@typia/utils 12.0.0-dev.20260225

package/lib/http/HttpLlm.d.ts

@@ -0,0 +1,130 @@
+import { IHttpConnection, IHttpLlmApplication, IHttpLlmController, IHttpLlmFunction, IHttpResponse, ILlmFunction, OpenApi, OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@typia/interface";
+/**
+ * LLM function calling utilities for OpenAPI documents.
+ *
+ * `HttpLlm` converts OpenAPI documents into LLM function calling applications
+ * and executes them. Supports all OpenAPI versions (Swagger 2.0, OpenAPI 3.0,
+ * 3.1) through automatic conversion to {@link OpenApi} format.
+ *
+ * Main functions:
+ *
+ * - {@link controller}: Create {@link IHttpLlmController} from OpenAPI document
+ * - {@link application}: Convert OpenAPI document to {@link IHttpLlmApplication}
+ * - {@link execute}: Call an LLM function and return the response body
+ * - {@link propagate}: Call an LLM function and return full HTTP response
+ * - {@link mergeParameters}: Merge LLM-filled and human-filled parameters
+ *
+ * Typical workflow:
+ *
+ * 1. Load OpenAPI document (JSON/YAML)
+ * 2. Call `HttpLlm.application()` to get function schemas
+ * 3. Send function schemas to LLM for function selection
+ * 4. Call `HttpLlm.execute()` with LLM's chosen function and arguments
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare namespace HttpLlm {
+    /**
+     * Create HTTP LLM controller from OpenAPI document.
+     *
+     * Composes {@link IHttpLlmController} from OpenAPI document with connection
+     * info. The controller can be used with {@link registerMcpControllers} to
+     * register all API operations as MCP tools at once.
+     *
+     * @param props Controller properties
+     * @returns HTTP LLM controller
+     */
+    const controller: (props: {
+        /** Identifier name of the controller. */
+        name: string;
+        /** OpenAPI document to convert. */
+        document: OpenApi.IDocument | SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument;
+        /** Connection to the API server. */
+        connection: IHttpConnection;
+        /** LLM schema conversion configuration. */
+        config?: Partial<IHttpLlmApplication.IConfig>;
+        /**
+         * Custom executor of the API function.
+         *
+         * Default executor is {@link HttpLlm.execute} function.
+         */
+        execute?: IHttpLlmController["execute"];
+    }) => IHttpLlmController;
+    /**
+     * Convert OpenAPI document to LLM function calling application.
+     *
+     * Converts API operations to LLM-callable functions. Use
+     * {@link mergeParameters} if `separate` option is configured.
+     *
+     * @param props Composition properties
+     * @returns LLM function calling application
+     */
+    const application: (props: {
+        /** OpenAPI document to convert. */
+        document: OpenApi.IDocument | SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument;
+        /** LLM schema conversion configuration. */
+        config?: Partial<IHttpLlmApplication.IConfig>;
+    }) => IHttpLlmApplication;
+    /** Properties for LLM function call. */
+    interface IFetchProps {
+        /** LLM function calling application. */
+        application: IHttpLlmApplication;
+        /** Function to call. */
+        function: IHttpLlmFunction;
+        /** HTTP connection info. */
+        connection: IHttpConnection;
+        /** Function arguments. */
+        input: object;
+    }
+    /**
+     * Execute LLM function call.
+     *
+     * Calls API endpoint and returns response body. Throws {@link HttpError} on
+     * non-2xx status.
+     *
+     * @param props Function call properties
+     * @returns Response body
+     * @throws HttpError on non-2xx status
+     */
+    const execute: (props: IFetchProps) => Promise<unknown>;
+    /**
+     * Propagate LLM function call.
+     *
+     * Calls API endpoint and returns full response including non-2xx. Use when
+     * you need to handle error responses yourself.
+     *
+     * @param props Function call properties
+     * @returns Full HTTP response
+     * @throws Error only on connection failure
+     */
+    const propagate: (props: IFetchProps) => Promise<IHttpResponse>;
+    /** Properties for parameter merging. */
+    interface IMergeProps {
+        /** Target function metadata. */
+        function: ILlmFunction;
+        /** LLM-provided arguments. */
+        llm: object | null;
+        /** Human-provided arguments. */
+        human: object | null;
+    }
+    /**
+     * Merge separated parameters.
+     *
+     * Combines human and LLM parameters when `separate` option was used. Throws
+     * error if `separate` was not configured.
+     *
+     * @param props Merge properties
+     * @returns Merged parameters
+     */
+    const mergeParameters: (props: IMergeProps) => object;
+    /**
+     * Merge two values.
+     *
+     * Objects are merged at property level. Primitives return `y ?? x`.
+     *
+     * @param x First value
+     * @param y Second value (preferred)
+     * @returns Merged value
+     */
+    const mergeValue: (x: unknown, y: unknown) => unknown;
+}

