@rushstack/heft-webpack5-plugin 0.6.0-rc.2 → 0.6.0

package/lib/Webpack5Plugin.js

@@ -1,366 +0,0 @@
-"use strict";
-// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
-// See LICENSE in the project root for license information.
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PLUGIN_NAME = void 0;
-const tapable_1 = require("tapable");
-const debug_certificate_manager_1 = require("@rushstack/debug-certificate-manager");
-const node_core_library_1 = require("@rushstack/node-core-library");
-const WebpackConfigurationLoader_1 = require("./WebpackConfigurationLoader");
-/**
- * @public
- */
-exports.PLUGIN_NAME = 'webpack5-plugin';
-const SERVE_PARAMETER_LONG_NAME = '--serve';
-const WEBPACK_PACKAGE_NAME = 'webpack';
-const WEBPACK_DEV_SERVER_PACKAGE_NAME = 'webpack-dev-server';
-const WEBPACK_DEV_SERVER_ENV_VAR_NAME = 'WEBPACK_DEV_SERVER';
-const WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME = 'webpack-dev-middleware';
-const UNINITIALIZED = 'UNINITIALIZED';
-/**
- * @internal
- */
-class Webpack5Plugin {
-    constructor() {
-        this._isServeMode = false;
-        this._webpackConfiguration = UNINITIALIZED;
-    }
-    get accessor() {
-        if (!this._accessor) {
-            this._accessor = {
-                hooks: {
-                    onLoadConfiguration: new tapable_1.AsyncSeriesBailHook(),
-                    onConfigure: new tapable_1.AsyncSeriesHook(['webpackConfiguration']),
-                    onAfterConfigure: new tapable_1.AsyncParallelHook(['webpackConfiguration']),
-                    onEmitStats: new tapable_1.AsyncParallelHook(['webpackStats'])
-                },
-                parameters: {
-                    isServeMode: this._isServeMode
-                }
-            };
-        }
-        return this._accessor;
-    }
-    apply(taskSession, heftConfiguration, options) {
-        this._isServeMode = taskSession.parameters.getFlagParameter(SERVE_PARAMETER_LONG_NAME).value;
-        if (!taskSession.parameters.watch && this._isServeMode) {
-            throw new Error(`The ${JSON.stringify(SERVE_PARAMETER_LONG_NAME)} parameter is only available when running in watch mode.`);
-        }
-        taskSession.hooks.run.tapPromise(exports.PLUGIN_NAME, async (runOptions) => {
-            await this._runWebpackAsync(taskSession, heftConfiguration, options);
-        });
-        taskSession.hooks.runIncremental.tapPromise(exports.PLUGIN_NAME, async (runOptions) => {
-            await this._runWebpackWatchAsync(taskSession, heftConfiguration, options);
-        });
-    }
-    async _getWebpackConfigurationAsync(taskSession, heftConfiguration, options) {
-        if (this._webpackConfiguration === UNINITIALIZED) {
-            // Obtain the webpack configuration by calling into the hook. If undefined
-            // is returned, load the default Webpack configuration.
-            taskSession.logger.terminal.writeVerboseLine('Attempting to load Webpack configuration via external plugins');
-            let webpackConfiguration = await this.accessor.hooks.onLoadConfiguration.promise();
-            if (webpackConfiguration === undefined) {
-                taskSession.logger.terminal.writeVerboseLine('Attempt to load the default Webpack configuration');
-                const configurationLoader = new WebpackConfigurationLoader_1.WebpackConfigurationLoader(taskSession.logger, taskSession.parameters.production, taskSession.parameters.watch && this._isServeMode);
-                webpackConfiguration = await configurationLoader.tryLoadWebpackConfigurationAsync(Object.assign(Object.assign({}, options), { taskSession,
-                    heftConfiguration, loadWebpackAsyncFn: this._loadWebpackAsync.bind(this) }));
-            }
-            if (webpackConfiguration === false) {
-                taskSession.logger.terminal.writeLine('Webpack disabled by external plugin');
-                this._webpackConfiguration = undefined;
-            }
-            else if (webpackConfiguration === undefined ||
-                (Array.isArray(webpackConfiguration) && webpackConfiguration.length === 0)) {
-                taskSession.logger.terminal.writeLine('No Webpack configuration found');
-                this._webpackConfiguration = undefined;
-            }
-            else {
-                if (this.accessor.hooks.onConfigure.isUsed()) {
-                    // Allow for plugins to customise the configuration
-                    await this.accessor.hooks.onConfigure.promise(webpackConfiguration);
-                }
-                if (this.accessor.hooks.onAfterConfigure.isUsed()) {
-                    // Provide the finalized configuration
-                    await this.accessor.hooks.onAfterConfigure.promise(webpackConfiguration);
-                }
-                this._webpackConfiguration = webpackConfiguration;
-            }
-        }
-        return this._webpackConfiguration;
-    }
-    async _loadWebpackAsync() {
-        if (!this._webpack) {
-            // Allow this to fail if webpack is not installed
-            this._webpack = await Promise.resolve().then(() => __importStar(require(WEBPACK_PACKAGE_NAME)));
-        }
-        return this._webpack;
-    }
-    async _getWebpackCompilerAsync(taskSession, webpackConfiguration) {
-        if (!this._webpackCompiler) {
-            const webpack = await this._loadWebpackAsync();
-            taskSession.logger.terminal.writeLine(`Using Webpack version ${webpack.version}`);
-            this._webpackCompiler = Array.isArray(webpackConfiguration)
-                ? webpack.default(webpackConfiguration) /* (webpack.Compilation[]) => MultiCompiler */
-                : webpack.default(webpackConfiguration); /* (webpack.Compilation) => Compiler */
-        }
-        return this._webpackCompiler;
-    }
-    async _runWebpackAsync(taskSession, heftConfiguration, options) {
-        this._validateEnvironmentVariable(taskSession);
-        if (taskSession.parameters.watch || this._isServeMode) {
-            // Should never happen, but just in case
-            throw new node_core_library_1.InternalError('Cannot run Webpack in compilation mode when watch mode is enabled');
-        }
-        // Load the config and compiler, and return if there is no config found
-        const webpackConfiguration = await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options);
-        if (!webpackConfiguration) {
-            return;
-        }
-        const compiler = await this._getWebpackCompilerAsync(taskSession, webpackConfiguration);
-        taskSession.logger.terminal.writeLine('Running Webpack compilation');
-        // Run the webpack compiler
-        let stats;
-        try {
-            stats = await node_core_library_1.LegacyAdapters.convertCallbackToPromise(compiler.run.bind(compiler));
-            await node_core_library_1.LegacyAdapters.convertCallbackToPromise(compiler.close.bind(compiler));
-        }
-        catch (e) {
-            taskSession.logger.emitError(e);
-        }
-        // Emit the errors from the stats object, if present
-        if (stats) {
-            this._emitErrors(taskSession.logger, stats, heftConfiguration.buildFolderPath);
-            if (this.accessor.hooks.onEmitStats.isUsed()) {
-                await this.accessor.hooks.onEmitStats.promise(stats);
-            }
-        }
-    }
-    async _runWebpackWatchAsync(taskSession, heftConfiguration, options) {
-        var _a, _b;
-        // Save a handle to the original promise, since the this-scoped promise will be replaced whenever
-        // the compilation completes.
-        let webpackCompilationDonePromise = this._webpackCompilationDonePromise;
-        if (!this._webpackWatchers) {
-            this._validateEnvironmentVariable(taskSession);
-            if (!taskSession.parameters.watch) {
-                // Should never happen, but just in case
-                throw new node_core_library_1.InternalError('Cannot run Webpack in watch mode when compilation mode is enabled');
-            }
-            // Load the config and compiler, and return if there is no config found
-            const webpackConfiguration = await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options);
-            if (!webpackConfiguration) {
-                return;
-            }
-            // Get the compiler which will be used for both serve and watch mode
-            const compiler = await this._getWebpackCompilerAsync(taskSession, webpackConfiguration);
-            // Set up the hook to detect when the watcher completes the watcher compilation. We will also log out
-            // errors from the compilation if present from the output stats object.
-            this._webpackCompilationDonePromise = new Promise((resolve) => {
-                this._webpackCompilationDonePromiseResolveFn = resolve;
-            });
-            webpackCompilationDonePromise = this._webpackCompilationDonePromise;
-            compiler.hooks.done.tap(exports.PLUGIN_NAME, (stats) => {
-                this._webpackCompilationDonePromiseResolveFn();
-                this._webpackCompilationDonePromise = new Promise((resolve) => {
-                    this._webpackCompilationDonePromiseResolveFn = resolve;
-                });
-                if (stats) {
-                    this._emitErrors(taskSession.logger, stats, heftConfiguration.buildFolderPath);
-                }
-            });
-            // Determine how we will run the compiler. When serving, we will run the compiler
-            // via the webpack-dev-server. Otherwise, we will run the compiler directly.
-            if (this._isServeMode) {
-                const defaultDevServerOptions = {
-                    host: 'localhost',
-                    devMiddleware: {
-                        publicPath: '/',
-                        stats: {
-                            cached: false,
-                            cachedAssets: false,
-                            colors: heftConfiguration.terminalProvider.supportsColor
-                        }
-                    },
-                    client: {
-                        logging: 'info',
-                        webSocketURL: {
-                            port: 8080
-                        }
-                    },
-                    port: 8080,
-                    onListening: (server) => {
-                        var _a;
-                        const addressInfo = (_a = server.server) === null || _a === void 0 ? void 0 : _a.address();
-                        if (addressInfo) {
-                            const address = typeof addressInfo === 'string' ? addressInfo : `${addressInfo.address}:${addressInfo.port}`;
-                            taskSession.logger.terminal.writeLine(`Started Webpack Dev Server at https://${address}`);
-                        }
-                    }
-                };
-                // Obtain the devServerOptions from the webpack configuration, and combine with the default options
-                let devServerOptions;
-                if (Array.isArray(webpackConfiguration)) {
-                    const filteredDevServerOptions = webpackConfiguration
-                        .map((configuration) => configuration.devServer)
-                        .filter((devServer) => !!devServer);
-                    if (filteredDevServerOptions.length > 1) {
-                        taskSession.logger.emitWarning(new Error(`Detected multiple webpack devServer configurations, using the first one.`));
-                    }
-                    devServerOptions = Object.assign(Object.assign({}, defaultDevServerOptions), filteredDevServerOptions[0]);
-                }
-                else {
-                    devServerOptions = Object.assign(Object.assign({}, defaultDevServerOptions), webpackConfiguration.devServer);
-                }
-                // Add the certificate and key to the devServerOptions if these fields don't already have values
-                if (!devServerOptions.server) {
-                    const certificateManager = new debug_certificate_manager_1.CertificateManager();
-                    const certificate = await certificateManager.ensureCertificateAsync(true, taskSession.logger.terminal);
-                    // Update the web socket URL to use the hostname provided by the certificate
-                    const clientConfiguration = devServerOptions.client;
-                    const hostname = (_a = certificate.subjectAltNames) === null || _a === void 0 ? void 0 : _a[0];
-                    if (hostname && typeof clientConfiguration === 'object') {
-                        const { webSocketURL } = clientConfiguration;
-                        if (typeof webSocketURL === 'object') {
-                            clientConfiguration.webSocketURL = Object.assign(Object.assign({}, webSocketURL), { hostname });
-                        }
-                    }
-                    devServerOptions = Object.assign(Object.assign({}, devServerOptions), { server: {
-                            type: 'https',
-                            options: {
-                                minVersion: 'TLSv1.3',
-                                key: certificate.pemKey,
-                                cert: certificate.pemCertificate,
-                                ca: certificate.pemCaCertificate
-                            }
-                        } });
-                }
-                // Since the webpack-dev-server does not return infrastructure errors via a callback like
-                // compiler.watch(...), we will need to intercept them and log them ourselves.
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                compiler.hooks.infrastructureLog.tap(exports.PLUGIN_NAME, (name, type, args) => {
-                    if (name === WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME && type === 'error') {
-                        const error = args[0];
-                        if (error) {
-                            taskSession.logger.emitError(error);
-                        }
-                    }
-                    return true;
-                });
-                // The webpack-dev-server package has a design flaw, where merely loading its package will set the
-                // WEBPACK_DEV_SERVER environment variable -- even if no APIs are accessed. This environment variable
-                // causes incorrect behavior if Heft is not running in serve mode. Thus, we need to be careful to call
-                // require() only if Heft is in serve mode.
-                taskSession.logger.terminal.writeLine('Starting webpack-dev-server');
-                const WebpackDevServer = (await Promise.resolve().then(() => __importStar(require(WEBPACK_DEV_SERVER_PACKAGE_NAME))))
-                    .default;
-                const webpackDevServer = new WebpackDevServer(devServerOptions, compiler);
-                await webpackDevServer.start();
-            }
-            else {
-                // Create the watcher. Compilation will start immediately after invoking watch().
-                taskSession.logger.terminal.writeLine('Starting Webpack watcher');
-                compiler.watch({}, (error) => {
-                    if (error) {
-                        taskSession.logger.emitError(error);
-                    }
-                });
-            }
-            // Store the watchers to be used for suspend/resume
-            this._webpackWatchers = ((_b = compiler.compilers) !== null && _b !== void 0 ? _b : [compiler]).map((compiler) => compiler.watching);
-        }
-        // Resume the compilation, wait for the compilation to complete, then suspend the watchers until the
-        // next iteration. Even if there are no changes, the promise should resolve since resuming from a
-        // suspended state invalidates the state of the watcher.
-        taskSession.logger.terminal.writeLine('Running incremental Webpack compilation');
-        for (const watcher of this._webpackWatchers) {
-            watcher.resume();
-        }
-        await webpackCompilationDonePromise;
-        for (const watcher of this._webpackWatchers) {
-            watcher.suspend();
-        }
-    }
-    _validateEnvironmentVariable(taskSession) {
-        if (!this._isServeMode && process.env[WEBPACK_DEV_SERVER_ENV_VAR_NAME]) {
-            taskSession.logger.emitWarning(new Error(`The "${WEBPACK_DEV_SERVER_ENV_VAR_NAME}" environment variable is set, ` +
-                'which will cause problems when webpack is not running in serve mode. ' +
-                `(Did a dependency inadvertently load the "${WEBPACK_DEV_SERVER_PACKAGE_NAME}" package?)`));
-        }
-    }
-    _emitErrors(logger, stats, buildFolderPath) {
-        if (stats.hasErrors() || stats.hasWarnings()) {
-            const serializedStats = stats.toJson('errors-warnings');
-            if (serializedStats.warnings) {
-                for (const warning of serializedStats.warnings) {
-                    logger.emitWarning(this._normalizeError(buildFolderPath, warning));
-                }
-            }
-            if (serializedStats.errors) {
-                for (const error of serializedStats.errors) {
-                    logger.emitError(this._normalizeError(buildFolderPath, error));
-                }
-            }
-        }
-    }
-    _normalizeError(buildFolderPath, error) {
-        if (error instanceof Error) {
-            return error;
-        }
-        else if (error.moduleIdentifier) {
-            let lineNumber;
-            let columnNumber;
-            if (error.loc) {
-                // Format of "<line>:<columnStart>-<columnEnd>"
-                // https://webpack.js.org/api/stats/#errors-and-warnings
-                const [lineNumberRaw, columnRangeRaw] = error.loc.split(':');
-                const [startColumnRaw] = columnRangeRaw.split('-');
-                if (lineNumberRaw) {
-                    lineNumber = parseInt(lineNumberRaw, 10);
-                    if (isNaN(lineNumber)) {
-                        lineNumber = undefined;
-                    }
-                }
-                if (startColumnRaw) {
-                    columnNumber = parseInt(startColumnRaw, 10);
-                    if (isNaN(columnNumber)) {
-                        columnNumber = undefined;
-                    }
-                }
-            }
-            return new node_core_library_1.FileError(error.message, {
-                absolutePath: error.moduleIdentifier,
-                projectFolder: buildFolderPath,
-                line: lineNumber,
-                column: columnNumber
-            });
-        }
-        else {
-            return new Error(error.message);
-        }
-    }
-}
-exports.default = Webpack5Plugin;
-//# sourceMappingURL=Webpack5Plugin.js.map

