@ahoo-wang/fetcher 0.3.3 → 0.3.5

package/README.md

@@ -78,6 +78,55 @@ fetcher
   });
 ```
 
+### Named Fetcher Usage
+
+NamedFetcher is an extension of the Fetcher class that automatically registers itself with a global registrar. This is
+useful when you need to manage multiple fetcher instances throughout your application.
+
+```typescript
+import { NamedFetcher, fetcherRegistrar } from '@ahoo-wang/fetcher';
+
+// Create a named fetcher that automatically registers itself
+const apiFetcher = new NamedFetcher('api', {
+  baseURL: 'https://api.example.com',
+  timeout: 5000,
+  headers: {
+    'Content-Type': 'application/json',
+    Authorization: 'Bearer token',
+  },
+});
+
+// Create another named fetcher for a different service
+const authFetcher = new NamedFetcher('auth', {
+  baseURL: 'https://auth.example.com',
+  timeout: 3000,
+});
+
+// Use the fetcher normally
+apiFetcher
+  .get('/users/123')
+  .then(response => response.json())
+  .then(data => console.log(data));
+
+// Retrieve a named fetcher from the registrar
+const retrievedFetcher = fetcherRegistrar.get('api');
+if (retrievedFetcher) {
+  retrievedFetcher.post('/users', {
+    body: { name: 'Jane Doe' },
+  });
+}
+
+// Use requiredGet to retrieve a fetcher (throws error if not found)
+try {
+  const authFetcher = fetcherRegistrar.requiredGet('auth');
+  authFetcher.post('/login', {
+    body: { username: 'user', password: 'pass' },
+  });
+} catch (error) {
+  console.error('Fetcher not found:', error.message);
+}
+```
+
 ### Interceptor Usage
 
 ```typescript
@@ -149,6 +198,43 @@ new Fetcher(options: FetcherOptions = defaultOptions)
 - `head(url: string, request?: Omit<FetcherRequest, 'method' | 'body'>): Promise<Response>` - HEAD request
 - `options(url: string, request?: Omit<FetcherRequest, 'method' | 'body'>): Promise<Response>` - OPTIONS request
 
+### NamedFetcher Class
+
+An extension of the Fetcher class that automatically registers itself with the global fetcherRegistrar using a provided
+name.
+
+#### Constructor
+
+```typescript
+new NamedFetcher(name
+:
+string, options
+:
+FetcherOptions = defaultOptions
+)
+```
+
+**Parameters:**
+
+- `name`: The name to register this fetcher under
+- `options`: Same as Fetcher constructor options
+
+### 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
+
 ### UrlBuilder Class
 
 URL builder for constructing complete URLs with parameters.

package/README.zh-CN.md

@@ -78,6 +78,55 @@ fetcher
   });
 ```
 
+### 命名 Fetcher 用法
+
+NamedFetcher 是 Fetcher 类的扩展，它会自动使用提供的名称在全局注册器中注册自己。当您需要在应用程序中管理多个 fetcher
+实例时，这很有用。
+
+```typescript
+import { NamedFetcher, fetcherRegistrar } from '@ahoo-wang/fetcher';
+
+// 创建一个自动注册自己的命名 fetcher
+const apiFetcher = new NamedFetcher('api', {
+  baseURL: 'https://api.example.com',
+  timeout: 5000,
+  headers: {
+    'Content-Type': 'application/json',
+    Authorization: 'Bearer token',
+  },
+});
+
+// 为不同的服务创建另一个命名 fetcher
+const authFetcher = new NamedFetcher('auth', {
+  baseURL: 'https://auth.example.com',
+  timeout: 3000,
+});
+
+// 正常使用 fetcher
+apiFetcher
+  .get('/users/123')
+  .then(response => response.json())
+  .then(data => console.log(data));
+
+// 从注册器中检索命名 fetcher
+const retrievedFetcher = fetcherRegistrar.get('api');
+if (retrievedFetcher) {
+  retrievedFetcher.post('/users', {
+    body: { name: 'Jane Doe' },
+  });
+}
+
+// 使用 requiredGet 检索 fetcher（如果未找到则抛出错误）
+try {
+  const authFetcher = fetcherRegistrar.requiredGet('auth');
+  authFetcher.post('/login', {
+    body: { username: 'user', password: 'pass' },
+  });
+} catch (error) {
+  console.error('未找到 Fetcher:', error.message);
+}
+```
+
 ### 拦截器用法
 
 ```typescript
