@typia/utils 12.0.0-dev.20260312-4 → 12.0.0-dev.20260313

package/src/http/HttpError.ts

@@ -1,114 +1,114 @@
-/**
- * Error thrown when HTTP request fails with non-2xx status.
- *
- * `HttpError` is thrown by {@link HttpLlm.execute} and
- * {@link HttpMigration.execute} when the server returns a non-2xx status code.
- * Contains the full HTTP context: method, path, status, headers, and response
- * body.
- *
- * The response body is available via {@link message} (raw string) or
- * {@link toJSON} (parsed JSON). For non-throwing behavior, use
- * {@link HttpLlm.propagate} or {@link HttpMigration.propagate} instead.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export class HttpError extends Error {
-  /** HTTP method used for the request. */
-  public readonly method:
-    | "GET"
-    | "QUERY"
-    | "DELETE"
-    | "POST"
-    | "PUT"
-    | "PATCH"
-    | "HEAD";
-
-  /** Request path or URL. */
-  public readonly path: string;
-
-  /** HTTP status code from server. */
-  public readonly status: number;
-
-  /** Response headers from server. */
-  public readonly headers: Record<string, string | string[]>;
-
-  /** @internal */
-  private body_: any = NOT_YET;
-
-  /**
-   * @param method HTTP method
-   * @param path Request path or URL
-   * @param status HTTP status code
-   * @param headers Response headers
-   * @param message Error message (response body)
-   */
-  public constructor(
-    method: "GET" | "QUERY" | "DELETE" | "POST" | "PUT" | "PATCH" | "HEAD",
-    path: string,
-    status: number,
-    headers: Record<string, string | string[]>,
-    message: string,
-  ) {
-    super(message);
-    this.method = method;
-    this.path = path;
-    this.status = status;
-    this.headers = headers;
-
-    // INHERITANCE POLYFILL
-    const proto: HttpError = new.target.prototype;
-    if (Object.setPrototypeOf) Object.setPrototypeOf(this, proto);
-    else (this as any).__proto__ = proto;
-  }
-
-  /**
-   * Serialize to JSON-compatible object.
-   *
-   * Lazily parses JSON message body on first call. If parsing fails, returns
-   * the original string.
-   *
-   * @template T Expected response body type
-   * @returns Structured HTTP error information
-   */
-  public toJSON<T>(): HttpError.IProps<T> {
-    if (this.body_ === NOT_YET)
-      try {
-        this.body_ = JSON.parse(this.message);
-      } catch {
-        this.body_ = this.message;
-      }
-    return {
-      method: this.method,
-      path: this.path,
-      status: this.status,
-      headers: this.headers,
-      message: this.body_,
-    };
-  }
-}
-export namespace HttpError {
-  /**
-   * JSON representation of HttpError.
-   *
-   * @template T Response body type
-   */
-  export interface IProps<T> {
-    /** HTTP method. */
-    method: "GET" | "QUERY" | "DELETE" | "POST" | "PUT" | "PATCH" | "HEAD";
-
-    /** Request path or URL. */
-    path: string;
-
-    /** HTTP status code. */
-    status: number;
-
-    /** Response headers. */
-    headers: Record<string, string | string[]>;
-
-    /** Response body (parsed JSON or original string). */
-    message: T;
-  }
-}
-
-/** @internal */
-const NOT_YET = {} as any;
+/**
+ * Error thrown when HTTP request fails with non-2xx status.
+ *
+ * `HttpError` is thrown by {@link HttpLlm.execute} and
+ * {@link HttpMigration.execute} when the server returns a non-2xx status code.
+ * Contains the full HTTP context: method, path, status, headers, and response
+ * body.
+ *
+ * The response body is available via {@link message} (raw string) or
+ * {@link toJSON} (parsed JSON). For non-throwing behavior, use
+ * {@link HttpLlm.propagate} or {@link HttpMigration.propagate} instead.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export class HttpError extends Error {
+  /** HTTP method used for the request. */
+  public readonly method:
+    | "GET"
+    | "QUERY"
+    | "DELETE"
+    | "POST"
+    | "PUT"
+    | "PATCH"
+    | "HEAD";
+
+  /** Request path or URL. */
+  public readonly path: string;
+
+  /** HTTP status code from server. */
+  public readonly status: number;
+
+  /** Response headers from server. */
+  public readonly headers: Record<string, string | string[]>;
+
+  /** @internal */
+  private body_: any = NOT_YET;
+
+  /**
+   * @param method HTTP method
+   * @param path Request path or URL
+   * @param status HTTP status code
+   * @param headers Response headers
+   * @param message Error message (response body)
+   */
+  public constructor(
+    method: "GET" | "QUERY" | "DELETE" | "POST" | "PUT" | "PATCH" | "HEAD",
+    path: string,
+    status: number,
+    headers: Record<string, string | string[]>,
+    message: string,
+  ) {
+    super(message);
+    this.method = method;
+    this.path = path;
+    this.status = status;
+    this.headers = headers;
+
+    // INHERITANCE POLYFILL
+    const proto: HttpError = new.target.prototype;
+    if (Object.setPrototypeOf) Object.setPrototypeOf(this, proto);
+    else (this as any).__proto__ = proto;
+  }
+
+  /**
+   * Serialize to JSON-compatible object.
+   *
+   * Lazily parses JSON message body on first call. If parsing fails, returns
+   * the original string.
+   *
+   * @template T Expected response body type
+   * @returns Structured HTTP error information
+   */
+  public toJSON<T>(): HttpError.IProps<T> {
+    if (this.body_ === NOT_YET)
+      try {
+        this.body_ = JSON.parse(this.message);
+      } catch {
+        this.body_ = this.message;
+      }
+    return {
+      method: this.method,
+      path: this.path,
+      status: this.status,
+      headers: this.headers,
+      message: this.body_,
+    };
+  }
+}
+export namespace HttpError {
+  /**
+   * JSON representation of HttpError.
+   *
+   * @template T Response body type
+   */
+  export interface IProps<T> {
+    /** HTTP method. */
+    method: "GET" | "QUERY" | "DELETE" | "POST" | "PUT" | "PATCH" | "HEAD";
+
+    /** Request path or URL. */
+    path: string;
+
+    /** HTTP status code. */
+    status: number;
+
+    /** Response headers. */
+    headers: Record<string, string | string[]>;
+
+    /** Response body (parsed JSON or original string). */
+    message: T;
+  }
+}
+
+/** @internal */
+const NOT_YET = {} as any;

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;
+  }
+}