update documentation + fix test

documentation/Home.md

@@ -319,6 +319,8 @@ Scopes are synchronous only and will provide automatic [chainability](#chaining)
 
 {{Definition.scope()}}
 
+{{Definition.defaultScope()}}
+
 
 ## Custom Methods
 

lib/base/context.js

@@ -19,6 +19,10 @@ exports.model = {
 
     self.setInternal('context', context);
 
+    self.callInterceptors('onContext', [context], function(okay){
+      //we use interceptors here even though there isn't anything to intercept...
+    });
+
     return self;
   }
 };

lib/base/interceptors.js

@@ -64,7 +64,22 @@ exports.store = {
      *
      * @return {Definition}
      */ 
-    this.addInterceptor('afterValidation');    
+    this.addInterceptor('afterValidation');
+
+
+    /**
+     * Will be called after a new context was set. This hook will be called by `Model.setContext()`.
+     * @class Definition
+     * @method onContext
+     * @param {function} callback - Your interceptor function
+     *
+     * @callback
+     * @param {Object} context - The current context
+     * @this Model
+     *
+     * @return {Definition}
+     */ 
+    this.addInterceptor('onContext');  
   },
 
   addInterceptor: function(name){

lib/base/scope.js

@@ -41,9 +41,18 @@ exports.definition = {
 
 
 
-
+  /**
+   * Adds a default scope
+   *
+   * @class Definition
+   * @method defaultScope
+   * @param {string} name - The name of the scope
+   *
+   * @return {Definition}
+   */
   defaultScope: function(name){
     this.default_scopes.push(name);
+    return this;
   }
 };
 

test/sql/__shared/includes-test.js

@@ -542,7 +542,7 @@ module.exports = function(title, beforeFn, afterFn, store_conf){
           User.include('user').exec(function(result){
             result.length.should.be.equal(3);
 
-            result[0].login.should.be.equal(result[0].user.login);
+            result[0].id.should.be.equal(result[0].user.id);
             result[0].email.should.not.be.equal(result[0].user.email);
 
             next();
@@ -561,7 +561,6 @@ module.exports = function(title, beforeFn, afterFn, store_conf){
 
             result[0].user.posts.length.should.be.equal(3);
             result[1].user.posts.length.should.be.equal(1);
-            result[2].user.posts.length.should.be.equal(0);
 
             next();
           }).catch(function(err){