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

package/dist/commands/cli/builtin/hf/index.js

@@ -0,0 +1,286 @@
+// ========= 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 { registerCliSpec } from '@struktoai/mirage-core/commands/cli/specs';
+import { CLISpec } from '@struktoai/mirage-core/commands/cli/types';
+import { Operand, Option } from '@struktoai/mirage-core/commands/spec/index';
+import { ResourceName } from '@struktoai/mirage-core/types';
+import { HfConfigSchema } from "../../../../core/hf_hub/config.js";
+import { listCmd, whoamiCmd } from "./auth.js";
+import { downloadCmd } from "./download.js";
+import { envCmd, versionCmd } from "./env.js";
+import { deleteCmd } from "./files.js";
+import { createCmd, tagCreateCmd, tagDeleteCmd, tagListCmd } from "./repo.js";
+import { uploadCmd } from "./upload.js";
+// Upstream `hf` is argparse, not clap, so the default UsageStyle already
+// words its refusals ("hf: error: argument ...: invalid choice: 'x'",
+// exit 2). There is no dialect to add for this one.
+const REPO_TYPE = new Option({
+    long: '--repo-type',
+    type: 'str',
+    choices: ['model', 'dataset', 'space'],
+    default: 'model',
+    metavar: 'REPO_TYPE',
+    description: "Type of repo (defaults to 'model')",
+});
+const REVISION = new Option({
+    long: '--revision',
+    type: 'str',
+    metavar: 'REVISION',
+    description: 'A branch name, a tag, or a commit hash',
+});
+const INCLUDE = new Option({
+    long: '--include',
+    type: 'str',
+    multiple: true,
+    metavar: 'INCLUDE',
+    description: 'Glob patterns to match files',
+});
+const EXCLUDE = new Option({
+    long: '--exclude',
+    type: 'str',
+    multiple: true,
+    metavar: 'EXCLUDE',
+    description: 'Glob patterns to exclude files',
+});
+const COMMIT_MESSAGE = new Option({
+    long: '--commit-message',
+    type: 'str',
+    metavar: 'COMMIT_MESSAGE',
+    description: 'The summary of the generated commit',
+});
+const COMMIT_DESCRIPTION = new Option({
+    long: '--commit-description',
+    type: 'str',
+    metavar: 'COMMIT_DESCRIPTION',
+    description: 'The description of the generated commit',
+});
+const CREATE_PR = new Option({
+    long: '--create-pr',
+    description: 'Upload the content as a new Pull Request',
+});
+const QUIET = new Option({
+    long: '--quiet',
+    description: 'Print only the path to the downloaded files',
+});
+const PRIVATE = new Option({
+    long: '--private',
+    description: 'Create a private repo if it does not exist yet',
+});
+const REPO_ID = new Operand({ type: 'str', name: 'REPO_ID', required: true });
+const AUTH = new CLISpec({
+    name: 'auth',
+    description: 'Manage authentication (login, logout, etc.).',
+    subcommands: [
+        new CLISpec({
+            name: 'whoami',
+            description: 'Find out which huggingface.co account you are logged in as.',
+            fn: whoamiCmd,
+        }),
+        new CLISpec({
+            name: 'list',
+            description: 'List all stored access tokens',
+            fn: listCmd,
+        }),
+    ],
+});
+// Upstream spells this one with an underscore, alone among hf's
+// options. Mimicking a program means mimicking its typos.
+const SPACE_SDK = new Option({
+    long: '--space_sdk',
+    type: 'str',
+    choices: ['gradio', 'streamlit', 'docker', 'static'],
+    metavar: 'SPACE_SDK',
+    description: 'The SDK a Space runs on; required for --repo-type space',
+});
+const TAG = new Operand({ type: 'str', name: 'TAG', required: true });
+const REPO_TAG = new CLISpec({
+    name: 'tag',
+    description: 'Manage tags for a repo on the Hub.',
+    subcommands: [
+        new CLISpec({
+            name: 'create',
+            description: 'Create a tag for a repo.',
+            fn: tagCreateCmd,
+            write: true,
+            positional: [REPO_ID, TAG],
+            options: [
+                new Option({
+                    short: '-m',
+                    long: '--message',
+                    type: 'str',
+                    metavar: 'MESSAGE',
+                    description: 'The description of the tag to create',
+                }),
+                REVISION,
+                REPO_TYPE,
+            ],
+        }),
+        new CLISpec({
+            name: 'list',
+            description: 'List tags for a repo.',
+            fn: tagListCmd,
+            positional: [REPO_ID],
+            options: [REPO_TYPE],
+        }),
+        new CLISpec({
+            name: 'delete',
+            description: 'Delete a tag from a repo.',
+            fn: tagDeleteCmd,
+            write: true,
+            positional: [REPO_ID, TAG],
+            options: [
+                new Option({
+                    short: '-y',
+                    long: '--yes',
+                    description: 'Answer Yes to prompts automatically',
+                }),
+                REPO_TYPE,
+            ],
+        }),
+    ],
+});
+const REPO = new CLISpec({
+    name: 'repo',
+    description: 'Manage repos on the Hub.',
+    subcommands: [
+        new CLISpec({
+            name: 'create',
+            description: 'Create a new repo on huggingface.co',
+            fn: createCmd,
+            write: true,
+            positional: [REPO_ID],
+            options: [
+                REPO_TYPE,
+                PRIVATE,
+                SPACE_SDK,
+                new Option({
+                    long: '--exist-ok',
+                    description: 'Do not raise an error if repo already exists',
+                }),
+                new Option({
+                    long: '--resource-group-id',
+                    type: 'str',
+                    metavar: 'RESOURCE_GROUP_ID',
+                    description: 'Resource group in which to create the repo. Resource groups is only available for Enterprise Hub organizations.',
+                }),
+            ],
+        }),
+        REPO_TAG,
+    ],
+});
+const REPO_FILES = new CLISpec({
+    name: 'repo-files',
+    description: 'Manage files in a repo on the Hub.',
+    subcommands: [
+        new CLISpec({
+            name: 'delete',
+            description: 'Delete files from a repo on the Hub',
+            fn: deleteCmd,
+            write: true,
+            positional: [
+                REPO_ID,
+                new Operand({ type: 'str', name: 'PATTERNS', required: true, remainder: true }),
+            ],
+            options: [REPO_TYPE, REVISION, COMMIT_MESSAGE, COMMIT_DESCRIPTION, CREATE_PR],
+        }),
+    ],
+});
+export const HF = new CLISpec({
+    name: 'hf',
+    description: 'hf command helpers',
+    configModel: HfConfigSchema,
+    serves: [ResourceName.HF_MODELS, ResourceName.HF_DATASETS, ResourceName.HF_SPACES],
+    subcommands: [
+        AUTH,
+        REPO,
+        REPO_FILES,
+        new CLISpec({
+            name: 'download',
+            description: 'Download files from the Hub',
+            fn: downloadCmd,
+            write: true,
+            positional: [REPO_ID, new Operand({ type: 'str', name: 'FILENAMES', remainder: true })],
+            options: [
+                REPO_TYPE,
+                REVISION,
+                INCLUDE,
+                EXCLUDE,
+                new Option({
+                    long: '--cache-dir',
+                    type: 'str',
+                    metavar: 'CACHE_DIR',
+                    description: 'Workspace directory to hold the cache; defaults to HF_HUB_CACHE or HF_HOME/hub from the session',
+                }),
+                new Option({
+                    long: '--force-download',
+                    description: 'Download even when the cache already holds the file',
+                }),
+                new Option({
+                    long: '--local-dir',
+                    type: 'str',
+                    metavar: 'LOCAL_DIR',
+                    description: 'Download straight into this directory, with no cache in between',
+                }),
+                new Option({
+                    long: '--max-workers',
+                    type: 'int',
+                    metavar: 'MAX_WORKERS',
+                    description: 'Maximum number of workers to use for downloading files. Default is 8.',
+                }),
+                QUIET,
+            ],
+        }),
+        new CLISpec({
+            name: 'upload',
+            description: 'Upload a file or a folder to the Hub. Recommended for single-commit uploads.',
+            fn: uploadCmd,
+            write: true,
+            positional: [
+                REPO_ID,
+                new Operand({ type: 'str', name: 'LOCAL_PATH' }),
+                new Operand({ type: 'str', name: 'PATH_IN_REPO' }),
+            ],
+            options: [
+                REPO_TYPE,
+                REVISION,
+                PRIVATE,
+                INCLUDE,
+                EXCLUDE,
+                new Option({
+                    long: '--delete',
+                    type: 'str',
+                    multiple: true,
+                    metavar: 'DELETE',
+                    description: 'Glob patterns for files to delete from the repo while committing',
+                }),
+                COMMIT_MESSAGE,
+                COMMIT_DESCRIPTION,
+                CREATE_PR,
+                QUIET,
+            ],
+        }),
+        new CLISpec({
+            name: 'env',
+            description: 'Print information about the environment.',
+            fn: envCmd,
+        }),
+        new CLISpec({
+            name: 'version',
+            description: 'Print information about the hf version.',
+            fn: versionCmd,
+        }),
+    ],
+});
+registerCliSpec(HF);
+//# sourceMappingURL=index.js.map

