@nestia/core 3.0.0-dev.20231209 → 3.0.0

package/src/decorators/internal/get_path_and_stringify.ts

@@ -1,91 +1,91 @@
-import { InternalServerErrorException } from "@nestjs/common";
-import typia, { IValidation, TypeGuardError } from "typia";
-
-import { IResponseBodyStringifier } from "../../options/IResponseBodyStringifier";
-import { NoTransformConfigureError } from "./NoTransformConfigureError";
-
-/**
- * @internal
- */
-export const get_path_and_stringify =
-  (method: string) =>
-  (...args: any[]): [string | string[] | undefined, (input: any) => string] => {
-    const path: string | string[] | null | undefined =
-      args[0] === undefined ||
-      typeof args[0] === "string" ||
-      Array.isArray(args[0])
-        ? args[0]
-        : null;
-    const functor: IResponseBodyStringifier<any> | undefined =
-      path === null ? args[0] : args[1];
-    return [path ?? undefined, take(method)(functor)];
-  };
-
-/**
- * @internal
- */
-const take =
-  (method: string) =>
-  <T>(functor?: IResponseBodyStringifier<T> | null) => {
-    if (functor === undefined) throw NoTransformConfigureError(method);
-    else if (functor === null) return JSON.stringify;
-    else if (functor.type === "stringify") return functor.stringify;
-    else if (functor.type === "assert") return assert(functor.assert);
-    else if (functor.type === "is") return is(functor.is);
-    else if (functor.type === "validate") return validate(functor.validate);
-    throw new Error(
-      `Error on nestia.core.${method}(): invalid typed stringify function.`,
-    );
-  };
-
-/**
- * @internal
- */
-const assert =
-  <T>(closure: (data: T) => string) =>
-  (data: T) => {
-    try {
-      return closure(data);
-    } catch (exp) {
-      if (typia.is<TypeGuardError>(exp))
-        throw new InternalServerErrorException({
-          path: exp.path,
-          reason: exp.message,
-          expected: exp.expected,
-          value: exp.value,
-          message: MESSAGE,
-        });
-      throw exp;
-    }
-  };
-
-/**
- * @internal
- */
-const is =
-  <T>(closure: (data: T) => string | null) =>
-  (data: T) => {
-    const result: string | null = closure(data);
-    if (result === null) throw new InternalServerErrorException(MESSAGE);
-    return result;
-  };
-
-/**
- * @internal
- */
-const validate =
-  <T>(closure: (data: T) => IValidation<string>) =>
-  (data: T) => {
-    const result: IValidation<string> = closure(data);
-    if (result.success === false)
-      throw new InternalServerErrorException({
-        errors: result.errors,
-        message: MESSAGE,
-      });
-    return result.data;
-  };
-
-/**
- * @internal
- */
-const MESSAGE = "Response body data is not following the promised type.";
+import { InternalServerErrorException } from "@nestjs/common";
+import typia, { IValidation, TypeGuardError } from "typia";
+
+import { IResponseBodyStringifier } from "../../options/IResponseBodyStringifier";
+import { NoTransformConfigureError } from "./NoTransformConfigureError";
+
+/**
+ * @internal
+ */
+export const get_path_and_stringify =
+  (method: string) =>
+  (...args: any[]): [string | string[] | undefined, (input: any) => string] => {
+    const path: string | string[] | null | undefined =
+      args[0] === undefined ||
+      typeof args[0] === "string" ||
+      Array.isArray(args[0])
+        ? args[0]
+        : null;
+    const functor: IResponseBodyStringifier<any> | undefined =
+      path === null ? args[0] : args[1];
+    return [path ?? undefined, take(method)(functor)];
+  };
+
+/**
+ * @internal
+ */
+const take =
+  (method: string) =>
+  <T>(functor?: IResponseBodyStringifier<T> | null) => {
+    if (functor === undefined) throw NoTransformConfigureError(method);
+    else if (functor === null) return JSON.stringify;
+    else if (functor.type === "stringify") return functor.stringify;
+    else if (functor.type === "assert") return assert(functor.assert);
+    else if (functor.type === "is") return is(functor.is);
+    else if (functor.type === "validate") return validate(functor.validate);
+    throw new Error(
+      `Error on nestia.core.${method}(): invalid typed stringify function.`,
+    );
+  };
+
+/**
+ * @internal
+ */
+const assert =
+  <T>(closure: (data: T) => string) =>
+  (data: T) => {
+    try {
+      return closure(data);
+    } catch (exp) {
+      if (typia.is<TypeGuardError>(exp))
+        throw new InternalServerErrorException({
+          path: exp.path,
+          reason: exp.message,
+          expected: exp.expected,
+          value: exp.value,
+          message: MESSAGE,
+        });
+      throw exp;
+    }
+  };
+
+/**
+ * @internal
+ */
+const is =
+  <T>(closure: (data: T) => string | null) =>
+  (data: T) => {
+    const result: string | null = closure(data);
+    if (result === null) throw new InternalServerErrorException(MESSAGE);
+    return result;
+  };
+
+/**
+ * @internal
+ */
+const validate =
+  <T>(closure: (data: T) => IValidation<string>) =>
+  (data: T) => {
+    const result: IValidation<string> = closure(data);
+    if (result.success === false)
+      throw new InternalServerErrorException({
+        errors: result.errors,
+        message: MESSAGE,
+      });
+    return result.data;
+  };
+
+/**
+ * @internal
+ */
+const MESSAGE = "Response body data is not following the promised type.";

