@nirmos/sdk 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# Nirmos TypeScript SDK
+
+Official TypeScript SDK for Nirmos Gateway and managed prompts. Supports Node.js 18+, ESM, CommonJS, streaming, normalized responses, stable error classes, and dependency-free prompt caching.
+
+## Install
+
+```bash
+pnpm add @nirmos/sdk
+```
+
+## Chat
+
+```ts
+import { Nirmos } from "@nirmos/sdk";
+
+const nirmos = new Nirmos({
+  apiKey: process.env.NIRMOS_API_KEY!,
+});
+
+const response = await nirmos.gateway.chat.create({
+  model: "openai/gpt-4.1-mini",
+  messages: [{ role: "user", content: "Hello from Nirmos" }],
+});
+
+console.log(response.outputText);
+console.log(response.usage);
+console.log(response.metadata.requestId);
+```
+
+## Streaming
+
+```ts
+const stream = await nirmos.gateway.chat.stream({
+  model: "openai/gpt-4.1-mini",
+  messages: [{ role: "user", content: "Write a short announcement." }],
+});
+
+for await (const event of stream) {
+  if (event.type === "content.delta") {
+    process.stdout.write(event.delta ?? "");
+  }
+}
+
+const completion = await stream.finalResponse();
+```
+
+## Managed prompts
+
+```ts
+const response = await nirmos.gateway.chat.create({
+  model: "anthropic/claude-sonnet-4",
+  prompt: {
+    id: "support-reply",
+    variables: { customerName: "Asha", tone: "calm" },
+  },
+  messages: [{ role: "user", content: "My order has not arrived." }],
+});
+```
+
+Prompt retrieval uses a configurable in-memory TTL/LRU cache. Content changes create immutable versions; approved versions can be activated without application redeployment.
+
+Full documentation lives in `apps/web/content/docs/sdk` in the Nirmos repository.

