@rushstack/rush-sdk 5.57.1 → 5.59.0-rc.2

package/README.md

@@ -1,26 +1,26 @@
-## @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 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:
-
-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.
-
-3. **(Not implemented yet)** 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**.
-
-
-## Links
-
-- [CHANGELOG.md](
-  https://github.com/microsoft/rushstack/blob/master/apps/rush/CHANGELOG.md) - Find
-  out what's new in the latest version
-- [API Reference](https://rushstack.io/pages/api/rush-lib/)
-
-Rush is part of the [Rush Stack](https://rushstack.io/) family of projects.
+## @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 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:
+
+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.
+
+3. **(Not implemented yet)** 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**.
+
+
+## Links
+
+- [CHANGELOG.md](
+  https://github.com/microsoft/rushstack/blob/master/apps/rush/CHANGELOG.md) - Find
+  out what's new in the latest version
+- [API Reference](https://rushstack.io/pages/api/rush-lib/)
+
+Rush is part of the [Rush Stack](https://rushstack.io/) family of projects.

package/dist/rush-lib.d.ts

@@ -603,6 +603,13 @@ declare interface IBaseBuildCacheJson {
  */
 declare type IBuildCacheJson = ICloudBuildCacheJson | ILocalBuildCacheJson;
 
+/**
+ * @internal
+ */
+export declare interface _IBuiltInPluginConfiguration extends _IRushPluginConfigurationBase {
+    pluginPackageFolder: string;
+}
+
 /**
  * @beta
  */
@@ -721,12 +728,10 @@ export declare interface IExperimentsJson {
      */
     buildCacheWithAllowWarningsInSuccessfulBuild?: boolean;
     /**
-     * If true, the multi-phase commands feature is enabled. To use this feature, create a "phased" command
+     * If true, the phased commands feature is enabled. To use this feature, create a "phased" command
      * in common/config/rush/command-line.json.
-     *
-     * THIS FEATURE IS NOT READY FOR USAGE YET. SEE GITHUB #2300 FOR STATUS.
      */
-    _multiPhaseCommands?: boolean;
+    phasedCommands?: boolean;
 }
 
 /**
@@ -736,6 +741,16 @@ export declare interface IGetChangedProjectsOptions {
     targetBranchName: string;
     terminal: ITerminal;
     shouldFetch?: boolean;
+    /**
+     * If set to `true`, consider a project's external dependency installation layout as defined in the
+     * package manager lockfile when determining if it has changed.
+     */
+    includeExternalDependencies: boolean;
+    /**
+     * If set to `true` apply the `incrementalBuildIgnoredGlobs` property in a project's `rush-project.json`
+     * and exclude matched files from change detection.
+     */
+    enableFiltering: boolean;
 }
 
 declare interface IIndividualVersionJson extends IVersionPolicyJson {
@@ -759,6 +774,12 @@ export declare interface ILaunchOptions {
      * with this version of Rush, so we shouldn't print a similar error.
      */
     alreadyReportedNodeTooNewError?: boolean;
+    /**
+     * Used to specify Rush plugins that are dependencies of the "\@microsoft/rush" package.
+     *
+     * @internal
+     */
+    builtInPluginConfigurations?: _IBuiltInPluginConfiguration[];
 }
 
 /**
@@ -935,11 +956,14 @@ export declare interface IRushPlugin {
     apply(rushSession: RushSession, rushConfiguration: RushConfiguration): void;
 }
 
-declare interface IRushPluginConfiguration extends IRushPluginConfigurationBase {
+declare interface IRushPluginConfiguration extends _IRushPluginConfigurationBase {
     autoinstallerName: string;
 }
 
-declare interface IRushPluginConfigurationBase {
+/**
+ * @internal
+ */
+export declare interface _IRushPluginConfigurationBase {
     packageName: string;
     pluginName: string;
 }
@@ -948,14 +972,12 @@ declare interface IRushPluginsConfigurationJson {
     plugins: IRushPluginConfiguration[];
 }
 
+declare type IRushRepositoryJson = IRushRepositoryJsonSingleUrl | IRushRepositoryJsonMultipleUrls;
+
 /**
  * Part of IRushConfigurationJson.
  */
-declare interface IRushRepositoryJson {
-    /**
-     * The remote url of the repository. This helps "rush change" find the right remote to compare against.
-     */
-    url?: string;
+declare interface IRushRepositoryJsonBase {
     /**
      * The default branch name. This tells "rush change" which remote branch to compare against.
      */
@@ -967,6 +989,26 @@ declare interface IRushRepositoryJson {
     defaultRemote?: string;
 }
 
+declare interface IRushRepositoryJsonMultipleUrls extends IRushRepositoryJsonBase {
+    /**
+     * Remote url(s) of the repository. If a value is provided, \"rush change\" will
+     * use one of these to find the right remote to compare against. Specifying multiple URLs
+     * is useful if a GitHub repository is renamed or for "<projectName>.visualstudio.com" vs
+     * "dev.azure.com/<projectName>" URLs.
+     */
+    urls?: string[];
+}
+
+declare interface IRushRepositoryJsonSingleUrl extends IRushRepositoryJsonBase {
+    /**
+     * The remote url of the repository. If a value is provided,
+     * \"rush change\" will use it to find the right remote to compare against.
+     *
+     * @deprecated Use "urls" instead.
+     */
+    url?: string;
+}
+
 /**
  * @beta
  */
@@ -1429,9 +1471,9 @@ export declare class ProjectChangeAnalyzer {
      * undefined === data isn't available (i.e. - git isn't present)
      */
     private _data;
-    private _filteredData;
-    private _projectStateCache;
-    private _rushConfiguration;
+    private readonly _filteredData;
+    private readonly _projectStateCache;
+    private readonly _rushConfiguration;
     private readonly _git;
     constructor(rushConfiguration: RushConfiguration);
     /**
@@ -1459,16 +1501,10 @@ export declare class ProjectChangeAnalyzer {
     _filterProjectDataAsync<T>(project: RushConfigurationProject, unfilteredProjectData: Map<string, T>, rootDir: string, terminal: ITerminal): Promise<Map<string, T>>;
     /**
      * Gets a list of projects that have changed in the current state of the repo
-     * when compared to the specified branch.
-     */
-    getProjectsWithChangesAsync(options: IGetChangedProjectsOptions): Promise<Set<RushConfigurationProject>>;
-    /**
-     * Gets a list of projects that have changed in the current state of the repo
-     * when compared to the specified branch, taking the shrinkwrap and settings in
+     * when compared to the specified branch, optionally taking the shrinkwrap and settings in
      * the rush-project.json file into consideration.
      */
-    getProjectsImpactedByDiffAsync(options: IGetChangedProjectsOptions): Promise<Set<RushConfigurationProject>>;
-    private _getChangedProjectsInternalAsync;
+    getChangedProjectsAsync(options: IGetChangedProjectsOptions): Promise<Set<RushConfigurationProject>>;
     private _getData;
     private _getIgnoreMatcherForProjectAsync;
     private _getRepoDeps;
@@ -1620,7 +1656,7 @@ export declare class RushConfiguration {
     private _gitChangeLogUpdateCommitMessage;
     private _gitTagSeparator;
     private _hotfixChangeEnabled;
-    private _repositoryUrl;
+    private _repositoryUrls;
     private _repositoryDefaultBranch;
     private _repositoryDefaultRemote;
     private _npmOptions;
@@ -1898,9 +1934,12 @@ export declare class RushConfiguration {
      */
     get hotfixChangeEnabled(): boolean;
     /**
-     * The remote url of the repository. This helps "rush change" find the right remote to compare against.
+     * Remote URL(s) of the repository. If a value is provided, \"rush change\" will
+     * use one of these to find the right remote to compare against. Specifying multiple URLs
+     * is useful if a GitHub repository is renamed or for "<projectName>.visualstudio.com" vs
+     * "dev.azure.com/<projectName>" URLs.
      */
-    get repositoryUrl(): string | undefined;
+    get repositoryUrls(): string[];
     /**
      * The default branch name. This tells "rush change" which remote branch to compare against.
      */
@@ -2450,6 +2489,14 @@ export declare class RushConstants {
      * The name of the per-user Rush configuration data folder.
      */
     static readonly rushUserConfigurationFolderName: string;
+    /**
+     * The name of the project `rush-logs` folder.
+     */
+    static readonly rushLogsFolderName: string;
+    /**
+     * The expected prefix for phase names in "common/config/rush/command-line.json"
+     */
+    static readonly phaseNamePrefix: '_phase:';
 }
 
 /**

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;AAE3D,2CAA6B;AAC7B,oEAAuF;AAEvF,MAAM,aAAa,GAAW,qBAAqB,CAAC;AAQpD,qGAAqG;AACrG,gGAAgG;AAChG,IAAI,aAAa,GAAkC,MAAM,CAAC,uBAAuB,CAAC;AAElF,6FAA6F;AAC7F,+FAA+F;AAC/F,IAAI,aAAa,KAAK,SAAS,EAAE;IAC/B,MAAM,aAAa,GAAuB,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,0CAAE,QAAQ,CAAC;IACnE,IAAI,aAAa,KAAK,SAAS,EAAE;QAC/B,MAAM,mBAAmB,GACvB,qCAAiB,CAAC,QAAQ,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAEnE,IAAI,mBAAmB,KAAK,SAAS,EAAE;YACrC,MAAM,iBAAiB,GAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC;YAEhG,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,IAAI;oBACF,MAAM,iBAAiB,GAAW,0BAAM,CAAC,aAAa,CAAC;wBACrD,UAAU,EAAE,aAAa;wBACzB,cAAc,EAAE,mBAAmB;qBACpC,CAAC,CAAC;oBAEH,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;iBAC5C;gBAAC,OAAO,KAAK,EAAE;oBACd,6CAA6C;iBAC9C;gBAED,oFAAoF;gBACpF,qGAAqG;gBACrG,IAAI,aAAa,KAAK,SAAS,EAAE;oBAC/B,+EAA+E;oBAC/E,gEAAgE;oBAChE,MAAM,CAAC,uBAAuB,GAAG,aAAa,CAAC;iBAChD;aACF;SACF;KACF;CACF;AAED,yGAAyG;AACzG,4GAA4G;AAC5G,EAAE;AACF,sBAAsB;AACtB,IAAI,aAAa,KAAK,SAAS,EAAE;IAC/B,qGAAqG;IACrG,wGAAwG;IACxG,2CAA2C;IAC3C,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;CACxF;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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\r\n// See LICENSE in the project root for license information.\r\n\r\nimport * as path from 'path';\r\nimport { Import, IPackageJson, PackageJsonLookup } from '@rushstack/node-core-library';\r\n\r\nconst RUSH_LIB_NAME: string = '@microsoft/rush-lib';\r\n\r\ntype RushLibModuleType = Record<string, unknown>;\r\ndeclare const global: NodeJS.Global &\r\n  typeof globalThis & {\r\n    ___rush___rushLibModule?: RushLibModuleType;\r\n  };\r\n\r\n// SCENARIO 1:  Rush's PluginManager has initialized \"rush-sdk\" with Rush's own instance of rush-lib.\r\n// The Rush host process will assign \"global.___rush___rushLibModule\" before loading the plugin.\r\nlet rushLibModule: RushLibModuleType | undefined = global.___rush___rushLibModule;\r\n\r\n// SCENARIO 2:  The project importing \"rush-sdk\" has installed its own instance of \"rush-lib\"\r\n// as a package.json dependency.  For example, this is used by the Jest tests for Rush plugins.\r\nif (rushLibModule === undefined) {\r\n  const importingPath: string | undefined = module?.parent?.filename;\r\n  if (importingPath !== undefined) {\r\n    const callerPackageFolder: string | undefined =\r\n      PackageJsonLookup.instance.tryGetPackageFolderFor(importingPath);\r\n\r\n    if (callerPackageFolder !== undefined) {\r\n      const callerPackageJson: IPackageJson = require(path.join(callerPackageFolder, 'package.json'));\r\n\r\n      // Does the caller properly declare a dependency on rush-lib?\r\n      if (\r\n        (callerPackageJson.dependencies && callerPackageJson.dependencies[RUSH_LIB_NAME] !== undefined) ||\r\n        (callerPackageJson.devDependencies &&\r\n          callerPackageJson.devDependencies[RUSH_LIB_NAME] !== undefined) ||\r\n        (callerPackageJson.peerDependencies &&\r\n          callerPackageJson.peerDependencies[RUSH_LIB_NAME] !== undefined)\r\n      ) {\r\n        // Try to resolve rush-lib from the caller's folder\r\n        try {\r\n          const rushLibModulePath: string = Import.resolveModule({\r\n            modulePath: RUSH_LIB_NAME,\r\n            baseFolderPath: callerPackageFolder\r\n          });\r\n\r\n          rushLibModule = require(rushLibModulePath);\r\n        } catch (error) {\r\n          // If we fail to resolve it, ignore the error\r\n        }\r\n\r\n        // If two different libraries invoke `rush-sdk`, and one of them provides \"rush-lib\"\r\n        // then the first version to be loaded wins.  We do not support side-by-side instances of \"rush-lib\".\r\n        if (rushLibModule !== undefined) {\r\n          // TODO: When we implement Scenario 3, we should also add some diagnostic state\r\n          // to track which scenario is active and how it got initialized.\r\n          global.___rush___rushLibModule = rushLibModule;\r\n        }\r\n      }\r\n    }\r\n  }\r\n}\r\n\r\n// SCENARIO 3:  A tool or script depends on \"rush-sdk\", and is meant to be used inside a monorepo folder.\r\n// In this case, we can use install-run-rush.js to obtain the appropriate rush-lib version for the monorepo.\r\n//\r\n// NOT IMPLEMENTED YET\r\nif (rushLibModule === undefined) {\r\n  // This error indicates that a project is trying to import \"@rushstack/rush-sdk\", but the Rush engine\r\n  // instance cannot be found.  If you are writing Jest tests for a Rush plugin, add \"@microsoft/rush-lib\"\r\n  // to the devDependencies for your project.\r\n  throw new Error('The \"@rushstack/rush-sdk\" package context has not been initialized.');\r\n}\r\n\r\n// Based on TypeScript's __exportStar()\r\nfor (const property in rushLibModule) {\r\n  if (property !== 'default' && !exports.hasOwnProperty(property)) {\r\n    const rushLibModuleForClosure: RushLibModuleType = rushLibModule;\r\n\r\n    // Based on TypeScript's __createBinding()\r\n    Object.defineProperty(exports, property, {\r\n      enumerable: true,\r\n      get: function () {\r\n        return rushLibModuleForClosure[property];\r\n      }\r\n    });\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;AAE3D,2CAA6B;AAC7B,oEAAuF;AAEvF,MAAM,aAAa,GAAW,qBAAqB,CAAC;AAQpD,qGAAqG;AACrG,gGAAgG;AAChG,IAAI,aAAa,GAAkC,MAAM,CAAC,uBAAuB,CAAC;AAElF,6FAA6F;AAC7F,+FAA+F;AAC/F,IAAI,aAAa,KAAK,SAAS,EAAE;IAC/B,MAAM,aAAa,GAAuB,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,0CAAE,QAAQ,CAAC;IACnE,IAAI,aAAa,KAAK,SAAS,EAAE;QAC/B,MAAM,mBAAmB,GACvB,qCAAiB,CAAC,QAAQ,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAEnE,IAAI,mBAAmB,KAAK,SAAS,EAAE;YACrC,MAAM,iBAAiB,GAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC;YAEhG,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,IAAI;oBACF,MAAM,iBAAiB,GAAW,0BAAM,CAAC,aAAa,CAAC;wBACrD,UAAU,EAAE,aAAa;wBACzB,cAAc,EAAE,mBAAmB;qBACpC,CAAC,CAAC;oBAEH,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;iBAC5C;gBAAC,OAAO,KAAK,EAAE;oBACd,6CAA6C;iBAC9C;gBAED,oFAAoF;gBACpF,qGAAqG;gBACrG,IAAI,aAAa,KAAK,SAAS,EAAE;oBAC/B,+EAA+E;oBAC/E,gEAAgE;oBAChE,MAAM,CAAC,uBAAuB,GAAG,aAAa,CAAC;iBAChD;aACF;SACF;KACF;CACF;AAED,yGAAyG;AACzG,4GAA4G;AAC5G,EAAE;AACF,sBAAsB;AACtB,IAAI,aAAa,KAAK,SAAS,EAAE;IAC/B,qGAAqG;IACrG,wGAAwG;IACxG,2CAA2C;IAC3C,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;CACxF;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","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 { Import, IPackageJson, PackageJsonLookup } from '@rushstack/node-core-library';\n\nconst RUSH_LIB_NAME: string = '@microsoft/rush-lib';\n\ntype RushLibModuleType = Record<string, unknown>;\ndeclare const global: NodeJS.Global &\n  typeof globalThis & {\n    ___rush___rushLibModule?: RushLibModuleType;\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 = global.___rush___rushLibModule;\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 | undefined = module?.parent?.filename;\n  if (importingPath !== undefined) {\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        try {\n          const rushLibModulePath: string = Import.resolveModule({\n            modulePath: RUSH_LIB_NAME,\n            baseFolderPath: callerPackageFolder\n          });\n\n          rushLibModule = require(rushLibModulePath);\n        } catch (error) {\n          // If we fail to resolve it, ignore the error\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          // TODO: When we implement Scenario 3, we should also add some diagnostic state\n          // to track which scenario is active and how it got initialized.\n          global.___rush___rushLibModule = rushLibModule;\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.\n//\n// NOT IMPLEMENTED YET\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  throw new Error('The \"@rushstack/rush-sdk\" package context has not been initialized.');\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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rushstack/rush-sdk",
-	"version": "5.57.1",
+	"version": "5.59.0-rc.2",
 	"description": "An API for interacting with the Rush engine",
 	"repository": {
 		"type": "git",
@@ -12,15 +12,15 @@
 	"typings": "dist/rush-lib.d.ts",
 	"license": "MIT",
 	"dependencies": {
-		"@rushstack/node-core-library": "3.44.1",
+		"@rushstack/node-core-library": "3.44.3",
 		"@types/node-fetch": "1.6.9",
 		"tapable": "2.2.1"
 	},
 	"devDependencies": {
-		"@microsoft/rush-lib": "5.57.1",
-		"@rushstack/eslint-config": "2.5.0",
-		"@rushstack/heft": "0.43.1",
-		"@rushstack/heft-node-rig": "1.4.2",
+		"@microsoft/rush-lib": "5.59.0-rc.2",
+		"@rushstack/eslint-config": "2.5.1",
+		"@rushstack/heft": "0.44.1",
+		"@rushstack/heft-node-rig": "1.5.1",
 		"@types/heft-jest": "1.0.1",
 		"@types/node": "12.20.24",
 		"@types/semver": "7.3.5"