@tsed/platform-params 7.0.0-alpha.1 → 7.0.0-beta.10

package/lib/esm/decorators/context.js

@@ -0,0 +1,14 @@
+import { ParamTypes } from "../domain/ParamTypes.js";
+import { mapParamsOptions } from "../utils/mapParamsOptions.js";
+import { UseParam } from "./useParam.js";
+export function Context(...args) {
+    const { expression, useType, useConverter = false, useValidation = false } = mapParamsOptions(args);
+    return UseParam({
+        paramType: ParamTypes.$CTX,
+        expression,
+        useType,
+        useConverter,
+        useValidation
+    });
+}
+//# sourceMappingURL=context.js.map

package/lib/esm/decorators/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/decorators/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAqDpC,MAAM,UAAU,OAAO,CAAC,GAAG,IAAW;IACpC,MAAM,EAAC,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK,EAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAElG,OAAO,QAAQ,CAAC;QACd,SAAS,EAAE,UAAU,CAAC,IAAI;QAC1B,UAAU;QACV,OAAO;QACP,YAAY;QACZ,aAAa;KACd,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {BaseContext} from \"@tsed/di\";\nimport {ParamTypes} from \"../domain/ParamTypes\";\nimport {mapParamsOptions} from \"../utils/mapParamsOptions\";\nimport {UseParam} from \"./useParam\";\n\n/**\n * Context decorator return the @@PlatformContext@@ created by Ts.ED when request is handled by the server.\n *\n * It contains some information as following:\n *\n * - The request id,\n * - The request container used by the Ts.ED DI. It contain all services annotated with `@Scope(ProviderScope.REQUEST)`,\n * - The current @@EndpointMetadata@@ resolved by Ts.ED during the request,\n * - The data return by the previous endpoint if you use multiple handler on the same route. By default data is empty.\n *\n * ::: tip\n * The @@PlatformContext@@ inherit from Map class. So you can store any information with.\n * :::\n *\n * #### Example\n *\n * ```typescript\n * @Middleware()\n * class AuthTokenMiddleware {\n *   use(@Req() request: Req, @Context() context: PlatformContext) {\n *      if (!context.has(\"auth\")){\n *        context.set('auth', new AuthToken(request))\n *      }\n *\n *      try {\n *        context.get(\"auth\").claims() // check token\n *      } catch(er){\n *        throw new Forbidden(\"Access forbidden - Bad token\")\n *      }\n *   }\n * }\n *\n * @Controller('/')\n * @UseBefore(AuthTokenMiddleware) // protect all routes for this controller\n * class MyCtrl {\n *    @Get('/')\n *    get(@Context('auth') auth: AuthToken) {\n *       console.log('auth', auth);\n *       console.log('auth.accessToken', auth.accessToken);\n *       console.log('auth.idToken', auth.idToken);\n *    }\n * }\n * ```\n *\n * @param expression The path of the property to get.\n * @decorator\n * @operation\n * @input\n */\nexport function Context(expression: string): ParameterDecorator;\nexport function Context(): ParameterDecorator;\nexport function Context(...args: any[]): ParameterDecorator {\n  const {expression, useType, useConverter = false, useValidation = false} = mapParamsOptions(args);\n\n  return UseParam({\n    paramType: ParamTypes.$CTX,\n    expression,\n    useType,\n    useConverter,\n    useValidation\n  });\n}\n\nexport type Context = BaseContext;\n"]}

package/lib/esm/decorators/cookies.js

@@ -0,0 +1,18 @@
+import { ParamTypes } from "../domain/ParamTypes.js";
+import { mapParamsOptions } from "../utils/mapParamsOptions.js";
+import { UseParam } from "./useParam.js";
+export function CookiesParams(...args) {
+    const { expression, useType, useConverter = false, useValidation = false } = mapParamsOptions(args);
+    return UseParam({
+        paramType: ParamTypes.COOKIES,
+        expression,
+        useType,
+        useConverter,
+        useValidation
+    });
+}
+export function Cookies(...args) {
+    // @ts-ignore
+    return CookiesParams(...args);
+}
+//# sourceMappingURL=cookies.js.map

