chore(@nestjs) publish v5.7.4 release

build(test/linting) update test/linting dependencies

.gitattributes

@@ -0,0 +1,2 @@
+package-lock.json   -diff -merge
+package-lock.json    linguist-generated=true

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,41 @@
+## PR Checklist
+Please check if your PR fulfills the following requirements:
+
+- [ ] The commit message follows our guidelines: https://github.com/nestjs/nest/blob/master/CONTRIBUTING.md
+- [ ] Tests for the changes have been added (for bug fixes / features)
+- [ ] Docs have been added / updated (for bug fixes / features)
+
+
+## PR Type
+What kind of change does this PR introduce?
+
+<!-- Please check the one that applies to this PR using "x". -->
+```
+[ ] Bugfix
+[ ] Feature
+[ ] Code style update (formatting, local variables)
+[ ] Refactoring (no functional changes, no api changes)
+[ ] Build related changes
+[ ] CI related changes
+[ ] Other... Please describe:
+```
+
+## What is the current behavior?
+<!-- Please describe the current behavior that you are modifying, or link to a relevant issue. -->
+
+Issue Number: N/A
+
+
+## What is the new behavior?
+
+
+## Does this PR introduce a breaking change?
+```
+[ ] Yes
+[ ] No
+```
+
+<!-- If this PR contains a breaking change, please describe the impact and migration path for existing applications below. -->
+
+
+## Other information

.gitignore

@@ -1,19 +1,23 @@
 # dependencies
 node_modules/
-package-lock.json
+
 # IDE
 /.idea
 /.awcache
 /.vscode
 
+# bundle
+packages/**/*.d.ts
+packages/**/*.js
+
 # misc
+.DS_Store
 lerna-debug.log
 npm-debug.log
-/src/common/npm-debug.log
-/src/core/npm-debug.log
-/src/testing/npm-debug.log
-/src/microservices/npm-debug.log
-/src/websockets/npm-debug.log
+yarn-error.log
+/**/npm-debug.log
+/packages/**/.npmignore
+/packages/**/LICENSE
 
 # example
 /quick-start
@@ -22,5 +26,7 @@ npm-debug.log
 
 # tests
 /test
+/benchmarks/memory
 /coverage
 /.nyc_output
+build/config\.gypi

.npmignore

@@ -0,0 +1,13 @@
+# source
+**/*.ts
+*.ts
+
+# definitions
+!**/*.d.ts
+!*.d.ts
+
+# configuration
+package-lock.json
+tslint.json
+tsconfig.json
+.prettierrc

.prettierignore

@@ -0,0 +1,2 @@
+packages/**/*.d.ts
+packages/**/*.js

.travis.yml

@@ -1,14 +1,24 @@
 language: node_js
 node_js:
-      - "7"
+  - "8"
+  - "10"
+  - "11"
+cache:
+  directories:
+    - "node_modules"
+git:
+  depth: 5
 addons:
-     firefox: "latest"
+  firefox: "latest"
 before_script:
-     - export DISPLAY=:99.0
-     - sh -e /etc/init.d/xvfb start
+  - export DISPLAY=:99.0
+  - sh -e /etc/init.d/xvfb start
+before_install:
+  - npm i -g npm@latest
 install:
-     - npm install
-     - gulp build
+  - npm ci
+  - npm run build:dev
 script:
-      - npm test
+  - npm run lint
+  - npm test
 after_success: npm run coverage

CHANGELOG.md

