@typia/utils 12.0.0-dev.20260309 → 12.0.0-dev.20260311

package/src/http/internal/HttpMigrateRouteFetcher.ts

@@ -1,203 +1,203 @@
-import { IHttpConnection, IHttpResponse } from "@typia/interface";
-
-import { HttpError } from "../HttpError";
-import type { HttpMigration } from "../HttpMigration";
-
-export namespace HttpMigrateRouteFetcher {
-  export const execute = async (
-    props: HttpMigration.IFetchProps,
-  ): Promise<unknown> => {
-    const result: IHttpResponse = await _Propagate("request", props);
-    props.route.success?.media;
-    if (result.status !== 200 && result.status !== 201)
-      throw new HttpError(
-        props.route.method.toUpperCase() as "GET",
-        props.route.path,
-        result.status,
-        result.headers,
-        result.body as string,
-      );
-    return result.body;
-  };
-
-  export const propagate = (
-    props: HttpMigration.IFetchProps,
-  ): Promise<IHttpResponse> => _Propagate("propagate", props);
-}
-
-const _Propagate = async (
-  from: string,
-  props: HttpMigration.IFetchProps,
-): Promise<IHttpResponse> => {
-  // VALIDATE PARAMETERS
-  const error = (message: string) =>
-    new Error(`Error on MigrateRouteFetcher.${from}(): ${message}`);
-  if (Array.isArray(props.parameters)) {
-    if (props.route.parameters.length !== props.parameters.length)
-      throw error(`number of parameters is not matched.`);
-  } else if (
-    props.route.parameters.every(
-      (p) => (props.parameters as Record<string, any>)[p.key] !== undefined,
-    ) === false
-  )
-    throw error(`number of parameters is not matched.`);
-
-  // VALIDATE QUERY
-  if (!!props.route.query !== !!props.query)
-    throw error(`query is not matched.`);
-  else if (!!props.route.body !== (props.body !== undefined))
-    throw error(`body is not matched.`);
-
-  // INIT REQUEST DATA
-  const headers: Record<string, IHttpConnection.HeaderValue | undefined> = {
-    ...(props.connection.headers ?? {}),
-    ...(props.route.body?.type &&
-    props.route.body.type !== "multipart/form-data"
-      ? { "Content-Type": props.route.body.type }
-      : {}),
-  };
-  const init: RequestInit = {
-    ...(props.connection.options ?? {}),
-    method: props.route.method.toUpperCase(),
-    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;
-    })(),
-  };
-  if (props.body !== undefined)
-    init.body = (
-      props.route.body?.type === "application/x-www-form-urlencoded"
-        ? requestQueryBody(props.body)
-        : props.route.body?.type === "multipart/form-data"
-          ? requestFormDataBody(props.body)
-          : props.route.body?.type === "application/json"
-            ? JSON.stringify(props.body)
-            : props.body
-    ) as any;
-
-  // DO REQUEST
-  const resolvedPath: string =
-    props.connection.host.endsWith("/") === false &&
-    props.route.emendedPath.startsWith("/") === false
-      ? `/${getPath(props)}`
-      : getPath(props);
-  const url: URL = new URL(`${props.connection.host}${resolvedPath}`);
-
-  const response: Response = await (props.connection.fetch ?? fetch)(url, init);
-  const status: number = response.status;
-  const out = (body: unknown): IHttpResponse => ({
-    status,
-    headers: responseHeaders(response.headers),
-    body,
-  });
-
-  if (status === 200 || status === 201) {
-    // SUCCESS CASE
-    if (props.route.method.toUpperCase() === "HEAD") return out(undefined);
-    else if (
-      props.route.success === null ||
-      props.route.success.type === "text/plain"
-    )
-      return out(await response.text());
-    else if (props.route.success.type === "application/json") {
-      const text: string = await response.text();
-      return out(text.length ? JSON.parse(text) : undefined);
-    } else if (props.route.success.type === "application/x-www-form-urlencoded")
-      return out(new URLSearchParams(await response.text()));
-    else if (props.route.success.type === "multipart/form-data")
-      return out(await response.formData());
-    throw error("Unsupported response body type.");
-  } else {
-    // FAILURE CASE
-    const type: string = (
-      response.headers.get("content-type") ??
-      response.headers.get("Content-Type") ??
-      ""
-    )
-      .split(";")[0]!
-      .trim();
-    if (type === "" || type.startsWith("text/"))
-      return out(await response.text());
-    else if (type === "application/json") return out(await response.json());
-    else if (type === "application/x-www-form-urlencoded")
-      return out(new URLSearchParams(await response.text()));
-    else if (type === "multipart/form-data")
-      return out(await response.formData());
-    else if (type === "application/octet-stream")
-      return out(await response.blob());
-    return out(await response.text());
-  }
-};
-
-const getPath = (
-  props: Pick<HttpMigration.IFetchProps, "route" | "parameters" | "query">,
-): string => {
-  let path: string = props.route.emendedPath;
-  props.route.parameters.forEach((p, i) => {
-    path = path.replace(
-      `:${p.key}`,
-      encodeURIComponent(
-        String(
-          (Array.isArray(props.parameters)
-            ? props.parameters[i]
-            : props.parameters[p.key]) ?? "null",
-        ),
-      ),
-    );
-  });
-  if (props.route.query) path += getQueryPath(props.query ?? {});
-  return path;
-};
-
-const getQueryPath = (query: Record<string, any>): string => {
-  const variables = new URLSearchParams();
-  for (const [key, value] of Object.entries(query))
-    if (undefined === value) continue;
-    else if (Array.isArray(value))
-      value.forEach((elem: any) => variables.append(key, String(elem)));
-    else variables.set(key, String(value));
-  return 0 === variables.size ? "" : `?${variables.toString()}`;
-};
-
-const requestQueryBody = (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 requestFormDataBody = (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;
-};
-
-const responseHeaders = (
-  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 { IHttpConnection, IHttpResponse } from "@typia/interface";
+
+import { HttpError } from "../HttpError";
+import type { HttpMigration } from "../HttpMigration";
+
+export namespace HttpMigrateRouteFetcher {
+  export const execute = async (
+    props: HttpMigration.IFetchProps,
+  ): Promise<unknown> => {
+    const result: IHttpResponse = await _Propagate("request", props);
+    props.route.success?.media;
+    if (result.status !== 200 && result.status !== 201)
+      throw new HttpError(
+        props.route.method.toUpperCase() as "GET",
+        props.route.path,
+        result.status,
+        result.headers,
+        result.body as string,
+      );
+    return result.body;
+  };
+
+  export const propagate = (
+    props: HttpMigration.IFetchProps,
+  ): Promise<IHttpResponse> => _Propagate("propagate", props);
+}
+
+const _Propagate = async (
+  from: string,
+  props: HttpMigration.IFetchProps,
+): Promise<IHttpResponse> => {
+  // VALIDATE PARAMETERS
+  const error = (message: string) =>
+    new Error(`Error on MigrateRouteFetcher.${from}(): ${message}`);
+  if (Array.isArray(props.parameters)) {
+    if (props.route.parameters.length !== props.parameters.length)
+      throw error(`number of parameters is not matched.`);
+  } else if (
+    props.route.parameters.every(
+      (p) => (props.parameters as Record<string, any>)[p.key] !== undefined,
+    ) === false
+  )
+    throw error(`number of parameters is not matched.`);
+
+  // VALIDATE QUERY
+  if (!!props.route.query !== !!props.query)
+    throw error(`query is not matched.`);
+  else if (!!props.route.body !== (props.body !== undefined))
+    throw error(`body is not matched.`);
+
+  // INIT REQUEST DATA
+  const headers: Record<string, IHttpConnection.HeaderValue | undefined> = {
+    ...(props.connection.headers ?? {}),
+    ...(props.route.body?.type &&
+    props.route.body.type !== "multipart/form-data"
+      ? { "Content-Type": props.route.body.type }
+      : {}),
+  };
+  const init: RequestInit = {
+    ...(props.connection.options ?? {}),
+    method: props.route.method.toUpperCase(),
+    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;
+    })(),
+  };
+  if (props.body !== undefined)
+    init.body = (
+      props.route.body?.type === "application/x-www-form-urlencoded"
+        ? requestQueryBody(props.body)
+        : props.route.body?.type === "multipart/form-data"
+          ? requestFormDataBody(props.body)
+          : props.route.body?.type === "application/json"
+            ? JSON.stringify(props.body)
+            : props.body
+    ) as any;
+
+  // DO REQUEST
+  const resolvedPath: string =
+    props.connection.host.endsWith("/") === false &&
+    props.route.emendedPath.startsWith("/") === false
+      ? `/${getPath(props)}`
+      : getPath(props);
+  const url: URL = new URL(`${props.connection.host}${resolvedPath}`);
+
+  const response: Response = await (props.connection.fetch ?? fetch)(url, init);
+  const status: number = response.status;
+  const out = (body: unknown): IHttpResponse => ({
+    status,
+    headers: responseHeaders(response.headers),
+    body,
+  });
+
+  if (status === 200 || status === 201) {
+    // SUCCESS CASE
+    if (props.route.method.toUpperCase() === "HEAD") return out(undefined);
+    else if (
+      props.route.success === null ||
+      props.route.success.type === "text/plain"
+    )
+      return out(await response.text());
+    else if (props.route.success.type === "application/json") {
+      const text: string = await response.text();
+      return out(text.length ? JSON.parse(text) : undefined);
+    } else if (props.route.success.type === "application/x-www-form-urlencoded")
+      return out(new URLSearchParams(await response.text()));
+    else if (props.route.success.type === "multipart/form-data")
+      return out(await response.formData());
+    throw error("Unsupported response body type.");
+  } else {
+    // FAILURE CASE
+    const type: string = (
+      response.headers.get("content-type") ??
+      response.headers.get("Content-Type") ??
+      ""
+    )
+      .split(";")[0]!
+      .trim();
+    if (type === "" || type.startsWith("text/"))
+      return out(await response.text());
+    else if (type === "application/json") return out(await response.json());
+    else if (type === "application/x-www-form-urlencoded")
+      return out(new URLSearchParams(await response.text()));
+    else if (type === "multipart/form-data")
+      return out(await response.formData());
+    else if (type === "application/octet-stream")
+      return out(await response.blob());
+    return out(await response.text());
+  }
+};
+
+const getPath = (
+  props: Pick<HttpMigration.IFetchProps, "route" | "parameters" | "query">,
+): string => {
+  let path: string = props.route.emendedPath;
+  props.route.parameters.forEach((p, i) => {
+    path = path.replace(
+      `:${p.key}`,
+      encodeURIComponent(
+        String(
+          (Array.isArray(props.parameters)
+            ? props.parameters[i]
+            : props.parameters[p.key]) ?? "null",
+        ),
+      ),
+    );
+  });
+  if (props.route.query) path += getQueryPath(props.query ?? {});
+  return path;
+};
+
+const getQueryPath = (query: Record<string, any>): string => {
+  const variables = new URLSearchParams();
+  for (const [key, value] of Object.entries(query))
+    if (undefined === value) continue;
+    else if (Array.isArray(value))
+      value.forEach((elem: any) => variables.append(key, String(elem)));
+    else variables.set(key, String(value));
+  return 0 === variables.size ? "" : `?${variables.toString()}`;
+};
+
+const requestQueryBody = (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 requestFormDataBody = (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;
+};
+
+const responseHeaders = (
+  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/src/index.ts

@@ -1,4 +1,4 @@
-export * from "./converters/index";
-export * from "./http/index";
-export * from "./utils/index";
-export * from "./validators/index";
+export * from "./converters/index";
+export * from "./http/index";
+export * from "./utils/index";
+export * from "./validators/index";

package/src/utils/ArrayUtil.ts

@@ -1,42 +1,42 @@
-/** @internal */
-export namespace ArrayUtil {
-  export const has = <T>(array: T[], pred: (elem: T) => boolean): boolean =>
-    array.some(pred);
-
-  export const add = <T>(
-    array: T[],
-    value: T,
-    pred: (x: T, y: T) => boolean = (x, y) => x === y,
-  ): boolean => {
-    if (array.some((elem) => pred(elem, value))) return false;
-    array.push(value);
-    return true;
-  };
-
-  export const set = <Key, T>(
-    array: T[],
-    value: T,
-    key: (elem: T) => Key,
-  ): void => {
-    if (array.some((elem) => key(elem) === key(value))) return;
-    array.push(value);
-  };
-
-  export const take = <T>(
-    array: T[],
-    pred: (elem: T) => boolean,
-    init: () => T,
-  ): T => {
-    const index: number = array.findIndex(pred);
-    if (index !== -1) return array[index]!;
-
-    const elem: T = init();
-    array.push(elem);
-    return elem;
-  };
-
-  export const repeat = <T>(
-    count: number,
-    closure: (index: number, count: number) => T,
-  ): T[] => new Array(count).fill("").map((_, index) => closure(index, count));
-}
+/** @internal */
+export namespace ArrayUtil {
+  export const has = <T>(array: T[], pred: (elem: T) => boolean): boolean =>
+    array.some(pred);
+
+  export const add = <T>(
+    array: T[],
+    value: T,
+    pred: (x: T, y: T) => boolean = (x, y) => x === y,
+  ): boolean => {
+    if (array.some((elem) => pred(elem, value))) return false;
+    array.push(value);
+    return true;
+  };
+
+  export const set = <Key, T>(
+    array: T[],
+    value: T,
+    key: (elem: T) => Key,
+  ): void => {
+    if (array.some((elem) => key(elem) === key(value))) return;
+    array.push(value);
+  };
+
+  export const take = <T>(
+    array: T[],
+    pred: (elem: T) => boolean,
+    init: () => T,
+  ): T => {
+    const index: number = array.findIndex(pred);
+    if (index !== -1) return array[index]!;
+
+    const elem: T = init();
+    array.push(elem);
+    return elem;
+  };
+
+  export const repeat = <T>(
+    count: number,
+    closure: (index: number, count: number) => T,
+  ): T[] => new Array(count).fill("").map((_, index) => closure(index, count));
+}