package/lib/esm/decorators/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../../src/decorators/cookies.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAsCpC,MAAM,UAAU,aAAa,CAAC,GAAG,IAAW;IAC1C,MAAM,EAAC,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK,EAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAElG,OAAO,QAAQ,CAAC;QACd,SAAS,EAAE,UAAU,CAAC,OAAO;QAC7B,UAAU;QACV,OAAO;QACP,YAAY;QACZ,aAAa;KACd,CAAC,CAAC;AACL,CAAC;AA6CD,MAAM,UAAU,OAAO,CAAC,GAAG,IAAW;IACpC,aAAa;IACb,OAAO,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;AAChC,CAAC","sourcesContent":["import {Type} from \"@tsed/core\";\nimport {ParamOptions} from \"../domain/ParamOptions\";\nimport {ParamTypes} from \"../domain/ParamTypes\";\nimport {mapParamsOptions} from \"../utils/mapParamsOptions\";\nimport {UseParam} from \"./useParam\";\n\n/**\n * Cookies or CookiesParams return the value from [request.cookies](http://expressjs.com/en/4x/api.html#req.cookies) object.\n *\n * #### Example\n *\n * ```typescript\n * @Controller('/')\n * class MyCtrl {\n *    @Post('/')\n *    create(@Cookies() cookies: any) {\n *       console.log('Entire cookies', cookies);\n *    }\n *\n *    @Post('/')\n *    create(@Cookies('id') id: string) {\n *       console.log('ID', id);\n *    }\n *\n *    @Post('/')\n *    create(@Cookies('user') user: IUser) {\n *       console.log('user', user);\n *    }\n * }\n * ```\n * > For more information on deserialization see [converters](/docs/converters.md) page.\n *\n * @param expression The path of the property to get.\n * @param useType The type of the class that to be used to deserialize the data.\n * @decorator\n * @operation\n * @input\n */\nexport function CookiesParams(expression: string | any, useType: any): ParameterDecorator;\nexport function CookiesParams(): ParameterDecorator;\nexport function CookiesParams(expression: string | any): ParameterDecorator;\nexport function CookiesParams(options: ParamOptions<any>): ParameterDecorator;\nexport function CookiesParams(...args: any[]): ParameterDecorator {\n  const {expression, useType, useConverter = false, useValidation = false} = mapParamsOptions(args);\n\n  return UseParam({\n    paramType: ParamTypes.COOKIES,\n    expression,\n    useType,\n    useConverter,\n    useValidation\n  });\n}\n\n/**\n * Cookies or CookiesParams return the value from [request.cookies](http://expressjs.com/en/4x/api.html#req.cookies) object.\n *\n * #### Example\n *\n * ```typescript\n * @Controller('/')\n * class MyCtrl {\n *    @Post('/')\n *    create(@Cookies() body: any) {\n *       console.log('Entire body', body);\n *    }\n *\n *    @Post('/')\n *    create(@Cookies('id') id: string) {\n *       console.log('ID', id);\n *    }\n *\n *    @Post('/')\n *    create(@Cookies('user') user: User) { // with deserialization\n *       console.log('user', user);\n *    }\n *\n *    @Post('/')\n *    create(@Cookies('users', User) users: User[]) { // with deserialization\n *       console.log('users', users);\n *    }\n * }\n * ```\n * > For more information on deserialization see [converters](/docs/converters.md) page.\n *\n * @param expression The path of the property to get.\n * @param useType The type of the class that to be used to deserialize the data.\n * @decorator\n * @aliasof CookiesParams\n * @operation\n * @input\n */\nexport function Cookies(expression: string, useType: Type<any>): ParameterDecorator;\nexport function Cookies(expression: string): ParameterDecorator;\nexport function Cookies(useType: Type<any>): ParameterDecorator;\nexport function Cookies(options: Partial<ParamOptions>): ParameterDecorator;\nexport function Cookies(): ParameterDecorator;\nexport function Cookies(...args: any[]): ParameterDecorator {\n  // @ts-ignore\n  return CookiesParams(...args);\n}\n"]}

package/lib/esm/decorators/headerParams.js

@@ -0,0 +1,14 @@
+import { ParamTypes } from "../domain/ParamTypes.js";
+import { UseParam } from "./useParam.js";
+import { mapParamsOptions } from "../utils/mapParamsOptions.js";
+export function HeaderParams(...args) {
+    const { expression, useType, useConverter = false, useValidation = false } = mapParamsOptions(args);
+    return UseParam({
+        paramType: ParamTypes.HEADER,
+        expression,
+        useType,
+        useConverter,
+        useValidation
+    });
+}
+//# sourceMappingURL=headerParams.js.map

package/lib/esm/decorators/headerParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerParams.js","sourceRoot":"","sources":["../../../src/decorators/headerParams.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AACpC,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAkC3D,MAAM,UAAU,YAAY,CAAC,GAAG,IAAW;IACzC,MAAM,EAAC,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK,EAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAElG,OAAO,QAAQ,CAAC;QACd,SAAS,EAAE,UAAU,CAAC,MAAM;QAC5B,UAAU;QACV,OAAO;QACP,YAAY;QACZ,aAAa;KACd,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {Type} from \"@tsed/core\";\nimport {ParamTypes} from \"../domain/ParamTypes\";\nimport {UseParam} from \"./useParam\";\nimport {mapParamsOptions} from \"../utils/mapParamsOptions\";\nimport {ParamOptions} from \"../domain/ParamOptions\";\n\n/**\n * HeaderParams return the value from [`request.get()`](http://expressjs.com/en/4x/api.html#req.get) method.\n *\n * #### Example\n *\n * ```typescript\n * @Controller('/')\n * class MyCtrl {\n *    @Get('/')\n *    get(@HeaderParams() body: any) {\n *       console.log('Entire body', body);\n *    }\n *\n *    @Get('/')\n *    get(@HeaderParams('x-token') token: string) {\n *       console.log('token', id);\n *    }\n * }\n * ```\n *\n * @param expression The path of the property to get.\n * @param useType\n * @decorator\n * @operation\n * @input\n */\nexport function HeaderParams(expression: string, useType: Type<any>): ParameterDecorator;\nexport function HeaderParams(expression: string): ParameterDecorator;\nexport function HeaderParams(useType: Type<any>): ParameterDecorator;\nexport function HeaderParams(options: Partial<ParamOptions>): ParameterDecorator;\nexport function HeaderParams(): ParameterDecorator;\nexport function HeaderParams(...args: any[]): ParameterDecorator {\n  const {expression, useType, useConverter = false, useValidation = false} = mapParamsOptions(args);\n\n  return UseParam({\n    paramType: ParamTypes.HEADER,\n    expression,\n    useType,\n    useConverter,\n    useValidation\n  });\n}\n"]}

package/lib/esm/decorators/locals.js