@@ -149,6 +198,40 @@ new Fetcher(options?: FetcherOptions)
 - `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
+)
+```
+
+**参数：**
+
+- `name`：注册此 fetcher 的名称
+- `options`：与 Fetcher 构造函数相同的选项
+
+### FetcherRegistrar
+
+用于按名称管理多个 Fetcher 实例的全局实例。
+
+#### 属性
+
+- `default`：获取或设置默认 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
+
 ### UrlBuilder 类
 
 用于构建带参数的完整 URL 的 URL 构建器。

package/dist/fetcher.d.ts

@@ -6,6 +6,7 @@ import { FetcherInterceptors, FetchExchange } from './interceptor';
  */
 export interface FetcherOptions extends BaseURLCapable, HeadersCapable, TimeoutCapable {
 }
+export declare const defaultOptions: FetcherOptions;
 /**
  * Fetcher request options interface
  */

package/dist/fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../src/fetcher.ts"],"names":[],"mappings":"AAcA,OAAO,EAAqC,cAAc,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EACL,cAAc,EAGd,cAAc,EAEd,YAAY,EACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnE;;GAEG;AACH,MAAM,WAAW,cACf,SAAQ,cAAc,EACpB,cAAc,EACd,cAAc;CACjB;AAWD;;GAEG;AACH,MAAM,WAAW,cACf,SAAQ,cAAc,EACpB,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,OAAQ,YAAW,cAAc,EAAE,cAAc;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAkB;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,UAAU,CAAa;IAC/B,YAAY,EAAE,mBAAmB,CAA6B;IAE9D;;;;OAIG;gBACS,OAAO,GAAE,cAA+B;IASpD;;;;;;OAMG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQzE;;;;;;;;OAQG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAgDzB;;;;;;;;;;OAUG;YACW,YAAY;IA2C1B;;;;;;;OAOG;YACW,WAAW;IAWzB;;;;;;OAMG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,CAAM,GAC1E,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,CAAM,GAC1E,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,CAAM,GAC1E,OAAO,CAAC,QAAQ,CAAC;CAGrB"}
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../src/fetcher.ts"],"names":[],"mappings":"AAcA,OAAO,EAAqC,cAAc,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EACL,cAAc,EAGd,cAAc,EAEd,YAAY,EACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnE;;GAEG;AACH,MAAM,WAAW,cACf,SAAQ,cAAc,EACpB,cAAc,EACd,cAAc;CACjB;AAMD,eAAO,MAAM,cAAc,EAAE,cAG5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cACf,SAAQ,cAAc,EACpB,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,OAAQ,YAAW,cAAc,EAAE,cAAc;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAkB;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,UAAU,CAAa;IAC/B,YAAY,EAAE,mBAAmB,CAA6B;IAE9D;;;;OAIG;gBACS,OAAO,GAAE,cAA+B;IASpD;;;;;;OAMG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQzE;;;;;;;;OAQG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAgDzB;;;;;;;;;;OAUG;YACW,YAAY;IA2C1B;;;;;;;OAOG;YACW,WAAW;IAWzB;;;;;;OAMG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,CAAM,GAC1E,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,CAAM,GAC1E,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,CAAM,GAC1E,OAAO,CAAC,QAAQ,CAAC;CAGrB"}

package/dist/fetcherRegistrar.d.ts

@@ -1,4 +1,8 @@
 import { Fetcher } from './fetcher';
