tests() exclude async hooks

bugfix(core) fix interceptors execution flow

.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

@@ -6,14 +6,18 @@ node_modules/
 /.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
@@ -24,3 +28,4 @@ npm-debug.log
 /test
 /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

.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

.travis.yml

@@ -1,14 +1,24 @@
 language: node_js
 node_js:
-      - "7"
+  - "8"
+  - "9"
+  - "10"
+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,261 +0,0 @@
-## 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

@@ -0,0 +1,330 @@
+# Contributing to Nest
+
+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)
+* [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]. -->
+
+## <a name="question"></a> Got a Question or Problem?
+
+**Do not open issues for general support questions as we want to keep GitHub issues for bug reports and feature requests.** You've got much better chances of getting your question answered on [Stack Overflow](https://stackoverflow.com/questions/tagged/nestjs) where the questions should be tagged with tag `nestjs`.
+
+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.
+
+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
+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".
+* **Small Features** can be crafted and directly [submitted as a Pull Request](#submit-pr).
+
+## <a name="submit"></a> Submission Guidelines
+
+### <a name="submit-issue"></a> Submitting an Issue
+
+Before you submit an issue, please search the issue tracker, maybe an issue for your problem already exists and the discussion might inform you of workarounds readily available.
+
+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
+
+<!--
+// TODO we need to create a playground, similar to plunkr
+
+A minimal reproduce scenario using a repository or Gist allows us to quickly confirm a bug (or point out coding problem) as well as confirm that we are fixing the right problem. If neither of these are not a suitable way to demonstrate the problem (for example for issues related to our npm packaging), please create a standalone git repository demonstrating the problem. -->
+
+<!-- We will be insisting on a minimal reproduce scenario in order to save maintainers time and ultimately be able to fix more bugs. Interestingly, from our experience users often find coding problems themselves while preparing a minimal plunk. We understand that sometimes it might be hard to extract essentials bits of code from a larger code-base but we really need to isolate the problem before we can fix it. -->
+
+Unfortunately, we are not able to investigate / fix bugs without a minimal reproduction, so if we don't hear back from you we are going to close an issue that don't have enough info to be reproduced.
+
+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. Fork the nestjs/nest repo.
+1. Make your changes in a new git branch:
+
+   ```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. 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.
+
+   ```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
+   ```
+
+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):
+
+    ```shell
+    git rebase master -i
+    git push -f
+    ```
+
+That's it! Thank you for your contribution!
+
+#### After your pull request is merged
+
+After your pull request is merged, you can safely delete your branch and pull the changes
+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
+  ```
+
+* Check out the master branch:
+
+  ```shell
+  git checkout master -f
+  ```
+
+* Delete the local branch:
+
+  ```shell
+  git branch -D my-fix-branch
+  ```
+
+* Update your master with the latest upstream version:
+
+  ```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.
+
+### 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:
+
+<!--
+// 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 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
+format that includes a **type**, a **scope** and a **subject**:
+
+```
+<type>(<scope>): <subject>
+<BLANK LINE>
+<body>
+<BLANK LINE>
+<footer>
+```
+
+The **header** is mandatory and the **scope** of the header is optional.
+
+Any line of the commit message cannot be longer 100 characters! This allows the message to be easier
+to read on GitHub as well as in various git tools.
+
+Footer should contain a [closing reference to an issue](https://help.github.com/articles/closing-issues-via-commit-messages/) if any.
+
+Samples: (even more [samples](https://github.com/nestjs/nest/commits/master))
+
+```
+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.
+
+### 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
+* **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**
+* **sample**
+* **microservices**
+* **testing**
+* **websockets**
+
+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
+* **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"
+* don't capitalize first letter
+* 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**.
+
+**Breaking Changes** should start with the word `BREAKING CHANGE:` with a space or two newlines. The rest of the commit message is then used for this.
+
+A detailed explanation can be found in this [document][commit-message-format].
+
+<!-- ## <a name="cla"></a> Signing the CLA
+
+Please sign our Contributor License Agreement (CLA) before sending pull requests. For any code
+changes to be accepted, the CLA must be signed. It's a quick process, we promise!
+
+* For individuals we have a [simple click-through form][individual-cla].
+* 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
+[github]: https://github.com/nestjs/nest
+[gitter]: https://gitter.im/nestjs/nest
+[individual-cla]: http://code.google.com/legal/individual-cla-v1.0.html
+[js-style-guide]: https://google.github.io/styleguide/jsguide.html
+[jsfiddle]: http://jsfiddle.net
+[plunker]: http://plnkr.co/edit
+[runnable]: http://runnable.com
+
+<!-- [stackoverflow]: http://stackoverflow.com/questions/tagged/angular -->

Readme.md

@@ -1,126 +1,76 @@
 <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 web applications. :cat: </p>
+
+  <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>
 <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#4" 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://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)-->
 
 ## Description
 
-<p>Nest is a framework for building efficient, scalable <a href="http://nodejs.org" target="_blank">Node.js</a> web 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>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>, 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
 
 <p>In recent years, thanks to Node.js, JavaScript has become the “lingua franca” of the web for both front and backend applications, giving rise to awesome projects like <a href="https://angular.io/" target="_blank">Angular</a>, <a href="https://github.com/facebook/react" target="_blank">React</a> and <a href="https://github.com/vuejs/vue" target="_blank">Vue</a> which improve developer productivity and enable the construction of fast, testable, extensible frontend applications. However, on the server-side, while there are a lot of superb libraries, helpers and tools for Node, none of them effectively solve the main problem - the architecture.</p>
 <p>Nest aims to provide an application architecture out of the box which allows for effortless creation of highly testable, scalable, loosely coupled and easily maintainable applications.</p>
 
-## Features
+## Getting started
 
-<ul>
-    <li>Built with <a href="http://www.typescriptlang.org" target="_blank">TypeScript</a> (compatible with pure JavaScript + <a href="http://babeljs.io/" target="_blank">Babel</a>)</li>
-    <li><strong>Easy</strong> to learn - syntax similar to <a href="https://angular.io/" target="_blank">Angular</a></li>
-    <li><strong>Familiar</strong> - based on well-known libraries (<a href="https://github.com/expressjs/express" target="_blank">Express</a> / <a href="https://github.com/socketio/socket.io" target="_blank">socket.io</a>)</li>
-    <li><strong>Dependency Injection</strong> - built-in asynchronous <strong>IoC</strong> container with a <strong>hierarchical injector</strong></li>
-    <li><strong>WebSockets</strong> module (based on <a href="https://github.com/socketio/socket.io" target="_blank">socket.io</a>, but you can bring your own library, by making use of <code>WsAdapter</code>)</li>
-    <li><strong>Modular</strong> - defines an easy to follow module definition pattern so you can split your system into reusable modules</li>
-    <li><strong>Reactive microservice</strong> support with message patterns (built-in transport via TCP / <a href="https://redis.io/" target="_blank">Redis</a>, but other communication schemes can be implemented with <code>CustomTransportStrategy</code>)</li>
-    <li><strong>Exception layer</strong> - throwable web exceptions with status codes, exception filters</li>
-    <li><strong>Pipes</strong> - synchronous & asynchronous (e.g. validation purposes)</li>
-    <li><strong>Guards</strong> - attach additional logic in a declarative manner (e.g. role-based access control)</li>
-    <li><strong>Interceptors</strong> - built on top of <a href="https://github.com/reactivex/rxjs" target="blank">RxJS</a></li>
-    <li>Testing utilities (both <strong>e2e & unit</strong> tests)</li>
-  <li><strong>More</strong>!</li>
-  </ul>
+* 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:
 
-## Installation
+## Support
 
-**Install the TypeScript Starter Project with Git:**
-```bash
-$ git clone https://github.com/nestjs/typescript-starter.git project
-$ cd project
-$ npm install
-$ npm run start
-```
+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).
 
