@testomatio/reporter 2.11.0 → 2.12.0

package/lib/bin/cli.js

@@ -84,6 +84,10 @@ program
         log_js_1.log.error(picocolors_1.default.red('Failed to create run on Testomat.io.'));
         process.exit(1);
     }
+    // tests are executed later, so report the run as pending with the tests it was scoped to:
+    // pipes add their report now and replace it when the run is finished
+    const plannedTests = (client.pipeStore.preparedTestIds || []).map(id => ({ test_id: id, title: id }));
+    await client.updateRunStatus('pending', { tests: plannedTests });
     // stdout carries ONLY the run id so it can be captured: RUN_ID=$(reporter start)
     console.log(runId);
     process.exit(0);

package/lib/client.d.ts

@@ -64,11 +64,11 @@ export class Client {
     /**
      *
      * Updates the status of the current test run and finishes the run.
-     * @param {'passed' | 'failed' | 'skipped' | 'finished'} status - The status of the current test run.
+     * @param {'passed' | 'failed' | 'skipped' | 'finished' | 'pending'} status - The status of the current test run.
      * @param {Partial<import('../types/types.js').RunData>} [params] - Additional run params (e.g. duration).
      * Must be one of "passed", "failed", or "finished"
      * @returns {Promise<any>} - A Promise that resolves when finishes the run.
      */
-    updateRunStatus(status: "passed" | "failed" | "skipped" | "finished", params?: Partial<import("../types/types.js").RunData>): Promise<any>;
+    updateRunStatus(status: "passed" | "failed" | "skipped" | "finished" | "pending", params?: Partial<import("../types/types.js").RunData>): Promise<any>;
 }
 import { S3Uploader } from './uploader.js';

package/lib/client.js

