@gcmdev/faxios 0.1.0 → 0.2.1

package/dist/lib/helpers/sanitizeHeaderValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeHeaderValue.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/sanitizeHeaderValue.ts"],"names":[],"mappings":"AA8CA,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,sBACQ,CAAC;AAK3D,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAAE,2BAQ3F"}

package/dist/lib/helpers/speedometer.d.ts

@@ -6,3 +6,4 @@
  */
 declare function speedometer(samplesCount?: number, min?: number): (chunkLength: number) => number | undefined;
 export default speedometer;
+//# sourceMappingURL=speedometer.d.ts.map

package/dist/lib/helpers/speedometer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speedometer.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/speedometer.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,iBAAS,WAAW,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CA4CrG;AAED,eAAe,WAAW,CAAC"}

package/dist/lib/helpers/substitutePathParams.d.ts

@@ -1,2 +1,3 @@
 /** Expects raw (unencoded) param values — applies encodeURIComponent here. */
 export declare function substitutePathParams(url: string, params: Record<string, unknown>): string;
+//# sourceMappingURL=substitutePathParams.d.ts.map

package/dist/lib/helpers/substitutePathParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"substitutePathParams.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/substitutePathParams.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAWzF"}

package/dist/lib/helpers/throttle.d.ts

@@ -6,3 +6,4 @@
  */
 declare function throttle(fn: (...args: Array<unknown>) => void, freq: number): [(...args: Array<unknown>) => void, () => void];
 export default throttle;
+//# sourceMappingURL=throttle.d.ts.map

package/dist/lib/helpers/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/throttle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,iBAAS,QAAQ,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC,CAoCtH;AAED,eAAe,QAAQ,CAAC"}

package/dist/lib/helpers/toFormData.d.ts

@@ -24,3 +24,4 @@ export declare const DEFAULT_FORM_DATA_MAX_DEPTH = 100;
  */
 declare function toFormData(obj: unknown, formData?: GenericFormData | null, options?: Record<string, unknown>): GenericFormData;
 export default toFormData;
+//# sourceMappingURL=toFormData.d.ts.map

package/dist/lib/helpers/toFormData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toFormData.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/toFormData.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAA6C,oBAAoB;AAK9F,eAAO,MAAM,2BAA2B,MAAM,CAAC;AA2D/C;;;;;;;;;;;;IAYI;AAEJ;;;;;;;;GAQG;AACH,iBAAS,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CA0MvH;AAED,eAAe,UAAU,CAAC"}

package/dist/lib/helpers/toURLEncodedForm.d.ts

@@ -1,2 +1,3 @@
 import type { GenericFormData } from "../types.js";
 export default function toURLEncodedForm(data: unknown, options?: Record<string, unknown>): GenericFormData;
+//# sourceMappingURL=toURLEncodedForm.d.ts.map

package/dist/lib/helpers/toURLEncodedForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toURLEncodedForm.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/toURLEncodedForm.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB;AAGnD,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,mBAOxF"}

package/dist/lib/helpers/trackStream.d.ts

@@ -1 +1,2 @@
 export declare const trackStream: (stream: unknown, chunkSize: number | undefined, onProgress?: ((bytes: number) => void) | null, onFinish?: ((err?: unknown) => void) | null) => unknown;
+//# sourceMappingURL=trackStream.d.ts.map

package/dist/lib/helpers/trackStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackStream.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/trackStream.ts"],"names":[],"mappings":"AA6EA,eAAO,MAAM,WAAW,GAAI,QAAQ,OAAO,EAAE,WAAW,MAAM,GAAG,SAAS,EAAE,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,KAAG,OA6CxK,CAAC"}

package/dist/lib/helpers/validator.d.ts

@@ -14,3 +14,4 @@ declare const _default: {
     validators: Record<string, ValidatorFn | undefined>;
 };
 export default _default;
+//# sourceMappingURL=validator.d.ts.map

