@nirmos/sdk 0.1.0

package/dist/cjs/prompts/prompts.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Prompts = void 0;
+const cache_js_1 = require("./cache.js");
+const mappers_js_1 = require("./mappers.js");
+const render_js_1 = require("./render.js");
+const versions_js_1 = require("./versions.js");
+class Prompts {
+    versions;
+    #transport;
+    #cache;
+    #inflight = new Map();
+    constructor(transport, config = {}) {
+        this.#transport = transport;
+        if (config !== false && config.enabled !== false) {
+            this.#cache = new cache_js_1.MemoryCache(positiveInteger(config.maxEntries, 100), nonNegativeNumber(config.ttlMs, 60_000));
+        }
+        this.versions = new versions_js_1.PromptVersions(transport, () => this.clearCache());
+    }
+    async create(params, options) {
+        const { data, response } = await this.#transport.request({
+            method: "POST",
+            path: "/v1/prompts",
+            body: (0, mappers_js_1.toWirePromptCreate)(params),
+            options,
+        });
+        this.clearCache();
+        return (0, mappers_js_1.normalizePrompt)(data, response);
+    }
+    async retrieve(identifier, options = {}) {
+        const { version = "active", cache = "default", ...requestOptions } = options;
+        const key = cacheKey(identifier, version);
+        if (cache === "default") {
+            const cached = this.#cache?.get(key);
+            if (cached)
+                return cached;
+            const pending = this.#inflight.get(key);
+            if (pending)
+                return pending;
+        }
+        const pending = this.#retrieveFromApi(identifier, version, requestOptions).then((prompt) => {
+            if (cache !== "no-store")
+                this.#cache?.set(key, prompt);
+            return prompt;
+        });
+        if (cache === "default")
+            this.#inflight.set(key, pending);
+        try {
+            return await pending;
+        }
+        finally {
+            this.#inflight.delete(key);
+        }
+    }
+    async retrieveActive(identifier, options = {}) {
+        return this.retrieve(identifier, { ...options, version: "active" });
+    }
+    async retrieveLatest(identifier, options = {}) {
+        return this.retrieve(identifier, { ...options, version: "latest" });
+    }
+    async update(identifier, params, options) {
+        const { data, response } = await this.#transport.request({
+            method: "PATCH",
+            path: `/v1/prompts/${encodeURIComponent(identifier)}`,
+            body: {
+                name: params.name,
+                slug: params.slug,
+                description: params.description,
+                metadata: params.metadata,
+                tags: params.tags,
+                folder: params.folder,
+                status: params.status,
+            },
+            options,
+        });
+        this.clearCache();
+        return (0, mappers_js_1.normalizePrompt)(data, response);
+    }
+    async render(promptOrReference, values = {}, options = {}) {
+        const prompt = "content" in promptOrReference
+            ? promptOrReference
+            : await this.retrieve(promptOrReference.id, {
+                version: promptOrReference.version,
+                cache: promptOrReference.cache,
+            });
+        return (0, render_js_1.renderPrompt)(prompt, values, options);
+    }
+    clearCache(identifier) {
+        if (!identifier) {
+            this.#cache?.clear();
+            return;
+        }
+        const encoded = encodeURIComponent(identifier);
+        this.#cache?.deleteMatching((key) => key.startsWith(`${encoded}:`) || key.includes(`:${encoded}:`));
+    }
+    async #retrieveFromApi(identifier, version, options) {
+        const encoded = encodeURIComponent(identifier);
+        const { data, response } = await this.#transport.request({
+            method: "GET",
+            path: `/v1/prompts/${encoded}`,
+            query: version === "active" ? undefined : { version },
+            options,
+        });
+        return (0, mappers_js_1.normalizePrompt)(data, response);
+    }
+}
+exports.Prompts = Prompts;
+function cacheKey(identifier, version) {
+    return `${encodeURIComponent(identifier)}:${version}`;
+}
+function positiveInteger(value, fallback) {
+    return value !== undefined && Number.isInteger(value) && value > 0
+        ? value
+        : fallback;
+}
+function nonNegativeNumber(value, fallback) {
+    return value !== undefined && Number.isFinite(value) && value >= 0
+        ? value
+        : fallback;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/cjs/prompts/prompts.js.map

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

package/dist/cjs/prompts/render.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPrompt = renderPrompt;
+const errors_js_1 = require("../core/errors.js");
+const PLACEHOLDER = /\{\{\s*([a-zA-Z][a-zA-Z0-9_.-]*)\s*\}\}/g;
+function renderPrompt(prompt, values = {}, options = {}) {
+    const resolved = resolveVariables(prompt.variables, values);
+    const sourceMessages = prompt.content.type === "chat"
+        ? prompt.content.messages
+        : [
+            {
+                role: prompt.content.role ?? "user",
+                content: prompt.content.text,
+            },
+        ];
+    const messages = sourceMessages.map((message) => ({
+        ...message,
+        content: typeof message.content === "string"
+            ? interpolate(message.content, resolved, options)
+            : message.content.map((part) => {
+                if (part.type === "text") {
+                    return {
+                        ...part,
+                        text: interpolate(part.text, resolved, options),
+                    };
+                }
+                if (part.type === "image") {
+                    return {
+                        ...part,
+                        url: interpolate(part.url, resolved, options),
+                    };
+                }
+                return part;
+            }),
+    }));
+    return {
+        promptId: prompt.id,
+        promptVersion: prompt.version.number,
+        messages,
+        variables: resolved,
+    };
+}
+function resolveVariables(definitions, supplied) {
+    const resolved = { ...supplied };
+    const missing = [];
+    for (const variable of definitions) {
+        const value = resolved[variable.name];
+        if (value === undefined && variable.default !== undefined) {
+            resolved[variable.name] = variable.default;
+        }
+        else if (value === undefined && variable.required) {
+            missing.push(variable.name);
+        }
+    }
+    if (missing.length > 0) {
+        throw new errors_js_1.PromptRenderError(`Missing required prompt variables: ${missing.join(", ")}.`, missing);
+    }
+    return resolved;
+}
+function interpolate(template, values, options) {
+    const unresolved = new Set();
+    const result = template.replace(PLACEHOLDER, (placeholder, name) => {
+        const value = values[name];
+        if (value === undefined) {
+            unresolved.add(name);
+            return placeholder;
+        }
+        return stringify(value);
+    });
+    if (unresolved.size > 0 && !options.allowUnresolved) {
+        const names = [...unresolved];
+        throw new errors_js_1.PromptRenderError(`Unresolved prompt variables: ${names.join(", ")}.`, names);
+    }
+    return result;
+}
+function stringify(value) {
+    if (value === null)
+        return "null";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=render.js.map

package/dist/cjs/prompts/render.js.map

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

package/dist/cjs/prompts/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/prompts/types.js.map

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

package/dist/cjs/prompts/versions.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptVersions = void 0;
+const mappers_js_1 = require("./mappers.js");
+class PromptVersions {
+    #transport;
+    #invalidate;
+    constructor(transport, invalidate) {
+        this.#transport = transport;
+        this.#invalidate = invalidate;
+    }
+    async create(identifier, params, options) {
+        const { data } = await this.#transport.request({
+            method: "POST",
+            path: `/v1/prompts/${encodeURIComponent(identifier)}/versions`,
+            body: (0, mappers_js_1.toWireVersionCreate)(params),
+            options,
+        });
+        this.#invalidate();
+        return (0, mappers_js_1.normalizeVersion)(data);
+    }
+    async retrieve(identifier, version, options) {
+        const { data } = await this.#transport.request({
+            method: "GET",
+            path: `/v1/prompts/${encodeURIComponent(identifier)}/versions/${version}`,
+            options,
+        });
+        return (0, mappers_js_1.normalizeVersion)(data);
+    }
+    async list(identifier, options = {}) {
+        const { limit, cursor, ...requestOptions } = options;
+        const { data } = await this.#transport.request({
+            method: "GET",
+            path: `/v1/prompts/${encodeURIComponent(identifier)}/versions`,
+            query: { limit, cursor },
+            options: requestOptions,
+        });
+        return (0, mappers_js_1.normalizeVersionPage)(data);
+    }
+    async activate(identifier, version, options) {
+        const { data } = await this.#transport.request({
+            method: "POST",
+            path: `/v1/prompts/${encodeURIComponent(identifier)}/versions/${version}/activate`,
+            options,
+        });
+        this.#invalidate();
+        return (0, mappers_js_1.normalizeVersion)(data);
+    }
+}
+exports.PromptVersions = PromptVersions;
+//# sourceMappingURL=versions.js.map