package/lib/http/HttpLlm.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpLlm = void 0;
+const HttpMigration_1 = require("./HttpMigration");
+const HttpLlmApplicationComposer_1 = require("./internal/HttpLlmApplicationComposer");
+const HttpLlmFunctionFetcher_1 = require("./internal/HttpLlmFunctionFetcher");
+const LlmDataMerger_1 = require("./internal/LlmDataMerger");
+/**
+ * LLM function calling utilities for OpenAPI documents.
+ *
+ * `HttpLlm` converts OpenAPI documents into LLM function calling applications
+ * and executes them. Supports all OpenAPI versions (Swagger 2.0, OpenAPI 3.0,
+ * 3.1) through automatic conversion to {@link OpenApi} format.
+ *
+ * Main functions:
+ *
+ * - {@link controller}: Create {@link IHttpLlmController} from OpenAPI document
+ * - {@link application}: Convert OpenAPI document to {@link IHttpLlmApplication}
+ * - {@link execute}: Call an LLM function and return the response body
+ * - {@link propagate}: Call an LLM function and return full HTTP response
+ * - {@link mergeParameters}: Merge LLM-filled and human-filled parameters
+ *
+ * Typical workflow:
+ *
+ * 1. Load OpenAPI document (JSON/YAML)
+ * 2. Call `HttpLlm.application()` to get function schemas
+ * 3. Send function schemas to LLM for function selection
+ * 4. Call `HttpLlm.execute()` with LLM's chosen function and arguments
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var HttpLlm;
+(function (HttpLlm) {
+    /* -----------------------------------------------------------
+      COMPOSERS
+    ----------------------------------------------------------- */
+    /**
+     * Create HTTP LLM controller from OpenAPI document.
+     *
+     * Composes {@link IHttpLlmController} from OpenAPI document with connection
+     * info. The controller can be used with {@link registerMcpControllers} to
+     * register all API operations as MCP tools at once.
+     *
+     * @param props Controller properties
+     * @returns HTTP LLM controller
+     */
+    HttpLlm.controller = (props) => ({
+        protocol: "http",
+        name: props.name,
+        application: HttpLlm.application({
+            document: props.document,
+            config: props.config,
+        }),
+        connection: props.connection,
+        execute: props.execute,
+    });
+    /**
+     * Convert OpenAPI document to LLM function calling application.
+     *
+     * Converts API operations to LLM-callable functions. Use
+     * {@link mergeParameters} if `separate` option is configured.
+     *
+     * @param props Composition properties
+     * @returns LLM function calling application
+     */
+    HttpLlm.application = (props) => {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        // MIGRATE
+        const migrate = HttpMigration_1.HttpMigration.application(props.document);
+        return HttpLlmApplicationComposer_1.HttpLlmApplicationComposer.application({
+            migrate,
+            config: {
+                reference: (_b = (_a = props.config) === null || _a === void 0 ? void 0 : _a.reference) !== null && _b !== void 0 ? _b : true,
+                strict: (_d = (_c = props.config) === null || _c === void 0 ? void 0 : _c.strict) !== null && _d !== void 0 ? _d : false,
+                separate: (_f = (_e = props.config) === null || _e === void 0 ? void 0 : _e.separate) !== null && _f !== void 0 ? _f : null,
+                maxLength: (_h = (_g = props.config) === null || _g === void 0 ? void 0 : _g.maxLength) !== null && _h !== void 0 ? _h : 64,
+                equals: (_k = (_j = props.config) === null || _j === void 0 ? void 0 : _j.equals) !== null && _k !== void 0 ? _k : false,
+            },
+        });
+    };
+    /**
+     * Execute LLM function call.
+     *
+     * Calls API endpoint and returns response body. Throws {@link HttpError} on
+     * non-2xx status.
+     *
+     * @param props Function call properties
+     * @returns Response body
+     * @throws HttpError on non-2xx status
+     */
+    HttpLlm.execute = (props) => HttpLlmFunctionFetcher_1.HttpLlmFunctionFetcher.execute(props);
+    /**
+     * Propagate LLM function call.
+     *
+     * Calls API endpoint and returns full response including non-2xx. Use when
+     * you need to handle error responses yourself.
+     *
+     * @param props Function call properties
+     * @returns Full HTTP response
+     * @throws Error only on connection failure
+     */
+    HttpLlm.propagate = (props) => HttpLlmFunctionFetcher_1.HttpLlmFunctionFetcher.propagate(props);
+    /**
+     * Merge separated parameters.
+     *
+     * Combines human and LLM parameters when `separate` option was used. Throws
+     * error if `separate` was not configured.
+     *
+     * @param props Merge properties
+     * @returns Merged parameters
+     */
+    HttpLlm.mergeParameters = (props) => LlmDataMerger_1.LlmDataMerger.parameters(props);
+    /**
+     * Merge two values.
+     *
+     * Objects are merged at property level. Primitives return `y ?? x`.
+     *
+     * @param x First value
+     * @param y Second value (preferred)
+     * @returns Merged value
+     */
+    HttpLlm.mergeValue = (x, y) => LlmDataMerger_1.LlmDataMerger.value(x, y);
+})(HttpLlm || (exports.HttpLlm = HttpLlm = {}));
+//# sourceMappingURL=HttpLlm.js.map

