@zenfs/core 0.7.10 → 0.8.0

package/dist/emulation/async.d.ts

@@ -2,8 +2,9 @@
 /// <reference types="node" resolution-mode="require"/>
 /// <reference types="node" resolution-mode="require"/>
 import type * as Node from 'fs';
-import { FileContents, NoArgCallback, ThreeArgCallback, TwoArgCallback } from '../filesystem.js';
+import type { FileContents } from '../filesystem.js';
 import { BigIntStats, type BigIntStatsFs, type Stats, type StatsFs } from '../stats.js';
+import type { Callback } from '../utils.js';
 import { Dirent, type Dir } from './dir.js';
 import { PathLike } from './shared.js';
 import { ReadStream, WriteStream } from './streams.js';
@@ -14,7 +15,7 @@ import { ReadStream, WriteStream } from './streams.js';
  * @param newPath
  * @param callback
  */
-export declare function rename(oldPath: PathLike, newPath: PathLike, cb?: NoArgCallback): void;
+export declare function rename(oldPath: PathLike, newPath: PathLike, cb?: Callback): void;
 /**
  * Test whether or not the given path exists by checking with the file system.
  * Then call the callback argument with either true or false.
@@ -28,14 +29,14 @@ export declare function exists(path: PathLike, cb?: (exists: boolean) => unknown
  * @param path
  * @param callback
  */
-export declare function stat(path: PathLike, callback: TwoArgCallback<Stats>): void;
-export declare function stat(path: PathLike, options: Node.StatOptions & {
+export declare function stat(path: PathLike, callback: Callback<[Stats]>): void;
+export declare function stat(path: PathLike, options: {
     bigint?: false;
-}, callback: TwoArgCallback<Stats>): void;
-export declare function stat(path: PathLike, options: Node.StatOptions & {
+}, callback: Callback<[Stats]>): void;
+export declare function stat(path: PathLike, options: {
     bigint: true;
-}, callback: TwoArgCallback<BigIntStats>): void;
-export declare function stat(path: PathLike, options: Node.StatOptions, callback: TwoArgCallback<Stats | BigIntStats>): void;
+}, callback: Callback<[BigIntStats]>): void;
+export declare function stat(path: PathLike, options: Node.StatOptions, callback: Callback<[Stats] | [BigIntStats]>): void;
 /**
  * Asynchronous `lstat`.
  * `lstat()` is identical to `stat()`, except that if path is a symbolic link,
@@ -43,28 +44,28 @@ export declare function stat(path: PathLike, options: Node.StatOptions, callback
  * @param path
  * @param callback
  */
-export declare function lstat(path: PathLike, callback: TwoArgCallback<Stats>): void;
+export declare function lstat(path: PathLike, callback: Callback<[Stats]>): void;
 export declare function lstat(path: PathLike, options: Node.StatOptions & {
     bigint?: false;
-}, callback: TwoArgCallback<Stats>): void;
+}, callback: Callback<[Stats]>): void;
 export declare function lstat(path: PathLike, options: Node.StatOptions & {
     bigint: true;
-}, callback: TwoArgCallback<BigIntStats>): void;
-export declare function lstat(path: PathLike, options: Node.StatOptions, callback: TwoArgCallback<Stats | BigIntStats>): void;
+}, callback: Callback<[BigIntStats]>): void;
+export declare function lstat(path: PathLike, options: Node.StatOptions, callback: Callback<[Stats | BigIntStats]>): void;
 /**
  * Asynchronous `truncate`.
  * @param path
  * @param len
  * @param callback
  */
-export declare function truncate(path: PathLike, cb?: NoArgCallback): void;
-export declare function truncate(path: PathLike, len: number, cb?: NoArgCallback): void;
+export declare function truncate(path: PathLike, cb?: Callback): void;
+export declare function truncate(path: PathLike, len: number, cb?: Callback): void;
 /**
  * Asynchronous `unlink`.
  * @param path
  * @param callback
  */
