@doxajs/queue-pg-boss

Controlled-adoption prerelease: Publicly downloadable under Apache-2.0; Midtown Home Improvements is the sole supported consumer. External use is permitted without compatibility, support, warranty, roadmap, or production-readiness commitments.

Doxa's first-party PostgreSQL queue, outbox handoff, worker, retry, failure, schedule, and operator adapter implemented with pg-boss.

pnpm add @doxajs/queue-pg-boss

Delivery is at least once. Jobs must be idempotent. Multiple background replicas may safely admit schedules because cron declarations and interval slots use distributed identities.

When pg-boss expires an attempt, Doxa aborts its writable model session and rolls back local entity, journal, and outbox writes. PostgreSQL cancellation remains armed through operation drain and commit. A handler that settles late cannot use stale models; external effects still require idempotency.

doxa migrate installs queue-owned schedule controls and short-lived attempt-trace lineage used to link retries across worker processes. Terminal jobs remove their attempt lineage, and orphaned rows expire defensively.