@struktoai/mirage-node 0.0.5 → 0.0.7-alpha.1

package/dist/fuse/core.d.ts

@@ -0,0 +1,157 @@
+import type { OpRecord } from '@struktoai/mirage-core/observe/record';
+import type { Ops } from '@struktoai/mirage-core/ops/ops';
+import { FileTable } from '@struktoai/mirage-core/runtime/handles/index';
+import type { FileStat } from '@struktoai/mirage-core/types';
+import type { Session } from '@struktoai/mirage-core/workspace/session/session';
+export interface FuseAttr {
+    mtime: Date;
+    atime: Date;
+    ctime: Date;
+    nlink: number;
+    size: number;
+    mode: number;
+    uid: number;
+    gid: number;
+}
+export interface Handle {
+    path: string;
+    data?: Uint8Array;
+    writeBuf?: [number, Uint8Array][];
+}
+interface PrefetchEntry {
+    data: Uint8Array;
+    expires: number;
+}
+export interface MountCoreOptions {
+    rootPrefix?: string;
+    /**
+     * Bind every op to this session's mount grants. The kernel-tier
+     * primitive: bind-mount the tree into a container and the narrowing
+     * travels with it. Enforcement happens inside dispatch/Ops via the
+     * session context, so binding at the op entry point is sufficient.
+     */
+    session?: Session;
+}
+/**
+ * Protocol-neutral mount logic shared by every kernel adapter.
+ *
+ * Everything here is expressed in POSIX terms (attribute records, ordinary
+ * thrown errors) and imports nothing from `@zkochan/fuse-native`, so it is
+ * reusable by a non-FUSE adapter and unit-testable without a kernel.
+ *
+ * The division of labour: this class decides *what* the filesystem
+ * contains, an adapter decides *how* to say it to a particular kernel
+ * interface. Adapters translate the errors thrown here into their own
+ * error codes with `classifyErrno`. Mirrors Python's `MountCore`.
+ *
+ * Every op goes through `ws.fs`, which delegates to the dispatcher, so
+ * a mount walks the same door as a shell line (mount modes, policies,
+ * cache, invalidation) and every op it runs lands in `ws.records` for
+ * `drainOps`. Reaching `ws.dispatch` from here instead would skip the
+ * record; reaching a backend directly would skip the door.
+ */
+export declare class MountCore {
+    readonly ops: Ops;
+    readonly session: Session | null;
+    private readonly now;
+    private readonly root;
+    readonly handles: FileTable<Handle>;
+    readonly xattrs: Map<string, Map<string, Buffer<ArrayBufferLike>>>;
+    readonly prefetchCache: Map<string, PrefetchEntry>;
+    private readonly prefetchInflight;
+    private readonly uid;
+    private readonly gid;
+    constructor(ops: Ops, options?: MountCoreOptions);
+    resolve(path: string): string;
+    dirStat(): FuseAttr;
+    fileStat(size: number): FuseAttr;
+    /**
+     * Fold merged stat attributes into an attr record. The workspace stat
+     * already carries the namespace overlay (chmod bits, chown ids, touched
+     * mtime), so honoring these fields here is what makes metadata ops
+     * visible through a mount. String uid/gid (names) are skipped: the kernel
+     * wants numeric ids and there is no user db to map against.
+     */
+    applyStatAttrs(entry: FuseAttr, s: FileStat): FuseAttr;
+    /**
+     * The target to present for a namespace link at a mount path, or null
+     * when not a link. Relative targets are stored verbatim and returned
+     * as-is. Absolute targets name virtual paths, so they are rewritten
+     * relative to the link's directory: returned raw, the kernel would
+     * resolve them against the host root and escape the mountpoint.
+     */
+    linkTarget(path: string): string | null;
+    /**
+     * The attrs a namespace link reports, from its own node row.
+     *
+     * Built from the target string alone, every link over a mount answered
+     * the mount's construction time and the mounting user, so what
+     * `chown -h` and `touch -h` wrote was invisible through the kernel.
+     * The row is the same one the door answers a no-follow stat with. Size
+     * stays the displayable target's length (what this mount's readlink
+     * returns), and the mode is always lrwxrwxrwx: a symlink's permission
+     * bits are not consulted by any POSIX system.
+     */
+    linkStat(target: string, virtual: string): FuseAttr;
+    cachedSize(path: string): number | null;
+    cachedData(path: string): Uint8Array | null;
+    /**
+     * Fetch bytes for a size-unknown file and cache them so the open → read →
+     * fstat burst (and subsequent stats within the TTL) reuse the same fetch.
+     * With getattr reporting 0 pre-open, this hydration is what lets fgetattr
+     * answer with the real byte length after open (mirrors Python's
+     * `prefetch_read`).
+     */
+    prefetch(path: string): Promise<Uint8Array | null>;
+    /** Drain and return accumulated op records (mirrors Python's drainOps). */
+    drainOps(): OpRecord[];
+    private writeFile;
+    /**
+     * Merge buffered writes over the raw base and persist the result.
+     * The base is read raw so a flush never stores a rendered view back
+     * into the mount.
+     */
+    private applyWrites;
+    getattr(path: string): Promise<FuseAttr>;
+    /** Attributes through an open handle, or path-based when not hydrated. */
+    fgetattr(path: string, fd: number): Promise<FuseAttr>;
+    readdir(path: string): Promise<string[]>;
+    read(path: string, fd: number, pos: number, len: number): Promise<Uint8Array>;
+    /** Buffer a write on its handle, or apply it directly when there is none. */
+    write(path: string, fd: number, data: Uint8Array, pos: number): Promise<void>;
+    create(path: string): Promise<number>;
+    mkdir(path: string): Promise<void>;
+    readlink(path: string): string;
+    /**
+     * Create namespace link `dest -> src` (ln -s src dest; libfuse passes
+     * the pointee first). Relative sources are stored verbatim (resolved
+     * at follow time, exactly like the shell `ln -s`); absolute sources
+     * are mapped into virtual space so a scoped mount stores the path it
+     * will later follow.
+     */
+    symlink(src: string, dest: string): Promise<void>;
+    /**
+     * Remove the entry at `path`, a link entry like any other.
+     *
+     * A link routes through the op door rather than straight to the node
+     * table: `unlink` is a LINK_ENTRY_OPS member, so the door answers a
+     * link path itself, gated by session grants and admission policies
+     * and recorded on the ledger. Writing the table here instead let a
+     * session-scoped kernel mount delete a link on a mount its profile
+     * hides. Mirrors Python's MountCore.unlink.
+     */
+    unlink(path: string): Promise<void>;
+    rename(src: string, dst: string): Promise<void>;
+    rmdir(path: string): Promise<void>;
+    truncate(path: string, size: number): Promise<void>;
+    statfs(): Record<string, number>;
+    setxattr(path: string, name: string, value: Buffer): void;
+    getxattr(path: string, name: string): Buffer | undefined;
+    listxattr(path: string): string[];
+    removexattr(path: string, name: string): void;
+    open(path: string): Promise<number>;
+    release(fd: number): Promise<void>;
+    flush(path: string, fd: number): Promise<void>;
+}
+export {};
+//# sourceMappingURL=core.d.ts.map

