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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/gridfs/write.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,KAAK,4GAAyB,CAAA"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/gridfs/write.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,KAAK,4GAAoB,CAAA;AAEtC,eAAO,MAAM,WAAW,kHAA0B,CAAA"}

package/dist/core/gridfs/write.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 { makeWriteBytes } from '@struktoai/mirage-core/core/object_store/write';
+import { makeWrite, makeWriteStream } from '@struktoai/mirage-core/core/object_store/write';
 import { DRIVER } from "./driver.js";
-export const write = makeWriteBytes(DRIVER);
+export const write = makeWrite(DRIVER);
+export const writeStream = makeWriteStream(DRIVER);
 //# sourceMappingURL=write.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/gridfs/write.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,cAAc,EAAE,MAAM,gDAAgD,CAAA;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,CAAC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA"}
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/gridfs/write.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,SAAS,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAA;AAC3F,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;AAEtC,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA"}

package/dist/core/hf_buckets/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const SCOPE_ERROR = 10000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/hf_buckets/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/hf_buckets/constants.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,WAAW,QAAQ,CAAA"}

package/dist/core/hf_buckets/constants.js

@@ -0,0 +1,15 @@
+// ========= 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. =========
+export const SCOPE_ERROR = 10000;
+//# sourceMappingURL=constants.js.map

package/dist/core/hf_buckets/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/hf_buckets/constants.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAA"}

package/dist/core/hf_buckets/create.d.ts

@@ -0,0 +1,2 @@
+export declare const create: import("@struktoai/mirage-core/core/object_store/driver").CreateFn<import("../../index.ts").HfBucketsAccessor>;
+//# sourceMappingURL=create.d.ts.map

package/dist/core/hf_buckets/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/core/hf_buckets/create.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,MAAM,gHAAqB,CAAA"}

package/dist/core/hf_buckets/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/core/hf_buckets/create.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;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA"}

package/dist/core/hf_buckets/driver.d.ts

@@ -0,0 +1,15 @@
+import type { ObjectStoreDriver } from '@struktoai/mirage-core/core/object_store/driver';
+import type { Operator } from 'opendal';
+import type { HfBucketsAccessor } from '../../accessor/hf_buckets.ts';
+/**
+ * One op's handle on a bucket: the operator and the Hub behind it.
+ *
+ * Listing and mutation go through opendal; the point lookup goes to the Hub
+ * directly, because opendal drops the bucket's content token.
+ */
+export interface HfConn {
+    accessor: HfBucketsAccessor;
+    op: Operator;
+}
+export declare const DRIVER: ObjectStoreDriver<HfBucketsAccessor, HfConn>;
+//# sourceMappingURL=driver.d.ts.map

package/dist/core/hf_buckets/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/core/hf_buckets/driver.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAIV,iBAAiB,EAElB,MAAM,iDAAiD,CAAA;AAExD,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAKrE;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,EAAE,EAAE,QAAQ,CAAA;CACb;AA4KD,eAAO,MAAM,MAAM,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,MAAM,CAiB/D,CAAA"}

package/dist/core/hf_buckets/driver.js

