@devicecloud.dev/dcd 4.0.3 → 4.1.0

package/dist/commands/cloud.d.ts

@@ -19,6 +19,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>;
@@ -54,4 +56,17 @@ export default class Cloud extends Command {
     };
     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

@@ -5,15 +5,16 @@ exports.mimeTypeLookupByExtension = void 0;
 const core_1 = require("@oclif/core");
 const cli_ux_1 = require("@oclif/core/lib/cli-ux");
 const errors_1 = require("@oclif/core/lib/errors");
+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',
@@ -45,16 +46,22 @@ class Cloud extends core_1.Command {
     static examples = ['<%= config.bin %> <%= command.id %>'];
     static flags = constants_1.flags;
     versionCheck = async () => {
-        const versionResponse = await fetch('https://registry.npmjs.org/@devicecloud.dev/dcd/latest');
-        const versionResponseJson = await versionResponse.json();
-        const latestVersion = versionResponseJson.version;
-        if (latestVersion !== this.config.version) {
-            this.log(`
+        try {
+            const latestVersion = (0, node_child_process_1.execSync)('npm view @devicecloud.dev/dcd version', {
+                encoding: 'utf8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).trim();
+            if (latestVersion !== this.config.version) {
+                this.log(`
   -------------------
   A new version of the devicecloud.dev CLI is available: ${latestVersion}
   Run 'npm install -g @devicecloud.dev/dcd@latest' to update to the latest version
   -------------------
   `);
+            }
+        }
+        catch {
+            // Silently fail if npm view command fails (e.g., no network connection)
         }
     };
     async run() {
@@ -64,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 { '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, '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, 'x86-arch': x86Arch, ...rest } = flags;
             // Resolve "latest" maestro version to actual version
             const resolvedMaestroVersion = (0, constants_1.resolveMaestroVersion)(maestroVersion);
             // Store debug flag for use in catch block
@@ -163,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);
@@ -215,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.");
@@ -368,8 +373,9 @@ class Cloud extends core_1.Command {
             }
             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}`);
                 }
             }
@@ -684,33 +690,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;
@@ -811,5 +793,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

@@ -13,6 +13,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>;

package/dist/constants.js

@@ -14,6 +14,7 @@ exports.SUPPORTED_MAESTRO_VERSIONS = [
     '1.41.0',
     '2.0.2',
     '2.0.3',
+    '2.0.4',
 ];
 exports.DEFAULT_MAESTRO_VERSION = '1.41.0';
 const getLatestMaestroVersion = () => exports.SUPPORTED_MAESTRO_VERSIONS.at(-1);
@@ -74,6 +75,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)',
     }),
@@ -191,8 +200,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',

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,88 @@ 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
+        const fileStream = createWriteStream(expandedPath, { flags: 'wx' });
+        await finished(Readable.fromWeb(res.body).pipe(fileStream));
+    },
 };

package/dist/plan.d.ts

@@ -1,9 +1,17 @@
+interface INotificationsConfig {
+    email?: {
+        enabled?: boolean;
+        onSuccess?: boolean;
+        recipients?: string[];
+    };
+}
 interface IWorkspaceConfig {
     excludeTags?: null | string[];
     executionOrder?: IExecutionOrder | null;
     flows?: null | string[];
     includeTags?: null | string[];
     local?: ILocal | null;
+    notifications?: INotificationsConfig;
 }
 interface ILocal {
     deterministicOrder: boolean | null;

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

@@ -134,6 +134,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 +283,8 @@
           "options": [
             "18",
             "17",
-            "16"
+            "16",
+            "26"
           ],
           "type": "option"
         },
@@ -303,6 +324,7 @@
             "1.41.0",
             "2.0.2",
             "2.0.3",
+            "2.0.4",
             "latest"
           ],
           "type": "option"
@@ -371,11 +393,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"
           ],
@@ -578,5 +601,5 @@
       ]
     }
   },
-  "version": "4.0.3"
+  "version": "4.1.0"
 }

package/package.json

@@ -72,7 +72,7 @@
     "type": "git",
     "url": "https://devicecloud.dev"
   },
-  "version": "4.0.3",
+  "version": "4.1.0",
   "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"
   }