@nestia/fetcher 3.0.0-dev.20231209 → 3.0.0

package/src/Resolved.ts

@@ -1,116 +1,119 @@
-/**
- * Resolved type erased every methods.
- *
- * `Resolved` is a type of TMP (Type Meta Programming) type which converts
- * its argument as a resolved type that erased every method properties.
- *
- * If the target argument is a built-in class which returns its origin primitive type
- * through the `valueOf()` method like the `String` or `Number`, its return type would
- * be the `string` or `number`. Otherwise, the built-in class does not have the
- * `valueOf()` method, the return type would be same with the target argument.
- *
- * Otherwise, the target argument is a type of custom class, all of its custom methods
- * would be erased and its prototype would be changed to the primitive `object`.
- * Therefore, return type of the TMP type finally be the resolved object.
- *
- * Before                  | After
- * ------------------------|----------------------------------------
- * `Boolean`               | `boolean`
- * `Number`                | `number`
- * `BigInt`                | `bigint`
- * `String`                | `string`
- * `Class`                 | `interface`
- * Native Class or Others  | No change
- *
- * @template Instance Target argument type.
- * @author Jeongho Nam - https://github.com/samchon
- * @author Kyungsu Kang - https://github.com/kakasoo
- */
-export type Resolved<T> = Equal<T, ResolvedMain<T>> extends true
-  ? T
-  : ResolvedMain<T>;
-
-type Equal<X, Y> = X extends Y ? (Y extends X ? true : false) : false;
-
-type ResolvedMain<Instance> = Instance extends [never]
-  ? never // (special trick for jsonable | null) type
-  : ValueOf<Instance> extends boolean | number | bigint | string
-  ? ValueOf<Instance>
-  : Instance extends Function
-  ? never
-  : Instance extends object
-  ? ResolvedObject<Instance>
-  : ValueOf<Instance>;
-
-type ResolvedObject<Instance extends object> = Instance extends Array<infer T>
-  ? IsTuple<Instance> extends true
-    ? ResolvedTuple<Instance>
-    : ResolvedMain<T>[]
-  : Instance extends Set<infer U>
-  ? Set<ResolvedMain<U>>
-  : Instance extends Map<infer K, infer V>
-  ? Map<ResolvedMain<K>, ResolvedMain<V>>
-  : Instance extends WeakSet<any> | WeakMap<any, any>
-  ? never
-  : Instance extends
-      | Date
-      | Uint8Array
-      | Uint8ClampedArray
-      | Uint16Array
-      | Uint32Array
-      | BigUint64Array
-      | Int8Array
-      | Int16Array
-      | Int32Array
-      | BigInt64Array
-      | Float32Array
-      | Float64Array
-      | ArrayBuffer
-      | SharedArrayBuffer
-      | DataView
-  ? Instance
-  : {
-      [P in keyof Instance]: ResolvedMain<Instance[P]>;
-    };
-
-type ResolvedTuple<T extends readonly any[]> = T extends []
-  ? []
-  : T extends [infer F]
-  ? [ResolvedMain<F>]
-  : T extends [infer F, ...infer Rest extends readonly any[]]
-  ? [ResolvedMain<F>, ...ResolvedTuple<Rest>]
-  : T extends [(infer F)?]
-  ? [ResolvedMain<F>?]
-  : T extends [(infer F)?, ...infer Rest extends readonly any[]]
-  ? [ResolvedMain<F>?, ...ResolvedTuple<Rest>]
-  : [];
-
-type ValueOf<Instance> = IsValueOf<Instance, Boolean> extends true
-  ? boolean
-  : IsValueOf<Instance, Number> extends true
-  ? number
-  : IsValueOf<Instance, String> extends true
-  ? string
-  : Instance;
-
-type IsTuple<T extends readonly any[] | { length: number }> = [T] extends [
-  never,
-]
-  ? false
-  : T extends readonly any[]
-  ? number extends T["length"]
-    ? false
-    : true
-  : false;
-
-type IsValueOf<Instance, Object extends IValueOf<any>> = Instance extends Object
-  ? Object extends IValueOf<infer Primitive>
-    ? Instance extends Primitive
-      ? false
-      : true // not Primitive, but Object
-    : false // cannot be
-  : false;
-
-interface IValueOf<T> {
-  valueOf(): T;
-}
+/**
+ * Resolved type erased every methods.
+ *
+ * `Resolved` is a type of TMP (Type Meta Programming) type which converts
+ * its argument as a resolved type that erased every method properties.
+ *
+ * If the target argument is a built-in class which returns its origin primitive type
+ * through the `valueOf()` method like the `String` or `Number`, its return type would
+ * be the `string` or `number`. Otherwise, the built-in class does not have the
+ * `valueOf()` method, the return type would be same with the target argument.
+ *
+ * Otherwise, the target argument is a type of custom class, all of its custom methods
+ * would be erased and its prototype would be changed to the primitive `object`.
+ * Therefore, return type of the TMP type finally be the resolved object.
+ *
+ * Before                  | After
+ * ------------------------|----------------------------------------
+ * `Boolean`               | `boolean`
+ * `Number`                | `number`
+ * `BigInt`                | `bigint`
+ * `String`                | `string`
+ * `Class`                 | `interface`
+ * Native Class or Others  | No change
+ *
+ * @template T Target argument type.
+ * @author Jeongho Nam - https://github.com/samchon
+ * @author Kyungsu Kang - https://github.com/kakasoo
+ */
+export type Resolved<T> =
+  Equal<T, ResolvedMain<T>> extends true ? T : ResolvedMain<T>;
+
+type Equal<X, Y> = X extends Y ? (Y extends X ? true : false) : false;
+
+type ResolvedMain<T> = T extends [never]
+  ? never // (special trick for jsonable | null) type
+  : ValueOf<T> extends boolean | number | bigint | string
+    ? ValueOf<T>
+    : T extends Function
+      ? never
+      : T extends object
+        ? ResolvedObject<T>
+        : ValueOf<T>;
+
+type ResolvedObject<T extends object> =
+  T extends Array<infer U>
+    ? IsTuple<T> extends true
+      ? ResolvedTuple<T>
+      : ResolvedMain<U>[]
+    : T extends Set<infer U>
+      ? Set<ResolvedMain<U>>
+      : T extends Map<infer K, infer V>
+        ? Map<ResolvedMain<K>, ResolvedMain<V>>
+        : T extends WeakSet<any> | WeakMap<any, any>
+          ? never
+          : T extends
+                | Date
+                | Uint8Array
+                | Uint8ClampedArray
+                | Uint16Array
+                | Uint32Array
+                | BigUint64Array
+                | Int8Array
+                | Int16Array
+                | Int32Array
+                | BigInt64Array
+                | Float32Array
+                | Float64Array
+                | ArrayBuffer
+                | SharedArrayBuffer
+                | DataView
+                | Blob
+                | File
+            ? T
+            : {
+                [P in keyof T]: ResolvedMain<T[P]>;
+              };
+
+type ResolvedTuple<T extends readonly any[]> = T extends []
+  ? []
+  : T extends [infer F]
+    ? [ResolvedMain<F>]
+    : T extends [infer F, ...infer Rest extends readonly any[]]
+      ? [ResolvedMain<F>, ...ResolvedTuple<Rest>]
+      : T extends [(infer F)?]
+        ? [ResolvedMain<F>?]
+        : T extends [(infer F)?, ...infer Rest extends readonly any[]]
+          ? [ResolvedMain<F>?, ...ResolvedTuple<Rest>]
+          : [];
+
+type IsTuple<T extends readonly any[] | { length: number }> = [T] extends [
+  never,
+]
+  ? false
+  : T extends readonly any[]
+    ? number extends T["length"]
+      ? false
+      : true
+    : false;
+
+type ValueOf<Instance> =
+  IsValueOf<Instance, Boolean> extends true
+    ? boolean
+    : IsValueOf<Instance, Number> extends true
+      ? number
+      : IsValueOf<Instance, String> extends true
+        ? string
+        : Instance;
+
+type IsValueOf<Instance, Object extends IValueOf<any>> = Instance extends Object
+  ? Object extends IValueOf<infer Primitive>
+    ? Instance extends Primitive
+      ? false
+      : true // not Primitive, but Object
+    : false // cannot be
+  : false;
+
+interface IValueOf<T> {
+  valueOf(): T;
+}

