@nestia/core 0.1.4 → 0.1.5

package/src/decorators/EncryptedRoute.ts

@@ -1,203 +1,203 @@
-import { AesPkcs5, IEncryptionPassword } from "@nestia/fetcher";
-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 { Singleton } from "../utils/Singleton";
-import { ENCRYPTION_METADATA_KEY } from "./internal/EncryptedConstant";
-import { get_path_and_stringify } from "./internal/get_path_and_stringify";
-import { headers_to_object } from "./internal/headers_to_object";
-import { route_error } from "./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
- */
-export namespace EncryptedRoute {
-    /**
-     * Encrypted router decorator function for the GET method.
-     *
-     * @param paths Path(s) of the HTTP request
-     * @returns Method decorator
-     */
-    export const Get = Generator("Get");
-
-    /**
-     * Encrypted router decorator function for the GET method.
-     *
-     * @param paths Path(s) of the HTTP request
-     * @returns Method decorator
-     */
-    export const Post = Generator("Post");
-
-    /**
-     * Encrypted router decorator function for the PATCH method.
-     *
-     * @param path Path of the HTTP request
-     * @returns Method decorator
-     */
-    export const Patch = Generator("Patch");
-
-    /**
-     * Encrypted router decorator function for the PUT method.
-     *
-     * @param path Path of the HTTP request
-     * @returns Method decorator
-     */
-    export const Put = Generator("Put");
-
-    /**
-     * Encrypted router decorator function for the DELETE method.
-     *
-     * @param path Path of the HTTP request
-     * @returns Method decorator
-     */
-    export const Delete = Generator("Delete");
-
-    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(
-                `EncryptedRoute.${method}`,
-            )(...args);
-            return applyDecorators(
-                ROUTERS[method](path),
-                UseInterceptors(
-                    new EncryptedRouteInterceptor(method, stringify),
-                ),
-            );
-        }
-        return route;
-    }
-}
-
-for (const method of [
-    assertStringify,
-    isStringify,
-    stringify,
-    validateStringify,
-]) {
-    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);
-}
-
-/**
- * @internal
- */
-class EncryptedRouteInterceptor implements NestInterceptor {
-    public constructor(
-        private readonly method: string,
-        private readonly stringify: (input: any) => string,
-    ) {}
-
-    public intercept(
-        context: ExecutionContext,
-        next: CallHandler,
-    ): Observable<any> {
-        const http: HttpArgumentsHost = context.switchToHttp();
-        return next.handle().pipe(
-            map((value) => {
-                const param:
-                    | IEncryptionPassword
-                    | IEncryptionPassword.Closure
-                    | undefined = Reflect.getMetadata(
-                    ENCRYPTION_METADATA_KEY,
-                    context.getClass(),
-                );
-                if (!param)
-                    throw new Error(
-                        `Error on EncryptedRoute.${this.method}(): no encryption password is given.`,
-                    );
-
-                const headers: Singleton<Record<string, string>> =
-                    new Singleton(() => {
-                        const request: express.Request = http.getRequest();
-                        return headers_to_object(request.headers);
-                    });
-                const body: string | undefined = this.stringify(value);
-                const password: IEncryptionPassword =
-                    typeof param === "function"
-                        ? param({ headers: headers.get(), body }, false)
-                        : param;
-                const disabled: boolean =
-                    password.disabled === undefined
-                        ? false
-                        : typeof password.disabled === "function"
-                        ? password.disabled(
-                              { headers: headers.get(), body },
-                              false,
-                          )
-                        : password.disabled;
-
-                const response: express.Response = http.getResponse();
-                response.header(
-                    "Content-Type",
-                    disabled ? "application/json" : "text/plain",
-                );
-
-                if (disabled === true) return body;
-                else if (body === undefined) return body;
-                return AesPkcs5.encrypt(body, password.key, password.iv);
-            }),
-            catchError((err) => route_error(http.getRequest(), err)),
-        );
-    }
-}
-
-/**
- * @internal
- */
-const ROUTERS = {
-    Get,
-    Post,
-    Put,
-    Patch,
-    Delete,
-};
+import { AesPkcs5, IEncryptionPassword } from "@nestia/fetcher";
+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 { Singleton } from "../utils/Singleton";
+import { ENCRYPTION_METADATA_KEY } from "./internal/EncryptedConstant";
+import { get_path_and_stringify } from "./internal/get_path_and_stringify";
+import { headers_to_object } from "./internal/headers_to_object";
+import { route_error } from "./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
+ */
+export namespace EncryptedRoute {
+    /**
+     * Encrypted router decorator function for the GET method.
+     *
+     * @param paths Path(s) of the HTTP request
+     * @returns Method decorator
+     */
+    export const Get = Generator("Get");
+
+    /**
+     * Encrypted router decorator function for the GET method.
+     *
+     * @param paths Path(s) of the HTTP request
+     * @returns Method decorator
+     */
+    export const Post = Generator("Post");
+
+    /**
+     * Encrypted router decorator function for the PATCH method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    export const Patch = Generator("Patch");
+
+    /**
+     * Encrypted router decorator function for the PUT method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    export const Put = Generator("Put");
+
+    /**
+     * Encrypted router decorator function for the DELETE method.
+     *
+     * @param path Path of the HTTP request
+     * @returns Method decorator
+     */
+    export const Delete = Generator("Delete");
+
+    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(
+                `EncryptedRoute.${method}`,
+            )(...args);
+            return applyDecorators(
+                ROUTERS[method](path),
+                UseInterceptors(
+                    new EncryptedRouteInterceptor(method, stringify),
+                ),
+            );
+        }
+        return route;
+    }
+}
+
+for (const method of [
+    assertStringify,
+    isStringify,
+    stringify,
+    validateStringify,
+]) {
+    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);
+}
+
+/**
+ * @internal
+ */
+class EncryptedRouteInterceptor implements NestInterceptor {
+    public constructor(
+        private readonly method: string,
+        private readonly stringify: (input: any) => string,
+    ) {}
+
+    public intercept(
+        context: ExecutionContext,
+        next: CallHandler,
+    ): Observable<any> {
+        const http: HttpArgumentsHost = context.switchToHttp();
+        return next.handle().pipe(
+            map((value) => {
+                const param:
+                    | IEncryptionPassword
+                    | IEncryptionPassword.Closure
+                    | undefined = Reflect.getMetadata(
+                    ENCRYPTION_METADATA_KEY,
+                    context.getClass(),
+                );
+                if (!param)
+                    throw new Error(
+                        `Error on EncryptedRoute.${this.method}(): no encryption password is given.`,
+                    );
+
+                const headers: Singleton<Record<string, string>> =
+                    new Singleton(() => {
+                        const request: express.Request = http.getRequest();
+                        return headers_to_object(request.headers);
+                    });
+                const body: string | undefined = this.stringify(value);
+                const password: IEncryptionPassword =
+                    typeof param === "function"
+                        ? param({ headers: headers.get(), body }, false)
+                        : param;
+                const disabled: boolean =
+                    password.disabled === undefined
+                        ? false
+                        : typeof password.disabled === "function"
+                        ? password.disabled(
+                              { headers: headers.get(), body },
+                              false,
+                          )
+                        : password.disabled;
+
+                const response: express.Response = http.getResponse();
+                response.header(
+                    "Content-Type",
+                    disabled ? "application/json" : "text/plain",
+                );
+
+                if (disabled === true) return body;
+                else if (body === undefined) return body;
+                return AesPkcs5.encrypt(body, password.key, password.iv);
+            }),
+            catchError((err) => route_error(http.getRequest(), err)),
+        );
+    }
+}
+
+/**
+ * @internal
+ */
+const ROUTERS = {
+    Get,
+    Post,
+    Put,
+    Patch,
+    Delete,
+};

package/src/decorators/PlainBody.ts

@@ -1,38 +1,38 @@
-import {
-    BadRequestException,
-    ExecutionContext,
-    createParamDecorator,
-} from "@nestjs/common";
-import type express from "express";
-import raw from "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
- */
-export const PlainBody: () => ParameterDecorator = createParamDecorator(
-    async function PlainBody(_data: any, context: ExecutionContext) {
-        const request: express.Request = context.switchToHttp().getRequest();
-        if (!request.readable) throw new BadRequestException("Invalid body");
-
-        const body: string = (await raw(request)).toString("utf8").trim();
-        return body;
-    },
-);
+import {
+    BadRequestException,
+    ExecutionContext,
+    createParamDecorator,
+} from "@nestjs/common";
+import type express from "express";
+import raw from "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
+ */
+export const PlainBody: () => ParameterDecorator = createParamDecorator(
+    async function PlainBody(_data: any, context: ExecutionContext) {
+        const request: express.Request = context.switchToHttp().getRequest();
+        if (!request.readable) throw new BadRequestException("Invalid body");
+
+        const body: string = (await raw(request)).toString("utf8").trim();
+        return body;
+    },
+);

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);