@nestjs/cli/commands/build.command.js

Nest - modern, fast, powerful node.js web framework (@cli)

import { ERROR_PREFIX } from '../lib/ui/index.js';
import { AbstractCommand } from './abstract.command.js';
export class BuildCommand extends AbstractCommand {
    load(program) {
        program
            .command('build [apps...]')
            .option('-c, --config [path]', 'Path to nest-cli configuration file.')
            .option('-p, --path [path]', 'Path to tsconfig file.')
            .option('-w, --watch', 'Run in watch mode (live-reload).')
            .option('-b, --builder [name]', 'Builder to be used (tsc, webpack, swc, rspack).')
            .option('--watchAssets', 'Watch non-ts (e.g., .graphql) files mode.')
            .option('--webpack', 'Use webpack for compilation (deprecated option, use --builder instead).')
            .option('--type-check', 'Enable type checking (when SWC is used).', () => true)
            .option('--no-type-check', 'Disable type checking (when SWC is used).', () => false)
            .option('--emit-declarations', 'Emit declaration files (.d.ts) when using SWC builder.')
            .option('--silent', 'Suppress informational compiler logs.')
            .option('--webpackPath [path]', 'Path to webpack configuration.')
            .option('--rspackPath [path]', 'Path to rspack configuration.')
            .option('--tsc', 'Use typescript compiler for compilation.')
            .option('--preserveWatchOutput', 'Use "preserveWatchOutput" option when using tsc watch mode.')
            .option('--all', 'Build all projects in a monorepo.')
            .option('--parallel [concurrency]', 'Build projects in parallel (with --all). Optionally limit concurrency.')
            .description('Build Nest application.')
            .action(async (apps, options) => {
            const isWebpackEnabled = options.tsc ? false : options.webpack;
            const availableBuilders = ['tsc', 'webpack', 'swc', 'rspack'];
            if (options.builder && !availableBuilders.includes(options.builder)) {
                console.error(ERROR_PREFIX +
                    ` Invalid builder option: ${options.builder}. Available builders: ${availableBuilders.join(', ')}`);
                process.exit(1);
            }
            let parallel;
            if (options.parallel === true || options.parallel === undefined) {
                // `--parallel` with no value means unlimited; absent means sequential.
                parallel = options.parallel;
            }
            else {
                const parsed = parseInt(options.parallel, 10);
                if (!Number.isFinite(parsed) || parsed < 1) {
                    console.error(ERROR_PREFIX +
                        ` Invalid --parallel value: "${options.parallel}". Expected a positive integer (e.g. --parallel 4) or no value for unlimited concurrency.`);
                    process.exit(1);
                }
                parallel = parsed;
            }
            const context = {
                apps: apps.length > 0 ? apps : [],
                config: options.config,
                webpack: isWebpackEnabled,
                watch: !!options.watch,
                watchAssets: !!options.watchAssets,
                path: options.path,
                webpackPath: options.webpackPath,
                rspackPath: options.rspackPath,
                builder: options.builder,
                typeCheck: options.typeCheck,
                // Left undefined when the flag is absent so `getValueOrDefault` can
                // still fall through to `compilerOptions.emitDeclarations`.
                emitDeclarations: options.emitDeclarations,
                silent: !!options.silent,
                // Left undefined when the flag is absent so `WatchCompiler` can
                // fall through to the tsconfig 'preserveWatchOutput' option.
                preserveWatchOutput: !!options.watch && !isWebpackEnabled
                    ? options.preserveWatchOutput
                    : false,
                all: !!options.all,
                parallel,
            };
            await this.action.handle(context);
        });
    }
}