@tsed/common 7.0.0-alpha.1 → 7.0.0-beta.3

package/lib/cjs/services/PlatformHandler.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformHandler = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@tsed/core");
+const di_1 = require("@tsed/di");
+const logger_1 = require("@tsed/logger");
+const platform_params_1 = require("@tsed/platform-params");
+const platform_response_filter_1 = require("@tsed/platform-response-filter");
+const AnyToPromiseWithCtx_1 = require("../domain/AnyToPromiseWithCtx");
+const HandlerMetadata_1 = require("../domain/HandlerMetadata");
+const HandlerType_1 = require("../interfaces/HandlerType");
+const createHandlerMetadata_1 = require("../utils/createHandlerMetadata");
+const setResponseHeaders_1 = require("../utils/setResponseHeaders");
+/**
+ * Platform Handler abstraction layer. Wrap original class method to a pure platform handler (Express, Koa, etc...).
+ * @platform
+ */
+let PlatformHandler = class PlatformHandler {
+    constructor(injector, params) {
+        this.injector = injector;
+        this.params = params;
+    }
+    /**
+     * Create a native middleware based on the given metadata and return an instance of AnyToPromiseWithCtx
+     * @param input
+     * @param options
+     */
+    createHandler(input, options = {}) {
+        return this.createRawHandler((0, createHandlerMetadata_1.createHandlerMetadata)(this.injector, input, options));
+    }
+    /**
+     * Create injectable handler from the given provider
+     * @param provider
+     * @param propertyKey
+     */
+    createCustomHandler(provider, propertyKey) {
+        const handler = this.compileHandler(new HandlerMetadata_1.HandlerMetadata({
+            token: provider.provide,
+            target: provider.useClass,
+            type: HandlerType_1.HandlerType.CUSTOM,
+            scope: provider.scope,
+            propertyKey
+        }));
+        return async ($ctx, next) => handler({
+            $ctx,
+            next
+        });
+    }
+    /**
+     * Send the response to the consumer.
+     * @param data
+     * @param ctx
+     * @protected
+     */
+    async flush(data, ctx) {
+        const { response } = ctx;
+        if (!response.isDone()) {
+            data = await this.responseFilter.serialize(data, ctx);
+            data = await this.responseFilter.transform(data, ctx);
+            response.body(data);
+        }
+    }
+    compileHandler(metadata) {
+        if (metadata.type === HandlerType_1.HandlerType.CTX_FN) {
+            return async (scope) => {
+                // @ts-ignore
+                return this.onCtxRequest({
+                    ...scope,
+                    handler: () => metadata.handler(scope.$ctx),
+                    metadata
+                });
+            };
+        }
+        const promise = this.params.compileHandler({
+            token: metadata.token,
+            propertyKey: metadata.propertyKey,
+            getCustomArgs: metadata.injectable ? undefined : this.getDefaultArgs(metadata)
+        });
+        return async (scope) => {
+            const handler = await promise;
+            // @ts-ignore
+            return this.onRequest({
+                ...scope,
+                handler,
+                metadata
+            });
+        };
+    }
+    async onCtxRequest(requestOptions) {
+        await requestOptions.handler(requestOptions);
+        return this.next(requestOptions);
+    }
+    /**
+     * Call handler when a request his handle
+     * @param requestOptions
+     */
+    async onRequest(requestOptions) {
+        const { $ctx, metadata, err, handler } = requestOptions;
+        // istanbul ignore next
+        if (!$ctx || $ctx.isDone()) {
+            logger_1.$log.error({
+                name: "HEADERS_SENT",
+                message: `An endpoint is called but the response is already send to the client. The call comes from the handler: ${metadata.toString()}`
+            });
+            return;
+        }
+        const resolver = new AnyToPromiseWithCtx_1.AnyToPromiseWithCtx({ $ctx, err });
+        return this.injector.runInContext($ctx, async () => {
+            try {
+                const { state, data, status, headers } = await resolver.call(handler);
+                if (state === core_1.AnyToPromiseStatus.RESOLVED) {
+                    if (status) {
+                        $ctx.response.status(status);
+                    }
+                    if (headers) {
+                        $ctx.response.setHeaders(headers);
+                    }
+                    if (data !== undefined) {
+                        $ctx.data = data;
+                    }
+                    // Can be canceled by the handler itself
+                    return await this.onSuccess($ctx.data, requestOptions);
+                }
+            }
+            catch (er) {
+                return this.onError(er, requestOptions);
+            }
+        });
+    }
+    async onError(er, requestOptions) {
+        const { next, $ctx, metadata } = requestOptions;
+        $ctx.data = er;
+        if (!next) {
+            throw er;
+        }
+        // istanbul ignore next
+        if (!$ctx || ($ctx === null || $ctx === void 0 ? void 0 : $ctx.isDone())) {
+            logger_1.$log.warn({
+                name: "HEADERS_SENT",
+                message: `An error was caught after the headers were sent to the client. The error comes from the handler: ${metadata.toString()}`,
+                stack: er.stack,
+                origin: er,
+                request_id: $ctx.id
+            });
+            return;
+        }
+        return next && next(er);
+    }
+    /**
+     * Manage success scenario
+     * @param data
+     * @param requestOptions
+     * @protected
+     */
+    async onSuccess(data, requestOptions) {
+        const { metadata, $ctx, next } = requestOptions;
+        // istanbul ignore next
+        if ($ctx === null || $ctx === void 0 ? void 0 : $ctx.isDone()) {
+            return;
+        }
+        // set headers each times that an endpoint is called
+        if (metadata.type === HandlerType_1.HandlerType.ENDPOINT) {
+            this.setHeaders($ctx);
+        }
+        // call returned middleware
+        if ((0, core_1.isFunction)(data) && !(0, core_1.isStream)(data)) {
+            return this.callReturnedMiddleware(data, $ctx, next);
+        }
+        if (metadata.isFinal()) {
+            return this.flush(data, $ctx);
+        }
+        return this.next(requestOptions);
+    }
+    /**
+     * Call the returned middleware by the handler.
+     * @param middleware
+     * @param ctx
+     * @param next
+     * @protected
+     */
+    callReturnedMiddleware(middleware, ctx, next) {
+        return middleware(ctx.getRequest(), ctx.getResponse(), next);
+    }
+    /**
+     * create Raw handler
+     * @param metadata
+     */
+    createRawHandler(metadata) {
+        if ([HandlerType_1.HandlerType.RAW_ERR_FN, HandlerType_1.HandlerType.RAW_FN].includes(metadata.type)) {
+            return metadata.handler;
+        }
+        const handler = this.compileHandler(metadata);
+        return async (request, response, next) => {
+            return handler({
+                next,
+                $ctx: request.$ctx
+            });
+        };
+    }
+    /**
+     * Set response headers
+     * @param ctx
+     * @protected
+     */
+    setHeaders(ctx) {
+        return (0, setResponseHeaders_1.setResponseHeaders)(ctx);
+    }
+    next(requestOptions) {
+        const { $ctx, next } = requestOptions;
+        return !$ctx.response.isDone() && next && next();
+    }
+    getDefaultArgs(metadata) {
+        return async (scope) => [
+            metadata.hasErrorParam && scope.err,
+            scope.$ctx.request.request,
+            scope.$ctx.response.response,
+            metadata.hasNextFunction && scope.next
+        ].filter(Boolean);
+    }
+};
+(0, tslib_1.__decorate)([
+    (0, di_1.Inject)(),
+    (0, tslib_1.__metadata)("design:type", platform_response_filter_1.PlatformResponseFilter)
+], PlatformHandler.prototype, "responseFilter", void 0);
+PlatformHandler = (0, tslib_1.__decorate)([
+    (0, di_1.Injectable)({
+        scope: di_1.ProviderScope.SINGLETON
+    }),
+    (0, tslib_1.__metadata)("design:paramtypes", [di_1.InjectorService, platform_params_1.PlatformParams])
+], PlatformHandler);
+exports.PlatformHandler = PlatformHandler;
+//# sourceMappingURL=PlatformHandler.js.map

