@testomatio/reporter 2.1.3-beta.3-multi-links → 2.3.0-beta.1-links

package/lib/adapter/codecept.js

@@ -26,6 +26,8 @@ const HOOK_EXECUTION_ORDER = {
     PRE_TEST: ['BeforeSuiteHook', 'BeforeHook'],
     POST_TEST: ['AfterHook', 'AfterSuiteHook']
 };
+// codeceptjs workers are self-contained
+data_storage_js_1.dataStorage.isFileStorage = false;
 const DATA_REGEXP = /[|\s]+?(\{".*\}|\[.*\])/;
 if (MAJOR_VERSION < 3) {
     console.log('🔴 This reporter works with CodeceptJS 3+, please update your tests');
@@ -48,7 +50,6 @@ function CodeceptReporter(config) {
         step: output.step,
         say: output.say,
     };
-    output.stepShift = 0;
     output.debug = function (msg) {
         originalOutput.debug(msg);
         data_storage_js_1.dataStorage.putData('log', repeat(this?.stepShift || 0) + picocolors_1.default.cyan(msg.toString()));
@@ -62,6 +63,7 @@ function CodeceptReporter(config) {
         originalOutput.log(msg);
         data_storage_js_1.dataStorage.putData('log', repeat(this?.stepShift || 0) + picocolors_1.default.gray(msg));
     };
+    output.stepShift = 0;
     recorder.startUnlessRunning();
     const hookSteps = new Map();
     let currentHook = null;
@@ -140,7 +142,7 @@ function CodeceptReporter(config) {
         const manuallyAttachedArtifacts = index_js_1.services.artifacts.get(test.fullTitle());
         const keyValues = index_js_1.services.keyValues.get(test.fullTitle());
         const stepHierarchy = buildUnifiedStepHierarchy(test.steps, hookSteps);
-        const labels = index_js_1.services.labels.get(test.fullTitle());
+        const links = index_js_1.services.links.get(test.fullTitle());
         index_js_1.services.setContext(null);
         client.addTestRun(test.state, {
             ...stripExampleFromTitle(title),
@@ -153,7 +155,7 @@ function CodeceptReporter(config) {
             files,
             steps: stepHierarchy, // Array of step objects per API schema
             logs,
-            labels,
+            links,
             manuallyAttachedArtifacts,
             meta: { ...keyValues, ...test.meta },
         });

package/lib/adapter/cucumber/current.js

@@ -105,6 +105,7 @@ class CucumberReporter extends cucumber_1.Formatter {
         const logs = index_js_1.services.logger.getLogs(testTitle).join('\n');
         const artifacts = index_js_1.services.artifacts.get(testTitle);
         const keyValues = index_js_1.services.keyValues.get(testTitle);
+        const links = index_js_1.services.links.get(testTitle);
         this.client.addTestRun(status, {
             // error: testCaseAttempt.worstTestStepResult.message,
             message,
@@ -114,6 +115,7 @@ class CucumberReporter extends cucumber_1.Formatter {
                 .trim(),
             example: { ...example },
             logs,
+            links,
             manuallyAttachedArtifacts: artifacts,
             meta: keyValues,
             title: scenario,

package/lib/adapter/jest.js

@@ -57,6 +57,7 @@ class JestReporter {
             const logs = getTestLogs(result);
             const artifacts = index_js_1.services.artifacts.get(result.fullName);
             const keyValues = index_js_1.services.keyValues.get(result.fullName);
+            const links = index_js_1.services.links.get(result.fullName);
             const deducedStatus = status === 'pending' ? 'skipped' : status;
             // In jest if test is not matched with test name pattern it is considered as skipped.
             // So adding a check if it is skipped for real or because of test pattern
@@ -69,6 +70,7 @@ class JestReporter {
                     title,
                     time: duration,
                     logs,
+                    links,
                     manuallyAttachedArtifacts: artifacts,
                     meta: keyValues,
                 });

package/lib/adapter/mocha.js

@@ -43,6 +43,7 @@ function MochaReporter(runner, opts) {
         const logs = getTestLogs(test);
         const artifacts = index_js_1.services.artifacts.get(test.fullTitle());
         const keyValues = index_js_1.services.keyValues.get(test.fullTitle());
+        const links = index_js_1.services.links.get(test.fullTitle());
         client.addTestRun(constants_js_1.STATUS.PASSED, {
             test_id: testId,
             suite_title: getSuiteTitle(test),
@@ -53,12 +54,16 @@ function MochaReporter(runner, opts) {
             logs,
             manuallyAttachedArtifacts: artifacts,
             meta: keyValues,
+            links,
         });
     });
     runner.on(EVENT_TEST_PENDING, test => {
         skipped += 1;
         console.log('skip: %s', test.fullTitle());
         const testId = (0, utils_js_1.getTestomatIdFromTestTitle)(test.title);
+        const artifacts = index_js_1.services.artifacts.get(test.fullTitle());
+        const keyValues = index_js_1.services.keyValues.get(test.fullTitle());
+        const links = index_js_1.services.links.get(test.fullTitle());
         client.addTestRun(constants_js_1.STATUS.SKIPPED, {
             title: getTestName(test),
             suite_title: getSuiteTitle(test),
@@ -66,6 +71,9 @@ function MochaReporter(runner, opts) {
             file: getFile(test),
             test_id: testId,
             time: test.duration,
+            manuallyAttachedArtifacts: artifacts,
+            meta: keyValues,
+            links,
         });
     });
     runner.on(EVENT_TEST_FAIL, async (test, err) => {
@@ -73,6 +81,9 @@ function MochaReporter(runner, opts) {
         console.log(picocolors_1.default.bold(picocolors_1.default.red('✖')), test.fullTitle(), picocolors_1.default.gray(err.message));
         const testId = (0, utils_js_1.getTestomatIdFromTestTitle)(test.title);
         const logs = getTestLogs(test);
+        const artifacts = index_js_1.services.artifacts.get(test.fullTitle());
+        const keyValues = index_js_1.services.keyValues.get(test.fullTitle());
+        const links = index_js_1.services.links.get(test.fullTitle());
         client.addTestRun(constants_js_1.STATUS.FAILED, {
             error: err,
             suite_title: getSuiteTitle(test),
@@ -82,6 +93,9 @@ function MochaReporter(runner, opts) {
             code: process.env.TESTOMATIO_UPDATE_CODE ? test.body.toString() : '',
             time: test.duration,
             logs,
+            manuallyAttachedArtifacts: artifacts,
+            meta: keyValues,
+            links,
         });
     });
     runner.on(EVENT_RUN_END, () => {

package/lib/adapter/playwright.js

@@ -55,6 +55,7 @@ class PlaywrightReporter {
         }
         const manuallyAttachedArtifacts = index_js_1.services.artifacts.get(fullTestTitle);
         const testMeta = index_js_1.services.keyValues.get(fullTestTitle);
+        const links = index_js_1.services.links.get(fullTestTitle);
         const rid = test.id || test.testId || (0, uuid_1.v4)();
         /**
          * @type {{
@@ -91,6 +92,7 @@ class PlaywrightReporter {
             steps: steps.length ? steps : undefined,
             time: duration,
             logs,
+            links,
             manuallyAttachedArtifacts,
             meta: {
                 browser: project.browser,

package/lib/adapter/webdriver.js

@@ -77,12 +77,10 @@ class WebdriverReporter extends reporter_1.default {
     onTestEnd(test) {
         test.suite = test.parent;
         const logs = getTestLogs(test.fullTitle);
-        // TODO: FIX: artifacts for some reason leads to empty report on Testomat.io
-        // const artifacts = services.artifacts.get(test.fullTitle);
-        // const keyValues = services.keyValues.get(test.fullTitle);
+        test.artifacts = index_js_1.services.artifacts.get(test.fullTitle);
+        test.meta = index_js_1.services.keyValues.get(test.fullTitle);
+        test.links = index_js_1.services.links.get(test.fullTitle);
         test.logs = logs;
-        // test.artifacts = artifacts;
-        // test.meta = keyValues;
         this._addTestPromises.push(this.addTest(test));
     }
     // wdio-cucumber does not trigger onTestEnd hook, thus, using this one
@@ -94,7 +92,7 @@ class WebdriverReporter extends reporter_1.default {
     async addTest(test) {
         if (!this.client)
             return;
-        const { title, _duration: duration, state, error, output } = test;
+        const { title, _duration: duration, state, error, output, links, artifacts, meta, logs } = test;
         const testId = (0, utils_js_1.getTestomatIdFromTestTitle)(title);
         const screenshotEndpoint = '/session/:sessionId/screenshot';
         const screenshotsBuffers = output
@@ -102,10 +100,11 @@ class WebdriverReporter extends reporter_1.default {
             .map(el => Buffer.from(el.result.value, 'base64'));
         await this.client.addTestRun(state, {
             rid: test.uid || '',
-            manuallyAttachedArtifacts: test.artifacts,
+            manuallyAttachedArtifacts: artifacts,
             error,
-            logs: test.logs,
-            meta: test.meta,
+            logs,
+            meta,
+            links,
             title,
             test_id: testId,
             time: duration,

package/lib/bin/startTest.js

@@ -4,103 +4,50 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const cross_spawn_1 = require("cross-spawn");
-const commander_1 = require("commander");
-const picocolors_1 = __importDefault(require("picocolors"));
-const client_js_1 = __importDefault(require("../client.js"));
-const constants_js_1 = require("../constants.js");
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = require("node:path");
 const utils_js_1 = require("../utils/utils.js");
-const config_js_1 = require("../config.js");
-const dotenv_1 = __importDefault(require("dotenv"));
+const picocolors_1 = __importDefault(require("picocolors"));
+// Define __dirname - this will be replaced by build script with actual __dirname for CommonJS
+const cliPath = (0, node_path_1.join)(__dirname, 'cli.js');
 const version = (0, utils_js_1.getPackageVersion)();
 console.log(picocolors_1.default.cyan(picocolors_1.default.bold(` 🤩 Testomat.io Reporter v${version}`)));
-const program = new commander_1.Command();
-program
-    .option('-c, --command <cmd>', 'Test runner command')
-    .option('--launch', 'Start a new run and return its ID')
-    .option('--finish', 'Finish Run by its ID')
-    .option('--env-file <envfile>', 'Load environment variables from env file')
-    .option('--filter <filter>', 'Additional execution filter')
-    .action(async (opts) => {
-    const { launch, finish, filter } = opts;
-    let { command } = opts;
-    if (opts.envFile)
-        dotenv_1.default.config({ path: opts.envFile });
-    const apiKey = process.env['INPUT_TESTOMATIO-KEY'] || config_js_1.config.TESTOMATIO;
-    const title = process.env.TESTOMATIO_TITLE;
-    if (launch) {
-        console.log('Starting a new Run on Testomat.io...');
-        const client = new client_js_1.default({ apiKey });
-        client.createRun().then(() => {
-            console.log(process.env.runId);
-            process.exit(0);
-        });
-        return;
-    }
-    if (finish) {
-        // TODO: add error in case of TESTOMATIO environment variable is not set
-        // because command is fine in console, but actually (on testomat.io) run is not finished
-        if (!process.env.TESTOMATIO_RUN) {
-            console.log('TESTOMATIO_RUN environment variable must be set.');
-            return process.exit(1);
+// Parse command line arguments to map start-test-run options to @testomatio/reporter run format
+const args = process.argv.slice(2);
+const newArgs = ['run'];
+let i = 0;
+while (i < args.length) {
+    const arg = args[i];
+    if (arg === '-c' || arg === '--command') {
+        // Map -c/--command to positional argument for run command
+        i++;
+        if (i < args.length) {
+            newArgs.push(args[i]);
         }
-        console.log('Finishing Run on Testomat.io...');
-        const client = new client_js_1.default({ apiKey });
-        // @ts-ignore
-        client.updateRunStatus(constants_js_1.STATUS.FINISHED).then(() => {
-            console.log(picocolors_1.default.yellow(`Run ${process.env.TESTOMATIO_RUN} was finished`));
-            process.exit(0);
-        });
-        return;
     }
-    let exitCode = 0;
-    if (!command.split) {
-        process.exitCode = 255;
-        console.log(constants_js_1.APP_PREFIX, `No command provided. Use -c option to launch a test runner.`);
-        return;
+    else if (arg.startsWith('--command=')) {
+        // Handle --command=value format
+        const command = arg.split('=', 2)[1];
+        newArgs.push(command);
     }
-    const client = new client_js_1.default({ apiKey, title, parallel: true });
-    if (filter) {
-        const [pipe, ...optsArray] = filter.split(':');
-        const pipeOptions = optsArray.join(':');
-        try {
-            const tests = await client.prepareRun({ pipe, pipeOptions });
-            if (!tests || tests.length === 0) {
-                return;
-            }
-            const grep = ` --grep (${tests.join('|')})`;
-            command += grep;
-        }
-        catch (err) {
-            console.log(constants_js_1.APP_PREFIX, err);
-        }
+    else if (arg === '--launch') {
+        // Map --launch to start command
+        newArgs[0] = 'start';
     }
-    const testCmds = command.split(' ');
-    console.log(constants_js_1.APP_PREFIX, `🚀 Running`, picocolors_1.default.green(command));
-    if (!apiKey) {
-        const cmd = (0, cross_spawn_1.spawn)(testCmds[0], testCmds.slice(1), { stdio: 'inherit' });
-        cmd.on('close', code => {
-            console.log(constants_js_1.APP_PREFIX, '⚠️ ', `Runner exited with ${picocolors_1.default.bold(code)}, report is ignored`);
-            if (code > exitCode)
-                exitCode = code;
-            process.exitCode = exitCode;
-        });
-        return;
+    else if (arg === '--finish') {
+        // Map --finish to finish command  
+        newArgs[0] = 'finish';
     }
-    client.createRun().then(() => {
-        const cmd = (0, cross_spawn_1.spawn)(testCmds[0], testCmds.slice(1), { stdio: 'inherit' });
-        cmd.on('close', code => {
-            const emoji = code === 0 ? '🟢' : '🔴';
-            console.log(constants_js_1.APP_PREFIX, emoji, `Runner exited with ${picocolors_1.default.bold(code)}`);
-            const status = code === 0 ? 'passed' : 'failed';
-            client.updateRunStatus(status, true);
-            if (code > exitCode)
-                exitCode = code;
-            process.exitCode = exitCode;
-        });
-    });
-});
-if (process.argv.length <= 2) {
-    program.outputHelp();
+    else {
+        // Pass through other arguments
+        newArgs.push(arg);
+    }
+    i++;
 }
-program.parse(process.argv);
+// Execute the main CLI with mapped arguments
+const child = (0, node_child_process_1.spawn)(process.execPath, [cliPath, ...newArgs], {
+    stdio: 'inherit'
+});
+child.on('exit', (code) => {
+    process.exit(code);
+});

package/lib/client.js

@@ -181,46 +181,18 @@ class Client {
         /**
          * @type {TestData}
          */
-        const { rid, error = null, time = 0, example = null, files = [], filesBuffers = [], steps, code = null, title, file, suite_title, suite_id, test_id, timestamp, manuallyAttachedArtifacts, labels, overwrite, } = testData;
+        const { rid, error = null, time = 0, example = null, files = [], filesBuffers = [], steps, code = null, title, file, suite_title, suite_id, test_id, timestamp, links, manuallyAttachedArtifacts, overwrite, } = testData;
         let { message = '', meta = {} } = testData;
         // stringify meta values and limit keys and values length to 255
         meta = Object.entries(meta)
             .filter(([, value]) => value !== null && value !== undefined)
-            .map(([key, value]) => {
-            try {
-                if (typeof value === 'object') {
-                    value = JSON.stringify(value);
-                }
-                else if (typeof value !== 'string') {
-                    try {
-                        value = value.toString();
-                    }
-                    catch (err) {
-                        console.warn(constants_js_1.APP_PREFIX, `Can't convert meta value to string`, err);
-                    }
-                }
-                if (value?.length > 255) {
-                    value = value.substring(0, 255);
-                    debug(constants_js_1.APP_PREFIX, `Meta info value "${value}" is too long, trimmed to 255 characters`);
-                }
-                if (key?.length > 255) {
-                    const newKey = key.substring(0, 255);
-                    debug(constants_js_1.APP_PREFIX, `Meta info key "${key}" is too long, trimmed to 255 characters`);
-                    return [newKey, value];
-                }
-                return [key, value];
-            }
-            catch (err) {
-                debug(constants_js_1.APP_PREFIX, `Error while processing meta info key ${key}`, err);
-                return [null, null];
-            }
-        })
             .reduce((acc, [key, value]) => {
             if (key)
                 acc[key] = value;
             return acc;
         }, {});
-        // Labels are simple array of strings, no processing needed
+        // Get links from storage using the test context
+        const testContext = suite_title ? `${suite_title} ${title}` : title;
         let errorFormatted = '';
         if (error) {
             errorFormatted += this.formatError(error) || '';
@@ -268,7 +240,7 @@ class Client {
             timestamp,
             artifacts,
             meta,
-            labels,
+            links,
             overwrite,
             ...(rootSuiteId && { root_suite_id: rootSuiteId }),
         };

package/lib/data-storage.d.ts

@@ -12,22 +12,22 @@ declare class DataStorage {
     /**
      * Puts any data to storage (file or global variable).
      * If file: stores data as text, if global variable – stores as array of data.
-     * @param {'log' | 'artifact' | 'keyvalue' | 'labels'} dataType
+     * @param {'log' | 'artifact' | 'keyvalue' | 'links'} dataType
      * @param {*} data anything you want to store (string, object, array, etc)
      * @param {*} context could be testId or any context (test name, suite name, including their IDs etc)
      * suite name + test name is used by default
      * @returns
      */
-    putData(dataType: "log" | "artifact" | "keyvalue" | "labels", data: any, context?: any): void;
+    putData(dataType: "log" | "artifact" | "keyvalue" | "links", data: any, context?: any): void;
     /**
      * Returns data, stored for specific test/context (or data which was stored without test id specified).
      * This method will get data from global variable and/or from from file (previosly saved with put method).
      *
-     * @param {'log' | 'artifact' | 'keyvalue' | 'labels'} dataType
+     * @param {'log' | 'artifact' | 'keyvalue' | 'links'} dataType
      * @param {string} context
      * @returns {any []} array of data (any type), null (if no data found for context) or string (if data type is log)
      */
-    getData(dataType: "log" | "artifact" | "keyvalue" | "labels", context: string): any[];
+    getData(dataType: "log" | "artifact" | "keyvalue" | "links", context: string): any[];
     #private;
 }
 export function stringToMD5Hash(str: any): string;

package/lib/data-storage.js

@@ -45,7 +45,6 @@ const os_1 = __importDefault(require("os"));
 const constants_js_1 = require("./constants.js");
 const utils_js_1 = require("./utils/utils.js");
 const crypto_1 = __importDefault(require("crypto"));
-const startTime = Date.now();
 const debug = (0, debug_1.default)('@testomatio/reporter:storage');
 class DataStorage {
     static #instance;
@@ -76,7 +75,7 @@ class DataStorage {
     /**
      * Puts any data to storage (file or global variable).
      * If file: stores data as text, if global variable – stores as array of data.
-     * @param {'log' | 'artifact' | 'keyvalue' | 'labels'} dataType
+     * @param {'log' | 'artifact' | 'keyvalue' | 'links'} dataType
      * @param {*} data anything you want to store (string, object, array, etc)
      * @param {*} context could be testId or any context (test name, suite name, including their IDs etc)
      * suite name + test name is used by default
@@ -104,7 +103,7 @@ class DataStorage {
      * Returns data, stored for specific test/context (or data which was stored without test id specified).
      * This method will get data from global variable and/or from from file (previosly saved with put method).
      *
-     * @param {'log' | 'artifact' | 'keyvalue' | 'labels'} dataType
+     * @param {'log' | 'artifact' | 'keyvalue' | 'links'} dataType
      * @param {string} context
      * @returns {any []} array of data (any type), null (if no data found for context) or string (if data type is log)
      */
@@ -135,7 +134,7 @@ class DataStorage {
         return null;
     }
     /**
-     * @param {'log' | 'artifact' | 'keyvalue' | 'labels'} dataType
+     * @param {'log' | 'artifact' | 'keyvalue' | 'links'} dataType
      * @param {string} context
      * @returns aray of data (any type)
      */
@@ -144,7 +143,7 @@ class DataStorage {
             if (global?.testomatioDataStore[dataType]) {
                 const testData = global.testomatioDataStore[dataType][context];
                 if (testData)
-                    debug(`"${dataType}" data for constext "${context}":`, testData.join(', '));
+                    debug('<=', dataType, 'global', context, testData);
                 return testData || [];
             }
             // debug(`No ${this.dataType} data for context ${context} in <global> storage`);
@@ -155,7 +154,7 @@ class DataStorage {
         }
     }
     /**
-     * @param {'log' | 'artifact' | 'keyvalue' | 'labels'} dataType
+     * @param {'log' | 'artifact' | 'keyvalue' | 'links'} dataType
      * @param {*} context
      * @returns array of data (any type)
      */
@@ -166,7 +165,7 @@ class DataStorage {
             if (fs_1.default.existsSync(filepath)) {
                 const testDataAsText = fs_1.default.readFileSync(filepath, 'utf-8');
                 if (testDataAsText)
-                    debug(`"${dataType}" data for context "${context}":`, testDataAsText);
+                    debug('<=', dataType, 'file', context, testDataAsText);
                 const testDataArr = testDataAsText?.split(os_1.default.EOL) || [];
                 return testDataArr;
             }
@@ -180,12 +179,12 @@ class DataStorage {
     }
     /**
      * Puts data to global variable. Unlike the file storage, stores data in array (file storage just append as string).
-     * @param {'log' | 'artifact' | 'keyvalue' | 'labels'} dataType
+     * @param {'log' | 'artifact' | 'keyvalue' | 'links'} dataType
      * @param {*} data
      * @param {*} context
      */
     #putDataToGlobalVar(dataType, data, context) {
-        debug('Saving data to global variable for ', context, ':', data);
+        debug('=>', dataType, 'global', context, data);
         if (!global.testomatioDataStore)
             global.testomatioDataStore = {};
         if (!global.testomatioDataStore?.[dataType])
@@ -196,7 +195,7 @@ class DataStorage {
     }
     /**
      * Puts data to file. Unlike the global variable storage, stores data as string
-     * @param {'log' | 'artifact' | 'keyvalue' | 'labels'} dataType
+     * @param {'log' | 'artifact' | 'keyvalue' | 'links'} dataType
      * @param {*} data
      * @param {string} context
      * @returns
@@ -209,7 +208,7 @@ class DataStorage {
         const filepath = (0, path_1.join)(dataDirPath, filename);
         if (!fs_1.default.existsSync(dataDirPath))
             utils_js_1.fileSystem.createDir(dataDirPath);
-        debug(`Saving data to file for context "${context}" to ${filepath}. Data: ${JSON.stringify(data)}`);
+        debug('=>', dataType, 'file', context, data);
         // append new line if file already exists (in this case its definitely includes some data)
         if (fs_1.default.existsSync(filepath)) {
             fs_1.default.appendFileSync(filepath, os_1.default.EOL + data, 'utf-8');
@@ -223,7 +222,7 @@ function stringToMD5Hash(str) {
     const md5 = crypto_1.default.createHash('md5');
     md5.update(str);
     const hash = md5.digest('hex');
-    return `${startTime}_${hash}`;
+    return `${process.env.runId || 'run'}_${hash}`;
 }
 exports.dataStorage = DataStorage.getInstance();
 // TODO: consider using fs promises instead of writeSync/appendFileSync to

package/lib/pipe/testomatio.js

@@ -113,8 +113,7 @@ class TestomatioPipe {
             const resp = await this.client.request({
                 method: 'GET',
                 url: '/api/test_grep',
-                params: q.params,
-                responseType: q.responseType
+                ...q,
             });
             if (Array.isArray(resp.data?.tests) && resp.data?.tests?.length > 0) {
                 (0, utils_js_1.foundedTestLog)(constants_js_1.APP_PREFIX, resp.data.tests);
@@ -173,7 +172,8 @@ class TestomatioPipe {
             const resp = await this.client.request({
                 method: 'PUT',
                 url: `/api/reporter/${this.runId}`,
-                data: runParams
+                data: runParams,
+                responseType: 'json'
             });
             if (resp.data.artifacts)
                 (0, pipe_utils_js_1.setS3Credentials)(resp.data.artifacts);

package/lib/reporter-functions.d.ts

@@ -4,11 +4,15 @@ declare namespace _default {
     export { addStep as step };
     export { setKeyValue as keyValue };
     export { setLabel as label };
+    export { linkTest };
+    export { linkJira };
 }
 export default _default;
 /**
  * Stores path to file as artifact and uploads it to the S3 storage
  * @param {string | {path: string, type: string, name: string}} data - path to file or object with path, type and name
+ * @param {any} [context=null] - optional context parameter
+ * @returns {void}
  */
 declare function saveArtifact(data: string | {
     path: string;
@@ -17,18 +21,21 @@ declare function saveArtifact(data: string | {
 }, context?: any): void;
 /**
  * Attach log message(s) to the test report
- * @param  string
+ * @param {...any} args - log messages to attach
+ * @returns {void}
  */
 declare function logMessage(...args: any[]): void;
 /**
  * Similar to "log" function but marks message in report as a step
- * @param {string} message
+ * @param {string} message - step message
+ * @returns {void}
  */
 declare function addStep(message: string): void;
 /**
  * Add key-value pair(s) to the test report
- * @param {{[key: string]: string} | string} keyValue object { key: value } (multiple props allowed) or key (string)
- * @param {string?} value
+ * @param {{[key: string]: string} | string} keyValue - object { key: value } (multiple props allowed) or key (string)
+ * @param {string|null} [value=null] - optional value when keyValue is a string
+ * @returns {void}
  */
 declare function setKeyValue(keyValue: {
     [key: string]: string;
@@ -36,6 +43,19 @@ declare function setKeyValue(keyValue: {
 /**
  * Add a single label to the test report
  * @param {string} key - label key (e.g. 'severity', 'feature', or just 'smoke' for labels without values)
- * @param {string} [value] - optional label value (e.g. 'high', 'login')
+ * @param {string|null} [value=null] - optional label value (e.g. 'high', 'login')
+ * @returns {void}
  */
-declare function setLabel(key: string, value?: string): void;
+declare function setLabel(key: string, value?: string | null): void;
+/**
+ * Add link(s) to the test report
+ * @param {...string} testIds - test IDs to link
+ * @returns {void}
+ */
+declare function linkTest(...testIds: string[]): void;
+/**
+ * Add JIRA issue link(s) to the test report
+ * @param {...string} jiraIds - JIRA issue IDs to link
+ * @returns {void}
+ */
+declare function linkJira(...jiraIds: string[]): void;