package/dist/lib/helpers/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/validator.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,MAAM,CAAC;AAmE7F;;;;;;;;GAQG;AAEH,iBAAS,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CA0BrH;;;;;AAED,wBAGE"}

package/dist/lib/platform.d.ts

@@ -6,7 +6,7 @@ declare const _default: {
             new (init?: string[][] | Record<string, string> | string | URLSearchParams): URLSearchParams;
             prototype: URLSearchParams;
         } | typeof FaxiosURLSearchParams;
-        FormData: (new (...args: Array<unknown>) => object) | null;
+        FormData: (new () => object) | null;
         Blob: (new (...args: Array<unknown>) => object) | null;
     };
     protocols: string[];
@@ -20,3 +20,4 @@ declare const _default: {
     origin: string;
 };
 export default _default;
+//# sourceMappingURL=platform.d.ts.map

package/dist/lib/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/lib/platform.ts"],"names":[],"mappings":"AAEA,OAAO,qBAAqB,2CAA2C;;;;;;;;6BAQhD,MAAM;6BACN,KAAK,CAAC,OAAO,CAAC,KAAK,MAAM;;;;;;;kBAJtB,MAAM;oBAAc,MAAM;;;;AAuBpD,wBAaE"}

package/dist/lib/plugins/attempt.d.ts

@@ -0,0 +1,2 @@
+export declare const RETRY_ATTEMPT: unique symbol;
+//# sourceMappingURL=attempt.d.ts.map

package/dist/lib/plugins/attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../../../src/lib/plugins/attempt.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,EAAE,OAAO,MAAuC,CAAC"}

package/dist/lib/plugins/attempt.js

@@ -0,0 +1,4 @@
+// Shared only by the built-in plugins; not exported from any entry point. retry writes the number
+// of the try it is about to make under this key of ctx.state, and timing reads it.
+export const RETRY_ATTEMPT = Symbol("faxios.retry.attempt");
+//# sourceMappingURL=attempt.js.map

package/dist/lib/plugins/attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.js","sourceRoot":"","sources":["../../../src/lib/plugins/attempt.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,mFAAmF;AACnF,MAAM,CAAC,MAAM,aAAa,GAAkB,MAAM,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/lib/plugins/authBearer.d.ts

@@ -0,0 +1,31 @@
+import type { FaxiosPlugin } from "../types.js";
+/** What `authBearer` provides to plugins installed after it. */
+export type AuthBearerCapability = {
+    auth: {
+        getToken: () => Promise<string>;
+    };
+};
+export type AuthBearerOptions = {
+    /** Replace a header the request already has. Default `false`: an explicit header is kept. */
+    overwrite?: boolean;
+    /** Put before the token, separated by a space. Default `"Bearer"`; `""` sends the bare token. */
+    scheme?: string;
+    /** The header to set. Default `"Authorization"`. */
+    header?: string;
+    /**
+     * The origins (`"https://api.example.com"`) that get the token, replacing the default rule:
+     * with an absolute `baseURL`, only its origin; otherwise only relative request URLs.
+     */
+    origins?: Array<string>;
+};
+/**
+ * Sets `Authorization: Bearer <token>` on requests to the API it guards, asking `getToken` each
+ * time, and provides the `auth` capability so later plugins (for example a token-refresh plugin)
+ * can ask for a token too. A header the request already has is kept unless `overwrite` is set.
+ * The token goes only to the `baseURL` origin when `baseURL` is absolute, otherwise only to
+ * relative request URLs; `origins` replaces that rule.
+ */
+export declare function authBearer(getToken: () => string | Promise<string>, options?: AuthBearerOptions): FaxiosPlugin<{
+    provides: AuthBearerCapability;
+}>;
+//# sourceMappingURL=authBearer.d.ts.map

