@struktoai/mirage-node 0.0.5 → 0.0.6

package/dist/core/disk/errors.js

@@ -0,0 +1,31 @@
+// ========= 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. =========
+// Restamp a raw node:fs error against the mount path. The disk backend
+// operates on a resolved host path, so a raw ErrnoException carries that host
+// path in its message and the command boundary would print it. Only the
+// virtual path may ever reach a user-facing message: the host root is an
+// implementation detail of the mount, and leaking it discloses the server's
+// directory layout. The errno code is preserved, so the GNU strerror wording
+// at the command boundary is unchanged. Errors with no errno code (a bug, not
+// a filesystem condition) are returned untouched so they still surface.
+export function diskError(err, spec) {
+    const code = err.code;
+    if (typeof code !== 'string')
+        return err;
+    const out = new Error(spec.virtual);
+    out.code = code;
+    out.virtualPath = spec.virtual;
+    return out;
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/disk/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/disk/errors.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;AAKvE,uEAAuE;AACvE,8EAA8E;AAC9E,wEAAwE;AACxE,yEAAyE;AACzE,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,GAAY,EAAE,IAAc;IACpD,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAA;IAChD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IACxC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAY,CAAA;IAC9C,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACf,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAA;IAC9B,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/core/disk/exists.d.ts

@@ -0,0 +1,4 @@
+import type { DiskAccessor } from '../../accessor/disk.ts';
+import type { PathSpec } from '@struktoai/mirage-core/types';
+export declare function exists(accessor: DiskAccessor, path: PathSpec): Promise<boolean>;
+//# sourceMappingURL=exists.d.ts.map

package/dist/core/disk/exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exists.d.ts","sourceRoot":"","sources":["../../../src/core/disk/exists.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,wBAAsB,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAQrF"}

package/dist/core/disk/exists.js

@@ -0,0 +1,26 @@
+// ========= 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 { access } from 'node:fs/promises';
+import { resolveSafe } from "./utils.js";
+export async function exists(accessor, path) {
+    const full = resolveSafe(accessor.root, path.mountPath);
+    try {
+        await access(full);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=exists.js.map

package/dist/core/disk/exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exists.js","sourceRoot":"","sources":["../../../src/core/disk/exists.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,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAsB,EAAE,IAAc;IACjE,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IACvD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/core/disk/find.d.ts

@@ -0,0 +1,21 @@
+import type { DiskAccessor } from '../../accessor/disk.ts';
+import type { PredNode } from '@struktoai/mirage-core/commands/builtin/find_eval';
+import type { PathSpec } from '@struktoai/mirage-core/types';
+export interface FindOptions {
+    name?: string | null;
+    type?: string | null;
+    minSize?: number | null;
+    maxSize?: number | null;
+    maxDepth?: number | null;
+    minDepth?: number | null;
+    nameExclude?: string | null;
+    orNames?: string[] | null;
+    iname?: string | null;
+    pathPattern?: string | null;
+    empty?: boolean | null;
+    tree?: PredNode | null;
+    mtimeMin?: number | null;
+    mtimeMax?: number | null;
+}
+export declare function find(accessor: DiskAccessor, p: PathSpec, options?: FindOptions): Promise<string[]>;
+//# sourceMappingURL=find.d.ts.map

package/dist/core/disk/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/core/disk/find.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAS1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mDAAmD,CAAA;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACtB,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AA6FD,wBAAsB,IAAI,CACxB,QAAQ,EAAE,YAAY,EACtB,CAAC,EAAE,QAAQ,EACX,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CA8CnB"}

package/dist/core/disk/find.js

@@ -0,0 +1,143 @@
+// ========= 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 { readdir, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { buildTree, emitStartPath, keep, startBasename, } from '@struktoai/mirage-core/commands/builtin/find_eval';
+import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
+import { norm, resolveSafe } from "./utils.js";
+async function walk(ctx, full, current, depth) {
+    const opts = ctx.options;
+    if (opts.maxDepth !== null && opts.maxDepth !== undefined && depth > opts.maxDepth)
+        return;
+    let entries;
+    try {
+        entries = await readdir(full, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const e of entries) {
+        const kind = e.isDirectory() ? 'd' : 'f';
+        const entryPath = current === '/' ? `/${e.name}` : `${current}/${e.name}`;
+        const entryName = e.name;
+        const entrySlashCount = (entryPath.match(/\//g) ?? []).length;
+        const entryDepth = entrySlashCount - ctx.baseDepth;
+        let accept = true;
+        if (opts.maxDepth !== null && opts.maxDepth !== undefined && entryDepth > opts.maxDepth) {
+            accept = false;
+        }
+        let isEmpty = null;
+        if (accept && opts.empty === true) {
+            try {
+                isEmpty =
+                    kind === 'f'
+                        ? (await stat(path.join(full, e.name))).size === 0
+                        : (await readdir(path.join(full, e.name))).length === 0;
+            }
+            catch {
+                isEmpty = null;
+            }
+        }
+        if (accept &&
+            !keep({ key: entryPath, name: entryName, kind, depth: entryDepth, isEmpty }, ctx.tree, opts.minDepth)) {
+            accept = false;
+        }
+        // Directories count as size 0 for -size (deliberate GNU divergence).
+        if (accept && kind !== 'f' && (opts.minSize != null || opts.maxSize != null)) {
+            // Directories contribute size 0 to -size (#318).
+            if (opts.minSize != null && opts.minSize > 0)
+                accept = false;
+            if (opts.maxSize != null && opts.maxSize < 0)
+                accept = false;
+        }
+        if (accept &&
+            kind === 'f' &&
+            (opts.minSize !== null ||
+                opts.maxSize !== null ||
+                opts.mtimeMin !== null ||
+                opts.mtimeMax !== null)) {
+            try {
+                const st = await stat(path.join(full, e.name));
+                if (opts.minSize !== null && opts.minSize !== undefined && st.size < opts.minSize)
+                    accept = false;
+                if (opts.maxSize !== null && opts.maxSize !== undefined && st.size > opts.maxSize)
+                    accept = false;
+                if (accept && (opts.mtimeMin !== undefined || opts.mtimeMax !== undefined)) {
+                    const mtime = st.mtime.getTime() / 1000;
+                    if (opts.mtimeMin !== null && opts.mtimeMin !== undefined && mtime < opts.mtimeMin)
+                        accept = false;
+                    if (opts.mtimeMax !== null && opts.mtimeMax !== undefined && mtime > opts.mtimeMax)
+                        accept = false;
+                }
+            }
+            catch {
+                accept = false;
+            }
+        }
+        if (accept)
+            ctx.results.push(entryPath);
+        if (kind === 'd') {
+            await walk(ctx, path.join(full, e.name), entryPath, depth + 1);
+        }
+    }
+}
+export async function find(accessor, p, options = {}) {
+    const virtual = norm(p.mountPath);
+    const startName = startBasename(p.virtual);
+    const full = resolveSafe(accessor.root, virtual);
+    const baseDepth = virtual === '/' ? 0 : (virtual.match(/\//g) ?? []).length;
+    const results = [];
+    const tree = options.tree ??
+        buildTree({
+            name: options.name,
+            iname: options.iname,
+            pathPattern: options.pathPattern,
+            type: options.type,
+            nameExclude: options.nameExclude,
+            orNames: options.orNames,
+            empty: options.empty,
+        });
+    if (options.maxDepth == null || options.maxDepth >= 0) {
+        let isDir = false;
+        try {
+            isDir = (await stat(full)).isDirectory();
+        }
+        catch {
+            isDir = false;
+        }
+        let rootEmpty = null;
+        if (isDir && options.empty === true) {
+            try {
+                rootEmpty = (await readdir(full)).length === 0;
+            }
+            catch {
+                rootEmpty = null;
+            }
+        }
+        emitStartPath(results, virtual, startName, {
+            kind: 'd',
+            isEmpty: rootEmpty,
+            exists: isDir,
+            tree,
+            maxDepth: options.maxDepth,
+            minDepth: options.minDepth,
+            minSize: options.minSize,
+            maxSize: options.maxSize,
+        });
+    }
+    await walk({ accessor, base: virtual, baseDepth, options, tree, results }, full, virtual, 0);
+    results.sort(compareCodePoints);
+    return results;
+}
+//# sourceMappingURL=find.js.map

package/dist/core/disk/find.js.map

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

package/dist/core/disk/mkdir.d.ts

@@ -0,0 +1,4 @@
+import type { DiskAccessor } from '../../accessor/disk.ts';
+import type { PathSpec } from '@struktoai/mirage-core/types';
+export declare function mkdir(accessor: DiskAccessor, path: PathSpec, parents?: boolean): Promise<void>;
+//# sourceMappingURL=mkdir.d.ts.map

package/dist/core/disk/mkdir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mkdir.d.ts","sourceRoot":"","sources":["../../../src/core/disk/mkdir.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAM5D,wBAAsB,KAAK,CACzB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,QAAQ,EACd,OAAO,UAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/core/disk/mkdir.js

@@ -0,0 +1,51 @@
+// ========= 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 { mkdir as fsMkdir } from 'node:fs/promises';
+import { invalidateAfterWrite, invalidateAncestors } from '@struktoai/mirage-core/cache/context';
+import { norm } from '@struktoai/mirage-core/utils/path';
+import { mkdirComponentError } from "./dest.js";
+import { diskError } from "./errors.js";
+import { resolveSafe } from "./utils.js";
+export async function mkdir(accessor, path, parents = false) {
+    const root = accessor.root;
+    const full = resolveSafe(root, path.mountPath);
+    if (parents) {
+        try {
+            await fsMkdir(full, { recursive: true });
+        }
+        catch (err) {
+            // The kernel names the whole path; GNU names the component it tripped
+            // on, so the chain is walked only now that it is known to be broken.
+            const named = err.code === 'ENOTDIR'
+                ? await mkdirComponentError(root, path, norm(path.mountPath))
+                : null;
+            throw named ?? diskError(err, path);
+        }
+        await invalidateAfterWrite(path);
+        await invalidateAncestors(path);
+        return;
+    }
+    // An existing target is EEXIST, not success: only -p is idempotent (GNU).
+    // Every internal caller that mirrors a tree through this op (cp -r) probes
+    // with isDirectory first, so it never reaches this path for a directory it
+    // meant to reuse.
+    try {
+        await fsMkdir(full);
+    }
+    catch (err) {
+        throw diskError(err, path);
+    }
+    await invalidateAfterWrite(path);
+}
+//# sourceMappingURL=mkdir.js.map

package/dist/core/disk/mkdir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mkdir.js","sourceRoot":"","sources":["../../../src/core/disk/mkdir.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,KAAK,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAA;AAEhG,OAAO,EAAE,IAAI,EAAE,MAAM,mCAAmC,CAAA;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,QAAsB,EACtB,IAAc,EACd,OAAO,GAAG,KAAK;IAEf,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAA;IAC1B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IAC9C,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,sEAAsE;YACtE,qEAAqE;YACrE,MAAM,KAAK,GACR,GAA6B,CAAC,IAAI,KAAK,SAAS;gBAC/C,CAAC,CAAC,MAAM,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC7D,CAAC,CAAC,IAAI,CAAA;YACV,MAAM,KAAK,IAAI,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACrC,CAAC;QACD,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAC/B,OAAM;IACR,CAAC;IACD,0EAA0E;IAC1E,2EAA2E;IAC3E,2EAA2E;IAC3E,kBAAkB;IAClB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;IACD,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;AAClC,CAAC"}

package/dist/core/disk/read.d.ts

@@ -0,0 +1,18 @@
+import type { DiskAccessor } from '../../accessor/disk.ts';
+import type { PathSpec } from '@struktoai/mirage-core/types';
+export declare function read(accessor: DiskAccessor, path: PathSpec): Promise<Uint8Array>;
+/**
+ * Read a byte range, seeking rather than reading the whole file.
+ *
+ * A null size means the rest of the file, which has no length to allocate for
+ * up front, so those reads accumulate fixed chunks until the handle is spent.
+ * A stated size is one positioned read.
+ *
+ * @param accessor the mount's disk handle
+ * @param path the path to read
+ * @param _index listing cache, unused here
+ * @param offset first byte to read
+ * @param size how many bytes, or null for the rest
+ */
+export declare function readRange(accessor: DiskAccessor, path: PathSpec, _index: unknown, offset: number, size: number | null): Promise<Uint8Array>;
+//# sourceMappingURL=read.d.ts.map

package/dist/core/disk/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/disk/read.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAI1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAM5D,wBAAsB,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAetF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,OAAO,CAAC,UAAU,CAAC,CAsCrB"}

package/dist/core/disk/read.js

@@ -0,0 +1,92 @@
+// ========= 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 { open, readFile } from 'node:fs/promises';
+import { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { ResourceName } from '@struktoai/mirage-core/types';
+import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { resolveSafe } from "./utils.js";
+const CHUNK = 1 << 20;
+export async function read(accessor, path) {
+    const timer = startOp();
+    const virtual = path.mountPath;
+    const full = resolveSafe(accessor.root, virtual);
+    let data;
+    try {
+        data = await readFile(full);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw enoent(path);
+        }
+        throw err;
+    }
+    record('read', virtual, ResourceName.DISK, data.byteLength, timer);
+    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+}
+/**
+ * Read a byte range, seeking rather than reading the whole file.
+ *
+ * A null size means the rest of the file, which has no length to allocate for
+ * up front, so those reads accumulate fixed chunks until the handle is spent.
+ * A stated size is one positioned read.
+ *
+ * @param accessor the mount's disk handle
+ * @param path the path to read
+ * @param _index listing cache, unused here
+ * @param offset first byte to read
+ * @param size how many bytes, or null for the rest
+ */
+export async function readRange(accessor, path, _index, offset, size) {
+    const timer = startOp();
+    const virtual = path.mountPath;
+    const full = resolveSafe(accessor.root, virtual);
+    let handle;
+    try {
+        handle = await open(full, 'r');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw enoent(path);
+        }
+        throw err;
+    }
+    try {
+        if (size !== null) {
+            const buf = Buffer.allocUnsafe(size);
+            const { bytesRead } = await handle.read(buf, 0, size, offset);
+            const out = new Uint8Array(buf.buffer, buf.byteOffset, bytesRead);
+            record('read', virtual, ResourceName.DISK, bytesRead, timer);
+            return out;
+        }
+        const parts = [];
+        let total = 0;
+        let at = offset;
+        for (;;) {
+            const buf = Buffer.allocUnsafe(CHUNK);
+            const { bytesRead } = await handle.read(buf, 0, CHUNK, at);
+            if (bytesRead === 0)
+                break;
+            parts.push(buf.subarray(0, bytesRead));
+            total += bytesRead;
+            at += bytesRead;
+        }
+        const joined = Buffer.concat(parts, total);
+        record('read', virtual, ResourceName.DISK, total, timer);
+        return new Uint8Array(joined.buffer, joined.byteOffset, joined.byteLength);
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=read.js.map

package/dist/core/disk/read.js.map

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

package/dist/core/disk/readdir.d.ts

@@ -0,0 +1,5 @@
+import type { DiskAccessor } from '../../accessor/disk.ts';
+import type { IndexCacheStore } from '@struktoai/mirage-core/cache/index/store';
+import type { PathSpec } from '@struktoai/mirage-core/types';
+export declare function readdir(accessor: DiskAccessor, path: PathSpec, index?: IndexCacheStore): Promise<string[]>;
+//# sourceMappingURL=readdir.d.ts.map

package/dist/core/disk/readdir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readdir.d.ts","sourceRoot":"","sources":["../../../src/core/disk/readdir.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAO5D,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,QAAQ,EACd,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAgDnB"}

package/dist/core/disk/readdir.js

@@ -0,0 +1,73 @@
+// ========= 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 { readdir as fsReaddir } from 'node:fs/promises';
+import { IndexEntry, ResourceType } from '@struktoai/mirage-core/cache/index/config';
+import { enoent, enotdir } from '@struktoai/mirage-core/utils/errors';
+import { mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { rstripSlash } from '@struktoai/mirage-core/utils/slash';
+import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
+import { norm, resolveSafe } from "./utils.js";
+export async function readdir(accessor, path, index) {
+    // A pattern spec addresses the directory whose entries the glob filters,
+    // and the rest of this function works in mount-relative space, so the
+    // directory has to be read off `dir` rather than off the virtual
+    // `directory` string (python strips the prefix by hand for the same
+    // reason).
+    const target = path.pattern !== null ? path.dir : path;
+    const virtual = target.mountPath;
+    const mountPrefix = mountPrefixOf(target.virtual, target.resourcePath);
+    // Canonical key: no trailing slash (except root), or the same dir
+    // indexes under two keys and cache hits return doubled-slash entries.
+    const virtualKey = rstripSlash(mountPrefix + virtual) || '/';
+    if (index !== undefined) {
+        const cached = await index.listDir(virtualKey);
+        if (cached.entries !== undefined && cached.entries !== null) {
+            return cached.entries;
+        }
+    }
+    const full = resolveSafe(accessor.root, virtual);
+    let entries;
+    try {
+        entries = await fsReaddir(full);
+    }
+    catch (err) {
+        // The kernel already separates ENOENT (a component does not exist) from
+        // ENOTDIR (a component exists but is not a directory); keep that split
+        // instead of collapsing both into one errno. Restamped onto the PathSpec
+        // so the virtual path, never the real fs path, is reported.
+        const code = err.code;
+        if (code === 'ENOTDIR')
+            throw enotdir(path);
+        if (code === 'ENOENT')
+            throw enoent(path);
+        throw err;
+    }
+    const base = norm(virtual);
+    const dirPrefix = base === '/' ? '/' : `${base}/`;
+    const sorted = [...entries].sort(compareCodePoints);
+    const virtualEntries = sorted.map((e) => `${mountPrefix}${dirPrefix}${e}`);
+    if (index !== undefined) {
+        const indexEntries = sorted.map((name) => [
+            name,
+            new IndexEntry({
+                id: `${dirPrefix}${name}`,
+                name,
+                resourceType: ResourceType.FILE,
+            }),
+        ]);
+        await index.setDir(virtualKey, indexEntries);
+    }
+    return virtualEntries;
+}
+//# sourceMappingURL=readdir.js.map

package/dist/core/disk/readdir.js.map

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

package/dist/core/disk/rename.d.ts

@@ -0,0 +1,4 @@
+import type { DiskAccessor } from '../../accessor/disk.ts';
+import type { PathSpec } from '@struktoai/mirage-core/types';
+export declare function rename(accessor: DiskAccessor, src: PathSpec, dst: PathSpec): Promise<void>;
+//# sourceMappingURL=rename.d.ts.map

package/dist/core/disk/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../src/core/disk/rename.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,wBAAsB,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhG"}

package/dist/core/disk/rename.js

@@ -0,0 +1,36 @@
+// ========= 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 { rename as fsRename } from 'node:fs/promises';
+import { invalidateSubtree } from '@struktoai/mirage-core/cache/context';
+import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { resolveSafe } from "./utils.js";
+export async function rename(accessor, src, dst) {
+    const s = resolveSafe(accessor.root, src.mountPath);
+    const d = resolveSafe(accessor.root, dst.mountPath);
+    try {
+        await fsRename(s, d);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw enoent(src);
+        }
+        throw err;
+    }
+    await invalidateSubtree(src);
+    // Both sides are subtree evictions: a rename destroys the destination's
+    // previous identity and relocates everything under the source, so a
+    // listing or body cached below either name is now stale.
+    await invalidateSubtree(dst);
+}
+//# sourceMappingURL=rename.js.map

package/dist/core/disk/rename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../../src/core/disk/rename.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,MAAM,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAExE,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAsB,EAAE,GAAa,EAAE,GAAa;IAC/E,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACnD,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACnD,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,MAAM,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IACD,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC5B,wEAAwE;IACxE,oEAAoE;IACpE,yDAAyD;IACzD,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC"}

package/dist/core/disk/rm.d.ts

@@ -0,0 +1,4 @@
+import type { DiskAccessor } from '../../accessor/disk.ts';
+import type { PathSpec } from '@struktoai/mirage-core/types';
+export declare function rmR(accessor: DiskAccessor, path: PathSpec): Promise<void>;
+//# sourceMappingURL=rm.d.ts.map

package/dist/core/disk/rm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rm.d.ts","sourceRoot":"","sources":["../../../src/core/disk/rm.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,wBAAsB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/E"}

package/dist/core/disk/rm.js

@@ -0,0 +1,22 @@
+// ========= 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 { rm } from 'node:fs/promises';
+import { invalidateSubtree } from '@struktoai/mirage-core/cache/context';
+import { resolveSafe } from "./utils.js";
+export async function rmR(accessor, path) {
+    const full = resolveSafe(accessor.root, path.mountPath);
+    await rm(full, { recursive: true, force: true });
+    await invalidateSubtree(path);
+}
+//# sourceMappingURL=rm.js.map

package/dist/core/disk/rm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rm.js","sourceRoot":"","sources":["../../../src/core/disk/rm.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,EAAE,EAAE,MAAM,kBAAkB,CAAA;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,QAAsB,EAAE,IAAc;IAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IACvD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAChD,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAA;AAC/B,CAAC"}