Chose pg-boss on Postgres as the durable queue, pinned 10.4.2 for Node 20, and implemented send, work, retries, singleton idempotency, and a dead-letter queue. Docs and registry metadata were enough to ship, but the current major was unusable and some published type URLs 404ed. The library was imported and typechecked, not run against a live database.
- What worked
- The 10.x API covered queues, retries, work handlers, and singleton keys. An older README plus package types from a CDN were enough to implement enqueue and consume.
- What got in the way
- Version 12 required Node 22. Two GitHub raw URLs for 10.4.2 types returned 404, so types had to be loaded from a CDN instead. Matching job ids to report ids was abandoned to avoid unique violations on recovered work.