package/src/decorators/internal/get_text_body.ts

@@ -1,20 +1,20 @@
-import type express from "express";
-import type { FastifyRequest } from "fastify";
-import raw from "raw-body";
-
-/**
- * @internal
- */
-export const get_text_body = async (
-  request: express.Request | FastifyRequest,
-): Promise<string> =>
-  isExpressRequest(request)
-    ? (await raw(request)).toString("utf8")
-    : (request.body as string);
-
-/**
- * @internal
- */
-const isExpressRequest = (
-  request: express.Request | FastifyRequest,
-): request is express.Request => (request as express.Request).app !== undefined;
+import type express from "express";
+import type { FastifyRequest } from "fastify";
+import raw from "raw-body";
+
+/**
+ * @internal
+ */
+export const get_text_body = async (
+  request: express.Request | FastifyRequest,
+): Promise<string> =>
+  isExpressRequest(request)
+    ? (await raw(request)).toString("utf8")
+    : (request.body as string);
+
+/**
+ * @internal
+ */
+const isExpressRequest = (
+  request: express.Request | FastifyRequest,
+): request is express.Request => (request as express.Request).app !== undefined;

package/src/decorators/internal/headers_to_object.ts

@@ -1,13 +1,13 @@
-import http from "http";
-
-/**
- * @internal
- */
-export function headers_to_object(
-  headers: http.IncomingHttpHeaders,
-): Record<string, string> {
-  const output: Record<string, string> = {};
-  for (const [key, value] of Object.entries(headers))
-    output[key] = value instanceof Array ? value[0] : value || "";
-  return output;
-}
+import http from "http";
+
+/**
+ * @internal
+ */
+export function headers_to_object(
+  headers: http.IncomingHttpHeaders,
+): Record<string, string> {
+  const output: Record<string, string> = {};
+  for (const [key, value] of Object.entries(headers))
+    output[key] = value instanceof Array ? value[0] : value || "";
+  return output;
+}

package/src/decorators/internal/load_controller.ts

@@ -1,51 +1,51 @@
-import is_ts_node from "detect-ts-node";
-
-import { Creator } from "../../typings/Creator";
-import { SourceFinder } from "../../utils/SourceFinder";
-
-/**
- * @internal
- */
-export const load_controllers = async (
-  path: string | string[] | { include: string[]; exclude?: string[] },
-): Promise<Creator<object>[]> => {
-  const sources: string[] = await SourceFinder.find({
-    include: Array.isArray(path)
-      ? path
-      : typeof path === "object"
-      ? path.include
-      : [path],
-    exclude:
-      typeof path === "object" && !Array.isArray(path)
-        ? path.exclude ?? []
-        : [],
-    filter:
-      EXTENSION === "ts"
-        ? (file) =>
-            file.substring(file.length - 3) === ".ts" &&
-            file.substring(file.length - 5) !== ".d.ts"
-        : (flle) => flle.substring(flle.length - 3) === ".js",
-  });
-  return mount(sources);
-};
-
-/**
- * @internal
- */
-async function mount(sources: string[]): Promise<any[]> {
-  const controllers: any[] = [];
-  for (const file of sources) {
-    const external: any = await import(file);
-    for (const key in external) {
-      const instance: Creator<object> = external[key];
-      if (Reflect.getMetadata("path", instance) !== undefined)
-        controllers.push(instance);
-    }
-  }
-  return controllers;
-}
-
-/**
- * @internal
- */
-const EXTENSION = is_ts_node ? "ts" : "js";
+import is_ts_node from "detect-ts-node";
+
+import { Creator } from "../../typings/Creator";
+import { SourceFinder } from "../../utils/SourceFinder";
+
+/**
+ * @internal
+ */
+export const load_controllers = async (
+  path: string | string[] | { include: string[]; exclude?: string[] },
+): Promise<Creator<object>[]> => {
+  const sources: string[] = await SourceFinder.find({
+    include: Array.isArray(path)
+      ? path
+      : typeof path === "object"
+        ? path.include
+        : [path],
+    exclude:
+      typeof path === "object" && !Array.isArray(path)
+        ? path.exclude ?? []
+        : [],
+    filter:
+      EXTENSION === "ts"
+        ? (file) =>
+            file.substring(file.length - 3) === ".ts" &&
+            file.substring(file.length - 5) !== ".d.ts"
+        : (flle) => flle.substring(flle.length - 3) === ".js",
+  });
+  return mount(sources);
+};
+
+/**
+ * @internal
+ */
+async function mount(sources: string[]): Promise<any[]> {
+  const controllers: any[] = [];
+  for (const file of sources) {
+    const external: any = await import(file);
+    for (const key in external) {
+      const instance: Creator<object> = external[key];
+      if (Reflect.getMetadata("path", instance) !== undefined)
+        controllers.push(instance);
+    }
+  }
+  return controllers;
+}
+
+/**
+ * @internal
+ */
+const EXTENSION = is_ts_node ? "ts" : "js";