@@ -0,0 +1,211 @@
+// ========= 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 { rstripSlash } from '@struktoai/mirage-core/utils/slash';
+import { SCOPE_ERROR } from "./constants.js";
+import { HfHubError } from "../hf_hub/client.js";
+import { fetchRow } from "./hub.js";
+function keyPrefixOf(_accessor) {
+    // key_prefix is applied as the operator's root (see HfBucketsAccessor), so
+    // every key the driver sees is already prefix-relative.
+    return '';
+}
+async function connect(accessor) {
+    return { conn: { accessor, op: await accessor.operator() }, close: () => Promise.resolve() };
+}
+function dirPath(pfx) {
+    return pfx !== '' ? pfx : '/';
+}
+function sizeOf(md) {
+    return md.contentLength !== null ? Number(md.contentLength) : null;
+}
+async function* listChildren(conn, pfx) {
+    const path = dirPath(pfx);
+    let entries;
+    try {
+        entries = await conn.op.list(path);
+    }
+    catch (err) {
+        // The Hub answers a missing subpath with 200 and [] more often than
+        // with an error; either way an empty yield is what lets the kit's
+        // missing-directory classification run.
+        if (isNotFound(err))
+            return;
+        throw err;
+    }
+    for (const entry of entries) {
+        const rel = entry.path();
+        if (rel === '')
+            continue;
+        if (rel === path) {
+            // The lister reported the directory itself; it proves the prefix
+            // holds something but names no child.
+            yield { key: rel, kind: 'marker' };
+            continue;
+        }
+        if (rel.endsWith('/')) {
+            yield { key: rstripSlash(rel), kind: 'd' };
+            continue;
+        }
+        // The Hub tree API carries a size for every file (for LFS files it is
+        // the object size, not the pointer's); when the lister omits the
+        // metadata, one stat per affected file fills the gap so the index
+        // never caches an unknown size.
+        const size = sizeOf(entry.metadata()) ?? sizeOf(await conn.op.stat(rel));
+        yield { key: rel, kind: 'f', size };
+    }
+}
+async function* listSubtree(conn, stem) {
+    if (stem !== '') {
+        let md = null;
+        try {
+            md = await conn.op.stat(stem);
+        }
+        catch (err) {
+            if (!isNotFound(err))
+                throw err;
+        }
+        if (md !== null && !md.isDirectory()) {
+            // A repo cannot hold a file and a directory of the same name, so
+            // a stem that is a file has nothing under it.
+            const size = sizeOf(md);
+            const modified = md.lastModified ?? '';
+            yield size === null ? { key: stem, modified } : { key: stem, size, modified };
+            return;
+        }
+    }
+    const base = stem !== '' ? `${stem}/` : '/';
+    let entries;
+    try {
+        entries = await conn.op.list(base, { recursive: true });
+    }
+    catch (err) {
+        if (isNotFound(err))
+            return;
+        throw err;
+    }
+    for (const entry of entries) {
+        const rel = entry.path();
+        if (rel === '' || rel.endsWith('/'))
+            continue;
+        const md = entry.metadata();
+        const size = sizeOf(md);
+        const modified = md.lastModified ?? '';
+        yield size === null ? { key: rel, modified } : { key: rel, size, modified };
+    }
+}
+async function head(conn, key) {
+    // paths-info, not opendal's stat: the binding reads the bucket's xet hash
+    // for nothing but the size and drops it, so a bucket stat through it
+    // carries no token. A Hub refusal propagates; the stat function names the path
+    // it was asked about, which a key cannot.
+    const row = await fetchRow(conn.accessor, key);
+    if (row === null)
+        return null;
+    const token = typeof row.xetHash === 'string' && row.xetHash !== '' ? row.xetHash : null;
+    // A file row always carries its size; one that does not is an answer the
+    // client cannot read, not a zero-byte file.
+    if (typeof row.size !== 'number') {
+        throw new HfHubError(`paths-info answered no size for ${key}`, 0, 'InvalidResponse');
+    }
+    // No mtime, though the row carries uploadedAt: a listing reads its times
+    // through opendal, which reports none for a bucket file, and a stat that
+    // disagreed with the listing about one file would be the worse answer.
+    return {
+        size: row.size,
+        modified: null,
+        fingerprint: token,
+        extra: token !== null ? { etag: token } : {},
+    };
+}
+async function get(conn, key) {
+    try {
+        return await conn.op.read(key);
+    }
+    catch (err) {
+        if (isNotFound(err))
+            return null;
+        throw err;
+    }
+}
+async function put(conn, key, data) {
+    // A missing repo or revision answers NotFound; it propagates so the
+    // write factory can name the path the user typed, not this key.
+    // No token: opendal's write does return Metadata here, but the python
+    // binding's returns nothing, so it is discarded to keep an hf write
+    // stamping the same absence in both languages. The written entry then
+    // verifies against nothing, so the next fresh read refetches once and
+    // stamps the download's token (#1138).
+    await conn.op.write(key, Buffer.from(data));
+    return null;
+}
+async function deleteFile(conn, key) {
+    try {
+        await conn.op.delete(key);
+    }
+    catch (err) {
+        // Deleting a missing key is silent, per the driver contract.
+        if (!isNotFound(err))
+            throw err;
+    }
+}
+async function deletePrefix(conn, pfx) {
+    let entries;
+    try {
+        entries = await conn.op.list(dirPath(pfx), { recursive: true });
+    }
+    catch (err) {
+        if (isNotFound(err))
+            return;
+        throw err;
+    }
+    // The Hub has no batch delete; one request per key.
+    for (const entry of entries) {
+        const key = entry.path();
+        if (key.endsWith('/'))
+            continue;
+        await conn.op.delete(key);
+    }
+}
+async function probePrefix(conn, pfx) {
+    try {
+        return (await conn.op.list(dirPath(pfx))).length > 0;
+    }
+    catch (err) {
+        if (isNotFound(err))
+            return false;
+        throw err;
+    }
+}
+function isNotFound(err) {
+    return err instanceof Error && err.message.startsWith('NotFound');
+}
+export const DRIVER = {
+    vfs: 'hf',
+    scopeError: SCOPE_ERROR,
+    keyPrefixOf,
+    connect,
+    listChildren,
+    listSubtree,
+    head,
+    get,
+    put,
+    deleteFile,
+    deletePrefix,
+    probePrefix,
+    isNotFound,
+    // No markers (the Hub refuses create_dir), no native move or copy
+    // (rename/cp stay unwired -> ENOTSUP), no query push-down.
+    markersSupported: false,
+};
+//# sourceMappingURL=driver.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare const exists: import("@struktoai/mirage-core/core/object_store/driver").ExistsFn<import("../../index.ts").HfBucketsAccessor>;
+//# sourceMappingURL=exists.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exists.d.ts","sourceRoot":"","sources":["../../../src/core/hf_buckets/exists.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,MAAM,gHAAmB,CAAA"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"exists.js","sourceRoot":"","sources":["../../../src/core/hf_buckets/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;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAA;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA"}

