@pureq/pureq 1.0.0

package/dist/src/response/response.d.ts

@@ -0,0 +1,58 @@
+/**
+ * A wrapper class for the standard Fetch `Response` object.
+ * Provides a clean interface for accessing body and metadata.
+ */
+export declare class HttpResponse {
+    private readonly response;
+    constructor(res: Response);
+    /**
+     * Returns true if status code is 200-299
+     */
+    get ok(): boolean;
+    /**
+     * HTTP status code
+     */
+    get status(): number;
+    /**
+     * Status description text
+     */
+    get statusText(): string;
+    /**
+     * Response headers object
+     */
+    get headers(): Headers;
+    /**
+     * Parse the response body as JSON.
+     * Developers are expected to verify .ok before calling this.
+     */
+    json<T = unknown>(): Promise<T>;
+    /**
+     * Parse the response body as plain text
+     */
+    text(): Promise<string>;
+    /**
+     * Parse the response body as a Blob
+     */
+    blob(): Promise<Blob>;
+    /**
+     * Parse the response body as ArrayBuffer
+     */
+    arrayBuffer(): Promise<ArrayBuffer>;
+    /**
+     * Parse the response body as FormData
+     */
+    formData(): Promise<FormData>;
+    /**
+     * Returns the underlying readable stream when available
+     */
+    stream(): ReadableStream<Uint8Array> | null;
+    /**
+     * Get the underlying Fetch API Response object
+     */
+    get native(): Response;
+    /**
+     * Clone the response to allow re-reading the body
+     */
+    clone(): HttpResponse;
+}
+//# sourceMappingURL=response.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../src/response/response.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAExB,GAAG,EAAE,QAAQ;IAIzB;;OAEG;IACH,IAAI,EAAE,IAAI,OAAO,CAEhB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;IAWrC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAIzC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IAInC;;OAEG;IACH,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI;IAI3C;;OAEG;IACH,IAAI,MAAM,IAAI,QAAQ,CAErB;IAED;;OAEG;IACH,KAAK,IAAI,YAAY;CAGtB"}

package/dist/src/response/response.js

@@ -0,0 +1,91 @@
+/**
+ * A wrapper class for the standard Fetch `Response` object.
+ * Provides a clean interface for accessing body and metadata.
+ */
+export class HttpResponse {
+    constructor(res) {
+        this.response = res;
+    }
+    /**
+     * Returns true if status code is 200-299
+     */
+    get ok() {
+        return this.response.ok;
+    }
+    /**
+     * HTTP status code
+     */
+    get status() {
+        return this.response.status;
+    }
+    /**
+     * Status description text
+     */
+    get statusText() {
+        return this.response.statusText;
+    }
+    /**
+     * Response headers object
+     */
+    get headers() {
+        return this.response.headers;
+    }
+    /**
+     * Parse the response body as JSON.
+     * Developers are expected to verify .ok before calling this.
+     */
+    async json() {
+        try {
+            return (await this.response.json());
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                throw new Error(`Failed to parse response as JSON: ${err.message}`);
+            }
+            throw err;
+        }
+    }
+    /**
+     * Parse the response body as plain text
+     */
+    async text() {
+        return this.response.text();
+    }
+    /**
+     * Parse the response body as a Blob
+     */
+    async blob() {
+        return this.response.blob();
+    }
+    /**
+     * Parse the response body as ArrayBuffer
+     */
+    async arrayBuffer() {
+        return this.response.arrayBuffer();
+    }
+    /**
+     * Parse the response body as FormData
+     */
+    async formData() {
+        return this.response.formData();
+    }
+    /**
+     * Returns the underlying readable stream when available
+     */
+    stream() {
+        return this.response.body;
+    }
+    /**
+     * Get the underlying Fetch API Response object
+     */
+    get native() {
+        return this.response;
+    }
+    /**
+     * Clone the response to allow re-reading the body
+     */
+    clone() {
+        return new HttpResponse(this.response.clone());
+    }
+}
+//# sourceMappingURL=response.js.map

package/dist/src/response/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../src/response/response.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,YAAY;IAGvB,YAAY,GAAa;QACvB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/src/serializers/formUrlEncodedSerializer.d.ts