-**Install the JavaScript (Babel) Starter Project with Git:**
-```bash
-$ git clone https://github.com/nestjs/javascript-starter.git project
-$ cd project
-$ npm install
-$ npm run start
-```
+#### Principal Sponsor
 
-**Start a New Project from Scratch with NPM:**
-```bash
-$ npm i --save @nestjs/core @nestjs/common @nestjs/microservices @nestjs/websockets @nestjs/testing reflect-metadata rxjs
-```
+<a href="https://valor-software.com/"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="320" /></a>
 
-## Documentation & Quick Start
+#### Gold Sponsors
 
-:books: [Documentation & Tutorial](https://docs.nestjs.com)
+<a href="http://xtremis.com/"><img src="https://nestjs.com/img/logo-xtremis.svg" width="220" /></a> 
 
-## Sponsors
+#### Silver Sponsors
+<a href="https://neoteric.eu/"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" /></a> &nbsp;
+  <a href="http://gojob.com"><img src="http://nestjs.com/img/gojob-logo.png" valign="bottom" height="95" /></a> &nbsp; <a href="https://www.swingdev.io"><img src="https://nestjs.com/img/swingdev-logo.svg#1" width="150" /> </a>
+
+#### Sponsors
+
+<a href="https://scal.io"><img src="https://nestjs.com/img/scalio-logo.svg" width="110" /></a> &nbsp; <a href="http://angularity.io"><img src="http://angularity.io/media/logo.svg" height="30" /></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" /></a> &nbsp; <a href="https://genuinebee.com/"><img src="https://nestjs.com/img/genuinebee.svg" height="38" /></a> &nbsp; <a href="http://architectnow.net/"><img src="https://nestjs.com/img/architectnow.png" height="24" /></a> &nbsp; <a href="https://quander.io/"><img src="https://nestjs.com/img/quander.png" height="28" /></a>
 
-<a href="https://valor-software.com/"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="210" /></a>
 
 ## Backers
 
-Nest is an MIT-licensed open source project. It can grow thanks to the support by these awesome people. If you'd like to join them, please [read more here](https://opencollective.com/nest#backer). Thanks! :heart_eyes:
+<a href="https://opencollective.com/nest"><img src="https://opencollective.com/nest/backers.svg?width=890"></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>
+## Stay in touch
 
-## People
-
-- Author - [Kamil Myśliwiec](https://kamilmysliwiec.com)
-- Website - [https://nestjs.com](https://nestjs.com/)
+* Author - [Kamil Myśliwiec](https://kamilmysliwiec.com)
+* Website - [https://nestjs.com](https://nestjs.com/)
+* Twitter - [@nestframework](https://twitter.com/nestframework)
 
 ## License
 
-  [MIT](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,50 @@
+'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({ scope: common_1.Scope.REQUEST })],
+  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

@@ -0,0 +1,20 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const common_1 = require("@nestjs/common");
+const app_controller_1 = require("./app.controller");
+let AppModule = class AppModule {
+};
+AppModule = __decorate([
+    common_1.Module({
+        imports: [],
+        controllers: [app_controller_1.AppController],
+    })
+], 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/e2e/cats/cats.e2e-spec.ts

@@ -1,33 +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/modules/cats/cats.module';
-import { CatsService } from '../../src/modules/cats/cats.service';
-
-describe('Cats', () => {
-    const server = express();
-    server.use(bodyParser.json());
-
-    const catsService = { findAll: () => ['test'] };
-
-    beforeAll(async () => {
-        const module = await Test.createTestingModule({
-            modules: [CatsModule],
-          })
-          .overrideComponent(CatsService).useValue(catsService)
-          .compile();
-
-        const app = module.createNestApplication(server);
-        await app.init();
-    });
-
-    it(`/GET cats`, () => {
-        return request(server)
-            .get('/cats')
-            .expect(200)
-            .expect({
-              data: catsService.findAll(),
-            });
-    });
-});

examples/01-cats-app/index.js

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

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

@@ -1,15 +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({
-    modules: [CatsModule],
-})
-export class ApplicationModule implements NestModule {
-    configure(consumer: MiddlewaresConsumer): void {
-        consumer.apply(LoggerMiddleware)
-            .with('ApplicationModule')
-            .forRoutes(CatsController);
-    }
-}

examples/01-cats-app/src/modules/common/decorators/roles.decorator.ts

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

examples/01-cats-app/src/modules/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/modules/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/modules/common/guards/roles.guard.ts

@@ -1,20 +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(req, context: ExecutionContext): boolean {
-    const { parent, handler } = context;
-    const roles = this.reflector.get<string[]>('roles', handler);
-    if (!roles) {
-      return true;
-    }
-
-    const user = req.user;
-    const hasRole = () => !!user.roles.find((role) => !!roles.find((item) => item === role));
-    return user && user.roles && hasRole();
-  }
-}

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

@@ -1,15 +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/modules/common/interceptors/exception.interceptor.ts

@@ -1,14 +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/modules/common/interceptors/logging.interceptor.ts

@@ -1,15 +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/modules/common/interceptors/mixin-cache.interceptor.ts

@@ -1,8 +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/modules/common/interceptors/transform.interceptor.ts

@@ -1,10 +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/modules/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/modules/common/pipes/parse-int.pipe.ts

@@ -1,13 +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/01-cats-app/src/modules/common/pipes/validation.pipe.ts

@@ -1,25 +0,0 @@
-import { HttpException } from '@nestjs/common';
-import { PipeTransform, Pipe, ArgumentMetadata, HttpStatus } from '@nestjs/common';
-import { validate } from 'class-validator';
-import { plainToClass } from 'class-transformer';
-
-@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 HttpException('Validation failed', HttpStatus.BAD_REQUEST);
-      }
-      return value;
-    }
-
-    private toValidate(metatype): boolean {
-      const types = [String, Boolean, Number, Array, Object];
-      return !types.find((type) => metatype === type);
-    }
-}

examples/02-gateways/client/index.html

@@ -1,22 +0,0 @@
-<html>
-    <head>
-        <script src="socket.io.js"></script>
-        <script>
-            const socket = io('http://localhost:81');
-            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,14 +0,0 @@
-require('ts-node/register');
-require('./src/server');
-
-
-
-
-
-
-
-
-
-
-
-

examples/02-gateways/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/server.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",
-    "class-transformer": "^0.1.7",
-    "class-validator": "^0.7.2",
-    "redis": "^2.7.1",
-    "reflect-metadata": "^0.1.10",
-    "rxjs": "^5.4.3",
-    "typescript": "^2.4.2",
-    "ws": "^3.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^7.0.41",
-    "@types/ws": "^3.0.2",
-    "ts-node": "^3.3.0"
-  }
-}

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

@@ -1,43 +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/modules/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/modules/common/guards/roles.guard.ts

@@ -1,20 +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/modules/common/interceptors/cache.interceptor.ts

@@ -1,14 +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/modules/common/interceptors/logging.interceptor.ts

@@ -1,15 +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/modules/common/interceptors/transform.interceptor.ts

@@ -1,10 +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/modules/common/pipes/validation.pipe.ts

@@ -1,25 +0,0 @@
-import { PipeTransform, Pipe, ArgumentMetadata, HttpStatus } from '@nestjs/common';
-import { validate } from 'class-validator';
-import { plainToClass } from 'class-transformer';
-import { WsException } from '@nestjs/websockets';
-
-@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 WsException('Validation failed');
-      }
-      return value;
-    }
-
-    private toValidate(metatype): boolean {
-      const types = [String, Boolean, Number, Array, Object];
-      return !types.find((type) => metatype === type);
-    }
-}

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

