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

package/dist/commands/upload.js

@@ -1,76 +1,80 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@oclif/core");
+exports.uploadCommand = void 0;
+const citty_1 = require("citty");
 const promises_1 = require("node:fs/promises");
-const constants_1 = require("../constants");
+const api_flags_1 = require("../config/flags/api.flags");
+const binary_flags_1 = require("../config/flags/binary.flags");
+const output_flags_1 = require("../config/flags/output.flags");
 const methods_1 = require("../methods");
+const auth_1 = require("../utils/auth");
+const cli_1 = require("../utils/cli");
+const config_store_1 = require("../utils/config-store");
 const expo_1 = require("../utils/expo");
 const styling_1 = require("../utils/styling");
-class Upload extends core_1.Command {
-    static args = {
-        appFile: core_1.Args.string({
-            description: 'The binary file or Expo signed URL to upload (e.g. test.apk, test.app, test.zip, build.tar.gz, or https://expo.dev/...)',
-            name: 'App file',
+exports.uploadCommand = (0, citty_1.defineCommand)({
+    meta: {
+        name: 'upload',
+        description: 'Upload an app binary to devicecloud.dev',
+    },
+    args: {
+        ...api_flags_1.apiFlags,
+        'app-url': binary_flags_1.binaryFlags['app-url'],
+        'ignore-sha-check': binary_flags_1.binaryFlags['ignore-sha-check'],
+        debug: output_flags_1.outputFlags.debug,
+        json: output_flags_1.outputFlags.json,
+        appFile: {
+            type: 'positional',
             required: false,
-        }),
-    };
-    static description = 'Upload an app binary to devicecloud.dev';
-    static enableJsonFlag = true;
-    static examples = [
-        '<%= config.bin %> <%= command.id %> path/to/app.apk',
-        '<%= config.bin %> <%= command.id %> path/to/app.zip --api-key YOUR_API_KEY',
-        '<%= config.bin %> <%= command.id %> path/to/build.tar.gz',
-        '<%= config.bin %> <%= command.id %> --app-url https://expo.dev/artifacts/...',
-    ];
-    static flags = {
-        apiKey: constants_1.flags.apiKey,
-        apiUrl: constants_1.flags.apiUrl,
-        'app-url': constants_1.flags['app-url'],
-        debug: constants_1.flags.debug,
-        'ignore-sha-check': constants_1.flags['ignore-sha-check'],
-    };
-    async run() {
+            description: 'The binary file or Expo signed URL to upload (e.g. test.apk, test.app, test.zip, build.tar.gz, or https://expo.dev/...)',
+        },
+    },
+    async run({ args }) {
         const tempFiles = [];
+        const json = Boolean(args.json);
+        // When --json is set, suppress chatty progress logs so stdout stays parseable.
+        const out = (m) => {
+            if (!json)
+                cli_1.logger.log(m);
+        };
         try {
-            const { args, flags } = await this.parse(Upload);
-            const { apiKey: apiKeyFlag, apiUrl, 'app-url': appUrl, debug, 'ignore-sha-check': ignoreShaCheck, json, } = flags;
-            const apiKey = apiKeyFlag || process.env.DEVICE_CLOUD_API_KEY;
-            if (!apiKey) {
-                throw new Error('You must provide an API key via --api-key flag or DEVICE_CLOUD_API_KEY environment variable');
-            }
-            // Resolve source: --app-url flag takes precedence, then positional arg
-            let resolvedFile = appUrl ?? args.appFile;
+            const apiKeyFlag = args['api-key'];
+            const apiUrl = (0, config_store_1.resolveApiUrl)(args['api-url']);
+            const appUrl = args['app-url'];
+            const ignoreShaCheck = Boolean(args['ignore-sha-check']);
+            const debug = Boolean(args.debug);
+            const positional = args.appFile;
+            const auth = await (0, auth_1.resolveAuth)({ apiKeyFlag });
+            let resolvedFile = appUrl ?? positional;
             if (!resolvedFile) {
-                throw new Error('You must provide an app file path or a signed Expo URL via --app-url');
+                throw new cli_1.CliError('You must provide an app file path or a signed Expo URL via --app-url');
             }
-            // Download from URL if needed
             if ((0, expo_1.isUrl)(resolvedFile)) {
-                this.log(`   ${styling_1.colors.dim('→ Downloading Expo build from URL...')}`);
-                const tarPath = await (0, expo_1.downloadExpoUrl)(resolvedFile, debug ?? false);
+                out(`   ${styling_1.colors.dim('→ Downloading Expo build from URL...')}`);
+                const tarPath = await (0, expo_1.downloadExpoUrl)(resolvedFile, debug);
                 tempFiles.push(tarPath);
                 resolvedFile = tarPath;
             }
-            // Extract .tar.gz if needed
             if (resolvedFile.endsWith('.tar.gz')) {
-                this.log(`   ${styling_1.colors.dim('→ Extracting Expo archive...')}`);
-                const extractDir = await (0, expo_1.extractTarGz)(resolvedFile, debug ?? false);
+                out(`   ${styling_1.colors.dim('→ Extracting Expo archive...')}`);
+                const extractDir = await (0, expo_1.extractTarGz)(resolvedFile, debug);
                 tempFiles.push(extractDir);
                 resolvedFile = await (0, expo_1.findAppBundle)(extractDir);
                 if (debug) {
-                    this.log(`[DEBUG] Found .app bundle at: ${resolvedFile}`);
+                    out(`[DEBUG] Found .app bundle at: ${resolvedFile}`);
                 }
             }
-            if (!['apk', '.app', '.zip', '.tar.gz'].some((ext) => resolvedFile.endsWith(ext))) {
-                throw new Error('App file must be a .apk for Android, .app/.zip for iOS, or .tar.gz (Expo iOS build)');
+            if (!['.apk', '.app', '.zip', '.tar.gz'].some((ext) => resolvedFile.endsWith(ext))) {
+                throw new cli_1.CliError('App file must be a .apk for Android, .app/.zip for iOS, or .tar.gz (Expo iOS build)');
             }
             if (resolvedFile.endsWith('.zip')) {
                 await (0, methods_1.verifyAppZip)(resolvedFile);
             }
-            this.log((0, styling_1.sectionHeader)('Uploading app binary'));
-            this.log(`   ${styling_1.colors.dim('→ File:')} ${styling_1.colors.highlight(resolvedFile)}`);
-            this.log('');
+            out((0, styling_1.sectionHeader)('Uploading app binary'));
+            out(`   ${styling_1.colors.dim('→ File:')} ${styling_1.colors.highlight(resolvedFile)}`);
+            out('');
             const appBinaryId = await (0, methods_1.uploadBinary)({
-                apiKey,
+                auth,
                 apiUrl,
                 debug,
                 filePath: resolvedFile,
@@ -78,32 +82,23 @@ class Upload extends core_1.Command {
                 log: !json,
             });
             if (json) {
-                return { appBinaryId };
+                // eslint-disable-next-line no-console
+                console.log(JSON.stringify({ appBinaryId }, null, 2));
+                return;
             }
-            this.log(`\n${styling_1.colors.success('✓')}  ${styling_1.colors.bold('Upload complete')}`);
-            this.log(`   ${styling_1.colors.dim('Binary ID:')} ${(0, styling_1.formatId)(appBinaryId)}\n`);
-            this.log(styling_1.colors.dim('You can use this Binary ID in subsequent test runs with:'));
-            this.log(styling_1.colors.info(`dcd cloud --app-binary-id ${appBinaryId} path/to/flow.yaml\n`));
+            cli_1.logger.log(`\n${styling_1.symbols.success} ${styling_1.colors.bold('Upload complete')}`);
+            cli_1.logger.log(`   ${styling_1.colors.dim('Binary ID:')} ${(0, styling_1.formatId)(appBinaryId)}\n`);
+            cli_1.logger.log(styling_1.colors.dim('You can use this Binary ID in subsequent test runs with:'));
+            cli_1.logger.log(styling_1.colors.info(`dcd cloud --app-binary-id ${appBinaryId} path/to/flow.yaml\n`));
         }
         catch (error) {
-            this.error(error, { exit: 1 });
+            cli_1.logger.error(error, { exit: 1, json });
         }
         finally {
             for (const p of tempFiles) {
                 await (0, promises_1.rm)(p, { recursive: true, force: true }).catch(() => { });
             }
         }
-    }
-    toErrorJson(err) {
-        if (err instanceof Error) {
-            return {
-                error: {
-                    message: err.message,
-                    ...(err.code ? { code: err.code } : {}),
-                },
-            };
-        }
-        return { error: { message: String(err) } };
-    }
-}
-exports.default = Upload;
+    },
+});
+exports.default = exports.uploadCommand;

package/dist/commands/whoami.d.ts

@@ -0,0 +1,2 @@
+export declare const whoamiCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+export default whoamiCommand;

package/dist/commands/whoami.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.whoamiCommand = void 0;
+/**
+ * `dcd whoami` — prints the logged-in user + active org from stored config.
+ */
+const citty_1 = require("citty");
+const cli_1 = require("../utils/cli");
+const config_store_1 = require("../utils/config-store");
+const styling_1 = require("../utils/styling");
+exports.whoamiCommand = (0, citty_1.defineCommand)({
+    meta: {
+        name: 'whoami',
+        description: 'Show the logged-in user and active organization',
+    },
+    run() {
+        const config = (0, config_store_1.readConfig)();
+        if (!config?.session) {
+            cli_1.logger.log(`${styling_1.symbols.info} Not logged in. Run ${styling_1.colors.highlight('dcd login')} or set ${styling_1.colors.highlight('DEVICE_CLOUD_API_KEY')}.`);
+            return;
+        }
+        cli_1.logger.log((0, styling_1.sectionHeader)('devicecloud.dev'));
+        cli_1.logger.log(`   ${styling_1.colors.dim('User:')} ${styling_1.colors.highlight(config.session.user_email)}`);
+        if (config.current_org_name) {
+            cli_1.logger.log(`   ${styling_1.colors.dim('Org:')}  ${styling_1.colors.highlight(config.current_org_name)}`);
+        }
+        else if (config.current_org_id) {
+            // Fallback for sessions stored before we persisted org name alongside id.
+            cli_1.logger.log(`   ${styling_1.colors.dim('Org:')}  ${styling_1.colors.highlight(config.current_org_id)}`);
+        }
+        cli_1.logger.log(`   ${styling_1.colors.dim('Env:')}  ${config.env}`);
+    },
+});
+exports.default = exports.whoamiCommand;

package/dist/config/environments.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Per-env devicecloud.dev coordinates — single source of truth for the URLs
+ * and Supabase credentials the CLI uses.
+ *
+ * **These `anonKey` values are public.** Supabase anon keys are JWTs designed
+ * to be embedded in client code (web apps, mobile apps, CLIs). They only
+ * grant whatever the project's RLS policies expose. Don't worry about seeing
+ * them here — every Supabase-based product ships its anon key the same way.
+ * https://supabase.com/docs/guides/api/api-keys
+ */
+export type DcdEnvName = 'dev' | 'prod';
+export interface DcdEnvironment {
+    apiUrl: string;
+    frontendUrl: string;
+    supabase: {
+        url: string;
+        projectRef: string;
+        anonKey: string;
+    };
+}
+export declare const ENVIRONMENTS: Record<DcdEnvName, DcdEnvironment>;
+/** Exact-match lookup of a known environment by API URL (trailing slashes ignored). */
+export declare function findEnvByApiUrl(apiUrl: string): DcdEnvironment | undefined;
+/** Map a caller-supplied API URL to one of the known environments. */
+export declare function inferEnvFromApiUrl(apiUrl: string): DcdEnvName;
+/**
+ * Frontend URL to open for a given API URL. Same as
+ * `ENVIRONMENTS[inferEnvFromApiUrl(apiUrl)].frontendUrl`, except that when the
+ * API is running on localhost we assume the frontend is too (vite dev server).
+ */
+export declare function resolveFrontendUrl(apiUrl: string): string;

package/dist/config/environments.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Per-env devicecloud.dev coordinates — single source of truth for the URLs
+ * and Supabase credentials the CLI uses.
+ *
+ * **These `anonKey` values are public.** Supabase anon keys are JWTs designed
+ * to be embedded in client code (web apps, mobile apps, CLIs). They only
+ * grant whatever the project's RLS policies expose. Don't worry about seeing
+ * them here — every Supabase-based product ships its anon key the same way.
+ * https://supabase.com/docs/guides/api/api-keys
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENVIRONMENTS = void 0;
+exports.findEnvByApiUrl = findEnvByApiUrl;
+exports.inferEnvFromApiUrl = inferEnvFromApiUrl;
+exports.resolveFrontendUrl = resolveFrontendUrl;
+exports.ENVIRONMENTS = {
+    prod: {
+        apiUrl: 'https://api.devicecloud.dev',
+        frontendUrl: 'https://console.devicecloud.dev',
+        supabase: {
+            url: 'https://cloud.devicecloud.dev',
+            projectRef: 'pgydnphbimetinsgfkbo',
+            anonKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InBneWRucGhiaW1ldGluc2dma2JvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3MDc1OTQzNDYsImV4cCI6MjAyMzE3MDM0Nn0.hAYOMFxxwX1exkQkY9xyQJGC_GhGnyogkj2N-kBkMI8',
+        },
+    },
+    dev: {
+        apiUrl: 'https://api.dev.devicecloud.dev',
+        frontendUrl: 'https://dev.console.devicecloud.dev',
+        supabase: {
+            url: 'https://lbmsowehtjwnqlurpemb.supabase.co',
+            projectRef: 'lbmsowehtjwnqlurpemb',
+            anonKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImxibXNvd2VodGp3bnFsdXJwZW1iIiwicm9sZSI6ImFub24iLCJpYXQiOjE3MDkyMTg0ODcsImV4cCI6MjAyNDc5NDQ4N30.zeLTMAuZ_WwYvGdeP0kdvL_Zrs-RQee5APPyxmWq7qQ',
+        },
+    },
+};
+/** Exact-match lookup of a known environment by API URL (trailing slashes ignored). */
+function findEnvByApiUrl(apiUrl) {
+    const normalize = (u) => u.replace(/\/+$/, '');
+    const needle = normalize(apiUrl);
+    return Object.values(exports.ENVIRONMENTS).find((env) => normalize(env.apiUrl) === needle);
+}
+/** Map a caller-supplied API URL to one of the known environments. */
+function inferEnvFromApiUrl(apiUrl) {
+    if (apiUrl.includes('api.dev.') || apiUrl.includes('localhost'))
+        return 'dev';
+    return 'prod';
+}
+/**
+ * Frontend URL to open for a given API URL. Same as
+ * `ENVIRONMENTS[inferEnvFromApiUrl(apiUrl)].frontendUrl`, except that when the
+ * API is running on localhost we assume the frontend is too (vite dev server).
+ */
+function resolveFrontendUrl(apiUrl) {
+    if (apiUrl.includes('localhost'))
+        return 'http://localhost:5173';
+    return exports.ENVIRONMENTS[inferEnvFromApiUrl(apiUrl)].frontendUrl;
+}

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

@@ -2,6 +2,14 @@
  * API authentication and configuration flags
  */
 export declare const apiFlags: {
-    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>;
+    readonly '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.";
+    };
+    readonly 'api-url': {
+        readonly type: "string";
+        readonly alias: ["apiURL", "apiUrl"];
+        readonly description: "API base URL (defaults to the URL stored by `dcd login`, else prod)";
+    };
 };

package/dist/config/flags/api.flags.js

@@ -1,19 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.apiFlags = void 0;
-const core_1 = require("@oclif/core");
 /**
  * API authentication and configuration flags
  */
 exports.apiFlags = {
-    apiKey: core_1.Flags.string({
-        aliases: ['api-key'],
+    'api-key': {
+        type: 'string',
+        alias: ['apiKey'],
         description: 'API key for devicecloud.dev (find this in the console UI). You can also set the DEVICE_CLOUD_API_KEY environment variable.',
-    }),
-    apiUrl: core_1.Flags.string({
-        aliases: ['api-url', 'apiURL'],
-        default: 'https://api.devicecloud.dev',
-        description: 'API base URL',
-        hidden: true,
-    }),
+    },
+    'api-url': {
+        type: 'string',
+        alias: ['apiURL', 'apiUrl'],
+        // No citty `default` here: commands resolve the effective URL via
+        // resolveApiUrl() so a value stored by `dcd login` (e.g. dev/staging) is
+        // honored instead of always defaulting to prod. See utils/config-store.ts.
+        description: 'API base URL (defaults to the URL stored by `dcd login`, else prod)',
+    },
 };

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

@@ -2,8 +2,21 @@
  * Binary upload and management flags
  */
 export declare const binaryFlags: {
-    'app-binary-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'app-file': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'app-url': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    readonly 'app-binary-id': {
+        readonly type: "string";
+        readonly description: "The ID of the app binary previously uploaded to devicecloud.dev";
+    };
+    readonly 'app-file': {
+        readonly type: "string";
+        readonly description: "App binary to run your flows against";
+        readonly valueHint: "path";
+    };
+    readonly '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.";
+    };
+    readonly '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)";
+    };
 };

