@pureq/pureq 1.0.0

package/dist/src/middleware/httpCache.js.map

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

package/dist/src/middleware/idempotencyKey.d.ts

@@ -0,0 +1,12 @@
+import type { Middleware, RequestConfig } from "../types/http";
+export interface IdempotencyKeyOptions {
+    readonly methods?: readonly RequestConfig["method"][];
+    readonly headerName?: string;
+    readonly onlyIfBodyPresent?: boolean;
+    readonly keyFactory?: () => string;
+}
+/**
+ * Adds idempotency key headers for mutation requests when absent.
+ */
+export declare function idempotencyKey(options?: IdempotencyKeyOptions): Middleware;
+//# sourceMappingURL=idempotencyKey.d.ts.map

package/dist/src/middleware/idempotencyKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyKey.d.ts","sourceRoot":"","sources":["../../../src/middleware/idempotencyKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG/D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,UAAU,CAkC9E"}

package/dist/src/middleware/idempotencyKey.js

@@ -0,0 +1,33 @@
+import { generateSecureId } from "../utils/crypto";
+/**
+ * Adds idempotency key headers for mutation requests when absent.
+ */
+export function idempotencyKey(options = {}) {
+    const methods = new Set(options.methods ?? ["POST", "PUT", "PATCH", "DELETE"]);
+    const headerName = options.headerName ?? "Idempotency-Key";
+    const onlyIfBodyPresent = options.onlyIfBodyPresent ?? false;
+    const keyFactory = options.keyFactory ?? (() => generateSecureId("idem"));
+    return async (req, next) => {
+        if (!methods.has(req.method)) {
+            return next(req);
+        }
+        if (onlyIfBodyPresent && req.body === undefined) {
+            return next(req);
+        }
+        // Use case-insensitive header lookup to avoid double-setting
+        const existingHeaderValue = req.headers &&
+            Object.entries(req.headers).find(([k]) => k.toLowerCase() === headerName.toLowerCase())?.[1];
+        if (existingHeaderValue) {
+            return next(req);
+        }
+        const nextReq = {
+            ...req,
+            headers: {
+                ...(req.headers ?? {}),
+                [headerName]: keyFactory(),
+            },
+        };
+        return next(nextReq);
+    };
+}
+//# sourceMappingURL=idempotencyKey.js.map

package/dist/src/middleware/idempotencyKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyKey.js","sourceRoot":"","sources":["../../../src/middleware/idempotencyKey.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AASnD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAAiC,EAAE;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAC3D,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,KAAK,CAAC;IAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1E,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QAED,IAAI,iBAAiB,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QAED,6DAA6D;QAC7D,MAAM,mBAAmB,GAAG,GAAG,CAAC,OAAO;YACrC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAC9B,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE,CACtD,EAAE,CAAC,CAAC,CAAC,CAAC;QACT,IAAI,mBAAmB,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAkB;YAC7B,GAAG,GAAG;YACN,OAAO,EAAE;gBACP,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;gBACtB,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE;aAC3B;SACF,CAAC;QAEF,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/middleware/offlineQueue.d.ts