-export declare function unlink(path: PathLike, cb?: NoArgCallback): void;
+export declare function unlink(path: PathLike, cb?: Callback): void;
 /**
  * Asynchronous file open.
  * Exclusive mode ensures that path is newly created.
@@ -90,8 +91,8 @@ export declare function unlink(path: PathLike, cb?: NoArgCallback): void;
  * @param mode defaults to `0644`
  * @param callback
  */
-export declare function open(path: PathLike, flag: string, cb?: TwoArgCallback<number>): void;
-export declare function open(path: PathLike, flag: string, mode: number | string, cb?: TwoArgCallback<number>): void;
+export declare function open(path: PathLike, flag: string, cb?: Callback<[number]>): void;
+export declare function open(path: PathLike, flag: string, mode: number | string, cb?: Callback<[number]>): void;
 /**
  * Asynchronously reads the entire contents of a file.
  * @param filename
@@ -100,14 +101,14 @@ export declare function open(path: PathLike, flag: string, mode: number | string
  * @option options flag Defaults to `'r'`.
  * @param callback If no encoding is specified, then the raw buffer is returned.
  */
-export declare function readFile(filename: PathLike, cb: TwoArgCallback<Uint8Array>): void;
+export declare function readFile(filename: PathLike, cb: Callback<[Uint8Array]>): void;
 export declare function readFile(filename: PathLike, options: {
     flag?: string;
-}, callback?: TwoArgCallback<Uint8Array>): void;
+}, callback?: Callback<[Uint8Array]>): void;
 export declare function readFile(filename: PathLike, options: {
     encoding: BufferEncoding;
     flag?: string;
-} | BufferEncoding, cb: TwoArgCallback<string>): void;
+} | BufferEncoding, cb: Callback<[string]>): void;
 /**
  * Asynchronously writes data to a file, replacing the file if it already
  * exists.
@@ -122,9 +123,9 @@ export declare function readFile(filename: PathLike, options: {
  * @option flag Defaults to `'w'`.
  * @param callback
  */
-export declare function writeFile(filename: PathLike, data: FileContents, cb?: NoArgCallback): void;
-export declare function writeFile(filename: PathLike, data: FileContents, encoding?: BufferEncoding, cb?: NoArgCallback): void;
-export declare function writeFile(filename: PathLike, data: FileContents, options?: Node.WriteFileOptions, cb?: NoArgCallback): void;
+export declare function writeFile(filename: PathLike, data: FileContents, cb?: Callback): void;
+export declare function writeFile(filename: PathLike, data: FileContents, encoding?: BufferEncoding, cb?: Callback): void;
+export declare function writeFile(filename: PathLike, data: FileContents, options?: Node.WriteFileOptions, cb?: Callback): void;
 /**
  * Asynchronously append data to a file, creating the file if it not yet
  * exists.
@@ -137,13 +138,13 @@ export declare function writeFile(filename: PathLike, data: FileContents, option
  * @option flag Defaults to `'a'`.
  * @param callback
  */
-export declare function appendFile(filename: PathLike, data: FileContents, cb?: NoArgCallback): void;
+export declare function appendFile(filename: PathLike, data: FileContents, cb?: Callback): void;
 export declare function appendFile(filename: PathLike, data: FileContents, options?: {
     encoding?: string;
     mode?: number | string;
     flag?: string;
-}, cb?: NoArgCallback): void;
-export declare function appendFile(filename: PathLike, data: FileContents, encoding?: string, cb?: NoArgCallback): void;
+}, cb?: Callback): void;
+export declare function appendFile(filename: PathLike, data: FileContents, encoding?: string, cb?: Callback): void;
 /**
  * Asynchronous `fstat`.
  * `fstat()` is identical to `stat()`, except that the file to be stat-ed is
@@ -151,39 +152,39 @@ export declare function appendFile(filename: PathLike, data: FileContents, encod
  * @param fd
  * @param callback
  */
