@tscomfy/cli 0.0.0-stage → 0.1.0

package/dist/transpile.js

@@ -0,0 +1,178 @@
+import { basename, dirname, isAbsolute, join, relative, sep } from "node:path";
+import { CODEGEN_VERSION, exportNameProblem, transpile, transpileNameProblem, } from "@tscomfy/codegen";
+import { hashSchema, importApi, importUi, parse, typedSchema } from "@tscomfy/core";
+import { HELP, parseFlags, required, value } from "./args.js";
+import { CliError } from "./io.js";
+import { MANIFEST, readGenerated, SNAPSHOT } from "./manifest.js";
+import { count, formatDiagnostic } from "./report.js";
+import { camelName, flagWords, isRecord } from "./util.js";
+/** `tscomfy transpile --help`. */
+export const TRANSPILE_USAGE = `Usage: tscomfy transpile (--prompt <prompt.json> | --workflow <workflow.json>) --schema <dir> [options]
+
+Turns an API-format prompt (the frontend's "Export (API)"), or a UI workflow (its "Save" or
+"Export"), into TypeScript that builds it with the types \`tscomfy generate\` wrote into <dir>.
+Running the code and exporting gives the prompt back: for a UI workflow, the prompt the frontend
+would queue for it, with Reroutes, PrimitiveNodes and subgraphs resolved. Nodes the types can't
+express are written as raw(…), with a warning.
+
+Options:
+  --prompt <file>      The prompt to transpile.
+  --workflow <file>    The UI workflow to transpile, instead of a prompt.
+  --schema <dir>       The directory \`tscomfy generate\` wrote (it reads ${SNAPSHOT} and ${MANIFEST}).
+  --out <file>         Where to write the module. Default: standard output, importing the
+                       schema relative to the current directory.
+  --name <identifier>  The exported constant. Default: from the file name, camelCased
+                       (My Txt2Img.json → myTxt2Img).
+  --no-inline          Give every node a variable, rather than inlining those used once.
+  -h, --help           Show this help.
+
+The header records the command that transpiles the file again, for a POSIX shell in the
+directory transpile ran in. A value that starts with - is written --flag=<value>.
+`;
+const FLAGS = [
+    { name: "prompt", takesValue: true },
+    { name: "workflow", takesValue: true },
+    { name: "schema", takesValue: true },
+    { name: "out", takesValue: true },
+    { name: "name", takesValue: true },
+    { name: "no-inline", takesValue: false },
+    HELP,
+];
+/** `tscomfy transpile`. */
+export async function transpileCommand(io, args) {
+    const flags = parseFlags(args, FLAGS);
+    if (flags.has("help")) {
+        io.out(TRANSPILE_USAGE);
+        return 0;
+    }
+    if (flags.has("prompt") && flags.has("workflow")) {
+        throw new CliError("Pass --prompt or --workflow, not both.", 2);
+    }
+    if (!flags.has("prompt") && !flags.has("workflow")) {
+        throw new CliError("--prompt or --workflow is required.", 2);
+    }
+    const kind = flags.has("workflow") ? "workflow" : "prompt";
+    const promptPath = required(flags, kind);
+    const schemaDir = required(flags, "schema");
+    const out = value(flags, "out");
+    const { manifest, schema } = await readGenerated(io, schemaDir);
+    const name = readName(flags, promptPath, manifest.exportName);
+    const text = await io.readText(promptPath);
+    if (text === undefined)
+        throw new CliError(`There is no file at ${promptPath}.`);
+    // The types in <dir> must be the ones this version would write, or the code won't fit them.
+    if (manifest.codegen !== CODEGEN_VERSION || manifest.schema !== hashSchema(schema)) {
+        throw new CliError(`${schemaDir} was generated by another version of tscomfy; run tscomfy generate again first.`);
+    }
+    const what = kind === "prompt" ? "a prompt" : "a UI workflow";
+    const mixUp = kind === "prompt" ? notAPrompt(text) : notAWorkflow(text);
+    if (mixUp !== undefined)
+        throw new CliError(`${promptPath} isn't ${what}: ${mixUp}`);
+    const typed = typedSchema(schema);
+    const imported = kind === "prompt" ? importApi(text, typed) : importUi(text, typed);
+    const fatal = imported.diagnostics.find((diagnostic) => diagnostic.path.length === 0 &&
+        (diagnostic.code === "E_INVALID_JSON" ||
+            diagnostic.code === "E_INVALID_PROMPT" ||
+            diagnostic.code === "E_INVALID_WORKFLOW"));
+    if (fatal !== undefined) {
+        throw new CliError(`${promptPath} isn't ${what}: ${fatal.message}`);
+    }
+    if (imported.workflow.graph.nodes.size === 0) {
+        throw new CliError(`${promptPath} isn't ${what}: it has no node that can be read.`);
+    }
+    const command = [
+        "tscomfy transpile",
+        flagWords(kind, promptPath),
+        flagWords("schema", schemaDir),
+        ...(out === undefined ? [] : [flagWords("out", out)]),
+        ...(flags.has("name") ? [flagWords("name", name)] : []),
+        ...(flags.has("no-inline") ? ["--no-inline"] : []),
+    ].join(" ");
+    const result = transpile(imported.workflow, {
+        name,
+        schemaModule: moduleSpecifier(out, schemaDir, manifest.importExtension),
+        schemaName: manifest.exportName,
+        inline: !flags.has("no-inline"),
+        header: [`Regenerate with: ${command}`],
+    });
+    for (const diagnostic of [...imported.diagnostics, ...result.diagnostics]) {
+        io.err(`${formatDiagnostic(diagnostic)}\n`);
+    }
+    if (out === undefined) {
+        io.out(result.code);
+        return 0;
+    }
+    await io.writeText(out, result.code);
+    io.out(`Transpiled ${count(imported.workflow.graph.nodes.size, "node")} from ${promptPath} into ${out}.\n`);
+    return 0;
+}
+/**
+ * What a file that isn't a prompt looks like instead, when it is a common mix-up: the frontend's
+ * UI workflow (`nodes` and `links`), or a `POST /prompt` body (`{ "prompt": … }`).
+ */
+function notAPrompt(text) {
+    const parsed = parse(text).value;
+    if (parsed === undefined || !isRecord(parsed))
+        return undefined;
+    if (isUiWorkflow(parsed))
+        return "it is a UI workflow; pass it with --workflow instead.";
+    // A node with the id "prompt" has a class_type; a POST /prompt body's prompt doesn't.
+    const prompt = parsed["prompt"];
+    if (prompt !== undefined && isRecord(prompt) && !Object.hasOwn(prompt, "class_type")) {
+        return "it is a POST /prompt body; save its prompt on its own.";
+    }
+    return undefined;
+}
+/** What a file passed as a UI workflow looks like instead: a prompt, or a `POST /prompt` body. */
+function notAWorkflow(text) {
+    const parsed = parse(text).value;
+    if (parsed === undefined || !isRecord(parsed) || isUiWorkflow(parsed))
+        return undefined;
+    const nodes = Object.values(parsed);
+    if (nodes.length > 0 && nodes.every((node) => isRecord(node) && "class_type" in node)) {
+        return "it is an API prompt; pass it with --prompt instead.";
+    }
+    if (Object.hasOwn(parsed, "prompt")) {
+        return "it is a POST /prompt body; save its prompt on its own and pass it with --prompt.";
+    }
+    return undefined;
+}
+function isUiWorkflow(parsed) {
+    return Array.isArray(parsed["nodes"]) && Array.isArray(parsed["links"]);
+}
+/**
+ * How the module imports the schema: relative to where it is written (the current directory
+ * without --out), with POSIX separators.
+ */
+function moduleSpecifier(out, schemaDir, extension) {
+    const from = out === undefined ? "." : dirname(out);
+    const target = relative(from, join(schemaDir, `index${extension}`));
+    // On another drive (Windows) there is no relative path.
+    if (isAbsolute(target)) {
+        throw new CliError("--schema and --out are on different drives; no relative import joins them.");
+    }
+    const posix = target.split(sep).join("/");
+    return posix.startsWith("./") || posix.startsWith("../") ? posix : `./${posix}`;
+}
+/**
+ * The export name: `--name`, or from the file name (`Anima-API.json` → `animaApi`, see
+ * `camelName`). The schema's name and this one must both be usable by `transpile`, by the rule
+ * `generate` checked the schema's with.
+ */
+function readName(flags, promptPath, schemaName) {
+    const schemaProblem = exportNameProblem(schemaName);
+    if (schemaProblem !== undefined) {
+        // Generated before generate checked this.
+        throw new CliError(`The schema's export name, ${schemaName}, won't do: ${schemaProblem}. Run tscomfy generate again with another --name.`);
+    }
+    const given = value(flags, "name");
+    const name = given ?? camelName(basename(promptPath).replace(/\.[^.]*$/, ""));
+    const problem = exportNameProblem(name) ?? transpileNameProblem({ name, schemaName });
+    if (problem !== undefined) {
+        throw new CliError(given === undefined
+            ? `Can't name the export ${JSON.stringify(name)}, after ${JSON.stringify(promptPath)}: ${problem}; pass --name.`
+            : `--name ${JSON.stringify(given)} isn't usable: ${problem}.`, 2);
+    }
+    return name;
+}
+//# sourceMappingURL=transpile.js.map

