feat(core): add sugar function for model binding

packages/core/src/application.ts

@@ -41,6 +41,12 @@ export class Application extends Context {
         this.controller(ctor);
       }
     }
+
+    if (options.models) {
+      for (const ctor of options.models) {
+        this.model(ctor);
+      }
+    }
   }
 
   /**
@@ -66,6 +72,27 @@ export class Application extends Context {
       .tag('controller');
   }
 
+  /**
+   * Register a model class with this application.
+   *
+   * @param modelCtor {Function} The model class
+   * (constructor function).
+   * @return {Binding} The newly created binding, you can use the reference to
+   * further modify the binding, e.g. lock the value to prevent further
+   * modifications.
+   *
+   * ```ts
+   * class MyModel {
+   * }
+   * app.model(MyModel).lock();
+   * ```
+   */
+  model(modelCtor: Constructor<{}>): Binding {
+    return this.bind(`models.${modelCtor.name}`)
+      .toClass(modelCtor)
+      .tag('model');
+  }
+
   /**
    * Bind a Server constructor to the Application's master context.
    * Each server constructor added in this way must provide a unique prefix

packages/core/src/component.ts

@@ -54,6 +54,12 @@ export function mountComponent(app: Application, component: Component) {
     }
   }
 
+  if (component.models) {
+    for (const modelCtor of component.models) {
+      app.model(modelCtor);
+    }
+  }
+
   if (component.providers) {
     for (const providerKey in component.providers) {
       app.bind(providerKey).toProvider(component.providers[providerKey]);

packages/core/test/acceptance/application.acceptance.ts

@@ -75,6 +75,38 @@ describe('Bootstrapping the application', () => {
       ]);
     });
 
+    it('registers models from constructor', () => {
+      class ProductModel {}
+
+      const app = new Application({
+        models: [ProductModel],
+      });
+
+      expect(app.find('models.*').map(b => b.key)).to.eql([
+        'models.ProductModel',
+      ]);
+
+      expect(app.findByTag('model').map(b => b.key)).to.eql([
+        'models.ProductModel',
+      ]);
+    });
+
+    it('registers all models from components', async () => {
+      class ProductModel {}
+
+      class ProductComponent {
+        models = [ProductModel];
+      }
+
+      const app = new Application({
+        components: [ProductComponent],
+      });
+
+      expect(app.find('models.*').map(b => b.key)).to.eql([
+        'models.ProductModel',
+      ]);
+    });
+
     it('injects component dependencies', () => {
       class ConfigComponent {
         providers = {

packages/core/test/unit/application.test.ts

@@ -33,6 +33,24 @@ describe('Application', () => {
     }
   });
 
+  describe('model binding', () => {
+    let app: Application;
+    class MyModel {}
+
+    beforeEach(givenApp);
+
+    it('binds a model', () => {
+      const binding = app.model(MyModel);
+      expect(Array.from(binding.tags)).to.containEql('model');
+      expect(binding.key).to.equal('models.MyModel');
+      expect(findKeysByTag(app, 'model')).to.containEql(binding.key);
+    });
+
+    function givenApp() {
+      app = new Application();
+    }
+  });
+
   describe('component binding', () => {
     let app: Application;
     class MyController {}