@noresponse/node 1.0.1 → 2.0.1

package/dist/esm/lib/http.d.ts

@@ -0,0 +1,67 @@
+export type Fetcher = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export type Awaitable<T> = T | Promise<T>;
+export type RequestInput = {
+    /**
+     * The URL the request will use.
+     */
+    url: URL;
+    /**
+     * Options used to create a [`Request`](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request).
+     */
+    options?: RequestInit | undefined;
+};
+export interface HTTPClientOptions {
+    fetcher?: Fetcher;
+}
+export type BeforeRequestHook = (req: Request) => Awaitable<Request | void>;
+export type RequestErrorHook = (err: unknown, req: Request) => Awaitable<void>;
+export type ResponseHook = (res: Response, req: Request) => Awaitable<void>;
+export declare class HTTPClient {
+    private fetcher;
+    private requestHooks;
+    private requestErrorHooks;
+    private responseHooks;
+    private options;
+    constructor(options?: HTTPClientOptions);
+    request(request: Request): Promise<Response>;
+    /**
+     * Registers a hook that is called before a request is made. The hook function
+     * can mutate the request or return a new request. This may be useful to add
+     * additional information to request such as request IDs and tracing headers.
+     */
+    addHook(hook: "beforeRequest", fn: BeforeRequestHook): this;
+    /**
+     * Registers a hook that is called when a request cannot be made due to a
+     * network error.
+     */
+    addHook(hook: "requestError", fn: RequestErrorHook): this;
+    /**
+     * Registers a hook that is called when a response has been received from the
+     * server.
+     */
+    addHook(hook: "response", fn: ResponseHook): this;
+    /** Removes a hook that was previously registered with `addHook`. */
+    removeHook(hook: "beforeRequest", fn: BeforeRequestHook): this;
+    /** Removes a hook that was previously registered with `addHook`. */
+    removeHook(hook: "requestError", fn: RequestErrorHook): this;
+    /** Removes a hook that was previously registered with `addHook`. */
+    removeHook(hook: "response", fn: ResponseHook): this;
+    clone(): HTTPClient;
+}
+export type StatusCodePredicate = number | string | (number | string)[];
+export declare function matchContentType(response: Response, pattern: string): boolean;
+export declare function matchStatusCode(response: Response, codes: StatusCodePredicate): boolean;
+export declare function matchResponse(response: Response, code: StatusCodePredicate, contentTypePattern: string): boolean;
+/**
+ * Uses various heurisitics to determine if an error is a connection error.
+ */
+export declare function isConnectionError(err: unknown): boolean;
+/**
+ * Uses various heurisitics to determine if an error is a timeout error.
+ */
+export declare function isTimeoutError(err: unknown): boolean;
+/**
+ * Uses various heurisitics to determine if an error is a abort error.
+ */
+export declare function isAbortError(err: unknown): boolean;
+//# sourceMappingURL=http.d.ts.map

package/dist/esm/lib/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/lib/http.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,CACpB,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAc1C,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,GAAG,EAAE,GAAG,CAAC;IACT;;OAEG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC;AAC/E,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC;AAE5E,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,OAAO,CAAoB;IAEnC,YAAY,OAAO,GAAE,iBAAsB,EAG1C;IAEK,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwBjD;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5D;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1D;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,GAAG,IAAI,CAAC;IAmBlD,oEAAoE;IACpE,UAAU,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/D,oEAAoE;IACpE,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7D,oEAAoE;IACpE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,GAAG,IAAI,CAAC;IA0BrD,KAAK,IAAI,UAAU,CAOlB;CACF;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;AAMxE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CA8C7E;AAID,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CA8BT;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,mBAAmB,EACzB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAsBvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAgBpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAgBlD"}

package/dist/esm/lib/http.js