package/dist/fuse/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/fuse/core.ts"],"names":[],"mappings":"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"}

package/dist/fuse/core.js

@@ -0,0 +1,478 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { posix } from 'node:path';
+import { FileTable, mergeWrites } from '@struktoai/mirage-core/runtime/handles/index';
+import { FileType } from '@struktoai/mirage-core/types';
+import { isMissingOp } from '@struktoai/mirage-core/utils/errors';
+import { rstripSlash } from '@struktoai/mirage-core/utils/slash';
+import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
+import { DIR_MODE, FILE_MODE, mtimeMs } from '@struktoai/mirage-core/utils/stat_view';
+import { errnoError } from "./errors.js";
+import { isMacosMetadata } from "./platform/macos.js";
+const PREFETCH_TTL_MS = 30_000;
+/**
+ * Protocol-neutral mount logic shared by every kernel adapter.
+ *
+ * Everything here is expressed in POSIX terms (attribute records, ordinary
+ * thrown errors) and imports nothing from `@zkochan/fuse-native`, so it is
+ * reusable by a non-FUSE adapter and unit-testable without a kernel.
+ *
+ * The division of labour: this class decides *what* the filesystem
+ * contains, an adapter decides *how* to say it to a particular kernel
+ * interface. Adapters translate the errors thrown here into their own
+ * error codes with `classifyErrno`. Mirrors Python's `MountCore`.
+ *
+ * Every op goes through `ws.fs`, which delegates to the dispatcher, so
+ * a mount walks the same door as a shell line (mount modes, policies,
+ * cache, invalidation) and every op it runs lands in `ws.records` for
+ * `drainOps`. Reaching `ws.dispatch` from here instead would skip the
+ * record; reaching a backend directly would skip the door.
+ */
+export class MountCore {
+    ops;
+    session;
+    now;
+    root;
+    handles = new FileTable();
+    // In-memory extended attributes, keyed by path. Backends have no POSIX
+    // xattrs, so these are advisory and never persisted; see setxattr.
+    xattrs = new Map();
+    prefetchCache = new Map();
+    prefetchInflight = new Map();
+    uid;
+    gid;
+    constructor(ops, options = {}) {
+        this.ops = ops;
+        this.now = new Date();
+        this.root = options.rootPrefix !== undefined ? rstripSlash(options.rootPrefix) : '';
+        this.uid = typeof process.getuid === 'function' ? process.getuid() : 0;
+        this.gid = typeof process.getgid === 'function' ? process.getgid() : 0;
+        this.session = options.session ?? null;
+    }
+    // ── helpers ──────────────────────────────────────────────────────
+    resolve(path) {
+        if (this.root === '')
+            return path;
+        return path === '/' ? this.root : this.root + path;
+    }
+    dirStat() {
+        return {
+            mtime: this.now,
+            atime: this.now,
+            ctime: this.now,
+            nlink: 2,
+            size: 0,
+            mode: DIR_MODE,
+            uid: this.uid,
+            gid: this.gid,
+        };
+    }
+    fileStat(size) {
+        return {
+            mtime: this.now,
+            atime: this.now,
+            ctime: this.now,
+            nlink: 1,
+            size,
+            mode: FILE_MODE,
+            uid: this.uid,
+            gid: this.gid,
+        };
+    }
+    /**
+     * Fold merged stat attributes into an attr record. The workspace stat
+     * already carries the namespace overlay (chmod bits, chown ids, touched
+     * mtime), so honoring these fields here is what makes metadata ops
+     * visible through a mount. String uid/gid (names) are skipped: the kernel
+     * wants numeric ids and there is no user db to map against.
+     */
+    applyStatAttrs(entry, s) {
+        if (s.mode !== null) {
+            entry.mode = (entry.mode & ~0o7777) | (s.mode & 0o7777);
+        }
+        if (typeof s.uid === 'number')
+            entry.uid = s.uid;
+        if (typeof s.gid === 'number')
+            entry.gid = s.gid;
+        if (s.modified !== null) {
+            // One translator per language: the naive-stamp-is-UTC rule lives
+            // in core's stat view, never re-parsed here with a bare Date.
+            // Null means the stamp did not parse; epoch zero is a real time
+            // and lands.
+            const ms = mtimeMs(s);
+            if (ms !== null) {
+                entry.mtime = new Date(ms);
+                entry.ctime = new Date(ms);
+            }
+        }
+        return entry;
+    }
+    /**
+     * The target to present for a namespace link at a mount path, or null
+     * when not a link. Relative targets are stored verbatim and returned
+     * as-is. Absolute targets name virtual paths, so they are rewritten
+     * relative to the link's directory: returned raw, the kernel would
+     * resolve them against the host root and escape the mountpoint.
+     */
+    linkTarget(path) {
+        const links = this.ops.links;
+        if (links === null)
+            return null;
+        const target = links.readlink(this.resolve(path));
+        if (target === null)
+            return null;
+        if (!target.startsWith('/'))
+            return target;
+        let virtualTarget = target;
+        if (this.root !== '') {
+            if (target === this.root) {
+                virtualTarget = '/';
+            }
+            else if (target.startsWith(this.root + '/')) {
+                virtualTarget = target.slice(this.root.length);
+            }
+            else {
+                // points outside the scoped root: unreachable through this
+                // mount, keep the stored form (a dangling link is legal)
+                return target;
+            }
+        }
+        const slash = path.lastIndexOf('/');
+        const parent = slash <= 0 ? '/' : path.slice(0, slash);
+        return posix.relative(parent, virtualTarget);
+    }
+    /**
+     * The attrs a namespace link reports, from its own node row.
+     *
+     * Built from the target string alone, every link over a mount answered
+     * the mount's construction time and the mounting user, so what
+     * `chown -h` and `touch -h` wrote was invisible through the kernel.
+     * The row is the same one the door answers a no-follow stat with. Size
+     * stays the displayable target's length (what this mount's readlink
+     * returns), and the mode is always lrwxrwxrwx: a symlink's permission
+     * bits are not consulted by any POSIX system.
+     */
+    linkStat(target, virtual) {
+        const entry = this.fileStat(new TextEncoder().encode(target).byteLength);
+        const row = this.ops.links?.linkStatAt(virtual) ?? null;
+        if (row !== null)
+            this.applyStatAttrs(entry, row);
+        entry.mode = 0o120777;
+        return entry;
+    }
+    cachedSize(path) {
+        for (const ctx of this.handles.values()) {
+            if (ctx.path === path && ctx.data !== undefined)
+                return ctx.data.byteLength;
+        }
+        const entry = this.prefetchCache.get(path);
+        if (entry !== undefined && entry.expires > Date.now())
+            return entry.data.byteLength;
+        return null;
+    }
+    cachedData(path) {
+        for (const ctx of this.handles.values()) {
+            if (ctx.path === path && ctx.data !== undefined)
+                return ctx.data;
+        }
+        const entry = this.prefetchCache.get(path);
+        if (entry !== undefined && entry.expires > Date.now())
+            return entry.data;
+        if (entry !== undefined)
+            this.prefetchCache.delete(path);
+        return null;
+    }
+    /**
+     * Fetch bytes for a size-unknown file and cache them so the open → read →
+     * fstat burst (and subsequent stats within the TTL) reuse the same fetch.
+     * With getattr reporting 0 pre-open, this hydration is what lets fgetattr
+     * answer with the real byte length after open (mirrors Python's
+     * `prefetch_read`).
+     */
+    async prefetch(path) {
+        const cached = this.cachedData(path);
+        if (cached !== null)
+            return cached;
+        const inflight = this.prefetchInflight.get(path);
+        if (inflight !== undefined)
+            return inflight;
+        const promise = (async () => {
+            try {
+                const data = await this.ops.readFile(this.resolve(path));
+                this.prefetchCache.set(path, { data, expires: Date.now() + PREFETCH_TTL_MS });
+                return data;
+            }
+            catch {
+                return null;
+            }
+            finally {
+                this.prefetchInflight.delete(path);
+            }
+        })();
+        this.prefetchInflight.set(path, promise);
+        return promise;
+    }
+    /** Drain and return accumulated op records (mirrors Python's drainOps). */
+    drainOps() {
+        const records = [...this.ops.records];
+        this.ops.records.length = 0;
+        return records;
+    }
+    async writeFile(path, data) {
+        await this.ops.writeFile(this.resolve(path), data);
+    }
+    /**
+     * Merge buffered writes over the raw base and persist the result.
+     * The base is read raw so a flush never stores a rendered view back
+     * into the mount.
+     */
+    async applyWrites(path, writes) {
+        let existing = new Uint8Array(0);
+        try {
+            existing = await this.ops.readFile(this.resolve(path), { raw: true });
+        }
+        catch {
+            // missing file: start from empty; the write creates it
+        }
+        await this.writeFile(path, mergeWrites(existing, writes));
+    }
+    // ── POSIX surface (throws; adapters classify) ────────────────────
+    async getattr(path) {
+        if (path === '/')
+            return this.dirStat();
+        // macOS Finder/Spotlight probes .DS_Store, ._*, .Spotlight-V100, etc.
+        // Reject early to avoid hitting the ops layer.
+        const name = path.slice(path.lastIndexOf('/') + 1);
+        if (isMacosMetadata(name)) {
+            throw errnoError('ENOENT', `no such file or directory: ${path}`);
+        }
+        // Link check must precede the workspace stat: the fs facade follows
+        // namespace links, so stat on a link path reports the target.
+        const target = this.linkTarget(path);
+        if (target !== null)
+            return this.linkStat(target, this.resolve(path));
+        const s = await this.ops.stat(this.resolve(path));
+        if (s.type === FileType.DIRECTORY) {
+            return this.applyStatAttrs(this.dirStat(), s);
+        }
+        // Size-unknown API files stat as 0 before open (never a fake size):
+        // the mount's direct_io makes the kernel read to EOF regardless, and
+        // attrTimeout '0' routes the post-open fstat to fgetattr, which serves
+        // the real hydrated size. Mirrors Python's core.py; see the CLAUDE.md
+        // FUSE section.
+        let size = s.size;
+        size ??= this.cachedSize(path) ?? 0;
+        return this.applyStatAttrs(this.fileStat(size), s);
+    }
+    /** Attributes through an open handle, or path-based when not hydrated. */
+    async fgetattr(path, fd) {
+        // fstat(fd) after open: the open handler prefetched size-unknown files
+        // into the handle, so answer with the real byte length instead of the
+        // 0 that path-based getattr reported before open.
+        const ctx = this.handles.get(fd);
+        if (ctx?.data !== undefined)
+            return this.fileStat(ctx.data.byteLength);
+        return this.getattr(path);
+    }
+    async readdir(path) {
+        // The workspace dispatcher merges namespace structure (child mounts
+        // and symlinks) into readdir and answers structure-only directories
+        // itself, so the core only normalizes entry shapes and drops macOS
+        // metadata names.
+        const names = new Set();
+        const entries = await this.ops.readdir(this.resolve(path));
+        for (const e of entries) {
+            const part = rstripSlash(e).split('/').pop() ?? '';
+            if (part !== '' && !isMacosMetadata(part))
+                names.add(part);
+        }
+        return ['.', '..', ...[...names].sort(compareCodePoints)];
+    }
+    async read(path, fd, pos, len) {
+        const ctx = this.handles.get(fd);
+        // Filetype-aware read: no `raw: true`, so an extension with a
+        // registered renderer surfaces as rendered text. Mirage registers
+        // none by default, so this reads raw bytes until a mount adds one.
+        // Matches Python's `self._ops.read(path)`, which also dispatches.
+        if (ctx !== undefined && ctx.data === undefined) {
+            const cached = this.cachedData(path);
+            ctx.data = cached ?? (await this.ops.readFile(this.resolve(path)));
+        }
+        const data = ctx?.data ?? this.cachedData(path) ?? (await this.ops.readFile(this.resolve(path)));
+        return data.subarray(pos, pos + len);
+    }
+    /** Buffer a write on its handle, or apply it directly when there is none. */
+    async write(path, fd, data, pos) {
+        const ctx = this.handles.get(fd);
+        if (ctx !== undefined) {
+            ctx.writeBuf ??= [];
+            ctx.writeBuf.push([pos, data]);
+            return;
+        }
+        await this.applyWrites(path, [[pos, data]]);
+    }
+    async create(path) {
+        // Route through the resource's `create` op so backends that distinguish
+        // "create empty" from "write bytes" get the right code path. Falls back
+        // to writeFile(empty) when the resource doesn't expose `create`.
+        try {
+            await this.ops.create(this.resolve(path));
+        }
+        catch (dispatchErr) {
+            if (!isMissingOp(dispatchErr, 'create'))
+                throw dispatchErr;
+            await this.writeFile(path, new Uint8Array(0));
+        }
+        return this.handles.add({ path });
+    }
+    async mkdir(path) {
+        await this.ops.mkdir(this.resolve(path));
+    }
+    readlink(path) {
+        const target = this.linkTarget(path);
+        if (target === null)
+            throw errnoError('EINVAL', `not a symbolic link: ${path}`);
+        return target;
+    }
+    /**
+     * Create namespace link `dest -> src` (ln -s src dest; libfuse passes
+     * the pointee first). Relative sources are stored verbatim (resolved
+     * at follow time, exactly like the shell `ln -s`); absolute sources
+     * are mapped into virtual space so a scoped mount stores the path it
+     * will later follow.
+     */
+    async symlink(src, dest) {
+        // The write routes through the op door like every other FUSE op, so
+        // session grants and admission policies refuse a scoped kernel
+        // mount exactly like a scoped shell.
+        if (this.ops.links === null)
+            throw errnoError('EROFS', 'workspace has no namespace links');
+        const stored = src.startsWith('/') ? this.resolve(src) : src;
+        await this.ops.symlink(this.resolve(dest), stored);
+    }
+    /**
+     * Remove the entry at `path`, a link entry like any other.
+     *
+     * A link routes through the op door rather than straight to the node
+     * table: `unlink` is a LINK_ENTRY_OPS member, so the door answers a
+     * link path itself, gated by session grants and admission policies
+     * and recorded on the ledger. Writing the table here instead let a
+     * session-scoped kernel mount delete a link on a mount its profile
+     * hides. Mirrors Python's MountCore.unlink.
+     */
+    async unlink(path) {
+        await this.ops.unlink(this.resolve(path));
+        this.xattrs.delete(path);
+        this.prefetchCache.delete(path);
+    }
+    async rename(src, dst) {
+        // The facade is where a cross-mount pair is refused with EXDEV,
+        // which is what makes `mv` between two backends fall back to
+        // copy+unlink instead of addressing the destination against the
+        // source's backend.
+        await this.ops.rename(this.resolve(src), this.resolve(dst));
+        const moved = this.xattrs.get(src);
+        if (moved !== undefined) {
+            this.xattrs.delete(src);
+            this.xattrs.set(dst, moved);
+        }
+    }
+    // No emptiness pre-check here, matching the python MountCore. Every
+    // backend's rmdir op refuses a non-empty directory itself, so a listing
+    // first was one extra round trip per call on an API-backed mount, and the
+    // catch that wrapped it swallowed whatever readdir raised.
+    async rmdir(path) {
+        await this.ops.rmdir(this.resolve(path));
+        this.xattrs.delete(path);
+    }
+    async truncate(path, size) {
+        // Prefer the resource's dedicated `truncate` op (atomic on most
+        // backends). Fall back to read/resize/write for resources that don't
+        // expose one.
+        try {
+            await this.ops.truncate(this.resolve(path), size);
+        }
+        catch (dispatchErr) {
+            if (!isMissingOp(dispatchErr, 'truncate'))
+                throw dispatchErr;
+            const data = await this.ops
+                .readFile(this.resolve(path), { raw: true })
+                .catch(() => new Uint8Array(0));
+            const out = new Uint8Array(size);
+            out.set(data.subarray(0, Math.min(data.byteLength, size)), 0);
+            await this.writeFile(path, out);
+        }
+    }
+    statfs() {
+        return {
+            bsize: 4096,
+            frsize: 4096,
+            blocks: 1024 * 1024,
+            bfree: 1024 * 1024,
+            bavail: 1024 * 1024,
+            files: 1_000_000,
+            ffree: 1_000_000,
+            favail: 1_000_000,
+            namemax: 255,
+        };
+    }
+    setxattr(path, name, value) {
+        let attrs = this.xattrs.get(path);
+        if (attrs === undefined) {
+            attrs = new Map();
+            this.xattrs.set(path, attrs);
+        }
+        attrs.set(name, Buffer.from(value));
+    }
+    getxattr(path, name) {
+        return this.xattrs.get(path)?.get(name);
+    }
+    listxattr(path) {
+        const attrs = this.xattrs.get(path);
+        return attrs ? [...attrs.keys()] : [];
+    }
+    removexattr(path, name) {
+        this.xattrs.get(path)?.delete(name);
+    }
+    async open(path) {
+        const s = await this.ops.stat(this.resolve(path));
+        const ctx = { path };
+        if (s.size === null && s.type !== FileType.DIRECTORY) {
+            const data = await this.prefetch(path);
+            if (data !== null)
+                ctx.data = data;
+        }
+        return this.handles.add(ctx);
+    }
+    async release(fd) {
+        const ctx = this.handles.get(fd);
+        if (ctx?.writeBuf !== undefined && ctx.writeBuf.length > 0) {
+            // The macFUSE FSKit shim issues WRITE then RELEASE with no FLUSH in
+            // between (the kext always flushes on close), so a handle can still
+            // hold buffered writes here. Dropping them would silently lose data
+            // written through an fskit mount.
+            await this.flush(ctx.path, fd);
+        }
+        this.handles.pop(fd);
+    }
+    async flush(path, fd) {
+        const ctx = this.handles.get(fd);
+        if (ctx?.writeBuf === undefined || ctx.writeBuf.length === 0)
+            return;
+        const writes = ctx.writeBuf;
+        ctx.writeBuf = [];
+        await this.applyWrites(path, writes);
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/fuse/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/fuse/core.ts"],"names":[],"mappings":"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"}