@sebbro/paraglide-lite 0.1.0

package/dist/services/file-handling/write-output.js

@@ -0,0 +1,157 @@
+import path from "node:path";
+import { hashOutputContents, hashContent } from "./content-hash.js";
+export async function writeOutput(args) {
+    const currentOutputHashes = hashOutput(args.output, args.directory);
+    // if the output hasn't changed, don't write it
+    const changedFiles = new Set();
+    for (const [filePath, hash] of Object.entries(currentOutputHashes)) {
+        if (args.previousOutputHashes?.[filePath] !== hash) {
+            changedFiles.add(filePath);
+        }
+    }
+    // Find files that have been removed in the current output
+    const filesToDelete = new Set();
+    if (args.previousOutputHashes) {
+        for (const filePath of Object.keys(args.previousOutputHashes)) {
+            if (!currentOutputHashes[filePath]) {
+                filesToDelete.add(filePath);
+            }
+        }
+    }
+    if (changedFiles.size === 0 && filesToDelete.size === 0) {
+        return currentOutputHashes;
+    }
+    // clear the output directory
+    //
+    // disabled because of https://github.com/opral/inlang-paraglide-js/issues/350
+    // and re-enabled because of https://github.com/opral/inlang-paraglide-js/issues/420
+    if (args.cleanDirectory) {
+        await args.fs.rm(args.directory, { recursive: true, force: true });
+    }
+    else {
+        await args.fs.mkdir(args.directory, { recursive: true });
+    }
+    // Delete files that have been removed
+    // ignore if cleanDirectory is true because the directory will be cleaned anyway
+    if (filesToDelete.size > 0 && !args.cleanDirectory) {
+        await deleteRemovedFiles(args.fs, args.directory, filesToDelete);
+    }
+    //Create missing directories inside the output directory
+    await Promise.allSettled(Object.keys(args.output).map(async (filePath) => {
+        const fullPath = path.resolve(args.directory, filePath);
+        const directory = path.dirname(fullPath);
+        await args.fs.mkdir(directory, { recursive: true });
+    }));
+    //Write files
+    await Promise.allSettled(Object.entries(args.output).map(async ([filePath, fileContent]) => {
+        if (!changedFiles.has(filePath)) {
+            return;
+        }
+        const fullPath = path.resolve(args.directory, filePath);
+        await args.fs.writeFile(fullPath, fileContent);
+    }));
+    //Only update the previousOutputHashes if the write was successful
+    return currentOutputHashes;
+}
+/**
+ * Delete files that have been removed and clean up empty directories
+ */
+async function deleteRemovedFiles(fs, baseDirectory, filesToDelete) {
+    // Collect directories that might need cleanup
+    const potentialEmptyDirs = new Set();
+    // First pass: delete all files and collect parent directories
+    await Promise.allSettled(Array.from(filesToDelete).map(async (filePath) => {
+        const fullPath = path.resolve(baseDirectory, filePath);
+        try {
+            await fs.unlink(fullPath);
+            // Add parent directory for potential cleanup
+            const dirPath = path.dirname(fullPath);
+            if (dirPath !== baseDirectory) {
+                potentialEmptyDirs.add(dirPath);
+            }
+        }
+        catch {
+            // Ignore errors if the file doesn't exist
+        }
+    }));
+    // Second pass: clean up empty directories, starting from deepest paths
+    const sortedDirs = Array.from(potentialEmptyDirs).sort((a, b) => b.length - a.length);
+    for (const dirPath of sortedDirs) {
+        // Only process directories within the base directory
+        if (!dirPath.startsWith(baseDirectory) || dirPath === baseDirectory) {
+            continue;
+        }
+        try {
+            const dirContents = await fs.readdir(dirPath);
+            if (dirContents.length === 0) {
+                await fs.rmdir(dirPath);
+                // Add parent directory for potential cleanup
+                const parentDir = path.dirname(dirPath);
+                if (parentDir !== baseDirectory) {
+                    sortedDirs.push(parentDir);
+                }
+            }
+        }
+        catch {
+            // Ignore errors during directory cleanup
+        }
+    }
+}
+function hashOutput(output, outputDirectory) {
+    return hashOutputContents(output, (filePath, fileContent) => fileContent + path.resolve(outputDirectory, filePath));
+}
+/**
+ * Walk an existing output directory and produce the same hash map that
+ * {@link writeOutput} would have returned on a previous compile.
+ *
+ * Used by the bundler plugins to seed `previousCompilation` on a fresh
+ * process so the first compile's diff against unchanged inputs is empty
+ * and `writeOutput` short-circuits — letting us avoid wiping the directory
+ * out from under concurrent SSR/prerender readers (#659).
+ *
+ * Returns `undefined` if the directory does not exist. Keys are
+ * forward-slash relative paths to match {@link hashOutput}.
+ */
+export async function hashDirectory(directory, fs) {
+    try {
+        const stat = await fs.stat(directory);
+        if (!stat.isDirectory())
+            return undefined;
+    }
+    catch {
+        return undefined;
+    }
+    const hashes = {};
+    async function walk(currentDir, relativePrefix) {
+        let entries;
+        try {
+            entries = await fs.readdir(currentDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const entryAbsolutePath = path.resolve(currentDir, entry.name);
+            const relativePath = relativePrefix
+                ? `${relativePrefix}/${entry.name}`
+                : entry.name;
+            if (entry.isDirectory()) {
+                await walk(entryAbsolutePath, relativePath);
+            }
+            else if (entry.isFile()) {
+                try {
+                    const fileContent = await fs.readFile(entryAbsolutePath, "utf-8");
+                    const combinedContent = fileContent + path.resolve(directory, relativePath);
+                    hashes[relativePath] = hashContent(combinedContent);
+                }
+                catch {
+                    // Another compiler process may be rewriting this file. A partial
+                    // seed is safe; the following compile will repair missing outputs.
+                }
+            }
+        }
+    }
+    await walk(directory, "");
+    return hashes;
+}
+//# sourceMappingURL=write-output.js.map

package/dist/services/file-handling/write-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-output.js","sourceRoot":"","sources":["../../../src/services/file-handling/write-output.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"node:path\";\nimport type nodeFs from \"node:fs/promises\";\nimport { hashOutputContents, hashContent } from \"./content-hash.js\";\n\nexport async function writeOutput(args: {\n\tdirectory: string;\n\toutput: Record<string, string>;\n\tcleanDirectory?: boolean;\n\tfs: typeof nodeFs;\n\tpreviousOutputHashes?: Record<string, string>;\n}) {\n\tconst currentOutputHashes = hashOutput(args.output, args.directory);\n\n\t// if the output hasn't changed, don't write it\n\tconst changedFiles = new Set();\n\n\tfor (const [filePath, hash] of Object.entries(currentOutputHashes)) {\n\t\tif (args.previousOutputHashes?.[filePath] !== hash) {\n\t\t\tchangedFiles.add(filePath);\n\t\t}\n\t}\n\n\t// Find files that have been removed in the current output\n\tconst filesToDelete = new Set<string>();\n\tif (args.previousOutputHashes) {\n\t\tfor (const filePath of Object.keys(args.previousOutputHashes)) {\n\t\t\tif (!currentOutputHashes[filePath]) {\n\t\t\t\tfilesToDelete.add(filePath);\n\t\t\t}\n\t\t}\n\t}\n\n\tif (changedFiles.size === 0 && filesToDelete.size === 0) {\n\t\treturn currentOutputHashes;\n\t}\n\n\t// clear the output directory\n\t//\n\t// disabled because of https://github.com/opral/inlang-paraglide-js/issues/350\n\t// and re-enabled because of https://github.com/opral/inlang-paraglide-js/issues/420\n\tif (args.cleanDirectory) {\n\t\tawait args.fs.rm(args.directory, { recursive: true, force: true });\n\t} else {\n\t\tawait args.fs.mkdir(args.directory, { recursive: true });\n\t}\n\t// Delete files that have been removed\n\t// ignore if cleanDirectory is true because the directory will be cleaned anyway\n\tif (filesToDelete.size > 0 && !args.cleanDirectory) {\n\t\tawait deleteRemovedFiles(args.fs, args.directory, filesToDelete);\n\t}\n\n\t//Create missing directories inside the output directory\n\tawait Promise.allSettled(\n\t\tObject.keys(args.output).map(async (filePath) => {\n\t\t\tconst fullPath = path.resolve(args.directory, filePath);\n\t\t\tconst directory = path.dirname(fullPath);\n\t\t\tawait args.fs.mkdir(directory, { recursive: true });\n\t\t})\n\t);\n\n\t//Write files\n\tawait Promise.allSettled(\n\t\tObject.entries(args.output).map(async ([filePath, fileContent]) => {\n\t\t\tif (!changedFiles.has(filePath)) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst fullPath = path.resolve(args.directory, filePath);\n\t\t\tawait args.fs.writeFile(fullPath, fileContent);\n\t\t})\n\t);\n\n\t//Only update the previousOutputHashes if the write was successful\n\treturn currentOutputHashes;\n}\n\n/**\n * Delete files that have been removed and clean up empty directories\n */\nasync function deleteRemovedFiles(\n\tfs: typeof nodeFs,\n\tbaseDirectory: string,\n\tfilesToDelete: Set<string>\n) {\n\t// Collect directories that might need cleanup\n\tconst potentialEmptyDirs = new Set<string>();\n\n\t// First pass: delete all files and collect parent directories\n\tawait Promise.allSettled(\n\t\tArray.from(filesToDelete).map(async (filePath) => {\n\t\t\tconst fullPath = path.resolve(baseDirectory, filePath);\n\t\t\ttry {\n\t\t\t\tawait fs.unlink(fullPath);\n\n\t\t\t\t// Add parent directory for potential cleanup\n\t\t\t\tconst dirPath = path.dirname(fullPath);\n\t\t\t\tif (dirPath !== baseDirectory) {\n\t\t\t\t\tpotentialEmptyDirs.add(dirPath);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Ignore errors if the file doesn't exist\n\t\t\t}\n\t\t})\n\t);\n\n\t// Second pass: clean up empty directories, starting from deepest paths\n\tconst sortedDirs = Array.from(potentialEmptyDirs).sort(\n\t\t(a, b) => b.length - a.length\n\t);\n\n\tfor (const dirPath of sortedDirs) {\n\t\t// Only process directories within the base directory\n\t\tif (!dirPath.startsWith(baseDirectory) || dirPath === baseDirectory) {\n\t\t\tcontinue;\n\t\t}\n\n\t\ttry {\n\t\t\tconst dirContents = await fs.readdir(dirPath);\n\t\t\tif (dirContents.length === 0) {\n\t\t\t\tawait fs.rmdir(dirPath);\n\n\t\t\t\t// Add parent directory for potential cleanup\n\t\t\t\tconst parentDir = path.dirname(dirPath);\n\t\t\t\tif (parentDir !== baseDirectory) {\n\t\t\t\t\tsortedDirs.push(parentDir);\n\t\t\t\t}\n\t\t\t}\n\t\t} catch {\n\t\t\t// Ignore errors during directory cleanup\n\t\t}\n\t}\n}\n\nfunction hashOutput(\n\toutput: Record<string, string>,\n\toutputDirectory: string\n): Record<string, string> {\n\treturn hashOutputContents(\n\t\toutput,\n\t\t(filePath, fileContent) =>\n\t\t\tfileContent + path.resolve(outputDirectory, filePath)\n\t);\n}\n\n/**\n * Walk an existing output directory and produce the same hash map that\n * {@link writeOutput} would have returned on a previous compile.\n *\n * Used by the bundler plugins to seed `previousCompilation` on a fresh\n * process so the first compile's diff against unchanged inputs is empty\n * and `writeOutput` short-circuits — letting us avoid wiping the directory\n * out from under concurrent SSR/prerender readers (#659).\n *\n * Returns `undefined` if the directory does not exist. Keys are\n * forward-slash relative paths to match {@link hashOutput}.\n */\nexport async function hashDirectory(\n\tdirectory: string,\n\tfs: typeof nodeFs\n): Promise<Record<string, string> | undefined> {\n\ttry {\n\t\tconst stat = await fs.stat(directory);\n\t\tif (!stat.isDirectory()) return undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n\n\tconst hashes: Record<string, string> = {};\n\n\tasync function walk(currentDir: string, relativePrefix: string) {\n\t\tlet entries;\n\t\ttry {\n\t\t\tentries = await fs.readdir(currentDir, { withFileTypes: true });\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\t\tfor (const entry of entries) {\n\t\t\tconst entryAbsolutePath = path.resolve(currentDir, entry.name);\n\t\t\tconst relativePath = relativePrefix\n\t\t\t\t? `${relativePrefix}/${entry.name}`\n\t\t\t\t: entry.name;\n\t\t\tif (entry.isDirectory()) {\n\t\t\t\tawait walk(entryAbsolutePath, relativePath);\n\t\t\t} else if (entry.isFile()) {\n\t\t\t\ttry {\n\t\t\t\t\tconst fileContent = await fs.readFile(entryAbsolutePath, \"utf-8\");\n\t\t\t\t\tconst combinedContent =\n\t\t\t\t\t\tfileContent + path.resolve(directory, relativePath);\n\t\t\t\t\thashes[relativePath] = hashContent(combinedContent);\n\t\t\t\t} catch {\n\t\t\t\t\t// Another compiler process may be rewriting this file. A partial\n\t\t\t\t\t// seed is safe; the following compile will repair missing outputs.\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tawait walk(directory, \"\");\n\treturn hashes;\n}\n"]}

