@nestia/fetcher 10.0.1 → 11.0.0-dev.20260305

package/src/internal/FetcherBase.ts

@@ -1,235 +1,235 @@
-import { HttpError } from "../HttpError";
-import { IConnection } from "../IConnection";
-import { IFetchEvent } from "../IFetchEvent";
-import { IFetchRoute } from "../IFetchRoute";
-import { IPropagation } from "../IPropagation";
-
-/** @internal */
-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 const request =
-    (props: IProps) =>
-    async <Input, Output>(
-      connection: IConnection,
-      route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
-      input?: Input,
-      stringify?: (input: Input) => string,
-    ): Promise<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 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);
-
-  /** @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 MESSAGE
-      //----
-      // 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.`,
-          );
-        else if (route.request.type !== "multipart/form-data")
-          headers["Content-Type"] = route.request.type;
-      } else if (input === undefined && headers["Content-Type"] !== undefined)
-        delete headers["Content-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;
-        })(),
-      };
-
-      // 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 === "multipart/form-data"
-              ? request_form_data_body(input as any)
-              : route.request?.type !== "text/plain"
-                ? (stringify ?? JSON.stringify)(input)
-                : input,
-          headers,
-        );
-
-      //----
-      // RESPONSE MESSAGE
-      //----
-      // 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 event: IFetchEvent = {
-        route,
-        path,
-        status: null,
-        input,
-        output: undefined,
-        started_at: new Date(),
-        respond_at: null,
-        completed_at: null!,
-      };
-      try {
-        // TRY FETCH
-        const response: Response = await (connection.fetch ?? fetch)(
-          url.href,
-          init,
-        );
-        event.respond_at = new Date();
-        event.status = response.status;
-
-        // 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);
-        }
-        event.output = result.data;
-        return result;
-      } catch (exp) {
-        throw exp;
-      } finally {
-        event.completed_at = new Date();
-        if (connection.logger)
-          try {
-            await connection.logger(event);
-          } catch {}
-      }
-    };
-}
-
-/** @internal */
-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;
-};
-
-/** @internal */
-const request_form_data_body = (input: Record<string, any>): FormData => {
-  const encoded: FormData = new FormData();
-  const append = (key: string) => (value: any) => {
-    if (value === undefined) return;
-    else if (typeof File === "function" && value instanceof File)
-      encoded.append(key, value, value.name);
-    else encoded.append(key, value);
-  };
-  for (const [key, value] of Object.entries(input))
-    if (Array.isArray(value)) value.map(append(key));
-    else append(key)(value);
-  return encoded;
-};
-
-/** @internal */
-const response_headers_to_object = (
-  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;
-};
+import { HttpError } from "../HttpError";
+import { IConnection } from "../IConnection";
+import { IFetchEvent } from "../IFetchEvent";
+import { IFetchRoute } from "../IFetchRoute";
+import { IPropagation } from "../IPropagation";
+
+/** @internal */
+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 const request =
+    (props: IProps) =>
+    async <Input, Output>(
+      connection: IConnection,
+      route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+      input?: Input,
+      stringify?: (input: Input) => string,
+    ): Promise<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 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);
+
+  /** @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 MESSAGE
+      //----
+      // 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.`,
+          );
+        else if (route.request.type !== "multipart/form-data")
+          headers["Content-Type"] = route.request.type;
+      } else if (input === undefined && headers["Content-Type"] !== undefined)
+        delete headers["Content-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;
+        })(),
+      };
+
+      // 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 === "multipart/form-data"
+              ? request_form_data_body(input as any)
+              : route.request?.type !== "text/plain"
+                ? (stringify ?? JSON.stringify)(input)
+                : input,
+          headers,
+        );
+
+      //----
+      // RESPONSE MESSAGE
+      //----
+      // 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 event: IFetchEvent = {
+        route,
+        path,
+        status: null,
+        input,
+        output: undefined,
+        started_at: new Date(),
+        respond_at: null,
+        completed_at: null!,
+      };
+      try {
+        // TRY FETCH
+        const response: Response = await (connection.fetch ?? fetch)(
+          url.href,
+          init,
+        );
+        event.respond_at = new Date();
+        event.status = response.status;
+
+        // 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);
+        }
+        event.output = result.data;
+        return result;
+      } catch (exp) {
+        throw exp;
+      } finally {
+        event.completed_at = new Date();
+        if (connection.logger)
+          try {
+            await connection.logger(event);
+          } catch {}
+      }
+    };
+}
+
+/** @internal */
+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;
+};
+
+/** @internal */
+const request_form_data_body = (input: Record<string, any>): FormData => {
+  const encoded: FormData = new FormData();
+  const append = (key: string) => (value: any) => {
+    if (value === undefined) return;
+    else if (typeof File === "function" && value instanceof File)
+      encoded.append(key, value, value.name);
+    else encoded.append(key, value);
+  };
+  for (const [key, value] of Object.entries(input))
+    if (Array.isArray(value)) value.map(append(key));
+    else append(key)(value);
+  return encoded;
+};
+
+/** @internal */
+const response_headers_to_object = (
+  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;
+};

