@flat8n/cli 0.1.0

package/dist/src/cli/server.d.ts

@@ -0,0 +1,2 @@
+export declare function bootN8n(): Promise<void>;
+export declare function killN8n(): void;

package/dist/src/cli/server.js

@@ -0,0 +1,62 @@
+import { spawn, execSync } from "node:child_process";
+import { spinner } from "@clack/prompts";
+let n8nProcess = null;
+function killGhostProcess() {
+    try {
+        if (process.platform === "win32") {
+            execSync('for /f "tokens=5" %a in (\'netstat -aon ^| findstr :5678\') do taskkill /F /T /PID %a', { stdio: "ignore", shell: "cmd.exe" });
+        }
+        else {
+            execSync("lsof -t -i:5678 | xargs kill -9", { stdio: "ignore" });
+        }
+    }
+    catch (e) {
+        // Ignore errors when no process exists
+    }
+}
+export async function bootN8n() {
+    const host = process.env.N8N_HOST || "http://localhost:5678";
+    // Only attempt local boot if we are targeting localhost
+    if (!host.includes("localhost") && !host.includes("127.0.0.1")) {
+        return;
+    }
+    // Quick check if it's already running
+    try {
+        const res = await fetch(`${host}/`);
+        if (res.ok)
+            return; // Already running
+    }
+    catch (e) { }
+    killGhostProcess();
+    n8nProcess = spawn("npx", ["n8n"], { stdio: ["ignore", "pipe", "pipe"], shell: true });
+    let isReady = false;
+    n8nProcess.stderr?.on("data", (data) => {
+        if (!isReady) {
+            const errorString = data.toString();
+            if (!errorString.includes("Python") && !errorString.includes("license")) {
+                // Silently capture errors during boot
+            }
+        }
+    });
+    const s = spinner();
+    s.start("Booting local n8n engine...");
+    while (!isReady) {
+        try {
+            const res = await fetch(`${host}/`);
+            if (res.ok) {
+                isReady = true;
+                s.stop("n8n engine is ready!");
+                break;
+            }
+        }
+        catch (e) { }
+        await new Promise(r => setTimeout(r, 1000));
+    }
+}
+export function killN8n() {
+    killGhostProcess();
+    if (n8nProcess) {
+        n8nProcess.kill("SIGINT");
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/src/cli/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/cli/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAqB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,IAAI,UAAU,GAAwB,IAAI,CAAC;AAE3C,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,QAAQ,CAAC,uFAAuF,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3I,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,uCAAuC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAE7D,wDAAwD;IACxD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,sCAAsC;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QACpC,IAAI,GAAG,CAAC,EAAE;YAAE,OAAO,CAAC,kBAAkB;IACxC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,CAAA,CAAC;IAEd,gBAAgB,EAAE,CAAC;IAEnB,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvF,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxE,sCAAsC;YACxC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;IACpB,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAEvC,OAAO,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;YACpC,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;gBACX,OAAO,GAAG,IAAI,CAAC;gBACf,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;gBAC/B,MAAM;YACR,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,CAAA,CAAC;QACd,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,gBAAgB,EAAE,CAAC;IACnB,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/src/cli/setup.d.ts

@@ -0,0 +1 @@
+export declare function ensureEnvironment(): Promise<void>;

package/dist/src/cli/setup.js

@@ -0,0 +1,62 @@
+import { select, text, note, log } from "@clack/prompts";
+import pc from "picocolors";
+import { appendFile } from "node:fs/promises";
+import { join } from "node:path";
+import { handleCancel } from "./ui.js";
+export async function ensureEnvironment() {
+    // If API key is already present in process.env, skip setup
+    if (process.env.N8N_API_KEY) {
+        return;
+    }
+    log.warn("N8N_API_KEY is missing from your environment.");
+    // Ask for Host Type
+    const hostType = handleCancel(await select({
+        message: "Where is your n8n instance hosted?",
+        options: [
+            { value: "local", label: "Local Desktop (n8n start)" },
+            { value: "cloud", label: "n8n Cloud" },
+            { value: "self-hosted", label: "Self-Hosted / Docker" },
+        ],
+    }));
+    let hostUrl = "http://localhost:5678";
+    if (hostType !== "local") {
+        const url = handleCancel(await text({
+            message: "Enter your n8n instance URL (e.g. https://n8n.yourdomain.com):",
+            placeholder: "https://",
+            validate: (value) => {
+                if (!value)
+                    return "URL is required.";
+                if (!value.startsWith("http://") && !value.startsWith("https://")) {
+                    return "URL must start with http:// or https://";
+                }
+            }
+        }));
+        hostUrl = url.trim().replace(/\/$/, ""); // Remove trailing slash
+    }
+    // Provide Instructions
+    const settingsUrl = `${hostUrl}/settings/api`;
+    note(`1. Open ${pc.cyan(pc.underline(settingsUrl))}\n2. Click "Add API Key" and label it "flat8n"\n3. Set expiration to "Never" and copy the key`, "How to get your API Key:");
+    // Ask for API Key
+    const apiKey = handleCancel(await text({
+        message: "Paste your n8n API Key:",
+        placeholder: "n8n_api_key_...",
+        validate: (value) => {
+            if (!value || value.trim().length === 0)
+                return "API Key is required.";
+        }
+    }));
+    // Inject into process.env so current run succeeds
+    process.env.N8N_HOST = hostUrl;
+    process.env.N8N_API_KEY = apiKey.trim();
+    // Save to local .env
+    const envPath = join(process.cwd(), ".env");
+    const envContent = `\nN8N_HOST=${hostUrl}\nN8N_API_KEY=${apiKey.trim()}\n`;
+    try {
+        await appendFile(envPath, envContent, "utf8");
+        log.success(`Saved API Key to ${pc.dim(envPath)}`);
+    }
+    catch (error) {
+        log.error(`Failed to save to .env file: ${String(error)}`);
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/src/cli/setup.js.map

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

package/dist/src/cli/sync.d.ts

@@ -0,0 +1,4 @@
+export declare function runSync(options: {
+    host?: string;
+    apiKey?: string | undefined;
+}): Promise<number>;

package/dist/src/cli/sync.js

@@ -0,0 +1,45 @@
+import { readdir, readFile } from "node:fs/promises";
+import { resolve, join } from "node:path";
+import { spinner } from "@clack/prompts";
+import pc from "picocolors";
+import { upsertWorkflow } from "./api.js";
+export async function runSync(options) {
+    const cwd = process.cwd();
+    const distDir = resolve(cwd, "dist");
+    let files;
+    try {
+        const entries = await readdir(distDir, { withFileTypes: true });
+        files = entries.filter(e => e.isFile() && e.name.endsWith(".json")).map(e => e.name);
+    }
+    catch (error) {
+        process.stderr.write(pc.red(`\n⚠ Failed to read dist directory. Have you run 'flat8n build' yet?\n`));
+        return 1;
+    }
+    if (files.length === 0) {
+        process.stdout.write(pc.yellow(`\n⚠ No compiled workflows found in dist/\n`));
+        return 0;
+    }
+    const s = spinner();
+    s.start(pc.cyan("Synchronizing workflows to n8n database..."));
+    let successCount = 0;
+    for (const file of files) {
+        const filePath = join(distDir, file);
+        try {
+            const content = await readFile(filePath, "utf8");
+            const parsed = JSON.parse(content);
+            const result = await upsertWorkflow(options, parsed);
+            if (!result.success) {
+                s.stop(pc.red(`⚠ Failed to deploy ${parsed.name || file}: ${result.error}`));
+                return 1;
+            }
+            successCount++;
+        }
+        catch (e) {
+            s.stop(pc.red(`⚠ Failed to parse or upload ${file}`));
+            return 1;
+        }
+    }
+    s.stop(pc.green(`✔ ${successCount} module(s) successfully deployed!`));
+    return 0;
+}
+//# sourceMappingURL=sync.js.map

package/dist/src/cli/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/cli/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAuD;IACnF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAErC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC,CAAC;QACtG,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,4CAA4C,CAAC,CAAC,CAAC;QAC9E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;IACpB,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC,CAAC;IAE/D,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEnC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,IAAI,IAAI,IAAI,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC7E,OAAO,CAAC,CAAC;YACX,CAAC;YACD,YAAY,EAAE,CAAC;QACjB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,+BAA+B,IAAI,EAAE,CAAC,CAAC,CAAC;YACtD,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,YAAY,mCAAmC,CAAC,CAAC,CAAC;IACvE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/src/cli/ui.d.ts

@@ -0,0 +1,5 @@
+export declare function printBrand(): void;
+export declare function showBranding(): void;
+export declare function handleCancel<T>(val: T | symbol): T;
+export declare function renderDashboardMenu(): void;
+export declare function startKeyboardListener(onReload: () => Promise<void>, onQuit: () => void): void;

package/dist/src/cli/ui.js

@@ -0,0 +1,66 @@
+import { isCancel, cancel } from "@clack/prompts";
+import pc from "picocolors";
+const ASCII_ART = [
+    "███████╗  ██╗         █████╗  ████████╗ ████████╗   █████╗  ███╗   ██╗",
+    "██╔════╝  ██║        ██╔══██╗ ╚══██╔══╝ ╚══██╔══╝  ██╔══██╗ ████╗  ██║",
+    "█████╗    ██║        ███████║    ██║       ██║     ╚█████╔╝ ██╔██╗ ██║",
+    "██╔══╝    ██║        ██╔══██║    ██║       ██║     ██╔══██╗ ██║╚██╗██║",
+    "██║       ████████╗  ██║  ██║    ██║       ██║     ╚█████╔╝ ██║ ╚████║",
+    "╚═╝       ╚═══════╝  ╚═╝  ╚═╝    ╚═╝       ╚═╝      ╚════╝  ╚═╝  ╚═══╝"
+];
+export function printBrand() {
+    process.stdout.write("\n");
+    // Single TrueColor block to prevent cmd.exe mid-line cursor squishing
+    const color = "\x1b[38;2;234;75;113m"; // #EA4B71
+    const reset = "\x1b[0m";
+    process.stdout.write(`${color}${ASCII_ART.join('\n')}${reset}\n`);
+}
+export function showBranding() {
+    printBrand();
+    const githubUrl = "https://github.com/jvondev";
+    const linkText = "by JVON DEV";
+    const pad = " ".repeat(59);
+    process.stdout.write(`${pad}\x1b[90m\x1b]8;;${githubUrl}\x1b\\${linkText}\x1b]8;;\x1b\\\x1b[0m\n\n`);
+}
+export function handleCancel(val) {
+    if (isCancel(val)) {
+        cancel("Operation cancelled.");
+        process.exit(0);
+    }
+    return val;
+}
+export function renderDashboardMenu() {
+    const host = process.env.N8N_HOST || "http://localhost:5678";
+    process.stdout.write("\n=============================================================\n");
+    process.stdout.write(`                 ${pc.bold("FLATT8N DEV SERVER ONLINE")}\n`);
+    process.stdout.write("=============================================================\n");
+    process.stdout.write(pc.dim("│\n"));
+    process.stdout.write(`◇  Dashboard : ${pc.cyan(host)}\n`);
+    process.stdout.write(`│  Reload    : Press [ R ]\n`);
+    process.stdout.write(`│  Quit      : Press [ Q ]\n`);
+    process.stdout.write(pc.dim("│\n"));
+}
+export function startKeyboardListener(onReload, onQuit) {
+    const stdin = process.stdin;
+    if (stdin.isTTY) {
+        stdin.setRawMode(true);
+    }
+    stdin.resume();
+    stdin.setEncoding("utf8");
+    stdin.on("data", async function (key) {
+        if (key === "\u0003" || key.toLowerCase() === "q") {
+            onQuit();
+        }
+        if (key.toLowerCase() === "r") {
+            process.stdout.write("\n");
+            if (stdin.isTTY)
+                stdin.setRawMode(false);
+            stdin.pause();
+            await onReload();
+            stdin.resume();
+            if (stdin.isTTY)
+                stdin.setRawMode(true);
+        }
+    });
+}
+//# sourceMappingURL=ui.js.map

package/dist/src/cli/ui.js.map

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

package/dist/src/compiler/analyze.d.ts

@@ -0,0 +1,15 @@
+import type { CompilerDiagnostic } from "./diagnostics.js";
+import type { AnalyzeInput } from "./inputs.js";
+import type { GraphStats } from "../ir/model.js";
+export interface WorkflowAnalysis {
+    readonly id: string;
+    readonly name: string;
+    readonly path: string;
+    readonly stats: GraphStats;
+}
+export interface AnalyzeResult {
+    readonly ok: boolean;
+    readonly workflows: readonly WorkflowAnalysis[];
+    readonly diagnostics: readonly CompilerDiagnostic[];
+}
+export declare function analyze(input: AnalyzeInput): AnalyzeResult;

package/dist/src/compiler/analyze.js

@@ -0,0 +1,26 @@
+import { parseN8nWorkflow } from "../parser/n8n-parser.js";
+import { collectGraphStats, validateWorkflowIR } from "../validation/graph-integrity.js";
+export function analyze(input) {
+    const diagnostics = [];
+    const workflows = [];
+    const sources = [input.entry, ...Object.values(input.dependencies ?? {})];
+    for (const source of sources) {
+        const parsed = parseN8nWorkflow(source);
+        diagnostics.push(...parsed.diagnostics);
+        if (parsed.workflow !== undefined) {
+            diagnostics.push(...validateWorkflowIR(parsed.workflow, "analysis"));
+            workflows.push({
+                id: parsed.workflow.id,
+                name: parsed.workflow.name,
+                path: parsed.workflow.path,
+                stats: collectGraphStats(parsed.workflow)
+            });
+        }
+    }
+    return {
+        ok: diagnostics.every((item) => item.severity !== "error"),
+        workflows,
+        diagnostics
+    };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/src/compiler/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/compiler/analyze.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAezF,MAAM,UAAU,OAAO,CAAC,KAAmB;IACzC,MAAM,WAAW,GAAyB,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;IAE1E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACxC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,WAAW,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;YACrE,SAAS,CAAC,IAAI,CAAC;gBACb,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;gBACtB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;gBAC1B,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;gBAC1B,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC;aAC1C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC;QAC1D,SAAS;QACT,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/src/compiler/diagnostics.d.ts

@@ -0,0 +1,28 @@
+export type DiagnosticSeverity = "error" | "warning";
+export interface SourceLocation {
+    readonly path: string;
+    readonly pointer: string;
+}
+export interface CompilerDiagnostic {
+    readonly severity: DiagnosticSeverity;
+    readonly pass: string;
+    readonly workflow: string;
+    readonly node?: string;
+    readonly location?: SourceLocation;
+    readonly cause: string;
+    readonly invariant: string;
+    readonly suggestion: string;
+}
+export interface DiagnosticInput {
+    readonly severity?: DiagnosticSeverity;
+    readonly pass: string;
+    readonly workflow: string;
+    readonly node?: string;
+    readonly location?: SourceLocation;
+    readonly cause: string;
+    readonly invariant: string;
+    readonly suggestion: string;
+}
+export declare function diagnostic(input: DiagnosticInput): CompilerDiagnostic;
+export declare function hasErrors(diagnostics: readonly CompilerDiagnostic[]): boolean;
+export declare function formatDiagnostic(item: CompilerDiagnostic): string;

package/dist/src/compiler/diagnostics.js

@@ -0,0 +1,26 @@
+export function diagnostic(input) {
+    const output = {
+        severity: input.severity ?? "error",
+        pass: input.pass,
+        workflow: input.workflow,
+        cause: input.cause,
+        invariant: input.invariant,
+        suggestion: input.suggestion
+    };
+    if (input.node !== undefined) {
+        output.node = input.node;
+    }
+    if (input.location !== undefined) {
+        output.location = input.location;
+    }
+    return output;
+}
+export function hasErrors(diagnostics) {
+    return diagnostics.some((item) => item.severity === "error");
+}
+export function formatDiagnostic(item) {
+    const node = item.node === undefined ? "" : ` node="${item.node}"`;
+    const location = item.location === undefined ? "" : ` ${item.location.path}${item.location.pointer}`;
+    return `[${item.severity}] ${item.pass} workflow="${item.workflow}"${node}${location}: ${item.cause}. Invariant: ${item.invariant}. Fix: ${item.suggestion}`;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/src/compiler/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/compiler/diagnostics.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,MAAM,GASR;QACF,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,OAAO;QACnC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;IAEF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,WAA0C;IAClE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAwB;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,GAAG,CAAC;IACnE,MAAM,QAAQ,GACZ,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACtF,OAAO,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,QAAQ,KAAK,IAAI,CAAC,KAAK,gBAAgB,IAAI,CAAC,SAAS,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;AAC/J,CAAC"}

package/dist/src/compiler/inputs.d.ts

@@ -0,0 +1,30 @@
+import type { JsonObject } from "./json.js";
+export interface WorkflowSource {
+    readonly id: string;
+    readonly path: string;
+    readonly workflow: JsonObject;
+}
+export interface LinkOptions {
+    readonly credentialPolicy?: "stripIds" | "preserveIds";
+    readonly credentialIdOverrides?: Readonly<Record<string, string>>;
+    readonly layout?: LayoutOptions;
+    readonly namespaceSeparator?: string;
+}
+export interface LayoutOptions {
+    readonly direction?: "right" | "left" | "down" | "up";
+    readonly spacing?: number;
+}
+export interface LinkInput {
+    readonly entry: WorkflowSource;
+    readonly dependencies?: Readonly<Record<string, WorkflowSource>>;
+    readonly options?: LinkOptions;
+}
+export interface ValidateInput {
+    readonly workflow: JsonObject;
+    readonly id?: string;
+    readonly path?: string;
+}
+export interface AnalyzeInput {
+    readonly entry: WorkflowSource;
+    readonly dependencies?: Readonly<Record<string, WorkflowSource>>;
+}

package/dist/src/compiler/inputs.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inputs.js.map

package/dist/src/compiler/inputs.js.map

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

package/dist/src/compiler/json.d.ts

@@ -0,0 +1,15 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+export type JsonArray = readonly JsonValue[];
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+export type MutableJsonObject = {
+    [key: string]: JsonValue;
+};
+export type MutableJsonArray = JsonValue[];
+export declare function isJsonObject(value: JsonValue | unknown): value is JsonObject;
+export declare function isJsonArray(value: JsonValue | unknown): value is JsonArray;
+export declare function asJsonValue(value: unknown): JsonValue | undefined;
+export declare function cloneJson(value: JsonValue): JsonValue;
+export declare function jsonEquals(left: JsonValue, right: JsonValue): boolean;

package/dist/src/compiler/json.js

@@ -0,0 +1,83 @@
+export function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function isJsonArray(value) {
+    return Array.isArray(value);
+}
+export function asJsonValue(value) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return Number.isNaN(value) ? undefined : value;
+    }
+    if (Array.isArray(value)) {
+        const values = [];
+        for (const item of value) {
+            const parsed = asJsonValue(item);
+            if (parsed === undefined) {
+                return undefined;
+            }
+            values.push(parsed);
+        }
+        return values;
+    }
+    if (typeof value === "object" && value !== null) {
+        const output = {};
+        for (const [key, item] of Object.entries(value)) {
+            const parsed = asJsonValue(item);
+            if (parsed === undefined) {
+                return undefined;
+            }
+            output[key] = parsed;
+        }
+        return output;
+    }
+    return undefined;
+}
+export function cloneJson(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => cloneJson(item));
+    }
+    if (isJsonObject(value)) {
+        const output = {};
+        for (const [key, item] of Object.entries(value)) {
+            output[key] = cloneJson(item);
+        }
+        return output;
+    }
+    return value;
+}
+export function jsonEquals(left, right) {
+    if (left === right) {
+        return true;
+    }
+    if (Array.isArray(left) || Array.isArray(right)) {
+        if (!Array.isArray(left) || !Array.isArray(right)) {
+            return false;
+        }
+        if (left.length !== right.length) {
+            return false;
+        }
+        return left.every((item, index) => {
+            const other = right[index];
+            return other !== undefined && jsonEquals(item, other);
+        });
+    }
+    if (isJsonObject(left) || isJsonObject(right)) {
+        if (!isJsonObject(left) || !isJsonObject(right)) {
+            return false;
+        }
+        const leftKeys = Object.keys(left).sort();
+        const rightKeys = Object.keys(right).sort();
+        if (leftKeys.length !== rightKeys.length) {
+            return false;
+        }
+        return leftKeys.every((key, index) => {
+            const otherKey = rightKeys[index];
+            return otherKey === key && jsonEquals(left[key], right[key]);
+        });
+    }
+    return false;
+}
+//# sourceMappingURL=json.js.map

package/dist/src/compiler/json.js.map

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

package/dist/src/compiler/link.d.ts

@@ -0,0 +1,18 @@
+import { type CompilerDiagnostic } from "./diagnostics.js";
+import type { LinkInput } from "./inputs.js";
+import type { JsonObject } from "./json.js";
+import type { WorkflowIR } from "../ir/model.js";
+export type LinkResult = {
+    readonly ok: true;
+    readonly workflow: JsonObject;
+    readonly json: string;
+    readonly ir: WorkflowIR;
+    readonly diagnostics: readonly CompilerDiagnostic[];
+} | {
+    readonly ok: false;
+    readonly diagnostics: readonly CompilerDiagnostic[];
+};
+export declare function link(input: LinkInput): LinkResult;
+export declare function linkOrThrow(input: LinkInput): Extract<LinkResult, {
+    readonly ok: true;
+}>;

package/dist/src/compiler/link.js

@@ -0,0 +1,84 @@
+import { formatDiagnostic, hasErrors } from "./diagnostics.js";
+import { stableStringify } from "./stable-json.js";
+import { generateN8nWorkflow } from "../generator/n8n-generator.js";
+import { parseN8nWorkflow } from "../parser/n8n-parser.js";
+import { CredentialIsolationPass } from "../passes/credential-isolation.js";
+import { DeterministicIdsPass } from "../passes/deterministic-ids.js";
+import { InlineSubworkflowsPass } from "../passes/inline-subworkflows.js";
+import { AutoLayoutPass } from "../passes/auto-layout.js";
+import { validateWorkflowIR } from "../validation/graph-integrity.js";
+export function link(input) {
+    const parsedEntry = parseN8nWorkflow(input.entry);
+    const diagnostics = [...parsedEntry.diagnostics];
+    const dependencies = new Map();
+    for (const [key, source] of Object.entries(input.dependencies ?? {})) {
+        const parsed = parseN8nWorkflow(source);
+        diagnostics.push(...parsed.diagnostics);
+        if (parsed.workflow !== undefined) {
+            addDependency(dependencies, key, parsed.workflow, diagnostics);
+            addDependency(dependencies, source.id, parsed.workflow, diagnostics);
+            addDependency(dependencies, parsed.workflow.name, parsed.workflow, diagnostics);
+        }
+    }
+    if (parsedEntry.workflow === undefined || hasErrors(diagnostics)) {
+        return { ok: false, diagnostics };
+    }
+    let current = parsedEntry.workflow;
+    diagnostics.push(...validateWorkflowIR(current, "pre-link-validation"));
+    if (hasErrors(diagnostics)) {
+        return { ok: false, diagnostics };
+    }
+    const passes = [
+        new InlineSubworkflowsPass(dependencies, input.options ?? {}),
+        new CredentialIsolationPass(input.options ?? {}),
+        new AutoLayoutPass(),
+        new DeterministicIdsPass()
+    ];
+    for (const pass of passes) {
+        const result = pass.run(current);
+        diagnostics.push(...result.diagnostics);
+        current = result.workflow;
+        if (hasErrors(result.diagnostics)) {
+            return { ok: false, diagnostics };
+        }
+    }
+    diagnostics.push(...validateWorkflowIR(current, "post-link-validation", {
+        requireNodeIds: true,
+        forbidBoundaryNodes: true,
+        forbidExecuteWorkflowNodes: true
+    }));
+    if (hasErrors(diagnostics)) {
+        return { ok: false, diagnostics };
+    }
+    const workflow = generateN8nWorkflow(current);
+    return {
+        ok: true,
+        workflow,
+        json: stableStringify(workflow),
+        ir: current,
+        diagnostics
+    };
+}
+export function linkOrThrow(input) {
+    const result = link(input);
+    if (result.ok) {
+        return result;
+    }
+    throw new Error(result.diagnostics.map(formatDiagnostic).join("\n"));
+}
+function addDependency(dependencies, key, workflow, diagnostics) {
+    const existing = dependencies.get(key);
+    if (existing !== undefined && existing.id !== workflow.id) {
+        diagnostics.push({
+            severity: "error",
+            pass: "dependency-map",
+            workflow: workflow.id,
+            cause: `dependency key "${key}" maps to both "${existing.id}" and "${workflow.id}"`,
+            invariant: "dependency keys must resolve deterministically",
+            suggestion: "use unique dependency aliases for workflow references"
+        });
+        return;
+    }
+    dependencies.set(key, workflow);
+}
+//# sourceMappingURL=link.js.map