@typia/interface 12.0.0-dev.20260311 → 12.0.0-dev.20260312

package/lib/http/IHttpLlmApplication.d.ts

@@ -50,7 +50,7 @@ export declare namespace IHttpLlmApplication {
     /** Composition error for an operation. */
     interface IError {
         /** HTTP method of the failed operation. */
-        method: "get" | "post" | "put" | "patch" | "delete" | "head";
+        method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
         /** Path of the failed operation. */
         path: string;
         /** Error messages describing the failure. */

package/lib/http/IHttpLlmFunction.d.ts

@@ -17,7 +17,7 @@ import { IHttpMigrateRoute } from "./IHttpMigrateRoute";
  */
 export interface IHttpLlmFunction extends ILlmFunction {
     /** HTTP method of the endpoint. */
-    method: "get" | "post" | "patch" | "put" | "delete";
+    method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
     /** Path of the endpoint. */
     path: string;
     /** Category tags from {@link OpenApi.IOperation.tags}. */

package/lib/http/IHttpMigrateApplication.d.ts

@@ -33,7 +33,7 @@ export declare namespace IHttpMigrateApplication {
         /** Returns source operation. */
         operation: () => OpenApi.IOperation;
         /** HTTP method. */
-        method: "head" | "get" | "post" | "put" | "patch" | "delete";
+        method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
         /** Operation path. */
         path: string;
         /** Error messages. */

package/lib/http/IHttpMigrateRoute.d.ts

@@ -11,8 +11,8 @@ import { OpenApi } from "../openapi/OpenApi";
  * @author Jeongho Nam - https://github.com/samchon
  */
 export interface IHttpMigrateRoute {
-    /** HTTP method. Operations with other methods are ignored. */
-    method: "head" | "get" | "post" | "put" | "patch" | "delete";
+    /** HTTP method. */
+    method: "head" | "get" | "post" | "put" | "patch" | "delete" | "query";
     /** Original path from OpenAPI document. */
     path: string;
     /** Emended path with `:param` format, always starts with `/`. */

package/lib/openapi/OpenApi.d.ts

@@ -1,12 +1,12 @@
 import { IJsonSchemaAttribute } from "../schema/IJsonSchemaAttribute";
 import * as tags from "../tags";
 /**
- * Emended OpenAPI v3.1 specification.
+ * Emended OpenAPI v3.2 specification.
  *
- * `OpenApi` is a refined OpenAPI v3.1 specification that normalizes ambiguous
+ * `OpenApi` is a refined OpenAPI v3.2 specification that normalizes ambiguous
  * and redundant expressions from various OpenAPI versions (Swagger 2.0, OpenAPI
- * 3.0, 3.1). This unified format simplifies schema processing for `typia` and
- * `@nestia/sdk`.
+ * 3.0, 3.1, 3.2). This unified format simplifies schema processing for `typia`
+ * and `@nestia/sdk`.
  *
  * Key simplifications:
  *
@@ -29,9 +29,9 @@ export declare namespace OpenApi {
      * Standard HTTP methods used in REST APIs. Each path can have multiple
      * operations, one per HTTP method.
      */
-    type Method = "get" | "post" | "put" | "delete" | "options" | "head" | "patch" | "trace";
+    type Method = "get" | "post" | "put" | "delete" | "options" | "head" | "patch" | "trace" | "query";
     /**
-     * Root document structure for emended OpenAPI v3.1.
+     * Root document structure for emended OpenAPI v3.2.
      *
      * Contains all API metadata, paths, operations, and reusable components. The
      * `x-samchon-emended-v4` marker indicates this document has been processed by
@@ -39,7 +39,7 @@ export declare namespace OpenApi {
      */
     interface IDocument {
         /** OpenAPI version. */
-        openapi: `3.1.${number}`;
+        openapi: `3.2.${number}`;
         /** List of servers providing the API. */
         servers?: IServer[];
         /** API metadata. */
@@ -54,8 +54,8 @@ export declare namespace OpenApi {
         security?: Record<string, string[]>[];
         /** Tag definitions for grouping operations. */
         tags?: IDocument.ITag[];
-        /** Marker for emended document by `@samchon/openapi`. */
-        "x-samchon-emended-v4": true;
+        /** Marker for emended document by `typia` */
+        "x-typia-emended-v12": true;
     }
     namespace IDocument {
         /**
@@ -84,8 +84,14 @@ export declare namespace OpenApi {
         interface ITag {
             /** Tag name. */
             name: string;
+            /** Short summary for display in tag lists. */
+            summary?: string;
             /** Tag description. */
             description?: string;
+            /** Parent tag name for hierarchical organization. */
+            parent?: string;
+            /** Tag classification (e.g., "nav", "badge"). */
+            kind?: string;
         }
         /** Contact information. */
         interface IContact {
@@ -134,6 +140,8 @@ export declare namespace OpenApi {
         summary?: string;
         /** Path description. */
         description?: string;
+        /** Additional non-standard HTTP method operations (e.g., LINK, UNLINK, PURGE). */
+        additionalOperations?: Record<string, IOperation>;
     }
     /** API operation metadata. */
     interface IOperation {
@@ -170,7 +178,7 @@ export declare namespace OpenApi {
             /** Parameter name. */
             name?: string;
             /** Parameter location. */
-            in: "path" | "query" | "header" | "cookie";
+            in: "path" | "query" | "querystring" | "header" | "cookie";
             /** Parameter schema. */
             schema: IJsonSchema;
             /** Whether required. */
@@ -211,6 +219,8 @@ export declare namespace OpenApi {
         interface IMediaType {
             /** Content schema. */
             schema?: IJsonSchema;
+            /** Schema for streaming items (SSE, JSON Lines, etc.). */
+            itemSchema?: IJsonSchema;
             /** Example value. */
             example?: any;
             /** Named examples. */
@@ -414,6 +424,8 @@ export declare namespace OpenApi {
             type: "oauth2";
             /** OAuth2 flows. */
             flows: IOAuth2.IFlowSet;
+            /** OAuth2 metadata discovery URL. */
+            oauth2MetadataUrl?: string;
             /** Scheme description. */
             description?: string;
         }
@@ -437,6 +449,8 @@ export declare namespace OpenApi {
                 password?: Omit<IFlow, "authorizationUrl">;
                 /** Client credentials flow. */
                 clientCredentials?: Omit<IFlow, "authorizationUrl">;
+                /** Device authorization flow. */
+                deviceAuthorization?: IDeviceFlow;
             }
             /** OAuth2 flow configuration. */
             interface IFlow {
@@ -449,6 +463,17 @@ export declare namespace OpenApi {
                 /** Available scopes. */
                 scopes?: Record<string, string>;
             }
+            /** OAuth2 device authorization flow. */
+            interface IDeviceFlow {
+                /** Device authorization URL. */
+                deviceAuthorizationUrl: string;
+                /** Token URL. */
+                tokenUrl: string;
+                /** Refresh URL. */
+                refreshUrl?: string;
+                /** Available scopes. */
+                scopes?: Record<string, string>;
+            }
         }
     }
 }

package/lib/openapi/OpenApiV3.d.ts

@@ -105,6 +105,13 @@ export declare namespace OpenApiV3 {
         summary?: string;
         /** Path description. */
         description?: string;
+        /**
+         * Non-standard HTTP method operations (extension).
+         *
+         * Used when downgrading from OpenAPI v3.2 to preserve
+         * non-standard methods like `query` or custom methods.
+         */
+        "x-additionalOperations"?: Record<string, IOperation>;
     }
     /** API operation metadata. */
     interface IOperation {

package/lib/openapi/OpenApiV3_1.d.ts

@@ -117,6 +117,13 @@ export declare namespace OpenApiV3_1 {
         summary?: string;
         /** Path description. */
         description?: string;
+        /**
+         * Non-standard HTTP method operations (extension).
+         *
+         * Used when downgrading from OpenAPI v3.2 to preserve
+         * non-standard methods like `query` or custom methods.
+         */
+        "x-additionalOperations"?: Record<string, IOperation>;
     }
     /** API operation metadata. */
     interface IOperation {