@@ -0,0 +1,14 @@
+import { ParamTypes } from "../domain/ParamTypes.js";
+import { mapParamsOptions } from "../utils/mapParamsOptions.js";
+import { UseParam } from "./useParam.js";
+export function Locals(...args) {
+    const { expression, useType, useConverter = false, useValidation = false } = mapParamsOptions(args);
+    return UseParam({
+        paramType: ParamTypes.LOCALS,
+        expression,
+        useType,
+        useConverter,
+        useValidation
+    });
+}
+//# sourceMappingURL=locals.js.map

package/lib/esm/decorators/locals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locals.js","sourceRoot":"","sources":["../../../src/decorators/locals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AA4CpC,MAAM,UAAU,MAAM,CAAC,GAAG,IAAW;IACnC,MAAM,EAAC,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK,EAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAElG,OAAO,QAAQ,CAAC;QACd,SAAS,EAAE,UAAU,CAAC,MAAM;QAC5B,UAAU;QACV,OAAO;QACP,YAAY;QACZ,aAAa;KACd,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {ParamTypes} from \"../domain/ParamTypes\";\nimport {mapParamsOptions} from \"../utils/mapParamsOptions\";\nimport {UseParam} from \"./useParam\";\n\n/**\n * Locals return the value from [response.locals](http://expressjs.com/en/4x/api.html#res.locals) object.\n *\n * ::: tip\n * Locals are generally used by express and third-party like templating engine to render a page/template.\n * See [Templating](http://tsed.io/tutorials/templating.html) section for more details.\n * :::\n *\n * #### Example\n *\n * ```typescript\n *  * @Middleware()\n * class LocalsMiddleware {\n *   use(@Locals() locals: any) {\n *      // set some on locals\n *      locals.user = \"user\"\n *   }\n * }\n *\n * @Controller('/')\n * @UseBefore(LocalsMiddleware)\n * class MyCtrl {\n *    @Get('/')\n *    @View('home.ejs') // will use locals and returned data to render the page\n *    get(@Locals('user') user: any) {\n *       console.log('user', user);\n *\n *       return {\n *         description: 'Hello world'\n *       }\n *    }\n * }\n * ```\n *\n * @param expression The path of the property to get.\n * @decorator\n * @operation\n * @input\n * @response\n */\nexport function Locals(expression: string): ParameterDecorator;\nexport function Locals(): ParameterDecorator;\nexport function Locals(...args: any[]): ParameterDecorator {\n  const {expression, useType, useConverter = false, useValidation = false} = mapParamsOptions(args);\n\n  return UseParam({\n    paramType: ParamTypes.LOCALS,\n    expression,\n    useType,\n    useConverter,\n    useValidation\n  });\n}\n"]}

package/lib/esm/decorators/paramFn.js

@@ -0,0 +1,13 @@
+import { JsonEntityFn } from "@tsed/schema";
+/**
+ * Get the Param metadata. Use this decorator to compose your own decorator.
+ *
+ * @param fn
+ * @decorator
+ * @operation
+ * @input
+ */
+export function ParamFn(fn) {
+    return JsonEntityFn(fn);
+}
+//# sourceMappingURL=paramFn.js.map

package/lib/esm/decorators/paramFn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paramFn.js","sourceRoot":"","sources":["../../../src/decorators/paramFn.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAqB,MAAM,cAAc,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,EAAwE;IAC9F,OAAO,YAAY,CAAqB,EAAE,CAAC,CAAC;AAC9C,CAAC","sourcesContent":["import {DecoratorParameters} from \"@tsed/core\";\nimport {JsonEntityFn, JsonParameterStore} from \"@tsed/schema\";\n\n/**\n * Get the Param metadata. Use this decorator to compose your own decorator.\n *\n * @param fn\n * @decorator\n * @operation\n * @input\n */\nexport function ParamFn(fn: (param: JsonParameterStore, parameters: DecoratorParameters) => void): ParameterDecorator {\n  return JsonEntityFn<JsonParameterStore>(fn);\n}\n"]}

package/lib/esm/decorators/pathParams.js

@@ -0,0 +1,49 @@
+import { ParamTypes } from "../domain/ParamTypes.js";
+import { mapParamsOptions } from "../utils/mapParamsOptions.js";
+import { UseParam } from "./useParam.js";
+export function PathParams(...args) {
+    const { expression, useType, useConverter = true, useValidation = true } = mapParamsOptions(args);
+    return UseParam({
+        paramType: ParamTypes.PATH,
+        expression,
+        useType,
+        useConverter,
+        useValidation
+    });
+}
+/**
+ * RawPathParams return the raw value from [request.params](http://expressjs.com/en/4x/api.html#req.params) object.
+ *
+ * Any validation and transformation are performed on the value. Use [pipes](/docs/pipes.html) to validate and/or transform the value.
+ *
+ * #### Example
+ *
+ * ```typescript
+ * @Controller('/')
+ * class MyCtrl {
+ *    @Get('/')
+ *    get(@RawPathParams() params: string) {
+ *       console.log('Entire params', params);
+ *    }
+ *
+ *    @Get('/')
+ *    get(@RawPathParams('id') id: string) {
+ *       console.log('ID', id);
+ *    }
+ * }
+ * ```
+ * > For more information on deserialization see [converters](/docs/converters.md) page.
+ *
+ * @param expression The path of the property to get.
+ * @decorator
+ * @operation
+ * @input
+ */
+export function RawPathParams(expression) {
+    return UseParam({
+        paramType: ParamTypes.PATH,
+        dataPath: "$ctx.request.params",
+        expression
+    });
+}
+//# sourceMappingURL=pathParams.js.map