package/lib/http/HttpLlm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpLlm.js","sourceRoot":"","sources":["../../src/http/HttpLlm.ts"],"names":[],"mappings":";;;AAcA,mDAAgD;AAChD,sFAAmF;AACnF,8EAA2E;AAC3E,4DAAyD;AAEzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,IAAiB,OAAO,CAsKvB;AAtKD,WAAiB,OAAO;IACtB;;kEAE8D;IAC9D;;;;;;;;;OASG;IACU,kBAAU,GAAG,CAAC,KAuB1B,EAAsB,EAAE,CAAC,CAAC;QACzB,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,QAAA,WAAW,CAAC;YACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;QACF,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IAEH;;;;;;;;OAQG;IACU,mBAAW,GAAG,CAAC,KAU3B,EAAuB,EAAE;;QACxB,UAAU;QACV,MAAM,OAAO,GAA4B,6BAAa,CAAC,WAAW,CAChE,KAAK,CAAC,QAAQ,CACf,CAAC;QACF,OAAO,uDAA0B,CAAC,WAAW,CAAC;YAC5C,OAAO;YACP,MAAM,EAAE;gBACN,SAAS,EAAE,MAAA,MAAA,KAAK,CAAC,MAAM,0CAAE,SAAS,mCAAI,IAAI;gBAC1C,MAAM,EAAE,MAAA,MAAA,KAAK,CAAC,MAAM,0CAAE,MAAM,mCAAI,KAAK;gBACrC,QAAQ,EAAE,MAAA,MAAA,KAAK,CAAC,MAAM,0CAAE,QAAQ,mCAAI,IAAI;gBACxC,SAAS,EAAE,MAAA,MAAA,KAAK,CAAC,MAAM,0CAAE,SAAS,mCAAI,EAAE;gBACxC,MAAM,EAAE,MAAA,MAAA,KAAK,CAAC,MAAM,0CAAE,MAAM,mCAAI,KAAK;aACtC;SACF,CAAC,CAAC;IACL,CAAC,CAAC;IAoBF;;;;;;;;;OASG;IACU,eAAO,GAAG,CAAC,KAAkB,EAAoB,EAAE,CAC9D,+CAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAExC;;;;;;;;;OASG;IACU,iBAAS,GAAG,CAAC,KAAkB,EAA0B,EAAE,CACtE,+CAAsB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAiB1C;;;;;;;;OAQG;IACU,uBAAe,GAAG,CAAC,KAAkB,EAAU,EAAE,CAC5D,6BAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAElC;;;;;;;;OAQG;IACU,kBAAU,GAAG,CAAC,CAAU,EAAE,CAAU,EAAW,EAAE,CAC5D,6BAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC,EAtKgB,OAAO,uBAAP,OAAO,QAsKvB"}

package/lib/http/HttpLlm.mjs