@@ -0,0 +1,206 @@
+const DEFAULT_FETCHER = (input, init) => {
+    // If input is a Request and init is undefined, Bun will discard the method,
+    // headers, body and other options that were set on the request object.
+    // Node.js and browers would ignore an undefined init value. This check is
+    // therefore needed for interop with Bun.
+    if (init == null) {
+        return fetch(input);
+    }
+    else {
+        return fetch(input, init);
+    }
+};
+export class HTTPClient {
+    fetcher;
+    requestHooks = [];
+    requestErrorHooks = [];
+    responseHooks = [];
+    options;
+    constructor(options = {}) {
+        this.options = options;
+        this.fetcher = options.fetcher || DEFAULT_FETCHER;
+    }
+    async request(request) {
+        let req = request;
+        for (const hook of this.requestHooks) {
+            const nextRequest = await hook(req);
+            if (nextRequest) {
+                req = nextRequest;
+            }
+        }
+        try {
+            const res = await this.fetcher(req);
+            for (const hook of this.responseHooks) {
+                await hook(res, req);
+            }
+            return res;
+        }
+        catch (err) {
+            for (const hook of this.requestErrorHooks) {
+                await hook(err, req);
+            }
+            throw err;
+        }
+    }
+    addHook(...args) {
+        if (args[0] === "beforeRequest") {
+            this.requestHooks.push(args[1]);
+        }
+        else if (args[0] === "requestError") {
+            this.requestErrorHooks.push(args[1]);
+        }
+        else if (args[0] === "response") {
+            this.responseHooks.push(args[1]);
+        }
+        else {
+            throw new Error(`Invalid hook type: ${args[0]}`);
+        }
+        return this;
+    }
+    removeHook(...args) {
+        let target;
+        if (args[0] === "beforeRequest") {
+            target = this.requestHooks;
+        }
+        else if (args[0] === "requestError") {
+            target = this.requestErrorHooks;
+        }
+        else if (args[0] === "response") {
+            target = this.responseHooks;
+        }
+        else {
+            throw new Error(`Invalid hook type: ${args[0]}`);
+        }
+        const index = target.findIndex((v) => v === args[1]);
+        if (index >= 0) {
+            target.splice(index, 1);
+        }
+        return this;
+    }
+    clone() {
+        const child = new HTTPClient(this.options);
+        child.requestHooks = this.requestHooks.slice();
+        child.requestErrorHooks = this.requestErrorHooks.slice();
+        child.responseHooks = this.responseHooks.slice();
+        return child;
+    }
+}
+// A semicolon surrounded by optional whitespace characters is used to separate
+// segments in a media type string.
+const mediaParamSeparator = /\s*;\s*/g;
+export function matchContentType(response, pattern) {
+    // `*` is a special case which means anything is acceptable.
+    if (pattern === "*") {
+        return true;
+    }
+    let contentType = response.headers.get("content-type")?.trim() || "application/octet-stream";
+    contentType = contentType.toLowerCase();
+    const wantParts = pattern.toLowerCase().trim().split(mediaParamSeparator);
+    const [wantType = "", ...wantParams] = wantParts;
+    if (wantType.split("/").length !== 2) {
+        return false;
+    }
+    const gotParts = contentType.split(mediaParamSeparator);
+    const [gotType = "", ...gotParams] = gotParts;
+    const [type = "", subtype = ""] = gotType.split("/");
+    if (!type || !subtype) {
+        return false;
+    }
+    if (wantType !== "*/*" &&
+        gotType !== wantType &&
+        `${type}/*` !== wantType &&
+        `*/${subtype}` !== wantType) {
+        return false;
+    }
+    if (gotParams.length < wantParams.length) {
+        return false;
+    }
+    const params = new Set(gotParams);
+    for (const wantParam of wantParams) {
+        if (!params.has(wantParam)) {
+            return false;
+        }
+    }
+    return true;
+}
+const codeRangeRE = new RegExp("^[0-9]xx$", "i");
+export function matchStatusCode(response, codes) {
+    const actual = `${response.status}`;
+    const expectedCodes = Array.isArray(codes) ? codes : [codes];
+    if (!expectedCodes.length) {
+        return false;
+    }
+    return expectedCodes.some((ec) => {
+        const code = `${ec}`;
+        if (code === "default") {
+            return true;
+        }
+        if (!codeRangeRE.test(`${code}`)) {
+            return code === actual;
+        }
+        const expectFamily = code.charAt(0);
+        if (!expectFamily) {
+            throw new Error("Invalid status code range");
+        }
+        const actualFamily = actual.charAt(0);
+        if (!actualFamily) {
+            throw new Error(`Invalid response status code: ${actual}`);
+        }
+        return actualFamily === expectFamily;
+    });
+}
+export function matchResponse(response, code, contentTypePattern) {
+    return (matchStatusCode(response, code) &&
+        matchContentType(response, contentTypePattern));
+}
+/**
+ * Uses various heurisitics to determine if an error is a connection error.
+ */
+export function isConnectionError(err) {
+    if (typeof err !== "object" || err == null) {
+        return false;
+    }
+    // Covers fetch in Deno as well
+    const isBrowserErr = err instanceof TypeError &&
+        err.message.toLowerCase().startsWith("failed to fetch");
+    const isNodeErr = err instanceof TypeError &&
+        err.message.toLowerCase().startsWith("fetch failed");
+    const isBunErr = "name" in err && err.name === "ConnectionError";
+    const isGenericErr = "code" in err &&
+        typeof err.code === "string" &&
+        err.code.toLowerCase() === "econnreset";
+    return isBrowserErr || isNodeErr || isGenericErr || isBunErr;
+}
+/**
+ * Uses various heurisitics to determine if an error is a timeout error.
+ */
+export function isTimeoutError(err) {
+    if (typeof err !== "object" || err == null) {
+        return false;
+    }
+    // Fetch in browser, Node.js, Bun, Deno
+    const isNative = "name" in err && err.name === "TimeoutError";
+    const isLegacyNative = "code" in err && err.code === 23;
+    // Node.js HTTP client and Axios
+    const isGenericErr = "code" in err &&
+        typeof err.code === "string" &&
+        err.code.toLowerCase() === "econnaborted";
+    return isNative || isLegacyNative || isGenericErr;
+}
+/**
+ * Uses various heurisitics to determine if an error is a abort error.
+ */
+export function isAbortError(err) {
+    if (typeof err !== "object" || err == null) {
+        return false;
+    }
+    // Fetch in browser, Node.js, Bun, Deno
+    const isNative = "name" in err && err.name === "AbortError";
+    const isLegacyNative = "code" in err && err.code === 20;
+    // Node.js HTTP client and Axios
+    const isGenericErr = "code" in err &&
+        typeof err.code === "string" &&
+        err.code.toLowerCase() === "econnaborted";
+    return isNative || isLegacyNative || isGenericErr;
+}
+//# sourceMappingURL=http.js.map

