Visão geral dos SDKs
Os SDKs oficiais de TypeScript e Python — o que eles acrescentam ao HTTPS puro, como se comparam e como compilá-los do código-fonte até serem publicados no npm e no PyPI.
Dois SDKs oficiais encapsulam a API pública: @dcision/sdk para TypeScript e JavaScript, e dcision para Python. Eles executam decisões com retries seguros, despacham destinos de função, verificam assinaturas de webhook e leem a sua conta e as suas execuções — com o mesmo comportamento nas duas linguagens.
Ainda não publicados — compile do código-fonte
O @dcision/sdk ainda não está no npm e o dcision ainda não está no PyPI. Compile-os a partir de um checkout do repositório da Dcision, como abaixo. Até esta página dizer que foram publicados, um pacote com esses nomes no npm ou no PyPI não vem da Dcision: não o instale.
# In a checkout of the Dcision repository — Node.js 22 and pnpm 10 for the workspace
pnpm install
pnpm --filter @dcision/sdk build # TypeScript: builds packages/sdk/dist
pip install ./packages/sdk-python # Python: installs into the active environmentDepois adicione o build de TypeScript ao seu projeto com npm install /path/to/dcision/packages/sdk — veja SDK de TypeScript e SDK de Python.
O que eles acrescentam
- Retries que nunca executam uma decisão duas vezes. Toda chamada
decideenvia umIdempotency-Key— o seu, ou um UUID novo reutilizado por todos os seus retries — e repete erros de rede, timeouts,429,502,503e504, respeitandoRetry-After. Uma segunda requisição que encontra a primeira ainda rodando espera por ela em vez de falhar. - Destinos de função. Registre handlers por nome; o SDK os chama em ordem depois da decisão.
- Verificação de webhooks. Uma única chamada verifica o
Dcision-Signatureem tempo constante, o timestamp e o evento. - Respostas tipadas e um único tipo de erro. Todo campo da API é tipado, e toda falha — um erro da API, um erro de rede, um handler que lança exceção, uma assinatura inválida — é um
DcisionErrorcom umcodeestável. - Padrões seguros. A API key é validada localmente e nunca impressa; as requisições usam
httpse nunca seguem redirecionamentos, então a chave não chega a outro host.
Comparação
| TypeScript | Python | |
|---|---|---|
| Pacote | @dcision/sdk (packages/sdk) | dcision (packages/sdk-python) |
| Runtimes | Node.js 20+, Bun, Deno, Cloudflare Workers, Vercel Edge | Python 3.9+ |
| Dependências | Nenhuma — fetch e Web Crypto | Nenhuma — a biblioteca padrão |
| Cliente | Assíncrono (promises) | Síncrono; use asyncio.to_thread em código assíncrono |
| Executar uma decisão | dcision.decide(slug, state, options) | client.decide(slug, state, ...) |
| Destinos de função | functions, decision.dispatch() | functions=, decision.dispatch() |
| Webhooks | verifyWebhook(), verifySignature() | verify_webhook(), verify_signature() |
| Conta e execuções | me(), executions.list(), executions.iterate() | me(), executions.list(), executions.iterate() |
| Timeout de cada tentativa | 30 segundos | 30 segundos |
| Retries | 2 (3 tentativas) | 2 (3 tentativas) |
Sem um SDK
A API é um único POST HTTPS com JSON, então qualquer linguagem serve: veja os exemplos em cURL, JavaScript e Python em Executar uma decisão e um cliente completo com retries em Retries idempotentes. A CLI cobre o terminal e a CI — ela também é compilada do código-fonte.
Limites
Todos os limites de tamanho e de quantidade num só lugar — corpo da requisição, estado e orçamento de tokens, decision schema, destinos e entregas, identificadores, workspace, time e login.
SDK TypeScript
@dcision/sdk para Node.js, Bun, Deno e runtimes edge — compilar do código-fonte, decide, destinos e funções, erros, retries idempotentes, execuções, me() e verificação de webhooks.