@@ -0,0 +1,6 @@
+import type { BodySerializer } from "../types/http";
+export interface FormUrlEncodedSerializerOptions {
+    readonly arrayMode?: "repeat" | "comma";
+}
+export declare function createFormUrlEncodedSerializer(options?: FormUrlEncodedSerializerOptions): BodySerializer;
+//# sourceMappingURL=formUrlEncodedSerializer.d.ts.map

package/dist/src/serializers/formUrlEncodedSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formUrlEncodedSerializer.d.ts","sourceRoot":"","sources":["../../../src/serializers/formUrlEncodedSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACzC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,cAAc,CA4ChB"}

package/dist/src/serializers/formUrlEncodedSerializer.js

@@ -0,0 +1,38 @@
+export function createFormUrlEncodedSerializer(options = {}) {
+    const arrayMode = options.arrayMode ?? "repeat";
+    return {
+        serialize(body) {
+            if (body === undefined || body === null) {
+                return { payload: null };
+            }
+            if (typeof body !== "object") {
+                return {
+                    payload: String(body),
+                    contentType: "application/x-www-form-urlencoded",
+                };
+            }
+            const params = new URLSearchParams();
+            for (const [key, value] of Object.entries(body)) {
+                if (value === undefined || value === null) {
+                    continue;
+                }
+                if (Array.isArray(value)) {
+                    if (arrayMode === "comma") {
+                        params.set(key, value.map((item) => String(item)).join(","));
+                        continue;
+                    }
+                    for (const item of value) {
+                        params.append(key, String(item));
+                    }
+                    continue;
+                }
+                params.set(key, String(value));
+            }
+            return {
+                payload: params.toString(),
+                contentType: "application/x-www-form-urlencoded",
+            };
+        },
+    };
+}
+//# sourceMappingURL=formUrlEncodedSerializer.js.map

package/dist/src/serializers/formUrlEncodedSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formUrlEncodedSerializer.js","sourceRoot":"","sources":["../../../src/serializers/formUrlEncodedSerializer.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,8BAA8B,CAC5C,UAA2C,EAAE;IAE7C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC;IAEhD,OAAO;QACL,SAAS,CAAC,IAAI;YACZ,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC3B,CAAC;YAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC;oBACrB,WAAW,EAAE,mCAAmC;iBACjD,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAErC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;gBAC3E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,SAAS;gBACX,CAAC;gBAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;wBAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;wBAC7D,SAAS;oBACX,CAAC;oBAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;oBACnC,CAAC;oBACD,SAAS;gBACX,CAAC;gBAED,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACjC,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE;gBAC1B,WAAW,EAAE,mCAAmC;aACjD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/serializers/jsonBodySerializer.d.ts

@@ -0,0 +1,3 @@
+import type { BodySerializer } from "../types/http";
+export declare const jsonBodySerializer: BodySerializer;
+//# sourceMappingURL=jsonBodySerializer.d.ts.map

package/dist/src/serializers/jsonBodySerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonBodySerializer.d.ts","sourceRoot":"","sources":["../../../src/serializers/jsonBodySerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAcpD,eAAO,MAAM,kBAAkB,EAAE,cAehC,CAAC"}

package/dist/src/serializers/jsonBodySerializer.js

@@ -0,0 +1,24 @@
+function isBodyInitLike(value) {
+    return (typeof value === "string" ||
+        value instanceof Blob ||
+        value instanceof FormData ||
+        value instanceof URLSearchParams ||
+        value instanceof ArrayBuffer ||
+        ArrayBuffer.isView(value) ||
+        value instanceof ReadableStream);
+}
+export const jsonBodySerializer = {
+    serialize(body) {
+        if (body === undefined || body === null) {
+            return { payload: null };
+        }
+        if (isBodyInitLike(body)) {
+            return { payload: body };
+        }
+        return {
+            payload: JSON.stringify(body),
+            contentType: "application/json",
+        };
+    },
+};
+//# sourceMappingURL=jsonBodySerializer.js.map

