@foundatiofx/fetchclient 1.1.0 → 1.2.0

package/script/src/RetryMiddleware.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryMiddleware = void 0;
+exports.createRetryMiddleware = createRetryMiddleware;
+/**
+ * Default HTTP methods that are eligible for retry.
+ * These are idempotent methods that can be safely retried without side effects.
+ */
+const DEFAULT_RETRY_METHODS = [
+    "GET",
+    "HEAD",
+    "PUT",
+    "DELETE",
+    "OPTIONS",
+    "TRACE",
+];
+/**
+ * Default HTTP status codes that trigger a retry.
+ */
+const DEFAULT_RETRY_STATUS_CODES = [
+    408, // Request Timeout
+    413, // Payload Too Large (rate limiting)
+    429, // Too Many Requests
+    500, // Internal Server Error
+    502, // Bad Gateway
+    503, // Service Unavailable
+    504, // Gateway Timeout
+];
+/**
+ * Retry middleware that automatically retries failed requests with exponential backoff.
+ *
+ * @example
+ * ```typescript
+ * const provider = new FetchClientProvider();
+ * provider.useRetry({
+ *   limit: 3,
+ *   statusCodes: [500, 502, 503, 504],
+ *   jitter: 0.1,
+ * });
+ *
+ * const client = provider.getFetchClient();
+ * const response = await client.getJSON('/api/data');
+ * ```
+ */
+class RetryMiddleware {
+    #options;
+    constructor(options) {
+        this.#options = {
+            limit: options?.limit ?? 2,
+            methods: (options?.methods ?? DEFAULT_RETRY_METHODS).map((m) => m.toUpperCase()),
+            statusCodes: options?.statusCodes ?? DEFAULT_RETRY_STATUS_CODES,
+            maxRetryAfter: options?.maxRetryAfter ?? Infinity,
+            backoffLimit: options?.backoffLimit ?? 30000,
+            jitter: options?.jitter ?? 0.1,
+            delay: options?.delay,
+            shouldRetry: options?.shouldRetry,
+            onRetry: options?.onRetry,
+        };
+    }
+    /**
+     * Creates the middleware function.
+     * @returns The middleware function
+     */
+    middleware() {
+        return async (context, next) => {
+            const method = context.request.method.toUpperCase();
+            // Check if method is eligible for retry
+            if (!this.#options.methods.includes(method)) {
+                await next();
+                return;
+            }
+            let attemptNumber = 0;
+            while (true) {
+                // Store retry metadata in context for observability
+                if (attemptNumber > 0) {
+                    context.retryAttempt = attemptNumber;
+                }
+                await next();
+                // If no response or we've exhausted retries, stop
+                if (!context.response || attemptNumber >= this.#options.limit) {
+                    break;
+                }
+                const response = context.response;
+                // Check if status code is retryable
+                if (!this.#options.statusCodes.includes(response.status)) {
+                    break;
+                }
+                // Check custom shouldRetry predicate
+                if (this.#options.shouldRetry) {
+                    const shouldRetry = await this.#options.shouldRetry(response, attemptNumber);
+                    if (!shouldRetry) {
+                        break;
+                    }
+                }
+                // Calculate base delay
+                let delay = this.#calculateDelay(attemptNumber, response);
+                // Check Retry-After header
+                const retryAfterDelay = this.#parseRetryAfter(response);
+                if (retryAfterDelay !== null) {
+                    // If Retry-After exceeds maxRetryAfter, don't retry
+                    if (retryAfterDelay > this.#options.maxRetryAfter) {
+                        break;
+                    }
+                    // Use the larger of computed delay or Retry-After
+                    delay = Math.max(delay, retryAfterDelay);
+                }
+                // Invoke onRetry callback
+                this.#options.onRetry?.(attemptNumber, response, delay);
+                // Wait before retry
+                await this.#sleep(delay);
+                // Reset response for next attempt
+                context.response = null;
+                attemptNumber++;
+            }
+        };
+    }
+    /**
+     * Calculates the delay for a given attempt with exponential backoff and jitter.
+     */
+    #calculateDelay(attemptNumber, response) {
+        let baseDelay;
+        if (this.#options.delay) {
+            baseDelay = this.#options.delay(attemptNumber, response);
+        }
+        else {
+            // Default exponential backoff: 1s, 2s, 4s, 8s, ...
+            baseDelay = Math.min(1000 * Math.pow(2, attemptNumber), this.#options.backoffLimit);
+        }
+        // Apply jitter
+        return this.#applyJitter(baseDelay);
+    }
+    /**
+     * Applies jitter to a delay value.
+     */
+    #applyJitter(delay) {
+        if (this.#options.jitter <= 0) {
+            return delay;
+        }
+        const jitterRange = delay * this.#options.jitter;
+        // Random value between -jitterRange and +jitterRange
+        const jitter = (Math.random() * 2 - 1) * jitterRange;
+        return Math.max(0, Math.round(delay + jitter));
+    }
+    /**
+     * Parses the Retry-After header and returns the delay in milliseconds.
+     * Supports both delta-seconds and HTTP-date formats.
+     */
+    #parseRetryAfter(response) {
+        const retryAfter = response.headers.get("Retry-After");
+        if (!retryAfter) {
+            return null;
+        }
+        // Try parsing as seconds (integer)
+        const seconds = parseInt(retryAfter, 10);
+        if (!isNaN(seconds)) {
+            return seconds * 1000;
+        }
+        // Try parsing as HTTP-date
+        const date = Date.parse(retryAfter);
+        if (!isNaN(date)) {
+            return Math.max(0, date - Date.now());
+        }
+        return null;
+    }
+    /**
+     * Sleep for the specified number of milliseconds.
+     */
+    #sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.RetryMiddleware = RetryMiddleware;
+/**
+ * Creates a retry middleware with the given options.
+ *
+ * @example
+ * ```typescript
+ * const client = new FetchClient();
+ * client.use(createRetryMiddleware({ limit: 3 }));
+ * ```
+ */
+function createRetryMiddleware(options) {
+    return new RetryMiddleware(options).middleware();
+}