package/dist/cjs/client.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NirmosClient = exports.Nirmos = void 0;
+const errors_js_1 = require("./core/errors.js");
+const transport_js_1 = require("./core/transport.js");
+const gateway_js_1 = require("./gateway/gateway.js");
+const prompts_js_1 = require("./prompts/prompts.js");
+class Nirmos {
+    gateway;
+    prompts;
+    constructor(options) {
+        validateOptions(options);
+        const transport = new transport_js_1.HttpTransport({
+            apiKey: options.apiKey,
+            baseUrl: normalizeBaseUrl(options.baseUrl ?? "https://api.nirmos.com"),
+            timeoutMs: nonNegative(options.timeoutMs, 60_000),
+            maxRetries: nonNegativeInteger(options.maxRetries, 2),
+            fetch: options.fetch ?? globalThis.fetch,
+            headers: options.headers,
+        });
+        this.prompts = new prompts_js_1.Prompts(transport, options.promptCache);
+        this.gateway = new gateway_js_1.Gateway(transport, this.prompts);
+    }
+}
+exports.Nirmos = Nirmos;
+exports.NirmosClient = Nirmos;
+function validateOptions(options) {
+    if (!options || typeof options !== "object") {
+        throw configError("Nirmos options are required.");
+    }
+    if (!options.apiKey || !options.apiKey.trim()) {
+        throw configError("Nirmos apiKey is required.");
+    }
+    if (typeof (options.fetch ?? globalThis.fetch) !== "function") {
+        throw configError("No fetch implementation found. Provide options.fetch in this runtime.");
+    }
+}
+function normalizeBaseUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw configError("Nirmos baseUrl must be a valid absolute URL.");
+    }
+    return url.toString().replace(/\/+$/, "");
+}
+function nonNegative(value, fallback) {
+    return value !== undefined && Number.isFinite(value) && value >= 0
+        ? value
+        : fallback;
+}
+function nonNegativeInteger(value, fallback) {
+    return value !== undefined && Number.isInteger(value) && value >= 0
+        ? value
+        : fallback;
+}
+function configError(message) {
+    return new errors_js_1.ConfigurationError(message);
+}
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";;;AAAA,gDAAsD;AACtD,sDAAoD;AAEpD,qDAA+C;AAC/C,qDAA+C;AAoB/C,MAAa,MAAM;IACR,OAAO,CAAU;IACjB,OAAO,CAAU;IAE1B,YAAY,OAAsB;QAChC,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,4BAAa,CAAC;YAClC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,IAAI,wBAAwB,CAAC;YACtE,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;YACjD,UAAU,EAAE,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;YACrD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK;YACxC,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,IAAI,oBAAO,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,IAAI,oBAAO,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;CACF;AAlBD,wBAkBC;AAGkB,8BAAY;AAE/B,SAAS,eAAe,CAAC,OAAsB;IAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,WAAW,CAAC,8BAA8B,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9C,MAAM,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,UAAU,EAAE,CAAC;QAC9D,MAAM,WAAW,CACf,uEAAuE,CACxE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,WAAW,CAAC,8CAA8C,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,WAAW,CAAC,KAAyB,EAAE,QAAgB;IAC9D,OAAO,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAChE,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAyB,EACzB,QAAgB;IAEhB,OAAO,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QACjE,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,IAAI,8BAAkB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/cjs/core/errors.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptRenderError = exports.StreamError = exports.NetworkError = exports.RequestAbortedError = exports.TimeoutError = exports.ServerError = exports.RateLimitError = exports.ValidationError = exports.ConflictError = exports.NotFoundError = exports.PermissionDeniedError = exports.AuthenticationError = exports.APIError = exports.ConfigurationError = exports.NirmosError = void 0;
+class NirmosError extends Error {
+    code;
+    requestId;
+    traceId;
+    constructor(message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = "NirmosError";
+        this.code = options.code;
+        this.requestId = options.requestId;
+        this.traceId = options.traceId;
+    }
+}
+exports.NirmosError = NirmosError;
+class ConfigurationError extends NirmosError {
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            code: options.code ?? "SDK_CONFIGURATION_ERROR",
+        });
+        this.name = "ConfigurationError";
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+class APIError extends NirmosError {
+    status;
+    retryable;
+    retryAfterMs;
+    details;
+    metadata;
+    headers;
+    constructor(message, options) {
+        super(message, options);
+        this.name = "APIError";
+        this.status = options.status;
+        this.retryable = options.retryable ?? false;
+        this.retryAfterMs = options.retryAfterMs;
+        this.details = options.details;
+        this.metadata = options.metadata;
+        this.headers = options.headers;
+    }
+}
+exports.APIError = APIError;
+class AuthenticationError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "AuthenticationError";
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+class PermissionDeniedError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "PermissionDeniedError";
+    }
+}
+exports.PermissionDeniedError = PermissionDeniedError;
+class NotFoundError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "NotFoundError";
+    }
+}
+exports.NotFoundError = NotFoundError;
+class ConflictError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ConflictError";
+    }
+}
+exports.ConflictError = ConflictError;
+class ValidationError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ValidationError";
+    }
+}
+exports.ValidationError = ValidationError;
+class RateLimitError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "RateLimitError";
+    }
+}
+exports.RateLimitError = RateLimitError;
+class ServerError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ServerError";
+    }
+}
+exports.ServerError = ServerError;
+class TimeoutError extends NirmosError {
+    timeoutMs;
+    constructor(timeoutMs, options = {}) {
+        super(`Request timed out after ${timeoutMs}ms.`, {
+            ...options,
+            code: options.code ?? "REQUEST_TIMEOUT",
+        });
+        this.name = "TimeoutError";
+        this.timeoutMs = timeoutMs;
+    }
+}
+exports.TimeoutError = TimeoutError;
+class RequestAbortedError extends NirmosError {
+    constructor(options = {}) {
+        super("Request was aborted.", {
+            ...options,
+            code: options.code ?? "REQUEST_ABORTED",
+        });
+        this.name = "RequestAbortedError";
+    }
+}
+exports.RequestAbortedError = RequestAbortedError;
+class NetworkError extends NirmosError {
+    constructor(cause) {
+        super("Unable to reach the Nirmos API.", {
+            cause,
+            code: "NETWORK_ERROR",
+        });
+        this.name = "NetworkError";
+    }
+}
+exports.NetworkError = NetworkError;
+class StreamError extends NirmosError {
+    constructor(message, options = {}) {
+        super(message, { ...options, code: options.code ?? "STREAM_ERROR" });
+        this.name = "StreamError";
+    }
+}
+exports.StreamError = StreamError;
+class PromptRenderError extends NirmosError {
+    missingVariables;
+    constructor(message, missingVariables = []) {
+        super(message, { code: "PROMPT_RENDER_ERROR" });
+        this.name = "PromptRenderError";
+        this.missingVariables = missingVariables;
+    }
+}
+exports.PromptRenderError = PromptRenderError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/core/errors.js.map

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