package/lib/cjs/services/PlatformHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformHandler.js","sourceRoot":"","sources":["../../../src/services/PlatformHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import {AnyToPromiseStatus, isFunction, isStream} from \"@tsed/core\";\nimport {Inject, Injectable, InjectorService, Provider, ProviderScope} from \"@tsed/di\";\nimport {$log} from \"@tsed/logger\";\nimport {ArgScope, HandlerWithScope, PlatformParams} from \"@tsed/platform-params\";\nimport {PlatformResponseFilter} from \"@tsed/platform-response-filter\";\nimport {AnyToPromiseWithCtx} from \"../domain/AnyToPromiseWithCtx\";\nimport {EndpointMetadata} from \"../domain/EndpointMetadata\";\nimport {HandlerMetadata} from \"../domain/HandlerMetadata\";\nimport {PlatformContext} from \"../domain/PlatformContext\";\nimport {HandlerType} from \"../interfaces/HandlerType\";\nimport {PlatformRouteWithoutHandlers} from \"../interfaces/PlatformRouteOptions\";\nimport {createHandlerMetadata} from \"../utils/createHandlerMetadata\";\nimport {setResponseHeaders} from \"../utils/setResponseHeaders\";\n\nexport interface OnRequestOptions {\n  $ctx: PlatformContext;\n  metadata: HandlerMetadata;\n  handler: HandlerWithScope;\n  next?: any;\n  err?: any;\n\n  [key: string]: any;\n}\n\n/**\n * Platform Handler abstraction layer. Wrap original class method to a pure platform handler (Express, Koa, etc...).\n * @platform\n */\n@Injectable({\n  scope: ProviderScope.SINGLETON\n})\nexport class PlatformHandler {\n  @Inject()\n  protected responseFilter: PlatformResponseFilter;\n\n  constructor(protected injector: InjectorService, protected params: PlatformParams) {}\n\n  /**\n   * Create a native middleware based on the given metadata and return an instance of AnyToPromiseWithCtx\n   * @param input\n   * @param options\n   */\n  createHandler(input: EndpointMetadata | HandlerMetadata | any, options: PlatformRouteWithoutHandlers = {}) {\n    return this.createRawHandler(createHandlerMetadata(this.injector, input, options));\n  }\n\n  /**\n   * Create injectable handler from the given provider\n   * @param provider\n   * @param propertyKey\n   */\n  createCustomHandler(provider: Provider, propertyKey: string) {\n    const handler = this.compileHandler(\n      new HandlerMetadata({\n        token: provider.provide,\n        target: provider.useClass,\n        type: HandlerType.CUSTOM,\n        scope: provider.scope,\n        propertyKey\n      })\n    );\n\n    return async ($ctx: PlatformContext, next?: any) =>\n      handler({\n        $ctx,\n        next\n      });\n  }\n\n  /**\n   * Send the response to the consumer.\n   * @param data\n   * @param ctx\n   * @protected\n   */\n  async flush(data: any, ctx: PlatformContext) {\n    const {response} = ctx;\n\n    if (!response.isDone()) {\n      data = await this.responseFilter.serialize(data, ctx);\n      data = await this.responseFilter.transform(data, ctx);\n      response.body(data);\n    }\n  }\n\n  compileHandler(metadata: HandlerMetadata) {\n    if (metadata.type === HandlerType.CTX_FN) {\n      return async (scope: Record<string, any>) => {\n        // @ts-ignore\n        return this.onCtxRequest({\n          ...scope,\n          handler: () => metadata.handler(scope.$ctx),\n          metadata\n        });\n      };\n    }\n\n    const promise = this.params.compileHandler<PlatformContext>({\n      token: metadata.token,\n      propertyKey: metadata.propertyKey,\n      getCustomArgs: metadata.injectable ? undefined : this.getDefaultArgs(metadata)\n    });\n\n    return async (scope: Record<string, any>) => {\n      const handler = await promise;\n      // @ts-ignore\n      return this.onRequest({\n        ...scope,\n        handler,\n        metadata\n      });\n    };\n  }\n\n  protected async onCtxRequest(requestOptions: OnRequestOptions): Promise<any> {\n    await requestOptions.handler(requestOptions);\n\n    return this.next(requestOptions);\n  }\n\n  /**\n   * Call handler when a request his handle\n   * @param requestOptions\n   */\n  protected async onRequest(requestOptions: OnRequestOptions): Promise<any> {\n    const {$ctx, metadata, err, handler} = requestOptions;\n    // istanbul ignore next\n    if (!$ctx || $ctx.isDone()) {\n      $log.error({\n        name: \"HEADERS_SENT\",\n        message: `An endpoint is called but the response is already send to the client. The call comes from the handler: ${metadata.toString()}`\n      });\n      return;\n    }\n\n    const resolver = new AnyToPromiseWithCtx({$ctx, err});\n\n    return this.injector.runInContext($ctx, async () => {\n      try {\n        const {state, data, status, headers} = await resolver.call(handler);\n\n        if (state === AnyToPromiseStatus.RESOLVED) {\n          if (status) {\n            $ctx.response.status(status);\n          }\n\n          if (headers) {\n            $ctx.response.setHeaders(headers);\n          }\n\n          if (data !== undefined) {\n            $ctx.data = data;\n          }\n\n          // Can be canceled by the handler itself\n          return await this.onSuccess($ctx.data, requestOptions);\n        }\n      } catch (er) {\n        return this.onError(er, requestOptions);\n      }\n    });\n  }\n\n  protected async onError(er: Error, requestOptions: OnRequestOptions) {\n    const {next, $ctx, metadata} = requestOptions;\n    $ctx.data = er;\n\n    if (!next) {\n      throw er;\n    }\n\n    // istanbul ignore next\n    if (!$ctx || $ctx?.isDone()) {\n      $log.warn({\n        name: \"HEADERS_SENT\",\n        message: `An error was caught after the headers were sent to the client. The error comes from the handler: ${metadata.toString()}`,\n        stack: er.stack,\n        origin: er,\n        request_id: $ctx.id\n      });\n\n      return;\n    }\n\n    return next && next(er);\n  }\n\n  /**\n   * Manage success scenario\n   * @param data\n   * @param requestOptions\n   * @protected\n   */\n  protected async onSuccess(data: any, requestOptions: OnRequestOptions) {\n    const {metadata, $ctx, next} = requestOptions;\n\n    // istanbul ignore next\n    if ($ctx?.isDone()) {\n      return;\n    }\n\n    // set headers each times that an endpoint is called\n    if (metadata.type === HandlerType.ENDPOINT) {\n      this.setHeaders($ctx);\n    }\n\n    // call returned middleware\n    if (isFunction(data) && !isStream(data)) {\n      return this.callReturnedMiddleware(data, $ctx, next);\n    }\n\n    if (metadata.isFinal()) {\n      return this.flush(data, $ctx);\n    }\n\n    return this.next(requestOptions);\n  }\n\n  /**\n   * Call the returned middleware by the handler.\n   * @param middleware\n   * @param ctx\n   * @param next\n   * @protected\n   */\n  protected callReturnedMiddleware(middleware: any, ctx: PlatformContext, next: any) {\n    return middleware(ctx.getRequest(), ctx.getResponse(), next);\n  }\n\n  /**\n   * create Raw handler\n   * @param metadata\n   */\n  protected createRawHandler(metadata: HandlerMetadata) {\n    if ([HandlerType.RAW_ERR_FN, HandlerType.RAW_FN].includes(metadata.type)) {\n      return metadata.handler;\n    }\n\n    const handler = this.compileHandler(metadata);\n\n    return async (request: any, response: any, next: any) => {\n      return handler({\n        next,\n        $ctx: request.$ctx\n      });\n    };\n  }\n\n  /**\n   * Set response headers\n   * @param ctx\n   * @protected\n   */\n  protected setHeaders(ctx: PlatformContext) {\n    return setResponseHeaders(ctx);\n  }\n\n  protected next(requestOptions: OnRequestOptions) {\n    const {$ctx, next} = requestOptions;\n\n    return !$ctx.response.isDone() && next && next();\n  }\n\n  protected getDefaultArgs(metadata: HandlerMetadata) {\n    return async (scope: ArgScope<PlatformContext>) =>\n      [\n        metadata.hasErrorParam && scope.err,\n        scope.$ctx.request.request,\n        scope.$ctx.response.response,\n        metadata.hasNextFunction && scope.next\n      ].filter(Boolean);\n  }\n}\n"]}

