sandbox-fs 1.0.0

package/dist/utils/ErrorFilter.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterError = filterError;
+/**
+ * Filter error messages to replace real paths with virtual paths
+ */
+function filterError(error, pathMapper) {
+    const realRoot = pathMapper.getRoot();
+    // Create a regex to match the real root path
+    // Escape special regex characters and handle both forward and back slashes
+    const escapedRoot = realRoot.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const rootPattern = new RegExp(escapedRoot.replace(/\\/g, "\\\\"), "g");
+    // Filter the error message
+    if (error.message) {
+        error.message = error.message.replace(rootPattern, "");
+    }
+    // Filter the stack trace
+    if (error.stack) {
+        error.stack = error.stack.replace(rootPattern, "");
+    }
+    // Filter the path property if it exists
+    const errWithPath = error;
+    if (errWithPath.path && typeof errWithPath.path === "string") {
+        try {
+            // Try to convert real path to virtual path
+            if (pathMapper.isWithinRoot(errWithPath.path)) {
+                errWithPath.path = pathMapper.toVirtualPath(errWithPath.path);
+            }
+            else {
+                // If outside root, just strip the root prefix
+                errWithPath.path = errWithPath.path.replace(rootPattern, "");
+            }
+        }
+        catch {
+            // If conversion fails, just strip the root prefix
+            errWithPath.path = errWithPath.path.replace(rootPattern, "");
+        }
+    }
+    // Filter the dest property if it exists (for copy operations)
+    if ("dest" in errWithPath && typeof errWithPath.dest === "string") {
+        try {
+            const destStr = errWithPath.dest;
+            if (pathMapper.isWithinRoot(destStr)) {
+                errWithPath.dest = pathMapper.toVirtualPath(destStr);
+            }
+            else {
+                errWithPath.dest = destStr.replace(rootPattern, "");
+            }
+        }
+        catch {
+            const destStr = errWithPath.dest;
+            errWithPath.dest = destStr.replace(rootPattern, "");
+        }
+    }
+    return error;
+}
+//# sourceMappingURL=ErrorFilter.js.map

package/dist/utils/ErrorFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorFilter.js","sourceRoot":"","sources":["../../src/utils/ErrorFilter.ts"],"names":[],"mappings":";;AAKA,kCAmDC;AAtDD;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAY,EAAE,UAAsB;IAC9D,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;IAEtC,6CAA6C;IAC7C,2EAA2E;IAC3E,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IAExE,2BAA2B;IAC3B,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,yBAAyB;IACzB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,wCAAwC;IACxC,MAAM,WAAW,GAAG,KAA8B,CAAC;IACnD,IAAI,WAAW,CAAC,IAAI,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7D,IAAI,CAAC;YACH,2CAA2C;YAC3C,IAAI,UAAU,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,WAAW,CAAC,IAAI,GAAG,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,8CAA8C;gBAC9C,WAAW,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;YAClD,WAAW,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,IAAI,MAAM,IAAI,WAAW,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,IAAc,CAAC;YAC3C,IAAI,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpC,WAAmB,CAAC,IAAI,GAAG,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACL,WAAmB,CAAC,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,OAAO,GAAG,WAAW,CAAC,IAAc,CAAC;YAC1C,WAAmB,CAAC,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/callbackify.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert a promise-based function to a callback-based function
+ */
+export declare function callbackify<T extends any[], R>(fn: (...args: T) => Promise<R>): (...args: [...T, (err: Error | null, result?: R) => void]) => void;
+/**
+ * Callbackify for void-returning promises
+ */
+export declare function callbackifyVoid<T extends any[]>(fn: (...args: T) => Promise<void>): (...args: [...T, (err: Error | null) => void]) => void;
+//# sourceMappingURL=callbackify.d.ts.map

