@nestia/core 7.3.1 → 7.3.3

package/src/decorators/internal/get_path_and_querify.ts

@@ -4,9 +4,7 @@ import typia, { IValidation, TypeGuardError } from "typia";
 import { IResponseBodyQuerifier } from "../../options/IResponseBodyQuerifier";
 import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
 
-/**
- * @internal
- */
+/** @internal */
 export const get_path_and_querify =
   (method: string) =>
   (
@@ -23,9 +21,7 @@ export const get_path_and_querify =
     return [path ?? undefined, take(method)(functor)];
   };
 
-/**
- * @internal
- */
+/** @internal */
 const take =
   (method: string) =>
   <T>(functor?: IResponseBodyQuerifier<T> | null) => {
@@ -42,9 +38,7 @@ const take =
     );
   };
 
-/**
- * @internal
- */
+/** @internal */
 const querify = (input: Record<string, any>): URLSearchParams => {
   const output: URLSearchParams = new URLSearchParams();
   for (const [key, value] of Object.entries(input))
@@ -55,9 +49,7 @@ const querify = (input: Record<string, any>): URLSearchParams => {
   return output;
 };
 
-/**
- * @internal
- */
+/** @internal */
 const assert =
   <T>(closure: (data: T) => URLSearchParams) =>
   (data: T) => {
@@ -76,9 +68,7 @@ const assert =
     }
   };
 
-/**
- * @internal
- */
+/** @internal */
 const is =
   <T>(closure: (data: T) => URLSearchParams | null) =>
   (data: T) => {
@@ -87,9 +77,7 @@ const is =
     return result;
   };
 
-/**
- * @internal
- */
+/** @internal */
 const validate =
   <T>(closure: (data: T) => IValidation<URLSearchParams>) =>
   (data: T) => {
@@ -102,7 +90,5 @@ const validate =
     return result.data;
   };
 
-/**
- * @internal
- */
+/** @internal */
 const MESSAGE = "Response body data is not following the promised type.";

package/src/decorators/internal/get_path_and_stringify.ts

@@ -5,9 +5,7 @@ import { IResponseBodyStringifier } from "../../options/IResponseBodyStringifier
 import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
 import { TypedRoute } from "../TypedRoute";
 
-/**
- * @internal
- */
+/** @internal */
 export const get_path_and_stringify =
   (logger: () => (log: TypedRoute.IValidateErrorLog) => void) =>
   (method: string) =>
@@ -28,9 +26,7 @@ export const get_path_and_stringify =
     return [path ?? undefined, take(logger)(method)(functor)];
   };
 
-/**
- * @internal
- */
+/** @internal */
 const take =
   (logger: () => (log: TypedRoute.IValidateErrorLog) => void) =>
   (method: string) =>
@@ -53,9 +49,7 @@ const take =
     );
   };
 
-/**
- * @internal
- */
+/** @internal */
 const assert =
   <T>(closure: (data: T) => string) =>
   (data: T): string => {
@@ -74,9 +68,7 @@ const assert =
     }
   };
 
-/**
- * @internal
- */
+/** @internal */
 const is =
   <T>(closure: (data: T) => string | null) =>
   (data: T, _method: string, _path: string) => {
@@ -85,9 +77,7 @@ const is =
     return result;
   };
 
-/**
- * @internal
- */
+/** @internal */
 const validate =
   <T>(closure: (data: T) => IValidation<string>) =>
   (data: T, _method: string, _path: string): string => {
@@ -116,7 +106,5 @@ const validateLog =
     return JSON.stringify(data);
   };
 
-/**
- * @internal
- */
+/** @internal */
 const MESSAGE = "Response body data is not following the promised type.";

package/src/decorators/internal/get_text_body.ts

@@ -2,9 +2,7 @@ import type express from "express";
 import type { FastifyRequest } from "fastify";
 import raw from "raw-body";
 
-/**
- * @internal
- */
+/** @internal */
 export const get_text_body = async (
   request: express.Request | FastifyRequest,
 ): Promise<string> =>
