@ahoo-wang/fetcher 0.9.5 → 0.9.9

package/dist/fetchExchange.d.ts

@@ -86,5 +86,16 @@ export declare class FetchExchange {
      * @returns true if a response is present, false otherwise
      */
     hasResponse(): boolean;
+    /**
+     * Gets the required response object, throwing an error if no response is available.
+     *
+     * This getter ensures that a response object is available, and throws an ExchangeError
+     * with details about the request if no response was received. This is useful for
+     * guaranteeing that downstream code always has a valid Response object to work with.
+     *
+     * @throws {ExchangeError} If no response is available for the current exchange
+     * @returns The Response object for this exchange
+     */
+    get requiredResponse(): Response;
 }
 //# sourceMappingURL=fetchExchange.d.ts.map

package/dist/fetchExchange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetchExchange.d.ts","sourceRoot":"","sources":["../src/fetchExchange.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,SAAS,CAAC;IAE/B;;;;;;;;;;;;;OAaG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM;gBAGnC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,YAAY,EACrB,QAAQ,CAAC,EAAE,QAAQ,EACnB,KAAK,CAAC,EAAE,KAAK,GAAG,GAAG;IAQrB;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,WAAW,IAAI,OAAO;CAGvB"}
+{"version":3,"file":"fetchExchange.d.ts","sourceRoot":"","sources":["../src/fetchExchange.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,SAAS,CAAC;IAE/B;;;;;;;;;;;;;OAaG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM;gBAGnC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,YAAY,EACrB,QAAQ,CAAC,EAAE,QAAQ,EACnB,KAAK,CAAC,EAAE,KAAK,GAAG,GAAG;IAQrB;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;;OASG;IACH,IAAI,gBAAgB,IAAI,QAAQ,CAQ/B;CACF"}

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;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,cACf,SAAQ,cAAc,EACpB,qBAAqB,EACrB,cAAc;IAChB,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAMD,eAAO,MAAM,eAAe,EAAE,cAG7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,OACX,YAAW,iBAAiB,EAAE,qBAAqB,EAAE,cAAc;IAEnE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAmB;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAE1C;;;;;;;OAOG;gBACS,OAAO,GAAE,cAAgC;IAOrD;;;;;;;;;;OAUG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa3E;;;;;;;;;;OAUG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAa5D;;;;;;;;;;OAUG;YACW,WAAW;IAWzB;;;;;;;;;OASG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;OAQG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;;OASG;IACG,IAAI,CACR,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;;;;OASG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAM,GACtD,OAAO,CAAC,QAAQ,CAAC;CAGrB"}
+{"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"}

package/dist/fetcherError.d.ts

@@ -1,4 +1,3 @@
-import { FetchExchange } from './fetchExchange';
 /**
  * Base error class for all Fetcher-related errors.
  *
@@ -30,33 +29,4 @@ export declare class FetcherError extends Error {
      */
     constructor(errorMsg?: string, cause?: (Error | any) | undefined);
 }
-/**
- * Custom error class for Fetcher request failures.
- *
- * This error is thrown when a fetch request fails and no response is generated.
- * It wraps the FetchExchange object to provide comprehensive information about the failed request.
- *
- * @example
- * ```typescript
- * try {
- *   await fetcher.get('/api/users');
- * } catch (error) {
- *   if (error instanceof FetchError) {
- *     console.log('Failed URL:', error.exchange.request.url);
- *     console.log('Request headers:', error.exchange.request.headers);
- *     console.log('Interceptor attributes:', error.exchange.attributes);
- *   }
- * }
- * ```
- */
-export declare class FetchError extends FetcherError {
-    readonly exchange: FetchExchange;
-    /**
-     * Creates a new FetchError instance.
-     *
-     * @param exchange - The FetchExchange object containing request/response/error information.
-     * @param errorMsg - Optional custom error message. If not provided, will use the exchange's error message.
-     */
-    constructor(exchange: FetchExchange, errorMsg?: string);
-}
 //# sourceMappingURL=fetcherError.d.ts.map