@@ -0,0 +1,78 @@
+import type { Middleware, RequestConfig } from "../types/http";
+import type { HttpResponse } from "../response/response";
+export interface OfflineQueueHooks {
+    readonly onQueued?: (event: {
+        readonly id: number;
+        readonly method: RequestConfig["method"];
+        readonly url: string;
+        readonly at: number;
+    }) => void;
+    readonly onReplayed?: (event: {
+        readonly id: number;
+        readonly method: RequestConfig["method"];
+        readonly url: string;
+        readonly at: number;
+        readonly status: number;
+    }) => void;
+    readonly onReplayError?: (event: {
+        readonly id: number;
+        readonly method: RequestConfig["method"];
+        readonly url: string;
+        readonly at: number;
+        readonly error: unknown;
+    }) => void;
+}
+export interface OfflineQueueOptions {
+    readonly methods?: readonly RequestConfig["method"][];
+    readonly isOffline?: () => boolean;
+    readonly maxQueueSize?: number;
+    readonly hooks?: OfflineQueueHooks;
+    readonly storage?: OfflineQueueStorageAdapter;
+    readonly generateId?: () => number | Promise<number>;
+}
+export interface QueuedRequest {
+    readonly id: number;
+    readonly req: RequestConfig;
+    readonly queuedAt: number;
+}
+export interface OfflineQueueStorageAdapter {
+    readonly push: (item: QueuedRequest) => Promise<void> | void;
+    readonly getAll: () => Promise<readonly QueuedRequest[]> | readonly QueuedRequest[];
+    readonly remove: (id: number) => Promise<void> | void;
+    readonly clear: () => Promise<void> | void;
+    readonly size: () => Promise<number> | number;
+}
+export declare class InMemoryQueueStorageAdapter implements OfflineQueueStorageAdapter {
+    private queue;
+    push(item: QueuedRequest): void;
+    getAll(): readonly QueuedRequest[];
+    remove(id: number): void;
+    clear(): void;
+    size(): number;
+}
+export interface OfflineQueueSnapshot {
+    readonly size: number;
+    readonly items: readonly {
+        readonly id: number;
+        readonly method: RequestConfig["method"];
+        readonly url: string;
+        readonly queuedAt: number;
+    }[];
+}
+export interface OfflineQueueController {
+    readonly middleware: Middleware;
+    readonly flush: (replay: (req: RequestConfig) => Promise<HttpResponse>, options?: {
+        readonly concurrency?: number;
+    }) => Promise<readonly HttpResponse[]>;
+    readonly snapshot: () => Promise<OfflineQueueSnapshot>;
+    readonly clear: () => Promise<void>;
+}
+/**
+ * Creates an offline queue controller for safe mutation replay in browser-like contexts.
+ */
+export declare function createOfflineQueue(options?: OfflineQueueOptions): OfflineQueueController;
+/**
+ * Middleware shortcut when queue controls are not needed directly.
+ */
+export declare function offlineQueue(options?: OfflineQueueOptions): Middleware;
+//# sourceMappingURL=offlineQueue.d.ts.map

package/dist/src/middleware/offlineQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offlineQueue.d.ts","sourceRoot":"","sources":["../../../src/middleware/offlineQueue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;KACrB,KAAK,IAAI,CAAC;IACX,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,KAAK,IAAI,CAAC;IACX,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;KACzB,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,GAAG,SAAS,aAAa,EAAE,CAAC;IACpF,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAC/C;AAED,qBAAa,2BAA4B,YAAW,0BAA0B;IAC5E,OAAO,CAAC,KAAK,CAAuB;IAEpC,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAI/B,MAAM,IAAI,SAAS,aAAa,EAAE;IAIlC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;CAGf;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS;QACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,EAAE,CAAC;CACL;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CACd,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,EACrD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KACxC,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAqBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,sBAAsB,CAmK5F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAE1E"}

package/dist/src/middleware/offlineQueue.js

