typia 15.0.0 → 15.0.1

package/lib/http.d.ts

@@ -4,7 +4,10 @@ import { TypeGuardError } from "./TypeGuardError";
  * Decodes `FormData` into type `T`.
  *
  * Parses a `FormData` instance with automatic type casting. Properties typed as
- * `boolean` or `Blob` are cast to expected types during decoding.
+ * `boolean`, `bigint`, or `number` are cast from their text, and `Blob` and
+ * `File` properties are read as given, except that the text `null` reads as
+ * `null`: as `undefined` instead for an optional single property whose type
+ * does not admit `null`, and always as `null` for an array element.
  *
  * Type `T` constraints:
  *
@@ -14,6 +17,11 @@ import { TypeGuardError } from "./TypeGuardError";
  *    types allowed
  * 4. No union types allowed
  *
+ * An absent key decodes a required array to `[]`, a nullable one to `null`, and
+ * an optional one to `undefined`. A string property keeps the text `null`
+ * unless its type admits `null`, and a blank numeric value decodes to
+ * `undefined`.
+ *
  * Does not validate the decoded value. For validation, use:
  *
  * - {@link assertFormData} — Throws on type mismatch
@@ -112,8 +120,8 @@ export declare function validateFormData<T extends object>(input: FormData): IVa
  * Decodes URL query string into type `T`.
  *
  * Parses a query string or `URLSearchParams` instance with automatic type
- * casting. Properties typed as `boolean` or `number` are cast to expected types
- * during decoding.
+ * casting. Properties typed as `boolean`, `bigint`, or `number` are cast to
+ * expected types during decoding.
  *
  * Type `T` constraints:
  *
@@ -122,6 +130,12 @@ export declare function validateFormData<T extends object>(input: FormData): IVa
  * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed
  * 4. No union types allowed
  *
+ * An absent key decodes a required array to `[]`, a nullable one to `null`, and
+ * an optional one to `undefined`, since a query string has no other spelling
+ * for an empty array. An absent required non-array property throws
+ * `Error("missing <key>")`. A string property keeps the text `null` unless its
+ * type admits `null`, and a blank numeric value decodes to `undefined`.
+ *
  * Does not validate the decoded value. For validation, use:
  *
  * - {@link assertQuery} — Throws on type mismatch
@@ -220,14 +234,15 @@ export declare function validateQuery<T extends object>(input: string | IReadabl
  * Decodes HTTP headers into type `T`.
  *
  * 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.
+ * `boolean`, `bigint`, or `number` are cast to expected types during decoding.
+ * 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
+ * 3. Property keys are read by their lowercase name; two keys that differ only by
+ *    case are not allowed
  * 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
@@ -238,6 +253,10 @@ export declare function validateQuery<T extends object>(input: string | IReadabl
  *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,
  *    `user-agent`
  *
+ * An absent optional array header, or one given as an empty array, is omitted,
+ * and an absent required one decodes to `[]`. `set-cookie` values are never
+ * split. A blank numeric header decodes to `undefined`.
+ *
  * Does not validate the decoded value. For validation, use:
  *
  * - {@link assertHeaders} — Throws on type mismatch
@@ -261,7 +280,8 @@ export declare function headers<T extends object>(input: Record<string, string |
  *
  * 1. Must be an object type
  * 2. No dynamic properties allowed
- * 3. Property keys must be lowercase
+ * 3. Property keys are read by their lowercase name; two keys that differ only by
+ *    case are not allowed
  * 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
@@ -298,7 +318,8 @@ export declare function assertHeaders<T extends object>(input: Record<string, st
  *
  * 1. Must be an object type
  * 2. No dynamic properties allowed
- * 3. Property keys must be lowercase
+ * 3. Property keys are read by their lowercase name; two keys that differ only by
+ *    case are not allowed
  * 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
@@ -333,7 +354,8 @@ export declare function isHeaders<T extends object>(input: Record<string, string
  *
  * 1. Must be an object type
  * 2. No dynamic properties allowed
- * 3. Property keys must be lowercase
+ * 3. Property keys are read by their lowercase name; two keys that differ only by
+ *    case are not allowed
  * 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
@@ -360,12 +382,15 @@ export declare function validateHeaders<T extends object>(input: Record<string,
  * Decodes URL path parameter into type `T`.
  *
  * 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.
+ * `boolean`, `bigint`, or `number`, casts the string value to the expected
+ * type. Also performs type assertion via {@link assert}, throwing
+ * {@link TypeGuardError} on mismatch.
+ *
+ * A blank value is not a number, and a string parameter keeps the text `null`
+ * unless `T` admits `null`.
  *
- * @template T Target atomic type (`boolean`, `bigint`, `number`, `string`, or
- *   `null`)
+ * @template T Target atomic type (`boolean`, `bigint`, `number`, or `string`),
+ *   optionally with `null`
  * @param input Path parameter string
  * @returns Decoded value of type `T`
  * @throws {TypeGuardError} When decoded value doesn't conform to type `T`
@@ -385,7 +410,7 @@ export declare function createFormData(): never;
  * @template T Target object type
  * @returns Reusable decoder function
  */
-export declare function createFormData<T extends object>(): (input: FormData) => T;
+export declare function createFormData<T extends object>(): (input: FormData) => Resolved<T>;
 /**
  * Creates reusable {@link assertFormData} function.
  *
@@ -403,7 +428,7 @@ export declare function createAssertFormData(errorFactory?: undefined | ((props:
  *   {@link TypeGuardError.IProps}
  * @returns Reusable decoder function
  */
-export declare function createAssertFormData<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: FormData, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)) => T;
+export declare function createAssertFormData<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: FormData, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)) => Resolved<T>;
 /**
  * Creates reusable {@link isFormData} function.
  *
@@ -417,7 +442,7 @@ export declare function createIsFormData(): never;
  * @template T Target object type
  * @returns Reusable decoder function
  */
-export declare function createIsFormData<T extends object>(): (input: FormData) => T | null;
+export declare function createIsFormData<T extends object>(): (input: FormData) => Resolved<T> | null;
 /**
  * Creates reusable {@link validateFormData} function.
  *
@@ -445,7 +470,7 @@ export declare function createQuery(): never;
  * @template T Target object type
  * @returns Reusable decoder function
  */
-export declare function createQuery<T extends object>(): (input: string | IReadableURLSearchParams) => T;
+export declare function createQuery<T extends object>(): (input: string | IReadableURLSearchParams) => Resolved<T>;
 /**
  * Creates reusable {@link assertQuery} function.
  *
@@ -463,7 +488,7 @@ export declare function createAssertQuery(errorFactory?: undefined | ((props: Ty
  *   {@link TypeGuardError.IProps}
  * @returns Reusable decoder function
  */
-export declare function createAssertQuery<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: string | IReadableURLSearchParams, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)) => T;
+export declare function createAssertQuery<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: string | IReadableURLSearchParams, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)) => Resolved<T>;
 /**
  * Creates reusable {@link isQuery} function.
  *
@@ -477,7 +502,7 @@ export declare function createIsQuery(): never;
  * @template T Target object type
  * @returns Reusable decoder function
  */
-export declare function createIsQuery<T extends object>(): (input: string | IReadableURLSearchParams) => T | null;
+export declare function createIsQuery<T extends object>(): (input: string | IReadableURLSearchParams) => Resolved<T> | null;
 /**
  * Creates reusable {@link validateQuery} function.
  *
@@ -505,7 +530,7 @@ export declare function createHeaders(): never;
  * @template T Target object type
  * @returns Reusable decoder function
  */
-export declare function createHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => T;
+export declare function createHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => Resolved<T>;
 /**
  * Creates reusable {@link assertHeaders} function.
  *
@@ -523,7 +548,7 @@ export declare function createAssertHeaders(errorFactory?: undefined | ((props:
  *   {@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>, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)) => T;
+export declare function createAssertHeaders<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: Record<string, string | string[] | undefined>, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)) => Resolved<T>;
 /**
  * Creates reusable {@link isHeaders} function.
  *
@@ -537,7 +562,7 @@ export declare function createIsHeaders(): never;
  * @template T Target object type
  * @returns Reusable decoder function
  */
-export declare function createIsHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => T | null;
+export declare function createIsHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => Resolved<T> | null;
 /**
  * Creates reusable {@link validateHeaders} function.
  *
@@ -565,4 +590,4 @@ export declare function createParameter(): never;
  * @template T Target atomic type
  * @returns Reusable decoder function
  */
-export declare function createParameter<T extends Atomic.Type | null>(): (input: string) => T;
+export declare function createParameter<T extends Atomic.Type | null>(): (input: string) => Resolved<T>;