package/dist/transpile.js.map

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

package/dist/util.d.ts

@@ -0,0 +1,33 @@
+import { type JsonValue } from "@tscomfy/core";
+/** Whether a JSON value is an object (not null, not an array). */
+export declare function isRecord(value: JsonValue): value is {
+    readonly [key: string]: JsonValue;
+};
+/** A word for a POSIX shell, quoted only when it has to be: `out dir` → `'out dir'`. */
+export declare function shellQuote(word: string): string;
+/**
+ * `--name value` for a POSIX shell, as the CLI reads it back: `--name=value` when the value
+ * starts with `-`, which the separate form would take for a flag (`--out=--weird`).
+ */
+export declare function flagWords(name: string, value: string): string;
+/**
+ * An export name from a file or directory name, the same rule for `generate --out` and
+ * `transpile --prompt`: camelCase from the runs of ASCII letters and digits, a word in capitals
+ * lowercased, the first word starting lowercase and the others uppercase
+ * (`src/comfy/local` → `local`, `my-server` → `myServer`, `Anima-API.json` → `animaApi`).
+ * May be empty or start with a digit: callers check the result.
+ */
+export declare function camelName(text: string): string;
+/**
+ * The message of an error body, when `text` is one rather than an answer: an object with a lone
+ * `detail`, `error` or `message` (`{"detail": "Not authenticated"}`, as auth proxies in front of
+ * ComfyUI send), whose value isn't a node definition. Shown as compact JSON, at most 200
+ * characters, with every control character escaped, so none reaches the terminal.
+ */
+export declare function errorBodyMessage(text: string): string | undefined;
+/**
+ * A URL fit for messages and generated files: without credentials, query or fragment, which is
+ * where servers expect passwords and tokens. `http://user:pw@host/api?token=t` → `http://host/api`.
+ */
+export declare function redactUrl(url: URL): string;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,eAAe,CAAC;AAEjE,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAEzF;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU9C;AAKD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuBjE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAO1C"}

