@devicecloud.dev/dcd 5.5.0-beta.4 → 5.5.0-beta.5

package/dist/commands/cloud.d.ts

@@ -98,6 +98,11 @@ export declare const cloudCommand: import("citty").CommandDef<{
         readonly type: "string";
         readonly description: "Pull request URL for this run (stored as gh_pr_url metadata)";
     };
+    readonly 'cancel-previous': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Cancel the still-queued tests of the previous run from the same CI context (repo + branch/PR + check name, read from your CI metadata). Tests already running are left to finish; cancelled tests are refunded at 75%. Does nothing outside CI.";
+    };
     readonly config: {
         readonly type: "string";
         readonly description: "Path to custom config.yaml file. If not provided, defaults to config.yaml in root flows folders.";

package/dist/commands/cloud.js

@@ -132,6 +132,7 @@ export const cloudCommand = defineCommand({
             const excludeFlows = coerceArray(collectRepeatedFlag(rawArgs, ['--exclude-flows']));
             const excludeTags = coerceArray(collectRepeatedFlag(rawArgs, ['--exclude-tags']));
             let flows = args.flows;
+            const cancelPrevious = Boolean(args['cancel-previous']);
             const googlePlay = Boolean(args['google-play']);
             const ignoreShaCheck = Boolean(args['ignore-sha-check']);
             // Single opt-in for client-side envelope encryption of every sensitive
@@ -549,6 +550,7 @@ export const cloudCommand = defineCommand({
                 androidNoSnapshot,
                 apiUrl,
                 appBinaryId: finalBinaryId,
+                cancelPrevious,
                 cliVersion,
                 commonRoot,
                 continueOnFailure,

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

@@ -2,6 +2,11 @@
  * Test execution and flow management flags
  */
 export declare const executionFlags: {
+    readonly 'cancel-previous': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Cancel the still-queued tests of the previous run from the same CI context (repo + branch/PR + check name, read from your CI metadata). Tests already running are left to finish; cancelled tests are refunded at 75%. Does nothing outside CI.";
+    };
     readonly config: {
         readonly type: "string";
         readonly description: "Path to custom config.yaml file. If not provided, defaults to config.yaml in root flows folders.";

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

@@ -2,6 +2,11 @@
  * Test execution and flow management flags
  */
 export const executionFlags = {
+    'cancel-previous': {
+        type: 'boolean',
+        default: false,
+        description: 'Cancel the still-queued tests of the previous run from the same CI context (repo + branch/PR + check name, read from your CI metadata). Tests already running are left to finish; cancelled tests are refunded at 75%. Does nothing outside CI.',
+    },
     config: {
         type: 'string',
         description: 'Path to custom config.yaml file. If not provided, defaults to config.yaml in root flows folders.',

package/dist/constants.d.ts

@@ -84,6 +84,11 @@ export declare const flags: {
         readonly type: "string";
         readonly description: "Pull request URL for this run (stored as gh_pr_url metadata)";
     };
+    readonly 'cancel-previous': {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Cancel the still-queued tests of the previous run from the same CI context (repo + branch/PR + check name, read from your CI metadata). Tests already running are left to finish; cancelled tests are refunded at 75%. Does nothing outside CI.";
+    };
     readonly config: {
         readonly type: "string";
         readonly description: "Path to custom config.yaml file. If not provided, defaults to config.yaml in root flows folders.";

package/dist/services/results-polling.service.d.ts

@@ -45,9 +45,21 @@ export declare function deviceFromResultRow(r: {
     config?: unknown;
     simulator_name?: string | null;
 }): TestDevice | undefined;
+/**
+ * Was this row cancelled because a newer run from the same CI context
+ * replaced it (`dcd cloud --cancel-previous`)?
+ *
+ * Read through a structural cast for the same reason deviceFromResultRow
+ * does: the committed generated types are regenerated wholesale from dev's
+ * swagger and lag the API, and this must work against an API that already
+ * sends the field.
+ */
+export declare function isSupersededRow(r: unknown): boolean;
+/** The upload that superseded this run, for the console link. */
+export declare function supersedingUploadId(results: unknown[]): string | undefined;
 export interface PollingResult {
     consoleUrl: string;
-    status: 'FAILED' | 'PASSED';
+    status: 'FAILED' | 'PASSED' | 'SUPERSEDED';
     tests: Array<{
         /** Device this result ran on (present when the API reports it). */
         device?: TestDevice;

package/dist/services/results-polling.service.js

@@ -38,6 +38,31 @@ export function deviceFromResultRow(r) {
         googlePlay: sim ? /(_PLAY|-play)$/.test(sim) : undefined,
     };
 }
+/**
+ * Was this row cancelled because a newer run from the same CI context
+ * replaced it (`dcd cloud --cancel-previous`)?
+ *
+ * Read through a structural cast for the same reason deviceFromResultRow
+ * does: the committed generated types are regenerated wholesale from dev's
+ * swagger and lag the API, and this must work against an API that already
+ * sends the field.
+ */
+export function isSupersededRow(r) {
+    const reason = r
+        ?.cancellation_reason;
+    return typeof reason === 'string' && reason.startsWith('superseded_by:');
+}
+/** The upload that superseded this run, for the console link. */
+export function supersedingUploadId(results) {
+    for (const r of results) {
+        const reason = r
+            ?.cancellation_reason;
+        if (typeof reason === 'string' && reason.startsWith('superseded_by:')) {
+            return reason.slice('superseded_by:'.length) || undefined;
+        }
+    }
+    return undefined;
+}
 /**
  * Service for polling test results from the API
  */
@@ -226,13 +251,23 @@ export class ResultsPollingService {
     }
     buildPollingResult(results, uploadId, consoleUrl, testMetadata) {
         const resultsWithoutEarlierTries = this.filterLatestResults(results);
+        // ANY superseded row settles the whole verdict, even alongside a test
+        // that had genuinely failed before the newer run replaced this one: this
+        // run no longer speaks for the commit, so failing the build on its behalf
+        // is wrong. Actions reaches the same conclusion — a cancelled run's
+        // conclusion is `cancelled`, whatever had already failed inside it. The
+        // failure is still printed and still in `tests[]`; only the exit code
+        // changes.
+        const superseded = resultsWithoutEarlierTries.some(isSupersededRow);
         return {
             consoleUrl,
             // Anything other than an explicit pass (CANCELLED, ERROR, a status we
             // don't know about yet) must fail the run — this gates CI exit codes.
-            status: resultsWithoutEarlierTries.every((result) => result.status === 'PASSED')
-                ? 'PASSED'
-                : 'FAILED',
+            status: superseded
+                ? 'SUPERSEDED'
+                : resultsWithoutEarlierTries.every((result) => result.status === 'PASSED')
+                    ? 'PASSED'
+                    : 'FAILED',
             tests: resultsWithoutEarlierTries.map((r) => ({
                 // r carries config/simulator_name at runtime; the committed generated
                 // types lag the API (regenerated wholesale from dev's swagger), so read
@@ -259,8 +294,12 @@ export class ResultsPollingService {
         const pending = statusCounts.PENDING || 0;
         const queued = statusCounts.QUEUED || 0;
         const running = statusCounts.RUNNING || 0;
+        // CANCELLED is terminal, so it counts as completed. Without it a
+        // cancelled or superseded run's footer sticks at "8/12 completed"
+        // forever, having already stopped polling.
+        const cancelled = statusCounts.CANCELLED || 0;
         const total = results.length;
-        const completed = passed + failed;
+        const completed = passed + failed + cancelled;
         const summary = formatTestSummary({
             completed,
             failed,
@@ -386,6 +425,27 @@ export class ResultsPollingService {
         }
         this.displayFinalResults(updatedResults, consoleUrl, json, logger);
         const output = this.buildPollingResult(updatedResults, uploadId, consoleUrl, testMetadata);
+        if (output.status === 'SUPERSEDED') {
+            // Exit 0: a newer run of the same CI context replaced this one, so
+            // failing the build here would fail it for work nobody is waiting on.
+            // Falls through to the success return below — RunFailedError, and with
+            // it the exit code 2 in `dcd cloud`, is never reached.
+            if (logger && !json) {
+                const newer = supersedingUploadId(updatedResults);
+                logger('\n');
+                logger(ui.warn('Run superseded by a newer run from the same CI context — exiting 0'));
+                if (newer) {
+                    logger(ui.branch(ui.fields([
+                        [
+                            'superseded by',
+                            colors.url(consoleUrl.replace(uploadId, newer)),
+                        ],
+                    ])));
+                }
+                logger('\n');
+            }
+            return output;
+        }
         if (output.status === 'FAILED') {
             if (debug && logger) {
                 logger(`[DEBUG] Some tests failed, returning failed status`);

package/dist/services/test-submission.service.d.ts

@@ -6,6 +6,13 @@ export interface TestSubmissionConfig {
     androidNoSnapshot?: boolean;
     apiUrl?: string;
     appBinaryId: string;
+    /**
+     * Ask the API to cancel the still-queued tests of the previous run from
+     * the same CI context. Sent as its own field rather than inside `config`,
+     * which is stamped onto every result row and shipped to the runner — this
+     * is a one-off submission directive, not run configuration.
+     */
+    cancelPrevious?: boolean;
     cliVersion: string;
     commonRoot: string;
     continueOnFailure?: boolean;

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

@@ -20,7 +20,7 @@ export class TestSubmissionService {
      * @returns The flow zip buffer, its SHA-256, and the string-encoded fields
      */
     async buildTestPayload(config) {
-        const { apiUrl, appBinaryId, encrypt = false, flowFile, executionPlan, commonRoot, cliVersion, env = [], metadata = [], googlePlay = false, androidApiLevel, androidDevice, androidNoSnapshot, iOSVersion, iOSDevice, name, runnerType, maestroVersion, deviceLocale, orientation, retry, continueOnFailure = true, renderEngine, report, showCrosshairs, maestroChromeOnboarding, raw, disableAnimations, deviceMatrix, debug = false, logger, } = config;
+        const { apiUrl, appBinaryId, encrypt = false, flowFile, executionPlan, commonRoot, cliVersion, env = [], metadata = [], cancelPrevious = false, googlePlay = false, androidApiLevel, androidDevice, androidNoSnapshot, iOSVersion, iOSDevice, name, runnerType, maestroVersion, deviceLocale, orientation, retry, continueOnFailure = true, renderEngine, report, showCrosshairs, maestroChromeOnboarding, raw, disableAnimations, deviceMatrix, debug = false, logger, } = config;
         const { allExcludeTags, allIncludeTags, flowMetadata, flowOverrides, flowsToRun: testFileNames, referencedFiles, sequence, workspaceConfig, } = executionPlan;
         const { flows: sequentialFlows = [] } = sequence ?? {};
         const envObject = this.parseKeyValuePairs(env);
@@ -144,6 +144,11 @@ export class TestSubmissionService {
             fields.metadata = JSON.stringify(metadataPayload);
             this.logDebug(debug, logger, `[DEBUG] Sending metadata to API: ${JSON.stringify(metadataPayload)}`);
         }
+        // Only sent when asked for, so every other submission's wire shape is
+        // unchanged and the flag is simply ignored by an older API.
+        if (cancelPrevious) {
+            fields.cancelPrevious = 'true';
+        }
         this.setOptionalFields(fields, {
             androidApiLevel,
             androidDevice,

package/package.json

@@ -59,7 +59,7 @@
     "type": "git",
     "url": "https://devicecloud.dev"
   },
-  "version": "5.5.0-beta.4",
+  "version": "5.5.0-beta.5",
   "bugs": {
     "url": "https://discord.gg/gm3mJwcNw8"
   },