package/dist/lib/plugins/authBearer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authBearer.d.ts","sourceRoot":"","sources":["../../../src/lib/plugins/authBearer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAA+B,oBAAoB;AAI7E,gEAAgE;AAChE,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;KAAE,CAAC;CAAE,CAAC;AAEnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,6FAA6F;IAC7F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACzB,CAAC;AA6DF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAE,iBAAsB,GAAG,YAAY,CAAC;IAAE,QAAQ,EAAE,oBAAoB,CAAC;CAAE,CAAC,CA6BvJ"}

package/dist/lib/plugins/authBearer.js

@@ -0,0 +1,99 @@
+// @ts-self-types="./authBearer.d.ts" — required for Deno: maps built .js to adjacent .d.ts in dist/
+import buildFullPath from "../core/buildFullPath.js";
+import FaxiosError from "../core/FaxiosError.js";
+import FaxiosHeaders from "../core/FaxiosHeaders.js";
+import isAbsoluteURL from "../helpers/isAbsoluteURL.js";
+import validator from "../helpers/validator.js";
+import utils from "../utils.js";
+import { definePlugin } from "./definePlugin.js";
+// A header name is a token (RFC 9110 §5.6.2).
+const TOKEN = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+// A bare origin, optionally with a trailing slash. A path would look like a narrower limit than
+// the origin the token is really sent to.
+function originOf(value) {
+    if (typeof value !== "string")
+        return null;
+    try {
+        const { origin } = new URL(value);
+        return origin !== "null" && (value === origin || value === `${origin}/`) ? origin : null;
+    }
+    catch {
+        return null;
+    }
+}
+const optionsSchema = {
+    overwrite: validator.validators["boolean"],
+    scheme: (value) => (typeof value === "string" && !/[\r\n]/.test(value)) || "a string without line breaks",
+    header: (value) => (typeof value === "string" && TOKEN.test(value)) || "a header name",
+    origins: (value) => (Array.isArray(value) && value.every(o => originOf(o) !== null)) || "an array of origins such as \"https://api.example.com\"",
+};
+const own = (source, key) => (utils.hasOwnProp(source, key) ? source[key] : undefined);
+// Resolves a relative URL the way a page would, without ever matching a real origin, so a URL
+// that leaves the page (`//host`, `/\host`) is told apart from one that stays on it.
+const SAME_ORIGIN = "https://same-origin.invalid";
+function resolvedOrigin(url, base) {
+    try {
+        return new URL(url, base).origin;
+    }
+    catch {
+        return null;
+    }
+}
+// A relative URL goes to the page's origin, which only a browser has.
+function pageHref() {
+    const location = "location" in globalThis ? globalThis.location : undefined;
+    if (location && typeof location === "object" && "href" in location && typeof location.href === "string")
+        return location.href;
+    return undefined;
+}
+function sendsTokenTo(config, origins) {
+    const baseURL = own(config, "baseURL");
+    const url = buildFullPath(baseURL, own(config, "url"), own(config, "allowAbsoluteUrls"), config);
+    if (origins) {
+        const origin = resolvedOrigin(url, isAbsoluteURL(url) ? undefined : pageHref());
+        return origin !== null && origins.includes(origin);
+    }
+    if (typeof baseURL === "string" && isAbsoluteURL(baseURL)) {
+        return resolvedOrigin(url, baseURL) === resolvedOrigin(baseURL, undefined);
+    }
+    return !isAbsoluteURL(url) && resolvedOrigin(url, SAME_ORIGIN) === SAME_ORIGIN;
+}
+/**
+ * Sets `Authorization: Bearer <token>` on requests to the API it guards, asking `getToken` each
+ * time, and provides the `auth` capability so later plugins (for example a token-refresh plugin)
+ * can ask for a token too. A header the request already has is kept unless `overwrite` is set.
+ * The token goes only to the `baseURL` origin when `baseURL` is absolute, otherwise only to
+ * relative request URLs; `origins` replaces that rule.
+ */
+export function authBearer(getToken, options = {}) {
+    if (typeof getToken !== "function") {
+        throw new FaxiosError("authBearer: getToken must be a function", FaxiosError.ERR_BAD_OPTION_VALUE);
+    }
+    // Callers without TypeScript can pass anything.
+    const given = options;
+    if (given === null || typeof given !== "object") {
+        throw new FaxiosError("authBearer options must be an object", FaxiosError.ERR_BAD_OPTION_VALUE);
+    }
+    validator.assertOptions(options, optionsSchema, false);
+    const overwrite = own(options, "overwrite") ?? false;
+    const scheme = own(options, "scheme") ?? "Bearer";
+    const header = own(options, "header") ?? "Authorization";
+    const origins = own(options, "origins")?.map(o => originOf(o)) ?? null;
+    const auth = { getToken: async () => getToken() };
+    return definePlugin({
+        name: "authBearer",
+        provides: { auth },
+        middleware: async (ctx, next) => {
+            if ((!overwrite && ctx.config.headers.has(header)) || !sendsTokenTo(ctx.config, origins))
+                return next(ctx);
+            const token = await auth.getToken();
+            // On a copy: middleware that calls next() again (retry installed before this plugin) comes
+            // back through here without the header, so every try asks for a fresh token.
+            const headers = new FaxiosHeaders(ctx.config.headers).set(header, scheme ? `${scheme} ${token}` : token, true);
+            const config = { ...ctx.config };
+            config.headers = headers;
+            return next({ ...ctx, config });
+        },
+    });
+}
+//# sourceMappingURL=authBearer.js.map