package/dist/esm/lib/http.js.map

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

package/dist/esm/lib/logger.d.ts

@@ -0,0 +1,6 @@
+export interface Logger {
+    group(label?: string): void;
+    groupEnd(): void;
+    log(message: any, ...args: any[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/esm/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/logger.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,IAAI,IAAI,CAAC;IACjB,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CACzC"}

package/dist/esm/lib/logger.js

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

package/dist/esm/lib/logger.js.map

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

package/dist/esm/lib/matchers.d.ts

@@ -0,0 +1,59 @@
+import { APIStatusError } from "../models/errors/api-status-error.js";
+import { ResponseValidationError } from "../models/errors/response-validation-error.js";
+import { Result } from "../types/fp.js";
+import { StatusCodePredicate } from "./http.js";
+export type Encoding = "jsonl" | "json" | "text" | "bytes" | "stream" | "sse" | "nil" | "fail";
+type Schema<T> = {
+    parse(raw: unknown): T;
+};
+type MatchOptions = {
+    ctype?: string;
+    hdrs?: boolean;
+    key?: string;
+    sseSentinel?: string;
+};
+export type ValueMatcher<V> = MatchOptions & {
+    enc: Encoding;
+    codes: StatusCodePredicate;
+    schema: Schema<V>;
+};
+export type ErrorMatcher<E> = MatchOptions & {
+    enc: Encoding;
+    codes: StatusCodePredicate;
+    schema: Schema<E>;
+    err: true;
+};
+export type FailMatcher = {
+    enc: "fail";
+    codes: StatusCodePredicate;
+};
+export type Matcher<T, E> = ValueMatcher<T> | ErrorMatcher<E> | FailMatcher;
+export declare function jsonErr<E>(codes: StatusCodePredicate, schema: Schema<E>, options?: MatchOptions): ErrorMatcher<E>;
+export declare function json<T>(codes: StatusCodePredicate, schema: Schema<T>, options?: MatchOptions): ValueMatcher<T>;
+export declare function jsonl<T>(codes: StatusCodePredicate, schema: Schema<T>, options?: MatchOptions): ValueMatcher<T>;
+export declare function jsonlErr<E>(codes: StatusCodePredicate, schema: Schema<E>, options?: MatchOptions): ErrorMatcher<E>;
+export declare function textErr<E>(codes: StatusCodePredicate, schema: Schema<E>, options?: MatchOptions): ErrorMatcher<E>;
+export declare function text<T>(codes: StatusCodePredicate, schema: Schema<T>, options?: MatchOptions): ValueMatcher<T>;
+export declare function bytesErr<E>(codes: StatusCodePredicate, schema: Schema<E>, options?: MatchOptions): ErrorMatcher<E>;
+export declare function bytes<T>(codes: StatusCodePredicate, schema: Schema<T>, options?: MatchOptions): ValueMatcher<T>;
+export declare function streamErr<E>(codes: StatusCodePredicate, schema: Schema<E>, options?: MatchOptions): ErrorMatcher<E>;
+export declare function stream<T>(codes: StatusCodePredicate, schema: Schema<T>, options?: MatchOptions): ValueMatcher<T>;
+export declare function sseErr<E>(codes: StatusCodePredicate, schema: Schema<E>, options?: MatchOptions): ErrorMatcher<E>;
+export declare function sse<T>(codes: StatusCodePredicate, schema: Schema<T>, options?: MatchOptions): ValueMatcher<T>;
+export declare function nilErr<E>(codes: StatusCodePredicate, schema: Schema<E>, options?: MatchOptions): ErrorMatcher<E>;
+export declare function nil<T>(codes: StatusCodePredicate, schema: Schema<T>, options?: MatchOptions): ValueMatcher<T>;
+export declare function fail(codes: StatusCodePredicate): FailMatcher;
+export type MatchedValue<Matchers> = Matchers extends Matcher<infer T, any>[] ? T : never;
+export type MatchedError<Matchers> = Matchers extends Matcher<any, infer E>[] ? E : never;
+export type MatchFunc<T, E> = (response: Response, request: Request, options?: {
+    resultKey?: string;
+    extraFields?: Record<string, unknown>;
+}) => Promise<[result: Result<T, E>, raw: unknown]>;
+export declare function match<T, E>(...matchers: Array<Matcher<T, E>>): MatchFunc<T, E | APIStatusError | ResponseValidationError>;
+/**
+ * Iterates over a Headers object and returns an object with all the header
+ * entries. Values are represented as an array to account for repeated headers.
+ */
+export declare function unpackHeaders(headers: Headers): Record<string, string[]>;
+export {};
+//# sourceMappingURL=matchers.d.ts.map

package/dist/esm/lib/matchers.d.ts.map

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

package/dist/esm/lib/matchers.js

@@ -0,0 +1,199 @@
+import { APIStatusError } from "../models/errors/api-status-error.js";
+import { ResponseValidationError } from "../models/errors/response-validation-error.js";
+import { ERR, OK } from "../types/fp.js";
+import { matchResponse, matchStatusCode } from "./http.js";
+import { isPlainObject } from "./primitives.js";
+const DEFAULT_CONTENT_TYPES = {
+    jsonl: "application/jsonl",
+    json: "application/json",
+    text: "text/plain",
+    bytes: "application/octet-stream",
+    stream: "application/octet-stream",
+    sse: "text/event-stream",
+    nil: "*",
+    fail: "*",
+};
+export function jsonErr(codes, schema, options) {
+    return { ...options, err: true, enc: "json", codes, schema };
+}
+export function json(codes, schema, options) {
+    return { ...options, enc: "json", codes, schema };
+}
+export function jsonl(codes, schema, options) {
+    return { ...options, enc: "jsonl", codes, schema };
+}
+export function jsonlErr(codes, schema, options) {
+    return { ...options, err: true, enc: "jsonl", codes, schema };
+}
+export function textErr(codes, schema, options) {
+    return { ...options, err: true, enc: "text", codes, schema };
+}
+export function text(codes, schema, options) {
+    return { ...options, enc: "text", codes, schema };
+}
+export function bytesErr(codes, schema, options) {
+    return { ...options, err: true, enc: "bytes", codes, schema };
+}
+export function bytes(codes, schema, options) {
+    return { ...options, enc: "bytes", codes, schema };
+}
+export function streamErr(codes, schema, options) {
+    return { ...options, err: true, enc: "stream", codes, schema };
+}
+export function stream(codes, schema, options) {
+    return { ...options, enc: "stream", codes, schema };
+}
+export function sseErr(codes, schema, options) {
+    return { ...options, err: true, enc: "sse", codes, schema };
+}
+export function sse(codes, schema, options) {
+    return { ...options, enc: "sse", codes, schema };
+}
+export function nilErr(codes, schema, options) {
+    return { ...options, err: true, enc: "nil", codes, schema };
+}
+export function nil(codes, schema, options) {
+    return { ...options, enc: "nil", codes, schema };
+}
+export function fail(codes) {
+    return { enc: "fail", codes };
+}
+export function match(...matchers) {
+    return async function matchFunc(response, request, options) {
+        let raw;
+        let matcher;
+        for (const match of matchers) {
+            const { codes } = match;
+            const ctpattern = "ctype" in match
+                ? match.ctype
+                : DEFAULT_CONTENT_TYPES[match.enc];
+            if (ctpattern && matchResponse(response, codes, ctpattern)) {
+                matcher = match;
+                break;
+            }
+            else if (!ctpattern && matchStatusCode(response, codes)) {
+                matcher = match;
+                break;
+            }
+        }
+        if (!matcher) {
+            return [{
+                    ok: false,
+                    error: new APIStatusError("Unexpected Status or Content-Type", {
+                        response,
+                        request,
+                        body: await response.text().catch(() => ""),
+                    }),
+                }, raw];
+        }
+        const encoding = matcher.enc;
+        let body = "";
+        switch (encoding) {
+            case "json":
+                body = await response.text();
+                raw = JSON.parse(body);
+                break;
+            case "jsonl":
+                raw = response.body;
+                break;
+            case "bytes":
+                raw = new Uint8Array(await response.arrayBuffer());
+                break;
+            case "stream":
+                raw = response.body;
+                break;
+            case "text":
+                body = await response.text();
+                raw = body;
+                break;
+            case "sse":
+                raw = response.body;
+                break;
+            case "nil":
+                body = await response.text();
+                raw = undefined;
+                break;
+            case "fail":
+                body = await response.text();
+                raw = body;
+                break;
+            default:
+                throw new Error(`Unsupported response type: ${encoding}`);
+        }
+        if (matcher.enc === "fail") {
+            return [{
+                    ok: false,
+                    error: new APIStatusError("API error occurred", {
+                        request,
+                        response,
+                        body,
+                    }),
+                }, raw];
+        }
+        const resultKey = matcher.key || options?.resultKey;
+        let data;
+        if ("err" in matcher) {
+            data = {
+                ...options?.extraFields,
+                ...(matcher.hdrs ? { Headers: unpackHeaders(response.headers) } : null),
+                ...(isPlainObject(raw) ? raw : null),
+                request$: request,
+                response$: response,
+                body$: body,
+            };
+        }
+        else if (resultKey) {
+            data = {
+                ...options?.extraFields,
+                ...(matcher.hdrs ? { Headers: unpackHeaders(response.headers) } : null),
+                [resultKey]: raw,
+            };
+        }
+        else if (matcher.hdrs) {
+            data = {
+                ...options?.extraFields,
+                ...(matcher.hdrs ? { Headers: unpackHeaders(response.headers) } : null),
+                ...(isPlainObject(raw) ? raw : null),
+            };
+        }
+        else {
+            data = raw;
+        }
+        if ("err" in matcher) {
+            const result = safeParseResponse(data, (v) => matcher.schema.parse(v), "Response validation failed", { request, response, body });
+            return [result.ok ? { ok: false, error: result.value } : result, raw];
+        }
+        else {
+            return [
+                safeParseResponse(data, (v) => matcher.schema.parse(v), "Response validation failed", { request, response, body }),
+                raw,
+            ];
+        }
+    };
+}
+const headerValRE = /, */;
+/**
+ * Iterates over a Headers object and returns an object with all the header
+ * entries. Values are represented as an array to account for repeated headers.
+ */
+export function unpackHeaders(headers) {
+    const out = {};
+    for (const [k, v] of headers.entries()) {
+        out[k] = v.split(headerValRE);
+    }
+    return out;
+}
+function safeParseResponse(rawValue, fn, errorMessage, httpMeta) {
+    try {
+        return OK(fn(rawValue));
+    }
+    catch (err) {
+        return ERR(new ResponseValidationError(errorMessage, {
+            cause: err,
+            rawValue,
+            rawMessage: errorMessage,
+            ...httpMeta,
+        }));
+    }
+}
+//# sourceMappingURL=matchers.js.map

package/dist/esm/lib/matchers.js.map

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

package/dist/esm/lib/primitives.d.ts

@@ -0,0 +1,27 @@
+export declare function invariant(condition: unknown, message: string): asserts condition;
+export type ExactPartial<T> = {
+    [P in keyof T]?: T[P] | undefined;
+};
+export type Remap<Inp, Mapping extends {
+    [k in keyof Inp]?: string | null;
+}> = {
+    [k in keyof Inp as Mapping[k] extends string ? Mapping[k] : Mapping[k] extends null ? never : k]: Inp[k];
+};
+/**
+ * Converts or omits an object's keys according to a mapping.
+ *
+ * @param inp An object whose keys will be remapped
+ * @param mappings A mapping of original keys to new keys. If a key is not present in the mapping, it will be left as is. If a key is mapped to `null`, it will be removed in the resulting object.
+ * @returns A new object with keys remapped or omitted according to the mappings
+ */
+export declare function remap<Inp extends Record<string, unknown>, const Mapping extends {
+    [k in keyof Inp]?: string | null;
+}>(inp: Inp, mappings: Mapping): Remap<Inp, Mapping>;
+export declare function combineSignals(...signals: Array<AbortSignal | null | undefined>): AbortSignal | null;
+export declare function abortSignalAny(signals: AbortSignal[]): AbortSignal;
+export declare function compactMap<T>(values: Record<string, T | undefined>): Record<string, T>;
+export declare function allRequired<V extends Record<string, unknown>>(v: V): {
+    [K in keyof V]: NonNullable<V[K]>;
+} | undefined;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/esm/lib/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/lib/primitives.ts"],"names":[],"mappings":"AAOA,wBAAgB,SAAS,CACvB,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAInB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;CAClC,CAAC;AAEF,MAAM,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;CAAE,IAAI;KAC5E,CAAC,IAAI,MAAM,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,GACxC,OAAO,CAAC,CAAC,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,GACvB,KAAK,GACL,CAAC,GAAsC,GAAG,CAAC,CAAC,CAAC;CAClD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,CAAC,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;CAAE,EAC1D,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAiBlD;AAED,wBAAgB,cAAc,CAC5B,GAAG,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,GAChD,WAAW,GAAG,IAAI,CAkBpB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,CAsClE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC,GACpC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAUnB;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,CAAC,EAAE,CAAC,GAEF;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,GACD,SAAS,CAMZ;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYlC"}