@tsed/platform-serverless 7.0.0-alpha.1 → 7.0.0-beta.3

package/lib/esm/domain/ServerlessResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerlessResponse.js","sourceRoot":"","sources":["../../../src/domain/ServerlessResponse.ts"],"names":[],"mappings":"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","sourcesContent":["import {getValue} from \"@tsed/core\";\nimport {getStatusMessage} from \"@tsed/schema\";\nimport type {APIGatewayEventDefaultAuthorizerContext, APIGatewayProxyEventBase, Context} from \"aws-lambda\";\nimport encodeUrl from \"encodeurl\";\nimport * as mime from \"mime\";\nimport type {ServerlessRequest} from \"./ServerlessRequest\";\n\nexport interface ServerlessResponseOptions {\n  event: APIGatewayProxyEventBase<APIGatewayEventDefaultAuthorizerContext>;\n  context: Context;\n  request: ServerlessRequest;\n}\n\nexport type HeaderValue = boolean | number | string;\n\n/**\n * @platform\n */\nexport class ServerlessResponse {\n  readonly event: APIGatewayProxyEventBase<APIGatewayEventDefaultAuthorizerContext>;\n  readonly request: ServerlessRequest;\n\n  #status: number = 200;\n  #body: any = undefined;\n  #headers: Record<string, HeaderValue> = {};\n  #locals: Record<string, any> = {};\n  #isHeadersSent = false;\n  #endListeners: Function[] = [];\n\n  constructor({event, request}: ServerlessResponseOptions) {\n    this.event = event;\n    this.request = request;\n  }\n\n  /**\n   * Get the current statusCode\n   */\n  get statusCode() {\n    return this.#status;\n  }\n\n  set statusCode(status) {\n    this.#status = status;\n  }\n\n  /**\n   * An object that contains response local variables scoped to the request, and therefore available only to the view(s) rendered during that request / response cycle (if any). Otherwise, this property is identical to app.locals.\n   *\n   * This property is useful for exposing request-level information such as the request path name, authenticated user, user settings, and so on.\n   */\n  get locals() {\n    return this.#locals;\n  }\n\n  get isHeadersSent() {\n    return this.#isHeadersSent;\n  }\n\n  getStatus() {\n    return this.#status;\n  }\n\n  /**\n   * Sets the HTTP status for the response.\n   *\n   * @param status\n   */\n  status(status: number) {\n    this.#status = status;\n    return this;\n  }\n\n  set(name: string, value: any) {\n    return this.setHeader(name, value);\n  }\n\n  /**\n   * Returns the HTTP response header specified by field. The match is case-insensitive.\n   *\n   * ```typescript\n   * response.get('Content-Type') // => \"text/plain\"\n   * ```\n   *\n   * @param name\n   */\n  get(name: string): string | number | boolean | undefined {\n    return getValue(this.#headers, name.toLowerCase());\n  }\n\n  getHeaders(): Record<string, HeaderValue> {\n    return {\n      ...this.#headers\n    };\n  }\n\n  hasStatus() {\n    return this.#status !== 200;\n  }\n\n  /**\n   * Set header `field` to `val`, or pass\n   * an object of header fields.\n   *\n   * Examples:\n   * ```typescript\n   * response.setHeaders({ Accept: 'text/plain', 'X-API-Key': 'tobi' });\n   * ```\n   *\n   * Aliased as `res.header()`.\n   */\n  setHeaders(headers: Record<string, HeaderValue>) {\n    // apply headers\n    Object.entries(headers).forEach(([key, item]) => {\n      this.setHeader(key, item);\n    });\n\n    return this;\n  }\n\n  setHeader(key: string, item: HeaderValue | null | undefined) {\n    if (item !== null && item !== undefined) {\n      key = key.toLowerCase();\n\n      if (key === \"location\") {\n        // \"back\" is an alias for the referrer\n        if (item === \"back\") {\n          item = this.request.get(\"Referrer\") || \"/\";\n        }\n\n        item = encodeUrl(String(item));\n      }\n\n      this.#headers = {\n        ...this.#headers,\n        [key.toLowerCase()]: item as any\n      };\n    }\n\n    return this;\n  }\n\n  /**\n   * Set `Content-Type` response header with `type` through `mime.lookup()`\n   * when it does not contain \"/\", or set the Content-Type to `type` otherwise.\n   *\n   * Examples:\n   *\n   *     res.type('.html');\n   *     res.type('html');\n   *     res.type('json');\n   *     res.type('application/json');\n   *     res.type('png');\n   */\n  contentType(contentType: string) {\n    this.setHeader(\"Content-Type\", mime.getType(contentType));\n\n    return this;\n  }\n\n  contentLength(length: number) {\n    this.setHeader(\"Content-Length\", length);\n    return this;\n  }\n\n  getContentLength() {\n    if (this.get(\"Content-Length\")) {\n      return parseInt(this.get(\"Content-Length\") as any, 10) || 0;\n    }\n  }\n\n  getContentType() {\n    return String(this.get(\"Content-Type\") || \"\").split(\";\")[0];\n  }\n\n  /**\n   * Redirects to the URL derived from the specified path, with specified status, a positive integer that corresponds to an [HTTP status code](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html).\n   * If not specified, status defaults to `302 Found`.\n   *\n   * @param status\n   * @param url\n   */\n  redirect(status: number, url: string) {\n    // Set location header\n    const address = this.location(url).get(\"Location\");\n    const body = `${getStatusMessage(status)}. Redirecting to ${address}`;\n\n    this.status(status).set(\"Content-Length\", Buffer.byteLength(body)).body(body);\n\n    return this;\n  }\n\n  /**\n   * Sets the response Location HTTP header to the specified path parameter.\n   *\n   * @param url\n   */\n  location(url: string) {\n    return this.set(\"Location\", url);\n  }\n\n  /**\n   * Send any data to your consumer.\n   *\n   * This method accept a ReadableStream, a plain object, boolean, string, number, null and undefined data.\n   * It choose the better way to send the data.\n   *\n   * @param body\n   */\n  body(body: any) {\n    this.#body = body;\n\n    return this;\n  }\n\n  getBody() {\n    return this.#body;\n  }\n\n  isDone(): boolean {\n    return this.#isHeadersSent;\n  }\n\n  onEnd(cb: Function) {\n    this.#endListeners.push(cb);\n\n    return this;\n  }\n\n  destroy() {\n    this.#endListeners.forEach((cb: Function) => cb());\n    this.#isHeadersSent = true;\n  }\n}\n"]}

