typia 9.7.1 → 9.7.2

package/src/http.ts

@@ -21,9 +21,9 @@ import { TypeGuardError } from "./TypeGuardError";
  * Form data decoder.
  *
  * `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.
+ * 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.
  *
  * 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
@@ -31,24 +31,22 @@ import { TypeGuardError } from "./TypeGuardError";
  *
  * 1. Type `T` must be an object type
  * 2. Do not allow dynamic property
- * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array types are allowed
+ * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array
+ *    types are allowed
  * 4. Union types are never 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.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Expected type of decoded value
  * @param input FormData instance
  * @returns Decoded form FormData
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function formData<T extends object>(input: FormData): Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function formData(): never {
   NoTransformConfigurationError("http.formData");
 }
@@ -56,40 +54,39 @@ export function formData(): never {
 /**
  * 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.
+ * `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.
  *
- * 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.
+ * 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.
  *
  * 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.
+ * `typia.http.assertFormData()` 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. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array types are allowed
+ * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array
+ *    types are allowed
  * 4. Union types are never 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
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function assertFormData<T extends object>(
   input: FormData,
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
 ): Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function assertFormData(): never {
   NoTransformConfigurationError("http.assertFormData");
 }
@@ -98,36 +95,34 @@ export function assertFormData(): never {
  * Form data decoder 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.
+ * 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.
  *
  * 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.
  *
  * 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.
+ * `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
- * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array types are allowed
+ * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array
+ *    types are allowed
  * 4. Union types are never allowed
  *
+ * @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
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function isFormData<T extends object>(
   input: FormData,
 ): Resolved<T> | null;
 
-/**
- * @internal
- */
+/** @internal */
 export function isFormData(): never {
   NoTransformConfigurationError("http.isFormData");
 }
@@ -136,38 +131,37 @@ export function isFormData(): never {
  * 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.
+ * 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.
  *
- * 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.
+ * 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.
  *
  * 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.
+ * `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. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array types are allowed
+ * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array
+ *    types are allowed
  * 4. Union types are never allowed
  *
+ * @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
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function validateFormData<T extends object>(
   input: FormData,
 ): IValidation<Resolved<T>>;
 
-/**
- * @internal
- */
+/** @internal */
 export function validateFormData(): never {
   NoTransformConfigurationError("http.validateFormData");
 }
@@ -178,41 +172,38 @@ export function validateFormData(): never {
 /**
  * URL query decoder.
  *
- * `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.
+ * `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.
  *
  * 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.
  *
- *  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. 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
  *
- * 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.
+ * 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.
  *
- *  - {@link assertQuery}
- *  - {@link isQuery}
- *  - {@link validateQuery}
+ * - {@link assertQuery}
+ * - {@link isQuery}
+ * - {@link validateQuery}
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Expected type of decoded value
  * @param input Query string or URLSearchParams instance
  * @returns Decoded query object
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function query<T extends object>(
   input: string | IReadableURLSearchParams,
 ): Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function query(): never {
   NoTransformConfigurationError("http.query");
 }
@@ -223,37 +214,35 @@ export function query(): never {
  * `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.
+ * `typia.http.assertQuery()` will cast the value to the expected type when
+ * decoding.
  *
- * 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.
+ * 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.
  *
  * 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.
+ * `typia.http.assertQuery()` function has some limitations. If target type `T`
+ * is notfollowing those restrictions, compilation errors would be occurred.
  *
- *  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. 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
  *
+ * @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 query object
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function assertQuery<T extends object>(
   input: string | IReadableURLSearchParams,
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
 ): Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function assertQuery(): never {
   NoTransformConfigurationError("http.assertQuery");
 }
@@ -264,7 +253,8 @@ export function assertQuery(): never {
  * `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.
+ * `typia.http.isQuery()` will cast the value to the expected type when
+ * decoding.
  *
  * Also, after decoding, `typia.http.isQuery()` performs type checking to the
  * decoded value by combining with {@link is} function. Therefore, when the
@@ -274,24 +264,21 @@ export function assertQuery(): never {
  * `typia.http.isQuery()` function has some limitations. If target type `T` is
  * notfollowing those restrictions, compilation errors would be occurred.
  *
- *  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. 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
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Expected type of decoded value
  * @param input Query string or URLSearchParams instance
  * @returns Decoded query object or `null` value
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function isQuery<T extends object>(
   input: string | IReadableURLSearchParams,
 ): Resolved<T> | null;
 
-/**
- * @internal
- */
+/** @internal */
 export function isQuery(): never {
   NoTransformConfigurationError("http.isQuery");
 }
@@ -302,35 +289,35 @@ export function isQuery(): never {
  * `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.
+ * `typia.http.validateQuery()` will cast the value to the expected type when
+ * decoding.
  *
- * 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.
+ * 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.
  *
  * 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.
+ * `typia.http.validateQuery()` function has some limitations. If target type
+ * `T` is notfollowing those restrictions, compilation errors would be
+ * occurred.
  *
- *  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. 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
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Expected type of decoded value
  * @param input Query string or URLSearchParams instance
  * @returns Validation result with decoded query object
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function validateQuery<T extends object>(
   input: string | IReadableURLSearchParams,
 ): IValidation<Resolved<T>>;
 
-/**
- * @internal
- */
+/** @internal */
 export function validateQuery(): never {
   NoTransformConfigurationError("http.validateQuery");
 }
@@ -341,62 +328,62 @@ export function validateQuery(): never {
 /**
  * Headers decoder (for express and fastify).
  *
- * `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.
+ * `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.
  *
- * 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.
+ * 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
- *  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}
+ * 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
+ *
+ * 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
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function headers<T extends object>(
   input: Record<string, string | string[] | undefined>,
 ): Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function headers(): never {
   NoTransformConfigurationError("http.headers");
 }
@@ -409,57 +396,56 @@ export function headers(): never {
  * `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.
+ * 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.
+ * 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
- *  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
+ * 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
  * @param errorFactory Custom error factory. Default is `TypeGuardError`
  * @returns Decoded headers object
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function assertHeaders<T extends object>(
   input: Record<string, string | string[] | undefined>,
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
 ): Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function assertHeaders(): never {
   NoTransformConfigurationError("http.assertHeaders");
 }
@@ -478,50 +464,49 @@ export function assertHeaders(): never {
  * decoded value by combining with {@link is} function. Therefore, when the
  * decoded value is not following the `T` type, `null` value would 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.
+ * 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
- *  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
+ * 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
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function isHeaders<T extends object>(
   input: Record<string, string | string[] | undefined>,
 ): Resolved<T> | null;
 
-/**
- * @internal
- */
+/** @internal */
 export function isHeaders(): never {
   NoTransformConfigurationError("http.isHeaders");
 }
@@ -529,60 +514,60 @@ export function isHeaders(): never {
 /**
  * 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.
+ * `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.
+ * 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.
+ * 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
- *  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
+ * 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
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function validateHeaders<T extends object>(
   input: Record<string, string | string[] | undefined>,
 ): IValidation<Resolved<T>>;
 
-/**
- * @internal
- */
+/** @internal */
 export function validateHeaders(): never {
   NoTransformConfigurationError("http.validateHeaders");
 }
@@ -593,13 +578,14 @@ export function validateHeaders(): never {
 /**
  * URL path parameter decoder.
  *
- * `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.
+ * `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.
  *
- * 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.
+ * 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
  * @param input Path parameter string
@@ -609,9 +595,7 @@ export function parameter<T extends Atomic.Type | null>(
   input: string,
 ): Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function parameter(): never {
   NoTransformConfigurationError("http.parameter");
 }
@@ -622,27 +606,23 @@ export function parameter(): never {
 /**
  * Creates a reusable {@link formdata} function.
  *
- * @danger You must configure the generic argument `T`
- * @template T The type of the formdata object
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T The type of the formdata object
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createFormData(): never;
 
 /**
  * Creates a reusable {@link formdata} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T The type of the formdata object
  * @returns A reusable `formdata` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createFormData<T extends object>(): (input: FormData) => T;
 
-/**
- * @internal
- */
+/** @internal */
 export function createFormData<T>(): (input: FormData) => T {
   NoTransformConfigurationError("http.createFormData");
 }
@@ -650,12 +630,11 @@ export function createFormData<T>(): (input: FormData) => T {
 /**
  * Creates a reusable {@link assertFormData} function.
  *
- * @danger You must configure the generic argument `T`
+ * @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
- *
- * @author Jeongho Nam - https://github.com/samchon
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createAssertFormData(
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
@@ -664,19 +643,16 @@ export function createAssertFormData(
 /**
  * Creates a 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
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createAssertFormData<T extends object>(
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
 ): (input: FormData) => T;
 
-/**
- * @internal
- */
+/** @internal */
 export function createAssertFormData<T>(): (input: FormData) => T {
   NoTransformConfigurationError("http.createAssertFormData");
 }
@@ -684,29 +660,25 @@ export function createAssertFormData<T>(): (input: FormData) => T {
 /**
  * Creates a reusable {@link isFormData} function.
  *
- * @danger You must configure the generic argument `T`
- * @template T The type of the formdata object
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T The type of the formdata object
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createIsFormData(): never;
 
 /**
  * Creates a reusable {@link isFormData} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T The type of the formdata object
  * @returns A reusable `isFormData` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createIsFormData<T extends object>(): (
   input: FormData,
 ) => T | null;
 
-/**
- * @internal
- */
+/** @internal */
 export function createIsFormData<T>(): (input: FormData) => T | null {
   NoTransformConfigurationError("http.createIsFormData");
 }
@@ -714,29 +686,25 @@ export function createIsFormData<T>(): (input: FormData) => T | null {
 /**
  * Creates a reusable {@link validateFormData} function.
  *
- * @danger You must configure the generic argument `T`
- * @template T The type of the formdata object
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T The type of the formdata object
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createValidateFormData(): never;
 
 /**
  * Creates a reusable {@link validateFormData} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T The type of the formdata object
  * @returns A reusable `validateFormData` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createValidateFormData<T extends object>(): (
   input: FormData,
 ) => IValidation<Resolved<T>>;
 
-/**
- * @internal
- */
+/** @internal */
 export function createValidateFormData<T>(): (
   input: FormData,
 ) => IValidation<Resolved<T>> {
@@ -746,29 +714,25 @@ export function createValidateFormData<T>(): (
 /**
  * Creates a reusable {@link query} function.
  *
- * @danger You must configure the generic argument `T`
- * @template T The type of the query object
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T The type of the query object
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createQuery(): never;
 
 /**
  * Creates a reusable {@link query} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T The type of the query object
  * @returns A reusable `query` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createQuery<T extends object>(): (
   input: string | IReadableURLSearchParams,
 ) => T;
 
-/**
- * @internal
- */
+/** @internal */
 export function createQuery<T>(): (
   input: string | IReadableURLSearchParams,
 ) => T {
@@ -778,12 +742,11 @@ export function createQuery<T>(): (
 /**
  * Creates a reusable {@link assertQuery} function.
  *
- * @danger You must configure the generic argument `T`
+ * @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
- *
- * @author Jeongho Nam - https://github.com/samchon
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createAssertQuery(
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
@@ -792,19 +755,16 @@ export function createAssertQuery(
 /**
  * Creates a 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
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createAssertQuery<T extends object>(
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
 ): (input: string | IReadableURLSearchParams) => T;
 
-/**
- * @internal
- */
+/** @internal */
 export function createAssertQuery<T>(): (
   input: string | IReadableURLSearchParams,
 ) => T {
@@ -814,29 +774,25 @@ export function createAssertQuery<T>(): (
 /**
  * Creates a reusable {@link isQuery} function.
  *
- * @danger You must configure the generic argument `T`
- * @template T The type of the query object
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T The type of the query object
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createIsQuery(): never;
 
 /**
  * Creates a reusable {@link isQuery} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T The type of the query object
  * @returns A reusable `isQuery` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createIsQuery<T extends object>(): (
   input: string | IReadableURLSearchParams,
 ) => T | null;
 
-/**
- * @internal
- */
+/** @internal */
 export function createIsQuery<T>(): (
   input: string | IReadableURLSearchParams,
 ) => T | null {
@@ -846,29 +802,25 @@ export function createIsQuery<T>(): (
 /**
  * Creates a reusable {@link validateQuery} function.
  *
- * @danger You must configure the generic argument `T`
- * @template T The type of the query object
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T The type of the query object
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createValidateQuery(): never;
 
 /**
  * Creates a reusable {@link validateQuery} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T The type of the query object
  * @returns A reusable `validateQuery` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createValidateQuery<T extends object>(): (
   input: string | IReadableURLSearchParams,
 ) => IValidation<Resolved<T>>;
 
-/**
- * @internal
- */
+/** @internal */
 export function createValidateQuery<T>(): (
   input: string | IReadableURLSearchParams,
 ) => IValidation<Resolved<T>> {
@@ -878,29 +830,25 @@ export function createValidateQuery<T>(): (
 /**
  * Creates a reusable {@link headers} function.
  *
- * @danger You must configure the generic argument `T`
- * @template T The type of the headers object
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T The type of the headers object
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createHeaders(): never;
 
 /**
  * Creates a reusable {@link headers} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T The type of the headers object
  * @returns A reusable `headers` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createHeaders<T extends object>(): (
   input: Record<string, string | string[] | undefined>,
 ) => T;
 
-/**
- * @internal
- */
+/** @internal */
 export function createHeaders<T>(): (
   input: Record<string, string | string[] | undefined>,
 ) => T {
@@ -910,12 +858,11 @@ export function createHeaders<T>(): (
 /**
  * Creates a reusable {@link assertHeaders} function.
  *
- * @danger You must configure the generic argument `T`
+ * @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
- *
- * @author Jeongho Nam - https://github.com/samchon
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createAssertHeaders(
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
@@ -924,19 +871,16 @@ export function createAssertHeaders(
 /**
  * Creates a 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
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createAssertHeaders<T extends object>(
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
 ): (input: Record<string, string | string[] | undefined>) => T;
 
-/**
- * @internal
- */
+/** @internal */
 export function createAssertHeaders<T>(): (
   input: Record<string, string | string[] | undefined>,
 ) => T {
@@ -946,29 +890,25 @@ export function createAssertHeaders<T>(): (
 /**
  * Creates a reusable {@link isHeaders} function.
  *
- * @danger You must configure the generic argument `T`
- * @template T The type of the headers object
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T The type of the headers object
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createIsHeaders(): never;
 
 /**
  * Creates a reusable {@link isHeaders} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T The type of the headers object
  * @returns A reusable `isHeaders` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createIsHeaders<T extends object>(): (
   input: Record<string, string | string[] | undefined>,
 ) => T | null;
 
-/**
- * @internal
- */
+/** @internal */
 export function createIsHeaders<T>(): (
   input: Record<string, string | string[] | undefined>,
 ) => T | null {
@@ -978,29 +918,25 @@ export function createIsHeaders<T>(): (
 /**
  * Creates a reusable {@link validateHeaders} function.
  *
- * @danger You must configure the generic argument `T`
- * @template T The type of the headers object
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T The type of the headers object
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createValidateHeaders(): never;
 
 /**
  * Creates a reusable {@link validateHeaders} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T The type of the headers object
  * @returns A reusable `validateHeaders` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createValidateHeaders<T extends object>(): (
   input: Record<string, string | string[] | undefined>,
 ) => IValidation<Resolved<T>>;
 
-/**
- * @internal
- */
+/** @internal */
 export function createValidateHeaders<T>(): (
   input: Record<string, string | string[] | undefined>,
 ) => IValidation<Resolved<T>> {
@@ -1010,29 +946,25 @@ export function createValidateHeaders<T>(): (
 /**
  * Creates a reusable {@link parameter} function.
  *
- * @danger You must configure the generic argument `T`
- * @template T The type of the parameter value
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T The type of the parameter value
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createParameter(): never;
 
 /**
  * Creates a reusable {@link parameter} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T The type of the parameter value
  * @returns A reusable `parameter` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createParameter<T extends Atomic.Type | null>(): (
   input: string,
 ) => T;
 
-/**
- * @internal
- */
+/** @internal */
 export function createParameter<T extends Atomic.Type | null>(): (
   input: string,
 ) => T {