@pureq/pureq 1.0.0

package/dist/src/middleware/retry.js

@@ -0,0 +1,189 @@
+import { markPolicyMiddleware } from "../policy/guardrails";
+import { appendPolicyTrace } from "../utils/policyTrace";
+function isRetryableStatus(status, allowList) {
+    if (allowList && allowList.length > 0) {
+        return allowList.includes(status);
+    }
+    return status >= 500;
+}
+// appendPolicyTrace is imported from ../utils/policyTrace
+function parseRetryAfter(value, nowMs) {
+    if (!value) {
+        return undefined;
+    }
+    const deltaSeconds = Number(value);
+    if (Number.isFinite(deltaSeconds)) {
+        return Math.max(0, Math.round(deltaSeconds * 1000));
+    }
+    const parsedDate = Date.parse(value);
+    if (!Number.isNaN(parsedDate)) {
+        return Math.max(0, parsedDate - nowMs);
+    }
+    return undefined;
+}
+async function sleep(ms, signal) {
+    if (ms <= 0) {
+        return;
+    }
+    await new Promise((resolve, reject) => {
+        const timeoutId = setTimeout(() => {
+            if (signal) {
+                signal.removeEventListener("abort", onAbort);
+            }
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timeoutId);
+            if (signal) {
+                signal.removeEventListener("abort", onAbort);
+            }
+            reject(signal?.reason ?? new DOMException("Aborted", "AbortError"));
+        };
+        if (signal) {
+            if (signal.aborted) {
+                onAbort();
+                return;
+            }
+            signal.addEventListener("abort", onAbort, { once: true });
+        }
+    });
+}
+/**
+ * pureq Retry Middleware
+ * Implements exponential backoff strategy for network failures or configured status codes.
+ */
+export function retry(options) {
+    if (!Number.isInteger(options.maxRetries) || options.maxRetries < 0) {
+        throw new Error("pureq: retry requires maxRetries to be a non-negative integer");
+    }
+    const { maxRetries, delay = 300, backoff = true, maxDelay = 5000, retryBudgetMs, retryOnStatus, retryOnNetworkError = true, respectRetryAfter = true, retryAfterHeaderName = "retry-after", onRetry, } = options;
+    const middleware = async (req, next) => {
+        let attempts = 0;
+        let totalWaitMs = 0;
+        const hasBudget = retryBudgetMs !== undefined && Number.isFinite(retryBudgetMs) && retryBudgetMs > 0;
+        const withRetryMeta = () => {
+            const hasMeta = typeof req === "object" && req !== null && "_meta" in req;
+            const currentMeta = hasMeta
+                ? (req._meta ?? {})
+                : {};
+            currentMeta.retryCount = attempts;
+            if (hasMeta) {
+                return req;
+            }
+            return {
+                ...req,
+                _meta: currentMeta,
+            };
+        };
+        const executeWithRetry = async () => {
+            try {
+                const res = await next(withRetryMeta());
+                if (isRetryableStatus(res.status, retryOnStatus) && attempts < maxRetries) {
+                    attempts++;
+                    const baseWait = backoff ? Math.min(delay * 2 ** (attempts - 1), maxDelay) : delay;
+                    const retryAfterMs = respectRetryAfter
+                        ? parseRetryAfter(res.headers.get(retryAfterHeaderName), Date.now())
+                        : undefined;
+                    const waitTime = Math.max(baseWait, retryAfterMs ?? 0);
+                    const budgetRemainingMs = hasBudget ? Math.max(0, retryBudgetMs - totalWaitMs) : undefined;
+                    if (budgetRemainingMs !== undefined && waitTime > budgetRemainingMs) {
+                        appendPolicyTrace(req, {
+                            policy: "retry",
+                            decision: "skip",
+                            at: Date.now(),
+                            attempt: attempts,
+                            reason: "retry budget exhausted",
+                            waitTimeMs: waitTime,
+                            status: res.status,
+                            ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+                            budgetRemainingMs,
+                            source: "status",
+                        });
+                        return res;
+                    }
+                    appendPolicyTrace(req, {
+                        policy: "retry",
+                        decision: "retry",
+                        at: Date.now(),
+                        attempt: attempts,
+                        reason: `retryable status ${res.status}`,
+                        waitTimeMs: waitTime,
+                        status: res.status,
+                        ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+                        ...(budgetRemainingMs !== undefined ? { budgetRemainingMs } : {}),
+                        source: "status",
+                    });
+                    onRetry?.({
+                        attempt: attempts,
+                        waitTime,
+                        status: res.status,
+                        ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+                        ...(budgetRemainingMs !== undefined ? { budgetRemainingMs } : {}),
+                        source: "status",
+                    });
+                    totalWaitMs += waitTime;
+                    await sleep(waitTime, req.signal);
+                    return executeWithRetry();
+                }
+                return res;
+            }
+            catch (error) {
+                if (!retryOnNetworkError) {
+                    throw error;
+                }
+                if (attempts < maxRetries) {
+                    attempts++;
+                    const waitTime = backoff ? Math.min(delay * 2 ** (attempts - 1), maxDelay) : delay;
+                    const budgetRemainingMs = hasBudget ? Math.max(0, retryBudgetMs - totalWaitMs) : undefined;
+                    if (budgetRemainingMs !== undefined && waitTime > budgetRemainingMs) {
+                        appendPolicyTrace(req, {
+                            policy: "retry",
+                            decision: "give-up",
+                            at: Date.now(),
+                            attempt: attempts,
+                            reason: "retry budget exhausted",
+                            waitTimeMs: waitTime,
+                            budgetRemainingMs,
+                            source: "network",
+                        });
+                        if (typeof error === "object" && error !== null) {
+                            error.__pureqRetryCount = attempts - 1;
+                        }
+                        throw error;
+                    }
+                    appendPolicyTrace(req, {
+                        policy: "retry",
+                        decision: "retry",
+                        at: Date.now(),
+                        attempt: attempts,
+                        reason: "network failure",
+                        waitTimeMs: waitTime,
+                        ...(budgetRemainingMs !== undefined ? { budgetRemainingMs } : {}),
+                        source: "network",
+                    });
+                    onRetry?.({
+                        attempt: attempts,
+                        waitTime,
+                        error,
+                        ...(budgetRemainingMs !== undefined ? { budgetRemainingMs } : {}),
+                        source: "network",
+                    });
+                    totalWaitMs += waitTime;
+                    await sleep(waitTime, req.signal);
+                    return executeWithRetry();
+                }
+                if (typeof error === "object" && error !== null) {
+                    error.__pureqRetryCount = attempts;
+                }
+                throw error;
+            }
+        };
+        return executeWithRetry();
+    };
+    return markPolicyMiddleware(middleware, {
+        name: "retry",
+        kind: "retry",
+        maxRetries,
+    });
+}
+//# sourceMappingURL=retry.js.map

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

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

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

