@nestia/core 0.1.0

package/lib/decorators/EncryptedRoute.js

@@ -0,0 +1,191 @@
+"use strict";
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+var e_1, _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EncryptedRoute = void 0;
+var fetcher_1 = require("@nestia/fetcher");
+var common_1 = require("@nestjs/common");
+var rxjs_1 = require("rxjs");
+var typia_1 = require("typia");
+var Singleton_1 = require("../utils/Singleton");
+var EncryptedConstant_1 = require("./internal/EncryptedConstant");
+var get_path_and_stringify_1 = require("./internal/get_path_and_stringify");
+var headers_to_object_1 = require("./internal/headers_to_object");
+var route_error_1 = require("./internal/route_error");
+/**
+ * Encrypted router decorator functions.
+ *
+ * `EncryptedRoute` is a module containing router decorator functions which encrypts
+ * response body data through AES-128/250 encryption. Also, those decorator functions
+ * can boost up JSON string conversion speed about 5x times faster, through
+ * [`typia.stringify()`](https://github.com/samchon/typia#fastest-json-string-conversion).
+ *
+ * For reference, `EncryptedRoute` encrypts response body usnig those options.
+ *
+ *  - AES-128/256
+ *  - CBC mode
+ *  - PKCS #5 Padding
+ *  - Base64 Encoding
+ *
+ * Also, router functions in `EncryptedRoute` can convert custom error classes to the
+ * regular {@link nest.HttpException} class automatically, through
+ * {@link ExceptionManager}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var EncryptedRoute;
+(function (EncryptedRoute) {
+    /**
+     * Encrypted router decorator function for the GET method.
+     *
+     * @param paths Path(s) of the HTTP request
+     * @returns Method decorator
+     */
+    EncryptedRoute.Get = Generator("Get");
+    /**
+     * Encrypted router decorator function for the GET method.
+     *
+     * @param paths Path(s) of the HTTP request
+     * @returns Method decorator
+     */
+    EncryptedRoute.Post = Generator("Post");
+    /**
+     * Encrypted router decorator function for the PATCH method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    EncryptedRoute.Patch = Generator("Patch");
+    /**
+     * Encrypted router decorator function for the PUT method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    EncryptedRoute.Put = Generator("Put");
+    /**
+     * Encrypted router decorator function for the DELETE method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    EncryptedRoute.Delete = Generator("Delete");
+    function Generator(method) {
+        function route() {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            var _a = __read((0, get_path_and_stringify_1.get_path_and_stringify)("EncryptedRoute.".concat(method)).apply(void 0, __spreadArray([], __read(args), false)), 2), path = _a[0], stringify = _a[1];
+            return (0, common_1.applyDecorators)(ROUTERS[method](path), (0, common_1.UseInterceptors)(new EncryptedRouteInterceptor(method, stringify)));
+        }
+        return route;
+    }
+})(EncryptedRoute = exports.EncryptedRoute || (exports.EncryptedRoute = {}));
+try {
+    for (var _b = __values([
+        typia_1.assertStringify,
+        typia_1.isStringify,
+        typia_1.stringify,
+        typia_1.validateStringify,
+    ]), _c = _b.next(); !_c.done; _c = _b.next()) {
+        var method = _c.value;
+        Object.assign(EncryptedRoute.Get, method);
+        Object.assign(EncryptedRoute.Delete, method);
+        Object.assign(EncryptedRoute.Post, method);
+        Object.assign(EncryptedRoute.Put, method);
+        Object.assign(EncryptedRoute.Patch, method);
+    }
+}
+catch (e_1_1) { e_1 = { error: e_1_1 }; }
+finally {
+    try {
+        if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+    }
+    finally { if (e_1) throw e_1.error; }
+}
+/**
+ * @internal
+ */
+var EncryptedRouteInterceptor = /** @class */ (function () {
+    function EncryptedRouteInterceptor(method, stringify) {
+        this.method = method;
+        this.stringify = stringify;
+    }
+    EncryptedRouteInterceptor.prototype.intercept = function (context, next) {
+        var _this = this;
+        var http = context.switchToHttp();
+        return next.handle().pipe((0, rxjs_1.map)(function (value) {
+            var param = Reflect.getMetadata(EncryptedConstant_1.ENCRYPTION_METADATA_KEY, context.getClass());
+            if (!param)
+                throw new Error("Error on EncryptedRoute.".concat(_this.method, "(): no encryption password is given."));
+            var headers = new Singleton_1.Singleton(function () {
+                var request = http.getRequest();
+                return (0, headers_to_object_1.headers_to_object)(request.headers);
+            });
+            var body = _this.stringify(value);
+            var password = typeof param === "function"
+                ? param({ headers: headers.get(), body: body }, false)
+                : param;
+            var disabled = password.disabled === undefined
+                ? false
+                : typeof password.disabled === "function"
+                    ? password.disabled({ headers: headers.get(), body: body }, false)
+                    : password.disabled;
+            var response = http.getResponse();
+            response.header("Content-Type", disabled ? "application/json" : "text/plain");
+            if (disabled === true)
+                return body;
+            else if (body === undefined)
+                return body;
+            return fetcher_1.AesPkcs5.encrypt(body, password.key, password.iv);
+        }), (0, rxjs_1.catchError)(function (err) { return (0, route_error_1.route_error)(http.getRequest(), err); }));
+    };
+    return EncryptedRouteInterceptor;
+}());
+/**
+ * @internal
+ */
+var ROUTERS = {
+    Get: common_1.Get,
+    Post: common_1.Post,
+    Put: common_1.Put,
+    Patch: common_1.Patch,
+    Delete: common_1.Delete,
+};
+//# sourceMappingURL=EncryptedRoute.js.map