@@ -1,18 +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(81)
-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,14 +0,0 @@
-require('ts-node/register');
-require('./src/server');
-
-
-
-
-
-
-
-
-
-
-
-

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

@@ -1,35 +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/modules/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/modules/common/guards/roles.guard.ts

@@ -1,20 +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/modules/common/interceptors/cache.interceptor.ts

@@ -1,14 +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/modules/common/interceptors/logging.interceptor.ts

@@ -1,15 +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/modules/common/interceptors/transform.interceptor.ts

@@ -1,10 +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/modules/common/pipes/validation.pipe.ts

@@ -1,26 +0,0 @@
-import { PipeTransform, Pipe, ArgumentMetadata, HttpStatus } from '@nestjs/common';
-import { validate } from 'class-validator';
-import { plainToClass } from 'class-transformer';
-import { WsException } from '@nestjs/websockets';
-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/server.ts

@@ -1,14 +0,0 @@
-import { NestFactory } from '@nestjs/core';
-import { ApplicationModule } from './modules/app.module';
-import { Transport } from '@nestjs/microservices';
-
-async function bootstrap() {
-  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,14 +0,0 @@
-require('ts-node/register');
-require('./src/server');
-
-
-
-
-
-
-
-
-
-
-
-

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/server.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/modules/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({
-  modules: [FeatureModule],
-})
-export class ApplicationModule {}

examples/04-injector/src/modules/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/modules/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/modules/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/modules/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({
-  modules: [CommonModule],
-  components: [CoreService, ContextService],
-  exports: [CommonModule],
-})
-export class CoreModule {}

examples/04-injector/src/modules/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/modules/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({
-  modules: [CoreModule],
-  components: [FeatureService],
-})
-export class FeatureModule {}

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

@@ -1,10 +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,14 +0,0 @@
-require('ts-node/register');
-require('./src/server');
-
-
-
-
-
-
-
-
-
-
-
-

examples/05-sql-typeorm/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/server.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",
-    "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/05-sql-typeorm/src/modules/app.module.ts

@@ -1,7 +0,0 @@
-import { Module } from '@nestjs/common';
-import { PhotoModule } from './photo/photo.module';
-
-@Module({
-  modules: [PhotoModule],
-})
-export class ApplicationModule {}

examples/05-sql-typeorm/src/modules/database/database.providers.ts

@@ -1,19 +0,0 @@
-import { createConnection } from 'typeorm';
-
-export const databaseProviders = [
-  {
-    provide: 'DbConnectionToken',
-    useFactory: async () => await createConnection({
-      type: 'mysql',
-      host: 'localhost',
-      port: 3306,
-      username: 'root',
-      password: 'root',
-      database: 'test',
-      entities: [
-          __dirname + '/../**/**.entity{.ts,.js}',
-      ],
-      autoSchemaSync: true,
-    }),
-  },
-];

examples/05-sql-typeorm/src/modules/photo/photo.entity.ts

@@ -1,22 +0,0 @@
-import { Entity, Column, PrimaryGeneratedColumn } from 'typeorm';
-
-@Entity()
-export class Photo {
-    @PrimaryGeneratedColumn()
-    id: number;
-
-    @Column({ length: 500 })
-    name: string;
-
-    @Column('text')
-    description: string;
-
-    @Column()
-    filename: string;
-
-    @Column('int')
-    views: number;
-
-    @Column()
-    isPublished: boolean;
-}

examples/05-sql-typeorm/src/modules/photo/photo.module.ts

@@ -1,13 +0,0 @@
-import { Module } from '@nestjs/common';
-import { DatabaseModule } from '../database/database.module';
-import { photoProviders } from './photo.providers';
-import { PhotoService } from './photo.service';
-
-@Module({
-  modules: [DatabaseModule],
-  components: [
-    ...photoProviders,
-    PhotoService,
-  ],
-})
-export class PhotoModule {}

examples/05-sql-typeorm/src/modules/photo/photo.providers.ts

@@ -1,10 +0,0 @@
-import { Connection, Repository } from 'typeorm';
-import { Photo } from './photo.entity';
-
-export const photoProviders = [
-  {
-    provide: 'PhotoRepositoryToken',
-    useFactory: (connection: Connection) => connection.getRepository(Photo),
-    inject: ['DbConnectionToken'],
-  },
-];

examples/06-mongoose/index.js

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

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/server.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": "^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/node": "^7.0.41",
-    "ts-node": "^3.3.0"
-  }
-}

