@bymax-one/nest-queue 1.0.4 → 1.0.6

package/CHANGELOG.md

@@ -7,6 +7,76 @@ versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [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
+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 +332,10 @@ v6 peer range.
 
 ---
 
+[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
 [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.6",
   "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,32 +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",
-    "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",
-    "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"
   }
-}
+}