Examples

nextjs-prisma

typescript/examples/nextjs-prisma is a minimal SaaS that exercises both halves end to end — it's the app the README's demo recording comes from. Storage is SQLite via @postel/prisma, so the whole round trip runs offline with zero external infrastructure.

What's in it:

• POST /api/orders — creates an Order row and calls postel.outbound.send() inside the same prisma.$transaction. Either both commit or neither does.
• POST /api/webhooks/vendor — receives that webhook back and verifies it against the app's own JWKS.
• GET /.well-known/webhooks-keys — the app's JWKS document (Ed25519 v1a signing; no shared secret to manage).
• Two demo scripts that need no dev server:
  • pnpm demo:crash — opens the transaction, creates the order, calls send(), then gets SIGKILLed mid-transaction; the script reconnects and proves neither the order nor the outbox message survived. That's the atomic outbox, demonstrated rather than claimed.
  • pnpm demo:happy-path — the same transaction left to commit, followed by signed delivery to a JWKS-verifying receiver.

Run it:

git clone https://github.com/postel-sh/postel
cd postel/typescript && pnpm install && pnpm build
cd examples/nextjs-prisma
cp .env.example .env
pnpm dev
# in another terminal:
curl -X POST http://localhost:3000/api/orders \
  -H 'content-type: application/json' \
  -d '{"sku": "WIDGET-1", "amountCents": 1999}'

The dev server logs the delivered webhook within a second or two — business write → commit → in-process worker → signed delivery → verified receipt, in one process.

More on the way

Express + Drizzle and Hono + Postgres reference apps are planned; the migration guides meanwhile show the before/after for BullMQ, Svix, and signing-only setups.