@devicecloud.dev/dcd 4.3.3 → 4.4.0

package/dist/commands/artifacts.d.ts

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+export default class Artifacts extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        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>;
+        debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'upload-id': 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>;
+        'artifacts-path': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        report: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'allure-path': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'html-path': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'junit-path': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/artifacts.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const constants_1 = require("../constants");
+const report_download_service_1 = require("../services/report-download.service");
+class Artifacts extends core_1.Command {
+    static description = 'Download artifacts or reports for a completed test run';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --download-artifacts FAILED',
+        '<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --download-artifacts ALL --artifacts-path ./my-artifacts.zip',
+        '<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --report junit',
+        '<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --report allure --allure-path ./report.html',
+    ];
+    static flags = {
+        apiKey: constants_1.flags.apiKey,
+        apiUrl: constants_1.flags.apiUrl,
+        debug: core_1.Flags.boolean({
+            default: false,
+            description: 'Enable detailed debug logging for troubleshooting issues',
+        }),
+        'upload-id': core_1.Flags.string({
+            description: 'UUID of the completed upload to download artifacts for',
+            required: true,
+        }),
+        'download-artifacts': core_1.Flags.string({
+            description: 'Download a zip containing the logs, screenshots and videos for this run. Options: ALL (everything), FAILED (failures only).',
+            exclusive: ['report'],
+            options: ['ALL', 'FAILED'],
+        }),
+        'artifacts-path': core_1.Flags.string({
+            dependsOn: ['download-artifacts'],
+            description: 'Custom file path for downloaded artifacts (default: ./artifacts.zip)',
+        }),
+        report: core_1.Flags.string({
+            description: 'Download a test report in the specified format.',
+            exclusive: ['download-artifacts'],
+            options: ['allure', 'html', 'html-detailed', 'junit'],
+        }),
+        'allure-path': core_1.Flags.string({
+            dependsOn: ['report'],
+            description: 'Custom file path for downloaded Allure report (default: ./report.html)',
+        }),
+        'html-path': core_1.Flags.string({
+            dependsOn: ['report'],
+            description: 'Custom file path for downloaded HTML report (default: ./report.html)',
+        }),
+        'junit-path': core_1.Flags.string({
+            dependsOn: ['report'],
+            description: 'Custom file path for downloaded JUnit report (default: ./report.xml)',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Artifacts);
+        const { apiKey: apiKeyFlag, apiUrl, debug, 'upload-id': uploadId, 'download-artifacts': downloadArtifacts, 'artifacts-path': artifactsPath, report, 'allure-path': allurePath, 'html-path': htmlPath, 'junit-path': junitPath, } = 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.');
+            return;
+        }
+        if (!downloadArtifacts && !report) {
+            this.error('Either --download-artifacts or --report must be specified.');
+            return;
+        }
+        const service = new report_download_service_1.ReportDownloadService();
+        if (downloadArtifacts) {
+            await service.downloadArtifacts({
+                apiKey,
+                apiUrl,
+                artifactsPath: artifactsPath ?? './artifacts.zip',
+                debug,
+                downloadType: downloadArtifacts,
+                logger: this.log.bind(this),
+                uploadId,
+                warnLogger: this.warn.bind(this),
+            });
+        }
+        if (report) {
+            await service.downloadReports({
+                allurePath,
+                apiKey,
+                apiUrl,
+                debug,
+                htmlPath,
+                junitPath,
+                logger: this.log.bind(this),
+                reportType: report,
+                uploadId,
+                warnLogger: this.warn.bind(this),
+            });
+        }
+    }
+}
+exports.default = Artifacts;

package/dist/commands/cloud.d.ts

