@rushstack/rush-sdk 5.161.0 → 5.163.0

package/lib-shim/index.js

@@ -108,7 +108,7 @@ async function iterateAsync(basePath, filePath, segments) {
 
 /***/ "../rush-lib/lib-esnext/api/RushGlobalFolder.js":
 /*!******************************************************************!*\
-  !*** ../rush-lib/lib-esnext/api/RushGlobalFolder.js + 9 modules ***!
+  !*** ../rush-lib/lib-esnext/api/RushGlobalFolder.js + 2 modules ***!
   \******************************************************************/
 /***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
 
@@ -122,181 +122,10 @@ __webpack_require__.d(__webpack_exports__, {
 
 // EXTERNAL MODULE: external "node:path"
 var external_node_path_ = __webpack_require__("node:path");
-;// external "node:child_process"
-const external_node_child_process_namespaceObject = require("node:child_process");
-;// external "node:os"
-const external_node_os_namespaceObject = require("node:os");
-;// external "node:perf_hooks"
-const external_node_perf_hooks_namespaceObject = require("node:perf_hooks");
-;// external "node:stream"
-const external_node_stream_namespaceObject = require("node:stream");
 // EXTERNAL MODULE: external "@rushstack/node-core-library"
 var node_core_library_ = __webpack_require__("@rushstack/node-core-library");
-;// external "node:fs"
-const external_node_fs_namespaceObject = require("node:fs");
-;// ../rush-lib/lib-esnext/utilities/npmrcUtilities.js
-// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
-// See LICENSE in the project root for license information.
-// IMPORTANT - do not use any non-built-in libraries in this file
-
-
-/**
- * This function reads the content for given .npmrc file path, and also trims
- * unusable lines from the .npmrc file.
- *
- * @returns
- * The text of the the .npmrc.
- */
-// create a global _combinedNpmrc for cache purpose
-const _combinedNpmrcMap = new Map();
-function _trimNpmrcFile(options) {
-    const { sourceNpmrcPath, linesToPrepend, linesToAppend, supportEnvVarFallbackSyntax } = options;
-    const combinedNpmrcFromCache = _combinedNpmrcMap.get(sourceNpmrcPath);
-    if (combinedNpmrcFromCache !== undefined) {
-        return combinedNpmrcFromCache;
-    }
-    let npmrcFileLines = [];
-    if (linesToPrepend) {
-        npmrcFileLines.push(...linesToPrepend);
-    }
-    if (external_node_fs_namespaceObject.existsSync(sourceNpmrcPath)) {
-        npmrcFileLines.push(...external_node_fs_namespaceObject.readFileSync(sourceNpmrcPath).toString().split('\n'));
-    }
-    if (linesToAppend) {
-        npmrcFileLines.push(...linesToAppend);
-    }
-    npmrcFileLines = npmrcFileLines.map((line) => (line || '').trim());
-    const resultLines = trimNpmrcFileLines(npmrcFileLines, process.env, supportEnvVarFallbackSyntax);
-    const combinedNpmrc = resultLines.join('\n');
-    //save the cache
-    _combinedNpmrcMap.set(sourceNpmrcPath, combinedNpmrc);
-    return combinedNpmrc;
-}
-/**
- *
- * @param npmrcFileLines The npmrc file's lines
- * @param env The environment variables object
- * @param supportEnvVarFallbackSyntax Whether to support fallback values in the form of `${VAR_NAME:-fallback}`
- * @returns
- */
-function trimNpmrcFileLines(npmrcFileLines, env, supportEnvVarFallbackSyntax) {
-    var _a;
-    const resultLines = [];
-    // This finds environment variable tokens that look like "${VAR_NAME}"
-    const expansionRegExp = /\$\{([^\}]+)\}/g;
-    // Comment lines start with "#" or ";"
-    const commentRegExp = /^\s*[#;]/;
-    // Trim out lines that reference environment variables that aren't defined
-    for (let line of npmrcFileLines) {
-        let lineShouldBeTrimmed = false;
-        //remove spaces before or after key and value
-        line = line
-            .split('=')
-            .map((lineToTrim) => lineToTrim.trim())
-            .join('=');
-        // Ignore comment lines
-        if (!commentRegExp.test(line)) {
-            const environmentVariables = line.match(expansionRegExp);
-            if (environmentVariables) {
-                for (const token of environmentVariables) {
-                    /**
-                     * Remove the leading "${" and the trailing "}" from the token
-                     *
-                     * ${nameString}                  -> nameString
-                     * ${nameString-fallbackString}   -> name-fallbackString
-                     * ${nameString:-fallbackString}  -> name:-fallbackString
-                     */
-                    const nameWithFallback = token.substring(2, token.length - 1);
-                    let environmentVariableName;
-                    let fallback;
-                    if (supportEnvVarFallbackSyntax) {
-                        /**
-                         * Get the environment variable name and fallback value.
-                         *
-                         *                                name          fallback
-                         * nameString                 ->  nameString    undefined
-                         * nameString-fallbackString  ->  nameString    fallbackString
-                         * nameString:-fallbackString ->  nameString    fallbackString
-                         */
-                        const matched = nameWithFallback.match(/^([^:-]+)(?:\:?-(.+))?$/);
-                        // matched: [originStr, variableName, fallback]
-                        environmentVariableName = (_a = matched === null || matched === void 0 ? void 0 : matched[1]) !== null && _a !== void 0 ? _a : nameWithFallback;
-                        fallback = matched === null || matched === void 0 ? void 0 : matched[2];
-                    }
-                    else {
-                        environmentVariableName = nameWithFallback;
-                    }
-                    // Is the environment variable and fallback value defined.
-                    if (!env[environmentVariableName] && !fallback) {
-                        // No, so trim this line
-                        lineShouldBeTrimmed = true;
-                        break;
-                    }
-                }
-            }
-        }
-        if (lineShouldBeTrimmed) {
-            // Example output:
-            // "; MISSING ENVIRONMENT VARIABLE: //my-registry.com/npm/:_authToken=${MY_AUTH_TOKEN}"
-            resultLines.push('; MISSING ENVIRONMENT VARIABLE: ' + line);
-        }
-        else {
-            resultLines.push(line);
-        }
-    }
-    return resultLines;
-}
-function _copyAndTrimNpmrcFile(options) {
-    const { logger, sourceNpmrcPath, targetNpmrcPath } = options;
-    logger.info(`Transforming ${sourceNpmrcPath}`); // Verbose
-    logger.info(`  --> "${targetNpmrcPath}"`);
-    const combinedNpmrc = _trimNpmrcFile(options);
-    external_node_fs_namespaceObject.writeFileSync(targetNpmrcPath, combinedNpmrc);
-    return combinedNpmrc;
-}
-function syncNpmrc(options) {
-    const { sourceNpmrcFolder, targetNpmrcFolder, useNpmrcPublish, logger = {
-        // eslint-disable-next-line no-console
-        info: console.log,
-        // eslint-disable-next-line no-console
-        error: console.error
-    }, createIfMissing = false } = options;
-    const sourceNpmrcPath = external_node_path_.join(sourceNpmrcFolder, !useNpmrcPublish ? '.npmrc' : '.npmrc-publish');
-    const targetNpmrcPath = external_node_path_.join(targetNpmrcFolder, '.npmrc');
-    try {
-        if (external_node_fs_namespaceObject.existsSync(sourceNpmrcPath) || createIfMissing) {
-            // Ensure the target folder exists
-            if (!external_node_fs_namespaceObject.existsSync(targetNpmrcFolder)) {
-                external_node_fs_namespaceObject.mkdirSync(targetNpmrcFolder, { recursive: true });
-            }
-            return _copyAndTrimNpmrcFile({
-                sourceNpmrcPath,
-                targetNpmrcPath,
-                logger,
-                ...options
-            });
-        }
-        else if (external_node_fs_namespaceObject.existsSync(targetNpmrcPath)) {
-            // If the source .npmrc doesn't exist and there is one in the target, delete the one in the target
-            logger.info(`Deleting ${targetNpmrcPath}`); // Verbose
-            external_node_fs_namespaceObject.unlinkSync(targetNpmrcPath);
-        }
-    }
-    catch (e) {
-        throw new Error(`Error syncing .npmrc file: ${e}`);
-    }
-}
-function isVariableSetInNpmrcFile(sourceNpmrcFolder, variableKey, supportEnvVarFallbackSyntax) {
-    const sourceNpmrcPath = `${sourceNpmrcFolder}/.npmrc`;
-    //if .npmrc file does not exist, return false directly
-    if (!fs.existsSync(sourceNpmrcPath)) {
-        return false;
-    }
-    const trimmedNpmrcFile = _trimNpmrcFile({ sourceNpmrcPath, supportEnvVarFallbackSyntax });
-    const variableKeyRegExp = new RegExp(`^${variableKey}=`, 'm');
-    return trimmedNpmrcFile.match(variableKeyRegExp) !== null;
-}
-//# sourceMappingURL=npmrcUtilities.js.map
+;// external "node:os"
+const external_node_os_namespaceObject = require("node:os");
 // EXTERNAL MODULE: ../../common/temp/default/node_modules/.pnpm/true-case-path@2.2.1/node_modules/true-case-path/index.js
 var true_case_path = __webpack_require__("../../common/temp/default/node_modules/.pnpm/true-case-path@2.2.1/node_modules/true-case-path/index.js");
 ;// ../rush-lib/lib-esnext/api/EnvironmentConfiguration.js
@@ -891,852 +720,6 @@ EnvironmentConfiguration._absoluteSymlinks = false;
 EnvironmentConfiguration._allowUnsupportedNodeVersion = false;
 EnvironmentConfiguration._allowWarningsInSuccessfulBuild = false;
 //# sourceMappingURL=EnvironmentConfiguration.js.map
-;// ../rush-lib/lib-esnext/logic/RushConstants.js
-// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
-// See LICENSE in the project root for license information.
-/**
- * Constants used by the Rush tool.
- * @beta
- *
- * @remarks
- *
- * These are NOT part of the public API surface for rush-lib.
- * The rationale is that we don't want people implementing custom parsers for
- * the Rush config files; instead, they should rely on the official APIs from rush-lib.
- */
-class RushConstants {
-}
-/**
- * The filename ("rush.json") for the root-level configuration file.
- */
-RushConstants.rushJsonFilename = 'rush.json';
-/**
- * The filename ("browser-approved-packages.json") for an optional policy configuration file
- * that stores a list of NPM packages that have been approved for usage by Rush projects.
- * This is part of a pair of config files, one for projects that run in a web browser
- * (e.g. whose approval criteria mostly focuses on licensing and code size), and one for everywhere else
- * (e.g. tooling projects whose approval criteria mostly focuses on avoiding node_modules sprawl).
- */
-RushConstants.browserApprovedPackagesFilename = 'browser-approved-packages.json';
-/**
- * The folder name ("changes") where change files will be stored.
- */
-RushConstants.changeFilesFolderName = 'changes';
-/**
- * The filename ("nonbrowser-approved-packages.json") for an optional policy configuration file
- * that stores a list of NPM packages that have been approved for usage by Rush projects.
- * This is part of a pair of config files, one for projects that run in a web browser
- * (e.g. whose approval criteria mostly focuses on licensing and code size), and one for everywhere else
- * (e.g. tooling projects whose approval criteria mostly focuses on avoiding node_modules sprawl).
- */
-RushConstants.nonbrowserApprovedPackagesFilename = 'nonbrowser-approved-packages.json';
-/**
- * The folder name ("common") where Rush's common data will be stored.
- */
-RushConstants.commonFolderName = 'common';
-/**
- * The NPM scope ("\@rush-temp") that is used for Rush's temporary projects.
- */
-RushConstants.rushTempNpmScope = '@rush-temp';
-/**
- * The folder name ("variants") under which named variant configurations for
- * alternate dependency sets may be found.
- * Example: `C:\MyRepo\common\config\rush\variants`
- */
-RushConstants.rushVariantsFolderName = 'variants';
-/**
- * The folder name ("temp") under the common folder, or under the .rush folder in each project's directory where
- * temporary files will be stored.
- * Example: `C:\MyRepo\common\temp`
- */
-RushConstants.rushTempFolderName = 'temp';
-/**
- * The folder name ("projects") where temporary projects will be stored.
- * Example: `C:\MyRepo\common\temp\projects`
- */
-RushConstants.rushTempProjectsFolderName = 'projects';
-/**
- * The filename ("npm-shrinkwrap.json") used to store an installation plan for the NPM package manger.
- */
-RushConstants.npmShrinkwrapFilename = 'npm-shrinkwrap.json';
-/**
- * Number of installation attempts
- */
-RushConstants.defaultMaxInstallAttempts = 1;
-/**
- * The filename ("pnpm-lock.yaml") used to store an installation plan for the PNPM package manger
- * (PNPM version 3.x and later).
- */
-RushConstants.pnpmV3ShrinkwrapFilename = 'pnpm-lock.yaml';
-/**
- * The filename ("pnpmfile.js") used to add custom configuration to PNPM (PNPM version 1.x and later).
- */
-RushConstants.pnpmfileV1Filename = 'pnpmfile.js';
-/**
- * The filename (".pnpmfile.cjs") used to add custom configuration to PNPM (PNPM version 6.x and later).
- */
-RushConstants.pnpmfileV6Filename = '.pnpmfile.cjs';
-/**
- * The filename (".modules.yaml") used by pnpm to specify configurations in the node_modules directory
- */
-RushConstants.pnpmModulesFilename = '.modules.yaml';
-/**
- * The folder name (".pnpm") used by pnpm to store the code of the dependencies for this subspace
- */
-RushConstants.pnpmVirtualStoreFolderName = '.pnpm';
-/**
- * The filename ("global-pnpmfile.cjs") used to add custom configuration to subspaces
- */
-RushConstants.pnpmfileGlobalFilename = 'global-pnpmfile.cjs';
-/**
- * The folder name used to store patch files for pnpm
- * Example: `C:\MyRepo\common\config\pnpm-patches`
- * Example: `C:\MyRepo\common\temp\patches`
- */
-RushConstants.pnpmPatchesFolderName = 'patches';
-/**
- * The folder name under `/common/temp` used to store checked-in patches.
- * Example: `C:\MyRepo\common\pnpm-patches`
- */
-RushConstants.pnpmPatchesCommonFolderName = `pnpm-${RushConstants.pnpmPatchesFolderName}`;
-/**
- * The filename ("shrinkwrap.yaml") used to store state for pnpm
- */
-RushConstants.yarnShrinkwrapFilename = 'yarn.lock';
-/**
- * The folder name ("node_modules") where NPM installs its packages.
- */
-RushConstants.nodeModulesFolderName = 'node_modules';
-/**
- * The filename ("pinned-versions.json") for an old configuration file that
- * that is no longer supported.
- *
- * @deprecated This feature has been superseded by the "preferredVersions" setting
- * in common-versions.json
- */
-// NOTE: Although this is marked as "deprecated", we will probably never retire it,
-// since we always want to report the warning when someone upgrades an old repo.
-RushConstants.pinnedVersionsFilename = 'pinned-versions.json';
-/**
- * The filename ("common-versions.json") for an optional configuration file
- * that stores dependency version information that affects all projects in the repo.
- * This configuration file should go in the "common/config/rush" folder.
- */
-RushConstants.commonVersionsFilename = 'common-versions.json';
-/**
- * The filename ("repo-state.json") for a file used by Rush to
- * store the state of various features as they stand in the repo.
- */
-RushConstants.repoStateFilename = 'repo-state.json';
-/**
- * The filename ("custom-tips.json") for the file used by Rush to
- * print user-customized messages.
- * This configuration file should go in the "common/config/rush" folder.
- */
-RushConstants.customTipsFilename = 'custom-tips.json';
-/**
- * The name of the per-project folder where project-specific Rush files are stored. For example,
- * the package-deps files, which are used by commands to determine if a particular project needs to be rebuilt.
- */
-RushConstants.projectRushFolderName = '.rush';
-/**
- * Custom command line configuration file, which is used by rush for implementing
- * custom command and options.
- */
-RushConstants.commandLineFilename = 'command-line.json';
-RushConstants.versionPoliciesFilename = 'version-policies.json';
-/**
- * Experiments configuration file.
- */
-RushConstants.experimentsFilename = 'experiments.json';
-/**
- * Pnpm configuration file
- */
-RushConstants.pnpmConfigFilename = 'pnpm-config.json';
-/**
- * Rush plugins configuration file name.
- */
-RushConstants.rushPluginsConfigFilename = 'rush-plugins.json';
-/**
- * Rush plugin manifest file name.
- */
-RushConstants.rushPluginManifestFilename = 'rush-plugin-manifest.json';
-/**
- * The artifactory.json configuration file name.
- */
-RushConstants.artifactoryFilename = 'artifactory.json';
-/**
- * The subspaces.json configuration file name
- */
-RushConstants.subspacesConfigFilename = 'subspaces.json';
-/**
- * The name of the default subspace if one isn't specified but subspaces is enabled.
- */
-RushConstants.defaultSubspaceName = 'default';
-/**
- * Build cache configuration file.
- */
-RushConstants.buildCacheFilename = 'build-cache.json';
-/**
- * Build cache version number, incremented when the logic to create cache entries changes.
- * Changing this ensures that cache entries generated by an old version will no longer register as a cache hit.
- */
-RushConstants.buildCacheVersion = 1;
-/**
- * Cobuild configuration file.
- */
-RushConstants.cobuildFilename = 'cobuild.json';
-/**
- * Per-project configuration filename.
- */
-RushConstants.rushProjectConfigFilename = 'rush-project.json';
-/**
- * The URL ("http://rushjs.io") for the Rush web site.
- */
-RushConstants.rushWebSiteUrl = 'https://rushjs.io';
-/**
- * The name of the NPM package for the Rush tool ("\@microsoft/rush").
- */
-RushConstants.rushPackageName = '@microsoft/rush';
-/**
- * The folder name ("rush-recycler") where Rush moves large folder trees
- * before asynchronously deleting them.
- */
-RushConstants.rushRecyclerFolderName = 'rush-recycler';
-/**
- * The name of the file to drop in project-folder/.rush/temp/ containing a listing of the project's direct
- * and indirect dependencies. This is used to detect if a project's dependencies have changed since the last build.
- */
-RushConstants.projectShrinkwrapFilename = 'shrinkwrap-deps.json';
-/**
- * The value of the "commandKind" property for a bulk command in command-line.json
- */
-RushConstants.bulkCommandKind = 'bulk';
-/**
- * The value of the "commandKind" property for a global command in command-line.json
- */
-RushConstants.globalCommandKind = 'global';
-/**
- * The value of the "commandKind" property for a phased command in command-line.json
- */
-RushConstants.phasedCommandKind = 'phased';
-/**
- * The name of the incremental build command.
- */
-RushConstants.buildCommandName = 'build';
-/**
- * The name of the non-incremental build command.
- */
-RushConstants.rebuildCommandName = 'rebuild';
-RushConstants.updateCloudCredentialsCommandName = 'update-cloud-credentials';
-/**
- * When a hash generated that contains multiple input segments, this character may be used
- * to separate them to avoid issues like
- * crypto.createHash('sha1').update('a').update('bc').digest('hex') === crypto.createHash('sha1').update('ab').update('c').digest('hex')
- */
-RushConstants.hashDelimiter = '|';
-/**
- * The name of the per-user Rush configuration data folder.
- */
-RushConstants.rushUserConfigurationFolderName = '.rush-user';
-/**
- * The name of the project `rush-logs` folder.
- */
-RushConstants.rushLogsFolderName = 'rush-logs';
-/**
- * The expected prefix for phase names in "common/config/rush/command-line.json"
- */
-RushConstants.phaseNamePrefix = '_phase:';
-/**
- * The default debounce value for Rush multi-project watch mode. When watching, controls
- * how long to wait after the last encountered file system event before execution. If another
- * file system event occurs in this interval, the timeout will reset.
- */
-RushConstants.defaultWatchDebounceMs = 1000;
-/**
- * The name of the parameter that can be used to bypass policies.
- */
-RushConstants.bypassPolicyFlagLongName = '--bypass-policy';
-/**
- * Merge Queue ignore configuration file.
- */
-RushConstants.mergeQueueIgnoreFileName = '.mergequeueignore';
-/**
- * The filename ("project-impact-graph.yaml") for the project impact graph file.
- */
-RushConstants.projectImpactGraphFilename = 'project-impact-graph.yaml';
-/**
- * The filename for the last link flag
- */
-RushConstants.lastLinkFlagFilename = 'last-link';
-/**
- * The filename for the Rush alerts config file.
- */
-RushConstants.rushAlertsConfigFilename = 'rush-alerts.json';
-/**
- * The filename for the file that tracks which variant is currently installed.
- */
-RushConstants.currentVariantsFilename = 'current-variants.json';
-/**
- * The filename ("rush-hotlink-state.json") used to store information about packages connected via
- * "rush link-package" and "rush bridge-package" commands.
- */
-RushConstants.rushHotlinkStateFilename = 'rush-hotlink-state.json';
-/**
- * The filename ("pnpm-sync.json") used to store the state of the pnpm sync command.
- */
-RushConstants.pnpmSyncFilename = '.pnpm-sync.json';
-//# sourceMappingURL=RushConstants.js.map
-;// ../rush-lib/lib-esnext/utilities/Utilities.js
-// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
-// See LICENSE in the project root for license information.
-
-
-
-
-
-
-
-
-
-// eslint-disable-next-line @typescript-eslint/no-redeclare
-const UNINITIALIZED = 'UNINITIALIZED';
-class Utilities {
-    /**
-     * Get the user's home directory. On windows this looks something like "C:\users\username\" and on UNIX
-     * this looks something like "/home/username/"
-     */
-    static getHomeFolder() {
-        let homeFolder = Utilities._homeFolder;
-        if (!homeFolder) {
-            const unresolvedUserFolder = process.env[process.platform === 'win32' ? 'USERPROFILE' : 'HOME'];
-            const dirError = "Unable to determine the current user's home directory";
-            if (unresolvedUserFolder === undefined) {
-                throw new Error(dirError);
-            }
-            homeFolder = external_node_path_.resolve(unresolvedUserFolder);
-            if (!node_core_library_.FileSystem.exists(homeFolder)) {
-                throw new Error(dirError);
-            }
-            Utilities._homeFolder = homeFolder;
-        }
-        return homeFolder;
-    }
-    /**
-     * Node.js equivalent of performance.now().
-     */
-    static getTimeInMs() {
-        return external_node_perf_hooks_namespaceObject.performance.now();
-    }
-    /**
-     * Retries a function until a timeout is reached. The function is expected to throw if it failed and
-     *  should be retried.
-     */
-    static retryUntilTimeout(fn, maxWaitTimeMs, getTimeoutError, fnName) {
-        const startTime = Utilities.getTimeInMs();
-        let looped = false;
-        let result;
-        for (;;) {
-            try {
-                result = fn();
-                break;
-            }
-            catch (e) {
-                looped = true;
-                const currentTime = Utilities.getTimeInMs();
-                if (currentTime - startTime > maxWaitTimeMs) {
-                    throw getTimeoutError(e);
-                }
-            }
-        }
-        if (looped) {
-            const currentTime = Utilities.getTimeInMs();
-            const totalSeconds = ((currentTime - startTime) / 1000.0).toFixed(2);
-            // This logging statement isn't meaningful to the end-user. `fnName` should be updated
-            // to something like `operationDescription`
-            // eslint-disable-next-line no-console
-            console.log(`${fnName}() stalled for ${totalSeconds} seconds`);
-        }
-        return result;
-    }
-    /**
-     * Creates the specified folder by calling FileSystem.ensureFolder(), but using a
-     * retry loop to recover from temporary locks that may be held by other processes.
-     * If the folder already exists, no error occurs.
-     */
-    static createFolderWithRetry(folderName) {
-        // Note: If a file exists with the same name, then we fall through and report
-        // an error.
-        if (Utilities.directoryExists(folderName)) {
-            return;
-        }
-        // We need to do a simple "FileSystem.ensureFolder(localModulesFolder)" here,
-        // however if the folder we deleted above happened to contain any files,
-        // then there seems to be some OS process (virus scanner?) that holds
-        // a lock on the folder for a split second, which causes mkdirSync to
-        // fail.  To workaround that, retry for up to 7 seconds before giving up.
-        const maxWaitTimeMs = 7 * 1000;
-        return Utilities.retryUntilTimeout(() => node_core_library_.FileSystem.ensureFolder(folderName), maxWaitTimeMs, (e) => new Error(`Error: ${e}\nOften this is caused by a file lock ` +
-            'from a process such as your text editor, command prompt, ' +
-            'or a filesystem watcher.'), 'createFolderWithRetry');
-    }
-    /**
-     * Determines if a path points to a directory and that it exists.
-     */
-    static directoryExists(directoryPath) {
-        let exists = false;
-        try {
-            const lstat = node_core_library_.FileSystem.getLinkStatistics(directoryPath);
-            exists = lstat.isDirectory();
-        }
-        catch (e) {
-            /* no-op */
-        }
-        return exists;
-    }
-    /**
-     * BE VERY CAREFUL CALLING THIS FUNCTION!
-     * If you specify the wrong folderPath (e.g. "/"), it could potentially delete your entire
-     * hard disk.
-     */
-    static dangerouslyDeletePath(folderPath) {
-        try {
-            node_core_library_.FileSystem.deleteFolder(folderPath);
-        }
-        catch (e) {
-            throw new Error(`${e.message}\nOften this is caused by a file lock from a process ` +
-                'such as your text editor, command prompt, or a filesystem watcher');
-        }
-    }
-    /*
-     * Returns true if dateToCompare is more recent than all of the inputFilenames, which
-     * would imply that we don't need to rebuild it. Returns false if any of the files
-     * does not exist.
-     * NOTE: The filenames can also be paths for directories, in which case the directory
-     * timestamp is compared.
-     */
-    static async isFileTimestampCurrentAsync(dateToCompare, inputFilePaths) {
-        let anyAreOutOfDate = false;
-        await node_core_library_.Async.forEachAsync(inputFilePaths, async (filePath) => {
-            if (!anyAreOutOfDate) {
-                let inputStats;
-                try {
-                    inputStats = await node_core_library_.FileSystem.getStatisticsAsync(filePath);
-                }
-                catch (e) {
-                    if (node_core_library_.FileSystem.isNotExistError(e)) {
-                        // eslint-disable-next-line require-atomic-updates
-                        anyAreOutOfDate = true;
-                    }
-                    else {
-                        throw e;
-                    }
-                }
-                if (inputStats && dateToCompare < inputStats.mtime) {
-                    // eslint-disable-next-line require-atomic-updates
-                    anyAreOutOfDate = true;
-                }
-            }
-        }, { concurrency: 10 });
-        return !anyAreOutOfDate;
-    }
-    /**
-     * Executes the command with the specified command-line parameters, and waits for it to complete.
-     * The current directory will be set to the specified workingDirectory.
-     */
-    static async executeCommandAsync({ command, args, workingDirectory, suppressOutput, onStdoutStreamChunk, environment, keepEnvironment, captureExitCodeAndSignal }) {
-        const { exitCode, signal } = await Utilities._executeCommandInternalAsync({
-            command,
-            args,
-            workingDirectory,
-            stdio: onStdoutStreamChunk
-                ? // Inherit the stdin and stderr streams, but pipe the stdout stream, which will then be piped
-                    // to the process's stdout after being intercepted by the onStdoutStreamChunk callback.
-                    ['inherit', 'pipe', 'inherit']
-                : suppressOutput
-                    ? // If the output is being suppressed, create pipes for all streams to prevent the child process
-                        // from printing to the parent process's (this process's) stdout/stderr, but allow the stdout and
-                        // stderr to be inspected if an error occurs.
-                        // TODO: Consider ignoring stdout and stdin and only piping stderr for inspection on error.
-                        ['pipe', 'pipe', 'pipe']
-                    : // If the output is not being suppressed or intercepted, inherit all streams from the parent process.
-                        ['inherit', 'inherit', 'inherit'],
-            environment,
-            keepEnvironment,
-            onStdoutStreamChunk,
-            captureOutput: false,
-            captureExitCodeAndSignal
-        });
-        if (captureExitCodeAndSignal) {
-            return { exitCode, signal };
-        }
-    }
-    /**
-     * Executes the command with the specified command-line parameters, and waits for it to complete.
-     * The current directory will be set to the specified workingDirectory.
-     */
-    static async executeCommandAndCaptureOutputAsync(command, args, workingDirectory, environment, keepEnvironment = false) {
-        const { stdout } = await Utilities._executeCommandInternalAsync({
-            command,
-            args,
-            workingDirectory,
-            stdio: ['pipe', 'pipe', 'pipe'],
-            environment,
-            keepEnvironment,
-            captureOutput: true
-        });
-        return stdout;
-    }
-    /**
-     * Attempts to run Utilities.executeCommand() up to maxAttempts times before giving up.
-     */
-    static async executeCommandWithRetryAsync(options, maxAttempts, retryCallback) {
-        if (maxAttempts < 1) {
-            throw new Error('The maxAttempts parameter cannot be less than 1');
-        }
-        let attemptNumber = 1;
-        for (;;) {
-            try {
-                await Utilities.executeCommandAsync(options);
-            }
-            catch (error) {
-                // eslint-disable-next-line no-console
-                console.log('\nThe command failed:');
-                const { command, args } = options;
-                // eslint-disable-next-line no-console
-                console.log(` ${command} ` + args.join(' '));
-                // eslint-disable-next-line no-console
-                console.log(`ERROR: ${error.toString()}`);
-                if (attemptNumber < maxAttempts) {
-                    ++attemptNumber;
-                    // eslint-disable-next-line no-console
-                    console.log(`Trying again (attempt #${attemptNumber})...\n`);
-                    if (retryCallback) {
-                        retryCallback();
-                    }
-                    continue;
-                }
-                else {
-                    // eslint-disable-next-line no-console
-                    console.error(`Giving up after ${attemptNumber} attempts\n`);
-                    throw error;
-                }
-            }
-            break;
-        }
-    }
-    /**
-     * Executes the command using cmd if running on windows, or using sh if running on a non-windows OS.
-     * @param command - the command to run on shell
-     * @param options - options for how the command should be run
-     */
-    static executeLifecycleCommand(command, options) {
-        const result = Utilities._executeLifecycleCommandInternal(command, external_node_child_process_namespaceObject.spawnSync, options);
-        if (options.handleOutput) {
-            Utilities._processResult({
-                error: result.error,
-                status: result.status,
-                stderr: result.stderr.toString()
-            });
-        }
-        if (result.status !== null) {
-            return result.status;
-        }
-        else {
-            throw result.error || new Error('An unknown error occurred.');
-        }
-    }
-    /**
-     * Executes the command using cmd if running on windows, or using sh if running on a non-windows OS.
-     * @param command - the command to run on shell
-     * @param options - options for how the command should be run
-     */
-    static executeLifecycleCommandAsync(command, options) {
-        const child = Utilities._executeLifecycleCommandInternal(command, external_node_child_process_namespaceObject.spawn, options);
-        if (options.connectSubprocessTerminator) {
-            node_core_library_.SubprocessTerminator.killProcessTreeOnExit(child, node_core_library_.SubprocessTerminator.RECOMMENDED_OPTIONS);
-        }
-        return child;
-    }
-    /**
-     * For strings passed to a shell command, this adds appropriate escaping
-     * to avoid misinterpretation of spaces or special characters.
-     *
-     * Example: 'hello there' --> '"hello there"'
-     */
-    static escapeShellParameter(parameter) {
-        // This approach is based on what NPM 7 now does:
-        // https://github.com/npm/run-script/blob/47a4d539fb07220e7215cc0e482683b76407ef9b/lib/run-script-pkg.js#L34
-        return JSON.stringify(parameter);
-    }
-    /**
-     * Installs a package by name and version in the specified directory.
-     */
-    static async installPackageInDirectoryAsync({ packageName, version, tempPackageTitle, commonRushConfigFolder, maxInstallAttempts, suppressOutput, directory }) {
-        directory = external_node_path_.resolve(directory);
-        const directoryExists = await node_core_library_.FileSystem.existsAsync(directory);
-        if (directoryExists) {
-            // eslint-disable-next-line no-console
-            console.log('Deleting old files from ' + directory);
-        }
-        await node_core_library_.FileSystem.ensureEmptyFolderAsync(directory);
-        const npmPackageJson = {
-            dependencies: {
-                [packageName]: version
-            },
-            description: 'Temporary file generated by the Rush tool',
-            name: tempPackageTitle,
-            private: true,
-            version: '0.0.0'
-        };
-        await node_core_library_.JsonFile.saveAsync(npmPackageJson, external_node_path_.join(directory, node_core_library_.FileConstants.PackageJson));
-        if (commonRushConfigFolder) {
-            Utilities.syncNpmrc({
-                sourceNpmrcFolder: commonRushConfigFolder,
-                targetNpmrcFolder: directory,
-                supportEnvVarFallbackSyntax: false
-            });
-        }
-        // eslint-disable-next-line no-console
-        console.log('\nRunning "npm install" in ' + directory);
-        // NOTE: Here we use whatever version of NPM we happen to find in the PATH
-        await Utilities.executeCommandWithRetryAsync({
-            command: 'npm',
-            args: ['install'],
-            workingDirectory: directory,
-            environment: Utilities._createEnvironmentForRushCommand({}),
-            suppressOutput
-        }, maxInstallAttempts);
-    }
-    /**
-     * Copies the file "sourcePath" to "destinationPath", overwriting the target file location.
-     * If the source file does not exist, then the target file is deleted.
-     */
-    static syncFile(sourcePath, destinationPath) {
-        if (node_core_library_.FileSystem.exists(sourcePath)) {
-            // eslint-disable-next-line no-console
-            console.log(`Copying "${sourcePath}"`);
-            // eslint-disable-next-line no-console
-            console.log(`  --> "${destinationPath}"`);
-            node_core_library_.FileSystem.copyFile({ sourcePath, destinationPath });
-        }
-        else {
-            if (node_core_library_.FileSystem.exists(destinationPath)) {
-                // If the source file doesn't exist and there is one in the target, delete the one in the target
-                // eslint-disable-next-line no-console
-                console.log(`Deleting ${destinationPath}`);
-                node_core_library_.FileSystem.deleteFile(destinationPath);
-            }
-        }
-    }
-    static getRushConfigNotFoundError() {
-        return new Error(`Unable to find ${RushConstants.rushJsonFilename} configuration file`);
-    }
-    static async usingAsync(getDisposableAsync, doActionAsync) {
-        let disposable;
-        try {
-            disposable = (await getDisposableAsync());
-            await doActionAsync(disposable);
-        }
-        finally {
-            disposable === null || disposable === void 0 ? void 0 : disposable.dispose();
-        }
-    }
-    static trimAfterLastSlash(filePath) {
-        const indexOfLastSlash = Math.max(filePath.lastIndexOf('/'), filePath.lastIndexOf('\\'));
-        if (indexOfLastSlash < 0) {
-            return filePath;
-        }
-        return filePath.substring(0, indexOfLastSlash);
-    }
-    /**
-     * If the path refers to a symlink, `FileSystem.exists()` would normally test whether the symlink
-     * points to a target that exists. By contrast, `existsOrIsBrokenSymlink()` will return true even if
-     * the symlink exists but its target does not. */
-    static existsOrIsSymlink(linkPath) {
-        try {
-            node_core_library_.FileSystem.getLinkStatistics(linkPath);
-            return true;
-        }
-        catch (err) {
-            return false;
-        }
-    }
-    static _executeLifecycleCommandInternal(command, spawnFunction, options) {
-        var _a;
-        let shellCommand = process.env.comspec || 'cmd';
-        let commandFlags = '/d /s /c';
-        let useShell = true;
-        if (process.platform !== 'win32') {
-            shellCommand = 'sh';
-            commandFlags = '-c';
-            useShell = false;
-        }
-        const environment = Utilities._createEnvironmentForRushCommand({
-            initCwd: options.initCwd,
-            initialEnvironment: options.initialEnvironment,
-            pathOptions: {
-                ...options.environmentPathOptions,
-                rushJsonFolder: (_a = options.rushConfiguration) === null || _a === void 0 ? void 0 : _a.rushJsonFolder,
-                projectRoot: options.workingDirectory,
-                commonTempFolder: options.rushConfiguration ? options.rushConfiguration.commonTempFolder : undefined
-            }
-        });
-        const stdio = options.handleOutput ? ['pipe', 'pipe', 'pipe'] : [0, 1, 2];
-        if (options.ipc) {
-            stdio.push('ipc');
-        }
-        const spawnOptions = {
-            cwd: options.workingDirectory,
-            shell: useShell,
-            env: environment,
-            stdio
-        };
-        if (options.connectSubprocessTerminator) {
-            Object.assign(spawnOptions, node_core_library_.SubprocessTerminator.RECOMMENDED_OPTIONS);
-        }
-        return spawnFunction(shellCommand, [commandFlags, command], spawnOptions);
-    }
-    /**
-     * Returns a process.env environment suitable for executing lifecycle scripts.
-     * @param initialEnvironment - an existing environment to copy instead of process.env
-     *
-     * @remarks
-     * Rush._assignRushInvokedFolder() assigns the `RUSH_INVOKED_FOLDER` variable globally
-     * via the parent process's environment.
-     */
-    static _createEnvironmentForRushCommand(options) {
-        var _a;
-        if (options.initialEnvironment === undefined) {
-            options.initialEnvironment = process.env;
-        }
-        // Set some defaults for the environment
-        const environment = {};
-        if ((_a = options.pathOptions) === null || _a === void 0 ? void 0 : _a.rushJsonFolder) {
-            environment.RUSHSTACK_FILE_ERROR_BASE_FOLDER = options.pathOptions.rushJsonFolder;
-        }
-        for (const key of Object.getOwnPropertyNames(options.initialEnvironment)) {
-            const normalizedKey = external_node_os_namespaceObject.platform() === 'win32' ? key.toUpperCase() : key;
-            // If Rush itself was invoked inside a lifecycle script, this may be set and would interfere
-            // with Rush's installations.  If we actually want it, we will set it explicitly below.
-            if (normalizedKey === 'INIT_CWD') {
-                continue;
-            }
-            // When NPM invokes a lifecycle event, it copies its entire configuration into environment
-            // variables.  Rush is supposed to be a deterministic controlled environment, so don't bring
-            // this along.
-            //
-            // NOTE: Longer term we should clean out the entire environment and use rush.json to bring
-            // back specific environment variables that the repo maintainer has determined to be safe.
-            if (normalizedKey.match(/^NPM_CONFIG_/)) {
-                continue;
-            }
-            // Use the uppercased environment variable name on Windows because environment variable names
-            // are case-insensitive on Windows
-            environment[normalizedKey] = options.initialEnvironment[key];
-        }
-        // When NPM invokes a lifecycle script, it sets an environment variable INIT_CWD that remembers
-        // the directory that NPM started in.  This allows naive scripts to change their current working directory
-        // and invoke NPM operations, while still be able to find a local .npmrc file.  Although Rush recommends
-        // for toolchain scripts to be professionally written (versus brittle stuff like
-        // "cd ./lib && npm run tsc && cd .."), we support INIT_CWD for compatibility.
-        //
-        // More about this feature: https://github.com/npm/npm/pull/12356
-        if (options.initCwd) {
-            environment['INIT_CWD'] = options.initCwd; // eslint-disable-line dot-notation
-        }
-        if (options.pathOptions) {
-            if (options.pathOptions.includeRepoBin && options.pathOptions.commonTempFolder) {
-                environment.PATH = Utilities._prependNodeModulesBinToPath(environment.PATH, options.pathOptions.commonTempFolder);
-            }
-            if (options.pathOptions.includeProjectBin && options.pathOptions.projectRoot) {
-                environment.PATH = Utilities._prependNodeModulesBinToPath(environment.PATH, options.pathOptions.projectRoot);
-            }
-            if (options.pathOptions.additionalPathFolders) {
-                environment.PATH = [...options.pathOptions.additionalPathFolders, environment.PATH].join(external_node_path_.delimiter);
-            }
-        }
-        // Communicate to downstream calls that they should not try to run hooks
-        environment[EnvironmentVariableNames._RUSH_RECURSIVE_RUSHX_CALL] = '1';
-        return environment;
-    }
-    /**
-     * Prepend the node_modules/.bin folder under the specified folder to the specified PATH variable. For example,
-     * if `rootDirectory` is "/foobar" and `existingPath` is "/bin", this function will return
-     * "/foobar/node_modules/.bin:/bin"
-     */
-    static _prependNodeModulesBinToPath(existingPath, rootDirectory) {
-        const binPath = external_node_path_.resolve(rootDirectory, 'node_modules', '.bin');
-        if (existingPath) {
-            return `${binPath}${external_node_path_.delimiter}${existingPath}`;
-        }
-        else {
-            return binPath;
-        }
-    }
-    /**
-     * Executes the command with the specified command-line parameters, and waits for it to complete.
-     * The current directory will be set to the specified workingDirectory.
-     */
-    static async _executeCommandInternalAsync({ command, args, workingDirectory, stdio, environment, keepEnvironment, onStdoutStreamChunk, captureOutput, captureExitCodeAndSignal }) {
-        var _a;
-        const options = {
-            cwd: workingDirectory,
-            shell: true,
-            stdio: stdio,
-            env: keepEnvironment
-                ? environment
-                : Utilities._createEnvironmentForRushCommand({ initialEnvironment: environment }),
-            maxBuffer: 10 * 1024 * 1024 // Set default max buffer size to 10MB
-        };
-        // This is needed since we specify shell=true below.
-        // NOTE: On Windows if we escape "NPM", the spawnSync() function runs something like this:
-        //   [ 'C:\\Windows\\system32\\cmd.exe', '/s', '/c', '""NPM" "install""' ]
-        //
-        // Due to a bug with Windows cmd.exe, the npm.cmd batch file's "%~dp0" variable will
-        // return the current working directory instead of the batch file's directory.
-        // The workaround is to not escape, npm, i.e. do this instead:
-        //   [ 'C:\\Windows\\system32\\cmd.exe', '/s', '/c', '"npm "install""' ]
-        //
-        // We will come up with a better solution for this when we promote executeCommand()
-        // into node-core-library, but for now this hack will unblock people:
-        // Only escape the command if it actually contains spaces:
-        const escapedCommand = command.indexOf(' ') < 0 ? command : Utilities.escapeShellParameter(command);
-        const escapedArgs = args.map((x) => Utilities.escapeShellParameter(x));
-        const childProcess = external_node_child_process_namespaceObject.spawn(escapedCommand, escapedArgs, options);
-        if (onStdoutStreamChunk) {
-            const inspectStream = new external_node_stream_namespaceObject.Transform({
-                transform: onStdoutStreamChunk
-                    ? (chunk, encoding, callback) => {
-                        const chunkString = chunk.toString();
-                        const updatedChunk = onStdoutStreamChunk(chunkString);
-                        callback(undefined, updatedChunk !== null && updatedChunk !== void 0 ? updatedChunk : chunk);
-                    }
-                    : undefined
-            });
-            (_a = childProcess.stdout) === null || _a === void 0 ? void 0 : _a.pipe(inspectStream).pipe(process.stdout);
-        }
-        return await node_core_library_.Executable.waitForExitAsync(childProcess, {
-            encoding: captureOutput ? 'utf8' : undefined,
-            throwOnNonZeroExitCode: !captureExitCodeAndSignal,
-            throwOnSignal: !captureExitCodeAndSignal
-        });
-    }
-    static _processResult({ error, stderr, status }) {
-        if (error) {
-            error.message += `\n${stderr}`;
-            if (status) {
-                error.message += `\nExited with status ${status}`;
-            }
-            throw error;
-        }
-        if (status) {
-            throw new Error(`The command failed with exit code ${status}\n${stderr}`);
-        }
-    }
-}
-Utilities.syncNpmrc = syncNpmrc;
-//# sourceMappingURL=Utilities.js.map
 ;// ../rush-lib/lib-esnext/api/RushGlobalFolder.js
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
@@ -1757,7 +740,7 @@ class RushGlobalFolder {
             this.path = rushGlobalFolderOverride;
         }
         else {
-            this.path = external_node_path_.join(Utilities.getHomeFolder(), '.rush');
+            this.path = external_node_path_.join(node_core_library_.User.getHomeFolder(), '.rush');
         }
         const normalizedNodeVersion = process.version.match(/^[a-z0-9\-\.]+$/i)
             ? process.version