package/dist/config/flags/binary.flags.js

@@ -1,26 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.binaryFlags = void 0;
-const core_1 = require("@oclif/core");
 /**
  * Binary upload and management flags
  */
 exports.binaryFlags = {
-    'app-binary-id': core_1.Flags.string({
-        aliases: ['app-binary-id'],
+    'app-binary-id': {
+        type: 'string',
         description: 'The ID of the app binary previously uploaded to devicecloud.dev',
-    }),
-    'app-file': core_1.Flags.file({
-        aliases: ['app-file'],
+    },
+    'app-file': {
+        type: 'string',
         description: 'App binary to run your flows against',
-        exclusive: ['app-url'],
-    }),
-    'app-url': core_1.Flags.string({
-        aliases: ['app-url'],
+        valueHint: 'path',
+    },
+    'app-url': {
+        type: 'string',
         description: 'Signed URL to an Expo iOS build (.tar.gz). The archive is downloaded and extracted automatically. Expo signed URLs expire after ~1 hour.',
-        exclusive: ['app-file'],
-    }),
-    'ignore-sha-check': core_1.Flags.boolean({
+    },
+    'ignore-sha-check': {
+        type: 'boolean',
         description: 'Ignore the sha hash check and upload the binary regardless of whether it already exists (not recommended)',
-    }),
+    },
 };

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

