npm - typia - Versions diffs - 15.0.0 → 15.1.0 - Mend

typia 15.0.0 → 15.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1330) hide show

package/lib/functional.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"functional.mjs","names":[],"sources":["../src/functional.ts"],"sourcesContent":["import { IValidation } from \"@typia/interface\";\n\nimport { TypeGuardError } from \"./TypeGuardError\";\nimport { NoTransformConfigurationError } from \"./transformers/NoTransformConfigurationError\";\n\ntype FunctionalIs<T extends (...args: any[]) => any> = T extends (\n this: infer This,\n ...args: infer Arguments\n) => infer Output\n ? Output extends Promise<infer R>\n ? (this: This, ...args: Arguments) => Promise<R \| null>\n : (this: This, ...args: Arguments) => Output \| null\n : never;\n\ntype FunctionalValidate<T extends (...args: any[]) => any> = T extends (\n this: infer This,\n ...args: infer Arguments\n) => infer Output\n ? Output extends Promise<infer R>\n ? (this: This, ...args: Arguments) => Promise<IValidation<R>>\n : (this: This, ...args: Arguments) => IValidation<Output>\n : never;\n\n/* ===========================================================\n FUNCTIONAL\n - ASSERT\n - IS\n - VALIDATE\n==============================================================\n ASSERT\n----------------------------------------------------------- /\n/\n Wraps function to assert both parameters and return value.\n \n Wraps the target function and validates all parameters before calling and\n * return value after calling through {@link assert}. Throws on first mismatch.\n \n Error path format:\n \n - Parameter errors: `$input.parameters[0].property`\n * - Return errors: `$input.return.property`\n \n Related functions:\n \n - {@link assertParameters} — Validates parameters only\n * - {@link assertReturn} — Validates return value only\n * - {@link validateFunction} — Collects all errors instead of throwing\n * - {@link assertEqualsFunction} — Also rejects extra properties\n \n @template T Target function type\n * @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n * @returns Wrapped function with same signature\n * @throws {TypeGuardError} When parameter or return value type mismatch\n /\nexport function assertFunction<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertFunction(): never {\n NoTransformConfigurationError(\"functional.assertFunction\");\n}\n\n/\n Wraps function to assert parameters only.\n \n Wraps the target function and validates all parameters before calling through\n * {@link assert}. Return value is not validated. Throws on first mismatch.\n \n Error path format: `$input.parameters[0].property`\n \n Related functions:\n \n - {@link assertFunction} — Also validates return value\n * - {@link assertReturn} — Validates return value only\n * - {@link validateParameters} — Collects all errors instead of throwing\n * - {@link assertEqualsParameters} — Also rejects extra properties\n \n @template T Target function type\n * @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n * @returns Wrapped function with same signature\n * @throws {TypeGuardError} When parameter type mismatch\n /\nexport function assertParameters<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertParameters(): never {\n NoTransformConfigurationError(\"functional.assertParameters\");\n}\n\n/\n Wraps function to assert return value only.\n \n Wraps the target function and validates return value after calling through\n * {@link assert}. Parameters are not validated. Throws on mismatch.\n \n Error path format: `$input.return.property`\n \n Related functions:\n \n - {@link assertFunction} — Also validates parameters\n * - {@link assertParameters} — Validates parameters only\n * - {@link validateReturn} — Collects all errors instead of throwing\n * - {@link assertEqualsReturn} — Also rejects extra properties\n \n @template T Target function type\n * @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n * @returns Wrapped function with same signature\n * @throws {TypeGuardError} When return value type mismatch\n /\nexport function assertReturn<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertReturn(): never {\n NoTransformConfigurationError(\"functional.assertReturn\");\n}\n\n/\n Wraps function to assert parameters and return value with strict equality.\n \n Wraps the target function and validates through {@link assertEquals}. Also\n * rejects extra properties not defined in type. Throws on first mismatch.\n \n Error path format:\n \n - Parameter errors: `$input.parameters[0].property`\n * - Return errors: `$input.return.property`\n \n Related functions:\n \n - {@link assertFunction} — Allows extra properties\n * - {@link assertEqualsParameters} — Validates parameters only\n * - {@link assertEqualsReturn} — Validates return value only\n * - {@link validateEqualsFunction} — Collects all errors instead of throwing\n \n @template T Target function type\n * @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n * @returns Wrapped function with same signature\n * @throws {TypeGuardError} When type mismatch or extra property detected\n /\nexport function assertEqualsFunction<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertEqualsFunction(): never {\n NoTransformConfigurationError(\"functional.assertEqualsFunction\");\n}\n\n/\n Wraps function to assert parameters with strict equality.\n \n Wraps the target function and validates parameters through\n * {@link assertEquals}. Also rejects extra properties. Return value is not\n * validated.\n \n Error path format: `$input.parameters[0].property`\n \n Related functions:\n \n - {@link assertParameters} — Allows extra properties\n * - {@link assertEqualsFunction} — Also validates return value\n * - {@link validateEqualsParameters} — Collects all errors instead of throwing\n \n @template T Target function type\n * @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n * @returns Wrapped function with same signature\n * @throws {TypeGuardError} When type mismatch or extra property detected\n /\nexport function assertEqualsParameters<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertEqualsParameters(): never {\n NoTransformConfigurationError(\"functional.assertEqualsParameters\");\n}\n\n/\n Wraps function to assert return value with strict equality.\n \n Wraps the target function and validates return value through\n * {@link assertEquals}. Also rejects extra properties. Parameters are not\n * validated.\n \n Error path format: `$input.return.property`\n \n Related functions:\n \n - {@link assertReturn} — Allows extra properties\n * - {@link assertEqualsFunction} — Also validates parameters\n * - {@link validateEqualsReturn} — Collects all errors instead of throwing\n \n @template T Target function type\n * @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n * @returns Wrapped function with same signature\n * @throws {TypeGuardError} When type mismatch or extra property detected\n /\nexport function assertEqualsReturn<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertEqualsReturn(): never {\n NoTransformConfigurationError(\"functional.assertEqualsReturn\");\n}\n\n/ -----------------------------------------------------------\n IS\n----------------------------------------------------------- /\n/\n Wraps function to test both parameters and return value.\n \n Wraps the target function and checks all parameters before calling and return\n * value after calling through {@link is}. Returns `null` on mismatch.\n \n Related functions:\n \n - {@link isParameters} — Tests parameters only\n * - {@link isReturn} — Tests return value only\n * - {@link assertFunction} — Throws with error details on mismatch\n * - {@link validateFunction} — Returns all error details\n * - {@link equalsFunction} — Also rejects extra properties\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning `Output \| null`\n /\nexport function isFunction<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function isFunction(): never {\n NoTransformConfigurationError(\"functional.isFunction\");\n}\n\n/\n Wraps function to test parameters only.\n \n Wraps the target function and checks all parameters before calling through\n * {@link is}. Return value is not checked. Returns `null` on mismatch.\n \n Related functions:\n \n - {@link isFunction} — Also tests return value\n * - {@link isReturn} — Tests return value only\n * - {@link assertParameters} — Throws with error details\n * - {@link validateParameters} — Returns all error details\n * - {@link equalsParameters} — Also rejects extra properties\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning `Output \| null`\n /\nexport function isParameters<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function isParameters(): never {\n NoTransformConfigurationError(\"functional.isParameters\");\n}\n\n/\n Wraps function to test return value only.\n \n Wraps the target function and checks return value after calling through\n * {@link is}. Parameters are not checked. Returns `null` on mismatch.\n \n Related functions:\n \n - {@link isFunction} — Also tests parameters\n * - {@link isParameters} — Tests parameters only\n * - {@link assertReturn} — Throws with error details\n * - {@link validateReturn} — Returns all error details\n * - {@link equalsReturn} — Also rejects extra properties\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning `Output \| null`\n /\nexport function isReturn<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function isReturn(): never {\n NoTransformConfigurationError(\"functional.isReturn\");\n}\n\n/\n Wraps function to test parameters and return value with strict equality.\n \n Wraps the target function and checks through {@link equals}. Also rejects\n * extra properties not defined in type. Returns `null` on mismatch.\n \n Related functions:\n \n - {@link isFunction} — Allows extra properties\n * - {@link equalsParameters} — Tests parameters only\n * - {@link equalsReturn} — Tests return value only\n * - {@link assertEqualsFunction} — Throws with error details\n * - {@link validateEqualsFunction} — Returns all error details\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning `Output \| null`\n /\nexport function equalsFunction<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function equalsFunction(): never {\n NoTransformConfigurationError(\"functional.equalsFunction\");\n}\n\n/\n Wraps function to test parameters with strict equality.\n \n Wraps the target function and checks parameters through {@link equals}. Also\n * rejects extra properties. Return value is not checked.\n \n Related functions:\n \n - {@link isParameters} — Allows extra properties\n * - {@link equalsFunction} — Also tests return value\n * - {@link equalsReturn} — Tests return value only\n * - {@link assertEqualsParameters} — Throws with error details\n * - {@link validateEqualsParameters} — Returns all error details\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning `Output \| null`\n /\nexport function equalsParameters<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function equalsParameters(): never {\n NoTransformConfigurationError(\"functional.equalsParameters\");\n}\n\n/\n Wraps function to test return value with strict equality.\n \n Wraps the target function and checks return value through {@link equals}. Also\n * rejects extra properties. Parameters are not checked.\n \n Related functions:\n \n - {@link isReturn} — Allows extra properties\n * - {@link equalsFunction} — Also tests parameters\n * - {@link equalsParameters} — Tests parameters only\n * - {@link assertEqualsReturn} — Throws with error details\n * - {@link validateEqualsReturn} — Returns all error details\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning `Output \| null`\n /\nexport function equalsReturn<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function equalsReturn(): never {\n NoTransformConfigurationError(\"functional.equalsReturn\");\n}\n\n/ -----------------------------------------------------------\n VALIDATE\n----------------------------------------------------------- /\n/\n Wraps function to validate both parameters and return value.\n \n Wraps the target function and validates all parameters before calling and\n * return value after calling through {@link validate}. Collects all errors.\n \n Error path format:\n \n - Parameter errors: `$input.parameters[0].property`\n * - Return errors: `$input.return.property`\n \n Related functions:\n \n - {@link validateParameters} — Validates parameters only\n * - {@link validateReturn} — Validates return value only\n * - {@link assertFunction} — Throws on first error\n * - {@link validateEqualsFunction} — Also rejects extra properties\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning {@link IValidation}\n /\nexport function validateFunction<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal /\nexport function validateFunction(): never {\n NoTransformConfigurationError(\"functional.validateFunction\");\n}\n\n/\n Wraps function to validate parameters only.\n \n Wraps the target function and validates all parameters before calling through\n * {@link validate}. Return value is not validated. Collects all errors.\n \n Error path format: `$input.parameters[0].property`\n \n Related functions:\n \n - {@link validateFunction} — Also validates return value\n * - {@link validateReturn} — Validates return value only\n * - {@link assertParameters} — Throws on first error\n * - {@link validateEqualsParameters} — Also rejects extra properties\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning {@link IValidation}\n /\nexport function validateParameters<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal /\nexport function validateParameters(): never {\n NoTransformConfigurationError(\"functional.validateParameters\");\n}\n\n/\n Wraps function to validate return value only.\n \n Wraps the target function and validates return value after calling through\n * {@link validate}. Parameters are not validated. Collects all errors.\n \n Error path format: `$input.return.property`\n \n Related functions:\n \n - {@link validateFunction} — Also validates parameters\n * - {@link validateParameters} — Validates parameters only\n * - {@link assertReturn} — Throws on first error\n * - {@link validateEqualsReturn} — Also rejects extra properties\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning {@link IValidation}\n /\nexport function validateReturn<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal /\nexport function validateReturn(): never {\n NoTransformConfigurationError(\"functional.validateReturn\");\n}\n\n/\n Wraps function to validate parameters and return value with strict equality.\n \n Wraps the target function and validates through {@link validateEquals}. Also\n * rejects extra properties not defined in type. Collects all errors.\n \n Error path format:\n \n - Parameter errors: `$input.parameters[0].property`\n * - Return errors: `$input.return.property`\n \n Related functions:\n \n - {@link validateFunction} — Allows extra properties\n * - {@link validateEqualsParameters} — Validates parameters only\n * - {@link validateEqualsReturn} — Validates return value only\n * - {@link assertEqualsFunction} — Throws on first error\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning {@link IValidation}\n /\nexport function validateEqualsFunction<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal /\nexport function validateEqualsFunction(): never {\n NoTransformConfigurationError(\"functional.validateEqualsFunction\");\n}\n\n/\n Wraps function to validate parameters with strict equality.\n \n Wraps the target function and validates parameters through\n * {@link validateEquals}. Also rejects extra properties. Return value is not\n * validated.\n \n Error path format: `$input.parameters[0].property`\n \n Related functions:\n \n - {@link validateParameters} — Allows extra properties\n * - {@link validateEqualsFunction} — Also validates return value\n * - {@link assertEqualsParameters} — Throws on first error\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning {@link IValidation}\n /\nexport function validateEqualsParameters<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal /\nexport function validateEqualsParameters(): never {\n NoTransformConfigurationError(\"functional.validateEqualsParameters\");\n}\n\n/\n Wraps function to validate return value with strict equality.\n \n Wraps the target function and validates return value through\n * {@link validateEquals}. Also rejects extra properties. Parameters are not\n * validated.\n \n Error path format: `$input.return.property`\n \n Related functions:\n \n - {@link validateReturn} — Allows extra properties\n * - {@link validateEqualsFunction} — Also validates parameters\n * - {@link assertEqualsReturn} — Throws on first error\n \n @template T Target function type\n * @param func Function to wrap\n * @returns Wrapped function returning {@link IValidation}\n /\nexport function validateEqualsReturn<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal */\nexport function validateEqualsReturn(): never {\n NoTransformConfigurationError(\"functional.validateEqualsReturn\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA8DA,SAAgB,iBAAwB;CACtC,8BAA8B,2BAA2B;AAC3D;;AA8BA,SAAgB,mBAA0B;CACxC,8BAA8B,6BAA6B;AAC7D;;AA8BA,SAAgB,eAAsB;CACpC,8BAA8B,yBAAyB;AACzD;;AAiCA,SAAgB,uBAA8B;CAC5C,8BAA8B,iCAAiC;AACjE;;AA8BA,SAAgB,yBAAgC;CAC9C,8BAA8B,mCAAmC;AACnE;;AA8BA,SAAgB,qBAA4B;CAC1C,8BAA8B,+BAA+B;AAC/D;;AA4BA,SAAgB,aAAoB;CAClC,8BAA8B,uBAAuB;AACvD;;AAyBA,SAAgB,eAAsB;CACpC,8BAA8B,yBAAyB;AACzD;;AAyBA,SAAgB,WAAkB;CAChC,8BAA8B,qBAAqB;AACrD;;AAyBA,SAAgB,iBAAwB;CACtC,8BAA8B,2BAA2B;AAC3D;;AAyBA,SAAgB,mBAA0B;CACxC,8BAA8B,6BAA6B;AAC7D;;AAyBA,SAAgB,eAAsB;CACpC,8BAA8B,yBAAyB;AACzD;;AAgCA,SAAgB,mBAA0B;CACxC,8BAA8B,6BAA6B;AAC7D;;AA0BA,SAAgB,qBAA4B;CAC1C,8BAA8B,+BAA+B;AAC/D;;AA0BA,SAAgB,iBAAwB;CACtC,8BAA8B,2BAA2B;AAC3D;;AA6BA,SAAgB,yBAAgC;CAC9C,8BAA8B,mCAAmC;AACnE;;AA0BA,SAAgB,2BAAkC;CAChD,8BAA8B,qCAAqC;AACrE;;AA0BA,SAAgB,uBAA8B;CAC5C,8BAA8B,iCAAiC;AACjE"}
1	+ {"version":3,"file":"functional.mjs","names":[],"sources":["../src/functional.ts"],"sourcesContent":["import { IValidation } from \"@typia/interface\";\n\nimport { TypeGuardError } from \"./TypeGuardError\";\nimport { NoTransformConfigurationError } from \"./transformers/NoTransformConfigurationError\";\n\ntype FunctionalIs<T extends (...args: any[]) => any> = T extends (\n this: infer This,\n ...args: infer Arguments\n) => infer Output\n ? Output extends Promise<infer R>\n ? (this: This, ...args: Arguments) => Promise<R \| null>\n : (this: This, ...args: Arguments) => Output \| null\n : never;\n\ntype FunctionalValidate<T extends (...args: any[]) => any> = T extends (\n this: infer This,\n ...args: infer Arguments\n) => infer Output\n ? Output extends Promise<infer R>\n ? (this: This, ...args: Arguments) => Promise<IValidation<R>>\n : (this: This, ...args: Arguments) => IValidation<Output>\n : never;\n\n/* ===========================================================\n FUNCTIONAL\n - ASSERT\n - IS\n - VALIDATE\n==============================================================\n ASSERT\n----------------------------------------------------------- /\n/\n Wraps function to assert both parameters and return value.\n \n Wraps the target function and validates all parameters before calling and\n * return value after calling through {@link assert}. Throws on first mismatch.\n \n Error path format:\n \n - Parameter errors: `$input.parameters[0].property`\n * - Return errors: `$input.return.property`\n \n Related functions:\n \n - {@link assertParameters} — Validates parameters only\n * - {@link assertReturn} — Validates return value only\n * - {@link validateFunction} — Collects all errors instead of throwing\n * - {@link assertEqualsFunction} — Also rejects extra properties\n \n @template T Target function type\n \n @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n \n @returns Wrapped function with same signature\n \n @throws {TypeGuardError} When parameter or return value type mismatch\n /\nexport function assertFunction<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertFunction(): never {\n NoTransformConfigurationError(\"functional.assertFunction\");\n}\n\n/\n Wraps function to assert parameters only.\n \n Wraps the target function and validates all parameters before calling through\n * {@link assert}. Return value is not validated. Throws on first mismatch.\n \n Error path format: `$input.parameters[0].property`\n \n Related functions:\n \n - {@link assertFunction} — Also validates return value\n * - {@link assertReturn} — Validates return value only\n * - {@link validateParameters} — Collects all errors instead of throwing\n * - {@link assertEqualsParameters} — Also rejects extra properties\n \n @template T Target function type\n \n @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n \n @returns Wrapped function with same signature\n \n @throws {TypeGuardError} When parameter type mismatch\n /\nexport function assertParameters<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertParameters(): never {\n NoTransformConfigurationError(\"functional.assertParameters\");\n}\n\n/\n Wraps function to assert return value only.\n \n Wraps the target function and validates return value after calling through\n * {@link assert}. Parameters are not validated. Throws on mismatch.\n \n Error path format: `$input.return.property`\n \n Related functions:\n \n - {@link assertFunction} — Also validates parameters\n * - {@link assertParameters} — Validates parameters only\n * - {@link validateReturn} — Collects all errors instead of throwing\n * - {@link assertEqualsReturn} — Also rejects extra properties\n \n @template T Target function type\n \n @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n \n @returns Wrapped function with same signature\n \n @throws {TypeGuardError} When return value type mismatch\n /\nexport function assertReturn<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertReturn(): never {\n NoTransformConfigurationError(\"functional.assertReturn\");\n}\n\n/\n Wraps function to assert parameters and return value with strict equality.\n \n Wraps the target function and validates through {@link assertEquals}. Also\n * rejects extra properties not defined in type. Throws on first mismatch.\n \n Error path format:\n \n - Parameter errors: `$input.parameters[0].property`\n * - Return errors: `$input.return.property`\n \n Related functions:\n \n - {@link assertFunction} — Allows extra properties\n * - {@link assertEqualsParameters} — Validates parameters only\n * - {@link assertEqualsReturn} — Validates return value only\n * - {@link validateEqualsFunction} — Collects all errors instead of throwing\n \n @template T Target function type\n \n @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n \n @returns Wrapped function with same signature\n \n @throws {TypeGuardError} When type mismatch or extra property detected\n /\nexport function assertEqualsFunction<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertEqualsFunction(): never {\n NoTransformConfigurationError(\"functional.assertEqualsFunction\");\n}\n\n/\n Wraps function to assert parameters with strict equality.\n \n Wraps the target function and validates parameters through\n * {@link assertEquals}. Also rejects extra properties. Return value is not\n * validated.\n \n Error path format: `$input.parameters[0].property`\n \n Related functions:\n \n - {@link assertParameters} — Allows extra properties\n * - {@link assertEqualsFunction} — Also validates return value\n * - {@link validateEqualsParameters} — Collects all errors instead of throwing\n \n @template T Target function type\n \n @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n \n @returns Wrapped function with same signature\n \n @throws {TypeGuardError} When type mismatch or extra property detected\n /\nexport function assertEqualsParameters<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertEqualsParameters(): never {\n NoTransformConfigurationError(\"functional.assertEqualsParameters\");\n}\n\n/\n Wraps function to assert return value with strict equality.\n \n Wraps the target function and validates return value through\n * {@link assertEquals}. Also rejects extra properties. Parameters are not\n * validated.\n \n Error path format: `$input.return.property`\n \n Related functions:\n \n - {@link assertReturn} — Allows extra properties\n * - {@link assertEqualsFunction} — Also validates parameters\n * - {@link validateEqualsReturn} — Collects all errors instead of throwing\n \n @template T Target function type\n \n @param func Function to wrap\n * @param errorFactory Custom error factory receiving\n * {@link TypeGuardError.IProps}\n \n @returns Wrapped function with same signature\n \n @throws {TypeGuardError} When type mismatch or extra property detected\n /\nexport function assertEqualsReturn<T extends (...args: any[]) => any>(\n func: T,\n errorFactory?: undefined \| ((props: TypeGuardError.IProps) => Error),\n): T;\n\n/* @internal /\nexport function assertEqualsReturn(): never {\n NoTransformConfigurationError(\"functional.assertEqualsReturn\");\n}\n\n/ -----------------------------------------------------------\n IS\n----------------------------------------------------------- /\n/\n Wraps function to test both parameters and return value.\n \n Wraps the target function and checks all parameters before calling and return\n * value after calling through {@link is}. Returns `null` on mismatch.\n \n Related functions:\n \n - {@link isParameters} — Tests parameters only\n * - {@link isReturn} — Tests return value only\n * - {@link assertFunction} — Throws with error details on mismatch\n * - {@link validateFunction} — Returns all error details\n * - {@link equalsFunction} — Also rejects extra properties\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning `Output \| null`\n /\nexport function isFunction<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function isFunction(): never {\n NoTransformConfigurationError(\"functional.isFunction\");\n}\n\n/\n Wraps function to test parameters only.\n \n Wraps the target function and checks all parameters before calling through\n * {@link is}. Return value is not checked. Returns `null` on mismatch.\n \n Related functions:\n \n - {@link isFunction} — Also tests return value\n * - {@link isReturn} — Tests return value only\n * - {@link assertParameters} — Throws with error details\n * - {@link validateParameters} — Returns all error details\n * - {@link equalsParameters} — Also rejects extra properties\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning `Output \| null`\n /\nexport function isParameters<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function isParameters(): never {\n NoTransformConfigurationError(\"functional.isParameters\");\n}\n\n/\n Wraps function to test return value only.\n \n Wraps the target function and checks return value after calling through\n * {@link is}. Parameters are not checked. Returns `null` on mismatch.\n \n Related functions:\n \n - {@link isFunction} — Also tests parameters\n * - {@link isParameters} — Tests parameters only\n * - {@link assertReturn} — Throws with error details\n * - {@link validateReturn} — Returns all error details\n * - {@link equalsReturn} — Also rejects extra properties\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning `Output \| null`\n /\nexport function isReturn<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function isReturn(): never {\n NoTransformConfigurationError(\"functional.isReturn\");\n}\n\n/\n Wraps function to test parameters and return value with strict equality.\n \n Wraps the target function and checks through {@link equals}. Also rejects\n * extra properties not defined in type. Returns `null` on mismatch.\n \n Related functions:\n \n - {@link isFunction} — Allows extra properties\n * - {@link equalsParameters} — Tests parameters only\n * - {@link equalsReturn} — Tests return value only\n * - {@link assertEqualsFunction} — Throws with error details\n * - {@link validateEqualsFunction} — Returns all error details\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning `Output \| null`\n /\nexport function equalsFunction<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function equalsFunction(): never {\n NoTransformConfigurationError(\"functional.equalsFunction\");\n}\n\n/\n Wraps function to test parameters with strict equality.\n \n Wraps the target function and checks parameters through {@link equals}. Also\n * rejects extra properties. Return value is not checked.\n \n Related functions:\n \n - {@link isParameters} — Allows extra properties\n * - {@link equalsFunction} — Also tests return value\n * - {@link equalsReturn} — Tests return value only\n * - {@link assertEqualsParameters} — Throws with error details\n * - {@link validateEqualsParameters} — Returns all error details\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning `Output \| null`\n /\nexport function equalsParameters<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function equalsParameters(): never {\n NoTransformConfigurationError(\"functional.equalsParameters\");\n}\n\n/\n Wraps function to test return value with strict equality.\n \n Wraps the target function and checks return value through {@link equals}. Also\n * rejects extra properties. Parameters are not checked.\n \n Related functions:\n \n - {@link isReturn} — Allows extra properties\n * - {@link equalsFunction} — Also tests parameters\n * - {@link equalsParameters} — Tests parameters only\n * - {@link assertEqualsReturn} — Throws with error details\n * - {@link validateEqualsReturn} — Returns all error details\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning `Output \| null`\n /\nexport function equalsReturn<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalIs<T>;\n\n/* @internal /\nexport function equalsReturn(): never {\n NoTransformConfigurationError(\"functional.equalsReturn\");\n}\n\n/ -----------------------------------------------------------\n VALIDATE\n----------------------------------------------------------- /\n/\n Wraps function to validate both parameters and return value.\n \n Wraps the target function and validates all parameters before calling and\n * return value after calling through {@link validate}. Collects all errors.\n \n Error path format:\n \n - Parameter errors: `$input.parameters[0].property`\n * - Return errors: `$input.return.property`\n \n Related functions:\n \n - {@link validateParameters} — Validates parameters only\n * - {@link validateReturn} — Validates return value only\n * - {@link assertFunction} — Throws on first error\n * - {@link validateEqualsFunction} — Also rejects extra properties\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning {@link IValidation}\n /\nexport function validateFunction<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal /\nexport function validateFunction(): never {\n NoTransformConfigurationError(\"functional.validateFunction\");\n}\n\n/\n Wraps function to validate parameters only.\n \n Wraps the target function and validates all parameters before calling through\n * {@link validate}. Return value is not validated. Collects all errors.\n \n Error path format: `$input.parameters[0].property`\n \n Related functions:\n \n - {@link validateFunction} — Also validates return value\n * - {@link validateReturn} — Validates return value only\n * - {@link assertParameters} — Throws on first error\n * - {@link validateEqualsParameters} — Also rejects extra properties\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning {@link IValidation}\n /\nexport function validateParameters<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal /\nexport function validateParameters(): never {\n NoTransformConfigurationError(\"functional.validateParameters\");\n}\n\n/\n Wraps function to validate return value only.\n \n Wraps the target function and validates return value after calling through\n * {@link validate}. Parameters are not validated. Collects all errors.\n \n Error path format: `$input.return.property`\n \n Related functions:\n \n - {@link validateFunction} — Also validates parameters\n * - {@link validateParameters} — Validates parameters only\n * - {@link assertReturn} — Throws on first error\n * - {@link validateEqualsReturn} — Also rejects extra properties\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning {@link IValidation}\n /\nexport function validateReturn<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal /\nexport function validateReturn(): never {\n NoTransformConfigurationError(\"functional.validateReturn\");\n}\n\n/\n Wraps function to validate parameters and return value with strict equality.\n \n Wraps the target function and validates through {@link validateEquals}. Also\n * rejects extra properties not defined in type. Collects all errors.\n \n Error path format:\n \n - Parameter errors: `$input.parameters[0].property`\n * - Return errors: `$input.return.property`\n \n Related functions:\n \n - {@link validateFunction} — Allows extra properties\n * - {@link validateEqualsParameters} — Validates parameters only\n * - {@link validateEqualsReturn} — Validates return value only\n * - {@link assertEqualsFunction} — Throws on first error\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning {@link IValidation}\n /\nexport function validateEqualsFunction<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal /\nexport function validateEqualsFunction(): never {\n NoTransformConfigurationError(\"functional.validateEqualsFunction\");\n}\n\n/\n Wraps function to validate parameters with strict equality.\n \n Wraps the target function and validates parameters through\n * {@link validateEquals}. Also rejects extra properties. Return value is not\n * validated.\n \n Error path format: `$input.parameters[0].property`\n \n Related functions:\n \n - {@link validateParameters} — Allows extra properties\n * - {@link validateEqualsFunction} — Also validates return value\n * - {@link assertEqualsParameters} — Throws on first error\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning {@link IValidation}\n /\nexport function validateEqualsParameters<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal /\nexport function validateEqualsParameters(): never {\n NoTransformConfigurationError(\"functional.validateEqualsParameters\");\n}\n\n/\n Wraps function to validate return value with strict equality.\n \n Wraps the target function and validates return value through\n * {@link validateEquals}. Also rejects extra properties. Parameters are not\n * validated.\n \n Error path format: `$input.return.property`\n \n Related functions:\n \n - {@link validateReturn} — Allows extra properties\n * - {@link validateEqualsFunction} — Also validates parameters\n * - {@link assertEqualsReturn} — Throws on first error\n \n @template T Target function type\n \n @param func Function to wrap\n \n @returns Wrapped function returning {@link IValidation}\n /\nexport function validateEqualsReturn<T extends (...args: any[]) => any>(\n func: T,\n): FunctionalValidate<T>;\n\n/* @internal */\nexport function validateEqualsReturn(): never {\n NoTransformConfigurationError(\"functional.validateEqualsReturn\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAiEA,SAAgB,iBAAwB;CACtC,8BAA8B,2BAA2B;AAC3D;;AAiCA,SAAgB,mBAA0B;CACxC,8BAA8B,6BAA6B;AAC7D;;AAiCA,SAAgB,eAAsB;CACpC,8BAA8B,yBAAyB;AACzD;;AAoCA,SAAgB,uBAA8B;CAC5C,8BAA8B,iCAAiC;AACjE;;AAiCA,SAAgB,yBAAgC;CAC9C,8BAA8B,mCAAmC;AACnE;;AAiCA,SAAgB,qBAA4B;CAC1C,8BAA8B,+BAA+B;AAC/D;;AA8BA,SAAgB,aAAoB;CAClC,8BAA8B,uBAAuB;AACvD;;AA2BA,SAAgB,eAAsB;CACpC,8BAA8B,yBAAyB;AACzD;;AA2BA,SAAgB,WAAkB;CAChC,8BAA8B,qBAAqB;AACrD;;AA2BA,SAAgB,iBAAwB;CACtC,8BAA8B,2BAA2B;AAC3D;;AA2BA,SAAgB,mBAA0B;CACxC,8BAA8B,6BAA6B;AAC7D;;AA2BA,SAAgB,eAAsB;CACpC,8BAA8B,yBAAyB;AACzD;;AAkCA,SAAgB,mBAA0B;CACxC,8BAA8B,6BAA6B;AAC7D;;AA4BA,SAAgB,qBAA4B;CAC1C,8BAA8B,+BAA+B;AAC/D;;AA4BA,SAAgB,iBAAwB;CACtC,8BAA8B,2BAA2B;AAC3D;;AA+BA,SAAgB,yBAAgC;CAC9C,8BAA8B,mCAAmC;AACnE;;AA4BA,SAAgB,2BAAkC;CAChD,8BAA8B,qCAAqC;AACrE;;AA4BA,SAAgB,uBAA8B;CAC5C,8BAA8B,iCAAiC;AACjE"}

package/lib/http.d.ts CHANGED Viewed

@@ -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
@@ -21,8 +29,11 @@ import { TypeGuardError } from "./TypeGuardError";
  * - {@link validateFormData} — Returns detailed validation errors
  *
  * @template T Target object type
+ *
  * @param input FormData instance to decode
+ *
  * @returns Decoded object of type `T`
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function formData<T extends object>(input: FormData): Resolved<T>;
@@ -47,11 +58,15 @@ export declare function formData<T extends object>(input: FormData): Resolved<T>
  * - {@link validateFormData} — Returns detailed validation errors
  *
  * @template T Target object type
+ *
  * @param input FormData instance to decode
  * @param errorFactory Custom error factory receiving
  *   {@link TypeGuardError.IProps}
+ *
  * @returns Decoded object of type `T`
+ *
  * @throws {TypeGuardError} When decoded value doesn't conform to type `T`
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function assertFormData<T extends object>(input: FormData, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): Resolved<T>;
@@ -76,8 +91,11 @@ export declare function assertFormData<T extends object>(input: FormData, errorF
  * - {@link validateFormData} — Returns detailed validation errors
  *
  * @template T Target object type
+ *
  * @param input FormData instance to decode
+ *
  * @returns Decoded object of type `T`, or `null` if invalid
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function isFormData<T extends object>(input: FormData): Resolved<T> | null;
@@ -103,8 +121,11 @@ export declare function isFormData<T extends object>(input: FormData): Resolved<
  * - {@link isFormData} — Returns `null` instead of error details
  *
  * @template T Target object type
+ *
  * @param input FormData instance to decode
+ *
  * @returns Validation result containing decoded value or errors
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function validateFormData<T extends object>(input: FormData): IValidation<Resolved<T>>;
@@ -112,8 +133,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 +143,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
@@ -129,8 +156,11 @@ export declare function validateFormData<T extends object>(input: FormData): IVa
  * - {@link validateQuery} — Returns detailed validation errors
  *
  * @template T Target object type
+ *
  * @param input Query string or URLSearchParams instance
+ *
  * @returns Decoded object of type `T`
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function query<T extends object>(input: string | IReadableURLSearchParams): Resolved<T>;
@@ -155,11 +185,15 @@ export declare function query<T extends object>(input: string | IReadableURLSear
  * - {@link validateQuery} — Returns detailed validation errors
  *
  * @template T Target object type
+ *
  * @param input Query string or URLSearchParams instance
  * @param errorFactory Custom error factory receiving
  *   {@link TypeGuardError.IProps}
+ *
  * @returns Decoded object of type `T`
+ *
  * @throws {TypeGuardError} When decoded value doesn't conform to type `T`
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function assertQuery<T extends object>(input: string | IReadableURLSearchParams, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): Resolved<T>;
@@ -184,8 +218,11 @@ export declare function assertQuery<T extends object>(input: string | IReadableU
  * - {@link validateQuery} — Returns detailed validation errors
  *
  * @template T Target object type
+ *
  * @param input Query string or URLSearchParams instance
+ *
  * @returns Decoded object of type `T`, or `null` if invalid
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function isQuery<T extends object>(input: string | IReadableURLSearchParams): Resolved<T> | null;
@@ -211,8 +248,11 @@ export declare function isQuery<T extends object>(input: string | IReadableURLSe
  * - {@link isQuery} — Returns `null` instead of error details
  *
  * @template T Target object type
+ *
  * @param input Query string or URLSearchParams instance
+ *
  * @returns Validation result containing decoded value or errors
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function validateQuery<T extends object>(input: string | IReadableURLSearchParams): IValidation<Resolved<T>>;
@@ -220,14 +260,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 +279,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
@@ -245,8 +290,11 @@ export declare function validateQuery<T extends object>(input: string | IReadabl
  * - {@link validateHeaders} — Returns detailed validation errors
  *
  * @template T Target object type
+ *
  * @param input Headers object from HTTP request
+ *
  * @returns Decoded object of type `T`
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function headers<T extends object>(input: Record<string, string | string[] | undefined>): Resolved<T>;
@@ -261,7 +309,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
@@ -279,11 +328,15 @@ export declare function headers<T extends object>(input: Record<string, string |
  * - {@link validateHeaders} — Returns detailed validation errors
  *
  * @template T Target object type
+ *
  * @param input Headers object from HTTP request
  * @param errorFactory Custom error factory receiving
  *   {@link TypeGuardError.IProps}
+ *
  * @returns Decoded object of type `T`
+ *
  * @throws {TypeGuardError} When decoded value doesn't conform to type `T`
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function assertHeaders<T extends object>(input: Record<string, string | string[] | undefined>, errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): Resolved<T>;
@@ -298,7 +351,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
@@ -316,8 +370,11 @@ export declare function assertHeaders<T extends object>(input: Record<string, st
  * - {@link validateHeaders} — Returns detailed validation errors
  *
  * @template T Target object type
+ *
  * @param input Headers object from HTTP request
+ *
  * @returns Decoded object of type `T`, or `null` if invalid
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function isHeaders<T extends object>(input: Record<string, string | string[] | undefined>): Resolved<T> | null;
@@ -333,7 +390,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
@@ -351,8 +409,11 @@ export declare function isHeaders<T extends object>(input: Record<string, string
  * - {@link isHeaders} — Returns `null` instead of error details
  *
  * @template T Target object type
+ *
  * @param input Headers object from HTTP request
+ *
  * @returns Validation result containing decoded value or errors
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function validateHeaders<T extends object>(input: Record<string, string | string[] | undefined>): IValidation<Resolved<T>>;
@@ -360,15 +421,22 @@ 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`, or `string`),
+ *   optionally with `null`
  *
- * @template T Target atomic type (`boolean`, `bigint`, `number`, `string`, or
- *   `null`)
  * @param input Path parameter string
+ *
  * @returns Decoded value of type `T`
+ *
  * @throws {TypeGuardError} When decoded value doesn't conform to type `T`
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function parameter<T extends Atomic.Type | null>(input: string): Resolved<T>;
@@ -376,6 +444,7 @@ export declare function parameter<T extends Atomic.Type | null>(input: string):
  * Creates reusable {@link formData} function.
  *
  * @template T Target object type
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createFormData(): never;
@@ -383,15 +452,18 @@ export declare function createFormData(): never;
  * Creates reusable {@link formData} function.
  *
  * @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.
  *
  * @template T Target object type
+ *
  * @param errorFactory Custom error factory receiving
  *   {@link TypeGuardError.IProps}
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createAssertFormData(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): never;
@@ -399,15 +471,18 @@ export declare function createAssertFormData(errorFactory?: undefined | ((props:
  * Creates reusable {@link assertFormData} function.
  *
  * @template T Target object type
+ *
  * @param errorFactory Custom error factory receiving
  *   {@link TypeGuardError.IProps}
+ *
  * @returns Reusable decoder function
  */
-export declare function createAssertFormData<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: FormData, 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.
  *
  * @template T Target object type
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createIsFormData(): never;
@@ -415,13 +490,15 @@ export declare function createIsFormData(): never;
  * Creates reusable {@link isFormData} function.
  *
  * @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.
  *
  * @template T Target object type
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createValidateFormData(): never;
@@ -429,6 +506,7 @@ export declare function createValidateFormData(): never;
  * Creates reusable {@link validateFormData} function.
  *
  * @template T Target object type
+ *
  * @returns Reusable decoder function
  */
 export declare function createValidateFormData<T extends object>(): (input: FormData) => IValidation<Resolved<T>>;
@@ -436,6 +514,7 @@ export declare function createValidateFormData<T extends object>(): (input: Form
  * Creates reusable {@link query} function.
  *
  * @template T Target object type
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createQuery(): never;
@@ -443,15 +522,18 @@ export declare function createQuery(): never;
  * Creates reusable {@link query} function.
  *
  * @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.
  *
  * @template T Target object type
+ *
  * @param errorFactory Custom error factory receiving
  *   {@link TypeGuardError.IProps}
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createAssertQuery(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): never;
@@ -459,15 +541,18 @@ export declare function createAssertQuery(errorFactory?: undefined | ((props: Ty
  * Creates reusable {@link assertQuery} function.
  *
  * @template T Target object type
+ *
  * @param errorFactory Custom error factory receiving
  *   {@link TypeGuardError.IProps}
+ *
  * @returns Reusable decoder function
  */
-export declare function createAssertQuery<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: string | IReadableURLSearchParams, 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.
  *
  * @template T Target object type
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createIsQuery(): never;
@@ -475,13 +560,15 @@ export declare function createIsQuery(): never;
  * Creates reusable {@link isQuery} function.
  *
  * @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.
  *
  * @template T Target object type
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createValidateQuery(): never;
@@ -489,6 +576,7 @@ export declare function createValidateQuery(): never;
  * Creates reusable {@link validateQuery} function.
  *
  * @template T Target object type
+ *
  * @returns Reusable decoder function
  */
 export declare function createValidateQuery<T extends object>(): (input: string | IReadableURLSearchParams) => IValidation<Resolved<T>>;
@@ -496,6 +584,7 @@ export declare function createValidateQuery<T extends object>(): (input: string
  * Creates reusable {@link headers} function.
  *
  * @template T Target object type
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createHeaders(): never;
@@ -503,15 +592,18 @@ export declare function createHeaders(): never;
  * Creates reusable {@link headers} function.
  *
  * @template T Target object type
+ *
  * @returns Reusable decoder function
  */
-export declare function createHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => T;
+export declare function createHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => Resolved<T>;
 /**
  * Creates reusable {@link assertHeaders} function.
  *
  * @template T Target object type
+ *
  * @param errorFactory Custom error factory receiving
  *   {@link TypeGuardError.IProps}
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createAssertHeaders(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): never;
@@ -519,15 +611,18 @@ export declare function createAssertHeaders(errorFactory?: undefined | ((props:
  * Creates reusable {@link assertHeaders} function.
  *
  * @template T Target object type
+ *
  * @param errorFactory Custom error factory receiving
  *   {@link TypeGuardError.IProps}
+ *
  * @returns Reusable decoder function
  */
-export declare function createAssertHeaders<T extends object>(errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error)): (input: Record<string, string | string[] | undefined>, 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.
  *
  * @template T Target object type
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createIsHeaders(): never;
@@ -535,13 +630,15 @@ export declare function createIsHeaders(): never;
  * Creates reusable {@link isHeaders} function.
  *
  * @template T Target object type
+ *
  * @returns Reusable decoder function
  */
-export declare function createIsHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => T | null;
+export declare function createIsHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => Resolved<T> | null;
 /**
  * Creates reusable {@link validateHeaders} function.
  *
  * @template T Target object type
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createValidateHeaders(): never;
@@ -549,6 +646,7 @@ export declare function createValidateHeaders(): never;
  * Creates reusable {@link validateHeaders} function.
  *
  * @template T Target object type
+ *
  * @returns Reusable decoder function
  */
 export declare function createValidateHeaders<T extends object>(): (input: Record<string, string | string[] | undefined>) => IValidation<Resolved<T>>;
@@ -556,6 +654,7 @@ export declare function createValidateHeaders<T extends object>(): (input: Recor
  * Creates reusable {@link parameter} function.
  *
  * @template T Target atomic type
+ *
  * @danger You must configure the generic argument `T`
  */
 export declare function createParameter(): never;
@@ -563,6 +662,7 @@ export declare function createParameter(): never;
  * Creates reusable {@link parameter} function.
  *
  * @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 CHANGED Viewed

	@@ -1 +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"}
1	+ {"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,gGAA6F;AAkD7F,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,eAAe,CAAC,CAAC;AACjD,CAAC;AAuCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,qBAAqB,CAAC,CAAC;AACvD,CAAC;AAkCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,iBAAiB,CAAC,CAAC;AACnD,CAAC;AAmCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,uBAAuB,CAAC,CAAC;AACzD,CAAC;AA2CD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,YAAY,CAAC,CAAC;AAC9C,CAAC;AAuCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC;AAkCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,cAAc,CAAC,CAAC;AAChD,CAAC;AAmCD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AAkDD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,cAAc,CAAC,CAAC;AAChD,CAAC;AAgDD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AA2CD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AA4CD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,sBAAsB,CAAC,CAAC;AACxD,CAAC;AA+BD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAyBD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,qBAAqB,CAAC,CAAC;AACvD,CAAC;AAiCD,gBAAgB;AAChB;IAIE,IAAA,6DAA6B,EAAC,2BAA2B,CAAC,CAAC;AAC7D,CAAC;AAsBD,gBAAgB;AAChB;IACE,IAAA,6DAA6B,EAAC,uBAAuB,CAAC,CAAC;AACzD,CAAC;AAsBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,6BAA6B,CAAC,CAAC;AAC/D,CAAC;AAsBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,kBAAkB,CAAC,CAAC;AACpD,CAAC;AAiCD,gBAAgB;AAChB;IAIE,IAAA,6DAA6B,EAAC,wBAAwB,CAAC,CAAC;AAC1D,CAAC;AAsBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AAsBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,0BAA0B,CAAC,CAAC;AAC5D,CAAC;AAsBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,oBAAoB,CAAC,CAAC;AACtD,CAAC;AAiCD,gBAAgB;AAChB;IAIE,IAAA,6DAA6B,EAAC,0BAA0B,CAAC,CAAC;AAC5D,CAAC;AAsBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,sBAAsB,CAAC,CAAC;AACxD,CAAC;AAsBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,4BAA4B,CAAC,CAAC;AAC9D,CAAC;AAsBD,gBAAgB;AAChB;IAGE,IAAA,6DAA6B,EAAC,sBAAsB,CAAC,CAAC;AACxD,CAAC"}