@pureq/pureq 1.0.0

package/dist/src/utils/policyTrace.js

@@ -0,0 +1,34 @@
+/**
+ * Shared utility for appending policy trace entries to the internal
+ * request metadata. The _meta object is intentionally mutable to allow
+ * trace accumulation as the request traverses the middleware pipeline.
+ *
+ * IMPORTANT: When forking requests (e.g. hedge middleware), callers
+ * must deep-copy _meta first to prevent cross-fork trace pollution.
+ */
+export function appendPolicyTrace(req, entry) {
+    const mutableReq = req;
+    const currentMeta = mutableReq._meta ?? {};
+    const existingTrace = Array.isArray(currentMeta.policyTrace)
+        ? currentMeta.policyTrace
+        : [];
+    currentMeta.policyTrace = [...existingTrace, entry];
+    mutableReq._meta = currentMeta;
+}
+/**
+ * Creates a deep copy of the internal _meta object so that forked
+ * request paths (e.g. primary vs hedge) do not share mutable state.
+ */
+export function deepCopyMeta(req) {
+    const meta = req._meta;
+    if (!meta) {
+        return {};
+    }
+    return {
+        ...meta,
+        ...(Array.isArray(meta.policyTrace)
+            ? { policyTrace: [...meta.policyTrace] }
+            : {}),
+    };
+}
+//# sourceMappingURL=policyTrace.js.map

package/dist/src/utils/policyTrace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policyTrace.js","sourceRoot":"","sources":["../../../src/utils/policyTrace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,UAAU,iBAAiB,CAAC,GAAkB,EAAE,KAAuB;IAC3E,MAAM,UAAU,GAAG,GAA0D,CAAC;IAC9E,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;IAE3C,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC;QAC1D,CAAC,CAAE,WAAW,CAAC,WAA2C;QAC1D,CAAC,CAAC,EAAE,CAAC;IAEP,WAAW,CAAC,WAAW,GAAG,CAAC,GAAG,aAAa,EAAE,KAAK,CAAC,CAAC;IACpD,UAAU,CAAC,KAAK,GAAG,WAAW,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAkB;IAElB,MAAM,IAAI,GAAI,GAA2C,CAAC,KAAK,CAAC;IAChE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,GAAG,IAAI;QACP,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;YACjC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE;YACxC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC"}

package/dist/src/utils/stableKey.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared stable key generation utilities for deduplication and caching.
+ * Produces deterministic string keys from request properties so that
+ * identical requests always map to the same cache/dedupe slot.
+ */
+import type { QueryParams } from "../types/http";
+/**
+ * Returns a deterministic string from a record of key-value pairs,
+ * sorted alphabetically by key.
+ */
+export declare function stableKeyValues(record: Readonly<Record<string, string>> | undefined): string;
+/**
+ * Returns a deterministic string from a QueryParams map,
+ * sorted alphabetically by key with arrays expanded inline.
+ */
+export declare function stableQuery(query: QueryParams | undefined): string;
+//# sourceMappingURL=stableKey.d.ts.map

package/dist/src/utils/stableKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stableKey.d.ts","sourceRoot":"","sources":["../../../src/utils/stableKey.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GAAG,MAAM,CAS5F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAqBlE"}

package/dist/src/utils/stableKey.js