package/src/decorators/internal/route_error.ts

@@ -1,45 +1,45 @@
-import { HttpException } from "@nestjs/common";
-import express from "express";
-import type { FastifyRequest } from "fastify";
-import { throwError } from "rxjs";
-
-import { ExceptionManager } from "../../utils/ExceptionManager";
-
-/**
- * @internal
- */
-export function route_error(
-  request: express.Request | FastifyRequest,
-  error: any,
-) {
-  error = (() => {
-    // HTTP-ERROR
-    if (error instanceof HttpException) return error;
-
-    // CUSTOM-REGISTERED ERROR
-    for (const [creator, closure] of ExceptionManager.tuples)
-      if (error instanceof creator) return closure(error);
-
-    // MAYBE INTERNAL ERROR
-    return error;
-  })();
-
-  try {
-    error.method = request.method;
-    error.path =
-      (request as express.Request).path ??
-      (request as FastifyRequest).routeOptions?.url ??
-      (request as FastifyRequest).routerPath;
-  } catch {}
-
-  setTimeout(() => {
-    for (const listener of ExceptionManager.listeners) {
-      try {
-        const res: any | Promise<any> = listener(error);
-        if (typeof res === "object" && typeof res.catch === "function")
-          res.catch(() => {});
-      } catch {}
-    }
-  }, 0);
-  return throwError(() => error);
-}
+import { HttpException } from "@nestjs/common";
+import express from "express";
+import type { FastifyRequest } from "fastify";
+import { throwError } from "rxjs";
+
+import { ExceptionManager } from "../../utils/ExceptionManager";
+
+/**
+ * @internal
+ */
+export function route_error(
+  request: express.Request | FastifyRequest,
+  error: any,
+) {
+  error = (() => {
+    // HTTP-ERROR
+    if (error instanceof HttpException) return error;
+
+    // CUSTOM-REGISTERED ERROR
+    for (const [creator, closure] of ExceptionManager.tuples)
+      if (error instanceof creator) return closure(error);
+
+    // MAYBE INTERNAL ERROR
+    return error;
+  })();
+
+  try {
+    error.method = request.method;
+    error.path =
+      (request as express.Request).path ??
+      (request as FastifyRequest).routeOptions?.url ??
+      (request as FastifyRequest).routerPath;
+  } catch {}
+
+  setTimeout(() => {
+    for (const listener of ExceptionManager.listeners) {
+      try {
+        const res: any | Promise<any> = listener(error);
+        if (typeof res === "object" && typeof res.catch === "function")
+          res.catch(() => {});
+      } catch {}
+    }
+  }, 0);
+  return throwError(() => error);
+}

package/src/decorators/internal/validate_request_body.ts

