@ricsam/isolate-path

Node.js-compatible path utilities for POSIX paths in isolated-vm V8 sandbox.

Installation

npm add @ricsam/isolate-path

Usage

import { setupPath } from "@ricsam/isolate-path";

// Default: uses "/" as working directory
const handle = await setupPath(context);

// Custom working directory for path.resolve()
const handle = await setupPath(context, { cwd: "/home/user/project" });

Options

• cwd - Current working directory for path.resolve(). Defaults to "/".

Injected Globals

• path.join(...paths) - Join path segments
• path.resolve(...paths) - Resolve to absolute path (uses configured cwd as base)
• path.normalize(path) - Normalize a path
• path.basename(path, ext?) - Get file name
• path.dirname(path) - Get directory name
• path.extname(path) - Get file extension
• path.isAbsolute(path) - Check if path is absolute
• path.parse(path) - Parse into components
• path.format(obj) - Format from components
• path.relative(from, to) - Get relative path
• path.sep - Path separator (/)
• path.delimiter - Path delimiter (:)
• path.posix - Alias to path (POSIX-only implementation)

Usage in Isolate

// Join paths
path.join('/foo', 'bar', 'baz'); // "/foo/bar/baz"
path.join('foo', 'bar', '..', 'baz'); // "foo/baz"

// Resolve to absolute (relative paths use configured cwd)
path.resolve('foo/bar'); // Uses cwd + "/foo/bar"
path.resolve('/foo', 'bar'); // "/foo/bar" (absolute paths ignore cwd)

// Parse and format
const parsed = path.parse('/foo/bar/baz.txt');
// { root: "/", dir: "/foo/bar", base: "baz.txt", ext: ".txt", name: "baz" }

path.format({ dir: '/foo/bar', base: 'baz.txt' }); // "/foo/bar/baz.txt"

// Other utilities
path.basename('/foo/bar/baz.txt'); // "baz.txt"
path.dirname('/foo/bar/baz.txt'); // "/foo/bar"
path.extname('file.tar.gz'); // ".gz"
path.isAbsolute('/foo'); // true

License

MIT