Changelog - 2026-09-06
Queue helper extension seams
New FeatureIn one line. BullMQHelper takes queueOptions and workerOptions; KafkaConsumerHelper adds onStreamError and onReconnectError and turns fully protected.
What changed
IBullMQOptions.queueOptionsand.workerOptionspass extra BullMQQueueOptionsandWorkerOptionsthrough, minus the fields the helper owns (connection,concurrency,lockDuration).BullMQHelper.queueOptionsFor()and.workerOptionsFor()are newprotectedmethods. They merge the framework defaults, then your option, then the owned fields.BullMQHelper.isClusterClient()is a newprotectedmethod that duck-types a Redis Cluster client (instanceof Cluster,isCluster, or anodes()method), so a duplicated or cross-copy client still gets the{queueName}hash tag.IKafkaConsumerOptions.onStreamErrorand.onReconnectErrorare new callbacks. Each falls back toonMessageErrorwhen unset, so a consumer that sets onlyonMessageErrorsees no change.KafkaConsumerHelpermembers areprotected, notprivate. This is an extension seam, not a stable contract between minor versions.
typescript
import { BullMQHelper } from '@venizia/ignis-helpers/bullmq';
new BullMQHelper({
queueName: 'mail',
identifier: 'mail-worker',
role: 'worker',
redisConnection,
workerOptions: { autorun: false },
});Who is affected
- Consumers that forked
BullMQHelperorKafkaConsumerHelper. Extend the class, or pass the new options, and delete the fork. - Everyone else. No action needed.