package/dist/lib/plugins/authBearer.js.map

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

package/dist/lib/plugins/definePlugin.d.ts

@@ -0,0 +1,22 @@
+import type { FaxiosMiddleware, FaxiosPlugin } from "../types.js";
+type Slot<T> = [keyof T] extends [never] ? unknown : T;
+type RequiredCapabilities<TCapabilities, TProvides> = [keyof TProvides] extends [never] ? Slot<TCapabilities> : Slot<{
+    [K in keyof TCapabilities as K extends keyof TProvides ? never : K]: TCapabilities[K];
+}>;
+/**
+ * Builds a plugin for `use()` and infers its `FaxiosPlugin` slots from the object: `provides` from
+ * the `provides` value, `options` and `requires` from the context type the middleware annotates
+ * (`ctx: FaxiosContext<Options, Capabilities>`). Capabilities the plugin provides itself don't
+ * count as required. Returns the same object.
+ */
+export declare function definePlugin<TProvides = {}, TOptions = {}, TCapabilities = TProvides>(plugin: {
+    name: string;
+    provides?: TProvides & NoInfer<Pick<TCapabilities, keyof TProvides & keyof TCapabilities>>;
+    middleware: FaxiosMiddleware<TOptions, TCapabilities>;
+}): FaxiosPlugin<{
+    requires: RequiredCapabilities<TCapabilities, TProvides>;
+    provides: Slot<TProvides>;
+    options: Slot<TOptions>;
+}>;
+export {};
+//# sourceMappingURL=definePlugin.d.ts.map

package/dist/lib/plugins/definePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definePlugin.d.ts","sourceRoot":"","sources":["../../../src/lib/plugins/definePlugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,oBAAoB;AAGlE,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;AAGvD,KAAK,oBAAoB,CAAC,aAAa,EAAE,SAAS,IAAI,CAAC,MAAM,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,GACnF,IAAI,CAAC,aAAa,CAAC,GACnB,IAAI,CAAC;KAAG,CAAC,IAAI,MAAM,aAAa,IAAI,CAAC,SAAS,MAAM,SAAS,GAAG,KAAK,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;CAAG,CAAC,CAAC;AAErG;;;;;GAKG;AAEH,wBAAgB,YAAY,CAAC,SAAS,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,aAAa,GAAG,SAAS,EAAE,MAAM,EAAE;IAC7F,IAAI,EAAE,MAAM,CAAC;IAGb,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,CAAC,CAAC;IAC3F,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;CACvD,GAAG,YAAY,CAAC;IACf,QAAQ,EAAE,oBAAoB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACzD,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;CACzB,CAAC,CAGD"}