package/dist/core/hf_buckets/hub.d.ts

@@ -0,0 +1,37 @@
+import type { HfBucketsAccessor } from '../../accessor/hf_buckets.ts';
+type Row = Record<string, unknown>;
+/**
+ * The paths-info endpoint of the mount's bucket.
+ *
+ * A bucket has no revisions, so unlike a repository's route this one carries
+ * no revision segment: `/paths-info/main` answers 404.
+ */
+export declare function pathsInfoUrl(accessor: HfBucketsAccessor): string;
+/**
+ * The content URL of one bucket file.
+ *
+ * The path is percent-encoded per segment, as a repository's resolve URL is:
+ * a name holding a "#" pasted raw truncates at the fragment.
+ */
+export declare function resolveUrl(accessor: HfBucketsAccessor, rel: string): string;
+/**
+ * The paths-info row of one bucket file, in one request.
+ *
+ * paths-info answers a missing path, a directory and a leading-slash spelling
+ * alike with an empty list, and a file with its row, so only a file row naming
+ * exactly the asked path is an answer. A row for some other path is not
+ * evidence about this one, and must not read as its absence: reconcile deletes
+ * what it believes is gone. The mount root is never a file and is never asked.
+ */
+export declare function fetchRow(accessor: HfBucketsAccessor, key: string): Promise<Row | null>;
+/**
+ * The content token a download's ETag vouches for, or null.
+ *
+ * A bucket file's strong ETag is its xet hash, the value paths-info reports,
+ * whether the read was whole or ranged. A weak validator promises equivalence
+ * rather than the same bytes, so it vouches for nothing, and neither does an
+ * empty one.
+ */
+export declare function readToken(rawEtag: string): string | null;
+export {};
+//# sourceMappingURL=hub.d.ts.map

package/dist/core/hf_buckets/hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../../../src/core/hf_buckets/hub.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAGrE,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAMlC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAc5F;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIxD"}

package/dist/core/hf_buckets/hub.js

@@ -0,0 +1,74 @@
+// ========= 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 { rstripSlash, stripSlash } from '@struktoai/mirage-core/utils/slash';
+import { HfHubError, quotePath, etagValue, hubPost } from "../hf_hub/client.js";
+function base(accessor) {
+    return rstripSlash(accessor.endpoint);
+}
+/**
+ * The paths-info endpoint of the mount's bucket.
+ *
+ * A bucket has no revisions, so unlike a repository's route this one carries
+ * no revision segment: `/paths-info/main` answers 404.
+ */
+export function pathsInfoUrl(accessor) {
+    return `${base(accessor)}/api/buckets/${accessor.repoId}/paths-info`;
+}
+/**
+ * The content URL of one bucket file.
+ *
+ * The path is percent-encoded per segment, as a repository's resolve URL is:
+ * a name holding a "#" pasted raw truncates at the fragment.
+ */
+export function resolveUrl(accessor, rel) {
+    return `${base(accessor)}/buckets/${accessor.repoId}/resolve/${quotePath(accessor.bucketPath(rel))}`;
+}
+/**
+ * The paths-info row of one bucket file, in one request.
+ *
+ * paths-info answers a missing path, a directory and a leading-slash spelling
+ * alike with an empty list, and a file with its row, so only a file row naming
+ * exactly the asked path is an answer. A row for some other path is not
+ * evidence about this one, and must not read as its absence: reconcile deletes
+ * what it believes is gone. The mount root is never a file and is never asked.
+ */
+export async function fetchRow(accessor, key) {
+    if (stripSlash(key) === '')
+        return null;
+    const asked = accessor.bucketPath(key);
+    const rows = await hubPost(accessor.account, pathsInfoUrl(accessor), { paths: [asked] });
+    if (!Array.isArray(rows)) {
+        throw new HfHubError(`paths-info answered no list for ${asked}`, 0, 'InvalidResponse');
+    }
+    const matching = rows.filter((row) => typeof row === 'object' && row !== null && row.path === asked);
+    if (rows.length > 0 && matching.length === 0) {
+        throw new HfHubError(`paths-info answered no row for ${asked}`, 0, 'PathMismatch');
+    }
+    return matching.find((row) => row.type === 'file') ?? null;
+}
+/**
+ * The content token a download's ETag vouches for, or null.
+ *
+ * A bucket file's strong ETag is its xet hash, the value paths-info reports,
+ * whether the read was whole or ranged. A weak validator promises equivalence
+ * rather than the same bytes, so it vouches for nothing, and neither does an
+ * empty one.
+ */
+export function readToken(rawEtag) {
+    if (rawEtag.trim().startsWith('W/'))
+        return null;
+    const value = etagValue(rawEtag);
+    return value === '' ? null : value;
+}
+//# sourceMappingURL=hub.js.map

package/dist/core/hf_buckets/hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.js","sourceRoot":"","sources":["../../../src/core/hf_buckets/hub.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,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAE5E,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAI/E,SAAS,IAAI,CAAC,QAA2B;IACvC,OAAO,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAA2B;IACtD,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,QAAQ,CAAC,MAAM,aAAa,CAAA;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,QAA2B,EAAE,GAAW;IACjE,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,QAAQ,CAAC,MAAM,YAAY,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAA;AACtG,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAA2B,EAAE,GAAW;IACrE,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACxF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,UAAU,CAAC,mCAAmC,KAAK,EAAE,EAAE,CAAC,EAAE,iBAAiB,CAAC,CAAA;IACxF,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAC1B,CAAC,GAAG,EAAc,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAK,GAAW,CAAC,IAAI,KAAK,KAAK,CAC5F,CAAA;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,UAAU,CAAC,kCAAkC,KAAK,EAAE,EAAE,CAAC,EAAE,cAAc,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,CAAA;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAChD,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAChC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;AACpC,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare const mkdir: import("@struktoai/mirage-core/core/object_store/driver").MkdirFn<import("../../index.ts").HfBucketsAccessor>;
+//# sourceMappingURL=mkdir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mkdir.d.ts","sourceRoot":"","sources":["../../../src/core/hf_buckets/mkdir.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,KAAK,+GAAoB,CAAA"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"mkdir.js","sourceRoot":"","sources":["../../../src/core/hf_buckets/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;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAA;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA"}

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

@@ -0,0 +1,23 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
+import type { HfBucketsAccessor } from '../../accessor/hf_buckets.ts';
+export interface HfReadOptions {
+    offset?: number;
+    size?: number;
+}
+/**
+ * Whether a download refusal says the file does not exist.
+ *
+ * Only a 404 carrying `EntryNotFound` does. A 404 without it (a CDN hop, a
+ * bucket the token cannot see) is a failed read of a file that may well exist,
+ * and reading it as absence would let reconcile drop the path's overlay.
+ */
+export declare function isMissing(err: unknown): boolean;
+/**
+ * Read a bucket file, or a byte window of it, from the Hub.
+ *
+ * Not through opendal: its read returns bare bytes, and the ETag the download
+ * carries is the file's xet hash, the token stat reports, so it is stamped on
+ * the read record as it comes.
+ */
+export declare function read(accessor: HfBucketsAccessor, path: PathSpec, options?: HfReadOptions): Promise<Uint8Array>;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/hf_buckets/read.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAUrE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE/C;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CACxB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAqCrB"}

