@tsed/platform-params 6.88.1 → 6.89.0

package/lib/esm/domain/ParamMetadata.js

@@ -0,0 +1,31 @@
+import { __decorate, __metadata } from "tslib";
+import { DecoratorTypes, prototypeOf } from "@tsed/core";
+import { JsonEntityComponent, JsonEntityStore, JsonParameterStore } from "@tsed/schema";
+import { ParamTypes } from "./ParamTypes";
+let ParamMetadata = class ParamMetadata extends JsonParameterStore {
+    constructor(options) {
+        super(options);
+        this.paramType = "$ctx";
+        this.pipes = [];
+        this.paramType = options.paramType || this.paramType;
+        this.expression = options.expression || this.expression;
+        this.dataPath = options.dataPath || this.dataPath;
+        this.pipes = options.pipes || [];
+    }
+    get key() {
+        let { expression, paramType, dataPath } = this;
+        if (expression && paramType === ParamTypes.HEADER) {
+            expression = String(expression).toLowerCase();
+        }
+        return [dataPath, expression].filter(Boolean).join(".");
+    }
+    static get(target, propertyKey, index) {
+        return JsonEntityStore.from(prototypeOf(target), propertyKey, index);
+    }
+};
+ParamMetadata = __decorate([
+    JsonEntityComponent(DecoratorTypes.PARAM),
+    __metadata("design:paramtypes", [Object])
+], ParamMetadata);
+export { ParamMetadata };
+//# sourceMappingURL=ParamMetadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ParamMetadata.js","sourceRoot":"","sources":["../../../src/domain/ParamMetadata.ts"],"names":[],"mappings":";AAAA,OAAO,EAAC,cAAc,EAAE,WAAW,EAAO,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAC,mBAAmB,EAAE,eAAe,EAA0B,kBAAkB,EAAC,MAAM,cAAc,CAAC;AAE9G,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AASxC,IAAa,aAAa,GAA1B,MAAa,aAAc,SAAQ,kBAAkB;IAMnD,YAAY,OAAgC;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAJV,cAAS,GAAW,MAAM,CAAC;QAC3B,UAAK,GAAwB,EAAE,CAAC;QAIrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC;QACrD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC;QACxD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,GAAG;QACL,IAAI,EAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAC,GAAG,IAAI,CAAC;QAE7C,IAAI,UAAU,IAAI,SAAS,KAAK,UAAU,CAAC,MAAM,EAAE;YACjD,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;SAC/C;QAED,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,MAAiB,EAAE,WAA4B,EAAE,KAAa;QACvE,OAAO,eAAe,CAAC,IAAI,CAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IACtF,CAAC;CACF,CAAA;AA3BY,aAAa;IADzB,mBAAmB,CAAC,cAAc,CAAC,KAAK,CAAC;;GAC7B,aAAa,CA2BzB;SA3BY,aAAa","sourcesContent":["import {DecoratorTypes, prototypeOf, Type} from \"@tsed/core\";\nimport {JsonEntityComponent, JsonEntityStore, JsonEntityStoreOptions, JsonParameterStore} from \"@tsed/schema\";\nimport {ParamOptions} from \"./ParamOptions\";\nimport {ParamTypes} from \"./ParamTypes\";\n\nexport interface PipeMethods<T = any, R = any> {\n  transform(value: T, metadata: ParamMetadata): R;\n}\n\nexport type ParamConstructorOptions = JsonEntityStoreOptions & ParamOptions;\n\n@JsonEntityComponent(DecoratorTypes.PARAM)\nexport class ParamMetadata extends JsonParameterStore implements ParamConstructorOptions {\n  public expression: string;\n  public dataPath: string;\n  public paramType: string = \"$ctx\";\n  public pipes: Type<PipeMethods>[] = [];\n\n  constructor(options: ParamConstructorOptions) {\n    super(options);\n    this.paramType = options.paramType || this.paramType;\n    this.expression = options.expression || this.expression;\n    this.dataPath = options.dataPath || this.dataPath;\n    this.pipes = options.pipes || [];\n  }\n\n  get key() {\n    let {expression, paramType, dataPath} = this;\n\n    if (expression && paramType === ParamTypes.HEADER) {\n      expression = String(expression).toLowerCase();\n    }\n\n    return [dataPath, expression].filter(Boolean).join(\".\");\n  }\n\n  static get(target: Type<any>, propertyKey: string | symbol, index: number): ParamMetadata {\n    return JsonEntityStore.from<ParamMetadata>(prototypeOf(target), propertyKey, index);\n  }\n}\n"]}

package/lib/esm/domain/ParamOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ParamOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ParamOptions.js","sourceRoot":"","sources":["../../../src/domain/ParamOptions.ts"],"names":[],"mappings":"","sourcesContent":["import {Type} from \"@tsed/core\";\n\nexport interface ParamOptions<T = any> {\n  dataPath: string;\n  paramType: string;\n  expression?: string;\n  useType?: Type<T>;\n  useConverter?: boolean;\n  useValidation?: boolean;\n\n  [key: string]: any;\n}\n"]}

