@nestia/fetcher 7.1.1-dev.20250714 → 7.2.0

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

@@ -1,31 +1,31 @@
-// import { IConnection } from "./IConnection";
-import { IFetchRoute } from "./IFetchRoute";
-
-export interface IFetchEvent {
-  route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">;
-  path: string;
-  status: number | null;
-  input: any;
-  output: any;
-  started_at: Date;
-  respond_at: Date | null;
-  completed_at: Date;
-}
-// export namespace IFetchEvent {
-//   export interface IFunction {
-//     (connection: IConnection, ...args: any[]): Promise<any>;
-//     METADATA: {
-//       method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
-//       path: string;
-//       request: null | {
-//         type: string;
-//         encrypted: boolean;
-//       };
-//       response: null | {
-//         type: string;
-//         encrypted: boolean;
-//       };
-//     };
-//     status: null | number;
-//   }
-// }
+// import { IConnection } from "./IConnection";
+import { IFetchRoute } from "./IFetchRoute";
+
+export interface IFetchEvent {
+  route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">;
+  path: string;
+  status: number | null;
+  input: any;
+  output: any;
+  started_at: Date;
+  respond_at: Date | null;
+  completed_at: Date;
+}
+// export namespace IFetchEvent {
+//   export interface IFunction {
+//     (connection: IConnection, ...args: any[]): Promise<any>;
+//     METADATA: {
+//       method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+//       path: string;
+//       request: null | {
+//         type: string;
+//         encrypted: boolean;
+//       };
+//       response: null | {
+//         type: string;
+//         encrypted: boolean;
+//       };
+//     };
+//     status: null | number;
+//   }
+// }

package/src/IFetchRoute.ts

@@ -1,69 +1,69 @@
-/**
- * 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;
-
-  /**
-   * Path template.
-   *
-   * Filled since 3.2.2 version.
-   */
-  template?: 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"
-      | "multipart/form-data"
-      | "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;
+
+  /**
+   * Path template.
+   *
+   * Filled since 3.2.2 version.
+   */
+  template?: 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"
+      | "multipart/form-data"
+      | "text/plain";
+    encrypted?: boolean;
+  }
+}

package/src/IPropagation.ts