package/lib/esm/index.js

@@ -0,0 +1,10 @@
+export * from "@tsed/di";
+export { Get, Post, Put, Delete, Head, Patch, Options, Route as Lambda } from "@tsed/schema";
+export * from "@tsed/platform-params";
+export * from "./builder/PlatformServerlessHandler";
+export * from "./builder/PlatformServerless";
+// decorators
+export * from "./domain/ServerlessContext";
+export * from "./domain/ServerlessResponse";
+export * from "./domain/ServerlessResponse";
+//# sourceMappingURL=index.js.map

package/lib/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,OAAO,EAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,MAAM,EAAC,MAAM,cAAc,CAAC;AAC3F,cAAc,uBAAuB,CAAC;AAEtC,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAE7C,aAAa;AACb,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC","sourcesContent":["export * from \"@tsed/di\";\nexport {Get, Post, Put, Delete, Head, Patch, Options, Route as Lambda} from \"@tsed/schema\";\nexport * from \"@tsed/platform-params\";\n\nexport * from \"./builder/PlatformServerlessHandler\";\nexport * from \"./builder/PlatformServerless\";\n\n// decorators\nexport * from \"./domain/ServerlessContext\";\nexport * from \"./domain/ServerlessResponse\";\nexport * from \"./domain/ServerlessResponse\";\n"]}

package/lib/esm/utils/getRequestId.js

@@ -0,0 +1,9 @@
+import { v4 } from "uuid";
+export function getRequestId(event, context) {
+    var _a;
+    if ((event === null || event === void 0 ? void 0 : event.headers) && event.headers["x-request-id"]) {
+        return event.headers["x-request-id"];
+    }
+    return ((_a = event === null || event === void 0 ? void 0 : event.requestContext) === null || _a === void 0 ? void 0 : _a.requestId) || (context === null || context === void 0 ? void 0 : context.awsRequestId) || v4().replace(/-/gi, "");
+}
+//# sourceMappingURL=getRequestId.js.map

