@bymax-one/nest-queue 1.0.5 → 1.0.7

package/CHANGELOG.md

@@ -7,6 +7,64 @@ 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
+build against the published tarball — so there is no runtime change.
+
+### Fixed
+
+- **The npm package page showed no documentation.** `1.0.5` reached the registry
+  with an empty `readme` field, so the page rendered nothing, even though
+  `README.md` was in the tarball all along. Publishing goes through the npm CLI
+  now instead of `pnpm publish`, and this release is what carries the README to
+  the registry.
+
+  The cause is measurable: across the five published `@bymax-one/*` libraries,
+  every package released under pnpm 11 landed with an empty `readme` and no
+  `_npmVersion`, while every one released under pnpm 10 — which delegated to the
+  npm CLI — carries both. `nest-realtime@1.0.1` confirmed it, restoring both
+  fields in a single release by switching the command.
+
+---
+
 ## [1.0.5] — 2026-08-01
 
 Documentation only. `dist/` is byte-identical to `1.0.4` — verified by diffing a
@@ -311,6 +369,8 @@ 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
 [1.0.3]: https://github.com/bymaxone/nest-queue/releases/tag/v1.0.3

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.5",
+  "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",
@@ -53,6 +53,30 @@
       ]
     }
   },
+  "scripts": {
+    "build": "pnpm clean && tsup",
+    "check:exports": "attw --pack .",
+    "check:published": "node scripts/check-published-surface.mjs",
+    "clean": "rm -rf dist coverage",
+    "lint": "eslint src scripts test",
+    "lint:fix": "eslint src scripts test --fix",
+    "mutation": "stryker run",
+    "mutation:dry-run": "stryker run --dryRunOnly",
+    "mutation:incremental": "stryker run --incremental",
+    "prepare": "husky",
+    "prepublishOnly": "pnpm clean && pnpm typecheck && pnpm test:types && pnpm lint && pnpm test:cov:all && pnpm build && pnpm check:published",
+    "release": "npm publish --provenance --access public",
+    "size": "node scripts/check-size.mjs",
+    "smoke": "node scripts/dogfood-smoke-test.mjs",
+    "test": "jest",
+    "test:all": "pnpm test && pnpm test:e2e",
+    "test:cov": "jest --coverage",
+    "test:cov:all": "jest --config jest.coverage.config.ts --coverage",
+    "test:e2e": "jest --config jest.e2e.config.ts",
+    "test:types": "tsc --noEmit -p tsconfig.typetest.json",
+    "test:watch": "jest --watch",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.server.json"
+  },
   "dependencies": {},
   "peerDependencies": {
     "@nestjs/common": "^11.0.16",
@@ -122,33 +146,12 @@
       "prettier --write"
     ]
   },
+  "packageManager": "pnpm@11.0.0",
   "engines": {
     "node": ">=24.0.0"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
-  },
-  "scripts": {
-    "build": "pnpm clean && tsup",
-    "check:exports": "attw --pack .",
-    "check:published": "node scripts/check-published-surface.mjs",
-    "clean": "rm -rf dist coverage",
-    "lint": "eslint src scripts test",
-    "lint:fix": "eslint src scripts test --fix",
-    "mutation": "stryker run",
-    "mutation:dry-run": "stryker run --dryRunOnly",
-    "mutation:incremental": "stryker run --incremental",
-    "release": "pnpm publish --provenance",
-    "size": "node scripts/check-size.mjs",
-    "smoke": "node scripts/dogfood-smoke-test.mjs",
-    "test": "jest",
-    "test:all": "pnpm test && pnpm test:e2e",
-    "test:cov": "jest --coverage",
-    "test:cov:all": "jest --config jest.coverage.config.ts --coverage",
-    "test:e2e": "jest --config jest.e2e.config.ts",
-    "test:types": "tsc --noEmit -p tsconfig.typetest.json",
-    "test:watch": "jest --watch",
-    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.server.json"
   }
-}
+}