@ahoo-wang/fetcher 0.9.0 → 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/fetchExchange.d.ts

@@ -1,7 +1,7 @@
 import { Fetcher } from './fetcher';
 import { FetchRequest } from './fetchRequest';
 /**
- * FetchExchange
+ * Container for HTTP request/response data that flows through the interceptor chain.
  *
  * Represents the complete exchange object that flows through the interceptor chain.
  * This object contains all the information about a request, response, and any errors
@@ -43,7 +43,7 @@ import { FetchRequest } from './fetchRequest';
  */
 export declare class FetchExchange {
     /**
-     * The Fetcher instance that initiated this exchange
+     * The Fetcher instance that initiated this exchange.
      */
     fetcher: Fetcher;
     /**
@@ -51,15 +51,15 @@ export declare class FetchExchange {
      */
     request: FetchRequest;
     /**
-     * The response object, undefined until the request completes successfully
+     * The response object, undefined until the request completes successfully.
      */
     response: Response | undefined;
     /**
-     * Any error that occurred during the request processing, undefined if no error occurred
+     * Any error that occurred during the request processing, undefined if no error occurred.
      */
     error: Error | any | undefined;
     /**
-     * Shared attributes for passing data between interceptors
+     * Shared attributes for passing data between interceptors.
      *
      * This property allows interceptors to share arbitrary data with each other.
      * Interceptors can read from and write to this object to pass information
@@ -75,13 +75,13 @@ export declare class FetchExchange {
     attributes: Record<string, any>;
     constructor(fetcher: Fetcher, request: FetchRequest, response?: Response, error?: Error | any);
     /**
-     * Checks if the exchange has an error
+     * Checks if the exchange has an error.
      *
      * @returns true if an error is present, false otherwise
      */
     hasError(): boolean;
     /**
-     * Checks if the exchange has a response
+     * Checks if the exchange has a response.
      *
      * @returns true if a response is present, false otherwise
      */

package/dist/fetchInterceptor.d.ts

@@ -1,7 +1,7 @@
 import { Interceptor } from './interceptor';
 import { FetchExchange } from './fetchExchange';
 /**
- * FetchInterceptor Class
+ * Interceptor implementation responsible for executing actual HTTP requests.
  *
  * This is an interceptor implementation responsible for executing actual HTTP requests
  * and handling timeout control. It is the last interceptor in the Fetcher request
@@ -15,17 +15,15 @@ import { FetchExchange } from './fetchExchange';
  */
 export declare class FetchInterceptor implements Interceptor {
     /**
-     * Interceptor name, used to identify and manage interceptor instances
+     * Interceptor name, used to identify and manage interceptor instances.
      *
-     * @remarks
      * Each interceptor must have a unique name for identification and manipulation
-     * within the interceptor manager
+     * within the interceptor manager.
      */
     name: string;
     /**
-     * Interceptor execution order, set to near maximum safe integer to ensure last execution
+     * Interceptor execution order, set to near maximum safe integer to ensure last execution.
      *
-     * @remarks
      * Since this is the interceptor that actually executes HTTP requests, it should
      * execute after all other request interceptors, so its order is set to
      * Number.MAX_SAFE_INTEGER - 100. This ensures that all request preprocessing is
@@ -34,7 +32,7 @@ export declare class FetchInterceptor implements Interceptor {
      */
     order: number;
     /**
-     * Intercept and process HTTP requests
+     * Intercept and process HTTP requests.
      *
      * Executes the actual HTTP request and applies timeout control. This is the final
      * step in the request processing chain, responsible for calling the timeoutFetch
@@ -46,15 +44,17 @@ export declare class FetchInterceptor implements Interceptor {
      *
      * @example
      * // Usually called internally by Fetcher
-     * const exchange = {
-     *   url: 'https://api.example.com/users',
-     *   request: {
+     * const fetcher = new Fetcher();
+     * const exchange = new FetchExchange(
+     *   fetcher,
+     *   {
+     *     url: 'https://api.example.com/users',
      *     method: 'GET',
      *     timeout: 5000
      *   }
-     * };
-     * const result = await fetchInterceptor.intercept(exchange);
-     * console.log(result.response); // HTTP response object
+     * );
+     * await fetchInterceptor.intercept(exchange);
+     * console.log(exchange.response); // HTTP response object
      */
     intercept(exchange: FetchExchange): Promise<void>;
 }

package/dist/fetchInterceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetchInterceptor.d.ts","sourceRoot":"","sources":["../src/fetchInterceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD;;;;;;OAMG;IACH,IAAI,SAAsB;IAE1B;;;;;;;;;OASG;IACH,KAAK,SAAiC;IAEtC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa;CAGxC"}
+{"version":3,"file":"fetchInterceptor.d.ts","sourceRoot":"","sources":["../src/fetchInterceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD;;;;;OAKG;IACH,IAAI,SAAsB;IAE1B;;;;;;;;OAQG;IACH,KAAK,SAAiC;IAEtC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa;CAGxC"}

package/dist/fetcher.d.ts

@@ -4,7 +4,10 @@ import { FetcherInterceptors } from './interceptor';
 import { FetchExchange } from './fetchExchange';
 import { BaseURLCapable, FetchRequest, FetchRequestInit, RequestHeaders, RequestHeadersCapable } from './fetchRequest';
 /**
- * Fetcher configuration options interface
+ * Configuration options for the Fetcher client.
+ *
+ * Defines the customizable aspects of a Fetcher instance including base URL,
+ * default headers, timeout settings, and interceptors.
  *
  * @example
  * ```typescript
@@ -21,7 +24,11 @@ export interface FetcherOptions extends BaseURLCapable, RequestHeadersCapable, T
 }
 export declare const DEFAULT_OPTIONS: FetcherOptions;
 /**
- * HTTP client class that supports URL building, timeout control, and more
+ * HTTP client with support for interceptors, URL building, and timeout control.
+ *
+ * The Fetcher class provides a flexible and extensible HTTP client implementation
+ * that follows the interceptor pattern. It supports URL parameter interpolation,
+ * request/response transformation, and timeout handling.
  *
  * @example
  * ```typescript
@@ -41,108 +48,208 @@ export declare class Fetcher implements UrlBuilderCapable, RequestHeadersCapable
     timeout?: number;
     interceptors: FetcherInterceptors;
     /**
-     * Create a Fetcher instance
+     * Initializes a new Fetcher instance with optional configuration.
+     *
+     * Creates a Fetcher with default settings that can be overridden through the options parameter.
+     * If no interceptors are provided, a default set of interceptors will be used.
      *
-     * @param options - Fetcher configuration options
+     * @param options - Configuration options for the Fetcher instance
      */
     constructor(options?: FetcherOptions);
     /**
-     * Make an HTTP request
+     * Executes an HTTP request with the specified URL and options.
      *
-     * @param url - Request URL path
-     * @param request - Request options, including path parameters, query parameters, etc.
-     * @returns Promise<Response> HTTP response
+     * This is the primary method for making HTTP requests. It processes the request
+     * through the interceptor chain and returns the resulting Response.
+     *
+     * @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 FetchError if the request fails and no response is generated
      */
     fetch(url: string, request?: FetchRequestInit): Promise<Response>;
     /**
-     * Send an HTTP request
+     * Processes an HTTP request through the Fetcher's internal workflow.
      *
-     * @param request - Request configuration object, including url, method, headers, body, etc.
-     * @returns Promise that resolves to a FetchExchange object containing request and response information
+     * This method prepares the request by merging headers and timeout settings,
+     * creates a FetchExchange object, and passes it through the exchange method
+     * for interceptor processing.
      *
-     * @throws Throws an exception when an error occurs during the request and is not handled by error interceptors
+     * @param request - Complete request configuration object
+     * @returns Promise that resolves to a FetchExchange containing request/response data
+     * @throws Error if an unhandled error occurs during request processing
      */
     request(request: FetchRequest): Promise<FetchExchange>;
     /**
-     * Process a fetch exchange 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.
+     *
+     * 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
      *
-     * This method orchestrates the complete request lifecycle by applying interceptors
-     * in the following order:
-     * 1. Request interceptors - to modify the outgoing request
-     * 2. Response interceptors - to process the incoming response
+     * 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
      *
-     * If any error occurs during the process, error interceptors are applied to handle it.
-     * If an error interceptor produces a response, that response is returned. Otherwise,
-     * the original error is re-thrown.
+     * @example
+     * ```typescript
+     * // Create a fetcher with custom interceptors
+     * const fetcher = new Fetcher();
      *
-     * @param fetchExchange - The exchange object containing request, response, and metadata
-     * @returns Promise<FetchExchange> The processed exchange with final response or error
-     * @throws Error if an error occurs and is not handled by error interceptors
+     * // 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>;
     /**
-     * Make an HTTP request with the specified method
+     * Internal helper method for making HTTP requests with a specific method.
      *
-     * @param method - HTTP method to use
-     * @param url - Request URL path
-     * @param request - Request options
-     * @returns Promise<Response> HTTP response
+     * This private method is used by the public HTTP method methods (get, post, etc.)
+     * to execute requests with the appropriate HTTP verb.
+     *
+     * @param method - The HTTP method to use for the request
+     * @param url - The URL path for the request
+     * @param request - Additional request options
+     * @returns Promise that resolves to the HTTP response
      */
     private methodFetch;
     /**
-     * Make a GET request
+     * Makes a GET HTTP request.
+     *
+     * Convenience method for making GET requests. The request body is omitted
+     * as GET requests should not contain a body according to HTTP specification.
      *
-     * @param url - Request URL path
-     * @param request - Request options, including path parameters, query parameters, etc.
-     * @returns Promise<Response> HTTP response
+     * @param url - The URL path for the request
+     * @param request - Request options excluding method and body
+     * @returns Promise that resolves to the HTTP response
      */
     get(url: string, request?: Omit<FetchRequestInit, 'method' | 'body'>): Promise<Response>;
     /**
-     * Make a POST request
+     * Makes a POST HTTP request.
+     *
+     * Convenience method for making POST requests, commonly used for creating resources.
      *
-     * @param url - Request URL path
-     * @param request - Request options, including path parameters, query parameters, request body, etc.
-     * @returns Promise<Response> HTTP response
+     * @param url - The URL path for the request
+     * @param request - Request options including body and other parameters
+     * @returns Promise that resolves to the HTTP response
      */
     post(url: string, request?: Omit<FetchRequestInit, 'method'>): Promise<Response>;
     /**
-     * Make a PUT request
+     * Makes a PUT HTTP request.
      *
-     * @param url - Request URL path
-     * @param request - Request options, including path parameters, query parameters, request body, etc.
-     * @returns Promise<Response> HTTP response
+     * Convenience method for making PUT requests, commonly used for updating resources.
+     *
+     * @param url - The URL path for the request
+     * @param request - Request options including body and other parameters
+     * @returns Promise that resolves to the HTTP response
      */
     put(url: string, request?: Omit<FetchRequestInit, 'method'>): Promise<Response>;
     /**
-     * Make a DELETE request
+     * Makes a DELETE HTTP request.
+     *
+     * Convenience method for making DELETE requests, commonly used for deleting resources.
      *
-     * @param url - Request URL path
-     * @param request - Request options, including path parameters, query parameters, etc.
-     * @returns Promise<Response> HTTP response
+     * @param url - The URL path for the request
+     * @param request - Request options excluding method and body
+     * @returns Promise that resolves to the HTTP response
      */
     delete(url: string, request?: Omit<FetchRequestInit, 'method'>): Promise<Response>;
     /**
-     * Make a PATCH request
+     * Makes a PATCH HTTP request.
+     *
+     * Convenience method for making PATCH requests, commonly used for partial updates.
      *
-     * @param url - Request URL path
-     * @param request - Request options, including path parameters, query parameters, request body, etc.
-     * @returns Promise<Response> HTTP response
+     * @param url - The URL path for the request
+     * @param request - Request options including body and other parameters
+     * @returns Promise that resolves to the HTTP response
      */
     patch(url: string, request?: Omit<FetchRequestInit, 'method'>): Promise<Response>;
     /**
-     * Make a HEAD request
+     * Makes a HEAD HTTP request.
      *
-     * @param url - Request URL path
-     * @param request - Request options, including path parameters, query parameters, etc.
-     * @returns Promise<Response> HTTP response
+     * Convenience method for making HEAD requests, which retrieve headers only.
+     * The request body is omitted as HEAD requests should not contain a body.
+     *
+     * @param url - The URL path for the request
+     * @param request - Request options excluding method and body
+     * @returns Promise that resolves to the HTTP response
      */
     head(url: string, request?: Omit<FetchRequestInit, 'method' | 'body'>): Promise<Response>;
     /**
-     * Make an OPTIONS request
+     * Makes an OPTIONS HTTP request.
+     *
+     * Convenience method for making OPTIONS requests, commonly used for CORS preflight.
+     * The request body is omitted as OPTIONS requests typically don't contain a body.
      *
-     * @param url - Request URL path
-     * @param request - Request options, including path parameters, query parameters, etc.
-     * @returns Promise<Response> HTTP response
+     * @param url - The URL path for the request
+     * @param request - Request options excluding method and body
+     * @returns Promise that resolves to the HTTP response
      */
     options(url: string, request?: Omit<FetchRequestInit, 'method' | 'body'>): Promise<Response>;
 }

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;;;;;;;;;;;;GAYG;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;;;;;;;;;;;;;;GAcG;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;;;;OAIG;gBACS,OAAO,GAAE,cAAgC;IAOrD;;;;;;OAMG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAU3E;;;;;;;OAOG;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;;;;;;;OAOG;YACW,WAAW;IAWzB;;;;;;OAMG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;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"}