ts-sdk-usagelisted
Install: claude install-skill suqo-ai/suqo-claude-plugin
# SUQO TypeScript SDK — usage
`@suqo/sdk`, server-side only — it holds a full-access API key and must never
be bundled into browser code. Node ≥18, zero runtime dependencies (`fetch`
and `node:crypto` are both built in), strict TypeScript, dual ESM/CJS build.
**Not yet published.** `npm view @suqo/sdk` 404s against the real npm
registry today (`package.json` is `0.0.1`; `specs/versioning.md`'s `1.0.0`
row is "Pending — this ticket's release," not shipped). Don't write
`npm install @suqo/sdk` as a working command — see `references/client-setup.md`
for what actually works right now (installing from a local build/tarball).
## Workflow
1. **Name the task** — checkout flow, subscription dashboard, webhook
endpoint, cancellation route, sync job.
2. **Load only the reference you need** from `references/`. Never load them
all. `references/api-surface.md` is the authority on signatures; load it
before writing any SDK call.
3. **Start from a template** in `templates/` when one is close, rather than
writing from scratch.
4. **Write against documented methods only.** If a reference doesn't cover
something, say so — do not invent a method, parameter, or property. In
particular: there is no `subscriptions.retrieve(id)` at all;
`RateLimitError` exists but the live API has never thrown one;
rate-limiting and idempotency are both explicitly "planned," not
implemented, in the SDK's own docs.
5. **Verify** — `tsc --noEmit` against the real SDK types, then the
p