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

package/dist/commands/upload.js

@@ -1,76 +1,77 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@oclif/core");
-const promises_1 = require("node:fs/promises");
-const constants_1 = require("../constants");
-const methods_1 = require("../methods");
-const expo_1 = require("../utils/expo");
-const styling_1 = require("../utils/styling");
-class Upload extends core_1.Command {
-    static args = {
-        appFile: core_1.Args.string({
-            description: 'The binary file or Expo signed URL to upload (e.g. test.apk, test.app, test.zip, build.tar.gz, or https://expo.dev/...)',
-            name: 'App file',
+import { defineCommand } from 'citty';
+import { rm } from 'node:fs/promises';
+import { apiFlags } from '../config/flags/api.flags.js';
+import { binaryFlags } from '../config/flags/binary.flags.js';
+import { outputFlags } from '../config/flags/output.flags.js';
+import { uploadBinary, verifyAppZip } from '../methods.js';
+import { resolveAuth } from '../utils/auth.js';
+import { CliError, logger } from '../utils/cli.js';
+import { resolveApiUrl } from '../utils/config-store.js';
+import { downloadExpoUrl, extractTarGz, findAppBundle, isUrl } from '../utils/expo.js';
+import { colors, formatId } from '../utils/styling.js';
+import { ui } from '../utils/ui.js';
+export const uploadCommand = defineCommand({
+    meta: {
+        name: 'upload',
+        description: 'Upload an app binary to devicecloud.dev',
+    },
+    args: {
+        ...apiFlags,
+        'app-url': binaryFlags['app-url'],
+        'ignore-sha-check': binaryFlags['ignore-sha-check'],
+        debug: outputFlags.debug,
+        json: 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)
+                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 = 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 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 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);
+            if (isUrl(resolvedFile)) {
+                out(ui.running('Downloading Expo build from URL…'));
+                const tarPath = await 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(ui.running('Extracting Expo archive…'));
+                const extractDir = await extractTarGz(resolvedFile, debug);
                 tempFiles.push(extractDir);
-                resolvedFile = await (0, expo_1.findAppBundle)(extractDir);
+                resolvedFile = await 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 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);
+                await 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('');
-            const appBinaryId = await (0, methods_1.uploadBinary)({
-                apiKey,
+            out(ui.section('Uploading app binary'));
+            out(ui.branch(ui.fields([['file', colors.highlight(resolvedFile)]])));
+            const appBinaryId = await uploadBinary({
+                auth,
                 apiUrl,
                 debug,
                 filePath: resolvedFile,
@@ -78,32 +79,25 @@ 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`));
+            logger.log(`\n${ui.success('Upload complete')}`);
+            logger.log(ui.branch([
+                ...ui.fields([['binary id', formatId(appBinaryId)]]),
+                ui.note('Use this Binary ID in subsequent test runs with:'),
+                colors.info(`dcd cloud --app-binary-id ${appBinaryId} path/to/flow.yaml`),
+            ]));
         }
         catch (error) {
-            this.error(error, { exit: 1 });
+            logger.error(error, { exit: 1, json });
         }
         finally {
             for (const p of tempFiles) {
-                await (0, promises_1.rm)(p, { recursive: true, force: true }).catch(() => { });
+                await 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;
+    },
+});
+export default 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,31 @@
+/**
+ * `dcd whoami` — prints the logged-in user + active org from stored config.
+ */
+import { defineCommand } from 'citty';
+import { logger } from '../utils/cli.js';
+import { readConfig } from '../utils/config-store.js';
+import { colors, formatId } from '../utils/styling.js';
+import { ui } from '../utils/ui.js';
+export const whoamiCommand = defineCommand({
+    meta: {
+        name: 'whoami',
+        description: 'Show the logged-in user and active organization',
+    },
+    run() {
+        const config = readConfig();
+        if (!config?.session) {
+            logger.log(ui.info(`Not logged in. Run ${colors.highlight('dcd login')} or set ${colors.highlight('DEVICE_CLOUD_API_KEY')}.`));
+            return;
+        }
+        // Fallback for sessions stored before we persisted org name alongside id.
+        const org = config.current_org_name ?? config.current_org_id;
+        const fields = [['user', formatId(config.session.user_email)]];
+        if (org) {
+            fields.push(['org', formatId(org)]);
+        }
+        fields.push(['env', config.env]);
+        logger.log(ui.section('devicecloud.dev'));
+        logger.log(ui.branch(ui.fields(fields)));
+    },
+});
+export default 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,52 @@
+/**
+ * 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 const 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). */
+export function findEnvByApiUrl(apiUrl) {
+    const normalize = (u) => u.replace(/\/+$/, '');
+    const needle = normalize(apiUrl);
+    return Object.values(ENVIRONMENTS).find((env) => normalize(env.apiUrl) === needle);
+}
+/** Map a caller-supplied API URL to one of the known environments. */
+export 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).
+ */
+export function resolveFrontendUrl(apiUrl) {
+    if (apiUrl.includes('localhost'))
+        return 'http://localhost:5173';
+    return 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,18 @@
-"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'],
+export const apiFlags = {
+    '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,22 @@
-"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'],
+export const binaryFlags = {
+    '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,59 @@
-"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");
+import { EAndroidApiLevels, EAndroidDevices, EiOSDevices, EiOSVersions, } from '../../types/domain/device.types.js';
+const androidApiLevels = Object.values(EAndroidApiLevels).join(', ');
+const androidDevices = Object.values(EAndroidDevices).join(', ');
+const iosDevices = Object.values(EiOSDevices).join(', ');
+const iosVersions = Object.values(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({
+export const deviceFlags = {
+    '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)";
+    };
 };