@devicecloud.dev/dcd 4.4.3 → 4.4.4

package/dist/commands/live.d.ts

@@ -0,0 +1,22 @@
+import { Command } from '@oclif/core';
+export default class Live 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>;
+        'app-binary-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        platform: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'session-id': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        yaml: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    static hidden: boolean;
+    static strict: boolean;
+    run(): Promise<void>;
+    private execTest;
+    private getFrontendUrl;
+    private getStatus;
+    private installBinary;
+    private startSession;
+    private stopSession;
+}

package/dist/commands/live.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const constants_1 = require("../constants");
+const api_gateway_1 = require("../gateways/api-gateway");
+const styling_1 = require("../utils/styling");
+class Live extends core_1.Command {
+    static description = 'Start and interact with a live device session';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> start',
+        '<%= config.bin %> <%= command.id %> start --platform android --app-binary-id abc-123',
+        '<%= config.bin %> <%= command.id %> install --session-id 42 --app-binary-id abc-123',
+        '<%= config.bin %> <%= command.id %> exec --session-id 42 --yaml "- launchApp"',
+        '<%= config.bin %> <%= command.id %> stop --session-id 42',
+        '<%= config.bin %> <%= command.id %> status --session-id 42',
+    ];
+    static flags = {
+        apiKey: constants_1.flags.apiKey,
+        apiUrl: constants_1.flags.apiUrl,
+        'app-binary-id': core_1.Flags.string({
+            description: 'Binary upload ID to install on the device',
+        }),
+        platform: core_1.Flags.string({
+            default: 'android',
+            description: 'Device platform',
+            options: ['android', 'ios'],
+        }),
+        'session-id': core_1.Flags.integer({
+            description: 'Live session ID (required for install, exec, stop, status)',
+        }),
+        yaml: core_1.Flags.string({
+            description: 'Maestro YAML commands to execute (for exec subcommand)',
+        }),
+    };
+    static hidden = true;
+    static strict = false;
+    async run() {
+        const { argv, flags } = await this.parse(Live);
+        const { apiKey: apiKeyFlag, apiUrl, 'app-binary-id': binaryId, platform, 'session-id': sessionId, yaml, } = flags;
+        const subcommand = argv[0];
+        if (!subcommand || !['exec', 'install', 'start', 'status', 'stop'].includes(subcommand)) {
+            this.log((0, styling_1.sectionHeader)('Live Session Commands'));
+            this.log(`   ${styling_1.colors.bold('start')}    Start a new live device session`);
+            this.log(`   ${styling_1.colors.bold('install')}  Install a binary on the device`);
+            this.log(`   ${styling_1.colors.bold('exec')}     Execute Maestro YAML commands`);
+            this.log(`   ${styling_1.colors.bold('stop')}     Stop a live session`);
+            this.log(`   ${styling_1.colors.bold('status')}   Get session status`);
+            this.log('');
+            this.log(`   Run ${styling_1.colors.highlight('dcd live <command> --help')} for details`);
+            return;
+        }
+        const apiKey = apiKeyFlag || process.env.DEVICE_CLOUD_API_KEY;
+        if (!apiKey) {
+            this.error('API key is required. Provide via --api-key flag or DEVICE_CLOUD_API_KEY environment variable.');
+        }
+        switch (subcommand) {
+            case 'start': {
+                await this.startSession(apiUrl, apiKey, platform, binaryId);
+                break;
+            }
+            case 'install': {
+                if (!sessionId)
+                    this.error('--session-id is required for install');
+                if (!binaryId)
+                    this.error('--app-binary-id is required for install');
+                await this.installBinary(apiUrl, apiKey, sessionId, binaryId);
+                break;
+            }
+            case 'exec': {
+                if (!sessionId)
+                    this.error('--session-id is required for exec');
+                if (!yaml)
+                    this.error('--yaml is required for exec');
+                await this.execTest(apiUrl, apiKey, sessionId, yaml);
+                break;
+            }
+            case 'stop': {
+                if (!sessionId)
+                    this.error('--session-id is required for stop');
+                await this.stopSession(apiUrl, apiKey, sessionId);
+                break;
+            }
+            case 'status': {
+                if (!sessionId)
+                    this.error('--session-id is required for status');
+                await this.getStatus(apiUrl, apiKey, sessionId);
+                break;
+            }
+            default: {
+                break;
+            }
+        }
+    }
+    async execTest(apiUrl, apiKey, sessionId, yaml) {
+        this.log(`${styling_1.symbols.running} Executing commands on session ${sessionId}...`);
+        const res = await fetch(`${apiUrl}/live/${sessionId}/exec`, {
+            body: JSON.stringify({ yaml }),
+            headers: {
+                'content-type': 'application/json',
+                'x-app-api-key': apiKey,
+            },
+            method: 'POST',
+        });
+        if (!res.ok) {
+            await api_gateway_1.ApiGateway.handleApiError(res, 'Failed to execute test');
+        }
+        const result = (await res.json());
+        if (result.success) {
+            this.log(`${styling_1.symbols.success} Command executed successfully`);
+        }
+        else {
+            this.log(`${styling_1.symbols.error} Command failed`);
+        }
+        if (result.output) {
+            this.log((0, styling_1.sectionHeader)('Output'));
+            this.log(result.output);
+        }
+        if (result.error) {
+            this.log((0, styling_1.sectionHeader)('Error'));
+            this.log(styling_1.colors.error(result.error));
+        }
+    }
+    getFrontendUrl(apiUrl) {
+        if (apiUrl.includes('localhost:8000'))
+            return 'http://localhost:5173';
+        if (apiUrl.includes('api.dev.'))
+            return 'https://dev.console.devicecloud.dev';
+        return 'https://console.devicecloud.dev';
+    }
+    async getStatus(apiUrl, apiKey, sessionId) {
+        const res = await fetch(`${apiUrl}/live/${sessionId}`, {
+            headers: {
+                'x-app-api-key': apiKey,
+            },
+            method: 'GET',
+        });
+        if (!res.ok) {
+            await api_gateway_1.ApiGateway.handleApiError(res, 'Failed to get session status');
+        }
+        const session = (await res.json());
+        this.log((0, styling_1.sectionHeader)('Live Session'));
+        this.log(`   ${styling_1.colors.dim('Session ID:')} ${styling_1.colors.highlight(String(session.id))}`);
+        this.log(`   ${styling_1.colors.dim('Platform:')}   ${session.platform}`);
+        this.log(`   ${styling_1.colors.dim('Status:')}     ${session.status}`);
+        if (session.binary_upload_id) {
+            this.log(`   ${styling_1.colors.dim('Binary:')}     ${session.binary_upload_id}`);
+        }
+        this.log(`   ${styling_1.colors.dim('Created:')}    ${new Date(session.created_at).toLocaleString()}`);
+    }
+    async installBinary(apiUrl, apiKey, sessionId, binaryId) {
+        this.log(`${styling_1.symbols.running} Installing binary ${styling_1.colors.highlight(binaryId)} on session ${sessionId}...`);
+        const res = await fetch(`${apiUrl}/live/${sessionId}/install`, {
+            body: JSON.stringify({ binaryUploadId: binaryId }),
+            headers: {
+                'content-type': 'application/json',
+                'x-app-api-key': apiKey,
+            },
+            method: 'POST',
+        });
+        if (!res.ok) {
+            await api_gateway_1.ApiGateway.handleApiError(res, 'Failed to install binary');
+        }
+        this.log(`${styling_1.symbols.success} Binary installed successfully`);
+    }
+    async startSession(apiUrl, apiKey, platform, binaryId) {
+        this.log(`${styling_1.symbols.running} Starting ${platform} live session...`);
+        const res = await fetch(`${apiUrl}/live`, {
+            body: JSON.stringify({
+                binaryUploadId: binaryId,
+                platform,
+            }),
+            headers: {
+                'content-type': 'application/json',
+                'x-app-api-key': apiKey,
+            },
+            method: 'POST',
+        });
+        if (!res.ok) {
+            await api_gateway_1.ApiGateway.handleApiError(res, 'Failed to start live session');
+        }
+        const session = (await res.json());
+        const frontendUrl = this.getFrontendUrl(apiUrl);
+        this.log(`${styling_1.symbols.success} Live session started`);
+        this.log(`   ${styling_1.colors.dim('Session ID:')} ${styling_1.colors.highlight(String(session.id))}`);
+        this.log(`   ${styling_1.colors.dim('Platform:')}   ${session.platform}`);
+        this.log(`   ${styling_1.colors.dim('Status:')}     ${session.status}`);
+        this.log(`   ${styling_1.colors.dim('Console:')}    ${styling_1.colors.highlight(`${frontendUrl}/live?session=${session.id}`)}`);
+        this.log('');
+        this.log(`   ${styling_1.colors.dim('Install a binary:')}  ${styling_1.colors.highlight(`dcd live install --session-id ${session.id} --app-binary-id <id>`)}`);
+        this.log(`   ${styling_1.colors.dim('Run a command:')}     ${styling_1.colors.highlight(`dcd live exec --session-id ${session.id} --yaml "- launchApp"`)}`);
+        this.log(`   ${styling_1.colors.dim('Stop session:')}      ${styling_1.colors.highlight(`dcd live stop --session-id ${session.id}`)}`);
+    }
+    async stopSession(apiUrl, apiKey, sessionId) {
+        this.log(`${styling_1.symbols.running} Stopping session ${sessionId}...`);
+        const res = await fetch(`${apiUrl}/live/${sessionId}`, {
+            headers: {
+                'x-app-api-key': apiKey,
+            },
+            method: 'DELETE',
+        });
+        if (!res.ok) {
+            await api_gateway_1.ApiGateway.handleApiError(res, 'Failed to stop session');
+        }
+        this.log(`${styling_1.symbols.success} Session stopped`);
+    }
+}
+exports.default = Live;

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

