@pureq/pureq 1.0.0

package/dist/src/middleware/circuitBreaker.js

@@ -0,0 +1,246 @@
+export class PureqCircuitOpenError extends Error {
+    constructor(message = "pureq: circuit breaker is open") {
+        super(message);
+        this.code = "PUREQ_CIRCUIT_OPEN";
+        this.name = "PureqCircuitOpenError";
+    }
+}
+function defaultShouldTrip(context) {
+    if (context.error) {
+        return true;
+    }
+    if (context.response) {
+        return context.response.status >= 500;
+    }
+    return false;
+}
+/**
+ * Circuit breaker middleware for downstream dependency protection.
+ */
+export function circuitBreaker(options = {}) {
+    return createCircuitBreaker(options).middleware;
+}
+/**
+ * Default key builder uses method + full URL, meaning parameterized
+ * paths (e.g. /users/123 vs /users/456) are tracked as separate
+ * circuits. For endpoint-level protection use a custom keyBuilder
+ * such as keyByMethodAndPath or keyByHost from circuitBreakerKeys.
+ */
+function defaultKeyBuilder(req) {
+    return `${req.method}:${req.url}`;
+}
+function createEntry(now) {
+    return {
+        state: "closed",
+        failureCount: 0,
+        successCount: 0,
+        openedAt: 0,
+        halfOpenProbeInFlight: false,
+        lastChangedAt: now,
+        lastAccessedAt: now,
+    };
+}
+/**
+ * Stateful circuit breaker controller.
+ * Provides middleware plus runtime inspection/reset APIs.
+ */
+export function createCircuitBreaker(options = {}) {
+    const failureThreshold = options.failureThreshold ?? 5;
+    const successThreshold = options.successThreshold ?? 1;
+    const cooldownMs = options.cooldownMs ?? 30000;
+    const shouldTrip = options.shouldTrip ?? defaultShouldTrip;
+    const keyBuilder = options.keyBuilder ?? defaultKeyBuilder;
+    const maxEntries = options.maxEntries ?? Number.POSITIVE_INFINITY;
+    const entryTtlMs = options.entryTtlMs;
+    const entries = new Map();
+    function evictOldestEntry() {
+        const oldestKey = entries.keys().next().value;
+        if (oldestKey !== undefined) {
+            entries.delete(oldestKey);
+        }
+    }
+    function pruneExpiredEntries(now) {
+        if (entryTtlMs === undefined || entryTtlMs <= 0) {
+            return;
+        }
+        for (const [key, entry] of entries) {
+            if (now - entry.lastAccessedAt >= entryTtlMs) {
+                entries.delete(key);
+            }
+        }
+    }
+    function touchEntry(key, entry, now) {
+        entry.lastAccessedAt = now;
+        entries.delete(key);
+        entries.set(key, entry);
+    }
+    function getEntry(key, now) {
+        pruneExpiredEntries(now);
+        const existing = entries.get(key);
+        if (existing) {
+            touchEntry(key, existing, now);
+            return existing;
+        }
+        while (entries.size >= maxEntries) {
+            evictOldestEntry();
+        }
+        const created = createEntry(now);
+        entries.set(key, created);
+        return created;
+    }
+    function openCircuit(key, entry, now) {
+        const previousState = entry.state;
+        entry.state = "open";
+        entry.openedAt = now;
+        entry.failureCount = 0;
+        entry.successCount = 0;
+        entry.halfOpenProbeInFlight = false;
+        entry.lastChangedAt = now;
+        entry.lastAccessedAt = now;
+        if (previousState !== entry.state) {
+            options.hooks?.onStateChange?.({ key, from: previousState, to: entry.state, at: now });
+        }
+        options.hooks?.onOpen?.({ key, openedAt: now, failures: failureThreshold });
+    }
+    function closeCircuit(key, entry, now) {
+        const previousState = entry.state;
+        entry.state = "closed";
+        entry.failureCount = 0;
+        entry.successCount = 0;
+        entry.halfOpenProbeInFlight = false;
+        entry.lastChangedAt = now;
+        entry.lastAccessedAt = now;
+        if (previousState !== entry.state) {
+            options.hooks?.onStateChange?.({ key, from: previousState, to: entry.state, at: now });
+        }
+        options.hooks?.onClose?.({ key, at: now });
+    }
+    function moveToHalfOpen(key, entry, now) {
+        const previousState = entry.state;
+        entry.state = "half-open";
+        entry.successCount = 0;
+        entry.halfOpenProbeInFlight = false;
+        entry.lastChangedAt = now;
+        entry.lastAccessedAt = now;
+        if (previousState !== entry.state) {
+            options.hooks?.onStateChange?.({ key, from: previousState, to: entry.state, at: now });
+        }
+        options.hooks?.onHalfOpen?.({ key, at: now });
+    }
+    const middleware = async (req, next) => {
+        const now = Date.now();
+        const key = keyBuilder(req);
+        const entry = getEntry(key, now);
+        touchEntry(key, entry, now);
+        if (entry.state === "open") {
+            if (now - entry.openedAt < cooldownMs) {
+                throw new PureqCircuitOpenError();
+            }
+            moveToHalfOpen(key, entry, now);
+        }
+        if (entry.state === "half-open") {
+            if (entry.halfOpenProbeInFlight) {
+                throw new PureqCircuitOpenError("pureq: circuit breaker half-open probe in flight");
+            }
+            entry.halfOpenProbeInFlight = true;
+        }
+        try {
+            const response = await next(req);
+            const shouldCountFailure = shouldTrip({ key, req, response });
+            if (shouldCountFailure) {
+                if (entry.state === "half-open") {
+                    openCircuit(key, entry, Date.now());
+                }
+                else {
+                    entry.failureCount += 1;
+                    if (entry.failureCount >= failureThreshold) {
+                        openCircuit(key, entry, Date.now());
+                    }
+                }
+                return response;
+            }
+            if (entry.state === "half-open") {
+                entry.successCount += 1;
+                if (entry.successCount >= successThreshold) {
+                    closeCircuit(key, entry, Date.now());
+                }
+            }
+            else {
+                entry.failureCount = 0;
+            }
+            return response;
+        }
+        catch (error) {
+            const shouldCountFailure = shouldTrip({ key, req, error });
+            if (!shouldCountFailure) {
+                throw error;
+            }
+            if (entry.state === "half-open") {
+                openCircuit(key, entry, Date.now());
+            }
+            else {
+                entry.failureCount += 1;
+                if (entry.failureCount >= failureThreshold) {
+                    openCircuit(key, entry, Date.now());
+                }
+            }
+            throw error;
+        }
+        finally {
+            if (entry.state === "half-open") {
+                entry.halfOpenProbeInFlight = false;
+            }
+            touchEntry(key, entry, Date.now());
+        }
+    };
+    const snapshot = () => {
+        pruneExpiredEntries(Date.now());
+        const result = [];
+        let closed = 0;
+        let open = 0;
+        let halfOpen = 0;
+        for (const [key, entry] of entries) {
+            if (entry.state === "closed") {
+                closed += 1;
+            }
+            else if (entry.state === "open") {
+                open += 1;
+            }
+            else {
+                halfOpen += 1;
+            }
+            result.push({
+                key,
+                state: entry.state,
+                failureCount: entry.failureCount,
+                successCount: entry.successCount,
+                openedAt: entry.openedAt,
+                lastChangedAt: entry.lastChangedAt,
+                lastAccessedAt: entry.lastAccessedAt,
+            });
+        }
+        result.sort((a, b) => a.key.localeCompare(b.key));
+        return {
+            size: result.length,
+            summary: {
+                closed,
+                open,
+                halfOpen,
+            },
+            entries: result,
+        };
+    };
+    const reset = (key) => {
+        if (key === undefined) {
+            entries.clear();
+            return;
+        }
+        entries.delete(key);
+    };
+    return {
+        middleware,
+        snapshot,
+        reset,
+    };
+}
+//# sourceMappingURL=circuitBreaker.js.map

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

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

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

