@nestia/fetcher 2.5.0-dev.20240130-7 → 2.5.0-dev.20240131

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/fetcher",
-  "version": "2.5.0-dev.20240130-7",
+  "version": "2.5.0-dev.20240131",
   "description": "Fetcher library of Nestia SDK",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/src/AesPkcs5.ts

@@ -1,50 +1,50 @@
-import crypto from "crypto";
-
-/**
- * Utility class for the AES-128/256 encryption.
- *
- *   - AES-128/256
- *   - CBC mode
- *   - PKCS#5 Padding
- *   - Base64 Encoding
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace AesPkcs5 {
-  /**
-   * Encrypt data
-   *
-   * @param data Target data
-   * @param key Key value of the encryption.
-   * @param iv Initializer Vector for the encryption
-   * @return Encrypted data
-   */
-  export function encrypt(data: string, key: string, iv: string): string {
-    const bytes: number = key.length * 8;
-    const cipher: crypto.Cipher = crypto.createCipheriv(
-      `AES-${bytes}-CBC`,
-      key,
-      iv,
-    );
-    return cipher.update(data, "utf8", "base64") + cipher.final("base64");
-  }
-
-  /**
-   * Decrypt data.
-   *
-   * @param data Target data
-   * @param key Key value of the decryption.
-   * @param iv Initializer Vector for the decryption
-   * @return Decrypted data.
-   */
-  export function decrypt(data: string, key: string, iv: string): string {
-    const bytes: number = key.length * 8;
-    const decipher: crypto.Decipher = crypto.createDecipheriv(
-      `AES-${bytes}-CBC`,
-      key,
-      iv,
-    );
-
-    return decipher.update(data, "base64", "utf8") + decipher.final("utf8");
-  }
-}
+import crypto from "crypto";
+
+/**
+ * Utility class for the AES-128/256 encryption.
+ *
+ *   - AES-128/256
+ *   - CBC mode
+ *   - PKCS#5 Padding
+ *   - Base64 Encoding
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export namespace AesPkcs5 {
+  /**
+   * Encrypt data
+   *
+   * @param data Target data
+   * @param key Key value of the encryption.
+   * @param iv Initializer Vector for the encryption
+   * @return Encrypted data
+   */
+  export function encrypt(data: string, key: string, iv: string): string {
+    const bytes: number = key.length * 8;
+    const cipher: crypto.Cipher = crypto.createCipheriv(
+      `AES-${bytes}-CBC`,
+      key,
+      iv,
+    );
+    return cipher.update(data, "utf8", "base64") + cipher.final("base64");
+  }
+
+  /**
+   * Decrypt data.
+   *
+   * @param data Target data
+   * @param key Key value of the decryption.
+   * @param iv Initializer Vector for the decryption
+   * @return Decrypted data.
+   */
+  export function decrypt(data: string, key: string, iv: string): string {
+    const bytes: number = key.length * 8;
+    const decipher: crypto.Decipher = crypto.createDecipheriv(
+      `AES-${bytes}-CBC`,
+      key,
+      iv,
+    );
+
+    return decipher.update(data, "base64", "utf8") + decipher.final("utf8");
+  }
+}

package/src/EncryptedFetcher.ts