-export declare function fstat(fd: number, cb: TwoArgCallback<Stats>): void;
+export declare function fstat(fd: number, cb: Callback<[Stats]>): void;
 export declare function fstat(fd: number, options: Node.StatOptions & {
     bigint?: false;
-}, cb: TwoArgCallback<Stats>): void;
+}, cb: Callback<[Stats]>): void;
 export declare function fstat(fd: number, options: Node.StatOptions & {
     bigint: true;
-}, cb: TwoArgCallback<BigIntStats>): void;
+}, cb: Callback<[BigIntStats]>): void;
 /**
  * Asynchronous close.
  * @param fd
  * @param callback
  */
-export declare function close(fd: number, cb?: NoArgCallback): void;
+export declare function close(fd: number, cb?: Callback): void;
 /**
  * Asynchronous ftruncate.
  * @param fd
  * @param len
  * @param callback
  */
-export declare function ftruncate(fd: number, cb?: NoArgCallback): void;
-export declare function ftruncate(fd: number, len?: number, cb?: NoArgCallback): void;
+export declare function ftruncate(fd: number, cb?: Callback): void;
+export declare function ftruncate(fd: number, len?: number, cb?: Callback): void;
 /**
  * Asynchronous fsync.
  * @param fd
  * @param callback
  */
-export declare function fsync(fd: number, cb?: NoArgCallback): void;
+export declare function fsync(fd: number, cb?: Callback): void;
 /**
  * Asynchronous fdatasync.
  * @param fd
  * @param callback
  */
-export declare function fdatasync(fd: number, cb?: NoArgCallback): void;
+export declare function fdatasync(fd: number, cb?: Callback): void;
 /**
  * Write buffer to the file specified by `fd`.
  * Note that it is unsafe to use fs.write multiple times on the same file
@@ -198,11 +199,11 @@ export declare function fdatasync(fd: number, cb?: NoArgCallback): void;
  *   the current position.
  * @param callback The number specifies the number of bytes written into the file.
  */
-export declare function write(fd: number, buffer: Uint8Array, offset: number, length: number, cb?: ThreeArgCallback<number, Uint8Array>): void;
-export declare function write(fd: number, buffer: Uint8Array, offset: number, length: number, position?: number, cb?: ThreeArgCallback<number, Uint8Array>): void;
-export declare function write(fd: number, data: FileContents, cb?: ThreeArgCallback<number, string>): void;
-export declare function write(fd: number, data: FileContents, position?: number, cb?: ThreeArgCallback<number, string>): void;
-export declare function write(fd: number, data: FileContents, position: number | null, encoding: BufferEncoding, cb?: ThreeArgCallback<number, string>): void;
+export declare function write(fd: number, buffer: Uint8Array, offset: number, length: number, cb?: Callback<[number, Uint8Array]>): void;
+export declare function write(fd: number, buffer: Uint8Array, offset: number, length: number, position?: number, cb?: Callback<[number, Uint8Array]>): void;
+export declare function write(fd: number, data: FileContents, cb?: Callback<[number, string]>): void;
+export declare function write(fd: number, data: FileContents, position?: number, cb?: Callback<[number, string]>): void;
+export declare function write(fd: number, data: FileContents, position: number | null, encoding: BufferEncoding, cb?: Callback<[number, string]>): void;
 /**
  * Read data from the file specified by `fd`.
  * @param buffer The buffer that the data will be
@@ -215,7 +216,7 @@ export declare function write(fd: number, data: FileContents, position: number |
  *   position.
  * @param callback The number is the number of bytes read
  */
-export declare function read(fd: number, buffer: Uint8Array, offset: number, length: number, position?: number, cb?: ThreeArgCallback<number, Uint8Array>): void;
+export declare function read(fd: number, buffer: Uint8Array, offset: number, length: number, position?: number, cb?: Callback<[number, Uint8Array]>): void;
 /**
  * Asynchronous `fchown`.
  * @param fd
@@ -223,14 +224,14 @@ export declare function read(fd: number, buffer: Uint8Array, offset: number, len
  * @param gid
  * @param callback
  */
