@foundatiofx/fetchclient 1.1.1 → 1.2.0

package/types/src/DefaultHelpers.d.ts

@@ -17,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>>;
 /**
@@ -27,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>>;
 /**
@@ -37,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>>;
 /**
@@ -47,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>>;
 /**
@@ -56,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>>;
 /**

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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"}

package/types/src/RateLimitMiddleware.d.ts

@@ -47,4 +47,31 @@ export declare class RateLimitMiddleware {
      */
     middleware(): FetchClientMiddleware;
 }
+/**
+ * Creates a rate limit middleware with the given options.
+ *
+ * @example
+ * ```typescript
+ * const client = new FetchClient();
+ * client.use(createRateLimitMiddleware({
+ *   maxRequests: 100,
+ *   windowSeconds: 60,
+ * }));
+ * ```
+ */
+export declare function createRateLimitMiddleware(options: RateLimitMiddlewareOptions): FetchClientMiddleware;
+/**
+ * Creates a per-domain rate limit middleware where each domain is tracked separately.
+ *
+ * @example
+ * ```typescript
+ * const client = new FetchClient();
+ * client.use(createPerDomainRateLimitMiddleware({
+ *   maxRequests: 100,
+ *   windowSeconds: 60,
+ * }));
+ * // api.example.com and api.other.com will have separate rate limits
+ * ```
+ */
+export declare function createPerDomainRateLimitMiddleware(options: RateLimitMiddlewareOptions): FetchClientMiddleware;
 //# sourceMappingURL=RateLimitMiddleware.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RateLimitMiddleware.d.ts","sourceRoot":"","sources":["../../src/src/RateLimitMiddleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,EAGL,WAAW,EACX,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;gBAE9B,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAW3E;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,mBAAmB;;IAG9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAU;gBAEpC,OAAO,EAAE,0BAA0B;IAO/C;;OAEG;IACH,IAAW,WAAW,IAAI,WAAW,CAEpC;IAED;;;OAGG;IACI,UAAU,IAAI,qBAAqB;CA8F3C"}