@@ -1,175 +1,175 @@
-import { AesPkcs5 } from "./AesPkcs5";
-import { IConnection } from "./IConnection";
-import { IEncryptionPassword } from "./IEncryptionPassword";
-import { IPropagation } from "./IPropagation";
-import { Primitive } from "./Primitive";
-import { FetcherBase } from "./internal/FetcherBase";
-import { IFetchRoute } from "./internal/IFetchRoute";
-
-/**
- * Utility class for `fetch` functions used in `@nestia/sdk` with encryption.
- *
- * `EncryptedFetcher` is a utility class designed for SDK functions generated by
- * [`@nestia/sdk`](https://nestia.io/docs/sdk/sdk), interacting with the remote
- * HTTP API encrypted by AES-PKCS algorithm. In other words, this is a collection of
- * dedicated `fetch()` functions for `@nestia/sdk` with encryption.
- *
- * For reference, `EncryptedFetcher` class being used only when target controller
- * method is encrypting body data by `@EncryptedRoute` or `@EncryptedBody` decorators.
- * If those decorators are not used, {@link PlainFetcher} class would be used instead.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace EncryptedFetcher {
-  /**
-   * Fetch function only for `HEAD` method.
-   *
-   * @param connection Connection information for the remote HTTP server
-   * @param route Route information about the target API
-   * @return Nothing because of `HEAD` method
-   */
-  export function fetch(
-    connection: IConnection,
-    route: IFetchRoute<"HEAD">,
-  ): Promise<void>;
-
-  /**
-   * Fetch function only for `GET` method.
-   *
-   * @param connection Connection information for the remote HTTP server
-   * @param route Route information about the target API
-   * @return Response body data from the remote API
-   */
-  export function fetch<Output>(
-    connection: IConnection,
-    route: IFetchRoute<"GET">,
-  ): Promise<Primitive<Output>>;
-
-  /**
-   * Fetch function for the `POST`, `PUT`, `PATCH` and `DELETE` methods.
-   *
-   * @param connection Connection information for the remote HTTP server
-   * @param route Route information about the target API
-   * @return Response body data from the remote API
-   */
-  export function fetch<Input, Output>(
-    connection: IConnection,
-    route: IFetchRoute<"POST" | "PUT" | "PATCH" | "DELETE">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Primitive<Output>>;
-
-  export async function fetch<Input, Output>(
-    connection: IConnection,
-    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Primitive<Output>> {
-    if (
-      (route.request?.encrypted === true || route.response?.encrypted) &&
-      connection.encryption === undefined
-    )
-      throw new Error(
-        "Error on EncryptedFetcher.fetch(): the encryption password has not been configured.",
-      );
-    const closure =
-      typeof connection.encryption === "function"
-        ? (direction: "encode" | "decode") =>
-            (
-              headers: Record<string, IConnection.HeaderValue | undefined>,
-              body: string,
-            ) =>
-              (connection.encryption as IEncryptionPassword.Closure)({
-                headers,
-                body,
-                direction,
-              })
-        : () => () => connection.encryption as IEncryptionPassword;
-
-    return FetcherBase.fetch({
-      className: "EncryptedFetcher",
-      encode:
-        route.request?.encrypted === true
-          ? (input, headers) => {
-              const p: IEncryptionPassword = closure("encode")(headers, input);
-              return AesPkcs5.encrypt(
-                (stringify ?? JSON.stringify)(input),
-                p.key,
-                p.iv,
-              );
-            }
-          : (input) => input,
-      decode:
-        route.response?.encrypted === true
-          ? (input, headers) => {
-              const p: IEncryptionPassword = closure("decode")(headers, input);
-              const s: string = AesPkcs5.decrypt(input, p.key, p.iv);
-              return s.length ? JSON.parse(s) : s;
-            }
-          : (input) => input,
-    })(connection, route, input, stringify);
-  }
-
-  export function propagate<Output extends IPropagation<any, any>>(
-    connection: IConnection,
-    route: IFetchRoute<"GET" | "HEAD">,
-  ): Promise<Output>;
-
-  export function propagate<Input, Output extends IPropagation<any, any>>(
-    connection: IConnection,
-    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Output>;
-
-  export async function propagate<Input, Output extends IPropagation<any, any>>(
-    connection: IConnection,
-    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Output> {
-    if (
-      (route.request?.encrypted === true || route.response?.encrypted) &&
-      connection.encryption === undefined
-    )
-      throw new Error(
-        "Error on EncryptedFetcher.propagate(): the encryption password has not been configured.",
-      );
-    const closure =
-      typeof connection.encryption === "function"
-        ? (direction: "encode" | "decode") =>
-            (
-              headers: Record<string, IConnection.HeaderValue | undefined>,
-              body: string,
-            ) =>
-              (connection.encryption as IEncryptionPassword.Closure)({
-                headers,
-                body,
-                direction,
-              })
-        : () => () => connection.encryption as IEncryptionPassword;
-
-    return FetcherBase.propagate({
-      className: "EncryptedFetcher",
-      encode:
-        route.request?.encrypted === true
-          ? (input, headers) => {
-              const p: IEncryptionPassword = closure("encode")(headers, input);
-              return AesPkcs5.encrypt(
-                (stringify ?? JSON.stringify)(input),
-                p.key,
-                p.iv,
-              );
-            }
-          : (input) => input,
-      decode:
-        route.response?.encrypted === true
-          ? (input, headers) => {
-              const p: IEncryptionPassword = closure("decode")(headers, input);
-              const s: string = AesPkcs5.decrypt(input, p.key, p.iv);
-              return s.length ? JSON.parse(s) : s;
-            }
-          : (input) => input,
-    })(connection, route, input, stringify) as Promise<Output>;
-  }
-}
+import { AesPkcs5 } from "./AesPkcs5";
+import { IConnection } from "./IConnection";
+import { IEncryptionPassword } from "./IEncryptionPassword";
+import { IPropagation } from "./IPropagation";
+import { Primitive } from "./Primitive";
+import { FetcherBase } from "./internal/FetcherBase";
+import { IFetchRoute } from "./internal/IFetchRoute";
+
+/**
+ * Utility class for `fetch` functions used in `@nestia/sdk` with encryption.
+ *
+ * `EncryptedFetcher` is a utility class designed for SDK functions generated by
+ * [`@nestia/sdk`](https://nestia.io/docs/sdk/sdk), interacting with the remote
+ * HTTP API encrypted by AES-PKCS algorithm. In other words, this is a collection of
+ * dedicated `fetch()` functions for `@nestia/sdk` with encryption.
+ *
+ * For reference, `EncryptedFetcher` class being used only when target controller
+ * method is encrypting body data by `@EncryptedRoute` or `@EncryptedBody` decorators.
+ * If those decorators are not used, {@link PlainFetcher} class would be used instead.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export namespace EncryptedFetcher {
+  /**
+   * Fetch function only for `HEAD` method.
+   *
+   * @param connection Connection information for the remote HTTP server
+   * @param route Route information about the target API
+   * @return Nothing because of `HEAD` method
+   */
+  export function fetch(
+    connection: IConnection,
+    route: IFetchRoute<"HEAD">,
+  ): Promise<void>;
+
+  /**
+   * Fetch function only for `GET` method.
+   *
+   * @param connection Connection information for the remote HTTP server
+   * @param route Route information about the target API
+   * @return Response body data from the remote API
+   */
+  export function fetch<Output>(
+    connection: IConnection,
+    route: IFetchRoute<"GET">,
+  ): Promise<Primitive<Output>>;
+
+  /**
+   * Fetch function for the `POST`, `PUT`, `PATCH` and `DELETE` methods.
+   *
+   * @param connection Connection information for the remote HTTP server
+   * @param route Route information about the target API
+   * @return Response body data from the remote API
+   */
+  export function fetch<Input, Output>(
+    connection: IConnection,
+    route: IFetchRoute<"POST" | "PUT" | "PATCH" | "DELETE">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Primitive<Output>>;
+
+  export async function fetch<Input, Output>(
+    connection: IConnection,
+    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Primitive<Output>> {
+    if (
+      (route.request?.encrypted === true || route.response?.encrypted) &&
+      connection.encryption === undefined
+    )
+      throw new Error(
+        "Error on EncryptedFetcher.fetch(): the encryption password has not been configured.",
+      );
+    const closure =
+      typeof connection.encryption === "function"
+        ? (direction: "encode" | "decode") =>
+            (
+              headers: Record<string, IConnection.HeaderValue | undefined>,
+              body: string,
+            ) =>
+              (connection.encryption as IEncryptionPassword.Closure)({
+                headers,
+                body,
+                direction,
+              })
+        : () => () => connection.encryption as IEncryptionPassword;
+
+    return FetcherBase.fetch({
+      className: "EncryptedFetcher",
+      encode:
+        route.request?.encrypted === true
+          ? (input, headers) => {
+              const p: IEncryptionPassword = closure("encode")(headers, input);
+              return AesPkcs5.encrypt(
+                (stringify ?? JSON.stringify)(input),
+                p.key,
+                p.iv,
+              );
+            }
+          : (input) => input,
+      decode:
+        route.response?.encrypted === true
+          ? (input, headers) => {
+              const p: IEncryptionPassword = closure("decode")(headers, input);
+              const s: string = AesPkcs5.decrypt(input, p.key, p.iv);
+              return s.length ? JSON.parse(s) : s;
+            }
+          : (input) => input,
+    })(connection, route, input, stringify);
+  }
+
+  export function propagate<Output extends IPropagation<any, any>>(
+    connection: IConnection,
+    route: IFetchRoute<"GET" | "HEAD">,
+  ): Promise<Output>;
+
+  export function propagate<Input, Output extends IPropagation<any, any>>(
+    connection: IConnection,
+    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Output>;
+
+  export async function propagate<Input, Output extends IPropagation<any, any>>(
+    connection: IConnection,
+    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Output> {
+    if (
+      (route.request?.encrypted === true || route.response?.encrypted) &&
+      connection.encryption === undefined
+    )
+      throw new Error(
+        "Error on EncryptedFetcher.propagate(): the encryption password has not been configured.",
+      );
+    const closure =
+      typeof connection.encryption === "function"
+        ? (direction: "encode" | "decode") =>
+            (
+              headers: Record<string, IConnection.HeaderValue | undefined>,
+              body: string,
+            ) =>
+              (connection.encryption as IEncryptionPassword.Closure)({
+                headers,
+                body,
+                direction,
+              })
+        : () => () => connection.encryption as IEncryptionPassword;
+
+    return FetcherBase.propagate({
+      className: "EncryptedFetcher",
+      encode:
+        route.request?.encrypted === true
+          ? (input, headers) => {
+              const p: IEncryptionPassword = closure("encode")(headers, input);
+              return AesPkcs5.encrypt(
+                (stringify ?? JSON.stringify)(input),
+                p.key,
+                p.iv,
+              );
+            }
+          : (input) => input,
+      decode:
+        route.response?.encrypted === true
+          ? (input, headers) => {
+              const p: IEncryptionPassword = closure("decode")(headers, input);
+              const s: string = AesPkcs5.decrypt(input, p.key, p.iv);
+              return s.length ? JSON.parse(s) : s;
+            }
+          : (input) => input,
+    })(connection, route, input, stringify) as Promise<Output>;
+  }
+}

package/src/HttpError.ts

@@ -1,85 +1,85 @@
-/**
- * HTTP Error.
- *
- * `HttpError` is a type of error class who've been thrown by the remote HTTP server.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export class HttpError extends Error {
-  /**
-   * @internal
-   */
-  private body_: any = NOT_YET;
-
-  /**
-   * Initializer Constructor.
-   *
-   * @param method Method of the HTTP request.
-   * @param path Path of the HTTP request.
-   * @param status Status code from the remote HTTP server.
-   * @param message Error message from the remote HTTP server.
-   */
-  public constructor(
-    public readonly method:
-      | "GET"
-      | "DELETE"
-      | "POST"
-      | "PUT"
-      | "PATCH"
-      | "HEAD",
-    public readonly path: string,
-    public readonly status: number,
-    public readonly headers: Record<string, string | string[]>,
-    message: string,
-  ) {
-    super(message);
-
-    // INHERITANCE POLYFILL
-    const proto: HttpError = new.target.prototype;
-    if (Object.setPrototypeOf) Object.setPrototypeOf(this, proto);
-    else (this as any).__proto__ = proto;
-  }
-
-  /**
-   * `HttpError` to JSON.
-   *
-   * When you call `JSON.stringify()` function on current `HttpError` instance,
-   * this `HttpError.toJSON()` method would be automatically called.
-   *
-   * Also, if response body from the remote HTTP server forms a JSON object,
-   * this `HttpError.toJSON()` method would be useful because it returns the
-   * parsed JSON object about the {@link message} property.
-   *
-   * @template T Expected type of the response body.
-   * @returns JSON object of the `HttpError`.
-   */
-  public toJSON<T>(): HttpError.IProps<T> {
-    if (this.body_ === NOT_YET)
-      try {
-        this.body_ = JSON.parse(this.message);
-      } catch {
-        this.body_ = this.message;
-      }
-    return {
-      method: this.method,
-      path: this.path,
-      status: this.status,
-      headers: this.headers,
-      message: this.body_,
-    };
-  }
-}
-export namespace HttpError {
-  /**
-   * Returned type of {@link HttpError.toJSON} method.
-   */
-  export interface IProps<T> {
-    method: "GET" | "DELETE" | "POST" | "PUT" | "PATCH" | "HEAD";
-    path: string;
-    status: number;
-    headers: Record<string, string | string[]>;
-    message: T;
-  }
-}
-
-const NOT_YET = {} as any;
+/**
+ * HTTP Error.
+ *
+ * `HttpError` is a type of error class who've been thrown by the remote HTTP server.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export class HttpError extends Error {
+  /**
+   * @internal
+   */
+  private body_: any = NOT_YET;
+
+  /**
+   * Initializer Constructor.
+   *
+   * @param method Method of the HTTP request.
+   * @param path Path of the HTTP request.
+   * @param status Status code from the remote HTTP server.
+   * @param message Error message from the remote HTTP server.
+   */
+  public constructor(
+    public readonly method:
+      | "GET"
+      | "DELETE"
+      | "POST"
+      | "PUT"
+      | "PATCH"
+      | "HEAD",
+    public readonly path: string,
+    public readonly status: number,
+    public readonly headers: Record<string, string | string[]>,
+    message: string,
+  ) {
+    super(message);
+
+    // INHERITANCE POLYFILL
+    const proto: HttpError = new.target.prototype;
+    if (Object.setPrototypeOf) Object.setPrototypeOf(this, proto);
+    else (this as any).__proto__ = proto;
+  }
+
+  /**
+   * `HttpError` to JSON.
+   *
+   * When you call `JSON.stringify()` function on current `HttpError` instance,
+   * this `HttpError.toJSON()` method would be automatically called.
+   *
+   * Also, if response body from the remote HTTP server forms a JSON object,
+   * this `HttpError.toJSON()` method would be useful because it returns the
+   * parsed JSON object about the {@link message} property.
+   *
+   * @template T Expected type of the response body.
+   * @returns JSON object of the `HttpError`.
+   */
+  public toJSON<T>(): HttpError.IProps<T> {
+    if (this.body_ === NOT_YET)
+      try {
+        this.body_ = JSON.parse(this.message);
+      } catch {
+        this.body_ = this.message;
+      }
+    return {
+      method: this.method,
+      path: this.path,
+      status: this.status,
+      headers: this.headers,
+      message: this.body_,
+    };
+  }
+}
+export namespace HttpError {
+  /**
+   * Returned type of {@link HttpError.toJSON} method.
+   */
+  export interface IProps<T> {
+    method: "GET" | "DELETE" | "POST" | "PUT" | "PATCH" | "HEAD";
+    path: string;
+    status: number;
+    headers: Record<string, string | string[]>;
+    message: T;
+  }
+}
+
+const NOT_YET = {} as any;

package/src/IEncryptionPassword.ts

@@ -1,50 +1,50 @@
-import { IConnection } from "./IConnection";
-
-/**
- * Encryption password.
- *
- * `IEncryptionPassword` is a type of interface who represents encryption password used by
- * the {@link Fetcher} with AES-128/256 algorithm. If your encryption password is not fixed
- * but changes according to the input content, you can utilize the
- * {@link IEncryptionPassword.Closure} function type.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export interface IEncryptionPassword {
-  /**
-   * Secret key.
-   */
-  key: string;
-
-  /**
-   * Initialization Vector.
-   */
-  iv: string;
-}
-export namespace IEncryptionPassword {
-  /**
-   * Type of a closure function returning the {@link IEncryptionPassword} object.
-   *
-   * `IEncryptionPassword.Closure` is a type of closure function who are returning the
-   * {@link IEncryptionPassword} object. It would be used when your encryption password
-   * be changed according to the input content.
-   */
-  export interface Closure {
-    /**
-     * Encryption password getter.
-     *
-     * @param props Properties for predication
-     * @returns Encryption password
-     */
-    (props: IProps): IEncryptionPassword;
-  }
-
-  /**
-   * Properties for the closure.
-   */
-  export interface IProps {
-    headers: Record<string, IConnection.HeaderValue | undefined>;
-    body: string;
-    direction: "encode" | "decode";
-  }
-}
+import { IConnection } from "./IConnection";
+
+/**
+ * Encryption password.
+ *
+ * `IEncryptionPassword` is a type of interface who represents encryption password used by
+ * the {@link Fetcher} with AES-128/256 algorithm. If your encryption password is not fixed
+ * but changes according to the input content, you can utilize the
+ * {@link IEncryptionPassword.Closure} function type.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IEncryptionPassword {
+  /**
+   * Secret key.
+   */
+  key: string;
+
+  /**
+   * Initialization Vector.
+   */
+  iv: string;
+}
+export namespace IEncryptionPassword {
+  /**
+   * Type of a closure function returning the {@link IEncryptionPassword} object.
+   *
+   * `IEncryptionPassword.Closure` is a type of closure function who are returning the
+   * {@link IEncryptionPassword} object. It would be used when your encryption password
+   * be changed according to the input content.
+   */
+  export interface Closure {
+    /**
+     * Encryption password getter.
+     *
+     * @param props Properties for predication
+     * @returns Encryption password
+     */
+    (props: IProps): IEncryptionPassword;
+  }
+
+  /**
+   * Properties for the closure.
+   */
+  export interface IProps {
+    headers: Record<string, IConnection.HeaderValue | undefined>;
+    body: string;
+    direction: "encode" | "decode";
+  }
+}

package/src/IRandomGenerator.ts

@@ -1,38 +1,38 @@
-export interface IRandomGenerator {
-  boolean(): boolean;
-  integer(minimum?: number, maximum?: number): number;
-  number(minimum?: number, maximum?: number): number;
-  bigint(minimum?: bigint, maximum?: bigint): bigint;
-  string(length?: number): string;
-  array<T>(closure: (index: number) => T, count?: number): T[];
-  length(): number;
-
-  uuid(): string;
-  email(): string;
-  url(): string;
-  ipv4(): string;
-  ipv6(): string;
-  pattern(regex: RegExp): string;
-  date(minimum?: number, maximum?: number): string;
-  datetime(minimum?: number, maximum?: number): string;
-
-  customs?: IRandomGenerator.CustomMap;
-}
-export namespace IRandomGenerator {
-  export type CustomMap = {
-    [Type in keyof Customizable]?: (
-      tags: ICommentTag[],
-    ) => Customizable[Type] | undefined;
-  };
-
-  export type Customizable = {
-    number: number;
-    string: string;
-    bigint: bigint;
-  };
-
-  export interface ICommentTag {
-    name: string;
-    value?: string;
-  }
-}
+export interface IRandomGenerator {
+  boolean(): boolean;
+  integer(minimum?: number, maximum?: number): number;
+  number(minimum?: number, maximum?: number): number;
+  bigint(minimum?: bigint, maximum?: bigint): bigint;
+  string(length?: number): string;
+  array<T>(closure: (index: number) => T, count?: number): T[];
+  length(): number;
+
+  uuid(): string;
+  email(): string;
+  url(): string;
+  ipv4(): string;
+  ipv6(): string;
+  pattern(regex: RegExp): string;
+  date(minimum?: number, maximum?: number): string;
+  datetime(minimum?: number, maximum?: number): string;
+
+  customs?: IRandomGenerator.CustomMap;
+}
+export namespace IRandomGenerator {
+  export type CustomMap = {
+    [Type in keyof Customizable]?: (
+      tags: ICommentTag[],
+    ) => Customizable[Type] | undefined;
+  };
+
+  export type Customizable = {
+    number: number;
+    string: string;
+    bigint: bigint;
+  };
+
+  export interface ICommentTag {
+    name: string;
+    value?: string;
+  }
+}

package/src/PlainFetcher.ts

@@ -1,106 +1,106 @@
-import { IConnection } from "./IConnection";
-import { IPropagation } from "./IPropagation";
-import { Primitive } from "./Primitive";
-import { FetcherBase } from "./internal/FetcherBase";
-import { IFetchRoute } from "./internal/IFetchRoute";
-
-/**
- * Utility class for `fetch` functions used in `@nestia/sdk`.
- *
- * `PlainFetcher` is a utility class designed for SDK functions generated by
- * [`@nestia/sdk`](https://nestia.io/docs/sdk/sdk), interacting with the remote
- * HTTP sever API. In other words, this is a collection of dedicated `fetch()`
- * functions for `@nestia/sdk`.
- *
- * For reference, `PlainFetcher` class does not encrypt or decrypt the body data
- * at all. It just delivers plain data without any post processing. If you've
- * defined a controller method through `@EncryptedRoute` or `@EncryptedBody`
- * decorator, then {@liink EncryptedFetcher} class would be used instead.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace PlainFetcher {
-  /**
-   * Fetch function only for `HEAD` method.
-   *
-   * @param connection Connection information for the remote HTTP server
-   * @param route Route information about the target API
-   * @return Nothing because of `HEAD` method
-   */
-  export function fetch(
-    connection: IConnection,
-    route: IFetchRoute<"HEAD">,
-  ): Promise<void>;
-
-  /**
-   * Fetch function only for `GET` method.
-   *
-   * @param connection Connection information for the remote HTTP server
-   * @param route Route information about the target API
-   * @return Response body data from the remote API
-   */
-  export function fetch<Output>(
-    connection: IConnection,
-    route: IFetchRoute<"GET">,
-  ): Promise<Primitive<Output>>;
-
-  /**
-   * Fetch function for the `POST`, `PUT`, `PATCH` and `DELETE` methods.
-   *
-   * @param connection Connection information for the remote HTTP server
-   * @param route Route information about the target API
-   * @return Response body data from the remote API
-   */
-  export function fetch<Input, Output>(
-    connection: IConnection,
-    route: IFetchRoute<"POST" | "PUT" | "PATCH" | "DELETE">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Primitive<Output>>;
-
-  export async function fetch<Input, Output>(
-    connection: IConnection,
-    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Primitive<Output>> {
-    if (route.request?.encrypted === true || route.response?.encrypted === true)
-      throw new Error(
-        "Error on PlainFetcher.fetch(): PlainFetcher doesn't have encryption ability. Use EncryptedFetcher instead.",
-      );
-    return FetcherBase.fetch({
-      className: "PlainFetcher",
-      encode: (input) => input,
-      decode: (input) => input,
-    })(connection, route, input, stringify);
-  }
-
-  export function propagate<Output extends IPropagation<any, any>>(
-    connection: IConnection,
-    route: IFetchRoute<"GET" | "HEAD">,
-  ): Promise<Output>;
-
-  export function propagate<Input, Output extends IPropagation<any, any>>(
-    connection: IConnection,
-    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Output>;
-
-  export async function propagate<Input, Output extends IPropagation<any, any>>(
-    connection: IConnection,
-    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
-    input?: Input,
-    stringify?: (input: Input) => string,
-  ): Promise<Output> {
-    if (route.request?.encrypted === true || route.response?.encrypted === true)
-      throw new Error(
-        "Error on PlainFetcher.propagate(): PlainFetcher doesn't have encryption ability. Use EncryptedFetcher instead.",
-      );
-    return FetcherBase.propagate({
-      className: "PlainFetcher",
-      encode: (input) => input,
-      decode: (input) => input,
-    })(connection, route, input, stringify) as Promise<Output>;
-  }
-}
+import { IConnection } from "./IConnection";
+import { IPropagation } from "./IPropagation";
+import { Primitive } from "./Primitive";
+import { FetcherBase } from "./internal/FetcherBase";
+import { IFetchRoute } from "./internal/IFetchRoute";
+
+/**
+ * Utility class for `fetch` functions used in `@nestia/sdk`.
+ *
+ * `PlainFetcher` is a utility class designed for SDK functions generated by
+ * [`@nestia/sdk`](https://nestia.io/docs/sdk/sdk), interacting with the remote
+ * HTTP sever API. In other words, this is a collection of dedicated `fetch()`
+ * functions for `@nestia/sdk`.
+ *
+ * For reference, `PlainFetcher` class does not encrypt or decrypt the body data
+ * at all. It just delivers plain data without any post processing. If you've
+ * defined a controller method through `@EncryptedRoute` or `@EncryptedBody`
+ * decorator, then {@liink EncryptedFetcher} class would be used instead.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export namespace PlainFetcher {
+  /**
+   * Fetch function only for `HEAD` method.
+   *
+   * @param connection Connection information for the remote HTTP server
+   * @param route Route information about the target API
+   * @return Nothing because of `HEAD` method
+   */
+  export function fetch(
+    connection: IConnection,
+    route: IFetchRoute<"HEAD">,
+  ): Promise<void>;
+
+  /**
+   * Fetch function only for `GET` method.
+   *
+   * @param connection Connection information for the remote HTTP server
+   * @param route Route information about the target API
+   * @return Response body data from the remote API
+   */
+  export function fetch<Output>(
+    connection: IConnection,
+    route: IFetchRoute<"GET">,
+  ): Promise<Primitive<Output>>;
+
+  /**
+   * Fetch function for the `POST`, `PUT`, `PATCH` and `DELETE` methods.
+   *
+   * @param connection Connection information for the remote HTTP server
+   * @param route Route information about the target API
+   * @return Response body data from the remote API
+   */
+  export function fetch<Input, Output>(
+    connection: IConnection,
+    route: IFetchRoute<"POST" | "PUT" | "PATCH" | "DELETE">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Primitive<Output>>;
+
+  export async function fetch<Input, Output>(
+    connection: IConnection,
+    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Primitive<Output>> {
+    if (route.request?.encrypted === true || route.response?.encrypted === true)
+      throw new Error(
+        "Error on PlainFetcher.fetch(): PlainFetcher doesn't have encryption ability. Use EncryptedFetcher instead.",
+      );
+    return FetcherBase.fetch({
+      className: "PlainFetcher",
+      encode: (input) => input,
+      decode: (input) => input,
+    })(connection, route, input, stringify);
+  }
+
+  export function propagate<Output extends IPropagation<any, any>>(
+    connection: IConnection,
+    route: IFetchRoute<"GET" | "HEAD">,
+  ): Promise<Output>;
+
+  export function propagate<Input, Output extends IPropagation<any, any>>(
+    connection: IConnection,
+    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Output>;
+
+  export async function propagate<Input, Output extends IPropagation<any, any>>(
+    connection: IConnection,
+    route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+    input?: Input,
+    stringify?: (input: Input) => string,
+  ): Promise<Output> {
+    if (route.request?.encrypted === true || route.response?.encrypted === true)
+      throw new Error(
+        "Error on PlainFetcher.propagate(): PlainFetcher doesn't have encryption ability. Use EncryptedFetcher instead.",
+      );
+    return FetcherBase.propagate({
+      className: "PlainFetcher",
+      encode: (input) => input,
+      decode: (input) => input,
+    })(connection, route, input, stringify) as Promise<Output>;
+  }
+}

package/src/index.ts

@@ -1,7 +1,7 @@
-export * from "./IConnection";
-export * from "./IEncryptionPassword";
-export * from "./IPropagation";
-export * from "./IRandomGenerator";
-export * from "./HttpError";
-export * from "./Primitive";
-export * from "./Resolved";
+export * from "./IConnection";
+export * from "./IEncryptionPassword";
+export * from "./IPropagation";
+export * from "./IRandomGenerator";
+export * from "./HttpError";
+export * from "./Primitive";
+export * from "./Resolved";

package/src/internal/IFetchRoute.ts

@@ -1,61 +1,61 @@
-/**
- * Properties of remote API route.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export interface IFetchRoute<
-  Method extends "HEAD" | "GET" | "POST" | "PUT" | "PATCH" | "DELETE",
-> {
-  /**
-   * Method of the HTTP request.
-   */
-  method: Method;
-
-  /**
-   * Path of the HTTP request.
-   */
-  path: string;
-
-  /**
-   * Request body data info.
-   */
-  request: Method extends "DELETE" | "POST" | "PUT" | "PATCH"
-    ? IFetchRoute.IBody | null
-    : null;
-
-  /**
-   * Response body data info.
-   */
-  response: Method extends "HEAD" ? null : IFetchRoute.IBody;
-
-  /**
-   * When special status code being used.
-   */
-  status: number | null;
-
-  /**
-   * Parser of the query string.
-   *
-   * If content type of response body is `application/x-www-form-urlencoded`,
-   * then this `parseQuery` function would be called.
-   *
-   * If you've forgotten to configuring this `parseQuery` property about the
-   * `application/x-www-form-urlencoded` typed response body data, then
-   * only the `URLSearchParams` typed instance would be returned instead.
-   */
-  parseQuery?(input: URLSearchParams): any;
-}
-export namespace IFetchRoute {
-  /**
-   * Metadata of body.
-   *
-   * Describes how content-type being used in body, and whether encrypted or not.
-   */
-  export interface IBody {
-    type:
-      | "application/json"
-      | "application/x-www-form-urlencoded"
-      | "text/plain";
-    encrypted?: boolean;
-  }
-}
+/**
+ * Properties of remote API route.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IFetchRoute<
+  Method extends "HEAD" | "GET" | "POST" | "PUT" | "PATCH" | "DELETE",
+> {
+  /**
+   * Method of the HTTP request.
+   */
+  method: Method;
+
+  /**
+   * Path of the HTTP request.
+   */
+  path: string;
+
+  /**
+   * Request body data info.
+   */
+  request: Method extends "DELETE" | "POST" | "PUT" | "PATCH"
+    ? IFetchRoute.IBody | null
+    : null;
+
+  /**
+   * Response body data info.
+   */
+  response: Method extends "HEAD" ? null : IFetchRoute.IBody;
+
+  /**
+   * When special status code being used.
+   */
+  status: number | null;
+
+  /**
+   * Parser of the query string.
+   *
+   * If content type of response body is `application/x-www-form-urlencoded`,
+   * then this `parseQuery` function would be called.
+   *
+   * If you've forgotten to configuring this `parseQuery` property about the
+   * `application/x-www-form-urlencoded` typed response body data, then
+   * only the `URLSearchParams` typed instance would be returned instead.
+   */
+  parseQuery?(input: URLSearchParams): any;
+}
+export namespace IFetchRoute {
+  /**
+   * Metadata of body.
+   *
+   * Describes how content-type being used in body, and whether encrypted or not.
+   */
+  export interface IBody {
+    type:
+      | "application/json"
+      | "application/x-www-form-urlencoded"
+      | "text/plain";
+    encrypted?: boolean;
+  }
+}

package/src/internal/Singleton.ts

@@ -1,20 +1,20 @@
-/**
- * @internal
- */
-export class Singleton<T> {
-  private value_: T | object;
-
-  public constructor(private readonly closure_: () => T) {
-    this.value_ = NOT_MOUNTED_YET;
-  }
-
-  public get(): T {
-    if (this.value_ === NOT_MOUNTED_YET) this.value_ = this.closure_();
-    return this.value_ as T;
-  }
-}
-
-/**
- * @internal
- */
-const NOT_MOUNTED_YET = {};
+/**
+ * @internal
+ */
+export class Singleton<T> {
+  private value_: T | object;
+
+  public constructor(private readonly closure_: () => T) {
+    this.value_ = NOT_MOUNTED_YET;
+  }
+
+  public get(): T {
+    if (this.value_ === NOT_MOUNTED_YET) this.value_ = this.closure_();
+    return this.value_ as T;
+  }
+}
+
+/**
+ * @internal
+ */
+const NOT_MOUNTED_YET = {};