@@ -0,0 +1,14 @@
+export interface StalePolicyDecision {
+    readonly ageMs: number;
+    readonly isFresh: boolean;
+    readonly canServeStaleOnError: boolean;
+    readonly ttlMs: number;
+    readonly staleIfErrorMs: number;
+}
+export declare function resolveStalePolicy(options: {
+    readonly storedAt: number;
+    readonly now: number;
+    readonly ttlMs: number;
+    readonly staleIfErrorMs: number;
+}): StalePolicyDecision;
+//# sourceMappingURL=stalePolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stalePolicy.d.ts","sourceRoot":"","sources":["../../../src/middleware/stalePolicy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,mBAAmB,CAYtB"}

package/dist/src/middleware/stalePolicy.js

@@ -0,0 +1,13 @@
+export function resolveStalePolicy(options) {
+    const ageMs = Math.max(0, options.now - options.storedAt);
+    const isFresh = ageMs <= options.ttlMs;
+    const canServeStaleOnError = ageMs <= options.ttlMs + options.staleIfErrorMs;
+    return {
+        ageMs,
+        isFresh,
+        canServeStaleOnError,
+        ttlMs: options.ttlMs,
+        staleIfErrorMs: options.staleIfErrorMs,
+    };
+}
+//# sourceMappingURL=stalePolicy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stalePolicy.js","sourceRoot":"","sources":["../../../src/middleware/stalePolicy.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,kBAAkB,CAAC,OAKlC;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IACvC,MAAM,oBAAoB,GAAG,KAAK,IAAI,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC;IAE7E,OAAO;QACL,KAAK;QACL,OAAO;QACP,oBAAoB;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC;AACJ,CAAC"}

package/dist/src/observability/otelMapping.d.ts