@@ -0,0 +1,5 @@
+import type { RequestConfig } from "../types/http";
+export declare function keyByHost(req: Readonly<RequestConfig>): string;
+export declare function keyByMethodAndPath(req: Readonly<RequestConfig>): string;
+export declare function keyByOriginAndPath(req: Readonly<RequestConfig>): string;
+//# sourceMappingURL=circuitBreakerKeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"circuitBreakerKeys.d.ts","sourceRoot":"","sources":["../../../src/middleware/circuitBreakerKeys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAUnD,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAM9D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAMvE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAMvE"}

package/dist/src/middleware/circuitBreakerKeys.js

@@ -0,0 +1,30 @@
+function safeURL(url) {
+    try {
+        return new URL(url);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function keyByHost(req) {
+    const parsed = safeURL(req.url);
+    if (!parsed) {
+        return `host:unknown:${req.method}`;
+    }
+    return `host:${parsed.host}`;
+}
+export function keyByMethodAndPath(req) {
+    const parsed = safeURL(req.url);
+    if (!parsed) {
+        return `path:${req.method}:${req.url}`;
+    }
+    return `path:${req.method}:${parsed.pathname}`;
+}
+export function keyByOriginAndPath(req) {
+    const parsed = safeURL(req.url);
+    if (!parsed) {
+        return `origin-path:${req.method}:${req.url}`;
+    }
+    return `origin-path:${req.method}:${parsed.origin}${parsed.pathname}`;
+}
+//# sourceMappingURL=circuitBreakerKeys.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"circuitBreakerKeys.js","sourceRoot":"","sources":["../../../src/middleware/circuitBreakerKeys.ts"],"names":[],"mappings":"AAEA,SAAS,OAAO,CAAC,GAAW;IAC1B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAA4B;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,gBAAgB,GAAG,CAAC,MAAM,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAA4B;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,QAAQ,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,QAAQ,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAA4B;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,eAAe,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,eAAe,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;AACxE,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { Middleware } from "../types/http";
+import type { InternalRequestConfig } from "../types/internal";
+import type { HttpResponse } from "../response/response";
+/**
+ * Composes multiple middlewares into a single executable function.
+ * Implements the "Onion Model" with re-entry prevention via index tracking.
+ */
+export declare function compose(middlewares: readonly Middleware[], executor?: (req: InternalRequestConfig) => Promise<HttpResponse>): (req: InternalRequestConfig) => Promise<HttpResponse>;
+//# sourceMappingURL=compose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../src/middleware/compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;GAGG;AACH,wBAAgB,OAAO,CACrB,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,QAAQ,GAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC,YAAY,CAAW,IAExD,KAAK,qBAAqB,KAAG,OAAO,CAAC,YAAY,CAAC,CAyCpE"}

package/dist/src/middleware/compose.js

@@ -0,0 +1,45 @@
+import { execute } from "../executor/execute";
+/**
+ * Composes multiple middlewares into a single executable function.
+ * Implements the "Onion Model" with re-entry prevention via index tracking.
+ */
+export function compose(middlewares, executor = execute) {
+    return function (req) {
+        function dispatch(i, currentConfig) {
+            const middleware = middlewares[i];
+            // After the last middleware, run the executor
+            if (!middleware) {
+                return executor(currentConfig);
+            }
+            // Guards against concurrent calls to next() within a single middleware.
+            // The flag is reset in the finally block after dispatch completes,
+            // which intentionally allows sequential re-invocation of next()
+            // (e.g. in an error-recovery path). Only truly parallel calls are rejected.
+            let nextInFlight = false;
+            try {
+                return middleware(currentConfig, async (nextConfig) => {
+                    if (nextInFlight) {
+                        throw new Error("pureq: next() was called multiple times in a single middleware");
+                    }
+                    nextInFlight = true;
+                    const nextReq = {
+                        ...currentConfig,
+                        ...nextConfig,
+                        _middlewares: currentConfig._middlewares,
+                    };
+                    try {
+                        return await dispatch(i + 1, nextReq);
+                    }
+                    finally {
+                        nextInFlight = false;
+                    }
+                });
+            }
+            catch (err) {
+                return Promise.reject(err);
+            }
+        }
+        return dispatch(0, req);
+    };
+}
+//# sourceMappingURL=compose.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../src/middleware/compose.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,WAAkC,EAClC,WAAkE,OAAO;IAEzE,OAAO,UAAU,GAA0B;QACzC,SAAS,QAAQ,CAAC,CAAS,EAAE,aAAoC;YAC/D,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAElC,8CAA8C;YAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,QAAQ,CAAC,aAAa,CAAC,CAAC;YACjC,CAAC;YAED,wEAAwE;YACxE,mEAAmE;YACnE,gEAAgE;YAChE,4EAA4E;YAC5E,IAAI,YAAY,GAAG,KAAK,CAAC;YAEzB,IAAI,CAAC;gBACH,OAAO,UAAU,CAAC,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;oBACpD,IAAI,YAAY,EAAE,CAAC;wBACjB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;oBACpF,CAAC;oBAED,YAAY,GAAG,IAAI,CAAC;oBACpB,MAAM,OAAO,GAA0B;wBACrC,GAAG,aAAa;wBAChB,GAAG,UAAU;wBACb,YAAY,EAAE,aAAa,CAAC,YAAY;qBACzC,CAAC;oBAEF,IAAI,CAAC;wBACH,OAAO,MAAM,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;oBACxC,CAAC;4BAAS,CAAC;wBACT,YAAY,GAAG,KAAK,CAAC;oBACvB,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { Middleware, RequestConfig } from "../types/http";
+export interface ConcurrencyLimitOptions {
+    readonly maxConcurrent: number;
+    readonly keyBuilder?: (req: Readonly<RequestConfig>) => string;
+    readonly maxQueue?: number;
+}
+/**
+ * Limits in-flight request concurrency globally or by key.
+ */
+export declare function concurrencyLimit(options: ConcurrencyLimitOptions): Middleware;
+//# sourceMappingURL=concurrencyLimit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concurrencyLimit.d.ts","sourceRoot":"","sources":["../../../src/middleware/concurrencyLimit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK,MAAM,CAAC;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AA2BD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,UAAU,CAyI7E"}

package/dist/src/middleware/concurrencyLimit.js

@@ -0,0 +1,126 @@
+import { markPolicyMiddleware } from "../policy/guardrails";
+const GLOBAL_KEY = "__global__";
+function validateOptions(options) {
+    if (!Number.isInteger(options.maxConcurrent) || options.maxConcurrent <= 0) {
+        throw new Error("pureq: concurrencyLimit requires maxConcurrent to be a positive integer");
+    }
+    if (options.maxQueue !== undefined && (!Number.isInteger(options.maxQueue) || options.maxQueue < 0)) {
+        throw new Error("pureq: concurrencyLimit maxQueue must be >= 0");
+    }
+}
+/**
+ * Limits in-flight request concurrency globally or by key.
+ */
+export function concurrencyLimit(options) {
+    validateOptions(options);
+    const maxConcurrent = options.maxConcurrent;
+    const maxQueue = options.maxQueue;
+    const keyBuilder = options.keyBuilder ?? (() => GLOBAL_KEY);
+    const buckets = new Map();
+    let nextTicketId = 0;
+    const getBucket = (key) => {
+        const existing = buckets.get(key);
+        if (existing) {
+            return existing;
+        }
+        const created = { active: 0, queue: [] };
+        buckets.set(key, created);
+        return created;
+    };
+    const cleanupBucketIfEmpty = (key) => {
+        const bucket = buckets.get(key);
+        if (!bucket) {
+            return;
+        }
+        if (bucket.active === 0 && bucket.queue.length === 0) {
+            buckets.delete(key);
+        }
+    };
+    const promoteNext = (key) => {
+        const bucket = buckets.get(key);
+        if (!bucket) {
+            return;
+        }
+        while (bucket.active < maxConcurrent && bucket.queue.length > 0) {
+            const next = bucket.queue.shift();
+            if (!next) {
+                break;
+            }
+            if (next.signal && next.onAbort) {
+                next.signal.removeEventListener("abort", next.onAbort);
+            }
+            bucket.active += 1;
+            next.resolve();
+        }
+        cleanupBucketIfEmpty(key);
+    };
+    const acquire = async (key, signal) => {
+        const bucket = getBucket(key);
+        if (bucket.active < maxConcurrent) {
+            bucket.active += 1;
+            return;
+        }
+        if (maxQueue !== undefined && bucket.queue.length >= maxQueue) {
+            throw new Error(`pureq: concurrency queue limit exceeded for key '${key}'`);
+        }
+        if (signal?.aborted) {
+            throw signal.reason ?? new DOMException("Aborted", "AbortError");
+        }
+        await new Promise((resolve, reject) => {
+            const ticketId = nextTicketId++;
+            // Prevent ticket ID overflow for long-running processes
+            if (nextTicketId > Number.MAX_SAFE_INTEGER) {
+                nextTicketId = 0;
+            }
+            let onAbort;
+            if (signal) {
+                onAbort = () => {
+                    const queuedBucket = buckets.get(key);
+                    if (!queuedBucket) {
+                        reject(signal.reason ?? new DOMException("Aborted", "AbortError"));
+                        return;
+                    }
+                    const index = queuedBucket.queue.findIndex((entry) => entry.id === ticketId);
+                    if (index >= 0) {
+                        queuedBucket.queue.splice(index, 1);
+                    }
+                    cleanupBucketIfEmpty(key);
+                    reject(signal.reason ?? new DOMException("Aborted", "AbortError"));
+                };
+                signal.addEventListener("abort", onAbort, { once: true });
+            }
+            const entry = {
+                id: ticketId,
+                resolve,
+                reject,
+                ...(signal !== undefined ? { signal } : {}),
+                ...(onAbort !== undefined ? { onAbort } : {}),
+            };
+            bucket.queue.push(entry);
+        });
+    };
+    const release = (key) => {
+        const bucket = buckets.get(key);
+        if (!bucket) {
+            return;
+        }
+        bucket.active = Math.max(0, bucket.active - 1);
+        promoteNext(key);
+    };
+    const middleware = async (req, next) => {
+        const key = keyBuilder(req);
+        await acquire(key, req.signal);
+        try {
+            return await next(req);
+        }
+        finally {
+            release(key);
+        }
+    };
+    return markPolicyMiddleware(middleware, {
+        name: "concurrencyLimit",
+        kind: "concurrency",
+        maxConcurrent,
+    });
+}
+//# sourceMappingURL=concurrencyLimit.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { Middleware } from "../types/http";
+export interface DeadlineOptions {
+    readonly defaultTimeoutMs?: number;
+    readonly now?: () => number;
+}
+/**
+ * Applies a total request deadline that is preserved across retries.
+ */
+export declare function deadline(options?: DeadlineOptions): Middleware;
+//# sourceMappingURL=deadline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../../src/middleware/deadline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAmFD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,UAAU,CA8ClE"}

package/dist/src/middleware/deadline.js

@@ -0,0 +1,99 @@
+import { markPolicyMiddleware } from "../policy/guardrails";
+function resolveDeadlineAt(req, now, defaultTimeoutMs) {
+    const existing = req._meta?.deadlineAt;
+    if (typeof existing === "number" && Number.isFinite(existing)) {
+        return existing;
+    }
+    if (req.timeout !== undefined) {
+        if (!Number.isFinite(req.timeout) || req.timeout <= 0) {
+            throw new Error("pureq: deadline requires timeout to be a positive number");
+        }
+        return now + req.timeout;
+    }
+    if (defaultTimeoutMs !== undefined) {
+        if (!Number.isFinite(defaultTimeoutMs) || defaultTimeoutMs <= 0) {
+            throw new Error("pureq: deadline defaultTimeoutMs must be a positive number");
+        }
+        return now + defaultTimeoutMs;
+    }
+    return undefined;
+}
+function readMeta(req) {
+    if (typeof req !== "object" || req === null || !("_meta" in req)) {
+        return undefined;
+    }
+    return req._meta;
+}
+function timeoutError(deadlineAt, now) {
+    const elapsed = Math.max(0, Math.round(now - deadlineAt));
+    return new Error(`pureq: request timeout after deadline exceeded (${elapsed}ms past deadline)`);
+}
+function joinSignal(externalSignal, remainingMs, deadlineAt, now) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => {
+        controller.abort(timeoutError(deadlineAt, now()));
+    }, remainingMs);
+    const onExternalAbort = () => {
+        controller.abort(externalSignal?.reason ?? new DOMException("Aborted", "AbortError"));
+    };
+    if (externalSignal) {
+        if (externalSignal.aborted) {
+            onExternalAbort();
+        }
+        else {
+            externalSignal.addEventListener("abort", onExternalAbort, { once: true });
+        }
+    }
+    const cleanup = () => {
+        clearTimeout(timeoutId);
+        if (externalSignal) {
+            externalSignal.removeEventListener("abort", onExternalAbort);
+        }
+    };
+    return {
+        signal: controller.signal,
+        cleanup,
+    };
+}
+/**
+ * Applies a total request deadline that is preserved across retries.
+ */
+export function deadline(options = {}) {
+    const middleware = async (req, next) => {
+        const nowFactory = options.now ?? Date.now;
+        const startedAt = nowFactory();
+        const existingMeta = readMeta(req);
+        const deadlineAt = resolveDeadlineAt({
+            ...(req.timeout !== undefined ? { timeout: req.timeout } : {}),
+            ...(existingMeta ? { _meta: existingMeta } : {}),
+        }, startedAt, options.defaultTimeoutMs);
+        if (deadlineAt === undefined) {
+            return next(req);
+        }
+        const remainingMs = Math.max(0, Math.ceil(deadlineAt - startedAt));
+        if (remainingMs <= 0) {
+            throw timeoutError(deadlineAt, startedAt);
+        }
+        const { signal, cleanup } = joinSignal(req.signal, remainingMs, deadlineAt, nowFactory);
+        try {
+            const nextReq = {
+                ...req,
+                signal,
+                timeout: Math.min(req.timeout ?? remainingMs, remainingMs),
+                _meta: {
+                    ...(existingMeta ?? {}),
+                    deadlineAt,
+                },
+            };
+            return await next(nextReq);
+        }
+        finally {
+            cleanup();
+        }
+    };
+    return markPolicyMiddleware(middleware, {
+        name: "deadline",
+        kind: "timeout",
+    });
+}
+//# sourceMappingURL=deadline.js.map

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

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

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

@@ -0,0 +1,13 @@
+import type { Middleware, RequestConfig } from "../types/http";
+export interface DedupeOptions {
+    readonly methods?: readonly RequestConfig["method"][];
+    readonly includeHeaders?: boolean;
+    readonly includeBody?: boolean;
+    readonly keyBuilder?: (req: Readonly<RequestConfig>) => string;
+}
+/**
+ * Deduplicates in-flight requests with the same request signature.
+ * Useful for UI bursts and concurrent cache stampede prevention.
+ */
+export declare function dedupe(options?: DedupeOptions): Middleware;
+//# sourceMappingURL=dedupe.d.ts.map