package/lib/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,gGAA6F;AAuC7F,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,eAAe,CAAC,CAAC;AACjD,CAAC;AAmCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,qBAAqB,CAAC,CAAC;AACvD,CAAC;AA+BD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,iBAAiB,CAAC,CAAC;AACnD,CAAC;AAgCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,uBAAuB,CAAC,CAAC;AACzD,CAAC;AAkCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,YAAY,CAAC,CAAC;AAC9C,CAAC;AAmCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC;AA+BD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,cAAc,CAAC,CAAC;AAChD,CAAC;AAgCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AA0CD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,cAAc,CAAC,CAAC;AAChD,CAAC;AA2CD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AAuCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAwCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,sBAAsB,CAAC,CAAC;AACxD,CAAC;AAwBD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAqBD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,qBAAqB,CAAC,CAAC;AACvD,CAAC;AA6BD,gBAAgB;AAChB;IAIE,IAAA,6DAA6B,EAAC,2BAA2B,CAAC,CAAC;AAC7D,CAAC;AAoBD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,uBAAuB,CAAC,CAAC;AACzD,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,6BAA6B,CAAC,CAAC;AAC/D,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC;AA6BD,gBAAgB;AAChB;IAIE,IAAA,6DAA6B,EAAC,wBAAwB,CAAC,CAAC;AAC1D,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,0BAA0B,CAAC,CAAC;AAC5D,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AA6BD,gBAAgB;AAChB;IAIE,IAAA,6DAA6B,EAAC,0BAA0B,CAAC,CAAC;AAC5D,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,sBAAsB,CAAC,CAAC;AACxD,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,4BAA4B,CAAC,CAAC;AAC9D,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,sBAAsB,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,gGAA6F;AA+C7F,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,eAAe,CAAC,CAAC;AACjD,CAAC;AAmCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,qBAAqB,CAAC,CAAC;AACvD,CAAC;AA+BD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,iBAAiB,CAAC,CAAC;AACnD,CAAC;AAgCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,uBAAuB,CAAC,CAAC;AACzD,CAAC;AAwCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,YAAY,CAAC,CAAC;AAC9C,CAAC;AAmCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC;AA+BD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,cAAc,CAAC,CAAC;AAChD,CAAC;AAgCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AA+CD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,cAAc,CAAC,CAAC;AAChD,CAAC;AA4CD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AAwCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAyCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,sBAAsB,CAAC,CAAC;AACxD,CAAC;AA2BD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAuBD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,qBAAqB,CAAC,CAAC;AACvD,CAAC;AA6BD,gBAAgB;AAChB;IAIE,IAAA,6DAA6B,EAAC,2BAA2B,CAAC,CAAC;AAC7D,CAAC;AAoBD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,uBAAuB,CAAC,CAAC;AACzD,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,6BAA6B,CAAC,CAAC;AAC/D,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC;AA6BD,gBAAgB;AAChB;IAIE,IAAA,6DAA6B,EAAC,wBAAwB,CAAC,CAAC;AAC1D,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,0BAA0B,CAAC,CAAC;AAC5D,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AA6BD,gBAAgB;AAChB;IAIE,IAAA,6DAA6B,EAAC,0BAA0B,CAAC,CAAC;AAC5D,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,sBAAsB,CAAC,CAAC;AACxD,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,4BAA4B,CAAC,CAAC;AAC9D,CAAC;AAoBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,sBAAsB,CAAC,CAAC;AACxD,CAAC"}