package/dist/util.js

@@ -0,0 +1,81 @@
+import { parse, stringify } from "@tscomfy/core";
+/** Whether a JSON value is an object (not null, not an array). */
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** A word for a POSIX shell, quoted only when it has to be: `out dir` → `'out dir'`. */
+export function shellQuote(word) {
+    return /^[\w@%+=:,./-]+$/.test(word) ? word : `'${word.replaceAll("'", "'\\''")}'`;
+}
+/**
+ * `--name value` for a POSIX shell, as the CLI reads it back: `--name=value` when the value
+ * starts with `-`, which the separate form would take for a flag (`--out=--weird`).
+ */
+export function flagWords(name, value) {
+    return value.startsWith("-")
+        ? `--${name}=${shellQuote(value)}`
+        : `--${name} ${shellQuote(value)}`;
+}
+/**
+ * An export name from a file or directory name, the same rule for `generate --out` and
+ * `transpile --prompt`: camelCase from the runs of ASCII letters and digits, a word in capitals
+ * lowercased, the first word starting lowercase and the others uppercase
+ * (`src/comfy/local` → `local`, `my-server` → `myServer`, `Anima-API.json` → `animaApi`).
+ * May be empty or start with a digit: callers check the result.
+ */
+export function camelName(text) {
+    const words = text.match(/[A-Za-z0-9]+/g) ?? [];
+    return words
+        .map((word, index) => {
+        const lower = word === word.toUpperCase() ? word.toLowerCase() : word;
+        return index === 0
+            ? lower.charAt(0).toLowerCase() + lower.slice(1)
+            : lower.charAt(0).toUpperCase() + lower.slice(1);
+    })
+        .join("");
+}
+/** How much of an error body's message a message shows. */
+const SHOWN_DETAIL = 200;
+/**
+ * The message of an error body, when `text` is one rather than an answer: an object with a lone
+ * `detail`, `error` or `message` (`{"detail": "Not authenticated"}`, as auth proxies in front of
+ * ComfyUI send), whose value isn't a node definition. Shown as compact JSON, at most 200
+ * characters, with every control character escaped, so none reaches the terminal.
+ */
+export function errorBodyMessage(text) {
+    const value = parse(text).value;
+    if (value === undefined || !isRecord(value))
+        return undefined;
+    const keys = Object.keys(value);
+    const [key] = keys;
+    if (keys.length !== 1 || (key !== "detail" && key !== "error" && key !== "message")) {
+        return undefined;
+    }
+    const message = value[key];
+    if (message === undefined || message === null)
+        return undefined;
+    // A node class named `error` is an object with its inputs and outputs.
+    if (isRecord(message) && (Object.hasOwn(message, "input") || Object.hasOwn(message, "output"))) {
+        return undefined;
+    }
+    // `stringify` escapes C0 controls; DEL and C1 controls (a CSI is U+009B) are escaped here.
+    const shown = stringify(message).replaceAll(/[\u007f-\u009f]/g, (char) => `\\u${char.charCodeAt(0).toString(16).padStart(4, "0")}`);
+    if (shown.length <= SHOWN_DETAIL)
+        return shown;
+    const cut = shown.slice(0, SHOWN_DETAIL);
+    // Not half a surrogate pair.
+    return `${/[\ud800-\udbff]$/.test(cut) ? cut.slice(0, -1) : cut}…`;
+}
+/**
+ * A URL fit for messages and generated files: without credentials, query or fragment, which is
+ * where servers expect passwords and tokens. `http://user:pw@host/api?token=t` → `http://host/api`.
+ */
+export function redactUrl(url) {
+    const shown = new URL(url.href);
+    shown.username = "";
+    shown.password = "";
+    shown.search = "";
+    shown.hash = "";
+    return shown.href;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@tscomfy/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "The tscomfy command: generate types from a ComfyUI server, check them for drift, and transpile API prompts and UI workflows to code.",
+  "keywords": [
+    "cli",
+    "codegen",
+    "comfyui",
+    "typescript",
+    "workflow"
+  ],
+  "homepage": "https://github.com/TheeKia/tscomfy/tree/main/packages/cli#readme",
+  "bugs": "https://github.com/TheeKia/tscomfy/issues",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TheeKia/tscomfy.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "tscomfy": "dist/main.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.tsbuildinfo",
+    "src"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "./dist/main.js",
+    "./src/main.ts"
+  ],
+  "exports": {
+    ".": {
+      "@tscomfy/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tscomfy/codegen": "0.1.0"
+  },
+  "devDependencies": {
+    "@tscomfy/core": "0.1.0",
+    "@tscomfy/fixtures": "0.0.0",
+    "@types/node": "24.19.2"
+  },
+  "peerDependencies": {
+    "@tscomfy/core": "^0.1.0"
+  },
+  "engines": {
+    "bun": ">=1.4",
+    "node": ">=24"
+  }
+}

