@devicecloud.dev/dcd 4.0.4 → 4.1.1

package/dist/commands/cloud.d.ts

@@ -9,8 +9,6 @@ export default class Cloud extends Command {
     static enableJsonFlag: boolean;
     static examples: string[];
     static 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, 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>;
@@ -19,6 +17,8 @@ export default class Cloud extends Command {
         '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>;
         'junit-path': 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>;
         async: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         config: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
@@ -50,8 +50,20 @@ export default class Cloud extends Command {
         'runner-type': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         '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>;
     };
     private versionCheck;
     run(): Promise<any>;
+    /**
+     * Handle downloading reports based on the report type specified
+     * @param reportType The type of report to download ('junit', 'allure', or 'html')
+     * @param apiUrl The base URL for the API server
+     * @param apiKey The API key for authentication
+     * @param uploadId The unique identifier for the test upload
+     * @param junitPath Optional file path where the JUnit report should be saved
+     * @param allurePath Optional file path where the Allure report should be saved
+     * @param htmlPath Optional file path where the HTML report should be saved
+     * @param debug Whether debug logging is enabled
+     * @returns Promise that resolves when all reports have been downloaded
+     */
+    private handleReportDownloads;
 }

package/dist/commands/cloud.js

@@ -9,12 +9,12 @@ const node_child_process_1 = require("node:child_process");
 const fs = require("node:fs");
 const os = require("node:os");
 const path = require("node:path");
-const streamZip = require("node-stream-zip");
 const constants_1 = require("../constants");
 const api_gateway_1 = require("../gateways/api-gateway");
 const methods_1 = require("../methods");
 const plan_1 = require("../plan");
 const compatibility_1 = require("../utils/compatibility");
+const StreamZip = require("node-stream-zip");
 exports.mimeTypeLookupByExtension = {
     apk: 'application/vnd.android.package-archive',
     yaml: 'application/x-yaml',
@@ -71,7 +71,7 @@ class Cloud extends core_1.Command {
         let jsonFile = false;
         try {
             const { args, flags, raw } = await this.parse(Cloud);
-            let { 'additional-app-binary-ids': nonFlatAdditionalAppBinaryIds, 'additional-app-files': nonFlatAdditionalAppFiles, 'android-api-level': androidApiLevel, 'android-device': androidDevice, apiKey: apiKeyFlag, apiUrl, 'app-binary-id': appBinaryId, 'app-file': appFile, 'artifacts-path': artifactsPath, 'junit-path': junitPath, 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, 'x86-arch': x86Arch, ...rest } = 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, ...rest } = flags;
             // Resolve "latest" maestro version to actual version
             const resolvedMaestroVersion = (0, constants_1.resolveMaestroVersion)(maestroVersion);
             // Store debug flag for use in catch block
@@ -170,7 +170,6 @@ class Cloud extends core_1.Command {
                         core_1.ux.action.status = 'Extracting tests...';
                     }
                     // Extract zip file
-                    const StreamZip = streamZip;
                     // eslint-disable-next-line new-cap
                     const zip = new StreamZip.async({ file: zipPath });
                     await zip.extract(null, moropoDir);
@@ -222,7 +221,6 @@ class Cloud extends core_1.Command {
             }
             if (debug) {
                 this.log(`DEBUG: API URL: ${apiUrl}`);
-                this.log(`DEBUG: API Key provided: ${apiKey ? 'Yes' : 'No'}`);
             }
             if (retry && retry > 2) {
                 this.log("Retries are now free of charge but limited to 2. If you're test is still failing after 2 retries, please ask for help on Discord.");
@@ -238,11 +236,8 @@ class Cloud extends core_1.Command {
             if (runnerType === 'gpu1') {
                 this.log('Note: runnerType gpu1 is Android-only and requires contacting support to enable. Without support enablement, your runner type will revert to default.');
             }
-            const additionalAppBinaryIds = nonFlatAdditionalAppBinaryIds?.flat();
-            const additionalAppFiles = nonFlatAdditionalAppFiles?.flat();
             const { firstFile, secondFile } = args;
             let finalBinaryId = appBinaryId;
-            let finalAdditionalBinaryIds = additionalAppBinaryIds;
             const finalAppFile = appFile ?? firstFile;
             let flowFile = flows ?? secondFile;
             if (debug) {
@@ -251,8 +246,6 @@ class Cloud extends core_1.Command {
                 this.log(`DEBUG: App binary ID: ${appBinaryId || 'not provided'}`);
                 this.log(`DEBUG: App file: ${finalAppFile || 'not provided'}`);
                 this.log(`DEBUG: Flow file: ${flowFile || 'not provided'}`);
-                this.log(`DEBUG: Additional app binary IDs: ${additionalAppBinaryIds?.join(', ') || 'none'}`);
-                this.log(`DEBUG: Additional app files: ${additionalAppFiles?.join(', ') || 'none'}`);
             }
             if (appBinaryId) {
                 if (secondFile) {
@@ -370,13 +363,10 @@ class Cloud extends core_1.Command {
                     await (0, methods_1.verifyAppZip)(finalAppFile);
                 }
             }
-            if (debug && additionalAppFiles?.length) {
-                this.log(`DEBUG: Verifying additional app files: ${additionalAppFiles.join(', ')}`);
-            }
-            await (0, methods_1.verifyAdditionalAppFiles)(additionalAppFiles);
             const flagLogs = [];
+            const sensitiveFlags = new Set(['api-key', 'apiKey', 'moropo-v1-api-key']);
             for (const [k, v] of Object.entries(flags)) {
-                if (v && v.toString().length > 0) {
+                if (v && v.toString().length > 0 && !sensitiveFlags.has(k)) {
                     flagLogs.push(`${k}: ${v}`);
                 }
             }
@@ -402,9 +392,6 @@ class Cloud extends core_1.Command {
         Submitting new job
       → Flow(s): ${flowFile}
       → App: ${appBinaryId || finalAppFile}
-      ${additionalAppBinaryIds.length > 0 || additionalAppFiles.length > 0
-                ? `→ Additional app(s): ${additionalAppBinaryIds} ${additionalAppFiles}`
-                : ''}
 
         With options
       → ${flagLogs.join(`
@@ -440,21 +427,6 @@ class Cloud extends core_1.Command {
                     this.log(`DEBUG: Binary uploaded with ID: ${binaryId}`);
                 }
             }
-            let uploadedBinaryIds = [];
-            if (additionalAppFiles?.length) {
-                if (debug) {
-                    this.log(`DEBUG: Uploading additional binary files: ${additionalAppFiles.join(', ')}`);
-                }
-                uploadedBinaryIds = await (0, methods_1.uploadBinaries)(additionalAppFiles, apiUrl, apiKey, ignoreShaCheck, !json);
-                finalAdditionalBinaryIds = [
-                    ...finalAdditionalBinaryIds,
-                    ...uploadedBinaryIds,
-                ];
-                if (debug) {
-                    this.log(`DEBUG: Additional binaries uploaded with IDs: ${uploadedBinaryIds.join(', ')}`);
-                    this.log(`DEBUG: Final additional binary IDs: ${finalAdditionalBinaryIds.join(', ')}`);
-                }
-            }
             const testFormData = new FormData();
             // eslint-disable-next-line unicorn/no-array-reduce
             const envObject = (env ?? []).reduce((acc, cur) => {
@@ -526,16 +498,8 @@ class Cloud extends core_1.Command {
                 report,
                 showCrosshairs: flags['show-crosshairs'],
                 skipChromeOnboarding: flags['skip-chrome-onboarding'],
-                uploadedBinaryIds,
                 version: this.config.version,
-                x86Arch,
             };
-            if (finalAdditionalBinaryIds?.length > 0) {
-                config.additionalAppBinaryIds = finalAdditionalBinaryIds;
-            }
-            if (uploadedBinaryIds?.length > 0) {
-                config.uploadedBinaryIds = uploadedBinaryIds;
-            }
             testFormData.set('config', JSON.stringify(config));
             if (Object.keys(metadataObject).length > 0) {
                 const metadataPayload = { userMetadata: metadataObject };
@@ -691,33 +655,9 @@ class Cloud extends core_1.Command {
                                     this.warn('Failed to download artifacts');
                                 }
                             }
-                            // Handle report download separately if --report junit is specified
-                            if (report === 'junit') {
-                                try {
-                                    if (debug) {
-                                        this.log('DEBUG: Downloading JUNIT report');
-                                    }
-                                    const reportPath = path.resolve(process.cwd(), junitPath || 'report.xml');
-                                    await api_gateway_1.ApiGateway.downloadReport(apiUrl, apiKey, results[0].test_upload_id, reportPath);
-                                    this.log('\n');
-                                    this.log(`JUNIT test report has been downloaded to ${reportPath}`);
-                                }
-                                catch (error) {
-                                    if (debug) {
-                                        this.log(`DEBUG: Error downloading JUNIT report: ${error}`);
-                                    }
-                                    const errorMessage = error instanceof Error ? error.message : String(error);
-                                    this.warn(`Failed to download JUNIT report: ${errorMessage}`);
-                                    if (errorMessage.includes('404')) {
-                                        this.warn('No JUNIT reports found for this upload. Make sure your tests were run with --report junit flag.');
-                                    }
-                                    else if (errorMessage.includes('EACCES') || errorMessage.includes('EPERM')) {
-                                        this.warn('Permission denied. Check write permissions for the current directory.');
-                                    }
-                                    else if (errorMessage.includes('ENOENT')) {
-                                        this.warn('Directory does not exist. Make sure you have write access to the current directory.');
-                                    }
-                                }
+                            // Handle report downloads based on --report flag
+                            if (report && ['allure', 'html', 'junit'].includes(report)) {
+                                await this.handleReportDownloads(report, apiUrl, apiKey, results[0].test_upload_id, junitPath, allurePath, htmlPath, debug);
                             }
                             const resultsWithoutEarlierTries = updatedResults.filter((result) => {
                                 const originalTryId = result.retry_of || result.id;
@@ -818,5 +758,65 @@ class Cloud extends core_1.Command {
             }
         }
     }
+    /**
+     * Handle downloading reports based on the report type specified
+     * @param reportType The type of report to download ('junit', 'allure', or 'html')
+     * @param apiUrl The base URL for the API server
+     * @param apiKey The API key for authentication
+     * @param uploadId The unique identifier for the test upload
+     * @param junitPath Optional file path where the JUnit report should be saved
+     * @param allurePath Optional file path where the Allure report should be saved
+     * @param htmlPath Optional file path where the HTML report should be saved
+     * @param debug Whether debug logging is enabled
+     * @returns Promise that resolves when all reports have been downloaded
+     */
+    // eslint-disable-next-line max-params
+    async handleReportDownloads(reportType, apiUrl, apiKey, uploadId, junitPath, allurePath, htmlPath, debug) {
+        const downloadReport = async (type, filePath) => {
+            try {
+                if (debug) {
+                    this.log(`DEBUG: Downloading ${type.toUpperCase()} report`);
+                }
+                await api_gateway_1.ApiGateway.downloadReportGeneric(apiUrl, apiKey, uploadId, type, filePath);
+                this.log(`${type.toUpperCase()} test report has been downloaded to ${filePath}`);
+            }
+            catch (error) {
+                if (debug) {
+                    this.log(`DEBUG: Error downloading ${type.toUpperCase()} report: ${error}`);
+                }
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                this.warn(`Failed to download ${type.toUpperCase()} report: ${errorMessage}`);
+                if (errorMessage.includes('404')) {
+                    this.warn(`No ${type.toUpperCase()} reports found for this upload. Make sure your tests generated results.`);
+                }
+                else if (errorMessage.includes('EACCES') || errorMessage.includes('EPERM')) {
+                    this.warn('Permission denied. Check write permissions for the current directory.');
+                }
+                else if (errorMessage.includes('ENOENT')) {
+                    this.warn('Directory does not exist. Make sure you have write access to the current directory.');
+                }
+            }
+        };
+        switch (reportType) {
+            case 'junit': {
+                const reportPath = path.resolve(process.cwd(), junitPath || 'report.xml');
+                await downloadReport('junit', reportPath);
+                break;
+            }
+            case 'allure': {
+                const reportPath = path.resolve(process.cwd(), allurePath || 'report.html');
+                await downloadReport('allure', reportPath);
+                break;
+            }
+            case 'html': {
+                const htmlReportPath = path.resolve(process.cwd(), htmlPath || 'report.html');
+                await downloadReport('html', htmlReportPath);
+                break;
+            }
+            default: {
+                this.warn(`Unknown report type: ${reportType}`);
+            }
+        }
+    }
 }
 exports.default = Cloud;

package/dist/constants.d.ts

@@ -3,8 +3,6 @@ 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, 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>;
@@ -13,6 +11,8 @@ export declare const flags: {
     '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>;
     'junit-path': 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>;
     async: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     config: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
@@ -44,5 +44,4 @@ export declare const flags: {
     'runner-type': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     '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

@@ -27,20 +27,6 @@ const resolveMaestroVersion = (version) => {
 };
 exports.resolveMaestroVersion = resolveMaestroVersion;
 exports.flags = {
-    'additional-app-binary-ids': core_1.Flags.string({
-        default: [],
-        description: 'The ID of the additional app binary(s) previously uploaded to devicecloud.dev to install before execution',
-        multiple: true,
-        multipleNonGreedy: true,
-        parse: (input) => input.split(','),
-    }),
-    'additional-app-files': core_1.Flags.file({
-        default: [],
-        description: 'Additional app binary(s) to install before execution',
-        multiple: true,
-        multipleNonGreedy: true,
-        parse: (input) => input.split(','),
-    }),
     'android-api-level': core_1.Flags.string({
         description: '[Android only] Android API level to run your flow against',
         options: Object.values(device_types_1.EAndroidApiLevels),
@@ -75,6 +61,14 @@ exports.flags = {
         dependsOn: ['report'],
         description: 'Custom file path for downloaded JUnit report (default: ./report.xml)',
     }),
+    '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)',
+    }),
     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)',
     }),
@@ -169,10 +163,12 @@ exports.flags = {
     }),
     mitmHost: core_1.Flags.string({
         description: 'used for mitmproxy support, enterprise only, contact support if interested',
+        hidden: true,
     }),
     mitmPath: core_1.Flags.string({
         dependsOn: ['mitmHost'],
         description: 'used for mitmproxy support, enterprise only, contact support if interested',
+        hidden: true,
     }),
     'moropo-v1-api-key': core_1.Flags.string({
         description: 'API key for Moropo v1 integration',
@@ -183,7 +179,7 @@ exports.flags = {
     }),
     orientation: core_1.Flags.string({
         description: '[Android only] The orientation of the device to run your flow against in degrees',
-        options: ['0', '90', '180', '270'],
+        options: ['0', '90'],
     }),
     quiet: core_1.Flags.boolean({
         char: 'q',
@@ -192,8 +188,8 @@ exports.flags = {
     }),
     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'],
+        description: 'Generate and download test reports in the specified format. Use "allure" for a complete HTML report.',
+        options: ['allure', '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',
@@ -211,8 +207,4 @@ exports.flags = {
         default: false,
         description: '[Android only] Skip Chrome browser onboarding screens when running tests',
     }),
-    '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

@@ -1,10 +1,16 @@
 import { TAppMetadata } from '../types';
 export declare const ApiGateway: {
+    /**
+     * Standardized error handling for API responses
+     * @param res - The fetch response object
+     * @param operation - Description of the operation that failed
+     * @returns Never returns, always throws
+     */
+    handleApiError(res: Response, operation: string): Promise<never>;
     checkForExistingUpload(baseUrl: string, apiKey: string, sha: string): Promise<{
         appBinaryId: string;
         exists: boolean;
     }>;
-    downloadReport(baseUrl: string, apiKey: string, uploadId: string, reportPath?: string): Promise<void>;
     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<{
@@ -33,4 +39,14 @@ export declare const ApiGateway: {
         message?: string;
         results?: import("../types/schema.types").components["schemas"]["IDBResult"][];
     }>;
+    /**
+     * Generic report download method that handles both junit and allure reports
+     * @param baseUrl - API base URL
+     * @param apiKey - API key for authentication
+     * @param uploadId - Upload ID to download report for
+     * @param reportType - Type of report to download ('junit' or 'allure')
+     * @param reportPath - Optional custom path for the downloaded report
+     * @returns Promise that resolves when download is complete
+     */
+    downloadReportGeneric(baseUrl: string, apiKey: string, uploadId: string, reportType: "allure" | "html" | "junit", reportPath?: string): Promise<void>;
 };

package/dist/gateways/api-gateway.js

@@ -1,9 +1,50 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiGateway = void 0;
-const fs = require("node:fs/promises");
 const path = require("node:path");
 exports.ApiGateway = {
+    /**
+     * Standardized error handling for API responses
+     * @param res - The fetch response object
+     * @param operation - Description of the operation that failed
+     * @returns Never returns, always throws
+     */
+    async handleApiError(res, operation) {
+        const errorText = await res.text();
+        let userMessage;
+        // Parse common API error formats
+        try {
+            const errorData = JSON.parse(errorText);
+            userMessage = errorData.message || errorData.error || errorText;
+        }
+        catch {
+            userMessage = errorText;
+        }
+        // Add context and improve readability
+        switch (res.status) {
+            case 400: {
+                throw new Error(`Invalid request: ${userMessage}`);
+            }
+            case 401: {
+                throw new Error(`Authentication failed. Please check your API key.`);
+            }
+            case 403: {
+                throw new Error(`Access denied. ${userMessage}`);
+            }
+            case 404: {
+                throw new Error(`Resource not found. ${userMessage}`);
+            }
+            case 429: {
+                throw new Error(`Rate limit exceeded. Please try again later.`);
+            }
+            case 500: {
+                throw new Error(`Server error occurred. Please try again or contact support.`);
+            }
+            default: {
+                throw new Error(`${operation} failed: ${userMessage} (HTTP ${res.status})`);
+            }
+        }
+    },
     async checkForExistingUpload(baseUrl, apiKey, sha) {
         const res = await fetch(`${baseUrl}/uploads/checkForExistingUpload`, {
             body: JSON.stringify({ sha }),
@@ -15,25 +56,6 @@ exports.ApiGateway = {
         });
         return res.json();
     },
-    async downloadReport(baseUrl, apiKey, uploadId, reportPath) {
-        const finalReportPath = reportPath || path.resolve(process.cwd(), `report-${uploadId}.xml`);
-        const url = `${baseUrl}/results/${uploadId}/report`;
-        const res = await fetch(url, {
-            headers: {
-                'x-app-api-key': apiKey,
-            },
-            method: 'GET',
-        });
-        if (!res.ok) {
-            const errorText = await res.text();
-            if (res.status === 404) {
-                throw new Error(`Upload ID '${uploadId}' not found or no results available for this upload`);
-            }
-            throw new Error(`Failed to download report: ${res.status} ${errorText}`);
-        }
-        const buffer = await res.arrayBuffer();
-        await fs.writeFile(finalReportPath, Buffer.from(buffer));
-    },
     async downloadArtifactsZip(baseUrl, apiKey, uploadId, results, artifactsPath = './artifacts.zip') {
         const res = await fetch(`${baseUrl}/results/${uploadId}/download`, {
             body: JSON.stringify({ results }),
@@ -44,7 +66,7 @@ exports.ApiGateway = {
             method: 'POST',
         });
         if (!res.ok) {
-            throw new Error(await res.text());
+            await this.handleApiError(res, 'Failed to download artifacts');
         }
         // Handle tilde expansion for home directory
         if (artifactsPath.startsWith('~/') || artifactsPath === '~') {
@@ -87,7 +109,7 @@ exports.ApiGateway = {
             method: 'POST',
         });
         if (!res.ok) {
-            throw new Error(await res.text());
+            await this.handleApiError(res, 'Failed to finalize upload');
         }
         return res.json();
     },
@@ -101,7 +123,7 @@ exports.ApiGateway = {
             method: 'POST',
         });
         if (!res.ok) {
-            throw new Error(await res.text());
+            await this.handleApiError(res, 'Failed to get upload URL');
         }
         return res.json();
     },
@@ -111,7 +133,7 @@ exports.ApiGateway = {
             headers: { 'x-app-api-key': apiKey },
         });
         if (!res.ok) {
-            throw new Error(await res.text());
+            await this.handleApiError(res, 'Failed to get results');
         }
         return res.json();
     },
@@ -129,7 +151,7 @@ exports.ApiGateway = {
             },
         });
         if (!response.ok) {
-            throw new Error(`Failed to fetch status: ${response.statusText}`);
+            await this.handleApiError(response, 'Failed to get upload status');
         }
         return response.json();
     },
@@ -142,8 +164,89 @@ exports.ApiGateway = {
             method: 'POST',
         });
         if (!res.ok) {
-            throw new Error(await res.text());
+            await this.handleApiError(res, 'Failed to upload test flows');
         }
         return res.json();
     },
+    /**
+     * Generic report download method that handles both junit and allure reports
+     * @param baseUrl - API base URL
+     * @param apiKey - API key for authentication
+     * @param uploadId - Upload ID to download report for
+     * @param reportType - Type of report to download ('junit' or 'allure')
+     * @param reportPath - Optional custom path for the downloaded report
+     * @returns Promise that resolves when download is complete
+     */
+    async downloadReportGeneric(baseUrl, apiKey, uploadId, reportType, reportPath) {
+        // Define endpoint and default filename mappings
+        const config = {
+            junit: {
+                endpoint: `/results/${uploadId}/report`,
+                defaultFilename: `report-${uploadId}.xml`,
+                notFoundMessage: `Upload ID '${uploadId}' not found or no results available for this upload`,
+                errorPrefix: 'Failed to download report',
+            },
+            allure: {
+                endpoint: `/allure/${uploadId}/download`,
+                defaultFilename: `report-${uploadId}.html`,
+                notFoundMessage: `Upload ID '${uploadId}' not found or no Allure report available for this upload`,
+                errorPrefix: 'Failed to download Allure report',
+            },
+            html: {
+                endpoint: `/results/${uploadId}/html-report`,
+                defaultFilename: `report-${uploadId}.html`,
+                notFoundMessage: `Upload ID '${uploadId}' not found or no HTML report available for this upload`,
+                errorPrefix: 'Failed to download HTML report',
+            },
+        };
+        const { endpoint, defaultFilename, notFoundMessage, errorPrefix } = config[reportType];
+        const finalReportPath = reportPath || path.resolve(process.cwd(), defaultFilename);
+        const url = `${baseUrl}${endpoint}`;
+        // Make the download request
+        const res = await fetch(url, {
+            headers: {
+                'x-app-api-key': apiKey,
+            },
+            method: 'GET',
+        });
+        if (!res.ok) {
+            const errorText = await res.text();
+            if (res.status === 404) {
+                throw new Error(notFoundMessage);
+            }
+            throw new Error(`${errorPrefix}: ${res.status} ${errorText}`);
+        }
+        // Handle tilde expansion for home directory (applies to all report types)
+        let expandedPath = finalReportPath;
+        if (finalReportPath.startsWith('~/') || finalReportPath === '~') {
+            expandedPath = finalReportPath.replace(/^~/, 
+            // eslint-disable-next-line unicorn/prefer-module
+            require('node:os').homedir());
+        }
+        // Create directory structure if it doesn't exist
+        // eslint-disable-next-line unicorn/prefer-module
+        const { dirname } = require('node:path');
+        // eslint-disable-next-line unicorn/prefer-module
+        const { createWriteStream, mkdirSync } = require('node:fs');
+        // eslint-disable-next-line unicorn/prefer-module
+        const { finished } = require('node:stream/promises');
+        // eslint-disable-next-line unicorn/prefer-module
+        const { Readable } = require('node:stream');
+        const directory = dirname(expandedPath);
+        if (directory !== '.') {
+            try {
+                mkdirSync(directory, { recursive: true });
+            }
+            catch (error) {
+                // Ignore EEXIST errors (directory already exists)
+                if (error.code !== 'EEXIST') {
+                    throw error;
+                }
+            }
+        }
+        // Write the file using streaming for better memory efficiency
+        // Use 'w' flag to overwrite existing files instead of failing
+        const fileStream = createWriteStream(expandedPath, { flags: 'w' });
+        await finished(Readable.fromWeb(res.body).pipe(fileStream));
+    },
 };

package/dist/methods.d.ts

@@ -8,8 +8,6 @@ export declare const extractAppMetadataAndroid: (appFilePath: string) => Promise
 export declare const extractAppMetadataIosZip: (appFilePath: string) => Promise<TAppMetadata>;
 export declare const extractAppMetadataIos: (appFolderPath: string) => Promise<TAppMetadata>;
 export declare const uploadBinary: (filePath: string, apiUrl: string, apiKey: string, ignoreShaCheck?: boolean, log?: boolean) => Promise<string>;
-export declare const uploadBinaries: (finalAppFiles: string[], apiUrl: string, apiKey: string, ignoreShaCheck?: boolean, log?: boolean) => Promise<string[]>;
-export declare const verifyAdditionalAppFiles: (appFiles: string[] | undefined) => Promise<void>;
 /**
  * Writes JSON data to a file with error handling
  * @param filePath - Path to the output JSON file

package/dist/methods.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatDurationSeconds = exports.writeJSONFile = exports.verifyAdditionalAppFiles = exports.uploadBinaries = exports.uploadBinary = exports.extractAppMetadataIos = exports.extractAppMetadataIosZip = exports.extractAppMetadataAndroid = exports.verifyAppZip = exports.compressFilesFromRelativePath = exports.compressFolderToBlob = exports.toBuffer = void 0;
+exports.formatDurationSeconds = exports.writeJSONFile = exports.uploadBinary = exports.extractAppMetadataIos = exports.extractAppMetadataIosZip = exports.extractAppMetadataAndroid = exports.verifyAppZip = exports.compressFilesFromRelativePath = exports.compressFolderToBlob = exports.toBuffer = void 0;
 const core_1 = require("@oclif/core");
 // required polyfill for node 18
 const file_1 = require("@web-std/file");
@@ -201,21 +201,6 @@ const uploadBinary = async (filePath, apiUrl, apiKey, ignoreShaCheck = false, lo
     return id;
 };
 exports.uploadBinary = uploadBinary;
-const uploadBinaries = async (finalAppFiles, apiUrl, apiKey, ignoreShaCheck = false, log = true) => Promise.all(finalAppFiles.map((f) => (0, exports.uploadBinary)(f, apiUrl, apiKey, ignoreShaCheck, log)));
-exports.uploadBinaries = uploadBinaries;
-const verifyAdditionalAppFiles = async (appFiles) => {
-    if (appFiles?.length) {
-        if (!appFiles.every((f) => ['apk', '.app', '.zip'].some((ext) => f.endsWith(ext)))) {
-            throw new Error('App file must be a .apk for android or .app/.zip file for iOS');
-        }
-        await Promise.all(appFiles.map(async (f) => {
-            if (f.endsWith('.zip')) {
-                await (0, exports.verifyAppZip)(f);
-            }
-        }));
-    }
-};
-exports.verifyAdditionalAppFiles = verifyAdditionalAppFiles;
 async function getFileHashFromFile(file) {
     return new Promise((resolve, reject) => {
         const hash = (0, node_crypto_1.createHash)('sha256');

package/dist/types/device.types.d.ts

@@ -23,7 +23,8 @@ export declare enum EAndroidDevices {
 export declare enum EiOSVersions {
     'eighteen' = "18",
     'seventeen' = "17",
-    'sixteen' = "16"
+    'sixteen' = "16",
+    'twentySix' = "26"
 }
 export declare enum EAndroidApiLevels {
     'thirty' = "30",

package/dist/types/device.types.js

@@ -30,6 +30,7 @@ var EiOSVersions;
     EiOSVersions["eighteen"] = "18";
     EiOSVersions["seventeen"] = "17";
     EiOSVersions["sixteen"] = "16";
+    EiOSVersions["twentySix"] = "26";
 })(EiOSVersions || (exports.EiOSVersions = EiOSVersions = {}));
 var EAndroidApiLevels;
 (function (EAndroidApiLevels) {

package/dist/types/schema.types.d.ts

@@ -3,9 +3,6 @@
  * Do not make direct changes to the file.
  */
 export interface paths {
-    "/admin/cleanupOldUploads": {
-        post: operations["AdminController_cleanupOldUploads"];
-    };
     "/uploads/binary": {
         post: operations["UploadsController_createBinary"];
     };
@@ -39,15 +36,36 @@ export interface paths {
     "/results/{uploadId}/download": {
         post: operations["ResultsController_getTestRunArtifacts"];
     };
-    "/results": {
-        post: operations["ResultsController_createResult"];
-    };
     "/results/notify/{uploadId}": {
         post: operations["ResultsController_notifyTestRunComplete"];
     };
+    "/results/{uploadId}/report": {
+        get: operations["ResultsController_downloadReport"];
+    };
+    "/results/{uploadId}/html-report": {
+        get: operations["ResultsController_downloadHtmlReport"];
+    };
     "/results/compatibility/data": {
         get: operations["ResultsController_getCompatibilityData"];
     };
+    "/allure/{uploadId}/download": {
+        /**
+         * Download Allure report as HTML
+         * @description Downloads a single-file Allure report as HTML containing all test results. Report is generated once and stored in Supabase Storage for subsequent downloads.
+         */
+        get: operations["AllureController_downloadAllureReport"];
+    };
+    "/webhooks": {
+        get: operations["WebhooksController_getWebhook"];
+        post: operations["WebhooksController_setWebhook"];
+        delete: operations["WebhooksController_deleteWebhook"];
+    };
+    "/webhooks/regenerate-secret": {
+        post: operations["WebhooksController_regenerateWebhookSecret"];
+    };
+    "/webhooks/test": {
+        post: operations["WebhooksController_testWebhook"];
+    };
     "/org/increase_credits": {
         post: operations["OrgController_paddleTransactionCompleted"];
     };
@@ -60,12 +78,6 @@ export interface paths {
     "/org/accept-invite": {
         post: operations["OrgController_acceptInvite"];
     };
-    "/public/stats": {
-        get: operations["StatsController_getPublicStats"];
-    };
-    "/moropo/run-scheduled-jobs": {
-        get: operations["MoropoController_runScheduledJobs"];
-    };
     "/frontend/check-domain-saml": {
         post: operations["FrontendController_checkDomainSaml"];
     };
@@ -137,7 +149,7 @@ export interface components {
             apiUrl?: string;
             appFile?: string;
             /** @enum {string} */
-            iOSVersion?: "16" | "17" | "18";
+            iOSVersion?: "16" | "17" | "18" | "26";
             /** @enum {string} */
             iOSDevice?: "iphone-14" | "iphone-14-pro" | "iphone-15" | "iphone-15-pro" | "iphone-16" | "iphone-16-plus" | "iphone-16-pro" | "iphone-16-pro-max" | "ipad-pro-6th-gen";
             platform?: string;
@@ -182,32 +194,6 @@ export interface components {
 export type $defs = Record<string, never>;
 export type external = Record<string, never>;
 export interface operations {
-    AdminController_cleanupOldUploads: {
-        parameters: {
-            query?: {
-                /** @description If true, shows what would be deleted without actually deleting */
-                dryRun?: boolean;
-            };
-        };
-        responses: {
-            /** @description Cleanup of old uploads has been triggered. */
-            201: {
-                content: {
-                    "application/json": {
-                        message?: string;
-                        deletedCount?: number;
-                        uploads?: ({
-                            id?: string;
-                            uploadType?: string;
-                            createdAt?: string;
-                            lastUsedDate?: string | null;
-                        })[];
-                        dryRun?: boolean;
-                    };
-                };
-            };
-        };
-    };
     UploadsController_createBinary: {
         parameters: {
             header: {
@@ -445,19 +431,25 @@ export interface operations {
             };
         };
     };
-    ResultsController_createResult: {
+    ResultsController_notifyTestRunComplete: {
         parameters: {
             header: {
                 "x-app-api-key": string;
             };
+            path: {
+                uploadId: string;
+            };
         };
         responses: {
+            /** @description Send results summary email. */
             201: {
-                content: never;
+                content: {
+                    "application/json": string;
+                };
             };
         };
     };
-    ResultsController_notifyTestRunComplete: {
+    ResultsController_downloadReport: {
         parameters: {
             header: {
                 "x-app-api-key": string;
@@ -467,8 +459,26 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Send results summary email. */
-            201: {
+            /** @description Download combined JUNIT test report (report.xml) for the upload */
+            200: {
+                content: {
+                    "application/json": string;
+                };
+            };
+        };
+    };
+    ResultsController_downloadHtmlReport: {
+        parameters: {
+            header: {
+                "x-app-api-key": string;
+            };
+            path: {
+                uploadId: string;
+            };
+        };
+        responses: {
+            /** @description Download combined HTML test report (report.html) for the upload */
+            200: {
                 content: {
                     "application/json": string;
                 };
@@ -497,6 +507,141 @@ export interface operations {
             };
         };
     };
+    /**
+     * Download Allure report as HTML
+     * @description Downloads a single-file Allure report as HTML containing all test results. Report is generated once and stored in Supabase Storage for subsequent downloads.
+     */
+    AllureController_downloadAllureReport: {
+        parameters: {
+            header: {
+                "x-app-api-key": string;
+            };
+            path: {
+                /** @description The upload ID to generate Allure report for */
+                uploadId: string;
+            };
+        };
+        responses: {
+            /** @description Allure report HTML file download */
+            200: {
+                content: {
+                    "text/html": string;
+                };
+            };
+            /** @description Upload not found or no results available */
+            404: {
+                content: never;
+            };
+        };
+    };
+    WebhooksController_getWebhook: {
+        parameters: {
+            query?: {
+                /** @description Set to true to return full secret instead of masked version */
+                show_secret?: boolean;
+            };
+            header: {
+                "x-app-api-key": string;
+            };
+        };
+        responses: {
+            /** @description Current webhook configuration */
+            200: {
+                content: {
+                    "application/json": {
+                        webhook_url?: string;
+                        /** @description Full secret (only when show_secret=true) */
+                        secret_key?: string;
+                        /** @description Masked secret (default) */
+                        secret_key_masked?: string;
+                        /** Format: date-time */
+                        created_at?: string;
+                        /** Format: date-time */
+                        updated_at?: string;
+                    };
+                };
+            };
+        };
+    };
+    WebhooksController_setWebhook: {
+        parameters: {
+            header: {
+                "x-app-api-key": string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * Format: uri
+                     * @example https://api.example.com/webhook
+                     */
+                    url: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook URL set successfully */
+            201: {
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+        };
+    };
+    WebhooksController_deleteWebhook: {
+        parameters: {
+            header: {
+                "x-app-api-key": string;
+            };
+        };
+        responses: {
+            /** @description Webhook configuration deleted successfully */
+            200: {
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+        };
+    };
+    WebhooksController_regenerateWebhookSecret: {
+        parameters: {
+            header: {
+                "x-app-api-key": string;
+            };
+        };
+        responses: {
+            /** @description Webhook secret regenerated successfully */
+            201: {
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+        };
+    };
+    WebhooksController_testWebhook: {
+        parameters: {
+            header: {
+                "x-app-api-key": string;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** Format: uri */
+                    url?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Test webhook sent successfully */
+            201: {
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+        };
+    };
     OrgController_paddleTransactionCompleted: {
         parameters: {
             header: {
@@ -583,41 +728,6 @@ export interface operations {
             };
         };
     };
-    StatsController_getPublicStats: {
-        responses: {
-            200: {
-                content: never;
-            };
-        };
-    };
-    StatsController_sendDailyReport: {
-        responses: {
-            201: {
-                content: never;
-            };
-        };
-    };
-    StatsController_reportSlowTestsDev: {
-        responses: {
-            201: {
-                content: never;
-            };
-        };
-    };
-    StatsController_reportSlowTestsProd: {
-        responses: {
-            201: {
-                content: never;
-            };
-        };
-    };
-    MoropoController_runScheduledJobs: {
-        responses: {
-            200: {
-                content: never;
-            };
-        };
-    };
     FrontendController_checkDomainSaml: {
         /** @description Domain to check for SAML configuration */
         requestBody: {

package/oclif.manifest.json

@@ -25,22 +25,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "additional-app-binary-ids": {
-          "description": "The ID of the additional app binary(s) previously uploaded to devicecloud.dev to install before execution",
-          "name": "additional-app-binary-ids",
-          "default": [],
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "additional-app-files": {
-          "description": "Additional app binary(s) to install before execution",
-          "name": "additional-app-files",
-          "default": [],
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
         "android-api-level": {
           "description": "[Android only] Android API level to run your flow against",
           "name": "android-api-level",
@@ -134,6 +118,26 @@
           "multiple": false,
           "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"
+        },
         "async": {
           "description": "Immediately return (exit code 0) from the command without waiting for the results of the run (useful for saving CI minutes)",
           "name": "async",
@@ -263,7 +267,8 @@
           "options": [
             "18",
             "17",
-            "16"
+            "16",
+            "26"
           ],
           "type": "option"
         },
@@ -318,6 +323,7 @@
         },
         "mitmHost": {
           "description": "used for mitmproxy support, enterprise only, contact support if interested",
+          "hidden": true,
           "name": "mitmHost",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -328,6 +334,7 @@
             "mitmHost"
           ],
           "description": "used for mitmproxy support, enterprise only, contact support if interested",
+          "hidden": true,
           "name": "mitmPath",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -355,9 +362,7 @@
           "multiple": false,
           "options": [
             "0",
-            "90",
-            "180",
-            "270"
+            "90"
           ],
           "type": "option"
         },
@@ -372,11 +377,12 @@
           "aliases": [
             "format"
           ],
-          "description": "Runs Maestro with the --format flag, this will generate a report in the specified format",
+          "description": "Generate and download test reports in the specified format. Use \"allure\" for a complete HTML report.",
           "name": "report",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
+            "allure",
             "junit",
             "html"
           ],
@@ -414,12 +420,6 @@
           "name": "skip-chrome-onboarding",
           "allowNo": false,
           "type": "boolean"
-        },
-        "x86-arch": {
-          "description": "[iOS only, experimental] Run your flow against x86 architecture simulator instead of arm64",
-          "name": "x86-arch",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -579,5 +579,5 @@
       ]
     }
   },
-  "version": "4.0.4"
+  "version": "4.1.1"
 }

package/package.json

@@ -72,7 +72,7 @@
     "type": "git",
     "url": "https://devicecloud.dev"
   },
-  "version": "4.0.4",
+  "version": "4.1.1",
   "bugs": {
     "url": "https://discord.gg/gm3mJwcNw8"
   },
@@ -89,7 +89,7 @@
     "dcd": "./bin/dev.js",
     "prod": "./bin/run.js",
     "build": "shx rm -rf dist && tsc -b",
-    "lint": "NODE_OPTIONS='--no-deprecation' eslint . --ext .ts",
+    "lint": "eslint . --ext .ts",
     "version": "oclif readme && git add README.md",
     "test": "node scripts/test-runner.mjs"
   }