package/lib/esm/domain/ParamTypes.js

@@ -0,0 +1,27 @@
+export var ParamTypes;
+(function (ParamTypes) {
+    ParamTypes["$CTX"] = "$CTX";
+    ParamTypes["BODY"] = "BODY";
+    ParamTypes["PATH"] = "PATH";
+    ParamTypes["QUERY"] = "QUERY";
+    ParamTypes["HEADER"] = "HEADER";
+    ParamTypes["RAW_BODY"] = "RAW_BODY";
+    ParamTypes["COOKIES"] = "COOKIES";
+    ParamTypes["LOCALS"] = "LOCALS";
+    ParamTypes["SESSION"] = "SESSION";
+    ParamTypes["FILES"] = "FILES";
+    /// NOT STD
+    ParamTypes["NEXT_FN"] = "NEXT_FN";
+    ParamTypes["ERR"] = "ERR";
+    ParamTypes["REQUEST"] = "REQUEST";
+    ParamTypes["PLATFORM_REQUEST"] = "PLATFORM_REQUEST";
+    ParamTypes["NODE_REQUEST"] = "NODE_REQUEST";
+    ParamTypes["RESPONSE"] = "RESPONSE";
+    ParamTypes["PLATFORM_RESPONSE"] = "PLATFORM_RESPONSE";
+    ParamTypes["NODE_RESPONSE"] = "NODE_RESPONSE";
+    ParamTypes["RESPONSE_DATA"] = "RESPONSE_DATA";
+    ParamTypes["ENDPOINT_INFO"] = "ENDPOINT_INFO";
+    ParamTypes["RES"] = "RES";
+    ParamTypes["REQ"] = "REQ";
+})(ParamTypes || (ParamTypes = {}));
+//# sourceMappingURL=ParamTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ParamTypes.js","sourceRoot":"","sources":["../../../src/domain/ParamTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,UAyBX;AAzBD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,6BAAe,CAAA;IACf,+BAAiB,CAAA;IACjB,mCAAqB,CAAA;IACrB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;IACnB,6BAAe,CAAA;IAEf,WAAW;IACX,iCAAmB,CAAA;IACnB,yBAAW,CAAA;IACX,iCAAmB,CAAA;IACnB,mDAAqC,CAAA;IACrC,2CAA6B,CAAA;IAC7B,mCAAqB,CAAA;IACrB,qDAAuC,CAAA;IACvC,6CAA+B,CAAA;IAC/B,6CAA+B,CAAA;IAC/B,6CAA+B,CAAA;IAC/B,yBAAW,CAAA;IACX,yBAAW,CAAA;AACb,CAAC,EAzBW,UAAU,KAAV,UAAU,QAyBrB","sourcesContent":["export enum ParamTypes {\n  $CTX = \"$CTX\",\n  BODY = \"BODY\",\n  PATH = \"PATH\",\n  QUERY = \"QUERY\",\n  HEADER = \"HEADER\",\n  RAW_BODY = \"RAW_BODY\",\n  COOKIES = \"COOKIES\",\n  LOCALS = \"LOCALS\",\n  SESSION = \"SESSION\",\n  FILES = \"FILES\",\n\n  /// NOT STD\n  NEXT_FN = \"NEXT_FN\",\n  ERR = \"ERR\",\n  REQUEST = \"REQUEST\",\n  PLATFORM_REQUEST = \"PLATFORM_REQUEST\",\n  NODE_REQUEST = \"NODE_REQUEST\",\n  RESPONSE = \"RESPONSE\",\n  PLATFORM_RESPONSE = \"PLATFORM_RESPONSE\",\n  NODE_RESPONSE = \"NODE_RESPONSE\",\n  RESPONSE_DATA = \"RESPONSE_DATA\",\n  ENDPOINT_INFO = \"ENDPOINT_INFO\",\n  RES = \"RES\",\n  REQ = \"REQ\"\n}\n"]}

package/lib/esm/errors/ParamValidationError.js

@@ -0,0 +1,25 @@
+import { nameOf } from "@tsed/core";
+import { BadRequest } from "@tsed/exceptions";
+import { ValidationError } from "./ValidationError";
+export class ParamValidationError extends BadRequest {
+    constructor() {
+        super(...arguments);
+        this.name = "PARAM_VALIDATION_ERROR";
+    }
+    static from(metadata, origin = {}) {
+        if (origin instanceof ValidationError || origin instanceof BadRequest) {
+            const name = nameOf(metadata.paramType)
+                .toLowerCase()
+                .replace(/parse|params|filter/gi, "");
+            const expression = metadata.expression;
+            const message = `Bad request on parameter "request.${name}${expression ? "." + expression : ""}".\n${origin.message}`.trim();
+            const error = new ParamValidationError(message);
+            error.dataPath = String(metadata.expression) || "";
+            error.requestType = nameOf(metadata.paramType);
+            error.origin = origin.origin || origin;
+            return error;
+        }
+        return origin;
+    }
+}
+//# sourceMappingURL=ParamValidationError.js.map

