@testomatio/reporter 2.8.0 → 2.8.2

package/lib/adapter/codecept.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CodeceptReporter = CodeceptReporter;
 const debug_1 = __importDefault(require("debug"));
+const path_1 = __importDefault(require("path"));
 const picocolors_1 = __importDefault(require("picocolors"));
 const client_js_1 = __importDefault(require("../client.js"));
 const constants_js_1 = require("../constants.js");
@@ -47,8 +48,8 @@ function CodeceptReporter(config) {
     const reportTestPromises = [];
     let isRunFinalized = false;
     const testTimeMap = {};
-    const { apiKey } = config;
-    const client = new client_js_1.default({ apiKey });
+    const clientConfig = buildCodeceptClientConfig(config);
+    const client = new client_js_1.default(clientConfig);
     // Store original output methods for fallback
     const originalOutput = {
         debug: output.debug,
@@ -492,5 +493,40 @@ function formatHookStep(step) {
     return formattedStep;
 }
 module.exports = CodeceptReporter;
+function buildCodeceptClientConfig(config = {}) {
+    const outputDir = resolveCodeceptOutputDir(config);
+    const reportDir = resolveCodeceptReportDir(config, outputDir);
+    return {
+        ...config,
+        apiKey: config.apiKey,
+        framework: 'codeceptjs',
+        outputDir,
+        reportDir,
+        html: config.html,
+        markdown: config.markdown,
+        csv: config.csv,
+    };
+}
+function resolveCodeceptOutputDir(config = {}) {
+    const codeceptStore = /** @type {{ outputDir?: string }} */ (codeceptjs_1.default.store || {});
+    const candidates = [
+        config.outputDir,
+        config.output,
+        codeceptStore.outputDir,
+        codecept?.config?.get?.()?.output,
+        codecept?.config?.output,
+    ];
+    const outputDir = candidates.find(value => typeof value === 'string' && value.trim());
+    return outputDir || 'output';
+}
+function resolveCodeceptReportDir(config = {}, outputDir = 'output') {
+    if (typeof config.reportDir === 'string' && config.reportDir.trim()) {
+        return config.reportDir;
+    }
+    if (path_1.default.isAbsolute(outputDir)) {
+        return path_1.default.join(outputDir, 'report');
+    }
+    return path_1.default.join(outputDir, 'report');
+}
 
 module.exports.CodeceptReporter = CodeceptReporter;

package/lib/bin/cli.js

@@ -103,9 +103,11 @@ program
             const filteredCommand = (0, utils_js_1.applyFilter)(command, tests);
             debug(`Execution pattern: "${pattern}"`);
             if (opts.filterList) {
-                log_js_1.log.info(picocolors_1.default.blue(`Matched test/suite IDs: ${tests.join(', ')}`));
                 if (command)
                     log_js_1.log.info(picocolors_1.default.green(`Full Running Command: ${filteredCommand}`));
+                console.log();
+                console.log(`Grep string:`);
+                console.log(`${tests.join(', ')}`);
                 return;
             }
             if (command && command.split) {

package/lib/client.js

@@ -105,8 +105,9 @@ class Client {
      * @returns {Promise<any>} - resolves to Run id which should be used to update / add test
      */
     async createRun(params = {}) {
+        const pipeParams = { ...(this.paramsForPipesFactory || {}), ...(params || {}) };
         if (!this.pipes || !this.pipes.length)
-            this.pipes = await (0, index_js_1.pipesFactory)(params || this.paramsForPipesFactory || {}, this.pipeStore);
+            this.pipes = await (0, index_js_1.pipesFactory)(pipeParams, this.pipeStore);
         debug('Creating run...');
         // all pipes disabled, skipping
         if (!this.pipes?.filter(p => p.isEnabled).length)

package/lib/pipe/bitbucket.d.ts

@@ -10,6 +10,7 @@ export class BitbucketPipe {
     store: {};
     tests: any[];
     token: any;
+    description: any;
     hiddenCommentData: string;
     client: Gaxios;
     cleanLog(log: any): Promise<string>;

package/lib/pipe/bitbucket.js

@@ -63,6 +63,7 @@ class BitbucketPipe {
         this.tests = [];
         // Bitbucket PAT looks like bbpat-*****
         this.token = params.BITBUCKET_ACCESS_TOKEN || process.env.BITBUCKET_ACCESS_TOKEN || this.ENV.BITBUCKET_ACCESS_TOKEN;
+        this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
         this.hiddenCommentData = `Testomat.io report: ${process.env.BITBUCKET_BRANCH || ''}`;
         debug(picocolors_1.default.yellow('Bitbucket Pipe:'), this.token ? 'TOKEN passed' : '*no token*', `Project key: ${this.ENV.BITBUCKET_PROJECT_KEY}, Pull request ID: ${this.ENV.BITBUCKET_PR_ID}`);
         if (!this.token) {
@@ -168,6 +169,9 @@ class BitbucketPipe {
             return text;
         });
         let body = summary;
+        if (this.description) {
+            body += `\n\n> ${(0, utils_js_1.truncate)(this.description, 1024).replace(/\r?\n/g, '\n> ')}`;
+        }
         if (failures.length) {
             body += `\n🟥 **Failures (${failures.length})**\n\n* ${failures.join('\n* ')}\n`;
             if (failures.length > 10) {

package/lib/pipe/csv.d.ts

@@ -12,9 +12,9 @@ declare class CsvPipe implements Pipe {
     store: any;
     title: any;
     results: any[];
-    outputDir: string;
+    outputDir: any;
     defaultReportName: string;
-    csvFilename: string;
+    csvFilename: any;
     isEnabled: boolean;
     outputFile: string;
     prepareRun(): Promise<void>;
@@ -23,7 +23,7 @@ declare class CsvPipe implements Pipe {
     /**
      * Create a folder that will contain the exported files
      */
-    checkExportDir(): void;
+    checkExportDir(): string;
     /**
      * Save data to the csv file.
      * @param {Object} data - data that will be added to the CSV file.

package/lib/pipe/csv.js

@@ -23,9 +23,12 @@ class CsvPipe {
         this.store = store || {};
         this.title = params.title || process.env.TESTOMATIO_TITLE;
         this.results = [];
-        this.outputDir = 'export';
+        this.outputDir = params.reportDir || 'export';
+        if (process.env.TESTOMATIO_RUNGROUP_TITLE) {
+            this.outputDir = path_1.default.join(this.outputDir, process.env.TESTOMATIO_RUNGROUP_TITLE);
+        }
         this.defaultReportName = 'report.csv';
-        this.csvFilename = process.env.TESTOMATIO_CSV_FILENAME;
+        this.csvFilename = resolveCsvFilename(params);
         this.isEnabled = false;
         if (this.csvFilename) {
             const filenameParts = this.csvFilename.split('.');
@@ -51,7 +54,7 @@ class CsvPipe {
      */
     checkExportDir() {
         if (!fs_1.default.existsSync(this.outputDir)) {
-            return fs_1.default.mkdirSync(this.outputDir);
+            return fs_1.default.mkdirSync(this.outputDir, { recursive: true });
         }
     }
     /**
@@ -127,3 +130,14 @@ class CsvPipe {
     }
 }
 module.exports = CsvPipe;
+function resolveCsvFilename(params = {}) {
+    if (typeof params.csvFilename === 'string' && params.csvFilename.trim()) {
+        return params.csvFilename;
+    }
+    if (typeof process.env.TESTOMATIO_CSV_FILENAME === 'string' && process.env.TESTOMATIO_CSV_FILENAME.trim()) {
+        return process.env.TESTOMATIO_CSV_FILENAME;
+    }
+    if (params.csv)
+        return 'report.csv';
+    return null;
+}

package/lib/pipe/github.d.ts

@@ -13,6 +13,7 @@ declare class GitHubPipe implements Pipe {
     store: {};
     tests: any[];
     token: any;
+    description: any;
     ref: string;
     repo: string;
     jobKey: string;

package/lib/pipe/github.js

@@ -58,6 +58,7 @@ class GitHubPipe {
         this.store = store;
         this.tests = [];
         this.token = params.GH_PAT || process.env.GH_PAT;
+        this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
         this.ref = process.env.GITHUB_REF;
         this.repo = process.env.GITHUB_REPOSITORY;
         this.jobKey = `${process.env.GITHUB_WORKFLOW || ''} / ${process.env.GITHUB_JOB || ''}`;
@@ -154,6 +155,9 @@ class GitHubPipe {
             return text;
         });
         let body = summary;
+        if (this.description) {
+            body += `\n\n> ${(0, utils_js_1.truncate)(this.description, 1024).replace(/\r?\n/g, '\n> ')}`;
+        }
         const coverageConfiguration = this.store?.coverageConfiguration;
         const isManualRun = this.store?.runKind === 'manual';
         if (isManualRun && coverageConfiguration) {

package/lib/pipe/gitlab.d.ts

@@ -13,6 +13,7 @@ declare class GitLabPipe {
     store: {};
     tests: any[];
     token: any;
+    description: any;
     hiddenCommentData: string;
     client: Gaxios;
     prepareRun(): Promise<void>;

package/lib/pipe/gitlab.js

@@ -29,6 +29,7 @@ class GitLabPipe {
         this.tests = [];
         // GitLab PAT looks like glpat-nKGdja3jsG4850sGksh7
         this.token = params.GITLAB_PAT || process.env.GITLAB_PAT || this.ENV.GITLAB_PAT;
+        this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
         this.hiddenCommentData = `<!--- testomat.io report ${process.env.CI_JOB_NAME || ''} -->`;
         debug(picocolors_1.default.yellow('GitLab Pipe:'), this.token ? 'TOKEN passed' : '*no token*', `Project id: ${this.ENV.CI_PROJECT_ID}, MR id: ${this.ENV.CI_MERGE_REQUEST_IID}`);
         if (!this.ENV.CI_PROJECT_ID || !this.ENV.CI_MERGE_REQUEST_IID) {
@@ -116,6 +117,9 @@ class GitLabPipe {
             return text;
         });
         let body = summary;
+        if (this.description) {
+            body += `\n\n> ${(0, utils_js_1.truncate)(this.description, 1024).replace(/\r?\n/g, '\n> ')}`;
+        }
         if (failures.length) {
             body += `\n<details>\n<summary><h3>🟥 Failures (${failures.length})</h4></summary>\n\n${failures.join('\n')}\n`;
             if (failures.length > 20) {

package/lib/pipe/html.d.ts

@@ -3,14 +3,15 @@ declare class HtmlPipe {
     constructor(params: any, store?: {});
     store: {};
     title: any;
+    description: any;
     apiKey: any;
-    isHtml: string;
+    isHtml: any;
     isEnabled: boolean;
     htmlOutputPath: string;
     filenameMsg: string;
     tests: any[];
     configuration: any;
-    htmlReportDir: string;
+    htmlReportDir: any;
     htmlReportName: string;
     templateFolderPath: string;
     templateHtmlPath: string;

package/lib/pipe/html.js

@@ -20,8 +20,9 @@ class HtmlPipe {
     constructor(params, store = {}) {
         this.store = store || {};
         this.title = params.title || process.env.TESTOMATIO_TITLE;
+        this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
         this.apiKey = params.apiKey || process.env.TESTOMATIO;
-        this.isHtml = process.env.TESTOMATIO_HTML_REPORT_SAVE;
+        this.isHtml = params.html ?? process.env.TESTOMATIO_HTML_REPORT_SAVE;
         debug('HTML Pipe: ', this.apiKey ? 'API KEY' : '*no api key provided*');
         this.isEnabled = false;
         this.htmlOutputPath = '';
@@ -30,7 +31,10 @@ class HtmlPipe {
         this.configuration = null;
         if (this.isHtml) {
             this.isEnabled = true;
-            this.htmlReportDir = process.env.TESTOMATIO_HTML_REPORT_FOLDER || constants_js_1.HTML_REPORT.FOLDER;
+            this.htmlReportDir = params.reportDir || process.env.TESTOMATIO_HTML_REPORT_FOLDER || constants_js_1.HTML_REPORT.FOLDER;
+            if (process.env.TESTOMATIO_RUNGROUP_TITLE) {
+                this.htmlReportDir = path_1.default.join(this.htmlReportDir, process.env.TESTOMATIO_RUNGROUP_TITLE);
+            }
             if (process.env.TESTOMATIO_HTML_FILENAME && process.env.TESTOMATIO_HTML_FILENAME.endsWith('.html')) {
                 this.htmlReportName = process.env.TESTOMATIO_HTML_FILENAME;
             }
@@ -204,7 +208,9 @@ class HtmlPipe {
             runUrl: this.store.runUrl || '',
             executionTime: testExecutionSumTime(aggregatedTests),
             executionDate: getCurrentDateTimeFormatted(),
-            description: runParams.description || this.store.coverageDescription || this.store.description || '',
+            description: [runParams.description || this.store.coverageDescription || this.store.description, this.description]
+                .filter(Boolean)
+                .join('\n\n') || '',
             configuration: buildDisplayConfiguration(this.configuration || this.store.configuration || runParams.configuration || null),
             tests: aggregatedTests,
             envVars: collectEnvironmentVariables(),

package/lib/pipe/markdown.d.ts

@@ -3,14 +3,15 @@ declare class MarkdownPipe {
     constructor(params: any, store?: {});
     store: {};
     title: any;
+    description: any;
     apiKey: any;
-    isMarkdown: string;
+    isMarkdown: any;
     isEnabled: boolean;
     markdownOutputPath: string;
     filenameMsg: string;
     tests: any[];
     configuration: any;
-    markdownReportDir: string;
+    markdownReportDir: any;
     markdownReportName: string;
     createRun(params?: {}): Promise<void>;
     prepareRun(): Promise<void>;

package/lib/pipe/markdown.js

@@ -17,8 +17,9 @@ class MarkdownPipe {
     constructor(params, store = {}) {
         this.store = store || {};
         this.title = params.title || process.env.TESTOMATIO_TITLE;
+        this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
         this.apiKey = params.apiKey || process.env.TESTOMATIO;
-        this.isMarkdown = process.env.TESTOMATIO_MARKDOWN_REPORT_SAVE;
+        this.isMarkdown = params.markdown ?? process.env.TESTOMATIO_MARKDOWN_REPORT_SAVE;
         debug('Markdown Pipe: ', this.apiKey ? 'API KEY' : '*no api key provided*');
         this.isEnabled = false;
         this.markdownOutputPath = '';
@@ -28,7 +29,11 @@ class MarkdownPipe {
         if (!this.isMarkdown)
             return;
         this.isEnabled = true;
-        this.markdownReportDir = process.env.TESTOMATIO_MARKDOWN_REPORT_FOLDER || constants_js_1.MARKDOWN_REPORT.FOLDER;
+        this.markdownReportDir =
+            params.reportDir || process.env.TESTOMATIO_MARKDOWN_REPORT_FOLDER || constants_js_1.MARKDOWN_REPORT.FOLDER;
+        if (process.env.TESTOMATIO_RUNGROUP_TITLE) {
+            this.markdownReportDir = path_1.default.join(this.markdownReportDir, process.env.TESTOMATIO_RUNGROUP_TITLE);
+        }
         const envName = process.env.TESTOMATIO_MARKDOWN_FILENAME;
         if (envName && envName.endsWith('.md')) {
             this.markdownReportName = envName;
@@ -112,7 +117,9 @@ class MarkdownPipe {
             isParallel: runParams?.isParallel,
             executionTime: testExecutionSumTime(aggregated),
             executionDate: getCurrentDateTimeFormatted(),
-            description: runParams?.description || this.store.coverageDescription || this.store.description || '',
+            description: [runParams?.description || this.store.coverageDescription || this.store.description, this.description]
+                .filter(Boolean)
+                .join('\n\n') || '',
             configuration: this.configuration || this.store.configuration || runParams?.configuration || null,
             tests: aggregated,
             stats,

package/lib/pipe/testomatio.d.ts

@@ -30,6 +30,7 @@ declare class TestomatioPipe implements Pipe {
     groupTitle: any;
     env: string;
     label: string;
+    description: any;
     client: Gaxios;
     proceed: boolean;
     jiraId: string;

package/lib/pipe/testomatio.js

@@ -67,6 +67,7 @@ class TestomatioPipe {
         this.groupTitle = params.groupTitle || process.env.TESTOMATIO_RUNGROUP_TITLE;
         this.env = process.env.TESTOMATIO_ENV;
         this.label = process.env.TESTOMATIO_LABEL;
+        this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
         // Create a new instance of gaxios with a custom config
         this.client = new gaxios_1.Gaxios({
             baseURL: `${this.url.trim()}`,
@@ -193,15 +194,17 @@ class TestomatioPipe {
             buildUrl = undefined;
         const accessEvent = process.env.TESTOMATIO_PUBLISH ? 'publish' : null;
         const coverageConfiguration = this.store?.coverageConfiguration;
-        let description = null;
+        let coverageDescription = null;
         let configuration = null;
         if (coverageConfiguration && (coverageConfiguration.tests?.length || coverageConfiguration.suites?.length)) {
-            description = this.store?.coverageDescription || null;
+            coverageDescription = this.store?.coverageDescription || null;
             configuration = {
                 tests: coverageConfiguration.tests?.map(id => id.replace(/^T/, '')) || [],
                 suites: coverageConfiguration.suites?.map(id => id.replace(/^S/, '')) || [],
             };
         }
+        // Run description: coverage-derived block (if any) with the user-provided TESTOMATIO_DESCRIPTION appended after it.
+        const description = [coverageDescription, this.description].filter(Boolean).join('\n\n') || null;
         // Merge caller-supplied configuration (e.g. { exploratory: true }) into runParams.configuration.
         // Caller values win on key conflict; coverage-derived tests/suites lists are preserved when not overridden.
         if (params.configuration && typeof params.configuration === 'object') {
@@ -509,11 +512,19 @@ class TestomatioPipe {
         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>');
+        const statusText = error.response?.statusText || '';
         let message = picocolors_1.default.yellow('⚠️ Request to Testomat.io failed:\n');
         message += picocolors_1.default.bold(`${picocolors_1.default.red(statusCode)} ${method} ${picocolors_1.default.gray(url)}\n`);
+        const apiMessage = error.response?.data?.message;
         if (statusCode === 403) {
             message += `\t${picocolors_1.default.red('Please check your API token. It might be invalid or expired.')}\n`;
         }
+        else if (apiMessage) {
+            message += `\t${picocolors_1.default.red(apiMessage)}\n`;
+        }
+        else if (statusText) {
+            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));
         if (process.env.DEBUG || process.env.TESTOMATIO_DEBUG || requestBody.length < 1000) {

package/package.json

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

package/src/adapter/codecept.js

@@ -1,4 +1,5 @@
 import createDebugMessages from 'debug';
+import path from 'path';
 import pc from 'picocolors';
 import TestomatClient from '../client.js';
 import { STATUS, APP_PREFIX, TESTOMAT_TMP_STORAGE_DIR, SCREENSHOTS_ON_STEPS } from '../constants.js';
@@ -53,9 +54,8 @@ function CodeceptReporter(config) {
   let isRunFinalized = false;
 
   const testTimeMap = {};
-  const { apiKey } = config;
-
-  const client = new TestomatClient({ apiKey });
+  const clientConfig = buildCodeceptClientConfig(config);
+  const client = new TestomatClient(clientConfig);
 
   // Store original output methods for fallback
   const originalOutput = {
@@ -577,3 +577,45 @@ function formatHookStep(step) {
 
 export { CodeceptReporter };
 export default CodeceptReporter;
+
+function buildCodeceptClientConfig(config = {}) {
+  const outputDir = resolveCodeceptOutputDir(config);
+  const reportDir = resolveCodeceptReportDir(config, outputDir);
+
+  return {
+    ...config,
+    apiKey: config.apiKey,
+    framework: 'codeceptjs',
+    outputDir,
+    reportDir,
+    html: config.html,
+    markdown: config.markdown,
+    csv: config.csv,
+  };
+}
+
+function resolveCodeceptOutputDir(config = {}) {
+  const codeceptStore = /** @type {{ outputDir?: string }} */ (codeceptjs.store || {});
+  const candidates = [
+    config.outputDir,
+    config.output,
+    codeceptStore.outputDir,
+    codecept?.config?.get?.()?.output,
+    codecept?.config?.output,
+  ];
+
+  const outputDir = candidates.find(value => typeof value === 'string' && value.trim());
+  return outputDir || 'output';
+}
+
+function resolveCodeceptReportDir(config = {}, outputDir = 'output') {
+  if (typeof config.reportDir === 'string' && config.reportDir.trim()) {
+    return config.reportDir;
+  }
+
+  if (path.isAbsolute(outputDir)) {
+    return path.join(outputDir, 'report');
+  }
+
+  return path.join(outputDir, 'report');
+}

package/src/bin/cli.js

@@ -116,8 +116,10 @@ program
         debug(`Execution pattern: "${pattern}"`);
 
         if(opts.filterList) {
-          log.info( pc.blue(`Matched test/suite IDs: ${tests.join(', ')}`));
-          if (command) log.info( pc.green(`Full Running Command: ${filteredCommand}`));
+          if (command) log.info(pc.green(`Full Running Command: ${filteredCommand}`));
+          console.log();
+          console.log(`Grep string:`);
+          console.log(`${tests.join(', ')}`);
           return;
         }
 

package/src/client.js

@@ -116,8 +116,9 @@ class Client {
    * @returns {Promise<any>} - resolves to Run id which should be used to update / add test
    */
   async createRun(params = {}) {
+    const pipeParams = { ...(this.paramsForPipesFactory || {}), ...(params || {}) };
     if (!this.pipes || !this.pipes.length)
-      this.pipes = await pipesFactory(params || this.paramsForPipesFactory || {}, this.pipeStore);
+      this.pipes = await pipesFactory(pipeParams, this.pipeStore);
     debug('Creating run...');
     // all pipes disabled, skipping
     if (!this.pipes?.filter(p => p.isEnabled).length) return Promise.resolve();

package/src/pipe/bitbucket.js

@@ -1,5 +1,5 @@
 import { APP_PREFIX, testomatLogoURL } from '../constants.js';
-import { ansiRegExp, isSameTest } from '../utils/utils.js';
+import { ansiRegExp, isSameTest, truncate } from '../utils/utils.js';
 import { statusEmoji, fullName } from '../utils/pipe_utils.js';
 import { Gaxios } from 'gaxios';
 import pc from 'picocolors';
@@ -27,6 +27,7 @@ export class BitbucketPipe {
     this.tests = [];
     // Bitbucket PAT looks like bbpat-*****
     this.token = params.BITBUCKET_ACCESS_TOKEN || process.env.BITBUCKET_ACCESS_TOKEN || this.ENV.BITBUCKET_ACCESS_TOKEN;
+    this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
     this.hiddenCommentData = `Testomat.io report: ${process.env.BITBUCKET_BRANCH || ''}`;
 
     debug(
@@ -170,6 +171,10 @@ export class BitbucketPipe {
 
     let body = summary;
 
+    if (this.description) {
+      body += `\n\n> ${truncate(this.description, 1024).replace(/\r?\n/g, '\n> ')}`;
+    }
+
     if (failures.length) {
       body += `\n🟥 **Failures (${failures.length})**\n\n* ${failures.join('\n* ')}\n`;
       if (failures.length > 10) {

package/src/pipe/csv.js

@@ -20,9 +20,12 @@ class CsvPipe {
     this.title = params.title || process.env.TESTOMATIO_TITLE;
     this.results = [];
 
-    this.outputDir = 'export';
+    this.outputDir = params.reportDir || 'export';
+    if (process.env.TESTOMATIO_RUNGROUP_TITLE) {
+      this.outputDir = path.join(this.outputDir, process.env.TESTOMATIO_RUNGROUP_TITLE);
+    }
     this.defaultReportName = 'report.csv';
-    this.csvFilename = process.env.TESTOMATIO_CSV_FILENAME;
+    this.csvFilename = resolveCsvFilename(params);
     this.isEnabled = false;
 
     if (this.csvFilename) {
@@ -57,7 +60,7 @@ class CsvPipe {
    */
   checkExportDir() {
     if (!fs.existsSync(this.outputDir)) {
-      return fs.mkdirSync(this.outputDir);
+      return fs.mkdirSync(this.outputDir, { recursive: true });
     }
   }
 
@@ -142,3 +145,17 @@ class CsvPipe {
 }
 
 export default CsvPipe;
+
+function resolveCsvFilename(params = {}) {
+  if (typeof params.csvFilename === 'string' && params.csvFilename.trim()) {
+    return params.csvFilename;
+  }
+
+  if (typeof process.env.TESTOMATIO_CSV_FILENAME === 'string' && process.env.TESTOMATIO_CSV_FILENAME.trim()) {
+    return process.env.TESTOMATIO_CSV_FILENAME;
+  }
+
+  if (params.csv) return 'report.csv';
+
+  return null;
+}

package/src/pipe/github.js

@@ -4,7 +4,7 @@ import pc from 'picocolors';
 import humanizeDuration from 'humanize-duration';
 import merge from 'lodash.merge';
 import { testomatLogoURL } from '../constants.js';
-import { ansiRegExp, isSameTest } from '../utils/utils.js';
+import { ansiRegExp, isSameTest, truncate } from '../utils/utils.js';
 import { statusEmoji, fullName } from '../utils/pipe_utils.js';
 import { log } from '../utils/log.js';
 
@@ -22,6 +22,7 @@ class GitHubPipe {
     this.store = store;
     this.tests = [];
     this.token = params.GH_PAT || process.env.GH_PAT;
+    this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
     this.ref = process.env.GITHUB_REF;
     this.repo = process.env.GITHUB_REPOSITORY;
     this.jobKey = `${process.env.GITHUB_WORKFLOW || ''} / ${process.env.GITHUB_JOB || ''}`;
@@ -143,6 +144,9 @@ class GitHubPipe {
       });
 
     let body = summary;
+    if (this.description) {
+      body += `\n\n> ${truncate(this.description, 1024).replace(/\r?\n/g, '\n> ')}`;
+    }
     const coverageConfiguration = this.store?.coverageConfiguration;
     const isManualRun = this.store?.runKind === 'manual';
     if (isManualRun && coverageConfiguration) {

package/src/pipe/gitlab.js

@@ -5,7 +5,7 @@ import humanizeDuration from 'humanize-duration';
 import merge from 'lodash.merge';
 import path from 'path';
 import { APP_PREFIX, testomatLogoURL } from '../constants.js';
-import { ansiRegExp, isSameTest } from '../utils/utils.js';
+import { ansiRegExp, isSameTest, truncate } from '../utils/utils.js';
 import { statusEmoji, fullName } from '../utils/pipe_utils.js';
 import { log } from '../utils/log.js';
 
@@ -27,6 +27,7 @@ class GitLabPipe {
     this.tests = [];
     // GitLab PAT looks like glpat-nKGdja3jsG4850sGksh7
     this.token = params.GITLAB_PAT || process.env.GITLAB_PAT || this.ENV.GITLAB_PAT;
+    this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
     this.hiddenCommentData = `<!--- testomat.io report ${process.env.CI_JOB_NAME || ''} -->`;
 
     debug(
@@ -145,6 +146,10 @@ class GitLabPipe {
 
     let body = summary;
 
+    if (this.description) {
+      body += `\n\n> ${truncate(this.description, 1024).replace(/\r?\n/g, '\n> ')}`;
+    }
+
     if (failures.length) {
       body += `\n<details>\n<summary><h3>🟥 Failures (${failures.length})</h4></summary>\n\n${failures.join('\n')}\n`;
       if (failures.length > 20) {

package/src/pipe/html.js

@@ -19,8 +19,9 @@ class HtmlPipe {
   constructor(params, store = {}) {
     this.store = store || {};
     this.title = params.title || process.env.TESTOMATIO_TITLE;
+    this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
     this.apiKey = params.apiKey || process.env.TESTOMATIO;
-    this.isHtml = process.env.TESTOMATIO_HTML_REPORT_SAVE;
+    this.isHtml = params.html ?? process.env.TESTOMATIO_HTML_REPORT_SAVE;
 
     debug('HTML Pipe: ', this.apiKey ? 'API KEY' : '*no api key provided*');
 
@@ -32,7 +33,10 @@ class HtmlPipe {
 
     if (this.isHtml) {
       this.isEnabled = true;
-      this.htmlReportDir = process.env.TESTOMATIO_HTML_REPORT_FOLDER || HTML_REPORT.FOLDER;
+      this.htmlReportDir = params.reportDir || process.env.TESTOMATIO_HTML_REPORT_FOLDER || HTML_REPORT.FOLDER;
+      if (process.env.TESTOMATIO_RUNGROUP_TITLE) {
+        this.htmlReportDir = path.join(this.htmlReportDir, process.env.TESTOMATIO_RUNGROUP_TITLE);
+      }
 
       if (process.env.TESTOMATIO_HTML_FILENAME && process.env.TESTOMATIO_HTML_FILENAME.endsWith('.html')) {
         this.htmlReportName = process.env.TESTOMATIO_HTML_FILENAME;
@@ -254,7 +258,10 @@ class HtmlPipe {
       runUrl: this.store.runUrl || '',
       executionTime: testExecutionSumTime(aggregatedTests),
       executionDate: getCurrentDateTimeFormatted(),
-      description: runParams.description || this.store.coverageDescription || this.store.description || '',
+      description:
+        [runParams.description || this.store.coverageDescription || this.store.description, this.description]
+          .filter(Boolean)
+          .join('\n\n') || '',
       configuration: buildDisplayConfiguration(
         this.configuration || this.store.configuration || runParams.configuration || null,
       ),

package/src/pipe/markdown.js

@@ -15,8 +15,9 @@ class MarkdownPipe {
   constructor(params, store = {}) {
     this.store = store || {};
     this.title = params.title || process.env.TESTOMATIO_TITLE;
+    this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
     this.apiKey = params.apiKey || process.env.TESTOMATIO;
-    this.isMarkdown = process.env.TESTOMATIO_MARKDOWN_REPORT_SAVE;
+    this.isMarkdown = params.markdown ?? process.env.TESTOMATIO_MARKDOWN_REPORT_SAVE;
 
     debug('Markdown Pipe: ', this.apiKey ? 'API KEY' : '*no api key provided*');
 
@@ -29,7 +30,11 @@ class MarkdownPipe {
     if (!this.isMarkdown) return;
 
     this.isEnabled = true;
-    this.markdownReportDir = process.env.TESTOMATIO_MARKDOWN_REPORT_FOLDER || MARKDOWN_REPORT.FOLDER;
+    this.markdownReportDir =
+      params.reportDir || process.env.TESTOMATIO_MARKDOWN_REPORT_FOLDER || MARKDOWN_REPORT.FOLDER;
+    if (process.env.TESTOMATIO_RUNGROUP_TITLE) {
+      this.markdownReportDir = path.join(this.markdownReportDir, process.env.TESTOMATIO_RUNGROUP_TITLE);
+    }
 
     const envName = process.env.TESTOMATIO_MARKDOWN_FILENAME;
     if (envName && envName.endsWith('.md')) {
@@ -134,7 +139,10 @@ class MarkdownPipe {
       isParallel: runParams?.isParallel,
       executionTime: testExecutionSumTime(aggregated),
       executionDate: getCurrentDateTimeFormatted(),
-      description: runParams?.description || this.store.coverageDescription || this.store.description || '',
+      description:
+        [runParams?.description || this.store.coverageDescription || this.store.description, this.description]
+          .filter(Boolean)
+          .join('\n\n') || '',
       configuration: this.configuration || this.store.configuration || runParams?.configuration || null,
       tests: aggregated,
       stats,
@@ -143,7 +151,6 @@ class MarkdownPipe {
     const md = renderDocument(data);
 
     fs.writeFileSync(outputPath, md, 'utf-8');
-
     if (fs.existsSync(outputPath)) {
       const absolutePath = path.resolve(outputPath);
       const fileUrlPath = fileUrl(absolutePath, { resolve: true });

package/src/pipe/testomatio.js

@@ -83,6 +83,7 @@ class TestomatioPipe {
     this.groupTitle = params.groupTitle || process.env.TESTOMATIO_RUNGROUP_TITLE;
     this.env = process.env.TESTOMATIO_ENV;
     this.label = process.env.TESTOMATIO_LABEL;
+    this.description = params.description || process.env.TESTOMATIO_DESCRIPTION;
 
     // Create a new instance of gaxios with a custom config
     this.client = new Gaxios({
@@ -227,15 +228,17 @@ class TestomatioPipe {
     const accessEvent = process.env.TESTOMATIO_PUBLISH ? 'publish' : null;
 
     const coverageConfiguration = this.store?.coverageConfiguration;
-    let description = null;
+    let coverageDescription = null;
     let configuration = null;
     if (coverageConfiguration && (coverageConfiguration.tests?.length || coverageConfiguration.suites?.length)) {
-      description = this.store?.coverageDescription || null;
+      coverageDescription = this.store?.coverageDescription || null;
       configuration = {
         tests: coverageConfiguration.tests?.map(id => id.replace(/^T/, '')) || [],
         suites: coverageConfiguration.suites?.map(id => id.replace(/^S/, '')) || [],
       };
     }
+    // Run description: coverage-derived block (if any) with the user-provided TESTOMATIO_DESCRIPTION appended after it.
+    const description = [coverageDescription, this.description].filter(Boolean).join('\n\n') || null;
 
     // Merge caller-supplied configuration (e.g. { exploratory: true }) into runParams.configuration.
     // Caller values win on key conflict; coverage-derived tests/suites lists are preserved when not overridden.
@@ -576,12 +579,18 @@ class TestomatioPipe {
     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>');
+    const statusText = error.response?.statusText || '';
 
     let message = pc.yellow('⚠️ Request to Testomat.io failed:\n');
     message += pc.bold(`${pc.red(statusCode)} ${method} ${pc.gray(url)}\n`);
 
+    const apiMessage = error.response?.data?.message;
     if (statusCode === 403) {
       message += `\t${pc.red('Please check your API token. It might be invalid or expired.')}\n`;
+    } else if (apiMessage) {
+      message += `\t${pc.red(apiMessage)}\n`;
+    } else if (statusText) {
+      message += `\t${pc.red(statusText)}\n`;
     }
 
     message += `\t${pc.bold('response: ')}${pc.gray(responseBody)}\n`;

package/types/types.d.ts

@@ -267,6 +267,9 @@ export interface RunData {
   /** If duration is pre-set value as in XML tests set it */
   duration?: number;
 
+  /** Free-form run description (from `TESTOMATIO_DESCRIPTION`); appended to any coverage-derived description. */
+  description?: string;
+
   /**
    * An array of `TestData` objects representing the individual test cases in the test run.
    * Used for JUNit report when we don't send the tests in realtime but in a batch as a part of final result */