@ahoo-wang/fetcher 0.8.0 → 0.8.2

package/dist/interceptor.d.ts

@@ -1,82 +1,6 @@
-import { Fetcher, FetcherRequest } from './fetcher';
 import { NamedCapable } from './types';
 import { OrderedCapable } from './orderedCapable';
-/**
- * FetchExchange Interface
- *
- * Represents the complete exchange object that flows through the interceptor chain.
- * This object contains all the information about a request, response, and any errors
- * that occur during the HTTP request lifecycle. It also provides a mechanism for
- * sharing data between interceptors through the attributes property.
- *
- * @example
- * ```typescript
- * // In a request interceptor
- * const requestInterceptor: Interceptor = {
- *   name: 'RequestInterceptor',
- *   order: 0,
- *   async intercept(exchange: FetchExchange): Promise<FetchExchange> {
- *     // Add custom data to share with other interceptors
- *     exchange.attributes = exchange.attributes || {};
- *     exchange.attributes.startTime = Date.now();
- *     exchange.attributes.customHeader = 'my-value';
- *     return exchange;
- *   }
- * };
- *
- * // In a response interceptor
- * const responseInterceptor: Interceptor = {
- *   name: 'ResponseInterceptor',
- *   order: 0,
- *   async intercept(exchange: FetchExchange): Promise<FetchExchange> {
- *     // Access data shared by previous interceptors
- *     if (exchange.attributes && exchange.attributes.startTime) {
- *       const startTime = exchange.attributes.startTime;
- *       const duration = Date.now() - startTime;
- *       console.log(`Request took ${duration}ms`);
- *     }
- *     return exchange;
- *   }
- * };
- * ```
- */
-export interface FetchExchange {
-    /**
-     * The Fetcher instance that initiated this exchange
-     */
-    fetcher: Fetcher;
-    /**
-     * The URL for this request
-     */
-    url: string;
-    /**
-     * The request configuration including method, headers, body, etc.
-     */
-    request: FetcherRequest;
-    /**
-     * The response object, undefined until the request completes successfully
-     */
-    response: Response | undefined;
-    /**
-     * Any error that occurred during the request processing, undefined if no error occurred
-     */
-    error: Error | any | undefined;
-    /**
-     * Shared attributes for passing data between interceptors
-     *
-     * This property allows interceptors to share arbitrary data with each other.
-     * Interceptors can read from and write to this object to pass information
-     * along the interceptor chain.
-     *
-     * @remarks
-     * - This property is optional and may be undefined initially
-     * - Interceptors should initialize this property if they need to use it
-     * - Use string keys to avoid conflicts between different interceptors
-     * - Consider namespacing your keys (e.g., 'mylib.retryCount' instead of 'retryCount')
-     * - Be mindful of memory usage when storing large objects
-     */
-    attributes?: Record<string, any>;
-}
+import { FetchExchange } from './fetchExchange';
 /**
  * Interceptor Interface
  *
@@ -257,11 +181,14 @@ export declare class FetcherInterceptors {
      * Request Interceptor Manager
      *
      * Responsible for managing all request-phase interceptors, executed before HTTP requests are sent.
-     * Contains two built-in interceptors by default: RequestBodyInterceptor and FetchInterceptor.
+     * Contains three built-in interceptors by default: UrlResolveInterceptor, RequestBodyInterceptor, and FetchInterceptor.
      *
      * @remarks
      * Request interceptors are executed in ascending order of their order values, with smaller values having higher priority.
-     * FetchInterceptor's order is set to Number.MAX_SAFE_INTEGER to ensure it executes last.
+     * The default interceptors are:
+     * 1. UrlResolveInterceptor (order: Number.MIN_SAFE_INTEGER) - Resolves the final URL
+     * 2. RequestBodyInterceptor (order: 0) - Converts object bodies to JSON
+     * 3. FetchInterceptor (order: Number.MAX_SAFE_INTEGER) - Executes the actual HTTP request
      */
     request: InterceptorManager;
     /**

package/dist/interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,cAAc,EAAY,MAAM,kBAAkB,CAAC;AAI5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,OAAO,EAAE,cAAc,CAAC;IAExB;;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,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY,EAAE,cAAc;IAC/D;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAAqB;IAE/C;;;;;;;;OAQG;gBACS,YAAY,GAAE,WAAW,EAAO;IAI5C;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAWtC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAS5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;;;;;;;OAaG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAQjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;;;;OASG;IACH,OAAO,EAAE,kBAAkB,CAGxB;IAEH;;;;;;;;OAQG;IACH,QAAQ,EAAE,kBAAkB,CAA4B;IAExD;;;;;;;;;OASG;IACH,KAAK,EAAE,kBAAkB,CAA4B;CACtD"}
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,cAAc,EAAY,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY,EAAE,cAAc;IAC/D;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAAqB;IAE/C;;;;;;;;OAQG;gBACS,YAAY,GAAE,WAAW,EAAO;IAI5C;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAWtC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAS5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;;;;;;;OAaG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAQjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;;;;;;;OAYG;IACH,OAAO,EAAE,kBAAkB,CAIxB;IAEH;;;;;;;;OAQG;IACH,QAAQ,EAAE,kBAAkB,CAA4B;IAExD;;;;;;;;;OASG;IACH,KAAK,EAAE,kBAAkB,CAA4B;CACtD"}

package/dist/mergeRequest.d.ts

@@ -1,4 +1,4 @@
-import { FetcherRequest } from './fetcher';
+import { FetcherRequest } from './fetchExchange';
 /**
  * Merges two FetcherRequest objects into one.
  *

package/dist/mergeRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mergeRequest.d.ts","sourceRoot":"","sources":["../src/mergeRequest.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,GACrB,cAAc,CA6ChB"}
+{"version":3,"file":"mergeRequest.d.ts","sourceRoot":"","sources":["../src/mergeRequest.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,GACrB,cAAc,CA6ChB"}

package/dist/requestBodyInterceptor.d.ts

@@ -1,4 +1,5 @@
-import { FetchExchange, Interceptor } from './interceptor';
+import { Interceptor } from './interceptor';
+import { FetchExchange } from './fetchExchange';
 /**
  * RequestBodyInterceptor Class
  *
@@ -17,11 +18,13 @@ export declare class RequestBodyInterceptor implements Interceptor {
      */
     name: string;
     /**
-     * Interceptor execution order, set to minimum safe integer to ensure early execution
+     * Interceptor execution order, set to run after UrlResolveInterceptor but before FetchInterceptor
      *
      * @remarks
-     * This interceptor should run before other request interceptors to ensure
-     * request bodies are properly formatted early in the processing chain.
+     * This interceptor should run after URL resolution (UrlResolveInterceptor) but before
+     * the actual HTTP request is made (FetchInterceptor). The order is set to
+     * Number.MIN_SAFE_INTEGER + 100 to ensure it executes in the correct position
+     * in the interceptor chain.
      */
     order: number;
     /**

package/dist/requestBodyInterceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requestBodyInterceptor.d.ts","sourceRoot":"","sources":["../src/requestBodyInterceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG3D;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,YAAW,WAAW;IACxD;;OAEG;IACH,IAAI,SAA4B;IAEhC;;;;;;OAMG;IACH,KAAK,SAA2B;IAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa;CA2ClD"}
+{"version":3,"file":"requestBodyInterceptor.d.ts","sourceRoot":"","sources":["../src/requestBodyInterceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,YAAW,WAAW;IACxD;;OAEG;IACH,IAAI,SAA4B;IAEhC;;;;;;;;OAQG;IACH,KAAK,SAAiC;IAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa;CA2ClD"}

package/dist/urlBuilder.d.ts

@@ -60,4 +60,7 @@ export declare class UrlBuilder implements BaseURLCapable {
      */
     interpolateUrl(url: string, path?: Record<string, any>): string;
 }
