@nestia/core 1.1.0 → 1.1.2-dev.20230503

package/lib/decorators/PlainBody.js

@@ -1,83 +1,83 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlainBody = void 0;
-var common_1 = require("@nestjs/common");
-var raw_body_1 = __importDefault(require("raw-body"));
-/**
- * Plain body decorator.
- *
- * `PlainBody` is a decorator function getting full body text from the HTTP request.
- *
- * If you adjust the regular {@link Body} decorator function to the body parameter,
- * you can't get the full body text because the {@link Body} tries to convert the
- * body text to JSON object. Therefore, `@nestia/core` provides this `PlainBody`
- * decorator function to get the full body text.
- *
- * ```typescript
- * \@TypedRoute.Post("memo")
- * public store
- *     (
- *         \@PlainBody() body: string
- *     ): void;
- * ```
- *
- * @return Parameter decorator
- * @author Jeongho Nam - https://github.com/samchon
- */
-exports.PlainBody = (0, common_1.createParamDecorator)(function PlainBody(_data, context) {
-    return __awaiter(this, void 0, void 0, function () {
-        var request, body;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    request = context.switchToHttp().getRequest();
-                    if (!request.readable)
-                        throw new common_1.BadRequestException("Invalid body");
-                    return [4 /*yield*/, (0, raw_body_1.default)(request)];
-                case 1:
-                    body = (_a.sent()).toString("utf8").trim();
-                    return [2 /*return*/, body];
-            }
-        });
-    });
-});
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlainBody = void 0;
+var common_1 = require("@nestjs/common");
+var raw_body_1 = __importDefault(require("raw-body"));
+/**
+ * Plain body decorator.
+ *
+ * `PlainBody` is a decorator function getting full body text from the HTTP request.
+ *
+ * If you adjust the regular {@link Body} decorator function to the body parameter,
+ * you can't get the full body text because the {@link Body} tries to convert the
+ * body text to JSON object. Therefore, `@nestia/core` provides this `PlainBody`
+ * decorator function to get the full body text.
+ *
+ * ```typescript
+ * \@TypedRoute.Post("memo")
+ * public store
+ *     (
+ *         \@PlainBody() body: string
+ *     ): void;
+ * ```
+ *
+ * @return Parameter decorator
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+exports.PlainBody = (0, common_1.createParamDecorator)(function PlainBody(_data, context) {
+    return __awaiter(this, void 0, void 0, function () {
+        var request, body;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    request = context.switchToHttp().getRequest();
+                    if (!request.readable)
+                        throw new common_1.BadRequestException("Invalid body");
+                    return [4 /*yield*/, (0, raw_body_1.default)(request)];
+                case 1:
+                    body = (_a.sent()).toString("utf8").trim();
+                    return [2 /*return*/, body];
+            }
+        });
+    });
+});
 //# sourceMappingURL=PlainBody.js.map

package/lib/decorators/TypedBody.d.ts

