@flow-as-code/cli 0.1.0

package/dist/watch.js

@@ -0,0 +1,293 @@
+/*
+ * Copyright 2026 The flow-as-code Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Watch engine: keeps <name>.flow.ts and <name>.flowdoc.json pairs in sync
+// inside one directory. A library, not a command: the studio server (A11)
+// consumes these events, and `flow-cli studio` will sit on top.
+//
+// Sync direction here is ts -> doc only. On a ts change the file is re-synthed
+// in the same sandboxed child process `flow-cli synth` uses, and the FlowDoc
+// is rewritten UNLESS the doc on disk was edited by someone else since this
+// watcher last wrote or observed it AND that edit does not carry the
+// sourceHash of the previous ts content. That state is dirty-both: the
+// watcher emits "conflict" and writes nothing. Never silently overwrite
+// (docs/01-flowdoc-spec.md, invariants 3 and the sourceHash dirty guard).
+//
+// One event is emitted for a change that alters nothing: a builder file edited
+// back to the exact bytes of the last successful sync, after a failed one.
+// Consumers latch "error" (the studio keeps a badge up until the document syncs
+// again), so a state that ends by being undone has to end with a "synced" or
+// the badge outlives the condition it reports.
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { watch as chokidarWatch } from "chokidar";
+import { serializeWithMeta, synthFile } from "./synth.js";
+const TS_SUFFIX = ".flow.ts";
+const DOC_SUFFIX = ".flowdoc.json";
+function hashHex(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+class Watcher {
+    listeners = new Map();
+    ledger = new Map();
+    /** Per-pair task chain so two changes to one pair never synth concurrently. */
+    chains = new Map();
+    fsWatcher;
+    dir;
+    closed = false;
+    constructor(dir) {
+        this.dir = resolve(dir);
+        // chokidar v5 takes no globs: watch the directory, filter paths here.
+        // awaitWriteFinish debounces editors' partial/atomic writes; the
+        // thresholds are far below the 1 second sync budget.
+        this.fsWatcher = chokidarWatch(this.dir, {
+            ignoreInitial: false,
+            depth: 0,
+            awaitWriteFinish: { stabilityThreshold: 50, pollInterval: 10 },
+        });
+        this.fsWatcher.on("add", (path) => this.route(path));
+        this.fsWatcher.on("change", (path) => this.route(path));
+        this.fsWatcher.on("error", (err) => {
+            this.emit("error", {
+                path: this.dir,
+                message: err instanceof Error ? err.message : String(err),
+            });
+        });
+        this.fsWatcher.on("ready", () => {
+            // Let the initial adds settle before declaring readiness.
+            void this.settled().then(() => {
+                if (!this.closed)
+                    this.emit("ready", {});
+            });
+        });
+    }
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (set === undefined) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return this;
+    }
+    off(event, listener) {
+        this.listeners.get(event)?.delete(listener);
+        return this;
+    }
+    once(event, listener) {
+        const wrapped = (payload) => {
+            this.off(event, wrapped);
+            listener(payload);
+        };
+        return this.on(event, wrapped);
+    }
+    noteWrite(name, contents) {
+        const entry = this.entry(name);
+        if (contents.tsContent !== undefined)
+            entry.lastTsHash = hashHex(contents.tsContent);
+        if (contents.docContent !== undefined)
+            entry.lastDocHash = hashHex(contents.docContent);
+    }
+    async close() {
+        this.closed = true;
+        await this.fsWatcher.close();
+        await this.settled();
+    }
+    emit(event, payload) {
+        for (const listener of [...(this.listeners.get(event) ?? [])]) {
+            listener(payload);
+        }
+    }
+    settled() {
+        return Promise.all([...this.chains.values()]).then(() => undefined);
+    }
+    route(path) {
+        const file = basename(path);
+        let name;
+        if (file.endsWith(TS_SUFFIX))
+            name = file.slice(0, -TS_SUFFIX.length);
+        else if (file.endsWith(DOC_SUFFIX))
+            name = file.slice(0, -DOC_SUFFIX.length);
+        if (name === undefined || name === "")
+            return;
+        this.enqueue(name, file.endsWith(TS_SUFFIX));
+    }
+    enqueue(name, tsChanged) {
+        const prev = this.chains.get(name) ?? Promise.resolve();
+        const next = prev.then(() => tsChanged ? this.handleTsChange(name) : this.handleDocChange(name));
+        // Keep the chain alive even if a handler slips an exception through.
+        this.chains.set(name, next.catch((e) => {
+            this.emit("error", {
+                path: join(this.dir, name + TS_SUFFIX),
+                message: e instanceof Error ? e.message : String(e),
+            });
+        }));
+    }
+    entry(name) {
+        let e = this.ledger.get(name);
+        if (e === undefined) {
+            e = {};
+            this.ledger.set(name, e);
+        }
+        return e;
+    }
+    /**
+     * A doc file appeared or changed. Our own writes echo back here and are
+     * recognized by hash; anything else is an external edit. The ledger keeps
+     * the last CLEAN state, so an external edit deliberately does not update
+     * it: the divergence is detected on the next ts change.
+     */
+    async handleDocChange(name) {
+        const entry = this.entry(name);
+        const docPath = join(this.dir, name + DOC_SUFFIX);
+        let bytes;
+        try {
+            bytes = await readFile(docPath);
+        }
+        catch {
+            return; // deleted between event and read; the next ts change re-creates it
+        }
+        const docHash = hashHex(bytes);
+        if (entry.lastDocHash === undefined) {
+            // First observation of this doc (startup scan or a doc that appeared
+            // before its ts): record it as the observed baseline.
+            entry.lastDocHash = docHash;
+        }
+        // Otherwise: external edit (or our own echo, which matches lastDocHash
+        // and needs nothing). Leave the ledger pointing at the clean state.
+    }
+    async handleTsChange(name) {
+        if (this.closed)
+            return;
+        const entry = this.entry(name);
+        const tsPath = join(this.dir, name + TS_SUFFIX);
+        const docPath = join(this.dir, name + DOC_SUFFIX);
+        let tsBytes;
+        try {
+            tsBytes = await readFile(tsPath);
+        }
+        catch {
+            return; // deleted between event and read
+        }
+        const tsHash = hashHex(tsBytes);
+        if (tsHash === entry.lastTsHash) {
+            // Normally an echo of our own write, or a touch: nothing to say. But it
+            // is also how a broken edit gets undone. Ctrl+Z back to the bytes we last
+            // synced from produces no synth and no event, so a consumer that latched
+            // the preceding `error` (the studio's "Code out of sync" badge) kept
+            // showing it until some unrelated edit happened. The doc on disk is still
+            // the one these bytes produced, so the pair IS in sync: say so.
+            if (entry.errored === true) {
+                entry.errored = false;
+                this.emit("synced", { tsPath, docPath, name });
+            }
+            return;
+        }
+        // Read the doc side to run the dirty guard.
+        let docBytes;
+        try {
+            docBytes = await readFile(docPath);
+        }
+        catch {
+            docBytes = undefined;
+        }
+        if (docBytes !== undefined) {
+            const docHash = hashHex(docBytes);
+            const docSourceHash = readSourceHash(docBytes);
+            if (entry.lastTsHash === undefined) {
+                // First look at this ts while a doc already exists (startup scan, or
+                // a pair dirty since startup). If the doc carries this ts content's
+                // hash the pair is in sync: baseline it without a synth. Anything
+                // else is dirty in an unknowable direction, so surface it instead of
+                // overwriting. Deliberately independent of lastDocHash: chokidar's
+                // initial add order (ts before doc or doc before ts) must not change
+                // the outcome.
+                if (docSourceHash === `sha256:${tsHash}`) {
+                    entry.lastDocHash = docHash;
+                    entry.lastTsHash = tsHash;
+                    return;
+                }
+                this.emit("conflict", {
+                    tsPath,
+                    docPath,
+                    name,
+                    reason: "doc exists but its meta.sourceHash does not match the ts content, and this " +
+                        "watcher has not seen the pair in sync; run `flow-cli synth` explicitly or " +
+                        "remove the stale side",
+                });
+                return;
+            }
+            const docChangedExternally = entry.lastDocHash !== undefined && docHash !== entry.lastDocHash;
+            if (docChangedExternally && docSourceHash !== `sha256:${entry.lastTsHash}`) {
+                // Dirty-both: the doc was edited externally (studio or hand edit)
+                // AND the ts changed. Never silently overwrite either side.
+                this.emit("conflict", {
+                    tsPath,
+                    docPath,
+                    name,
+                    reason: "both sides changed: the flowdoc was edited since the last sync " +
+                        "and the ts file changed too; resolve manually and re-save one side",
+                });
+                return;
+            }
+        }
+        // Clean (or doc missing): re-synth in the sandboxed child and write.
+        try {
+            const { flows, sourceHash } = await synthFile(tsPath);
+            const doc = pickDoc(flows, name);
+            if (doc === undefined) {
+                entry.errored = true;
+                this.emit("error", {
+                    path: tsPath,
+                    message: `${basename(tsPath)} exports ${flows.length} flows and none is named "${name}"; ` +
+                        `the watcher pairs ${name}${TS_SUFFIX} with ${name}${DOC_SUFFIX} by name`,
+                });
+                return;
+            }
+            const outBytes = serializeWithMeta(doc, sourceHash);
+            await writeFile(docPath, outBytes, "utf8");
+            entry.lastDocHash = hashHex(outBytes);
+            entry.lastTsHash = tsHash;
+            entry.errored = false;
+            this.emit("synced", { tsPath, docPath, name });
+        }
+        catch (e) {
+            entry.errored = true;
+            this.emit("error", { path: tsPath, message: e instanceof Error ? e.message : String(e) });
+        }
+    }
+}
+/**
+ * The flow whose name matches the file base name, else a lone export. Exported
+ * so the studio bridge pairs a builder file with its FlowDoc by exactly the
+ * rule the watcher uses, rather than a second one that could disagree.
+ */
+export function pickDoc(flows, name) {
+    const named = flows.find((f) => f.name === name);
+    if (named !== undefined)
+        return named.doc;
+    const only = flows.length === 1 ? flows[0] : undefined;
+    return only?.doc;
+}
+function readSourceHash(docBytes) {
+    try {
+        const doc = JSON.parse(docBytes.toString("utf8"));
+        const hash = doc.meta?.sourceHash;
+        return typeof hash === "string" ? hash : undefined;
+    }
+    catch {
+        return undefined; // unparseable doc counts as an external edit with no provenance
+    }
+}
+/**
+ * Watches `dir` (non-recursive) and keeps every <name>.flow.ts /
+ * <name>.flowdoc.json pair in sync, ts -> doc, with the sourceHash dirty
+ * guard described at the top of this file.
+ */
+export function createWatcher(dir) {
+    return new Watcher(dir);
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map

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

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@flow-as-code/cli",
+  "version": "0.1.0",
+  "description": "CLI over @flow-as-code/core: lint, codegen, synth, render, emit, the local studio server, and export, simulate, and diff against a live Amazon Connect instance.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./synth": {
+      "types": "./dist/synth.d.ts",
+      "import": "./dist/synth.js"
+    },
+    "./watch": {
+      "types": "./dist/watch.d.ts",
+      "import": "./dist/watch.js"
+    },
+    "./bridge": {
+      "types": "./dist/bridge/server.d.ts",
+      "import": "./dist/bridge/server.js"
+    }
+  },
+  "bin": {
+    "flow-cli": "dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "schema",
+    "!**/*.test.ts",
+    "!**/*.test.tsx",
+    "!**/__fixtures__",
+    "!**/__generated__",
+    "!**/*.tsbuildinfo",
+    "!**/__snapshots__",
+    "!**/*.snap",
+    "!**/test-helpers.ts",
+    "!**/test-helpers.tsx"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.12"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "node ../../scripts/chmod-bins.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@flow-as-code/cdk": "0.1.0",
+    "@flow-as-code/core": "0.1.0",
+    "@flow-as-code/studio": "0.1.0",
+    "@flow-as-code/tf": "0.1.0",
+    "ajv": "^8.20.0",
+    "chokidar": "^5.0.0",
+    "commander": "^14.0.3",
+    "tsx": "^4.23.13",
+    "yaml": "^2.9.0"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-connect": "^3.600.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-connect": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flow-as-code/flow-as-code.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/flow-as-code/flow-as-code/tree/main/packages/cli#readme",
+  "bugs": {
+    "url": "https://github.com/flow-as-code/flow-as-code/issues"
+  }
+}