typia 11.0.3 → 12.0.0-dev.20260227

package/lib/http.d.ts

@@ -1,701 +1,568 @@
-import { Atomic } from "./typings/Atomic";
-import { IReadableURLSearchParams } from "./IReadableURLSearchParams";
-import { IValidation } from "./IValidation";
-import { Resolved } from "./Resolved";
+import { Atomic, IReadableURLSearchParams, IValidation, Resolved } from "@typia/interface";
 import { TypeGuardError } from "./TypeGuardError";
 /**
- * Form data decoder.
+ * Decodes `FormData` into type `T`.
  *
- * `typia.http.formData()` is a function decoding `FormData` instance, with
- * automatic type casting to the expected type. When property type is defined as
- * `boolean` or `Blob` type, `typia.http.formData()` will cast the value to the
- * expected type when decoding.
+ * Parses a `FormData` instance with automatic type casting. Properties typed as
+ * `boolean` or `Blob` are cast to expected types during decoding.
  *
- * By the way, as `FormData` is not enough to express complex data structures,
- * `typia.http.formData()` function has some limitations. If target type `T` is
- * not following those restrictions, compilation errors would be occurred.
+ * Type `T` constraints:
  *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
  * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array
- *    types are allowed
- * 4. Union types are never allowed
+ *    types allowed
+ * 4. No union types allowed
  *
- * Also, `typia.http.formData()` function does not perform validation about the
- * decoded value. Therefore, if you can't sure that input data is following the
- * `T` type, it would better to call one of below functions instead.
+ * Does not validate the decoded value. For validation, use:
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
- * @param input FormData instance
- * @returns Decoded form FormData
+ * - {@link assertFormData} — Throws on type mismatch
+ * - {@link isFormData} — Returns `null` on type mismatch
+ * - {@link validateFormData} — Returns detailed validation errors
+ *
+ * @template T Target object type
+ * @param input FormData instance to decode
+ * @returns Decoded object of type `T`
+ * @danger You must configure the generic argument `T`
  */
 export declare function formData<T extends object>(input: FormData): Resolved<T>;
 /**
- * Form data decoder with type assertion.
- *
- * `typia.http.assertFormData()` is a function decoding `FormData` instance,
- * with automatic type casting to the expected type. When property type is
- * defined as `boolean` or `Blob` type, `typia.http.assertFormData()` will cast
- * the value to the expected type when decoding.
+ * Decodes `FormData` into type `T` with assertion.
  *
- * Also, after decoding, `typia.http.assertFormData()` performs type assertion
- * to the decoded value by combining with {@link assert} function. Therefore,
- * when the decoded value is not following the `T` type, {@link TypeGuardError}
- * or custom error generated by _errorFactory_ would be thrown.
+ * Parses a `FormData` instance with automatic type casting, then validates the
+ * result via {@link assert}. Throws {@link TypeGuardError} on mismatch.
  *
- * By the way, as `FormData` is not enough to express complex data structures,
- * `typia.http.assertFormData()` function has some limitations. If target type
- * `T` is not following those restrictions, compilation errors would be
- * occurred.
+ * Type `T` constraints:
  *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
  * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array
- *    types are allowed
- * 4. Union types are never allowed
+ *    types allowed
+ * 4. No union types allowed
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
- * @param input FormData instance
- * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @returns Decoded form FormData
+ * Related functions:
+ *
+ * - {@link formData} — No validation
+ * - {@link isFormData} — Returns `null` instead of throwing
+ * - {@link validateFormData} — Returns detailed validation errors
+ *
+ * @template T Target object type
+ * @param input FormData instance to decode
+ * @param errorFactory Custom error factory receiving
+ *   {@link TypeGuardError.IProps}
+ * @returns Decoded object of type `T`
+ * @throws {TypeGuardError} When decoded value doesn't conform to type `T`
+ * @danger You must configure the generic argument `T`
  */
 export declare function assertFormData<T extends object>(input: FormData, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): Resolved<T>;
 /**
- * Form data decoder with type checking.
+ * Decodes `FormData` into type `T` with type checking.
  *
- * `typia.http.isFormData()` is a function decoding `FormData` instance, with
- * automatic type casting to the expected type. When property type is defined as
- * `boolean` or `Blob` type, `typia.http.isFormData()` will cast the value to
- * the expected type when decoding.
+ * Parses a `FormData` instance with automatic type casting, then validates the
+ * result via {@link is}. Returns `null` on type mismatch.
  *
- * Also, after decoding, `typia.http.isFormData()` performs type checking to the
- * decoded value by combining with {@link is} function. Therefore, when the
- * decoded value is not following the `T` type, `null` value would be returned.
+ * Type `T` constraints:
  *
- * By the way, as `FormData` is not enough to express complex data structures,
- * `typia.http.isFormData()` function has some limitations. If target type `T`
- * is not following those restrictions, compilation errors would be occurred.
- *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
  * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array
- *    types are allowed
- * 4. Union types are never allowed
+ *    types allowed
+ * 4. No union types allowed
+ *
+ * Related functions:
+ *
+ * - {@link formData} — No validation
+ * - {@link assertFormData} — Throws instead of returning `null`
+ * - {@link validateFormData} — Returns detailed validation errors
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
- * @param input FormData instance
- * @returns Decoded form FormData or `null` value
+ * @template T Target object type
+ * @param input FormData instance to decode
+ * @returns Decoded object of type `T`, or `null` if invalid
+ * @danger You must configure the generic argument `T`
  */
 export declare function isFormData<T extends object>(input: FormData): Resolved<T> | null;
 /**
- * Form data decoder with type validation.
- *
- * `typia.http.validateFormData()` is a function decoding `FormData` instance,
- * with automatic type casting to the expected type. When property type is
- * defined as `boolean` or `Blob` type, `typia.http.validateFormData()` will
- * cast the value to the expected type when decoding.
+ * Decodes `FormData` into type `T` with validation.
  *
- * Also, after decoding, `typia.http.validateFormData()` performs type
- * validation to the decoded value by combining with {@link validate} function.
- * Therefore, when the decoded value is not following the `T` type,
- * {@link IValidation.IFailure} would be returned. Otherwise, x@xxxx
- * IValidation.ISuccess} would be returned.
+ * Parses a `FormData` instance with automatic type casting, then validates the
+ * result via {@link validate}. Returns {@link IValidation.IFailure} with all
+ * errors on mismatch, or {@link IValidation.ISuccess} with decoded value.
  *
- * By the way, as `FormData` is not enough to express complex data structures,
- * `typia.http.validateFormData()` function has some limitations. If target type
- * `T` is not following those restrictions, compilation errors would be
- * occurred.
+ * Type `T` constraints:
  *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
  * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array
- *    types are allowed
- * 4. Union types are never allowed
+ *    types allowed
+ * 4. No union types allowed
+ *
+ * Related functions:
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
- * @param input FormData instance
- * @returns Validation result with decoded form FormData
+ * - {@link formData} — No validation
+ * - {@link assertFormData} — Throws on first error
+ * - {@link isFormData} — Returns `null` instead of error details
+ *
+ * @template T Target object type
+ * @param input FormData instance to decode
+ * @returns Validation result containing decoded value or errors
+ * @danger You must configure the generic argument `T`
  */
 export declare function validateFormData<T extends object>(input: FormData): IValidation<Resolved<T>>;
 /**
- * URL query decoder.
+ * Decodes URL query string into type `T`.
  *
- * `typia.http.query()` is a function decoding a query string or an
- * `URLSearchParams` instance, with automatic type casting to the expected type.
- * When property type be defined as `boolean` or `number` type,
- * `typia.http.query()` will cast the value to the expected type when decoding.
+ * Parses a query string or `URLSearchParams` instance with automatic type
+ * casting. Properties typed as `boolean` or `number` are cast to expected types
+ * during decoding.
  *
- * By the way, as URL query is not enough to express complex data structures,
- * `typia.http.query()` function has some limitations. If target type `T` is not
- * following those restrictions, compilation errors would be occurred.
+ * Type `T` constraints:
  *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
- * 3. Only `boolean`, `bigint`, `number`, `string` or their array types are allowed
- * 4. Union types are never allowed
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
+ * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed
+ * 4. No union types allowed
  *
- * Also, `typia.http.query()` function does not perform validation about the
- * decoded value. Therefore, if you can't sure that input data is following the
- * `T` type, it would better to call one of below functions instead.
+ * Does not validate the decoded value. For validation, use:
  *
- * - {@link assertQuery}
- * - {@link isQuery}
- * - {@link validateQuery}
+ * - {@link assertQuery} — Throws on type mismatch
+ * - {@link isQuery} — Returns `null` on type mismatch
+ * - {@link validateQuery} — Returns detailed validation errors
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
+ * @template T Target object type
  * @param input Query string or URLSearchParams instance
- * @returns Decoded query object
+ * @returns Decoded object of type `T`
+ * @danger You must configure the generic argument `T`
  */
 export declare function query<T extends object>(input: string | IReadableURLSearchParams): Resolved<T>;
 /**
- * URL query decoder with type assertion.
+ * Decodes URL query string into type `T` with assertion.
  *
- * `typia.http.assertQuery()` is a function decoding a query string or an
- * `URLSearchParams` instance, with automatic type casting to the expected type.
- * When property type is defined as `boolean` or `number` type,
- * `typia.http.assertQuery()` will cast the value to the expected type when
- * decoding.
+ * Parses a query string or `URLSearchParams` instance with automatic type
+ * casting, then validates the result via {@link assert}. Throws
+ * {@link TypeGuardError} on mismatch.
  *
- * Also, after decoding, `typia.http.assertQuery()` performs type assertion to
- * the decoded value by combining with {@link assert} function. Therefore, when
- * the decoded value is not following the `T` type, {@link TypeGuardError} or
- * custom error generated by _errorFactory_ would be thrown.
+ * Type `T` constraints:
  *
- * By the way, as URL query is not enough to express complex data structures,
- * `typia.http.assertQuery()` function has some limitations. If target type `T`
- * is notfollowing those restrictions, compilation errors would be occurred.
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
+ * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed
+ * 4. No union types allowed
  *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
- * 3. Only `boolean`, `bigint`, `number`, `string` or their array types are allowed
- * 4. Union types are never allowed
+ * Related functions:
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
+ * - {@link query} — No validation
+ * - {@link isQuery} — Returns `null` instead of throwing
+ * - {@link validateQuery} — Returns detailed validation errors
+ *
+ * @template T Target object type
  * @param input Query string or URLSearchParams instance
- * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @returns Decoded query object
+ * @param errorFactory Custom error factory receiving
+ *   {@link TypeGuardError.IProps}
+ * @returns Decoded object of type `T`
+ * @throws {TypeGuardError} When decoded value doesn't conform to type `T`
+ * @danger You must configure the generic argument `T`
  */
 export declare function assertQuery<T extends object>(input: string | IReadableURLSearchParams, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): Resolved<T>;
 /**
- * URL query decoder with type checking.
+ * Decodes URL query string into type `T` with type checking.
+ *
+ * Parses a query string or `URLSearchParams` instance with automatic type
+ * casting, then validates the result via {@link is}. Returns `null` on type
+ * mismatch.
  *
- * `typia.http.isQuery()` is a function decoding a query string or an
- * `URLSearchParams` instance, with automatic type casting to the expected type.
- * When property type is defined as `boolean` or `number` type,
- * `typia.http.isQuery()` will cast the value to the expected type when
- * decoding.
+ * Type `T` constraints:
  *
- * Also, after decoding, `typia.http.isQuery()` performs type checking to the
- * decoded value by combining with {@link is} function. Therefore, when the
- * decoded value is not following the `T` type, `null` value would be returned.
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
+ * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed
+ * 4. No union types allowed
  *
- * By the way, as URL query is not enough to express complex data structures,
- * `typia.http.isQuery()` function has some limitations. If target type `T` is
- * notfollowing those restrictions, compilation errors would be occurred.
+ * Related functions:
  *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
- * 3. Only `boolean`, `bigint`, `number`, `string` or their array types are allowed
- * 4. Union types are never allowed
+ * - {@link query} — No validation
+ * - {@link assertQuery} — Throws instead of returning `null`
+ * - {@link validateQuery} — Returns detailed validation errors
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
+ * @template T Target object type
  * @param input Query string or URLSearchParams instance
- * @returns Decoded query object or `null` value
+ * @returns Decoded object of type `T`, or `null` if invalid
+ * @danger You must configure the generic argument `T`
  */
 export declare function isQuery<T extends object>(input: string | IReadableURLSearchParams): Resolved<T> | null;
 /**
- * URL query decoder with type validation.
+ * Decodes URL query string into type `T` with validation.
+ *
+ * Parses a query string or `URLSearchParams` instance with automatic type
+ * casting, then validates the result via {@link validate}. Returns
+ * {@link IValidation.IFailure} with all errors on mismatch, or
+ * {@link IValidation.ISuccess} with decoded value.
  *
- * `typia.http.validateQuery()` is a function decoding a query string or an
- * `URLSearchParams` instance, with automatic type casting to the expected type.
- * When property type is defined as `boolean` or `number` type,
- * `typia.http.validateQuery()` will cast the value to the expected type when
- * decoding.
+ * Type `T` constraints:
  *
- * Also, after decoding, `typia.http.validateQuery()` performs type validation
- * to the decoded value by combining with {@link validate} function. Therefore,
- * when the decoded value is not following the `T` type,
- * {@link IValidation.IFailure} would be returned. Otherwise,
- * {@link IValidation.ISuccess} would be returned.
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
+ * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed
+ * 4. No union types allowed
  *
- * By the way, as URL query is not enough to express complex data structures,
- * `typia.http.validateQuery()` function has some limitations. If target type
- * `T` is notfollowing those restrictions, compilation errors would be
- * occurred.
+ * Related functions:
  *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
- * 3. Only `boolean`, `bigint`, `number`, `string` or their array types are allowed
- * 4. Union types are never allowed
+ * - {@link query} — No validation
+ * - {@link assertQuery} — Throws on first error
+ * - {@link isQuery} — Returns `null` instead of error details
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
+ * @template T Target object type
  * @param input Query string or URLSearchParams instance
- * @returns Validation result with decoded query object
+ * @returns Validation result containing decoded value or errors
+ * @danger You must configure the generic argument `T`
  */
 export declare function validateQuery<T extends object>(input: string | IReadableURLSearchParams): IValidation<Resolved<T>>;
 /**
- * Headers decoder (for express and fastify).
+ * Decodes HTTP headers into type `T`.
  *
- * `typia.http.headers()` is a function decoding an header instance, with
- * automatic type casting to the expected type. When property type is defined as
- * `boolean` or `number` type, `typia.http.headers()` will cast the value to the
- * expected type.
+ * Parses HTTP headers object with automatic type casting. Properties typed as
+ * `boolean` or `number` are cast to expected types during decoding. Compatible
+ * with Express and Fastify request headers.
  *
- * By the way, as HTTP headers are not enough to express complex data
- * structures, `typia.http.headers()` function has some limitations. If target
- * type `T` is not following those restrictions, compilation errors would be
- * occurred.
+ * Type `T` constraints:
  *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
- * 3. Property key must be lower case
- * 4. Property value cannot be `null`, but `undefined` is possible
- * 5. Only `boolean`, `bigint`, `number`, `string` or their array types are allowed
- * 6. Union types are never allowed
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
+ * 3. Property keys must be lowercase
+ * 4. Property values cannot be `null` (but `undefined` is allowed)
+ * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed
+ * 6. No union types allowed
  * 7. Property `set-cookie` must be array type
- * 8. Those properties cannot be array type
- *
- * - Age
- * - Authorization
- * - Content-length
- * - Content-type
- * - Etag
- * - Expires
- * - From
- * - Host
- * - If-modified-since
- * - If-unmodified-since
- * - Last-modified
- * - Location
- * - Max-forwards
- * - Proxy-authorization
- * - Referer
- * - Retry-after
- * - Server
- * - User-agent
- *
- * Also, `typia.http.headers()` function does not perform validation about the
- * decoded value. Therefore, if you can't sure that input data is following the
- * `T` type, it would better to call one of below functions instead.
- *
- * - {@link assertHeaders}
- * - {@link isHeaders}
- * - {@link validateHeaders}
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
- * @param input Query string or URLSearchParams instance
- * @returns Decoded headers object
+ * 8. These properties cannot be array type: `age`, `authorization`,
+ *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,
+ *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,
+ *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,
+ *    `user-agent`
+ *
+ * Does not validate the decoded value. For validation, use:
+ *
+ * - {@link assertHeaders} — Throws on type mismatch
+ * - {@link isHeaders} — Returns `null` on type mismatch
+ * - {@link validateHeaders} — Returns detailed validation errors
+ *
+ * @template T Target object type
+ * @param input Headers object from HTTP request
+ * @returns Decoded object of type `T`
+ * @danger You must configure the generic argument `T`
  */
 export declare function headers<T extends object>(input: Record<string, string | string[] | undefined>): Resolved<T>;
 /**
- * Headers decoder with type assertion (for express and fastify).
- *
- * `typia.http.assertHeaders()` is a function decoding an header instance, with
- * automatic type casting to the expected type. When property type is defined as
- * `boolean` or `number` type, `typia.http.headers()` will cast the value to the
- * expected type.
- *
- * Also, after decoding, `typia.http.assertHeaders()` performs type assertion to
- * the decoded value by combining with {@link assert} function. Therefore, when
- * the decoded value is not following the `T` type, {@link TypeGuardError} or
- * custom error generated by _errorFactory_ would be thrown.
- *
- * By the way, as HTTP headers are not enough to express complex data
- * structures, `typia.http.headers()` function has some limitations. If target
- * type `T` is not following those restrictions, compilation errors would be
- * occurred.
- *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
- * 3. Property key must be lower case
- * 4. Property value cannot be `null`, but `undefined` is possible
- * 5. Only `boolean`, `bigint`, `number`, `string` or their array types are allowed
- * 6. Union types are never allowed
+ * Decodes HTTP headers into type `T` with assertion.
+ *
+ * Parses HTTP headers object with automatic type casting, then validates the
+ * result via {@link assert}. Throws {@link TypeGuardError} on mismatch.
+ * Compatible with Express and Fastify request headers.
+ *
+ * Type `T` constraints:
+ *
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
+ * 3. Property keys must be lowercase
+ * 4. Property values cannot be `null` (but `undefined` is allowed)
+ * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed
+ * 6. No union types allowed
  * 7. Property `set-cookie` must be array type
- * 8. Those properties cannot be array type
- *
- * - Age
- * - Authorization
- * - Content-length
- * - Content-type
- * - Etag
- * - Expires
- * - From
- * - Host
- * - If-modified-since
- * - If-unmodified-since
- * - Last-modified
- * - Location
- * - Max-forwards
- * - Proxy-authorization
- * - Referer
- * - Retry-after
- * - Server
- * - User-agent
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
- * @param input Query string or URLSearchParams instance
- * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @returns Decoded headers object
+ * 8. These properties cannot be array type: `age`, `authorization`,
+ *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,
+ *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,
+ *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,
+ *    `user-agent`
+ *
+ * Related functions:
+ *
+ * - {@link headers} — No validation
+ * - {@link isHeaders} — Returns `null` instead of throwing
+ * - {@link validateHeaders} — Returns detailed validation errors
+ *
+ * @template T Target object type
+ * @param input Headers object from HTTP request
+ * @param errorFactory Custom error factory receiving
+ *   {@link TypeGuardError.IProps}
+ * @returns Decoded object of type `T`
+ * @throws {TypeGuardError} When decoded value doesn't conform to type `T`
+ * @danger You must configure the generic argument `T`
  */
 export declare function assertHeaders<T extends object>(input: Record<string, string | string[] | undefined>, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): Resolved<T>;
 /**
- * > You must configure the generic argument `T`.
+ * Decodes HTTP headers into type `T` with type checking.
+ *
+ * Parses HTTP headers object with automatic type casting, then validates the
+ * result via {@link is}. Returns `null` on type mismatch. Compatible with
+ * Express and Fastify request headers.
  *
- * Headers decoder with type checking (for express and fastify).
+ * Type `T` constraints:
  *
- * `typia.http.isHeaders()` is a function decoding an header instance, with
- * automatic type casting to the expected type. When property type is defined as
- * `boolean` or `number` type, `typia.http.headers()` will cast the value to the
- * expected type.
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
+ * 3. Property keys must be lowercase
+ * 4. Property values cannot be `null` (but `undefined` is allowed)
+ * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed
+ * 6. No union types allowed
+ * 7. Property `set-cookie` must be array type
+ * 8. These properties cannot be array type: `age`, `authorization`,
+ *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,
+ *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,
+ *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,
+ *    `user-agent`
  *
- * Also, after decoding, `typia.http.isHeaders()` performs type checking to the
- * decoded value by combining with {@link is} function. Therefore, when the
- * decoded value is not following the `T` type, `null` value would be returned.
+ * Related functions:
  *
- * By the way, as HTTP headers are not enough to express complex data
- * structures, `typia.http.headers()` function has some limitations. If target
- * type `T` is not following those restrictions, compilation errors would be
- * occurred.
+ * - {@link headers} — No validation
+ * - {@link assertHeaders} — Throws instead of returning `null`
+ * - {@link validateHeaders} — Returns detailed validation errors
  *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
- * 3. Property key must be lower case
- * 4. Property value cannot be `null`, but `undefined` is possible
- * 5. Only `boolean`, `bigint`, `number`, `string` or their array types are allowed
- * 6. Union types are never allowed
- * 7. Property `set-cookie` must be array type
- * 8. Those properties cannot be array type
- *
- * - Age
- * - Authorization
- * - Content-length
- * - Content-type
- * - Etag
- * - Expires
- * - From
- * - Host
- * - If-modified-since
- * - If-unmodified-since
- * - Last-modified
- * - Location
- * - Max-forwards
- * - Proxy-authorization
- * - Referer
- * - Retry-after
- * - Server
- * - User-agent
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
- * @param input Query string or URLSearchParams instance
- * @returns Decoded headers object or `null` value
+ * @template T Target object type
+ * @param input Headers object from HTTP request
+ * @returns Decoded object of type `T`, or `null` if invalid
+ * @danger You must configure the generic argument `T`
  */
 export declare function isHeaders<T extends object>(input: Record<string, string | string[] | undefined>): Resolved<T> | null;
 /**
- * Headers decoder with type validation (for express and fastify).
- *
- * `typia.http.validateHeaders()` is a function decoding an header instance,
- * with automatic type casting to the expected type. When property type is
- * defined as `boolean` or `number` type, `typia.http.headers()` will cast the
- * value to the expected type.
- *
- * Also, after decoding, `typia.http.validateHeaders()` performs type assertion
- * to the decoded value by combining with {@link validate} function. Therefore,
- * when the decoded value is not following the `T` type,
- * {@link IValidation.IError} would be returned. Otherwise,
- * {@link IValidation.ISuccess} be returned.
- *
- * By the way, as HTTP headers are not enough to express complex data
- * structures, `typia.http.headers()` function has some limitations. If target
- * type `T` is not following those restrictions, compilation errors would be
- * occurred.
- *
- * 1. Type `T` must be an object type
- * 2. Do not allow dynamic property
- * 3. Property key must be lower case
- * 4. Property value cannot be `null`, but `undefined` is possible
- * 5. Only `boolean`, `bigint`, `number`, `string` or their array types are allowed
- * 6. Union types are never allowed
+ * Decodes HTTP headers into type `T` with validation.
+ *
+ * Parses HTTP headers object with automatic type casting, then validates the
+ * result via {@link validate}. Returns {@link IValidation.IFailure} with all
+ * errors on mismatch, or {@link IValidation.ISuccess} with decoded value.
+ * Compatible with Express and Fastify request headers.
+ *
+ * Type `T` constraints:
+ *
+ * 1. Must be an object type
+ * 2. No dynamic properties allowed
+ * 3. Property keys must be lowercase
+ * 4. Property values cannot be `null` (but `undefined` is allowed)
+ * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed
+ * 6. No union types allowed
  * 7. Property `set-cookie` must be array type
- * 8. Those properties cannot be array type
- *
- * - Age
- * - Authorization
- * - Content-length
- * - Content-type
- * - Etag
- * - Expires
- * - From
- * - Host
- * - If-modified-since
- * - If-unmodified-since
- * - Last-modified
- * - Location
- * - Max-forwards
- * - Proxy-authorization
- * - Referer
- * - Retry-after
- * - Server
- * - User-agent
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T Expected type of decoded value
- * @param input Query string or URLSearchParams instance
- * @returns Decoded headers object
+ * 8. These properties cannot be array type: `age`, `authorization`,
+ *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,
+ *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,
+ *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,
+ *    `user-agent`
+ *
+ * Related functions:
+ *
+ * - {@link headers} — No validation
+ * - {@link assertHeaders} — Throws on first error
+ * - {@link isHeaders} — Returns `null` instead of error details
+ *
+ * @template T Target object type
+ * @param input Headers object from HTTP request
+ * @returns Validation result containing decoded value or errors
+ * @danger You must configure the generic argument `T`
  */
 export declare function validateHeaders<T extends object>(input: Record<string, string | string[] | undefined>): IValidation<Resolved<T>>;
 /**
- * URL path parameter decoder.
+ * Decodes URL path parameter into type `T`.
  *
- * `typia.http.parameter()` is a function decoding a path parameter, with
- * automatic type casting to the expected type. When type `T` has been defined
- * as `boolean` or `number` type, `typia.http.parameter()` will cast the value
- * to the expected type.
+ * Parses a path parameter string with automatic type casting. When type `T` is
+ * `boolean` or `number`, casts the string value to the expected type. Also
+ * performs type assertion via {@link assert}, throwing {@link TypeGuardError} on
+ * mismatch.
  *
- * Also, `typia.http.parameter()` performs type assertion to the decoded value
- * by combining with {@link assert} function. Therefore, when the decoded value
- * is not following the `T` type, {@link TypeGuardError} would be thrown.
- *
- * @template T Expected type of decoded value
+ * @template T Target atomic type (`boolean`, `bigint`, `number`, `string`, or
+ *   `null`)
  * @param input Path parameter string
- * @returns Decoded path parameter value
+ * @returns Decoded value of type `T`
+ * @throws {TypeGuardError} When decoded value doesn't conform to type `T`
+ * @danger You must configure the generic argument `T`
  */
 export declare function parameter<T extends Atomic.Type | null>(input: string): Resolved<T>;
 /**
- * Creates a reusable {@link formdata} function.
+ * Creates reusable {@link formData} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the formdata object
- * @throws Compile error
+ * @template T Target object type
  * @danger You must configure the generic argument `T`
  */
 export declare function createFormData(): never;
 /**
- * Creates a reusable {@link formdata} function.
+ * Creates reusable {@link formData} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the formdata object
- * @returns A reusable `formdata` function
+ * @template T Target object type
+ * @returns Reusable decoder function
  */
 export declare function createFormData<T extends object>(): (input: FormData) => T;
 /**
- * Creates a reusable {@link assertFormData} function.
+ * Creates reusable {@link assertFormData} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the formdata object
- * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @throws Compile error
+ * @template T Target object type
+ * @param errorFactory Custom error factory receiving
+ *   {@link TypeGuardError.IProps}
  * @danger You must configure the generic argument `T`
  */
 export declare function createAssertFormData(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): never;
 /**
- * Creates a reusable {@link assertFormData} function.
+ * Creates reusable {@link assertFormData} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the formdata object
- * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @returns A reusable `assertFormData` function
+ * @template T Target object type
+ * @param errorFactory Custom error factory receiving
+ *   {@link TypeGuardError.IProps}
+ * @returns Reusable decoder function
  */
 export declare function createAssertFormData<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: FormData) => T;
 /**
- * Creates a reusable {@link isFormData} function.
+ * Creates reusable {@link isFormData} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the formdata object
- * @throws Compile error
+ * @template T Target object type
  * @danger You must configure the generic argument `T`
  */
 export declare function createIsFormData(): never;
 /**
- * Creates a reusable {@link isFormData} function.
+ * Creates reusable {@link isFormData} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the formdata object
- * @returns A reusable `isFormData` function
+ * @template T Target object type
+ * @returns Reusable decoder function
  */
 export declare function createIsFormData<T extends object>(): (input: FormData) => T | null;
 /**
- * Creates a reusable {@link validateFormData} function.
+ * Creates reusable {@link validateFormData} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the formdata object
- * @throws Compile error
+ * @template T Target object type
  * @danger You must configure the generic argument `T`
  */
 export declare function createValidateFormData(): never;
 /**
- * Creates a reusable {@link validateFormData} function.
+ * Creates reusable {@link validateFormData} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the formdata object
- * @returns A reusable `validateFormData` function
+ * @template T Target object type
+ * @returns Reusable decoder function
  */
 export declare function createValidateFormData<T extends object>(): (input: FormData) => IValidation<Resolved<T>>;
 /**
- * Creates a reusable {@link query} function.
+ * Creates reusable {@link query} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the query object
- * @throws Compile error
+ * @template T Target object type
  * @danger You must configure the generic argument `T`
  */
 export declare function createQuery(): never;
 /**
- * Creates a reusable {@link query} function.
+ * Creates reusable {@link query} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the query object
- * @returns A reusable `query` function
+ * @template T Target object type
+ * @returns Reusable decoder function
  */
 export declare function createQuery<T extends object>(): (input: string | IReadableURLSearchParams) => T;
 /**
- * Creates a reusable {@link assertQuery} function.
+ * Creates reusable {@link assertQuery} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the query object
- * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @throws Compile error
+ * @template T Target object type
+ * @param errorFactory Custom error factory receiving
+ *   {@link TypeGuardError.IProps}
  * @danger You must configure the generic argument `T`
  */
 export declare function createAssertQuery(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): never;
 /**
- * Creates a reusable {@link assertQuery} function.
+ * Creates reusable {@link assertQuery} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the query object
- * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @returns A reusable `assertQuery` function
+ * @template T Target object type
+ * @param errorFactory Custom error factory receiving
+ *   {@link TypeGuardError.IProps}
+ * @returns Reusable decoder function
  */
 export declare function createAssertQuery<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: string | IReadableURLSearchParams) => T;
 /**
- * Creates a reusable {@link isQuery} function.
+ * Creates reusable {@link isQuery} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the query object
- * @throws Compile error
+ * @template T Target object type
  * @danger You must configure the generic argument `T`
  */
 export declare function createIsQuery(): never;
 /**
- * Creates a reusable {@link isQuery} function.
+ * Creates reusable {@link isQuery} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the query object
- * @returns A reusable `isQuery` function
+ * @template T Target object type
+ * @returns Reusable decoder function
  */
 export declare function createIsQuery<T extends object>(): (input: string | IReadableURLSearchParams) => T | null;
 /**
- * Creates a reusable {@link validateQuery} function.
+ * Creates reusable {@link validateQuery} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the query object
- * @throws Compile error
+ * @template T Target object type
  * @danger You must configure the generic argument `T`
  */
 export declare function createValidateQuery(): never;
 /**
- * Creates a reusable {@link validateQuery} function.
+ * Creates reusable {@link validateQuery} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the query object
- * @returns A reusable `validateQuery` function
+ * @template T Target object type
+ * @returns Reusable decoder function
  */
 export declare function createValidateQuery<T extends object>(): (input: string | IReadableURLSearchParams) => IValidation<Resolved<T>>;
 /**
- * Creates a reusable {@link headers} function.
+ * Creates reusable {@link headers} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the headers object
- * @throws Compile error
+ * @template T Target object type
  * @danger You must configure the generic argument `T`
  */
 export declare function createHeaders(): never;
 /**
- * Creates a reusable {@link headers} function.
+ * Creates reusable {@link headers} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the headers object
- * @returns A reusable `headers` function
+ * @template T Target object type
+ * @returns Reusable decoder function
  */
 export declare function createHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => T;
 /**
- * Creates a reusable {@link assertHeaders} function.
+ * Creates reusable {@link assertHeaders} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the headers object
- * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @throws Compile error
+ * @template T Target object type
+ * @param errorFactory Custom error factory receiving
+ *   {@link TypeGuardError.IProps}
  * @danger You must configure the generic argument `T`
  */
 export declare function createAssertHeaders(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): never;
 /**
- * Creates a reusable {@link assertHeaders} function.
+ * Creates reusable {@link assertHeaders} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the headers object
- * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @returns A reusable `assertHeaders` function
+ * @template T Target object type
+ * @param errorFactory Custom error factory receiving
+ *   {@link TypeGuardError.IProps}
+ * @returns Reusable decoder function
  */
 export declare function createAssertHeaders<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: Record<string, string | string[] | undefined>) => T;
 /**
- * Creates a reusable {@link isHeaders} function.
+ * Creates reusable {@link isHeaders} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the headers object
- * @throws Compile error
+ * @template T Target object type
  * @danger You must configure the generic argument `T`
  */
 export declare function createIsHeaders(): never;
 /**
- * Creates a reusable {@link isHeaders} function.
+ * Creates reusable {@link isHeaders} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the headers object
- * @returns A reusable `isHeaders` function
+ * @template T Target object type
+ * @returns Reusable decoder function
  */
 export declare function createIsHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => T | null;
 /**
- * Creates a reusable {@link validateHeaders} function.
+ * Creates reusable {@link validateHeaders} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the headers object
- * @throws Compile error
+ * @template T Target object type
  * @danger You must configure the generic argument `T`
  */
 export declare function createValidateHeaders(): never;
 /**
- * Creates a reusable {@link validateHeaders} function.
+ * Creates reusable {@link validateHeaders} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the headers object
- * @returns A reusable `validateHeaders` function
+ * @template T Target object type
+ * @returns Reusable decoder function
  */
 export declare function createValidateHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => IValidation<Resolved<T>>;
 /**
- * Creates a reusable {@link parameter} function.
+ * Creates reusable {@link parameter} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the parameter value
- * @throws Compile error
+ * @template T Target atomic type
  * @danger You must configure the generic argument `T`
  */
 export declare function createParameter(): never;
 /**
- * Creates a reusable {@link parameter} function.
+ * Creates reusable {@link parameter} function.
  *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The type of the parameter value
- * @returns A reusable `parameter` function
+ * @template T Target atomic type
+ * @returns Reusable decoder function
  */
 export declare function createParameter<T extends Atomic.Type | null>(): (input: string) => T;