@@ -0,0 +1,123 @@
+import { HttpMigration } from './HttpMigration.mjs';
+import { HttpLlmApplicationComposer } from './internal/HttpLlmApplicationComposer.mjs';
+import { HttpLlmFunctionFetcher } from './internal/HttpLlmFunctionFetcher.mjs';
+import { LlmDataMerger } from './internal/LlmDataMerger.mjs';
+
+/**
+ * LLM function calling utilities for OpenAPI documents.
+ *
+ * `HttpLlm` converts OpenAPI documents into LLM function calling applications
+ * and executes them. Supports all OpenAPI versions (Swagger 2.0, OpenAPI 3.0,
+ * 3.1) through automatic conversion to {@link OpenApi} format.
+ *
+ * Main functions:
+ *
+ * - {@link controller}: Create {@link IHttpLlmController} from OpenAPI document
+ * - {@link application}: Convert OpenAPI document to {@link IHttpLlmApplication}
+ * - {@link execute}: Call an LLM function and return the response body
+ * - {@link propagate}: Call an LLM function and return full HTTP response
+ * - {@link mergeParameters}: Merge LLM-filled and human-filled parameters
+ *
+ * Typical workflow:
+ *
+ * 1. Load OpenAPI document (JSON/YAML)
+ * 2. Call `HttpLlm.application()` to get function schemas
+ * 3. Send function schemas to LLM for function selection
+ * 4. Call `HttpLlm.execute()` with LLM's chosen function and arguments
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var HttpLlm;
+(function (HttpLlm) {
+    /* -----------------------------------------------------------
+      COMPOSERS
+    ----------------------------------------------------------- */
+    /**
+     * Create HTTP LLM controller from OpenAPI document.
+     *
+     * Composes {@link IHttpLlmController} from OpenAPI document with connection
+     * info. The controller can be used with {@link registerMcpControllers} to
+     * register all API operations as MCP tools at once.
+     *
+     * @param props Controller properties
+     * @returns HTTP LLM controller
+     */
+    HttpLlm.controller = (props) => ({
+        protocol: "http",
+        name: props.name,
+        application: HttpLlm.application({
+            document: props.document,
+            config: props.config,
+        }),
+        connection: props.connection,
+        execute: props.execute,
+    });
+    /**
+     * Convert OpenAPI document to LLM function calling application.
+     *
+     * Converts API operations to LLM-callable functions. Use
+     * {@link mergeParameters} if `separate` option is configured.
+     *
+     * @param props Composition properties
+     * @returns LLM function calling application
+     */
+    HttpLlm.application = (props) => {
+        // MIGRATE
+        const migrate = HttpMigration.application(props.document);
+        return HttpLlmApplicationComposer.application({
+            migrate,
+            config: {
+                reference: props.config?.reference ?? true,
+                strict: props.config?.strict ?? false,
+                separate: props.config?.separate ?? null,
+                maxLength: props.config?.maxLength ?? 64,
+                equals: props.config?.equals ?? false,
+            },
+        });
+    };
+    /**
+     * Execute LLM function call.
+     *
+     * Calls API endpoint and returns response body. Throws {@link HttpError} on
+     * non-2xx status.
+     *
+     * @param props Function call properties
+     * @returns Response body
+     * @throws HttpError on non-2xx status
+     */
+    HttpLlm.execute = (props) => HttpLlmFunctionFetcher.execute(props);
+    /**
+     * Propagate LLM function call.
+     *
+     * Calls API endpoint and returns full response including non-2xx. Use when
+     * you need to handle error responses yourself.
+     *
+     * @param props Function call properties
+     * @returns Full HTTP response
+     * @throws Error only on connection failure
+     */
+    HttpLlm.propagate = (props) => HttpLlmFunctionFetcher.propagate(props);
+    /**
+     * Merge separated parameters.
+     *
+     * Combines human and LLM parameters when `separate` option was used. Throws
+     * error if `separate` was not configured.
+     *
+     * @param props Merge properties
+     * @returns Merged parameters
+     */
+    HttpLlm.mergeParameters = (props) => LlmDataMerger.parameters(props);
+    /**
+     * Merge two values.
+     *
+     * Objects are merged at property level. Primitives return `y ?? x`.
+     *
+     * @param x First value
+     * @param y Second value (preferred)
+     * @returns Merged value
+     */
+    HttpLlm.mergeValue = (x, y) => LlmDataMerger.value(x, y);
+})(HttpLlm || (HttpLlm = {}));
+
+export { HttpLlm };
+//# sourceMappingURL=HttpLlm.mjs.map

