@rushstack/rush-sdk 5.79.0 → 5.80.0

package/dist/rush-lib.d.ts

@@ -1086,6 +1086,10 @@ export declare interface IOperationExecutionResult {
      * Object used to report a summary at the end of the Rush invocation.
      */
     readonly stdioSummarizer: StdioSummarizer;
+    /**
+     * The value indicates the duration of the same operation without cache hit.
+     */
+    readonly nonCachedDurationMs: number | undefined;
 }
 
 /**
@@ -1169,6 +1173,31 @@ export declare interface IOperationRunnerContext {
      * Object used to report a summary at the end of the Rush invocation.
      */
     stdioSummarizer: StdioSummarizer;
+    /**
+     * Object used to record state of the operation.
+     *
+     * @internal
+     */
+    _operationStateFile?: _OperationStateFile;
+    /**
+     * Object used to track elapsed time.
+     */
+    stopwatch: IStopwatchResult;
+}
+
+/**
+ * @internal
+ */
+export declare interface _IOperationStateFileOptions {
+    rushProject: RushConfigurationProject;
+    phase: IPhase;
+}
+
+/**
+ * @internal
+ */
+export declare interface _IOperationStateJson {
+    nonCachedDurationMs: number;
 }
 
 /**
@@ -1478,7 +1507,7 @@ declare interface IRushVariantOptionsJson {
 
 /**
  * Represents a readonly view of a `Stopwatch`.
- * @alpha
+ * @beta
  */
 export declare interface IStopwatchResult {
     /**
@@ -1595,6 +1624,10 @@ export declare interface ITelemetryOperationResult {
      * If the operation was blocked, will be `undefined`.
      */
     endTimestampMs?: number;
+    /**
+     * Duration in milliseconds when the operation does not hit cache
+     */
+    nonCachedDurationMs?: number;
 }
 
 /**
@@ -1666,7 +1699,7 @@ export declare class _LastInstallFlag {
      *
      * @internal
      */
-    checkValidAndReportStoreIssues(): boolean;
+    checkValidAndReportStoreIssues(rushVerb: string): boolean;
     private _isValid;
     /**
      * Writes the flag file to disk with the current state
@@ -1907,6 +1940,32 @@ export declare class Operation {
     deleteDependency(dependency: Operation): void;
 }
 
+/**
+ * A helper class for managing the state file of a operation.
+ *
+ * @internal
+ */
+export declare class _OperationStateFile {
+    private readonly _rushProject;
+    private readonly _filename;
+    private _state;
+    constructor(options: _IOperationStateFileOptions);
+    private static _getFilename;
+    /**
+     * ProjectBuildCache expects the relative path for better logging
+     *
+     * @internal
+     */
+    static getFilenameRelativeToProjectRoot(phase: IPhase): string;
+    /**
+     * Returns the filename of the metadata file.
+     */
+    get filename(): string;
+    get state(): _IOperationStateJson | undefined;
+    writeAsync(json: _IOperationStateJson): Promise<void>;
+    tryRestoreAsync(): Promise<_IOperationStateJson | undefined>;
+}
+
 /**
  * Enumeration defining potential states of an operation
  * @beta

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.79.0",
+  "version": "5.80.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -12,18 +12,18 @@
   "typings": "dist/rush-lib.d.ts",
   "license": "MIT",
   "dependencies": {
-    "@rushstack/node-core-library": "3.52.0",
+    "@rushstack/node-core-library": "3.53.0",
     "@types/node-fetch": "1.6.9",
     "tapable": "2.2.1"
   },
   "devDependencies": {
-    "@microsoft/rush-lib": "5.79.0",
-    "@rushstack/eslint-config": "3.0.1",
-    "@rushstack/heft": "0.47.10",
-    "@rushstack/heft-node-rig": "1.10.12",
-    "@rushstack/stream-collator": "4.0.205",
-    "@rushstack/ts-command-line": "4.12.3",
-    "@rushstack/terminal": "0.3.74",
+    "@microsoft/rush-lib": "5.80.0",
+    "@rushstack/eslint-config": "3.1.0",
+    "@rushstack/heft": "0.48.0",
+    "@rushstack/heft-node-rig": "1.11.0",
+    "@rushstack/stream-collator": "4.0.207",
+    "@rushstack/ts-command-line": "4.12.4",
+    "@rushstack/terminal": "0.3.76",
     "@types/heft-jest": "1.0.1",
     "@types/semver": "7.3.5",
     "@types/webpack-env": "1.13.0"