package/lib/esm/errors/ParamValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParamValidationError.js","sourceRoot":"","sources":["../../../src/errors/ParamValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,YAAY,CAAC;AAClC,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAElD,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAApD;;QACS,SAAI,GAAW,wBAAwB,CAAC;IAsBjD,CAAC;IAlBC,MAAM,CAAC,IAAI,CAAC,QAAuB,EAAE,SAAc,EAAE;QACnD,IAAI,MAAM,YAAY,eAAe,IAAI,MAAM,YAAY,UAAU,EAAE;YACrE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;iBACpC,WAAW,EAAE;iBACb,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;YACxC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;YACvC,MAAM,OAAO,GAAG,qCAAqC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;YAE7H,MAAM,KAAK,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAChD,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACnD,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC/C,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;YAEvC,OAAO,KAAK,CAAC;SACd;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF","sourcesContent":["import {nameOf} from \"@tsed/core\";\nimport {BadRequest} from \"@tsed/exceptions\";\nimport {ParamMetadata} from \"../domain/ParamMetadata\";\nimport {ValidationError} from \"./ValidationError\";\n\nexport class ParamValidationError extends BadRequest {\n  public name: string = \"PARAM_VALIDATION_ERROR\";\n  public dataPath: string;\n  public requestType: string;\n\n  static from(metadata: ParamMetadata, origin: any = {}) {\n    if (origin instanceof ValidationError || origin instanceof BadRequest) {\n      const name = nameOf(metadata.paramType)\n        .toLowerCase()\n        .replace(/parse|params|filter/gi, \"\");\n      const expression = metadata.expression;\n      const message = `Bad request on parameter \"request.${name}${expression ? \".\" + expression : \"\"}\".\\n${origin.message}`.trim();\n\n      const error = new ParamValidationError(message);\n      error.dataPath = String(metadata.expression) || \"\";\n      error.requestType = nameOf(metadata.paramType);\n      error.origin = origin.origin || origin;\n\n      return error;\n    }\n\n    return origin;\n  }\n}\n"]}

package/lib/esm/errors/RequiredValidationError.js

@@ -0,0 +1,28 @@
+import { nameOf } from "@tsed/core";
+import { ValidationError } from "./ValidationError";
+export class RequiredValidationError extends ValidationError {
+    constructor() {
+        super(...arguments);
+        this.name = "REQUIRED_VALIDATION_ERROR";
+    }
+    static from(metadata) {
+        const name = nameOf(metadata.paramType);
+        const expression = metadata.expression;
+        const type = name.toLowerCase().replace(/parse|params|filter/gi, "");
+        const message = `It should have required parameter '${expression}'`;
+        const errors = [
+            {
+                dataPath: "",
+                keyword: "required",
+                message,
+                modelName: type,
+                params: {
+                    missingProperty: expression
+                },
+                schemaPath: "#/required"
+            }
+        ];
+        return new RequiredValidationError(message, errors);
+    }
+}
+//# sourceMappingURL=RequiredValidationError.js.map

package/lib/esm/errors/RequiredValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequiredValidationError.js","sourceRoot":"","sources":["../../../src/errors/RequiredValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,YAAY,CAAC;AAElC,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAElD,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAA5D;;QACS,SAAI,GAAW,2BAA2B,CAAC;IAuBpD,CAAC;IArBC,MAAM,CAAC,IAAI,CAAC,QAAuB;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,sCAAsC,UAAU,GAAG,CAAC;QAEpE,MAAM,MAAM,GAAG;YACb;gBACE,QAAQ,EAAE,EAAE;gBACZ,OAAO,EAAE,UAAU;gBACnB,OAAO;gBACP,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE;oBACN,eAAe,EAAE,UAAU;iBAC5B;gBACD,UAAU,EAAE,YAAY;aACzB;SACF,CAAC;QAEF,OAAO,IAAI,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;CACF","sourcesContent":["import {nameOf} from \"@tsed/core\";\nimport {ParamMetadata} from \"../domain/ParamMetadata\";\nimport {ValidationError} from \"./ValidationError\";\n\nexport class RequiredValidationError extends ValidationError {\n  public name: string = \"REQUIRED_VALIDATION_ERROR\";\n\n  static from(metadata: ParamMetadata) {\n    const name = nameOf(metadata.paramType);\n    const expression = metadata.expression;\n    const type = name.toLowerCase().replace(/parse|params|filter/gi, \"\");\n    const message = `It should have required parameter '${expression}'`;\n\n    const errors = [\n      {\n        dataPath: \"\",\n        keyword: \"required\",\n        message,\n        modelName: type,\n        params: {\n          missingProperty: expression\n        },\n        schemaPath: \"#/required\"\n      }\n    ];\n\n    return new RequiredValidationError(message, errors);\n  }\n}\n"]}

package/lib/esm/errors/ValidationError.js

@@ -0,0 +1,9 @@
+import { BadRequest } from "@tsed/exceptions";
+export class ValidationError extends BadRequest {
+    constructor(message, errors = []) {
+        super(message);
+        this.name = "VALIDATION_ERROR";
+        this.errors = errors;
+    }
+}
+//# sourceMappingURL=ValidationError.js.map

package/lib/esm/errors/ValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.js","sourceRoot":"","sources":["../../../src/errors/ValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAE5C,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAI7C,YAAY,OAAe,EAAE,SAAgB,EAAE;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAJV,SAAI,GAAW,kBAAkB,CAAC;QAKvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF","sourcesContent":["import {BadRequest} from \"@tsed/exceptions\";\n\nexport class ValidationError extends BadRequest {\n  public name: string = \"VALIDATION_ERROR\";\n  public errors: any[];\n\n  constructor(message: string, errors: any[] = []) {\n    super(message);\n    this.errors = errors;\n  }\n}\n"]}

package/lib/esm/index.js

@@ -0,0 +1,34 @@
+export * from "./utils/mapParamsOptions";
+// domain
+export * from "./domain/ParamMetadata";
+export * from "./domain/ParamOptions";
+export * from "./domain/ParamTypes";
+// pipes
+export * from "./pipes/ParseExpressionPipe";
+export * from "./pipes/DeserializerPipe";
+export * from "./pipes/ValidationPipe";
+// builder
+export * from "./builder/PlatformParams";
+// errors
+export * from "./errors/RequiredValidationError";
+export * from "./errors/ValidationError";
+export * from "./errors/ParamValidationError";
+// decorators
+export * from "./decorators/context";
+export * from "./decorators/bodyParams";
+export * from "./decorators/usePipe";
+export * from "./decorators/useParam";
+export * from "./decorators/useParamType";
+export * from "./decorators/useType";
+export * from "./decorators/useValidation";
+export * from "./decorators/useDeserialization";
+export * from "./decorators/useParamExpression";
+export * from "./decorators/useParamType";
+export * from "./decorators/headerParams";
+export * from "./decorators/cookies";
+export * from "./decorators/locals";
+export * from "./decorators/pathParams";
+export * from "./decorators/queryParams";
+export * from "./decorators/session";
+export * from "./decorators/paramFn";
+//# 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,0BAA0B,CAAC;AAEzC,SAAS;AACT,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AAEpC,QAAQ;AACR,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAEvC,UAAU;AACV,cAAc,0BAA0B,CAAC;AAEzC,SAAS;AACT,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAE9C,aAAa;AACb,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC","sourcesContent":["export * from \"./utils/mapParamsOptions\";\n\n// domain\nexport * from \"./domain/ParamMetadata\";\nexport * from \"./domain/ParamOptions\";\nexport * from \"./domain/ParamTypes\";\n\n// pipes\nexport * from \"./pipes/ParseExpressionPipe\";\nexport * from \"./pipes/DeserializerPipe\";\nexport * from \"./pipes/ValidationPipe\";\n\n// builder\nexport * from \"./builder/PlatformParams\";\n\n// errors\nexport * from \"./errors/RequiredValidationError\";\nexport * from \"./errors/ValidationError\";\nexport * from \"./errors/ParamValidationError\";\n\n// decorators\nexport * from \"./decorators/context\";\nexport * from \"./decorators/bodyParams\";\nexport * from \"./decorators/usePipe\";\nexport * from \"./decorators/useParam\";\nexport * from \"./decorators/useParamType\";\nexport * from \"./decorators/useType\";\nexport * from \"./decorators/useValidation\";\nexport * from \"./decorators/useDeserialization\";\nexport * from \"./decorators/useParamExpression\";\nexport * from \"./decorators/useParamType\";\nexport * from \"./decorators/headerParams\";\nexport * from \"./decorators/cookies\";\nexport * from \"./decorators/locals\";\nexport * from \"./decorators/pathParams\";\nexport * from \"./decorators/queryParams\";\nexport * from \"./decorators/session\";\nexport * from \"./decorators/paramFn\";\n"]}

package/lib/esm/pipes/DeserializerPipe.js

@@ -0,0 +1,27 @@
+var DeserializerPipe_1;
+import { __decorate, __metadata } from "tslib";
+import { Constant, Injectable } from "@tsed/di";
+import { deserialize } from "@tsed/json-mapper";
+let DeserializerPipe = DeserializerPipe_1 = class DeserializerPipe {
+    transform(value, param) {
+        return deserialize(value, {
+            useAlias: true,
+            additionalProperties: this.settings.additionalProperties === "accept",
+            type: param.type,
+            collectionType: param.collectionType,
+            groups: param.parameter.groups,
+            genericTypes: param.nestedGenerics[0],
+            nestedGenerics: param.nestedGenerics,
+            ...(param.store.get(DeserializerPipe_1) || {})
+        });
+    }
+};
+__decorate([
+    Constant("converter", {}),
+    __metadata("design:type", Object)
+], DeserializerPipe.prototype, "settings", void 0);
+DeserializerPipe = DeserializerPipe_1 = __decorate([
+    Injectable()
+], DeserializerPipe);
+export { DeserializerPipe };
+//# sourceMappingURL=DeserializerPipe.js.map

