Jobs

@caisson/jobs is the background-work port. Trigger.dev (self-hostable) is the default driver; a test driver runs jobs deterministically under the standards gate, so suites assert on job behavior without a queue.

The contract

Billing and credit side-effects are enqueued, never run inline in a request handler. A webhook returns fast, and the money-moving work runs as a job — so a dropped connection mid-request never leaves a half-applied charge or a half-granted credit.

import { enqueue } from "@caisson/jobs";

// The webhook handler returns immediately; the credit grant runs as a job.
await enqueue("grant-credits", { accountId, sourceEventId });

The same enqueue call hits the test driver under bun run check, so the enqueue contract is verified without standing up Trigger.dev.

Related