package/lib/esm/decorators/pathParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathParams.js","sourceRoot":"","sources":["../../../src/decorators/pathParams.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAuCpC,MAAM,UAAU,UAAU,CAAC,GAAG,IAAW;IACvC,MAAM,EAAC,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,EAAE,aAAa,GAAG,IAAI,EAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEhG,OAAO,QAAQ,CAAC;QACd,SAAS,EAAE,UAAU,CAAC,IAAI;QAC1B,UAAU;QACV,OAAO;QACP,YAAY;QACZ,aAAa;KACd,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,QAAQ,CAAC;QACd,SAAS,EAAE,UAAU,CAAC,IAAI;QAC1B,QAAQ,EAAE,qBAAqB;QAC/B,UAAU;KACX,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {Type} from \"@tsed/core\";\nimport {ParamOptions} from \"../domain/ParamOptions\";\nimport {ParamTypes} from \"../domain/ParamTypes\";\nimport {mapParamsOptions} from \"../utils/mapParamsOptions\";\nimport {UseParam} from \"./useParam\";\n\n/**\n * PathParams return the value from [request.params](http://expressjs.com/en/4x/api.html#req.params) object.\n *\n * #### Example\n *\n * ```typescript\n * @Controller('/')\n * class MyCtrl {\n *    @Get('/')\n *    get(@PathParams() params: any) {\n *       console.log('Entire params', params);\n *    }\n *\n *    @Get('/')\n *    get(@PathParams('id') id: string) {\n *       console.log('ID', id);\n *    }\n *\n *    @Get('/')\n *    get(@PathParams({expression: 'id', useType: () => new MyCustomModel() }) id: string) {\n *       console.log('ID', id);\n *    }\n * }\n * ```\n * > For more information on deserialization see [converters](/docs/converters.md) page.\n *\n * @param expression The path of the property to get.\n * @param useType The type of the class that to be used to deserialize the data.\n * @decorator\n * @operation\n * @input\n */\nexport function PathParams(expression: string, useType: Type<any>): ParameterDecorator;\nexport function PathParams(expression: string): ParameterDecorator;\nexport function PathParams(useType: Type<any>): ParameterDecorator;\nexport function PathParams(options: Partial<ParamOptions>): ParameterDecorator;\nexport function PathParams(): ParameterDecorator;\nexport function PathParams(...args: any[]): ParameterDecorator {\n  const {expression, useType, useConverter = true, useValidation = true} = mapParamsOptions(args);\n\n  return UseParam({\n    paramType: ParamTypes.PATH,\n    expression,\n    useType,\n    useConverter,\n    useValidation\n  });\n}\n\n/**\n * RawPathParams return the raw value from [request.params](http://expressjs.com/en/4x/api.html#req.params) object.\n *\n * Any validation and transformation are performed on the value. Use [pipes](/docs/pipes.html) to validate and/or transform the value.\n *\n * #### Example\n *\n * ```typescript\n * @Controller('/')\n * class MyCtrl {\n *    @Get('/')\n *    get(@RawPathParams() params: string) {\n *       console.log('Entire params', params);\n *    }\n *\n *    @Get('/')\n *    get(@RawPathParams('id') id: string) {\n *       console.log('ID', id);\n *    }\n * }\n * ```\n * > For more information on deserialization see [converters](/docs/converters.md) page.\n *\n * @param expression The path of the property to get.\n * @decorator\n * @operation\n * @input\n */\nexport function RawPathParams(expression: string) {\n  return UseParam({\n    paramType: ParamTypes.PATH,\n    dataPath: \"$ctx.request.params\",\n    expression\n  });\n}\n"]}

package/lib/esm/decorators/queryParams.js

@@ -0,0 +1,49 @@
+import { ParamTypes } from "../domain/ParamTypes.js";
+import { mapParamsOptions } from "../utils/mapParamsOptions.js";
+import { UseParam } from "./useParam.js";
+export function QueryParams(...args) {
+    const { expression, useType, useConverter = true, useValidation = true } = mapParamsOptions(args);
+    return UseParam({
+        paramType: ParamTypes.QUERY,
+        expression,
+        useType,
+        useConverter,
+        useValidation
+    });
+}
+/**
+ * RawQueryParams return the value from [request.query](http://expressjs.com/en/4x/api.html#req.query) object.
+ *
+ * Any validation and transformation are performed on the value. Use [pipes](/docs/pipes.html) to validate and/or transform the value.
+ *
+ * #### Example
+ *
+ * ```typescript
+ * @Controller('/')
+ * class MyCtrl {
+ *    @Get('/')
+ *    get(@RawPathParams() params: any) {
+ *       console.log('Entire params', params);
+ *    }
+ *
+ *    @Get('/')
+ *    get(@RawPathParams('id') id: string) {
+ *       console.log('ID', id);
+ *    }
+ * }
+ * ```
+ * > For more information on deserialization see [converters](/docs/converters.md) page.
+ *
+ * @param expression The path of the property to get.
+ * @decorator
+ * @operation
+ * @input
+ */
+export function RawQueryParams(expression) {
+    return QueryParams({
+        expression,
+        useConverters: false,
+        useValidation: false
+    });
+}
+//# sourceMappingURL=queryParams.js.map

