@ahoo-wang/fetcher 0.8.1 → 0.8.2

package/dist/fetcher.d.ts

@@ -1,6 +1,8 @@
+import { UrlBuilder, UrlBuilderCapable } from './urlBuilder';
 import { TimeoutCapable } from './timeout';
 import { BaseURLCapable, HeadersCapable, RequestField } from './types';
-import { FetcherInterceptors, FetchExchange } from './interceptor';
+import { FetcherInterceptors } from './interceptor';
+import { FetcherRequest, FetchExchange } from './fetchExchange';
 /**
  * Fetcher configuration options interface
  */
@@ -8,89 +10,6 @@ export interface FetcherOptions extends BaseURLCapable, HeadersCapable, TimeoutC
     interceptors?: FetcherInterceptors;
 }
 export declare const DEFAULT_OPTIONS: FetcherOptions;
-/**
- * Fetcher request configuration interface
- *
- * This interface defines all the configuration options available for making HTTP requests
- * with the Fetcher client. It extends the standard RequestInit interface while adding
- * Fetcher-specific features like path parameters, query parameters, and timeout control.
- *
- * @example
- * ```typescript
- * const request: FetcherRequest = {
- *   method: 'GET',
- *   path: { id: 123 },
- *   query: { include: 'profile' },
- *   headers: { 'Authorization': 'Bearer token' },
- *   timeout: 5000
- * };
- *
- * const response = await fetcher.fetch('/users/{id}', request);
- * ```
- */
-export interface FetcherRequest extends TimeoutCapable, HeadersCapable, Omit<RequestInit, 'body' | 'headers'> {
-    /**
-     * Path parameters for URL templating
-     *
-     * An object containing key-value pairs that will be used to replace placeholders
-     * in the URL path. Placeholders are specified using curly braces, e.g., '/users/{id}'.
-     *
-     * @example
-     * ```typescript
-     * // With URL '/users/{id}/posts/{postId}'
-     * const request = {
-     *   path: { id: 123, postId: 456 }
-     * };
-     * // Results in URL: '/users/123/posts/456'
-     * ```
-     */
-    path?: Record<string, any>;
-    /**
-     * Query parameters for URL query string
-     *
-     * An object containing key-value pairs that will be serialized and appended
-     * to the URL as query parameters. Arrays are serialized as multiple parameters
-     * with the same name, and objects are JSON-stringified.
-     *
-     * @example
-     * ```typescript
-     * const request = {
-     *   query: {
-     *     limit: 10,
-     *     filter: 'active',
-     *     tags: ['important', 'urgent']
-     *   }
-     * };
-     * // Results in query string: '?limit=10&filter=active&tags=important&tags=urgent'
-     * ```
-     */
-    query?: Record<string, any>;
-    /**
-     * Request body
-     *
-     * The body of the request. Can be a string, Blob, ArrayBuffer, FormData,
-     * URLSearchParams, or a plain object. Plain objects are automatically
-     * converted to JSON and the appropriate Content-Type header is set.
-     *
-     * @example
-     * ```typescript
-     * // Plain object (automatically converted to JSON)
-     * const request = {
-     *   method: 'POST',
-     *   body: { name: 'John', email: 'john@example.com' }
-     * };
-     *
-     * // FormData
-     * const formData = new FormData();
-     * formData.append('name', 'John');
-     * const request = {
-     *   method: 'POST',
-     *   body: formData
-     * };
-     * ```
-     */
-    body?: BodyInit | Record<string, any> | null;
-}
 /**
  * HTTP client class that supports URL building, timeout control, and more
  *
@@ -102,10 +21,10 @@ export interface FetcherRequest extends TimeoutCapable, HeadersCapable, Omit<Req
  *   timeout: 5000
  * });
  */
