@typia/interface 12.0.0-dev.20260309 → 12.0.0-dev.20260310

package/src/http/IHttpMigrateRoute.ts

@@ -1,165 +1,165 @@
-import { OpenApi } from "../openapi/OpenApi";
-
-/**
- * HTTP route converted from OpenAPI operation.
- *
- * `IHttpMigrateRoute` represents a single API endpoint with all
- * request/response schemas resolved and ready for code generation. Contains
- * {@link parameters} for URL path variables, {@link query} for query strings,
- * {@link headers}, {@link body} for request payload, and
- * {@link success}/{@link exceptions} for responses.
- *
- * @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";
-
-  /** Original path from OpenAPI document. */
-  path: string;
-
-  /** Emended path with `:param` format, always starts with `/`. */
-  emendedPath: string;
-
-  /**
-   * Accessor path for generated RPC function.
-   *
-   * Namespaces from static path segments, function name from method +
-   * parameters. `delete` becomes `erase` to avoid reserved keyword.
-   */
-  accessor: string[];
-
-  /** Path parameters only. */
-  parameters: IHttpMigrateRoute.IParameter[];
-
-  /** Combined headers as single object. Null if none. */
-  headers: IHttpMigrateRoute.IHeaders | null;
-
-  /** Combined query parameters as single object. Null if none. */
-  query: IHttpMigrateRoute.IQuery | null;
-
-  /** Request body metadata. Null if none. */
-  body: IHttpMigrateRoute.IBody | null;
-
-  /** Success response (200/201). Null if void return. */
-  success: IHttpMigrateRoute.ISuccess | null;
-
-  /** Exception responses keyed by status code. */
-  exceptions: Record<string, IHttpMigrateRoute.IException>;
-
-  /** Returns description comment for the RPC function. */
-  comment: () => string;
-
-  /** Returns source {@link OpenApi.IOperation}. */
-  operation: () => OpenApi.IOperation;
-}
-export namespace IHttpMigrateRoute {
-  /** Path parameter metadata. */
-  export interface IParameter {
-    /** Parameter name in path template. */
-    name: string;
-
-    /** Parameter variable key. */
-    key: string;
-
-    /** Parameter type schema. */
-    schema: OpenApi.IJsonSchema;
-
-    /** Returns source parameter definition. */
-    parameter: () => OpenApi.IOperation.IParameter;
-  }
-
-  /** Headers metadata. */
-  export interface IHeaders {
-    /** Combined headers parameter name. */
-    name: string;
-
-    /** Headers variable key. */
-    key: string;
-
-    /** Combined headers schema. */
-    schema: OpenApi.IJsonSchema;
-
-    /** Returns title. */
-    title: () => string | undefined;
-
-    /** Returns description. */
-    description: () => string | undefined;
-
-    /** Returns example value. */
-    example: () => any | undefined;
-
-    /** Returns named examples. */
-    examples: () => Record<string, any> | undefined;
-  }
-
-  /** Query parameters metadata. */
-  export interface IQuery {
-    /** Combined query parameter name. */
-    name: string;
-
-    /** Query variable key. */
-    key: string;
-
-    /** Combined query schema. */
-    schema: OpenApi.IJsonSchema;
-
-    /** Returns title. */
-    title: () => string | undefined;
-
-    /** Returns description. */
-    description: () => string | undefined;
-
-    /** Returns example value. */
-    example: () => any | undefined;
-
-    /** Returns named examples. */
-    examples: () => Record<string, any> | undefined;
-  }
-
-  /** Request body metadata. */
-  export interface IBody {
-    /** Body parameter name. */
-    name: string;
-
-    /** Body variable key. */
-    key: string;
-
-    /** Content media type. */
-    type:
-      | "text/plain"
-      | "application/json"
-      | "application/x-www-form-urlencoded"
-      | "multipart/form-data";
-
-    /** Body type schema. */
-    schema: OpenApi.IJsonSchema;
-
-    /** Returns description. */
-    description: () => string | undefined;
-
-    /** Returns source media type definition. */
-    media: () => OpenApi.IOperation.IMediaType;
-
-    /** Nestia encryption flag. */
-    "x-nestia-encrypted"?: boolean;
-  }
-
-  /** Success response metadata. */
-  export interface ISuccess extends IBody {
-    /** HTTP status code. */
-    status: string;
-  }
-
-  /** Exception response metadata. */
-  export interface IException {
-    /** Exception type schema. */
-    schema: OpenApi.IJsonSchema;
-
-    /** Returns source response definition. */
-    response: () => OpenApi.IOperation.IResponse;
-
-    /** Returns source media type definition. */
-    media: () => OpenApi.IOperation.IMediaType;
-  }
-}
+import { OpenApi } from "../openapi/OpenApi";
+
+/**
+ * HTTP route converted from OpenAPI operation.
+ *
+ * `IHttpMigrateRoute` represents a single API endpoint with all
+ * request/response schemas resolved and ready for code generation. Contains
+ * {@link parameters} for URL path variables, {@link query} for query strings,
+ * {@link headers}, {@link body} for request payload, and
+ * {@link success}/{@link exceptions} for responses.
+ *
+ * @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";
+
+  /** Original path from OpenAPI document. */
+  path: string;
+
+  /** Emended path with `:param` format, always starts with `/`. */
+  emendedPath: string;
+
+  /**
+   * Accessor path for generated RPC function.
+   *
+   * Namespaces from static path segments, function name from method +
+   * parameters. `delete` becomes `erase` to avoid reserved keyword.
+   */
+  accessor: string[];
+
+  /** Path parameters only. */
+  parameters: IHttpMigrateRoute.IParameter[];
+
+  /** Combined headers as single object. Null if none. */
+  headers: IHttpMigrateRoute.IHeaders | null;
+
+  /** Combined query parameters as single object. Null if none. */
+  query: IHttpMigrateRoute.IQuery | null;
+
+  /** Request body metadata. Null if none. */
+  body: IHttpMigrateRoute.IBody | null;
+
+  /** Success response (200/201). Null if void return. */
+  success: IHttpMigrateRoute.ISuccess | null;
+
+  /** Exception responses keyed by status code. */
+  exceptions: Record<string, IHttpMigrateRoute.IException>;
+
+  /** Returns description comment for the RPC function. */
+  comment: () => string;
+
+  /** Returns source {@link OpenApi.IOperation}. */
+  operation: () => OpenApi.IOperation;
+}
+export namespace IHttpMigrateRoute {
+  /** Path parameter metadata. */
+  export interface IParameter {
+    /** Parameter name in path template. */
+    name: string;
+
+    /** Parameter variable key. */
+    key: string;
+
+    /** Parameter type schema. */
+    schema: OpenApi.IJsonSchema;
+
+    /** Returns source parameter definition. */
+    parameter: () => OpenApi.IOperation.IParameter;
+  }
+
+  /** Headers metadata. */
+  export interface IHeaders {
+    /** Combined headers parameter name. */
+    name: string;
+
+    /** Headers variable key. */
+    key: string;
+
+    /** Combined headers schema. */
+    schema: OpenApi.IJsonSchema;
+
+    /** Returns title. */
+    title: () => string | undefined;
+
+    /** Returns description. */
+    description: () => string | undefined;
+
+    /** Returns example value. */
+    example: () => any | undefined;
+
+    /** Returns named examples. */
+    examples: () => Record<string, any> | undefined;
+  }
+
+  /** Query parameters metadata. */
+  export interface IQuery {
+    /** Combined query parameter name. */
+    name: string;
+
+    /** Query variable key. */
+    key: string;
+
+    /** Combined query schema. */
+    schema: OpenApi.IJsonSchema;
+
+    /** Returns title. */
+    title: () => string | undefined;
+
+    /** Returns description. */
+    description: () => string | undefined;
+
+    /** Returns example value. */
+    example: () => any | undefined;
+
+    /** Returns named examples. */
+    examples: () => Record<string, any> | undefined;
+  }
+
+  /** Request body metadata. */
+  export interface IBody {
+    /** Body parameter name. */
+    name: string;
+
+    /** Body variable key. */
+    key: string;
+
+    /** Content media type. */
+    type:
+      | "text/plain"
+      | "application/json"
+      | "application/x-www-form-urlencoded"
+      | "multipart/form-data";
+
+    /** Body type schema. */
+    schema: OpenApi.IJsonSchema;
+
+    /** Returns description. */
+    description: () => string | undefined;
+
+    /** Returns source media type definition. */
+    media: () => OpenApi.IOperation.IMediaType;
+
+    /** Nestia encryption flag. */
+    "x-nestia-encrypted"?: boolean;
+  }
+
+  /** Success response metadata. */
+  export interface ISuccess extends IBody {
+    /** HTTP status code. */
+    status: string;
+  }
+
+  /** Exception response metadata. */
+  export interface IException {
+    /** Exception type schema. */
+    schema: OpenApi.IJsonSchema;
+
+    /** Returns source response definition. */
+    response: () => OpenApi.IOperation.IResponse;
+
+    /** Returns source media type definition. */
+    media: () => OpenApi.IOperation.IMediaType;
+  }
+}

