import { describe, test, expect } from "bun:test" import path from "path" import fs from "fs/promises" import { Filesystem } from "../../src/util/filesystem" import { tmpdir } from "../fixture/fixture" describe("filesystem", () => { describe("exists()", () => { test("returns true for existing file", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "test.txt") await fs.writeFile(filepath, "content", "utf-8") expect(await Filesystem.exists(filepath)).toBe(true) }) test("returns false for non-existent file", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "does-not-exist.txt") expect(await Filesystem.exists(filepath)).toBe(false) }) test("returns true for existing directory", async () => { await using tmp = await tmpdir() const dirpath = path.join(tmp.path, "subdir") await fs.mkdir(dirpath) expect(await Filesystem.exists(dirpath)).toBe(true) }) }) describe("isDir()", () => { test("returns true for directory", async () => { await using tmp = await tmpdir() const dirpath = path.join(tmp.path, "testdir") await fs.mkdir(dirpath) expect(await Filesystem.isDir(dirpath)).toBe(true) }) test("returns false for file", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "test.txt") await fs.writeFile(filepath, "content", "utf-8") expect(await Filesystem.isDir(filepath)).toBe(false) }) test("returns false for non-existent path", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "does-not-exist") expect(await Filesystem.isDir(filepath)).toBe(false) }) }) describe("size()", () => { test("returns file size", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "test.txt") const content = "Hello, World!" await fs.writeFile(filepath, content, "utf-8") expect(await Filesystem.size(filepath)).toBe(content.length) }) test("returns 0 for non-existent file", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "does-not-exist.txt") expect(await Filesystem.size(filepath)).toBe(0) }) test("returns directory size", async () => { await using tmp = await tmpdir() const dirpath = path.join(tmp.path, "testdir") await fs.mkdir(dirpath) // Directories have size on some systems const size = await Filesystem.size(dirpath) expect(typeof size).toBe("number") }) }) describe("readText()", () => { test("reads file content", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "test.txt") const content = "Hello, World!" await fs.writeFile(filepath, content, "utf-8") expect(await Filesystem.readText(filepath)).toBe(content) }) test("throws for non-existent file", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "does-not-exist.txt") await expect(Filesystem.readText(filepath)).rejects.toThrow() }) test("reads UTF-8 content correctly", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "unicode.txt") const content = "Hello δΈ–η•Œ 🌍" await fs.writeFile(filepath, content, "utf-8") expect(await Filesystem.readText(filepath)).toBe(content) }) }) describe("readJson()", () => { test("reads and parses JSON", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "test.json") const data = { key: "value", nested: { array: [1, 2, 3] } } await fs.writeFile(filepath, JSON.stringify(data), "utf-8") const result: typeof data = await Filesystem.readJson(filepath) expect(result).toEqual(data) }) test("throws for invalid JSON", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "invalid.json") await fs.writeFile(filepath, "{ invalid json", "utf-8") await expect(Filesystem.readJson(filepath)).rejects.toThrow() }) test("throws for non-existent file", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "does-not-exist.json") await expect(Filesystem.readJson(filepath)).rejects.toThrow() }) test("returns typed data", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "typed.json") interface Config { name: string version: number } const data: Config = { name: "test", version: 1 } await fs.writeFile(filepath, JSON.stringify(data), "utf-8") const result = await Filesystem.readJson(filepath) expect(result.name).toBe("test") expect(result.version).toBe(1) }) }) describe("readBytes()", () => { test("reads file as buffer", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "test.txt") const content = "Hello, World!" await fs.writeFile(filepath, content, "utf-8") const buffer = await Filesystem.readBytes(filepath) expect(buffer).toBeInstanceOf(Buffer) expect(buffer.toString("utf-8")).toBe(content) }) test("throws for non-existent file", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "does-not-exist.bin") await expect(Filesystem.readBytes(filepath)).rejects.toThrow() }) }) describe("write()", () => { test("writes text content", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "test.txt") const content = "Hello, World!" await Filesystem.write(filepath, content) expect(await fs.readFile(filepath, "utf-8")).toBe(content) }) test("writes buffer content", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "test.bin") const content = Buffer.from([0x00, 0x01, 0x02, 0x03]) await Filesystem.write(filepath, content) const read = await fs.readFile(filepath) expect(read).toEqual(content) }) test("writes with permissions", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "protected.txt") const content = "secret" await Filesystem.write(filepath, content, 0o600) const stats = await fs.stat(filepath) // Check permissions on Unix if (process.platform !== "win32") { expect(stats.mode & 0o777).toBe(0o600) } }) test("creates parent directories", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "nested", "deep", "file.txt") const content = "nested content" await Filesystem.write(filepath, content) expect(await fs.readFile(filepath, "utf-8")).toBe(content) }) }) describe("writeJson()", () => { test("writes JSON data", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "data.json") const data = { key: "value", number: 42 } await Filesystem.writeJson(filepath, data) const content = await fs.readFile(filepath, "utf-8") expect(JSON.parse(content)).toEqual(data) }) test("writes formatted JSON", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "pretty.json") const data = { key: "value" } await Filesystem.writeJson(filepath, data) const content = await fs.readFile(filepath, "utf-8") expect(content).toContain("\n") expect(content).toContain(" ") }) test("writes with permissions", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "config.json") const data = { secret: "data" } await Filesystem.writeJson(filepath, data, 0o600) const stats = await fs.stat(filepath) if (process.platform !== "win32") { expect(stats.mode & 0o777).toBe(0o600) } }) }) describe("mimeType()", () => { test("returns correct MIME type for JSON", () => { expect(Filesystem.mimeType("test.json")).toContain("application/json") }) test("returns correct MIME type for JavaScript", () => { expect(Filesystem.mimeType("test.js")).toContain("javascript") }) test("returns MIME type for TypeScript (or video/mp2t due to extension conflict)", () => { const mime = Filesystem.mimeType("test.ts") // .ts is ambiguous: TypeScript vs MPEG-2 TS video expect(mime === "video/mp2t" || mime === "application/typescript" || mime === "text/typescript").toBe(true) }) test("returns correct MIME type for images", () => { expect(Filesystem.mimeType("test.png")).toContain("image/png") expect(Filesystem.mimeType("test.jpg")).toContain("image/jpeg") }) test("returns default for unknown extension", () => { expect(Filesystem.mimeType("test.unknown")).toBe("application/octet-stream") }) test("handles files without extension", () => { expect(Filesystem.mimeType("Makefile")).toBe("application/octet-stream") }) }) describe("windowsPath()", () => { test("converts Git Bash paths", () => { if (process.platform === "win32") { expect(Filesystem.windowsPath("/c/Users/test")).toBe("C:/Users/test") expect(Filesystem.windowsPath("/d/dev/project")).toBe("D:/dev/project") } else { expect(Filesystem.windowsPath("/c/Users/test")).toBe("/c/Users/test") } }) test("converts Cygwin paths", () => { if (process.platform === "win32") { expect(Filesystem.windowsPath("/cygdrive/c/Users/test")).toBe("C:/Users/test") expect(Filesystem.windowsPath("/cygdrive/x/dev/project")).toBe("X:/dev/project") } else { expect(Filesystem.windowsPath("/cygdrive/c/Users/test")).toBe("/cygdrive/c/Users/test") } }) test("converts WSL paths", () => { if (process.platform === "win32") { expect(Filesystem.windowsPath("/mnt/c/Users/test")).toBe("C:/Users/test") expect(Filesystem.windowsPath("/mnt/z/dev/project")).toBe("Z:/dev/project") } else { expect(Filesystem.windowsPath("/mnt/c/Users/test")).toBe("/mnt/c/Users/test") } }) test("ignores normal Windows paths", () => { expect(Filesystem.windowsPath("C:/Users/test")).toBe("C:/Users/test") expect(Filesystem.windowsPath("D:\\dev\\project")).toBe("D:\\dev\\project") }) }) describe("writeStream()", () => { test("writes from Web ReadableStream", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "streamed.txt") const content = "Hello from stream!" const encoder = new TextEncoder() const stream = new ReadableStream({ start(controller) { controller.enqueue(encoder.encode(content)) controller.close() }, }) await Filesystem.writeStream(filepath, stream) expect(await fs.readFile(filepath, "utf-8")).toBe(content) }) test("writes from Node.js Readable stream", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "node-streamed.txt") const content = "Hello from Node stream!" const { Readable } = await import("stream") const stream = Readable.from([content]) await Filesystem.writeStream(filepath, stream) expect(await fs.readFile(filepath, "utf-8")).toBe(content) }) test("writes binary data from Web ReadableStream", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "binary.dat") const binaryData = new Uint8Array([0x00, 0x01, 0x02, 0x03, 0xff]) const stream = new ReadableStream({ start(controller) { controller.enqueue(binaryData) controller.close() }, }) await Filesystem.writeStream(filepath, stream) const read = await fs.readFile(filepath) expect(Buffer.from(read)).toEqual(Buffer.from(binaryData)) }) test("writes large content in chunks", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "large.txt") const chunks = ["chunk1", "chunk2", "chunk3", "chunk4", "chunk5"] const stream = new ReadableStream({ start(controller) { for (const chunk of chunks) { controller.enqueue(new TextEncoder().encode(chunk)) } controller.close() }, }) await Filesystem.writeStream(filepath, stream) expect(await fs.readFile(filepath, "utf-8")).toBe(chunks.join("")) }) test("creates parent directories", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "nested", "deep", "streamed.txt") const content = "nested stream content" const stream = new ReadableStream({ start(controller) { controller.enqueue(new TextEncoder().encode(content)) controller.close() }, }) await Filesystem.writeStream(filepath, stream) expect(await fs.readFile(filepath, "utf-8")).toBe(content) }) test("writes with permissions", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "protected-stream.txt") const content = "secret stream content" const stream = new ReadableStream({ start(controller) { controller.enqueue(new TextEncoder().encode(content)) controller.close() }, }) await Filesystem.writeStream(filepath, stream, 0o600) const stats = await fs.stat(filepath) if (process.platform !== "win32") { expect(stats.mode & 0o777).toBe(0o600) } }) test("writes executable with permissions", async () => { await using tmp = await tmpdir() const filepath = path.join(tmp.path, "script.sh") const content = "#!/bin/bash\necho hello" const stream = new ReadableStream({ start(controller) { controller.enqueue(new TextEncoder().encode(content)) controller.close() }, }) await Filesystem.writeStream(filepath, stream, 0o755) const stats = await fs.stat(filepath) if (process.platform !== "win32") { expect(stats.mode & 0o777).toBe(0o755) } expect(await fs.readFile(filepath, "utf-8")).toBe(content) }) }) describe("resolve()", () => { test("resolves slash-prefixed drive paths on Windows", async () => { if (process.platform !== "win32") return await using tmp = await tmpdir() const forward = tmp.path.replaceAll("\\", "/") expect(Filesystem.resolve(`/${forward}`)).toBe(Filesystem.normalizePath(tmp.path)) }) test("resolves slash-prefixed drive roots on Windows", async () => { if (process.platform !== "win32") return await using tmp = await tmpdir() const drive = tmp.path[0].toUpperCase() expect(Filesystem.resolve(`/${drive}:`)).toBe(Filesystem.resolve(`${drive}:/`)) }) test("resolves Git Bash and MSYS2 paths on Windows", async () => { // Git Bash and MSYS2 both use //... paths on Windows. if (process.platform !== "win32") return await using tmp = await tmpdir() const drive = tmp.path[0].toLowerCase() const rest = tmp.path.slice(2).replaceAll("\\", "/") expect(Filesystem.resolve(`/${drive}${rest}`)).toBe(Filesystem.normalizePath(tmp.path)) }) test("resolves Git Bash and MSYS2 drive roots on Windows", async () => { // Git Bash and MSYS2 both use / paths on Windows. if (process.platform !== "win32") return await using tmp = await tmpdir() const drive = tmp.path[0].toLowerCase() expect(Filesystem.resolve(`/${drive}`)).toBe(Filesystem.resolve(`${drive.toUpperCase()}:/`)) }) test("resolves Cygwin paths on Windows", async () => { if (process.platform !== "win32") return await using tmp = await tmpdir() const drive = tmp.path[0].toLowerCase() const rest = tmp.path.slice(2).replaceAll("\\", "/") expect(Filesystem.resolve(`/cygdrive/${drive}${rest}`)).toBe(Filesystem.normalizePath(tmp.path)) }) test("resolves Cygwin drive roots on Windows", async () => { if (process.platform !== "win32") return await using tmp = await tmpdir() const drive = tmp.path[0].toLowerCase() expect(Filesystem.resolve(`/cygdrive/${drive}`)).toBe(Filesystem.resolve(`${drive.toUpperCase()}:/`)) }) test("resolves WSL mount paths on Windows", async () => { if (process.platform !== "win32") return await using tmp = await tmpdir() const drive = tmp.path[0].toLowerCase() const rest = tmp.path.slice(2).replaceAll("\\", "/") expect(Filesystem.resolve(`/mnt/${drive}${rest}`)).toBe(Filesystem.normalizePath(tmp.path)) }) test("resolves WSL mount roots on Windows", async () => { if (process.platform !== "win32") return await using tmp = await tmpdir() const drive = tmp.path[0].toLowerCase() expect(Filesystem.resolve(`/mnt/${drive}`)).toBe(Filesystem.resolve(`${drive.toUpperCase()}:/`)) }) }) })