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

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

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

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

@@ -0,0 +1,12 @@
+import type { FileStat, PathSpec } from '@struktoai/mirage-core/types';
+import type { HfBucketsAccessor } from '../../accessor/hf_buckets.ts';
+/**
+ * Stat one path, a refused bucket reading as permission denied.
+ *
+ * paths-info answers a missing path with an empty list, never an error, so a
+ * 401, 403 or 404 from it is about the bucket: an anonymous caller asking for
+ * one that does not exist gets 401. Answering that as "no such file" would let
+ * reconcile delete what a refreshed token can see.
+ */
+export declare function stat(accessor: HfBucketsAccessor, pathSpec: PathSpec): Promise<FileStat>;
+//# sourceMappingURL=stat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stat.d.ts","sourceRoot":"","sources":["../../../src/core/hf_buckets/stat.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAMrE;;;;;;;GAOG;AACH,wBAAsB,IAAI,CAAC,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAE7F"}

package/dist/core/hf_buckets/stat.js

@@ -0,0 +1,29 @@
+// ========= 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 { makeStat } from '@struktoai/mirage-core/core/object_store/stat';
+import { refusalsDenied } from "../hf_hub/lookup.js";
+import { DRIVER } from "./driver.js";
+const kitStat = makeStat(DRIVER);
+/**
+ * Stat one path, a refused bucket reading as permission denied.
+ *
+ * paths-info answers a missing path with an empty list, never an error, so a
+ * 401, 403 or 404 from it is about the bucket: an anonymous caller asking for
+ * one that does not exist gets 401. Answering that as "no such file" would let
+ * reconcile delete what a refreshed token can see.
+ */
+export async function stat(accessor, pathSpec) {
+    return refusalsDenied(pathSpec, () => kitStat(accessor, pathSpec));
+}
+//# sourceMappingURL=stat.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stat.js","sourceRoot":"","sources":["../../../src/core/hf_buckets/stat.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,QAAQ,EAAE,MAAM,+CAA+C,CAAA;AAGxE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;AAEhC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,QAA2B,EAAE,QAAkB;IACxE,OAAO,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;AACpE,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
+import type { HfBucketsAccessor } from '../../accessor/hf_buckets.ts';
+/** Stream a bucket file from the Hub, stamped with its ETag. */
+export declare function readStream(accessor: HfBucketsAccessor, path: PathSpec): AsyncIterable<Uint8Array>;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/hf_buckets/stream.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAOrE,gEAAgE;AAChE,wBAAuB,UAAU,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACb,aAAa,CAAC,UAAU,CAAC,CAiB3B"}

package/dist/core/hf_buckets/stream.js

@@ -0,0 +1,46 @@
+// ========= 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 { recordStream } from '@struktoai/mirage-core/observe/context';
+import { eisdir, enoent } from '@struktoai/mirage-core/errors/fs';
+import { stripSlash } from '@struktoai/mirage-core/utils/slash';
+import { hubStream } from "../hf_hub/client.js";
+import { REFUSED_STATUSES } from "../hf_hub/constants.js";
+import { asRefusal } from "../hf_hub/lookup.js";
+import { readToken, resolveUrl } from "./hub.js";
+import { isMissing } from "./read.js";
+/** Stream a bucket file from the Hub, stamped with its ETag. */
+export async function* readStream(accessor, path) {
+    const rel = path.mountPath;
+    if (stripSlash(rel) === '')
+        throw eisdir(path);
+    const rec = recordStream('read', path.virtual, accessor.vfsName);
+    const stamp = (headers) => {
+        if (rec !== null)
+            rec.fingerprint = readToken(headers.etag ?? '');
+    };
+    try {
+        const url = resolveUrl(accessor, rel);
+        for await (const chunk of hubStream(accessor.account, url, stamp)) {
+            if (rec !== null)
+                rec.bytes += chunk.byteLength;
+            yield chunk;
+        }
+    }
+    catch (err) {
+        if (isMissing(err))
+            throw enoent(path);
+        throw asRefusal(path, err, REFUSED_STATUSES);
+    }
+}
+//# sourceMappingURL=stream.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../src/core/hf_buckets/stream.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,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAErE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAE/D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,gEAAgE;AAChE,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAC/B,QAA2B,EAC3B,IAAc;IAEd,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAA;IAC1B,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE;QAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAChE,MAAM,KAAK,GAAG,CAAC,OAA+B,EAAQ,EAAE;QACtD,IAAI,GAAG,KAAK,IAAI;YAAE,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;IACnE,CAAC,CAAA;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;QACrC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;YAClE,IAAI,GAAG,KAAK,IAAI;gBAAE,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAA;YAC/C,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,SAAS,CAAC,GAAG,CAAC;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC"}

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

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

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

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

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

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

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

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

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

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

