@tscomfy/cli 0.0.0-stage → 0.1.0

package/dist/io.js

@@ -0,0 +1,80 @@
+import { mkdir, readFile, realpath, rename, rm, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { errorBodyMessage, redactUrl } from "./util.js";
+/** A failure to report to the user: a message, and the exit code to end with. */
+export class CliError extends Error {
+    /** 1 for a failure, 2 for a usage error. */
+    exitCode;
+    /** A failure with `message`, ending the process with `exitCode`. */
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = "CliError";
+        this.exitCode = exitCode;
+    }
+}
+const FETCH_TIMEOUT_MS = 60_000;
+/** The real world: the process's streams, `fetch` and `node:fs`, which Node and Bun both have. */
+export function systemIo() {
+    return {
+        out: (text) => {
+            process.stdout.write(text);
+        },
+        err: (text) => {
+            process.stderr.write(text);
+        },
+        fetchText: async (url) => {
+            const shown = redactUrl(new URL(url));
+            try {
+                const response = await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+                if (!response.ok) {
+                    const answer = `${String(response.status)} ${response.statusText}`.trimEnd();
+                    // Best effort: the status says what went wrong; the body may say why.
+                    const body = await response.text().catch(() => "");
+                    const detail = errorBodyMessage(body);
+                    throw new CliError(`${shown} answered ${answer}${detail === undefined ? "" : `: ${detail}`}`);
+                }
+                return await response.text();
+            }
+            catch (error) {
+                if (error instanceof CliError)
+                    throw error;
+                throw new CliError(`Could not reach ${shown}: ${reason(error)}`);
+            }
+        },
+        readText: async (path) => {
+            try {
+                // TextDecoder drops a byte order mark, as editors that save one expect.
+                return new TextDecoder().decode(await readFile(path));
+            }
+            catch (error) {
+                if (codeOf(error) === "ENOENT")
+                    return undefined;
+                throw new CliError(`Could not read ${path}: ${reason(error)}`);
+            }
+        },
+        writeText: async (path, text) => {
+            // Through a temporary file, so an interrupted run never leaves a file half written. One
+            // name per file, so a run that was killed leaves nothing a later run doesn't replace; and
+            // a symlink is followed, so the file it points to is the one replaced.
+            const target = await realpath(path).catch(() => path);
+            const temporary = `${target}.tmp`;
+            try {
+                await mkdir(dirname(target), { recursive: true });
+                await writeFile(temporary, text);
+                await rename(temporary, target);
+            }
+            catch (error) {
+                // Best effort: when the directory can't be made, there is nothing to remove.
+                await rm(temporary, { force: true }).catch(() => undefined);
+                throw new CliError(`Could not write ${path}: ${reason(error)}`);
+            }
+        },
+    };
+}
+function reason(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function codeOf(error) {
+    return typeof error === "object" && error !== null ? Reflect.get(error, "code") : undefined;
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAmBxD,iFAAiF;AACjF,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,4CAA4C;IACnC,QAAQ,CAAS;IAE1B,oEAAoE;IACpE,YAAY,OAAe,EAAE,QAAQ,GAAG,CAAC;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,kGAAkG;AAClG,MAAM,UAAU,QAAQ;IACtB,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;gBACrF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,CAAC;oBAC7E,sEAAsE;oBACtE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;oBACnD,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;oBACtC,MAAM,IAAI,QAAQ,CAChB,GAAG,KAAK,aAAa,MAAM,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,EAAE,CAC1E,CAAC;gBACJ,CAAC;gBACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,QAAQ;oBAAE,MAAM,KAAK,CAAC;gBAC3C,MAAM,IAAI,QAAQ,CAAC,mBAAmB,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACvB,IAAI,CAAC;gBACH,wEAAwE;gBACxE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACxD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ;oBAAE,OAAO,SAAS,CAAC;gBACjD,MAAM,IAAI,QAAQ,CAAC,kBAAkB,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QACD,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC9B,wFAAwF;YACxF,0FAA0F;YAC1F,uEAAuE;YACvE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,SAAS,GAAG,GAAG,MAAM,MAAM,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClD,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBACjC,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,6EAA6E;gBAC7E,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC5D,MAAM,IAAI,QAAQ,CAAC,mBAAmB,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9F,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

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

package/dist/main.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// The `tscomfy` executable.
+import { systemIo } from "./io.js";
+import { run } from "./run.js";
+process.exitCode = await run(process.argv.slice(2), systemIo());
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,4BAA4B;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,47 @@
+import type { Schema } from "@tscomfy/core";
+import { type Io } from "./io.ts";
+/** The record `generate` writes last, next to the files, for `check` and `transpile`. */
+export declare const MANIFEST = "tscomfy.json";
+/** The raw snapshot written next to the generated files, for `--from` and `check`. */
+export declare const SNAPSHOT = "object_info.json";
+/**
+ * What one `generate` run wrote: the codegen version, the schema hash, the options needed to
+ * regenerate, and a content hash of every file, so `check` notices an edited, missing or
+ * half-written file and output from another version.
+ */
+export interface Manifest {
+    readonly codegen: string;
+    /** `hashSchema` of the snapshot (D15). */
+    readonly schema: string;
+    readonly exportName: string;
+    readonly importExtension: ".js" | ".ts";
+    /**
+     * The ComfyUI version of the snapshot, when known: the server's with `--url`, the
+     * `--comfy-version` given with `--from`. For regenerating from the snapshot, and for the
+     * command `check` suggests with `--from`.
+     */
+    readonly comfyVersion?: string;
+    /** `sha256:<hex>` of each file, by its name in the output directory: exactly {@link FILES}. */
+    readonly files: {
+        readonly [file: string]: string;
+    };
+}
+/** The files a manifest covers, in the order `check` reports them. */
+export declare const FILES: readonly string[];
+/** `sha256:<hex>` of a text's UTF-8 bytes. */
+export declare function contentHash(text: string): string;
+/** The manifest's file contents: stable key order, one trailing newline. */
+export declare function formatManifest(manifest: Manifest): string;
+/** The manifest in `out`, or `undefined` when there is none. Throws for one that isn't ours. */
+export declare function readManifest(io: Io, out: string): Promise<Manifest | undefined>;
+/** A directory `tscomfy generate` wrote: its manifest, and the snapshot normalized. */
+export interface Generated {
+    readonly manifest: Manifest;
+    readonly snapshotPath: string;
+    /** The snapshot's text, exactly as written. */
+    readonly snapshotText: string;
+    readonly schema: Schema;
+}
+/** The manifest and snapshot in `dir`; fails when either is missing, or isn't ours. */
+export declare function readGenerated(io: Io, dir: string): Promise<Generated>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAY,KAAK,EAAE,EAAE,MAAM,SAAS,CAAC;AAG5C,yFAAyF;AACzF,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AAEvC,sFAAsF;AACtF,eAAO,MAAM,QAAQ,qBAAqB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,KAAK,GAAG,KAAK,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACrD;AAED,sEAAsE;AACtE,eAAO,MAAM,KAAK,EAAE,SAAS,MAAM,EAAuC,CAAC;AAE3E,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEzD;AAED,gGAAgG;AAChG,wBAAsB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAcrF;AAsBD,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,uFAAuF;AACvF,wBAAsB,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAW3E"}

package/dist/manifest.js

@@ -0,0 +1,66 @@
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { CliError } from "./io.js";
+import { loadSchema } from "./source.js";
+/** The record `generate` writes last, next to the files, for `check` and `transpile`. */
+export const MANIFEST = "tscomfy.json";
+/** The raw snapshot written next to the generated files, for `--from` and `check`. */
+export const SNAPSHOT = "object_info.json";
+/** The files a manifest covers, in the order `check` reports them. */
+export const FILES = ["nodes.ts", "index.ts", SNAPSHOT];
+/** `sha256:<hex>` of a text's UTF-8 bytes. */
+export function contentHash(text) {
+    return `sha256:${createHash("sha256").update(text, "utf8").digest("hex")}`;
+}
+/** The manifest's file contents: stable key order, one trailing newline. */
+export function formatManifest(manifest) {
+    return `${JSON.stringify(manifest, null, 2)}\n`;
+}
+/** The manifest in `out`, or `undefined` when there is none. Throws for one that isn't ours. */
+export async function readManifest(io, out) {
+    const path = join(out, MANIFEST);
+    const text = await io.readText(path);
+    if (text === undefined)
+        return undefined;
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        throw new CliError(`${path} is not JSON; run tscomfy generate again.`);
+    }
+    if (!isManifest(value)) {
+        throw new CliError(`${path} is not a tscomfy manifest; run tscomfy generate again.`);
+    }
+    return value;
+}
+function isManifest(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const field = (name) => Reflect.get(value, name);
+    const files = field("files");
+    const extension = field("importExtension");
+    const comfyVersion = field("comfyVersion");
+    return (typeof field("codegen") === "string" &&
+        typeof field("schema") === "string" &&
+        typeof field("exportName") === "string" &&
+        (extension === ".js" || extension === ".ts") &&
+        (comfyVersion === undefined || typeof comfyVersion === "string") &&
+        typeof files === "object" &&
+        files !== null &&
+        // Exactly our files: a hand-edited list must not hide one, or name a path outside `out`.
+        Object.keys(files).toSorted().join("\n") === FILES.toSorted().join("\n") &&
+        Object.values(files).every((hash) => typeof hash === "string"));
+}
+/** The manifest and snapshot in `dir`; fails when either is missing, or isn't ours. */
+export async function readGenerated(io, dir) {
+    const manifest = await readManifest(io, dir);
+    const snapshotPath = join(dir, SNAPSHOT);
+    const snapshotText = await io.readText(snapshotPath);
+    if (manifest === undefined || snapshotText === undefined) {
+        throw new CliError(`There is no ${manifest === undefined ? MANIFEST : SNAPSHOT} in ${dir}; run tscomfy generate first.`);
+    }
+    const { schema } = loadSchema({ text: snapshotText, label: snapshotPath, flag: "" });
+    return { manifest, snapshotPath, snapshotText, schema };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/report.d.ts

@@ -0,0 +1,13 @@
+import { type Diagnostic, type Schema } from "@tscomfy/core";
+/**
+ * Diagnostics grouped by node pack (`python_module`; docs/plan.md §9), errors and warnings
+ * counted, at most a few lines per pack unless `verbose`.
+ */
+export declare function reportDiagnostics(diagnostics: readonly Diagnostic[], schema: Schema, objectInfo: string, verbose: boolean): string;
+/** One line for a diagnostic: its code, where, and what. */
+export declare function formatDiagnostic(diagnostic: Diagnostic): string;
+/** `1 warning`, `3 errors`. */
+export declare function count(amount: number, noun: string): string;
+/** A byte size for humans. */
+export declare function size(bytes: number): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAS,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAMpE;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,MAAM,CAuBR;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE/D;AAED,+BAA+B;AAC/B,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,8BAA8B;AAC9B,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1C"}

package/dist/report.js

@@ -0,0 +1,69 @@
+import { parse } from "@tscomfy/core";
+import { isRecord } from "./util.js";
+/** How many diagnostics a pack shows before the rest are summarized, unless verbose. */
+const SHOWN_PER_PACK = 5;
+/**
+ * Diagnostics grouped by node pack (`python_module`; docs/plan.md §9), errors and warnings
+ * counted, at most a few lines per pack unless `verbose`.
+ */
+export function reportDiagnostics(diagnostics, schema, objectInfo, verbose) {
+    if (diagnostics.length === 0)
+        return "";
+    const packs = packsOf(schema, objectInfo);
+    const groups = new Map();
+    for (const diagnostic of diagnostics) {
+        const classType = String(diagnostic.path[0] ?? "");
+        const pack = packs.get(classType) ?? "(no pack)";
+        groups.set(pack, [...(groups.get(pack) ?? []), diagnostic]);
+    }
+    const errors = diagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
+    const lines = [
+        `${count(errors, "error")} and ${count(diagnostics.length - errors, "warning")} in the node definitions:`,
+    ];
+    for (const pack of [...groups.keys()].toSorted()) {
+        const group = groups.get(pack) ?? [];
+        lines.push(`  ${pack}: ${String(group.length)}`);
+        const shown = verbose ? group : group.slice(0, SHOWN_PER_PACK);
+        for (const diagnostic of shown)
+            lines.push(`    ${formatDiagnostic(diagnostic)}`);
+        if (shown.length < group.length) {
+            lines.push(`    … and ${String(group.length - shown.length)} more (--verbose shows all)`);
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
+/** One line for a diagnostic: its code, where, and what. */
+export function formatDiagnostic(diagnostic) {
+    return `${diagnostic.code} ${diagnostic.path.join(" › ")}: ${diagnostic.message}`;
+}
+/** `1 warning`, `3 errors`. */
+export function count(amount, noun) {
+    return `${String(amount)} ${noun}${amount === 1 ? "" : "s"}`;
+}
+/** A byte size for humans. */
+export function size(bytes) {
+    if (bytes < 1024)
+        return `${String(bytes)} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+/**
+ * Each class type's pack: from the schema, or from the raw response for nodes the normalizer
+ * dropped.
+ */
+function packsOf(schema, objectInfo) {
+    const packs = new Map();
+    const raw = parse(objectInfo).value;
+    if (raw !== undefined && isRecord(raw)) {
+        for (const [classType, node] of Object.entries(raw)) {
+            const module = isRecord(node) ? node["python_module"] : undefined;
+            if (typeof module === "string")
+                packs.set(classType, module);
+        }
+    }
+    for (const node of Object.values(schema.nodes))
+        packs.set(node.classType, node.pythonModule);
+    return packs;
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/dist/run.d.ts

@@ -0,0 +1,9 @@
+import { type Io } from "./io.ts";
+/** The CLI's version. A test keeps it equal to package.json. */
+export declare const CLI_VERSION = "0.1.0";
+/**
+ * Runs the CLI with `args` (without the program name) and returns the exit code: 0 on success,
+ * 1 on a failure or detected drift, 2 on a usage error.
+ */
+export declare function run(args: readonly string[], io: Io): Promise<number>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,EAAE,EAAE,MAAM,SAAS,CAAC;AAG5C,gEAAgE;AAChE,eAAO,MAAM,WAAW,UAAU,CAAC;AAwBnC;;;GAGG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC1E"}

package/dist/run.js

@@ -0,0 +1,89 @@
+import { CHECK_USAGE, checkCommand } from "./check.js";
+import { GENERATE_USAGE, generateCommand } from "./generate.js";
+import { CliError } from "./io.js";
+import { TRANSPILE_USAGE, transpileCommand } from "./transpile.js";
+/** The CLI's version. A test keeps it equal to package.json. */
+export const CLI_VERSION = "0.1.0";
+/** `tscomfy --help`. */
+const USAGE = `Usage: tscomfy <command> [options]
+
+Commands:
+  generate   Generate typed node definitions from a ComfyUI server
+  check      Check that the generated types still match the server
+  transpile  Turn an API-format prompt or a UI workflow into TypeScript over the generated types
+  help       Show this help, or a command's: tscomfy help <command>
+
+Options:
+  -h, --help     Show this help.
+  -v, --version  Print the version.
+
+Run tscomfy <command> --help for a command's options.
+`;
+const USAGES = new Map([
+    ["generate", GENERATE_USAGE],
+    ["check", CHECK_USAGE],
+    ["transpile", TRANSPILE_USAGE],
+]);
+/**
+ * Runs the CLI with `args` (without the program name) and returns the exit code: 0 on success,
+ * 1 on a failure or detected drift, 2 on a usage error.
+ */
+export async function run(args, io) {
+    const [command, ...rest] = args;
+    try {
+        switch (command) {
+            case "generate":
+                return await generateCommand(io, rest);
+            case "check":
+                return await checkCommand(io, rest);
+            case "transpile":
+                return await transpileCommand(io, rest);
+            case "-v":
+            case "--version":
+                noArguments(rest);
+                io.out(`${CLI_VERSION}\n`);
+                return 0;
+            case "-h":
+            case "--help":
+                noArguments(rest);
+                io.out(USAGE);
+                return 0;
+            case "help":
+                return help(io, rest);
+            case undefined:
+                io.err(USAGE);
+                return 2;
+            default:
+                throw new CliError(`Unknown command ${JSON.stringify(command)}.`, 2);
+        }
+    }
+    catch (error) {
+        if (!(error instanceof CliError))
+            throw error;
+        io.err(`tscomfy: ${error.message}\n`);
+        if (error.exitCode === 2) {
+            io.err(`\n${USAGES.get(command ?? "") ?? USAGE}`);
+        }
+        return error.exitCode;
+    }
+}
+/** `tscomfy help [<command>]`: the usage, or a command's. */
+function help(io, args) {
+    const [topic, ...rest] = args;
+    noArguments(rest);
+    if (topic === undefined) {
+        io.out(USAGE);
+        return 0;
+    }
+    const usage = USAGES.get(topic);
+    if (usage === undefined)
+        throw new CliError(`Unknown command ${JSON.stringify(topic)}.`, 2);
+    io.out(usage);
+    return 0;
+}
+function noArguments(args) {
+    const [extra] = args;
+    if (extra !== undefined)
+        throw new CliError(`Unexpected argument ${JSON.stringify(extra)}.`, 2);
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/source.d.ts

@@ -0,0 +1,28 @@
+import { type Diagnostic, type Schema } from "@tscomfy/core";
+import { type Flags } from "./args.ts";
+import { type Io } from "./io.ts";
+/** Where node definitions come from: a server, or a saved `/object_info` response. */
+export interface Source {
+    /** The `/object_info` text, exactly as served or saved. */
+    readonly text: string;
+    readonly comfyVersion?: string;
+    /** For messages: the server or the file. */
+    readonly label: string;
+    /** For the regenerate command in headers: `--url <server>` or `--from <file>`. */
+    readonly flag: string;
+}
+/**
+ * Reads `--url` (GET `/object_info`, and `/system_stats` for the version) or `--from`. Exactly
+ * one must be given. Only read-only GETs: tscomfy never queues anything.
+ */
+export declare function readSource(io: Io, flags: Flags): Promise<Source>;
+/**
+ * The normalized schema of a source. A response that holds no usable node at all (not JSON, not
+ * an object, an error body such as `{"detail": "Not authenticated"}`, or `{}`) is fatal, so it
+ * can't replace good types; anything less is reported and the rest generated.
+ */
+export declare function loadSchema(source: Source): {
+    readonly schema: Schema;
+    readonly diagnostics: readonly Diagnostic[];
+};
+//# sourceMappingURL=source.d.ts.map

package/dist/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAuB,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,KAAK,KAAK,EAAS,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,EAAY,MAAM,SAAS,CAAC;AAG5C,sFAAsF;AACtF,MAAM,WAAW,MAAM;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BtE;AA0CD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C,CAgBA"}

package/dist/source.js

@@ -0,0 +1,92 @@
+import { normalizeObjectInfo } from "@tscomfy/core";
+import { value } from "./args.js";
+import { CliError } from "./io.js";
+import { errorBodyMessage, flagWords, redactUrl } from "./util.js";
+/**
+ * Reads `--url` (GET `/object_info`, and `/system_stats` for the version) or `--from`. Exactly
+ * one must be given. Only read-only GETs: tscomfy never queues anything.
+ */
+export async function readSource(io, flags) {
+    const url = value(flags, "url");
+    const from = value(flags, "from");
+    if ((url === undefined) === (from === undefined)) {
+        throw new CliError("Give either --url <server> or --from <object_info.json>.", 2);
+    }
+    if (from !== undefined) {
+        const text = await io.readText(from);
+        if (text === undefined)
+            throw new CliError(`There is no file at ${from}.`);
+        const comfyVersion = value(flags, "comfy-version");
+        return {
+            text,
+            ...(comfyVersion === undefined ? {} : { comfyVersion }),
+            label: from,
+            flag: flagWords("from", from),
+        };
+    }
+    const base = serverBase(url ?? "");
+    const shown = redactUrl(base).replace(/\/+$/, "");
+    const text = await io.fetchText(endpoint(base, "object_info"));
+    const comfyVersion = await readComfyVersion(io, endpoint(base, "system_stats"));
+    return {
+        text,
+        ...(comfyVersion === undefined ? {} : { comfyVersion }),
+        label: shown,
+        flag: flagWords("url", shown),
+    };
+}
+/**
+ * The server URL. Credentials and the query (which often carries a token) are sent with each
+ * request but never shown: messages and generated headers use {@link redactUrl}.
+ */
+function serverBase(url) {
+    // Not echoed: an unparseable URL may still hold a password.
+    if (!URL.canParse(url))
+        throw new CliError("--url is not a valid URL.", 2);
+    const parsed = new URL(url);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new CliError(`${redactUrl(parsed)} is not an http(s) URL.`, 2);
+    }
+    if (parsed.hash !== "") {
+        throw new CliError("--url can't have a #fragment: it never reaches the server.", 2);
+    }
+    return parsed;
+}
+/** An endpoint under the server's path, keeping its query: `http://h/api/?t=1` → `…/api/x?t=1`. */
+function endpoint(base, name) {
+    const url = new URL(base.href);
+    url.pathname = `${url.pathname.replace(/\/+$/, "")}/${name}`;
+    return url.href;
+}
+/** The ComfyUI version from `/system_stats`; optional, so a failure only loses the version. */
+async function readComfyVersion(io, url) {
+    try {
+        const stats = JSON.parse(await io.fetchText(url));
+        const system = typeof stats === "object" && stats !== null ? Reflect.get(stats, "system") : undefined;
+        const version = typeof system === "object" && system !== null
+            ? Reflect.get(system, "comfyui_version")
+            : undefined;
+        return typeof version === "string" ? version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The normalized schema of a source. A response that holds no usable node at all (not JSON, not
+ * an object, an error body such as `{"detail": "Not authenticated"}`, or `{}`) is fatal, so it
+ * can't replace good types; anything less is reported and the rest generated.
+ */
+export function loadSchema(source) {
+    const result = normalizeObjectInfo(source.text, source.comfyVersion === undefined ? {} : { comfyVersion: source.comfyVersion });
+    if (Object.keys(result.schema.nodes).length === 0) {
+        const detail = errorBodyMessage(source.text);
+        if (detail !== undefined) {
+            throw new CliError(`${source.label} is an error response, not node definitions: ${detail}.`);
+        }
+        const error = result.diagnostics.find((diagnostic) => diagnostic.severity === "error");
+        throw new CliError(`${source.label} doesn't hold node definitions${error === undefined ? "" : `: ${error.message}`}`);
+    }
+    return result;
+}
+//# sourceMappingURL=source.js.map

package/dist/source.js.map

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

package/dist/transpile.d.ts

@@ -0,0 +1,6 @@
+import { type Io } from "./io.ts";
+/** `tscomfy transpile --help`. */
+export declare const TRANSPILE_USAGE: string;
+/** `tscomfy transpile`. */
+export declare function transpileCommand(io: Io, args: readonly string[]): Promise<number>;
+//# sourceMappingURL=transpile.d.ts.map

package/dist/transpile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpile.d.ts","sourceRoot":"","sources":["../src/transpile.ts"],"names":[],"mappings":"AASA,OAAO,EAAY,KAAK,EAAE,EAAE,MAAM,SAAS,CAAC;AAK5C,kCAAkC;AAClC,eAAO,MAAM,eAAe,EAAE,MAqB7B,CAAC;AAYF,2BAA2B;AAC3B,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyEvF"}