package/lib/http/HttpLlm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpLlm.mjs","sources":["../../src/http/HttpLlm.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAmBA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG,IAAW;AAAjB,CAAA,UAAiB,OAAO,EAAA;AACtB;;AAE8D;AAC9D;;;;;;;;;AASG;AACU,IAAA,OAAA,CAAA,UAAU,GAAG,CAAC,KAuB1B,MAA0B;AACzB,QAAA,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,OAAA,CAAA,WAAW,CAAC;YACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;QACF,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;AACvB,KAAA,CAAC;AAEF;;;;;;;;AAQG;AACU,IAAA,OAAA,CAAA,WAAW,GAAG,CAAC,KAU3B,KAAyB;;QAExB,MAAM,OAAO,GAA4B,aAAa,CAAC,WAAW,CAChE,KAAK,CAAC,QAAQ,CACf;QACD,OAAO,0BAA0B,CAAC,WAAW,CAAC;YAC5C,OAAO;AACP,YAAA,MAAM,EAAE;AACN,gBAAA,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,IAAI;AAC1C,gBAAA,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK;AACrC,gBAAA,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,IAAI,IAAI;AACxC,gBAAA,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE;AACxC,gBAAA,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK;AACtC,aAAA;AACF,SAAA,CAAC;AACJ,IAAA,CAAC;AAoBD;;;;;;;;;AASG;AACU,IAAA,OAAA,CAAA,OAAO,GAAG,CAAC,KAAkB,KACxC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC;AAEvC;;;;;;;;;AASG;AACU,IAAA,OAAA,CAAA,SAAS,GAAG,CAAC,KAAkB,KAC1C,sBAAsB,CAAC,SAAS,CAAC,KAAK,CAAC;AAiBzC;;;;;;;;AAQG;AACU,IAAA,OAAA,CAAA,eAAe,GAAG,CAAC,KAAkB,KAChD,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;AAEjC;;;;;;;;AAQG;AACU,IAAA,OAAA,CAAA,UAAU,GAAG,CAAC,CAAU,EAAE,CAAU,KAC/C,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC,EAtKgB,OAAO,KAAP,OAAO,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/http/HttpMigration.d.ts