package/lib/esm/utils/getRequestId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRequestId.js","sourceRoot":"","sources":["../../../src/utils/getRequestId.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,EAAE,EAAC,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,YAAY,CAAC,KAAwE,EAAE,OAAgB;;IACrH,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,KAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;QACnD,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;KACtC;IAED,OAAO,CAAA,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,cAAc,0CAAE,SAAS,MAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,CAAA,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC9F,CAAC","sourcesContent":["import {APIGatewayEventDefaultAuthorizerContext, APIGatewayProxyEventBase, Context} from \"aws-lambda\";\nimport {v4} from \"uuid\";\n\nexport function getRequestId(event: APIGatewayProxyEventBase<APIGatewayEventDefaultAuthorizerContext>, context: Context) {\n  if (event?.headers && event.headers[\"x-request-id\"]) {\n    return event.headers[\"x-request-id\"];\n  }\n\n  return event?.requestContext?.requestId || context?.awsRequestId || v4().replace(/-/gi, \"\");\n}\n"]}

package/lib/esm/utils/setResponseHeaders.js

@@ -0,0 +1,31 @@
+function mergeHeaders(specHeaders, headers) {
+    return Object.entries(specHeaders).reduce((headers, [key, item]) => {
+        key = key.toLowerCase();
+        return {
+            ...headers,
+            [key]: headers[key] === undefined ? String(item.example) : headers[key]
+        };
+    }, headers);
+}
+/**
+ * @ignore
+ */
+export function setResponseHeaders(ctx) {
+    const { response, endpoint } = ctx;
+    const operation = endpoint.operation;
+    if (response.isDone()) {
+        return;
+    }
+    if (!response.hasStatus()) {
+        // apply status only if the isn't already modified
+        response.status(operation.getStatus());
+    }
+    const statusCode = response.statusCode;
+    const headers = operation.getHeadersOf(response.statusCode);
+    const mergedHeaders = mergeHeaders(headers, response.getHeaders());
+    response.setHeaders(mergedHeaders);
+    if (operation.isRedirection(statusCode)) {
+        response.redirect(statusCode, String(mergedHeaders["location"]));
+    }
+}
+//# sourceMappingURL=setResponseHeaders.js.map

package/lib/esm/utils/setResponseHeaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setResponseHeaders.js","sourceRoot":"","sources":["../../../src/utils/setResponseHeaders.ts"],"names":[],"mappings":"AAIA,SAAS,YAAY,CAAC,WAA2D,EAAE,OAAoC;IACrH,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;QACjE,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO;YACL,GAAG,OAAO;YACV,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;SACxE,CAAC;IACJ,CAAC,EAAE,OAAO,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAsB;IACvD,MAAM,EAAC,QAAQ,EAAE,QAAQ,EAAC,GAAG,GAAG,CAAC;IACjC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAU,CAAC;IAEtC,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE;QACrB,OAAO;KACR;IAED,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE;QACzB,kDAAkD;QAClD,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;KACxC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IACvC,MAAM,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAEnE,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAEnC,IAAI,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE;QACvC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;KAClE;AACH,CAAC","sourcesContent":["import {JsonHeader} from \"@tsed/schema\";\nimport {ServerlessContext} from \"../domain/ServerlessContext\";\nimport {HeaderValue} from \"../domain/ServerlessResponse\";\n\nfunction mergeHeaders(specHeaders: Record<string, JsonHeader & {example: string}>, headers: Record<string, HeaderValue>) {\n  return Object.entries(specHeaders).reduce((headers, [key, item]) => {\n    key = key.toLowerCase();\n    return {\n      ...headers,\n      [key]: headers[key] === undefined ? String(item.example) : headers[key]\n    };\n  }, headers);\n}\n\n/**\n * @ignore\n */\nexport function setResponseHeaders(ctx: ServerlessContext) {\n  const {response, endpoint} = ctx;\n  const operation = endpoint.operation!;\n\n  if (response.isDone()) {\n    return;\n  }\n\n  if (!response.hasStatus()) {\n    // apply status only if the isn't already modified\n    response.status(operation.getStatus());\n  }\n\n  const statusCode = response.statusCode;\n  const headers = operation.getHeadersOf(response.statusCode);\n  const mergedHeaders = mergeHeaders(headers, response.getHeaders());\n\n  response.setHeaders(mergedHeaders);\n\n  if (operation.isRedirection(statusCode)) {\n    response.redirect(statusCode, String(mergedHeaders[\"location\"]));\n  }\n}\n"]}

