@nestia/core 0.1.5 → 0.1.7

package/src/decorators/TypedBody.ts

@@ -1,49 +1,49 @@
-import {
-    BadRequestException,
-    ExecutionContext,
-    createParamDecorator,
-} from "@nestjs/common";
-import type express from "express";
-import raw from "raw-body";
-import { assert, is, validate } from "typia";
-
-import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
-import { validate_request_body } from "./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
- */
-export function TypedBody<T>(
-    validator?: IRequestBodyValidator<T>,
-): ParameterDecorator {
-    const checker = validate_request_body("TypedBody")(validator);
-    return createParamDecorator(async function TypedBody(
-        _unknown: any,
-        context: ExecutionContext,
-    ) {
-        const request: express.Request = context.switchToHttp().getRequest();
-        if (request.headers["content-type"] !== "application/json") {
-            throw new BadRequestException(
-                "Request body is not the application/json.",
-            );
-        }
-        const data: any = request.body
-            ? request.body
-            : JSON.parse((await raw(request, "utf8")).trim());
-        checker(data);
-        return data;
-    })();
-}
-
-Object.assign(TypedBody, assert);
-Object.assign(TypedBody, is);
-Object.assign(TypedBody, validate);
+import {
+    BadRequestException,
+    ExecutionContext,
+    createParamDecorator,
+} from "@nestjs/common";
+import type express from "express";
+import raw from "raw-body";
+import { assert, is, validate } from "typia";
+
+import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
+import { validate_request_body } from "./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
+ */
+export function TypedBody<T>(
+    validator?: IRequestBodyValidator<T>,
+): ParameterDecorator {
+    const checker = validate_request_body("TypedBody")(validator);
+    return createParamDecorator(async function TypedBody(
+        _unknown: any,
+        context: ExecutionContext,
+    ) {
+        const request: express.Request = context.switchToHttp().getRequest();
+        if (request.headers["content-type"] !== "application/json") {
+            throw new BadRequestException(
+                "Request body is not the application/json.",
+            );
+        }
+        const data: any = request.body
+            ? request.body
+            : JSON.parse((await raw(request, "utf8")).trim());
+        checker(data);
+        return data;
+    })();
+}
+
+Object.assign(TypedBody, assert);
+Object.assign(TypedBody, is);
+Object.assign(TypedBody, validate);

package/src/decorators/TypedParam.ts

