@testingbot/cli 1.0.1 → 1.0.3

package/dist/utils/connectivity.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * Utility for checking internet connectivity using third-party endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkInternetConnectivity = checkInternetConnectivity;
+exports.formatConnectivityResults = formatConnectivityResults;
+/**
+ * Test a single endpoint and return the result
+ */
+async function testEndpoint(url, description) {
+    const startTime = Date.now();
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), 3000);
+        const response = await fetch(url, {
+            method: 'HEAD',
+            signal: controller.signal,
+            redirect: 'manual',
+        });
+        clearTimeout(timeoutId);
+        const latencyMs = Date.now() - startTime;
+        return {
+            endpoint: `${description} (${url})`,
+            success: true,
+            statusCode: response.status,
+            latencyMs,
+        };
+    }
+    catch (error) {
+        const latencyMs = Date.now() - startTime;
+        let errorMessage = 'Unknown error';
+        if (error instanceof Error) {
+            if (error.name === 'AbortError') {
+                errorMessage = 'Request timeout (>3s)';
+            }
+            else if (error.message.includes('fetch failed')) {
+                errorMessage = 'Network request failed (DNS/connection error)';
+            }
+            else if (error.message.includes('ENOTFOUND')) {
+                errorMessage = 'DNS resolution failed';
+            }
+            else if (error.message.includes('ECONNREFUSED')) {
+                errorMessage = 'Connection refused';
+            }
+            else if (error.message.includes('ETIMEDOUT')) {
+                errorMessage = 'Connection timeout';
+            }
+            else if (error.message.includes('ENETUNREACH')) {
+                errorMessage = 'Network unreachable';
+            }
+            else {
+                errorMessage = error.message;
+            }
+        }
+        return {
+            endpoint: `${description} (${url})`,
+            success: false,
+            error: errorMessage,
+            latencyMs,
+        };
+    }
+}
+/**
+ * Check if the system has internet connectivity by testing against
+ * multiple reliable third-party endpoints in parallel.
+ * Returns as soon as one endpoint succeeds, reducing latency significantly.
+ */
+async function checkInternetConnectivity() {
+    const testEndpoints = [
+        { url: 'https://www.google.com/generate_204', description: 'Google' },
+        {
+            url: 'https://www.cloudflare.com/cdn-cgi/trace',
+            description: 'Cloudflare',
+        },
+        { url: 'https://1.1.1.1/', description: 'Cloudflare DNS' },
+    ];
+    // Test all endpoints in parallel
+    const endpointPromises = testEndpoints.map(({ url, description }) => testEndpoint(url, description));
+    // Use Promise.any to return on first success, or collect all failures
+    try {
+        // Create promises that only resolve on success
+        const successPromises = endpointPromises.map(async (promise) => {
+            const result = await promise;
+            if (result.success) {
+                return result;
+            }
+            throw result; // Throw failures so Promise.any continues to next
+        });
+        const successResult = await Promise.any(successPromises);
+        return {
+            connected: true,
+            endpointResults: [successResult],
+            message: `Internet connectivity verified via ${successResult.endpoint} (${successResult.latencyMs}ms)`,
+        };
+    }
+    catch (aggregateError) {
+        // All endpoints failed - collect all results
+        const endpointResults = await Promise.all(endpointPromises);
+        const testedEndpoints = endpointResults.map((r) => r.endpoint).join(', ');
+        return {
+            connected: false,
+            endpointResults,
+            message: `No internet connectivity detected. Tested endpoints: ${testedEndpoints}`,
+        };
+    }
+}
+/**
+ * Format connectivity check results for display
+ */
+function formatConnectivityResults(result) {
+    const lines = [];
+    if (result.connected) {
+        lines.push(`✓ ${result.message}`);
+    }
+    else {
+        lines.push(`✗ ${result.message}`);
+        lines.push('');
+        lines.push('Endpoint results:');
+        for (const endpoint of result.endpointResults) {
+            lines.push(`  • ${endpoint.endpoint}: ${endpoint.error} (${endpoint.latencyMs}ms)`);
+        }
+        lines.push('');
+        lines.push('Troubleshooting steps:');
+        lines.push('  1. Check your internet connection');
+        lines.push('  2. Verify no firewall is blocking outbound connections');
+        lines.push('  3. Check if a VPN or proxy is interfering');
+        lines.push('  4. Try: ping google.com');
+    }
+    return lines.join('\n');
+}