package/dist/lib/plugins/definePlugin.js

@@ -0,0 +1,14 @@
+// @ts-self-types="./definePlugin.d.ts" — required for Deno: maps built .js to adjacent .d.ts in dist/
+// The `@gcmdev/faxios/plugins` entry point. The built-in plugins have their own subpaths.
+/**
+ * Builds a plugin for `use()` and infers its `FaxiosPlugin` slots from the object: `provides` from
+ * the `provides` value, `options` and `requires` from the context type the middleware annotates
+ * (`ctx: FaxiosContext<Options, Capabilities>`). Capabilities the plugin provides itself don't
+ * count as required. Returns the same object.
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- `{}`: no capabilities or options, as in FaxiosContext
+export function definePlugin(plugin) {
+    // Only the types change: use() reads the fields at install time, as it does for any plugin.
+    return plugin;
+}
+//# sourceMappingURL=definePlugin.js.map

package/dist/lib/plugins/definePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definePlugin.js","sourceRoot":"","sources":["../../../src/lib/plugins/definePlugin.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,0FAA0F;AAY1F;;;;;GAKG;AACH,4HAA4H;AAC5H,MAAM,UAAU,YAAY,CAA2D,MAMtF;IAKC,4FAA4F;IAC5F,OAAO,MAAe,CAAC;AACzB,CAAC"}

package/dist/lib/plugins/retry.d.ts

@@ -0,0 +1,66 @@
+import type { FaxiosPlugin, Method } from "../types.js";
+export type RetryOptions = {
+    /** Total tries, counting the first request. Default 3. */
+    attempts?: number;
+    /**
+     * Whether the try that just failed should be retried. `attempt` counts from 1.
+     * Default: network errors, timeouts and the `statuses`; never a cancellation. A custom `retryOn`
+     * replaces that whole predicate, so `statuses` is ignored when both are set. retryOn decides
+     * only within `methods`; to retry POST, list it in `methods`.
+     */
+    retryOn?: (error: unknown, attempt: number) => boolean;
+    /**
+     * Response statuses the default predicate retries. Default 408, 429, 500, 502, 503 and 504.
+     * Ignored when `retryOn` is set.
+     */
+    statuses?: ReadonlyArray<number>;
+    /**
+     * Milliseconds to wait before the next try, or a function of the try that failed. Default 100ms,
+     * doubling. Capped at `maxDelay`, then jittered. A 429 or 503 with a `Retry-After` header waits
+     * that long instead, unless `respectRetryAfter` is `false`.
+     */
+    delay?: number | ((attempt: number, error: unknown) => number);
+    /** The most the computed backoff waits, in milliseconds. Default 30 000. Doesn't apply to `Retry-After`. */
+    maxDelay?: number;
+    /**
+     * `"full"` (default) waits a random time between 0 and the capped backoff, so clients that failed
+     * together don't retry together; `"none"` waits the capped backoff. Doesn't apply to `Retry-After`.
+     */
+    jitter?: "full" | "none";
+    /**
+     * The longest `Retry-After` (seconds or an HTTP date, on a 429 or 503) to wait, in milliseconds.
+     * Default 300 000 (5 minutes). A longer one rejects with the response's error instead of retrying.
+     * Ignored when `respectRetryAfter` is `false`.
+     */
+    maxRetryAfter?: number;
+    /**
+     * Whether a 429 or 503's `Retry-After` header sets the wait. Default `true`. With `false`, every
+     * retry waits the computed backoff and `maxRetryAfter` doesn't apply; which requests retry doesn't
+     * change. Turn it off when another plugin, such as a queue throttle, honours `Retry-After` itself.
+     */
+    respectRetryAfter?: boolean;
+    /**
+     * Called before each wait with the error, the try that failed and the wait in milliseconds. If it
+     * throws, the request rejects with that error and stops retrying.
+     */
+    onRetry?: (error: unknown, attempt: number, delayMs: number) => void;
+    /**
+     * HTTP methods that may be retried, in any case. Default: GET, HEAD, OPTIONS, PUT, DELETE and
+     * QUERY. POST and PATCH aren't idempotent, so add them only if your API dedupes repeats. A request
+     * whose method isn't listed is never retried, whatever `retryOn` or `statuses` say.
+     */
+    methods?: ReadonlyArray<Method>;
+};
+/** Per-request override: `false` turns retries off, an object overrides the plugin's options. */
+export type RetryRequestOptions = {
+    retry?: RetryOptions | false;
+};
+/**
+ * Retries failed requests by calling `next` again. Each `next` dispatches its own copy of the
+ * config, so every try starts from the same input. Install it inside middleware that should run
+ * once per request (for example `timing` installed first measures all tries together).
+ */
+export declare function retry(options?: RetryOptions): FaxiosPlugin<{
+    options: RetryRequestOptions;
+}>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/lib/plugins/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/lib/plugins/retry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAiB,YAAY,EAAwE,MAAM,EAAE,oBAAoB;AAgD7I,MAAM,MAAM,YAAY,GAAG;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACvD;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC;IAC/D,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,iGAAiG;AACjG,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;CAAE,CAAC;AAkGpE;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,YAAY,CAAC;IAAE,OAAO,EAAE,mBAAmB,CAAC;CAAE,CAAC,CAiCjG"}