-export declare function fchown(fd: number, uid: number, gid: number, cb?: NoArgCallback): void;
+export declare function fchown(fd: number, uid: number, gid: number, cb?: Callback): void;
 /**
  * Asynchronous `fchmod`.
  * @param fd
  * @param mode
  * @param callback
  */
-export declare function fchmod(fd: number, mode: string | number, cb: NoArgCallback): void;
+export declare function fchmod(fd: number, mode: string | number, cb: Callback): void;
 /**
  * Change the file timestamps of a file referenced by the supplied file
  * descriptor.
@@ -239,20 +240,20 @@ export declare function fchmod(fd: number, mode: string | number, cb: NoArgCallb
  * @param mtime
  * @param callback
  */
-export declare function futimes(fd: number, atime: number | Date, mtime: number | Date, cb?: NoArgCallback): void;
+export declare function futimes(fd: number, atime: number | Date, mtime: number | Date, cb?: Callback): void;
 /**
  * Asynchronous `rmdir`.
  * @param path
  * @param callback
  */
-export declare function rmdir(path: PathLike, cb?: NoArgCallback): void;
+export declare function rmdir(path: PathLike, cb?: Callback): void;
 /**
  * Asynchronous `mkdir`.
  * @param path
  * @param mode defaults to `0777`
  * @param callback
  */
-export declare function mkdir(path: PathLike, mode?: Node.Mode, cb?: NoArgCallback): void;
+export declare function mkdir(path: PathLike, mode?: Node.Mode, cb?: Callback): void;
 /**
  * Asynchronous `readdir`. Reads the contents of a directory.
  * The callback gets two arguments `(err, files)` where `files` is an array of
@@ -260,20 +261,20 @@ export declare function mkdir(path: PathLike, mode?: Node.Mode, cb?: NoArgCallba
  * @param path
  * @param callback
  */
-export declare function readdir(path: PathLike, cb: TwoArgCallback<string[]>): void;
+export declare function readdir(path: PathLike, cb: Callback<[string[]]>): void;
 export declare function readdir(path: PathLike, options: {
     withFileTypes?: false;
-}, cb: TwoArgCallback<string[]>): void;
+}, cb: Callback<[string[]]>): void;
 export declare function readdir(path: PathLike, options: {
     withFileTypes: true;
-}, cb: TwoArgCallback<Dirent[]>): void;
+}, cb: Callback<[Dirent[]]>): void;
 /**
  * Asynchronous `link`.
  * @param existing
  * @param newpath
  * @param callback
  */
-export declare function link(existing: PathLike, newpath: PathLike, cb?: NoArgCallback): void;
+export declare function link(existing: PathLike, newpath: PathLike, cb?: Callback): void;
 /**
  * Asynchronous `symlink`.
  * @param target target path
@@ -281,17 +282,17 @@ export declare function link(existing: PathLike, newpath: PathLike, cb?: NoArgCa
  * @param type can be either `'dir'` or `'file'` (default is `'file'`)
  * @param callback
  */
-export declare function symlink(target: PathLike, path: PathLike, cb?: NoArgCallback): void;
-export declare function symlink(target: PathLike, path: PathLike, type?: Node.symlink.Type, cb?: NoArgCallback): void;
+export declare function symlink(target: PathLike, path: PathLike, cb?: Callback): void;
+export declare function symlink(target: PathLike, path: PathLike, type?: Node.symlink.Type, cb?: Callback): void;
 /**
  * Asynchronous readlink.
  * @param path
  * @param callback
  */
