@zenfs/core 1.11.4 → 2.1.0

package/dist/internal/error.d.ts

@@ -1,213 +1,18 @@
+import { Exception, type ExceptionJSON } from 'kerium';
 /**
- * Standard libc error codes. More will be added to this enum and error strings as they are
- * needed.
+ * @deprecated Use {@link ExceptionJSON} instead
  * @category Internals
- * @see https://en.wikipedia.org/wiki/Errno.h
  */
-export declare enum Errno {
-    /** Operation not permitted */
-    EPERM = 1,
-    /** No such file or directory */
-    ENOENT = 2,
-    /** Interrupted system call */
-    EINTR = 4,
-    /** Input/output error */
-    EIO = 5,
-    /** No such device or address */
-    ENXIO = 6,
-    /** Bad file descriptor */
-    EBADF = 9,
-    /** Resource temporarily unavailable */
-    EAGAIN = 11,
-    /** Cannot allocate memory */
-    ENOMEM = 12,
-    /** Permission denied */
-    EACCES = 13,
-    /** Bad address */
-    EFAULT = 14,
-    /** Block device required */
-    ENOTBLK = 15,
-    /** Resource busy or locked */
-    EBUSY = 16,
-    /** File exists */
-    EEXIST = 17,
-    /** Invalid cross-device link */
-    EXDEV = 18,
-    /** No such device */
-    ENODEV = 19,
-    /** File is not a directory */
-    ENOTDIR = 20,
-    /** File is a directory */
-    EISDIR = 21,
-    /** Invalid argument */
-    EINVAL = 22,
-    /** Too many open files in system */
-    ENFILE = 23,
-    /** Too many open files */
-    EMFILE = 24,
-    /** Text file busy */
-    ETXTBSY = 26,
-    /** File is too big */
-    EFBIG = 27,
-    /** No space left on disk */
-    ENOSPC = 28,
-    /** Illegal seek */
-    ESPIPE = 29,
-    /** Cannot modify a read-only file system */
-    EROFS = 30,
-    /** Too many links */
-    EMLINK = 31,
-    /** Broken pipe */
-    EPIPE = 32,
-    /** Numerical argument out of domain */
-    EDOM = 33,
-    /** Numerical result out of range */
-    ERANGE = 34,
-    /** Resource deadlock would occur */
-    EDEADLK = 35,
-    /** File name too long */
-    ENAMETOOLONG = 36,
-    /** No locks available */
-    ENOLCK = 37,
-    /** Function not implemented */
-    ENOSYS = 38,
-    /** Directory is not empty */
-    ENOTEMPTY = 39,
-    /** Too many levels of symbolic links */
-    ELOOP = 40,
-    /** No message of desired type */
-    ENOMSG = 42,
-    /** Invalid exchange */
-    EBADE = 52,
-    /** Invalid request descriptor */
-    EBADR = 53,
-    /** Exchange full */
-    EXFULL = 54,
-    /** No anode */
-    ENOANO = 55,
-    /** Invalid request code */
-    EBADRQC = 56,
-    /** Device not a stream */
-    ENOSTR = 60,
-    /** No data available */
-    ENODATA = 61,
-    /** Timer expired */
-    ETIME = 62,
-    /** Out of streams resources */
-    ENOSR = 63,
-    /** Machine is not on the network */
-    ENONET = 64,
-    /** Object is remote */
-    EREMOTE = 66,
-    /** Link has been severed */
-    ENOLINK = 67,
-    /** Communication error on send */
-    ECOMM = 70,
-    /** Protocol error */
-    EPROTO = 71,
-    /** Bad message */
-    EBADMSG = 74,
-    /** Value too large for defined data type */
-    EOVERFLOW = 75,
-    /** File descriptor in bad state */
-    EBADFD = 77,
-    /** Streams pipe error */
-    ESTRPIPE = 86,
-    /** Socket operation on non-socket */
-    ENOTSOCK = 88,
-    /** Destination address required */
-    EDESTADDRREQ = 89,
-    /** Message too long */
-    EMSGSIZE = 90,
-    /** Protocol wrong type for socket */
-    EPROTOTYPE = 91,
-    /** Protocol not available */
-    ENOPROTOOPT = 92,
-    /** Protocol not supported */
-    EPROTONOSUPPORT = 93,
-    /** Socket type not supported */
-    ESOCKTNOSUPPORT = 94,
-    /** Operation is not supported */
-    ENOTSUP = 95,
-    /** Network is down */
-    ENETDOWN = 100,
-    /** Network is unreachable */
-    ENETUNREACH = 101,
-    /** Network dropped connection on reset */
-    ENETRESET = 102,
-    /** Connection timed out */
-    ETIMEDOUT = 110,
-    /** Connection refused */
-    ECONNREFUSED = 111,
-    /** Host is down */
-    EHOSTDOWN = 112,
-    /** No route to host */
-    EHOSTUNREACH = 113,
-    /** Operation already in progress */
-    EALREADY = 114,
-    /** Operation now in progress */
-    EINPROGRESS = 115,
-    /** Stale file handle */
-    ESTALE = 116,
-    /** Remote I/O error */
-    EREMOTEIO = 121,
-    /** Disk quota exceeded */
-    EDQUOT = 122
-}
+export type ErrnoErrorJSON = ExceptionJSON;
 /**
- * Strings associated with each error code.
+ * @deprecated Use {@link Exception} instead
  * @category Internals
- * @internal
  */
