@rushstack/rush-sdk 5.90.2-pr3954.0 → 5.90.2-pr3964.0

package/README.md

@@ -1,64 +1,29 @@
 ## @rushstack/rush-sdk
 
-This is a companion package for the Rush tool. See the [@microsoft/rush](https://www.npmjs.com/package/@microsoft/rush) package for details.
+This is a companion package for the Rush tool.  See the [@microsoft/rush](https://www.npmjs.com/package/@microsoft/rush) package for details.
 
-⚠ **_THIS PACKAGE IS EXPERIMENTAL_** ⚠
+⚠ ***THIS PACKAGE IS EXPERIMENTAL*** ⚠
 
-The **@rushstack/rush-sdk** package acts as a lightweight proxy for accessing the APIs of the **@microsoft/rush-lib** engine. It is intended to support three different use cases:
+The **@rushstack/rush-sdk** package acts as a lightweight proxy for accessing the APIs of the **@microsoft/rush-lib** engine.  It is intended to support three different use cases:
 
-1. Rush plugins should import from **@rushstack/rush-sdk** instead of **@microsoft/rush-lib**. This gives plugins full access to Rush APIs while avoiding a redundant installation of those packages. At runtime, the APIs will be bound to the correct `rushVersion` from **rush.json**, and guaranteed to be the same **@microsoft/rush-lib** module instance as the plugin host.
+1. Rush plugins should import from **@rushstack/rush-sdk** instead of **@microsoft/rush-lib**.  This gives plugins full access to Rush APIs while avoiding a redundant installation of those packages.  At runtime, the APIs will be bound to the correct `rushVersion` from **rush.json**, and guaranteed to be the same **@microsoft/rush-lib** module instance as the plugin host.
 
-2. When authoring unit tests for a Rush plugin, developers should add **@microsoft/rush-lib** to their **package.json** `devDependencies`. In this context, **@rushstack/rush-sdk** will resolve to that instance for testing purposes.
+2. When authoring unit tests for a Rush plugin, developers should add **@microsoft/rush-lib** to their **package.json** `devDependencies`.  In this context, **@rushstack/rush-sdk** will resolve to that instance for testing purposes.
 
-3. For scripts and tools that are designed to be used in a Rush monorepo, in the future **@rushstack/rush-sdk** will automatically invoke **install-run-rush.js** and load the local installation. This ensures that tools load a compatible version of the Rush engine for the given branch. Once this is implemented, **@rushstack/rush-sdk** can replace **@microsoft/rush-lib** entirely as the official API interface, with the latter serving as the underlying implementation.
+3. For scripts and tools that are designed to be used in a Rush monorepo, in the future **@rushstack/rush-sdk** will automatically invoke **install-run-rush.js** and load the local installation.  This ensures that tools load a compatible version of the Rush engine for the given branch.  Once this is implemented, **@rushstack/rush-sdk** can replace **@microsoft/rush-lib** entirely as the official API interface, with the latter serving as the underlying implementation.
 
-The **@rushstack/rush-sdk** API declarations are identical to the corresponding version of **@microsoft/rush-lib**.
-
-## Importing internal APIs
-
-Backwards compatibility is only guaranteed for the APIs marked as `@public` in the official `rush-lib.d.ts` entry point.
-However, sometimes it is expedient for a script to import internal modules from `@microsoft/rush-lib` to access
-unofficial APIs. This practice faces a technical challenge that `@microsoft/rush-lib` is bundled using Webpack.
-The `@rushstack/rush-sdk` package provides stub files that import the corresponding internal module from the
-Webpack bundle, via the `@rushstack/webpack-deep-imports-plugin` mechanism.
-
-> **WARNING:** If the loaded `rush-lib` package has a different version from `rush-sdk`, there is
-> no guarantee that the corresponding path will exist or have the same type signature.
-> Access internal APIs at your own risk. If you find an internal API to be useful, we recommend
-> that you create a GitHub issue proposing to make it public.
-
-Example 1: Conventional import of a public API:
-
-```ts
-// THIS IS THE RECOMMENDED PRACTICE:
-import { RushConfiguration } from '@rushstack/rush-sdk';
-const config = RushConfiguration.loadFromDefaultLocation();
-console.log(config.commonFolder);
-```
 
-Example 2: How to import an internal API:
-
-```ts
-// WARNING: INTERNAL APIS MAY CHANGE AT ANY TIME -- USE THIS AT YOUR OWN RISK:
-
-// Important: Since we're calling an internal API, we need to use the unbundled .d.ts files
-// instead of the normal .d.ts rollup
-import { RushConfiguration } from '@rushstack/rush-sdk/lib/';
-const config = RushConfiguration.loadFromDefaultLocation();
-console.log(config.commonFolder);
-
-// Load an internal module from the Webpack bundle using a path-based import of a stub file:
-import { GitEmailPolicy } from '@rushstack/rush-sdk/lib/logic/policy/GitEmailPolicy';
-console.log(GitEmailPolicy.getEmailExampleLines(config));
-```
+The **@rushstack/rush-sdk** API declarations are identical to the corresponding version of **@microsoft/rush-lib**.
 
 ## Debugging
 
-Verbose logging can be enabled by setting environment variable `RUSH_SDK_DEBUG=1`.
+Verbose logging can be turn on by set environment variable `RUSH_SDK_DEBUG` to `1`
+
 
 ## Links
 
-- [CHANGELOG.md](https://github.com/microsoft/rushstack/blob/main/apps/rush/CHANGELOG.md) - Find
+- [CHANGELOG.md](
+  https://github.com/microsoft/rushstack/blob/main/apps/rush/CHANGELOG.md) - Find
   out what's new in the latest version
 - [API Reference](https://api.rushstack.io/pages/rush-lib/)
 

package/dist/rush-lib.d.ts

@@ -2500,7 +2500,6 @@ export declare class RepoStateFile {
  */
 export declare class Rush {
     private static __rushLibPackageJson;
-    private static __rushLibPackageFolder;
     /**
      * This API is used by the `@microsoft/rush` front end to launch the "rush" command-line.
      * Third-party tools should not use this API.  Instead, they should execute the "rush" binary
@@ -2534,8 +2533,6 @@ export declare class Rush {
      * @internal
      */
     static get _rushLibPackageJson(): IPackageJson;
-    static get _rushLibPackageFolder(): string;
-    private static _ensureOwnPackageJsonIsLoaded;
     /**
      * Assign the `RUSH_INVOKED_FOLDER` environment variable during startup.  This is only applied when
      * Rush is invoked via the CLI, not via the `@microsoft/rush-lib` automation API.
@@ -3444,21 +3441,6 @@ export declare class _RushGlobalFolder {
     constructor();
 }
 
-/**
- * Used by rush-sdk to access internals of rush-lib.
- * @internal
- */
-export declare class _RushInternals {
-    /**
-     * Used by rush-sdk to load an internal API specified by its module path.
-     *
-     * @param srcImportPath - The module path to load.  For example, to refer to `src/api/ChangeFile.ts`,
-     * the `srcImportPath` would be `"api/ChangeFile"`.
-     * @returns the module object as would be returned by `require()`
-     */
-    static loadModule(srcImportPath: string): unknown;
-}
-
 /**
  * Hooks into the lifecycle of the Rush process invocation that plugins may tap into.
  *

package/lib/index.d.ts

@@ -1,52 +1,2 @@
-/**
- * A library for writing scripts that interact with the {@link https://rushjs.io/ | Rush} tool.
- * @packageDocumentation
- */
-export { ApprovedPackagesPolicy } from './api/ApprovedPackagesPolicy';
-export { RushConfiguration, ITryFindRushJsonLocationOptions } from './api/RushConfiguration';
-export { IPackageManagerOptionsJsonBase, IConfigurationEnvironment, IConfigurationEnvironmentVariable, PackageManagerOptionsConfigurationBase } from './logic/base/BasePackageManagerOptionsConfiguration';
-export { INpmOptionsJson as _INpmOptionsJson, NpmOptionsConfiguration } from './logic/npm/NpmOptionsConfiguration';
-export { IYarnOptionsJson as _IYarnOptionsJson, YarnOptionsConfiguration } from './logic/yarn/YarnOptionsConfiguration';
-export { IPnpmOptionsJson as _IPnpmOptionsJson, PnpmStoreOptions, PnpmOptionsConfiguration } from './logic/pnpm/PnpmOptionsConfiguration';
-export { BuildCacheConfiguration } from './api/BuildCacheConfiguration';
-export { GetCacheEntryIdFunction, IGenerateCacheEntryIdOptions } from './logic/buildCache/CacheEntryId';
-export { FileSystemBuildCacheProvider, IFileSystemBuildCacheProviderOptions } from './logic/buildCache/FileSystemBuildCacheProvider';
-export { IPhase } from './api/CommandLineConfiguration';
-export { EnvironmentConfiguration, EnvironmentVariableNames, IEnvironmentConfigurationInitializeOptions } from './api/EnvironmentConfiguration';
-export { RushConstants } from './logic/RushConstants';
-export { PackageManagerName, PackageManager } from './api/packageManager/PackageManager';
-export { RushConfigurationProject } from './api/RushConfigurationProject';
-export { RushUserConfiguration } from './api/RushUserConfiguration';
-export { RushGlobalFolder as _RushGlobalFolder } from './api/RushGlobalFolder';
-export { ApprovedPackagesItem, ApprovedPackagesConfiguration } from './api/ApprovedPackagesConfiguration';
-export { CommonVersionsConfiguration } from './api/CommonVersionsConfiguration';
-export { PackageJsonEditor, PackageJsonDependency, DependencyType } from './api/PackageJsonEditor';
-export { RepoStateFile } from './logic/RepoStateFile';
-export { LookupByPath } from './logic/LookupByPath';
-export { EventHooks, Event } from './api/EventHooks';
-export { ChangeManager } from './api/ChangeManager';
-export { LastInstallFlag as _LastInstallFlag, ILockfileValidityCheckOptions as _ILockfileValidityCheckOptions } from './api/LastInstallFlag';
-export { VersionPolicyDefinitionName, BumpType, LockStepVersionPolicy, IndividualVersionPolicy, VersionPolicy } from './api/VersionPolicy';
-export { VersionPolicyConfiguration } from './api/VersionPolicyConfiguration';
-export { ILaunchOptions, Rush } from './api/Rush';
-export { RushInternals as _RushInternals } from './api/RushInternals';
-export { ExperimentsConfiguration, IExperimentsJson } from './api/ExperimentsConfiguration';
-export { ProjectChangeAnalyzer, IGetChangedProjectsOptions } from './logic/ProjectChangeAnalyzer';
-export { IOperationRunner, IOperationRunnerContext } from './logic/operations/IOperationRunner';
-export { IExecutionResult, IOperationExecutionResult } from './logic/operations/IOperationExecutionResult';
-export { IOperationOptions, Operation } from './logic/operations/Operation';
-export { OperationStatus } from './logic/operations/OperationStatus';
-export { RushSession, IRushSessionOptions, CloudBuildCacheProviderFactory } from './pluginFramework/RushSession';
-export { IRushCommand, IGlobalCommand, IPhasedCommand, RushLifecycleHooks } from './pluginFramework/RushLifeCycle';
-export { ICreateOperationsContext, PhasedCommandHooks } from './pluginFramework/PhasedCommandHooks';
-export { IRushPlugin } from './pluginFramework/IRushPlugin';
-export { IBuiltInPluginConfiguration as _IBuiltInPluginConfiguration } from './pluginFramework/PluginLoader/BuiltInPluginLoader';
-export { IRushPluginConfigurationBase as _IRushPluginConfigurationBase } from './api/RushPluginsConfiguration';
-export { ILogger } from './pluginFramework/logging/Logger';
-export { ICloudBuildCacheProvider } from './logic/buildCache/ICloudBuildCacheProvider';
-export { ICredentialCacheOptions, ICredentialCacheEntry, CredentialCache } from './logic/CredentialCache';
-export type { ITelemetryData, ITelemetryMachineInfo, ITelemetryOperationResult } from './logic/Telemetry';
-export { IStopwatchResult } from './utilities/Stopwatch';
-export { OperationStateFile as _OperationStateFile, IOperationStateFileOptions as _IOperationStateFileOptions, IOperationStateJson as _IOperationStateJson } from './logic/operations/OperationStateFile';
-export { OperationMetadataManager as _OperationMetadataManager, IOperationMetadataManagerOptions as _IOperationMetadataManagerOptions, IOperationMetaData as _IOperationMetadata } from './logic/operations/OperationMetadataManager';
+export {};
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/lib/index.js

@@ -1 +1,190 @@
-module.exports = require("../lib-shim/index")._rushSdk_loadInternalModule("index");
+"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;
+};
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = __importStar(require("path"));
+const node_core_library_1 = require("@rushstack/node-core-library");
+const RUSH_LIB_NAME = '@microsoft/rush-lib';
+const verboseEnabled = typeof process !== 'undefined' && process.env.RUSH_SDK_DEBUG === '1';
+const terminal = new node_core_library_1.Terminal(new node_core_library_1.ConsoleTerminalProvider({
+    verboseEnabled
+}));
+function _require(moduleName) {
+    if (typeof __non_webpack_require__ === 'function') {
+        // If this library has been bundled with Webpack, we need to call the real `require` function
+        // that doesn't get turned into a `__webpack_require__` statement.
+        // `__non_webpack_require__` is a Webpack macro that gets turned into a `require` statement
+        // during bundling.
+        return __non_webpack_require__(moduleName);
+    }
+    else {
+        return require(moduleName);
+    }
+}
+// SCENARIO 1:  Rush's PluginManager has initialized "rush-sdk" with Rush's own instance of rush-lib.
+// The Rush host process will assign "global.___rush___rushLibModule" before loading the plugin.
+let rushLibModule = global.___rush___rushLibModule || global.___rush___rushLibModuleFromInstallAndRunRush;
+let errorMessage = '';
+// SCENARIO 2:  The project importing "rush-sdk" has installed its own instance of "rush-lib"
+// as a package.json dependency.  For example, this is used by the Jest tests for Rush plugins.
+if (rushLibModule === undefined) {
+    const importingPath = (_a = module === null || module === void 0 ? void 0 : module.parent) === null || _a === void 0 ? void 0 : _a.filename;
+    if (importingPath) {
+        const callerPackageFolder = node_core_library_1.PackageJsonLookup.instance.tryGetPackageFolderFor(importingPath);
+        if (callerPackageFolder !== undefined) {
+            const callerPackageJson = _require(path.join(callerPackageFolder, 'package.json'));
+            // Does the caller properly declare a dependency on rush-lib?
+            if ((callerPackageJson.dependencies && callerPackageJson.dependencies[RUSH_LIB_NAME] !== undefined) ||
+                (callerPackageJson.devDependencies &&
+                    callerPackageJson.devDependencies[RUSH_LIB_NAME] !== undefined) ||
+                (callerPackageJson.peerDependencies &&
+                    callerPackageJson.peerDependencies[RUSH_LIB_NAME] !== undefined)) {
+                // Try to resolve rush-lib from the caller's folder
+                terminal.writeVerboseLine(`Try to load ${RUSH_LIB_NAME} from caller package`);
+                try {
+                    rushLibModule = requireRushLibUnderFolderPath(callerPackageFolder);
+                }
+                catch (error) {
+                    // If we fail to resolve it, ignore the error
+                    terminal.writeVerboseLine(`Failed to load ${RUSH_LIB_NAME} from caller package`);
+                }
+                // If two different libraries invoke `rush-sdk`, and one of them provides "rush-lib"
+                // then the first version to be loaded wins.  We do not support side-by-side instances of "rush-lib".
+                if (rushLibModule !== undefined) {
+                    // to track which scenario is active and how it got initialized.
+                    global.___rush___rushLibModule = rushLibModule;
+                    terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} from caller`);
+                }
+            }
+        }
+    }
+}
+// SCENARIO 3:  A tool or script depends on "rush-sdk", and is meant to be used inside a monorepo folder.
+// In this case, we can use install-run-rush.js to obtain the appropriate rush-lib version for the monorepo.
+if (rushLibModule === undefined) {
+    try {
+        const rushJsonPath = tryFindRushJsonLocation(process.cwd());
+        if (!rushJsonPath) {
+            throw new Error('Unable to find rush.json in the current folder or its parent folders.\n' +
+                'This tool is meant to be invoked from a working directory inside a Rush repository.');
+        }
+        const monorepoRoot = path.dirname(rushJsonPath);
+        const rushJson = node_core_library_1.JsonFile.load(rushJsonPath);
+        const { rushVersion } = rushJson;
+        const installRunNodeModuleFolder = path.join(monorepoRoot, `common/temp/install-run/@microsoft+rush@${rushVersion}`);
+        try {
+            // First, try to load the version of "rush-lib" that was installed by install-run-rush.js
+            terminal.writeVerboseLine(`Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush`);
+            rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);
+        }
+        catch (e) {
+            let installAndRunRushStderrContent = '';
+            try {
+                const installAndRunRushJSPath = path.join(monorepoRoot, 'common/scripts/install-run-rush.js');
+                terminal.writeLine('The Rush engine has not been installed yet. Invoking install-run-rush.js...');
+                const installAndRuhRushProcess = node_core_library_1.Executable.spawnSync('node', [installAndRunRushJSPath, '--help'], {
+                    stdio: 'pipe'
+                });
+                installAndRunRushStderrContent = installAndRuhRushProcess.stderr;
+                if (installAndRuhRushProcess.status !== 0) {
+                    throw new Error(`The ${RUSH_LIB_NAME} package failed to install`);
+                }
+                // Retry to load "rush-lib" after install-run-rush run
+                terminal.writeVerboseLine(`Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush a second time`);
+                rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);
+            }
+            catch (e) {
+                console.error(`${installAndRunRushStderrContent}`);
+                throw new Error(`The ${RUSH_LIB_NAME} package failed to load`);
+            }
+        }
+        if (rushLibModule !== undefined) {
+            // to track which scenario is active and how it got initialized.
+            global.___rush___rushLibModuleFromInstallAndRunRush = rushLibModule;
+            terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} installed by install-run-rush`);
+        }
+    }
+    catch (e) {
+        // no-catch
+        errorMessage = e.message;
+    }
+}
+if (rushLibModule === undefined) {
+    // This error indicates that a project is trying to import "@rushstack/rush-sdk", but the Rush engine
+    // instance cannot be found.  If you are writing Jest tests for a Rush plugin, add "@microsoft/rush-lib"
+    // to the devDependencies for your project.
+    console.error(`Error: The @rushstack/rush-sdk package was not able to load the Rush engine:
+${errorMessage}
+`);
+    process.exit(1);
+}
+// Based on TypeScript's __exportStar()
+for (const property in rushLibModule) {
+    if (property !== 'default' && !exports.hasOwnProperty(property)) {
+        const rushLibModuleForClosure = rushLibModule;
+        // Based on TypeScript's __createBinding()
+        Object.defineProperty(exports, property, {
+            enumerable: true,
+            get: function () {
+                return rushLibModuleForClosure[property];
+            }
+        });
+    }
+}
+/**
+ * Require `@microsoft/rush-lib` under the specified folder path.
+ */
+function requireRushLibUnderFolderPath(folderPath) {
+    const rushLibModulePath = node_core_library_1.Import.resolveModule({
+        modulePath: RUSH_LIB_NAME,
+        baseFolderPath: folderPath
+    });
+    return _require(rushLibModulePath);
+}
+/**
+ * Find the rush.json location and return the path, or undefined if a rush.json can't be found.
+ *
+ * @privateRemarks
+ * Keep this in sync with `RushConfiguration.tryFindRushJsonLocation`.
+ */
+function tryFindRushJsonLocation(startingFolder) {
+    let currentFolder = startingFolder;
+    // Look upwards at parent folders until we find a folder containing rush.json
+    for (let i = 0; i < 10; ++i) {
+        const rushJsonFilename = path.join(currentFolder, 'rush.json');
+        if (node_core_library_1.FileSystem.exists(rushJsonFilename)) {
+            return rushJsonFilename;
+        }
+        const parentFolder = path.dirname(currentFolder);
+        if (parentFolder === currentFolder) {
+            break;
+        }
+        currentFolder = parentFolder;
+    }
+    return undefined;
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,2CAA6B;AAC7B,oEAUsC;AAGtC,MAAM,aAAa,GAAW,qBAAqB,CAAC;AAEpD,MAAM,cAAc,GAAY,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,GAAG,CAAC;AACrG,MAAM,QAAQ,GAAa,IAAI,4BAAQ,CACrC,IAAI,2CAAuB,CAAC;IAC1B,cAAc;CACf,CAAC,CACH,CAAC;AASF,SAAS,QAAQ,CAAU,UAAkB;IAC3C,IAAI,OAAO,uBAAuB,KAAK,UAAU,EAAE;QACjD,6FAA6F;QAC7F,kEAAkE;QAClE,2FAA2F;QAC3F,mBAAmB;QACnB,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;KAC5C;SAAM;QACL,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;KAC5B;AACH,CAAC;AAED,qGAAqG;AACrG,gGAAgG;AAChG,IAAI,aAAa,GACf,MAAM,CAAC,uBAAuB,IAAI,MAAM,CAAC,4CAA4C,CAAC;AACxF,IAAI,YAAY,GAAW,EAAE,CAAC;AAE9B,6FAA6F;AAC7F,+FAA+F;AAC/F,IAAI,aAAa,KAAK,SAAS,EAAE;IAC/B,MAAM,aAAa,GAA8B,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,0CAAE,QAAQ,CAAC;IAC1E,IAAI,aAAa,EAAE;QACjB,MAAM,mBAAmB,GACvB,qCAAiB,CAAC,QAAQ,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAEnE,IAAI,mBAAmB,KAAK,SAAS,EAAE;YACrC,MAAM,iBAAiB,GAAiB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC;YAEjG,6DAA6D;YAC7D,IACE,CAAC,iBAAiB,CAAC,YAAY,IAAI,iBAAiB,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,SAAS,CAAC;gBAC/F,CAAC,iBAAiB,CAAC,eAAe;oBAChC,iBAAiB,CAAC,eAAe,CAAC,aAAa,CAAC,KAAK,SAAS,CAAC;gBACjE,CAAC,iBAAiB,CAAC,gBAAgB;oBACjC,iBAAiB,CAAC,gBAAgB,CAAC,aAAa,CAAC,KAAK,SAAS,CAAC,EAClE;gBACA,mDAAmD;gBACnD,QAAQ,CAAC,gBAAgB,CAAC,eAAe,aAAa,sBAAsB,CAAC,CAAC;gBAC9E,IAAI;oBACF,aAAa,GAAG,6BAA6B,CAAC,mBAAmB,CAAC,CAAC;iBACpE;gBAAC,OAAO,KAAK,EAAE;oBACd,6CAA6C;oBAC7C,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,aAAa,sBAAsB,CAAC,CAAC;iBAClF;gBAED,oFAAoF;gBACpF,qGAAqG;gBACrG,IAAI,aAAa,KAAK,SAAS,EAAE;oBAC/B,gEAAgE;oBAChE,MAAM,CAAC,uBAAuB,GAAG,aAAa,CAAC;oBAC/C,QAAQ,CAAC,gBAAgB,CAAC,UAAU,aAAa,cAAc,CAAC,CAAC;iBAClE;aACF;SACF;KACF;CACF;AAED,yGAAyG;AACzG,4GAA4G;AAC5G,IAAI,aAAa,KAAK,SAAS,EAAE;IAC/B,IAAI;QACF,MAAM,YAAY,GAAuB,uBAAuB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC,YAAY,EAAE;YACjB,MAAM,IAAI,KAAK,CACb,yEAAyE;gBACvE,qFAAqF,CACxF,CAAC;SACH;QACD,MAAM,YAAY,GAAW,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAExD,MAAM,QAAQ,GAAe,4BAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzD,MAAM,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;QAEjC,MAAM,0BAA0B,GAAW,IAAI,CAAC,IAAI,CAClD,YAAY,EACZ,2CAA2C,WAAW,EAAE,CACzD,CAAC;QAEF,IAAI;YACF,yFAAyF;YACzF,QAAQ,CAAC,gBAAgB,CAAC,mBAAmB,aAAa,gCAAgC,CAAC,CAAC;YAC5F,aAAa,GAAG,6BAA6B,CAAC,0BAA0B,CAAC,CAAC;SAC3E;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,8BAA8B,GAAW,EAAE,CAAC;YAChD,IAAI;gBACF,MAAM,uBAAuB,GAAW,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,oCAAoC,CAAC,CAAC;gBAEtG,QAAQ,CAAC,SAAS,CAAC,6EAA6E,CAAC,CAAC;gBAElG,MAAM,wBAAwB,GAA6B,8BAAU,CAAC,SAAS,CAC7E,MAAM,EACN,CAAC,uBAAuB,EAAE,QAAQ,CAAC,EACnC;oBACE,KAAK,EAAE,MAAM;iBACd,CACF,CAAC;gBAEF,8BAA8B,GAAG,wBAAwB,CAAC,MAAM,CAAC;gBACjE,IAAI,wBAAwB,CAAC,MAAM,KAAK,CAAC,EAAE;oBACzC,MAAM,IAAI,KAAK,CAAC,OAAO,aAAa,4BAA4B,CAAC,CAAC;iBACnE;gBAED,sDAAsD;gBACtD,QAAQ,CAAC,gBAAgB,CACvB,mBAAmB,aAAa,8CAA8C,CAC/E,CAAC;gBACF,aAAa,GAAG,6BAA6B,CAAC,0BAA0B,CAAC,CAAC;aAC3E;YAAC,OAAO,CAAC,EAAE;gBACV,OAAO,CAAC,KAAK,CAAC,GAAG,8BAA8B,EAAE,CAAC,CAAC;gBACnD,MAAM,IAAI,KAAK,CAAC,OAAO,aAAa,yBAAyB,CAAC,CAAC;aAChE;SACF;QAED,IAAI,aAAa,KAAK,SAAS,EAAE;YAC/B,gEAAgE;YAChE,MAAM,CAAC,4CAA4C,GAAG,aAAa,CAAC;YACpE,QAAQ,CAAC,gBAAgB,CAAC,UAAU,aAAa,gCAAgC,CAAC,CAAC;SACpF;KACF;IAAC,OAAO,CAAC,EAAE;QACV,WAAW;QACX,YAAY,GAAI,CAAW,CAAC,OAAO,CAAC;KACrC;CACF;AAED,IAAI,aAAa,KAAK,SAAS,EAAE;IAC/B,qGAAqG;IACrG,wGAAwG;IACxG,2CAA2C;IAC3C,OAAO,CAAC,KAAK,CAAC;EACd,YAAY;CACb,CAAC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CACjB;AAED,uCAAuC;AACvC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE;IACpC,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE;QAC/D,MAAM,uBAAuB,GAAsB,aAAa,CAAC;QAEjE,0CAA0C;QAC1C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE;YACvC,UAAU,EAAE,IAAI;YAChB,GAAG,EAAE;gBACH,OAAO,uBAAuB,CAAC,QAAQ,CAAC,CAAC;YAC3C,CAAC;SACF,CAAC,CAAC;KACJ;CACF;AAED;;GAEG;AACH,SAAS,6BAA6B,CAAC,UAAkB;IACvD,MAAM,iBAAiB,GAAW,0BAAM,CAAC,aAAa,CAAC;QACrD,UAAU,EAAE,aAAa;QACzB,cAAc,EAAE,UAAU;KAC3B,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,SAAS,uBAAuB,CAAC,cAAsB;IACrD,IAAI,aAAa,GAAW,cAAc,CAAC;IAE3C,6EAA6E;IAC7E,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE;QACnC,MAAM,gBAAgB,GAAW,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAEvE,IAAI,8BAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE;YACvC,OAAO,gBAAgB,CAAC;SACzB;QAED,MAAM,YAAY,GAAW,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,YAAY,KAAK,aAAa,EAAE;YAClC,MAAM;SACP;QAED,aAAa,GAAG,YAAY,CAAC;KAC9B;IAED,OAAO,SAAS,CAAC;AACnB,CAAC","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 * as path from 'path';\nimport {\n  JsonFile,\n  JsonObject,\n  Import,\n  IPackageJson,\n  PackageJsonLookup,\n  Executable,\n  FileSystem,\n  Terminal,\n  ConsoleTerminalProvider\n} from '@rushstack/node-core-library';\nimport type { SpawnSyncReturns } from 'child_process';\n\nconst RUSH_LIB_NAME: string = '@microsoft/rush-lib';\n\nconst verboseEnabled: boolean = typeof process !== 'undefined' && process.env.RUSH_SDK_DEBUG === '1';\nconst terminal: Terminal = new Terminal(\n  new ConsoleTerminalProvider({\n    verboseEnabled\n  })\n);\n\ntype RushLibModuleType = Record<string, unknown>;\ndeclare const global: NodeJS.Global &\n  typeof globalThis & {\n    ___rush___rushLibModule?: RushLibModuleType;\n    ___rush___rushLibModuleFromInstallAndRunRush?: RushLibModuleType;\n  };\n\nfunction _require<TResult>(moduleName: string): TResult {\n  if (typeof __non_webpack_require__ === 'function') {\n    // If this library has been bundled with Webpack, we need to call the real `require` function\n    // that doesn't get turned into a `__webpack_require__` statement.\n    // `__non_webpack_require__` is a Webpack macro that gets turned into a `require` statement\n    // during bundling.\n    return __non_webpack_require__(moduleName);\n  } else {\n    return require(moduleName);\n  }\n}\n\n// SCENARIO 1:  Rush's PluginManager has initialized \"rush-sdk\" with Rush's own instance of rush-lib.\n// The Rush host process will assign \"global.___rush___rushLibModule\" before loading the plugin.\nlet rushLibModule: RushLibModuleType | undefined =\n  global.___rush___rushLibModule || global.___rush___rushLibModuleFromInstallAndRunRush;\nlet errorMessage: string = '';\n\n// SCENARIO 2:  The project importing \"rush-sdk\" has installed its own instance of \"rush-lib\"\n// as a package.json dependency.  For example, this is used by the Jest tests for Rush plugins.\nif (rushLibModule === undefined) {\n  const importingPath: string | null | undefined = module?.parent?.filename;\n  if (importingPath) {\n    const callerPackageFolder: string | undefined =\n      PackageJsonLookup.instance.tryGetPackageFolderFor(importingPath);\n\n    if (callerPackageFolder !== undefined) {\n      const callerPackageJson: IPackageJson = _require(path.join(callerPackageFolder, 'package.json'));\n\n      // Does the caller properly declare a dependency on rush-lib?\n      if (\n        (callerPackageJson.dependencies && callerPackageJson.dependencies[RUSH_LIB_NAME] !== undefined) ||\n        (callerPackageJson.devDependencies &&\n          callerPackageJson.devDependencies[RUSH_LIB_NAME] !== undefined) ||\n        (callerPackageJson.peerDependencies &&\n          callerPackageJson.peerDependencies[RUSH_LIB_NAME] !== undefined)\n      ) {\n        // Try to resolve rush-lib from the caller's folder\n        terminal.writeVerboseLine(`Try to load ${RUSH_LIB_NAME} from caller package`);\n        try {\n          rushLibModule = requireRushLibUnderFolderPath(callerPackageFolder);\n        } catch (error) {\n          // If we fail to resolve it, ignore the error\n          terminal.writeVerboseLine(`Failed to load ${RUSH_LIB_NAME} from caller package`);\n        }\n\n        // If two different libraries invoke `rush-sdk`, and one of them provides \"rush-lib\"\n        // then the first version to be loaded wins.  We do not support side-by-side instances of \"rush-lib\".\n        if (rushLibModule !== undefined) {\n          // to track which scenario is active and how it got initialized.\n          global.___rush___rushLibModule = rushLibModule;\n          terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} from caller`);\n        }\n      }\n    }\n  }\n}\n\n// SCENARIO 3:  A tool or script depends on \"rush-sdk\", and is meant to be used inside a monorepo folder.\n// In this case, we can use install-run-rush.js to obtain the appropriate rush-lib version for the monorepo.\nif (rushLibModule === undefined) {\n  try {\n    const rushJsonPath: string | undefined = tryFindRushJsonLocation(process.cwd());\n    if (!rushJsonPath) {\n      throw new Error(\n        'Unable to find rush.json in the current folder or its parent folders.\\n' +\n          'This tool is meant to be invoked from a working directory inside a Rush repository.'\n      );\n    }\n    const monorepoRoot: string = path.dirname(rushJsonPath);\n\n    const rushJson: JsonObject = JsonFile.load(rushJsonPath);\n    const { rushVersion } = rushJson;\n\n    const installRunNodeModuleFolder: string = path.join(\n      monorepoRoot,\n      `common/temp/install-run/@microsoft+rush@${rushVersion}`\n    );\n\n    try {\n      // First, try to load the version of \"rush-lib\" that was installed by install-run-rush.js\n      terminal.writeVerboseLine(`Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush`);\n      rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);\n    } catch (e) {\n      let installAndRunRushStderrContent: string = '';\n      try {\n        const installAndRunRushJSPath: string = path.join(monorepoRoot, 'common/scripts/install-run-rush.js');\n\n        terminal.writeLine('The Rush engine has not been installed yet. Invoking install-run-rush.js...');\n\n        const installAndRuhRushProcess: SpawnSyncReturns<string> = Executable.spawnSync(\n          'node',\n          [installAndRunRushJSPath, '--help'],\n          {\n            stdio: 'pipe'\n          }\n        );\n\n        installAndRunRushStderrContent = installAndRuhRushProcess.stderr;\n        if (installAndRuhRushProcess.status !== 0) {\n          throw new Error(`The ${RUSH_LIB_NAME} package failed to install`);\n        }\n\n        // Retry to load \"rush-lib\" after install-run-rush run\n        terminal.writeVerboseLine(\n          `Trying to load  ${RUSH_LIB_NAME} installed by install-run-rush a second time`\n        );\n        rushLibModule = requireRushLibUnderFolderPath(installRunNodeModuleFolder);\n      } catch (e) {\n        console.error(`${installAndRunRushStderrContent}`);\n        throw new Error(`The ${RUSH_LIB_NAME} package failed to load`);\n      }\n    }\n\n    if (rushLibModule !== undefined) {\n      // to track which scenario is active and how it got initialized.\n      global.___rush___rushLibModuleFromInstallAndRunRush = rushLibModule;\n      terminal.writeVerboseLine(`Loaded ${RUSH_LIB_NAME} installed by install-run-rush`);\n    }\n  } catch (e) {\n    // no-catch\n    errorMessage = (e as Error).message;\n  }\n}\n\nif (rushLibModule === undefined) {\n  // This error indicates that a project is trying to import \"@rushstack/rush-sdk\", but the Rush engine\n  // instance cannot be found.  If you are writing Jest tests for a Rush plugin, add \"@microsoft/rush-lib\"\n  // to the devDependencies for your project.\n  console.error(`Error: The @rushstack/rush-sdk package was not able to load the Rush engine:\n${errorMessage}\n`);\n  process.exit(1);\n}\n\n// Based on TypeScript's __exportStar()\nfor (const property in rushLibModule) {\n  if (property !== 'default' && !exports.hasOwnProperty(property)) {\n    const rushLibModuleForClosure: RushLibModuleType = rushLibModule;\n\n    // Based on TypeScript's __createBinding()\n    Object.defineProperty(exports, property, {\n      enumerable: true,\n      get: function () {\n        return rushLibModuleForClosure[property];\n      }\n    });\n  }\n}\n\n/**\n * Require `@microsoft/rush-lib` under the specified folder path.\n */\nfunction requireRushLibUnderFolderPath(folderPath: string): RushLibModuleType {\n  const rushLibModulePath: string = Import.resolveModule({\n    modulePath: RUSH_LIB_NAME,\n    baseFolderPath: folderPath\n  });\n\n  return _require(rushLibModulePath);\n}\n\n/**\n * Find the rush.json location and return the path, or undefined if a rush.json can't be found.\n *\n * @privateRemarks\n * Keep this in sync with `RushConfiguration.tryFindRushJsonLocation`.\n */\nfunction tryFindRushJsonLocation(startingFolder: string): string | undefined {\n  let currentFolder: string = startingFolder;\n\n  // Look upwards at parent folders until we find a folder containing rush.json\n  for (let i: number = 0; i < 10; ++i) {\n    const rushJsonFilename: string = path.join(currentFolder, 'rush.json');\n\n    if (FileSystem.exists(rushJsonFilename)) {\n      return rushJsonFilename;\n    }\n\n    const parentFolder: string = path.dirname(currentFolder);\n    if (parentFolder === currentFolder) {\n      break;\n    }\n\n    currentFolder = parentFolder;\n  }\n\n  return undefined;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.90.2-pr3954.0",
+  "version": "5.90.2-pr3964.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -8,7 +8,7 @@
     "directory": "apps/rush-sdk"
   },
   "homepage": "https://rushjs.io",
-  "main": "lib-shim/index.js",
+  "main": "lib/index.js",
   "typings": "dist/rush-lib.d.ts",
   "license": "MIT",
   "dependencies": {
@@ -20,7 +20,7 @@
     "@types/heft-jest": "1.0.1",
     "@types/semver": "7.3.5",
     "@types/webpack-env": "1.18.0",
-    "@microsoft/rush-lib": "5.90.2-pr3954.0",
+    "@microsoft/rush-lib": "5.90.2-pr3964.0",
     "@rushstack/eslint-config": "3.2.0",
     "@rushstack/heft": "0.49.7",
     "@rushstack/heft-node-rig": "1.12.4",

package/lib/api/ApprovedPackagesConfiguration.d.ts

@@ -1,74 +0,0 @@
-/**
- * Part of IApprovedPackagesJson.
- */
-export interface IApprovedPackagesItemJson {
-    name: string;
-    allowedCategories: string[];
-}
-/**
- * This represents the JSON data structure for the "browser-approved-packages.json"
- * and "nonbrowser-approved-packages.json" configuration files.  See "approved-packages.schema.json"
- * for documentation.
- */
-export interface IApprovedPackagesJson {
-    $schema?: string;
-    packages: IApprovedPackagesItemJson[];
-}
-/**
- * An item returned by ApprovedPackagesConfiguration
- * @public
- */
-export declare class ApprovedPackagesItem {
-    /**
-     * The NPM package name
-     */
-    packageName: string;
-    /**
-     * The project categories that are allowed to use this package.
-     */
-    allowedCategories: Set<string>;
-    /**
-     * @internal
-     */
-    constructor(packageName: string);
-}
-/**
- * This represents the JSON file specified via the "approvedPackagesFile" option in rush.json.
- * @public
- */
-export declare class ApprovedPackagesConfiguration {
-    private static _jsonSchema;
-    items: ApprovedPackagesItem[];
-    private _itemsByName;
-    private _loadedJson;
-    private _jsonFilename;
-    constructor(jsonFilename: string);
-    /**
-     * Clears all the settings, returning to an empty state.
-     */
-    clear(): void;
-    getItemByName(packageName: string): ApprovedPackagesItem | undefined;
-    addOrUpdatePackage(packageName: string, reviewCategory: string): boolean;
-    /**
-     * If the file exists, calls loadFromFile().
-     */
-    tryLoadFromFile(approvedPackagesPolicyEnabled: boolean): boolean;
-    /**
-     * Loads the configuration data from the filename that was passed to the constructor.
-     */
-    loadFromFile(): void;
-    /**
-     * Loads the configuration data to the filename that was passed to the constructor.
-     */
-    saveToFile(): void;
-    /**
-     * Helper function only used by the constructor when loading the file.
-     */
-    private _addItemJson;
-    /**
-     * Helper function that adds an already created ApprovedPackagesItem to the
-     * list and set.
-     */
-    private _addItem;
-}
-//# sourceMappingURL=ApprovedPackagesConfiguration.d.ts.map

package/lib/api/ApprovedPackagesConfiguration.js

@@ -1 +0,0 @@
-module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("api/ApprovedPackagesConfiguration");

package/lib/api/ApprovedPackagesPolicy.d.ts

@@ -1,54 +0,0 @@
-import { ApprovedPackagesConfiguration } from './ApprovedPackagesConfiguration';
-import { RushConfiguration, IRushConfigurationJson } from './RushConfiguration';
-/**
- * This is a helper object for RushConfiguration.
- * It exposes the "approvedPackagesPolicy" feature from rush.json.
- * @public
- */
-export declare class ApprovedPackagesPolicy {
-    /**
-     * Whether the feature is enabled.  The feature is enabled if the "approvedPackagesPolicy"
-     * field is assigned in rush.json.
-     */
-    readonly enabled: boolean;
-    /**
-     * A list of NPM package scopes that will be excluded from review (e.g. `@types`)
-     */
-    readonly ignoredNpmScopes: ReadonlySet<string>;
-    /**
-     * A list of category names that are valid for usage as the RushConfigurationProject.reviewCategory field.
-     * This array will never be undefined.
-     */
-    readonly reviewCategories: ReadonlySet<string>;
-    /**
-     * Packages approved for usage in a web browser.  This is the stricter of the two types, so by default
-     * all new packages are added to this file.
-     *
-     * @remarks
-     *
-     * This is part of an optional approval workflow, whose purpose is to review any new dependencies
-     * that are introduced (e.g. maybe a legal review is required, or maybe we are trying to minimize bloat).
-     * When Rush discovers a new dependency has been added to package.json, it will update the file.
-     * The intent is that the file will be stored in Git and tracked by a branch policy that notifies
-     * reviewers when a PR attempts to modify the file.
-     *
-     * Example filename: `C:\MyRepo\common\config\rush\browser-approved-packages.json`
-     */
-    readonly browserApprovedPackages: ApprovedPackagesConfiguration;
-    /**
-     * Packages approved for usage everywhere *except* in a web browser.
-     *
-     * @remarks
-     *
-     * This is part of an optional approval workflow, whose purpose is to review any new dependencies
-     * that are introduced (e.g. maybe a legal review is required, or maybe we are trying to minimize bloat).
-     * The intent is that the file will be stored in Git and tracked by a branch policy that notifies
-     * reviewers when a PR attempts to modify the file.
-     *
-     * Example filename: `C:\MyRepo\common\config\rush\browser-approved-packages.json`
-     */
-    readonly nonbrowserApprovedPackages: ApprovedPackagesConfiguration;
-    /** @internal */
-    constructor(rushConfiguration: RushConfiguration, rushConfigurationJson: IRushConfigurationJson);
-}
-//# sourceMappingURL=ApprovedPackagesPolicy.d.ts.map

package/lib/api/ApprovedPackagesPolicy.js

@@ -1 +0,0 @@
-module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("api/ApprovedPackagesPolicy");

package/lib/api/BuildCacheConfiguration.d.ts

@@ -1,77 +0,0 @@
-import { JsonObject, ITerminal } from '@rushstack/node-core-library';
-import { RushConfiguration } from './RushConfiguration';
-import { FileSystemBuildCacheProvider } from '../logic/buildCache/FileSystemBuildCacheProvider';
-import { ICloudBuildCacheProvider } from '../logic/buildCache/ICloudBuildCacheProvider';
-import { GetCacheEntryIdFunction } from '../logic/buildCache/CacheEntryId';
-import type { RushSession } from '../pluginFramework/RushSession';
-/**
- * Describes the file structure for the "common/config/rush/build-cache.json" config file.
- */
-export interface IBaseBuildCacheJson {
-    buildCacheEnabled: boolean;
-    cacheProvider: string;
-    cacheEntryNamePattern?: string;
-}
-/**
- * @public
- */
-export interface ILocalBuildCacheJson extends IBaseBuildCacheJson {
-    readonly cacheProvider: 'local-only';
-}
-/**
- * @beta
- */
-export interface ICloudBuildCacheJson extends IBaseBuildCacheJson {
-    readonly cacheProvider: string;
-    [otherConfigKey: string]: JsonObject;
-}
-/**
- * @beta
- */
-export declare type IBuildCacheJson = ICloudBuildCacheJson | ILocalBuildCacheJson;
-/**
- * Use this class to load and save the "common/config/rush/build-cache.json" config file.
- * This file provides configuration options for cached project build output.
- * @beta
- */
-export declare class BuildCacheConfiguration {
-    private static _jsonSchema;
-    /**
-     * Indicates whether the build cache feature is enabled.
-     * Typically it is enabled in the build-cache.json config file.
-     */
-    readonly buildCacheEnabled: boolean;
-    /**
-     * Indicates whether or not writing to the cache is enabled.
-     */
-    cacheWriteEnabled: boolean;
-    /**
-     * Method to calculate the cache entry id for a project, phase, and project state.
-     */
-    readonly getCacheEntryId: GetCacheEntryIdFunction;
-    /**
-     * The provider for interacting with the local build cache.
-     */
-    readonly localCacheProvider: FileSystemBuildCacheProvider;
-    /**
-     * The provider for interacting with the cloud build cache, if configured.
-     */
-    readonly cloudCacheProvider: ICloudBuildCacheProvider | undefined;
-    private constructor();
-    /**
-     * Attempts to load the build-cache.json data from the standard file path `common/config/rush/build-cache.json`.
-     * If the file has not been created yet, then undefined is returned.
-     */
-    static tryLoadAsync(terminal: ITerminal, rushConfiguration: RushConfiguration, rushSession: RushSession): Promise<BuildCacheConfiguration | undefined>;
-    /**
-     * Loads the build-cache.json data from the standard file path `common/config/rush/build-cache.json`.
-     * If the file has not been created yet, or if the feature is not enabled, then an error is reported.
-     */
-    static loadAndRequireEnabledAsync(terminal: ITerminal, rushConfiguration: RushConfiguration, rushSession: RushSession): Promise<BuildCacheConfiguration>;
-    /**
-     * Gets the absolute path to the build-cache.json file in the specified rush workspace.
-     */
-    static getBuildCacheConfigFilePath(rushConfiguration: RushConfiguration): string;
-    private static _loadAsync;
-}
-//# sourceMappingURL=BuildCacheConfiguration.d.ts.map

package/lib/api/BuildCacheConfiguration.js

@@ -1 +0,0 @@
-module.exports = require("../../lib-shim/index")._rushSdk_loadInternalModule("api/BuildCacheConfiguration");