Resumen de los SDKs

Los SDKs oficiales de TypeScript y Python — qué agregan frente a HTTPS directo, cómo se comparan y cómo compilarlos desde el código fuente hasta que se publiquen en npm y PyPI.

Dos SDKs oficiales envuelven la API pública: @dcision/sdk para TypeScript y JavaScript, y dcision para Python. Ejecutan decisiones con reintentos seguros, despachan destinos de función, verifican firmas de webhook y leen tu cuenta y tus ejecuciones, con el mismo comportamiento en ambos lenguajes.

Aún no publicados: compílalos desde el código fuente

@dcision/sdk todavía no está en npm y dcision todavía no está en PyPI. Compílalos desde una copia del repositorio de Dcision, como se indica abajo. Hasta que esta página diga que están publicados, un paquete con estos nombres en npm o PyPI no proviene de Dcision: no lo instales.

Compilar desde el código fuente
# 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

Luego agrega la compilación de TypeScript a tu proyecto con npm install /path/to/dcision/packages/sdk; consulta SDK de TypeScript y SDK de Python.

Qué agregan

  • Reintentos que nunca ejecutan una decisión dos veces. Cada llamada a decide envía una Idempotency-Key —la tuya, o un UUID nuevo reutilizado por todos sus reintentos— y reintenta los errores de red, los timeouts, 429, 502, 503 y 504, respetando Retry-After. Una segunda solicitud que encuentra la primera todavía en ejecución la espera en lugar de fallar.
  • Destinos de función. Registra handlers por nombre; el SDK los llama en orden después de la decisión.
  • Verificación de webhooks. Una sola llamada comprueba Dcision-Signature en tiempo constante, el timestamp y el evento.
  • Respuestas tipadas y un único tipo de error. Cada campo de la API está tipado, y cada fallo —un error de la API, un error de red, un handler que lanza una excepción, una firma incorrecta— es un DcisionError con un code estable.
  • Valores predeterminados seguros. La clave de API se valida localmente y nunca se imprime; las solicitudes usan https y nunca siguen redirecciones, así que la clave no puede llegar a otro host.

Comparación

TypeScriptPython
Paquete@dcision/sdk (packages/sdk)dcision (packages/sdk-python)
RuntimesNode.js 20+, Bun, Deno, Cloudflare Workers, Vercel EdgePython 3.9+
DependenciasNinguna: fetch y Web CryptoNinguna: la biblioteca estándar
ClienteAsíncrono (promesas)Síncrono; usa asyncio.to_thread en código async
Ejecutar una decisióndcision.decide(slug, state, options)client.decide(slug, state, ...)
Destinos de funciónfunctions, decision.dispatch()functions=, decision.dispatch()
WebhooksverifyWebhook(), verifySignature()verify_webhook(), verify_signature()
Cuenta y ejecucionesme(), executions.list(), executions.iterate()me(), executions.list(), executions.iterate()
Timeout de cada intento30 segundos30 segundos
Reintentos2 (3 intentos)2 (3 intentos)

Sin un SDK

La API es un único POST HTTPS con JSON, así que cualquier lenguaje sirve: consulta los ejemplos de cURL, JavaScript y Python en Ejecutar una decisión y un cliente completo con reintentos en Reintentos idempotentes. La CLI cubre la terminal y el CI; también se compila desde el código fuente.

En esta página