@meshy-ai/cli 0.1.0

package/dist/internal/download.js

@@ -0,0 +1,283 @@
+/**
+ * Download a completed task's artifacts to the local filesystem.
+ *
+ * Two target shapes:
+ *   1. File path (e.g. `character/front.jpeg`) — used when the task has a
+ *      single downloadable artifact (most 2D image tasks). The Content-Type
+ *      of the HTTP response is authoritative; if the user-supplied extension
+ *      disagrees, the file is saved with the correct extension instead.
+ *   2. Directory path (anything without a recognized file extension) — used
+ *      when the task emits multiple artifacts (3D models, thumbnails,
+ *      textures, animation outputs). Each artifact is named after its role
+ *      (model.glb, thumbnail.png, texture_0_base_color.png, ...).
+ *
+ * A `meta.json` alongside the artifacts records the full task response plus
+ * the saved paths for later reference.
+ */
+import { createWriteStream, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, extname, join } from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import sharp from "sharp";
+import { UsageError } from "./errors.js";
+import { logger } from "./logger.js";
+/** Extensions sharp can transcode between. */
+const CONVERTIBLE_IMAGE_EXTS = new Set(["jpg", "jpeg", "png", "webp", "gif", "tiff", "tif", "avif"]);
+export function enumerateArtifacts(task) {
+    const out = [];
+    if (task.model_urls) {
+        for (const [ext, url] of Object.entries(task.model_urls)) {
+            if (typeof url === "string" && url) {
+                out.push({ key: `model_${ext}`, url, preferredExt: ext.toLowerCase() });
+            }
+        }
+    }
+    if (task.thumbnail_url) {
+        out.push({ key: "thumbnail", url: task.thumbnail_url, preferredExt: "png" });
+    }
+    if (Array.isArray(task.texture_urls)) {
+        task.texture_urls.forEach((set, i) => {
+            for (const [name, url] of Object.entries(set)) {
+                if (typeof url === "string" && url) {
+                    out.push({ key: `texture_${i}_${name}`, url, preferredExt: "png" });
+                }
+            }
+        });
+    }
+    if (Array.isArray(task.image_urls)) {
+        task.image_urls.forEach((url, i) => {
+            if (typeof url === "string" && url) {
+                out.push({ key: `image_${i}`, url, preferredExt: "" });
+            }
+        });
+    }
+    // Rigging / animate-style endpoints nest outputs under `result`.
+    if (task.result && typeof task.result === "object") {
+        for (const [key, value] of Object.entries(task.result)) {
+            if (typeof value !== "string" || !/^https?:/.test(value))
+                continue;
+            const extMatch = key.match(/_(fbx|glb|usdz|obj|png|jpg|jpeg|webp)_url$/i);
+            const preferredExt = extMatch ? extMatch[1].toLowerCase() : "";
+            out.push({ key, url: value, preferredExt });
+        }
+    }
+    return out;
+}
+/** Heuristic: does this look like a file path (has an extension) or a dir? */
+export function looksLikeFile(path) {
+    return /\.[A-Za-z0-9]{2,6}$/.test(path);
+}
+export async function downloadArtifacts(task, outputPath, resource) {
+    const artifacts = enumerateArtifacts(task);
+    if (artifacts.length === 0) {
+        // Report-only tasks (analyze-printability) carry their result in a
+        // structured field instead of downloadable files. Persist the full task
+        // JSON so `-o` still means "give me the result on disk".
+        if (task.printability != null) {
+            return saveReportOnly(task, outputPath, resource);
+        }
+        throw new Error(`task ${task.id} has no downloadable artifacts`);
+    }
+    if (looksLikeFile(outputPath) && artifacts.length > 1) {
+        throw new UsageError(`task ${task.id} produced ${artifacts.length} artifacts — '${outputPath}' looks like a file. ` +
+            `Pass a directory path for --output instead (e.g. '${stripExt(outputPath)}').`);
+    }
+    const singleFileMode = looksLikeFile(outputPath);
+    // Plan every path we'd write up front so we can bail before any network
+    // work when a destination already exists. This prevents silent overwrite
+    // of prior runs.
+    let targetDir;
+    const plannedArtifactPaths = [];
+    if (singleFileMode) {
+        targetDir = dirname(outputPath) || ".";
+        plannedArtifactPaths.push(outputPath);
+    }
+    else {
+        targetDir = outputPath;
+        for (const artifact of artifacts) {
+            plannedArtifactPaths.push(join(targetDir, deriveFilename(artifact)));
+        }
+    }
+    // Per-file meta in single-file mode (`-o a.png` → `a_meta.json`) so two
+    // outputs can share a directory without trampling each other. Directory
+    // mode keeps the plain `meta.json` alongside the artifacts.
+    const metadataPath = singleFileMode
+        ? `${stripExt(outputPath)}_meta.json`
+        : join(targetDir, "meta.json");
+    const existing = [...plannedArtifactPaths, metadataPath].filter((p) => existsSync(p));
+    if (existing.length > 0) {
+        throw new UsageError(`refusing to overwrite existing file(s):\n  ${existing.join("\n  ")}\n` +
+            `(delete them or choose a different --output path to rerun)`);
+    }
+    mkdirSync(targetDir, { recursive: true });
+    const saved = [];
+    if (singleFileMode) {
+        saved.push(await downloadArtifact(artifacts[0], outputPath));
+    }
+    else {
+        for (const artifact of artifacts) {
+            const targetPath = join(targetDir, deriveFilename(artifact));
+            saved.push(await downloadArtifact(artifact, targetPath));
+        }
+    }
+    writeMeta(task, resource, metadataPath, saved);
+    return { savedFiles: saved, metadataPath };
+}
+function deriveFilename(artifact) {
+    if (artifact.key.startsWith("model_")) {
+        const ext = artifact.key.slice("model_".length);
+        return `model.${ext}`;
+    }
+    if (artifact.key === "thumbnail") {
+        return `thumbnail.${artifact.preferredExt || "png"}`;
+    }
+    // Keys from `result.*_url` (animate / rigging) arrive like
+    // "animation_glb_url". The trailing "_url" is structural; the real name
+    // is what precedes it.
+    const stem = artifact.key.replace(/_url$/, "");
+    // Unknown extension → leave it off; downloadArtifact will append the
+    // content-type-derived extension so we don't emit a bogus `.bin`.
+    return artifact.preferredExt ? `${stem}.${artifact.preferredExt}` : stem;
+}
+function stripExt(path) {
+    const ext = extname(path);
+    return ext ? path.slice(0, -ext.length) : path;
+}
+async function downloadArtifact(artifact, targetPath) {
+    logger.debug(`GET ${artifact.url}`);
+    const resp = await fetch(artifact.url);
+    if (!resp.ok) {
+        throw new Error(`download failed for ${artifact.key} (${resp.status} ${resp.statusText})`);
+    }
+    if (!resp.body)
+        throw new Error(`empty body for ${artifact.url}`);
+    const contentType = resp.headers.get("content-type") ?? "";
+    const actualExt = extFromContentType(contentType);
+    const requestedExt = extname(targetPath).slice(1).toLowerCase();
+    mkdirSync(dirname(targetPath), { recursive: true });
+    // No extension requested (e.g. unknown-format image artifact) — pick one
+    // from the content-type so the file has a reasonable suffix.
+    if (!requestedExt && actualExt) {
+        const finalPath = `${targetPath}.${actualExt}`;
+        await pipeline(Readable.fromWeb(resp.body), createWriteStream(finalPath));
+        return finalPath;
+    }
+    // Fast path: extensions agree (or the server didn't specify one) — stream through.
+    if (!actualExt ||
+        !requestedExt ||
+        actualExt === requestedExt ||
+        extEquivalent(actualExt, requestedExt)) {
+        await pipeline(Readable.fromWeb(resp.body), createWriteStream(targetPath));
+        return targetPath;
+    }
+    // Extensions differ. Buffer the body so we can either transcode or rename.
+    const buffer = Buffer.from(await resp.arrayBuffer());
+    // Both sides are image formats sharp understands — convert.
+    if (CONVERTIBLE_IMAGE_EXTS.has(actualExt) && CONVERTIBLE_IMAGE_EXTS.has(requestedExt)) {
+        logger.debug(`converting ${actualExt} → ${requestedExt} for ${artifact.key}`);
+        await convertImage(buffer, requestedExt, targetPath);
+        return targetPath;
+    }
+    // Can't convert safely — save with the true extension so the file isn't a lie.
+    const base = targetPath.slice(0, targetPath.length - (requestedExt.length + 1));
+    const fallback = `${base}.${actualExt}`;
+    logger.warn(`extension mismatch for ${artifact.key}: requested .${requestedExt}, got ${contentType || "?"}; ` +
+        `cannot transcode ${actualExt} → ${requestedExt}, saving as ${fallback}`);
+    await pipeline(Readable.from(buffer), createWriteStream(fallback));
+    return fallback;
+}
+async function convertImage(buffer, targetExt, targetPath) {
+    const pipe = sharp(buffer);
+    switch (targetExt) {
+        case "jpg":
+        case "jpeg":
+            await pipe.jpeg({ quality: 92 }).toFile(targetPath);
+            return;
+        case "png":
+            await pipe.png().toFile(targetPath);
+            return;
+        case "webp":
+            await pipe.webp({ quality: 92 }).toFile(targetPath);
+            return;
+        case "gif":
+            await pipe.gif().toFile(targetPath);
+            return;
+        case "tiff":
+        case "tif":
+            await pipe.tiff().toFile(targetPath);
+            return;
+        case "avif":
+            await pipe.avif({ quality: 60 }).toFile(targetPath);
+            return;
+        default:
+            throw new Error(`unsupported image target extension: ${targetExt}`);
+    }
+}
+function extFromContentType(ct) {
+    const base = ct.split(";")[0].trim().toLowerCase();
+    const map = {
+        "image/jpeg": "jpg",
+        "image/png": "png",
+        "image/webp": "webp",
+        "image/gif": "gif",
+        "image/tiff": "tiff",
+        "image/bmp": "bmp",
+        "model/gltf-binary": "glb",
+        "model/gltf+json": "gltf",
+        "model/obj": "obj",
+        "model/vnd.usdz+zip": "usdz",
+        "model/stl": "stl",
+        "model/3mf": "3mf",
+        "application/json": "json",
+        "video/mp4": "mp4",
+    };
+    return map[base] ?? "";
+}
+function extEquivalent(a, b) {
+    const groups = [new Set(["jpg", "jpeg"]), new Set(["tif", "tiff"])];
+    return groups.some((g) => g.has(a) && g.has(b));
+}
+/**
+ * Save a no-artifact task (e.g. analyze-printability) to disk. Two layouts:
+ *   - `-o report.json` (or any .json file): write the full task object there;
+ *     no sidecar (the file IS the report).
+ *   - `-o some/dir/` (or any non-file path): write `meta.json` inside,
+ *     matching the directory-mode layout used elsewhere.
+ * Other single-file extensions are rejected — the data is JSON, lying about
+ * the extension would be worse than a clear error.
+ */
+function saveReportOnly(task, outputPath, resource) {
+    const singleFileMode = looksLikeFile(outputPath);
+    if (singleFileMode) {
+        const ext = extname(outputPath).slice(1).toLowerCase();
+        if (ext !== "json") {
+            throw new UsageError(`${resource} produces a JSON report — pass '-o <path>.json' or a directory path (got '${outputPath}').`);
+        }
+        if (existsSync(outputPath)) {
+            throw new UsageError(`refusing to overwrite existing file:\n  ${outputPath}\n` +
+                `(delete it or choose a different --output path to rerun)`);
+        }
+        mkdirSync(dirname(outputPath) || ".", { recursive: true });
+        writeFileSync(outputPath, `${JSON.stringify({ resource, task, downloaded_at: new Date().toISOString() }, null, 2)}\n`, "utf8");
+        return { savedFiles: [], metadataPath: outputPath };
+    }
+    const metadataPath = join(outputPath, "meta.json");
+    if (existsSync(metadataPath)) {
+        throw new UsageError(`refusing to overwrite existing file:\n  ${metadataPath}\n` +
+            `(delete it or choose a different --output path to rerun)`);
+    }
+    mkdirSync(outputPath, { recursive: true });
+    writeMeta(task, resource, metadataPath, []);
+    return { savedFiles: [], metadataPath };
+}
+function writeMeta(task, resource, path, savedFiles) {
+    const meta = {
+        resource,
+        task,
+        saved_files: savedFiles,
+        downloaded_at: new Date().toISOString(),
+    };
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(meta, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=download.js.map

package/dist/internal/download.js.map

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

package/dist/internal/errors.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Terminal error presentation — routes a caught error to stderr with a
+ * human-friendly line, emits the structured payload when --format=json, and
+ * maps MeshyApiError codes to conventional exit codes for scripting.
+ */
+import { type OutputFormat } from "./output.js";
+export declare const EXIT_CODES: {
+    readonly OK: 0;
+    readonly GENERIC: 1;
+    readonly USAGE: 2;
+    readonly AUTH: 3;
+    readonly VALIDATION: 4;
+    readonly NOT_FOUND: 5;
+    readonly RATE_LIMIT: 6;
+    readonly NETWORK: 7;
+    readonly TIMED_OUT: 8;
+    readonly CREDIT: 9;
+};
+export declare class UsageError extends Error {
+    constructor(message: string);
+}
+/**
+ * An error that carries the command which fixes it.
+ *
+ * Agents parse stdout, not the prose on stderr, so a recoverable failure has to
+ * say how to recover *in the payload*: `hint` is a command the caller can run
+ * verbatim. Errors with no known remedy stay plain — a wrong guess is worse
+ * than no hint.
+ */
+export declare class HintedError extends Error {
+    readonly code: string;
+    readonly hint?: string;
+    readonly docs?: string;
+    /**
+     * Overrides the exit code this error maps to. Set it when the failure has a
+     * conventional code that `code` alone doesn't imply — a chained step that
+     * times out is still a timeout (8), not a generic failure.
+     */
+    readonly exitCode?: number;
+    constructor(params: {
+        message: string;
+        code: string;
+        hint?: string;
+        docs?: string;
+        exitCode?: number;
+    });
+}
+export declare const SESSION_REVOKED_HINT = "Session revoked or expired. Run: meshy auth login";
+export declare const CREDENTIAL_REJECTED_HINT = "Credential rejected or revoked. Run: meshy auth login  (or: meshy auth login --with-key msy_...)";
+/** No credential at all — the error every new user meets first. */
+export declare function authRequiredError(detail?: string): HintedError;
+export declare function exitCodeFor(err: unknown): number;
+export declare function reportError(err: unknown, format: OutputFormat): void;
+/**
+ * The payload shape stays additive: `hint` and `docs` join the existing
+ * name/message/status/code/path fields rather than moving everything under an
+ * `{ok:false, error:{…}}` envelope. Successful commands emit bare API payloads
+ * with no `ok` field, so an envelope on failures only would force consumers to
+ * probe for two different shapes.
+ */
+export declare function toErrorPayload(err: unknown): {
+    name: string;
+    message: string;
+    [k: string]: unknown;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/internal/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAQ,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,UAAU;;;;;;;;;;;CAWb,CAAC;AAEX,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEf,MAAM,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;CAQF;AAID,eAAO,MAAM,oBAAoB,sDAAsD,CAAC;AACxF,eAAO,MAAM,wBAAwB,qGAAkD,CAAC;AAExF,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAO9D;AAyBD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CA0BhD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAapE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CA4BpG"}

package/dist/internal/errors.js

@@ -0,0 +1,169 @@
+/**
+ * Terminal error presentation — routes a caught error to stderr with a
+ * human-friendly line, emits the structured payload when --format=json, and
+ * maps MeshyApiError codes to conventional exit codes for scripting.
+ */
+import { MeshyApiError } from "../client/errors.js";
+import { emit } from "./output.js";
+export const EXIT_CODES = {
+    OK: 0,
+    GENERIC: 1,
+    USAGE: 2,
+    AUTH: 3,
+    VALIDATION: 4,
+    NOT_FOUND: 5,
+    RATE_LIMIT: 6,
+    NETWORK: 7,
+    TIMED_OUT: 8,
+    CREDIT: 9,
+};
+export class UsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UsageError";
+    }
+}
+/**
+ * An error that carries the command which fixes it.
+ *
+ * Agents parse stdout, not the prose on stderr, so a recoverable failure has to
+ * say how to recover *in the payload*: `hint` is a command the caller can run
+ * verbatim. Errors with no known remedy stay plain — a wrong guess is worse
+ * than no hint.
+ */
+export class HintedError extends Error {
+    code;
+    hint;
+    docs;
+    /**
+     * Overrides the exit code this error maps to. Set it when the failure has a
+     * conventional code that `code` alone doesn't imply — a chained step that
+     * times out is still a timeout (8), not a generic failure.
+     */
+    exitCode;
+    constructor(params) {
+        super(params.message);
+        this.name = "HintedError";
+        this.code = params.code;
+        this.hint = params.hint;
+        this.docs = params.docs;
+        this.exitCode = params.exitCode;
+    }
+}
+const DOCS_AUTH = "https://docs.meshy.ai/en/api/authentication";
+const LOGIN_HINT = "Run: meshy auth login  (or: meshy auth login --with-key msy_...)";
+export const SESSION_REVOKED_HINT = "Session revoked or expired. Run: meshy auth login";
+export const CREDENTIAL_REJECTED_HINT = `Credential rejected or revoked. ${LOGIN_HINT}`;
+/** No credential at all — the error every new user meets first. */
+export function authRequiredError(detail) {
+    return new HintedError({
+        message: detail ?? "No credentials found.",
+        code: "unauthenticated",
+        hint: LOGIN_HINT,
+        docs: DOCS_AUTH,
+    });
+}
+/**
+ * Remedies for API failures, keyed by MeshyApiError.code so the mapping lives
+ * in one place instead of at every call site.
+ */
+function hintForApiError(err) {
+    switch (err.code) {
+        case "auth":
+            if (err.credentialKind === "api_key") {
+                return { hint: CREDENTIAL_REJECTED_HINT, docs: DOCS_AUTH };
+            }
+            // oauth or unknown → session-revoked hint
+            return { hint: SESSION_REVOKED_HINT, docs: DOCS_AUTH };
+        case "credit":
+            return {
+                hint: "Out of credits. Confirm with: meshy balance — then top up at https://www.meshy.ai/pricing",
+            };
+        case "rate_limit":
+            return { hint: "Rate limited. Pause before retrying, or lower request concurrency." };
+        default:
+            return {};
+    }
+}
+export function exitCodeFor(err) {
+    if (err instanceof UsageError)
+        return EXIT_CODES.USAGE;
+    if (err instanceof HintedError) {
+        // An explicit exitCode wins — the raiser knew the conventional code for
+        // its own failure (a chained `make` step that times out is a timeout).
+        // Otherwise map by code: "unauthenticated" → AUTH(3); "oauth_timeout" →
+        // TIMED_OUT(8) (device flow expired_token, loopback waitForCallback
+        // timeout, manual prompt timeout all share it); everything else →
+        // GENERIC(1).
+        if (err.exitCode !== undefined)
+            return err.exitCode;
+        if (err.code === "unauthenticated")
+            return EXIT_CODES.AUTH;
+        if (err.code === "oauth_timeout")
+            return EXIT_CODES.TIMED_OUT;
+        return EXIT_CODES.GENERIC;
+    }
+    if (err instanceof MeshyApiError) {
+        switch (err.code) {
+            case "auth": return EXIT_CODES.AUTH;
+            case "validation": return EXIT_CODES.VALIDATION;
+            case "not_found": return EXIT_CODES.NOT_FOUND;
+            case "rate_limit": return EXIT_CODES.RATE_LIMIT;
+            case "network": return EXIT_CODES.NETWORK;
+            case "credit": return EXIT_CODES.CREDIT;
+            case "server": return EXIT_CODES.GENERIC;
+        }
+    }
+    return EXIT_CODES.GENERIC;
+}
+export function reportError(err, format) {
+    const payload = toErrorPayload(err);
+    process.stderr.write(`error: ${payload.message}\n`);
+    if (typeof payload["hint"] === "string") {
+        process.stderr.write(`hint: ${payload["hint"]}\n`);
+    }
+    if (format !== "pretty") {
+        try {
+            emit(payload, { format });
+        }
+        catch {
+            /* ignore: stderr already carries the human message */
+        }
+    }
+}
+/**
+ * The payload shape stays additive: `hint` and `docs` join the existing
+ * name/message/status/code/path fields rather than moving everything under an
+ * `{ok:false, error:{…}}` envelope. Successful commands emit bare API payloads
+ * with no `ok` field, so an envelope on failures only would force consumers to
+ * probe for two different shapes.
+ */
+export function toErrorPayload(err) {
+    if (err instanceof MeshyApiError) {
+        return { ...err.toJSON(), ...hintForApiError(err), name: err.name, message: err.message };
+    }
+    if (err instanceof HintedError) {
+        // DeviceFlowError (a HintedError subclass) carries an oauthErrorCode field
+        // that machine consumers need to distinguish access_denied / invalid_grant /
+        // expired_token etc. Serialise it as `oauth_error` (snake_case, consistent
+        // with the rest of the JSON error payload) without importing the subclass
+        // (which would create a circular dependency through device.ts → errors.ts).
+        const errAsUnknown = err;
+        const oauthError = typeof errAsUnknown["oauthErrorCode"] === "string"
+            ? errAsUnknown["oauthErrorCode"]
+            : undefined;
+        return {
+            name: err.name,
+            message: err.message,
+            code: err.code,
+            ...(oauthError !== undefined ? { oauth_error: oauthError } : {}),
+            ...(err.hint ? { hint: err.hint } : {}),
+            ...(err.docs ? { docs: err.docs } : {}),
+        };
+    }
+    if (err instanceof Error) {
+        return { name: err.name, message: err.message };
+    }
+    return { name: "Error", message: String(err) };
+}
+//# sourceMappingURL=errors.js.map

package/dist/internal/errors.js.map

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

package/dist/internal/file-input.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Resolve user-supplied image and model inputs into something Meshy accepts.
+ *
+ * Accepted inputs (both images and 3D models):
+ *   - http(s) URLs — preflighted with HEAD so unreachable sources fail fast.
+ *   - Local file paths (absolute or relative to cwd) — read, MIME-sniffed,
+ *     and inlined as data URIs. Users don't have to host files themselves.
+ *
+ * Base64 data URIs on the command line aren't accepted — the whole point of
+ * local-path support is to spare the user from encoding them manually.
+ */
+/** camelCase option names that hold image inputs. */
+export declare const IMAGE_FIELDS: {
+    scalar: readonly ["imageUrl", "imageStyleUrl"];
+    list: readonly ["imageUrls", "referenceImageUrls"];
+};
+/** camelCase option names that hold 3D model inputs. */
+export declare const MODEL_FIELDS: {
+    scalar: readonly ["modelUrl"];
+    list: readonly [];
+};
+export declare function resolveImageFields(opts: Record<string, unknown>): Promise<void>;
+export declare function resolveModelFields(opts: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=file-input.d.ts.map

package/dist/internal/file-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-input.d.ts","sourceRoot":"","sources":["../../src/internal/file-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,qDAAqD;AACrD,eAAO,MAAM,YAAY;;;CASxB,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,YAAY;;;CAGxB,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF"}