@meshy-ai/cli 0.1.0

package/dist/internal/task-command.js

@@ -0,0 +1,189 @@
+/**
+ * Factory that wires the uniform get/list/delete/wait/create subcommands for
+ * any async-task resource. Keeps the per-resource modules focused on their
+ * unique create-flag shape.
+ */
+import { Command, Option } from "commander";
+import { downloadArtifacts } from "./download.js";
+import { resolveImageFields, resolveModelFields } from "./file-input.js";
+import { pollUntilTerminal } from "./poll.js";
+import { emit } from "./output.js";
+import { mergePayload, parseJsonFlag } from "./payload.js";
+import { printReport } from "./report.js";
+import { getUpdateNotice } from "./update-notifier.js";
+import { buildRuntime, readGlobalFlags } from "./runtime.js";
+import { summarizeTask, TERMINAL_STATUSES } from "../client/types.js";
+import { UsageError } from "./errors.js";
+import { logger } from "./logger.js";
+export function buildResourceCommand(spec) {
+    const cmd = new Command(spec.name).description(spec.description);
+    // create
+    const createCmd = new Command("create").description(spec.create.description);
+    spec.create.configure(createCmd);
+    createCmd
+        .addOption(new Option("--data <json>", "raw JSON payload (or @file.json); merges with flags"))
+        .addOption(new Option("--async", "return the task_id immediately without polling; query later with `<resource> wait <id>` or `get <id>`").default(false))
+        .addOption(new Option("--timeout <seconds>", "max seconds to poll in sync mode").default("600"))
+        .action(async (opts, thisCmd) => {
+        const runtime = await buildRuntime(readGlobalFlags(thisCmd));
+        const endpoint = spec.endpointOf(runtime.client);
+        const data = parseJsonFlag(opts.data, "--data");
+        // Resolve local file paths + preflight URLs for image and 3D-model
+        // inputs before building the payload — fail fast on missing inputs.
+        await resolveImageFields(opts);
+        await resolveModelFields(opts);
+        const flagPayload = spec.create.toPayload(opts);
+        const defaults = spec.create.toDefaults?.(opts) ?? {};
+        const payload = mergePayload(defaults, data, flagPayload);
+        logger.debug("create payload", payload);
+        const taskId = await endpoint.create(payload);
+        const runAsync = Boolean(opts.async);
+        const timeoutSeconds = Number(opts.timeout ?? 600);
+        if (runAsync) {
+            emit({
+                resource: spec.name,
+                task_id: taskId,
+                status: "PENDING",
+                hint: `meshy-cli ${spec.name} wait ${taskId}`,
+            }, { format: runtime.flags.format, file: undefined });
+            return;
+        }
+        const started = Date.now();
+        const { task, timedOut } = await pollUntilTerminal(endpoint, taskId, {
+            timeoutSeconds,
+            intervalMs: runtime.config.pollIntervalMs,
+        });
+        const elapsed = (Date.now() - started) / 1000;
+        await emitTerminalOutcome(task, timedOut, elapsed, spec.name, runtime);
+    });
+    cmd.addCommand(createCmd);
+    // get
+    cmd
+        .command("get <task-id>")
+        .description("Retrieve a single task by id")
+        .action(async (taskId, _opts, thisCmd) => {
+        const runtime = await buildRuntime(readGlobalFlags(thisCmd));
+        const task = await spec.endpointOf(runtime.client).retrieve(taskId);
+        await emitTerminalOutcome(task, false, undefined, spec.name, runtime);
+    });
+    // wait
+    cmd
+        .command("wait <task-id>")
+        .description("Poll until the task reaches a terminal status")
+        .option("--timeout <seconds>", "max seconds to wait", "600")
+        .action(async (taskId, opts, thisCmd) => {
+        const runtime = await buildRuntime(readGlobalFlags(thisCmd));
+        const endpoint = spec.endpointOf(runtime.client);
+        const timeoutSeconds = Number(opts.timeout ?? 600);
+        const started = Date.now();
+        const { task, timedOut } = await pollUntilTerminal(endpoint, taskId, {
+            timeoutSeconds,
+            intervalMs: runtime.config.pollIntervalMs,
+        });
+        const elapsed = (Date.now() - started) / 1000;
+        await emitTerminalOutcome(task, timedOut, elapsed, spec.name, runtime);
+    });
+    // delete
+    cmd
+        .command("delete <task-id>")
+        .description("Delete a task")
+        .action(async (taskId, _opts, thisCmd) => {
+        const runtime = await buildRuntime(readGlobalFlags(thisCmd));
+        await spec.endpointOf(runtime.client).delete(taskId);
+        emit({ resource: spec.name, task_id: taskId, deleted: true }, {
+            format: runtime.flags.format,
+            file: runtime.flags.output,
+        });
+    });
+    // list (optional — some endpoints don't support it)
+    if (spec.supportsList !== false) {
+        cmd
+            .command("list")
+            .description("List recent tasks")
+            .option("--page <n>", "page number (1-based)", "1")
+            .option("--page-size <n>", "page size", "10")
+            .option("--sort-by <field>", "sort order (e.g. -created_at)", "-created_at")
+            .action(async (opts, thisCmd) => {
+            const runtime = await buildRuntime(readGlobalFlags(thisCmd));
+            const tasks = await spec.endpointOf(runtime.client).list({
+                page_num: Number(opts.page ?? 1),
+                page_size: Number(opts.pageSize ?? 10),
+                sort_by: opts.sortBy ?? "-created_at",
+            });
+            emit(tasks.map((t) => summarizeTask(t)), {
+                format: runtime.flags.format,
+                file: runtime.flags.output,
+            });
+        });
+    }
+    else {
+        cmd
+            .command("list")
+            .description("(unsupported) Meshy does not expose a list endpoint for this resource")
+            .action(() => {
+            throw new UsageError(`${spec.name} does not support list`);
+        });
+    }
+    return cmd;
+}
+/**
+ * Decide how to report a task whose status is (expected to be) terminal:
+ *   - with `-o`: download artifacts to the filesystem and print the status
+ *     report. Failed/timed-out tasks print the FAIL form without downloads.
+ *   - without `-o`: emit the familiar JSON/pretty summary to stdout.
+ */
+export async function emitTerminalOutcome(task, timedOut, elapsedSeconds, resourceName, runtime) {
+    const output = runtime.flags.output;
+    const succeeded = !timedOut && task.status === "SUCCEEDED";
+    if (output) {
+        if (succeeded) {
+            const { savedFiles, metadataPath } = await downloadArtifacts(task, output, resourceName);
+            const successReport = {
+                status: "SUCCESS",
+                taskId: task.id,
+                type: task.type || resourceName,
+                savedFiles,
+                metadataPath,
+            };
+            const successNotice = getUpdateNotice();
+            if (successNotice)
+                successReport._notice = successNotice;
+            printReport(successReport);
+        }
+        else {
+            const report = {
+                status: "FAIL",
+                taskId: task.id,
+                type: task.type || resourceName,
+            };
+            if (timedOut)
+                report.timedOut = true;
+            else if (task.task_error?.message)
+                report.error = task.task_error.message;
+            else if (task.status)
+                report.error = `task status: ${task.status}`;
+            const failNotice = getUpdateNotice();
+            if (failNotice)
+                report._notice = failNotice;
+            printReport(report);
+            process.exitCode = timedOut ? 8 : 1;
+        }
+        if (succeeded)
+            return;
+    }
+    else {
+        // No -o: keep the JSON/pretty summary for machine consumption.
+        emit({
+            resource: resourceName,
+            ...summarizeTask(task, elapsedSeconds),
+            ...(timedOut ? { timed_out: true } : {}),
+        }, { format: runtime.flags.format });
+    }
+    if (!output) {
+        if (timedOut)
+            process.exitCode = 8;
+        else if (!TERMINAL_STATUSES.has(task.status) || task.status !== "SUCCEEDED")
+            process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=task-command.js.map

package/dist/internal/task-command.js.map

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

package/dist/internal/update-notifier.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Update notifier — two-channel design.
+ *
+ * Channel 1 (agents / machines): JSON outputs carry `_notice.update` when a
+ * newer version is available. Injected by attachUpdateNotice() in output.ts
+ * and report.ts.
+ *
+ * Channel 2 (humans on TTY): a single stderr line printed by
+ * printHumanUpdateHint() after emit() renders its output.
+ *
+ * Hard rule: this module MUST NEVER slow down, hang, or break the main
+ * command. Network I/O runs in a detached child process (see refreshCache)
+ * so a hung registry cannot delay process exit. All public functions are
+ * synchronous and read only from the local cache file.
+ */
+import { spawn } from "node:child_process";
+import type { OutputFormat } from "./output.js";
+export declare const REGISTRY_URL = "https://registry.npmjs.org/meshy-cli/latest";
+export declare const FETCH_TIMEOUT_MS = 15000;
+export declare const MAX_RESPONSE_BYTES: number;
+export declare const CACHE_TTL_MS: number;
+export declare const UPDATE_COMMAND = "npm i -g meshy-cli@latest";
+/**
+ * Hidden self-command used for the detached background refresh child.
+ * CRITICAL: the child must check argv for this token and return immediately
+ * to prevent an infinite spawn chain.
+ */
+export declare const REFRESH_COMMAND = "__refresh-update-cache";
+export interface UpdateNotice {
+    current: string;
+    latest: string;
+    message: string;
+    command: string;
+}
+interface UpdateState {
+    latest_version?: string;
+    checked_at?: number;
+}
+/** Returns the path to the update-state cache file. */
+export declare function stateFilePath(): string;
+/**
+ * Returns true when the update check should be skipped entirely.
+ * Skips when:
+ *   - MESHY_CLI_NO_UPDATE_NOTIFIER is a non-empty string
+ *   - any CI env var (CI, GITHUB_ACTIONS, BUILD_NUMBER, RUN_ID) is non-empty
+ *   - version contains "-dev"
+ *   - version matches a git-describe suffix (e.g. 0.1.0-5-gdeadbee)
+ */
+export declare function shouldSkip(env?: NodeJS.ProcessEnv, version?: string): boolean;
+/**
+ * Semver 2.0.0-compliant comparison. Returns -1 if a < b, 0 if equal, 1 if a > b.
+ *
+ * Rules:
+ *   - strips leading "v"
+ *   - strips "+build" metadata (build metadata is ignored per semver §10)
+ *   - splits prerelease on first "-"
+ *   - compares numeric major/minor/patch (missing segments → 0, non-numeric → 0)
+ *   - equal numerics: release > prerelease (semver §11.3)
+ *   - both prereleases: compare dot-separated identifiers left-to-right (semver §11.4):
+ *       numeric identifiers compare numerically
+ *       alphanumeric identifiers compare lexically (ASCII)
+ *       numeric < alphanumeric
+ *       if all shared identifiers equal, shorter set has LOWER precedence
+ */
+export declare function compareVersions(a: string, b: string): -1 | 0 | 1;
+/**
+ * Returns an UpdateNotice if latest > current, otherwise null.
+ */
+export declare function buildNotice(latest: string, current?: string): UpdateNotice | null;
+/**
+ * Pure read from the cache file — no network, no TTL check.
+ *
+ * Note: a newer-version fact does not expire. TTL gates only the network
+ * refresh (isCacheStale). Once we know a newer version exists, we keep
+ * surfacing the notice until the user upgrades.
+ *
+ * Returns null on missing/corrupt file, missing latest_version, or when
+ * latest is not newer than current. Never throws.
+ */
+export declare function checkCached(stateFile?: string, current?: string): UpdateNotice | null;
+/**
+ * Returns true when the cache is missing, corrupt, has no checked_at, or
+ * is older than CACHE_TTL_MS.
+ */
+export declare function isCacheStale(stateFile?: string, now?: number): boolean;
+/**
+ * Returns the cached update notice if applicable, or null.
+ * This is what emit() and report paths call — synchronous, never throws.
+ */
+export declare function getUpdateNotice(): UpdateNotice | null;
+/**
+ * Injects the update notice into a value before JSON serialization.
+ *
+ * Injection rules:
+ *   - notice null → value unchanged
+ *   - format "pretty" → unchanged (humans get the stderr line instead)
+ *   - Array + format "ndjson": if non-empty and first element is a plain
+ *     object, return new array with first element replaced by
+ *     { ...first, _notice: { update: notice } }. Attaches ONCE on the first
+ *     line only — never per-line.
+ *   - Array + any other format (e.g. "json") → unchanged. A JSON array has
+ *     no clean metadata slot without breaking the schema, so we leave it alone.
+ *   - plain object → { ...value, _notice: { update: notice } }
+ *   - anything else (string/number/null) → unchanged
+ */
+export declare function attachUpdateNotice(value: unknown, format: OutputFormat, notice: UpdateNotice | null): unknown;
+/**
+ * Writes the update message to stderr ONLY when all three of
+ * io.stdout/io.stderr/io.stdin have truthy isTTY (i.e. a fully interactive
+ * terminal). NEVER writes to stdout — stdout must stay machine-parseable.
+ *
+ * Returns true if the hint was written, false otherwise.
+ */
+export declare function printHumanUpdateHint(notice: UpdateNotice | null, io: {
+    stdout: {
+        isTTY?: boolean;
+    };
+    stderr: {
+        isTTY?: boolean;
+        write(s: string): unknown;
+    };
+    stdin: {
+        isTTY?: boolean;
+    };
+}): boolean;
+/**
+ * Atomically writes the update state to disk.
+ * Uses a tmp file + rename to avoid torn JSON from concurrent CLI runs.
+ */
+export declare function writeState(state: UpdateState, file?: string): void;
+/**
+ * Fetches the latest version from the npm registry.
+ * Throws on any failure — callers must swallow.
+ */
+export declare function fetchLatestVersion(registryUrl?: string, timeoutMs?: number): Promise<string>;
+/**
+ * Entry point for the hidden background child command.
+ * Fetches the latest version and writes it to the cache.
+ * Must never throw — the child always exits 0.
+ */
+export declare function runRefreshCommand(): Promise<void>;
+/**
+ * Fire-and-forget spawner. Spawns a detached child process to refresh the
+ * update cache in the background. NEVER throws, never awaits anything.
+ *
+ * Why a detached child instead of in-process fetch:
+ *   An in-flight undici/fetch keeps the Node event loop alive, so an
+ *   in-process fire-and-forget fetch would delay process exit by up to the
+ *   15s timeout — violating "never slow down the main command". A detached
+ *   child is fully independent and the parent can exit immediately.
+ */
+export declare function refreshCache(deps?: {
+    env?: NodeJS.ProcessEnv;
+    argv?: string[];
+    scriptPath?: string;
+    stateFile?: string;
+    spawnImpl?: typeof spawn;
+}): void;
+export {};
+//# sourceMappingURL=update-notifier.d.ts.map

package/dist/internal/update-notifier.d.ts.map

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