@zuplo/editor 1.0.30627199824 → 1.0.30628139828

package/dist/adapters/memory-fs.d.ts

@@ -0,0 +1,44 @@
+import { type ChangeNotifier, type FileSystemPort } from "../ports.js";
+export interface MemoryFileSystemOptions {
+    /**
+     * The project to start from, as project-relative path → file content. Parent
+     * directories are implied and don't need listing.
+     */
+    files?: Record<string, string>;
+    /**
+     * Top-level directories whose changes are reported to `onChange` listeners.
+     * Defaults to the same set chokidar watches on Node, so the preview's
+     * live-reload behaviour matches the CLI's rather than being broader.
+     */
+    watchedDirs?: readonly string[];
+    /** Injectable clock, so tests can control mtimes. */
+    now?: () => Date;
+    /**
+     * The mtime the seeded project starts with. Defaults to now.
+     *
+     * Worth setting to a constant wherever the same seed is loaded more than
+     * once — a Worker builds one of these per isolate, and if each picked its own
+     * startup time, a client that read a file from one isolate would be told its
+     * save conflicts when it landed on another. The file it read and the file it
+     * is saving over are byte-identical; only the clock disagreed.
+     */
+    seedMtime?: Date;
+}
+export interface MemoryFileSystem extends FileSystemPort, ChangeNotifier {
+    /** Discards all edits and returns to the seeded project. */
+    reset(): void;
+}
+/**
+ * A `FileSystemPort` held entirely in memory — what the per-PR preview Worker
+ * runs against, since a Worker has no filesystem.
+ *
+ * Directories are implied by the paths of the files inside them, plus any
+ * created explicitly, which is enough for a project tree and avoids maintaining
+ * a parallel directory structure that could disagree with the files.
+ *
+ * It doubles as the `ChangeNotifier`: writes report themselves, so the SPA's
+ * live-reload path stays exercised in the preview instead of going quiet with
+ * no chokidar to drive it.
+ */
+export declare function createMemoryFileSystem(options?: MemoryFileSystemOptions): MemoryFileSystem;
+//# sourceMappingURL=memory-fs.d.ts.map

package/dist/adapters/memory-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-fs.d.ts","sourceRoot":"","sources":["../../src/adapters/memory-fs.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,cAAc,EAKpB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhC,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAEjB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc,EAAE,cAAc;IACtE,4DAA4D;IAC5D,KAAK,IAAI,IAAI,CAAC;CACf;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAwOlB"}

package/dist/adapters/memory-fs.js