package/lib/esm/pipes/DeserializerPipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeserializerPipe.js","sourceRoot":"","sources":["../../../src/pipes/DeserializerPipe.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAC,QAAQ,EAAE,UAAU,EAAC,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAI9C,IAAa,gBAAgB,wBAA7B,MAAa,gBAAgB;IAM3B,SAAS,CAAC,KAAU,EAAE,KAAoB;QACxC,OAAO,WAAW,CAAC,KAAK,EAAE;YACxB,QAAQ,EAAE,IAAI;YACd,oBAAoB,EAAE,IAAI,CAAC,QAAQ,CAAC,oBAAoB,KAAK,QAAQ;YACrE,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM;YAC9B,YAAY,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;YACrC,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAgB,CAAC,IAAI,EAAE,CAAC;SAC7C,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAhBC;IADC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;;kDAGxB;AAJS,gBAAgB;IAD5B,UAAU,EAAE;GACA,gBAAgB,CAkB5B;SAlBY,gBAAgB","sourcesContent":["import {Constant, Injectable} from \"@tsed/di\";\nimport {deserialize} from \"@tsed/json-mapper\";\nimport {ParamMetadata, PipeMethods} from \"../domain/ParamMetadata\";\n\n@Injectable()\nexport class DeserializerPipe implements PipeMethods {\n  @Constant(\"converter\", {})\n  private settings: {\n    additionalProperties?: \"error\" | \"accept\" | \"ignore\";\n  };\n\n  transform(value: any, param: ParamMetadata) {\n    return deserialize(value, {\n      useAlias: true,\n      additionalProperties: this.settings.additionalProperties === \"accept\",\n      type: param.type,\n      collectionType: param.collectionType,\n      groups: param.parameter.groups,\n      genericTypes: param.nestedGenerics[0],\n      nestedGenerics: param.nestedGenerics,\n      ...(param.store.get(DeserializerPipe) || {})\n    });\n  }\n}\n"]}

package/lib/esm/pipes/ParseExpressionPipe.js

@@ -0,0 +1,21 @@
+import { __decorate } from "tslib";
+import { getValue } from "@tsed/core";
+import { Injectable } from "@tsed/di";
+import { ParamTypes } from "../domain/ParamTypes";
+let ParseExpressionPipe = class ParseExpressionPipe {
+    transform(scope, param) {
+        const { paramType, type } = param;
+        const value = getValue(scope, param.key);
+        if ([ParamTypes.QUERY, ParamTypes.PATH].includes(paramType) && value === "" && type !== String) {
+            return undefined;
+        }
+        return value;
+    }
+};
+ParseExpressionPipe = __decorate([
+    Injectable({
+        priority: -1000
+    })
+], ParseExpressionPipe);
+export { ParseExpressionPipe };
+//# sourceMappingURL=ParseExpressionPipe.js.map

package/lib/esm/pipes/ParseExpressionPipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParseExpressionPipe.js","sourceRoot":"","sources":["../../../src/pipes/ParseExpressionPipe.ts"],"names":[],"mappings":";AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AACpC,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAEpC,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAMhD,IAAa,mBAAmB,GAAhC,MAAa,mBAAmB;IAC9B,SAAS,CAAC,KAAe,EAAE,KAAoB;QAC7C,MAAM,EAAC,SAAS,EAAE,IAAI,EAAC,GAAG,KAAK,CAAC;QAEhC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAuB,CAAC,IAAI,KAAK,KAAK,EAAE,IAAI,IAAI,KAAK,MAAM,EAAE;YAC5G,OAAO,SAAS,CAAC;SAClB;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAA;AAZY,mBAAmB;IAH/B,UAAU,CAAC;QACV,QAAQ,EAAE,CAAC,IAAI;KAChB,CAAC;GACW,mBAAmB,CAY/B;SAZY,mBAAmB","sourcesContent":["import {getValue} from \"@tsed/core\";\nimport {Injectable} from \"@tsed/di\";\nimport {PipeMethods, ParamMetadata} from \"../domain/ParamMetadata\";\nimport {ParamTypes} from \"../domain/ParamTypes\";\nimport type {ArgScope} from \"../builder/PlatformParams\";\n\n@Injectable({\n  priority: -1000\n})\nexport class ParseExpressionPipe implements PipeMethods {\n  transform(scope: ArgScope, param: ParamMetadata) {\n    const {paramType, type} = param;\n\n    const value = getValue(scope, param.key);\n\n    if ([ParamTypes.QUERY, ParamTypes.PATH].includes(paramType as ParamTypes) && value === \"\" && type !== String) {\n      return undefined;\n    }\n\n    return value;\n  }\n}\n"]}

package/lib/esm/pipes/ValidationPipe.js

