@nestia/core 1.3.5 → 1.3.7

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 };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlainBody = void 0;
-var common_1 = require("@nestjs/common");
-var get_text_body_1 = require("./internal/get_text_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;
-        return __generator(this, function (_a) {
-            request = context
-                .switchToHttp()
-                .getRequest();
-            if (!isTextPlain(request.headers["content-type"]))
-                throw new common_1.BadRequestException("Request body type is not \"text/plain\".");
-            return [2 /*return*/, (0, get_text_body_1.get_text_body)(request)];
-        });
-    });
-});
-var isTextPlain = function (text) {
-    return text !== undefined &&
-        text
-            .split(";")
-            .map(function (str) { return str.trim(); })
-            .some(function (str) { return str === "text/plain"; });
-};
+"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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlainBody = void 0;
+var common_1 = require("@nestjs/common");
+var get_text_body_1 = require("./internal/get_text_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;
+        return __generator(this, function (_a) {
+            request = context
+                .switchToHttp()
+                .getRequest();
+            if (!isTextPlain(request.headers["content-type"]))
+                throw new common_1.BadRequestException("Request body type is not \"text/plain\".");
+            return [2 /*return*/, (0, get_text_body_1.get_text_body)(request)];
+        });
+    });
+});
+var isTextPlain = function (text) {
+    return text !== undefined &&
+        text
+            .split(";")
+            .map(function (str) { return str.trim(); })
+            .some(function (str) { return str === "text/plain"; });
+};
 //# 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,46 +1,46 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TypedBody = void 0;
-var common_1 = require("@nestjs/common");
-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) {
-        var request = context
-            .switchToHttp()
-            .getRequest();
-        if (isApplicationJson(request.headers["content-type"]) === false)
-            throw new common_1.BadRequestException("Request body type is not \"application/json\".");
-        var error = checker(request.body);
-        if (error !== null)
-            throw error;
-        return request.body;
-    })();
-}
-exports.TypedBody = TypedBody;
-Object.assign(TypedBody, typia_1.is);
-Object.assign(TypedBody, typia_1.assert);
-Object.assign(TypedBody, typia_1.validate);
-var isApplicationJson = function (text) {
-    return text !== undefined &&
-        text
-            .split(";")
-            .map(function (str) { return str.trim(); })
-            .some(function (str) { return str === "application/json"; });
-};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedBody = void 0;
+var common_1 = require("@nestjs/common");
+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) {
+        var request = context
+            .switchToHttp()
+            .getRequest();
+        if (isApplicationJson(request.headers["content-type"]) === false)
+            throw new common_1.BadRequestException("Request body type is not \"application/json\".");
+        var error = checker(request.body);
+        if (error !== null)
+            throw error;
+        return request.body;
+    })();
+}
+exports.TypedBody = TypedBody;
+Object.assign(TypedBody, typia_1.is);
+Object.assign(TypedBody, typia_1.assert);
+Object.assign(TypedBody, typia_1.validate);
+var isApplicationJson = function (text) {
+    return text !== undefined &&
+        text
+            .split(";")
+            .map(function (str) { return str.trim(); })
+            .some(function (str) { return str === "application/json"; });
+};
 //# 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" | "date", 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" | "date", nullable?: false | true): ParameterDecorator;

package/lib/decorators/TypedParam.js

@@ -1,77 +1,77 @@
-"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) {
-    function TypedParam(_a, context) {
-        var request = context
-            .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 if (type === "date") {
-            if (DATE_PATTERN.test(str) === false)
-                throw new common_1.BadRequestException("Value of the URL parameter \"".concat(name, "\" is not a valid date."));
-            return str;
-        }
-        else
-            return str;
-    }
-    TypedParam.nullable = !!nullable;
-    TypedParam.type = type;
-    return (0, common_1.createParamDecorator)(TypedParam)(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;
-var DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+"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) {
+    function TypedParam(_a, context) {
+        var request = context
+            .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 if (type === "date") {
+            if (DATE_PATTERN.test(str) === false)
+                throw new common_1.BadRequestException("Value of the URL parameter \"".concat(name, "\" is not a valid date."));
+            return str;
+        }
+        else
+            return str;
+    }
+    TypedParam.nullable = !!nullable;
+    TypedParam.type = type;
+    return (0, common_1.createParamDecorator)(TypedParam)(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;
+var DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
 //# sourceMappingURL=TypedParam.js.map

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;