@nestia/fetcher 10.0.2 → 11.0.0-dev.20260305

package/src/IFetchRoute.ts

@@ -1,60 +1,60 @@
-/**
- * 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,99 +1,99 @@
-/**
- * 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.
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @template StatusMap Map of status code and its body data type.
- * @template Success Default success status code.
- */
-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.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @template StatusMap Map of status code and its body data type.
+ * @template Success Default success status code.
+ */
+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"]]>;
+}

package/src/NestiaSimulator.ts

@@ -1,82 +1,82 @@
-import { HttpError } from "./HttpError";
-
-export namespace NestiaSimulator {
-  export interface IProps {
-    host: string;
-    path: string;
-    method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
-    contentType: string;
-  }
-
-  export const assert = (props: IProps) => {
-    return {
-      param: param(props),
-      query: query(props),
-      body: body(props),
-    };
-  };
-  const param =
-    (props: IProps) =>
-    (name: string) =>
-    <T>(task: () => T): void => {
-      validate((exp) => `URL parameter "${name}" is not ${exp.expected} type.`)(
-        props,
-      )(task);
-    };
-
-  const query =
-    (props: IProps) =>
-    <T>(task: () => T): void =>
-      validate(
-        () => "Request query parameters are not following the promised type.",
-      )(props)(task);
-
-  const body =
-    (props: IProps) =>
-    <T>(task: () => T): void =>
-      validate(() => "Request body is not following the promised type.")(props)(
-        task,
-      );
-
-  const validate =
-    (message: (exp: TypeGuardError) => string, path?: string) =>
-    (props: IProps) =>
-    <T>(task: () => T): void => {
-      try {
-        task();
-      } catch (exp) {
-        if (isTypeGuardError(exp))
-          throw new HttpError(
-            props.method,
-            props.host + props.path,
-            400,
-            {
-              "Content-Type": props.contentType,
-            },
-            JSON.stringify({
-              method: exp.method,
-              path: path ?? exp.path,
-              expected: exp.expected,
-              value: exp.value,
-              message: message(exp),
-            }),
-          );
-        throw exp;
-      }
-    };
-}
-
-const isTypeGuardError = (input: any): input is TypeGuardError =>
-  "string" === typeof input.method &&
-  (undefined === input.path || "string" === typeof input.path) &&
-  "string" === typeof input.expected &&
-  "string" === typeof input.name &&
-  "string" === typeof input.message &&
-  (undefined === input.stack || "string" === typeof input.stack);
-
-interface TypeGuardError extends Error {
-  method: string;
-  path: string | undefined;
-  expected: string;
-  value: any;
-}
+import { HttpError } from "./HttpError";
+
+export namespace NestiaSimulator {
+  export interface IProps {
+    host: string;
+    path: string;
+    method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+    contentType: string;
+  }
+
+  export const assert = (props: IProps) => {
+    return {
+      param: param(props),
+      query: query(props),
+      body: body(props),
+    };
+  };
+  const param =
+    (props: IProps) =>
+    (name: string) =>
+    <T>(task: () => T): void => {
+      validate((exp) => `URL parameter "${name}" is not ${exp.expected} type.`)(
+        props,
+      )(task);
+    };
+
+  const query =
+    (props: IProps) =>
+    <T>(task: () => T): void =>
+      validate(
+        () => "Request query parameters are not following the promised type.",
+      )(props)(task);
+
+  const body =
+    (props: IProps) =>
+    <T>(task: () => T): void =>
+      validate(() => "Request body is not following the promised type.")(props)(
+        task,
+      );
+
+  const validate =
+    (message: (exp: TypeGuardError) => string, path?: string) =>
+    (props: IProps) =>
+    <T>(task: () => T): void => {
+      try {
+        task();
+      } catch (exp) {
+        if (isTypeGuardError(exp))
+          throw new HttpError(
+            props.method,
+            props.host + props.path,
+            400,
+            {
+              "Content-Type": props.contentType,
+            },
+            JSON.stringify({
+              method: exp.method,
+              path: path ?? exp.path,
+              expected: exp.expected,
+              value: exp.value,
+              message: message(exp),
+            }),
+          );
+        throw exp;
+      }
+    };
+}
+
+const isTypeGuardError = (input: any): input is TypeGuardError =>
+  "string" === typeof input.method &&
+  (undefined === input.path || "string" === typeof input.path) &&
+  "string" === typeof input.expected &&
+  "string" === typeof input.name &&
+  "string" === typeof input.message &&
+  (undefined === input.stack || "string" === typeof input.stack);
+
+interface TypeGuardError extends Error {
+  method: string;
+  path: string | undefined;
+  expected: string;
+  value: any;
+}