package/script/src/mocks/MockHistory.js

@@ -6,6 +6,7 @@ exports.MockHistoryImpl = void 0;
  */
 class MockHistoryImpl {
     #get = [];
+    #head = [];
     #post = [];
     #put = [];
     #patch = [];
@@ -14,6 +15,9 @@ class MockHistoryImpl {
     get get() {
         return [...this.#get];
     }
+    get head() {
+        return [...this.#head];
+    }
     get post() {
         return [...this.#post];
     }
@@ -38,6 +42,9 @@ class MockHistoryImpl {
             case "GET":
                 this.#get.push(request);
                 break;
+            case "HEAD":
+                this.#head.push(request);
+                break;
             case "POST":
                 this.#post.push(request);
                 break;
@@ -57,6 +64,7 @@ class MockHistoryImpl {
      */
     clear() {
         this.#get = [];
+        this.#head = [];
         this.#post = [];
         this.#put = [];
         this.#patch = [];

package/script/src/mocks/MockRegistry.js

@@ -43,6 +43,13 @@ class MockRegistry {
     onGet(url) {
         return this.#addMock("GET", url);
     }
+    /**
+     * Creates a mock for HEAD requests matching the given URL.
+     * @param url - URL string or RegExp to match
+     */
+    onHead(url) {
+        return this.#addMock("HEAD", url);
+    }
     /**
      * Creates a mock for POST requests matching the given URL.
      * @param url - URL string or RegExp to match

package/types/mod.d.ts

@@ -1,6 +1,8 @@
 export { FetchClient } from "./src/FetchClient.js";
 export type { FetchClientOptions } from "./src/FetchClientOptions.js";
 export type { FetchClientResponse } from "./src/FetchClientResponse.js";
+export { FetchClientError } from "./src/FetchClientError.js";
+export { ResponsePromise } from "./src/ResponsePromise.js";
 export { ProblemDetails } from "./src/ProblemDetails.js";
 export { type CacheKey, type CacheTag, FetchClientCache, } from "./src/FetchClientCache.js";
 export type { RequestOptions } from "./src/RequestOptions.js";
@@ -10,4 +12,98 @@ export { defaultInstance as defaultProviderInstance, FetchClientProvider, } from
 export * from "./src/DefaultHelpers.js";
 export { CircuitBreaker, type CircuitBreakerOptions, type CircuitState, groupByDomain as circuitBreakerGroupByDomain, type GroupCircuitBreakerOptions, } from "./src/CircuitBreaker.js";
 export { CircuitBreakerMiddleware, type CircuitBreakerMiddlewareOptions, CircuitOpenError, createCircuitBreakerMiddleware, createPerDomainCircuitBreakerMiddleware, } from "./src/CircuitBreakerMiddleware.js";
+export { createRetryMiddleware, RetryMiddleware, type RetryMiddlewareOptions, } from "./src/RetryMiddleware.js";
+export { createPerDomainRateLimitMiddleware, createRateLimitMiddleware, RateLimitError, RateLimitMiddleware, type RateLimitMiddlewareOptions, } from "./src/RateLimitMiddleware.js";
+export { groupByDomain as rateLimiterGroupByDomain, RateLimiter, type RateLimiterOptions, } from "./src/RateLimiter.js";
+import { createRetryMiddleware } from "./src/RetryMiddleware.js";
+import { createPerDomainRateLimitMiddleware, createRateLimitMiddleware } from "./src/RateLimitMiddleware.js";
+import { createCircuitBreakerMiddleware, createPerDomainCircuitBreakerMiddleware } from "./src/CircuitBreakerMiddleware.js";
+import { deleteJSON, getJSON, patchJSON, postJSON, putJSON, useMiddleware } from "./src/DefaultHelpers.js";
+import type { GetRequestOptions, RequestOptions } from "./src/RequestOptions.js";
+import type { ResponsePromise } from "./src/ResponsePromise.js";
+/**
+ * Convenience middleware factory functions for use with FetchClient.use()
+ *
+ * @example
+ * ```typescript
+ * import { FetchClient, middleware } from "@foundatiofx/fetchclient";
+ *
+ * const client = new FetchClient();
+ * client.use(
+ *   middleware.retry({ limit: 3 }),
+ *   middleware.rateLimit({ maxRequests: 100, windowSeconds: 60 }),
+ *   middleware.circuitBreaker({ failureThreshold: 5 })
+ * );
+ * ```
+ */
+export declare const middleware: {
+    /** Retry failed requests with exponential backoff and jitter */
+    retry: typeof createRetryMiddleware;
+    /** Rate limit requests to prevent overwhelming servers */
+    rateLimit: typeof createRateLimitMiddleware;
+    /** Per-domain rate limit (each domain tracked separately) */
+    perDomainRateLimit: typeof createPerDomainRateLimitMiddleware;
+    /** Circuit breaker for fault tolerance */
+    circuitBreaker: typeof createCircuitBreakerMiddleware;
+    /** Per-domain circuit breaker (each domain tracked separately) */
+    perDomainCircuitBreaker: typeof createPerDomainCircuitBreakerMiddleware;
+};
+/**
+ * Default export for convenient access to all HTTP methods.
+ *
+ * @example
+ * ```typescript
+ * import fc from "@foundatiofx/fetchclient";
+ *
+ * // Configure middleware
+ * fc.use(fc.middleware.retry({ limit: 3 }));
+ *
+ * // Use JSON methods (recommended)
+ * const { data: user } = await fc.getJSON<User>("/api/user/1");
+ * const { data: created } = await fc.postJSON<User>("/api/users", { name: "Alice" });
+ *
+ * // Or use fluent API for other response types
+ * const html = await fc.get("/page").text();
+ * ```
+ */
+declare const fetchClient: {
+    /** Sends a GET request. Use `.json<T>()` for typed JSON response. */
+    get: (url: string, options?: GetRequestOptions) => ResponsePromise<unknown>;
+    /** Sends a POST request. Use `.json<T>()` for typed JSON response. */
+    post: (url: string, body?: object | string | FormData, options?: RequestOptions) => ResponsePromise<unknown>;
+    /** Sends a PUT request. Use `.json<T>()` for typed JSON response. */
+    put: (url: string, body?: object | string | FormData, options?: RequestOptions) => ResponsePromise<unknown>;
+    /** Sends a PATCH request. Use `.json<T>()` for typed JSON response. */
+    patch: (url: string, body?: object | string | FormData, options?: RequestOptions) => ResponsePromise<unknown>;
+    /** Sends a DELETE request. Use `.json<T>()` for typed JSON response. */
+    delete: (url: string, options?: RequestOptions) => ResponsePromise<unknown>;
+    /** Sends a HEAD request. */
+    head: (url: string, options?: GetRequestOptions) => ResponsePromise<void>;
+    /** Sends a GET request and returns parsed JSON in response.data */
+    getJSON: typeof getJSON;
+    /** Sends a POST request and returns parsed JSON in response.data */
+    postJSON: typeof postJSON;
+    /** Sends a PUT request and returns parsed JSON in response.data */
+    putJSON: typeof putJSON;
+    /** Sends a PATCH request and returns parsed JSON in response.data */
+    patchJSON: typeof patchJSON;
+    /** Sends a DELETE request and returns parsed JSON in response.data */
+    deleteJSON: typeof deleteJSON;
+    /** Adds middleware to the default provider */
+    use: typeof useMiddleware;
+    /** Middleware factory functions */
+    middleware: {
+        /** Retry failed requests with exponential backoff and jitter */
+        retry: typeof createRetryMiddleware;
+        /** Rate limit requests to prevent overwhelming servers */
+        rateLimit: typeof createRateLimitMiddleware;
+        /** Per-domain rate limit (each domain tracked separately) */
+        perDomainRateLimit: typeof createPerDomainRateLimitMiddleware;
+        /** Circuit breaker for fault tolerance */
+        circuitBreaker: typeof createCircuitBreakerMiddleware;
+        /** Per-domain circuit breaker (each domain tracked separately) */
+        perDomainCircuitBreaker: typeof createPerDomainCircuitBreakerMiddleware;
+    };
+};
+export default fetchClient;
 //# sourceMappingURL=mod.d.ts.map

package/types/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EACL,eAAe,IAAI,uBAAuB,EAC1C,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,aAAa,IAAI,2BAA2B,EAC5C,KAAK,0BAA0B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,EACpC,gBAAgB,EAChB,8BAA8B,EAC9B,uCAAuC,GACxC,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"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"}

package/types/src/DefaultHelpers.d.ts

@@ -1,4 +1,5 @@
 import type { FetchClient } from "./FetchClient.js";
+import type { FetchClientCache } from "./FetchClientCache.js";
 import type { FetchClientMiddleware } from "./FetchClientMiddleware.js";
 import type { FetchClientOptions } from "./FetchClientOptions.js";
 import { type FetchClientProvider } from "./FetchClientProvider.js";
@@ -16,7 +17,7 @@ export declare function useFetchClient(options?: FetchClientOptions): FetchClien
  * Sends a GET request to the specified URL using the default client and provider and returns the response as JSON.
  * @param url - The URL to send the GET request to.
  * @param options - Optional request options.
- * @returns A promise that resolves to the response as JSON.
+ * @returns A promise that resolves to the response with parsed JSON in `data`.
  */
 export declare function getJSON<T>(url: string, options?: GetRequestOptions): Promise<FetchClientResponse<T>>;
 /**
@@ -26,7 +27,7 @@ export declare function getJSON<T>(url: string, options?: GetRequestOptions): Pr
  * @param {string} url - The URL to send the request to.
  * @param {object | string | FormData} [body] - The JSON payload or form data to send with the request.
  * @param {RequestOptions} [options] - Additional options for the request.
- * @returns {Promise<FetchClientResponse<T>>} - A promise that resolves to the response data.
+ * @returns A promise that resolves to the response with parsed JSON in `data`.
  */
 export declare function postJSON<T>(url: string, body?: object | string | FormData, options?: RequestOptions): Promise<FetchClientResponse<T>>;
 /**
@@ -36,7 +37,7 @@ export declare function postJSON<T>(url: string, body?: object | string | FormDa
  * @param {string} url - The URL to send the request to.
  * @param {object | string} [body] - The JSON payload to send with the request.
  * @param {RequestOptions} [options] - Additional options for the request.
- * @returns {Promise<FetchClientResponse<T>>} - A promise that resolves to the response data.
+ * @returns A promise that resolves to the response with parsed JSON in `data`.
  */
 export declare function putJSON<T>(url: string, body?: object | string, options?: RequestOptions): Promise<FetchClientResponse<T>>;
 /**
@@ -46,7 +47,7 @@ export declare function putJSON<T>(url: string, body?: object | string, options?
  * @param {string} url - The URL to send the request to.
  * @param {object | string} [body] - The JSON payload to send with the request.
  * @param {RequestOptions} [options] - Additional options for the request.
- * @returns {Promise<FetchClientResponse<T>>} - A promise that resolves to the response data.
+ * @returns A promise that resolves to the response with parsed JSON in `data`.
  */
 export declare function patchJSON<T>(url: string, body?: object | string, options?: RequestOptions): Promise<FetchClientResponse<T>>;
 /**
@@ -55,7 +56,7 @@ export declare function patchJSON<T>(url: string, body?: object | string, option
  * @template T - The type of the response data.
  * @param {string} url - The URL to send the request to.
  * @param {RequestOptions} [options] - Additional options for the request.
- * @returns {Promise<FetchClientResponse<T>>} - A promise that resolves to the response data.
+ * @returns A promise that resolves to the response with parsed JSON in `data`.
  */
 export declare function deleteJSON<T>(url: string, options?: RequestOptions): Promise<FetchClientResponse<T>>;
 /**
@@ -63,6 +64,11 @@ export declare function deleteJSON<T>(url: string, options?: RequestOptions): Pr
  * @returns The current FetchClientProvider.
  */
 export declare function getCurrentProvider(): FetchClientProvider;
+/**
+ * Gets the cache from the current provider.
+ * @returns The FetchClientCache instance.
+ */
+export declare function getCache(): FetchClientCache;
 /**
  * Sets the function that retrieves the current FetchClientProvider using whatever scoping mechanism is available.
  * @param getProviderFunc - The function that retrieves the current FetchClientProvider.

package/types/src/DefaultHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultHelpers.d.ts","sourceRoot":"","sources":["../../src/src/DefaultHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI7E;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAEjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAEjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAEjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAEjC;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAEjC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,mBAAmB,GAAG,IAAI,QAGlD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,QAEzC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,MAAM,GAAG,IAAI,QAGrC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,QAGnE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,qBAAqB,QAE9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,QAExD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,0BAA0B,QAGpC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,0BAA0B,EAAE,cAAc,CAAC,QAG1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,+BAA+B,QAE1E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,IAAI,CAAC,+BAA+B,EAAE,cAAc,CAAC,QAGhE"}
+{"version":3,"file":"DefaultHelpers.d.ts","sourceRoot":"","sources":["../../src/src/DefaultHelpers.ts"],"names":[],"mappings":"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"}

package/types/src/FetchClient.d.ts

@@ -5,6 +5,7 @@ import type { FetchClientCache } from "./FetchClientCache.js";
 import { FetchClientProvider } from "./FetchClientProvider.js";
 import type { FetchClientOptions } from "./FetchClientOptions.js";
 import { type IObjectEvent } from "./ObjectEvent.js";
+import { ResponsePromise } from "./ResponsePromise.js";
 type Fetch = typeof globalThis.fetch;
 /**
  * Represents a client for making HTTP requests using the Fetch API.
@@ -57,14 +58,16 @@ export declare class FetchClient {
      *
      * @param url - The URL to send the GET request to.
      * @param options - The optional request options.
-     * @returns A promise that resolves to the response of the GET request.
+     * @returns A ResponsePromise that resolves to the response. Can use `.json<T>()` for typed JSON.
      */
-    get(url: string, options?: GetRequestOptions): Promise<FetchClientResponse<unknown>>;
+    get(url: string, options?: GetRequestOptions): ResponsePromise<unknown>;
     /**
      * Sends a GET request to the specified URL and returns the response as JSON.
+     * The response will have the parsed JSON in `response.data`.
+     *
      * @param url - The URL to send the GET request to.
      * @param options - Optional request options.
-     * @returns A promise that resolves to the response as JSON.
+     * @returns A promise that resolves to the response with parsed JSON in `data`.
      */
     getJSON<T>(url: string, options?: GetRequestOptions): Promise<FetchClientResponse<T>>;
     /**
@@ -73,17 +76,18 @@ export declare class FetchClient {
      * @param url - The URL to send the request to.
      * @param body - The request body, can be an object, a string, or FormData.
      * @param options - Additional options for the request.
-     * @returns A promise that resolves to a FetchClientResponse object.
+     * @returns A ResponsePromise that resolves to the response. Can use `.json<T>()` for typed JSON.
      */
-    post(url: string, body?: object | string | FormData, options?: RequestOptions): Promise<FetchClientResponse<unknown>>;
+    post(url: string, body?: object | string | FormData, options?: RequestOptions): ResponsePromise<unknown>;
     /**
      * Sends a POST request with JSON payload to the specified URL.
+     * The response will have the parsed JSON in `response.data`.
      *
      * @template T - The type of the response data.
      * @param {string} url - The URL to send the request to.
      * @param {object | string | FormData} [body] - The JSON payload or form data to send with the request.
      * @param {RequestOptions} [options] - Additional options for the request.
-     * @returns {Promise<FetchClientResponse<T>>} - A promise that resolves to the response data.
+     * @returns A promise that resolves to the response with parsed JSON in `data`.
      */
     postJSON<T>(url: string, body?: object | string | FormData, options?: RequestOptions): Promise<FetchClientResponse<T>>;
     /**
@@ -91,17 +95,18 @@ export declare class FetchClient {
      * @param url - The URL to send the request to.
      * @param body - The request body, can be an object, a string, or FormData.
      * @param options - The request options.
-     * @returns A promise that resolves to a FetchClientResponse object.
+     * @returns A ResponsePromise that resolves to the response. Can use `.json<T>()` for typed JSON.
      */
-    put(url: string, body?: object | string | FormData, options?: RequestOptions): Promise<FetchClientResponse<unknown>>;
+    put(url: string, body?: object | string | FormData, options?: RequestOptions): ResponsePromise<unknown>;
     /**
      * Sends a PUT request with JSON payload to the specified URL.
+     * The response will have the parsed JSON in `response.data`.
      *
      * @template T - The type of the response data.
      * @param {string} url - The URL to send the request to.
      * @param {object | string} [body] - The JSON payload to send with the request.
      * @param {RequestOptions} [options] - Additional options for the request.
-     * @returns {Promise<FetchClientResponse<T>>} - A promise that resolves to the response data.
+     * @returns A promise that resolves to the response with parsed JSON in `data`.
      */
     putJSON<T>(url: string, body?: object | string, options?: RequestOptions): Promise<FetchClientResponse<T>>;
     /**
@@ -109,17 +114,18 @@ export declare class FetchClient {
      * @param url - The URL to send the PATCH request to.
      * @param body - The body of the request. It can be an object, a string, or FormData.
      * @param options - The options for the request.
-     * @returns A Promise that resolves to the response of the PATCH request.
+     * @returns A ResponsePromise that resolves to the response. Can use `.json<T>()` for typed JSON.
      */
-    patch(url: string, body?: object | string | FormData, options?: RequestOptions): Promise<Response>;
+    patch(url: string, body?: object | string | FormData, options?: RequestOptions): ResponsePromise<unknown>;
     /**
      * Sends a PATCH request with JSON payload to the specified URL.
+     * The response will have the parsed JSON in `response.data`.
      *
      * @template T - The type of the response data.
      * @param {string} url - The URL to send the request to.
      * @param {object | string} [body] - The JSON payload to send with the request.
      * @param {RequestOptions} [options] - Additional options for the request.
-     * @returns {Promise<FetchClientResponse<T>>} - A promise that resolves to the response data.
+     * @returns A promise that resolves to the response with parsed JSON in `data`.
      */
     patchJSON<T>(url: string, body?: object | string, options?: RequestOptions): Promise<FetchClientResponse<T>>;
     /**
@@ -127,18 +133,28 @@ export declare class FetchClient {
      *
      * @param url - The URL to send the DELETE request to.
      * @param options - The options for the request.
-     * @returns A promise that resolves to a `FetchClientResponse` object.
+     * @returns A ResponsePromise that resolves to the response. Can use `.json<T>()` for typed JSON.
      */
-    delete(url: string, options?: RequestOptions): Promise<FetchClientResponse<unknown>>;
+    delete(url: string, options?: RequestOptions): ResponsePromise<unknown>;
     /**
      * Sends a DELETE request with JSON payload to the specified URL.
+     * The response will have the parsed JSON in `response.data`.
      *
      * @template T - The type of the response data.
      * @param {string} url - The URL to send the request to.
      * @param {RequestOptions} [options] - Additional options for the request.
-     * @returns {Promise<FetchClientResponse<T>>} - A promise that resolves to the response data.
+     * @returns A promise that resolves to the response with parsed JSON in `data`.
      */
     deleteJSON<T>(url: string, options?: RequestOptions): Promise<FetchClientResponse<T>>;
+    /**
+     * Sends a HEAD request to the specified URL.
+     * HEAD requests are identical to GET requests but without the response body.
+     *
+     * @param url - The URL to send the HEAD request to.
+     * @param options - The optional request options.
+     * @returns A ResponsePromise that resolves to the response.
+     */
+    head(url: string, options?: GetRequestOptions): ResponsePromise<void>;
     private validate;
     private fetchInternal;
     private invokeMiddleware;

package/types/src/FetchClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FetchClient.d.ts","sourceRoot":"","sources":["../../src/src/FetchClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FetchClient.d.ts","sourceRoot":"","sources":["../../src/src/FetchClient.ts"],"names":[],"mappings":"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"}

package/types/src/FetchClientError.d.ts

@@ -0,0 +1,29 @@
+import type { FetchClientResponse } from "./FetchClientResponse.js";
+/**
+ * Error wrapper for non-2xx responses.
+ * Exposes the underlying response for compatibility and debugging.
+ */
+export declare class FetchClientError extends Error {
+    readonly response: FetchClientResponse<unknown>;
+    constructor(response: FetchClientResponse<unknown>, message?: string);
+    get status(): number;
+    get statusText(): string;
+    get ok(): boolean;
+    get headers(): Headers;
+    get url(): string;
+    get redirected(): boolean;
+    get type(): ResponseType;
+    get body(): ReadableStream<Uint8Array> | null;
+    get bodyUsed(): boolean;
+    get data(): unknown;
+    get problem(): unknown;
+    get meta(): unknown;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    blob(): Promise<Blob>;
+    formData(): Promise<FormData>;
+    bytes(): Promise<Uint8Array>;
+    clone(): Response;
+}
+//# sourceMappingURL=FetchClientError.d.ts.map

package/types/src/FetchClientError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchClientError.d.ts","sourceRoot":"","sources":["../../src/src/FetchClientError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;gBAGrD,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC,EACtC,OAAO,CAAC,EAAE,MAAM;IAWlB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,EAAE,IAAI,OAAO,CAEhB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,IAAI,IAAI,YAAY,CAEvB;IAED,IAAI,IAAI,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAE5C;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAInC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IAK7B,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAK5B,KAAK,IAAI,QAAQ;CAGlB"}

package/types/src/FetchClientProvider.d.ts

@@ -9,6 +9,7 @@ import { type RateLimitMiddlewareOptions } from "./RateLimitMiddleware.js";
 import { type RateLimiter } from "./RateLimiter.js";
 import { type CircuitBreakerMiddlewareOptions } from "./CircuitBreakerMiddleware.js";
 import { type CircuitBreaker } from "./CircuitBreaker.js";
+import { type RetryMiddlewareOptions } from "./RetryMiddleware.js";
 type Fetch = typeof globalThis.fetch;
 /**
  * Represents a provider for creating instances of the FetchClient class with shared default options and cache.
@@ -127,6 +128,16 @@ export declare class FetchClientProvider {
      * Removes the circuit breaker middleware from all FetchClient instances created by this provider.
      */
     removeCircuitBreaker(): void;
+    /**
+     * Enables automatic retry for failed requests.
+     * Retries are performed with exponential backoff and jitter.
+     * @param options - The retry configuration options.
+     */
+    useRetry(options?: RetryMiddlewareOptions): void;
+    /**
+     * Removes the retry middleware from all FetchClient instances created by this provider.
+     */
+    removeRetry(): void;
 }
 export declare const defaultInstance: FetchClientProvider;
 export {};

package/types/src/FetchClientProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FetchClientProvider.d.ts","sourceRoot":"","sources":["../../src/src/FetchClientProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,KAAK,KAAK,GAAG,OAAO,UAAU,CAAC,KAAK,CAAC;AAErC;;GAEG;AACH,qBAAa,mBAAmB;;IAW9B;;;OAGG;gBACS,KAAK,CAAC,EAAE,KAAK;IAyBzB;;OAEG;IACH,IAAW,KAAK,IAAI,KAAK,GAAG,SAAS,CAEpC;IAED;;OAEG;IACH,IAAW,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAExC;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAE1C;IAED;;OAEG;IACH,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,kBAAkB,CAEvC;IAED;;OAEG;IACH,IAAW,OAAO,CAAC,KAAK,EAAE,kBAAkB,EAE3C;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,gBAAgB,CAEnC;IAED;;;;OAIG;IACI,cAAc,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW;IAchE;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,kBAAkB;IAO/C;;;OAGG;IACI,kBAAkB,CAAC,eAAe,EAAE,MAAM,MAAM,GAAG,IAAI;IAO9D;;;OAGG;IACI,iBAAiB,CACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAQpE;;;OAGG;IACI,UAAU,CAAC,GAAG,EAAE,MAAM;IAO7B;;;OAGG;IACI,aAAa,CAAC,UAAU,EAAE,qBAAqB;IAUtD;;;OAGG;IACI,YAAY,CAAC,OAAO,EAAE,0BAA0B;IAMvD;;;OAGG;IACI,qBAAqB,CAC1B,OAAO,EAAE,IAAI,CAAC,0BAA0B,EAAE,cAAc,CAAC;IAU3D;;;OAGG;IACH,IAAW,WAAW,IAAI,WAAW,GAAG,SAAS,CAEhD;IAED;;OAEG;IACI,eAAe;IAWtB;;;;;OAKG;IACI,iBAAiB,CAAC,OAAO,CAAC,EAAE,+BAA+B;IAOlE;;;;OAIG;IACI,0BAA0B,CAC/B,OAAO,CAAC,EAAE,IAAI,CAAC,+BAA+B,EAAE,cAAc,CAAC;IAWjE;;;OAGG;IACH,IAAW,cAAc,IAAI,cAAc,GAAG,SAAS,CAEtD;IAED;;OAEG;IACI,oBAAoB;CAU5B;AAGD,eAAO,MAAM,eAAe,EAAE,mBAA8B,CAAC"}
+{"version":3,"file":"FetchClientProvider.d.ts","sourceRoot":"","sources":["../../src/src/FetchClientProvider.ts"],"names":[],"mappings":"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"}