package/lib/{builder → types/builder}/PlatformServerless.d.ts

@@ -1,23 +1,31 @@
 import { Type } from "@tsed/core";
 import { InjectorService } from "@tsed/di";
-import type { APIGatewayProxyHandler } from "aws-lambda";
+import type { Instance } from "find-my-way";
+import type { Handler } from "aws-lambda";
+export interface PlatformServerlessSettings extends Partial<TsED.Configuration> {
+    lambda?: Type[];
+}
 /**
  * @platform
  */
 export declare class PlatformServerless {
-    #private;
     readonly name: string;
+    private _injector;
+    private _router;
+    private _promise;
     get injector(): InjectorService;
     get settings(): TsED.Configuration & import("@tsed/di").DIConfiguration;
-    get promise(): Promise<void>;
+    get promise(): Promise<any>;
     static bootstrap(settings?: Partial<TsED.Configuration> & {
         lambda?: Type[];
     }): PlatformServerless;
-    callbacks(tokens?: Type | Type[], exports?: {}): Record<string, APIGatewayProxyHandler>;
-    callback(token: Type<any>, propertyKey: string): APIGatewayProxyHandler;
+    handler(): Handler;
+    callbacks(tokens?: Type | Type[], callbacks?: any): Record<string, Handler>;
     ready(): Promise<void>;
     stop(): Promise<void>;
-    protected bootstrap(settings?: Partial<TsED.Configuration>): this;
+    init(): Promise<any>;
+    protected callback(token: Type<any>, propertyKey: string): Handler;
+    protected initRouter(): Promise<Instance<any>>;
     protected createInjector(settings: any): this;
     protected loadInjector(): Promise<void>;
 }

package/lib/{builder → types/builder}/PlatformServerlessHandler.d.ts

@@ -1,11 +1,11 @@
 import { InjectorService, TokenProvider } from "@tsed/di";
-import { PlatformExceptions } from "@tsed/platform-exceptions";
 import { PlatformParams } from "@tsed/platform-params";
