@devicecloud.dev/dcd 4.4.8 → 5.0.0-beta.0

package/README.md

@@ -1,16 +1,29 @@
 # devicecloud.dev CLI
 
-
 ---
 
 One line swap out for Maestro Cloud
 
-Install:
+Install (no Node required):
+
+```sh-session
+$ curl -fsSL https://get.devicecloud.dev/install.sh | sh
+```
+
+On Windows:
+
+```powershell
+irm https://get.devicecloud.dev/install.ps1 | iex
+```
+
+Or via npm if you already have Node 22+:
 
 ```sh-session
 $ npm install -g @devicecloud.dev/dcd
 ```
 
+Upgrade later with `dcd upgrade` (binary install) or `npm install -g @devicecloud.dev/dcd@latest` (npm install).
+
 Use:
 
 ```sh-session
@@ -19,3 +32,28 @@ $ dcd cloud --apiKey <apiKey> <appFile> .myFlows/
 ```
 
 See full documentation: [Docs](https://docs.devicecloud.dev)
+
+
+## Development
+
+Requires Node 22+ and [pnpm](https://pnpm.io). `pnpm install` builds the CLI and installs the git hooks automatically.
+
+```sh-session
+$ pnpm install        # install deps, build, set up git hooks
+$ pnpm dcd <args>     # run the CLI from source
+$ pnpm lint           # ESLint
+$ pnpm typecheck      # strict tsc, no emit
+$ pnpm test           # build + boot mock API + integration/unit tests
+```
+
+### Secret scanning
+
+A [gitleaks](https://github.com/gitleaks/gitleaks) scan runs in two places, both sharing the allowlist in `.gitleaks.toml`:
+
+- **pre-commit hook** (via husky) — scans your staged changes and blocks the commit if a secret is found. Install the binary so it can run; without it the hook skips with a warning:
+  ```sh-session
+  $ brew install gitleaks      # or see github.com/gitleaks/gitleaks#installing
+  ```
+- **CI** — the `secret-scan` job scans the full history on every push and pull request, and is the enforced backstop regardless of local setup.
+
+

package/dist/commands/artifacts.d.ts

@@ -1,18 +1,47 @@
-import { Command } from '@oclif/core';
-export default class Artifacts extends Command {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        apiKey: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        apiUrl: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'upload-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'download-artifacts': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'artifacts-path': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        report: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'allure-path': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'html-path': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'junit-path': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-    };
-    run(): Promise<void>;
-}
+export declare const artifactsCommand: import("citty").CommandDef<{
+    debug: {
+        type: "boolean";
+        default: false;
+        description: string;
+    };
+    'upload-id': {
+        type: "string";
+        required: true;
+        description: string;
+    };
+    'download-artifacts': {
+        type: "string";
+        description: string;
+    };
+    'artifacts-path': {
+        type: "string";
+        description: string;
+    };
+    report: {
+        type: "string";
+        description: string;
+    };
+    'allure-path': {
+        type: "string";
+        description: string;
+    };
+    'html-path': {
+        type: "string";
+        description: string;
+    };
+    'junit-path': {
+        type: "string";
+        description: string;
+    };
+    'api-key': {
+        readonly type: "string";
+        readonly alias: ["apiKey"];
+        readonly description: "API key for devicecloud.dev (find this in the console UI). You can also set the DEVICE_CLOUD_API_KEY environment variable.";
+    };
+    'api-url': {
+        readonly type: "string";
+        readonly alias: ["apiURL", "apiUrl"];
+        readonly description: "API base URL (defaults to the URL stored by `dcd login`, else prod)";
+    };
+}>;
+export default artifactsCommand;

package/dist/commands/artifacts.js

@@ -1,93 +1,101 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@oclif/core");
-const constants_1 = require("../constants");
+exports.artifactsCommand = void 0;
+const citty_1 = require("citty");
+const api_flags_1 = require("../config/flags/api.flags");
 const report_download_service_1 = require("../services/report-download.service");
-class Artifacts extends core_1.Command {
-    static description = 'Download artifacts or reports for a completed test run';
-    static examples = [
-        '<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --download-artifacts FAILED',
-        '<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --download-artifacts ALL --artifacts-path ./my-artifacts.zip',
-        '<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --report junit',
-        '<%= config.bin %> <%= command.id %> --upload-id 123e4567-e89b-12d3-a456-426614174000 --report allure --allure-path ./report.html',
-    ];
-    static flags = {
-        apiKey: constants_1.flags.apiKey,
-        apiUrl: constants_1.flags.apiUrl,
-        debug: core_1.Flags.boolean({
+const auth_1 = require("../utils/auth");
+const cli_1 = require("../utils/cli");
+const config_store_1 = require("../utils/config-store");
+const DOWNLOAD_OPTIONS = ['ALL', 'FAILED'];
+const REPORT_OPTIONS = ['allure', 'html', 'html-detailed', 'junit'];
+exports.artifactsCommand = (0, citty_1.defineCommand)({
+    meta: {
+        name: 'artifacts',
+        description: 'Download artifacts or reports for a completed test run',
+    },
+    args: {
+        ...api_flags_1.apiFlags,
+        debug: {
+            type: 'boolean',
             default: false,
             description: 'Enable detailed debug logging for troubleshooting issues',
-        }),
-        'upload-id': core_1.Flags.string({
-            description: 'UUID of the completed upload to download artifacts for',
+        },
+        'upload-id': {
+            type: 'string',
             required: true,
-        }),
-        'download-artifacts': core_1.Flags.string({
-            description: 'Download a zip containing the logs, screenshots and videos for this run. Options: ALL (everything), FAILED (failures only).',
-            exclusive: ['report'],
-            options: ['ALL', 'FAILED'],
-        }),
-        'artifacts-path': core_1.Flags.string({
-            dependsOn: ['download-artifacts'],
-            description: 'Custom file path for downloaded artifacts (default: ./artifacts.zip)',
-        }),
-        report: core_1.Flags.string({
-            description: 'Download a test report in the specified format.',
-            exclusive: ['download-artifacts'],
-            options: ['allure', 'html', 'html-detailed', 'junit'],
-        }),
-        'allure-path': core_1.Flags.string({
-            dependsOn: ['report'],
+            description: 'UUID of the completed upload to download artifacts for',
+        },
+        'download-artifacts': {
+            type: 'string',
+            description: 'Download a zip containing the logs, screenshots and videos for this run (options: ALL, FAILED)',
+        },
+        'artifacts-path': {
+            type: 'string',
+            description: 'Custom file path for downloaded artifacts (default: ./artifacts.zip). Requires --download-artifacts.',
+        },
+        report: {
+            type: 'string',
+            description: 'Download a test report in the specified format (options: allure, html, html-detailed, junit)',
+        },
+        'allure-path': {
+            type: 'string',
             description: 'Custom file path for downloaded Allure report (default: ./report.html)',
-        }),
-        'html-path': core_1.Flags.string({
-            dependsOn: ['report'],
+        },
+        'html-path': {
+            type: 'string',
             description: 'Custom file path for downloaded HTML report (default: ./report.html)',
-        }),
-        'junit-path': core_1.Flags.string({
-            dependsOn: ['report'],
+        },
+        'junit-path': {
+            type: 'string',
             description: 'Custom file path for downloaded JUnit report (default: ./report.xml)',
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(Artifacts);
-        const { apiKey: apiKeyFlag, apiUrl, debug, 'upload-id': uploadId, 'download-artifacts': downloadArtifacts, 'artifacts-path': artifactsPath, report, 'allure-path': allurePath, 'html-path': htmlPath, 'junit-path': junitPath, } = flags;
-        const apiKey = apiKeyFlag || process.env.DEVICE_CLOUD_API_KEY;
-        if (!apiKey) {
-            this.error('API key is required. Please provide it via --api-key flag or DEVICE_CLOUD_API_KEY environment variable.');
-            return;
+        },
+    },
+    async run({ args }) {
+        const apiKeyFlag = args['api-key'];
+        const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
+        const debug = Boolean(args.debug);
+        const uploadId = args['upload-id'];
+        const downloadArtifacts = (0, cli_1.validateEnum)(args['download-artifacts'], DOWNLOAD_OPTIONS, 'download-artifacts');
+        const artifactsPath = args['artifacts-path'];
+        const report = (0, cli_1.validateEnum)(args.report, REPORT_OPTIONS, 'report');
+        const allurePath = args['allure-path'];
+        const htmlPath = args['html-path'];
+        const junitPath = args['junit-path'];
+        const auth = await (0, auth_1.resolveAuth)({ apiKeyFlag });
+        if (downloadArtifacts && report) {
+            throw new cli_1.CliError('--download-artifacts cannot also be provided when using --report (flags are mutually exclusive).');
         }
         if (!downloadArtifacts && !report) {
-            this.error('Either --download-artifacts or --report must be specified.');
-            return;
+            throw new cli_1.CliError('Either --download-artifacts or --report must be specified.');
         }
         const service = new report_download_service_1.ReportDownloadService();
         if (downloadArtifacts) {
             await service.downloadArtifacts({
-                apiKey,
+                auth,
                 apiUrl,
                 artifactsPath: artifactsPath ?? './artifacts.zip',
                 debug,
                 downloadType: downloadArtifacts,
-                logger: this.log.bind(this),
+                logger: (m) => cli_1.logger.log(m),
                 uploadId,
-                warnLogger: this.warn.bind(this),
+                warnLogger: (m) => cli_1.logger.warn(m),
             });
         }
         if (report) {
             await service.downloadReports({
                 allurePath,
-                apiKey,
+                auth,
                 apiUrl,
                 debug,
                 htmlPath,
                 junitPath,
-                logger: this.log.bind(this),
+                logger: (m) => cli_1.logger.log(m),
                 reportType: report,
                 uploadId,
-                warnLogger: this.warn.bind(this),
+                warnLogger: (m) => cli_1.logger.warn(m),
             });
         }
-    }
-}
-exports.default = Artifacts;
+    },
+});
+exports.default = exports.artifactsCommand;

package/dist/commands/cloud.d.ts

@@ -1,4 +1,3 @@
-import { Command } from '@oclif/core';
 /**
  * Primary CLI command for executing tests on DeviceCloud.
  * Orchestrates the complete test workflow:
@@ -11,90 +10,231 @@ import { Command } from '@oclif/core';
  *
  * Replaces `maestro cloud` with DeviceCloud-specific functionality.
  */
-export default class Cloud extends Command {
-    static args: {
-        firstFile: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
-        secondFile: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static description: string;
-    static enableJsonFlag: boolean;
-    static examples: string[];
-    static flags: {
-        '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>;
-        debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'download-artifacts': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'json-file': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'json-file-name': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        quiet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        report: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        branch: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'commit-sha': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'repo-name': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'pr-number': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'pr-url': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        config: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'exclude-flows': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
-        'exclude-tags': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
-        flows: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'include-tags': import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
-        'maestro-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        retry: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'runner-type': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        env: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
-        metadata: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
-        mitmHost: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        mitmPath: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'moropo-v1-api-key': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        name: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        '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>;
-        'device-locale': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'google-play': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'ios-device': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'ios-version': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        orientation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'maestro-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'android-no-snapshot': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'disable-animations': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'app-binary-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'app-file': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'app-url': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        apiKey: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        apiUrl: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-    };
-    /** Service for device/OS compatibility validation */
-    private deviceValidationService;
-    /** Service for Moropo test framework integration */
-    private moropoService;
-    /** Service for downloading test reports and artifacts */
-    private reportDownloadService;
-    /** Service for polling test results with 10-second intervals */
-    private resultsPollingService;
-    /** Service for submitting tests to the API */
-    private testSubmissionService;
-    /**
-     * Check for CLI updates and notify user if outdated
-     * Compares current version with latest npm release
-     * @returns Promise that resolves when version check is complete
-     */
-    private versionCheck;
-    /** Service for CLI version checking */
-    private versionService;
-    /**
-     * Main command execution entry point
-     * Orchestrates the complete test submission and monitoring workflow
-     * @returns Promise that resolves when command execution is complete
-     * @throws RunFailedError if tests fail
-     * @throws Error for infrastructure or configuration errors
-     */
-    run(): Promise<any>;
-    protected toErrorJson(err: unknown): unknown;
-}
+export declare const cloudCommand: import("citty").CommandDef<{
+    firstFile: {
+        type: "positional";
+        required: false;
+        description: string;
+    };
+    secondFile: {
+        type: "positional";
+        required: false;
+        description: string;
+    };
+    'artifacts-path': {
+        readonly type: "string";
+        readonly description: "Custom file path for downloaded artifacts (default: ./artifacts.zip). Requires --download-artifacts.";
+    };
+    'junit-path': {
+        readonly type: "string";
+        readonly description: "Custom file path for downloaded JUnit report (requires --report junit, default: ./report.xml)";
+    };
+    'allure-path': {
+        readonly type: "string";
+        readonly description: "Custom file path for downloaded Allure report (requires --report allure, default: ./report.html)";
+    };
+    'html-path': {
+        readonly type: "string";
+        readonly description: "Custom file path for downloaded HTML report (requires --report html, default: ./report.html)";
+    };
+    async: {
+        readonly type: "boolean";
+        readonly description: "Immediately return (exit code 0) from the command without waiting for the results of the run (useful for saving CI minutes)";
+    };
+    debug: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Enable detailed debug logging for troubleshooting issues";
+    };
+    'download-artifacts': {
+        readonly type: "string";
+        readonly description: "Download a zip containing the logs, screenshots and videos for each result in this run (options: ALL, FAILED)";
+    };
+    'dry-run': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Simulate the run without actually triggering the upload/test, useful for debugging workflow issues.";
+    };
+    json: {
+        readonly type: "boolean";
+        readonly description: "Output results in JSON format. Exit codes: 0 on success, 2 if the test run fails, 1 on CLI/infrastructure errors";
+    };
+    'json-file': {
+        readonly type: "boolean";
+        readonly description: "Write JSON output to a file. File will be called <upload_id>_dcd.json unless you supply the --json-file-name flag - note: exits with code 0 even if the test run fails (CLI/infrastructure errors still exit 1)";
+    };
+    'json-file-name': {
+        readonly type: "string";
+        readonly description: "A custom name for the JSON file (can also include relative path). Requires --json-file.";
+    };
+    quiet: {
+        readonly type: "boolean";
+        readonly alias: ["q"];
+        readonly default: false;
+        readonly description: "Quieter console output that won't provide progress updates";
+    };
+    report: {
+        readonly type: "string";
+        readonly alias: ["format"];
+        readonly description: "Generate and download test reports in the specified format (options: allure, junit, html, html-detailed). Use \"allure\" for a complete HTML report.";
+    };
+    branch: {
+        readonly type: "string";
+        readonly description: "Git branch name for this run (stored as gh_branch metadata)";
+    };
+    'commit-sha': {
+        readonly type: "string";
+        readonly description: "Git commit SHA for this run (stored as gh_sha metadata)";
+    };
+    'repo-name': {
+        readonly type: "string";
+        readonly description: "Repository in owner/repo format (stored as gh_repo metadata, e.g. \"acme/my-app\")";
+    };
+    'pr-number': {
+        readonly type: "string";
+        readonly description: "Pull request number for this run (stored as gh_pr_number metadata)";
+    };
+    'pr-url': {
+        readonly type: "string";
+        readonly description: "Pull request URL for this run (stored as gh_pr_url metadata)";
+    };
+    config: {
+        readonly type: "string";
+        readonly description: "Path to custom config.yaml file. If not provided, defaults to config.yaml in root flows folders.";
+        readonly valueHint: "path";
+    };
+    'exclude-flows': {
+        readonly type: "string";
+        readonly description: "Sub directories to ignore when building the flow file list (comma-separated, may be repeated)";
+    };
+    'exclude-tags': {
+        readonly type: "string";
+        readonly description: "Flows which have these tags will be excluded from the run (comma-separated, may be repeated)";
+    };
+    flows: {
+        readonly type: "string";
+        readonly description: "The path to the flow file or folder containing your flows";
+    };
+    'include-tags': {
+        readonly type: "string";
+        readonly description: "Only flows which have these tags will be included in the run (comma-separated, may be repeated)";
+    };
+    'maestro-version': {
+        readonly type: "string";
+        readonly alias: ["maestroVersion"];
+        readonly description: "Maestro version to run your flow against. Use \"latest\" for the most recent version. See https://docs.devicecloud.dev/configuration/maestro-versions for supported versions.";
+    };
+    retry: {
+        readonly type: "string";
+        readonly description: "Automatically retry the run up to the number of times specified (same as pressing retry in the UI) - this is free of charge";
+    };
+    'runner-type': {
+        readonly type: "string";
+        readonly default: "default";
+        readonly description: "[experimental] The type of runner to use (options: default, m4, m1, gpu1, cpu1) - note: anything other than default or cpu1 will incur premium pricing tiers, see https://docs.devicecloud.dev/configuration/runner-type for more information.";
+    };
+    env: {
+        readonly type: "string";
+        readonly alias: ["e"];
+        readonly description: "One or more environment variables to inject into your flows (format: KEY=VALUE, may be repeated)";
+        readonly valueHint: "KEY=VALUE";
+    };
+    metadata: {
+        readonly type: "string";
+        readonly alias: ["m"];
+        readonly description: "Arbitrary key-value metadata to include with your test run (format: key=value, may be repeated)";
+    };
+    mitmHost: {
+        readonly type: "string";
+        readonly description: "used for mitmproxy support, enterprise only, contact support if interested";
+    };
+    mitmPath: {
+        readonly type: "string";
+        readonly description: "used for mitmproxy support, enterprise only, contact support if interested";
+    };
+    'moropo-v1-api-key': {
+        readonly type: "string";
+        readonly description: "API key for Moropo v1 integration";
+    };
+    name: {
+        readonly type: "string";
+        readonly description: "A custom name for your upload (useful for tagging commits etc)";
+    };
+    'android-api-level': {
+        readonly type: "string";
+        readonly description: `[Android only] Android API level to run your flow against (options: ${string})`;
+    };
+    'android-device': {
+        readonly type: "string";
+        readonly description: `[Android only] Android device to run your flow against (options: ${string})`;
+    };
+    'device-locale': {
+        readonly type: "string";
+        readonly description: "Locale that will be set to a device, ISO-639-1 code and uppercase ISO-3166-1 code e.g. \"de_DE\" for Germany";
+    };
+    'google-play': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "[Android only] Run your flow against Google Play devices";
+    };
+    'ios-device': {
+        readonly type: "string";
+        readonly description: `[iOS only] iOS device to run your flow against (options: ${string})`;
+    };
+    'ios-version': {
+        readonly type: "string";
+        readonly description: `[iOS only] iOS version to run your flow against (options: ${string})`;
+    };
+    orientation: {
+        readonly type: "string";
+        readonly description: "[Android only] The orientation of the device to run your flow against (0 = portrait, 90 = landscape)";
+    };
+    'show-crosshairs': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "[Android only] Display crosshairs for screen interactions during test execution";
+    };
+    'maestro-chrome-onboarding': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "[Android only] Force Maestro-based Chrome onboarding - note: this will slow your tests but can fix browser related crashes. See https://docs.devicecloud.dev/advanced/chrome-onboarding for more information.";
+    };
+    'android-no-snapshot': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "[Android only] Force cold boot instead of using snapshot boot. This is automatically enabled for API 35+ but can be used to force cold boot on older API levels.";
+    };
+    'disable-animations': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Disable device animations during test execution. On Android, disables system animation scales. On iOS, enables Reduce Motion. Reduces CPU load and may improve test reliability.";
+    };
+    'app-binary-id': {
+        readonly type: "string";
+        readonly description: "The ID of the app binary previously uploaded to devicecloud.dev";
+    };
+    'app-file': {
+        readonly type: "string";
+        readonly description: "App binary to run your flows against";
+        readonly valueHint: "path";
+    };
+    'app-url': {
+        readonly type: "string";
+        readonly description: "Signed URL to an Expo iOS build (.tar.gz). The archive is downloaded and extracted automatically. Expo signed URLs expire after ~1 hour.";
+    };
+    'ignore-sha-check': {
+        readonly type: "boolean";
+        readonly description: "Ignore the sha hash check and upload the binary regardless of whether it already exists (not recommended)";
+    };
+    'api-key': {
+        readonly type: "string";
+        readonly alias: ["apiKey"];
+        readonly description: "API key for devicecloud.dev (find this in the console UI). You can also set the DEVICE_CLOUD_API_KEY environment variable.";
+    };
+    'api-url': {
+        readonly type: "string";
+        readonly alias: ["apiURL", "apiUrl"];
+        readonly description: "API base URL (defaults to the URL stored by `dcd login`, else prod)";
+    };
+}>;
+export default cloudCommand;