Add cancel-previous input

README.md

@@ -67,6 +67,30 @@ the failing iOS run should have held. Keep the value fixed for a given job:
 GitHub matches required checks by name, so a name that changes per commit can
 never be required.
 
+## Cancelling superseded runs
+
+Push twice in quick succession and the first run's queued tests are dead
+weight. `cancel-previous` cancels them when the newer run is submitted:
+
+```yaml
+- uses: devicecloud-dev/device-cloud-for-maestro@v2
+  with:
+    api-key: ${{ secrets.DCD_API_KEY }}
+    app-file: build/app.apk
+    cancel-previous: true
+    check-name: Android
+```
+
+The previous run is matched on repo + branch (or PR number) + `check-name`, so
+set `check-name` per job whenever one commit runs this action more than once —
+without it the iOS job would cancel the Android job's queued tests. Runs from
+the same workflow run never cancel each other.
+
+Only queued tests are cancelled: anything already running on a device finishes
+and reports normally. Cancelled tests are refunded at 75%. The superseded run
+exits 0 rather than failing your build, sends no completion email or webhook,
+and its GitHub check is closed as skipped so it cannot block a PR.
+
 ## Migrating from Maestro Cloud
 
 Replace the `uses` line in your workflow:

action.yml

@@ -23,6 +23,9 @@ inputs:
   async:
     description: 'Immediately return (exit code 0) from the command without waiting for the results of the run (useful for saving CI minutes)'
     required: false
+  cancel-previous:
+    description: 'Cancel the still-queued tests of the previous run of this job on the same branch or PR. Tests already running are left to finish; cancelled tests are refunded at 75%. Set check-name per job when one commit runs this action more than once, since it scopes the group'
+    required: false
   device-locale:
     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'
     required: false

src/index.ts

@@ -129,6 +129,7 @@ const run = async (): Promise<void> => {
       appBinaryId,
       appFilePath,
       async,
+      cancelPrevious,
       config,
       deviceLocale,
       downloadArtifacts,
@@ -177,6 +178,7 @@ const run = async (): Promise<void> => {
       'app-binary-id': appBinaryId,
       'app-file': appFilePath,
       async,
+      'cancel-previous': cancelPrevious,
       config,
       'device-locale': deviceLocale,
       'download-artifacts': downloadArtifacts,

src/methods/params.test.ts

@@ -97,15 +97,21 @@ describe('getParameters', () => {
   it('maps boolean inputs from the string "true"', async () => {
     inputs['async'] = 'true';
     inputs['google-play'] = 'true';
+    inputs['cancel-previous'] = 'true';
     inputs['debug'] = 'true';
     let params = await getParameters();
     expect(params.async).toBe(true);
     expect(params.googlePlay).toBe(true);
+    expect(params.cancelPrevious).toBe(true);
     expect(params.debug).toBe(true);
 
     inputs['async'] = 'false';
+    inputs['cancel-previous'] = '';
     params = await getParameters();
     expect(params.async).toBe(false);
+    // Unset means off: the falsy-dropping reducer in index.ts then omits
+    // the flag entirely, so an opted-out run's command line is unchanged.
+    expect(params.cancelPrevious).toBe(false);
   });
 
   it('normalises empty device inputs to null', async () => {

src/methods/params.ts

@@ -16,6 +16,7 @@ export type Params = {
   androidDevice: string | null;
   excludeFlows: string;
   googlePlay: boolean;
+  cancelPrevious: boolean;
   iosDevice: string | null;
   name?: string;
   deviceLocale?: string;
@@ -187,6 +188,8 @@ export async function getParameters(): Promise<Params> {
   const excludeFlows = core.getInput('exclude-flows', { required: false });
   const googlePlay =
     core.getInput('google-play', { required: false }) === 'true';
+  const cancelPrevious =
+    core.getInput('cancel-previous', { required: false }) === 'true';
 
   const deviceLocale = core.getInput('device-locale', { required: false });
   const downloadArtifacts = parseDownloadArtifacts(
@@ -266,6 +269,7 @@ export async function getParameters(): Promise<Params> {
     iosDevice,
     excludeFlows,
     googlePlay,
+    cancelPrevious,
     deviceLocale,
     downloadArtifacts,
     maestroVersion,