@bymax-one/nest-queue 1.0.6 → 1.0.7

package/CHANGELOG.md

@@ -7,6 +7,43 @@ versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [1.0.7] — 2026-08-04
+
+**Runtime change.** `dist/` differs from `1.0.6`: the four decorators no longer carry
+a `reflect-metadata` side-effect import, so the built bundle no longer references the
+package at all.
+
+### Fixed
+
+- **The application owns the `reflect-metadata` polyfill.** `@Processor`, `@Process`,
+  `@OnWorkerEvent` and `@OnQueueEvent` each imported it for its side effect. None of
+  the other eight `@bymax-one` libraries does — the polyfill is global state the
+  application initialises once in `main.ts`, and NestJS pulls it in regardless:
+  importing `@nestjs/common` alone takes `Reflect.defineMetadata` from `undefined` to
+  `function`. Nothing here needed to load it.
+
+  Carrying it also contradicted this package's own `"sideEffects": false`, which
+  asserts that no module has a side effect while importing something whose entire
+  purpose is one.
+
+  The cost was measurable in a consumer's bundle: with the import present, esbuild
+  inlines the polyfill, taking a minimal bundle from **53 kB to 95 kB** even when the
+  application had already loaded it.
+
+  Nothing changes for a correctly wired application. The decorators are reachable
+  only through the `.` subpath, whose bundle imports `@nestjs/common` on its first
+  line — so the polyfill is present before any decorator body runs, which the tests
+  and a real consumer both confirm.
+
+### Changed
+
+- **The Quick Start shows the `main.ts` entry point**, with `import 'reflect-metadata'`
+  as its first line, and the peer matrix states plainly that the polyfill belongs to
+  the application. Previously the README named `reflect-metadata` only as a peer, which
+  was survivable while the library loaded it and is not now.
+
+---
+
 ## [1.0.6] — 2026-08-02
 
 Metadata only. `dist/` is byte-identical to `1.0.5` — verified by diffing a fresh
@@ -332,6 +369,7 @@ v6 peer range.
 
 ---
 
+[1.0.7]: https://github.com/bymaxone/nest-queue/compare/v1.0.6...v1.0.7
 [1.0.6]: https://github.com/bymaxone/nest-queue/releases/tag/v1.0.6
 [1.0.5]: https://github.com/bymaxone/nest-queue/releases/tag/v1.0.5
 [1.0.4]: https://github.com/bymaxone/nest-queue/releases/tag/v1.0.4

package/README.md

@@ -120,6 +120,12 @@ Both subpaths ship ESM **and** CommonJS with declarations for each format, so a
 | `./shared`   | None                                                                                                      |
 | Optional     | `bullmq-otel ^1` (OpenTelemetry)                                                                          |
 
+> [!IMPORTANT]
+> `reflect-metadata` is a **global polyfill the application owns** — import it once at
+> the top of `main.ts`. This library never imports it, so it cannot be shipped twice
+> into your bundle; NestJS pulls it in as well, which is why a correctly wired
+> application already has it before a decorator runs.
+
 ---
 
 > [!TIP]
@@ -137,7 +143,24 @@ Both subpaths ship ESM **and** CommonJS with declarations for each format, so a
 ## 🚀 Quick Start
 
 ```bash
-pnpm add @bymax-one/nest-queue bullmq ioredis
+pnpm add @bymax-one/nest-queue bullmq ioredis reflect-metadata
+```
+
+`reflect-metadata` is loaded **once by your application**, before anything else — this
+is the standard NestJS entry point and the decorators in this library depend on it:
+
+```typescript
+// main.ts
+import 'reflect-metadata'
+import { NestFactory } from '@nestjs/core'
+import { AppModule } from './app.module'
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule)
+  await app.listen(3000)
+}
+
+void bootstrap()
 ```
 
 Wire the module in your root `AppModule`:

package/dist/server/index.cjs

@@ -5,7 +5,6 @@ var core = require('@nestjs/core');
 var ioredis = require('ioredis');
 var bullmq = require('bullmq');
 var path = require('path');
