ts-sdk-usagelisted
Install: claude install-skill suqo-ai/suqo-claude-plugins
# 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.
**Published.** `@suqo/sdk` is live on the public npm registry:
`npm i @suqo/sdk`. Releases are automated end-to-end and publish via npm OIDC
Trusted Publishing (no stored npm tokens), with a required human approval
before anything goes live. Links: npm
<https://www.npmjs.com/package/@suqo/sdk>, repo
<https://github.com/suqo-ai/suqo-sdk-ts>, docs
<https://suqo.ai/docs/sdk> (TypeScript:
<https://suqo.ai/docs/sdk/typescript/>). See `references/client-setup.md` for
install and client construction.
## 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 explic