@meshy-ai/cli 0.1.0

package/.env.example

@@ -0,0 +1,14 @@
+# Required: your Meshy API key (https://www.meshy.ai/api)
+MESHY_API_KEY=YOUR_MESHY_API_KEY_HERE
+
+# Optional base URL overrides (defaults shown)
+# MESHY_BASE_URL_V1=https://api.meshy.ai/openapi/v1
+# MESHY_BASE_URL_V2=https://api.meshy.ai/openapi/v2
+
+# Optional timeouts / polling
+# MESHY_CONNECT_TIMEOUT_MS=10000
+# MESHY_READ_TIMEOUT_MS=120000
+# MESHY_POLL_INTERVAL_MS=3000
+
+# Optional log level: debug | info | warn | error | silent
+# MESHY_LOG_LEVEL=warn

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 <Yujia>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,376 @@
+# meshy-cli
+
+A small, well-structured command-line interface for the [Meshy AI API](https://docs.meshy.ai/) — text-to-3D, image-to-3D (standard and smart-topology), remesh, convert, resize, rigging, animation, retexture, 2D image generation, multi-color print output, and the `balance` endpoint. Built for humans and AI agents.
+
+Two layers. `meshy make` chains the documented flows so that one command
+produces one model. Underneath, a per-endpoint command for every resource
+shares a uniform `create / get / list / wait / delete` verb surface, with a raw
+`api` passthrough for endpoints the CLI doesn't model yet and a `skills/`
+directory of agent-facing documentation.
+
+The flag surface is deliberately curated rather than a 1:1 mirror of the API: deprecated parameters (`symmetry_mode`, `hd_texture`, `is_a_t_pose`) are not exposed, geometry knobs live on `remesh` and sizing on `resize` instead of every generation command, and defaults are pinned to game-ready values (PBR maps on, 4k textures — same credit cost as the bare defaults). Everything the API accepts remains reachable through `--data`.
+
+## Install
+
+Requires Node 20+.
+
+```bash
+npm i -g meshy-cli       # installs `meshy-cli` and `meshy`
+meshy --help
+```
+
+The same build is also published under the scoped alias
+[`@meshy-ai/cli`](https://www.npmjs.com/package/@meshy-ai/cli)
+(`npm i -g @meshy-ai/cli`) — identical contents, pick whichever name you
+remember; don't install both.
+
+### Development
+
+```bash
+# straight from git (`prepare` builds dist for you)
+npm i -g git+https://github.com/meshy-dev/meshy-cli.git
+
+# or clone for local development
+pnpm install
+pnpm build
+node dist/index.js --help
+pnpm link --global       # exposes `meshy` / `meshy-cli` on $PATH
+```
+
+## Auth
+
+Log in once and the credential is stored for you:
+
+```bash
+meshy auth login                                # opens the browser (OAuth, loopback + PKCE)
+meshy auth login --with-key msy_your_key_here   # paste an existing API key instead
+meshy auth status                               # what's in effect, and does it work
+```
+
+The default `auth login` opens `https://www.meshy.ai/oauth/authorize` in your
+browser, starts a loopback server on port 8765 (override with `--port`), and
+waits for the callback. The authorize URL is always printed to **stderr** so you
+can copy-paste it if the browser doesn't open automatically.
+
+In headless or agent contexts where a browser is not available, use
+`--with-key` or set `MESHY_API_KEY` instead. Set `MESHY_CLI_NO_BROWSER=1` to
+suppress the browser-open attempt (the URL is still printed to stderr).
+
+Or keep it in the environment — unchanged, and still the right choice for CI:
+
+```bash
+export MESHY_API_KEY=msy_your_key_here
+meshy-cli --api-key msy_... balance             # or per-call
+```
+
+Get a key at <https://www.meshy.ai/settings/api>.
+
+**Resolution order:** `--api-key` › `MESHY_API_KEY` › the active stored profile.
+The environment variable stays ahead of the stored credential on purpose, so a
+CI runner is never overridden by whatever a developer once logged into on that
+machine. With none of the three, commands exit `3` and print the command that
+fixes it.
+
+**Where it lives:** `~/.config/meshy/credentials.json`, mode `0600`, on every
+platform (`MESHY_CONFIG_DIR` or `MESHY_CREDENTIALS_PATH` move it). Writes go
+through a cross-process lock and a temp-file rename, because several agents
+driving this CLI at once is the normal case. A non-production `--base-url-v1`
+reads and writes `credentials.dev.json` instead, so staging cannot clobber a
+production login.
+
+**OAuth token refresh:** when the stored OAuth access token is within 60 seconds
+of expiry (or already expired), the CLI silently refreshes it using the stored
+refresh token before running the command. A refresh failure with an unexpired
+token is swallowed (the existing token is used); a failure with an expired token
+exits `3` with a hint to run `meshy auth login`.
+
+**Profiles:** `auth login --profile work`, `auth list`, `auth use work`,
+`auth logout [--all]`.
+
+## One model, one command
+
+`make` chains the documented flows so a caller who wants a model does not have
+to pick an endpoint and carry task ids between steps:
+
+```bash
+meshy make "a red sports car" -o car.glb   # text-to-3d preview → refine
+meshy make ./cat.png -o out/cat/           # image-to-3d, textured
+```
+
+The input decides the chain: a prompt runs the two-stage text flow, an image
+runs the single textured `image-to-3d` task. There is no third judgement — no
+route picked by inspecting the input, no image step inserted ahead of a prompt,
+no pause between stages. Those are opinions, and a CLI that acts on its own
+opinions spends someone else's credits. Compose anything else from the resource
+commands below.
+
+```bash
+meshy make "a red sports car" --dry-run          # the steps and the estimate, no spend
+meshy make "a red sports car" --max-credits 25   # refuse to start when over budget
+```
+
+Both guards run before the first task is created. If a later step fails, the
+error's `hint` is the command that resumes from the finished step — running it
+beats starting over, which would pay for that step twice.
+
+## At a glance
+
+```bash
+# account
+meshy-cli balance
+
+# text → 3D (sync by default: blocks until the task finishes)
+meshy-cli text-to-3d create --mode preview --prompt "a red sports car"
+meshy-cli text-to-3d create --mode refine  --preview-task-id <id>
+
+# image → 3D
+meshy-cli image-to-3d create --image-url https://example.com/cat.png
+
+# smart topology: component-aware low-poly with a native polycount
+meshy-cli image-to-3d create --image-url cat.png --model-type smart-topology --target-polycount 10000
+
+# fire-and-forget (--async): returns the task_id immediately, query later
+TASK=$(meshy-cli text-to-image create --prompt "mountain landscape" --async | jq -r .task_id)
+meshy-cli text-to-image get  "$TASK"
+meshy-cli text-to-image wait "$TASK" -o /tmp/result.json
+
+# raw passthrough for any endpoint
+meshy-cli api GET  /balance
+meshy-cli api POST /text-to-3d --data '{"mode":"preview","prompt":"a cactus"}'
+```
+
+## Resources
+
+One command per endpoint. They are all registered and all supported, but they
+are indexed by `meshy resources` rather than listed in `meshy --help` — that
+help text is read on every invocation (an agent pays for the whole surface each
+time), so it should not grow with the API. `meshy <resource> --help` documents
+each one in full.
+
+| Command | Meshy endpoint | Docs |
+|---|---|---|
+| `balance` | `GET /balance` | [docs](https://docs.meshy.ai/en/api/balance) |
+| `text-to-3d` | `/text-to-3d` (v2) | [docs](https://docs.meshy.ai/en/api/text-to-3d) |
+| `image-to-3d` | `/image-to-3d` | [docs](https://docs.meshy.ai/en/api/image-to-3d) |
+| `multi-image-to-3d` | `/multi-image-to-3d` | [docs](https://docs.meshy.ai/en/api/multi-image-to-3d) |
+| `remesh` | `/remesh` | [docs](https://docs.meshy.ai/en/api/remesh) |
+| `convert` | `/convert` | [docs](https://docs.meshy.ai/en/api/convert) |
+| `resize` | `/resize` | [docs](https://docs.meshy.ai/en/api/resize) |
+| `rigging` | `/rigging` | [docs](https://docs.meshy.ai/en/api/rigging) |
+| `animate` | `/animations` | [docs](https://docs.meshy.ai/en/api/animations) |
+| `retexture` | `/retexture` | [docs](https://docs.meshy.ai/en/api/retexture) |
+| `text-to-image` | `/text-to-image` | [docs](https://docs.meshy.ai/en/api/text-to-image) |
+| `image-to-image` | `/image-to-image` | [docs](https://docs.meshy.ai/en/api/image-to-image) |
+| `multi-color-print` | `/print/multi-color` | [docs](https://docs.meshy.ai/en/api/multi-color-print) |
+| `analyze-printability` | `/print/analyze` | [docs](https://docs.meshy.ai/en/api/analyze-printability) |
+| `repair-printability` | `/print/repair` | [docs](https://docs.meshy.ai/en/api/repair-printability) |
+
+Per-resource actions (all single-HTTP-call):
+
+```
+meshy-cli <resource> create [flags] [--data <json>] [--async] [--timeout <s>]
+meshy-cli <resource> get    <task-id>
+meshy-cli <resource> list   [--page <n>] [--page-size <n>] [--sort-by <field>]
+meshy-cli <resource> wait   <task-id> [--timeout <s>]
+meshy-cli <resource> delete <task-id>
+```
+
+Top-level shortcut:
+
+```
+meshy-cli delete <task-id>
+    # Meshy's DELETE is unified across resources, but GET is not, so
+    # `get`/`wait` live only on their resource.
+```
+
+`create` is **synchronous by default** — it polls until the task reaches a
+terminal status (`SUCCEEDED` / `FAILED` / `CANCELED`) or `--timeout` hits.
+Pass `--async` to return the `task_id` immediately; then call
+`<resource> get <id>` or `<resource> wait <id>` when you need the result.
+
+## Saving artifacts with `-o`
+
+When `-o` is set on a `create`/`wait`/`get`, the CLI downloads every artifact
+the task produced, writes a sidecar metadata file, and prints a status report
+instead of JSON. Single-file outputs get a per-file `<stem>_meta.json`
+(e.g. `front.jpeg` → `front_meta.json`) so two outputs can share one
+directory; directory-mode outputs share a single `meta.json`.
+
+```bash
+# Single-artifact task — pass a file path. Extension is autocorrected
+# against the response Content-Type; sharp transcodes between
+# jpg/png/webp/gif/tiff/avif so the file truly has the requested format.
+meshy-cli text-to-image create --ai-model nano-banana --prompt "a leaf" \
+  -o assets/leaf.jpeg
+
+# Multi-artifact task (3D, multi-view 2D, animation) — pass a directory.
+# Files land with role-based names: model.glb, thumbnail.png,
+# texture_0_base_color.png, animation_glb.glb, …
+meshy-cli image-to-3d wait <id> -o out/robot/
+```
+
+Existing files at the target abort with a clear `UsageError` — no silent
+overwrite. Without `-o`, the CLI keeps its pre-download JSON behavior
+(machine-readable summary on stdout).
+
+## Image and 3D-model inputs
+
+Flags that take a media source (`--image-url`, `--image-urls`,
+`--reference-image-urls`, `--texture-image-url`, `--image-style-url`,
+`--model-url`) accept:
+
+- **http(s) URLs** — preflighted with HEAD so unreachable sources fail fast.
+- **Local file paths** — absolute or relative to cwd. MIME-sniffed via magic
+  bytes (with extension fallback) and inlined as `data:` URIs on the wire.
+
+You do not need to host files. `data:` URIs on the command line are rejected
+explicitly — pass a local path instead. Missing files and 4xx/5xx responses
+exit with code `2` and a flag-prefixed message before any task is created.
+
+## Global flags
+
+| Flag | Purpose |
+|------|---------|
+| `--api-key <key>` | Override `MESHY_API_KEY` |
+| `--base-url-v1 <url>` / `--base-url-v2 <url>` | Override endpoints (staging/proxy) |
+| `--format json\|pretty\|ndjson` | Stdout format when `-o` is not set (default `json`) |
+| `-o, --output <path>` | Download artifacts to a file/directory; write `meta.json`; switch stdout to a status report |
+| `-v, --verbose` | Debug logging to stderr |
+| `--log-level <level>` | `debug \| info \| warn \| error \| silent` |
+
+## Exit codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | success |
+| 1 | generic / server |
+| 2 | usage (flag parse error) |
+| 3 | auth (`401`) |
+| 4 | validation (`400`, `422`) |
+| 5 | not found (`404`) |
+| 6 | rate limit (`429`) |
+| 7 | network |
+| 8 | timed out waiting for a task |
+| 9 | credit exhausted (`402`) |
+
+## Environment variables
+
+| Variable | Default |
+|---|---|
+| `MESHY_API_KEY` | — (required unless a profile is stored) |
+| `MESHY_BASE_URL_V1` | `https://api.meshy.ai/openapi/v1` |
+| `MESHY_BASE_URL_V2` | `https://api.meshy.ai/openapi/v2` |
+| `MESHY_OAUTH_AUTHORIZE_URL` | `https://www.meshy.ai/oauth/authorize` — override for staging/testing |
+| `MESHY_CLI_NO_BROWSER` | unset — set to `1` to suppress browser open (URL still printed to stderr) |
+| `MESHY_CONNECT_TIMEOUT_MS` | `10000` |
+| `MESHY_READ_TIMEOUT_MS` | `120000` |
+| `MESHY_POLL_INTERVAL_MS` | `3000` |
+| `MESHY_LOG_LEVEL` | `warn` |
+| `MESHY_CLI_NO_UPDATE_NOTIFIER` | unset — any non-empty value disables update checks; CI envs (`CI`, `GITHUB_ACTIONS`, `BUILD_NUMBER`, `RUN_ID`) auto-skip |
+
+## Update notifications
+
+meshy-cli checks the npm registry for a newer version at most once per 24 hours. The result is cached at `~/.config/meshy/update-state.json`. The refresh runs in a detached background process so it can never slow down or fail a command.
+
+When a newer version is available:
+
+- **JSON object outputs** (`--format json` when the result is an object) carry a top-level `_notice.update = { current, latest, message, command }` so agents can relay it to the user.
+- **ndjson arrays** carry `_notice.update` on the **first line only** (the first element, if it is a plain object).
+- **Plain JSON arrays** (`--format json` with an array result) are intentionally left untouched — there is no clean metadata slot in a JSON array without breaking the schema.
+- **Humans on an interactive terminal** get a single line on stderr after the command output.
+- **stdout is never polluted** — the notice never appears on stdout.
+- **Skipped automatically** in CI environments and for development builds.
+
+## Agent skills
+
+The `skills/` directory contains markdown-based skills for AI coding agents
+(Claude Code, etc.):
+
+- [`skills/meshy-cli`](skills/meshy-cli/SKILL.md) — a single skill covering
+  setup, `make`, the shared verb contract, the API constraints that produce
+  failed tasks when ignored, and the exit-code table.
+
+  It is deliberately short. A skill is loaded into an agent's context on every
+  invocation, so length is a running cost; anything an agent can look up on
+  demand (`meshy resources`, `meshy <resource> --help`,
+  <https://docs.meshy.ai/en/api/>) is linked rather than copied.
+
+## Project layout
+
+```
+meshy-cli/
+├── src/
+│   ├── index.ts             # CLI entry
+│   ├── root.ts              # root command + global flag wiring
+│   ├── cmd/                 # make + resources + api/balance/delete + one file per endpoint
+│   ├── client/              # Meshy HTTP client (v1 + v2 fetchers, typed endpoints)
+│   └── internal/
+│       ├── config.ts        # env + flag → runtime config
+│       ├── runtime.ts       # lazy client/config construction
+│       ├── make-plan.ts     # make's route choice + step list (pure, offline)
+│       ├── pricing.ts       # credit estimates for the chains make runs
+│       ├── task-command.ts  # create/get/list/wait/delete factory
+│       ├── poll.ts          # backoff polling until terminal
+│       ├── file-input.ts    # image + 3D-model flag resolution (URL or local)
+│       ├── download.ts      # -o artifact download, meta.json, extension fix
+│       ├── report.ts        # Status: SUCCESS / FAIL stdout formatter
+│       ├── output.ts        # json / pretty / ndjson writers
+│       ├── payload.ts       # --data parsing, mergePayload, dropNullish
+│       ├── flags.ts         # parseBool / parseInt10 / parseCsv helpers
+│       ├── errors.ts        # UsageError + exit-code mapping
+│       ├── global-options.ts  # mirror --format etc. onto subcommands
+│       └── logger.ts        # leveled stderr logger
+├── tests/                   # node:test unit + integration tests
+├── skills/                  # agent-facing markdown skill (published with the package)
+├── internal-assets/         # not published, not mirrored — see its README
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## Design notes
+
+- **Two layers, one of them opinion-free.** `make` chains endpoints; the
+  resource commands expose them one at a time. `make` picks its chain from the
+  input type alone and stops there. Every richer decision — going through an
+  image first, confirming a shape before texturing, a polycount that rigs well
+  — is a judgement about someone else's asset and someone else's credits, so it
+  stays with the caller rather than being baked into a default.
+- **Plan first, then spend.** `make` computes the whole chain before creating
+  anything, so `--dry-run` and a real run share one code path and one estimate.
+  `--max-credits` refuses on that estimate; a budget enforced after step one has
+  billed is not a budget.
+- **Two fetchers.** `text-to-3d` lives under `/openapi/v2`, everything else on
+  `/openapi/v1`. The client holds both and routes per endpoint.
+- **Uniform verbs.** A single `buildResourceCommand` factory generates
+  `get`/`list`/`wait`/`delete` for every resource. Resource modules only
+  contribute their unique `create` flag shape.
+- **`--data` escape hatch.** Every `create` accepts a raw JSON object (or
+  `@file.json`) that merges with structured flags. Use this when Meshy ships a
+  new field before the CLI models it.
+- **Stdout is reserved for command output.** Logs and errors go to stderr so
+  pipes (`| jq`, `-o file`) stay clean.
+
+## Releasing
+
+Versions are tag-driven and fully automated — there is no manual publish
+step. `package.json` is the single source of truth for the version (the CLI
+reads it at startup, and a test asserts `VERSION === package.json#version`).
+
+```bash
+# 1. bump the version (also updates the lockfile-free metadata)
+npm version patch        # or minor / major
+# 2. push the commit and the tag
+git push && git push --tags
+```
+
+Pushing the `vX.Y.Z` tag runs
+[`.github/workflows/release.yml`](.github/workflows/release.yml):
+typecheck → test → build → verify tag == `package.json#version` →
+`npm publish --access public` for both `meshy-cli` and the scoped alias
+`@meshy-ai/cli`. One-time prerequisites: the repo must be public and an
+`NPM_TOKEN` secret with publish rights must be configured.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/client/endpoints/analyze-printability.d.ts

@@ -0,0 +1,5 @@
+import { TaskEndpoint, type HttpFetch } from "./base.js";
+export declare class AnalyzePrintabilityEndpoint extends TaskEndpoint {
+    constructor(http: HttpFetch);
+}
+//# sourceMappingURL=analyze-printability.d.ts.map

package/dist/client/endpoints/analyze-printability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-printability.d.ts","sourceRoot":"","sources":["../../../src/client/endpoints/analyze-printability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAEzD,qBAAa,2BAA4B,SAAQ,YAAY;gBAC/C,IAAI,EAAE,SAAS;CAG5B"}

package/dist/client/endpoints/analyze-printability.js

@@ -0,0 +1,7 @@
+import { TaskEndpoint } from "./base.js";
+export class AnalyzePrintabilityEndpoint extends TaskEndpoint {
+    constructor(http) {
+        super(http, "/print/analyze");
+    }
+}
+//# sourceMappingURL=analyze-printability.js.map

package/dist/client/endpoints/analyze-printability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-printability.js","sourceRoot":"","sources":["../../../src/client/endpoints/analyze-printability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkB,MAAM,WAAW,CAAC;AAEzD,MAAM,OAAO,2BAA4B,SAAQ,YAAY;IAC3D,YAAY,IAAe;QACzB,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/client/endpoints/animate.d.ts

@@ -0,0 +1,6 @@
+import { TaskEndpoint, type HttpFetch } from "./base.js";
+/** POST /openapi/v1/animations — plural path. */
+export declare class AnimateEndpoint extends TaskEndpoint {
+    constructor(http: HttpFetch);
+}
+//# sourceMappingURL=animate.d.ts.map

package/dist/client/endpoints/animate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../../../src/client/endpoints/animate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAEzD,iDAAiD;AACjD,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,IAAI,EAAE,SAAS;CAG5B"}

package/dist/client/endpoints/animate.js

@@ -0,0 +1,8 @@
+import { TaskEndpoint } from "./base.js";
+/** POST /openapi/v1/animations — plural path. */
+export class AnimateEndpoint extends TaskEndpoint {
+    constructor(http) {
+        super(http, "/animations");
+    }
+}
+//# sourceMappingURL=animate.js.map

package/dist/client/endpoints/animate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.js","sourceRoot":"","sources":["../../../src/client/endpoints/animate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkB,MAAM,WAAW,CAAC;AAEzD,iDAAiD;AACjD,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,IAAe;QACzB,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/client/endpoints/balance.d.ts

@@ -0,0 +1,9 @@
+/** GET /openapi/v1/balance */
+import { type Balance } from "../types.js";
+import type { HttpFetch } from "./base.js";
+export declare class BalanceEndpoint {
+    private readonly http;
+    constructor(http: HttpFetch);
+    get(): Promise<Balance>;
+}
+//# sourceMappingURL=balance.d.ts.map

package/dist/client/endpoints/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../../src/client/endpoints/balance.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAG9B,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;gBAErB,IAAI,EAAE,SAAS;IAIrB,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;CAgB9B"}

package/dist/client/endpoints/balance.js

@@ -0,0 +1,27 @@
+/** GET /openapi/v1/balance */
+import { mapHttpError, MeshyApiError } from "../errors.js";
+import { BalanceSchema } from "../types.js";
+export class BalanceEndpoint {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async get() {
+        const resp = await this.http("/balance", { method: "GET" });
+        if (!resp.ok)
+            throw await mapHttpError(resp, "/balance");
+        const raw = await resp.json();
+        const parsed = BalanceSchema.safeParse(raw);
+        if (!parsed.success) {
+            throw new MeshyApiError({
+                message: `unexpected balance shape: ${parsed.error.message}`,
+                status: resp.status,
+                code: "server",
+                path: "/balance",
+                body: raw,
+            });
+        }
+        return parsed.data;
+    }
+}
+//# sourceMappingURL=balance.js.map

package/dist/client/endpoints/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../../src/client/endpoints/balance.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAG1D,MAAM,OAAO,eAAe;IACT,IAAI,CAAY;IAEjC,YAAY,IAAe;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,MAAM,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACzD,MAAM,GAAG,GAAY,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,aAAa,CAAC;gBACtB,OAAO,EAAE,6BAA6B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;gBAC5D,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,GAAG;aACV,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;CACF"}

package/dist/client/endpoints/base.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Base class for async-task Meshy endpoints:
+ *   POST   /<resource>               → { result: <task_id> }
+ *   GET    /<resource>/:id           → Task
+ *   GET    /<resource>               → Task[]
+ *   DELETE /<resource>/:id           → 200
+ */
+import { type Task } from "../types.js";
+export type HttpFetch = (path: string, init?: RequestInit) => Promise<Response>;
+export interface ListParams {
+    page_num?: number;
+    page_size?: number;
+    sort_by?: string;
+}
+export declare class TaskEndpoint {
+    readonly resourcePath: string;
+    protected readonly http: HttpFetch;
+    constructor(http: HttpFetch, resourcePath: string);
+    create(payload: Record<string, unknown>): Promise<string>;
+    retrieve(taskId: string): Promise<Task>;
+    list(params?: ListParams): Promise<Task[]>;
+    delete(taskId: string): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/client/endpoints/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/client/endpoints/base.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAGL,KAAK,IAAI,EACV,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAEvB,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM;IAQ3C,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBzD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvC,IAAI,CAAC,MAAM,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAgB9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM5C"}

package/dist/client/endpoints/base.js

@@ -0,0 +1,87 @@
+/**
+ * Base class for async-task Meshy endpoints:
+ *   POST   /<resource>               → { result: <task_id> }
+ *   GET    /<resource>/:id           → Task
+ *   GET    /<resource>               → Task[]
+ *   DELETE /<resource>/:id           → 200
+ */
+import { mapHttpError, MeshyApiError } from "../errors.js";
+import { TaskCreateResponseSchema, TaskSchema, } from "../types.js";
+export class TaskEndpoint {
+    resourcePath;
+    http;
+    constructor(http, resourcePath) {
+        if (!resourcePath.startsWith("/")) {
+            throw new Error(`resourcePath must start with "/" (got ${resourcePath})`);
+        }
+        this.http = http;
+        this.resourcePath = resourcePath;
+    }
+    async create(payload) {
+        const resp = await this.http(this.resourcePath, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload ?? {}),
+        });
+        if (!resp.ok)
+            throw await mapHttpError(resp, this.resourcePath);
+        const raw = await resp.json();
+        const parsed = TaskCreateResponseSchema.safeParse(raw);
+        if (!parsed.success) {
+            throw new MeshyApiError({
+                message: `unexpected response from POST ${this.resourcePath}: ${parsed.error.message}`,
+                status: resp.status,
+                code: "server",
+                path: this.resourcePath,
+                body: raw,
+            });
+        }
+        return parsed.data.result;
+    }
+    async retrieve(taskId) {
+        if (!taskId)
+            throw new Error("task_id is required");
+        const path = `${this.resourcePath}/${encodeURIComponent(taskId)}`;
+        const resp = await this.http(path, { method: "GET" });
+        if (!resp.ok)
+            throw await mapHttpError(resp, path);
+        const raw = await resp.json();
+        const parsed = TaskSchema.safeParse(raw);
+        if (!parsed.success) {
+            throw new MeshyApiError({
+                message: `unexpected task shape from GET ${path}: ${parsed.error.message}`,
+                status: resp.status,
+                code: "server",
+                path,
+                body: raw,
+            });
+        }
+        return parsed.data;
+    }
+    async list(params = {}) {
+        const search = new URLSearchParams();
+        search.set("page_num", String(params.page_num ?? 1));
+        search.set("page_size", String(params.page_size ?? 10));
+        search.set("sort_by", params.sort_by ?? "-created_at");
+        const path = `${this.resourcePath}?${search.toString()}`;
+        const resp = await this.http(path, { method: "GET" });
+        if (!resp.ok)
+            throw await mapHttpError(resp, this.resourcePath);
+        const raw = await resp.json();
+        if (!Array.isArray(raw))
+            return [];
+        return raw.map((t) => {
+            const parsed = TaskSchema.safeParse(t);
+            return parsed.success ? parsed.data : t;
+        });
+    }
+    async delete(taskId) {
+        if (!taskId)
+            throw new Error("task_id is required");
+        const path = `${this.resourcePath}/${encodeURIComponent(taskId)}`;
+        const resp = await this.http(path, { method: "DELETE" });
+        if (!resp.ok)
+            throw await mapHttpError(resp, path);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/client/endpoints/base.js.map

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

package/dist/client/endpoints/convert.d.ts

@@ -0,0 +1,5 @@
+import { TaskEndpoint, type HttpFetch } from "./base.js";
+export declare class ConvertEndpoint extends TaskEndpoint {
+    constructor(http: HttpFetch);
+}
+//# sourceMappingURL=convert.d.ts.map

package/dist/client/endpoints/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/client/endpoints/convert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAEzD,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,IAAI,EAAE,SAAS;CAG5B"}

package/dist/client/endpoints/convert.js

@@ -0,0 +1,7 @@
+import { TaskEndpoint } from "./base.js";
+export class ConvertEndpoint extends TaskEndpoint {
+    constructor(http) {
+        super(http, "/convert");
+    }
+}
+//# sourceMappingURL=convert.js.map

package/dist/client/endpoints/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/client/endpoints/convert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkB,MAAM,WAAW,CAAC;AAEzD,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,IAAe;QACzB,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1B,CAAC;CACF"}