package/dist/services/file-handling/write-output.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/file-handling/write-output.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-output.test.d.ts","sourceRoot":"","sources":["../../../src/services/file-handling/write-output.test.ts"],"names":[],"mappings":""}

package/dist/services/file-handling/write-output.test.js

@@ -0,0 +1,217 @@
+import memfs from "memfs";
+import { test, expect, vi, beforeEach } from "vitest";
+beforeEach(() => {
+    vi.resetModules();
+});
+test("should write the output to a non-existing directory", async () => {
+    const { writeOutput } = await import("./write-output.js");
+    const fs = mockFs({});
+    await writeOutput({
+        directory: "/output",
+        output: { "test.txt": "test" },
+        fs,
+    });
+    expect(await fs.readFile("/output/test.txt", { encoding: "utf-8" })).toBe("test");
+});
+test("should clear & overwrite output that's already there", async () => {
+    const { writeOutput } = await import("./write-output.js");
+    const fs = mockFs({
+        "/output/test.txt": "old",
+        "/output/other.txt": "other",
+    });
+    await writeOutput({
+        directory: "/output",
+        output: { "test.txt": "new" },
+        cleanDirectory: true,
+        fs,
+    });
+    expect(await fs.readFile("/output/test.txt", { encoding: "utf-8" })).toBe("new");
+    await expect(async () => await fs.readFile("/output/other.txt", { encoding: "utf-8" })).rejects.toBeDefined();
+});
+test("should create any missing directories", async () => {
+    const { writeOutput } = await import("./write-output.js");
+    const fs = mockFs({});
+    await writeOutput({
+        directory: "/output/messages",
+        output: {
+            "de/test.txt": "de",
+            "en/test.txt": "en",
+        },
+        fs,
+    });
+    expect(await fs.readFile("/output/messages/de/test.txt", { encoding: "utf-8" })).toBe("de");
+    expect(await fs.readFile("/output/messages/en/test.txt", { encoding: "utf-8" })).toBe("en");
+});
+test("should only write once if the output hasn't changed", async () => {
+    const { writeOutput } = await import("./write-output.js");
+    const fs = mockFs({});
+    const writeFileSpy = vi.spyOn(fs, "writeFile");
+    const hashes = await writeOutput({
+        directory: "/output",
+        output: { "test.txt": "test" },
+        fs,
+    });
+    const hashes2 = await writeOutput({
+        directory: "/output",
+        output: { "test.txt": "test" },
+        fs,
+        previousOutputHashes: hashes,
+    });
+    expect(hashes).toEqual(hashes2);
+    expect(await fs.readFile("/output/test.txt", { encoding: "utf-8" })).toBe("test");
+    expect(writeFileSpy).toHaveBeenCalledTimes(1);
+});
+test("should write again if the output has changed", async () => {
+    const { writeOutput } = await import("./write-output.js");
+    const fs = mockFs({});
+    const writeFileSpy = vi.spyOn(fs, "writeFile");
+    const hashes = await writeOutput({
+        directory: "/output",
+        output: { "test.txt": "test" },
+        fs,
+    });
+    await writeOutput({
+        directory: "/output",
+        output: { "test.txt": "test2" },
+        fs,
+        previousOutputHashes: hashes,
+    });
+    expect(await fs.readFile("/output/test.txt", { encoding: "utf-8" })).toBe("test2");
+    expect(writeFileSpy).toHaveBeenCalledTimes(2);
+});
+test("should write files if output has partially changed", async () => {
+    const { writeOutput } = await import("./write-output.js");
+    const fs = mockFs({});
+    const writeFileSpy = vi.spyOn(fs, "writeFile");
+    const hashes = await writeOutput({
+        directory: "/output",
+        output: { "file1.txt": "test", "file2.txt": "test" },
+        fs,
+    });
+    await writeOutput({
+        directory: "/output",
+        output: { "file1.txt": "test", "file2.txt": "test2" },
+        fs,
+        previousOutputHashes: hashes,
+    });
+    expect(writeFileSpy).toHaveBeenCalledWith("/output/file2.txt", "test2");
+    expect(writeFileSpy).toHaveBeenCalledTimes(3);
+});
+test("should delete files that have been removed from the output", async () => {
+    const { writeOutput } = await import("./write-output.js");
+    const fs = mockFs({});
+    // First write with three files
+    const hashes = await writeOutput({
+        directory: "/output",
+        output: {
+            "file1.txt": "content1",
+            "file2.txt": "content2",
+            "subdir/file3.txt": "content3",
+        },
+        fs,
+    });
+    // Verify all files were written
+    expect(await fs.readFile("/output/file1.txt", { encoding: "utf-8" })).toBe("content1");
+    expect(await fs.readFile("/output/file2.txt", { encoding: "utf-8" })).toBe("content2");
+    expect(await fs.readFile("/output/subdir/file3.txt", { encoding: "utf-8" })).toBe("content3");
+    // Second write with file2.txt removed
+    await writeOutput({
+        directory: "/output",
+        output: {
+            "file1.txt": "content1",
+            "subdir/file3.txt": "content3updated",
+        },
+        fs,
+        previousOutputHashes: hashes,
+    });
+    // Verify file1.txt still exists
+    expect(await fs.readFile("/output/file1.txt", { encoding: "utf-8" })).toBe("content1");
+    // Verify file2.txt has been deleted
+    await expect(async () => await fs.readFile("/output/file2.txt", { encoding: "utf-8" })).rejects.toBeDefined();
+    // Verify file3.txt was updated
+    expect(await fs.readFile("/output/subdir/file3.txt", { encoding: "utf-8" })).toBe("content3updated");
+    // Get the new hashes
+    const newHashes = await writeOutput({
+        directory: "/output",
+        output: {
+            "file1.txt": "content1",
+            "subdir/file3.txt": "content3updated",
+        },
+        fs,
+        previousOutputHashes: hashes,
+    });
+    // Third write with subdir/file3.txt removed
+    await writeOutput({
+        directory: "/output",
+        output: {
+            "file1.txt": "content1",
+        },
+        fs,
+        previousOutputHashes: newHashes,
+    });
+    // Verify file1.txt still exists
+    expect(await fs.readFile("/output/file1.txt", { encoding: "utf-8" })).toBe("content1");
+    // Verify subdir/file3.txt has been deleted
+    await expect(async () => await fs.readFile("/output/subdir/file3.txt", { encoding: "utf-8" })).rejects.toBeDefined();
+    // Verify the subdir directory has also been removed
+    await expect(async () => await fs.readdir("/output/subdir")).rejects.toBeDefined();
+});
+test("hashDirectory matches the hashes writeOutput returns", async () => {
+    const { writeOutput, hashDirectory } = await import("./write-output.js");
+    const fs = mockFs({});
+    const output = {
+        "a.txt": "alpha",
+        "nested/b.txt": "beta",
+        "nested/deep/c.txt": "gamma",
+    };
+    const writtenHashes = await writeOutput({
+        directory: "/output",
+        output,
+        fs,
+    });
+    const seededHashes = await hashDirectory("/output", fs);
+    expect(seededHashes).toEqual(writtenHashes);
+});
+test("hashDirectory returns undefined when directory does not exist", async () => {
+    const { hashDirectory } = await import("./write-output.js");
+    const fs = mockFs({});
+    expect(await hashDirectory("/nope", fs)).toBeUndefined();
+});
+test("hashDirectory skips files that disappear while walking", async () => {
+    const { hashDirectory } = await import("./write-output.js");
+    const fs = mockFs({
+        "/output/a.txt": "alpha",
+        "/output/b.txt": "beta",
+    });
+    const readFile = fs.readFile.bind(fs);
+    vi.spyOn(fs, "readFile").mockImplementation((async (...args) => {
+        if (args[0] === "/output/b.txt") {
+            throw new Error("file disappeared");
+        }
+        return readFile(args[0], args[1]);
+    }));
+    const seededHashes = await hashDirectory("/output", fs);
+    expect(seededHashes).toEqual({
+        "a.txt": expect.any(String),
+    });
+});
+test("hashDirectory skips directories that disappear while walking", async () => {
+    const { hashDirectory } = await import("./write-output.js");
+    const fs = mockFs({
+        "/output/nested/b.txt": "beta",
+    });
+    const readdir = fs.readdir.bind(fs);
+    vi.spyOn(fs, "readdir").mockImplementation((async (...args) => {
+        if (args[0] === "/output/nested") {
+            throw new Error("directory disappeared");
+        }
+        return readdir(args[0], args[1]);
+    }));
+    const seededHashes = await hashDirectory("/output", fs);
+    expect(seededHashes).toEqual({});
+});
+const mockFs = (files) => {
+    const _memfs = memfs.createFsFromVolume(memfs.Volume.fromJSON(files));
+    return _memfs.promises;
+};
+//# sourceMappingURL=write-output.test.js.map

