# What changed in @nestjs/bullmq

> 12 changes in @nestjs/bullmq 11 to 12 from its official release notes, upgrade guides and advisories: 6 breaking, 5 new APIs and options. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/npm/@nestjs/bullmq/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @nestjs/bullmq 12

### Breaking changes

- Nest packages are ESM-only; CommonJS applications can continue consuming them through require(esm) on supported Node.js versions. (12.0.0) — [upgrade guide](https://docs.nestjs.com/migration-guide)
- Lifecycle hooks are called by component hierarchy level, which can change execution order when providers or modules depend on one another. (12.0.0) — [upgrade guide](https://docs.nestjs.com/migration-guide)
- Deep imports into build internals are no longer resolvable; import from the package root instead. (12.0.0) — [release notes](https://github.com/nestjs/bull/releases/tag/%40nestjs/bullmq%4012.0.0)
- Running a Nest 12 application requires Node.js v20.19+ or v22.12+ on the 22.x line. (12.0.0) — [upgrade guide](https://docs.nestjs.com/migration-guide)
- Optional markers on constructor parameters are no longer inherited by subclasses; redeclare the marker in a subclass constructor to avoid UnknownDependenciesException. (12.0.0) — [upgrade guide](https://docs.nestjs.com/migration-guide)
- CommonJS use requires Node 20.19+, 22.12+, or 24+, where require(esm) is enabled by default. (12.0.0) — [release notes](https://github.com/nestjs/bull/releases/tag/%40nestjs/bullmq%4012.0.0)

### New APIs and options

- The observability SDK adds opt-in instrumentation through the application instrument option, reporting jobs and queue consumers in Nest terms. (12.0.0) — [upgrade guide](https://docs.nestjs.com/migration-guide)
- The package manifest is exposed as a subpath for tooling that resolves it through the package specifier. (12.0.0) — [release notes](https://github.com/nestjs/bull/releases/tag/%40nestjs/bullmq%4012.0.0)

### Fixes and other changes

- The exports map includes a require condition, so CommonJS Nest apps can continue using require('@nestjs/bullmq') with supported Node versions. (12.0.0) — [release notes](https://github.com/nestjs/bull/releases/tag/%40nestjs/bullmq%4012.0.0)

## @nestjs/bullmq 11

### New APIs and options

- Adds support for BullMQ v6. (11.0.5) — [release notes](https://github.com/nestjs/bull/releases/tag/%40nestjs/bullmq%4011.0.5)
- Adds the forceDisconnectOnShutdown option for graceful disconnection. (11.0.5) — [release notes](https://github.com/nestjs/bull/releases/tag/%40nestjs/bullmq%4011.0.5)
- Adds telemetry support for workers. (11.0.5) — [release notes](https://github.com/nestjs/bull/releases/tag/%40nestjs/bullmq%4011.0.5)