package/src/http/IHttpResponse.ts

@@ -1,42 +1,42 @@
-/**
- * HTTP response structure returned from server communication.
- *
- * `IHttpResponse` represents the complete HTTP response received from a remote
- * server, containing the status code, response headers, and body. This
- * interface is used by `@nestia/fetcher` to return structured response data
- * from API calls.
- *
- * The {@link status} property contains the HTTP status code (e.g., 200, 404),
- * {@link headers} contains all response headers (some may have multiple values),
- * and {@link body} contains the parsed response body (typically JSON-decoded).
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export interface IHttpResponse {
-  /**
-   * HTTP status code of the response.
-   *
-   * Standard HTTP status codes indicating the result of the request. Common
-   * values: 200 (OK), 201 (Created), 400 (Bad Request), 401 (Unauthorized), 404
-   * (Not Found), 500 (Internal Server Error).
-   */
-  status: number;
-
-  /**
-   * Response headers from the server.
-   *
-   * Contains all HTTP headers returned by the server. Header values can be
-   * either a single string or an array of strings for headers that appear
-   * multiple times (e.g., `Set-Cookie`).
-   */
-  headers: Record<string, string | string[]>;
-
-  /**
-   * Parsed body content of the response.
-   *
-   * The response body after parsing. For JSON responses, this is the decoded
-   * JavaScript object. The actual type depends on the endpoint and response
-   * content-type.
-   */
-  body: unknown;
-}
+/**
+ * HTTP response structure returned from server communication.
+ *
+ * `IHttpResponse` represents the complete HTTP response received from a remote
+ * server, containing the status code, response headers, and body. This
+ * interface is used by `@nestia/fetcher` to return structured response data
+ * from API calls.
+ *
+ * The {@link status} property contains the HTTP status code (e.g., 200, 404),
+ * {@link headers} contains all response headers (some may have multiple values),
+ * and {@link body} contains the parsed response body (typically JSON-decoded).
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IHttpResponse {
+  /**
+   * HTTP status code of the response.
+   *
+   * Standard HTTP status codes indicating the result of the request. Common
+   * values: 200 (OK), 201 (Created), 400 (Bad Request), 401 (Unauthorized), 404
+   * (Not Found), 500 (Internal Server Error).
+   */
+  status: number;
+
+  /**
+   * Response headers from the server.
+   *
+   * Contains all HTTP headers returned by the server. Header values can be
+   * either a single string or an array of strings for headers that appear
+   * multiple times (e.g., `Set-Cookie`).
+   */
+  headers: Record<string, string | string[]>;
+
+  /**
+   * Parsed body content of the response.
+   *
+   * The response body after parsing. For JSON responses, this is the decoded
+   * JavaScript object. The actual type depends on the endpoint and response
+   * content-type.
+   */
+  body: unknown;
+}