@@ -0,0 +1,13 @@
+import type { TransportEvent } from "../types/events";
+export interface OpenTelemetryLikeAttributes {
+    readonly [key: string]: string | number | boolean;
+}
+/**
+ * Maps a transport event to OpenTelemetry-like attributes.
+ *
+ * SECURITY NOTE: The `url.full` attribute contains the raw URL which may include
+ * sensitive query parameters (tokens, API keys). Use `redactUrlQueryParams()`
+ * from the redaction module to sanitize URLs before exporting to telemetry backends.
+ */
+export declare function mapTransportEventToOtelAttributes(event: TransportEvent): OpenTelemetryLikeAttributes;
+//# sourceMappingURL=otelMapping.d.ts.map

package/dist/src/observability/otelMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otelMapping.d.ts","sourceRoot":"","sources":["../../../src/observability/otelMapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACnD;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,cAAc,GACpB,2BAA2B,CA4B7B"}

package/dist/src/observability/otelMapping.js

@@ -0,0 +1,31 @@
+/**
+ * Maps a transport event to OpenTelemetry-like attributes.
+ *
+ * SECURITY NOTE: The `url.full` attribute contains the raw URL which may include
+ * sensitive query parameters (tokens, API keys). Use `redactUrlQueryParams()`
+ * from the redaction module to sanitize URLs before exporting to telemetry backends.
+ */
+export function mapTransportEventToOtelAttributes(event) {
+    const attributes = {
+        "http.request.method": event.method,
+        "url.full": event.url,
+        "pureq.phase": event.phase,
+    };
+    if (event.status !== undefined) {
+        attributes["http.response.status_code"] = event.status;
+    }
+    if (event.durationMs !== undefined) {
+        attributes["pureq.duration_ms"] = event.durationMs;
+    }
+    if (event.retryCount !== undefined) {
+        attributes["pureq.retry_count"] = event.retryCount;
+    }
+    if (event.errorKind !== undefined) {
+        attributes["pureq.error_kind"] = event.errorKind;
+    }
+    if (event.policyTrace !== undefined) {
+        attributes["pureq.policy_trace_count"] = event.policyTrace.length;
+    }
+    return attributes;
+}
+//# sourceMappingURL=otelMapping.js.map

package/dist/src/observability/otelMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otelMapping.js","sourceRoot":"","sources":["../../../src/observability/otelMapping.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAC/C,KAAqB;IAErB,MAAM,UAAU,GAA8C;QAC5D,qBAAqB,EAAE,KAAK,CAAC,MAAM;QACnC,UAAU,EAAE,KAAK,CAAC,GAAG;QACrB,aAAa,EAAE,KAAK,CAAC,KAAK;KAC3B,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,UAAU,CAAC,2BAA2B,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACzD,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,UAAU,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC;IACrD,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,UAAU,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC;IACrD,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,UAAU,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IACnD,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,UAAU,CAAC,0BAA0B,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC;IACpE,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/src/observability/otelProfiles.d.ts

@@ -0,0 +1,16 @@
+import type { TransportEvent } from "../types/events";
+import type { OpenTelemetryLikeAttributes } from "./otelMapping";
+/**
+ * Maps a transport event to standard HTTP OpenTelemetry semantic conventions.
+ * @see https://opentelemetry.io/docs/specs/semconv/http/http-spans/
+ */
+export declare function mapToStandardHttpAttributes(event: TransportEvent): OpenTelemetryLikeAttributes;
+/**
+ * Maps a transport event to AWS X-Ray compatible semantic conventions.
+ */
+export declare function mapToAwsSemanticConventions(event: TransportEvent): OpenTelemetryLikeAttributes;
+/**
+ * Maps a transport event to GCP Cloud Trace compatible semantic conventions.
+ */
+export declare function mapToGcpSemanticConventions(event: TransportEvent): OpenTelemetryLikeAttributes;
+//# sourceMappingURL=otelProfiles.d.ts.map

package/dist/src/observability/otelProfiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otelProfiles.d.ts","sourceRoot":"","sources":["../../../src/observability/otelProfiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAGjE;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,GACpB,2BAA2B,CAwB7B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,GACpB,2BAA2B,CAgB7B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,GACpB,2BAA2B,CAgB7B"}

package/dist/src/observability/otelProfiles.js

