homeio

1import { lstat, mkdtemp, mkdir, readFile, realpath, rm, writeFile } from "node:fs/promises";
2import os from "node:os";
3import path from "node:path";
4import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
5
6const originalEnv = process.env;
7
8let tempRoot = "";
9
10describe("path resolver", () => {
11  beforeEach(async () => {
12    vi.resetModules();
13    process.env = { ...originalEnv };
14    tempRoot = await mkdtemp(path.join(os.tmpdir(), "home-server-files-root-"));
15    process.env.FILES_ROOT = tempRoot;
16  });
17
18  afterEach(async () => {
19    process.env = originalEnv;
20    if (tempRoot) {
21      await rm(tempRoot, { recursive: true, force: true });
22    }
23  });
24
25  it("maps virtual reserved directories to hidden on-disk folders", async () => {
26    const { resolvePathWithinFilesRoot } = await import(
27      "@/lib/server/modules/files/path-resolver"
28    );
29
30    const resolved = await resolvePathWithinFilesRoot({
31      inputPath: "Trash",
32      allowHiddenSegments: true,
33    });
34
35    expect(resolved.relativePath).toBe("Trash");
36    expect(resolved.exists).toBe(true);
37    expect(resolved.absolutePath).toBe(await realpath(path.join(tempRoot, ".Trash")));
38
39    const info = await lstat(path.join(tempRoot, ".Trash"));
40    expect(info.isDirectory()).toBe(true);
41  });
42
43  it("migrates legacy visible internal folders to hidden folders", async () => {
44    await mkdir(path.join(tempRoot, "Trash"), { recursive: true });
45    await writeFile(path.join(tempRoot, "Trash", "notes.txt"), "hello", "utf8");
46
47    const { resolvePathWithinFilesRoot } = await import(
48      "@/lib/server/modules/files/path-resolver"
49    );
50
51    const resolved = await resolvePathWithinFilesRoot({
52      inputPath: "Trash/notes.txt",
53      allowHiddenSegments: true,
54    });
55
56    expect(resolved.absolutePath).toBe(
57      await realpath(path.join(tempRoot, ".Trash", "notes.txt")),
58    );
59    expect(await readFile(resolved.absolutePath, "utf8")).toBe("hello");
60    await expect(lstat(path.join(tempRoot, "Trash"))).rejects.toMatchObject({
61      code: "ENOENT",
62    });
63  });
64
65  it("removes an empty legacy visible internal folder when hidden root already exists", async () => {
66    await mkdir(path.join(tempRoot, ".Shared"), { recursive: true });
67    await mkdir(path.join(tempRoot, "Shared"), { recursive: true });
68
69    const { ensureFilesRootDirectories } = await import(
70      "@/lib/server/modules/files/path-resolver"
71    );
72
73    await ensureFilesRootDirectories();
74
75    await expect(lstat(path.join(tempRoot, "Shared"))).rejects.toMatchObject({
76      code: "ENOENT",
77    });
78    const hiddenInfo = await lstat(path.join(tempRoot, ".Shared"));
79    expect(hiddenInfo.isDirectory()).toBe(true);
80  });
81});
82