@@ -1,70 +1,70 @@
-import {
-    BadRequestException,
-    ExecutionContext,
-    createParamDecorator,
-} from "@nestjs/common";
-import type express from "express";
-
-/**
- * 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 function TypedParam(
-    name: string,
-    type: "boolean" | "number" | "string" | "uuid" = "string",
-    nullable: boolean = false,
-) {
-    return createParamDecorator(function TypedParam(
-        {}: any,
-        ctx: ExecutionContext,
-    ) {
-        const request: express.Request = ctx.switchToHttp().getRequest();
-        const str: string = 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 BadRequestException(
-                    `Value of the URL parameter '${name}' is not a boolean.`,
-                );
-        } else if (type === "number") {
-            const value: number = Number(str);
-            if (isNaN(value))
-                throw new BadRequestException(
-                    `Value of the URL parameter "${name}" is not a number.`,
-                );
-            return value;
-        } else if (type === "uuid") {
-            if (UUID_PATTERN.test(str) === false)
-                throw new BadRequestException(
-                    `Value of the URL parameter "${name}" is not a valid UUID.`,
-                );
-            return str;
-        } else return str;
-    })(name);
-}
-
-const UUID_PATTERN =
-    /^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i;
+import {
+    BadRequestException,
+    ExecutionContext,
+    createParamDecorator,
+} from "@nestjs/common";
+import type express from "express";
+
+/**
+ * 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 function TypedParam(
+    name: string,
+    type: "boolean" | "number" | "string" | "uuid" = "string",
+    nullable: boolean = false,
+) {
+    return createParamDecorator(function TypedParam(
+        {}: any,
+        ctx: ExecutionContext,
+    ) {
+        const request: express.Request = ctx.switchToHttp().getRequest();
+        const str: string = 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 BadRequestException(
+                    `Value of the URL parameter '${name}' is not a boolean.`,
+                );
+        } else if (type === "number") {
+            const value: number = Number(str);
+            if (isNaN(value))
+                throw new BadRequestException(
+                    `Value of the URL parameter "${name}" is not a number.`,
+                );
+            return value;
+        } else if (type === "uuid") {
+            if (UUID_PATTERN.test(str) === false)
+                throw new BadRequestException(
+                    `Value of the URL parameter "${name}" is not a valid UUID.`,
+                );
+            return str;
+        } else return str;
+    })(name);
+}
+
+const UUID_PATTERN =
+    /^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i;

package/src/decorators/TypedRoute.ts

@@ -1,149 +1,149 @@
-import {
-    CallHandler,
-    Delete,
-    ExecutionContext,
-    Get,
-    NestInterceptor,
-    Patch,
-    Post,
-    Put,
-    UseInterceptors,
-    applyDecorators,
-} from "@nestjs/common";
-import { HttpArgumentsHost } from "@nestjs/common/interfaces";
-import express from "express";
-import { Observable, catchError, map } from "rxjs";
-import {
-    assertStringify,
-    isStringify,
-    stringify,
-    validateStringify,
-} from "typia";
-
-import { IResponseBodyStringifier } from "../options/IResponseBodyStringifier";
-import { get_path_and_stringify } from "./internal/get_path_and_stringify";
-import { route_error } from "./internal/route_error";
-
-/**
- * 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 namespace TypedRoute {
-    /**
-     * Router decorator function for the GET method.
-     *
-     * @param path Path of the HTTP request
-     * @returns Method decorator
-     */
-    export const Get = Generator("Get");
-
-    /**
-     * Router decorator function for the POST method.
-     *
-     * @param path Path of the HTTP request
-     * @returns Method decorator
-     */
-    export const Post = Generator("Post");
-
-    /**
-     * Router decorator function for the PATH method.
-     *
-     * @param path Path of the HTTP request
-     * @returns Method decorator
-     */
-    export const Patch = Generator("Patch");
-
-    /**
-     * Router decorator function for the PUT method.
-     *
-     * @param path Path of the HTTP request
-     * @returns Method decorator
-     */
-    export const Put = Generator("Put");
-
-    /**
-     * Router decorator function for the DELETE method.
-     *
-     * @param path Path of the HTTP request
-     * @returns Method decorator
-     */
-    export const Delete = Generator("Delete");
-
-    /**
-     * @internal
-     */
-    function Generator(method: "Get" | "Post" | "Put" | "Patch" | "Delete") {
-        function route(path?: string | string[]): MethodDecorator;
-        function route<T>(
-            stringify?: IResponseBodyStringifier<T>,
-        ): MethodDecorator;
-        function route<T>(
-            path: string | string[],
-            stringify?: IResponseBodyStringifier<T>,
-        ): MethodDecorator;
-
-        function route(...args: any[]): MethodDecorator {
-            const [path, stringify] = get_path_and_stringify(
-                `TypedRoute.${method}`,
-            )(...args);
-            return applyDecorators(
-                ROUTERS[method](path),
-                UseInterceptors(new TypedRouteInterceptor(stringify)),
-            );
-        }
-        return route;
-    }
-}
-for (const method of [
-    assertStringify,
-    isStringify,
-    stringify,
-    validateStringify,
-]) {
-    Object.assign(TypedRoute.Get, method);
-    Object.assign(TypedRoute.Delete, method);
-    Object.assign(TypedRoute.Post, method);
-    Object.assign(TypedRoute.Put, method);
-    Object.assign(TypedRoute.Patch, method);
-}
-
-/**
- * @internal
- */
-class TypedRouteInterceptor implements NestInterceptor {
-    public constructor(private readonly stringify: (input: any) => string) {}
-
-    public intercept(
-        context: ExecutionContext,
-        next: CallHandler,
-    ): Observable<any> {
-        const http: HttpArgumentsHost = context.switchToHttp();
-        const response: express.Response = http.getResponse();
-        response.header("Content-Type", "application/json");
-
-        return next.handle().pipe(
-            map((value) => this.stringify(value)),
-            catchError((err) => route_error(http.getRequest(), err)),
-        );
-    }
-}
-
-/**
- * @internal
- */
-const ROUTERS = {
-    Get,
-    Post,
-    Patch,
-    Put,
-    Delete,
-};
+import {
+    CallHandler,
+    Delete,
+    ExecutionContext,
+    Get,
+    NestInterceptor,
+    Patch,
+    Post,
+    Put,
+    UseInterceptors,
+    applyDecorators,
+} from "@nestjs/common";
+import { HttpArgumentsHost } from "@nestjs/common/interfaces";
+import express from "express";
+import { Observable, catchError, map } from "rxjs";
+import {
+    assertStringify,
+    isStringify,
+    stringify,
+    validateStringify,
+} from "typia";
+
+import { IResponseBodyStringifier } from "../options/IResponseBodyStringifier";
+import { get_path_and_stringify } from "./internal/get_path_and_stringify";
+import { route_error } from "./internal/route_error";
+
+/**
+ * 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 namespace TypedRoute {
+    /**
+     * Router decorator function for the GET method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    export const Get = Generator("Get");
+
+    /**
+     * Router decorator function for the POST method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    export const Post = Generator("Post");
+
+    /**
+     * Router decorator function for the PATH method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    export const Patch = Generator("Patch");
+
+    /**
+     * Router decorator function for the PUT method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    export const Put = Generator("Put");
+
+    /**
+     * Router decorator function for the DELETE method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    export const Delete = Generator("Delete");
+
+    /**
+     * @internal
+     */
+    function Generator(method: "Get" | "Post" | "Put" | "Patch" | "Delete") {
+        function route(path?: string | string[]): MethodDecorator;
+        function route<T>(
+            stringify?: IResponseBodyStringifier<T>,
+        ): MethodDecorator;
+        function route<T>(
+            path: string | string[],
+            stringify?: IResponseBodyStringifier<T>,
+        ): MethodDecorator;
+
+        function route(...args: any[]): MethodDecorator {
+            const [path, stringify] = get_path_and_stringify(
+                `TypedRoute.${method}`,
+            )(...args);
+            return applyDecorators(
+                ROUTERS[method](path),
+                UseInterceptors(new TypedRouteInterceptor(stringify)),
+            );
+        }
+        return route;
+    }
+}
+for (const method of [
+    assertStringify,
+    isStringify,
+    stringify,
+    validateStringify,
+]) {
+    Object.assign(TypedRoute.Get, method);
+    Object.assign(TypedRoute.Delete, method);
+    Object.assign(TypedRoute.Post, method);
+    Object.assign(TypedRoute.Put, method);
+    Object.assign(TypedRoute.Patch, method);
+}
+
+/**
+ * @internal
+ */
+class TypedRouteInterceptor implements NestInterceptor {
+    public constructor(private readonly stringify: (input: any) => string) {}
+
+    public intercept(
+        context: ExecutionContext,
+        next: CallHandler,
+    ): Observable<any> {
+        const http: HttpArgumentsHost = context.switchToHttp();
+        const response: express.Response = http.getResponse();
+        response.header("Content-Type", "application/json");
+
+        return next.handle().pipe(
+            map((value) => this.stringify(value)),
+            catchError((err) => route_error(http.getRequest(), err)),
+        );
+    }
+}
+
+/**
+ * @internal
+ */
+const ROUTERS = {
+    Get,
+    Post,
+    Patch,
+    Put,
+    Delete,
+};

package/src/decorators/internal/EncryptedConstant.ts

@@ -1,4 +1,4 @@
-/**
- * @internal
- */
-export const ENCRYPTION_METADATA_KEY = "nestia:core:encryption:password";
+/**
+ * @internal
+ */
+export const ENCRYPTION_METADATA_KEY = "nestia:core:encryption:password";