@@ -319,7 +319,7 @@ class Client {
     /**
      *
      * Updates the status of the current test run and finishes the run.
-     * @param {'passed' | 'failed' | 'skipped' | 'finished'} status - The status of the current test run.
+     * @param {'passed' | 'failed' | 'skipped' | 'finished' | 'pending'} status - The status of the current test run.
      * @param {Partial<import('../types/types.js').RunData>} [params] - Additional run params (e.g. duration).
      * Must be one of "passed", "failed", or "finished"
      * @returns {Promise<any>} - A Promise that resolves when finishes the run.

package/lib/pipe/html.js

@@ -216,7 +216,7 @@ class HtmlPipe {
             runUrl: this.store.runUrl || '',
             executionTime: testExecutionSumTime(aggregatedTests),
             executionDate: getCurrentDateTimeFormatted(),
-            description: [runParams.description || this.store.coverageDescription || this.store.description, this.description]
+            description: [this.description, runParams.description || this.store.coverageDescription || this.store.description]
                 .filter(Boolean)
                 .join('\n\n') || '',
             configuration: buildDisplayConfiguration(this.configuration || this.store.configuration || runParams.configuration || null),

package/lib/pipe/markdown.js

@@ -117,7 +117,7 @@ class MarkdownPipe {
             isParallel: runParams?.isParallel,
             executionTime: testExecutionSumTime(aggregated),
             executionDate: getCurrentDateTimeFormatted(),
-            description: [runParams?.description || this.store.coverageDescription || this.store.description, this.description]
+            description: [this.description, runParams?.description || this.store.coverageDescription || this.store.description]
                 .filter(Boolean)
                 .join('\n\n') || '',
             configuration: this.configuration || this.store.configuration || runParams?.configuration || null,

package/lib/pipe/testomatio.js

@@ -247,8 +247,9 @@ class TestomatioPipe {
                 suites: coverageConfiguration.suites?.map(id => id.replace(/^S/, '')) || [],
             };
         }
-        // Run description: coverage-derived block (if any) with the user-provided TESTOMATIO_DESCRIPTION appended after it.
-        const description = [coverageDescription, this.description].filter(Boolean).join('\n\n') || null;
+        // Run description: the user-provided TESTOMATIO_DESCRIPTION with the coverage-derived block
+        // (if any) added after it. Neither overrides the other.
+        const description = [this.description, coverageDescription].filter(Boolean).join('\n\n') || null;
         // Merge caller-supplied configuration (e.g. { exploratory: true }) into runParams.configuration.
         // Caller values win on key conflict; coverage-derived tests/suites lists are preserved when not overridden.
         if (params.configuration && typeof params.configuration === 'object') {
@@ -511,6 +512,9 @@ class TestomatioPipe {
             console.warn(`${constants_js_1.APP_PREFIX} ${errorMessage}`);
         }
         const { status } = params;
+        // a pending run was just created: nothing to update here, only other pipes report it
+        if (status === 'pending')
+            return;
         let status_event;
         if (status === constants_js_1.STATUS.FINISHED)
             status_event = 'finish';

package/lib/utils/pipe_utils.js

@@ -121,6 +121,8 @@ function statusEmoji(status) {
         return '🔴';
     if (status === 'skipped')
         return '🟡';
+    if (status === 'pending')
+        return '🕐';
     return '';
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testomatio/reporter",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "Testomatio Reporter Client",
   "engines": {
     "node": ">=18"

package/src/bin/cli.js

@@ -87,6 +87,11 @@ program
       process.exit(1);
     }
 
+    // tests are executed later, so report the run as pending with the tests it was scoped to:
+    // pipes add their report now and replace it when the run is finished
+    const plannedTests = (client.pipeStore.preparedTestIds || []).map(id => ({ test_id: id, title: id }));
+    await client.updateRunStatus('pending', { tests: plannedTests });
+
     // stdout carries ONLY the run id so it can be captured: RUN_ID=$(reporter start)
     console.log(runId);
     process.exit(0);

package/src/client.js

@@ -371,7 +371,7 @@ class Client {
   /**
    *
    * Updates the status of the current test run and finishes the run.
-   * @param {'passed' | 'failed' | 'skipped' | 'finished'} status - The status of the current test run.
+   * @param {'passed' | 'failed' | 'skipped' | 'finished' | 'pending'} status - The status of the current test run.
    * @param {Partial<import('../types/types.js').RunData>} [params] - Additional run params (e.g. duration).
    * Must be one of "passed", "failed", or "finished"
    * @returns {Promise<any>} - A Promise that resolves when finishes the run.

package/src/pipe/html.js

@@ -268,7 +268,7 @@ class HtmlPipe {
       executionTime: testExecutionSumTime(aggregatedTests),
       executionDate: getCurrentDateTimeFormatted(),
       description:
-        [runParams.description || this.store.coverageDescription || this.store.description, this.description]
+        [this.description, runParams.description || this.store.coverageDescription || this.store.description]
           .filter(Boolean)
           .join('\n\n') || '',
       configuration: buildDisplayConfiguration(

package/src/pipe/markdown.js

@@ -140,7 +140,7 @@ class MarkdownPipe {
       executionTime: testExecutionSumTime(aggregated),
       executionDate: getCurrentDateTimeFormatted(),
       description:
-        [runParams?.description || this.store.coverageDescription || this.store.description, this.description]
+        [this.description, runParams?.description || this.store.coverageDescription || this.store.description]
           .filter(Boolean)
           .join('\n\n') || '',
       configuration: this.configuration || this.store.configuration || runParams?.configuration || null,

package/src/pipe/testomatio.js

@@ -279,8 +279,9 @@ class TestomatioPipe {
         suites: coverageConfiguration.suites?.map(id => id.replace(/^S/, '')) || [],
       };
     }
-    // Run description: coverage-derived block (if any) with the user-provided TESTOMATIO_DESCRIPTION appended after it.
-    const description = [coverageDescription, this.description].filter(Boolean).join('\n\n') || null;
+    // Run description: the user-provided TESTOMATIO_DESCRIPTION with the coverage-derived block
+    // (if any) added after it. Neither overrides the other.
+    const description = [this.description, coverageDescription].filter(Boolean).join('\n\n') || null;
 
     // Merge caller-supplied configuration (e.g. { exploratory: true }) into runParams.configuration.
     // Caller values win on key conflict; coverage-derived tests/suites lists are preserved when not overridden.
@@ -558,6 +559,9 @@ class TestomatioPipe {
 
     const { status } = params;
 
+    // a pending run was just created: nothing to update here, only other pipes report it
+    if (status === 'pending') return;
+
     let status_event;
 
     if (status === STATUS.FINISHED) status_event = 'finish';

package/src/utils/pipe_utils.js

@@ -117,6 +117,7 @@ function statusEmoji(status) {
   if (status === 'passed') return '🟢';
   if (status === 'failed') return '🔴';
   if (status === 'skipped') return '🟡';
+  if (status === 'pending') return '🕐';
   return '';
 }
 

package/types/types.d.ts

@@ -289,6 +289,8 @@ export enum RunStatus {
   Passed = 'passed',
   Failed = 'failed',
   Finished = 'finished',
+  /** run created but not executed yet, reported by `reporter start` */
+  Pending = 'pending',
 }
 
 /** Batch upload strategy: