@rushstack/rush-http-build-cache-plugin 5.109.1 → 5.110.0

package/.rush/temp/operation/_phase_build/all.log

@@ -1,6 +1,6 @@
-Invoking: heft run --only build -- --clean --production
- ---- build started ---- 
-[build:typescript] Using TypeScript version 5.0.4
-[build:typescript] Copied 1 folder or file and linked 0 files
- ---- build finished (7.587s) ---- 
--------------------- Finished (7.593s) --------------------
+Invoking: heft run --only build -- --clean --production
+ ---- build started ---- 
+[build:typescript] Using TypeScript version 5.0.4
+[build:typescript] Copied 1 folder or file and linked 0 files
+ ---- build finished (4.156s) ---- 
+-------------------- Finished (4.163s) --------------------

package/.rush/temp/operation/_phase_build/state.json

@@ -1,3 +1,3 @@
 {
-  "nonCachedDurationMs": 8144.625750000124
+  "nonCachedDurationMs": 4615.885499999975
 }

package/.rush/temp/operation/_phase_test/all.log

@@ -1,15 +1,15 @@
-Invoking: heft run --only test -- --clean --production
-The provided list of phases does not contain all phase dependencies. You may need to run the excluded phases manually.
- ---- test started ---- 
-[test:jest] Using Jest version 29.5.0
-[test:jest] 
-[test:jest] Run start. 1 test suite
-[test:jest] START lib/test/HttpBuildCacheProvider.test.js
-[test:jest] PASS lib/test/HttpBuildCacheProvider.test.js (duration: 0.952s, 2 passed, 0 failed)
-[test:jest] 
-[test:jest] Tests finished:
-[test:jest]   Successes: 2
-[test:jest]   Failures: 0
-[test:jest]   Total: 2
- ---- test finished (1.852s) ---- 
--------------------- Finished (1.859s) --------------------
+Invoking: heft run --only test -- --clean --production
+The provided list of phases does not contain all phase dependencies. You may need to run the excluded phases manually.
+ ---- test started ---- 
+[test:jest] Using Jest version 29.5.0
+[test:jest] 
+[test:jest] Run start. 1 test suite
+[test:jest] START lib\test\HttpBuildCacheProvider.test.js
+[test:jest] PASS lib\test\HttpBuildCacheProvider.test.js (duration: 0.976s, 2 passed, 0 failed)
+[test:jest] 
+[test:jest] Tests finished:
+[test:jest]   Successes: 2
+[test:jest]   Failures: 0
+[test:jest]   Total: 2
+ ---- test finished (1.860s) ---- 
+-------------------- Finished (1.866s) --------------------

package/.rush/temp/operation/_phase_test/state.json

@@ -1,3 +1,3 @@
 {
-  "nonCachedDurationMs": 2474.0941769999918
+  "nonCachedDurationMs": 2334.1952000000747
 }

package/.rush/temp/{rushstack+rush-http-build-cache-plugin-_phase_build-7d401680bf3bf0eed7a5fd5643898d15e32a9b69.tar.log → rushstack+rush-http-build-cache-plugin-_phase_build-6123140279635b4e69641307e04c82615d4a5778.tar.log}

@@ -1,5 +1,5 @@
-Start time: Sat Oct 07 2023 01:09:03 GMT+0000 (Coordinated Universal Time)
-Invoking "/usr/bin/tar -c -f /home/vsts/work/1/s/common/temp/build-cache/rushstack+rush-http-build-cache-plugin-_phase_build-7d401680bf3bf0eed7a5fd5643898d15e32a9b69-5a592f374c5bfc38.temp -z --files-from=-"
+Start time: Mon Oct 30 2023 23:21:22 GMT+0000 (Coordinated Universal Time)
+Invoking "C:\Windows\system32\tar.exe -c -f D:\a\_work\1\s\common\temp\build-cache\rushstack+rush-http-build-cache-plugin-_phase_build-6123140279635b4e69641307e04c82615d4a5778-2af28b40a6505109.temp -z --files-from=-"
 
 ======= BEGIN PROCESS INPUT ======
 .rush/temp/operation/_phase_build/all.log