package/lib/AesPkcs5.d.ts

@@ -1,30 +0,0 @@
-/**
- * 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 declare namespace AesPkcs5 {
-    /**
-     * Encrypt data
-     *
-     * @param data Target data
-     * @param key Key value of the encryption.
-     * @param iv Initializer Vector for the encryption
-     * @returns Encrypted data
-     */
-    function encrypt(data: string, key: string, iv: string): string;
-    /**
-     * Decrypt data.
-     *
-     * @param data Target data
-     * @param key Key value of the decryption.
-     * @param iv Initializer Vector for the decryption
-     * @returns Decrypted data.
-     */
-    function decrypt(data: string, key: string, iv: string): string;
-}

package/lib/AesPkcs5.js

@@ -1,49 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AesPkcs5 = void 0;
-var crypto_1 = __importDefault(require("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
- */
-var AesPkcs5;
-(function (AesPkcs5) {
-    /**
-     * Encrypt data
-     *
-     * @param data Target data
-     * @param key Key value of the encryption.
-     * @param iv Initializer Vector for the encryption
-     * @returns Encrypted data
-     */
-    function encrypt(data, key, iv) {
-        var bytes = key.length * 8;
-        var cipher = crypto_1.default.createCipheriv("AES-".concat(bytes, "-CBC"), key, iv);
-        return cipher.update(data, "utf8", "base64") + cipher.final("base64");
-    }
-    AesPkcs5.encrypt = encrypt;
-    /**
-     * Decrypt data.
-     *
-     * @param data Target data
-     * @param key Key value of the decryption.
-     * @param iv Initializer Vector for the decryption
-     * @returns Decrypted data.
-     */
-    function decrypt(data, key, iv) {
-        var bytes = key.length * 8;
-        var decipher = crypto_1.default.createDecipheriv("AES-".concat(bytes, "-CBC"), key, iv);
-        return decipher.update(data, "base64", "utf8") + decipher.final("utf8");
-    }
-    AesPkcs5.decrypt = decrypt;
-})(AesPkcs5 || (exports.AesPkcs5 = AesPkcs5 = {}));
-//# sourceMappingURL=AesPkcs5.js.map

package/lib/AesPkcs5.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AesPkcs5.js","sourceRoot":"","sources":["../src/AesPkcs5.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA4B;AAE5B;;;;;;;;;GASG;AACH,IAAiB,QAAQ,CAoCxB;AApCD,WAAiB,QAAQ;IACvB;;;;;;;OAOG;IACH,SAAgB,OAAO,CAAC,IAAY,EAAE,GAAW,EAAE,EAAU;QAC3D,IAAM,KAAK,GAAW,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QACrC,IAAM,MAAM,GAAkB,gBAAM,CAAC,cAAc,CACjD,cAAO,KAAK,SAAM,EAClB,GAAG,EACH,EAAE,CACH,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;IARe,gBAAO,UAQtB,CAAA;IAED;;;;;;;OAOG;IACH,SAAgB,OAAO,CAAC,IAAY,EAAE,GAAW,EAAE,EAAU;QAC3D,IAAM,KAAK,GAAW,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QACrC,IAAM,QAAQ,GAAoB,gBAAM,CAAC,gBAAgB,CACvD,cAAO,KAAK,SAAM,EAClB,GAAG,EACH,EAAE,CACH,CAAC;QACF,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;IARe,gBAAO,UAQtB,CAAA;AACH,CAAC,EApCgB,QAAQ,wBAAR,QAAQ,QAoCxB"}

package/lib/EncryptedFetcher.d.ts

@@ -1,47 +0,0 @@
-import { IConnection } from "./IConnection";
-import { IFetchRoute } from "./IFetchRoute";
-import { IPropagation } from "./IPropagation";
-/**
- * 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 declare 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
-     * @returns Nothing because of `HEAD` method
-     */
-    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
-     * @returns Response body data from the remote API
-     */
-    function fetch<Output>(connection: IConnection, route: IFetchRoute<"GET">): Promise<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
-     * @returns Response body data from the remote API
-     */
-    function fetch<Input, Output>(connection: IConnection, route: IFetchRoute<"POST" | "PUT" | "PATCH" | "DELETE">, input?: Input, stringify?: (input: Input) => string): Promise<Output>;
-    function propagate<Output extends IPropagation<any, any>>(connection: IConnection, route: IFetchRoute<"GET" | "HEAD">): Promise<Output>;
-    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>;
-}