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.
# 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 environmentLuego 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
decideenvía unaIdempotency-Key—la tuya, o un UUID nuevo reutilizado por todos sus reintentos— y reintenta los errores de red, los timeouts,429,502,503y504, respetandoRetry-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-Signatureen 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
DcisionErrorcon uncodeestable. - Valores predeterminados seguros. La clave de API se valida localmente y nunca se imprime; las solicitudes usan
httpsy nunca siguen redirecciones, así que la clave no puede llegar a otro host.
Comparación
| TypeScript | Python | |
|---|---|---|
| Paquete | @dcision/sdk (packages/sdk) | dcision (packages/sdk-python) |
| Runtimes | Node.js 20+, Bun, Deno, Cloudflare Workers, Vercel Edge | Python 3.9+ |
| Dependencias | Ninguna: fetch y Web Crypto | Ninguna: la biblioteca estándar |
| Cliente | Asíncrono (promesas) | Síncrono; usa asyncio.to_thread en código async |
| Ejecutar una decisión | dcision.decide(slug, state, options) | client.decide(slug, state, ...) |
| Destinos de función | functions, decision.dispatch() | functions=, decision.dispatch() |
| Webhooks | verifyWebhook(), verifySignature() | verify_webhook(), verify_signature() |
| Cuenta y ejecuciones | me(), executions.list(), executions.iterate() | me(), executions.list(), executions.iterate() |
| Timeout de cada intento | 30 segundos | 30 segundos |
| Reintentos | 2 (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.
Límites
Todos los límites de tamaño y cantidad en un solo lugar — cuerpo de la solicitud, state y presupuesto de tokens, schema de decisión, destinos y entregas, identificadores, workspace, equipo e inicio de sesión.
SDK de TypeScript
@dcision/sdk para Node.js, Bun, Deno y runtimes edge — compilación desde el código fuente, decide, destinos y funciones, errores, reintentos idempotentes, ejecuciones, me() y verificación de webhooks.