@nestia/core 11.0.0-dev.20260312 → 11.0.0-dev.20260313-2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/core",
-  "version": "11.0.0-dev.20260312",
+  "version": "11.0.0-dev.20260313-2",
   "description": "Super-fast validation decorators of NestJS",
   "main": "lib/index.js",
   "exports": {
@@ -39,9 +39,9 @@
   },
   "homepage": "https://nestia.io",
   "dependencies": {
-    "@typia/core": "12.0.0-dev.20260312-2",
-    "@typia/interface": "12.0.0-dev.20260312-2",
-    "@typia/utils": "12.0.0-dev.20260312-2",
+    "@typia/core": "12.0.0-dev.20260313",
+    "@typia/interface": "12.0.0-dev.20260313",
+    "@typia/utils": "12.0.0-dev.20260313",
     "detect-ts-node": "^1.0.5",
     "get-function-location": "^2.0.0",
     "glob": "^11.0.3",
@@ -50,17 +50,17 @@
     "reflect-metadata": ">=0.1.12",
     "rxjs": ">=6.0.3",
     "tgrid": "^1.1.0",
-    "typia": "12.0.0-dev.20260312-2",
+    "typia": "12.0.0-dev.20260313",
     "ws": "^7.5.3",
-    "@nestia/fetcher": "^11.0.0-dev.20260312"
+    "@nestia/fetcher": "^11.0.0-dev.20260313-2"
   },
   "peerDependencies": {
     "@nestjs/common": ">=7.0.1",
     "@nestjs/core": ">=7.0.1",
     "reflect-metadata": ">=0.1.12",
     "rxjs": ">=6.0.3",
-    "typia": "12.0.0-dev.20260312-2",
-    "@nestia/fetcher": "^11.0.0-dev.20260312"
+    "typia": "12.0.0-dev.20260313",
+    "@nestia/fetcher": "^11.0.0-dev.20260313-2"
   },
   "devDependencies": {
     "@nestjs/common": "^11.1.4",

package/src/decorators/DynamicModule.ts

@@ -1,44 +1,44 @@
-import { Module } from "@nestjs/common";
-import { ModuleMetadata } from "@nestjs/common/interfaces";
-
-import { Creator } from "../typings/Creator";
-import { load_controllers } from "./internal/load_controller";
-
-/**
- * Dynamic module.
- *
- * `DynamicModule` is a namespace wrapping a convenient function, which can load
- * controller classes dynamically just by specifying their directory path.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace DynamicModule {
-  /**
-   * Mount dynamic module.
-   *
-   * Constructs a module instance with directory path of controller classes.
-   *
-   * Every controller classes in the target directory would be dynamically
-   * mounted.
-   *
-   * @param path Path of controllers
-   * @param metadata Additional metadata except controllers
-   * @returns Module instance
-   */
-  export async function mount(
-    path: string | string[] | { include: string[]; exclude?: string[] },
-    metadata: Omit<ModuleMetadata, "controllers"> = {},
-    isTsNode?: boolean,
-  ) {
-    // LOAD CONTROLLERS
-    const controllers: Creator<object>[] = await load_controllers(
-      path,
-      isTsNode,
-    );
-
-    // RETURN WITH DECORATING
-    @Module({ ...metadata, controllers })
-    class NestiaModule {}
-    return NestiaModule;
-  }
-}
+import { Module } from "@nestjs/common";
+import { ModuleMetadata } from "@nestjs/common/interfaces";
+
+import { Creator } from "../typings/Creator";
+import { load_controllers } from "./internal/load_controller";
+
+/**
+ * Dynamic module.
+ *
+ * `DynamicModule` is a namespace wrapping a convenient function, which can load
+ * controller classes dynamically just by specifying their directory path.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export namespace DynamicModule {
+  /**
+   * Mount dynamic module.
+   *
+   * Constructs a module instance with directory path of controller classes.
+   *
+   * Every controller classes in the target directory would be dynamically
+   * mounted.
+   *
+   * @param path Path of controllers
+   * @param metadata Additional metadata except controllers
+   * @returns Module instance
+   */
+  export async function mount(
+    path: string | string[] | { include: string[]; exclude?: string[] },
+    metadata: Omit<ModuleMetadata, "controllers"> = {},
+    isTsNode?: boolean,
+  ) {
+    // LOAD CONTROLLERS
+    const controllers: Creator<object>[] = await load_controllers(
+      path,
+      isTsNode,
+    );
+
+    // RETURN WITH DECORATING
+    @Module({ ...metadata, controllers })
+    class NestiaModule {}
+    return NestiaModule;
+  }
+}