@@ -0,0 +1,41 @@
+/**
+ * Shared stable key generation utilities for deduplication and caching.
+ * Produces deterministic string keys from request properties so that
+ * identical requests always map to the same cache/dedupe slot.
+ */
+/**
+ * Returns a deterministic string from a record of key-value pairs,
+ * sorted alphabetically by key.
+ */
+export function stableKeyValues(record) {
+    if (!record) {
+        return "";
+    }
+    return Object.entries(record)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
+        .join("&");
+}
+/**
+ * Returns a deterministic string from a QueryParams map,
+ * sorted alphabetically by key with arrays expanded inline.
+ */
+export function stableQuery(query) {
+    if (!query) {
+        return "";
+    }
+    const keys = Object.keys(query).sort((a, b) => a.localeCompare(b));
+    const parts = [];
+    for (const key of keys) {
+        const value = query[key];
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(item))}`);
+            }
+            continue;
+        }
+        parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+    }
+    return parts.join("&");
+}
+//# sourceMappingURL=stableKey.js.map

package/dist/src/utils/stableKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stableKey.js","sourceRoot":"","sources":["../../../src/utils/stableKey.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoD;IAClF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1B,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;SAChF,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,SAAS;QACX,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/src/utils/url.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Utility for extracting path parameters from a template string.
+ * Supports patterns like "/users/:id" or "/users/:userId/posts/:postId".
+ */
+export type ExtractParams<T extends string> = string extends T ? Record<string, string> : T extends `${infer _Start}/:${infer Param}/${infer Rest}` ? {
+    [K in CleanParam<Param> | keyof ExtractParams<`/${Rest}`>]: string;
+} : T extends `${infer _Start}/:${infer Param}` ? {
+    [K in CleanParam<Param>]: string;
+} : {};
+type CleanParam<P extends string> = P extends `${infer Name}?${string}` ? Name : P extends `${infer Name}#${string}` ? Name : P;
+/**
+ * Type-safe request options based on the URL path.
+ * Forces the user to provide correct parameters for a given URL template.
+ */
+export interface TypedRequestOptions<Path extends string> {
+    readonly params: ExtractParams<Path>;
+    readonly query?: Readonly<Record<string, string | string[]>>;
+    readonly body?: unknown;
+    readonly headers?: Readonly<Record<string, string>>;
+}
+export {};
+//# sourceMappingURL=url.d.ts.map

package/dist/src/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IACxC,MAAM,SAAS,CAAC,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,CAAC,SAAS,GAAG,MAAM,MAAM,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,GACvD;KAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,MAAM;CAAE,GACtE,CAAC,SAAS,GAAG,MAAM,MAAM,KAAK,MAAM,KAAK,EAAE,GACzC;KAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM;CAAE,GACpC,EAAE,CAAC;AAEb,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,IAC9B,CAAC,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,EAAE,GAC/B,IAAI,GACJ,CAAC,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,EAAE,GACjC,IAAI,GACJ,CAAC,CAAC;AAEV;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,IAAI,SAAS,MAAM;IACtD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD"}

package/dist/src/utils/url.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=url.js.map

package/dist/src/utils/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/utils/url.ts"],"names":[],"mappings":""}

package/dist/tests/adapter-serializer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter-serializer.test.d.ts.map

package/dist/tests/adapter-serializer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-serializer.test.d.ts","sourceRoot":"","sources":["../../tests/adapter-serializer.test.ts"],"names":[],"mappings":""}

package/dist/tests/adapter-serializer.test.js