package/dist/fetcherError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcherError.d.ts","sourceRoot":"","sources":["../src/fetcherError.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAa,SAAQ,KAAK;aASnB,KAAK,CAAC,GAAE,KAAK,GAAG,GAAG;IARrC;;;;;OAKG;gBAED,QAAQ,CAAC,EAAE,MAAM,EACD,KAAK,CAAC,GAAE,KAAK,GAAG,GAAG,aAAA;CAetC;AAGD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAW,SAAQ,YAAY;aAQxB,QAAQ,EAAE,aAAa;IAPzC;;;;;OAKG;gBAEe,QAAQ,EAAE,aAAa,EACvC,QAAQ,CAAC,EAAE,MAAM;CAUpB"}
+{"version":3,"file":"fetcherError.d.ts","sourceRoot":"","sources":["../src/fetcherError.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAa,SAAQ,KAAK;aASnB,KAAK,CAAC,GAAE,KAAK,GAAG,GAAG;IARrC;;;;;OAKG;gBAED,QAAQ,CAAC,EAAE,MAAM,EACD,KAAK,CAAC,GAAE,KAAK,GAAG,GAAG,aAAA;CAetC"}

package/dist/index.es.js

@@ -1,10 +1,10 @@
-function b(r) {
+function g(r) {
   return /^([a-z][a-z\d+\-.]*:)?\/\//i.test(r);
 }
-function g(r, t) {
-  return b(t) ? t : t ? r.replace(/\/?\/$/, "") + "/" + t.replace(/^\/+/, "") : r;
+function P(r, e) {
+  return g(e) ? e : e ? r.replace(/\/?\/$/, "") + "/" + e.replace(/^\/+/, "") : r;
 }
-class w {
+class b {
   /**
    * Initializes a new UrlBuilder instance.
    *
@@ -15,8 +15,8 @@ class w {
    * const urlBuilder = new UrlBuilder('https://api.example.com');
    * ```
    */
-  constructor(t) {
-    this.baseURL = t;
+  constructor(e) {
+    this.baseURL = e;
   }
   /**
    * Builds a complete URL, including path parameter replacement and query parameter addition.
@@ -36,8 +36,8 @@ class w {
    * // Result: https://api.example.com/users/123/posts/456?filter=active&limit=10
    * ```
    */
-  build(t, e) {
-    const s = e?.path, o = e?.query, i = g(this.baseURL, t);
+  build(e, t) {
+    const s = t?.path, o = t?.query, i = P(this.baseURL, e);
     let n = this.interpolateUrl(i, s);
     if (o) {
       const u = new URLSearchParams(o).toString();
@@ -54,8 +54,8 @@ class w {
    * @param request - The FetchRequest containing URL and URL parameters
    * @returns Complete resolved URL string
    */
-  resolveRequestUrl(t) {
-    return this.build(t.url, t.urlParams);
+  resolveRequestUrl(e) {
+    return this.build(e.url, e.urlParams);
   }
   /**
    * Replaces placeholders in the URL with path parameters.
@@ -84,13 +84,13 @@ class w {
    * }
    * ```
    */
-  interpolateUrl(t, e) {
-    return e ? t.replace(/{([^}]+)}/g, (s, o) => {
-      const i = e[o];
+  interpolateUrl(e, t) {
+    return t ? e.replace(/{([^}]+)}/g, (s, o) => {
+      const i = t[o];
       if (i === void 0)
         throw new Error(`Missing required path parameter: ${o}`);
       return String(i);
-    }) : t;
+    }) : e;
   }
 }
 class a extends Error {
@@ -100,21 +100,9 @@ class a extends Error {
    * @param errorMsg - Optional error message. If not provided, will use the cause's message or a default message.
    * @param cause - Optional underlying error that caused this error.
    */
-  constructor(t, e) {
-    const s = t || e?.message || "An error occurred in the fetcher";
-    super(s), this.cause = e, this.name = "FetcherError", e?.stack && (this.stack = e.stack), Object.setPrototypeOf(this, a.prototype);
-  }
-}
-class m extends a {
-  /**
-   * Creates a new FetchError instance.
-   *
-   * @param exchange - The FetchExchange object containing request/response/error information.
-   * @param errorMsg - Optional custom error message. If not provided, will use the exchange's error message.
-   */
-  constructor(t, e) {
-    const s = e || t.error?.message || `Request to ${t.request.url} failed with no response`;
-    super(s, t.error), this.exchange = t, this.name = "FetchError", Object.setPrototypeOf(this, m.prototype);
+  constructor(e, t) {
+    const s = e || t?.message || "An error occurred in the fetcher";
+    super(s), this.cause = t, this.name = "FetcherError", t?.stack && (this.stack = t.stack), Object.setPrototypeOf(this, a.prototype);
   }
 }
 class T extends a {
@@ -123,83 +111,58 @@ class T extends a {
    *
    * @param request - The request options that timed out
    */
-  constructor(t) {
-    const e = t.method || "GET", s = `Request timeout of ${t.timeout}ms exceeded for ${e} ${t.url}`;
-    super(s), this.name = "FetchTimeoutError", this.request = t, Object.setPrototypeOf(this, T.prototype);
+  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);
   }
 }
-function S(r, t) {
-  return typeof r < "u" ? r : t;
+function S(r, e) {
+  return typeof r < "u" ? r : e;
 }
 async function _(r) {
-  const t = r.url, e = r.timeout, s = r;
-  if (!e)
-    return fetch(t, s);
+  const e = r.url, t = r.timeout, s = r;
+  if (!t)
+    return fetch(e, s);
   const o = new AbortController(), i = {
     ...s,
     signal: o.signal
   };
   let n = null;
-  const u = new Promise((z, P) => {
+  const u = new Promise((X, A) => {
     n = setTimeout(() => {
       n && clearTimeout(n);
-      const I = new T(r);
-      o.abort(I), P(I);
-    }, e);
+      const y = new T(r);
+      o.abort(y), A(y);
+    }, t);
   });
   try {
-    return await Promise.race([fetch(t, i), u]);
+    return await Promise.race([fetch(e, i), u]);
   } finally {
     n && clearTimeout(n);
   }
 }
+const w = "UrlResolveInterceptor", I = Number.MIN_SAFE_INTEGER + 1e3;
 class N {
-  constructor(t, e, s, o) {
-    this.attributes = {}, this.fetcher = t, this.request = e, this.response = s, this.error = o;
-  }
-  /**
-   * Checks if the exchange has an error.
-   *
-   * @returns true if an error is present, false otherwise
-   */
-  hasError() {
-    return !!this.error;
-  }
-  /**
-   * Checks if the exchange has a response.
-   *
-   * @returns true if a response is present, false otherwise
-   */
-  hasResponse() {
-    return !!this.response;
-  }
-}
-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 Q = "Content-Type";
-var f = /* @__PURE__ */ ((r) => (r.APPLICATION_JSON = "application/json", r.TEXT_EVENT_STREAM = "text/event-stream", r))(f || {});
-function l(r, t) {
-  if (!(r === void 0 && t === void 0))
-    return t === void 0 ? r : r === void 0 ? t : { ...r, ...t };
-}
-const F = "UrlResolveInterceptor", O = Number.MIN_SAFE_INTEGER + 1e3;
-class q {
   constructor() {
-    this.name = F, this.order = O;
+    this.name = w, this.order = I;
   }
   /**
    * Resolves the final URL by combining the base URL, path parameters, and query parameters.
    *
    * @param exchange - The fetch exchange containing the request information
    */
-  intercept(t) {
-    const e = t.request;
-    e.url = t.fetcher.urlBuilder.resolveRequestUrl(e);
+  intercept(e) {
+    const t = e.request;
+    t.url = e.fetcher.urlBuilder.resolveRequestUrl(t);
   }
 }
-const U = "RequestBodyInterceptor", C = O + 1e3;
-class L {
+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 || {});
+const F = "RequestBodyInterceptor", q = I + 1e3;
+class U {
   constructor() {
-    this.name = U, this.order = C;
+    this.name = F, this.order = q;
   }
   /**
    * Attempts to convert request body to a valid fetch API body type.
@@ -238,21 +201,21 @@ class L {
    * // exchange.request.body will be '{"name":"John","age":30}'
    * // exchange.request.headers will include 'Content-Type: application/json'
    */
-  intercept(t) {
-    const e = t.request;
-    if (e.body === void 0 || e.body === null || typeof e.body != "object" || e.body instanceof ArrayBuffer || ArrayBuffer.isView(e.body) || // Includes TypedArray and DataView
-    e.body instanceof Blob || e.body instanceof File || e.body instanceof URLSearchParams || e.body instanceof FormData || e.body instanceof ReadableStream)
+  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) || // Includes TypedArray and DataView
+    t.body instanceof Blob || t.body instanceof File || t.body instanceof URLSearchParams || t.body instanceof FormData || t.body instanceof ReadableStream)
       return;
-    const s = { ...e };
-    s.body = JSON.stringify(e.body), s.headers || (s.headers = {});
+    const s = { ...t };
+    s.body = JSON.stringify(t.body), s.headers || (s.headers = {});
     const o = s.headers;
-    o["Content-Type"] || (o["Content-Type"] = f.APPLICATION_JSON), t.request = s;
+    o["Content-Type"] || (o["Content-Type"] = R.APPLICATION_JSON), e.request = s;
   }
 }
-const D = "FetchInterceptor", v = Number.MAX_SAFE_INTEGER - 1e3;
-class M {
+const C = "FetchInterceptor", L = Number.MAX_SAFE_INTEGER - 1e3;
+class D {
   constructor() {
-    this.name = D, this.order = v;
+    this.name = C, this.order = L;
   }
   /**
    * Intercept and process HTTP requests.
@@ -279,14 +242,14 @@ class M {
    * await fetchInterceptor.intercept(exchange);
    * console.log(exchange.response); // HTTP response object
    */
-  async intercept(t) {
-    t.response = await _(t.request);
+  async intercept(e) {
+    e.response = await _(e.request);
   }
 }
-function h(r, t) {
-  return t ? r.filter(t).sort((e, s) => e.order - s.order) : [...r].sort((e, s) => e.order - s.order);
+function d(r, e) {
+  return e ? r.filter(e).sort((t, s) => t.order - s.order) : [...r].sort((t, s) => t.order - s.order);
 }
-class d {
+class l {
   /**
    * Initializes a new InterceptorRegistry instance.
    *
@@ -296,8 +259,8 @@ class d {
    * The provided interceptors will be sorted by their order property immediately
    * upon construction.
    */
-  constructor(t = []) {
-    this.sortedInterceptors = [], this.sortedInterceptors = h(t);
+  constructor(e = []) {
+    this.sortedInterceptors = [], this.sortedInterceptors = d(e);
   }
   /**
    * Gets the name of this interceptor registry.
@@ -334,10 +297,10 @@ class d {
    *
    * After adding, interceptors are automatically sorted by their order property.
    */
-  use(t) {
-    return this.sortedInterceptors.some((e) => e.name === t.name) ? !1 : (this.sortedInterceptors = h([
+  use(e) {
+    return this.sortedInterceptors.some((t) => t.name === e.name) ? !1 : (this.sortedInterceptors = d([
       ...this.sortedInterceptors,
-      t
+      e
     ]), !0);
   }
   /**
@@ -347,12 +310,12 @@ class d {
    * @returns True if an interceptor was removed, false if no interceptor with the
    *          given name was found
    */
-  eject(t) {
-    const e = this.sortedInterceptors;
-    return this.sortedInterceptors = h(
-      e,
-      (s) => s.name !== t
-    ), e.length !== this.sortedInterceptors.length;
+  eject(e) {
+    const t = this.sortedInterceptors;
+    return this.sortedInterceptors = d(
+      t,
+      (s) => s.name !== e
+    ), t.length !== this.sortedInterceptors.length;
   }
   /**
    * Removes all interceptors from this registry.
@@ -374,27 +337,27 @@ class d {
    * If any interceptor throws an error, the execution chain is broken and the error
    * is propagated to the caller.
    */
-  async intercept(t) {
-    for (const e of this.sortedInterceptors)
-      await e.intercept(t);
+  async intercept(e) {
+    for (const t of this.sortedInterceptors)
+      await t.intercept(e);
   }
 }
-class R extends a {
-  constructor(t) {
+class f extends a {
+  constructor(e) {
     super(
-      `Request failed with status code ${t.response?.status} for ${t.request.url}`
-    ), this.exchange = t, this.name = "HttpStatusValidationError", Object.setPrototypeOf(this, R.prototype);
+      `Request failed with status code ${e.response?.status} for ${e.request.url}`
+    ), this.exchange = e, this.name = "HttpStatusValidationError", Object.setPrototypeOf(this, f.prototype);
   }
 }
-const $ = (r) => r >= 200 && r < 300, j = "ValidateStatusInterceptor", B = Number.MAX_SAFE_INTEGER - 1e3;
-class G {
+const v = (r) => r >= 200 && r < 300, B = "ValidateStatusInterceptor", G = Number.MAX_SAFE_INTEGER - 1e3;
+class M {
   /**
    * Creates a new ValidateStatusInterceptor instance.
    *
    * @param validateStatus - Function that determines if a status code is valid
    */
-  constructor(t = $) {
-    this.validateStatus = t;
+  constructor(e = v) {
+    this.validateStatus = e;
   }
   /**
    * Gets the name of this interceptor.
@@ -402,7 +365,7 @@ class G {
    * @returns The name of this interceptor
    */
   get name() {
-    return j;
+    return B;
   }
   /**
    * Gets the order of this interceptor.
@@ -410,7 +373,7 @@ class G {
    * @returns VALIDATE_STATUS_INTERCEPTOR_ORDER, indicating this interceptor should execute early
    */
   get order() {
-    return B;
+    return G;
   }
   /**
    * Validates the response status code.
@@ -425,34 +388,35 @@ class G {
    * preventing other response handlers from attempting to process them. Valid responses
    * proceed through the rest of the response interceptor chain normally.
    */
-  intercept(t) {
-    if (!t.response)
+  intercept(e) {
+    if (!e.response)
       return;
-    const e = t.response.status;
-    if (!this.validateStatus(e))
-      throw new R(t);
+    const t = e.response.status;
+    if (!this.validateStatus(t))
+      throw new f(e);
   }
 }
-class y extends a {
+class h extends a {
   /**
    * Creates a new ExchangeError instance.
    *
    * @param exchange - The FetchExchange object containing request/response/error information.
+   * @param errorMsg - An optional error message.
    */
-  constructor(t) {
-    const e = t.error?.message || t.response?.statusText || `Request to ${t.request.url} failed during exchange`;
-    super(e, t.error), this.exchange = t, this.name = "ExchangeError", Object.setPrototypeOf(this, y.prototype);
+  constructor(e, t) {
+    const s = t || e.error?.message || e.response?.statusText || `Request to ${e.request.url} failed during exchange`;
+    super(s, e.error), this.exchange = e, this.name = "ExchangeError", Object.setPrototypeOf(this, h.prototype);
   }
 }
-class V {
+class $ {
   constructor() {
-    this.request = new d([
-      new q(),
-      new L(),
+    this.request = new l([
+      new N(),
+      new U(),
+      new D()
+    ]), this.response = new l([
       new M()
-    ]), this.response = new d([
-      new G()
-    ]), this.error = new d();
+    ]), this.error = new l();
   }
   /**
    * Processes a FetchExchange through the interceptor pipeline.
@@ -540,23 +504,66 @@ class V {
    * const result = await fetcher.exchange(exchange);
    * ```
    */
-  async exchange(t) {
+  async exchange(e) {
     try {
-      return await this.request.intercept(t), await this.response.intercept(t), t;
-    } catch (e) {
-      if (t.error = e, await this.error.intercept(t), !t.hasError())
-        return t;
-      throw new y(t);
+      return await this.request.intercept(e), await this.response.intercept(e), e;
+    } catch (t) {
+      if (e.error = t, await this.error.intercept(e), !e.hasError())
+        return e;
+      throw new h(e);
     }
   }
 }
-const p = {
-  "Content-Type": f.APPLICATION_JSON
-}, A = {
+class j {
+  constructor(e, t, s, o) {
+    this.attributes = {}, this.fetcher = e, this.request = t, this.response = s, this.error = o;
+  }
+  /**
+   * Checks if the exchange has an error.
+   *
+   * @returns true if an error is present, false otherwise
+   */
+  hasError() {
+    return !!this.error;
+  }
+  /**
+   * Checks if the exchange has a response.
+   *
+   * @returns true if a response is present, false otherwise
+   */
+  hasResponse() {
+    return !!this.response;
+  }
+  /**
+   * Gets the required response object, throwing an error if no response is available.
+   *
+   * This getter ensures that a response object is available, and throws an ExchangeError
+   * with details about the request if no response was received. This is useful for
+   * guaranteeing that downstream code always has a valid Response object to work with.
+   *
+   * @throws {ExchangeError} If no response is available for the current exchange
+   * @returns The Response object for this exchange
+   */
+  get requiredResponse() {
+    if (!this.response)
+      throw new h(
+        this,
+        `Request to ${this.request.url} failed with no response`
+      );
+    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
+}, O = {
   baseURL: "",
-  headers: p
+  headers: E
 };
-class H {
+class V {
   /**
    * Initializes a new Fetcher instance with optional configuration.
    *
@@ -565,8 +572,8 @@ class H {
    *
    * @param options - Configuration options for the Fetcher instance
    */
-  constructor(t = A) {
-    this.headers = p, this.urlBuilder = new w(t.baseURL), this.headers = t.headers ?? p, this.timeout = t.timeout, this.interceptors = t.interceptors ?? new V();
+  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 $();
   }
   /**
    * Executes an HTTP request with the specified URL and options.
@@ -579,16 +586,9 @@ class H {
    * @returns Promise that resolves to the HTTP response
    * @throws FetchError if the request fails and no response is generated
    */
-  async fetch(t, e = {}) {
-    const s = e;
-    s.url = t;
-    const o = await this.request(s);
-    if (!o.response)
-      throw new m(
-        o,
-        `Request to ${s.url} failed with no response`
-      );
-    return o.response;
+  async fetch(e, t = {}) {
+    const s = t;
+    return s.url = e, (await this.request(s)).requiredResponse;
   }
   /**
    * Processes an HTTP request through the Fetcher's internal workflow.
@@ -601,12 +601,12 @@ class H {
    * @returns Promise that resolves to a FetchExchange containing request/response data
    * @throws Error if an unhandled error occurs during request processing
    */
-  async request(t) {
-    const e = l(t.headers, this.headers), s = {
-      ...t,
-      headers: e,
-      timeout: S(t.timeout, this.timeout)
-    }, o = new N(this, s);
+  async request(e) {
+    const t = p(e.headers, this.headers), s = {
+      ...e,
+      headers: t,
+      timeout: S(e.timeout, this.timeout)
+    }, o = new j(this, s);
     return this.interceptors.exchange(o);
   }
   /**
@@ -620,10 +620,10 @@ class H {
    * @param request - Additional request options
    * @returns Promise that resolves to the HTTP response
    */
-  async methodFetch(t, e, s = {}) {
-    return this.fetch(e, {
+  async methodFetch(e, t, s = {}) {
+    return this.fetch(t, {
       ...s,
-      method: t
+      method: e
     });
   }
   /**
@@ -636,8 +636,8 @@ class H {
    * @param request - Request options excluding method and body
    * @returns Promise that resolves to the HTTP response
    */
-  async get(t, e = {}) {
-    return this.methodFetch(c.GET, t, e);
+  async get(e, t = {}) {
+    return this.methodFetch(c.GET, e, t);
   }
   /**
    * Makes a POST HTTP request.
@@ -648,8 +648,8 @@ class H {
    * @param request - Request options including body and other parameters
    * @returns Promise that resolves to the HTTP response
    */
-  async post(t, e = {}) {
-    return this.methodFetch(c.POST, t, e);
+  async post(e, t = {}) {
+    return this.methodFetch(c.POST, e, t);
   }
   /**
    * Makes a PUT HTTP request.
@@ -660,8 +660,8 @@ class H {
    * @param request - Request options including body and other parameters
    * @returns Promise that resolves to the HTTP response
    */
-  async put(t, e = {}) {
-    return this.methodFetch(c.PUT, t, e);
+  async put(e, t = {}) {
+    return this.methodFetch(c.PUT, e, t);
   }
   /**
    * Makes a DELETE HTTP request.
@@ -672,8 +672,8 @@ class H {
    * @param request - Request options excluding method and body
    * @returns Promise that resolves to the HTTP response
    */
-  async delete(t, e = {}) {
-    return this.methodFetch(c.DELETE, t, e);
+  async delete(e, t = {}) {
+    return this.methodFetch(c.DELETE, e, t);
   }
   /**
    * Makes a PATCH HTTP request.
@@ -684,8 +684,8 @@ class H {
    * @param request - Request options including body and other parameters
    * @returns Promise that resolves to the HTTP response
    */
-  async patch(t, e = {}) {
-    return this.methodFetch(c.PATCH, t, e);
+  async patch(e, t = {}) {
+    return this.methodFetch(c.PATCH, e, t);
   }
   /**
    * Makes a HEAD HTTP request.
@@ -697,8 +697,8 @@ class H {
    * @param request - Request options excluding method and body
    * @returns Promise that resolves to the HTTP response
    */
-  async head(t, e = {}) {
-    return this.methodFetch(c.HEAD, t, e);
+  async head(e, t = {}) {
+    return this.methodFetch(c.HEAD, e, t);
   }
   /**
    * Makes an OPTIONS HTTP request.
@@ -710,12 +710,12 @@ class H {
    * @param request - Request options excluding method and body
    * @returns Promise that resolves to the HTTP response
    */
-  async options(t, e = {}) {
-    return this.methodFetch(c.OPTIONS, t, e);
+  async options(e, t = {}) {
+    return this.methodFetch(c.OPTIONS, e, t);
   }
 }
-const E = "default";
-class k {
+const m = "default";
+class H {
   constructor() {
     this.registrar = /* @__PURE__ */ new Map();
   }
@@ -728,8 +728,8 @@ class k {
    * const fetcher = new Fetcher({ baseURL: 'https://api.example.com' });
    * fetcherRegistrar.register('api', fetcher);
    */
-  register(t, e) {
-    this.registrar.set(t, e);
+  register(e, t) {
+    this.registrar.set(e, t);
   }
   /**
    * Unregister a Fetcher instance by name
@@ -742,8 +742,8 @@ class k {
    *   console.log('Fetcher unregistered successfully');
    * }
    */
-  unregister(t) {
-    return this.registrar.delete(t);
+  unregister(e) {
+    return this.registrar.delete(e);
   }
   /**
    * Get a Fetcher instance by name
@@ -756,8 +756,8 @@ class k {
    *   // Use the fetcher
    * }
    */
-  get(t) {
-    return this.registrar.get(t);
+  get(e) {
+    return this.registrar.get(e);
   }
   /**
    * Get a Fetcher instance by name, throwing an error if not found
@@ -773,11 +773,11 @@ class k {
    *   console.error('Fetcher not found:', error.message);
    * }
    */
-  requiredGet(t) {
-    const e = this.get(t);
-    if (!e)
-      throw new Error(`Fetcher ${t} not found`);
-    return e;
+  requiredGet(e) {
+    const t = this.get(e);
+    if (!t)
+      throw new Error(`Fetcher ${e} not found`);
+    return t;
   }
   /**
    * Get the default Fetcher instance
@@ -788,7 +788,7 @@ class k {
    * const defaultFetcher = fetcherRegistrar.default;
    */
   get default() {
-    return this.requiredGet(E);
+    return this.requiredGet(m);
   }
   /**
    * Set the default Fetcher instance
@@ -798,8 +798,8 @@ class k {
    * const fetcher = new Fetcher({ baseURL: 'https://api.example.com' });
    * fetcherRegistrar.default = fetcher;
    */
-  set default(t) {
-    this.register(E, t);
+  set default(e) {
+    this.register(m, e);
   }
   /**
    * Get a copy of all registered fetchers
@@ -815,31 +815,31 @@ class k {
     return new Map(this.registrar);
   }
 }
-const J = new k();
-function Y(r, t) {
+const k = new H();
+function Q(r, e) {
   if (Object.keys(r).length === 0)
-    return t;
-  if (Object.keys(t).length === 0)
+    return e;
+  if (Object.keys(e).length === 0)
     return r;
-  const e = {
-    path: l(r.urlParams?.path, t.urlParams?.path),
-    query: l(r.urlParams?.query, t.urlParams?.query)
+  const t = {
+    path: p(r.urlParams?.path, e.urlParams?.path),
+    query: p(r.urlParams?.query, e.urlParams?.query)
   }, s = {
     ...r.headers,
-    ...t.headers
-  }, o = t.method ?? r.method, i = t.body ?? r.body, n = t.timeout ?? r.timeout, u = t.signal ?? r.signal;
+    ...e.headers
+  }, o = e.method ?? r.method, i = e.body ?? r.body, n = e.timeout ?? r.timeout, u = e.signal ?? r.signal;
   return {
     ...r,
-    ...t,
+    ...e,
     method: o,
-    urlParams: e,
+    urlParams: t,
     headers: s,
     body: i,
     timeout: n,
     signal: u
   };
 }
-class X extends H {
+class J extends V {
   /**
    * Create a NamedFetcher instance and automatically register it with the global fetcherRegistrar
    *
@@ -857,48 +857,47 @@ class X extends H {
    *   headers: { 'Authorization': 'Bearer token' }
    * });
    */
-  constructor(t, e = A) {
-    super(e), this.name = t, J.register(t, this);
+  constructor(e, t = O) {
+    super(t), this.name = e, k.register(e, this);
   }
 }
-const K = new X(E);
+const Y = new J(m);
 export {
-  Q as ContentTypeHeader,
-  f as ContentTypeValues,
-  E as DEFAULT_FETCHER_NAME,
-  A as DEFAULT_OPTIONS,
-  y as ExchangeError,
-  D as FETCH_INTERCEPTOR_NAME,
-  v as FETCH_INTERCEPTOR_ORDER,
-  m as FetchError,
-  N as FetchExchange,
-  M as FetchInterceptor,
+  z as ContentTypeHeader,
+  R as ContentTypeValues,
+  m 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,
-  H as Fetcher,
+  V as Fetcher,
   a as FetcherError,
-  k as FetcherRegistrar,
+  H as FetcherRegistrar,
   c as HttpMethod,
-  R as HttpStatusValidationError,
-  V as InterceptorManager,
-  d as InterceptorRegistry,
-  X as NamedFetcher,
-  U as REQUEST_BODY_INTERCEPTOR_NAME,
-  C as REQUEST_BODY_INTERCEPTOR_ORDER,
-  L as RequestBodyInterceptor,
-  F as URL_RESOLVE_INTERCEPTOR_NAME,
-  O as URL_RESOLVE_INTERCEPTOR_ORDER,
-  w as UrlBuilder,
-  q as UrlResolveInterceptor,
-  j as VALIDATE_STATUS_INTERCEPTOR_NAME,
-  B as VALIDATE_STATUS_INTERCEPTOR_ORDER,
-  G as ValidateStatusInterceptor,
-  g as combineURLs,
-  K as fetcher,
-  J as fetcherRegistrar,
-  b as isAbsoluteURL,
-  l as mergeRecords,
-  Y as mergeRequest,
+  f as HttpStatusValidationError,
+  $ as InterceptorManager,
+  l as InterceptorRegistry,
+  J as NamedFetcher,
+  F as REQUEST_BODY_INTERCEPTOR_NAME,
+  q as REQUEST_BODY_INTERCEPTOR_ORDER,
+  U as RequestBodyInterceptor,
+  w as URL_RESOLVE_INTERCEPTOR_NAME,
+  I as URL_RESOLVE_INTERCEPTOR_ORDER,
+  b as UrlBuilder,
+  N as UrlResolveInterceptor,
+  B as VALIDATE_STATUS_INTERCEPTOR_NAME,
+  G as VALIDATE_STATUS_INTERCEPTOR_ORDER,
+  M as ValidateStatusInterceptor,
+  P as combineURLs,
+  Y as fetcher,
+  k as fetcherRegistrar,
+  g as isAbsoluteURL,
+  p as mergeRecords,
+  Q as mergeRequest,
   S as resolveTimeout,
   _ as timeoutFetch,
-  h as toSorted
+  d as toSorted
 };

package/dist/index.umd.js

@@ -1 +1 @@
-(function(s,h){typeof exports=="object"&&typeof module<"u"?h(exports):typeof define=="function"&&define.amd?define(["exports"],h):(s=typeof globalThis<"u"?globalThis:s||self,h(s.Fetcher={}))})(this,(function(s){"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 S{constructor(e){this.baseURL=e}build(e,t){const n=t?.path,o=t?.query,u=P(this.baseURL,e);let i=this.interpolateUrl(u,n);if(o){const E=new URLSearchParams(o).toString();E&&(i+="?"+E)}return i}resolveRequestUrl(e){return this.build(e.url,e.urlParams)}interpolateUrl(e,t){return t?e.replace(/{([^}]+)}/g,(n,o)=>{const u=t[o];if(u===void 0)throw new Error(`Missing required path parameter: ${o}`);return String(u)}):e}}class a extends Error{constructor(e,t){const n=e||t?.message||"An error occurred in the fetcher";super(n),this.cause=t,this.name="FetcherError",t?.stack&&(this.stack=t.stack),Object.setPrototypeOf(this,a.prototype)}}class d extends a{constructor(e,t){const n=t||e.error?.message||`Request to ${e.request.url} failed with no response`;super(n,e.error),this.exchange=e,this.name="FetchError",Object.setPrototypeOf(this,d.prototype)}}class l extends a{constructor(e){const t=e.method||"GET",n=`Request timeout of ${e.timeout}ms exceeded for ${t} ${e.url}`;super(n),this.name="FetchTimeoutError",this.request=e,Object.setPrototypeOf(this,l.prototype)}}function N(r,e){return typeof r<"u"?r:e}async function g(r){const e=r.url,t=r.timeout,n=r;if(!t)return fetch(e,n);const o=new AbortController,u={...n,signal:o.signal};let i=null;const E=new Promise((W,K)=>{i=setTimeout(()=>{i&&clearTimeout(i);const J=new l(r);o.abort(J),K(J)},t)});try{return await Promise.race([fetch(e,u),E])}finally{i&&clearTimeout(i)}}class F{constructor(e,t,n,o){this.attributes={},this.fetcher=e,this.request=t,this.response=n,this.error=o}hasError(){return!!this.error}hasResponse(){return!!this.response}}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||{});const Q="Content-Type";var T=(r=>(r.APPLICATION_JSON="application/json",r.TEXT_EVENT_STREAM="text/event-stream",r))(T||{});function R(r,e){if(!(r===void 0&&e===void 0))return e===void 0?r:r===void 0?e:{...r,...e}}const b="UrlResolveInterceptor",O=Number.MIN_SAFE_INTEGER+1e3;class w{constructor(){this.name=b,this.order=O}intercept(e){const t=e.request;t.url=e.fetcher.urlBuilder.resolveRequestUrl(t)}}const U="RequestBodyInterceptor",C=O+1e3;class L{constructor(){this.name=U,this.order=C}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;const n={...t};n.body=JSON.stringify(t.body),n.headers||(n.headers={});const o=n.headers;o["Content-Type"]||(o["Content-Type"]=T.APPLICATION_JSON),e.request=n}}const q="FetchInterceptor",D=Number.MAX_SAFE_INTEGER-1e3;class M{constructor(){this.name=q,this.order=D}async intercept(e){e.response=await g(e.request)}}function m(r,e){return e?r.filter(e).sort((t,n)=>t.order-n.order):[...r].sort((t,n)=>t.order-n.order)}class f{constructor(e=[]){this.sortedInterceptors=[],this.sortedInterceptors=m(e)}get name(){return this.constructor.name}get order(){return Number.MIN_SAFE_INTEGER}get interceptors(){return[...this.sortedInterceptors]}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,n=>n.name!==e),t.length!==this.sortedInterceptors.length}clear(){this.sortedInterceptors=[]}async intercept(e){for(const t of this.sortedInterceptors)await t.intercept(e)}}class y 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,y.prototype)}}const Y=r=>r>=200&&r<300,v="ValidateStatusInterceptor",V=Number.MAX_SAFE_INTEGER-1e3;class B{constructor(e=Y){this.validateStatus=e}get name(){return v}get order(){return V}intercept(e){if(!e.response)return;const t=e.response.status;if(!this.validateStatus(t))throw new y(e)}}class I extends a{constructor(e){const t=e.error?.message||e.response?.statusText||`Request to ${e.request.url} failed during exchange`;super(t,e.error),this.exchange=e,this.name="ExchangeError",Object.setPrototypeOf(this,I.prototype)}}class H{constructor(){this.request=new f([new w,new L,new M]),this.response=new f([new B]),this.error=new f}async exchange(e){try{return await this.request.intercept(e),await this.response.intercept(e),e}catch(t){if(e.error=t,await this.error.intercept(e),!e.hasError())return e;throw new I(e)}}}const _={"Content-Type":T.APPLICATION_JSON},A={baseURL:"",headers:_};class j{constructor(e=A){this.headers=_,this.urlBuilder=new S(e.baseURL),this.headers=e.headers??_,this.timeout=e.timeout,this.interceptors=e.interceptors??new H}async fetch(e,t={}){const n=t;n.url=e;const o=await this.request(n);if(!o.response)throw new d(o,`Request to ${n.url} failed with no response`);return o.response}async request(e){const t=R(e.headers,this.headers),n={...e,headers:t,timeout:N(e.timeout,this.timeout)},o=new F(this,n);return this.interceptors.exchange(o)}async methodFetch(e,t,n={}){return this.fetch(t,{...n,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 p="default";class ${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 G=new $;function X(r,e){if(Object.keys(r).length===0)return e;if(Object.keys(e).length===0)return r;const t={path:R(r.urlParams?.path,e.urlParams?.path),query:R(r.urlParams?.query,e.urlParams?.query)},n={...r.headers,...e.headers},o=e.method??r.method,u=e.body??r.body,i=e.timeout??r.timeout,E=e.signal??r.signal;return{...r,...e,method:o,urlParams:t,headers:n,body:u,timeout:i,signal:E}}class k extends j{constructor(e,t=A){super(t),this.name=e,G.register(e,this)}}const z=new k(p);s.ContentTypeHeader=Q,s.ContentTypeValues=T,s.DEFAULT_FETCHER_NAME=p,s.DEFAULT_OPTIONS=A,s.ExchangeError=I,s.FETCH_INTERCEPTOR_NAME=q,s.FETCH_INTERCEPTOR_ORDER=D,s.FetchError=d,s.FetchExchange=F,s.FetchInterceptor=M,s.FetchTimeoutError=l,s.Fetcher=j,s.FetcherError=a,s.FetcherRegistrar=$,s.HttpMethod=c,s.HttpStatusValidationError=y,s.InterceptorManager=H,s.InterceptorRegistry=f,s.NamedFetcher=k,s.REQUEST_BODY_INTERCEPTOR_NAME=U,s.REQUEST_BODY_INTERCEPTOR_ORDER=C,s.RequestBodyInterceptor=L,s.URL_RESOLVE_INTERCEPTOR_NAME=b,s.URL_RESOLVE_INTERCEPTOR_ORDER=O,s.UrlBuilder=S,s.UrlResolveInterceptor=w,s.VALIDATE_STATUS_INTERCEPTOR_NAME=v,s.VALIDATE_STATUS_INTERCEPTOR_ORDER=V,s.ValidateStatusInterceptor=B,s.combineURLs=P,s.fetcher=z,s.fetcherRegistrar=G,s.isAbsoluteURL=h,s.mergeRecords=R,s.mergeRequest=X,s.resolveTimeout=N,s.timeoutFetch=g,s.toSorted=m,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})}));
+(function(s,a){typeof exports=="object"&&typeof module<"u"?a(exports):typeof define=="function"&&define.amd?define(["exports"],a):(s=typeof globalThis<"u"?globalThis:s||self,a(s.Fetcher={}))})(this,(function(s){"use strict";function a(r){return/^([a-z][a-z\d+\-.]*:)?\/\//i.test(r)}function A(r,e){return a(e)?e:e?r.replace(/\/?\/$/,"")+"/"+e.replace(/^\/+/,""):r}class S{constructor(e){this.baseURL=e}build(e,t){const n=t?.path,o=t?.query,u=A(this.baseURL,e);let i=this.interpolateUrl(u,n);if(o){const E=new URLSearchParams(o).toString();E&&(i+="?"+E)}return i}resolveRequestUrl(e){return this.build(e.url,e.urlParams)}interpolateUrl(e,t){return t?e.replace(/{([^}]+)}/g,(n,o)=>{const u=t[o];if(u===void 0)throw new Error(`Missing required path parameter: ${o}`);return String(u)}):e}}class h extends Error{constructor(e,t){const n=e||t?.message||"An error occurred in the fetcher";super(n),this.cause=t,this.name="FetcherError",t?.stack&&(this.stack=t.stack),Object.setPrototypeOf(this,h.prototype)}}class T extends h{constructor(e){const t=e.method||"GET",n=`Request timeout of ${e.timeout}ms exceeded for ${t} ${e.url}`;super(n),this.name="FetchTimeoutError",this.request=e,Object.setPrototypeOf(this,T.prototype)}}function g(r,e){return typeof r<"u"?r:e}async function P(r){const e=r.url,t=r.timeout,n=r;if(!t)return fetch(e,n);const o=new AbortController,u={...n,signal:o.signal};let i=null;const E=new Promise((K,z)=>{i=setTimeout(()=>{i&&clearTimeout(i);const k=new T(r);o.abort(k),z(k)},t)});try{return await Promise.race([fetch(e,u),E])}finally{i&&clearTimeout(i)}}const N="UrlResolveInterceptor",_=Number.MIN_SAFE_INTEGER+1e3;class F{constructor(){this.name=N,this.order=_}intercept(e){const t=e.request;t.url=e.fetcher.urlBuilder.resolveRequestUrl(t)}}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||{});const J="Content-Type";var l=(r=>(r.APPLICATION_JSON="application/json",r.TEXT_EVENT_STREAM="text/event-stream",r))(l||{});const b="RequestBodyInterceptor",U=_+1e3;class w{constructor(){this.name=b,this.order=U}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;const n={...t};n.body=JSON.stringify(t.body),n.headers||(n.headers={});const o=n.headers;o["Content-Type"]||(o["Content-Type"]=l.APPLICATION_JSON),e.request=n}}const C="FetchInterceptor",q=Number.MAX_SAFE_INTEGER-1e3;class L{constructor(){this.name=C,this.order=q}async intercept(e){e.response=await P(e.request)}}function R(r,e){return e?r.filter(e).sort((t,n)=>t.order-n.order):[...r].sort((t,n)=>t.order-n.order)}class m{constructor(e=[]){this.sortedInterceptors=[],this.sortedInterceptors=R(e)}get name(){return this.constructor.name}get order(){return Number.MIN_SAFE_INTEGER}get interceptors(){return[...this.sortedInterceptors]}use(e){return this.sortedInterceptors.some(t=>t.name===e.name)?!1:(this.sortedInterceptors=R([...this.sortedInterceptors,e]),!0)}eject(e){const t=this.sortedInterceptors;return this.sortedInterceptors=R(t,n=>n.name!==e),t.length!==this.sortedInterceptors.length}clear(){this.sortedInterceptors=[]}async intercept(e){for(const t of this.sortedInterceptors)await t.intercept(e)}}class f extends h{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)}}const Q=r=>r>=200&&r<300,D="ValidateStatusInterceptor",v=Number.MAX_SAFE_INTEGER-1e3;class M{constructor(e=Q){this.validateStatus=e}get name(){return D}get order(){return v}intercept(e){if(!e.response)return;const t=e.response.status;if(!this.validateStatus(t))throw new f(e)}}class d extends h{constructor(e,t){const n=t||e.error?.message||e.response?.statusText||`Request to ${e.request.url} failed during exchange`;super(n,e.error),this.exchange=e,this.name="ExchangeError",Object.setPrototypeOf(this,d.prototype)}}class V{constructor(){this.request=new m([new F,new w,new L]),this.response=new m([new M]),this.error=new m}async exchange(e){try{return await this.request.intercept(e),await this.response.intercept(e),e}catch(t){if(e.error=t,await this.error.intercept(e),!e.hasError())return e;throw new d(e)}}}class B{constructor(e,t,n,o){this.attributes={},this.fetcher=e,this.request=t,this.response=n,this.error=o}hasError(){return!!this.error}hasResponse(){return!!this.response}get requiredResponse(){if(!this.response)throw new d(this,`Request to ${this.request.url} failed with no response`);return this.response}}function I(r,e){if(!(r===void 0&&e===void 0))return e===void 0?r:r===void 0?e:{...r,...e}}const p={"Content-Type":l.APPLICATION_JSON},O={baseURL:"",headers:p};class H{constructor(e=O){this.headers=p,this.urlBuilder=new S(e.baseURL),this.headers=e.headers??p,this.timeout=e.timeout,this.interceptors=e.interceptors??new V}async fetch(e,t={}){const n=t;return n.url=e,(await this.request(n)).requiredResponse}async request(e){const t=I(e.headers,this.headers),n={...e,headers:t,timeout:g(e.timeout,this.timeout)},o=new B(this,n);return this.interceptors.exchange(o)}async methodFetch(e,t,n={}){return this.fetch(t,{...n,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 j{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 G=new j;function Y(r,e){if(Object.keys(r).length===0)return e;if(Object.keys(e).length===0)return r;const t={path:I(r.urlParams?.path,e.urlParams?.path),query:I(r.urlParams?.query,e.urlParams?.query)},n={...r.headers,...e.headers},o=e.method??r.method,u=e.body??r.body,i=e.timeout??r.timeout,E=e.signal??r.signal;return{...r,...e,method:o,urlParams:t,headers:n,body:u,timeout:i,signal:E}}class $ extends H{constructor(e,t=O){super(t),this.name=e,G.register(e,this)}}const X=new $(y);s.ContentTypeHeader=J,s.ContentTypeValues=l,s.DEFAULT_FETCHER_NAME=y,s.DEFAULT_OPTIONS=O,s.ExchangeError=d,s.FETCH_INTERCEPTOR_NAME=C,s.FETCH_INTERCEPTOR_ORDER=q,s.FetchExchange=B,s.FetchInterceptor=L,s.FetchTimeoutError=T,s.Fetcher=H,s.FetcherError=h,s.FetcherRegistrar=j,s.HttpMethod=c,s.HttpStatusValidationError=f,s.InterceptorManager=V,s.InterceptorRegistry=m,s.NamedFetcher=$,s.REQUEST_BODY_INTERCEPTOR_NAME=b,s.REQUEST_BODY_INTERCEPTOR_ORDER=U,s.RequestBodyInterceptor=w,s.URL_RESOLVE_INTERCEPTOR_NAME=N,s.URL_RESOLVE_INTERCEPTOR_ORDER=_,s.UrlBuilder=S,s.UrlResolveInterceptor=F,s.VALIDATE_STATUS_INTERCEPTOR_NAME=D,s.VALIDATE_STATUS_INTERCEPTOR_ORDER=v,s.ValidateStatusInterceptor=M,s.combineURLs=A,s.fetcher=X,s.fetcherRegistrar=G,s.isAbsoluteURL=a,s.mergeRecords=I,s.mergeRequest=Y,s.resolveTimeout=g,s.timeoutFetch=P,s.toSorted=R,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})}));

package/dist/interceptorManager.d.ts

@@ -29,8 +29,9 @@ export declare class ExchangeError extends FetcherError {
      * Creates a new ExchangeError instance.
      *
      * @param exchange - The FetchExchange object containing request/response/error information.
+     * @param errorMsg - An optional error message.
      */
-    constructor(exchange: FetchExchange);
+    constructor(exchange: FetchExchange, errorMsg?: string);
 }
 /**
  * Collection of interceptor managers for the Fetcher client.

package/dist/interceptorManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptorManager.d.ts","sourceRoot":"","sources":["../src/interceptorManager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAc,SAAQ,YAAY;aAMjB,QAAQ,EAAE,aAAa;IALnD;;;;OAIG;gBACyB,QAAQ,EAAE,aAAa;CASpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAIlC;IAEH;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAEnC;IAEH;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAA6B;IAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqFG;IACG,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAqBrE"}
+{"version":3,"file":"interceptorManager.d.ts","sourceRoot":"","sources":["../src/interceptorManager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAc,SAAQ,YAAY;aAOjB,QAAQ,EAAE,aAAa;IANnD;;;;;OAKG;gBACyB,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM;CASvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAIlC;IAEH;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAEnC;IAEH;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAA6B;IAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqFG;IACG,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAqBrE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahoo-wang/fetcher",
-  "version": "0.9.5",
+  "version": "0.9.9",
   "description": "Ultra-lightweight (1.9kB) HTTP client with built-in path parameters and Axios-like API",
   "keywords": [
     "fetch",
@@ -14,11 +14,12 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/Ahoo-Wang/fetcher.git",
-    "directory": "packages/core"
+    "directory": "packages/fetcher"
   },
   "bugs": {
     "url": "https://github.com/Ahoo-Wang/fetcher/issues"
   },
+  "type": "module",
   "main": "./dist/index.umd.js",
   "module": "./dist/index.es.js",
   "types": "./dist/index.d.ts",