@zenfs/core 0.9.6 → 0.10.0

package/dist/emulation/async.js

@@ -1,4 +1,4 @@
-import { ApiError, ErrorCode } from '../ApiError.js';
+import { ErrnoError, Errno } from '../error.js';
 import { BigIntStats } from '../stats.js';
 import { nop, normalizeMode } from '../utils.js';
 import { R_OK } from './constants.js';
@@ -37,7 +37,7 @@ export function stat(path, options, callback = nop) {
     callback = typeof options == 'function' ? options : callback;
     promises
         .stat(path, typeof options != 'function' ? options : {})
-        .then((stats) => callback(null, stats))
+        .then(stats => callback(undefined, stats))
         .catch(callback);
 }
 stat;
@@ -45,7 +45,7 @@ export function lstat(path, options, callback = nop) {
     callback = typeof options == 'function' ? options : callback;
     promises
         .lstat(path, typeof options != 'function' ? options : {})
-        .then(stats => callback(null, stats))
+        .then(stats => callback(undefined, stats))
         .catch(callback);
 }
 lstat;
@@ -75,7 +75,7 @@ export function open(path, flag, cbMode, cb = nop) {
     cb = typeof cbMode === 'function' ? cbMode : cb;
     promises
         .open(path, flag, mode)
-        .then(handle => cb(null, handle.fd))
+        .then(handle => cb(undefined, handle.fd))
         .catch(cb);
 }
 open;
@@ -83,7 +83,7 @@ export function readFile(filename, options, cb = nop) {
     cb = typeof options === 'function' ? options : cb;
     promises
         .readFile(filename, typeof options === 'function' ? null : options)
-        .then(data => cb(null, data))
+        .then(data => cb(undefined, data))
         .catch(cb);
 }
 readFile;
@@ -91,7 +91,7 @@ export function writeFile(filename, data, cbEncOpts, cb = nop) {
     cb = typeof cbEncOpts === 'function' ? cbEncOpts : cb;
     promises
         .writeFile(filename, data, typeof cbEncOpts != 'function' ? cbEncOpts : null)
-        .then(() => cb(null))
+        .then(() => cb(undefined))
         .catch(cb);
 }
 writeFile;
@@ -107,7 +107,7 @@ export function fstat(fd, options, cb = nop) {
     cb = typeof options == 'function' ? options : cb;
     fd2file(fd)
         .stat()
-        .then(stats => cb(null, typeof options == 'object' && options?.bigint ? new BigIntStats(stats) : stats))
+        .then(stats => cb(undefined, typeof options == 'object' && options?.bigint ? new BigIntStats(stats) : stats))
         .catch(cb);
 }
 fstat;