@@ -2,15 +2,53 @@
  * Device-specific flags for Android and iOS configuration
  */
 export declare const deviceFlags: {
-    '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>;
+    readonly 'android-api-level': {
+        readonly type: "string";
+        readonly description: `[Android only] Android API level to run your flow against (options: ${string})`;
+    };
+    readonly 'android-device': {
+        readonly type: "string";
+        readonly description: `[Android only] Android device to run your flow against (options: ${string})`;
+    };
+    readonly '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";
+    };
+    readonly 'google-play': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "[Android only] Run your flow against Google Play devices";
+    };
+    readonly 'ios-device': {
+        readonly type: "string";
+        readonly description: `[iOS only] iOS device to run your flow against (options: ${string})`;
+    };
+    readonly 'ios-version': {
+        readonly type: "string";
+        readonly description: `[iOS only] iOS version to run your flow against (options: ${string})`;
+    };
+    readonly orientation: {
+        readonly type: "string";
+        readonly description: "[Android only] The orientation of the device to run your flow against (0 = portrait, 90 = landscape)";
+    };
+    readonly 'show-crosshairs': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "[Android only] Display crosshairs for screen interactions during test execution";
+    };
+    readonly '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.";
+    };
+    readonly '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.";
+    };
+    readonly '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.";
+    };
 };

