@devicecloud.dev/dcd 3.7.11 → 4.0.0

package/dist/commands/status.js

@@ -2,16 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const constants_1 = require("../constants");
-const ApiGateway_1 = require("../gateways/ApiGateway");
+const api_gateway_1 = require("../gateways/api-gateway");
 const methods_1 = require("../methods");
 class Status extends core_1.Command {
     static description = 'Get the status of an upload by name or upload ID';
+    static enableJsonFlag = true;
     static examples = [
         '<%= config.bin %> <%= command.id %> --name my-upload-name',
         '<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --json',
     ];
-    static enableJsonFlag = true;
     static flags = {
+        apiKey: constants_1.flags.apiKey,
+        apiUrl: constants_1.flags.apiUrl,
         json: core_1.Flags.boolean({
             description: 'output in json format',
         }),
@@ -23,29 +25,18 @@ class Status extends core_1.Command {
             description: 'UUID of the upload to check status for',
             exclusive: ['name'],
         }),
-        apiKey: constants_1.flags.apiKey,
-        apiUrl: constants_1.flags.apiUrl,
     };
-    getStatusSymbol(status) {
-        switch (status) {
-            case 'PASSED':
-                return '✓';
-            case 'FAILED':
-                return '✗';
-            case 'CANCELLED':
-                return '⊘';
-            case 'PENDING':
-                return '⋯';
-            default:
-                return '?';
-        }
-    }
+    // eslint-disable-next-line complexity
     async run() {
         const { flags } = await this.parse(Status);
-        const { apiUrl, apiKey: apiKeyFlag, name, 'upload-id': uploadId, json, } = flags;
+        const { apiKey: apiKeyFlag, apiUrl, json, name, 'upload-id': uploadId, } = flags;
         const apiKey = apiKeyFlag || process.env.DEVICE_CLOUD_API_KEY;
         if (!apiKey) {
-            this.error('API Key is required. Please provide it via --api-key flag or DEVICE_CLOUD_API_KEY environment variable.');
+            this.error('API key is required. Please provide it via --api-key flag or DEVICE_CLOUD_API_KEY environment variable.');
+            return;
+        }
+        if (name && uploadId) {
+            this.error('Cannot provide both --name and --upload-id. These options are mutually exclusive.');
             return;
         }
         if (!name && !uploadId) {
@@ -56,7 +47,7 @@ class Status extends core_1.Command {
         let status = null;
         for (let attempt = 1; attempt <= 5; attempt++) {
             try {
-                status = (await ApiGateway_1.ApiGateway.getUploadStatus(apiUrl, apiKey, {
+                status = (await api_gateway_1.ApiGateway.getUploadStatus(apiUrl, apiKey, {
                     name,
                     uploadId,
                 }));
@@ -66,7 +57,9 @@ class Status extends core_1.Command {
                 lastError = error;
                 if (attempt < 5) {
                     this.log(`Network error on attempt ${attempt}/5. Retrying...`);
-                    await new Promise((resolve) => setTimeout(resolve, 1000 * attempt));
+                    await new Promise((resolve) => {
+                        setTimeout(resolve, 1000 * attempt);
+                    });
                 }
             }
         }
@@ -74,51 +67,47 @@ class Status extends core_1.Command {
             const errorMessage = `Failed to get status after 5 attempts. Check your network. Last error: ${lastError?.message || 'Unknown error'}`;
             if (json) {
                 return {
+                    attempts: 5,
+                    error: errorMessage,
                     status: 'FAILED',
                     tests: [],
-                    error: errorMessage,
-                    attempts: 5,
                 };
             }
-            else {
-                this.error(errorMessage);
-                return;
-            }
+            this.error(errorMessage);
+            return;
         }
         try {
             if (json) {
                 return status;
             }
-            else {
-                this.log('\n📊 Upload Status');
-                this.log('═'.repeat(80));
-                // Display overall status
-                const overallSymbol = this.getStatusSymbol(status.status);
-                this.log(`${overallSymbol}  Status:      ${status.status}`);
-                if (status.uploadId) {
-                    this.log(`🆔 Upload ID:   ${status.uploadId}`);
-                }
-                if (status.appBinaryId) {
-                    this.log(`📱 Binary ID:   ${status.appBinaryId}`);
-                }
-                if (status.consoleUrl) {
-                    this.log(`🔗 Console:     ${status.consoleUrl}`);
-                }
-                if (status.tests.length > 0) {
-                    this.log('\n📋 Test Results');
-                    this.log('─'.repeat(80));
-                    status.tests.forEach((item) => {
-                        const symbol = this.getStatusSymbol(item.status);
-                        this.log(`${symbol} ${item.name}`);
-                        this.log(`   Status: ${item.status}`);
-                        if (item.status === 'FAILED' && item.failReason) {
-                            this.log(`   Fail reason: ${item.failReason}`);
-                        }
-                        if (item.durationSeconds) {
-                            this.log(`   Duration: ${(0, methods_1.formatDurationSeconds)(item.durationSeconds)}`);
-                        }
-                        this.log('');
-                    });
+            this.log('\n📊 Upload Status');
+            this.log('═'.repeat(80));
+            // Display overall status
+            const overallSymbol = this.getStatusSymbol(status.status);
+            this.log(`${overallSymbol}  Status:      ${status.status}`);
+            if (status.uploadId) {
+                this.log(`🆔 Upload ID:   ${status.uploadId}`);
+            }
+            if (status.appBinaryId) {
+                this.log(`📱 Binary ID:   ${status.appBinaryId}`);
+            }
+            if (status.consoleUrl) {
+                this.log(`🔗 Console:     ${status.consoleUrl}`);
+            }
+            if (status.tests.length > 0) {
+                this.log('\n📋 Test Results');
+                this.log('─'.repeat(80));
+                for (const item of status.tests) {
+                    const symbol = this.getStatusSymbol(item.status);
+                    this.log(`${symbol} ${item.name}`);
+                    this.log(`   Status: ${item.status}`);
+                    if (item.status === 'FAILED' && item.failReason) {
+                        this.log(`   Fail reason: ${item.failReason}`);
+                    }
+                    if (item.durationSeconds) {
+                        this.log(`   Duration: ${(0, methods_1.formatDurationSeconds)(item.durationSeconds)}`);
+                    }
+                    this.log('');
                 }
             }
         }
@@ -126,5 +115,24 @@ class Status extends core_1.Command {
             this.error(`Failed to get status: ${error.message}`);
         }
     }
+    getStatusSymbol(status) {
+        switch (status) {
+            case 'PASSED': {
+                return '✓';
+            }
+            case 'FAILED': {
+                return '✗';
+            }
+            case 'CANCELLED': {
+                return '⊘';
+            }
+            case 'PENDING': {
+                return '⋯';
+            }
+            default: {
+                return '?';
+            }
+        }
+    }
 }
 exports.default = Status;

package/dist/commands/upload.d.ts

@@ -4,14 +4,14 @@ export default class Upload extends Command {
         appFile: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
-        apiKey: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        apiKey: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         apiUrl: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
-    static enableJsonFlag: boolean;
     run(): Promise<{
         appBinaryId: string;
-    } | undefined>;
+    }>;
 }

package/dist/commands/upload.js

@@ -7,11 +7,12 @@ class Upload extends core_1.Command {
     static args = {
         appFile: core_1.Args.string({
             description: 'The binary file to upload (e.g. test.apk for android or test.app/.zip for ios)',
-            required: true,
             name: 'App file',
+            required: true,
         }),
     };
     static description = 'Upload an app binary to devicecloud.dev';
+    static enableJsonFlag = true;
     static examples = [
         '<%= config.bin %> <%= command.id %> path/to/app.apk',
         '<%= config.bin %> <%= command.id %> path/to/app.zip --api-key YOUR_API_KEY',
@@ -21,7 +22,6 @@ class Upload extends core_1.Command {
         apiUrl: constants_1.flags.apiUrl,
         'ignore-sha-check': constants_1.flags['ignore-sha-check'],
     };
-    static enableJsonFlag = true;
     async run() {
         try {
             const { args, flags } = await this.parse(Upload);

package/dist/constants.d.ts

@@ -1,41 +1,47 @@
+export declare const SUPPORTED_MAESTRO_VERSIONS: string[];
+export declare const DEFAULT_MAESTRO_VERSION = "1.41.0";
+export declare const getLatestMaestroVersion: () => string;
+export declare const resolveMaestroVersion: (version?: string) => string;
 export declare const flags: {
     'additional-app-binary-ids': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
     'additional-app-files': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
-    'android-api-level': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'android-device': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'skip-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    apiKey: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'android-api-level': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'android-device': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    apiKey: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     apiUrl: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'app-binary-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'app-file': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    '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>;
+    'artifacts-path': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     async: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    config: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'device-locale': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'download-artifacts': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'artifacts-path': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    config: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    env: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'device-locale': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'download-artifacts': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    env: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
     'exclude-flows': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
     'exclude-tags': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
-    flows: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    flows: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'google-play': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    'include-tags': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
     'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    'ios-device': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'ios-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'x86-arch': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    'include-tags': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
+    'ios-device': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'ios-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    'json-file': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    'json-file-name': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'maestro-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-    mitmHost: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    mitmPath: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    name: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    orientation: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    metadata: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
+    mitmHost: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    mitmPath: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'moropo-v1-api-key': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    name: 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>;
     quiet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    retry: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    report: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    retry: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
     'runner-type': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-    report: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    'json-file': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    'moropo-v1-api-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    'skip-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    'x86-arch': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
 };

package/dist/constants.js

@@ -1,8 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.flags = void 0;
+exports.flags = exports.resolveMaestroVersion = exports.getLatestMaestroVersion = exports.DEFAULT_MAESTRO_VERSION = exports.SUPPORTED_MAESTRO_VERSIONS = void 0;
 const core_1 = require("@oclif/core");
 const device_types_1 = require("./types/device.types");
+// Centralized maestro version definitions - single source of truth
+exports.SUPPORTED_MAESTRO_VERSIONS = [
+    '1.39.0',
+    '1.39.1',
+    '1.39.2',
+    '1.39.4',
+    '1.39.5',
+    '1.39.7',
+    '1.39.13',
+    '1.40.0',
+    '1.40.1',
+    '1.40.2',
+    '1.40.3',
+    '1.41.0',
+];
+exports.DEFAULT_MAESTRO_VERSION = '1.41.0';
+const getLatestMaestroVersion = () => exports.SUPPORTED_MAESTRO_VERSIONS.at(-1);
+exports.getLatestMaestroVersion = getLatestMaestroVersion;
+const resolveMaestroVersion = (version) => {
+    if (version === 'latest') {
+        return (0, exports.getLatestMaestroVersion)();
+    }
+    return version || exports.DEFAULT_MAESTRO_VERSION;
+};
+exports.resolveMaestroVersion = resolveMaestroVersion;
 exports.flags = {
     'additional-app-binary-ids': core_1.Flags.string({
         default: [],
@@ -26,14 +51,6 @@ exports.flags = {
         description: '[Android only] Android device to run your flow against',
         options: Object.values(device_types_1.EAndroidDevices),
     }),
-    'skip-chrome-onboarding': core_1.Flags.boolean({
-        description: '[Android only] Skip Chrome browser onboarding screens when running tests',
-        default: false,
-    }),
-    'show-crosshairs': core_1.Flags.boolean({
-        description: '[Android only] Display crosshairs for screen interactions during test execution',
-        default: false,
-    }),
     apiKey: core_1.Flags.string({
         aliases: ['api-key'],
         description: 'API key for devicecloud.dev (find this in the console UI). You can also set the DEVICE_CLOUD_API_KEY environment variable.',
@@ -52,12 +69,20 @@ exports.flags = {
         aliases: ['app-file'],
         description: 'App binary to run your flows against',
     }),
+    'artifacts-path': core_1.Flags.string({
+        dependsOn: ['download-artifacts'],
+        description: 'Custom file path for downloaded artifacts (default: ./artifacts.zip)',
+    }),
     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)',
     }),
     config: core_1.Flags.file({
         description: 'Path to custom config.yaml file. If not provided, defaults to config.yaml in root flows folders.',
     }),
+    debug: core_1.Flags.boolean({
+        default: false,
+        description: 'Enable detailed debug logging for troubleshooting issues',
+    }),
     'device-locale': core_1.Flags.string({
         description: 'Locale that will be set to a device, ISO-639-1 code and uppercase ISO-3166-1 code e.g. "de_DE" for Germany',
     }),
@@ -65,13 +90,9 @@ exports.flags = {
         description: 'Download a zip containing the logs, screenshots and videos for each result in this run. You will debited a $0.01 egress fee for each result. Use --download-artifacts=FAILED for failures only or --download-artifacts=ALL for every result.',
         options: ['ALL', 'FAILED'],
     }),
-    'artifacts-path': core_1.Flags.string({
-        description: 'Custom file path for downloaded artifacts (default: ./artifacts.zip)',
-        dependsOn: ['download-artifacts'],
-    }),
-    debug: core_1.Flags.boolean({
-        description: 'Enable detailed debug logging for troubleshooting issues',
+    'dry-run': core_1.Flags.boolean({
         default: false,
+        description: 'Simulate the run without actually triggering the upload/test, useful for debugging workflow issues.',
     }),
     env: core_1.Flags.file({
         char: 'e',
@@ -102,6 +123,9 @@ exports.flags = {
         default: false,
         description: '[Android only] Run your flow against Google Play devices',
     }),
+    'ignore-sha-check': core_1.Flags.boolean({
+        description: 'Ignore the sha hash check and upload the binary regardless of whether it already exists (not recommended)',
+    }),
     'include-tags': core_1.Flags.string({
         aliases: ['include-tags'],
         default: [],
@@ -110,9 +134,6 @@ exports.flags = {
         multipleNonGreedy: true,
         parse: (input) => input.split(','),
     }),
-    'ignore-sha-check': core_1.Flags.boolean({
-        description: 'Ignore the sha hash check and upload the binary regardless of whether it already exists (not recommended)',
-    }),
     'ios-device': core_1.Flags.string({
         description: '[iOS only] iOS device to run your flow against',
         options: Object.values(device_types_1.EiOSDevices),
@@ -121,35 +142,39 @@ exports.flags = {
         description: '[iOS only] iOS version to run your flow against',
         options: Object.values(device_types_1.EiOSVersions),
     }),
-    'x86-arch': core_1.Flags.boolean({
-        description: '[iOS only, experimental] Run your flow against x86 architecture simulator instead of arm64',
-        default: false,
+    json: core_1.Flags.boolean({
+        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',
+        required: false,
+    }),
+    'json-file-name': core_1.Flags.string({
+        description: 'A custom name for the JSON file (can also include relative path)',
+        dependsOn: ['json-file'],
     }),
     'maestro-version': core_1.Flags.string({
         aliases: ['maestroVersion'],
-        default: '1.39.5',
+        default: exports.DEFAULT_MAESTRO_VERSION,
         description: 'Maestro version to run your flow against',
-        options: [
-            '1.39.0',
-            '1.39.1',
-            '1.39.2',
-            '1.39.4',
-            '1.39.5',
-            '1.39.7',
-            '1.39.13',
-            '1.40.0',
-            '1.40.1',
-            '1.40.2',
-            '1.40.3',
-            '1.41.0',
-        ],
+        options: [...exports.SUPPORTED_MAESTRO_VERSIONS, 'latest'],
+    }),
+    metadata: core_1.Flags.string({
+        char: 'm',
+        description: 'Arbitrary key-value metadata to include with your test run (format: key=value)',
+        multiple: true,
+        multipleNonGreedy: true,
     }),
     mitmHost: core_1.Flags.string({
         description: 'used for mitmproxy support, enterprise only, contact support if interested',
     }),
     mitmPath: core_1.Flags.string({
-        description: 'used for mitmproxy support, enterprise only, contact support if interested',
         dependsOn: ['mitmHost'],
+        description: 'used for mitmproxy support, enterprise only, contact support if interested',
+    }),
+    'moropo-v1-api-key': core_1.Flags.string({
+        description: 'API key for Moropo v1 integration',
+        required: false,
     }),
     name: core_1.Flags.string({
         description: 'A custom name for your upload (useful for tagging commits etc)',
@@ -163,32 +188,29 @@ exports.flags = {
         default: false,
         description: 'Quieter console output that wont provide progress updates',
     }),
+    report: core_1.Flags.string({
+        aliases: ['format'],
+        description: 'Runs Maestro with the --format flag, this will generate a report in the specified format',
+        options: ['junit', 'html'],
+    }),
     retry: core_1.Flags.integer({
         description: 'Automatically retry the run up to the number of times specified (same as pressing retry in the UI) - this is free of charge',
     }),
     'runner-type': core_1.Flags.string({
-        description: '[experimental] The type of runner to use - note: anything other than default will incur premium pricing tiers, see https://docs.devicecloud.dev/reference/runner-type for more information',
         default: 'default',
+        description: '[experimental] The type of runner to use - note: anything other than default will incur premium pricing tiers, see https://docs.devicecloud.dev/reference/runner-type for more information',
         options: ['default', 'm4', 'm1'],
     }),
-    report: core_1.Flags.string({
-        aliases: ['format'],
-        description: 'Runs Maestro with the --format flag, this will generate a report in the specified format',
-        options: ['junit', 'html'],
-    }),
-    json: core_1.Flags.boolean({
-        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. If you supply the --name flag, file <name>_dcd.json will be written, otherwise file <upload_id>_dcd.json will be written - note: will always exit with code 0',
-        required: false,
+    'show-crosshairs': core_1.Flags.boolean({
+        default: false,
+        description: '[Android only] Display crosshairs for screen interactions during test execution',
     }),
-    'moropo-v1-api-key': core_1.Flags.string({
-        description: 'API key for Moropo v1 integration',
-        required: false,
+    'skip-chrome-onboarding': core_1.Flags.boolean({
+        default: false,
+        description: '[Android only] Skip Chrome browser onboarding screens when running tests',
     }),
-    'dry-run': core_1.Flags.boolean({
-        description: 'Simulate the run without actually triggering the upload/test, useful for debugging workflow issues.',
+    'x86-arch': core_1.Flags.boolean({
         default: false,
+        description: '[iOS only, experimental] Run your flow against x86 architecture simulator instead of arm64',
     }),
 };

package/dist/gateways/api-gateway.d.ts

@@ -0,0 +1,35 @@
+import { TAppMetadata } from '../types';
+export declare const ApiGateway: {
+    checkForExistingUpload(baseUrl: string, apiKey: string, sha: string): Promise<{
+        appBinaryId: string;
+        exists: boolean;
+    }>;
+    downloadArtifactsZip(baseUrl: string, apiKey: string, uploadId: string, results: "ALL" | "FAILED", artifactsPath?: string): Promise<void>;
+    finaliseUpload(baseUrl: string, apiKey: string, id: string, metadata: TAppMetadata, path: string, sha: string): Promise<Record<string, never>>;
+    getBinaryUploadUrl(baseUrl: string, apiKey: string, platform: "android" | "ios"): Promise<{
+        id: string;
+        message: string;
+        path: string;
+        token: string;
+    }>;
+    getResultsForUpload(baseUrl: string, apiKey: string, uploadId: string): Promise<{
+        results?: import("../types/schema.types").components["schemas"]["TResultResponse"][];
+        statusCode?: number;
+    }>;
+    getUploadStatus(baseUrl: string, apiKey: string, options: {
+        name?: string;
+        uploadId?: string;
+    }): Promise<{
+        status: "CANCELLED" | "FAILED" | "PASSED" | "PENDING";
+        tests: Array<{
+            durationSeconds?: number;
+            failReason?: string;
+            name: string;
+            status: "CANCELLED" | "FAILED" | "PASSED" | "PENDING";
+        }>;
+    }>;
+    uploadFlow(baseUrl: string, apiKey: string, testFormData: FormData): Promise<{
+        message?: string;
+        results?: import("../types/schema.types").components["schemas"]["IDBResult"][];
+    }>;
+};