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.

Compilar do código-fonte
# 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 environment

Depois 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 decide envia um Idempotency-Key — o seu, ou um UUID novo reutilizado por todos os seus retries — e repete erros de rede, timeouts, 429, 502, 503 e 504, respeitando Retry-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-Signature em 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 DcisionError com um code estável.
  • Padrões seguros. A API key é validada localmente e nunca impressa; as requisições usam https e nunca seguem redirecionamentos, então a chave não chega a outro host.

Comparação

TypeScriptPython
Pacote@dcision/sdk (packages/sdk)dcision (packages/sdk-python)
RuntimesNode.js 20+, Bun, Deno, Cloudflare Workers, Vercel EdgePython 3.9+
DependênciasNenhuma — fetch e Web CryptoNenhuma — a biblioteca padrão
ClienteAssíncrono (promises)Síncrono; use asyncio.to_thread em código assíncrono
Executar uma decisãodcision.decide(slug, state, options)client.decide(slug, state, ...)
Destinos de funçãofunctions, decision.dispatch()functions=, decision.dispatch()
WebhooksverifyWebhook(), verifySignature()verify_webhook(), verify_signature()
Conta e execuçõesme(), executions.list(), executions.iterate()me(), executions.list(), executions.iterate()
Timeout de cada tentativa30 segundos30 segundos
Retries2 (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.

Nesta página