@happy-ts/fetch-t 1.8.0 → 1.8.1

package/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.8.1] - 2026-01-13
+
+### Changed
+
+- Replace `tiny-invariant` with explicit `throw` statements to preserve error messages in production builds
+- Improve parameter validation error messages with proper `TypeError` vs `Error` distinction
+
+### Removed
+
+- Remove `tiny-invariant` dependency (smaller bundle size)
+
 ## [1.8.0] - 2026-01-12
 
 ### Added
@@ -199,6 +210,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Timeout support
 - Rust-like Result type error handling via `happy-rusty` library
 
+[1.8.1]: https://github.com/JiangJie/fetch-t/compare/v1.8.0...v1.8.1
 [1.8.0]: https://github.com/JiangJie/fetch-t/compare/v1.7.0...v1.8.0
 [1.7.0]: https://github.com/JiangJie/fetch-t/compare/v1.6.0...v1.7.0
 [1.6.0]: https://github.com/JiangJie/fetch-t/compare/v1.5.1...v1.6.0

package/README.cn.md

@@ -103,6 +103,36 @@ const result = await fetchT('https://api.example.com/data', {
 - [自动重试](examples/with-retry.ts) - 自动重试策略
 - [错误处理](examples/error-handling.ts) - 错误处理模式
 
+## 错误处理设计
+
+`fetchT` 区分两类错误：
+
+### 编程错误（同步抛出）
+
+无效参数会立即抛出异常，实现快速失败：
+
+```ts
+// 以下代码同步抛出异常 - 不需要 try/catch 包裹 await
+fetchT('https://example.com', { timeout: -1 });     // Error: timeout 必须 > 0
+fetchT('https://example.com', { timeout: 'bad' });  // TypeError: timeout 必须是数字
+fetchT('not-a-url');                                // TypeError: 无效的 URL
+```
+
+这与原生 `fetch` 不同，原生 `fetch` 对参数错误返回 rejected Promise。同步抛出提供更清晰的调用栈，帮助在开发阶段发现问题。
+
+### 运行时错误（Result 类型）
+
+网络故障和 HTTP 错误通过 `Result` 类型包装：
+
+```ts
+const result = await fetchT('https://api.example.com/data', { responseType: 'json' });
+
+if (result.isErr()) {
+    const error = result.unwrapErr();
+    // FetchError（包含状态码）或网络 Error
+}
+```
+
 ## 许可证
 
 [MIT](LICENSE)

package/README.md

@@ -103,6 +103,36 @@ const result = await fetchT('https://api.example.com/data', {
 - [Retry](examples/with-retry.ts) - Automatic retry strategies
 - [Error Handling](examples/error-handling.ts) - Error handling patterns
 
+## Error Handling Design
+
+`fetchT` distinguishes between two types of errors:
+
+### Programming Errors (Synchronous)
+
+Invalid parameters throw immediately for fail-fast behavior:
+
+```ts
+// These throw synchronously - no try/catch around await needed
+fetchT('https://example.com', { timeout: -1 });     // Error: timeout must be > 0
+fetchT('https://example.com', { timeout: 'bad' });  // TypeError: timeout must be a number
+fetchT('not-a-url');                                // TypeError: Invalid URL
+```
+
+This differs from native `fetch`, which returns rejected Promises for parameter errors. Synchronous throws provide clearer stack traces and catch bugs during development.
+
+### Runtime Errors (Result Type)
+
+Network failures and HTTP errors are wrapped in `Result` type:
+
+```ts
+const result = await fetchT('https://api.example.com/data', { responseType: 'json' });
+
+if (result.isErr()) {
+    const error = result.unwrapErr();
+    // FetchError with status code, or network Error
+}
+```
+
 ## License
 
 [MIT](LICENSE)

package/dist/main.cjs

@@ -3,7 +3,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const happyRusty = require('happy-rusty');
-const invariant = require('tiny-invariant');
 
 const ABORT_ERROR = "AbortError";
 const TIMEOUT_ERROR = "TimeoutError";
@@ -244,16 +243,27 @@ function validateOptions(init) {
   } = init;
   if (responseType != null) {
     const validTypes = ["text", "arraybuffer", "blob", "json", "bytes", "stream"];
-    invariant(validTypes.includes(responseType), () => `responseType must be one of ${validTypes.join(", ")} but received ${responseType}`);
+    if (!validTypes.includes(responseType)) {
+      throw new TypeError(`responseType must be one of ${validTypes.join(", ")} but received ${responseType}`);
+    }
   }
   if (timeout != null) {
-    invariant(typeof timeout === "number" && timeout > 0, () => `timeout must be a number greater than 0 but received ${timeout}`);
+    if (typeof timeout !== "number") {
+      throw new TypeError(`timeout must be a number but received ${typeof timeout}`);
+    }
+    if (timeout <= 0) {
+      throw new Error(`timeout must be a number greater than 0 but received ${timeout}`);
+    }
   }
   if (onProgress != null) {
-    invariant(typeof onProgress === "function", () => `onProgress callback must be a function but received ${typeof onProgress}`);
+    if (typeof onProgress !== "function") {
+      throw new TypeError(`onProgress callback must be a function but received ${typeof onProgress}`);
+    }
   }
   if (onChunk != null) {
-    invariant(typeof onChunk === "function", () => `onChunk callback must be a function but received ${typeof onChunk}`);
+    if (typeof onChunk !== "function") {
+      throw new TypeError(`onChunk callback must be a function but received ${typeof onChunk}`);
+    }
   }
   let retries = 0;
   let delay2 = 0;
@@ -267,17 +277,30 @@ function validateOptions(init) {
     when = retryOptions.when;
     onRetry = retryOptions.onRetry;
   }
-  invariant(Number.isInteger(retries) && retries >= 0, () => `Retry count must be a non-negative integer but received ${retries}`);
+  if (!Number.isInteger(retries)) {
+    throw new TypeError(`Retry count must be an integer but received ${retries}`);
+  }
+  if (retries < 0) {
+    throw new Error(`Retry count must be non-negative but received ${retries}`);
+  }
   if (typeof delay2 === "number") {
-    invariant(delay2 >= 0, () => `Retry delay must be a non-negative number but received ${delay2}`);
+    if (delay2 < 0) {
+      throw new Error(`Retry delay must be a non-negative number but received ${delay2}`);
+    }
   } else {
-    invariant(typeof delay2 === "function", () => `Retry delay must be a number or a function but received ${typeof delay2}`);
+    if (typeof delay2 !== "function") {
+      throw new TypeError(`Retry delay must be a number or a function but received ${typeof delay2}`);
+    }
   }
   if (when != null) {
-    invariant(Array.isArray(when) || typeof when === "function", () => `Retry when condition must be an array of status codes or a function but received ${typeof when}`);
+    if (!Array.isArray(when) && typeof when !== "function") {
+      throw new TypeError(`Retry when condition must be an array of status codes or a function but received ${typeof when}`);
+    }
   }
   if (onRetry != null) {
-    invariant(typeof onRetry === "function", () => `Retry onRetry callback must be a function but received ${typeof onRetry}`);
+    if (typeof onRetry !== "function") {
+      throw new TypeError(`Retry onRetry callback must be a function but received ${typeof onRetry}`);
+    }
   }
   return { retries, delay: delay2, when, onRetry };
 }

package/dist/main.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.cjs","sources":["../src/fetch/constants.ts","../src/fetch/defines.ts","../src/fetch/fetch.ts"],"sourcesContent":["/**\n * Error name for aborted fetch requests.\n *\n * This matches the standard `AbortError` name used by the Fetch API when a request\n * is cancelled via `AbortController.abort()`.\n *\n * @example\n * ```typescript\n * import { fetchT, ABORT_ERROR } from '@happy-ts/fetch-t';\n *\n * const task = fetchT('https://api.example.com/data', { abortable: true });\n * task.abort();\n *\n * const result = await task.response;\n * result.inspectErr((err) => {\n *     if (err.name === ABORT_ERROR) {\n *         console.log('Request was aborted');\n *     }\n * });\n * ```\n */\nexport const ABORT_ERROR = 'AbortError' as const;\n\n/**\n * Error name for timed out fetch requests.\n *\n * This is set on the `Error.name` property when a request exceeds the specified\n * `timeout` duration and is automatically aborted.\n *\n * @example\n * ```typescript\n * import { fetchT, TIMEOUT_ERROR } from '@happy-ts/fetch-t';\n *\n * const result = await fetchT('https://api.example.com/slow-endpoint', {\n *     timeout: 5000, // 5 seconds\n * });\n *\n * result.inspectErr((err) => {\n *     if (err.name === TIMEOUT_ERROR) {\n *         console.log('Request timed out after 5 seconds');\n *     }\n * });\n * ```\n */\nexport const TIMEOUT_ERROR = 'TimeoutError' as const;\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { AsyncResult, IOResult } from 'happy-rusty';\n\n/**\n * Union type of all possible fetchT response data types.\n *\n * Used when `responseType` is a dynamic string value rather than a literal type,\n * as the exact return type cannot be determined at compile time.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponseData } from '@happy-ts/fetch-t';\n *\n * // When responseType is dynamic, return type is FetchResponseData\n * const responseType = getResponseType(); // returns string\n * const result = await fetchT('https://api.example.com/data', { responseType });\n * // result is Result<FetchResponseData, Error>\n * ```\n */\nexport type FetchResponseData =\n    | string\n    | ArrayBuffer\n    | Blob\n    | Uint8Array<ArrayBuffer>\n    | ReadableStream<Uint8Array<ArrayBuffer>>\n    | Response\n    | null;\n\n/**\n * Represents the response of a fetch operation as an async Result type.\n *\n * This is an alias for `AsyncResult<T, E>` from the `happy-rusty` library,\n * providing Rust-like error handling without throwing exceptions.\n *\n * @typeParam T - The type of the data expected in a successful response.\n * @typeParam E - The type of the error (defaults to `any`). Typically `Error` or `FetchError`.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponse } from '@happy-ts/fetch-t';\n *\n * // FetchResponse is a Promise that resolves to Result<T, E>\n * const response: FetchResponse<string> = fetchT('https://api.example.com', {\n *     responseType: 'text',\n * });\n *\n * const result = await response;\n * result\n *     .inspect((text) => console.log('Success:', text))\n *     .inspectErr((err) => console.error('Error:', err));\n * ```\n */\nexport type FetchResponse<T, E = any> = AsyncResult<T, E>;\n\n/**\n * Represents an abortable fetch operation with control methods.\n *\n * Returned when `abortable: true` is set in the fetch options. Provides\n * the ability to cancel the request and check its abort status.\n *\n * @typeParam T - The type of the data expected in the response.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchTask } from '@happy-ts/fetch-t';\n *\n * interface User {\n *     id: number;\n *     name: string;\n * }\n *\n * const task: FetchTask<User> = fetchT<User>('https://api.example.com/user/1', {\n *     abortable: true,\n *     responseType: 'json',\n * });\n *\n * // Check if aborted\n * console.log('Is aborted:', task.aborted); // false\n *\n * // Abort with optional reason\n * task.abort('User navigated away');\n *\n * // Access the response (will be an error after abort)\n * const result = await task.response;\n * result.inspectErr((err) => console.log('Aborted:', err.message));\n * ```\n */\nexport interface FetchTask<T> {\n    /**\n     * Aborts the fetch task, optionally with a reason.\n     *\n     * Once aborted, the `response` promise will resolve to an `Err` containing\n     * an `AbortError`. The abort reason can be any value and will be passed\n     * to the underlying `AbortController.abort()`.\n     *\n     * @param reason - An optional value indicating why the task was aborted.\n     *                 This can be an Error, string, or any other value.\n     */\n    abort(reason?: any): void;\n\n    /**\n     * Indicates whether the fetch task has been aborted.\n     *\n     * Returns `true` if `abort()` was called or if the request timed out.\n     */\n    readonly aborted: boolean;\n\n    /**\n     * The response promise of the fetch task.\n     *\n     * Resolves to `Ok<T>` on success, or `Err<Error>` on failure (including abort).\n     */\n    readonly response: FetchResponse<T>;\n}\n\n/**\n * Specifies the expected response type for automatic parsing.\n *\n * - `'text'` - Parse response as string via `Response.text()`\n * - `'json'` - Parse response as JSON via `Response.json()`\n * - `'arraybuffer'` - Parse response as ArrayBuffer via `Response.arrayBuffer()`\n * - `'bytes'` - Parse response as Uint8Array<ArrayBuffer> via `Response.bytes()` (with fallback for older environments)\n * - `'blob'` - Parse response as Blob via `Response.blob()`\n * - `'stream'` - Return the raw `ReadableStream` for streaming processing\n *\n * If not specified, the raw `Response` object is returned.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponseType } from '@happy-ts/fetch-t';\n *\n * const responseType: FetchResponseType = 'json';\n *\n * const result = await fetchT('https://api.example.com/data', { responseType });\n * ```\n */\nexport type FetchResponseType = 'text' | 'arraybuffer' | 'blob' | 'json' | 'bytes' | 'stream';\n\n/**\n * Represents the download progress of a fetch operation.\n *\n * Passed to the `onProgress` callback when tracking download progress.\n * Note: Progress tracking requires the server to send a `Content-Length` header.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchProgress } from '@happy-ts/fetch-t';\n *\n * await fetchT('https://example.com/file.zip', {\n *     responseType: 'blob',\n *     onProgress: (result) => {\n *         result.inspect((progress: FetchProgress) => {\n *             const percent = (progress.completedByteLength / progress.totalByteLength) * 100;\n *             console.log(`Downloaded: ${percent.toFixed(1)}%`);\n *         });\n *     },\n * });\n * ```\n */\nexport interface FetchProgress {\n    /**\n     * The total number of bytes to be received (from Content-Length header).\n     */\n    totalByteLength: number;\n\n    /**\n     * The number of bytes received so far.\n     */\n    completedByteLength: number;\n}\n\n/**\n * Options for configuring retry behavior.\n */\nexport interface FetchRetryOptions {\n    /**\n     * Number of times to retry the request on failure.\n     *\n     * By default, only network errors trigger retries. HTTP errors (4xx, 5xx)\n     * require explicit configuration via `when`.\n     *\n     * @default 0 (no retries)\n     */\n    retries?: number;\n\n    /**\n     * Delay between retry attempts in milliseconds.\n     *\n     * Can be a static number or a function for custom strategies like exponential backoff.\n     * The function receives the current attempt number (1-indexed).\n     *\n     * @default 0 (immediate retry)\n     */\n    delay?: number | ((attempt: number) => number);\n\n    /**\n     * Conditions under which to retry the request.\n     *\n     * Can be an array of HTTP status codes or a custom function.\n     * By default, only network errors (not FetchError) trigger retries.\n     */\n    when?: number[] | ((error: Error, attempt: number) => boolean);\n\n    /**\n     * Callback invoked before each retry attempt.\n     *\n     * Useful for logging, metrics, or adjusting request parameters.\n     */\n    onRetry?: (error: Error, attempt: number) => void;\n}\n\n/**\n * Extended fetch options that add additional capabilities to the standard `RequestInit`.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchInit } from '@happy-ts/fetch-t';\n *\n * const options: FetchInit = {\n *     // Standard RequestInit options\n *     method: 'POST',\n *     headers: { 'Content-Type': 'application/json' },\n *     body: JSON.stringify({ key: 'value' }),\n *\n *     // Extended options\n *     abortable: true,           // Return FetchTask for manual abort control\n *     responseType: 'json',      // Auto-parse response as JSON\n *     timeout: 10000,            // Abort after 10 seconds\n *     onProgress: (result) => {  // Track download progress\n *         result.inspect(({ completedByteLength, totalByteLength }) => {\n *             console.log(`${completedByteLength}/${totalByteLength}`);\n *         });\n *     },\n *     onChunk: (chunk) => {      // Receive raw data chunks\n *         console.log('Received chunk:', chunk.byteLength, 'bytes');\n *     },\n * };\n *\n * const task = fetchT('https://api.example.com/upload', options);\n * ```\n */\nexport interface FetchInit extends RequestInit {\n    /**\n     * When `true`, returns a `FetchTask` instead of `FetchResponse`.\n     *\n     * The `FetchTask` provides `abort()` method and `aborted` status.\n     *\n     * @default false\n     */\n    abortable?: boolean;\n\n    /**\n     * Specifies how the response body should be parsed.\n     *\n     * - `'text'` - Returns `string`\n     * - `'json'` - Returns parsed JSON (type `T`)\n     * - `'arraybuffer'` - Returns `ArrayBuffer`\n     * - `'bytes'` - Returns `Uint8Array<ArrayBuffer>` (with fallback for older environments)\n     * - `'blob'` - Returns `Blob`\n     * - `'stream'` - Returns `ReadableStream<Uint8Array<ArrayBuffer>>`\n     * - `undefined` - Returns raw `Response` object\n     *\n     * When using a dynamic string value (not a literal type), the return type\n     * will be `FetchResponseData` (union of all possible types).\n     */\n    responseType?: FetchResponseType;\n\n    /**\n     * Maximum time in milliseconds to wait for the request to complete.\n     *\n     * If exceeded, the request is automatically aborted with a `TimeoutError`.\n     * Must be a positive number.\n     */\n    timeout?: number;\n\n    /**\n     * Retry options.\n     *\n     * Can be a number (shorthand for retries count) or an options object.\n     *\n     * @example\n     * ```typescript\n     * // Retry up to 3 times on network errors\n     * const result = await fetchT('https://api.example.com/data', {\n     *     retry: 3,\n     * });\n     *\n     * // Detailed configuration\n     * const result = await fetchT('https://api.example.com/data', {\n     *     retry: {\n     *         retries: 3,\n     *         delay: 1000,\n     *         when: [500, 502],\n     *         onRetry: (error, attempt) => console.log(error),\n     *     },\n     * });\n     * ```\n     */\n    retry?: number | FetchRetryOptions;\n\n    /**\n     * Callback invoked during download to report progress.\n     *\n     * Receives an `IOResult<FetchProgress>`:\n     * - `Ok(FetchProgress)` - Progress update with byte counts\n     * - `Err(Error)` - If `Content-Length` header is missing (called once)\n     *\n     * @param progressResult - The progress result, either success with progress data or error.\n     */\n    onProgress?: (progressResult: IOResult<FetchProgress>) => void;\n\n    /**\n     * Callback invoked when a chunk of data is received.\n     *\n     * Useful for streaming or processing data as it arrives.\n     * Each chunk is a `Uint8Array<ArrayBuffer>` containing the raw bytes.\n     *\n     * @param chunk - The raw data chunk received from the response stream.\n     */\n    onChunk?: (chunk: Uint8Array<ArrayBuffer>) => void;\n}\n\n/**\n * Custom error class for HTTP error responses (non-2xx status codes).\n *\n * Thrown when `Response.ok` is `false`. Contains the HTTP status code\n * for programmatic error handling.\n *\n * @example\n * ```typescript\n * import { fetchT, FetchError } from '@happy-ts/fetch-t';\n *\n * const result = await fetchT('https://api.example.com/not-found', {\n *     responseType: 'json',\n * });\n *\n * result.inspectErr((err) => {\n *     if (err instanceof FetchError) {\n *         console.log('HTTP Status:', err.status);  // e.g., 404\n *         console.log('Status Text:', err.message); // e.g., \"Not Found\"\n *\n *         // Handle specific status codes\n *         switch (err.status) {\n *             case 401:\n *                 console.log('Unauthorized - please login');\n *                 break;\n *             case 404:\n *                 console.log('Resource not found');\n *                 break;\n *             case 500:\n *                 console.log('Server error');\n *                 break;\n *         }\n *     }\n * });\n * ```\n */\nexport class FetchError extends Error {\n    /**\n     * The error name, always `'FetchError'`.\n     */\n    override name = 'FetchError';\n\n    /**\n     * The HTTP status code of the response (e.g., 404, 500).\n     */\n    status: number;\n\n    /**\n     * Creates a new FetchError instance.\n     *\n     * @param message - The status text from the HTTP response (e.g., \"Not Found\").\n     * @param status - The HTTP status code (e.g., 404).\n     */\n    constructor(message: string, status: number) {\n        super(message);\n        this.status = status;\n    }\n}\n","import { Err, Ok, type AsyncIOResult } from 'happy-rusty';\nimport invariant from 'tiny-invariant';\nimport { ABORT_ERROR } from './constants.ts';\nimport { FetchError, type FetchInit, type FetchResponse, type FetchResponseData, type FetchResponseType, type FetchRetryOptions, type FetchTask } from './defines.ts';\n\n/**\n * Fetches a resource from the network as a text string and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'text'`.\n * @returns A `FetchTask` representing the abortable operation with a `string` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'text';\n}): FetchTask<string>;\n\n/**\n * Fetches a resource from the network as an ArrayBuffer and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'arraybuffer'`.\n * @returns A `FetchTask` representing the abortable operation with an `ArrayBuffer` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'arraybuffer';\n}): FetchTask<ArrayBuffer>;\n\n/**\n * Fetches a resource from the network as a Blob and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'blob'`.\n * @returns A `FetchTask` representing the abortable operation with a `Blob` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'blob';\n}): FetchTask<Blob>;\n\n/**\n * Fetches a resource from the network and parses it as JSON, returning an abortable `FetchTask`.\n *\n * @typeParam T - The expected type of the parsed JSON data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'json'`.\n * @returns A `FetchTask` representing the abortable operation with a response parsed as type `T`.\n */\nexport function fetchT<T>(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'json';\n}): FetchTask<T | null>;\n\n/**\n * Fetches a resource from the network as a ReadableStream and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'stream'`.\n * @returns A `FetchTask` representing the abortable operation with a `ReadableStream<Uint8Array<ArrayBuffer>>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'stream';\n}): FetchTask<ReadableStream<Uint8Array<ArrayBuffer>> | null>;\n\n/**\n * Fetches a resource from the network as a Uint8Array<ArrayBuffer> and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'bytes'`.\n * @returns A `FetchTask` representing the abortable operation with a `Uint8Array<ArrayBuffer>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'bytes';\n}): FetchTask<Uint8Array<ArrayBuffer>>;\n\n/**\n * Fetches a resource from the network and returns an abortable `FetchTask` with a dynamic response type.\n *\n * Use this overload when `responseType` is a `FetchResponseType` union type.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and a `FetchResponseType`.\n * @returns A `FetchTask` representing the abortable operation with a `FetchResponseData` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: FetchResponseType;\n}): FetchTask<FetchResponseData>;\n\n/**\n * Fetches a resource from the network as a text string.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'text'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `string` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'text';\n}): FetchResponse<string, Error>;\n\n/**\n * Fetches a resource from the network as an ArrayBuffer.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'arraybuffer'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with an `ArrayBuffer` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'arraybuffer';\n}): FetchResponse<ArrayBuffer, Error>;\n\n/**\n * Fetches a resource from the network as a Blob.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'blob'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Blob` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'blob';\n}): FetchResponse<Blob, Error>;\n\n/**\n * Fetches a resource from the network and parses it as JSON.\n *\n * @typeParam T - The expected type of the parsed JSON data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'json'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a response parsed as type `T`.\n */\nexport function fetchT<T>(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'json';\n}): FetchResponse<T | null, Error>;\n\n/**\n * Fetches a resource from the network as a ReadableStream.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'stream'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `ReadableStream<Uint8Array<ArrayBuffer>>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'stream';\n}): FetchResponse<ReadableStream<Uint8Array<ArrayBuffer>> | null, Error>;\n\n/**\n * Fetches a resource from the network as a Uint8Array<ArrayBuffer>.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'bytes'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Uint8Array<ArrayBuffer>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'bytes';\n}): FetchResponse<Uint8Array<ArrayBuffer>, Error>;\n\n/**\n * Fetches a resource from the network with a dynamic response type (non-abortable).\n *\n * Use this overload when `responseType` is a `FetchResponseType` union type.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation with a `FetchResponseType`, and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `FetchResponseData` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: FetchResponseType;\n}): FetchResponse<FetchResponseData, Error>;\n\n/**\n * Fetches a resource from the network and returns an abortable `FetchTask` with a generic `Response`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true`.\n * @returns A `FetchTask` representing the abortable operation with a `Response` object.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n}): FetchTask<Response>;\n\n/**\n * Fetches a resource from the network and returns a `FetchResponse` with a generic `Response` object.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Optional additional options for the fetch operation, and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Response` object.\n */\nexport function fetchT(url: string | URL, init?: FetchInit & {\n    abortable?: false;\n}): FetchResponse<Response>;\n\n/**\n * Enhanced fetch function that wraps the native Fetch API with additional capabilities.\n *\n * Features:\n * - **Abortable requests**: Set `abortable: true` to get a `FetchTask` with `abort()` method.\n * - **Type-safe responses**: Use `responseType` to automatically parse responses as text, JSON, ArrayBuffer, or Blob.\n * - **Timeout support**: Set `timeout` in milliseconds to auto-abort long-running requests.\n * - **Progress tracking**: Use `onProgress` callback to track download progress (requires Content-Length header).\n * - **Chunk streaming**: Use `onChunk` callback to receive raw data chunks as they arrive.\n * - **Retry support**: Use `retry` to automatically retry failed requests with configurable delay and conditions.\n * - **Result type error handling**: Returns `Result<T, Error>` instead of throwing exceptions.\n *\n * @typeParam T - The expected type of the response data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, extending standard `RequestInit` with custom properties.\n * @returns A `FetchTask<T>` if `abortable: true`, otherwise a `FetchResponse<T>` (which is `AsyncResult<T, Error>`).\n * @throws {Error} If `url` is not a string or URL object.\n * @throws {Error} If `timeout` is specified but is not a positive number.\n *\n * @example\n * // Basic GET request - returns Response object wrapped in Result\n * const result = await fetchT('https://api.example.com/data');\n * result\n *     .inspect((res) => console.log('Status:', res.status))\n *     .inspectErr((err) => console.error('Error:', err));\n *\n * @example\n * // GET JSON with type safety\n * interface User {\n *     id: number;\n *     name: string;\n * }\n * const result = await fetchT<User>('https://api.example.com/user/1', {\n *     responseType: 'json',\n * });\n * result.inspect((user) => console.log(user.name));\n *\n * @example\n * // POST request with JSON body\n * const result = await fetchT<User>('https://api.example.com/users', {\n *     method: 'POST',\n *     headers: { 'Content-Type': 'application/json' },\n *     body: JSON.stringify({ name: 'John' }),\n *     responseType: 'json',\n * });\n *\n * @example\n * // Abortable request with timeout\n * const task = fetchT('https://api.example.com/data', {\n *     abortable: true,\n *     timeout: 5000, // 5 seconds\n * });\n *\n * // Cancel the request if needed\n * task.abort('User cancelled');\n *\n * // Check if aborted\n * console.log('Aborted:', task.aborted);\n *\n * // Wait for response\n * const result = await task.response;\n *\n * @example\n * // Track download progress\n * const result = await fetchT('https://example.com/large-file.zip', {\n *     responseType: 'blob',\n *     onProgress: (progressResult) => {\n *         progressResult\n *             .inspect(({ completedByteLength, totalByteLength }) => {\n *                 const percent = ((completedByteLength / totalByteLength) * 100).toFixed(1);\n *                 console.log(`Progress: ${percent}%`);\n *             })\n *             .inspectErr((err) => console.warn('Progress unavailable:', err.message));\n *     },\n * });\n *\n * @example\n * // Stream data chunks\n * const chunks: Uint8Array[] = [];\n * const result = await fetchT('https://example.com/stream', {\n *     onChunk: (chunk) => chunks.push(chunk),\n * });\n *\n * @example\n * // Retry with exponential backoff\n * const result = await fetchT('https://api.example.com/data', {\n *     retry: {\n *         retries: 3,\n *         delay: (attempt) => Math.min(1000 * Math.pow(2, attempt - 1), 10000),\n *         when: [500, 502, 503, 504],\n *         onRetry: (error, attempt) => console.log(`Retry ${attempt}: ${error.message}`),\n *     },\n *     responseType: 'json',\n * });\n */\nexport function fetchT(url: string | URL, init?: FetchInit): FetchTask<FetchResponseData> | FetchResponse<FetchResponseData> {\n    // Validate and parse URL\n    const parsedUrl = validateUrl(url);\n\n    const fetchInit = init ?? {};\n\n    const {\n        retries,\n        delay: retryDelay,\n        when: retryWhen,\n        onRetry,\n    } = validateOptions(fetchInit);\n\n    const {\n        // default not abortable\n        abortable = false,\n        responseType,\n        timeout,\n        onProgress,\n        onChunk,\n        ...rest\n    } = fetchInit;\n\n    // Preserve user's original signal before modifications (rest.signal will be reassigned in setSignal)\n    const userSignal = rest.signal;\n\n    // User controller for manual abort (stops all retries)\n    let userController: AbortController | undefined;\n    if (abortable) {\n        userController = new AbortController();\n    }\n\n    /**\n     * Determines if the error should trigger a retry.\n     * By default, only network errors (not FetchError) trigger retries.\n     */\n    const shouldRetry = (error: Error, attempt: number): boolean => {\n        // Never retry on user abort\n        if (error.name === ABORT_ERROR) {\n            return false;\n        }\n\n        if (!retryWhen) {\n            // Default: only retry on network errors (not FetchError/HTTP errors)\n            return !(error instanceof FetchError);\n        }\n\n        if (Array.isArray(retryWhen)) {\n            // Retry on specific HTTP status codes\n            return error instanceof FetchError && retryWhen.includes(error.status);\n        }\n\n        // Custom retry condition\n        return retryWhen(error, attempt);\n    };\n\n    /**\n     * Calculates the delay before the next retry attempt.\n     */\n    const getRetryDelay = (attempt: number): number => {\n        return typeof retryDelay === 'function'\n            ? retryDelay(attempt)\n            : retryDelay;\n    };\n\n    /**\n     * Configures the abort signal for a fetch attempt.\n     *\n     * Combines multiple signals:\n     * - User's external signal (from init.signal)\n     * - Internal abort controller signal (for abortable requests)\n     * - Timeout signal (creates a new one each call for per-attempt timeout)\n     *\n     * Must be called before each fetch attempt to ensure fresh timeout signal on retries.\n     */\n    const configureSignal = (): void => {\n        const signals: AbortSignal[] = [];\n\n        // Merge user's signal from init (if provided)\n        if (userSignal) {\n            signals.push(userSignal);\n        }\n\n        if (userController) {\n            signals.push(userController.signal);\n        }\n\n        if (typeof timeout === 'number') {\n            signals.push(AbortSignal.timeout(timeout));\n        }\n\n        // Combine all signals\n        if (signals.length > 0) {\n            rest.signal = signals.length === 1\n                ? signals[0]\n                : AbortSignal.any(signals);\n        }\n    };\n\n    /**\n     * Performs a single fetch attempt with optional timeout.\n     */\n    const doFetch = async (): AsyncIOResult<FetchResponseData> => {\n        configureSignal();\n\n        try {\n            const response = await fetch(parsedUrl, rest);\n\n            if (!response.ok) {\n                // Cancel the response body to free resources\n                response.body?.cancel().catch(() => {\n                    // Silently ignore stream cancel errors\n                });\n                return Err(new FetchError(response.statusText, response.status));\n            }\n\n            return await processResponse(response);\n        } catch (err) {\n            return Err(err instanceof Error\n                ? err\n                // Non-Error type, most likely an abort reason\n                : wrapAbortReason(err),\n            );\n        }\n    };\n\n    /**\n     * Sets up progress tracking and chunk callbacks using a cloned response.\n     * The original response is returned unchanged for further processing.\n     */\n    const setupProgressCallbacks = async (response: Response): Promise<void> => {\n        let totalByteLength: number | undefined;\n        let completedByteLength = 0;\n\n        if (onProgress) {\n            const contentLength = response.headers.get('content-length');\n            if (contentLength == null) {\n                try {\n                    onProgress(Err(new Error('No content-length in response headers')));\n                } catch {\n                    // Silently ignore user callback errors\n                }\n            } else {\n                totalByteLength = Number.parseInt(contentLength, 10);\n            }\n        }\n\n        const body = response.clone().body as ReadableStream<Uint8Array<ArrayBuffer>>;\n\n        try {\n            for await (const chunk of body) {\n                if (onChunk) {\n                    try {\n                        onChunk(chunk);\n                    } catch {\n                        // Silently ignore user callback errors\n                    }\n                }\n\n                if (onProgress && totalByteLength != null) {\n                    completedByteLength += chunk.byteLength;\n                    try {\n                        onProgress(Ok({\n                            totalByteLength,\n                            completedByteLength,\n                        }));\n                    } catch {\n                        // Silently ignore user callback errors\n                    }\n                }\n            }\n        } catch {\n            // Silently ignore stream read errors\n        }\n    };\n\n    /**\n     * Processes the response based on responseType and callbacks.\n     */\n    const processResponse = async (response: Response): AsyncIOResult<FetchResponseData> => {\n        // Setup progress/chunk callbacks if needed (uses cloned response internally)\n        if (response.body && (onProgress || onChunk)) {\n            setupProgressCallbacks(response);\n        }\n\n        switch (responseType) {\n            case 'json': {\n                // Align with stream behavior: no body yields Ok(null)\n                if (response.body == null) {\n                    return Ok(null);\n                }\n                try {\n                    return Ok(await response.json());\n                } catch {\n                    return Err(new Error('Response is invalid json while responseType is json'));\n                }\n            }\n            case 'text': {\n                return Ok(await response.text());\n            }\n            case 'bytes': {\n                // Use native bytes() if available, otherwise fallback to arrayBuffer()\n                if (typeof response.bytes === 'function') {\n                    return Ok(await response.bytes());\n                }\n                // Fallback for older environments\n                return Ok(new Uint8Array(await response.arrayBuffer()));\n            }\n            case 'arraybuffer': {\n                return Ok(await response.arrayBuffer());\n            }\n            case 'blob': {\n                return Ok(await response.blob());\n            }\n            case 'stream': {\n                return Ok(response.body);\n            }\n            default: {\n                // default return the original Response object to preserve all metadata\n                return Ok(response);\n            }\n        }\n    };\n\n    /**\n     * Performs fetch with retry logic.\n     */\n    const fetchWithRetry = async (): FetchResponse<FetchResponseData, Error> => {\n        let lastError: Error | undefined;\n        let attempt = 0;\n\n        do {\n            // Before retry (not first attempt), wait for delay\n            if (attempt > 0) {\n                // Check if user aborted before delay (e.g., aborted in `when` callback)\n                if (userController?.signal.aborted) {\n                    return Err(userController.signal.reason as Error);\n                }\n\n                const delayMs = getRetryDelay(attempt);\n                // Wait for delay if necessary\n                if (delayMs > 0) {\n                    await delay(delayMs);\n\n                    // Check if user aborted during delay\n                    if (userController?.signal.aborted) {\n                        return Err(userController.signal.reason as Error);\n                    }\n                }\n\n                // Call onRetry right before the actual retry request\n                try {\n                    onRetry?.(lastError as Error, attempt);\n                } catch {\n                    // Silently ignore user callback errors\n                }\n            }\n\n            const result = await doFetch();\n\n            if (result.isOk()) {\n                return result;\n            }\n\n            lastError = result.unwrapErr();\n            attempt++;\n\n            // Check if we should retry\n        } while (attempt <= retries && shouldRetry(lastError, attempt));\n\n        // No more retries or should not retry\n        // lastError is guaranteed to be defined here because:\n        // 1. do...while loop executes at least once\n        // 2. We only reach here if result.isErr()\n        return Err(lastError);\n    };\n\n    const response = fetchWithRetry();\n\n    if (abortable && userController) {\n        return {\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            abort(reason?: any): void {\n                if (reason instanceof Error) {\n                    userController.abort(reason);\n                } else if (reason != null) {\n                    userController.abort(wrapAbortReason(reason));\n                } else {\n                    userController.abort();\n                }\n            },\n\n            get aborted(): boolean {\n                return userController.signal.aborted;\n            },\n\n            get response(): FetchResponse<FetchResponseData> {\n                return response;\n            },\n        };\n    }\n\n    return response;\n}\n\n/**\n * Delays execution for the specified number of milliseconds.\n */\nfunction delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Wraps a non-Error abort reason into an Error with ABORT_ERROR name.\n */\nfunction wrapAbortReason(reason: unknown): Error {\n    const error = new Error(typeof reason === 'string' ? reason : String(reason));\n    error.name = ABORT_ERROR;\n    error.cause = reason;\n    return error;\n}\n\ninterface ParsedRetryOptions extends FetchRetryOptions {\n    retries: number;\n    delay: number | ((attempt: number) => number);\n}\n\n/**\n * Validates fetch options and parses retry configuration.\n */\nfunction validateOptions(init: FetchInit): ParsedRetryOptions {\n    const {\n        responseType,\n        timeout,\n        retry: retryOptions = 0,\n        onProgress,\n        onChunk,\n    } = init;\n\n    if (responseType != null) {\n        const validTypes = ['text', 'arraybuffer', 'blob', 'json', 'bytes', 'stream'];\n        invariant(validTypes.includes(responseType), () => `responseType must be one of ${ validTypes.join(', ') } but received ${ responseType }`);\n    }\n\n    if (timeout != null) {\n        invariant(typeof timeout === 'number' && timeout > 0, () => `timeout must be a number greater than 0 but received ${ timeout }`);\n    }\n\n    if (onProgress != null) {\n        invariant(typeof onProgress === 'function', () => `onProgress callback must be a function but received ${ typeof onProgress }`);\n    }\n\n    if (onChunk != null) {\n        invariant(typeof onChunk === 'function', () => `onChunk callback must be a function but received ${ typeof onChunk }`);\n    }\n\n    // Parse retry options\n    let retries = 0;\n    let delay: number | ((attempt: number) => number) = 0;\n    let when: ((error: Error, attempt: number) => boolean) | number[] | undefined;\n    let onRetry: ((error: Error, attempt: number) => void) | undefined;\n\n    if (typeof retryOptions === 'number') {\n        retries = retryOptions;\n    } else if (retryOptions && typeof retryOptions === 'object') {\n        retries = retryOptions.retries ?? 0;\n        delay = retryOptions.delay ?? 0;\n        when = retryOptions.when;\n        onRetry = retryOptions.onRetry;\n    }\n\n    invariant(Number.isInteger(retries) && retries >= 0, () => `Retry count must be a non-negative integer but received ${ retries }`);\n\n    if (typeof delay === 'number') {\n        invariant(delay >= 0, () => `Retry delay must be a non-negative number but received ${ delay }`);\n    } else {\n        invariant(typeof delay === 'function', () => `Retry delay must be a number or a function but received ${ typeof delay }`);\n    }\n\n    if (when != null) {\n        invariant(Array.isArray(when) || typeof when === 'function', () => `Retry when condition must be an array of status codes or a function but received ${ typeof when }`);\n    }\n\n    if (onRetry != null) {\n        invariant(typeof onRetry === 'function', () => `Retry onRetry callback must be a function but received ${ typeof onRetry }`);\n    }\n\n    return { retries, delay, when, onRetry };\n}\n\n/**\n * Validates and parses a URL string or URL object.\n * In browser environments, relative URLs are resolved against `location.href`.\n * In non-browser environments (Node/Deno/Bun), only absolute URLs are valid.\n *\n * @param url - The URL to validate, either a string or URL object.\n * @returns The parsed URL object.\n * @throws {TypeError} If the URL is invalid or cannot be parsed.\n */\nfunction validateUrl(url: string | URL): URL {\n    if (url instanceof URL) {\n        return url;\n    }\n\n    try {\n        // In browser, use location.href as base for relative URLs\n        // In Node/Deno/Bun, location is undefined, so relative URLs will fail\n        const base = typeof location !== 'undefined' ? location.href : undefined;\n        return new URL(url, base);\n    } catch {\n        throw new TypeError(`Invalid URL: ${ url }`);\n    }\n}\n"],"names":["response","Err","Ok","delay"],"mappings":"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"}
+{"version":3,"file":"main.cjs","sources":["../src/fetch/constants.ts","../src/fetch/defines.ts","../src/fetch/fetch.ts"],"sourcesContent":["/**\n * Error name for aborted fetch requests.\n *\n * This matches the standard `AbortError` name used by the Fetch API when a request\n * is cancelled via `AbortController.abort()`.\n *\n * @example\n * ```typescript\n * import { fetchT, ABORT_ERROR } from '@happy-ts/fetch-t';\n *\n * const task = fetchT('https://api.example.com/data', { abortable: true });\n * task.abort();\n *\n * const result = await task.response;\n * result.inspectErr((err) => {\n *     if (err.name === ABORT_ERROR) {\n *         console.log('Request was aborted');\n *     }\n * });\n * ```\n */\nexport const ABORT_ERROR = 'AbortError' as const;\n\n/**\n * Error name for timed out fetch requests.\n *\n * This is set on the `Error.name` property when a request exceeds the specified\n * `timeout` duration and is automatically aborted.\n *\n * @example\n * ```typescript\n * import { fetchT, TIMEOUT_ERROR } from '@happy-ts/fetch-t';\n *\n * const result = await fetchT('https://api.example.com/slow-endpoint', {\n *     timeout: 5000, // 5 seconds\n * });\n *\n * result.inspectErr((err) => {\n *     if (err.name === TIMEOUT_ERROR) {\n *         console.log('Request timed out after 5 seconds');\n *     }\n * });\n * ```\n */\nexport const TIMEOUT_ERROR = 'TimeoutError' as const;\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { AsyncResult, IOResult } from 'happy-rusty';\n\n/**\n * Union type of all possible fetchT response data types.\n *\n * Used when `responseType` is a dynamic string value rather than a literal type,\n * as the exact return type cannot be determined at compile time.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponseData } from '@happy-ts/fetch-t';\n *\n * // When responseType is dynamic, return type is FetchResponseData\n * const responseType = getResponseType(); // returns string\n * const result = await fetchT('https://api.example.com/data', { responseType });\n * // result is Result<FetchResponseData, Error>\n * ```\n */\nexport type FetchResponseData =\n    | string\n    | ArrayBuffer\n    | Blob\n    | Uint8Array<ArrayBuffer>\n    | ReadableStream<Uint8Array<ArrayBuffer>>\n    | Response\n    | null;\n\n/**\n * Represents the response of a fetch operation as an async Result type.\n *\n * This is an alias for `AsyncResult<T, E>` from the `happy-rusty` library,\n * providing Rust-like error handling without throwing exceptions.\n *\n * @typeParam T - The type of the data expected in a successful response.\n * @typeParam E - The type of the error (defaults to `any`). Typically `Error` or `FetchError`.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponse } from '@happy-ts/fetch-t';\n *\n * // FetchResponse is a Promise that resolves to Result<T, E>\n * const response: FetchResponse<string> = fetchT('https://api.example.com', {\n *     responseType: 'text',\n * });\n *\n * const result = await response;\n * result\n *     .inspect((text) => console.log('Success:', text))\n *     .inspectErr((err) => console.error('Error:', err));\n * ```\n */\nexport type FetchResponse<T, E = any> = AsyncResult<T, E>;\n\n/**\n * Represents an abortable fetch operation with control methods.\n *\n * Returned when `abortable: true` is set in the fetch options. Provides\n * the ability to cancel the request and check its abort status.\n *\n * @typeParam T - The type of the data expected in the response.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchTask } from '@happy-ts/fetch-t';\n *\n * interface User {\n *     id: number;\n *     name: string;\n * }\n *\n * const task: FetchTask<User> = fetchT<User>('https://api.example.com/user/1', {\n *     abortable: true,\n *     responseType: 'json',\n * });\n *\n * // Check if aborted\n * console.log('Is aborted:', task.aborted); // false\n *\n * // Abort with optional reason\n * task.abort('User navigated away');\n *\n * // Access the response (will be an error after abort)\n * const result = await task.response;\n * result.inspectErr((err) => console.log('Aborted:', err.message));\n * ```\n */\nexport interface FetchTask<T> {\n    /**\n     * Aborts the fetch task, optionally with a reason.\n     *\n     * Once aborted, the `response` promise will resolve to an `Err` containing\n     * an `AbortError`. The abort reason can be any value and will be passed\n     * to the underlying `AbortController.abort()`.\n     *\n     * @param reason - An optional value indicating why the task was aborted.\n     *                 This can be an Error, string, or any other value.\n     */\n    abort(reason?: any): void;\n\n    /**\n     * Indicates whether the fetch task has been aborted.\n     *\n     * Returns `true` if `abort()` was called or if the request timed out.\n     */\n    readonly aborted: boolean;\n\n    /**\n     * The response promise of the fetch task.\n     *\n     * Resolves to `Ok<T>` on success, or `Err<Error>` on failure (including abort).\n     */\n    readonly response: FetchResponse<T>;\n}\n\n/**\n * Specifies the expected response type for automatic parsing.\n *\n * - `'text'` - Parse response as string via `Response.text()`\n * - `'json'` - Parse response as JSON via `Response.json()`\n * - `'arraybuffer'` - Parse response as ArrayBuffer via `Response.arrayBuffer()`\n * - `'bytes'` - Parse response as Uint8Array<ArrayBuffer> via `Response.bytes()` (with fallback for older environments)\n * - `'blob'` - Parse response as Blob via `Response.blob()`\n * - `'stream'` - Return the raw `ReadableStream` for streaming processing\n *\n * If not specified, the raw `Response` object is returned.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponseType } from '@happy-ts/fetch-t';\n *\n * const responseType: FetchResponseType = 'json';\n *\n * const result = await fetchT('https://api.example.com/data', { responseType });\n * ```\n */\nexport type FetchResponseType = 'text' | 'arraybuffer' | 'blob' | 'json' | 'bytes' | 'stream';\n\n/**\n * Represents the download progress of a fetch operation.\n *\n * Passed to the `onProgress` callback when tracking download progress.\n * Note: Progress tracking requires the server to send a `Content-Length` header.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchProgress } from '@happy-ts/fetch-t';\n *\n * await fetchT('https://example.com/file.zip', {\n *     responseType: 'blob',\n *     onProgress: (result) => {\n *         result.inspect((progress: FetchProgress) => {\n *             const percent = (progress.completedByteLength / progress.totalByteLength) * 100;\n *             console.log(`Downloaded: ${percent.toFixed(1)}%`);\n *         });\n *     },\n * });\n * ```\n */\nexport interface FetchProgress {\n    /**\n     * The total number of bytes to be received (from Content-Length header).\n     */\n    totalByteLength: number;\n\n    /**\n     * The number of bytes received so far.\n     */\n    completedByteLength: number;\n}\n\n/**\n * Options for configuring retry behavior.\n */\nexport interface FetchRetryOptions {\n    /**\n     * Number of times to retry the request on failure.\n     *\n     * By default, only network errors trigger retries. HTTP errors (4xx, 5xx)\n     * require explicit configuration via `when`.\n     *\n     * @default 0 (no retries)\n     */\n    retries?: number;\n\n    /**\n     * Delay between retry attempts in milliseconds.\n     *\n     * Can be a static number or a function for custom strategies like exponential backoff.\n     * The function receives the current attempt number (1-indexed).\n     *\n     * @default 0 (immediate retry)\n     */\n    delay?: number | ((attempt: number) => number);\n\n    /**\n     * Conditions under which to retry the request.\n     *\n     * Can be an array of HTTP status codes or a custom function.\n     * By default, only network errors (not FetchError) trigger retries.\n     */\n    when?: number[] | ((error: Error, attempt: number) => boolean);\n\n    /**\n     * Callback invoked before each retry attempt.\n     *\n     * Useful for logging, metrics, or adjusting request parameters.\n     */\n    onRetry?: (error: Error, attempt: number) => void;\n}\n\n/**\n * Extended fetch options that add additional capabilities to the standard `RequestInit`.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchInit } from '@happy-ts/fetch-t';\n *\n * const options: FetchInit = {\n *     // Standard RequestInit options\n *     method: 'POST',\n *     headers: { 'Content-Type': 'application/json' },\n *     body: JSON.stringify({ key: 'value' }),\n *\n *     // Extended options\n *     abortable: true,           // Return FetchTask for manual abort control\n *     responseType: 'json',      // Auto-parse response as JSON\n *     timeout: 10000,            // Abort after 10 seconds\n *     onProgress: (result) => {  // Track download progress\n *         result.inspect(({ completedByteLength, totalByteLength }) => {\n *             console.log(`${completedByteLength}/${totalByteLength}`);\n *         });\n *     },\n *     onChunk: (chunk) => {      // Receive raw data chunks\n *         console.log('Received chunk:', chunk.byteLength, 'bytes');\n *     },\n * };\n *\n * const task = fetchT('https://api.example.com/upload', options);\n * ```\n */\nexport interface FetchInit extends RequestInit {\n    /**\n     * When `true`, returns a `FetchTask` instead of `FetchResponse`.\n     *\n     * The `FetchTask` provides `abort()` method and `aborted` status.\n     *\n     * @default false\n     */\n    abortable?: boolean;\n\n    /**\n     * Specifies how the response body should be parsed.\n     *\n     * - `'text'` - Returns `string`\n     * - `'json'` - Returns parsed JSON (type `T`)\n     * - `'arraybuffer'` - Returns `ArrayBuffer`\n     * - `'bytes'` - Returns `Uint8Array<ArrayBuffer>` (with fallback for older environments)\n     * - `'blob'` - Returns `Blob`\n     * - `'stream'` - Returns `ReadableStream<Uint8Array<ArrayBuffer>>`\n     * - `undefined` - Returns raw `Response` object\n     *\n     * When using a dynamic string value (not a literal type), the return type\n     * will be `FetchResponseData` (union of all possible types).\n     */\n    responseType?: FetchResponseType;\n\n    /**\n     * Maximum time in milliseconds to wait for the request to complete.\n     *\n     * If exceeded, the request is automatically aborted with a `TimeoutError`.\n     * Must be a positive number.\n     */\n    timeout?: number;\n\n    /**\n     * Retry options.\n     *\n     * Can be a number (shorthand for retries count) or an options object.\n     *\n     * @example\n     * ```typescript\n     * // Retry up to 3 times on network errors\n     * const result = await fetchT('https://api.example.com/data', {\n     *     retry: 3,\n     * });\n     *\n     * // Detailed configuration\n     * const result = await fetchT('https://api.example.com/data', {\n     *     retry: {\n     *         retries: 3,\n     *         delay: 1000,\n     *         when: [500, 502],\n     *         onRetry: (error, attempt) => console.log(error),\n     *     },\n     * });\n     * ```\n     */\n    retry?: number | FetchRetryOptions;\n\n    /**\n     * Callback invoked during download to report progress.\n     *\n     * Receives an `IOResult<FetchProgress>`:\n     * - `Ok(FetchProgress)` - Progress update with byte counts\n     * - `Err(Error)` - If `Content-Length` header is missing (called once)\n     *\n     * @param progressResult - The progress result, either success with progress data or error.\n     */\n    onProgress?: (progressResult: IOResult<FetchProgress>) => void;\n\n    /**\n     * Callback invoked when a chunk of data is received.\n     *\n     * Useful for streaming or processing data as it arrives.\n     * Each chunk is a `Uint8Array<ArrayBuffer>` containing the raw bytes.\n     *\n     * @param chunk - The raw data chunk received from the response stream.\n     */\n    onChunk?: (chunk: Uint8Array<ArrayBuffer>) => void;\n}\n\n/**\n * Custom error class for HTTP error responses (non-2xx status codes).\n *\n * Thrown when `Response.ok` is `false`. Contains the HTTP status code\n * for programmatic error handling.\n *\n * @example\n * ```typescript\n * import { fetchT, FetchError } from '@happy-ts/fetch-t';\n *\n * const result = await fetchT('https://api.example.com/not-found', {\n *     responseType: 'json',\n * });\n *\n * result.inspectErr((err) => {\n *     if (err instanceof FetchError) {\n *         console.log('HTTP Status:', err.status);  // e.g., 404\n *         console.log('Status Text:', err.message); // e.g., \"Not Found\"\n *\n *         // Handle specific status codes\n *         switch (err.status) {\n *             case 401:\n *                 console.log('Unauthorized - please login');\n *                 break;\n *             case 404:\n *                 console.log('Resource not found');\n *                 break;\n *             case 500:\n *                 console.log('Server error');\n *                 break;\n *         }\n *     }\n * });\n * ```\n */\nexport class FetchError extends Error {\n    /**\n     * The error name, always `'FetchError'`.\n     */\n    override name = 'FetchError';\n\n    /**\n     * The HTTP status code of the response (e.g., 404, 500).\n     */\n    status: number;\n\n    /**\n     * Creates a new FetchError instance.\n     *\n     * @param message - The status text from the HTTP response (e.g., \"Not Found\").\n     * @param status - The HTTP status code (e.g., 404).\n     */\n    constructor(message: string, status: number) {\n        super(message);\n        this.status = status;\n    }\n}\n","import { Err, Ok, type AsyncIOResult } from 'happy-rusty';\nimport { ABORT_ERROR } from './constants.ts';\nimport { FetchError, type FetchInit, type FetchResponse, type FetchResponseData, type FetchResponseType, type FetchRetryOptions, type FetchTask } from './defines.ts';\n\n/**\n * Fetches a resource from the network as a text string and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'text'`.\n * @returns A `FetchTask` representing the abortable operation with a `string` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'text';\n}): FetchTask<string>;\n\n/**\n * Fetches a resource from the network as an ArrayBuffer and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'arraybuffer'`.\n * @returns A `FetchTask` representing the abortable operation with an `ArrayBuffer` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'arraybuffer';\n}): FetchTask<ArrayBuffer>;\n\n/**\n * Fetches a resource from the network as a Blob and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'blob'`.\n * @returns A `FetchTask` representing the abortable operation with a `Blob` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'blob';\n}): FetchTask<Blob>;\n\n/**\n * Fetches a resource from the network and parses it as JSON, returning an abortable `FetchTask`.\n *\n * @typeParam T - The expected type of the parsed JSON data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'json'`.\n * @returns A `FetchTask` representing the abortable operation with a response parsed as type `T`.\n */\nexport function fetchT<T>(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'json';\n}): FetchTask<T | null>;\n\n/**\n * Fetches a resource from the network as a ReadableStream and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'stream'`.\n * @returns A `FetchTask` representing the abortable operation with a `ReadableStream<Uint8Array<ArrayBuffer>>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'stream';\n}): FetchTask<ReadableStream<Uint8Array<ArrayBuffer>> | null>;\n\n/**\n * Fetches a resource from the network as a Uint8Array<ArrayBuffer> and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'bytes'`.\n * @returns A `FetchTask` representing the abortable operation with a `Uint8Array<ArrayBuffer>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'bytes';\n}): FetchTask<Uint8Array<ArrayBuffer>>;\n\n/**\n * Fetches a resource from the network and returns an abortable `FetchTask` with a dynamic response type.\n *\n * Use this overload when `responseType` is a `FetchResponseType` union type.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and a `FetchResponseType`.\n * @returns A `FetchTask` representing the abortable operation with a `FetchResponseData` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: FetchResponseType;\n}): FetchTask<FetchResponseData>;\n\n/**\n * Fetches a resource from the network as a text string.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'text'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `string` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'text';\n}): FetchResponse<string, Error>;\n\n/**\n * Fetches a resource from the network as an ArrayBuffer.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'arraybuffer'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with an `ArrayBuffer` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'arraybuffer';\n}): FetchResponse<ArrayBuffer, Error>;\n\n/**\n * Fetches a resource from the network as a Blob.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'blob'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Blob` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'blob';\n}): FetchResponse<Blob, Error>;\n\n/**\n * Fetches a resource from the network and parses it as JSON.\n *\n * @typeParam T - The expected type of the parsed JSON data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'json'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a response parsed as type `T`.\n */\nexport function fetchT<T>(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'json';\n}): FetchResponse<T | null, Error>;\n\n/**\n * Fetches a resource from the network as a ReadableStream.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'stream'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `ReadableStream<Uint8Array<ArrayBuffer>>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'stream';\n}): FetchResponse<ReadableStream<Uint8Array<ArrayBuffer>> | null, Error>;\n\n/**\n * Fetches a resource from the network as a Uint8Array<ArrayBuffer>.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'bytes'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Uint8Array<ArrayBuffer>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'bytes';\n}): FetchResponse<Uint8Array<ArrayBuffer>, Error>;\n\n/**\n * Fetches a resource from the network with a dynamic response type (non-abortable).\n *\n * Use this overload when `responseType` is a `FetchResponseType` union type.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation with a `FetchResponseType`, and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `FetchResponseData` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: FetchResponseType;\n}): FetchResponse<FetchResponseData, Error>;\n\n/**\n * Fetches a resource from the network and returns an abortable `FetchTask` with a generic `Response`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true`.\n * @returns A `FetchTask` representing the abortable operation with a `Response` object.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n}): FetchTask<Response>;\n\n/**\n * Fetches a resource from the network and returns a `FetchResponse` with a generic `Response` object.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Optional additional options for the fetch operation, and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Response` object.\n */\nexport function fetchT(url: string | URL, init?: FetchInit & {\n    abortable?: false;\n}): FetchResponse<Response>;\n\n/**\n * Enhanced fetch function that wraps the native Fetch API with additional capabilities.\n *\n * Features:\n * - **Abortable requests**: Set `abortable: true` to get a `FetchTask` with `abort()` method.\n * - **Type-safe responses**: Use `responseType` to automatically parse responses as text, JSON, ArrayBuffer, or Blob.\n * - **Timeout support**: Set `timeout` in milliseconds to auto-abort long-running requests.\n * - **Progress tracking**: Use `onProgress` callback to track download progress (requires Content-Length header).\n * - **Chunk streaming**: Use `onChunk` callback to receive raw data chunks as they arrive.\n * - **Retry support**: Use `retry` to automatically retry failed requests with configurable delay and conditions.\n * - **Result type error handling**: Returns `Result<T, Error>` instead of throwing exceptions.\n *\n * @typeParam T - The expected type of the response data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, extending standard `RequestInit` with custom properties.\n * @returns A `FetchTask<T>` if `abortable: true`, otherwise a `FetchResponse<T>` (which is `AsyncResult<T, Error>`).\n * @throws {Error} If `url` is not a string or URL object.\n * @throws {Error} If `timeout` is specified but is not a positive number.\n *\n * @example\n * // Basic GET request - returns Response object wrapped in Result\n * const result = await fetchT('https://api.example.com/data');\n * result\n *     .inspect((res) => console.log('Status:', res.status))\n *     .inspectErr((err) => console.error('Error:', err));\n *\n * @example\n * // GET JSON with type safety\n * interface User {\n *     id: number;\n *     name: string;\n * }\n * const result = await fetchT<User>('https://api.example.com/user/1', {\n *     responseType: 'json',\n * });\n * result.inspect((user) => console.log(user.name));\n *\n * @example\n * // POST request with JSON body\n * const result = await fetchT<User>('https://api.example.com/users', {\n *     method: 'POST',\n *     headers: { 'Content-Type': 'application/json' },\n *     body: JSON.stringify({ name: 'John' }),\n *     responseType: 'json',\n * });\n *\n * @example\n * // Abortable request with timeout\n * const task = fetchT('https://api.example.com/data', {\n *     abortable: true,\n *     timeout: 5000, // 5 seconds\n * });\n *\n * // Cancel the request if needed\n * task.abort('User cancelled');\n *\n * // Check if aborted\n * console.log('Aborted:', task.aborted);\n *\n * // Wait for response\n * const result = await task.response;\n *\n * @example\n * // Track download progress\n * const result = await fetchT('https://example.com/large-file.zip', {\n *     responseType: 'blob',\n *     onProgress: (progressResult) => {\n *         progressResult\n *             .inspect(({ completedByteLength, totalByteLength }) => {\n *                 const percent = ((completedByteLength / totalByteLength) * 100).toFixed(1);\n *                 console.log(`Progress: ${percent}%`);\n *             })\n *             .inspectErr((err) => console.warn('Progress unavailable:', err.message));\n *     },\n * });\n *\n * @example\n * // Stream data chunks\n * const chunks: Uint8Array[] = [];\n * const result = await fetchT('https://example.com/stream', {\n *     onChunk: (chunk) => chunks.push(chunk),\n * });\n *\n * @example\n * // Retry with exponential backoff\n * const result = await fetchT('https://api.example.com/data', {\n *     retry: {\n *         retries: 3,\n *         delay: (attempt) => Math.min(1000 * Math.pow(2, attempt - 1), 10000),\n *         when: [500, 502, 503, 504],\n *         onRetry: (error, attempt) => console.log(`Retry ${attempt}: ${error.message}`),\n *     },\n *     responseType: 'json',\n * });\n */\nexport function fetchT(url: string | URL, init?: FetchInit): FetchTask<FetchResponseData> | FetchResponse<FetchResponseData> {\n    // Validate and parse URL\n    const parsedUrl = validateUrl(url);\n\n    const fetchInit = init ?? {};\n\n    const {\n        retries,\n        delay: retryDelay,\n        when: retryWhen,\n        onRetry,\n    } = validateOptions(fetchInit);\n\n    const {\n        // default not abortable\n        abortable = false,\n        responseType,\n        timeout,\n        onProgress,\n        onChunk,\n        ...rest\n    } = fetchInit;\n\n    // Preserve user's original signal before modifications (rest.signal will be reassigned in setSignal)\n    const userSignal = rest.signal;\n\n    // User controller for manual abort (stops all retries)\n    let userController: AbortController | undefined;\n    if (abortable) {\n        userController = new AbortController();\n    }\n\n    /**\n     * Determines if the error should trigger a retry.\n     * By default, only network errors (not FetchError) trigger retries.\n     */\n    const shouldRetry = (error: Error, attempt: number): boolean => {\n        // Never retry on user abort\n        if (error.name === ABORT_ERROR) {\n            return false;\n        }\n\n        if (!retryWhen) {\n            // Default: only retry on network errors (not FetchError/HTTP errors)\n            return !(error instanceof FetchError);\n        }\n\n        if (Array.isArray(retryWhen)) {\n            // Retry on specific HTTP status codes\n            return error instanceof FetchError && retryWhen.includes(error.status);\n        }\n\n        // Custom retry condition\n        return retryWhen(error, attempt);\n    };\n\n    /**\n     * Calculates the delay before the next retry attempt.\n     */\n    const getRetryDelay = (attempt: number): number => {\n        return typeof retryDelay === 'function'\n            ? retryDelay(attempt)\n            : retryDelay;\n    };\n\n    /**\n     * Configures the abort signal for a fetch attempt.\n     *\n     * Combines multiple signals:\n     * - User's external signal (from init.signal)\n     * - Internal abort controller signal (for abortable requests)\n     * - Timeout signal (creates a new one each call for per-attempt timeout)\n     *\n     * Must be called before each fetch attempt to ensure fresh timeout signal on retries.\n     */\n    const configureSignal = (): void => {\n        const signals: AbortSignal[] = [];\n\n        // Merge user's signal from init (if provided)\n        if (userSignal) {\n            signals.push(userSignal);\n        }\n\n        if (userController) {\n            signals.push(userController.signal);\n        }\n\n        if (typeof timeout === 'number') {\n            signals.push(AbortSignal.timeout(timeout));\n        }\n\n        // Combine all signals\n        if (signals.length > 0) {\n            rest.signal = signals.length === 1\n                ? signals[0]\n                : AbortSignal.any(signals);\n        }\n    };\n\n    /**\n     * Performs a single fetch attempt with optional timeout.\n     */\n    const doFetch = async (): AsyncIOResult<FetchResponseData> => {\n        configureSignal();\n\n        try {\n            const response = await fetch(parsedUrl, rest);\n\n            if (!response.ok) {\n                // Cancel the response body to free resources\n                response.body?.cancel().catch(() => {\n                    // Silently ignore stream cancel errors\n                });\n                return Err(new FetchError(response.statusText, response.status));\n            }\n\n            return await processResponse(response);\n        } catch (err) {\n            return Err(err instanceof Error\n                ? err\n                // Non-Error type, most likely an abort reason\n                : wrapAbortReason(err),\n            );\n        }\n    };\n\n    /**\n     * Sets up progress tracking and chunk callbacks using a cloned response.\n     * The original response is returned unchanged for further processing.\n     */\n    const setupProgressCallbacks = async (response: Response): Promise<void> => {\n        let totalByteLength: number | undefined;\n        let completedByteLength = 0;\n\n        if (onProgress) {\n            const contentLength = response.headers.get('content-length');\n            if (contentLength == null) {\n                try {\n                    onProgress(Err(new Error('No content-length in response headers')));\n                } catch {\n                    // Silently ignore user callback errors\n                }\n            } else {\n                totalByteLength = Number.parseInt(contentLength, 10);\n            }\n        }\n\n        const body = response.clone().body as ReadableStream<Uint8Array<ArrayBuffer>>;\n\n        try {\n            for await (const chunk of body) {\n                if (onChunk) {\n                    try {\n                        onChunk(chunk);\n                    } catch {\n                        // Silently ignore user callback errors\n                    }\n                }\n\n                if (onProgress && totalByteLength != null) {\n                    completedByteLength += chunk.byteLength;\n                    try {\n                        onProgress(Ok({\n                            totalByteLength,\n                            completedByteLength,\n                        }));\n                    } catch {\n                        // Silently ignore user callback errors\n                    }\n                }\n            }\n        } catch {\n            // Silently ignore stream read errors\n        }\n    };\n\n    /**\n     * Processes the response based on responseType and callbacks.\n     */\n    const processResponse = async (response: Response): AsyncIOResult<FetchResponseData> => {\n        // Setup progress/chunk callbacks if needed (uses cloned response internally)\n        if (response.body && (onProgress || onChunk)) {\n            setupProgressCallbacks(response);\n        }\n\n        switch (responseType) {\n            case 'json': {\n                // Align with stream behavior: no body yields Ok(null)\n                if (response.body == null) {\n                    return Ok(null);\n                }\n                try {\n                    return Ok(await response.json());\n                } catch {\n                    return Err(new Error('Response is invalid json while responseType is json'));\n                }\n            }\n            case 'text': {\n                return Ok(await response.text());\n            }\n            case 'bytes': {\n                // Use native bytes() if available, otherwise fallback to arrayBuffer()\n                if (typeof response.bytes === 'function') {\n                    return Ok(await response.bytes());\n                }\n                // Fallback for older environments\n                return Ok(new Uint8Array(await response.arrayBuffer()));\n            }\n            case 'arraybuffer': {\n                return Ok(await response.arrayBuffer());\n            }\n            case 'blob': {\n                return Ok(await response.blob());\n            }\n            case 'stream': {\n                return Ok(response.body);\n            }\n            default: {\n                // default return the original Response object to preserve all metadata\n                return Ok(response);\n            }\n        }\n    };\n\n    /**\n     * Performs fetch with retry logic.\n     */\n    const fetchWithRetry = async (): FetchResponse<FetchResponseData, Error> => {\n        let lastError: Error | undefined;\n        let attempt = 0;\n\n        do {\n            // Before retry (not first attempt), wait for delay\n            if (attempt > 0) {\n                // Check if user aborted before delay (e.g., aborted in `when` callback)\n                if (userController?.signal.aborted) {\n                    return Err(userController.signal.reason as Error);\n                }\n\n                const delayMs = getRetryDelay(attempt);\n                // Wait for delay if necessary\n                if (delayMs > 0) {\n                    await delay(delayMs);\n\n                    // Check if user aborted during delay\n                    if (userController?.signal.aborted) {\n                        return Err(userController.signal.reason as Error);\n                    }\n                }\n\n                // Call onRetry right before the actual retry request\n                try {\n                    onRetry?.(lastError as Error, attempt);\n                } catch {\n                    // Silently ignore user callback errors\n                }\n            }\n\n            const result = await doFetch();\n\n            if (result.isOk()) {\n                return result;\n            }\n\n            lastError = result.unwrapErr();\n            attempt++;\n\n            // Check if we should retry\n        } while (attempt <= retries && shouldRetry(lastError, attempt));\n\n        // No more retries or should not retry\n        // lastError is guaranteed to be defined here because:\n        // 1. do...while loop executes at least once\n        // 2. We only reach here if result.isErr()\n        return Err(lastError);\n    };\n\n    const response = fetchWithRetry();\n\n    if (abortable && userController) {\n        return {\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            abort(reason?: any): void {\n                if (reason instanceof Error) {\n                    userController.abort(reason);\n                } else if (reason != null) {\n                    userController.abort(wrapAbortReason(reason));\n                } else {\n                    userController.abort();\n                }\n            },\n\n            get aborted(): boolean {\n                return userController.signal.aborted;\n            },\n\n            get response(): FetchResponse<FetchResponseData> {\n                return response;\n            },\n        };\n    }\n\n    return response;\n}\n\n/**\n * Delays execution for the specified number of milliseconds.\n */\nfunction delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Wraps a non-Error abort reason into an Error with ABORT_ERROR name.\n */\nfunction wrapAbortReason(reason: unknown): Error {\n    const error = new Error(typeof reason === 'string' ? reason : String(reason));\n    error.name = ABORT_ERROR;\n    error.cause = reason;\n    return error;\n}\n\ninterface ParsedRetryOptions extends FetchRetryOptions {\n    retries: number;\n    delay: number | ((attempt: number) => number);\n}\n\n/**\n * Validates fetch options and parses retry configuration.\n */\nfunction validateOptions(init: FetchInit): ParsedRetryOptions {\n    const {\n        responseType,\n        timeout,\n        retry: retryOptions = 0,\n        onProgress,\n        onChunk,\n    } = init;\n\n    if (responseType != null) {\n        const validTypes = ['text', 'arraybuffer', 'blob', 'json', 'bytes', 'stream'];\n        if (!validTypes.includes(responseType)) {\n            throw new TypeError(`responseType must be one of ${ validTypes.join(', ') } but received ${ responseType }`);\n        }\n    }\n\n    if (timeout != null) {\n        if (typeof timeout !== 'number') {\n            throw new TypeError(`timeout must be a number but received ${ typeof timeout }`);\n        }\n        if (timeout <= 0) {\n            throw new Error(`timeout must be a number greater than 0 but received ${ timeout }`);\n        }\n    }\n\n    if (onProgress != null) {\n        if (typeof onProgress !== 'function') {\n            throw new TypeError(`onProgress callback must be a function but received ${ typeof onProgress }`);\n        }\n    }\n\n    if (onChunk != null) {\n        if (typeof onChunk !== 'function') {\n            throw new TypeError(`onChunk callback must be a function but received ${ typeof onChunk }`);\n        }\n    }\n\n    // Parse retry options\n    let retries = 0;\n    let delay: number | ((attempt: number) => number) = 0;\n    let when: ((error: Error, attempt: number) => boolean) | number[] | undefined;\n    let onRetry: ((error: Error, attempt: number) => void) | undefined;\n\n    if (typeof retryOptions === 'number') {\n        retries = retryOptions;\n    } else if (retryOptions && typeof retryOptions === 'object') {\n        retries = retryOptions.retries ?? 0;\n        delay = retryOptions.delay ?? 0;\n        when = retryOptions.when;\n        onRetry = retryOptions.onRetry;\n    }\n\n    if (!Number.isInteger(retries)) {\n        throw new TypeError(`Retry count must be an integer but received ${ retries }`);\n    }\n    if (retries < 0) {\n        throw new Error(`Retry count must be non-negative but received ${ retries }`);\n    }\n\n    if (typeof delay === 'number') {\n        if (delay < 0) {\n            throw new Error(`Retry delay must be a non-negative number but received ${ delay }`);\n        }\n    } else {\n        if (typeof delay !== 'function') {\n            throw new TypeError(`Retry delay must be a number or a function but received ${ typeof delay }`);\n        }\n    }\n\n    if (when != null) {\n        if (!Array.isArray(when) && typeof when !== 'function') {\n            throw new TypeError(`Retry when condition must be an array of status codes or a function but received ${ typeof when }`);\n        }\n    }\n\n    if (onRetry != null) {\n        if (typeof onRetry !== 'function') {\n            throw new TypeError(`Retry onRetry callback must be a function but received ${ typeof onRetry }`);\n        }\n    }\n\n    return { retries, delay, when, onRetry };\n}\n\n/**\n * Validates and parses a URL string or URL object.\n * In browser environments, relative URLs are resolved against `location.href`.\n * In non-browser environments (Node/Deno/Bun), only absolute URLs are valid.\n *\n * @param url - The URL to validate, either a string or URL object.\n * @returns The parsed URL object.\n * @throws {TypeError} If the URL is invalid or cannot be parsed.\n */\nfunction validateUrl(url: string | URL): URL {\n    if (url instanceof URL) {\n        return url;\n    }\n\n    try {\n        // In browser, use location.href as base for relative URLs\n        // In Node/Deno/Bun, location is undefined, so relative URLs will fail\n        const base = typeof location !== 'undefined' ? location.href : undefined;\n        return new URL(url, base);\n    } catch {\n        throw new TypeError(`Invalid URL: ${ url }`);\n    }\n}\n"],"names":["response","Err","Ok","delay"],"mappings":";;;;;;AAqBO,MAAM,WAAA,GAAc;AAuBpB,MAAM,aAAA,GAAgB;;ACyTtB,MAAM,mBAAmB,KAAA,CAAM;AAAA;AAAA;AAAA;AAAA,EAIzB,IAAA,GAAO,YAAA;AAAA;AAAA;AAAA;AAAA,EAKhB,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,WAAA,CAAY,SAAiB,MAAA,EAAgB;AACzC,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAClB;AACJ;;ACnFO,SAAS,MAAA,CAAO,KAAmB,IAAA,EAAmF;AAEzH,EAAA,MAAM,SAAA,GAAY,YAAY,GAAG,CAAA;AAEjC,EAAA,MAAM,SAAA,GAAY,QAAQ,EAAC;AAE3B,EAAA,MAAM;AAAA,IACF,OAAA;AAAA,IACA,KAAA,EAAO,UAAA;AAAA,IACP,IAAA,EAAM,SAAA;AAAA,IACN;AAAA,GACJ,GAAI,gBAAgB,SAAS,CAAA;AAE7B,EAAA,MAAM;AAAA;AAAA,IAEF,SAAA,GAAY,KAAA;AAAA,IACZ,YAAA;AAAA,IACA,OAAA;AAAA,IACA,UAAA;AAAA,IACA,OAAA;AAAA,IACA,GAAG;AAAA,GACP,GAAI,SAAA;AAGJ,EAAA,MAAM,aAAa,IAAA,CAAK,MAAA;AAGxB,EAAA,IAAI,cAAA;AACJ,EAAA,IAAI,SAAA,EAAW;AACX,IAAA,cAAA,GAAiB,IAAI,eAAA,EAAgB;AAAA,EACzC;AAMA,EAAA,MAAM,WAAA,GAAc,CAAC,KAAA,EAAc,OAAA,KAA6B;AAE5D,IAAA,IAAI,KAAA,CAAM,SAAS,WAAA,EAAa;AAC5B,MAAA,OAAO,KAAA;AAAA,IACX;AAEA,IAAA,IAAI,CAAC,SAAA,EAAW;AAEZ,MAAA,OAAO,EAAE,KAAA,YAAiB,UAAA,CAAA;AAAA,IAC9B;AAEA,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,SAAS,CAAA,EAAG;AAE1B,MAAA,OAAO,KAAA,YAAiB,UAAA,IAAc,SAAA,CAAU,QAAA,CAAS,MAAM,MAAM,CAAA;AAAA,IACzE;AAGA,IAAA,OAAO,SAAA,CAAU,OAAO,OAAO,CAAA;AAAA,EACnC,CAAA;AAKA,EAAA,MAAM,aAAA,GAAgB,CAAC,OAAA,KAA4B;AAC/C,IAAA,OAAO,OAAO,UAAA,KAAe,UAAA,GACvB,UAAA,CAAW,OAAO,CAAA,GAClB,UAAA;AAAA,EACV,CAAA;AAYA,EAAA,MAAM,kBAAkB,MAAY;AAChC,IAAA,MAAM,UAAyB,EAAC;AAGhC,IAAA,IAAI,UAAA,EAAY;AACZ,MAAA,OAAA,CAAQ,KAAK,UAAU,CAAA;AAAA,IAC3B;AAEA,IAAA,IAAI,cAAA,EAAgB;AAChB,MAAA,OAAA,CAAQ,IAAA,CAAK,eAAe,MAAM,CAAA;AAAA,IACtC;AAEA,IAAA,IAAI,OAAO,YAAY,QAAA,EAAU;AAC7B,MAAA,OAAA,CAAQ,IAAA,CAAK,WAAA,CAAY,OAAA,CAAQ,OAAO,CAAC,CAAA;AAAA,IAC7C;AAGA,IAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACpB,MAAA,IAAA,CAAK,MAAA,GAAS,QAAQ,MAAA,KAAW,CAAA,GAC3B,QAAQ,CAAC,CAAA,GACT,WAAA,CAAY,GAAA,CAAI,OAAO,CAAA;AAAA,IACjC;AAAA,EACJ,CAAA;AAKA,EAAA,MAAM,UAAU,YAA8C;AAC1D,IAAA,eAAA,EAAgB;AAEhB,IAAA,IAAI;AACA,MAAA,MAAMA,SAAAA,GAAW,MAAM,KAAA,CAAM,SAAA,EAAW,IAAI,CAAA;AAE5C,MAAA,IAAI,CAACA,UAAS,EAAA,EAAI;AAEd,QAAAA,SAAAA,CAAS,IAAA,EAAM,MAAA,EAAO,CAAE,MAAM,MAAM;AAAA,QAEpC,CAAC,CAAA;AACD,QAAA,OAAOC,eAAI,IAAI,UAAA,CAAWD,UAAS,UAAA,EAAYA,SAAAA,CAAS,MAAM,CAAC,CAAA;AAAA,MACnE;AAEA,MAAA,OAAO,MAAM,gBAAgBA,SAAQ,CAAA;AAAA,IACzC,SAAS,GAAA,EAAK;AACV,MAAA,OAAOC,cAAA;AAAA,QAAI,GAAA,YAAe,KAAA,GACpB,GAAA,GAEA,eAAA,CAAgB,GAAG;AAAA,OACzB;AAAA,IACJ;AAAA,EACJ,CAAA;AAMA,EAAA,MAAM,sBAAA,GAAyB,OAAOD,SAAAA,KAAsC;AACxE,IAAA,IAAI,eAAA;AACJ,IAAA,IAAI,mBAAA,GAAsB,CAAA;AAE1B,IAAA,IAAI,UAAA,EAAY;AACZ,MAAA,MAAM,aAAA,GAAgBA,SAAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,gBAAgB,CAAA;AAC3D,MAAA,IAAI,iBAAiB,IAAA,EAAM;AACvB,QAAA,IAAI;AACA,UAAA,UAAA,CAAWC,cAAA,CAAI,IAAI,KAAA,CAAM,uCAAuC,CAAC,CAAC,CAAA;AAAA,QACtE,CAAA,CAAA,MAAQ;AAAA,QAER;AAAA,MACJ,CAAA,MAAO;AACH,QAAA,eAAA,GAAkB,MAAA,CAAO,QAAA,CAAS,aAAA,EAAe,EAAE,CAAA;AAAA,MACvD;AAAA,IACJ;AAEA,IAAA,MAAM,IAAA,GAAOD,SAAAA,CAAS,KAAA,EAAM,CAAE,IAAA;AAE9B,IAAA,IAAI;AACA,MAAA,WAAA,MAAiB,SAAS,IAAA,EAAM;AAC5B,QAAA,IAAI,OAAA,EAAS;AACT,UAAA,IAAI;AACA,YAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,UACjB,CAAA,CAAA,MAAQ;AAAA,UAER;AAAA,QACJ;AAEA,QAAA,IAAI,UAAA,IAAc,mBAAmB,IAAA,EAAM;AACvC,UAAA,mBAAA,IAAuB,KAAA,CAAM,UAAA;AAC7B,UAAA,IAAI;AACA,YAAA,UAAA,CAAWE,aAAA,CAAG;AAAA,cACV,eAAA;AAAA,cACA;AAAA,aACH,CAAC,CAAA;AAAA,UACN,CAAA,CAAA,MAAQ;AAAA,UAER;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACJ,CAAA;AAKA,EAAA,MAAM,eAAA,GAAkB,OAAOF,SAAAA,KAAyD;AAEpF,IAAA,IAAIA,SAAAA,CAAS,IAAA,KAAS,UAAA,IAAc,OAAA,CAAA,EAAU;AAC1C,MAAA,sBAAA,CAAuBA,SAAQ,CAAA;AAAA,IACnC;AAEA,IAAA,QAAQ,YAAA;AAAc,MAClB,KAAK,MAAA,EAAQ;AAET,QAAA,IAAIA,SAAAA,CAAS,QAAQ,IAAA,EAAM;AACvB,UAAA,OAAOE,cAAG,IAAI,CAAA;AAAA,QAClB;AACA,QAAA,IAAI;AACA,UAAA,OAAOA,aAAA,CAAG,MAAMF,SAAAA,CAAS,IAAA,EAAM,CAAA;AAAA,QACnC,CAAA,CAAA,MAAQ;AACJ,UAAA,OAAOC,cAAA,CAAI,IAAI,KAAA,CAAM,qDAAqD,CAAC,CAAA;AAAA,QAC/E;AAAA,MACJ;AAAA,MACA,KAAK,MAAA,EAAQ;AACT,QAAA,OAAOC,aAAA,CAAG,MAAMF,SAAAA,CAAS,IAAA,EAAM,CAAA;AAAA,MACnC;AAAA,MACA,KAAK,OAAA,EAAS;AAEV,QAAA,IAAI,OAAOA,SAAAA,CAAS,KAAA,KAAU,UAAA,EAAY;AACtC,UAAA,OAAOE,aAAA,CAAG,MAAMF,SAAAA,CAAS,KAAA,EAAO,CAAA;AAAA,QACpC;AAEA,QAAA,OAAOE,cAAG,IAAI,UAAA,CAAW,MAAMF,SAAAA,CAAS,WAAA,EAAa,CAAC,CAAA;AAAA,MAC1D;AAAA,MACA,KAAK,aAAA,EAAe;AAChB,QAAA,OAAOE,aAAA,CAAG,MAAMF,SAAAA,CAAS,WAAA,EAAa,CAAA;AAAA,MAC1C;AAAA,MACA,KAAK,MAAA,EAAQ;AACT,QAAA,OAAOE,aAAA,CAAG,MAAMF,SAAAA,CAAS,IAAA,EAAM,CAAA;AAAA,MACnC;AAAA,MACA,KAAK,QAAA,EAAU;AACX,QAAA,OAAOE,aAAA,CAAGF,UAAS,IAAI,CAAA;AAAA,MAC3B;AAAA,MACA,SAAS;AAEL,QAAA,OAAOE,cAAGF,SAAQ,CAAA;AAAA,MACtB;AAAA;AACJ,EACJ,CAAA;AAKA,EAAA,MAAM,iBAAiB,YAAqD;AACxE,IAAA,IAAI,SAAA;AACJ,IAAA,IAAI,OAAA,GAAU,CAAA;AAEd,IAAA,GAAG;AAEC,MAAA,IAAI,UAAU,CAAA,EAAG;AAEb,QAAA,IAAI,cAAA,EAAgB,OAAO,OAAA,EAAS;AAChC,UAAA,OAAOC,cAAA,CAAI,cAAA,CAAe,MAAA,CAAO,MAAe,CAAA;AAAA,QACpD;AAEA,QAAA,MAAM,OAAA,GAAU,cAAc,OAAO,CAAA;AAErC,QAAA,IAAI,UAAU,CAAA,EAAG;AACb,UAAA,MAAM,MAAM,OAAO,CAAA;AAGnB,UAAA,IAAI,cAAA,EAAgB,OAAO,OAAA,EAAS;AAChC,YAAA,OAAOA,cAAA,CAAI,cAAA,CAAe,MAAA,CAAO,MAAe,CAAA;AAAA,UACpD;AAAA,QACJ;AAGA,QAAA,IAAI;AACA,UAAA,OAAA,GAAU,WAAoB,OAAO,CAAA;AAAA,QACzC,CAAA,CAAA,MAAQ;AAAA,QAER;AAAA,MACJ;AAEA,MAAA,MAAM,MAAA,GAAS,MAAM,OAAA,EAAQ;AAE7B,MAAA,IAAI,MAAA,CAAO,MAAK,EAAG;AACf,QAAA,OAAO,MAAA;AAAA,MACX;AAEA,MAAA,SAAA,GAAY,OAAO,SAAA,EAAU;AAC7B,MAAA,OAAA,EAAA;AAAA,IAGJ,CAAA,QAAS,OAAA,IAAW,OAAA,IAAW,WAAA,CAAY,WAAW,OAAO,CAAA;AAM7D,IAAA,OAAOA,eAAI,SAAS,CAAA;AAAA,EACxB,CAAA;AAEA,EAAA,MAAM,WAAW,cAAA,EAAe;AAEhC,EAAA,IAAI,aAAa,cAAA,EAAgB;AAC7B,IAAA,OAAO;AAAA;AAAA,MAEH,MAAM,MAAA,EAAoB;AACtB,QAAA,IAAI,kBAAkB,KAAA,EAAO;AACzB,UAAA,cAAA,CAAe,MAAM,MAAM,CAAA;AAAA,QAC/B,CAAA,MAAA,IAAW,UAAU,IAAA,EAAM;AACvB,UAAA,cAAA,CAAe,KAAA,CAAM,eAAA,CAAgB,MAAM,CAAC,CAAA;AAAA,QAChD,CAAA,MAAO;AACH,UAAA,cAAA,CAAe,KAAA,EAAM;AAAA,QACzB;AAAA,MACJ,CAAA;AAAA,MAEA,IAAI,OAAA,GAAmB;AACnB,QAAA,OAAO,eAAe,MAAA,CAAO,OAAA;AAAA,MACjC,CAAA;AAAA,MAEA,IAAI,QAAA,GAA6C;AAC7C,QAAA,OAAO,QAAA;AAAA,MACX;AAAA,KACJ;AAAA,EACJ;AAEA,EAAA,OAAO,QAAA;AACX;AAKA,SAAS,MAAM,EAAA,EAA2B;AACtC,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAA,OAAA,KAAW,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AACzD;AAKA,SAAS,gBAAgB,MAAA,EAAwB;AAC7C,EAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,WAAW,QAAA,GAAW,MAAA,GAAS,MAAA,CAAO,MAAM,CAAC,CAAA;AAC5E,EAAA,KAAA,CAAM,IAAA,GAAO,WAAA;AACb,EAAA,KAAA,CAAM,KAAA,GAAQ,MAAA;AACd,EAAA,OAAO,KAAA;AACX;AAUA,SAAS,gBAAgB,IAAA,EAAqC;AAC1D,EAAA,MAAM;AAAA,IACF,YAAA;AAAA,IACA,OAAA;AAAA,IACA,OAAO,YAAA,GAAe,CAAA;AAAA,IACtB,UAAA;AAAA,IACA;AAAA,GACJ,GAAI,IAAA;AAEJ,EAAA,IAAI,gBAAgB,IAAA,EAAM;AACtB,IAAA,MAAM,aAAa,CAAC,MAAA,EAAQ,eAAe,MAAA,EAAQ,MAAA,EAAQ,SAAS,QAAQ,CAAA;AAC5E,IAAA,IAAI,CAAC,UAAA,CAAW,QAAA,CAAS,YAAY,CAAA,EAAG;AACpC,MAAA,MAAM,IAAI,UAAU,CAAA,4BAAA,EAAgC,UAAA,CAAW,KAAK,IAAI,CAAE,CAAA,cAAA,EAAkB,YAAa,CAAA,CAAE,CAAA;AAAA,IAC/G;AAAA,EACJ;AAEA,EAAA,IAAI,WAAW,IAAA,EAAM;AACjB,IAAA,IAAI,OAAO,YAAY,QAAA,EAAU;AAC7B,MAAA,MAAM,IAAI,SAAA,CAAU,CAAA,sCAAA,EAA0C,OAAO,OAAQ,CAAA,CAAE,CAAA;AAAA,IACnF;AACA,IAAA,IAAI,WAAW,CAAA,EAAG;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,qDAAA,EAAyD,OAAQ,CAAA,CAAE,CAAA;AAAA,IACvF;AAAA,EACJ;AAEA,EAAA,IAAI,cAAc,IAAA,EAAM;AACpB,IAAA,IAAI,OAAO,eAAe,UAAA,EAAY;AAClC,MAAA,MAAM,IAAI,SAAA,CAAU,CAAA,oDAAA,EAAwD,OAAO,UAAW,CAAA,CAAE,CAAA;AAAA,IACpG;AAAA,EACJ;AAEA,EAAA,IAAI,WAAW,IAAA,EAAM;AACjB,IAAA,IAAI,OAAO,YAAY,UAAA,EAAY;AAC/B,MAAA,MAAM,IAAI,SAAA,CAAU,CAAA,iDAAA,EAAqD,OAAO,OAAQ,CAAA,CAAE,CAAA;AAAA,IAC9F;AAAA,EACJ;AAGA,EAAA,IAAI,OAAA,GAAU,CAAA;AACd,EAAA,IAAIE,MAAAA,GAAgD,CAAA;AACpD,EAAA,IAAI,IAAA;AACJ,EAAA,IAAI,OAAA;AAEJ,EAAA,IAAI,OAAO,iBAAiB,QAAA,EAAU;AAClC,IAAA,OAAA,GAAU,YAAA;AAAA,EACd,CAAA,MAAA,IAAW,YAAA,IAAgB,OAAO,YAAA,KAAiB,QAAA,EAAU;AACzD,IAAA,OAAA,GAAU,aAAa,OAAA,IAAW,CAAA;AAClC,IAAAA,MAAAA,GAAQ,aAAa,KAAA,IAAS,CAAA;AAC9B,IAAA,IAAA,GAAO,YAAA,CAAa,IAAA;AACpB,IAAA,OAAA,GAAU,YAAA,CAAa,OAAA;AAAA,EAC3B;AAEA,EAAA,IAAI,CAAC,MAAA,CAAO,SAAA,CAAU,OAAO,CAAA,EAAG;AAC5B,IAAA,MAAM,IAAI,SAAA,CAAU,CAAA,4CAAA,EAAgD,OAAQ,CAAA,CAAE,CAAA;AAAA,EAClF;AACA,EAAA,IAAI,UAAU,CAAA,EAAG;AACb,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,8CAAA,EAAkD,OAAQ,CAAA,CAAE,CAAA;AAAA,EAChF;AAEA,EAAA,IAAI,OAAOA,WAAU,QAAA,EAAU;AAC3B,IAAA,IAAIA,SAAQ,CAAA,EAAG;AACX,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,uDAAA,EAA2DA,MAAM,CAAA,CAAE,CAAA;AAAA,IACvF;AAAA,EACJ,CAAA,MAAO;AACH,IAAA,IAAI,OAAOA,WAAU,UAAA,EAAY;AAC7B,MAAA,MAAM,IAAI,SAAA,CAAU,CAAA,wDAAA,EAA4D,OAAOA,MAAM,CAAA,CAAE,CAAA;AAAA,IACnG;AAAA,EACJ;AAEA,EAAA,IAAI,QAAQ,IAAA,EAAM;AACd,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,IAAK,OAAO,SAAS,UAAA,EAAY;AACpD,MAAA,MAAM,IAAI,SAAA,CAAU,CAAA,iFAAA,EAAqF,OAAO,IAAK,CAAA,CAAE,CAAA;AAAA,IAC3H;AAAA,EACJ;AAEA,EAAA,IAAI,WAAW,IAAA,EAAM;AACjB,IAAA,IAAI,OAAO,YAAY,UAAA,EAAY;AAC/B,MAAA,MAAM,IAAI,SAAA,CAAU,CAAA,uDAAA,EAA2D,OAAO,OAAQ,CAAA,CAAE,CAAA;AAAA,IACpG;AAAA,EACJ;AAEA,EAAA,OAAO,EAAE,OAAA,EAAS,KAAA,EAAAA,MAAAA,EAAO,MAAM,OAAA,EAAQ;AAC3C;AAWA,SAAS,YAAY,GAAA,EAAwB;AACzC,EAAA,IAAI,eAAe,GAAA,EAAK;AACpB,IAAA,OAAO,GAAA;AAAA,EACX;AAEA,EAAA,IAAI;AAGA,IAAA,MAAM,IAAA,GAAO,OAAO,QAAA,KAAa,WAAA,GAAc,SAAS,IAAA,GAAO,MAAA;AAC/D,IAAA,OAAO,IAAI,GAAA,CAAI,GAAA,EAAK,IAAI,CAAA;AAAA,EAC5B,CAAA,CAAA,MAAQ;AACJ,IAAA,MAAM,IAAI,SAAA,CAAU,CAAA,aAAA,EAAiB,GAAI,CAAA,CAAE,CAAA;AAAA,EAC/C;AACJ;;;;;;;"}

package/dist/main.mjs

@@ -1,5 +1,4 @@
 import { Err, Ok } from 'happy-rusty';
-import invariant from 'tiny-invariant';
 
 const ABORT_ERROR = "AbortError";
 const TIMEOUT_ERROR = "TimeoutError";
@@ -240,16 +239,27 @@ function validateOptions(init) {
   } = init;
   if (responseType != null) {
     const validTypes = ["text", "arraybuffer", "blob", "json", "bytes", "stream"];
-    invariant(validTypes.includes(responseType), () => `responseType must be one of ${validTypes.join(", ")} but received ${responseType}`);
+    if (!validTypes.includes(responseType)) {
+      throw new TypeError(`responseType must be one of ${validTypes.join(", ")} but received ${responseType}`);
+    }
   }
   if (timeout != null) {
-    invariant(typeof timeout === "number" && timeout > 0, () => `timeout must be a number greater than 0 but received ${timeout}`);
+    if (typeof timeout !== "number") {
+      throw new TypeError(`timeout must be a number but received ${typeof timeout}`);
+    }
+    if (timeout <= 0) {
+      throw new Error(`timeout must be a number greater than 0 but received ${timeout}`);
+    }
   }
   if (onProgress != null) {
-    invariant(typeof onProgress === "function", () => `onProgress callback must be a function but received ${typeof onProgress}`);
+    if (typeof onProgress !== "function") {
+      throw new TypeError(`onProgress callback must be a function but received ${typeof onProgress}`);
+    }
   }
   if (onChunk != null) {
-    invariant(typeof onChunk === "function", () => `onChunk callback must be a function but received ${typeof onChunk}`);
+    if (typeof onChunk !== "function") {
+      throw new TypeError(`onChunk callback must be a function but received ${typeof onChunk}`);
+    }
   }
   let retries = 0;
   let delay2 = 0;
@@ -263,17 +273,30 @@ function validateOptions(init) {
     when = retryOptions.when;
     onRetry = retryOptions.onRetry;
   }
-  invariant(Number.isInteger(retries) && retries >= 0, () => `Retry count must be a non-negative integer but received ${retries}`);
+  if (!Number.isInteger(retries)) {
+    throw new TypeError(`Retry count must be an integer but received ${retries}`);
+  }
+  if (retries < 0) {
+    throw new Error(`Retry count must be non-negative but received ${retries}`);
+  }
   if (typeof delay2 === "number") {
-    invariant(delay2 >= 0, () => `Retry delay must be a non-negative number but received ${delay2}`);
+    if (delay2 < 0) {
+      throw new Error(`Retry delay must be a non-negative number but received ${delay2}`);
+    }
   } else {
-    invariant(typeof delay2 === "function", () => `Retry delay must be a number or a function but received ${typeof delay2}`);
+    if (typeof delay2 !== "function") {
+      throw new TypeError(`Retry delay must be a number or a function but received ${typeof delay2}`);
+    }
   }
   if (when != null) {
-    invariant(Array.isArray(when) || typeof when === "function", () => `Retry when condition must be an array of status codes or a function but received ${typeof when}`);
+    if (!Array.isArray(when) && typeof when !== "function") {
+      throw new TypeError(`Retry when condition must be an array of status codes or a function but received ${typeof when}`);
+    }
   }
   if (onRetry != null) {
-    invariant(typeof onRetry === "function", () => `Retry onRetry callback must be a function but received ${typeof onRetry}`);
+    if (typeof onRetry !== "function") {
+      throw new TypeError(`Retry onRetry callback must be a function but received ${typeof onRetry}`);
+    }
   }
   return { retries, delay: delay2, when, onRetry };
 }

package/dist/main.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.mjs","sources":["../src/fetch/constants.ts","../src/fetch/defines.ts","../src/fetch/fetch.ts"],"sourcesContent":["/**\n * Error name for aborted fetch requests.\n *\n * This matches the standard `AbortError` name used by the Fetch API when a request\n * is cancelled via `AbortController.abort()`.\n *\n * @example\n * ```typescript\n * import { fetchT, ABORT_ERROR } from '@happy-ts/fetch-t';\n *\n * const task = fetchT('https://api.example.com/data', { abortable: true });\n * task.abort();\n *\n * const result = await task.response;\n * result.inspectErr((err) => {\n *     if (err.name === ABORT_ERROR) {\n *         console.log('Request was aborted');\n *     }\n * });\n * ```\n */\nexport const ABORT_ERROR = 'AbortError' as const;\n\n/**\n * Error name for timed out fetch requests.\n *\n * This is set on the `Error.name` property when a request exceeds the specified\n * `timeout` duration and is automatically aborted.\n *\n * @example\n * ```typescript\n * import { fetchT, TIMEOUT_ERROR } from '@happy-ts/fetch-t';\n *\n * const result = await fetchT('https://api.example.com/slow-endpoint', {\n *     timeout: 5000, // 5 seconds\n * });\n *\n * result.inspectErr((err) => {\n *     if (err.name === TIMEOUT_ERROR) {\n *         console.log('Request timed out after 5 seconds');\n *     }\n * });\n * ```\n */\nexport const TIMEOUT_ERROR = 'TimeoutError' as const;\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { AsyncResult, IOResult } from 'happy-rusty';\n\n/**\n * Union type of all possible fetchT response data types.\n *\n * Used when `responseType` is a dynamic string value rather than a literal type,\n * as the exact return type cannot be determined at compile time.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponseData } from '@happy-ts/fetch-t';\n *\n * // When responseType is dynamic, return type is FetchResponseData\n * const responseType = getResponseType(); // returns string\n * const result = await fetchT('https://api.example.com/data', { responseType });\n * // result is Result<FetchResponseData, Error>\n * ```\n */\nexport type FetchResponseData =\n    | string\n    | ArrayBuffer\n    | Blob\n    | Uint8Array<ArrayBuffer>\n    | ReadableStream<Uint8Array<ArrayBuffer>>\n    | Response\n    | null;\n\n/**\n * Represents the response of a fetch operation as an async Result type.\n *\n * This is an alias for `AsyncResult<T, E>` from the `happy-rusty` library,\n * providing Rust-like error handling without throwing exceptions.\n *\n * @typeParam T - The type of the data expected in a successful response.\n * @typeParam E - The type of the error (defaults to `any`). Typically `Error` or `FetchError`.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponse } from '@happy-ts/fetch-t';\n *\n * // FetchResponse is a Promise that resolves to Result<T, E>\n * const response: FetchResponse<string> = fetchT('https://api.example.com', {\n *     responseType: 'text',\n * });\n *\n * const result = await response;\n * result\n *     .inspect((text) => console.log('Success:', text))\n *     .inspectErr((err) => console.error('Error:', err));\n * ```\n */\nexport type FetchResponse<T, E = any> = AsyncResult<T, E>;\n\n/**\n * Represents an abortable fetch operation with control methods.\n *\n * Returned when `abortable: true` is set in the fetch options. Provides\n * the ability to cancel the request and check its abort status.\n *\n * @typeParam T - The type of the data expected in the response.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchTask } from '@happy-ts/fetch-t';\n *\n * interface User {\n *     id: number;\n *     name: string;\n * }\n *\n * const task: FetchTask<User> = fetchT<User>('https://api.example.com/user/1', {\n *     abortable: true,\n *     responseType: 'json',\n * });\n *\n * // Check if aborted\n * console.log('Is aborted:', task.aborted); // false\n *\n * // Abort with optional reason\n * task.abort('User navigated away');\n *\n * // Access the response (will be an error after abort)\n * const result = await task.response;\n * result.inspectErr((err) => console.log('Aborted:', err.message));\n * ```\n */\nexport interface FetchTask<T> {\n    /**\n     * Aborts the fetch task, optionally with a reason.\n     *\n     * Once aborted, the `response` promise will resolve to an `Err` containing\n     * an `AbortError`. The abort reason can be any value and will be passed\n     * to the underlying `AbortController.abort()`.\n     *\n     * @param reason - An optional value indicating why the task was aborted.\n     *                 This can be an Error, string, or any other value.\n     */\n    abort(reason?: any): void;\n\n    /**\n     * Indicates whether the fetch task has been aborted.\n     *\n     * Returns `true` if `abort()` was called or if the request timed out.\n     */\n    readonly aborted: boolean;\n\n    /**\n     * The response promise of the fetch task.\n     *\n     * Resolves to `Ok<T>` on success, or `Err<Error>` on failure (including abort).\n     */\n    readonly response: FetchResponse<T>;\n}\n\n/**\n * Specifies the expected response type for automatic parsing.\n *\n * - `'text'` - Parse response as string via `Response.text()`\n * - `'json'` - Parse response as JSON via `Response.json()`\n * - `'arraybuffer'` - Parse response as ArrayBuffer via `Response.arrayBuffer()`\n * - `'bytes'` - Parse response as Uint8Array<ArrayBuffer> via `Response.bytes()` (with fallback for older environments)\n * - `'blob'` - Parse response as Blob via `Response.blob()`\n * - `'stream'` - Return the raw `ReadableStream` for streaming processing\n *\n * If not specified, the raw `Response` object is returned.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponseType } from '@happy-ts/fetch-t';\n *\n * const responseType: FetchResponseType = 'json';\n *\n * const result = await fetchT('https://api.example.com/data', { responseType });\n * ```\n */\nexport type FetchResponseType = 'text' | 'arraybuffer' | 'blob' | 'json' | 'bytes' | 'stream';\n\n/**\n * Represents the download progress of a fetch operation.\n *\n * Passed to the `onProgress` callback when tracking download progress.\n * Note: Progress tracking requires the server to send a `Content-Length` header.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchProgress } from '@happy-ts/fetch-t';\n *\n * await fetchT('https://example.com/file.zip', {\n *     responseType: 'blob',\n *     onProgress: (result) => {\n *         result.inspect((progress: FetchProgress) => {\n *             const percent = (progress.completedByteLength / progress.totalByteLength) * 100;\n *             console.log(`Downloaded: ${percent.toFixed(1)}%`);\n *         });\n *     },\n * });\n * ```\n */\nexport interface FetchProgress {\n    /**\n     * The total number of bytes to be received (from Content-Length header).\n     */\n    totalByteLength: number;\n\n    /**\n     * The number of bytes received so far.\n     */\n    completedByteLength: number;\n}\n\n/**\n * Options for configuring retry behavior.\n */\nexport interface FetchRetryOptions {\n    /**\n     * Number of times to retry the request on failure.\n     *\n     * By default, only network errors trigger retries. HTTP errors (4xx, 5xx)\n     * require explicit configuration via `when`.\n     *\n     * @default 0 (no retries)\n     */\n    retries?: number;\n\n    /**\n     * Delay between retry attempts in milliseconds.\n     *\n     * Can be a static number or a function for custom strategies like exponential backoff.\n     * The function receives the current attempt number (1-indexed).\n     *\n     * @default 0 (immediate retry)\n     */\n    delay?: number | ((attempt: number) => number);\n\n    /**\n     * Conditions under which to retry the request.\n     *\n     * Can be an array of HTTP status codes or a custom function.\n     * By default, only network errors (not FetchError) trigger retries.\n     */\n    when?: number[] | ((error: Error, attempt: number) => boolean);\n\n    /**\n     * Callback invoked before each retry attempt.\n     *\n     * Useful for logging, metrics, or adjusting request parameters.\n     */\n    onRetry?: (error: Error, attempt: number) => void;\n}\n\n/**\n * Extended fetch options that add additional capabilities to the standard `RequestInit`.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchInit } from '@happy-ts/fetch-t';\n *\n * const options: FetchInit = {\n *     // Standard RequestInit options\n *     method: 'POST',\n *     headers: { 'Content-Type': 'application/json' },\n *     body: JSON.stringify({ key: 'value' }),\n *\n *     // Extended options\n *     abortable: true,           // Return FetchTask for manual abort control\n *     responseType: 'json',      // Auto-parse response as JSON\n *     timeout: 10000,            // Abort after 10 seconds\n *     onProgress: (result) => {  // Track download progress\n *         result.inspect(({ completedByteLength, totalByteLength }) => {\n *             console.log(`${completedByteLength}/${totalByteLength}`);\n *         });\n *     },\n *     onChunk: (chunk) => {      // Receive raw data chunks\n *         console.log('Received chunk:', chunk.byteLength, 'bytes');\n *     },\n * };\n *\n * const task = fetchT('https://api.example.com/upload', options);\n * ```\n */\nexport interface FetchInit extends RequestInit {\n    /**\n     * When `true`, returns a `FetchTask` instead of `FetchResponse`.\n     *\n     * The `FetchTask` provides `abort()` method and `aborted` status.\n     *\n     * @default false\n     */\n    abortable?: boolean;\n\n    /**\n     * Specifies how the response body should be parsed.\n     *\n     * - `'text'` - Returns `string`\n     * - `'json'` - Returns parsed JSON (type `T`)\n     * - `'arraybuffer'` - Returns `ArrayBuffer`\n     * - `'bytes'` - Returns `Uint8Array<ArrayBuffer>` (with fallback for older environments)\n     * - `'blob'` - Returns `Blob`\n     * - `'stream'` - Returns `ReadableStream<Uint8Array<ArrayBuffer>>`\n     * - `undefined` - Returns raw `Response` object\n     *\n     * When using a dynamic string value (not a literal type), the return type\n     * will be `FetchResponseData` (union of all possible types).\n     */\n    responseType?: FetchResponseType;\n\n    /**\n     * Maximum time in milliseconds to wait for the request to complete.\n     *\n     * If exceeded, the request is automatically aborted with a `TimeoutError`.\n     * Must be a positive number.\n     */\n    timeout?: number;\n\n    /**\n     * Retry options.\n     *\n     * Can be a number (shorthand for retries count) or an options object.\n     *\n     * @example\n     * ```typescript\n     * // Retry up to 3 times on network errors\n     * const result = await fetchT('https://api.example.com/data', {\n     *     retry: 3,\n     * });\n     *\n     * // Detailed configuration\n     * const result = await fetchT('https://api.example.com/data', {\n     *     retry: {\n     *         retries: 3,\n     *         delay: 1000,\n     *         when: [500, 502],\n     *         onRetry: (error, attempt) => console.log(error),\n     *     },\n     * });\n     * ```\n     */\n    retry?: number | FetchRetryOptions;\n\n    /**\n     * Callback invoked during download to report progress.\n     *\n     * Receives an `IOResult<FetchProgress>`:\n     * - `Ok(FetchProgress)` - Progress update with byte counts\n     * - `Err(Error)` - If `Content-Length` header is missing (called once)\n     *\n     * @param progressResult - The progress result, either success with progress data or error.\n     */\n    onProgress?: (progressResult: IOResult<FetchProgress>) => void;\n\n    /**\n     * Callback invoked when a chunk of data is received.\n     *\n     * Useful for streaming or processing data as it arrives.\n     * Each chunk is a `Uint8Array<ArrayBuffer>` containing the raw bytes.\n     *\n     * @param chunk - The raw data chunk received from the response stream.\n     */\n    onChunk?: (chunk: Uint8Array<ArrayBuffer>) => void;\n}\n\n/**\n * Custom error class for HTTP error responses (non-2xx status codes).\n *\n * Thrown when `Response.ok` is `false`. Contains the HTTP status code\n * for programmatic error handling.\n *\n * @example\n * ```typescript\n * import { fetchT, FetchError } from '@happy-ts/fetch-t';\n *\n * const result = await fetchT('https://api.example.com/not-found', {\n *     responseType: 'json',\n * });\n *\n * result.inspectErr((err) => {\n *     if (err instanceof FetchError) {\n *         console.log('HTTP Status:', err.status);  // e.g., 404\n *         console.log('Status Text:', err.message); // e.g., \"Not Found\"\n *\n *         // Handle specific status codes\n *         switch (err.status) {\n *             case 401:\n *                 console.log('Unauthorized - please login');\n *                 break;\n *             case 404:\n *                 console.log('Resource not found');\n *                 break;\n *             case 500:\n *                 console.log('Server error');\n *                 break;\n *         }\n *     }\n * });\n * ```\n */\nexport class FetchError extends Error {\n    /**\n     * The error name, always `'FetchError'`.\n     */\n    override name = 'FetchError';\n\n    /**\n     * The HTTP status code of the response (e.g., 404, 500).\n     */\n    status: number;\n\n    /**\n     * Creates a new FetchError instance.\n     *\n     * @param message - The status text from the HTTP response (e.g., \"Not Found\").\n     * @param status - The HTTP status code (e.g., 404).\n     */\n    constructor(message: string, status: number) {\n        super(message);\n        this.status = status;\n    }\n}\n","import { Err, Ok, type AsyncIOResult } from 'happy-rusty';\nimport invariant from 'tiny-invariant';\nimport { ABORT_ERROR } from './constants.ts';\nimport { FetchError, type FetchInit, type FetchResponse, type FetchResponseData, type FetchResponseType, type FetchRetryOptions, type FetchTask } from './defines.ts';\n\n/**\n * Fetches a resource from the network as a text string and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'text'`.\n * @returns A `FetchTask` representing the abortable operation with a `string` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'text';\n}): FetchTask<string>;\n\n/**\n * Fetches a resource from the network as an ArrayBuffer and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'arraybuffer'`.\n * @returns A `FetchTask` representing the abortable operation with an `ArrayBuffer` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'arraybuffer';\n}): FetchTask<ArrayBuffer>;\n\n/**\n * Fetches a resource from the network as a Blob and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'blob'`.\n * @returns A `FetchTask` representing the abortable operation with a `Blob` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'blob';\n}): FetchTask<Blob>;\n\n/**\n * Fetches a resource from the network and parses it as JSON, returning an abortable `FetchTask`.\n *\n * @typeParam T - The expected type of the parsed JSON data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'json'`.\n * @returns A `FetchTask` representing the abortable operation with a response parsed as type `T`.\n */\nexport function fetchT<T>(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'json';\n}): FetchTask<T | null>;\n\n/**\n * Fetches a resource from the network as a ReadableStream and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'stream'`.\n * @returns A `FetchTask` representing the abortable operation with a `ReadableStream<Uint8Array<ArrayBuffer>>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'stream';\n}): FetchTask<ReadableStream<Uint8Array<ArrayBuffer>> | null>;\n\n/**\n * Fetches a resource from the network as a Uint8Array<ArrayBuffer> and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'bytes'`.\n * @returns A `FetchTask` representing the abortable operation with a `Uint8Array<ArrayBuffer>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'bytes';\n}): FetchTask<Uint8Array<ArrayBuffer>>;\n\n/**\n * Fetches a resource from the network and returns an abortable `FetchTask` with a dynamic response type.\n *\n * Use this overload when `responseType` is a `FetchResponseType` union type.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and a `FetchResponseType`.\n * @returns A `FetchTask` representing the abortable operation with a `FetchResponseData` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: FetchResponseType;\n}): FetchTask<FetchResponseData>;\n\n/**\n * Fetches a resource from the network as a text string.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'text'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `string` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'text';\n}): FetchResponse<string, Error>;\n\n/**\n * Fetches a resource from the network as an ArrayBuffer.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'arraybuffer'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with an `ArrayBuffer` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'arraybuffer';\n}): FetchResponse<ArrayBuffer, Error>;\n\n/**\n * Fetches a resource from the network as a Blob.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'blob'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Blob` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'blob';\n}): FetchResponse<Blob, Error>;\n\n/**\n * Fetches a resource from the network and parses it as JSON.\n *\n * @typeParam T - The expected type of the parsed JSON data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'json'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a response parsed as type `T`.\n */\nexport function fetchT<T>(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'json';\n}): FetchResponse<T | null, Error>;\n\n/**\n * Fetches a resource from the network as a ReadableStream.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'stream'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `ReadableStream<Uint8Array<ArrayBuffer>>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'stream';\n}): FetchResponse<ReadableStream<Uint8Array<ArrayBuffer>> | null, Error>;\n\n/**\n * Fetches a resource from the network as a Uint8Array<ArrayBuffer>.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'bytes'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Uint8Array<ArrayBuffer>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'bytes';\n}): FetchResponse<Uint8Array<ArrayBuffer>, Error>;\n\n/**\n * Fetches a resource from the network with a dynamic response type (non-abortable).\n *\n * Use this overload when `responseType` is a `FetchResponseType` union type.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation with a `FetchResponseType`, and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `FetchResponseData` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: FetchResponseType;\n}): FetchResponse<FetchResponseData, Error>;\n\n/**\n * Fetches a resource from the network and returns an abortable `FetchTask` with a generic `Response`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true`.\n * @returns A `FetchTask` representing the abortable operation with a `Response` object.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n}): FetchTask<Response>;\n\n/**\n * Fetches a resource from the network and returns a `FetchResponse` with a generic `Response` object.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Optional additional options for the fetch operation, and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Response` object.\n */\nexport function fetchT(url: string | URL, init?: FetchInit & {\n    abortable?: false;\n}): FetchResponse<Response>;\n\n/**\n * Enhanced fetch function that wraps the native Fetch API with additional capabilities.\n *\n * Features:\n * - **Abortable requests**: Set `abortable: true` to get a `FetchTask` with `abort()` method.\n * - **Type-safe responses**: Use `responseType` to automatically parse responses as text, JSON, ArrayBuffer, or Blob.\n * - **Timeout support**: Set `timeout` in milliseconds to auto-abort long-running requests.\n * - **Progress tracking**: Use `onProgress` callback to track download progress (requires Content-Length header).\n * - **Chunk streaming**: Use `onChunk` callback to receive raw data chunks as they arrive.\n * - **Retry support**: Use `retry` to automatically retry failed requests with configurable delay and conditions.\n * - **Result type error handling**: Returns `Result<T, Error>` instead of throwing exceptions.\n *\n * @typeParam T - The expected type of the response data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, extending standard `RequestInit` with custom properties.\n * @returns A `FetchTask<T>` if `abortable: true`, otherwise a `FetchResponse<T>` (which is `AsyncResult<T, Error>`).\n * @throws {Error} If `url` is not a string or URL object.\n * @throws {Error} If `timeout` is specified but is not a positive number.\n *\n * @example\n * // Basic GET request - returns Response object wrapped in Result\n * const result = await fetchT('https://api.example.com/data');\n * result\n *     .inspect((res) => console.log('Status:', res.status))\n *     .inspectErr((err) => console.error('Error:', err));\n *\n * @example\n * // GET JSON with type safety\n * interface User {\n *     id: number;\n *     name: string;\n * }\n * const result = await fetchT<User>('https://api.example.com/user/1', {\n *     responseType: 'json',\n * });\n * result.inspect((user) => console.log(user.name));\n *\n * @example\n * // POST request with JSON body\n * const result = await fetchT<User>('https://api.example.com/users', {\n *     method: 'POST',\n *     headers: { 'Content-Type': 'application/json' },\n *     body: JSON.stringify({ name: 'John' }),\n *     responseType: 'json',\n * });\n *\n * @example\n * // Abortable request with timeout\n * const task = fetchT('https://api.example.com/data', {\n *     abortable: true,\n *     timeout: 5000, // 5 seconds\n * });\n *\n * // Cancel the request if needed\n * task.abort('User cancelled');\n *\n * // Check if aborted\n * console.log('Aborted:', task.aborted);\n *\n * // Wait for response\n * const result = await task.response;\n *\n * @example\n * // Track download progress\n * const result = await fetchT('https://example.com/large-file.zip', {\n *     responseType: 'blob',\n *     onProgress: (progressResult) => {\n *         progressResult\n *             .inspect(({ completedByteLength, totalByteLength }) => {\n *                 const percent = ((completedByteLength / totalByteLength) * 100).toFixed(1);\n *                 console.log(`Progress: ${percent}%`);\n *             })\n *             .inspectErr((err) => console.warn('Progress unavailable:', err.message));\n *     },\n * });\n *\n * @example\n * // Stream data chunks\n * const chunks: Uint8Array[] = [];\n * const result = await fetchT('https://example.com/stream', {\n *     onChunk: (chunk) => chunks.push(chunk),\n * });\n *\n * @example\n * // Retry with exponential backoff\n * const result = await fetchT('https://api.example.com/data', {\n *     retry: {\n *         retries: 3,\n *         delay: (attempt) => Math.min(1000 * Math.pow(2, attempt - 1), 10000),\n *         when: [500, 502, 503, 504],\n *         onRetry: (error, attempt) => console.log(`Retry ${attempt}: ${error.message}`),\n *     },\n *     responseType: 'json',\n * });\n */\nexport function fetchT(url: string | URL, init?: FetchInit): FetchTask<FetchResponseData> | FetchResponse<FetchResponseData> {\n    // Validate and parse URL\n    const parsedUrl = validateUrl(url);\n\n    const fetchInit = init ?? {};\n\n    const {\n        retries,\n        delay: retryDelay,\n        when: retryWhen,\n        onRetry,\n    } = validateOptions(fetchInit);\n\n    const {\n        // default not abortable\n        abortable = false,\n        responseType,\n        timeout,\n        onProgress,\n        onChunk,\n        ...rest\n    } = fetchInit;\n\n    // Preserve user's original signal before modifications (rest.signal will be reassigned in setSignal)\n    const userSignal = rest.signal;\n\n    // User controller for manual abort (stops all retries)\n    let userController: AbortController | undefined;\n    if (abortable) {\n        userController = new AbortController();\n    }\n\n    /**\n     * Determines if the error should trigger a retry.\n     * By default, only network errors (not FetchError) trigger retries.\n     */\n    const shouldRetry = (error: Error, attempt: number): boolean => {\n        // Never retry on user abort\n        if (error.name === ABORT_ERROR) {\n            return false;\n        }\n\n        if (!retryWhen) {\n            // Default: only retry on network errors (not FetchError/HTTP errors)\n            return !(error instanceof FetchError);\n        }\n\n        if (Array.isArray(retryWhen)) {\n            // Retry on specific HTTP status codes\n            return error instanceof FetchError && retryWhen.includes(error.status);\n        }\n\n        // Custom retry condition\n        return retryWhen(error, attempt);\n    };\n\n    /**\n     * Calculates the delay before the next retry attempt.\n     */\n    const getRetryDelay = (attempt: number): number => {\n        return typeof retryDelay === 'function'\n            ? retryDelay(attempt)\n            : retryDelay;\n    };\n\n    /**\n     * Configures the abort signal for a fetch attempt.\n     *\n     * Combines multiple signals:\n     * - User's external signal (from init.signal)\n     * - Internal abort controller signal (for abortable requests)\n     * - Timeout signal (creates a new one each call for per-attempt timeout)\n     *\n     * Must be called before each fetch attempt to ensure fresh timeout signal on retries.\n     */\n    const configureSignal = (): void => {\n        const signals: AbortSignal[] = [];\n\n        // Merge user's signal from init (if provided)\n        if (userSignal) {\n            signals.push(userSignal);\n        }\n\n        if (userController) {\n            signals.push(userController.signal);\n        }\n\n        if (typeof timeout === 'number') {\n            signals.push(AbortSignal.timeout(timeout));\n        }\n\n        // Combine all signals\n        if (signals.length > 0) {\n            rest.signal = signals.length === 1\n                ? signals[0]\n                : AbortSignal.any(signals);\n        }\n    };\n\n    /**\n     * Performs a single fetch attempt with optional timeout.\n     */\n    const doFetch = async (): AsyncIOResult<FetchResponseData> => {\n        configureSignal();\n\n        try {\n            const response = await fetch(parsedUrl, rest);\n\n            if (!response.ok) {\n                // Cancel the response body to free resources\n                response.body?.cancel().catch(() => {\n                    // Silently ignore stream cancel errors\n                });\n                return Err(new FetchError(response.statusText, response.status));\n            }\n\n            return await processResponse(response);\n        } catch (err) {\n            return Err(err instanceof Error\n                ? err\n                // Non-Error type, most likely an abort reason\n                : wrapAbortReason(err),\n            );\n        }\n    };\n\n    /**\n     * Sets up progress tracking and chunk callbacks using a cloned response.\n     * The original response is returned unchanged for further processing.\n     */\n    const setupProgressCallbacks = async (response: Response): Promise<void> => {\n        let totalByteLength: number | undefined;\n        let completedByteLength = 0;\n\n        if (onProgress) {\n            const contentLength = response.headers.get('content-length');\n            if (contentLength == null) {\n                try {\n                    onProgress(Err(new Error('No content-length in response headers')));\n                } catch {\n                    // Silently ignore user callback errors\n                }\n            } else {\n                totalByteLength = Number.parseInt(contentLength, 10);\n            }\n        }\n\n        const body = response.clone().body as ReadableStream<Uint8Array<ArrayBuffer>>;\n\n        try {\n            for await (const chunk of body) {\n                if (onChunk) {\n                    try {\n                        onChunk(chunk);\n                    } catch {\n                        // Silently ignore user callback errors\n                    }\n                }\n\n                if (onProgress && totalByteLength != null) {\n                    completedByteLength += chunk.byteLength;\n                    try {\n                        onProgress(Ok({\n                            totalByteLength,\n                            completedByteLength,\n                        }));\n                    } catch {\n                        // Silently ignore user callback errors\n                    }\n                }\n            }\n        } catch {\n            // Silently ignore stream read errors\n        }\n    };\n\n    /**\n     * Processes the response based on responseType and callbacks.\n     */\n    const processResponse = async (response: Response): AsyncIOResult<FetchResponseData> => {\n        // Setup progress/chunk callbacks if needed (uses cloned response internally)\n        if (response.body && (onProgress || onChunk)) {\n            setupProgressCallbacks(response);\n        }\n\n        switch (responseType) {\n            case 'json': {\n                // Align with stream behavior: no body yields Ok(null)\n                if (response.body == null) {\n                    return Ok(null);\n                }\n                try {\n                    return Ok(await response.json());\n                } catch {\n                    return Err(new Error('Response is invalid json while responseType is json'));\n                }\n            }\n            case 'text': {\n                return Ok(await response.text());\n            }\n            case 'bytes': {\n                // Use native bytes() if available, otherwise fallback to arrayBuffer()\n                if (typeof response.bytes === 'function') {\n                    return Ok(await response.bytes());\n                }\n                // Fallback for older environments\n                return Ok(new Uint8Array(await response.arrayBuffer()));\n            }\n            case 'arraybuffer': {\n                return Ok(await response.arrayBuffer());\n            }\n            case 'blob': {\n                return Ok(await response.blob());\n            }\n            case 'stream': {\n                return Ok(response.body);\n            }\n            default: {\n                // default return the original Response object to preserve all metadata\n                return Ok(response);\n            }\n        }\n    };\n\n    /**\n     * Performs fetch with retry logic.\n     */\n    const fetchWithRetry = async (): FetchResponse<FetchResponseData, Error> => {\n        let lastError: Error | undefined;\n        let attempt = 0;\n\n        do {\n            // Before retry (not first attempt), wait for delay\n            if (attempt > 0) {\n                // Check if user aborted before delay (e.g., aborted in `when` callback)\n                if (userController?.signal.aborted) {\n                    return Err(userController.signal.reason as Error);\n                }\n\n                const delayMs = getRetryDelay(attempt);\n                // Wait for delay if necessary\n                if (delayMs > 0) {\n                    await delay(delayMs);\n\n                    // Check if user aborted during delay\n                    if (userController?.signal.aborted) {\n                        return Err(userController.signal.reason as Error);\n                    }\n                }\n\n                // Call onRetry right before the actual retry request\n                try {\n                    onRetry?.(lastError as Error, attempt);\n                } catch {\n                    // Silently ignore user callback errors\n                }\n            }\n\n            const result = await doFetch();\n\n            if (result.isOk()) {\n                return result;\n            }\n\n            lastError = result.unwrapErr();\n            attempt++;\n\n            // Check if we should retry\n        } while (attempt <= retries && shouldRetry(lastError, attempt));\n\n        // No more retries or should not retry\n        // lastError is guaranteed to be defined here because:\n        // 1. do...while loop executes at least once\n        // 2. We only reach here if result.isErr()\n        return Err(lastError);\n    };\n\n    const response = fetchWithRetry();\n\n    if (abortable && userController) {\n        return {\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            abort(reason?: any): void {\n                if (reason instanceof Error) {\n                    userController.abort(reason);\n                } else if (reason != null) {\n                    userController.abort(wrapAbortReason(reason));\n                } else {\n                    userController.abort();\n                }\n            },\n\n            get aborted(): boolean {\n                return userController.signal.aborted;\n            },\n\n            get response(): FetchResponse<FetchResponseData> {\n                return response;\n            },\n        };\n    }\n\n    return response;\n}\n\n/**\n * Delays execution for the specified number of milliseconds.\n */\nfunction delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Wraps a non-Error abort reason into an Error with ABORT_ERROR name.\n */\nfunction wrapAbortReason(reason: unknown): Error {\n    const error = new Error(typeof reason === 'string' ? reason : String(reason));\n    error.name = ABORT_ERROR;\n    error.cause = reason;\n    return error;\n}\n\ninterface ParsedRetryOptions extends FetchRetryOptions {\n    retries: number;\n    delay: number | ((attempt: number) => number);\n}\n\n/**\n * Validates fetch options and parses retry configuration.\n */\nfunction validateOptions(init: FetchInit): ParsedRetryOptions {\n    const {\n        responseType,\n        timeout,\n        retry: retryOptions = 0,\n        onProgress,\n        onChunk,\n    } = init;\n\n    if (responseType != null) {\n        const validTypes = ['text', 'arraybuffer', 'blob', 'json', 'bytes', 'stream'];\n        invariant(validTypes.includes(responseType), () => `responseType must be one of ${ validTypes.join(', ') } but received ${ responseType }`);\n    }\n\n    if (timeout != null) {\n        invariant(typeof timeout === 'number' && timeout > 0, () => `timeout must be a number greater than 0 but received ${ timeout }`);\n    }\n\n    if (onProgress != null) {\n        invariant(typeof onProgress === 'function', () => `onProgress callback must be a function but received ${ typeof onProgress }`);\n    }\n\n    if (onChunk != null) {\n        invariant(typeof onChunk === 'function', () => `onChunk callback must be a function but received ${ typeof onChunk }`);\n    }\n\n    // Parse retry options\n    let retries = 0;\n    let delay: number | ((attempt: number) => number) = 0;\n    let when: ((error: Error, attempt: number) => boolean) | number[] | undefined;\n    let onRetry: ((error: Error, attempt: number) => void) | undefined;\n\n    if (typeof retryOptions === 'number') {\n        retries = retryOptions;\n    } else if (retryOptions && typeof retryOptions === 'object') {\n        retries = retryOptions.retries ?? 0;\n        delay = retryOptions.delay ?? 0;\n        when = retryOptions.when;\n        onRetry = retryOptions.onRetry;\n    }\n\n    invariant(Number.isInteger(retries) && retries >= 0, () => `Retry count must be a non-negative integer but received ${ retries }`);\n\n    if (typeof delay === 'number') {\n        invariant(delay >= 0, () => `Retry delay must be a non-negative number but received ${ delay }`);\n    } else {\n        invariant(typeof delay === 'function', () => `Retry delay must be a number or a function but received ${ typeof delay }`);\n    }\n\n    if (when != null) {\n        invariant(Array.isArray(when) || typeof when === 'function', () => `Retry when condition must be an array of status codes or a function but received ${ typeof when }`);\n    }\n\n    if (onRetry != null) {\n        invariant(typeof onRetry === 'function', () => `Retry onRetry callback must be a function but received ${ typeof onRetry }`);\n    }\n\n    return { retries, delay, when, onRetry };\n}\n\n/**\n * Validates and parses a URL string or URL object.\n * In browser environments, relative URLs are resolved against `location.href`.\n * In non-browser environments (Node/Deno/Bun), only absolute URLs are valid.\n *\n * @param url - The URL to validate, either a string or URL object.\n * @returns The parsed URL object.\n * @throws {TypeError} If the URL is invalid or cannot be parsed.\n */\nfunction validateUrl(url: string | URL): URL {\n    if (url instanceof URL) {\n        return url;\n    }\n\n    try {\n        // In browser, use location.href as base for relative URLs\n        // In Node/Deno/Bun, location is undefined, so relative URLs will fail\n        const base = typeof location !== 'undefined' ? location.href : undefined;\n        return new URL(url, base);\n    } catch {\n        throw new TypeError(`Invalid URL: ${ url }`);\n    }\n}\n"],"names":["response","delay"],"mappings":"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"}
+{"version":3,"file":"main.mjs","sources":["../src/fetch/constants.ts","../src/fetch/defines.ts","../src/fetch/fetch.ts"],"sourcesContent":["/**\n * Error name for aborted fetch requests.\n *\n * This matches the standard `AbortError` name used by the Fetch API when a request\n * is cancelled via `AbortController.abort()`.\n *\n * @example\n * ```typescript\n * import { fetchT, ABORT_ERROR } from '@happy-ts/fetch-t';\n *\n * const task = fetchT('https://api.example.com/data', { abortable: true });\n * task.abort();\n *\n * const result = await task.response;\n * result.inspectErr((err) => {\n *     if (err.name === ABORT_ERROR) {\n *         console.log('Request was aborted');\n *     }\n * });\n * ```\n */\nexport const ABORT_ERROR = 'AbortError' as const;\n\n/**\n * Error name for timed out fetch requests.\n *\n * This is set on the `Error.name` property when a request exceeds the specified\n * `timeout` duration and is automatically aborted.\n *\n * @example\n * ```typescript\n * import { fetchT, TIMEOUT_ERROR } from '@happy-ts/fetch-t';\n *\n * const result = await fetchT('https://api.example.com/slow-endpoint', {\n *     timeout: 5000, // 5 seconds\n * });\n *\n * result.inspectErr((err) => {\n *     if (err.name === TIMEOUT_ERROR) {\n *         console.log('Request timed out after 5 seconds');\n *     }\n * });\n * ```\n */\nexport const TIMEOUT_ERROR = 'TimeoutError' as const;\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { AsyncResult, IOResult } from 'happy-rusty';\n\n/**\n * Union type of all possible fetchT response data types.\n *\n * Used when `responseType` is a dynamic string value rather than a literal type,\n * as the exact return type cannot be determined at compile time.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponseData } from '@happy-ts/fetch-t';\n *\n * // When responseType is dynamic, return type is FetchResponseData\n * const responseType = getResponseType(); // returns string\n * const result = await fetchT('https://api.example.com/data', { responseType });\n * // result is Result<FetchResponseData, Error>\n * ```\n */\nexport type FetchResponseData =\n    | string\n    | ArrayBuffer\n    | Blob\n    | Uint8Array<ArrayBuffer>\n    | ReadableStream<Uint8Array<ArrayBuffer>>\n    | Response\n    | null;\n\n/**\n * Represents the response of a fetch operation as an async Result type.\n *\n * This is an alias for `AsyncResult<T, E>` from the `happy-rusty` library,\n * providing Rust-like error handling without throwing exceptions.\n *\n * @typeParam T - The type of the data expected in a successful response.\n * @typeParam E - The type of the error (defaults to `any`). Typically `Error` or `FetchError`.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponse } from '@happy-ts/fetch-t';\n *\n * // FetchResponse is a Promise that resolves to Result<T, E>\n * const response: FetchResponse<string> = fetchT('https://api.example.com', {\n *     responseType: 'text',\n * });\n *\n * const result = await response;\n * result\n *     .inspect((text) => console.log('Success:', text))\n *     .inspectErr((err) => console.error('Error:', err));\n * ```\n */\nexport type FetchResponse<T, E = any> = AsyncResult<T, E>;\n\n/**\n * Represents an abortable fetch operation with control methods.\n *\n * Returned when `abortable: true` is set in the fetch options. Provides\n * the ability to cancel the request and check its abort status.\n *\n * @typeParam T - The type of the data expected in the response.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchTask } from '@happy-ts/fetch-t';\n *\n * interface User {\n *     id: number;\n *     name: string;\n * }\n *\n * const task: FetchTask<User> = fetchT<User>('https://api.example.com/user/1', {\n *     abortable: true,\n *     responseType: 'json',\n * });\n *\n * // Check if aborted\n * console.log('Is aborted:', task.aborted); // false\n *\n * // Abort with optional reason\n * task.abort('User navigated away');\n *\n * // Access the response (will be an error after abort)\n * const result = await task.response;\n * result.inspectErr((err) => console.log('Aborted:', err.message));\n * ```\n */\nexport interface FetchTask<T> {\n    /**\n     * Aborts the fetch task, optionally with a reason.\n     *\n     * Once aborted, the `response` promise will resolve to an `Err` containing\n     * an `AbortError`. The abort reason can be any value and will be passed\n     * to the underlying `AbortController.abort()`.\n     *\n     * @param reason - An optional value indicating why the task was aborted.\n     *                 This can be an Error, string, or any other value.\n     */\n    abort(reason?: any): void;\n\n    /**\n     * Indicates whether the fetch task has been aborted.\n     *\n     * Returns `true` if `abort()` was called or if the request timed out.\n     */\n    readonly aborted: boolean;\n\n    /**\n     * The response promise of the fetch task.\n     *\n     * Resolves to `Ok<T>` on success, or `Err<Error>` on failure (including abort).\n     */\n    readonly response: FetchResponse<T>;\n}\n\n/**\n * Specifies the expected response type for automatic parsing.\n *\n * - `'text'` - Parse response as string via `Response.text()`\n * - `'json'` - Parse response as JSON via `Response.json()`\n * - `'arraybuffer'` - Parse response as ArrayBuffer via `Response.arrayBuffer()`\n * - `'bytes'` - Parse response as Uint8Array<ArrayBuffer> via `Response.bytes()` (with fallback for older environments)\n * - `'blob'` - Parse response as Blob via `Response.blob()`\n * - `'stream'` - Return the raw `ReadableStream` for streaming processing\n *\n * If not specified, the raw `Response` object is returned.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchResponseType } from '@happy-ts/fetch-t';\n *\n * const responseType: FetchResponseType = 'json';\n *\n * const result = await fetchT('https://api.example.com/data', { responseType });\n * ```\n */\nexport type FetchResponseType = 'text' | 'arraybuffer' | 'blob' | 'json' | 'bytes' | 'stream';\n\n/**\n * Represents the download progress of a fetch operation.\n *\n * Passed to the `onProgress` callback when tracking download progress.\n * Note: Progress tracking requires the server to send a `Content-Length` header.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchProgress } from '@happy-ts/fetch-t';\n *\n * await fetchT('https://example.com/file.zip', {\n *     responseType: 'blob',\n *     onProgress: (result) => {\n *         result.inspect((progress: FetchProgress) => {\n *             const percent = (progress.completedByteLength / progress.totalByteLength) * 100;\n *             console.log(`Downloaded: ${percent.toFixed(1)}%`);\n *         });\n *     },\n * });\n * ```\n */\nexport interface FetchProgress {\n    /**\n     * The total number of bytes to be received (from Content-Length header).\n     */\n    totalByteLength: number;\n\n    /**\n     * The number of bytes received so far.\n     */\n    completedByteLength: number;\n}\n\n/**\n * Options for configuring retry behavior.\n */\nexport interface FetchRetryOptions {\n    /**\n     * Number of times to retry the request on failure.\n     *\n     * By default, only network errors trigger retries. HTTP errors (4xx, 5xx)\n     * require explicit configuration via `when`.\n     *\n     * @default 0 (no retries)\n     */\n    retries?: number;\n\n    /**\n     * Delay between retry attempts in milliseconds.\n     *\n     * Can be a static number or a function for custom strategies like exponential backoff.\n     * The function receives the current attempt number (1-indexed).\n     *\n     * @default 0 (immediate retry)\n     */\n    delay?: number | ((attempt: number) => number);\n\n    /**\n     * Conditions under which to retry the request.\n     *\n     * Can be an array of HTTP status codes or a custom function.\n     * By default, only network errors (not FetchError) trigger retries.\n     */\n    when?: number[] | ((error: Error, attempt: number) => boolean);\n\n    /**\n     * Callback invoked before each retry attempt.\n     *\n     * Useful for logging, metrics, or adjusting request parameters.\n     */\n    onRetry?: (error: Error, attempt: number) => void;\n}\n\n/**\n * Extended fetch options that add additional capabilities to the standard `RequestInit`.\n *\n * @example\n * ```typescript\n * import { fetchT, type FetchInit } from '@happy-ts/fetch-t';\n *\n * const options: FetchInit = {\n *     // Standard RequestInit options\n *     method: 'POST',\n *     headers: { 'Content-Type': 'application/json' },\n *     body: JSON.stringify({ key: 'value' }),\n *\n *     // Extended options\n *     abortable: true,           // Return FetchTask for manual abort control\n *     responseType: 'json',      // Auto-parse response as JSON\n *     timeout: 10000,            // Abort after 10 seconds\n *     onProgress: (result) => {  // Track download progress\n *         result.inspect(({ completedByteLength, totalByteLength }) => {\n *             console.log(`${completedByteLength}/${totalByteLength}`);\n *         });\n *     },\n *     onChunk: (chunk) => {      // Receive raw data chunks\n *         console.log('Received chunk:', chunk.byteLength, 'bytes');\n *     },\n * };\n *\n * const task = fetchT('https://api.example.com/upload', options);\n * ```\n */\nexport interface FetchInit extends RequestInit {\n    /**\n     * When `true`, returns a `FetchTask` instead of `FetchResponse`.\n     *\n     * The `FetchTask` provides `abort()` method and `aborted` status.\n     *\n     * @default false\n     */\n    abortable?: boolean;\n\n    /**\n     * Specifies how the response body should be parsed.\n     *\n     * - `'text'` - Returns `string`\n     * - `'json'` - Returns parsed JSON (type `T`)\n     * - `'arraybuffer'` - Returns `ArrayBuffer`\n     * - `'bytes'` - Returns `Uint8Array<ArrayBuffer>` (with fallback for older environments)\n     * - `'blob'` - Returns `Blob`\n     * - `'stream'` - Returns `ReadableStream<Uint8Array<ArrayBuffer>>`\n     * - `undefined` - Returns raw `Response` object\n     *\n     * When using a dynamic string value (not a literal type), the return type\n     * will be `FetchResponseData` (union of all possible types).\n     */\n    responseType?: FetchResponseType;\n\n    /**\n     * Maximum time in milliseconds to wait for the request to complete.\n     *\n     * If exceeded, the request is automatically aborted with a `TimeoutError`.\n     * Must be a positive number.\n     */\n    timeout?: number;\n\n    /**\n     * Retry options.\n     *\n     * Can be a number (shorthand for retries count) or an options object.\n     *\n     * @example\n     * ```typescript\n     * // Retry up to 3 times on network errors\n     * const result = await fetchT('https://api.example.com/data', {\n     *     retry: 3,\n     * });\n     *\n     * // Detailed configuration\n     * const result = await fetchT('https://api.example.com/data', {\n     *     retry: {\n     *         retries: 3,\n     *         delay: 1000,\n     *         when: [500, 502],\n     *         onRetry: (error, attempt) => console.log(error),\n     *     },\n     * });\n     * ```\n     */\n    retry?: number | FetchRetryOptions;\n\n    /**\n     * Callback invoked during download to report progress.\n     *\n     * Receives an `IOResult<FetchProgress>`:\n     * - `Ok(FetchProgress)` - Progress update with byte counts\n     * - `Err(Error)` - If `Content-Length` header is missing (called once)\n     *\n     * @param progressResult - The progress result, either success with progress data or error.\n     */\n    onProgress?: (progressResult: IOResult<FetchProgress>) => void;\n\n    /**\n     * Callback invoked when a chunk of data is received.\n     *\n     * Useful for streaming or processing data as it arrives.\n     * Each chunk is a `Uint8Array<ArrayBuffer>` containing the raw bytes.\n     *\n     * @param chunk - The raw data chunk received from the response stream.\n     */\n    onChunk?: (chunk: Uint8Array<ArrayBuffer>) => void;\n}\n\n/**\n * Custom error class for HTTP error responses (non-2xx status codes).\n *\n * Thrown when `Response.ok` is `false`. Contains the HTTP status code\n * for programmatic error handling.\n *\n * @example\n * ```typescript\n * import { fetchT, FetchError } from '@happy-ts/fetch-t';\n *\n * const result = await fetchT('https://api.example.com/not-found', {\n *     responseType: 'json',\n * });\n *\n * result.inspectErr((err) => {\n *     if (err instanceof FetchError) {\n *         console.log('HTTP Status:', err.status);  // e.g., 404\n *         console.log('Status Text:', err.message); // e.g., \"Not Found\"\n *\n *         // Handle specific status codes\n *         switch (err.status) {\n *             case 401:\n *                 console.log('Unauthorized - please login');\n *                 break;\n *             case 404:\n *                 console.log('Resource not found');\n *                 break;\n *             case 500:\n *                 console.log('Server error');\n *                 break;\n *         }\n *     }\n * });\n * ```\n */\nexport class FetchError extends Error {\n    /**\n     * The error name, always `'FetchError'`.\n     */\n    override name = 'FetchError';\n\n    /**\n     * The HTTP status code of the response (e.g., 404, 500).\n     */\n    status: number;\n\n    /**\n     * Creates a new FetchError instance.\n     *\n     * @param message - The status text from the HTTP response (e.g., \"Not Found\").\n     * @param status - The HTTP status code (e.g., 404).\n     */\n    constructor(message: string, status: number) {\n        super(message);\n        this.status = status;\n    }\n}\n","import { Err, Ok, type AsyncIOResult } from 'happy-rusty';\nimport { ABORT_ERROR } from './constants.ts';\nimport { FetchError, type FetchInit, type FetchResponse, type FetchResponseData, type FetchResponseType, type FetchRetryOptions, type FetchTask } from './defines.ts';\n\n/**\n * Fetches a resource from the network as a text string and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'text'`.\n * @returns A `FetchTask` representing the abortable operation with a `string` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'text';\n}): FetchTask<string>;\n\n/**\n * Fetches a resource from the network as an ArrayBuffer and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'arraybuffer'`.\n * @returns A `FetchTask` representing the abortable operation with an `ArrayBuffer` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'arraybuffer';\n}): FetchTask<ArrayBuffer>;\n\n/**\n * Fetches a resource from the network as a Blob and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'blob'`.\n * @returns A `FetchTask` representing the abortable operation with a `Blob` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'blob';\n}): FetchTask<Blob>;\n\n/**\n * Fetches a resource from the network and parses it as JSON, returning an abortable `FetchTask`.\n *\n * @typeParam T - The expected type of the parsed JSON data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'json'`.\n * @returns A `FetchTask` representing the abortable operation with a response parsed as type `T`.\n */\nexport function fetchT<T>(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'json';\n}): FetchTask<T | null>;\n\n/**\n * Fetches a resource from the network as a ReadableStream and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'stream'`.\n * @returns A `FetchTask` representing the abortable operation with a `ReadableStream<Uint8Array<ArrayBuffer>>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'stream';\n}): FetchTask<ReadableStream<Uint8Array<ArrayBuffer>> | null>;\n\n/**\n * Fetches a resource from the network as a Uint8Array<ArrayBuffer> and returns an abortable `FetchTask`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and `responseType: 'bytes'`.\n * @returns A `FetchTask` representing the abortable operation with a `Uint8Array<ArrayBuffer>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: 'bytes';\n}): FetchTask<Uint8Array<ArrayBuffer>>;\n\n/**\n * Fetches a resource from the network and returns an abortable `FetchTask` with a dynamic response type.\n *\n * Use this overload when `responseType` is a `FetchResponseType` union type.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true` and a `FetchResponseType`.\n * @returns A `FetchTask` representing the abortable operation with a `FetchResponseData` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n    responseType: FetchResponseType;\n}): FetchTask<FetchResponseData>;\n\n/**\n * Fetches a resource from the network as a text string.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'text'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `string` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'text';\n}): FetchResponse<string, Error>;\n\n/**\n * Fetches a resource from the network as an ArrayBuffer.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'arraybuffer'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with an `ArrayBuffer` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'arraybuffer';\n}): FetchResponse<ArrayBuffer, Error>;\n\n/**\n * Fetches a resource from the network as a Blob.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'blob'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Blob` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'blob';\n}): FetchResponse<Blob, Error>;\n\n/**\n * Fetches a resource from the network and parses it as JSON.\n *\n * @typeParam T - The expected type of the parsed JSON data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'json'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a response parsed as type `T`.\n */\nexport function fetchT<T>(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'json';\n}): FetchResponse<T | null, Error>;\n\n/**\n * Fetches a resource from the network as a ReadableStream.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'stream'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `ReadableStream<Uint8Array<ArrayBuffer>>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'stream';\n}): FetchResponse<ReadableStream<Uint8Array<ArrayBuffer>> | null, Error>;\n\n/**\n * Fetches a resource from the network as a Uint8Array<ArrayBuffer>.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `responseType: 'bytes'` and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Uint8Array<ArrayBuffer>` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: 'bytes';\n}): FetchResponse<Uint8Array<ArrayBuffer>, Error>;\n\n/**\n * Fetches a resource from the network with a dynamic response type (non-abortable).\n *\n * Use this overload when `responseType` is a `FetchResponseType` union type.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation with a `FetchResponseType`, and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `FetchResponseData` response.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable?: false;\n    responseType: FetchResponseType;\n}): FetchResponse<FetchResponseData, Error>;\n\n/**\n * Fetches a resource from the network and returns an abortable `FetchTask` with a generic `Response`.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, must include `abortable: true`.\n * @returns A `FetchTask` representing the abortable operation with a `Response` object.\n */\nexport function fetchT(url: string | URL, init: FetchInit & {\n    abortable: true;\n}): FetchTask<Response>;\n\n/**\n * Fetches a resource from the network and returns a `FetchResponse` with a generic `Response` object.\n *\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Optional additional options for the fetch operation, and `abortable` must be `false` or omitted.\n * @returns A `FetchResponse` representing the operation with a `Response` object.\n */\nexport function fetchT(url: string | URL, init?: FetchInit & {\n    abortable?: false;\n}): FetchResponse<Response>;\n\n/**\n * Enhanced fetch function that wraps the native Fetch API with additional capabilities.\n *\n * Features:\n * - **Abortable requests**: Set `abortable: true` to get a `FetchTask` with `abort()` method.\n * - **Type-safe responses**: Use `responseType` to automatically parse responses as text, JSON, ArrayBuffer, or Blob.\n * - **Timeout support**: Set `timeout` in milliseconds to auto-abort long-running requests.\n * - **Progress tracking**: Use `onProgress` callback to track download progress (requires Content-Length header).\n * - **Chunk streaming**: Use `onChunk` callback to receive raw data chunks as they arrive.\n * - **Retry support**: Use `retry` to automatically retry failed requests with configurable delay and conditions.\n * - **Result type error handling**: Returns `Result<T, Error>` instead of throwing exceptions.\n *\n * @typeParam T - The expected type of the response data.\n * @param url - The resource to fetch. Can be a URL object or a string representing a URL.\n * @param init - Additional options for the fetch operation, extending standard `RequestInit` with custom properties.\n * @returns A `FetchTask<T>` if `abortable: true`, otherwise a `FetchResponse<T>` (which is `AsyncResult<T, Error>`).\n * @throws {Error} If `url` is not a string or URL object.\n * @throws {Error} If `timeout` is specified but is not a positive number.\n *\n * @example\n * // Basic GET request - returns Response object wrapped in Result\n * const result = await fetchT('https://api.example.com/data');\n * result\n *     .inspect((res) => console.log('Status:', res.status))\n *     .inspectErr((err) => console.error('Error:', err));\n *\n * @example\n * // GET JSON with type safety\n * interface User {\n *     id: number;\n *     name: string;\n * }\n * const result = await fetchT<User>('https://api.example.com/user/1', {\n *     responseType: 'json',\n * });\n * result.inspect((user) => console.log(user.name));\n *\n * @example\n * // POST request with JSON body\n * const result = await fetchT<User>('https://api.example.com/users', {\n *     method: 'POST',\n *     headers: { 'Content-Type': 'application/json' },\n *     body: JSON.stringify({ name: 'John' }),\n *     responseType: 'json',\n * });\n *\n * @example\n * // Abortable request with timeout\n * const task = fetchT('https://api.example.com/data', {\n *     abortable: true,\n *     timeout: 5000, // 5 seconds\n * });\n *\n * // Cancel the request if needed\n * task.abort('User cancelled');\n *\n * // Check if aborted\n * console.log('Aborted:', task.aborted);\n *\n * // Wait for response\n * const result = await task.response;\n *\n * @example\n * // Track download progress\n * const result = await fetchT('https://example.com/large-file.zip', {\n *     responseType: 'blob',\n *     onProgress: (progressResult) => {\n *         progressResult\n *             .inspect(({ completedByteLength, totalByteLength }) => {\n *                 const percent = ((completedByteLength / totalByteLength) * 100).toFixed(1);\n *                 console.log(`Progress: ${percent}%`);\n *             })\n *             .inspectErr((err) => console.warn('Progress unavailable:', err.message));\n *     },\n * });\n *\n * @example\n * // Stream data chunks\n * const chunks: Uint8Array[] = [];\n * const result = await fetchT('https://example.com/stream', {\n *     onChunk: (chunk) => chunks.push(chunk),\n * });\n *\n * @example\n * // Retry with exponential backoff\n * const result = await fetchT('https://api.example.com/data', {\n *     retry: {\n *         retries: 3,\n *         delay: (attempt) => Math.min(1000 * Math.pow(2, attempt - 1), 10000),\n *         when: [500, 502, 503, 504],\n *         onRetry: (error, attempt) => console.log(`Retry ${attempt}: ${error.message}`),\n *     },\n *     responseType: 'json',\n * });\n */\nexport function fetchT(url: string | URL, init?: FetchInit): FetchTask<FetchResponseData> | FetchResponse<FetchResponseData> {\n    // Validate and parse URL\n    const parsedUrl = validateUrl(url);\n\n    const fetchInit = init ?? {};\n\n    const {\n        retries,\n        delay: retryDelay,\n        when: retryWhen,\n        onRetry,\n    } = validateOptions(fetchInit);\n\n    const {\n        // default not abortable\n        abortable = false,\n        responseType,\n        timeout,\n        onProgress,\n        onChunk,\n        ...rest\n    } = fetchInit;\n\n    // Preserve user's original signal before modifications (rest.signal will be reassigned in setSignal)\n    const userSignal = rest.signal;\n\n    // User controller for manual abort (stops all retries)\n    let userController: AbortController | undefined;\n    if (abortable) {\n        userController = new AbortController();\n    }\n\n    /**\n     * Determines if the error should trigger a retry.\n     * By default, only network errors (not FetchError) trigger retries.\n     */\n    const shouldRetry = (error: Error, attempt: number): boolean => {\n        // Never retry on user abort\n        if (error.name === ABORT_ERROR) {\n            return false;\n        }\n\n        if (!retryWhen) {\n            // Default: only retry on network errors (not FetchError/HTTP errors)\n            return !(error instanceof FetchError);\n        }\n\n        if (Array.isArray(retryWhen)) {\n            // Retry on specific HTTP status codes\n            return error instanceof FetchError && retryWhen.includes(error.status);\n        }\n\n        // Custom retry condition\n        return retryWhen(error, attempt);\n    };\n\n    /**\n     * Calculates the delay before the next retry attempt.\n     */\n    const getRetryDelay = (attempt: number): number => {\n        return typeof retryDelay === 'function'\n            ? retryDelay(attempt)\n            : retryDelay;\n    };\n\n    /**\n     * Configures the abort signal for a fetch attempt.\n     *\n     * Combines multiple signals:\n     * - User's external signal (from init.signal)\n     * - Internal abort controller signal (for abortable requests)\n     * - Timeout signal (creates a new one each call for per-attempt timeout)\n     *\n     * Must be called before each fetch attempt to ensure fresh timeout signal on retries.\n     */\n    const configureSignal = (): void => {\n        const signals: AbortSignal[] = [];\n\n        // Merge user's signal from init (if provided)\n        if (userSignal) {\n            signals.push(userSignal);\n        }\n\n        if (userController) {\n            signals.push(userController.signal);\n        }\n\n        if (typeof timeout === 'number') {\n            signals.push(AbortSignal.timeout(timeout));\n        }\n\n        // Combine all signals\n        if (signals.length > 0) {\n            rest.signal = signals.length === 1\n                ? signals[0]\n                : AbortSignal.any(signals);\n        }\n    };\n\n    /**\n     * Performs a single fetch attempt with optional timeout.\n     */\n    const doFetch = async (): AsyncIOResult<FetchResponseData> => {\n        configureSignal();\n\n        try {\n            const response = await fetch(parsedUrl, rest);\n\n            if (!response.ok) {\n                // Cancel the response body to free resources\n                response.body?.cancel().catch(() => {\n                    // Silently ignore stream cancel errors\n                });\n                return Err(new FetchError(response.statusText, response.status));\n            }\n\n            return await processResponse(response);\n        } catch (err) {\n            return Err(err instanceof Error\n                ? err\n                // Non-Error type, most likely an abort reason\n                : wrapAbortReason(err),\n            );\n        }\n    };\n\n    /**\n     * Sets up progress tracking and chunk callbacks using a cloned response.\n     * The original response is returned unchanged for further processing.\n     */\n    const setupProgressCallbacks = async (response: Response): Promise<void> => {\n        let totalByteLength: number | undefined;\n        let completedByteLength = 0;\n\n        if (onProgress) {\n            const contentLength = response.headers.get('content-length');\n            if (contentLength == null) {\n                try {\n                    onProgress(Err(new Error('No content-length in response headers')));\n                } catch {\n                    // Silently ignore user callback errors\n                }\n            } else {\n                totalByteLength = Number.parseInt(contentLength, 10);\n            }\n        }\n\n        const body = response.clone().body as ReadableStream<Uint8Array<ArrayBuffer>>;\n\n        try {\n            for await (const chunk of body) {\n                if (onChunk) {\n                    try {\n                        onChunk(chunk);\n                    } catch {\n                        // Silently ignore user callback errors\n                    }\n                }\n\n                if (onProgress && totalByteLength != null) {\n                    completedByteLength += chunk.byteLength;\n                    try {\n                        onProgress(Ok({\n                            totalByteLength,\n                            completedByteLength,\n                        }));\n                    } catch {\n                        // Silently ignore user callback errors\n                    }\n                }\n            }\n        } catch {\n            // Silently ignore stream read errors\n        }\n    };\n\n    /**\n     * Processes the response based on responseType and callbacks.\n     */\n    const processResponse = async (response: Response): AsyncIOResult<FetchResponseData> => {\n        // Setup progress/chunk callbacks if needed (uses cloned response internally)\n        if (response.body && (onProgress || onChunk)) {\n            setupProgressCallbacks(response);\n        }\n\n        switch (responseType) {\n            case 'json': {\n                // Align with stream behavior: no body yields Ok(null)\n                if (response.body == null) {\n                    return Ok(null);\n                }\n                try {\n                    return Ok(await response.json());\n                } catch {\n                    return Err(new Error('Response is invalid json while responseType is json'));\n                }\n            }\n            case 'text': {\n                return Ok(await response.text());\n            }\n            case 'bytes': {\n                // Use native bytes() if available, otherwise fallback to arrayBuffer()\n                if (typeof response.bytes === 'function') {\n                    return Ok(await response.bytes());\n                }\n                // Fallback for older environments\n                return Ok(new Uint8Array(await response.arrayBuffer()));\n            }\n            case 'arraybuffer': {\n                return Ok(await response.arrayBuffer());\n            }\n            case 'blob': {\n                return Ok(await response.blob());\n            }\n            case 'stream': {\n                return Ok(response.body);\n            }\n            default: {\n                // default return the original Response object to preserve all metadata\n                return Ok(response);\n            }\n        }\n    };\n\n    /**\n     * Performs fetch with retry logic.\n     */\n    const fetchWithRetry = async (): FetchResponse<FetchResponseData, Error> => {\n        let lastError: Error | undefined;\n        let attempt = 0;\n\n        do {\n            // Before retry (not first attempt), wait for delay\n            if (attempt > 0) {\n                // Check if user aborted before delay (e.g., aborted in `when` callback)\n                if (userController?.signal.aborted) {\n                    return Err(userController.signal.reason as Error);\n                }\n\n                const delayMs = getRetryDelay(attempt);\n                // Wait for delay if necessary\n                if (delayMs > 0) {\n                    await delay(delayMs);\n\n                    // Check if user aborted during delay\n                    if (userController?.signal.aborted) {\n                        return Err(userController.signal.reason as Error);\n                    }\n                }\n\n                // Call onRetry right before the actual retry request\n                try {\n                    onRetry?.(lastError as Error, attempt);\n                } catch {\n                    // Silently ignore user callback errors\n                }\n            }\n\n            const result = await doFetch();\n\n            if (result.isOk()) {\n                return result;\n            }\n\n            lastError = result.unwrapErr();\n            attempt++;\n\n            // Check if we should retry\n        } while (attempt <= retries && shouldRetry(lastError, attempt));\n\n        // No more retries or should not retry\n        // lastError is guaranteed to be defined here because:\n        // 1. do...while loop executes at least once\n        // 2. We only reach here if result.isErr()\n        return Err(lastError);\n    };\n\n    const response = fetchWithRetry();\n\n    if (abortable && userController) {\n        return {\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            abort(reason?: any): void {\n                if (reason instanceof Error) {\n                    userController.abort(reason);\n                } else if (reason != null) {\n                    userController.abort(wrapAbortReason(reason));\n                } else {\n                    userController.abort();\n                }\n            },\n\n            get aborted(): boolean {\n                return userController.signal.aborted;\n            },\n\n            get response(): FetchResponse<FetchResponseData> {\n                return response;\n            },\n        };\n    }\n\n    return response;\n}\n\n/**\n * Delays execution for the specified number of milliseconds.\n */\nfunction delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Wraps a non-Error abort reason into an Error with ABORT_ERROR name.\n */\nfunction wrapAbortReason(reason: unknown): Error {\n    const error = new Error(typeof reason === 'string' ? reason : String(reason));\n    error.name = ABORT_ERROR;\n    error.cause = reason;\n    return error;\n}\n\ninterface ParsedRetryOptions extends FetchRetryOptions {\n    retries: number;\n    delay: number | ((attempt: number) => number);\n}\n\n/**\n * Validates fetch options and parses retry configuration.\n */\nfunction validateOptions(init: FetchInit): ParsedRetryOptions {\n    const {\n        responseType,\n        timeout,\n        retry: retryOptions = 0,\n        onProgress,\n        onChunk,\n    } = init;\n\n    if (responseType != null) {\n        const validTypes = ['text', 'arraybuffer', 'blob', 'json', 'bytes', 'stream'];\n        if (!validTypes.includes(responseType)) {\n            throw new TypeError(`responseType must be one of ${ validTypes.join(', ') } but received ${ responseType }`);\n        }\n    }\n\n    if (timeout != null) {\n        if (typeof timeout !== 'number') {\n            throw new TypeError(`timeout must be a number but received ${ typeof timeout }`);\n        }\n        if (timeout <= 0) {\n            throw new Error(`timeout must be a number greater than 0 but received ${ timeout }`);\n        }\n    }\n\n    if (onProgress != null) {\n        if (typeof onProgress !== 'function') {\n            throw new TypeError(`onProgress callback must be a function but received ${ typeof onProgress }`);\n        }\n    }\n\n    if (onChunk != null) {\n        if (typeof onChunk !== 'function') {\n            throw new TypeError(`onChunk callback must be a function but received ${ typeof onChunk }`);\n        }\n    }\n\n    // Parse retry options\n    let retries = 0;\n    let delay: number | ((attempt: number) => number) = 0;\n    let when: ((error: Error, attempt: number) => boolean) | number[] | undefined;\n    let onRetry: ((error: Error, attempt: number) => void) | undefined;\n\n    if (typeof retryOptions === 'number') {\n        retries = retryOptions;\n    } else if (retryOptions && typeof retryOptions === 'object') {\n        retries = retryOptions.retries ?? 0;\n        delay = retryOptions.delay ?? 0;\n        when = retryOptions.when;\n        onRetry = retryOptions.onRetry;\n    }\n\n    if (!Number.isInteger(retries)) {\n        throw new TypeError(`Retry count must be an integer but received ${ retries }`);\n    }\n    if (retries < 0) {\n        throw new Error(`Retry count must be non-negative but received ${ retries }`);\n    }\n\n    if (typeof delay === 'number') {\n        if (delay < 0) {\n            throw new Error(`Retry delay must be a non-negative number but received ${ delay }`);\n        }\n    } else {\n        if (typeof delay !== 'function') {\n            throw new TypeError(`Retry delay must be a number or a function but received ${ typeof delay }`);\n        }\n    }\n\n    if (when != null) {\n        if (!Array.isArray(when) && typeof when !== 'function') {\n            throw new TypeError(`Retry when condition must be an array of status codes or a function but received ${ typeof when }`);\n        }\n    }\n\n    if (onRetry != null) {\n        if (typeof onRetry !== 'function') {\n            throw new TypeError(`Retry onRetry callback must be a function but received ${ typeof onRetry }`);\n        }\n    }\n\n    return { retries, delay, when, onRetry };\n}\n\n/**\n * Validates and parses a URL string or URL object.\n * In browser environments, relative URLs are resolved against `location.href`.\n * In non-browser environments (Node/Deno/Bun), only absolute URLs are valid.\n *\n * @param url - The URL to validate, either a string or URL object.\n * @returns The parsed URL object.\n * @throws {TypeError} If the URL is invalid or cannot be parsed.\n */\nfunction validateUrl(url: string | URL): URL {\n    if (url instanceof URL) {\n        return url;\n    }\n\n    try {\n        // In browser, use location.href as base for relative URLs\n        // In Node/Deno/Bun, location is undefined, so relative URLs will fail\n        const base = typeof location !== 'undefined' ? location.href : undefined;\n        return new URL(url, base);\n    } catch {\n        throw new TypeError(`Invalid URL: ${ url }`);\n    }\n}\n"],"names":["response","delay"],"mappings":"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"}

package/package.json

@@ -3,7 +3,7 @@
   "description": "Type-safe Fetch API wrapper with abortable requests, timeout support, progress tracking, automatic retry, and Rust-like Result error handling.",
   "author": "jiang115jie@gmail.com",
   "license": "MIT",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "type": "module",
   "main": "dist/main.cjs",
   "module": "dist/main.mjs",
@@ -56,19 +56,18 @@
   ],
   "devDependencies": {
     "@eslint/js": "^9.39.2",
-    "@stylistic/eslint-plugin": "^5.6.1",
-    "@vitest/coverage-v8": "^4.0.16",
+    "@stylistic/eslint-plugin": "^5.7.0",
+    "@vitest/coverage-v8": "^4.0.17",
     "eslint": "^9.39.2",
     "msw": "^2.12.7",
-    "typedoc": "^0.28.15",
+    "typedoc": "^0.28.16",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.52.0",
-    "vite": "^7.3.0",
+    "typescript-eslint": "^8.53.0",
+    "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.0.16"
+    "vitest": "^4.0.17"
   },
   "dependencies": {
-    "happy-rusty": "^1.9.0",
-    "tiny-invariant": "^1.3.3"
+    "happy-rusty": "^1.9.0"
   }
 }