+/**
+ * Default fetcher name used when no name is specified
+ */
+export declare const defaultFetcherName = "default";
 /**
  * FetcherRegistrar is a registry for managing multiple Fetcher instances.
  * It allows registering, retrieving, and unregistering Fetcher instances by name.

package/dist/fetcherRegistrar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcherRegistrar.d.ts","sourceRoot":"","sources":["../src/fetcherRegistrar.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAmC;IAEpD;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAI9C;;;;;;;;;;OAUG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAItC;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQlC;;;;;;;OAOG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;;;OAOG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,EAE3B;IAED;;;;;;;;;OASG;IACH,IAAI,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAEnC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}
+{"version":3,"file":"fetcherRegistrar.d.ts","sourceRoot":"","sources":["../src/fetcherRegistrar.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAmC;IAEpD;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAI9C;;;;;;;;;;OAUG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAItC;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQlC;;;;;;;OAOG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;;;OAOG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,EAE3B;IAED;;;;;;;;;OASG;IACH,IAAI,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAEnC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './fetcher';
 export * from './fetcherRegistrar';
 export * from './interceptor';
+export * from './namedFetcher';
 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,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,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC"}

package/dist/index.es.js

@@ -1,10 +1,10 @@
-function E(r) {
+function b(r) {
   return /^([a-z][a-z\d+\-.]*:)?\/\//i.test(r);
 }
-function b(r, e) {
-  return E(e) ? e : e ? r.replace(/\/?\/$/, "") + "/" + e.replace(/^\/+/, "") : r;
+function g(r, e) {
+  return b(e) ? e : e ? r.replace(/\/?\/$/, "") + "/" + e.replace(/^\/+/, "") : r;
 }
-class g {
+class P {
   /**
    * 创建UrlBuilder实例
    *
@@ -23,7 +23,7 @@ class g {
    * @throws 当路径参数中缺少必需的占位符时抛出错误
    */
   build(e, t, s) {
-    let i = b(this.baseURL, e), o = this.interpolateUrl(i, t);
+    let i = g(this.baseURL, e), o = this.interpolateUrl(i, t);
     if (s) {
       const n = new URLSearchParams(s).toString();
       n && (o += "?" + n);
@@ -47,7 +47,7 @@ class g {
     }) : e;
   }
 }