package/dist/utils/error-helpers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Error enhancement utilities for better diagnostics
+ */
+import { AxiosError } from 'axios';
+import TestingBotError from '../models/testingbot_error';
+/**
+ * Enhances generic network errors with more specific diagnostic information
+ */
+export declare function enhanceNetworkError(error: Error, url: string): TestingBotError;
+/**
+ * Get a user-friendly error message for an HTTP status code
+ */
+export declare function getStatusCodeMessage(statusCode: number, serverMessage?: string): string;
+/**
+ * Handle Axios errors with enhanced diagnostics
+ */
+export declare function handleAxiosError(error: AxiosError, operation: string): TestingBotError;
+/**
+ * Check if an error is a network-level error (vs HTTP error)
+ */
+export declare function isNetworkError(error: AxiosError): boolean;
+/**
+ * Check if error is retryable
+ */
+export declare function isRetryableError(error: AxiosError): boolean;
+//# sourceMappingURL=error-helpers.d.ts.map

package/dist/utils/error-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/error-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,eAAe,MAAM,4BAA4B,CAAC;AAEzD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,eAAe,CAkCjB;AAoFD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,GAChB,eAAe,CA8DjB;AA6BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAW3D"}

package/dist/utils/error-helpers.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * Error enhancement utilities for better diagnostics
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enhanceNetworkError = enhanceNetworkError;
+exports.getStatusCodeMessage = getStatusCodeMessage;
+exports.handleAxiosError = handleAxiosError;
+exports.isNetworkError = isNetworkError;
+exports.isRetryableError = isRetryableError;
+const testingbot_error_1 = __importDefault(require("../models/testingbot_error"));
+/**
+ * Enhances generic network errors with more specific diagnostic information
+ */
+function enhanceNetworkError(error, url) {
+    let hostname;
+    let origin;
+    try {
+        const urlObj = new URL(url);
+        hostname = urlObj.hostname;
+        origin = urlObj.origin;
+    }
+    catch {
+        hostname = url;
+        origin = url;
+    }
+    const lines = [
+        `Network request failed: ${url}`,
+        '',
+        'Possible causes:',
+        `  1. No internet connection - check your network connectivity`,
+        `  2. DNS resolution failed - unable to resolve "${hostname}"`,
+        `  3. Firewall or proxy blocking the request`,
+        `  4. API server is down or unreachable`,
+        `  5. SSL/TLS certificate validation failed`,
+        '',
+        'Troubleshooting steps:',
+        `  • Check internet connection: ping google.com`,
+        `  • Test API reachability: curl ${origin}`,
+        `  • Verify API URL is correct: ${origin}`,
+        `  • Check for proxy/VPN interference`,
+        `  • Try again in a few moments if server is temporarily down`,
+        '',
+        `Original error: ${error.message}`,
+    ];
+    return new testingbot_error_1.default(lines.join('\n'), { cause: error });
+}
+const STATUS_CODE_MESSAGES = {
+    400: {
+        message: 'Invalid request',
+        troubleshooting: [
+            'Check that all required parameters are provided',
+            'Verify the file format is correct (APK for Android, IPA/ZIP for iOS)',
+            'Ensure the request payload is valid',
+        ],
+    },
+    401: {
+        message: 'Invalid TestingBot credentials. Please check your API key and secret',
+        troubleshooting: [
+            'Run "testingbot login" to authenticate via browser',
+            'Use --api-key and --api-secret command line options',
+            'Set TB_KEY and TB_SECRET environment variables',
+            'Create ~/.testingbot file with content: key:secret',
+        ],
+    },
+    403: {
+        message: 'Access denied',
+        troubleshooting: [
+            'Check your account has the required permissions',
+            'Verify your subscription plan includes this feature',
+            'Contact support if you believe this is an error',
+        ],
+    },
+    404: {
+        message: 'Resource not found',
+        troubleshooting: [
+            'Verify the resource ID or path is correct',
+            'Check if the resource was deleted or expired',
+        ],
+    },
+    429: {
+        message: 'Your TestingBot credits are depleted',
+        troubleshooting: [
+            'Check your remaining credits at https://testingbot.com/members',
+            'Upgrade your plan at https://testingbot.com/pricing',
+            'Contact support if you believe this is an error',
+        ],
+    },
+    500: {
+        message: 'Server error occurred',
+        troubleshooting: [
+            'This is a temporary issue on our end',
+            'Please try again in a few moments',
+            'Contact support if the issue persists',
+        ],
+    },
+    502: {
+        message: 'Bad gateway - service temporarily unavailable',
+        troubleshooting: [
+            'The service is experiencing issues',
+            'Please try again in a few moments',
+        ],
+    },
+    503: {
+        message: 'Service temporarily unavailable',
+        troubleshooting: [
+            'The service is under maintenance or overloaded',
+            'Please try again in a few moments',
+        ],
+    },
+    504: {
+        message: 'Gateway timeout',
+        troubleshooting: [
+            'The request took too long to process',
+            'Try with a smaller file or simpler request',
+            'Check your network connection speed',
+        ],
+    },
+};
+/**
+ * Get a user-friendly error message for an HTTP status code
+ */
+function getStatusCodeMessage(statusCode, serverMessage) {
+    const config = STATUS_CODE_MESSAGES[statusCode];
+    if (!config) {
+        return serverMessage
+            ? `Request failed (HTTP ${statusCode}): ${serverMessage}`
+            : `Request failed with HTTP status ${statusCode}`;
+    }
+    const lines = [config.message];
+    if (serverMessage) {
+        lines.push(`Details: ${serverMessage}`);
+    }
+    if (config.troubleshooting && config.troubleshooting.length > 0) {
+        lines.push('');
+        lines.push('Troubleshooting:');
+        for (const step of config.troubleshooting) {
+            lines.push(`  • ${step}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Handle Axios errors with enhanced diagnostics
+ */
+function handleAxiosError(error, operation) {
+    // Network-level errors (no response)
+    if (!error.response) {
+        if (error.code === 'ECONNREFUSED') {
+            return new testingbot_error_1.default(`${operation}: Connection refused. The server may be down or unreachable.\n\n` +
+                'Troubleshooting:\n' +
+                '  • Check if the API server is running\n' +
+                '  • Verify the API URL is correct\n' +
+                '  • Check for firewall or proxy issues', { cause: error });
+        }
+        if (error.code === 'ENOTFOUND') {
+            return new testingbot_error_1.default(`${operation}: DNS resolution failed. Could not resolve the server hostname.\n\n` +
+                'Troubleshooting:\n' +
+                '  • Check your internet connection\n' +
+                '  • Verify the API URL is correct\n' +
+                '  • Try: ping api.testingbot.com', { cause: error });
+        }
+        if (error.code === 'ETIMEDOUT' || error.code === 'ECONNABORTED') {
+            return new testingbot_error_1.default(`${operation}: Connection timed out. The request took too long to complete.\n\n` +
+                'Troubleshooting:\n' +
+                '  • Check your internet connection speed\n' +
+                '  • Try again - the server may be temporarily slow\n' +
+                '  • For large files, ensure stable connection', { cause: error });
+        }
+        if (error.code === 'CERT_HAS_EXPIRED' ||
+            error.code === 'UNABLE_TO_VERIFY_LEAF_SIGNATURE') {
+            return new testingbot_error_1.default(`${operation}: SSL/TLS certificate error.\n\n` +
+                'Troubleshooting:\n' +
+                '  • Check your system date and time are correct\n' +
+                '  • Update your CA certificates\n' +
+                '  • Check for proxy/VPN interference', { cause: error });
+        }
+        // Generic network error
+        return enhanceNetworkError(error, error.config?.url || 'unknown URL');
+    }
+    // HTTP errors (have response)
+    const statusCode = error.response.status;
+    const serverMessage = extractServerMessage(error.response.data);
+    return new testingbot_error_1.default(`${operation}: ${getStatusCodeMessage(statusCode, serverMessage)}`, { cause: error });
+}
+/**
+ * Extract error message from various server response formats
+ */
+function extractServerMessage(data) {
+    if (!data)
+        return undefined;
+    if (typeof data === 'string') {
+        // Try to parse as JSON
+        try {
+            const parsed = JSON.parse(data);
+            return parsed.message || parsed.error || data;
+        }
+        catch {
+            return data;
+        }
+    }
+    if (typeof data === 'object') {
+        const obj = data;
+        if (typeof obj.message === 'string')
+            return obj.message;
+        if (typeof obj.error === 'string')
+            return obj.error;
+        if (typeof obj.errors === 'string')
+            return obj.errors;
+        if (Array.isArray(obj.errors))
+            return obj.errors.join(', ');
+    }
+    return undefined;
+}
+/**
+ * Check if an error is a network-level error (vs HTTP error)
+ */
+function isNetworkError(error) {
+    return !error.response && !!error.code;
+}
+/**
+ * Check if error is retryable
+ */
+function isRetryableError(error) {
+    // Network errors are usually retryable
+    if (isNetworkError(error)) {
+        return true;
+    }
+    // Some HTTP errors are retryable
+    const retryableStatusCodes = [408, 429, 500, 502, 503, 504];
+    return error.response
+        ? retryableStatusCodes.includes(error.response.status)
+        : false;
+}

package/dist/utils/file-type-detector.d.ts

@@ -9,7 +9,10 @@ export interface FileTypeResult {
 export declare function detectFileType(filePath: string): Promise<FileTypeResult | undefined>;
 /**
  * Detect platform (Android or iOS) from app file.
- * Uses magic bytes for content detection, with extension fallback for zip-based formats.
+ * Uses a combination of magic bytes and file extension for reliable detection.
+ *
+ * Android: .apk, .apks files
+ * iOS: .ipa, .app, .zip files (when not APK)
  */
 export declare function detectPlatformFromFile(filePath: string): Promise<'Android' | 'iOS' | undefined>;
 //# sourceMappingURL=file-type-detector.d.ts.map

package/dist/utils/file-type-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-type-detector.d.ts","sourceRoot":"","sources":["../../src/utils/file-type-detector.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CASrC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC,CAmBxC"}
+{"version":3,"file":"file-type-detector.d.ts","sourceRoot":"","sources":["../../src/utils/file-type-detector.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CASrC;AASD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC,CAgCxC"}

package/dist/utils/file-type-detector.js

@@ -1,7 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.detectFileType = detectFileType;
 exports.detectPlatformFromFile = detectPlatformFromFile;
+const node_path_1 = __importDefault(require("node:path"));
 /**
  * Detect file type from file content using magic bytes.
  * Returns undefined if the file type cannot be determined.
@@ -17,22 +21,42 @@ async function detectFileType(filePath) {
         return undefined;
     }
 }
+/**
+ * Get file extension in lowercase without the dot
+ */
+function getExtension(filePath) {
+    return node_path_1.default.extname(filePath).toLowerCase().slice(1);
+}
 /**
  * Detect platform (Android or iOS) from app file.
- * Uses magic bytes for content detection, with extension fallback for zip-based formats.
+ * Uses a combination of magic bytes and file extension for reliable detection.
+ *
+ * Android: .apk, .apks files
+ * iOS: .ipa, .app, .zip files (when not APK)
  */
 async function detectPlatformFromFile(filePath) {
+    const ext = getExtension(filePath);
     const fileType = await detectFileType(filePath);
+    // Check for Android APK files
     if (fileType) {
-        // APK files are detected as 'application/zip' with ext 'apk'
-        // or as 'application/vnd.android.package-archive'
         if (fileType.ext === 'apk' ||
             fileType.mime === 'application/vnd.android.package-archive') {
             return 'Android';
         }
-        if (fileType.ext === 'zip' || fileType.mime === 'application/zip') {
-            return 'iOS';
-        }
+    }
+    // Extension-based detection (more reliable for mobile apps)
+    // APK and APKS are Android
+    if (ext === 'apk' || ext === 'apks') {
+        return 'Android';
+    }
+    // IPA, APP are iOS
+    if (ext === 'ipa' || ext === 'app') {
+        return 'iOS';
+    }
+    // ZIP files could be either, but commonly used for iOS simulator builds
+    // If magic bytes detected it as zip and extension is .zip, assume iOS
+    if (ext === 'zip' && fileType?.mime === 'application/zip') {
+        return 'iOS';
     }
     return undefined;
 }

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";oBAOkB,MAAM;yBAID,MAAM;IAI3B;;;OAGG;wBACiB,MAAM,MAAM,MAAM,GAAG,MAAM;IAa/C;;OAEG;kCAC2B,MAAM,GAAG,SAAS,GAAG,IAAI;;AA7BzD,wBAiDE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";oBAOkB,MAAM;yBAID,MAAM;IAI3B;;;OAGG;wBACiB,MAAM,MAAM,MAAM,GAAG,MAAM;IAa/C;;OAEG;kCAC2B,MAAM,GAAG,SAAS,GAAG,IAAI;;AA7BzD,wBAuDE"}

package/dist/utils.js

@@ -5,7 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const package_json_1 = __importDefault(require("../package.json"));
 const logger_1 = __importDefault(require("./logger"));
-const colors_1 = __importDefault(require("colors"));
+const picocolors_1 = __importDefault(require("picocolors"));
 let versionCheckDisplayed = false;
 exports.default = {
     getUserAgent() {
@@ -41,8 +41,13 @@ exports.default = {
         const currentVersion = this.getCurrentVersion();
         if (this.compareVersions(currentVersion, latestVersion) < 0) {
             versionCheckDisplayed = true;
-            logger_1.default.warn(colors_1.default.yellow(`\n📦 A new version of testingbotctl is available: ${colors_1.default.green(latestVersion)} (current: ${currentVersion})`));
-            logger_1.default.warn(colors_1.default.yellow(`   Run ${colors_1.default.cyan('npm update -g testingbotctl')} to update.\n`));
+            const border = '─'.repeat(80);
+            logger_1.default.info(`\nCLI Version: ${picocolors_1.default.cyan(currentVersion)}\n`);
+            logger_1.default.warn(picocolors_1.default.yellow(border));
+            logger_1.default.warn(picocolors_1.default.yellow('⚠  Update Available'));
+            logger_1.default.warn(picocolors_1.default.yellow(`   A new version of the TestingBot CLI is available: ${picocolors_1.default.green(latestVersion)}`));
+            logger_1.default.warn(picocolors_1.default.yellow(`   Run: ${picocolors_1.default.cyan('npm install -g @testingbot/cli@latest')}`));
+            logger_1.default.warn(picocolors_1.default.yellow(border) + '\n');
         }
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testingbot/cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "CLI tool to run Espresso, XCUITest, and Maestro tests on TestingBot's cloud infrastructure",
   "main": "dist/index.js",
   "bin": {
@@ -49,12 +49,12 @@
   "dependencies": {
     "archiver": "^7.0.1",
     "axios": "^1.13.2",
-    "colors": "^1.4.0",
     "commander": "^14.0.2",
     "file-type": "^21.1.1",
     "form-data": "^4.0.5",
     "glob": "^13.0.0",
     "js-yaml": "^4.1.1",
+    "picocolors": "^1.1.1",
     "progress-stream": "^2.0.0",
     "socket.io-client": "^4.8.1",
     "tracer": "^1.3.0"