@@ -33,6 +33,11 @@ export default class Cloud extends Command {
         'json-file-name': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         quiet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         report: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        branch: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'commit-sha': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'repo-name': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'pr-number': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'pr-url': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         config: 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>;
@@ -60,6 +65,7 @@ export default class Cloud extends Command {
         'disable-animations': 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>;
+        'app-url': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         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>;

package/dist/commands/cloud.js

@@ -15,6 +15,7 @@ const results_polling_service_1 = require("../services/results-polling.service")
 const test_submission_service_1 = require("../services/test-submission.service");
 const version_service_1 = require("../services/version.service");
 const compatibility_1 = require("../utils/compatibility");
+const expo_1 = require("../utils/expo");
 const styling_1 = require("../utils/styling");
 // Suppress punycode deprecation warning (caused by whatwg, supabase dependancy)
 process.removeAllListeners('warning');
@@ -93,9 +94,11 @@ class Cloud extends core_1.Command {
         // Store debug flag outside try/catch to access it in catch block
         let debugFlag = false;
         let jsonFile = false;
+        // Temp files created during Expo URL download / .tar.gz extraction — cleaned up in finally
+        const tempFiles = [];
         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, 'android-no-snapshot': androidNoSnapshot, } = flags;
+            let { 'android-api-level': androidApiLevel, 'android-device': androidDevice, apiKey: apiKeyFlag, apiUrl, 'app-binary-id': appBinaryId, 'app-file': appFile, 'app-url': appUrl, '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, branch: ghBranch, 'commit-sha': ghCommitSha, 'repo-name': ghRepoName, 'pr-number': ghPrNumber, 'pr-url': ghPrUrl, } = flags;
             // Store debug flag for use in catch block
             debugFlag = debug === true;
             jsonFile = flags['json-file'] === true;
@@ -164,11 +167,11 @@ class Cloud extends core_1.Command {
                 debug,
                 logger: this.log.bind(this),
             });
-            const DEPRECATED_MAESTRO_VERSIONS = ['1.39.2', '1.39.7'];
+            const DEPRECATED_MAESTRO_VERSIONS = ['1.39.2', '1.39.7', '2.0.3'];
             if (DEPRECATED_MAESTRO_VERSIONS.includes(resolvedMaestroVersion)) {
                 this.log(`\n${styling_1.dividers.light}\n` +
                     `${styling_1.colors.warning('⚠')}  ${styling_1.colors.bold('Deprecation Warning')}\n` +
-                    styling_1.colors.dim(`Maestro version ${resolvedMaestroVersion} is deprecated and will be removed soon. `) +
+                    styling_1.colors.dim(`Maestro version ${resolvedMaestroVersion} is deprecated and will be removed on 27/03/2026. `) +
                     styling_1.colors.dim(`Please upgrade to a newer version. See: `) +
                     styling_1.colors.info('https://docs.devicecloud.dev/configuration/maestro-versions') + `\n` +
                     `${styling_1.dividers.light}\n`);
@@ -189,8 +192,26 @@ class Cloud extends core_1.Command {
             }
             const { firstFile, secondFile } = args;
             let finalBinaryId = appBinaryId;
-            const finalAppFile = appFile ?? firstFile;
+            let finalAppFile = appFile ?? (appUrl ?? firstFile);
             let flowFile = flows ?? secondFile;
+            // Resolve --app-url or a local .tar.gz to a .app path before validation
+            if (finalAppFile && !appBinaryId) {
+                if ((0, expo_1.isUrl)(finalAppFile)) {
+                    this.log(`   ${styling_1.colors.dim('→ Downloading Expo build from URL...')}`);
+                    const tarPath = await (0, expo_1.downloadExpoUrl)(finalAppFile, debug ?? false);
+                    tempFiles.push(tarPath);
+                    finalAppFile = tarPath;
+                }
+                if (finalAppFile.endsWith('.tar.gz')) {
+                    this.log(`   ${styling_1.colors.dim('→ Extracting Expo archive...')}`);
+                    const extractDir = await (0, expo_1.extractTarGz)(finalAppFile, debug ?? false);
+                    tempFiles.push(extractDir);
+                    finalAppFile = await (0, expo_1.findAppBundle)(extractDir);
+                    if (debug) {
+                        this.log(`[DEBUG] Found .app bundle at: ${finalAppFile}`);
+                    }
+                }
+            }
             if (debug) {
                 this.log(`[DEBUG] First file argument: ${firstFile || 'not provided'}`);
                 this.log(`[DEBUG] Second file argument: ${secondFile || 'not provided'}`);
@@ -296,8 +317,8 @@ class Cloud extends core_1.Command {
                 if (!(flowFile && finalAppFile)) {
                     throw new Error('You must provide a flow file and an app binary id');
                 }
-                if (!['apk', '.app', '.zip'].some((ext) => finalAppFile.endsWith(ext))) {
-                    throw new Error('App file must be a .apk for android or .app/.zip file for iOS');
+                if (!['apk', '.app', '.zip', '.tar.gz'].some((ext) => finalAppFile.endsWith(ext))) {
+                    throw new Error('App file must be a .apk for Android, .app/.zip for iOS, or .tar.gz (Expo iOS build)');
                 }
                 if (finalAppFile.endsWith('.zip')) {
                     if (debug) {
@@ -384,6 +405,19 @@ class Cloud extends core_1.Command {
             if (!finalBinaryId) {
                 throw new Error('Internal error: finalBinaryId should be defined after validation');
             }
+            const ghMetadataOverrides = [];
+            if (ghBranch)
+                ghMetadataOverrides.push(`gh_branch=${ghBranch}`);
+            if (ghCommitSha)
+                ghMetadataOverrides.push(`gh_sha=${ghCommitSha}`);
+            if (ghRepoName)
+                ghMetadataOverrides.push(`gh_repo=${ghRepoName}`);
+            if (ghPrNumber)
+                ghMetadataOverrides.push(`gh_pr_number=${ghPrNumber}`);
+            if (ghPrUrl)
+                ghMetadataOverrides.push(`gh_pr_url=${ghPrUrl}`);
+            // Explicit --metadata values take precedence (last-write-wins in parseKeyValuePairs)
+            const mergedMetadata = [...ghMetadataOverrides, ...(metadata ?? [])];
             const testFormData = await this.testSubmissionService.buildTestFormData({
                 androidApiLevel,
                 androidDevice,
@@ -402,7 +436,7 @@ class Cloud extends core_1.Command {
                 iOSVersion,
                 logger: this.log.bind(this),
                 maestroVersion: resolvedMaestroVersion,
-                metadata,
+                metadata: mergedMetadata,
                 mitmHost,
                 mitmPath,
                 name,
@@ -572,6 +606,10 @@ class Cloud extends core_1.Command {
             }
         }
         finally {
+            // Clean up any temp files created during Expo URL download / .tar.gz extraction
+            for (const p of tempFiles) {
+                await Promise.resolve().then(() => require('node:fs/promises')).then((fsp) => fsp.rm(p, { recursive: true, force: true }).catch(() => { }));
+            }
             if (output) {
                 // eslint-disable-next-line no-unsafe-finally
                 return output;

package/dist/commands/upload.d.ts

@@ -9,6 +9,7 @@ export default class Upload extends Command {
     static flags: {
         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-url': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };

package/dist/commands/upload.js

@@ -1,15 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
+const promises_1 = require("node:fs/promises");
 const constants_1 = require("../constants");
 const methods_1 = require("../methods");
+const expo_1 = require("../utils/expo");
 const styling_1 = require("../utils/styling");
 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)',
+            description: 'The binary file or Expo signed URL to upload (e.g. test.apk, test.app, test.zip, build.tar.gz, or https://expo.dev/...)',
             name: 'App file',
-            required: true,
+            required: false,
         }),
     };
     static description = 'Upload an app binary to devicecloud.dev';
@@ -17,36 +19,61 @@ class Upload extends core_1.Command {
     static examples = [
         '<%= config.bin %> <%= command.id %> path/to/app.apk',
         '<%= config.bin %> <%= command.id %> path/to/app.zip --api-key YOUR_API_KEY',
+        '<%= config.bin %> <%= command.id %> path/to/build.tar.gz',
+        '<%= config.bin %> <%= command.id %> --app-url https://expo.dev/artifacts/...',
     ];
     static flags = {
         apiKey: constants_1.flags.apiKey,
         apiUrl: constants_1.flags.apiUrl,
+        'app-url': constants_1.flags['app-url'],
         debug: constants_1.flags.debug,
         'ignore-sha-check': constants_1.flags['ignore-sha-check'],
     };
     async run() {
+        const tempFiles = [];
         try {
             const { args, flags } = await this.parse(Upload);
-            const { appFile } = args;
-            const { apiKey: apiKeyFlag, apiUrl, debug, 'ignore-sha-check': ignoreShaCheck, json, } = flags;
+            const { apiKey: apiKeyFlag, apiUrl, 'app-url': appUrl, debug, 'ignore-sha-check': ignoreShaCheck, json, } = flags;
             const apiKey = apiKeyFlag || process.env.DEVICE_CLOUD_API_KEY;
             if (!apiKey) {
                 throw new Error('You must provide an API key via --api-key flag or DEVICE_CLOUD_API_KEY environment variable');
             }
-            if (!['apk', '.app', '.zip'].some((ext) => appFile.endsWith(ext))) {
-                throw new Error('App file must be a .apk for android or .app/.zip file for iOS');
+            // Resolve source: --app-url flag takes precedence, then positional arg
+            let resolvedFile = appUrl ?? args.appFile;
+            if (!resolvedFile) {
+                throw new Error('You must provide an app file path or a signed Expo URL via --app-url');
             }
-            if (appFile.endsWith('.zip')) {
-                await (0, methods_1.verifyAppZip)(appFile);
+            // Download from URL if needed
+            if ((0, expo_1.isUrl)(resolvedFile)) {
+                this.log(`   ${styling_1.colors.dim('→ Downloading Expo build from URL...')}`);
+                const tarPath = await (0, expo_1.downloadExpoUrl)(resolvedFile, debug ?? false);
+                tempFiles.push(tarPath);
+                resolvedFile = tarPath;
+            }
+            // Extract .tar.gz if needed
+            if (resolvedFile.endsWith('.tar.gz')) {
+                this.log(`   ${styling_1.colors.dim('→ Extracting Expo archive...')}`);
+                const extractDir = await (0, expo_1.extractTarGz)(resolvedFile, debug ?? false);
+                tempFiles.push(extractDir);
+                resolvedFile = await (0, expo_1.findAppBundle)(extractDir);
+                if (debug) {
+                    this.log(`[DEBUG] Found .app bundle at: ${resolvedFile}`);
+                }
+            }
+            if (!['apk', '.app', '.zip', '.tar.gz'].some((ext) => resolvedFile.endsWith(ext))) {
+                throw new Error('App file must be a .apk for Android, .app/.zip for iOS, or .tar.gz (Expo iOS build)');
+            }
+            if (resolvedFile.endsWith('.zip')) {
+                await (0, methods_1.verifyAppZip)(resolvedFile);
             }
             this.log((0, styling_1.sectionHeader)('Uploading app binary'));
-            this.log(`   ${styling_1.colors.dim('→ File:')} ${styling_1.colors.highlight(appFile)}`);
+            this.log(`   ${styling_1.colors.dim('→ File:')} ${styling_1.colors.highlight(resolvedFile)}`);
             this.log('');
             const appBinaryId = await (0, methods_1.uploadBinary)({
                 apiKey,
                 apiUrl,
                 debug,
-                filePath: appFile,
+                filePath: resolvedFile,
                 ignoreShaCheck,
                 log: !json,
             });
@@ -61,6 +88,11 @@ class Upload extends core_1.Command {
         catch (error) {
             this.error(error, { exit: 1 });
         }
+        finally {
+            for (const p of tempFiles) {
+                await (0, promises_1.rm)(p, { recursive: true, force: true }).catch(() => { });
+            }
+        }
     }
 }
 exports.default = Upload;

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

@@ -4,5 +4,6 @@
 export declare const binaryFlags: {
     '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>;
+    'app-url': 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/config/flags/binary.flags.js

@@ -13,6 +13,12 @@ exports.binaryFlags = {
     'app-file': core_1.Flags.file({
         aliases: ['app-file'],
         description: 'App binary to run your flows against',
+        exclusive: ['app-url'],
+    }),
+    'app-url': core_1.Flags.string({
+        aliases: ['app-url'],
+        description: 'Signed URL to an Expo iOS build (.tar.gz). The archive is downloaded and extracted automatically. Expo signed URLs expire after ~1 hour.',
+        exclusive: ['app-file'],
     }),
     '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)',

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

@@ -0,0 +1,7 @@
+export declare const githubFlags: {
+    branch: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'commit-sha': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'repo-name': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'pr-number': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'pr-url': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+};

package/dist/config/flags/github.flags.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.githubFlags = void 0;
+const core_1 = require("@oclif/core");
+exports.githubFlags = {
+    branch: core_1.Flags.string({
+        description: 'Git branch name for this run (stored as gh_branch metadata)',
+    }),
+    'commit-sha': core_1.Flags.string({
+        description: 'Git commit SHA for this run (stored as gh_sha metadata)',
+    }),
+    'repo-name': core_1.Flags.string({
+        description: 'Repository in owner/repo format (stored as gh_repo metadata, e.g. "acme/my-app")',
+    }),
+    'pr-number': core_1.Flags.string({
+        description: 'Pull request number for this run (stored as gh_pr_number metadata)',
+    }),
+    'pr-url': core_1.Flags.string({
+        description: 'Pull request URL for this run (stored as gh_pr_url metadata)',
+    }),
+};

package/dist/constants.d.ts

@@ -20,6 +20,11 @@ export declare const flags: {
     'json-file-name': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     quiet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     report: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    branch: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'commit-sha': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'repo-name': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'pr-number': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    'pr-url': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     config: 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>;
@@ -47,6 +52,7 @@ export declare const flags: {
     'disable-animations': 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>;
+    'app-url': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     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>;

package/dist/constants.js

@@ -10,6 +10,7 @@ const binary_flags_1 = require("./config/flags/binary.flags");
 const device_flags_1 = require("./config/flags/device.flags");
 const environment_flags_1 = require("./config/flags/environment.flags");
 const execution_flags_1 = require("./config/flags/execution.flags");
+const github_flags_1 = require("./config/flags/github.flags");
 const output_flags_1 = require("./config/flags/output.flags");
 /**
  * All flag definitions consolidated from domain-specific flag modules.
@@ -21,5 +22,6 @@ exports.flags = {
     ...device_flags_1.deviceFlags,
     ...environment_flags_1.environmentFlags,
     ...execution_flags_1.executionFlags,
+    ...github_flags_1.githubFlags,
     ...output_flags_1.outputFlags,
 };

package/dist/services/metadata-extractor.service.d.ts

@@ -32,6 +32,15 @@ export declare class IosZipMetadataExtractor implements IMetadataExtractor {
     extract(filePath: string): Promise<TAppMetadata>;
     private parseInfoPlist;
 }
+/**
+ * Extracts metadata from Expo iOS .tar.gz archives by extracting the
+ * archive to a temp directory, finding the .app bundle inside, then
+ * delegating to IosAppMetadataExtractor.
+ */
+export declare class ExpoTarGzMetadataExtractor implements IMetadataExtractor {
+    canHandle(filePath: string): boolean;
+    extract(filePath: string): Promise<TAppMetadata>;
+}
 /**
  * Service for extracting app metadata from various file formats
  */

package/dist/services/metadata-extractor.service.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MetadataExtractorService = exports.IosZipMetadataExtractor = exports.IosAppMetadataExtractor = exports.AndroidMetadataExtractor = void 0;
+exports.MetadataExtractorService = exports.ExpoTarGzMetadataExtractor = exports.IosZipMetadataExtractor = exports.IosAppMetadataExtractor = exports.AndroidMetadataExtractor = void 0;
 const AppInfoParser = require("app-info-parser");
 const bplist_parser_1 = require("bplist-parser");
 const promises_1 = require("node:fs/promises");
@@ -107,12 +107,36 @@ class IosZipMetadataExtractor {
     }
 }
 exports.IosZipMetadataExtractor = IosZipMetadataExtractor;
+/**
+ * Extracts metadata from Expo iOS .tar.gz archives by extracting the
+ * archive to a temp directory, finding the .app bundle inside, then
+ * delegating to IosAppMetadataExtractor.
+ */
+class ExpoTarGzMetadataExtractor {
+    canHandle(filePath) {
+        return filePath.endsWith('.tar.gz');
+    }
+    async extract(filePath) {
+        const { extractTarGz, findAppBundle } = await Promise.resolve().then(() => require('../utils/expo'));
+        const extractDir = await extractTarGz(filePath, false);
+        try {
+            const appPath = await findAppBundle(extractDir);
+            const iosExtractor = new IosAppMetadataExtractor();
+            return await iosExtractor.extract(appPath);
+        }
+        finally {
+            await (0, promises_1.rm)(extractDir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+}
+exports.ExpoTarGzMetadataExtractor = ExpoTarGzMetadataExtractor;
 /**
  * Service for extracting app metadata from various file formats
  */
 class MetadataExtractorService {
     extractors = [
         new AndroidMetadataExtractor(),
+        new ExpoTarGzMetadataExtractor(),
         new IosZipMetadataExtractor(),
         new IosAppMetadataExtractor(),
     ];

package/dist/utils/expo.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Returns true if the input looks like an HTTP/HTTPS URL.
+ * @param input - String to test
+ * @returns True if the string begins with http:// or https://
+ */
+export declare function isUrl(input: string): boolean;
+/**
+ * Downloads a file from a URL to a temp file and returns the temp path.
+ * Retries up to 3 times on network error. Expo signed URLs expire after ~1 hour,
+ * so a clear error is shown on 401/403 responses.
+ * Caller is responsible for deleting the returned file.
+ * @param url - HTTPS URL to download from
+ * @param debug - Whether to emit debug log lines
+ * @returns Absolute path to the downloaded temp file
+ */
+export declare function downloadExpoUrl(url: string, debug: boolean): Promise<string>;
+/**
+ * Extracts a .tar.gz archive to a new temp directory and returns the directory path.
+ * Caller is responsible for deleting the returned directory.
+ * @param tarPath - Absolute path to the .tar.gz file
+ * @param debug - Whether to emit debug log lines
+ * @returns Absolute path to the newly created extract directory
+ */
+export declare function extractTarGz(tarPath: string, debug: boolean): Promise<string>;
+/**
+ * Recursively searches a directory for the shallowest .app bundle and returns its absolute path.
+ * Handles both root-level bundles (MyApp.app/) and nested layouts (Payload/MyApp.app/).
+ * @param dir - Directory to search within
+ * @returns Absolute path to the .app directory
+ */
+export declare function findAppBundle(dir: string): Promise<string>;

package/dist/utils/expo.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUrl = isUrl;
+exports.downloadExpoUrl = downloadExpoUrl;
+exports.extractTarGz = extractTarGz;
+exports.findAppBundle = findAppBundle;
+const node_crypto_1 = require("node:crypto");
+const fs = require("node:fs");
+const fsp = require("node:fs/promises");
+const os = require("node:os");
+const path = require("node:path");
+const node_stream_1 = require("node:stream");
+const promises_1 = require("node:stream/promises");
+const tar = require("tar");
+const DOWNLOAD_RETRY_ATTEMPTS = 3;
+const DOWNLOAD_RETRY_DELAY_MS = 2000;
+/**
+ * Returns true if the input looks like an HTTP/HTTPS URL.
+ * @param input - String to test
+ * @returns True if the string begins with http:// or https://
+ */
+function isUrl(input) {
+    return input.startsWith('http://') || input.startsWith('https://');
+}
+/**
+ * Downloads a file from a URL to a temp file and returns the temp path.
+ * Retries up to 3 times on network error. Expo signed URLs expire after ~1 hour,
+ * so a clear error is shown on 401/403 responses.
+ * Caller is responsible for deleting the returned file.
+ * @param url - HTTPS URL to download from
+ * @param debug - Whether to emit debug log lines
+ * @returns Absolute path to the downloaded temp file
+ */
+async function downloadExpoUrl(url, debug) {
+    const destPath = path.join(os.tmpdir(), `dcd-expo-${(0, node_crypto_1.randomUUID)()}.tar.gz`);
+    for (let attempt = 1; attempt <= DOWNLOAD_RETRY_ATTEMPTS; attempt++) {
+        if (debug) {
+            console.log(`[DEBUG] Downloading Expo URL (attempt ${attempt}/${DOWNLOAD_RETRY_ATTEMPTS}): ${url}`);
+        }
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                if (response.status === 403 || response.status === 401) {
+                    throw new Error(`Failed to download Expo build from URL (HTTP ${response.status}). Expo signed URLs expire after ~1 hour — please generate a fresh URL with 'eas build' and try again.`);
+                }
+                throw new Error(`Failed to download Expo build from URL (HTTP ${response.status}).`);
+            }
+            if (!response.body) {
+                throw new Error('No response body received from Expo URL.');
+            }
+            // Stream to disk using pipeline to handle backpressure and avoid loading
+            // the entire archive in memory
+            await (0, promises_1.pipeline)(node_stream_1.Readable.fromWeb(response.body), fs.createWriteStream(destPath));
+            if (debug) {
+                const stat = await fsp.stat(destPath);
+                console.log(`[DEBUG] Downloaded ${(stat.size / 1024 / 1024).toFixed(2)} MB to ${destPath}`);
+            }
+            return destPath;
+        }
+        catch (error) {
+            // Clean up any partial file before retrying
+            await fsp.rm(destPath, { force: true }).catch(() => { });
+            const isLastAttempt = attempt === DOWNLOAD_RETRY_ATTEMPTS;
+            if (isLastAttempt) {
+                throw error;
+            }
+            if (debug) {
+                console.log(`[DEBUG] Download failed (attempt ${attempt}), retrying in ${DOWNLOAD_RETRY_DELAY_MS}ms...`);
+            }
+            await new Promise((resolve) => { setTimeout(resolve, DOWNLOAD_RETRY_DELAY_MS); });
+        }
+    }
+    // Unreachable — loop always throws or returns before exhausting attempts
+    throw new Error('Download failed after all retry attempts.');
+}
+/**
+ * Extracts a .tar.gz archive to a new temp directory and returns the directory path.
+ * Caller is responsible for deleting the returned directory.
+ * @param tarPath - Absolute path to the .tar.gz file
+ * @param debug - Whether to emit debug log lines
+ * @returns Absolute path to the newly created extract directory
+ */
+async function extractTarGz(tarPath, debug) {
+    const extractDir = path.join(os.tmpdir(), `dcd-expo-${(0, node_crypto_1.randomUUID)()}`);
+    await fsp.mkdir(extractDir, { recursive: true });
+    if (debug) {
+        console.log(`[DEBUG] Extracting ${tarPath} to ${extractDir}`);
+    }
+    await tar.extract({ cwd: extractDir, file: tarPath });
+    if (debug) {
+        console.log(`[DEBUG] Extraction complete: ${extractDir}`);
+    }
+    return extractDir;
+}
+/**
+ * Recursively searches a directory for the shallowest .app bundle and returns its absolute path.
+ * Handles both root-level bundles (MyApp.app/) and nested layouts (Payload/MyApp.app/).
+ * @param dir - Directory to search within
+ * @returns Absolute path to the .app directory
+ */
+async function findAppBundle(dir) {
+    const candidates = [];
+    async function walk(current, depth) {
+        const entries = await fsp.readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name.endsWith('.app')) {
+                    candidates.push({ depth, fullPath });
+                    // Do not recurse into the .app bundle itself
+                }
+                else if (entry.name !== '__MACOSX') {
+                    // Skip __MACOSX metadata directories created by macOS zip utilities
+                    await walk(fullPath, depth + 1);
+                }
+            }
+        }
+    }
+    await walk(dir, 0);
+    if (candidates.length === 0) {
+        throw new Error('No .app bundle found inside the archive. Ensure you are using an iOS Expo build (eas build --platform ios).');
+    }
+    // Return the shallowest (lowest depth) candidate
+    candidates.sort((a, b) => a.depth - b.depth);
+    return candidates[0].fullPath;
+}

package/oclif.manifest.json

@@ -1,5 +1,139 @@
 {
   "commands": {
+    "artifacts": {
+      "aliases": [],
+      "args": {},
+      "description": "Download artifacts or reports for a completed test run",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --download-artifacts FAILED",
+        "<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --download-artifacts ALL --artifacts-path ./my-artifacts.zip",
+        "<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --report junit",
+        "<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --report allure --allure-path ./report.html"
+      ],
+      "flags": {
+        "apiKey": {
+          "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.",
+          "name": "apiKey",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "apiUrl": {
+          "aliases": [
+            "api-url",
+            "apiURL"
+          ],
+          "description": "API base URL",
+          "hidden": true,
+          "name": "apiUrl",
+          "default": "https://api.devicecloud.dev",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "description": "Enable detailed debug logging for troubleshooting issues",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "upload-id": {
+          "description": "UUID of the completed upload to download artifacts for",
+          "name": "upload-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "download-artifacts": {
+          "description": "Download a zip containing the logs, screenshots and videos for this run. Options: ALL (everything), FAILED (failures only).",
+          "exclusive": [
+            "report"
+          ],
+          "name": "download-artifacts",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ALL",
+            "FAILED"
+          ],
+          "type": "option"
+        },
+        "artifacts-path": {
+          "dependsOn": [
+            "download-artifacts"
+          ],
+          "description": "Custom file path for downloaded artifacts (default: ./artifacts.zip)",
+          "name": "artifacts-path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "report": {
+          "description": "Download a test report in the specified format.",
+          "exclusive": [
+            "download-artifacts"
+          ],
+          "name": "report",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "allure",
+            "html",
+            "html-detailed",
+            "junit"
+          ],
+          "type": "option"
+        },
+        "allure-path": {
+          "dependsOn": [
+            "report"
+          ],
+          "description": "Custom file path for downloaded Allure report (default: ./report.html)",
+          "name": "allure-path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "html-path": {
+          "dependsOn": [
+            "report"
+          ],
+          "description": "Custom file path for downloaded HTML report (default: ./report.html)",
+          "name": "html-path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "junit-path": {
+          "dependsOn": [
+            "report"
+          ],
+          "description": "Custom file path for downloaded JUnit report (default: ./report.xml)",
+          "name": "junit-path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "artifacts",
+      "pluginAlias": "@devicecloud.dev/dcd",
+      "pluginName": "@devicecloud.dev/dcd",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "artifacts.js"
+      ]
+    },
     "cloud": {
       "aliases": [],
       "args": {
@@ -63,11 +197,27 @@
             "app-file"
           ],
           "description": "App binary to run your flows against",
+          "exclusive": [
+            "app-url"
+          ],
           "name": "app-file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "app-url": {
+          "aliases": [
+            "app-url"
+          ],
+          "description": "Signed URL to an Expo iOS build (.tar.gz). The archive is downloaded and extracted automatically. Expo signed URLs expire after ~1 hour.",
+          "exclusive": [
+            "app-file"
+          ],
+          "name": "app-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "ignore-sha-check": {
           "description": "Ignore the sha hash check and upload the binary regardless of whether it already exists (not recommended)",
           "name": "ignore-sha-check",
@@ -313,6 +463,41 @@
           ],
           "type": "option"
         },
+        "branch": {
+          "description": "Git branch name for this run (stored as gh_branch metadata)",
+          "name": "branch",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "commit-sha": {
+          "description": "Git commit SHA for this run (stored as gh_sha metadata)",
+          "name": "commit-sha",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "repo-name": {
+          "description": "Repository in owner/repo format (stored as gh_repo metadata, e.g. \"acme/my-app\")",
+          "name": "repo-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pr-number": {
+          "description": "Pull request number for this run (stored as gh_pr_number metadata)",
+          "name": "pr-number",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pr-url": {
+          "description": "Pull request URL for this run (stored as gh_pr_url metadata)",
+          "name": "pr-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "artifacts-path": {
           "dependsOn": [
             "download-artifacts"
@@ -610,15 +795,17 @@
       "aliases": [],
       "args": {
         "appFile": {
-          "description": "The binary file to upload (e.g. test.apk for android or test.app/.zip for ios)",
+          "description": "The binary file or Expo signed URL to upload (e.g. test.apk, test.app, test.zip, build.tar.gz, or https://expo.dev/...)",
           "name": "appFile",
-          "required": true
+          "required": false
         }
       },
       "description": "Upload an app binary to devicecloud.dev",
       "examples": [
         "<%= config.bin %> <%= command.id %> path/to/app.apk",
-        "<%= config.bin %> <%= command.id %> path/to/app.zip --api-key YOUR_API_KEY"
+        "<%= config.bin %> <%= command.id %> path/to/app.zip --api-key YOUR_API_KEY",
+        "<%= config.bin %> <%= command.id %> path/to/build.tar.gz",
+        "<%= config.bin %> <%= command.id %> --app-url https://expo.dev/artifacts/..."
       ],
       "flags": {
         "json": {
@@ -651,6 +838,19 @@
           "multiple": false,
           "type": "option"
         },
+        "app-url": {
+          "aliases": [
+            "app-url"
+          ],
+          "description": "Signed URL to an Expo iOS build (.tar.gz). The archive is downloaded and extracted automatically. Expo signed URLs expire after ~1 hour.",
+          "exclusive": [
+            "app-file"
+          ],
+          "name": "app-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "debug": {
           "description": "Enable detailed debug logging for troubleshooting issues",
           "name": "debug",
@@ -680,5 +880,5 @@
       ]
     }
   },
-  "version": "4.3.3"
+  "version": "4.4.0"
 }

package/package.json

@@ -5,36 +5,38 @@
   },
   "dependencies": {
     "@oclif/core": "^3.27.0",
-    "@oclif/plugin-help": "^6.2.36",
-    "@supabase/supabase-js": "^2.81.1",
+    "@oclif/plugin-help": "^6.2.37",
+    "@supabase/supabase-js": "^2.99.1",
     "app-info-parser": "^1.1.6",
     "archiver": "^7.0.1",
     "bplist-parser": "^0.3.2",
     "chalk": "4.1.2",
-    "glob": "^11.1.0",
+    "glob": "^13.0.6",
     "js-yaml": "^4.1.1",
     "node-stream-zip": "^1.15.0",
     "plist": "^3.1.0",
+    "tar": "^7.5.11",
     "tus-js-client": "^4.3.1"
   },
   "description": "Better cloud maestro testing",
   "devDependencies": {
     "@oclif/prettier-config": "^0.2.1",
-    "@oclif/test": "^4.1.15",
-    "@types/archiver": "^6.0.4",
+    "@oclif/test": "^4.1.16",
+    "@types/archiver": "^7.0.0",
     "@types/chai": "^5.2.3",
     "@types/glob-to-regexp": "^0.4.4",
     "@types/js-yaml": "^4.0.9",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^24.10.1",
+    "@types/node": "^25.4.0",
     "@types/plist": "^3.0.5",
-    "chai": "^5.3.3",
+    "@types/tar": "^7.0.87",
+    "chai": "^6.2.2",
     "eslint": "^8.57.1",
     "eslint-config-oclif": "^5.2.2",
     "eslint-config-oclif-typescript": "^3.1.14",
     "eslint-config-prettier": "^10.1.8",
     "mocha": "^11.7.5",
-    "oclif": "^4.22.47",
+    "oclif": "^4.22.87",
     "shx": "^0.4.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
@@ -67,7 +69,7 @@
     "type": "git",
     "url": "https://devicecloud.dev"
   },
-  "version": "4.3.3",
+  "version": "4.4.0",
   "bugs": {
     "url": "https://discord.gg/gm3mJwcNw8"
   },