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

package/dist/config/flags/environment.flags.js

@@ -1,37 +1,32 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.environmentFlags = void 0;
-const core_1 = require("@oclif/core");
 /**
  * Environment configuration and metadata flags
  */
-exports.environmentFlags = {
-    env: core_1.Flags.file({
-        char: 'e',
-        description: 'One or more environment variables to inject into your flows',
-        multiple: true,
-        multipleNonGreedy: true,
-    }),
-    metadata: core_1.Flags.string({
-        char: 'm',
-        description: 'Arbitrary key-value metadata to include with your test run (format: key=value)',
-        multiple: true,
-        multipleNonGreedy: true,
-    }),
-    mitmHost: core_1.Flags.string({
+export const environmentFlags = {
+    env: {
+        type: 'string',
+        alias: ['e'],
+        description: 'One or more environment variables to inject into your flows (format: KEY=VALUE, may be repeated)',
+        valueHint: 'KEY=VALUE',
+    },
+    metadata: {
+        type: 'string',
+        alias: ['m'],
+        description: 'Arbitrary key-value metadata to include with your test run (format: key=value, may be repeated)',
+    },
+    mitmHost: {
+        type: 'string',
         description: 'used for mitmproxy support, enterprise only, contact support if interested',
-        hidden: true,
-    }),
-    mitmPath: core_1.Flags.string({
-        dependsOn: ['mitmHost'],
+    },
+    mitmPath: {
+        type: 'string',
         description: 'used for mitmproxy support, enterprise only, contact support if interested',
-        hidden: true,
-    }),
-    'moropo-v1-api-key': core_1.Flags.string({
+    },
+    'moropo-v1-api-key': {
+        type: 'string',
         description: 'API key for Moropo v1 integration',
-        required: false,
-    }),
-    name: core_1.Flags.string({
+    },
+    name: {
+        type: 'string',
         description: 'A custom name for your upload (useful for tagging commits etc)',
-    }),
+    },
 };

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

@@ -2,12 +2,39 @@
  * Test execution and flow management flags
  */
 export declare const executionFlags: {
-    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>;
+    readonly 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";
+    };
+    readonly 'exclude-flows': {
+        readonly type: "string";
+        readonly description: "Sub directories to ignore when building the flow file list (comma-separated, may be repeated)";
+    };
+    readonly 'exclude-tags': {
+        readonly type: "string";
+        readonly description: "Flows which have these tags will be excluded from the run (comma-separated, may be repeated)";
+    };
+    readonly flows: {
+        readonly type: "string";
+        readonly description: "The path to the flow file or folder containing your flows";
+    };
+    readonly 'include-tags': {
+        readonly type: "string";
+        readonly description: "Only flows which have these tags will be included in the run (comma-separated, may be repeated)";
+    };
+    readonly '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.";
+    };
+    readonly 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";
+    };
+    readonly '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.";
+    };
 };

package/dist/config/flags/execution.flags.js

@@ -1,50 +1,40 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.executionFlags = void 0;
-const core_1 = require("@oclif/core");
 /**
  * Test execution and flow management flags
  */
