diffusr 0.1.0 → 0.2.0

package/README.md

@@ -17,7 +17,7 @@ Mint keys on the Developers page in the app.
 ```ts
 import { Diffusr } from "diffusr";
 
-const diffusr = new Diffusr(); // reads DIFFUSR_KEY
+const diffusr = new Diffusr(); // reads DIFFUSR_KEY, else the key `npx diffusr login` saved
 
 // 1. Ask the price. Free: nothing is made, nothing is spent.
 const quote = await diffusr.makeVideo({
@@ -63,6 +63,47 @@ app.post("/diffusr", express.text({ type: "*/*" }), (req, res) => {
 constant-time compare, two signatures after a secret rotation, a 5-minute
 timestamp window, `whsec_` prefix handled.
 
+## Command line
+
+The package also installs a `diffusr` command. No install needed:
+
+```sh
+npx diffusr login                      # shows a code, opens your browser, saves a key
+npx diffusr make_image "a mug on a sunlit table"
+npx diffusr whoami                     # who you are, and your balance
+npx diffusr help                       # every command
+npx diffusr make_video --help          # every flag of one command
+```
+
+Anything that costs credits shows the price first and asks `Make it? [y/N]`.
+It never spends without a yes. A local file works wherever a link is
+expected (`--image-urls ./mug.jpg`): it is uploaded first.
+
+For scripts and agents:
+
+```sh
+diffusr price make_video "a can of sparkling water" --json   # free: just the price
+diffusr make_video "a can of sparkling water" --yes --json   # spend, wait, print the result
+```
+
+- `--json` prints only the JSON answer on stdout. Errors go to stderr.
+- `--yes` allows spending. Without it, and with no terminal, the command
+  exits with code `2` and makes nothing.
+- `--no-wait` starts the job and prints its id. Check it with `diffusr get_result <id>`.
+- `diffusr logout` revokes the saved key and deletes the file.
+
+The commands come from the API's own description, so a new API tool shows up
+by itself.
+
+**Where the key is saved.** `~/.config/diffusr/config.json` (or
+`$XDG_CONFIG_HOME/diffusr/config.json`; on Windows `%APPDATA%\diffusr\config.json`).
+Only you can read it (mode 0600). The `Diffusr` class and the Python package
+read the same file.
+
+**Which key wins.** The `--key` flag or the constructor argument, then the
+`DIFFUSR_KEY` variable, then the saved file. The API address: `--base-url` or
+the `baseUrl` option, then `DIFFUSR_BASE_URL`, then the saved file.
+
 ## Methods
 
 | Method | REST |

package/dist/cli/account.d.ts

@@ -0,0 +1,19 @@
+import { Diffusr } from "../client.js";
+import type { SavedConfig } from "../config.js";
+import type { FlagDef, ParsedArgs } from "./args.js";
+import type { Io } from "./io.js";
+export declare const LOGIN_FLAGS: Map<string, FlagDef>;
+export declare const LOGOUT_FLAGS: Map<string, FlagDef>;
+export declare const WHOAMI_FLAGS: Map<string, FlagDef>;
+export interface Auth {
+    key: string | undefined;
+    source: "argument" | "env" | "file" | undefined;
+    config: SavedConfig | undefined;
+    baseUrl: string;
+}
+/** The key (argument, DIFFUSR_KEY, saved file) and the base URL that goes with it. */
+export declare function resolveAuth(io: Io, args: ParsedArgs): Auth;
+export declare function makeClient(io: Io, auth: Auth): Diffusr;
+export declare function login(io: Io, args: ParsedArgs): Promise<number>;
+export declare function whoami(io: Io, args: ParsedArgs): Promise<number>;
+export declare function logout(io: Io, args: ParsedArgs): Promise<number>;

package/dist/cli/account.js

@@ -0,0 +1,250 @@
+import { DEFAULT_BASE_URL, Diffusr } from "../client.js";
+import { configPath, deleteConfig, readConfig, resolveKey, writeConfig } from "../config.js";
+import { DiffusrError } from "../errors.js";
+import { flagBool, flagStr } from "./args.js";
+import { credits, formatMe } from "./format.js";
+import { CliError, shouldOpenBrowser } from "./io.js";
+export const LOGIN_FLAGS = new Map([
+    ["test", true],
+    ["name", false],
+    ["force", true],
+    ["json", true],
+    ["help", true],
+    ["version", true],
+    ["yes", true],
+    ["base_url", false],
+    ["key", false],
+].map(([name, boolean]) => [name, { name: name, boolean: boolean }]));
+export const LOGOUT_FLAGS = new Map([
+    ["revoke_env_key", true],
+    ["json", true],
+    ["help", true],
+    ["version", true],
+    ["yes", true],
+    ["base_url", false],
+    ["key", false],
+].map(([name, boolean]) => [name, { name: name, boolean: boolean }]));
+export const WHOAMI_FLAGS = LOGOUT_FLAGS;
+const MISSING_KEY = "Pass an API key, set DIFFUSR_KEY, or run `npx diffusr login`.";
+const trim = (u) => u.replace(/\/+$/, "");
+/** The key (argument, DIFFUSR_KEY, saved file) and the base URL that goes with it. */
+export function resolveAuth(io, args) {
+    const found = resolveKey(flagStr(args, "key"), io.env, io.platform);
+    const fileBase = found?.source === "file" ? found.config?.base_url : undefined;
+    const baseUrl = trim(flagStr(args, "base_url") || io.env.DIFFUSR_BASE_URL || fileBase || DEFAULT_BASE_URL);
+    return { key: found?.key, source: found?.source, config: found?.config, baseUrl };
+}
+export function makeClient(io, auth) {
+    if (!auth.key)
+        throw new DiffusrError({ status: 0, code: "MISSING_API_KEY", message: MISSING_KEY });
+    return new Diffusr(auth.key, { baseUrl: auth.baseUrl, fetch: io.fetch });
+}
+function describeSource(io, auth) {
+    if (auth.source === "argument")
+        return "the --key flag";
+    if (auth.source === "env")
+        return "DIFFUSR_KEY";
+    return `the saved file ${configPath(io.env, io.platform)}`;
+}
+// ——— plain JSON calls with no key (login) ———
+async function postJson(io, url, body) {
+    let res;
+    try {
+        res = await io.fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", Accept: "application/json", "User-Agent": "diffusr-cli" },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(20_000),
+        });
+    }
+    catch (cause) {
+        throw new DiffusrError({ status: 0, code: "NETWORK_ERROR", message: `Could not reach diffusr: ${cause.message}` });
+    }
+    const text = await res.text().catch(() => "");
+    let parsed = {};
+    try {
+        const p = JSON.parse(text);
+        if (p && typeof p === "object")
+            parsed = p;
+    }
+    catch {
+        /* not JSON */
+    }
+    if (!text || Object.keys(parsed).length === 0)
+        parsed = { error: text.slice(0, 300) || `HTTP ${res.status}` };
+    return { status: res.status, body: parsed };
+}
+function toDiffusrError(status, body) {
+    return new DiffusrError({
+        status,
+        code: typeof body.code === "string" ? body.code : `HTTP_${status}`,
+        message: typeof body.error === "string" ? body.error : `HTTP ${status}`,
+        requestId: typeof body.request_id === "string" ? body.request_id : undefined,
+        retryAfter: typeof body.retry_after_seconds === "number" ? body.retry_after_seconds : undefined,
+        body,
+    });
+}
+// ——— login ———
+function limitWords(a) {
+    if (typeof a.monthly_limit_credits === "number")
+        return `limit ${credits(a.monthly_limit_credits)} a month`;
+    if (typeof a.daily_limit_credits === "number")
+        return `limit ${credits(a.daily_limit_credits)} a day`;
+    return "no limit";
+}
+export async function login(io, args) {
+    const json = flagBool(args, "json");
+    const say = (l) => (json ? io.err(l) : io.out(l));
+    const existing = readConfig(io.env, io.platform);
+    if (existing && !flagBool(args, "force")) {
+        io.err(`Already signed in as ${existing.email ?? "this account"}${existing.key_name ? ` (${existing.mode ?? "live"} key "${existing.key_name}")` : ""}. Run diffusr logout first, or diffusr login --force.`);
+        return 1;
+    }
+    const base = trim(flagStr(args, "base_url") || io.env.DIFFUSR_BASE_URL || DEFAULT_BASE_URL);
+    const mode = flagBool(args, "test") ? "test" : "live";
+    const started = await postJson(io, `${base}/cli/logins`, { device_name: flagStr(args, "name") || io.hostname, mode });
+    if (started.status < 200 || started.status >= 300)
+        throw toDiffusrError(started.status, started.body);
+    const s = started.body;
+    const loginId = String(s.login_id ?? "");
+    const pollToken = String(s.poll_token ?? "");
+    const code = String(s.code ?? "");
+    const verifyUrl = String(s.verify_url ?? "");
+    if (!loginId || !pollToken)
+        throw new CliError("diffusr sent back an answer this version does not understand. Update with: npm i -g diffusr");
+    say(`Your code:  ${code.replace(/^(\d{3})(\d+)$/, "$1 $2")}`);
+    say(`Open ${verifyUrl}`);
+    say("and press Yes, connect.");
+    say("");
+    say("Waiting…");
+    if (shouldOpenBrowser(io.env, io.platform) && verifyUrl)
+        io.openUrl(verifyUrl);
+    const expiresAt = io.now() + (typeof s.expires_in === "number" ? s.expires_in : 600) * 1000;
+    const intervalMs = Math.max(1, typeof s.interval === "number" ? s.interval : 3) * 1000;
+    while (io.now() < expiresAt) {
+        await io.sleep(intervalMs);
+        const r = await postJson(io, `${base}/cli/logins/${encodeURIComponent(loginId)}/token`, { poll_token: pollToken });
+        if (r.status === 429) {
+            const wait = typeof r.body.retry_after_seconds === "number" ? r.body.retry_after_seconds * 1000 : intervalMs;
+            await io.sleep(wait);
+            continue;
+        }
+        if (r.status === 404)
+            throw new CliError("This login was not found. Run diffusr login again.");
+        if (r.status >= 500)
+            continue;
+        if (r.status >= 400)
+            throw toDiffusrError(r.status, r.body);
+        const a = r.body;
+        switch (a.status) {
+            case "approved": {
+                const cfg = {
+                    key: String(a.key),
+                    key_id: String(a.key_id ?? ""),
+                    key_name: String(a.key_name ?? ""),
+                    mode: a.mode === "test" ? "test" : "live",
+                    email: String(a.email ?? ""),
+                    ...(base !== DEFAULT_BASE_URL ? { base_url: base } : {}),
+                    saved_at: new Date(io.now()).toISOString(),
+                };
+                const file = writeConfig(cfg, io.env, io.platform);
+                // --force replaced a saved key: revoke it so no live key is left behind.
+                if (existing && existing.key !== cfg.key)
+                    await revokeQuietly(io, existing);
+                if (json) {
+                    io.out(JSON.stringify({ connected: true, email: cfg.email, key_id: cfg.key_id, key_name: cfg.key_name, mode: cfg.mode, config_path: file }, null, 2));
+                }
+                else {
+                    io.out(`✓ Connected as ${cfg.email} (${cfg.mode} key "${cfg.key_name}", ${limitWords(a)})`);
+                    io.out("");
+                    io.out('Try: diffusr make_image "a mug on a sunlit table"');
+                }
+                if (io.env.DIFFUSR_KEY)
+                    io.err("Note: DIFFUSR_KEY is set in this shell, and it wins over the saved key.");
+                return 0;
+            }
+            case "denied":
+                throw new CliError("Cancelled in the browser.");
+            case "expired":
+                throw new CliError("The code expired. Run diffusr login again.");
+            case "failed":
+                throw new CliError(typeof a.error === "string" ? a.error : "The login failed. Run diffusr login again.");
+            default:
+                break; // pending
+        }
+    }
+    throw new CliError("The code expired. Run diffusr login again.");
+}
+/** Best effort: revoke a key we no longer keep. A failure only warns. */
+async function revokeQuietly(io, old) {
+    try {
+        await new Diffusr(old.key, { baseUrl: trim(old.base_url || DEFAULT_BASE_URL), fetch: io.fetch, maxRetries: 1 }).call("POST", "/cli/logout", { body: {} });
+    }
+    catch (e) {
+        if (e instanceof DiffusrError && e.status === 401)
+            return; // already gone
+        io.err(`Note: the old key "${old.key_name ?? "CLI"}" could not be revoked. Revoke it on the Developers page.`);
+    }
+}
+// ——— whoami ———
+export async function whoami(io, args) {
+    const auth = resolveAuth(io, args);
+    const client = makeClient(io, auth);
+    const me = await client.call("GET", "/me");
+    if (flagBool(args, "json")) {
+        io.out(JSON.stringify(me, null, 2));
+        return 0;
+    }
+    for (const l of formatMe(me))
+        io.out(l);
+    io.out(`Key from ${describeSource(io, auth)}`);
+    return 0;
+}
+// ——— logout ———
+export async function logout(io, args) {
+    const json = flagBool(args, "json");
+    const auth = resolveAuth(io, args);
+    const saved = readConfig(io.env, io.platform);
+    const revokeEnv = flagBool(args, "revoke_env_key");
+    const envSet = Boolean(io.env.DIFFUSR_KEY);
+    let key;
+    let name;
+    let base = auth.baseUrl;
+    if (saved) {
+        key = saved.key;
+        name = saved.key_name;
+        base = trim(flagStr(args, "base_url") || io.env.DIFFUSR_BASE_URL || saved.base_url || DEFAULT_BASE_URL);
+    }
+    else if (revokeEnv && auth.key) {
+        key = auth.key;
+    }
+    if (!key) {
+        const msg = auth.key ? `Nothing saved to sign out of. The key from ${describeSource(io, auth)} was left alone (add --revoke-env-key to revoke it).` : "You are not signed in. Nothing is saved.";
+        if (json)
+            io.out(JSON.stringify({ revoked: false, message: msg }));
+        else
+            io.out(msg);
+        return 0;
+    }
+    try {
+        await new Diffusr(key, { baseUrl: base, fetch: io.fetch }).call("POST", "/cli/logout", { body: {} });
+    }
+    catch (e) {
+        // A 401 means the key is already gone: that is what we wanted.
+        if (!(e instanceof DiffusrError && e.status === 401))
+            throw e;
+    }
+    if (saved)
+        deleteConfig(io.env, io.platform);
+    const label = name ? `The key "${name}"` : "The key";
+    if (json)
+        io.out(JSON.stringify({ revoked: true, key_name: name ?? null }));
+    else
+        io.out(`Signed out. ${label} is revoked.`);
+    if (envSet && io.env.DIFFUSR_KEY !== key)
+        io.err("Note: DIFFUSR_KEY is still set in this shell.");
+    else if (envSet)
+        io.err("Note: DIFFUSR_KEY is still set in this shell, but that key no longer works.");
+    return 0;
+}
+//# sourceMappingURL=account.js.map

package/dist/cli/account.js.map

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

package/dist/cli/args.d.ts

@@ -0,0 +1,28 @@
+import type { Json } from "./spec.js";
+export declare function schemaType(s: Json): string | undefined;
+export declare const flagName: (prop: string) => string;
+/** "string", "integer", "a|b", "string[]", "json". */
+export declare function describeType(s: Json): string;
+export declare function readAt(path: string, flag: string): string;
+/**
+ * Turn the raw values of one flag into the JSON value its schema wants.
+ * `raws` has one entry per time the flag was given.
+ */
+export declare function coerceFlag(s: Json, raws: string[], flag: string): unknown;
+export interface FlagDef {
+    /** Property name, snake_case. */
+    name: string;
+    boolean: boolean;
+}
+export interface ParsedArgs {
+    positionals: string[];
+    /** Flag (snake_case) -> every value given. Booleans hold "true"/"false". */
+    flags: Map<string, string[]>;
+}
+/**
+ * Split argv into positionals and flags. `known` says which flags exist and
+ * whether they take a value; anything else is an error.
+ */
+export declare function parseArgs(argv: string[], known: Map<string, FlagDef>, helpHint: string): ParsedArgs;
+export declare function flagBool(p: ParsedArgs, name: string): boolean;
+export declare function flagStr(p: ParsedArgs, name: string): string | undefined;

package/dist/cli/args.js

@@ -0,0 +1,204 @@
+import { readFileSync } from "node:fs";
+import { CliError } from "./io.js";
+export function schemaType(s) {
+    if (typeof s.type === "string")
+        return s.type;
+    if (Array.isArray(s.type))
+        return s.type.find((t) => t !== "null");
+    for (const k of ["anyOf", "oneOf"]) {
+        const list = s[k];
+        if (Array.isArray(list)) {
+            for (const sub of list) {
+                const t = schemaType(sub);
+                if (t && t !== "null")
+                    return t;
+            }
+        }
+    }
+    if (Array.isArray(s.enum))
+        return "string";
+    if ("const" in s)
+        return typeof s.const;
+    return undefined;
+}
+export const flagName = (prop) => "--" + prop.replace(/_/g, "-");
+/** "string", "integer", "a|b", "string[]", "json". */
+export function describeType(s) {
+    if (Array.isArray(s.enum))
+        return s.enum.join("|");
+    const t = schemaType(s);
+    if (t === "array") {
+        const items = (s.items ?? {});
+        return schemaType(items) === "object" ? "json[]" : `${describeType(items)}[]`;
+    }
+    if (t === "object")
+        return "json";
+    return t ?? "value";
+}
+function fromJsonArg(raw, flag) {
+    const text = raw.startsWith("@") ? readAt(raw.slice(1), flag) : raw;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new CliError(`${flag} needs JSON${raw.startsWith("@") ? ` (the file ${raw.slice(1)} is not valid JSON)` : ""}.`);
+    }
+}
+export function readAt(path, flag) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        throw new CliError(`${flag}: cannot read the file ${path}.`);
+    }
+}
+function scalar(s, raw, flag) {
+    const t = schemaType(s);
+    let v = raw;
+    if (t === "integer") {
+        if (!/^-?\d+$/.test(raw.trim()))
+            throw new CliError(`${flag} needs a whole number, not "${raw}".`);
+        v = Number(raw);
+    }
+    else if (t === "number") {
+        if (raw.trim() === "" || !Number.isFinite(Number(raw)))
+            throw new CliError(`${flag} needs a number, not "${raw}".`);
+        v = Number(raw);
+    }
+    else if (t === "boolean") {
+        if (/^(true|yes|1)$/i.test(raw))
+            v = true;
+        else if (/^(false|no|0)$/i.test(raw))
+            v = false;
+        else
+            throw new CliError(`${flag} needs true or false, not "${raw}".`);
+    }
+    if (Array.isArray(s.enum) && !s.enum.includes(v)) {
+        throw new CliError(`${flag} must be one of: ${s.enum.join(", ")} (not "${raw}").`);
+    }
+    return v;
+}
+/**
+ * Turn the raw values of one flag into the JSON value its schema wants.
+ * `raws` has one entry per time the flag was given.
+ */
+export function coerceFlag(s, raws, flag) {
+    const t = schemaType(s);
+    if (t === "array") {
+        const items = (s.items ?? {});
+        const out = [];
+        for (const raw of raws) {
+            const trimmed = raw.trim();
+            if (trimmed.startsWith("[") || trimmed.startsWith("@")) {
+                const v = fromJsonArg(trimmed, flag);
+                if (!Array.isArray(v))
+                    throw new CliError(`${flag} needs a JSON list.`);
+                out.push(...v);
+            }
+            else if (schemaType(items) === "object") {
+                out.push(fromJsonArg(trimmed, flag));
+            }
+            else {
+                for (const part of trimmed.split(","))
+                    if (part.trim() !== "")
+                        out.push(scalar(items, part.trim(), flag));
+            }
+        }
+        return out;
+    }
+    const raw = raws[raws.length - 1] ?? "";
+    if (t === "object") {
+        const trimmed = raw.trim();
+        if (trimmed.startsWith("{") || trimmed.startsWith("@"))
+            return fromJsonArg(trimmed, flag);
+        // name=value pairs for a map of strings, e.g. --pictures him=./a.jpg
+        const obj = {};
+        for (const r of raws) {
+            const i = r.indexOf("=");
+            if (i <= 0)
+                throw new CliError(`${flag} needs JSON, or name=value pairs.`);
+            obj[r.slice(0, i)] = r.slice(i + 1);
+        }
+        return obj;
+    }
+    if (t === undefined) {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return raw;
+        }
+    }
+    return scalar(s, raw, flag);
+}
+const SHORT = { y: "yes", h: "help", v: "version" };
+/**
+ * Split argv into positionals and flags. `known` says which flags exist and
+ * whether they take a value; anything else is an error.
+ */
+export function parseArgs(argv, known, helpHint) {
+    const positionals = [];
+    const flags = new Map();
+    const add = (k, v) => flags.set(k, [...(flags.get(k) ?? []), v]);
+    for (let i = 0; i < argv.length; i++) {
+        const tok = argv[i];
+        if (tok === "--") {
+            positionals.push(...argv.slice(i + 1));
+            break;
+        }
+        let name;
+        let inline;
+        if (tok.startsWith("--")) {
+            const eq = tok.indexOf("=");
+            name = (eq === -1 ? tok.slice(2) : tok.slice(2, eq)).replace(/-/g, "_");
+            if (eq !== -1)
+                inline = tok.slice(eq + 1);
+        }
+        else if (/^-[a-z]$/i.test(tok) && SHORT[tok[1].toLowerCase()]) {
+            name = SHORT[tok[1].toLowerCase()];
+        }
+        else {
+            positionals.push(tok);
+            continue;
+        }
+        let def = known.get(name);
+        let negated = false;
+        if (!def && name.startsWith("no_")) {
+            const base = known.get(name.slice(3));
+            if (base?.boolean) {
+                def = base;
+                negated = true;
+            }
+        }
+        if (!def)
+            throw new CliError(`Unknown flag --${name.replace(/_/g, "-")}. ${helpHint}`);
+        if (def.boolean) {
+            let v = negated ? "false" : "true";
+            if (inline !== undefined)
+                v = inline;
+            else if (!negated && argv[i + 1] !== undefined && /^(true|false)$/i.test(argv[i + 1]))
+                v = argv[++i];
+            add(def.name, v);
+        }
+        else if (inline !== undefined) {
+            add(def.name, inline);
+        }
+        else {
+            const next = argv[i + 1];
+            if (next === undefined)
+                throw new CliError(`${flagName(def.name)} needs a value.`);
+            add(def.name, next);
+            i++;
+        }
+    }
+    return { positionals, flags };
+}
+export function flagBool(p, name) {
+    const v = p.flags.get(name);
+    return v !== undefined && /^(true|1|yes)$/i.test(v[v.length - 1]);
+}
+export function flagStr(p, name) {
+    const v = p.flags.get(name);
+    return v?.[v.length - 1];
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

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

package/dist/cli/format.d.ts

@@ -0,0 +1,10 @@
+/** "✦ 1,240.00": always two decimals, like the app. */
+export declare function credits(n: number | string): string;
+export declare function errorLine(e: unknown): string;
+export declare function wrap(text: string, width: number, indent: string): string;
+/** Quote in credits from a make or dry-run answer. */
+export declare function priceCredits(answer: unknown): number | undefined;
+export declare function outputUrls(result: unknown): string[];
+export declare function chargedCredits(result: unknown): number | undefined;
+export declare function formatMe(me: unknown): string[];
+export declare function formatResult(r: unknown): string[];