package/dist/cjs/prompts/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../../src/prompts/versions.ts"],"names":[],"mappings":";;;AAEA,6CAIsB;AAStB,MAAa,cAAc;IAChB,UAAU,CAAgB;IAC1B,WAAW,CAAa;IAEjC,YAAY,SAAwB,EAAE,UAAsB;QAC1D,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,UAA4B,EAC5B,MAAiC,EACjC,OAAwB;QAExB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAU;YACtD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe,kBAAkB,CAAC,UAAU,CAAC,WAAW;YAC9D,IAAI,EAAE,IAAA,gCAAmB,EAAC,MAAM,CAAC;YACjC,OAAO;SACR,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,OAAO,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,UAA4B,EAC5B,OAAe,EACf,OAAwB;QAExB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAU;YACtD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,kBAAkB,CAAC,UAAU,CAAC,aAAa,OAAO,EAAE;YACzE,OAAO;SACR,CAAC,CAAC;QACH,OAAO,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,UAA4B,EAC5B,UAAoC,EAAE;QAEtC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;QACrD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAU;YACtD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,kBAAkB,CAAC,UAAU,CAAC,WAAW;YAC9D,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;YACxB,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;QACH,OAAO,IAAA,iCAAoB,EAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,UAA4B,EAC5B,OAAe,EACf,OAAwB;QAExB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAU;YACtD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe,kBAAkB,CAAC,UAAU,CAAC,aAAa,OAAO,WAAW;YAClF,OAAO;SACR,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,OAAO,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAhED,wCAgEC"}

