@nestia/core 3.1.0-dev.20240429 → 3.1.0-dev.20240430-2

package/src/decorators/TypedHeaders.ts

@@ -1,69 +1,69 @@
-import { ExecutionContext, createParamDecorator } from "@nestjs/common";
-import type express from "express";
-import type { FastifyRequest } from "fastify";
-import typia from "typia";
-
-import { IRequestHeadersValidator } from "../options/IRequestHeadersValidator";
-import { validate_request_headers } from "./internal/validate_request_headers";
-
-/**
- * Type safe HTTP headers decorator.
- *
- * `TypedHeaders` is a decorator function that can parse HTTP headers. It is almost
- * same with {@link nest.Headers}, but it can automatically cast property type following
- * its DTO definition. Also, `TypedHeaders` performs type validation.
- *
- * For reference, target type `T` must follow such restrictions. Also, if actual HTTP
- * header values are different with their promised type `T`, `BadRequestException`
- * error (status code: 400) would be thrown.
- *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
- * 3. Property key must be lower case
- * 4. Property value cannot be `null`, but `undefined` is possible
- * 5. Only `boolean`, `bigint`, `number`, `string` or their array types are allowed
- * 6. By the way, union type never be not allowed
- * 7. Property `set-cookie` must be array type
- * 8. Those properties cannot be array type
- *   - age
- *   - authorization
- *   - content-length
- *   - content-type
- *   - etag
- *   - expires
- *   - from
- *   - host
- *   - if-modified-since
- *   - if-unmodified-since
- *   - last-modified
- *   - location
- *   - max-forwards
- *   - proxy-authorization
- *   - referer
- *   - retry-after
- *   - server
- *   - user-agent
- *
- * @returns Parameter decorator
- * @author Jeongho Nam - https://github.com/samchon
- */
-export function TypedHeaders<T extends object>(
-  validator?: IRequestHeadersValidator<T>,
-): ParameterDecorator {
-  const checker = validate_request_headers(validator);
-  return createParamDecorator(function TypedHeaders(
-    _unknown: any,
-    context: ExecutionContext,
-  ) {
-    const request: express.Request | FastifyRequest = context
-      .switchToHttp()
-      .getRequest();
-
-    const output: T | Error = checker(request.headers);
-    if (output instanceof Error) throw output;
-    return output;
-  })();
-}
-Object.assign(TypedHeaders, typia.http.assertHeaders);
-Object.assign(TypedHeaders, typia.http.isHeaders);
-Object.assign(TypedHeaders, typia.http.validateHeaders);
+import { ExecutionContext, createParamDecorator } from "@nestjs/common";
+import type express from "express";
+import type { FastifyRequest } from "fastify";
+import typia from "typia";
+
+import { IRequestHeadersValidator } from "../options/IRequestHeadersValidator";
+import { validate_request_headers } from "./internal/validate_request_headers";
+
+/**
+ * Type safe HTTP headers decorator.
+ *
+ * `TypedHeaders` is a decorator function that can parse HTTP headers. It is almost
+ * same with {@link nest.Headers}, but it can automatically cast property type following
+ * its DTO definition. Also, `TypedHeaders` performs type validation.
+ *
+ * For reference, target type `T` must follow such restrictions. Also, if actual HTTP
+ * header values are different with their promised type `T`, `BadRequestException`
+ * error (status code: 400) would be thrown.
+ *
+ * 1. Type `T` must be an object type
+ * 2. Do not allow dynamic property
+ * 3. Property key must be lower case
+ * 4. Property value cannot be `null`, but `undefined` is possible
+ * 5. Only `boolean`, `bigint`, `number`, `string` or their array types are allowed
+ * 6. By the way, union type never be not allowed
+ * 7. Property `set-cookie` must be array type
+ * 8. Those properties cannot be array type
+ *   - age
+ *   - authorization
+ *   - content-length
+ *   - content-type
+ *   - etag
+ *   - expires
+ *   - from
+ *   - host
+ *   - if-modified-since
+ *   - if-unmodified-since
+ *   - last-modified
+ *   - location
+ *   - max-forwards
+ *   - proxy-authorization
+ *   - referer
+ *   - retry-after
+ *   - server
+ *   - user-agent
+ *
+ * @returns Parameter decorator
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export function TypedHeaders<T extends object>(
+  validator?: IRequestHeadersValidator<T>,
+): ParameterDecorator {
+  const checker = validate_request_headers(validator);
+  return createParamDecorator(function TypedHeaders(
+    _unknown: any,
+    context: ExecutionContext,
+  ) {
+    const request: express.Request | FastifyRequest = context
+      .switchToHttp()
+      .getRequest();
+
+    const output: T | Error = checker(request.headers);
+    if (output instanceof Error) throw output;
+    return output;
+  })();
+}
+Object.assign(TypedHeaders, typia.http.assertHeaders);
+Object.assign(TypedHeaders, typia.http.isHeaders);
+Object.assign(TypedHeaders, typia.http.validateHeaders);

package/src/decorators/TypedParam.ts

@@ -1,64 +1,64 @@
-import {
-  BadRequestException,
-  ExecutionContext,
-  createParamDecorator,
-} from "@nestjs/common";
-import type express from "express";
-import type { FastifyRequest } from "fastify";
-import typia, { TypeGuardError } from "typia";
-
-import { NoTransformConfigureError } from "./internal/NoTransformConfigureError";
-
-/**
- * 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, and validates it.
- *
- * ```typescript
- * import { tags } from "typia";
- *
- * \@TypedRoute.Get("shopping/sales/:id/:no/:paused")
- * public async pause(
- *   \@TypedParam("id", "uuid"), id: string & tags.Format<"uuid">,
- *   \@TypedParam("no") id: number & tags.Type<"uint32">
- *   \@TypedParam("paused") paused: boolean | null
- * ): Promise<void>;
- * ```
- *
- * @param name URL Parameter name
- * @returns Parameter decorator
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export function TypedParam<T extends boolean | bigint | number | string | null>(
-  name: string,
-  assert?: (value: string) => T,
-): ParameterDecorator {
-  if (assert === undefined) throw NoTransformConfigureError("TypedParam");
-
-  return createParamDecorator(function TypedParam(
-    {}: any,
-    context: ExecutionContext,
-  ) {
-    const request: express.Request | FastifyRequest = context
-      .switchToHttp()
-      .getRequest();
-    const str: string = (request.params as any)[name];
-    try {
-      return assert(str);
-    } catch (exp) {
-      if (typia.is<TypeGuardError>(exp))
-        throw new BadRequestException({
-          path: exp.path,
-          reason: exp.message,
-          expected: exp.expected,
-          value: exp.value,
-          message: `Invalid URL parameter value on "${name}".`,
-        });
-      throw exp;
-    }
-  })(name);
-}
-Object.assign(TypedParam, typia.http.parameter);
+import {
+  BadRequestException,
+  ExecutionContext,
+  createParamDecorator,
+} from "@nestjs/common";
+import type express from "express";
+import type { FastifyRequest } from "fastify";
+import typia, { TypeGuardError } from "typia";
+
+import { NoTransformConfigureError } from "./internal/NoTransformConfigureError";
+
+/**
+ * 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, and validates it.
+ *
+ * ```typescript
+ * import { tags } from "typia";
+ *
+ * \@TypedRoute.Get("shopping/sales/:id/:no/:paused")
+ * public async pause(
+ *   \@TypedParam("id", "uuid"), id: string & tags.Format<"uuid">,
+ *   \@TypedParam("no") id: number & tags.Type<"uint32">
+ *   \@TypedParam("paused") paused: boolean | null
+ * ): Promise<void>;
+ * ```
+ *
+ * @param name URL Parameter name
+ * @returns Parameter decorator
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export function TypedParam<T extends boolean | bigint | number | string | null>(
+  name: string,
+  assert?: (value: string) => T,
+): ParameterDecorator {
+  if (assert === undefined) throw NoTransformConfigureError("TypedParam");
+
+  return createParamDecorator(function TypedParam(
+    {}: any,
+    context: ExecutionContext,
+  ) {
+    const request: express.Request | FastifyRequest = context
+      .switchToHttp()
+      .getRequest();
+    const str: string = (request.params as any)[name];
+    try {
+      return assert(str);
+    } catch (exp) {
+      if (typia.is<TypeGuardError>(exp))
+        throw new BadRequestException({
+          path: exp.path,
+          reason: exp.message,
+          expected: exp.expected,
+          value: exp.value,
+          message: `Invalid URL parameter value on "${name}".`,
+        });
+      throw exp;
+    }
+  })(name);
+}
+Object.assign(TypedParam, typia.http.parameter);

package/src/decorators/TypedRoute.ts

@@ -1,144 +1,144 @@
-import {
-  CallHandler,
-  Delete,
-  ExecutionContext,
-  Get,
-  NestInterceptor,
-  Patch,
-  Post,
-  Put,
-  UseInterceptors,
-  applyDecorators,
-} from "@nestjs/common";
-import { HttpArgumentsHost } from "@nestjs/common/interfaces";
-import type express from "express";
-import { catchError, map } from "rxjs/operators";
-import typia 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";
-
-/**
- * Type safe router decorator functions.
- *
- * `TypedRoute` is a module containing router decorator functions which can boost up
- * JSON string conversion speed about 200x times faster than `class-transformer`.
- * Furthermore, such JSON string conversion is even type safe through
- * [typia](https://github.com/samchon/typia).
- *
- * For reference, if you try to invalid data that is not following the promised
- * type `T`, 500 internal server error would be thrown. Also, as `TypedRoute` composes
- * JSON string through `typia.assertStringify<T>()` function, it is not possible to
- * modify response data through interceptors.
- *
- * @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 [
-  typia.json.stringify,
-  typia.json.isStringify,
-  typia.json.assertStringify,
-  typia.json.validateStringify,
-])
-  for (const [key, value] of Object.entries(method))
-    for (const deco of [
-      TypedRoute.Get,
-      TypedRoute.Delete,
-      TypedRoute.Post,
-      TypedRoute.Put,
-      TypedRoute.Patch,
-    ])
-      (deco as any)[key] = value;
-
-/**
- * @internal
- */
-class TypedRouteInterceptor implements NestInterceptor {
-  public constructor(private readonly stringify: (input: any) => string) {}
-
-  public intercept(context: ExecutionContext, next: CallHandler) {
-    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 type express from "express";
+import { catchError, map } from "rxjs/operators";
+import typia 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";
+
+/**
+ * Type safe router decorator functions.
+ *
+ * `TypedRoute` is a module containing router decorator functions which can boost up
+ * JSON string conversion speed about 200x times faster than `class-transformer`.
+ * Furthermore, such JSON string conversion is even type safe through
+ * [typia](https://github.com/samchon/typia).
+ *
+ * For reference, if you try to invalid data that is not following the promised
+ * type `T`, 500 internal server error would be thrown. Also, as `TypedRoute` composes
+ * JSON string through `typia.assertStringify<T>()` function, it is not possible to
+ * modify response data through interceptors.
+ *
+ * @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 [
+  typia.json.stringify,
+  typia.json.isStringify,
+  typia.json.assertStringify,
+  typia.json.validateStringify,
+])
+  for (const [key, value] of Object.entries(method))
+    for (const deco of [
+      TypedRoute.Get,
+      TypedRoute.Delete,
+      TypedRoute.Post,
+      TypedRoute.Put,
+      TypedRoute.Patch,
+    ])
+      (deco as any)[key] = value;
+
+/**
+ * @internal
+ */
+class TypedRouteInterceptor implements NestInterceptor {
+  public constructor(private readonly stringify: (input: any) => string) {}
+
+  public intercept(context: ExecutionContext, next: CallHandler) {
+    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";

package/src/decorators/internal/NoTransformConfigureError.ts

@@ -1,8 +1,8 @@
-/**
- * @internal
- */
-export function NoTransformConfigureError(method: string): Error {
-  return new Error(
-    `Error on nestia.core.${method}(): no transform has been configured. Run "npx typia setup" command, or check if you're using non-standard TypeScript compiler like Babel or SWC.`,
-  );
-}
+/**
+ * @internal
+ */
+export function NoTransformConfigureError(method: string): Error {
+  return new Error(
+    `Error on nestia.core.${method}(): no transform has been configured. Run "npx typia setup" command, or check if you're using non-standard TypeScript compiler like Babel or SWC.`,
+  );
+}