@nestjs/bull

What's Changed

@nestjs/bull, @nestjs/bullmq, and @nestjs/bull-shared are now native ES modules, and the major version is aligned with the Nest 12 release line.

ESM migration

All three packages are published as pure ESM ("type": "module", compiled with NodeNext) behind a proper exports map. Deep imports into build internals are no longer resolvable — import from the package root:

// still fine
import { BullModule, InjectQueue, Processor } from '@nestjs/bullmq';

// no longer resolvable
import { BullExplorer } from '@nestjs/bullmq/dist/bull.explorer';

./package.json is exposed as a subpath for tooling that resolves the manifest through the package specifier.

require(esm) — CommonJS still works

You do not need to convert your app to ESM. Thanks to Node's require(esm) support, the exports map ships a require condition alongside import, so require('@nestjs/bullmq') from a CommonJS Nest app keeps working. This needs Node 20.19+, 22.12+, or 24+ — the versions where require(esm) is enabled by default.

TypeScript consumers should be on "moduleResolution": "node16", "nodenext", or "bundler" so the exports map is honored.