npm install @turgo/sdk. Typed client covering the full API: auto-auth, auto-retry with backoff, auto-pagination, and webhook verification helpers. TypeScript-first with full type definitions.
Install and init
npm install @turgo/sdk, then: import { Turgo } from '@turgo/sdk'; const turgo = new Turgo({ apiKey: process.env.TURGO_API_KEY }). All resources hang off the client: turgo.contacts, turgo.sequences, turgo.signals.
The ergonomics
Auto-pagination (for await (const c of turgo.contacts.list({icpTier:'A'}))), automatic 429 backoff, typed request/response objects, and batch helpers that chunk large arrays into batch calls for you.
Webhook helper
turgo.webhooks.verify(rawBody, signatureHeader, secret) implements the full signature scheme including timestamp checks — use it in your handler middleware.
Example — fire a product signal
await turgo.signals.fire({ type: 'usage_limit_approaching', accountDomain: 'customer.com', strength: 0.8, meta: { feature: 'seats', usage: 0.92 } }) — three lines to turn product telemetry into an expansion play trigger.
