@testomatio/reporter 2.15.0-beta.1-json-output → 2.16.0

package/lib/adapter/codecept.js

@@ -34,7 +34,8 @@ const HOOK_EXECUTION_ORDER = {
 };
 // codeceptjs workers are self-contained
 data_storage_js_1.dataStorage.isFileStorage = false;
-const DATA_REGEXP = /[|\s]+?(\{".*\}|\[.*\])/;
+// CodeceptJS appends the serialized data row of a data-driven test to its title
+const DATA_REGEXP = / \| (\{.*\}|\[.*\]|null|"(?:\\.|[^"\\])*")((?:\s+@[a-zA-Z0-9-_]+)*)$/;
 if (MAJOR_VERSION < 3) {
     console.log('🔴 This reporter works with CodeceptJS 3+, please update your tests');
 }
@@ -259,7 +260,7 @@ function CodeceptReporter(config) {
         processArtifactsForUpload(artifacts, uid, title, videos, traces);
     });
     event.dispatcher.on(event.step.started, step => {
-        const stepText = `${repeat(output.stepShift)} ${step.toCliStyled ? step.toCliStyled() : step.toString()}`;
+        const stepText = `${repeat(output.stepShift)} ${formatStepLog(step)}`;
         data_storage_js_1.dataStorage.putData('log', stepText);
     });
     event.dispatcher.on(event.step.finished, step => {
@@ -298,16 +299,31 @@ function stripExampleFromTitle(title) {
     const res = title.match(DATA_REGEXP);
     if (!res)
         return { title, example: null };
+    let example = null;
+    let exampleParsed = false;
     try {
-        const example = JSON.parse(res[1]);
-        title = title.replace(DATA_REGEXP, '').trim();
-        return { title, example };
+        example = JSON.parse(res[1]);
+        exampleParsed = true;
     }
     catch (e) {
-        // If JSON parsing fails, return title without example
-        debug('Failed to parse example JSON:', res[1], e.message);
-        return { title: title.replace(DATA_REGEXP, '').trim(), example: null };
+        try {
+            example = JSON.parse(res[1].slice(1, -1));
+            exampleParsed = true;
+        }
+        catch (e2) {
+            debug('Failed to parse example from title:', res[1]);
+        }
+    }
+    let baseTitle = title.slice(0, res.index).trim();
+    if (exampleParsed && baseTitle.includes('${current}')) {
+        baseTitle = baseTitle.replaceAll('${current}', formatExample(example));
     }
+    return { title: `${baseTitle}${res[2]}`, example };
+}
+function formatExample(example) {
+    if (example !== null && typeof example === 'object')
+        return JSON.stringify(example);
+    return String(example);
 }
 function stripTagsFromTitle(title) {
     // Remove @tags from the end of titles (e.g., "Hooks Test Suite @hooks" -> "Hooks Test Suite")
@@ -316,6 +332,16 @@ function stripTagsFromTitle(title) {
 function repeat(num) {
     return ''.padStart(num, ' ');
 }
+function formatStepLog(step) {
+    if (typeof step?.toCliStyled === 'function')
+        return step.toCliStyled();
+    if (typeof step?.toString === 'function' && step.toString !== Object.prototype.toString) {
+        return step.toString();
+    }
+    const title = step?.title || '';
+    const args = Array.isArray(step?.args) ? step.args.join(', ') : '';
+    return `${title}${args ? ` ${args}` : ''}`.trim();
+}
 // Helper functions for cleaner event handling
 function initializeTestDataStore() {
     if (!global.testomatioDataStore)

package/lib/bin/cli.js

@@ -45,6 +45,9 @@ program
     if (subOpts.filterList || subOpts.format) {
         process.env.TESTOMATIO_LOG_STDERR = '1';
         process.env.TESTOMATIO_LOG_LEVEL ||= 'WARN';
+        // with --format json the logs are machine-readable too: one JSON object per line on stderr
+        if (subOpts.format === 'json')
+            process.env.TESTOMATIO_LOG_JSON = '1';
     }
     else {
         console.log(picocolors_1.default.cyan(picocolors_1.default.bold(` 🤩 Testomat.io Reporter v${version}`)));
@@ -80,7 +83,7 @@ program
         };
     }
     await client.createRun(createRunParams);
-    const runId = client.pipeStore.runId || process.env.runId;
+    const runId = client.pipeStore.runId;
     if (!runId) {
         log_js_1.log.error(picocolors_1.default.red('Failed to create run on Testomat.io.'));
         process.exit(1);
@@ -90,7 +93,7 @@ program
     const plannedTests = (client.pipeStore.preparedTestIds || []).map(id => ({ test_id: id, title: id }));
     await client.updateRunStatus('pending', { tests: plannedTests });
     // stdout carries ONLY the run data so it can be captured: RUN_ID=$(reporter start)
-    console.log((0, pipe_utils_js_1.formatRunOutput)({ ...client.pipeStore, runId }, opts.format));
+    console.log((0, pipe_utils_js_1.formatRunOutput)(client.pipeStore, opts.format));
     process.exit(0);
 });
 program
@@ -226,16 +229,19 @@ program
         }
         if (apiKey) {
             await client.createRun(createRunParams);
-            const runId = process.env.TESTOMATIO_RUN || process.env.runId;
+            const runId = client.pipeStore.runId;
+            if (!runId) {
+                log_js_1.log.error(picocolors_1.default.red('Failed to create run on Testomat.io.'));
+                process.exit(1);
+            }
             if (client.pipeStore.runUrl)
                 log_js_1.log.info(`📊 Report URL: ${picocolors_1.default.magenta(client.pipeStore.runUrl)}`);
             if (opts.kind !== 'manual') {
                 log_js_1.log.info(`No command passed, so you need to run tests yourself:`);
                 log_js_1.log.info(`TESTOMATIO_RUN=${runId} <command>`);
             }
-            const runOutput = (0, pipe_utils_js_1.formatRunOutput)({ ...client.pipeStore, runId }, opts.format);
-            if (opts.format && runOutput)
-                console.log(runOutput);
+            if (opts.format)
+                console.log((0, pipe_utils_js_1.formatRunOutput)(client.pipeStore, opts.format));
         }
         else {
             log_js_1.log.info('⚠️  No API key provided. Cannot create run without TESTOMATIO key.');

package/lib/client.js

@@ -175,7 +175,7 @@ class Client {
             }
         }
         catch (err) {
-            console.error(constants_js_1.APP_PREFIX, 'Error in uploadStepArtifacts for testRid', testRid, ':', err);
+            log_js_1.log.error('Error in uploadStepArtifacts for testRid', testRid, ':', err.message || err);
             throw err;
         }
     }
@@ -209,7 +209,7 @@ class Client {
             await this.uploadStepArtifacts(steps, rid);
         }
         catch (err) {
-            console.log(constants_js_1.APP_PREFIX, 'Failed to upload step artifacts:', err);
+            log_js_1.log.error('Failed to upload step artifacts:', err.message || err);
         }
         const uploadedFiles = [];
         const stackArtifactsEnabled = (0, utils_js_1.transformEnvVarToBoolean)(process.env.TESTOMATIO_STACK_ARTIFACTS);
@@ -357,7 +357,7 @@ class Client {
                 }));
                 const pathPadding = Math.max(...failedUploads.map(upload => upload.relativePath.length)) + 1;
                 failedUploads.forEach(upload => {
-                    console.log(`  ${picocolors_1.default.gray('|')} 🔴 ${upload.relativePath.padEnd(pathPadding)} ${picocolors_1.default.gray(`| ${upload.sizePretty.padStart(filesizeStrMaxLength)} |`)}`);
+                    log_js_1.log.info(`  ${picocolors_1.default.gray('|')} 🔴 ${upload.relativePath.padEnd(pathPadding)} ${picocolors_1.default.gray(`| ${upload.sizePretty.padStart(filesizeStrMaxLength)} |`)}`);
                 });
             }
             if (this.uploader.skippedUploads.length) {
@@ -368,7 +368,7 @@ class Client {
                 }));
                 const pathPadding = Math.max(...skippedUploads.map(upload => upload.relativePath.length)) + 1;
                 skippedUploads.forEach(upload => {
-                    console.log(`  ${picocolors_1.default.gray('|')} 🟡 ${upload.relativePath.padEnd(pathPadding)} ${picocolors_1.default.gray(`| ${upload.sizePretty.padStart(filesizeStrMaxLength)} |`)}`);
+                    log_js_1.log.info(`  ${picocolors_1.default.gray('|')} 🟡 ${upload.relativePath.padEnd(pathPadding)} ${picocolors_1.default.gray(`| ${upload.sizePretty.padStart(filesizeStrMaxLength)} |`)}`);
                 });
             }
             if (this.uploader.skippedUploads.length || this.uploader.failedUploads.length) {

package/lib/pipe/csv.js

@@ -11,6 +11,7 @@ const picocolors_1 = __importDefault(require("picocolors"));
 const lodash_merge_1 = __importDefault(require("lodash.merge"));
 const utils_js_1 = require("../utils/utils.js");
 const constants_js_1 = require("../constants.js");
+const log_js_1 = require("../utils/log.js");
 const debug = (0, debug_1.default)('@testomatio/reporter:pipe:csv');
 /**
  * @typedef {import('../../types/types.js').Pipe} Pipe
@@ -68,10 +69,10 @@ class CsvPipe {
         // First, we check whether the export directory exists: if yes - OK, no - create it.
         this.checkExportDir();
         if (!this.outputFile) {
-            console.log(picocolors_1.default.yellow(`⚠️  CSV file is not set, ignoring`));
+            log_js_1.log.warn(picocolors_1.default.yellow(`⚠️  CSV file is not set, ignoring`));
             return;
         }
-        console.log(picocolors_1.default.yellow(`⏳ The test results will be added to the csv. It will take some time...`));
+        log_js_1.log.info(picocolors_1.default.yellow(`⏳ The test results will be added to the csv. It will take some time...`));
         try {
             // Create csv writer object
             const writer = (0, csv_writer_1.createObjectCsvWriter)({
@@ -82,7 +83,7 @@ class CsvPipe {
             return await writer.writeRecords(data);
         }
         catch (e) {
-            console.log('Unknown csv error: ', e);
+            log_js_1.log.error('Unknown csv error: ', e);
         }
     }
     /**
@@ -122,7 +123,7 @@ class CsvPipe {
         // Save results based on the default headers
         if (this.isEnabled) {
             await this.saveToCsv(this.results, constants_js_1.CSV_HEADERS);
-            console.log(picocolors_1.default.green(`🗃️  Recording completed! You can check the result in file = ${this.outputFile}`));
+            log_js_1.log.info(picocolors_1.default.green(`🗃️  Recording completed! You can check the result in file = ${this.outputFile}`));
         }
     }
     toString() {

package/lib/pipe/html.js

@@ -13,6 +13,7 @@ const marked_1 = require("marked");
 const file_url_1 = __importDefault(require("file-url"));
 const utils_js_1 = require("../utils/utils.js");
 const constants_js_1 = require("../constants.js");
+const log_js_1 = require("../utils/log.js");
 const node_url_1 = require("node:url");
 const debug = (0, debug_1.default)('@testomatio/reporter:pipe:html');
 const HTML_ARTIFACTS_DIR = 'artifacts';
@@ -120,12 +121,12 @@ class HtmlPipe {
         const { runParams, tests, outputPath, templatePath, warningMsg: msg } = opts;
         debug('HTML tests data:', tests);
         if (!outputPath) {
-            console.log(picocolors_1.default.yellow(`🚨 HTML export path is not set, ignoring...`));
+            log_js_1.log.warn(picocolors_1.default.yellow(`🚨 HTML export path is not set, ignoring...`));
             return;
         }
-        console.log(picocolors_1.default.yellow(`⏳ The test results will be added to the HTML report. It will take some time...`));
+        log_js_1.log.info(picocolors_1.default.yellow(`⏳ The test results will be added to the HTML report. It will take some time...`));
         if (msg) {
-            console.log(picocolors_1.default.blue(msg));
+            log_js_1.log.info(picocolors_1.default.blue(msg));
         }
         const aggregatedTests = aggregateTestRetries(tests);
         const copyLocalArtifacts = resolveHtmlCopyArtifacts(this.htmlCopyArtifacts);
@@ -237,10 +238,10 @@ class HtmlPipe {
             // Convert the file path to a file URL
             const fileUrlPath = (0, file_url_1.default)(absolutePath, { resolve: true });
             debug('HTML tests data:', fileUrlPath);
-            console.log(picocolors_1.default.green(`📊 The HTML report was successfully generated. Full filepath: ${fileUrlPath}`));
+            log_js_1.log.info(picocolors_1.default.green(`📊 The HTML report was successfully generated. Full filepath: ${fileUrlPath}`));
         }
         else {
-            console.log(picocolors_1.default.red(`🚨 Failed to generate the HTML report.`));
+            log_js_1.log.error(picocolors_1.default.red(`🚨 Failed to generate the HTML report.`));
         }
     }
     /**
@@ -251,7 +252,7 @@ class HtmlPipe {
      */
     #generateHTMLReport(data, templatePath = '') {
         if (!templatePath) {
-            console.log(picocolors_1.default.red(`🚨 HTML template not found. Report generation is impossible!`));
+            log_js_1.log.error(picocolors_1.default.red(`🚨 HTML template not found. Report generation is impossible!`));
             return;
         }
         const templateSource = fs_1.default.readFileSync(templatePath, 'utf8');
@@ -261,8 +262,8 @@ class HtmlPipe {
             return template(data);
         }
         catch (e) {
-            console.log(picocolors_1.default.red('❌ Oops! An unknown error occurred when generating an HTML report'));
-            console.log(picocolors_1.default.red(e));
+            log_js_1.log.error(picocolors_1.default.red('❌ Oops! An unknown error occurred when generating an HTML report'));
+            log_js_1.log.error(picocolors_1.default.red(e));
         }
     }
     #loadReportHelpers() {

