visual-node 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+> **🤖 VIBE CODED.** This project was built end-to-end through AI-assisted ("vibe
+> coding") development sessions. Review the generated code before trusting it in
+> production, same as you would for any dependency.
+
+# visual-node
+
+Visual, node-based backend builder for Node.js. Drag-and-drop flows **compile** to real,
+readable, git-friendly Express.js source — this is a codegen tool, not a runtime
+interpreter. Nothing from this package ships inside the servers it generates.
+
+## Install & run
+
+```bash
+npx visual-node [projectDir]
+# or
+npm install -g visual-node
+visual-node [projectDir]
+```
+
+Opens an editor at `http://localhost:4000` against `projectDir` (defaults to the current
+directory). Build a flow, **Compile** it to a real Express server, **Run Server** to spawn
+and hit it right there, or just read the generated files yourself.
+
+## Environment variables
+
+| Variable | Default | Purpose |
+| --- | --- | --- |
+| `PORT` | `4000` | Port the editor listens on |
+| `FLOWSERVER_PROJECT_DIR` | current directory | Project directory (overridden by a CLI arg) |
+
+## Examples
+
+The source repository ships five worked examples under `examples/` — a minimal route, an
+in-memory REST API using Variables, a custom-middleware logger, a visual Function Graph
+with branching, and an npm-dependency example — each with its source flow and compiled
+output committed side by side.
+
+## What this is not
+
+Not a runtime interpreter (no Node-RED/n8n-style flow engine ships with generated
+servers), not a hosted service, and not a multi-tenant tool — it's a local, single-project
+codegen editor meant to hand you real source code you keep, read, and commit.

package/dist/app.d.ts

@@ -0,0 +1,3 @@
+import { type Express } from "express";
+import type { AppConfig } from "./config.js";
+export declare function buildApp(config: AppConfig): Express;

package/dist/app.js

@@ -0,0 +1,44 @@
+import express from "express";
+import cors from "cors";
+import { expressConnectMiddleware } from "@connectrpc/connect-express";
+import { registerNodeRegistryFlowRoutes } from "./connect/node-registry-flow.service.js";
+import { registerValidateGenerateRoutes } from "./connect/validate-generate.service.js";
+import { registerRunRoutes } from "./connect/run.service.js";
+import { registerFilesRoutes } from "./connect/files.service.js";
+import { registerCompileFunctionGraphRoutes } from "./connect/compile-function-graph.service.js";
+import { registerPluginsRoutes } from "./connect/plugins.service.js";
+import { serveStatic } from "./static.js";
+export function buildApp(config) {
+    const app = express();
+    app.use(cors());
+    // Buf Connect transport (gRPC / gRPC-Web / Connect protocol) — the only API surface as of
+    // Phase 8; see docs/phase8-backend-grpc-flatbuffers-plan.md. The REST routes this replaced
+    // (`routes/*.routes.ts`) were removed once parity was confirmed end-to-end. No
+    // `express.json()` is mounted: Connect owns its own body parsing entirely, and nothing
+    // else in this app reads `req.body`.
+    //
+    // All six service-group registrations share ONE router instance and use `router.rpc()`
+    // per method (not `router.service()`), since `router.service()` fills every method the
+    // service defines that's absent from its partial implementation with an "unimplemented"
+    // stub — calling it more than once per service on a shared router would let a later
+    // group's stub-fill silently overwrite an earlier group's real methods.
+    app.use(expressConnectMiddleware({
+        // editor-ui's dev server (vite.config.ts) only proxies "/api" to editor-server, and
+        // its browser Connect client (src/api/client.ts) is configured with `baseUrl: "/api"`
+        // to match — without this prefix, Connect requests would land at the Express app
+        // root (e.g. "/flowserver.v1.EditorService/GetNodeRegistry") and never reach this
+        // middleware through the dev proxy.
+        requestPathPrefix: "/api",
+        routes: (router) => {
+            registerNodeRegistryFlowRoutes(router, config);
+            registerValidateGenerateRoutes(router, config);
+            registerRunRoutes(router, config);
+            registerFilesRoutes(router, config);
+            registerCompileFunctionGraphRoutes(router, config);
+            registerPluginsRoutes(router, config);
+        },
+    }));
+    serveStatic(app);
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,OAAyB,MAAM,SAAS,CAAC;AAChD,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAEhB,0FAA0F;IAC1F,2FAA2F;IAC3F,+EAA+E;IAC/E,uFAAuF;IACvF,qCAAqC;IACrC,EAAE;IACF,uFAAuF;IACvF,uFAAuF;IACvF,wFAAwF;IACxF,oFAAoF;IACpF,wEAAwE;IACxE,GAAG,CAAC,GAAG,CACL,wBAAwB,CAAC;QACvB,oFAAoF;QACpF,sFAAsF;QACtF,iFAAiF;QACjF,kFAAkF;QAClF,oCAAoC;QACpC,iBAAiB,EAAE,MAAM;QACzB,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YACjB,8BAA8B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/C,8BAA8B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/C,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAClC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACpC,kCAAkC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACnD,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;KACF,CAAC,CACH,CAAC;IAEF,WAAW,CAAC,GAAG,CAAC,CAAC;IAEjB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/codegen-helpers.d.ts

@@ -0,0 +1,55 @@
+import { type Flow, type ProjectCompileResult, type ProjectFile, type ValidationError } from "@visual-node/core";
+export type CompileResult = {
+    valid: true;
+    code: string;
+} | {
+    valid: false;
+    errors: ValidationError[];
+};
+export declare function compile(flow: Flow): Promise<CompileResult>;
+export interface ProjectCompileFromDisk {
+    /** The raw, parsed `.blueprint` sources read from disk — same order as `result.files` when `result.valid`. */
+    sourceFiles: ProjectFile[];
+    result: ProjectCompileResult;
+}
+/**
+ * Reads every `.blueprint` file in the project, parses it, and runs core's project-wide
+ * `compileProject`. A read/parse failure on an individual file becomes a per-file error
+ * (excluded from the compiled batch) rather than 500ing the whole request. Shared by
+ * `/api/compile` and `/api/run/start` — both need "the whole project, compiled from disk",
+ * not just whatever flow happens to be open in the canvas.
+ */
+export declare function compileProjectFromDisk(projectDir: string): Promise<ProjectCompileFromDisk>;
+/**
+ * Finds the one file in the project responsible for starting the server — the file whose
+ * flow contains an "express.listen" node. That's the file "Run Server" needs to spawn;
+ * everything else (helpers required by it) just needs to be written to disk alongside it.
+ */
+export declare function findEntryFile(sourceFiles: ProjectFile[]): ProjectFile | {
+    error: string;
+};
+/**
+ * Writes (or merges into) a CommonJS package.json in `projectDir`. Required for the
+ * generated `server.js` (which uses `require`) to run correctly with plain
+ * `node server.js` — without it, an ancestor directory's "type": "module" (or no manifest
+ * at all) can make Node misidentify the file's module type. Declaring dependencies (not
+ * just omitting `type: module`) is what makes `npm install && node server.js` actually
+ * work, instead of leaving the user to guess what to install.
+ *
+ * Unlike the original write-once behavior, this now merges on every call: an existing
+ * package.json's fields (including any hand-edited `dependencies` entries) are preserved,
+ * `express` is added only if missing, and `options.dependencies` (the flow/project's
+ * collected npm-mode `logic.require`/Custom Code declarations — see
+ * `@visual-node/core`'s `collectFlowDependencies`/`collectProjectDependencies`) is merged in
+ * without ever downgrading/overwriting an already-pinned real version. A dependency
+ * key is only written/updated when it's currently absent or currently the placeholder
+ * `"*"` (an earlier compile's "unpinned" marker) — a real pinned version a user hand-edited
+ * in always wins.
+ */
+export declare function ensureCommonJsPackageJson(projectDir: string, name: string, options?: {
+    dependencies?: Record<string, string>;
+}): Promise<void>;
+export declare function nodeModulesInstalled(projectDir: string): Promise<{
+    installed: boolean;
+    missing: string[];
+}>;

package/dist/codegen-helpers.js

@@ -0,0 +1,142 @@
+import { access, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { compileProject, decodeFlow, emitExpress, formatCode, validateFlow, } from "@visual-node/core";
+import { listBlueprintFiles } from "./file-tree.js";
+const EXPRESS_DEPENDENCY_VERSION = "^4.19.2";
+export async function compile(flow) {
+    const validation = validateFlow(flow);
+    if (!validation.valid) {
+        return { valid: false, errors: validation.errors };
+    }
+    const { code } = emitExpress(flow);
+    const formatted = await formatCode(code);
+    return { valid: true, code: formatted };
+}
+/**
+ * Reads every `.blueprint` file in the project, parses it, and runs core's project-wide
+ * `compileProject`. A read/parse failure on an individual file becomes a per-file error
+ * (excluded from the compiled batch) rather than 500ing the whole request. Shared by
+ * `/api/compile` and `/api/run/start` — both need "the whole project, compiled from disk",
+ * not just whatever flow happens to be open in the canvas.
+ */
+export async function compileProjectFromDisk(projectDir) {
+    const blueprintRefs = await listBlueprintFiles(projectDir);
+    const files = [];
+    const readErrors = [];
+    for (const ref of blueprintRefs) {
+        const absolutePath = path.join(projectDir, ref.relativePath);
+        let raw;
+        try {
+            raw = await readFile(absolutePath);
+        }
+        catch (err) {
+            readErrors.push({ relativePath: ref.relativePath, message: `Failed to read file: ${err.message}` });
+            continue;
+        }
+        try {
+            const flow = decodeFlow(new Uint8Array(raw.buffer, raw.byteOffset, raw.byteLength));
+            files.push({ relativePath: ref.relativePath, flow });
+        }
+        catch (err) {
+            readErrors.push({ relativePath: ref.relativePath, message: `Failed to decode: ${err.message}` });
+        }
+    }
+    const result = await compileProject(files);
+    if (readErrors.length === 0)
+        return { sourceFiles: files, result };
+    if (result.valid)
+        return { sourceFiles: files, result: { valid: false, errors: readErrors } };
+    return { sourceFiles: files, result: { valid: false, errors: [...readErrors, ...result.errors] } };
+}
+/**
+ * Finds the one file in the project responsible for starting the server — the file whose
+ * flow contains an "express.listen" node. That's the file "Run Server" needs to spawn;
+ * everything else (helpers required by it) just needs to be written to disk alongside it.
+ */
+export function findEntryFile(sourceFiles) {
+    const candidates = sourceFiles.filter((f) => f.flow.nodes.some((n) => n.type === "express.listen"));
+    if (candidates.length === 0) {
+        return { error: 'No file in this project has an "express.listen" node yet — nothing to run.' };
+    }
+    if (candidates.length > 1) {
+        return {
+            error: `Multiple files call "express.listen" (${candidates
+                .map((f) => f.relativePath)
+                .join(", ")}) — only one entry file is supported.`,
+        };
+    }
+    return candidates[0];
+}
+async function pathExists(target) {
+    try {
+        await access(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Writes (or merges into) a CommonJS package.json in `projectDir`. Required for the
+ * generated `server.js` (which uses `require`) to run correctly with plain
+ * `node server.js` — without it, an ancestor directory's "type": "module" (or no manifest
+ * at all) can make Node misidentify the file's module type. Declaring dependencies (not
+ * just omitting `type: module`) is what makes `npm install && node server.js` actually
+ * work, instead of leaving the user to guess what to install.
+ *
+ * Unlike the original write-once behavior, this now merges on every call: an existing
+ * package.json's fields (including any hand-edited `dependencies` entries) are preserved,
+ * `express` is added only if missing, and `options.dependencies` (the flow/project's
+ * collected npm-mode `logic.require`/Custom Code declarations — see
+ * `@visual-node/core`'s `collectFlowDependencies`/`collectProjectDependencies`) is merged in
+ * without ever downgrading/overwriting an already-pinned real version. A dependency
+ * key is only written/updated when it's currently absent or currently the placeholder
+ * `"*"` (an earlier compile's "unpinned" marker) — a real pinned version a user hand-edited
+ * in always wins.
+ */
+export async function ensureCommonJsPackageJson(projectDir, name, options) {
+    const pkgPath = path.join(projectDir, "package.json");
+    let manifest;
+    if (await pathExists(pkgPath)) {
+        try {
+            const raw = await readFile(pkgPath, "utf8");
+            manifest = { ...JSON.parse(raw) };
+        }
+        catch {
+            manifest = { name, private: true };
+        }
+    }
+    else {
+        manifest = { name, private: true };
+    }
+    const dependencies = { ...(manifest.dependencies ?? {}) };
+    if (!dependencies.express) {
+        dependencies.express = EXPRESS_DEPENDENCY_VERSION;
+    }
+    for (const [pkg, version] of Object.entries(options?.dependencies ?? {})) {
+        if (!dependencies[pkg] || dependencies[pkg] === "*") {
+            dependencies[pkg] = version;
+        }
+    }
+    manifest.dependencies = dependencies;
+    await writeFile(pkgPath, JSON.stringify(manifest, null, 2) + "\n", "utf8");
+}
+export async function nodeModulesInstalled(projectDir) {
+    const pkgPath = path.join(projectDir, "package.json");
+    let dependencies = {};
+    try {
+        const raw = await readFile(pkgPath, "utf8");
+        dependencies = JSON.parse(raw).dependencies ?? {};
+    }
+    catch {
+        dependencies = {};
+    }
+    const missing = [];
+    for (const pkg of Object.keys(dependencies)) {
+        if (!(await pathExists(path.join(projectDir, "node_modules", pkg)))) {
+            missing.push(pkg);
+        }
+    }
+    return { installed: missing.length === 0, missing };
+}
+//# sourceMappingURL=codegen-helpers.js.map

package/dist/codegen-helpers.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export interface AppConfig {
+    projectDir: string;
+}
+/**
+ * Resolves the single project directory this server instance operates on:
+ * first CLI arg, then FLOWSERVER_PROJECT_DIR, then cwd. This is a local,
+ * single-project tool — no multi-project registry.
+ */
+export declare function resolveProjectDir(argv?: string[]): string;

package/dist/config.js

@@ -0,0 +1,13 @@
+import path from "node:path";
+/**
+ * Resolves the single project directory this server instance operates on:
+ * first CLI arg, then FLOWSERVER_PROJECT_DIR, then cwd. This is a local,
+ * single-project tool — no multi-project registry.
+ */
+export function resolveProjectDir(argv = process.argv.slice(2)) {
+    // `pnpm run dev -- <dir>` forwards a literal "--" through tsx watch into argv; skip it.
+    const fromArg = argv.find((a) => a !== "--");
+    const dir = fromArg ?? process.env.FLOWSERVER_PROJECT_DIR ?? process.cwd();
+    return path.resolve(dir);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,wFAAwF;IACxF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/connect/compile-function-graph.service.d.ts

@@ -0,0 +1,14 @@
+import type { ConnectRouter } from "@connectrpc/connect";
+import type { AppConfig } from "../config.js";
+/**
+ * Registers the `CompileProject`, `WriteCompiledProject`, and `PreviewFunctionGraph` RPCs
+ * from `EditorService` (see proto-gen's `editor_pb.ts` and
+ * docs/phase8-backend-grpc-flatbuffers-plan.md). Business logic is not duplicated here: every
+ * handler below is a thin Connect-shaped wrapper around the exact same helpers the REST routes
+ * call — `compileProjectFromDisk`/`ensureCommonJsPackageJson`
+ * (packages/editor-server/src/codegen-helpers.ts, also used by
+ * packages/editor-server/src/routes/compile.routes.ts) and `emitFunctionGraphBody`/
+ * `FunctionGraphError` (packages/core, also used by
+ * packages/editor-server/src/routes/function-graph.routes.ts).
+ */
+export declare function registerCompileFunctionGraphRoutes(router: ConnectRouter, config: AppConfig): ConnectRouter;

package/dist/connect/compile-function-graph.service.js

@@ -0,0 +1,106 @@
+import path from "node:path";
+import { EditorService } from "@visual-node/proto-gen";
+import { collectProjectDependencies, decodeFlow, emitFunctionGraphBody, FunctionGraphError, writeGeneratedFile, } from "@visual-node/core";
+import { compileProjectFromDisk, ensureCommonJsPackageJson } from "../codegen-helpers.js";
+/** Maps core/editor-server's `ProjectFileError` onto the generated `ValidationError` message init shape. */
+function toValidationErrorInit(err) {
+    return {
+        nodeId: err.nodeId ?? "",
+        blueprintNodeId: err.blueprintNodeId ?? "",
+        message: err.message,
+        relativePath: err.relativePath,
+    };
+}
+/**
+ * Registers the `CompileProject`, `WriteCompiledProject`, and `PreviewFunctionGraph` RPCs
+ * from `EditorService` (see proto-gen's `editor_pb.ts` and
+ * docs/phase8-backend-grpc-flatbuffers-plan.md). Business logic is not duplicated here: every
+ * handler below is a thin Connect-shaped wrapper around the exact same helpers the REST routes
+ * call — `compileProjectFromDisk`/`ensureCommonJsPackageJson`
+ * (packages/editor-server/src/codegen-helpers.ts, also used by
+ * packages/editor-server/src/routes/compile.routes.ts) and `emitFunctionGraphBody`/
+ * `FunctionGraphError` (packages/core, also used by
+ * packages/editor-server/src/routes/function-graph.routes.ts).
+ */
+export function registerCompileFunctionGraphRoutes(router, config) {
+    // POST /api/compile (preview) -> CompileProject. Mirrors compile.routes.ts's "/" handler:
+    // read+compile the whole project from disk, no request payload (the route operates on
+    // whatever's currently on disk, not on anything sent by the caller).
+    router.rpc(EditorService.method.compileProject, async () => {
+        const { result } = await compileProjectFromDisk(config.projectDir);
+        if (!result.valid) {
+            return { valid: false, results: [], errors: result.errors.map(toValidationErrorInit) };
+        }
+        return {
+            valid: true,
+            results: result.files.map((file) => ({ relativePath: file.relativePath, code: file.code })),
+            errors: [],
+        };
+    });
+    // POST /api/compile/write -> WriteCompiledProject. Mirrors compile.routes.ts's "/write"
+    // handler: recompute the same compile (no caching/reuse of a prior CompileProject call,
+    // exactly like the REST route recomputes on every write), then persist every file and
+    // ensure a CommonJS package.json exists.
+    router.rpc(EditorService.method.writeCompiledProject, async () => {
+        const { sourceFiles, result } = await compileProjectFromDisk(config.projectDir);
+        if (!result.valid) {
+            return { valid: false, written: false, files: [], errors: result.errors.map(toValidationErrorInit) };
+        }
+        for (const file of result.files) {
+            await writeGeneratedFile(path.join(config.projectDir, file.relativePath), file.code);
+        }
+        const { dependencies } = collectProjectDependencies(sourceFiles);
+        await ensureCommonJsPackageJson(config.projectDir, path.basename(config.projectDir) || "flowserver-app", {
+            dependencies,
+        });
+        return {
+            valid: true,
+            written: true,
+            files: result.files.map((file) => ({ relativePath: file.relativePath, outputPath: file.relativePath })),
+            errors: [],
+        };
+    });
+    // POST /api/function-graph/preview -> PreviewFunctionGraph. Mirrors
+    // function-graph.routes.ts: pure in-memory compile of a Function node's blueprint
+    // sub-graph, always resolves successfully (never throws a Connect error) — an
+    // incomplete/invalid graph is an expected, frequent state while a user is still wiring
+    // nodes together, surfaced via the response's `error` oneof branch instead.
+    //
+    // `PreviewFunctionGraphRequest.flatbuffer_flow` carries only a graph (`{ nodes, edges }`),
+    // not a full top-level `Flow` — it has no `meta`/`version` of its own. The caller is
+    // expected to have filled those in with placeholder values before calling `encodeFlow`
+    // (a full `Flow` is required to encode at all); `decodeFlow` here still returns a
+    // full `Flow` shape because it always parses the strict FlatBuffers envelope, but only
+    // `.nodes`/`.edges` carry real data for this RPC — `.meta`/`.version` are discarded.
+    router.rpc(EditorService.method.previewFunctionGraph, async (req) => {
+        try {
+            let nodes = [];
+            let edges = [];
+            if (req.flatbufferFlow && req.flatbufferFlow.length > 0) {
+                const flow = decodeFlow(req.flatbufferFlow);
+                nodes = flow.nodes;
+                edges = flow.edges;
+            }
+            const { code: body } = emitFunctionGraphBody({ nodes, edges });
+            return { result: { case: "body", value: body } };
+        }
+        catch (err) {
+            if (err instanceof FunctionGraphError) {
+                return {
+                    result: {
+                        case: "error",
+                        value: { message: err.message, blueprintNodeId: err.nodeId ?? "" },
+                    },
+                };
+            }
+            return {
+                result: {
+                    case: "error",
+                    value: { message: err instanceof Error ? err.message : String(err), blueprintNodeId: "" },
+                },
+            };
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=compile-function-graph.service.js.map

package/dist/connect/compile-function-graph.service.js.map

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

package/dist/connect/files.service.d.ts

@@ -0,0 +1,7 @@
+import { type ConnectRouter } from "@connectrpc/connect";
+import type { AppConfig } from "../config.js";
+/** Registers the file-tree CRUD RPCs on `router`. Uses `router.rpc()` per-method (not
+ * `router.service()`) so this registration only claims the seven methods it implements,
+ * leaving the rest of `EditorService` free for other registration modules to claim their
+ * own subset of methods on the same router without clobbering each other. */
+export declare function registerFilesRoutes(router: ConnectRouter, config: AppConfig): ConnectRouter;

package/dist/connect/files.service.js

@@ -0,0 +1,175 @@
+import { access, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { ConnectError, Code } from "@connectrpc/connect";
+import { decodeFlow, encodeFlow } from "@visual-node/core";
+import { EditorService, FileTreeNode_Kind } from "@visual-node/proto-gen";
+import { isPlausibleFlow } from "../flow-shape.js";
+import { listTree } from "../file-tree.js";
+import { resolveSafePath } from "../path-safety.js";
+function toProtoTree(nodes) {
+    return nodes.map((n) => n.type === "folder"
+        ? {
+            kind: FileTreeNode_Kind.FOLDER,
+            name: n.name,
+            relativePath: n.relativePath,
+            children: toProtoTree(n.children),
+        }
+        : { kind: FileTreeNode_Kind.FILE, name: n.name, relativePath: n.relativePath, children: [] });
+}
+async function pathExists(target) {
+    try {
+        await access(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Mirrors files.routes.ts's (unexported) `emptyBlueprint()`. */
+function emptyBlueprint(basename) {
+    return {
+        version: "1",
+        meta: { name: basename, target: "express" },
+        nodes: [],
+        edges: [],
+        variables: [],
+    };
+}
+function invalidPath() {
+    return new ConnectError("Invalid or missing path", Code.InvalidArgument);
+}
+/** Registers the file-tree CRUD RPCs on `router`. Uses `router.rpc()` per-method (not
+ * `router.service()`) so this registration only claims the seven methods it implements,
+ * leaving the rest of `EditorService` free for other registration modules to claim their
+ * own subset of methods on the same router without clobbering each other. */
+export function registerFilesRoutes(router, config) {
+    return router
+        .rpc(EditorService.method.listFiles, async () => {
+        const tree = await listTree(config.projectDir);
+        return { tree: toProtoTree(tree) };
+    })
+        .rpc(EditorService.method.createFolder, async (req) => {
+        const requestedPath = req.path;
+        const target = resolveSafePath(config.projectDir, requestedPath);
+        if (!target)
+            throw invalidPath();
+        if (await pathExists(target)) {
+            throw new ConnectError(`A file or folder already exists at "${requestedPath}"`, Code.AlreadyExists);
+        }
+        await mkdir(target, { recursive: true });
+        return { ok: true, path: requestedPath };
+    })
+        .rpc(EditorService.method.createBlueprint, async (req) => {
+        const requestedPath = req.path;
+        if (typeof requestedPath !== "string" || !requestedPath.endsWith(".blueprint")) {
+            throw new ConnectError('`path` must end in ".blueprint"', Code.InvalidArgument);
+        }
+        const target = resolveSafePath(config.projectDir, requestedPath);
+        if (!target)
+            throw invalidPath();
+        if (await pathExists(target)) {
+            throw new ConnectError(`A file already exists at "${requestedPath}"`, Code.AlreadyExists);
+        }
+        const basename = path.basename(requestedPath, ".blueprint");
+        const flow = emptyBlueprint(basename);
+        const flatbufferFlow = encodeFlow(flow);
+        await mkdir(path.dirname(target), { recursive: true });
+        await writeFile(target, flatbufferFlow);
+        return { ok: true, path: requestedPath, flatbufferFlow };
+    })
+        .rpc(EditorService.method.getBlueprint, async (req) => {
+        const requestedPath = req.path;
+        if (typeof requestedPath !== "string" || !requestedPath.endsWith(".blueprint")) {
+            throw new ConnectError('`path` must end in ".blueprint"', Code.InvalidArgument);
+        }
+        const target = resolveSafePath(config.projectDir, requestedPath);
+        if (!target)
+            throw invalidPath();
+        let raw;
+        try {
+            raw = await readFile(target);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                throw new ConnectError(`No file at "${requestedPath}"`, Code.NotFound);
+            }
+            throw err;
+        }
+        const flatbufferFlow = new Uint8Array(raw.buffer, raw.byteOffset, raw.byteLength);
+        let flow;
+        try {
+            flow = decodeFlow(flatbufferFlow);
+        }
+        catch (err) {
+            throw new ConnectError(`"${requestedPath}" could not be decoded: ${err.message}`, Code.Internal);
+        }
+        if (!isPlausibleFlow(flow)) {
+            throw new ConnectError(`"${requestedPath}" is not a valid flow`, Code.Internal);
+        }
+        return { flatbufferFlow };
+    })
+        .rpc(EditorService.method.saveBlueprint, async (req) => {
+        const requestedPath = req.path;
+        if (typeof requestedPath !== "string" || !requestedPath.endsWith(".blueprint")) {
+            throw new ConnectError('`path` must end in ".blueprint"', Code.InvalidArgument);
+        }
+        const target = resolveSafePath(config.projectDir, requestedPath);
+        if (!target)
+            throw invalidPath();
+        let flow;
+        try {
+            flow = decodeFlow(req.flatbufferFlow);
+        }
+        catch (err) {
+            throw new ConnectError(`\`flatbuffer_flow\` is not a valid encoded flow: ${err.message}`, Code.InvalidArgument);
+        }
+        if (!isPlausibleFlow(flow)) {
+            throw new ConnectError("`flatbuffer_flow` must decode to a flow with `nodes`, `edges`, and `meta`", Code.InvalidArgument);
+        }
+        await mkdir(path.dirname(target), { recursive: true });
+        // Write the exact bytes the client sent (already validated above), not a re-encode of
+        // the decoded Flow — this preserves byte-for-byte round-tripping and avoids a pointless
+        // decode+re-encode cycle now that wire format and disk format are the same thing.
+        await writeFile(target, req.flatbufferFlow);
+        return { ok: true };
+    })
+        .rpc(EditorService.method.renamePath, async (req) => {
+        const from = req.from;
+        const to = req.to;
+        const fromTarget = resolveSafePath(config.projectDir, from);
+        const toTarget = resolveSafePath(config.projectDir, to);
+        if (!fromTarget || !toTarget)
+            throw invalidPath();
+        if (!(await pathExists(fromTarget))) {
+            throw new ConnectError(`No file or folder at "${from}"`, Code.NotFound);
+        }
+        if (await pathExists(toTarget)) {
+            throw new ConnectError(`A file or folder already exists at "${to}"`, Code.AlreadyExists);
+        }
+        await mkdir(path.dirname(toTarget), { recursive: true });
+        await rename(fromTarget, toTarget);
+        return { ok: true };
+    })
+        .rpc(EditorService.method.deletePath, async (req) => {
+        const requestedPath = req.path;
+        const target = resolveSafePath(config.projectDir, requestedPath);
+        if (!target)
+            throw invalidPath();
+        let exists = true;
+        try {
+            await stat(target);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                exists = false;
+            else
+                throw err;
+        }
+        if (!exists) {
+            throw new ConnectError(`No file or folder at "${requestedPath}"`, Code.NotFound);
+        }
+        await rm(target, { recursive: true, force: false });
+        return { ok: true };
+    });
+}
+//# sourceMappingURL=files.service.js.map