+import type { PlatformExceptions } from "@tsed/platform-exceptions";
 import { ServerlessContext } from "../domain/ServerlessContext";
 export declare class PlatformServerlessHandler {
     protected injector: InjectorService;
     protected params: PlatformParams;
-    protected exceptions: PlatformExceptions;
+    protected exceptionsManager: Promise<PlatformExceptions>;
     createHandler(token: TokenProvider, propertyKey: string | symbol): ($ctx: ServerlessContext) => Promise<{
         statusCode: number;
         body: any;

package/lib/{domain → types/domain}/ServerlessResponse.d.ts

@@ -25,6 +25,7 @@ export declare class ServerlessResponse {
      * This property is useful for exposing request-level information such as the request path name, authenticated user, user settings, and so on.
      */
     get locals(): Record<string, any>;
+    get isHeadersSent(): boolean;
     getStatus(): number;
     /**
      * Sets the HTTP status for the response.
@@ -101,5 +102,4 @@ export declare class ServerlessResponse {
     isDone(): boolean;
     onEnd(cb: Function): this;
     destroy(): void;
-    isHeadersSent(): boolean;
 }

package/lib/{index.d.ts → types/index.d.ts}

@@ -1,9 +1,8 @@
 export * from "@tsed/di";
+export { Get, Post, Put, Delete, Head, Patch, Options, Route as Lambda } from "@tsed/schema";
 export * from "@tsed/platform-params";
 export * from "./builder/PlatformServerlessHandler";
 export * from "./builder/PlatformServerless";
-export * from "./services/PlatformServerlessTest";
-export * from "./decorators/lambda";
 export * from "./domain/ServerlessContext";
 export * from "./domain/ServerlessResponse";
 export * from "./domain/ServerlessResponse";

package/lib/types/utils/getRequestId.d.ts

@@ -0,0 +1,2 @@
+import { APIGatewayEventDefaultAuthorizerContext, APIGatewayProxyEventBase, Context } from "aws-lambda";
+export declare function getRequestId(event: APIGatewayProxyEventBase<APIGatewayEventDefaultAuthorizerContext>, context: Context): string;

package/package.json

@@ -1,34 +1,39 @@
 {
   "name": "@tsed/platform-serverless",
-  "version": "7.0.0-alpha.1",
+  "version": "7.0.0-beta.3",
   "description": "Platform serverless module for Ts.ED Framework",
   "private": false,
   "source": "./src/index.ts",
-  "main": "./lib/index.js",
-  "typings": "./lib/index.d.ts",
+  "main": "./lib/cjs/index.js",
+  "typings": "./lib/types/index.d.ts",
   "exports": {
-    "require": "./lib/index.js",
-    "default": "./lib/index.modern.js"
+    "types": "./lib/types/index.d.ts",
+    "import": "./lib/esm/index.js",
+    "require": "./lib/cjs/index.js",
+    "default": "./lib/esm/index.js"
   },
   "scripts": {
-    "build": "microbundle --target node --no-compress --format modern,cjs --tsconfig ./tsconfig.compile.json",
+    "build": "yarn run build:esm && yarn run build:cjs",
+    "build:cjs": "tsc --build tsconfig.compile.json",
+    "build:esm": "tsc --build tsconfig.compile.esm.json",
     "test": "cross-env NODE_ENV=test jest"
   },
   "dependencies": {
-    "@tsed/core": "7.0.0-alpha.1",
-    "@tsed/di": "7.0.0-alpha.1",
-    "@tsed/exceptions": "7.0.0-alpha.1",
-    "@tsed/json-mapper": "7.0.0-alpha.1",
-    "@tsed/logger": "^5.17.0",
-    "@tsed/platform-exceptions": "7.0.0-alpha.1",
-    "@tsed/platform-params": "7.0.0-alpha.1",
-    "@tsed/schema": "7.0.0-alpha.1",
+    "@tsed/core": "7.0.0-beta.3",
+    "@tsed/di": "7.0.0-beta.3",
+    "@tsed/exceptions": "7.0.0-beta.3",
+    "@tsed/json-mapper": "7.0.0-beta.3",
+    "@tsed/logger": "^6.0.0",
+    "@tsed/platform-exceptions": "7.0.0-beta.3",
+    "@tsed/platform-params": "7.0.0-beta.3",
+    "@tsed/schema": "7.0.0-beta.3",
     "encodeurl": "^1.0.2",
     "mime": "^2.5.2",
     "tslib": "2.2.0",
     "uuid": "^8.3.2"
   },
   "devDependencies": {
+    "@tsed/platform-serverless-testing": "7.0.0-beta.3",
     "@types/aws-lambda": "^8.10.83",
     "@types/encodeurl": "^1.0.0",
     "@types/mime": "^2.0.3"
@@ -38,7 +43,7 @@
   "bugs": {
     "url": "https://github.com/tsedio/tsed/issues"
   },
-  "homepage": "https://github.com/tsedio/tsed/tree/alpha/packages/platform/platform-serverless",
+  "homepage": "https://github.com/tsedio/tsed/tree/beta/packages/platform/platform-serverless",
   "author": "Romain Lenzotti",
   "license": "MIT"
 }

package/readme.md

@@ -36,16 +36,94 @@ This package allows the creation of pure Lambda AWS without mounting an Express.
 It supports:
 
 - Creating multiple lambda in one file,
+- Support routing,
 - DI injection with `@tsed/di`,
 - Models mapping using `@tsed/schema` and `@tsed/json-mapper`,
 - Params decorators can be used from `@tsed/platform-params` to get Query, Body, etc...
+- Response can be modified by using `@tsed/platform-response-filter`,
+- All error can be handled by using `@tsed/platform-exceptions`,
 - Operation descriptions like `@Returns`,
 - `@tsed/async-hook-context` to inject Context anywhere in your class!
+- All ORM already available for other Ts.ED platform.
+
+## Unsupported features
+
+Some features that you can use with the Express.js or Koa.js platforms are not available with the Serverless
+platform.
+
+(See also our [table feature capabilities](https://tsed.io/getting-started/#platform-features-support)).
+
+### Middlewares
+
+This mechanism is specific to Koa.js / Express.js and doesn't exist with the Serverless approach.
+
+Serverless provides a number of features such as Cors management via the configuration of `serverless.yml` and doesn't
+need to use middleware. In addition, serverless [plugins](https://www.serverless.com/plugins/) are also available and
+allow you to manage advanced scenarios without having to develop anything!
+
+If you can't find what you are looking for on the Serverless side, you can use `@tsed/di`'
+s [Interceptors](/docs/interceptors.md) to decorate the methods and add shareable features.
+
+### Passport/OIDC/GraphQL etc...
+
+Because middlewares aren't supported Passport.js, OIDC, GraphQL won't be usable in this platform either.
+
+### Upload files
+
+File upload isn't covered at this time. Any help is welcome to improve this platform :).
+
+### Statics files
+
+The goal of lambda isn't to expose static files. We do not plan to support this use in the near future.
+
+## Rule
+
+::: warning By convention, try to not import something from `@tsed/common`. `@tsed/common` embed a lot of codes designed
+for the Full server platform which are not necessary in the Serverless context and aren't optimized for it.
+
+The recent version of Ts.ED expose all necessary decorators from `@tsed/schema`, `@tsed/platform-params` or `@tsed/di`.
+For example, @@Get@@ or @@Post@@ are commonly imported like this:
+
+```typescript
+import {Get} from "@tsed/common";
+```
+
+Now, you have to import the decorator from `@tsed/schema`.
+
+```typescript
+import {Get} from "@tsed/schema";
+```
+
+:::
 
 ## Installation
 
+Generate a new project with the CLI (you can also start from an existing project):
+
+```bash
+tsed init .
+? Choose the target platform: Express.js
+? Choose the architecture for your project: Ts.ED
+? Choose the convention file styling: Ts.ED
+? Check the features needed for your project Swagger, Testing, Linter
+? Choose unit framework Jest
+? Choose linter tools framework EsLint
+? Choose extra linter tools Prettier, Lint on commit
+? Choose the package manager: Yarn
+```
+ 
+This tutorial works also with NPM package manager!
+
+Yarn:
+```bash
+yarn add @tsed/platform-serverless serverless serverless-offline
+yarn add -D @types/aws-lambda
+```
+
+Npm:
 ```bash
-npm install --save @tsed/platform-serverless
+npm install --save @tsed/platform-serverless serverless serverless-offline
+npm install --save-dev @types/aws-lambda
 ```
 
 ## Configuration
@@ -53,33 +131,33 @@ npm install --save @tsed/platform-serverless
 In the `src/lambda` create a new Lambda class:
 
 ```typescript
-import {Injectable} from "@tsed/di";
-import {Returns, Summary} from "@tsed/schema";
-import {QueryParams} from "@tsed/platform-serverless"; // /!\ don't import decorators from @tsed/common
+import {Controller, Inject} from "@tsed/di";
+import {Get, Returns, Summary} from "@tsed/schema";
+import {QueryParams} from "@tsed/platform-params"; // /!\ don't import decorators from @tsed/common
 import {TimeslotsService} from "../services/TimeslotsService";
 import {TimeslotModel} from "../models/TimeslotModel";
 
-@Injectable()
+@Controller("/timeslots")
 export class TimeslotsLambda {
   @Inject()
   protected timeslotsService: TimeslotsService;
 
-  @Lambda()
+  @Get("/")
   @Summary("Return a list of timeslots")
   @Returns(200, Array).Of(TimeslotModel)
   get(@QueryParams("date_start") dateStart: Date, @QueryParams("date_end") dateEnd: Date) {
     return this.timeslotsService.find({
       dateStart,
       dateEnd
-    })
+    });
   }
 }
 ```
 
-Create new handler.ts to expose your lambda:
+Create new `handler.ts` to expose your lambda:
 
 ```typescript
-import {PlatformServerless} from "@tsed/serverless";
+import {PlatformServerless} from "@tsed/platform-serverless";
 import {TimeslotsLambda} from "./lambda/TimeslotsLambda";
 
 const platform = PlatformServerless.bootstrap({
@@ -93,70 +171,124 @@ const platform = PlatformServerless.bootstrap({
 export = platform.callbacks();
 ```
 
-Finally, create the serverless.yml:
+Finally, create the `serverless.yml`:
 
 ```yml
-# Welcome to Serverless!
-#
-# This file is the main config file for your service.
-# It's very minimal at this point and uses default values.
-# You can always add more config options for more control.
-# We've included some commented out config examples here.
-# Just uncomment any of them to get that config option.
-#
-# For full config options, check the docs:
-#    docs.serverless.com
-#
-# Happy Coding!
+service: timeslots
+
+frameworkVersion: '2'
+
+provider:
+   name: aws
+   runtime: nodejs14.x
+   lambdaHashingVersion: '20201221'
+
+plugins:
+   - serverless-offline
+
+functions:
+   timeslots:
+      handler: dist/handler.getTimeslots
+      events:
+         - http:
+              path: /timeslots
+              method: get
+```
+
+## Invoke a lambda with serverless
+
+Serverless provide a plugin named `serverless-offline`. This Serverless plugin emulates AWS λ and API Gateway on your
+local machine to speed up your development cycles. To do so, it starts an HTTP server that handles the request's
+lifecycle like API does and invokes your handlers.
+
+So, by using the `serverless offline` command, we'll be able to invoke our function. For that, we need also to build our
+code before invoke the lambda.
+
+To simplify our workflow, we can add the following npm script command in our `package.json`:
+
+```json
+{
+  "scripts": {
+    "invoke:timeslots": "yarn build && serverless invoke local -f timeslots"
+  }
+}
+```
+
+Now, we can run the following command to invoke our lambda:
+
+```
+yarn invoke:timeslots
+// OR
+npm run invoke:timeslots
+```
+
+You should see in the terminal the following result:
+
+```json
+{
+  "statusCode": 200,
+  "body": "[{\"id\":\"b6de4fc7-faaa-4cd7-a144-42f6af0dec6b\",\"title\":\"title\",\"description\":\"description\",\"start_date\":\"2021-10-29T10:40:57.019Z\",\"end_date\":\"2021-10-29T10:40:57.019Z\",\"created_at\":\"2021-10-29T10:40:57.019Z\",\"update_at\":\"2021-10-29T10:40:57.019Z\"}]",
+  "headers": {
+    "content-type": "application/json",
+    "x-request-id": "ebb52d5e-113b-40da-b34e-c14811df596b"
+  },
+  "isBase64Encoded": false
+}
+```
+
+## Manage routes from code
+
+Declaring all routes in the `serverless.yml` file can be a source of error. `@tsed/platform-serverless` can handle all
+routes and call the right lambda based on the decorators like `@Get`, `@Post`, etc...
 
+To use the embed router, change the `serverless.yml` declaration by this example:
+
+```yml
 service: timeslots
-# app and org for use with dashboard.serverless.com
-#app: your-app-name
-#org: your-org-name
 
-# You can pin your service to only deploy with a specific Serverless version
-# Check out our docs for more details
 frameworkVersion: '2'
 
 provider:
   name: aws
-  runtime: nodejs12.x
-  lambdaHashingVersion: 20201221
+  runtime: nodejs14.x
+  lambdaHashingVersion: '20201221'
+
+plugins:
+  - serverless-offline
 
 functions:
-  timeslots:
-    handler: handler.getTimeslots
+  any:
+    handler: dist/handler.handler
     events:
       - http:
-        path: /timeslots
-        method: get
-        cors: true
+          method: ANY
+          path: /
+      - http:
+          method: ANY
+          path: '{proxy+}'
 ```
 
-## Multiple lambda
-
-In you lambda controller use Lambda decorators: 
+Then, edit the `handler.ts` and change the exported functions:
 
 ```typescript
-import {Injectable} from "@tsed/di";
-import {Returns, Summary} from "@tsed/schema";
-import {QueryParams} from "@tsed/platform-serverless"; // /!\ don't import decorators from @tsed/common
-import {TimeslotsService} from "../services/TimeslotsService";
-import {TimeslotModel} from "../models/TimeslotModel";
+import {PlatformServerless} from "@tsed/platform-serverless";
+import {TimeslotsLambda} from "./TimeslotsLambda";
 
-@Injectable()
-export class TimeslotsLambda {
-  @Inject()
-  protected timeslotsService: TimeslotsService;
+const platform = PlatformServerless.bootstrap({
+  lambda: [TimeslotsLambda]
+});
 
-  @Lambda()
-  @Summary("Return a list of timeslots")
-  @Returns(200, Array).Of(TimeslotModel)
-  get(@QueryParams("date_start") dateStart: Date, @QueryParams("date_end") dateEnd: Date) {
-    return this.timeslotsService.find({
-      dateStart,
-      dateEnd
-    })
+export const handler = platform.handler();
+```
+
+Now, Ts.ED will handle request and call the expected lambda in your controllers.
+
+To simplify our workflow, we can add the following npm script command in our `package.json`:
+
+```json
+{
+  "scripts": {
+    "invoke:any": "yarn serverless invoke local -f any --data '{\"path\":\"/timeslots\", \"httpMethod\": \"GET\"}'"
   }
 }
 ```
@@ -184,6 +316,91 @@ export class TimeslotsLambda {
 }
 ```
 
+## Testing
+
+Ts.ED provide a way to test you lambda with mocked Aws event and context by using the `PlatformServerlessTest` util.
+
+Here an example to test a Lambda controller:
+
+```typescript
+import {PlatformServerlessTest} from "@tsed/platform-serverless-testing";
+import {PlatformServerless} from "@tsed/platform-serverless";
+
+@Controller("/")
+class TimeslotsLambdaController {
+  @Get("/")
+  getAll() {
+    return [];
+  }
+
+  @Get("/:id")
+  getById(@PathParams("id") id: string, @QueryParams("start_date") startDate: Date, @QueryParams("end_date") endDate: Date) {
+    return {
+      id,
+      startDate,
+      endDate
+    };
+  }
+}
+
+describe("TimeslotsLambdaController", () => {
+  beforeEach(
+    PlatformServerlessTest.bootstrap(PlatformServerless, {
+      lambda: [TimeslotsLambdaController]
+    })
+  );
+  afterEach(() => PlatformServerlessTest.reset());
+
+  describe("Invoke by lambda name", () => {
+    it("should call getAll Lambda", async () => {
+      const response = await PlatformServerlessTest.request.call("getAll");
+
+      expect(response.statusCode).toEqual(200);
+      expect(response.headers).toEqual({
+        "x-request-id": "requestId",
+        "content-type": "application/json"
+      });
+      expect(JSON.parse(response.body)).toEqual([]);
+    });
+
+    it("should call getAll Lambda", async () => {
+      const response = await PlatformServerlessTest.request.call("getById")
+        .params({
+          id: "1"
+        })
+        .query({
+          start_date: new Date("2020-01-01"),
+          end_date: new Date("2020-01-10")
+        });
+
+      expect(response.statusCode).toEqual(200);
+      expect(response.headers).toEqual({
+        "x-request-id": "requestId",
+        "content-type": "application/json"
+      });
+      expect(JSON.parse(response.body)).toEqual({
+        id: "1",
+        endDate: "2020-01-10T00:00:00.000Z",
+        startDate: "2020-01-01T00:00:00.000Z"
+      });
+    });    
+  });
+  
+  describe("invoke using the router", () => {
+    it("should call getAll Lambda", async () => {
+      const response = await PlatformServerlessTest.request.get("/");
+
+      expect(response.statusCode).toEqual(200);
+      expect(response.headers).toEqual({
+        "x-request-id": "requestId",
+        "content-type": "application/json"
+      });
+      expect(JSON.parse(response.body)).toEqual([]);
+    });
+  });
+});
+```
+
 ## Contributors
 Please read [contributing guidelines here](https://tsed.io/CONTRIBUTING.html).