package/dist/src/serializers/jsonBodySerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonBodySerializer.js","sourceRoot":"","sources":["../../../src/serializers/jsonBodySerializer.ts"],"names":[],"mappings":"AAEA,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,YAAY,IAAI;QACrB,KAAK,YAAY,QAAQ;QACzB,KAAK,YAAY,eAAe;QAChC,KAAK,YAAY,WAAW;QAC5B,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QACzB,KAAK,YAAY,cAAc,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,SAAS,CAAC,IAAI;QACZ,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC7B,WAAW,EAAE,kBAAkB;SAChC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/types/events.d.ts

@@ -0,0 +1,49 @@
+import type { RequestConfig } from "./http";
+import type { PureqErrorKind } from "./result";
+export type TransportEventPhase = "start" | "success" | "error";
+export interface PolicyTraceEntry {
+    readonly policy: string;
+    readonly decision: string;
+    readonly at: number;
+    readonly reason: string;
+    readonly attempt?: number;
+    readonly waitTimeMs?: number;
+    readonly status?: number;
+    readonly source?: string;
+    readonly retryAfterMs?: number;
+    readonly budgetRemainingMs?: number;
+    readonly key?: string;
+    readonly ageMs?: number;
+    readonly ttlMs?: number;
+}
+export interface TransportEvent {
+    readonly phase: TransportEventPhase;
+    readonly at: number;
+    readonly requestId?: string;
+    readonly method: RequestConfig["method"];
+    readonly url: string;
+    readonly startedAt?: number;
+    readonly durationMs?: number;
+    readonly status?: number;
+    readonly retryCount?: number;
+    readonly errorKind?: PureqErrorKind;
+    readonly policyTrace?: readonly PolicyTraceEntry[];
+}
+export type TransportStartEvent = TransportEvent & {
+    readonly phase: "start";
+    readonly startedAt: number;
+};
+export type TransportSuccessEvent = TransportEvent & {
+    readonly phase: "success";
+    readonly startedAt: number;
+    readonly durationMs: number;
+    readonly status: number;
+    readonly retryCount: number;
+};
+export type TransportErrorEvent = TransportEvent & {
+    readonly phase: "error";
+    readonly startedAt: number;
+    readonly durationMs: number;
+    readonly errorKind: PureqErrorKind;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/src/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpD;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG;IACjD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG;IACjD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;CACpC,CAAC"}

package/dist/src/types/events.js

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

package/dist/src/types/events.js.map

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

package/dist/src/types/http.d.ts

@@ -0,0 +1,78 @@
+import type { HttpResponse } from "../response/response";
+/**
+ * Standard HTTP methods supported by the library
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+/**
+ * Allowed query value primitives
+ */
+export type QueryValue = string | number | boolean;
+/**
+ * Allowed query map
+ */
+export type QueryParams = Readonly<Record<string, QueryValue | readonly QueryValue[]>>;
+export type HttpAdapter = (url: string, init: RequestInit) => Promise<Response>;
+export interface BodySerializer {
+    readonly serialize: (body: unknown) => {
+        readonly payload: BodyInit | null;
+        readonly contentType?: string;
+    };
+}
+/**
+ * Core Request configuration object
+ */
+export interface RequestConfig {
+    /**
+     * HTTP Method
+     */
+    readonly method: HttpMethod;
+    /**
+     * Request URL
+     */
+    readonly url: string;
+    /**
+     * Key-value map of path parameters (e.g., :userId)
+     */
+    readonly params?: Readonly<Record<string, string>>;
+    /**
+     * Query parameters to append to the URL
+     */
+    readonly query?: QueryParams;
+    /**
+     * Request body (typically object or string)
+     */
+    readonly body?: unknown;
+    /**
+     * Request headers
+     */
+    readonly headers?: Readonly<Record<string, string>>;
+    /**
+     * Abort signal to cancel the request
+     */
+    readonly signal?: AbortSignal;
+    /**
+     * Timeout in milliseconds
+     */
+    readonly timeout?: number;
+}
+/**
+ * Middleware function following the "Onion Model" pattern
+ */
+export type Middleware = (req: RequestConfig, next: (req: RequestConfig) => Promise<HttpResponse>) => Promise<HttpResponse>;
+/**
+ * Request interceptor
+ */
+export type RequestInterceptor = (req: Readonly<RequestConfig>) => RequestConfig | Promise<RequestConfig>;
+/**
+ * Response interceptor
+ */
+export type ResponseInterceptor = (res: HttpResponse, req: Readonly<RequestConfig>) => HttpResponse | Promise<HttpResponse>;
+/**
+ * Prioritized interceptor registration
+ */
+export interface InterceptorEntry<T> {
+    readonly handler: T;
+    readonly priority?: number;
+    readonly name?: string;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/src/types/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/types/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAAC,CAAC,CAAC;AAEvF,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEhF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;QACrC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;QAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,KAChD,OAAO,CAAC,YAAY,CAAC,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,KACzB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,KACzB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/src/types/http.js

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

package/dist/src/types/http.js.map

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

package/dist/src/types/internal.d.ts

@@ -0,0 +1,20 @@
+import type { RequestConfig, Middleware } from "./http";
+import type { HttpResponse } from "../response/response";
+/**
+ * Internal request state with middleware queue
+ */
+export interface InternalRequestConfig extends RequestConfig {
+    /**
+     * Middleware chain local to this specific request
+     */
+    readonly _middlewares: readonly Middleware[];
+    /**
+     * Optional metadata container for internal instrumentation.
+     */
+    readonly _meta?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Type of a middleware executor after composition
+ */
+export type ComposedMiddleware = (req: InternalRequestConfig) => Promise<HttpResponse>;
+//# sourceMappingURL=internal.d.ts.map

package/dist/src/types/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../src/types/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC"}

package/dist/src/types/internal.js

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

package/dist/src/types/internal.js.map

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

package/dist/src/types/result.d.ts

@@ -0,0 +1,32 @@
+import type { HttpResponse } from "../response/response";
+export type Ok<T> = {
+    readonly ok: true;
+    readonly data: T;
+};
+export type Err<E> = {
+    readonly ok: false;
+    readonly error: E;
+};
+export type Result<T, E> = Ok<T> | Err<E>;
+export type PureqErrorKind = "network" | "timeout" | "aborted" | "http" | "circuit-open" | "unknown";
+export interface PureqErrorMetadata {
+    readonly requestId?: string;
+    readonly method?: string;
+    readonly url?: string;
+    readonly retryCount?: number;
+    readonly rootCause?: string;
+}
+export interface PureqError {
+    readonly kind: PureqErrorKind;
+    readonly message: string;
+    readonly cause: unknown;
+    readonly status?: number;
+    readonly statusText?: string;
+    readonly metadata?: PureqErrorMetadata;
+}
+export type HttpResult = Result<HttpResponse, PureqError>;
+export declare function ok<T>(data: T): Ok<T>;
+export declare function err<E>(error: E): Err<E>;
+export declare function toPureqError(cause: unknown, metadata?: PureqErrorMetadata): PureqError;
+export declare function httpErrorFromResponse(response: HttpResponse, metadata?: PureqErrorMetadata): PureqError;
+//# sourceMappingURL=result.d.ts.map

package/dist/src/types/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/types/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,MAAM,EAAE,CAAC,CAAC,IAAI;IAClB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI;IACnB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAE1C,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;AAErG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;AAE1D,wBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAEpC;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAEvC;AAkBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,kBAAuB,GAAG,UAAU,CA4C1F;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,GAAE,kBAAuB,GAAG,UAAU,CAY3G"}

package/dist/src/types/result.js

@@ -0,0 +1,66 @@
+export function ok(data) {
+    return { ok: true, data };
+}
+export function err(error) {
+    return { ok: false, error };
+}
+function extractRetryCount(cause) {
+    if (typeof cause === "object" && cause !== null && "__pureqRetryCount" in cause) {
+        const value = cause.__pureqRetryCount;
+        return typeof value === "number" ? value : undefined;
+    }
+    return undefined;
+}
+function inferRootCause(cause) {
+    // DOMException extends Error, so a single instanceof Error check covers both.
+    if (cause instanceof Error) {
+        return cause.name;
+    }
+    return typeof cause;
+}
+export function toPureqError(cause, metadata = {}) {
+    const message = cause instanceof Error ? cause.message : String(cause);
+    const isTypeErrorLike = cause instanceof TypeError ||
+        (typeof cause === "object" &&
+            cause !== null &&
+            "name" in cause &&
+            cause.name === "TypeError");
+    const looksLikeNetworkMessage = /network|fetch|socket|econn|enotfound|timed out/i.test(message);
+    const retryCount = metadata.retryCount !== undefined ? metadata.retryCount : extractRetryCount(cause);
+    const rootCause = metadata.rootCause !== undefined ? metadata.rootCause : inferRootCause(cause);
+    const normalizedMetadata = {
+        ...metadata,
+        ...(retryCount !== undefined ? { retryCount } : {}),
+        ...(rootCause !== undefined ? { rootCause } : {}),
+    };
+    if (cause instanceof Error && cause.message.includes("request timeout")) {
+        return { kind: "timeout", message, cause, metadata: normalizedMetadata };
+    }
+    if (cause instanceof DOMException &&
+        cause.name === "AbortError") {
+        return { kind: "aborted", message, cause, metadata: normalizedMetadata };
+    }
+    if (isTypeErrorLike || looksLikeNetworkMessage) {
+        return { kind: "network", message, cause, metadata: normalizedMetadata };
+    }
+    if (cause instanceof Error &&
+        (cause.name === "PureqCircuitOpenError" ||
+            message.includes("circuit breaker is open") ||
+            message.includes("half-open probe in flight"))) {
+        return { kind: "circuit-open", message, cause, metadata: normalizedMetadata };
+    }
+    return { kind: "unknown", message, cause, metadata: normalizedMetadata };
+}
+export function httpErrorFromResponse(response, metadata = {}) {
+    const base = `HTTP ${response.status}`;
+    const detail = response.statusText ? ` ${response.statusText}` : "";
+    return {
+        kind: "http",
+        message: `${base}${detail}`,
+        cause: response,
+        status: response.status,
+        statusText: response.statusText,
+        metadata,
+    };
+}
+//# sourceMappingURL=result.js.map

package/dist/src/types/result.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Generates a cryptographically strong random ID.
+ * Prefers crypto.randomUUID, falls back to crypto.getRandomValues,
+ * and only uses Math.random as a last resort for environments
+ * without any Web Crypto API support.
+ */
+export declare function generateSecureId(prefix?: string): string;
+//# sourceMappingURL=crypto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../../src/utils/crypto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAexD"}

package/dist/src/utils/crypto.js

@@ -0,0 +1,21 @@
+/**
+ * Generates a cryptographically strong random ID.
+ * Prefers crypto.randomUUID, falls back to crypto.getRandomValues,
+ * and only uses Math.random as a last resort for environments
+ * without any Web Crypto API support.
+ */
+export function generateSecureId(prefix) {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+        return crypto.randomUUID();
+    }
+    if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
+        const bytes = new Uint8Array(16);
+        crypto.getRandomValues(bytes);
+        const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+        return prefix ? `${prefix}-${hex}` : hex;
+    }
+    // Last resort fallback for legacy environments without Web Crypto API.
+    // This is NOT cryptographically secure.
+    return `${prefix ?? "id"}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+}
+//# sourceMappingURL=crypto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../../src/utils/crypto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7E,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAClF,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/E,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3C,CAAC;IAED,uEAAuE;IACvE,wCAAwC;IACxC,OAAO,GAAG,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAClF,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * 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.
+ */
+import type { RequestConfig } from "../types/http";
+import type { PolicyTraceEntry } from "../types/events";
+export declare function appendPolicyTrace(req: RequestConfig, entry: PolicyTraceEntry): void;
+/**
+ * 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 declare function deepCopyMeta(req: RequestConfig): Record<string, unknown>;
+//# sourceMappingURL=policyTrace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policyTrace.d.ts","sourceRoot":"","sources":["../../../src/utils/policyTrace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAUnF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,aAAa,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}