@@ -0,0 +1,204 @@
+import { editorConfig } from "../constants.js";
+import { PathNotFoundError, toSafeSegments, } from "../ports.js";
+const decoder = new TextDecoder();
+/**
+ * A `FileSystemPort` held entirely in memory — what the per-PR preview Worker
+ * runs against, since a Worker has no filesystem.
+ *
+ * Directories are implied by the paths of the files inside them, plus any
+ * created explicitly, which is enough for a project tree and avoids maintaining
+ * a parallel directory structure that could disagree with the files.
+ *
+ * It doubles as the `ChangeNotifier`: writes report themselves, so the SPA's
+ * live-reload path stays exercised in the preview instead of going quiet with
+ * no chokidar to drive it.
+ */
+export function createMemoryFileSystem(options = {}) {
+    const { files: seed = {}, watchedDirs = editorConfig.watch.watchedDirs, now = () => new Date(), 
+    // One timestamp for the whole seed rather than one per file, so `reset()`
+    // restores the project exactly as it was first loaded.
+    seedMtime = now(), } = options;
+    const files = new Map();
+    /** Directories that exist without (yet) containing a file. */
+    const emptyDirs = new Map();
+    const listeners = new Set();
+    /** Canonicalises a path and refuses traversal, exactly as Node's adapter does. */
+    const key = (path) => toSafeSegments(path).join("/");
+    const parentOf = (path) => path.slice(0, Math.max(0, path.lastIndexOf("/")));
+    const isWatched = (path) => watchedDirs.some((dir) => path === dir || path.startsWith(`${dir}/`));
+    /**
+     * Announces a change the way chokidar does on Node — including for the
+     * editor's own saves, which also trip the real watcher.
+     */
+    const emit = (path) => {
+        if (!isWatched(path)) {
+            return;
+        }
+        for (const listener of listeners) {
+            listener(path);
+        }
+    };
+    /** True when anything lives under `path`, which is what makes it a directory. */
+    const hasChildren = (path) => {
+        const prefix = `${path}/`;
+        for (const filePath of files.keys()) {
+            if (filePath.startsWith(prefix)) {
+                return true;
+            }
+        }
+        for (const dirPath of emptyDirs.keys()) {
+            if (dirPath.startsWith(prefix)) {
+                return true;
+            }
+        }
+        return false;
+    };
+    const isDirectory = (path) => 
+    // The root always exists, even in an empty project.
+    path === "" || emptyDirs.has(path) || hasChildren(path);
+    /**
+     * Records `path` and its ancestors as directories.
+     *
+     * They're only remembered while empty: once a file sits inside, the file's
+     * own path is what makes the directory exist, and keeping a second record
+     * would let the two disagree.
+     */
+    const addDirs = (path, timestamp) => {
+        for (let dir = path; dir !== ""; dir = parentOf(dir)) {
+            if (!files.has(dir)) {
+                emptyDirs.set(dir, timestamp);
+            }
+        }
+    };
+    const write = (path, content, at) => {
+        const mtime = at ?? now();
+        // A file and a directory can't share a path, and the file wins — the same
+        // way writing over a directory on disk fails rather than merging.
+        emptyDirs.delete(path);
+        addDirs(parentOf(path), mtime);
+        files.set(path, { content, mtime });
+        return { type: "file", mtime };
+    };
+    const load = () => {
+        files.clear();
+        emptyDirs.clear();
+        for (const [path, content] of Object.entries(seed)) {
+            write(key(path), content, seedMtime);
+        }
+    };
+    load();
+    return {
+        onChange(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        reset() {
+            load();
+        },
+        // Every method below is `async` even though nothing here awaits: it makes a
+        // rejected promise the only way these fail, matching the Node adapter. A
+        // sync throw from `key()` on a traversal attempt would otherwise escape
+        // before the promise existed, and callers would have to guard both ways.
+        async readFileWithStat(path) {
+            const file = files.get(key(path));
+            if (!file) {
+                throw new PathNotFoundError(path);
+            }
+            // Content and mtime come from one immutable record, so they always
+            // describe the same version — the property the Node adapter needs an open
+            // file handle to get.
+            return {
+                content: typeof file.content === "string"
+                    ? file.content
+                    : decoder.decode(file.content),
+                mtime: file.mtime,
+            };
+        },
+        async listDir(path) {
+            const dir = key(path);
+            if (!isDirectory(dir)) {
+                throw new PathNotFoundError(path);
+            }
+            const prefix = dir === "" ? "" : `${dir}/`;
+            const entries = new Map();
+            const collect = (fullPath, type) => {
+                if (!fullPath.startsWith(prefix)) {
+                    return;
+                }
+                const rest = fullPath.slice(prefix.length);
+                if (rest === "") {
+                    return;
+                }
+                const slash = rest.indexOf("/");
+                // A path continuing past the first segment describes a grandchild, so
+                // the segment itself is a directory rather than the entry.
+                const name = slash === -1 ? rest : rest.slice(0, slash);
+                entries.set(name, {
+                    name,
+                    type: slash === -1 ? type : "directory",
+                });
+            };
+            for (const filePath of files.keys()) {
+                collect(filePath, "file");
+            }
+            for (const dirPath of emptyDirs.keys()) {
+                collect(dirPath, "directory");
+            }
+            return [...entries.values()];
+        },
+        async statPath(path) {
+            const target = key(path);
+            const file = files.get(target);
+            if (file) {
+                return { type: "file", mtime: file.mtime };
+            }
+            if (isDirectory(target)) {
+                return {
+                    type: "directory",
+                    mtime: emptyDirs.get(target) ?? now(),
+                };
+            }
+            return undefined;
+        },
+        async writeFile(path, content) {
+            const target = key(path);
+            const stat = write(target, content);
+            emit(target);
+            return stat;
+        },
+        async remove(path) {
+            const target = key(path);
+            if (!files.delete(target)) {
+                throw new PathNotFoundError(path);
+            }
+            // The parent may have just become empty, and an empty directory still
+            // exists on disk after its last file is deleted.
+            addDirs(parentOf(target), now());
+            emit(target);
+        },
+        async rename(from, to) {
+            const fromKey = key(from);
+            const toKey = key(to);
+            const file = files.get(fromKey);
+            if (!file) {
+                throw new PathNotFoundError(from);
+            }
+            files.delete(fromKey);
+            addDirs(parentOf(fromKey), now());
+            // Carries its mtime across, as a rename on disk does — the content didn't
+            // change, so a client holding a `Last-Modified` for it stays valid.
+            emptyDirs.delete(toKey);
+            addDirs(parentOf(toKey), file.mtime);
+            files.set(toKey, file);
+            emit(fromKey);
+            emit(toKey);
+        },
+        async mkdirp(path) {
+            const target = key(path);
+            if (target !== "") {
+                addDirs(target, now());
+            }
+        },
+    };
+}
+//# sourceMappingURL=memory-fs.js.map

package/dist/adapters/memory-fs.js.map

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

package/dist/adapters/memory-fs.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-fs.spec.d.ts.map

package/dist/adapters/memory-fs.spec.d.ts.map

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

package/dist/adapters/memory-fs.spec.js

@@ -0,0 +1,74 @@
+import assert from "node:assert";
+import { describe, it } from "node:test";
+import { createMemoryFileSystem } from "./memory-fs.js";
+const seed = {
+    "config/routes.oas.json": '{"openapi":"3.1.0"}',
+    "docs/introduction.md": "# Hello\n",
+};
+describe("createMemoryFileSystem", () => {
+    describe("seedMtime", () => {
+        // Two filesystems built from one seed stand in for two Worker isolates.
+        // Each builds its own copy of the project, and a client that reads a file
+        // from one may well save it back through the other — so if they disagree
+        // on the untouched file's mtime, that save is rejected as a conflict with
+        // bytes it matches exactly. Not hypothetical: it shipped, and every save
+        // in the preview deployment failed with 412.
+        it("gives the same mtime to every instance built from one seed", async () => {
+            const seedMtime = new Date("2026-01-02T03:04:05Z");
+            const first = createMemoryFileSystem({ files: seed, seedMtime });
+            const second = createMemoryFileSystem({ files: seed, seedMtime });
+            const fromFirst = await first.readFileWithStat("config/routes.oas.json");
+            const fromSecond = await second.readFileWithStat("config/routes.oas.json");
+            assert.strictEqual(fromFirst.mtime.getTime(), fromSecond.mtime.getTime(), "instances disagreed on the seeded mtime");
+            assert.strictEqual(fromFirst.mtime.getTime(), seedMtime.getTime());
+        });
+        it("gives every seeded file the same mtime", async () => {
+            const seedMtime = new Date("2026-01-02T03:04:05Z");
+            const fs = createMemoryFileSystem({ files: seed, seedMtime });
+            const routes = await fs.readFileWithStat("config/routes.oas.json");
+            const docs = await fs.readFileWithStat("docs/introduction.md");
+            assert.strictEqual(routes.mtime.getTime(), docs.mtime.getTime());
+        });
+        it("still stamps later writes with the clock, not the seed", async () => {
+            const seedMtime = new Date("2026-01-02T03:04:05Z");
+            const writeTime = new Date("2026-06-07T08:09:10Z");
+            const fs = createMemoryFileSystem({
+                files: seed,
+                seedMtime,
+                now: () => writeTime,
+            });
+            await fs.writeFile("docs/introduction.md", "# Edited\n");
+            const edited = await fs.readFileWithStat("docs/introduction.md");
+            assert.strictEqual(edited.mtime.getTime(), writeTime.getTime());
+        });
+        it("restores the seeded mtime on reset", async () => {
+            const seedMtime = new Date("2026-01-02T03:04:05Z");
+            const fs = createMemoryFileSystem({
+                files: seed,
+                seedMtime,
+                now: () => new Date("2026-06-07T08:09:10Z"),
+            });
+            await fs.writeFile("docs/introduction.md", "# Edited\n");
+            fs.reset();
+            const restored = await fs.readFileWithStat("docs/introduction.md");
+            assert.strictEqual(restored.content, seed["docs/introduction.md"]);
+            assert.strictEqual(restored.mtime.getTime(), seedMtime.getTime());
+        });
+        it("defaults to a single timestamp when none is given", async () => {
+            const fs = createMemoryFileSystem({ files: seed });
+            const routes = await fs.readFileWithStat("config/routes.oas.json");
+            const docs = await fs.readFileWithStat("docs/introduction.md");
+            assert.strictEqual(routes.mtime.getTime(), docs.mtime.getTime());
+        });
+    });
+    describe("listDir", () => {
+        // The root listing names each top-level entry once, rather than repeating
+        // paths of the files underneath it.
+        it("returns immediate children only", async () => {
+            const fs = createMemoryFileSystem({ files: seed });
+            const entries = await fs.listDir("/");
+            assert.deepStrictEqual(entries.map((entry) => `${entry.type}:${entry.name}`).sort(), ["directory:config", "directory:docs"]);
+        });
+    });
+});
+//# sourceMappingURL=memory-fs.spec.js.map

package/dist/adapters/memory-fs.spec.js.map

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

package/dist/adapters/memory-preferences.d.ts

@@ -0,0 +1,10 @@
+import type { EditorPreferencesPort } from "../ports.js";
+/**
+ * Keeps the user's external-editor choice in memory for the life of the process.
+ *
+ * Used by the preview Worker, which has no home directory to persist to. The
+ * preference dialog and toolbar behave correctly within a session; the choice is
+ * simply forgotten when the isolate recycles.
+ */
+export declare function createMemoryEditorPreferences(): EditorPreferencesPort;
+//# sourceMappingURL=memory-preferences.d.ts.map

package/dist/adapters/memory-preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-preferences.d.ts","sourceRoot":"","sources":["../../src/adapters/memory-preferences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,IAAI,qBAAqB,CAUrE"}

package/dist/adapters/memory-preferences.js

@@ -0,0 +1,18 @@
+/**
+ * Keeps the user's external-editor choice in memory for the life of the process.
+ *
+ * Used by the preview Worker, which has no home directory to persist to. The
+ * preference dialog and toolbar behave correctly within a session; the choice is
+ * simply forgotten when the isolate recycles.
+ */
+export function createMemoryEditorPreferences() {
+    let editor = null;
+    return {
+        get: () => Promise.resolve(editor),
+        set: (value) => {
+            editor = value;
+            return Promise.resolve();
+        },
+    };
+}
+//# sourceMappingURL=memory-preferences.js.map

package/dist/adapters/memory-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-preferences.js","sourceRoot":"","sources":["../../src/adapters/memory-preferences.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,GAA0B;IACrE,IAAI,MAAM,GAAkB,IAAI,CAAC;IAEjC,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAClC,GAAG,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC;YACtB,MAAM,GAAG,KAAK,CAAC;YACf,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAAA,CAC1B;KACF,CAAC;AAAA,CACH"}

package/dist/adapters/memory.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The platform-free adapters, collected so a consumer that must avoid `node:*`
+ * has a single import that is guaranteed not to reach it.
+ *
+ * The preview Worker imports from here rather than from the package root, which
+ * pulls in `LocalEditorServer` and with it `@hono/node-server` and chokidar.
+ */
+export { createMemoryFileSystem, type MemoryFileSystem, type MemoryFileSystemOptions, } from "./memory-fs.js";
+export { createMemoryEditorPreferences } from "./memory-preferences.js";
+//# sourceMappingURL=memory.d.ts.map

package/dist/adapters/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/adapters/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/adapters/memory.js

@@ -0,0 +1,10 @@
+/**
+ * The platform-free adapters, collected so a consumer that must avoid `node:*`
+ * has a single import that is guaranteed not to reach it.
+ *
+ * The preview Worker imports from here rather than from the package root, which
+ * pulls in `LocalEditorServer` and with it `@hono/node-server` and chokidar.
+ */
+export { createMemoryFileSystem, } from "./memory-fs.js";
+export { createMemoryEditorPreferences } from "./memory-preferences.js";
+//# sourceMappingURL=memory.js.map

package/dist/adapters/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/adapters/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,sBAAsB,GAGvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/adapters/node-fs.d.ts

@@ -0,0 +1,11 @@
+import { type FileSystemPort } from "../ports.js";
+/**
+ * A `FileSystemPort` over a real directory on disk — what the Zuplo CLI runs
+ * against.
+ *
+ * All the `node:fs` specifics the routes used to carry live here: joining onto
+ * the project root, the open-file-handle dance behind `readFileWithStat`, and
+ * translating `ENOENT` into `PathNotFoundError`.
+ */
+export declare function createNodeFileSystem(sourceDirectory: string): FileSystemPort;
+//# sourceMappingURL=node-fs.d.ts.map

package/dist/adapters/node-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-fs.d.ts","sourceRoot":"","sources":["../../src/adapters/node-fs.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EAKpB,MAAM,aAAa,CAAC;AAMrB;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,CAkI5E"}

package/dist/adapters/node-fs.js

@@ -0,0 +1,133 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { PathNotFoundError, toSafeSegments, } from "../ports.js";
+function isNotFound(err) {
+    return err.code === "ENOENT";
+}
+/**
+ * A `FileSystemPort` over a real directory on disk — what the Zuplo CLI runs
+ * against.
+ *
+ * All the `node:fs` specifics the routes used to carry live here: joining onto
+ * the project root, the open-file-handle dance behind `readFileWithStat`, and
+ * translating `ENOENT` into `PathNotFoundError`.
+ */
+export function createNodeFileSystem(sourceDirectory) {
+    /**
+     * Resolves a project-relative path to an absolute one.
+     *
+     * `toSafeSegments` has already refused anything containing `..`, so joining
+     * the segments can't escape `sourceDirectory` — the segments are rebuilt from
+     * the validated list rather than from the caller's string so that guarantee
+     * can't be sidestepped by a separator the split didn't expect.
+     */
+    const resolve = (relativePath) => path.join(sourceDirectory, ...toSafeSegments(relativePath));
+    return {
+        async readFileWithStat(relativePath) {
+            const fullPath = resolve(relativePath);
+            let handle;
+            try {
+                handle = await fs.open(fullPath, "r");
+            }
+            catch (err) {
+                if (isNotFound(err)) {
+                    throw new PathNotFoundError(relativePath);
+                }
+                throw err;
+            }
+            try {
+                // Both reads come from the same open handle, so the mtime returned
+                // can't describe a different version of the file than the content it
+                // accompanies. See `FileSystemPort.readFileWithStat`.
+                const stats = await handle.stat();
+                const content = await handle.readFile("utf-8");
+                return { content, mtime: stats.mtime };
+            }
+            finally {
+                await handle.close();
+            }
+        },
+        async listDir(relativePath) {
+            const fullPath = resolve(relativePath);
+            let entries;
+            try {
+                entries = await fs.readdir(fullPath, { withFileTypes: true });
+            }
+            catch (err) {
+                if (isNotFound(err)) {
+                    throw new PathNotFoundError(relativePath);
+                }
+                throw err;
+            }
+            // Anything that is neither a file nor a directory (sockets, devices, a
+            // symlink to nowhere) is dropped rather than guessed at — the editor has
+            // no way to display it.
+            return entries.flatMap((entry) => {
+                if (entry.isDirectory()) {
+                    return [{ name: entry.name, type: "directory" }];
+                }
+                if (entry.isFile()) {
+                    return [{ name: entry.name, type: "file" }];
+                }
+                return [];
+            });
+        },
+        async statPath(relativePath) {
+            try {
+                const stats = await fs.stat(resolve(relativePath));
+                if (stats.isDirectory()) {
+                    return { type: "directory", mtime: stats.mtime };
+                }
+                if (stats.isFile()) {
+                    return { type: "file", mtime: stats.mtime };
+                }
+                return undefined;
+            }
+            catch (err) {
+                if (isNotFound(err)) {
+                    return undefined;
+                }
+                throw err;
+            }
+        },
+        async writeFile(relativePath, content) {
+            const fullPath = resolve(relativePath);
+            await fs.mkdir(path.dirname(fullPath), { recursive: true });
+            await fs.writeFile(fullPath, content);
+            const stats = await fs.stat(fullPath);
+            return { type: "file", mtime: stats.mtime };
+        },
+        async rename(from, to) {
+            const fromPath = resolve(from);
+            const toPath = resolve(to);
+            // Renaming into a directory that doesn't exist yet is how the portal
+            // moves a file into a new folder, so create the destination's parents
+            // rather than failing.
+            await fs.mkdir(path.dirname(toPath), { recursive: true });
+            try {
+                await fs.rename(fromPath, toPath);
+            }
+            catch (err) {
+                if (isNotFound(err)) {
+                    throw new PathNotFoundError(from);
+                }
+                throw err;
+            }
+        },
+        async remove(relativePath) {
+            try {
+                await fs.unlink(resolve(relativePath));
+            }
+            catch (err) {
+                if (isNotFound(err)) {
+                    throw new PathNotFoundError(relativePath);
+                }
+                throw err;
+            }
+        },
+        async mkdirp(relativePath) {
+            await fs.mkdir(resolve(relativePath), { recursive: true });
+        },
+    };
+}
+//# sourceMappingURL=node-fs.js.map

package/dist/adapters/node-fs.js.map

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

package/dist/adapters/node-preferences.d.ts

@@ -0,0 +1,10 @@
+import type { EditorPreferencesPort } from "../ports.js";
+/**
+ * Stores the user's external-editor choice in `~/.config/zuplo/editor.json`, so
+ * it survives across CLI runs.
+ *
+ * This is deliberately outside the project directory and therefore outside
+ * `FileSystemPort` — it's a per-user setting, not part of the API being edited.
+ */
+export declare function createNodeEditorPreferences(): EditorPreferencesPort;
+//# sourceMappingURL=node-preferences.d.ts.map

package/dist/adapters/node-preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-preferences.d.ts","sourceRoot":"","sources":["../../src/adapters/node-preferences.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAYzD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAuBnE"}

package/dist/adapters/node-preferences.js

@@ -0,0 +1,38 @@
+import fs from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+function getZuploConfigDir() {
+    const xdgConfigHome = process.env.XDG_CONFIG_HOME ?? path.join(homedir(), ".config");
+    return path.join(xdgConfigHome, "zuplo");
+}
+function getEditorConfigPath() {
+    return path.join(getZuploConfigDir(), "editor.json");
+}
+/**
+ * Stores the user's external-editor choice in `~/.config/zuplo/editor.json`, so
+ * it survives across CLI runs.
+ *
+ * This is deliberately outside the project directory and therefore outside
+ * `FileSystemPort` — it's a per-user setting, not part of the API being edited.
+ */
+export function createNodeEditorPreferences() {
+    return {
+        async get() {
+            try {
+                const data = await fs.readFile(getEditorConfigPath(), "utf-8");
+                return JSON.parse(data).editor ?? null;
+            }
+            catch {
+                // No file yet, or something unparseable in it — either way the user has
+                // no usable preference, and failing the request would block the editor
+                // from loading over a cosmetic setting.
+                return null;
+            }
+        },
+        async set(editor) {
+            await fs.mkdir(getZuploConfigDir(), { recursive: true });
+            await fs.writeFile(getEditorConfigPath(), JSON.stringify({ editor }, null, 2), "utf-8");
+        },
+    };
+}
+//# sourceMappingURL=node-preferences.js.map

package/dist/adapters/node-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-preferences.js","sourceRoot":"","sources":["../../src/adapters/node-preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,SAAS,iBAAiB,GAAW;IACnC,MAAM,aAAa,GACjB,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AAAA,CAC1C;AAED,SAAS,mBAAmB,GAAW;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,aAAa,CAAC,CAAC;AAAA,CACtD;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,GAA0B;IACnE,OAAO;QACL,KAAK,CAAC,GAAG,GAA2B;YAClC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC/D,OAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAA6B,IAAI,IAAI,CAAC;YACjE,CAAC;YAAC,MAAM,CAAC;gBACP,0EAAwE;gBACxE,uEAAuE;gBACvE,wCAAwC;gBACxC,OAAO,IAAI,CAAC;YACd,CAAC;QAAA,CACF;QAED,KAAK,CAAC,GAAG,CAAC,MAAc,EAAiB;YACvC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,MAAM,EAAE,CAAC,SAAS,CAChB,mBAAmB,EAAE,EACrB,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EACnC,OAAO,CACR,CAAC;QAAA,CACH;KACF,CAAC;AAAA,CACH"}