@@ -12,9 +10,7 @@ export const get_text_body = async (
     ? (await raw(request)).toString("utf8")
     : (request.body as string);
 
-/**
- * @internal
- */
+/** @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,8 +1,6 @@
 import http from "http";
 
-/**
- * @internal
- */
+/** @internal */
 export function headers_to_object(
   headers: http.IncomingHttpHeaders,
 ): Record<string, string> {

package/src/decorators/internal/is_request_body_undefined.ts

@@ -1,9 +1,7 @@
 import type express from "express";
 import type { FastifyRequest } from "fastify";
 
-/**
- * @internal
- */
+/** @internal */
 export const is_request_body_undefined = (
   request: express.Request | FastifyRequest,
 ): boolean =>

package/src/decorators/internal/load_controller.ts

@@ -15,7 +15,7 @@ export const load_controllers = async (
         : [path],
     exclude:
       typeof path === "object" && !Array.isArray(path)
-        ? path.exclude ?? []
+        ? (path.exclude ?? [])
         : [],
     filter:
       isTsNode === true || EXTENSION === "ts"
@@ -27,9 +27,7 @@ export const load_controllers = async (
   return mount(sources);
 };
 
-/**
- * @internal
- */
+/** @internal */
 async function mount(sources: string[]): Promise<any[]> {
   const controllers: any[] = [];
   for (const file of sources) {
@@ -43,7 +41,5 @@ async function mount(sources: string[]): Promise<any[]> {
   return controllers;
 }
 
-/**
- * @internal
- */
+/** @internal */
 const EXTENSION = is_ts_node ? "ts" : "js";

package/src/decorators/internal/route_error.ts

@@ -5,9 +5,7 @@ import { throwError } from "rxjs";
 
 import { ExceptionManager } from "../../utils/ExceptionManager";
 
-/**
- * @internal
- */
+/** @internal */
 export function route_error(
   request: express.Request | FastifyRequest,
   error: any,

package/src/decorators/internal/validate_request_body.ts

@@ -4,9 +4,7 @@ import typia, { IValidation, TypeGuardError } from "typia";
 import { IRequestBodyValidator } from "../../options/IRequestBodyValidator";
 import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
 
-/**
- * @internal
- */
+/** @internal */
 export const validate_request_body =
   (method: string) =>
   <T>(validator?: IRequestBodyValidator<T>): ((input: T) => Error | null) => {
@@ -20,9 +18,7 @@ export const validate_request_body =
       new Error(`Error on nestia.core.${method}(): invalid typed validator.`);
   };
 
-/**
- * @internal
- */
+/** @internal */
 const assert =
   <T>(closure: (data: T) => T) =>
   (input: T) => {
@@ -43,9 +39,7 @@ const assert =
     }
   };
 
-/**
- * @internal
- */
+/** @internal */
 const is =
   <T>(closure: (data: T) => boolean) =>
   (input: T) => {
@@ -53,9 +47,7 @@ const is =
     return success ? null : new BadRequestException(MESSAGE);
   };
 
-/**
- * @internal
- */
+/** @internal */
 const validate =
   <T>(closure: (data: T) => IValidation<T>) =>
   (input: T) => {
@@ -68,7 +60,5 @@ const validate =
         });
   };
 
-/**
- * @internal
- */
+/** @internal */
 const MESSAGE = "Request body data is not following the promised type.";

package/src/decorators/internal/validate_request_form_data.ts

@@ -4,9 +4,7 @@ import typia, { IValidation, TypeGuardError } from "typia";
 import { IRequestFormDataProps } from "../../options/IRequestFormDataProps";
 import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
 
-/**
- * @internal
- */
+/** @internal */
 export const validate_request_form_data = <T>(
   props?: IRequestFormDataProps<T>,
 ): ((value: FormData) => T | Error) => {
@@ -24,9 +22,7 @@ export const validate_request_form_data = <T>(
     );
 };
 
-/**
- * @internal
- */
+/** @internal */
 const assert =
   <T>(closure: (input: FormData) => T) =>
   (input: FormData): T | BadRequestException => {
@@ -46,9 +42,7 @@ const assert =
     }
   };
 
-/**
- * @internal
- */
+/** @internal */
 const is =
   <T>(closure: (input: FormData) => T | null) =>
   (input: FormData): T | BadRequestException => {
@@ -56,9 +50,7 @@ const is =
     return result !== null ? result : new BadRequestException(MESSAGE);
   };
 
-/**
- * @internal
- */
+/** @internal */
 const validate =
   <T>(closure: (input: FormData) => IValidation<T>) =>
   (input: FormData): T | BadRequestException => {
@@ -71,7 +63,5 @@ const validate =
         });
   };
 
