@bymax-one/nest-queue 1.2.7 → 1.2.9

package/CHANGELOG.md

@@ -11,6 +11,46 @@ versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [1.2.9] — 2026-11-01
+
+No action required: behaviour for an `Error` with a string `message` is unchanged, and the public API, the types
+(`index.d.ts` and `index.d.cts` are identical) and the peer ranges are unchanged. Measured with
+`diff -r` of a fresh build against the unpacked 1.2.8 tarball, only the two runtime bundles
+(`index.mjs`, `index.cjs`) differ.
+
+### Fixed
+
+- **The fallback `error` listener no longer throws on an emission that is not an `Error`.** The
+  listener the library attaches to every `Queue`, `Worker` and `QueueEvents`, and to the `FlowProducer` when flows are enabled, read
+  `err.message` directly, so `emit('error', undefined)` or `emit('error', null)` threw a `TypeError`
+  out of the listener, and out of `emit` to its caller, which can end the process. It now logs
+  whatever value arrived, falling back to a fixed phrase for one it cannot print.
+- **A rejected `enqueueBulk` with a non-`Error` reason still produces `BULK_ENQUEUE_FAILED`.**
+  The cause was read with `(err as Error).message`, which threw a `TypeError` for a `null` or
+  `undefined` rejection, replacing the typed exception; it now carries a string cause for any
+  rejected value.
+
+---
+
+## [1.2.8] — 2026-11-01
+
+No action required: behaviour, the public API, the types and the peer ranges are unchanged.
+Measured with `diff -r` of a fresh build against the unpacked 1.2.7 tarball, `dist/` is identical;
+the package otherwise changes in `README.md`, this file and the version in `package.json`.
+
+### Documentation
+
+- **The README now states how many Redis connections the library holds.** A new "Redis connections"
+  section gives the budget measured against Redis 8: 1 for the module in Mode B and none of its own
+  in Mode A, 2 per worker, 2 per queue observed with `@OnQueueEvent`, and none for producers and
+  flows, all released on close. It carries a worked example (20 workers and 5 observed queues hold
+  51 connections in Mode B) and a note on connection quotas of managed Redis plans.
+- **The Mode B description of the connections was wrong.** It said the library opens one connection
+  per worker and per observed queue; each of those holds two, a blocking connection and a command
+  connection.
+
+---
+
 ## [1.2.7] — 2026-10-31
 
 Action required if your `connection.url` can be empty or malformed: an invalid or empty
@@ -728,7 +768,9 @@ v6 peer range.
 
 ---
 
-[Unreleased]: https://github.com/bymaxone/nest-queue/compare/v1.2.7...HEAD
+[Unreleased]: https://github.com/bymaxone/nest-queue/compare/v1.2.9...HEAD
+[1.2.9]: https://github.com/bymaxone/nest-queue/compare/v1.2.8...v1.2.9
+[1.2.8]: https://github.com/bymaxone/nest-queue/compare/v1.2.7...v1.2.8
 [1.2.7]: https://github.com/bymaxone/nest-queue/compare/v1.2.6...v1.2.7
 [1.2.6]: https://github.com/bymaxone/nest-queue/compare/v1.2.5...v1.2.6
 [1.2.5]: https://github.com/bymaxone/nest-queue/compare/v1.2.4...v1.2.5

package/README.md