-export declare const errorMessages: {
-    [K in Errno]: string;
-};
+export declare const ErrnoError: typeof Exception;
 /**
+ * @deprecated Use {@link Exception} instead
  * @category Internals
  */
-export interface ErrnoErrorJSON {
-    errno: Errno;
-    message: string;
-    path?: string;
-    code: keyof typeof Errno;
-    stack: string;
-    syscall: string;
-}
-/**
- * An error with additional information about what happened
- * @category Internals
- */
-export declare class ErrnoError extends Error implements NodeJS.ErrnoException {
-    /**
-     * The kind of error
-     */
-    errno: Errno;
-    /**
-     * A descriptive error message
-     */
-    message: string;
-    path?: string | undefined;
-    syscall: string;
-    static fromJSON(json: ErrnoErrorJSON): ErrnoError;
-    static With(code: keyof typeof Errno, path?: string, syscall?: string): ErrnoError;
-    code: keyof typeof Errno;
-    stack: string;
-    constructor(
-    /**
-     * The kind of error
-     */
-    errno: Errno, 
-    /**
-     * A descriptive error message
-     */
-    message?: string, path?: string | undefined, syscall?: string);
-    /**
-     * @returns A friendly error message.
-     */
-    toString(): string;
-    toJSON(): ErrnoErrorJSON;
-    /**
-     * The size of the API error in buffer-form in bytes.
-     */
-    bufferSize(): number;
-}
+export type ErrnoError = Exception;
+export declare function withPath<E extends Exception>(e: E, path: string): E;
+export declare function wrap<const FS, const Prop extends keyof FS & string>(fs: FS, prop: Prop, path: string, dest?: string): FS[Prop];

package/dist/internal/error.js

@@ -1,292 +1,23 @@
+import { Exception, setUVMessage } from 'kerium';
 /**
- * Standard libc error codes. More will be added to this enum and error strings as they are
- * needed.
+ * @deprecated Use {@link Exception} instead
  * @category Internals
- * @see https://en.wikipedia.org/wiki/Errno.h
  */
