@zenfs/core 0.3.4 → 0.4.0

package/dist/cred.d.ts

@@ -1,5 +1,5 @@
 /**
- * Credentials used for FS ops.
+ * Credentials used for various operations.
  * Similar to Linux's cred struct. See https://github.com/torvalds/linux/blob/master/include/linux/cred.h
  */
 export declare class Cred {

package/dist/cred.js

@@ -1,5 +1,5 @@
 /**
- * Credentials used for FS ops.
+ * Credentials used for various operations.
  * Similar to Linux's cred struct. See https://github.com/torvalds/linux/blob/master/include/linux/cred.h
  */
 export class Cred {

package/dist/emulation/callbacks.d.ts

@@ -2,7 +2,7 @@
 /// <reference types="node" resolution-mode="require"/>
 import type * as Node from 'fs';
 import { TwoArgCallback, NoArgCallback, ThreeArgCallback, FileContents } from '../filesystem.js';
-import { BigIntStats, Stats } from '../stats.js';
+import { BigIntStats, type Stats } from '../stats.js';
 import { PathLike } from './shared.js';
 import { ReadStream, WriteStream } from './streams.js';
 import { Dirent } from './dir.js';

package/dist/emulation/callbacks.js

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

package/dist/emulation/constants.d.ts

@@ -1,10 +1,10 @@
-/** Constant for fs.access(). File is visible to the calling process. */
+/** File is visible to the calling process. */
 export declare const F_OK = 0;
-/** Constant for fs.access(). File can be read by the calling process. */
+/** File can be read by the calling process. */
 export declare const R_OK = 4;
-/** Constant for fs.access(). File can be written by the calling process. */
+/** File can be written by the calling process. */
 export declare const W_OK = 2;
-/** Constant for fs.access(). File can be executed by the calling process. */
+/** File can be executed by the calling process. */
 export declare const X_OK = 1;
 /** Constant for fs.copyFile. Flag indicating the destination file should not be overwritten if it already exists. */
 export declare const COPYFILE_EXCL = 1;
@@ -18,27 +18,27 @@ export declare const COPYFILE_FICLONE = 2;
  * If the underlying platform does not support copy-on-write, then the operation will fail with an error.
  */
 export declare const COPYFILE_FICLONE_FORCE = 4;
-/** Constant for fs.open(). Flag indicating to open a file for read-only access. */
+/** Flag indicating to open a file for read-only access. */
 export declare const O_RDONLY = 0;
-/** Constant for fs.open(). Flag indicating to open a file for write-only access. */
+/** Flag indicating to open a file for write-only access. */
 export declare const O_WRONLY = 1;
-/** Constant for fs.open(). Flag indicating to open a file for read-write access. */
+/** Flag indicating to open a file for read-write access. */
 export declare const O_RDWR = 2;
-/** Constant for fs.open(). Flag indicating to create the file if it does not already exist. */
+/** Flag indicating to create the file if it does not already exist. */
 export declare const O_CREAT = 64;
-/** Constant for fs.open(). Flag indicating that opening a file should fail if the O_CREAT flag is set and the file already exists. */
+/** Flag indicating that opening a file should fail if the O_CREAT flag is set and the file already exists. */
 export declare const O_EXCL = 128;
 /**
- * Constant for fs.open(). Flag indicating that if path identifies a terminal device,
+ * Flag indicating that if path identifies a terminal device,
  * opening the path shall not cause that terminal to become the controlling terminal for the process
  * (if the process does not already have one).
  */
 export declare const O_NOCTTY = 256;
-/** Constant for fs.open(). Flag indicating that if the file exists and is a regular file, and the file is opened successfully for write access, its length shall be truncated to zero. */
+/** Flag indicating that if the file exists and is a regular file, and the file is opened successfully for write access, its length shall be truncated to zero. */
 export declare const O_TRUNC = 512;
-/** Constant for fs.open(). Flag indicating that data will be appended to the end of the file. */
+/** Flag indicating that data will be appended to the end of the file. */
 export declare const O_APPEND = 1024;
-/** Constant for fs.open(). Flag indicating that the open should fail if the path is not a directory. */
+/** Flag indicating that the open should fail if the path is not a directory. */
 export declare const O_DIRECTORY = 65536;
 /**
  * constant for fs.open().
@@ -47,55 +47,61 @@ export declare const O_DIRECTORY = 65536;
  * This flag is available on Linux operating systems only.
  */
 export declare const O_NOATIME = 262144;
-/** Constant for fs.open(). Flag indicating that the open should fail if the path is a symbolic link. */
+/** Flag indicating that the open should fail if the path is a symbolic link. */
 export declare const O_NOFOLLOW = 131072;
-/** Constant for fs.open(). Flag indicating that the file is opened for synchronous I/O. */
+/** Flag indicating that the file is opened for synchronous I/O. */
 export declare const O_SYNC = 1052672;
-/** Constant for fs.open(). Flag indicating that the file is opened for synchronous I/O with write operations waiting for data integrity. */
+/** Flag indicating that the file is opened for synchronous I/O with write operations waiting for data integrity. */
 export declare const O_DSYNC = 4096;
-/** Constant for fs.open(). Flag indicating to open the symbolic link itself rather than the resource it is pointing to. */
+/** Flag indicating to open the symbolic link itself rather than the resource it is pointing to. */
 export declare const O_SYMLINK = 32768;
-/** Constant for fs.open(). When set, an attempt will be made to minimize caching effects of file I/O. */
+/** When set, an attempt will be made to minimize caching effects of file I/O. */
 export declare const O_DIRECT = 16384;
-/** Constant for fs.open(). Flag indicating to open the file in nonblocking mode when possible. */
+/** Flag indicating to open the file in nonblocking mode when possible. */
 export declare const O_NONBLOCK = 2048;
-/** Constant for fs.Stats mode property for determining a file's type. Bit mask used to extract the file type code. */
+/** Bit mask used to extract the file type from mode. */
 export declare const S_IFMT = 61440;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a regular file. */
+/** File type constant for a socket. */
+export declare const S_IFSOCK = 49152;
+/** File type constant for a symbolic link. */
+export declare const S_IFLNK = 40960;
+/** File type constant for a regular file. */
 export declare const S_IFREG = 32768;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a directory. */
+/** File type constant for a block-oriented device file. */
+export declare const S_IFBLK = 24576;
+/** File type constant for a directory. */
 export declare const S_IFDIR = 16384;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a character-oriented device file. */
+/** File type constant for a character-oriented device file. */
 export declare const S_IFCHR = 8192;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a block-oriented device file. */
-export declare const S_IFBLK = 24576;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a FIFO/pipe. */
+/** File type constant for a FIFO/pipe. */
 export declare const S_IFIFO = 4096;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a symbolic link. */
-export declare const S_IFLNK = 40960;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a socket. */
-export declare const S_IFSOCK = 49152;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable, writable and executable by owner. */
+/** Set user id */
+export declare const S_ISUID = 2048;
+/** Set group id */
+export declare const S_ISGID = 1024;
+/** Sticky bit */
+export declare const S_ISVTX = 512;
+/** File mode indicating readable, writable and executable by owner. */
 export declare const S_IRWXU = 448;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable by owner. */
+/** File mode indicating readable by owner. */
 export declare const S_IRUSR = 256;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating writable by owner. */
+/** File mode indicating writable by owner. */
 export declare const S_IWUSR = 128;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating executable by owner. */
+/** File mode indicating executable by owner. */
 export declare const S_IXUSR = 64;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable, writable and executable by group. */
+/** File mode indicating readable, writable and executable by group. */
 export declare const S_IRWXG = 56;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable by group. */
+/** File mode indicating readable by group. */
 export declare const S_IRGRP = 32;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating writable by group. */
+/** File mode indicating writable by group. */
 export declare const S_IWGRP = 16;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating executable by group. */
+/** File mode indicating executable by group. */
 export declare const S_IXGRP = 8;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable, writable and executable by others. */
+/** File mode indicating readable, writable and executable by others. */
 export declare const S_IRWXO = 7;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable by others. */
+/** File mode indicating readable by others. */
 export declare const S_IROTH = 4;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating writable by others. */
+/** File mode indicating writable by others. */
 export declare const S_IWOTH = 2;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating executable by others. */
+/** File mode indicating executable by others. */
 export declare const S_IXOTH = 1;

package/dist/emulation/constants.js

@@ -1,15 +1,18 @@
 /*
 FS Constants
 See https://nodejs.org/api/fs.html#file-access-constants
+
+Note: Many of these are pulled from
+https://github.com/torvalds/linux/blob/master/include/uapi/linux/stat.h
 */
 // File Access Constants
-/** Constant for fs.access(). File is visible to the calling process. */
+/** File is visible to the calling process. */
 export const F_OK = 0;
-/** Constant for fs.access(). File can be read by the calling process. */
+/** File can be read by the calling process. */
 export const R_OK = 4;
-/** Constant for fs.access(). File can be written by the calling process. */
+/** File can be written by the calling process. */
 export const W_OK = 2;
-/** Constant for fs.access(). File can be executed by the calling process. */
+/** File can be executed by the calling process. */
 export const X_OK = 1;
 // File Copy Constants
 /** Constant for fs.copyFile. Flag indicating the destination file should not be overwritten if it already exists. */
@@ -25,86 +28,92 @@ export const COPYFILE_FICLONE = 2;
  */
 export const COPYFILE_FICLONE_FORCE = 4;
 // File Open Constants
-/** Constant for fs.open(). Flag indicating to open a file for read-only access. */
+/** Flag indicating to open a file for read-only access. */
 export const O_RDONLY = 0;
-/** Constant for fs.open(). Flag indicating to open a file for write-only access. */
+/** Flag indicating to open a file for write-only access. */
 export const O_WRONLY = 1;
-/** Constant for fs.open(). Flag indicating to open a file for read-write access. */
+/** Flag indicating to open a file for read-write access. */
 export const O_RDWR = 2;
-/** Constant for fs.open(). Flag indicating to create the file if it does not already exist. */
-export const O_CREAT = 0o100; // Node internal is
-/** Constant for fs.open(). Flag indicating that opening a file should fail if the O_CREAT flag is set and the file already exists. */
-export const O_EXCL = 0o200;
+/** Flag indicating to create the file if it does not already exist. */
+export const O_CREAT = 0x40; // bit 6
+/** Flag indicating that opening a file should fail if the O_CREAT flag is set and the file already exists. */
+export const O_EXCL = 0x80; // bit 7
 /**
- * Constant for fs.open(). Flag indicating that if path identifies a terminal device,
+ * Flag indicating that if path identifies a terminal device,
  * opening the path shall not cause that terminal to become the controlling terminal for the process
  * (if the process does not already have one).
  */
-export const O_NOCTTY = 0o400;
-/** Constant for fs.open(). Flag indicating that if the file exists and is a regular file, and the file is opened successfully for write access, its length shall be truncated to zero. */
-export const O_TRUNC = 0o1000;
-/** Constant for fs.open(). Flag indicating that data will be appended to the end of the file. */
-export const O_APPEND = 0o2000;
-/** Constant for fs.open(). Flag indicating that the open should fail if the path is not a directory. */
-export const O_DIRECTORY = 0o200000;
+export const O_NOCTTY = 0x100; // bit 8
+/** Flag indicating that if the file exists and is a regular file, and the file is opened successfully for write access, its length shall be truncated to zero. */
+export const O_TRUNC = 0x200; // bit 9
+/** Flag indicating that data will be appended to the end of the file. */
+export const O_APPEND = 0x400; // bit 10
+/** Flag indicating that the open should fail if the path is not a directory. */
+export const O_DIRECTORY = 0x10000; // bit 16
 /**
  * constant for fs.open().
  * Flag indicating reading accesses to the file system will no longer result in
  * an update to the atime information associated with the file.
  * This flag is available on Linux operating systems only.
  */
-export const O_NOATIME = 0o1000000;
-/** Constant for fs.open(). Flag indicating that the open should fail if the path is a symbolic link. */
-export const O_NOFOLLOW = 0o400000;
-/** Constant for fs.open(). Flag indicating that the file is opened for synchronous I/O. */
-export const O_SYNC = 0o4010000;
-/** Constant for fs.open(). Flag indicating that the file is opened for synchronous I/O with write operations waiting for data integrity. */
-export const O_DSYNC = 0o10000;
-/** Constant for fs.open(). Flag indicating to open the symbolic link itself rather than the resource it is pointing to. */
-export const O_SYMLINK = 0o100000;
-/** Constant for fs.open(). When set, an attempt will be made to minimize caching effects of file I/O. */
-export const O_DIRECT = 0o40000;
-/** Constant for fs.open(). Flag indicating to open the file in nonblocking mode when possible. */
-export const O_NONBLOCK = 0o4000;
+export const O_NOATIME = 0x40000; // bit 18
+/** Flag indicating that the open should fail if the path is a symbolic link. */
+export const O_NOFOLLOW = 0x20000; // bit 17
+/** Flag indicating that the file is opened for synchronous I/O. */
+export const O_SYNC = 0x101000; // bit 20 and bit 12
+/** Flag indicating that the file is opened for synchronous I/O with write operations waiting for data integrity. */
+export const O_DSYNC = 0x1000; // bit 12
+/** Flag indicating to open the symbolic link itself rather than the resource it is pointing to. */
+export const O_SYMLINK = 0x8000; // bit 15
+/** When set, an attempt will be made to minimize caching effects of file I/O. */
+export const O_DIRECT = 0x4000; // bit 14
+/** Flag indicating to open the file in nonblocking mode when possible. */
+export const O_NONBLOCK = 0x800; // bit 11
 // File Type Constants
-/** Constant for fs.Stats mode property for determining a file's type. Bit mask used to extract the file type code. */
+/** Bit mask used to extract the file type from mode. */
 export const S_IFMT = 0xf000;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a regular file. */
-export const S_IFREG = 0o100000;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a directory. */
-export const S_IFDIR = 0o40000;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a character-oriented device file. */
-export const S_IFCHR = 0o20000;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a block-oriented device file. */
-export const S_IFBLK = 0o60000;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a FIFO/pipe. */
-export const S_IFIFO = 0o10000;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a symbolic link. */
-export const S_IFLNK = 0o120000;
-/** Constant for fs.Stats mode property for determining a file's type. File type constant for a socket. */
-export const S_IFSOCK = 0o140000;
+/** File type constant for a socket. */
+export const S_IFSOCK = 0xc000;
+/** File type constant for a symbolic link. */
+export const S_IFLNK = 0xa000;
+/** File type constant for a regular file. */
+export const S_IFREG = 0x8000;
+/** File type constant for a block-oriented device file. */
+export const S_IFBLK = 0x6000;
+/** File type constant for a directory. */
+export const S_IFDIR = 0x4000;
+/** File type constant for a character-oriented device file. */
+export const S_IFCHR = 0x2000;
+/** File type constant for a FIFO/pipe. */
+export const S_IFIFO = 0x1000;
+/** Set user id */
+export const S_ISUID = 0o4000;
+/** Set group id */
+export const S_ISGID = 0o2000;
+/** Sticky bit */
+export const S_ISVTX = 0o1000;
 // File Mode Constants
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable, writable and executable by owner. */
+/** File mode indicating readable, writable and executable by owner. */
 export const S_IRWXU = 0o700;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable by owner. */
+/** File mode indicating readable by owner. */
 export const S_IRUSR = 0o400;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating writable by owner. */
+/** File mode indicating writable by owner. */
 export const S_IWUSR = 0o200;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating executable by owner. */
+/** File mode indicating executable by owner. */
 export const S_IXUSR = 0o100;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable, writable and executable by group. */
+/** File mode indicating readable, writable and executable by group. */
 export const S_IRWXG = 0o70;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable by group. */
+/** File mode indicating readable by group. */
 export const S_IRGRP = 0o40;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating writable by group. */
+/** File mode indicating writable by group. */
 export const S_IWGRP = 0o20;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating executable by group. */
+/** File mode indicating executable by group. */
 export const S_IXGRP = 0o10;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable, writable and executable by others. */
+/** File mode indicating readable, writable and executable by others. */
 export const S_IRWXO = 7;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating readable by others. */
+/** File mode indicating readable by others. */
 export const S_IROTH = 4;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating writable by others. */
+/** File mode indicating writable by others. */
 export const S_IWOTH = 2;
-/** Constant for fs.Stats mode property for determining access permissions for a file. File mode indicating executable by others. */
+/** File mode indicating executable by others. */
 export const S_IXOTH = 1;

package/dist/emulation/dir.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" resolution-mode="require"/>
 import type { Dirent as _Dirent, Dir as _Dir } from 'fs';
-import { NoArgCallback, TwoArgCallback } from '../filesystem.js';
-import { Stats } from '../stats.js';
+import type { NoArgCallback, TwoArgCallback } from '../filesystem.js';
+import type { Stats } from '../stats.js';
 export declare class Dirent implements _Dirent {
     name: string;
     protected stats: Stats;

package/dist/emulation/promises.d.ts

@@ -5,7 +5,7 @@ import type * as Node from 'node:fs';
 export * as constants from './constants.js';
 import type { PathLike, BufferToUint8Array } from './shared.js';
 import { FileContents } from '../filesystem.js';
-import { BigIntStats, Stats } from '../stats.js';
+import { BigIntStats, type Stats } from '../stats.js';
 import { Dirent } from './dir.js';
 export declare class FileHandle implements BufferToUint8Array<Node.promises.FileHandle> {
     /**

package/dist/emulation/promises.js

@@ -211,12 +211,12 @@ export async function exists(_path) {
 }
 export async function stat(path, options) {
     const stats = await doOp('stat', true, path, cred);
-    return options?.bigint ? BigIntStats.clone(stats) : stats;
+    return options?.bigint ? new BigIntStats(stats) : stats;
 }
 stat;
 export async function lstat(path, options) {
     const stats = await doOp('stat', false, path, cred);
-    return options?.bigint ? BigIntStats.clone(stats) : stats;
+    return options?.bigint ? new BigIntStats(stats) : stats;
 }
 lstat;
 // FILE-ONLY METHODS
@@ -248,7 +248,7 @@ unlink;
  * @internal
  */
 async function _open(_path, _flag, _mode = 0o644, resolveSymlinks) {
-    const path = normalizePath(_path), mode = normalizeMode(_mode, 0o644), flag = FileFlag.FromString(_flag);
+    const path = normalizePath(_path), mode = normalizeMode(_mode, 0o644), flag = FileFlag.Get(_flag);
     try {
         switch (flag.pathExistsAction()) {
             case ActionType.THROW:
@@ -327,7 +327,7 @@ async function _readFile(fname, flag, resolveSymlinks) {
 }
 export async function readFile(filename, _options) {
     const options = normalizeOptions(_options, null, 'r', null);
-    const flag = FileFlag.FromString(options.flag);
+    const flag = FileFlag.Get(options.flag);
     if (!flag.isReadable()) {
         throw new ApiError(ErrorCode.EINVAL, 'Flag passed must allow for reading.');
     }
@@ -363,7 +363,7 @@ async function _writeFile(fname, data, flag, mode, resolveSymlinks) {
  */
 export async function writeFile(filename, data, _options) {
     const options = normalizeOptions(_options, 'utf8', 'w', 0o644);
-    const flag = FileFlag.FromString(options.flag);
+    const flag = FileFlag.Get(options.flag);
     if (!flag.isWriteable()) {
         throw new ApiError(ErrorCode.EINVAL, 'Flag passed must allow for writing.');
     }
@@ -399,7 +399,7 @@ async function _appendFile(fname, data, flag, mode, resolveSymlinks) {
  */
 export async function appendFile(filename, data, _options) {
     const options = normalizeOptions(_options, 'utf8', 'a', 0o644);
-    const flag = FileFlag.FromString(options.flag);
+    const flag = FileFlag.Get(options.flag);
     if (!flag.isAppendable()) {
         throw new ApiError(ErrorCode.EINVAL, 'Flag passed to appendFile must allow for appending.');
     }

package/dist/emulation/sync.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" resolution-mode="require"/>
 /// <reference types="node" resolution-mode="require"/>
 import { FileContents } from '../filesystem.js';
-import { BigIntStats, Stats } from '../stats.js';
+import { BigIntStats, type Stats } from '../stats.js';
 import type { symlink, ReadSyncOptions, BaseEncodingOptions, BufferEncodingOption } from 'fs';
 import type * as Node from 'fs';
 import { PathLike } from './shared.js';

package/dist/emulation/sync.js

@@ -60,12 +60,12 @@ export function existsSync(path) {
 existsSync;
 export function statSync(path, options) {
     const stats = doOp('statSync', true, path, cred);
-    return options?.bigint ? BigIntStats.clone(stats) : stats;
+    return options?.bigint ? new BigIntStats(stats) : stats;
 }
 statSync;
 export function lstatSync(path, options) {
     const stats = doOp('statSync', false, path, cred);
-    return options?.bigint ? BigIntStats.clone(stats) : stats;
+    return options?.bigint ? new BigIntStats(stats) : stats;
 }
 lstatSync;
 /**
@@ -92,7 +92,7 @@ export function unlinkSync(path) {
 }
 unlinkSync;
 function _openSync(_path, _flag, _mode, resolveSymlinks) {
-    const path = normalizePath(_path), mode = normalizeMode(_mode, 0o644), flag = FileFlag.FromString(_flag);
+    const path = normalizePath(_path), mode = normalizeMode(_mode, 0o644), flag = FileFlag.Get(_flag);
     // Check if the path exists, and is a file.
     let stats;
     try {
@@ -176,7 +176,7 @@ function _readFileSync(fname, flag, resolveSymlinks) {
 }
 export function readFileSync(filename, arg2 = {}) {
     const options = normalizeOptions(arg2, null, 'r', 0o644);
-    const flag = FileFlag.FromString(options.flag);
+    const flag = FileFlag.Get(options.flag);
     if (!flag.isReadable()) {
         throw new ApiError(ErrorCode.EINVAL, 'Flag passed to readFile must allow for reading.');
     }
@@ -201,7 +201,7 @@ function _writeFileSync(fname, data, flag, mode, resolveSymlinks) {
 }
 export function writeFileSync(filename, data, _options) {
     const options = normalizeOptions(_options, 'utf8', 'w', 0o644);
-    const flag = FileFlag.FromString(options.flag);
+    const flag = FileFlag.Get(options.flag);
     if (!flag.isWriteable()) {
         throw new ApiError(ErrorCode.EINVAL, 'Flag passed to writeFile must allow for writing.');
     }
@@ -230,7 +230,7 @@ function _appendFileSync(fname, data, flag, mode, resolveSymlinks) {
 }
 export function appendFileSync(filename, data, arg3) {
     const options = normalizeOptions(arg3, 'utf8', 'a', 0o644);
-    const flag = FileFlag.FromString(options.flag);
+    const flag = FileFlag.Get(options.flag);
     if (!flag.isAppendable()) {
         throw new ApiError(ErrorCode.EINVAL, 'Flag passed to appendFile must allow for appending.');
     }
@@ -243,7 +243,7 @@ export function appendFileSync(filename, data, arg3) {
 appendFileSync;
 export function fstatSync(fd, options) {
     const stats = fd2file(fd).statSync();
-    return options?.bigint ? BigIntStats.clone(stats) : stats;
+    return options?.bigint ? new BigIntStats(stats) : stats;
 }
 fstatSync;
 /**

package/dist/file.d.ts

@@ -17,6 +17,9 @@ declare global {
         }): ArrayBuffer;
     }
 }
+/**
+ * @hidden
+ */
 export declare enum ActionType {
     NOP = 0,
     THROW = 1,
@@ -42,28 +45,39 @@ export declare enum ActionType {
  * Exclusive mode ensures that the file path is newly created.
  */
 export declare class FileFlag {
-    private static flagCache;
-    private static validFlagStrs;
+    /**
+     * Contains cached FileMode instances.
+     */
+    protected static cache: Map<string | number, FileFlag>;
+    /**
+     * Array of valid mode strings.
+     */
+    protected static validStrings: string[];
     /**
      * Get an object representing the given file flag.
      * @param flag The string or number representing the flag
      * @return The FileFlag object representing the flag
      * @throw when the flag string is invalid
      */
-    static FromString(flag: string | number): FileFlag;
-    private flagStr;
+    static Get(flag: string | number): FileFlag;
+    protected _flag: string;
     /**
-     * This should never be called directly.
      * @param flag The string or number representing the flag
      * @throw when the flag is invalid
      */
-    constructor(flag: string | number);
+    protected constructor(flag: string | number);
     /**
      * @param flag The number representing the flag
-     * @return The string representing the flag
-     * @throw when the flag number is invalid
+     * @returns The string representing the flag
+     * @throws when the flag number is invalid
+     */
+    static StringOf(flag: number): string;
+    /**
+     * @param flag The string representing the flag
+     * @returns The number representing the flag
+     * @throws when the flag string is invalid
      */
-    static NumberToString(flag: number): string;
+    static NumberOf(flag: string): number;
     /**
      * Get the underlying flag string for this flag.
      */
@@ -258,11 +272,11 @@ export declare abstract class File {
  * extend this class and implement those two methods.
  * @todo 'close' lever that disables functionality once closed.
  */
-export declare abstract class PreloadFile<T extends FileSystem> extends File {
+export declare abstract class PreloadFile<FS extends FileSystem> extends File {
     /**
      * The file system that created the file.
      */
-    protected fs: T;
+    protected fs: FS;
     /**
      * Path to the file
      */
@@ -288,7 +302,7 @@ export declare abstract class PreloadFile<T extends FileSystem> extends File {
     /**
      * The file system that created the file.
      */
-    fs: T, 
+    fs: FS, 
     /**
      * Path to the file
      */