@ahoo-wang/fetcher 0.9.1 → 0.9.5

package/README.md

@@ -8,12 +8,12 @@
 [![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%
-smaller than Axios while providing the same powerful features.
+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
@@ -123,9 +123,11 @@ responses, and errors at different stages of the HTTP request lifecycle.
 
 Fetcher comes with several built-in interceptors that are automatically registered:
 
-1. **UrlResolveInterceptor**: Resolves URLs with path and query parameters (order: Number.MIN_SAFE_INTEGER + 100)
-2. **RequestBodyInterceptor**: Converts object bodies to JSON strings (order: Number.MIN_SAFE_INTEGER + 200)
-3. **FetchInterceptor**: Executes the actual HTTP request (order: Number.MAX_SAFE_INTEGER - 100)
+1. **UrlResolveInterceptor**: Resolves URLs with path and query parameters (order: Number.MIN_SAFE_INTEGER + 1000)
+2. **RequestBodyInterceptor**: Converts object bodies to JSON strings (order: Number.MIN_SAFE_INTEGER + 2000)
+3. **FetchInterceptor**: Executes the actual HTTP request (order: Number.MAX_SAFE_INTEGER - 1000)
+4. **ValidateStatusInterceptor**: Validates HTTP status codes and throws errors for invalid statuses (response
+   interceptor, order: Number.MAX_SAFE_INTEGER - 1000)
 
 ### Using Interceptors
 
@@ -246,6 +248,13 @@ new Fetcher(options ? : FetcherOptions);
 - `headers`: Default request headers
 - `interceptors`: Interceptor collection for request, response, and error handling
 
+#### Properties
+
+- `urlBuilder`: URL builder instance for constructing URLs
+- `headers`: Default request headers
+- `timeout`: Default request timeout
+- `interceptors`: Interceptor collection for request, response, and error handling
+
 #### Methods
 
 - `fetch(url: string, request?: FetcherRequest): Promise<Response>` - Generic HTTP request method
@@ -256,13 +265,8 @@ new Fetcher(options ? : FetcherOptions);
 - `patch(url: string, request?: Omit<FetcherRequest, 'method'>): Promise<Response>` - PATCH request
 - `head(url: string, request?: Omit<FetcherRequest, 'method' | 'body'>): Promise<Response>` - HEAD request
 - `options(url: string, request?: Omit<FetcherRequest, 'method' | 'body'>): Promise<Response>` - OPTIONS request
-
-#### Properties
-
-- `urlBuilder`: URL builder instance for constructing URLs
-- `headers`: Default request headers
-- `timeout`: Default request timeout
-- `interceptors`: Interceptor collection for request, response, and error handling
+- `request(request: FetchRequest): Promise<FetchExchange>` - Process an HTTP request through the Fetcher's internal
+  workflow
 
 ### FetcherRequest Interface
 
@@ -273,8 +277,7 @@ Configuration options for HTTP requests.
 - `method`: HTTP method (GET, POST, PUT, DELETE, etc.)
 - `headers`: Request headers
 - `body`: Request body (can be object, string, Blob, etc.)
-- `path`: Path parameters for URL templating
-- `query`: Query parameters for URL query string
+- `urlParams`: URL parameters including path parameters for URL templating and query parameters for URL query string
 - `timeout`: Request timeout in milliseconds
 
 ### Response Extension
@@ -332,9 +335,13 @@ Interceptor interface that defines the basic structure of interceptors.
 
 - `intercept(exchange: FetchExchange): void | Promise<void>` - Intercept and process data
 
-#### InterceptorManager Class
+#### InterceptorRegistry Class
+
+Registry for managing multiple interceptors of the same type.
 
-Interceptor manager for managing multiple interceptors of the same type.
+**Properties:**
+
+- `interceptors: Interceptor[]` - Get all interceptors in the registry
 
 **Methods:**
 
@@ -343,15 +350,20 @@ Interceptor manager for managing multiple interceptors of the same type.
 - `clear(): void` - Clear all interceptors
 - `intercept(exchange: FetchExchange): Promise<void>` - Execute all interceptors in sequence
 
-#### FetcherInterceptors Class
+#### InterceptorManager Class
 
 Fetcher interceptor collection, including request, response, and error interceptor managers.
 
 **Properties:**
 
-- `request: InterceptorManager` - Request interceptor manager
-- `response: InterceptorManager` - Response interceptor manager
-- `error: InterceptorManager` - Error interceptor manager
+- `request: InterceptorRegistry` - Request interceptor manager
+- `response: InterceptorRegistry` - Response interceptor manager
+- `error: InterceptorRegistry` - Error interceptor manager
+
+**Methods:**
+
+- `exchange(fetchExchange: FetchExchange): Promise<FetchExchange>` - Process a FetchExchange through the interceptor
+  pipeline, executing request, response, and error interceptors in sequence
 
 ## 🤝 Contributing
 

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}`）和查询参数
 - **🔗 拦截器系统**：请求、响应和错误拦截器的中间件模式
 - **⏱️ 超时控制**：可配置的请求超时和适当的错误处理
@@ -121,9 +121,11 @@ Fetcher 中的拦截器系统遵循中间件模式，允许您在 HTTP 请求生
 
 Fetcher 自带几个内置拦截器，它们会自动注册：
 
-1. **UrlResolveInterceptor**：解析带路径和查询参数的 URL（顺序：Number.MIN_SAFE_INTEGER + 100）
-2. **RequestBodyInterceptor**：将对象体转换为 JSON 字符串（顺序：Number.MIN_SAFE_INTEGER + 200）
-3. **FetchInterceptor**：执行实际的 HTTP 请求（顺序：Number.MAX_SAFE_INTEGER - 100）
+1. **UrlResolveInterceptor**：解析带路径和查询参数的 URL（顺序：Number.MIN_SAFE_INTEGER + 1000）
+2. **RequestBodyInterceptor**：将对象体转换为 JSON 字符串（顺序：Number.MIN_SAFE_INTEGER + 2000）
+3. **FetchInterceptor**：执行实际的 HTTP 请求（顺序：Number.MAX_SAFE_INTEGER - 1000）
+4. **ValidateStatusInterceptor**：验证 HTTP 状态码并在状态码无效时抛出错误（响应拦截器，顺序：Number.MAX_SAFE_INTEGER -
+   1000）
 
 ### 使用拦截器
 
@@ -244,6 +246,13 @@ new Fetcher(options ? : FetcherOptions);
 - `headers`：默认请求头部
 - `interceptors`：用于请求、响应和错误处理的拦截器集合
 
+#### 属性
+
+- `urlBuilder`：用于构建 URL 的 URL 构建器实例
+- `headers`：默认请求头部
+- `timeout`：默认请求超时时间
+- `interceptors`：用于请求、响应和错误处理的拦截器集合
+
 #### 方法
 
 - `fetch(url: string, request?: FetcherRequest): Promise<Response>` - 通用 HTTP 请求方法
@@ -254,13 +263,7 @@ new Fetcher(options ? : FetcherOptions);
 - `patch(url: string, request?: Omit<FetcherRequest, 'method'>): Promise<Response>` - PATCH 请求
 - `head(url: string, request?: Omit<FetcherRequest, 'method' | 'body'>): Promise<Response>` - HEAD 请求
 - `options(url: string, request?: Omit<FetcherRequest, 'method' | 'body'>): Promise<Response>` - OPTIONS 请求
-
-#### 属性
-
-- `urlBuilder`：用于构建 URL 的 URL 构建器实例
-- `headers`：默认请求头部
-- `timeout`：默认请求超时时间
-- `interceptors`：用于请求、响应和错误处理的拦截器集合
+- `request(request: FetchRequest): Promise<FetchExchange>` - 通过 Fetcher 的内部工作流处理 HTTP 请求
 
 ### FetcherRequest 接口
 
@@ -271,8 +274,7 @@ HTTP 请求的配置选项。
 - `method`：HTTP 方法（GET、POST、PUT、DELETE 等）
 - `headers`：请求头部
 - `body`：请求体（可以是对象、字符串、Blob 等）
-- `path`：用于 URL 模板的路径参数
-- `query`：用于 URL 查询字符串的查询参数
+- `urlParams`：URL 参数，包括用于 URL 模板的路径参数和用于 URL 查询字符串的查询参数
 - `timeout`：请求超时时间（毫秒）
 
 ### 响应扩展
@@ -330,9 +332,13 @@ string, options ? : FetcherOptions
 
 - `intercept(exchange: FetchExchange): void | Promise<void>` - 拦截并处理数据
 
-#### InterceptorManager 类
+#### InterceptorRegistry 类
+
+用于管理同一类型多个拦截器的拦截器注册表。
 
-用于管理同一类型多个拦截器的拦截器管理器。
+**属性：**
+
+- `interceptors: Interceptor[]` - 获取注册表中的所有拦截器
 
 **方法：**
 
@@ -341,15 +347,19 @@ string, options ? : FetcherOptions
 - `clear(): void` - 清除所有拦截器
 - `intercept(exchange: FetchExchange): Promise<void>` - 顺序执行所有拦截器
 
-#### FetcherInterceptors 类
+#### InterceptorManager 类
 
 Fetcher 拦截器集合，包括请求、响应和错误拦截器管理器。
 
 **属性：**
 
-- `request: InterceptorManager` - 请求拦截器管理器
-- `response: InterceptorManager` - 响应拦截器管理器
-- `error: InterceptorManager` - 错误拦截器管理器
+- `request: InterceptorRegistry` - 请求拦截器管理器
+- `response: InterceptorRegistry` - 响应拦截器管理器
+- `error: InterceptorRegistry` - 错误拦截器管理器
+
+**方法：**
+
+- `exchange(fetchExchange: FetchExchange): Promise<FetchExchange>` - 通过拦截器管道处理 FetchExchange
 
 ## 🤝 贡献
 

package/dist/fetchInterceptor.d.ts

@@ -1,36 +1,55 @@
-import { Interceptor } from './interceptor';
+import { RequestInterceptor } from './interceptor';
 import { FetchExchange } from './fetchExchange';
+/**
+ * The name of the FetchInterceptor.
+ */
+export declare const FETCH_INTERCEPTOR_NAME = "FetchInterceptor";
+/**
+ * The order of the FetchInterceptor.
+ * Set to Number.MAX_SAFE_INTEGER - 1000 to ensure it runs latest among request interceptors.
+ */
+export declare const FETCH_INTERCEPTOR_ORDER: number;
 /**
  * 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
+ * and handling timeout control. It is the latest interceptor in the Fetcher request
  * processing chain, ensuring that the actual network request is executed after all
  * previous interceptors have completed processing.
  *
+ * @remarks
+ * This interceptor runs at the very end of the request interceptor chain to ensure
+ * that the actual HTTP request is executed after all other request processing is complete.
+ * The order is set to FETCH_INTERCEPTOR_ORDER to ensure it executes after all other
+ * request interceptors, completing the request processing pipeline before the network
+ * request is made. This positioning ensures that all request preprocessing is
+ * completed before the actual network request is made.
+ *
  * @example
  * // Usually not created manually as Fetcher uses it automatically
  * const fetcher = new Fetcher();
  * // FetchInterceptor is automatically registered in fetcher.interceptors.request
  */
-export declare class FetchInterceptor implements Interceptor {
+export declare class FetchInterceptor implements RequestInterceptor {
     /**
      * Interceptor name, used to identify and manage interceptor instances.
      *
      * Each interceptor must have a unique name for identification and manipulation
      * within the interceptor manager.
      */
-    name: string;
+    readonly name = "FetchInterceptor";
     /**
-     * Interceptor execution order, set to near maximum safe integer to ensure last execution.
+     * Interceptor execution order, set to near maximum safe integer to ensure latest execution.
      *
      * 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
+     * FETCH_INTERCEPTOR_ORDER. This ensures that all request preprocessing is
      * completed before the actual network request is made, while still allowing
-     * other interceptors to run after it if needed.
+     * other interceptors to run after it if needed. The positioning at the end
+     * of the request chain ensures that all transformations and validations are
+     * completed before the network request is executed.
      */
-    order: number;
+    readonly order: number;
     /**
      * Intercept and process HTTP requests.
      *

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;;;;;OAKG;IACH,IAAI,SAAsB;IAE1B;;;;;;;;OAQG;IACH,KAAK,SAAiC;IAEtC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa;CAGxC"}
+{"version":3,"file":"fetchInterceptor.d.ts","sourceRoot":"","sources":["../src/fetchInterceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAiC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IACzD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,sBAA0B;IAEvC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAAK,SAA2B;IAEzC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa;CAGxC"}

package/dist/fetcher.d.ts

@@ -1,8 +1,8 @@
 import { UrlBuilder, UrlBuilderCapable } from './urlBuilder';
 import { TimeoutCapable } from './timeout';
-import { FetcherInterceptors } from './interceptor';
 import { FetchExchange } from './fetchExchange';
 import { BaseURLCapable, FetchRequest, FetchRequestInit, RequestHeaders, RequestHeadersCapable } from './fetchRequest';
+import { InterceptorManager } from './interceptorManager';
 /**
  * Configuration options for the Fetcher client.
  *
@@ -15,12 +15,12 @@ import { BaseURLCapable, FetchRequest, FetchRequestInit, RequestHeaders, Request
  *   baseURL: 'https://api.example.com',
  *   headers: { 'Content-Type': 'application/json' },
  *   timeout: 5000,
- *   interceptors: new FetcherInterceptors()
+ *   interceptors: new InterceptorManager()
  * };
  * ```
  */
 export interface FetcherOptions extends BaseURLCapable, RequestHeadersCapable, TimeoutCapable {
-    interceptors?: FetcherInterceptors;
+    interceptors?: InterceptorManager;
 }
 export declare const DEFAULT_OPTIONS: FetcherOptions;
 /**
@@ -43,10 +43,10 @@ export declare const DEFAULT_OPTIONS: FetcherOptions;
  * ```
  */
 export declare class Fetcher implements UrlBuilderCapable, RequestHeadersCapable, TimeoutCapable {
-    urlBuilder: UrlBuilder;
-    headers?: RequestHeaders;
-    timeout?: number;
-    interceptors: FetcherInterceptors;
+    readonly urlBuilder: UrlBuilder;
+    readonly headers?: RequestHeaders;
+    readonly timeout?: number;
+    readonly interceptors: InterceptorManager;
     /**
      * Initializes a new Fetcher instance with optional configuration.
      *
@@ -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>;
     /**
@@ -80,23 +80,6 @@ export declare class Fetcher implements UrlBuilderCapable, RequestHeadersCapable
      * @throws Error if an unhandled error occurs during request processing
      */
     request(request: FetchRequest): Promise<FetchExchange>;
-    /**
-     * Processes a FetchExchange through the interceptor chain.
-     *
-     * Orchestrates the complete request lifecycle by applying interceptors in sequence:
-     * 1. Request interceptors - Modify the outgoing request
-     * 2. Response interceptors - Process the incoming response
-     *
-     * 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
-     *
-     * @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
-     */
-    exchange(fetchExchange: FetchExchange): Promise<FetchExchange>;
     /**
      * Internal helper method for making HTTP requests with a specific method.
      *

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,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,cAAc,EAEd,YAAY,EACZ,gBAAgB,EAEhB,cAAc,EACd,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,cACf,SAAQ,cAAc,EACpB,qBAAqB,EACrB,cAAc;IAChB,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAMD,eAAO,MAAM,eAAe,EAAE,cAG7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,OACX,YAAW,iBAAiB,EAAE,qBAAqB,EAAE,cAAc;IAEnE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAmB;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAE1C;;;;;;;OAOG;gBACS,OAAO,GAAE,cAAgC;IAOrD;;;;;;;;;;OAUG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa3E;;;;;;;;;;OAUG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAa5D;;;;;;;;;;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,62 @@
+import { FetchExchange } from './fetchExchange';
+/**
+ * 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 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);
+}
+//# 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;AAEhD;;;;;;;;;;;;;;;;;;;;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;AAGD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAW,SAAQ,YAAY;aAQxB,QAAQ,EAAE,aAAa;IAPzC;;;;;OAKG;gBAEe,QAAQ,EAAE,aAAa,EACvC,QAAQ,CAAC,EAAE,MAAM;CAUpB"}

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 export * from './fetcher';
+export * from './fetcherError';
 export * from './fetcherRegistrar';
 export * from './fetchExchange';
 export * from './fetchInterceptor';
 export * from './fetchRequest';
 export * from './interceptor';
+export * from './interceptorManager';
 export * from './mergeRequest';
 export * from './namedFetcher';
 export * from './orderedCapable';
@@ -14,4 +16,5 @@ export * from './urlBuilder';
 export * from './urlResolveInterceptor';
 export * from './urls';
 export * from './utils';
+export * from './validateStatusInterceptor';
 //# sourceMappingURL=index.d.ts.map

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,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,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;AACxB,cAAc,6BAA6B,CAAC"}