-export var Errno;
-(function (Errno) {
-    /** Operation not permitted */
-    Errno[Errno["EPERM"] = 1] = "EPERM";
-    /** No such file or directory */
-    Errno[Errno["ENOENT"] = 2] = "ENOENT";
-    /** Interrupted system call */
-    Errno[Errno["EINTR"] = 4] = "EINTR";
-    /** Input/output error */
-    Errno[Errno["EIO"] = 5] = "EIO";
-    /** No such device or address */
-    Errno[Errno["ENXIO"] = 6] = "ENXIO";
-    /** Bad file descriptor */
-    Errno[Errno["EBADF"] = 9] = "EBADF";
-    /** Resource temporarily unavailable */
-    Errno[Errno["EAGAIN"] = 11] = "EAGAIN";
-    /** Cannot allocate memory */
-    Errno[Errno["ENOMEM"] = 12] = "ENOMEM";
-    /** Permission denied */
-    Errno[Errno["EACCES"] = 13] = "EACCES";
-    /** Bad address */
-    Errno[Errno["EFAULT"] = 14] = "EFAULT";
-    /** Block device required */
-    Errno[Errno["ENOTBLK"] = 15] = "ENOTBLK";
-    /** Resource busy or locked */
-    Errno[Errno["EBUSY"] = 16] = "EBUSY";
-    /** File exists */
-    Errno[Errno["EEXIST"] = 17] = "EEXIST";
-    /** Invalid cross-device link */
-    Errno[Errno["EXDEV"] = 18] = "EXDEV";
-    /** No such device */
-    Errno[Errno["ENODEV"] = 19] = "ENODEV";
-    /** File is not a directory */
-    Errno[Errno["ENOTDIR"] = 20] = "ENOTDIR";
-    /** File is a directory */
-    Errno[Errno["EISDIR"] = 21] = "EISDIR";
-    /** Invalid argument */
-    Errno[Errno["EINVAL"] = 22] = "EINVAL";
-    /** Too many open files in system */
-    Errno[Errno["ENFILE"] = 23] = "ENFILE";
-    /** Too many open files */
-    Errno[Errno["EMFILE"] = 24] = "EMFILE";
-    /** Text file busy */
-    Errno[Errno["ETXTBSY"] = 26] = "ETXTBSY";
-    /** File is too big */
-    Errno[Errno["EFBIG"] = 27] = "EFBIG";
-    /** No space left on disk */
-    Errno[Errno["ENOSPC"] = 28] = "ENOSPC";
-    /** Illegal seek */
-    Errno[Errno["ESPIPE"] = 29] = "ESPIPE";
-    /** Cannot modify a read-only file system */
-    Errno[Errno["EROFS"] = 30] = "EROFS";
-    /** Too many links */
-    Errno[Errno["EMLINK"] = 31] = "EMLINK";
-    /** Broken pipe */
-    Errno[Errno["EPIPE"] = 32] = "EPIPE";
-    /** Numerical argument out of domain */
-    Errno[Errno["EDOM"] = 33] = "EDOM";
-    /** Numerical result out of range */
-    Errno[Errno["ERANGE"] = 34] = "ERANGE";
-    /** Resource deadlock would occur */
-    Errno[Errno["EDEADLK"] = 35] = "EDEADLK";
-    /** File name too long */
-    Errno[Errno["ENAMETOOLONG"] = 36] = "ENAMETOOLONG";
-    /** No locks available */
-    Errno[Errno["ENOLCK"] = 37] = "ENOLCK";
-    /** Function not implemented */
-    Errno[Errno["ENOSYS"] = 38] = "ENOSYS";
-    /** Directory is not empty */
-    Errno[Errno["ENOTEMPTY"] = 39] = "ENOTEMPTY";
-    /** Too many levels of symbolic links */
-    Errno[Errno["ELOOP"] = 40] = "ELOOP";
-    /** No message of desired type */
-    Errno[Errno["ENOMSG"] = 42] = "ENOMSG";
-    /** Invalid exchange */
-    Errno[Errno["EBADE"] = 52] = "EBADE";
-    /** Invalid request descriptor */
-    Errno[Errno["EBADR"] = 53] = "EBADR";
-    /** Exchange full */
-    Errno[Errno["EXFULL"] = 54] = "EXFULL";
-    /** No anode */
-    Errno[Errno["ENOANO"] = 55] = "ENOANO";
-    /** Invalid request code */
-    Errno[Errno["EBADRQC"] = 56] = "EBADRQC";
-    /** Device not a stream */
-    Errno[Errno["ENOSTR"] = 60] = "ENOSTR";
-    /** No data available */
-    Errno[Errno["ENODATA"] = 61] = "ENODATA";
-    /** Timer expired */
-    Errno[Errno["ETIME"] = 62] = "ETIME";
-    /** Out of streams resources */
-    Errno[Errno["ENOSR"] = 63] = "ENOSR";
-    /** Machine is not on the network */
-    Errno[Errno["ENONET"] = 64] = "ENONET";
-    /** Object is remote */
-    Errno[Errno["EREMOTE"] = 66] = "EREMOTE";
-    /** Link has been severed */
-    Errno[Errno["ENOLINK"] = 67] = "ENOLINK";
-    /** Communication error on send */
-    Errno[Errno["ECOMM"] = 70] = "ECOMM";
-    /** Protocol error */
-    Errno[Errno["EPROTO"] = 71] = "EPROTO";
-    /** Bad message */
-    Errno[Errno["EBADMSG"] = 74] = "EBADMSG";
-    /** Value too large for defined data type */
-    Errno[Errno["EOVERFLOW"] = 75] = "EOVERFLOW";
-    /** File descriptor in bad state */
-    Errno[Errno["EBADFD"] = 77] = "EBADFD";
-    /** Streams pipe error */
-    Errno[Errno["ESTRPIPE"] = 86] = "ESTRPIPE";
-    /** Socket operation on non-socket */
-    Errno[Errno["ENOTSOCK"] = 88] = "ENOTSOCK";
-    /** Destination address required */
-    Errno[Errno["EDESTADDRREQ"] = 89] = "EDESTADDRREQ";
-    /** Message too long */
-    Errno[Errno["EMSGSIZE"] = 90] = "EMSGSIZE";
-    /** Protocol wrong type for socket */
-    Errno[Errno["EPROTOTYPE"] = 91] = "EPROTOTYPE";
-    /** Protocol not available */
-    Errno[Errno["ENOPROTOOPT"] = 92] = "ENOPROTOOPT";
-    /** Protocol not supported */
-    Errno[Errno["EPROTONOSUPPORT"] = 93] = "EPROTONOSUPPORT";
-    /** Socket type not supported */
-    Errno[Errno["ESOCKTNOSUPPORT"] = 94] = "ESOCKTNOSUPPORT";
-    /** Operation is not supported */
-    Errno[Errno["ENOTSUP"] = 95] = "ENOTSUP";
-    /** Network is down */
-    Errno[Errno["ENETDOWN"] = 100] = "ENETDOWN";
-    /** Network is unreachable */
-    Errno[Errno["ENETUNREACH"] = 101] = "ENETUNREACH";
-    /** Network dropped connection on reset */
-    Errno[Errno["ENETRESET"] = 102] = "ENETRESET";
-    /** Connection timed out */
-    Errno[Errno["ETIMEDOUT"] = 110] = "ETIMEDOUT";
-    /** Connection refused */
-    Errno[Errno["ECONNREFUSED"] = 111] = "ECONNREFUSED";
-    /** Host is down */
-    Errno[Errno["EHOSTDOWN"] = 112] = "EHOSTDOWN";
-    /** No route to host */
-    Errno[Errno["EHOSTUNREACH"] = 113] = "EHOSTUNREACH";
-    /** Operation already in progress */
-    Errno[Errno["EALREADY"] = 114] = "EALREADY";
-    /** Operation now in progress */
-    Errno[Errno["EINPROGRESS"] = 115] = "EINPROGRESS";
-    /** Stale file handle */
-    Errno[Errno["ESTALE"] = 116] = "ESTALE";
-    /** Remote I/O error */
-    Errno[Errno["EREMOTEIO"] = 121] = "EREMOTEIO";
-    /** Disk quota exceeded */
-    Errno[Errno["EDQUOT"] = 122] = "EDQUOT";
-})(Errno || (Errno = {}));
-/**
- * Strings associated with each error code.
- * @category Internals
- * @internal
- */
-export const errorMessages = {
-    [Errno.EPERM]: 'Operation not permitted',
-    [Errno.ENOENT]: 'No such file or directory',
-    [Errno.EINTR]: 'Interrupted system call',
-    [Errno.EIO]: 'Input/output error',
-    [Errno.ENXIO]: 'No such device or address',
-    [Errno.EBADF]: 'Bad file descriptor',
-    [Errno.EAGAIN]: 'Resource temporarily unavailable',
-    [Errno.ENOMEM]: 'Cannot allocate memory',
-    [Errno.EACCES]: 'Permission denied',
-    [Errno.EFAULT]: 'Bad address',
-    [Errno.ENOTBLK]: 'Block device required',
-    [Errno.EBUSY]: 'Resource busy or locked',
-    [Errno.EEXIST]: 'File exists',
-    [Errno.EXDEV]: 'Invalid cross-device link',
-    [Errno.ENODEV]: 'No such device',
-    [Errno.ENOTDIR]: 'File is not a directory',
-    [Errno.EISDIR]: 'File is a directory',
-    [Errno.EINVAL]: 'Invalid argument',
-    [Errno.ENFILE]: 'Too many open files in system',
-    [Errno.EMFILE]: 'Too many open files',
-    [Errno.ETXTBSY]: 'Text file busy',
-    [Errno.EFBIG]: 'File is too big',
-    [Errno.ENOSPC]: 'No space left on disk',
-    [Errno.ESPIPE]: 'Illegal seek',
-    [Errno.EROFS]: 'Cannot modify a read-only file system',
-    [Errno.EMLINK]: 'Too many links',
-    [Errno.EPIPE]: 'Broken pipe',
-    [Errno.EDOM]: 'Numerical argument out of domain',
-    [Errno.ERANGE]: 'Numerical result out of range',
-    [Errno.EDEADLK]: 'Resource deadlock would occur',
-    [Errno.ENAMETOOLONG]: 'File name too long',
-    [Errno.ENOLCK]: 'No locks available',
-    [Errno.ENOSYS]: 'Function not implemented',
-    [Errno.ENOTEMPTY]: 'Directory is not empty',
-    [Errno.ELOOP]: 'Too many levels of symbolic links',
-    [Errno.ENOMSG]: 'No message of desired type',
-    [Errno.EBADE]: 'Invalid exchange',
-    [Errno.EBADR]: 'Invalid request descriptor',
-    [Errno.EXFULL]: 'Exchange full',
-    [Errno.ENOANO]: 'No anode',
-    [Errno.EBADRQC]: 'Invalid request code',
-    [Errno.ENOSTR]: 'Device not a stream',
-    [Errno.ENODATA]: 'No data available',
-    [Errno.ETIME]: 'Timer expired',
-    [Errno.ENOSR]: 'Out of streams resources',
-    [Errno.ENONET]: 'Machine is not on the network',
-    [Errno.EREMOTE]: 'Object is remote',
-    [Errno.ENOLINK]: 'Link has been severed',
-    [Errno.ECOMM]: 'Communication error on send',
-    [Errno.EPROTO]: 'Protocol error',
-    [Errno.EBADMSG]: 'Bad message',
-    [Errno.EOVERFLOW]: 'Value too large for defined data type',
-    [Errno.EBADFD]: 'File descriptor in bad state',
-    [Errno.ESTRPIPE]: 'Streams pipe error',
-    [Errno.ENOTSOCK]: 'Socket operation on non-socket',
-    [Errno.EDESTADDRREQ]: 'Destination address required',
-    [Errno.EMSGSIZE]: 'Message too long',
-    [Errno.EPROTOTYPE]: 'Protocol wrong type for socket',
-    [Errno.ENOPROTOOPT]: 'Protocol not available',
-    [Errno.EPROTONOSUPPORT]: 'Protocol not supported',
-    [Errno.ESOCKTNOSUPPORT]: 'Socket type not supported',
-    [Errno.ENOTSUP]: 'Operation is not supported',
-    [Errno.ENETDOWN]: 'Network is down',
-    [Errno.ENETUNREACH]: 'Network is unreachable',
-    [Errno.ENETRESET]: 'Network dropped connection on reset',
-    [Errno.ETIMEDOUT]: 'Connection timed out',
-    [Errno.ECONNREFUSED]: 'Connection refused',
-    [Errno.EHOSTDOWN]: 'Host is down',
-    [Errno.EHOSTUNREACH]: 'No route to host',
-    [Errno.EALREADY]: 'Operation already in progress',
-    [Errno.EINPROGRESS]: 'Operation now in progress',
-    [Errno.ESTALE]: 'Stale file handle',
-    [Errno.EREMOTEIO]: 'Remote I/O error',
-    [Errno.EDQUOT]: 'Disk quota exceeded',
-};
-/**
- * An error with additional information about what happened
- * @category Internals
- */
-export class ErrnoError extends Error {
-    static fromJSON(json) {
-        const err = new ErrnoError(json.errno, json.message, json.path, json.syscall);
-        err.code = json.code;
-        err.stack = json.stack;
-        return err;
-    }
-    static With(code, path, syscall) {
-        return new ErrnoError(Errno[code], errorMessages[Errno[code]], path, syscall);
-    }
-    constructor(
-    /**
-     * The kind of error
-     */
-    errno, 
-    /**
-     * A descriptive error message
-     */
-    message = errorMessages[errno], path, syscall = '') {
-        super(message);
-        this.errno = errno;
-        this.message = message;
-        this.path = path;
-        this.syscall = syscall;
-        this.code = Errno[errno];
-    }
-    /**
-     * @returns A friendly error message.
-     */
-    toString() {
-        return this.code + ': ' + this.message + (this.path ? `, '${this.path}'` : '');
-    }
-    toJSON() {
-        return {
-            errno: this.errno,
-            code: this.code,
-            path: this.path,
-            stack: this.stack,
-            message: this.message,
-            syscall: this.syscall,
-        };
-    }
-    /**
-     * The size of the API error in buffer-form in bytes.
-     */
-    bufferSize() {
-        // 4 bytes for string length.
-        return 4 + JSON.stringify(this.toJSON()).length;
-    }
+export const ErrnoError = Exception;
+export function withPath(e, path) {
+    e.path = path;
+    return e;
+}
+export function wrap(fs, prop, path, dest) {
+    const fn = fs[prop];
+    if (typeof fn !== 'function')
+        throw new TypeError(`${prop} is not a function`);
+    return function (...args) {
+        try {
+            return fn.call(fs, ...args);
+        }
+        catch (e) {
+            throw setUVMessage(Object.assign(e, { path, dest, syscall: prop.endsWith('Sync') ? prop.slice(0, -4) : prop }));
+        }
+    };
 }

package/dist/internal/file_index.d.ts

@@ -1,6 +1,6 @@
+import type { UsageInfo } from './filesystem.js';
 import type { InodeLike } from './inode.js';
 import { Inode } from './inode.js';
-import type { UsageInfo } from './filesystem.js';
 /**
  * An Index in JSON form
  * @internal

package/dist/internal/file_index.js

@@ -1,9 +1,10 @@
 /* Note: this file is named file_index.ts because Typescript has special behavior regarding index.ts which can't be disabled. */
-import { isJSON, randomInt, sizeof } from 'utilium';
+import { withErrno } from 'kerium';
+import { sizeof } from 'memium';
+import { isJSON, randomInt } from 'utilium';
+import { basename, dirname } from '../path.js';
 import { S_IFDIR, S_IFMT, size_max } from '../vfs/constants.js';
-import { basename, dirname } from '../vfs/path.js';
-import { Errno, ErrnoError } from './error.js';
-import { __inode_sz, Inode } from './inode.js';
+import { Inode } from './inode.js';
 export const version = 1;
 /**
  * An index of file metadata
@@ -35,7 +36,7 @@ export class Index extends Map {
      * Get the size in bytes of the index (including the size reported for each entry)
      */
     get byteSize() {
-        let size = this.size * __inode_sz;
+        let size = this.size * sizeof(Inode);
         for (const entry of this.values())
             size += entry.size;
         return size;
@@ -65,9 +66,9 @@ export class Index extends Map {
     directoryEntries(path) {
         const node = this.get(path);
         if (!node)
-            throw ErrnoError.With('ENOENT', path);
+            throw withErrno('ENOENT');
         if ((node.mode & S_IFMT) != S_IFDIR)
-            throw ErrnoError.With('ENOTDIR', path);
+            throw withErrno('ENOTDIR');
         const entries = {};
         for (const entry of this.keys()) {
             if (dirname(entry) == path && entry != path) {
@@ -106,9 +107,8 @@ export class Index extends Map {
      */
     fromJSON(json) {
         var _a;
-        if (json.version != version) {
-            throw new ErrnoError(Errno.EINVAL, 'Index version mismatch');
-        }
+        if (json.version != version)
+            throw withErrno('EINVAL', 'Index version mismatch');
         this.clear();
         for (const [path, node] of Object.entries(json.entries)) {
             (_a = node.data) !== null && _a !== void 0 ? _a : (node.data = randomInt(1, size_max));
@@ -123,7 +123,7 @@ export class Index extends Map {
      */
     static parse(data) {
         if (!isJSON(data))
-            throw new ErrnoError(Errno.EINVAL, 'Invalid JSON');
+            throw withErrno('EINVAL', 'Invalid JSON');
         const json = JSON.parse(data);
         const index = new Index();
         index.fromJSON(json);