Official SDKs
Typed, versioned, and generated from the RevKeen OpenAPI contract
RevKeen ships three official server-side SDKs. Every client is generated from packages/openapi/openapi.json, so the REST reference, examples, and SDK methods stay aligned.
Server-side SDKs
TypeScript
Node.js, Bun, Deno, Cloudflare Workers, Vercel Edge. @revkeen/sdk on npm · github.com/RevKeen/sdk-typescript
Go
Idiomatic context.Context + typed structs. github.com/RevKeen/sdk-go · pkg.go.dev
PHP
PHP 8.1+, PSR-4 autoloading, Laravel + Symfony adapters. revkeen/sdk-php on Packagist · github.com/RevKeen/sdk-php
Choose by runtime
| SDK | Best for | Install | Runtime |
|---|---|---|---|
| TypeScript | Node services, edge runtimes, full-stack apps | npm install @revkeen/sdk | Node.js 18+, Bun, Deno, Workers |
| Go | Backend services, workers, internal tooling | go get github.com/RevKeen/sdk-go | Go 1.21+ |
| PHP | Laravel, Symfony, WordPress, PHP applications | composer require revkeen/sdk-php | PHP 8.1+ |
Shared client shape
Every SDK exposes the same resource-oriented model — resource, method, typed params.
| TypeScript | Go | PHP |
|---|---|---|
client.customers.create({...}) | client.Customers.Create(ctx, params) | $client->customers->create([...]) |
client.invoices.finalize(id) | client.Invoices.Finalize(ctx, id) | $client->invoices->finalize($id) |
client.webhooks.verify(...) | revkeen.Webhooks.Verify(...) | WebhookVerifier::verify(...) |
for await (…) auto-paging | iter.Next() iterator | foreach ($client->…->autoPagingList()) |
What every SDK gives you
- Typed request and response — compile-time safety, autocomplete, no
interface{}/any/stdClass - Automatic retries on
5xx,429, network errors with exponential backoff - Automatic idempotency keys on safe-to-retry mutations
- Pagination helpers (
autoPagingList/ iterators) - Webhook signature verification in one line
- OAuth 2.1 + API-key auth — both first-class
- Structured errors with
code,status,request_id
Install quickly
npm install @revkeen/sdk
# or: pnpm add / yarn add / bun addgo get github.com/RevKeen/sdk-gocomposer require revkeen/sdk-phpVersioning
SDK minor versions map 1:1 to API versions. Patch versions carry bug fixes and non-breaking additions under the same API version.
| SDK | Package | Compatibility docs |
|---|---|---|
| TypeScript | @revkeen/sdk | Versioning |
| Go | github.com/RevKeen/sdk-go | Versioning |
| PHP | revkeen/sdk-php | Versioning |
See versioning for the deprecation policy and API compatibility rules.
Generation pipeline
- Source of truth: packages/openapi/openapi.json
- Each SDK repo has a GitHub Action that regenerates its client on every spec change
- A human-authored layer on top of the generated client adds idiomatic retry, pagination, webhook, and error-handling helpers
- Public releases are cut via
semantic-release