import { afterEach, describe, expect, it } from "vitest"; import { mkdtempSync, mkdirSync, realpathSync, rmSync, symlinkSync, writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; import { join, win32 } from "node:path"; import { isValidProjectId } from "./src/utils/projectRouting"; import { createStudioApi } from "@hyperframes/studio-server"; import type { ViteDevServer } from "vite"; import { createProjectSignatureCache, createViteAdapter } from "./vite.adapter"; const roots: string[] = []; afterEach(() => { for (const root of roots.splice(0)) rmSync(root, { recursive: true, force: true }); }); function fixture() { const root = mkdtempSync(join(tmpdir(), "hf-project-routing-")); roots.push(root); const data = join(root, "data"); const sessions = join(root, "sessions"); mkdirSync(data); mkdirSync(sessions); // Project resolution does not call Vite's module loader. const adapter = createViteAdapter( data, {} as ViteDevServer, createProjectSignatureCache({ compute: () => "test" }), ); const app = createStudioApi(adapter); return { root, data, sessions, adapter, app }; } describe("Vite project resolution boundary", () => { it.each(["C%3A", "C%3Ademo", "..%2Fsessions", "a%2Fb", "a%5Cb", "%2E%2E%2Fsessions", "a%00b"])( "rejects a router-decoded unsafe ID: %s", async (id) => { const { app } = fixture(); expect((await app.request(`http://localhost/projects/${id}`)).status).toBe(404); }, ); it("preserves valid names, session aliases, and explicitly listed symlink projects", async () => { const { data, sessions, root, adapter, app } = fixture(); const id = "..MaƱana #1 50%"; mkdirSync(join(data, id)); expect((await app.request(`http://localhost/projects/${encodeURIComponent(id)}`)).status).toBe( 200, ); writeFileSync(join(sessions, "alias.json"), JSON.stringify({ projectId: id, title: "Title" })); expect(adapter.resolveProject("alias")?.id).toBe(id); const linked = join(root, "linked"); mkdirSync(linked); symlinkSync(linked, join(data, "shortcut"), "junction"); expect(adapter.resolveProject("shortcut")?.dir).toBe(realpathSync(linked)); }); it("rejects drive-relative IDs that Windows resolves as root or sibling aliases", () => { expect(win32.resolve("C:\\hf\\data", "C:")).toBe("C:\\hf\\data"); expect(win32.resolve("C:\\hf\\data", "C:demo")).toBe("C:\\hf\\data\\demo"); expect(isValidProjectId("C:")).toBe(false); expect(isValidProjectId("C:demo")).toBe(false); }); it.skipIf(process.platform === "win32")( "does not discover POSIX directory names outside the portable ID contract", async () => { const { data, adapter } = fixture(); for (const id of ["valid", "bad\\name", "bad\nname", "C:demo"]) { mkdirSync(join(data, id)); writeFileSync(join(data, id, "index.html"), ""); } expect((await adapter.listProjects()).map((project) => project.id)).toEqual(["valid"]); }, ); it("rejects traversal in a session's project mapping", () => { const { sessions, adapter } = fixture(); writeFileSync(join(sessions, "alias.json"), JSON.stringify({ projectId: "../sessions" })); expect(adapter.resolveProject("alias")).toBeNull(); }); });