-exports.executionFlags = {
-    config: core_1.Flags.file({
+export const executionFlags = {
+    config: {
+        type: 'string',
         description: 'Path to custom config.yaml file. If not provided, defaults to config.yaml in root flows folders.',
-    }),
-    'exclude-flows': core_1.Flags.string({
-        default: [],
-        description: 'Sub directories to ignore when building the flow file list',
-        multiple: true,
-        multipleNonGreedy: true,
-        parse: (input) => input.split(','),
-    }),
-    'exclude-tags': core_1.Flags.string({
-        aliases: ['exclude-tags'],
-        default: [],
-        description: 'Flows which have these tags will be excluded from the run',
-        multiple: true,
-        multipleNonGreedy: true,
-        parse: (input) => input.split(','),
-    }),
-    flows: core_1.Flags.string({
+        valueHint: 'path',
+    },
+    'exclude-flows': {
+        type: 'string',
+        description: 'Sub directories to ignore when building the flow file list (comma-separated, may be repeated)',
+    },
+    'exclude-tags': {
+        type: 'string',
+        description: 'Flows which have these tags will be excluded from the run (comma-separated, may be repeated)',
+    },
+    flows: {
+        type: 'string',
         description: 'The path to the flow file or folder containing your flows',
-    }),
-    'include-tags': core_1.Flags.string({
-        aliases: ['include-tags'],
-        default: [],
-        description: 'Only flows which have these tags will be included in the run',
-        multiple: true,
-        multipleNonGreedy: true,
-        parse: (input) => input.split(','),
-    }),
-    'maestro-version': core_1.Flags.string({
-        aliases: ['maestroVersion'],
+    },
+    'include-tags': {
+        type: 'string',
+        description: 'Only flows which have these tags will be included in the run (comma-separated, may be repeated)',
+    },
+    'maestro-version': {
+        type: 'string',
+        alias: ['maestroVersion'],
         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: core_1.Flags.integer({
+    },
+    retry: {
+        type: 'string',
         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': core_1.Flags.string({
+    },
+    'runner-type': {
+        type: 'string',
         default: 'default',
-        description: '[experimental] The type of runner to use - note: anything other than default or cpu1 will incur premium pricing tiers, see https://docs.devicecloud.dev/configuration/runner-type for more information.',
-        options: ['default', 'm4', 'm1', 'gpu1', 'cpu1'],
-    }),
+        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.',
+    },
 };

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

@@ -1,7 +1,25 @@
+/**
+ * GitHub context flags — stored as gh_* metadata alongside the run
+ */
 export declare const githubFlags: {
-    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>;
+    readonly branch: {
+        readonly type: "string";
+        readonly description: "Git branch name for this run (stored as gh_branch metadata)";
+    };
+    readonly 'commit-sha': {
+        readonly type: "string";
+        readonly description: "Git commit SHA for this run (stored as gh_sha metadata)";
+    };
+    readonly 'repo-name': {
+        readonly type: "string";
+        readonly description: "Repository in owner/repo format (stored as gh_repo metadata, e.g. \"acme/my-app\")";
+    };
+    readonly 'pr-number': {
+        readonly type: "string";
+        readonly description: "Pull request number for this run (stored as gh_pr_number metadata)";
+    };
+    readonly 'pr-url': {
+        readonly type: "string";
+        readonly description: "Pull request URL for this run (stored as gh_pr_url metadata)";
+    };
 };

package/dist/config/flags/github.flags.js

@@ -1,21 +1,25 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.githubFlags = void 0;
-const core_1 = require("@oclif/core");
-exports.githubFlags = {
-    branch: core_1.Flags.string({
+/**
+ * GitHub context flags — stored as gh_* metadata alongside the run
+ */
+export const githubFlags = {
+    branch: {
+        type: 'string',
         description: 'Git branch name for this run (stored as gh_branch metadata)',
-    }),
-    'commit-sha': core_1.Flags.string({
+    },
+    'commit-sha': {
+        type: 'string',
         description: 'Git commit SHA for this run (stored as gh_sha metadata)',
-    }),
-    'repo-name': core_1.Flags.string({
+    },
+    'repo-name': {
+        type: 'string',
         description: 'Repository in owner/repo format (stored as gh_repo metadata, e.g. "acme/my-app")',
-    }),
-    'pr-number': core_1.Flags.string({
+    },
+    'pr-number': {
+        type: 'string',
         description: 'Pull request number for this run (stored as gh_pr_number metadata)',
-    }),
-    'pr-url': core_1.Flags.string({
+    },
+    'pr-url': {
+        type: 'string',
         description: 'Pull request URL for this run (stored as gh_pr_url metadata)',
-    }),
+    },
 };

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

@@ -2,17 +2,61 @@
  * Output format and artifact download flags
  */
 export declare const outputFlags: {
-    '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>;
+    readonly 'artifacts-path': {
+        readonly type: "string";
+        readonly description: "Custom file path for downloaded artifacts (default: ./artifacts.zip). Requires --download-artifacts.";
+    };
+    readonly 'junit-path': {
+        readonly type: "string";
+        readonly description: "Custom file path for downloaded JUnit report (requires --report junit, default: ./report.xml)";
+    };
+    readonly 'allure-path': {
+        readonly type: "string";
+        readonly description: "Custom file path for downloaded Allure report (requires --report allure, default: ./report.html)";
+    };
+    readonly 'html-path': {
+        readonly type: "string";
+        readonly description: "Custom file path for downloaded HTML report (requires --report html, default: ./report.html)";
+    };
+    readonly 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)";
+    };
+    readonly debug: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Enable detailed debug logging for troubleshooting issues";
+    };
+    readonly '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)";
+    };
+    readonly 'dry-run': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Simulate the run without actually triggering the upload/test, useful for debugging workflow issues.";
+    };
+    readonly 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";
+    };
+    readonly '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)";
+    };
+    readonly 'json-file-name': {
+        readonly type: "string";
+        readonly description: "A custom name for the JSON file (can also include relative path). Requires --json-file.";
+    };
+    readonly quiet: {
+        readonly type: "boolean";
+        readonly alias: ["q"];
+        readonly default: false;
+        readonly description: "Quieter console output that won't provide progress updates";
+    };
+    readonly 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.";
+    };
 };

