@rushstack/rush-sdk 5.69.0 → 5.70.0

package/dist/rush-lib.d.ts

@@ -817,6 +817,21 @@ declare interface IEventHooksJson {
     postRushBuild?: string[];
 }
 
+/**
+ * The `IExecutionResult` interface represents the results of executing a set of {@link Operation}s.
+ * @alpha
+ */
+export declare interface IExecutionResult {
+    /**
+     * The results for each scheduled operation.
+     */
+    readonly operationResults: ReadonlyMap<Operation, IOperationExecutionResult>;
+    /**
+     * The overall result.
+     */
+    readonly status: OperationStatus;
+}
+
 /**
  * This interface represents the raw experiments.json file which allows repo
  * maintainers to enable and disable experimental Rush features.
@@ -1024,6 +1039,33 @@ export declare class IndividualVersionPolicy extends VersionPolicy {
 export declare interface _INpmOptionsJson extends IPackageManagerOptionsJsonBase {
 }
 
+/**
+ * The `IOperationExecutionResult` interface represents the results of executing an {@link Operation}.
+ * @alpha
+ */
+export declare interface IOperationExecutionResult {
+    /**
+     * The current execution status of an operation. Operations start in the 'ready' state,
+     * but can be 'blocked' if an upstream operation failed. It is 'executing' when
+     * the operation is executing. Once execution is complete, it is either 'success' or
+     * 'failure'.
+     */
+    readonly status: OperationStatus;
+    /**
+     * The error which occurred while executing this operation, this is stored in case we need
+     * it later (for example to re-print errors at end of execution).
+     */
+    readonly error: Error | undefined;
+    /**
+     * Object tracking execution timing.
+     */
+    readonly stopwatch: IStopwatchResult;
+    /**
+     * Object used to report a summary at the end of the Rush invocation.
+     */
+    readonly stdioSummarizer: StdioSummarizer;
+}
+
 /**
  * Options for constructing a new Operation.
  * @alpha
@@ -1359,6 +1401,29 @@ declare interface IRushVariantOptionsJson {
     description: string;
 }
 
+/**
+ * Represents a readonly view of a `Stopwatch`.
+ * @alpha
+ */
+export declare interface IStopwatchResult {
+    /**
+     * Displays how long the stopwatch has been executing in a human readable format.
+     */
+    toString(): string;
+    /**
+     * Get the duration in seconds.
+     */
+    get duration(): number;
+    /**
+     * Return the start time of the most recent stopwatch run.
+     */
+    get startTime(): number | undefined;
+    /**
+     * Return the end time of the most recent stopwatch run.
+     */
+    get endTime(): number | undefined;
+}
+
 /**
  * @beta
  */
@@ -1872,6 +1937,12 @@ export declare class PhasedCommandHooks {
      * Use the context to distinguish between the initial run and phased runs.
      */
     readonly createOperations: AsyncSeriesWaterfallHook<[Set<Operation>, ICreateOperationsContext]>;
+    /**
+     * Hook invoked after executing a set of operations.
+     * Use the context to distinguish between the initial run and phased runs.
+     * Hook is series for stable output.
+     */
+    readonly afterExecuteOperations: AsyncSeriesHook<[IExecutionResult, ICreateOperationsContext]>;
     /**
      * Hook invoked after a run has finished and the command is watching for changes.
      * May be used to display additional relevant data to the user.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.69.0",
+  "version": "5.70.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
     "tapable": "2.2.1"
   },
   "devDependencies": {
-    "@microsoft/rush-lib": "5.69.0",
+    "@microsoft/rush-lib": "5.70.0",
     "@rushstack/eslint-config": "2.6.0",
     "@rushstack/heft": "0.45.2",
     "@rushstack/heft-node-rig": "1.9.3",