improve auth error

Author: jochen-testingbot

src/cli.ts

@@ -179,7 +179,11 @@ const espressoCommand = program
       });
       if (credentials === null) {
         throw new Error(
-          'Please specify credentials via --api-key/--api-secret, TB_KEY/TB_SECRET environment variables, or ~/.testingbot file',
+          'No TestingBot credentials found. Please authenticate using one of these methods:\n' +
+            '  1. Run "testingbot login" to authenticate via browser (recommended)\n' +
+            '  2. Use --api-key and --api-secret options\n' +
+            '  3. Set TB_KEY and TB_SECRET environment variables\n' +
+            '  4. Create ~/.testingbot file with content: key:secret',
         );
       }
       const espresso = new Espresso(credentials, options);
@@ -365,7 +369,11 @@ const maestroCommand = program
       });
       if (credentials === null) {
         throw new Error(
-          'Please specify credentials via --api-key/--api-secret, TB_KEY/TB_SECRET environment variables, or ~/.testingbot file',
+          'No TestingBot credentials found. Please authenticate using one of these methods:\n' +
+            '  1. Run "testingbot login" to authenticate via browser (recommended)\n' +
+            '  2. Use --api-key and --api-secret options\n' +
+            '  3. Set TB_KEY and TB_SECRET environment variables\n' +
+            '  4. Create ~/.testingbot file with content: key:secret',
         );
       }
       const maestro = new Maestro(credentials, options);
@@ -482,7 +490,11 @@ const xcuitestCommand = program
       });
       if (credentials === null) {
         throw new Error(
-          'Please specify credentials via --api-key/--api-secret, TB_KEY/TB_SECRET environment variables, or ~/.testingbot file',
+          'No TestingBot credentials found. Please authenticate using one of these methods:\n' +
+            '  1. Run "testingbot login" to authenticate via browser (recommended)\n' +
+            '  2. Use --api-key and --api-secret options\n' +
+            '  3. Set TB_KEY and TB_SECRET environment variables\n' +
+            '  4. Create ~/.testingbot file with content: key:secret',
         );
       }
       const xcuitest = new XCUITest(credentials, options);

src/upload.ts

@@ -80,6 +80,15 @@ export default class Upload {
         throw error;
       }
       if (axios.isAxiosError(error)) {
+        if (error.response?.status === 401) {
+          throw new TestingBotError(
+            'Invalid TestingBot credentials. Please check your API key and secret.\n' +
+              'You can update your credentials by running "testingbot login" or by using:\n' +
+              '  --api-key and --api-secret options\n' +
+              '  TB_KEY and TB_SECRET environment variables\n' +
+              '  ~/.testingbot file with content: key:secret',
+          );
+        }
         const message = error.response?.data?.error || error.message;
         throw new TestingBotError(`Upload failed: ${message}`);
       }

tests/cli.test.ts

@@ -306,7 +306,11 @@ describe('TestingBotCTL CLI', () => {
     ]);
 
     expect(mockError).toHaveBeenCalledWith(
-      'Espresso error: Please specify credentials via --api-key/--api-secret, TB_KEY/TB_SECRET environment variables, or ~/.testingbot file',
+      'Espresso error: No TestingBot credentials found. Please authenticate using one of these methods:\n' +
+        '  1. Run "testingbot login" to authenticate via browser (recommended)\n' +
+        '  2. Use --api-key and --api-secret options\n' +
+        '  3. Set TB_KEY and TB_SECRET environment variables\n' +
+        '  4. Create ~/.testingbot file with content: key:secret',
     );
   });
 
@@ -327,7 +331,11 @@ describe('TestingBotCTL CLI', () => {
     ]);
 
     expect(mockError).toHaveBeenCalledWith(
-      'Maestro error: Please specify credentials via --api-key/--api-secret, TB_KEY/TB_SECRET environment variables, or ~/.testingbot file',
+      'Maestro error: No TestingBot credentials found. Please authenticate using one of these methods:\n' +
+        '  1. Run "testingbot login" to authenticate via browser (recommended)\n' +
+        '  2. Use --api-key and --api-secret options\n' +
+        '  3. Set TB_KEY and TB_SECRET environment variables\n' +
+        '  4. Create ~/.testingbot file with content: key:secret',
     );
   });
 
@@ -350,7 +358,11 @@ describe('TestingBotCTL CLI', () => {
     ]);
 
     expect(mockError).toHaveBeenCalledWith(
-      'XCUITest error: Please specify credentials via --api-key/--api-secret, TB_KEY/TB_SECRET environment variables, or ~/.testingbot file',
+      'XCUITest error: No TestingBot credentials found. Please authenticate using one of these methods:\n' +
+        '  1. Run "testingbot login" to authenticate via browser (recommended)\n' +
+        '  2. Use --api-key and --api-secret options\n' +
+        '  3. Set TB_KEY and TB_SECRET environment variables\n' +
+        '  4. Create ~/.testingbot file with content: key:secret',
     );
   });