package/src/args.ts

@@ -0,0 +1,78 @@
+import { CliError } from "./io.ts";
+
+/** One flag a command accepts: `--name value`, `--name=value`, or a boolean `--name`. */
+export interface FlagSpec {
+  readonly name: string;
+  readonly takesValue: boolean;
+  /** A one-letter alias of a boolean flag: `h` for `-h`. */
+  readonly short?: string;
+}
+
+/** Parsed flags: the value of each given flag, `true` for a boolean one. */
+export type Flags = ReadonlyMap<string, string | true>;
+
+/** `-h, --help`, which every command takes. */
+export const HELP: FlagSpec = { name: "help", takesValue: false, short: "h" };
+
+/**
+ * Parses the arguments after the command name. Throws a usage {@link CliError} (exit 2).
+ *
+ * A value given apart (`--out dir`) can't start with `-`, so a forgotten value isn't read from
+ * the next flag (`--out --from x`); `--out=-dir` gives such a value. Every value is recorded in
+ * a regenerate command, which can't keep control characters, so none may have one.
+ */
+export function parseFlags(args: readonly string[], specs: readonly FlagSpec[]): Flags {
+  const flags = new Map<string, string | true>();
+  for (let index = 0; index < args.length; index++) {
+    const arg = args[index] ?? "";
+    const short = /^-([A-Za-z])$/.exec(arg)?.[1];
+    if (short !== undefined) {
+      const spec = specs.find((each) => each.short === short);
+      if (spec === undefined) throw new CliError(`Unknown option -${short}.`, 2);
+      if (flags.has(spec.name)) throw new CliError(`--${spec.name} is given twice.`, 2);
+      flags.set(spec.name, true);
+      continue;
+    }
+    if (!arg.startsWith("--")) throw new CliError(`Unexpected argument ${JSON.stringify(arg)}.`, 2);
+    const equals = arg.indexOf("=");
+    const name = arg.slice(2, equals === -1 ? undefined : equals);
+    const spec = specs.find((each) => each.name === name);
+    if (spec === undefined) throw new CliError(`Unknown option --${name}.`, 2);
+    if (flags.has(name)) throw new CliError(`--${name} is given twice.`, 2);
+    if (!spec.takesValue) {
+      if (equals !== -1) throw new CliError(`--${name} takes no value.`, 2);
+      flags.set(name, true);
+      continue;
+    }
+    const given = equals === -1 ? args[++index] : arg.slice(equals + 1);
+    if (given === undefined || given === "") throw new CliError(`--${name} needs a value.`, 2);
+    if (equals === -1 && given.startsWith("-")) {
+      throw new CliError(
+        `--${name} needs a value; for one that starts with -, write --${name}=<value>.`,
+        2,
+      );
+    }
+    // oxlint-disable-next-line no-control-regex -- control characters are what this looks for
+    if (/[\u0000-\u001f\u007f]/.test(given)) {
+      throw new CliError(
+        `--${name} has a control character, which a regenerate command can't keep.`,
+        2,
+      );
+    }
+    flags.set(name, given);
+  }
+  return flags;
+}
+
+/** A flag's value, if given. */
+export function value(flags: Flags, name: string): string | undefined {
+  const given = flags.get(name);
+  return typeof given === "string" ? given : undefined;
+}
+
+/** A flag's value, which must be given. */
+export function required(flags: Flags, name: string): string {
+  const given = value(flags, name);
+  if (given === undefined) throw new CliError(`--${name} is required.`, 2);
+  return given;
+}