@@ -1,100 +1,100 @@
-/**
- * Propagation type.
- *
- * `IPropagation` is a type gathering all possible status codes and their body
- * data types as a discriminated union type. You can specify the status code and
- * its body data type just by using conditional statement like below.
- *
- * ```typescript
- * type Output = IPropagation<{
- *    200: ISeller.IAuthorized;
- *    400: TypeGuardError.IProps;
- * >};
- *
- * const output: Output = await sdk.sellers.authenticate.join(input);
- * if (output.success) {
- *     // automatically casted to "ISeller.IAuthorized" type
- *     const authorized: ISeller.IAuthorized = output.data;
- * } else if (output.status === 400) {
- *     // automatically casted to "TypeGuardError.IProps" type
- *     const error: TypeGuardError.IProps = output.data;
- * } else {
- *     // unknown type when out of pre-defined status codes
- *     const result: unknown = output.data;
- * }
- * ```
- *
- * For reference, this `IPropagation` type is utilized by SDK library generated by
- * `@nestia/sdk`, when you've configured {@link INestiaConfig.propagate} to be `true`.
- * In that case, SDK functions generated by `@nestia/sdk` no more returns response DTO
- * typed data directly, but returns this `IPropagation` typed object instead.
- *
- * @template StatusMap Map of status code and its body data type.
- * @template Success Default success status code.
- * @author Jeongho Nam - https://github.com/samchon
- */
-export type IPropagation<
-  StatusMap extends {
-    [P in IPropagation.Status]?: any;
-  },
-  Success extends number = 200 | 201,
-> =
-  | {
-      [P in keyof StatusMap]: IPropagation.IBranch<
-        P extends Success ? true : false,
-        P,
-        StatusMap[P]
-      >;
-    }[keyof StatusMap]
-  | IPropagation.IBranch<false, unknown, unknown>;
-export namespace IPropagation {
-  /**
-   * Type of configurable status codes.
-   *
-   * The special characters like `2XX`, `3XX`, `4XX`, `5XX` are meaning the range
-   * of status codes. If `5XX` is specified, it means the status code is in the
-   * range of `500` to `599`.
-   */
-  export type Status = number | "2XX" | "3XX" | "4XX" | "5XX";
-
-  /**
-   * Branch type of propagation.
-   *
-   * `IPropagation.IBranch` is a branch type composing `IPropagation` type,
-   * which is gathering all possible status codes and their body data types
-   * as a union type.
-   */
-  export interface IBranch<Success extends boolean, StatusValue, BodyData> {
-    success: Success;
-    status: StatusValue extends "2XX" | "3XX" | "4XX" | "5XX"
-      ? StatusRange<StatusValue>
-      : StatusValue extends number
-        ? StatusValue
-        : never;
-    data: BodyData;
-    headers: Record<string, string | string[]>;
-  }
-
-  /**
-   * Range of status codes by the first digit.
-   */
-  export type StatusRange<T extends "2XX" | "3XX" | "4XX" | "5XX"> = T extends 0
-    ? IntRange<200, 299>
-    : T extends 3
-      ? IntRange<300, 399>
-      : T extends 4
-        ? IntRange<400, 499>
-        : IntRange<500, 599>;
-
-  type IntRange<F extends number, T extends number> = Exclude<
-    Enumerate<T>,
-    Enumerate<F>
-  >;
-
-  type Enumerate<
-    N extends number,
-    Acc extends number[] = [],
-  > = Acc["length"] extends N
-    ? Acc[number]
-    : Enumerate<N, [...Acc, Acc["length"]]>;
-}
+/**
+ * Propagation type.
+ *
+ * `IPropagation` is a type gathering all possible status codes and their body
+ * data types as a discriminated union type. You can specify the status code and
+ * its body data type just by using conditional statement like below.
+ *
+ * ```typescript
+ * type Output = IPropagation<{
+ *    200: ISeller.IAuthorized;
+ *    400: TypeGuardError.IProps;
+ * >};
+ *
+ * const output: Output = await sdk.sellers.authenticate.join(input);
+ * if (output.success) {
+ *     // automatically casted to "ISeller.IAuthorized" type
+ *     const authorized: ISeller.IAuthorized = output.data;
+ * } else if (output.status === 400) {
+ *     // automatically casted to "TypeGuardError.IProps" type
+ *     const error: TypeGuardError.IProps = output.data;
+ * } else {
+ *     // unknown type when out of pre-defined status codes
+ *     const result: unknown = output.data;
+ * }
+ * ```
+ *
+ * For reference, this `IPropagation` type is utilized by SDK library generated by
+ * `@nestia/sdk`, when you've configured {@link INestiaConfig.propagate} to be `true`.
+ * In that case, SDK functions generated by `@nestia/sdk` no more returns response DTO
+ * typed data directly, but returns this `IPropagation` typed object instead.
+ *
+ * @template StatusMap Map of status code and its body data type.
+ * @template Success Default success status code.
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type IPropagation<
+  StatusMap extends {
+    [P in IPropagation.Status]?: any;
+  },
+  Success extends number = 200 | 201,
+> =
+  | {
+      [P in keyof StatusMap]: IPropagation.IBranch<
+        P extends Success ? true : false,
+        P,
+        StatusMap[P]
+      >;
+    }[keyof StatusMap]
+  | IPropagation.IBranch<false, unknown, unknown>;
+export namespace IPropagation {
+  /**
+   * Type of configurable status codes.
+   *
+   * The special characters like `2XX`, `3XX`, `4XX`, `5XX` are meaning the range
+   * of status codes. If `5XX` is specified, it means the status code is in the
+   * range of `500` to `599`.
+   */
+  export type Status = number | "2XX" | "3XX" | "4XX" | "5XX";
+
+  /**
+   * Branch type of propagation.
+   *
+   * `IPropagation.IBranch` is a branch type composing `IPropagation` type,
+   * which is gathering all possible status codes and their body data types
+   * as a union type.
+   */
+  export interface IBranch<Success extends boolean, StatusValue, BodyData> {
+    success: Success;
+    status: StatusValue extends "2XX" | "3XX" | "4XX" | "5XX"
+      ? StatusRange<StatusValue>
+      : StatusValue extends number
+        ? StatusValue
+        : never;
+    data: BodyData;
+    headers: Record<string, string | string[]>;
+  }
+
+  /**
+   * Range of status codes by the first digit.
+   */
+  export type StatusRange<T extends "2XX" | "3XX" | "4XX" | "5XX"> = T extends 0
+    ? IntRange<200, 299>
+    : T extends 3
+      ? IntRange<300, 399>
+      : T extends 4
+        ? IntRange<400, 499>
+        : IntRange<500, 599>;
+
+  type IntRange<F extends number, T extends number> = Exclude<
+    Enumerate<T>,
+    Enumerate<F>
+  >;
+
+  type Enumerate<
+    N extends number,
+    Acc extends number[] = [],
+  > = Acc["length"] extends N
+    ? Acc[number]
+    : Enumerate<N, [...Acc, Acc["length"]]>;
+}