release: v12.0.0 major release (approx. Q3 2026)

.circleci/config.yml

@@ -1,21 +1,15 @@
 version: 2.1
 
 parameters:
-  check-legacy-node-version:
-    type: boolean
-    default: false
-  legacy-node-version:
-    type: string
-    default: '18.20'
   maintenance-node-version:
     type: string
-    default: '20.18'
+    default: '20.19'
   active-node-version:
     type: string
-    default: '22.11'
+    default: '22.14'
   current-node-version:
     type: string
-    default: '23.3'
+    default: '24.1'
 
 aliases:
   - &restore-cache
@@ -62,61 +56,36 @@ jobs:
     docker:
       - image: cimg/node:<< parameters.node-version >>
     steps:
+      - checkout
+      - *restore-cache
+      - *install-deps
+      - *build-packages
       - when:
           condition:
-            and:
-              - equal:
-                  [
-                    '<< parameters.node-version >>',
-                    '<< pipeline.parameters.legacy-node-version >>',
-                  ]
-              - not: << pipeline.parameters.check-legacy-node-version >>
+            equal:
+              [
+                '<< parameters.node-version >>',
+                '<< pipeline.parameters.maintenance-node-version >>',
+              ]
           steps:
             - run:
-                name: Skip
-                command: |
-                  echo Skipping
+                name: Test (coverage)
+                command: npm run test:cov
+            - run:
+                name: Collect coverage
+                command: npm run coverage
+            - store_artifacts:
+                path: coverage
       - when:
           condition:
-            or:
-              - not:
-                  equal:
-                    [
-                      '<< parameters.node-version >>',
-                      '<< pipeline.parameters.legacy-node-version >>',
-                    ]
-              - << pipeline.parameters.check-legacy-node-version >>
+            not:
+              equal:
+                [
+                  '<< parameters.node-version >>',
+                  '<< pipeline.parameters.maintenance-node-version >>',
+                ]
           steps:
-            - checkout
-            - *restore-cache
-            - *install-deps
-            - *build-packages
-            - when:
-                condition:
-                  equal:
-                    [
-                      '<< parameters.node-version >>',
-                      '<< pipeline.parameters.maintenance-node-version >>',
-                    ]
-                steps:
-                  - run:
-                      name: Test (coverage)
-                      command: npm run test:cov
-                  - run:
-                      name: Collect coverage
-                      command: npm run coverage
-                  - store_artifacts:
-                      path: coverage
-            - when:
-                condition:
-                  not:
-                    equal:
-                      [
-                        '<< parameters.node-version >>',
-                        '<< pipeline.parameters.maintenance-node-version >>',
-                      ]
-                steps:
-                  - *run-unit-tests
+            - *run-unit-tests
 
   lint:
     working_directory: ~/nest
@@ -183,7 +152,6 @@ jobs:
           name: Build all samples
           command: npm run build:samples
 
-
 workflows:
   build-and-test:
     jobs:
@@ -195,7 +163,6 @@ workflows:
             parameters:
               node-version:
                 [
-                  '<< pipeline.parameters.legacy-node-version >>',
                   '<< pipeline.parameters.maintenance-node-version >>',
                   '<< pipeline.parameters.active-node-version >>',
                   '<< pipeline.parameters.current-node-version >>',
@@ -209,4 +176,3 @@ workflows:
       - samples:
           requires:
             - build
-

.oxlintrc.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["typescript"],
+  "categories": {
+    "correctness": "error"
+  },
+  "env": {
+    "node": true
+  },
+  "ignorePatterns": ["node_modules", "**/*.js", "**/*.d.ts"],
+  "rules": {
+    "no-unused-vars": "off",
+    "no-unused-expressions": "off",
+    "typescript/no-explicit-any": "off",
+    "typescript/no-non-null-asserted-optional-chain": "warn",
+    "typescript/no-require-imports": "off"
+  }
+}

CONTRIBUTING.md

@@ -116,7 +116,6 @@ We cannot accept code without this.
 1. In GitHub, send a pull request to `nestjs:master`.
 
 - If we suggest changes then:
-
   - Make the required updates.
   - Re-run the Nest test suites to ensure tests are still passing.
   - Rebase your branch and force push to your GitHub repository (this will update your Pull Request):
@@ -159,7 +158,7 @@ from the main (upstream) repository:
 
 ## <a name="development"></a> Development Setup
 