@@ -0,0 +1,59 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createClient } from "../src/index";
+describe("adapter and serializer boundaries", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("uses custom adapter instead of global fetch", async () => {
+        const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response("fallback", { status: 200 }));
+        const calls = [];
+        const adapter = async (url, init) => {
+            calls.push({ url, ...(init.method !== undefined ? { method: init.method } : {}) });
+            return new Response(JSON.stringify({ ok: true }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        };
+        const client = createClient({ adapter });
+        const data = await client.getJson("https://api.example.com/ping");
+        expect(data.ok).toBe(true);
+        expect(calls).toEqual([{ url: "https://api.example.com/ping", method: "GET" }]);
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+    it("keeps relative URL when baseURL is not provided", async () => {
+        const adapter = vi.fn(async (_url, _init) => new Response("{}", { status: 200 }));
+        const client = createClient({ adapter });
+        await client.get("health");
+        expect(adapter).toHaveBeenCalledTimes(1);
+        expect(adapter.mock.calls[0]?.[0]).toBe("health");
+    });
+    it("uses custom serializer and content type for object body", async () => {
+        const adapter = vi.fn(async (_url, init) => {
+            return new Response("{}", {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        });
+        const client = createClient({
+            adapter,
+            bodySerializer: {
+                serialize(body) {
+                    if (typeof body === "object" && body !== null) {
+                        return {
+                            payload: `payload=${JSON.stringify(body)}`,
+                            contentType: "application/x-www-form-urlencoded",
+                        };
+                    }
+                    return { payload: body == null ? null : String(body) };
+                },
+            },
+        });
+        await client.post("https://api.example.com/form", { a: 1 });
+        const init = adapter.mock.calls[0]?.[1];
+        expect(init).toBeDefined();
+        expect(init?.body).toBe('payload={"a":1}');
+        const headers = (init?.headers ?? {});
+        expect(headers["Content-Type"]).toBe("application/x-www-form-urlencoded");
+    });
+});
+//# sourceMappingURL=adapter-serializer.test.js.map

package/dist/tests/adapter-serializer.test.js.map

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

package/dist/tests/browser-runtime.smoke.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-runtime.smoke.test.d.ts.map

package/dist/tests/browser-runtime.smoke.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-runtime.smoke.test.d.ts","sourceRoot":"","sources":["../../tests/browser-runtime.smoke.test.ts"],"names":[],"mappings":""}

package/dist/tests/browser-runtime.smoke.test.js

@@ -0,0 +1,17 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createClient } from "../src/index";
+describe("browser runtime smoke", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("executes basic request flow in browser-like environment", async () => {
+        vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response(JSON.stringify({ ok: true }), {
+            status: 200,
+            headers: { "content-type": "application/json" },
+        }));
+        const client = createClient();
+        const data = await client.getJson("https://example.com/health");
+        expect(data.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=browser-runtime.smoke.test.js.map

package/dist/tests/browser-runtime.smoke.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-runtime.smoke.test.js","sourceRoot":"","sources":["../../tests/browser-runtime.smoke.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,iBAAiB,CAC7C,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;YACzC,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAkB,4BAA4B,CAAC,CAAC;QAEjF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/circuit-breaker.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=circuit-breaker.test.d.ts.map

package/dist/tests/circuit-breaker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.test.d.ts","sourceRoot":"","sources":["../../tests/circuit-breaker.test.ts"],"names":[],"mappings":""}

package/dist/tests/circuit-breaker.test.js

@@ -0,0 +1,184 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { circuitBreaker, createCircuitBreaker } from "../src/middleware/circuitBreaker";
+import { createClient } from "../src/client/createClient";
+import { keyByHost, keyByMethodAndPath } from "../src/middleware/circuitBreakerKeys";
+describe("circuit breaker middleware", () => {
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it("opens after threshold failures and short-circuits subsequent requests", async () => {
+        vi.spyOn(globalThis, "fetch").mockRejectedValue(new TypeError("downstream error"));
+        const client = createClient().use(circuitBreaker({
+            failureThreshold: 2,
+            cooldownMs: 1000,
+        }));
+        const first = await client.getResult("https://api.example.com/health");
+        const second = await client.getResult("https://api.example.com/health");
+        const third = await client.getResult("https://api.example.com/health");
+        expect(first.ok).toBe(false);
+        expect(second.ok).toBe(false);
+        expect(third.ok).toBe(false);
+        if (!third.ok) {
+            expect(third.error.kind).toBe("circuit-open");
+        }
+        expect(globalThis.fetch).toHaveBeenCalledTimes(2);
+    });
+    it("transitions to half-open after cooldown and closes on successful probe", async () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date("2026-01-01T00:00:00.000Z"));
+        const fetchMock = vi
+            .spyOn(globalThis, "fetch")
+            .mockRejectedValueOnce(new TypeError("temporary outage"))
+            .mockResolvedValueOnce(new Response("ok", { status: 200 }))
+            .mockResolvedValueOnce(new Response("ok", { status: 200 }));
+        const client = createClient().use(circuitBreaker({
+            failureThreshold: 1,
+            successThreshold: 1,
+            cooldownMs: 5000,
+        }));
+        const first = await client.getResult("https://api.example.com/health");
+        expect(first.ok).toBe(false);
+        const second = await client.getResult("https://api.example.com/health");
+        expect(second.ok).toBe(false);
+        if (!second.ok) {
+            expect(second.error.kind).toBe("circuit-open");
+        }
+        vi.setSystemTime(new Date("2026-01-01T00:00:05.000Z"));
+        const third = await client.getResult("https://api.example.com/health");
+        expect(third.ok).toBe(true);
+        const fourth = await client.getResult("https://api.example.com/health");
+        expect(fourth.ok).toBe(true);
+        expect(fetchMock).toHaveBeenCalledTimes(3);
+    });
+    it("can trip on HTTP status without thrown error", async () => {
+        const fetchMock = vi
+            .spyOn(globalThis, "fetch")
+            .mockResolvedValueOnce(new Response("bad", { status: 503 }))
+            .mockResolvedValueOnce(new Response("ok", { status: 200 }));
+        const client = createClient().use(circuitBreaker({
+            failureThreshold: 1,
+        }));
+        const first = await client.get("https://api.example.com/health");
+        expect(first.status).toBe(503);
+        const second = await client.getResult("https://api.example.com/health");
+        expect(second.ok).toBe(false);
+        if (!second.ok) {
+            expect(second.error.kind).toBe("circuit-open");
+        }
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+    });
+    it("isolates circuit state per dependency key", async () => {
+        const fetchMock = vi
+            .spyOn(globalThis, "fetch")
+            .mockImplementation(async (url) => {
+            if (String(url).includes("service-a")) {
+                throw new TypeError("service-a down");
+            }
+            return new Response("ok", { status: 200 });
+        });
+        const breaker = createCircuitBreaker({
+            failureThreshold: 1,
+            keyBuilder: (req) => {
+                if (req.url.includes("service-a")) {
+                    return "service-a";
+                }
+                return "service-b";
+            },
+        });
+        const client = createClient().use(breaker.middleware);
+        const a1 = await client.getResult("https://service-a/api/health");
+        const a2 = await client.getResult("https://service-a/api/health");
+        const b1 = await client.getResult("https://service-b/api/health");
+        expect(a1.ok).toBe(false);
+        expect(a2.ok).toBe(false);
+        if (!a2.ok) {
+            expect(a2.error.kind).toBe("circuit-open");
+        }
+        expect(b1.ok).toBe(true);
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+    });
+    it("exposes snapshot and reset controls", async () => {
+        vi.spyOn(globalThis, "fetch").mockRejectedValue(new TypeError("downstream error"));
+        const breaker = createCircuitBreaker({
+            failureThreshold: 1,
+            keyBuilder: () => "dep-a",
+        });
+        const client = createClient().use(breaker.middleware);
+        await client.getResult("https://service-a/api/health");
+        const snapshot = breaker.snapshot();
+        expect(snapshot.size).toBe(1);
+        expect(snapshot.summary.open).toBe(1);
+        expect(snapshot.summary.closed).toBe(0);
+        expect(snapshot.summary.halfOpen).toBe(0);
+        expect(snapshot.entries[0]?.key).toBe("dep-a");
+        expect(snapshot.entries[0]?.state).toBe("open");
+        breaker.reset("dep-a");
+        expect(breaker.snapshot().size).toBe(0);
+    });
+    it("evicts oldest circuits when maxEntries is reached", async () => {
+        vi.spyOn(globalThis, "fetch").mockRejectedValue(new TypeError("downstream error"));
+        const breaker = createCircuitBreaker({
+            failureThreshold: 1,
+            maxEntries: 2,
+            keyBuilder: (req) => req.url,
+        });
+        const client = createClient().use(breaker.middleware);
+        await client.getResult("https://svc-a.local/health");
+        await client.getResult("https://svc-b.local/health");
+        await client.getResult("https://svc-c.local/health");
+        const snapshot = breaker.snapshot();
+        expect(snapshot.size).toBe(2);
+        const keys = snapshot.entries.map((item) => item.key);
+        expect(keys).toEqual(["https://svc-b.local/health", "https://svc-c.local/health"]);
+    });
+    it("prunes stale circuits by TTL", async () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date("2026-01-01T00:00:00.000Z"));
+        vi.spyOn(globalThis, "fetch").mockRejectedValue(new TypeError("downstream error"));
+        const breaker = createCircuitBreaker({
+            failureThreshold: 1,
+            entryTtlMs: 1000,
+            keyBuilder: () => "dep-a",
+        });
+        const client = createClient().use(breaker.middleware);
+        await client.getResult("https://svc-a.local/health");
+        expect(breaker.snapshot().size).toBe(1);
+        vi.setSystemTime(new Date("2026-01-01T00:00:02.000Z"));
+        expect(breaker.snapshot().size).toBe(0);
+    });
+    it("provides key preset helpers", () => {
+        const req = {
+            method: "GET",
+            url: "https://api.example.com/v1/users?cursor=1",
+        };
+        expect(keyByHost(req)).toBe("host:api.example.com");
+        expect(keyByMethodAndPath(req)).toBe("path:GET:/v1/users");
+    });
+    it("emits onStateChange events", async () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date("2026-01-01T00:00:00.000Z"));
+        const transitions = [];
+        vi.spyOn(globalThis, "fetch")
+            .mockRejectedValueOnce(new TypeError("temporary outage"))
+            .mockResolvedValueOnce(new Response("ok", { status: 200 }));
+        const breaker = createCircuitBreaker({
+            failureThreshold: 1,
+            successThreshold: 1,
+            cooldownMs: 1000,
+            keyBuilder: () => "dep-a",
+            hooks: {
+                onStateChange: (event) => {
+                    transitions.push(`${event.from}->${event.to}`);
+                },
+            },
+        });
+        const client = createClient().use(breaker.middleware);
+        await client.getResult("https://svc-a.local/health");
+        await client.getResult("https://svc-a.local/health");
+        vi.setSystemTime(new Date("2026-01-01T00:00:01.000Z"));
+        await client.getResult("https://svc-a.local/health");
+        expect(transitions).toEqual(["closed->open", "open->half-open", "half-open->closed"]);
+    });
+});
+//# sourceMappingURL=circuit-breaker.test.js.map

