diffusr 0.0.0-stage → 0.2.0

package/dist/cli/test-helpers.d.ts

@@ -0,0 +1,32 @@
+import type { Io } from "./io.js";
+export interface Call {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body: unknown;
+    raw: unknown;
+}
+export type Route = (call: Call) => {
+    status?: number;
+    body?: unknown;
+} | undefined;
+export interface Fake {
+    io: Io;
+    home: string;
+    out: string[];
+    err: string[];
+    calls: Call[];
+    asked: string[];
+    opened: string[];
+    setRoutes(r: Route[]): void;
+    answers: string[];
+}
+/** An Io with a mocked fetch, a temp HOME and a fake clock. Never touches the network. */
+export declare function fakeIo(opts?: {
+    env?: Record<string, string>;
+    tty?: boolean;
+    routes?: Route[];
+}): Fake;
+export declare const BASE = "https://app.diffusr.ai/api/v2";
+export declare const KEY = "dfsr_live_testkey";
+export declare const on: (method: string, path: string, body: unknown, status?: number) => Route;

package/dist/cli/test-helpers.js

@@ -0,0 +1,70 @@
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/** An Io with a mocked fetch, a temp HOME and a fake clock. Never touches the network. */
+export function fakeIo(opts = {}) {
+    const home = mkdtempSync(join(tmpdir(), "diffusr-cli-"));
+    let routes = opts.routes ?? [];
+    let clock = 1_700_000_000_000;
+    const f = {
+        home,
+        out: [],
+        err: [],
+        calls: [],
+        asked: [],
+        opened: [],
+        answers: [],
+        setRoutes: (r) => (routes = r),
+        io: undefined,
+    };
+    f.io = {
+        out: (l) => void f.out.push(l),
+        err: (l) => void f.err.push(l),
+        errRaw: () => { },
+        stdinIsTTY: opts.tty ?? false,
+        stdoutIsTTY: opts.tty ?? false,
+        stderrIsTTY: false,
+        ask: async (q) => {
+            f.asked.push(q);
+            return f.answers.shift() ?? "";
+        },
+        env: { HOME: home, ...opts.env },
+        platform: "linux",
+        hostname: "athens",
+        fetch: (async (input, init) => {
+            const url = String(input);
+            const headers = {};
+            for (const [k, v] of Object.entries((init?.headers ?? {})))
+                headers[k.toLowerCase()] = v;
+            let body = init?.body;
+            if (typeof body === "string") {
+                try {
+                    body = JSON.parse(body);
+                }
+                catch {
+                    /* keep text */
+                }
+            }
+            const call = { method: init?.method ?? "GET", url, headers, body, raw: init?.body };
+            f.calls.push(call);
+            for (const r of routes) {
+                const hit = r(call);
+                if (hit)
+                    return new Response(hit.body === undefined ? "" : JSON.stringify(hit.body), { status: hit.status ?? 200, headers: { "content-type": "application/json" } });
+            }
+            return new Response(JSON.stringify({ error: `no route for ${call.method} ${url}`, code: "NO_ROUTE" }), { status: 599 });
+        }),
+        sleep: async (ms) => {
+            clock += ms;
+        },
+        now: () => clock,
+        openUrl: (u) => void f.opened.push(u),
+        liveSpec: false,
+        pollIntervalMs: 1,
+    };
+    return f;
+}
+export const BASE = "https://app.diffusr.ai/api/v2";
+export const KEY = "dfsr_live_testkey";
+export const on = (method, path, body, status = 200) => (c) => c.method === method && c.url.split("?")[0] === BASE + path ? { status, body } : undefined;
+//# sourceMappingURL=test-helpers.js.map