package/dist/core/hf_buckets/read.js

@@ -0,0 +1,79 @@
+// ========= 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 { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { eisdir, enoent } from '@struktoai/mirage-core/errors/fs';
+import { stripSlash } from '@struktoai/mirage-core/utils/slash';
+import { HfHubError, hubBytesTagged } from "../hf_hub/client.js";
+import { REFUSED_STATUSES } from "../hf_hub/constants.js";
+import { refusalsDenied } from "../hf_hub/lookup.js";
+import { readToken, resolveUrl } from "./hub.js";
+const MISSING_ENTRY = 'EntryNotFound';
+const UNSATISFIABLE = 416;
+/**
+ * Whether a download refusal says the file does not exist.
+ *
+ * Only a 404 carrying `EntryNotFound` does. A 404 without it (a CDN hop, a
+ * bucket the token cannot see) is a failed read of a file that may well exist,
+ * and reading it as absence would let reconcile drop the path's overlay.
+ */
+export function isMissing(err) {
+    return err instanceof HfHubError && err.status === 404 && err.errorCode === MISSING_ENTRY;
+}
+/**
+ * Read a bucket file, or a byte window of it, from the Hub.
+ *
+ * Not through opendal: its read returns bare bytes, and the ETag the download
+ * carries is the file's xet hash, the token stat reports, so it is stamped on
+ * the read record as it comes.
+ */
+export async function read(accessor, path, options = {}) {
+    const rel = path.mountPath;
+    if (stripSlash(rel) === '')
+        throw eisdir(path);
+    // `size: null` is the window's own spelling for "the rest of the file",
+    // which is not the same as asking for no window at all.
+    const hasWindow = (options.offset ?? 0) > 0 || options.size !== undefined;
+    // A zero-length Range header is not one the client can build, so a
+    // zero-length window asks for one byte and discards it: the request still
+    // answers whether the file exists, which an empty return would skip.
+    const window = hasWindow
+        ? { offset: options.offset ?? 0, size: options.size === 0 ? 1 : (options.size ?? null) }
+        : undefined;
+    const timer = startOp();
+    let data;
+    let etag;
+    try {
+        ;
+        [data, etag] = await refusalsDenied(path, () => hubBytesTagged(accessor.account, resolveUrl(accessor, rel), window), REFUSED_STATUSES);
+    }
+    catch (err) {
+        if (isMissing(err))
+            throw enoent(path);
+        if (!(err instanceof HfHubError) || err.status !== UNSATISFIABLE || window === undefined) {
+            throw err;
+        }
+        // A window starting at or past EOF: the Hub answers 416 where a POSIX read
+        // returns nothing. Folded here rather than left to the ops factory,
+        // because a caller reading the range op directly has no fold of its own.
+        data = new Uint8Array();
+        etag = '';
+    }
+    if (options.size === 0)
+        data = new Uint8Array();
+    record('read', path.virtual, accessor.vfsName, data.byteLength, timer, {
+        fingerprint: readToken(etag),
+    });
+    return data;
+}
+//# sourceMappingURL=read.js.map

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

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

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

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

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

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

package/dist/core/hf_buckets/readdir.js

@@ -0,0 +1,18 @@
+// ========= 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 { 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/hf_buckets/readdir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readdir.js","sourceRoot":"","sources":["../../../src/core/hf_buckets/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;AACvE,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/hf_buckets/rm.d.ts

@@ -0,0 +1,2 @@
+export declare const rmR: import("@struktoai/mirage-core/core/object_store/driver").PathFn<import("../../index.ts").HfBucketsAccessor>;
+//# sourceMappingURL=rm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rm.d.ts","sourceRoot":"","sources":["../../../src/core/hf_buckets/rm.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,GAAG,8GAA2B,CAAA"}