@@ -1,57 +1,72 @@
-import { BadRequestException } from "@nestjs/common";
-import typia, { IValidation, TypeGuardError } from "typia";
-
-import { IRequestBodyValidator } from "../../options/IRequestBodyValidator";
-import { NoTransformConfigureError } from "./NoTransformConfigureError";
-
-export const validate_request_body =
-  (method: string) =>
-  <T>(validator?: IRequestBodyValidator<T>) => {
-    if (!validator) return () => NoTransformConfigureError(method);
-    else if (validator.type === "assert") return assert(validator.assert);
-    else if (validator.type === "is") return is(validator.is);
-    else if (validator.type === "validate") return validate(validator.validate);
-    return () =>
-      new Error(`Error on nestia.core.${method}(): invalid typed validator.`);
-  };
-
-const assert =
-  <T>(closure: (data: T) => T) =>
-  (input: T) => {
-    try {
-      closure(input);
-      return null;
-    } catch (exp) {
-      if (typia.is<TypeGuardError>(exp)) {
-        return new BadRequestException({
-          path: exp.path,
-          reason: exp.message,
-          expected: exp.expected,
-          value: exp.value,
-          message: MESSAGE,
-        });
-      }
-      throw exp;
-    }
-  };
-
-const is =
-  <T>(closure: (data: T) => boolean) =>
-  (input: T) => {
-    const success: boolean = closure(input);
-    return success ? null : new BadRequestException(MESSAGE);
-  };
-
-const validate =
-  <T>(closure: (data: T) => IValidation<T>) =>
-  (input: T) => {
-    const result: IValidation<T> = closure(input);
-    return result.success
-      ? null
-      : new BadRequestException({
-          errors: result.errors,
-          message: MESSAGE,
-        });
-  };
-
-const MESSAGE = "Request body data is not following the promised type.";
+import { BadRequestException } from "@nestjs/common";
+import typia, { IValidation, TypeGuardError } from "typia";
+
+import { IRequestBodyValidator } from "../../options/IRequestBodyValidator";
+import { NoTransformConfigureError } from "./NoTransformConfigureError";
+
+/**
+ * @internal
+ */
+export const validate_request_body =
+  (method: string) =>
+  <T>(validator?: IRequestBodyValidator<T>) => {
+    if (!validator) return () => NoTransformConfigureError(method);
+    else if (validator.type === "assert") return assert(validator.assert);
+    else if (validator.type === "is") return is(validator.is);
+    else if (validator.type === "validate") return validate(validator.validate);
+    return () =>
+      new Error(`Error on nestia.core.${method}(): invalid typed validator.`);
+  };
+
+/**
+ * @internal
+ */
+const assert =
+  <T>(closure: (data: T) => T) =>
+  (input: T) => {
+    try {
+      closure(input);
+      return null;
+    } catch (exp) {
+      if (typia.is<TypeGuardError>(exp)) {
+        return new BadRequestException({
+          path: exp.path,
+          reason: exp.message,
+          expected: exp.expected,
+          value: exp.value,
+          message: MESSAGE,
+        });
+      }
+      throw exp;
+    }
+  };
+
+/**
+ * @internal
+ */
+const is =
+  <T>(closure: (data: T) => boolean) =>
+  (input: T) => {
+    const success: boolean = closure(input);
+    return success ? null : new BadRequestException(MESSAGE);
+  };
+
+/**
+ * @internal
+ */
+const validate =
+  <T>(closure: (data: T) => IValidation<T>) =>
+  (input: T) => {
+    const result: IValidation<T> = closure(input);
+    return result.success
+      ? null
+      : new BadRequestException({
+          errors: result.errors,
+          message: MESSAGE,
+        });
+  };
+
+/**
+ * @internal
+ */
+const MESSAGE = "Request body data is not following the promised type.";

package/src/decorators/internal/validate_request_form_data.ts

@@ -0,0 +1,75 @@
+import { BadRequestException } from "@nestjs/common";
+import typia, { IValidation, TypeGuardError } from "typia";
+
+import { IRequestFormDataProps } from "../../options/IRequestFormDataProps";
+import { NoTransformConfigureError } from "./NoTransformConfigureError";
+
+/**
+ * @internal
+ */
+export const validate_request_form_data = <T>(
+  props?: IRequestFormDataProps<T>,
+) => {
+  if (!props) return () => NoTransformConfigureError("TypedFormData.Bpdu");
+  else if (props.validator.type === "assert")
+    return assert(props.validator.assert);
+  else if (props.validator.type === "is") return is(props.validator.is);
+  else if (props.validator.type === "validate")
+    return validate(props.validator.validate);
+  return () =>
+    new Error(
+      `Error on nestia.core.TypedFormData.Body(): invalid typed validator.`,
+    );
+};
+
+/**
+ * @internal
+ */
+const assert =
+  <T>(closure: (input: FormData) => T) =>
+  (input: FormData): T | BadRequestException => {
+    try {
+      return closure(input);
+    } catch (exp) {
+      if (typia.is<TypeGuardError>(exp)) {
+        return new BadRequestException({
+          path: exp.path,
+          reason: exp.message,
+          expected: exp.expected,
+          value: exp.value,
+          message: MESSAGE,
+        });
+      }
+      throw exp;
+    }
+  };
+
+/**
+ * @internal
+ */
+const is =
+  <T>(closure: (input: FormData) => T | null) =>
+  (input: FormData): T | BadRequestException => {
+    const result: T | null = closure(input);
+    return result !== null ? result : new BadRequestException(MESSAGE);
+  };
+
+/**
+ * @internal
+ */
+const validate =
+  <T>(closure: (input: FormData) => IValidation<T>) =>
+  (input: FormData): T | BadRequestException => {
+    const result: IValidation<T> = closure(input);
+    return result.success
+      ? result.data
+      : new BadRequestException({
+          errors: result.errors,
+          message: MESSAGE,
+        });
+  };
+
+/**
+ * @internal
+ */
+const MESSAGE = "Request multipart data is not following the promised type.";