@@ -313,8 +313,41 @@ BymaxQueueModule.forRoot({
 })
 ```
 
-The library opens one connection for queues, one per worker and one per queue that has an
-`@OnQueueEvent` listener. The worker and `QueueEvents` connections carry `maxRetriesPerRequest: null`.
+The library opens one connection for all queues and flows, and two for each worker and for each
+queue that has an `@OnQueueEvent` listener ([the budget is below](#-redis-connections)). The worker
+and `QueueEvents` connections carry `maxRetriesPerRequest: null`.
+
+---
+
+## 🔌 Redis connections
+
+How many connections the library holds is linear in what you register, so you can budget it before
+you deploy. Counts were read from `INFO clients` against Redis 8 with BullMQ 6 and `ioredis` 6, and
+every connection is released when the application context closes.
+
+| What you register                              | Connections held                                                               |
+| ---------------------------------------------- | ------------------------------------------------------------------------------ |
+| The module (Mode B, library-owned connection)  | 1, shared by every producer and every flow                                     |
+| The module (Mode A, your client)               | 0 of its own; your client is yours and is never counted                        |
+| A queue you enqueue to, with `QueueService`    | 0 more: queues share the module's connection                                   |
+| `FlowService` (flows enabled)                  | 0 more                                                                         |
+| Each worker (`@Processor` or `WorkerRegistry`) | 2: a blocking connection that waits for jobs, and a command connection         |
+| Each queue observed with `@OnQueueEvent`       | 2: a blocking connection that reads the event stream, and a command connection |
+
+Producers and flows add nothing, so the cost comes from consumers. The blocking connection of a
+worker cannot be shared: it is parked inside a blocking command until a job arrives.
+
+**Worked example.** One application instance in Mode B with 20 workers and 5 queues observed with
+`@OnQueueEvent` holds 1 + (2 × 20) + (2 × 5) = **51** connections; in Mode A the same instance holds
+50, plus whatever your own client uses. Each instance of the application opens its own set, so three
+instances hold 153.
+
+**Managed Redis.** Hosted Redis plans cap the number of concurrent connections, and a plan sized for
+a handful of clients is exhausted by one instance with a few dozen workers. Multiply the table by
+the number of instances you run (include rolling deploys, where old and new instances overlap) and
+compare it with the limit of your plan; self-managed Redis allows 10 000 by default (`maxclients`).
+In `CLIENT LIST`, the blocking connection of a worker has a name that starts with
+`<prefix>:<base64 of the queue name>`, which identifies it; the command connection is unnamed.
 
 ---
 

package/dist/server/index.cjs

@@ -368,10 +368,22 @@ function validateJobSchedulerOptions(repeat) {
   }
 }
 
+// src/server/utils/describe-error.ts
+function describeError(cause) {
+  try {
+    if (typeof cause === "object" && cause !== null && "message" in cause) {
+      if (typeof cause.message === "string") return cause.message;
+    }
+    return String(cause);
+  } catch {
+    return "unknown error";
+  }
+}
+
 // src/server/utils/attach-error-listener.ts
 function attachDefaultErrorListener(emitter, logger, kind, queueName) {
   emitter.on("error", (err) => {
-    logger.error(`${kind} for queue "${queueName}" emitted an error: ${err.message}`);
+    logger.error(`${kind} for queue "${queueName}" emitted an error: ${describeError(err)}`);
   });
 }
 
@@ -503,7 +515,7 @@ exports.QueueService = class QueueService {
         QUEUE_ERROR_CODES.BULK_ENQUEUE_FAILED,
         common.HttpStatus.INTERNAL_SERVER_ERROR,
         {
-          cause: err.message
+          cause: describeError(err)
         }
       );
     }
@@ -809,20 +821,6 @@ exports.MetricsService = class MetricsService {
 exports.MetricsService = __decorateClass([
   common.Injectable()
 ], exports.MetricsService);
-
-// src/server/utils/describe-error.ts
-function describeError(cause) {
-  try {
-    if (typeof cause === "object" && cause !== null && "message" in cause) {
-      if (typeof cause.message === "string") return cause.message;
-    }
-    return String(cause);
-  } catch {
-    return "unknown error";
-  }
-}
-
-// src/server/services/worker-registry.service.ts
 var _entries;
 exports.WorkerRegistry = class WorkerRegistry {
   constructor(connection, options) {

package/dist/server/index.mjs

@@ -366,10 +366,22 @@ function validateJobSchedulerOptions(repeat) {
   }
 }
 
+// src/server/utils/describe-error.ts
+function describeError(cause) {
+  try {
+    if (typeof cause === "object" && cause !== null && "message" in cause) {
+      if (typeof cause.message === "string") return cause.message;
+    }
+    return String(cause);
+  } catch {
+    return "unknown error";
+  }
+}
+
 // src/server/utils/attach-error-listener.ts
 function attachDefaultErrorListener(emitter, logger, kind, queueName) {
   emitter.on("error", (err) => {
-    logger.error(`${kind} for queue "${queueName}" emitted an error: ${err.message}`);
+    logger.error(`${kind} for queue "${queueName}" emitted an error: ${describeError(err)}`);
   });
 }
 
@@ -501,7 +513,7 @@ var QueueService = class {
         QUEUE_ERROR_CODES.BULK_ENQUEUE_FAILED,
         HttpStatus.INTERNAL_SERVER_ERROR,
         {
-          cause: err.message
+          cause: describeError(err)
         }
       );
     }
@@ -807,20 +819,6 @@ var MetricsService = class {
 MetricsService = __decorateClass([
   Injectable()
 ], MetricsService);
-
-// src/server/utils/describe-error.ts
-function describeError(cause) {
-  try {
-    if (typeof cause === "object" && cause !== null && "message" in cause) {
-      if (typeof cause.message === "string") return cause.message;
-    }
-    return String(cause);
-  } catch {
-    return "unknown error";
-  }
-}
-
-// src/server/services/worker-registry.service.ts
 var _entries;
 var WorkerRegistry = class {
   constructor(connection, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bymax-one/nest-queue",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "description": "NestJS dynamic module wrapping BullMQ — typed jobs, flows, job schedulers, deduplication, OpenTelemetry, graceful shutdown",
   "author": "Bymax One <support@bymax.one>",
   "license": "MIT",