@bymax-one/nest-queue 1.0.4 → 1.0.5

package/CHANGELOG.md

@@ -7,6 +7,55 @@ versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [1.0.5] — 2026-08-01
+
+Documentation only. `dist/` is byte-identical to `1.0.4` — verified by diffing a
+fresh build against the published tarball — so there is no runtime change.
+
+### Fixed
+
+- **The README's configuration examples did not compile in a strict project.**
+  Eight snippets passed `process.env.REDIS_URL` where a `string` is required:
+
+  ```
+  TS2322: Type 'string | undefined' is not assignable to type 'string'.
+  ```
+
+  `process.env.X` is `string | undefined` under `strict`, so anyone copying the
+  Quick Start into a strict TypeScript project — the configuration this library
+  itself uses and recommends — got a type error out of the box. Now shown with a
+  fallback, which is what the code has to do anyway:
+
+  ```ts
+  connection: {
+    url: process.env.REDIS_URL ?? 'redis://localhost:6379'
+  }
+  ```
+
+  Found by `pnpm check:published`, added in the same release, which compiles the
+  README's own snippets against the built package. Nobody had reported it, and
+  nothing before this would have.
+
+### Added
+
+- **`pnpm check:published`** — a gate that verifies the published surface matches
+  the documentation, before a tag rather than after it. It scaffolds a throwaway
+  consumer, symlinks the package into its own `node_modules` so resolution runs
+  through the `exports` map into `dist/`, and then checks that the README's links
+  resolve, that its TypeScript snippets and the type tests compile against the
+  built package, and that every `v*.*.*` tag has a `## [x.y.z]` CHANGELOG section.
+
+  Each of those exists because its absence let a defect reach npm: the 404 link
+  corrected in `1.0.3`, the exported type that rejected the README's own snippet
+  corrected in `1.0.4`, and a deleted heading that would have turned release notes
+  into the generic fallback.
+
+  It runs in CI, in `release.yml`, and inside `prepublishOnly` — the last one
+  because the first publish of a package is manual by design, which is precisely
+  the path that bypasses the tag workflow.
+
+---
+
 ## [1.0.4] — 2026-08-01
 
 ### Fixed
@@ -262,6 +311,9 @@ v6 peer range.
 
 ---
 
+[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
 [1.0.2]: https://github.com/bymaxone/nest-queue/releases/tag/v1.0.2
 [1.0.1]: https://github.com/bymaxone/nest-queue/releases/tag/v1.0.1
 [1.0.0]: https://github.com/bymaxone/nest-queue/releases/tag/v1.0.0

package/README.md

@@ -149,7 +149,7 @@ import { BymaxQueueModule } from '@bymax-one/nest-queue'
 @Module({
   imports: [
     BymaxQueueModule.forRoot({
-      connection: { url: process.env.REDIS_URL },
+      connection: { url: process.env.REDIS_URL ?? 'redis://localhost:6379' },
       isGlobal: true,
     }),
   ],
@@ -259,7 +259,7 @@ Mode B lets the library own the Redis connections. Pass either a URL or raw iore
 ```typescript
 // URL form
 BymaxQueueModule.forRoot({
-  connection: { url: process.env.REDIS_URL },
+  connection: { url: process.env.REDIS_URL ?? 'redis://localhost:6379' },
   isGlobal: true,
 })
 
@@ -267,9 +267,9 @@ BymaxQueueModule.forRoot({
 BymaxQueueModule.forRoot({
   connection: {
     options: {
-      host: process.env.REDIS_HOST,
+      host: process.env.REDIS_HOST ?? 'localhost',
       port: Number(process.env.REDIS_PORT),
-      password: process.env.REDIS_PASSWORD,
+      password: process.env.REDIS_PASSWORD ?? undefined,
       tls: {},
     },
   },
@@ -345,7 +345,7 @@ Enable flows in the module options and inject the service:
 
 ```typescript
 BymaxQueueModule.forRoot({
-  connection: { url: process.env.REDIS_URL },
+  connection: { url: process.env.REDIS_URL ?? 'redis://localhost:6379' },
   flows: { enabled: true },
 })
 
@@ -370,7 +370,7 @@ Provide a per-queue snapshot with a configurable TTL cache:
 
 ```typescript
 BymaxQueueModule.forRoot({
-  connection: { url: process.env.REDIS_URL },
+  connection: { url: process.env.REDIS_URL ?? 'redis://localhost:6379' },
   metrics: { enabled: true, cacheTtlMs: 5_000 },
 })
 
@@ -562,7 +562,7 @@ Pass a `bullmq-otel` telemetry instance (optional peer dep) to trace spans from
 import { BullMQOtel } from 'bullmq-otel'
 
 BymaxQueueModule.forRoot({
-  connection: { url: process.env.REDIS_URL },
+  connection: { url: process.env.REDIS_URL ?? 'redis://localhost:6379' },
   telemetry: new BullMQOtel('my-service', tracer),
 })
 ```
@@ -602,7 +602,7 @@ Tune `drainTimeoutMs` when jobs may run longer than 30 s:
 
 ```typescript
 BymaxQueueModule.forRoot({
-  connection: { url: process.env.REDIS_URL },
+  connection: { url: process.env.REDIS_URL ?? 'redis://localhost:6379' },
   shutdown: { drainTimeoutMs: 60_000 },
 })
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bymax-one/nest-queue",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "NestJS dynamic module wrapping BullMQ — typed jobs, flows, job schedulers, deduplication, OpenTelemetry, graceful shutdown",
   "author": "Bymax One <support@bymax.one>",
   "license": "MIT",
@@ -131,23 +131,24 @@
   },
   "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",
-    "test": "jest",
-    "test:cov": "jest --coverage",
-    "test:watch": "jest --watch",
-    "test:e2e": "jest --config jest.e2e.config.ts",
-    "test:all": "pnpm test && pnpm test:e2e",
-    "test:cov:all": "jest --config jest.coverage.config.ts --coverage",
-    "test:types": "tsc --noEmit -p tsconfig.typetest.json",
     "mutation": "stryker run",
-    "mutation:incremental": "stryker run --incremental",
     "mutation:dry-run": "stryker run --dryRunOnly",
-    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.server.json",
+    "mutation:incremental": "stryker run --incremental",
+    "release": "pnpm publish --provenance",
     "size": "node scripts/check-size.mjs",
     "smoke": "node scripts/dogfood-smoke-test.mjs",
-    "check:exports": "attw --pack .",
-    "clean": "rm -rf dist coverage",
-    "release": "pnpm publish --provenance"
+    "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"
   }
 }