@@ -1,16 +1,16 @@
-import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
-/**
- * Type safe body decorator.
- *
- * `TypedBody` is a decoratur function getting `application/json` typed data from
- * request body. Also, it validates the request body data type through
- * [typia](https://github.com/samchon/typia) and the validation speed is
- * maximum 15,000x times faster than `class-validator`.
- *
- * For reference, when the request body data is not following the promised type `T`,
- * `BadRequestException` error (status code: 400) would be thrown.
- *
- * @param validator Custom validator if required. Default is `typia.assert()`
- * @author Jeongho Nam - https://github.com/samchon
- */
-export declare function TypedBody<T>(validator?: IRequestBodyValidator<T>): ParameterDecorator;
+import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
+/**
+ * Type safe body decorator.
+ *
+ * `TypedBody` is a decoratur function getting `application/json` typed data from
+ * request body. Also, it validates the request body data type through
+ * [typia](https://github.com/samchon/typia) and the validation speed is
+ * maximum 15,000x times faster than `class-validator`.
+ *
+ * For reference, when the request body data is not following the promised type `T`,
+ * `BadRequestException` error (status code: 400) would be thrown.
+ *
+ * @param validator Custom validator if required. Default is `typia.assert()`
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare function TypedBody<T>(validator?: IRequestBodyValidator<T>): ParameterDecorator;

package/lib/decorators/TypedBody.js

@@ -1,95 +1,95 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TypedBody = void 0;
-var common_1 = require("@nestjs/common");
-var raw_body_1 = __importDefault(require("raw-body"));
-var typia_1 = require("typia");
-var validate_request_body_1 = require("./internal/validate_request_body");
-/**
- * Type safe body decorator.
- *
- * `TypedBody` is a decoratur function getting `application/json` typed data from
- * request body. Also, it validates the request body data type through
- * [typia](https://github.com/samchon/typia) and the validation speed is
- * maximum 15,000x times faster than `class-validator`.
- *
- * For reference, when the request body data is not following the promised type `T`,
- * `BadRequestException` error (status code: 400) would be thrown.
- *
- * @param validator Custom validator if required. Default is `typia.assert()`
- * @author Jeongho Nam - https://github.com/samchon
- */
-function TypedBody(validator) {
-    var checker = (0, validate_request_body_1.validate_request_body)("TypedBody")(validator);
-    return (0, common_1.createParamDecorator)(function TypedBody(_unknown, context) {
-        return __awaiter(this, void 0, void 0, function () {
-            var request, data, _a, _b, _c;
-            return __generator(this, function (_d) {
-                switch (_d.label) {
-                    case 0:
-                        request = context.switchToHttp().getRequest();
-                        if (!request.is("application/json")) {
-                            throw new common_1.BadRequestException("Request body is not the application/json.");
-                        }
-                        if (!request.body) return [3 /*break*/, 1];
-                        _a = request.body;
-                        return [3 /*break*/, 3];
-                    case 1:
-                        _c = (_b = JSON).parse;
-                        return [4 /*yield*/, (0, raw_body_1.default)(request, "utf8")];
-                    case 2:
-                        _a = _c.apply(_b, [(_d.sent()).trim()]);
-                        _d.label = 3;
-                    case 3:
-                        data = _a;
-                        checker(data);
-                        return [2 /*return*/, data];
-                }
-            });
-        });
-    })();
-}
-exports.TypedBody = TypedBody;
-Object.assign(TypedBody, typia_1.is);
-Object.assign(TypedBody, typia_1.assert);
-Object.assign(TypedBody, typia_1.validate);
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedBody = void 0;
+var common_1 = require("@nestjs/common");
+var raw_body_1 = __importDefault(require("raw-body"));
+var typia_1 = require("typia");
+var validate_request_body_1 = require("./internal/validate_request_body");
+/**
+ * Type safe body decorator.
+ *
+ * `TypedBody` is a decoratur function getting `application/json` typed data from
+ * request body. Also, it validates the request body data type through
+ * [typia](https://github.com/samchon/typia) and the validation speed is
+ * maximum 15,000x times faster than `class-validator`.
+ *
+ * For reference, when the request body data is not following the promised type `T`,
+ * `BadRequestException` error (status code: 400) would be thrown.
+ *
+ * @param validator Custom validator if required. Default is `typia.assert()`
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+function TypedBody(validator) {
+    var checker = (0, validate_request_body_1.validate_request_body)("TypedBody")(validator);
+    return (0, common_1.createParamDecorator)(function TypedBody(_unknown, context) {
+        return __awaiter(this, void 0, void 0, function () {
+            var request, data, _a, _b, _c;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        request = context.switchToHttp().getRequest();
+                        if (!request.is("application/json")) {
+                            throw new common_1.BadRequestException("Request body is not the application/json.");
+                        }
+                        if (!request.body) return [3 /*break*/, 1];
+                        _a = request.body;
+                        return [3 /*break*/, 3];
+                    case 1:
+                        _c = (_b = JSON).parse;
+                        return [4 /*yield*/, (0, raw_body_1.default)(request, "utf8")];
+                    case 2:
+                        _a = _c.apply(_b, [(_d.sent()).trim()]);
+                        _d.label = 3;
+                    case 3:
+                        data = _a;
+                        checker(data);
+                        return [2 /*return*/, data];
+                }
+            });
+        });
+    })();
+}
+exports.TypedBody = TypedBody;
+Object.assign(TypedBody, typia_1.is);
+Object.assign(TypedBody, typia_1.assert);
+Object.assign(TypedBody, typia_1.validate);
 //# sourceMappingURL=TypedBody.js.map

package/lib/decorators/TypedParam.d.ts