@@ -0,0 +1,58 @@
+import { IHttpConnection, IHttpMigrateApplication, IHttpMigrateRoute, IHttpResponse, OpenApi, OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@typia/interface";
+/**
+ * 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 declare namespace HttpMigration {
+    /**
+     * Convert OpenAPI document to migration application.
+     *
+     * @param document OpenAPI document (any version)
+     * @returns Migration application with callable routes
+     */
+    const application: (document: OpenApi.IDocument | SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument) => IHttpMigrateApplication;
+    /**
+     * Execute HTTP route.
+     *
+     * @param props Fetch properties
+     * @returns Response body
+     * @throws HttpError on non-2xx status
+     */
+    const execute: (props: IFetchProps) => Promise<unknown>;
+    /**
+     * Execute HTTP route and return full response.
+     *
+     * @param props Fetch properties
+     * @returns Full HTTP response including non-2xx
+     */
+    const propagate: (props: IFetchProps) => Promise<IHttpResponse>;
+    /** Properties for HTTP route execution. */
+    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/lib/http/HttpMigration.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpMigration = void 0;
+const OpenApiConverter_1 = require("../converters/OpenApiConverter");
+const HttpMigrateApplicationComposer_1 = require("./internal/HttpMigrateApplicationComposer");
+const HttpMigrateRouteFetcher_1 = require("./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
+ */
+var HttpMigration;
+(function (HttpMigration) {
+    /**
+     * Convert OpenAPI document to migration application.
+     *
+     * @param document OpenAPI document (any version)
+     * @returns Migration application with callable routes
+     */
+    HttpMigration.application = (document) => HttpMigrateApplicationComposer_1.HttpMigrateApplicationComposer.compose(OpenApiConverter_1.OpenApiConverter.upgradeDocument(document));
+    /**
+     * Execute HTTP route.
+     *
+     * @param props Fetch properties
+     * @returns Response body
+     * @throws HttpError on non-2xx status
+     */
+    HttpMigration.execute = (props) => HttpMigrateRouteFetcher_1.HttpMigrateRouteFetcher.execute(props);
+    /**
+     * Execute HTTP route and return full response.
+     *
+     * @param props Fetch properties
+     * @returns Full HTTP response including non-2xx
+     */
+    HttpMigration.propagate = (props) => HttpMigrateRouteFetcher_1.HttpMigrateRouteFetcher.propagate(props);
+})(HttpMigration || (exports.HttpMigration = HttpMigration = {}));
+//# sourceMappingURL=HttpMigration.js.map

package/lib/http/HttpMigration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpMigration.js","sourceRoot":"","sources":["../../src/http/HttpMigration.ts"],"names":[],"mappings":";;;AAWA,qEAAkE;AAClE,8FAA2F;AAC3F,gFAA6E;AAE7E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,IAAiB,aAAa,CAwD7B;AAxDD,WAAiB,aAAa;IAC5B;;;;;OAKG;IACU,yBAAW,GAAG,CACzB,QAIyB,EACA,EAAE,CAC3B,+DAA8B,CAAC,OAAO,CACpC,mCAAgB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAC3C,CAAC;IAEJ;;;;;;OAMG;IACU,qBAAO,GAAG,CAAC,KAAkB,EAAoB,EAAE,CAC9D,iDAAuB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAEzC;;;;;OAKG;IACU,uBAAS,GAAG,CAAC,KAAkB,EAA0B,EAAE,CACtE,iDAAuB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAqB7C,CAAC,EAxDgB,aAAa,6BAAb,aAAa,QAwD7B"}

package/lib/http/HttpMigration.mjs

@@ -0,0 +1,52 @@
+import { OpenApiConverter } from '../converters/OpenApiConverter.mjs';
+import { HttpMigrateApplicationComposer } from './internal/HttpMigrateApplicationComposer.mjs';
+import { HttpMigrateRouteFetcher } from './internal/HttpMigrateRouteFetcher.mjs';
+
+/**
+ * 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
+ */
+var HttpMigration;
+(function (HttpMigration) {
+    /**
+     * Convert OpenAPI document to migration application.
+     *
+     * @param document OpenAPI document (any version)
+     * @returns Migration application with callable routes
+     */
+    HttpMigration.application = (document) => HttpMigrateApplicationComposer.compose(OpenApiConverter.upgradeDocument(document));
+    /**
+     * Execute HTTP route.
+     *
+     * @param props Fetch properties
+     * @returns Response body
+     * @throws HttpError on non-2xx status
+     */
+    HttpMigration.execute = (props) => HttpMigrateRouteFetcher.execute(props);
+    /**
+     * Execute HTTP route and return full response.
+     *
+     * @param props Fetch properties
+     * @returns Full HTTP response including non-2xx
+     */
+    HttpMigration.propagate = (props) => HttpMigrateRouteFetcher.propagate(props);
+})(HttpMigration || (HttpMigration = {}));
+
+export { HttpMigration };
+//# sourceMappingURL=HttpMigration.mjs.map

package/lib/http/HttpMigration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpMigration.mjs","sources":["../../src/http/HttpMigration.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAeA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,IAAW;AAAjB,CAAA,UAAiB,aAAa,EAAA;AAC5B;;;;;AAKG;AACU,IAAA,aAAA,CAAA,WAAW,GAAG,CACzB,QAIyB,KAEzB,8BAA8B,CAAC,OAAO,CACpC,gBAAgB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAC3C;AAEH;;;;;;AAMG;AACU,IAAA,aAAA,CAAA,OAAO,GAAG,CAAC,KAAkB,KACxC,uBAAuB,CAAC,OAAO,CAAC,KAAK,CAAC;AAExC;;;;;AAKG;AACU,IAAA,aAAA,CAAA,SAAS,GAAG,CAAC,KAAkB,KAC1C,uBAAuB,CAAC,SAAS,CAAC,KAAK,CAAC;AAqB5C,CAAC,EAxDgB,aAAa,KAAb,aAAa,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/http/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./HttpError";
+export * from "./HttpLlm";
+export * from "./HttpMigration";

package/lib/http/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./HttpError"), exports);
+__exportStar(require("./HttpLlm"), exports);
+__exportStar(require("./HttpMigration"), exports);
+//# sourceMappingURL=index.js.map

package/lib/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,4CAA0B;AAC1B,kDAAgC"}

package/lib/http/index.mjs

@@ -0,0 +1,4 @@
+export { HttpError } from './HttpError.mjs';
+export { HttpLlm } from './HttpLlm.mjs';
+export { HttpMigration } from './HttpMigration.mjs';
+//# sourceMappingURL=index.mjs.map

package/lib/http/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/lib/http/internal/HttpLlmApplicationComposer.d.ts

@@ -0,0 +1,8 @@
+import { IHttpLlmApplication, IHttpMigrateApplication } from "@typia/interface";
+export declare namespace HttpLlmApplicationComposer {
+    const application: (props: {
+        migrate: IHttpMigrateApplication;
+        config?: Partial<IHttpLlmApplication.IConfig>;
+    }) => IHttpLlmApplication;
+    const shorten: (app: IHttpLlmApplication, limit?: number) => void;
+}