@@ -128,7 +128,7 @@ export function ftruncate(fd, lenOrCB, cb = nop) {
     cb = typeof lenOrCB === 'function' ? lenOrCB : cb;
     const file = fd2file(fd);
     if (length < 0) {
-        throw new ApiError(ErrorCode.EINVAL);
+        throw new ErrnoError(Errno.EINVAL);
     }
     file.truncate(length)
         .then(() => cb())
@@ -160,7 +160,7 @@ export function fdatasync(fd, cb = nop) {
 }
 fdatasync;
 export function write(fd, data, cbPosOff, cbLenEnc, cbPos, cb = nop) {
-    let buffer, offset, length, position = null, encoding;
+    let buffer, offset, length, position, encoding;
     const handle = new promises.FileHandle(fd);
     if (typeof data === 'string') {
         // Signature 1: (fd, string, [position?, [encoding?]], cb?)
@@ -179,7 +179,7 @@ export function write(fd, data, cbPosOff, cbLenEnc, cbPos, cb = nop) {
             default:
                 // ...try to find the callback and get out of here!
                 cb = typeof cbLenEnc === 'function' ? cbLenEnc : typeof cbPos === 'function' ? cbPos : cb;
-                cb(new ApiError(ErrorCode.EINVAL, 'Invalid arguments.'));
+                cb(new ErrnoError(Errno.EINVAL, 'Invalid arguments.'));
                 return;
         }
         buffer = Buffer.from(data);
@@ -188,19 +188,19 @@ export function write(fd, data, cbPosOff, cbLenEnc, cbPos, cb = nop) {
         const _cb = cb;
         handle
             .write(buffer, offset, length, position)
-            .then(({ bytesWritten }) => _cb(null, bytesWritten, buffer.toString(encoding)))
+            .then(({ bytesWritten }) => _cb(undefined, bytesWritten, buffer.toString(encoding)))
             .catch(_cb);
     }
     else {
         // Signature 2: (fd, buffer, offset, length, position?, cb?)
-        buffer = Buffer.from(data);
+        buffer = Buffer.from(data.buffer);
         offset = cbPosOff;
         length = cbLenEnc;
         position = typeof cbPos === 'number' ? cbPos : null;
         const _cb = (typeof cbPos === 'function' ? cbPos : cb);
         handle
             .write(buffer, offset, length, position)
-            .then(({ bytesWritten }) => _cb(null, bytesWritten, buffer))
+            .then(({ bytesWritten }) => _cb(undefined, bytesWritten, buffer))
             .catch(_cb);
     }
 }
@@ -220,7 +220,7 @@ write;
 export function read(fd, buffer, offset, length, position, cb = nop) {
     new promises.FileHandle(fd)
         .read(buffer, offset, length, position)
-        .then(({ bytesRead, buffer }) => cb(null, bytesRead, buffer))
+        .then(({ bytesRead, buffer }) => cb(undefined, bytesRead, buffer))
         .catch(cb);
 }
 read;
@@ -297,7 +297,7 @@ export function readdir(path, _options, cb = nop) {
     promises
         .readdir(path, options)
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        .then(entries => cb(null, entries))
+        .then(entries => cb(undefined, entries))
         .catch(cb);
 }
 readdir;
@@ -327,7 +327,7 @@ export function readlink(path, options, callback = nop) {
     callback = typeof options == 'function' ? options : callback;
     promises
         .readlink(path)
-        .then(result => callback(null, result))
+        .then(result => callback(undefined, result))
         .catch(callback);
 }
 readlink;
@@ -417,7 +417,7 @@ export function realpath(path, arg2, cb = nop) {
     cb = typeof arg2 === 'function' ? arg2 : cb;
     promises
         .realpath(path, typeof arg2 === 'function' ? null : arg2)
-        .then(result => cb(null, result))
+        .then(result => cb(undefined, result))
         .catch(cb);
 }
 realpath;
@@ -430,19 +430,19 @@ export function access(path, cbMode, cb = nop) {
         .catch(cb);
 }
 access;
-export function watchFile(filename, optsListener, listener = nop) {
-    throw ApiError.With('ENOSYS', filename, 'watchFile');
+export function watchFile(path, optsListener, listener = nop) {
+    throw ErrnoError.With('ENOSYS', path.toString(), 'watchFile');
 }
 watchFile;
 /**
  * @todo Implement
  */
-export function unwatchFile(filename, listener = nop) {
-    throw ApiError.With('ENOSYS', filename, 'unwatchFile');
+export function unwatchFile(path, listener = nop) {
+    throw ErrnoError.With('ENOSYS', path.toString(), 'unwatchFile');
 }
 unwatchFile;
-export function watch(filename, options, listener = nop) {
-    throw ApiError.With('ENOSYS', filename, 'watch');
+export function watch(path, options, listener = nop) {
+    throw ErrnoError.With('ENOSYS', path.toString(), 'watch');
 }
 watch;
 /**
@@ -480,7 +480,7 @@ export function createReadStream(path, _options) {
                 .catch(callback);
         },
     });
-    stream.path = path;
+    stream.path = path.toString();
     return stream;
 }
 createReadStream;
@@ -499,8 +499,8 @@ export function createWriteStream(path, _options) {
         async write(chunk, encoding, callback) {
             try {
                 handle || (handle = await promises.open(path, 'w', options?.mode || 0o666));
-                await handle.write(chunk, null, encoding);
-                callback(null);
+                await handle.write(chunk, 0, encoding);
+                callback(undefined);
             }
             catch (error) {
                 await handle?.close();
@@ -521,15 +521,15 @@ export function createWriteStream(path, _options) {
                 .catch(callback);
         },
     });
-    stream.path = path;
+    stream.path = path.toString();
     return stream;
 }
 createWriteStream;
 export function rm(path, options, callback = nop) {
     callback = typeof options === 'function' ? options : callback;
     promises
-        .rm(path, typeof options === 'function' ? null : options)
-        .then(() => callback(null))
+        .rm(path, typeof options === 'function' ? undefined : options)
+        .then(() => callback(undefined))
         .catch(callback);
 }
 rm;
@@ -537,60 +537,60 @@ export function mkdtemp(prefix, options, callback = nop) {
     callback = typeof options === 'function' ? options : callback;
     promises
         .mkdtemp(prefix, typeof options != 'function' ? options : null)
-        .then(result => callback(null, result))
+        .then(result => callback(undefined, result))
         .catch(callback);
 }
 mkdtemp;
-export function copyFile(src, dest, flags, callback) {
+export function copyFile(src, dest, flags, callback = nop) {
     callback = typeof flags === 'function' ? flags : callback;
     promises
-        .copyFile(src, dest, typeof flags === 'function' ? null : flags)
-        .then(() => callback(null))
+        .copyFile(src, dest, typeof flags === 'function' ? undefined : flags)
+        .then(() => callback(undefined))
         .catch(callback);
 }
 copyFile;
 export function readv(fd, buffers, position, cb = nop) {
     cb = typeof position === 'function' ? position : cb;
     new promises.FileHandle(fd)
-        .readv(buffers, typeof position === 'function' ? null : position)
-        .then(({ buffers, bytesRead }) => cb(null, bytesRead, buffers))
+        .readv(buffers, typeof position === 'function' ? undefined : position)
+        .then(({ buffers, bytesRead }) => cb(undefined, bytesRead, buffers))
         .catch(cb);
 }
 readv;
 export function writev(fd, buffers, position, cb = nop) {
     cb = typeof position === 'function' ? position : cb;
     new promises.FileHandle(fd)
-        .writev(buffers, typeof position === 'function' ? null : position)
-        .then(({ buffers, bytesWritten }) => cb(null, bytesWritten, buffers))
+        .writev(buffers, typeof position === 'function' ? undefined : position)
+        .then(({ buffers, bytesWritten }) => cb(undefined, bytesWritten, buffers))
         .catch(cb);
 }
 writev;
 export function opendir(path, options, cb = nop) {
     cb = typeof options === 'function' ? options : cb;
     promises
-        .opendir(path, typeof options === 'function' ? null : options)
-        .then(result => cb(null, result))
+        .opendir(path, typeof options === 'function' ? undefined : options)
+        .then(result => cb(undefined, result))
         .catch(cb);
 }
 opendir;
-export function cp(source, destination, opts, callback) {
+export function cp(source, destination, opts, callback = nop) {
     callback = typeof opts === 'function' ? opts : callback;
     promises
-        .cp(source, destination, typeof opts === 'function' ? null : opts)
-        .then(() => callback(null))
+        .cp(source, destination, typeof opts === 'function' ? undefined : opts)
+        .then(() => callback(undefined))
         .catch(callback);
 }
 cp;
 export function statfs(path, options, callback = nop) {
     callback = typeof options === 'function' ? options : callback;
     promises
-        .statfs(path, typeof options === 'function' ? null : options)
-        .then(result => callback(null, result))
+        .statfs(path, typeof options === 'function' ? undefined : options)
+        .then(result => callback(undefined, result))
         .catch(callback);
 }
 statfs;
 export async function openAsBlob(path, options) {
-    const handle = await promises.open(path, 'r');
+    const handle = await promises.open(path.toString(), 'r');
     const buffer = await handle.readFile();
     await handle.close();
     return new Blob([buffer], options);

package/dist/emulation/dir.js

@@ -1,5 +1,5 @@
 import { readdir } from './promises.js';
-import { ApiError, ErrorCode } from '../ApiError.js';
+import { ErrnoError, Errno } from '../error.js';
 import { readdirSync } from './sync.js';
 import { basename } from './path.js';
 export class Dirent {
@@ -38,12 +38,13 @@ export class Dirent {
 export class Dir {
     checkClosed() {
         if (this.closed) {
-            throw new ApiError(ErrorCode.EBADF, 'Can not use closed Dir');
+            throw new ErrnoError(Errno.EBADF, 'Can not use closed Dir');
         }
     }
     constructor(path) {
         this.path = path;
         this.closed = false;
+        this._entries = [];
     }
     close(cb) {
         this.closed = true;
@@ -63,16 +64,16 @@ export class Dir {
         if (!this._entries) {
             this._entries = await readdir(this.path, { withFileTypes: true });
         }
-        if (this._entries.length == 0) {
+        if (!this._entries.length) {
             return null;
         }
-        return this._entries.shift();
+        return this._entries.shift() || null;
     }
     read(cb) {
         if (!cb) {
             return this._read();
         }
-        this._read().then(value => cb(null, value));
+        this._read().then(value => cb(undefined, value));
     }
     /**
      * Synchronously read the next directory entry via `readdir(3)` as a `Dirent`.
@@ -83,10 +84,10 @@ export class Dir {
         if (!this._entries) {
             this._entries = readdirSync(this.path, { withFileTypes: true });
         }
-        if (this._entries.length == 0) {
+        if (!this._entries.length) {
             return null;
         }
-        return this._entries.shift();
+        return this._entries.shift() || null;
     }
     /**
      * Asynchronously iterates over the directory via `readdir(3)` until all entries have been read.

package/dist/emulation/index.d.ts

@@ -4,5 +4,5 @@ export * as promises from './promises.js';
 export * as constants from './constants.js';
 export * from './streams.js';
 export * from './dir.js';
-export { mountMapping, mounts, mount, umount } from './shared.js';
+export { mountObject, mounts, mount, umount } from './shared.js';
 export { Stats, BigIntStats, StatsFs } from '../stats.js';

package/dist/emulation/index.js

@@ -4,5 +4,5 @@ export * as promises from './promises.js';
 export * as constants from './constants.js';
 export * from './streams.js';
 export * from './dir.js';
-export { mountMapping, mounts, mount, umount } from './shared.js';
+export { mountObject, mounts, mount, umount } from './shared.js';
 export { Stats, BigIntStats, StatsFs } from '../stats.js';

package/dist/emulation/path.d.ts

@@ -1,14 +1,15 @@
 /// <reference types="node" resolution-mode="require"/>
 import type { ParsedPath } from 'node:path';
+export type AbsolutePath = `/${string}`;
 export declare let cwd: string;
 export declare function cd(path: string): void;
 export declare const sep = "/";
 export declare function normalizeString(path: string, allowAboveRoot: boolean): string;
 export declare function formatExt(ext: string): string;
-export declare function resolve(...args: string[]): string;
+export declare function resolve(...parts: string[]): AbsolutePath;
 export declare function normalize(path: string): string;
 export declare function isAbsolute(path: string): boolean;
-export declare function join(...args: string[]): string;
+export declare function join(...parts: string[]): string;
 export declare function relative(from: string, to: string): string;
 export declare function dirname(path: string): string;
 export declare function basename(path: string, suffix?: string): string;

package/dist/emulation/path.js

@@ -25,11 +25,6 @@ export function cd(path) {
     cwd = resolve(cwd, path);
 }
 export const sep = '/';
-function validateString(str, name) {
-    if (typeof str != 'string') {
-        throw new TypeError(`"${name}" is not a string`);
-    }
-}
 function validateObject(str, name) {
     if (typeof str != 'object') {
         throw new TypeError(`"${name}" is not an object`);
@@ -107,19 +102,18 @@ export function normalizeString(path, allowAboveRoot) {
 export function formatExt(ext) {
     return ext ? `${ext[0] === '.' ? '' : '.'}${ext}` : '';
 }
-export function resolve(...args) {
+export function resolve(...parts) {
     let resolved = '';
-    let absolute = false;
-    for (let i = args.length - 1; i >= -1 && !absolute; i--) {
-        const path = i >= 0 ? args[i] : cwd;
-        validateString(path, `paths[${i}]`);
-        // Skip empty entries
-        if (!path.length) {
+    for (const part of [...parts.reverse(), cwd]) {
+        if (!part.length) {
             continue;
         }
-        resolved = `${path}/${resolved}`;
-        absolute = path[0] == '/';
+        resolved = `${part}/${resolved}`;
+        if (part.startsWith('/')) {
+            break;
+        }
     }
+    const absolute = resolved.startsWith('/');
     // At this point the path should be resolved to a full absolute path, but
     // handle relative paths to be safe (might happen when cwd fails)
     // Normalize the path
@@ -127,17 +121,16 @@ export function resolve(...args) {
     if (absolute) {
         return `/${resolved}`;
     }
-    return resolved.length > 0 ? resolved : '/';
+    return resolved.length ? resolved : '/';
 }
 export function normalize(path) {
-    validateString(path, 'path');
-    if (path.length === 0)
+    if (!path.length)
         return '.';
-    const isAbsolute = path[0] === '/';
-    const trailingSeparator = path.at(-1) === '/';
+    const isAbsolute = path.startsWith('/');
+    const trailingSeparator = path.endsWith('/');
     // Normalize the path
     path = normalizeString(path, !isAbsolute);
-    if (path.length === 0) {
+    if (!path.length) {
         if (isAbsolute)
             return '/';
         return trailingSeparator ? './' : '.';
@@ -147,30 +140,17 @@ export function normalize(path) {
     return isAbsolute ? `/${path}` : path;
 }
 export function isAbsolute(path) {
-    validateString(path, 'path');
-    return path.length > 0 && path[0] === '/';
+    return path.startsWith('/');
 }
-export function join(...args) {
-    if (args.length === 0)
+export function join(...parts) {
+    if (!parts.length)
         return '.';
-    let joined;
-    for (let i = 0; i < args.length; ++i) {
-        const arg = args[i];
-        validateString(arg, 'path');
-        if (arg.length > 0) {
-            if (joined === undefined)
-                joined = arg;
-            else
-                joined += `/${arg}`;
-        }
-    }
-    if (joined === undefined)
+    const joined = parts.join('/');
+    if (!joined?.length)
         return '.';
     return normalize(joined);
 }
 export function relative(from, to) {
-    validateString(from, 'from');
-    validateString(to, 'to');
     if (from === to)
         return '';
     // Trim leading forward slashes.
@@ -233,7 +213,6 @@ export function relative(from, to) {
     return `${out}${to.slice(toStart + lastCommonSep)}`;
 }
 export function dirname(path) {
-    validateString(path, 'path');
     if (path.length === 0)
         return '.';
     const hasRoot = path[0] === '/';
@@ -258,9 +237,6 @@ export function dirname(path) {
     return path.slice(0, end);
 }
 export function basename(path, suffix) {
-    if (suffix !== undefined)
-        validateString(suffix, 'ext');
-    validateString(path, 'path');
     let start = 0;
     let end = -1;
     let matchedSlash = true;
@@ -330,7 +306,6 @@ export function basename(path, suffix) {
     return path.slice(start, end);
 }
 export function extname(path) {
-    validateString(path, 'path');
     let startDot = -1;
     let startPart = 0;
     let end = -1;
@@ -387,8 +362,7 @@ export function format(pathObject) {
     return dir === pathObject.root ? `${dir}${base}` : `${dir}/${base}`;
 }
 export function parse(path) {
-    validateString(path, 'path');
-    const isAbsolute = path[0] === '/';
+    const isAbsolute = path.startsWith('/');
     const ret = { root: isAbsolute ? '/' : '', dir: '', base: '', ext: '', name: '' };
     if (path.length === 0)
         return ret;