package/dist/services/file-handling/write-output.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-output.test.js","sourceRoot":"","sources":["../../../src/services/file-handling/write-output.test.ts"],"names":[],"mappings":"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","sourcesContent":["import memfs from \"memfs\";\nimport type fs from \"node:fs/promises\";\nimport { test, expect, vi, beforeEach } from \"vitest\";\n\nbeforeEach(() => {\n\tvi.resetModules();\n});\n\ntest(\"should write the output to a non-existing directory\", async () => {\n\tconst { writeOutput } = await import(\"./write-output.js\");\n\tconst fs = mockFs({});\n\n\tawait writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: { \"test.txt\": \"test\" },\n\t\tfs,\n\t});\n\texpect(await fs.readFile(\"/output/test.txt\", { encoding: \"utf-8\" })).toBe(\n\t\t\"test\"\n\t);\n});\n\ntest(\"should clear & overwrite output that's already there\", async () => {\n\tconst { writeOutput } = await import(\"./write-output.js\");\n\tconst fs = mockFs({\n\t\t\"/output/test.txt\": \"old\",\n\t\t\"/output/other.txt\": \"other\",\n\t});\n\n\tawait writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: { \"test.txt\": \"new\" },\n\t\tcleanDirectory: true,\n\t\tfs,\n\t});\n\n\texpect(await fs.readFile(\"/output/test.txt\", { encoding: \"utf-8\" })).toBe(\n\t\t\"new\"\n\t);\n\tawait expect(\n\t\tasync () => await fs.readFile(\"/output/other.txt\", { encoding: \"utf-8\" })\n\t).rejects.toBeDefined();\n});\n\ntest(\"should create any missing directories\", async () => {\n\tconst { writeOutput } = await import(\"./write-output.js\");\n\tconst fs = mockFs({});\n\n\tawait writeOutput({\n\t\tdirectory: \"/output/messages\",\n\t\toutput: {\n\t\t\t\"de/test.txt\": \"de\",\n\t\t\t\"en/test.txt\": \"en\",\n\t\t},\n\t\tfs,\n\t});\n\texpect(\n\t\tawait fs.readFile(\"/output/messages/de/test.txt\", { encoding: \"utf-8\" })\n\t).toBe(\"de\");\n\texpect(\n\t\tawait fs.readFile(\"/output/messages/en/test.txt\", { encoding: \"utf-8\" })\n\t).toBe(\"en\");\n});\n\ntest(\"should only write once if the output hasn't changed\", async () => {\n\tconst { writeOutput } = await import(\"./write-output.js\");\n\tconst fs = mockFs({});\n\n\tconst writeFileSpy = vi.spyOn(fs as any, \"writeFile\");\n\n\tconst hashes = await writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: { \"test.txt\": \"test\" },\n\t\tfs,\n\t});\n\tconst hashes2 = await writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: { \"test.txt\": \"test\" },\n\t\tfs,\n\t\tpreviousOutputHashes: hashes,\n\t});\n\texpect(hashes).toEqual(hashes2);\n\texpect(await fs.readFile(\"/output/test.txt\", { encoding: \"utf-8\" })).toBe(\n\t\t\"test\"\n\t);\n\texpect(writeFileSpy).toHaveBeenCalledTimes(1);\n});\n\ntest(\"should write again if the output has changed\", async () => {\n\tconst { writeOutput } = await import(\"./write-output.js\");\n\tconst fs = mockFs({});\n\n\tconst writeFileSpy = vi.spyOn(fs as any, \"writeFile\");\n\n\tconst hashes = await writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: { \"test.txt\": \"test\" },\n\t\tfs,\n\t});\n\tawait writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: { \"test.txt\": \"test2\" },\n\t\tfs,\n\t\tpreviousOutputHashes: hashes,\n\t});\n\texpect(await fs.readFile(\"/output/test.txt\", { encoding: \"utf-8\" })).toBe(\n\t\t\"test2\"\n\t);\n\texpect(writeFileSpy).toHaveBeenCalledTimes(2);\n});\n\ntest(\"should write files if output has partially changed\", async () => {\n\tconst { writeOutput } = await import(\"./write-output.js\");\n\tconst fs = mockFs({});\n\n\tconst writeFileSpy = vi.spyOn(fs as any, \"writeFile\");\n\n\tconst hashes = await writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: { \"file1.txt\": \"test\", \"file2.txt\": \"test\" },\n\t\tfs,\n\t});\n\n\tawait writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: { \"file1.txt\": \"test\", \"file2.txt\": \"test2\" },\n\t\tfs,\n\t\tpreviousOutputHashes: hashes,\n\t});\n\texpect(writeFileSpy).toHaveBeenCalledWith(\"/output/file2.txt\", \"test2\");\n\texpect(writeFileSpy).toHaveBeenCalledTimes(3);\n});\n\ntest(\"should delete files that have been removed from the output\", async () => {\n\tconst { writeOutput } = await import(\"./write-output.js\");\n\tconst fs = mockFs({});\n\n\t// First write with three files\n\tconst hashes = await writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: {\n\t\t\t\"file1.txt\": \"content1\",\n\t\t\t\"file2.txt\": \"content2\",\n\t\t\t\"subdir/file3.txt\": \"content3\",\n\t\t},\n\t\tfs,\n\t});\n\n\t// Verify all files were written\n\texpect(await fs.readFile(\"/output/file1.txt\", { encoding: \"utf-8\" })).toBe(\n\t\t\"content1\"\n\t);\n\texpect(await fs.readFile(\"/output/file2.txt\", { encoding: \"utf-8\" })).toBe(\n\t\t\"content2\"\n\t);\n\texpect(\n\t\tawait fs.readFile(\"/output/subdir/file3.txt\", { encoding: \"utf-8\" })\n\t).toBe(\"content3\");\n\n\t// Second write with file2.txt removed\n\tawait writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: {\n\t\t\t\"file1.txt\": \"content1\",\n\t\t\t\"subdir/file3.txt\": \"content3updated\",\n\t\t},\n\t\tfs,\n\t\tpreviousOutputHashes: hashes,\n\t});\n\n\t// Verify file1.txt still exists\n\texpect(await fs.readFile(\"/output/file1.txt\", { encoding: \"utf-8\" })).toBe(\n\t\t\"content1\"\n\t);\n\t// Verify file2.txt has been deleted\n\tawait expect(\n\t\tasync () => await fs.readFile(\"/output/file2.txt\", { encoding: \"utf-8\" })\n\t).rejects.toBeDefined();\n\t// Verify file3.txt was updated\n\texpect(\n\t\tawait fs.readFile(\"/output/subdir/file3.txt\", { encoding: \"utf-8\" })\n\t).toBe(\"content3updated\");\n\n\t// Get the new hashes\n\tconst newHashes = await writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: {\n\t\t\t\"file1.txt\": \"content1\",\n\t\t\t\"subdir/file3.txt\": \"content3updated\",\n\t\t},\n\t\tfs,\n\t\tpreviousOutputHashes: hashes,\n\t});\n\n\t// Third write with subdir/file3.txt removed\n\tawait writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput: {\n\t\t\t\"file1.txt\": \"content1\",\n\t\t},\n\t\tfs,\n\t\tpreviousOutputHashes: newHashes,\n\t});\n\n\t// Verify file1.txt still exists\n\texpect(await fs.readFile(\"/output/file1.txt\", { encoding: \"utf-8\" })).toBe(\n\t\t\"content1\"\n\t);\n\t// Verify subdir/file3.txt has been deleted\n\tawait expect(\n\t\tasync () =>\n\t\t\tawait fs.readFile(\"/output/subdir/file3.txt\", { encoding: \"utf-8\" })\n\t).rejects.toBeDefined();\n\t// Verify the subdir directory has also been removed\n\tawait expect(\n\t\tasync () => await fs.readdir(\"/output/subdir\")\n\t).rejects.toBeDefined();\n});\n\ntest(\"hashDirectory matches the hashes writeOutput returns\", async () => {\n\tconst { writeOutput, hashDirectory } = await import(\"./write-output.js\");\n\tconst fs = mockFs({});\n\n\tconst output = {\n\t\t\"a.txt\": \"alpha\",\n\t\t\"nested/b.txt\": \"beta\",\n\t\t\"nested/deep/c.txt\": \"gamma\",\n\t};\n\n\tconst writtenHashes = await writeOutput({\n\t\tdirectory: \"/output\",\n\t\toutput,\n\t\tfs,\n\t});\n\n\tconst seededHashes = await hashDirectory(\"/output\", fs);\n\n\texpect(seededHashes).toEqual(writtenHashes);\n});\n\ntest(\"hashDirectory returns undefined when directory does not exist\", async () => {\n\tconst { hashDirectory } = await import(\"./write-output.js\");\n\tconst fs = mockFs({});\n\n\texpect(await hashDirectory(\"/nope\", fs)).toBeUndefined();\n});\n\ntest(\"hashDirectory skips files that disappear while walking\", async () => {\n\tconst { hashDirectory } = await import(\"./write-output.js\");\n\tconst fs = mockFs({\n\t\t\"/output/a.txt\": \"alpha\",\n\t\t\"/output/b.txt\": \"beta\",\n\t});\n\tconst readFile = fs.readFile.bind(fs);\n\tvi.spyOn(fs, \"readFile\").mockImplementation((async (...args) => {\n\t\tif (args[0] === \"/output/b.txt\") {\n\t\t\tthrow new Error(\"file disappeared\");\n\t\t}\n\t\treturn readFile(args[0], args[1]);\n\t}) as typeof fs.readFile);\n\n\tconst seededHashes = await hashDirectory(\"/output\", fs);\n\n\texpect(seededHashes).toEqual({\n\t\t\"a.txt\": expect.any(String),\n\t});\n});\n\ntest(\"hashDirectory skips directories that disappear while walking\", async () => {\n\tconst { hashDirectory } = await import(\"./write-output.js\");\n\tconst fs = mockFs({\n\t\t\"/output/nested/b.txt\": \"beta\",\n\t});\n\tconst readdir = fs.readdir.bind(fs);\n\tvi.spyOn(fs, \"readdir\").mockImplementation((async (...args) => {\n\t\tif (args[0] === \"/output/nested\") {\n\t\t\tthrow new Error(\"directory disappeared\");\n\t\t}\n\t\treturn readdir(args[0], args[1] as never);\n\t}) as typeof fs.readdir);\n\n\tconst seededHashes = await hashDirectory(\"/output\", fs);\n\n\texpect(seededHashes).toEqual({});\n});\n\nconst mockFs = (files: memfs.DirectoryJSON) => {\n\tconst _memfs = memfs.createFsFromVolume(memfs.Volume.fromJSON(files));\n\treturn _memfs.promises as unknown as typeof fs;\n};\n"]}