-export declare function readlink(path: PathLike, callback: TwoArgCallback<string> & any): void;
-export declare function readlink(path: PathLike, options: Node.BufferEncodingOption, callback: TwoArgCallback<Uint8Array>): void;
-export declare function readlink(path: PathLike, options: Node.EncodingOption, callback: TwoArgCallback<string | Uint8Array>): void;
-export declare function readlink(path: PathLike, options: Node.EncodingOption, callback: TwoArgCallback<string>): void;
+export declare function readlink(path: PathLike, callback: Callback<[string]> & any): void;
+export declare function readlink(path: PathLike, options: Node.BufferEncodingOption, callback: Callback<[Uint8Array]>): void;
+export declare function readlink(path: PathLike, options: Node.EncodingOption, callback: Callback<[string | Uint8Array]>): void;
+export declare function readlink(path: PathLike, options: Node.EncodingOption, callback: Callback<[string]>): void;
 /**
  * Asynchronous `chown`.
  * @param path
@@ -299,7 +300,7 @@ export declare function readlink(path: PathLike, options: Node.EncodingOption, c
  * @param gid
  * @param callback
  */
-export declare function chown(path: PathLike, uid: number, gid: number, cb?: NoArgCallback): void;
+export declare function chown(path: PathLike, uid: number, gid: number, cb?: Callback): void;
 /**
  * Asynchronous `lchown`.
  * @param path
@@ -307,21 +308,21 @@ export declare function chown(path: PathLike, uid: number, gid: number, cb?: NoA
  * @param gid
  * @param callback
  */
-export declare function lchown(path: PathLike, uid: number, gid: number, cb?: NoArgCallback): void;
+export declare function lchown(path: PathLike, uid: number, gid: number, cb?: Callback): void;
 /**
  * Asynchronous `chmod`.
  * @param path
  * @param mode
  * @param callback
  */
-export declare function chmod(path: PathLike, mode: number | string, cb?: NoArgCallback): void;
+export declare function chmod(path: PathLike, mode: number | string, cb?: Callback): void;
 /**
  * Asynchronous `lchmod`.
  * @param path
  * @param mode
  * @param callback
  */
-export declare function lchmod(path: PathLike, mode: number | string, cb?: NoArgCallback): void;
+export declare function lchmod(path: PathLike, mode: number | string, cb?: Callback): void;
 /**
  * Change file timestamps of the file referenced by the supplied path.
  * @param path
@@ -329,7 +330,7 @@ export declare function lchmod(path: PathLike, mode: number | string, cb?: NoArg
  * @param mtime
  * @param callback
  */
-export declare function utimes(path: PathLike, atime: number | Date, mtime: number | Date, cb?: NoArgCallback): void;
+export declare function utimes(path: PathLike, atime: number | Date, mtime: number | Date, cb?: Callback): void;
 /**
  * Change file timestamps of the file referenced by the supplied path.
  * @param path
@@ -337,7 +338,7 @@ export declare function utimes(path: PathLike, atime: number | Date, mtime: numb
  * @param mtime
  * @param callback
  */
-export declare function lutimes(path: PathLike, atime: number | Date, mtime: number | Date, cb?: NoArgCallback): void;
+export declare function lutimes(path: PathLike, atime: number | Date, mtime: number | Date, cb?: Callback): void;
 /**
  * Asynchronous `realpath`. The callback gets two arguments
  * `(err, resolvedPath)`. May use `process.cwd` to resolve relative paths.
@@ -345,16 +346,16 @@ export declare function lutimes(path: PathLike, atime: number | Date, mtime: num
  * @param path
  * @param callback
  */
-export declare function realpath(path: PathLike, cb?: TwoArgCallback<string>): void;
-export declare function realpath(path: PathLike, options: Node.EncodingOption, cb: TwoArgCallback<string>): void;
+export declare function realpath(path: PathLike, cb?: Callback<[string]>): void;
+export declare function realpath(path: PathLike, options: Node.EncodingOption, cb: Callback<[string]>): void;
 /**
  * Asynchronous `access`.
  * @param path
  * @param mode
  * @param callback
  */
-export declare function access(path: PathLike, cb: NoArgCallback): void;
-export declare function access(path: PathLike, mode: number, cb: NoArgCallback): void;
+export declare function access(path: PathLike, cb: Callback): void;
+export declare function access(path: PathLike, mode: number, cb: Callback): void;
 /**
  * @todo Implement
  */