@@ -0,0 +1,66 @@
+import { mapTransportEventToOtelAttributes } from "./otelMapping";
+/**
+ * Maps a transport event to standard HTTP OpenTelemetry semantic conventions.
+ * @see https://opentelemetry.io/docs/specs/semconv/http/http-spans/
+ */
+export function mapToStandardHttpAttributes(event) {
+    const base = mapTransportEventToOtelAttributes(event);
+    const attributes = {
+        ...base,
+        "http.method": event.method,
+        "http.url": event.url,
+    };
+    if (event.status !== undefined) {
+        attributes["http.status_code"] = event.status;
+    }
+    // Optionally extract host/scheme if URL is valid
+    try {
+        const urlObj = new URL(event.url);
+        attributes["http.scheme"] = urlObj.protocol.replace(":", "");
+        attributes["http.host"] = urlObj.host;
+        attributes["net.peer.name"] = urlObj.hostname;
+        attributes["net.peer.port"] = urlObj.port ? parseInt(urlObj.port, 10) : (urlObj.protocol === "https:" ? 443 : 80);
+    }
+    catch {
+        // Ignore invalid URLs
+    }
+    return attributes;
+}
+/**
+ * Maps a transport event to AWS X-Ray compatible semantic conventions.
+ */
+export function mapToAwsSemanticConventions(event) {
+    const standard = mapToStandardHttpAttributes(event);
+    const awsAttributes = {
+        ...standard,
+        "aws.service": "pureq-client",
+    };
+    if (event.status !== undefined) {
+        if (event.status >= 500)
+            awsAttributes["aws.is_fault"] = true;
+        else if (event.status >= 400)
+            awsAttributes["aws.is_error"] = true;
+    }
+    else if (event.errorKind !== undefined) {
+        awsAttributes["aws.is_fault"] = true;
+    }
+    return awsAttributes;
+}
+/**
+ * Maps a transport event to GCP Cloud Trace compatible semantic conventions.
+ */
+export function mapToGcpSemanticConventions(event) {
+    const standard = mapToStandardHttpAttributes(event);
+    const gcpAttributes = {
+        ...standard,
+    };
+    // GCP Cloud Trace often looks for specific agent identifiers and status mappings
+    if (event.status !== undefined) {
+        gcpAttributes["/http/status_code"] = event.status;
+    }
+    gcpAttributes["/http/url"] = event.url;
+    gcpAttributes["/http/method"] = event.method;
+    gcpAttributes["/agent"] = "pureq";
+    return gcpAttributes;
+}
+//# sourceMappingURL=otelProfiles.js.map

package/dist/src/observability/otelProfiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otelProfiles.js","sourceRoot":"","sources":["../../../src/observability/otelProfiles.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iCAAiC,EAAE,MAAM,eAAe,CAAC;AAElE;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAqB;IAErB,MAAM,IAAI,GAAG,iCAAiC,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,UAAU,GAA8C;QAC5D,GAAG,IAAI;QACP,aAAa,EAAE,KAAK,CAAC,MAAM;QAC3B,UAAU,EAAE,KAAK,CAAC,GAAG;KACtB,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,UAAU,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IAChD,CAAC;IAED,iDAAiD;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7D,UAAU,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QACtC,UAAU,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC9C,UAAU,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpH,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAqB;IAErB,MAAM,QAAQ,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,aAAa,GAA8C;QAC/D,GAAG,QAAQ;QACX,aAAa,EAAE,cAAc;KAC9B,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;YAAE,aAAa,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;aACzD,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;YAAE,aAAa,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IACrE,CAAC;SAAM,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACzC,aAAa,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IACvC,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAqB;IAErB,MAAM,QAAQ,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,aAAa,GAA8C;QAC/D,GAAG,QAAQ;KACZ,CAAC;IAEF,iFAAiF;IACjF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,aAAa,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACpD,CAAC;IACD,aAAa,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC;IACvC,aAAa,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7C,aAAa,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;IAElC,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/src/observability/redaction.d.ts

