@typia/utils 12.0.1 → 12.1.0-dev.20260325

package/src/http/HttpMigration.ts

@@ -1,94 +1,94 @@
-import {
-  IHttpConnection,
-  IHttpMigrateApplication,
-  IHttpMigrateRoute,
-  IHttpResponse,
-  OpenApi,
-  OpenApiV3,
-  OpenApiV3_1,
-  OpenApiV3_2,
-  SwaggerV2,
-} from "@typia/interface";
-
-import { OpenApiConverter } from "../converters/OpenApiConverter";
-import { HttpMigrateApplicationComposer } from "./internal/HttpMigrateApplicationComposer";
-import { HttpMigrateRouteFetcher } from "./internal/HttpMigrateRouteFetcher";
-
-/**
- * OpenAPI to HTTP migration utilities.
- *
- * `HttpMigration` converts OpenAPI documents into executable HTTP routes
- * ({@link IHttpMigrateApplication}). Unlike {@link HttpLlm} which targets LLM
- * function calling, this focuses on SDK/client code generation.
- *
- * Supports all OpenAPI versions (Swagger 2.0, OpenAPI 3.0, 3.1) through
- * automatic conversion to normalized {@link OpenApi} format.
- *
- * Main functions:
- *
- * - {@link application}: Convert OpenAPI document to
- *   {@link IHttpMigrateApplication}
- * - {@link execute}: Call a route and return response body
- * - {@link propagate}: Call a route and return full HTTP response (including
- *   non-2xx)
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace HttpMigration {
-  /**
-   * Convert OpenAPI document to migration application.
-   *
-   * @param document OpenAPI document (any version)
-   * @returns Migration application with callable routes
-   */
-  export const application = (
-    document:
-      | OpenApi.IDocument
-      | SwaggerV2.IDocument
-      | OpenApiV3.IDocument
-      | OpenApiV3_1.IDocument
-      | OpenApiV3_2.IDocument,
-  ): IHttpMigrateApplication =>
-    HttpMigrateApplicationComposer.compose(
-      OpenApiConverter.upgradeDocument(document),
-    );
-
-  /**
-   * Execute HTTP route.
-   *
-   * @param props Fetch properties
-   * @returns Response body
-   * @throws HttpError on non-2xx status
-   */
-  export const execute = (props: IFetchProps): Promise<unknown> =>
-    HttpMigrateRouteFetcher.execute(props);
-
-  /**
-   * Execute HTTP route and return full response.
-   *
-   * @param props Fetch properties
-   * @returns Full HTTP response including non-2xx
-   */
-  export const propagate = (props: IFetchProps): Promise<IHttpResponse> =>
-    HttpMigrateRouteFetcher.propagate(props);
-
-  /** Properties for HTTP route execution. */
-  export interface IFetchProps {
-    /** HTTP connection info. */
-    connection: IHttpConnection;
-
-    /** Route to execute. */
-    route: IHttpMigrateRoute;
-
-    /** Path parameters. */
-    parameters:
-      | Array<string | number | boolean | bigint | null>
-      | Record<string, string | number | boolean | bigint | null>;
-
-    /** Query parameters. */
-    query?: object | undefined;
-
-    /** Request body. */
-    body?: object | undefined;
-  }
-}
+import {
+  IHttpConnection,
+  IHttpMigrateApplication,
+  IHttpMigrateRoute,
+  IHttpResponse,
+  OpenApi,
+  OpenApiV3,
+  OpenApiV3_1,
+  OpenApiV3_2,
+  SwaggerV2,
+} from "@typia/interface";
+
+import { OpenApiConverter } from "../converters/OpenApiConverter";
+import { HttpMigrateApplicationComposer } from "./internal/HttpMigrateApplicationComposer";
+import { HttpMigrateRouteFetcher } from "./internal/HttpMigrateRouteFetcher";
+
+/**
+ * OpenAPI to HTTP migration utilities.
+ *
+ * `HttpMigration` converts OpenAPI documents into executable HTTP routes
+ * ({@link IHttpMigrateApplication}). Unlike {@link HttpLlm} which targets LLM
+ * function calling, this focuses on SDK/client code generation.
+ *
+ * Supports all OpenAPI versions (Swagger 2.0, OpenAPI 3.0, 3.1) through
+ * automatic conversion to normalized {@link OpenApi} format.
+ *
+ * Main functions:
+ *
+ * - {@link application}: Convert OpenAPI document to
+ *   {@link IHttpMigrateApplication}
+ * - {@link execute}: Call a route and return response body
+ * - {@link propagate}: Call a route and return full HTTP response (including
+ *   non-2xx)
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export namespace HttpMigration {
+  /**
+   * Convert OpenAPI document to migration application.
+   *
+   * @param document OpenAPI document (any version)
+   * @returns Migration application with callable routes
+   */
+  export const application = (
+    document:
+      | OpenApi.IDocument
+      | SwaggerV2.IDocument
+      | OpenApiV3.IDocument
+      | OpenApiV3_1.IDocument
+      | OpenApiV3_2.IDocument,
+  ): IHttpMigrateApplication =>
+    HttpMigrateApplicationComposer.compose(
+      OpenApiConverter.upgradeDocument(document),
+    );
+
+  /**
+   * Execute HTTP route.
+   *
+   * @param props Fetch properties
+   * @returns Response body
+   * @throws HttpError on non-2xx status
+   */
+  export const execute = (props: IFetchProps): Promise<unknown> =>
+    HttpMigrateRouteFetcher.execute(props);
+
+  /**
+   * Execute HTTP route and return full response.
+   *
+   * @param props Fetch properties
+   * @returns Full HTTP response including non-2xx
+   */
+  export const propagate = (props: IFetchProps): Promise<IHttpResponse> =>
+    HttpMigrateRouteFetcher.propagate(props);
+
+  /** Properties for HTTP route execution. */
+  export interface IFetchProps {
+    /** HTTP connection info. */
+    connection: IHttpConnection;
+
+    /** Route to execute. */
+    route: IHttpMigrateRoute;
+
+    /** Path parameters. */
+    parameters:
+      | Array<string | number | boolean | bigint | null>
+      | Record<string, string | number | boolean | bigint | null>;
+
+    /** Query parameters. */
+    query?: object | undefined;
+
+    /** Request body. */
+    body?: object | undefined;
+  }
+}

