@nestia/fetcher 2.4.3 → 2.4.4-dev.20240109

package/package.json

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

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/IConnection.ts

@@ -1,237 +1,237 @@
-/// <reference lib="dom" />
-import { IEncryptionPassword } from "./IEncryptionPassword";
-import { IRandomGenerator } from "./IRandomGenerator";
-
-/**
- * Connection information.
- *
- * `IConnection` is an interface ttype who represents connection information of the
- * remote HTTP server. You can target the remote HTTP server by wring the
- * {@link IConnection.host} variable down. Also, you can configure special header values
- * by specializing the {@link IConnection.headers} variable.
- *
- * If the remote HTTP server encrypts or decrypts its body data through the AES-128/256
- * algorithm, specify the {@link IConnection.encryption} with {@link IEncryptionPassword}
- * or {@link IEncryptionPassword.Closure} variable.
- *
- * @author Jenogho Nam - https://github.com/samchon
- * @author Seungjun We - https://github.com/SeungjunWe
- */
-export interface IConnection<Headers extends object = {}> {
-  /**
-   * Host address of the remote HTTP server.
-   */
-  host: string;
-
-  /**
-   * Header values delivered to the remote HTTP server.
-   */
-  headers?: Record<string, IConnection.HeaderValue> &
-    IConnection.Headerify<Headers>;
-
-  /**
-   * Use simulation mode.
-   *
-   * If you configure this property to be `true` or assign an {@link IRandomGenerator}
-   * instance, your SDK library does not send any request to remote backend server,
-   * but just returns random data generated by `typia.random<T>()` function with
-   * request data validation.
-   *
-   * By the way, to utilize this simulation mode, SDK library must be generated with
-   * {@link INestiaConfig.simulate} option, too. Open `nestia.config.ts` file, and
-   * configure {@link INestiaConfig.simulate} property to be `true`. Them, newly
-   * generated SDK library would have a built-in mock-up data generator.
-   *
-   * @default false
-   */
-  simulate?: boolean | Partial<IRandomGenerator>;
-
-  /**
-   * Additional options for the `fetch` function.
-   */
-  options?: IConnection.IOptions;
-
-  /**
-   * Encryption password of its closure function.
-   *
-   * Define it only when target backend server is encrypting body data through
-   * `@EncryptedRoute` or `@EncryptedBody` decorators of `@nestia/core` for
-   * security reason.
-   */
-  encryption?: IEncryptionPassword | IEncryptionPassword.Closure;
-
-  /**
-   * Custom fetch function.
-   *
-   * If you want to use custom `fetch` function instead of built-in function,
-   * assign your custom `fetch` function into this property.
-   */
-  fetch?: typeof fetch;
-}
-export namespace IConnection {
-  /**
-   * Addiotional options for the `fetch` function.
-   *
-   * Almost same with {@link RequestInit} type of the {@link fetch} function,
-   * but `body`, `headers` and `method` properties are omitted.
-   *
-   * The reason why defining duplicated definition of {@link RequestInit}
-   * is for legacy NodeJS environments, which does not have the {@link fetch}
-   * function type.
-   */
-  export interface IOptions {
-    /**
-     * A string indicating how the request will interact with the browser's
-     * cache to set request's cache.
-     */
-    cache?:
-      | "default"
-      | "force-cache"
-      | "no-cache"
-      | "no-store"
-      | "only-if-cached"
-      | "reload";
-
-    /**
-     * A string indicating whether credentials will be sent with the request
-     * always, never, or only when sent to a same-origin URL. Sets request's
-     * credentials.
-     */
-    credentials?: "omit" | "same-origin" | "include";
-
-    /**
-     * A cryptographic hash of the resource to be fetched by request.
-     *
-     * Sets request's integrity.
-     */
-    integrity?: string;
-
-    /**
-     * A boolean to set request's keepalive.
-     */
-    keepalive?: boolean;
-
-    /**
-     * A string to indicate whether the request will use CORS, or will be
-     * restricted to same-origin URLs.
-     *
-     * Sets request's mode.
-     */
-    mode?: "cors" | "navigate" | "no-cors" | "same-origin";
-
-    /**
-     * A string indicating whether request follows redirects, results in
-     * an error upon encountering a redirect, or returns the redirect
-     * (in an opaque fashion).
-     *
-     * Sets request's redirect.
-     */
-    redirect?: "error" | "follow" | "manual";
-
-    /**
-     * A string whose value is a same-origin URL, "about:client", or the
-     * empty string, to set request's referrer.
-     */
-    referrer?: string;
-
-    /**
-     * A referrer policy to set request's referrerPolicy.
-     */
-    referrerPolicy?:
-      | ""
-      | "no-referrer"
-      | "no-referrer-when-downgrade"
-      | "origin"
-      | "origin-when-cross-origin"
-      | "same-origin"
-      | "strict-origin"
-      | "strict-origin-when-cross-origin"
-      | "unsafe-url";
-
-    /**
-     * An AbortSignal to set request's signal.
-     */
-    signal?: AbortSignal | null;
-  }
-
-  /**
-   * Type of allowed header values.
-   *
-   * Only atomic or array of atomic values are allowed.
-   */
-  export type HeaderValue =
-    | string
-    | boolean
-    | number
-    | bigint
-    | string
-    | Array<boolean>
-    | Array<number>
-    | Array<bigint>
-    | Array<number>
-    | Array<string>;
-
-  /**
-   * Type of headers
-   *
-   * `Headerify` removes every properties that are not allowed in the
-   * HTTP headers type.
-   *
-   * Below are list of prohibited in HTTP headers.
-   *
-   * 1. Value type one of {@link HeaderValue}
-   * 2. Key is "set-cookie", but value is not an Array type
-   * 3. Key is one of them, but value is 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"
-   */
-  export type Headerify<T extends object> = {
-    [P in keyof T]?: T[P] extends HeaderValue | undefined
-      ? P extends string
-        ? Lowercase<P> extends "set-cookie"
-          ? T[P] extends Array<HeaderValue>
-            ? T[P] | undefined
-            : never
-          : Lowercase<P> extends
-              | "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"
-          ? T[P] extends Array<HeaderValue>
-            ? never
-            : T[P] | undefined
-          : T[P] | undefined
-        : never
-      : never;
-  };
-}
+/// <reference lib="dom" />
+import { IEncryptionPassword } from "./IEncryptionPassword";
+import { IRandomGenerator } from "./IRandomGenerator";
+
+/**
+ * Connection information.
+ *
+ * `IConnection` is an interface ttype who represents connection information of the
+ * remote HTTP server. You can target the remote HTTP server by wring the
+ * {@link IConnection.host} variable down. Also, you can configure special header values
+ * by specializing the {@link IConnection.headers} variable.
+ *
+ * If the remote HTTP server encrypts or decrypts its body data through the AES-128/256
+ * algorithm, specify the {@link IConnection.encryption} with {@link IEncryptionPassword}
+ * or {@link IEncryptionPassword.Closure} variable.
+ *
+ * @author Jenogho Nam - https://github.com/samchon
+ * @author Seungjun We - https://github.com/SeungjunWe
+ */
+export interface IConnection<Headers extends object = {}> {
+  /**
+   * Host address of the remote HTTP server.
+   */
+  host: string;
+
+  /**
+   * Header values delivered to the remote HTTP server.
+   */
+  headers?: Record<string, IConnection.HeaderValue> &
+    IConnection.Headerify<Headers>;
+
+  /**
+   * Use simulation mode.
+   *
+   * If you configure this property to be `true` or assign an {@link IRandomGenerator}
+   * instance, your SDK library does not send any request to remote backend server,
+   * but just returns random data generated by `typia.random<T>()` function with
+   * request data validation.
+   *
+   * By the way, to utilize this simulation mode, SDK library must be generated with
+   * {@link INestiaConfig.simulate} option, too. Open `nestia.config.ts` file, and
+   * configure {@link INestiaConfig.simulate} property to be `true`. Them, newly
+   * generated SDK library would have a built-in mock-up data generator.
+   *
+   * @default false
+   */
+  simulate?: boolean | Partial<IRandomGenerator>;
+
+  /**
+   * Additional options for the `fetch` function.
+   */
+  options?: IConnection.IOptions;
+
+  /**
+   * Encryption password of its closure function.
+   *
+   * Define it only when target backend server is encrypting body data through
+   * `@EncryptedRoute` or `@EncryptedBody` decorators of `@nestia/core` for
+   * security reason.
+   */
+  encryption?: IEncryptionPassword | IEncryptionPassword.Closure;
+
+  /**
+   * Custom fetch function.
+   *
+   * If you want to use custom `fetch` function instead of built-in function,
+   * assign your custom `fetch` function into this property.
+   */
+  fetch?: typeof fetch;
+}
+export namespace IConnection {
+  /**
+   * Addiotional options for the `fetch` function.
+   *
+   * Almost same with {@link RequestInit} type of the {@link fetch} function,
+   * but `body`, `headers` and `method` properties are omitted.
+   *
+   * The reason why defining duplicated definition of {@link RequestInit}
+   * is for legacy NodeJS environments, which does not have the {@link fetch}
+   * function type.
+   */
+  export interface IOptions {
+    /**
+     * A string indicating how the request will interact with the browser's
+     * cache to set request's cache.
+     */
+    cache?:
+      | "default"
+      | "force-cache"
+      | "no-cache"
+      | "no-store"
+      | "only-if-cached"
+      | "reload";
+
+    /**
+     * A string indicating whether credentials will be sent with the request
+     * always, never, or only when sent to a same-origin URL. Sets request's
+     * credentials.
+     */
+    credentials?: "omit" | "same-origin" | "include";
+
+    /**
+     * A cryptographic hash of the resource to be fetched by request.
+     *
+     * Sets request's integrity.
+     */
+    integrity?: string;
+
+    /**
+     * A boolean to set request's keepalive.
+     */
+    keepalive?: boolean;
+
+    /**
+     * A string to indicate whether the request will use CORS, or will be
+     * restricted to same-origin URLs.
+     *
+     * Sets request's mode.
+     */
+    mode?: "cors" | "navigate" | "no-cors" | "same-origin";
+
+    /**
+     * A string indicating whether request follows redirects, results in
+     * an error upon encountering a redirect, or returns the redirect
+     * (in an opaque fashion).
+     *
+     * Sets request's redirect.
+     */
+    redirect?: "error" | "follow" | "manual";
+
+    /**
+     * A string whose value is a same-origin URL, "about:client", or the
+     * empty string, to set request's referrer.
+     */
+    referrer?: string;
+
+    /**
+     * A referrer policy to set request's referrerPolicy.
+     */
+    referrerPolicy?:
+      | ""
+      | "no-referrer"
+      | "no-referrer-when-downgrade"
+      | "origin"
+      | "origin-when-cross-origin"
+      | "same-origin"
+      | "strict-origin"
+      | "strict-origin-when-cross-origin"
+      | "unsafe-url";
+
+    /**
+     * An AbortSignal to set request's signal.
+     */
+    signal?: AbortSignal | null;
+  }
+
+  /**
+   * Type of allowed header values.
+   *
+   * Only atomic or array of atomic values are allowed.
+   */
+  export type HeaderValue =
+    | string
+    | boolean
+    | number
+    | bigint
+    | string
+    | Array<boolean>
+    | Array<number>
+    | Array<bigint>
+    | Array<number>
+    | Array<string>;
+
+  /**
+   * Type of headers
+   *
+   * `Headerify` removes every properties that are not allowed in the
+   * HTTP headers type.
+   *
+   * Below are list of prohibited in HTTP headers.
+   *
+   * 1. Value type one of {@link HeaderValue}
+   * 2. Key is "set-cookie", but value is not an Array type
+   * 3. Key is one of them, but value is 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"
+   */
+  export type Headerify<T extends object> = {
+    [P in keyof T]?: T[P] extends HeaderValue | undefined
+      ? P extends string
+        ? Lowercase<P> extends "set-cookie"
+          ? T[P] extends Array<HeaderValue>
+            ? T[P] | undefined
+            : never
+          : Lowercase<P> extends
+              | "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"
+          ? T[P] extends Array<HeaderValue>
+            ? never
+            : T[P] | undefined
+          : T[P] | undefined
+        : never
+      : never;
+  };
+}