package/lib/esm/decorators/queryParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryParams.js","sourceRoot":"","sources":["../../../src/decorators/queryParams.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AA4CpC,MAAM,UAAU,WAAW,CAAC,GAAG,IAAW;IACxC,MAAM,EAAC,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,EAAE,aAAa,GAAG,IAAI,EAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEhG,OAAO,QAAQ,CAAC;QACd,SAAS,EAAE,UAAU,CAAC,KAAK;QAC3B,UAAU;QACV,OAAO;QACP,YAAY;QACZ,aAAa;KACd,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,OAAO,WAAW,CAAC;QACjB,UAAU;QACV,aAAa,EAAE,KAAK;QACpB,aAAa,EAAE,KAAK;KACrB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {Type} from \"@tsed/core\";\nimport {ParamOptions} from \"../domain/ParamOptions\";\nimport {ParamTypes} from \"../domain/ParamTypes\";\nimport {mapParamsOptions} from \"../utils/mapParamsOptions\";\nimport {UseParam} from \"./useParam\";\n\n/**\n * QueryParams return the value from [request.query](http://expressjs.com/en/4x/api.html#req.query) object.\n *\n * #### Example\n *\n * ```typescript\n * @Controller('/')\n * class MyCtrl {\n *    @Get('/')\n *    get(@QueryParams() query: any) {\n *       console.log('Entire query', query);\n *    }\n *\n *    @Get('/')\n *    get(@QueryParams('id') id: string) {\n *       console.log('ID', id);\n *    }\n *\n *    @Get('/')\n *    get(@QueryParams('user') user: User) { // with deserialization\n *       console.log('user', user);\n *    }\n *\n *    @Get('/')\n *    get(@QueryParams('users', User) users: User[]) { // with deserialization\n *       console.log('users', users);\n *    }\n * }\n * ```\n * > For more information on deserialization see [converters](/docs/converters.md) page.\n *\n * @param expression The path of the property to get.\n * @param useType The type of the class that to be used to deserialize the data.\n * @decorator\n * @operation\n * @input\n */\nexport function QueryParams(expression: string, useType: Type<any>): ParameterDecorator;\nexport function QueryParams(expression: string): ParameterDecorator;\nexport function QueryParams(useType: Type<any>): ParameterDecorator;\nexport function QueryParams(options: Partial<ParamOptions>): ParameterDecorator;\nexport function QueryParams(): ParameterDecorator;\nexport function QueryParams(...args: any[]): ParameterDecorator {\n  const {expression, useType, useConverter = true, useValidation = true} = mapParamsOptions(args);\n\n  return UseParam({\n    paramType: ParamTypes.QUERY,\n    expression,\n    useType,\n    useConverter,\n    useValidation\n  });\n}\n\n/**\n * RawQueryParams return the value from [request.query](http://expressjs.com/en/4x/api.html#req.query) object.\n *\n * Any validation and transformation are performed on the value. Use [pipes](/docs/pipes.html) to validate and/or transform the value.\n *\n * #### Example\n *\n * ```typescript\n * @Controller('/')\n * class MyCtrl {\n *    @Get('/')\n *    get(@RawPathParams() params: any) {\n *       console.log('Entire params', params);\n *    }\n *\n *    @Get('/')\n *    get(@RawPathParams('id') id: string) {\n *       console.log('ID', id);\n *    }\n * }\n * ```\n * > For more information on deserialization see [converters](/docs/converters.md) page.\n *\n * @param expression The path of the property to get.\n * @decorator\n * @operation\n * @input\n */\nexport function RawQueryParams(expression: string) {\n  return QueryParams({\n    expression,\n    useConverters: false,\n    useValidation: false\n  });\n}\n"]}

package/lib/esm/decorators/session.js

@@ -0,0 +1,14 @@
+import { ParamTypes } from "../domain/ParamTypes.js";
+import { mapParamsOptions } from "../utils/mapParamsOptions.js";
+import { UseParam } from "./useParam.js";
+export function Session(...args) {
+    const { expression, useType, useConverter = false, useValidation = false } = mapParamsOptions(args);
+    return UseParam({
+        paramType: ParamTypes.SESSION,
+        expression,
+        useType,
+        useConverter,
+        useValidation
+    });
+}
+//# sourceMappingURL=session.js.map

package/lib/esm/decorators/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/decorators/session.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAqCpC,MAAM,UAAU,OAAO,CAAC,GAAG,IAAW;IACpC,MAAM,EAAC,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK,EAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAElG,OAAO,QAAQ,CAAC;QACd,SAAS,EAAE,UAAU,CAAC,OAAO;QAC7B,UAAU;QACV,OAAO;QACP,YAAY;QACZ,aAAa;KACd,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {ParamOptions} from \"../domain/ParamOptions\";\nimport {ParamTypes} from \"../domain/ParamTypes\";\nimport {mapParamsOptions} from \"../utils/mapParamsOptions\";\nimport {UseParam} from \"./useParam\";\n\n/**\n * Session return the value from [request.session](http://expressjs.com/en/4x/api.html#req.session) object.\n *\n * #### Example\n *\n * ```typescript\n * @Controller('/')\n * class MyCtrl {\n *    @Post('/')\n *    create(@Session() session: Express.Session) {\n *       console.log('Entire session', session);\n *    }\n *\n *    @Post('/')\n *    create(@Session('id') id: string) {\n *       console.log('ID', id);\n *    }\n *\n *    @Post('/') // Example to deserialize use from session\n *    create(@Session({expression: 'user', useConverter: true}) user: User) {\n *       console.log('user', user);\n *       console.log('instanceOf user', user instanceof User);\n *    }\n * }\n * ```\n * > For more information on deserialization see [converters](/docs/converters.md) page.\n *\n * @param expression The path of the property to get.\n * @decorator\n * @operation\n * @input\n */\nexport function Session(expression: string): ParameterDecorator;\nexport function Session(options: Partial<ParamOptions>): ParameterDecorator;\nexport function Session(): ParameterDecorator;\nexport function Session(...args: any[]): ParameterDecorator {\n  const {expression, useType, useConverter = false, useValidation = false} = mapParamsOptions(args);\n\n  return UseParam({\n    paramType: ParamTypes.SESSION,\n    expression,\n    useType,\n    useConverter,\n    useValidation\n  });\n}\n"]}