package/dist/config/flags/device.flags.js

@@ -1,54 +1,62 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deviceFlags = void 0;
-const core_1 = require("@oclif/core");
 const device_types_1 = require("../../types/domain/device.types");
+const androidApiLevels = Object.values(device_types_1.EAndroidApiLevels).join(', ');
+const androidDevices = Object.values(device_types_1.EAndroidDevices).join(', ');
+const iosDevices = Object.values(device_types_1.EiOSDevices).join(', ');
+const iosVersions = Object.values(device_types_1.EiOSVersions).join(', ');
 /**
  * Device-specific flags for Android and iOS configuration
  */
 exports.deviceFlags = {
-    '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),
-    }),
-    'android-device': core_1.Flags.string({
-        description: '[Android only] Android device to run your flow against',
-        options: Object.values(device_types_1.EAndroidDevices),
-    }),
-    'device-locale': core_1.Flags.string({
+    'android-api-level': {
+        type: 'string',
+        description: `[Android only] Android API level to run your flow against (options: ${androidApiLevels})`,
+    },
+    'android-device': {
+        type: 'string',
+        description: `[Android only] Android device to run your flow against (options: ${androidDevices})`,
+    },
+    'device-locale': {
+        type: 'string',
         description: 'Locale that will be set to a device, ISO-639-1 code and uppercase ISO-3166-1 code e.g. "de_DE" for Germany',
-    }),
-    'google-play': core_1.Flags.boolean({
-        aliases: ['google-play'],
+    },
+    'google-play': {
+        type: 'boolean',
         default: false,
         description: '[Android only] Run your flow against Google Play devices',
-    }),
-    'ios-device': core_1.Flags.string({
-        description: '[iOS only] iOS device to run your flow against',
-        options: Object.values(device_types_1.EiOSDevices),
-    }),
-    'ios-version': core_1.Flags.string({
-        description: '[iOS only] iOS version to run your flow against',
-        options: Object.values(device_types_1.EiOSVersions),
-    }),
-    orientation: core_1.Flags.string({
+    },
+    'ios-device': {
+        type: 'string',
+        description: `[iOS only] iOS device to run your flow against (options: ${iosDevices})`,
+    },
+    'ios-version': {
+        type: 'string',
+        description: `[iOS only] iOS version to run your flow against (options: ${iosVersions})`,
+    },
+    orientation: {
+        type: 'string',
         description: '[Android only] The orientation of the device to run your flow against (0 = portrait, 90 = landscape)',
-        options: ['0', '90'],
-    }),
-    'show-crosshairs': core_1.Flags.boolean({
+    },
+    'show-crosshairs': {
+        type: 'boolean',
         default: false,
         description: '[Android only] Display crosshairs for screen interactions during test execution',
-    }),
-    'maestro-chrome-onboarding': core_1.Flags.boolean({
+    },
+    'maestro-chrome-onboarding': {
+        type: 'boolean',
         default: false,
         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': core_1.Flags.boolean({
+    },
+    'android-no-snapshot': {
+        type: 'boolean',
         default: false,
         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': core_1.Flags.boolean({
+    },
+    'disable-animations': {
+        type: 'boolean',
         default: false,
         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.',
-    }),
+    },
 };

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

@@ -2,10 +2,31 @@
  * Environment configuration and metadata flags
  */
 export declare const environmentFlags: {
-    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>;
+    readonly 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";
+    };
+    readonly 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)";
+    };
+    readonly mitmHost: {
+        readonly type: "string";
+        readonly description: "used for mitmproxy support, enterprise only, contact support if interested";
+    };
+    readonly mitmPath: {
+        readonly type: "string";
+        readonly description: "used for mitmproxy support, enterprise only, contact support if interested";
+    };
+    readonly 'moropo-v1-api-key': {
+        readonly type: "string";
+        readonly description: "API key for Moropo v1 integration";
+    };
+    readonly name: {
+        readonly type: "string";
+        readonly description: "A custom name for your upload (useful for tagging commits etc)";
+    };
 };