package/dist/commands/cli/builtin/hf/index.js.map

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

package/dist/commands/cli/builtin/hf/repo.d.ts

@@ -0,0 +1,16 @@
+import type { CLIInvocation } from '@struktoai/mirage-core/commands/cli/types';
+import type { CommandFnResult } from '@struktoai/mirage-core/commands/config';
+/** Create a repository on the Hub. */
+export declare function createCmd(inv: CLIInvocation): Promise<CommandFnResult>;
+/** Tag a revision of a repository. */
+export declare function tagCreateCmd(inv: CLIInvocation): Promise<CommandFnResult>;
+/** List a repository's tags. */
+export declare function tagListCmd(inv: CLIInvocation): Promise<CommandFnResult>;
+/**
+ * Delete a tag from a repository.
+ *
+ * Upstream asks for confirmation before deleting; a workspace has no terminal,
+ * so the answer arrives either as `-y` or on stdin.
+ */
+export declare function tagDeleteCmd(inv: CLIInvocation): Promise<CommandFnResult>;
+//# sourceMappingURL=repo.d.ts.map

package/dist/commands/cli/builtin/hf/repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../../../src/commands/cli/builtin/hf/repo.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAU7E,sCAAsC;AACtC,wBAAsB,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAyB5E;AAED,sCAAsC;AACtC,wBAAsB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAe/E;AAED,gCAAgC;AAChC,wBAAsB,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAK7E;AAmBD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAa/E"}