package/lib/esm/decorators/useDeserialization.js

@@ -0,0 +1,14 @@
+import { DeserializerPipe } from "../pipes/DeserializerPipe.js";
+import { UsePipe } from "./usePipe.js";
+/**
+ * Use JsonMapper to deserialize the data.
+ *
+ * @decorator
+ * @operation
+ * @input
+ * @pipe
+ */
+export function UseDeserialization(options = {}) {
+    return UsePipe(DeserializerPipe, options);
+}
+//# sourceMappingURL=useDeserialization.js.map

package/lib/esm/decorators/useDeserialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeserialization.js","sourceRoot":"","sources":["../../../src/decorators/useDeserialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAe,EAAE;IAClD,OAAO,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC","sourcesContent":["import {DeserializerPipe} from \"../pipes/DeserializerPipe\";\nimport {UsePipe} from \"./usePipe\";\n\n/**\n * Use JsonMapper to deserialize the data.\n *\n * @decorator\n * @operation\n * @input\n * @pipe\n */\nexport function UseDeserialization(options: any = {}) {\n  return UsePipe(DeserializerPipe, options);\n}\n"]}

package/lib/esm/decorators/useParam.js

@@ -0,0 +1,46 @@
+import { useDecorators } from "@tsed/core";
+import { Any } from "@tsed/schema";
+import { ParamTypes } from "../domain/ParamTypes.js";
+import { ParamFn } from "./paramFn.js";
+import { UseDeserialization } from "./useDeserialization.js";
+import { UseParamType } from "./useParamType.js";
+import { UseType } from "./useType.js";
+import { UseValidation } from "./useValidation.js";
+/**
+ * @ignore
+ * @param options
+ */
+function mapPipes(options) {
+    const { paramType, useType, expression, useValidation, useConverter, ...props } = options;
+    return [
+        useType
+            ? UseType(useType)
+            : ParamFn((entity, parameters) => {
+                if (entity.isCollection && entity.type === Object && paramType !== ParamTypes.FILES) {
+                    Any()(...parameters);
+                }
+            }),
+        useValidation && UseValidation(),
+        useConverter && UseDeserialization(props)
+    ];
+}
+/**
+ * Register a new param. It use the paramType to extract value and give it to the next pipe.
+ *
+ * Given options allow to enable or disable following pipes:
+ *
+ * - useType: Add extra type for the json mapper,
+ * - expression: Get property from the returned value by the previous pipe.
+ * - useValidation: Apply validation from the returned value by the previous pipe.
+ * - useConverter: Apply json mapper from the returned value by the previous pipe.
+ *
+ * @param options
+ * @decorator
+ * @operation
+ * @input
+ * @pipe
+ */
+export function UseParam(options) {
+    return useDecorators(UseParamType(options), ...mapPipes(options));
+}
+//# sourceMappingURL=useParam.js.map

package/lib/esm/decorators/useParam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useParam.js","sourceRoot":"","sources":["../../../src/decorators/useParam.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,aAAa,EAAC,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAC,GAAG,EAAC,MAAM,cAAc,CAAC;AAEjC,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAE9C;;;GAGG;AACH,SAAS,QAAQ,CAAC,OAA8B;IAC9C,MAAM,EAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,KAAK,EAAC,GAAG,OAAO,CAAC;IAExF,OAAO;QACL,OAAO;YACL,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;YAClB,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;gBAC7B,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,KAAK,UAAU,CAAC,KAAK,EAAE;oBACnF,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;iBACtB;YACH,CAAC,CAAC;QACN,aAAa,IAAI,aAAa,EAAE;QAChC,YAAY,IAAI,kBAAkB,CAAC,KAAK,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ,CAAC,OAA8B;IACrD,OAAO,aAAa,CAAC,YAAY,CAAC,OAAc,CAAC,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAuB,CAAC;AACjG,CAAC","sourcesContent":["import {isBuffer, isString, useDecorators} from \"@tsed/core\";\nimport {Any} from \"@tsed/schema\";\nimport {ParamOptions} from \"../domain/ParamOptions\";\nimport {ParamTypes} from \"../domain/ParamTypes\";\nimport {ParamFn} from \"./paramFn\";\nimport {UseDeserialization} from \"./useDeserialization\";\nimport {UseParamType} from \"./useParamType\";\nimport {UseType} from \"./useType\";\nimport {UseValidation} from \"./useValidation\";\n\n/**\n * @ignore\n * @param options\n */\nfunction mapPipes(options: Partial<ParamOptions>) {\n  const {paramType, useType, expression, useValidation, useConverter, ...props} = options;\n\n  return [\n    useType\n      ? UseType(useType)\n      : ParamFn((entity, parameters) => {\n          if (entity.isCollection && entity.type === Object && paramType !== ParamTypes.FILES) {\n            Any()(...parameters);\n          }\n        }),\n    useValidation && UseValidation(),\n    useConverter && UseDeserialization(props)\n  ];\n}\n\n/**\n * Register a new param. It use the paramType to extract value and give it to the next pipe.\n *\n * Given options allow to enable or disable following pipes:\n *\n * - useType: Add extra type for the json mapper,\n * - expression: Get property from the returned value by the previous pipe.\n * - useValidation: Apply validation from the returned value by the previous pipe.\n * - useConverter: Apply json mapper from the returned value by the previous pipe.\n *\n * @param options\n * @decorator\n * @operation\n * @input\n * @pipe\n */\nexport function UseParam(options: Partial<ParamOptions>): ParameterDecorator {\n  return useDecorators(UseParamType(options as any), ...mapPipes(options)) as ParameterDecorator;\n}\n"]}