@@ -393,33 +394,33 @@ export declare function createWriteStream(path: PathLike, options?: {
     fd?: number;
     mode?: number;
 }): WriteStream;
-export declare function rm(path: PathLike, callback: NoArgCallback): void;
-export declare function rm(path: PathLike, options: Node.RmOptions, callback: NoArgCallback): void;
+export declare function rm(path: PathLike, callback: Callback): void;
+export declare function rm(path: PathLike, options: Node.RmOptions, callback: Callback): void;
 /**
  * Asynchronously creates a unique temporary directory.
  * Generates six random characters to be appended behind a required prefix to create a unique temporary directory.
  */
-export declare function mkdtemp(prefix: string, callback: TwoArgCallback<string>): void;
-export declare function mkdtemp(prefix: string, options: Node.EncodingOption, callback: TwoArgCallback<string>): void;
-export declare function mkdtemp(prefix: string, options: Node.BufferEncodingOption, callback: TwoArgCallback<Buffer>): void;
-export declare function copyFile(src: PathLike, dest: PathLike, callback: NoArgCallback): void;
-export declare function copyFile(src: PathLike, dest: PathLike, flags: number, callback: NoArgCallback): void;
-type readvCb = ThreeArgCallback<number, NodeJS.ArrayBufferView[]>;
+export declare function mkdtemp(prefix: string, callback: Callback<[string]>): void;
+export declare function mkdtemp(prefix: string, options: Node.EncodingOption, callback: Callback<[string]>): void;
+export declare function mkdtemp(prefix: string, options: Node.BufferEncodingOption, callback: Callback<[Buffer]>): void;
+export declare function copyFile(src: PathLike, dest: PathLike, callback: Callback): void;
+export declare function copyFile(src: PathLike, dest: PathLike, flags: number, callback: Callback): void;
+type readvCb = Callback<[number, NodeJS.ArrayBufferView[]]>;
 export declare function readv(fd: number, buffers: readonly NodeJS.ArrayBufferView[], cb: readvCb): void;
 export declare function readv(fd: number, buffers: readonly NodeJS.ArrayBufferView[], position: number, cb: readvCb): void;
-type writevCb = ThreeArgCallback<number, NodeJS.ArrayBufferView[]>;
+type writevCb = Callback<[number, NodeJS.ArrayBufferView[]]>;
 export declare function writev(fd: number, buffers: NodeJS.ArrayBufferView[], cb: writevCb): void;
 export declare function writev(fd: number, buffers: NodeJS.ArrayBufferView[], position: number, cb: writevCb): void;
-export declare function opendir(path: PathLike, cb: TwoArgCallback<Dir>): void;
-export declare function opendir(path: PathLike, options: Node.OpenDirOptions, cb: TwoArgCallback<Dir>): void;
-export declare function cp(source: PathLike, destination: PathLike, callback: NoArgCallback): void;
-export declare function cp(source: PathLike, destination: PathLike, opts: Node.CopyOptions, callback: NoArgCallback): void;
-export declare function statfs(path: PathLike, callback: TwoArgCallback<StatsFs>): void;
+export declare function opendir(path: PathLike, cb: Callback<[Dir]>): void;
+export declare function opendir(path: PathLike, options: Node.OpenDirOptions, cb: Callback<[Dir]>): void;
+export declare function cp(source: PathLike, destination: PathLike, callback: Callback): void;
+export declare function cp(source: PathLike, destination: PathLike, opts: Node.CopyOptions, callback: Callback): void;
+export declare function statfs(path: PathLike, callback: Callback<[StatsFs]>): void;
 export declare function statfs(path: PathLike, options: Node.StatFsOptions & {
     bigint?: false;
-}, callback: TwoArgCallback<StatsFs>): void;
+}, callback: Callback<[StatsFs]>): void;
 export declare function statfs(path: PathLike, options: Node.StatFsOptions & {
     bigint: true;
-}, callback: TwoArgCallback<BigIntStatsFs>): void;
+}, callback: Callback<[BigIntStatsFs]>): void;
 export declare function openAsBlob(path: PathLike, options?: Node.OpenAsBlobOptions): Promise<Blob>;
 export {};