package/lib/cjs/services/PlatformMiddlewaresChain.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformMiddlewaresChain = void 0;
+const tslib_1 = require("tslib");
+const di_1 = require("@tsed/di");
+const platform_params_1 = require("@tsed/platform-params");
+const bindEndpointMiddleware_1 = require("../middlewares/bindEndpointMiddleware");
+const PlatformAcceptMimesMiddleware_1 = require("../middlewares/PlatformAcceptMimesMiddleware");
+const PlatformMulterMiddleware_1 = require("../middlewares/PlatformMulterMiddleware");
+const useCtxHandler_1 = require("../utils/useCtxHandler");
+let PlatformMiddlewaresChain = class PlatformMiddlewaresChain {
+    get(provider, operationRoute) {
+        const { endpoint } = operationRoute;
+        const { beforeMiddlewares, middlewares: mldwrs, afterMiddlewares } = endpoint;
+        const { middlewares: { use, useAfter } } = provider;
+        const hasFiles = [...operationRoute.endpoint.children.values()].find((item) => item.paramType === platform_params_1.ParamTypes.FILES);
+        return []
+            .concat((0, useCtxHandler_1.useCtxHandler)((0, bindEndpointMiddleware_1.bindEndpointMiddleware)(endpoint)))
+            .concat(PlatformAcceptMimesMiddleware_1.PlatformAcceptMimesMiddleware)
+            .concat(hasFiles && PlatformMulterMiddleware_1.PlatformMulterMiddleware)
+            .concat(beforeMiddlewares) // Endpoint before-middlewares
+            .concat(use) // Controller use-middlewares
+            .concat(mldwrs) // Endpoint middlewares
+            .concat(endpoint) // Endpoint metadata
+            .concat(afterMiddlewares) // Endpoint after-middlewares
+            .concat(useAfter) // Controller after middlewares (equivalent to afterEach)
+            .filter((item) => !!item);
+    }
+};
+PlatformMiddlewaresChain = (0, tslib_1.__decorate)([
+    (0, di_1.Injectable)()
+], PlatformMiddlewaresChain);
+exports.PlatformMiddlewaresChain = PlatformMiddlewaresChain;
+//# sourceMappingURL=PlatformMiddlewaresChain.js.map