package/dist/commands/cli/builtin/hf/repo.js

@@ -0,0 +1,97 @@
+// ========= 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 { UsageError } from '@struktoai/mirage-core/commands/errors';
+import { FlagView } from '@struktoai/mirage-core/commands/spec/index';
+import { materialize } from '@struktoai/mirage-core/io/types';
+import { createRepo, createTag, deleteTag, listTags } from "../../../../core/hf_hub/admin.js";
+import { repoUrl } from "../../../../core/hf_hub/client.js";
+import { hfEndpoint } from "../../../../core/hf_hub/config.js";
+import { DEFAULT_REVISION } from "../../../../core/hf_hub/constants.js";
+import { repoTypeOf, requireOperands, requireToken, textOut } from "./accessor.js";
+/** Create a repository on the Hub. */
+export async function createCmd(inv) {
+    requireOperands(inv, ['repo_id']);
+    requireToken(inv, 'repo create');
+    const fl = new FlagView(inv.flags);
+    const config = inv.config;
+    const repoId = inv.texts[0] ?? '';
+    const repoType = repoTypeOf(fl);
+    const sdk = fl.asStr('space_sdk');
+    if (repoType === 'space' && (sdk === undefined || sdk === '')) {
+        throw new UsageError('creating a space requires --space_sdk (gradio, streamlit, docker or static)');
+    }
+    const result = await createRepo(config, repoId, {
+        repoType,
+        private: fl.asBool('private'),
+        spaceSdk: sdk,
+        existOk: fl.asBool('exist_ok'),
+        resourceGroupId: fl.asStr('resource_group_id'),
+    });
+    const url = result.url;
+    return textOut(typeof url === 'string' ? `${url}\n` : `${repoUrl(hfEndpoint(config), repoType, repoId)}\n`, true);
+}
+/** Tag a revision of a repository. */
+export async function tagCreateCmd(inv) {
+    requireOperands(inv, ['repo_id', 'tag']);
+    requireToken(inv, 'repo tag create');
+    const fl = new FlagView(inv.flags);
+    const repoId = inv.texts[0] ?? '';
+    const tag = inv.texts[1] ?? '';
+    await createTag(inv.config, repoId, tag, repoTypeOf(fl), fl.asStr('revision') ?? DEFAULT_REVISION, fl.asStr('message'));
+    return textOut(`Tag ${tag} created on ${repoId}\n`, true);
+}
+/** List a repository's tags. */
+export async function tagListCmd(inv) {
+    requireOperands(inv, ['repo_id']);
+    const fl = new FlagView(inv.flags);
+    const tags = await listTags(inv.config, inv.texts[0] ?? '', repoTypeOf(fl));
+    return textOut(tags.map((name) => `${name}\n`).join(''));
+}
+/**
+ * Whether the line agreed to a destructive action.
+ *
+ * Upstream asks on stdin and takes `-y` to skip the question, so both routes
+ * are honored: `-y` short-circuits, and otherwise the piped answer is read the
+ * way `input()` would read it. A line with nothing piped is the case upstream
+ * cannot reach, since a workspace has no terminal to fall back to, and it
+ * declines rather than assuming yes.
+ */
+async function confirmed(inv) {
+    if (new FlagView(inv.flags).asBool('yes'))
+        return true;
+    if (inv.stdin === null)
+        return false;
+    const answer = new TextDecoder().decode(await materialize(inv.stdin));
+    const trimmed = answer.trim().toLowerCase();
+    return trimmed === 'y' || trimmed === 'yes';
+}
+/**
+ * Delete a tag from a repository.
+ *
+ * Upstream asks for confirmation before deleting; a workspace has no terminal,
+ * so the answer arrives either as `-y` or on stdin.
+ */
+export async function tagDeleteCmd(inv) {
+    requireOperands(inv, ['repo_id', 'tag']);
+    requireToken(inv, 'repo tag delete');
+    const fl = new FlagView(inv.flags);
+    const repoId = inv.texts[0] ?? '';
+    const tag = inv.texts[1] ?? '';
+    if (!(await confirmed(inv))) {
+        throw new UsageError(`deleting tag ${tag} needs -y, or y on stdin: there is no terminal to confirm on`);
+    }
+    await deleteTag(inv.config, repoId, tag, repoTypeOf(fl));
+    return textOut(`Tag ${tag} deleted on ${repoId}\n`, true);
+}
+//# sourceMappingURL=repo.js.map