-/**
- * @internal
- */
+/** @internal */
 const MESSAGE = "Request multipart data is not following the promised type.";

package/src/decorators/internal/validate_request_headers.ts

@@ -4,9 +4,7 @@ import typia, { IValidation, TypeGuardError } from "typia";
 import { IRequestHeadersValidator } from "../../options/IRequestHeadersValidator";
 import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
 
-/**
- * @internal
- */
+/** @internal */
 export const validate_request_headers = <T>(
   validator?: IRequestHeadersValidator<T>,
 ): ((input: Record<string, string | string[] | undefined>) => T | Error) => {
@@ -21,9 +19,7 @@ export const validate_request_headers = <T>(
     new Error(`Error on nestia.core.TypedHeaders(): invalid typed validator.`);
 };
 
-/**
- * @internal
- */
+/** @internal */
 const assert =
   <T>(closure: (input: Record<string, string | string[] | undefined>) => T) =>
   (
@@ -45,9 +41,7 @@ const assert =
     }
   };
 
-/**
- * @internal
- */
+/** @internal */
 const is =
   <T>(
     closure: (input: Record<string, string | string[] | undefined>) => T | null,
@@ -59,9 +53,7 @@ const is =
     return result !== null ? result : new BadRequestException(MESSAGE);
   };
 
-/**
- * @internal
- */
+/** @internal */
 const validate =
   <T>(
     closure: (
@@ -80,7 +72,5 @@ const validate =
         });
   };
 
-/**
- * @internal
- */
+/** @internal */
 const MESSAGE = "Request headers data is not following the promised type.";

package/src/decorators/internal/validate_request_query.ts

@@ -4,9 +4,7 @@ import typia, { IValidation, TypeGuardError } from "typia";
 import { IRequestQueryValidator } from "../../options/IRequestQueryValidator";
 import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
 
-/**
- * @internal
- */
+/** @internal */
 export const validate_request_query =
   (method: string) =>
   <T>(validator?: IRequestQueryValidator<T>) => {
@@ -21,9 +19,7 @@ export const validate_request_query =
       new Error(`Error on nestia.core.${method}(): invalid typed validator.`);
   };
 
-/**
- * @internal
- */
+/** @internal */
 const assert =
   <T>(closure: (input: URLSearchParams) => T) =>
   (input: URLSearchParams): T | BadRequestException => {
@@ -43,9 +39,7 @@ const assert =
     }
   };
 
-/**
- * @internal
- */
+/** @internal */
 const is =
   <T>(closure: (input: URLSearchParams) => T | null) =>
   (input: URLSearchParams): T | BadRequestException => {
@@ -53,9 +47,7 @@ const is =
     return result !== null ? result : new BadRequestException(MESSAGE);
   };
 
-/**
- * @internal
- */
+/** @internal */
 const validate =
   <T>(closure: (input: URLSearchParams) => IValidation<T>) =>
   (input: URLSearchParams): T | BadRequestException => {
@@ -68,7 +60,5 @@ const validate =
         });
   };
 
-/**
- * @internal
- */
+/** @internal */
 const MESSAGE = "Request query data is not following the promised type.";

package/src/utils/ExceptionManager.ts