@@ -0,0 +1,39 @@
+export interface RedactionOptions {
+    readonly redactedValue?: string;
+    readonly sensitiveHeaderNames?: readonly string[];
+    readonly sensitiveFieldPatterns?: readonly RegExp[];
+}
+/**
+ * Redacts sensitive header values while preserving keys.
+ */
+export declare function redactHeaders(headers: Readonly<Record<string, string>>, options?: RedactionOptions): Readonly<Record<string, string>>;
+/**
+ * Redacts sensitive object fields by key pattern.
+ */
+export declare function redactObjectFields<T extends Readonly<Record<string, unknown>>>(value: T, options?: RedactionOptions): T;
+/**
+ * Standard PII (Personally Identifiable Information) Redaction Profile.
+ * Redacts common PII field names like email, phone, ssn, address.
+ */
+export declare const piiRedactionOptions: RedactionOptions;
+/**
+ * Standard Auth Redaction Profile.
+ * Extends the default auth redaction with stricter keys and patterns.
+ */
+export declare const authRedactionOptions: RedactionOptions;
+export interface UrlRedactionOptions {
+    readonly redactedValue?: string;
+    readonly sensitiveParams?: readonly string[];
+}
+/**
+ * Redacts sensitive query parameters from a URL string.
+ * Useful for preventing secret leakage via telemetry/logging.
+ *
+ * @example
+ * ```ts
+ * redactUrlQueryParams("https://api.example.com/v1?token=secret123&page=1")
+ * // => "https://api.example.com/v1?token=[REDACTED]&page=1"
+ * ```
+ */
+export declare function redactUrlQueryParams(url: string, options?: UrlRedactionOptions): string;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/src/observability/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../../src/observability/redaction.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrD;AAYD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACzC,OAAO,GAAE,gBAAqB,GAC7B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAYlC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC5E,KAAK,EAAE,CAAC,EACR,OAAO,GAAE,gBAAqB,GAC7B,CAAC,CAWH;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,gBAWjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAalC,CAAC;AAkBF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAsBR"}

package/dist/src/observability/redaction.js

@@ -0,0 +1,112 @@
+const defaultSensitiveHeaders = [
+    "authorization",
+    "proxy-authorization",
+    "cookie",
+    "set-cookie",
+    "x-api-key",
+];
+const defaultSensitiveFieldPatterns = [/token/i, /secret/i, /password/i, /api[-_]?key/i];
+/**
+ * Redacts sensitive header values while preserving keys.
+ */
+export function redactHeaders(headers, options = {}) {
+    const redactedValue = options.redactedValue ?? "[REDACTED]";
+    const sensitive = new Set((options.sensitiveHeaderNames ?? defaultSensitiveHeaders).map((key) => key.toLowerCase()));
+    const result = {};
+    for (const [key, value] of Object.entries(headers)) {
+        result[key] = sensitive.has(key.toLowerCase()) ? redactedValue : value;
+    }
+    return result;
+}
+/**
+ * Redacts sensitive object fields by key pattern.
+ */
+export function redactObjectFields(value, options = {}) {
+    const redactedValue = options.redactedValue ?? "[REDACTED]";
+    const patterns = options.sensitiveFieldPatterns ?? defaultSensitiveFieldPatterns;
+    const result = {};
+    for (const [key, fieldValue] of Object.entries(value)) {
+        const sensitive = patterns.some((pattern) => pattern.test(key));
+        result[key] = sensitive ? redactedValue : fieldValue;
+    }
+    return result;
+}
+/**
+ * Standard PII (Personally Identifiable Information) Redaction Profile.
+ * Redacts common PII field names like email, phone, ssn, address.
+ */
+export const piiRedactionOptions = {
+    sensitiveFieldPatterns: [
+        /email/i,
+        /phone/i,
+        /ssn/i,
+        /social.?security/i,
+        /address/i,
+        /credit.?card/i,
+        /dob/i,
+        /date.?of.?birth/i,
+    ],
+};
+/**
+ * Standard Auth Redaction Profile.
+ * Extends the default auth redaction with stricter keys and patterns.
+ */
+export const authRedactionOptions = {
+    sensitiveHeaderNames: [
+        ...defaultSensitiveHeaders,
+        "x-amz-security-token",
+        "x-goog-api-key",
+    ],
+    sensitiveFieldPatterns: [
+        ...defaultSensitiveFieldPatterns,
+        /client.?secret/i,
+        /access.?token/i,
+        /refresh.?token/i,
+        /auth/i,
+    ],
+};
+/**
+ * Default query parameter names considered sensitive in URLs.
+ */
+const defaultSensitiveQueryParams = [
+    "token",
+    "key",
+    "api_key",
+    "apiKey",
+    "apikey",
+    "secret",
+    "password",
+    "access_token",
+    "refresh_token",
+    "client_secret",
+];
+/**
+ * Redacts sensitive query parameters from a URL string.
+ * Useful for preventing secret leakage via telemetry/logging.
+ *
+ * @example
+ * ```ts
+ * redactUrlQueryParams("https://api.example.com/v1?token=secret123&page=1")
+ * // => "https://api.example.com/v1?token=[REDACTED]&page=1"
+ * ```
+ */
+export function redactUrlQueryParams(url, options = {}) {
+    const redactedValue = options.redactedValue ?? "[REDACTED]";
+    const sensitiveParams = new Set((options.sensitiveParams ?? defaultSensitiveQueryParams).map((p) => p.toLowerCase()));
+    try {
+        const parsed = new URL(url);
+        let redacted = false;
+        for (const key of [...parsed.searchParams.keys()]) {
+            if (sensitiveParams.has(key.toLowerCase())) {
+                parsed.searchParams.set(key, redactedValue);
+                redacted = true;
+            }
+        }
+        return redacted ? parsed.toString() : url;
+    }
+    catch {
+        // If the URL is not parseable (e.g. relative path), return as-is
+        return url;
+    }
+}
+//# sourceMappingURL=redaction.js.map

