@ominity/api-typescript 0.0.1

package/dist/esm/lib/matchers.js

@@ -0,0 +1,200 @@
+import { OminityDefaultError } from "../models/errors/ominity-default-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 "./is-plain-object.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 OminityDefaultError("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:
+                encoding;
+                throw new Error(`Unsupported response type: ${encoding}`);
+        }
+        if (matcher.enc === "fail") {
+            return [{
+                    ok: false,
+                    error: new OminityDefaultError("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,26 @@
+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;
+//# 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":"AAQA,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"}

package/dist/esm/lib/primitives.js

@@ -0,0 +1,100 @@
+class InvariantError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvariantError";
+    }
+}
+export function invariant(condition, message) {
+    if (!condition) {
+        throw new InvariantError(message);
+    }
+}
+/**
+ * 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 function remap(inp, mappings) {
+    let out = {};
+    if (!Object.keys(mappings).length) {
+        out = inp;
+        return out;
+    }
+    for (const [k, v] of Object.entries(inp)) {
+        const j = mappings[k];
+        if (j === null) {
+            continue;
+        }
+        out[j ?? k] = v;
+    }
+    return out;
+}
+export function combineSignals(...signals) {
+    const filtered = [];
+    for (const signal of signals) {
+        if (signal) {
+            filtered.push(signal);
+        }
+    }
+    switch (filtered.length) {
+        case 0:
+        case 1:
+            return filtered[0] || null;
+        default:
+            if ("any" in AbortSignal && typeof AbortSignal.any === "function") {
+                return AbortSignal.any(filtered);
+            }
+            return abortSignalAny(filtered);
+    }
+}
+export function abortSignalAny(signals) {
+    const controller = new AbortController();
+    const result = controller.signal;
+    if (!signals.length) {
+        return controller.signal;
+    }
+    if (signals.length === 1) {
+        return signals[0] || controller.signal;
+    }
+    for (const signal of signals) {
+        if (signal.aborted) {
+            return signal;
+        }
+    }
+    function abort() {
+        controller.abort(this.reason);
+        clean();
+    }
+    const signalRefs = [];
+    function clean() {
+        for (const signalRef of signalRefs) {
+            const signal = signalRef.deref();
+            if (signal) {
+                signal.removeEventListener("abort", abort);
+            }
+        }
+    }
+    for (const signal of signals) {
+        signalRefs.push(new WeakRef(signal));
+        signal.addEventListener("abort", abort);
+    }
+    return result;
+}
+export function compactMap(values) {
+    const out = {};
+    for (const [k, v] of Object.entries(values)) {
+        if (typeof v !== "undefined") {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+export function allRequired(v) {
+    if (Object.values(v).every((x) => x == null)) {
+        return void 0;
+    }
+    return v;
+}
+//# sourceMappingURL=primitives.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/lib/primitives.ts"],"names":[],"mappings":"AACA,MAAM,cAAe,SAAQ,KAAK;IAChC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CACvB,SAAkB,EAClB,OAAe;IAEf,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAcD;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAGnB,GAAQ,EAAE,QAAiB;IAC3B,IAAI,GAAG,GAAQ,EAAE,CAAC;IAElB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;QAClC,GAAG,GAAG,GAAG,CAAC;QACV,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QACD,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,GAAG,OAA8C;IAEjD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,CAAC;QACP,KAAK,CAAC;YACJ,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC7B;YACE,IAAI,KAAK,IAAI,WAAW,IAAI,OAAO,WAAW,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;gBAClE,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IACjC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,UAAU,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC;IACzC,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,SAAS,KAAK;QACZ,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,KAAK,EAAE,CAAC;IACV,CAAC;IAED,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,SAAS,KAAK;QACZ,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,MAAqC;IAErC,MAAM,GAAG,GAAsB,EAAE,CAAC;IAElC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,OAAO,CAAC,KAAK,WAAW,EAAE,CAAC;YAC7B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,CAAI;IAMJ,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC,CAAC;IAChB,CAAC;IAED,OAAO,CAAsC,CAAC;AAChD,CAAC"}

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

@@ -0,0 +1,38 @@
+export type BackoffStrategy = {
+    initialInterval: number;
+    maxInterval: number;
+    exponent: number;
+    maxElapsedTime: number;
+};
+export type RetryConfig = {
+    strategy: "none";
+} | {
+    strategy: "backoff";
+    backoff?: BackoffStrategy;
+    retryConnectionErrors?: boolean;
+};
+/**
+ * PermanentError is an error that is not recoverable. Throwing this error will
+ * cause a retry loop to terminate.
+ */
+export declare class PermanentError extends Error {
+    /** The underlying cause of the error. */
+    readonly cause: unknown;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * TemporaryError is an error is used to signal that an HTTP request can be
+ * retried as part of a retry loop. If retry attempts are exhausted and this
+ * error is thrown, the response will be returned to the caller.
+ */
+export declare class TemporaryError extends Error {
+    response: Response;
+    constructor(message: string, response: Response);
+}
+export declare function retry(fetchFn: () => Promise<Response>, options: {
+    config: RetryConfig;
+    statusCodes: string[];
+}): Promise<Response>;
+//# sourceMappingURL=retries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retries.d.ts","sourceRoot":"","sources":["../../../src/lib/retries.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAAG;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AASF,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IACE,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEN;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,yCAAyC;IACzC,SAAkB,KAAK,EAAE,OAAO,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAgB3D;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,EAAE,QAAQ,CAAC;gBAEP,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;CAOhD;AAED,wBAAsB,KAAK,CACzB,OAAO,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAChC,OAAO,EAAE;IACP,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,GACA,OAAO,CAAC,QAAQ,CAAC,CAanB"}

package/dist/esm/lib/retries.js

@@ -0,0 +1,144 @@
+import { isConnectionError, isTimeoutError } from "./http.js";
+const defaultBackoff = {
+    initialInterval: 500,
+    maxInterval: 60000,
+    exponent: 1.5,
+    maxElapsedTime: 3600000,
+};
+/**
+ * PermanentError is an error that is not recoverable. Throwing this error will
+ * cause a retry loop to terminate.
+ */
+export class PermanentError extends Error {
+    constructor(message, options) {
+        let msg = message;
+        if (options?.cause) {
+            msg += `: ${options.cause}`;
+        }
+        super(msg, options);
+        this.name = "PermanentError";
+        // In older runtimes, the cause field would not have been assigned through
+        // the super() call.
+        if (typeof this.cause === "undefined") {
+            this.cause = options?.cause;
+        }
+        Object.setPrototypeOf(this, PermanentError.prototype);
+    }
+}
+/**
+ * TemporaryError is an error is used to signal that an HTTP request can be
+ * retried as part of a retry loop. If retry attempts are exhausted and this
+ * error is thrown, the response will be returned to the caller.
+ */
+export class TemporaryError extends Error {
+    constructor(message, response) {
+        super(message);
+        this.response = response;
+        this.name = "TemporaryError";
+        Object.setPrototypeOf(this, TemporaryError.prototype);
+    }
+}
+export async function retry(fetchFn, options) {
+    switch (options.config.strategy) {
+        case "backoff":
+            return retryBackoff(wrapFetcher(fetchFn, {
+                statusCodes: options.statusCodes,
+                retryConnectionErrors: !!options.config.retryConnectionErrors,
+            }), options.config.backoff ?? defaultBackoff);
+        default:
+            return await fetchFn();
+    }
+}
+function wrapFetcher(fn, options) {
+    return async () => {
+        try {
+            const res = await fn();
+            if (isRetryableResponse(res, options.statusCodes)) {
+                throw new TemporaryError("Response failed with retryable status code", res);
+            }
+            return res;
+        }
+        catch (err) {
+            if (err instanceof TemporaryError) {
+                throw err;
+            }
+            if (options.retryConnectionErrors &&
+                (isTimeoutError(err) || isConnectionError(err))) {
+                throw err;
+            }
+            throw new PermanentError("Permanent error", { cause: err });
+        }
+    };
+}
+const codeRangeRE = new RegExp("^[0-9]xx$", "i");
+function isRetryableResponse(res, statusCodes) {
+    const actual = `${res.status}`;
+    return statusCodes.some((code) => {
+        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;
+    });
+}
+async function retryBackoff(fn, strategy) {
+    const { maxElapsedTime, initialInterval, exponent, maxInterval } = strategy;
+    const start = Date.now();
+    let x = 0;
+    while (true) {
+        try {
+            const res = await fn();
+            return res;
+        }
+        catch (err) {
+            if (err instanceof PermanentError) {
+                throw err.cause;
+            }
+            const elapsed = Date.now() - start;
+            if (elapsed > maxElapsedTime) {
+                if (err instanceof TemporaryError) {
+                    return err.response;
+                }
+                throw err;
+            }
+            let retryInterval = 0;
+            if (err instanceof TemporaryError) {
+                retryInterval = retryIntervalFromResponse(err.response);
+            }
+            if (retryInterval <= 0) {
+                retryInterval =
+                    initialInterval * Math.pow(x, exponent) + Math.random() * 1000;
+            }
+            const d = Math.min(retryInterval, maxInterval);
+            await delay(d);
+            x++;
+        }
+    }
+}
+function retryIntervalFromResponse(res) {
+    const retryVal = res.headers.get("retry-after") || "";
+    if (!retryVal) {
+        return 0;
+    }
+    const parsedNumber = Number(retryVal);
+    if (Number.isInteger(parsedNumber)) {
+        return parsedNumber * 1000;
+    }
+    const parsedDate = Date.parse(retryVal);
+    if (Number.isInteger(parsedDate)) {
+        const deltaMS = parsedDate - Date.now();
+        return deltaMS > 0 ? Math.ceil(deltaMS) : 0;
+    }
+    return 0;
+}
+async function delay(delay) {
+    return new Promise((resolve) => setTimeout(resolve, delay));
+}
+//# sourceMappingURL=retries.js.map

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

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

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

@@ -0,0 +1,21 @@
+import * as z from "zod/v4";
+import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
+import { Result } from "../types/fp.js";
+/**
+ * Utility function that executes some code which may throw a ZodError. It
+ * intercepts this error and converts it to an SDKValidationError so as to not
+ * leak Zod implementation details to user code.
+ */
+export declare function parse<Inp, Out>(rawValue: Inp, fn: (value: Inp) => Out, errorMessage: string): Out;
+/**
+ * Utility function that executes some code which may result in a ZodError. It
+ * intercepts this error and converts it to an SDKValidationError so as to not
+ * leak Zod implementation details to user code.
+ */
+export declare function safeParse<Inp, Out>(rawValue: Inp, fn: (value: Inp) => Out, errorMessage: string): Result<Out, SDKValidationError>;
+export declare function collectExtraKeys<Shape extends z.core.$ZodShape, Catchall extends z.ZodType, K extends string, Optional extends boolean>(obj: z.ZodObject<Shape, z.core.$catchall<Catchall>>, extrasKey: K, optional: Optional): z.ZodPipe<z.ZodObject<Shape, z.core.$catchall<Catchall>>, z.ZodTransform<z.output<z.ZodObject<Shape, z.core.$strip>> & (Optional extends false ? {
+    [k in K]: Record<string, z.output<Catchall>>;
+} : {
+    [k in K]?: Record<string, z.output<Catchall>> | undefined;
+}), z.output<z.ZodObject<Shape, z.core.$catchall<Catchall>>>>>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAW,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,EAC5B,QAAQ,EAAE,GAAG,EACb,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,EACvB,YAAY,EAAE,MAAM,GACnB,GAAG,CASL;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAChC,QAAQ,EAAE,GAAG,EACb,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,EACvB,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAMjC;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,EAC9B,QAAQ,SAAS,CAAC,CAAC,OAAO,EAC1B,CAAC,SAAS,MAAM,EAChB,QAAQ,SAAS,OAAO,EAExB,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EACnD,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,QAAQ,GACjB,CAAC,CAAC,OAAO,CACV,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAC9C,CAAC,CAAC,YAAY,CACV,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAC3C,CAAC,QAAQ,SAAS,KAAK,GAAG;KACvB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;CAC7C,GACC;KACC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS;CAC1D,CAAC,EACJ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CACzD,CACF,CA2BA"}

package/dist/esm/lib/schemas.js

@@ -0,0 +1,54 @@
+import * as z from "zod/v4";
+import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
+import { ERR, OK } from "../types/fp.js";
+/**
+ * Utility function that executes some code which may throw a ZodError. It
+ * intercepts this error and converts it to an SDKValidationError so as to not
+ * leak Zod implementation details to user code.
+ */
+export function parse(rawValue, fn, errorMessage) {
+    try {
+        return fn(rawValue);
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            throw new SDKValidationError(errorMessage, err, rawValue);
+        }
+        throw err;
+    }
+}
+/**
+ * Utility function that executes some code which may result in a ZodError. It
+ * intercepts this error and converts it to an SDKValidationError so as to not
+ * leak Zod implementation details to user code.
+ */
+export function safeParse(rawValue, fn, errorMessage) {
+    try {
+        return OK(fn(rawValue));
+    }
+    catch (err) {
+        return ERR(new SDKValidationError(errorMessage, err, rawValue));
+    }
+}
+export function collectExtraKeys(obj, extrasKey, optional) {
+    return z.pipe(obj, z.transform((val) => {
+        const extras = {};
+        const { shape } = obj;
+        for (const [key] of Object.entries(val)) {
+            if (key in shape) {
+                continue;
+            }
+            const v = val[key];
+            if (typeof v === "undefined") {
+                continue;
+            }
+            extras[key] = v;
+            delete val[key];
+        }
+        if (optional && Object.keys(extras).length === 0) {
+            return val;
+        }
+        return { ...val, [extrasKey]: extras };
+    }));
+}
+//# sourceMappingURL=schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/lib/schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,GAAG,EAAE,EAAE,EAAU,MAAM,gBAAgB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,KAAK,CACnB,QAAa,EACb,EAAuB,EACvB,YAAoB;IAEpB,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,kBAAkB,CAAC,YAAY,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,QAAa,EACb,EAAuB,EACvB,YAAoB;IAEpB,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,GAAG,CAAC,IAAI,kBAAkB,CAAC,YAAY,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAM9B,GAAmD,EACnD,SAAY,EACZ,QAAkB;IAclB,OAAO,CAAC,CAAC,IAAI,CACX,GAAG,EACH,CAAC,CAAC,SAAS,CAAC,CAAC,GAAQ,EAAE,EAAE;QACvB,MAAM,MAAM,GAAuC,EAAE,CAAC;QACtD,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;QACtB,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;gBACjB,SAAS;YACX,CAAC;YAED,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,IAAI,OAAO,CAAC,KAAK,WAAW,EAAE,CAAC;gBAC7B,SAAS;YACX,CAAC;YAED,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,GAAG,CAAC;QACb,CAAC;QAED,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}