package/dist/lib/plugins/retry.js

@@ -0,0 +1,168 @@
+// @ts-self-types="./retry.d.ts" — required for Deno: maps built .js to adjacent .d.ts in dist/
+import CanceledError from "../cancel/CanceledError.js";
+import isCancel from "../cancel/isCancel.js";
+import FaxiosError from "../core/FaxiosError.js";
+import validator from "../helpers/validator.js";
+import utils from "../utils.js";
+import { RETRY_ATTEMPT } from "./attempt.js";
+import { definePlugin } from "./definePlugin.js";
+// Config values are read as own properties only (repo rule for possibly untrusted input).
+const ownValue = (source, key) => (utils.hasOwnProp(source, key) ? source[key] : undefined);
+const isWait = (ms) => typeof ms === "number" && Number.isFinite(ms) && ms >= 0;
+// An HTTP method is a token (RFC 9110 §9.1, §5.6.2); anything else can never match a request.
+const TOKEN = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+const isStatus = (value) => Number.isInteger(value) && value >= 100 && value <= 599;
+// Bounded on purpose: NaN or Infinity would make a failing request loop forever.
+const optionsSchema = {
+    attempts: (value) => (Number.isInteger(value) && value >= 1) || "an integer of at least 1",
+    retryOn: validator.validators["function"],
+    delay: (value) => isWait(value) || typeof value === "function" || "a finite number of at least 0 or a function",
+    methods: (value) => (Array.isArray(value) && value.every(m => typeof m === "string" && TOKEN.test(m))) || "an array of HTTP method names",
+    statuses: (value) => (Array.isArray(value) && value.every(isStatus)) || "an array of HTTP status codes (100-599)",
+    maxRetryAfter: (value) => isWait(value) || "a finite number of milliseconds of at least 0",
+    maxDelay: (value) => isWait(value) || "a finite number of milliseconds of at least 0",
+    jitter: (value) => value === "full" || value === "none" || "\"full\" or \"none\"",
+    respectRetryAfter: validator.validators["boolean"],
+    onRetry: validator.validators["function"],
+};
+// Transient failures: timeout, rate limit, and server errors that may clear on their own. 501 and
+// 505 mean the server will never handle the request, so they aren't here.
+const DEFAULT_STATUSES = [408, 429, 500, 502, 503, 504];
+// Statuses whose Retry-After says when to try again (RFC 9110 §10.2.3).
+const RETRY_AFTER_STATUSES = [429, 503];
+// Methods whose repeat has the same effect as one request (RFC 9110 §9.2.2, plus QUERY).
+const IDEMPOTENT_METHODS = ["get", "head", "options", "put", "delete", "query"];
+// One check for both the factory argument and a per-request override.
+function assertRetryOptions(value, config) {
+    if (value === null || typeof value !== "object") {
+        throw new FaxiosError("retry options must be an object", FaxiosError.ERR_BAD_OPTION_VALUE, config);
+    }
+    validator.assertOptions(value, optionsSchema, false);
+}
+function retryByDefault(error, statuses) {
+    if (isCancel(error) || !(error instanceof FaxiosError))
+        return false;
+    if (error.code === FaxiosError.ERR_NETWORK || error.code === FaxiosError.ETIMEDOUT)
+        return true;
+    const status = error.response?.status;
+    return status !== undefined && statuses.includes(status);
+}
+// The wait a 429 or 503 asks for, in milliseconds: delay-seconds or an HTTP date (a past date
+// means now). undefined when there's no usable header, so the computed backoff applies.
+function retryAfterMs(error) {
+    if (!(error instanceof FaxiosError) || !error.response || !RETRY_AFTER_STATUSES.includes(error.response.status))
+        return undefined;
+    const value = error.response.headers.get("retry-after");
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    if (/^\d+$/.test(trimmed))
+        return Number(trimmed) * 1000;
+    const date = Date.parse(trimmed);
+    return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());
+}
+const doublingDelay = (attempt) => 100 * 2 ** (attempt - 1);
+// A stream is consumed by the first try, so sending it again would send nothing.
+// The same stream checks the fetch adapter uses: web ReadableStreams and Node-style pipe streams.
+function canReplay(data) {
+    return !utils.isReadableStream?.(data) && !utils.isStream(data);
+}
+function wait(ms, signal, config) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new CanceledError(null, config));
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener?.("abort", onAbort);
+            reject(new CanceledError(null, config));
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener?.("abort", onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener?.("abort", onAbort);
+    });
+}
+// Each list is lower-cased right after it is validated: the plugin's once, a per-request override's
+// on the request that carries it.
+function retriesMethod(config, perRequest, pluginMethods) {
+    const requestMethods = perRequest ? ownValue(perRequest, "methods")?.map(m => m.toLowerCase()) : undefined;
+    const methods = requestMethods ?? pluginMethods ?? IDEMPOTENT_METHODS;
+    return methods.includes(String(ownValue(config, "method") ?? "get").toLowerCase());
+}
+// Per field, request first: no merged object, and only own properties count.
+function resolvePolicy(options, perRequest) {
+    const setting = (key) => (perRequest ? ownValue(perRequest, key) : undefined) ?? ownValue(options, key);
+    const statuses = setting("statuses") ?? DEFAULT_STATUSES;
+    return {
+        attempts: setting("attempts") ?? 3,
+        retryOn: setting("retryOn") ?? ((error) => retryByDefault(error, statuses)),
+        delay: setting("delay") ?? doublingDelay,
+        maxDelay: setting("maxDelay") ?? 30_000,
+        jitter: setting("jitter") ?? "full",
+        maxRetryAfter: setting("maxRetryAfter") ?? 300_000,
+        respectRetryAfter: setting("respectRetryAfter") ?? true,
+        onRetry: setting("onRetry"),
+    };
+}
+// How long to wait before the next try, or undefined when the server's Retry-After is longer
+// than the caller is willing to wait, so the error is rethrown.
+function waitBeforeRetry(error, attempt, policy, config) {
+    const retryAfter = policy.respectRetryAfter ? retryAfterMs(error) : undefined;
+    if (retryAfter !== undefined)
+        return retryAfter > policy.maxRetryAfter ? undefined : retryAfter;
+    const computed = typeof policy.delay === "function" ? policy.delay(attempt, error) : policy.delay;
+    if (!isWait(computed)) {
+        throw new FaxiosError(`retry: delay must give a finite number of at least 0, got ${String(computed)}`, FaxiosError.ERR_BAD_OPTION_VALUE, config);
+    }
+    const capped = Math.min(computed, policy.maxDelay);
+    // Jitter only spreads out clients that failed together; it needs no unpredictability.
+    // eslint-disable-next-line sonarjs/pseudo-random -- see above
+    return policy.jitter === "full" ? Math.floor(Math.random() * capped) : capped;
+}
+/**
+ * Retries failed requests by calling `next` again. Each `next` dispatches its own copy of the
+ * config, so every try starts from the same input. Install it inside middleware that should run
+ * once per request (for example `timing` installed first measures all tries together).
+ */
+export function retry(options = {}) {
+    assertRetryOptions(options);
+    // Lower-cased once here, so requests compare names without re-casing the list.
+    const pluginMethods = ownValue(options, "methods")?.map(m => m.toLowerCase());
+    return definePlugin({
+        name: "retry",
+        middleware: async (ctx, next) => {
+            const perRequest = ownValue(ctx.config, "retry");
+            if (perRequest === false)
+                return next(ctx);
+            if (perRequest !== undefined)
+                assertRetryOptions(perRequest, ctx.config);
+            const policy = resolvePolicy(options, perRequest);
+            if (!retriesMethod(ctx.config, perRequest, pluginMethods))
+                return next(ctx);
+            // Tries run one after another on purpose: each must finish before deciding on the next.
+            for (let attempt = 1;; attempt++) {
+                // For timing: the try number, read after next() settles.
+                ctx.state[RETRY_ATTEMPT] = attempt;
+                try {
+                    // eslint-disable-next-line no-await-in-loop -- see above
+                    return await next(ctx);
+                }
+                catch (error) {
+                    if (attempt >= policy.attempts || !canReplay(ownValue(ctx.config, "data")) || !policy.retryOn(error, attempt))
+                        throw error;
+                    const ms = waitBeforeRetry(error, attempt, policy, ctx.config);
+                    if (ms === undefined)
+                        throw error;
+                    // A throwing hook rejects the request with its own error, before any wait.
+                    policy.onRetry?.(error, attempt, ms);
+                    // eslint-disable-next-line no-await-in-loop -- see above
+                    await wait(ms, ownValue(ctx.config, "signal"), ctx.config);
+                }
+            }
+        },
+    });
+}
+//# sourceMappingURL=retry.js.map

