update endpoint to retrive SC download

saucelabs · Jan 28, 2025 · bbfbd93 · bbfbd93
1 parent 05961a9
commit bbfbd93
Show file tree

Hide file tree

Showing 19 changed files with 449 additions and 636 deletions.
diff --git a/README.md b/README.md
@@ -104,12 +104,12 @@ or start Sauce Connect Proxy in EU datacenter:
 # start Sauce Connect tunnel for eu-central-1 region
 $ sl sc --region eu --tunnel-name "my-tunnel"
 # run a specific Sauce Connect version
-$ sl sc --scVersion 4.9.1
+$ sl sc --scVersion 5.2.2
 # see all available Sauce Connect parameters via:
 $ sl sc --help
 ```
 
-You can see all available Sauce Connect parameters on the [Sauce Labs Docs](https://docs.saucelabs.com/dev/cli/sauce-connect-proxy/).
+You can see all available Sauce Connect parameters on the [Sauce Labs Docs](https://docs.saucelabs.com/dev/cli/sauce-connect-5/run/).
 
 ### As NPM Package
 
@@ -179,7 +179,7 @@ import SauceLabs from 'saucelabs';
      */
     logger: (stdout) => console.log(stdout),
     /**
-     * see all available parameters here: https://docs.saucelabs.com/dev/cli/sauce-connect-proxy/
+     * see all available parameters here: https://docs.saucelabs.com/dev/cli/sauce-connect-5/run/
      * all parameters have to be applied camel cased instead of with hyphens, e.g.
      * to apply the `--tunnel-name` parameter, set:
      */
@@ -219,6 +219,7 @@ const myAccount = new SauceLabs({
   user: 'YOUR-USER',
   key: 'YOUR-ACCESS-KEY',
   region: 'eu', // run in EU datacenter
+  tunnelName: 'my-tunnel',
 });
 
 // get full webdriver url from the client depending on `region` option:

diff --git a/apis/sauce.json b/apis/sauce.json
@@ -458,81 +458,33 @@
       },
       "type": "object"
     },
-    "SauceConnectDownloadInfo": {
+    "SauceConnectDownload": {
       "type": "object",
       "properties": {
-        "download_url": {
-          "type": "string"
-        },
-        "sha1": {
-          "type": "string",
-          "nullable": true
-        },
-        "sha256": {
-          "type": "string",
-          "nullable": true
-        },
-        "version": {
-          "type": "string",
-          "nullable": true
-        }
-      }
-    },
-    "SauceConnectByPlatform": {
-      "type": "object",
-      "properties": {
-        "linux": {
-          "$ref": "#/definitions/SauceConnectDownloadInfo",
-          "nullable": true
-        },
-        "linux-arm64": {
-          "$ref": "#/definitions/SauceConnectDownloadInfo",
-          "nullable": true
-        },
-        "win32": {
-          "$ref": "#/definitions/SauceConnectDownloadInfo",
-          "nullable": true
-        },
-        "osx": {
-          "$ref": "#/definitions/SauceConnectDownloadInfo"
-        }
-      }
-    },
-    "SauceConnectVersions": {
-      "type": "object",
-      "properties": {
-        "latest_version": {
-          "type": "string"
-        },
-        "client_version": {
-          "type": "string"
-        },
-        "status": {
-          "type": "string",
-          "enum": ["LATEST", "UPGRADE", "PRERELEASE", "UNKNOWN", "EOL"]
-        },
-        "info_url": {
-          "type": "string"
-        },
-        "download_url": {
-          "type": "string"
-        },
-        "sha1": {
-          "type": "string",
-          "nullable": true
-        },
-        "sha256": {
-          "type": "string",
-          "nullable": true
-        }
-      },
-      "downloads": {
-        "$ref": "#/definitions/SauceConnectByPlatform"
-      },
-      "all_downloads": {
-        "type": "array",
-        "items": {
-          "$ref": "#/definitions/SauceConnectByPlatform"
+        "download": {
+          "type": "object",
+          "properties": {
+            "url": {
+              "type": "string"
+            },
+            "version": {
+              "type": "string"
+            },
+            "checksums": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "value": {
+                    "type": "string"
+                  },
+                  "algorithm": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
         }
       }
     },
@@ -820,10 +772,17 @@
       "required": true,
       "type": "string"
     },
-    "clientHost": {
-      "description": "SC client host OS and CPU arch",
+    "clientArch": {
+      "description": "SC client host CPU arch",
       "in": "query",
-      "name": "client_host",
+      "name": "arch",
+      "required": false,
+      "type": "string"
+    },
+    "clientOS": {
+      "description": "SC client host OS",
+      "in": "query",
+      "name": "os",
       "required": false,
       "type": "string"
     },
@@ -1768,25 +1727,26 @@
         "tags": ["Tunnel"]
       }
     },
-    "/v1/public/tunnels/info/versions": {
+    "/v1/public/tunnels/sauce-connect/download": {
       "get": {
-        "operationId": "sc_versions",
+        "description": "Get Sauce Connect download information for the latest version",
+        "operationId": "sc_download",
         "parameters": [
           {
-            "$ref": "#/parameters/clientVersion"
+            "$ref": "#/parameters/clientArch"
           },
           {
-            "$ref": "#/parameters/clientHost"
+            "$ref": "#/parameters/clientOS"
           },
           {
-            "$ref": "#/parameters/all"
+            "$ref": "#/parameters/clientVersion"
           }
         ],
         "responses": {
           "200": {
-            "description": "Tunnels",
+            "description": "download",
             "schema": {
-              "$ref": "#/definitions/SauceConnectVersions"
+              "$ref": "#/definitions/SauceConnectDownload"
             }
           },
           "default": {
@@ -1796,7 +1756,6 @@
             }
           }
         },
-        "summary": "Get tunnels for the user or all the users in the team",
         "tags": ["Tunnel"]
       }
     },

diff --git a/docs/interface.md b/docs/interface.md
@@ -185,12 +185,12 @@ The following commands are available via package or cli tool:
     </tr>
     <tr>
       <td>
-        <b>GET</b> <code>/v1/public/tunnels/info/versions</code><br>
-        Get tunnels for the user or all the users in the team
+        <b>GET</b> <code>/v1/public/tunnels/sauce-connect/download</code><br>
+        Get Sauce Connect download information for the latest version
         <h3>Example:</h3>
-        <code>api.scVersions({ ...options })</code>
+        <code>api.scDownload({ ...options })</code>
         <br><h4>Options</h4>
-        <ul>          <li><b>client_version</b>: SC client version</li>          <li><b>client_host</b>: SC client host OS and CPU arch</li>          <li><b>all</b>: Should the response contain the same team user data</li>        </ul>      </td>
+        <ul>          <li><b>arch</b>: SC client host CPU architecture</li>          <li><b>os</b>: SC client host OS</li>        <li><b>version</b>: Optional. Return the newest version matching this minimal version</li>        </ul>      </td>
     </tr>
     <tr>
       <td>

diff --git a/e2e/sc.test.js b/e2e/sc.test.js
@@ -23,27 +23,42 @@ test('should be able to get Sauce Connect versions', async () => {
     return;
   }
   const api = new SauceLabs();
-  const scVersion = await api.scVersions({
-    clientVersion: '5.1.0',
-    clientHost: 'darwin-arm64',
+  const response = await api.scDownload({
+    version: '5.2.2',
+    arch: 'arm64',
+    os: 'macos',
   });
-  expect(scVersion.status).toEqual('UPGRADE');
-  expect(scVersion.latest_version).toMatch(/5\./);
-  console.log(scVersion.download_url);
+
+  expect(response.download.version).toEqual('5.2.2');
+  expect(response.download.url).toMatch(/5\.2\.2/);
+  console.log(response.download.url);
 });
 
 test('should not be able to run Sauce Connect due to invalid credentials', async () => {
   if (SKIP_TEST) {
     return;
   }
-  const api = new SauceLabs({key: 'foobar'});
+  const api = new SauceLabs({key: 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa'});
   const err = await api
     .startSauceConnect({
       logger: console.log.bind(console),
       tunnelName: `node-saucelabs E2E test - ${ID}`,
     })
     .catch((err) => err);
-  expect(err.message).toContain('Unauthorized');
+  expect(err.message).toContain('Not authorized');
+});
+
+test('should not be able to run Sauce Connect due to missing tunnel-name', async () => {
+  if (SKIP_TEST) {
+    return;
+  }
+  const api = new SauceLabs();
+  const err = await api
+    .startSauceConnect({
+      logger: console.log.bind(console),
+    })
+    .catch((err) => err);
+  expect(err.message).toContain('Missing tunnel-name');
 });
 
 test('should be able to run Sauce Connect', async () => {

diff --git a/src/cli.js b/src/cli.js
@@ -16,7 +16,6 @@ export const run = () => {
     .epilog(EPILOG)
     .demandCommand()
     .commandDir('commands')
-    .wrap(yargs.terminalWidth())
     .help()
     .version(SAUCE_VERSION_NOTE);
 

diff --git a/src/constants.js b/src/constants.js
@@ -3,7 +3,7 @@ import os from 'os';
 
 import {version} from '../package.json';
 
-export const DEFAULT_SAUCE_CONNECT_VERSION = '5.2.0';
+export const DEFAULT_SAUCE_CONNECT_VERSION = '5.2.2';
 export const SAUCE_VERSION_NOTE = `node-saucelabs v${version}\nSauce Connect v${DEFAULT_SAUCE_CONNECT_VERSION}`;
 
 const protocols = [
@@ -313,10 +313,6 @@ export const SC_PARAMS_TO_STRIP = [
 ];
 
 export const SC_READY_MESSAGE = 'Sauce Connect is up, you may start your tests';
-export const SC_FAILURE_MESSAGES = [
-  'Sauce Connect could not establish a connection',
-  'Sauce Connect failed to start',
-];
-export const SC_WAIT_FOR_MESSAGES = ['\u001b[K', 'Please wait for']; // "\u001b" = Escape character
-export const SC_CLOSE_MESSAGE = 'Goodbye';
+export const SC_FAILURE_MESSAGES = ['fatal error exiting'];
+export const SC_CLOSE_MESSAGE = 'tunnel was shutdown';
 export const SC_CLOSE_TIMEOUT = 5000;