[DO NOT REVIEW] feat: implement convention based boot

package.json

@@ -39,6 +39,7 @@
     "build:current": "lerna run --loglevel=silent build:current",
     "pretest": "npm run build:current",
     "test": "node packages/build/bin/run-nyc npm run mocha",
+    "test:clean": "npm run clean && npm run build:current && npm run test",
     "mocha": "node packages/build/bin/select-dist mocha --opts test/mocha.opts \"packages/*/DIST/test/**/*.js\"",
     "posttest": "npm run lint"
   },

packages/boot/.gitignore

@@ -0,0 +1,3 @@
+*.tgz
+dist*
+package

packages/boot/.npmrc

@@ -0,0 +1 @@
+package-lock=false

packages/boot/LICENSE

@@ -0,0 +1,25 @@
+Copyright (c) IBM Corp. 2017. All Rights Reserved.
+Node module: @loopback/boot
+This project is licensed under the MIT License, full text below.
+
+--------
+
+MIT license
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

packages/boot/README.md

@@ -0,0 +1,109 @@
+# @loopback/boot
+
+Boot package for LoopBack 4 to bootstrap convention based projects.
+
+## Overview
+
+This package provides the ability to bootstrap a LoopBack 4 project by
+automatically automatically associating artifacts and configuration with an
+application at runtime.
+
+The package is currently consumed as a [Mixin](http://loopback.io/doc/en/lb4/Mixin.html).
+
+It will automatically find all [Controller](http://loopback.io/doc/en/lb4/Controllers.html)
+classes by searching through all files in `controllers` directory ending in 
+`.controller.js` and bind them to the application using `this.controller()`.
+
+Other Mixins can support automatic Booting by overriding the `boot()` method.
+See example in [Advanced use](#advanced-use).
+
+## Installation
+
+```sh
+npm i --save @loopback/boot
+```
+
+## Basic use
+
+Using `@loopback/boot` is simple. It is a Mixin and should be added to your
+application Class as shown below.
+
+```ts
+class BootedApplication extends BootMixin(Application) {
+  constructor(options?: ApplicationConfig) {
+    super(options);
+  }
+}
+```
+
+### Configuration
+
+Configuration options for boot can be set via the `ApplicationConfig` object 
+(`options`). The following options are supported:
+
+|Name|Default|Description|
+|-|-|-|
+|`boot.rootDir`|`process.cwd()`|The root directory for the project. All other paths are resolved relative to this path.|
+|`boot.controllerDirs`|`controllers`|String or Array of directory paths to search in for controllers. Paths may be relative to `rootDir` or absolute.|
+|`boot.controllerExts`|`controller.js`|String or Array of file extensions to consider as controller files.|
+
+*Example*
+```ts
+app = new BootedApplication({
+  rest: {
+    port: 3000
+  },
+  boot: {
+    rootDir: '/absolute/path/to/my/app/root',
+    controllerDirs: ['controllers', 'ctrls'],
+    controllerExts: ['controller.js', '.ctrl.js'],
+  },
+});
+
+## Advanced use
+
+An extension developer can support the **boot** process by writing a mixin and
+overriding the `boot()` function as shown below. If a user is using
+`@loopback/boot`, it will automatically boot your artifact as well.
+
+```ts
+function TestMixin<T extends Constructor<any>>(superClass: T) {
+  return class extends superClass {
+    constructor(...args: any[]) {
+      super(...args);
+    }
+
+    async boot() {
+      // Your custom config
+      const repoDir = this.options.boot.repoDir || 'repositories';
+      // We call the convenience method to boot class artifacts
+      await this.bootClassArtifacts(repoDir, 'repository.js', 'testMixinRepo');
+
+      // IMPORTANT: This line must be added so all other artifacts can be booted
+      // automatically and regardless of the order of the Mixins.
+      if (super.boot) await super.boot();
+    }
+  };
+}
+```
+
+## Related resources
+
+**Coming Soon** Link to Boot Docs.
+
+## Contributions
+
+- [Guidelines](https://github.com/strongloop/loopback-next/wiki/Contributing#guidelines)
+- [Join the team](https://github.com/strongloop/loopback-next/issues/110)
+
+## Tests
+
+run `npm test` from the root folder.
+
+## Contributors
+
+See [all contributors](https://github.com/strongloop/loopback-next/graphs/contributors).
+
+## License
+
+MIT

packages/boot/docs.json

@@ -0,0 +1,14 @@
+{
+  "content": [
+    "index.ts",
+    "src/index.ts",
+    "src/types.ts",
+    "src/utils.ts",
+    "src/mixins/boot.mixin.ts"
+  ],
+  "codeSectionDepth": 4,
+  "assets": {
+    "/": "/docs",
+    "/docs": "/docs"
+  }
+}

packages/boot/index.d.ts

@@ -0,0 +1,6 @@
+// Copyright IBM Corp. 2013,2017. All Rights Reserved.
+// Node module: @loopback/boot
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+export * from './dist/src';

packages/boot/index.js

@@ -0,0 +1,6 @@
+// Copyright IBM Corp. 2013,2017. All Rights Reserved.
+// Node module: @loopback/boot
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+module.exports = require('./dist/src');

packages/boot/index.ts

@@ -0,0 +1,6 @@
+// Copyright IBM Corp. 2013,2017. All Rights Reserved.
+// Node module: @loopback/boot
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+export * from './src';

packages/boot/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@loopback/boot",
+  "version": "4.0.0-alpha.1",
+  "description": "Boot handler for LoopBack 4 apps",
+  "engines": {
+    "node": ">=8"
+  },
+  "main": "index.js",
+  "scripts": {
+    "acceptance": "mocha --opts ../../test/mocha.opts dist/test/acceptance/**/*.js",
+    "build": "lb-tsc",
+    "build:current": "lb-tsc",
+    "build:apidocs": "lb-apidocs",
+    "clean": "lb-clean loopback-boot*.tgz dist package api-docs",
+    "prepare": "npm run build",
+    "pretest": "npm run clean && npm run build",
+    "test": "mocha --opts ../../test/mocha.opts dist/test/",
+    "unit": "mocha --opts ../../test/mocha.opts dist/test/unit/",
+    "verify": "npm pack && tar xf loopback-boot*.tgz && tree package && npm run clean"
+  },
+  "author": "IBM",
+  "license": "MIT",
+  "keywords": ["LoopBack", "Boot"],
+  "files": [
+    "README.md",
+    "index.js",
+    "index.d.ts",
+    "dist/src",
+    "api-docs",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/strongloop/loopback-next.git"
+  },
+  "devDependencies": {
+    "@loopback/build": "^4.0.0-alpha.7",
+    "@loopback/core": "^4.0.0-alpha.26",
+    "@loopback/rest": "^4.0.0-alpha.15",
+    "@loopback/testlab": "^4.0.0-alpha.17"
+  },
+  "dependencies": {
+    "@loopback/context": "^4.0.0-alpha.23",
+    "debug": "^3.1.0"
+  }
+}

packages/boot/src/index.ts

@@ -0,0 +1,8 @@
+// Copyright IBM Corp. 2013,2017. All Rights Reserved.
+// Node module: @loopback/boot
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+export * from './mixins/boot.mixin';
+export * from './utils';
+export * from './types';