@typia/interface 12.0.0-dev.20260316 → 12.0.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2022 Jeongho Nam
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2022 Jeongho Nam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,29 +1,29 @@
-# `@typia/interface`
-
-![Typia Logo](https://typia.io/logo.png)
-
-[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/typia/blob/master/LICENSE)
-[![NPM Version](https://img.shields.io/npm/v/typia.svg)](https://www.npmjs.com/package/typia)
-[![NPM Downloads](https://img.shields.io/npm/dm/typia.svg)](https://www.npmjs.com/package/typia)
-[![Build Status](https://github.com/samchon/typia/workflows/test/badge.svg)](https://github.com/samchon/typia/actions?query=workflow%3Atest)
-[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://typia.io/docs/)
-[![Gurubase](https://img.shields.io/badge/Gurubase-Document%20Chatbot-006BFF)](https://gurubase.io/g/typia)
-[![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
-
-Shared type definitions and interfaces for the [`typia`](https://github.com/samchon/typia) ecosystem.
-
-This is an **internal package** of `typia`. You don't need to install it directly — it is automatically included as a dependency of `typia`.
-
-## Key Interfaces
-
-| Module | Description |
-|--------|-------------|
-| `ILlmApplication` | LLM function calling application schema |
-| `ILlmController` | Class-based LLM controller |
-| `ILlmSchema` | LLM schema definition |
-| `IJsonSchemaCollection` | JSON Schema collection |
-| `IValidation` | Validation result (success/failure with errors) |
-| `IHttpLlmApplication` | HTTP-based LLM application schema |
-| `IHttpLlmController` | HTTP-based LLM controller |
-| `IHttpConnection` | API connection configuration |
-| `tags` | Decorator tags (`Format`, `Minimum`, `Maximum`, `Pattern`, etc.) |
+# `@typia/interface`
+
+![Typia Logo](https://typia.io/logo.png)
+
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/typia/blob/master/LICENSE)
+[![NPM Version](https://img.shields.io/npm/v/typia.svg)](https://www.npmjs.com/package/typia)
+[![NPM Downloads](https://img.shields.io/npm/dm/typia.svg)](https://www.npmjs.com/package/typia)
+[![Build Status](https://github.com/samchon/typia/workflows/test/badge.svg)](https://github.com/samchon/typia/actions?query=workflow%3Atest)
+[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://typia.io/docs/)
+[![Gurubase](https://img.shields.io/badge/Gurubase-Document%20Chatbot-006BFF)](https://gurubase.io/g/typia)
+[![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
+
+Shared type definitions and interfaces for the [`typia`](https://github.com/samchon/typia) ecosystem.
+
+This is an **internal package** of `typia`. You don't need to install it directly — it is automatically included as a dependency of `typia`.
+
+## Key Interfaces
+
+| Module | Description |
+|--------|-------------|
+| `ILlmApplication` | LLM function calling application schema |
+| `ILlmController` | Class-based LLM controller |
+| `ILlmSchema` | LLM schema definition |
+| `IJsonSchemaCollection` | JSON Schema collection |
+| `IValidation` | Validation result (success/failure with errors) |
+| `IHttpLlmApplication` | HTTP-based LLM application schema |
+| `IHttpLlmController` | HTTP-based LLM controller |
+| `IHttpConnection` | API connection configuration |
+| `tags` | Decorator tags (`Format`, `Minimum`, `Maximum`, `Pattern`, etc.) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typia/interface",
-  "version": "12.0.0-dev.20260316",
+  "version": "12.0.0",
   "description": "Superfast runtime validators with only one line",
   "main": "lib/index.js",
   "exports": {

package/src/http/IHttpLlmApplication.ts

@@ -1,72 +1,72 @@
-import { OpenApi } from "../openapi/OpenApi";
-import { ILlmSchema } from "../schema/ILlmSchema";
-import { IHttpLlmFunction } from "./IHttpLlmFunction";
-import { IHttpMigrateRoute } from "./IHttpMigrateRoute";
-
-/**
- * LLM function calling application from OpenAPI document.
- *
- * `IHttpLlmApplication` is a collection of {@link IHttpLlmFunction} schemas
- * converted from {@link OpenApi.IDocument} by `HttpLlm.application()`. Each
- * OpenAPI operation becomes an LLM-callable function.
- *
- * Successful conversions go to {@link functions}, failed ones to {@link errors}
- * with detailed error messages. Common failure causes:
- *
- * - Unsupported schema features (tuples, `oneOf` with incompatible types)
- * - Missing required fields in OpenAPI document
- * - Operations marked with `x-samchon-human: true`
- *
- * Configure behavior via {@link IHttpLlmApplication.IConfig}:
- *
- * - {@link IHttpLlmApplication.IConfig.maxLength}: Function name length limit
- * - {@link ILlmSchema.IConfig.strict}: OpenAI structured output mode
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export interface IHttpLlmApplication {
-  /** Successfully converted LLM function schemas. */
-  functions: IHttpLlmFunction[];
-
-  /** Operations that failed conversion. */
-  errors: IHttpLlmApplication.IError[];
-
-  /** Configuration used for composition. */
-  config: IHttpLlmApplication.IConfig;
-}
-export namespace IHttpLlmApplication {
-  /** Configuration for HTTP LLM application composition. */
-  export interface IConfig extends ILlmSchema.IConfig {
-    /**
-     * Maximum function name length. Truncated or UUID if exceeded.
-     *
-     * @default 64
-     */
-    maxLength: number;
-
-    /**
-     * Whether to disallow superfluous properties.
-     *
-     * @default false
-     */
-    equals: boolean;
-  }
-
-  /** Composition error for an operation. */
-  export interface IError {
-    /** HTTP method of the failed operation. */
-    method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
-
-    /** Path of the failed operation. */
-    path: string;
-
-    /** Error messages describing the failure. */
-    messages: string[];
-
-    /** Returns source {@link OpenApi.IOperation}. */
-    operation: () => OpenApi.IOperation;
-
-    /** Returns source route. Undefined if error occurred at migration level. */
-    route: () => IHttpMigrateRoute | undefined;
-  }
-}
+import { OpenApi } from "../openapi/OpenApi";
+import { ILlmSchema } from "../schema/ILlmSchema";
+import { IHttpLlmFunction } from "./IHttpLlmFunction";
+import { IHttpMigrateRoute } from "./IHttpMigrateRoute";
+
+/**
+ * LLM function calling application from OpenAPI document.
+ *
+ * `IHttpLlmApplication` is a collection of {@link IHttpLlmFunction} schemas
+ * converted from {@link OpenApi.IDocument} by `HttpLlm.application()`. Each
+ * OpenAPI operation becomes an LLM-callable function.
+ *
+ * Successful conversions go to {@link functions}, failed ones to {@link errors}
+ * with detailed error messages. Common failure causes:
+ *
+ * - Unsupported schema features (tuples, `oneOf` with incompatible types)
+ * - Missing required fields in OpenAPI document
+ * - Operations marked with `x-samchon-human: true`
+ *
+ * Configure behavior via {@link IHttpLlmApplication.IConfig}:
+ *
+ * - {@link IHttpLlmApplication.IConfig.maxLength}: Function name length limit
+ * - {@link ILlmSchema.IConfig.strict}: OpenAI structured output mode
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IHttpLlmApplication {
+  /** Successfully converted LLM function schemas. */
+  functions: IHttpLlmFunction[];
+
+  /** Operations that failed conversion. */
+  errors: IHttpLlmApplication.IError[];
+
+  /** Configuration used for composition. */
+  config: IHttpLlmApplication.IConfig;
+}
+export namespace IHttpLlmApplication {
+  /** Configuration for HTTP LLM application composition. */
+  export interface IConfig extends ILlmSchema.IConfig {
+    /**
+     * Maximum function name length. Truncated or UUID if exceeded.
+     *
+     * @default 64
+     */
+    maxLength: number;
+
+    /**
+     * Whether to disallow superfluous properties.
+     *
+     * @default false
+     */
+    equals: boolean;
+  }
+
+  /** Composition error for an operation. */
+  export interface IError {
+    /** HTTP method of the failed operation. */
+    method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
+
+    /** Path of the failed operation. */
+    path: string;
+
+    /** Error messages describing the failure. */
+    messages: string[];
+
+    /** Returns source {@link OpenApi.IOperation}. */
+    operation: () => OpenApi.IOperation;
+
+    /** Returns source route. Undefined if error occurred at migration level. */
+    route: () => IHttpMigrateRoute | undefined;
+  }
+}

package/src/http/IHttpLlmFunction.ts

@@ -1,34 +1,34 @@
-import { OpenApi } from "../openapi/OpenApi";
-import { ILlmFunction } from "../schema/ILlmFunction";
-import { IHttpMigrateRoute } from "./IHttpMigrateRoute";
-
-/**
- * LLM function calling schema from OpenAPI operation.
- *
- * Extends {@link ILlmFunction} with HTTP-specific properties. Generated from
- * {@link OpenApi.IOperation} as part of {@link IHttpLlmApplication}.
- *
- * - {@link method}, {@link path}: HTTP endpoint info
- * - {@link operation}: Source OpenAPI operation
- * - {@link route}: Source migration route
- *
- * Inherits {@link parse} and {@link validate} from {@link ILlmFunction}.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export interface IHttpLlmFunction extends ILlmFunction {
-  /** HTTP method of the endpoint. */
-  method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
-
-  /** Path of the endpoint. */
-  path: string;
-
-  /** Category tags from {@link OpenApi.IOperation.tags}. */
-  tags?: string[];
-
-  /** Returns the source {@link OpenApi.IOperation}. */
-  operation: () => OpenApi.IOperation;
-
-  /** Returns the source {@link IHttpMigrateRoute}. */
-  route: () => IHttpMigrateRoute;
-}
+import { OpenApi } from "../openapi/OpenApi";
+import { ILlmFunction } from "../schema/ILlmFunction";
+import { IHttpMigrateRoute } from "./IHttpMigrateRoute";
+
+/**
+ * LLM function calling schema from OpenAPI operation.
+ *
+ * Extends {@link ILlmFunction} with HTTP-specific properties. Generated from
+ * {@link OpenApi.IOperation} as part of {@link IHttpLlmApplication}.
+ *
+ * - {@link method}, {@link path}: HTTP endpoint info
+ * - {@link operation}: Source OpenAPI operation
+ * - {@link route}: Source migration route
+ *
+ * Inherits {@link parse} and {@link validate} from {@link ILlmFunction}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IHttpLlmFunction extends ILlmFunction {
+  /** HTTP method of the endpoint. */
+  method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
+
+  /** Path of the endpoint. */
+  path: string;
+
+  /** Category tags from {@link OpenApi.IOperation.tags}. */
+  tags?: string[];
+
+  /** Returns the source {@link OpenApi.IOperation}. */
+  operation: () => OpenApi.IOperation;
+
+  /** Returns the source {@link IHttpMigrateRoute}. */
+  route: () => IHttpMigrateRoute;
+}

package/src/http/IHttpMigrateApplication.ts

@@ -1,48 +1,48 @@
-import { OpenApi } from "../openapi/OpenApi";
-import { IHttpMigrateRoute } from "./IHttpMigrateRoute";
-
-/**
- * Migrated application from OpenAPI document.
- *
- * `IHttpMigrateApplication` converts OpenAPI operations into callable HTTP
- * routes via `HttpMigration.application()`. Unlike {@link IHttpLlmApplication}
- * which targets LLM function calling, this focuses on SDK/client code
- * generation with full HTTP semantics.
- *
- * Each {@link IHttpMigrateRoute} represents a single API endpoint with:
- *
- * - Resolved path parameters (`:id` format)
- * - Combined query/header schemas as objects
- * - Request/response body with content type
- * - Accessor path for RPC-style function naming
- *
- * Failed operations go to {@link errors} with detailed messages.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export interface IHttpMigrateApplication {
-  /** Successfully migrated routes. */
-  routes: IHttpMigrateRoute[];
-
-  /** Operations that failed migration. */
-  errors: IHttpMigrateApplication.IError[];
-
-  /** Returns source OpenAPI document. */
-  document: () => OpenApi.IDocument;
-}
-export namespace IHttpMigrateApplication {
-  /** Migration error for an operation. */
-  export interface IError {
-    /** Returns source operation. */
-    operation: () => OpenApi.IOperation;
-
-    /** HTTP method. */
-    method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
-
-    /** Operation path. */
-    path: string;
-
-    /** Error messages. */
-    messages: string[];
-  }
-}
+import { OpenApi } from "../openapi/OpenApi";
+import { IHttpMigrateRoute } from "./IHttpMigrateRoute";
+
+/**
+ * Migrated application from OpenAPI document.
+ *
+ * `IHttpMigrateApplication` converts OpenAPI operations into callable HTTP
+ * routes via `HttpMigration.application()`. Unlike {@link IHttpLlmApplication}
+ * which targets LLM function calling, this focuses on SDK/client code
+ * generation with full HTTP semantics.
+ *
+ * Each {@link IHttpMigrateRoute} represents a single API endpoint with:
+ *
+ * - Resolved path parameters (`:id` format)
+ * - Combined query/header schemas as objects
+ * - Request/response body with content type
+ * - Accessor path for RPC-style function naming
+ *
+ * Failed operations go to {@link errors} with detailed messages.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IHttpMigrateApplication {
+  /** Successfully migrated routes. */
+  routes: IHttpMigrateRoute[];
+
+  /** Operations that failed migration. */
+  errors: IHttpMigrateApplication.IError[];
+
+  /** Returns source OpenAPI document. */
+  document: () => OpenApi.IDocument;
+}
+export namespace IHttpMigrateApplication {
+  /** Migration error for an operation. */
+  export interface IError {
+    /** Returns source operation. */
+    operation: () => OpenApi.IOperation;
+
+    /** HTTP method. */
+    method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
+
+    /** Operation path. */
+    path: string;
+
+    /** Error messages. */
+    messages: string[];
+  }
+}