package/dist/tests/circuit-breaker.test.js.map

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

package/dist/tests/client.integration.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.integration.d.ts.map

package/dist/tests/client.integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.integration.d.ts","sourceRoot":"","sources":["../../tests/client.integration.ts"],"names":[],"mappings":""}

package/dist/tests/client.integration.js

@@ -0,0 +1,44 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createClient, retry } from "../src/index";
+describe("integration: client flow", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("composes retry + hooks + json helper in a single request flow", async () => {
+        let calls = 0;
+        const retryEvents = [];
+        const successRetryCounts = [];
+        vi.spyOn(globalThis, "fetch").mockImplementation(async () => {
+            calls += 1;
+            if (calls === 1) {
+                return new Response("temporary", { status: 500 });
+            }
+            return new Response(JSON.stringify({ id: "u1", name: "Alice" }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        });
+        const client = createClient({
+            hooks: {
+                onRequestSuccess: (event) => {
+                    successRetryCounts.push(event.retryCount);
+                },
+            },
+        }).use(retry({
+            maxRetries: 2,
+            delay: 1,
+            backoff: false,
+            onRetry: (event) => {
+                retryEvents.push(event.attempt);
+            },
+        }));
+        const user = await client.getJson("https://example.com/users/:id", {
+            params: { id: "u1" },
+        });
+        expect(user).toEqual({ id: "u1", name: "Alice" });
+        expect(calls).toBe(2);
+        expect(retryEvents).toEqual([1]);
+        expect(successRetryCounts).toEqual([1]);
+    });
+});
+//# sourceMappingURL=client.integration.js.map

package/dist/tests/client.integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.integration.js","sourceRoot":"","sources":["../../tests/client.integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAEnD,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,MAAM,kBAAkB,GAAa,EAAE,CAAC;QAExC,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE;YAC1D,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE;gBAC/D,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;aAChD,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,KAAK,EAAE;gBACL,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;oBAC1B,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC5C,CAAC;aACF;SACF,CAAC,CAAC,GAAG,CACJ,KAAK,CAAC;YACJ,UAAU,EAAE,CAAC;YACb,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjB,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClC,CAAC;SACF,CAAC,CACH,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAA+B,+BAA+B,EAAE;YAC/F,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;SACrB,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/client.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.integration.test.d.ts.map

package/dist/tests/client.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.integration.test.d.ts","sourceRoot":"","sources":["../../tests/client.integration.test.ts"],"names":[],"mappings":""}

package/dist/tests/client.integration.test.js

@@ -0,0 +1,63 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createClient, retry } from "../src/index";
+describe("integration: client flow", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("composes retry + hooks + json helper in a single request flow", async () => {
+        let calls = 0;
+        const retryEvents = [];
+        const successRetryCounts = [];
+        vi.spyOn(globalThis, "fetch").mockImplementation(async () => {
+            calls += 1;
+            if (calls === 1) {
+                return new Response("temporary", { status: 500 });
+            }
+            return new Response(JSON.stringify({ id: "u1", name: "Alice" }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        });
+        const client = createClient({
+            hooks: {
+                onRequestSuccess: (event) => {
+                    successRetryCounts.push(event.retryCount);
+                },
+            },
+        }).use(retry({
+            maxRetries: 2,
+            delay: 1,
+            backoff: false,
+            onRetry: (event) => {
+                retryEvents.push(event.attempt);
+            },
+        }));
+        const user = await client.getJson("https://example.com/users/:id", {
+            params: { id: "u1" },
+        });
+        expect(user).toEqual({ id: "u1", name: "Alice" });
+        expect(calls).toBe(2);
+        expect(retryEvents).toEqual([1]);
+        expect(successRetryCounts).toEqual([1]);
+    });
+    it("supports fetch-like usage for beginners", async () => {
+        const fetchMock = vi.spyOn(globalThis, "fetch").mockImplementation(async () => {
+            return new Response(JSON.stringify({ id: "u1" }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        });
+        const client = createClient();
+        const response = await client.fetch("https://example.com/users/:id", {
+            params: { id: "u1" },
+        });
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        expect(response.status).toBe(200);
+        expect(await response.json()).toEqual({ id: "u1" });
+        const result = await client.fetchJson("https://example.com/users/:id", {
+            params: { id: "u1" },
+        });
+        expect(result).toEqual({ id: "u1" });
+    });
+});
+//# sourceMappingURL=client.integration.test.js.map

package/dist/tests/client.integration.test.js.map

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

package/dist/tests/compose.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compose.test.d.ts.map

package/dist/tests/compose.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.test.d.ts","sourceRoot":"","sources":["../../tests/compose.test.ts"],"names":[],"mappings":""}

package/dist/tests/compose.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+import { compose } from "../src/middleware/compose";
+import { HttpResponse } from "../src/response/response";
+describe("compose", () => {
+    it("throws when next() is called multiple times", async () => {
+        const fn = compose([
+            async (req, next) => {
+                const first = next(req);
+                const second = next(req);
+                await first;
+                return second;
+            },
+            async () => {
+                return Promise.resolve(new HttpResponse(new Response("{}", { status: 200 })));
+            },
+        ]);
+        await expect(fn({
+            method: "GET",
+            url: "https://example.com/health",
+            _middlewares: [],
+        })).rejects.toThrow("next() was called multiple times");
+    });
+});
+//# sourceMappingURL=compose.test.js.map