examples/06-mongoose/src/modules/database/database.providers.ts

@@ -1,13 +0,0 @@
-import * as mongoose from 'mongoose';
-
-export const databaseProviders = [
-  {
-    provide: 'DbConnectionToken',
-    useFactory: async (): Promise<mongoose.Connection> => {
-      (mongoose as any).Promise = global.Promise;
-      return await mongoose.connect('mongodb://localhost/nest', {
-        useMongoClient: true,
-      });
-    },
-  },
-];

examples/07-sequelize/index.js

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

examples/07-sequelize/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/server.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",
-    "mysql2": "^1.4.2",
-    "redis": "^2.7.1",
-    "reflect-metadata": "^0.1.10",
-    "rxjs": "^5.4.3",
-    "sequelize": "^4.12.0",
-    "sequelize-typescript": "^0.5.0",
-    "typescript": "^2.4.2"
-  },
-  "devDependencies": {
-    "@types/node": "^7.0.41",
-    "@types/sequelize": "^4.0.75",
-    "ts-node": "^3.3.0"
-  }
-}

examples/07-sequelize/src/modules/cats/cats.module.ts

@@ -1,15 +0,0 @@
-import { Module } from '@nestjs/common';
-import { CatsController } from './cats.controller';
-import { CatsService } from './cats.service';
-import { catsProviders } from './cats.providers';
-import { DatabaseModule } from '../database/database.module';
-
-@Module({
-  modules: [DatabaseModule],
-  controllers: [CatsController],
-  components: [
-    CatsService,
-    ...catsProviders,
-  ],
-})
-export class CatsModule {}