+{"version":3,"file":"RateLimitMiddleware.d.ts","sourceRoot":"","sources":["../../src/src/RateLimitMiddleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,EAIL,WAAW,EACX,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;gBAE9B,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAW3E;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,mBAAmB;;IAG9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAU;gBAEpC,OAAO,EAAE,0BAA0B;IAO/C;;OAEG;IACH,IAAW,WAAW,IAAI,WAAW,CAEpC;IAED;;;OAGG;IACI,UAAU,IAAI,qBAAqB;CA8F3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,qBAAqB,CAEvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,0BAA0B,GAClC,qBAAqB,CAKvB"}

package/types/src/ResponsePromise.d.ts

@@ -0,0 +1,93 @@
+import type { FetchClientResponse } from "./FetchClientResponse.js";
+import type { RequestOptions } from "./RequestOptions.js";
+/**
+ * A promise that resolves to a FetchClientResponse with additional helper methods
+ * for parsing the response body. This allows for a fluent API similar to ky:
+ *
+ * @example
+ * ```typescript
+ * // Await to get the full response
+ * const response = await client.get("/api/users");
+ *
+ * // Or use helper methods for direct access to parsed body
+ * const users = await client.get("/api/users").json<User[]>();
+ * const html = await client.get("/page").text();
+ * const file = await client.get("/file").blob();
+ * ```
+ */
+export declare class ResponsePromise<T = unknown> implements PromiseLike<FetchClientResponse<T>> {
+    #private;
+    constructor(responsePromise: Promise<FetchClientResponse<T>>, options?: RequestOptions);
+    /**
+     * Implements PromiseLike interface so the ResponsePromise can be awaited.
+     */
+    then<TResult1 = FetchClientResponse<T>, TResult2 = never>(onfulfilled?: ((value: FetchClientResponse<T>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    /**
+     * Catches any errors from the response promise.
+     */
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<FetchClientResponse<T> | TResult>;
+    /**
+     * Executes a callback when the promise settles (fulfilled or rejected).
+     */
+    finally(onfinally?: (() => void) | null): Promise<FetchClientResponse<T>>;
+    /**
+     * Parses the response body as JSON.
+     *
+     * If the response was already parsed as JSON (via getJSON, postJSON, etc.),
+     * returns the parsed data directly. Otherwise, parses the response body.
+     *
+     * @template TJson - The expected type of the JSON response
+     * @returns A promise that resolves to the parsed JSON
+     *
+     * @example
+     * ```typescript
+     * const user = await client.get("/api/user/1").json<User>();
+     * ```
+     */
+    json<TJson = T>(): Promise<TJson>;
+    /**
+     * Returns the response body as text.
+     *
+     * @returns A promise that resolves to the response text
+     *
+     * @example
+     * ```typescript
+     * const html = await client.get("/page").text();
+     * ```
+     */
+    text(): Promise<string>;
+    /**
+     * Returns the response body as a Blob.
+     *
+     * @returns A promise that resolves to the response as a Blob
+     *
+     * @example
+     * ```typescript
+     * const imageBlob = await client.get("/image.png").blob();
+     * ```
+     */
+    blob(): Promise<Blob>;
+    /**
+     * Returns the response body as an ArrayBuffer.
+     *
+     * @returns A promise that resolves to the response as an ArrayBuffer
+     *
+     * @example
+     * ```typescript
+     * const buffer = await client.get("/file").arrayBuffer();
+     * ```
+     */
+    arrayBuffer(): Promise<ArrayBuffer>;
+    /**
+     * Returns the response body as FormData.
+     *
+     * @returns A promise that resolves to the response as FormData
+     *
+     * @example
+     * ```typescript
+     * const formData = await client.get("/form").formData();
+     * ```
+     */
+    formData(): Promise<FormData>;
+}
+//# sourceMappingURL=ResponsePromise.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResponsePromise.d.ts","sourceRoot":"","sources":["../../src/src/ResponsePromise.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CACtC,YAAW,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;;gBAK5C,eAAe,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAChD,OAAO,CAAC,EAAE,cAAc;IAM1B;;OAEG;IACH,IAAI,CAAC,QAAQ,GAAG,mBAAmB,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,EACtD,WAAW,CAAC,EACR,CAAC,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GACrE,IAAI,EACR,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAC1E,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAI/B;;OAEG;IACH,KAAK,CAAC,OAAO,GAAG,KAAK,EACnB,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GACxE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAI5C;;OAEG;IACH,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAIzE;;;;;;;;;;;;;OAaG;IACG,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC;IAmBvC;;;;;;;;;OASG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B;;;;;;;;;OASG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAKzC;;;;;;;;;OASG;IACG,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;CAqDpC"}

package/types/src/RetryMiddleware.d.ts

@@ -0,0 +1,88 @@
+import type { FetchClientMiddleware } from "./FetchClientMiddleware.js";
+/**
+ * Configuration options for the retry middleware.
+ */
+export interface RetryMiddlewareOptions {
+    /**
+     * Maximum number of retry attempts.
+     * @default 2
+     */
+    limit?: number;
+    /**
+     * HTTP methods eligible for retry.
+     * @default ['GET', 'HEAD', 'PUT', 'DELETE', 'OPTIONS', 'TRACE']
+     */
+    methods?: string[];
+    /**
+     * HTTP status codes that trigger a retry.
+     * @default [408, 413, 429, 500, 502, 503, 504]
+     */
+    statusCodes?: number[];
+    /**
+     * Maximum value of Retry-After header to respect, in milliseconds.
+     * If Retry-After exceeds this value, the request will not be retried.
+     * @default Infinity
+     */
+    maxRetryAfter?: number;
+    /**
+     * Maximum backoff delay in milliseconds.
+     * @default 30000
+     */
+    backoffLimit?: number;
+    /**
+     * Custom delay function that receives the attempt number (0-indexed) and returns delay in ms.
+     * If not provided, exponential backoff is used: min(1000 * 2^attempt, backoffLimit)
+     */
+    delay?: (attemptNumber: number, response?: Response) => number;
+    /**
+     * Jitter fraction for randomizing delay.
+     * For example, 0.1 means +/- 10% randomization.
+     * @default 0.1
+     */
+    jitter?: number;
+    /**
+     * Custom predicate to determine if a request should be retried.
+     * Called after default checks pass. Return true to retry, false to stop.
+     */
+    shouldRetry?: (response: Response, attemptNumber: number) => boolean | Promise<boolean>;
+    /**
+     * Callback invoked before each retry attempt.
+     */
+    onRetry?: (attemptNumber: number, response: Response, delayMs: number) => void;
+}
+/**
+ * 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');
+ * ```
+ */
+export declare class RetryMiddleware {
+    #private;
+    constructor(options?: RetryMiddlewareOptions);
+    /**
+     * Creates the middleware function.
+     * @returns The middleware function
+     */
+    middleware(): FetchClientMiddleware;
+}
+/**
+ * Creates a retry middleware with the given options.
+ *
+ * @example
+ * ```typescript
+ * const client = new FetchClient();
+ * client.use(createRetryMiddleware({ limit: 3 }));
+ * ```
+ */
+export declare function createRetryMiddleware(options?: RetryMiddlewareOptions): FetchClientMiddleware;
+//# sourceMappingURL=RetryMiddleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RetryMiddleware.d.ts","sourceRoot":"","sources":["../../src/src/RetryMiddleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AA4BxE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,KAAK,MAAM,CAAC;IAE/D;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,WAAW,CAAC,EAAE,CACZ,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,KAClB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,OAAO,CAAC,EAAE,CACR,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;CACX;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;;gBAoBd,OAAO,CAAC,EAAE,sBAAsB;IAgB5C;;;OAGG;IACI,UAAU,IAAI,qBAAqB;CAuI3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CAEvB"}

package/types/src/mocks/MockHistory.d.ts

@@ -5,6 +5,7 @@ import type { MockHistory } from "./types.js";
 export declare class MockHistoryImpl implements MockHistory {
     #private;
     get get(): Request[];
+    get head(): Request[];
     get post(): Request[];
     get put(): Request[];
     get patch(): Request[];

package/types/src/mocks/MockHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockHistory.d.ts","sourceRoot":"","sources":["../../../src/src/mocks/MockHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;;IAQjD,IAAI,GAAG,IAAI,OAAO,EAAE,CAEnB;IAED,IAAI,IAAI,IAAI,OAAO,EAAE,CAEpB;IAED,IAAI,GAAG,IAAI,OAAO,EAAE,CAEnB;IAED,IAAI,KAAK,IAAI,OAAO,EAAE,CAErB;IAED,IAAI,MAAM,IAAI,OAAO,EAAE,CAEtB;IAED,IAAI,GAAG,IAAI,OAAO,EAAE,CAEnB;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAsB9B;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd"}
+{"version":3,"file":"MockHistory.d.ts","sourceRoot":"","sources":["../../../src/src/mocks/MockHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;;IASjD,IAAI,GAAG,IAAI,OAAO,EAAE,CAEnB;IAED,IAAI,IAAI,IAAI,OAAO,EAAE,CAEpB;IAED,IAAI,IAAI,IAAI,OAAO,EAAE,CAEpB;IAED,IAAI,GAAG,IAAI,OAAO,EAAE,CAEnB;IAED,IAAI,KAAK,IAAI,OAAO,EAAE,CAErB;IAED,IAAI,MAAM,IAAI,OAAO,EAAE,CAEtB;IAED,IAAI,GAAG,IAAI,OAAO,EAAE,CAEnB;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAyB9B;;OAEG;IACH,KAAK,IAAI,IAAI;CASd"}

package/types/src/mocks/MockRegistry.d.ts

@@ -38,6 +38,11 @@ export declare class MockRegistry {
      * @param url - URL string or RegExp to match
      */
     onGet(url: string | RegExp): MockResponseBuilder<MockRegistry>;
+    /**
+     * Creates a mock for HEAD requests matching the given URL.
+     * @param url - URL string or RegExp to match
+     */
+    onHead(url: string | RegExp): MockResponseBuilder<MockRegistry>;
     /**
      * Creates a mock for POST requests matching the given URL.
      * @param url - URL string or RegExp to match

package/types/src/mocks/MockRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockRegistry.d.ts","sourceRoot":"","sources":["../../../src/src/mocks/MockRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D,KAAK,KAAK,GAAG,OAAO,UAAU,CAAC,KAAK,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,YAAY;;IAMvB;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAI9D;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAI/D;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAI9D;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAIhE;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAIjE;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAoB9D;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI;IAyBxD;;OAEG;IACH,OAAO,IAAI,IAAI;IAkIf;;OAEG;IACH,IAAI,OAAO,IAAI,WAAW,CAEzB;IAED;;;;;;;;;;;;;;;OAeG;IACH,IAAI,KAAK,IAAI,KAAK,CAOjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,YAAY,IAAI,IAAI;CAGrB"}
+{"version":3,"file":"MockRegistry.d.ts","sourceRoot":"","sources":["../../../src/src/mocks/MockRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D,KAAK,KAAK,GAAG,OAAO,UAAU,CAAC,KAAK,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,YAAY;;IAMvB;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAI9D;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAI/D;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAI/D;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAI9D;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAIhE;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAIjE;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC;IAoB9D;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI;IAyBxD;;OAEG;IACH,OAAO,IAAI,IAAI;IAkIf;;OAEG;IACH,IAAI,OAAO,IAAI,WAAW,CAEzB;IAED;;;;;;;;;;;;;;;OAeG;IACH,IAAI,KAAK,IAAI,KAAK,CAOjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,YAAY,IAAI,IAAI;CAGrB"}

package/types/src/mocks/types.d.ts

@@ -33,6 +33,8 @@ export interface MockDefinition {
 export interface MockHistory {
     /** GET requests */
     readonly get: Request[];
+    /** HEAD requests */
+    readonly head: Request[];
     /** POST requests */
     readonly post: Request[];
     /** PUT requests */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/mocks/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iDAAiD;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,oDAAoD;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;IACxB,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;IACxB,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/mocks/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iDAAiD;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,oDAAoD;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;IACxB,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACzB,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;IACxB,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;CACzB"}

package/types/src/tests/RetryMiddleware.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryMiddleware.test.d.ts","sourceRoot":"","sources":["../../../src/src/tests/RetryMiddleware.test.ts"],"names":[],"mappings":""}