resonate-http-service-design-typescript

What problem does it solve?

HTTP route handlers are ephemeral and cannot safely perform long-running or replay-sensitive work; this Skill helps map HTTP requests to durable Resonate workflows so APIs remain responsive, idempotent, and crash-safe.

Core Features & Use Cases

• Async job orchestration: Patterns to submit jobs, poll status, or await callbacks and webhooks while workflows perform the work.
• Service decomposition & RPC: Best practices for separating API, worker, and DB services and invoking durable RPC between groups.
• Determinism & idempotency: Promise ID strategies, deterministic APIs (ctx.date.now, ctx.math.random), and guidance on detaching side effects and handling retries.
• Error handling & concurrency: Structured concurrency examples, timeout and retry controls, and treating promise-exists errors as idempotent outcomes.
• Use Case: Build a TypeScript Express/Fastify API where POST /jobs begins a durable "process-job" workflow, workers call db RPC methods, and external webhooks resolve approval promises.

Quick Start

Create a POST /jobs endpoint that begins a durable workflow named process-job, returns 202 with a jobId, and uses stable promise IDs for idempotency.