package/src/http/internal/HttpMigrateApplicationComposer.ts

@@ -1,56 +1,56 @@
-import {
-  IHttpMigrateApplication,
-  IHttpMigrateRoute,
-  OpenApi,
-} from "@typia/interface";
-
-import { EndpointUtil } from "../../utils/internal/EndpointUtil";
-import { HttpMigrateRouteAccessor } from "./HttpMigrateRouteAccessor";
-import { HttpMigrateRouteComposer } from "./HttpMigrateRouteComposer";
-
-export namespace HttpMigrateApplicationComposer {
-  export const compose = (
-    document: OpenApi.IDocument,
-  ): IHttpMigrateApplication => {
-    const errors: IHttpMigrateApplication.IError[] = [];
-    const entire: Array<IHttpMigrateRoute | null> = Object.entries({
-      ...(document.paths ?? {}),
-      ...(document.webhooks ?? {}),
-    })
-      .map(([path, collection]) =>
-        (["head", "get", "post", "put", "patch", "delete", "query"] as const)
-          .filter((method) => collection[method] !== undefined)
-          .map((method) => {
-            const operation: OpenApi.IOperation = collection[method]!;
-            const migrated: IHttpMigrateRoute | string[] =
-              HttpMigrateRouteComposer.compose({
-                document,
-                method,
-                path,
-                emendedPath: EndpointUtil.reJoinWithDecimalParameters(path),
-                operation,
-              });
-            if (Array.isArray(migrated)) {
-              errors.push({
-                method,
-                path,
-                operation: () => operation,
-                messages: migrated,
-              });
-              return null;
-            }
-            return migrated;
-          }),
-      )
-      .flat();
-    const operations: IHttpMigrateRoute[] = entire.filter(
-      (o): o is IHttpMigrateRoute => !!o,
-    );
-    HttpMigrateRouteAccessor.overwrite(operations);
-    return {
-      document: () => document,
-      routes: operations,
-      errors,
-    } satisfies IHttpMigrateApplication as IHttpMigrateApplication;
-  };
-}
+import {
+  IHttpMigrateApplication,
+  IHttpMigrateRoute,
+  OpenApi,
+} from "@typia/interface";
+
+import { EndpointUtil } from "../../utils/internal/EndpointUtil";
+import { HttpMigrateRouteAccessor } from "./HttpMigrateRouteAccessor";
+import { HttpMigrateRouteComposer } from "./HttpMigrateRouteComposer";
+
+export namespace HttpMigrateApplicationComposer {
+  export const compose = (
+    document: OpenApi.IDocument,
+  ): IHttpMigrateApplication => {
+    const errors: IHttpMigrateApplication.IError[] = [];
+    const entire: Array<IHttpMigrateRoute | null> = Object.entries({
+      ...(document.paths ?? {}),
+      ...(document.webhooks ?? {}),
+    })
+      .map(([path, collection]) =>
+        (["head", "get", "post", "put", "patch", "delete", "query"] as const)
+          .filter((method) => collection[method] !== undefined)
+          .map((method) => {
+            const operation: OpenApi.IOperation = collection[method]!;
+            const migrated: IHttpMigrateRoute | string[] =
+              HttpMigrateRouteComposer.compose({
+                document,
+                method,
+                path,
+                emendedPath: EndpointUtil.reJoinWithDecimalParameters(path),
+                operation,
+              });
+            if (Array.isArray(migrated)) {
+              errors.push({
+                method,
+                path,
+                operation: () => operation,
+                messages: migrated,
+              });
+              return null;
+            }
+            return migrated;
+          }),
+      )
+      .flat();
+    const operations: IHttpMigrateRoute[] = entire.filter(
+      (o): o is IHttpMigrateRoute => !!o,
+    );
+    HttpMigrateRouteAccessor.overwrite(operations);
+    return {
+      document: () => document,
+      routes: operations,
+      errors,
+    } satisfies IHttpMigrateApplication as IHttpMigrateApplication;
+  };
+}