package/dist/cjs/core/metadata.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractMetadata = extractMetadata;
+exports.compactMetadata = compactMetadata;
+exports.asUnknownRecord = asUnknownRecord;
+exports.readString = readString;
+exports.readNumber = readNumber;
+exports.readBoolean = readBoolean;
+exports.readArray = readArray;
+function asRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? value
+        : undefined;
+}
+function header(response, ...names) {
+    for (const name of names) {
+        const value = response.headers.get(name);
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+function numericHeader(response, ...names) {
+    const value = header(response, ...names);
+    if (!value)
+        return undefined;
+    const number = Number.parseFloat(value.replace(/ms$/i, ""));
+    return Number.isFinite(number) ? number : undefined;
+}
+function extractMetadata(response, payload) {
+    const root = asRecord(payload);
+    const bodyMeta = asRecord(root?._meta) ?? asRecord(root?.meta) ?? asRecord(root?.metadata);
+    const metadata = {
+        requestId: stringValue(bodyMeta?.request_id) ??
+            stringValue(bodyMeta?.requestId) ??
+            header(response, "x-nirmos-request-id", "x-request-id"),
+        traceId: stringValue(bodyMeta?.trace_id) ??
+            stringValue(bodyMeta?.traceId) ??
+            header(response, "x-nirmos-trace-id", "x-trace-id"),
+        provider: stringValue(bodyMeta?.provider) ?? header(response, "x-nirmos-provider"),
+        model: stringValue(bodyMeta?.model) ?? header(response, "x-nirmos-model"),
+        latencyMs: numberValue(bodyMeta?.latency_ms) ??
+            numberValue(bodyMeta?.latencyMs) ??
+            numericHeader(response, "x-nirmos-response-time", "x-response-time"),
+    };
+    const cacheStatus = header(response, "x-nirmos-cache-status", "x-promptnetra-cache-status");
+    const cacheLayer = header(response, "x-nirmos-cache-layer", "x-promptnetra-cache-layer");
+    const remainingTtlSeconds = numericHeader(response, "x-nirmos-cache-remaining-ttl", "x-promptnetra-cache-remaining-ttl");
+    if (cacheStatus || cacheLayer || remainingTtlSeconds !== undefined) {
+        metadata.cache = {
+            status: cacheStatus,
+            layer: cacheLayer,
+            remainingTtlSeconds,
+        };
+    }
+    return metadata;
+}
+function compactMetadata(metadata) {
+    return Object.fromEntries(Object.entries(metadata).filter(([, value]) => value !== undefined));
+}
+function asUnknownRecord(value) {
+    return asRecord(value) ?? {};
+}
+function readString(record, ...keys) {
+    for (const key of keys) {
+        const value = stringValue(record[key]);
+        if (value !== undefined)
+            return value;
+    }
+    return undefined;
+}
+function readNumber(record, ...keys) {
+    for (const key of keys) {
+        const value = numberValue(record[key]);
+        if (value !== undefined)
+            return value;
+    }
+    return undefined;
+}
+function readBoolean(record, ...keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === "boolean")
+            return value;
+    }
+    return undefined;
+}
+function readArray(record, ...keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (Array.isArray(value))
+            return value;
+    }
+    return [];
+}
+//# sourceMappingURL=metadata.js.map

package/dist/cjs/core/metadata.js.map

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

package/dist/cjs/core/transport.js

