@contextjs/io v25.0.0-beta.3

@contextjs/io

File system utilities for reading, writing, and inspecting files, directories, and paths — with clean APIs and exception-based error handling.

✨ Features

• Create, rename, and delete files and directories
• Automatic parent directory creation for files
• Path utilities: isFile, isDirectory, exists
• Clear and consistent exceptions
• Null-safe input validation
• Zero dependencies

Installation

npm i @contextjs/io

Usage

import { File, Directory, Path } from '@contextjs/io';

if (!Directory.exists("logs"))
    Directory.create("logs");

File.save("logs/app.log", "Application started", true);

const log = File.read("logs/app.log");
File.save("logs/app.log", log + "\nSecond line", true);

File.rename("logs/app.log", "logs/app-archived.log");

if (Path.isFile("logs/app-archived.log"))
    File.delete("logs/app-archived.log");

if (Directory.exists("logs"))
    Directory.delete("logs");

These custom exceptions are thrown by the File and Directory APIs:

API Reference

For detailed API documentation, please refer to the API Reference.