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

package/dist/accessor/disk.js

@@ -14,9 +14,13 @@
 import { Accessor } from '@struktoai/mirage-core/accessor/index';
 export class DiskAccessor extends Accessor {
     root;
-    constructor(root) {
+    // Whether a listing is stored with its folder's version
+    // (core/disk/listing_version.ts).
+    folderVersions;
+    constructor(root, folderVersions = true) {
         super();
         this.root = root;
+        this.folderVersions = folderVersions;
     }
 }
 //# sourceMappingURL=disk.js.map

package/dist/accessor/disk.js.map

@@ -1 +1 @@
-{"version":3,"file":"disk.js","sourceRoot":"","sources":["../../src/accessor/disk.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,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAEhE,MAAM,OAAO,YAAa,SAAQ,QAAQ;IAC/B,IAAI,CAAQ;IAErB,YAAY,IAAY;QACtB,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}
+{"version":3,"file":"disk.js","sourceRoot":"","sources":["../../src/accessor/disk.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,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAEhE,MAAM,OAAO,YAAa,SAAQ,QAAQ;IAC/B,IAAI,CAAQ;IACrB,wDAAwD;IACxD,kCAAkC;IACzB,cAAc,CAAS;IAEhC,YAAY,IAAY,EAAE,cAAc,GAAG,IAAI;QAC7C,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAA;IACtC,CAAC;CACF"}

package/dist/accessor/email.d.ts

@@ -5,6 +5,14 @@ export declare class EmailAccessor extends Accessor {
     readonly config: EmailConfig;
     private clientPromise;
     constructor(config: EmailConfig);
+    /**
+     * The connected IMAP client, connecting on first use and again after the
+     * last one failed. imapflow emits `error` when its socket times out, resets
+     * or fails outside a command, and Node throws an `error` event nobody
+     * listens for, which would end the process and every mount in it; the
+     * listener keeps the failure on this client and drops it, as `close` does,
+     * so the next access connects afresh instead of reusing a dead socket.
+     */
     getImap(): Promise<ImapFlow>;
     close(): Promise<void>;
 }

package/dist/accessor/email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/accessor/email.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAEhE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,OAAO,CAAC,aAAa,CAAiC;gBAE1C,MAAM,EAAE,WAAW;IAKzB,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;IA2B5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/accessor/email.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAEhE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,OAAO,CAAC,aAAa,CAAiC;gBAE1C,MAAM,EAAE,WAAW;IAK/B;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;IAoCnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAUtC"}

package/dist/accessor/email.js

@@ -20,24 +20,43 @@ export class EmailAccessor extends Accessor {
         super();
         this.config = config;
     }
+    /**
+     * The connected IMAP client, connecting on first use and again after the
+     * last one failed. imapflow emits `error` when its socket times out, resets
+     * or fails outside a command, and Node throws an `error` event nobody
+     * listens for, which would end the process and every mount in it; the
+     * listener keeps the failure on this client and drops it, as `close` does,
+     * so the next access connects afresh instead of reusing a dead socket.
+     */
     async getImap() {
-        this.clientPromise ??= (async () => {
-            const mod = await loadOptionalPeer(() => import('imapflow'), { feature: 'EmailAccessor', packageName: 'imapflow' });
-            const client = new mod.ImapFlow({
-                host: this.config.imapHost,
-                port: this.config.imapPort,
-                secure: this.config.useSsl,
-                auth: { user: this.config.username, pass: this.config.password },
-                logger: false,
-            });
-            await client.connect();
-            return client;
-        })();
+        if (this.clientPromise === null) {
+            const pending = (async () => {
+                const mod = await loadOptionalPeer(() => import('imapflow'), { feature: 'EmailAccessor', packageName: 'imapflow' });
+                const client = new mod.ImapFlow({
+                    host: this.config.imapHost,
+                    port: this.config.imapPort,
+                    secure: this.config.useSsl,
+                    auth: { user: this.config.username, pass: this.config.password },
+                    logger: false,
+                });
+                const drop = () => {
+                    if (this.clientPromise === pending)
+                        this.clientPromise = null;
+                };
+                client.on('error', drop);
+                client.on('close', drop);
+                await client.connect();
+                return client;
+            })();
+            this.clientPromise = pending;
+        }
+        const current = this.clientPromise;
         try {
-            return await this.clientPromise;
+            return await current;
         }
         catch (err) {
-            this.clientPromise = null;
+            if (this.clientPromise === current)
+                this.clientPromise = null;
             throw err;
         }
     }

package/dist/accessor/email.js.map

@@ -1 +1 @@
-{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/accessor/email.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,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAA;AAI7E,MAAM,OAAO,aAAc,SAAQ,QAAQ;IAChC,MAAM,CAAa;IACpB,aAAa,GAA6B,IAAI,CAAA;IAEtD,YAAY,MAAmB;QAC7B,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,aAAa,KAAK,CAAC,KAAK,IAAI,EAAE;YACjC,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAChC,GAAG,EAAE,CACH,MAAM,CAAC,UAAU,CAEf,EACJ,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,CACtD,CAAA;YACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC;gBAC9B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC1B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;gBAChE,MAAM,EAAE,KAAK;aACd,CAAC,CAAA;YACF,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;YACtB,OAAO,MAAM,CAAA;QACf,CAAC,CAAC,EAAE,CAAA;QACJ,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,aAAa,CAAA;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;YACzB,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI;YAAE,OAAM;QACvC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,aAAa,CAAA;YAClC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAA;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;IAC3B,CAAC;CACF"}
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/accessor/email.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,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAA;AAI7E,MAAM,OAAO,aAAc,SAAQ,QAAQ;IAChC,MAAM,CAAa;IACpB,aAAa,GAA6B,IAAI,CAAA;IAEtD,YAAY,MAAmB;QAC7B,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,OAAO,GAAsB,CAAC,KAAK,IAAI,EAAE;gBAC7C,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAChC,GAAG,EAAE,CACH,MAAM,CAAC,UAAU,CAEf,EACJ,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,CACtD,CAAA;gBACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC;oBAC9B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;oBAC1B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;oBAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;oBAChE,MAAM,EAAE,KAAK;iBACd,CAAC,CAAA;gBACF,MAAM,IAAI,GAAG,GAAS,EAAE;oBACtB,IAAI,IAAI,CAAC,aAAa,KAAK,OAAO;wBAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;gBAC/D,CAAC,CAAA;gBACD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;gBACxB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;gBACxB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;gBACtB,OAAO,MAAM,CAAA;YACf,CAAC,CAAC,EAAE,CAAA;YACJ,IAAI,CAAC,aAAa,GAAG,OAAO,CAAA;QAC9B,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAA;QAClC,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAA;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,aAAa,KAAK,OAAO;gBAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;YAC7D,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAEQ,KAAK,CAAC,KAAK;QAClB,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI;YAAE,OAAM;QACvC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,aAAa,CAAA;YAClC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAA;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;IAC3B,CAAC;CACF"}

package/dist/accessor/gridfs.d.ts

@@ -1,6 +1,6 @@
 import type { Db, MongoClient } from 'mongodb';
 import { Accessor } from '@struktoai/mirage-core/accessor/index';
-import type { GridFSConfig } from '../resource/gridfs/config.ts';
+import type { GridFSConfig } from '../vfs/gridfs/config.ts';
 export declare class GridFSAccessor extends Accessor {
     readonly config: GridFSConfig;
     private clientPromise;

package/dist/accessor/gridfs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gridfs.d.ts","sourceRoot":"","sources":["../../src/accessor/gridfs.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAMhE,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,OAAO,CAAC,aAAa,CAAoC;gBAE7C,MAAM,EAAE,YAAY;IAK1B,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAK9B,EAAE,IAAI,OAAO,CAAC,EAAE,CAAC;YAKT,QAAQ;IAUhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}
+{"version":3,"file":"gridfs.d.ts","sourceRoot":"","sources":["../../src/accessor/gridfs.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAM3D,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,OAAO,CAAC,aAAa,CAAoC;gBAE7C,MAAM,EAAE,YAAY;IAK1B,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAK9B,EAAE,IAAI,OAAO,CAAC,EAAE,CAAC;YAKT,QAAQ;IAUP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAMtC"}

package/dist/accessor/gridfs.js

@@ -12,7 +12,7 @@
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
 import { Accessor } from '@struktoai/mirage-core/accessor/index';
-import { loadOptionalPeer } from "../optional_peer.js";
+import { loadOptionalPeer } from '@struktoai/mirage-core/utils/optional_peer';
 export class GridFSAccessor extends Accessor {
     config;
     clientPromise = null;
@@ -30,7 +30,7 @@ export class GridFSAccessor extends Accessor {
     }
     async _connect() {
         const mod = await loadOptionalPeer(() => import('mongodb'), {
-            feature: 'GridFSResource',
+            feature: 'GridFSVFS',
             packageName: 'mongodb',
         });
         const client = new mod.MongoClient(this.config.uri);

package/dist/accessor/gridfs.js.map

@@ -1 +1 @@
-{"version":3,"file":"gridfs.js","sourceRoot":"","sources":["../../src/accessor/gridfs.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,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAOtD,MAAM,OAAO,cAAe,SAAQ,QAAQ;IACjC,MAAM,CAAc;IACrB,aAAa,GAAgC,IAAI,CAAA;IAEzD,YAAY,MAAoB;QAC9B,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAA;QACtC,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,EAAE;QACN,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QAClC,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACxC,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAoC,EAAE;YAC7F,OAAO,EAAE,gBAAgB;YACzB,WAAW,EAAE,SAAS;SACvB,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACnD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;QACtB,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI;YAAE,OAAM;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAA;QACvC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QACzB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;CACF"}
+{"version":3,"file":"gridfs.js","sourceRoot":"","sources":["../../src/accessor/gridfs.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,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAA;AAO7E,MAAM,OAAO,cAAe,SAAQ,QAAQ;IACjC,MAAM,CAAc;IACrB,aAAa,GAAgC,IAAI,CAAA;IAEzD,YAAY,MAAoB;QAC9B,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAA;QACtC,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,EAAE;QACN,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QAClC,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACxC,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAoC,EAAE;YAC7F,OAAO,EAAE,WAAW;YACpB,WAAW,EAAE,SAAS;SACvB,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACnD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;QACtB,OAAO,MAAM,CAAA;IACf,CAAC;IAEQ,KAAK,CAAC,KAAK;QAClB,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI;YAAE,OAAM;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAA;QACvC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QACzB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;CACF"}

package/dist/accessor/hf_buckets.d.ts

@@ -0,0 +1,39 @@
+import type { Operator } from 'opendal';
+import { Accessor } from '@struktoai/mirage-core/accessor/index';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { type HfBucketsConfig } from '../vfs/hf_buckets/config.ts';
+import { type HfAccountAccessor } from './hf_hub.ts';
+/**
+ * A mount onto one Hugging Face bucket.
+ *
+ * Listing and writes go through the opendal operator; stat's point lookup and
+ * every read go to the Hub through the account the mount builds, because the
+ * bucket's content token (its xet hash) comes from paths-info and the resolve
+ * download, neither of which the binding exposes.
+ */
+export declare class HfBucketsAccessor extends Accessor {
+    readonly config: HfBucketsConfig;
+    readonly repoType: string;
+    readonly vfsName: VFSName;
+    private operatorPromise;
+    readonly account: HfAccountAccessor;
+    constructor(config: HfBucketsConfig);
+    get repoId(): string;
+    get bucketUri(): string;
+    get endpoint(): string;
+    get keyPrefix(): string;
+    /**
+     * Lift a mount-relative path to its bucket-relative spelling.
+     *
+     * opendal applies the key prefix as its operator root; a Hub call made
+     * directly has to apply it here instead. Empty segments are dropped:
+     * opendal normalizes its root the same way, and the Hub matches paths
+     * exactly, so `a//b/x` would name a file the listing shows as `a/b/x` and
+     * answer it absent.
+     */
+    bucketPath(rel: string): string;
+    operatorOptions(): Record<string, string>;
+    operator(): Promise<Operator>;
+    private createOperator;
+}
+//# sourceMappingURL=hf_buckets.d.ts.map

package/dist/accessor/hf_buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf_buckets.d.ts","sourceRoot":"","sources":["../../src/accessor/hf_buckets.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAItD,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC/E,OAAO,EAAa,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/D;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;aAOjB,MAAM,EAAE,eAAe;IANnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAW;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAqB;IAC9C,OAAO,CAAC,eAAe,CAAiC;IAExD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;gBAEP,MAAM,EAAE,eAAe;IAKnD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAO/B,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAgBzC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;YAKf,cAAc;CAO7B"}

package/dist/accessor/hf_buckets.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 { Accessor } from '@struktoai/mirage-core/accessor/index';
+import { VFSName } from '@struktoai/mirage-core/types';
+import * as kp from '@struktoai/mirage-core/utils/key_prefix';
+import { stripSlash } from '@struktoai/mirage-core/utils/slash';
+import { loadOptionalPeer } from '@struktoai/mirage-core/utils/optional_peer';
+import { HF_ENDPOINT } from "../vfs/hf_buckets/config.js";
+import { accountOf } from "./hf_hub.js";
+/**
+ * A mount onto one Hugging Face bucket.
+ *
+ * Listing and writes go through the opendal operator; stat's point lookup and
+ * every read go to the Hub through the account the mount builds, because the
+ * bucket's content token (its xet hash) comes from paths-info and the resolve
+ * download, neither of which the binding exposes.
+ */
+export class HfBucketsAccessor extends Accessor {
+    config;
+    repoType = 'bucket';
+    vfsName = VFSName.HF_BUCKETS;
+    operatorPromise = null;
+    account;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.account = accountOf(config);
+    }
+    get repoId() {
+        return this.config.bucket;
+    }
+    get bucketUri() {
+        return `hf://buckets/${this.repoId}`;
+    }
+    get endpoint() {
+        return this.config.endpoint ?? HF_ENDPOINT;
+    }
+    get keyPrefix() {
+        return kp.normalize(this.config.keyPrefix);
+    }
+    /**
+     * Lift a mount-relative path to its bucket-relative spelling.
+     *
+     * opendal applies the key prefix as its operator root; a Hub call made
+     * directly has to apply it here instead. Empty segments are dropped:
+     * opendal normalizes its root the same way, and the Hub matches paths
+     * exactly, so `a//b/x` would name a file the listing shows as `a/b/x` and
+     * answer it absent.
+     */
+    bucketPath(rel) {
+        return `${this.keyPrefix}/${rel}`
+            .split('/')
+            .filter((part) => part !== '')
+            .join('/');
+    }
+    operatorOptions() {
+        const options = {
+            repo_type: this.repoType,
+            repo_id: this.repoId,
+        };
+        if (this.config.token !== undefined && this.config.token !== '') {
+            options.token = this.config.token;
+        }
+        if (this.config.endpoint !== undefined && this.config.endpoint !== '') {
+            options.endpoint = this.config.endpoint;
+        }
+        const keyPrefix = this.keyPrefix;
+        if (keyPrefix !== '')
+            options.root = `/${stripSlash(keyPrefix)}/`;
+        return options;
+    }
+    operator() {
+        this.operatorPromise ??= this.createOperator();
+        return this.operatorPromise;
+    }
+    async createOperator() {
+        const mod = await loadOptionalPeer(() => import('opendal'), { feature: 'HuggingFace VFS', packageName: 'opendal' });
+        return new mod.Operator('hf', this.operatorOptions());
+    }
+}
+//# sourceMappingURL=hf_buckets.js.map

package/dist/accessor/hf_buckets.js.map

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

package/dist/accessor/hf_hub.d.ts

@@ -1,51 +1,44 @@
 import { Accessor } from '@struktoai/mirage-core/accessor/index';
-import type { IndexEntry } from '@struktoai/mirage-core/cache/index/config';
-import { ResourceName } from '@struktoai/mirage-core/types';
-import { type HfRepoConfig } from '../resource/hf_buckets/config.ts';
-import type { TreeEntry } from '../core/hf_hub/tree_entry.ts';
-export interface RowTables {
-    entries: Map<string, IndexEntry>;
-    children: Map<string, string[]>;
+import { VFSName } from '@struktoai/mirage-core/types';
+import { type HfBucketsConfig, type HfRepoConfig } from '../vfs/hf_buckets/config.ts';
+import { type HfConfig } from '../core/hf_hub/config.ts';
+/**
+ * One Hub account: credential, origin and the bound its requests run under.
+ * The `hf` CLI's install accessor and the account a repository handle
+ * borrows; a mount builds its own with `accountOf`.
+ */
+export declare class HfAccountAccessor extends Accessor {
+    readonly config: HfConfig;
+    /** How long one Hub request may go without progress. */
+    readonly timeoutMs: number;
+    constructor(config: HfConfig, 
+    /** How long one Hub request may go without progress. */
+    timeoutMs?: number);
+    get token(): string | undefined;
+    get endpoint(): string;
 }
+/** The account a repository or bucket mount builds and owns. */
+export declare function accountOf(config: HfRepoConfig | HfBucketsConfig): HfAccountAccessor;
 /**
- * A mount onto one Hugging Face Hub repository.
+ * One Hugging Face Hub repository, over an account it borrows.
  *
- * Holds the whole repository tree: the Hub's listing endpoint is recursive,
- * so one paged walk is the mount's entire listing and every read after it is
- * a lookup. find and du read that tree directly; everything else goes through
- * the index it seeds.
+ * The Hub's listing endpoint is recursive, so one paged walk is the mount's
+ * entire listing, which the mount keeps; every stat and read after it is
+ * handed its row.
  *
  * Constructed without touching the network. A constructor cannot await, so
  * fetching here would mean a blocking client stalling whatever loop the
- * caller is on; the tree hydrates on first use instead.
+ * caller is on.
  */
 export declare class HfHubAccessor extends Accessor {
+    readonly account: HfAccountAccessor;
     readonly config: HfRepoConfig;
     private readonly kind;
-    readonly resourceName: ResourceName;
-    /** The recursive tree, keyed mount-relative with no leading slash and with
-     * keyPrefix already stripped. Reseated by every refill. */
-    tree: Map<string, TreeEntry>;
-    /** Whether that tree is an answer or just the empty default, which is a
-     * different question from whether it holds anything: an empty repository
-     * hydrates to an empty map, and reading that as "not hydrated" refetches it
-     * forever. */
-    treeLoaded: boolean;
-    /** The index tables derived from that tree, for a mount with no index
-     * wired. Derivation is O(tree), so a readdir loop over a large repo would
-     * be quadratic without a memo; every reseat of `tree` clears it. */
-    rowsCache: {
-        prefix: string;
-        rows: RowTables;
-    } | null;
-    /** Guards the lazy hydration so concurrent first reads make one request
-     * rather than one per caller. */
-    hydrating: Promise<void> | null;
-    constructor(config: HfRepoConfig, kind?: string, resourceName?: ResourceName);
+    readonly vfsName: VFSName;
+    constructor(account: HfAccountAccessor, config: HfRepoConfig, kind?: string, vfsName?: VFSName);
     get repoType(): string;
     get repoId(): string;
     get endpoint(): string;
-    get token(): string | undefined;
     /**
      * The revision this mount reads.
      *
@@ -68,13 +61,25 @@ export declare class HfHubAccessor extends Accessor {
      */
     repoPath(rel: string): string;
 }
-export declare class HfModelsHubAccessor extends HfHubAccessor {
-    constructor(config: HfRepoConfig);
+/**
+ * A Hub handle for one repository, over an account it borrows.
+ *
+ * The `hf` CLI builds one per invocation over the install's account rather
+ * than owning a second Hub client: the handle only names which repository is
+ * being addressed and rides the account's credential, origin and request
+ * bound, so `hf` gets the mount's tree walk and commit builder for free. It
+ * reaches no mount, which is what keeps `hf` an account CLI. A verb reads paths and
+ * sizes, never the per-file commit a mount's mtimes come from, so the walk
+ * lists bare.
+ */
+export declare function hubFor(account: HfAccountAccessor, repoId: string, repoType: string, revision?: string): HfHubAccessor;
+export declare class HfModelsAccessor extends HfHubAccessor {
+    constructor(account: HfAccountAccessor, config: HfRepoConfig);
 }
-export declare class HfDatasetsHubAccessor extends HfHubAccessor {
-    constructor(config: HfRepoConfig);
+export declare class HfDatasetsAccessor extends HfHubAccessor {
+    constructor(account: HfAccountAccessor, config: HfRepoConfig);
 }
-export declare class HfSpacesHubAccessor extends HfHubAccessor {
-    constructor(config: HfRepoConfig);
+export declare class HfSpacesAccessor extends HfHubAccessor {
+    constructor(account: HfAccountAccessor, config: HfRepoConfig);
 }
 //# sourceMappingURL=hf_hub.d.ts.map

package/dist/accessor/hf_hub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hf_hub.d.ts","sourceRoot":"","sources":["../../src/accessor/hf_hub.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAA;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAEjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE7D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAChC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IAkBvC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,QAAQ,CAAC,YAAY,EAAE,YAAY;IAnBrC;+DAC2D;IAC3D,IAAI,yBAA+B;IACnC;;;kBAGc;IACd,UAAU,UAAQ;IAClB;;wEAEoE;IACpE,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAO;IAC5D;qCACiC;IACjC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAO;gBAG3B,MAAM,EAAE,YAAY,EACZ,IAAI,SAAU,EACtB,YAAY,GAAE,YAAqC;IAK9D,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED;;;;;;;OAOG;IACH,IAAI,QAAQ,IAAI,MAAM,CAGrB;IAED,0EAA0E;IAC1E,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,aAAa,IAAI,OAAO,GAAG,SAAS,CAEvC;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAO9B;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,MAAM,EAAE,YAAY;CAGjC;AAED,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,MAAM,EAAE,YAAY;CAGjC;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,MAAM,EAAE,YAAY;CAGjC"}
+{"version":3,"file":"hf_hub.d.ts","sourceRoot":"","sources":["../../src/accessor/hf_hub.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEtD,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAIpE;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAE3C,QAAQ,CAAC,MAAM,EAAE,QAAQ;IACzB,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAFjB,MAAM,EAAE,QAAQ;IACzB,wDAAwD;IAC/C,SAAS,GAAE,MAAsB;IAK5C,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,GAAG,iBAAiB,CAGnF;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IAEvC,QAAQ,CAAC,OAAO,EAAE,iBAAiB;IACnC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO;gBAHhB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,YAAY,EACZ,IAAI,SAAU,EACtB,OAAO,GAAE,OAA2B;IAK/C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;;;OAOG;IACH,IAAI,QAAQ,IAAI,MAAM,CAGrB;IAED,0EAA0E;IAC1E,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,aAAa,IAAI,OAAO,GAAG,SAAS,CAEvC;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAO9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,aAAa,CAUf;AAED,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY;CAG7D;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY;CAG7D;AAED,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY;CAG7D"}

package/dist/accessor/hf_hub.js

@@ -12,46 +12,61 @@
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
 import { Accessor } from '@struktoai/mirage-core/accessor/index';
-import { ResourceName } from '@struktoai/mirage-core/types';
+import { VFSName } from '@struktoai/mirage-core/types';
 import * as kp from '@struktoai/mirage-core/utils/key_prefix';
-import { HF_ENDPOINT } from "../resource/hf_buckets/config.js";
+import { HF_ENDPOINT, HF_TIMEOUT_MS, } from "../vfs/hf_buckets/config.js";
+import { hfEndpoint } from "../core/hf_hub/config.js";
 import { DEFAULT_REVISION } from "../core/hf_hub/constants.js";
+import { rstripSlash, stripSlash } from '@struktoai/mirage-core/utils/slash';
 /**
- * A mount onto one Hugging Face Hub repository.
+ * One Hub account: credential, origin and the bound its requests run under.
+ * The `hf` CLI's install accessor and the account a repository handle
+ * borrows; a mount builds its own with `accountOf`.
+ */
+export class HfAccountAccessor extends Accessor {
+    config;
+    timeoutMs;
+    constructor(config, 
+    /** How long one Hub request may go without progress. */
+    timeoutMs = HF_TIMEOUT_MS) {
+        super();
+        this.config = config;
+        this.timeoutMs = timeoutMs;
+    }
+    get token() {
+        return this.config.token;
+    }
+    get endpoint() {
+        return hfEndpoint(this.config);
+    }
+}
+/** The account a repository or bucket mount builds and owns. */
+export function accountOf(config) {
+    const { token, endpoint = HF_ENDPOINT, timeoutMs } = config;
+    return new HfAccountAccessor(token === undefined ? { endpoint } : { token, endpoint }, timeoutMs);
+}
+/**
+ * One Hugging Face Hub repository, over an account it borrows.
  *
- * Holds the whole repository tree: the Hub's listing endpoint is recursive,
- * so one paged walk is the mount's entire listing and every read after it is
- * a lookup. find and du read that tree directly; everything else goes through
- * the index it seeds.
+ * The Hub's listing endpoint is recursive, so one paged walk is the mount's
+ * entire listing, which the mount keeps; every stat and read after it is
+ * handed its row.
  *
  * Constructed without touching the network. A constructor cannot await, so
  * fetching here would mean a blocking client stalling whatever loop the
- * caller is on; the tree hydrates on first use instead.
+ * caller is on.
  */
 export class HfHubAccessor extends Accessor {
+    account;
     config;
     kind;
-    resourceName;
-    /** The recursive tree, keyed mount-relative with no leading slash and with
-     * keyPrefix already stripped. Reseated by every refill. */
-    tree = new Map();
-    /** Whether that tree is an answer or just the empty default, which is a
-     * different question from whether it holds anything: an empty repository
-     * hydrates to an empty map, and reading that as "not hydrated" refetches it
-     * forever. */
-    treeLoaded = false;
-    /** The index tables derived from that tree, for a mount with no index
-     * wired. Derivation is O(tree), so a readdir loop over a large repo would
-     * be quadratic without a memo; every reseat of `tree` clears it. */
-    rowsCache = null;
-    /** Guards the lazy hydration so concurrent first reads make one request
-     * rather than one per caller. */
-    hydrating = null;
-    constructor(config, kind = 'model', resourceName = ResourceName.HF_MODELS) {
+    vfsName;
+    constructor(account, config, kind = 'model', vfsName = VFSName.HF_MODELS) {
         super();
+        this.account = account;
         this.config = config;
         this.kind = kind;
-        this.resourceName = resourceName;
+        this.vfsName = vfsName;
     }
     get repoType() {
         return this.kind;
@@ -60,10 +75,7 @@ export class HfHubAccessor extends Accessor {
         return this.config.repoId;
     }
     get endpoint() {
-        return this.config.endpoint ?? HF_ENDPOINT;
-    }
-    get token() {
-        return this.config.token;
+        return this.account.endpoint;
     }
     /**
      * The revision this mount reads.
@@ -96,27 +108,45 @@ export class HfHubAccessor extends Accessor {
      */
     repoPath(rel) {
         const prefix = this.keyPrefix;
-        const stem = rel.replace(/^\/+|\/+$/g, '');
+        const stem = stripSlash(rel);
         if (prefix === '')
             return stem;
         if (stem === '')
-            return prefix.replace(/\/+$/, '');
-        return kp.apply(prefix, rel).replace(/\/+$/, '');
+            return rstripSlash(prefix);
+        return rstripSlash(kp.apply(prefix, rel));
     }
 }
-export class HfModelsHubAccessor extends HfHubAccessor {
-    constructor(config) {
-        super(config, 'model', ResourceName.HF_MODELS);
+/**
+ * A Hub handle for one repository, over an account it borrows.
+ *
+ * The `hf` CLI builds one per invocation over the install's account rather
+ * than owning a second Hub client: the handle only names which repository is
+ * being addressed and rides the account's credential, origin and request
+ * bound, so `hf` gets the mount's tree walk and commit builder for free. It
+ * reaches no mount, which is what keeps `hf` an account CLI. A verb reads paths and
+ * sizes, never the per-file commit a mount's mtimes come from, so the walk
+ * lists bare.
+ */
+export function hubFor(account, repoId, repoType, revision) {
+    return new HfHubAccessor(account, {
+        repoId,
+        revision: revision === undefined || revision === '' ? DEFAULT_REVISION : revision,
+        expandCommits: false,
+    }, repoType);
+}
+export class HfModelsAccessor extends HfHubAccessor {
+    constructor(account, config) {
+        super(account, config, 'model', VFSName.HF_MODELS);
     }
 }
-export class HfDatasetsHubAccessor extends HfHubAccessor {
-    constructor(config) {
-        super(config, 'dataset', ResourceName.HF_DATASETS);
+export class HfDatasetsAccessor extends HfHubAccessor {
+    constructor(account, config) {
+        super(account, config, 'dataset', VFSName.HF_DATASETS);
     }
 }
-export class HfSpacesHubAccessor extends HfHubAccessor {
-    constructor(config) {
-        super(config, 'space', ResourceName.HF_SPACES);
+export class HfSpacesAccessor extends HfHubAccessor {
+    constructor(account, config) {
+        super(account, config, 'space', VFSName.HF_SPACES);
     }
 }
 //# sourceMappingURL=hf_hub.js.map

package/dist/accessor/hf_hub.js.map

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

package/dist/accessor/nextcloud.d.ts

@@ -1,9 +1,9 @@
 import type { Operator } from 'opendal';
 import { Accessor } from '@struktoai/mirage-core/accessor/index';
-import type { NextcloudConfig } from '../resource/nextcloud/config.ts';
+import type { NextcloudConfig } from '../vfs/nextcloud/config.ts';
 export declare class NextcloudAccessor extends Accessor {
     readonly config: NextcloudConfig;
-    readonly resourceName: "nextcloud";
+    readonly vfsName: "nextcloud";
     private operatorPromise;
     constructor(config: NextcloudConfig);
     operator(): Promise<Operator>;

package/dist/accessor/nextcloud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nextcloud.d.ts","sourceRoot":"","sources":["../../src/accessor/nextcloud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAGhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,qBAAa,iBAAkB,SAAQ,QAAQ;IAIjC,QAAQ,CAAC,MAAM,EAAE,eAAe;IAH5C,QAAQ,CAAC,YAAY,cAAyB;IAC9C,OAAO,CAAC,eAAe,CAAiC;gBAEnC,MAAM,EAAE,eAAe;IAI5C,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;YAKf,cAAc;CAU7B"}
+{"version":3,"file":"nextcloud.d.ts","sourceRoot":"","sources":["../../src/accessor/nextcloud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAGhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAEjE,qBAAa,iBAAkB,SAAQ,QAAQ;IAIjC,QAAQ,CAAC,MAAM,EAAE,eAAe;IAH5C,QAAQ,CAAC,OAAO,cAAoB;IACpC,OAAO,CAAC,eAAe,CAAiC;gBAEnC,MAAM,EAAE,eAAe;IAI5C,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;YAKf,cAAc;CAU7B"}