package/dist/cli/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../src/cli/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAwBjC,0FAA0F;AAC1F,MAAM,UAAU,MAAM,CAAC,OAA0E,EAAE;IACjG,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IACzD,IAAI,MAAM,GAAY,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IACxC,IAAI,KAAK,GAAG,iBAAiB,CAAC;IAC9B,MAAM,CAAC,GAAS;QACd,IAAI;QACJ,GAAG,EAAE,EAAE;QACP,GAAG,EAAE,EAAE;QACP,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9B,EAAE,EAAE,SAA0B;KAC/B,CAAC;IACF,CAAC,CAAC,EAAE,GAAG;QACL,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;QAChB,UAAU,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK;QAC7B,WAAW,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK;QAC9B,WAAW,EAAE,KAAK;QAClB,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACf,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;QACD,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;QAChC,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,CAAC,KAAK,EAAE,KAA6B,EAAE,IAAkB,EAAE,EAAE;YAClE,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAA2B,CAAC;gBAAE,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;YACnH,IAAI,IAAI,GAAY,IAAI,EAAE,IAAI,CAAC;YAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,eAAe;gBACjB,CAAC;YACH,CAAC;YACD,MAAM,IAAI,GAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC1F,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;gBACpB,IAAI,GAAG;oBAAE,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;YACvK,CAAC;YACD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,gBAAgB,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1H,CAAC,CAAiB;QAClB,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YAClB,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QACD,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK;QAChB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,QAAQ,EAAE,KAAK;QACf,cAAc,EAAE,CAAC;KAClB,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,+BAA+B,CAAC;AACpD,MAAM,CAAC,MAAM,GAAG,GAAG,mBAAmB,CAAC;AAEvC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAc,EAAE,IAAY,EAAE,IAAa,EAAE,MAAM,GAAG,GAAG,EAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5F,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { runCli } from "./cli/main.js";
+runCli(process.argv.slice(2)).then((code) => {
+    process.exitCode = code;
+}, (e) => {
+    process.stderr.write(`error: ${e instanceof Error ? e.message : String(e)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAChC,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,EACD,CAAC,CAAU,EAAE,EAAE;IACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CACF,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,116 @@
+import type { HeaderBag } from "./verify.js";
+import type { CallbackDelivery, CallbackDeliveryList, CallbackSecret, CallOptions, CreatorVideoBody, RequestOptions, EditImageBody, MakeAnswer, MakeImageBody, MakeMusicBody, MakeVideoBody, ModelList, RecastBody, Result, ResultList, RunTemplateBody, TemplateList, UploadedFile } from "./types.js";
+export declare const DEFAULT_BASE_URL = "https://app.diffusr.ai/api/v2";
+export declare const SDK_VERSION = "0.2.0";
+export interface DiffusrOptions {
+    /** Default `https://app.diffusr.ai/api/v2`. */
+    baseUrl?: string;
+    /** Your own fetch (tests, proxies). Default: the global one (Node 18+). */
+    fetch?: typeof fetch;
+    /** Automatic retries on 429 / 503 / network errors / timeouts (GETs also on 500, 502, 504). Default 3. */
+    maxRetries?: number;
+    /** First retry delay when the API sends no Retry-After; doubles each try. Default 500. */
+    retryBaseMs?: number;
+    /** Per-request timeout in ms (each attempt). Default 60 000. */
+    timeoutMs?: number;
+}
+export interface WaitOptions {
+    /** Give up after this long. Default 15 minutes. */
+    timeoutMs?: number;
+    /** First pause between checks. Default 3000; it grows ×1.5 up to 15 s. */
+    intervalMs?: number;
+    /** Called with every answer while waiting. */
+    onPoll?: (result: Result) => void;
+}
+export declare class Diffusr {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly maxRetries;
+    private readonly retryBaseMs;
+    private readonly timeoutMs;
+    /**
+     * @param apiKey `dfsr_live_…` or `dfsr_test_…` (free). Default: `process.env.DIFFUSR_KEY`,
+     * then the key `diffusr login` saved. The base URL: `opts.baseUrl`, then `DIFFUSR_BASE_URL`,
+     * then the saved file's `base_url` (only when the key came from the file), then the default.
+     */
+    constructor(apiKey?: string, opts?: DiffusrOptions);
+    makeVideo<B extends MakeVideoBody>(body: B, opts?: CallOptions): Promise<MakeAnswer<B>>;
+    makeImage<B extends MakeImageBody>(body: B, opts?: CallOptions): Promise<MakeAnswer<B>>;
+    editImage<B extends EditImageBody>(body: B, opts?: CallOptions): Promise<MakeAnswer<B>>;
+    recast<B extends RecastBody>(body: B, opts?: CallOptions): Promise<MakeAnswer<B>>;
+    makeMusic<B extends MakeMusicBody>(body: B, opts?: CallOptions): Promise<MakeAnswer<B>>;
+    creatorVideo<B extends CreatorVideoBody>(body: B, opts?: CallOptions): Promise<MakeAnswer<B>>;
+    runTemplate<B extends RunTemplateBody>(body: B, opts?: CallOptions): Promise<MakeAnswer<B>>;
+    /** POST /{tool}. One Idempotency-Key per call, reused by every automatic retry. */
+    private make;
+    getResult(id: string, opts?: RequestOptions): Promise<Result>;
+    listResults(q?: {
+        limit?: number;
+    }): Promise<ResultList>;
+    /**
+     * Stop queued work before it generates (that part is never charged). A step
+     * that is already generating may still finish and be charged: check
+     * `result.charge` on the answer. A finished job comes back unchanged.
+     */
+    cancel(id: string): Promise<Result>;
+    /**
+     * Poll until the job is over and return the result. A job that ends FAILED
+     * or CANCELED is returned too: check `result.status`. Throws a
+     * `DiffusrError` with code `WAIT_TIMEOUT` if it is still running at the
+     * deadline (the job itself keeps going).
+     */
+    waitFor(id: string, opts?: WaitOptions): Promise<Result>;
+    /**
+     * Upload a local file and get a `file_url` to pass to a tool. Takes a path
+     * (Node), a Buffer / Uint8Array, or a Blob. Two steps: ask for a signed
+     * URL, PUT the exact bytes to it.
+     */
+    uploadFile(file: string | Uint8Array | Blob, opts?: {
+        contentType?: string;
+    }): Promise<{
+        file_url: string;
+        kind: string;
+    }>;
+    /** Have us copy a public link in (images and short clips; use `uploadFile` for big videos). */
+    uploadFromUrl(sourceUrl: string): Promise<UploadedFile>;
+    listModels(q?: {
+        kind?: "video" | "image";
+    }): Promise<ModelList>;
+    listTemplates(): Promise<TemplateList>;
+    listCallbacks(q?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<CallbackDeliveryList>;
+    /** One more try for a FAILED event (up to 3 by hand). */
+    retryCallback(eventId: string): Promise<CallbackDelivery>;
+    /** Your signing secret (`whsec_…`) for `Diffusr.verifyCallback`. */
+    getCallbackSecret(): Promise<CallbackSecret>;
+    rotateCallbackSecret(): Promise<CallbackSecret>;
+    /**
+     * Check a callback's signature (Standard Webhooks). Pass the raw request
+     * body text, the request headers and your `whsec_…` secret. Rejects a
+     * timestamp more than 5 minutes off; accepts a rotation's two signatures.
+     */
+    static verifyCallback(rawBody: string, headers: HeaderBag, secret: string, opts?: {
+        toleranceSec?: number;
+        nowSec?: number;
+    }): boolean;
+    /**
+     * Call any API path the typed methods do not cover (the CLI uses this).
+     * Same retries, timeouts and errors as every other call. `path` is relative
+     * to the base URL, e.g. `/results/r1`. Add your own `Idempotency-Key` header
+     * for a make call.
+     */
+    call<T = unknown>(method: "GET" | "POST", path: string, opts?: {
+        query?: Record<string, string | number | boolean | undefined>;
+        body?: unknown;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<T>;
+    private request;
+    /** 0.5 s, 1 s, 2 s… with a little jitter. */
+    private backoff;
+    private toError;
+}

package/dist/client.js

@@ -0,0 +1,281 @@
+import { randomUUID } from "node:crypto";
+import { DiffusrError } from "./errors.js";
+import { resolveKey } from "./config.js";
+import { verifyCallback } from "./verify.js";
+import { TERMINAL_STATUSES } from "./types.js";
+export const DEFAULT_BASE_URL = "https://app.diffusr.ai/api/v2";
+export const SDK_VERSION = "0.2.0";
+/** Never wait longer than this on a single automatic retry; throw instead. */
+const MAX_AUTO_RETRY_WAIT_SEC = 30;
+const DEFAULT_TIMEOUT_MS = 60_000;
+const CONTENT_TYPES = {
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    webp: "image/webp",
+    gif: "image/gif",
+    mp4: "video/mp4",
+    mov: "video/quicktime",
+    webm: "video/webm",
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    m4a: "audio/mp4",
+};
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function toQuery(q) {
+    const p = new URLSearchParams();
+    for (const [k, v] of Object.entries(q ?? {}))
+        if (v !== undefined)
+            p.set(k, String(v));
+    const s = p.toString();
+    return s ? `?${s}` : "";
+}
+export class Diffusr {
+    apiKey;
+    baseUrl;
+    fetchImpl;
+    maxRetries;
+    retryBaseMs;
+    timeoutMs;
+    /**
+     * @param apiKey `dfsr_live_…` or `dfsr_test_…` (free). Default: `process.env.DIFFUSR_KEY`,
+     * then the key `diffusr login` saved. The base URL: `opts.baseUrl`, then `DIFFUSR_BASE_URL`,
+     * then the saved file's `base_url` (only when the key came from the file), then the default.
+     */
+    constructor(apiKey, opts = {}) {
+        const found = resolveKey(apiKey || undefined);
+        if (!found) {
+            throw new DiffusrError({ status: 0, code: "MISSING_API_KEY", message: "Pass an API key, set DIFFUSR_KEY, or run `npx diffusr login`." });
+        }
+        const envBase = typeof process !== "undefined" ? process.env.DIFFUSR_BASE_URL : undefined;
+        const fileBase = found.source === "file" ? found.config?.base_url : undefined;
+        this.apiKey = found.key;
+        this.baseUrl = (opts.baseUrl || envBase || fileBase || DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.fetchImpl = opts.fetch ?? ((...a) => fetch(...a));
+        this.maxRetries = opts.maxRetries ?? 3;
+        this.retryBaseMs = opts.retryBaseMs ?? 500;
+        this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    // ——— make calls (paid; `dry_run: true` is free) ———
+    makeVideo(body, opts) {
+        return this.make("make_video", body, opts);
+    }
+    makeImage(body, opts) {
+        return this.make("make_image", body, opts);
+    }
+    editImage(body, opts) {
+        return this.make("edit_image", body, opts);
+    }
+    recast(body, opts) {
+        return this.make("recast", body, opts);
+    }
+    makeMusic(body, opts) {
+        return this.make("make_music", body, opts);
+    }
+    creatorVideo(body, opts) {
+        return this.make("creator_video", body, opts);
+    }
+    runTemplate(body, opts) {
+        return this.make("run_template", body, opts);
+    }
+    /** POST /{tool}. One Idempotency-Key per call, reused by every automatic retry. */
+    async make(tool, body, opts = {}) {
+        const key = opts.idempotencyKey ?? body.idempotency_key ?? randomUUID();
+        const { idempotency_key: _drop, ...rest } = body;
+        void _drop;
+        return this.request("POST", `/${tool}`, { body: rest, headers: { "Idempotency-Key": key }, signal: opts.signal, timeoutMs: opts.timeoutMs });
+    }
+    // ——— results ———
+    getResult(id, opts) {
+        return this.request("GET", `/results/${encodeURIComponent(id)}`, opts);
+    }
+    listResults(q) {
+        return this.request("GET", `/results${toQuery(q)}`);
+    }
+    /**
+     * Stop queued work before it generates (that part is never charged). A step
+     * that is already generating may still finish and be charged: check
+     * `result.charge` on the answer. A finished job comes back unchanged.
+     */
+    cancel(id) {
+        return this.request("POST", `/results/${encodeURIComponent(id)}/cancel`, { body: {} });
+    }
+    /**
+     * Poll until the job is over and return the result. A job that ends FAILED
+     * or CANCELED is returned too: check `result.status`. Throws a
+     * `DiffusrError` with code `WAIT_TIMEOUT` if it is still running at the
+     * deadline (the job itself keeps going).
+     */
+    async waitFor(id, opts = {}) {
+        const deadline = Date.now() + (opts.timeoutMs ?? 15 * 60_000);
+        let interval = opts.intervalMs ?? 3000;
+        for (;;) {
+            const result = await this.getResult(id);
+            opts.onPoll?.(result);
+            if (TERMINAL_STATUSES.includes(result.status))
+                return result;
+            const left = deadline - Date.now();
+            if (left <= 0)
+                break;
+            await sleep(Math.min(interval, left));
+            interval = Math.min(Math.round(interval * 1.5), Math.max(15_000, opts.intervalMs ?? 0));
+            if (Date.now() >= deadline)
+                break;
+        }
+        throw new DiffusrError({
+            status: 0,
+            code: "WAIT_TIMEOUT",
+            message: `Result ${id} was still not finished after ${Math.round((opts.timeoutMs ?? 15 * 60_000) / 1000)} s. It keeps running: call waitFor or getResult again.`,
+        });
+    }
+    // ——— files ———
+    /**
+     * Upload a local file and get a `file_url` to pass to a tool. Takes a path
+     * (Node), a Buffer / Uint8Array, or a Blob. Two steps: ask for a signed
+     * URL, PUT the exact bytes to it.
+     */
+    async uploadFile(file, opts = {}) {
+        let bytes;
+        let contentType = opts.contentType;
+        if (typeof file === "string") {
+            const { readFile } = await import("node:fs/promises");
+            bytes = await readFile(file);
+            contentType ??= CONTENT_TYPES[file.split(".").pop()?.toLowerCase() ?? ""];
+        }
+        else if (typeof Blob !== "undefined" && file instanceof Blob) {
+            bytes = new Uint8Array(await file.arrayBuffer());
+            contentType ??= file.type || undefined;
+        }
+        else {
+            bytes = file;
+        }
+        if (!contentType) {
+            throw new DiffusrError({ status: 0, code: "CONTENT_TYPE_REQUIRED", message: "Pass { contentType } (e.g. \"video/mp4\"): it could not be worked out." });
+        }
+        const ticket = await this.request("POST", "/uploads", { body: { content_type: contentType, size_bytes: bytes.byteLength } });
+        const res = await this.fetchImpl(ticket.upload_url, { method: ticket.method, headers: ticket.headers, body: bytes });
+        if (!res.ok) {
+            throw new DiffusrError({ status: res.status, code: "UPLOAD_FAILED", message: `The upload PUT failed with HTTP ${res.status}.` });
+        }
+        return { file_url: ticket.file_url, kind: ticket.kind };
+    }
+    /** Have us copy a public link in (images and short clips; use `uploadFile` for big videos). */
+    uploadFromUrl(sourceUrl) {
+        return this.request("POST", "/uploads", { body: { source_url: sourceUrl } });
+    }
+    // ——— catalog ———
+    listModels(q) {
+        return this.request("GET", `/models${toQuery(q)}`);
+    }
+    listTemplates() {
+        return this.request("GET", "/templates");
+    }
+    // ——— callbacks ———
+    listCallbacks(q) {
+        return this.request("GET", `/callbacks${toQuery(q)}`);
+    }
+    /** One more try for a FAILED event (up to 3 by hand). */
+    retryCallback(eventId) {
+        return this.request("POST", `/callbacks/${encodeURIComponent(eventId)}/retry`, { body: {} });
+    }
+    /** Your signing secret (`whsec_…`) for `Diffusr.verifyCallback`. */
+    getCallbackSecret() {
+        return this.request("GET", "/callbacks/secret");
+    }
+    rotateCallbackSecret() {
+        return this.request("POST", "/callbacks/secret/rotate", { body: {} });
+    }
+    /**
+     * Check a callback's signature (Standard Webhooks). Pass the raw request
+     * body text, the request headers and your `whsec_…` secret. Rejects a
+     * timestamp more than 5 minutes off; accepts a rotation's two signatures.
+     */
+    static verifyCallback(rawBody, headers, secret, opts) {
+        return verifyCallback(rawBody, headers, secret, opts);
+    }
+    // ——— any operation ———
+    /**
+     * Call any API path the typed methods do not cover (the CLI uses this).
+     * Same retries, timeouts and errors as every other call. `path` is relative
+     * to the base URL, e.g. `/results/r1`. Add your own `Idempotency-Key` header
+     * for a make call.
+     */
+    call(method, path, opts = {}) {
+        return this.request(method, `${path}${toQuery(opts.query)}`, { body: opts.body, headers: opts.headers, signal: opts.signal, timeoutMs: opts.timeoutMs });
+    }
+    // ——— plumbing ———
+    async request(method, path, init = {}) {
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: "application/json",
+            "User-Agent": `diffusr-node/${SDK_VERSION}`,
+            ...init.headers,
+        };
+        if (init.body !== undefined)
+            headers["Content-Type"] = "application/json";
+        const payload = init.body === undefined ? undefined : JSON.stringify(init.body);
+        const timeoutMs = init.timeoutMs ?? this.timeoutMs;
+        for (let attempt = 0;; attempt++) {
+            let res;
+            const timeoutSignal = AbortSignal.timeout(timeoutMs);
+            const signal = init.signal ? AbortSignal.any([init.signal, timeoutSignal]) : timeoutSignal;
+            try {
+                res = await this.fetchImpl(this.baseUrl + path, { method, headers, signal, ...(payload !== undefined ? { body: payload } : {}) });
+            }
+            catch (cause) {
+                // The caller's own abort is theirs: never retry or rewrap it.
+                if (init.signal?.aborted)
+                    throw cause;
+                const timedOut = timeoutSignal.aborted;
+                if (attempt < this.maxRetries) {
+                    await sleep(this.backoff(attempt));
+                    continue;
+                }
+                throw timedOut
+                    ? new DiffusrError({ status: 0, code: "TIMEOUT", message: `diffusr did not answer within ${Math.round(timeoutMs / 1000)} s.` })
+                    : new DiffusrError({ status: 0, code: "NETWORK_ERROR", message: `Could not reach diffusr: ${cause.message}` });
+            }
+            if (res.ok) {
+                const text = await res.text();
+                return (text ? JSON.parse(text) : {});
+            }
+            const err = await this.toError(res);
+            const retryable = res.status === 429 || res.status === 503 || (method === "GET" && (res.status === 500 || res.status === 502 || res.status === 504));
+            const wait = err.retryAfter ?? this.backoff(attempt) / 1000;
+            if (retryable && attempt < this.maxRetries && wait <= MAX_AUTO_RETRY_WAIT_SEC) {
+                await sleep(Math.round(wait * 1000));
+                continue;
+            }
+            throw err;
+        }
+    }
+    /** 0.5 s, 1 s, 2 s… with a little jitter. */
+    backoff(attempt) {
+        return this.retryBaseMs * 2 ** attempt * (1 + Math.random() * 0.2);
+    }
+    async toError(res) {
+        const text = await res.text().catch(() => "");
+        let body;
+        try {
+            const parsed = JSON.parse(text);
+            if (parsed && typeof parsed === "object")
+                body = parsed;
+        }
+        catch {
+            /* not JSON */
+        }
+        const header = Number(res.headers.get("retry-after"));
+        const fromBody = typeof body?.retry_after_seconds === "number" ? body.retry_after_seconds : undefined;
+        const retryAfter = Number.isFinite(header) && res.headers.get("retry-after") !== null ? header : fromBody;
+        const message = typeof body?.error === "string" ? body.error : text.slice(0, 300) || `HTTP ${res.status}`;
+        return new DiffusrError({
+            status: res.status,
+            code: typeof body?.code === "string" ? body.code : `HTTP_${res.status}`,
+            message,
+            requestId: (typeof body?.request_id === "string" ? body.request_id : undefined) ?? res.headers.get("x-request-id") ?? undefined,
+            retryAfter,
+            body,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAuB/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AACnC,8EAA8E;AAC9E,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACnC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAwBlC,MAAM,aAAa,GAA2B;IAC5C,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,iBAAiB;IACtB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;CACjB,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAE1E,SAAS,OAAO,CAAC,CAAoE;IACnF,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAAE,IAAI,CAAC,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,OAAO,OAAO;IACD,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,SAAS,CAAe;IACxB,UAAU,CAAS;IACnB,WAAW,CAAS;IACpB,SAAS,CAAS;IAEnC;;;;OAIG;IACH,YAAY,MAAe,EAAE,OAAuB,EAAE;QACpD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,+DAA+D,EAAE,CAAC,CAAC;QAC3I,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1F,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,IAAI,QAAQ,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC;IACxD,CAAC;IAED,qDAAqD;IAErD,SAAS,CAA0B,IAAO,EAAE,IAAkB;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD,SAAS,CAA0B,IAAO,EAAE,IAAkB;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD,SAAS,CAA0B,IAAO,EAAE,IAAkB;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,CAAuB,IAAO,EAAE,IAAkB;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,SAAS,CAA0B,IAAO,EAAE,IAAkB;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD,YAAY,CAA6B,IAAO,EAAE,IAAkB;QAClE,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,WAAW,CAA4B,IAAO,EAAE,IAAkB;QAChE,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,mFAAmF;IAC3E,KAAK,CAAC,IAAI,CAChB,IAAY,EACZ,IAAO,EACP,OAAoB,EAAE;QAEtB,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,eAAe,IAAI,UAAU,EAAE,CAAC;QACxE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACjD,KAAK,KAAK,CAAC;QACX,OAAO,IAAI,CAAC,OAAO,CAAgB,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9J,CAAC;IAED,kBAAkB;IAElB,SAAS,CAAC,EAAU,EAAE,IAAqB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACzE,CAAC;IAED,WAAW,CAAC,CAAsB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,OAAoB,EAAE;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC;QAC9D,IAAI,QAAQ,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;QACvC,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;YACtB,IAAI,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;YAC7D,MAAM,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnC,IAAI,IAAI,IAAI,CAAC;gBAAE,MAAM;YACrB,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YACtC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;YACxF,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;gBAAE,MAAM;QACpC,CAAC;QACD,MAAM,IAAI,YAAY,CAAC;YACrB,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,UAAU,EAAE,iCAAiC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,wDAAwD;SACjK,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IAEhB;;;;OAIG;IACH,KAAK,CAAC,UAAU,CACd,IAAgC,EAChC,OAAiC,EAAE;QAEnC,IAAI,KAAiB,CAAC;QACtB,IAAI,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACnC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACtD,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC7B,WAAW,KAAK,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;YAC/D,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACjD,WAAW,KAAK,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,IAAkB,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,wEAAwE,EAAE,CAAC,CAAC;QAC1J,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAe,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC3I,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,KAAc,EAAE,CAAC,CAAC;QAC9H,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,mCAAmC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QACnI,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,+FAA+F;IAC/F,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,kBAAkB;IAElB,UAAU,CAAC,CAAgC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED,oBAAoB;IAEpB,aAAa,CAAC,CAAuC;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,yDAAyD;IACzD,aAAa,CAAC,OAAe;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,oEAAoE;IACpE,iBAAiB;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAClD,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,0BAA0B,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,OAAe,EAAE,OAAkB,EAAE,MAAc,EAAE,IAAiD;QAC1H,OAAO,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,wBAAwB;IAExB;;;;;OAKG;IACH,IAAI,CACF,MAAsB,EACtB,IAAY,EACZ,OAAsK,EAAE;QAExK,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9J,CAAC;IAED,mBAAmB;IAEX,KAAK,CAAC,OAAO,CAAI,MAAsB,EAAE,IAAY,EAAE,OAA+H,EAAE;QAC9L,MAAM,OAAO,GAA2B;YACtC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;YACtC,MAAM,EAAE,kBAAkB;YAC1B,YAAY,EAAE,gBAAgB,WAAW,EAAE;YAC3C,GAAG,IAAI,CAAC,OAAO;SAChB,CAAC;QACF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC;QACnD,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;YAClC,IAAI,GAAa,CAAC;YAClB,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC3F,IAAI,CAAC;gBACH,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACpI,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,8DAA8D;gBAC9D,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO;oBAAE,MAAM,KAAK,CAAC;gBACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC;gBACvC,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;oBAC9B,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;oBACnC,SAAS;gBACX,CAAC;gBACD,MAAM,QAAQ;oBACZ,CAAC,CAAC,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,iCAAiC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC/H,CAAC,CAAC,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,4BAA6B,KAAe,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC9H,CAAC;YACD,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;gBACX,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAM,CAAC;YAC7C,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC;YACrJ,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;YAC5D,IAAI,SAAS,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,IAAI,uBAAuB,EAAE,CAAC;gBAC9E,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;gBACrC,SAAS;YACX,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,6CAA6C;IACrC,OAAO,CAAC,OAAe;QAC7B,OAAO,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IACrE,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,GAAa;QACjC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,IAAyC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,IAAI,GAAG,MAAiC,CAAC;QACrF,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,OAAO,IAAI,EAAE,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;QACtG,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1G,MAAM,OAAO,GAAG,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QAC1G,OAAO,IAAI,YAAY,CAAC;YACtB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,MAAM,EAAE;YACvE,OAAO;YACP,SAAS,EAAE,CAAC,OAAO,IAAI,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS;YAC/H,UAAU;YACV,IAAI;SACL,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+/** What `diffusr login` saves. Only `key` matters to the SDK; the rest is for people. */
+export interface SavedConfig {
+    key: string;
+    key_id?: string;
+    key_name?: string;
+    mode?: "live" | "test";
+    email?: string;
+    /** Only written when it is not the default base URL. */
+    base_url?: string;
+    saved_at?: string;
+}
+type Env = Record<string, string | undefined>;
+/** `$XDG_CONFIG_HOME/diffusr/config.json`, else `~/.config/diffusr/config.json`; on Windows `%APPDATA%\diffusr\config.json`. */
+export declare function configPath(env?: Env, platform?: string): string;
+/** Where the CLI caches the API description. */
+export declare function cacheDir(env?: Env, platform?: string): string;
+/** The saved config, or undefined when there is none or it has no key. Never throws. */
+export declare function readConfig(env?: Env, platform?: string): SavedConfig | undefined;
+/** Write the config: folder 0700, file 0600, via a temp file in the same folder and a rename. */
+export declare function writeConfig(cfg: SavedConfig, env?: Env, platform?: string): string;
+/** Delete the config file (only that file). Returns true when there was one. */
+export declare function deleteConfig(env?: Env, platform?: string): boolean;
+export type KeySource = "argument" | "env" | "file";
+/** Key lookup order: the argument, then DIFFUSR_KEY, then the saved file. */
+export declare function resolveKey(arg?: string, env?: Env, platform?: string): {
+    key: string;
+    source: KeySource;
+    config?: SavedConfig;
+} | undefined;
+export {};

package/dist/config.js

@@ -0,0 +1,71 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const processEnv = () => (typeof process !== "undefined" ? process.env : {});
+const processPlatform = () => (typeof process !== "undefined" ? process.platform : "linux");
+/** `$XDG_CONFIG_HOME/diffusr/config.json`, else `~/.config/diffusr/config.json`; on Windows `%APPDATA%\diffusr\config.json`. */
+export function configPath(env = processEnv(), platform = processPlatform()) {
+    if (platform === "win32")
+        return join(env.APPDATA || join(homedir(), "AppData", "Roaming"), "diffusr", "config.json");
+    return join(env.XDG_CONFIG_HOME || join(env.HOME || homedir(), ".config"), "diffusr", "config.json");
+}
+/** Where the CLI caches the API description. */
+export function cacheDir(env = processEnv(), platform = processPlatform()) {
+    if (platform === "win32")
+        return join(env.LOCALAPPDATA || join(homedir(), "AppData", "Local"), "diffusr");
+    return join(env.XDG_CACHE_HOME || join(env.HOME || homedir(), ".cache"), "diffusr");
+}
+/** The saved config, or undefined when there is none or it has no key. Never throws. */
+export function readConfig(env = processEnv(), platform) {
+    try {
+        const parsed = JSON.parse(readFileSync(configPath(env, platform), "utf8"));
+        if (parsed && typeof parsed === "object" && typeof parsed.key === "string" && parsed.key) {
+            return parsed;
+        }
+    }
+    catch {
+        /* missing or unreadable */
+    }
+    return undefined;
+}
+/** Write the config: folder 0700, file 0600, via a temp file in the same folder and a rename. */
+export function writeConfig(cfg, env = processEnv(), platform) {
+    const file = configPath(env, platform);
+    const dir = dirname(file);
+    const existed = existsSync(dir);
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    // Only tighten a folder we made: it may hold other files that are not ours.
+    if (!existed)
+        chmodSync(dir, 0o700);
+    const tmp = join(dir, `.config.${process.pid}.${Date.now()}.tmp`);
+    try {
+        writeFileSync(tmp, JSON.stringify(cfg, null, 2) + "\n", { mode: 0o600 });
+        chmodSync(tmp, 0o600);
+        renameSync(tmp, file);
+    }
+    catch (e) {
+        rmSync(tmp, { force: true });
+        throw e;
+    }
+    return file;
+}
+/** Delete the config file (only that file). Returns true when there was one. */
+export function deleteConfig(env = processEnv(), platform) {
+    const file = configPath(env, platform);
+    if (!existsSync(file))
+        return false;
+    rmSync(file, { force: true });
+    return true;
+}
+/** Key lookup order: the argument, then DIFFUSR_KEY, then the saved file. */
+export function resolveKey(arg, env = processEnv(), platform) {
+    if (arg)
+        return { key: arg, source: "argument" };
+    if (env.DIFFUSR_KEY)
+        return { key: env.DIFFUSR_KEY, source: "env" };
+    const config = readConfig(env, platform);
+    if (config)
+        return { key: config.key, source: "file", config };
+    return undefined;
+}
+//# sourceMappingURL=config.js.map