package/src/decorators/PlainBody.ts

@@ -1,76 +1,76 @@
-import {
-  BadRequestException,
-  ExecutionContext,
-  createParamDecorator,
-} from "@nestjs/common";
-import type express from "express";
-import type { FastifyRequest } from "fastify";
-
-import { get_text_body } from "./internal/get_text_body";
-import { is_request_body_undefined } from "./internal/is_request_body_undefined";
-import { validate_request_body } from "./internal/validate_request_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;
- * ```
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @returns Parameter decorator
- */
-export function PlainBody(): ParameterDecorator;
-
-/** @internal */
-export function PlainBody(
-  assert?: (input: unknown) => string,
-): ParameterDecorator {
-  const checker = assert
-    ? validate_request_body("PlainBody")({
-        type: "assert",
-        assert,
-      })
-    : null;
-  return createParamDecorator(async function PlainBody(
-    _data: any,
-    context: ExecutionContext,
-  ) {
-    const request: express.Request | FastifyRequest = context
-      .switchToHttp()
-      .getRequest();
-    if (
-      is_request_body_undefined(request) &&
-      (checker ?? (() => null))(undefined as any) === null
-    )
-      return undefined;
-    else if (!isTextPlain(request.headers["content-type"]))
-      throw new BadRequestException(`Request body type is not "text/plain".`);
-    const value: string = await get_text_body(request);
-    if (checker) {
-      const error: Error | null = checker(value);
-      if (error !== null) throw error;
-    }
-    return value;
-  })();
-}
-
-/** @internal */
-const isTextPlain = (text?: string): boolean =>
-  text !== undefined &&
-  text
-    .split(";")
-    .map((str) => str.trim())
-    .some((str) => str === "text/plain");
+import {
+  BadRequestException,
+  ExecutionContext,
+  createParamDecorator,
+} from "@nestjs/common";
+import type express from "express";
+import type { FastifyRequest } from "fastify";
+
+import { get_text_body } from "./internal/get_text_body";
+import { is_request_body_undefined } from "./internal/is_request_body_undefined";
+import { validate_request_body } from "./internal/validate_request_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;
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @returns Parameter decorator
+ */
+export function PlainBody(): ParameterDecorator;
+
+/** @internal */
+export function PlainBody(
+  assert?: (input: unknown) => string,
+): ParameterDecorator {
+  const checker = assert
+    ? validate_request_body("PlainBody")({
+        type: "assert",
+        assert,
+      })
+    : null;
+  return createParamDecorator(async function PlainBody(
+    _data: any,
+    context: ExecutionContext,
+  ) {
+    const request: express.Request | FastifyRequest = context
+      .switchToHttp()
+      .getRequest();
+    if (
+      is_request_body_undefined(request) &&
+      (checker ?? (() => null))(undefined as any) === null
+    )
+      return undefined;
+    else if (!isTextPlain(request.headers["content-type"]))
+      throw new BadRequestException(`Request body type is not "text/plain".`);
+    const value: string = await get_text_body(request);
+    if (checker) {
+      const error: Error | null = checker(value);
+      if (error !== null) throw error;
+    }
+    return value;
+  })();
+}
+
+/** @internal */
+const isTextPlain = (text?: string): boolean =>
+  text !== undefined &&
+  text
+    .split(";")
+    .map((str) => str.trim())
+    .some((str) => str === "text/plain");

package/src/decorators/SwaggerExample.ts

@@ -1,100 +1,100 @@
-export namespace SwaggerExample {
-  export function Response<T>(value: T): MethodDecorator;
-  export function Response<T>(key: string, value: T): MethodDecorator;
-  export function Response(...args: any[]): MethodDecorator {
-    return function SwaggerExampleResponse(
-      _target: Object,
-      _propertyKey: string | symbol,
-      descriptor: TypedPropertyDescriptor<any>,
-    ): TypedPropertyDescriptor<any> {
-      emplaceValue(emplaceOfResponse(descriptor))(args);
-      return descriptor;
-    };
-  }
-
-  export function Parameter<T>(value: T): ParameterDecorator;
-  export function Parameter<T>(key: string, value: T): ParameterDecorator;
-  export function Parameter(...args: any[]): ParameterDecorator {
-    return function SwaggerExampleParameter(
-      target: Object,
-      propertyKey: string | symbol | undefined,
-      index: number,
-    ): void {
-      emplaceValue(emplaceOfParameter(target, propertyKey ?? "", index))(args);
-    };
-  }
-
-  export interface IData<T> {
-    examples?: Record<string, T>;
-    example?: T;
-    index?: number;
-  }
-}
-
-const emplaceValue =
-  <T>(data: SwaggerExample.IData<T>) =>
-  (args: any[]) => {
-    if (args.length === 1) data.example = args[0];
-    else {
-      const key: string = args[0];
-      const value: T = args[1];
-      data.examples ??= {};
-      data.examples[key] = value;
-    }
-  };
-
-const emplaceOfResponse = <T>(
-  descriptor: TypedPropertyDescriptor<any>,
-): SwaggerExample.IData<T> => {
-  const oldbie: SwaggerExample.IData<T> | undefined = Reflect.getMetadata(
-    "nestia/SwaggerExample/Response",
-    descriptor.value,
-  );
-  if (oldbie !== undefined) return oldbie;
-  const newbie: SwaggerExample.IData<T> = {};
-  Reflect.defineMetadata(
-    "nestia/SwaggerExample/Response",
-    newbie,
-    descriptor.value,
-  );
-  return newbie;
-};
-
-const emplaceOfParameter = (
-  target: Object,
-  propertyKey: string | symbol,
-  index: number,
-): SwaggerExample.IData<any> => {
-  const array: SwaggerExample.IData<any>[] = emplaceArrayOfParameters(
-    target,
-    propertyKey,
-  );
-  const oldibe: SwaggerExample.IData<any> | undefined = array.find(
-    (e) => e.index === index,
-  );
-  if (oldibe !== undefined) return oldibe;
-
-  const data: SwaggerExample.IData<any> = { index };
-  array.push(data);
-  return data;
-};
-
-const emplaceArrayOfParameters = (
-  target: Object,
-  propertyKey: string | symbol,
-): SwaggerExample.IData<any>[] => {
-  const array: SwaggerExample.IData<any>[] | undefined = Reflect.getMetadata(
-    "nestia/SwaggerExample/Parameters",
-    target,
-    propertyKey,
-  );
-  if (array !== undefined) return array;
-  const newbie: SwaggerExample.IData<any>[] = [];
-  Reflect.defineMetadata(
-    "nestia/SwaggerExample/Parameters",
-    newbie,
-    target,
-    propertyKey,
-  );
-  return newbie;
-};
+export namespace SwaggerExample {
+  export function Response<T>(value: T): MethodDecorator;
+  export function Response<T>(key: string, value: T): MethodDecorator;
+  export function Response(...args: any[]): MethodDecorator {
+    return function SwaggerExampleResponse(
+      _target: Object,
+      _propertyKey: string | symbol,
+      descriptor: TypedPropertyDescriptor<any>,
+    ): TypedPropertyDescriptor<any> {
+      emplaceValue(emplaceOfResponse(descriptor))(args);
+      return descriptor;
+    };
+  }
+
+  export function Parameter<T>(value: T): ParameterDecorator;
+  export function Parameter<T>(key: string, value: T): ParameterDecorator;
+  export function Parameter(...args: any[]): ParameterDecorator {
+    return function SwaggerExampleParameter(
+      target: Object,
+      propertyKey: string | symbol | undefined,
+      index: number,
+    ): void {
+      emplaceValue(emplaceOfParameter(target, propertyKey ?? "", index))(args);
+    };
+  }
+
+  export interface IData<T> {
+    examples?: Record<string, T>;
+    example?: T;
+    index?: number;
+  }
+}
+
+const emplaceValue =
+  <T>(data: SwaggerExample.IData<T>) =>
+  (args: any[]) => {
+    if (args.length === 1) data.example = args[0];
+    else {
+      const key: string = args[0];
+      const value: T = args[1];
+      data.examples ??= {};
+      data.examples[key] = value;
+    }
+  };
+
+const emplaceOfResponse = <T>(
+  descriptor: TypedPropertyDescriptor<any>,
+): SwaggerExample.IData<T> => {
+  const oldbie: SwaggerExample.IData<T> | undefined = Reflect.getMetadata(
+    "nestia/SwaggerExample/Response",
+    descriptor.value,
+  );
+  if (oldbie !== undefined) return oldbie;
+  const newbie: SwaggerExample.IData<T> = {};
+  Reflect.defineMetadata(
+    "nestia/SwaggerExample/Response",
+    newbie,
+    descriptor.value,
+  );
+  return newbie;
+};
+
+const emplaceOfParameter = (
+  target: Object,
+  propertyKey: string | symbol,
+  index: number,
+): SwaggerExample.IData<any> => {
+  const array: SwaggerExample.IData<any>[] = emplaceArrayOfParameters(
+    target,
+    propertyKey,
+  );
+  const oldibe: SwaggerExample.IData<any> | undefined = array.find(
+    (e) => e.index === index,
+  );
+  if (oldibe !== undefined) return oldibe;
+
+  const data: SwaggerExample.IData<any> = { index };
+  array.push(data);
+  return data;
+};
+
+const emplaceArrayOfParameters = (
+  target: Object,
+  propertyKey: string | symbol,
+): SwaggerExample.IData<any>[] => {
+  const array: SwaggerExample.IData<any>[] | undefined = Reflect.getMetadata(
+    "nestia/SwaggerExample/Parameters",
+    target,
+    propertyKey,
+  );
+  if (array !== undefined) return array;
+  const newbie: SwaggerExample.IData<any>[] = [];
+  Reflect.defineMetadata(
+    "nestia/SwaggerExample/Parameters",
+    newbie,
+    target,
+    propertyKey,
+  );
+  return newbie;
+};

package/src/decorators/TypedBody.ts

@@ -1,57 +1,57 @@
-import {
-  BadRequestException,
-  ExecutionContext,
-  createParamDecorator,
-} from "@nestjs/common";
-import type express from "express";
-import type { FastifyRequest } from "fastify";
-
-import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
-import { is_request_body_undefined } from "./internal/is_request_body_undefined";
-import { validate_request_body } from "./internal/validate_request_body";
-
-/**
- * Type safe body decorator.
- *
- * `TypedBody` is a decorator 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
- * 20,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.
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @param validator Custom validator if required. Default is `typia.assert()`
- */
-export function TypedBody<T>(
-  validator?: IRequestBodyValidator<T>,
-): ParameterDecorator {
-  const checker = validate_request_body("TypedBody")(validator);
-  return createParamDecorator(function TypedBody(
-    _unknown: any,
-    context: ExecutionContext,
-  ) {
-    const request: express.Request | FastifyRequest = context
-      .switchToHttp()
-      .getRequest();
-    if (is_request_body_undefined(request) && checker(undefined as T) === null)
-      return undefined;
-    else if (isApplicationJson(request.headers["content-type"]) === false)
-      throw new BadRequestException(
-        `Request body type is not "application/json".`,
-      );
-
-    const error: Error | null = checker(request.body);
-    if (error !== null) throw error;
-    return request.body;
-  })();
-}
-
-/** @internal */
-const isApplicationJson = (text?: string): boolean =>
-  text !== undefined &&
-  text
-    .split(";")
-    .map((str) => str.trim())
-    .some((str) => str === "application/json");
+import {
+  BadRequestException,
+  ExecutionContext,
+  createParamDecorator,
+} from "@nestjs/common";
+import type express from "express";
+import type { FastifyRequest } from "fastify";
+
+import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
+import { is_request_body_undefined } from "./internal/is_request_body_undefined";
+import { validate_request_body } from "./internal/validate_request_body";
+
+/**
+ * Type safe body decorator.
+ *
+ * `TypedBody` is a decorator 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
+ * 20,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.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param validator Custom validator if required. Default is `typia.assert()`
+ */
+export function TypedBody<T>(
+  validator?: IRequestBodyValidator<T>,
+): ParameterDecorator {
+  const checker = validate_request_body("TypedBody")(validator);
+  return createParamDecorator(function TypedBody(
+    _unknown: any,
+    context: ExecutionContext,
+  ) {
+    const request: express.Request | FastifyRequest = context
+      .switchToHttp()
+      .getRequest();
+    if (is_request_body_undefined(request) && checker(undefined as T) === null)
+      return undefined;
+    else if (isApplicationJson(request.headers["content-type"]) === false)
+      throw new BadRequestException(
+        `Request body type is not "application/json".`,
+      );
+
+    const error: Error | null = checker(request.body);
+    if (error !== null) throw error;
+    return request.body;
+  })();
+}
+
+/** @internal */
+const isApplicationJson = (text?: string): boolean =>
+  text !== undefined &&
+  text
+    .split(";")
+    .map((str) => str.trim())
+    .some((str) => str === "application/json");