package/dist/utils/callbackify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbackify.d.ts","sourceRoot":"","sources":["../../src/utils/callbackify.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,EAC5C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7B,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,CAuBpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,GAAG,EAAE,EAC7C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAChC,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC,KAAK,IAAI,CAkBxD"}

package/dist/utils/callbackify.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callbackify = callbackify;
+exports.callbackifyVoid = callbackifyVoid;
+/**
+ * Convert a promise-based function to a callback-based function
+ */
+function callbackify(fn) {
+    return function (...args) {
+        // Extract callback from arguments
+        const callback = args[args.length - 1];
+        if (typeof callback !== 'function') {
+            throw new TypeError('The last argument must be a callback function');
+        }
+        // Get the actual arguments (without callback)
+        const actualArgs = args.slice(0, -1);
+        // Call the promise function
+        fn.apply(this, actualArgs)
+            .then((result) => {
+            // Call callback with no error
+            callback(null, result);
+        })
+            .catch((err) => {
+            // Call callback with error
+            callback(err);
+        });
+    };
+}
+/**
+ * Callbackify for void-returning promises
+ */
+function callbackifyVoid(fn) {
+    return function (...args) {
+        const callback = args[args.length - 1];
+        if (typeof callback !== 'function') {
+            throw new TypeError('The last argument must be a callback function');
+        }
+        const actualArgs = args.slice(0, -1);
+        fn.apply(this, actualArgs)
+            .then(() => {
+            callback(null);
+        })
+            .catch((err) => {
+            callback(err);
+        });
+    };
+}
+//# sourceMappingURL=callbackify.js.map

package/dist/utils/callbackify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbackify.js","sourceRoot":"","sources":["../../src/utils/callbackify.ts"],"names":[],"mappings":";;AAGA,kCAyBC;AAKD,0CAoBC;AArDD;;GAEG;AACH,SAAgB,WAAW,CACzB,EAA8B;IAE9B,OAAO,UAAqB,GAAG,IAAW;QACxC,kCAAkC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEvC,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;QACvE,CAAC;QAED,8CAA8C;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAM,CAAC;QAE1C,4BAA4B;QAC5B,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;aACvB,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,8BAA8B;YAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,2BAA2B;YAC3B,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAC7B,EAAiC;IAEjC,OAAO,UAAqB,GAAG,IAAW;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEvC,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAM,CAAC;QAE1C,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;aACvB,IAAI,CAAC,GAAG,EAAE;YACT,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AACJ,CAAC"}

package/dist/wrappers/VirtualDir.d.ts

@@ -0,0 +1,34 @@
+import * as fs from 'fs';
+import { VirtualDirent } from './VirtualDirent';
+import type { PathMapper } from '../PathMapper';
+/**
+ * Virtual Dir that wraps a real fs.Dir and returns VirtualDirent instances
+ */
+export declare class VirtualDir implements AsyncIterable<VirtualDirent> {
+    private realDir;
+    private _virtualPath;
+    private pathMapper;
+    constructor(realDir: fs.Dir, virtualPath: string, pathMapper: PathMapper);
+    get path(): string;
+    /**
+     * Read the next directory entry
+     */
+    read(): Promise<VirtualDirent | null>;
+    /**
+     * Synchronously read the next directory entry
+     */
+    readSync(): VirtualDirent | null;
+    /**
+     * Close the directory
+     */
+    close(): Promise<void>;
+    /**
+     * Synchronously close the directory
+     */
+    closeSync(): void;
+    /**
+     * Async iterator support
+     */
+    [Symbol.asyncIterator](): AsyncIterator<VirtualDirent>;
+}
+//# sourceMappingURL=VirtualDir.d.ts.map

package/dist/wrappers/VirtualDir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualDir.d.ts","sourceRoot":"","sources":["../../src/wrappers/VirtualDir.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;GAEG;AACH,qBAAa,UAAW,YAAW,aAAa,CAAC,aAAa,CAAC;IAC7D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAa;gBAEnB,OAAO,EAAE,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;IAMxE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAc3C;;OAEG;IACH,QAAQ,IAAI,aAAa,GAAG,IAAI;IAahC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,aAAa,CAAC;CAWvD"}