package/lib/http.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"http.mjs","names":[],"sources":["../src/http.ts"],"sourcesContent":["import {\n  Atomic,\n  IReadableURLSearchParams,\n  IValidation,\n  Resolved,\n} from \"@typia/interface\";\n\nimport { TypeGuardError } from \"./TypeGuardError\";\nimport { NoTransformConfigurationError } from \"./transformers/NoTransformConfigurationError\";\n\n/* ===========================================================\n    HTTP\n      - FORM-DATA\n      - QUERY\n      - HEADERS\n      - PARAMETER\n      - FACTORY FUNCTIONS\n==============================================================\n    FORM-DATA\n----------------------------------------------------------- */\n/**\n * Decodes `FormData` into type `T`.\n *\n * Parses a `FormData` instance with automatic type casting. Properties typed as\n * `boolean` or `Blob` are cast to expected types during decoding.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array\n *    types allowed\n * 4. No union types allowed\n *\n * Does not validate the decoded value. For validation, use:\n *\n * - {@link assertFormData} — Throws on type mismatch\n * - {@link isFormData} — Returns `null` on type mismatch\n * - {@link validateFormData} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input FormData instance to decode\n * @returns Decoded object of type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function formData<T extends object>(input: FormData): Resolved<T>;\n\n/** @internal */\nexport function formData(): never {\n  NoTransformConfigurationError(\"http.formData\");\n}\n\n/**\n * Decodes `FormData` into type `T` with assertion.\n *\n * Parses a `FormData` instance with automatic type casting, then validates the\n * result via {@link assert}. Throws {@link TypeGuardError} on mismatch.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array\n *    types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link formData} — No validation\n * - {@link isFormData} — Returns `null` instead of throwing\n * - {@link validateFormData} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input FormData instance to decode\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Decoded object of type `T`\n * @throws {TypeGuardError} When decoded value doesn't conform to type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function assertFormData<T extends object>(\n  input: FormData,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): Resolved<T>;\n\n/** @internal */\nexport function assertFormData(): never {\n  NoTransformConfigurationError(\"http.assertFormData\");\n}\n\n/**\n * Decodes `FormData` into type `T` with type checking.\n *\n * Parses a `FormData` instance with automatic type casting, then validates the\n * result via {@link is}. Returns `null` on type mismatch.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array\n *    types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link formData} — No validation\n * - {@link assertFormData} — Throws instead of returning `null`\n * - {@link validateFormData} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input FormData instance to decode\n * @returns Decoded object of type `T`, or `null` if invalid\n * @danger You must configure the generic argument `T`\n */\nexport function isFormData<T extends object>(\n  input: FormData,\n): Resolved<T> | null;\n\n/** @internal */\nexport function isFormData(): never {\n  NoTransformConfigurationError(\"http.isFormData\");\n}\n\n/**\n * Decodes `FormData` into type `T` with validation.\n *\n * Parses a `FormData` instance with automatic type casting, then validates the\n * result via {@link validate}. Returns {@link IValidation.IFailure} with all\n * errors on mismatch, or {@link IValidation.ISuccess} with decoded value.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array\n *    types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link formData} — No validation\n * - {@link assertFormData} — Throws on first error\n * - {@link isFormData} — Returns `null` instead of error details\n *\n * @template T Target object type\n * @param input FormData instance to decode\n * @returns Validation result containing decoded value or errors\n * @danger You must configure the generic argument `T`\n */\nexport function validateFormData<T extends object>(\n  input: FormData,\n): IValidation<Resolved<T>>;\n\n/** @internal */\nexport function validateFormData(): never {\n  NoTransformConfigurationError(\"http.validateFormData\");\n}\n\n/* -----------------------------------------------------------\n    QUERY\n----------------------------------------------------------- */\n/**\n * Decodes URL query string into type `T`.\n *\n * Parses a query string or `URLSearchParams` instance with automatic type\n * casting. Properties typed as `boolean` or `number` are cast to expected types\n * during decoding.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 4. No union types allowed\n *\n * Does not validate the decoded value. For validation, use:\n *\n * - {@link assertQuery} — Throws on type mismatch\n * - {@link isQuery} — Returns `null` on type mismatch\n * - {@link validateQuery} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Query string or URLSearchParams instance\n * @returns Decoded object of type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function query<T extends object>(\n  input: string | IReadableURLSearchParams,\n): Resolved<T>;\n\n/** @internal */\nexport function query(): never {\n  NoTransformConfigurationError(\"http.query\");\n}\n\n/**\n * Decodes URL query string into type `T` with assertion.\n *\n * Parses a query string or `URLSearchParams` instance with automatic type\n * casting, then validates the result via {@link assert}. Throws\n * {@link TypeGuardError} on mismatch.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link query} — No validation\n * - {@link isQuery} — Returns `null` instead of throwing\n * - {@link validateQuery} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Query string or URLSearchParams instance\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Decoded object of type `T`\n * @throws {TypeGuardError} When decoded value doesn't conform to type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function assertQuery<T extends object>(\n  input: string | IReadableURLSearchParams,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): Resolved<T>;\n\n/** @internal */\nexport function assertQuery(): never {\n  NoTransformConfigurationError(\"http.assertQuery\");\n}\n\n/**\n * Decodes URL query string into type `T` with type checking.\n *\n * Parses a query string or `URLSearchParams` instance with automatic type\n * casting, then validates the result via {@link is}. Returns `null` on type\n * mismatch.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link query} — No validation\n * - {@link assertQuery} — Throws instead of returning `null`\n * - {@link validateQuery} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Query string or URLSearchParams instance\n * @returns Decoded object of type `T`, or `null` if invalid\n * @danger You must configure the generic argument `T`\n */\nexport function isQuery<T extends object>(\n  input: string | IReadableURLSearchParams,\n): Resolved<T> | null;\n\n/** @internal */\nexport function isQuery(): never {\n  NoTransformConfigurationError(\"http.isQuery\");\n}\n\n/**\n * Decodes URL query string into type `T` with validation.\n *\n * Parses a query string or `URLSearchParams` instance with automatic type\n * casting, then validates the result via {@link validate}. Returns\n * {@link IValidation.IFailure} with all errors on mismatch, or\n * {@link IValidation.ISuccess} with decoded value.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link query} — No validation\n * - {@link assertQuery} — Throws on first error\n * - {@link isQuery} — Returns `null` instead of error details\n *\n * @template T Target object type\n * @param input Query string or URLSearchParams instance\n * @returns Validation result containing decoded value or errors\n * @danger You must configure the generic argument `T`\n */\nexport function validateQuery<T extends object>(\n  input: string | IReadableURLSearchParams,\n): IValidation<Resolved<T>>;\n\n/** @internal */\nexport function validateQuery(): never {\n  NoTransformConfigurationError(\"http.validateQuery\");\n}\n\n/* -----------------------------------------------------------\n    HEADERS\n----------------------------------------------------------- */\n/**\n * Decodes HTTP headers into type `T`.\n *\n * Parses HTTP headers object with automatic type casting. Properties typed as\n * `boolean` or `number` are cast to expected types during decoding. Compatible\n * with Express and Fastify request headers.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Property keys must be lowercase\n * 4. Property values cannot be `null` (but `undefined` is allowed)\n * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 6. No union types allowed\n * 7. Property `set-cookie` must be array type\n * 8. These properties cannot be array type: `age`, `authorization`,\n *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,\n *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,\n *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,\n *    `user-agent`\n *\n * Does not validate the decoded value. For validation, use:\n *\n * - {@link assertHeaders} — Throws on type mismatch\n * - {@link isHeaders} — Returns `null` on type mismatch\n * - {@link validateHeaders} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Headers object from HTTP request\n * @returns Decoded object of type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function headers<T extends object>(\n  input: Record<string, string | string[] | undefined>,\n): Resolved<T>;\n\n/** @internal */\nexport function headers(): never {\n  NoTransformConfigurationError(\"http.headers\");\n}\n\n/**\n * Decodes HTTP headers into type `T` with assertion.\n *\n * Parses HTTP headers object with automatic type casting, then validates the\n * result via {@link assert}. Throws {@link TypeGuardError} on mismatch.\n * Compatible with Express and Fastify request headers.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Property keys must be lowercase\n * 4. Property values cannot be `null` (but `undefined` is allowed)\n * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 6. No union types allowed\n * 7. Property `set-cookie` must be array type\n * 8. These properties cannot be array type: `age`, `authorization`,\n *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,\n *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,\n *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,\n *    `user-agent`\n *\n * Related functions:\n *\n * - {@link headers} — No validation\n * - {@link isHeaders} — Returns `null` instead of throwing\n * - {@link validateHeaders} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Headers object from HTTP request\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Decoded object of type `T`\n * @throws {TypeGuardError} When decoded value doesn't conform to type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function assertHeaders<T extends object>(\n  input: Record<string, string | string[] | undefined>,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): Resolved<T>;\n\n/** @internal */\nexport function assertHeaders(): never {\n  NoTransformConfigurationError(\"http.assertHeaders\");\n}\n\n/**\n * Decodes HTTP headers into type `T` with type checking.\n *\n * Parses HTTP headers object with automatic type casting, then validates the\n * result via {@link is}. Returns `null` on type mismatch. Compatible with\n * Express and Fastify request headers.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Property keys must be lowercase\n * 4. Property values cannot be `null` (but `undefined` is allowed)\n * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 6. No union types allowed\n * 7. Property `set-cookie` must be array type\n * 8. These properties cannot be array type: `age`, `authorization`,\n *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,\n *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,\n *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,\n *    `user-agent`\n *\n * Related functions:\n *\n * - {@link headers} — No validation\n * - {@link assertHeaders} — Throws instead of returning `null`\n * - {@link validateHeaders} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Headers object from HTTP request\n * @returns Decoded object of type `T`, or `null` if invalid\n * @danger You must configure the generic argument `T`\n */\nexport function isHeaders<T extends object>(\n  input: Record<string, string | string[] | undefined>,\n): Resolved<T> | null;\n\n/** @internal */\nexport function isHeaders(): never {\n  NoTransformConfigurationError(\"http.isHeaders\");\n}\n\n/**\n * Decodes HTTP headers into type `T` with validation.\n *\n * Parses HTTP headers object with automatic type casting, then validates the\n * result via {@link validate}. Returns {@link IValidation.IFailure} with all\n * errors on mismatch, or {@link IValidation.ISuccess} with decoded value.\n * Compatible with Express and Fastify request headers.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Property keys must be lowercase\n * 4. Property values cannot be `null` (but `undefined` is allowed)\n * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 6. No union types allowed\n * 7. Property `set-cookie` must be array type\n * 8. These properties cannot be array type: `age`, `authorization`,\n *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,\n *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,\n *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,\n *    `user-agent`\n *\n * Related functions:\n *\n * - {@link headers} — No validation\n * - {@link assertHeaders} — Throws on first error\n * - {@link isHeaders} — Returns `null` instead of error details\n *\n * @template T Target object type\n * @param input Headers object from HTTP request\n * @returns Validation result containing decoded value or errors\n * @danger You must configure the generic argument `T`\n */\nexport function validateHeaders<T extends object>(\n  input: Record<string, string | string[] | undefined>,\n): IValidation<Resolved<T>>;\n\n/** @internal */\nexport function validateHeaders(): never {\n  NoTransformConfigurationError(\"http.validateHeaders\");\n}\n\n/* -----------------------------------------------------------\n    PARAMETER\n----------------------------------------------------------- */\n/**\n * Decodes URL path parameter into type `T`.\n *\n * Parses a path parameter string with automatic type casting. When type `T` is\n * `boolean` or `number`, casts the string value to the expected type. Also\n * performs type assertion via {@link assert}, throwing {@link TypeGuardError} on\n * mismatch.\n *\n * @template T Target atomic type (`boolean`, `bigint`, `number`, `string`, or\n *   `null`)\n * @param input Path parameter string\n * @returns Decoded value of type `T`\n * @throws {TypeGuardError} When decoded value doesn't conform to type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function parameter<T extends Atomic.Type | null>(\n  input: string,\n): Resolved<T>;\n\n/** @internal */\nexport function parameter(): never {\n  NoTransformConfigurationError(\"http.parameter\");\n}\n\n/* -----------------------------------------------------------\n    FACTORY FUNCTIONS\n----------------------------------------------------------- */\n/**\n * Creates reusable {@link formData} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createFormData(): never;\n\n/**\n * Creates reusable {@link formData} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createFormData<T extends object>(): (input: FormData) => T;\n\n/** @internal */\nexport function createFormData<T>(): (input: FormData) => T {\n  NoTransformConfigurationError(\"http.createFormData\");\n}\n\n/**\n * Creates reusable {@link assertFormData} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @danger You must configure the generic argument `T`\n */\nexport function createAssertFormData(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): never;\n\n/**\n * Creates reusable {@link assertFormData} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Reusable decoder function\n */\nexport function createAssertFormData<T extends object>(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): (\n  input: FormData,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => T;\n\n/** @internal */\nexport function createAssertFormData<T>(): (\n  input: FormData,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => T {\n  NoTransformConfigurationError(\"http.createAssertFormData\");\n}\n\n/**\n * Creates reusable {@link isFormData} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createIsFormData(): never;\n\n/**\n * Creates reusable {@link isFormData} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createIsFormData<T extends object>(): (\n  input: FormData,\n) => T | null;\n\n/** @internal */\nexport function createIsFormData<T>(): (input: FormData) => T | null {\n  NoTransformConfigurationError(\"http.createIsFormData\");\n}\n\n/**\n * Creates reusable {@link validateFormData} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createValidateFormData(): never;\n\n/**\n * Creates reusable {@link validateFormData} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createValidateFormData<T extends object>(): (\n  input: FormData,\n) => IValidation<Resolved<T>>;\n\n/** @internal */\nexport function createValidateFormData<T>(): (\n  input: FormData,\n) => IValidation<Resolved<T>> {\n  NoTransformConfigurationError(\"http.createValidateFormData\");\n}\n\n/**\n * Creates reusable {@link query} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createQuery(): never;\n\n/**\n * Creates reusable {@link query} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createQuery<T extends object>(): (\n  input: string | IReadableURLSearchParams,\n) => T;\n\n/** @internal */\nexport function createQuery<T>(): (\n  input: string | IReadableURLSearchParams,\n) => T {\n  NoTransformConfigurationError(\"http.createQuery\");\n}\n\n/**\n * Creates reusable {@link assertQuery} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @danger You must configure the generic argument `T`\n */\nexport function createAssertQuery(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): never;\n\n/**\n * Creates reusable {@link assertQuery} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Reusable decoder function\n */\nexport function createAssertQuery<T extends object>(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): (\n  input: string | IReadableURLSearchParams,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => T;\n\n/** @internal */\nexport function createAssertQuery<T>(): (\n  input: string | IReadableURLSearchParams,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => T {\n  NoTransformConfigurationError(\"http.createAssertQuery\");\n}\n\n/**\n * Creates reusable {@link isQuery} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createIsQuery(): never;\n\n/**\n * Creates reusable {@link isQuery} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createIsQuery<T extends object>(): (\n  input: string | IReadableURLSearchParams,\n) => T | null;\n\n/** @internal */\nexport function createIsQuery<T>(): (\n  input: string | IReadableURLSearchParams,\n) => T | null {\n  NoTransformConfigurationError(\"http.createIsQuery\");\n}\n\n/**\n * Creates reusable {@link validateQuery} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createValidateQuery(): never;\n\n/**\n * Creates reusable {@link validateQuery} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createValidateQuery<T extends object>(): (\n  input: string | IReadableURLSearchParams,\n) => IValidation<Resolved<T>>;\n\n/** @internal */\nexport function createValidateQuery<T>(): (\n  input: string | IReadableURLSearchParams,\n) => IValidation<Resolved<T>> {\n  NoTransformConfigurationError(\"http.createValidateQuery\");\n}\n\n/**\n * Creates reusable {@link headers} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createHeaders(): never;\n\n/**\n * Creates reusable {@link headers} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createHeaders<T extends object>(): (\n  input: Record<string, string | string[] | undefined>,\n) => T;\n\n/** @internal */\nexport function createHeaders<T>(): (\n  input: Record<string, string | string[] | undefined>,\n) => T {\n  NoTransformConfigurationError(\"http.createHeaders\");\n}\n\n/**\n * Creates reusable {@link assertHeaders} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @danger You must configure the generic argument `T`\n */\nexport function createAssertHeaders(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): never;\n\n/**\n * Creates reusable {@link assertHeaders} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Reusable decoder function\n */\nexport function createAssertHeaders<T extends object>(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): (\n  input: Record<string, string | string[] | undefined>,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => T;\n\n/** @internal */\nexport function createAssertHeaders<T>(): (\n  input: Record<string, string | string[] | undefined>,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => T {\n  NoTransformConfigurationError(\"http.createAssertHeaders\");\n}\n\n/**\n * Creates reusable {@link isHeaders} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createIsHeaders(): never;\n\n/**\n * Creates reusable {@link isHeaders} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createIsHeaders<T extends object>(): (\n  input: Record<string, string | string[] | undefined>,\n) => T | null;\n\n/** @internal */\nexport function createIsHeaders<T>(): (\n  input: Record<string, string | string[] | undefined>,\n) => T | null {\n  NoTransformConfigurationError(\"http.createIsHeaders\");\n}\n\n/**\n * Creates reusable {@link validateHeaders} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createValidateHeaders(): never;\n\n/**\n * Creates reusable {@link validateHeaders} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createValidateHeaders<T extends object>(): (\n  input: Record<string, string | string[] | undefined>,\n) => IValidation<Resolved<T>>;\n\n/** @internal */\nexport function createValidateHeaders<T>(): (\n  input: Record<string, string | string[] | undefined>,\n) => IValidation<Resolved<T>> {\n  NoTransformConfigurationError(\"http.createValidateHeaders\");\n}\n\n/**\n * Creates reusable {@link parameter} function.\n *\n * @template T Target atomic type\n * @danger You must configure the generic argument `T`\n */\nexport function createParameter(): never;\n\n/**\n * Creates reusable {@link parameter} function.\n *\n * @template T Target atomic type\n * @returns Reusable decoder function\n */\nexport function createParameter<T extends Atomic.Type | null>(): (\n  input: string,\n) => T;\n\n/** @internal */\nexport function createParameter<T extends Atomic.Type | null>(): (\n  input: string,\n) => T {\n  NoTransformConfigurationError(\"http.createParameter\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,WAAkB;CAChC,8BAA8B,eAAe;AAC/C;;AAoCA,SAAgB,iBAAwB;CACtC,8BAA8B,qBAAqB;AACrD;;AAgCA,SAAgB,aAAoB;CAClC,8BAA8B,iBAAiB;AACjD;;AAiCA,SAAgB,mBAA0B;CACxC,8BAA8B,uBAAuB;AACvD;;AAmCA,SAAgB,QAAe;CAC7B,8BAA8B,YAAY;AAC5C;;AAoCA,SAAgB,cAAqB;CACnC,8BAA8B,kBAAkB;AAClD;;AAgCA,SAAgB,UAAiB;CAC/B,8BAA8B,cAAc;AAC9C;;AAiCA,SAAgB,gBAAuB;CACrC,8BAA8B,oBAAoB;AACpD;;AA2CA,SAAgB,UAAiB;CAC/B,8BAA8B,cAAc;AAC9C;;AA4CA,SAAgB,gBAAuB;CACrC,8BAA8B,oBAAoB;AACpD;;AAwCA,SAAgB,YAAmB;CACjC,8BAA8B,gBAAgB;AAChD;;AAyCA,SAAgB,kBAAyB;CACvC,8BAA8B,sBAAsB;AACtD;;AAyBA,SAAgB,YAAmB;CACjC,8BAA8B,gBAAgB;AAChD;;AAsBA,SAAgB,iBAA4C;CAC1D,8BAA8B,qBAAqB;AACrD;;AA8BA,SAAgB,uBAGT;CACL,8BAA8B,2BAA2B;AAC3D;;AAqBA,SAAgB,mBAAqD;CACnE,8BAA8B,uBAAuB;AACvD;;AAqBA,SAAgB,yBAEc;CAC5B,8BAA8B,6BAA6B;AAC7D;;AAqBA,SAAgB,cAET;CACL,8BAA8B,kBAAkB;AAClD;;AA8BA,SAAgB,oBAGT;CACL,8BAA8B,wBAAwB;AACxD;;AAqBA,SAAgB,gBAEF;CACZ,8BAA8B,oBAAoB;AACpD;;AAqBA,SAAgB,sBAEc;CAC5B,8BAA8B,0BAA0B;AAC1D;;AAqBA,SAAgB,gBAET;CACL,8BAA8B,oBAAoB;AACpD;;AA8BA,SAAgB,sBAGT;CACL,8BAA8B,0BAA0B;AAC1D;;AAqBA,SAAgB,kBAEF;CACZ,8BAA8B,sBAAsB;AACtD;;AAqBA,SAAgB,wBAEc;CAC5B,8BAA8B,4BAA4B;AAC5D;;AAqBA,SAAgB,kBAET;CACL,8BAA8B,sBAAsB;AACtD"}
+{"version":3,"file":"http.mjs","names":[],"sources":["../src/http.ts"],"sourcesContent":["import {\n  Atomic,\n  IReadableURLSearchParams,\n  IValidation,\n  Resolved,\n} from \"@typia/interface\";\n\nimport { TypeGuardError } from \"./TypeGuardError\";\nimport { NoTransformConfigurationError } from \"./transformers/NoTransformConfigurationError\";\n\n/* ===========================================================\n    HTTP\n      - FORM-DATA\n      - QUERY\n      - HEADERS\n      - PARAMETER\n      - FACTORY FUNCTIONS\n==============================================================\n    FORM-DATA\n----------------------------------------------------------- */\n/**\n * Decodes `FormData` into type `T`.\n *\n * Parses a `FormData` instance with automatic type casting. Properties typed as\n * `boolean`, `bigint`, or `number` are cast from their text, and `Blob` and\n * `File` properties are read as given, except that the text `null` reads as\n * `null`: as `undefined` instead for an optional single property whose type\n * does not admit `null`, and always as `null` for an array element.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array\n *    types allowed\n * 4. No union types allowed\n *\n * An absent key decodes a required array to `[]`, a nullable one to `null`, and\n * an optional one to `undefined`. A string property keeps the text `null`\n * unless its type admits `null`, and a blank numeric value decodes to\n * `undefined`.\n *\n * Does not validate the decoded value. For validation, use:\n *\n * - {@link assertFormData} — Throws on type mismatch\n * - {@link isFormData} — Returns `null` on type mismatch\n * - {@link validateFormData} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input FormData instance to decode\n * @returns Decoded object of type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function formData<T extends object>(input: FormData): Resolved<T>;\n\n/** @internal */\nexport function formData(): never {\n  NoTransformConfigurationError(\"http.formData\");\n}\n\n/**\n * Decodes `FormData` into type `T` with assertion.\n *\n * Parses a `FormData` instance with automatic type casting, then validates the\n * result via {@link assert}. Throws {@link TypeGuardError} on mismatch.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array\n *    types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link formData} — No validation\n * - {@link isFormData} — Returns `null` instead of throwing\n * - {@link validateFormData} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input FormData instance to decode\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Decoded object of type `T`\n * @throws {TypeGuardError} When decoded value doesn't conform to type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function assertFormData<T extends object>(\n  input: FormData,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): Resolved<T>;\n\n/** @internal */\nexport function assertFormData(): never {\n  NoTransformConfigurationError(\"http.assertFormData\");\n}\n\n/**\n * Decodes `FormData` into type `T` with type checking.\n *\n * Parses a `FormData` instance with automatic type casting, then validates the\n * result via {@link is}. Returns `null` on type mismatch.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array\n *    types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link formData} — No validation\n * - {@link assertFormData} — Throws instead of returning `null`\n * - {@link validateFormData} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input FormData instance to decode\n * @returns Decoded object of type `T`, or `null` if invalid\n * @danger You must configure the generic argument `T`\n */\nexport function isFormData<T extends object>(\n  input: FormData,\n): Resolved<T> | null;\n\n/** @internal */\nexport function isFormData(): never {\n  NoTransformConfigurationError(\"http.isFormData\");\n}\n\n/**\n * Decodes `FormData` into type `T` with validation.\n *\n * Parses a `FormData` instance with automatic type casting, then validates the\n * result via {@link validate}. Returns {@link IValidation.IFailure} with all\n * errors on mismatch, or {@link IValidation.ISuccess} with decoded value.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string`, `Blob`, `File` or their array\n *    types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link formData} — No validation\n * - {@link assertFormData} — Throws on first error\n * - {@link isFormData} — Returns `null` instead of error details\n *\n * @template T Target object type\n * @param input FormData instance to decode\n * @returns Validation result containing decoded value or errors\n * @danger You must configure the generic argument `T`\n */\nexport function validateFormData<T extends object>(\n  input: FormData,\n): IValidation<Resolved<T>>;\n\n/** @internal */\nexport function validateFormData(): never {\n  NoTransformConfigurationError(\"http.validateFormData\");\n}\n\n/* -----------------------------------------------------------\n    QUERY\n----------------------------------------------------------- */\n/**\n * Decodes URL query string into type `T`.\n *\n * Parses a query string or `URLSearchParams` instance with automatic type\n * casting. Properties typed as `boolean`, `bigint`, or `number` are cast to\n * expected types during decoding.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 4. No union types allowed\n *\n * An absent key decodes a required array to `[]`, a nullable one to `null`, and\n * an optional one to `undefined`, since a query string has no other spelling\n * for an empty array. An absent required non-array property throws\n * `Error(\"missing <key>\")`. A string property keeps the text `null` unless its\n * type admits `null`, and a blank numeric value decodes to `undefined`.\n *\n * Does not validate the decoded value. For validation, use:\n *\n * - {@link assertQuery} — Throws on type mismatch\n * - {@link isQuery} — Returns `null` on type mismatch\n * - {@link validateQuery} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Query string or URLSearchParams instance\n * @returns Decoded object of type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function query<T extends object>(\n  input: string | IReadableURLSearchParams,\n): Resolved<T>;\n\n/** @internal */\nexport function query(): never {\n  NoTransformConfigurationError(\"http.query\");\n}\n\n/**\n * Decodes URL query string into type `T` with assertion.\n *\n * Parses a query string or `URLSearchParams` instance with automatic type\n * casting, then validates the result via {@link assert}. Throws\n * {@link TypeGuardError} on mismatch.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link query} — No validation\n * - {@link isQuery} — Returns `null` instead of throwing\n * - {@link validateQuery} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Query string or URLSearchParams instance\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Decoded object of type `T`\n * @throws {TypeGuardError} When decoded value doesn't conform to type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function assertQuery<T extends object>(\n  input: string | IReadableURLSearchParams,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): Resolved<T>;\n\n/** @internal */\nexport function assertQuery(): never {\n  NoTransformConfigurationError(\"http.assertQuery\");\n}\n\n/**\n * Decodes URL query string into type `T` with type checking.\n *\n * Parses a query string or `URLSearchParams` instance with automatic type\n * casting, then validates the result via {@link is}. Returns `null` on type\n * mismatch.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link query} — No validation\n * - {@link assertQuery} — Throws instead of returning `null`\n * - {@link validateQuery} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Query string or URLSearchParams instance\n * @returns Decoded object of type `T`, or `null` if invalid\n * @danger You must configure the generic argument `T`\n */\nexport function isQuery<T extends object>(\n  input: string | IReadableURLSearchParams,\n): Resolved<T> | null;\n\n/** @internal */\nexport function isQuery(): never {\n  NoTransformConfigurationError(\"http.isQuery\");\n}\n\n/**\n * Decodes URL query string into type `T` with validation.\n *\n * Parses a query string or `URLSearchParams` instance with automatic type\n * casting, then validates the result via {@link validate}. Returns\n * {@link IValidation.IFailure} with all errors on mismatch, or\n * {@link IValidation.ISuccess} with decoded value.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 4. No union types allowed\n *\n * Related functions:\n *\n * - {@link query} — No validation\n * - {@link assertQuery} — Throws on first error\n * - {@link isQuery} — Returns `null` instead of error details\n *\n * @template T Target object type\n * @param input Query string or URLSearchParams instance\n * @returns Validation result containing decoded value or errors\n * @danger You must configure the generic argument `T`\n */\nexport function validateQuery<T extends object>(\n  input: string | IReadableURLSearchParams,\n): IValidation<Resolved<T>>;\n\n/** @internal */\nexport function validateQuery(): never {\n  NoTransformConfigurationError(\"http.validateQuery\");\n}\n\n/* -----------------------------------------------------------\n    HEADERS\n----------------------------------------------------------- */\n/**\n * Decodes HTTP headers into type `T`.\n *\n * Parses HTTP headers object with automatic type casting. Properties typed as\n * `boolean`, `bigint`, or `number` are cast to expected types during decoding.\n * Compatible with Express and Fastify request headers.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Property keys are read by their lowercase name; two keys that differ only by\n *    case are not allowed\n * 4. Property values cannot be `null` (but `undefined` is allowed)\n * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 6. No union types allowed\n * 7. Property `set-cookie` must be array type\n * 8. These properties cannot be array type: `age`, `authorization`,\n *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,\n *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,\n *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,\n *    `user-agent`\n *\n * An absent optional array header, or one given as an empty array, is omitted,\n * and an absent required one decodes to `[]`. `set-cookie` values are never\n * split. A blank numeric header decodes to `undefined`.\n *\n * Does not validate the decoded value. For validation, use:\n *\n * - {@link assertHeaders} — Throws on type mismatch\n * - {@link isHeaders} — Returns `null` on type mismatch\n * - {@link validateHeaders} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Headers object from HTTP request\n * @returns Decoded object of type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function headers<T extends object>(\n  input: Record<string, string | string[] | undefined>,\n): Resolved<T>;\n\n/** @internal */\nexport function headers(): never {\n  NoTransformConfigurationError(\"http.headers\");\n}\n\n/**\n * Decodes HTTP headers into type `T` with assertion.\n *\n * Parses HTTP headers object with automatic type casting, then validates the\n * result via {@link assert}. Throws {@link TypeGuardError} on mismatch.\n * Compatible with Express and Fastify request headers.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Property keys are read by their lowercase name; two keys that differ only by\n *    case are not allowed\n * 4. Property values cannot be `null` (but `undefined` is allowed)\n * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 6. No union types allowed\n * 7. Property `set-cookie` must be array type\n * 8. These properties cannot be array type: `age`, `authorization`,\n *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,\n *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,\n *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,\n *    `user-agent`\n *\n * Related functions:\n *\n * - {@link headers} — No validation\n * - {@link isHeaders} — Returns `null` instead of throwing\n * - {@link validateHeaders} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Headers object from HTTP request\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Decoded object of type `T`\n * @throws {TypeGuardError} When decoded value doesn't conform to type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function assertHeaders<T extends object>(\n  input: Record<string, string | string[] | undefined>,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): Resolved<T>;\n\n/** @internal */\nexport function assertHeaders(): never {\n  NoTransformConfigurationError(\"http.assertHeaders\");\n}\n\n/**\n * Decodes HTTP headers into type `T` with type checking.\n *\n * Parses HTTP headers object with automatic type casting, then validates the\n * result via {@link is}. Returns `null` on type mismatch. Compatible with\n * Express and Fastify request headers.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Property keys are read by their lowercase name; two keys that differ only by\n *    case are not allowed\n * 4. Property values cannot be `null` (but `undefined` is allowed)\n * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 6. No union types allowed\n * 7. Property `set-cookie` must be array type\n * 8. These properties cannot be array type: `age`, `authorization`,\n *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,\n *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,\n *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,\n *    `user-agent`\n *\n * Related functions:\n *\n * - {@link headers} — No validation\n * - {@link assertHeaders} — Throws instead of returning `null`\n * - {@link validateHeaders} — Returns detailed validation errors\n *\n * @template T Target object type\n * @param input Headers object from HTTP request\n * @returns Decoded object of type `T`, or `null` if invalid\n * @danger You must configure the generic argument `T`\n */\nexport function isHeaders<T extends object>(\n  input: Record<string, string | string[] | undefined>,\n): Resolved<T> | null;\n\n/** @internal */\nexport function isHeaders(): never {\n  NoTransformConfigurationError(\"http.isHeaders\");\n}\n\n/**\n * Decodes HTTP headers into type `T` with validation.\n *\n * Parses HTTP headers object with automatic type casting, then validates the\n * result via {@link validate}. Returns {@link IValidation.IFailure} with all\n * errors on mismatch, or {@link IValidation.ISuccess} with decoded value.\n * Compatible with Express and Fastify request headers.\n *\n * Type `T` constraints:\n *\n * 1. Must be an object type\n * 2. No dynamic properties allowed\n * 3. Property keys are read by their lowercase name; two keys that differ only by\n *    case are not allowed\n * 4. Property values cannot be `null` (but `undefined` is allowed)\n * 5. Only `boolean`, `bigint`, `number`, `string` or their array types allowed\n * 6. No union types allowed\n * 7. Property `set-cookie` must be array type\n * 8. These properties cannot be array type: `age`, `authorization`,\n *    `content-length`, `content-type`, `etag`, `expires`, `from`, `host`,\n *    `if-modified-since`, `if-unmodified-since`, `last-modified`, `location`,\n *    `max-forwards`, `proxy-authorization`, `referer`, `retry-after`, `server`,\n *    `user-agent`\n *\n * Related functions:\n *\n * - {@link headers} — No validation\n * - {@link assertHeaders} — Throws on first error\n * - {@link isHeaders} — Returns `null` instead of error details\n *\n * @template T Target object type\n * @param input Headers object from HTTP request\n * @returns Validation result containing decoded value or errors\n * @danger You must configure the generic argument `T`\n */\nexport function validateHeaders<T extends object>(\n  input: Record<string, string | string[] | undefined>,\n): IValidation<Resolved<T>>;\n\n/** @internal */\nexport function validateHeaders(): never {\n  NoTransformConfigurationError(\"http.validateHeaders\");\n}\n\n/* -----------------------------------------------------------\n    PARAMETER\n----------------------------------------------------------- */\n/**\n * Decodes URL path parameter into type `T`.\n *\n * Parses a path parameter string with automatic type casting. When type `T` is\n * `boolean`, `bigint`, or `number`, casts the string value to the expected\n * type. Also performs type assertion via {@link assert}, throwing\n * {@link TypeGuardError} on mismatch.\n *\n * A blank value is not a number, and a string parameter keeps the text `null`\n * unless `T` admits `null`.\n *\n * @template T Target atomic type (`boolean`, `bigint`, `number`, or `string`),\n *   optionally with `null`\n * @param input Path parameter string\n * @returns Decoded value of type `T`\n * @throws {TypeGuardError} When decoded value doesn't conform to type `T`\n * @danger You must configure the generic argument `T`\n */\nexport function parameter<T extends Atomic.Type | null>(\n  input: string,\n): Resolved<T>;\n\n/** @internal */\nexport function parameter(): never {\n  NoTransformConfigurationError(\"http.parameter\");\n}\n\n/* -----------------------------------------------------------\n    FACTORY FUNCTIONS\n----------------------------------------------------------- */\n/**\n * Creates reusable {@link formData} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createFormData(): never;\n\n/**\n * Creates reusable {@link formData} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createFormData<T extends object>(): (\n  input: FormData,\n) => Resolved<T>;\n\n/** @internal */\nexport function createFormData<T>(): (input: FormData) => Resolved<T> {\n  NoTransformConfigurationError(\"http.createFormData\");\n}\n\n/**\n * Creates reusable {@link assertFormData} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @danger You must configure the generic argument `T`\n */\nexport function createAssertFormData(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): never;\n\n/**\n * Creates reusable {@link assertFormData} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Reusable decoder function\n */\nexport function createAssertFormData<T extends object>(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): (\n  input: FormData,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => Resolved<T>;\n\n/** @internal */\nexport function createAssertFormData<T>(): (\n  input: FormData,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => Resolved<T> {\n  NoTransformConfigurationError(\"http.createAssertFormData\");\n}\n\n/**\n * Creates reusable {@link isFormData} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createIsFormData(): never;\n\n/**\n * Creates reusable {@link isFormData} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createIsFormData<T extends object>(): (\n  input: FormData,\n) => Resolved<T> | null;\n\n/** @internal */\nexport function createIsFormData<T>(): (input: FormData) => Resolved<T> | null {\n  NoTransformConfigurationError(\"http.createIsFormData\");\n}\n\n/**\n * Creates reusable {@link validateFormData} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createValidateFormData(): never;\n\n/**\n * Creates reusable {@link validateFormData} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createValidateFormData<T extends object>(): (\n  input: FormData,\n) => IValidation<Resolved<T>>;\n\n/** @internal */\nexport function createValidateFormData<T>(): (\n  input: FormData,\n) => IValidation<Resolved<T>> {\n  NoTransformConfigurationError(\"http.createValidateFormData\");\n}\n\n/**\n * Creates reusable {@link query} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createQuery(): never;\n\n/**\n * Creates reusable {@link query} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createQuery<T extends object>(): (\n  input: string | IReadableURLSearchParams,\n) => Resolved<T>;\n\n/** @internal */\nexport function createQuery<T>(): (\n  input: string | IReadableURLSearchParams,\n) => Resolved<T> {\n  NoTransformConfigurationError(\"http.createQuery\");\n}\n\n/**\n * Creates reusable {@link assertQuery} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @danger You must configure the generic argument `T`\n */\nexport function createAssertQuery(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): never;\n\n/**\n * Creates reusable {@link assertQuery} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Reusable decoder function\n */\nexport function createAssertQuery<T extends object>(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): (\n  input: string | IReadableURLSearchParams,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => Resolved<T>;\n\n/** @internal */\nexport function createAssertQuery<T>(): (\n  input: string | IReadableURLSearchParams,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => Resolved<T> {\n  NoTransformConfigurationError(\"http.createAssertQuery\");\n}\n\n/**\n * Creates reusable {@link isQuery} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createIsQuery(): never;\n\n/**\n * Creates reusable {@link isQuery} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createIsQuery<T extends object>(): (\n  input: string | IReadableURLSearchParams,\n) => Resolved<T> | null;\n\n/** @internal */\nexport function createIsQuery<T>(): (\n  input: string | IReadableURLSearchParams,\n) => Resolved<T> | null {\n  NoTransformConfigurationError(\"http.createIsQuery\");\n}\n\n/**\n * Creates reusable {@link validateQuery} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createValidateQuery(): never;\n\n/**\n * Creates reusable {@link validateQuery} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createValidateQuery<T extends object>(): (\n  input: string | IReadableURLSearchParams,\n) => IValidation<Resolved<T>>;\n\n/** @internal */\nexport function createValidateQuery<T>(): (\n  input: string | IReadableURLSearchParams,\n) => IValidation<Resolved<T>> {\n  NoTransformConfigurationError(\"http.createValidateQuery\");\n}\n\n/**\n * Creates reusable {@link headers} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createHeaders(): never;\n\n/**\n * Creates reusable {@link headers} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createHeaders<T extends object>(): (\n  input: Record<string, string | string[] | undefined>,\n) => Resolved<T>;\n\n/** @internal */\nexport function createHeaders<T>(): (\n  input: Record<string, string | string[] | undefined>,\n) => Resolved<T> {\n  NoTransformConfigurationError(\"http.createHeaders\");\n}\n\n/**\n * Creates reusable {@link assertHeaders} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @danger You must configure the generic argument `T`\n */\nexport function createAssertHeaders(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): never;\n\n/**\n * Creates reusable {@link assertHeaders} function.\n *\n * @template T Target object type\n * @param errorFactory Custom error factory receiving\n *   {@link TypeGuardError.IProps}\n * @returns Reusable decoder function\n */\nexport function createAssertHeaders<T extends object>(\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n): (\n  input: Record<string, string | string[] | undefined>,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => Resolved<T>;\n\n/** @internal */\nexport function createAssertHeaders<T>(): (\n  input: Record<string, string | string[] | undefined>,\n  errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),\n) => Resolved<T> {\n  NoTransformConfigurationError(\"http.createAssertHeaders\");\n}\n\n/**\n * Creates reusable {@link isHeaders} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createIsHeaders(): never;\n\n/**\n * Creates reusable {@link isHeaders} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createIsHeaders<T extends object>(): (\n  input: Record<string, string | string[] | undefined>,\n) => Resolved<T> | null;\n\n/** @internal */\nexport function createIsHeaders<T>(): (\n  input: Record<string, string | string[] | undefined>,\n) => Resolved<T> | null {\n  NoTransformConfigurationError(\"http.createIsHeaders\");\n}\n\n/**\n * Creates reusable {@link validateHeaders} function.\n *\n * @template T Target object type\n * @danger You must configure the generic argument `T`\n */\nexport function createValidateHeaders(): never;\n\n/**\n * Creates reusable {@link validateHeaders} function.\n *\n * @template T Target object type\n * @returns Reusable decoder function\n */\nexport function createValidateHeaders<T extends object>(): (\n  input: Record<string, string | string[] | undefined>,\n) => IValidation<Resolved<T>>;\n\n/** @internal */\nexport function createValidateHeaders<T>(): (\n  input: Record<string, string | string[] | undefined>,\n) => IValidation<Resolved<T>> {\n  NoTransformConfigurationError(\"http.createValidateHeaders\");\n}\n\n/**\n * Creates reusable {@link parameter} function.\n *\n * @template T Target atomic type\n * @danger You must configure the generic argument `T`\n */\nexport function createParameter(): never;\n\n/**\n * Creates reusable {@link parameter} function.\n *\n * @template T Target atomic type\n * @returns Reusable decoder function\n */\nexport function createParameter<T extends Atomic.Type | null>(): (\n  input: string,\n) => Resolved<T>;\n\n/** @internal */\nexport function createParameter<T extends Atomic.Type | null>(): (\n  input: string,\n) => Resolved<T> {\n  NoTransformConfigurationError(\"http.createParameter\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,WAAkB;CAChC,8BAA8B,eAAe;AAC/C;;AAoCA,SAAgB,iBAAwB;CACtC,8BAA8B,qBAAqB;AACrD;;AAgCA,SAAgB,aAAoB;CAClC,8BAA8B,iBAAiB;AACjD;;AAiCA,SAAgB,mBAA0B;CACxC,8BAA8B,uBAAuB;AACvD;;AAyCA,SAAgB,QAAe;CAC7B,8BAA8B,YAAY;AAC5C;;AAoCA,SAAgB,cAAqB;CACnC,8BAA8B,kBAAkB;AAClD;;AAgCA,SAAgB,UAAiB;CAC/B,8BAA8B,cAAc;AAC9C;;AAiCA,SAAgB,gBAAuB;CACrC,8BAA8B,oBAAoB;AACpD;;AAgDA,SAAgB,UAAiB;CAC/B,8BAA8B,cAAc;AAC9C;;AA6CA,SAAgB,gBAAuB;CACrC,8BAA8B,oBAAoB;AACpD;;AAyCA,SAAgB,YAAmB;CACjC,8BAA8B,gBAAgB;AAChD;;AA0CA,SAAgB,kBAAyB;CACvC,8BAA8B,sBAAsB;AACtD;;AA4BA,SAAgB,YAAmB;CACjC,8BAA8B,gBAAgB;AAChD;;AAwBA,SAAgB,iBAAsD;CACpE,8BAA8B,qBAAqB;AACrD;;AA8BA,SAAgB,uBAGC;CACf,8BAA8B,2BAA2B;AAC3D;;AAqBA,SAAgB,mBAA+D;CAC7E,8BAA8B,uBAAuB;AACvD;;AAqBA,SAAgB,yBAEc;CAC5B,8BAA8B,6BAA6B;AAC7D;;AAqBA,SAAgB,cAEC;CACf,8BAA8B,kBAAkB;AAClD;;AA8BA,SAAgB,oBAGC;CACf,8BAA8B,wBAAwB;AACxD;;AAqBA,SAAgB,gBAEQ;CACtB,8BAA8B,oBAAoB;AACpD;;AAqBA,SAAgB,sBAEc;CAC5B,8BAA8B,0BAA0B;AAC1D;;AAqBA,SAAgB,gBAEC;CACf,8BAA8B,oBAAoB;AACpD;;AA8BA,SAAgB,sBAGC;CACf,8BAA8B,0BAA0B;AAC1D;;AAqBA,SAAgB,kBAEQ;CACtB,8BAA8B,sBAAsB;AACtD;;AAqBA,SAAgB,wBAEc;CAC5B,8BAA8B,4BAA4B;AAC5D;;AAqBA,SAAgB,kBAEC;CACf,8BAA8B,sBAAsB;AACtD"}

package/lib/internal/_httpFormDataReadBigint.js

@@ -3,11 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._httpFormDataReadBigint = void 0;
 const _httpFormDataReadBigint = (input) => input instanceof File
     ? input
-    : !!(input === null || input === void 0 ? void 0 : input.length)
-        ? input === "null"
-            ? null
-            : toBigint(input)
-        : undefined;
+    : // Blank text is absent, as the empty string always was: `BigInt(" ")`
+        // is 0n, which would read a whitespace value as a real zero (#2448).
+        typeof input === "string" && input.trim().length !== 0
+            ? input === "null"
+                ? null
+                : toBigint(input)
+            : undefined;
 exports._httpFormDataReadBigint = _httpFormDataReadBigint;
 const toBigint = (str) => {
     try {

package/lib/internal/_httpFormDataReadBigint.js.map

@@ -1 +1 @@
-{"version":3,"file":"_httpFormDataReadBigint.js","sourceRoot":"","sources":["../../src/internal/_httpFormDataReadBigint.ts"],"names":[],"mappings":";;;AAAO,MAAM,uBAAuB,GAAG,CACrC,KAA2B,EACA,EAAE,CAC7B,KAAK,YAAY,IAAI;IACnB,CAAC,CAAE,KAAa;IAChB,CAAC,CAAC,CAAC,EAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAAM,CAAA;QACf,CAAC,CAAC,KAAK,KAAK,MAAM;YAChB,CAAC,CAAC,IAAI;YACN,CAAC,CAAE,QAAQ,CAAC,KAAK,CAAS;QAC5B,CAAC,CAAC,SAAS,CAAC;AATL,QAAA,uBAAuB,GAAvB,uBAAuB,CASlB;AAElB,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAmB,EAAE;IAChD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;eAAO,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"_httpFormDataReadBigint.js","sourceRoot":"","sources":["../../src/internal/_httpFormDataReadBigint.ts"],"names":[],"mappings":";;;AAAO,MAAM,uBAAuB,GAAG,CACrC,KAA2B,EACA,EAAE,CAC7B,KAAK,YAAY,IAAI;IACnB,CAAC,CAAE,KAAa;IAChB,CAAC,CAAC,sEAAsE;QACtE,qEAAqE;QACrE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YACtD,CAAC,CAAC,KAAK,KAAK,MAAM;gBAChB,CAAC,CAAC,IAAI;gBACN,CAAC,CAAE,QAAQ,CAAC,KAAK,CAAS;YAC5B,CAAC,CAAC,SAAS,CAAC;AAXL,QAAA,uBAAuB,GAAvB,uBAAuB,CAWlB;AAElB,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAmB,EAAE;IAChD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;eAAO,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC,CAAC"}

package/lib/internal/_httpFormDataReadBigint.mjs

@@ -1,5 +1,5 @@
 //#region src/internal/_httpFormDataReadBigint.ts
-const _httpFormDataReadBigint = (input) => input instanceof File ? input : !!input?.length ? input === "null" ? null : toBigint(input) : void 0;
+const _httpFormDataReadBigint = (input) => input instanceof File ? input : typeof input === "string" && input.trim().length !== 0 ? input === "null" ? null : toBigint(input) : void 0;
 const toBigint = (str) => {
 	try {
 		return BigInt(str);

package/lib/internal/_httpFormDataReadBigint.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_httpFormDataReadBigint.mjs","names":[],"sources":["../../src/internal/_httpFormDataReadBigint.ts"],"sourcesContent":["export const _httpFormDataReadBigint = (\n  input: string | File | null,\n): bigint | null | undefined =>\n  input instanceof File\n    ? (input as any)\n    : !!input?.length\n      ? input === \"null\"\n        ? null\n        : (toBigint(input) as any)\n      : undefined;\n\nconst toBigint = (str: string): bigint | string => {\n  try {\n    return BigInt(str);\n  } catch {\n    return str;\n  }\n};\n"],"mappings":";AAAA,MAAa,2BACX,UAEA,iBAAiB,OACZ,QACD,CAAC,CAAC,OAAO,SACP,UAAU,SACR,OACC,SAAS,KAAK,IACjB,KAAA;AAER,MAAM,YAAY,QAAiC;CACjD,IAAI;EACF,OAAO,OAAO,GAAG;CACnB,QAAQ;EACN,OAAO;CACT;AACF"}
+{"version":3,"file":"_httpFormDataReadBigint.mjs","names":[],"sources":["../../src/internal/_httpFormDataReadBigint.ts"],"sourcesContent":["export const _httpFormDataReadBigint = (\n  input: string | File | null,\n): bigint | null | undefined =>\n  input instanceof File\n    ? (input as any)\n    : // Blank text is absent, as the empty string always was: `BigInt(\" \")`\n      // is 0n, which would read a whitespace value as a real zero (#2448).\n      typeof input === \"string\" && input.trim().length !== 0\n      ? input === \"null\"\n        ? null\n        : (toBigint(input) as any)\n      : undefined;\n\nconst toBigint = (str: string): bigint | string => {\n  try {\n    return BigInt(str);\n  } catch {\n    return str;\n  }\n};\n"],"mappings":";AAAA,MAAa,2BACX,UAEA,iBAAiB,OACZ,QAGD,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,WAAW,IACnD,UAAU,SACR,OACC,SAAS,KAAK,IACjB,KAAA;AAER,MAAM,YAAY,QAAiC;CACjD,IAAI;EACF,OAAO,OAAO,GAAG;CACnB,QAAQ;EACN,OAAO;CACT;AACF"}

package/lib/internal/_httpFormDataReadBoolean.js

@@ -3,16 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._httpFormDataReadBoolean = void 0;
 const _httpFormDataReadBoolean = (input) => input instanceof File
     ? input
-    : input === null
-        ? undefined
-        : input === "null"
-            ? null
-            : input.length === 0
-                ? true
-                : input === "true" || input === "1"
+    : // `undefined` is as absent as `null`, which `FormData.get` returns; a
+        // stand-in that answers `undefined` must not throw on `.length`.
+        input === null || input === undefined
+            ? undefined
+            : input === "null"
+                ? null
+                : input.length === 0
                     ? true
-                    : input === "false" || input === "0"
-                        ? false
-                        : input; // wrong type
+                    : input === "true" || input === "1"
+                        ? true
+                        : input === "false" || input === "0"
+                            ? false
+                            : input; // wrong type
 exports._httpFormDataReadBoolean = _httpFormDataReadBoolean;
 //# sourceMappingURL=_httpFormDataReadBoolean.js.map

package/lib/internal/_httpFormDataReadBoolean.js.map

@@ -1 +1 @@
-{"version":3,"file":"_httpFormDataReadBoolean.js","sourceRoot":"","sources":["../../src/internal/_httpFormDataReadBoolean.ts"],"names":[],"mappings":";;;AAAO,MAAM,wBAAwB,GAAG,CACtC,KAA2B,EACC,EAAE,CAC9B,KAAK,YAAY,IAAI;IACnB,CAAC,CAAE,KAAa;IAChB,CAAC,CAAC,KAAK,KAAK,IAAI;QACd,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK,KAAK,MAAM;YAChB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;gBAClB,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG;oBACjC,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,GAAG;wBAClC,CAAC,CAAC,KAAK;wBACP,CAAC,CAAE,KAAa,CAAC,CAAC,aAAa;AAfhC,QAAA,wBAAwB,GAAxB,wBAAwB,CAeN"}
+{"version":3,"file":"_httpFormDataReadBoolean.js","sourceRoot":"","sources":["../../src/internal/_httpFormDataReadBoolean.ts"],"names":[],"mappings":";;;AAAO,MAAM,wBAAwB,GAAG,CACtC,KAA2B,EACC,EAAE,CAC9B,KAAK,YAAY,IAAI;IACnB,CAAC,CAAE,KAAa;IAChB,CAAC,CAAC,sEAAsE;QACtE,iEAAiE;QACjE,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YACrC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,KAAK,KAAK,MAAM;gBAChB,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;oBAClB,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG;wBACjC,CAAC,CAAC,IAAI;wBACN,CAAC,CAAC,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,GAAG;4BAClC,CAAC,CAAC,KAAK;4BACP,CAAC,CAAE,KAAa,CAAC,CAAC,aAAa;AAjBhC,QAAA,wBAAwB,GAAxB,wBAAwB,CAiBN"}

package/lib/internal/_httpFormDataReadBoolean.mjs

@@ -1,5 +1,5 @@
 //#region src/internal/_httpFormDataReadBoolean.ts
-const _httpFormDataReadBoolean = (input) => input instanceof File ? input : input === null ? void 0 : input === "null" ? null : input.length === 0 ? true : input === "true" || input === "1" ? true : input === "false" || input === "0" ? false : input;
+const _httpFormDataReadBoolean = (input) => input instanceof File ? input : input === null || input === void 0 ? void 0 : input === "null" ? null : input.length === 0 ? true : input === "true" || input === "1" ? true : input === "false" || input === "0" ? false : input;
 //#endregion
 export { _httpFormDataReadBoolean };
 

package/lib/internal/_httpFormDataReadBoolean.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_httpFormDataReadBoolean.mjs","names":[],"sources":["../../src/internal/_httpFormDataReadBoolean.ts"],"sourcesContent":["export const _httpFormDataReadBoolean = (\n  input: string | File | null,\n): boolean | null | undefined =>\n  input instanceof File\n    ? (input as any)\n    : input === null\n      ? undefined\n      : input === \"null\"\n        ? null\n        : input.length === 0\n          ? true\n          : input === \"true\" || input === \"1\"\n            ? true\n            : input === \"false\" || input === \"0\"\n              ? false\n              : (input as any); // wrong type\n"],"mappings":";AAAA,MAAa,4BACX,UAEA,iBAAiB,OACZ,QACD,UAAU,OACR,KAAA,IACA,UAAU,SACR,OACA,MAAM,WAAW,IACf,OACA,UAAU,UAAU,UAAU,MAC5B,OACA,UAAU,WAAW,UAAU,MAC7B,QACC"}
+{"version":3,"file":"_httpFormDataReadBoolean.mjs","names":[],"sources":["../../src/internal/_httpFormDataReadBoolean.ts"],"sourcesContent":["export const _httpFormDataReadBoolean = (\n  input: string | File | null,\n): boolean | null | undefined =>\n  input instanceof File\n    ? (input as any)\n    : // `undefined` is as absent as `null`, which `FormData.get` returns; a\n      // stand-in that answers `undefined` must not throw on `.length`.\n      input === null || input === undefined\n      ? undefined\n      : input === \"null\"\n        ? null\n        : input.length === 0\n          ? true\n          : input === \"true\" || input === \"1\"\n            ? true\n            : input === \"false\" || input === \"0\"\n              ? false\n              : (input as any); // wrong type\n"],"mappings":";AAAA,MAAa,4BACX,UAEA,iBAAiB,OACZ,QAGD,UAAU,QAAQ,UAAU,KAAA,IAC1B,KAAA,IACA,UAAU,SACR,OACA,MAAM,WAAW,IACf,OACA,UAAU,UAAU,UAAU,MAC5B,OACA,UAAU,WAAW,UAAU,MAC7B,QACC"}

package/lib/internal/_httpFormDataReadNumber.js

@@ -3,11 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._httpFormDataReadNumber = void 0;
 const _httpFormDataReadNumber = (input) => input instanceof File
     ? input
-    : !!(input === null || input === void 0 ? void 0 : input.length)
-        ? input === "null"
-            ? null
-            : toNumber(input)
-        : undefined;
+    : // Blank text is absent, as the empty string always was: `Number(" ")`
+        // is 0, which would read a whitespace value as a real zero (#2448).
+        typeof input === "string" && input.trim().length !== 0
+            ? input === "null"
+                ? null
+                : toNumber(input)
+            : undefined;
 exports._httpFormDataReadNumber = _httpFormDataReadNumber;
 const toNumber = (str) => {
     const value = Number(str);

package/lib/internal/_httpFormDataReadNumber.js.map

@@ -1 +1 @@
-{"version":3,"file":"_httpFormDataReadNumber.js","sourceRoot":"","sources":["../../src/internal/_httpFormDataReadNumber.ts"],"names":[],"mappings":";;;AAAO,MAAM,uBAAuB,GAAG,CACrC,KAA2B,EACA,EAAE,CAC7B,KAAK,YAAY,IAAI;IACnB,CAAC,CAAE,KAAa;IAChB,CAAC,CAAC,CAAC,EAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAAM,CAAA;QACf,CAAC,CAAC,KAAK,KAAK,MAAM;YAChB,CAAC,CAAC,IAAI;YACN,CAAC,CAAE,QAAQ,CAAC,KAAK,CAAS;QAC5B,CAAC,CAAC,SAAS,CAAC;AATL,QAAA,uBAAuB,GAAvB,uBAAuB,CASlB;AAElB,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAmB,EAAE;IAChD,MAAM,KAAK,GAAW,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACpC,CAAC,CAAC"}
+{"version":3,"file":"_httpFormDataReadNumber.js","sourceRoot":"","sources":["../../src/internal/_httpFormDataReadNumber.ts"],"names":[],"mappings":";;;AAAO,MAAM,uBAAuB,GAAG,CACrC,KAA2B,EACA,EAAE,CAC7B,KAAK,YAAY,IAAI;IACnB,CAAC,CAAE,KAAa;IAChB,CAAC,CAAC,sEAAsE;QACtE,oEAAoE;QACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YACtD,CAAC,CAAC,KAAK,KAAK,MAAM;gBAChB,CAAC,CAAC,IAAI;gBACN,CAAC,CAAE,QAAQ,CAAC,KAAK,CAAS;YAC5B,CAAC,CAAC,SAAS,CAAC;AAXL,QAAA,uBAAuB,GAAvB,uBAAuB,CAWlB;AAElB,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAmB,EAAE;IAChD,MAAM,KAAK,GAAW,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACpC,CAAC,CAAC"}

package/lib/internal/_httpFormDataReadNumber.mjs

@@ -1,5 +1,5 @@
 //#region src/internal/_httpFormDataReadNumber.ts
-const _httpFormDataReadNumber = (input) => input instanceof File ? input : !!input?.length ? input === "null" ? null : toNumber(input) : void 0;
+const _httpFormDataReadNumber = (input) => input instanceof File ? input : typeof input === "string" && input.trim().length !== 0 ? input === "null" ? null : toNumber(input) : void 0;
 const toNumber = (str) => {
 	const value = Number(str);
 	return isNaN(value) ? str : value;

package/lib/internal/_httpFormDataReadNumber.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_httpFormDataReadNumber.mjs","names":[],"sources":["../../src/internal/_httpFormDataReadNumber.ts"],"sourcesContent":["export const _httpFormDataReadNumber = (\n  input: string | File | null,\n): number | null | undefined =>\n  input instanceof File\n    ? (input as any)\n    : !!input?.length\n      ? input === \"null\"\n        ? null\n        : (toNumber(input) as any)\n      : undefined;\n\nconst toNumber = (str: string): number | string => {\n  const value: number = Number(str);\n  return isNaN(value) ? str : value;\n};\n"],"mappings":";AAAA,MAAa,2BACX,UAEA,iBAAiB,OACZ,QACD,CAAC,CAAC,OAAO,SACP,UAAU,SACR,OACC,SAAS,KAAK,IACjB,KAAA;AAER,MAAM,YAAY,QAAiC;CACjD,MAAM,QAAgB,OAAO,GAAG;CAChC,OAAO,MAAM,KAAK,IAAI,MAAM;AAC9B"}
+{"version":3,"file":"_httpFormDataReadNumber.mjs","names":[],"sources":["../../src/internal/_httpFormDataReadNumber.ts"],"sourcesContent":["export const _httpFormDataReadNumber = (\n  input: string | File | null,\n): number | null | undefined =>\n  input instanceof File\n    ? (input as any)\n    : // Blank text is absent, as the empty string always was: `Number(\" \")`\n      // is 0, which would read a whitespace value as a real zero (#2448).\n      typeof input === \"string\" && input.trim().length !== 0\n      ? input === \"null\"\n        ? null\n        : (toNumber(input) as any)\n      : undefined;\n\nconst toNumber = (str: string): number | string => {\n  const value: number = Number(str);\n  return isNaN(value) ? str : value;\n};\n"],"mappings":";AAAA,MAAa,2BACX,UAEA,iBAAiB,OACZ,QAGD,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,WAAW,IACnD,UAAU,SACR,OACC,SAAS,KAAK,IACjB,KAAA;AAER,MAAM,YAAY,QAAiC;CACjD,MAAM,QAAgB,OAAO,GAAG;CAChC,OAAO,MAAM,KAAK,IAAI,MAAM;AAC9B"}

package/lib/internal/_httpFormDataReadString.d.ts

@@ -1 +1,9 @@
-export declare const _httpFormDataReadString: (input: string | File | null) => string | null | undefined;
+/**
+ * Reads one form field as a string.
+ *
+ * The text `"null"` spells `null` only where the property's type admits `null`;
+ * elsewhere it is the string `"null"` (#2450). The emitter passes `false` for a
+ * string whose type does not admit `null` and omits the argument otherwise, so
+ * code emitted before the parameter existed keeps its reading.
+ */
+export declare const _httpFormDataReadString: (input: string | File | null, nullable?: boolean) => string | null | undefined;

package/lib/internal/_httpFormDataReadString.js

@@ -1,11 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._httpFormDataReadString = void 0;
-const _httpFormDataReadString = (input) => input instanceof File
+/**
+ * Reads one form field as a string.
+ *
+ * The text `"null"` spells `null` only where the property's type admits `null`;
+ * elsewhere it is the string `"null"` (#2450). The emitter passes `false` for a
+ * string whose type does not admit `null` and omits the argument otherwise, so
+ * code emitted before the parameter existed keeps its reading.
+ */
+const _httpFormDataReadString = (input, nullable = true) => input instanceof File
     ? input
     : input === null
         ? undefined
-        : input === "null"
+        : nullable === true && input === "null"
             ? null
             : input;
 exports._httpFormDataReadString = _httpFormDataReadString;

package/lib/internal/_httpFormDataReadString.js.map

@@ -1 +1 @@
-{"version":3,"file":"_httpFormDataReadString.js","sourceRoot":"","sources":["../../src/internal/_httpFormDataReadString.ts"],"names":[],"mappings":";;;AAAO,MAAM,uBAAuB,GAAG,CACrC,KAA2B,EACA,EAAE,CAC7B,KAAK,YAAY,IAAI;IACnB,CAAC,CAAE,KAAa;IAChB,CAAC,CAAC,KAAK,KAAK,IAAI;QACd,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK,KAAK,MAAM;YAChB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,KAAK,CAAC;AATH,QAAA,uBAAuB,GAAvB,uBAAuB,CASpB"}
+{"version":3,"file":"_httpFormDataReadString.js","sourceRoot":"","sources":["../../src/internal/_httpFormDataReadString.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACI,MAAM,uBAAuB,GAAG,CACrC,KAA2B,EAC3B,QAAQ,GAAY,IAAI,EACG,EAAE,CAC7B,KAAK,YAAY,IAAI;IACnB,CAAC,CAAE,KAAa;IAChB,CAAC,CAAC,KAAK,KAAK,IAAI;QACd,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM;YACrC,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,KAAK,CAAC;AAVH,QAAA,uBAAuB,GAAvB,uBAAuB,CAUpB"}

package/lib/internal/_httpFormDataReadString.mjs

@@ -1,5 +1,13 @@
 //#region src/internal/_httpFormDataReadString.ts
-const _httpFormDataReadString = (input) => input instanceof File ? input : input === null ? void 0 : input === "null" ? null : input;
+/**
+* Reads one form field as a string.
+*
+* The text `"null"` spells `null` only where the property's type admits `null`;
+* elsewhere it is the string `"null"` (#2450). The emitter passes `false` for a
+* string whose type does not admit `null` and omits the argument otherwise, so
+* code emitted before the parameter existed keeps its reading.
+*/
+const _httpFormDataReadString = (input, nullable = true) => input instanceof File ? input : input === null ? void 0 : nullable === true && input === "null" ? null : input;
 //#endregion
 export { _httpFormDataReadString };
 

package/lib/internal/_httpFormDataReadString.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_httpFormDataReadString.mjs","names":[],"sources":["../../src/internal/_httpFormDataReadString.ts"],"sourcesContent":["export const _httpFormDataReadString = (\n  input: string | File | null,\n): string | null | undefined =>\n  input instanceof File\n    ? (input as any)\n    : input === null\n      ? undefined\n      : input === \"null\"\n        ? null\n        : input;\n"],"mappings":";AAAA,MAAa,2BACX,UAEA,iBAAiB,OACZ,QACD,UAAU,OACR,KAAA,IACA,UAAU,SACR,OACA"}
+{"version":3,"file":"_httpFormDataReadString.mjs","names":[],"sources":["../../src/internal/_httpFormDataReadString.ts"],"sourcesContent":["/**\n * Reads one form field as a string.\n *\n * The text `\"null\"` spells `null` only where the property's type admits `null`;\n * elsewhere it is the string `\"null\"` (#2450). The emitter passes `false` for a\n * string whose type does not admit `null` and omits the argument otherwise, so\n * code emitted before the parameter existed keeps its reading.\n */\nexport const _httpFormDataReadString = (\n  input: string | File | null,\n  nullable: boolean = true,\n): string | null | undefined =>\n  input instanceof File\n    ? (input as any)\n    : input === null\n      ? undefined\n      : nullable === true && input === \"null\"\n        ? null\n        : input;\n"],"mappings":";;;;;;;;;AAQA,MAAa,2BACX,OACA,WAAoB,SAEpB,iBAAiB,OACZ,QACD,UAAU,OACR,KAAA,IACA,aAAa,QAAQ,UAAU,SAC7B,OACA"}

package/lib/internal/_httpHeaderReadBigint.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._httpHeaderReadBigint = void 0;
-const _httpHeaderReadBigint = (value) => value !== undefined ? toBigint(value) : undefined;
+const _httpHeaderReadBigint = (value) => 
+// A blank header, or a blank element of a header list, is absent: `BigInt("")`
+// is 0n, which let validators accept an empty header as a real zero (#2448).
+value !== undefined && isBlank(value) === false ? toBigint(value) : undefined;
 exports._httpHeaderReadBigint = _httpHeaderReadBigint;
+const isBlank = (value) => typeof value === "string" && value.trim().length === 0;
 const toBigint = (str) => {
     try {
         return BigInt(str);

package/lib/internal/_httpHeaderReadBigint.js.map

@@ -1 +1 @@
-{"version":3,"file":"_httpHeaderReadBigint.js","sourceRoot":"","sources":["../../src/internal/_httpHeaderReadBigint.ts"],"names":[],"mappings":";;;AAAO,MAAM,qBAAqB,GAAG,CAAC,KAAyB,EAAE,EAAE,CACjE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AADvC,QAAA,qBAAqB,GAArB,qBAAqB,CACkB;AAEpD,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAmB,EAAE;IAChD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;eAAO,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"_httpHeaderReadBigint.js","sourceRoot":"","sources":["../../src/internal/_httpHeaderReadBigint.ts"],"names":[],"mappings":";;;AAAO,MAAM,qBAAqB,GAAG,CAAC,KAAyB,EAAE,EAAE;AACjE,+EAA+E;AAC/E,6EAA6E;AAC7E,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAHnE,QAAA,qBAAqB,GAArB,qBAAqB,CAG8C;AAEhF,MAAM,OAAO,GAAG,CAAC,KAAa,EAAW,EAAE,CACzC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;AAEzD,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAmB,EAAE;IAChD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;eAAO,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC,CAAC"}

package/lib/internal/_httpHeaderReadBigint.mjs

@@ -1,5 +1,6 @@
 //#region src/internal/_httpHeaderReadBigint.ts
-const _httpHeaderReadBigint = (value) => value !== void 0 ? toBigint(value) : void 0;
+const _httpHeaderReadBigint = (value) => value !== void 0 && isBlank(value) === false ? toBigint(value) : void 0;
+const isBlank = (value) => typeof value === "string" && value.trim().length === 0;
 const toBigint = (str) => {
 	try {
 		return BigInt(str);