package/.rush/temp/rushstack+rush-http-build-cache-plugin-_phase_build-6123140279635b4e69641307e04c82615d4a5778.untar.log

@@ -0,0 +1,10 @@
+Start time: Mon Oct 30 2023 23:36:29 GMT+0000 (Coordinated Universal Time)
+Invoking "C:\Windows\system32\tar.exe -x -m -f D:\a\_work\1\s\common\temp\build-cache\rushstack+rush-http-build-cache-plugin-_phase_build-6123140279635b4e69641307e04c82615d4a5778"
+
+======= BEGIN PROCESS INPUT ======
+
+======== END PROCESS INPUT =======
+======= BEGIN PROCESS OUTPUT =======
+======== END PROCESS OUTPUT ========
+
+Exited with code "0"

package/.rush/temp/{rushstack+rush-http-build-cache-plugin-_phase_test-feaedf2fd3e8683d195ad4842d74adbfdde78aee.tar.log → rushstack+rush-http-build-cache-plugin-_phase_test-78333a9310f75472822f70554dee637804eb3b97.tar.log}

@@ -1,5 +1,5 @@
-Start time: Sat Oct 07 2023 01:10:22 GMT+0000 (Coordinated Universal Time)
-Invoking "/usr/bin/tar -c -f /home/vsts/work/1/s/common/temp/build-cache/rushstack+rush-http-build-cache-plugin-_phase_test-feaedf2fd3e8683d195ad4842d74adbfdde78aee-1e49e6410b7dac39.temp -z --files-from=-"
+Start time: Mon Oct 30 2023 23:23:10 GMT+0000 (Coordinated Universal Time)
+Invoking "C:\Windows\system32\tar.exe -c -f D:\a\_work\1\s\common\temp\build-cache\rushstack+rush-http-build-cache-plugin-_phase_test-78333a9310f75472822f70554dee637804eb3b97-bff6412c018e4375.temp -z --files-from=-"
 
 ======= BEGIN PROCESS INPUT ======
 .rush/temp/operation/_phase_test/all.log

package/.rush/temp/rushstack+rush-http-build-cache-plugin-_phase_test-78333a9310f75472822f70554dee637804eb3b97.untar.log

@@ -0,0 +1,10 @@
+Start time: Mon Oct 30 2023 23:36:29 GMT+0000 (Coordinated Universal Time)
+Invoking "C:\Windows\system32\tar.exe -x -m -f D:\a\_work\1\s\common\temp\build-cache\rushstack+rush-http-build-cache-plugin-_phase_test-78333a9310f75472822f70554dee637804eb3b97"
+
+======= BEGIN PROCESS INPUT ======
+
+======== END PROCESS INPUT =======
+======= BEGIN PROCESS OUTPUT =======
+======== END PROCESS OUTPUT ========
+
+Exited with code "0"

package/README.md

