@zenfs/core 2.4.1 → 2.4.3

package/dist/vfs/dir.d.ts

@@ -1,9 +1,3 @@
-import type { Dir as _Dir, Dirent as _Dirent } from 'node:fs';
-import type { V_Context } from '../context.js';
-import type { InodeLike } from '../internal/inode.js';
-import type { Callback } from '../utils.js';
-import { Buffer } from 'buffer';
-import { BufferView } from 'utilium/buffer.js';
 /**
  * @see `DT_*` in `dirent.h`
  */
@@ -28,80 +22,9 @@ export declare function ifToDt(mode: number): DirType;
  * @see `DTTOIF` in `dirent.h`
  */
 export declare function dtToIf(dt: DirType): number;
-declare const Dirent_base: import("memium").StructConstructor<BufferView<any>>;
-export declare class Dirent<Name extends string | Buffer = string, TArrayBuffer extends ArrayBufferLike = ArrayBufferLike> extends Dirent_base<TArrayBuffer> implements _Dirent<Name> {
-    protected accessor ino: number;
-    /** Reserved for 64-bit inodes */
-    private accessor _ino;
-    protected accessor type: DirType;
-    protected accessor _name: Uint8Array;
-    get name(): Name;
-    /**
-     * @internal @protected
-     */
-    _encoding?: BufferEncoding | 'buffer' | null;
-    /**
-     * @internal @protected
-     */
-    _parentPath: string;
-    get parentPath(): string;
-    /**
-     * @deprecated Removed in Node v24, use `parentPath` instead.
-     */
-    get path(): string;
-    /**
-     * @internal
-     */
-    static from(path: string, stats: InodeLike, encoding?: BufferEncoding | 'buffer' | null): Dirent;
-    isFile(): boolean;
-    isDirectory(): boolean;
-    isBlockDevice(): boolean;
-    isCharacterDevice(): boolean;
-    isSymbolicLink(): boolean;
-    isFIFO(): boolean;
-    isSocket(): boolean;
+export declare class Dirent {
+    ino: number;
+    type: DirType;
+    path: string;
+    name: string;
 }
-/**
- * A class representing a directory stream.
- */
-export declare class Dir implements _Dir, AsyncIterator<Dirent> {
-    readonly path: string;
-    protected readonly context: V_Context;
-    protected closed: boolean;
-    protected checkClosed(): void;
-    protected _entries?: Dirent[];
-    constructor(path: string, context: V_Context);
-    /**
-     * Asynchronously close the directory's underlying resource handle.
-     * Subsequent reads will result in errors.
-     */
-    close(): Promise<void>;
-    close(cb: Callback): void;
-    /**
-     * Synchronously close the directory's underlying resource handle.
-     * Subsequent reads will result in errors.
-     */
-    closeSync(): void;
-    protected _read(): Promise<Dirent | null>;
-    /**
-     * Asynchronously read the next directory entry via `readdir(3)` as an `Dirent`.
-     * After the read is completed, a value is returned that will be resolved with an `Dirent`, or `null` if there are no more directory entries to read.
-     * 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: 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.
-     * Directory entries returned by this function are in no particular order as provided by the operating system's underlying directory mechanisms.
-     */
-    readSync(): Dirent | null;
-    next(): Promise<IteratorResult<Dirent>>;
-    /**
-     * Asynchronously iterates over the directory via `readdir(3)` until all entries have been read.
-     */
-    [Symbol.asyncIterator](): this;
-    [Symbol.dispose](): void;
-    [Symbol.asyncDispose](): Promise<void>;
-}
-export {};

package/dist/vfs/dir.js

@@ -1,47 +1,4 @@
-var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
-    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
-    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
-    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
-    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
-    var _, done = false;
-    for (var i = decorators.length - 1; i >= 0; i--) {
-        var context = {};
-        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
-        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
-        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
-        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
-        if (kind === "accessor") {
-            if (result === void 0) continue;
-            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
-            if (_ = accept(result.get)) descriptor.get = _;
-            if (_ = accept(result.set)) descriptor.set = _;
-            if (_ = accept(result.init)) initializers.unshift(_);
-        }
-        else if (_ = accept(result)) {
-            if (kind === "field") initializers.unshift(_);
-            else descriptor[key] = _;
-        }
-    }
-    if (target) Object.defineProperty(target, contextIn.name, descriptor);
-    done = true;
-};
-var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
-    var useValue = arguments.length > 2;
-    for (var i = 0; i < initializers.length; i++) {
-        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
-    }
-    return useValue ? value : void 0;
-};
-import { Buffer } from 'buffer';
-import { withErrno } from 'kerium';
-import { warn } from 'kerium/log';
-import { sizeof } from 'memium';
-import { $from, struct, types as t } from 'memium/decorators';
-import { encodeUTF8 } from 'utilium';
-import { BufferView } from 'utilium/buffer.js';
-import { basename, dirname } from '../path.js';
-import { readdir } from './promises.js';
-import { readdirSync } from './sync.js';
+// SPDX-License-Identifier: LGPL-3.0-or-later
 /**
  * @see `DT_*` in `dirent.h`
  */
@@ -71,194 +28,9 @@ export function ifToDt(mode) {
 export function dtToIf(dt) {
     return dt << 12;
 }
-let Dirent = (() => {
-    var _a, _b, _c;
-    let _classDecorators = [struct.packed('Dirent')];
-    let _classDescriptor;
-    let _classExtraInitializers = [];
-    let _classThis;
-    let _classSuper = $from(BufferView);
-    let _ino_decorators;
-    let _ino_initializers = [];
-    let _ino_extraInitializers = [];
-    let __ino_decorators;
-    let __ino_initializers = [];
-    let __ino_extraInitializers = [];
-    let _type_decorators;
-    let _type_initializers = [];
-    let _type_extraInitializers = [];
-    let __name_decorators;
-    let __name_initializers = [];
-    let __name_extraInitializers = [];
-    var Dirent = class extends _classSuper {
-        static { _classThis = this; }
-        static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
-            _ino_decorators = [(_a = t).uint32.bind(_a)];
-            __ino_decorators = [(_b = t).uint32.bind(_b)];
-            _type_decorators = [(_c = t).uint8.bind(_c)];
-            __name_decorators = [t.char(256)];
-            __esDecorate(this, null, _ino_decorators, { kind: "accessor", name: "ino", static: false, private: false, access: { has: obj => "ino" in obj, get: obj => obj.ino, set: (obj, value) => { obj.ino = value; } }, metadata: _metadata }, _ino_initializers, _ino_extraInitializers);
-            __esDecorate(this, null, __ino_decorators, { kind: "accessor", name: "_ino", static: false, private: false, access: { has: obj => "_ino" in obj, get: obj => obj._ino, set: (obj, value) => { obj._ino = value; } }, metadata: _metadata }, __ino_initializers, __ino_extraInitializers);
-            __esDecorate(this, null, _type_decorators, { kind: "accessor", name: "type", static: false, private: false, access: { has: obj => "type" in obj, get: obj => obj.type, set: (obj, value) => { obj.type = value; } }, metadata: _metadata }, _type_initializers, _type_extraInitializers);
-            __esDecorate(this, null, __name_decorators, { kind: "accessor", name: "_name", static: false, private: false, access: { has: obj => "_name" in obj, get: obj => obj._name, set: (obj, value) => { obj._name = value; } }, metadata: _metadata }, __name_initializers, __name_extraInitializers);
-            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
-            Dirent = _classThis = _classDescriptor.value;
-            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-            __runInitializers(_classThis, _classExtraInitializers);
-        }
-        #ino_accessor_storage = __runInitializers(this, _ino_initializers, void 0);
-        get ino() { return this.#ino_accessor_storage; }
-        set ino(value) { this.#ino_accessor_storage = value; }
-        #_ino_accessor_storage = (__runInitializers(this, _ino_extraInitializers), __runInitializers(this, __ino_initializers, void 0));
-        /** Reserved for 64-bit inodes */
-        get _ino() { return this.#_ino_accessor_storage; }
-        set _ino(value) { this.#_ino_accessor_storage = value; }
-        #type_accessor_storage = (__runInitializers(this, __ino_extraInitializers), __runInitializers(this, _type_initializers, void 0));
-        get type() { return this.#type_accessor_storage; }
-        set type(value) { this.#type_accessor_storage = value; }
-        #_name_accessor_storage = (__runInitializers(this, _type_extraInitializers), __runInitializers(this, __name_initializers, void 0));
-        get _name() { return this.#_name_accessor_storage; }
-        set _name(value) { this.#_name_accessor_storage = value; }
-        get name() {
-            const end = (this._name.indexOf(0) + 1 || 256) - 1;
-            const name = Buffer.from(this._name.subarray(0, end));
-            return (this._encoding == 'buffer' ? name : name.toString(this._encoding));
-        }
-        /**
-         * @internal @protected
-         */
-        _encoding = __runInitializers(this, __name_extraInitializers);
-        /**
-         * @internal @protected
-         */
-        _parentPath;
-        get parentPath() {
-            return this._parentPath;
-        }
-        /**
-         * @deprecated Removed in Node v24, use `parentPath` instead.
-         */
-        get path() {
-            warn('Dirent.path was removed in Node v24, use parentPath instead');
-            return this._parentPath;
-        }
-        /**
-         * @internal
-         */
-        static from(path, stats, encoding) {
-            const dirent = new Dirent(new ArrayBuffer(sizeof(Dirent) + 1));
-            dirent._parentPath = dirname(path);
-            dirent._name = encodeUTF8(basename(path));
-            dirent.ino = stats.ino;
-            dirent.type = ifToDt(stats.mode);
-            dirent._encoding = encoding;
-            return dirent;
-        }
-        isFile() {
-            return this.type === DirType.REG;
-        }
-        isDirectory() {
-            return this.type === DirType.DIR;
-        }
-        isBlockDevice() {
-            return this.type === DirType.BLK;
-        }
-        isCharacterDevice() {
-            return this.type === DirType.CHR;
-        }
-        isSymbolicLink() {
-            return this.type === DirType.LNK;
-        }
-        isFIFO() {
-            return this.type === DirType.FIFO;
-        }
-        isSocket() {
-            return this.type === DirType.SOCK;
-        }
-    };
-    return Dirent = _classThis;
-})();
-export { Dirent };
-/**
- * A class representing a directory stream.
- */
-export class Dir {
+export class Dirent {
+    ino;
+    type;
     path;
-    context;
-    closed = false;
-    checkClosed() {
-        if (this.closed)
-            throw withErrno('EBADF', 'Can not use closed Dir');
-    }
-    _entries;
-    constructor(path, context) {
-        this.path = path;
-        this.context = context;
-    }
-    close(cb) {
-        this.closed = true;
-        if (!cb) {
-            return Promise.resolve();
-        }
-        cb(null);
-    }
-    /**
-     * Synchronously close the directory's underlying resource handle.
-     * Subsequent reads will result in errors.
-     */
-    closeSync() {
-        this.closed = true;
-    }
-    async _read() {
-        this.checkClosed();
-        this._entries ??= await readdir.call(this.context, this.path, {
-            withFileTypes: true,
-        });
-        if (!this._entries.length)
-            return null;
-        return this._entries.shift() ?? null;
-    }
-    read(cb) {
-        if (!cb) {
-            return this._read();
-        }
-        void this._read().then(value => cb(null, value));
-    }
-    /**
-     * 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.
-     * Directory entries returned by this function are in no particular order as provided by the operating system's underlying directory mechanisms.
-     */
-    readSync() {
-        this.checkClosed();
-        this._entries ??= readdirSync.call(this.context, this.path, { withFileTypes: true });
-        if (!this._entries.length)
-            return null;
-        return this._entries.shift() ?? null;
-    }
-    async next() {
-        const value = await this._read();
-        if (value) {
-            return { done: false, value };
-        }
-        await this.close();
-        return { done: true, value: undefined };
-    }
-    /**
-     * Asynchronously iterates over the directory via `readdir(3)` until all entries have been read.
-     */
-    [Symbol.asyncIterator]() {
-        return this;
-    }
-    [Symbol.dispose]() {
-        if (this.closed)
-            return;
-        this.closeSync();
-    }
-    async [Symbol.asyncDispose]() {
-        if (this.closed)
-            return;
-        await this.close();
-    }
+    name;
 }

package/dist/vfs/file.d.ts

@@ -10,7 +10,7 @@ export interface FileReadResult<T extends ArrayBufferView> {
 /**
  * @internal
  */
-export declare class SyncHandle {
+export declare class Handle {
     readonly context: V_Context;
     readonly path: string;
     readonly fs: FileSystem;
@@ -41,25 +41,64 @@ export declare class SyncHandle {
      * Whether the file is open or closed
      */
     protected closed: boolean;
+    get isClosed(): boolean;
     /**
      * Creates a file with `path` and, optionally, the given contents.
      * Note that, if contents is specified, it will be mutated by the file.
      */
     constructor(context: V_Context, path: string, fs: FileSystem, internalPath: string, flag: number, inode: InodeLike);
+    protected get _isSync(): boolean;
     [Symbol.dispose](): void;
-    private get _isSync();
-    sync(): void;
+    syncSync(): void;
     /**
      * Default implementation maps to `syncSync`.
      */
-    datasync(): void;
-    close(): void;
+    datasyncSync(): void;
+    closeSync(): void;
+    /**
+     * Cleans up. This will *not* sync the file data to the FS
+     */
+    protected disposeSync(force?: boolean): void;
+    truncateSync(length: number): void;
+    /**
+     * Write buffer to the file.
+     * @param buffer Uint8Array containing the data to write to the file.
+     * @param offset Offset in the buffer to start reading data from.
+     * @param length The amount of bytes to write to the file.
+     * @param position Offset from the beginning of the file where this data should be written.
+     * If position is null, the data will be written at  the current position.
+     * @returns bytes written
+     */
+    writeSync(buffer: Uint8Array, offset?: number, length?: number, position?: number): number;
+    /**
+     * Read data from the file.
+     * @param buffer The buffer that the data will be written to.
+     * @param offset The offset within the buffer where writing will start.
+     * @param length An integer specifying the number of bytes to read.
+     * @param position An integer specifying where to begin reading from in the file.
+     * If position is null, data will be read from the current file position.
+     * @returns number of bytes written
+     */
+    readSync(buffer: ArrayBufferView, offset?: number, length?: number, position?: number): number;
+    chmodSync(mode: number): void;
+    chownSync(uid: number, gid: number): void;
+    /**
+     * Change the file timestamps of the file.
+     */
+    utimesSync(atime: number, mtime: number): void;
+    [Symbol.asyncDispose](): Promise<void>;
+    sync(): Promise<void>;
+    /**
+     * Default implementation maps to `sync`.
+     */
+    datasync(): Promise<void>;
+    close(): Promise<void>;
     /**
      * Cleans up. This will *not* sync the file data to the FS
      */
     protected dispose(force?: boolean): void;
     stat(): InodeLike;
-    truncate(length: number): void;
+    truncate(length: number): Promise<void>;
     /**
      * Write buffer to the file.
      * @param buffer Uint8Array containing the data to write to the file.
@@ -69,7 +108,7 @@ export declare class SyncHandle {
      * If position is null, the data will be written at  the current position.
      * @returns bytes written
      */
-    write(buffer: Uint8Array, offset?: number, length?: number, position?: number): number;
+    write(buffer: Uint8Array, offset?: number, length?: number, position?: number): Promise<number>;
     /**
      * Read data from the file.
      * @param buffer The buffer that the data will be written to.
@@ -79,13 +118,13 @@ export declare class SyncHandle {
      * If position is null, data will be read from the current file position.
      * @returns number of bytes written
      */
-    read(buffer: ArrayBufferView, offset?: number, length?: number, position?: number): number;
-    chmod(mode: number): void;
-    chown(uid: number, gid: number): void;
+    read(buffer: ArrayBufferView, offset?: number, length?: number, position?: number): Promise<number>;
+    chmod(mode: number): Promise<void>;
+    chown(uid: number, gid: number): Promise<void>;
     /**
      * Change the file timestamps of the file.
      */
-    utimes(atime: number, mtime: number): void;
+    utimes(atime: number, mtime: number): Promise<void>;
     /**
      * Create a stream for reading the file.
      */
@@ -98,9 +137,9 @@ export declare class SyncHandle {
 /**
  * @internal @hidden
  */
-export declare function toFD(file: SyncHandle): number;
+export declare function toFD(file: Handle): number;
 /**
  * @internal @hidden
  */
-export declare function fromFD($: V_Context, fd: number): SyncHandle;
+export declare function fromFD($: V_Context, fd: number): Handle;
 export declare function deleteFD($: V_Context, fd: number): boolean;