package/lib/esm/decorators/useParamExpression.js

@@ -0,0 +1,16 @@
+import { ParamFn } from "./paramFn.js";
+/**
+ * Get data from a path inside the given object
+ *
+ * @param expression
+ * @decorator
+ * @operation
+ * @input
+ * @pipe
+ */
+export function UseParamExpression(expression) {
+    return ParamFn((param) => {
+        param.expression = expression || "";
+    });
+}
+//# sourceMappingURL=useParamExpression.js.map

package/lib/esm/decorators/useParamExpression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useParamExpression.js","sourceRoot":"","sources":["../../../src/decorators/useParamExpression.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAmB;IACpD,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,KAAK,CAAC,UAAU,GAAG,UAAU,IAAI,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {ParamFn} from \"./paramFn\";\n\n/**\n * Get data from a path inside the given object\n *\n * @param expression\n * @decorator\n * @operation\n * @input\n * @pipe\n */\nexport function UseParamExpression(expression?: string) {\n  return ParamFn((param) => {\n    param.expression = expression || \"\";\n  });\n}\n"]}

package/lib/esm/decorators/useParamType.js

@@ -0,0 +1,28 @@
+import { isBuffer, useDecorators } from "@tsed/core";
+import { isParameterType, Name } from "@tsed/schema";
+import { ParamFn } from "./paramFn.js";
+import { UseParamExpression } from "./useParamExpression.js";
+import { PARAM_TYPES_DATA_PATH, ParamTypes } from "../domain/ParamTypes.js";
+/**
+ * Get the object from request (like body, params, query, etc...).
+ *
+ * @decorator
+ * @operation
+ * @input
+ * @pipe
+ */
+export function UseParamType(options) {
+    return useDecorators(ParamFn((param) => {
+        var _a;
+        if (isParameterType(options.paramType)) {
+            param.parameter.in(options.paramType);
+        }
+        param.paramType = options.paramType;
+        if (isBuffer(param.type) || isBuffer(options.useType) || options.paramType === ParamTypes.RAW_BODY) {
+            param.paramType = ParamTypes.RAW_BODY;
+            (_a = param.parent.operation) === null || _a === void 0 ? void 0 : _a.consumes(["*/*"]);
+        }
+        param.dataPath = options.dataPath || PARAM_TYPES_DATA_PATH[param.paramType] || "$ctx";
+    }), options.expression && UseParamExpression(options.expression), options.expression && Name(options.expression));
+}
+//# sourceMappingURL=useParamType.js.map

package/lib/esm/decorators/useParamType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useParamType.js","sourceRoot":"","sources":["../../../src/decorators/useParamType.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AACnD,OAAO,EAAC,eAAe,EAAE,IAAI,EAAC,MAAM,cAAc,CAAC;AACnD,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,qBAAqB,EAAE,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,OAAqB;IAChD,OAAO,aAAa,CAClB,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;;QAChB,IAAI,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;YACtC,KAAK,CAAC,SAAU,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;SACxC;QAED,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QAEpC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,SAAS,KAAK,UAAU,CAAC,QAAQ,EAAE;YAClG,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC;YACtC,MAAA,KAAK,CAAC,MAAM,CAAC,SAAS,0CAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;SAC3C;QAED,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC;IACxF,CAAC,CAAC,EACF,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,EAC5D,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAC/C,CAAC;AACJ,CAAC","sourcesContent":["import {isBuffer, useDecorators} from \"@tsed/core\";\nimport {isParameterType, Name} from \"@tsed/schema\";\nimport {ParamFn} from \"./paramFn\";\nimport {ParamOptions} from \"../domain/ParamOptions\";\nimport {UseParamExpression} from \"./useParamExpression\";\nimport {PARAM_TYPES_DATA_PATH, ParamTypes} from \"../domain/ParamTypes\";\n\n/**\n * Get the object from request (like body, params, query, etc...).\n *\n * @decorator\n * @operation\n * @input\n * @pipe\n */\nexport function UseParamType(options: ParamOptions) {\n  return useDecorators(\n    ParamFn((param) => {\n      if (isParameterType(options.paramType)) {\n        param.parameter!.in(options.paramType);\n      }\n\n      param.paramType = options.paramType;\n\n      if (isBuffer(param.type) || isBuffer(options.useType) || options.paramType === ParamTypes.RAW_BODY) {\n        param.paramType = ParamTypes.RAW_BODY;\n        param.parent.operation?.consumes([\"*/*\"]);\n      }\n\n      param.dataPath = options.dataPath || PARAM_TYPES_DATA_PATH[param.paramType] || \"$ctx\";\n    }),\n    options.expression && UseParamExpression(options.expression),\n    options.expression && Name(options.expression)\n  );\n}\n"]}

package/lib/esm/decorators/usePipe.js

@@ -0,0 +1,18 @@
+import { ParamFn } from "./paramFn.js";
+/**
+ * Register a Pipe to be used with the current decorated param.
+ *
+ * @param token
+ * @param options
+ * @decorator
+ * @operation
+ * @input
+ * @pipe
+ */
+export function UsePipe(token, options = {}) {
+    return ParamFn((param) => {
+        param.store.set(token, options);
+        param.pipes.push(token);
+    });
+}
+//# sourceMappingURL=usePipe.js.map