package/dist/commands/cli/builtin/hf/repo.js.map

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

package/dist/commands/cli/builtin/hf/upload.d.ts

@@ -0,0 +1,21 @@
+import type { CLIInvocation } from '@struktoai/mirage-core/commands/cli/types';
+import type { CommandFnResult } from '@struktoai/mirage-core/commands/config';
+interface Row {
+    name: string;
+    data: Uint8Array;
+}
+/** Apply the line's --include and --exclude globs. */
+export declare function keep(rows: Row[], include: readonly string[], exclude: readonly string[]): Row[];
+/**
+ * The repo-relative directory an upload's third operand names.
+ *
+ * A Hub path is repo-relative with no leading slash and no `.` component, so
+ * the operand is normalized rather than used verbatim: `hf upload repo /local .`
+ * means the repository root, and taking the dot literally stored every file
+ * under `./`, which is a path the resolve endpoint then could not find.
+ */
+export declare function inRepoBase(value: string): string;
+/** Upload a workspace file or folder to a repository, as one commit. */
+export declare function uploadCmd(inv: CLIInvocation): Promise<CommandFnResult>;
+export {};
+//# sourceMappingURL=upload.d.ts.map

package/dist/commands/cli/builtin/hf/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../../../src/commands/cli/builtin/hf/upload.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAe7E,UAAU,GAAG;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAA;CACjB;AA2DD,sDAAsD;AACtD,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,EAAE,CAS/F;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAehD;AAED,wEAAwE;AACxE,wBAAsB,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CA0D5E"}

