durably
Steps that survive crashes. SQLite to PostgreSQL.
Documentation | Live Demo
Packages
| Package | Description |
|---|
| @coji/durably | Core library - job definitions, steps, and persistence |
| @coji/durably-react | React bindings - hooks for triggering and monitoring jobs |
Features
- Resumable — each step's result is persisted; interrupted jobs resume from the last successful step
- Parallel joins — run independent named steps concurrently and replay only unfinished branches after recovery
- Flexible storage — libSQL/Turso, PostgreSQL, better-sqlite3, or browser OPFS
- Browser + server — same API for Node.js and browsers
- Lease-based recovery — stale workers are automatically reclaimed via fencing tokens
- Auto cleanup —
retainRuns option purges old completed runs automatically
- React hooks — real-time progress via SSE, fullstack and SPA modes
- Type-safe — Zod schemas for input/output, labels, and auth context
Quick Start
pnpm add @coji/durably kysely zod @libsql/client @libsql/kysely-libsql
See the Quick Start guide, or Choosing a Database for PostgreSQL and other backends.
Development
Use Node.js 24 and pnpm 12. The exact versions are declared in package.json; pnpm downloads the development runtime automatically.
pnpm install --frozen-lockfile
pnpm --filter @coji/durably exec playwright install chromium
pnpm validate
pnpm build
pnpm doctor:check scans the React bindings and all four React examples with React Doctor. It requires a complete 100/100 score for each project and also runs as part of pnpm validate and CI. pnpm doctor shows an interactive report. Keep any rule suppression adjacent to the affected line and explain why the behavior is intentional.
Docker must be running for PostgreSQL tests. Alternatively, set DURABLY_TEST_POSTGRES_URL to an existing PostgreSQL instance.
See the dependency migration notes for package-by-package compatibility decisions and validation, and ADR-0002 for runtime and compiler setup.
License
MIT