package/dist/services/file-watching/tracked-fs.d.ts

@@ -0,0 +1,25 @@
+type TrackedFs = {
+    fs: typeof import("node:fs");
+    readFiles: Set<string>;
+    clearReadFiles: () => void;
+};
+type TrackedFsOptions = {
+    baseDir?: string;
+    fs?: typeof import("node:fs");
+};
+type WatchTargetOptions = {
+    baseDir?: string;
+    outdir?: string;
+    ignoreCache?: boolean;
+    includeDirectories?: boolean;
+    ignorePath?: (path: string) => boolean;
+};
+type WatchTargets = {
+    files: Set<string>;
+    directories: Set<string>;
+    isIgnoredPath: (path: string) => boolean;
+};
+export declare function isPathWithinDirectories(path: string, directories: Iterable<string>): boolean;
+export declare function getWatchTargets(files: Iterable<string>, options?: WatchTargetOptions): WatchTargets;
+export declare function createTrackedFs(options?: TrackedFsOptions): TrackedFs;
+export {};

package/dist/services/file-watching/tracked-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracked-fs.d.ts","sourceRoot":"","sources":["../../../src/services/file-watching/tracked-fs.ts"],"names":[],"mappings":"AAIA,KAAK,SAAS,GAAG;IAChB,EAAE,EAAE,cAAc,SAAS,CAAC,CAAC;IAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,cAAc,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,cAAc,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC,CAAC;AAEF,KAAK,YAAY,GAAG;IACnB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACzC,CAAC;AAEF,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC3B,OAAO,CAYT;AAED,wBAAgB,eAAe,CAC9B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,OAAO,GAAE,kBAAuB,GAC9B,YAAY,CAgDd;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAgDzE"}

