@nestia/fetcher 2.4.2 → 2.4.3

package/src/internal/FetcherBase.ts

@@ -1,224 +1,212 @@
 import import2 from "import2";
+
+import { HttpError } from "../HttpError";
 import { IConnection } from "../IConnection";
+import { IPropagation } from "../IPropagation";
 import { Primitive } from "../Primitive";
 import { IFetchRoute } from "./IFetchRoute";
 import { Singleton } from "./Singleton";
-import { HttpError } from "../HttpError";
-import { IPropagation } from "../IPropagation";
 
 export namespace FetcherBase {
-    export interface IProps {
-        className: string;
-        encode: (
-            input: any,
-            headers: Record<string, IConnection.HeaderValue | undefined>,
-        ) => string;
-        decode: (
-            input: string,
-            headers: Record<string, IConnection.HeaderValue | undefined>,
-        ) => any;
-    }
+  export interface IProps {
+    className: string;
+    encode: (
+      input: any,
+      headers: Record<string, IConnection.HeaderValue | undefined>,
+    ) => string;
+    decode: (
+      input: string,
+      headers: Record<string, IConnection.HeaderValue | undefined>,
+    ) => any;
+  }
 
-    export const fetch =
-        (props: IProps) =>
-        async <Input, Output>(
-            connection: IConnection,
-            route: IFetchRoute<
-                "DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT"
-            >,
-            input?: Input,
-            stringify?: (input: Input) => string,
-        ): Promise<Primitive<Output>> => {
-            const result = await _Propagate("fetch")(props)(
-                connection,
-                route,
-                input,
-                stringify,
-            );
-            if ((result as any).success === false)
-                throw new HttpError(
-                    route.method,
-                    route.path,
-                    result.status as any as number,
-                    result.headers,
-                    result.data as string,
-                );
-            return result.data as Primitive<Output>;
-        };
+  export const fetch =
+    (props: IProps) =>
+    async <Input, Output>(
+      connection: IConnection,
+      route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+      input?: Input,
+      stringify?: (input: Input) => string,
+    ): Promise<Primitive<Output>> => {
+      const result = await _Propagate("fetch")(props)(
+        connection,
+        route,
+        input,
+        stringify,
+      );
+      if ((result as any).success === false)
+        throw new HttpError(
+          route.method,
+          route.path,
+          result.status as any as number,
+          result.headers,
+          result.data as string,
+        );
+      return result.data as Primitive<Output>;
+    };
 
-    export const propagate =
-        (props: IProps) =>
-        async <Input>(
-            connection: IConnection,
-            route: IFetchRoute<
-                "DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT"
-            >,
-            input?: Input,
-            stringify?: (input: Input) => string,
-        ): Promise<IPropagation<any, any>> =>
-            _Propagate("propagate")(props)(connection, route, input, stringify);
+  export const propagate =
+    (props: IProps) =>
+    async <Input>(
+      connection: IConnection,
+      route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+      input?: Input,
+      stringify?: (input: Input) => string,
+    ): Promise<IPropagation<any, any>> =>
+      _Propagate("propagate")(props)(connection, route, input, stringify);
 
-    /**
-     * @internal
-     */
-    const _Propagate =
-        (method: string) =>
-        (props: IProps) =>
-        async <Input>(
-            connection: IConnection,
-            route: IFetchRoute<
-                "DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT"
-            >,
-            input?: Input,
-            stringify?: (input: Input) => string,
-        ): Promise<IPropagation<any, any>> => {
-            //----
-            // REQUEST MESSSAGE
-            //----
-            // METHOD & HEADERS
-            const headers: Record<string, IConnection.HeaderValue | undefined> =
-                {
-                    ...(connection.headers ?? {}),
-                };
-            if (input !== undefined) {
-                if (route.request?.type === undefined)
-                    throw new Error(
-                        `Error on ${props.className}.fetch(): no content-type being configured.`,
-                    );
-                headers["Content-Type"] = route.request.type;
-            }
+  /**
+   * @internal
+   */
+  const _Propagate =
+    (method: string) =>
+    (props: IProps) =>
+    async <Input>(
+      connection: IConnection,
+      route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+      input?: Input,
+      stringify?: (input: Input) => string,
+    ): Promise<IPropagation<any, any>> => {
+      //----
+      // REQUEST MESSSAGE
+      //----
+      // METHOD & HEADERS
+      const headers: Record<string, IConnection.HeaderValue | undefined> = {
+        ...(connection.headers ?? {}),
+      };
+      if (input !== undefined) {
+        if (route.request?.type === undefined)
+          throw new Error(
+            `Error on ${props.className}.fetch(): no content-type being configured.`,
+          );
+        headers["Content-Type"] = route.request.type;
+      }
 
-            // INIT REQUEST DATA
-            const init: RequestInit = {
-                ...(connection.options ?? {}),
-                method: route.method,
-                headers: (() => {
-                    const output: [string, string][] = [];
-                    for (const [key, value] of Object.entries(headers))
-                        if (value === undefined) continue;
-                        else if (Array.isArray(value))
-                            for (const v of value)
-                                output.push([key, String(v)]);
-                        else output.push([key, String(value)]);
-                    return output;
-                })(),
-            };
+      // INIT REQUEST DATA
+      const init: RequestInit = {
+        ...(connection.options ?? {}),
+        method: route.method,
+        headers: (() => {
+          const output: [string, string][] = [];
+          for (const [key, value] of Object.entries(headers))
+            if (value === undefined) continue;
+            else if (Array.isArray(value))
+              for (const v of value) output.push([key, String(v)]);
+            else output.push([key, String(value)]);
+          return output;
+        })(),
+      };
 
-            // CONSTRUCT BODY DATA
-            if (input !== undefined)
-                init.body = props.encode(
-                    // BODY TRANSFORM
-                    route.request?.type === "application/x-www-form-urlencoded"
-                        ? request_query_body(input)
-                        : route.request?.type !== "text/plain"
-                        ? (stringify ?? JSON.stringify)(input)
-                        : input,
-                    headers,
-                );
+      // CONSTRUCT BODY DATA
+      if (input !== undefined)
+        init.body = props.encode(
+          // BODY TRANSFORM
+          route.request?.type === "application/x-www-form-urlencoded"
+            ? request_query_body(input)
+            : route.request?.type !== "text/plain"
+            ? (stringify ?? JSON.stringify)(input)
+            : input,
+          headers,
+        );
 
-            //----
-            // RESPONSE MESSSAGE
-            //----
-            // URL SPECIFICATION
-            const path: string =
-                connection.host[connection.host.length - 1] !== "/" &&
-                route.path[0] !== "/"
-                    ? `/${route.path}`
-                    : route.path;
-            const url: URL = new URL(`${connection.host}${path}`);
+      //----
+      // RESPONSE MESSSAGE
+      //----
+      // URL SPECIFICATION
+      const path: string =
+        connection.host[connection.host.length - 1] !== "/" &&
+        route.path[0] !== "/"
+          ? `/${route.path}`
+          : route.path;
+      const url: URL = new URL(`${connection.host}${path}`);
 
-            // DO FETCH
-            const response: Response = await (
-                connection.fetch ?? (await polyfill.get())
-            )(url.href, init);
+      // DO FETCH
+      const response: Response = await (
+        connection.fetch ?? (await polyfill.get())
+      )(url.href, init);
 
-            // CONSTRUCT RESULT DATA
-            const result: IPropagation<any, any> = {
-                success:
-                    response.status === 200 ||
-                    response.status === 201 ||
-                    response.status == route.status,
-                status: response.status,
-                headers: response_headers_to_object(response.headers),
-                data: undefined!,
-            } as any;
-            if ((result as any).success === false) {
-                // WHEN FAILED
-                result.data = await response.text();
-                const type = response.headers.get("content-type");
-                if (
-                    method !== "fetch" &&
-                    type &&
-                    type.indexOf("application/json") !== -1
-                )
-                    try {
-                        result.data = JSON.parse(result.data);
-                    } catch {}
-            } else {
-                // WHEN SUCCESS
-                if (route.method === "HEAD") result.data = undefined!;
-                else if (route.response?.type === "application/json") {
-                    const text: string = await response.text();
-                    result.data = text.length ? JSON.parse(text) : undefined;
-                } else if (
-                    route.response?.type === "application/x-www-form-urlencoded"
-                ) {
-                    const query: URLSearchParams = new URLSearchParams(
-                        await response.text(),
-                    );
-                    result.data = route.parseQuery
-                        ? route.parseQuery(query)
-                        : query;
-                } else
-                    result.data = props.decode(
-                        await response.text(),
-                        result.headers,
-                    );
-            }
-            return result;
-        };
+      // CONSTRUCT RESULT DATA
+      const result: IPropagation<any, any> = {
+        success:
+          response.status === 200 ||
+          response.status === 201 ||
+          response.status == route.status,
+        status: response.status,
+        headers: response_headers_to_object(response.headers),
+        data: undefined!,
+      } as any;
+      if ((result as any).success === false) {
+        // WHEN FAILED
+        result.data = await response.text();
+        const type = response.headers.get("content-type");
+        if (
+          method !== "fetch" &&
+          type &&
+          type.indexOf("application/json") !== -1
+        )
+          try {
+            result.data = JSON.parse(result.data);
+          } catch {}
+      } else {
+        // WHEN SUCCESS
+        if (route.method === "HEAD") result.data = undefined!;
+        else if (route.response?.type === "application/json") {
+          const text: string = await response.text();
+          result.data = text.length ? JSON.parse(text) : undefined;
+        } else if (
+          route.response?.type === "application/x-www-form-urlencoded"
+        ) {
+          const query: URLSearchParams = new URLSearchParams(
+            await response.text(),
+          );
+          result.data = route.parseQuery ? route.parseQuery(query) : query;
+        } else
+          result.data = props.decode(await response.text(), result.headers);
+      }
+      return result;
+    };
 }
 
 /**
  * @internal
  */
 const polyfill = new Singleton(async (): Promise<typeof fetch> => {
-    if (
-        typeof global === "object" &&
-        typeof global.process === "object" &&
-        typeof global.process.versions === "object" &&
-        typeof global.process.versions.node !== undefined
-    ) {
-        global.fetch ??= ((await import2("node-fetch")) as any).default;
-        return (global as any).fetch;
-    }
-    return window.fetch;
+  if (
+    typeof global === "object" &&
+    typeof global.process === "object" &&
+    typeof global.process.versions === "object" &&
+    typeof global.process.versions.node !== undefined
+  ) {
+    global.fetch ??= ((await import2("node-fetch")) as any).default;
+    return (global as any).fetch;
+  }
+  return window.fetch;
 });
 
 const request_query_body = (input: any): URLSearchParams => {
-    const q: URLSearchParams = new URLSearchParams();
-    for (const [key, value] of Object.entries(input))
-        if (value === undefined) continue;
-        else if (Array.isArray(value))
-            value.forEach((elem) => q.append(key, String(elem)));
-        else q.set(key, String(value));
-    return q;
+  const q: URLSearchParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(input))
+    if (value === undefined) continue;
+    else if (Array.isArray(value))
+      value.forEach((elem) => q.append(key, String(elem)));
+    else q.set(key, String(value));
+  return q;
 };
 
 /**
  * @internal
  */
 const response_headers_to_object = (
-    headers: Headers,
+  headers: Headers,
 ): Record<string, string | string[]> => {
-    const output: Record<string, string | string[]> = {};
-    headers.forEach((value, key) => {
-        if (key === "set-cookie") {
-            output[key] ??= [];
-            (output[key] as string[]).push(
-                ...value.split(";").map((str) => str.trim()),
-            );
-        } else output[key] = value;
-    });
-    return output;
+  const output: Record<string, string | string[]> = {};
+  headers.forEach((value, key) => {
+    if (key === "set-cookie") {
+      output[key] ??= [];
+      (output[key] as string[]).push(
+        ...value.split(";").map((str) => str.trim()),
+      );
+    } else output[key] = value;
+  });
+  return output;
 };

package/src/internal/IFetchRoute.ts

@@ -4,58 +4,58 @@
  * @author Jeongho Nam - https://github.com/samchon
  */
 export interface IFetchRoute<
-    Method extends "HEAD" | "GET" | "POST" | "PUT" | "PATCH" | "DELETE",
+  Method extends "HEAD" | "GET" | "POST" | "PUT" | "PATCH" | "DELETE",
 > {
-    /**
-     * Method of the HTTP request.
-     */
-    method: Method;
+  /**
+   * Method of the HTTP request.
+   */
+  method: Method;
 
-    /**
-     * Path of the HTTP request.
-     */
-    path: string;
+  /**
+   * Path of the HTTP request.
+   */
+  path: string;
 
-    /**
-     * Request body data info.
-     */
-    request: Method extends "DELETE" | "POST" | "PUT" | "PATCH"
-        ? IFetchRoute.IBody | null
-        : null;
+  /**
+   * 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;
+  /**
+   * Response body data info.
+   */
+  response: Method extends "HEAD" ? null : IFetchRoute.IBody;
 
-    /**
-     * When special status code being used.
-     */
-    status: number | null;
+  /**
+   * 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;
+  /**
+   * 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;
-    }
+  /**
+   * 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 = {};