package/lib/pipe/testomatio.d.ts

@@ -36,6 +36,7 @@ declare class TestomatioPipe implements Pipe {
     store: any;
     title: any;
     sharedRun: boolean;
+    sharedRunShards: number;
     sharedRunTimeout: number;
     groupTitle: any;
     env: string;

package/lib/pipe/testomatio.js

@@ -10,6 +10,7 @@ const json_cycle_1 = __importDefault(require("json-cycle"));
 const constants_js_1 = require("../constants.js");
 const utils_js_1 = require("../utils/utils.js");
 const pipe_utils_js_1 = require("../utils/pipe_utils.js");
+const hide_token_js_1 = require("../utils/hide_token.js");
 const config_js_1 = require("../config.js");
 const log_js_1 = require("../utils/log.js");
 const debug = (0, debug_1.default)('@testomatio/reporter:pipe:testomatio');
@@ -75,11 +76,14 @@ class TestomatioPipe {
         this.store = store || {};
         this.title = params.title || process.env.TESTOMATIO_TITLE;
         this.sharedRun = !!process.env.TESTOMATIO_SHARED_RUN;
+        this.sharedRunShards = process.env.TESTOMATIO_SHARDS
+            ? parseInt(process.env.TESTOMATIO_SHARDS, 10) || undefined
+            : undefined;
         this.sharedRunTimeout = process.env.TESTOMATIO_SHARED_RUN_TIMEOUT
             ? parseInt(process.env.TESTOMATIO_SHARED_RUN_TIMEOUT, 10)
             : undefined;
-        if (this.sharedRunTimeout && !this.sharedRun) {
-            debug('Auto-enabling sharedRun because sharedRunTimeout is set');
+        if ((this.sharedRunTimeout || this.sharedRunShards) && !this.sharedRun) {
+            debug('Auto-enabling sharedRun because sharedRunTimeout or sharedRunShards is set');
             this.sharedRun = true;
         }
         if (!this.title && (this.sharedRun || this.sharedRunTimeout)) {
@@ -289,6 +293,7 @@ class TestomatioPipe {
             label: this.label,
             shared_run: this.sharedRun,
             shared_run_timeout: this.sharedRunTimeout,
+            shared_run_shards: this.sharedRunShards,
             kind: params.kind,
             status: params.status,
             configuration,
@@ -346,14 +351,14 @@ class TestomatioPipe {
         }
         catch (err) {
             if (!this.apiKey)
-                console.error('Testomat.io API key is not set');
+                log_js_1.log.error('Testomat.io API key is not set');
             const errorText = err.response?.data?.message || err.message;
             debug('Error creating run', err);
-            console.log(constants_js_1.APP_PREFIX, errorText || err);
+            log_js_1.log.error(errorText || err);
             if (err.response?.status === 403)
                 this.#disablePipe();
             this.#logFailedResponse(err);
-            console.error(constants_js_1.APP_PREFIX, 'Error creating Testomat.io report (see details above), please check if your API key is valid. Skipping report');
+            log_js_1.log.error('Error creating Testomat.io report (see details above), please check if your API key is valid. Skipping report');
             printCreateIssue();
         }
         debug('"createRun" function finished');
@@ -370,7 +375,7 @@ class TestomatioPipe {
             this.reportingCanceledDueToReqFailures = true;
             let errorMessage = `⚠️ ${process.env.TESTOMATIO_MAX_REQUEST_FAILURES}`;
             errorMessage += ' requests were failed, reporting to Testomat aborted.';
-            console.warn(`${constants_js_1.APP_PREFIX} ${picocolors_1.default.yellow(errorMessage)}`);
+            log_js_1.log.warn(picocolors_1.default.yellow(errorMessage));
         }
         return cancelReporting;
     }
@@ -513,7 +518,7 @@ class TestomatioPipe {
         debug('Finishing run...');
         if (this.reportingCanceledDueToReqFailures) {
             const errorMessage = picocolors_1.default.red(`⚠️ Due to request failures, ${this.notReportedTestsCount} test(s) were not reported to Testomat.io`);
-            console.warn(`${constants_js_1.APP_PREFIX} ${errorMessage}`);
+            log_js_1.log.warn(errorMessage);
         }
         const { status } = params;
         // a pending run was just created: nothing to update here, only other pipes report it
@@ -526,6 +531,8 @@ class TestomatioPipe {
             status_event = 'pass';
         if (status === constants_js_1.STATUS.FAILED)
             status_event = 'fail';
+        if (this.sharedRun)
+            status_event = 'finish';
         try {
             if (this.runId && !this.proceed) {
                 await this.client.request({
@@ -561,7 +568,7 @@ class TestomatioPipe {
             }
         }
         catch (err) {
-            console.log(constants_js_1.APP_PREFIX, 'Error updating status, skipping...', err);
+            log_js_1.log.error('Error updating status, skipping...', err.message || err);
             this.#logFailedResponse(err);
             printCreateIssue();
         }
@@ -582,7 +589,7 @@ class TestomatioPipe {
         let responseBody = stringify(error.response?.data ?? error.response ?? error, { pretty: true });
         if (!responseBody)
             responseBody = '<empty>';
-        responseBody = hideTestomatioToken(responseBody);
+        responseBody = (0, hide_token_js_1.hideTestomatioToken)(responseBody);
         const statusCode = error.status || error.code || error.response?.status || '<unknown status code>';
         const method = error.response?.config?.method || '<unknown method>';
         const url = String(error.response?.config?.url || '<unknown url>');
@@ -600,18 +607,32 @@ class TestomatioPipe {
             message += `\t${picocolors_1.default.red(statusText)}\n`;
         }
         message += `\t${picocolors_1.default.bold('response: ')}${picocolors_1.default.gray(responseBody)}\n`;
-        const requestBody = hideTestomatioToken(stringify(error.response?.config?.data));
+        let requestBody = (0, hide_token_js_1.hideTestomatioToken)(stringify(error.response?.config?.data));
+        let requestTruncated = false;
         if (process.env.DEBUG || process.env.TESTOMATIO_DEBUG || requestBody.length < 1000) {
             // full body
             message += `\t${picocolors_1.default.bold('request: ')}${picocolors_1.default.gray(requestBody)}\n`;
         }
         else {
             // cut body
-            const requestBodyCut = requestBody.slice(0, 1000);
-            message += `\t${picocolors_1.default.bold('request: ')}${picocolors_1.default.gray(`${requestBodyCut}...`)}\n`;
+            requestTruncated = true;
+            requestBody = `${requestBody.slice(0, 1000)}...`;
+            message += `\t${picocolors_1.default.bold('request: ')}${picocolors_1.default.gray(requestBody)}\n`;
             message += '\trequest body is cut, run with TESTOMATIO_DEBUG=1 to see full body\n';
         }
-        console.log(message);
+        // the JSON line is built from the same values as the text message, with the token already hidden
+        const fields = {
+            status: statusCode,
+            method,
+            url,
+            error: apiMessage || statusText || undefined,
+            response: parseIfJson(responseBody),
+            request: parseIfJson(requestBody),
+        };
+        // a cut body is no longer valid JSON, so consumers are told why `request` is a string
+        if (requestTruncated)
+            fields.requestTruncated = true;
+        log_js_1.log.errorWithFields(fields, message);
         if (error.response?.data?.message?.includes('could not be matched')) {
             this.hasUnmatchedTests = true;
         }
@@ -626,20 +647,9 @@ function printCreateIssue() {
         return;
     registeredErrorHints = true;
     process.on('exit', () => {
-        console.log(constants_js_1.APP_PREFIX, 'There was an error reporting to Testomat.io.\n', picocolors_1.default.yellow('If you think this is a bug please create an issue: https://github.com/testomatio/reporter/issues/new.'), picocolors_1.default.yellow('Provide the logs from above'));
+        log_js_1.log.error('There was an error reporting to Testomat.io.\n', picocolors_1.default.yellow('If you think this is a bug please create an issue: https://github.com/testomatio/reporter/issues/new.'), picocolors_1.default.yellow('Provide the logs from above'));
     });
 }
-/**
- * Removes Testomatio token from string data
- *
- * @param {string} data
- * @returns {string}
- */
-function hideTestomatioToken(data) {
-    return (typeof data === 'string' ? data : '')
-        .replace(/"api_key"\s*:\s*"[^"]+"/g, '"api_key": "<hidden>"')
-        .replace(/"(tstmt_[^"]+)"/g, '"tstmt_***"');
-}
 /**
  * Stringifies provided data
  *
@@ -650,4 +660,18 @@ function hideTestomatioToken(data) {
 function stringify(anything, opts = { pretty: false }) {
     return typeof anything === 'string' ? anything : JSON.stringify(anything, null, opts.pretty ? 2 : undefined);
 }
+/**
+ * Turn a JSON string back into an object for structured logs; keeps the string if it is not JSON.
+ *
+ * @param {string} data
+ * @returns {any}
+ */
+function parseIfJson(data) {
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        return data;
+    }
+}
 module.exports = TestomatioPipe;

package/lib/utils/hide_token.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hides the Testomat.io API token in any data which is about to be printed or logged.
+ * Applied at the logger level, so a raw error object with a request body can't leak the token.
+ *
+ * @param {string} data
+ * @returns {string} The data with every token replaced, empty string if data is not a string.
+ */
+export function hideTestomatioToken(data: string): string;

package/lib/utils/hide_token.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hideTestomatioToken = hideTestomatioToken;
+/**
+ * Hides the Testomat.io API token in any data which is about to be printed or logged.
+ * Applied at the logger level, so a raw error object with a request body can't leak the token.
+ *
+ * @param {string} data
+ * @returns {string} The data with every token replaced, empty string if data is not a string.
+ */
+function hideTestomatioToken(data) {
+    if (typeof data !== 'string')
+        return '';
+    return data.replace(/"api_key"\s*:\s*"[^"]+"/g, '"api_key": "<hidden>"').replace(/tstmt_[\w-]+/g, 'tstmt_***');
+}
+
+module.exports.hideTestomatioToken = hideTestomatioToken;

package/lib/utils/log.d.ts

@@ -12,6 +12,12 @@ export function getLogLevel(): number;
  * @returns {boolean} True if the message should be logged
  */
 export function shouldLog(messageLevel: number): boolean;
+/**
+ * Check if logs should be printed as JSON lines instead of [TESTOMATIO] prefixed text.
+ * Enabled by the CLI for `--format json` so the whole output is machine-readable.
+ * @returns {boolean}
+ */
+export function isJsonOutput(): boolean;
 /**
  * Log an info message with [TESTOMATIO] prefix.
  * Only logs when TESTOMATIO_LOG_LEVEL is INFO.
@@ -30,6 +36,13 @@ export function warn(...args: any[]): void;
  * @param {...any} args - Arguments to log
  */
 export function error(...args: any[]): void;
+/**
+ * Log an error which carries structured data, e.g. a failed API request.
+ * The fields are added to the JSON line; in text mode only the message is printed.
+ * @param {Object} fields - Extra fields to add to the JSON object
+ * @param {...any} args - Arguments to log as text
+ */
+export function errorWithFields(fields: any, ...args: any[]): void;
 export namespace LOG_LEVELS {
     let ERROR: number;
     let WARN: number;
@@ -39,6 +52,8 @@ export namespace log {
     export { info };
     export { warn };
     export { error };
+    export { errorWithFields };
+    export { isJsonOutput };
     export { getLogLevel };
     export { shouldLog };
     export { LOG_LEVELS };

package/lib/utils/log.js

@@ -3,10 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.log = exports.LOG_LEVELS = void 0;
 exports.getLogLevel = getLogLevel;
 exports.shouldLog = shouldLog;
+exports.isJsonOutput = isJsonOutput;
 exports.info = info;
 exports.warn = warn;
 exports.error = error;
+exports.errorWithFields = errorWithFields;
+const util_1 = require("util");
 const constants_js_1 = require("../constants.js");
+const hide_token_js_1 = require("./hide_token.js");
 /**
  * Log levels for the Testomat.io reporter.
  * A message is logged if its level is <= the current log level.
@@ -39,16 +43,51 @@ function getLogLevel() {
 function shouldLog(messageLevel) {
     return messageLevel <= getLogLevel() || !!process.env.TESTOMATIO_DEBUG;
 }
+/**
+ * Check if logs should be printed as JSON lines instead of [TESTOMATIO] prefixed text.
+ * Enabled by the CLI for `--format json` so the whole output is machine-readable.
+ * @returns {boolean}
+ */
+function isJsonOutput() {
+    return process.env.TESTOMATIO_LOG_JSON === '1';
+}
+/**
+ * Render a log message as a single JSON line, e.g. `{"level":"error","message":"..."}`.
+ * Colors are stripped, so the message stays readable after parsing.
+ * @param {string} level - Log level name
+ * @param {any[]} args - Arguments as passed to the log function
+ * @param {Object} [fields] - Extra fields to add to the JSON object
+ * @returns {string}
+ */
+function jsonLine(level, args, fields = {}) {
+    const message = (0, util_1.stripVTControlCharacters)((0, util_1.format)(...args)).trim();
+    return (0, hide_token_js_1.hideTestomatioToken)(JSON.stringify({ ...fields, level, message }));
+}
+/**
+ * Render the arguments of a log function as text, with the API token hidden.
+ * Errors and other objects are formatted the way console does it.
+ * @param {any[]} args - Arguments as passed to the log function
+ * @returns {string}
+ */
+function textLine(args) {
+    return (0, hide_token_js_1.hideTestomatioToken)((0, util_1.format)(...args));
+}
 /**
  * Log an info message with [TESTOMATIO] prefix.
  * Only logs when TESTOMATIO_LOG_LEVEL is INFO.
  * @param {...any} args - Arguments to log
  */
 function info(...args) {
-    if (shouldLog(exports.LOG_LEVELS.INFO)) {
-        const fn = process.env.TESTOMATIO_LOG_STDERR === '1' ? console.error : console.log;
-        fn(constants_js_1.APP_PREFIX, ...args);
+    if (!shouldLog(exports.LOG_LEVELS.INFO))
+        return;
+    let fn = console.log;
+    if (process.env.TESTOMATIO_LOG_STDERR === '1')
+        fn = console.error;
+    if (isJsonOutput()) {
+        fn(jsonLine('info', args));
+        return;
     }
+    fn(constants_js_1.APP_PREFIX, textLine(args));
 }
 /**
  * Log a warning message with [TESTOMATIO] prefix.
@@ -56,9 +95,13 @@ function info(...args) {
  * @param {...any} args - Arguments to log
  */
 function warn(...args) {
-    if (shouldLog(exports.LOG_LEVELS.WARN)) {
-        console.warn(constants_js_1.APP_PREFIX, ...args);
+    if (!shouldLog(exports.LOG_LEVELS.WARN))
+        return;
+    if (isJsonOutput()) {
+        console.warn(jsonLine('warn', args));
+        return;
     }
+    console.warn(constants_js_1.APP_PREFIX, textLine(args));
 }
 /**
  * Log an error message with [TESTOMATIO] prefix.
@@ -66,9 +109,28 @@ function warn(...args) {
  * @param {...any} args - Arguments to log
  */
 function error(...args) {
-    if (shouldLog(exports.LOG_LEVELS.ERROR)) {
-        console.error(constants_js_1.APP_PREFIX, ...args);
+    if (!shouldLog(exports.LOG_LEVELS.ERROR))
+        return;
+    if (isJsonOutput()) {
+        console.error(jsonLine('error', args));
+        return;
     }
+    console.error(constants_js_1.APP_PREFIX, textLine(args));
+}
+/**
+ * Log an error which carries structured data, e.g. a failed API request.
+ * The fields are added to the JSON line; in text mode only the message is printed.
+ * @param {Object} fields - Extra fields to add to the JSON object
+ * @param {...any} args - Arguments to log as text
+ */
+function errorWithFields(fields, ...args) {
+    if (!shouldLog(exports.LOG_LEVELS.ERROR))
+        return;
+    if (isJsonOutput()) {
+        console.error(jsonLine('error', args, fields));
+        return;
+    }
+    console.error(constants_js_1.APP_PREFIX, textLine(args));
 }
 /**
  * Logging utility for Testomat.io reporter.
@@ -83,6 +145,8 @@ exports.log = {
     info,
     warn,
     error,
+    errorWithFields,
+    isJsonOutput,
     getLogLevel,
     shouldLog,
     LOG_LEVELS: exports.LOG_LEVELS,
@@ -92,8 +156,12 @@ module.exports.getLogLevel = getLogLevel;
 
 module.exports.shouldLog = shouldLog;
 
+module.exports.isJsonOutput = isJsonOutput;
+
 module.exports.info = info;
 
 module.exports.warn = warn;
 
 module.exports.error = error;
+
+module.exports.errorWithFields = errorWithFields;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testomatio/reporter",
-  "version": "2.15.0-beta.1-json-output",
+  "version": "2.16.0",
   "description": "Testomatio Reporter Client",
   "engines": {
     "node": ">=18"

package/src/adapter/codecept.js

@@ -34,7 +34,8 @@ const HOOK_EXECUTION_ORDER = {
 // codeceptjs workers are self-contained
 dataStorage.isFileStorage = false;
 
-const DATA_REGEXP = /[|\s]+?(\{".*\}|\[.*\])/;
+// CodeceptJS appends the serialized data row of a data-driven test to its title
+const DATA_REGEXP = / \| (\{.*\}|\[.*\]|null|"(?:\\.|[^"\\])*")((?:\s+@[a-zA-Z0-9-_]+)*)$/;
 
 if (MAJOR_VERSION < 3) {
   console.log('🔴 This reporter works with CodeceptJS 3+, please update your tests');
@@ -301,7 +302,7 @@ function CodeceptReporter(config) {
   });
 
   event.dispatcher.on(event.step.started, step => {
-    const stepText = `${repeat(output.stepShift)} ${step.toCliStyled ? step.toCliStyled() : step.toString()}`;
+    const stepText = `${repeat(output.stepShift)} ${formatStepLog(step)}`;
     dataStorage.putData('log', stepText);
   });
 
@@ -349,15 +350,30 @@ function stripExampleFromTitle(title) {
   const res = title.match(DATA_REGEXP);
   if (!res) return { title, example: null };
 
+  let example = null;
+  let exampleParsed = false;
   try {
-    const example = JSON.parse(res[1]);
-    title = title.replace(DATA_REGEXP, '').trim();
-    return { title, example };
+    example = JSON.parse(res[1]);
+    exampleParsed = true;
   } catch (e) {
-    // If JSON parsing fails, return title without example
-    debug('Failed to parse example JSON:', res[1], e.message);
-    return { title: title.replace(DATA_REGEXP, '').trim(), example: null };
+    try {
+      example = JSON.parse(res[1].slice(1, -1));
+      exampleParsed = true;
+    } catch (e2) {
+      debug('Failed to parse example from title:', res[1]);
+    }
+  }
+
+  let baseTitle = title.slice(0, res.index).trim();
+  if (exampleParsed && baseTitle.includes('${current}')) {
+    baseTitle = baseTitle.replaceAll('${current}', formatExample(example));
   }
+  return { title: `${baseTitle}${res[2]}`, example };
+}
+
+function formatExample(example) {
+  if (example !== null && typeof example === 'object') return JSON.stringify(example);
+  return String(example);
 }
 
 function stripTagsFromTitle(title) {
@@ -369,6 +385,18 @@ function repeat(num) {
   return ''.padStart(num, ' ');
 }
 
+function formatStepLog(step) {
+  if (typeof step?.toCliStyled === 'function') return step.toCliStyled();
+
+  if (typeof step?.toString === 'function' && step.toString !== Object.prototype.toString) {
+    return step.toString();
+  }
+
+  const title = step?.title || '';
+  const args = Array.isArray(step?.args) ? step.args.join(', ') : '';
+  return `${title}${args ? ` ${args}` : ''}`.trim();
+}
+
 // Helper functions for cleaner event handling
 function initializeTestDataStore() {
   if (!global.testomatioDataStore) global.testomatioDataStore = {};

package/src/bin/cli.js

@@ -43,6 +43,8 @@ program
     if (subOpts.filterList || subOpts.format) {
       process.env.TESTOMATIO_LOG_STDERR = '1';
       process.env.TESTOMATIO_LOG_LEVEL ||= 'WARN';
+      // with --format json the logs are machine-readable too: one JSON object per line on stderr
+      if (subOpts.format === 'json') process.env.TESTOMATIO_LOG_JSON = '1';
     } else {
       console.log(pc.cyan(pc.bold(` 🤩 Testomat.io Reporter v${version}`)));
     }
@@ -82,7 +84,7 @@ program
 
     await client.createRun(createRunParams);
 
-    const runId = client.pipeStore.runId || process.env.runId;
+    const runId = client.pipeStore.runId;
     if (!runId) {
       log.error(pc.red('Failed to create run on Testomat.io.'));
       process.exit(1);
@@ -94,7 +96,7 @@ program
     await client.updateRunStatus('pending', { tests: plannedTests });
 
     // stdout carries ONLY the run data so it can be captured: RUN_ID=$(reporter start)
-    console.log(formatRunOutput({ ...client.pipeStore, runId }, opts.format));
+    console.log(formatRunOutput(client.pipeStore, opts.format));
     process.exit(0);
   });
 
@@ -250,15 +252,20 @@ program
 
       if (apiKey) {
         await client.createRun(createRunParams);
-        const runId = process.env.TESTOMATIO_RUN || process.env.runId;
+
+        const runId = client.pipeStore.runId;
+        if (!runId) {
+          log.error(pc.red('Failed to create run on Testomat.io.'));
+          process.exit(1);
+        }
+
         if (client.pipeStore.runUrl) log.info( `📊 Report URL: ${pc.magenta(client.pipeStore.runUrl)}`);
 
         if (opts.kind !== 'manual') {
           log.info( `No command passed, so you need to run tests yourself:`);
           log.info( `TESTOMATIO_RUN=${runId} <command>`);
         }
-        const runOutput = formatRunOutput({ ...client.pipeStore, runId }, opts.format);
-        if (opts.format && runOutput) console.log(runOutput);
+        if (opts.format) console.log(formatRunOutput(client.pipeStore, opts.format));
       } else {
         log.info( '⚠️  No API key provided. Cannot create run without TESTOMATIO key.');
         process.exit(1);

package/src/client.js

@@ -187,7 +187,7 @@ class Client {
       }
 
     } catch (err) {
-      console.error(APP_PREFIX, 'Error in uploadStepArtifacts for testRid', testRid, ':', err);
+      log.error('Error in uploadStepArtifacts for testRid', testRid, ':', err.message || err);
       throw err;
     }
   }
@@ -225,7 +225,7 @@ class Client {
     try {
       await this.uploadStepArtifacts(steps, rid);
     } catch (err) {
-      console.log(APP_PREFIX, 'Failed to upload step artifacts:', err);
+      log.error('Failed to upload step artifacts:', err.message || err);
     }
 
     const uploadedFiles = [];
@@ -423,7 +423,7 @@ class Client {
           const pathPadding = Math.max(...failedUploads.map(upload => upload.relativePath.length)) + 1;
 
           failedUploads.forEach(upload => {
-            console.log(
+            log.info(
               `  ${pc.gray('|')} 🔴 ${upload.relativePath.padEnd(pathPadding)} ${pc.gray(
                 `| ${upload.sizePretty.padStart(filesizeStrMaxLength)} |`,
               )}`,
@@ -439,7 +439,7 @@ class Client {
           }));
           const pathPadding = Math.max(...skippedUploads.map(upload => upload.relativePath.length)) + 1;
           skippedUploads.forEach(upload => {
-            console.log(
+            log.info(
               `  ${pc.gray('|')} 🟡 ${upload.relativePath.padEnd(pathPadding)} ${pc.gray(
                 `| ${upload.sizePretty.padStart(filesizeStrMaxLength)} |`,
               )}`,

package/src/pipe/csv.js

@@ -6,6 +6,7 @@ import pc from 'picocolors';
 import merge from 'lodash.merge';
 import { isSameTest, getCurrentDateTime, ansiRegExp } from '../utils/utils.js';
 import { CSV_HEADERS } from '../constants.js';
+import { log } from '../utils/log.js';
 
 const debug = createDebugMessages('@testomatio/reporter:pipe:csv');
 /**
@@ -76,11 +77,11 @@ class CsvPipe {
     this.checkExportDir();
 
     if (!this.outputFile) {
-      console.log(pc.yellow(`⚠️  CSV file is not set, ignoring`));
+      log.warn(pc.yellow(`⚠️  CSV file is not set, ignoring`));
       return;
     }
 
-    console.log(pc.yellow(`⏳ The test results will be added to the csv. It will take some time...`));
+    log.info(pc.yellow(`⏳ The test results will be added to the csv. It will take some time...`));
 
     try {
       // Create csv writer object
@@ -91,7 +92,7 @@ class CsvPipe {
       // Save csv file based on the current data
       return await writer.writeRecords(data);
     } catch (e) {
-      console.log('Unknown csv error: ', e);
+      log.error('Unknown csv error: ', e);
     }
   }
 
@@ -135,7 +136,7 @@ class CsvPipe {
     // Save results based on the default headers
     if (this.isEnabled) {
       await this.saveToCsv(this.results, CSV_HEADERS);
-      console.log(pc.green(`🗃️  Recording completed! You can check the result in file = ${this.outputFile}`));
+      log.info(pc.green(`🗃️  Recording completed! You can check the result in file = ${this.outputFile}`));
     }
   }
 

package/src/pipe/html.js

@@ -8,6 +8,7 @@ import { marked } from 'marked';
 import fileUrl from 'file-url';
 import { fileSystem, isSameTest, ansiRegExp, formatStep, transformEnvVarToBoolean } from '../utils/utils.js';
 import { HTML_REPORT } from '../constants.js';
+import { log } from '../utils/log.js';
 import { fileURLToPath } from 'node:url';
 
 const debug = createDebugMessages('@testomatio/reporter:pipe:html');
@@ -144,14 +145,14 @@ class HtmlPipe {
     debug('HTML tests data:', tests);
 
     if (!outputPath) {
-      console.log(pc.yellow(`🚨 HTML export path is not set, ignoring...`));
+      log.warn(pc.yellow(`🚨 HTML export path is not set, ignoring...`));
       return;
     }
 
-    console.log(pc.yellow(`⏳ The test results will be added to the HTML report. It will take some time...`));
+    log.info(pc.yellow(`⏳ The test results will be added to the HTML report. It will take some time...`));
 
     if (msg) {
-      console.log(pc.blue(msg));
+      log.info(pc.blue(msg));
     }
 
     const aggregatedTests = aggregateTestRetries(tests);
@@ -295,9 +296,9 @@ class HtmlPipe {
 
       debug('HTML tests data:', fileUrlPath);
 
-      console.log(pc.green(`📊 The HTML report was successfully generated. Full filepath: ${fileUrlPath}`));
+      log.info(pc.green(`📊 The HTML report was successfully generated. Full filepath: ${fileUrlPath}`));
     } else {
-      console.log(pc.red(`🚨 Failed to generate the HTML report.`));
+      log.error(pc.red(`🚨 Failed to generate the HTML report.`));
     }
   }
 
@@ -309,7 +310,7 @@ class HtmlPipe {
    */
   #generateHTMLReport(data, templatePath = '') {
     if (!templatePath) {
-      console.log(pc.red(`🚨 HTML template not found. Report generation is impossible!`));
+      log.error(pc.red(`🚨 HTML template not found. Report generation is impossible!`));
       return;
     }
 
@@ -320,8 +321,8 @@ class HtmlPipe {
 
       return template(data);
     } catch (e) {
-      console.log(pc.red('❌ Oops! An unknown error occurred when generating an HTML report'));
-      console.log(pc.red(e));
+      log.error(pc.red('❌ Oops! An unknown error occurred when generating an HTML report'));
+      log.error(pc.red(e));
     }
   }
 

package/src/pipe/testomatio.js

@@ -18,6 +18,7 @@ import {
   getGitCommitSha,
 } from '../utils/utils.js';
 import { parseFilterParams, generateFilterRequestParams, setS3Credentials } from '../utils/pipe_utils.js';
+import { hideTestomatioToken } from '../utils/hide_token.js';
 import { config } from '../config.js';
 import { log } from '../utils/log.js';
 
@@ -87,12 +88,15 @@ class TestomatioPipe {
     this.store = store || {};
     this.title = params.title || process.env.TESTOMATIO_TITLE;
     this.sharedRun = !!process.env.TESTOMATIO_SHARED_RUN;
+    this.sharedRunShards = process.env.TESTOMATIO_SHARDS
+      ? parseInt(process.env.TESTOMATIO_SHARDS, 10) || undefined
+      : undefined;
     this.sharedRunTimeout = process.env.TESTOMATIO_SHARED_RUN_TIMEOUT
       ? parseInt(process.env.TESTOMATIO_SHARED_RUN_TIMEOUT, 10)
       : undefined;
 
-    if (this.sharedRunTimeout && !this.sharedRun) {
-      debug('Auto-enabling sharedRun because sharedRunTimeout is set');
+    if ((this.sharedRunTimeout || this.sharedRunShards) && !this.sharedRun) {
+      debug('Auto-enabling sharedRun because sharedRunTimeout or sharedRunShards is set');
       this.sharedRun = true;
     }
 
@@ -322,6 +326,7 @@ class TestomatioPipe {
         label: this.label,
         shared_run: this.sharedRun,
         shared_run_timeout: this.sharedRunTimeout,
+        shared_run_shards: this.sharedRunShards,
         kind: params.kind,
         status: params.status,
         configuration,
@@ -380,16 +385,15 @@ class TestomatioPipe {
       process.env.runId = this.runId;
       debug('Run created', this.runId);
     } catch (err) {
-      if (!this.apiKey) console.error('Testomat.io API key is not set');
+      if (!this.apiKey) log.error('Testomat.io API key is not set');
       const errorText = err.response?.data?.message || err.message;
       debug('Error creating run', err);
-      console.log(APP_PREFIX, errorText || err);
+      log.error(errorText || err);
       if (err.response?.status === 403) this.#disablePipe();
 
       this.#logFailedResponse(err);
 
-      console.error(
-        APP_PREFIX,
+      log.error(
         'Error creating Testomat.io report (see details above), please check if your API key is valid. Skipping report',
       );
       printCreateIssue();
@@ -409,7 +413,7 @@ class TestomatioPipe {
       this.reportingCanceledDueToReqFailures = true;
       let errorMessage = `⚠️ ${process.env.TESTOMATIO_MAX_REQUEST_FAILURES}`;
       errorMessage += ' requests were failed, reporting to Testomat aborted.';
-      console.warn(`${APP_PREFIX} ${pc.yellow(errorMessage)}`);
+      log.warn(pc.yellow(errorMessage));
     }
     return cancelReporting;
   }
@@ -557,7 +561,7 @@ class TestomatioPipe {
       const errorMessage = pc.red(
         `⚠️ Due to request failures, ${this.notReportedTestsCount} test(s) were not reported to Testomat.io`,
       );
-      console.warn(`${APP_PREFIX} ${errorMessage}`);
+      log.warn(errorMessage);
     }
 
     const { status } = params;
@@ -570,6 +574,7 @@ class TestomatioPipe {
     if (status === STATUS.FINISHED) status_event = 'finish';
     if (status === STATUS.PASSED) status_event = 'pass';
     if (status === STATUS.FAILED) status_event = 'fail';
+    if (this.sharedRun) status_event = 'finish';
 
     try {
       if (this.runId && !this.proceed) {
@@ -621,7 +626,7 @@ class TestomatioPipe {
         );
       }
     } catch (err) {
-      console.log(APP_PREFIX, 'Error updating status, skipping...', err);
+      log.error('Error updating status, skipping...', err.message || err);
       this.#logFailedResponse(err);
       printCreateIssue();
     }
@@ -665,18 +670,32 @@ class TestomatioPipe {
 
     message += `\t${pc.bold('response: ')}${pc.gray(responseBody)}\n`;
 
-    const requestBody = hideTestomatioToken(stringify(error.response?.config?.data));
+    let requestBody = hideTestomatioToken(stringify(error.response?.config?.data));
+    let requestTruncated = false;
     if (process.env.DEBUG || process.env.TESTOMATIO_DEBUG || requestBody.length < 1000) {
       // full body
       message += `\t${pc.bold('request: ')}${pc.gray(requestBody)}\n`;
     } else {
       // cut body
-      const requestBodyCut = requestBody.slice(0, 1000);
-      message += `\t${pc.bold('request: ')}${pc.gray(`${requestBodyCut}...`)}\n`;
+      requestTruncated = true;
+      requestBody = `${requestBody.slice(0, 1000)}...`;
+      message += `\t${pc.bold('request: ')}${pc.gray(requestBody)}\n`;
       message += '\trequest body is cut, run with TESTOMATIO_DEBUG=1 to see full body\n';
     }
 
-    console.log(message);
+    // the JSON line is built from the same values as the text message, with the token already hidden
+    const fields = {
+      status: statusCode,
+      method,
+      url,
+      error: apiMessage || statusText || undefined,
+      response: parseIfJson(responseBody),
+      request: parseIfJson(requestBody),
+    };
+    // a cut body is no longer valid JSON, so consumers are told why `request` is a string
+    if (requestTruncated) fields.requestTruncated = true;
+
+    log.errorWithFields(fields, message);
 
     if (error.response?.data?.message?.includes('could not be matched')) {
       this.hasUnmatchedTests = true;
@@ -693,8 +712,7 @@ function printCreateIssue() {
   if (registeredErrorHints) return;
   registeredErrorHints = true;
   process.on('exit', () => {
-    console.log(
-      APP_PREFIX,
+    log.error(
       'There was an error reporting to Testomat.io.\n',
       pc.yellow(
         'If you think this is a bug please create an issue: https://github.com/testomatio/reporter/issues/new.',
@@ -704,18 +722,6 @@ function printCreateIssue() {
   });
 }
 
-/**
- * Removes Testomatio token from string data
- *
- * @param {string} data
- * @returns {string}
- */
-function hideTestomatioToken(data) {
-  return (typeof data === 'string' ? data : '')
-    .replace(/"api_key"\s*:\s*"[^"]+"/g, '"api_key": "<hidden>"')
-    .replace(/"(tstmt_[^"]+)"/g, '"tstmt_***"');
-}
-
 /**
  * Stringifies provided data
  *
@@ -727,4 +733,18 @@ function stringify(anything, opts = { pretty: false }) {
   return typeof anything === 'string' ? anything : JSON.stringify(anything, null, opts.pretty ? 2 : undefined);
 }
 
+/**
+ * Turn a JSON string back into an object for structured logs; keeps the string if it is not JSON.
+ *
+ * @param {string} data
+ * @returns {any}
+ */
+function parseIfJson(data) {
+  try {
+    return JSON.parse(data);
+  } catch {
+    return data;
+  }
+}
+
 export default TestomatioPipe;

package/src/utils/hide_token.js

@@ -0,0 +1,12 @@
+/**
+ * Hides the Testomat.io API token in any data which is about to be printed or logged.
+ * Applied at the logger level, so a raw error object with a request body can't leak the token.
+ *
+ * @param {string} data
+ * @returns {string} The data with every token replaced, empty string if data is not a string.
+ */
+export function hideTestomatioToken(data) {
+  if (typeof data !== 'string') return '';
+
+  return data.replace(/"api_key"\s*:\s*"[^"]+"/g, '"api_key": "<hidden>"').replace(/tstmt_[\w-]+/g, 'tstmt_***');
+}

package/src/utils/log.js

@@ -1,4 +1,6 @@
+import { format as formatArgs, stripVTControlCharacters } from 'util';
 import { APP_PREFIX } from '../constants.js';
+import { hideTestomatioToken } from './hide_token.js';
 
 /**
  * Log levels for the Testomat.io reporter.
@@ -35,16 +37,54 @@ export function shouldLog(messageLevel) {
   return messageLevel <= getLogLevel() || !!process.env.TESTOMATIO_DEBUG;
 }
 
+/**
+ * Check if logs should be printed as JSON lines instead of [TESTOMATIO] prefixed text.
+ * Enabled by the CLI for `--format json` so the whole output is machine-readable.
+ * @returns {boolean}
+ */
+export function isJsonOutput() {
+  return process.env.TESTOMATIO_LOG_JSON === '1';
+}
+
+/**
+ * Render a log message as a single JSON line, e.g. `{"level":"error","message":"..."}`.
+ * Colors are stripped, so the message stays readable after parsing.
+ * @param {string} level - Log level name
+ * @param {any[]} args - Arguments as passed to the log function
+ * @param {Object} [fields] - Extra fields to add to the JSON object
+ * @returns {string}
+ */
+function jsonLine(level, args, fields = {}) {
+  const message = stripVTControlCharacters(formatArgs(...args)).trim();
+  return hideTestomatioToken(JSON.stringify({ ...fields, level, message }));
+}
+
+/**
+ * Render the arguments of a log function as text, with the API token hidden.
+ * Errors and other objects are formatted the way console does it.
+ * @param {any[]} args - Arguments as passed to the log function
+ * @returns {string}
+ */
+function textLine(args) {
+  return hideTestomatioToken(formatArgs(...args));
+}
+
 /**
  * Log an info message with [TESTOMATIO] prefix.
  * Only logs when TESTOMATIO_LOG_LEVEL is INFO.
  * @param {...any} args - Arguments to log
  */
 export function info(...args) {
-  if (shouldLog(LOG_LEVELS.INFO)) {
-    const fn = process.env.TESTOMATIO_LOG_STDERR === '1' ? console.error : console.log;
-    fn(APP_PREFIX, ...args);
+  if (!shouldLog(LOG_LEVELS.INFO)) return;
+
+  let fn = console.log;
+  if (process.env.TESTOMATIO_LOG_STDERR === '1') fn = console.error;
+
+  if (isJsonOutput()) {
+    fn(jsonLine('info', args));
+    return;
   }
+  fn(APP_PREFIX, textLine(args));
 }
 
 /**
@@ -53,9 +93,13 @@ export function info(...args) {
  * @param {...any} args - Arguments to log
  */
 export function warn(...args) {
-  if (shouldLog(LOG_LEVELS.WARN)) {
-    console.warn(APP_PREFIX, ...args);
+  if (!shouldLog(LOG_LEVELS.WARN)) return;
+
+  if (isJsonOutput()) {
+    console.warn(jsonLine('warn', args));
+    return;
   }
+  console.warn(APP_PREFIX, textLine(args));
 }
 
 /**
@@ -64,9 +108,29 @@ export function warn(...args) {
  * @param {...any} args - Arguments to log
  */
 export function error(...args) {
-  if (shouldLog(LOG_LEVELS.ERROR)) {
-    console.error(APP_PREFIX, ...args);
+  if (!shouldLog(LOG_LEVELS.ERROR)) return;
+
+  if (isJsonOutput()) {
+    console.error(jsonLine('error', args));
+    return;
+  }
+  console.error(APP_PREFIX, textLine(args));
+}
+
+/**
+ * Log an error which carries structured data, e.g. a failed API request.
+ * The fields are added to the JSON line; in text mode only the message is printed.
+ * @param {Object} fields - Extra fields to add to the JSON object
+ * @param {...any} args - Arguments to log as text
+ */
+export function errorWithFields(fields, ...args) {
+  if (!shouldLog(LOG_LEVELS.ERROR)) return;
+
+  if (isJsonOutput()) {
+    console.error(jsonLine('error', args, fields));
+    return;
   }
+  console.error(APP_PREFIX, textLine(args));
 }
 
 /**
@@ -82,6 +146,8 @@ export const log = {
   info,
   warn,
   error,
+  errorWithFields,
+  isJsonOutput,
   getLogLevel,
   shouldLog,
   LOG_LEVELS,