package/lib/cjs/services/PlatformMiddlewaresChain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformMiddlewaresChain.js","sourceRoot":"","sources":["../../../src/services/PlatformMiddlewaresChain.ts"],"names":[],"mappings":";;;;AAAA,iCAAoC;AACpC,2DAAgE;AAIhE,kFAA6E;AAC7E,gGAA2F;AAC3F,sFAAiF;AACjF,0DAAqD;AAGrD,IAAa,wBAAwB,GAArC,MAAa,wBAAwB;IACnC,GAAG,CAAC,QAA4B,EAAE,cAAoD;QACpF,MAAM,EAAC,QAAQ,EAAC,GAAG,cAAc,CAAC;QAClC,MAAM,EAAC,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAC,GAAG,QAAQ,CAAC;QAE5E,MAAM,EACJ,WAAW,EAAE,EAAC,GAAG,EAAE,QAAQ,EAAC,EAC7B,GAAG,QAAQ,CAAC;QAEb,MAAM,QAAQ,GAAG,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAmB,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,4BAAU,CAAC,KAAK,CAAC,CAAC;QAEnI,OAAQ,EAAY;aACjB,MAAM,CAAC,IAAA,6BAAa,EAAC,IAAA,+CAAsB,EAAC,QAAQ,CAAC,CAAC,CAAC;aACvD,MAAM,CAAC,6DAA6B,CAAC;aACrC,MAAM,CAAC,QAAQ,IAAI,mDAAwB,CAAC;aAC5C,MAAM,CAAC,iBAAiB,CAAC,CAAC,8BAA8B;aACxD,MAAM,CAAC,GAAG,CAAC,CAAC,6BAA6B;aACzC,MAAM,CAAC,MAAM,CAAC,CAAC,uBAAuB;aACtC,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB;aACrC,MAAM,CAAC,gBAAgB,CAAC,CAAC,6BAA6B;aACtD,MAAM,CAAC,QAAQ,CAAC,CAAC,yDAAyD;aAC1E,MAAM,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AAvBY,wBAAwB;IADpC,IAAA,eAAU,GAAE;GACA,wBAAwB,CAuBpC;AAvBY,4DAAwB","sourcesContent":["import {Injectable} from \"@tsed/di\";\nimport {ParamMetadata, ParamTypes} from \"@tsed/platform-params\";\nimport {JsonOperationRoute} from \"@tsed/schema\";\nimport {ControllerProvider} from \"../domain/ControllerProvider\";\nimport {EndpointMetadata} from \"../domain/EndpointMetadata\";\nimport {bindEndpointMiddleware} from \"../middlewares/bindEndpointMiddleware\";\nimport {PlatformAcceptMimesMiddleware} from \"../middlewares/PlatformAcceptMimesMiddleware\";\nimport {PlatformMulterMiddleware} from \"../middlewares/PlatformMulterMiddleware\";\nimport {useCtxHandler} from \"../utils/useCtxHandler\";\n\n@Injectable()\nexport class PlatformMiddlewaresChain {\n  get(provider: ControllerProvider, operationRoute: JsonOperationRoute<EndpointMetadata>) {\n    const {endpoint} = operationRoute;\n    const {beforeMiddlewares, middlewares: mldwrs, afterMiddlewares} = endpoint;\n\n    const {\n      middlewares: {use, useAfter}\n    } = provider;\n\n    const hasFiles = [...operationRoute.endpoint.children.values()].find((item: ParamMetadata) => item.paramType === ParamTypes.FILES);\n\n    return ([] as any[])\n      .concat(useCtxHandler(bindEndpointMiddleware(endpoint)))\n      .concat(PlatformAcceptMimesMiddleware)\n      .concat(hasFiles && PlatformMulterMiddleware)\n      .concat(beforeMiddlewares) // Endpoint before-middlewares\n      .concat(use) // Controller use-middlewares\n      .concat(mldwrs) // Endpoint middlewares\n      .concat(endpoint) // Endpoint metadata\n      .concat(afterMiddlewares) // Endpoint after-middlewares\n      .concat(useAfter) // Controller after middlewares (equivalent to afterEach)\n      .filter((item: any) => !!item);\n  }\n}\n"]}