package/src/index.ts

@@ -1,7 +1,9 @@
-export * from "./IConnection";
-export * from "./IEncryptionPassword";
-export * from "./IPropagation";
-export * from "./IRandomGenerator";
-export * from "./HttpError";
-export * from "./Primitive";
-export * from "./Resolved";
+export * from "./HttpError";
+export * from "./IConnection";
+export * from "./IEncryptionPassword";
+export * from "./IFetchEvent";
+export * from "./IFetchRoute";
+export * from "./IPropagation";
+export * from "./IRandomGenerator";
+export * from "./Primitive";
+export * from "./Resolved";

package/src/internal/FetcherBase.ts

@@ -2,9 +2,9 @@ import import2 from "import2";
 
 import { HttpError } from "../HttpError";
 import { IConnection } from "../IConnection";
+import { IFetchEvent } from "../IFetchEvent";
+import { IFetchRoute } from "../IFetchRoute";
 import { IPropagation } from "../IPropagation";
-import { Primitive } from "../Primitive";
-import { IFetchRoute } from "./IFetchRoute";
 import { Singleton } from "./Singleton";
 
 export namespace FetcherBase {
@@ -13,9 +13,9 @@ export namespace FetcherBase {
     encode: (
       input: any,
       headers: Record<string, IConnection.HeaderValue | undefined>,
-    ) => string | Uint8Array;
+    ) => string;
     decode: (
-      input: string | Uint8Array,
+      input: string,
       headers: Record<string, IConnection.HeaderValue | undefined>,
     ) => any;
   }
