@rushstack/rush-sdk 5.125.0 → 5.126.0

package/lib/cli/actions/ChangeAction.d.ts

@@ -18,10 +18,10 @@ export declare class ChangeAction extends BaseRushAction {
     runAsync(): Promise<void>;
     private _generateHostMap;
     private _verifyAsync;
-    private get _targetBranch();
+    private _getTargetBranchAsync;
     private _getChangedProjectNamesAsync;
-    private _validateChangeFile;
-    private _getChangeFiles;
+    private _validateChangeFileAsync;
+    private _getChangeFilesAsync;
     /**
      * The main loop which prompts the user for information on changed projects.
      */
@@ -48,7 +48,7 @@ export declare class ChangeAction extends BaseRushAction {
      * Asks the user for their email address
      */
     private _promptForEmailAsync;
-    private _warnUnstagedChanges;
+    private _warnUnstagedChangesAsync;
     /**
      * Writes change files to the common/changes folder. Will prompt for overwrite if file already exists.
      */
@@ -60,6 +60,6 @@ export declare class ChangeAction extends BaseRushAction {
      */
     private _writeFile;
     private _logNoChangeFileRequired;
-    private _stageAndCommitGitChanges;
+    private _stageAndCommitGitChangesAsync;
 }
 //# sourceMappingURL=ChangeAction.d.ts.map

package/lib/cli/actions/PublishAction.d.ts

@@ -35,11 +35,11 @@ export declare class PublishAction extends BaseRushAction {
      */
     private _validate;
     private _publishChangesAsync;
-    private _publishAll;
-    private _gitAddTags;
-    private _npmPublish;
-    private _packageExists;
-    private _npmPack;
+    private _publishAllAsync;
+    private _gitAddTagsAsync;
+    private _npmPublishAsync;
+    private _packageExistsAsync;
+    private _npmPackAsync;
     private _calculateTarballName;
     private _setDependenciesBeforePublish;
     private _setDependenciesBeforeCommit;

package/lib/cli/actions/VersionAction.d.ts

@@ -17,6 +17,6 @@ export declare class VersionAction extends BaseRushAction {
     private _overwritePolicyVersionIfNeeded;
     private _validateInput;
     private _validateResult;
-    private _gitProcess;
+    private _gitProcessAsync;
 }
 //# sourceMappingURL=VersionAction.d.ts.map

package/lib/index.d.ts

@@ -3,57 +3,57 @@
  * @packageDocumentation
  */
 export { ApprovedPackagesPolicy } from './api/ApprovedPackagesPolicy';
-export { RushConfiguration, ITryFindRushJsonLocationOptions } from './api/RushConfiguration';
+export { RushConfiguration, type ITryFindRushJsonLocationOptions } from './api/RushConfiguration';
 export { Subspace } from './api/Subspace';
 export { SubspacesConfiguration } from './api/SubspacesConfiguration';
-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, PnpmStoreLocation, IPnpmLockfilePolicies, IPnpmPackageExtension, IPnpmPeerDependencyRules, IPnpmPeerDependenciesMeta, PnpmStoreOptions, PnpmOptionsConfiguration, PnpmResolutionMode } from './logic/pnpm/PnpmOptionsConfiguration';
+export { type IPackageManagerOptionsJsonBase, type IConfigurationEnvironment, type IConfigurationEnvironmentVariable, PackageManagerOptionsConfigurationBase } from './logic/base/BasePackageManagerOptionsConfiguration';
+export { type INpmOptionsJson as _INpmOptionsJson, NpmOptionsConfiguration } from './logic/npm/NpmOptionsConfiguration';
+export { type IYarnOptionsJson as _IYarnOptionsJson, YarnOptionsConfiguration } from './logic/yarn/YarnOptionsConfiguration';
+export { type IPnpmOptionsJson as _IPnpmOptionsJson, type PnpmStoreLocation, type IPnpmLockfilePolicies, type IPnpmPackageExtension, type IPnpmPeerDependencyRules, type IPnpmPeerDependenciesMeta, type PnpmStoreOptions, PnpmOptionsConfiguration, type PnpmResolutionMode } from './logic/pnpm/PnpmOptionsConfiguration';
 export { BuildCacheConfiguration } from './api/BuildCacheConfiguration';
-export { CobuildConfiguration, ICobuildJson } from './api/CobuildConfiguration';
-export { GetCacheEntryIdFunction, IGenerateCacheEntryIdOptions } from './logic/buildCache/CacheEntryId';
-export { FileSystemBuildCacheProvider, IFileSystemBuildCacheProviderOptions } from './logic/buildCache/FileSystemBuildCacheProvider';
-export { IPhase, PhaseBehaviorForMissingScript as IPhaseBehaviorForMissingScript } from './api/CommandLineConfiguration';
-export { EnvironmentConfiguration, EnvironmentVariableNames, IEnvironmentConfigurationInitializeOptions } from './api/EnvironmentConfiguration';
+export { CobuildConfiguration, type ICobuildJson } from './api/CobuildConfiguration';
+export type { GetCacheEntryIdFunction, IGenerateCacheEntryIdOptions } from './logic/buildCache/CacheEntryId';
+export { FileSystemBuildCacheProvider, type IFileSystemBuildCacheProviderOptions } from './logic/buildCache/FileSystemBuildCacheProvider';
+export type { IPhase, PhaseBehaviorForMissingScript as IPhaseBehaviorForMissingScript } from './api/CommandLineConfiguration';
+export { EnvironmentConfiguration, EnvironmentVariableNames, type IEnvironmentConfigurationInitializeOptions } from './api/EnvironmentConfiguration';
 export { RushConstants } from './logic/RushConstants';
-export { PackageManagerName, PackageManager } from './api/packageManager/PackageManager';
+export { type PackageManagerName, PackageManager } from './api/packageManager/PackageManager';
 export { RushConfigurationProject } from './api/RushConfigurationProject';
-export { IRushProjectJson as _IRushProjectJson, IOperationSettings, RushProjectConfiguration, IRushPhaseSharding } from './api/RushProjectConfiguration';
+export { type IRushProjectJson as _IRushProjectJson, type IOperationSettings, RushProjectConfiguration, type IRushPhaseSharding } from './api/RushProjectConfiguration';
 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, PackageJsonDependencyMeta } from './api/PackageJsonEditor';
 export { RepoStateFile } from './logic/RepoStateFile';
-export { LookupByPath, IPrefixMatch } from './logic/LookupByPath';
+export { LookupByPath, type IPrefixMatch } from './logic/LookupByPath';
 export { EventHooks, Event } from './api/EventHooks';
 export { ChangeManager } from './api/ChangeManager';
 export { FlagFile as _FlagFile } from './api/FlagFile';
 export { VersionPolicyDefinitionName, BumpType, LockStepVersionPolicy, IndividualVersionPolicy, VersionPolicy } from './api/VersionPolicy';
 export { VersionPolicyConfiguration } from './api/VersionPolicyConfiguration';
-export { ILaunchOptions, Rush } from './api/Rush';
+export { type ILaunchOptions, Rush } from './api/Rush';
 export { RushInternals as _RushInternals } from './api/RushInternals';
-export { ExperimentsConfiguration, IExperimentsJson } from './api/ExperimentsConfiguration';
-export { CustomTipsConfiguration, CustomTipId, ICustomTipsJson, ICustomTipInfo, ICustomTipItemJson, CustomTipSeverity, CustomTipType } from './api/CustomTipsConfiguration';
-export { ProjectChangeAnalyzer, IGetChangedProjectsOptions, IRawRepoState as _IRawRepoState } 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 { ExperimentsConfiguration, type IExperimentsJson } from './api/ExperimentsConfiguration';
+export { CustomTipsConfiguration, CustomTipId, type ICustomTipsJson, type ICustomTipInfo, type ICustomTipItemJson, CustomTipSeverity, CustomTipType } from './api/CustomTipsConfiguration';
+export { ProjectChangeAnalyzer, type IGetChangedProjectsOptions, type IRawRepoState as _IRawRepoState } from './logic/ProjectChangeAnalyzer';
+export type { IOperationRunner, IOperationRunnerContext } from './logic/operations/IOperationRunner';
+export type { IExecutionResult, IOperationExecutionResult } from './logic/operations/IOperationExecutionResult';
+export { type IOperationOptions, Operation } from './logic/operations/Operation';
 export { OperationStatus } from './logic/operations/OperationStatus';
-export { RushSession, IRushSessionOptions, CloudBuildCacheProviderFactory, CobuildLockProviderFactory } from './pluginFramework/RushSession';
-export { IRushCommand, IGlobalCommand, IPhasedCommand, RushLifecycleHooks } from './pluginFramework/RushLifeCycle';
-export { ICreateOperationsContext, IExecuteOperationsContext, 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 { ICobuildLockProvider, ICobuildContext, ICobuildCompletedState } from './logic/cobuild/ICobuildLockProvider';
-export { ICredentialCacheOptions, ICredentialCacheEntry, CredentialCache } from './logic/CredentialCache';
+export { RushSession, type IRushSessionOptions, type CloudBuildCacheProviderFactory, type CobuildLockProviderFactory } from './pluginFramework/RushSession';
+export { type IRushCommand, type IGlobalCommand, type IPhasedCommand, RushLifecycleHooks } from './pluginFramework/RushLifeCycle';
+export { type ICreateOperationsContext, type IExecuteOperationsContext, PhasedCommandHooks } from './pluginFramework/PhasedCommandHooks';
+export type { IRushPlugin } from './pluginFramework/IRushPlugin';
+export type { IBuiltInPluginConfiguration as _IBuiltInPluginConfiguration } from './pluginFramework/PluginLoader/BuiltInPluginLoader';
+export type { IRushPluginConfigurationBase as _IRushPluginConfigurationBase } from './api/RushPluginsConfiguration';
+export type { ILogger } from './pluginFramework/logging/Logger';
+export type { ICloudBuildCacheProvider } from './logic/buildCache/ICloudBuildCacheProvider';
+export type { ICobuildLockProvider, ICobuildContext, ICobuildCompletedState } from './logic/cobuild/ICobuildLockProvider';
+export { type ICredentialCacheOptions, type 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 type { IStopwatchResult } from './utilities/Stopwatch';
+export { OperationStateFile as _OperationStateFile, type IOperationStateFileOptions as _IOperationStateFileOptions, type IOperationStateJson as _IOperationStateJson } from './logic/operations/OperationStateFile';
+export { OperationMetadataManager as _OperationMetadataManager, type IOperationMetadataManagerOptions as _IOperationMetadataManagerOptions, type IOperationMetaData as _IOperationMetadata } from './logic/operations/OperationMetadataManager';
 export { RushCommandLine, type IRushCommandLineSpec, type IRushCommandLineParameter, type IRushCommandLineAction } from './api/RushCommandLine';
 //# sourceMappingURL=index.d.ts.map

package/lib/logic/Git.d.ts

@@ -31,31 +31,31 @@ export declare class Git {
      * the result of `this.getGitInfo()` is used.
      */
     isPathUnderGitWorkingTree(repoInfo?: gitInfo.GitRepoInfo): boolean;
-    /**
-     * If a Git email address is configured and is nonempty, this returns it.
-     * Otherwise, undefined is returned.
-     */
-    tryGetGitEmail(): string | undefined;
     /**
      * If a Git email address is configured and is nonempty, this returns it.
      * Otherwise, configuration instructions are printed to the console,
      * and AlreadyReportedError is thrown.
      */
-    getGitEmail(): string;
+    getGitEmailAsync(): Promise<string>;
+    /**
+     * If the Git email address is configured and non-empty, this returns it. Otherwise
+     * it prints an error message and throws.
+     */
+    validateGitEmail(userEmail: string | undefined): string;
     /**
      * Get the folder where Git hooks should go for the current working tree.
      * Returns undefined if the current path is not under a Git working tree.
      */
     getHooksFolder(): string | undefined;
-    isHooksPathDefault(): boolean;
-    getConfigHooksPath(): string;
+    getIsHooksPathDefaultAsync(): Promise<boolean>;
+    getConfigHooksPathAsync(): Promise<string>;
     /**
      * Get information about the current Git working tree.
      * Returns undefined if rush.json is not under a Git working tree.
      */
     getGitInfo(): Readonly<gitInfo.GitRepoInfo> | undefined;
-    getMergeBase(targetBranch: string, terminal: ITerminal, shouldFetch?: boolean): string;
-    getBlobContent({ blobSpec, repositoryRoot }: IGetBlobOptions): string;
+    getMergeBaseAsync(targetBranch: string, terminal: ITerminal, shouldFetch?: boolean): Promise<string>;
+    getBlobContentAsync({ blobSpec, repositoryRoot }: IGetBlobOptions): Promise<string>;
     /**
      * @param pathPrefix - An optional path prefix "git diff"s should be filtered by.
      * @returns
@@ -63,7 +63,7 @@ export declare class Git {
      * those in the provided {@param targetBranch}. If a {@param pathPrefix} is provided,
      * this function only returns results under the that path.
      */
-    getChangedFiles(targetBranch: string, terminal: ITerminal, skipFetch?: boolean, pathPrefix?: string): string[];
+    getChangedFilesAsync(targetBranch: string, terminal: ITerminal, skipFetch?: boolean, pathPrefix?: string): Promise<string[]>;
     /**
      * Gets the remote default branch that maps to the provided repository url.
      * This method is used by 'Rush change' to find the default remote branch to compare against.
@@ -73,15 +73,15 @@ export declare class Git {
      *
      * @param rushConfiguration - rush configuration
      */
-    getRemoteDefaultBranch(): string;
-    hasUncommittedChanges(): boolean;
-    hasUnstagedChanges(): boolean;
+    getRemoteDefaultBranchAsync(): Promise<string>;
+    hasUncommittedChangesAsync(): Promise<boolean>;
+    hasUnstagedChangesAsync(): Promise<boolean>;
     /**
      * The list of files changed but not committed
      */
-    getUncommittedChanges(): ReadonlyArray<string>;
+    getUncommittedChangesAsync(): Promise<ReadonlyArray<string>>;
     getTagSeparator(): string;
-    getGitStatus(): Iterable<IGitStatusEntry>;
+    getGitStatusAsync(): Promise<Iterable<IGitStatusEntry>>;
     /**
      * Git remotes can use different URL syntaxes; this converts them all to a normalized HTTPS
      * representation for matching purposes.  IF THE INPUT IS NOT ALREADY HTTPS, THE OUTPUT IS
@@ -91,18 +91,22 @@ export declare class Git {
      * `git@github.com:ExampleOrg/ExampleProject.git` --> `https://github.com/ExampleOrg/ExampleProject`
      */
     static normalizeGitUrlForComparison(gitUrl: string): string;
-    private _tryGetGitEmail;
-    private _tryGetGitHooksPath;
+    /**
+     * Returns an object containing either the result of the `git config user.email`
+     * command or an error.
+     */
+    tryGetGitEmailAsync(): Promise<string | undefined>;
+    private _tryGetGitHooksPathAsync;
     private _tryFetchRemoteBranch;
     private _fetchRemoteBranch;
     /**
      * @internal
      */
-    _executeGitCommandAndCaptureOutput(gitPath: string, args: string[], repositoryRoot?: string): string;
+    _executeGitCommandAndCaptureOutputAsync(gitPath: string, args: string[], repositoryRoot?: string): Promise<string>;
     /**
      *
      * @param ref Given a ref which can be branch name, commit hash, tag name, etc, check if it is a commit hash
      */
-    isRefACommit(ref: string): boolean;
+    determineIfRefIsACommitAsync(ref: string): Promise<boolean>;
 }
 //# sourceMappingURL=Git.d.ts.map

package/lib/logic/PackageJsonUpdaterTypes.d.ts

@@ -2,7 +2,7 @@ import type { RushConfigurationProject } from '../api/RushConfigurationProject';
 /**
  * The type of SemVer range specifier that is prepended to the version
  */
-export declare const enum SemVerStyle {
+export declare enum SemVerStyle {
     Exact = "exact",
     Caret = "caret",
     Tilde = "tilde",

package/lib/logic/PublishGit.d.ts

@@ -5,15 +5,15 @@ export declare class PublishGit {
     private readonly _gitPath;
     private readonly _gitTagSeparator;
     constructor(git: Git, targetBranch: string | undefined);
-    checkout(branchName: string | undefined, createBranch?: boolean): void;
-    merge(branchName: string, verify?: boolean): void;
-    deleteBranch(branchName: string | undefined, hasRemote?: boolean, verify?: boolean): void;
-    pull(verify?: boolean): void;
-    fetch(): void;
-    addChanges(pathspec?: string, workingDirectory?: string): void;
-    addTag(shouldExecute: boolean, packageName: string, packageVersion: string, commitId: string | undefined, preReleaseName?: string): void;
-    hasTag(packageConfig: RushConfigurationProject): boolean;
-    commit(commitMessage: string, verify?: boolean): void;
-    push(branchName: string | undefined, verify?: boolean): void;
+    checkoutAsync(branchName: string | undefined, createBranch?: boolean): Promise<void>;
+    mergeAsync(branchName: string, verify?: boolean): Promise<void>;
+    deleteBranchAsync(branchName: string | undefined, hasRemote?: boolean, verify?: boolean): Promise<void>;
+    pullAsync(verify?: boolean): Promise<void>;
+    fetchAsync(): Promise<void>;
+    addChangesAsync(pathspec?: string, workingDirectory?: string): Promise<void>;
+    addTagAsync(shouldExecute: boolean, packageName: string, packageVersion: string, commitId: string | undefined, preReleaseName?: string): Promise<void>;
+    hasTagAsync(packageConfig: RushConfigurationProject): Promise<boolean>;
+    commitAsync(commitMessage: string, verify?: boolean): Promise<void>;
+    pushAsync(branchName: string | undefined, verify?: boolean): Promise<void>;
 }
 //# sourceMappingURL=PublishGit.d.ts.map

package/lib/logic/PublishUtilities.d.ts

@@ -38,7 +38,7 @@ export declare class PublishUtilities {
      * @param secretSubstring -- if specified, a substring to be replaced by `<<SECRET>>` to avoid printing secrets
      * on the console
      */
-    static execCommand(shouldExecute: boolean, command: string, args?: string[], workingDirectory?: string, environment?: IEnvironment, secretSubstring?: string): void;
+    static execCommandAsync(shouldExecute: boolean, command: string, args?: string[], workingDirectory?: string, environment?: IEnvironment, secretSubstring?: string): Promise<void>;
     static getNewDependencyVersion(dependencies: {
         [key: string]: string;
     }, dependencyName: string, newProjectVersion: string): string;

package/lib/logic/operations/CacheableOperationPlugin.d.ts

@@ -47,9 +47,8 @@ export declare class CacheableOperationPlugin implements IPhasedCommandPlugin {
     private _tryGetProjectBuildCacheAsync;
     private _tryGetLogOnlyProjectBuildCacheAsync;
     private _tryGetCobuildLockAsync;
-    private _getBuildCacheTerminal;
-    private _createBuildCacheTerminal;
-    private _tryGetBuildCacheProjectLogWritable;
+    private _createBuildCacheTerminalAsync;
+    private _tryGetBuildCacheProjectLogWritableAsync;
 }
 export declare function clusterOperations(initialClusters: DisjointSet<Operation>, operationBuildCacheMap: Map<Operation, {
     cacheDisabledReason: string | undefined;

package/lib/logic/operations/ProjectLogWritable.d.ts

@@ -1,6 +1,26 @@
 import { TerminalWritable, type ITerminalChunk } from '@rushstack/terminal';
 import type { CollatedTerminal } from '@rushstack/stream-collator';
 import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
+export interface IProjectLogWritableOptions {
+    project: RushConfigurationProject;
+    terminal: CollatedTerminal;
+    logFilenameIdentifier: string;
+    enableChunkedOutput?: boolean;
+}
+export interface ILogFilePaths {
+    logFolderPath: string;
+    logChunksFolderPath: string;
+    logPath: string;
+    logChunksPath: string;
+    errorLogPath: string;
+    relativeLogPath: string;
+    relativeErrorLogPath: string;
+    relativeLogChunksPath: string;
+}
+export interface IGetLogFilePathsOptions {
+    project: RushConfigurationProject;
+    logFilenameIdentifier: string;
+}
 export declare class ProjectLogWritable extends TerminalWritable {
     private readonly _terminal;
     readonly logPath: string;
@@ -38,21 +58,9 @@ export declare class ProjectLogWritable extends TerminalWritable {
      */
     private _chunkWriter;
     private _enableChunkedOutput;
-    constructor(project: RushConfigurationProject, terminal: CollatedTerminal, logFilenameIdentifier: string, options?: {
-        enableChunkedOutput?: boolean;
-    });
-    static getLogFilePaths({ project, logFilenameIdentifier, isLegacyLog }: {
-        project: RushConfigurationProject;
-        logFilenameIdentifier: string;
-        isLegacyLog?: boolean;
-    }): {
-        logPath: string;
-        logChunksPath: string;
-        errorLogPath: string;
-        relativeLogPath: string;
-        relativeErrorLogPath: string;
-        relativeLogChunksPath: string;
-    };
+    private constructor();
+    static initializeAsync({ project, terminal, logFilenameIdentifier, enableChunkedOutput }: IProjectLogWritableOptions): Promise<ProjectLogWritable>;
+    static getLogFilePaths({ project: { projectFolder, packageName }, logFilenameIdentifier }: IGetLogFilePathsOptions): ILogFilePaths;
     writeChunk(chunk: ITerminalChunk): void;
     protected onWriteChunk(chunk: ITerminalChunk): void;
     protected onClose(): void;

package/lib/logic/policy/GitEmailPolicy.d.ts

@@ -1,5 +1,5 @@
 import type { RushConfiguration } from '../../api/RushConfiguration';
 import type { IPolicyValidatorOptions } from './PolicyValidator';
-export declare function validate(rushConfiguration: RushConfiguration, options: IPolicyValidatorOptions): void;
+export declare function validateAsync(rushConfiguration: RushConfiguration, options: IPolicyValidatorOptions): Promise<void>;
 export declare function getEmailExampleLines(rushConfiguration: RushConfiguration): string[];
 //# sourceMappingURL=GitEmailPolicy.d.ts.map

package/lib/utilities/Npm.d.ts

@@ -1,6 +1,6 @@
 export declare class Npm {
-    static publishedVersions(packageName: string, cwd: string, env: {
+    static getPublishedVersionsAsync(packageName: string, cwd: string, env: {
         [key: string]: string | undefined;
-    }, extraArgs?: string[]): string[];
+    }, extraArgs?: string[]): Promise<string[]>;
 }
 //# sourceMappingURL=Npm.d.ts.map

package/lib/utilities/Utilities.d.ts

@@ -1,5 +1,4 @@
 /// <reference types="node" />
-/// <reference types="node" />
 import * as child_process from 'child_process';
 import type { RushConfiguration } from '../api/RushConfiguration';
 import { syncNpmrc } from './npmrcUtilities';
@@ -9,7 +8,7 @@ export interface IEnvironment {
     [environmentVariableName: string]: string | undefined;
 }
 /**
- * Options for Utilities.executeCommand().
+ * Options for {@link Utilities.executeCommandAsync}.
  */
 export interface IExecuteCommandOptions {
     command: string;
@@ -18,9 +17,13 @@ export interface IExecuteCommandOptions {
     environment?: IEnvironment;
     suppressOutput?: boolean;
     keepEnvironment?: boolean;
+    /**
+     * Note that this takes precedence over {@link IExecuteCommandOptions.suppressOutput}
+     */
+    onStdoutStreamChunk?: (chunk: string) => string | void;
 }
 /**
- * Options for Utilities.installPackageInDirectory().
+ * Options for {@link Utilities.installPackageInDirectoryAsync}.
  */
 export interface IInstallPackageInDirectoryOptions {
     directory: string;
@@ -120,30 +123,16 @@ export declare class Utilities {
      * 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 executeCommand(options: IExecuteCommandOptions): void;
+    static executeCommandAsync({ command, args, workingDirectory, suppressOutput, onStdoutStreamChunk, environment, keepEnvironment }: IExecuteCommandOptions): Promise<void>;
     /**
      * 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.
-     *
-     * It's basically the same as executeCommand() except that it returns a Promise.
      */
-    static executeCommandAndInspectOutputAsync(options: IExecuteCommandOptions, onStdoutStreamChunk?: (chunk: string) => string | void, onExit?: (exitCode: number | null, signal: NodeJS.Signals | null) => void): Promise<void>;
-    /**
-     * 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 executeCommandAndCaptureOutput(command: string, args: string[], workingDirectory: string, environment?: IEnvironment, keepEnvironment?: boolean): string;
+    static executeCommandAndCaptureOutputAsync(command: string, args: string[], workingDirectory: string, environment?: IEnvironment, keepEnvironment?: boolean): Promise<string>;
     /**
      * Attempts to run Utilities.executeCommand() up to maxAttempts times before giving up.
      */
-    static executeCommandWithRetry(options: IExecuteCommandOptions, maxAttempts: number, retryCallback?: () => void): void;
-    /**
-     * Attempts to run Utilities.executeCommand() up to maxAttempts times before giving up.
-     * Using `onStdoutStreamChunk` to process the output of the command.
-     *
-     * Note: This is similar to {@link executeCommandWithRetry} except that it returns a Promise and provides a callback to process the output.
-     */
-    static executeCommandAndProcessOutputWithRetryAsync(options: IExecuteCommandOptions, maxAttempts: number, onStdoutStreamChunk?: (chunk: string) => string | void, retryCallback?: () => void): Promise<void>;
+    static executeCommandWithRetryAsync(options: IExecuteCommandOptions, maxAttempts: number, retryCallback?: () => void): Promise<void>;
     /**
      * 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
@@ -166,7 +155,7 @@ export declare class Utilities {
     /**
      * Installs a package by name and version in the specified directory.
      */
-    static installPackageInDirectory(options: IInstallPackageInDirectoryOptions): void;
+    static installPackageInDirectoryAsync({ packageName, version, tempPackageTitle, commonRushConfigFolder, maxInstallAttempts, suppressOutput, directory }: IInstallPackageInDirectoryOptions): Promise<void>;
     /**
      * Copies the file "sourcePath" to "destinationPath", overwriting the target file location.
      * If the source file does not exist, then the target file is deleted.
@@ -196,18 +185,11 @@ export declare class Utilities {
      * "/foobar/node_modules/.bin:/bin"
      */
     private static _prependNodeModulesBinToPath;
-    /**
-     * 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.
-     *
-     * It's the same as _executeCommandInternal except that it returns a promise.
-     */
-    private static _executeCommandAndInspectOutputInternalAsync;
     /**
      * 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.
      */
-    private static _executeCommandInternal;
+    private static _executeCommandInternalAsync;
     private static _processResult;
 }
 //# sourceMappingURL=Utilities.d.ts.map

package/{dist → lib-shim}/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.44.1"
+      "packageVersion": "7.46.2"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.125.0",
+  "version": "5.126.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -25,17 +25,17 @@
   "dependencies": {
     "@types/node-fetch": "2.6.2",
     "tapable": "2.2.1",
-    "@rushstack/node-core-library": "5.1.0",
-    "@rushstack/terminal": "0.12.0"
+    "@rushstack/node-core-library": "5.4.1",
+    "@rushstack/terminal": "0.13.0"
   },
   "devDependencies": {
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.0",
-    "@rushstack/heft": "0.66.12",
+    "@rushstack/ts-command-line": "4.22.0",
+    "@rushstack/heft": "0.66.17",
+    "@microsoft/rush-lib": "5.126.0",
     "local-node-rig": "1.0.0",
-    "@microsoft/rush-lib": "5.125.0",
-    "@rushstack/stream-collator": "4.1.50",
-    "@rushstack/ts-command-line": "4.21.2"
+    "@rushstack/stream-collator": "4.1.55"
   },
   "scripts": {
     "build": "heft build --clean",