package/dist/wrappers/VirtualDir.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VirtualDir = void 0;
+const VirtualDirent_1 = require("./VirtualDirent");
+/**
+ * Virtual Dir that wraps a real fs.Dir and returns VirtualDirent instances
+ */
+class VirtualDir {
+    constructor(realDir, virtualPath, pathMapper) {
+        this.realDir = realDir;
+        this._virtualPath = virtualPath;
+        this.pathMapper = pathMapper;
+    }
+    get path() {
+        return this._virtualPath;
+    }
+    /**
+     * Read the next directory entry
+     */
+    async read() {
+        const realDirent = await this.realDir.read();
+        if (realDirent === null) {
+            return null;
+        }
+        // Construct virtual path for this entry
+        const virtualEntryPath = this._virtualPath === '/'
+            ? `/${realDirent.name}`
+            : `${this._virtualPath}/${realDirent.name}`;
+        return new VirtualDirent_1.VirtualDirent(realDirent, virtualEntryPath, realDirent.name);
+    }
+    /**
+     * Synchronously read the next directory entry
+     */
+    readSync() {
+        const realDirent = this.realDir.readSync();
+        if (realDirent === null) {
+            return null;
+        }
+        const virtualEntryPath = this._virtualPath === '/'
+            ? `/${realDirent.name}`
+            : `${this._virtualPath}/${realDirent.name}`;
+        return new VirtualDirent_1.VirtualDirent(realDirent, virtualEntryPath, realDirent.name);
+    }
+    /**
+     * Close the directory
+     */
+    async close() {
+        await this.realDir.close();
+    }
+    /**
+     * Synchronously close the directory
+     */
+    closeSync() {
+        this.realDir.closeSync();
+    }
+    /**
+     * Async iterator support
+     */
+    [Symbol.asyncIterator]() {
+        return {
+            next: async () => {
+                const dirent = await this.read();
+                if (dirent === null) {
+                    return { done: true, value: undefined };
+                }
+                return { done: false, value: dirent };
+            },
+        };
+    }
+}
+exports.VirtualDir = VirtualDir;
+//# sourceMappingURL=VirtualDir.js.map

package/dist/wrappers/VirtualDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualDir.js","sourceRoot":"","sources":["../../src/wrappers/VirtualDir.ts"],"names":[],"mappings":";;;AACA,mDAAgD;AAGhD;;GAEG;AACH,MAAa,UAAU;IAKrB,YAAY,OAAe,EAAE,WAAmB,EAAE,UAAsB;QACtE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,wCAAwC;QACxC,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,KAAK,GAAG;YAChD,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE;YACvB,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QAE9C,OAAO,IAAI,6BAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC3C,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,KAAK,GAAG;YAChD,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE;YACvB,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QAE9C,OAAO,IAAI,6BAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,KAAK,IAA4C,EAAE;gBACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACjC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;gBAC1C,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACxC,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AA5ED,gCA4EC"}

package/dist/wrappers/VirtualDirent.d.ts

@@ -0,0 +1,21 @@
+import * as fs from 'fs';
+/**
+ * Virtual Dirent that wraps a real fs.Dirent and exposes virtual paths
+ */
+export declare class VirtualDirent implements fs.Dirent {
+    private realDirent;
+    private _virtualPath;
+    private _name;
+    constructor(realDirent: fs.Dirent, virtualPath: string, name?: string);
+    get name(): string;
+    get path(): string;
+    get parentPath(): string;
+    isFile(): boolean;
+    isDirectory(): boolean;
+    isBlockDevice(): boolean;
+    isCharacterDevice(): boolean;
+    isSymbolicLink(): boolean;
+    isFIFO(): boolean;
+    isSocket(): boolean;
+}
+//# sourceMappingURL=VirtualDirent.d.ts.map