-You will need [Node.js](https://nodejs.org) version >= 10.13.0 (except for v13).
+You will need [Node.js](https://nodejs.org) version >= 20.
 
 1. After cloning the repo, run:
 
@@ -322,8 +321,10 @@ changes to be accepted, the CLA must be signed. It's a quick process, we promise
 <!-- [coc]: https://github.com/angular/code-of-conduct/blob/master/CODE_OF_CONDUCT.md -->
 
 [commit-message-format]: https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#
+
 <!-- [individual-cla]: http://code.google.com/legal/individual-cla-v1.0.html -->
 <!-- [corporate-cla]: http://code.google.com/legal/corporate-cla-v1.0.html -->
+
 [dev-doc]: https://github.com/nestjs/nest/blob/master/docs/DEVELOPER.md
 [github]: https://github.com/nestjs/nest
 [stackoverflow]: https://stackoverflow.com/questions/tagged/nestjs

gulpfile.mjs

@@ -0,0 +1,13 @@
+/**
+ * Load the TypeScript compiler, then load the TypeScript gulpfile which simply loads all
+ * the tasks. The tasks are really inside tools/gulp/tasks.
+ */
+
+import { register } from 'node:module';
+import { pathToFileURL } from 'node:url';
+
+register('ts-node/esm', pathToFileURL('./'), {
+  data: { project: './tools/gulp/tsconfig.json' },
+});
+
+await import('./tools/gulp/gulpfile.ts');

integration/auto-mock/src/bar.service.ts

@@ -1,5 +1,5 @@
 import { Injectable } from '@nestjs/common';
-import { FooService } from './foo.service';
+import { FooService } from './foo.service.js';
 
 @Injectable()
 export class BarService {

integration/auto-mock/test/bar.service.spec.ts

@@ -1,17 +1,11 @@
 import { Test } from '@nestjs/testing';
-import * as chai from 'chai';
-import * as chaiAsPromised from 'chai-as-promised';
-import * as sinon from 'sinon';
-import { BarService } from '../src/bar.service';
-import { FooService } from '../src/foo.service';
-
-chai.use(chaiAsPromised);
-const { expect } = chai;
+import { BarService } from '../src/bar.service.js';
+import { FooService } from '../src/foo.service.js';
 
 describe('Auto-Mocking Bar Deps', () => {
   let service: BarService;
   let fooService: FooService;
-  const stub = sinon.stub();
+  const stub = vi.fn();
   beforeEach(async () => {
     const moduleRef = await Test.createTestingModule({
       providers: [BarService],
@@ -23,12 +17,12 @@ describe('Auto-Mocking Bar Deps', () => {
   });
 
   it('should be defined', () => {
-    expect(service).not.to.be.undefined;
-    expect(fooService).not.to.be.undefined;
+    expect(service).not.toBeUndefined();
+    expect(fooService).not.toBeUndefined();
   });
   it('should call bar.bar', () => {
     service.bar();
-    expect(stub.called);
+    expect(stub).toHaveBeenCalled();
   });
 });
 
@@ -39,23 +33,25 @@ describe('Auto-Mocking with token in factory', () => {
     })
       .useMocker(token => {
         if (token === FooService) {
-          return { foo: sinon.stub };
+          return { foo: vi.fn() };
         }
       })
       .compile();
     const service = moduleRef.get(BarService);
-    const fooServ = moduleRef.get<{ foo: sinon.SinonStub }>(FooService as any);
+    const fooServ = moduleRef.get<{ foo: ReturnType<typeof vi.fn> }>(
+      FooService as any,
+    );
     service.bar();
-    expect(fooServ.foo.called);
+    expect(fooServ.foo).toHaveBeenCalled();
   });
   it('cannot mock the dependencies', async () => {
     const moduleRef = Test.createTestingModule({
       providers: [BarService],
     }).useMocker(token => {
       if (token === FooService.name + 'something that fails the token') {
-        return { foo: sinon.stub };
+        return { foo: vi.fn() };
       }
     }).compile;
-    expect(moduleRef()).to.eventually.throw();
+    await expect(moduleRef()).rejects.toThrow();
   });
 });

integration/auto-mock/tsconfig.json

@@ -1,13 +1,15 @@
 {
   "compilerOptions": {
+    "types": ["vitest/globals"],
     "module": "commonjs",
     "declaration": false,
     "noImplicitAny": false,
     "removeComments": true,
     "noLib": false,
+    "esModuleInterop": true,
     "emitDecoratorMetadata": true,
     "experimentalDecorators": true,
-    "target": "ES2021",
+    "target": "ES2023",
     "sourceMap": true,
     "allowJs": true,
     "strictNullChecks": true,