@@ -0,0 +1,77 @@
+import { __decorate, __metadata } from "tslib";
+import { nameOf } from "@tsed/core";
+import { Injectable, InjectorService } from "@tsed/di";
+import { deserialize } from "@tsed/json-mapper";
+import { getJsonSchema } from "@tsed/schema";
+import { RequiredValidationError } from "../errors/RequiredValidationError";
+import { ParamTypes } from "../domain/ParamTypes";
+let ValidationPipe = class ValidationPipe {
+    constructor(injector) {
+        const provider = injector.getProviders().find((provider) => nameOf(provider.token) === "AjvService");
+        if (provider) {
+            this.validator = injector.invoke(provider.token);
+        }
+    }
+    coerceTypes(value, metadata) {
+        if (value === undefined) {
+            return value;
+        }
+        if (value === "null") {
+            return null;
+        }
+        if (metadata.isPrimitive) {
+            try {
+                return deserialize(value, {
+                    type: metadata.type
+                });
+            }
+            catch (er) {
+                return value;
+            }
+        }
+        if (metadata.isArray) {
+            return [].concat(value);
+        }
+        return value;
+    }
+    skip(value, metadata) {
+        return metadata.paramType === ParamTypes.PATH && !metadata.isPrimitive;
+    }
+    async transform(value, metadata) {
+        if (!this.validator) {
+            this.checkIsRequired(value, metadata);
+            return value;
+        }
+        if (this.skip(value, metadata)) {
+            return value;
+        }
+        value = this.coerceTypes(value, metadata);
+        this.checkIsRequired(value, metadata);
+        if (value === undefined) {
+            return value;
+        }
+        const schema = getJsonSchema(metadata, {
+            customKeys: true
+        });
+        await this.validator.validate(value, {
+            schema,
+            type: metadata.isClass ? metadata.type : undefined,
+            collectionType: metadata.collectionType
+        });
+        return value;
+    }
+    checkIsRequired(value, metadata) {
+        if (metadata.isRequired(value)) {
+            throw RequiredValidationError.from(metadata);
+        }
+        return true;
+    }
+};
+ValidationPipe = __decorate([
+    Injectable({
+        type: "validator"
+    }),
+    __metadata("design:paramtypes", [InjectorService])
+], ValidationPipe);
+export { ValidationPipe };
+//# sourceMappingURL=ValidationPipe.js.map

package/lib/esm/pipes/ValidationPipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationPipe.js","sourceRoot":"","sources":["../../../src/pipes/ValidationPipe.ts"],"names":[],"mappings":"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","sourcesContent":["import {nameOf} from \"@tsed/core\";\nimport {Injectable, InjectorService} from \"@tsed/di\";\nimport {deserialize} from \"@tsed/json-mapper\";\nimport {getJsonSchema} from \"@tsed/schema\";\nimport {RequiredValidationError} from \"../errors/RequiredValidationError\";\nimport {PipeMethods, ParamMetadata} from \"../domain/ParamMetadata\";\nimport {ParamTypes} from \"../domain/ParamTypes\";\n\n@Injectable({\n  type: \"validator\"\n})\nexport class ValidationPipe implements PipeMethods {\n  private validator: {validate(value: any, options: any): Promise<any>};\n\n  constructor(injector: InjectorService) {\n    const provider = injector.getProviders().find((provider) => nameOf(provider.token) === \"AjvService\");\n\n    if (provider) {\n      this.validator = injector.invoke<any>(provider.token);\n    }\n  }\n\n  coerceTypes(value: any, metadata: ParamMetadata) {\n    if (value === undefined) {\n      return value;\n    }\n\n    if (value === \"null\") {\n      return null;\n    }\n\n    if (metadata.isPrimitive) {\n      try {\n        return deserialize(value, {\n          type: metadata.type\n        });\n      } catch (er) {\n        return value;\n      }\n    }\n\n    if (metadata.isArray) {\n      return [].concat(value);\n    }\n\n    return value;\n  }\n\n  skip(value: any, metadata: ParamMetadata) {\n    return metadata.paramType === ParamTypes.PATH && !metadata.isPrimitive;\n  }\n\n  async transform(value: any, metadata: ParamMetadata): Promise<any> {\n    if (!this.validator) {\n      this.checkIsRequired(value, metadata);\n      return value;\n    }\n\n    if (this.skip(value, metadata)) {\n      return value;\n    }\n\n    value = this.coerceTypes(value, metadata);\n\n    this.checkIsRequired(value, metadata);\n\n    if (value === undefined) {\n      return value;\n    }\n\n    const schema = getJsonSchema(metadata, {\n      customKeys: true\n    });\n\n    await this.validator.validate(value, {\n      schema,\n      type: metadata.isClass ? metadata.type : undefined,\n      collectionType: metadata.collectionType\n    });\n\n    return value;\n  }\n\n  protected checkIsRequired(value: any, metadata: ParamMetadata) {\n    if (metadata.isRequired(value)) {\n      throw RequiredValidationError.from(metadata);\n    }\n\n    return true;\n  }\n}\n"]}

package/lib/esm/utils/mapParamsOptions.js

@@ -0,0 +1,26 @@
+import { isObject } from "@tsed/core";
+/**
+ * @ignore
+ */
+export function mapParamsOptions(args) {
+    if (args.length === 1) {
+        if (typeof args[0] === "string") {
+            return {
+                expression: args[0]
+            };
+        }
+        if (!isObject(args[0])) {
+            return {
+                useType: args[0]
+            };
+        }
+        return {
+            ...args[0]
+        };
+    }
+    return {
+        expression: args[0],
+        useType: args[1]
+    };
+}
+//# sourceMappingURL=mapParamsOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapParamsOptions.js","sourceRoot":"","sources":["../../../src/utils/mapParamsOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAGpC;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAW;IAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;QACrB,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE;YAC/B,OAAO;gBACL,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;aACpB,CAAC;SACH;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YACtB,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;aACjB,CAAC;SACH;QAED,OAAO;YACL,GAAG,IAAI,CAAC,CAAC,CAAC;SACX,CAAC;KACH;IAED,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;QACnB,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;KACjB,CAAC;AACJ,CAAC","sourcesContent":["import {isObject} from \"@tsed/core\";\nimport {ParamOptions} from \"../domain/ParamOptions\";\n\n/**\n * @ignore\n */\nexport function mapParamsOptions(args: any[]): Partial<ParamOptions<any>> {\n  if (args.length === 1) {\n    if (typeof args[0] === \"string\") {\n      return {\n        expression: args[0]\n      };\n    }\n\n    if (!isObject(args[0])) {\n      return {\n        useType: args[0]\n      };\n    }\n\n    return {\n      ...args[0]\n    };\n  }\n\n  return {\n    expression: args[0],\n    useType: args[1]\n  };\n}\n"]}

package/lib/types/builder/PlatformParams.d.ts

@@ -0,0 +1,23 @@
+import { DIContext, InjectorService, TokenProvider } from "@tsed/di";
+import { JsonEntityStore } from "@tsed/schema";
+import { ParamMetadata, PipeMethods } from "../domain/ParamMetadata";
+export declare type ArgScope<Context extends DIContext = DIContext> = {
+    $ctx: Context;
+} & Record<string, any>;
+export declare type HandlerWithScope<Context extends DIContext = DIContext> = (scope: ArgScope<Context>) => any;
+export interface CompileHandlerOptions<Context extends DIContext = DIContext> extends Record<any, unknown> {
+    token: TokenProvider;
+    propertyKey: string | symbol;
+    getCustomArgs?: (scope: ArgScope<Context>) => Promise<any[]>;
+}
+/**
+ * Platform Params abstraction layer.
+ * @platform
+ */
+export declare class PlatformParams {
+    protected injector: InjectorService;
+    getPipes(param: ParamMetadata): Promise<PipeMethods<any, any>[]>;
+    compile<Context extends DIContext = DIContext>(entity: JsonEntityStore): Promise<(scope: ArgScope<Context>) => Promise<any[]>>;
+    getArg(scope: ArgScope, pipes: PipeMethods[], param: ParamMetadata): Promise<any>;
+    compileHandler<Context extends DIContext = DIContext>(metadata: CompileHandlerOptions<Context>): Promise<HandlerWithScope<Context>>;
+}

package/lib/types/decorators/bodyParams.d.ts

@@ -0,0 +1,64 @@
+import { Type } from "@tsed/core";
+import { ParamOptions } from "../domain/ParamOptions";
+/**
+ * BodyParams return the value from [request.body](http://expressjs.com/en/4x/api.html#req.body) object.
+ *
+ * #### Example
+ *
+ * ```typescript
+ * @Controller('/')
+ * class MyCtrl {
+ *    @Post('/')
+ *    create(@BodyParams() body: any) {
+ *       console.log('Entire body', body);
+ *    }
+ *
+ *    @Post('/')
+ *    create(@BodyParams('id') id: string) {
+ *       console.log('ID', id);
+ *    }
+ *
+ *    @Post('/')
+ *    create(@BodyParams('user') user: User) { // with deserialization
+ *       console.log('user', user);
+ *    }
+ *
+ *    @Post('/')
+ *    create(@BodyParams('users', User) users: User[]) { // with deserialization
+ *       console.log('users', users);
+ *    }
+ * }
+ * ```
+ * > For more information on deserialization see [converters](/docs/converters.md) page.
+ *
+ * @param expression The path of the property to get.
+ * @param useType The type of the class that to be used to deserialize the data.
+ * @decorator
+ * @operation
+ * @input
+ */
+export declare function BodyParams(expression: string, useType: Type<any>): ParameterDecorator;
+export declare function BodyParams(expression: string): ParameterDecorator;
+export declare function BodyParams(useType: Type<any>): ParameterDecorator;
+export declare function BodyParams(options: Partial<ParamOptions>): ParameterDecorator;
+export declare function BodyParams(): ParameterDecorator;
+/**
+ * RawBodyParams return the value from [request.body](http://expressjs.com/en/4x/api.html#req.body) as a Buffer.
+ *
+ * #### Example
+ *
+ * ```typescript
+ * @Controller('/')
+ * class MyCtrl {
+ *    @Post('/')
+ *    create(@RawBodyParams() body: Buffer) {
+ *       console.log('Entire body', body.toString("utf8"));
+ *    }
+ * }
+ * ```
+ *
+ * @decorator
+ * @operation
+ * @input
+ */
+export declare function RawBodyParams(): ParameterDecorator;