package/dist/wrappers/VirtualDirent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualDirent.d.ts","sourceRoot":"","sources":["../../src/wrappers/VirtualDirent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB;;GAEG;AACH,qBAAa,aAAc,YAAW,EAAE,CAAC,MAAM;IAC7C,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAS;gBAEV,UAAU,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAMrE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,UAAU,IAAI,MAAM,CAMvB;IAED,MAAM,IAAI,OAAO;IAIjB,WAAW,IAAI,OAAO;IAItB,aAAa,IAAI,OAAO;IAIxB,iBAAiB,IAAI,OAAO;IAI5B,cAAc,IAAI,OAAO;IAIzB,MAAM,IAAI,OAAO;IAIjB,QAAQ,IAAI,OAAO;CAGpB"}

package/dist/wrappers/VirtualDirent.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VirtualDirent = void 0;
+/**
+ * Virtual Dirent that wraps a real fs.Dirent and exposes virtual paths
+ */
+class VirtualDirent {
+    constructor(realDirent, virtualPath, name) {
+        this.realDirent = realDirent;
+        this._virtualPath = virtualPath;
+        this._name = name || realDirent.name;
+    }
+    get name() {
+        return this._name;
+    }
+    get path() {
+        return this._virtualPath;
+    }
+    get parentPath() {
+        // Return the parent directory path
+        const parts = this._virtualPath.split('/').filter(Boolean);
+        if (parts.length === 0)
+            return '/';
+        parts.pop();
+        return '/' + parts.join('/');
+    }
+    isFile() {
+        return this.realDirent.isFile();
+    }
+    isDirectory() {
+        return this.realDirent.isDirectory();
+    }
+    isBlockDevice() {
+        return this.realDirent.isBlockDevice();
+    }
+    isCharacterDevice() {
+        return this.realDirent.isCharacterDevice();
+    }
+    isSymbolicLink() {
+        return this.realDirent.isSymbolicLink();
+    }
+    isFIFO() {
+        return this.realDirent.isFIFO();
+    }
+    isSocket() {
+        return this.realDirent.isSocket();
+    }
+}
+exports.VirtualDirent = VirtualDirent;
+//# sourceMappingURL=VirtualDirent.js.map

package/dist/wrappers/VirtualDirent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualDirent.js","sourceRoot":"","sources":["../../src/wrappers/VirtualDirent.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAa,aAAa;IAKxB,YAAY,UAAqB,EAAE,WAAmB,EAAE,IAAa;QACnE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC;IACvC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,UAAU;QACZ,mCAAmC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QACnC,KAAK,CAAC,GAAG,EAAE,CAAC;QACZ,OAAO,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;IACvC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;IACzC,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;IAC7C,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;CACF;AAtDD,sCAsDC"}

package/example.js