@@ -27,7 +27,7 @@ export namespace FetcherBase {
       route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
       input?: Input,
       stringify?: (input: Input) => string,
-    ): Promise<Primitive<Output>> => {
+    ): Promise<Output> => {
       const result = await _Propagate("fetch")(props)(
         connection,
         route,
@@ -42,7 +42,7 @@ export namespace FetcherBase {
           result.headers,
           result.data as string,
         );
-      return result.data as Primitive<Output>;
+      return result.data as Output;
     };
 
   export const propagate =
@@ -63,7 +63,9 @@ export namespace FetcherBase {
     (props: IProps) =>
     async <Input>(
       connection: IConnection,
-      route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">,
+      metadata: IFetchRoute<
+        "DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT"
+      >,
       input?: Input,
       stringify?: (input: Input) => string,
     ): Promise<IPropagation<any, any>> => {
@@ -74,18 +76,18 @@ export namespace FetcherBase {
       const headers: Record<string, IConnection.HeaderValue | undefined> = {
         ...(connection.headers ?? {}),
       };
-      if (input !== undefined) {
-        if (route.request?.type === undefined)
+      if (input !== undefined)
+        if (metadata.request?.type === undefined)
           throw new Error(
             `Error on ${props.className}.fetch(): no content-type being configured.`,
           );
-        headers["Content-Type"] = route.request.type;
-      }
+        else if (metadata.request.type !== "multipart/form-data")
+          headers["Content-Type"] = metadata.request.type;
 
       // INIT REQUEST DATA
       const init: RequestInit = {
         ...(connection.options ?? {}),
-        method: route.method,
+        method: metadata.method,
         headers: (() => {
           const output: [string, string][] = [];
           for (const [key, value] of Object.entries(headers))
@@ -101,12 +103,13 @@ export namespace FetcherBase {
       if (input !== undefined)
         init.body = props.encode(
           // BODY TRANSFORM
-          route.request?.type === "application/x-www-form-urlencoded"
+          metadata.request?.type === "application/x-www-form-urlencoded"
             ? request_query_body(input)
-            : route.request?.type !== "application/octet-stream" &&
-              route.request?.type !== "text/plain"
-            ? (stringify ?? JSON.stringify)(input)
-            : input,
+            : metadata.request?.type === "multipart/form-data"
+              ? request_form_data_body(input as any)
+              : metadata.request?.type !== "text/plain"
+                ? (stringify ?? JSON.stringify)(input)
+                : input,
           headers,
         );
 
@@ -116,59 +119,81 @@ export namespace FetcherBase {
       // URL SPECIFICATION
       const path: string =
         connection.host[connection.host.length - 1] !== "/" &&
-        route.path[0] !== "/"
-          ? `/${route.path}`
-          : route.path;
+        metadata.path[0] !== "/"
+          ? `/${metadata.path}`
+          : metadata.path;
       const url: URL = new URL(`${connection.host}${path}`);
 
       // DO FETCH
-      const response: Response = await (
-        connection.fetch ?? (await polyfill.get())
-      )(url.href, init);
+      const event: IFetchEvent = {
+        route: metadata,
+        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 ?? (await polyfill.get())
+        )(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
-        )
+        // CONSTRUCT RESULT DATA
+        const result: IPropagation<any, any> = {
+          success:
+            response.status === 200 ||
+            response.status === 201 ||
+            response.status == metadata.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 (metadata.method === "HEAD") result.data = undefined!;
+          else if (metadata.response?.type === "application/json") {
+            const text: string = await response.text();
+            result.data = text.length ? JSON.parse(text) : undefined;
+          } else if (
+            metadata.response?.type === "application/x-www-form-urlencoded"
+          ) {
+            const query: URLSearchParams = new URLSearchParams(
+              await response.text(),
+            );
+            result.data = metadata.parseQuery
+              ? metadata.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 {
-            result.data = JSON.parse(result.data);
+            await connection.logger(event);
           } 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 if (route.response?.type === "application/octet-stream")
-          result.data = props.decode(
-            new Uint8Array(await response.arrayBuffer()),
-            result.headers,
-          );
-        else result.data = await response.text();
       }
-      return result;
     };
 }
 
@@ -176,18 +201,27 @@ export namespace FetcherBase {
  * @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;
+  function is_node_process(m: typeof global | null): boolean {
+    return (
+      m !== null &&
+      typeof m.process === "object" &&
+      m.process !== null &&
+      typeof m.process.versions === "object" &&
+      m.process.versions !== null &&
+      typeof m.process.versions.node !== "undefined"
+    );
   }
-  return window.fetch;
+  if (typeof global === "object" && is_node_process(global)) {
+    const m: any = global as any;
+    m.fetch ??= ((await import2("node-fetch")) as any).default;
+    return (m as any).fetch;
+  }
+  return self.fetch;
 });
 
+/**
+ * @internal
+ */
 const request_query_body = (input: any): URLSearchParams => {
   const q: URLSearchParams = new URLSearchParams();
   for (const [key, value] of Object.entries(input))
@@ -198,6 +232,24 @@ const request_query_body = (input: any): URLSearchParams => {
   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 (value instanceof Blob)
+      if (value instanceof File) encoded.append(key, value, value.name);
+      else encoded.append(key, value);
+    else encoded.append(key, String(value));
+  };
+  for (const [key, value] of Object.entries(input))
+    if (Array.isArray(value)) value.map(append(key));
+    else append(key)(value);
+  return encoded;
+};
+
 /**
  * @internal
  */

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 = {};

package/lib/internal/AesPkcs5.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AesPkcs5.js","sourceRoot":"","sources":["../../src/internal/AesPkcs5.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA4B;AAE5B;;;;;;;;;GASG;AACH,IAAiB,QAAQ,CAqDxB;AArDD,WAAiB,QAAQ;IACvB;;;;;;;OAOG;IACU,gBAAO,GAAG,UACrB,IAAyB,EACzB,GAAW,EACX,EAAU;QAEV,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,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC;IAEF;;;;;;;OAOG;IACU,gBAAO,GAAG,UACrB,IAAgB,EAChB,GAAW,EACX,EAAU;QAEV,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,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC;IAEF;;OAEG;IACH,IAAM,MAAM,GAAG,UAAC,CAAS,EAAE,CAAS;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC,EArDgB,QAAQ,wBAAR,QAAQ,QAqDxB"}