@devicecloud.dev/dcd 4.2.2 → 4.2.4

package/dist/commands/cloud.d.ts

@@ -55,6 +55,7 @@ export default class Cloud extends Command {
         'ios-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         orientation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'maestro-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'app-binary-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'app-file': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/dist/commands/cloud.js

@@ -202,6 +202,10 @@ class Cloud extends core_1.Command {
             this.deviceValidationService.validateiOSDevice(iOSVersion, iOSDevice, compatibilityData, { debug, logger: this.log.bind(this) });
             // Validate Android device configuration
             this.deviceValidationService.validateAndroidDevice(androidApiLevel, androidDevice, googlePlay, compatibilityData, { debug, logger: this.log.bind(this) });
+            // Warn if maestro-chrome-onboarding flag is used without Android devices
+            if (flags['maestro-chrome-onboarding'] && !androidApiLevel && !androidDevice) {
+                this.warn('The --maestro-chrome-onboarding flag only applies to Android tests and will be ignored for iOS tests.');
+            }
             flowFile = path.resolve(flowFile);
             if (!flowFile?.endsWith('.yaml') &&
                 !flowFile?.endsWith('.yml') &&
@@ -383,6 +387,7 @@ class Cloud extends core_1.Command {
                 retry,
                 runnerType,
                 showCrosshairs: flags['show-crosshairs'],
+                maestroChromeOnboarding: flags['maestro-chrome-onboarding'],
             });
             if (debug) {
                 this.log(`[DEBUG] Submitting flow upload request to ${apiUrl}/uploads/flow`);

package/dist/commands/status.d.ts

@@ -12,13 +12,13 @@ type StatusResponse = {
     createdAt?: string;
     error?: string;
     name?: string;
-    status: 'CANCELLED' | 'FAILED' | 'PASSED' | 'PENDING' | 'RUNNING';
+    status: 'CANCELLED' | 'FAILED' | 'PASSED' | 'PENDING' | 'QUEUED' | 'RUNNING';
     tests: {
         createdAt?: string;
         durationSeconds?: number;
         failReason?: string;
         name: string;
-        status: 'CANCELLED' | 'FAILED' | 'PASSED' | 'PENDING' | 'RUNNING';
+        status: 'CANCELLED' | 'FAILED' | 'PASSED' | 'PENDING' | 'QUEUED' | 'RUNNING';
     }[];
     uploadId?: string;
 };

package/dist/config/flags/device.flags.d.ts

@@ -10,4 +10,5 @@ export declare const deviceFlags: {
     'ios-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     orientation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    'maestro-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
 };

package/dist/config/flags/device.flags.js

@@ -32,11 +32,15 @@ exports.deviceFlags = {
         options: Object.values(device_types_1.EiOSVersions),
     }),
     orientation: core_1.Flags.string({
-        description: '[Android only] The orientation of the device to run your flow against in degrees',
+        description: '[Android only] The orientation of the device to run your flow against (0 = portrait, 90 = landscape)',
         options: ['0', '90'],
     }),
     'show-crosshairs': core_1.Flags.boolean({
         default: false,
         description: '[Android only] Display crosshairs for screen interactions during test execution',
     }),
+    'maestro-chrome-onboarding': core_1.Flags.boolean({
+        default: false,
+        description: '[Android only] Force Maestro-based Chrome onboarding - note: this will slow your tests but can fix browser related crashes. See https://docs.devicecloud.dev/reference/chrome-onboarding for more information.',
+    }),
 };

package/dist/config/flags/output.flags.js

@@ -12,15 +12,15 @@ exports.outputFlags = {
     }),
     'junit-path': core_1.Flags.string({
         dependsOn: ['report'],
-        description: 'Custom file path for downloaded JUnit report (default: ./report.xml)',
+        description: 'Custom file path for downloaded JUnit report (requires --report junit, default: ./report.xml)',
     }),
     'allure-path': core_1.Flags.string({
         dependsOn: ['report'],
-        description: 'Custom file path for downloaded Allure report (default: ./report.html)',
+        description: 'Custom file path for downloaded Allure report (requires --report allure, default: ./report.html)',
     }),
     'html-path': core_1.Flags.string({
         dependsOn: ['report'],
-        description: 'Custom file path for downloaded HTML report (default: ./report.html)',
+        description: 'Custom file path for downloaded HTML report (requires --report html, default: ./report.html)',
     }),
     async: core_1.Flags.boolean({
         description: 'Immediately return (exit code 0) from the command without waiting for the results of the run (useful for saving CI minutes)',
@@ -41,7 +41,7 @@ exports.outputFlags = {
         description: 'Output results in JSON format - note: will always provide exit code 0',
     }),
     'json-file': core_1.Flags.boolean({
-        description: 'Write JSON output to a file. File be called <upload_id>_dcd.json unless you supply the --json-file-name flag - note: will always exit with code 0',
+        description: 'Write JSON output to a file. File will be called <upload_id>_dcd.json unless you supply the --json-file-name flag - note: will always exit with code 0',
         required: false,
     }),
     'json-file-name': core_1.Flags.string({
@@ -51,7 +51,7 @@ exports.outputFlags = {
     quiet: core_1.Flags.boolean({
         char: 'q',
         default: false,
-        description: 'Quieter console output that wont provide progress updates',
+        description: "Quieter console output that won't provide progress updates",
     }),
     report: core_1.Flags.string({
         aliases: ['format'],

package/dist/constants.d.ts

@@ -42,6 +42,7 @@ export declare const flags: {
     'ios-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     orientation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    'maestro-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     'app-binary-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'app-file': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/dist/services/execution-plan.service.js

@@ -259,7 +259,8 @@ async function plan(options) {
     if (workspaceConfig.executionOrder?.flowsOrder &&
         workspaceConfig.executionOrder.flowsOrder.length > 0 &&
         flowsToRunInSequence.length === 0) {
-        throw new Error(`executionOrder specified ${workspaceConfig.executionOrder.flowsOrder.length} flow(s) but none were found.\n\n` +
+        console.warn(`Warning: executionOrder specified ${workspaceConfig.executionOrder.flowsOrder.length} flow(s) but none were found.\n` +
+            `This may be intentional if flows were excluded by tags.\n\n` +
             `Expected flows: ${workspaceConfig.executionOrder.flowsOrder.join(', ')}\n` +
             `Available flow names: ${Object.keys(pathsByName).join(', ')}\n\n` +
             `Hint: Flow names come from either the 'name' field in the flow config or the filename without extension.`);

package/dist/services/execution-plan.utils.js

@@ -27,15 +27,20 @@ function getFlowsToRunInSequence(paths, flowOrder, debug = false) {
     }
     if (namesInOrder.length === 0) {
         const notFound = [...orderSet].filter((item) => !availableNames.includes(item));
-        throw new Error(`Could not find flows specified in executionOrder.flowsOrder: ${notFound.join(', ')}\n\n` +
+        console.warn(`Warning: Could not find flows specified in executionOrder.flowsOrder: ${notFound.join(', ')}\n` +
+            `This may be intentional if flows were excluded by tags.\n` +
             `Available flow names:\n${availableNames.join('\n')}`);
+        return [];
     }
     const result = [...orderSet].filter((item) => namesInOrder.includes(item));
     if (result.length === 0) {
         const notFound = [...orderSet].filter((item) => !namesInOrder.includes(item));
-        throw new Error(`Could not find flows needed for execution in order: ${notFound.join(', ')}\n\nAvailable flow names:\n${availableNames.join('\n')}`);
+        console.warn(`Warning: Could not find flows needed for execution in order: ${notFound.join(', ')}\n` +
+            `This may be intentional if flows were excluded by tags.\n` +
+            `Available flow names:\n${availableNames.join('\n')}`);
+        return [];
     }
-    else if (flowOrder
+    if (flowOrder
         .slice(0, result.length)
         .every((value, index) => value === result[index])) {
         const resolvedPaths = result.map((item) => paths[item]);
@@ -44,12 +49,10 @@ function getFlowsToRunInSequence(paths, flowOrder, debug = false) {
         }
         return resolvedPaths;
     }
-    else {
-        throw new Error(`Flow order mismatch in executionOrder.flowsOrder.\n\n` +
-            `Expected order: [${flowOrder.slice(0, result.length).join(', ')}]\n` +
-            `Actual order: [${result.join(', ')}]\n\n` +
-            `Please ensure flows are specified in the correct order.`);
-    }
+    throw new Error(`Flow order mismatch in executionOrder.flowsOrder.\n\n` +
+        `Expected order: [${flowOrder.slice(0, result.length).join(', ')}]\n` +
+        `Actual order: [${result.join(', ')}]\n\n` +
+        `Please ensure flows are specified in the correct order.`);
 }
 function isFlowFile(filePath) {
     // Exclude files inside .app bundles

package/dist/services/results-polling.service.js

@@ -46,7 +46,7 @@ class ResultsPollingService {
                 const updatedResults = await this.fetchAndLogResults(apiUrl, apiKey, uploadId, debug, logger);
                 const { summary } = this.calculateStatusSummary(updatedResults);
                 previousSummary = this.updateDisplayStatus(updatedResults, quiet, json, summary, previousSummary);
-                const allComplete = updatedResults.every((result) => !['PENDING', 'RUNNING'].includes(result.status));
+                const allComplete = updatedResults.every((result) => !['PENDING', 'QUEUED', 'RUNNING'].includes(result.status));
                 if (allComplete) {
                     return await this.handleCompletedTests(updatedResults, {
                         consoleUrl,
@@ -98,6 +98,7 @@ class ResultsPollingService {
         const passed = statusCounts.PASSED || 0;
         const failed = statusCounts.FAILED || 0;
         const pending = statusCounts.PENDING || 0;
+        const queued = statusCounts.QUEUED || 0;
         const running = statusCounts.RUNNING || 0;
         const total = results.length;
         const completed = passed + failed;
@@ -106,10 +107,11 @@ class ResultsPollingService {
             failed,
             passed,
             pending,
+            queued,
             running,
             total,
         });
-        return { completed, failed, passed, pending, running, summary, total };
+        return { completed, failed, passed, pending, queued, running, summary, total };
     }
     displayFinalResults(results, consoleUrl, json, logger) {
         if (json) {
@@ -144,6 +146,9 @@ class ResultsPollingService {
                         case 'PENDING': {
                             return styling_1.colors.warning(row.status);
                         }
+                        case 'QUEUED': {
+                            return styling_1.colors.dim(row.status);
+                        }
                         default: {
                             return styling_1.colors.dim(row.status);
                         }
@@ -309,7 +314,9 @@ class ResultsPollingService {
                         ? styling_1.colors.error(status.padEnd(10, ' '))
                         : status.toUpperCase() === 'RUNNING'
                             ? styling_1.colors.info(status.padEnd(10, ' '))
-                            : styling_1.colors.warning(status.padEnd(10, ' '));
+                            : status.toUpperCase() === 'QUEUED'
+                                ? styling_1.colors.dim(status.padEnd(10, ' '))
+                                : styling_1.colors.warning(status.padEnd(10, ' '));
                 const retryText = isRetry ? styling_1.colors.dim(' (retry)') : '';
                 core_1.ux.action.status += `\n${statusFormatted}  ${test}${retryText}`;
             }

package/dist/services/test-submission.service.d.ts

@@ -15,6 +15,7 @@ export interface TestSubmissionConfig {
     iOSDevice?: string;
     iOSVersion?: string;
     logger?: (message: string) => void;
+    maestroChromeOnboarding?: boolean;
     maestroVersion: string;
     metadata?: string[];
     mitmHost?: string;

package/dist/services/test-submission.service.js

@@ -17,7 +17,7 @@ class TestSubmissionService {
      * @returns FormData ready to be submitted to the API
      */
     async buildTestFormData(config) {
-        const { appBinaryId, flowFile, executionPlan, commonRoot, cliVersion, env = [], metadata = [], googlePlay = false, androidApiLevel, androidDevice, iOSVersion, iOSDevice, name, runnerType, maestroVersion, deviceLocale, orientation, mitmHost, mitmPath, retry, continueOnFailure = true, report, showCrosshairs, raw, debug = false, logger, } = config;
+        const { appBinaryId, flowFile, executionPlan, commonRoot, cliVersion, env = [], metadata = [], googlePlay = false, androidApiLevel, androidDevice, iOSVersion, iOSDevice, name, runnerType, maestroVersion, deviceLocale, orientation, mitmHost, mitmPath, retry, continueOnFailure = true, report, showCrosshairs, maestroChromeOnboarding, raw, debug = false, logger, } = config;
         const { allExcludeTags, allIncludeTags, flowMetadata, flowOverrides, flowsToRun: testFileNames, referencedFiles, sequence, workspaceConfig, } = executionPlan;
         const { flows: sequentialFlows = [] } = sequence ?? {};
         const testFormData = new FormData();
@@ -79,6 +79,7 @@ class TestSubmissionService {
             raw: JSON.stringify(raw),
             report,
             showCrosshairs,
+            maestroChromeOnboarding,
             version: cliVersion,
         };
         testFormData.set('config', JSON.stringify(configPayload));

package/dist/utils/styling.d.ts

@@ -11,6 +11,7 @@ export declare const symbols: {
     readonly error: string;
     readonly info: string;
     readonly pending: string;
+    readonly queued: string;
     readonly running: string;
     readonly success: string;
     readonly unknown: string;
@@ -86,6 +87,7 @@ export declare function formatTestSummary(summary: {
     failed: number;
     passed: number;
     pending: number;
+    queued: number;
     running: number;
     total: number;
 }): string;

package/dist/utils/styling.js

@@ -23,6 +23,7 @@ exports.symbols = {
     error: chalk.red('✗'),
     info: chalk.blue('ℹ'),
     pending: chalk.yellow('⏸'),
+    queued: chalk.gray('⏳'),
     running: chalk.blue('▶'),
     success: chalk.green('✓'),
     unknown: chalk.gray('?'),
@@ -69,6 +70,9 @@ function formatStatus(status) {
         case 'PENDING': {
             return `${exports.symbols.pending} ${exports.colors.warning(status)}`;
         }
+        case 'QUEUED': {
+            return `${exports.symbols.queued} ${exports.colors.dim(status)}`;
+        }
         case 'CANCELLED': {
             return `${exports.symbols.cancelled} ${exports.colors.dim(status)}`;
         }
@@ -132,6 +136,7 @@ function formatTestSummary(summary) {
         exports.colors.error(`✗ ${summary.failed}`),
         exports.colors.info(`▶ ${summary.running}`),
         exports.colors.warning(`⏸ ${summary.pending}`),
+        exports.colors.dim(`⏳ ${summary.queued}`),
     ];
     return parts.join(' │ ');
 }

package/oclif.manifest.json

@@ -153,7 +153,7 @@
           "type": "option"
         },
         "orientation": {
-          "description": "[Android only] The orientation of the device to run your flow against in degrees",
+          "description": "[Android only] The orientation of the device to run your flow against (0 = portrait, 90 = landscape)",
           "name": "orientation",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -169,6 +169,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "maestro-chrome-onboarding": {
+          "description": "[Android only] Force Maestro-based Chrome onboarding - note: this will slow your tests but can fix browser related crashes. See https://docs.devicecloud.dev/reference/chrome-onboarding for more information.",
+          "name": "maestro-chrome-onboarding",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "char": "e",
           "description": "One or more environment variables to inject into your flows",
@@ -309,7 +315,7 @@
           "dependsOn": [
             "report"
           ],
-          "description": "Custom file path for downloaded JUnit report (default: ./report.xml)",
+          "description": "Custom file path for downloaded JUnit report (requires --report junit, default: ./report.xml)",
           "name": "junit-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -319,7 +325,7 @@
           "dependsOn": [
             "report"
           ],
-          "description": "Custom file path for downloaded Allure report (default: ./report.html)",
+          "description": "Custom file path for downloaded Allure report (requires --report allure, default: ./report.html)",
           "name": "allure-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -329,7 +335,7 @@
           "dependsOn": [
             "report"
           ],
-          "description": "Custom file path for downloaded HTML report (default: ./report.html)",
+          "description": "Custom file path for downloaded HTML report (requires --report html, default: ./report.html)",
           "name": "html-path",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -365,7 +371,7 @@
           "type": "boolean"
         },
         "json-file": {
-          "description": "Write JSON output to a file. File be called <upload_id>_dcd.json unless you supply the --json-file-name flag - note: will always exit with code 0",
+          "description": "Write JSON output to a file. File will be called <upload_id>_dcd.json unless you supply the --json-file-name flag - note: will always exit with code 0",
           "name": "json-file",
           "required": false,
           "allowNo": false,
@@ -383,7 +389,7 @@
         },
         "quiet": {
           "char": "q",
-          "description": "Quieter console output that wont provide progress updates",
+          "description": "Quieter console output that won't provide progress updates",
           "name": "quiet",
           "allowNo": false,
           "type": "boolean"
@@ -661,5 +667,5 @@
       ]
     }
   },
-  "version": "4.2.2"
+  "version": "4.2.4"
 }

package/package.json

@@ -67,7 +67,7 @@
     "type": "git",
     "url": "https://devicecloud.dev"
   },
-  "version": "4.2.2",
+  "version": "4.2.4",
   "bugs": {
     "url": "https://discord.gg/gm3mJwcNw8"
   },