@@ -0,0 +1,189 @@
+import { markPolicyMiddleware } from "../policy/guardrails";
+import { HttpResponse as PureqHttpResponse } from "../response/response";
+import { appendPolicyTrace } from "../utils/policyTrace";
+export class InMemoryQueueStorageAdapter {
+    constructor() {
+        this.queue = [];
+    }
+    push(item) {
+        this.queue.push(item);
+    }
+    getAll() {
+        return [...this.queue];
+    }
+    remove(id) {
+        this.queue = this.queue.filter((item) => item.id !== id);
+    }
+    clear() {
+        this.queue.length = 0;
+    }
+    size() {
+        return this.queue.length;
+    }
+}
+// appendPolicyTrace is imported from ../utils/policyTrace
+/**
+ * Creates a serializable copy of the request suitable for offline storage.
+ * Deliberately excludes AbortSignal since it is not serializable and
+ * would reference a stale controller upon replay.
+ */
+function cloneRequestForQueue(req) {
+    return {
+        method: req.method,
+        url: req.url,
+        ...(req.params !== undefined ? { params: { ...req.params } } : {}),
+        ...(req.query !== undefined ? { query: req.query } : {}),
+        ...(req.body !== undefined ? { body: req.body } : {}),
+        ...(req.headers !== undefined ? { headers: { ...req.headers } } : {}),
+        ...(req.timeout !== undefined ? { timeout: req.timeout } : {}),
+    };
+}
+/**
+ * Creates an offline queue controller for safe mutation replay in browser-like contexts.
+ */
+export function createOfflineQueue(options = {}) {
+    const methods = new Set(options.methods ?? ["POST", "PUT", "PATCH", "DELETE"]);
+    const maxQueueSize = options.maxQueueSize ?? 500;
+    const isOffline = options.isOffline ?? (() => {
+        if (typeof navigator === "undefined") {
+            return false;
+        }
+        return navigator.onLine === false;
+    });
+    const storage = options.storage ?? new InMemoryQueueStorageAdapter();
+    const hooks = options.hooks;
+    let nextIdCounter = 1;
+    const generateId = options.generateId ?? (() => nextIdCounter++);
+    const middleware = async (req, next) => {
+        if (!methods.has(req.method) || !isOffline()) {
+            return next(req);
+        }
+        const currentSize = await storage.size();
+        if (currentSize >= maxQueueSize) {
+            throw new Error("pureq: offline queue is full");
+        }
+        const id = await generateId();
+        const queuedAt = Date.now();
+        await storage.push({
+            id,
+            req: cloneRequestForQueue(req),
+            queuedAt,
+        });
+        appendPolicyTrace(req, {
+            policy: "offline-queue",
+            decision: "queued",
+            at: queuedAt,
+            reason: "offline mode",
+            key: `${req.method}:${req.url}`,
+        });
+        hooks?.onQueued?.({ id, method: req.method, url: req.url, at: queuedAt });
+        return new PureqHttpResponse(new Response(JSON.stringify({ queued: true, queueId: id }), {
+            status: 202,
+            headers: { "content-type": "application/json" },
+        }));
+    };
+    const flush = async (replay, options) => {
+        const pending = await storage.getAll();
+        const concurrency = options?.concurrency ?? 1;
+        const responses = [];
+        if (concurrency <= 1) {
+            // Sequential replay (default, safest for ordering guarantees)
+            for (const item of pending) {
+                try {
+                    const response = await replay(item.req);
+                    responses.push(response);
+                    // Remove from queue only after successful replay.
+                    // NOTE: If the app crashes between successful replay and this removal,
+                    // the request might be replayed again upon restart. It is strongly recommended
+                    // to use `idempotencyKey` middleware to prevent duplicate operations on the backend.
+                    await storage.remove(item.id);
+                    hooks?.onReplayed?.({
+                        id: item.id,
+                        method: item.req.method,
+                        url: item.req.url,
+                        at: Date.now(),
+                        status: response.status,
+                    });
+                }
+                catch (error) {
+                    // Leave in storage on failure (defer to next flush or retry budgets)
+                    hooks?.onReplayError?.({
+                        id: item.id,
+                        method: item.req.method,
+                        url: item.req.url,
+                        at: Date.now(),
+                        error,
+                    });
+                }
+            }
+        }
+        else {
+            // Concurrent replay in batches of `concurrency`
+            for (let i = 0; i < pending.length; i += concurrency) {
+                const batch = pending.slice(i, i + concurrency);
+                const results = await Promise.allSettled(batch.map(async (item) => {
+                    const response = await replay(item.req);
+                    await storage.remove(item.id);
+                    hooks?.onReplayed?.({
+                        id: item.id,
+                        method: item.req.method,
+                        url: item.req.url,
+                        at: Date.now(),
+                        status: response.status,
+                    });
+                    return response;
+                }));
+                for (let j = 0; j < results.length; j++) {
+                    const result = results[j];
+                    if (result && result.status === "fulfilled") {
+                        responses.push(result.value);
+                    }
+                    else if (result && result.status === "rejected") {
+                        const item = batch[j];
+                        if (item) {
+                            hooks?.onReplayError?.({
+                                id: item.id,
+                                method: item.req.method,
+                                url: item.req.url,
+                                at: Date.now(),
+                                error: result.reason,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        return responses;
+    };
+    const snapshot = async () => {
+        const items = await storage.getAll();
+        return {
+            size: items.length,
+            items: items.map((item) => ({
+                id: item.id,
+                method: item.req.method,
+                url: item.req.url,
+                queuedAt: item.queuedAt,
+            })),
+        };
+    };
+    const clear = async () => {
+        await storage.clear();
+    };
+    return {
+        middleware: markPolicyMiddleware(middleware, {
+            name: "offlineQueue",
+            kind: "cache",
+        }),
+        flush,
+        snapshot,
+        clear,
+    };
+}
+/**
+ * Middleware shortcut when queue controls are not needed directly.
+ */
+export function offlineQueue(options = {}) {
+    return createOfflineQueue(options).middleware;
+}
+//# sourceMappingURL=offlineQueue.js.map

package/dist/src/middleware/offlineQueue.js.map

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

package/dist/src/middleware/presets.d.ts

@@ -0,0 +1,31 @@
+import type { Middleware } from "../types/http";
+import { type CircuitBreakerOptions } from "./circuitBreaker";
+import { type DedupeOptions } from "./dedupe";
+import { type RetryOptions } from "./retry";
+import { type IdempotencyKeyOptions } from "./idempotencyKey";
+export interface ResilientPresetOptions {
+    readonly dedupe?: false | DedupeOptions;
+    readonly retry?: RetryOptions;
+    readonly circuitBreaker?: CircuitBreakerOptions;
+    readonly idempotencyKey?: false | IdempotencyKeyOptions;
+}
+export interface PresetProfileOptions extends ResilientPresetOptions {
+    readonly requestTimeoutMs?: number;
+}
+/**
+ * Production-ready middleware stack preset for fetch/axios replacement use cases.
+ */
+export declare function resilientPreset(options?: ResilientPresetOptions): readonly Middleware[];
+/**
+ * Frontend-focused preset with conservative retries for user-facing responsiveness.
+ */
+export declare function frontendPreset(options?: PresetProfileOptions): readonly Middleware[];
+/**
+ * BFF-focused preset balancing latency and upstream stability.
+ */
+export declare function bffPreset(options?: PresetProfileOptions): readonly Middleware[];
+/**
+ * Backend-focused preset prioritizing dependency resilience under sustained load.
+ */
+export declare function backendPreset(options?: PresetProfileOptions): readonly Middleware[];
+//# sourceMappingURL=presets.d.ts.map

package/dist/src/middleware/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/middleware/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,GAAG,qBAAqB,CAAC;CACzD;AAED,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAClE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAyBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,SAAS,UAAU,EAAE,CAiC3F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,oBAAyB,GAAG,SAAS,UAAU,EAAE,CA2BxF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,oBAAyB,GAAG,SAAS,UAAU,EAAE,CA4BnF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,SAAS,UAAU,EAAE,CA4BvF"}

package/dist/src/middleware/presets.js

@@ -0,0 +1,122 @@
+import { circuitBreaker } from "./circuitBreaker";
+import { dedupe } from "./dedupe";
+import { retry } from "./retry";
+import { idempotencyKey } from "./idempotencyKey";
+import { defaultTimeout } from "./defaultTimeout";
+function mergeRetry(defaults, override) {
+    if (!override) {
+        return defaults;
+    }
+    return {
+        ...defaults,
+        ...override,
+    };
+}
+function mergeCircuitBreaker(defaults, override) {
+    if (!override) {
+        return defaults;
+    }
+    return {
+        ...defaults,
+        ...override,
+    };
+}
+/**
+ * Production-ready middleware stack preset for fetch/axios replacement use cases.
+ */
+export function resilientPreset(options = {}) {
+    const stack = [];
+    if (options.dedupe !== false) {
+        stack.push(dedupe(options.dedupe));
+    }
+    if (options.idempotencyKey !== false) {
+        stack.push(idempotencyKey(options.idempotencyKey));
+    }
+    stack.push(retry(options.retry ?? {
+        maxRetries: 2,
+        delay: 200,
+        backoff: true,
+        retryOnStatus: [429, 500, 502, 503, 504],
+    }));
+    stack.push(circuitBreaker(options.circuitBreaker ?? {
+        failureThreshold: 5,
+        successThreshold: 1,
+        cooldownMs: 30000,
+    }));
+    return stack;
+}
+/**
+ * Frontend-focused preset with conservative retries for user-facing responsiveness.
+ */
+export function frontendPreset(options = {}) {
+    const timeoutMs = options.requestTimeoutMs ?? 5000;
+    return [
+        defaultTimeout(timeoutMs),
+        ...resilientPreset({
+            ...options,
+            dedupe: options.dedupe ?? { methods: ["GET", "HEAD"] },
+            retry: mergeRetry({
+                maxRetries: 1,
+                delay: 150,
+                backoff: true,
+                retryOnStatus: [429, 500, 502, 503, 504],
+            }, options.retry),
+            circuitBreaker: mergeCircuitBreaker({
+                failureThreshold: 4,
+                successThreshold: 1,
+                cooldownMs: 10000,
+            }, options.circuitBreaker),
+        }),
+    ];
+}
+/**
+ * BFF-focused preset balancing latency and upstream stability.
+ */
+export function bffPreset(options = {}) {
+    const timeoutMs = options.requestTimeoutMs ?? 3000;
+    return [
+        defaultTimeout(timeoutMs),
+        ...resilientPreset({
+            ...options,
+            dedupe: options.dedupe ?? { methods: ["GET", "HEAD"] },
+            idempotencyKey: options.idempotencyKey ?? { onlyIfBodyPresent: true },
+            retry: mergeRetry({
+                maxRetries: 2,
+                delay: 200,
+                backoff: true,
+                retryOnStatus: [429, 500, 502, 503, 504],
+            }, options.retry),
+            circuitBreaker: mergeCircuitBreaker({
+                failureThreshold: 5,
+                successThreshold: 1,
+                cooldownMs: 20000,
+            }, options.circuitBreaker),
+        }),
+    ];
+}
+/**
+ * Backend-focused preset prioritizing dependency resilience under sustained load.
+ */
+export function backendPreset(options = {}) {
+    const timeoutMs = options.requestTimeoutMs ?? 2500;
+    return [
+        defaultTimeout(timeoutMs),
+        ...resilientPreset({
+            ...options,
+            dedupe: options.dedupe ?? false,
+            idempotencyKey: options.idempotencyKey ?? { onlyIfBodyPresent: true },
+            retry: mergeRetry({
+                maxRetries: 3,
+                delay: 250,
+                backoff: true,
+                retryOnStatus: [408, 425, 429, 500, 502, 503, 504],
+            }, options.retry),
+            circuitBreaker: mergeCircuitBreaker({
+                failureThreshold: 6,
+                successThreshold: 2,
+                cooldownMs: 30000,
+            }, options.circuitBreaker),
+        }),
+    ];
+}
+//# sourceMappingURL=presets.js.map

package/dist/src/middleware/presets.js.map

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

package/dist/src/middleware/retry.d.ts

@@ -0,0 +1,27 @@
+import type { Middleware } from "../types/http";
+export interface RetryOptions {
+    readonly maxRetries: number;
+    readonly delay?: number;
+    readonly backoff?: boolean;
+    readonly maxDelay?: number;
+    readonly retryBudgetMs?: number;
+    readonly retryOnStatus?: readonly number[];
+    readonly retryOnNetworkError?: boolean;
+    readonly respectRetryAfter?: boolean;
+    readonly retryAfterHeaderName?: string;
+    readonly onRetry?: (event: {
+        readonly attempt: number;
+        readonly waitTime: number;
+        readonly status?: number;
+        readonly error?: unknown;
+        readonly retryAfterMs?: number;
+        readonly budgetRemainingMs?: number;
+        readonly source: "status" | "network";
+    }) => void;
+}
+/**
+ * pureq Retry Middleware
+ * Implements exponential backoff strategy for network failures or configured status codes.
+ */
+export declare function retry(options: RetryOptions): Middleware;
+//# sourceMappingURL=retry.d.ts.map

package/dist/src/middleware/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/middleware/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,eAAe,CAAC;AAK/D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;KACvC,KAAK,IAAI,CAAC;CACZ;AA4DD;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAiKvD"}