File System

bun add @talosjs/fs

import { File } from "@talosjs/fs";

const file = new File("/path/to/config.json");

if (await file.exists()) {
  // Read in different shapes
  const raw = await file.text();
  const config = await file.json<{ name: string; version: number }>();
  const bytes = await file.bytes();

  // Metadata
  console.log(file.getName());      // "config.json"
  console.log(file.getExtension()); // "json"
  console.log(file.getSize());      // size in bytes
}

// Write, append, copy, delete
await file.write("Hello, World!");
await file.append("\nmore content");
const backup = await file.copy("/path/to/config.backup.json");
await backup.delete();

import { File } from "@talosjs/fs";

const file = new File("/path/to/large-data.json");

for await (const item of file.streamAsJson<{ id: number }>()) {
  console.log(item.id);
}

// Or stream raw chunks / decoded text
const log = new File("/path/to/app.log");
for await (const line of log.streamAsText()) {
  process.stdout.write(line);
}

import { File } from "@talosjs/fs";

// Download a remote file to disk
const downloaded = await File.download("https://example.com/data.zip", "/tmp/data.zip");

// Buffered (incremental) writes via a FileSink
const out = new File("/tmp/output.txt");
const writer = out.writer();
writer.write("Line 1\n");
writer.write("Line 2\n");
writer.end(); // flush and close

import { Directory } from "@talosjs/fs";

const dir = new Directory("/path/to/project");

await dir.mkdir();                       // recursive by default
const names = await dir.ls({ recursive: true });
const totalBytes = await dir.getSize();

// Navigate fluently
const srcDir = dir.cd("src", "components");

// Iterate only files matching a pattern
for await (const file of srcDir.getFiles({ recursive: true, pattern: /\.ts$/ })) {
  console.log(file.getPath());
}

// Copy, move, clean up
await dir.cp("/path/to/copy", { overwrite: true });
if (await dir.isEmpty()) {
  await dir.rm({ force: true });
}

// Watch for changes
const watcher = dir.watch((event, filename) => {
  console.log(`${event}: ${filename}`);
}, { recursive: true });
// watcher.close();