@@ -1,31 +1,31 @@
-/**
- * Type safe URL parameter decorator.
- *
- * `TypedParam` is a decorator function getting specific typed parameter from the
- * HTTP request URL. It's almost same with the {@link nest.Param}, but `TypedParam`
- * automatically casts parameter value to be following its type. Beside, the
- * {@link nest.Param} always parses all of the parameters as `string` type.
- *
- * Note that, if you just omit the `type` and `nullable` parameters, then
- * `TypedParam` automatically determines the `type` and `nullable` values
- * just by analyzing the parameter type. Only when you need to specify them
- * are, you want to use the `uuid` type.
- *
- * ```typescript
- * \@TypedRoute.Get("shopping/sales/:id/:no/:paused")
- * public async pause
- *     (
- *         \@TypedParam("id", "uuid"), id: string, // uuid specification
- *         \@TypedParam("no") id: number, // auto casting
- *         \@TypedParam("paused") paused: boolean | null // auto casting
- *     ): Promise<void>;
- * ```
- *
- * @param name URL Parameter name
- * @param type If omit, automatically determined by the parameter type.
- * @param nullable If omit, automatically determined by the parameter type.
- * @returns Parameter decorator
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export declare function TypedParam(name: string, type?: "boolean" | "number" | "string" | "uuid", nullable?: false | true): ParameterDecorator;
+/**
+ * Type safe URL parameter decorator.
+ *
+ * `TypedParam` is a decorator function getting specific typed parameter from the
+ * HTTP request URL. It's almost same with the {@link nest.Param}, but `TypedParam`
+ * automatically casts parameter value to be following its type. Beside, the
+ * {@link nest.Param} always parses all of the parameters as `string` type.
+ *
+ * Note that, if you just omit the `type` and `nullable` parameters, then
+ * `TypedParam` automatically determines the `type` and `nullable` values
+ * just by analyzing the parameter type. Only when you need to specify them
+ * are, you want to use the `uuid` type.
+ *
+ * ```typescript
+ * \@TypedRoute.Get("shopping/sales/:id/:no/:paused")
+ * public async pause
+ *     (
+ *         \@TypedParam("id", "uuid"), id: string, // uuid specification
+ *         \@TypedParam("no") id: number, // auto casting
+ *         \@TypedParam("paused") paused: boolean | null // auto casting
+ *     ): Promise<void>;
+ * ```
+ *
+ * @param name URL Parameter name
+ * @param type If omit, automatically determined by the parameter type.
+ * @param nullable If omit, automatically determined by the parameter type.
+ * @returns Parameter decorator
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare function TypedParam(name: string, type?: "boolean" | "number" | "string" | "uuid", nullable?: false | true): ParameterDecorator;

package/lib/decorators/TypedParam.js

@@ -1,66 +1,69 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TypedParam = void 0;
-var common_1 = require("@nestjs/common");
-/**
- * Type safe URL parameter decorator.
- *
- * `TypedParam` is a decorator function getting specific typed parameter from the
- * HTTP request URL. It's almost same with the {@link nest.Param}, but `TypedParam`
- * automatically casts parameter value to be following its type. Beside, the
- * {@link nest.Param} always parses all of the parameters as `string` type.
- *
- * Note that, if you just omit the `type` and `nullable` parameters, then
- * `TypedParam` automatically determines the `type` and `nullable` values
- * just by analyzing the parameter type. Only when you need to specify them
- * are, you want to use the `uuid` type.
- *
- * ```typescript
- * \@TypedRoute.Get("shopping/sales/:id/:no/:paused")
- * public async pause
- *     (
- *         \@TypedParam("id", "uuid"), id: string, // uuid specification
- *         \@TypedParam("no") id: number, // auto casting
- *         \@TypedParam("paused") paused: boolean | null // auto casting
- *     ): Promise<void>;
- * ```
- *
- * @param name URL Parameter name
- * @param type If omit, automatically determined by the parameter type.
- * @param nullable If omit, automatically determined by the parameter type.
- * @returns Parameter decorator
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-function TypedParam(name, type, nullable) {
-    return (0, common_1.createParamDecorator)(function TypedParam(_a, ctx) {
-        var request = ctx.switchToHttp().getRequest();
-        var str = request.params[name];
-        if (nullable === true && str === "null")
-            return null;
-        else if (type === "boolean") {
-            if (str === "true" || str === "1")
-                return true;
-            else if (str === "false" || str === "0")
-                return false;
-            else
-                throw new common_1.BadRequestException("Value of the URL parameter '".concat(name, "' is not a boolean."));
-        }
-        else if (type === "number") {
-            var value = Number(str);
-            if (isNaN(value))
-                throw new common_1.BadRequestException("Value of the URL parameter \"".concat(name, "\" is not a number."));
-            return value;
-        }
-        else if (type === "uuid") {
-            if (UUID_PATTERN.test(str) === false)
-                throw new common_1.BadRequestException("Value of the URL parameter \"".concat(name, "\" is not a valid UUID."));
-            return str;
-        }
-        else
-            return str;
-    })(name);
-}
-exports.TypedParam = TypedParam;
-var UUID_PATTERN = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000)$/i;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedParam = void 0;
+var common_1 = require("@nestjs/common");
+/**
+ * Type safe URL parameter decorator.
+ *
+ * `TypedParam` is a decorator function getting specific typed parameter from the
+ * HTTP request URL. It's almost same with the {@link nest.Param}, but `TypedParam`
+ * automatically casts parameter value to be following its type. Beside, the
+ * {@link nest.Param} always parses all of the parameters as `string` type.
+ *
+ * Note that, if you just omit the `type` and `nullable` parameters, then
+ * `TypedParam` automatically determines the `type` and `nullable` values
+ * just by analyzing the parameter type. Only when you need to specify them
+ * are, you want to use the `uuid` type.
+ *
+ * ```typescript
+ * \@TypedRoute.Get("shopping/sales/:id/:no/:paused")
+ * public async pause
+ *     (
+ *         \@TypedParam("id", "uuid"), id: string, // uuid specification
+ *         \@TypedParam("no") id: number, // auto casting
+ *         \@TypedParam("paused") paused: boolean | null // auto casting
+ *     ): Promise<void>;
+ * ```
+ *
+ * @param name URL Parameter name
+ * @param type If omit, automatically determined by the parameter type.
+ * @param nullable If omit, automatically determined by the parameter type.
+ * @returns Parameter decorator
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+function TypedParam(name, type, nullable) {
+    var deco = (0, common_1.createParamDecorator)(function TypedParam(_a, ctx) {
+        var request = ctx.switchToHttp().getRequest();
+        var str = request.params[name];
+        if (nullable === true && str === "null")
+            return null;
+        else if (type === "boolean") {
+            if (str === "true" || str === "1")
+                return true;
+            else if (str === "false" || str === "0")
+                return false;
+            else
+                throw new common_1.BadRequestException("Value of the URL parameter '".concat(name, "' is not a boolean."));
+        }
+        else if (type === "number") {
+            var value = Number(str);
+            if (isNaN(value))
+                throw new common_1.BadRequestException("Value of the URL parameter \"".concat(name, "\" is not a number."));
+            return value;
+        }
+        else if (type === "uuid") {
+            if (UUID_PATTERN.test(str) === false)
+                throw new common_1.BadRequestException("Value of the URL parameter \"".concat(name, "\" is not a valid UUID."));
+            return str;
+        }
+        else
+            return str;
+    })(name);
+    deco.nullable = !!nullable;
+    deco.type = type;
+    return deco;
+}
+exports.TypedParam = TypedParam;
+var UUID_PATTERN = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000)$/i;
 //# sourceMappingURL=TypedParam.js.map

package/lib/decorators/TypedParam.js.map

@@ -1 +1 @@
-{"version":3,"file":"TypedParam.js","sourceRoot":"","sources":["../../src/decorators/TypedParam.ts"],"names":[],"mappings":";;;AAAA,yCAIwB;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,UAAU,CACtB,IAAY,EACZ,IAA+C,EAC/C,QAAuB;IAEvB,OAAO,IAAA,6BAAoB,EAAC,SAAS,UAAU,CAC3C,EAAO,EACP,GAAqB;QAErB,IAAM,OAAO,GAAoB,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;QACjE,IAAM,GAAG,GAAW,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,QAAQ,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;aAChD,IAAI,IAAI,KAAK,SAAS,EAAE;YACzB,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;iBAC1C,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,GAAG;gBAAE,OAAO,KAAK,CAAC;;gBAElD,MAAM,IAAI,4BAAmB,CACzB,sCAA+B,IAAI,wBAAqB,CAC3D,CAAC;SACT;aAAM,IAAI,IAAI,KAAK,QAAQ,EAAE;YAC1B,IAAM,KAAK,GAAW,MAAM,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,KAAK,CAAC,KAAK,CAAC;gBACZ,MAAM,IAAI,4BAAmB,CACzB,uCAA+B,IAAI,wBAAoB,CAC1D,CAAC;YACN,OAAO,KAAK,CAAC;SAChB;aAAM,IAAI,IAAI,KAAK,MAAM,EAAE;YACxB,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK;gBAChC,MAAM,IAAI,4BAAmB,CACzB,uCAA+B,IAAI,4BAAwB,CAC9D,CAAC;YACN,OAAO,GAAG,CAAC;SACd;;YAAM,OAAO,GAAG,CAAC;IACtB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACb,CAAC;AAnCD,gCAmCC;AAED,IAAM,YAAY,GACd,qHAAqH,CAAC"}
+{"version":3,"file":"TypedParam.js","sourceRoot":"","sources":["../../src/decorators/TypedParam.ts"],"names":[],"mappings":";;;AAAA,yCAIwB;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,UAAU,CACtB,IAAY,EACZ,IAA+C,EAC/C,QAAuB;IAEvB,IAAM,IAAI,GAAG,IAAA,6BAAoB,EAAC,SAAS,UAAU,CACjD,EAAO,EACP,GAAqB;QAErB,IAAM,OAAO,GAAoB,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;QACjE,IAAM,GAAG,GAAW,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,QAAQ,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;aAChD,IAAI,IAAI,KAAK,SAAS,EAAE;YACzB,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;iBAC1C,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,GAAG;gBAAE,OAAO,KAAK,CAAC;;gBAElD,MAAM,IAAI,4BAAmB,CACzB,sCAA+B,IAAI,wBAAqB,CAC3D,CAAC;SACT;aAAM,IAAI,IAAI,KAAK,QAAQ,EAAE;YAC1B,IAAM,KAAK,GAAW,MAAM,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,KAAK,CAAC,KAAK,CAAC;gBACZ,MAAM,IAAI,4BAAmB,CACzB,uCAA+B,IAAI,wBAAoB,CAC1D,CAAC;YACN,OAAO,KAAK,CAAC;SAChB;aAAM,IAAI,IAAI,KAAK,MAAM,EAAE;YACxB,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK;gBAChC,MAAM,IAAI,4BAAmB,CACzB,uCAA+B,IAAI,4BAAwB,CAC9D,CAAC;YACN,OAAO,GAAG,CAAC;SACd;;YAAM,OAAO,GAAG,CAAC;IACtB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACR,IAAY,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;IACnC,IAAY,CAAC,IAAI,GAAG,IAAI,CAAC;IAC1B,OAAO,IAAI,CAAC;AAChB,CAAC;AAtCD,gCAsCC;AAED,IAAM,YAAY,GACd,qHAAqH,CAAC"}

package/lib/decorators/TypedQuery.d.ts

@@ -1,14 +1,14 @@
-/**
- * Type safe URL query decorator.
- *
- * `TypedQuery` is a decorator function that can parse URL query string. It is almost
- * same with {@link nest.Query}, but it can automatically cast property type following
- * its DTO definition. Also, `TypedQuery` performs type validation.
- *
- * For referecen, when URL query parameters are different with their promised
- * type `T`, `BadRequestException` error (status code: 400) would be thrown.
- *
- * @returns Parameter decorator
- * @author Jeongho Nam - https://github.com/samchon
- */
-export declare function TypedQuery<T>(decoder?: (params: URLSearchParams) => T): ParameterDecorator;
+/**
+ * Type safe URL query decorator.
+ *
+ * `TypedQuery` is a decorator function that can parse URL query string. It is almost
+ * same with {@link nest.Query}, but it can automatically cast property type following
+ * its DTO definition. Also, `TypedQuery` performs type validation.
+ *
+ * For referecen, when URL query parameters are different with their promised
+ * type `T`, `BadRequestException` error (status code: 400) would be thrown.
+ *
+ * @returns Parameter decorator
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare function TypedQuery<T>(decoder?: (params: URLSearchParams) => T): ParameterDecorator;