package/lib/cjs/services/PlatformRequest.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformRequest = void 0;
+const tslib_1 = require("tslib");
+const di_1 = require("@tsed/di");
+/**
+ * Platform Request abstraction layer.
+ * @platform
+ */
+let PlatformRequest = class PlatformRequest {
+    constructor({ request }, $ctx) {
+        this.$ctx = $ctx;
+        this.raw = request;
+    }
+    get secure() {
+        return this.raw.secure;
+    }
+    get host() {
+        return this.get("host");
+    }
+    get protocol() {
+        return this.raw.protocol;
+    }
+    /**
+     * Get the url of the request.
+     *
+     * Is equivalent of `express.response.originalUrl || express.response.url`.
+     */
+    get url() {
+        return this.raw.originalUrl || this.raw.url;
+    }
+    get headers() {
+        return this.raw.headers;
+    }
+    get method() {
+        return this.raw.method;
+    }
+    /**
+     * Contains key-value pairs of data submitted in the request body. By default, it is `undefined`, and is populated when you use
+     * `body-parsing` middleware such as `express.json()` or `express.urlencoded()`.
+     */
+    get body() {
+        return this.raw.body;
+    }
+    get rawBody() {
+        return this.raw.rawBody || this.raw.body;
+    }
+    /**
+     * When using `cookie-parser` middleware, this property is an object that contains cookies sent by the request.
+     * If the request contains no cookies, it defaults to `{}`.
+     */
+    get cookies() {
+        return this.raw.cookies;
+    }
+    /**
+     * This property is an object containing properties mapped to the named route `parameters`.
+     * For example, if you have the route `/user/:name`, then the `name` property is available as `req.params.name`.
+     * This object defaults to `{}`.
+     */
+    get params() {
+        return this.raw.params;
+    }
+    /**
+     * This property is an object containing a property for each query string parameter in the route.
+     * When query parser is set to disabled, it is an empty object `{}`, otherwise it is the result of the configured query parser.
+     */
+    get query() {
+        return this.raw.query;
+    }
+    /**
+     * This property is an object containing a property for each session attributes set by any code.
+     * It require to install a middleware like express-session to work.
+     */
+    get session() {
+        return this.raw.session;
+    }
+    get files() {
+        return this.raw.files;
+    }
+    /**
+     * Return the original request framework instance
+     */
+    get request() {
+        return this.getRequest();
+    }
+    /**
+     * Return the original request node.js instance
+     */
+    get req() {
+        return this.getReq();
+    }
+    /**
+     * Returns the HTTP request header specified by field. The match is case-insensitive.
+     *
+     * ```typescript
+     * request.get('Content-Type') // => "text/plain"
+     * ```
+     *
+     * @param name
+     */
+    get(name) {
+        return this.raw.get(name);
+    }
+    accepts(mime) {
+        // @ts-ignore
+        return this.raw.accepts(mime);
+    }
+    isAborted() {
+        return this.raw.aborted;
+    }
+    destroy() {
+        // @ts-ignore
+        delete this.raw;
+        // @ts-ignore
+        delete this.response;
+        // @ts-ignore
+        delete this.$ctx;
+    }
+    /**
+     * Return the Framework response object (express, koa, etc...)
+     */
+    getRequest() {
+        return this.raw;
+    }
+    /**
+     * Return the Node.js response object
+     */
+    getReq() {
+        return this.raw;
+    }
+};
+PlatformRequest = (0, tslib_1.__decorate)([
+    (0, di_1.Injectable)(),
+    (0, di_1.Scope)(di_1.ProviderScope.INSTANCE),
+    (0, tslib_1.__metadata)("design:paramtypes", [Object, Function])
+], PlatformRequest);
+exports.PlatformRequest = PlatformRequest;
+//# sourceMappingURL=PlatformRequest.js.map

