Skip to content

Release 2.0.0

Choose a tag to compare

@github-actions github-actions released this 06 Sep 02:33
· 1 commit to main since this release
9d3ec34

Adds BullMQ 6 support and fixes queue routing, scheduler defaults, Node ESM imports, and connection lifecycle handling.

Upgrade requirements

  • Requires BullMQ >=5.58.8 <7. Earlier versions can silently ignore scheduler payload updates.
  • Resolved task queue names must be unique; ambiguous names and prefixes now throw.
  • Invalid Redis ports and worker settings now fail before startup.
  • Before upgrading to BullMQ 6, migrate legacy repeatable jobs while still on v5. Replace repeat enqueues with task.schedule, debounce with deduplication, and utc: true with tz: 'UTC'. See BullMQ's migration guide.

Fixes and additions

  • Published ESM imports resolve correctly in Node.
  • Queue and worker configuration accept omitted connections; workers inherit producer connection and Redis key prefix unless explicitly overridden.
  • Scheduler templates filter incompatible options from every defaults layer.
  • Producer connections open lazily and can be closed with the new closeAllQueues() export.
  • Handlers receive the BullMQ lock token and, where supported, cancellation signal.
  • Producer retries use bounded defaults; worker startup errors clean up previously created workers.
  • Includes the default Redis driver required by fresh BullMQ 6 installations.

Validation

Build, typechecking, lint, 14 unit tests, package imports, and Redis integration passed against BullMQ 5.58.8, 5.81.4, 6.0.0, and 6.3.4 on Bun and Node. CI runs the compatibility matrix before npm publication.