@testingbot/cli 1.0.2 → 1.0.4

package/dist/upload.d.ts

@@ -7,6 +7,8 @@ export interface UploadOptions {
     contentType: ContentType;
     showProgress?: boolean;
     checksum?: string;
+    /** Validate that the file is a valid zip-based archive (APK, IPA, ZIP) */
+    validateZipFormat?: boolean;
 }
 export interface UploadResult {
     id: number;
@@ -19,6 +21,15 @@ export default class Upload {
      */
     private formatFileSize;
     private validateFile;
+    /**
+     * Validate that the file is a valid zip-based archive.
+     * ZIP, APK, IPA files all start with the ZIP magic bytes (PK\x03\x04).
+     */
+    private validateZipFormat;
+    /**
+     * Extract error message from server response data
+     */
+    private extractErrorMessage;
     /**
      * Calculate MD5 checksum of a file, returning base64-encoded result
      * This matches ActiveStorage's checksum format

package/dist/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAMA,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAK/C,MAAM,MAAM,WAAW,GACnB,yCAAyC,GACzC,0BAA0B,GAC1B,iBAAiB,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,CAAC,OAAO,OAAO,MAAM;IACZ,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA6FlE,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,cAAc;YAUR,YAAY;IAQ1B;;;OAGG;IACU,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAUlE"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAMA,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAK/C,MAAM,MAAM,WAAW,GACnB,yCAAyC,GACzC,0BAA0B,GAC1B,iBAAiB,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,CAAC,OAAO,OAAO,MAAM;IACZ,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAyGlE,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,cAAc;YAUR,YAAY;IAQ1B;;;OAGG;YACW,iBAAiB;IAqB/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;;OAGG;IACU,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAUlE"}

package/dist/upload.js

@@ -16,6 +16,9 @@ class Upload {
     async upload(options) {
         const { filePath, url, credentials, showProgress = false } = options;
         await this.validateFile(filePath);
+        if (options.validateZipFormat) {
+            await this.validateZipFormat(filePath);
+        }
         const fileName = node_path_1.default.basename(filePath);
         const fileStats = await node_fs_1.default.promises.stat(filePath);
         const totalSize = fileStats.size;
@@ -85,6 +88,11 @@ class Upload {
                 throw error;
             }
             if (axios_1.default.isAxiosError(error)) {
+                // Handle 400 errors specifically for file uploads
+                if (error.response?.status === 400) {
+                    const serverMessage = this.extractErrorMessage(error.response.data);
+                    throw new testingbot_error_1.default(`Upload rejected: ${serverMessage || 'The file was not accepted by the server'}`, { cause: error });
+                }
                 throw (0, error_helpers_1.handleAxiosError)(error, 'Upload failed');
             }
             throw new testingbot_error_1.default(`Upload failed: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error instanceof Error ? error : undefined });
@@ -122,6 +130,55 @@ class Upload {
             throw new testingbot_error_1.default(`File not found or not readable: ${filePath}`);
         }
     }
+    /**
+     * Validate that the file is a valid zip-based archive.
+     * ZIP, APK, IPA files all start with the ZIP magic bytes (PK\x03\x04).
+     */
+    async validateZipFormat(filePath) {
+        const ZIP_MAGIC_BYTES = Buffer.from([0x50, 0x4b, 0x03, 0x04]); // PK\x03\x04
+        const fd = await node_fs_1.default.promises.open(filePath, 'r');
+        try {
+            const buffer = Buffer.alloc(4);
+            const { bytesRead } = await fd.read(buffer, 0, 4, 0);
+            if (bytesRead < 4 || !buffer.subarray(0, 4).equals(ZIP_MAGIC_BYTES)) {
+                const fileName = node_path_1.default.basename(filePath);
+                const ext = node_path_1.default.extname(filePath).toLowerCase();
+                throw new testingbot_error_1.default(`Invalid file format: "${fileName}" is not a valid ${ext || 'archive'} file. ` +
+                    `The file does not appear to be a valid zip-based archive (APK, IPA, or ZIP).`);
+            }
+        }
+        finally {
+            await fd.close();
+        }
+    }
+    /**
+     * Extract error message from server response data
+     */
+    extractErrorMessage(data) {
+        if (!data)
+            return undefined;
+        if (typeof data === 'string') {
+            try {
+                const parsed = JSON.parse(data);
+                return parsed.message || parsed.error || parsed.errors || 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;
+    }
     /**
      * Calculate MD5 checksum of a file, returning base64-encoded result
      * This matches ActiveStorage's checksum format

package/dist/utils/connectivity.d.ts

@@ -15,7 +15,8 @@ export interface ConnectivityCheckResult {
 }
 /**
  * Check if the system has internet connectivity by testing against
- * multiple reliable third-party endpoints with detailed diagnostics.
+ * multiple reliable third-party endpoints in parallel.
+ * Returns as soon as one endpoint succeeds, reducing latency significantly.
  */
 export declare function checkInternetConnectivity(): Promise<ConnectivityCheckResult>;
 /**

package/dist/utils/connectivity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connectivity.d.ts","sourceRoot":"","sources":["../../src/utils/connectivity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAmFlF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,uBAAuB,GAC9B,MAAM,CAuBR"}
+{"version":3,"file":"connectivity.d.ts","sourceRoot":"","sources":["../../src/utils/connectivity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AA4DD;;;;GAIG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CA4ClF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,uBAAuB,GAC9B,MAAM,CAuBR"}

package/dist/utils/connectivity.js

@@ -5,9 +5,66 @@
 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 with detailed diagnostics.
+ * multiple reliable third-party endpoints in parallel.
+ * Returns as soon as one endpoint succeeds, reducing latency significantly.
  */
 async function checkInternetConnectivity() {
     const testEndpoints = [
@@ -18,79 +75,35 @@ async function checkInternetConnectivity() {
         },
         { 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;
+    // 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;
             }
-        }
-        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,
-            });
-        }
+            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)`,
+        };
     }
-    let message;
-    if (anySuccess) {
-        const successfulEndpoint = endpointResults.find((r) => r.success);
-        message = `Internet connectivity verified via ${successfulEndpoint?.endpoint} (${successfulEndpoint?.latencyMs}ms)`;
-    }
-    else {
+    catch (aggregateError) {
+        // All endpoints failed - collect all results
+        const endpointResults = await Promise.all(endpointPromises);
         const testedEndpoints = endpointResults.map((r) => r.endpoint).join(', ');
-        message = `No internet connectivity detected. Tested endpoints: ${testedEndpoints}`;
+        return {
+            connected: false,
+            endpointResults,
+            message: `No internet connectivity detected. Tested endpoints: ${testedEndpoints}`,
+        };
     }
-    return {
-        connected: anySuccess,
-        endpointResults,
-        message,
-    };
 }
 /**
  * Format connectivity check results for display

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

@@ -6,6 +6,24 @@ declare const _default: {
      * Returns: -1 if v1 < v2, 0 if equal, 1 if v1 > v2
      */
     compareVersions(v1: string, v2: string): number;
+    /**
+     * Check if a device specification is a wildcard or regex pattern
+     */
+    isWildcardDevice(device: string | undefined): boolean;
+    /**
+     * Check if a version specification is a wildcard or regex pattern
+     */
+    isWildcardVersion(version: string | undefined): boolean;
+    /**
+     * Show info message when running many flows on a specific real device without sharding
+     */
+    showRealDeviceFlowsInfo(options: {
+        realDevice: boolean;
+        device?: string;
+        version?: string;
+        flowCount: number;
+        shardSplit?: number;
+    }): void;
     /**
      * Check if a newer version is available and display update notice
      */

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,wBAuDE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";oBAQkB,MAAM;yBAID,MAAM;IAI3B;;;OAGG;wBACiB,MAAM,MAAM,MAAM,GAAG,MAAM;IAa/C;;OAEG;6BACsB,MAAM,GAAG,SAAS,GAAG,OAAO;IAMrD;;OAEG;+BACwB,MAAM,GAAG,SAAS,GAAG,OAAO;IAMvD;;OAEG;qCAC8B;QAC/B,UAAU,EAAE,OAAO,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI;IAuDR;;OAEG;kCAC2B,MAAM,GAAG,SAAS,GAAG,IAAI;;AA/GzD,wBAyIE"}

package/dist/utils.js

@@ -5,8 +5,9 @@ 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;
+let realDeviceFlowsInfoDisplayed = false;
 exports.default = {
     getUserAgent() {
         return `TestingBot-CTL-${package_json_1.default.version}`;
@@ -31,6 +32,56 @@ exports.default = {
         }
         return 0;
     },
+    /**
+     * Check if a device specification is a wildcard or regex pattern
+     */
+    isWildcardDevice(device) {
+        if (!device)
+            return true;
+        // Check for common wildcard/regex characters
+        return device === '*' || device.includes('*') || device.includes('?') || device.includes('.*');
+    },
+    /**
+     * Check if a version specification is a wildcard or regex pattern
+     */
+    isWildcardVersion(version) {
+        if (!version)
+            return true;
+        // Check for common wildcard/regex characters
+        return version === '*' || version.includes('*') || version.includes('?') || version.includes('.*');
+    },
+    /**
+     * Show info message when running many flows on a specific real device without sharding
+     */
+    showRealDeviceFlowsInfo(options) {
+        // Only show once
+        if (realDeviceFlowsInfoDisplayed) {
+            return;
+        }
+        // Check conditions: real device, specific device, more than 2 flows, no shards
+        if (!options.realDevice ||
+            this.isWildcardDevice(options.device) ||
+            options.flowCount <= 2 ||
+            options.shardSplit) {
+            return;
+        }
+        realDeviceFlowsInfoDisplayed = true;
+        const border = '─'.repeat(80);
+        logger_1.default.info('');
+        logger_1.default.info(picocolors_1.default.cyan(border));
+        logger_1.default.info(picocolors_1.default.cyan('ℹ  Performance Tip'));
+        logger_1.default.info(picocolors_1.default.cyan(`   Running ${options.flowCount} flows on a specific device (${options.device}) in real device mode.`));
+        logger_1.default.info(picocolors_1.default.cyan('   Each flow runs in its own session on that device, which may be slow.'));
+        logger_1.default.info(picocolors_1.default.cyan(''));
+        logger_1.default.info(picocolors_1.default.cyan('   Consider these alternatives for faster execution:'));
+        logger_1.default.info(picocolors_1.default.cyan(`   • Use ${picocolors_1.default.white('--shard-split <n>')} to run multiple flows in the same session`));
+        logger_1.default.info(picocolors_1.default.cyan(`   • Use wildcards for device (e.g., ${picocolors_1.default.white('"Pixel.*"')}) to parallelize across devices`));
+        if (!this.isWildcardVersion(options.version)) {
+            logger_1.default.info(picocolors_1.default.cyan(`   • Use wildcards for version (e.g., ${picocolors_1.default.white('"15.*"')}) for broader device selection`));
+        }
+        logger_1.default.info(picocolors_1.default.cyan(border));
+        logger_1.default.info('');
+    },
     /**
      * Check if a newer version is available and display update notice
      */
@@ -42,12 +93,12 @@ exports.default = {
         if (this.compareVersions(currentVersion, latestVersion) < 0) {
             versionCheckDisplayed = true;
             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');
+            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,7 +1,7 @@
 {
   "name": "@testingbot/cli",
-  "version": "1.0.2",
-  "description": "CLI tool to run Espresso, XCUITest, and Maestro tests on TestingBot's cloud infrastructure",
+  "version": "1.0.4",
+  "description": "CLI tool to run Espresso, XCUITest and Maestro tests on TestingBot's cloud infrastructure",
   "main": "dist/index.js",
   "bin": {
     "testingbot": "dist/index.js"
@@ -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"