@@ -0,0 +1,95 @@
+const { VirtualFileSystem } = require("./dist/index.js");
+const path = require("path");
+const fs = require("fs");
+
+// Create a test directory
+const testDir = path.join(__dirname, "test-data");
+if (!fs.existsSync(testDir)) {
+  fs.mkdirSync(testDir);
+}
+
+// Create a test file
+fs.writeFileSync(path.join(testDir, "example.txt"), "Hello from VFS!");
+fs.mkdirSync(path.join(testDir, "subdir"), { recursive: true });
+fs.writeFileSync(
+  path.join(testDir, "subdir", "nested.txt"),
+  "Nested file content",
+);
+
+console.log("Test directory created at:", testDir);
+console.log("");
+
+// Create VFS instance
+const vfs = new VirtualFileSystem({ root: testDir });
+const vfsFs = vfs.createNodeFSModule();
+const vfsPath = vfs.createNodePathModule();
+
+console.log("=== VirtualFileSystem Test ===\n");
+
+// Test path conversion
+console.log("1. Path Conversion:");
+console.log("   Virtual -> Real:", vfs.toRealPath("/example.txt"));
+console.log(
+  "   Real -> Virtual:",
+  vfs.toVirtualPath(path.join(testDir, "example.txt")),
+);
+console.log("");
+
+// Test read operations
+console.log("2. Read Operations:");
+console.log("   readFileSync:", vfsFs.readFileSync("/example.txt", "utf8"));
+console.log("   readdirSync:", vfsFs.readdirSync("/"));
+console.log(
+  "   statSync:",
+  vfsFs.statSync("/example.txt").isFile() ? "is a file" : "not a file",
+);
+console.log("");
+
+// Test promise API
+console.log("3. Promise API:");
+vfsFs.promises
+  .readFile("/subdir/nested.txt", "utf8")
+  .then((content) => console.log("   promises.readFile:", content))
+  .catch((err) => console.error("   Error:", err.message));
+
+// Test write operation (should fail)
+console.log("");
+console.log("4. Write Operation (should fail):");
+try {
+  vfsFs.writeFileSync("/test.txt", "data");
+} catch (err) {
+  console.log("   ✓ Write blocked with code:", err.code);
+}
+
+// Test path module
+console.log("");
+console.log("5. Path Module:");
+console.log('   resolve("."):', vfsPath.resolve("."));
+console.log('   resolve("foo/bar.txt"):', vfsPath.resolve("foo/bar.txt"));
+console.log('   join("/foo", "bar"):', vfsPath.join("/foo", "bar"));
+console.log("   sep:", vfsPath.sep);
+console.log('   dirname("/foo/bar.txt"):', vfsPath.dirname("/foo/bar.txt"));
+console.log("");
+
+// Test error filtering
+console.log("6. Error Filtering:");
+try {
+  vfsFs.readFileSync("/nonexistent.txt");
+} catch (err) {
+  console.log("   Error message:", err.message);
+  console.log("   ✓ Real path filtered (no absolute path visible)");
+}
+console.log("");
+
+// Test close
+console.log("7. Close VFS:");
+vfs.close();
+console.log("   VFS closed:", vfs.closed);
+
+try {
+  vfsFs.readFileSync("/example.txt");
+} catch (err) {
+  console.log("   ✓ Operations after close blocked with code:", err.code);
+}
+
+console.log("\n=== All Tests Passed! ===");

package/example.ts

@@ -0,0 +1,32 @@
+import { VirtualFileSystem, VFSOptions } from './dist/index';
+import * as path from 'path';
+import * as fs from 'fs';
+
+// Create test directory
+const testDir = path.join(__dirname, 'test-data');
+
+// Create VFS with TypeScript
+const options: VFSOptions = { root: testDir };
+const vfs: VirtualFileSystem = new VirtualFileSystem(options);
+
+// Get typed fs and path modules
+const vfsFs = vfs.createNodeFSModule();
+const vfsPath = vfs.createNodePathModule();
+
+// TypeScript knows the types!
+const content: string = vfsFs.readFileSync('/example.txt', 'utf8');
+const files: string[] = vfsFs.readdirSync('/') as string[];
+const resolved: string = vfsPath.resolve('foo', 'bar');
+
+console.log('TypeScript example works!');
+console.log('Content:', content);
+console.log('Files:', files);
+console.log('Resolved:', resolved);
+
+// Test promise API with async/await
+(async () => {
+  const asyncContent: string = await vfsFs.promises.readFile('/example.txt', 'utf8');
+  console.log('Async content:', asyncContent);
+})();
+
+vfs.close();

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "sandbox-fs",
+  "version": "1.0.0",
+  "description": "A read-only virtual file system that maps Unix-style virtual paths to a real directory root",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "commonjs",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "filesystem",
+    "vfs",
+    "virtual",
+    "sandbox",
+    "readonly",
+    "fs"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^18.0.0",
+    "typescript": "^5.0.0"
+  }
+}