package/dist/src/observability/redaction.js.map

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

package/dist/src/policy/guardrails.d.ts

@@ -0,0 +1,14 @@
+import type { Middleware } from "../types/http";
+export interface PolicyMetadata {
+    readonly name: string;
+    readonly kind: "timeout" | "retry" | "hedge" | "cache" | "concurrency";
+    readonly maxRetries?: number;
+    readonly maxConcurrent?: number;
+}
+export type PolicyAwareMiddleware = Middleware & {
+    readonly __pureqPolicy?: PolicyMetadata;
+};
+export declare function markPolicyMiddleware<T extends Middleware>(middleware: T, metadata: PolicyMetadata): T;
+export declare function getPolicyMetadata(middleware: Middleware): PolicyMetadata | undefined;
+export declare function validatePolicyGuardrails(middlewares: readonly Middleware[]): void;
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/src/policy/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../../src/policy/guardrails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC;CACzC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,cAAc,GAAG,CAAC,CASrG;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAEpF;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CA0BjF"}

package/dist/src/policy/guardrails.js

@@ -0,0 +1,36 @@
+export function markPolicyMiddleware(middleware, metadata) {
+    Object.defineProperty(middleware, "__pureqPolicy", {
+        value: metadata,
+        enumerable: false,
+        configurable: false,
+        writable: false,
+    });
+    return middleware;
+}
+export function getPolicyMetadata(middleware) {
+    return middleware.__pureqPolicy;
+}
+export function validatePolicyGuardrails(middlewares) {
+    const policies = middlewares
+        .map((middleware) => getPolicyMetadata(middleware))
+        .filter((policy) => policy !== undefined);
+    const retryPolicies = policies.filter((policy) => policy.kind === "retry");
+    if (retryPolicies.length > 1) {
+        throw new Error("pureq: multiple retry policies are not allowed in one client");
+    }
+    const timeoutPolicies = policies.filter((policy) => policy.kind === "timeout");
+    const hasDeadline = timeoutPolicies.some((policy) => policy.name === "deadline");
+    const hasDefaultTimeout = timeoutPolicies.some((policy) => policy.name === "defaultTimeout");
+    if (hasDeadline && hasDefaultTimeout) {
+        throw new Error("pureq: use deadline or defaultTimeout, not both");
+    }
+    if (timeoutPolicies.length > 1) {
+        throw new Error("pureq: do not combine multiple timeout policies in one client");
+    }
+    for (const policy of retryPolicies) {
+        if (policy.maxRetries !== undefined && policy.maxRetries > 10) {
+            throw new Error("pureq: retry maxRetries must be 10 or less");
+        }
+    }
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/src/policy/guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.js","sourceRoot":"","sources":["../../../src/policy/guardrails.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,oBAAoB,CAAuB,UAAa,EAAE,QAAwB;IAChG,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,eAAe,EAAE;QACjD,KAAK,EAAE,QAAQ;QACf,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,KAAK;QACnB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAsB;IACtD,OAAQ,UAAoC,CAAC,aAAa,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,WAAkC;IACzE,MAAM,QAAQ,GAAG,WAAW;SACzB,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,MAAM,EAA4B,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAEtE,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAC3E,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC/E,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACjF,MAAM,iBAAiB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;IAC7F,IAAI,WAAW,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;AACH,CAAC"}