package/dist/emulation/async.js

@@ -35,7 +35,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(null, stats))
         .catch(callback);
 }
 stat;
@@ -105,7 +105,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(null, typeof options == 'object' && options?.bigint ? new BigIntStats(stats) : stats))
         .catch(cb);
 }
 fstat;

package/dist/emulation/dir.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" resolution-mode="require"/>
 import type { Dirent as _Dirent, Dir as _Dir } from 'fs';
-import type { NoArgCallback, TwoArgCallback } from '../filesystem.js';
+import type { Callback } from '../utils.js';
 import type { Stats } from '../stats.js';
 export declare class Dirent implements _Dirent {
     path: string;
@@ -29,7 +29,7 @@ export declare class Dir implements _Dir {
      * Subsequent reads will result in errors.
      */
     close(): Promise<void>;
-    close(cb: NoArgCallback): void;
+    close(cb: Callback): void;
     /**
      * Synchronously close the directory's underlying resource handle.
      * Subsequent reads will result in errors.
@@ -42,7 +42,7 @@ export declare class Dir implements _Dir {
      * Directory entries returned by this function are in no particular order as provided by the operating system's underlying directory mechanisms.
      */
     read(): Promise<Dirent | null>;
-    read(cb: TwoArgCallback<Dirent | null>): void;
+    read(cb: Callback<[Dirent | null]>): void;
     /**
      * Synchronously read the next directory entry via `readdir(3)` as a `Dirent`.
      * If there are no more directory entries to read, null will be returned.

package/dist/emulation/promises.js

@@ -416,7 +416,7 @@ readFile;
  * @option options flag Defaults to `'w'`.
  */
 export async function writeFile(filename, data, _options) {
-    const options = normalizeOptions(_options, 'utf8', 'w', 0o644);
+    const options = normalizeOptions(_options, 'utf8', 'w+', 0o644);
     const handle = await open(filename, options.flag, options.mode);
     try {
         await handle.writeFile(data, options);

package/dist/emulation/streams.d.ts

@@ -2,9 +2,9 @@
 /// <reference types="node" resolution-mode="require"/>
 import type * as Node from 'fs';
 import { Readable, Writable } from 'readable-stream';
-import { NoArgCallback } from '../filesystem.js';
+import { Callback } from '../utils.js';
 export declare class ReadStream extends Readable implements Node.ReadStream {
-    close(callback?: NoArgCallback): void;
+    close(callback?: Callback): void;
     bytesRead: number;
     path: string | Buffer;
     pending: boolean;
@@ -55,7 +55,7 @@ export declare class ReadStream extends Readable implements Node.ReadStream {
     prependOnceListener(event: 'resume', listener: () => void): this;
 }
 export declare class WriteStream extends Writable implements Node.WriteStream {
-    close(callback?: NoArgCallback): void;
+    close(callback?: Callback): void;
     bytesWritten: number;
     path: string | Buffer;
     pending: boolean;

package/dist/emulation/sync.js

@@ -199,7 +199,7 @@ function _writeFileSync(fname, data, flag, mode, resolveSymlinks) {
     }
 }
 export function writeFileSync(filename, data, _options) {
-    const options = normalizeOptions(_options, 'utf8', 'w', 0o644);
+    const options = normalizeOptions(_options, 'utf8', 'w+', 0o644);
     const flag = parseFlag(options.flag);
     if (!isWriteable(flag)) {
         throw new ApiError(ErrorCode.EINVAL, 'Flag passed to writeFile must allow for writing.');

package/dist/filesystem.d.ts

@@ -1,10 +1,6 @@
-import { ApiError } from './ApiError.js';
-import type { Stats } from './stats.js';
-import { type File } from './file.js';
 import { type Cred } from './cred.js';
-export type NoArgCallback = (e?: ApiError) => unknown;
-export type TwoArgCallback<T> = (e?: ApiError, rv?: T) => unknown;
-export type ThreeArgCallback<T, U> = (e?: ApiError, arg1?: T, arg2?: U) => unknown;
+import { type File } from './file.js';
+import type { Stats } from './stats.js';
 export type FileContents = Uint8Array | string;
 /**
  * Metadata about a FileSystem
@@ -18,10 +14,6 @@ export interface FileSystemMetadata {
      * Wheter the FS is readonly or not
      */
     readonly: boolean;
-    /**
-     * Does the FS support properties
-     */
-    supportsProperties: boolean;
     /**
      * The total space
      */

package/dist/filesystem.js

@@ -1,7 +1,7 @@
 import { ApiError, ErrorCode } from './ApiError.js';
-import { PreloadFile, parseFlag } from './file.js';
 import { rootCred } from './cred.js';
 import { join } from './emulation/path.js';
+import { PreloadFile, parseFlag } from './file.js';
 /**
  * Structure for a filesystem. All ZenFS FileSystems must implement this.
  *
@@ -20,7 +20,6 @@ export class FileSystem {
         return {
             name: this.constructor.name,
             readonly: false,
-            supportsProperties: false,
             totalSpace: 0,
             freeSpace: 0,
         };
@@ -125,6 +124,7 @@ export function Async(FS) {
             this._isInitialized = false;
         }
         async ready() {
+            await this._sync.ready();
             if (this._isInitialized) {
                 return this;
             }

package/dist/utils.d.ts

@@ -1,5 +1,7 @@
-import { FileSystem } from './filesystem.js';
+import type { OptionalTuple } from 'utilium';
+import { ApiError } from './ApiError.js';
 import { Cred } from './cred.js';
+import { FileSystem } from './filesystem.js';
 declare global {
     function atob(data: string): string;
     function btoa(data: string): string;
@@ -14,11 +16,6 @@ export declare function mkdirpSync(p: string, mode: number, cred: Cred, fs: File
  * @hidden
  */
 export declare function levenshtein(a: string, b: string): number;
-/**
- * Waits n ms.
- * @hidden
- */
-export declare function wait(ms: number): Promise<void>;
 /**
  * @hidden
  */
@@ -43,20 +40,4 @@ export declare function decodeDirListing(data: Uint8Array): Record<string, bigin
  * @hidden
  */
 export declare function encodeDirListing(data: Record<string, bigint>): Uint8Array;
-/**
- * Extracts an object of properties assignable to P from an object T
- * @hidden
- */
-export type ExtractProperties<T, P> = {
-    [K in keyof T as T[K] extends infer Prop ? (Prop extends P ? K : never) : never]: T[K];
-};
-/**
- * Extract a the keys in T which are required properties
- * @hidden
- * @see https://stackoverflow.com/a/55247867/17637456
- */
-export type RequiredKeys<T> = {
-    [K in keyof T]-?: {} extends {
-        [P in K]: T[K];
-    } ? never : K;
-}[keyof T];
+export type Callback<Args extends unknown[] = []> = (e?: ApiError, ...args: OptionalTuple<Args>) => unknown;

package/dist/utils.js

@@ -83,15 +83,6 @@ export function levenshtein(a, b) {
     }
     return dd;
 }
-/**
- * Waits n ms.
- * @hidden
- */
-export function wait(ms) {
-    return new Promise(resolve => {
-        setTimeout(resolve, ms);
-    });
-}
 /**
  * @hidden
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zenfs/core",
-	"version": "0.7.10",
+	"version": "0.8.0",
 	"description": "A filesystem in your browser",
 	"main": "dist/index.js",
 	"types": "dist",
@@ -57,7 +57,8 @@
 		"@types/readable-stream": "^4.0.10",
 		"buffer": "^6.0.3",
 		"minimatch": "^9.0.3",
-		"readable-stream": "^4.5.2"
+		"readable-stream": "^4.5.2",
+		"utilium": "^0.2.0"
 	},
 	"devDependencies": {
 		"@fal-works/esbuild-plugin-global-externals": "^2.1.2",