@@ -0,0 +1,276 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpTransport = void 0;
+const errors_js_1 = require("./errors.js");
+const metadata_js_1 = require("./metadata.js");
+const SDK_VERSION = "1.0.0";
+class HttpTransport {
+    #config;
+    constructor(config) {
+        this.#config = config;
+    }
+    async request(request) {
+        const response = await this.fetch(request);
+        const data = await parseResponseBody(response);
+        if (!response.ok) {
+            throw createApiError(response, data);
+        }
+        return { data: data, response };
+    }
+    async ensureSuccess(response) {
+        if (response.ok)
+            return response;
+        const data = await parseResponseBody(response);
+        throw createApiError(response, data);
+    }
+    async fetch(request) {
+        const maxRetries = request.options?.maxRetries ?? this.#config.maxRetries;
+        const retryableMethod = request.method === "GET" || request.options?.idempotencyKey !== undefined;
+        let attempt = 0;
+        while (true) {
+            try {
+                const response = await this.#fetchOnce(request);
+                if (retryableMethod &&
+                    attempt < maxRetries &&
+                    isRetryableStatus(response.status)) {
+                    await response.body?.cancel();
+                    await waitBeforeRetry(response, attempt, request.options?.signal);
+                    attempt += 1;
+                    continue;
+                }
+                return response;
+            }
+            catch (error) {
+                if (retryableMethod &&
+                    attempt < maxRetries &&
+                    error instanceof errors_js_1.NetworkError) {
+                    await wait(250 * 2 ** attempt, request.options?.signal);
+                    attempt += 1;
+                    continue;
+                }
+                throw error;
+            }
+        }
+    }
+    async #fetchOnce(request) {
+        const timeoutMs = request.options?.timeoutMs ?? this.#config.timeoutMs;
+        const controller = new AbortController();
+        let timedOut = false;
+        let externallyAborted = false;
+        let timer;
+        let responseOwnsCleanup = false;
+        let cleanedUp = false;
+        const abortFromSignal = () => {
+            externallyAborted = true;
+            controller.abort(request.options?.signal?.reason);
+            cleanup();
+        };
+        const cleanup = () => {
+            if (cleanedUp)
+                return;
+            cleanedUp = true;
+            if (timer)
+                clearTimeout(timer);
+            request.options?.signal?.removeEventListener("abort", abortFromSignal);
+        };
+        if (request.options?.signal?.aborted) {
+            throw new errors_js_1.RequestAbortedError({
+                cause: request.options.signal.reason,
+            });
+        }
+        request.options?.signal?.addEventListener("abort", abortFromSignal, {
+            once: true,
+        });
+        if (timeoutMs > 0) {
+            timer = setTimeout(() => {
+                timedOut = true;
+                controller.abort();
+                cleanup();
+            }, timeoutMs);
+        }
+        try {
+            const response = await this.#config.fetch(this.#url(request), {
+                method: request.method,
+                headers: this.#headers(request),
+                body: request.body === undefined ? undefined : JSON.stringify(request.body),
+                signal: controller.signal,
+            });
+            if (!response.body)
+                return response;
+            responseOwnsCleanup = true;
+            const reader = response.body.getReader();
+            const body = new ReadableStream({
+                async pull(streamController) {
+                    try {
+                        const { done, value } = await reader.read();
+                        if (done) {
+                            cleanup();
+                            streamController.close();
+                        }
+                        else {
+                            streamController.enqueue(value);
+                        }
+                    }
+                    catch (error) {
+                        cleanup();
+                        if (timedOut) {
+                            streamController.error(new errors_js_1.TimeoutError(timeoutMs, { cause: error }));
+                        }
+                        else if (externallyAborted || request.options?.signal?.aborted) {
+                            streamController.error(new errors_js_1.RequestAbortedError({ cause: error }));
+                        }
+                        else {
+                            streamController.error(new errors_js_1.NetworkError(error));
+                        }
+                    }
+                },
+                async cancel(reason) {
+                    try {
+                        await reader.cancel(reason);
+                    }
+                    finally {
+                        cleanup();
+                    }
+                },
+            });
+            return new Response(body, {
+                headers: response.headers,
+                status: response.status,
+                statusText: response.statusText,
+            });
+        }
+        catch (error) {
+            if (timedOut)
+                throw new errors_js_1.TimeoutError(timeoutMs, { cause: error });
+            if (externallyAborted || request.options?.signal?.aborted) {
+                throw new errors_js_1.RequestAbortedError({ cause: error });
+            }
+            throw new errors_js_1.NetworkError(error);
+        }
+        finally {
+            if (!responseOwnsCleanup)
+                cleanup();
+        }
+    }
+    #url(request) {
+        const url = new URL(request.path.replace(/^\//, ""), `${this.#config.baseUrl}/`);
+        for (const [key, value] of Object.entries(request.query ?? {})) {
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        }
+        return url.toString();
+    }
+    #headers(request) {
+        const headers = createHeaders(this.#config.headers);
+        headers.set("accept", "application/json");
+        headers.set("x-api-key", this.#config.apiKey);
+        headers.set("x-nirmos-sdk-version", SDK_VERSION);
+        if (request.body !== undefined) {
+            headers.set("content-type", "application/json");
+        }
+        createHeaders(request.options?.headers).forEach((value, key) => {
+            if (key.toLowerCase() !== "x-api-key")
+                headers.set(key, value);
+        });
+        if (request.options?.idempotencyKey) {
+            headers.set("idempotency-key", request.options.idempotencyKey);
+        }
+        return headers;
+    }
+}
+exports.HttpTransport = HttpTransport;
+async function parseResponseBody(response) {
+    if (response.status === 204)
+        return undefined;
+    const text = await response.text();
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function createApiError(response, payload) {
+    const root = (0, metadata_js_1.asUnknownRecord)(payload);
+    const error = (0, metadata_js_1.asUnknownRecord)(root.error);
+    const metadata = (0, metadata_js_1.extractMetadata)(response, payload);
+    const message = ((0, metadata_js_1.readString)(error, "message") ??
+        (0, metadata_js_1.readString)(root, "message") ??
+        response.statusText) ||
+        "Nirmos API request failed.";
+    const code = (0, metadata_js_1.readString)(error, "code", "type") ?? (0, metadata_js_1.readString)(root, "code");
+    const retryable = (0, metadata_js_1.readBoolean)(error, "retryable") ?? isRetryableStatus(response.status);
+    const retryAfterMs = parseRetryAfter(response.headers.get("retry-after"));
+    const options = {
+        status: response.status,
+        code,
+        retryable,
+        retryAfterMs,
+        details: error.details,
+        metadata,
+        requestId: metadata.requestId,
+        traceId: metadata.traceId,
+        headers: response.headers,
+    };
+    if (response.status === 401)
+        return new errors_js_1.AuthenticationError(message, options);
+    if (response.status === 403)
+        return new errors_js_1.PermissionDeniedError(message, options);
+    if (response.status === 404)
+        return new errors_js_1.NotFoundError(message, options);
+    if (response.status === 409)
+        return new errors_js_1.ConflictError(message, options);
+    if (response.status === 422 || response.status === 400) {
+        return new errors_js_1.ValidationError(message, options);
+    }
+    if (response.status === 429)
+        return new errors_js_1.RateLimitError(message, options);
+    if (response.status >= 500)
+        return new errors_js_1.ServerError(message, options);
+    return new errors_js_1.APIError(message, options);
+}
+function isRetryableStatus(status) {
+    return status === 408 || status === 429 || status >= 500;
+}
+function parseRetryAfter(value) {
+    if (!value)
+        return undefined;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds))
+        return Math.max(0, seconds * 1_000);
+    const date = Date.parse(value);
+    return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());
+}
+async function waitBeforeRetry(response, attempt, signal) {
+    const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
+    await wait(retryAfter ?? 250 * 2 ** attempt, signal);
+}
+async function wait(milliseconds, signal) {
+    if (signal?.aborted) {
+        throw new errors_js_1.RequestAbortedError({ cause: signal.reason });
+    }
+    await new Promise((resolve, reject) => {
+        const finish = () => {
+            signal?.removeEventListener("abort", abort);
+            resolve();
+        };
+        const timer = setTimeout(finish, milliseconds);
+        const abort = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", abort);
+            reject(new errors_js_1.RequestAbortedError({ cause: signal?.reason }));
+        };
+        signal?.addEventListener("abort", abort, { once: true });
+    });
+}
+function createHeaders(input) {
+    if (!input)
+        return new Headers();
+    if (Array.isArray(input)) {
+        return new Headers(input.map(([key, value]) => [key, value]));
+    }
+    return new Headers(input);
+}
+//# sourceMappingURL=transport.js.map