package/dist/services/file-watching/tracked-fs.js

@@ -0,0 +1,94 @@
+import fs from "node:fs";
+import { dirname, resolve } from "node:path";
+import { nodeNormalizePath } from "../../utilities/node-normalize-path.js";
+export function isPathWithinDirectories(path, directories) {
+    const normalizedPath = nodeNormalizePath(path);
+    for (const directory of directories) {
+        const normalizedDirectory = nodeNormalizePath(directory);
+        if (normalizedPath === normalizedDirectory ||
+            normalizedPath.startsWith(`${normalizedDirectory}/`)) {
+            return true;
+        }
+    }
+    return false;
+}
+export function getWatchTargets(files, options = {}) {
+    const baseDir = options.baseDir ?? process.cwd();
+    const outdirPath = options.outdir
+        ? nodeNormalizePath(resolve(baseDir, options.outdir))
+        : undefined;
+    const ignoreCache = options.ignoreCache ?? true;
+    const includeDirectories = options.includeDirectories ?? true;
+    const ignorePath = options.ignorePath;
+    const isIgnoredPath = (path) => {
+        const normalizedPath = nodeNormalizePath(path);
+        // match whole path segments only — a project under e.g. /cachet-app/
+        // must not have its inputs ignored
+        if (ignoreCache && /(^|\/)cache(\/|$)/.test(normalizedPath)) {
+            return true;
+        }
+        if (outdirPath &&
+            (normalizedPath === outdirPath ||
+                normalizedPath.startsWith(`${outdirPath}/`))) {
+            return true;
+        }
+        return ignorePath ? ignorePath(normalizedPath) : false;
+    };
+    const nextFiles = new Set();
+    const nextDirectories = new Set();
+    for (const filePath of files) {
+        const normalizedPath = nodeNormalizePath(filePath);
+        if (isIgnoredPath(normalizedPath)) {
+            continue;
+        }
+        nextFiles.add(normalizedPath);
+        if (includeDirectories) {
+            const directoryPath = dirname(normalizedPath);
+            if (!isIgnoredPath(directoryPath)) {
+                nextDirectories.add(directoryPath);
+            }
+        }
+    }
+    return {
+        files: nextFiles,
+        directories: nextDirectories,
+        isIgnoredPath,
+    };
+}
+export function createTrackedFs(options = {}) {
+    const baseDir = options.baseDir ?? process.cwd();
+    const baseFs = options.fs ?? fs;
+    const readFiles = new Set();
+    const trackRead = (path) => {
+        readFiles.add(nodeNormalizePath(resolve(baseDir, path.toString())));
+    };
+    const wrappedFs = {
+        ...baseFs,
+        // @ts-expect-error - Node's fs has too many overloads
+        readFile: (path, options, callback) => {
+            trackRead(path);
+            return baseFs.readFile(path, options, callback);
+        },
+        // @ts-expect-error - Node's fs has too many overloads
+        readFileSync: (path, options) => {
+            trackRead(path);
+            return baseFs.readFileSync(path, options);
+        },
+        promises: {
+            ...baseFs.promises,
+            // @ts-expect-error - Node's fs.promises has too many overloads
+            readFile: async (path, options) => {
+                trackRead(path);
+                return baseFs.promises.readFile(path, options);
+            },
+        },
+    };
+    return {
+        fs: wrappedFs,
+        readFiles,
+        clearReadFiles: () => {
+            readFiles.clear();
+        },
+    };
+}
+//# sourceMappingURL=tracked-fs.js.map