package/src/http/index.ts

@@ -1,7 +1,7 @@
-export * from "./IHttpConnection";
-export * from "./IHttpLlmController";
-export * from "./IHttpLlmApplication";
-export * from "./IHttpLlmFunction";
-export * from "./IHttpMigrateApplication";
-export * from "./IHttpMigrateRoute";
-export * from "./IHttpResponse";
+export * from "./IHttpConnection";
+export * from "./IHttpLlmController";
+export * from "./IHttpLlmApplication";
+export * from "./IHttpLlmFunction";
+export * from "./IHttpMigrateApplication";
+export * from "./IHttpMigrateRoute";
+export * from "./IHttpResponse";

package/src/index.ts

@@ -1,9 +1,9 @@
-export * from "./http/index";
-export * from "./schema/index";
-export * from "./openapi/index";
-export * from "./typings/index";
-export * from "./utils/index";
-export * from "./metadata/index";
-export * from "./protobuf/index";
-
-export * as tags from "./tags/index";
+export * from "./http/index";
+export * from "./schema/index";
+export * from "./openapi/index";
+export * from "./typings/index";
+export * from "./utils/index";
+export * from "./metadata/index";
+export * from "./protobuf/index";
+
+export * as tags from "./tags/index";

package/src/metadata/IJsDocTagInfo.ts

