@ahoo-wang/fetcher 0.9.2 → 0.9.5

package/dist/urlResolveInterceptor.d.ts

@@ -1,13 +1,28 @@
-import { Interceptor } from './interceptor';
+import { RequestInterceptor } from './interceptor';
 import { FetchExchange } from './fetchExchange';
+/**
+ * The name of the UrlResolveInterceptor.
+ */
+export declare const URL_RESOLVE_INTERCEPTOR_NAME = "UrlResolveInterceptor";
+/**
+ * The order of the UrlResolveInterceptor.
+ * Set to Number.MIN_SAFE_INTEGER + 1000 to ensure it runs earliest among request interceptors.
+ */
+export declare const URL_RESOLVE_INTERCEPTOR_ORDER: number;
 /**
  * Interceptor responsible for resolving the final URL for a request.
  *
  * This interceptor combines the base URL, path parameters, and query parameters
- * to create the final URL for a request. It should be executed early in
+ * to create the final URL for a request. It should be executed earliest in
  * the interceptor chain to ensure the URL is properly resolved before other interceptors
  * process the request.
  *
+ * @remarks
+ * This interceptor runs at the very beginning of the request interceptor chain to ensure
+ * URL resolution happens before any other request processing. The order is set to
+ * URL_RESOLVE_INTERCEPTOR_ORDER to ensure it executes before all other request interceptors,
+ * establishing the foundation for subsequent processing.
+ *
  * @example
  * // With baseURL: 'https://api.example.com'
  * // Request URL: '/users/{id}'
@@ -15,20 +30,20 @@ import { FetchExchange } from './fetchExchange';
  * // Query params: { filter: 'active' }
  * // Final URL: 'https://api.example.com/users/123?filter=active'
  */
