@testomatio/reporter 2.8.3 → 2.8.5-beta.1-remote

package/lib/bin/cli.js

@@ -35,10 +35,13 @@ program
         dotenv_1.default.config();
     }
     // --filter-list produces a machine-readable test list on stdout, so route
-    // logs to stderr and skip the banner to keep stdout clean for piping.
+    // remaining output to stderr, skip the banner, and silence info-level
+    // logs so the terminal isn't flooded with progress noise.
+    // Set TESTOMATIO_LOG_LEVEL=INFO to re-enable progress logs for debugging.
     const subOpts = actionCommand.opts();
     if (subOpts.filterList || subOpts.format) {
         process.env.TESTOMATIO_LOG_STDERR = '1';
+        process.env.TESTOMATIO_LOG_LEVEL ||= 'WARN';
     }
     else {
         console.log(picocolors_1.default.cyan(picocolors_1.default.bold(` 🤩 Testomat.io Reporter v${version}`)));
@@ -88,7 +91,19 @@ program
     .option('--filter-list <filter>', 'Get a list of all tests by filter before running')
     .option('--format <format>', 'Machine-readable output format for --filter-list (grep, json, newline, ids)')
     .option('--kind <type>', 'Specify run type: automated, manual, or mixed')
+    .option('--remote <profile>', 'Trigger run on the named Testomat.io CI profile instead of executing locally')
+    .option('--remote-param <kv>', 'key=value pair forwarded to the CI profile config (repeat for multiple)', (value, prev) => prev.concat([value]), [])
     .action(async (command, opts) => {
+    if (opts.remote) {
+        if (opts.filterList) {
+            log_js_1.log.warn(picocolors_1.default.red('⚠️  --filter-list cannot be combined with --remote'));
+            process.exit(1);
+        }
+        process.env.TESTOMATIO_CI_PROFILE = opts.remote;
+        if (opts.remoteParam?.length) {
+            process.env.TESTOMATIO_CI_PARAMS = opts.remoteParam.join(',');
+        }
+    }
     const apiKey = process.env['INPUT_TESTOMATIO-KEY'] || config_js_1.config.TESTOMATIO;
     const title = process.env.TESTOMATIO_TITLE;
     const client = new client_js_1.default({ apiKey, title });
@@ -106,7 +121,11 @@ program
         try {
             const tests = await client.prepareRun(prepareRunParams);
             if (!tests || tests.length === 0) {
-                log_js_1.log.info(picocolors_1.default.yellow('No tests found.'));
+                log_js_1.log.warn(picocolors_1.default.yellow('No tests found.'));
+                // Exit non-zero on --filter-list so scripts can detect "nothing to run"
+                // via $? and skip launching the runner.
+                if (opts.filterList)
+                    process.exit(1);
                 return;
             }
             if (opts.filterList) {
@@ -120,15 +139,42 @@ program
                 }
                 return;
             }
-            if (command && command.split) {
+            if (command && command.split && !opts.remote) {
                 command = (0, utils_js_1.applyFilter)(command, tests);
             }
         }
         catch (err) {
-            log_js_1.log.info(err.message || err);
+            log_js_1.log.error(err.message || err);
+            if (opts.filterList)
+                process.exit(1);
             return;
         }
     }
+    if (opts.remote) {
+        if (!apiKey) {
+            log_js_1.log.warn(picocolors_1.default.red('⚠️  TESTOMATIO API key required for --remote'));
+            process.exit(1);
+        }
+        if (command) {
+            log_js_1.log.warn(picocolors_1.default.yellow('Note: positional command is ignored when --remote is set; CI runs the workflow.'));
+        }
+        const createRunParams = {};
+        if (title)
+            createRunParams.title = title;
+        if (opts.kind)
+            createRunParams.kind = opts.kind;
+        try {
+            await client.createRun(createRunParams);
+        }
+        catch (err) {
+            log_js_1.log.warn(picocolors_1.default.red(`CI launch failed: ${err.message || err}`));
+            process.exit(1);
+        }
+        log_js_1.log.info(`🚀 CI build triggered on profile ${picocolors_1.default.cyan(opts.remote)}`);
+        if (client.pipeStore.runUrl)
+            log_js_1.log.info(`📊 Report URL: ${picocolors_1.default.magenta(client.pipeStore.runUrl)}`);
+        return process.exit(0);
+    }
     // just create a run (wich tests which match filters) without executing tests
     if (!command || !command.split) {
         const createRunParams = {};

package/lib/client.js

@@ -92,6 +92,8 @@ class Client {
             // Run only the selected pipe
             const rawResult = await p.prepareRun(pipeOptions);
             const result = Array.isArray(rawResult) ? rawResult : [];
+            // Expose resolved test ids to other pipes (e.g. TestomatioPipe builds `ci.grep` from this).
+            this.pipeStore.preparedTestIds = result;
             debug('Execution tests list', result);
             return result;
         }

package/lib/pipe/coverage.js

@@ -125,7 +125,7 @@ class CoveragePipe {
             log_js_1.log.info(`Matched files: ${[...lines].join(', ')}`);
         }
         if (lines.size === 0) {
-            log_js_1.log.info('ℹ️  No matching entries in coverage file for provided Git changes.');
+            log_js_1.log.warn('ℹ️  No matching entries in coverage file for provided Git changes.');
             return [];
         }
         // Step 3: Handle tag labels tests from the server
@@ -142,7 +142,7 @@ class CoveragePipe {
             }
         }
         if (this.tests.size === 0 && this.suiteIds.size === 0) {
-            log_js_1.log.info('ℹ️  No tests found for execution based on Git changes.');
+            log_js_1.log.warn('ℹ️  No tests found for execution based on Git changes.');
             return [];
         }
         this.results = [...this.tests, ...this.suiteIds];
@@ -201,7 +201,7 @@ class CoveragePipe {
                 ...q,
             });
             if (!Array.isArray(resp.data?.tests) && resp.data?.tests?.length === 0) {
-                log_js_1.log.info(`🔍 No test by ${type}=${id} were found on the Testomat.io server side!`);
+                log_js_1.log.warn(`🔍 No test by ${type}=${id} were found on the Testomat.io server side!`);
                 return undefined;
             }
             return resp.data.tests;
@@ -276,7 +276,7 @@ class CoveragePipe {
             log_js_1.log.error(err.message);
             return undefined;
         }
-        log_js_1.log.warn(`We will use '${cmd}' Git command.`);
+        log_js_1.log.info(`We will use '${cmd}' Git command.`);
         try {
             // For clear unit testing process -> Like test_defaultGitChangedFile = todomvc-tests/edit-todos_test.js
             if (this.isDefaultGitChanges) {
@@ -285,7 +285,7 @@ class CoveragePipe {
             else {
                 this.changedFiles = this.#getChangedFilesFromGit(cmd);
                 if (this.changedFiles.length === 0) {
-                    log_js_1.log.info('ℹ️  No files changed in the latest Git commit. Skipping coverage processing.');
+                    log_js_1.log.warn('ℹ️  No files changed in the latest Git commit. Skipping coverage processing.');
                     return undefined;
                 }
             }
@@ -314,18 +314,18 @@ class CoveragePipe {
     validateCoverageFile() {
         // Validate the presence of the coverage filepath
         if (!fs_1.default.existsSync(this.coverageFilePath)) {
-            log_js_1.log.info('❌ Coverage file not found:', this.coverageFilePath);
+            log_js_1.log.error('❌ Coverage file not found:', this.coverageFilePath);
             return undefined;
         }
         // Ensure the given path is a file (not a directory or other type)
         const stat = fs_1.default.statSync(this.coverageFilePath);
         if (!stat.isFile()) {
-            log_js_1.log.info('❌ Provided coverage path is not a file:', this.coverageFilePath);
+            log_js_1.log.error('❌ Provided coverage path is not a file:', this.coverageFilePath);
             return undefined;
         }
         // Validate the file extension to be ".yml" to ensure it's a YAML file
         if (path_1.default.extname(this.coverageFilePath) !== ".yml") {
-            log_js_1.log.info('❌ Coverage file must have a .yml extension:', this.coverageFilePath);
+            log_js_1.log.error('❌ Coverage file must have a .yml extension:', this.coverageFilePath);
             return undefined;
         }
         debug('Coverage file validation is OK!');

package/lib/pipe/testomatio.d.ts

@@ -31,6 +31,8 @@ declare class TestomatioPipe implements Pipe {
     env: string;
     label: string;
     description: any;
+    ciProfile: string;
+    ciParams: Record<string, string>;
     client: Gaxios;
     proceed: boolean;
     jiraId: string;

package/lib/pipe/testomatio.js

@@ -15,6 +15,26 @@ const log_js_1 = require("../utils/log.js");
 const debug = (0, debug_1.default)('@testomatio/reporter:pipe:testomatio');
 if (process.env.TESTOMATIO_RUN)
     process.env.runId = process.env.TESTOMATIO_RUN;
+/**
+ * Parse `TESTOMATIO_CI_PARAMS` (comma-separated `key=value` pairs) into an object.
+ * Entries without `=` or with empty keys are skipped. Returns undefined when input is empty.
+ *
+ * @param {string|undefined} raw
+ * @returns {Record<string, string>|undefined}
+ */
+function parseCiParams(raw) {
+    if (!raw)
+        return undefined;
+    /** @type {Record<string, string>} */
+    const result = {};
+    for (const entry of raw.split(',')) {
+        const idx = entry.indexOf('=');
+        if (idx <= 0)
+            continue;
+        result[entry.slice(0, idx).trim()] = entry.slice(idx + 1);
+    }
+    return Object.keys(result).length ? result : undefined;
+}
 /**
  * @typedef {import('../../types/types.js').Pipe} Pipe
  * @typedef {import('../../types/types.js').TestData} TestData
@@ -68,6 +88,12 @@ class TestomatioPipe {
         this.env = process.env.TESTOMATIO_ENV;
         this.label = process.env.TESTOMATIO_LABEL;
         this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
+        // Remote CI launch — when `TESTOMATIO_CI_PROFILE` is set the run will be created
+        // on the server *and* the named CI profile will be dispatched. Optional
+        // `TESTOMATIO_CI_PARAMS` is a comma-separated list of `key=value` pairs
+        // forwarded to the CI profile config (e.g. `branch=develop,REGION=eu`).
+        this.ciProfile = process.env.TESTOMATIO_CI_PROFILE;
+        this.ciParams = parseCiParams(process.env.TESTOMATIO_CI_PARAMS);
         // Create a new instance of gaxios with a custom config
         this.client = new gaxios_1.Gaxios({
             baseURL: `${this.url.trim()}`,
@@ -213,6 +239,19 @@ class TestomatioPipe {
                 this.store.configuration = { ...(this.store.configuration || {}), ...params.configuration };
             }
         }
+        // Assemble the `ci` block when the user asked for a remote CI launch via
+        // TESTOMATIO_CI_PROFILE (e.g. `--remote github`). Grep is taken from whatever
+        // `--filter` resolution already stashed in the shared pipeStore.
+        /** @type {{profile: string, grep?: string, override?: Record<string, any>}|null} */
+        let ci = null;
+        if (this.ciProfile) {
+            ci = { profile: this.ciProfile };
+            const grepIds = this.store?.preparedTestIds;
+            if (grepIds?.length)
+                ci.grep = grepIds.join('|');
+            if (this.ciParams)
+                ci.override = this.ciParams;
+        }
         const runParams = Object.fromEntries(Object.entries({
             ci_build_url: buildUrl,
             api_key: this.apiKey.trim(),
@@ -227,6 +266,7 @@ class TestomatioPipe {
             kind: params.kind,
             configuration,
             description,
+            ci,
         }).filter(([, value]) => !!value));
         debug(' >>>>>> Run params', JSON.stringify(runParams, null, 2));
         if (this.runId) {

package/package.json

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

package/src/bin/cli.js

@@ -33,10 +33,13 @@ program
     }
 
     // --filter-list produces a machine-readable test list on stdout, so route
-    // logs to stderr and skip the banner to keep stdout clean for piping.
+    // remaining output to stderr, skip the banner, and silence info-level
+    // logs so the terminal isn't flooded with progress noise.
+    // Set TESTOMATIO_LOG_LEVEL=INFO to re-enable progress logs for debugging.
     const subOpts = actionCommand.opts();
     if (subOpts.filterList || subOpts.format) {
       process.env.TESTOMATIO_LOG_STDERR = '1';
+      process.env.TESTOMATIO_LOG_LEVEL ||= 'WARN';
     } else {
       console.log(pc.cyan(pc.bold(` 🤩 Testomat.io Reporter v${version}`)));
     }
@@ -94,7 +97,25 @@ program
   .option('--filter-list <filter>', 'Get a list of all tests by filter before running')
   .option('--format <format>', 'Machine-readable output format for --filter-list (grep, json, newline, ids)')
   .option('--kind <type>', 'Specify run type: automated, manual, or mixed')
+  .option('--remote <profile>', 'Trigger run on the named Testomat.io CI profile instead of executing locally')
+  .option(
+    '--remote-param <kv>',
+    'key=value pair forwarded to the CI profile config (repeat for multiple)',
+    (value, prev) => prev.concat([value]),
+    [],
+  )
   .action(async (command, opts) => {
+    if (opts.remote) {
+      if (opts.filterList) {
+        log.warn(pc.red('⚠️  --filter-list cannot be combined with --remote'));
+        process.exit(1);
+      }
+      process.env.TESTOMATIO_CI_PROFILE = opts.remote;
+      if (opts.remoteParam?.length) {
+        process.env.TESTOMATIO_CI_PARAMS = opts.remoteParam.join(',');
+      }
+    }
+
     const apiKey = process.env['INPUT_TESTOMATIO-KEY'] || config.TESTOMATIO;
     const title = process.env.TESTOMATIO_TITLE;
     const client = new TestomatClient({ apiKey, title });
@@ -116,7 +137,10 @@ program
         const tests = await client.prepareRun(prepareRunParams);
 
         if (!tests || tests.length === 0) {
-          log.info( pc.yellow('No tests found.'));
+          log.warn( pc.yellow('No tests found.'));
+          // Exit non-zero on --filter-list so scripts can detect "nothing to run"
+          // via $? and skip launching the runner.
+          if (opts.filterList) process.exit(1);
           return;
         }
 
@@ -131,16 +155,42 @@ program
           return;
         }
 
-        if (command && command.split) {
+        if (command && command.split && !opts.remote) {
           command = applyFilter(command, tests);
         }
       }
       catch (err) {
-        log.info( err.message || err);
+        log.error( err.message || err);
+        if (opts.filterList) process.exit(1);
         return;
       }
     }
 
+    if (opts.remote) {
+      if (!apiKey) {
+        log.warn(pc.red('⚠️  TESTOMATIO API key required for --remote'));
+        process.exit(1);
+      }
+      if (command) {
+        log.warn(pc.yellow('Note: positional command is ignored when --remote is set; CI runs the workflow.'));
+      }
+
+      const createRunParams = {};
+      if (title) createRunParams.title = title;
+      if (opts.kind) createRunParams.kind = opts.kind;
+
+      try {
+        await client.createRun(createRunParams);
+      } catch (err) {
+        log.warn(pc.red(`CI launch failed: ${err.message || err}`));
+        process.exit(1);
+      }
+
+      log.info(`🚀 CI build triggered on profile ${pc.cyan(opts.remote)}`);
+      if (client.pipeStore.runUrl) log.info(`📊 Report URL: ${pc.magenta(client.pipeStore.runUrl)}`);
+      return process.exit(0);
+    }
+
     // just create a run (wich tests which match filters) without executing tests
     if (!command || !command.split) {
       const createRunParams = {};

package/src/client.js

@@ -102,6 +102,9 @@ class Client {
       const rawResult = await p.prepareRun(pipeOptions);
       const result = Array.isArray(rawResult) ? rawResult : [];
 
+      // Expose resolved test ids to other pipes (e.g. TestomatioPipe builds `ci.grep` from this).
+      this.pipeStore.preparedTestIds = result;
+
       debug('Execution tests list', result);
 
       return result;

package/src/pipe/coverage.js

@@ -140,7 +140,7 @@ class CoveragePipe { // or Changes for the future???
         }
 
         if (lines.size === 0) {
-            log.info( 'ℹ️  No matching entries in coverage file for provided Git changes.');
+            log.warn( 'ℹ️  No matching entries in coverage file for provided Git changes.');
             return [];
         }
 
@@ -163,7 +163,7 @@ class CoveragePipe { // or Changes for the future???
         }
 
         if (this.tests.size === 0 && this.suiteIds.size === 0) {
-            log.info( 'ℹ️  No tests found for execution based on Git changes.');
+            log.warn( 'ℹ️  No tests found for execution based on Git changes.');
             return [];
         }
 
@@ -234,7 +234,7 @@ class CoveragePipe { // or Changes for the future???
             });
 
             if (!Array.isArray(resp.data?.tests) && resp.data?.tests?.length === 0) {
-                log.info( `🔍 No test by ${type}=${id} were found on the Testomat.io server side!`);
+                log.warn( `🔍 No test by ${type}=${id} were found on the Testomat.io server side!`);
 
                 return undefined;
             }
@@ -322,7 +322,7 @@ class CoveragePipe { // or Changes for the future???
             return undefined;
         }
 
-        log.warn( `We will use '${cmd}' Git command.`);
+        log.info( `We will use '${cmd}' Git command.`);
 
         try {
             // For clear unit testing process -> Like test_defaultGitChangedFile = todomvc-tests/edit-todos_test.js
@@ -333,7 +333,7 @@ class CoveragePipe { // or Changes for the future???
                 this.changedFiles =  this.#getChangedFilesFromGit(cmd);
 
                 if (this.changedFiles.length === 0) {
-                    log.info('ℹ️  No files changed in the latest Git commit. Skipping coverage processing.');
+                    log.warn('ℹ️  No files changed in the latest Git commit. Skipping coverage processing.');
 
                     return undefined;
                 }
@@ -365,20 +365,20 @@ class CoveragePipe { // or Changes for the future???
     validateCoverageFile() {
         // Validate the presence of the coverage filepath
         if (!fs.existsSync(this.coverageFilePath)) {
-            log.info( '❌ Coverage file not found:', this.coverageFilePath);
+            log.error( '❌ Coverage file not found:', this.coverageFilePath);
             return undefined;
         }
 
         // Ensure the given path is a file (not a directory or other type)
         const stat = fs.statSync(this.coverageFilePath);
         if (!stat.isFile()) {
-            log.info( '❌ Provided coverage path is not a file:', this.coverageFilePath);
+            log.error( '❌ Provided coverage path is not a file:', this.coverageFilePath);
             return undefined;
         }
 
         // Validate the file extension to be ".yml" to ensure it's a YAML file
         if (path.extname(this.coverageFilePath) !== ".yml") {
-            log.info( '❌ Coverage file must have a .yml extension:', this.coverageFilePath);
+            log.error( '❌ Coverage file must have a .yml extension:', this.coverageFilePath);
             return undefined;
         }
 

package/src/pipe/testomatio.js

@@ -24,6 +24,25 @@ const debug = createDebugMessages('@testomatio/reporter:pipe:testomatio');
 
 if (process.env.TESTOMATIO_RUN) process.env.runId = process.env.TESTOMATIO_RUN;
 
+/**
+ * Parse `TESTOMATIO_CI_PARAMS` (comma-separated `key=value` pairs) into an object.
+ * Entries without `=` or with empty keys are skipped. Returns undefined when input is empty.
+ *
+ * @param {string|undefined} raw
+ * @returns {Record<string, string>|undefined}
+ */
+function parseCiParams(raw) {
+  if (!raw) return undefined;
+  /** @type {Record<string, string>} */
+  const result = {};
+  for (const entry of raw.split(',')) {
+    const idx = entry.indexOf('=');
+    if (idx <= 0) continue;
+    result[entry.slice(0, idx).trim()] = entry.slice(idx + 1);
+  }
+  return Object.keys(result).length ? result : undefined;
+}
+
 /**
  * @typedef {import('../../types/types.js').Pipe} Pipe
  * @typedef {import('../../types/types.js').TestData} TestData
@@ -85,6 +104,13 @@ class TestomatioPipe {
     this.label = process.env.TESTOMATIO_LABEL;
     this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
 
+    // Remote CI launch — when `TESTOMATIO_CI_PROFILE` is set the run will be created
+    // on the server *and* the named CI profile will be dispatched. Optional
+    // `TESTOMATIO_CI_PARAMS` is a comma-separated list of `key=value` pairs
+    // forwarded to the CI profile config (e.g. `branch=develop,REGION=eu`).
+    this.ciProfile = process.env.TESTOMATIO_CI_PROFILE;
+    this.ciParams = parseCiParams(process.env.TESTOMATIO_CI_PARAMS);
+
     // Create a new instance of gaxios with a custom config
     this.client = new Gaxios({
       baseURL: `${this.url.trim()}`,
@@ -248,6 +274,18 @@ class TestomatioPipe {
         this.store.configuration = { ...(this.store.configuration || {}), ...params.configuration };
       }
     }
+
+    // Assemble the `ci` block when the user asked for a remote CI launch via
+    // TESTOMATIO_CI_PROFILE (e.g. `--remote github`). Grep is taken from whatever
+    // `--filter` resolution already stashed in the shared pipeStore.
+    /** @type {{profile: string, grep?: string, override?: Record<string, any>}|null} */
+    let ci = null;
+    if (this.ciProfile) {
+      ci = { profile: this.ciProfile };
+      const grepIds = this.store?.preparedTestIds;
+      if (grepIds?.length) ci.grep = grepIds.join('|');
+      if (this.ciParams) ci.override = this.ciParams;
+    }
     const runParams = Object.fromEntries(
       Object.entries({
         ci_build_url: buildUrl,
@@ -263,6 +301,7 @@ class TestomatioPipe {
         kind: params.kind,
         configuration,
         description,
+        ci,
       }).filter(([, value]) => !!value),
     );
     debug(' >>>>>> Run params', JSON.stringify(runParams, null, 2));

package/types/types.d.ts

@@ -293,7 +293,7 @@ export interface Pipe {
   store: {};
 
   /** starts run  */
-  createRun(): Promise<void>;
+  createRun(params?: CreateRunParams): Promise<void>;
 
   /** adds a test to the current run */
   addTest(test: TestData): any;
@@ -316,6 +316,28 @@ export interface PipeResult {
   result?: any;
 }
 
+/**
+ * Parameters accepted by `Client.createRun`.
+ *
+ * Remote CI launch (via `--remote <profile>` / matching `TESTOMATIO_CI_PROFILE`
+ * env var) is **not** passed through this object — `TestomatioPipe` reads the
+ * env vars directly and assembles the request body. See
+ * `TESTOMATIO_CI_PROFILE` and `TESTOMATIO_CI_OVERRIDE`.
+ */
+export interface CreateRunParams {
+  /** Run kind. Defaults to `automated` server-side. */
+  kind?: 'automated' | 'manual' | 'mixed';
+
+  /** Run title. */
+  title?: string;
+
+  /** Run configuration merged into the server-side run configuration. */
+  configuration?: Record<string, any>;
+
+  /** Override batch upload on/off. */
+  isBatchEnabled?: boolean;
+}
+
 /**
  * Represents a step in a test.
  */