@@ -1,349 +0,0 @@
-## 4.6.4
-### Bug Fixes
-- **microservices**: can't select/get from context when using `NestFactory.createMicroservice` [#398](https://github.com/nestjs/nest/issues/398)
-
-## 4.6.3
-### Bug Fixes
-- **core**: error thrown when connecting to microservice (hybrid applicaton) [#425](https://github.com/nestjs/nest/issues/425)
-
-## 4.6.2
-### Improvements
-- **core**: simplify `NestFactory.create(...args)` signature
-
-## 4.6.1
-### Improvements
-- **common**: create `ModuleMetadata` interface
-- **core**: majority of methods (`INestApplication`, `INestMicroservice`, and `INestApplicationContext`) return `this` instead of `void`
-- **core**: remove static dependencies & relationships inside `NestFactory`
-
-### Features
-- **core**: [feature] add `appOptions` property to `create[..]` methods of `NestFactory`
-
-### Bug Fixes
-- **common**: [bugfix] update `class-validator` [#417](https://github.com/nestjs/nest/issues/417)
-- **core**: [bugfix] catch error thrown by `bodyParser` in exception filter [#422](https://github.com/nestjs/nest/issues/422)
-
-## 4.6.0
-### Features
-- **common**: `ValidationPipe` improvements [#383](https://github.com/nestjs/nest/pull/383)
-- **common**: `ParseIntPipe` improvements [#385](https://github.com/nestjs/nest/pull/385)
-- **common**: add `FileInterceptor`, `FilesInterceptor`, `@UploadedFile()` and `@UploadedFiles()` (`multer` integration)
-- **common**: add `HttpModule` that exposes `HttpService` (`axios` integration)
-- **core**: add `app.disable()` and `app.enable()` wrappers around `express` app
-- **core**: add ability to inject `express` reference (`EXPRESS_REF` token)
-- **core**: enable possibility to extend metadata (inheritance support) [#228](https://github.com/nestjs/nest/issues/228)
-- **core**: `NestFactory.create()` now accepts third argument `HttpsOptions`
-- **core**: add `app.enableCors()` to `INestApplication` (`cors` integration)
-- **core**: add `@Render()` decorator (MVC applications)
-- **core**: provide `Logger.overrideLogger()` [#247](https://github.com/nestjs/nest/issues/247)
-- **microservices**: add `listenAsync()` to `INestMicroservice` instance
-
-### Bug Fixes
-- **core**: simplify HTTPS protocol usage
-- **core**: custom transport strategy - thrown exceptions issue [#290](https://github.com/nestjs/nest/issues/290)
-- **core**: injector fails silently [#287](https://github.com/nestjs/nest/issues/287)
-- **core**: secure websockets (`wss://`) [#384](https://github.com/nestjs/nest/issues/384)
-- **core**: can't select/get from context when using `NestFactory.createMicroservice()` [#398](https://github.com/nestjs/nest/issues/398)
-- **core**: interceptor `$stream` observable returns another observable instead of the response object [#376](https://github.com/nestjs/nest/issues/376)
-- **core**: `Observable.throw` from controller results in unhandled rejection promise [#373](https://github.com/nestjs/nest/issues/373)
-
-## 4.5.10
-- **core**: [bugfix] #343
-- **core**: [bugfix] #337 
-
-## 4.5.6
-- **core**: [bugfix] dynamic modules `exports`
-
-## 4.5.5
-- **core**: [bugfix] add missing `app.engine()` wrapper
-
-## 4.5.4
-- **core**: [bugfix] dynamic modules recurrent imports fix
-
-## 4.5.3
-- **testing**: [bugfix] issue #326
-
-## 4.5.2
-- **common**: [feature] rename `modules` to `imports` (`@Module()` decorator)
-- **core**: [feature] exception filters with empty `@Catch()` metadata handle each occurred exception 
-- **core**: [improvement] increase performance
-
-## 4.5.1
-- **common**: [feature] `INestAplication` provides a `getHttpServer()` method now
-- **websockets**: [bugfix] `IoAdapter` bugfix
-
-## 4.5.0
-- **common**: bugfix #286
-- **core**: dynamic modules feature
-- **core**: global scope feature
-- **core**: `ExternalContextCreator` & `ModulesContainer` 
-- **core**: merge `NestApplicationContext` with `NestApplication`
-- **core**: `NotFoundException` is thrown when route is not available #298
-- **core**: add `set()` wrapper around native express methods
-- **core**: bugfix #281
-- **websockets**: bugfix #271
-- **microservices**: log RPC exceptions #303
-- **microservices**: merge `NestApplicationContext` with `NestMicroservice`
-- **microservices**: handle ECONNREFUSED #288
-
-## 4.4.1
-- **common**: `ValidationPipe` improvement
-- **common**: custom route params decorators accepts pipes now
-- **core**: bugfix #268
-
-## 4.4.0 
-- **core**: possibility to create the `NestApplicationContext` using `NestFactory.createApplicationContext()` (Nest application without HTTP server / microservice in the background)
-- **core**: create custom params decorators feature (`createRouteParamDecorator()`)
-
-## 4.3.3
-- **common**: `ParseIntPipe` is now available out-of-the-box (`@nestjs/common`)
-- **common**: package contains a set of useful HTTP exceptions now, such as `ForbiddenException`, `UnauthorizedException`, `BadRequestException` etc
-- **core**: `HttpException` was moved to `@nestjs/common`. This one from `core` packages is now DEPRECATED and will be removed in the next MAJOR release
-
-## 4.3.0
-- **common**: `ValidationPipe` is now available out-of-the-box (`@nestjs/common`)
-- **core**: `json` and `urlencoded` (`body-parser`) middlewares are applied by default now, bugfix #252
-- **core** more informative error message (injector) #223
-example: `[ExceptionHandler] Nest can't resolve dependencies of the UsersService (+, +, ?, +, +, +). Please verify whether [2] argument is available in the current context.`
-- **core**: bugfix #240 - middlewares container state
-- **core**: bugifx #257 - `@Next()` issue
-- **testing**: testing module is now independent from `@nestjs/microservices`
-
-## 4.2.2
-- **websockets**: bugfix #242
-
-## 4.2.1
-- **core**: IoAdapter bugfix
-
-## 4.2.0
-- **core**: log controller prefix #153
-- **websockets**: gateway listen the same port as the app #126
-
-## 4.1.4
-- **common**: remove deprecated `@ExceptionFilters()` decorator
-- **core**: update to latest **express* version (4.16.2)
-- **core**: bugfix #187
-- **core**: bugfix #185
-- **all**: packages codependency refactor
-- **all**: add *lerna* package
-
-## 4.1.3
-- **core**: forward reference bugfixes & security updates
-
-## 4.1.1
-- **common**: add `forwardRef()` util
-- **core**: improve injector & dependencies scanner
-
-## 4.1.0
-- **common**: add `@Bind()` and `@Dependencies()` decorators to fix route parameters decorators (pure JavaScript compatibility issue)
-- **core**: improve performance
-
-## 4.0.1
-- **core**: add possibility to setup global guards and global interceptors
-- **common**: `INestApplication` has `useGlobalInterceptors()` and `useGlobalGuards()` now
-- **microservices**: add possibility to setup global guards, interceptors, filters and pipes
-- **core**: add timestamp to log output
-- **core**: improve pipes performance
-- **core**: add ability to omit param name when passing param-scoped pipe/s
-- **websockets**: fix disconnect event issue (pass client instead of socket.io instance)
-
-## 4.0.0
-**@nestjs/core**
-- Asynchronous `NestFactory` [read more](http://www.docs.nestjs.com/first-steps)
-- New response handling approach [read more](http://www.docs.nestjs.com/controllers)
-- Interceptors feature [read more](http://www.docs.nestjs.com/interceptors)
-- `@Shared()` deprecated (modules are singletons by default) [read more](http://www.docs.nestjs.com/modules)
-- `@SingleScope()` decorator [read more](http://www.docs.nestjs.com/modules)
-- Modules re-exporting [read more](http://www.docs.nestjs.com/modules)
-- Deffered & functional middlewares [read more](http://www.docs.nestjs.com/middlewares)
-- Guards feature [read more](http://www.docs.nestjs.com/guards)
-- Async components [read more](http://www.docs.nestjs.com/advanced/async-components)
-- Hierarchical injector improvements [read more](http://www.docs.nestjs.com/advanced/hierarchical-injector)
-- Mixin classes [read more](http://www.docs.nestjs.com/advanced/mixins)
-- New `INestApplication` API
-
-**@nestjs/microservices**
-- Possibility to return Promise / Observable / plain value [read more](http://www.docs.nestjs.com/microservices/basics)
-- Guards & Interceptors & Pipes & Exception Filters integration
-
-
-**@nestjs/websockets**
-- Possibility to return Promise / Observable / plain value [read more](http://www.docs.nestjs.com/websockets/gateways)
-- Guards & Interceptors & Pipes & Exception Filters integration
-- New `WebSocketAdapter` API
-
-**@nestjs/testing**
-- Completely rewritten testing package
-
-## 3.0.1 (24.06.2017)
-**@nestjs/core**
-- Hierarchical injector bugfix,
-- Middlewares `@UseFilters()` bugfix (#95).
-
-**@nestjs/microservices**
-- TCP server / client bugfix (#91)
-
-## 3.0.0 (03.06.2017)
-**@nestjs/common - BREAKING CHANGE**
-- You should now pass objects into `@UseFilters()` decorator instead of metatypes,
-- Exception Filters can't inject dependencies (they're not coupled with modules),
-- `@ExceptionFilters()` is deprecated, use `@UseFilters()` instead.
-- `INestApplication` has new methods - `useGlobalFilters()` and `useGlobalPipes()`,
-- New lifecycle hook - `OnModuleDestroy` interface.
-
-**@nestjs/core**
-- `@Pipe()` feature (async & sync),
-- Exception Filters can have global, controller and method scope.
-
-**@nestjs/websockets - BREAKING CHANGE**
-- Use `useWebSocketAdapter()` instead of `setIoAdapter()`,
-- You can port any WS library - just implement `WebSocketAdapter` (@nestjs/common).
-
-**@nestjs/microservices - BREAKING CHANGE**
-- Now methods have to return `Observable`, and they receive only one argument `data`,
-- Microservices can return multiple values, but after emitting `Observable` has to be COMPLETED!
-- You can port any transport strategy instead of built-in Redis/TCP, just implement `CustomTransportStrategy`.
-
-## 2.1.3 (27.05.2017)
-**@nestjs/common**, **@nestjs/websockets**
-- `INestApplication` and `INestMicroservice` has new method now - `setIoAdapter()`,
-- Ability to use custom `IoAdapter`
-
-## 2.1.1 (24.05.2017)
-**@nestjs/common**, **@nestjs/websockets**, **@nestjs/microservices**
-- `INestApplication` and `INestMicroservice` has new method now - `setIoAdapter()`,
-- Ability to use custom `IoAdapter`
-
-## 2.1.0 (22.05.2017)
-**@nestjs/common**, **@nestjs/core**
-- `INestApplication` has new methods now - `init()`, `setGlobalPrefix()`, `connectMicroservice()`, `close()`, `startAllMicroservices()`,
-- `INestMicroservice` has new method - `close()`
-
-## 2.0.3 (15.05.2017)
-**@nestjs/common**
-- `Req()` (`Request()`) and `Res()` (`Response()`) aliases to avoid conflicts with express typings
-
-## 2.0.0 (14.05.2017)
-
-- **Hierarchical injector** improvements
-- `@Shared(token?: string)` decorator for **scoped**, shared Modules
-- Modules **are not singletons** anymore
-- Added `iterare` library for applying multiple transformations to a collection
-- `Logger` service is public,
-- Nest is now splitted into feature packages:
-```typescript
-@nestjs/core
-@nestjs/common
-@nestjs/microservices
-@nestjs/testing
-@nestjs/websockets
-```
-- `rxjs`, `redis` and `reflect-metadata` moved into `peerDependencies`
-- `@Patch()` support
-
-## 1.0.0 (Final - 01.05.2017)
-
-- Added **Gateway Middlewares** support:
-
-```
-@WebSocketGateway({
-    port: 2000,
-    middlewares: [ChatMiddleware],
-})
-```
-Gateway Middleware example:
-```
-@Middleware()
-export class ChatMiddleware implements GatewayMiddleware {
-    public resolve(): (socket, next) => void {
-        return (socket, next) => {
-            console.log('Authorization...');
-            next();
-        };
-    }
-}
-```
-
-- New Gateway lifecycle interfaces `OnGatewayInit`, `OnGatewayConnection`, `OnGatewayDisconnect`
-- `@SubscribeMessage()` now accepts also plain strings:
-
-```
-@SubscribeMessage('event')
-```
-
-- `@Controller()` now accepts also plain strings: 
-
-```
-@Controller('users')
-```
-
-- `HttpStatus` (`HttpStatus.OK` etc.) enumerator
-- **Route params decorators** support 
-
-```
-Request: () => ParameterDecorator
-Response: () => ParameterDecorator
-Next: () => ParameterDecorator
-Query: (property?: string) => ParameterDecorator
-Body: (property?: string) => ParameterDecorator
-Param: (property?: string) => ParameterDecorator
-Session: () => ParameterDecorator
-Headers: (property?: string) => ParameterDecorator
-```
-
-- `MiddlewaresBuilder` -> `MiddlewaresConsumer`
-- **Exception Filters** support
-
-```
-@ExceptionFilters(CustomExceptionFilter, NextExceptionFilter)
-export class UsersController {}
-```
-Exception filter example:
-
-```
-export class CustomException {}
-
-@Catch(CustomException)
-export class CustomExceptionFilter implements ExceptionFilter {
-    public catch(exception, response) {
-        response.status(500).json({
-            message: 'Custom exception message.',
-        });
-    }
-}
-```
-- Module injection support:
-
-```
-export class UsersController {
-    constructor(private module: UsersModule) {}
-}
-```
-
-- `ModuleRef` support
-
-## 1.0.0-RC7 (08.04.2017)
-
-- MiddlewareBuilder: `use()` deprecated, use `apply()` instead
-- MiddlewareBuilder: new `apply()` method
-
-## 1.0.0-RC4 (08.04.2017)
-
-- Support for `@Post`, `@Get`, `@Delete`, `@Put`, `@All` decorators
-- Added ability to pass data to middleware metatypes
-
-## 1.0.0-BETA-1 (23.03.2017)
-
-- `@Inject` -> `@Dependencies`
-- `@Inject` decorator for custom constructor parameters
-- Custom providers support (useClass, useValue, useFactory)
-
-## 1.0.0-ALPHA-23 (19.03.2017)
-
-- Microservices support (TCP & Redis transports)
-- NestRunner -> NestFactory
-- Simplify application initialization & configuration
-- Added abillity to pass custom express instance
-- `@Inject` decorator for ES6+
-- SocketGateway -> WebSocketGateway
-- GatewayServer -> WebSocketServer

CONTRIBUTING.md

@@ -3,14 +3,15 @@
 We would love for you to contribute to Nest and help make it even better than it is
 today! As a contributor, here are the guidelines we would like you to follow:
 
- - [Code of Conduct](#coc)
- - [Question or Problem?](#question)
- - [Issues and Bugs](#issue)
- - [Feature Requests](#feature)
- - [Submission Guidelines](#submit)
- - [Coding Rules](#rules)
- - [Commit Message Guidelines](#commit)
- <!-- - [Signing the CLA](#cla) -->
+<!--* [Code of Conduct](#coc)-->
+* [Question or Problem?](#question)
+* [Issues and Bugs](#issue)
+* [Feature Requests](#feature)
+* [Submission Guidelines](#submit)
+* [Development Setup](#development)
+* [Coding Rules](#rules)
+* [Commit Message Guidelines](#commit)
+  <!-- - [Signing the CLA](#cla) -->
 
 <!-- ## <a name="coc"></a> Code of Conduct
 Help us keep Nest open and inclusive. Please read and follow our [Code of Conduct][coc]. -->
@@ -22,27 +23,30 @@ Help us keep Nest open and inclusive. Please read and follow our [Code of Conduc
 Stack Overflow is a much better place to ask questions since:
 
 <!-- - there are thousands of people willing to help on Stack Overflow [maybe one day] -->
-- questions and answers stay available for public viewing so your question / answer might help someone else
-- Stack Overflow's voting system assures that the best answers are prominently visible.
+
+* questions and answers stay available for public viewing so your question / answer might help someone else
+* Stack Overflow's voting system assures that the best answers are prominently visible.
 
 To save your and our time, we will systematically close all issues that are requests for general support and redirect people to Stack Overflow.
 
 If you would like to chat about the question in real-time, you can reach out via [our gitter channel][gitter].
 
 ## <a name="issue"></a> Found a Bug?
+
 If you find a bug in the source code, you can help us by
 [submitting an issue](#submit-issue) to our [GitHub Repository][github]. Even better, you can
 [submit a Pull Request](#submit-pr) with a fix.
 
 ## <a name="feature"></a> Missing a Feature?
-You can *request* a new feature by [submitting an issue](#submit-issue) to our GitHub
-Repository. If you would like to *implement* a new feature, please submit an issue with
+
+You can _request_ a new feature by [submitting an issue](#submit-issue) to our GitHub
+Repository. If you would like to _implement_ a new feature, please submit an issue with
 a proposal for your work first, to be sure that we can use it.
 Please consider what kind of change it is:
 
 * For a **Major Feature**, first open an issue and outline your proposal so that it can be
-discussed. This will also allow us to better coordinate our efforts, prevent duplication of work,
-and help you to craft the change so that it is successfully accepted into the project. For your issue name, please prefix your proposal with `[discussion]`, for example "[discussion]: your feature idea".
+  discussed. This will also allow us to better coordinate our efforts, prevent duplication of work,
+  and help you to craft the change so that it is successfully accepted into the project. For your issue name, please prefix your proposal with `[discussion]`, for example "[discussion]: your feature idea".
 * **Small Features** can be crafted and directly [submitted as a Pull Request](#submit-pr).
 
 ## <a name="submit"></a> Submission Guidelines
@@ -53,9 +57,9 @@ Before you submit an issue, please search the issue tracker, maybe an issue for
 
 We want to fix all the issues as soon as possible, but before fixing a bug we need to reproduce and confirm it. In order to reproduce bugs we will systematically ask you to provide a minimal reproduction scenario using a repository or [Gist](https://gist.github.com/). Having a live, reproducible scenario gives us wealth of important information without going back & forth to you with additional questions like:
 
-- version of NestJS used
-- 3rd-party libraries and their versions
-- and most importantly - a use-case that fails
+* version of NestJS used
+* 3rd-party libraries and their versions
+* and most importantly - a use-case that fails
 
 <!--
 // TODO we need to create a playground, similar to plunkr
@@ -68,42 +72,50 @@ Unfortunately, we are not able to investigate / fix bugs without a minimal repro
 
 You can file new issues by filling out our [new issue form](https://github.com/nestjs/nest/issues/new).
 
-
 ### <a name="submit-pr"></a> Submitting a Pull Request (PR)
+
 Before you submit your Pull Request (PR) consider the following guidelines:
 
+<!--
+To the first point
+
+1. Please sign our [Contributor License Agreement (CLA)](#cla) before sending PRs.
+We cannot accept code without this.
+-->
+
 1. Search [GitHub](https://github.com/nestjs/nest/pulls) for an open or closed PR
-  that relates to your submission. You don't want to duplicate effort.
-<!-- 1. Please sign our [Contributor License Agreement (CLA)](#cla) before sending PRs.
-  We cannot accept code without this. -->
+   that relates to your submission. You don't want to duplicate effort.
 1. Fork the nestjs/nest repo.
 1. Make your changes in a new git branch:
 
-     ```shell
-     git checkout -b my-fix-branch master
-     ```
+   ```shell
+   git checkout -b my-fix-branch master
+   ```
 
 1. Create your patch, **including appropriate test cases**.
 1. Follow our [Coding Rules](#rules).
-1. Run the full Nest test suite, as described in the [developer documentation][dev-doc],
-  and ensure that all tests pass.
+1. Run the full Nest test suite (see [common scripts](#common-scripts)),
+   and ensure that all tests pass.
 1. Commit your changes using a descriptive commit message that follows our
-  [commit message conventions](#commit). Adherence to these conventions
-  is necessary because release notes are automatically generated from these messages.
+   [commit message conventions](#commit). Adherence to these conventions
+   is necessary because release notes are automatically generated from these messages.
 
-     ```shell
-     git commit -a
-     ```
-    Note: the optional commit `-a` command line option will automatically "add" and "rm" edited files.
+   ```shell
+   git commit -a
+   ```
+
+   Note: the optional commit `-a` command line option will automatically "add" and "rm" edited files.
 
 1. Push your branch to GitHub:
 
-    ```shell
-    git push origin my-fix-branch
-    ```
+   ```shell
+   git push origin my-fix-branch
+   ```
 
 1. In GitHub, send a pull request to `nestjs:master`.
+
 * If we suggest changes then:
+
   * Make the required updates.
   * Re-run the Nest test suites to ensure tests are still passing.
   * Rebase your branch and force push to your GitHub repository (this will update your Pull Request):
@@ -122,47 +134,90 @@ from the main (upstream) repository:
 
 * Delete the remote branch on GitHub either through the GitHub web UI or your local shell as follows:
 
-    ```shell
-    git push origin --delete my-fix-branch
-    ```
+  ```shell
+  git push origin --delete my-fix-branch
+  ```
 
 * Check out the master branch:
 
-    ```shell
-    git checkout master -f
-    ```
+  ```shell
+  git checkout master -f
+  ```
 
 * Delete the local branch:
 
-    ```shell
-    git branch -D my-fix-branch
-    ```
+  ```shell
+  git branch -D my-fix-branch
+  ```
 
 * Update your master with the latest upstream version:
 
-    ```shell
-    git pull --ff upstream master
-    ```
+  ```shell
+  git pull --ff upstream master
+  ```
+
+## <a name="development"></a> Development Setup
+
+You will need Node.js version 8.9.0+.
+
+1. After cloning the repo, run:
+
+```bash
+$ npm i # (or yarn install)
+```
+
+2. In order to prepare your environment run `prepare.sh` shell script:
+
+```bash
+$ sh scripts/prepare.sh
+```
+
+That will compile fresh packages and afterward, move them to all `sample` directories as well as integration tests.
+
+### <a name="common-scripts"></a>Commonly used NPM scripts
+
+```bash
+# build all packages and put them near to their source .ts files
+$ npm run build
+
+# build all packages and move to "sample" and "integration" directories
+# if cross-packages breaking changes were performed you may face irrelevant errors
+# in order to verify the build, you can run this command again then
+$ npm run build:dev
+
+# run the full unit tests suite
+$ npm run test
+
+# run integration tests
+# docker is required(!)
+$ sh scripts/run-integration.sh
+
+# run linter
+$ npm run lint
+```
 
 ## <a name="rules"></a> Coding Rules
+
 To ensure consistency throughout the source code, keep these rules in mind as you are working:
 
-* All features or bug fixes **must be tested** by one or more specs (unit-tests).
 <!--
 // We're working on auto-documentation.
 * All public API methods **must be documented**. (Details TBC). -->
+
+* All features or bug fixes **must be tested** by one or more specs (unit-tests).
 * We follow [Google's JavaScript Style Guide][js-style-guide], but wrap all code at
   **100 characters**. An automated formatter is available, see
   [DEVELOPER.md](docs/DEVELOPER.md#clang-format).
 
 ## <a name="commit"></a> Commit Message Guidelines
 
-We have very precise rules over how our git commit messages can be formatted.  This leads to **more
-readable messages** that are easy to follow when looking through the **project history**.  But also,
+We have very precise rules over how our git commit messages can be formatted. This leads to **more
+readable messages** that are easy to follow when looking through the **project history**. But also,
 we use the git commit messages to **generate the Nest change log**.
 
 ### Commit Message Format
-Each commit message consists of a **header**, a **body** and a **footer**.  The header has a special
+
+Each commit message consists of a **header**, a **body** and a **footer**. The header has a special
 format that includes a **type**, a **scope** and a **subject**:
 
 ```
@@ -183,38 +238,37 @@ Footer should contain a [closing reference to an issue](https://help.github.com/
 Samples: (even more [samples](https://github.com/nestjs/nest/commits/master))
 
 ```
-docs(changelog): update change log to beta.5
-```
-```
-fix(release): need to depend on latest rxjs and zone.js
-
-The version in our package.json gets copied to the one we publish, and users need the latest of these.
+docs(changelog) update change log to beta.5
+bugfix(core) need to depend on latest rxjs and zone.js
 ```
 
 ### Revert
-If the commit reverts a previous commit, it should begin with `revert: `, followed by the header of the reverted commit. In the body it should say: `This reverts commit <hash>.`, where the hash is the SHA of the commit being reverted.
+
+If the commit reverts a previous commit, it should begin with `revert:`, followed by the header of the reverted commit. In the body it should say: `This reverts commit <hash>.`, where the hash is the SHA of the commit being reverted.
 
 ### Type
+
 Must be one of the following:
 
 * **build**: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
 * **ci**: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
 * **docs**: Documentation only changes
-* **feat**: A new feature
-* **fix**: A bug fix
+* **feature**: A new feature
+* **bugfix**: A bug fix
 * **perf**: A code change that improves performance
 * **refactor**: A code change that neither fixes a bug nor adds a feature
 * **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
 * **test**: Adding missing tests or correcting existing tests
 
 ### Scope
+
 The scope should be the name of the npm package affected (as perceived by person reading changelog generated from commit messages.
 
 The following is the list of supported scopes:
 
 * **common**
 * **core**
-* **examples**
+* **sample**
 * **microservices**
 * **testing**
 * **websockets**
@@ -223,11 +277,12 @@ There are currently a few exceptions to the "use package name" rule:
 
 * **packaging**: used for changes that change the npm package layout in all of our packages, e.g. public path changes, package.json changes done to all packages, d.ts file/format changes, changes to bundles, etc.
 * **changelog**: used for updating the release notes in CHANGELOG.md
-* **examples/#**: for the example apps directory, replacing # with the example app number
-<!-- * **aio**: used for docs-app (angular.io) related changes within the /aio directory of the repo -->
+* **sample/#**: for the example apps directory, replacing # with the example app number
 * none/empty string: useful for `style`, `test` and `refactor` changes that are done across all packages (e.g. `style: add missing semicolons`)
+<!-- * **aio**: used for docs-app (angular.io) related changes within the /aio directory of the repo -->
 
 ### Subject
+
 The subject contains succinct description of the change:
 
 * use the imperative, present tense: "change" not "changed" nor "changes"
@@ -235,10 +290,12 @@ The subject contains succinct description of the change:
 * no dot (.) at the end
 
 ### Body
+
 Just as in the **subject**, use the imperative, present tense: "change" not "changed" nor "changes".
 The body should include the motivation for the change and contrast this with previous behavior.
 
 ### Footer
+
 The footer should contain any information about **Breaking Changes** and is also the place to
 reference GitHub issues that this commit **Closes**.
 
@@ -255,9 +312,10 @@ changes to be accepted, the CLA must be signed. It's a quick process, we promise
 * For corporations we'll need you to
   [print, sign and one of scan+email, fax or mail the form][corporate-cla]. -->
 
-
 <!-- [angular-group]: https://groups.google.com/forum/#!forum/angular -->
+
 <!-- [coc]: https://github.com/angular/code-of-conduct/blob/master/CODE_OF_CONDUCT.md -->
+
 [commit-message-format]: https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#
 [corporate-cla]: http://code.google.com/legal/corporate-cla-v1.0.html
 [dev-doc]: https://github.com/nestjs/nest/blob/master/docs/DEVELOPER.md
@@ -268,4 +326,5 @@ changes to be accepted, the CLA must be signed. It's a quick process, we promise
 [jsfiddle]: http://jsfiddle.net
 [plunker]: http://plnkr.co/edit
 [runnable]: http://runnable.com
+
 <!-- [stackoverflow]: http://stackoverflow.com/questions/tagged/angular -->

Readme.md

@@ -1,12 +1,12 @@
 <p align="center">
-  <a href="http://nestjs.com/" target="blank"><img src="http://kamilmysliwiec.com/public/nest-logo.png#1" alt="Nest Logo" /></a>
+  <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo_text.svg" width="320" alt="Nest Logo" /></a>
 </p>
 
 [travis-image]: https://api.travis-ci.org/nestjs/nest.svg?branch=master
 [travis-url]: https://travis-ci.org/nestjs/nest
 [linux-image]: https://img.shields.io/travis/nestjs/nest/master.svg?label=linux
 [linux-url]: https://travis-ci.org/nestjs/nest
-  
+
   <p align="center">A progressive <a href="http://nodejs.org" target="blank">Node.js</a> framework for building efficient and scalable server-side applications, heavily inspired by <a href="https://angular.io" target="blank">Angular</a>.</p>
     <p align="center">
 <a href="https://www.npmjs.com/~nestjscore"><img src="https://img.shields.io/npm/v/@nestjs/core.svg" alt="NPM Version" /></a>
@@ -14,10 +14,13 @@
 <a href="https://www.npmjs.com/~nestjscore"><img src="https://img.shields.io/npm/dm/@nestjs/core.svg" alt="NPM Downloads" /></a>
 <a href="https://travis-ci.org/nestjs/nest"><img src="https://api.travis-ci.org/nestjs/nest.svg?branch=master" alt="Travis" /></a>
 <a href="https://travis-ci.org/nestjs/nest"><img src="https://img.shields.io/travis/nestjs/nest/master.svg?label=linux" alt="Linux" /></a>
-<a href="https://coveralls.io/github/nestjs/nest?branch=master"><img src="https://coveralls.io/repos/github/nestjs/nest/badge.svg?branch=master#5" alt="Coverage" /></a>
+<a href="https://coveralls.io/github/nestjs/nest?branch=master"><img src="https://coveralls.io/repos/github/nestjs/nest/badge.svg?branch=master#8" alt="Coverage" /></a>
 <a href="https://gitter.im/nestjs/nestjs?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=body_badge"><img src="https://badges.gitter.im/nestjs/nestjs.svg" alt="Gitter" /></a>
+<a href="https://discord.gg/G7Qnnhy"><img src="https://img.shields.io/badge/discord-online-brightgreen.svg" alt="Discord"/></a>
 <a href="https://opencollective.com/nest#backer"><img src="https://opencollective.com/nest/backers/badge.svg" alt="Backers on Open Collective" /></a>
 <a href="https://opencollective.com/nest#sponsor"><img src="https://opencollective.com/nest/sponsors/badge.svg" alt="Sponsors on Open Collective" /></a>
+  <a href="https://paypal.me/kamilmysliwiec"><img src="https://img.shields.io/badge/Donate-PayPal-ff3f59.svg"/></a>
+  <a href="https://twitter.com/nestframework"><img src="https://img.shields.io/twitter/follow/nestframework.svg?style=social&label=Follow"></a>
 </p>
   <!--[![Backers on Open Collective](https://opencollective.com/nest/backers/badge.svg)](https://opencollective.com/nest#backer)
   [![Sponsors on Open Collective](https://opencollective.com/nest/sponsors/badge.svg)](https://opencollective.com/nest#sponsor)-->
@@ -25,7 +28,8 @@
 ## Description
 
 <p>Nest is a framework for building efficient, scalable <a href="http://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with  <a href="http://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).</p>
-<p>Under the hood, Nest makes use of <a href="https://expressjs.com/" target="_blank">Express</a>, allowing for easy use of the myriad third-party plugins which are available.</p>
+
+<p>Under the hood, Nest makes use of <a href="https://expressjs.com/" target="_blank">Express</a>, but also, provides compatibility with a wide range of other libraries, like e.g. <a href="https://github.com/fastify/fastify" target="blank">Fastify</a>, allowing for easy use of the myriad third-party plugins which are available.</p>
 
 ## Philosophy
 
@@ -34,52 +38,45 @@
 
 ## Getting started
 
-To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
+* To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
+* 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
 
-## Sponsors
+## Support
 
-Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://opencollective.com/nest). Thanks! :heart_eyes:
+Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
 
-<a href="https://valor-software.com/"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="210" /></a> &nbsp; &nbsp; <a href="https://scal.io"><img src="https://nestjs.com/img/scalio-logo.png" width="160" /></a>
+#### Principal Sponsor
 
-## Backers 
+<a href="https://valor-software.com/"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="320" /></a>
 
-<a href="https://opencollective.com/nest/backer/0/website" target="_blank"><img src="https://opencollective.com/nest/backer/0/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/1/website" target="_blank"><img src="https://opencollective.com/nest/backer/1/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/2/website" target="_blank"><img src="https://opencollective.com/nest/backer/2/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/3/website" target="_blank"><img src="https://opencollective.com/nest/backer/3/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/4/website" target="_blank"><img src="https://opencollective.com/nest/backer/4/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/5/website" target="_blank"><img src="https://opencollective.com/nest/backer/5/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/6/website" target="_blank"><img src="https://opencollective.com/nest/backer/6/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/7/website" target="_blank"><img src="https://opencollective.com/nest/backer/7/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/8/website" target="_blank"><img src="https://opencollective.com/nest/backer/8/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/9/website" target="_blank"><img src="https://opencollective.com/nest/backer/9/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/10/website" target="_blank"><img src="https://opencollective.com/nest/backer/10/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/11/website" target="_blank"><img src="https://opencollective.com/nest/backer/11/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/12/website" target="_blank"><img src="https://opencollective.com/nest/backer/12/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/13/website" target="_blank"><img src="https://opencollective.com/nest/backer/13/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/14/website" target="_blank"><img src="https://opencollective.com/nest/backer/14/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/15/website" target="_blank"><img src="https://opencollective.com/nest/backer/15/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/16/website" target="_blank"><img src="https://opencollective.com/nest/backer/16/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/17/website" target="_blank"><img src="https://opencollective.com/nest/backer/17/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/18/website" target="_blank"><img src="https://opencollective.com/nest/backer/18/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/19/website" target="_blank"><img src="https://opencollective.com/nest/backer/19/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/20/website" target="_blank"><img src="https://opencollective.com/nest/backer/20/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/21/website" target="_blank"><img src="https://opencollective.com/nest/backer/21/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/22/website" target="_blank"><img src="https://opencollective.com/nest/backer/22/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/23/website" target="_blank"><img src="https://opencollective.com/nest/backer/23/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/24/website" target="_blank"><img src="https://opencollective.com/nest/backer/24/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/25/website" target="_blank"><img src="https://opencollective.com/nest/backer/25/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/26/website" target="_blank"><img src="https://opencollective.com/nest/backer/26/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/27/website" target="_blank"><img src="https://opencollective.com/nest/backer/27/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/28/website" target="_blank"><img src="https://opencollective.com/nest/backer/28/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/29/website" target="_blank"><img src="https://opencollective.com/nest/backer/29/avatar.svg"></a>
+#### Base Sponsor
 
-## People
+<a href="https://blueanchor.io/"><img src="https://nestjs.com/img/blueanchor.png" width="300" /></a> &nbsp;
+<a href="https://www.novologic.com/"><img src="https://nestjs.com/img/novologic.png" width="200" /></a>
 
-- Author - [Kamil Myśliwiec](https://kamilmysliwiec.com)
-- Website - [https://nestjs.com](https://nestjs.com/)
+#### Silver Sponsors
+<a href="https://neoteric.eu/"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> &nbsp;
+  <a href="http://gojob.com"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" height="95" /></a> &nbsp; <a href="https://www.swingdev.io"><img src="https://nestjs.com/img/swingdev-logo.svg#1" width="150" valign="middle" /> </a> &nbsp; &nbsp;
+  <a href="https://yakaz.com/"><img src="https://nestjs.com/img/yakaz.png" width="100" valign="middle" /></a> 
+  <a href="http://xtremis.com/"><img src="https://nestjs.com/img/logo-xtremis.svg" width="150" valign="middle" /></a> 
+
+#### Sponsors
+
+<a href="https://scal.io"><img src="https://nestjs.com/img/scalio-logo.svg" width="110" valign="middle" /></a> &nbsp; <a href="http://angularity.io"><img src="http://angularity.io/media/logo.svg" height="30" valign="middle" /></a> &nbsp; <!--<a href="https://keycdn.com"><img src="https://nestjs.com/img/keycdn.svg" height="30" /></a> &nbsp;--> <a href="https://hostpresto.com"><img src="https://nestjs.com/img/hostpresto.png" height="30" valign="middle" /></a> &nbsp; <a href="https://genuinebee.com/"><img src="https://nestjs.com/img/genuinebee.svg" height="38" valign="middle" /></a> &nbsp; <a href="http://architectnow.net/"><img src="https://nestjs.com/img/architectnow.png" height="24" valign="middle" /></a> &nbsp; <a href="https://quander.io/"><img src="https://nestjs.com/img/quander.png" height="28" valign="middle" /></a> &nbsp; <a href="https://mantro.net/"><img src="https://nestjs.com/img/mantro-logo.svg" height="20" valign="middle" /></a> &nbsp;
+
+<a href="https://triplebyte.com/"><img src="https://nestjs.com/img/triplebyte.png" height="30" valign="middle" /></a>
+
+
+## Backers
+
+<a href="https://opencollective.com/nest"><img src="https://opencollective.com/nest/backers.svg?width=890"></a>
+
+## Stay in touch
+
+* Author - [Kamil Myśliwiec](https://kamilmysliwiec.com)
+* Website - [https://nestjs.com](https://nestjs.com/)
+* Twitter - [@nestframework](https://twitter.com/nestframework)
 
 ## License
 
-  Nest is [MIT licensed](LICENSE).
+Nest is [MIT licensed](LICENSE).

benchmarks/all_output.txt

@@ -0,0 +1,48 @@
+-----------------------
+express
+-----------------------
+Running 10s test @ http://localhost:3000
+  8 threads and 1024 connections
+  Thread Stats   Avg      Stdev     Max   +/- Stdev
+    Latency    47.78ms   19.09ms 212.47ms   66.94%
+    Req/Sec     1.31k   268.90     2.07k    72.38%
+  104687 requests in 10.02s, 21.47MB read
+  Socket errors: connect 0, read 877, write 0, timeout 0
+Requests/sec:  10444.24
+Transfer/sec:      2.14MB
+-----------------------
+fastify
+-----------------------
+Running 10s test @ http://localhost:3000
+  8 threads and 1024 connections
+  Thread Stats   Avg      Stdev     Max   +/- Stdev
+    Latency    21.80ms    8.73ms  78.12ms   55.78%
+    Req/Sec     2.99k     0.92k    5.67k    68.88%
+  238550 requests in 10.02s, 31.17MB read
+  Socket errors: connect 0, read 862, write 0, timeout 0
+Requests/sec:  23795.79
+Transfer/sec:      3.11MB
+-----------------------
+nest
+-----------------------
+Running 10s test @ http://localhost:3000
+  8 threads and 1024 connections
+  Thread Stats   Avg      Stdev     Max   +/- Stdev
+    Latency    54.00ms   22.33ms 200.25ms   62.23%
+    Req/Sec     1.15k   338.60     1.88k    66.12%
+  91348 requests in 10.05s, 18.82MB read
+  Socket errors: connect 0, read 983, write 0, timeout 0
+Requests/sec:   9093.64
+Transfer/sec:      1.87MB
+-----------------------
+nest-fastify
+-----------------------
+Running 10s test @ http://localhost:3000
+  8 threads and 1024 connections
+  Thread Stats   Avg      Stdev     Max   +/- Stdev
+    Latency    29.31ms   11.71ms 101.96ms   70.03%
+    Req/Sec     2.17k     0.93k    4.12k    63.13%
+  173241 requests in 10.05s, 22.80MB read
+  Socket errors: connect 0, read 934, write 0, timeout 0
+Requests/sec:  17233.87
+Transfer/sec:      2.27MB

benchmarks/express.js

@@ -0,0 +1,7 @@
+'use strict';
+
+const express = require('express');
+const app = express();
+
+app.get('/', async (req, res) => res.send('Hello world'));
+app.listen(3000);

benchmarks/fastify.js

@@ -0,0 +1,5 @@
+'use strict';
+
+const fastify = require('fastify')();
+fastify.get('/', async (req, reply) => reply.send('Hello world'));
+fastify.listen(3000);

benchmarks/nest-fastify.js

@@ -0,0 +1,9 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+const core_1 = require('@nestjs/core');
+const app_module_1 = require('./nest/app.module');
+core_1.NestFactory.create(app_module_1.AppModule, new core_1.FastifyAdapter(), {
+  logger: false,
+  bodyParser: false,
+}).then(app => app.listen(3000));
+//# sourceMappingURL=main.js.map

benchmarks/nest.js

@@ -0,0 +1,9 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+const core_1 = require('@nestjs/core');
+const app_module_1 = require('./nest/app.module');
+core_1.NestFactory.create(app_module_1.AppModule, {
+  logger: false,
+  bodyParser: false,
+}).then(app => app.listen(3000));
+//# sourceMappingURL=main.js.map

benchmarks/nest/app.controller.d.ts

@@ -0,0 +1,3 @@
+export declare class AppController {
+  root(): string;
+}

benchmarks/nest/app.controller.js

@@ -0,0 +1,28 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const common_1 = require("@nestjs/common");
+let AppController = class AppController {
+    root() {
+        return 'Hello world!';
+    }
+};
+__decorate([
+    common_1.Get(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", String)
+], AppController.prototype, "root", null);
+AppController = __decorate([
+    common_1.Controller()
+], AppController);
+exports.AppController = AppController;
+//# sourceMappingURL=app.controller.js.map

benchmarks/nest/app.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.controller.js","sourceRoot":"","sources":["../src/app.controller.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,2CAAiD;AAGjD,IAAa,aAAa,GAA1B,MAAa,aAAa;IAExB,IAAI;QACF,OAAO,cAAc,CAAA;IACvB,CAAC;CACF,CAAA;AAHC;IADC,YAAG,EAAE;;;;yCAGL;AAJU,aAAa;IADzB,mBAAU,EAAE;GACA,aAAa,CAKzB;AALY,sCAAa"}

benchmarks/nest/app.module.d.ts

@@ -0,0 +1 @@
+export declare class AppModule {}

benchmarks/nest/app.module.js

@@ -6,14 +6,15 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const module_decorator_1 = require("../decorators/modules/module.decorator");
-const http_service_1 = require("./http.service");
-let HttpModule = class HttpModule {
+const common_1 = require("@nestjs/common");
+const app_controller_1 = require("./app.controller");
+let AppModule = class AppModule {
 };
-HttpModule = __decorate([
-    module_decorator_1.Module({
-        components: [http_service_1.HttpService],
-        exports: [http_service_1.HttpService],
+AppModule = __decorate([
+    common_1.Module({
+        imports: [],
+        controllers: [app_controller_1.AppController],
     })
-], HttpModule);
-exports.HttpModule = HttpModule;
+], AppModule);
+exports.AppModule = AppModule;
+//# sourceMappingURL=app.module.js.map

benchmarks/nest/app.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":";;;;;;;;AAAA,2CAAwC;AACxC,qDAAiD;AAMjD,IAAa,SAAS,GAAtB,MAAa,SAAS;CAAG,CAAA;AAAZ,SAAS;IAJrB,eAAM,CAAC;QACN,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,CAAC,8BAAa,CAAC;KAC7B,CAAC;GACW,SAAS,CAAG;AAAZ,8BAAS"}

benchmarks/nest/main.d.ts

@@ -0,0 +1 @@
+export {};

benchmarks/nest/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,6CAAyC;AAEzC,KAAK,UAAU,SAAS;IACtB,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,sBAAS,CAAC,CAAC;IAChD,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AACD,SAAS,EAAE,CAAC"}

benchmarks/run.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+echo 'Library:' $1
+node $1 &
+pid=$!
+
+sleep 2
+
+wrk 'http://localhost:3000' \
+  -d 10 \
+  -c 1024 \
+  -t 8 
+
+kill $pid

benchmarks/run_all.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+: > all_output.txt
+
+lib=(express fastify nest nest-fastify)
+for item in ${lib[*]}
+do
+  echo '-----------------------' >> all_output.txt
+  echo $item >> all_output.txt
+  echo '-----------------------' >> all_output.txt
+
+  node $item &
+  pid=$!
+
+  sleep 2
+  
+  wrk 'http://localhost:3000' \
+    -d 10 \
+    -c 1024 \
+    -t 8 >> all_output.txt
+
+    kill $pid
+done

examples/01-cats-app/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/01-cats-app/src/app.module.ts

@@ -1,16 +0,0 @@
-import { Module, NestModule, MiddlewaresConsumer } from '@nestjs/common';
-import { LoggerMiddleware } from './common/middlewares/logger.middleware';
-import { CatsModule } from './cats/cats.module';
-import { CatsController } from './cats/cats.controller';
-
-@Module({
-  imports: [CatsModule],
-})
-export class ApplicationModule implements NestModule {
-  configure(consumer: MiddlewaresConsumer): void {
-    consumer
-      .apply(LoggerMiddleware)
-      .with('ApplicationModule')
-      .forRoutes(CatsController);
-  }
-}

examples/01-cats-app/src/common/exceptions/forbidden.exception.ts

@@ -1,8 +0,0 @@
-import { HttpException } from '@nestjs/common';
-import { HttpStatus } from '@nestjs/common';
-
-export class ForbiddenException extends HttpException {
-  constructor() {
-    super('Forbidden', HttpStatus.FORBIDDEN);
-  }
-}

examples/01-cats-app/src/common/filters/http-exception.filter.ts

@@ -1,14 +0,0 @@
-import { ExceptionFilter, Catch } from '@nestjs/common';
-import { HttpException } from '@nestjs/common';
-
-@Catch(HttpException)
-export class HttpExceptionFilter implements ExceptionFilter {
-  catch(exception: HttpException, response) {
-    const status = exception.getStatus();
-
-    response.status(status).json({
-      statusCode: status,
-      message: `It's a message from the exception filter`,
-    });
-  }
-}

examples/01-cats-app/src/common/interceptors/cache.interceptor.ts

@@ -1,19 +0,0 @@
-import { Interceptor, NestInterceptor, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/observable/of';
-
-@Interceptor()
-export abstract class CacheInterceptor implements NestInterceptor {
-  protected abstract readonly isCached: () => boolean;
-
-  intercept(
-    dataOrRequest,
-    context: ExecutionContext,
-    stream$: Observable<any>,
-  ): Observable<any> {
-    if (this.isCached()) {
-      return Observable.of([]);
-    }
-    return stream$;
-  }
-}

examples/01-cats-app/src/common/interceptors/exception.interceptor.ts

@@ -1,28 +0,0 @@
-import {
-  Interceptor,
-  NestInterceptor,
-  ExecutionContext,
-  HttpStatus,
-} from '@nestjs/common';
-import { HttpException } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/operator/catch';
-import 'rxjs/add/observable/throw';
-
-@Interceptor()
-export class ExceptionInterceptor implements NestInterceptor {
-  intercept(
-    dataOrRequest,
-    context: ExecutionContext,
-    stream$: Observable<any>,
-  ): Observable<any> {
-    return stream$.catch(err =>
-      Observable.throw(
-        new HttpException(
-          'Exception interceptor message',
-          HttpStatus.BAD_GATEWAY,
-        ),
-      ),
-    );
-  }
-}

examples/01-cats-app/src/common/interceptors/logging.interceptor.ts

@@ -1,17 +0,0 @@
-import { Interceptor, NestInterceptor, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/operator/do';
-
-@Interceptor()
-export class LoggingInterceptor implements NestInterceptor {
-  intercept(
-    dataOrRequest,
-    context: ExecutionContext,
-    stream$: Observable<any>,
-  ): Observable<any> {
-    console.log('Before...');
-    const now = Date.now();
-
-    return stream$.do(() => console.log(`After... ${Date.now() - now}ms`));
-  }
-}

examples/01-cats-app/src/common/interceptors/mixin-cache.interceptor.ts

@@ -1,10 +0,0 @@
-import { mixin } from '@nestjs/common';
-import { CacheInterceptor } from './cache.interceptor';
-
-export function mixinCacheInterceptor(isCached: () => boolean) {
-  return mixin(
-    class extends CacheInterceptor {
-      protected readonly isCached = isCached;
-    },
-  );
-}

examples/01-cats-app/src/common/interceptors/transform.interceptor.ts

@@ -1,14 +0,0 @@
-import { Interceptor, NestInterceptor, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/operator/map';
-
-@Interceptor()
-export class TransformInterceptor implements NestInterceptor {
-  intercept(
-    dataOrRequest,
-    context: ExecutionContext,
-    stream$: Observable<any>,
-  ): Observable<any> {
-    return stream$.map(data => ({ data }));
-  }
-}

examples/01-cats-app/src/common/middlewares/logger.middleware.ts

@@ -1,11 +0,0 @@
-import { Middleware, NestMiddleware, ExpressMiddleware } from '@nestjs/common';
-
-@Middleware()
-export class LoggerMiddleware implements NestMiddleware {
-  resolve(name: string): ExpressMiddleware {
-    return (req, res, next) => {
-      console.log(`[${name}] Request...`); // [ApplicationModule] Request...
-      next();
-    };
-  }
-}

examples/01-cats-app/src/common/pipes/parse-int.pipe.ts

@@ -1,18 +0,0 @@
-import { HttpException } from '@nestjs/common';
-import {
-  PipeTransform,
-  Pipe,
-  ArgumentMetadata,
-  HttpStatus,
-} from '@nestjs/common';
-
-@Pipe()
-export class ParseIntPipe implements PipeTransform<string> {
-  async transform(value: string, metadata: ArgumentMetadata) {
-    const val = parseInt(value, 10);
-    if (isNaN(val)) {
-      throw new HttpException('Validation failed', HttpStatus.BAD_REQUEST);
-    }
-    return val;
-  }
-}

examples/02-gateways/client/index.html

@@ -1,22 +0,0 @@
-<html>
-    <head>
-        <script src="socket.io.js"></script>
-        <script>
-            const socket = io('http://localhost:3000');
-            socket.on('connect', function() {
-                console.log('Connected');
-                socket.emit('events', { test: 'test' });
-            });
-            socket.on('events', function(data) {
-                console.log('event', data);
-            });
-            socket.on('exception', function(data) {
-                console.log('event', data);
-            });
-            socket.on('disconnect', function() {
-                console.log('Disconnected');
-            });
-        </script>
-    </head>
-    <body></body>
-</html>

examples/02-gateways/client/ws.html

@@ -1,18 +0,0 @@
-<html>
-    <head>
-        <script>
-            const socket = new WebSocket('ws://localhost:81');
-            socket.onopen = function() {
-                console.log('Connected');
-                socket.send(JSON.stringify({
-                    type: 'events',
-                    message: 'test',
-                }));
-                socket.onmessage = function(data) {
-                    console.log(data);
-                }
-            };
-        </script>
-    </head>
-    <body></body>
-</html>

examples/02-gateways/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/02-gateways/src/common/adapters/ws-adapter.ts

@@ -1,45 +0,0 @@
-import * as WebSocket from 'ws';
-import { WebSocketAdapter } from '@nestjs/common';
-import { MessageMappingProperties } from '@nestjs/websockets';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/observable/fromEvent';
-import 'rxjs/add/observable/empty';
-import 'rxjs/add/operator/switchMap';
-import 'rxjs/add/operator/filter';
-
-export class WsAdapter implements WebSocketAdapter {
-  public create(port: number) {
-    return new WebSocket.Server({ port });
-  }
-
-  public bindClientConnect(server, callback: (...args: any[]) => void) {
-    server.on('connection', callback);
-  }
-
-  public bindMessageHandlers(
-    client: WebSocket,
-    handlers: MessageMappingProperties[],
-    process: (data: any) => Observable<any>,
-  ) {
-    Observable.fromEvent(client, 'message')
-      .switchMap(buffer => this.bindMessageHandler(buffer, handlers, process))
-      .filter(result => !!result)
-      .subscribe(response => client.send(JSON.stringify(response)));
-  }
-
-  public bindMessageHandler(
-    buffer,
-    handlers: MessageMappingProperties[],
-    process: (data: any) => Observable<any>,
-  ): Observable<any> {
-    const data = JSON.parse(buffer.data);
-    const messageHandler = handlers.find(
-      handler => handler.message === data.type,
-    );
-    if (!messageHandler) {
-      return Observable.empty();
-    }
-    const { callback } = messageHandler;
-    return process(callback(data));
-  }
-}

examples/02-gateways/src/common/filters/ws-exception.filter.ts

@@ -1,12 +0,0 @@
-import { Catch, WsExceptionFilter } from '@nestjs/common';
-import { WsException } from '@nestjs/websockets';
-
-@Catch(WsException)
-export class ExceptionFilter implements WsExceptionFilter {
-  catch(exception: WsException, client) {
-    client.emit('exception', {
-      status: 'error',
-      message: `It's a message from the exception filter`,
-    });
-  }
-}

examples/02-gateways/src/common/guards/roles.guard.ts

@@ -1,21 +0,0 @@
-import { Guard, CanActivate, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import { Reflector } from '@nestjs/core';
-
-@Guard()
-export class RolesGuard implements CanActivate {
-  constructor(private readonly reflector: Reflector) {}
-
-  canActivate(data, context: ExecutionContext): boolean {
-    const { parent, handler } = context;
-    const roles = this.reflector.get<string[]>('roles', handler);
-    if (!roles) {
-      return true;
-    }
-
-    const user = data.user;
-    const hasRole = () =>
-      !!user.roles.find(role => !!roles.find(item => item === role));
-    return user && user.roles && hasRole();
-  }
-}

examples/02-gateways/src/common/interceptors/cache.interceptor.ts

@@ -1,18 +0,0 @@
-import { Interceptor, NestInterceptor, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/observable/of';
-
-@Interceptor()
-export class CacheInterceptor implements NestInterceptor {
-  intercept(
-    dataOrRequest,
-    context: ExecutionContext,
-    stream$: Observable<any>,
-  ): Observable<any> {
-    const isCached = true;
-    if (isCached) {
-      return Observable.of([]);
-    }
-    return stream$;
-  }
-}

examples/02-gateways/src/common/interceptors/logging.interceptor.ts

@@ -1,17 +0,0 @@
-import { Interceptor, NestInterceptor, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/operator/do';
-
-@Interceptor()
-export class LoggingInterceptor implements NestInterceptor {
-  intercept(
-    dataOrRequest,
-    context: ExecutionContext,
-    stream$: Observable<any>,
-  ): Observable<any> {
-    console.log('Before...');
-    const now = Date.now();
-
-    return stream$.do(() => console.log(`After... ${Date.now() - now}ms`));
-  }
-}

examples/02-gateways/src/common/interceptors/transform.interceptor.ts

@@ -1,14 +0,0 @@
-import { Interceptor, NestInterceptor, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/operator/map';
-
-@Interceptor()
-export class TransformInterceptor implements NestInterceptor {
-  intercept(
-    dataOrRequest,
-    context: ExecutionContext,
-    stream$: Observable<any>,
-  ): Observable<any> {
-    return stream$.map(data => ({ data }));
-  }
-}

examples/02-gateways/src/events/events.gateway.ts

@@ -1,23 +0,0 @@
-import {
-  WebSocketGateway,
-  SubscribeMessage,
-  WsResponse,
-  WebSocketServer,
-  WsException,
-} from '@nestjs/websockets';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/observable/from';
-import 'rxjs/add/operator/map';
-
-@WebSocketGateway()
-export class EventsGateway {
-  @WebSocketServer() server;
-
-  @SubscribeMessage('events')
-  onEvent(client, data): Observable<WsResponse<number>> {
-    const event = 'events';
-    const response = [1, 2, 3];
-
-    return Observable.from(response).map(res => ({ event, data: res }));
-  }
-}

examples/03-microservices/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/03-microservices/src/common/adapters/rabbitmq-client.ts

@@ -1,44 +0,0 @@
-import * as amqp from 'amqplib';
-import { ClientProxy } from '@nestjs/microservices';
-
-export class RabbitMQClient extends ClientProxy {
-  constructor(private readonly host: string, private readonly queue: string) {
-    super();
-  }
-
-  protected async sendSingleMessage(
-    messageObj,
-    callback: (err, result, disposed?: boolean) => void,
-  ) {
-    const server = await amqp.connect(this.host);
-    const channel = await server.createChannel();
-    const { sub, pub } = this.getQueues();
-
-    channel.assertQueue(sub, { durable: false });
-    channel.assertQueue(pub, { durable: false });
-
-    channel.consume(
-      pub,
-      message => this.handleMessage(message, server, callback),
-      { noAck: true },
-    );
-    channel.sendToQueue(sub, Buffer.from(JSON.stringify(messageObj)));
-  }
-
-  private handleMessage(
-    message,
-    server,
-    callback: (err, result, disposed?: boolean) => void,
-  ) {
-    const { content } = message;
-    const { err, response, disposed } = JSON.parse(content.toString());
-    if (disposed) {
-      server.close();
-    }
-    callback(err, response, disposed);
-  }
-
-  private getQueues() {
-    return { pub: `${this.queue}_pub`, sub: `${this.queue}_sub` };
-  }
-}

examples/03-microservices/src/common/adapters/rabbitmq-server.ts

@@ -1,53 +0,0 @@
-import * as amqp from 'amqplib';
-import { Server, CustomTransportStrategy } from '@nestjs/microservices';
-import { Observable } from 'rxjs/Observable';
-
-export class RabbitMQServer extends Server implements CustomTransportStrategy {
-  private server: amqp.Connection = null;
-  private channel: amqp.Channel = null;
-
-  constructor(private readonly host: string, private readonly queue: string) {
-    super();
-  }
-
-  public async listen(callback: () => void) {
-    await this.init();
-    this.channel.consume(`${this.queue}_sub`, this.handleMessage.bind(this), {
-      noAck: true,
-    });
-  }
-
-  public close() {
-    this.channel && this.channel.close();
-    this.server && this.server.close();
-  }
-
-  private async handleMessage(message) {
-    const { content } = message;
-    const messageObj = JSON.parse(content.toString());
-
-    const handlers = this.getHandlers();
-    const pattern = JSON.stringify(messageObj.pattern);
-    if (!this.messageHandlers[pattern]) {
-      return;
-    }
-
-    const handler = this.messageHandlers[pattern];
-    const response$ = this.transformToObservable(
-      await handler(messageObj.data),
-    ) as Observable<any>;
-    response$ && this.send(response$, data => this.sendMessage(data));
-  }
-
-  private sendMessage(message) {
-    const buffer = Buffer.from(JSON.stringify(message));
-    this.channel.sendToQueue(`${this.queue}_pub`, buffer);
-  }
-
-  private async init() {
-    this.server = await amqp.connect(this.host);
-    this.channel = await this.server.createChannel();
-    this.channel.assertQueue(`${this.queue}_sub`, { durable: false });
-    this.channel.assertQueue(`${this.queue}_pub`, { durable: false });
-  }
-}

examples/03-microservices/src/common/decorators/roles.decorator.ts

@@ -1,3 +0,0 @@
-import { ReflectMetadata } from '@nestjs/common';
-
-export const Roles = (...roles: string[]) => ReflectMetadata('roles', roles);

examples/03-microservices/src/common/guards/roles.guard.ts

@@ -1,21 +0,0 @@
-import { Guard, CanActivate, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import { Reflector } from '@nestjs/core';
-
-@Guard()
-export class RolesGuard implements CanActivate {
-  constructor(private readonly reflector: Reflector) {}
-
-  canActivate(data, context: ExecutionContext): boolean {
-    const { parent, handler } = context;
-    const roles = this.reflector.get<string[]>('roles', handler);
-    if (!roles) {
-      return true;
-    }
-
-    const user = data.user;
-    const hasRole = () =>
-      !!user.roles.find(role => !!roles.find(item => item === role));
-    return user && user.roles && hasRole();
-  }
-}

examples/03-microservices/src/common/interceptors/cache.interceptor.ts

@@ -1,18 +0,0 @@
-import { Interceptor, NestInterceptor, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/observable/of';
-
-@Interceptor()
-export class CacheInterceptor implements NestInterceptor {
-  intercept(
-    dataOrRequest,
-    context: ExecutionContext,
-    stream$: Observable<any>,
-  ): Observable<any> {
-    const isCached = true;
-    if (isCached) {
-      return Observable.of([]);
-    }
-    return stream$;
-  }
-}

examples/03-microservices/src/common/interceptors/logging.interceptor.ts

@@ -1,17 +0,0 @@
-import { Interceptor, NestInterceptor, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/operator/do';
-
-@Interceptor()
-export class LoggingInterceptor implements NestInterceptor {
-  intercept(
-    dataOrRequest,
-    context: ExecutionContext,
-    stream$: Observable<any>,
-  ): Observable<any> {
-    console.log('Before...');
-    const now = Date.now();
-
-    return stream$.do(() => console.log(`After... ${Date.now() - now}ms`));
-  }
-}

examples/03-microservices/src/common/interceptors/transform.interceptor.ts

@@ -1,14 +0,0 @@
-import { Interceptor, NestInterceptor, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs/Observable';
-import 'rxjs/add/operator/map';
-
-@Interceptor()
-export class TransformInterceptor implements NestInterceptor {
-  intercept(
-    dataOrRequest,
-    context: ExecutionContext,
-    stream$: Observable<any>,
-  ): Observable<any> {
-    return stream$.map(data => ({ data }));
-  }
-}

examples/03-microservices/src/common/pipes/validation.pipe.ts

@@ -1,25 +0,0 @@
-import { PipeTransform, Pipe, ArgumentMetadata } from '@nestjs/common';
-import { validate } from 'class-validator';
-import { plainToClass } from 'class-transformer';
-import { RpcException } from '@nestjs/microservices';
-
-@Pipe()
-export class ValidationPipe implements PipeTransform<any> {
-  async transform(value, metadata: ArgumentMetadata) {
-    const { metatype } = metadata;
-    if (!metatype || !this.toValidate(metatype)) {
-      return value;
-    }
-    const object = plainToClass(metatype, value);
-    const errors = await validate(object);
-    if (errors.length > 0) {
-      throw new RpcException('Validation failed');
-    }
-    return value;
-  }
-
-  private toValidate(metatype): boolean {
-    const types = [String, Boolean, Number, Array, Object];
-    return !types.find(type => metatype === type);
-  }
-}

examples/03-microservices/src/main.ts

@@ -1,18 +0,0 @@
-import { NestFactory } from '@nestjs/core';
-import { Transport } from '@nestjs/microservices';
-import { ApplicationModule } from './app.module';
-
-async function bootstrap() {
-  const app = await NestFactory.createMicroservice(ApplicationModule);
-  await app.listenAsync();
-
-  /** Hybrid application (HTTP + (n)Microservices)
-  const app = await NestFactory.create(ApplicationModule);
-  app.connectMicroservice({
-    transport: Transport.TCP,
-  });
-
-  await app.startAllMicroservicesAsync();
-  await app.listen(3001); */
-}
-bootstrap();

examples/04-injector/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/04-injector/package.json

@@ -1,26 +0,0 @@
-{
-  "name": "nest-typescript-starter",
-  "version": "1.0.0",
-  "description": "Nest TypeScript starter repository",
-  "license": "MIT",
-  "scripts": {
-    "start": "node index.js",
-    "prestart:prod": "tsc",
-    "start:prod": "node dist/main.js"
-  },
-  "dependencies": {
-    "@nestjs/common": "^4.3.0",
-    "@nestjs/core": "^4.3.0",
-    "@nestjs/microservices": "^4.3.0",
-    "@nestjs/testing": "^4.3.0",
-    "@nestjs/websockets": "^4.3.0",
-    "redis": "^2.7.1",
-    "reflect-metadata": "^0.1.10",
-    "rxjs": "^5.4.3",
-    "typescript": "^2.4.2"
-  },
-  "devDependencies": {
-    "@types/node": "^7.0.41",
-    "ts-node": "^3.3.0"
-  }
-}

examples/04-injector/src/app.module.ts

@@ -1,8 +0,0 @@
-import { Module } from '@nestjs/common';
-import { CoreModule } from './core/core.module';
-import { FeatureModule } from './feature/feature.module';
-
-@Module({
-  imports: [FeatureModule],
-})
-export class ApplicationModule {}

examples/04-injector/src/common/common.module.ts

@@ -1,8 +0,0 @@
-import { Module, SingleScope } from '@nestjs/common';
-import { CommonService } from './common.service';
-
-@Module({
-  components: [CommonService],
-  exports: [CommonService],
-})
-export class CommonModule {}

examples/04-injector/src/common/common.service.ts

@@ -1,9 +0,0 @@
-import { Component } from '@nestjs/common';
-import { CoreService } from '../core/core.service';
-
-@Component()
-export class CommonService {
-  constructor(private readonly coreService: CoreService) {
-    console.log('CommonService', coreService);
-  }
-}

examples/04-injector/src/core/context.service.ts

@@ -1,10 +0,0 @@
-import { Component } from '@nestjs/common';
-import { CommonService } from '../common/common.service';
-import { CoreService } from './core.service';
-
-@Component()
-export class ContextService {
-  constructor(private readonly commonService: CoreService) {
-    console.log('ContextService', commonService);
-  }
-}

examples/04-injector/src/core/core.module.ts

@@ -1,12 +0,0 @@
-import { Module } from '@nestjs/common';
-import { CoreService } from './core.service';
-import { CommonModule } from '../common/common.module';
-import { ContextService } from './context.service';
-import { FeatureModule } from '../feature/feature.module';
-
-@Module({
-  imports: [CommonModule],
-  components: [CoreService, ContextService],
-  exports: [CommonModule],
-})
-export class CoreModule {}

examples/04-injector/src/core/core.service.ts

@@ -1,8 +0,0 @@
-import { Component } from '@nestjs/common';
-
-@Component()
-export class CoreService {
-  constructor() {
-    console.log('CoreService');
-  }
-}

examples/04-injector/src/feature/feature.module.ts

@@ -1,9 +0,0 @@
-import { Module } from '@nestjs/common';
-import { FeatureService } from './feature.service';
-import { CoreModule } from '../core/core.module';
-
-@Module({
-  imports: [CoreModule],
-  components: [FeatureService],
-})
-export class FeatureModule {}

examples/04-injector/src/feature/feature.service.ts

@@ -1,9 +0,0 @@
-import { Component } from '@nestjs/common';
-import { CommonService } from '../common/common.service';
-
-@Component()
-export class FeatureService {
-  constructor(private readonly commonService: CommonService) {
-    console.log('FeatureService', commonService);
-  }
-}

examples/05-sql-typeorm/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/05-sql-typeorm/package.json

@@ -1,26 +0,0 @@
-{
-  "name": "nest-typescript-starter",
-  "version": "1.0.0",
-  "description": "Nest TypeScript starter repository",
-  "license": "MIT",
-  "scripts": {
-    "start": "node index.js",
-    "prestart:prod": "tsc",
-    "start:prod": "node dist/main.js"
-  },
-  "dependencies": {
-    "@nestjs/common": "^4.5.0",
-    "@nestjs/core": "^4.5.0",
-    "@nestjs/typeorm": "^2.0.0",
-    "mysql": "^2.14.1",
-    "redis": "^2.7.1",
-    "reflect-metadata": "^0.1.10",
-    "rxjs": "^5.4.3",
-    "typeorm": "0.1.0-alpha.40",
-    "typescript": "^2.4.2"
-  },
-  "devDependencies": {
-    "@types/node": "^7.0.41",
-    "ts-node": "^3.3.0"
-  }
-}

examples/06-mongoose/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/06-mongoose/package.json

@@ -1,28 +0,0 @@
-{
-  "name": "nest-typescript-starter",
-  "version": "1.0.0",
-  "description": "Nest TypeScript starter repository",
-  "license": "MIT",
-  "scripts": {
-    "start": "node index.js",
-    "prestart:prod": "tsc",
-    "start:prod": "node dist/main.js"
-  },
-  "dependencies": {
-    "@nestjs/common": "^4.3.0",
-    "@nestjs/core": "^4.3.0",
-    "@nestjs/microservices": "^4.3.0",
-    "@nestjs/testing": "^4.3.0",
-    "@nestjs/websockets": "^4.3.0",
-    "mongoose": "^5.0.1",
-    "redis": "^2.7.1",
-    "reflect-metadata": "^0.1.10",
-    "rxjs": "^5.4.3",
-    "typescript": "^2.4.2"
-  },
-  "devDependencies": {
-    "@types/mongoose": "^4.7.23",
-    "@types/node": "^7.0.41",
-    "ts-node": "^3.3.0"
-  }
-}

examples/06-mongoose/src/database/database.module.ts

@@ -1,8 +0,0 @@
-import { Module } from '@nestjs/common';
-import { databaseProviders } from './database.providers';
-
-@Module({
-  components: [...databaseProviders],
-  exports: [...databaseProviders],
-})
-export class DatabaseModule {}

examples/07-sequelize/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/08-passport/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/08-passport/package.json

@@ -1,30 +0,0 @@
-{
-  "name": "nest-typescript-starter",
-  "version": "1.0.0",
-  "description": "Nest TypeScript starter repository",
-  "license": "MIT",
-  "scripts": {
-    "start": "node index.js",
-    "prestart:prod": "tsc",
-    "start:prod": "node dist/main.js"
-  },
-  "dependencies": {
-    "@nestjs/common": "^4.3.0",
-    "@nestjs/core": "^4.3.0",
-    "@nestjs/microservices": "^4.3.0",
-    "@nestjs/testing": "^4.3.0",
-    "@nestjs/websockets": "^4.3.0",
-    "@types/passport-jwt": "^2.0.24",
-    "jsonwebtoken": "^8.0.1",
-    "passport": "^0.4.0",
-    "passport-jwt": "^3.0.0",
-    "redis": "^2.7.1",
-    "reflect-metadata": "^0.1.10",
-    "rxjs": "^5.4.3",
-    "typescript": "^2.4.2"
-  },
-  "devDependencies": {
-    "@types/node": "^7.0.41",
-    "ts-node": "^3.3.0"
-  }
-}

examples/08-passport/src/auth/auth.controller.ts

@@ -1,18 +0,0 @@
-import { Controller, Post, HttpStatus, HttpCode, Get } from '@nestjs/common';
-import { AuthService } from './auth.service';
-
-@Controller('auth')
-export class AuthController {
-  constructor(private readonly authService: AuthService) {}
-
-  @Post('token')
-  @HttpCode(HttpStatus.OK)
-  public async getToken() {
-    return await this.authService.createToken();
-  }
-
-  @Get('authorized')
-  public async authorized() {
-    console.log('Authorized route...');
-  }
-}

examples/08-passport/src/auth/auth.module.ts

@@ -1,22 +0,0 @@
-import * as passport from 'passport';
-import {
-  Module,
-  NestModule,
-  MiddlewaresConsumer,
-  RequestMethod,
-} from '@nestjs/common';
-import { AuthService } from './auth.service';
-import { JwtStrategy } from './passport/jwt.strategy';
-import { AuthController } from './auth.controller';
-
-@Module({
-  components: [AuthService, JwtStrategy],
-  controllers: [AuthController],
-})
-export class AuthModule implements NestModule {
-  public configure(consumer: MiddlewaresConsumer) {
-    consumer
-      .apply(passport.authenticate('jwt', { session: false }))
-      .forRoutes({ path: '/auth/authorized', method: RequestMethod.ALL });
-  }
-}

examples/08-passport/src/auth/auth.service.ts

@@ -1,22 +0,0 @@
-import * as jwt from 'jsonwebtoken';
-import { Component, Inject } from '@nestjs/common';
-
-@Component()
-export class AuthService {
-  async createToken() {
-    const expiresIn = 60 * 60,
-      secretOrKey = 'secret';
-    const user = { email: 'thisis@example.com' };
-    const token = jwt.sign(user, secretOrKey, { expiresIn });
-    return {
-      expires_in: expiresIn,
-      access_token: token,
-    };
-  }
-
-  async validateUser(signedUser): Promise<boolean> {
-    // put some validation logic here
-    // for example query user by id / email / username
-    return true;
-  }
-}

examples/08-passport/src/auth/passport/jwt.strategy.ts

@@ -1,27 +0,0 @@
-import * as passport from 'passport';
-import { ExtractJwt, Strategy } from 'passport-jwt';
-import { Component, Inject } from '@nestjs/common';
-import { AuthService } from '../auth.service';
-
-@Component()
-export class JwtStrategy extends Strategy {
-  constructor(private readonly authService: AuthService) {
-    super(
-      {
-        jwtFromRequest: ExtractJwt.fromAuthHeaderAsBearerToken(),
-        passReqToCallback: true,
-        secretOrKey: 'secret',
-      },
-      async (req, payload, next) => await this.verify(req, payload, next),
-    );
-    passport.use(this);
-  }
-
-  public async verify(req, payload, done) {
-    const isValid = await this.authService.validateUser(payload);
-    if (!isValid) {
-      return done('Unauthorized', false);
-    }
-    done(null, payload);
-  }
-}

examples/09-babel-example/src/app.module.js

@@ -1,8 +0,0 @@
-import { Module } from '@nestjs/common';
-import { CatsModule } from './cats/cats.module';
-import { CatsController } from './cats/cats.controller';
-
-@Module({
-    imports: [CatsModule],
-})
-export class ApplicationModule {}

examples/10-mockgoose/e2e/cats/cats.e2e-spec.ts

@@ -1,44 +0,0 @@
-import * as express from 'express';
-import * as bodyParser from 'body-parser';
-import * as request from 'supertest';
-import { Test } from '@nestjs/testing';
-import { CatsModule } from '../../src/cats/cats.module';
-
-describe('Cats', () => {
-  const server = express();
-  server.use(bodyParser.json());
-
-  beforeAll(async () => {
-    const module = await Test.createTestingModule({
-      imports: [CatsModule],
-    }).compile();
-
-    const app = module.createNestApplication(server);
-    await app.init();
-  });
-
-  it(`/POST insert cat`, () => {
-    return request(server)
-      .post('/cats')
-      .send({
-        name: 'Tiger',
-        age: 2,
-        breed: 'Russian Blue',
-      })
-      .expect(201);
-  });
-
-  it(`/GET cats`, async done => {
-    const cats = await request(server)
-      .get('/cats')
-      .expect(200);
-
-    const [cat] = cats.body;
-
-    expect(cat.name).toBe('Tiger');
-    expect(cat.age).toBe(2);
-    expect(cat.breed).toBe('Russian Blue');
-
-    done();
-  });
-});

examples/10-mockgoose/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/10-mockgoose/package.json

@@ -1,35 +0,0 @@
-{
-  "name": "nest-typescript-starter",
-  "version": "1.0.0",
-  "description": "Nest TypeScript starter repository",
-  "license": "MIT",
-  "scripts": {
-    "start": "node index.js",
-    "prestart:prod": "tsc",
-    "start:prod": "node dist/main.js",
-    "e2e": "jest --config=e2e/jest-e2e.json --forceExit",
-    "e2e:watch": "jest --watch --config=e2e/jest-e2e.json"
-  },
-  "dependencies": {
-    "@nestjs/common": "^4.3.0",
-    "@nestjs/core": "^4.3.0",
-    "@nestjs/microservices": "^4.3.0",
-    "@nestjs/testing": "^4.3.0",
-    "@nestjs/websockets": "^4.3.0",
-    "mongoose": "^4.11.13",
-    "redis": "^2.7.1",
-    "reflect-metadata": "^0.1.10",
-    "rxjs": "^5.4.3",
-    "typescript": "^2.4.2"
-  },
-  "devDependencies": {
-    "@types/mongoose": "^4.7.23",
-    "@types/jest": "^20.0.8",
-    "@types/node": "^7.0.41",
-    "mockgoose-fix": "^7.3.6",
-    "jest": "^20.0.4",
-    "supertest": "^3.0.0",
-    "ts-jest": "^20.0.14",
-    "ts-node": "^3.3.0"
-  }
-}

examples/10-mockgoose/src/cats/cats.providers.ts

@@ -1,10 +0,0 @@
-import * as mongoose from 'mongoose';
-import { CatSchema } from './schemas/cat.schema';
-
-export const catsProviders = [
-  {
-    provide: 'CatModelToken',
-    useFactory: mongoose => mongoose.connection.model('Cat', CatSchema),
-    inject: ['DbToken'],
-  },
-];

examples/10-mockgoose/src/database/database.providers.ts

@@ -1,28 +0,0 @@
-import * as mongoose from 'mongoose';
-import { Mockgoose } from 'mockgoose-fix';
-
-export const databaseProviders = [
-  {
-    provide: 'DbToken',
-    useFactory: async () => {
-      (mongoose as any).Promise = global.Promise;
-
-      if (process.env.NODE_ENV === 'test') {
-        const mockgoose = new Mockgoose(mongoose);
-        mockgoose.helper.setDbVersion('3.4.3');
-
-        mockgoose.prepareStorage().then(async () => {
-          await mongoose.connect('mongodb://example.com/TestingDB', {
-            useMongoClient: true,
-          });
-        });
-      } else {
-        await mongoose.connect('mongodb://localhost/nest', {
-          useMongoClient: true,
-        });
-      }
-
-      return mongoose;
-    },
-  },
-];

examples/11-swagger/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/11-swagger/src/app.module.ts

@@ -1,8 +0,0 @@
-import { Module, NestModule, MiddlewaresConsumer } from '@nestjs/common';
-import { CatsModule } from './cats/cats.module';
-import { CatsController } from './cats/cats.controller';
-
-@Module({
-  imports: [CatsModule],
-})
-export class ApplicationModule {}

examples/12-graphql-apollo/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/12-graphql-apollo/src/app.module.ts

@@ -1,43 +0,0 @@
-import {
-  Module,
-  MiddlewaresConsumer,
-  NestModule,
-  RequestMethod,
-} from '@nestjs/common';
-import { graphqlExpress, graphiqlExpress } from 'apollo-server-express';
-import { GraphQLModule, GraphQLFactory } from '@nestjs/graphql';
-
-import { CatsModule } from './cats/cats.module';
-import { SubscriptionsModule } from './subscriptions/subscriptions.module';
-
-@Module({
-  imports: [SubscriptionsModule.forRoot(), CatsModule, GraphQLModule],
-})
-export class ApplicationModule implements NestModule {
-  constructor(
-    private readonly subscriptionsModule: SubscriptionsModule,
-    private readonly graphQLFactory: GraphQLFactory,
-  ) {}
-
-  configure(consumer: MiddlewaresConsumer) {
-    const schema = this.createSchema();
-    this.subscriptionsModule.createSubscriptionServer(schema);
-
-    consumer
-      .apply(
-        graphiqlExpress({
-          endpointURL: '/graphql',
-          subscriptionsEndpoint: `ws://localhost:3001/subscriptions`,
-        }),
-      )
-      .forRoutes({ path: '/graphiql', method: RequestMethod.GET })
-      .apply(graphqlExpress(req => ({ schema, rootValue: req })))
-      .forRoutes({ path: '/graphql', method: RequestMethod.ALL });
-  }
-
-  createSchema() {
-    const typeDefs = this.graphQLFactory.mergeTypesByPaths('./**/*.graphql');
-    const schema = this.graphQLFactory.createSchema({ typeDefs });
-    return schema;
-  }
-}

examples/12-graphql-apollo/src/cats/cats.guard.ts

@@ -1,8 +0,0 @@
-import { CanActivate, Guard, ExecutionContext } from '@nestjs/common';
-
-@Guard()
-export class CatsGuard implements CanActivate {
-  canActivate(request: any, context: ExecutionContext): boolean {
-    return true;
-  }
-}

examples/12-graphql-apollo/src/subscriptions/subscription.constants.ts

@@ -1 +0,0 @@
-export const SUBSCRIPTION_SERVER = 'SUBSCRIPTION_SERVER';

examples/12-graphql-apollo/src/subscriptions/subscription.providers.ts

@@ -1,15 +0,0 @@
-import { createServer } from 'http';
-
-import { SUBSCRIPTION_SERVER } from './subscription.constants';
-
-export const createSubscriptionProviders = (port: number = 3001) => [
-  {
-    provide: SUBSCRIPTION_SERVER,
-    useFactory: () => {
-      const server = createServer();
-      return new Promise(resolve =>
-        server.listen(port, () => resolve(server)),
-      );
-    },
-  },
-];

examples/12-graphql-apollo/src/subscriptions/subscriptions.module.ts

@@ -1,49 +0,0 @@
-import * as WebSocket from 'ws';
-import { Module, DynamicModule, Inject, OnModuleDestroy } from '@nestjs/common';
-import { SubscriptionServer, ServerOptions } from 'subscriptions-transport-ws';
-import { execute, subscribe } from 'graphql';
-
-import { createSubscriptionProviders } from './subscription.providers';
-import { SUBSCRIPTION_SERVER } from './subscription.constants';
-
-@Module({
-  exports: [SubscriptionsModule],
-})
-export class SubscriptionsModule implements OnModuleDestroy {
-  private subscriptionServer: SubscriptionServer;
-
-  constructor(@Inject(SUBSCRIPTION_SERVER) private readonly ws) {}
-
-  static forRoot(port: number = 3001): DynamicModule {
-    const providers = createSubscriptionProviders(port);
-    return {
-      module: SubscriptionsModule,
-      components: [...providers],
-      exports: [...providers],
-    };
-  }
-
-  createSubscriptionServer(
-    schema: any,
-    options: ServerOptions = {},
-    socketOptions: WebSocket.ServerOption = {},
-  ) {
-    this.subscriptionServer = new SubscriptionServer(
-      {
-        execute,
-        subscribe,
-        schema,
-        ...options,
-      },
-      {
-        server: this.ws,
-        path: '/subscriptions',
-        ...socketOptions,
-      },
-    );
-  }
-
-  onModuleDestroy() {
-    this.ws.close();
-  }
-}

examples/13-mongo-typeorm/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/14-mongoose-module/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/15-mvc/README.md

@@ -1,80 +0,0 @@
-<p align="center">
-  <a href="http://nestjs.com/" target="blank"><img src="http://kamilmysliwiec.com/public/nest-logo.png#1" alt="Nest Logo" /></a>
-</p>
-
-[travis-image]: https://api.travis-ci.org/nestjs/nest.svg?branch=master
-[travis-url]: https://travis-ci.org/nestjs/nest
-[linux-image]: https://img.shields.io/travis/nestjs/nest/master.svg?label=linux
-[linux-url]: https://travis-ci.org/nestjs/nest
-  
- <p align="center">A progressive <a href="http://nodejs.org" target="blank">Node.js</a> framework for building efficient and scalable web applications. </p>
-    <p align="center">
-<a href="https://www.npmjs.com/~nestjscore"><img src="https://img.shields.io/npm/v/@nestjs/cqrs.svg" alt="NPM Version" /></a>
-<a href="https://www.npmjs.com/~nestjscore"><img src="https://img.shields.io/npm/l/@nestjs/core.svg" alt="Package License" /></a>
-<a href="https://www.npmjs.com/~nestjscore"><img src="https://img.shields.io/npm/dm/@nestjs/core.svg" alt="NPM Downloads" /></a>
-<a href="https://travis-ci.org/nestjs/nest"><img src="https://api.travis-ci.org/nestjs/nest.svg?branch=master" alt="Travis" /></a>
-<a href="https://travis-ci.org/nestjs/nest"><img src="https://img.shields.io/travis/nestjs/nest/master.svg?label=linux" alt="Linux" /></a>
-<a href="https://coveralls.io/github/nestjs/nest?branch=master"><img src="https://coveralls.io/repos/github/nestjs/nest/badge.svg?branch=master#2" alt="Coverage" /></a>
-<a href="https://gitter.im/nestjs/nestjs?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=body_badge"><img src="https://badges.gitter.im/nestjs/nestjs.svg" alt="Gitter" /></a>
-<a href="https://opencollective.com/nest#backer"><img src="https://opencollective.com/nest/backers/badge.svg" alt="Backers on Open Collective" /></a>
-<a href="https://opencollective.com/nest#sponsor"><img src="https://opencollective.com/nest/sponsors/badge.svg" alt="Sponsors on Open Collective" /></a>
-</p>
-  <!--[![Backers on Open Collective](https://opencollective.com/nest/backers/badge.svg)](https://opencollective.com/nest#backer)
-  [![Sponsors on Open Collective](https://opencollective.com/nest/sponsors/badge.svg)](https://opencollective.com/nest#sponsor)-->
-
-## Description
-
-[Nest](https://github.com/nestjs/nest) framework **TypeScript** starter repository. 
-  
-## Installation
-
-```bash
-$ npm install
-```
-
-## Start
-
-```
-$ npm run start
-```
-
-## People
-
-- Author - [Kamil Myśliwiec](https://kamilmysliwiec.com)
-- Website - [https://nestjs.com](https://nestjs.com/)
-
-## Backers
-
-I am on a mission to provide an architecture to create truly flexible, scalable and loosely coupled systems using the Node.js platform. It takes a lot of time, so if you want to support me, please [become a backer / sponsor]((https://opencollective.com/nest#backer)). I appreciate your help. Thanks! :heart_eyes:
-
-<a href="https://opencollective.com/nest/backer/0/website" target="_blank"><img src="https://opencollective.com/nest/backer/0/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/1/website" target="_blank"><img src="https://opencollective.com/nest/backer/1/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/2/website" target="_blank"><img src="https://opencollective.com/nest/backer/2/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/3/website" target="_blank"><img src="https://opencollective.com/nest/backer/3/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/4/website" target="_blank"><img src="https://opencollective.com/nest/backer/4/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/5/website" target="_blank"><img src="https://opencollective.com/nest/backer/5/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/6/website" target="_blank"><img src="https://opencollective.com/nest/backer/6/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/7/website" target="_blank"><img src="https://opencollective.com/nest/backer/7/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/8/website" target="_blank"><img src="https://opencollective.com/nest/backer/8/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/9/website" target="_blank"><img src="https://opencollective.com/nest/backer/9/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/10/website" target="_blank"><img src="https://opencollective.com/nest/backer/10/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/11/website" target="_blank"><img src="https://opencollective.com/nest/backer/11/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/12/website" target="_blank"><img src="https://opencollective.com/nest/backer/12/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/13/website" target="_blank"><img src="https://opencollective.com/nest/backer/13/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/14/website" target="_blank"><img src="https://opencollective.com/nest/backer/14/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/15/website" target="_blank"><img src="https://opencollective.com/nest/backer/15/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/16/website" target="_blank"><img src="https://opencollective.com/nest/backer/16/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/17/website" target="_blank"><img src="https://opencollective.com/nest/backer/17/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/18/website" target="_blank"><img src="https://opencollective.com/nest/backer/18/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/19/website" target="_blank"><img src="https://opencollective.com/nest/backer/19/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/20/website" target="_blank"><img src="https://opencollective.com/nest/backer/20/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/21/website" target="_blank"><img src="https://opencollective.com/nest/backer/21/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/22/website" target="_blank"><img src="https://opencollective.com/nest/backer/22/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/23/website" target="_blank"><img src="https://opencollective.com/nest/backer/23/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/24/website" target="_blank"><img src="https://opencollective.com/nest/backer/24/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/25/website" target="_blank"><img src="https://opencollective.com/nest/backer/25/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/26/website" target="_blank"><img src="https://opencollective.com/nest/backer/26/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/27/website" target="_blank"><img src="https://opencollective.com/nest/backer/27/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/28/website" target="_blank"><img src="https://opencollective.com/nest/backer/28/avatar.svg"></a>
-<a href="https://opencollective.com/nest/backer/29/website" target="_blank"><img src="https://opencollective.com/nest/backer/29/avatar.svg"></a>
-

examples/15-mvc/index.js

@@ -1,2 +0,0 @@
-require('ts-node/register');
-require('./src/main');

examples/15-mvc/src/views/index.jade

@@ -1,4 +0,0 @@
-html
-  head
-  body
-    p= message

gulpfile.js

@@ -1,65 +1,100 @@
+const fs = require('fs');
+const path = require('path');
 const gulp = require('gulp');
 const ts = require('gulp-typescript');
-const gulpSequence = require('gulp-sequence');
+const sourcemaps = require('gulp-sourcemaps');
+const clean = require('gulp-clean');
+const deleteEmpty = require('delete-empty');
 
 const packages = {
-	common: ts.createProject('src/common/tsconfig.json'),
-	core: ts.createProject('src/core/tsconfig.json'),
-	microservices: ts.createProject('src/microservices/tsconfig.json'),
-	websockets: ts.createProject('src/websockets/tsconfig.json'),
-	testing: ts.createProject('src/testing/tsconfig.json'),
+  common: ts.createProject('packages/common/tsconfig.json'),
+  core: ts.createProject('packages/core/tsconfig.json'),
+  microservices: ts.createProject('packages/microservices/tsconfig.json'),
+  websockets: ts.createProject('packages/websockets/tsconfig.json'),
+  testing: ts.createProject('packages/testing/tsconfig.json'),
 };
 const modules = Object.keys(packages);
-const source = 'src';
+const source = 'packages';
 const distId = process.argv.indexOf('--dist');
-const dist = distId < 0 ? 'node_modules/@nestjs' : process.argv[distId + 1];
+const dist = distId < 0 ? source : process.argv[distId + 1];
 
 gulp.task('default', function() {
-	modules.forEach(module => {
-		gulp.watch(
-			[`${source}/${module}/**/*.ts`, `${source}/${module}/*.ts`],
-			[module]
-		);
-	});
+  modules.forEach(module => {
+    gulp.watch(
+      [`${source}/${module}/**/*.ts`, `${source}/${module}/*.ts`],
+      [module],
+    );
+  });
+});
+
+gulp.task('copy-misc', function() {
+  return gulp
+    .src(['Readme.md', 'LICENSE', '.npmignore'])
+    .pipe(gulp.dest(`${source}/common`))
+    .pipe(gulp.dest(`${source}/core`))
+    .pipe(gulp.dest(`${source}/microservices`))
+    .pipe(gulp.dest(`${source}/websockets`))
+    .pipe(gulp.dest(`${source}/testing`));
+});
+
+gulp.task('clean:output', function() {
+  return gulp
+    .src([`${source}/**/*.js`, `${source}/**/*.d.ts`], {
+      read: false,
+    })
+    .pipe(clean());
+});
+
+gulp.task('clean:dirs', function(done) {
+  deleteEmpty.sync(`${source}/`);
+  done();
+});
+
+gulp.task('clean:bundle', gulp.series('clean:output', 'clean:dirs'));
+
+modules.forEach(module => {
+  gulp.task(module, () => {
+    return packages[module]
+      .src()
+      .pipe(packages[module]())
+      .pipe(gulp.dest(`${dist}/${module}`));
+  });
 });
 
 modules.forEach(module => {
-	gulp.task(module, () => {
-		return packages[module]
-			.src()
-			.pipe(packages[module]())
-			.pipe(gulp.dest(`${dist}/${module}`));
-	});
+  gulp.task(module + ':dev', () => {
+    return packages[module]
+      .src()
+      .pipe(sourcemaps.init())
+      .pipe(packages[module]())
+      .pipe(
+        sourcemaps.mapSources(sourcePath => './' + sourcePath.split('/').pop()),
+      )
+      .pipe(sourcemaps.write('.'))
+      .pipe(gulp.dest(`${dist}/${module}`));
+  });
 });
 
-gulp.task('build', function(cb) {
-	gulpSequence('common', modules.filter((module) => module !== 'common'), cb);
-});
+gulp.task('common:dev', gulp.series(modules.map(module => module + ':dev')));
+gulp.task('build', gulp.series(modules));
+gulp.task('build:dev', gulp.series('common:dev'));
 
+function getFolders(dir) {
+  return fs.readdirSync(dir).filter(function(file) {
+    return fs.statSync(path.join(dir, file)).isDirectory();
+  });
+}
 gulp.task('move', function() {
-	gulp.src(['node_modules/@nestjs/**/*']).pipe(
-    gulp.dest('examples/01-cats-app/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/02-gateways/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/03-microservices/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/04-injector/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/05-sql-typeorm/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/06-mongoose/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/07-sequelize/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/08-passport/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/09-babel-example/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/11-swagger/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/12-graphql-apollo/node_modules/@nestjs')
-  ).pipe(
-    gulp.dest('examples/15-mvc/node_modules/@nestjs')
-  );
+  const getDirs = base => getFolders(base).map(path => `${base}/${path}`);
+
+  const examplesDirs = getDirs('sample');
+  const integrationDirs = getDirs('integration');
+  const directories = examplesDirs.concat(integrationDirs);
+
+  let stream = gulp.src(['node_modules/@nestjs/**/*']);
+
+  directories.forEach(dir => {
+    stream = stream.pipe(gulp.dest(dir + '/node_modules/@nestjs'));
+  });
+  return stream;
 });

integration/docker-compose.yml

@@ -0,0 +1,46 @@
+version: "3"
+
+services:
+  redis:
+    container_name: test-redis
+    image: redis
+    ports:
+      - "6379:6379"
+    restart: always
+  nats:
+    container_name: test-nats
+    image: nats
+    ports:
+      - "8222:8222"
+      - "4222:4222"
+      - "6222:6222"
+    restart: always
+  mqtt:
+    container_name: test-mqtt
+    image: toke/mosquitto
+    ports:
+      - "1883:1883"
+      - "9001:9001"
+    restart: always
+  mysql:
+    image: mysql:5.7.22
+    restart: always
+    environment:
+      MYSQL_ROOT_PASSWORD: root
+      MYSQL_DATABASE: test
+    ports:
+      - "3306:3306"
+    restart: always
+  mongodb:
+    image: mongo:latest
+    environment:
+      - MONGODB_DATABASE="test"
+    ports:
+      - 27017:27017
+  rabbit:
+    hostname: rabbit
+    image: "rabbitmq:management"
+    ports:
+      - "15672:15672"
+      - "5672:5672"
+    tty: true

integration/graphql/e2e/graphql-async-class.spec.ts

@@ -0,0 +1,38 @@
+import { INestApplication } from '@nestjs/common';
+import { NestFactory } from '@nestjs/core';
+import * as request from 'supertest';
+import { AsyncClassApplicationModule } from '../src/async-options-class.module';
+
+describe('GraphQL (async class)', () => {
+  let app: INestApplication;
+
+  beforeEach(async () => {
+    app = await NestFactory.create(AsyncClassApplicationModule, {
+      logger: false,
+    });
+    await app.init();
+  });
+
+  it(`should return query result`, () => {
+    return request(app.getHttpServer())
+      .post('/graphql')
+      .send({
+        operationName: null,
+        variables: {},
+        query: '{\n  getCats {\n    id\n  }\n}\n',
+      })
+      .expect(200, {
+        data: {
+          getCats: [
+            {
+              id: 1,
+            },
+          ],
+        },
+      });
+  });
+
+  afterEach(async () => {
+    await app.close();
+  });
+});

integration/graphql/e2e/graphql-async-existing.spec.ts

@@ -0,0 +1,38 @@
+import { INestApplication } from '@nestjs/common';
+import { NestFactory } from '@nestjs/core';
+import * as request from 'supertest';
+import { AsyncExistingApplicationModule } from '../src/async-options-existing.module';
+
+describe('GraphQL (async existing)', () => {
+  let app: INestApplication;
+
+  beforeEach(async () => {
+    app = await NestFactory.create(AsyncExistingApplicationModule, {
+      logger: false,
+    });
+    await app.init();
+  });
+
+  it(`should return query result`, () => {
+    return request(app.getHttpServer())
+      .post('/graphql')
+      .send({
+        operationName: null,
+        variables: {},
+        query: '{\n  getCats {\n    id\n  }\n}\n',
+      })
+      .expect(200, {
+        data: {
+          getCats: [
+            {
+              id: 1,
+            },
+          ],
+        },
+      });
+  });
+
+  afterEach(async () => {
+    await app.close();
+  });
+});