package/dist/esm/client.d.ts

@@ -0,0 +1,28 @@
+import type { HeadersInput } from "./core/types.js";
+import { Gateway } from "./gateway/gateway.js";
+import { Prompts } from "./prompts/prompts.js";
+import type { PromptCacheConfig } from "./prompts/types.js";
+export interface NirmosOptions {
+    /** Nirmos API key. Keep this key on trusted servers. */
+    apiKey: string;
+    /** API origin. Defaults to https://api.nirmos.com. */
+    baseUrl?: string;
+    /** Default request timeout. Defaults to 60 seconds. Set to 0 to disable. */
+    timeoutMs?: number;
+    /** Retry count for safe GET requests. Defaults to 2. */
+    maxRetries?: number;
+    /** Custom fetch implementation for tests or specialized runtimes. */
+    fetch?: typeof globalThis.fetch;
+    /** Headers added to every request. */
+    headers?: HeadersInput;
+    /** In-memory managed prompt cache configuration. Set false to disable. */
+    promptCache?: PromptCacheConfig | false;
+}
+export declare class Nirmos {
+    readonly gateway: Gateway;
+    readonly prompts: Prompts;
+    constructor(options: NirmosOptions);
+}
+/** Explicit alias for codebases that prefer client-suffixed class names. */
+export { Nirmos as NirmosClient };
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,sCAAsC;IACtC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC;CACzC;AAED,qBAAa,MAAM;IACjB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,OAAO,EAAE,aAAa;CAcnC;AAED,4EAA4E;AAC5E,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,CAAC"}

package/dist/esm/client.js

@@ -0,0 +1,58 @@
+import { ConfigurationError } from "./core/errors.js";
+import { HttpTransport } from "./core/transport.js";
+import { Gateway } from "./gateway/gateway.js";
+import { Prompts } from "./prompts/prompts.js";
+export class Nirmos {
+    gateway;
+    prompts;
+    constructor(options) {
+        validateOptions(options);
+        const transport = new 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(transport, options.promptCache);
+        this.gateway = new Gateway(transport, this.prompts);
+    }
+}
+/** Explicit alias for codebases that prefer client-suffixed class names. */
+export { Nirmos as NirmosClient };
+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 ConfigurationError(message);
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAoB/C,MAAM,OAAO,MAAM;IACR,OAAO,CAAU;IACjB,OAAO,CAAU;IAE1B,YAAY,OAAsB;QAChC,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,aAAa,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,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;CACF;AAED,4EAA4E;AAC5E,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,CAAC;AAElC,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,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/esm/core/errors.d.ts