package/lib/types/decorators/context.d.ts

@@ -0,0 +1,59 @@
+import { BaseContext } from "@tsed/di";
+declare global {
+    namespace TsED {
+        interface Context {
+        }
+    }
+}
+/**
+ * Context decorator return the @@PlatformContext@@ created by Ts.ED when request is handled by the server.
+ *
+ * It contains some information as following:
+ *
+ * - The request id,
+ * - The request container used by the Ts.ED DI. It contain all services annotated with `@Scope(ProviderScope.REQUEST)`,
+ * - The current @@EndpointMetadata@@ resolved by Ts.ED during the request,
+ * - The data return by the previous endpoint if you use multiple handler on the same route. By default data is empty.
+ *
+ * ::: tip
+ * The @@PlatformContext@@ inherit from Map class. So you can store any information with.
+ * :::
+ *
+ * #### Example
+ *
+ * ```typescript
+ * @Middleware()
+ * class AuthTokenMiddleware {
+ *   use(@Req() request: Req, @Context() context: PlatformContext) {
+ *      if (!context.has("auth")){
+ *        context.set('auth', new AuthToken(request))
+ *      }
+ *
+ *      try {
+ *        context.get("auth").claims() // check token
+ *      } catch(er){
+ *        throw new Forbidden("Access forbidden - Bad token")
+ *      }
+ *   }
+ * }
+ *
+ * @Controller('/')
+ * @UseBefore(AuthTokenMiddleware) // protect all routes for this controller
+ * class MyCtrl {
+ *    @Get('/')
+ *    get(@Context('auth') auth: AuthToken) {
+ *       console.log('auth', auth);
+ *       console.log('auth.accessToken', auth.accessToken);
+ *       console.log('auth.idToken', auth.idToken);
+ *    }
+ * }
+ * ```
+ *
+ * @param expression The path of the property to get.
+ * @decorator
+ * @operation
+ * @input
+ */
+export declare function Context(expression: string): ParameterDecorator;
+export declare function Context(): ParameterDecorator;
+export declare type Context = BaseContext;

package/lib/types/decorators/cookies.d.ts

@@ -0,0 +1,81 @@
+import { Type } from "@tsed/core";
+import { ParamOptions } from "../domain/ParamOptions";
+/**
+ * Cookies or CookiesParams return the value from [request.cookies](http://expressjs.com/en/4x/api.html#req.cookies) object.
+ *
+ * #### Example
+ *
+ * ```typescript
+ * @Controller('/')
+ * class MyCtrl {
+ *    @Post('/')
+ *    create(@Cookies() cookies: any) {
+ *       console.log('Entire cookies', cookies);
+ *    }
+ *
+ *    @Post('/')
+ *    create(@Cookies('id') id: string) {
+ *       console.log('ID', id);
+ *    }
+ *
+ *    @Post('/')
+ *    create(@Cookies('user') user: IUser) {
+ *       console.log('user', user);
+ *    }
+ * }
+ * ```
+ * > For more information on deserialization see [converters](/docs/converters.md) page.
+ *
+ * @param expression The path of the property to get.
+ * @param useType The type of the class that to be used to deserialize the data.
+ * @decorator
+ * @operation
+ * @input
+ */
+export declare function CookiesParams(expression: string | any, useType: any): ParameterDecorator;
+export declare function CookiesParams(): ParameterDecorator;
+export declare function CookiesParams(expression: string | any): ParameterDecorator;
+export declare function CookiesParams(options: ParamOptions<any>): ParameterDecorator;
+/**
+ * Cookies or CookiesParams return the value from [request.cookies](http://expressjs.com/en/4x/api.html#req.cookies) object.
+ *
+ * #### Example
+ *
+ * ```typescript
+ * @Controller('/')
+ * class MyCtrl {
+ *    @Post('/')
+ *    create(@Cookies() body: any) {
+ *       console.log('Entire body', body);
+ *    }
+ *
+ *    @Post('/')
+ *    create(@Cookies('id') id: string) {
+ *       console.log('ID', id);
+ *    }
+ *
+ *    @Post('/')
+ *    create(@Cookies('user') user: User) { // with deserialization
+ *       console.log('user', user);
+ *    }
+ *
+ *    @Post('/')
+ *    create(@Cookies('users', User) users: User[]) { // with deserialization
+ *       console.log('users', users);
+ *    }
+ * }
+ * ```
+ * > For more information on deserialization see [converters](/docs/converters.md) page.
+ *
+ * @param expression The path of the property to get.
+ * @param useType The type of the class that to be used to deserialize the data.
+ * @decorator
+ * @aliasof CookiesParams
+ * @operation
+ * @input
+ */
+export declare function Cookies(expression: string, useType: Type<any>): ParameterDecorator;
+export declare function Cookies(expression: string): ParameterDecorator;
+export declare function Cookies(useType: Type<any>): ParameterDecorator;
+export declare function Cookies(options: Partial<ParamOptions>): ParameterDecorator;
+export declare function Cookies(): ParameterDecorator;