@pureq/pureq 1.0.0

package/dist/src/client/createClient.js

@@ -0,0 +1,310 @@
+import { compose } from "../middleware/compose";
+import { execute } from "../executor/execute";
+import { validatePolicyGuardrails } from "../policy/guardrails";
+import { generateSecureId } from "../utils/crypto";
+import { err, httpErrorFromResponse, ok, toPureqError, } from "../types/result";
+function sortByPriority(items) {
+    return [...items].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+}
+/**
+ * Creates a new, immutable pureq client.
+ */
+export function createClient(baseOptions = {}) {
+    const commonMiddlewares = baseOptions.middlewares || [];
+    validatePolicyGuardrails(commonMiddlewares);
+    const requestInterceptors = sortByPriority(baseOptions.requestInterceptors ?? []);
+    const responseInterceptors = sortByPriority(baseOptions.responseInterceptors ?? []);
+    const requestIdHeaderName = baseOptions.requestIdHeaderName ?? "x-request-id";
+    function defaultRequestIdFactory() {
+        return generateSecureId("pureq");
+    }
+    const requestIdFactory = baseOptions.requestIdFactory ?? defaultRequestIdFactory;
+    const executeWithBoundaries = (req) => {
+        const options = {
+            ...(baseOptions.adapter !== undefined ? { adapter: baseOptions.adapter } : {}),
+            ...(baseOptions.bodySerializer !== undefined
+                ? { bodySerializer: baseOptions.bodySerializer }
+                : {}),
+        };
+        return execute(req, options);
+    };
+    function errorMetadataFromRequest(req, cause) {
+        const retryCountFromReq = typeof req._meta?.retryCount === "number" ? req._meta.retryCount : undefined;
+        const retryCountFromCause = typeof cause === "object" && cause !== null && "__pureqRetryCount" in cause
+            ? cause.__pureqRetryCount
+            : undefined;
+        const requestId = typeof req._meta?.requestId === "string" ? req._meta.requestId : undefined;
+        const retryCount = typeof retryCountFromCause === "number"
+            ? retryCountFromCause
+            : retryCountFromReq;
+        return {
+            method: req.method,
+            url: req.url,
+            ...(requestId !== undefined ? { requestId } : {}),
+            ...(retryCount !== undefined ? { retryCount } : {}),
+        };
+    }
+    /**
+     * Internal execution logic
+     */
+    async function run(req) {
+        let transformedReq = req;
+        const requestId = typeof transformedReq._meta?.requestId === "string"
+            ? transformedReq._meta.requestId
+            : requestIdFactory();
+        const startedAt = typeof transformedReq._meta?.startedAt === "number"
+            ? transformedReq._meta.startedAt
+            : Date.now();
+        baseOptions.hooks?.onRequestStart?.({
+            phase: "start",
+            at: startedAt,
+            requestId,
+            method: transformedReq.method,
+            url: transformedReq.url,
+            startedAt,
+        });
+        for (const interceptor of requestInterceptors) {
+            const nextReq = await interceptor.handler(transformedReq);
+            transformedReq = {
+                ...transformedReq,
+                ...nextReq,
+                _middlewares: transformedReq._middlewares,
+            };
+        }
+        const allMiddlewares = [...commonMiddlewares, ...transformedReq._middlewares];
+        const dispatchFn = compose(allMiddlewares, executeWithBoundaries);
+        let response = await dispatchFn(transformedReq);
+        for (const interceptor of responseInterceptors) {
+            response = await interceptor.handler(response, transformedReq);
+        }
+        const latencyMs = Date.now() - startedAt;
+        baseOptions.hooks?.onRequestSuccess?.({
+            phase: "success",
+            at: Date.now(),
+            requestId,
+            method: transformedReq.method,
+            url: transformedReq.url,
+            startedAt,
+            latencyMs,
+            durationMs: latencyMs,
+            status: response.status,
+            retryCount: typeof transformedReq._meta?.retryCount === "number"
+                ? transformedReq._meta.retryCount
+                : 0,
+        });
+        return response;
+    }
+    async function runResult(req) {
+        try {
+            return ok(await run(req));
+        }
+        catch (cause) {
+            const error = toPureqError(cause, errorMetadataFromRequest(req, cause));
+            const startedAt = typeof req._meta?.startedAt === "number" ? req._meta.startedAt : Date.now();
+            const requestId = typeof req._meta?.requestId === "string" ? req._meta.requestId : requestIdFactory();
+            const latencyMs = Date.now() - startedAt;
+            baseOptions.hooks?.onRequestError?.({
+                phase: "error",
+                at: Date.now(),
+                requestId,
+                method: req.method,
+                url: req.url,
+                startedAt,
+                latencyMs,
+                durationMs: latencyMs,
+                errorKind: error.kind,
+                error,
+            });
+            return err(error);
+        }
+    }
+    async function toJsonResult(resultOrPromise, reqForMeta) {
+        const result = await resultOrPromise;
+        if (!result.ok) {
+            return result;
+        }
+        const response = result.data;
+        if (!response.ok) {
+            return err(httpErrorFromResponse(response, errorMetadataFromRequest(reqForMeta)));
+        }
+        try {
+            const data = await response.json();
+            return ok(data);
+        }
+        catch (cause) {
+            return err(toPureqError(cause, errorMetadataFromRequest(reqForMeta, cause)));
+        }
+    }
+    async function toJson(resultOrPromise, reqForMeta) {
+        const parsed = await toJsonResult(resultOrPromise, reqForMeta);
+        if (!parsed.ok) {
+            throw new Error(parsed.error.message);
+        }
+        return parsed.data;
+    }
+    /**
+     * Request template preparation
+     */
+    function prepareRequest(method, url, options = {}) {
+        const formattedBaseURL = baseOptions.baseURL?.replace(/\/$/, "") ?? "";
+        const isAbsoluteURL = /^[a-zA-Z][a-zA-Z\d+.-]*:\/\//.test(url);
+        const isProtocolRelativeURL = url.startsWith("//");
+        const isAbsolutePath = url.startsWith("/");
+        const fullURL = isAbsoluteURL || isProtocolRelativeURL
+            ? url
+            : formattedBaseURL
+                ? `${formattedBaseURL}${isAbsolutePath ? url : `/${url}`}`
+                : url;
+        const requestId = requestIdFactory();
+        const mergedHeaders = {
+            ...(baseOptions.headers ?? {}),
+            ...(options.headers ?? {}),
+        };
+        if (!(requestIdHeaderName in mergedHeaders)) {
+            mergedHeaders[requestIdHeaderName] = requestId;
+        }
+        const traceContext = baseOptions.traceContextProvider?.();
+        if (traceContext?.traceparent && !mergedHeaders.traceparent) {
+            mergedHeaders.traceparent = traceContext.traceparent;
+        }
+        if (traceContext?.tracestate && !mergedHeaders.tracestate) {
+            mergedHeaders.tracestate = traceContext.tracestate;
+        }
+        return {
+            method,
+            url: fullURL,
+            ...(options.params !== undefined ? { params: options.params } : {}),
+            ...(options.query !== undefined ? { query: options.query } : {}),
+            ...(options.body !== undefined ? { body: options.body } : {}),
+            ...(options.signal !== undefined ? { signal: options.signal } : {}),
+            ...(options.timeout !== undefined ? { timeout: options.timeout } : {}),
+            headers: mergedHeaders,
+            _middlewares: [],
+            _meta: {
+                requestId,
+                startedAt: Date.now(),
+                retryCount: 0,
+            },
+        };
+    }
+    function prepareFetchRequest(url, init = {}) {
+        const { method, ...rest } = init;
+        return prepareRequest(method ?? "GET", url, rest);
+    }
+    /**
+     * Shared helper for body-carrying methods (POST, PUT, PATCH) to avoid
+     * repeating the same options-spreading boilerplate.
+     */
+    function prepareBodyRequest(method, url, body, options) {
+        return prepareRequest(method, url, {
+            ...(options?.params !== undefined ? { params: options.params } : {}),
+            ...(options?.query !== undefined ? { query: options.query } : {}),
+            ...(options?.headers !== undefined ? { headers: options.headers } : {}),
+            ...(options?.signal !== undefined ? { signal: options.signal } : {}),
+            ...(options?.timeout !== undefined ? { timeout: options.timeout } : {}),
+            ...(body !== undefined ? { body } : {}),
+        });
+    }
+    const client = {
+        use(middleware) {
+            return createClient({
+                ...baseOptions,
+                middlewares: [...commonMiddlewares, middleware],
+            });
+        },
+        useRequestInterceptor(interceptor, options) {
+            const entry = {
+                handler: interceptor,
+                ...(options?.priority !== undefined ? { priority: options.priority } : {}),
+                ...(options?.name !== undefined ? { name: options.name } : {}),
+            };
+            return createClient({
+                ...baseOptions,
+                requestInterceptors: [...(baseOptions.requestInterceptors ?? []), entry],
+            });
+        },
+        useResponseInterceptor(interceptor, options) {
+            const entry = {
+                handler: interceptor,
+                ...(options?.priority !== undefined ? { priority: options.priority } : {}),
+                ...(options?.name !== undefined ? { name: options.name } : {}),
+            };
+            return createClient({
+                ...baseOptions,
+                responseInterceptors: [...(baseOptions.responseInterceptors ?? []), entry],
+            });
+        },
+        request(config) {
+            return run(prepareRequest(config.method, config.url, config));
+        },
+        requestResult(config) {
+            return runResult(prepareRequest(config.method, config.url, config));
+        },
+        requestJson(config) {
+            const req = prepareRequest(config.method, config.url, config);
+            return toJson(runResult(req), req);
+        },
+        requestJsonResult(config) {
+            const req = prepareRequest(config.method, config.url, config);
+            return toJsonResult(runResult(req), req);
+        },
+        get(url, options) {
+            return run(prepareRequest("GET", url, options));
+        },
+        getResult(url, options) {
+            return runResult(prepareRequest("GET", url, options));
+        },
+        getJson(url, options) {
+            const req = prepareRequest("GET", url, options);
+            return toJson(runResult(req), req);
+        },
+        getJsonResult(url, options) {
+            const req = prepareRequest("GET", url, options);
+            return toJsonResult(runResult(req), req);
+        },
+        post(url, body, options) {
+            return run(prepareBodyRequest("POST", url, body, options));
+        },
+        postResult(url, body, options) {
+            return runResult(prepareBodyRequest("POST", url, body, options));
+        },
+        postJson(url, body, options) {
+            const req = prepareBodyRequest("POST", url, body, options);
+            return toJson(runResult(req), req);
+        },
+        postJsonResult(url, body, options) {
+            const req = prepareBodyRequest("POST", url, body, options);
+            return toJsonResult(runResult(req), req);
+        },
+        put(url, body, options) {
+            return run(prepareBodyRequest("PUT", url, body, options));
+        },
+        putResult(url, body, options) {
+            return runResult(prepareBodyRequest("PUT", url, body, options));
+        },
+        patch(url, body, options) {
+            return run(prepareBodyRequest("PATCH", url, body, options));
+        },
+        patchResult(url, body, options) {
+            return runResult(prepareBodyRequest("PATCH", url, body, options));
+        },
+        delete(url, options) {
+            return run(prepareRequest("DELETE", url, options));
+        },
+        deleteResult(url, options) {
+            return runResult(prepareRequest("DELETE", url, options));
+        },
+        fetch(url, init) {
+            return run(prepareFetchRequest(url, init));
+        },
+        fetchResult(url, init) {
+            return runResult(prepareFetchRequest(url, init));
+        },
+        fetchJson(url, init) {
+            const req = prepareFetchRequest(url, init);
+            return toJson(runResult(req), req);
+        },
+    };
+    return client;
+}
+//# sourceMappingURL=createClient.js.map

package/dist/src/client/createClient.js.map

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

package/dist/src/executor/execute.d.ts

@@ -0,0 +1,19 @@
+import type { BodySerializer, HttpAdapter, RequestConfig } from "../types/http";
+import { HttpResponse } from "../response/response";
+import { type HttpResult } from "../types/result";
+export interface ExecuteOptions {
+    readonly adapter?: HttpAdapter;
+    readonly bodySerializer?: BodySerializer;
+}
+/**
+ * Performs actual HTTP execution using the global fetch API.
+ * This is the ONLY file allowed to have HTTP-related side effects.
+ */
+export declare function execute(req: RequestConfig, options?: ExecuteOptions): Promise<HttpResponse>;
+/**
+ * Non-throwing execution API that always returns a Result.
+ * HTTP status errors are represented by HttpResponse with ok=false.
+ * Transport/runtime failures are represented by Err(PureqError).
+ */
+export declare function executeResult(req: RequestConfig, options?: ExecuteOptions): Promise<HttpResult>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/src/executor/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/executor/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAkDzE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAuCD;;;GAGG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAkCrG;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAOzG"}

package/dist/src/executor/execute.js

@@ -0,0 +1,121 @@
+import { HttpResponse } from "../response/response";
+import { err, ok, toPureqError } from "../types/result";
+import { jsonBodySerializer } from "../serializers/jsonBodySerializer";
+/**
+ * Builds the effective URL with path parameter replacement and query string expansion.
+ * Pure function: No side effects.
+ */
+function buildFullURL(url, params, query) {
+    let finalUrl = url;
+    // Replace path parameters (e.g., /users/:id)
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            // Use replaceAll to handle multiple occurrences of the same parameter
+            finalUrl = finalUrl.replaceAll(`:${key}`, encodeURIComponent(value));
+        }
+    }
+    // Detect any unreplaced path parameter placeholders
+    const unreplaced = finalUrl.match(/:([a-zA-Z_]\w*)/g);
+    if (unreplaced) {
+        throw new Error(`pureq: unresolved path parameters: ${unreplaced.join(", ")}`);
+    }
+    // Handle query parameters
+    if (query) {
+        const searchParams = new URLSearchParams();
+        for (const [key, value] of Object.entries(query)) {
+            if (Array.isArray(value)) {
+                value.forEach((v) => searchParams.append(key, String(v)));
+            }
+            else {
+                searchParams.append(key, String(value));
+            }
+        }
+        const queryString = searchParams.toString();
+        if (queryString) {
+            finalUrl += (finalUrl.includes("?") ? "&" : "?") + queryString;
+        }
+    }
+    return finalUrl;
+}
+const defaultBodySerializer = jsonBodySerializer;
+function buildManagedSignal(externalSignal, timeoutMs) {
+    const controller = new AbortController();
+    let timeoutId;
+    const abortFromExternal = () => {
+        controller.abort(externalSignal?.reason ?? new DOMException("Aborted", "AbortError"));
+    };
+    if (externalSignal) {
+        if (externalSignal.aborted) {
+            abortFromExternal();
+        }
+        else {
+            externalSignal.addEventListener("abort", abortFromExternal, { once: true });
+        }
+    }
+    if (timeoutMs !== undefined && timeoutMs > 0) {
+        timeoutId = setTimeout(() => {
+            controller.abort(new Error(`pureq: request timeout after ${timeoutMs}ms`));
+        }, timeoutMs);
+    }
+    const cleanup = () => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        if (externalSignal) {
+            externalSignal.removeEventListener("abort", abortFromExternal);
+        }
+    };
+    return { signal: controller.signal, cleanup };
+}
+/**
+ * Performs actual HTTP execution using the global fetch API.
+ * This is the ONLY file allowed to have HTTP-related side effects.
+ */
+export async function execute(req, options = {}) {
+    const adapter = options.adapter ?? fetch;
+    const serializer = options.bodySerializer ?? defaultBodySerializer;
+    const fullUrl = buildFullURL(req.url, req.params, req.query);
+    const { payload, contentType } = serializer.serialize(req.body);
+    const { signal, cleanup } = buildManagedSignal(req.signal, req.timeout);
+    const init = {
+        method: req.method,
+        headers: req.headers ?? {},
+        body: req.method !== "GET" && req.method !== "HEAD" ? payload : null,
+        signal,
+    };
+    // Provide default JSON headers only when body was JSON-encoded by pureq.
+    // Use case-insensitive check to avoid duplicate Content-Type headers.
+    const hasContentType = req.headers &&
+        Object.keys(req.headers).some((k) => k.toLowerCase() === "content-type");
+    if (contentType && !hasContentType) {
+        init.headers = {
+            ...req.headers,
+            "Content-Type": contentType,
+        };
+    }
+    try {
+        const res = await adapter(fullUrl, init);
+        cleanup();
+        return new HttpResponse(res);
+    }
+    catch (error) {
+        cleanup();
+        // These are execution errors (network, DNS, timeout etc.), NOT status errors.
+        throw error;
+    }
+}
+/**
+ * Non-throwing execution API that always returns a Result.
+ * HTTP status errors are represented by HttpResponse with ok=false.
+ * Transport/runtime failures are represented by Err(PureqError).
+ */
+export async function executeResult(req, options = {}) {
+    try {
+        const response = await execute(req, options);
+        return ok(response);
+    }
+    catch (cause) {
+        return err(toPureqError(cause));
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/src/executor/execute.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * pureq: Functional, immutable, and type-safe HTTP layer library.
+ */
+export * from "./client/createClient";
+export * from "./types/http";
+export * from "./middleware/compose";
+export * from "./middleware/retry";
+export * from "./middleware/dedupe";
+export * from "./middleware/httpCache";
+export * from "./middleware/stalePolicy";
+export * from "./middleware/hedge";
+export * from "./middleware/offlineQueue";
+export * from "./middleware/defaultTimeout";
+export * from "./middleware/deadline";
+export * from "./middleware/concurrencyLimit";
+export * from "./middleware/circuitBreaker";
+export * from "./middleware/circuitBreakerKeys";
+export * from "./middleware/idempotencyKey";
+export * from "./middleware/diagnostics";
+export * from "./middleware/diagnosticsExporters";
+export * from "./middleware/presets";
+export * from "./policy/guardrails";
+export * from "./response/response";
+export * from "./executor/execute";
+export * from "./types/result";
+export * from "./types/events";
+export * from "./observability/otelMapping";
+export * from "./observability/otelProfiles";
+export * from "./observability/redaction";
+export * from "./adapters/fetchAdapter";
+export * from "./adapters/instrumentedAdapter";
+export * from "./serializers/jsonBodySerializer";
+export * from "./serializers/formUrlEncodedSerializer";
+export type { ExtractParams, TypedRequestOptions } from "./utils/url";
+export { generateSecureId } from "./utils/crypto";
+export { redactUrlQueryParams, type UrlRedactionOptions } from "./observability/redaction";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,36 @@
+/**
+ * pureq: Functional, immutable, and type-safe HTTP layer library.
+ */
+export * from "./client/createClient";
+export * from "./types/http";
+export * from "./middleware/compose";
+export * from "./middleware/retry";
+export * from "./middleware/dedupe";
+export * from "./middleware/httpCache";
+export * from "./middleware/stalePolicy";
+export * from "./middleware/hedge";
+export * from "./middleware/offlineQueue";
+export * from "./middleware/defaultTimeout";
+export * from "./middleware/deadline";
+export * from "./middleware/concurrencyLimit";
+export * from "./middleware/circuitBreaker";
+export * from "./middleware/circuitBreakerKeys";
+export * from "./middleware/idempotencyKey";
+export * from "./middleware/diagnostics";
+export * from "./middleware/diagnosticsExporters";
+export * from "./middleware/presets";
+export * from "./policy/guardrails";
+export * from "./response/response";
+export * from "./executor/execute";
+export * from "./types/result";
+export * from "./types/events";
+export * from "./observability/otelMapping";
+export * from "./observability/otelProfiles";
+export * from "./observability/redaction";
+export * from "./adapters/fetchAdapter";
+export * from "./adapters/instrumentedAdapter";
+export * from "./serializers/jsonBodySerializer";
+export * from "./serializers/formUrlEncodedSerializer";
+export { generateSecureId } from "./utils/crypto";
+export { redactUrlQueryParams } from "./observability/redaction";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,77 @@
+import type { Middleware, RequestConfig } from "../types/http";
+import type { HttpResponse } from "../response/response";
+export declare class PureqCircuitOpenError extends Error {
+    readonly code = "PUREQ_CIRCUIT_OPEN";
+    constructor(message?: string);
+}
+export interface CircuitBreakerHooks {
+    readonly onOpen?: (event: {
+        readonly key: string;
+        readonly openedAt: number;
+        readonly failures: number;
+    }) => void;
+    readonly onHalfOpen?: (event: {
+        readonly key: string;
+        readonly at: number;
+    }) => void;
+    readonly onClose?: (event: {
+        readonly key: string;
+        readonly at: number;
+    }) => void;
+    readonly onStateChange?: (event: {
+        readonly key: string;
+        readonly from: State;
+        readonly to: State;
+        readonly at: number;
+    }) => void;
+}
+export interface CircuitBreakerOptions {
+    readonly failureThreshold?: number;
+    readonly successThreshold?: number;
+    readonly cooldownMs?: number;
+    readonly keyBuilder?: (req: Readonly<RequestConfig>) => string;
+    readonly maxEntries?: number;
+    readonly entryTtlMs?: number;
+    readonly shouldTrip?: (context: {
+        readonly key: string;
+        readonly req: Readonly<RequestConfig>;
+        readonly response?: HttpResponse;
+        readonly error?: unknown;
+    }) => boolean;
+    readonly hooks?: CircuitBreakerHooks;
+}
+type State = "closed" | "open" | "half-open";
+export interface CircuitSnapshotEntry {
+    readonly key: string;
+    readonly state: State;
+    readonly failureCount: number;
+    readonly successCount: number;
+    readonly openedAt: number;
+    readonly lastChangedAt: number;
+    readonly lastAccessedAt: number;
+}
+export interface CircuitSnapshot {
+    readonly size: number;
+    readonly summary: {
+        readonly closed: number;
+        readonly open: number;
+        readonly halfOpen: number;
+    };
+    readonly entries: readonly CircuitSnapshotEntry[];
+}
+export interface CircuitBreakerController {
+    readonly middleware: Middleware;
+    readonly snapshot: () => CircuitSnapshot;
+    readonly reset: (key?: string) => void;
+}
+/**
+ * Circuit breaker middleware for downstream dependency protection.
+ */
+export declare function circuitBreaker(options?: CircuitBreakerOptions): Middleware;
+/**
+ * Stateful circuit breaker controller.
+ * Provides middleware plus runtime inspection/reset APIs.
+ */
+export declare function createCircuitBreaker(options?: CircuitBreakerOptions): CircuitBreakerController;
+export {};
+//# sourceMappingURL=circuitBreaker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"circuitBreaker.d.ts","sourceRoot":"","sources":["../../../src/middleware/circuitBreaker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,wBAAwB;gBAEzB,OAAO,SAAmC;CAIvD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,KAAK,IAAI,CAAC;IACX,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;KACrB,KAAK,IAAI,CAAC;IACX,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;KACrB,KAAK,IAAI,CAAC;IACX,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;QACrB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;KACrB,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK,MAAM,CAAC;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE;QAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;QACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;QACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;KAC1B,KAAK,OAAO,CAAC;IACd,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED,KAAK,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAY7C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,eAAe,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAeD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,UAAU,CAE9E;AAwBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,wBAAwB,CA2NlG"}