@nestjs/cli 12.0.0-alpha.0 → 12.0.0-alpha.2

package/lib/compiler/defaults/rspack-defaults.d.ts

@@ -1,2 +1,2 @@
 import { MultiNestCompilerPlugins } from '../plugins/plugins-loader.js';
-export declare const rspackDefaultsFactory: (sourceRoot: string, relativeSourceRoot: string, entryFilename: string, isDebugEnabled: boolean | undefined, tsConfigFile: string | undefined, plugins: MultiNestCompilerPlugins) => Record<string, any>;
+export declare const rspackDefaultsFactory: (sourceRoot: string, relativeSourceRoot: string, entryFilename: string, isDebugEnabled: boolean | undefined, tsConfigFile: string | undefined, plugins: MultiNestCompilerPlugins, isEsm?: boolean) => Record<string, any>;

package/lib/compiler/defaults/rspack-defaults.js

@@ -1,11 +1,22 @@
-import { createRequire } from 'module';
+import { builtinModules, createRequire } from 'module';
 import { join } from 'path';
-import { TsconfigPathsPlugin } from 'tsconfig-paths-webpack-plugin';
 import { defaultTsconfigFilename } from '../../configuration/defaults.js';
 import { appendTsExtension } from '../helpers/append-extension.js';
-import nodeExternals from 'webpack-node-externals';
 const require = createRequire(import.meta.url);
