@ahoo-wang/fetcher 0.11.2 → 1.0.0

package/README.md

@@ -8,7 +8,7 @@
 [![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 HTTP client with built-in path parameters, query parameters, and Axios-like API.
+The lightweight core that powers the entire Fetcher ecosystem. Ultra-lightweight foundation with Axios-like API.
 
 ## 🌟 Features
 
@@ -63,6 +63,24 @@ const createUserResponse = await fetcher.post('/users', {
 });
 ```
 
+### Integration Test Example: Typicode API Integration
+
+The following example shows how to integrate with the JSONPlaceholder API, similar to the integration test in the
+Fetcher project. You can find the complete implementation
+in [integration-test/src/fetcher/typicodeFetcher.ts](../../integration-test/src/fetcher/typicodeFetcher.ts).
+
+```typescript
+import { NamedFetcher } from '@ahoo-wang/fetcher';
+import { cosecRequestInterceptor, cosecResponseInterceptor } from '../cosec';
+
+export const typicodeFetcher = new NamedFetcher('typicode', {
+  baseURL: 'https://jsonplaceholder.typicode.com',
+});
+
+typicodeFetcher.interceptors.request.use(cosecRequestInterceptor);
+typicodeFetcher.interceptors.response.use(cosecResponseInterceptor);
+```
+
 ### Named Fetcher Usage
 
 ```typescript

package/README.zh-CN.md

@@ -63,6 +63,24 @@ const createUserResponse = await fetcher.post('/users', {
 });
 ```
 
+### 集成测试示例：Typicode API 集成
+
+以下示例展示了如何与 JSONPlaceholder API 集成，类似于 Fetcher
+项目中的集成测试。您可以在 [integration-test/src/fetcher/typicodeFetcher.ts](../../integration-test/src/fetcher/typicodeFetcher.ts)
+中找到完整实现。
+
+```typescript
+import { NamedFetcher } from '@ahoo-wang/fetcher';
+import { cosecRequestInterceptor, cosecResponseInterceptor } from '../cosec';
+
+export const typicodeFetcher = new NamedFetcher('typicode', {
+  baseURL: 'https://jsonplaceholder.typicode.com',
+});
+
+typicodeFetcher.interceptors.request.use(cosecRequestInterceptor);
+typicodeFetcher.interceptors.response.use(cosecResponseInterceptor);
+```
+
 ### 命名 Fetcher 用法
 
 ```typescript
@@ -95,16 +113,6 @@ try {
 }
 ```
 
-### 默认 Fetcher 用法
-
-```typescript
-import { fetcher } from '@ahoo-wang/fetcher';
-
-// 直接使用默认 fetcher
-const response = await fetcher.get('/users');
-const data = await response.json<User>();
-```
-
 ## 🔗 拦截器系统
 
 ### 核心概念

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,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,cAAc,EAEd,YAAY,EACZ,gBAAgB,EAEhB,cAAc,EACd,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,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;IACnE,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;IAO3E;;;;;;;;;;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"}
+{"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;AACxB,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;IACnE,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;IAO3E;;;;;;;;;;OAUG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAgB5D;;;;;;;;;;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/index.es.js

@@ -105,7 +105,7 @@ class a extends Error {
     super(s), this.cause = t, this.name = "FetcherError", t?.stack && (this.stack = t.stack), Object.setPrototypeOf(this, a.prototype);
   }
 }
-class T extends a {
+class m extends a {
   /**
    * Creates a new FetchTimeoutError instance.
    *
@@ -113,7 +113,7 @@ class T extends a {
    */
   constructor(e) {
     const t = e.method || "GET", s = `Request timeout of ${e.timeout}ms exceeded for ${t} ${e.url}`;
-    super(s), this.name = "FetchTimeoutError", this.request = e, Object.setPrototypeOf(this, T.prototype);
+    super(s), this.name = "FetchTimeoutError", this.request = e, Object.setPrototypeOf(this, m.prototype);
   }
 }
 function S(r, e) {
@@ -131,8 +131,8 @@ async function _(r) {
   const u = new Promise((X, A) => {
     n = setTimeout(() => {
       n && clearTimeout(n);
-      const y = new T(r);
-      o.abort(y), A(y);
+      const f = new m(r);
+      o.abort(f), A(f);
     }, t);
   });
   try {
@@ -158,7 +158,7 @@ class N {
 }
 var c = /* @__PURE__ */ ((r) => (r.GET = "GET", r.POST = "POST", r.PUT = "PUT", r.DELETE = "DELETE", r.PATCH = "PATCH", r.HEAD = "HEAD", r.OPTIONS = "OPTIONS", r))(c || {});
 const z = "Content-Type";
-var R = /* @__PURE__ */ ((r) => (r.APPLICATION_JSON = "application/json", r.TEXT_EVENT_STREAM = "text/event-stream", r))(R || {});
+var T = /* @__PURE__ */ ((r) => (r.APPLICATION_JSON = "application/json", r.TEXT_EVENT_STREAM = "text/event-stream", r))(T || {});
 const F = "RequestBodyInterceptor", q = I + 1e3;
 class U {
   constructor() {
@@ -209,7 +209,7 @@ class U {
     const s = { ...t };
     s.body = JSON.stringify(t.body), s.headers || (s.headers = {});
     const o = s.headers;
-    o["Content-Type"] || (o["Content-Type"] = R.APPLICATION_JSON), e.request = s;
+    o["Content-Type"] || (o["Content-Type"] = T.APPLICATION_JSON), e.request = s;
   }
 }
 const C = "FetchInterceptor", L = Number.MAX_SAFE_INTEGER - 1e3;
@@ -342,11 +342,11 @@ class l {
       await t.intercept(e);
   }
 }
-class f extends a {
+class R extends a {
   constructor(e) {
     super(
       `Request failed with status code ${e.response?.status} for ${e.request.url}`
-    ), this.exchange = e, this.name = "HttpStatusValidationError", Object.setPrototypeOf(this, f.prototype);
+    ), this.exchange = e, this.name = "HttpStatusValidationError", Object.setPrototypeOf(this, R.prototype);
   }
 }
 const v = (r) => r >= 200 && r < 300, B = "ValidateStatusInterceptor", G = Number.MAX_SAFE_INTEGER - 1e3;
@@ -393,7 +393,7 @@ class M {
       return;
     const t = e.response.status;
     if (!this.validateStatus(t))
-      throw new f(e);
+      throw new R(e);
   }
 }
 class h extends a {
@@ -553,15 +553,11 @@ class j {
     return this.response;
   }
 }
-function p(r, e) {
-  if (!(r === void 0 && e === void 0))
-    return e === void 0 ? r : r === void 0 ? e : { ...r, ...e };
-}
-const E = {
-  "Content-Type": R.APPLICATION_JSON
+const p = {
+  "Content-Type": T.APPLICATION_JSON
 }, O = {
   baseURL: "",
-  headers: E
+  headers: p
 };
 class V {
   /**
@@ -573,7 +569,7 @@ class V {
    * @param options - Configuration options for the Fetcher instance
    */
   constructor(e = O) {
-    this.headers = E, this.urlBuilder = new b(e.baseURL), this.headers = e.headers ?? E, this.timeout = e.timeout, this.interceptors = e.interceptors ?? new $();
+    this.headers = p, this.urlBuilder = new b(e.baseURL), this.headers = e.headers ?? p, this.timeout = e.timeout, this.interceptors = e.interceptors ?? new $();
   }
   /**
    * Executes an HTTP request with the specified URL and options.
@@ -602,7 +598,10 @@ class V {
    * @throws Error if an unhandled error occurs during request processing
    */
   async request(e) {
-    const t = p(e.headers, this.headers), s = {
+    const t = {
+      ...this.headers,
+      ...e.headers
+    }, s = {
       ...e,
       headers: t,
       timeout: S(e.timeout, this.timeout)
@@ -714,7 +713,7 @@ class V {
     return this.methodFetch(c.OPTIONS, e, t);
   }
 }
-const m = "default";
+const E = "default";
 class H {
   constructor() {
     this.registrar = /* @__PURE__ */ new Map();
@@ -788,7 +787,7 @@ class H {
    * const defaultFetcher = fetcherRegistrar.default;
    */
   get default() {
-    return this.requiredGet(m);
+    return this.requiredGet(E);
   }
   /**
    * Set the default Fetcher instance
@@ -799,7 +798,7 @@ class H {
    * fetcherRegistrar.default = fetcher;
    */
   set default(e) {
-    this.register(m, e);
+    this.register(E, e);
   }
   /**
    * Get a copy of all registered fetchers
@@ -816,14 +815,18 @@ class H {
   }
 }
 const k = new H();
+function y(r, e) {
+  if (!(r === void 0 && e === void 0))
+    return e === void 0 ? r : r === void 0 ? e : { ...r, ...e };
+}
 function Q(r, e) {
   if (Object.keys(r).length === 0)
     return e;
   if (Object.keys(e).length === 0)
     return r;
   const t = {
-    path: p(r.urlParams?.path, e.urlParams?.path),
-    query: p(r.urlParams?.query, e.urlParams?.query)
+    path: y(r.urlParams?.path, e.urlParams?.path),
+    query: y(r.urlParams?.query, e.urlParams?.query)
   }, s = {
     ...r.headers,
     ...e.headers
@@ -861,23 +864,23 @@ class J extends V {
     super(t), this.name = e, k.register(e, this);
   }
 }
-const Y = new J(m);
+const Y = new J(E);
 export {
   z as ContentTypeHeader,
-  R as ContentTypeValues,
-  m as DEFAULT_FETCHER_NAME,
+  T as ContentTypeValues,
+  E as DEFAULT_FETCHER_NAME,
   O as DEFAULT_OPTIONS,
   h as ExchangeError,
   C as FETCH_INTERCEPTOR_NAME,
   L as FETCH_INTERCEPTOR_ORDER,
   j as FetchExchange,
   D as FetchInterceptor,
-  T as FetchTimeoutError,
+  m as FetchTimeoutError,
   V as Fetcher,
   a as FetcherError,
   H as FetcherRegistrar,
   c as HttpMethod,
-  f as HttpStatusValidationError,
+  R as HttpStatusValidationError,
   $ as InterceptorManager,
   l as InterceptorRegistry,
   J as NamedFetcher,
@@ -895,7 +898,7 @@ export {
   Y as fetcher,
   k as fetcherRegistrar,
   g as isAbsoluteURL,
-  p as mergeRecords,
+  y as mergeRecords,
   Q as mergeRequest,
   S as resolveTimeout,
   _ as timeoutFetch,