v11.0.0

release notes

Published 1/20/2025

MajorContains breaking changes

Release notes

v11.0.0 (2025-01-16)

Article: https://trilon.io/blog/announcing-nestjs-11-whats-new Migration guide: https://docs.nestjs.com/migration-guide 👈 👈 👈

⚠️ Node v16 and v18 are no longer supported (>= v20 is required).

Features

common, core, microservices
- #14142 feat(microservices): add status, unwrap, on methods to microservice transporters (clients/servers) (@kamilmysliwiec)
- #14121 feat(common): add json logger, built-in logger improvements (@kamilmysliwiec)
common, core
- #13336 feat(core): introduce different module opaque key factories (improve bootstrap performance) (@kamilmysliwiec)
common, core, microservices, platform-express, platform-fastify, platform-socket.io, platform-ws, testing, websockets
- #14238 chore(deps): upgrade to express v5, fastify v5, add legacy route path converter to minimize breaking changes (@kamilmysliwiec)

Enhancements

common
- #14213 feat(common): add error messages for file validators (@mag123c)
- #14131 feat(common): allow passing number to http error createBody (@kamilmysliwiec)
- #14122 feat(common): add ParseDatePipe, add tsdoc to other pipes (@kamilmysliwiec)
- #12735 feat(common)!: type narrowing allowed injection tokens for [@Inject](https://github.com/Inject)() (@micalevisk)
- #12764 fix(common): apply options to plaintoclass in classserializerinterceptor (@kmw14641)
- #14126 fix(common): type narrowing context parameter on createParamDecorator's callback (@EeeasyCode)
- #13628 chore(class-transformer): plainToClass is deprectated and replaced with plainToInstance (@tomflorentin)
microservices
- #14200 feat(microservices): support nats queue per handler (@kamilmysliwiec)
- #13924 feat(microservices): add gracefull shutdown option for nats server (@alinowrouzii)
- #12622 feat: allow for microservice options to come from the di container (@jmcdo29)
- #14134 feat(microservices): add max tcp packet buffer length (@kamilmysliwiec)
- #12761 feat(microservices): ability to use a random port for the TCP server (@PieterScheffers)
websockets
- #14184 feat(websockets): include exception cause to associate error with req (@kamilmysliwiec)
common, core, microservices, websockets
- #14182 feat(common): introduce intrinsic exception (@kamilmysliwiec)
common, core, platform-fastify
- #13278 feat(core,common,platform-fastify): add webdav http methods support (@johaven)
platform-express
- #13407 feat: add multer error fieldname to the exception message (@mmgroner)
platform-ws
- #14127 feat(ws): introduce message parser for ws adapter (@CodyTseng)
platform-fastify
- #14115 chore(fastify): update fastify view options interface (@Tony133)
- #14116 refactor(fastify): update fastify static options interface (@Tony133)
common, core
- #14113 feat(core): allow overriding abortOnError for the select method (@kamilmysliwiec)

Bug fixes

core
- #14267 fix shutdown hooks order (@flovouin)
- #13388 correction of Reflector types (@AlexRMU)
- #14110 fix(core): Calculate module distance after bindGlobalScope (@wenlong-chen)
- #14111 fix(core): Order of module destroy should be the reverse of module init (@wenlong-chen)
- #14097 fix(core): revisit dependencies w/ possibly higher distance (@clkamp)
platform-fastify
- #13797 fix(fastify-adapter): middleware not executed when root path is excluded (@patrickacioli)
microservices
- #14129 fix: rabbitmq bindings and auto-generated queues (@EeeasyCode)
- #14112 fix(microservices): use instance refs for target handler callbacks (@kamilmysliwiec)
- #13468 fix(microservices): delete unnecessary call of grpcClient.start (@kamilmysliwiec)
common
- #14114 fix(common)!: drop broken support for promises on exports of modules (@micalevisk)

Other packages in the ecosystem