package/dist/services/file-watching/tracked-fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracked-fs.js","sourceRoot":"","sources":["../../../src/services/file-watching/tracked-fs.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { nodeNormalizePath } from \"../../utilities/node-normalize-path.js\";\n\ntype TrackedFs = {\n\tfs: typeof import(\"node:fs\");\n\treadFiles: Set<string>;\n\tclearReadFiles: () => void;\n};\n\ntype TrackedFsOptions = {\n\tbaseDir?: string;\n\tfs?: typeof import(\"node:fs\");\n};\n\ntype WatchTargetOptions = {\n\tbaseDir?: string;\n\toutdir?: string;\n\tignoreCache?: boolean;\n\tincludeDirectories?: boolean;\n\tignorePath?: (path: string) => boolean;\n};\n\ntype WatchTargets = {\n\tfiles: Set<string>;\n\tdirectories: Set<string>;\n\tisIgnoredPath: (path: string) => boolean;\n};\n\nexport function isPathWithinDirectories(\n\tpath: string,\n\tdirectories: Iterable<string>\n): boolean {\n\tconst normalizedPath = nodeNormalizePath(path);\n\tfor (const directory of directories) {\n\t\tconst normalizedDirectory = nodeNormalizePath(directory);\n\t\tif (\n\t\t\tnormalizedPath === normalizedDirectory ||\n\t\t\tnormalizedPath.startsWith(`${normalizedDirectory}/`)\n\t\t) {\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n}\n\nexport function getWatchTargets(\n\tfiles: Iterable<string>,\n\toptions: WatchTargetOptions = {}\n): WatchTargets {\n\tconst baseDir = options.baseDir ?? process.cwd();\n\tconst outdirPath = options.outdir\n\t\t? nodeNormalizePath(resolve(baseDir, options.outdir))\n\t\t: undefined;\n\tconst ignoreCache = options.ignoreCache ?? true;\n\tconst includeDirectories = options.includeDirectories ?? true;\n\tconst ignorePath = options.ignorePath;\n\n\tconst isIgnoredPath = (path: string) => {\n\t\tconst normalizedPath = nodeNormalizePath(path);\n\t\t// match whole path segments only — a project under e.g. /cachet-app/\n\t\t// must not have its inputs ignored\n\t\tif (ignoreCache && /(^|\\/)cache(\\/|$)/.test(normalizedPath)) {\n\t\t\treturn true;\n\t\t}\n\t\tif (\n\t\t\toutdirPath &&\n\t\t\t(normalizedPath === outdirPath ||\n\t\t\t\tnormalizedPath.startsWith(`${outdirPath}/`))\n\t\t) {\n\t\t\treturn true;\n\t\t}\n\t\treturn ignorePath ? ignorePath(normalizedPath) : false;\n\t};\n\n\tconst nextFiles = new Set<string>();\n\tconst nextDirectories = new Set<string>();\n\n\tfor (const filePath of files) {\n\t\tconst normalizedPath = nodeNormalizePath(filePath);\n\t\tif (isIgnoredPath(normalizedPath)) {\n\t\t\tcontinue;\n\t\t}\n\t\tnextFiles.add(normalizedPath);\n\t\tif (includeDirectories) {\n\t\t\tconst directoryPath = dirname(normalizedPath);\n\t\t\tif (!isIgnoredPath(directoryPath)) {\n\t\t\t\tnextDirectories.add(directoryPath);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tfiles: nextFiles,\n\t\tdirectories: nextDirectories,\n\t\tisIgnoredPath,\n\t};\n}\n\nexport function createTrackedFs(options: TrackedFsOptions = {}): TrackedFs {\n\tconst baseDir = options.baseDir ?? process.cwd();\n\tconst baseFs = options.fs ?? fs;\n\tconst readFiles = new Set<string>();\n\n\tconst trackRead = (path: fs.PathLike | number) => {\n\t\treadFiles.add(nodeNormalizePath(resolve(baseDir, path.toString())));\n\t};\n\n\tconst wrappedFs: typeof import(\"node:fs\") = {\n\t\t...baseFs,\n\t\t// @ts-expect-error - Node's fs has too many overloads\n\t\treadFile: (\n\t\t\tpath: fs.PathLike | number,\n\t\t\toptions: { encoding?: null; flag?: string } | null | undefined,\n\t\t\tcallback: (err: NodeJS.ErrnoException | null, data: Buffer) => void\n\t\t) => {\n\t\t\ttrackRead(path);\n\t\t\treturn baseFs.readFile(path, options, callback);\n\t\t},\n\t\t// @ts-expect-error - Node's fs has too many overloads\n\t\treadFileSync: (\n\t\t\tpath: fs.PathLike | number,\n\t\t\toptions?: { encoding?: null; flag?: string } | null | undefined\n\t\t) => {\n\t\t\ttrackRead(path);\n\t\t\treturn baseFs.readFileSync(path, options);\n\t\t},\n\t\tpromises: {\n\t\t\t...baseFs.promises,\n\t\t\t// @ts-expect-error - Node's fs.promises has too many overloads\n\t\t\treadFile: async (\n\t\t\t\tpath: fs.PathLike,\n\t\t\t\toptions?: { encoding?: null; flag?: string } | null\n\t\t\t): Promise<Buffer> => {\n\t\t\t\ttrackRead(path);\n\t\t\t\treturn baseFs.promises.readFile(path, options);\n\t\t\t},\n\t\t},\n\t};\n\n\treturn {\n\t\tfs: wrappedFs,\n\t\treadFiles,\n\t\tclearReadFiles: () => {\n\t\t\treadFiles.clear();\n\t\t},\n\t};\n}\n"]}

package/dist/services/file-watching/tracked-fs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/file-watching/tracked-fs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracked-fs.test.d.ts","sourceRoot":"","sources":["../../../src/services/file-watching/tracked-fs.test.ts"],"names":[],"mappings":""}