chore(README): Update documentation

Author: jspizziri

README.md

@@ -17,31 +17,52 @@ sequelize-connect is a simple singleton wrapper for the sequelize ORM, making it
 
 ***NOTE:*** `sequelize-connect` must be configured upon app initialization, prior to [accessing your models](#accessing-sequelize)
 
-The  sequelize-connect `connect()` method accepts the same parameters as the Sequelize() object `database, username, password, options`. It is important to configure the `discover` array of the set of paths where your models should be discovered.
+The  sequelize-connect `connect()` method accepts the same parameters as the Sequelize() object `database, username, password, options`.
 ```js
 // app.js
-var orm 		= require('sequelize-connect');
+var Connection 		= require('sequelize-connect');
 
-orm.discover = [__dirname + '/models'];
-orm.connect(
+var orm = new Connection(
   'test-db',
   'test-user',
   'secret1234',
   {
     dialect: "mysql",
     port:    3306
-  })
-  .then(function(){
-    // Connection is completed
-  });
+  }
+)
+.then(function(instance){
+  // Connection is completed
+});
+```
+
+It is important to configure the `discover` array of the set of paths where your models should be discovered.
+```js
+// app.js
+var Connection 		= require('sequelize-connect');
+
+var discover = [__dirname + '/models', ...];
+var orm = new Connection(
+  'test-db',
+  'test-user',
+  'secret1234',
+  {
+    dialect: "mysql",
+    port:    3306
+  },
+  discover,
+)
+.then(function(instance){
+  // Connection is completed
+});
 ```
-Upon `connect()` sequelize-connect will ***ASYNCHRONOUSLY recurse*** through all of the subfolders located at the provided file paths looking for any files with the naming default convention `*.model.js`. Connect will return a Promise that is called on it's completion.
+Upon the first initialization of the `Connection` e.g. `new Connection(...);` sequelize-connect will ***ASYNCHRONOUSLY recurse*** through all of the subfolders located at the provided file paths looking for any files with the naming default convention `*.model.js`. Connect will return a Promise that is called on it's completion.
 
 #### Connection String
 You can use a connection string to connect as well:
 
 ```js
-orm.connect(
+new Connection(
   'MyConnectionString',
   {
     dialect: "mysql",
@@ -56,15 +77,27 @@ orm.connect(
 ## Custom matcher
 If you prefer to define your own naming convention instead of the default you can create a custom matching function which receives the file name as the parameter returns a `boolean` indicating if sequelize-connect should attempt to load the file as a model.
 
-This function should be attached to `matcher` like so:
+This function should be injected to `Connection` like so:
 
 ```js
-orm.matcher = function(file){
+var matcher = function(file){
   if(//some condition or regex here)
     return true;
 
   return false;
 };
+
+new Connection(
+  'test-db',
+  'test-user',
+  'secret1234',
+  {
+    dialect: "mysql",
+    port:    3306
+  },
+  discover,
+  matcher
+)
 ```
 
 
@@ -74,13 +107,51 @@ After connecting you can access the sequelize instance and models wherever you n
 ```js
 // somefile.js
 
-var orm       = require('sequelize-connect');
+var Connection = require('sequelize-connect');
+var orm = new Connection(); // singleton pattern - returns the created instance
 var sequelize = orm.sequelize;
 var Sequelize = orm.Sequelize;
 var models    = orm.models;
 var User      = models.User;
 ```
 
+If you prefer, rather than waiting for the connection to load before initializing every part of your application, you can wrap the code that has dependencies on your models in a `then`. e.g.
+
+
+```js
+// app.js
+new Connection(
+  'MyConnectionString',
+  {
+    dialect: "mysql",
+    port:    3306
+  })
+```
+
+```js
+// foobar.js
+
+var Promise = require('bluebird');
+var Connection = require('sequelize-connect');
+var orm = new Connection();
+
+// This will ensure that the connection has been established
+// if you load foobar.js before you wait for your initial connection
+// to return
+var Promise.resolve(orm)
+  .then(function(instance) {
+    var User = instance.models.Foo;
+
+    /**
+     * Get list of users
+     * restriction: 'admin'
+     */
+    var index = function(req, res) {
+      Foo.bar()
+    };
+  })
+```
+
 ## Defining Models
 
 Models are defined as per the suggestion the article here: http://sequelizejs.com/articles/express. All associations are done via the class method `associate` which is injected with the models object.
@@ -107,16 +178,32 @@ module.exports = function(sequelize, DataTypes) {
 
 ## Logging
 
-Logging is done via the [winston](https://github.com/winstonjs/winston), the winston object can be accessed at via `orm.logger`. If you want to control the log level you can do it like so:
+Logging is optional, but is turned off by default. In order to enable logging, simply inject the logger of your choice:
 
 ```js
-orm.logger.level = "debug";
+
+myLogger = console;
+// myLogger = winston;
+// myLogger = ...;
+
+new Connection(
+  'test-db',
+  'test-user',
+  'secret1234',
+  {
+    dialect: "mysql",
+    port:    3306
+  },
+  discover,
+  matcher,
+  myLogger
+)
 ```
 
-To disable logging entirely:
+Your logger must comply with the following interface:
 
 ```js
-orm.logger.level = null
+logger.log(level, message);
 ```