+export interface UrlBuilderCapable {
+    urlBuilder: UrlBuilder;
+}
 //# sourceMappingURL=urlBuilder.d.ts.map

package/dist/urlBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"urlBuilder.d.ts","sourceRoot":"","sources":["../src/urlBuilder.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAW,YAAW,cAAc;IAC/C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;gBACS,OAAO,EAAE,MAAM;IAI3B;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CACH,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM;IAYT;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;CAWhE"}
+{"version":3,"file":"urlBuilder.d.ts","sourceRoot":"","sources":["../src/urlBuilder.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAW,YAAW,cAAc;IAC/C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;gBACS,OAAO,EAAE,MAAM;IAI3B;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CACH,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM;IAYT;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;CAWhE;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,UAAU,CAAC;CACxB"}

package/dist/urlResolveInterceptor.d.ts

@@ -0,0 +1,39 @@
+import { Interceptor } from './interceptor';
+import { FetchExchange } from './fetchExchange';
+/**
+ * URL Resolution Interceptor
+ *
+ * This interceptor is responsible for resolving the final URL for a request by combining
+ * the base URL, path parameters, and query parameters. It should be executed early in
+ * the interceptor chain to ensure the URL is properly resolved before other interceptors
+ * process the request.
+ *
+ * @remarks
+ * This interceptor has the lowest possible order (Number.MIN_SAFE_INTEGER) to ensure
+ * it runs first in the request interceptor chain, before any other request processing.
+ *
+ * @example
+ * // With baseURL: 'https://api.example.com'
+ * // Request URL: '/users/{id}'
+ * // Path params: { id: 123 }
+ * // Query params: { filter: 'active' }
+ * // Final URL: 'https://api.example.com/users/123?filter=active'
+ */
+export declare class UrlResolveInterceptor implements Interceptor {
+    /**
+     * The name of this interceptor
+     */
+    name: string;
+    /**
+     * The order of this interceptor (executed first)
+     */
+    order: number;
+    /**
+     * 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(exchange: FetchExchange): FetchExchange;
+}
+//# sourceMappingURL=urlResolveInterceptor.d.ts.map

package/dist/urlResolveInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlResolveInterceptor.d.ts","sourceRoot":"","sources":["../src/urlResolveInterceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,qBAAsB,YAAW,WAAW;IACvD;;OAEG;IACH,IAAI,SAA2B;IAE/B;;OAEG;IACH,KAAK,SAA2B;IAEhC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa;CAQlD"}

package/package.json

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