@@ -6,24 +6,27 @@ import { Creator } from "../typings/Creator";
 /**
  * Exception manager for HTTP server.
  *
- * `ExceptionManager` is an utility class who can insert or erase custom error class with
- * its conversion method to a regular {@link nest.HttpException} instance.
+ * `ExceptionManager` is an utility class who can insert or erase custom error
+ * class with its conversion method to a regular {@link nest.HttpException}
+ * instance.
  *
- * If you define an API function through {@link TypedRoute} or {@link EncryptedRoute}
- * instead of the basic router decorator functions like {@link nest.Get} or
- * {@link nest.Post} and the API function throws a custom error whose class has been
- * {@link ExceptionManager.insert inserted} in this `EntityManager`, the error would be
- * automatically converted to the regular {@link nest.HttpException} instance by the
- * {@link ExceptionManager.Closure} function.
+ * If you define an API function through {@link TypedRoute} or
+ * {@link EncryptedRoute} instead of the basic router decorator functions like
+ * {@link nest.Get} or {@link nest.Post} and the API function throws a custom
+ * error whose class has been {@link ExceptionManager.insert inserted} in this
+ * `EntityManager`, the error would be automatically converted to the regular
+ * {@link nest.HttpException} instance by the {@link ExceptionManager.Closure}
+ * function.
  *
- * Therefore, with this `ExceptionManager` and {@link TypedRoute} or {@link EncryptedRoute},
- * you can manage your custom error classes much systemtically. You can avoid 500 internal
- * server error or hard coding implementation about the custom error classes.
+ * Therefore, with this `ExceptionManager` and {@link TypedRoute} or
+ * {@link EncryptedRoute}, you can manage your custom error classes much
+ * systemtically. You can avoid 500 internal server error or hard coding
+ * implementation about the custom error classes.
  *
  * Below error classes are defaultly configured in this `ExceptionManager`
  *
- *   - `typia.TypeGuardError`
- *   - `@nestia/fetcher.HttpError`
+ * - `typia.TypeGuardError`
+ * - `@nestia/fetcher.HttpError`
  *
  * @author Jeongho Nam - https://github.com/samchon
  */
@@ -31,7 +34,8 @@ export namespace ExceptionManager {
   /**
    * Insert an error class with converter.
    *
-   * If you've inserted an duplicated error class, the closure would be overwritten.
+   * If you've inserted an duplicated error class, the closure would be
+   * overwritten.
    *
    * @param creator Target error class
    * @param closure A closure function converting to the `HttpException` class
@@ -70,32 +74,31 @@ export namespace ExceptionManager {
   }
 
   /**
-   * Type of a closure function converting to the regular {@link nest.HttpException}.
+   * Type of a closure function converting to the regular
+   * {@link nest.HttpException}.
    *
-   * `ExceptionManager.Closure` is a type of closure function who are converting from
-   * custom error to the regular {@link nest.HttpException} instance. It would be used
-   * in the {@link ExceptionManager} with {@link TypedRoute} or {@link EncryptedRoute}.
+   * `ExceptionManager.Closure` is a type of closure function who are converting
+   * from custom error to the regular {@link nest.HttpException} instance. It
+   * would be used in the {@link ExceptionManager} with {@link TypedRoute} or
+   * {@link EncryptedRoute}.
    */
   export interface Closure<T extends Error> {
     /**
      * Error converter.
      *
-     * Convert from custom error to the regular {@link nest.HttpException} instance.
+     * Convert from custom error to the regular {@link nest.HttpException}
+     * instance.
      *
      * @param exception Custom error instance
-     * @return Regular {@link nest.HttpException} instance
+     * @returns Regular {@link nest.HttpException} instance
      */
     (exception: T): HttpException;
   }
 
-  /**
-   * @internal
-   */
+  /** @internal */
   export const tuples: Array<[Creator<any>, Closure<any>]> = [];
 
-  /**
-   * @internal
-   */
+  /** @internal */
   export const listeners: Set<(error: any) => any> = new Set();
 }
 

package/src/utils/Singleton.ts

@@ -1,6 +1,4 @@
-/**
- * @internal
- */
+/** @internal */
 export class Singleton<T> {
   private value_: T | object;
 
@@ -14,7 +12,5 @@ export class Singleton<T> {
   }
 }
 
-/**
- * @internal
- */
+/** @internal */
 const NOT_MOUNTED_YET = {};