@struktoai/mirage-node 0.0.7-alpha.2 → 0.0.7

package/dist/core/gridfs/driver.js

@@ -11,82 +11,15 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { ResourceName } from '@struktoai/mirage-core/types';
+import { concat } from '@struktoai/mirage-core/utils/bytes';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { chunks } from '@struktoai/mirage-core/io/cooperative';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { toIsoZ } from '@struktoai/mirage-core/utils/dates';
 import { bucket, deleteAll, escapeRegex, filesColl, iterLatest, latestFile, prefixQuery, } from "./client.js";
 import { SCOPE_ERROR } from "./constants.js";
 import { isNoFileError } from "./read.js";
-/**
- * Translate a find -name glob into a regex fragment matching one path
- * segment. Returns null for character classes we do not translate (the
- * caller falls back to the unpushed prefix query; client-side keep()
- * still applies the exact semantics).
- */
-export function globRegex(pattern) {
-    if (pattern.includes('[') || pattern.includes(']'))
-        return null;
-    let out = '';
-    for (const ch of pattern) {
-        if (ch === '*')
-            out += '[^/]*';
-        else if (ch === '?')
-            out += '[^/]';
-        else
-            out += escapeRegex(ch);
-    }
-    return out;
-}
-/**
- * Build the fs.files query, pushing -name/-iname/-type/-size server-side
- * when the translation is exact. Every condition is a superset of the GNU
- * semantics (directory markers always pass the size condition, unpushable
- * globs fall back to the prefix scan), so the client-side keep() pass
- * stays authoritative.
- */
-export function buildQuery(pfx, options, pushdown) {
-    const conds = [];
-    const base = prefixQuery(pfx);
-    if (Object.keys(base).length > 0)
-        conds.push(base);
-    if (pushdown) {
-        const escaped = escapeRegex(pfx);
-        const globs = [
-            [options.name, ''],
-            [options.iname, 'i'],
-        ];
-        for (const [pat, flags] of globs) {
-            if (pat === undefined || pat === null)
-                continue;
-            const rx = globRegex(pat);
-            if (rx === null)
-                continue;
-            const regex = { $regex: `^${escaped}(.*/)?${rx}/?$` };
-            if (flags !== '')
-                regex.$options = flags;
-            conds.push({ filename: regex });
-        }
-        if (options.type === 'f') {
-            conds.push({ filename: { $not: { $regex: '/$' } } });
-        }
-        else if (options.type === 'd') {
-            conds.push({ filename: { $regex: '/$' } });
-        }
-        if (options.minSize != null || options.maxSize != null) {
-            const sizeCond = {};
-            if (options.minSize != null)
-                sizeCond.$gte = options.minSize;
-            if (options.maxSize != null)
-                sizeCond.$lte = options.maxSize;
-            // Directory markers ride through; the client-side dirs-count-as-0
-            // rule decides their fate.
-            conds.push({ $or: [{ length: sizeCond }, { filename: { $regex: '/$' } }] });
-        }
-    }
-    if (conds.length === 0)
-        return {};
-    if (conds.length === 1)
-        return conds[0] ?? {};
-    return { $and: conds };
-}
 /** Match the file at `stem` plus everything beneath it. */
 function subtreeQuery(stem) {
     if (stem === '')
@@ -113,7 +46,12 @@ async function* listChildren(conn, pfx) {
         const relative = fname.slice(pfx.length);
         const slash = relative.indexOf('/');
         if (slash === -1) {
-            yield { key: fname, kind: 'f', size: doc.length, modified: doc.uploadDate.toISOString() };
+            yield {
+                key: fname,
+                kind: 'f',
+                size: doc.length,
+                modified: toIsoZ(doc.uploadDate),
+            };
         }
         else {
             // A deeper filename or a "seg/" directory marker both imply an
@@ -122,25 +60,11 @@ async function* listChildren(conn, pfx) {
         }
     }
 }
-async function* listTree(conn, pfx) {
-    for await (const doc of iterLatest(conn, prefixQuery(pfx))) {
-        yield { key: doc.filename, size: doc.length };
-    }
-}
 async function* listSubtree(conn, stem) {
     for await (const doc of iterLatest(conn, subtreeQuery(stem))) {
-        yield { key: doc.filename, size: doc.length };
+        yield { key: doc.filename, size: doc.length, modified: toIsoZ(doc.uploadDate) };
     }
 }
-async function* iterQuery(conn, query) {
-    for await (const doc of iterLatest(conn, query)) {
-        yield { key: doc.filename, size: doc.length };
-    }
-}
-function findTree(conn, pfx, hints) {
-    const query = buildQuery(pfx, hints, hints.pushdown);
-    return [iterQuery(conn, query), JSON.stringify(query) !== JSON.stringify(prefixQuery(pfx))];
-}
 async function head(conn, key) {
     const doc = await latestFile(conn, key);
     if (doc === null)
@@ -148,7 +72,7 @@ async function head(conn, key) {
     const revision = doc._id.toString();
     return {
         size: doc.length,
-        modified: doc.uploadDate.toISOString(),
+        modified: toIsoZ(doc.uploadDate),
         fingerprint: revision,
         revision,
         extra: { file_id: revision },
@@ -161,23 +85,16 @@ async function get(conn, key) {
     const b = await bucket(conn);
     const readable = b.openDownloadStream(doc._id);
     const chunks = [];
-    let total = 0;
     for await (const chunk of readable) {
         chunks.push(chunk);
-        total += chunk.byteLength;
-    }
-    const out = new Uint8Array(total);
-    let offset = 0;
-    for (const c of chunks) {
-        out.set(c, offset);
-        offset += c.byteLength;
     }
-    return out;
+    return concat(chunks);
 }
 async function put(conn, key, data) {
     // Uploads a new revision; older revisions stay in fs.files, so reads
     // pinned to an old revision _id keep working (GridFS-native
-    // versioning).
+    // versioning). The new _id wins both keys of the latest-first sort, so
+    // it is what `head` answers next, spelled the same way.
     const b = await bucket(conn);
     const upload = b.openUploadStream(key);
     await new Promise((resolve, reject) => {
@@ -187,6 +104,32 @@ async function put(conn, key, data) {
         });
         upload.end(data);
     });
+    const revision = upload.id.toString();
+    return { size: data.byteLength, fingerprint: revision, revision };
+}
+async function putStream(conn, key, data) {
+    const upload = (await bucket(conn)).openUploadStream(key);
+    let size = 0;
+    async function* counted() {
+        for await (const part of chunks(data)) {
+            size += part.length;
+            yield part;
+        }
+    }
+    try {
+        await pipeline(Readable.from(counted()), upload);
+    }
+    catch (error) {
+        try {
+            await upload.abort();
+        }
+        catch (cleanup) {
+            console.debug('Could not abort GridFS upload', cleanup);
+        }
+        throw error;
+    }
+    const revision = upload.id.toString();
+    return { size, fingerprint: revision, revision };
 }
 async function deleteFile(conn, key) {
     // Removes every revision of the filename (rm semantics; mirrors S3's
@@ -262,16 +205,16 @@ async function probePrefix(conn, pfx) {
     return doc !== null;
 }
 export const DRIVER = {
-    resource: ResourceName.GRIDFS,
+    vfs: VFSName.GRIDFS,
     scopeError: SCOPE_ERROR,
     keyPrefixOf,
     connect,
     listChildren,
-    listTree,
     listSubtree,
     head,
     get,
     put,
+    putStream,
     deleteFile,
     deletePrefix,
     moveFile,
@@ -279,6 +222,5 @@ export const DRIVER = {
     copyFile,
     probePrefix,
     isNotFound: isNoFileError,
-    findTree,
 };
 //# sourceMappingURL=driver.js.map

package/dist/core/gridfs/driver.js.map

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

package/dist/core/gridfs/events.d.ts

@@ -0,0 +1,33 @@
+import { type FileEvent, type JsonValue, type PathSpec } from '@struktoai/mirage-core/types';
+import type { GridFSAccessor } from '../../accessor/gridfs.ts';
+/**
+ * Map one change stream event on a bucket's files collection onto mount
+ * paths.
+ *
+ * The consumer owns the stream (`watch()` on `<bucket>.files`, ideally with
+ * `fullDocumentBeforeChange` so a delete names its file) and its resume token,
+ * and passes each event's `operationType` with the event. Nothing here runs a
+ * loop.
+ *
+ * GridFS keeps every upload as its own revision and serves the newest, so
+ * after an insert, a delete or a rename the hook counts the revisions left
+ * under each name it touched: none is a DELETE, one just made is a CREATE, and
+ * any other is an UPDATE, since the file now reads another revision. A delete
+ * names its document by id only; the pre-image, or the insert the hook saw,
+ * names the file, and with neither the whole mount is UNKNOWN. A filename
+ * ending in `/` is a directory marker. A dropped or renamed collection, a
+ * dropped database and an invalidated stream leave the mount UNKNOWN.
+ *
+ * Mirrors Python `GridFSEventHook` (`core/gridfs/events.py`).
+ */
+export declare class GridFSEventHook {
+    private readonly accessor;
+    private readonly names;
+    constructor(accessor: GridFSAccessor);
+    /** The mount-relative path of a filename, or null outside the key prefix. */
+    private relative;
+    /** The change `filename` now reads as, from the revisions left. */
+    private settled;
+    toEvents(root: PathSpec, operationType: string, payload: JsonValue): Promise<readonly FileEvent[]>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/core/gridfs/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/core/gridfs/events.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,8BAA8B,CAAA;AAIrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAO9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;gBAEtC,QAAQ,EAAE,cAAc;IAIpC,6EAA6E;IAC7E,OAAO,CAAC,QAAQ;IAMhB,mEAAmE;YACrD,OAAO;IAkBf,QAAQ,CACZ,IAAI,EAAE,QAAQ,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC;CAyCjC"}

package/dist/core/gridfs/events.js

@@ -0,0 +1,117 @@
+// ========= 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 { FileChangeKind, } from '@struktoai/mirage-core/types';
+import { normalize } from '@struktoai/mirage-core/utils/key_prefix';
+import { rstripSlash } from '@struktoai/mirage-core/utils/slash';
+import { eventAt, field, textField } from '@struktoai/mirage-core/events/index';
+import { filesColl } from "./client.js";
+// Events after which the stream no longer describes the files collection
+// document by document.
+const GONE = new Set(['drop', 'dropDatabase', 'rename', 'invalidate']);
+/**
+ * Map one change stream event on a bucket's files collection onto mount
+ * paths.
+ *
+ * The consumer owns the stream (`watch()` on `<bucket>.files`, ideally with
+ * `fullDocumentBeforeChange` so a delete names its file) and its resume token,
+ * and passes each event's `operationType` with the event. Nothing here runs a
+ * loop.
+ *
+ * GridFS keeps every upload as its own revision and serves the newest, so
+ * after an insert, a delete or a rename the hook counts the revisions left
+ * under each name it touched: none is a DELETE, one just made is a CREATE, and
+ * any other is an UPDATE, since the file now reads another revision. A delete
+ * names its document by id only; the pre-image, or the insert the hook saw,
+ * names the file, and with neither the whole mount is UNKNOWN. A filename
+ * ending in `/` is a directory marker. A dropped or renamed collection, a
+ * dropped database and an invalidated stream leave the mount UNKNOWN.
+ *
+ * Mirrors Python `GridFSEventHook` (`core/gridfs/events.py`).
+ */
+export class GridFSEventHook {
+    accessor;
+    names = new Map();
+    constructor(accessor) {
+        this.accessor = accessor;
+    }
+    /** The mount-relative path of a filename, or null outside the key prefix. */
+    relative(filename) {
+        const prefix = normalize(this.accessor.config.keyPrefix);
+        if (prefix !== '' && !filename.startsWith(prefix))
+            return null;
+        return filename.slice(prefix.length);
+    }
+    /** The change `filename` now reads as, from the revisions left. */
+    async settled(root, filename, made) {
+        const relative = this.relative(filename);
+        if (relative === null)
+            return [];
+        if (relative.endsWith('/')) {
+            const kind = made ? FileChangeKind.CREATE : FileChangeKind.UNKNOWN;
+            return [eventAt(root, rstripSlash(relative), kind)];
+        }
+        const files = await filesColl(this.accessor);
+        const left = await files.countDocuments({ filename }, { limit: 2 });
+        const kind = left === 0
+            ? FileChangeKind.DELETE
+            : made && left === 1
+                ? FileChangeKind.CREATE
+                : FileChangeKind.UPDATE;
+        return [eventAt(root, relative, kind)];
+    }
+    async toEvents(root, operationType, payload) {
+        const config = this.accessor.config;
+        const ns = field(payload, 'ns');
+        if (operationType === 'invalidate')
+            return [eventAt(root, '', FileChangeKind.UNKNOWN)];
+        const coll = textField(ns, 'coll');
+        if (textField(ns, 'db') !== config.database ||
+            (coll !== null && coll !== `${config.bucket ?? 'fs'}.files`)) {
+            return [];
+        }
+        if (GONE.has(operationType))
+            return [eventAt(root, '', FileChangeKind.UNKNOWN)];
+        const ident = JSON.stringify(field(field(payload, 'documentKey'), '_id'));
+        const before = textField(field(payload, 'fullDocumentBeforeChange'), 'filename') ??
+            this.names.get(ident) ??
+            null;
+        const after = textField(field(payload, 'fullDocument'), 'filename') ??
+            textField(field(field(payload, 'updateDescription'), 'updatedFields'), 'filename');
+        if (operationType === 'insert' && after !== null) {
+            this.names.set(ident, after);
+            return this.settled(root, after, true);
+        }
+        if (operationType === 'delete') {
+            this.names.delete(ident);
+            if (before === null)
+                return [eventAt(root, '', FileChangeKind.UNKNOWN)];
+            return this.settled(root, before, false);
+        }
+        if (operationType !== 'update' && operationType !== 'replace')
+            return [];
+        if (before === null) {
+            if (after !== null)
+                this.names.set(ident, after);
+            return [eventAt(root, '', FileChangeKind.UNKNOWN)];
+        }
+        if (after === null || after === before)
+            return this.settled(root, before, false);
+        this.names.set(ident, after);
+        return [
+            ...(await this.settled(root, before, false)),
+            ...(await this.settled(root, after, true)),
+        ];
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/core/gridfs/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/core/gridfs/events.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,EACL,cAAc,GAIf,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AAE/E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,yEAAyE;AACzE,wBAAwB;AACxB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAA;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,eAAe;IACT,QAAQ,CAAgB;IACxB,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IAElD,YAAY,QAAwB;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAED,6EAA6E;IACrE,QAAQ,CAAC,QAAgB;QAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACxD,IAAI,MAAM,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAA;QAC9D,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC;IAED,mEAAmE;IAC3D,KAAK,CAAC,OAAO,CAAC,IAAc,EAAE,QAAgB,EAAE,IAAa;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACxC,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,EAAE,CAAA;QAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAA;YAClE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;QACrD,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC5C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QACnE,MAAM,IAAI,GACR,IAAI,KAAK,CAAC;YACR,CAAC,CAAC,cAAc,CAAC,MAAM;YACvB,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK,CAAC;gBAClB,CAAC,CAAC,cAAc,CAAC,MAAM;gBACvB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAA;QAC7B,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAc,EACd,aAAqB,EACrB,OAAkB;QAElB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAA;QACnC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAC/B,IAAI,aAAa,KAAK,YAAY;YAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;QACtF,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;QAClC,IACE,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,MAAM,CAAC,QAAQ;YACvC,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,QAAQ,CAAC,EAC5D,CAAC;YACD,OAAO,EAAE,CAAA;QACX,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC;YAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;QACzE,MAAM,MAAM,GACV,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,0BAA0B,CAAC,EAAE,UAAU,CAAC;YACjE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;YACrB,IAAI,CAAA;QACN,MAAM,KAAK,GACT,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,UAAU,CAAC;YACrD,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,EAAE,eAAe,CAAC,EAAE,UAAU,CAAC,CAAA;QACpF,IAAI,aAAa,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;YAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;QACxC,CAAC;QACD,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACxB,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;YACvE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;QAC1C,CAAC;QACD,IAAI,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;QACxE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,KAAK,KAAK,IAAI;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;YAChD,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;QACpD,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;QAChF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QAC5B,OAAO;YACL,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC5C,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;SAC3C,CAAA;IACH,CAAC;CACF"}

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

@@ -1,5 +1,4 @@
 import type { ObjectId } from 'mongodb';
-import type { IndexCacheStore } from '@struktoai/mirage-core/cache/index/store';
 import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { GridFSAccessor } from '../../accessor/gridfs.ts';
 export interface GridFSReadOptions {
@@ -8,5 +7,5 @@ export interface GridFSReadOptions {
 }
 export declare function resolveFileId(accessor: GridFSAccessor, path: PathSpec, key: string): Promise<ObjectId>;
 export declare function isNoFileError(err: unknown): boolean;
-export declare function read(accessor: GridFSAccessor, path: PathSpec, _index?: IndexCacheStore, options?: GridFSReadOptions): Promise<Uint8Array>;
+export declare function read(accessor: GridFSAccessor, path: PathSpec, options?: GridFSReadOptions): Promise<Uint8Array>;
 //# sourceMappingURL=read.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/gridfs/read.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAG/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAG9D,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,QAAQ,CAAC,CAUnB;AA0DD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAInD;AAED,wBAAsB,IAAI,CACxB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAarB"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/gridfs/read.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAGvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAI9D,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,QAAQ,CAAC,CAUnB;AAkDD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAInD;AAED,wBAAsB,IAAI,CACxB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAarB"}

package/dist/core/gridfs/read.js

@@ -11,10 +11,12 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { concat } from '@struktoai/mirage-core/utils/bytes';
 import { record, revisionFor, startOp } from '@struktoai/mirage-core/observe/context';
-import { ResourceName } from '@struktoai/mirage-core/types';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
-import { bucket, fileById, gridfsKey, latestFile, loadGridFSModule, rawPathOf } from "./client.js";
+import { VFSName } from '@struktoai/mirage-core/types';
+import { enoent } from '@struktoai/mirage-core/errors/fs';
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { bucket, fileById, gridfsKey, latestFile, loadGridFSModule } from "./client.js";
 export async function resolveFileId(accessor, path, key) {
     const pinnedRevision = revisionFor(path.virtual);
     if (pinnedRevision !== null) {
@@ -55,11 +57,9 @@ async function downloadBytes(accessor, path, fileId, options = {}) {
     }
     const readable = b.openDownloadStream(fileId, streamOptions);
     const chunks = [];
-    let total = 0;
     try {
         for await (const chunk of readable) {
             chunks.push(chunk);
-            total += chunk.byteLength;
         }
     }
     catch (err) {
@@ -68,13 +68,7 @@ async function downloadBytes(accessor, path, fileId, options = {}) {
         }
         throw err;
     }
-    const out = new Uint8Array(total);
-    let offset = 0;
-    for (const c of chunks) {
-        out.set(c, offset);
-        offset += c.byteLength;
-    }
-    return out;
+    return concat(chunks);
 }
 export function isNoFileError(err) {
     if (err === null || typeof err !== 'object')
@@ -82,7 +76,7 @@ export function isNoFileError(err) {
     const message = err.message ?? '';
     return message.includes('FileNotFound');
 }
-export async function read(accessor, path, _index, options = {}) {
+export async function read(accessor, path, options = {}) {
     const virtual = path.virtual;
     const raw = rawPathOf(path);
     const key = gridfsKey(raw, accessor.config);
@@ -90,7 +84,7 @@ export async function read(accessor, path, _index, options = {}) {
     const fileId = await resolveFileId(accessor, path, key);
     const bytes = await downloadBytes(accessor, path, fileId, options);
     const revision = fileId.toString();
-    record('read', virtual, ResourceName.GRIDFS, bytes.byteLength, timer, {
+    record('read', virtual, VFSName.GRIDFS, bytes.byteLength, timer, {
         fingerprint: revision,
         revision,
     });

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

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

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

@@ -1,2 +1,3 @@
 export declare const readdir: import("@struktoai/mirage-core/core/object_store/driver").ReaddirFn<import("../../index.ts").GridFSAccessor>;
+export declare const tree: import("@struktoai/mirage-core/core/object_store/driver").TreeFn<import("../../index.ts").GridFSAccessor>;
 //# sourceMappingURL=readdir.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"readdir.d.ts","sourceRoot":"","sources":["../../../src/core/gridfs/readdir.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,OAAO,8GAAsB,CAAA"}
+{"version":3,"file":"readdir.d.ts","sourceRoot":"","sources":["../../../src/core/gridfs/readdir.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,OAAO,8GAAsB,CAAA;AAC1C,eAAO,MAAM,IAAI,2GAAmB,CAAA"}

package/dist/core/gridfs/readdir.js

@@ -11,7 +11,8 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { makeReaddir } from '@struktoai/mirage-core/core/object_store/readdir';
+import { makeReaddir, makeTree } from '@struktoai/mirage-core/core/object_store/readdir';
 import { DRIVER } from "./driver.js";
 export const readdir = makeReaddir(DRIVER);
+export const tree = makeTree(DRIVER);
 //# sourceMappingURL=readdir.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"readdir.js","sourceRoot":"","sources":["../../../src/core/gridfs/readdir.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,WAAW,EAAE,MAAM,kDAAkD,CAAA;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA"}
+{"version":3,"file":"readdir.js","sourceRoot":"","sources":["../../../src/core/gridfs/readdir.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,WAAW,EAAE,QAAQ,EAAE,MAAM,kDAAkD,CAAA;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;AAC1C,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA"}

package/dist/core/gridfs/stream.d.ts

@@ -1,17 +1,4 @@
 import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { GridFSAccessor } from '../../accessor/gridfs.ts';
-export declare function stream(accessor: GridFSAccessor, path: PathSpec): AsyncIterable<Uint8Array>;
-/**
- * The resource-level `range_read(path, start, end)`, end exclusive.
- *
- * Every other backend's `rangeRead` and all of python's spell the window this
- * way; gridfs read its fourth argument as a length, so `range_read(p, 10, 20)`
- * returned twenty bytes from offset ten where python returned ten.
- *
- * @param accessor the GridFS accessor
- * @param path the file path
- * @param start first byte to read
- * @param end one past the last byte to read
- */
-export declare function rangeRead(accessor: GridFSAccessor, path: PathSpec, start: number, end: number): Promise<Uint8Array>;
+export declare function readStream(accessor: GridFSAccessor, path: PathSpec, onVersion?: (version: string | null) => void): AsyncIterable<Uint8Array>;
 //# sourceMappingURL=stream.d.ts.map

package/dist/core/gridfs/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/gridfs/stream.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAM9D,wBAAuB,MAAM,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAmCjG;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,CAAC,CAErB"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/gridfs/stream.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAO9D,wBAAuB,UAAU,CAC/B,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAC3C,aAAa,CAAC,UAAU,CAAC,CAoC3B"}

package/dist/core/gridfs/stream.js

@@ -12,17 +12,19 @@
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
 import { recordStream } from '@struktoai/mirage-core/observe/context';
-import { ResourceName } from '@struktoai/mirage-core/types';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
-import { bucket, gridfsKey, rawPathOf } from "./client.js";
-import { isNoFileError, read, resolveFileId } from "./read.js";
+import { VFSName } from '@struktoai/mirage-core/types';
+import { enoent } from '@struktoai/mirage-core/errors/fs';
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { bucket, gridfsKey } from "./client.js";
+import { isNoFileError, resolveFileId } from "./read.js";
 const DEFAULT_CHUNK_SIZE = 8192;
-export async function* stream(accessor, path) {
+export async function* readStream(accessor, path, onVersion) {
     const virtual = path.virtual;
     const raw = rawPathOf(path);
     const key = gridfsKey(raw, accessor.config);
-    const rec = recordStream('read', virtual, ResourceName.GRIDFS);
     const fileId = await resolveFileId(accessor, path, key);
+    onVersion?.(fileId.toString());
+    const rec = recordStream('read', virtual, VFSName.GRIDFS);
     if (rec !== null) {
         const revision = fileId.toString();
         rec.fingerprint = revision;
@@ -57,19 +59,4 @@ export async function* stream(accessor, path) {
         yield pending;
     }
 }
-/**
- * The resource-level `range_read(path, start, end)`, end exclusive.
- *
- * Every other backend's `rangeRead` and all of python's spell the window this
- * way; gridfs read its fourth argument as a length, so `range_read(p, 10, 20)`
- * returned twenty bytes from offset ten where python returned ten.
- *
- * @param accessor the GridFS accessor
- * @param path the file path
- * @param start first byte to read
- * @param end one past the last byte to read
- */
-export async function rangeRead(accessor, path, start, end) {
-    return read(accessor, path, undefined, { offset: start, size: end - start });
-}
 //# sourceMappingURL=stream.js.map