package/dist/lib/plugins/retry.js.map

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

package/dist/lib/plugins/timing.d.ts

@@ -0,0 +1,32 @@
+import type { FaxiosPlugin } from "../types.js";
+/**
+ * What `timing` reports once per request: `status` on success, `error` on failure. No config,
+ * headers or body, so an event is safe to log.
+ */
+export type TimingEvent = {
+    /** The request method, upper-cased (`"GET"`). */
+    method: string;
+    /** The full request URL without its query string and fragment. */
+    url: string;
+    /**
+     * The try number from `retry`: each try's when installed after it, the final try's when
+     * installed before it. Absent without `retry`.
+     */
+    attempt?: number;
+    durationMs: number;
+} & ({
+    status: number;
+    error?: undefined;
+} | {
+    status?: undefined;
+    error: unknown;
+});
+/**
+ * Measures the time around `next` and calls `onTiming` once per request with the method, URL,
+ * duration and status or error. Installed before `retry`, the duration covers every try;
+ * installed after it, each try is reported. The response is returned unchanged. If `onTiming`
+ * throws while reporting a failure, the request still rejects with its own error; while
+ * reporting a success, its error rejects the request.
+ */
+export declare function timing(onTiming: (event: TimingEvent) => void): FaxiosPlugin;
+//# sourceMappingURL=timing.d.ts.map

package/dist/lib/plugins/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../src/lib/plugins/timing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,YAAY,EAAE,oBAAoB;AAK/D;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAAE,GAAG;IAAE,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;CAAE,CAAC,CAAC;AAsBvF;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,YAAY,CAuB3E"}