@@ -1,25 +1,25 @@
-/**
- * JSDoc tag information extracted from TypeScript source.
- *
- * Represents a single JSDoc tag like `@param`, `@returns`, `@deprecated`, etc.
- * Used throughout typia's metadata system to preserve documentation.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export interface IJsDocTagInfo {
-  /** Tag name without `@` prefix (e.g., `"param"`, `"returns"`). */
-  name: string;
-
-  /** Tag text content, if any. */
-  text?: IJsDocTagInfo.IText[];
-}
-export namespace IJsDocTagInfo {
-  /** Text segment within a JSDoc tag. */
-  export interface IText {
-    /** Text content. */
-    text: string;
-
-    /** Text kind (e.g., `"text"`, `"parameterName"`). */
-    kind: string;
-  }
-}
+/**
+ * JSDoc tag information extracted from TypeScript source.
+ *
+ * Represents a single JSDoc tag like `@param`, `@returns`, `@deprecated`, etc.
+ * Used throughout typia's metadata system to preserve documentation.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IJsDocTagInfo {
+  /** Tag name without `@` prefix (e.g., `"param"`, `"returns"`). */
+  name: string;
+
+  /** Tag text content, if any. */
+  text?: IJsDocTagInfo.IText[];
+}
+export namespace IJsDocTagInfo {
+  /** Text segment within a JSDoc tag. */
+  export interface IText {
+    /** Text content. */
+    text: string;
+
+    /** Text kind (e.g., `"text"`, `"parameterName"`). */
+    kind: string;
+  }
+}

package/src/metadata/IMetadataComponents.ts

@@ -1,24 +1,24 @@
-import { IMetadataSchema } from "./IMetadataSchema";
-
-/**
- * Shared type definitions for metadata schemas.
- *
- * `IMetadataComponents` stores reusable type definitions that can be referenced
- * from {@link IMetadataSchema} via {@link IMetadataSchema.IReference}. This
- * enables deduplication of complex types across multiple schemas.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export interface IMetadataComponents {
-  /** Object type definitions. */
-  objects: IMetadataSchema.IObjectType[];
-
-  /** Type alias definitions. */
-  aliases: IMetadataSchema.IAliasType[];
-
-  /** Array type definitions. */
-  arrays: IMetadataSchema.IArrayType[];
-
-  /** Tuple type definitions. */
-  tuples: IMetadataSchema.ITupleType[];
-}
+import { IMetadataSchema } from "./IMetadataSchema";
+
+/**
+ * Shared type definitions for metadata schemas.
+ *
+ * `IMetadataComponents` stores reusable type definitions that can be referenced
+ * from {@link IMetadataSchema} via {@link IMetadataSchema.IReference}. This
+ * enables deduplication of complex types across multiple schemas.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IMetadataComponents {
+  /** Object type definitions. */
+  objects: IMetadataSchema.IObjectType[];
+
+  /** Type alias definitions. */
+  aliases: IMetadataSchema.IAliasType[];
+
+  /** Array type definitions. */
+  arrays: IMetadataSchema.IArrayType[];
+
+  /** Tuple type definitions. */
+  tuples: IMetadataSchema.ITupleType[];
+}