-export declare class UrlResolveInterceptor implements Interceptor {
+export declare class UrlResolveInterceptor implements RequestInterceptor {
     /**
      * The name of this interceptor.
      */
-    name: string;
+    readonly name = "UrlResolveInterceptor";
     /**
-     * The order of this interceptor (executed first).
+     * The order of this interceptor (executed earliest).
      *
-     * This interceptor should run first in the request interceptor chain to ensure
+     * This interceptor should run at the very beginning of the request interceptor chain to ensure
      * URL resolution happens before any other request processing. The order is set to
-     * Number.MIN_SAFE_INTEGER + 100 to allow for other interceptors that need to run
-     * even earlier while still maintaining a high priority.
+     * URL_RESOLVE_INTERCEPTOR_ORDER to ensure it executes before all other request interceptors,
+     * establishing the foundation for subsequent processing.
      */
-    order: number;
+    readonly order: number;
     /**
      * Resolves the final URL by combining the base URL, path parameters, and query parameters.
      *

package/dist/urlResolveInterceptor.d.ts.map

@@ -1 +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;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,YAAW,WAAW;IACvD;;OAEG;IACH,IAAI,SAA2B;IAE/B;;;;;;;OAOG;IACH,KAAK,SAAiC;IAEtC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa;CAIlC"}
+{"version":3,"file":"urlResolveInterceptor.d.ts","sourceRoot":"","sources":["../src/urlResolveInterceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,4BAA4B,0BAA0B,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,6BAA6B,QAAiC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,qBAAsB,YAAW,kBAAkB;IAC9D;;OAEG;IACH,QAAQ,CAAC,IAAI,2BAAgC;IAE7C;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,SAAiC;IAE/C;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa;CAIlC"}

package/dist/validateStatusInterceptor.d.ts

@@ -0,0 +1,112 @@
+import { ResponseInterceptor } from './interceptor';
+import { FetchExchange } from './fetchExchange';
+import { FetcherError } from './fetcherError';
+/**
+ * Error thrown when response status validation fails.
+ *
+ * This error is thrown by ValidateStatusInterceptor when the response status
+ * does not pass the validation defined by the validateStatus function.
+ */
+export declare class HttpStatusValidationError extends FetcherError {
+    readonly exchange: FetchExchange;
+    constructor(exchange: FetchExchange);
+}
+/**
+ * Defines whether to resolve or reject the promise for a given HTTP response status code.
+ * If `validateStatus` returns `true` (or is set to `null` or `undefined`), the promise will be resolved;
+ * otherwise, the promise will be rejected.
+ *
+ * @param status - HTTP response status code
+ * @returns true to resolve the promise, false to reject it
+ *
+ * @example
+ * ```typescript
+ * // Default behavior (2xx status codes are resolved)
+ * const fetcher = new Fetcher();
+ *
+ * // Custom behavior (only 200 status code is resolved)
+ * const fetcher = new Fetcher({
+ *   validateStatus: (status) => status === 200
+ * });
+ *
+ * // Always resolve (never reject based on status)
+ * const fetcher = new Fetcher({
+ *   validateStatus: (status) => true
+ * });
+ * ```
+ */
+type ValidateStatus = (status: number) => boolean;
+/**
+ * The name of the ValidateStatusInterceptor.
+ */
+export declare const VALIDATE_STATUS_INTERCEPTOR_NAME = "ValidateStatusInterceptor";
+/**
+ * The order of the ValidateStatusInterceptor.
+ * Set to Number.MAX_SAFE_INTEGER - 1000 to ensure it runs latest among response interceptors,
+ * but still allows other interceptors to run after it if needed.
+ */
+export declare const VALIDATE_STATUS_INTERCEPTOR_ORDER: number;
+/**
+ * Response interceptor that validates HTTP status codes.
+ *
+ * This interceptor implements behavior similar to axios's validateStatus option.
+ * It checks the response status code against a validation function and throws
+ * an error if the status is not valid.
+ *
+ * @remarks
+ * This interceptor runs at the very beginning of the response interceptor chain to ensure
+ * status validation happens before any other response processing. The order is set to
+ * VALIDATE_STATUS_INTERCEPTOR_ORDER to ensure it executes early in the response chain,
+ * allowing for other response interceptors to run after it if needed. This positioning
+ * ensures that invalid responses are caught and handled early in the response processing
+ * pipeline, before other response handlers attempt to process them.
+ *
+ * @example
+ * ```typescript
+ * // Default behavior (2xx status codes are valid)
+ * const interceptor = new ValidateStatusInterceptor();
+ *
+ * // Custom validation (only 200 status code is valid)
+ * const interceptor = new ValidateStatusInterceptor((status) => status === 200);
+ *
+ * // Always valid (never throws based on status)
+ * const interceptor = new ValidateStatusInterceptor((status) => true);
+ * ```
+ */
+export declare class ValidateStatusInterceptor implements ResponseInterceptor {
+    private readonly validateStatus;
+    /**
+     * Gets the name of this interceptor.
+     *
+     * @returns The name of this interceptor
+     */
+    get name(): string;
+    /**
+     * Gets the order of this interceptor.
+     *
+     * @returns VALIDATE_STATUS_INTERCEPTOR_ORDER, indicating this interceptor should execute early
+     */
+    get order(): number;
+    /**
+     * Creates a new ValidateStatusInterceptor instance.
+     *
+     * @param validateStatus - Function that determines if a status code is valid
+     */
+    constructor(validateStatus?: ValidateStatus);
+    /**
+     * Validates the response status code.
+     *
+     * @param exchange - The exchange containing the response to validate
+     * @throws HttpStatusValidationError if the status code is not valid
+     *
+     * @remarks
+     * This method runs at the beginning of the response interceptor chain to ensure
+     * status validation happens before any other response processing. Invalid responses
+     * are caught and converted to HttpStatusValidationError early in the pipeline,
+     * preventing other response handlers from attempting to process them. Valid responses
+     * proceed through the rest of the response interceptor chain normally.
+     */
+    intercept(exchange: FetchExchange): void;
+}
+export {};
+//# sourceMappingURL=validateStatusInterceptor.d.ts.map

package/dist/validateStatusInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateStatusInterceptor.d.ts","sourceRoot":"","sources":["../src/validateStatusInterceptor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;aAC7B,QAAQ,EAAE,aAAa;gBAAvB,QAAQ,EAAE,aAAa;CAOpD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;AAKlD;;GAEG;AACH,eAAO,MAAM,gCAAgC,8BAA8B,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,QAAiC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,yBAA0B,YAAW,mBAAmB;IAyBjE,OAAO,CAAC,QAAQ,CAAC,cAAc;IAxBjC;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;OAIG;gBAEgB,cAAc,GAAE,cAAwC;IAI3E;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa;CAalC"}

package/package.json

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