@@ -0,0 +1,72 @@
+import type { RequestMetadata } from "./types.js";
+export interface NirmosErrorOptions {
+    cause?: unknown;
+    code?: string;
+    requestId?: string;
+    traceId?: string;
+}
+export declare class NirmosError extends Error {
+    readonly code?: string;
+    readonly requestId?: string;
+    readonly traceId?: string;
+    constructor(message: string, options?: NirmosErrorOptions);
+}
+export declare class ConfigurationError extends NirmosError {
+    constructor(message: string, options?: NirmosErrorOptions);
+}
+export interface APIErrorOptions extends NirmosErrorOptions {
+    status: number;
+    retryable?: boolean;
+    retryAfterMs?: number;
+    details?: unknown;
+    metadata?: RequestMetadata;
+    headers?: Headers;
+}
+export declare class APIError extends NirmosError {
+    readonly status: number;
+    readonly retryable: boolean;
+    readonly retryAfterMs?: number;
+    readonly details?: unknown;
+    readonly metadata?: RequestMetadata;
+    readonly headers?: Headers;
+    constructor(message: string, options: APIErrorOptions);
+}
+export declare class AuthenticationError extends APIError {
+    constructor(message: string, options: APIErrorOptions);
+}
+export declare class PermissionDeniedError extends APIError {
+    constructor(message: string, options: APIErrorOptions);
+}
+export declare class NotFoundError extends APIError {
+    constructor(message: string, options: APIErrorOptions);
+}
+export declare class ConflictError extends APIError {
+    constructor(message: string, options: APIErrorOptions);
+}
+export declare class ValidationError extends APIError {
+    constructor(message: string, options: APIErrorOptions);
+}
+export declare class RateLimitError extends APIError {
+    constructor(message: string, options: APIErrorOptions);
+}
+export declare class ServerError extends APIError {
+    constructor(message: string, options: APIErrorOptions);
+}
+export declare class TimeoutError extends NirmosError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number, options?: NirmosErrorOptions);
+}
+export declare class RequestAbortedError extends NirmosError {
+    constructor(options?: NirmosErrorOptions);
+}
+export declare class NetworkError extends NirmosError {
+    constructor(cause?: unknown);
+}
+export declare class StreamError extends NirmosError {
+    constructor(message: string, options?: NirmosErrorOptions);
+}
+export declare class PromptRenderError extends NirmosError {
+    readonly missingVariables: readonly string[];
+    constructor(message: string, missingVariables?: readonly string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAO9D;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAO9D;AAED,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,QAAS,SAAQ,WAAW;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAUtD;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAItD;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAItD;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAItD;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAItD;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAItD;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAItD;AAED,qBAAa,WAAY,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAItD;AAED,qBAAa,YAAa,SAAQ,WAAW;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAQhE;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,GAAE,kBAAuB;CAO7C;AAED,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,KAAK,CAAC,EAAE,OAAO;CAO5B;AAED,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAI9D;AAED,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEjC,OAAO,EAAE,MAAM,EAAE,gBAAgB,GAAE,SAAS,MAAM,EAAO;CAKtE"}

package/dist/esm/core/errors.js

@@ -0,0 +1,125 @@
+export 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;
+    }
+}
+export class ConfigurationError extends NirmosError {
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            code: options.code ?? "SDK_CONFIGURATION_ERROR",
+        });
+        this.name = "ConfigurationError";
+    }
+}
+export 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;
+    }
+}
+export class AuthenticationError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "AuthenticationError";
+    }
+}
+export class PermissionDeniedError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "PermissionDeniedError";
+    }
+}
+export class NotFoundError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "NotFoundError";
+    }
+}
+export class ConflictError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ConflictError";
+    }
+}
+export class ValidationError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ValidationError";
+    }
+}
+export class RateLimitError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "RateLimitError";
+    }
+}
+export class ServerError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ServerError";
+    }
+}
+export 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;
+    }
+}
+export class RequestAbortedError extends NirmosError {
+    constructor(options = {}) {
+        super("Request was aborted.", {
+            ...options,
+            code: options.code ?? "REQUEST_ABORTED",
+        });
+        this.name = "RequestAbortedError";
+    }
+}
+export class NetworkError extends NirmosError {
+    constructor(cause) {
+        super("Unable to reach the Nirmos API.", {
+            cause,
+            code: "NETWORK_ERROR",
+        });
+        this.name = "NetworkError";
+    }
+}
+export class StreamError extends NirmosError {
+    constructor(message, options = {}) {
+        super(message, { ...options, code: options.code ?? "STREAM_ERROR" });
+        this.name = "StreamError";
+    }
+}
+export class PromptRenderError extends NirmosError {
+    missingVariables;
+    constructor(message, missingVariables = []) {
+        super(message, { code: "PROMPT_RENDER_ERROR" });
+        this.name = "PromptRenderError";
+        this.missingVariables = missingVariables;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/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/esm/core/metadata.d.ts

@@ -0,0 +1,11 @@
+import type { RequestMetadata } from "./types.js";
+type UnknownRecord = Record<string, unknown>;
+export declare function extractMetadata(response: Response, payload?: unknown): RequestMetadata;
+export declare function compactMetadata(metadata: RequestMetadata): RequestMetadata;
+export declare function asUnknownRecord(value: unknown): UnknownRecord;
+export declare function readString(record: UnknownRecord, ...keys: string[]): string | undefined;
+export declare function readNumber(record: UnknownRecord, ...keys: string[]): number | undefined;
+export declare function readBoolean(record: UnknownRecord, ...keys: string[]): boolean | undefined;
+export declare function readArray(record: UnknownRecord, ...keys: string[]): unknown[];
+export {};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/esm/core/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/core/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoC7C,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,OAAO,GAChB,eAAe,CAgDjB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAI1E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAE7D;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EACrB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,OAAO,GAAG,SAAS,CAMrB;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAM7E"}