package/lib/esm/decorators/usePipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePipe.js","sourceRoot":"","sources":["../../../src/decorators/usePipe.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAC,KAAwB,EAAE,UAAe,EAAE;IACjE,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {Type} from \"@tsed/core\";\nimport {PipeMethods} from \"@tsed/schema\";\nimport {ParamFn} from \"./paramFn\";\n\n/**\n * Register a Pipe to be used with the current decorated param.\n *\n * @param token\n * @param options\n * @decorator\n * @operation\n * @input\n * @pipe\n */\nexport function UsePipe(token: Type<PipeMethods>, options: any = {}) {\n  return ParamFn((param) => {\n    param.store.set(token, options);\n    param.pipes.push(token);\n  });\n}\n"]}

package/lib/esm/decorators/useType.js

@@ -0,0 +1,16 @@
+import { CollectionOf } from "@tsed/schema";
+/**
+ * Set the type of the item colllection.
+ *
+ * Prefer @@CollectionOf@@ usage.
+ *
+ * @param type
+ * @decorator
+ * @operation
+ * @input
+ * @alias CollectionOf
+ */
+export function UseType(type) {
+    return CollectionOf(type);
+}
+//# sourceMappingURL=useType.js.map

package/lib/esm/decorators/useType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useType.js","sourceRoot":"","sources":["../../../src/decorators/useType.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,IAAqB;IAC3C,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["import {Type} from \"@tsed/core\";\nimport {CollectionOf} from \"@tsed/schema\";\n\n/**\n * Set the type of the item colllection.\n *\n * Prefer @@CollectionOf@@ usage.\n *\n * @param type\n * @decorator\n * @operation\n * @input\n * @alias CollectionOf\n */\nexport function UseType(type: any | Type<any>) {\n  return CollectionOf(type);\n}\n"]}

package/lib/esm/decorators/useValidation.js

@@ -0,0 +1,18 @@
+import { ValidationPipe } from "../pipes/ValidationPipe.js";
+import { ParamFn } from "./paramFn.js";
+/**
+ * Enable validation on the decoratored parameter.
+ *
+ * @decorator
+ * @operation
+ * @input
+ * @pipe
+ */
+export function UseValidation() {
+    return ParamFn((param) => {
+        if (param.type || param.collectionType) {
+            param.pipes.push(ValidationPipe);
+        }
+    });
+}
+//# sourceMappingURL=useValidation.js.map

package/lib/esm/decorators/useValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useValidation.js","sourceRoot":"","sources":["../../../src/decorators/useValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,cAAc,EAAE;YACtC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;SAClC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {ValidationPipe} from \"../pipes/ValidationPipe\";\nimport {ParamFn} from \"./paramFn\";\n\n/**\n * Enable validation on the decoratored parameter.\n *\n * @decorator\n * @operation\n * @input\n * @pipe\n */\nexport function UseValidation() {\n  return ParamFn((param) => {\n    if (param.type || param.collectionType) {\n      param.pipes.push(ValidationPipe);\n    }\n  });\n}\n"]}

package/lib/esm/domain/ParamMetadata.js

@@ -0,0 +1,2 @@
+export { ParamMetadata } from "@tsed/schema";
+//# 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,aAAa,EAAC,MAAM,cAAc,CAAC","sourcesContent":["export {ParamMetadata} from \"@tsed/schema\";\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,37 @@
+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 = {}));
+export const PARAM_TYPES_DATA_PATH = {
+    [ParamTypes.HEADER]: "$ctx.request.headers",
+    [ParamTypes.RAW_BODY]: "$ctx.request.rawBody",
+    [ParamTypes.BODY]: "$ctx.request.body",
+    [ParamTypes.QUERY]: "$ctx.request.query",
+    [ParamTypes.PATH]: "$ctx.request.params",
+    [ParamTypes.COOKIES]: "$ctx.request.cookies",
+    [ParamTypes.SESSION]: "$ctx.request.session",
+    [ParamTypes.LOCALS]: "$ctx.response.locals"
+};
+//# 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;AAED,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,sBAAsB;IAC3C,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,sBAAsB;IAC7C,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,mBAAmB;IACtC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,oBAAoB;IACxC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,qBAAqB;IACxC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,sBAAsB;IAC5C,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,sBAAsB;IAC5C,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,sBAAsB;CAC5C,CAAC","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\nexport const PARAM_TYPES_DATA_PATH: Record<string, string> = {\n  [ParamTypes.HEADER]: \"$ctx.request.headers\",\n  [ParamTypes.RAW_BODY]: \"$ctx.request.rawBody\",\n  [ParamTypes.BODY]: \"$ctx.request.body\",\n  [ParamTypes.QUERY]: \"$ctx.request.query\",\n  [ParamTypes.PATH]: \"$ctx.request.params\",\n  [ParamTypes.COOKIES]: \"$ctx.request.cookies\",\n  [ParamTypes.SESSION]: \"$ctx.request.session\",\n  [ParamTypes.LOCALS]: \"$ctx.response.locals\"\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.js";
+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,QAA4B,EAAE,SAAc,EAAE;QACxD,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 {JsonParameterStore} from \"@tsed/schema\";\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: JsonParameterStore, 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.js";
+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;AAClC,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAGlD,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAA5D;;QACS,SAAI,GAAW,2BAA2B,CAAC;IAuBpD,CAAC;IArBC,MAAM,CAAC,IAAI,CAAC,QAA4B;QACtC,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 {ValidationError} from \"./ValidationError\";\nimport {JsonParameterStore} from \"@tsed/schema\";\n\nexport class RequiredValidationError extends ValidationError {\n  public name: string = \"REQUIRED_VALIDATION_ERROR\";\n\n  static from(metadata: JsonParameterStore) {\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/exports.js

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