package/lib/decorators/EncryptedRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncryptedRoute.js","sourceRoot":"","sources":["../../src/decorators/EncryptedRoute.ts"],"names":[],"mappings":"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"}

package/lib/decorators/PlainBody.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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-helper` 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
+ */
+export declare const PlainBody: () => ParameterDecorator;

package/lib/decorators/PlainBody.js

@@ -0,0 +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-helper` 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/PlainBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlainBody.js","sourceRoot":"","sources":["../../src/decorators/PlainBody.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAIwB;AAExB,sDAA2B;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACU,QAAA,SAAS,GAA6B,IAAA,6BAAoB,EACnE,SAAe,SAAS,CAAC,KAAU,EAAE,OAAyB;;;;;;oBACpD,OAAO,GAAoB,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;oBACrE,IAAI,CAAC,OAAO,CAAC,QAAQ;wBAAE,MAAM,IAAI,4BAAmB,CAAC,cAAc,CAAC,CAAC;oBAE/C,qBAAM,IAAA,kBAAG,EAAC,OAAO,CAAC,EAAA;;oBAAlC,IAAI,GAAW,CAAC,SAAkB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;oBACjE,sBAAO,IAAI,EAAC;;;;CACf,CACJ,CAAC"}

package/lib/decorators/TypedBody.d.ts

@@ -0,0 +1,14 @@
+import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
+/**
+ * Safe body decorator.
+ *
+ * `TypedBody` is a decorator function getting JSON data from HTTP request. Also,
+ * it validates the JSON data type through
+ * [`typia.assert()`](https://github.com/samchon/typia#runtime-type-checkers)
+ * function and throws `BadRequestException` error (status code: 400), if the JSON
+ * data is not following the promised type.
+ *
+ * @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

@@ -0,0 +1,93 @@
+"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");
+/**
+ * Safe body decorator.
+ *
+ * `TypedBody` is a decorator function getting JSON data from HTTP request. Also,
+ * it validates the JSON data type through
+ * [`typia.assert()`](https://github.com/samchon/typia#runtime-type-checkers)
+ * function and throws `BadRequestException` error (status code: 400), if the JSON
+ * data is not following the promised type.
+ *
+ * @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.headers["content-type"] !== "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.assert);
+Object.assign(TypedBody, typia_1.is);
+Object.assign(TypedBody, typia_1.validate);
+//# sourceMappingURL=TypedBody.js.map

package/lib/decorators/TypedBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedBody.js","sourceRoot":"","sources":["../../src/decorators/TypedBody.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAIwB;AAExB,sDAA2B;AAC3B,+BAA6C;AAG7C,0EAAyE;AAEzE;;;;;;;;;;;GAWG;AACH,SAAgB,SAAS,CACrB,SAAoC;IAEpC,IAAM,OAAO,GAAG,IAAA,6CAAqB,EAAC,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9D,OAAO,IAAA,6BAAoB,EAAC,SAAe,SAAS,CAChD,QAAa,EACb,OAAyB;;;;;;wBAEnB,OAAO,GAAoB,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;wBACrE,IAAI,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,kBAAkB,EAAE;4BACxD,MAAM,IAAI,4BAAmB,CACzB,2CAA2C,CAC9C,CAAC;yBACL;6BACiB,OAAO,CAAC,IAAI,EAAZ,wBAAY;wBACxB,KAAA,OAAO,CAAC,IAAI,CAAA;;;wBACZ,KAAA,CAAA,KAAA,IAAI,CAAA,CAAC,KAAK,CAAA;wBAAE,qBAAM,IAAA,kBAAG,EAAC,OAAO,EAAE,MAAM,CAAC,EAAA;;wBAAtC,KAAA,cAAW,CAAC,SAA0B,CAAC,CAAC,IAAI,EAAE,EAAC,CAAA;;;wBAF/C,IAAI,KAE2C;wBACrD,OAAO,CAAC,IAAI,CAAC,CAAC;wBACd,sBAAO,IAAI,EAAC;;;;KACf,CAAC,EAAE,CAAC;AACT,CAAC;AApBD,8BAoBC;AAED,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,cAAM,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,UAAE,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,gBAAQ,CAAC,CAAC"}

package/lib/decorators/TypedParam.d.ts

@@ -0,0 +1,25 @@
+/**
+ * URL parameter decorator with type.
+ *
+ * `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` can specify
+ * the parameter type manually. Beside, the {@link nest.Param} always parses all of the
+ * parameters as string type.
+ *
+ * ```typescript
+ * \@TypedRoute.Get("shopping/sales/:section/:id/:paused")
+ * public async pause
+ *     (
+ *         \@TypedParam("section", "string") section: string,
+ *         \@TypedParam("id", "number") id: number,
+ *         \@TypedParam("paused", "boolean", true) paused: boolean | null
+ *     ): Promise<void>;
+ * ```
+ *
+ * @param name URL Parameter name
+ * @param type Type of the URL parameter
+ * @returns Parameter decorator
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare function TypedParam(name: string, type?: "boolean" | "number" | "string" | "uuid", nullable?: boolean): ParameterDecorator;

package/lib/decorators/TypedParam.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedParam = void 0;
+var common_1 = require("@nestjs/common");
+/**
+ * URL parameter decorator with type.
+ *
+ * `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` can specify
+ * the parameter type manually. Beside, the {@link nest.Param} always parses all of the
+ * parameters as string type.
+ *
+ * ```typescript
+ * \@TypedRoute.Get("shopping/sales/:section/:id/:paused")
+ * public async pause
+ *     (
+ *         \@TypedParam("section", "string") section: string,
+ *         \@TypedParam("id", "number") id: number,
+ *         \@TypedParam("paused", "boolean", true) paused: boolean | null
+ *     ): Promise<void>;
+ * ```
+ *
+ * @param name URL Parameter name
+ * @param type Type of the URL parameter
+ * @returns Parameter decorator
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+function TypedParam(name, type, nullable) {
+    if (type === void 0) { type = "string"; }
+    if (nullable === void 0) { nullable = false; }
+    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}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i;
+//# sourceMappingURL=TypedParam.js.map

package/lib/decorators/TypedParam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedParam.js","sourceRoot":"","sources":["../../src/decorators/TypedParam.ts"],"names":[],"mappings":";;;AAAA,yCAIwB;AAGxB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,UAAU,CACtB,IAAY,EACZ,IAAyD,EACzD,QAAyB;IADzB,qBAAA,EAAA,eAAyD;IACzD,yBAAA,EAAA,gBAAyB;IAEzB,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,iEAAiE,CAAC"}

package/lib/decorators/TypedRoute.d.ts

@@ -0,0 +1,71 @@
+import { IResponseBodyStringifier } from "../options/IResponseBodyStringifier";
+/**
+ * Safe router decorator functions.
+ *
+ * `TypedRoute` is a module containing router decorator functions which can boost up
+ * JSON string conversion speed about 5x times faster, through
+ * [`typia.stringify()`](https://github.com/samchon/typia#fastest-json-string-conversion).
+ *
+ * Also, router functions in `TypedRoute` can convert custom error classes to the
+ * regular {@link nest.HttpException} class automatically, through
+ * {@link ExceptionManager}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare namespace TypedRoute {
+    /**
+     * Router decorator function for the GET method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    const Get: {
+        (path?: string | string[]): MethodDecorator;
+        <T>(stringify?: IResponseBodyStringifier<T> | undefined): MethodDecorator;
+        <T_1>(path: string | string[], stringify?: IResponseBodyStringifier<T_1> | undefined): MethodDecorator;
+    };
+    /**
+     * Router decorator function for the POST method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    const Post: {
+        (path?: string | string[]): MethodDecorator;
+        <T>(stringify?: IResponseBodyStringifier<T> | undefined): MethodDecorator;
+        <T_1>(path: string | string[], stringify?: IResponseBodyStringifier<T_1> | undefined): MethodDecorator;
+    };
+    /**
+     * Router decorator function for the PATH method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    const Patch: {
+        (path?: string | string[]): MethodDecorator;
+        <T>(stringify?: IResponseBodyStringifier<T> | undefined): MethodDecorator;
+        <T_1>(path: string | string[], stringify?: IResponseBodyStringifier<T_1> | undefined): MethodDecorator;
+    };
+    /**
+     * Router decorator function for the PUT method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    const Put: {
+        (path?: string | string[]): MethodDecorator;
+        <T>(stringify?: IResponseBodyStringifier<T> | undefined): MethodDecorator;
+        <T_1>(path: string | string[], stringify?: IResponseBodyStringifier<T_1> | undefined): MethodDecorator;
+    };
+    /**
+     * Router decorator function for the DELETE method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    const Delete: {
+        (path?: string | string[]): MethodDecorator;
+        <T>(stringify?: IResponseBodyStringifier<T> | undefined): MethodDecorator;
+        <T_1>(path: string | string[], stringify?: IResponseBodyStringifier<T_1> | undefined): MethodDecorator;
+    };
+}