@ahoo-wang/fetcher 0.5.6 → 0.6.1

package/README.md

@@ -6,6 +6,7 @@
 [![License](https://img.shields.io/npm/l/@ahoo-wang/fetcher.svg)](https://github.com/Ahoo-Wang/fetcher/blob/main/LICENSE)
 [![npm downloads](https://img.shields.io/npm/dm/@ahoo-wang/fetcher.svg)](https://www.npmjs.com/package/@ahoo-wang/fetcher)
 [![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.
@@ -53,7 +54,7 @@ const response = await fetcher.get('/users/{id}', {
   path: { id: 123 },
   query: { include: 'profile' },
 });
-const userData = await response.json();
+const userData = await response.json<User>();
 
 // POST request with automatic JSON conversion
 const createUserResponse = await fetcher.post('/users', {
@@ -100,12 +101,46 @@ import { fetcher } from '@ahoo-wang/fetcher';
 
 // Use the default fetcher directly
 const response = await fetcher.get('/users');
-const data = await response.json();
+const data = await response.json<User>();
 ```
 
 ## 🔗 Interceptor System
 
-### Request Interceptors
+### Interceptor
+
+Interceptor interface that defines the basic structure of interceptors.
+
+**Properties:**
+
+- `name: string` - The name of the interceptor, used to identify it, must be unique
+- `order: number` - The execution order of the interceptor, smaller values have higher priority
+
+**Methods:**
+
+- `intercept(exchange: FetchExchange): FetchExchange | Promise<FetchExchange>` - Intercept and process data
+
+### InterceptorManager
+
+Interceptor manager for managing multiple interceptors of the same type.
+
+**Methods:**
+
+- `use(interceptor: Interceptor): boolean` - Add interceptor, returns whether the addition was successful
+- `eject(name: string): boolean` - Remove interceptor by name, returns whether the removal was successful
+- `clear(): void` - Clear all interceptors
+- `intercept(exchange: FetchExchange): Promise<FetchExchange>` - Execute all interceptors in sequence
+
+### FetcherInterceptors
+
+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
+
+### Using Interceptors
 
 ```typescript
 import { Fetcher } from '@ahoo-wang/fetcher';
@@ -113,7 +148,9 @@ import { Fetcher } from '@ahoo-wang/fetcher';
 const fetcher = new Fetcher({ baseURL: 'https://api.example.com' });
 
 // Add request interceptor (e.g., for authentication)
-const interceptorId = fetcher.interceptors.request.use({
+const success = fetcher.interceptors.request.use({
+  name: 'auth-interceptor',
+  order: 100,
   intercept(exchange) {
     return {
       ...exchange,
@@ -128,8 +165,84 @@ const interceptorId = fetcher.interceptors.request.use({
   },
 });
 
-// Remove interceptor
-fetcher.interceptors.request.eject(interceptorId);
+// Add response interceptor (e.g., for logging)
+fetcher.interceptors.response.use({
+  name: 'logging-interceptor',
+  order: 10,
+  intercept(exchange) {
+    console.log('Response received:', exchange.response?.status);
+    return exchange;
+  },
+});
+
+// Add error interceptor (e.g., for unified error handling)
+fetcher.interceptors.error.use({
+  name: 'error-interceptor',
+  order: 50,
+  intercept(exchange) {
+    if (exchange.error?.name === 'FetchTimeoutError') {
+      console.error('Request timeout:', exchange.error.message);
+    } else {
+      console.error('Network error:', exchange.error?.message);
+    }
+    return exchange;
+  },
+});
+
+// Remove interceptor by name
+fetcher.interceptors.request.eject('auth-interceptor');
+```
+
+### Ordered Execution
+
+The `OrderedCapable` system allows you to control the execution order of interceptors and other components.
+
+#### Ordering Concept
+
+```typescript
+import { OrderedCapable } from '@ahoo-wang/fetcher';
+
+// Lower order values have higher priority
+const highPriority: OrderedCapable = { order: 1 }; // Executes first
+const mediumPriority: OrderedCapable = { order: 10 }; // Executes second
+const lowPriority: OrderedCapable = { order: 100 }; // Executes last
+```
+
+#### Interceptor Ordering
+
+```typescript
+// Add interceptors with different orders
+fetcher.interceptors.request.use({
+  name: 'timing-interceptor',
+  order: 5, // Executes very early
+  intercept(exchange) {
+    console.log('Very early timing');
+    return exchange;
+  },
+});
+
+fetcher.interceptors.request.use({
+  name: 'logging-interceptor',
+  order: 10, // Executes early
+  intercept(exchange) {
+    console.log('Early logging');
+    return exchange;
+  },
+});
+
+fetcher.interceptors.request.use({
+  name: 'auth-interceptor',
+  order: 50, // Executes later
+  intercept(exchange) {
+    // Add auth headers
+    return exchange;
+  },
+});
+
+// Execution order will be:
+// 1. timing-interceptor (order: 5)
+// 2. logging-interceptor (order: 10)
+// 3. auth-interceptor (order: 50)
 ```
 
 ### Response Interceptors
@@ -189,6 +302,16 @@ new Fetcher(options ? : FetcherOptions);
 - `head(url: string, request?: Omit<FetcherRequest, 'method' | 'body'>): Promise<Response>` - HEAD request
 - `options(url: string, request?: Omit<FetcherRequest, 'method' | 'body'>): Promise<Response>` - OPTIONS request
 
+### Response Extension
+
+To provide better TypeScript support, we extend the native Response interface with a type-safe json() method:
+
+```typescript
+// Now you can use it with type safety
+const response = await fetcher.get('/users/123');
+const userData = await response.json<User>(); // Type is Promise<User>
+```
+
 ### NamedFetcher Class
 
 An extension of the Fetcher class that automatically registers itself with the global fetcherRegistrar.
@@ -221,16 +344,29 @@ Global instance for managing multiple Fetcher instances by name.
 
 ### Interceptor System
 
+#### Interceptor
+
+Interceptor interface that defines the basic structure of interceptors.
+
+**Properties:**
+
+- `name: string` - The name of the interceptor, used to identify it, must be unique
+- `order: number` - The execution order of the interceptor, smaller values have higher priority
+
+**Methods:**
+
+- `intercept(exchange: FetchExchange): FetchExchange | Promise<FetchExchange>` - Intercept and process data
+
 #### InterceptorManager
 
 Interceptor manager for managing multiple interceptors of the same type.
 
 **Methods:**
 
-- `use(interceptor: Interceptor): number` - Add interceptor, returns interceptor ID
-- `eject(index: number): void` - Remove interceptor by ID
+- `use(interceptor: Interceptor): boolean` - Add interceptor, returns whether the addition was successful
+- `eject(name: string): boolean` - Remove interceptor by name, returns whether the removal was successful
 - `clear(): void` - Clear all interceptors
-- `intercept(exchange: FetchExchange): Promise<FetchExchange>` - Execute all interceptors sequentially
+- `intercept(exchange: FetchExchange): Promise<FetchExchange>` - Execute all interceptors in sequence
 
 #### FetcherInterceptors
 
@@ -242,16 +378,178 @@ Fetcher interceptor collection, including request, response, and error intercept
 - `response: InterceptorManager` - Response interceptor manager
 - `error: InterceptorManager` - Error interceptor manager
 
-## 🛠️ Development
+**Options:**
 
-### Testing
+- `baseURL`: Base URL for all requests
+- `timeout`: Request timeout in milliseconds
+- `headers`: Default request headers
 
-```bash
-# Run tests
-pnpm test
+#### Methods
+
+- `fetch(url: string, request?: FetcherRequest): Promise<Response>` - Generic HTTP request method
+- `get(url: string, request?: Omit<FetcherRequest, 'method' | 'body'>): Promise<Response>` - GET request
+- `post(url: string, request?: Omit<FetcherRequest, 'method'>): Promise<Response>` - POST request
+- `put(url: string, request?: Omit<FetcherRequest, 'method'>): Promise<Response>` - PUT request
+- `delete(url: string, request?: Omit<FetcherRequest, 'method'>): Promise<Response>` - DELETE request
+- `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
+
+### Response Extension
+
+To provide better TypeScript support, we extend the native Response interface with a type-safe json() method:
+
+```typescript
+// Now you can use it with type safety
+const response = await fetcher.get('/users/123');
+const userData = await response.json<User>(); // Type is Promise<User>
+```
+
+### NamedFetcher Class
+
+An extension of the Fetcher class that automatically registers itself with the global fetcherRegistrar.
+
+#### Constructor
+
+```typescript
+new NamedFetcher(name
+:
+string, options ? : FetcherOptions
+)
+;
+```
+
+### FetcherRegistrar
+
+Global instance for managing multiple Fetcher instances by name.
+
+#### Properties
+
+- `default`: Get or set the default fetcher instance
+
+#### Methods
+
+- `register(name: string, fetcher: Fetcher): void` - Register a fetcher with a name
+- `unregister(name: string): boolean` - Unregister a fetcher by name
+- `get(name: string): Fetcher | undefined` - Get a fetcher by name
+- `requiredGet(name: string): Fetcher` - Get a fetcher by name, throws if not found
+- `fetchers: Map<string, Fetcher>` - Get all registered fetchers
+
+### Interceptor System
+
+#### Interceptor
+
+Interceptor interface that defines the basic structure of interceptors.
+
+**Properties:**
+
+- `name: string` - The name of the interceptor, used to identify it, must be unique
+- `order: number` - The execution order of the interceptor, smaller values have higher priority
+
+**Methods:**
+
+- `intercept(exchange: FetchExchange): FetchExchange | Promise<FetchExchange>` - Intercept and process data
+
+#### InterceptorManager
+
+Interceptor manager for managing multiple interceptors of the same type.
+
+**Methods:**
+
+- `use(interceptor: Interceptor): boolean` - Add interceptor, returns whether the addition was successful
+- `eject(name: string): boolean` - Remove interceptor by name, returns whether the removal was successful
+- `clear(): void` - Clear all interceptors
+- `intercept(exchange: FetchExchange): Promise<FetchExchange>` - Execute all interceptors in sequence
+
+#### FetcherInterceptors
+
+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 Interceptors
+
+```typescript
+import { Fetcher } from '@ahoo-wang/fetcher';
+
+const fetcher = new Fetcher({ baseURL: 'https://api.example.com' });
+
+// Add request interceptor (e.g., for authentication)
+const success = fetcher.interceptors.request.use({
+  name: 'auth-interceptor',
+  order: 100,
+  intercept(exchange) {
+    return {
+      ...exchange,
+      request: {
+        ...exchange.request,
+        headers: {
+          ...exchange.request.headers,
+          Authorization: 'Bearer ' + getAuthToken(),
+        },
+      },
+    };
+  },
+});
+
+// Remove interceptor
+fetcher.interceptors.request.eject('auth-interceptor');
+```
+
+### OrderedCapable System
+
+The `OrderedCapable` system allows you to control the execution order of interceptors and other components.
+
+#### Ordering Concept
+
+```typescript
+import { OrderedCapable } from '@ahoo-wang/fetcher';
+
+// Lower order values have higher priority
+const highPriority: OrderedCapable = { order: 1 }; // Executes first
+const mediumPriority: OrderedCapable = { order: 10 }; // Executes second
+const lowPriority: OrderedCapable = { order: 100 }; // Executes last
+```
+
+#### Interceptor Ordering
+
+```typescript
+// Add interceptors with different orders
+fetcher.interceptors.request.use({
+  name: 'logging-interceptor',
+  order: 10, // Executes early
+  intercept(exchange) {
+    console.log('Early logging');
+    return exchange;
+  },
+});
+
+fetcher.interceptors.request.use({
+  name: 'auth-interceptor',
+  order: 50, // Executes later
+  intercept(exchange) {
+    // Add auth headers
+    return exchange;
+  },
+});
+
+fetcher.interceptors.request.use({
+  name: 'timing-interceptor',
+  order: 5, // Executes very early
+  intercept(exchange) {
+    console.log('Very early timing');
+    return exchange;
+  },
+});
 
-# Run tests with coverage
-pnpm test --coverage
+// Execution order will be:
+// 1. timing-interceptor (order: 5)
+// 2. logging-interceptor (order: 10)
+// 3. auth-interceptor (order: 50)
 ```
 
 ## 🤝 Contributing

package/README.zh-CN.md

@@ -6,6 +6,7 @@
 [![License](https://img.shields.io/npm/l/@ahoo-wang/fetcher.svg)](https://github.com/Ahoo-Wang/fetcher/blob/main/LICENSE)
 [![npm downloads](https://img.shields.io/npm/dm/@ahoo-wang/fetcher.svg)](https://www.npmjs.com/package/@ahoo-wang/fetcher)
 [![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%，同时提供相同的强大功能。
 
@@ -52,7 +53,7 @@ const response = await fetcher.get('/users/{id}', {
   path: { id: 123 },
   query: { include: 'profile' },
 });
-const userData = await response.json();
+const userData = await response.json<User>();
 
 // 带自动 JSON 转换的 POST 请求
 const createUserResponse = await fetcher.post('/users', {
@@ -99,12 +100,46 @@ import { fetcher } from '@ahoo-wang/fetcher';
 
 // 直接使用默认 fetcher
 const response = await fetcher.get('/users');
-const data = await response.json();
+const data = await response.json<User>();
 ```
 
 ## 🔗 拦截器系统
 
-### 请求拦截器
+### Interceptor
+
+拦截器接口，定义了拦截器的基本结构。
+
+**属性：**
+
+- `name: string` - 拦截器的名称，用于标识拦截器，不可重复
+- `order: number` - 拦截器的执行顺序，数值越小优先级越高
+
+**方法：**
+
+- `intercept(exchange: FetchExchange): FetchExchange | Promise<FetchExchange>` - 拦截并处理数据
+
+### InterceptorManager
+
+用于管理同一类型多个拦截器的拦截器管理器。
+
+**方法：**
+
+- `use(interceptor: Interceptor): boolean` - 添加拦截器，返回是否添加成功
+- `eject(name: string): boolean` - 按名称移除拦截器，返回是否移除成功
+- `clear(): void` - 清除所有拦截器
+- `intercept(exchange: FetchExchange): Promise<FetchExchange>` - 顺序执行所有拦截器
+
+### FetcherInterceptors
+
+Fetcher 拦截器集合，包括请求、响应和错误拦截器管理器。
+
+**属性：**
+
+- `request: InterceptorManager` - 请求拦截器管理器
+- `response: InterceptorManager` - 响应拦截器管理器
+- `error: InterceptorManager` - 错误拦截器管理器
+
+### 使用拦截器
 
 ```typescript
 import { Fetcher } from '@ahoo-wang/fetcher';
@@ -112,7 +147,9 @@ import { Fetcher } from '@ahoo-wang/fetcher';
 const fetcher = new Fetcher({ baseURL: 'https://api.example.com' });
 
 // 添加请求拦截器（例如用于认证）
-const interceptorId = fetcher.interceptors.request.use({
+const success = fetcher.interceptors.request.use({
+  name: 'auth-interceptor',
+  order: 100,
   intercept(exchange) {
     return {
       ...exchange,
@@ -127,27 +164,20 @@ const interceptorId = fetcher.interceptors.request.use({
   },
 });
 
-// 移除拦截器
-fetcher.interceptors.request.eject(interceptorId);
-```
-
-### 响应拦截器
-
-```typescript
 // 添加响应拦截器（例如用于日志记录）
 fetcher.interceptors.response.use({
+  name: 'logging-interceptor',
+  order: 10,
   intercept(exchange) {
-    console.log('收到响应:', exchange.response.status);
+    console.log('收到响应:', exchange.response?.status);
     return exchange;
   },
 });
-```
-
-### 错误拦截器
 
-```typescript
 // 添加错误拦截器（例如用于统一错误处理）
 fetcher.interceptors.error.use({
+  name: 'error-interceptor',
+  order: 50,
   intercept(exchange) {
     if (exchange.error?.name === 'FetchTimeoutError') {
       console.error('请求超时:', exchange.error.message);
@@ -157,89 +187,62 @@ fetcher.interceptors.error.use({
     return exchange;
   },
 });
-```
-
-## 📚 API 参考
 
-### Fetcher 类
-
-提供各种 HTTP 方法的核心 HTTP 客户端类。
-
-#### 构造函数
-
-```typescript
-new Fetcher(options ? : FetcherOptions);
+// 按名称移除拦截器
+fetcher.interceptors.request.eject('auth-interceptor');
 ```
 
-**选项：**
+### 有序执行
 
-- `baseURL`：基础 URL
-- `timeout`：以毫秒为单位的请求超时
-- `headers`：默认请求头部
+`OrderedCapable` 系统允许您控制拦截器和其他组件的执行顺序。
 
-#### 方法
-
-- `fetch(url: string, request?: FetcherRequest): Promise<Response>` - 通用 HTTP 请求方法
-- `get(url: string, request?: Omit<FetcherRequest, 'method' | 'body'>): Promise<Response>` - GET 请求
-- `post(url: string, request?: Omit<FetcherRequest, 'method'>): Promise<Response>` - POST 请求
-- `put(url: string, request?: Omit<FetcherRequest, 'method'>): Promise<Response>` - PUT 请求
-- `delete(url: string, request?: Omit<FetcherRequest, 'method'>): Promise<Response>` - DELETE 请求
-- `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 请求
-
-### NamedFetcher 类
-
-Fetcher 类的扩展，它会自动使用提供的名称在全局 fetcherRegistrar 中注册自己。
-
-#### 构造函数
+#### 排序概念
 
 ```typescript
-new NamedFetcher(name
-:
-string, options ? : FetcherOptions
-)
-;
-```
-
-### FetcherRegistrar
-
-用于按名称管理多个 Fetcher 实例的全局实例。
-
-#### 属性
-
-- `default`：获取或设置默认 fetcher 实例
-
-#### 方法
+import { OrderedCapable } from '@ahoo-wang/fetcher';
 
-- `register(name: string, fetcher: Fetcher): void` - 使用名称注册 fetcher
-- `unregister(name: string): boolean` - 按名称注销 fetcher
-- `get(name: string): Fetcher | undefined` - 按名称获取 fetcher
-- `requiredGet(name: string): Fetcher` - 按名称获取 fetcher，如果未找到则抛出错误
-- `fetchers: Map<string, Fetcher>` - 获取所有已注册的 fetcher
-
-### 拦截器系统
-
-#### InterceptorManager
-
-用于管理同一类型多个拦截器的拦截器管理器。
-
-**方法：**
+// 数值越小优先级越高
+const highPriority: OrderedCapable = { order: 1 }; // 首先执行
+const mediumPriority: OrderedCapable = { order: 10 }; // 其次执行
+const lowPriority: OrderedCapable = { order: 100 }; // 最后执行
+```
 
-- `use(interceptor: Interceptor): number` - 添加拦截器，返回拦截器 ID
-- `eject(index: number): void` - 按 ID 移除拦截器
-- `clear(): void` - 清除所有拦截器
-- `intercept(exchange: FetchExchange): Promise<FetchExchange>` - 顺序执行所有拦截器
+#### 拦截器排序
 
-#### FetcherInterceptors
+```typescript
+// 添加具有不同顺序的拦截器
+fetcher.interceptors.request.use({
+  name: 'timing-interceptor',
+  order: 5, // 很早执行
+  intercept(exchange) {
+    console.log('很早的计时');
+    return exchange;
+  },
+});
 
-Fetcher 拦截器集合，包括请求、响应和错误拦截器管理器。
+fetcher.interceptors.request.use({
+  name: 'logging-interceptor',
+  order: 10, // 较早执行
+  intercept(exchange) {
+    console.log('较早的日志');
+    return exchange;
+  },
+});
 
-**属性：**
+fetcher.interceptors.request.use({
+  name: 'auth-interceptor',
+  order: 50, // 较晚执行
+  intercept(exchange) {
+    // 添加认证头部
+    return exchange;
+  },
+});
 
-- `request: InterceptorManager` - 请求拦截器管理器
-- `response: InterceptorManager` - 响应拦截器管理器
-- `error: InterceptorManager` - 错误拦截器管理器
+// 执行顺序将是：
+// 1. timing-interceptor (order: 5)
+// 2. logging-interceptor (order: 10)
+// 3. auth-interceptor (order: 50)
+```
 
 ## 🛠️ 开发
 

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export * from './fetcher';
 export * from './fetcherRegistrar';
 export * from './interceptor';
 export * from './namedFetcher';
+export * from './orderedCapable';
+export * from './requestBodyInterceptor';
 export * from './timeout';
 export * from './types';
 export * from './urlBuilder';

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,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,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,QAAQ,CAAC"}

package/dist/index.es.js

@@ -1,8 +1,8 @@
-function b(r) {
+function w(r) {
   return /^([a-z][a-z\d+\-.]*:)?\/\//i.test(r);
 }
-function g(r, e) {
-  return b(e) ? e : e ? r.replace(/\/?\/$/, "") + "/" + e.replace(/^\/+/, "") : r;
+function I(r, e) {
+  return w(e) ? e : e ? r.replace(/\/?\/$/, "") + "/" + e.replace(/^\/+/, "") : r;
 }
 class P {
   /**
@@ -23,7 +23,7 @@ class P {
    * @throws 当路径参数中缺少必需的占位符时抛出错误
    */
   build(e, t, s) {
-    const o = g(this.baseURL, e);
+    const o = I(this.baseURL, e);
     let i = this.interpolateUrl(o, t);
     if (s) {
       const n = new URLSearchParams(s).toString();
@@ -48,21 +48,30 @@ class P {
     }) : e;
   }
 }
-function O(r, e) {
+function A(r, e) {
   return typeof r < "u" ? r : e;
 }
-class l extends Error {
+class m extends Error {
   constructor(e, t) {
     const s = e.request?.method || "GET", o = `Request timeout of ${t}ms exceeded for ${s} ${e.url}`;
-    super(o), this.name = "FetchTimeoutError", this.exchange = e, Object.setPrototypeOf(this, l.prototype);
+    super(o), this.name = "FetchTimeoutError", this.exchange = e, Object.setPrototypeOf(this, m.prototype);
   }
 }
-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 || {}), A = /* @__PURE__ */ ((r) => (r.METHOD = "method", r.BODY = "body", r))(A || {});
-const d = "Content-Type";
+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 || {}), F = /* @__PURE__ */ ((r) => (r.METHOD = "method", r.BODY = "body", r))(F || {});
+const f = "Content-Type";
 var p = /* @__PURE__ */ ((r) => (r.APPLICATION_JSON = "application/json", r.TEXT_EVENT_STREAM = "text/event-stream", r))(p || {});
-class h {
-  constructor() {
-    this.interceptors = [];
+function h(r, e) {
+  return e ? r.filter(e).sort((t, s) => t.order - s.order) : [...r].sort((t, s) => t.order - s.order);
+}
+class d {
+  constructor(e = []) {
+    this.sortedInterceptors = [], this.sortedInterceptors = h(e);
+  }
+  get name() {
+    return this.constructor.name;
+  }
+  get order() {
+    return Number.MIN_SAFE_INTEGER;
   }
   /**
    * 添加拦截器到管理器中
@@ -70,21 +79,21 @@ class h {
    * @returns 拦截器在管理器中的索引位置
    */
   use(e) {
-    const t = this.interceptors.length;
-    return this.interceptors.push(e), t;
+    return this.sortedInterceptors.some((t) => t.name === e.name) ? !1 : (this.sortedInterceptors = h([...this.sortedInterceptors, e]), !0);
   }
   /**
-   * 根据索引移除拦截器
-   * @param index - 要移除的拦截器索引
+   * 根据名称移除拦截器
+   * @param name 要移除的拦截器名称
    */
   eject(e) {
-    this.interceptors[e] && (this.interceptors[e] = null);
+    const t = this.sortedInterceptors;
+    return this.sortedInterceptors = h(t, (s) => s.name !== e), t.length !== this.sortedInterceptors.length;
   }
   /**
    * 清空所有拦截器
    */
   clear() {
-    this.interceptors = [];
+    this.sortedInterceptors = [];
   }
   /**
    * 依次执行所有拦截器对数据的处理
@@ -93,17 +102,20 @@ class h {
    */
   async intercept(e) {
     let t = e;
-    for (const s of this.interceptors)
-      s && (t = await s.intercept(t));
+    for (const s of this.sortedInterceptors)
+      t = await s.intercept(t);
     return t;
   }
 }
-class F {
+class O {
   constructor() {
-    this.request = new h(), this.response = new h(), this.error = new h();
+    this.request = new d(), this.response = new d(), this.error = new d();
   }
 }
-class q {
+class S {
+  constructor() {
+    this.name = "RequestBodyInterceptor", this.order = Number.MIN_SAFE_INTEGER;
+  }
   /**
    * 尝试转换请求体为合法的 fetch API body 类型
    *
@@ -134,23 +146,23 @@ class q {
     const s = { ...t };
     s.body = JSON.stringify(t.body), s.headers || (s.headers = {});
     const o = s.headers;
-    return o[d] || (o[d] = p.APPLICATION_JSON), { ...e, request: s };
+    return o[f] || (o[f] = p.APPLICATION_JSON), { ...e, request: s };
   }
 }
-const y = {
-  [d]: p.APPLICATION_JSON
-}, T = {
+const T = {
+  [f]: p.APPLICATION_JSON
+}, y = {
   baseURL: "",
-  headers: y
+  headers: T
 };
-class S {
+class q {
   /**
    * Create a Fetcher instance
    *
    * @param options - Fetcher configuration options
    */
-  constructor(e = T) {
-    this.headers = y, this.interceptors = new F(), this.urlBuilder = new P(e.baseURL), e.headers !== void 0 && (this.headers = e.headers), this.timeout = e.timeout, this.interceptors.request.use(new q());
+  constructor(e = y) {
+    this.headers = T, this.interceptors = new O(), this.urlBuilder = new P(e.baseURL), e.headers !== void 0 && (this.headers = e.headers), this.timeout = e.timeout, this.interceptors.request.use(new S());
   }
   /**
    * Make an HTTP request
@@ -190,16 +202,16 @@ class S {
       error: void 0
     };
     try {
-      const u = {
+      const a = {
         ...n
       };
-      n = await this.interceptors.request.intercept(u), n.response = await this.timeoutFetch(n);
-      const a = {
+      n = await this.interceptors.request.intercept(a), n.response = await this.timeoutFetch(n);
+      const u = {
         ...n
       };
-      return n = await this.interceptors.response.intercept(a), n;
-    } catch (u) {
-      if (n.error = u, n = await this.interceptors.error.intercept(n), n.response)
+      return n = await this.interceptors.response.intercept(u), n;
+    } catch (a) {
+      if (n.error = a, n = await this.interceptors.error.intercept(n), n.response)
         return n;
       throw n.error;
     }
@@ -216,28 +228,28 @@ class S {
    * @throws FetchTimeoutError Thrown when the request times out
    */
   async timeoutFetch(e) {
-    const t = e.url, s = e.request, o = s.timeout, i = O(o, this.timeout);
+    const t = e.url, s = e.request, o = s.timeout, i = A(o, this.timeout);
     if (!i)
       return fetch(t, s);
-    const n = new AbortController(), u = {
+    const n = new AbortController(), a = {
       ...s,
       signal: n.signal
     };
-    let a = null;
-    const E = new Promise((L, w) => {
-      a = setTimeout(() => {
-        a && clearTimeout(a);
-        const m = new l(e, i);
-        n.abort(m), w(m);
+    let u = null;
+    const g = new Promise((L, b) => {
+      u = setTimeout(() => {
+        u && clearTimeout(u);
+        const E = new m(e, i);
+        n.abort(E), b(E);
       }, i);
     });
     try {
       return await Promise.race([
-        fetch(t, u),
-        E
+        fetch(t, a),
+        g
       ]);
     } finally {
-      a && clearTimeout(a);
+      u && clearTimeout(u);
     }
   }
   /**
@@ -325,8 +337,8 @@ class S {
     return this.methodFetch(c.OPTIONS, e, t);
   }
 }
-const f = "default";
-class R {
+const l = "default";
+class N {
   constructor() {
     this.registrar = /* @__PURE__ */ new Map();
   }
@@ -399,7 +411,7 @@ class R {
    * const defaultFetcher = fetcherRegistrar.default;
    */
   get default() {
-    return this.requiredGet(f);
+    return this.requiredGet(l);
   }
   /**
    * Set the default Fetcher instance
@@ -410,7 +422,7 @@ class R {
    * fetcherRegistrar.default = fetcher;
    */
   set default(e) {
-    this.register(f, e);
+    this.register(l, e);
   }
   /**
    * Get a copy of all registered fetchers
@@ -426,8 +438,8 @@ class R {
     return new Map(this.registrar);
   }
 }
-const U = new R();
-class I extends S {
+const R = new N();
+class U extends q {
   /**
    * Create a NamedFetcher instance and automatically register it with the global fetcherRegistrar
    *
@@ -445,28 +457,30 @@ class I extends S {
    *   headers: { 'Authorization': 'Bearer token' }
    * });
    */
-  constructor(e, t = T) {
-    super(t), this.name = e, U.register(e, this);
+  constructor(e, t = y) {
+    super(t), this.name = e, R.register(e, this);
   }
 }
-const N = new I(f);
+const _ = new U(l);
 export {
-  d as ContentTypeHeader,
+  f as ContentTypeHeader,
   p as ContentTypeValues,
-  f as DEFAULT_FETCHER_NAME,
-  T as DEFAULT_OPTIONS,
-  l as FetchTimeoutError,
-  S as Fetcher,
-  F as FetcherInterceptors,
-  R as FetcherRegistrar,
+  l as DEFAULT_FETCHER_NAME,
+  y as DEFAULT_OPTIONS,
+  m as FetchTimeoutError,
+  q as Fetcher,
+  O as FetcherInterceptors,
+  N as FetcherRegistrar,
   c as HttpMethod,
-  h as InterceptorManager,
-  I as NamedFetcher,
-  A as RequestField,
+  d as InterceptorManager,
+  U as NamedFetcher,
+  S as RequestBodyInterceptor,
+  F as RequestField,
   P as UrlBuilder,
-  g as combineURLs,
-  N as fetcher,
-  U as fetcherRegistrar,
-  b as isAbsoluteURL,
-  O as resolveTimeout
+  I as combineURLs,
+  _ as fetcher,
+  R as fetcherRegistrar,
+  w as isAbsoluteURL,
+  A as resolveTimeout,
+  h as toSorted
 };

package/dist/index.umd.js

@@ -1 +1 @@
-(function(n,h){typeof exports=="object"&&typeof module<"u"?h(exports):typeof define=="function"&&define.amd?define(["exports"],h):(n=typeof globalThis<"u"?globalThis:n||self,h(n.Fetcher={}))})(this,(function(n){"use strict";function h(r){return/^([a-z][a-z\d+\-.]*:)?\/\//i.test(r)}function p(r,e){return h(e)?e:e?r.replace(/\/?\/$/,"")+"/"+e.replace(/^\/+/,""):r}class b{constructor(e){this.baseURL=e}build(e,t,s){const o=p(this.baseURL,e);let c=this.interpolateUrl(o,t);if(s){const i=new URLSearchParams(s).toString();i&&(c+="?"+i)}return c}interpolateUrl(e,t){return t?e.replace(/{([^}]+)}/g,(s,o)=>{const c=t[o];if(c===void 0)throw new Error(`Missing required path parameter: ${o}`);return String(c)}):e}}function g(r,e){return typeof r<"u"?r:e}class f extends Error{constructor(e,t){const s=e.request?.method||"GET",o=`Request timeout of ${t}ms exceeded for ${s} ${e.url}`;super(o),this.name="FetchTimeoutError",this.exchange=e,Object.setPrototypeOf(this,f.prototype)}}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||{}),F=(r=>(r.METHOD="method",r.BODY="body",r))(F||{});const l="Content-Type";var m=(r=>(r.APPLICATION_JSON="application/json",r.TEXT_EVENT_STREAM="text/event-stream",r))(m||{});class T{constructor(){this.interceptors=[]}use(e){const t=this.interceptors.length;return this.interceptors.push(e),t}eject(e){this.interceptors[e]&&(this.interceptors[e]=null)}clear(){this.interceptors=[]}async intercept(e){let t=e;for(const s of this.interceptors)s&&(t=await s.intercept(t));return t}}class w{constructor(){this.request=new T,this.response=new T,this.error=new T}}class q{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 e;const s={...t};s.body=JSON.stringify(t.body),s.headers||(s.headers={});const o=s.headers;return o[l]||(o[l]=m.APPLICATION_JSON),{...e,request:s}}}const P={[l]:m.APPLICATION_JSON},E={baseURL:"",headers:P};class A{constructor(e=E){this.headers=P,this.interceptors=new w,this.urlBuilder=new b(e.baseURL),e.headers!==void 0&&(this.headers=e.headers),this.timeout=e.timeout,this.interceptors.request.use(new q)}async fetch(e,t={}){const s=await this.request(e,t);if(!s.response)throw new Error(`Request to ${s.url} failed with no response`);return s.response}async request(e,t={}){const s={...this.headers||{},...t.headers||{}},o={...t,headers:Object.keys(s).length>0?s:void 0},c=this.urlBuilder.build(e,t.path,t.query);let i={fetcher:this,url:c,request:o,response:void 0,error:void 0};try{const d={...i};i=await this.interceptors.request.intercept(d),i.response=await this.timeoutFetch(i);const a={...i};return i=await this.interceptors.response.intercept(a),i}catch(d){if(i.error=d,i=await this.interceptors.error.intercept(i),i.response)return i;throw i.error}}async timeoutFetch(e){const t=e.url,s=e.request,o=s.timeout,c=g(o,this.timeout);if(!c)return fetch(t,s);const i=new AbortController,d={...s,signal:i.signal};let a=null;const I=new Promise((D,N)=>{a=setTimeout(()=>{a&&clearTimeout(a);const U=new f(e,c);i.abort(U),N(U)},c)});try{return await Promise.race([fetch(t,d),I])}finally{a&&clearTimeout(a)}}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 y="default";class O{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(y)}set default(e){this.register(y,e)}get fetchers(){return new Map(this.registrar)}}const R=new O;class S extends A{constructor(e,t=E){super(t),this.name=e,R.register(e,this)}}const L=new S(y);n.ContentTypeHeader=l,n.ContentTypeValues=m,n.DEFAULT_FETCHER_NAME=y,n.DEFAULT_OPTIONS=E,n.FetchTimeoutError=f,n.Fetcher=A,n.FetcherInterceptors=w,n.FetcherRegistrar=O,n.HttpMethod=u,n.InterceptorManager=T,n.NamedFetcher=S,n.RequestField=F,n.UrlBuilder=b,n.combineURLs=p,n.fetcher=L,n.fetcherRegistrar=R,n.isAbsoluteURL=h,n.resolveTimeout=g,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));
+(function(n,h){typeof exports=="object"&&typeof module<"u"?h(exports):typeof define=="function"&&define.amd?define(["exports"],h):(n=typeof globalThis<"u"?globalThis:n||self,h(n.Fetcher={}))})(this,(function(n){"use strict";function h(r){return/^([a-z][a-z\d+\-.]*:)?\/\//i.test(r)}function g(r,e){return h(e)?e:e?r.replace(/\/?\/$/,"")+"/"+e.replace(/^\/+/,""):r}class b{constructor(e){this.baseURL=e}build(e,t,s){const i=g(this.baseURL,e);let c=this.interpolateUrl(i,t);if(s){const o=new URLSearchParams(s).toString();o&&(c+="?"+o)}return c}interpolateUrl(e,t){return t?e.replace(/{([^}]+)}/g,(s,i)=>{const c=t[i];if(c===void 0)throw new Error(`Missing required path parameter: ${i}`);return String(c)}):e}}function F(r,e){return typeof r<"u"?r:e}class f extends Error{constructor(e,t){const s=e.request?.method||"GET",i=`Request timeout of ${t}ms exceeded for ${s} ${e.url}`;super(i),this.name="FetchTimeoutError",this.exchange=e,Object.setPrototypeOf(this,f.prototype)}}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||{}),I=(r=>(r.METHOD="method",r.BODY="body",r))(I||{});const l="Content-Type";var m=(r=>(r.APPLICATION_JSON="application/json",r.TEXT_EVENT_STREAM="text/event-stream",r))(m||{});function T(r,e){return e?r.filter(e).sort((t,s)=>t.order-s.order):[...r].sort((t,s)=>t.order-s.order)}class E{constructor(e=[]){this.sortedInterceptors=[],this.sortedInterceptors=T(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=T([...this.sortedInterceptors,e]),!0)}eject(e){const t=this.sortedInterceptors;return this.sortedInterceptors=T(t,s=>s.name!==e),t.length!==this.sortedInterceptors.length}clear(){this.sortedInterceptors=[]}async intercept(e){let t=e;for(const s of this.sortedInterceptors)t=await s.intercept(t);return t}}class w{constructor(){this.request=new E,this.response=new E,this.error=new E}}class A{constructor(){this.name="RequestBodyInterceptor",this.order=Number.MIN_SAFE_INTEGER}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 e;const s={...t};s.body=JSON.stringify(t.body),s.headers||(s.headers={});const i=s.headers;return i[l]||(i[l]=m.APPLICATION_JSON),{...e,request:s}}}const P={[l]:m.APPLICATION_JSON},p={baseURL:"",headers:P};class O{constructor(e=p){this.headers=P,this.interceptors=new w,this.urlBuilder=new b(e.baseURL),e.headers!==void 0&&(this.headers=e.headers),this.timeout=e.timeout,this.interceptors.request.use(new A)}async fetch(e,t={}){const s=await this.request(e,t);if(!s.response)throw new Error(`Request to ${s.url} failed with no response`);return s.response}async request(e,t={}){const s={...this.headers||{},...t.headers||{}},i={...t,headers:Object.keys(s).length>0?s:void 0},c=this.urlBuilder.build(e,t.path,t.query);let o={fetcher:this,url:c,request:i,response:void 0,error:void 0};try{const d={...o};o=await this.interceptors.request.intercept(d),o.response=await this.timeoutFetch(o);const a={...o};return o=await this.interceptors.response.intercept(a),o}catch(d){if(o.error=d,o=await this.interceptors.error.intercept(o),o.response)return o;throw o.error}}async timeoutFetch(e){const t=e.url,s=e.request,i=s.timeout,c=F(i,this.timeout);if(!c)return fetch(t,s);const o=new AbortController,d={...s,signal:o.signal};let a=null;const L=new Promise((D,_)=>{a=setTimeout(()=>{a&&clearTimeout(a);const q=new f(e,c);o.abort(q),_(q)},c)});try{return await Promise.race([fetch(t,d),L])}finally{a&&clearTimeout(a)}}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 y="default";class R{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(y)}set default(e){this.register(y,e)}get fetchers(){return new Map(this.registrar)}}const S=new R;class N extends O{constructor(e,t=p){super(t),this.name=e,S.register(e,this)}}const U=new N(y);n.ContentTypeHeader=l,n.ContentTypeValues=m,n.DEFAULT_FETCHER_NAME=y,n.DEFAULT_OPTIONS=p,n.FetchTimeoutError=f,n.Fetcher=O,n.FetcherInterceptors=w,n.FetcherRegistrar=R,n.HttpMethod=u,n.InterceptorManager=E,n.NamedFetcher=N,n.RequestBodyInterceptor=A,n.RequestField=I,n.UrlBuilder=b,n.combineURLs=g,n.fetcher=U,n.fetcherRegistrar=S,n.isAbsoluteURL=h,n.resolveTimeout=F,n.toSorted=T,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));

package/dist/interceptor.d.ts

@@ -1,4 +1,6 @@
 import { Fetcher, FetcherRequest } from './fetcher';
+import { NamedCapable } from './types';
+import { OrderedCapable } from './orderedCapable';
 export interface FetchExchange {
     fetcher: Fetcher;
     url: string;
@@ -10,7 +12,11 @@ export interface FetchExchange {
  * 拦截器接口，定义了拦截器的基本结构
  * @template T - 拦截器处理的数据类型
  */
-export interface Interceptor {
+export interface Interceptor extends NamedCapable, OrderedCapable {
+    /**
+     * 拦截器的名称,用于标识拦截器，不可重复
+     */
+    name: string;
     /**
      * 拦截并处理数据
      * @param exchange - 需要处理的数据
@@ -22,18 +28,21 @@ export interface Interceptor {
  * 拦截器管理器类，用于管理同一类型的多个拦截器
  */
 export declare class InterceptorManager implements Interceptor {
-    private interceptors;
+    get name(): string;
+    get order(): number;
+    private sortedInterceptors;
+    constructor(interceptors?: Interceptor[]);
     /**
      * 添加拦截器到管理器中
      * @param interceptor - 要添加的拦截器
      * @returns 拦截器在管理器中的索引位置
      */
-    use(interceptor: Interceptor): number;
+    use(interceptor: Interceptor): boolean;
     /**
-     * 根据索引移除拦截器
-     * @param index - 要移除的拦截器索引
+     * 根据名称移除拦截器
+     * @param name 要移除的拦截器名称
      */
-    eject(index: number): void;
+    eject(name: string): boolean;
     /**
      * 清空所有拦截器
      */

package/dist/interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,SAAS,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5E;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,YAAY,CAAiC;IAErD;;;;OAIG;IACH,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM;IAMrC;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAUjE;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAA4B;IAEvD;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAA4B;IAExD;;OAEG;IACH,KAAK,EAAE,kBAAkB,CAA4B;CACtD"}
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,cAAc,EAAY,MAAM,kBAAkB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,SAAS,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY,EAAE,cAAc;IAC/D;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5E;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,YAAY,GAAE,WAAW,EAAO;IAI5C;;;;OAIG;IACH,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAQtC;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAQjE;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAA4B;IAEvD;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAA4B;IAExD;;OAEG;IACH,KAAK,EAAE,kBAAkB,CAA4B;CACtD"}

package/dist/orderedCapable.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 具备排序能力的接口
+ *
+ * 实现该接口的类型需要提供一个排序属性，用于确定执行顺序。
+ * 数值越小优先级越高，相同数值的元素保持原有相对顺序。
+ */
+export interface OrderedCapable {
+    /**
+     * 排序值
+     *
+     * 数值越小优先级越高。负数、零和正数都支持。
+     * 当多个元素具有相同的order值时，它们的相对顺序将保持不变（稳定排序）。
+     */
+    order: number;
+}
+/**
+ * 对实现了OrderedCapable接口的数组进行排序
+ *
+ * 该函数创建并返回一个新的排序数组，不会修改原始数组。
+ * 支持可选的过滤函数来筛选需要排序的元素。
+ *
+ * @template T - 数组元素类型，必须实现OrderedCapable接口
+ * @param array - 需要排序的数组
+ * @param filter - 可选的过滤函数，用于筛选需要参与排序的元素
+ * @returns 排序后的新数组，按照order值升序排列
+ *
+ * @example
+ * ```typescript
+ * const items: OrderedCapable[] = [
+ *   { order: 10 },
+ *   { order: 5 },
+ *   { order: 1 },
+ * ];
+ *
+ * const sortedItems = toSorted(items);
+ * // 结果: [{ order: 1 }, { order: 5 }, { order: 10 }]
+ *
+ * // 使用过滤函数
+ * const filteredAndSorted = toSorted(items, item => item.order > 3);
+ * // 结果: [{ order: 5 }, { order: 10 }]
+ * ```
+ */
+export declare function toSorted<T extends OrderedCapable>(array: T[], filter?: (item: T) => boolean): T[];
+//# sourceMappingURL=orderedCapable.d.ts.map

package/dist/orderedCapable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderedCapable.d.ts","sourceRoot":"","sources":["../src/orderedCapable.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,cAAc,EAC/C,KAAK,EAAE,CAAC,EAAE,EACV,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAC5B,CAAC,EAAE,CAKL"}

package/dist/requestBodyInterceptor.d.ts

@@ -3,6 +3,8 @@ import { FetchExchange, Interceptor } from './interceptor';
  * 请求体拦截器，负责将普通对象转换为JSON字符串
  */
 export declare class RequestBodyInterceptor implements Interceptor {
+    name: string;
+    order: number;
     /**
      * 尝试转换请求体为合法的 fetch API body 类型
      *

package/dist/requestBodyInterceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requestBodyInterceptor.d.ts","sourceRoot":"","sources":["../src/requestBodyInterceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG3D;;GAEG;AACH,qBAAa,sBAAuB,YAAW,WAAW;IACxD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa;CA2ClD"}
+{"version":3,"file":"requestBodyInterceptor.d.ts","sourceRoot":"","sources":["../src/requestBodyInterceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG3D;;GAEG;AACH,qBAAa,sBAAuB,YAAW,WAAW;IACxD,IAAI,SAA4B;IAChC,KAAK,SAA2B;IAEhC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa;CA2ClD"}

package/dist/types.d.ts

@@ -32,7 +32,28 @@ export declare enum ContentTypeValues {
     APPLICATION_JSON = "application/json",
     TEXT_EVENT_STREAM = "text/event-stream"
 }
+/**
+ * 具备名称能力的接口
+ * 实现该接口的类型需要提供一个名称属性
+ */
 export interface NamedCapable {
+    /**
+     * 名称
+     */
     name: string;
 }
+/**
+ * Global extension of Response interface
+ * Adds type-safe json() method support to Response objects
+ */
+declare global {
+    interface Response {
+        /**
+         * Parse response body as JSON in a type-safe manner
+         * @template T The type of returned data, defaults to any
+         * @returns Promise<T> The parsed JSON data
+         */
+        json<T = any>(): Promise<T>;
+    }
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,oBAAY,UAAU;IACpB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD,oBAAY,iBAAiB;IAC3B,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,oBAAY,UAAU;IACpB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD,oBAAY,iBAAiB;IAC3B,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,QAAQ;QAChB;;;;WAIG;QACH,IAAI,CAAC,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;KAC7B;CACF"}

package/package.json

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