package/dist/config/flags/output.flags.js

@@ -1,61 +1,62 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.outputFlags = void 0;
-const core_1 = require("@oclif/core");
 /**
  * Output format and artifact download flags
  */
-exports.outputFlags = {
-    'artifacts-path': core_1.Flags.string({
-        dependsOn: ['download-artifacts'],
-        description: 'Custom file path for downloaded artifacts (default: ./artifacts.zip)',
-    }),
-    'junit-path': core_1.Flags.string({
-        dependsOn: ['report'],
+export const outputFlags = {
+    'artifacts-path': {
+        type: 'string',
+        description: 'Custom file path for downloaded artifacts (default: ./artifacts.zip). Requires --download-artifacts.',
+    },
+    'junit-path': {
+        type: 'string',
         description: 'Custom file path for downloaded JUnit report (requires --report junit, default: ./report.xml)',
-    }),
-    'allure-path': core_1.Flags.string({
-        dependsOn: ['report'],
+    },
+    'allure-path': {
+        type: 'string',
         description: 'Custom file path for downloaded Allure report (requires --report allure, default: ./report.html)',
-    }),
-    'html-path': core_1.Flags.string({
-        dependsOn: ['report'],
+    },
+    'html-path': {
+        type: 'string',
         description: 'Custom file path for downloaded HTML report (requires --report html, default: ./report.html)',
-    }),
-    async: core_1.Flags.boolean({
+    },
+    async: {
+        type: 'boolean',
         description: 'Immediately return (exit code 0) from the command without waiting for the results of the run (useful for saving CI minutes)',
-    }),
-    debug: core_1.Flags.boolean({
+    },
+    debug: {
+        type: 'boolean',
         default: false,
         description: 'Enable detailed debug logging for troubleshooting issues',
-    }),
-    'download-artifacts': core_1.Flags.string({
-        description: 'Download a zip containing the logs, screenshots and videos for each result in this run. Options: ALL (everything), FAILED (failures only).',
-        options: ['ALL', 'FAILED'],
-    }),
-    'dry-run': core_1.Flags.boolean({
+    },
+    'download-artifacts': {
+        type: 'string',
+        description: 'Download a zip containing the logs, screenshots and videos for each result in this run (options: ALL, FAILED)',
+    },
+    'dry-run': {
+        type: 'boolean',
         default: false,
         description: 'Simulate the run without actually triggering the upload/test, useful for debugging workflow issues.',
-    }),
-    json: core_1.Flags.boolean({
-        description: 'Output results in JSON format - note: will always provide exit code 0',
-    }),
-    'json-file': core_1.Flags.boolean({
-        description: 'Write JSON output to a file. File will be called <upload_id>_dcd.json unless you supply the --json-file-name flag - note: will always exit with code 0',
-        required: false,
-    }),
-    'json-file-name': core_1.Flags.string({
-        description: 'A custom name for the JSON file (can also include relative path)',
-        dependsOn: ['json-file'],
-    }),
-    quiet: core_1.Flags.boolean({
-        char: 'q',
+    },
+    json: {
+        type: 'boolean',
+        description: 'Output results in JSON format. Exit codes: 0 on success, 2 if the test run fails, 1 on CLI/infrastructure errors',
+    },
+    'json-file': {
+        type: 'boolean',
+        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': {
+        type: 'string',
+        description: 'A custom name for the JSON file (can also include relative path). Requires --json-file.',
+    },
+    quiet: {
+        type: 'boolean',
+        alias: ['q'],
         default: false,
         description: "Quieter console output that won't provide progress updates",
-    }),
-    report: core_1.Flags.string({
-        aliases: ['format'],
-        description: 'Generate and download test reports in the specified format. Use "allure" for a complete HTML report.',
-        options: ['allure', 'junit', 'html', 'html-detailed'],
-    }),
+    },
+    report: {
+        type: 'string',
+        alias: ['format'],
+        description: 'Generate and download test reports in the specified format (options: allure, junit, html, html-detailed). Use "allure" for a complete HTML report.',
+    },
 };