@devicecloud.dev/dcd 4.2.4 → 4.2.5

package/dist/commands/cloud.d.ts

@@ -6,7 +6,7 @@ import { Command } from '@oclif/core';
  * - Flow file analysis and dependency resolution
  * - Device compatibility validation
  * - Test submission with parallel execution
- * - Real-time result polling with 5-second intervals
+ * - Real-time result polling with 10-second intervals
  * - Artifact download (reports, videos, logs)
  *
  * Replaces `maestro cloud` with DeviceCloud-specific functionality.
@@ -56,6 +56,7 @@ export default class Cloud extends Command {
         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>;
+        'android-no-snapshot': 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>;
@@ -68,7 +69,7 @@ export default class Cloud extends Command {
     private moropoService;
     /** Service for downloading test reports and artifacts */
     private reportDownloadService;
-    /** Service for polling test results with 5-second intervals */
+    /** Service for polling test results with 10-second intervals */
     private resultsPollingService;
     /** Service for submitting tests to the API */
     private testSubmissionService;

package/dist/commands/cloud.js

@@ -31,7 +31,7 @@ process.on('warning', (warning) => {
  * - Flow file analysis and dependency resolution
  * - Device compatibility validation
  * - Test submission with parallel execution
- * - Real-time result polling with 5-second intervals
+ * - Real-time result polling with 10-second intervals
  * - Artifact download (reports, videos, logs)
  *
  * Replaces `maestro cloud` with DeviceCloud-specific functionality.
@@ -59,7 +59,7 @@ class Cloud extends core_1.Command {
     moropoService = new moropo_service_1.MoropoService();
     /** Service for downloading test reports and artifacts */
     reportDownloadService = new report_download_service_1.ReportDownloadService();
-    /** Service for polling test results with 5-second intervals */
+    /** Service for polling test results with 10-second intervals */
     resultsPollingService = new results_polling_service_1.ResultsPollingService();
     /** Service for submitting tests to the API */
     testSubmissionService = new test_submission_service_1.TestSubmissionService();
@@ -95,7 +95,7 @@ class Cloud extends core_1.Command {
         let jsonFile = false;
         try {
             const { args, flags, raw } = await this.parse(Cloud);
-            let { 'android-api-level': androidApiLevel, 'android-device': androidDevice, apiKey: apiKeyFlag, apiUrl, 'app-binary-id': appBinaryId, 'app-file': appFile, 'artifacts-path': artifactsPath, 'junit-path': junitPath, 'allure-path': allurePath, 'html-path': htmlPath, async, config: configFile, debug, 'device-locale': deviceLocale, 'download-artifacts': downloadArtifacts, 'dry-run': dryRun, env, 'exclude-flows': excludeFlows, 'exclude-tags': excludeTags, flows, 'google-play': googlePlay, 'ignore-sha-check': ignoreShaCheck, 'include-tags': includeTags, 'ios-device': iOSDevice, 'ios-version': iOSVersion, json, 'json-file-name': jsonFileName, 'maestro-version': maestroVersion, metadata, mitmHost, mitmPath, 'moropo-v1-api-key': moropoApiKey, name, orientation, quiet, report, retry, 'runner-type': runnerType, } = flags;
+            let { 'android-api-level': androidApiLevel, 'android-device': androidDevice, apiKey: apiKeyFlag, apiUrl, 'app-binary-id': appBinaryId, 'app-file': appFile, 'artifacts-path': artifactsPath, 'junit-path': junitPath, 'allure-path': allurePath, 'html-path': htmlPath, async, config: configFile, debug, 'device-locale': deviceLocale, 'download-artifacts': downloadArtifacts, 'dry-run': dryRun, env, 'exclude-flows': excludeFlows, 'exclude-tags': excludeTags, flows, 'google-play': googlePlay, 'ignore-sha-check': ignoreShaCheck, 'include-tags': includeTags, 'ios-device': iOSDevice, 'ios-version': iOSVersion, json, 'json-file-name': jsonFileName, 'maestro-version': maestroVersion, metadata, mitmHost, mitmPath, 'moropo-v1-api-key': moropoApiKey, name, orientation, quiet, report, retry, 'runner-type': runnerType, 'android-no-snapshot': androidNoSnapshot, } = flags;
             // Store debug flag for use in catch block
             debugFlag = debug === true;
             jsonFile = flags['json-file'] === true;
@@ -242,7 +242,7 @@ class Cloud extends core_1.Command {
                 }
                 throw error;
             }
-            const { allExcludeTags, allIncludeTags, flowOverrides, flowsToRun: testFileNames, referencedFiles, sequence, } = executionPlan;
+            const { allExcludeTags, allIncludeTags, flowMetadata, flowOverrides, flowsToRun: testFileNames, referencedFiles, sequence, } = executionPlan;
             if (debug) {
                 this.log(`[DEBUG] All include tags: ${allIncludeTags?.join(', ') || 'none'}`);
                 this.log(`[DEBUG] All exclude tags: ${allExcludeTags?.join(', ') || 'none'}`);
@@ -263,6 +263,21 @@ class Cloud extends core_1.Command {
             if (debug) {
                 this.log(`[DEBUG] Common root directory: ${commonRoot}`);
             }
+            // Build testMetadataMap from flowMetadata (keyed by normalized test file name)
+            // This map provides flowName and tags for each test for JSON output
+            const testMetadataMap = {};
+            for (const [absolutePath, metadata] of Object.entries(flowMetadata)) {
+                // Normalize the path to match the format used in results (e.g., "./flows/test.yaml")
+                const normalizedPath = absolutePath.replaceAll(commonRoot, '.').split(path.sep).join('/');
+                const metadataRecord = metadata;
+                const flowName = metadataRecord?.name || path.parse(absolutePath).name;
+                const rawTags = metadataRecord?.tags;
+                const tags = Array.isArray(rawTags) ? rawTags.map(String) : (rawTags ? [String(rawTags)] : []);
+                testMetadataMap[normalizedPath] = { flowName, tags };
+            }
+            if (debug) {
+                this.log(`[DEBUG] Built testMetadataMap for ${Object.keys(testMetadataMap).length} flows`);
+            }
             const { continueOnFailure = true, flows: sequentialFlows = [] } = sequence ?? {};
             if (debug && sequentialFlows.length > 0) {
                 this.log(`[DEBUG] Sequential flows: ${sequentialFlows.join(', ')}`);
@@ -363,6 +378,7 @@ class Cloud extends core_1.Command {
             const testFormData = await this.testSubmissionService.buildTestFormData({
                 androidApiLevel,
                 androidDevice,
+                androidNoSnapshot,
                 appBinaryId: finalBinaryId,
                 cliVersion: this.config.version,
                 commonRoot,
@@ -420,8 +436,11 @@ class Cloud extends core_1.Command {
                     consoleUrl: url,
                     status: 'PENDING',
                     tests: results.map((r) => ({
+                        fileName: r.test_file_name,
+                        flowName: testMetadataMap[r.test_file_name]?.flowName || path.parse(r.test_file_name).name,
                         name: r.test_file_name,
                         status: r.status,
+                        tags: testMetadataMap[r.test_file_name]?.tags || [],
                     })),
                     uploadId: results[0].test_upload_id,
                 };
@@ -446,7 +465,7 @@ class Cloud extends core_1.Command {
                 logger: this.log.bind(this),
                 quiet,
                 uploadId: results[0].test_upload_id,
-            })
+            }, testMetadataMap)
                 .catch(async (error) => {
                 if (error instanceof results_polling_service_1.RunFailedError) {
                     // Handle failed test run

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

@@ -11,4 +11,5 @@ export declare const deviceFlags: {
     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>;
+    'android-no-snapshot': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
 };

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

@@ -43,4 +43,8 @@ exports.deviceFlags = {
         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.',
     }),
+    'android-no-snapshot': core_1.Flags.boolean({
+        default: false,
+        description: '[Android only] Force cold boot instead of using snapshot boot. This is automatically enabled for API 35+ but can be used to force cold boot on older API levels.',
+    }),
 };

package/dist/constants.d.ts

@@ -43,6 +43,7 @@ export declare const flags: {
     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>;
+    'android-no-snapshot': 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

@@ -211,7 +211,8 @@ async function plan(options) {
     const flowOverrides = {};
     const allFlows = unfilteredFlowFiles.filter((filePath) => {
         const config = configPerFlowFile[filePath];
-        const tags = config?.tags || [];
+        const rawTags = config?.tags;
+        const tags = Array.isArray(rawTags) ? rawTags : (rawTags ? [rawTags] : []);
         if (config) {
             flowMetadata[filePath] = config;
             flowOverrides[filePath] = extractDeviceCloudOverrides(config);

package/dist/services/results-polling.service.d.ts

@@ -17,14 +17,28 @@ export interface PollingOptions {
     quiet?: boolean;
     uploadId: string;
 }
+/** Metadata for a test flow extracted from YAML config */
+export interface TestMetadata {
+    /** Flow name from YAML config 'name' field or filename without extension */
+    flowName: string;
+    /** Tags from YAML config 'tags' field */
+    tags: string[];
+}
 export interface PollingResult {
     consoleUrl: string;
     status: 'FAILED' | 'PASSED';
     tests: Array<{
         durationSeconds: null | number;
         failReason?: string;
+        /** File path of the test (same as name, for clarity) */
+        fileName: string;
+        /** Flow name from YAML config or filename without extension */
+        flowName: string;
+        /** Test file name (unchanged for backwards compatibility) */
         name: string;
         status: string;
+        /** Tags from YAML config (empty array if none) */
+        tags: string[];
     }>;
     uploadId: string;
 }
@@ -38,9 +52,10 @@ export declare class ResultsPollingService {
      * Poll for test results until all tests complete
      * @param results Initial test results from submission
      * @param options Polling configuration
+     * @param testMetadata Optional metadata map for each test (flowName, tags)
      * @returns Promise that resolves with final test results or rejects if tests fail
      */
-    pollUntilComplete(results: TestResult[], options: PollingOptions): Promise<PollingResult>;
+    pollUntilComplete(results: TestResult[], options: PollingOptions, testMetadata?: Record<string, TestMetadata>): Promise<PollingResult>;
     private buildPollingResult;
     private calculateStatusSummary;
     private displayFinalResults;

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResultsPollingService = exports.RunFailedError = void 0;
 const core_1 = require("@oclif/core");
 const cli_ux_1 = require("@oclif/core/lib/cli-ux");
+const path = require("node:path");
 const api_gateway_1 = require("../gateways/api-gateway");
 const methods_1 = require("../methods");
 const connectivity_1 = require("../utils/connectivity");
@@ -24,14 +25,15 @@ exports.RunFailedError = RunFailedError;
  */
 class ResultsPollingService {
     MAX_SEQUENTIAL_FAILURES = 10;
-    POLL_INTERVAL_MS = 5000;
+    POLL_INTERVAL_MS = 10_000;
     /**
      * Poll for test results until all tests complete
      * @param results Initial test results from submission
      * @param options Polling configuration
+     * @param testMetadata Optional metadata map for each test (flowName, tags)
      * @returns Promise that resolves with final test results or rejects if tests fail
      */
-    async pollUntilComplete(results, options) {
+    async pollUntilComplete(results, options, testMetadata) {
         const { apiUrl, apiKey, uploadId, consoleUrl, quiet = false, json = false, debug = false, logger } = options;
         this.initializePollingDisplay(json, logger);
         let sequentialPollFailures = 0;
@@ -53,6 +55,7 @@ class ResultsPollingService {
                         debug,
                         json,
                         logger,
+                        testMetadata,
                         uploadId,
                     });
                 }
@@ -74,7 +77,7 @@ class ResultsPollingService {
             }
         }
     }
-    buildPollingResult(results, uploadId, consoleUrl) {
+    buildPollingResult(results, uploadId, consoleUrl, testMetadata) {
         const resultsWithoutEarlierTries = this.filterLatestResults(results);
         return {
             consoleUrl,
@@ -84,8 +87,11 @@ class ResultsPollingService {
             tests: resultsWithoutEarlierTries.map((r) => ({
                 durationSeconds: r.duration_seconds,
                 failReason: r.status === 'FAILED' ? r.fail_reason || 'No reason provided' : undefined,
+                fileName: r.test_file_name,
+                flowName: testMetadata?.[r.test_file_name]?.flowName || path.parse(r.test_file_name).name,
                 name: r.test_file_name,
                 status: r.status,
+                tags: testMetadata?.[r.test_file_name]?.tags || [],
             })),
             uploadId,
         };
@@ -219,12 +225,12 @@ class ResultsPollingService {
      * @returns Promise resolving to final polling result
      */
     async handleCompletedTests(updatedResults, options) {
-        const { uploadId, consoleUrl, json, debug, logger } = options;
+        const { uploadId, consoleUrl, json, debug, logger, testMetadata } = options;
         if (debug && logger) {
             logger(`[DEBUG] All tests completed, stopping poll`);
         }
         this.displayFinalResults(updatedResults, consoleUrl, json, logger);
-        const output = this.buildPollingResult(updatedResults, uploadId, consoleUrl);
+        const output = this.buildPollingResult(updatedResults, uploadId, consoleUrl, testMetadata);
         if (output.status === 'FAILED') {
             if (debug && logger) {
                 logger(`[DEBUG] Some tests failed, returning failed status`);

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

@@ -2,6 +2,7 @@ import { IExecutionPlan } from './execution-plan.service';
 export interface TestSubmissionConfig {
     androidApiLevel?: string;
     androidDevice?: string;
+    androidNoSnapshot?: boolean;
     appBinaryId: string;
     cliVersion: string;
     commonRoot: 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, maestroChromeOnboarding, raw, debug = false, logger, } = config;
+        const { appBinaryId, flowFile, executionPlan, commonRoot, cliVersion, env = [], metadata = [], googlePlay = false, androidApiLevel, androidDevice, androidNoSnapshot, 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();
@@ -69,6 +69,7 @@ class TestSubmissionService {
         const configPayload = {
             allExcludeTags,
             allIncludeTags,
+            androidNoSnapshot,
             autoRetriesRemaining: retry,
             continueOnFailure,
             deviceLocale,

package/oclif.manifest.json

@@ -175,6 +175,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "android-no-snapshot": {
+          "description": "[Android only] Force cold boot instead of using snapshot boot. This is automatically enabled for API 35+ but can be used to force cold boot on older API levels.",
+          "name": "android-no-snapshot",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "char": "e",
           "description": "One or more environment variables to inject into your flows",
@@ -667,5 +673,5 @@
       ]
     }
   },
-  "version": "4.2.4"
+  "version": "4.2.5"
 }

package/package.json

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