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

package/dist/observe/redis_store.js.map

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

package/dist/optional_peer.d.ts

@@ -1,2 +1,24 @@
-export { loadOptionalPeer } from '@struktoai/mirage-core/utils/optional_peer';
+import type { RedisClientType } from 'redis';
+/**
+ * A connected node-redis client for `url`, reconnection off. node-redis throws
+ * an `error` nobody listens for, which would end the process, so `onError`
+ * hears it instead: the client is dead after one, and the caller drops it and
+ * connects afresh on its next call.
+ */
+export declare function connectRedis(url: string, feature: string, onError: () => void): Promise<RedisClientType>;
+/**
+ * A node-redis client connected on first use. A client that errors is dropped,
+ * so the next call connects afresh. `close` is idempotent: the workspace closes
+ * the plane store it consumed and the owning WorkspaceStateStore closes every
+ * plane it built, so the second close is a no-op, not a crash on an
+ * already-quit client.
+ */
+export declare class RedisConnection {
+    private readonly url;
+    private readonly feature;
+    private pending;
+    constructor(url: string, feature: string);
+    client(): Promise<RedisClientType>;
+    close(): Promise<void>;
+}
 //# sourceMappingURL=optional_peer.d.ts.map

package/dist/optional_peer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optional_peer.d.ts","sourceRoot":"","sources":["../src/optional_peer.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAA"}
+{"version":3,"file":"optional_peer.d.ts","sourceRoot":"","sources":["../src/optional_peer.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAG5C;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,IAAI,GAClB,OAAO,CAAC,eAAe,CAAC,CAe1B;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,OAAO,CAAwC;gBAGpC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM;IAGlC,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAU5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/optional_peer.js

@@ -11,5 +11,53 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-export { loadOptionalPeer } from '@struktoai/mirage-core/utils/optional_peer';
+import { loadOptionalPeer } from '@struktoai/mirage-core/utils/optional_peer';
+/**
+ * A connected node-redis client for `url`, reconnection off. node-redis throws
+ * an `error` nobody listens for, which would end the process, so `onError`
+ * hears it instead: the client is dead after one, and the caller drops it and
+ * connects afresh on its next call.
+ */
+export async function connectRedis(url, feature, onError) {
+    const mod = await loadOptionalPeer(() => import('redis'), { feature, packageName: 'redis' });
+    const c = mod.createClient({
+        url,
+        socket: { reconnectStrategy: false },
+    });
+    c.on('error', onError);
+    await c.connect();
+    return c;
+}
+/**
+ * A node-redis client connected on first use. A client that errors is dropped,
+ * so the next call connects afresh. `close` is idempotent: the workspace closes
+ * the plane store it consumed and the owning WorkspaceStateStore closes every
+ * plane it built, so the second close is a no-op, not a crash on an
+ * already-quit client.
+ */
+export class RedisConnection {
+    url;
+    feature;
+    pending = null;
+    constructor(url, feature) {
+        this.url = url;
+        this.feature = feature;
+    }
+    client() {
+        if (this.pending === null) {
+            const pending = connectRedis(this.url, this.feature, () => {
+                if (this.pending === pending)
+                    this.pending = null;
+            });
+            this.pending = pending;
+        }
+        return this.pending;
+    }
+    async close() {
+        const pending = this.pending;
+        this.pending = null;
+        if (pending !== null)
+            await (await pending).quit();
+    }
+}
 //# sourceMappingURL=optional_peer.js.map

package/dist/optional_peer.js.map

@@ -1 +1 @@
-{"version":3,"file":"optional_peer.js","sourceRoot":"","sources":["../src/optional_peer.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAA"}
+{"version":3,"file":"optional_peer.js","sourceRoot":"","sources":["../src/optional_peer.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAA;AAE7E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,OAAe,EACf,OAAmB;IAEnB,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAChC,GAAG,EAAE,CACH,MAAM,CAAC,OAAO,CAEZ,EACJ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAClC,CAAA;IACD,MAAM,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC;QACzB,GAAG;QACH,MAAM,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE;KACK,CAAC,CAAA;IAC5C,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACtB,MAAM,CAAC,CAAC,OAAO,EAAE,CAAA;IACjB,OAAO,CAAC,CAAA;AACV,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAIP;IACA;IAJX,OAAO,GAAoC,IAAI,CAAA;IAEvD,YACmB,GAAW,EACX,OAAe;QADf,QAAG,GAAH,GAAG,CAAQ;QACX,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ,MAAM;QACJ,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACxD,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;oBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;YACnD,CAAC,CAAC,CAAA;YACF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACxB,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM,CAAC,MAAM,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;IACpD,CAAC;CACF"}

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

@@ -0,0 +1,8 @@
+import type { FsCondition } from '@struktoai/mirage-core/errors/types';
+export declare const ROUTED_CALLS: readonly ["access", "appendFile", "chmod", "chown", "copyFile", "exists", "lchmod", "lchown", "lstat", "lutimes", "mkdir", "readFile", "readdir", "readlink", "rename", "rm", "rmdir", "stat", "symlink", "truncate", "unlink", "utimes", "writeFile"];
+export type RoutedCall = (typeof ROUTED_CALLS)[number];
+export declare const DESCRIPTOR_CALLS: readonly ["close", "fchmod", "fchown", "fdatasync", "fstat", "fsync", "ftruncate", "futimes", "read", "readv", "write", "writev"];
+export declare const REFUSED_CALLS: Readonly<Record<string, FsCondition>>;
+export declare const LISTENED_CALLS: ReadonlySet<string>;
+export declare const PATH_ARGS: Readonly<Record<string, readonly number[]>>;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/runtime/js/host/constants.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA;AAatE,eAAO,MAAM,YAAY,wPAwBf,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAMtD,eAAO,MAAM,gBAAgB,mIAanB,CAAA;AAIV,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAY/D,CAAA;AAKD,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAAmC,CAAA;AAKlF,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAMjE,CAAA"}

package/dist/runtime/js/host/constants.js

@@ -0,0 +1,97 @@
+// ========= 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 { HARD_LINK_REFUSAL } from '@struktoai/mirage-core/runtime/constants';
+// The node fs functions the patch answers, by name, the way python's
+// runtime/python/host/constants.py classifies `os`. A name covers its
+// three spellings (`fs.promises.x`, the callback `fs.x`, `fs.xSync`),
+// whichever node has. A routed name goes through the workspace on a
+// mounted path and a refused one answers its condition there; any other
+// keeps node's function. A sync spelling refuses a mounted path, since
+// the workspace answers asynchronously. constants.test.ts lists the
+// names that keep node's function on purpose, because nothing they take
+// is a path a mount could serve, and fails on any other, which would
+// keep node's own answer with a mounted path in hand.
+export const ROUTED_CALLS = [
+    'access',
+    'appendFile',
+    'chmod',
+    'chown',
+    'copyFile',
+    'exists',
+    'lchmod',
+    'lchown',
+    'lstat',
+    'lutimes',
+    'mkdir',
+    'readFile',
+    'readdir',
+    'readlink',
+    'rename',
+    'rm',
+    'rmdir',
+    'stat',
+    'symlink',
+    'truncate',
+    'unlink',
+    'utimes',
+    'writeFile',
+];
+// The calls that take a descriptor rather than a path: they answer for a
+// descriptor `open` handed out and leave every other one to node. fchmod,
+// fchown and futimes are among them so a mounted descriptor never reaches
+// the device that holds its number.
+export const DESCRIPTOR_CALLS = [
+    'close',
+    'fchmod',
+    'fchown',
+    'fdatasync',
+    'fstat',
+    'fsync',
+    'ftruncate',
+    'futimes',
+    'read',
+    'readv',
+    'write',
+    'writev',
+];
+// Watchers have no workspace twin. A hard link answers EPERM, as link(2)
+// does on a filesystem without them.
+export const REFUSED_CALLS = {
+    cp: 'ENOTSUP',
+    glob: 'ENOTSUP',
+    link: HARD_LINK_REFUSAL,
+    mkdtemp: 'ENOTSUP',
+    mkdtempDisposable: 'ENOTSUP',
+    openAsBlob: 'ENOTSUP',
+    opendir: 'ENOTSUP',
+    realpath: 'ENOTSUP',
+    statfs: 'ENOTSUP',
+    watch: 'ENOTSUP',
+    watchFile: 'ENOTSUP',
+};
+// The refused calls whose function argument is a listener rather than a
+// callback (`fs.watch`, `fs.watchFile`): node answers their failure by
+// throwing, so the refusal throws too instead of calling the listener.
+export const LISTENED_CALLS = new Set(['watch', 'watchFile']);
+// The argument positions that name a path, for the calls that take more
+// than the first: both ends of a move or copy, and a symlink's own
+// location (its target is stored as typed and never routed).
+export const PATH_ARGS = {
+    copyFile: [0, 1],
+    cp: [0, 1],
+    link: [0, 1],
+    rename: [0, 1],
+    symlink: [1],
+};
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/runtime/js/host/constants.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAE5E,qEAAqE;AACrE,sEAAsE;AACtE,sEAAsE;AACtE,oEAAoE;AACpE,wEAAwE;AACxE,uEAAuE;AACvE,oEAAoE;AACpE,wEAAwE;AACxE,qEAAqE;AACrE,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,OAAO;IACP,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,SAAS;IACT,OAAO;IACP,UAAU;IACV,SAAS;IACT,UAAU;IACV,QAAQ;IACR,IAAI;IACJ,OAAO;IACP,MAAM;IACN,SAAS;IACT,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,WAAW;CACH,CAAA;AAIV,yEAAyE;AACzE,0EAA0E;AAC1E,0EAA0E;AAC1E,oCAAoC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,OAAO;IACP,OAAO;IACP,WAAW;IACX,SAAS;IACT,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;CACA,CAAA;AAEV,yEAAyE;AACzE,qCAAqC;AACrC,MAAM,CAAC,MAAM,aAAa,GAA0C;IAClE,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,SAAS;IAClB,iBAAiB,EAAE,SAAS;IAC5B,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;CACrB,CAAA;AAED,wEAAwE;AACxE,uEAAuE;AACvE,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAA;AAElF,wEAAwE;AACxE,mEAAmE;AACnE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAgD;IACpE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAChB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACV,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACd,OAAO,EAAE,CAAC,CAAC,CAAC;CACb,CAAA"}

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

@@ -0,0 +1,96 @@
+import { type RuntimeFiles } from '@struktoai/mirage-core/runtime/files';
+import { FileHandle } from '@struktoai/mirage-core/runtime/handles/file_handle';
+import type { VFSStat } from '@struktoai/mirage-core/runtime/types';
+import type { OpenMode } from '@struktoai/mirage-core/runtime/handles/mode';
+import type { Kept } from '@struktoai/mirage-core/runtime/handles/types';
+import type { NamespaceLinks } from '@struktoai/mirage-core/view/types';
+/** node's `flags` argument as open(2) flags; node's default is `'r'`. */
+export declare function openFlags(flags: unknown): number;
+/** What open(2) flags say about a handle, in the mode vocabulary. Mirrors
+ * python's `host/descriptors.open_mode`. */
+export declare function openMode(flags: number): OpenMode;
+/**
+ * One descriptor `open` handed out for a mounted path. `path` is the path
+ * it names now (a rename through the patch moves it); `handle` is null for
+ * a directory, which a descriptor may name but not read; `kept` is its file
+ * once its name was removed or replaced, which it reads and lands on from
+ * then on; `opened` is the path it was opened at, which its inode number
+ * comes from however the file is renamed since.
+ */
+export interface Descriptor {
+    path: string;
+    readonly mode: OpenMode;
+    handle: FileHandle | null;
+    kept: Kept | null;
+    opened: string;
+    stat: VFSStat | null;
+}
+/** 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 declare function readAt(handle: FileHandle, offset: number, size: number): Promise<Uint8Array>;
+/** Read up to `size` bytes at the position, advancing it. */
+export declare function readOn(handle: FileHandle, size: number): Promise<Uint8Array>;
+/**
+ * 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 declare class Descriptors {
+    private readonly files;
+    private readonly native;
+    private readonly links;
+    private readonly table;
+    private readonly queues;
+    constructor(files: RuntimeFiles, native: Record<string, unknown>, links: NamespaceLinks | null);
+    /** 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: string, follow?: boolean): string;
+    /** The mounted descriptor `fd` is, else undefined. */
+    get(fd: unknown): Descriptor | undefined;
+    /** Run `fn` after every call already queued on `fd`. */
+    serial<T>(fd: number, fn: () => Promise<T>): Promise<T>;
+    /** Open a mounted path by open(2) flags and number the result. */
+    open(path: string, flags: number): Promise<number>;
+    /** A descriptor's ranged read: what it kept once its name went, else
+     * what is at its path now. */
+    private fetch;
+    /** 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. */
+    land(desc: Descriptor): Promise<void>;
+    private invalidatePeers;
+    /** Land the writes of every descriptor open on `path`, which a change of
+     * its times must come after. */
+    landPath(path: string): Promise<void>;
+    /** 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: string, to: string): void;
+    /** 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. */
+    hold(path: string): Promise<[Descriptor, Kept][]>;
+    /** Detach the descriptors `hold` read for, now their name went. */
+    keep(held: [Descriptor, Kept][]): void;
+    /** Land a descriptor's writes and give its number back. */
+    close(fd: number): Promise<void>;
+    /** The handle a read or a write through `fd` uses. */
+    file(fd: number, wantRead: boolean, wantWrite: boolean): FileHandle;
+}
+//# sourceMappingURL=descriptors.d.ts.map

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

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