@testingbot/cli 1.0.1 → 1.0.2

package/dist/utils/connectivity.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Utility for checking internet connectivity using third-party endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkInternetConnectivity = checkInternetConnectivity;
+exports.formatConnectivityResults = formatConnectivityResults;
+/**
+ * Check if the system has internet connectivity by testing against
+ * multiple reliable third-party endpoints with detailed diagnostics.
+ */
+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' },
+    ];
+    const endpointResults = [];
+    let anySuccess = false;
+    for (const { url, description } of testEndpoints) {
+        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;
+            if (response) {
+                anySuccess = true;
+                endpointResults.push({
+                    endpoint: `${description} (${url})`,
+                    success: true,
+                    statusCode: response.status,
+                    latencyMs,
+                });
+                break;
+            }
+        }
+        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;
+                }
+            }
+            endpointResults.push({
+                endpoint: `${description} (${url})`,
+                success: false,
+                error: errorMessage,
+                latencyMs,
+            });
+        }
+    }
+    let message;
+    if (anySuccess) {
+        const successfulEndpoint = endpointResults.find((r) => r.success);
+        message = `Internet connectivity verified via ${successfulEndpoint?.endpoint} (${successfulEndpoint?.latencyMs}ms)`;
+    }
+    else {
+        const testedEndpoints = endpointResults.map((r) => r.endpoint).join(', ');
+        message = `No internet connectivity detected. Tested endpoints: ${testedEndpoints}`;
+    }
+    return {
+        connected: anySuccess,
+        endpointResults,
+        message,
+    };
+}
+/**
+ * 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.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

@@ -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: ${colors_1.default.cyan(currentVersion)}\n`);
+            logger_1.default.warn(colors_1.default.yellow(border));
+            logger_1.default.warn(colors_1.default.yellow('⚠  Update Available'));
+            logger_1.default.warn(colors_1.default.yellow(`   A new version of the TestingBot CLI is available: ${colors_1.default.green(latestVersion)}`));
+            logger_1.default.warn(colors_1.default.yellow(`   Run: ${colors_1.default.cyan('npm install -g @testingbot/cli@latest')}`));
+            logger_1.default.warn(colors_1.default.yellow(border) + '\n');
         }
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testingbot/cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "CLI tool to run Espresso, XCUITest, and Maestro tests on TestingBot's cloud infrastructure",
   "main": "dist/index.js",
   "bin": {