config (breaking changes)
- https://github.com/nestjs/config/releases/tag/4.0.0
cli
- https://github.com/nestjs/nest-cli/releases/tag/11.0.0
cache-manager (breaking changes)
- https://github.com/nestjs/cache-manager/releases/tag/3.0.0
cqrs
- https://github.com/nestjs/cqrs/releases/tag/11.0.0

Dependencies

Other
- #14205 chore(dev-deps): upgrade to eslint v9 (@kamilmysliwiec)
- #14428 fix(deps): update dependency mercurius to v16.0.1 (@renovate[bot])
- #14424 fix(deps): update dependency mongoose to v8.9.5 (@renovate[bot])
- #14410 fix(deps): update dependency @fastify/static to v8.0.4 (@renovate[bot])
- #14411 fix(deps): update dependency @fastify/view to v10.0.2 (@renovate[bot])
- #14403 chore(deps): update dependency nats to v2.29.1 (@renovate[bot])
- #14400 fix(deps): update dependency ansis to v3.8.1 (@renovate[bot])
- #14337 chore(deps): update dependency @fastify/multipart to v9.0.2 (@renovate[bot])
- #14415 fix(deps): update dependency mercurius to v16 (@renovate[bot])
- #14397 chore(deps): update dependency webpack-cli to v6 (@renovate[bot])
- #14384 fix(deps): update dependency typescript to v5.7.3 (@renovate[bot])
- #14378 chore(deps): update dependency core-js to v3.40.0 (@renovate[bot])
- #14377 chore(deps): update dependency @eslint/js to v9.17.0 (@renovate[bot])
- #14375 chore(deps): update dependency @grpc/grpc-js to v1.12.5 (@renovate[bot])
- #14370 chore(deps): update dependency ioredis to v5.4.2 (@renovate[bot])
- #14197 chore(deps-dev): bump @fastify/static from 7.0.4 to 8.0.3 (@dependabot[bot])
- #14345 chore(deps): update dependency eslint to v9 (@renovate[bot])
- #14324 fix(deps): update dependency @socket.io/redis-adapter to v8.3.0 (@renovate[bot])
- #14363 chore(deps): bump @fastify/cors from 9.0.1 to 10.0.2 (@dependabot[bot])
- #14354 chore(deps-dev): bump cache-manager from 5.7.6 to 6.3.2 (@dependabot[bot])
- #14021 chore(deps-dev): bump @fastify/view from 9.1.0 to 10.0.1 (@dependabot[bot])
- #14326 fix(deps): update dependency mongodb to v6.12.0 (@renovate[bot])
- #14307 fix(deps): update dependency @grpc/grpc-js to v1.12.4 (@renovate[bot])
platform-fastify
- #14402 fix(deps): update dependency @fastify/middie to v9.0.3 (@renovate[bot])
- #14401 fix(deps): update dependency @fastify/formbody to v8.0.2 (@renovate[bot])
- #14387 fix(deps): update dependency light-my-request to v6.5.1 (@renovate[bot])
- #13990 feat(platform-fastify): added support for Fastify v5 (@Tony133)

Committers: 22

Alex (@AlexRMU)
Ali Nowrouzi (@alinowrouzii)
Antonio Tripodi (@Tony133)
Christian Lütke-Stetzkamp (@clkamp)
Cody Tseng (@CodyTseng)
Flo (@flovouin)
Harel Danieli (@Hareloo)
Jackie McDoniel (@jmcdo29)
JaeHo Jang (@mag123c)
Johaven (@johaven)
Kamil Mysliwiec (@kamilmysliwiec)
Khan / 이창민 (@EeeasyCode)
Max Katz (@maxktz)
Mendel Groner (@mmgroner)
Micael Levi L. Cavalcante (@micalevisk)
Mitchell (@Mittcio)
Patrick Acioli (@patrickacioli)
Pieter Scheffers (@PieterScheffers)
@bestlyg
@kmw14641
@tomflorentin
@wenlong-chen