Download Latest Version
12.26.3 source code.zip (793.8 kB)
Get an email when there's a new version of pg-boss
| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| 12.26.2 source code.tar.gz | 2026-07-21 | 651.5 kB | |
| 12.26.2 source code.zip | 2026-07-21 | 788.8 kB | |
| README.md | 2026-07-21 | 1.6 kB | |
| Totals: 3 Items | 1.4 MB | 0 | |
What's Changed
Fixes
Recover silent LISTEN/NOTIFY connection drops. The dedicated listener connection could go half-open — TCP dies with no FIN and no error event — leaving notify-enabled workers silently degraded to the 30s polling backstop with no recovery. The listener now runs two independent detectors:
- TCP keepalive on the listen connection for OS-level dead-peer detection.
- Same-session heartbeat that verifies the channel subscription is still live, catching both a hung socket and a lost subscription while the socket looks fine.
On any drop it tears down, reconnects with capped backoff, re-runs LISTEN, and fires the reconnect hook so workers drain jobs missed during the gap. Works identically over SSL/TLS connections.
New options
Heartbeat and keepalive timings are now tunable via the constructor (previously hardcoded) — useful for raising the heartbeat timeout on a loaded database:
- notifyHeartbeatIntervalMs — interval between listener heartbeat checks. Default 10000.
- notifyHeartbeatTimeoutMs — per-heartbeat query timeout; the listener reconnects if a heartbeat exceeds it. Default 5000.
- notifyKeepAliveInitialDelayMs — TCP keepalive initial delay on the listener connection. Default 10000.
Defaults preserve prior behavior, so no action is needed unless you want to tune them.
New Contributors
- @unix made their first contribution in https://github.com/timgit/pg-boss/pull/851
Full Changelog: https://github.com/timgit/pg-boss/compare/12.26.1...12.26.2
