@ahoo-wang/fetcher 0.9.1 → 0.9.2

package/README.md

@@ -8,12 +8,13 @@
 [![npm bundle size](https://img.shields.io/bundlephobia/minzip/%40ahoo-wang%2Ffetcher)](https://www.npmjs.com/package/@ahoo-wang/fetcher)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Ahoo-Wang/fetcher)
 
-A modern, ultra-lightweight (1.9kB) HTTP client with built-in path parameters, query parameters, and Axios-like API. 86%
+A modern, ultra-lightweight (2.3KiB) HTTP client with built-in path parameters, query parameters, and Axios-like API.
+83%
 smaller than Axios while providing the same powerful features.
 
 ## 🌟 Features
 
-- **⚡ Ultra-Lightweight**: Only 1.9kB min+gzip - 86% smaller than Axios
+- **⚡ Ultra-Lightweight**: Only 2.3KiB min+gzip - 83% smaller than Axios
 - **🧭 Path & Query Parameters**: Built-in support for path (`{id}`) and query parameters
 - **🔗 Interceptor System**: Request, response, and error interceptors for middleware patterns
 - **⏱️ Timeout Control**: Configurable request timeouts with proper error handling

package/README.zh-CN.md

@@ -8,11 +8,11 @@
 [![npm bundle size](https://img.shields.io/bundlephobia/minzip/%40ahoo-wang%2Ffetcher)](https://www.npmjs.com/package/@ahoo-wang/fetcher)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Ahoo-Wang/fetcher)
 
-一个现代、超轻量级（1.9kB）的 HTTP 客户端，内置路径参数、查询参数和类似 Axios 的 API。比 Axios 小 86%，同时提供相同的强大功能。
+一个现代、超轻量级（2.3kB）的 HTTP 客户端，内置路径参数、查询参数和类似 Axios 的 API。比 Axios 小 83%，同时提供相同的强大功能。
 
 ## 🌟 特性
 
-- **⚡ 超轻量级**：仅 1.9kB min+gzip - 比 Axios 小 86%
+- **⚡ 超轻量级**：仅 2.3KiB min+gzip - 比 Axios 小 83%
 - **🧭 路径和查询参数**：内置支持路径（`{id}`）和查询参数
 - **🔗 拦截器系统**：请求、响应和错误拦截器的中间件模式
 - **⏱️ 超时控制**：可配置的请求超时和适当的错误处理

package/dist/fetcher.d.ts

@@ -65,7 +65,7 @@ export declare class Fetcher implements UrlBuilderCapable, RequestHeadersCapable
      * @param url - The URL path for the request (relative to baseURL if set)
      * @param request - Request configuration including headers, body, parameters, etc.
      * @returns Promise that resolves to the HTTP response
-     * @throws Error if the request fails and no response is generated
+     * @throws FetchError if the request fails and no response is generated
      */
     fetch(url: string, request?: FetchRequestInit): Promise<Response>;
     /**
@@ -81,20 +81,90 @@ export declare class Fetcher implements UrlBuilderCapable, RequestHeadersCapable
      */
     request(request: FetchRequest): Promise<FetchExchange>;
     /**
-     * Processes a FetchExchange through the interceptor chain.
+     * Processes a FetchExchange through the interceptor pipeline.
      *
-     * Orchestrates the complete request lifecycle by applying interceptors in sequence:
-     * 1. Request interceptors - Modify the outgoing request
-     * 2. Response interceptors - Process the incoming response
+     * This method is the core of the Fetcher's interceptor system. It executes the three
+     * phases of interceptors in sequence:
+     * 1. Request interceptors - Process the request before sending
+     * 2. Response interceptors - Process the response after receiving
+     * 3. Error interceptors - Handle any errors that occurred during the process
      *
-     * Error handling follows this flow:
-     * - If an error occurs, error interceptors are invoked
-     * - If an error interceptor produces a response, it's returned
-     * - Otherwise, the original error is re-thrown
+     * The interceptor pipeline follows the Chain of Responsibility pattern, where each
+     * interceptor can modify the exchange object and decide whether to continue or
+     * terminate the chain.
      *
-     * @param fetchExchange - The exchange object containing request and response data
-     * @returns Promise resolving to the processed exchange
-     * @throws Error if an unhandled error occurs during processing
+     * @param fetchExchange - The exchange object containing request, response, and error information
+     * @returns Promise that resolves to the processed FetchExchange
+     * @throws ExchangeError if an unhandled error occurs during processing
+     *
+     * @remarks
+     * The method handles three distinct phases:
+     *
+     * 1. Request Phase: Executes request interceptors which can modify headers, URL, body, etc.
+     *    Built-in interceptors handle URL resolution, body serialization, and actual HTTP execution.
+     *
+     * 2. Response Phase: Executes response interceptors which can transform or validate responses.
+     *    These interceptors only run if the request phase completed without throwing.
+     *
+     * 3. Error Phase: Executes error interceptors when any phase throws an error. Error interceptors
+     *    can handle errors by clearing the error property. If error interceptors clear the error,
+     *    the exchange is returned successfully.
+     *
+     * Error Handling:
+     * - If any interceptor throws an error, the error phase is triggered
+     * - Error interceptors can "fix" errors by clearing the error property on the exchange
+     * - If errors remain after error interceptors run, they are wrapped in ExchangeError
+     *
+     * Order of Execution:
+     * 1. Request interceptors (sorted by order property, ascending)
+     * 2. Response interceptors (sorted by order property, ascending) - only if no error in request phase
+     * 3. Error interceptors (sorted by order property, ascending) - only if an error occurred
+     *
+     * @example
+     * ```typescript
+     * // Create a fetcher with custom interceptors
+     * const fetcher = new Fetcher();
+     *
+     * // Add a request interceptor
+     * fetcher.interceptors.request.use({
+     *   name: 'AuthInterceptor',
+     *   order: 100,
+     *   async intercept(exchange: FetchExchange) {
+     *     exchange.request.headers = {
+     *       ...exchange.request.headers,
+     *       'Authorization': 'Bearer ' + getToken()
+     *     };
+     *   }
+     * });
+     *
+     * // Add a response interceptor
+     * fetcher.interceptors.response.use({
+     *   name: 'ResponseLogger',
+     *   order: 100,
+     *   async intercept(exchange: FetchExchange) {
+     *     console.log(`Response status: ${exchange.response?.status}`);
+     *   }
+     * });
+     *
+     * // Add an error interceptor
+     * fetcher.interceptors.error.use({
+     *   name: 'ErrorLogger',
+     *   order: 100,
+     *   async intercept(exchange: FetchExchange) {
+     *     console.error(`Request to ${exchange.request.url} failed:`, exchange.error);
+     *     // Clear the error to indicate it's been handled
+     *     exchange.error = undefined;
+     *   }
+     * });
+     *
+     * // Create and process an exchange
+     * const request: FetchRequest = {
+     *   url: '/api/users',
+     *   method: HttpMethod.GET
+     * };
+     * const exchange = new FetchExchange(fetcher, request);
+     * const result = await fetcher.exchange(exchange);
+     * ```
      */
     exchange(fetchExchange: FetchExchange): Promise<FetchExchange>;
     /**

package/dist/fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../src/fetcher.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAkB,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,cAAc,EAEd,YAAY,EACZ,gBAAgB,EAEhB,cAAc,EACd,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,cACf,SAAQ,cAAc,EACpB,qBAAqB,EACrB,cAAc;IAChB,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAMD,eAAO,MAAM,eAAe,EAAE,cAG7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,OACX,YAAW,iBAAiB,EAAE,qBAAqB,EAAE,cAAc;IAEnE,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,EAAE,cAAc,CAAmB;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,mBAAmB,CAAC;IAElC;;;;;;;OAOG;gBACS,OAAO,GAAE,cAAgC;IAOrD;;;;;;;;;;OAUG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAU3E;;;;;;;;;;OAUG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAa5D;;;;;;;;;;;;;;;OAeG;IACG,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBpE;;;;;;;;;;OAUG;YACW,WAAW;IAWzB;;;;;;;;;OASG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;;OASG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;;OASG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;CAGrB"}
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../src/fetcher.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAkB,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,cAAc,EAEd,YAAY,EACZ,gBAAgB,EAEhB,cAAc,EACd,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAIxB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,cACf,SAAQ,cAAc,EACpB,qBAAqB,EACrB,cAAc;IAChB,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAMD,eAAO,MAAM,eAAe,EAAE,cAG7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,OACX,YAAW,iBAAiB,EAAE,qBAAqB,EAAE,cAAc;IACnE,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,EAAE,cAAc,CAAmB;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,mBAAmB,CAAC;IAElC;;;;;;;OAOG;gBACS,OAAO,GAAE,cAAgC;IAOrD;;;;;;;;;;OAUG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAU3E;;;;;;;;;;OAUG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAa5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqFG;IACG,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAsBpE;;;;;;;;;;OAUG;YACW,WAAW;IAWzB;;;;;;;;;OASG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;;OASG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;;OASG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;CAGrB"}

package/dist/fetcherError.d.ts

@@ -0,0 +1,122 @@
+import { FetchExchange } from './fetchExchange';
+import { FetchRequest } from './fetchRequest';
+/**
+ * Base error class for all Fetcher-related errors.
+ *
+ * This class extends the native Error class and provides a foundation for
+ * all custom errors thrown by the Fetcher library. It includes support for
+ * error chaining through the cause property.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fetcher.get('/api/users');
+ * } catch (error) {
+ *   if (error instanceof FetcherError) {
+ *     console.log('Fetcher error:', error.message);
+ *     if (error.cause) {
+ *       console.log('Caused by:', error.cause);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class FetcherError extends Error {
+    readonly cause?: (Error | any) | undefined;
+    /**
+     * Creates a new FetcherError instance.
+     *
+     * @param errorMsg - Optional error message. If not provided, will use the cause's message or a default message.
+     * @param cause - Optional underlying error that caused this error.
+     */
+    constructor(errorMsg?: string, cause?: (Error | any) | undefined);
+}
+/**
+ * Custom error class for FetchExchange related errors.
+ *
+ * This error is thrown when there are issues with the HTTP exchange process,
+ * such as when a request fails and no response is generated. It provides
+ * comprehensive information about the failed request through the exchange object.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fetcher.get('/api/users');
+ * } catch (error) {
+ *   if (error instanceof ExchangeError) {
+ *     console.log('Request URL:', error.exchange.request.url);
+ *     console.log('Request method:', error.exchange.request.method);
+ *     if (error.exchange.error) {
+ *       console.log('Underlying error:', error.exchange.error);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class ExchangeError extends FetcherError {
+    readonly exchange: FetchExchange;
+    /**
+     * Creates a new ExchangeError instance.
+     *
+     * @param exchange - The FetchExchange object containing request/response/error information.
+     */
+    constructor(exchange: FetchExchange);
+}
+/**
+ * Custom error class for Fetcher request failures.
+ *
+ * This error is thrown when a fetch request fails and no response is generated.
+ * It wraps the FetchExchange object to provide comprehensive information about the failed request.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fetcher.get('/api/users');
+ * } catch (error) {
+ *   if (error instanceof FetchError) {
+ *     console.log('Failed URL:', error.exchange.request.url);
+ *     console.log('Request headers:', error.exchange.request.headers);
+ *     console.log('Interceptor attributes:', error.exchange.attributes);
+ *   }
+ * }
+ * ```
+ */
+export declare class FetchError extends FetcherError {
+    readonly exchange: FetchExchange;
+    /**
+     * Creates a new FetchError instance.
+     *
+     * @param exchange - The FetchExchange object containing request/response/error information.
+     * @param errorMsg - Optional custom error message. If not provided, will use the exchange's error message.
+     */
+    constructor(exchange: FetchExchange, errorMsg?: string);
+}
+/**
+ * Exception class thrown when an HTTP request times out.
+ *
+ * This error is thrown by the timeoutFetch function when a request exceeds its timeout limit.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const response = await timeoutFetch('https://api.example.com/users', {}, 1000);
+ * } catch (error) {
+ *   if (error instanceof FetchTimeoutError) {
+ *     console.log(`Request timed out after ${error.timeout}ms`);
+ *   }
+ * }
+ * ```
+ */
+export declare class FetchTimeoutError extends FetcherError {
+    /**
+     * The request options that timed out.
+     */
+    request: FetchRequest;
+    /**
+     * Creates a new FetchTimeoutError instance.
+     *
+     * @param request - The request options that timed out
+     */
+    constructor(request: FetchRequest);
+}
+//# sourceMappingURL=fetcherError.d.ts.map

package/dist/fetcherError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcherError.d.ts","sourceRoot":"","sources":["../src/fetcherError.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAa,SAAQ,KAAK;aASnB,KAAK,CAAC,GAAE,KAAK,GAAG,GAAG;IARrC;;;;;OAKG;gBAED,QAAQ,CAAC,EAAE,MAAM,EACD,KAAK,CAAC,GAAE,KAAK,GAAG,GAAG,aAAA;CAetC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAc,SAAQ,YAAY;aAMjB,QAAQ,EAAE,aAAa;IALnD;;;;OAIG;gBACyB,QAAQ,EAAE,aAAa;CASpD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAW,SAAQ,YAAY;aAQxB,QAAQ,EAAE,aAAa;IAPzC;;;;;OAKG;gBAEe,QAAQ,EAAE,aAAa,EACvC,QAAQ,CAAC,EAAE,MAAM;CAUpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;;;OAIG;gBACS,OAAO,EAAE,YAAY;CASlC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './fetcherError';
 export * from './fetcher';
 export * from './fetcherRegistrar';
 export * from './fetchExchange';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/index.es.js

@@ -1,10 +1,56 @@
-function I(r) {
+class a extends Error {
+  /**
+   * Creates a new FetcherError instance.
+   *
+   * @param errorMsg - Optional error message. If not provided, will use the cause's message or a default message.
+   * @param cause - Optional underlying error that caused this error.
+   */
+  constructor(e, t) {
+    const s = e || t?.message || "An error occurred in the fetcher";
+    super(s), this.cause = t, this.name = "FetcherError", t?.stack && (this.stack = t.stack), Object.setPrototypeOf(this, a.prototype);
+  }
+}
+class f extends a {
+  /**
+   * Creates a new ExchangeError instance.
+   *
+   * @param exchange - The FetchExchange object containing request/response/error information.
+   */
+  constructor(e) {
+    const t = e.error?.message || e.response?.statusText || `Request to ${e.request.url} failed during exchange`;
+    super(t, e.error), this.exchange = e, this.name = "ExchangeError", Object.setPrototypeOf(this, f.prototype);
+  }
+}
+class y extends a {
+  /**
+   * Creates a new FetchError instance.
+   *
+   * @param exchange - The FetchExchange object containing request/response/error information.
+   * @param errorMsg - Optional custom error message. If not provided, will use the exchange's error message.
+   */
+  constructor(e, t) {
+    const s = t || e.error?.message || `Request to ${e.request.url} failed with no response`;
+    super(s, e.error), this.exchange = e, this.name = "FetchError", Object.setPrototypeOf(this, y.prototype);
+  }
+}
+class E extends a {
+  /**
+   * Creates a new FetchTimeoutError instance.
+   *
+   * @param request - The request options that timed out
+   */
+  constructor(e) {
+    const t = e.method || "GET", s = `Request timeout of ${e.timeout}ms exceeded for ${t} ${e.url}`;
+    super(s), this.name = "FetchTimeoutError", this.request = e, Object.setPrototypeOf(this, E.prototype);
+  }
+}
+function w(r) {
   return /^([a-z][a-z\d+\-.]*:)?\/\//i.test(r);
 }
-function b(r, e) {
-  return I(e) ? e : e ? r.replace(/\/?\/$/, "") + "/" + e.replace(/^\/+/, "") : r;
+function P(r, e) {
+  return w(e) ? e : e ? r.replace(/\/?\/$/, "") + "/" + e.replace(/^\/+/, "") : r;
 }
-class g {
+class R {
   /**
    * Initializes a new UrlBuilder instance.
    *
@@ -37,13 +83,13 @@ class g {
    * ```
    */
   build(e, t) {
-    const s = t?.path, n = t?.query, i = b(this.baseURL, e);
-    let o = this.interpolateUrl(i, s);
-    if (n) {
-      const u = new URLSearchParams(n).toString();
-      u && (o += "?" + u);
+    const s = t?.path, o = t?.query, i = P(this.baseURL, e);
+    let n = this.interpolateUrl(i, s);
+    if (o) {
+      const u = new URLSearchParams(o).toString();
+      u && (n += "?" + u);
     }
-    return o;
+    return n;
   }
   /**
    * Resolves a complete URL from a FetchRequest.
@@ -85,57 +131,46 @@ class g {
    * ```
    */
   interpolateUrl(e, t) {
-    return t ? e.replace(/{([^}]+)}/g, (s, n) => {
-      const i = t[n];
+    return t ? e.replace(/{([^}]+)}/g, (s, o) => {
+      const i = t[o];
       if (i === void 0)
-        throw new Error(`Missing required path parameter: ${n}`);
+        throw new Error(`Missing required path parameter: ${o}`);
       return String(i);
     }) : e;
   }
 }
-function w(r, e) {
+function F(r, e) {
   return typeof r < "u" ? r : e;
 }
-class p extends Error {
-  /**
-   * Creates a new FetchTimeoutError instance.
-   *
-   * @param request - The request options that timed out
-   */
-  constructor(e) {
-    const t = e.method || "GET", s = `Request timeout of ${e.timeout}ms exceeded for ${t} ${e.url}`;
-    super(s), this.name = "FetchTimeoutError", this.request = e, Object.setPrototypeOf(this, p.prototype);
-  }
-}
-async function P(r) {
+async function A(r) {
   const e = r.url, t = r.timeout, s = r;
   if (!t)
     return fetch(e, s);
-  const n = new AbortController(), i = {
+  const o = new AbortController(), i = {
     ...s,
-    signal: n.signal
+    signal: o.signal
   };
-  let o = null;
-  const u = new Promise((L, E) => {
-    o = setTimeout(() => {
-      o && clearTimeout(o);
-      const y = new p(r);
-      n.abort(y), E(y);
+  let n = null;
+  const u = new Promise((D, I) => {
+    n = setTimeout(() => {
+      n && clearTimeout(n);
+      const b = new E(r);
+      o.abort(b), I(b);
     }, t);
   });
   try {
     return await Promise.race([fetch(e, i), u]);
   } finally {
-    o && clearTimeout(o);
+    n && clearTimeout(n);
   }
 }
-function a(r, e) {
+function h(r, e) {
   return e ? r.filter(e).sort((t, s) => t.order - s.order) : [...r].sort((t, s) => t.order - s.order);
 }
 var c = /* @__PURE__ */ ((r) => (r.GET = "GET", r.POST = "POST", r.PUT = "PUT", r.DELETE = "DELETE", r.PATCH = "PATCH", r.HEAD = "HEAD", r.OPTIONS = "OPTIONS", r))(c || {});
-const v = "Content-Type";
-var f = /* @__PURE__ */ ((r) => (r.APPLICATION_JSON = "application/json", r.TEXT_EVENT_STREAM = "text/event-stream", r))(f || {});
-class R {
+const G = "Content-Type";
+var T = /* @__PURE__ */ ((r) => (r.APPLICATION_JSON = "application/json", r.TEXT_EVENT_STREAM = "text/event-stream", r))(T || {});
+class O {
   constructor() {
     this.name = "RequestBodyInterceptor", this.order = Number.MIN_SAFE_INTEGER + 200;
   }
@@ -183,11 +218,11 @@ class R {
       return;
     const s = { ...t };
     s.body = JSON.stringify(t.body), s.headers || (s.headers = {});
-    const n = s.headers;
-    n["Content-Type"] || (n["Content-Type"] = f.APPLICATION_JSON), e.request = s;
+    const o = s.headers;
+    o["Content-Type"] || (o["Content-Type"] = T.APPLICATION_JSON), e.request = s;
   }
 }
-class F {
+class q {
   constructor() {
     this.name = "FetchInterceptor", this.order = Number.MAX_SAFE_INTEGER - 100;
   }
@@ -217,10 +252,10 @@ class F {
    * console.log(exchange.response); // HTTP response object
    */
   async intercept(e) {
-    e.response = await P(e.request);
+    e.response = await A(e.request);
   }
 }
-class A {
+class N {
   constructor() {
     this.name = "UrlResolveInterceptor", this.order = Number.MIN_SAFE_INTEGER + 100;
   }
@@ -234,7 +269,7 @@ class A {
     t.url = e.fetcher.urlBuilder.resolveRequestUrl(t);
   }
 }
-class h {
+class d {
   /**
    * Initializes a new InterceptorManager instance.
    *
@@ -245,7 +280,7 @@ class h {
    * upon construction.
    */
   constructor(e = []) {
-    this.sortedInterceptors = [], this.sortedInterceptors = a(e);
+    this.sortedInterceptors = [], this.sortedInterceptors = h(e);
   }
   /**
    * Gets the name of this interceptor manager.
@@ -277,7 +312,7 @@ class h {
    * After adding, interceptors are automatically sorted by their order property.
    */
   use(e) {
-    return this.sortedInterceptors.some((t) => t.name === e.name) ? !1 : (this.sortedInterceptors = a([
+    return this.sortedInterceptors.some((t) => t.name === e.name) ? !1 : (this.sortedInterceptors = h([
       ...this.sortedInterceptors,
       e
     ]), !0);
@@ -291,7 +326,7 @@ class h {
    */
   eject(e) {
     const t = this.sortedInterceptors;
-    return this.sortedInterceptors = a(
+    return this.sortedInterceptors = h(
       t,
       (s) => s.name !== e
     ), t.length !== this.sortedInterceptors.length;
@@ -321,18 +356,18 @@ class h {
       await t.intercept(e);
   }
 }
-class N {
+class S {
   constructor() {
-    this.request = new h([
-      new A(),
-      new R(),
-      new F()
-    ]), this.response = new h(), this.error = new h();
+    this.request = new d([
+      new N(),
+      new O(),
+      new q()
+    ]), this.response = new d(), this.error = new d();
   }
 }
-class S {
-  constructor(e, t, s, n) {
-    this.attributes = {}, this.fetcher = e, this.request = t, this.response = s, this.error = n;
+class U {
+  constructor(e, t, s, o) {
+    this.attributes = {}, this.fetcher = e, this.request = t, this.response = s, this.error = o;
   }
   /**
    * Checks if the exchange has an error.
@@ -351,17 +386,17 @@ class S {
     return !!this.response;
   }
 }
-function d(r, e) {
+function l(r, e) {
   if (!(r === void 0 && e === void 0))
     return e === void 0 ? r : r === void 0 ? e : { ...r, ...e };
 }
-const l = {
-  "Content-Type": f.APPLICATION_JSON
-}, T = {
+const p = {
+  "Content-Type": T.APPLICATION_JSON
+}, g = {
   baseURL: "",
-  headers: l
+  headers: p
 };
-class q {
+class _ {
   /**
    * Initializes a new Fetcher instance with optional configuration.
    *
@@ -370,8 +405,8 @@ class q {
    *
    * @param options - Configuration options for the Fetcher instance
    */
-  constructor(e = T) {
-    this.headers = l, this.urlBuilder = new g(e.baseURL), this.headers = e.headers ?? l, this.timeout = e.timeout, this.interceptors = e.interceptors ?? new N();
+  constructor(e = g) {
+    this.headers = p, this.urlBuilder = new R(e.baseURL), this.headers = e.headers ?? p, this.timeout = e.timeout, this.interceptors = e.interceptors ?? new S();
   }
   /**
    * Executes an HTTP request with the specified URL and options.
@@ -382,15 +417,15 @@ class q {
    * @param url - The URL path for the request (relative to baseURL if set)
    * @param request - Request configuration including headers, body, parameters, etc.
    * @returns Promise that resolves to the HTTP response
-   * @throws Error if the request fails and no response is generated
+   * @throws FetchError if the request fails and no response is generated
    */
   async fetch(e, t = {}) {
     const s = t;
     s.url = e;
-    const n = await this.request(s);
-    if (!n.response)
-      throw new Error(`Request to ${s.url} failed with no response`);
-    return n.response;
+    const o = await this.request(s);
+    if (!o.response)
+      throw new y(o, `Request to ${s.url} failed with no response`);
+    return o.response;
   }
   /**
    * Processes an HTTP request through the Fetcher's internal workflow.
@@ -404,36 +439,106 @@ class q {
    * @throws Error if an unhandled error occurs during request processing
    */
   async request(e) {
-    const t = d(e.headers, this.headers), s = {
+    const t = l(e.headers, this.headers), s = {
       ...e,
       headers: t,
-      timeout: w(e.timeout, this.timeout)
-    }, n = new S(this, s);
-    return this.exchange(n);
+      timeout: F(e.timeout, this.timeout)
+    }, o = new U(this, s);
+    return this.exchange(o);
   }
   /**
-   * Processes a FetchExchange through the interceptor chain.
+   * Processes a FetchExchange through the interceptor pipeline.
+   *
+   * This method is the core of the Fetcher's interceptor system. It executes the three
+   * phases of interceptors in sequence:
+   * 1. Request interceptors - Process the request before sending
+   * 2. Response interceptors - Process the response after receiving
+   * 3. Error interceptors - Handle any errors that occurred during the process
+   *
+   * The interceptor pipeline follows the Chain of Responsibility pattern, where each
+   * interceptor can modify the exchange object and decide whether to continue or
+   * terminate the chain.
+   *
+   * @param fetchExchange - The exchange object containing request, response, and error information
+   * @returns Promise that resolves to the processed FetchExchange
+   * @throws ExchangeError if an unhandled error occurs during processing
+   *
+   * @remarks
+   * The method handles three distinct phases:
+   *
+   * 1. Request Phase: Executes request interceptors which can modify headers, URL, body, etc.
+   *    Built-in interceptors handle URL resolution, body serialization, and actual HTTP execution.
+   *
+   * 2. Response Phase: Executes response interceptors which can transform or validate responses.
+   *    These interceptors only run if the request phase completed without throwing.
    *
-   * Orchestrates the complete request lifecycle by applying interceptors in sequence:
-   * 1. Request interceptors - Modify the outgoing request
-   * 2. Response interceptors - Process the incoming response
+   * 3. Error Phase: Executes error interceptors when any phase throws an error. Error interceptors
+   *    can handle errors by clearing the error property. If error interceptors clear the error,
+   *    the exchange is returned successfully.
    *
-   * Error handling follows this flow:
-   * - If an error occurs, error interceptors are invoked
-   * - If an error interceptor produces a response, it's returned
-   * - Otherwise, the original error is re-thrown
+   * Error Handling:
+   * - If any interceptor throws an error, the error phase is triggered
+   * - Error interceptors can "fix" errors by clearing the error property on the exchange
+   * - If errors remain after error interceptors run, they are wrapped in ExchangeError
    *
-   * @param fetchExchange - The exchange object containing request and response data
-   * @returns Promise resolving to the processed exchange
-   * @throws Error if an unhandled error occurs during processing
+   * Order of Execution:
+   * 1. Request interceptors (sorted by order property, ascending)
+   * 2. Response interceptors (sorted by order property, ascending) - only if no error in request phase
+   * 3. Error interceptors (sorted by order property, ascending) - only if an error occurred
+   *
+   * @example
+   * ```typescript
+   * // Create a fetcher with custom interceptors
+   * const fetcher = new Fetcher();
+   *
+   * // Add a request interceptor
+   * fetcher.interceptors.request.use({
+   *   name: 'AuthInterceptor',
+   *   order: 100,
+   *   async intercept(exchange: FetchExchange) {
+   *     exchange.request.headers = {
+   *       ...exchange.request.headers,
+   *       'Authorization': 'Bearer ' + getToken()
+   *     };
+   *   }
+   * });
+   *
+   * // Add a response interceptor
+   * fetcher.interceptors.response.use({
+   *   name: 'ResponseLogger',
+   *   order: 100,
+   *   async intercept(exchange: FetchExchange) {
+   *     console.log(`Response status: ${exchange.response?.status}`);
+   *   }
+   * });
+   *
+   * // Add an error interceptor
+   * fetcher.interceptors.error.use({
+   *   name: 'ErrorLogger',
+   *   order: 100,
+   *   async intercept(exchange: FetchExchange) {
+   *     console.error(`Request to ${exchange.request.url} failed:`, exchange.error);
+   *     // Clear the error to indicate it's been handled
+   *     exchange.error = undefined;
+   *   }
+   * });
+   *
+   * // Create and process an exchange
+   * const request: FetchRequest = {
+   *   url: '/api/users',
+   *   method: HttpMethod.GET
+   * };
+   * const exchange = new FetchExchange(fetcher, request);
+   * const result = await fetcher.exchange(exchange);
+   * ```
    */
   async exchange(e) {
     try {
       return await this.interceptors.request.intercept(e), await this.interceptors.response.intercept(e), e;
     } catch (t) {
-      if (e.error = t, await this.interceptors.error.intercept(e), e.hasResponse())
+      if (e.error = t, await this.interceptors.error.intercept(e), !e.hasError())
         return e;
-      throw e.error;
+      throw new f(e);
     }
   }
   /**
@@ -542,7 +647,7 @@ class q {
   }
 }
 const m = "default";
-class O {
+class L {
   constructor() {
     this.registrar = /* @__PURE__ */ new Map();
   }
@@ -642,31 +747,31 @@ class O {
     return new Map(this.registrar);
   }
 }
-const U = new O();
-function C(r, e) {
+const v = new L();
+function j(r, e) {
   if (Object.keys(r).length === 0)
     return e;
   if (Object.keys(e).length === 0)
     return r;
   const t = {
-    path: d(r.urlParams?.path, e.urlParams?.path),
-    query: d(r.urlParams?.query, e.urlParams?.query)
+    path: l(r.urlParams?.path, e.urlParams?.path),
+    query: l(r.urlParams?.query, e.urlParams?.query)
   }, s = {
     ...r.headers,
     ...e.headers
-  }, n = e.method ?? r.method, i = e.body ?? r.body, o = e.timeout ?? r.timeout, u = e.signal ?? r.signal;
+  }, o = e.method ?? r.method, i = e.body ?? r.body, n = e.timeout ?? r.timeout, u = e.signal ?? r.signal;
   return {
     ...r,
     ...e,
-    method: n,
+    method: o,
     urlParams: t,
     headers: s,
     body: i,
-    timeout: o,
+    timeout: n,
     signal: u
   };
 }
-class _ extends q {
+class C extends _ {
   /**
    * Create a NamedFetcher instance and automatically register it with the global fetcherRegistrar
    *
@@ -684,35 +789,38 @@ class _ extends q {
    *   headers: { 'Authorization': 'Bearer token' }
    * });
    */
-  constructor(e, t = T) {
-    super(t), this.name = e, U.register(e, this);
+  constructor(e, t = g) {
+    super(t), this.name = e, v.register(e, this);
   }
 }
-const D = new _(m);
+const $ = new C(m);
 export {
-  v as ContentTypeHeader,
-  f as ContentTypeValues,
+  G as ContentTypeHeader,
+  T as ContentTypeValues,
   m as DEFAULT_FETCHER_NAME,
-  T as DEFAULT_OPTIONS,
-  S as FetchExchange,
-  F as FetchInterceptor,
-  p as FetchTimeoutError,
-  q as Fetcher,
-  N as FetcherInterceptors,
-  O as FetcherRegistrar,
+  g as DEFAULT_OPTIONS,
+  f as ExchangeError,
+  y as FetchError,
+  U as FetchExchange,
+  q as FetchInterceptor,
+  E as FetchTimeoutError,
+  _ as Fetcher,
+  a as FetcherError,
+  S as FetcherInterceptors,
+  L as FetcherRegistrar,
   c as HttpMethod,
-  h as InterceptorManager,
-  _ as NamedFetcher,
-  R as RequestBodyInterceptor,
-  g as UrlBuilder,
-  A as UrlResolveInterceptor,
-  b as combineURLs,
-  D as fetcher,
-  U as fetcherRegistrar,
-  I as isAbsoluteURL,
-  d as mergeRecords,
-  C as mergeRequest,
-  w as resolveTimeout,
-  P as timeoutFetch,
-  a as toSorted
+  d as InterceptorManager,
+  C as NamedFetcher,
+  O as RequestBodyInterceptor,
+  R as UrlBuilder,
+  N as UrlResolveInterceptor,
+  P as combineURLs,
+  $ as fetcher,
+  v as fetcherRegistrar,
+  w as isAbsoluteURL,
+  l as mergeRecords,
+  j as mergeRequest,
+  F as resolveTimeout,
+  A as timeoutFetch,
+  h as toSorted
 };

package/dist/index.umd.js

@@ -1 +1 @@
-(function(n,a){typeof exports=="object"&&typeof module<"u"?a(exports):typeof define=="function"&&define.amd?define(["exports"],a):(n=typeof globalThis<"u"?globalThis:n||self,a(n.Fetcher={}))})(this,(function(n){"use strict";function a(r){return/^([a-z][a-z\d+\-.]*:)?\/\//i.test(r)}function g(r,e){return a(e)?e:e?r.replace(/\/?\/$/,"")+"/"+e.replace(/^\/+/,""):r}class I{constructor(e){this.baseURL=e}build(e,t){const s=t?.path,o=t?.query,u=g(this.baseURL,e);let i=this.interpolateUrl(u,s);if(o){const h=new URLSearchParams(o).toString();h&&(i+="?"+h)}return i}resolveRequestUrl(e){return this.build(e.url,e.urlParams)}interpolateUrl(e,t){return t?e.replace(/{([^}]+)}/g,(s,o)=>{const u=t[o];if(u===void 0)throw new Error(`Missing required path parameter: ${o}`);return String(u)}):e}}function b(r,e){return typeof r<"u"?r:e}class d extends Error{constructor(e){const t=e.method||"GET",s=`Request timeout of ${e.timeout}ms exceeded for ${t} ${e.url}`;super(s),this.name="FetchTimeoutError",this.request=e,Object.setPrototypeOf(this,d.prototype)}}async function F(r){const e=r.url,t=r.timeout,s=r;if(!t)return fetch(e,s);const o=new AbortController,u={...s,signal:o.signal};let i=null;const h=new Promise((B,D)=>{i=setTimeout(()=>{i&&clearTimeout(i);const _=new d(r);o.abort(_),D(_)},t)});try{return await Promise.race([fetch(e,u),h])}finally{i&&clearTimeout(i)}}function l(r,e){return e?r.filter(e).sort((t,s)=>t.order-s.order):[...r].sort((t,s)=>t.order-s.order)}var c=(r=>(r.GET="GET",r.POST="POST",r.PUT="PUT",r.DELETE="DELETE",r.PATCH="PATCH",r.HEAD="HEAD",r.OPTIONS="OPTIONS",r))(c||{});const L="Content-Type";var m=(r=>(r.APPLICATION_JSON="application/json",r.TEXT_EVENT_STREAM="text/event-stream",r))(m||{});class R{constructor(){this.name="RequestBodyInterceptor",this.order=Number.MIN_SAFE_INTEGER+200}intercept(e){const t=e.request;if(t.body===void 0||t.body===null||typeof t.body!="object"||t.body instanceof ArrayBuffer||ArrayBuffer.isView(t.body)||t.body instanceof Blob||t.body instanceof File||t.body instanceof URLSearchParams||t.body instanceof FormData||t.body instanceof ReadableStream)return;const s={...t};s.body=JSON.stringify(t.body),s.headers||(s.headers={});const o=s.headers;o["Content-Type"]||(o["Content-Type"]=m.APPLICATION_JSON),e.request=s}}class w{constructor(){this.name="FetchInterceptor",this.order=Number.MAX_SAFE_INTEGER-100}async intercept(e){e.response=await F(e.request)}}class P{constructor(){this.name="UrlResolveInterceptor",this.order=Number.MIN_SAFE_INTEGER+100}intercept(e){const t=e.request;t.url=e.fetcher.urlBuilder.resolveRequestUrl(t)}}class f{constructor(e=[]){this.sortedInterceptors=[],this.sortedInterceptors=l(e)}get name(){return this.constructor.name}get order(){return Number.MIN_SAFE_INTEGER}use(e){return this.sortedInterceptors.some(t=>t.name===e.name)?!1:(this.sortedInterceptors=l([...this.sortedInterceptors,e]),!0)}eject(e){const t=this.sortedInterceptors;return this.sortedInterceptors=l(t,s=>s.name!==e),t.length!==this.sortedInterceptors.length}clear(){this.sortedInterceptors=[]}async intercept(e){for(const t of this.sortedInterceptors)await t.intercept(e)}}class A{constructor(){this.request=new f([new P,new R,new w]),this.response=new f,this.error=new f}}class N{constructor(e,t,s,o){this.attributes={},this.fetcher=e,this.request=t,this.response=s,this.error=o}hasError(){return!!this.error}hasResponse(){return!!this.response}}function y(r,e){if(!(r===void 0&&e===void 0))return e===void 0?r:r===void 0?e:{...r,...e}}const p={"Content-Type":m.APPLICATION_JSON},E={baseURL:"",headers:p};class S{constructor(e=E){this.headers=p,this.urlBuilder=new I(e.baseURL),this.headers=e.headers??p,this.timeout=e.timeout,this.interceptors=e.interceptors??new A}async fetch(e,t={}){const s=t;s.url=e;const o=await this.request(s);if(!o.response)throw new Error(`Request to ${s.url} failed with no response`);return o.response}async request(e){const t=y(e.headers,this.headers),s={...e,headers:t,timeout:b(e.timeout,this.timeout)},o=new N(this,s);return this.exchange(o)}async exchange(e){try{return await this.interceptors.request.intercept(e),await this.interceptors.response.intercept(e),e}catch(t){if(e.error=t,await this.interceptors.error.intercept(e),e.hasResponse())return e;throw e.error}}async methodFetch(e,t,s={}){return this.fetch(t,{...s,method:e})}async get(e,t={}){return this.methodFetch(c.GET,e,t)}async post(e,t={}){return this.methodFetch(c.POST,e,t)}async put(e,t={}){return this.methodFetch(c.PUT,e,t)}async delete(e,t={}){return this.methodFetch(c.DELETE,e,t)}async patch(e,t={}){return this.methodFetch(c.PATCH,e,t)}async head(e,t={}){return this.methodFetch(c.HEAD,e,t)}async options(e,t={}){return this.methodFetch(c.OPTIONS,e,t)}}const T="default";class q{constructor(){this.registrar=new Map}register(e,t){this.registrar.set(e,t)}unregister(e){return this.registrar.delete(e)}get(e){return this.registrar.get(e)}requiredGet(e){const t=this.get(e);if(!t)throw new Error(`Fetcher ${e} not found`);return t}get default(){return this.requiredGet(T)}set default(e){this.register(T,e)}get fetchers(){return new Map(this.registrar)}}const O=new q;function v(r,e){if(Object.keys(r).length===0)return e;if(Object.keys(e).length===0)return r;const t={path:y(r.urlParams?.path,e.urlParams?.path),query:y(r.urlParams?.query,e.urlParams?.query)},s={...r.headers,...e.headers},o=e.method??r.method,u=e.body??r.body,i=e.timeout??r.timeout,h=e.signal??r.signal;return{...r,...e,method:o,urlParams:t,headers:s,body:u,timeout:i,signal:h}}class U extends S{constructor(e,t=E){super(t),this.name=e,O.register(e,this)}}const C=new U(T);n.ContentTypeHeader=L,n.ContentTypeValues=m,n.DEFAULT_FETCHER_NAME=T,n.DEFAULT_OPTIONS=E,n.FetchExchange=N,n.FetchInterceptor=w,n.FetchTimeoutError=d,n.Fetcher=S,n.FetcherInterceptors=A,n.FetcherRegistrar=q,n.HttpMethod=c,n.InterceptorManager=f,n.NamedFetcher=U,n.RequestBodyInterceptor=R,n.UrlBuilder=I,n.UrlResolveInterceptor=P,n.combineURLs=g,n.fetcher=C,n.fetcherRegistrar=O,n.isAbsoluteURL=a,n.mergeRecords=y,n.mergeRequest=v,n.resolveTimeout=b,n.timeoutFetch=F,n.toSorted=l,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));
+(function(n,i){typeof exports=="object"&&typeof module<"u"?i(exports):typeof define=="function"&&define.amd?define(["exports"],i):(n=typeof globalThis<"u"?globalThis:n||self,i(n.Fetcher={}))})(this,(function(n){"use strict";class i extends Error{constructor(e,t){const s=e||t?.message||"An error occurred in the fetcher";super(s),this.cause=t,this.name="FetcherError",t?.stack&&(this.stack=t.stack),Object.setPrototypeOf(this,i.prototype)}}class d extends i{constructor(e){const t=e.error?.message||e.response?.statusText||`Request to ${e.request.url} failed during exchange`;super(t,e.error),this.exchange=e,this.name="ExchangeError",Object.setPrototypeOf(this,d.prototype)}}class l extends i{constructor(e,t){const s=t||e.error?.message||`Request to ${e.request.url} failed with no response`;super(s,e.error),this.exchange=e,this.name="FetchError",Object.setPrototypeOf(this,l.prototype)}}class m extends i{constructor(e){const t=e.method||"GET",s=`Request timeout of ${e.timeout}ms exceeded for ${t} ${e.url}`;super(s),this.name="FetchTimeoutError",this.request=e,Object.setPrototypeOf(this,m.prototype)}}function F(r){return/^([a-z][a-z\d+\-.]*:)?\/\//i.test(r)}function I(r,e){return F(e)?e:e?r.replace(/\/?\/$/,"")+"/"+e.replace(/^\/+/,""):r}class R{constructor(e){this.baseURL=e}build(e,t){const s=t?.path,o=t?.query,a=I(this.baseURL,e);let c=this.interpolateUrl(a,s);if(o){const h=new URLSearchParams(o).toString();h&&(c+="?"+h)}return c}resolveRequestUrl(e){return this.build(e.url,e.urlParams)}interpolateUrl(e,t){return t?e.replace(/{([^}]+)}/g,(s,o)=>{const a=t[o];if(a===void 0)throw new Error(`Missing required path parameter: ${o}`);return String(a)}):e}}function P(r,e){return typeof r<"u"?r:e}async function w(r){const e=r.url,t=r.timeout,s=r;if(!t)return fetch(e,s);const o=new AbortController,a={...s,signal:o.signal};let c=null;const h=new Promise((G,B)=>{c=setTimeout(()=>{c&&clearTimeout(c);const C=new m(r);o.abort(C),B(C)},t)});try{return await Promise.race([fetch(e,a),h])}finally{c&&clearTimeout(c)}}function f(r,e){return e?r.filter(e).sort((t,s)=>t.order-s.order):[...r].sort((t,s)=>t.order-s.order)}var u=(r=>(r.GET="GET",r.POST="POST",r.PUT="PUT",r.DELETE="DELETE",r.PATCH="PATCH",r.HEAD="HEAD",r.OPTIONS="OPTIONS",r))(u||{});const D="Content-Type";var y=(r=>(r.APPLICATION_JSON="application/json",r.TEXT_EVENT_STREAM="text/event-stream",r))(y||{});class A{constructor(){this.name="RequestBodyInterceptor",this.order=Number.MIN_SAFE_INTEGER+200}intercept(e){const t=e.request;if(t.body===void 0||t.body===null||typeof t.body!="object"||t.body instanceof ArrayBuffer||ArrayBuffer.isView(t.body)||t.body instanceof Blob||t.body instanceof File||t.body instanceof URLSearchParams||t.body instanceof FormData||t.body instanceof ReadableStream)return;const s={...t};s.body=JSON.stringify(t.body),s.headers||(s.headers={});const o=s.headers;o["Content-Type"]||(o["Content-Type"]=y.APPLICATION_JSON),e.request=s}}class O{constructor(){this.name="FetchInterceptor",this.order=Number.MAX_SAFE_INTEGER-100}async intercept(e){e.response=await w(e.request)}}class q{constructor(){this.name="UrlResolveInterceptor",this.order=Number.MIN_SAFE_INTEGER+100}intercept(e){const t=e.request;t.url=e.fetcher.urlBuilder.resolveRequestUrl(t)}}class p{constructor(e=[]){this.sortedInterceptors=[],this.sortedInterceptors=f(e)}get name(){return this.constructor.name}get order(){return Number.MIN_SAFE_INTEGER}use(e){return this.sortedInterceptors.some(t=>t.name===e.name)?!1:(this.sortedInterceptors=f([...this.sortedInterceptors,e]),!0)}eject(e){const t=this.sortedInterceptors;return this.sortedInterceptors=f(t,s=>s.name!==e),t.length!==this.sortedInterceptors.length}clear(){this.sortedInterceptors=[]}async intercept(e){for(const t of this.sortedInterceptors)await t.intercept(e)}}class N{constructor(){this.request=new p([new q,new A,new O]),this.response=new p,this.error=new p}}class S{constructor(e,t,s,o){this.attributes={},this.fetcher=e,this.request=t,this.response=s,this.error=o}hasError(){return!!this.error}hasResponse(){return!!this.response}}function E(r,e){if(!(r===void 0&&e===void 0))return e===void 0?r:r===void 0?e:{...r,...e}}const g={"Content-Type":y.APPLICATION_JSON},b={baseURL:"",headers:g};class U{constructor(e=b){this.headers=g,this.urlBuilder=new R(e.baseURL),this.headers=e.headers??g,this.timeout=e.timeout,this.interceptors=e.interceptors??new N}async fetch(e,t={}){const s=t;s.url=e;const o=await this.request(s);if(!o.response)throw new l(o,`Request to ${s.url} failed with no response`);return o.response}async request(e){const t=E(e.headers,this.headers),s={...e,headers:t,timeout:P(e.timeout,this.timeout)},o=new S(this,s);return this.exchange(o)}async exchange(e){try{return await this.interceptors.request.intercept(e),await this.interceptors.response.intercept(e),e}catch(t){if(e.error=t,await this.interceptors.error.intercept(e),!e.hasError())return e;throw new d(e)}}async methodFetch(e,t,s={}){return this.fetch(t,{...s,method:e})}async get(e,t={}){return this.methodFetch(u.GET,e,t)}async post(e,t={}){return this.methodFetch(u.POST,e,t)}async put(e,t={}){return this.methodFetch(u.PUT,e,t)}async delete(e,t={}){return this.methodFetch(u.DELETE,e,t)}async patch(e,t={}){return this.methodFetch(u.PATCH,e,t)}async head(e,t={}){return this.methodFetch(u.HEAD,e,t)}async options(e,t={}){return this.methodFetch(u.OPTIONS,e,t)}}const T="default";class L{constructor(){this.registrar=new Map}register(e,t){this.registrar.set(e,t)}unregister(e){return this.registrar.delete(e)}get(e){return this.registrar.get(e)}requiredGet(e){const t=this.get(e);if(!t)throw new Error(`Fetcher ${e} not found`);return t}get default(){return this.requiredGet(T)}set default(e){this.register(T,e)}get fetchers(){return new Map(this.registrar)}}const _=new L;function j(r,e){if(Object.keys(r).length===0)return e;if(Object.keys(e).length===0)return r;const t={path:E(r.urlParams?.path,e.urlParams?.path),query:E(r.urlParams?.query,e.urlParams?.query)},s={...r.headers,...e.headers},o=e.method??r.method,a=e.body??r.body,c=e.timeout??r.timeout,h=e.signal??r.signal;return{...r,...e,method:o,urlParams:t,headers:s,body:a,timeout:c,signal:h}}class v extends U{constructor(e,t=b){super(t),this.name=e,_.register(e,this)}}const M=new v(T);n.ContentTypeHeader=D,n.ContentTypeValues=y,n.DEFAULT_FETCHER_NAME=T,n.DEFAULT_OPTIONS=b,n.ExchangeError=d,n.FetchError=l,n.FetchExchange=S,n.FetchInterceptor=O,n.FetchTimeoutError=m,n.Fetcher=U,n.FetcherError=i,n.FetcherInterceptors=N,n.FetcherRegistrar=L,n.HttpMethod=u,n.InterceptorManager=p,n.NamedFetcher=v,n.RequestBodyInterceptor=A,n.UrlBuilder=R,n.UrlResolveInterceptor=q,n.combineURLs=I,n.fetcher=M,n.fetcherRegistrar=_,n.isAbsoluteURL=F,n.mergeRecords=E,n.mergeRequest=j,n.resolveTimeout=P,n.timeoutFetch=w,n.toSorted=f,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));

package/dist/timeout.d.ts

@@ -25,34 +25,6 @@ export interface TimeoutCapable {
  * Otherwise, optionsTimeout is returned. If both are undefined, undefined is returned.
  */
 export declare function resolveTimeout(requestTimeout?: number, optionsTimeout?: number): number | undefined;
-/**
- * Exception class thrown when an HTTP request times out.
- *
- * This error is thrown by the timeoutFetch function when a request exceeds its timeout limit.
- *
- * @example
- * ```typescript
- * try {
- *   const response = await timeoutFetch('https://api.example.com/users', {}, 1000);
- * } catch (error) {
- *   if (error instanceof FetchTimeoutError) {
- *     console.log(`Request timed out after ${error.timeout}ms`);
- *   }
- * }
- * ```
- */
-export declare class FetchTimeoutError extends Error {
-    /**
-     * The request options that timed out.
-     */
-    request: FetchRequest;
-    /**
-     * Creates a new FetchTimeoutError instance.
-     *
-     * @param request - The request options that timed out
-     */
-    constructor(request: FetchRequest);
-}
 /**
  * HTTP request method with timeout control.
  *

package/dist/timeout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../src/timeout.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,cAAc,CAAC,EAAE,MAAM,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;;;OAIG;gBACS,OAAO,EAAE,YAAY;CASlC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyC3E"}
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../src/timeout.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,cAAc,CAAC,EAAE,MAAM,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyC3E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahoo-wang/fetcher",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "Ultra-lightweight (1.9kB) HTTP client with built-in path parameters and Axios-like API",
   "keywords": [
     "fetch",