-export declare class Fetcher implements HeadersCapable, TimeoutCapable {
+export declare class Fetcher implements UrlBuilderCapable, HeadersCapable, TimeoutCapable {
+    urlBuilder: UrlBuilder;
     headers?: Record<string, string>;
     timeout?: number;
-    private urlBuilder;
     interceptors: FetcherInterceptors;
     /**
      * Create a Fetcher instance
@@ -131,6 +50,23 @@ export declare class Fetcher implements HeadersCapable, TimeoutCapable {
      * @throws Throws an exception when an error occurs during the request and is not handled by error interceptors
      */
     request(url: string, request?: FetcherRequest): Promise<FetchExchange>;
+    /**
+     * Process a fetch exchange through the interceptor chain
+     *
+     * This method orchestrates the complete request lifecycle by applying interceptors
+     * in the following order:
+     * 1. Request interceptors - to modify the outgoing request
+     * 2. Response interceptors - to process the incoming response
+     *
+     * If any error occurs during the process, error interceptors are applied to handle it.
+     * If an error interceptor produces a response, that response is returned. Otherwise,
+     * the original error is re-thrown.
+     *
+     * @param fetchExchange - The exchange object containing request, response, and metadata
+     * @returns Promise<FetchExchange> The processed exchange with final response or error
+     * @throws Error if an error occurs and is not handled by error interceptors
+     */
+    exchange(fetchExchange: FetchExchange): Promise<FetchExchange>;
     /**
      * Make an HTTP request with the specified method
      *

package/dist/fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../src/fetcher.ts"],"names":[],"mappings":"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"}
+{"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,EACL,cAAc,EAGd,cAAc,EAEd,YAAY,EACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,cACf,SAAQ,cAAc,EACpB,cAAc,EACd,cAAc;IAChB,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAMD,eAAO,MAAM,eAAe,EAAE,cAG7B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,OAAQ,YAAW,iBAAiB,EAAE,cAAc,EAAE,cAAc;IAC/E,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAmB;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,mBAAmB,CAAC;IAElC;;;;OAIG;gBACS,OAAO,GAAE,cAAgC;IAOrD;;;;;;OAMG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQzE;;;;;;;;OAQG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAwBzB;;;;;;;;;;;;;;;OAeG;IACG,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBpE;;;;;;;OAOG;YACW,WAAW;IAWzB;;;;;;OAMG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,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/index.d.ts

@@ -1,5 +1,6 @@
 export * from './fetcher';
 export * from './fetcherRegistrar';
+export * from './fetchExchange';
 export * from './fetchInterceptor';
 export * from './interceptor';
 export * from './mergeRequest';
@@ -9,5 +10,6 @@ export * from './requestBodyInterceptor';
 export * from './timeout';
 export * from './types';
 export * from './urlBuilder';
+export * from './urlResolveInterceptor';
 export * from './urls';
 //# 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,oBAAoB,CAAC;AACnC,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,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,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,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"}

package/dist/index.es.js

@@ -1,10 +1,10 @@
-function b(r) {
+function E(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 E(e) ? e : e ? r.replace(/\/?\/$/, "") + "/" + e.replace(/^\/+/, "") : r;
 }
-class I {
+class w {
   /**
    * Creates a UrlBuilder instance
    *
@@ -33,11 +33,11 @@ class I {
    * ```
    */
   build(e, t, s) {
-    const i = g(this.baseURL, e);
-    let o = this.interpolateUrl(i, t);
+    const n = I(this.baseURL, e);
+    let o = this.interpolateUrl(n, t);
     if (s) {
-      const n = new URLSearchParams(s).toString();
-      n && (o += "?" + n);
+      const c = new URLSearchParams(s).toString();
+      c && (o += "?" + c);
     }
     return o;
   }
@@ -57,15 +57,15 @@ class I {
    * ```
    */
   interpolateUrl(e, t) {
-    return t ? e.replace(/{([^}]+)}/g, (s, i) => {
-      const o = t[i];
+    return t ? e.replace(/{([^}]+)}/g, (s, n) => {
+      const o = t[n];
       if (o === void 0)
-        throw new Error(`Missing required path parameter: ${i}`);
+        throw new Error(`Missing required path parameter: ${n}`);
       return String(o);
     }) : e;
   }
 }
-function w(r, e) {
+function A(r, e) {
   return typeof r < "u" ? r : e;
 }
 class p extends Error {
@@ -77,43 +77,43 @@ class p extends Error {
    * @param timeout - The timeout value in milliseconds
    */
   constructor(e, t, s) {
-    const i = t.method || "GET", o = `Request timeout of ${s}ms exceeded for ${i} ${e}`;
+    const n = t.method || "GET", o = `Request timeout of ${s}ms exceeded for ${n} ${e}`;
     super(o), this.name = "FetchTimeoutError", this.url = e, this.request = t, this.timeout = s, Object.setPrototypeOf(this, p.prototype);
   }
 }
-async function A(r, e, t) {
+async function F(r, e, t) {
   if (!t)
     return fetch(r, e);
-  const s = new AbortController(), i = {
+  const s = new AbortController(), n = {
     ...e,
     signal: s.signal
   };
   let o = null;
-  const n = new Promise((a, h) => {
+  const c = new Promise((y, u) => {
     o = setTimeout(() => {
       o && clearTimeout(o);
-      const E = new p(r, e, t);
-      s.abort(E), h(E);
+      const T = new p(r, e, t);
+      s.abort(T), u(T);
     }, t);
   });
   try {
     return await Promise.race([
-      fetch(r, i),
-      n
+      fetch(r, n),
+      c
     ]);
   } finally {
     o && clearTimeout(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 || {}), F = /* @__PURE__ */ ((r) => (r.METHOD = "method", r.BODY = "body", r))(F || {});
-const l = "Content-Type";
-var y = /* @__PURE__ */ ((r) => (r.APPLICATION_JSON = "application/json", r.TEXT_EVENT_STREAM = "text/event-stream", r))(y || {});
-function u(r, e) {
+var i = /* @__PURE__ */ ((r) => (r.GET = "GET", r.POST = "POST", r.PUT = "PUT", r.DELETE = "DELETE", r.PATCH = "PATCH", r.HEAD = "HEAD", r.OPTIONS = "OPTIONS", r))(i || {}), N = /* @__PURE__ */ ((r) => (r.METHOD = "method", r.BODY = "body", r))(N || {});
+const d = "Content-Type";
+var f = /* @__PURE__ */ ((r) => (r.APPLICATION_JSON = "application/json", r.TEXT_EVENT_STREAM = "text/event-stream", r))(f || {});
+function a(r, e) {
   return e ? r.filter(e).sort((t, s) => t.order - s.order) : [...r].sort((t, s) => t.order - s.order);
 }
 class O {
   constructor() {
-    this.name = "RequestBodyInterceptor", this.order = Number.MIN_SAFE_INTEGER;
+    this.name = "RequestBodyInterceptor", this.order = Number.MIN_SAFE_INTEGER + 100;
   }
   /**
    * Attempts to convert request body to a valid fetch API body type
@@ -158,8 +158,8 @@ class O {
       return e;
     const s = { ...t };
     s.body = JSON.stringify(t.body), s.headers || (s.headers = {});
-    const i = s.headers;
-    return i[l] || (i[l] = y.APPLICATION_JSON), e.request = s, e;
+    const n = s.headers;
+    return n[d] || (n[d] = f.APPLICATION_JSON), e.request = s, e;
   }
 }
 class P {
@@ -191,14 +191,32 @@ class P {
    * console.log(result.response); // HTTP response object
    */
   async intercept(e) {
-    return e.response = await A(
+    return e.response = await F(
       e.url,
       e.request,
       e.request.timeout
     ), e;
   }
 }
-class d {
+class R {
+  constructor() {
+    this.name = "UrlResolveInterceptor", this.order = Number.MIN_SAFE_INTEGER;
+  }
+  /**
+   * Resolves the final URL by combining the base URL, path parameters, and query parameters
+   *
+   * @param exchange - The fetch exchange containing the request information
+   * @returns The modified exchange with the resolved URL
+   */
+  intercept(e) {
+    return e.url = e.fetcher.urlBuilder.build(
+      e.url,
+      e.request.path,
+      e.request.query
+    ), e;
+  }
+}
+class h {
   /**
    * Creates a new InterceptorManager instance
    *
@@ -209,7 +227,7 @@ class d {
    * upon construction.
    */
   constructor(e = []) {
-    this.sortedInterceptors = [], this.sortedInterceptors = u(e);
+    this.sortedInterceptors = [], this.sortedInterceptors = a(e);
   }
   /**
    * Gets the name of this interceptor manager
@@ -241,7 +259,7 @@ class d {
    * After adding, interceptors are automatically sorted by their order property.
    */
   use(e) {
-    return this.sortedInterceptors.some((t) => t.name === e.name) ? !1 : (this.sortedInterceptors = u([
+    return this.sortedInterceptors.some((t) => t.name === e.name) ? !1 : (this.sortedInterceptors = a([
       ...this.sortedInterceptors,
       e
     ]), !0);
@@ -255,7 +273,7 @@ class d {
    */
   eject(e) {
     const t = this.sortedInterceptors;
-    return this.sortedInterceptors = u(
+    return this.sortedInterceptors = a(
       t,
       (s) => s.name !== e
     ), t.length !== this.sortedInterceptors.length;
@@ -289,26 +307,27 @@ class d {
 }
 class S {
   constructor() {
-    this.request = new d([
+    this.request = new h([
+      new R(),
       new O(),
       new P()
-    ]), this.response = new d(), this.error = new d();
+    ]), this.response = new h(), this.error = new h();
   }
 }
-const f = {
-  [l]: y.APPLICATION_JSON
-}, T = {
+const l = {
+  [d]: f.APPLICATION_JSON
+}, b = {
   baseURL: "",
-  headers: f
+  headers: l
 };
-class N {
+class g {
   /**
    * Create a Fetcher instance
    *
    * @param options - Fetcher configuration options
    */
-  constructor(e = T) {
-    this.headers = f, this.urlBuilder = new I(e.baseURL), this.headers = e.headers ?? f, this.timeout = e.timeout, this.interceptors = e.interceptors ?? new S();
+  constructor(e = b) {
+    this.headers = l, this.urlBuilder = new w(e.baseURL), this.headers = e.headers ?? l, this.timeout = e.timeout, this.interceptors = e.interceptors ?? new S();
   }
   /**
    * Make an HTTP request
@@ -336,25 +355,43 @@ class N {
     const s = {
       ...this.headers || {},
       ...t.headers || {}
-    }, i = {
+    }, n = {
       ...t,
       headers: Object.keys(s).length > 0 ? s : void 0,
-      timeout: w(t.timeout, this.timeout)
-    }, o = this.urlBuilder.build(e, t.path, t.query);
-    let n = {
+      timeout: A(t.timeout, this.timeout)
+    }, o = {
       fetcher: this,
-      url: o,
-      request: i,
+      url: e,
+      request: n,
       response: void 0,
       error: void 0,
       attributes: {}
     };
+    return this.exchange(o);
+  }
+  /**
+   * Process a fetch exchange through the interceptor chain
+   *
+   * This method orchestrates the complete request lifecycle by applying interceptors
+   * in the following order:
+   * 1. Request interceptors - to modify the outgoing request
+   * 2. Response interceptors - to process the incoming response
+   *
+   * If any error occurs during the process, error interceptors are applied to handle it.
+   * If an error interceptor produces a response, that response is returned. Otherwise,
+   * the original error is re-thrown.
+   *
+   * @param fetchExchange - The exchange object containing request, response, and metadata
+   * @returns Promise<FetchExchange> The processed exchange with final response or error
+   * @throws Error if an error occurs and is not handled by error interceptors
+   */
+  async exchange(e) {
     try {
-      return n = await this.interceptors.request.intercept(n), n = await this.interceptors.response.intercept(n), n;
-    } catch (a) {
-      if (n.error = a, n = await this.interceptors.error.intercept(n), n.response)
-        return n;
-      throw n.error;
+      return e = await this.interceptors.request.intercept(e), e = await this.interceptors.response.intercept(e), e;
+    } catch (t) {
+      if (e.error = t, e = await this.interceptors.error.intercept(e), e.response)
+        return e;
+      throw e.error;
     }
   }
   /**
@@ -379,7 +416,7 @@ class N {
    * @returns Promise<Response> HTTP response
    */
   async get(e, t = {}) {
-    return this.methodFetch(c.GET, e, t);
+    return this.methodFetch(i.GET, e, t);
   }
   /**
    * Make a POST request
@@ -389,7 +426,7 @@ class N {
    * @returns Promise<Response> HTTP response
    */
   async post(e, t = {}) {
-    return this.methodFetch(c.POST, e, t);
+    return this.methodFetch(i.POST, e, t);
   }
   /**
    * Make a PUT request
@@ -399,7 +436,7 @@ class N {
    * @returns Promise<Response> HTTP response
    */
   async put(e, t = {}) {
-    return this.methodFetch(c.PUT, e, t);
+    return this.methodFetch(i.PUT, e, t);
   }
   /**
    * Make a DELETE request
@@ -409,7 +446,7 @@ class N {
    * @returns Promise<Response> HTTP response
    */
   async delete(e, t = {}) {
-    return this.methodFetch(c.DELETE, e, t);
+    return this.methodFetch(i.DELETE, e, t);
   }
   /**
    * Make a PATCH request
@@ -419,7 +456,7 @@ class N {
    * @returns Promise<Response> HTTP response
    */
   async patch(e, t = {}) {
-    return this.methodFetch(c.PATCH, e, t);
+    return this.methodFetch(i.PATCH, e, t);
   }
   /**
    * Make a HEAD request
@@ -429,7 +466,7 @@ class N {
    * @returns Promise<Response> HTTP response
    */
   async head(e, t = {}) {
-    return this.methodFetch(c.HEAD, e, t);
+    return this.methodFetch(i.HEAD, e, t);
   }
   /**
    * Make an OPTIONS request
@@ -439,11 +476,11 @@ class N {
    * @returns Promise<Response> HTTP response
    */
   async options(e, t = {}) {
-    return this.methodFetch(c.OPTIONS, e, t);
+    return this.methodFetch(i.OPTIONS, e, t);
   }
 }
 const m = "default";
-class R {
+class q {
   constructor() {
     this.registrar = /* @__PURE__ */ new Map();
   }
@@ -543,8 +580,8 @@ class R {
     return new Map(this.registrar);
   }
 }
-const q = new R();
-function _(r, e) {
+const _ = new q();
+function L(r, e) {
   if (Object.keys(r).length === 0)
     return e;
   if (Object.keys(e).length === 0)
@@ -555,23 +592,23 @@ function _(r, e) {
   }, s = {
     ...r.query,
     ...e.query
-  }, i = {
+  }, n = {
     ...r.headers,
     ...e.headers
-  }, o = e.method ?? r.method, n = e.body ?? r.body, a = e.timeout ?? r.timeout, h = e.signal ?? r.signal;
+  }, o = e.method ?? r.method, c = e.body ?? r.body, y = e.timeout ?? r.timeout, u = e.signal ?? r.signal;
   return {
     ...r,
     ...e,
     method: o,
     path: t,
     query: s,
-    headers: i,
-    body: n,
-    timeout: a,
-    signal: h
+    headers: n,
+    body: c,
+    timeout: y,
+    signal: u
   };
 }
-class U extends N {
+class U extends g {
   /**
    * Create a NamedFetcher instance and automatically register it with the global fetcherRegistrar
    *
@@ -589,33 +626,34 @@ class U extends N {
    *   headers: { 'Authorization': 'Bearer token' }
    * });
    */
-  constructor(e, t = T) {
-    super(t), this.name = e, q.register(e, this);
+  constructor(e, t = b) {
+    super(t), this.name = e, _.register(e, this);
   }
 }
-const L = new U(m);
+const D = new U(m);
 export {
-  l as ContentTypeHeader,
-  y as ContentTypeValues,
+  d as ContentTypeHeader,
+  f as ContentTypeValues,
   m as DEFAULT_FETCHER_NAME,
-  T as DEFAULT_OPTIONS,
+  b as DEFAULT_OPTIONS,
   P as FetchInterceptor,
   p as FetchTimeoutError,
-  N as Fetcher,
+  g as Fetcher,
   S as FetcherInterceptors,
-  R as FetcherRegistrar,
-  c as HttpMethod,
-  d as InterceptorManager,
+  q as FetcherRegistrar,
+  i as HttpMethod,
+  h as InterceptorManager,
   U as NamedFetcher,
   O as RequestBodyInterceptor,
-  F as RequestField,
-  I as UrlBuilder,
-  g as combineURLs,
-  L as fetcher,
-  q as fetcherRegistrar,
-  b as isAbsoluteURL,
-  _ as mergeRequest,
-  w as resolveTimeout,
-  A as timeoutFetch,
-  u as toSorted
+  N as RequestField,
+  w as UrlBuilder,
+  R as UrlResolveInterceptor,
+  I as combineURLs,
+  D as fetcher,
+  _ as fetcherRegistrar,
+  E as isAbsoluteURL,
+  L as mergeRequest,
+  A as resolveTimeout,
+  F as timeoutFetch,
+  a 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 g(r,e){return h(e)?e:e?r.replace(/\/?\/$/,"")+"/"+e.replace(/^\/+/,""):r}class F{constructor(e){this.baseURL=e}build(e,t,s){const c=g(this.baseURL,e);let i=this.interpolateUrl(c,t);if(s){const o=new URLSearchParams(s).toString();o&&(i+="?"+o)}return i}interpolateUrl(e,t){return t?e.replace(/{([^}]+)}/g,(s,c)=>{const i=t[c];if(i===void 0)throw new Error(`Missing required path parameter: ${c}`);return String(i)}):e}}function I(r,e){return typeof r<"u"?r:e}class a extends Error{constructor(e,t,s){const c=t.method||"GET",i=`Request timeout of ${s}ms exceeded for ${c} ${e}`;super(i),this.name="FetchTimeoutError",this.url=e,this.request=t,this.timeout=s,Object.setPrototypeOf(this,a.prototype)}}async function w(r,e,t){if(!t)return fetch(r,e);const s=new AbortController,c={...e,signal:s.signal};let i=null;const o=new Promise((T,b)=>{i=setTimeout(()=>{i&&clearTimeout(i);const _=new a(r,e,t);s.abort(_),b(_)},t)});try{return await Promise.race([fetch(r,c),o])}finally{i&&clearTimeout(i)}}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||{}),A=(r=>(r.METHOD="method",r.BODY="body",r))(A||{});const d="Content-Type";var l=(r=>(r.APPLICATION_JSON="application/json",r.TEXT_EVENT_STREAM="text/event-stream",r))(l||{});function f(r,e){return e?r.filter(e).sort((t,s)=>t.order-s.order):[...r].sort((t,s)=>t.order-s.order)}class R{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 c=s.headers;return c[d]||(c[d]=l.APPLICATION_JSON),e.request=s,e}}class O{constructor(){this.name="FetchInterceptor",this.order=Number.MAX_SAFE_INTEGER}async intercept(e){return e.response=await w(e.url,e.request,e.request.timeout),e}}class m{constructor(e=[]){this.sortedInterceptors=[],this.sortedInterceptors=f(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=f([...this.sortedInterceptors,e]),!0)}eject(e){const t=this.sortedInterceptors;return this.sortedInterceptors=f(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 P{constructor(){this.request=new m([new R,new O]),this.response=new m,this.error=new m}}const E={[d]:l.APPLICATION_JSON},p={baseURL:"",headers:E};class S{constructor(e=p){this.headers=E,this.urlBuilder=new F(e.baseURL),this.headers=e.headers??E,this.timeout=e.timeout,this.interceptors=e.interceptors??new P}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||{}},c={...t,headers:Object.keys(s).length>0?s:void 0,timeout:I(t.timeout,this.timeout)},i=this.urlBuilder.build(e,t.path,t.query);let o={fetcher:this,url:i,request:c,response:void 0,error:void 0,attributes:{}};try{return o=await this.interceptors.request.intercept(o),o=await this.interceptors.response.intercept(o),o}catch(T){if(o.error=T,o=await this.interceptors.error.intercept(o),o.response)return o;throw o.error}}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 N{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 U=new N;function L(r,e){if(Object.keys(r).length===0)return e;if(Object.keys(e).length===0)return r;const t={...r.path,...e.path},s={...r.query,...e.query},c={...r.headers,...e.headers},i=e.method??r.method,o=e.body??r.body,T=e.timeout??r.timeout,b=e.signal??r.signal;return{...r,...e,method:i,path:t,query:s,headers:c,body:o,timeout:T,signal:b}}class q extends S{constructor(e,t=p){super(t),this.name=e,U.register(e,this)}}const D=new q(y);n.ContentTypeHeader=d,n.ContentTypeValues=l,n.DEFAULT_FETCHER_NAME=y,n.DEFAULT_OPTIONS=p,n.FetchInterceptor=O,n.FetchTimeoutError=a,n.Fetcher=S,n.FetcherInterceptors=P,n.FetcherRegistrar=N,n.HttpMethod=u,n.InterceptorManager=m,n.NamedFetcher=q,n.RequestBodyInterceptor=R,n.RequestField=A,n.UrlBuilder=F,n.combineURLs=g,n.fetcher=D,n.fetcherRegistrar=U,n.isAbsoluteURL=h,n.mergeRequest=L,n.resolveTimeout=I,n.timeoutFetch=w,n.toSorted=f,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));
+(function(n,u){typeof exports=="object"&&typeof module<"u"?u(exports):typeof define=="function"&&define.amd?define(["exports"],u):(n=typeof globalThis<"u"?globalThis:n||self,u(n.Fetcher={}))})(this,(function(n){"use strict";function u(r){return/^([a-z][a-z\d+\-.]*:)?\/\//i.test(r)}function E(r,e){return u(e)?e:e?r.replace(/\/?\/$/,"")+"/"+e.replace(/^\/+/,""):r}class I{constructor(e){this.baseURL=e}build(e,t,s){const i=E(this.baseURL,e);let o=this.interpolateUrl(i,t);if(s){const a=new URLSearchParams(s).toString();a&&(o+="?"+a)}return o}interpolateUrl(e,t){return t?e.replace(/{([^}]+)}/g,(s,i)=>{const o=t[i];if(o===void 0)throw new Error(`Missing required path parameter: ${i}`);return String(o)}):e}}function F(r,e){return typeof r<"u"?r:e}class h extends Error{constructor(e,t,s){const i=t.method||"GET",o=`Request timeout of ${s}ms exceeded for ${i} ${e}`;super(o),this.name="FetchTimeoutError",this.url=e,this.request=t,this.timeout=s,Object.setPrototypeOf(this,h.prototype)}}async function R(r,e,t){if(!t)return fetch(r,e);const s=new AbortController,i={...e,signal:s.signal};let o=null;const a=new Promise((_,b)=>{o=setTimeout(()=>{o&&clearTimeout(o);const L=new h(r,e,t);s.abort(L),b(L)},t)});try{return await Promise.race([fetch(r,i),a])}finally{o&&clearTimeout(o)}}var c=(r=>(r.GET="GET",r.POST="POST",r.PUT="PUT",r.DELETE="DELETE",r.PATCH="PATCH",r.HEAD="HEAD",r.OPTIONS="OPTIONS",r))(c||{}),w=(r=>(r.METHOD="method",r.BODY="body",r))(w||{});const d="Content-Type";var l=(r=>(r.APPLICATION_JSON="application/json",r.TEXT_EVENT_STREAM="text/event-stream",r))(l||{});function m(r,e){return e?r.filter(e).sort((t,s)=>t.order-s.order):[...r].sort((t,s)=>t.order-s.order)}class A{constructor(){this.name="RequestBodyInterceptor",this.order=Number.MIN_SAFE_INTEGER+100}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[d]||(i[d]=l.APPLICATION_JSON),e.request=s,e}}class N{constructor(){this.name="FetchInterceptor",this.order=Number.MAX_SAFE_INTEGER}async intercept(e){return e.response=await R(e.url,e.request,e.request.timeout),e}}class O{constructor(){this.name="UrlResolveInterceptor",this.order=Number.MIN_SAFE_INTEGER}intercept(e){return e.url=e.fetcher.urlBuilder.build(e.url,e.request.path,e.request.query),e}}class f{constructor(e=[]){this.sortedInterceptors=[],this.sortedInterceptors=m(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=m([...this.sortedInterceptors,e]),!0)}eject(e){const t=this.sortedInterceptors;return this.sortedInterceptors=m(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 S{constructor(){this.request=new f([new O,new A,new N]),this.response=new f,this.error=new f}}const T={[d]:l.APPLICATION_JSON},p={baseURL:"",headers:T};class g{constructor(e=p){this.headers=T,this.urlBuilder=new I(e.baseURL),this.headers=e.headers??T,this.timeout=e.timeout,this.interceptors=e.interceptors??new S}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,timeout:F(t.timeout,this.timeout)},o={fetcher:this,url:e,request:i,response:void 0,error:void 0,attributes:{}};return this.exchange(o)}async exchange(e){try{return e=await this.interceptors.request.intercept(e),e=await this.interceptors.response.intercept(e),e}catch(t){if(e.error=t,e=await this.interceptors.error.intercept(e),e.response)return e;throw e.error}}async methodFetch(e,t,s={}){return this.fetch(t,{...s,method:e})}async get(e,t={}){return this.methodFetch(c.GET,e,t)}async post(e,t={}){return this.methodFetch(c.POST,e,t)}async put(e,t={}){return this.methodFetch(c.PUT,e,t)}async delete(e,t={}){return this.methodFetch(c.DELETE,e,t)}async patch(e,t={}){return this.methodFetch(c.PATCH,e,t)}async head(e,t={}){return this.methodFetch(c.HEAD,e,t)}async options(e,t={}){return this.methodFetch(c.OPTIONS,e,t)}}const y="default";class P{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 q=new P;function D(r,e){if(Object.keys(r).length===0)return e;if(Object.keys(e).length===0)return r;const t={...r.path,...e.path},s={...r.query,...e.query},i={...r.headers,...e.headers},o=e.method??r.method,a=e.body??r.body,_=e.timeout??r.timeout,b=e.signal??r.signal;return{...r,...e,method:o,path:t,query:s,headers:i,body:a,timeout:_,signal:b}}class U extends g{constructor(e,t=p){super(t),this.name=e,q.register(e,this)}}const v=new U(y);n.ContentTypeHeader=d,n.ContentTypeValues=l,n.DEFAULT_FETCHER_NAME=y,n.DEFAULT_OPTIONS=p,n.FetchInterceptor=N,n.FetchTimeoutError=h,n.Fetcher=g,n.FetcherInterceptors=S,n.FetcherRegistrar=P,n.HttpMethod=c,n.InterceptorManager=f,n.NamedFetcher=U,n.RequestBodyInterceptor=A,n.RequestField=w,n.UrlBuilder=I,n.UrlResolveInterceptor=O,n.combineURLs=E,n.fetcher=v,n.fetcherRegistrar=q,n.isAbsoluteURL=u,n.mergeRequest=D,n.resolveTimeout=F,n.timeoutFetch=R,n.toSorted=m,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));