package/dist/commands/cli/builtin/hf/upload.js

@@ -0,0 +1,178 @@
+// ========= 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 { UsageError } from '@struktoai/mirage-core/commands/errors';
+import { FlagView } from '@struktoai/mirage-core/commands/spec/index';
+import { FileType, PathSpec } from '@struktoai/mirage-core/types';
+import { isMissingPath } from '@struktoai/mirage-core/utils/errors';
+import { fnmatch } from '@struktoai/mirage-core/utils/fnmatch';
+import { createRepo } from "../../../../core/hf_hub/admin.js";
+import { repoUrl } from "../../../../core/hf_hub/client.js";
+import { commit } from "../../../../core/hf_hub/commit.js";
+import { DEFAULT_COMMIT_MESSAGE } from "../../../../core/hf_hub/constants.js";
+import { hubFor, repoTypeOf, requireOperands, requireToken, textOut } from "./accessor.js";
+import { refuseVariadic } from "./download.js";
+async function isDir(dispatch, path) {
+    const [stat] = await dispatch('stat', PathSpec.fromStrPath(path));
+    return stat?.type === FileType.DIRECTORY;
+}
+/**
+ * Read a workspace file, or every file under a workspace directory.
+ *
+ * Read through the op dispatcher rather than any filesystem of its own: an
+ * account CLI has no mount, and the path the line named is an unrelated
+ * workspace file, which is exactly what the dispatcher door is for.
+ *
+ * Reports whether `local` was a directory, because the caller needs it:
+ * upstream reads `path_in_repo` as the destination FILE for a file source and
+ * as the destination FOLDER for a directory one, so a file uploaded to
+ * `u.txt` must land at `u.txt` and not at `u.txt/u.txt`.
+ */
+async function collect(dispatch, local) {
+    const base = local.replace(/\/+$/, '');
+    let directory;
+    try {
+        directory = await isDir(dispatch, base);
+    }
+    catch (err) {
+        if (isMissingPath(err))
+            throw new UsageError(`${local}: No such file or directory`);
+        throw err;
+    }
+    if (!directory) {
+        const [data] = await dispatch('read', PathSpec.fromStrPath(base));
+        return {
+            rows: [{ name: base.slice(base.lastIndexOf('/') + 1), data: data }],
+            fromDir: false,
+        };
+    }
+    const rows = [];
+    const pending = [base];
+    while (pending.length > 0) {
+        const current = pending.pop() ?? '';
+        const [entries] = await dispatch('readdir', PathSpec.fromStrPath(current));
+        for (const entry of entries) {
+            const child = entry.startsWith('/') ? entry : `${current}/${entry}`;
+            if (await isDir(dispatch, child)) {
+                pending.push(child);
+                continue;
+            }
+            const [data] = await dispatch('read', PathSpec.fromStrPath(child));
+            rows.push({ name: child.slice(base.length + 1), data: data });
+        }
+    }
+    return {
+        rows: rows.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0)),
+        fromDir: true,
+    };
+}
+/** Apply the line's --include and --exclude globs. */
+export function keep(rows, include, exclude) {
+    let out = rows;
+    if (include.length > 0) {
+        out = out.filter((row) => include.some((pattern) => fnmatch(row.name, pattern)));
+    }
+    if (exclude.length > 0) {
+        out = out.filter((row) => !exclude.some((pattern) => fnmatch(row.name, pattern)));
+    }
+    return out;
+}
+/**
+ * The repo-relative directory an upload's third operand names.
+ *
+ * A Hub path is repo-relative with no leading slash and no `.` component, so
+ * the operand is normalized rather than used verbatim: `hf upload repo /local .`
+ * means the repository root, and taking the dot literally stored every file
+ * under `./`, which is a path the resolve endpoint then could not find.
+ */
+export function inRepoBase(value) {
+    const cleaned = value.trim();
+    if (cleaned === '')
+        return '';
+    const parts = [];
+    for (const part of cleaned.split('/')) {
+        if (part === '' || part === '.')
+            continue;
+        if (part === '..') {
+            if (parts.pop() === undefined) {
+                throw new UsageError(`path_in_repo must stay inside the repository: ${value}`);
+            }
+            continue;
+        }
+        parts.push(part);
+    }
+    return parts.join('/');
+}
+/** Upload a workspace file or folder to a repository, as one commit. */
+export async function uploadCmd(inv) {
+    requireOperands(inv, ['repo_id']);
+    requireToken(inv, 'upload');
+    const fl = new FlagView(inv.flags);
+    const dispatch = inv.doors?.dispatch;
+    if (dispatch === undefined) {
+        throw new UsageError('hf upload needs a workspace to read from');
+    }
+    const repoId = inv.texts[0] ?? '';
+    const operands = inv.texts.slice(1);
+    const include = fl.asList('include');
+    const exclude = fl.asList('exclude');
+    const deletions = fl.asList('delete');
+    for (const [patterns, flag] of [
+        [include, '--include'],
+        [exclude, '--exclude'],
+        [deletions, '--delete'],
+    ]) {
+        if (patterns.length > 0)
+            refuseVariadic(operands, flag, patterns);
+    }
+    const local = operands[0] ?? '.';
+    const inRepo = operands[1] ?? '';
+    const collected = await collect(dispatch, local);
+    const rows = keep(collected.rows, include, exclude);
+    if (rows.length === 0)
+        throw new UsageError(`no files matched under ${local}`);
+    const base = inRepoBase(inRepo);
+    // A directory source spreads under `path_in_repo`; a file source lands AT
+    // it. Appending the basename either way stored `hf upload r f.txt f.txt` at
+    // `f.txt/f.txt`, which the tree then reported as a directory and
+    // `hf download` could not find at all.
+    const additions = collected.fromDir
+        ? rows.map((row) => ({ path: base === '' ? row.name : `${base}/${row.name}`, data: row.data }))
+        : [
+            {
+                path: base === '' ? (rows[0]?.name ?? '') : base,
+                data: rows[0]?.data ?? new Uint8Array(),
+            },
+        ];
+    const repoType = repoTypeOf(fl);
+    // Upstream creates the repository if it is missing and ignores --private
+    // when it already exists, so the flag picks the visibility of one this line
+    // brings into being rather than changing an existing repository's.
+    await createRepo(inv.config, repoId, {
+        repoType,
+        private: fl.asBool('private'),
+        existOk: true,
+    });
+    const accessor = hubFor(inv, repoId, repoType, fl.asStr('revision'));
+    await commit(accessor, {
+        additions,
+        deletions: [...deletions],
+        message: fl.asStr('commit_message') ?? DEFAULT_COMMIT_MESSAGE,
+        description: fl.asStr('commit_description') ?? '',
+        createPr: fl.asBool('create_pr'),
+    });
+    const home = repoUrl(inv.config.endpoint, accessor.repoType, repoId);
+    const url = `${home}/tree/${accessor.revision}/${base}`.replace(/\/+$/, '');
+    return textOut(`${url}\n`, true);
+}
+//# sourceMappingURL=upload.js.map

package/dist/commands/cli/builtin/hf/upload.js.map

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