@@ -49,6 +49,6 @@ exports.deviceFlags = {
     }),
     'disable-animations': core_1.Flags.boolean({
         default: false,
-        description: '[Android only] Disable device animations during test execution. This reduces CPU load and may improve test reliability on resource-constrained runners.',
+        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/services/execution-plan.service.d.ts

@@ -14,6 +14,14 @@ interface IWorkspaceConfig {
     includeTags?: null | string[];
     local?: ILocal | null;
     notifications?: INotificationsConfig;
+    platform?: {
+        android?: {
+            disableAnimations?: boolean;
+        };
+        ios?: {
+            disableAnimations?: boolean;
+        };
+    };
 }
 /** Local execution configuration */
 interface ILocal {

package/dist/services/execution-plan.service.js

@@ -92,9 +92,10 @@ function extractDeviceCloudOverrides(config) {
 /**
  * Generate execution plan for a single flow file
  * @param normalizedInput - Normalized path to the flow file
+ * @param configFile - Optional custom config file path
  * @returns Execution plan for the single file with dependencies
  */
-async function planSingleFile(normalizedInput) {
+async function planSingleFile(normalizedInput, configFile) {
     if (normalizedInput.endsWith('config.yaml') ||
         normalizedInput.endsWith('config.yml')) {
         throw new Error('If using config.yaml, pass the workspace folder path, not the config file or a custom path via --config');
@@ -106,6 +107,14 @@ async function planSingleFile(normalizedInput) {
         flowMetadata[normalizedInput] = config;
         flowOverrides[normalizedInput] = extractDeviceCloudOverrides(config);
     }
+    let workspaceConfig;
+    if (configFile) {
+        const configFilePath = path.resolve(process.cwd(), configFile);
+        if (!fs.existsSync(configFilePath)) {
+            throw new Error(`Config file does not exist: ${configFilePath}`);
+        }
+        workspaceConfig = (0, execution_plan_utils_1.readYamlFileAsJson)(configFilePath);
+    }
     const checkedDependancies = await checkDependencies(normalizedInput);
     return {
         flowMetadata,
@@ -113,6 +122,7 @@ async function planSingleFile(normalizedInput) {
         flowsToRun: [normalizedInput],
         referencedFiles: [...new Set(checkedDependancies)],
         totalFlowFiles: 1,
+        workspaceConfig,
     };
 }
 /**
@@ -211,7 +221,7 @@ async function plan(options) {
         throw new Error(`Flow path does not exist: ${path.resolve(normalizedInput)}`);
     }
     if (fs.lstatSync(normalizedInput).isFile()) {
-        return planSingleFile(normalizedInput);
+        return planSingleFile(normalizedInput, configFile);
     }
     let unfilteredFlowFiles = await (0, execution_plan_utils_1.readDirectory)(normalizedInput, execution_plan_utils_1.isFlowFile);
     if (unfilteredFlowFiles.length === 0) {

package/dist/services/test-submission.service.js

@@ -67,6 +67,11 @@ class TestSubmissionService {
         testFormData.set('env', JSON.stringify(envObject));
         // Note: googlePlay is now included in configPayload below instead of as a separate field
         // to work around a FormData parsing issue in the API
+        const targetPlatform = iOSDevice || iOSVersion ? 'ios' : 'android';
+        const configYamlDisableAnimations = targetPlatform === 'ios'
+            ? Boolean(workspaceConfig?.platform?.ios?.disableAnimations)
+            : Boolean(workspaceConfig?.platform?.android?.disableAnimations);
+        const effectiveDisableAnimations = disableAnimations || configYamlDisableAnimations;
         const configPayload = {
             allExcludeTags,
             allIncludeTags,
@@ -83,7 +88,7 @@ class TestSubmissionService {
             report,
             showCrosshairs,
             maestroChromeOnboarding,
-            disableAnimations,
+            disableAnimations: effectiveDisableAnimations,
             version: cliVersion,
         };
         testFormData.set('config', JSON.stringify(configPayload));

package/oclif.manifest.json

@@ -332,7 +332,7 @@
           "type": "boolean"
         },
         "disable-animations": {
-          "description": "[Android only] Disable device animations during test execution. This reduces CPU load and may improve test reliability on resource-constrained runners.",
+          "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.",
           "name": "disable-animations",
           "allowNo": false,
           "type": "boolean"
@@ -717,6 +717,92 @@
         "list.js"
       ]
     },
+    "live": {
+      "aliases": [],
+      "args": {},
+      "description": "Start and interact with a live device session",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> start",
+        "<%= config.bin %> <%= command.id %> start --platform android --app-binary-id abc-123",
+        "<%= config.bin %> <%= command.id %> install --session-id 42 --app-binary-id abc-123",
+        "<%= config.bin %> <%= command.id %> exec --session-id 42 --yaml \"- launchApp\"",
+        "<%= config.bin %> <%= command.id %> stop --session-id 42",
+        "<%= config.bin %> <%= command.id %> status --session-id 42"
+      ],
+      "flags": {
+        "apiKey": {
+          "aliases": [
+            "api-key"
+          ],
+          "description": "API key for devicecloud.dev (find this in the console UI). You can also set the DEVICE_CLOUD_API_KEY environment variable.",
+          "name": "apiKey",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "apiUrl": {
+          "aliases": [
+            "api-url",
+            "apiURL"
+          ],
+          "description": "API base URL",
+          "hidden": true,
+          "name": "apiUrl",
+          "default": "https://api.devicecloud.dev",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "app-binary-id": {
+          "description": "Binary upload ID to install on the device",
+          "name": "app-binary-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "platform": {
+          "description": "Device platform",
+          "name": "platform",
+          "default": "android",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "android",
+            "ios"
+          ],
+          "type": "option"
+        },
+        "session-id": {
+          "description": "Live session ID (required for install, exec, stop, status)",
+          "name": "session-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yaml": {
+          "description": "Maestro YAML commands to execute (for exec subcommand)",
+          "name": "yaml",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "live",
+      "pluginAlias": "@devicecloud.dev/dcd",
+      "pluginName": "@devicecloud.dev/dcd",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "live.js"
+      ]
+    },
     "status": {
       "aliases": [],
       "args": {},
@@ -880,5 +966,5 @@
       ]
     }
   },
-  "version": "4.4.3"
+  "version": "4.4.4"
 }

package/package.json

@@ -36,7 +36,7 @@
     "eslint-config-oclif-typescript": "^3.1.14",
     "eslint-config-prettier": "^10.1.8",
     "mocha": "^11.7.5",
-    "oclif": "^4.22.87",
+    "oclif": "^4.22.96",
     "shx": "^0.4.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
@@ -69,7 +69,7 @@
     "type": "git",
     "url": "https://devicecloud.dev"
   },
-  "version": "4.4.3",
+  "version": "4.4.4",
   "bugs": {
     "url": "https://discord.gg/gm3mJwcNw8"
   },