package/dist/core/hf_buckets/write.js

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

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

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

@@ -1,4 +1,4 @@
-import { type HfConfig } from './config.ts';
-/** Who the configured token belongs to. */
-export declare function whoami(config: HfConfig): Promise<Record<string, unknown>>;
+import type { HfAccountAccessor } from '../../accessor/hf_hub.ts';
+/** Who the account's token belongs to. */
+export declare function whoami(account: HfAccountAccessor): Promise<Record<string, unknown>>;
 //# sourceMappingURL=account.d.ts.map

package/dist/core/hf_hub/account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/core/hf_hub/account.ts"],"names":[],"mappings":"AAeA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEvD,2CAA2C;AAC3C,wBAAsB,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAI/E"}
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/core/hf_hub/account.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAIjE,0CAA0C;AAC1C,wBAAsB,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAIzF"}

package/dist/core/hf_hub/account.js

@@ -12,11 +12,11 @@
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
 import { hubGet } from "./client.js";
-import { hfEndpoint } from "./config.js";
-/** Who the configured token belongs to. */
-export async function whoami(config) {
-    const url = `${hfEndpoint(config).replace(/\/+$/, '')}/api/whoami-v2`;
-    const data = await hubGet(config.token, url);
+import { rstripSlash } from '@struktoai/mirage-core/utils/slash';
+/** Who the account's token belongs to. */
+export async function whoami(account) {
+    const url = `${rstripSlash(account.endpoint)}/api/whoami-v2`;
+    const data = await hubGet(account, url);
     return typeof data === 'object' && data !== null ? data : {};
 }
 //# sourceMappingURL=account.js.map

package/dist/core/hf_hub/account.js.map

@@ -1 +1 @@
-{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/core/hf_hub/account.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,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,UAAU,EAAiB,MAAM,aAAa,CAAA;AAEvD,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAgB;IAC3C,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAA;IACrE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAC5C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAE,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC3F,CAAC"}
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/core/hf_hub/account.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAEhE,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAA0B;IACrD,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAA;IAC5D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IACvC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAE,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC3F,CAAC"}

package/dist/core/hf_hub/admin.d.ts

@@ -1,4 +1,4 @@
-import { type HfConfig } from './config.ts';
+import type { HfAccountAccessor } from '../../accessor/hf_hub.ts';
 /**
  * The organization and name halves the repo endpoints take.
  *
@@ -24,18 +24,16 @@ export interface CreateRepoOptions {
     resourceGroupId?: string | undefined;
 }
 /** Create a repository on the Hub. */
-export declare function createRepo(config: HfConfig, repoId: string, options?: CreateRepoOptions): Promise<Record<string, unknown>>;
-/** Delete a repository from the Hub. */
-export declare function deleteRepo(config: HfConfig, repoId: string, repoType?: string): Promise<void>;
+export declare function createRepo(account: HfAccountAccessor, repoId: string, options?: CreateRepoOptions): Promise<Record<string, unknown>>;
 /** Tag a revision of a repository. */
-export declare function createTag(config: HfConfig, repoId: string, tag: string, repoType?: string, revision?: string, message?: string): Promise<void>;
+export declare function createTag(account: HfAccountAccessor, repoId: string, tag: string, repoType?: string, revision?: string, message?: string): Promise<void>;
 /** Remove a tag from a repository. */
-export declare function deleteTag(config: HfConfig, repoId: string, tag: string, repoType?: string): Promise<void>;
+export declare function deleteTag(account: HfAccountAccessor, repoId: string, tag: string, repoType?: string): Promise<void>;
 /**
  * Every tag on a repository.
  *
  * Read from /refs, which is the only endpoint that enumerates them; there is
  * no tag listing of its own.
  */
-export declare function listTags(config: HfConfig, repoId: string, repoType?: string): Promise<string[]>;
+export declare function listTags(account: HfAccountAccessor, repoId: string, repoType?: string): Promise<string[]>;
 //# sourceMappingURL=admin.d.ts.map

package/dist/core/hf_hub/admin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../src/core/hf_hub/admin.ts"],"names":[],"mappings":"AAeA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGvD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,CAInE;AAOD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC;AAED,sCAAsC;AACtC,wBAAsB,UAAU,CAC9B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBlC;AAED,wCAAwC;AACxC,wBAAsB,UAAU,CAC9B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,SAAU,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,sCAAsC;AACtC,wBAAsB,SAAS,CAC7B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,SAAU,EAClB,QAAQ,GAAE,MAAyB,EACnC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,sCAAsC;AACtC,wBAAsB,SAAS,CAC7B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,SAAU,GACjB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,SAAU,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB"}
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../src/core/hf_hub/admin.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAKjE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,CAInE;AAYD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC;AAED,sCAAsC;AACtC,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBlC;AAED,sCAAsC;AACtC,wBAAsB,SAAS,CAC7B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,SAAU,EAClB,QAAQ,GAAE,MAAyB,EACnC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,sCAAsC;AACtC,wBAAsB,SAAS,CAC7B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,SAAU,GACjB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,SAAU,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB"}

package/dist/core/hf_hub/admin.js

@@ -12,8 +12,8 @@
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
 import { HfHubError, hubGet, hubPost, hubRequest, repoUrl, revSegment } from "./client.js";
-import { hfEndpoint } from "./config.js";
 import { API_SEGMENTS, DEFAULT_REVISION, HTTP_CONFLICT } from "./constants.js";
+import { rstripSlash } from '@struktoai/mirage-core/utils/slash';
 /**
  * The organization and name halves the repo endpoints take.
  *
@@ -27,12 +27,12 @@ export function splitRepoId(repoId) {
         return [null, repoId];
     return [repoId.slice(0, cut), repoId.slice(cut + 1)];
 }
-function repoApiUrl(config, repoType, repoId, suffix) {
+function repoApiUrl(account, repoType, repoId, suffix) {
     const segment = API_SEGMENTS[repoType] ?? 'models';
-    return `${hfEndpoint(config).replace(/\/+$/, '')}/api/${segment}/${repoId}${suffix}`;
+    return `${rstripSlash(account.endpoint)}/api/${segment}/${repoId}${suffix}`;
 }
 /** Create a repository on the Hub. */
-export async function createRepo(config, repoId, options = {}) {
+export async function createRepo(account, repoId, options = {}) {
     const [organization, name] = splitRepoId(repoId);
     const body = {
         name,
@@ -46,35 +46,29 @@ export async function createRepo(config, repoId, options = {}) {
     if (options.resourceGroupId !== undefined && options.resourceGroupId !== '') {
         body.resourceGroupId = options.resourceGroupId;
     }
-    const url = `${hfEndpoint(config).replace(/\/+$/, '')}/api/repos/create`;
+    const url = `${rstripSlash(account.endpoint)}/api/repos/create`;
     let data;
     try {
-        data = await hubPost(config.token, url, body);
+        data = await hubPost(account, url, body);
     }
     catch (err) {
         if (options.existOk !== true || !(err instanceof HfHubError) || err.status !== HTTP_CONFLICT) {
             throw err;
         }
-        return { url: repoUrl(hfEndpoint(config), options.repoType ?? 'model', repoId) };
+        return { url: repoUrl(account.endpoint, options.repoType ?? 'model', repoId) };
     }
     return typeof data === 'object' && data !== null ? data : {};
 }
-/** Delete a repository from the Hub. */
-export async function deleteRepo(config, repoId, repoType = 'model') {
-    const [organization, name] = splitRepoId(repoId);
-    const url = `${hfEndpoint(config).replace(/\/+$/, '')}/api/repos/delete`;
-    await hubRequest(config.token, 'DELETE', url, { name, organization, type: repoType });
-}
 /** Tag a revision of a repository. */
-export async function createTag(config, repoId, tag, repoType = 'model', revision = DEFAULT_REVISION, message) {
+export async function createTag(account, repoId, tag, repoType = 'model', revision = DEFAULT_REVISION, message) {
     const body = { tag };
     if (message !== undefined)
         body.message = message;
-    await hubPost(config.token, repoApiUrl(config, repoType, repoId, `/tag/${revSegment(revision)}`), body);
+    await hubPost(account, repoApiUrl(account, repoType, repoId, `/tag/${revSegment(revision)}`), body);
 }
 /** Remove a tag from a repository. */
-export async function deleteTag(config, repoId, tag, repoType = 'model') {
-    await hubRequest(config.token, 'DELETE', repoApiUrl(config, repoType, repoId, `/tag/${revSegment(tag)}`), null);
+export async function deleteTag(account, repoId, tag, repoType = 'model') {
+    await hubRequest(account, 'DELETE', repoApiUrl(account, repoType, repoId, `/tag/${revSegment(tag)}`), null);
 }
 /**
  * Every tag on a repository.
@@ -82,8 +76,8 @@ export async function deleteTag(config, repoId, tag, repoType = 'model') {
  * Read from /refs, which is the only endpoint that enumerates them; there is
  * no tag listing of its own.
  */
-export async function listTags(config, repoId, repoType = 'model') {
-    const data = await hubGet(config.token, repoApiUrl(config, repoType, repoId, '/refs'));
+export async function listTags(account, repoId, repoType = 'model') {
+    const data = await hubGet(account, repoApiUrl(account, repoType, repoId, '/refs'));
     const rows = data.tags;
     const names = [];
     for (const row of Array.isArray(rows) ? rows : []) {

package/dist/core/hf_hub/admin.js.map

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

package/dist/core/hf_hub/cache.d.ts

@@ -1,3 +1,4 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { TreeEntry } from './tree_entry.ts';
 /**
  * The one flat directory a repository's cache lives under.
@@ -19,13 +20,13 @@ export declare function repoFolderName(repoId: string, repoType: string): string
  */
 export declare function etagOf(entry: TreeEntry): string;
 /** Where one file's bytes live, shared across every snapshot. */
-export declare function blobPath(cacheDir: string, folder: string, etag: string): string;
+export declare function blobPath(cacheDir: PathSpec, folder: string, etag: string): PathSpec;
 /** The directory one commit's tree is rendered under. */
-export declare function snapshotDir(cacheDir: string, folder: string, sha: string): string;
+export declare function snapshotDir(cacheDir: PathSpec, folder: string, sha: string): PathSpec;
 /** Where one file appears within a commit's rendered tree. */
-export declare function snapshotPath(cacheDir: string, folder: string, sha: string, repoPath: string): string;
+export declare function snapshotPath(cacheDir: PathSpec, folder: string, sha: string, repoPath: string): PathSpec;
 /** The file recording which commit a branch or tag points at. */
-export declare function refPath(cacheDir: string, folder: string, revision: string): string;
+export declare function refPath(cacheDir: PathSpec, folder: string, revision: string): PathSpec;
 /**
  * The relative target a snapshot entry points at.
  *

package/dist/core/hf_hub/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/core/hf_hub/cache.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE/C;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAK9E"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/core/hf_hub/cache.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE/C;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEnF;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAErF;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,QAAQ,CAEV;AAED,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAEtF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAK9E"}

package/dist/core/hf_hub/cache.js

@@ -37,19 +37,19 @@ export function etagOf(entry) {
 }
 /** Where one file's bytes live, shared across every snapshot. */
 export function blobPath(cacheDir, folder, etag) {
-    return `${cacheDir}/${folder}/blobs/${etag}`;
+    return cacheDir.join(folder, 'blobs', etag);
 }
 /** The directory one commit's tree is rendered under. */
 export function snapshotDir(cacheDir, folder, sha) {
-    return `${cacheDir}/${folder}/snapshots/${sha}`;
+    return cacheDir.join(folder, 'snapshots', sha);
 }
 /** Where one file appears within a commit's rendered tree. */
 export function snapshotPath(cacheDir, folder, sha, repoPath) {
-    return `${snapshotDir(cacheDir, folder, sha)}/${repoPath}`;
+    return snapshotDir(cacheDir, folder, sha).join(repoPath);
 }
 /** The file recording which commit a branch or tag points at. */
 export function refPath(cacheDir, folder, revision) {
-    return `${cacheDir}/${folder}/refs/${revision}`;
+    return cacheDir.join(folder, 'refs', revision);
 }
 /**
  * The relative target a snapshot entry points at.

package/dist/core/hf_hub/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/core/hf_hub/cache.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,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGlD;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,QAAgB;IAC7D,OAAO,CAAC,GAAG,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;AACvE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,KAAgB;IACrC,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAA;AACvD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,MAAc,EAAE,IAAY;IACrE,OAAO,GAAG,QAAQ,IAAI,MAAM,UAAU,IAAI,EAAE,CAAA;AAC9C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,MAAc,EAAE,GAAW;IACvE,OAAO,GAAG,QAAQ,IAAI,MAAM,cAAc,GAAG,EAAE,CAAA;AACjD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,MAAc,EACd,GAAW,EACX,QAAgB;IAEhB,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAA;AAC5D,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,OAAO,CAAC,QAAgB,EAAE,MAAc,EAAE,QAAgB;IACxE,OAAO,GAAG,QAAQ,IAAI,MAAM,SAAS,QAAQ,EAAE,CAAA;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,IAAY;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAC5C,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAA;AAClD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,GAAqC;IAC7D,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAA;IAC/B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,MAAM,CAAA;IACxD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAA;IACxB,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AACjE,CAAC"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/core/hf_hub/cache.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGlD;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,QAAgB;IAC7D,OAAO,CAAC,GAAG,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;AACvE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,KAAgB;IACrC,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAA;AACvD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CAAC,QAAkB,EAAE,MAAc,EAAE,IAAY;IACvE,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;AAC7C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,QAAkB,EAAE,MAAc,EAAE,GAAW;IACzE,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,CAAA;AAChD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAC1B,QAAkB,EAClB,MAAc,EACd,GAAW,EACX,QAAgB;IAEhB,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AAC1D,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,OAAO,CAAC,QAAkB,EAAE,MAAc,EAAE,QAAgB;IAC1E,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,IAAY;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAC5C,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAA;AAClD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,GAAqC;IAC7D,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAA;IAC/B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,MAAM,CAAA;IACxD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAA;IACxB,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AACjE,CAAC"}

package/dist/core/hf_hub/checksum.d.ts

@@ -0,0 +1,17 @@
+import type { FileStat, PathSpec } from '@struktoai/mirage-core/types';
+import type { HfHubAccessor } from '../../accessor/hf_hub.ts';
+export declare const LFS_OID: RegExp;
+/**
+ * The sha256 the Hub keeps for an LFS file, asked live.
+ *
+ * An LFS file's row carries its LFS oid, the sha256 of exactly the bytes a
+ * read downloads. A plain git blob's oid hashes a git header with the bytes,
+ * and the Hub keeps no other digest, so every other file and algorithm is
+ * read, without a request when the listing's row names no LFS oid. The
+ * listing's row can be older than the bytes a read downloads, so an LFS file's
+ * row is asked again with one paths-info request, the row a tree walk carries.
+ * A digest answered is recorded as the read it stands in for, with the token a
+ * read of those bytes would record. Mirrors Python's `checksum`.
+ */
+export declare function checksum(accessor: HfHubAccessor, path: PathSpec, algorithm: string, entry?: FileStat | null): Promise<string | null>;
+//# sourceMappingURL=checksum.d.ts.map

package/dist/core/hf_hub/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../../src/core/hf_hub/checksum.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAM7D,eAAO,MAAM,OAAO,QAAmB,CAAA;AAEvC;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB"}

package/dist/core/hf_hub/checksum.js

@@ -0,0 +1,50 @@
+// ========= 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 { stripSlash } from '@struktoai/mirage-core/utils/slash';
+import { refusalsDenied } from "./lookup.js";
+import { fileEntry } from '@struktoai/mirage-core/core/hierarchy/probe';
+import { rowToken } from "./read.js";
+import { fetchPath } from "./tree.js";
+export const LFS_OID = /^[0-9a-f]{64}$/;
+/**
+ * The sha256 the Hub keeps for an LFS file, asked live.
+ *
+ * An LFS file's row carries its LFS oid, the sha256 of exactly the bytes a
+ * read downloads. A plain git blob's oid hashes a git header with the bytes,
+ * and the Hub keeps no other digest, so every other file and algorithm is
+ * read, without a request when the listing's row names no LFS oid. The
+ * listing's row can be older than the bytes a read downloads, so an LFS file's
+ * row is asked again with one paths-info request, the row a tree walk carries.
+ * A digest answered is recorded as the read it stands in for, with the token a
+ * read of those bytes would record. Mirrors Python's `checksum`.
+ */
+export async function checksum(accessor, path, algorithm, entry) {
+    if (algorithm !== 'sha256')
+        return null;
+    const listed = fileEntry(path, entry);
+    const lfs = listed.extra.lfs_oid;
+    if (typeof lfs !== 'string' || lfs === '')
+        return null;
+    const rel = stripSlash(path.mountPath);
+    const timer = startOp();
+    const found = (await refusalsDenied(path, () => fetchPath(accessor, rel))).get(rel);
+    if (found === undefined || !LFS_OID.test(found.lfsOid))
+        return null;
+    record('read', path.virtual, accessor.vfsName, 0, timer, {
+        fingerprint: rowToken(listed, found.lfsOid),
+    });
+    return found.lfsOid;
+}
+//# sourceMappingURL=checksum.js.map

package/dist/core/hf_hub/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../../../src/core/hf_hub/checksum.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,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,6CAA6C,CAAA;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAA;AAEvC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAuB,EACvB,IAAc,EACd,SAAiB,EACjB,KAAuB;IAEvB,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IACvC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACrC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAA;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IACtD,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,MAAM,KAAK,GAAG,CAAC,MAAM,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACnF,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAA;IACnE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE;QACvD,WAAW,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;KAC5C,CAAC,CAAA;IACF,OAAO,KAAK,CAAC,MAAM,CAAA;AACrB,CAAC"}

package/dist/core/hf_hub/client.d.ts

@@ -1,3 +1,4 @@
+import type { HfAccountAccessor } from '../../accessor/hf_hub.ts';
 import type { ApiResponse, RetryPolicy } from '@struktoai/mirage-core/core/api/client';
 import type { ByteWindow } from '@struktoai/mirage-core/utils/ranges';
 export declare const RETRY: RetryPolicy;
@@ -13,6 +14,28 @@ export declare class HfHubError extends Error {
     constructor(message: string, status: number, errorCode?: string);
     readonly status: number;
 }
+/**
+ * A request that never reached the Hub: the connection was refused, reset or
+ * could not be resolved.
+ *
+ * undici rejects these as `TypeError: fetch failed`, the same class a
+ * programming error throws, so a caller that keeps the two apart (the
+ * freshness gate, the read probe) would take an outage for a bug and fail
+ * the whole line. The message is kept, since the executor renders it, and
+ * the original rejection rides along as `cause`. Python's aiohttp raises a
+ * `ClientError` here of its own.
+ */
+export declare class HfHubConnectionError extends Error {
+    constructor(cause: TypeError);
+}
+/**
+ * The fetch every Hub call rides, with a transport failure renamed.
+ *
+ * Only a `TypeError` is a transport failure; an abort, including the
+ * stall bound's `TimeoutError`, passes through as it was. The global is read
+ * per call, not captured, so a stubbed fetch is the one used.
+ */
+export declare const hubFetch: typeof fetch;
 /**
  * Auth and accept headers for one Hub call.
  *
@@ -20,6 +43,17 @@ export declare class HfHubError extends Error {
  * serves every public repo without a token, so a mount with no credential
  * reads normally and only the write path needs one.
  */
+/**
+ * A fetch that gives up on a request making no progress for `ms`.
+ *
+ * The clock runs while connecting and waiting for the answer, and restarts on
+ * every chunk of the body, so a large download that keeps flowing is never
+ * cut off; a total bound would fail any file that takes longer than it to
+ * arrive. It is what huggingface_hub's own timeout means, and the python twin
+ * is `stall_timeout`, which aiohttp spells as sock_connect and sock_read. A
+ * bound of zero or less is none, as aiohttp reads a zero.
+ */
+export declare function stallFetch(ms: number): typeof fetch;
 export declare function hubHeaders(token: string | undefined): Record<string, string>;
 /** The /api URL for one repository-scoped endpoint. */
 export declare function apiUrl(endpoint: string, repoType: string, repoId: string, suffix: string): string;
@@ -49,6 +83,13 @@ export declare function apiUrl(endpoint: string, repoType: string, repoId: strin
 export declare function revSegment(revision: string): string;
 export declare function repoUrl(endpoint: string, repoType: string, repoId: string): string;
 export declare function resolveUrl(endpoint: string, repoType: string, repoId: string, revision: string, path: string): string;
+/**
+ * A repo-relative path percent-encoded per segment, with no leading slash.
+ *
+ * A Hub repo or bucket may hold a file whose name carries a space or a "#",
+ * and pasting it raw truncates the URL at the fragment.
+ */
+export declare function quotePath(path: string): string;
 /**
  * Map a failing Hub response to the backend's own error.
  *
@@ -56,26 +97,38 @@ export declare function resolveUrl(endpoint: string, repoType: string, repoId: s
  * body, and the header is the one that survives a HEAD, so it is preferred.
  */
 export declare function errorOf(response: Response, text: string): Error;
-export declare function hubGet(token: string | undefined, url: string, params?: Record<string, string>): Promise<unknown>;
+export declare function hubGet(account: HfAccountAccessor, url: string, params?: Record<string, string>): Promise<unknown>;
 /** One GET retaining status and headers, which tree pagination reads. */
-export declare function hubGetResponse(token: string | undefined, url: string, params?: Record<string, string>): Promise<ApiResponse>;
-export declare function hubPost(token: string | undefined, url: string, body: unknown, params?: Record<string, string>): Promise<unknown>;
+export declare function hubGetResponse(account: HfAccountAccessor, url: string, params?: Record<string, string>): Promise<ApiResponse>;
+export declare function hubPost(account: HfAccountAccessor, url: string, body: unknown, params?: Record<string, string>): Promise<unknown>;
 /** One arbitrary JSON call, for the endpoints that are not GET or POST. */
-export declare function hubRequest(token: string | undefined, method: string, url: string, body: unknown, params?: Record<string, string>): Promise<unknown>;
+export declare function hubRequest(account: HfAccountAccessor, method: string, url: string, body: unknown, params?: Record<string, string>): Promise<unknown>;
 /** One newline-delimited-JSON POST, which is the commit endpoint's shape. */
-export declare function hubPostNdjson(token: string | undefined, url: string, payload: Uint8Array, params?: Record<string, string>): Promise<unknown>;
+export declare function hubPostNdjson(account: HfAccountAccessor, url: string, payload: Uint8Array, params?: Record<string, string>): Promise<unknown>;
 /**
  * Fetch file content, optionally a byte window of it.
  *
  * `/resolve` answers a redirect to the CDN and fetch follows it, carrying the
  * Range along, so a window costs no extra round trip.
  */
-export declare function hubBytes(token: string | undefined, url: string, window?: ByteWindow): Promise<Uint8Array>;
+export declare function hubBytes(account: HfAccountAccessor, url: string, window?: ByteWindow): Promise<Uint8Array>;
+/**
+ * Fetch file content together with the ETag the bytes came with.
+ *
+ * The ETag is the final response's, after the redirect to the CDN: the first
+ * hop answers for the LFS object, the last one for the bytes actually served,
+ * which is the only one that can vouch for them. The ETag is `''` when none.
+ */
+export declare function hubBytesTagged(account: HfAccountAccessor, url: string, window?: ByteWindow): Promise<[Uint8Array, string]>;
+/** An ETag header's value, without the weak marker or the quotes. */
+export declare function etagValue(raw: string): string;
 /**
  * Stream file content without holding it whole in memory.
  *
  * Not routed through `apiRequest`: that reads the body to completion before
- * returning, which is the opposite of what a stream is for.
+ * returning, which is the opposite of what a stream is for. `onResponse` is
+ * told the final response's headers, lower-cased, once and before the first
+ * chunk, so an empty file reports them too.
  */
-export declare function hubStream(token: string | undefined, url: string): AsyncIterable<Uint8Array>;
+export declare function hubStream(account: HfAccountAccessor, url: string, onResponse?: (headers: Record<string, string>) => void): AsyncIterable<Uint8Array>;
 //# sourceMappingURL=client.d.ts.map