@testomatio/reporter 2.8.5 → 2.9.0

package/lib/adapter/codecept.js

@@ -43,6 +43,7 @@ if (MAJOR_VERSION === 3 && MINOR_VERSION < 7) {
 }
 function CodeceptReporter(config) {
     const failedTests = [];
+    const reportedTestUids = new Set();
     let videos = [];
     let traces = [];
     const reportTestPromises = [];
@@ -141,6 +142,7 @@ function CodeceptReporter(config) {
             return;
         const error = hook?.ctx?.currentTest?.err;
         for (const test of suite.tests) {
+            reportedTestUids.add(test.uid);
             const reportTestPromise = client.addTestRun('failed', {
                 ...stripExampleFromTitle(test.title),
                 rid: test.uid,
@@ -171,9 +173,26 @@ function CodeceptReporter(config) {
             await finalizeRun('all.after');
         });
     });
+    event.dispatcher.on(event.test.skipped, test => {
+        const { uid, tags, title } = test.simplify();
+        if (uid && reportedTestUids.has(uid))
+            return;
+        index_js_1.services.setContext(null);
+        const reportTestPromise = client.addTestRun(constants_js_1.STATUS.SKIPPED, {
+            ...stripExampleFromTitle(title),
+            rid: uid,
+            test_id: (0, utils_js_1.getTestomatIdFromTestTitle)(`${title} ${tags?.join(' ')}`),
+            suite_title: test.parent && stripTagsFromTitle(stripExampleFromTitle(test.parent.title).title),
+            time: test.duration,
+            meta: test.meta,
+        });
+        reportTestPromises.push(reportTestPromise);
+        reportedTestUids.add(uid);
+    });
     event.dispatcher.on(event.test.after, test => {
         const { uid, tags, title, artifacts } = test.simplify();
         const error = test.err || null;
+        reportedTestUids.add(uid);
         failedTests.push(uid || title);
         const testObj = getTestAndMessage(title);
         const files = buildArtifactFiles(artifacts);

package/lib/bin/cli.js

@@ -333,7 +333,7 @@ program
     const client = new client_js_1.default({
         apiKey,
         runId,
-        isBatchEnabled: false,
+        batchMode: constants_js_1.BATCH_MODE.DISABLED,
     });
     let testruns = client.uploader.readUploadedFiles(runId);
     const numTotalArtifacts = testruns.length;

package/lib/bin/uploadArtifacts.js

@@ -13,6 +13,7 @@ const config_js_1 = require("../config.js");
 const utils_js_2 = require("../utils/utils.js");
 const dotenv_1 = __importDefault(require("dotenv"));
 const log_js_1 = require("../utils/log.js");
+const constants_js_1 = require("../constants.js");
 const debug = (0, debug_1.default)('@testomatio/reporter:upload-cli');
 const version = (0, utils_js_1.getPackageVersion)();
 console.log(picocolors_1.default.cyan(picocolors_1.default.bold(` 🤩 Testomat.io Reporter v${version}`)));
@@ -37,7 +38,7 @@ program
     const client = new client_js_1.default({
         apiKey,
         runId,
-        isBatchEnabled: false,
+        batchMode: constants_js_1.BATCH_MODE.DISABLED,
     });
     let testruns = client.uploader.readUploadedFiles(process.env.TESTOMATIO_RUN);
     const numTotalArtifacts = testruns.length;

package/lib/constants.d.ts

@@ -10,6 +10,12 @@ export namespace STATUS {
     let SKIPPED: string;
     let FINISHED: string;
 }
+/** @type {{ AUTO: 'auto', MANUAL: 'manual', DISABLED: 'disabled' }} */
+export const BATCH_MODE: {
+    AUTO: "auto";
+    MANUAL: "manual";
+    DISABLED: "disabled";
+};
 export namespace HTML_REPORT {
     let FOLDER: string;
     let REPORT_DEFAULT_NAME: string;

package/lib/constants.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEBUG_FILE = exports.SCREENSHOTS_ON_STEPS = exports.REPORTER_REQUEST_RETRIES = exports.testomatLogoURL = exports.REQUEST_TIMEOUT = exports.MARKDOWN_REPORT = exports.HTML_REPORT = exports.STATUS = exports.CSV_HEADERS = exports.TESTOMAT_TMP_STORAGE_DIR = exports.APP_PREFIX = void 0;
+exports.DEBUG_FILE = exports.SCREENSHOTS_ON_STEPS = exports.REPORTER_REQUEST_RETRIES = exports.testomatLogoURL = exports.REQUEST_TIMEOUT = exports.MARKDOWN_REPORT = exports.HTML_REPORT = exports.BATCH_MODE = exports.STATUS = exports.CSV_HEADERS = exports.TESTOMAT_TMP_STORAGE_DIR = exports.APP_PREFIX = void 0;
 exports.getCreateRunRequestTimeout = getCreateRunRequestTimeout;
 const picocolors_1 = __importDefault(require("picocolors"));
 const os_1 = __importDefault(require("os"));
@@ -37,6 +37,14 @@ const STATUS = {
     FINISHED: 'finished',
 };
 exports.STATUS = STATUS;
+// batch upload mode
+/** @type {{ AUTO: 'auto', MANUAL: 'manual', DISABLED: 'disabled' }} */
+const BATCH_MODE = {
+    AUTO: 'auto',
+    MANUAL: 'manual',
+    DISABLED: 'disabled',
+};
+exports.BATCH_MODE = BATCH_MODE;
 // html pipe var
 const HTML_REPORT = {
     FOLDER: 'html-report',
@@ -79,6 +87,8 @@ module.exports.CSV_HEADERS = CSV_HEADERS;
 
 module.exports.STATUS = STATUS;
 
+module.exports.BATCH_MODE = BATCH_MODE;
+
 module.exports.HTML_REPORT = HTML_REPORT;
 
 module.exports.MARKDOWN_REPORT = MARKDOWN_REPORT;

package/lib/pipe/coverage.js

@@ -221,9 +221,10 @@ class CoveragePipe {
      */
     #getChangedFilesFromGit(cmd) {
         try {
+            // Capture stderr (instead of ignoring it) so Git's actual error is available for diagnostics
             const result = (0, child_process_1.execSync)(cmd, {
                 encoding: 'utf-8',
-                stdio: ['pipe', 'pipe', 'ignore']
+                stdio: ['pipe', 'pipe', 'pipe']
             });
             return result
                 .split('\n')
@@ -231,15 +232,26 @@ class CoveragePipe {
                 .filter(Boolean);
         }
         catch (err) {
-            const errorMessage = err.message || '';
-            // Git edge: Not a git repository or other error
+            // Prefer Git's own stderr output, fall back to the generic error message
+            const gitOutput = (err.stderr || '').toString().trim();
+            const errorMessage = gitOutput || err.message || '';
+            // Git edge: Not a git repository
             if (errorMessage.includes('Not a git repository')) {
                 log_js_1.log.error('❌ Error: This folder is not a Git repository.');
+                return [];
             }
-            else {
-                throw new Error(`❌ Git command failed ("${cmd}"):\n`, errorMessage);
+            // Git edge: the branch/ref to diff against is not available locally.
+            // This is common in CI, where a shallow checkout fetches only the current branch.
+            if (errorMessage.includes('unknown revision') ||
+                errorMessage.includes('ambiguous argument') ||
+                errorMessage.includes('bad revision')) {
+                log_js_1.log.error(`❌ Git command failed ("${cmd}"):\n${errorMessage}`);
+                log_js_1.log.error(`🔍 Branch "${this.branch}" was not found locally. ` +
+                    `In CI this usually means a shallow checkout — fetch full history first, e.g. ` +
+                    `actions/checkout with "fetch-depth: 0", or run "git fetch origin ${this.branch}:${this.branch}".`);
+                return [];
             }
-            return [];
+            throw new Error(`❌ Git command failed ("${cmd}"):\n${errorMessage}`);
         }
     }
     /**

package/lib/pipe/debug.d.ts

@@ -3,18 +3,13 @@ export class DebugPipe {
     params: any;
     store: any;
     isEnabled: boolean;
-    batch: {
-        isEnabled: any;
-        intervalFunction: any;
-        intervalTime: number;
-        tests: any[];
-        batchIndex: number;
-    };
+    tests: any[];
     logFilePath: string;
     rootPath: string;
     historyDir: string;
     testomatioEnvVars: {};
-    batchUpload(): Promise<void>;
+    flushOnExit: () => void;
+    exitListenerAttached: boolean;
     /**
      * Logs data to a file if logging is enabled.
      *
@@ -24,9 +19,17 @@ export class DebugPipe {
     logToFile(logData: any): Promise<void>;
     lastActionTimestamp: number;
     prepareRun(opts: any): Promise<any[]>;
-    createRun(params?: {}): Promise<{}>;
+    createRun(params?: {}): Promise<void>;
     addTest(data: any): Promise<void>;
     finishRun(params: any): Promise<void>;
     sync(): Promise<void>;
+    /**
+     * Writes any buffered tests to the debug file as a single batch.
+     * Runs synchronously so it can also be invoked from a process `exit` handler,
+     * which is the only chance to persist tests when a hook failure (e.g. a failing
+     * AfterSuite) prevents `finishRun` from being reached. Idempotent: the buffer is
+     * drained on flush, so a later `finishRun`/exit flush is a no-op.
+     */
+    flushBufferedTests(): void;
     toString(): string;
 }

package/lib/pipe/debug.js

@@ -17,13 +17,7 @@ class DebugPipe {
         this.store = store || {};
         this.isEnabled = !!process.env.TESTOMATIO_DEBUG || !!process.env.DEBUG;
         if (this.isEnabled) {
-            this.batch = {
-                isEnabled: this.params.isBatchEnabled ?? !process.env.TESTOMATIO_DISABLE_BATCH_UPLOAD,
-                intervalFunction: null,
-                intervalTime: 5000,
-                tests: [],
-                batchIndex: 0,
-            };
+            this.tests = [];
             const suffix = process.env.TESTOMATIO_REPLAY ? 'replay' : '';
             const paths = (0, debug_js_1.getDebugFilePath)(suffix);
             this.logFilePath = paths.tmp;
@@ -63,8 +57,12 @@ class DebugPipe {
             this.logToFile({ datetime: new Date().toISOString(), timestamp: Date.now() });
             this.logToFile({ data: 'variables', testomatioEnvVars: this.testomatioEnvVars });
             this.logToFile({ data: 'store', store: this.store || {} });
-            // Bind batchUpload to the instance
-            this.batchUpload = this.batchUpload.bind(this);
+            // Safety net for hook failures (e.g. a failing AfterSuite) that abort the run
+            // before finishRun: buffered tests would otherwise be lost. The handler is
+            // attached lazily when the first test is buffered and detached once flushed,
+            // so processes that create many pipes don't pile up `exit` listeners.
+            this.flushOnExit = () => this.flushBufferedTests();
+            this.exitListenerAttached = false;
         }
     }
     /**
@@ -89,46 +87,21 @@ class DebugPipe {
     async createRun(params = {}) {
         if (!this.isEnabled)
             return;
-        if (params.isBatchEnabled === true || params.isBatchEnabled === false)
-            this.batch.isEnabled = params.isBatchEnabled;
-        if (!this.isEnabled)
-            return {};
-        if (this.batch.isEnabled)
-            this.batch.intervalFunction = setInterval(this.batchUpload, this.batch.intervalTime);
         this.logToFile({ action: 'createRun', params });
     }
     async addTest(data) {
         if (!this.isEnabled)
             return;
-        if (!this.batch.isEnabled) {
-            const logData = { action: 'addTest', testId: data };
-            if (this.store.runId)
-                logData.runId = this.store.runId;
-            this.logToFile(logData);
+        this.tests.push(data);
+        if (!this.exitListenerAttached) {
+            process.once('exit', this.flushOnExit);
+            this.exitListenerAttached = true;
         }
-        else
-            this.batch.tests.push(data);
-        if (!this.batch.intervalFunction)
-            await this.batchUpload();
-    }
-    async batchUpload() {
-        this.batch.batchIndex++;
-        if (!this.batch.isEnabled)
-            return;
-        if (!this.batch.tests.length)
-            return;
-        const testsToSend = this.batch.tests.splice(0);
-        const logData = { action: 'addTestsBatch', tests: testsToSend };
-        if (this.store.runId)
-            logData.runId = this.store.runId;
-        this.logToFile(logData);
     }
     async finishRun(params) {
         if (!this.isEnabled)
             return;
         await this.sync();
-        if (this.batch.intervalFunction)
-            clearInterval(this.batch.intervalFunction);
         const logData = { action: 'finishRun', params };
         if (this.store.runId)
             logData.runId = this.store.runId;
@@ -137,9 +110,27 @@ class DebugPipe {
         log_js_1.log.info(`History: ${this.historyDir}`);
     }
     async sync() {
-        if (!this.isEnabled)
+        this.flushBufferedTests();
+    }
+    /**
+     * Writes any buffered tests to the debug file as a single batch.
+     * Runs synchronously so it can also be invoked from a process `exit` handler,
+     * which is the only chance to persist tests when a hook failure (e.g. a failing
+     * AfterSuite) prevents `finishRun` from being reached. Idempotent: the buffer is
+     * drained on flush, so a later `finishRun`/exit flush is a no-op.
+     */
+    flushBufferedTests() {
+        if (!this.isEnabled || !this.tests.length)
             return;
-        await this.batchUpload();
+        const tests = this.tests.splice(0);
+        const logData = { action: 'addTestsBatch', tests };
+        if (this.store.runId)
+            logData.runId = this.store.runId;
+        this.logToFile(logData);
+        if (this.exitListenerAttached) {
+            process.removeListener('exit', this.flushOnExit);
+            this.exitListenerAttached = false;
+        }
     }
     toString() {
         return 'Debug Reporter';

package/lib/pipe/testomatio.d.ts

@@ -1,16 +1,26 @@
 export default TestomatioPipe;
 export type Pipe = import("../../types/types.js").Pipe;
 export type TestData = import("../../types/types.js").TestData;
+export type BatchMode = import("../../types/types.js").BatchMode;
+export type CreateRunParams = import("../../types/types.js").CreateRunParams;
 /**
  * @typedef {import('../../types/types.js').Pipe} Pipe
  * @typedef {import('../../types/types.js').TestData} TestData
+ * @typedef {import('../../types/types.js').BatchMode} BatchMode
+ * @typedef {import('../../types/types.js').CreateRunParams} CreateRunParams
  * @class TestomatioPipe
  * @implements {Pipe}
  */
 declare class TestomatioPipe implements Pipe {
     constructor(params: any, store: any);
     batch: {
-        isEnabled: any;
+        /** @type {BatchMode}
+         * Batch upload mode:
+         * - `auto`: upload tests automatically by time interval (e.g. every 5 seconds).
+         * - `manual`: buffer tests and upload only when `sync()` is invoked manually.
+         * - `disabled`: send one test per request, no batching.
+         */
+        mode: BatchMode;
         intervalFunction: any;
         intervalTime: number;
         tests: any[];
@@ -50,14 +60,10 @@ declare class TestomatioPipe implements Pipe {
     prepareRun(opts: any): Promise<string[]>;
     /**
      * Creates a new run on Testomat.io
-     * @param {{isBatchEnabled?: boolean, kind?: string, configuration?: Record<string, any>}} params
+     * @param {CreateRunParams} params
      * @returns Promise<void>
      */
-    createRun(params?: {
-        isBatchEnabled?: boolean;
-        kind?: string;
-        configuration?: Record<string, any>;
-    }): Promise<void>;
+    createRun(params?: CreateRunParams): Promise<void>;
     runUrl: string;
     runPublicUrl: any;
     /**

package/lib/pipe/testomatio.js

@@ -38,15 +38,23 @@ function parseCiParams(raw) {
 /**
  * @typedef {import('../../types/types.js').Pipe} Pipe
  * @typedef {import('../../types/types.js').TestData} TestData
+ * @typedef {import('../../types/types.js').BatchMode} BatchMode
+ * @typedef {import('../../types/types.js').CreateRunParams} CreateRunParams
  * @class TestomatioPipe
  * @implements {Pipe}
  */
 class TestomatioPipe {
     constructor(params, store) {
         this.batch = {
-            isEnabled: params?.isBatchEnabled ?? !process.env.TESTOMATIO_DISABLE_BATCH_UPLOAD,
+            /** @type {BatchMode}
+             * Batch upload mode:
+             * - `auto`: upload tests automatically by time interval (e.g. every 5 seconds).
+             * - `manual`: buffer tests and upload only when `sync()` is invoked manually.
+             * - `disabled`: send one test per request, no batching.
+             */
+            mode: params.batchMode || (process.env.TESTOMATIO_DISABLE_BATCH_UPLOAD ? constants_js_1.BATCH_MODE.DISABLED : constants_js_1.BATCH_MODE.AUTO),
             intervalFunction: null, // will be created in createRun by setInterval function
-            intervalTime: 5000, // how often tests are sent
+            intervalTime: 6000, // how often tests are sent
             tests: [], // array of tests in batch
             batchIndex: 0, // represents the current batch index (starts from 1 and increments by 1 for each batch)
             numberOfTimesCalledWithoutTests: 0, // how many times batch was called without tests
@@ -193,14 +201,15 @@ class TestomatioPipe {
     }
     /**
      * Creates a new run on Testomat.io
-     * @param {{isBatchEnabled?: boolean, kind?: string, configuration?: Record<string, any>}} params
+     * @param {CreateRunParams} params
      * @returns Promise<void>
      */
     async createRun(params = {}) {
-        this.batch.isEnabled = params.isBatchEnabled ?? this.batch.isEnabled;
+        if (params.batchMode)
+            this.batch.mode = params.batchMode;
         if (!this.isEnabled)
             return;
-        if (this.batch.isEnabled && this.isEnabled)
+        if (this.batch.mode === constants_js_1.BATCH_MODE.AUTO && this.isEnabled)
             this.batch.intervalFunction = setInterval(this.#batchUpload, this.batch.intervalTime);
         if (this.store) {
             this.store.runKind = params.kind;
@@ -391,7 +400,7 @@ class TestomatioPipe {
      * Uploads tests as a batch (multiple tests at once). Intended to be used with a setInterval
      */
     #batchUpload = async () => {
-        if (!this.batch.isEnabled)
+        if (this.batch.mode === constants_js_1.BATCH_MODE.DISABLED)
             return;
         if (!this.batch.tests.length)
             return;
@@ -401,7 +410,7 @@ class TestomatioPipe {
         if (this.batch.numberOfTimesCalledWithoutTests > 10) {
             debug('📨 Batch upload: no tests to send for 10 times, stopping batch');
             clearInterval(this.batch.intervalFunction);
-            this.batch.isEnabled = false;
+            this.batch.mode = constants_js_1.BATCH_MODE.DISABLED;
         }
         if (!this.batch.tests.length) {
             debug('📨 Batch upload: no tests to send');
@@ -454,12 +463,12 @@ class TestomatioPipe {
         }
         this.#formatData(data);
         let uploading = null;
-        if (!this.batch.isEnabled)
+        if (this.batch.mode === constants_js_1.BATCH_MODE.DISABLED)
             uploading = this.#uploadSingleTest(data);
         else
             this.batch.tests.push(data);
-        // if test is added after run which is already finished
-        if (!this.batch.intervalFunction)
+        // auto mode but no interval running yet (e.g. createRun hasn't started it): flush immediately
+        if (this.batch.mode === constants_js_1.BATCH_MODE.AUTO && !this.batch.intervalFunction)
             uploading = this.#batchUpload();
         // return promise to be able to wait for it
         return uploading;
@@ -487,7 +496,7 @@ class TestomatioPipe {
             // (e.g. if test has artifacts, add test function will be invoked only after artifacts are uploaded)
             // batch stops working after run is finished; thus, disable it to use single test uploading
             this.batch.intervalFunction = null;
-            this.batch.isEnabled = false;
+            this.batch.mode = constants_js_1.BATCH_MODE.DISABLED;
         }
         debug('Finishing run...');
         if (this.reportingCanceledDueToReqFailures) {
@@ -549,7 +558,7 @@ class TestomatioPipe {
         if (this.batch.intervalFunction) {
             clearInterval(this.batch.intervalFunction);
             this.batch.intervalFunction = null;
-            this.batch.isEnabled = false;
+            this.batch.mode = constants_js_1.BATCH_MODE.DISABLED;
         }
         this.batch.tests = [];
     }

package/lib/replay.js

@@ -210,7 +210,7 @@ class Replay {
         process.env.TESTOMATIO_REPLAY = '1';
         const client = new client_js_1.default({
             apiKey: this.apiKey,
-            isBatchEnabled: true,
+            batchMode: constants_js_1.BATCH_MODE.AUTO,
             ...runParams,
             ...(runId && { runId }),
         });

package/lib/xmlReader.d.ts

@@ -8,7 +8,7 @@ declare class XmlReader {
         env: string;
         group_title: string;
         detach: string;
-        isBatchEnabled: boolean;
+        batchMode: "manual";
     };
     runId: any;
     adapter: import("./junit-adapter/adapter.js").default;

package/lib/xmlReader.js

@@ -51,8 +51,7 @@ class XmlReader {
             env: TESTOMATIO_ENV,
             group_title: TESTOMATIO_RUNGROUP_TITLE,
             detach: TESTOMATIO_MARK_DETACHED,
-            // batch uploading is implemented for xml already
-            isBatchEnabled: false,
+            batchMode: constants_js_1.BATCH_MODE.MANUAL,
         };
         this.runId = opts.runId || TESTOMATIO_RUN;
         this.adapter = (0, index_js_2.default)(opts.lang?.toLowerCase(), opts);
@@ -467,7 +466,7 @@ class XmlReader {
             title: this.requestParams.title,
             env: this.requestParams.env,
             group_title: this.requestParams.group_title,
-            isBatchEnabled: this.requestParams.isBatchEnabled,
+            batchMode: this.requestParams.batchMode,
         };
         debug('Run', runParams);
         this.pipes = this.pipes || (await this.pipesPromise);
@@ -521,7 +520,7 @@ class XmlReader {
         this.formatTests();
         this.pipes = this.pipes || (await this.pipesPromise);
         // Create run before uploading tests to ensure runId is set
-        await this.createRun();
+        // await this.createRun(); // makes reporting stuck after finish, thus commenting out
         if (!this.tests || !Array.isArray(this.tests) || this.tests.length === 0) {
             debug('No tests to upload, finishing run');
             const finishData = {

package/package.json

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

package/src/adapter/codecept.js

@@ -48,6 +48,7 @@ if (MAJOR_VERSION === 3 && MINOR_VERSION < 7) {
 
 function CodeceptReporter(config) {
   const failedTests = [];
+  const reportedTestUids = new Set();
   let videos = [];
   let traces = [];
   const reportTestPromises = [];
@@ -161,6 +162,7 @@ function CodeceptReporter(config) {
     const error = hook?.ctx?.currentTest?.err;
 
     for (const test of suite.tests) {
+      reportedTestUids.add(test.uid);
       const reportTestPromise = client.addTestRun('failed', {
         ...stripExampleFromTitle(test.title),
         rid: test.uid,
@@ -197,9 +199,29 @@ function CodeceptReporter(config) {
     });
   });
 
+  event.dispatcher.on(event.test.skipped, test => {
+    const { uid, tags, title } = test.simplify();
+
+    if (uid && reportedTestUids.has(uid)) return;
+
+    services.setContext(null);
+
+    const reportTestPromise = client.addTestRun(STATUS.SKIPPED, {
+      ...stripExampleFromTitle(title),
+      rid: uid,
+      test_id: getTestomatIdFromTestTitle(`${title} ${tags?.join(' ')}`),
+      suite_title: test.parent && stripTagsFromTitle(stripExampleFromTitle(test.parent.title).title),
+      time: test.duration,
+      meta: test.meta,
+    });
+    reportTestPromises.push(reportTestPromise);
+    reportedTestUids.add(uid);
+  });
+
   event.dispatcher.on(event.test.after, test => {
     const { uid, tags, title, artifacts } = test.simplify();
     const error = test.err || null;
+    reportedTestUids.add(uid);
     failedTests.push(uid || title);
     const testObj = getTestAndMessage(title);
     const files = buildArtifactFiles(artifacts);
@@ -211,8 +233,8 @@ function CodeceptReporter(config) {
 
     // Build step hierarchy with screenshot from screenshotOnFail
     const stepHierarchy = buildUnifiedStepHierarchy(
-      test.steps, 
-      hookSteps, 
+      test.steps,
+      hookSteps,
       screenshotOnFailPath
     );
 

package/src/bin/cli.js

@@ -6,7 +6,7 @@ import { glob } from 'glob';
 import createDebugMessages from 'debug';
 import TestomatClient from '../client.js';
 import XmlReader from '../xmlReader.js';
-import { APP_PREFIX, STATUS, DEBUG_FILE } from '../constants.js';
+import { APP_PREFIX, STATUS, DEBUG_FILE, BATCH_MODE } from '../constants.js';
 import { cleanLatestRunId, getPackageVersion, applyFilter } from '../utils/utils.js';
 import { config } from '../config.js';
 import { readLatestRunId } from '../utils/utils.js';
@@ -369,7 +369,7 @@ program
     const client = new TestomatClient({
       apiKey,
       runId,
-      isBatchEnabled: false,
+      batchMode: BATCH_MODE.DISABLED,
     });
 
     let testruns = client.uploader.readUploadedFiles(runId);

package/src/bin/uploadArtifacts.js

@@ -9,6 +9,7 @@ import { config } from '../config.js';
 import { readLatestRunId } from '../utils/utils.js';
 import dotenv from 'dotenv';
 import { log } from '../utils/log.js';
+import { BATCH_MODE } from '../constants.js';
 
 const debug = createDebugMessages('@testomatio/reporter:upload-cli');
 const version = getPackageVersion();
@@ -37,7 +38,7 @@ program
     const client = new TestomatClient({
       apiKey,
       runId,
-      isBatchEnabled: false,
+      batchMode: BATCH_MODE.DISABLED,
     });
     let testruns = client.uploader.readUploadedFiles(process.env.TESTOMATIO_RUN);
 

package/src/constants.js

@@ -28,6 +28,14 @@ const STATUS = {
   SKIPPED: 'skipped',
   FINISHED: 'finished',
 };
+
+// batch upload mode
+/** @type {{ AUTO: 'auto', MANUAL: 'manual', DISABLED: 'disabled' }} */
+const BATCH_MODE = {
+  AUTO: 'auto',
+  MANUAL: 'manual',
+  DISABLED: 'disabled',
+};
 // html pipe var
 const HTML_REPORT = {
   FOLDER: 'html-report',
@@ -61,6 +69,7 @@ export {
   TESTOMAT_TMP_STORAGE_DIR,
   CSV_HEADERS,
   STATUS,
+  BATCH_MODE,
   HTML_REPORT,
   MARKDOWN_REPORT,
   REQUEST_TIMEOUT,

package/src/pipe/coverage.js

@@ -261,9 +261,10 @@ class CoveragePipe { // or Changes for the future???
      */
     #getChangedFilesFromGit(cmd) {
         try {
+            // Capture stderr (instead of ignoring it) so Git's actual error is available for diagnostics
             const result = execSync(cmd, {
                 encoding: 'utf-8',
-                stdio: ['pipe', 'pipe', 'ignore']
+                stdio: ['pipe', 'pipe', 'pipe']
             });
 
             return result
@@ -272,16 +273,33 @@ class CoveragePipe { // or Changes for the future???
                 .filter(Boolean);
         }
         catch (err) {
-            const errorMessage = err.message || '';
-            // Git edge: Not a git repository or other error
+            // Prefer Git's own stderr output, fall back to the generic error message
+            const gitOutput = (err.stderr || '').toString().trim();
+            const errorMessage = gitOutput || err.message || '';
+
+            // Git edge: Not a git repository
             if (errorMessage.includes('Not a git repository')) {
-                log.error( '❌ Error: This folder is not a Git repository.');
+                log.error('❌ Error: This folder is not a Git repository.');
+                return [];
             }
-            else {
-                throw new Error(`❌ Git command failed ("${cmd}"):\n`, errorMessage);
+
+            // Git edge: the branch/ref to diff against is not available locally.
+            // This is common in CI, where a shallow checkout fetches only the current branch.
+            if (
+                errorMessage.includes('unknown revision') ||
+                errorMessage.includes('ambiguous argument') ||
+                errorMessage.includes('bad revision')
+            ) {
+                log.error(`❌ Git command failed ("${cmd}"):\n${errorMessage}`);
+                log.error(
+                    `🔍 Branch "${this.branch}" was not found locally. ` +
+                    `In CI this usually means a shallow checkout — fetch full history first, e.g. ` +
+                    `actions/checkout with "fetch-depth: 0", or run "git fetch origin ${this.branch}:${this.branch}".`
+                );
+                return [];
             }
 
-            return [];
+            throw new Error(`❌ Git command failed ("${cmd}"):\n${errorMessage}`);
         }
     }
 

package/src/pipe/debug.js

@@ -14,13 +14,7 @@ export class DebugPipe {
 
     this.isEnabled = !!process.env.TESTOMATIO_DEBUG || !!process.env.DEBUG;
     if (this.isEnabled) {
-      this.batch = {
-        isEnabled: this.params.isBatchEnabled ?? !process.env.TESTOMATIO_DISABLE_BATCH_UPLOAD,
-        intervalFunction: null,
-        intervalTime: 5000,
-        tests: [],
-        batchIndex: 0,
-      };
+      this.tests = [];
       const suffix = process.env.TESTOMATIO_REPLAY ? 'replay' : '';
       const paths = getDebugFilePath(suffix);
       this.logFilePath = paths.tmp;
@@ -60,8 +54,13 @@ export class DebugPipe {
       this.logToFile({ datetime: new Date().toISOString(), timestamp: Date.now() });
       this.logToFile({ data: 'variables', testomatioEnvVars: this.testomatioEnvVars });
       this.logToFile({ data: 'store', store: this.store || {} });
-      // Bind batchUpload to the instance
-      this.batchUpload = this.batchUpload.bind(this);
+
+      // Safety net for hook failures (e.g. a failing AfterSuite) that abort the run
+      // before finishRun: buffered tests would otherwise be lost. The handler is
+      // attached lazily when the first test is buffered and detached once flushed,
+      // so processes that create many pipes don't pile up `exit` listeners.
+      this.flushOnExit = () => this.flushBufferedTests();
+      this.exitListenerAttached = false;
     }
   }
 
@@ -88,42 +87,22 @@ export class DebugPipe {
 
   async createRun(params = {}) {
     if (!this.isEnabled) return;
-    if (params.isBatchEnabled === true || params.isBatchEnabled === false) this.batch.isEnabled = params.isBatchEnabled;
-
-    if (!this.isEnabled) return {};
-    if (this.batch.isEnabled) this.batch.intervalFunction = setInterval(this.batchUpload, this.batch.intervalTime);
 
     this.logToFile({ action: 'createRun', params });
   }
 
   async addTest(data) {
     if (!this.isEnabled) return;
-
-    if (!this.batch.isEnabled) {
-      const logData = { action: 'addTest', testId: data };
-      if (this.store.runId) logData.runId = this.store.runId;
-      this.logToFile(logData);
-    } else this.batch.tests.push(data);
-
-    if (!this.batch.intervalFunction) await this.batchUpload();
-  }
-
-  async batchUpload() {
-    this.batch.batchIndex++;
-    if (!this.batch.isEnabled) return;
-    if (!this.batch.tests.length) return;
-
-    const testsToSend = this.batch.tests.splice(0);
-
-    const logData = { action: 'addTestsBatch', tests: testsToSend };
-    if (this.store.runId) logData.runId = this.store.runId;
-    this.logToFile(logData);
+    this.tests.push(data);
+    if (!this.exitListenerAttached) {
+      process.once('exit', this.flushOnExit);
+      this.exitListenerAttached = true;
+    }
   }
 
   async finishRun(params) {
     if (!this.isEnabled) return;
     await this.sync();
-    if (this.batch.intervalFunction) clearInterval(this.batch.intervalFunction);
     const logData = { action: 'finishRun', params };
     if (this.store.runId) logData.runId = this.store.runId;
     this.logToFile(logData);
@@ -133,8 +112,28 @@ export class DebugPipe {
   }
 
   async sync() {
-    if (!this.isEnabled) return;
-    await this.batchUpload();
+    this.flushBufferedTests();
+  }
+
+  /**
+   * Writes any buffered tests to the debug file as a single batch.
+   * Runs synchronously so it can also be invoked from a process `exit` handler,
+   * which is the only chance to persist tests when a hook failure (e.g. a failing
+   * AfterSuite) prevents `finishRun` from being reached. Idempotent: the buffer is
+   * drained on flush, so a later `finishRun`/exit flush is a no-op.
+   */
+  flushBufferedTests() {
+    if (!this.isEnabled || !this.tests.length) return;
+
+    const tests = this.tests.splice(0);
+    const logData = { action: 'addTestsBatch', tests };
+    if (this.store.runId) logData.runId = this.store.runId;
+    this.logToFile(logData);
+
+    if (this.exitListenerAttached) {
+      process.removeListener('exit', this.flushOnExit);
+      this.exitListenerAttached = false;
+    }
   }
 
   toString() {

package/src/pipe/testomatio.js

@@ -5,6 +5,7 @@ import JsonCycle from 'json-cycle';
 import {
   APP_PREFIX,
   STATUS,
+  BATCH_MODE,
   REQUEST_TIMEOUT,
   getCreateRunRequestTimeout,
   REPORTER_REQUEST_RETRIES,
@@ -46,17 +47,25 @@ function parseCiParams(raw) {
 /**
  * @typedef {import('../../types/types.js').Pipe} Pipe
  * @typedef {import('../../types/types.js').TestData} TestData
+ * @typedef {import('../../types/types.js').BatchMode} BatchMode
+ * @typedef {import('../../types/types.js').CreateRunParams} CreateRunParams
  * @class TestomatioPipe
  * @implements {Pipe}
  */
 class TestomatioPipe {
   constructor(params, store) {
     this.batch = {
-      isEnabled: params?.isBatchEnabled ?? !process.env.TESTOMATIO_DISABLE_BATCH_UPLOAD,
+      /** @type {BatchMode}
+       * Batch upload mode:
+       * - `auto`: upload tests automatically by time interval (e.g. every 5 seconds).
+       * - `manual`: buffer tests and upload only when `sync()` is invoked manually.
+       * - `disabled`: send one test per request, no batching.
+       */
+      mode: params.batchMode || (process.env.TESTOMATIO_DISABLE_BATCH_UPLOAD ? BATCH_MODE.DISABLED : BATCH_MODE.AUTO),
       intervalFunction: null, // will be created in createRun by setInterval function
-      intervalTime: 5000, // how often tests are sent
+      intervalTime: 6000, // how often tests are sent
       tests: [], // array of tests in batch
-      batchIndex: 0, // represents the current batch index (starts from 1 and increments by 1 for each batch)
+      batchIndex: 0,  // represents the current batch index (starts from 1 and increments by 1 for each batch)
       numberOfTimesCalledWithoutTests: 0, // how many times batch was called without tests
     };
     this.retriesTimestamps = [];
@@ -222,13 +231,13 @@ class TestomatioPipe {
 
   /**
    * Creates a new run on Testomat.io
-   * @param {{isBatchEnabled?: boolean, kind?: string, configuration?: Record<string, any>}} params
+   * @param {CreateRunParams} params
    * @returns Promise<void>
    */
   async createRun(params = {}) {
-    this.batch.isEnabled = params.isBatchEnabled ?? this.batch.isEnabled;
+    if (params.batchMode) this.batch.mode = params.batchMode;
     if (!this.isEnabled) return;
-    if (this.batch.isEnabled && this.isEnabled)
+    if (this.batch.mode === BATCH_MODE.AUTO && this.isEnabled)
       this.batch.intervalFunction = setInterval(this.#batchUpload, this.batch.intervalTime);
     if (this.store) {
       this.store.runKind = params.kind;
@@ -433,14 +442,14 @@ class TestomatioPipe {
    * Uploads tests as a batch (multiple tests at once). Intended to be used with a setInterval
    */
   #batchUpload = async () => {
-    if (!this.batch.isEnabled) return;
+    if (this.batch.mode === BATCH_MODE.DISABLED) return;
     if (!this.batch.tests.length) return;
     if (this.#cancelTestReportingInCaseOfTooManyReqFailures()) return;
     // prevent infinite loop
     if (this.batch.numberOfTimesCalledWithoutTests > 10) {
       debug('📨 Batch upload: no tests to send for 10 times, stopping batch');
       clearInterval(this.batch.intervalFunction);
-      this.batch.isEnabled = false;
+      this.batch.mode = BATCH_MODE.DISABLED;
     }
     if (!this.batch.tests.length) {
       debug('📨 Batch upload: no tests to send');
@@ -496,11 +505,11 @@ class TestomatioPipe {
     this.#formatData(data);
 
     let uploading = null;
-    if (!this.batch.isEnabled) uploading = this.#uploadSingleTest(data);
+    if (this.batch.mode === BATCH_MODE.DISABLED) uploading = this.#uploadSingleTest(data);
     else this.batch.tests.push(data);
 
-    // if test is added after run which is already finished
-    if (!this.batch.intervalFunction) uploading = this.#batchUpload();
+    // auto mode but no interval running yet (e.g. createRun hasn't started it): flush immediately
+    if (this.batch.mode === BATCH_MODE.AUTO && !this.batch.intervalFunction) uploading = this.#batchUpload();
 
     // return promise to be able to wait for it
     return uploading;
@@ -529,7 +538,7 @@ class TestomatioPipe {
       // (e.g. if test has artifacts, add test function will be invoked only after artifacts are uploaded)
       // batch stops working after run is finished; thus, disable it to use single test uploading
       this.batch.intervalFunction = null;
-      this.batch.isEnabled = false;
+      this.batch.mode = BATCH_MODE.DISABLED;
     }
 
     debug('Finishing run...');
@@ -613,7 +622,7 @@ class TestomatioPipe {
     if (this.batch.intervalFunction) {
       clearInterval(this.batch.intervalFunction);
       this.batch.intervalFunction = null;
-      this.batch.isEnabled = false;
+      this.batch.mode = BATCH_MODE.DISABLED;
     }
     this.batch.tests = [];
   }

package/src/replay.js

@@ -1,7 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import TestomatClient from './client.js';
-import { STATUS, DEBUG_FILE } from './constants.js';
+import { STATUS, DEBUG_FILE, BATCH_MODE } from './constants.js';
 import { config } from './config.js';
 
 export class Replay {
@@ -216,7 +216,7 @@ export class Replay {
 
     const client = new TestomatClient({
       apiKey: this.apiKey,
-      isBatchEnabled: true,
+      batchMode: BATCH_MODE.AUTO,
       ...runParams,
       ...(runId && { runId }),
     });

package/src/xmlReader.js

@@ -3,7 +3,7 @@ import path from 'path';
 import pc from 'picocolors';
 import fs from 'fs';
 import { XMLParser } from 'fast-xml-parser';
-import { APP_PREFIX, STATUS } from './constants.js';
+import { APP_PREFIX, STATUS, BATCH_MODE } from './constants.js';
 import { randomUUID } from 'crypto';
 import { fileURLToPath } from 'url';
 import { NUnitXmlParser } from './junit-adapter/nunit-parser.js';
@@ -73,8 +73,7 @@ class XmlReader {
       env: TESTOMATIO_ENV,
       group_title: TESTOMATIO_RUNGROUP_TITLE,
       detach: TESTOMATIO_MARK_DETACHED,
-      // batch uploading is implemented for xml already
-      isBatchEnabled: false,
+      batchMode: BATCH_MODE.MANUAL,
     };
     this.runId = opts.runId || TESTOMATIO_RUN;
     this.adapter = adapterFactory(opts.lang?.toLowerCase(), opts);
@@ -543,7 +542,7 @@ class XmlReader {
       title: this.requestParams.title,
       env: this.requestParams.env,
       group_title: this.requestParams.group_title,
-      isBatchEnabled: this.requestParams.isBatchEnabled,
+      batchMode: this.requestParams.batchMode,
     };
 
     debug('Run', runParams);
@@ -611,7 +610,7 @@ class XmlReader {
     this.pipes = this.pipes || (await this.pipesPromise);
 
     // Create run before uploading tests to ensure runId is set
-    await this.createRun();
+    // await this.createRun(); // makes reporting stuck after finish, thus commenting out
 
     if (!this.tests || !Array.isArray(this.tests) || this.tests.length === 0) {
       debug('No tests to upload, finishing run');

package/types/types.d.ts

@@ -234,7 +234,7 @@ export interface HtmlTestData extends TestData {
 /**
  * Extended test data for Markdown reporter.
  */
-export interface MarkdownTestData extends HtmlTestData {}
+export interface MarkdownTestData extends HtmlTestData { }
 
 /**
  * Object representing a result of a Run.
@@ -288,6 +288,13 @@ export enum RunStatus {
   Finished = 'finished',
 }
 
+/** Batch upload strategy:
+ * `auto` (by time interval, e.g. every 5 seconds),
+ * `manual` (send tests via manually invoking sync() ),
+ * `disabled` (one test per request, no batching).
+ */
+export type BatchMode = 'auto' | 'manual' | 'disabled';
+
 export interface Pipe {
   isEnabled: boolean;
   store: {};
@@ -334,8 +341,8 @@ export interface CreateRunParams {
   /** Run configuration merged into the server-side run configuration. */
   configuration?: Record<string, any>;
 
-  /** Override batch upload on/off. */
-  isBatchEnabled?: boolean;
+  /** Override batch upload mode. */
+  batchMode?: BatchMode;
 }
 
 /**