examples/07-sequelize/src/modules/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/08-passport/index.js

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

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/server.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/modules/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/modules/auth/auth.module.ts

@@ -1,25 +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/modules/auth/auth.service.ts

@@ -1,21 +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/modules/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/08-passport/src/server.ts

@@ -1,8 +0,0 @@
-import { NestFactory } from '@nestjs/core';
-import { ApplicationModule } from './modules/app.module';
-
-async function bootstrap() {
-  const app = await NestFactory.create(ApplicationModule);
-  await app.listen(3001);
-}
-bootstrap();

examples/09-babel-example/src/modules/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({
-    modules: [CatsModule],
-})
-export class ApplicationModule {}

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

@@ -1,46 +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/modules/cats/cats.module';
-
-describe('Cats', () => {
-    const server = express();
-    server.use(bodyParser.json());
-
-    beforeAll(async () => {
-        const module = await Test.createTestingModule({
-            modules: [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,14 +0,0 @@
-require('ts-node/register');
-require('./src/server');
-
-
-
-
-
-
-
-
-
-
-
-

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/server.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": "^7.3.3",
-    "jest": "^20.0.4",
-    "supertest": "^3.0.0",
-    "ts-jest": "^20.0.14",
-    "ts-node": "^3.3.0"
-  }
-}

examples/10-mockgoose/src/modules/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/modules/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/10-mockgoose/src/modules/database/database.providers.ts

@@ -1,32 +0,0 @@
-import * as mongoose from 'mongoose';
-import { Mockgoose } from 'mockgoose';
-
-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/10-mockgoose/src/server.ts

@@ -1,8 +0,0 @@
-import { NestFactory } from '@nestjs/core';
-import { ApplicationModule } from './modules/app.module';
-
-async function bootstrap() {
-  const app = await NestFactory.create(ApplicationModule);
-  await app.listen(3011);
-}
-bootstrap();