package/lib/cjs/services/PlatformRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformRequest.js","sourceRoot":"","sources":["../../../src/services/PlatformRequest.ts"],"names":[],"mappings":";;;;AAAA,iCAA0D;AAgB1D;;;GAGG;AAGH,IAAa,eAAe,GAA5B,MAAa,eAAe;IAQ1B,YAAY,EAAC,OAAO,EAAgB,EAAY,IAAqB;QAArB,SAAI,GAAJ,IAAI,CAAiB;QACnE,IAAI,CAAC,GAAG,GAAG,OAAc,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC9C,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,GAAG,CAAC,OAAc,CAAC;IACjC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAaD,OAAO,CAAC,IAAwB;QAC9B,aAAa;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,aAAa;QACb,OAAO,IAAI,CAAC,GAAG,CAAC;QAChB,aAAa;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC;QACrB,aAAa;QACb,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,GAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,GAAU,CAAC;IACzB,CAAC;CACF,CAAA;AA/JY,eAAe;IAF3B,IAAA,eAAU,GAAE;IACZ,IAAA,UAAK,EAAC,kBAAa,CAAC,QAAQ,CAAC;;GACjB,eAAe,CA+J3B;AA/JY,0CAAe","sourcesContent":["import {Injectable, ProviderScope, Scope} from \"@tsed/di\";\nimport {IncomingHttpHeaders, IncomingMessage} from \"http\";\nimport type {PlatformContext} from \"../domain/PlatformContext\";\nimport {IncomingEvent} from \"../interfaces/IncomingEvent\";\nimport type {PlatformResponse} from \"./PlatformResponse\";\n\ndeclare global {\n  namespace TsED {\n    // @ts-ignore\n    export interface Request {\n      id: string;\n      $ctx: PlatformContext;\n    }\n  }\n}\n\n/**\n * Platform Request abstraction layer.\n * @platform\n */\n@Injectable()\n@Scope(ProviderScope.INSTANCE)\nexport class PlatformRequest<T extends {[key: string]: any} = any> {\n  public raw: T;\n\n  /**\n   * The current @@PlatformResponse@@.\n   */\n  public response: PlatformResponse;\n\n  constructor({request}: IncomingEvent, protected $ctx: PlatformContext) {\n    this.raw = request as any;\n  }\n\n  get secure(): boolean {\n    return this.raw.secure;\n  }\n\n  get host(): string {\n    return this.get(\"host\");\n  }\n\n  get protocol(): string {\n    return this.raw.protocol;\n  }\n\n  /**\n   * Get the url of the request.\n   *\n   * Is equivalent of `express.response.originalUrl || express.response.url`.\n   */\n  get url(): string {\n    return this.raw.originalUrl || this.raw.url;\n  }\n\n  get headers(): IncomingHttpHeaders {\n    return this.raw.headers;\n  }\n\n  get method(): string {\n    return this.raw.method;\n  }\n\n  /**\n   * Contains key-value pairs of data submitted in the request body. By default, it is `undefined`, and is populated when you use\n   * `body-parsing` middleware such as `express.json()` or `express.urlencoded()`.\n   */\n  get body(): any {\n    return this.raw.body;\n  }\n\n  get rawBody(): any {\n    return this.raw.rawBody || this.raw.body;\n  }\n\n  /**\n   * When using `cookie-parser` middleware, this property is an object that contains cookies sent by the request.\n   * If the request contains no cookies, it defaults to `{}`.\n   */\n  get cookies(): {[key: string]: any} {\n    return this.raw.cookies;\n  }\n\n  /**\n   * This property is an object containing properties mapped to the named route `parameters`.\n   * For example, if you have the route `/user/:name`, then the `name` property is available as `req.params.name`.\n   * This object defaults to `{}`.\n   */\n  get params(): {[key: string]: any} {\n    return this.raw.params;\n  }\n\n  /**\n   * This property is an object containing a property for each query string parameter in the route.\n   * When query parser is set to disabled, it is an empty object `{}`, otherwise it is the result of the configured query parser.\n   */\n  get query(): {[key: string]: any} {\n    return this.raw.query;\n  }\n\n  /**\n   * This property is an object containing a property for each session attributes set by any code.\n   * It require to install a middleware like express-session to work.\n   */\n  get session(): {[key: string]: any} {\n    return this.raw.session as any;\n  }\n\n  get files() {\n    return this.raw.files;\n  }\n\n  /**\n   * Return the original request framework instance\n   */\n  get request() {\n    return this.getRequest();\n  }\n\n  /**\n   * Return the original request node.js instance\n   */\n  get req() {\n    return this.getReq();\n  }\n\n  /**\n   * Returns the HTTP request header specified by field. The match is case-insensitive.\n   *\n   * ```typescript\n   * request.get('Content-Type') // => \"text/plain\"\n   * ```\n   *\n   * @param name\n   */\n  get(name: string) {\n    return this.raw.get(name);\n  }\n\n  /**\n   * Checks if the specified content types are acceptable, based on the request’s Accept HTTP header field. The method returns the best match, or if none of the specified content types is acceptable, returns false (in which case, the application should respond with 406 \"Not Acceptable\").\n   *\n   * The type value may be a single MIME type string (such as “application/json”), an extension name such as “json”, a comma-delimited list, or an array. For a list or array, the method returns the best match (if any).\n   *\n   * @param mime\n   */\n  accepts(mime: string): string | false;\n\n  accepts(mime: string[]): string[] | false;\n\n  accepts(mime?: string | string[]): string | string[] | false {\n    // @ts-ignore\n    return this.raw.accepts(mime);\n  }\n\n  isAborted() {\n    return this.raw.aborted;\n  }\n\n  destroy() {\n    // @ts-ignore\n    delete this.raw;\n    // @ts-ignore\n    delete this.response;\n    // @ts-ignore\n    delete this.$ctx;\n  }\n\n  /**\n   * Return the Framework response object (express, koa, etc...)\n   */\n  getRequest<Req = T>(): Req {\n    return this.raw as any;\n  }\n\n  /**\n   * Return the Node.js response object\n   */\n  getReq(): IncomingMessage {\n    return this.raw as any;\n  }\n}\n"]}