-function P(r, e) {
+function O(r, e) {
   return typeof r < "u" ? r : e;
 }
 class l extends Error {
@@ -56,7 +56,7 @@ class l extends Error {
     super(i), this.name = "FetchTimeoutError", this.exchange = e, Object.setPrototypeOf(this, l.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 || {}), O = /* @__PURE__ */ ((r) => (r.METHOD = "method", r.BODY = "body", r))(O || {});
+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 || {}), q = /* @__PURE__ */ ((r) => (r.METHOD = "method", r.BODY = "body", r))(q || {});
 const d = "Content-Type";
 var f = /* @__PURE__ */ ((r) => (r.APPLICATION_JSON = "application/json", r.TEXT_EVENT_STREAM = "text/event-stream", r))(f || {});
 class h {
@@ -97,7 +97,7 @@ class h {
     return t;
   }
 }
-class q {
+class F {
   constructor() {
     this.request = new h(), this.response = new h(), this.error = new h();
   }
@@ -138,18 +138,18 @@ class A {
 }
 const y = {
   [d]: f.APPLICATION_JSON
-}, F = {
+}, T = {
   baseURL: "",
   headers: y
 };
-class I {
+class S {
   /**
    * Create a Fetcher instance
    *
    * @param options - Fetcher configuration options
    */
-  constructor(e = F) {
-    this.headers = y, this.interceptors = new q(), this.urlBuilder = new g(e.baseURL), e.headers !== void 0 && (this.headers = e.headers), this.timeout = e.timeout, this.interceptors.request.use(new A());
+  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 A());
   }
   /**
    * Make an HTTP request
@@ -219,7 +219,7 @@ class I {
    * @throws FetchTimeoutError Thrown when the request times out
    */
   async timeoutFetch(e) {
-    const t = e.url, s = e.request, i = s.timeout, o = P(i, this.timeout);
+    const t = e.url, s = e.request, i = s.timeout, o = O(i, this.timeout);
     if (!o)
       return fetch(t, s);
     const n = new AbortController(), u = {
@@ -227,17 +227,17 @@ class I {
       signal: n.signal
     };
     let a = null;
-    const T = new Promise((R, w) => {
+    const w = new Promise((N, E) => {
       a = setTimeout(() => {
         a && clearTimeout(a);
         const p = new l(e, o);
-        n.abort(p), w(p);
+        n.abort(p), E(p);
       }, o);
     });
     try {
       return await Promise.race([
         fetch(t, u),
-        T
+        w
       ]);
     } finally {
       a && clearTimeout(a);
@@ -329,7 +329,7 @@ class I {
   }
 }
 const m = "default";
-class S {
+class R {
   constructor() {
     this.registrar = /* @__PURE__ */ new Map();
   }
@@ -429,20 +429,45 @@ class S {
     return new Map(this.registrar);
   }
 }
-const U = new S();
+const I = new R();
+class U extends S {
+  /**
+   * Create a NamedFetcher instance and automatically register it with the global fetcherRegistrar
+   *
+   * @param name - The name to register this fetcher under
+   * @param options - Fetcher configuration options (same as Fetcher constructor)
+   *
+   * @example
+   * // Create with default options
+   * const fetcher1 = new NamedFetcher('default');
+   *
+   * // Create with custom options
+   * const fetcher2 = new NamedFetcher('api', {
+   *   baseURL: 'https://api.example.com',
+   *   timeout: 5000,
+   *   headers: { 'Authorization': 'Bearer token' }
+   * });
+   */
+  constructor(e, t = T) {
+    super(t), this.name = e, I.register(e, this);
+  }
+}
 export {
   d as ContentTypeHeader,
   f as ContentTypeValues,
   l as FetchTimeoutError,
-  I as Fetcher,
-  q as FetcherInterceptors,
-  S as FetcherRegistrar,
+  S as Fetcher,
+  F as FetcherInterceptors,
+  R as FetcherRegistrar,
   c as HttpMethod,
   h as InterceptorManager,
-  O as RequestField,
-  g as UrlBuilder,
-  b as combineURLs,
-  U as fetcherRegistrar,
-  E as isAbsoluteURL,
-  P as resolveTimeout
+  U as NamedFetcher,
+  q as RequestField,
+  P as UrlBuilder,
+  g as combineURLs,
+  m as defaultFetcherName,
+  T as defaultOptions,
+  I as fetcherRegistrar,
+  b as isAbsoluteURL,
+  O as resolveTimeout
 };

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 y(r,e){return h(e)?e:e?r.replace(/\/?\/$/,"")+"/"+e.replace(/^\/+/,""):r}class T{constructor(e){this.baseURL=e}build(e,t,s){let o=y(this.baseURL,e),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 b(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||{}),g=(r=>(r.METHOD="method",r.BODY="body",r))(g||{});const l="Content-Type";var m=(r=>(r.APPLICATION_JSON="application/json",r.TEXT_EVENT_STREAM="text/event-stream",r))(m||{});class p{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(let s of this.interceptors)s&&(t=await s.intercept(t));return t}}class E{constructor(){this.request=new p,this.response=new p,this.error=new p}}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 w={[l]:m.APPLICATION_JSON},R={baseURL:"",headers:w};class S{constructor(e=R){this.headers=w,this.interceptors=new E,this.urlBuilder=new T(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.pathParams,t.queryParams);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=b(o,this.timeout);if(!c)return fetch(t,s);const i=new AbortController,d={...s,signal:i.signal};let a=null;const U=new Promise((L,I)=>{a=setTimeout(()=>{a&&clearTimeout(a);const O=new f(e,c);i.abort(O),I(O)},c)});try{return await Promise.race([fetch(t,d),U])}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 P="default";class F{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(P)}set default(e){this.register(P,e)}get fetchers(){return new Map(this.registrar)}}const A=new F;n.ContentTypeHeader=l,n.ContentTypeValues=m,n.FetchTimeoutError=f,n.Fetcher=S,n.FetcherInterceptors=E,n.FetcherRegistrar=F,n.HttpMethod=u,n.InterceptorManager=p,n.RequestField=g,n.UrlBuilder=T,n.combineURLs=y,n.fetcherRegistrar=A,n.isAbsoluteURL=h,n.resolveTimeout=b,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 b(r,e){return h(e)?e:e?r.replace(/\/?\/$/,"")+"/"+e.replace(/^\/+/,""):r}class g{constructor(e){this.baseURL=e}build(e,t,s){let o=b(this.baseURL,e),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 E(r,e){return typeof r<"u"?r:e}class l 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)}}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||{}),w=(r=>(r.METHOD="method",r.BODY="body",r))(w||{});const f="Content-Type";var m=(r=>(r.APPLICATION_JSON="application/json",r.TEXT_EVENT_STREAM="text/event-stream",r))(m||{});class p{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(let s of this.interceptors)s&&(t=await s.intercept(t));return t}}class F{constructor(){this.request=new p,this.response=new p,this.error=new p}}class A{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[f]||(o[f]=m.APPLICATION_JSON),{...e,request:s}}}const P={[f]:m.APPLICATION_JSON},y={baseURL:"",headers:P};class O{constructor(e=y){this.headers=P,this.interceptors=new F,this.urlBuilder=new g(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||{}},o={...t,headers:Object.keys(s).length>0?s:void 0},c=this.urlBuilder.build(e,t.pathParams,t.queryParams);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=E(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((L,N)=>{a=setTimeout(()=>{a&&clearTimeout(a);const S=new l(e,c);i.abort(S),N(S)},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 T="default";class q{constructor(){this.registrar=new Map}register(e,t){this.registrar.set(e,t)}unregister(e){return this.registrar.delete(e)}get(e){return this.registrar.get(e)}requiredGet(e){const t=this.get(e);if(!t)throw new Error(`Fetcher ${e} not found`);return t}get default(){return this.requiredGet(T)}set default(e){this.register(T,e)}get fetchers(){return new Map(this.registrar)}}const R=new q;class U extends O{constructor(e,t=y){super(t),this.name=e,R.register(e,this)}}n.ContentTypeHeader=f,n.ContentTypeValues=m,n.FetchTimeoutError=l,n.Fetcher=O,n.FetcherInterceptors=F,n.FetcherRegistrar=q,n.HttpMethod=u,n.InterceptorManager=p,n.NamedFetcher=U,n.RequestField=w,n.UrlBuilder=g,n.combineURLs=b,n.defaultFetcherName=T,n.defaultOptions=y,n.fetcherRegistrar=R,n.isAbsoluteURL=h,n.resolveTimeout=E,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));

package/dist/namedFetcher.d.ts

@@ -0,0 +1,47 @@
+import { NamedCapable } from './types';
+import { Fetcher, FetcherOptions } from './fetcher';
+/**
+ * NamedFetcher is an extension of the Fetcher class that automatically registers
+ * itself with the global fetcherRegistrar using a provided name.
+ * This allows for easy management and retrieval of multiple fetcher instances
+ * throughout an application by name.
+ *
+ * @example
+ * // Create a named fetcher that automatically registers itself
+ * const apiFetcher = new NamedFetcher('api', {
+ *   baseURL: 'https://api.example.com',
+ *   timeout: 5000
+ * });
+ *
+ * // Retrieve the fetcher later by name
+ * const sameFetcher = fetcherRegistrar.get('api');
+ * console.log(apiFetcher === sameFetcher); // true
+ *
+ * // Use the fetcher normally
+ * const response = await apiFetcher.get('/users');
+ */
+export declare class NamedFetcher extends Fetcher implements NamedCapable {
+    /**
+     * The name of this fetcher instance, used for registration and retrieval
+     */
+    name: string;
+    /**
+     * Create a NamedFetcher instance and automatically register it with the global fetcherRegistrar
+     *
+     * @param name - The name to register this fetcher under
+     * @param options - Fetcher configuration options (same as Fetcher constructor)
+     *
+     * @example
+     * // Create with default options
+     * const fetcher1 = new NamedFetcher('default');
+     *
+     * // Create with custom options
+     * const fetcher2 = new NamedFetcher('api', {
+     *   baseURL: 'https://api.example.com',
+     *   timeout: 5000,
+     *   headers: { 'Authorization': 'Bearer token' }
+     * });
+     */
+    constructor(name: string, options?: FetcherOptions);
+}
+//# sourceMappingURL=namedFetcher.d.ts.map

package/dist/namedFetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namedFetcher.d.ts","sourceRoot":"","sources":["../src/namedFetcher.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAkB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAa,SAAQ,OAAQ,YAAW,YAAY;IAC/D;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;;;;;;;OAgBG;gBACS,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAA+B;CAKnE"}

package/dist/timeout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../src/timeout.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,cAAc,CAAC,EAAE,MAAM,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,EAAE,aAAa,CAAC;gBAEZ,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM;CAUrD"}
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../src/timeout.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,cAAc,CAAC,EAAE,MAAM,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,EAAE,aAAa,CAAC;gBAEZ,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM;CAUrD"}

package/dist/types.d.ts

@@ -32,4 +32,7 @@ export declare enum ContentTypeValues {
     APPLICATION_JSON = "application/json",
     TEXT_EVENT_STREAM = "text/event-stream"
 }
+export interface NamedCapable {
+    name: string;
+}
 //# 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"}
+{"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;AAGD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahoo-wang/fetcher",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Core library providing basic HTTP client functionality for Fetcher",
   "keywords": [
     "fetch",