@@ -1,116 +1,116 @@
-# @rushstack/rush-http-build-cache-plugin
-
-A Rush plugin that uses HTTP/HTTPS to manage cache objects.
-
-Authentication is provided via standard `Authorization` HTTP headers, with the value (a Bearer or Basic token) configured using a custom node script. Your "tokenHandler" node script is automatically called when the user updates their cloud credentials.
-
-## Configuration
-
-To use the HTTP build cache plugin, enable it in `common/config/rush/build-cache.json`:
-
-```json
-{
-    "buildCacheEnabled": true,
-
-    "cacheProvider": "http"
-}
-```
-
-Then customize the `httpConfiguration` block. For typical use cases, where you'll use a remote HTTP URL with authentication, you'll need to provide at least the `url` and `tokenHandler` options:
-
-```json
-{
-    "httpConfiguration": {
-        "url": "https://build-cache.example.com",
-        "tokenHandler": {
-            "exec": "node",
-            "args": ["common/scripts/custom-script-that-returns-an-authentication-header.js"]
-        },
-        "isCacheWriteAllowed": false
-    }
-}
-```
-
-(For more detail on the above properties and additional optional properties, consult the default `build-cache.json` file.)
-
-## Authorization Details
-
-The HTTP build cache plugin offloads authorization to an external executable script that you define. A typical use case would be to create a simple script, for example `common/scripts/cache-auth.js`, that prints an Authorization header value when executed.
-
-For example:
-
-```console
-node common/scripts/cache-auth.js
-# => Bearer 0284357923592790DDb979dBcd2zz
-```
-
-How the script generates authorization values is up to you, and depends on the configuration of your remote cache server.
-
-Possible implementations:
-
- - The script could read simple environment variables (`CACHE_USER` and `CACHE_TOKEN`) defined by the developer
- - It could reuse existing credentials your developers have, like NPM tokens, GitHub credentials, or jFrog API tokens
- - It could make an HTTP call to another server accessible by your developers that returns temporary credentials
-
-## HTTP Cache Server Requirements
-
-The HTTP build cache plugin can use almost any HTTP/HTTPS backend for remote caching, as long as it honors the following rules:
-
- - Uses `Authorization: Bearer xxx` or `Authorization: Basic xxx` headers for authentication.
- - Accepts GET requests for cache reads.
- - Accepts PUT requests for cache writes (with a raw request body -- no `form/multipart` MIME types).
- - Cache hits return HTTP 200 with the file in the response body.
- - Successful cache writes return HTTP 2xx (200-299).
- - Cache misses return HTTP 404 or HTTP 403.
- - Invalid or missing authentication returns HTTP 401.
-
-## Examples
-
-### Gradle Build Cache Server
-
-The Gradle Build Cache Server (typically used to support Gradle Remote Build Cache) meets all of the requirements above, so if you don't have another server in mind, you can use it as your remote backend.
-
-First, start up and configure your build cache node locally:
-
- - Download latest JAR file from https://docs.gradle.com/build-cache-node/
- - Start the service: `java -jar build-cache-node-14.0.jar start`
- - Copy the startup banner information, and navigate to the specified localhost port
- - Enter the temporary username/password credentials printed in the startup banner
- - Click Build Cache > Settings > Cache Access Control and grant "Read & write" access to Anonymous
-
-Second, configure your `build-cache.json` file as described in the Configuration section:
-
- - Note that your `url` must end with `/cache/`, for example, `http://localhost:5071/cache/`.
- - To test reading and writing, set `isCacheWriteAllowed: true`.
- - Configure `tokenHandler` to point to a script that prints a Basic or Bearer Authorization value (this can be a dummy string if you granted Read and Write to Anonymous in your build cache node configuration).
-
-Note that the Gradle Build Cache Server has a stricter format for its cache keys (they should be a simple hexadecimal hash with no non-alphanumeric characters). Configure this setting in your `build-cache.json` file:
-
-```json
-{
-    "cacheEntryNamePattern": "[hash]"
-}
-```
-
-Last, initialize your cache credentials using Rush:
-
-```console
-rush update-cloud-credentials --interactive
-```
-
-To test out your remote build cache with full debugging output (for spotting any errors reading or writing the cache), run with the `--debug` flag:
-
-```console
-rush --debug build --verbose
-```
-
-> If you go on to deploy Rush remote build caching to your developers using the Gradle Build Cache, update your `tokenHandler`
-> script to reflect your use case -- for example, you could require each developer to have a designated username/token configured
-> via environment variables, and configure Cache Access Control with the corresponding entries. In this case the `tokenHandler`
-> script should read the environment variables and print out an Authorization header, for example:
->
-> ```javascript
-> // common/scripts/build-cache-auth.js
-> const credentials = `${process.env.CACHE_USER}:${process.env.CACHE_TOKEN}`;
-> console.log('Basic ' + Buffer.from(credentials).toString('base64'));
-> ```
+# @rushstack/rush-http-build-cache-plugin
+
+A Rush plugin that uses HTTP/HTTPS to manage cache objects.
+
+Authentication is provided via standard `Authorization` HTTP headers, with the value (a Bearer or Basic token) configured using a custom node script. Your "tokenHandler" node script is automatically called when the user updates their cloud credentials.
+
+## Configuration
+
+To use the HTTP build cache plugin, enable it in `common/config/rush/build-cache.json`:
+
+```json
+{
+    "buildCacheEnabled": true,
+
+    "cacheProvider": "http"
+}
+```
+
+Then customize the `httpConfiguration` block. For typical use cases, where you'll use a remote HTTP URL with authentication, you'll need to provide at least the `url` and `tokenHandler` options:
+
+```json
+{
+    "httpConfiguration": {
+        "url": "https://build-cache.example.com",
+        "tokenHandler": {
+            "exec": "node",
+            "args": ["common/scripts/custom-script-that-returns-an-authentication-header.js"]
+        },
+        "isCacheWriteAllowed": false
+    }
+}
+```
+
+(For more detail on the above properties and additional optional properties, consult the default `build-cache.json` file.)
+
+## Authorization Details
+
+The HTTP build cache plugin offloads authorization to an external executable script that you define. A typical use case would be to create a simple script, for example `common/scripts/cache-auth.js`, that prints an Authorization header value when executed.
+
+For example:
+
+```console
+node common/scripts/cache-auth.js
+# => Bearer 0284357923592790DDb979dBcd2zz
+```
+
+How the script generates authorization values is up to you, and depends on the configuration of your remote cache server.
+
+Possible implementations:
+
+ - The script could read simple environment variables (`CACHE_USER` and `CACHE_TOKEN`) defined by the developer
+ - It could reuse existing credentials your developers have, like NPM tokens, GitHub credentials, or jFrog API tokens
+ - It could make an HTTP call to another server accessible by your developers that returns temporary credentials
+
+## HTTP Cache Server Requirements
+
+The HTTP build cache plugin can use almost any HTTP/HTTPS backend for remote caching, as long as it honors the following rules:
+
+ - Uses `Authorization: Bearer xxx` or `Authorization: Basic xxx` headers for authentication.
+ - Accepts GET requests for cache reads.
+ - Accepts PUT requests for cache writes (with a raw request body -- no `form/multipart` MIME types).
+ - Cache hits return HTTP 200 with the file in the response body.
+ - Successful cache writes return HTTP 2xx (200-299).
+ - Cache misses return HTTP 404 or HTTP 403.
+ - Invalid or missing authentication returns HTTP 401.
+
+## Examples
+
+### Gradle Build Cache Server
+
+The Gradle Build Cache Server (typically used to support Gradle Remote Build Cache) meets all of the requirements above, so if you don't have another server in mind, you can use it as your remote backend.
+
+First, start up and configure your build cache node locally:
+
+ - Download latest JAR file from https://docs.gradle.com/build-cache-node/
+ - Start the service: `java -jar build-cache-node-14.0.jar start`
+ - Copy the startup banner information, and navigate to the specified localhost port
+ - Enter the temporary username/password credentials printed in the startup banner
+ - Click Build Cache > Settings > Cache Access Control and grant "Read & write" access to Anonymous
+
+Second, configure your `build-cache.json` file as described in the Configuration section:
+
+ - Note that your `url` must end with `/cache/`, for example, `http://localhost:5071/cache/`.
+ - To test reading and writing, set `isCacheWriteAllowed: true`.
+ - Configure `tokenHandler` to point to a script that prints a Basic or Bearer Authorization value (this can be a dummy string if you granted Read and Write to Anonymous in your build cache node configuration).
+
+Note that the Gradle Build Cache Server has a stricter format for its cache keys (they should be a simple hexadecimal hash with no non-alphanumeric characters). Configure this setting in your `build-cache.json` file:
+
+```json
+{
+    "cacheEntryNamePattern": "[hash]"
+}
+```
+
+Last, initialize your cache credentials using Rush:
+
+```console
+rush update-cloud-credentials --interactive
+```
+
+To test out your remote build cache with full debugging output (for spotting any errors reading or writing the cache), run with the `--debug` flag:
+
+```console
+rush --debug build --verbose
+```
+
+> If you go on to deploy Rush remote build caching to your developers using the Gradle Build Cache, update your `tokenHandler`
+> script to reflect your use case -- for example, you could require each developer to have a designated username/token configured
+> via environment variables, and configure Cache Access Control with the corresponding entries. In this case the `tokenHandler`
+> script should read the environment variables and print out an Authorization header, for example:
+>
+> ```javascript
+> // common/scripts/build-cache-auth.js
+> const credentials = `${process.env.CACHE_USER}:${process.env.CACHE_TOKEN}`;
+> console.log('Basic ' + Buffer.from(credentials).toString('base64'));
+> ```