package/lib/Webpack5Plugin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Webpack5Plugin.js","sourceRoot":"","sources":["../src/Webpack5Plugin.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;AAK3D,qCAAkF;AAClF,oFAA6F;AAC7F,oEAAwF;AAWxF,6EAA0E;AAU1E;;GAEG;AACU,QAAA,WAAW,GAAsB,iBAAiB,CAAC;AAChE,MAAM,yBAAyB,GAAc,SAAS,CAAC;AACvD,MAAM,oBAAoB,GAAc,SAAS,CAAC;AAClD,MAAM,+BAA+B,GAAyB,oBAAoB,CAAC;AACnF,MAAM,+BAA+B,GAAyB,oBAAoB,CAAC;AACnF,MAAM,mCAAmC,GAA6B,wBAAwB,CAAC;AAC/F,MAAM,aAAa,GAAoB,eAAe,CAAC;AAEvD;;GAEG;AACH,MAAqB,cAAc;IAAnC;QAEU,iBAAY,GAAY,KAAK,CAAC;QAG9B,0BAAqB,GAA6D,aAAa,CAAC;IA8Z1G,CAAC;IAzZC,IAAW,QAAQ;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACnB,IAAI,CAAC,SAAS,GAAG;gBACf,KAAK,EAAE;oBACL,mBAAmB,EAAE,IAAI,6BAAmB,EAAE;oBAC9C,WAAW,EAAE,IAAI,yBAAe,CAAC,CAAC,sBAAsB,CAAC,CAAC;oBAC1D,gBAAgB,EAAE,IAAI,2BAAiB,CAAC,CAAC,sBAAsB,CAAC,CAAC;oBACjE,WAAW,EAAE,IAAI,2BAAiB,CAAC,CAAC,cAAc,CAAC,CAAC;iBACrD;gBACD,UAAU,EAAE;oBACV,WAAW,EAAE,IAAI,CAAC,YAAY;iBAC/B;aACF,CAAC;SACH;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,KAAK,CACV,WAA6B,EAC7B,iBAAoC,EACpC,OAA8B;QAE9B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,CAAC,KAAK,CAAC;QAC7F,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE;YACtD,MAAM,IAAI,KAAK,CACb,OAAO,IAAI,CAAC,SAAS,CACnB,yBAAyB,CAC1B,0DAA0D,CAC5D,CAAC;SACH;QAED,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAW,EAAE,KAAK,EAAE,UAAmC,EAAE,EAAE;YAC1F,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,CACzC,mBAAW,EACX,KAAK,EAAE,UAA8C,EAAE,EAAE;YACvD,MAAM,IAAI,CAAC,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;QAC5E,CAAC,CACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,6BAA6B,CACzC,WAA6B,EAC7B,iBAAoC,EACpC,OAA8B;QAE9B,IAAI,IAAI,CAAC,qBAAqB,KAAK,aAAa,EAAE;YAChD,0EAA0E;YAC1E,uDAAuD;YACvD,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAC1C,+DAA+D,CAChE,CAAC;YACF,IAAI,oBAAoB,GACtB,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC;YAC1D,IAAI,oBAAoB,KAAK,SAAS,EAAE;gBACtC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,mDAAmD,CAAC,CAAC;gBAClG,MAAM,mBAAmB,GAA+B,IAAI,uDAA0B,CACpF,WAAW,CAAC,MAAM,EAClB,WAAW,CAAC,UAAU,CAAC,UAAU,EACjC,WAAW,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAClD,CAAC;gBACF,oBAAoB,GAAG,MAAM,mBAAmB,CAAC,gCAAgC,iCAC5E,OAAO,KACV,WAAW;oBACX,iBAAiB,EACjB,kBAAkB,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IACrD,CAAC;aACJ;YAED,IAAI,oBAAoB,KAAK,KAAK,EAAE;gBAClC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;gBAC7E,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;aACxC;iBAAM,IACL,oBAAoB,KAAK,SAAS;gBAClC,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC,CAAC,EAC1E;gBACA,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;gBACxE,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;aACxC;iBAAM;gBACL,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE;oBAC5C,mDAAmD;oBACnD,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;iBACrE;gBACD,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE;oBACjD,sCAAsC;oBACtC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;iBAC1E;gBACD,IAAI,CAAC,qBAAqB,GAAG,oBAAoB,CAAC;aACnD;SACF;QACD,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,iBAAiB;QAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAClB,iDAAiD;YACjD,IAAI,CAAC,QAAQ,GAAG,wDAAa,oBAAoB,GAAC,CAAC;SACpD;QACD,OAAO,IAAI,CAAC,QAAS,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,wBAAwB,CACpC,WAA6B,EAC7B,oBAA2C;QAE3C,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC1B,MAAM,OAAO,GAAoB,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAChE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,yBAAyB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;gBACzD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,8CAA8C;gBACtF,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,uCAAuC;SACnF;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,WAA6B,EAC7B,iBAAoC,EACpC,OAA8B;QAE9B,IAAI,CAAC,4BAA4B,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,WAAW,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE;YACrD,wCAAwC;YACxC,MAAM,IAAI,iCAAa,CAAC,mEAAmE,CAAC,CAAC;SAC9F;QAED,uEAAuE;QACvE,MAAM,oBAAoB,GAAsC,MAAM,IAAI,CAAC,6BAA6B,CACtG,WAAW,EACX,iBAAiB,EACjB,OAAO,CACR,CAAC;QACF,IAAI,CAAC,oBAAoB,EAAE;YACzB,OAAO;SACR;QACD,MAAM,QAAQ,GAA6C,MAAM,IAAI,CAAC,wBAAwB,CAC5F,WAAW,EACX,oBAAoB,CACrB,CAAC;QACF,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAErE,2BAA2B;QAC3B,IAAI,KAAuD,CAAC;QAC5D,IAAI;YACF,KAAK,GAAG,MAAM,kCAAc,CAAC,wBAAwB,CAClD,QAA6B,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAClD,CAAC;YACF,MAAM,kCAAc,CAAC,wBAAwB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;SAC9E;QAAC,OAAO,CAAC,EAAE;YACV,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAU,CAAC,CAAC;SAC1C;QAED,oDAAoD;QACpD,IAAI,KAAK,EAAE;YACT,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;YAC/E,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE;gBAC5C,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;aACtD;SACF;IACH,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,WAA6B,EAC7B,iBAAoC,EACpC,OAA8B;;QAE9B,iGAAiG;QACjG,6BAA6B;QAC7B,IAAI,6BAA6B,GAA8B,IAAI,CAAC,8BAA8B,CAAC;QAEnG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC1B,IAAI,CAAC,4BAA4B,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,EAAE;gBACjC,wCAAwC;gBACxC,MAAM,IAAI,iCAAa,CAAC,mEAAmE,CAAC,CAAC;aAC9F;YAED,uEAAuE;YACvE,MAAM,oBAAoB,GACxB,MAAM,IAAI,CAAC,6BAA6B,CAAC,WAAW,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;YACpF,IAAI,CAAC,oBAAoB,EAAE;gBACzB,OAAO;aACR;YAED,oEAAoE;YACpE,MAAM,QAAQ,GAA6C,MAAM,IAAI,CAAC,wBAAwB,CAC5F,WAAW,EACX,oBAAoB,CACrB,CAAC;YAEF,qGAAqG;YACrG,uEAAuE;YACvE,IAAI,CAAC,8BAA8B,GAAG,IAAI,OAAO,CAAC,CAAC,OAAmB,EAAE,EAAE;gBACxE,IAAI,CAAC,uCAAuC,GAAG,OAAO,CAAC;YACzD,CAAC,CAAC,CAAC;YACH,6BAA6B,GAAG,IAAI,CAAC,8BAA8B,CAAC;YACpE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAW,EAAE,CAAC,KAA4C,EAAE,EAAE;gBACpF,IAAI,CAAC,uCAAwC,EAAE,CAAC;gBAChD,IAAI,CAAC,8BAA8B,GAAG,IAAI,OAAO,CAAC,CAAC,OAAmB,EAAE,EAAE;oBACxE,IAAI,CAAC,uCAAuC,GAAG,OAAO,CAAC;gBACzD,CAAC,CAAC,CAAC;gBACH,IAAI,KAAK,EAAE;oBACT,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;iBAChF;YACH,CAAC,CAAC,CAAC;YAEH,iFAAiF;YACjF,4EAA4E;YAC5E,IAAI,IAAI,CAAC,YAAY,EAAE;gBACrB,MAAM,uBAAuB,GAAoC;oBAC/D,IAAI,EAAE,WAAW;oBACjB,aAAa,EAAE;wBACb,UAAU,EAAE,GAAG;wBACf,KAAK,EAAE;4BACL,MAAM,EAAE,KAAK;4BACb,YAAY,EAAE,KAAK;4BACnB,MAAM,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,aAAa;yBACzD;qBACF;oBACD,MAAM,EAAE;wBACN,OAAO,EAAE,MAAM;wBACf,YAAY,EAAE;4BACZ,IAAI,EAAE,IAAI;yBACX;qBACF;oBACD,IAAI,EAAE,IAAI;oBACV,WAAW,EAAE,CAAC,MAAyB,EAAE,EAAE;;wBACzC,MAAM,WAAW,GAAqC,MAAA,MAAM,CAAC,MAAM,0CAAE,OAAO,EAAiB,CAAC;wBAC9F,IAAI,WAAW,EAAE;4BACf,MAAM,OAAO,GACX,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;4BAC/F,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;yBAC3F;oBACH,CAAC;iBACF,CAAC;gBAEF,mGAAmG;gBACnG,IAAI,gBAAiD,CAAC;gBACtD,IAAI,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE;oBACvC,MAAM,wBAAwB,GAAsC,oBAAoB;yBACrF,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC;yBAC/C,MAAM,CAAC,CAAC,SAAS,EAAgD,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;oBACpF,IAAI,wBAAwB,CAAC,MAAM,GAAG,CAAC,EAAE;wBACvC,WAAW,CAAC,MAAM,CAAC,WAAW,CAC5B,IAAI,KAAK,CAAC,0EAA0E,CAAC,CACtF,CAAC;qBACH;oBACD,gBAAgB,mCAAQ,uBAAuB,GAAK,wBAAwB,CAAC,CAAC,CAAC,CAAE,CAAC;iBACnF;qBAAM;oBACL,gBAAgB,mCAAQ,uBAAuB,GAAK,oBAAoB,CAAC,SAAS,CAAE,CAAC;iBACtF;gBAED,gGAAgG;gBAChG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE;oBAC5B,MAAM,kBAAkB,GAAuB,IAAI,8CAAkB,EAAE,CAAC;oBACxE,MAAM,WAAW,GAAiB,MAAM,kBAAkB,CAAC,sBAAsB,CAC/E,IAAI,EACJ,WAAW,CAAC,MAAM,CAAC,QAAQ,CAC5B,CAAC;oBAEF,4EAA4E;oBAC5E,MAAM,mBAAmB,GAA8C,gBAAgB,CAAC,MAAM,CAAC;oBAC/F,MAAM,QAAQ,GAAuB,MAAA,WAAW,CAAC,eAAe,0CAAG,CAAC,CAAC,CAAC;oBACtE,IAAI,QAAQ,IAAI,OAAO,mBAAmB,KAAK,QAAQ,EAAE;wBACvD,MAAM,EAAE,YAAY,EAAE,GAAG,mBAAmB,CAAC;wBAC7C,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE;4BACpC,mBAAmB,CAAC,YAAY,mCAC3B,YAAY,KACf,QAAQ,GACT,CAAC;yBACH;qBACF;oBAED,gBAAgB,mCACX,gBAAgB,KACnB,MAAM,EAAE;4BACN,IAAI,EAAE,OAAO;4BACb,OAAO,EAAE;gCACP,UAAU,EAAE,SAAS;gCACrB,GAAG,EAAE,WAAW,CAAC,MAAM;gCACvB,IAAI,EAAE,WAAW,CAAC,cAAc;gCAChC,EAAE,EAAE,WAAW,CAAC,gBAAgB;6BACjC;yBACF,GACF,CAAC;iBACH;gBAED,yFAAyF;gBACzF,8EAA8E;gBAC9E,8DAA8D;gBAC9D,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,mBAAW,EAAE,CAAC,IAAY,EAAE,IAAY,EAAE,IAAW,EAAE,EAAE;oBAC5F,IAAI,IAAI,KAAK,mCAAmC,IAAI,IAAI,KAAK,OAAO,EAAE;wBACpE,MAAM,KAAK,GAAsB,IAAI,CAAC,CAAC,CAAC,CAAC;wBACzC,IAAI,KAAK,EAAE;4BACT,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;yBACrC;qBACF;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC,CAAC,CAAC;gBAEH,kGAAkG;gBAClG,qGAAqG;gBACrG,sGAAsG;gBACtG,2CAA2C;gBAC3C,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;gBACrE,MAAM,gBAAgB,GAA6B,CAAC,wDAAa,+BAA+B,GAAC,CAAC;qBAC/F,OAAO,CAAC;gBACX,MAAM,gBAAgB,GAAsB,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;gBAC7F,MAAM,gBAAgB,CAAC,KAAK,EAAE,CAAC;aAChC;iBAAM;gBACL,iFAAiF;gBACjF,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;gBAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAoB,EAAE,EAAE;oBAC1C,IAAI,KAAK,EAAE;wBACT,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;qBACrC;gBACH,CAAC,CAAC,CAAC;aACJ;YAED,mDAAmD;YACnD,IAAI,CAAC,gBAAgB,GAAG,CACtB,MAAC,QAAkC,CAAC,SAAS,mCAAI,CAAC,QAA4B,CAAC,CAChF,CAAC,GAAG,CAAC,CAAC,QAA0B,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAC1D;QAED,oGAAoG;QACpG,iGAAiG;QACjG,wDAAwD;QACxD,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;QACjF,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,EAAE;YAC3C,OAAO,CAAC,MAAM,EAAE,CAAC;SAClB;QACD,MAAM,6BAA6B,CAAC;QACpC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,EAAE;YAC3C,OAAO,CAAC,OAAO,EAAE,CAAC;SACnB;IACH,CAAC;IAEO,4BAA4B,CAAC,WAA6B;QAChE,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,EAAE;YACtE,WAAW,CAAC,MAAM,CAAC,WAAW,CAC5B,IAAI,KAAK,CACP,QAAQ,+BAA+B,iCAAiC;gBACtE,uEAAuE;gBACvE,6CAA6C,+BAA+B,aAAa,CAC5F,CACF,CAAC;SACH;IACH,CAAC;IAEO,WAAW,CACjB,MAAqB,EACrB,KAA2C,EAC3C,eAAuB;QAEvB,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE;YAC5C,MAAM,eAAe,GAA8B,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAEnF,IAAI,eAAe,CAAC,QAAQ,EAAE;gBAC5B,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE;oBAC9C,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;iBACpE;aACF;YAED,IAAI,eAAe,CAAC,MAAM,EAAE;gBAC1B,KAAK,MAAM,KAAK,IAAI,eAAe,CAAC,MAAM,EAAE;oBAC1C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC;iBAChE;aACF;SACF;IACH,CAAC;IAEO,eAAe,CAAC,eAAuB,EAAE,KAA0B;QACzE,IAAI,KAAK,YAAY,KAAK,EAAE;YAC1B,OAAO,KAAK,CAAC;SACd;aAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE;YACjC,IAAI,UAA8B,CAAC;YACnC,IAAI,YAAgC,CAAC;YACrC,IAAI,KAAK,CAAC,GAAG,EAAE;gBACb,+CAA+C;gBAC/C,wDAAwD;gBACxD,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC7D,MAAM,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACnD,IAAI,aAAa,EAAE;oBACjB,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;oBACzC,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE;wBACrB,UAAU,GAAG,SAAS,CAAC;qBACxB;iBACF;gBACD,IAAI,cAAc,EAAE;oBAClB,YAAY,GAAG,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;oBAC5C,IAAI,KAAK,CAAC,YAAY,CAAC,EAAE;wBACvB,YAAY,GAAG,SAAS,CAAC;qBAC1B;iBACF;aACF;YAED,OAAO,IAAI,6BAAS,CAAC,KAAK,CAAC,OAAO,EAAE;gBAClC,YAAY,EAAE,KAAK,CAAC,gBAAgB;gBACpC,aAAa,EAAE,eAAe;gBAC9B,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;SACJ;aAAM;YACL,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;SACjC;IACH,CAAC;CACF;AAnaD,iCAmaC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { AddressInfo } from 'net';\nimport type * as TWebpack from 'webpack';\nimport type TWebpackDevServer from 'webpack-dev-server';\nimport { AsyncParallelHook, AsyncSeriesBailHook, AsyncSeriesHook } from 'tapable';\nimport { CertificateManager, type ICertificate } from '@rushstack/debug-certificate-manager';\nimport { FileError, InternalError, LegacyAdapters } from '@rushstack/node-core-library';\nimport type {\n  HeftConfiguration,\n  IHeftTaskSession,\n  IHeftTaskPlugin,\n  IHeftTaskRunHookOptions,\n  IScopedLogger,\n  IHeftTaskRunIncrementalHookOptions\n} from '@rushstack/heft';\n\nimport type { IWebpackConfiguration, IWebpackPluginAccessor } from './shared';\nimport { WebpackConfigurationLoader } from './WebpackConfigurationLoader';\n\ntype ExtendedCompiler = TWebpack.Compiler & { watching: TWebpack.Watching };\ntype ExtendedMultiCompiler = TWebpack.MultiCompiler & { compilers: ExtendedCompiler[] };\n\nexport interface IWebpackPluginOptions {\n  devConfigurationPath: string | undefined;\n  configurationPath: string | undefined;\n}\n\n/**\n * @public\n */\nexport const PLUGIN_NAME: 'webpack5-plugin' = 'webpack5-plugin';\nconst SERVE_PARAMETER_LONG_NAME: '--serve' = '--serve';\nconst WEBPACK_PACKAGE_NAME: 'webpack' = 'webpack';\nconst WEBPACK_DEV_SERVER_PACKAGE_NAME: 'webpack-dev-server' = 'webpack-dev-server';\nconst WEBPACK_DEV_SERVER_ENV_VAR_NAME: 'WEBPACK_DEV_SERVER' = 'WEBPACK_DEV_SERVER';\nconst WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME: 'webpack-dev-middleware' = 'webpack-dev-middleware';\nconst UNINITIALIZED: 'UNINITIALIZED' = 'UNINITIALIZED';\n\n/**\n * @internal\n */\nexport default class Webpack5Plugin implements IHeftTaskPlugin<IWebpackPluginOptions> {\n  private _accessor: IWebpackPluginAccessor | undefined;\n  private _isServeMode: boolean = false;\n  private _webpack: typeof TWebpack | undefined;\n  private _webpackCompiler: ExtendedCompiler | ExtendedMultiCompiler | undefined;\n  private _webpackConfiguration: IWebpackConfiguration | undefined | typeof UNINITIALIZED = UNINITIALIZED;\n  private _webpackWatchers: TWebpack.Watching[] | undefined;\n  private _webpackCompilationDonePromise: Promise<void> | undefined;\n  private _webpackCompilationDonePromiseResolveFn: (() => void) | undefined;\n\n  public get accessor(): IWebpackPluginAccessor {\n    if (!this._accessor) {\n      this._accessor = {\n        hooks: {\n          onLoadConfiguration: new AsyncSeriesBailHook(),\n          onConfigure: new AsyncSeriesHook(['webpackConfiguration']),\n          onAfterConfigure: new AsyncParallelHook(['webpackConfiguration']),\n          onEmitStats: new AsyncParallelHook(['webpackStats'])\n        },\n        parameters: {\n          isServeMode: this._isServeMode\n        }\n      };\n    }\n    return this._accessor;\n  }\n\n  public apply(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions\n  ): void {\n    this._isServeMode = taskSession.parameters.getFlagParameter(SERVE_PARAMETER_LONG_NAME).value;\n    if (!taskSession.parameters.watch && this._isServeMode) {\n      throw new Error(\n        `The ${JSON.stringify(\n          SERVE_PARAMETER_LONG_NAME\n        )} parameter is only available when running in watch mode.`\n      );\n    }\n\n    taskSession.hooks.run.tapPromise(PLUGIN_NAME, async (runOptions: IHeftTaskRunHookOptions) => {\n      await this._runWebpackAsync(taskSession, heftConfiguration, options);\n    });\n\n    taskSession.hooks.runIncremental.tapPromise(\n      PLUGIN_NAME,\n      async (runOptions: IHeftTaskRunIncrementalHookOptions) => {\n        await this._runWebpackWatchAsync(taskSession, heftConfiguration, options);\n      }\n    );\n  }\n\n  private async _getWebpackConfigurationAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions\n  ): Promise<IWebpackConfiguration | undefined> {\n    if (this._webpackConfiguration === UNINITIALIZED) {\n      // Obtain the webpack configuration by calling into the hook. If undefined\n      // is returned, load the default Webpack configuration.\n      taskSession.logger.terminal.writeVerboseLine(\n        'Attempting to load Webpack configuration via external plugins'\n      );\n      let webpackConfiguration: IWebpackConfiguration | false | undefined =\n        await this.accessor.hooks.onLoadConfiguration.promise();\n      if (webpackConfiguration === undefined) {\n        taskSession.logger.terminal.writeVerboseLine('Attempt to load the default Webpack configuration');\n        const configurationLoader: WebpackConfigurationLoader = new WebpackConfigurationLoader(\n          taskSession.logger,\n          taskSession.parameters.production,\n          taskSession.parameters.watch && this._isServeMode\n        );\n        webpackConfiguration = await configurationLoader.tryLoadWebpackConfigurationAsync({\n          ...options,\n          taskSession,\n          heftConfiguration,\n          loadWebpackAsyncFn: this._loadWebpackAsync.bind(this)\n        });\n      }\n\n      if (webpackConfiguration === false) {\n        taskSession.logger.terminal.writeLine('Webpack disabled by external plugin');\n        this._webpackConfiguration = undefined;\n      } else if (\n        webpackConfiguration === undefined ||\n        (Array.isArray(webpackConfiguration) && webpackConfiguration.length === 0)\n      ) {\n        taskSession.logger.terminal.writeLine('No Webpack configuration found');\n        this._webpackConfiguration = undefined;\n      } else {\n        if (this.accessor.hooks.onConfigure.isUsed()) {\n          // Allow for plugins to customise the configuration\n          await this.accessor.hooks.onConfigure.promise(webpackConfiguration);\n        }\n        if (this.accessor.hooks.onAfterConfigure.isUsed()) {\n          // Provide the finalized configuration\n          await this.accessor.hooks.onAfterConfigure.promise(webpackConfiguration);\n        }\n        this._webpackConfiguration = webpackConfiguration;\n      }\n    }\n    return this._webpackConfiguration;\n  }\n\n  private async _loadWebpackAsync(): Promise<typeof TWebpack> {\n    if (!this._webpack) {\n      // Allow this to fail if webpack is not installed\n      this._webpack = await import(WEBPACK_PACKAGE_NAME);\n    }\n    return this._webpack!;\n  }\n\n  private async _getWebpackCompilerAsync(\n    taskSession: IHeftTaskSession,\n    webpackConfiguration: IWebpackConfiguration\n  ): Promise<ExtendedCompiler | ExtendedMultiCompiler> {\n    if (!this._webpackCompiler) {\n      const webpack: typeof TWebpack = await this._loadWebpackAsync();\n      taskSession.logger.terminal.writeLine(`Using Webpack version ${webpack.version}`);\n      this._webpackCompiler = Array.isArray(webpackConfiguration)\n        ? webpack.default(webpackConfiguration) /* (webpack.Compilation[]) => MultiCompiler */\n        : webpack.default(webpackConfiguration); /* (webpack.Compilation) => Compiler */\n    }\n    return this._webpackCompiler;\n  }\n\n  private async _runWebpackAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions\n  ): Promise<void> {\n    this._validateEnvironmentVariable(taskSession);\n    if (taskSession.parameters.watch || this._isServeMode) {\n      // Should never happen, but just in case\n      throw new InternalError('Cannot run Webpack in compilation mode when watch mode is enabled');\n    }\n\n    // Load the config and compiler, and return if there is no config found\n    const webpackConfiguration: IWebpackConfiguration | undefined = await this._getWebpackConfigurationAsync(\n      taskSession,\n      heftConfiguration,\n      options\n    );\n    if (!webpackConfiguration) {\n      return;\n    }\n    const compiler: ExtendedCompiler | ExtendedMultiCompiler = await this._getWebpackCompilerAsync(\n      taskSession,\n      webpackConfiguration\n    );\n    taskSession.logger.terminal.writeLine('Running Webpack compilation');\n\n    // Run the webpack compiler\n    let stats: TWebpack.Stats | TWebpack.MultiStats | undefined;\n    try {\n      stats = await LegacyAdapters.convertCallbackToPromise(\n        (compiler as ExtendedCompiler).run.bind(compiler)\n      );\n      await LegacyAdapters.convertCallbackToPromise(compiler.close.bind(compiler));\n    } catch (e) {\n      taskSession.logger.emitError(e as Error);\n    }\n\n    // Emit the errors from the stats object, if present\n    if (stats) {\n      this._emitErrors(taskSession.logger, stats, heftConfiguration.buildFolderPath);\n      if (this.accessor.hooks.onEmitStats.isUsed()) {\n        await this.accessor.hooks.onEmitStats.promise(stats);\n      }\n    }\n  }\n\n  private async _runWebpackWatchAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions\n  ): Promise<void> {\n    // Save a handle to the original promise, since the this-scoped promise will be replaced whenever\n    // the compilation completes.\n    let webpackCompilationDonePromise: Promise<void> | undefined = this._webpackCompilationDonePromise;\n\n    if (!this._webpackWatchers) {\n      this._validateEnvironmentVariable(taskSession);\n      if (!taskSession.parameters.watch) {\n        // Should never happen, but just in case\n        throw new InternalError('Cannot run Webpack in watch mode when compilation mode is enabled');\n      }\n\n      // Load the config and compiler, and return if there is no config found\n      const webpackConfiguration: IWebpackConfiguration | undefined =\n        await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options);\n      if (!webpackConfiguration) {\n        return;\n      }\n\n      // Get the compiler which will be used for both serve and watch mode\n      const compiler: ExtendedCompiler | ExtendedMultiCompiler = await this._getWebpackCompilerAsync(\n        taskSession,\n        webpackConfiguration\n      );\n\n      // Set up the hook to detect when the watcher completes the watcher compilation. We will also log out\n      // errors from the compilation if present from the output stats object.\n      this._webpackCompilationDonePromise = new Promise((resolve: () => void) => {\n        this._webpackCompilationDonePromiseResolveFn = resolve;\n      });\n      webpackCompilationDonePromise = this._webpackCompilationDonePromise;\n      compiler.hooks.done.tap(PLUGIN_NAME, (stats?: TWebpack.Stats | TWebpack.MultiStats) => {\n        this._webpackCompilationDonePromiseResolveFn!();\n        this._webpackCompilationDonePromise = new Promise((resolve: () => void) => {\n          this._webpackCompilationDonePromiseResolveFn = resolve;\n        });\n        if (stats) {\n          this._emitErrors(taskSession.logger, stats, heftConfiguration.buildFolderPath);\n        }\n      });\n\n      // Determine how we will run the compiler. When serving, we will run the compiler\n      // via the webpack-dev-server. Otherwise, we will run the compiler directly.\n      if (this._isServeMode) {\n        const defaultDevServerOptions: TWebpackDevServer.Configuration = {\n          host: 'localhost',\n          devMiddleware: {\n            publicPath: '/',\n            stats: {\n              cached: false,\n              cachedAssets: false,\n              colors: heftConfiguration.terminalProvider.supportsColor\n            }\n          },\n          client: {\n            logging: 'info',\n            webSocketURL: {\n              port: 8080\n            }\n          },\n          port: 8080,\n          onListening: (server: TWebpackDevServer) => {\n            const addressInfo: AddressInfo | string | undefined = server.server?.address() as AddressInfo;\n            if (addressInfo) {\n              const address: string =\n                typeof addressInfo === 'string' ? addressInfo : `${addressInfo.address}:${addressInfo.port}`;\n              taskSession.logger.terminal.writeLine(`Started Webpack Dev Server at https://${address}`);\n            }\n          }\n        };\n\n        // Obtain the devServerOptions from the webpack configuration, and combine with the default options\n        let devServerOptions: TWebpackDevServer.Configuration;\n        if (Array.isArray(webpackConfiguration)) {\n          const filteredDevServerOptions: TWebpackDevServer.Configuration[] = webpackConfiguration\n            .map((configuration) => configuration.devServer)\n            .filter((devServer): devServer is TWebpackDevServer.Configuration => !!devServer);\n          if (filteredDevServerOptions.length > 1) {\n            taskSession.logger.emitWarning(\n              new Error(`Detected multiple webpack devServer configurations, using the first one.`)\n            );\n          }\n          devServerOptions = { ...defaultDevServerOptions, ...filteredDevServerOptions[0] };\n        } else {\n          devServerOptions = { ...defaultDevServerOptions, ...webpackConfiguration.devServer };\n        }\n\n        // Add the certificate and key to the devServerOptions if these fields don't already have values\n        if (!devServerOptions.server) {\n          const certificateManager: CertificateManager = new CertificateManager();\n          const certificate: ICertificate = await certificateManager.ensureCertificateAsync(\n            true,\n            taskSession.logger.terminal\n          );\n\n          // Update the web socket URL to use the hostname provided by the certificate\n          const clientConfiguration: TWebpackDevServer.Configuration['client'] = devServerOptions.client;\n          const hostname: string | undefined = certificate.subjectAltNames?.[0];\n          if (hostname && typeof clientConfiguration === 'object') {\n            const { webSocketURL } = clientConfiguration;\n            if (typeof webSocketURL === 'object') {\n              clientConfiguration.webSocketURL = {\n                ...webSocketURL,\n                hostname\n              };\n            }\n          }\n\n          devServerOptions = {\n            ...devServerOptions,\n            server: {\n              type: 'https',\n              options: {\n                minVersion: 'TLSv1.3',\n                key: certificate.pemKey,\n                cert: certificate.pemCertificate,\n                ca: certificate.pemCaCertificate\n              }\n            }\n          };\n        }\n\n        // Since the webpack-dev-server does not return infrastructure errors via a callback like\n        // compiler.watch(...), we will need to intercept them and log them ourselves.\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        compiler.hooks.infrastructureLog.tap(PLUGIN_NAME, (name: string, type: string, args: any[]) => {\n          if (name === WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME && type === 'error') {\n            const error: Error | undefined = args[0];\n            if (error) {\n              taskSession.logger.emitError(error);\n            }\n          }\n          return true;\n        });\n\n        // The webpack-dev-server package has a design flaw, where merely loading its package will set the\n        // WEBPACK_DEV_SERVER environment variable -- even if no APIs are accessed. This environment variable\n        // causes incorrect behavior if Heft is not running in serve mode. Thus, we need to be careful to call\n        // require() only if Heft is in serve mode.\n        taskSession.logger.terminal.writeLine('Starting webpack-dev-server');\n        const WebpackDevServer: typeof TWebpackDevServer = (await import(WEBPACK_DEV_SERVER_PACKAGE_NAME))\n          .default;\n        const webpackDevServer: TWebpackDevServer = new WebpackDevServer(devServerOptions, compiler);\n        await webpackDevServer.start();\n      } else {\n        // Create the watcher. Compilation will start immediately after invoking watch().\n        taskSession.logger.terminal.writeLine('Starting Webpack watcher');\n        compiler.watch({}, (error?: Error | null) => {\n          if (error) {\n            taskSession.logger.emitError(error);\n          }\n        });\n      }\n\n      // Store the watchers to be used for suspend/resume\n      this._webpackWatchers = (\n        (compiler as ExtendedMultiCompiler).compilers ?? [compiler as ExtendedCompiler]\n      ).map((compiler: ExtendedCompiler) => compiler.watching);\n    }\n\n    // Resume the compilation, wait for the compilation to complete, then suspend the watchers until the\n    // next iteration. Even if there are no changes, the promise should resolve since resuming from a\n    // suspended state invalidates the state of the watcher.\n    taskSession.logger.terminal.writeLine('Running incremental Webpack compilation');\n    for (const watcher of this._webpackWatchers) {\n      watcher.resume();\n    }\n    await webpackCompilationDonePromise;\n    for (const watcher of this._webpackWatchers) {\n      watcher.suspend();\n    }\n  }\n\n  private _validateEnvironmentVariable(taskSession: IHeftTaskSession): void {\n    if (!this._isServeMode && process.env[WEBPACK_DEV_SERVER_ENV_VAR_NAME]) {\n      taskSession.logger.emitWarning(\n        new Error(\n          `The \"${WEBPACK_DEV_SERVER_ENV_VAR_NAME}\" environment variable is set, ` +\n            'which will cause problems when webpack is not running in serve mode. ' +\n            `(Did a dependency inadvertently load the \"${WEBPACK_DEV_SERVER_PACKAGE_NAME}\" package?)`\n        )\n      );\n    }\n  }\n\n  private _emitErrors(\n    logger: IScopedLogger,\n    stats: TWebpack.Stats | TWebpack.MultiStats,\n    buildFolderPath: string\n  ): void {\n    if (stats.hasErrors() || stats.hasWarnings()) {\n      const serializedStats: TWebpack.StatsCompilation = stats.toJson('errors-warnings');\n\n      if (serializedStats.warnings) {\n        for (const warning of serializedStats.warnings) {\n          logger.emitWarning(this._normalizeError(buildFolderPath, warning));\n        }\n      }\n\n      if (serializedStats.errors) {\n        for (const error of serializedStats.errors) {\n          logger.emitError(this._normalizeError(buildFolderPath, error));\n        }\n      }\n    }\n  }\n\n  private _normalizeError(buildFolderPath: string, error: TWebpack.StatsError): Error {\n    if (error instanceof Error) {\n      return error;\n    } else if (error.moduleIdentifier) {\n      let lineNumber: number | undefined;\n      let columnNumber: number | undefined;\n      if (error.loc) {\n        // Format of \"<line>:<columnStart>-<columnEnd>\"\n        // https://webpack.js.org/api/stats/#errors-and-warnings\n        const [lineNumberRaw, columnRangeRaw] = error.loc.split(':');\n        const [startColumnRaw] = columnRangeRaw.split('-');\n        if (lineNumberRaw) {\n          lineNumber = parseInt(lineNumberRaw, 10);\n          if (isNaN(lineNumber)) {\n            lineNumber = undefined;\n          }\n        }\n        if (startColumnRaw) {\n          columnNumber = parseInt(startColumnRaw, 10);\n          if (isNaN(columnNumber)) {\n            columnNumber = undefined;\n          }\n        }\n      }\n\n      return new FileError(error.message, {\n        absolutePath: error.moduleIdentifier,\n        projectFolder: buildFolderPath,\n        line: lineNumber,\n        column: columnNumber\n      });\n    } else {\n      return new Error(error.message);\n    }\n  }\n}\n"]}

package/lib/schemas/heft-webpack5-plugin.schema.json

@@ -1,25 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-04/schema#",
-  "title": "Webpack 5 Plugin Configuration",
-  "description": "Defines options for Webpack 5 plugin execution.",
-  "type": "object",
-
-  "additionalProperties": false,
-
-  "properties": {
-    "$schema": {
-      "description": "Part of the JSON Schema standard, this optional keyword declares the URL of the schema that the file conforms to. Editors may download the schema and use it to perform syntax highlighting.",
-      "type": "string"
-    },
-
-    "devConfigurationPath": {
-      "description": "Specifies a relative path to the Webpack dev configuration, which is used in \"serve\" mode. The default value is \"./webpack.dev.config.js\".",
-      "type": "string"
-    },
-
-    "configurationPath": {
-      "description": "Specifies a relative path to the Webpack configuration. The default value is \"./webpack.config.js\".",
-      "type": "string"
-    }
-  }
-}