-export const rspackDefaultsFactory = (sourceRoot, relativeSourceRoot, entryFilename, isDebugEnabled = false, tsConfigFile = defaultTsconfigFilename, plugins) => {
+function loadRspackDeps() {
+    try {
+        const externals = require('webpack-node-externals');
+        const { TsconfigPathsPlugin } = require('tsconfig-paths-webpack-plugin');
+        return { nodeExternals: externals, TsconfigPathsPlugin };
+    }
+    catch (e) {
+        const pkg = e?.message?.match?.(/Cannot find.*'([^']+)'/)?.[1] ?? 'webpack-node-externals';
+        throw new Error(`The "${pkg}" package is required when using the rspack compiler but could not be found. ` +
+            `Please install it:\n\n  npm install --save-dev @rspack/core webpack-node-externals tsconfig-paths-webpack-plugin\n`);
+    }
+}
+export const rspackDefaultsFactory = (sourceRoot, relativeSourceRoot, entryFilename, isDebugEnabled = false, tsConfigFile = defaultTsconfigFilename, plugins, isEsm = false) => {
+    const { nodeExternals: externals, TsconfigPathsPlugin } = loadRspackDeps();
     const isPluginRegistered = isAnyPluginRegistered(plugins);
     const rspackConfiguration = {
         entry: appendTsExtension(join(sourceRoot, entryFilename)),
@@ -13,10 +24,36 @@ export const rspackDefaultsFactory = (sourceRoot, relativeSourceRoot, entryFilen
         target: 'node',
         output: {
             filename: join(relativeSourceRoot, `${entryFilename}.js`),
+            ...(isEsm && {
+                module: true,
+                library: { type: 'module' },
+                chunkFormat: 'module',
+                chunkLoading: 'import',
+            }),
         },
+        ...(isEsm && {
+            experiments: { outputModule: true, topLevelAwait: true },
+        }),
         ignoreWarnings: [/^(?!CriticalDependenciesWarning$)/],
-        externals: [nodeExternals()],
-        externalsPresets: { node: true },
+        externals: [
+            externals(isEsm ? { importType: 'module' } : {}),
+            ...(isEsm
+                ? [
+                    ({ request }, callback) => {
+                        if (!request)
+                            return callback();
+                        const bare = request.startsWith('node:')
+                            ? request.slice(5)
+                            : request;
+                        if (builtinModules.includes(bare)) {
+                            return callback(null, `module ${request}`);
+                        }
+                        callback();
+                    },
+                ]
+                : []),
+        ],
+        externalsPresets: { node: !isEsm },
         module: {
             rules: [
                 {
@@ -41,11 +78,18 @@ export const rspackDefaultsFactory = (sourceRoot, relativeSourceRoot, entryFilen
                         },
                     ],
                     exclude: /node_modules/,
+                    ...(isEsm && { type: 'javascript/esm' }),
                 },
             ],
         },
         resolve: {
             extensions: ['.tsx', '.ts', '.js'],
+            ...(isEsm && {
+                extensionAlias: {
+                    '.js': ['.ts', '.js'],
+                    '.mjs': ['.mts', '.mjs'],
+                },
+            }),
             tsConfig: tsConfigFile,
             plugins: [
                 new TsconfigPathsPlugin({

package/lib/compiler/defaults/webpack-defaults.d.ts

@@ -1,3 +1,3 @@
+import type webpack from 'webpack';
 import { MultiNestCompilerPlugins } from '../plugins/plugins-loader.js';
-import webpack from 'webpack';
 export declare const webpackDefaultsFactory: (sourceRoot: string, relativeSourceRoot: string, entryFilename: string, isDebugEnabled: boolean | undefined, tsConfigFile: string | undefined, plugins: MultiNestCompilerPlugins) => webpack.Configuration;

package/lib/compiler/defaults/webpack-defaults.js

@@ -1,12 +1,23 @@
 import { createRequire } from 'module';
 import { join } from 'path';
-import { TsconfigPathsPlugin } from 'tsconfig-paths-webpack-plugin';
 import { defaultTsconfigFilename } from '../../configuration/defaults.js';
 import { appendTsExtension } from '../helpers/append-extension.js';
-import webpack from 'webpack';
-import nodeExternals from 'webpack-node-externals';
 const require = createRequire(import.meta.url);
+function loadWebpackDeps() {
+    try {
+        const wp = require('webpack');
+        const externals = require('webpack-node-externals');
+        const { TsconfigPathsPlugin } = require('tsconfig-paths-webpack-plugin');
+        return { webpack: wp, nodeExternals: externals, TsconfigPathsPlugin };
+    }
+    catch (e) {
+        const pkg = e?.message?.match?.(/Cannot find.*'([^']+)'/)?.[1] ?? 'webpack';
+        throw new Error(`The "${pkg}" package is required when using the webpack compiler but could not be found. ` +
+            `Please install it:\n\n  npm install --save-dev webpack webpack-node-externals tsconfig-paths-webpack-plugin ts-loader fork-ts-checker-webpack-plugin\n`);
+    }
+}
 export const webpackDefaultsFactory = (sourceRoot, relativeSourceRoot, entryFilename, isDebugEnabled = false, tsConfigFile = defaultTsconfigFilename, plugins) => {
+    const { webpack: wp, nodeExternals: externals, TsconfigPathsPlugin, } = loadWebpackDeps();
     const isPluginRegistered = isAnyPluginRegistered(plugins);
     const webpackConfiguration = {
         entry: appendTsExtension(join(sourceRoot, entryFilename)),
@@ -16,7 +27,7 @@ export const webpackDefaultsFactory = (sourceRoot, relativeSourceRoot, entryFile
             filename: join(relativeSourceRoot, `${entryFilename}.js`),
         },
         ignoreWarnings: [/^(?!CriticalDependenciesWarning$)/],
-        externals: [nodeExternals()],
+        externals: [externals()],
         externalsPresets: { node: true },
         module: {
             rules: [
@@ -57,7 +68,7 @@ export const webpackDefaultsFactory = (sourceRoot, relativeSourceRoot, entryFile
             __dirname: false,
         },
         plugins: [
-            new webpack.IgnorePlugin({
+            new wp.IgnorePlugin({
                 checkResource(resource) {
                     const lazyImports = [
                         '@nestjs/microservices',

package/lib/compiler/rspack-compiler.js

@@ -2,6 +2,7 @@ import { existsSync } from 'fs';
 import { createRequire } from 'module';
 import { join } from 'path';
 import { INFO_PREFIX } from '../ui/index.js';
+import { isEsmProject } from '../utils/is-esm-project.js';
 import { BaseCompiler } from './base-compiler.js';
 import { rspackDefaultsFactory } from './defaults/rspack-defaults.js';
 import { getValueOrDefault } from './helpers/get-value-or-default.js';
@@ -20,8 +21,15 @@ export class RspackCompiler extends BaseCompiler {
         const pathToSource = this.getPathToSource(configuration, tsConfigPath, appName);
         const entryFile = getValueOrDefault(configuration, 'entryFile', appName, 'entryFile', extras.options);
         const entryFileRoot = getValueOrDefault(configuration, 'root', appName) || '';
-        const defaultOptions = rspackDefaultsFactory(pathToSource, entryFileRoot, entryFile, extras.debug ?? false, tsConfigPath, plugins);
-        const rspack = require('@rspack/core');
+        const defaultOptions = rspackDefaultsFactory(pathToSource, entryFileRoot, entryFile, extras.debug ?? false, tsConfigPath, plugins, isEsmProject());
+        let rspack;
+        try {
+            rspack = require('@rspack/core');
+        }
+        catch {
+            throw new Error('@rspack/core is not installed. To use the rspack compiler, install the required packages:\n\n' +
+                '  npm install --save-dev @rspack/core webpack-node-externals tsconfig-paths-webpack-plugin\n');
+        }
         let compiler;
         let watchOptions;
         let watch;

package/lib/compiler/webpack-compiler.d.ts

@@ -2,7 +2,7 @@ import { Configuration } from '../configuration/index.js';
 import { AssetsManager } from './assets-manager.js';
 import { BaseCompiler } from './base-compiler.js';
 import { PluginsLoader } from './plugins/plugins-loader.js';
-import webpack from 'webpack';
+import type webpack from 'webpack';
 type WebpackConfigFactory = (config: webpack.Configuration, webpackRef: typeof webpack) => webpack.Configuration;
 type WebpackConfigFactoryOrConfig = WebpackConfigFactory | webpack.Configuration;
 type WebpackCompilerExtras = {

package/lib/compiler/webpack-compiler.js

@@ -1,10 +1,24 @@
 import { existsSync } from 'fs';
+import { createRequire } from 'module';
 import { join } from 'path';
 import { INFO_PREFIX } from '../ui/index.js';
+import { isEsmProject } from '../utils/is-esm-project.js';
 import { BaseCompiler } from './base-compiler.js';
 import { webpackDefaultsFactory } from './defaults/webpack-defaults.js';
 import { getValueOrDefault } from './helpers/get-value-or-default.js';
-import webpack from 'webpack';
+const WEBPACK_DEPRECATION_MSG = 'The webpack compiler is deprecated and will be removed in a future major version. ' +
+    'Please migrate to rspack (--builder rspack). ' +
+    'See https://docs.nestjs.com/cli/usages#build for details.';
+const require = createRequire(import.meta.url);
+function loadWebpack() {
+    try {
+        return require('webpack');
+    }
+    catch {
+        throw new Error('webpack is not installed. To use the webpack compiler, install the required packages:\n\n' +
+            '  npm install --save-dev webpack webpack-node-externals tsconfig-paths-webpack-plugin ts-loader\n');
+    }
+}
 export class WebpackCompiler extends BaseCompiler {
     constructor(pluginsLoader) {
         super(pluginsLoader);
@@ -19,7 +33,14 @@ export class WebpackCompiler extends BaseCompiler {
         const pathToSource = this.getPathToSource(configuration, tsConfigPath, appName);
         const entryFile = getValueOrDefault(configuration, 'entryFile', appName, 'entryFile', extras.options);
         const entryFileRoot = getValueOrDefault(configuration, 'root', appName) || '';
+        if (isEsmProject()) {
+            throw new Error('The webpack compiler does not support ESM projects ("type": "module" in package.json). ' +
+                'Please use rspack instead by setting "builder": "rspack" in your nest-cli.json compilerOptions, ' +
+                'or use --builder rspack on the command line.');
+        }
+        console.warn(`\n${INFO_PREFIX} ${WEBPACK_DEPRECATION_MSG}\n`);
         const defaultOptions = webpackDefaultsFactory(pathToSource, entryFileRoot, entryFile, extras.debug ?? false, tsConfigPath, plugins);
+        const wp = loadWebpack();
         let compiler;
         let watchOptions;
         let watch;
@@ -27,27 +48,27 @@ export class WebpackCompiler extends BaseCompiler {
             const webpackConfigurations = extras.webpackConfigFactoryOrConfig.map((configOrFactory) => {
                 const unwrappedConfig = typeof configOrFactory !== 'function'
                     ? configOrFactory
-                    : configOrFactory(defaultOptions, webpack);
+                    : configOrFactory(defaultOptions, wp);
                 return {
                     ...defaultOptions,
                     mode: extras.watchMode ? 'development' : defaultOptions.mode,
                     ...unwrappedConfig,
                 };
             });
-            compiler = webpack(webpackConfigurations);
+            compiler = wp(webpackConfigurations);
             watchOptions = webpackConfigurations.map((config) => config.watchOptions || {});
             watch = webpackConfigurations.some((config) => config.watch);
         }
         else {
             const projectWebpackOptions = typeof extras.webpackConfigFactoryOrConfig !== 'function'
                 ? extras.webpackConfigFactoryOrConfig
-                : extras.webpackConfigFactoryOrConfig(defaultOptions, webpack);
+                : extras.webpackConfigFactoryOrConfig(defaultOptions, wp);
             const webpackConfiguration = {
                 ...defaultOptions,
                 mode: extras.watchMode ? 'development' : defaultOptions.mode,
                 ...projectWebpackOptions,
             };
-            compiler = webpack(webpackConfiguration);
+            compiler = wp(webpackConfiguration);
             watchOptions = webpackConfiguration.watchOptions;
             watch = webpackConfiguration.watch;
         }

package/lib/utils/is-esm-project.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Detect whether the target project uses ESM output.
+ * Checks the project's package.json for `"type": "module"`.
+ */
+export declare function isEsmProject(cwd?: string): boolean;

package/lib/utils/is-esm-project.js

@@ -0,0 +1,16 @@
+import { readFileSync } from 'fs';
+import { join } from 'path';
+/**
+ * Detect whether the target project uses ESM output.
+ * Checks the project's package.json for `"type": "module"`.
+ */
+export function isEsmProject(cwd = process.cwd()) {
+    try {
+        const raw = readFileSync(join(cwd, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        return pkg.type === 'module';
+    }
+    catch {
+        return false;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/cli",
-  "version": "12.0.0-alpha.0",
+  "version": "12.0.0-alpha.2",
   "type": "module",
   "description": "Nest - modern, fast, powerful node.js web framework (@cli)",
   "publishConfig": {
@@ -28,8 +28,7 @@
     "test:dev": "npm run clean && vitest --watch",
     "prerelease": "npm run build",
     "release": "release-it",
-    "prepare": "husky",
-    "postinstall": "node tools/postinstall.cjs"
+    "prepare": "husky && node tools/postinstall.cjs"
   },
   "repository": {
     "type": "git",
@@ -50,28 +49,25 @@
     "chokidar": "4.0.3",
     "cli-table3": "0.6.5",
     "commander": "14.0.3",
-    "fork-ts-checker-webpack-plugin": "9.1.0",
     "glob": "13.0.6",
     "node-emoji": "2.2.0",
     "ora": "9.3.0",
     "tsconfig-paths": "4.2.0",
-    "tsconfig-paths-webpack-plugin": "4.2.0",
-    "typescript": "5.9.3",
-    "webpack": "5.105.4",
-    "webpack-node-externals": "3.0.0"
+    "typescript": "5.9.3"
   },
   "devDependencies": {
     "@commitlint/cli": "20.4.3",
     "@commitlint/config-angular": "20.4.3",
+    "@eslint/js": "10.0.1",
+    "@rspack/core": "^1.7.7",
     "@swc/cli": "0.8.0",
     "@swc/core": "1.15.18",
     "@types/node": "24.10.13",
     "@types/webpack-node-externals": "3.0.4",
-    "@eslint/js": "10.0.1",
     "delete-empty": "3.0.0",
     "eslint": "10.0.2",
     "eslint-config-prettier": "10.1.8",
-    "typescript-eslint": "8.56.1",
+    "fork-ts-checker-webpack-plugin": "9.1.0",
     "gulp": "5.0.1",
     "gulp-clean": "0.4.0",
     "husky": "9.1.7",
@@ -79,21 +75,49 @@
     "prettier": "3.8.1",
     "release-it": "19.2.4",
     "ts-loader": "9.5.4",
-    "vitest": "3.2.4"
+    "tsconfig-paths-webpack-plugin": "4.2.0",
+    "typescript-eslint": "8.56.1",
+    "vitest": "3.2.4",
+    "webpack": "5.105.4",
+    "webpack-node-externals": "3.0.0"
   },
   "lint-staged": {
     "**/*.{ts,json}": []
   },
   "peerDependencies": {
+    "@rspack/core": "^1.0.0",
     "@swc/cli": "^0.1.62 || ^0.3.0 || ^0.4.0 || ^0.5.0 || ^0.6.0 || ^0.7.0 || ^0.8.0",
-    "@swc/core": "^1.3.62"
+    "@swc/core": "^1.3.62",
+    "fork-ts-checker-webpack-plugin": "^9.0.0",
+    "ts-loader": "^9.0.0",
+    "tsconfig-paths-webpack-plugin": "^4.0.0",
+    "webpack": "^5.0.0",
+    "webpack-node-externals": "^3.0.0"
   },
   "peerDependenciesMeta": {
+    "@rspack/core": {
+      "optional": true
+    },
     "@swc/cli": {
       "optional": true
     },
     "@swc/core": {
       "optional": true
+    },
+    "fork-ts-checker-webpack-plugin": {
+      "optional": true
+    },
+    "ts-loader": {
+      "optional": true
+    },
+    "tsconfig-paths-webpack-plugin": {
+      "optional": true
+    },
+    "webpack": {
+      "optional": true
+    },
+    "webpack-node-externals": {
+      "optional": true
     }
   }
 }