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

package/dist/runtime/js/host/descriptors.js

@@ -0,0 +1,331 @@
+// ========= 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 { constants } from 'node:fs';
+import { devNull } from 'node:os';
+import { walkSpelling } from '@struktoai/mirage-core/commands/builtin/utils/paths';
+import { ebadf, eisdir, eloop, enoent, enotdir } from '@struktoai/mirage-core/errors/fs';
+import { keptView } from '@struktoai/mirage-core/runtime/files';
+import { FileHandle } from '@struktoai/mirage-core/runtime/handles/file_handle';
+import { applyFlush } from '@struktoai/mirage-core/runtime/handles/flush';
+import { applyOpen } from '@struktoai/mirage-core/runtime/open';
+import { PathSpec } from '@struktoai/mirage-core/types';
+import { CycleError, resolvePath } from '@struktoai/mirage-core/utils/path';
+const { O_RDONLY, O_WRONLY, O_RDWR, O_CREAT, O_EXCL, O_TRUNC, O_APPEND } = constants;
+const { O_NOFOLLOW, O_DIRECTORY } = constants;
+// node's string flags as open(2) flags, the synchronous spellings read as
+// their plain ones: a mount has no page cache for them to bypass.
+const STRING_FLAGS = {
+    r: O_RDONLY,
+    rs: O_RDONLY,
+    sr: O_RDONLY,
+    'r+': O_RDWR,
+    'rs+': O_RDWR,
+    'sr+': O_RDWR,
+    w: O_TRUNC | O_CREAT | O_WRONLY,
+    wx: O_TRUNC | O_CREAT | O_WRONLY | O_EXCL,
+    xw: O_TRUNC | O_CREAT | O_WRONLY | O_EXCL,
+    'w+': O_TRUNC | O_CREAT | O_RDWR,
+    'wx+': O_TRUNC | O_CREAT | O_RDWR | O_EXCL,
+    'xw+': O_TRUNC | O_CREAT | O_RDWR | O_EXCL,
+    a: O_APPEND | O_CREAT | O_WRONLY,
+    ax: O_APPEND | O_CREAT | O_WRONLY | O_EXCL,
+    xa: O_APPEND | O_CREAT | O_WRONLY | O_EXCL,
+    as: O_APPEND | O_CREAT | O_WRONLY,
+    sa: O_APPEND | O_CREAT | O_WRONLY,
+    'a+': O_APPEND | O_CREAT | O_RDWR,
+    'ax+': O_APPEND | O_CREAT | O_RDWR | O_EXCL,
+    'xa+': O_APPEND | O_CREAT | O_RDWR | O_EXCL,
+    'as+': O_APPEND | O_CREAT | O_RDWR,
+    'sa+': O_APPEND | O_CREAT | O_RDWR,
+};
+/** node's `flags` argument as open(2) flags; node's default is `'r'`. */
+export function openFlags(flags) {
+    if (typeof flags === 'number')
+        return flags;
+    if (flags === undefined || flags === null)
+        return O_RDONLY;
+    const known = typeof flags === 'string' ? STRING_FLAGS[flags] : undefined;
+    if (known === undefined) {
+        const shown = typeof flags === 'string' ? flags : typeof flags;
+        throw Object.assign(new TypeError(`The value "${shown}" is invalid for option "flags"`), {
+            code: 'ERR_INVALID_ARG_VALUE',
+        });
+    }
+    return known;
+}
+/** What open(2) flags say about a handle, in the mode vocabulary. Mirrors
+ * python's `host/descriptors.open_mode`. */
+export function openMode(flags) {
+    const access = flags & (O_WRONLY | O_RDWR);
+    const writable = access === O_WRONLY || access === O_RDWR;
+    const create = (flags & O_CREAT) !== 0;
+    return {
+        readable: access === O_RDONLY || access === O_RDWR,
+        writable,
+        truncate: writable && (flags & O_TRUNC) !== 0,
+        append: (flags & O_APPEND) !== 0,
+        create,
+        exclusive: create && (flags & O_EXCL) !== 0,
+        binary: true,
+    };
+}
+/** Read `size` bytes at `offset` without moving the handle's position,
+ * fetching what the handle lacks first; the caller holds the descriptor's
+ * queue, so nothing else moves the position meanwhile. */
+export async function readAt(handle, offset, size) {
+    const pos = handle.pos;
+    handle.pos = offset;
+    try {
+        while (handle.lacks(size))
+            await handle.fill(size);
+        return handle.pread(offset, size);
+    }
+    finally {
+        handle.pos = pos;
+    }
+}
+/** Read up to `size` bytes at the position, advancing it. */
+export async function readOn(handle, size) {
+    while (handle.lacks(size))
+        await handle.fill(size);
+    return handle.read(size);
+}
+/**
+ * The descriptors `open` hands out for mounted paths, by number: the
+ * twin of python's `host/descriptors.Descriptors`.
+ *
+ * Each number is a real descriptor on the null device, held open as long
+ * as the mounted one is, so it never collides with a file the process
+ * opens meanwhile; the descriptor calls that could reach the device with
+ * it (fchmod, fchown, futimes) are routed too. Writes stay in the handle
+ * until a `close` or an `fsync`. The calls on one descriptor run one at a
+ * time (`serial`), so a sync never settles writes made while it was out
+ * and a positioned read never moves another call's position. A descriptor
+ * follows its file through a rename made through the patch, and keeps the
+ * bytes it had once one removes or replaces its name.
+ */
+export class Descriptors {
+    files;
+    native;
+    links;
+    table = new Map();
+    queues = new Map();
+    constructor(files, native, 
+    // The namespace's links, which a walk follows; null while it keeps none.
+    links) {
+        this.files = files;
+        this.native = native;
+        this.links = links;
+    }
+    /** The path an op on `path` lands on, as the dispatcher walks it: a link
+     * in front of a dot followed before the climb, the dots resolved, and the
+     * final link followed too when `follow` (a rename or a removal acts on
+     * the name itself). One file reads as one path whichever spelling reached
+     * it, which is how a rename or an unlink finds the descriptors open on
+     * it. Mirrors python's Descriptors.walked. */
+    walked(path, follow = true) {
+        const spec = PathSpec.fromStrPath(path, undefined, '/');
+        const links = this.links;
+        if (links === null)
+            return spec.virtual;
+        const resolve = (virtual) => links.follow(virtual);
+        try {
+            const spelled = walkSpelling(spec, resolve);
+            const cut = spelled.lastIndexOf('/');
+            const name = spelled.slice(cut + 1);
+            if (follow || name === '' || name === '.' || name === '..') {
+                return resolvePath(resolve(spelled), '/');
+            }
+            const above = resolvePath(resolve(spelled.slice(0, cut) || '/'), '/');
+            return `${above.replace(/\/+$/, '')}/${name}`;
+        }
+        catch (err) {
+            if (err instanceof CycleError)
+                throw eloop(path);
+            throw err;
+        }
+    }
+    /** The mounted descriptor `fd` is, else undefined. */
+    get(fd) {
+        return typeof fd === 'number' ? this.table.get(fd) : undefined;
+    }
+    /** Run `fn` after every call already queued on `fd`. */
+    serial(fd, fn) {
+        const prev = this.queues.get(fd) ?? Promise.resolve();
+        const run = prev.then(fn);
+        const tail = run.then(() => undefined, () => undefined);
+        this.queues.set(fd, tail);
+        void tail.then(() => {
+            if (this.queues.get(fd) === tail)
+                this.queues.delete(fd);
+        });
+        return run;
+    }
+    /** Open a mounted path by open(2) flags and number the result. */
+    async open(path, flags) {
+        const mode = openMode(flags);
+        const row = await this.files.statOrNull(path, (flags & O_NOFOLLOW) !== 0);
+        if (row?.isLink === true)
+            throw eloop(path);
+        if ((flags & O_DIRECTORY) !== 0 && row?.isDir !== true) {
+            throw row === null ? enoent(path) : enotdir(path);
+        }
+        const desc = { path, mode, handle: null, kept: null, opened: path, stat: row };
+        // What other descriptors on the file still owe lands first, so their
+        // older writes never land over what this one writes.
+        if (mode.writable)
+            await this.landPath(path);
+        if (row?.isDir !== true || mode.writable || mode.create) {
+            const opened = await applyOpen(this.files, path, mode);
+            desc.handle = FileHandle.opened(path, opened === null ? null : this.fetch(desc, mode.writable), { size: opened?.size ?? 0, writable: mode.writable, append: mode.append });
+        }
+        desc.stat ??= await this.files.stat(path);
+        desc.path = this.walked(path);
+        desc.opened = desc.path;
+        const fd = this.native.openSync(devNull, 'r');
+        this.table.set(fd, desc);
+        return fd;
+    }
+    /** A descriptor's ranged read: what it kept once its name went, else
+     * what is at its path now. */
+    fetch(desc, raw) {
+        return (offset, size) => {
+            const kept = desc.kept;
+            if (kept !== null) {
+                try {
+                    const view = keptView(kept, raw);
+                    return Promise.resolve(view.slice(offset, size === null ? undefined : offset + size));
+                }
+                catch (err) {
+                    return Promise.reject(err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+            return this.files.read(desc.path, size === null ? { raw } : { offset, size, raw });
+        };
+    }
+    /** Land a descriptor's writes on the mount; one whose name went lands
+     * them on what its file kept, which every other descriptor on it reads,
+     * as writes to an unlinked file stay with it. */
+    async land(desc) {
+        const handle = desc.handle;
+        if (handle === null)
+            return;
+        if (desc.kept !== null) {
+            if (handle.dirty) {
+                desc.kept.data = applyFlush(desc.kept.data, handle.flushPlan());
+                handle.settle(this.fetch(desc, true));
+                this.invalidatePeers(desc);
+            }
+            return;
+        }
+        const steps = handle.flushPlan();
+        if (steps.length === 0)
+            return;
+        await this.files.flush(desc.path, steps);
+        handle.settle(this.fetch(desc, true));
+        this.invalidatePeers(desc);
+    }
+    invalidatePeers(changed) {
+        for (const peer of this.table.values()) {
+            const same = changed.kept !== null
+                ? peer.kept === changed.kept
+                : peer.kept === null && peer.path === changed.path;
+            if (peer === changed || !same || peer.handle === null)
+                continue;
+            const size = peer.kept === null
+                ? (changed.handle?.size ?? 0)
+                : keptView(peer.kept, peer.mode.writable).length;
+            peer.handle.invalidate(this.fetch(peer, peer.mode.writable), size);
+        }
+    }
+    /** Land the writes of every descriptor open on `path`, which a change of
+     * its times must come after. */
+    async landPath(path) {
+        const named = this.walked(path);
+        for (const [fd, desc] of this.table) {
+            if (desc.path === named)
+                await this.serial(fd, () => this.land(desc));
+        }
+    }
+    /** Follow a rename: a descriptor on `from` or under it names the same
+     * file at `to` now, both as walked before the rename. */
+    moved(from, to) {
+        const under = `${from.replace(/\/+$/, '')}/`;
+        for (const desc of this.table.values()) {
+            if (desc.kept === null && (desc.path === from || desc.path.startsWith(under))) {
+                desc.path = to + desc.path.slice(from.length);
+            }
+        }
+    }
+    /** Read what the descriptors open on `path` need before its name is
+     * removed or replaced; `keep` them once it has gone. They share what
+     * RuntimeFiles.kept reads, so a read that fails (a policy refusing it,
+     * say) still lets the removal it allows go ahead. The descriptors are
+     * collected once the read is back, so one opened while it was out is held
+     * too, and a view the read skipped is read for it. */
+    async hold(path) {
+        const named = this.walked(path, false);
+        const open = () => [...this.table.values()].filter((desc) => desc.path === named && desc.kept === null && desc.handle !== null);
+        if (open().length === 0)
+            return [];
+        let read = { stored: false, rendered: false };
+        let kept = null;
+        for (;;) {
+            const held = open();
+            // A descriptor that cannot read needs nothing kept for it.
+            const stored = held.some((desc) => desc.mode.writable);
+            const rendered = held.some((desc) => desc.mode.readable && !desc.mode.writable);
+            if (kept !== null && (!stored || read.stored) && (!rendered || read.rendered)) {
+                const answer = kept;
+                return held.map((desc) => [desc, answer]);
+            }
+            read = { stored: read.stored || stored, rendered: read.rendered || rendered };
+            kept = await this.files.kept(named, read);
+        }
+    }
+    /** Detach the descriptors `hold` read for, now their name went. */
+    keep(held) {
+        for (const [desc, kept] of held)
+            desc.kept = kept;
+    }
+    /** Land a descriptor's writes and give its number back. */
+    close(fd) {
+        return this.serial(fd, async () => {
+            const desc = this.table.get(fd);
+            if (desc === undefined)
+                throw ebadf(String(fd));
+            this.table.delete(fd);
+            try {
+                await this.land(desc);
+            }
+            finally {
+                ;
+                this.native.closeSync(fd);
+            }
+        });
+    }
+    /** The handle a read or a write through `fd` uses. */
+    file(fd, wantRead, wantWrite) {
+        const desc = this.table.get(fd);
+        if (desc === undefined)
+            throw ebadf(String(fd));
+        if (desc.handle === null)
+            throw eisdir(desc.path);
+        if ((wantRead && !desc.mode.readable) || (wantWrite && !desc.mode.writable)) {
+            throw ebadf(desc.path);
+        }
+        return desc.handle;
+    }
+}
+//# sourceMappingURL=descriptors.js.map

package/dist/runtime/js/host/descriptors.js.map

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

package/dist/runtime/js/host/fs.d.ts

@@ -0,0 +1,18 @@
+import type { Workspace } from '@struktoai/mirage-core/workspace/workspace/workspace';
+/**
+ * Point node's own `fs` at the workspace for every mounted path.
+ *
+ * Each name in `constants.ts` is swapped on the CommonJS `fs` object
+ * and on `fs.promises`, in all the spellings node has: a routed call
+ * goes through the workspace, a refused one answers its condition, and
+ * a sync spelling refuses a mounted path, since the workspace answers
+ * asynchronously. A path no mount owns reaches node's own function in
+ * every spelling, so the rest of the process keeps its filesystem. ESM
+ * named imports of `node:fs/promises` keep node's functions: an ES
+ * module binds them at link time, which is also why a node backend's
+ * own host I/O never routes back into the workspace.
+ *
+ * Returns a `restore()` that puts every swapped function back.
+ */
+export declare function patchNodeFs(ws: Workspace): () => void;
+//# sourceMappingURL=fs.d.ts.map

package/dist/runtime/js/host/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../../src/runtime/js/host/fs.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sDAAsD,CAAA;AAo1BrF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,IAAI,CA4KrD"}