@struktoai/mirage-node 0.0.5-alpha.1 → 0.0.6

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

@@ -0,0 +1,41 @@
+import { type HfConfig } from './config.ts';
+/**
+ * The organization and name halves the repo endpoints take.
+ *
+ * The create and delete endpoints do not take a `namespace/name` id: they take
+ * the two apart, and an id with no namespace means the caller's own, which the
+ * Hub fills in from the token.
+ */
+export declare function splitRepoId(repoId: string): [string | null, string];
+export interface CreateRepoOptions {
+    repoType?: string;
+    private?: boolean;
+    spaceSdk?: string | undefined;
+    /**
+     * Treat the Hub's 409 as success, answering with the repository url
+     * derived from the id rather than the one the create call would have
+     * returned.
+     */
+    existOk?: boolean;
+    /**
+     * The Enterprise resource group to create the repository in. Spelled
+     * `resourceGroupId` on the wire, which is huggingface_hub's own spelling.
+     */
+    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>;
+/** Tag a revision of a repository. */
+export declare function createTag(config: HfConfig, 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>;
+/**
+ * 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[]>;
+//# sourceMappingURL=admin.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/hf_hub/admin.js

@@ -0,0 +1,98 @@
+// ========= 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 { HfHubError, hubGet, hubPost, hubRequest, repoUrl, revSegment } from "./client.js";
+import { hfEndpoint } from "./config.js";
+import { API_SEGMENTS, DEFAULT_REVISION, HTTP_CONFLICT } from "./constants.js";
+/**
+ * The organization and name halves the repo endpoints take.
+ *
+ * The create and delete endpoints do not take a `namespace/name` id: they take
+ * the two apart, and an id with no namespace means the caller's own, which the
+ * Hub fills in from the token.
+ */
+export function splitRepoId(repoId) {
+    const cut = repoId.indexOf('/');
+    if (cut === -1)
+        return [null, repoId];
+    return [repoId.slice(0, cut), repoId.slice(cut + 1)];
+}
+function repoApiUrl(config, repoType, repoId, suffix) {
+    const segment = API_SEGMENTS[repoType] ?? 'models';
+    return `${hfEndpoint(config).replace(/\/+$/, '')}/api/${segment}/${repoId}${suffix}`;
+}
+/** Create a repository on the Hub. */
+export async function createRepo(config, repoId, options = {}) {
+    const [organization, name] = splitRepoId(repoId);
+    const body = {
+        name,
+        organization,
+        type: options.repoType ?? 'model',
+    };
+    if (options.private === true)
+        body.visibility = 'private';
+    if (options.spaceSdk !== undefined && options.spaceSdk !== '')
+        body.sdk = options.spaceSdk;
+    if (options.resourceGroupId !== undefined && options.resourceGroupId !== '') {
+        body.resourceGroupId = options.resourceGroupId;
+    }
+    const url = `${hfEndpoint(config).replace(/\/+$/, '')}/api/repos/create`;
+    let data;
+    try {
+        data = await hubPost(config.token, 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 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) {
+    const body = { tag };
+    if (message !== undefined)
+        body.message = message;
+    await hubPost(config.token, repoApiUrl(config, 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);
+}
+/**
+ * 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 async function listTags(config, repoId, repoType = 'model') {
+    const data = await hubGet(config.token, repoApiUrl(config, repoType, repoId, '/refs'));
+    const rows = data.tags;
+    const names = [];
+    for (const row of Array.isArray(rows) ? rows : []) {
+        if (typeof row === 'object' && row !== null) {
+            const name = row.name;
+            if (typeof name === 'string')
+                names.push(name);
+        }
+    }
+    return names;
+}
+//# sourceMappingURL=admin.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,47 @@
+import type { TreeEntry } from './tree_entry.ts';
+/**
+ * The one flat directory a repository's cache lives under.
+ *
+ * Upstream's own spelling (`file_download.repo_folder_name`): the plural kind
+ * and the two halves of the id joined by `--`, so `julien-c/EsperBERTo-small`
+ * as a model is `models--julien-c--EsperBERTo-small`. Flattening is the point:
+ * a namespace holding a slash would otherwise nest, and two repos could
+ * collide across kinds.
+ */
+export declare function repoFolderName(repoId: string, repoType: string): string;
+/**
+ * The name a file's bytes are cached under.
+ *
+ * Upstream keys a blob by the ETag the resolve endpoint answered, which is the
+ * LFS sha256 for a pointer-backed file and the git blob oid for an ordinary
+ * one. Both are content addresses, which is what makes the blob shareable
+ * between revisions: two snapshots of an unchanged file link to one blob.
+ */
+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;
+/** The directory one commit's tree is rendered under. */
+export declare function snapshotDir(cacheDir: string, folder: string, sha: string): string;
+/** Where one file appears within a commit's rendered tree. */
+export declare function snapshotPath(cacheDir: string, folder: string, sha: string, repoPath: string): string;
+/** The file recording which commit a branch or tag points at. */
+export declare function refPath(cacheDir: string, folder: string, revision: string): string;
+/**
+ * The relative target a snapshot entry points at.
+ *
+ * Relative, not absolute, because upstream's cache is relocatable: a whole
+ * cache directory can be moved or copied and every link still resolves.
+ * Derived from the entry's own depth rather than counted out, so a nested path
+ * cannot get the number of `..` hops wrong.
+ */
+export declare function linkTarget(repoPath: string, etag: string): string;
+/**
+ * The cache root the session names, in upstream's own order.
+ *
+ * Upstream reads `HF_HUB_CACHE` first and falls back to `HF_HOME/hub`, then to
+ * `~/.cache/huggingface/hub`. A workspace has no home directory, so the last
+ * step is the one that cannot be taken and the caller reports that rather than
+ * inventing a path.
+ */
+export declare function cacheRoot(env: Readonly<Record<string, string>>): string | null;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/hf_hub/cache.js

@@ -0,0 +1,81 @@
+// ========= 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 { REPO_ID_SEPARATOR } from "./constants.js";
+/**
+ * The one flat directory a repository's cache lives under.
+ *
+ * Upstream's own spelling (`file_download.repo_folder_name`): the plural kind
+ * and the two halves of the id joined by `--`, so `julien-c/EsperBERTo-small`
+ * as a model is `models--julien-c--EsperBERTo-small`. Flattening is the point:
+ * a namespace holding a slash would otherwise nest, and two repos could
+ * collide across kinds.
+ */
+export function repoFolderName(repoId, repoType) {
+    return [`${repoType}s`, ...repoId.split('/')].join(REPO_ID_SEPARATOR);
+}
+/**
+ * The name a file's bytes are cached under.
+ *
+ * Upstream keys a blob by the ETag the resolve endpoint answered, which is the
+ * LFS sha256 for a pointer-backed file and the git blob oid for an ordinary
+ * one. Both are content addresses, which is what makes the blob shareable
+ * between revisions: two snapshots of an unchanged file link to one blob.
+ */
+export function etagOf(entry) {
+    return entry.lfsOid !== '' ? entry.lfsOid : entry.oid;
+}
+/** Where one file's bytes live, shared across every snapshot. */
+export function blobPath(cacheDir, folder, etag) {
+    return `${cacheDir}/${folder}/blobs/${etag}`;
+}
+/** The directory one commit's tree is rendered under. */
+export function snapshotDir(cacheDir, folder, sha) {
+    return `${cacheDir}/${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}`;
+}
+/** The file recording which commit a branch or tag points at. */
+export function refPath(cacheDir, folder, revision) {
+    return `${cacheDir}/${folder}/refs/${revision}`;
+}
+/**
+ * The relative target a snapshot entry points at.
+ *
+ * Relative, not absolute, because upstream's cache is relocatable: a whole
+ * cache directory can be moved or copied and every link still resolves.
+ * Derived from the entry's own depth rather than counted out, so a nested path
+ * cannot get the number of `..` hops wrong.
+ */
+export function linkTarget(repoPath, etag) {
+    const depth = repoPath.split('/').length - 1;
+    return `${'../'.repeat(depth + 2)}blobs/${etag}`;
+}
+/**
+ * The cache root the session names, in upstream's own order.
+ *
+ * Upstream reads `HF_HUB_CACHE` first and falls back to `HF_HOME/hub`, then to
+ * `~/.cache/huggingface/hub`. A workspace has no home directory, so the last
+ * step is the one that cannot be taken and the caller reports that rather than
+ * inventing a path.
+ */
+export function cacheRoot(env) {
+    const direct = env.HF_HUB_CACHE;
+    if (direct !== undefined && direct !== '')
+        return direct;
+    const home = env.HF_HOME;
+    return home !== undefined && home !== '' ? `${home}/hub` : null;
+}
+//# sourceMappingURL=cache.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,81 @@
+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;
+/** A Hub call that answered with a status the caller cannot use. */
+export declare class HfHubError extends Error {
+    /**
+     * The Hub's `X-Error-Code`, '' when it sent none. The status alone cannot
+     * tell its refusals apart: a missing repository, a missing revision and a
+     * missing file are all 404, and only this header says which
+     * (`RepoNotFound` / `RevisionNotFound` / `EntryNotFound`).
+     */
+    readonly errorCode: string;
+    constructor(message: string, status: number, errorCode?: string);
+    readonly status: number;
+}
+/**
+ * Auth and accept headers for one Hub call.
+ *
+ * An anonymous call is a first-class case here, unlike GitHub's: the Hub
+ * serves every public repo without a token, so a mount with no credential
+ * reads normally and only the write path needs one.
+ */
+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;
+/**
+ * The content URL for one file at one revision.
+ *
+ * The path is percent-encoded per segment: a Hub repo may hold a file whose
+ * name carries a space or a "#", and pasting it raw truncates the URL at the
+ * fragment.
+ */
+/**
+ * The web URL of a repository, which is what the CLI echoes.
+ *
+ * A model sits at the origin root and the other two kinds sit under a
+ * plural segment, the same split `resolveUrl` walks.
+ */
+/**
+ * One revision, encoded as a single URL path segment.
+ *
+ * A git ref may hold a slash (`feature/foo`, `refs/pr/1`), and every Hub
+ * route reads the segment after the verb as the whole revision, so an
+ * unencoded one splits: `/tree/feature/foo` names revision `feature` and
+ * subtree `foo`. The extra replace is what makes this identical to
+ * python's `quote(revision, safe="")`, which encodes the four characters
+ * `encodeURIComponent` leaves alone.
+ */
+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;
+/**
+ * Map a failing Hub response to the backend's own error.
+ *
+ * The Hub reports its reason in an `X-Error-Message` header as well as in the
+ * 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>;
+/** 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>;
+/** 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>;
+/** 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>;
+/**
+ * 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>;
+/**
+ * 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.
+ */
+export declare function hubStream(token: string | undefined, url: string): AsyncIterable<Uint8Array>;
+//# sourceMappingURL=client.d.ts.map

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

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

package/dist/core/hf_hub/client.js

@@ -0,0 +1,197 @@
+// ========= 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 { apiRequest } from '@struktoai/mirage-core/core/api/client';
+import { API_SEGMENTS, MAX_RETRIES, RESOLVE_SEGMENTS, RETRY_STATUSES } from "./constants.js";
+export const RETRY = {
+    statuses: RETRY_STATUSES,
+    maxRetries: MAX_RETRIES,
+    maxBackoff: 30,
+    delaySource: 'header',
+    retryTransport: true,
+};
+/** A Hub call that answered with a status the caller cannot use. */
+export class HfHubError extends Error {
+    /**
+     * The Hub's `X-Error-Code`, '' when it sent none. The status alone cannot
+     * tell its refusals apart: a missing repository, a missing revision and a
+     * missing file are all 404, and only this header says which
+     * (`RepoNotFound` / `RevisionNotFound` / `EntryNotFound`).
+     */
+    errorCode;
+    constructor(message, status, errorCode = '') {
+        super(message);
+        this.name = 'HfHubError';
+        this.status = status;
+        this.errorCode = errorCode;
+    }
+    status;
+}
+/**
+ * Auth and accept headers for one Hub call.
+ *
+ * An anonymous call is a first-class case here, unlike GitHub's: the Hub
+ * serves every public repo without a token, so a mount with no credential
+ * reads normally and only the write path needs one.
+ */
+export function hubHeaders(token) {
+    const headers = { Accept: 'application/json' };
+    if (token !== undefined && token !== '')
+        headers.Authorization = `Bearer ${token}`;
+    return headers;
+}
+/** The /api URL for one repository-scoped endpoint. */
+export function apiUrl(endpoint, repoType, repoId, suffix) {
+    const segment = API_SEGMENTS[repoType] ?? 'models';
+    return `${endpoint.replace(/\/+$/, '')}/api/${segment}/${repoId}${suffix}`;
+}
+/**
+ * The content URL for one file at one revision.
+ *
+ * The path is percent-encoded per segment: a Hub repo may hold a file whose
+ * name carries a space or a "#", and pasting it raw truncates the URL at the
+ * fragment.
+ */
+/**
+ * The web URL of a repository, which is what the CLI echoes.
+ *
+ * A model sits at the origin root and the other two kinds sit under a
+ * plural segment, the same split `resolveUrl` walks.
+ */
+/**
+ * One revision, encoded as a single URL path segment.
+ *
+ * A git ref may hold a slash (`feature/foo`, `refs/pr/1`), and every Hub
+ * route reads the segment after the verb as the whole revision, so an
+ * unencoded one splits: `/tree/feature/foo` names revision `feature` and
+ * subtree `foo`. The extra replace is what makes this identical to
+ * python's `quote(revision, safe="")`, which encodes the four characters
+ * `encodeURIComponent` leaves alone.
+ */
+export function revSegment(revision) {
+    return encodeURIComponent(revision).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+export function repoUrl(endpoint, repoType, repoId) {
+    const segment = RESOLVE_SEGMENTS[repoType] ?? '';
+    const base = `${endpoint.replace(/\/+$/, '')}/${segment === '' ? '' : `${segment}/`}`;
+    return `${base}${repoId}`;
+}
+export function resolveUrl(endpoint, repoType, repoId, revision, path) {
+    const segment = RESOLVE_SEGMENTS[repoType] ?? '';
+    const base = `${endpoint.replace(/\/+$/, '')}/${segment === '' ? '' : `${segment}/`}`;
+    const encoded = path
+        .replace(/^\/+/, '')
+        .split('/')
+        .map((part) => encodeURIComponent(part))
+        .join('/');
+    return `${base}${repoId}/resolve/${revSegment(revision)}/${encoded}`;
+}
+/**
+ * Map a failing Hub response to the backend's own error.
+ *
+ * The Hub reports its reason in an `X-Error-Message` header as well as in the
+ * body, and the header is the one that survives a HEAD, so it is preferred.
+ */
+export function errorOf(response, text) {
+    const header = response.headers.get('X-Error-Message');
+    const message = header ?? text.trim();
+    const fallback = response.statusText === '' ? 'request failed' : response.statusText;
+    return new HfHubError(message === '' ? fallback : message, response.status, response.headers.get('X-Error-Code') ?? '');
+}
+export async function hubGet(token, url, params) {
+    return apiRequest('GET', url, {
+        errorOf,
+        headers: hubHeaders(token),
+        params,
+        retry: RETRY,
+    });
+}
+/** One GET retaining status and headers, which tree pagination reads. */
+export async function hubGetResponse(token, url, params) {
+    return (await apiRequest('GET', url, {
+        errorOf,
+        headers: hubHeaders(token),
+        params,
+        retry: RETRY,
+        read: 'response',
+    }));
+}
+export async function hubPost(token, url, body, params) {
+    return apiRequest('POST', url, {
+        errorOf,
+        headers: hubHeaders(token),
+        params,
+        json: body,
+        retry: RETRY,
+    });
+}
+/** One arbitrary JSON call, for the endpoints that are not GET or POST. */
+export async function hubRequest(token, method, url, body, params) {
+    const options = {
+        errorOf,
+        headers: hubHeaders(token),
+        params,
+        retry: RETRY,
+    };
+    if (body !== null && body !== undefined)
+        options.json = body;
+    return apiRequest(method.toUpperCase(), url, options);
+}
+/** One newline-delimited-JSON POST, which is the commit endpoint's shape. */
+export async function hubPostNdjson(token, url, payload, params) {
+    return apiRequest('POST', url, {
+        errorOf,
+        headers: { ...hubHeaders(token), 'Content-Type': 'application/x-ndjson' },
+        params,
+        body: payload,
+        retry: RETRY,
+    });
+}
+/**
+ * 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 async function hubBytes(token, url, window) {
+    return (await apiRequest('GET', url, {
+        errorOf,
+        headers: hubHeaders(token),
+        retry: RETRY,
+        read: 'bytes',
+        window,
+    }));
+}
+/**
+ * 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.
+ */
+export async function* hubStream(token, url) {
+    const response = await fetch(url, { headers: hubHeaders(token) });
+    if (response.status >= 400)
+        throw errorOf(response, await response.text());
+    const body = response.body;
+    if (body === null)
+        return;
+    const reader = body.getReader();
+    for (;;) {
+        const chunk = await reader.read();
+        if (chunk.done)
+            break;
+        if (chunk.value !== undefined)
+            yield chunk.value;
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,54 @@
+import type { HfHubAccessor } from '../../accessor/hf_hub.ts';
+/** One file a commit adds or replaces. */
+export interface Addition {
+    path: string;
+    data: Uint8Array;
+}
+/**
+ * A write the Hub will only accept through the LFS/Xet upload path.
+ *
+ * Thrown rather than papered over, because the alternative is a commit that
+ * references content the Hub never received: the file would appear in the
+ * tree and every read of it would fail. Which files land here is the
+ * repository's own `.gitattributes` plus a size threshold, so it is the
+ * repo's decision, not a fixed byte count this code could apply.
+ */
+export declare class LfsRequiredError extends Error {
+    constructor(message: string);
+}
+/** The commit endpoint for one revision. */
+export declare function commitUrl(accessor: HfHubAccessor, revision?: string): string;
+/**
+ * Ask the Hub how each file must be uploaded.
+ *
+ * The Hub decides regular-vs-LFS-vs-Xet from the repository's
+ * `.gitattributes` and the file's size, so it is asked rather than guessed. It
+ * only needs the first bytes to sniff the type, which is why a sample rather
+ * than the content is sent.
+ */
+export declare function uploadModes(accessor: HfHubAccessor, additions: Addition[], revision?: string): Promise<Map<string, string>>;
+/**
+ * Serialize one commit as newline-delimited JSON.
+ *
+ * The header line comes first and carries the message; every operation is one
+ * line after it. This is the Hub's own shape, not a convention chosen here.
+ */
+export declare function payload(additions: Addition[], deletions: string[], folders: string[], message: string, description?: string, parent?: string): Uint8Array;
+export interface CommitOptions {
+    additions?: Addition[];
+    deletions?: string[];
+    folders?: string[];
+    message?: string;
+    description?: string;
+    createPr?: boolean;
+    revision?: string;
+}
+/**
+ * Apply one commit to the repository.
+ *
+ * Every addition is checked against the preupload endpoint first, and a file
+ * the Hub wants uploaded out of band is refused here rather than referenced by
+ * a commit whose content never arrived.
+ */
+export declare function commit(accessor: HfHubAccessor, options?: CommitOptions): Promise<Record<string, unknown>>;
+//# sourceMappingURL=commit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../src/core/hf_hub/commit.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAU7D,0CAA0C;AAC1C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAA;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAMD,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA+B9B;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,QAAQ,EAAE,EACrB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,SAAK,EAChB,MAAM,SAAK,GACV,UAAU,CAaZ;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4BlC"}