package/config/jest.config.json

@@ -1,14 +1,14 @@
-{
-  "extends": "local-node-rig/profiles/default/config/jest.config.json",
-  "clearMocks": true,
-  "restoreMocks": true,
-  "collectCoverage": true,
-  "coverageThreshold": {
-    "global": {
-      "branches": 4,
-      "functions": 15,
-      "lines": 4,
-      "statements": 4
-    }
-  }
-}
+{
+  "extends": "local-node-rig/profiles/default/config/jest.config.json",
+  "clearMocks": true,
+  "restoreMocks": true,
+  "collectCoverage": true,
+  "coverageThreshold": {
+    "global": {
+      "branches": 4,
+      "functions": 15,
+      "lines": 4,
+      "statements": 4
+    }
+  }
+}

package/config/rig.json

@@ -1,18 +1,18 @@
-{
-  // The "rig.json" file directs tools to look for their config files in an external package.
-  // Documentation for this system: https://www.npmjs.com/package/@rushstack/rig-package
-  "$schema": "https://developer.microsoft.com/json-schemas/rig-package/rig.schema.json",
-
-  /**
-   * (Required) The name of the rig package to inherit from.
-   * It should be an NPM package name with the "-rig" suffix.
-   */
-  "rigPackageName": "local-node-rig",
-
-  /**
-   * (Optional) Selects a config profile from the rig package.  The name must consist of
-   * lowercase alphanumeric words separated by hyphens, for example "sample-profile".
-   * If omitted, then the "default" profile will be used."
-   */
-  "rigProfile": "default"
-}
+{
+  // The "rig.json" file directs tools to look for their config files in an external package.
+  // Documentation for this system: https://www.npmjs.com/package/@rushstack/rig-package
+  "$schema": "https://developer.microsoft.com/json-schemas/rig-package/rig.schema.json",
+
+  /**
+   * (Required) The name of the rig package to inherit from.
+   * It should be an NPM package name with the "-rig" suffix.
+   */
+  "rigPackageName": "local-node-rig",
+
+  /**
+   * (Optional) Selects a config profile from the rig package.  The name must consist of
+   * lowercase alphanumeric words separated by hyphens, for example "sample-profile".
+   * If omitted, then the "default" profile will be used."
+   */
+  "rigProfile": "default"
+}