-require('reflect-metadata');
 
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __decorateClass = (decorators, target, key, kind) => {
@@ -1440,6 +1439,8 @@ exports.BymaxQueueModule = class BymaxQueueModule extends ConfigurableModuleClas
 exports.BymaxQueueModule = __decorateClass([
   common.Module({})
 ], exports.BymaxQueueModule);
+
+// src/server/decorators/processor.decorator.ts
 function Processor(queueName, options) {
   return (target) => {
     const concurrencyOmitted = options?.concurrency === void 0;
@@ -1455,6 +1456,8 @@ function Processor(queueName, options) {
     Reflect.defineMetadata(PROCESSOR_METADATA_KEY, metadata, target);
   };
 }
+
+// src/server/decorators/process.decorator.ts
 function Process(jobName) {
   return (target, propertyKey) => {
     const existing = Reflect.getOwnMetadata(PROCESS_HANDLERS_METADATA_KEY, target.constructor) ?? [];
@@ -1462,6 +1465,8 @@ function Process(jobName) {
     Reflect.defineMetadata(PROCESS_HANDLERS_METADATA_KEY, [...existing, entry], target.constructor);
   };
 }
+
+// src/server/decorators/on-worker-event.decorator.ts
 function OnWorkerEvent(eventName) {
   return (target, propertyKey) => {
     const existing = Reflect.getOwnMetadata(
@@ -1475,6 +1480,8 @@ function OnWorkerEvent(eventName) {
     );
   };
 }
+
+// src/server/decorators/on-queue-event.decorator.ts
 function OnQueueEvent(eventName) {
   return (target, propertyKey) => {
     const existing = Reflect.getOwnMetadata(

package/dist/server/index.d.cts

@@ -1102,7 +1102,6 @@ declare function Processor(queueName: string, options?: WorkerOptions): ClassDec
  * class coexist without overwriting each other.
  * @layer server/decorators
  */
-
 /**
  * Marks a method as a job processor. If `jobName` is supplied the method is
  * only invoked for jobs whose `name` matches; if omitted the method acts as a
@@ -1135,7 +1134,6 @@ declare function Process(jobName?: string): MethodDecorator;
  * and timing fields. Use `'progress'` to observe `job.updateProgress()`.
  * @layer server/decorators
  */
-
 /**
  * Union of BullMQ `Worker` event names surfaced by this library. Handlers
  * registered with `@OnWorkerEvent` receive the **full** `Job` instance for
@@ -1195,7 +1193,6 @@ declare function OnWorkerEvent(eventName: WorkerEventName): MethodDecorator;
  * To inspect the full `Job`, call `QueueService.getJob(jobId)`.
  * @layer server/decorators
  */
-
 /**
  * Union of BullMQ `QueueEvents` event names surfaced by this library. Listeners
  * registered with `@OnQueueEvent` receive a serialized event payload, NOT the

package/dist/server/index.d.ts

@@ -1102,7 +1102,6 @@ declare function Processor(queueName: string, options?: WorkerOptions): ClassDec
  * class coexist without overwriting each other.
  * @layer server/decorators
  */
-
 /**
  * Marks a method as a job processor. If `jobName` is supplied the method is
  * only invoked for jobs whose `name` matches; if omitted the method acts as a
@@ -1135,7 +1134,6 @@ declare function Process(jobName?: string): MethodDecorator;
  * and timing fields. Use `'progress'` to observe `job.updateProgress()`.
  * @layer server/decorators
  */
-
 /**
  * Union of BullMQ `Worker` event names surfaced by this library. Handlers
  * registered with `@OnWorkerEvent` receive the **full** `Job` instance for
@@ -1195,7 +1193,6 @@ declare function OnWorkerEvent(eventName: WorkerEventName): MethodDecorator;
  * To inspect the full `Job`, call `QueueService.getJob(jobId)`.
  * @layer server/decorators
  */
-
 /**
  * Union of BullMQ `QueueEvents` event names surfaced by this library. Listeners
  * registered with `@OnQueueEvent` receive a serialized event payload, NOT the

package/dist/server/index.mjs

@@ -3,7 +3,6 @@ import { DiscoveryService, DiscoveryModule } from '@nestjs/core';
 import { Redis } from 'ioredis';
 import { Worker, QueueEvents, Queue, FlowProducer } from 'bullmq';
 import { isAbsolute, extname } from 'path';
-import 'reflect-metadata';
 
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __decorateClass = (decorators, target, key, kind) => {
@@ -1438,6 +1437,8 @@ var BymaxQueueModule = class extends ConfigurableModuleClass {
 BymaxQueueModule = __decorateClass([
   Module({})
 ], BymaxQueueModule);
+
+// src/server/decorators/processor.decorator.ts
 function Processor(queueName, options) {
   return (target) => {
     const concurrencyOmitted = options?.concurrency === void 0;
@@ -1453,6 +1454,8 @@ function Processor(queueName, options) {
     Reflect.defineMetadata(PROCESSOR_METADATA_KEY, metadata, target);
   };
 }
+
+// src/server/decorators/process.decorator.ts
 function Process(jobName) {
   return (target, propertyKey) => {
     const existing = Reflect.getOwnMetadata(PROCESS_HANDLERS_METADATA_KEY, target.constructor) ?? [];
@@ -1460,6 +1463,8 @@ function Process(jobName) {
     Reflect.defineMetadata(PROCESS_HANDLERS_METADATA_KEY, [...existing, entry], target.constructor);
   };
 }
+
+// src/server/decorators/on-worker-event.decorator.ts
 function OnWorkerEvent(eventName) {
   return (target, propertyKey) => {
     const existing = Reflect.getOwnMetadata(
@@ -1473,6 +1478,8 @@ function OnWorkerEvent(eventName) {
     );
   };
 }
+
+// src/server/decorators/on-queue-event.decorator.ts
 function OnQueueEvent(eventName) {
   return (target, propertyKey) => {
     const existing = Reflect.getOwnMetadata(

package/package.json

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