package/coverage/HttpBuildCacheProvider.ts.html

@@ -23,9 +23,9 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">65.56% </span>
+                <span class="strong">65.09% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>278/424</span>
+                <span class='fraction'>276/424</span>
             </div>
         
             
@@ -44,9 +44,9 @@
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">65.56% </span>
+                <span class="strong">65.09% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>278/424</span>
+                <span class='fraction'>276/424</span>
             </div>
         
             
@@ -548,7 +548,6 @@
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-yes">1x</span>
@@ -565,7 +564,6 @@
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">2x</span>
@@ -660,6 +658,8 @@
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-no">&nbsp;</span>
@@ -952,7 +952,7 @@ export interface IHttpBuildCacheProviderOptions {
   cacheKeyPrefix?: string;
   isCacheWriteAllowed: boolean;
   pluginName: string;
-  rushProjectRoot: string;
+  rushJsonFolder: string;
 }
 &nbsp;
 const MAX_HTTP_CACHE_ATTEMPTS: number = 3;
@@ -960,7 +960,6 @@ const DEFAULT_MIN_HTTP_RETRY_DELAY_MS = 2500;
 &nbsp;
 export class HttpBuildCacheProvider implements ICloudBuildCacheProvider {
   private readonly _pluginName: string;
-  private readonly _rushSession: RushSession;
   private readonly _rushProjectRoot: string;
   private readonly _environmentCredential: string | undefined;
   private readonly _isCacheWriteAllowedByConfiguration: boolean;
@@ -978,8 +977,7 @@ export class HttpBuildCacheProvider implements ICloudBuildCacheProvider {
 &nbsp;
   public constructor(options: IHttpBuildCacheProviderOptions, rushSession: RushSession) {
     this._pluginName = options.pluginName;
-    this._rushSession = rushSession;
-    this._rushProjectRoot = options.rushProjectRoot;
+    this._rushProjectRoot = options.rushJsonFolder;
 &nbsp;
     this._environmentCredential = EnvironmentConfiguration.buildCacheCredential;
     this._isCacheWriteAllowedByConfiguration = options.isCacheWriteAllowed;
@@ -1069,7 +1067,9 @@ export class HttpBuildCacheProvider implements ICloudBuildCacheProvider {
 <span class="cstat-no" title="statement not covered" ></span>
 <span class="cstat-no" title="statement not covered" >    const cmd: string = `${this._tokenHandler.exec} ${(this._tokenHandler.args || []).join(' ')}`;</span>
 <span class="cstat-no" title="statement not covered" >    terminal.writeVerboseLine(`Running '${cmd}' to get credentials`);</span>
-<span class="cstat-no" title="statement not covered" >    const result = Executable.spawnSync(this._tokenHandler.exec, this._tokenHandler.args || []);</span>
+<span class="cstat-no" title="statement not covered" >    const result = Executable.spawnSync(this._tokenHandler.exec, this._tokenHandler.args || [], {</span>
+<span class="cstat-no" title="statement not covered" >      currentWorkingDirectory: this._rushProjectRoot</span>
+<span class="cstat-no" title="statement not covered" >    });</span>
 <span class="cstat-no" title="statement not covered" ></span>
 <span class="cstat-no" title="statement not covered" >    terminal.writeErrorLine(result.stderr);</span>
 <span class="cstat-no" title="statement not covered" ></span>
@@ -1342,7 +1342,7 @@ export class HttpBuildCacheProvider implements ICloudBuildCacheProvider {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2023-10-07T01:10:22.716Z
+                at 2023-10-30T23:23:10.071Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/RushHttpBuildCachePlugin.ts.html

@@ -291,7 +291,7 @@
 <span class="cstat-no" title="statement not covered" ></span>
 <span class="cstat-no" title="statement not covered" >        const options: IHttpBuildCacheProviderOptions = {</span>
 <span class="cstat-no" title="statement not covered" >          pluginName: this.pluginName,</span>
-<span class="cstat-no" title="statement not covered" >          rushProjectRoot: rushConfig.rushJsonFolder,</span>
+<span class="cstat-no" title="statement not covered" >          rushJsonFolder: rushConfig.rushJsonFolder,</span>
 <span class="cstat-no" title="statement not covered" >          url: url,</span>
 <span class="cstat-no" title="statement not covered" >          uploadMethod: uploadMethod,</span>
 <span class="cstat-no" title="statement not covered" >          headers: headers,</span>
@@ -313,7 +313,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2023-10-07T01:10:22.716Z
+                at 2023-10-30T23:23:10.071Z
             </div>
         <script src="prettify.js"></script>
         <script>