@mablhq/mabl-cli 1.45.1 → 1.47.12

package/commands/tests/testsUtil.js

@@ -26,8 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toBasicHttpAuthenticationCredentials = exports.generateChromiumPreferencesFile = exports.logTestInfoIfPresent = exports.milliSecondsToSeconds = exports.calculateTotalTimeSeconds = exports.extractTestRunConfig = exports.pullDownTestRunConfig = exports.validateRunCommandWithLabels = exports.validateRunEditCommand = exports.cleanupTestResources = exports.sleep = exports.editTheTest = exports.runTheTest = exports.prepareTrainerForSplitPlayback = exports.cleanUpInitialPages = exports.getExtensionBackgroundPageWithCliTool = exports.createBrowserForExecutionEngine = exports.addExecutionEngineLaunchArgs = exports.createBrowser = exports.prepareChromePreferencesDirectory = exports.findChrome = exports.searchForChrome = exports.getFinalUrl = exports.getTempChromePrefDirectory = void 0;
-const async_retry_1 = __importDefault(require("async-retry"));
+exports.toBasicHttpAuthenticationCredentials = exports.logTestInfoIfPresent = exports.milliSecondsToSeconds = exports.calculateTotalTimeSeconds = exports.extractTestRunConfig = exports.pullDownTestRunConfig = exports.validateRunCommandWithLabels = exports.validateRunEditCommand = exports.cleanupTestResources = exports.sleep = exports.editTheTest = exports.runTheTest = exports.prepareTrainerForSplitPlayback = exports.cleanUpInitialPages = exports.getExtensionBackgroundPageWithCliTool = exports.createBrowserForExecutionEngine = exports.createBrowser = exports.getFinalUrl = void 0;
 const cli_table3_1 = __importDefault(require("cli-table3"));
 const fs = __importStar(require("fs-extra"));
 const os = __importStar(require("os"));
@@ -36,45 +35,14 @@ const browserLauncher_1 = require("../../browserLauncher/browserLauncher");
 const trainingSessionActions_1 = require("../../core/messaging/actions/trainingSessionActions");
 const logLineMessaging_1 = require("../../core/messaging/logLineMessaging");
 const messaging_1 = require("../../core/messaging/messaging");
-const env_1 = require("../../env/env");
 const cliConfigProvider_1 = require("../../providers/cliConfigProvider");
 const loggingProvider_1 = require("../../providers/logging/loggingProvider");
 const fileUploadUtil_1 = require("../../util/fileUploadUtil");
 const logUtils_1 = require("../../util/logUtils");
-const resourceUtil_1 = require("../../util/resourceUtil");
-const configKeys_1 = require("../config/config_cmds/configKeys");
 const constants_1 = require("../constants");
-const mobileEmulationUtil_1 = require("./mobileEmulationUtil");
 const trainerUtil_1 = require("./tests_cmds/trainerUtil");
 const chalk = require('chalk');
-const chromeFinder = require('chrome-launcher/dist/chrome-finder');
-const launchUtils = require('chrome-launcher/dist/utils');
-const tmp = require('tmp-promise');
-const baseExecutionEngineLaunchArgs = [
-    '--unlimited-storage',
-    '--disable-dev-shm-usage',
-    '--enable-print-preview-register-promos',
-    '--kiosk-printing',
-    '--disable-infobars',
-    '--enable-logging',
-    '--v=0',
-    '--enable-features=NetworkService,NetworkServiceInProcess',
-    '--disable-features=site-per-process',
-    '--disable-component-update',
-];
-const ExecutionEngineFakeAudioFilePath = '/opt/media/mabl_test_audio.wav';
-const ExecutionEngineFakeVideoFilePath = '/opt/media/mabl_test_pattern.y4m';
 let RUNNING_TEST = false;
-function getTempChromePrefDirectory() {
-    const tempDir = tmp.dirSync({
-        mode: 0o777,
-        prefix: `${env_1.CONF_FILE_PROJECT_NAME}-`,
-    });
-    const preferencesPath = path.normalize(`${tempDir.name}/chromePreferences`);
-    fs.ensureDirSync(preferencesPath, 0o777);
-    return preferencesPath;
-}
-exports.getTempChromePrefDirectory = getTempChromePrefDirectory;
 function getFinalUrl(test, parsedUrl) {
     const finalUrl = parsedUrl || test.url;
     if (!finalUrl) {
@@ -83,29 +51,8 @@ function getFinalUrl(test, parsedUrl) {
     return finalUrl;
 }
 exports.getFinalUrl = getFinalUrl;
-function searchForChrome() {
-    const chromes = chromeFinder[launchUtils.getPlatform()]();
-    return chromes.filter((chrome) => {
-        const lowCase = chrome.toLowerCase();
-        return !(lowCase.includes('canary') ||
-            lowCase.includes('dev') ||
-            lowCase.includes('beta'));
-    })[0];
-}
-exports.searchForChrome = searchForChrome;
-async function findChrome() {
-    const existingLocation = await cliConfigProvider_1.CliConfigProvider.getConfigProperty(configKeys_1.configKeys.browserPath);
-    if (typeof existingLocation === 'string' &&
-        existingLocation &&
-        fs.existsSync(existingLocation)) {
-        return existingLocation;
-    }
-    const chromePath = searchForChrome();
-    await cliConfigProvider_1.CliConfigProvider.setConfigProperty(configKeys_1.configKeys.browserPath, chromePath);
-    return chromePath;
-}
-exports.findChrome = findChrome;
-async function launchBrowserInstance(launchArgs, userDataDir, headless, credentials, options) {
+async function launchBrowserInstance(engine, launchArgs, headless, credentials, options) {
+    const userDataDir = await engine.prepareBrowserPreferencesDirectory(options.windowPlacement);
     const optionsProxy = await maybeGetProxyOptions(options);
     if (optionsProxy) {
         options = {
@@ -161,20 +108,6 @@ function maybeLaunchBrowser(launchArgs, userDataDir, headless, credentials, opti
         credentials,
     });
 }
-async function prepareChromePreferencesDirectory(browserPreferences) {
-    return (0, async_retry_1.default)(() => {
-        const tempBrowserPreferencesDirectory = getTempChromePrefDirectory();
-        fs.ensureDirSync(path.normalize(`${tempBrowserPreferencesDirectory}/Default`));
-        const prefFilePath = path.normalize(`${tempBrowserPreferencesDirectory}/Default/Preferences`);
-        fs.writeFileSync(prefFilePath, JSON.stringify(browserPreferences, null, 3));
-        fs.chmodSync(path.normalize(`${tempBrowserPreferencesDirectory}/Default`), 0o777);
-        fs.chmodSync(prefFilePath, 0o777);
-        return tempBrowserPreferencesDirectory;
-    }, {
-        retries: 5,
-    });
-}
-exports.prepareChromePreferencesDirectory = prepareChromePreferencesDirectory;
 function removeTempBrowserPreferencesDirectory(tempDirPath) {
     try {
         fs.removeSync(tempDirPath);
@@ -182,75 +115,28 @@ function removeTempBrowserPreferencesDirectory(tempDirPath) {
     catch (error) {
     }
 }
-async function createBrowser(browserWidth, browserHeight, headless, containerTesting, tempBrowserPreferencesDirectory, options) {
+async function createBrowser(engine, browserWidth, browserHeight, headless, containerTesting, options) {
     var _a;
     const { credentials, disableIsolation, ignoreCertificateErrors, emulationConfig, enableExtensions, resourcesDirectoryOverride, } = options || {};
-    const disableFeaturesFlags = [];
-    const launchArgs = [];
-    if (containerTesting) {
-        launchArgs.push('--no-sandbox');
-    }
-    if (disableIsolation) {
-        disableFeaturesFlags.push('IsolateOrigins');
-    }
-    disableFeaturesFlags.push('site-per-process');
-    launchArgs.push(`--disable-features=${disableFeaturesFlags.join(',')}`);
-    if (options === null || options === void 0 ? void 0 : options.autoOpenDevtoolsForTabs) {
-        launchArgs.push('--auto-open-devtools-for-tabs');
-    }
-    const fakeMicrophoneMedia = (0, resourceUtil_1.findResource)('media/mabl_test_audio.wav', resourcesDirectoryOverride);
-    const fakeWebcamMedia = (0, resourceUtil_1.findResource)('media/mabl_test_pattern.y4m', resourcesDirectoryOverride);
-    const defaultDeviceDescriptor = addLaunchArgs(launchArgs, browserWidth, browserHeight, fakeMicrophoneMedia, fakeWebcamMedia, ignoreCertificateErrors, emulationConfig);
-    let ignoreDefaultArgs;
-    if (enableExtensions) {
-        ignoreDefaultArgs = ['--disable-extensions'];
-    }
-    const maybeBrowser = await launchBrowserInstance(launchArgs, tempBrowserPreferencesDirectory, headless, credentials, {
+    const { commandLineArgs: launchArgs, ignoreCommandLineDefaultArgs: ignoreDefaultArgs, defaultDeviceDescriptor, engineSpecificOptions, } = engine.getBrowserLaunchOptions(containerTesting, options, browserWidth, browserHeight, ignoreCertificateErrors, emulationConfig, enableExtensions, disableIsolation, resourcesDirectoryOverride);
+    const maybeBrowser = await launchBrowserInstance(engine, launchArgs, headless, credentials, {
         ...options,
+        ...engineSpecificOptions,
         defaultDeviceDescriptor,
         ignoreDefaultArgs,
         userAgent: (_a = options === null || options === void 0 ? void 0 : options.userAgent) !== null && _a !== void 0 ? _a : emulationConfig === null || emulationConfig === void 0 ? void 0 : emulationConfig.device_config.user_agent,
         defaultUserAgent: options === null || options === void 0 ? void 0 : options.defaultUserAgent,
-        enableScreencastModeForScreenshotTimeouts: false,
+        windowPlacement: options.windowPlacement,
     });
     if (!maybeBrowser) {
-        throw new Error('Unable to start Chrome session');
+        throw new Error('Unable to start browser session');
     }
-    maybeBrowser.on(browserLauncher_1.BrowserEvent.BrowserDestroyed, () => removeTempBrowserPreferencesDirectory(tempBrowserPreferencesDirectory));
+    maybeBrowser.on(browserLauncher_1.BrowserEvent.BrowserDestroyed, () => removeTempBrowserPreferencesDirectory(maybeBrowser.getBrowserPreferencesDirectory()));
     return maybeBrowser;
 }
 exports.createBrowser = createBrowser;
-function addLaunchArgs(launchArgs, browserWidth, browserHeight, fakeMicrophoneMediaPath, fakeWebcamMediaPath, ignoreCertificateErrors, emulationConfig) {
-    var _a, _b;
-    const defaultDeviceDescriptor = (0, mobileEmulationUtil_1.getDeviceDescriptorForEmulation)(emulationConfig);
-    launchArgs.push(`--window-size=${(_a = defaultDeviceDescriptor === null || defaultDeviceDescriptor === void 0 ? void 0 : defaultDeviceDescriptor.width) !== null && _a !== void 0 ? _a : browserWidth},${(_b = defaultDeviceDescriptor === null || defaultDeviceDescriptor === void 0 ? void 0 : defaultDeviceDescriptor.height) !== null && _b !== void 0 ? _b : browserHeight}`);
-    launchArgs.push('--use-fake-ui-for-media-stream');
-    launchArgs.push('--use-fake-device-for-media-stream');
-    launchArgs.push(`--use-file-for-fake-audio-capture=${fakeMicrophoneMediaPath}`);
-    launchArgs.push(`--use-file-for-fake-video-capture=${fakeWebcamMediaPath}`);
-    launchArgs.push('--disable-notifications');
-    if (ignoreCertificateErrors) {
-        launchArgs.push('--ignore-certificate-errors');
-    }
-    return defaultDeviceDescriptor;
-}
-function addExecutionEngineLaunchArgs(browserWidth, browserHeight, proxyInfo, emulationConfig) {
-    const launchArgs = [...baseExecutionEngineLaunchArgs];
-    if (proxyInfo.pacProxy) {
-        launchArgs.push(`--proxy-pac-url=${proxyInfo.pacProxy}`);
-    }
-    else if (proxyInfo.socksProxy) {
-        launchArgs.push(`--proxy-server=socks=${proxyInfo.socksProxy}`);
-    }
-    else {
-        throw new Error('no proxy provided for cloud run');
-    }
-    const defaultDeviceDescriptor = addLaunchArgs(launchArgs, browserWidth, browserHeight, ExecutionEngineFakeAudioFilePath, ExecutionEngineFakeVideoFilePath, true, emulationConfig);
-    loggingProvider_1.logger.debug(`launchArgs: ${JSON.stringify(launchArgs)}`);
-    return { defaultDeviceDescriptor, launchArgs };
-}
-exports.addExecutionEngineLaunchArgs = addExecutionEngineLaunchArgs;
-async function createBrowserForExecutionEngine(browserWidth, browserHeight, headless, tempBrowserPreferencesDirectory, proxyInfo, options) {
+async function createBrowserForExecutionEngine(engine, browserWidth, browserHeight, headless, proxyInfo, options) {
+    const tempBrowserPreferencesDirectory = await engine.prepareBrowserPreferencesDirectory();
     const { credentials, deviceEmulationConfig, userAgent } = options;
     if (deviceEmulationConfig && !userAgent) {
         options = {
@@ -258,13 +144,13 @@ async function createBrowserForExecutionEngine(browserWidth, browserHeight, head
             userAgent: deviceEmulationConfig.device_config.user_agent,
         };
     }
-    const { launchArgs, defaultDeviceDescriptor } = addExecutionEngineLaunchArgs(browserWidth, browserHeight, proxyInfo, deviceEmulationConfig);
+    const { launchArgs, defaultDeviceDescriptor } = engine.getExecutionEngineBrowserLaunchOptions(browserWidth, browserHeight, proxyInfo, deviceEmulationConfig);
     if (defaultDeviceDescriptor) {
         options = { ...options, defaultDeviceDescriptor };
     }
     const maybeBrowser = await maybeLaunchBrowser(launchArgs, tempBrowserPreferencesDirectory, headless, credentials, options);
     if (!maybeBrowser) {
-        throw new Error('Unable to start Chrome session');
+        throw new Error('Unable to start browser session');
     }
     return maybeBrowser;
 }
@@ -584,31 +470,6 @@ function logTestInfoIfPresent(description, infoArg) {
     }
 }
 exports.logTestInfoIfPresent = logTestInfoIfPresent;
-function generateChromiumPreferencesFile(windowPlacement) {
-    const preferences = {
-        download: {
-            open_pdf_in_system_reader: true,
-            prompt_for_download: false,
-        },
-        profile: {
-            avatar_index: 5,
-            name: 'mabl',
-        },
-        plugins: {
-            always_open_pdf_externally: true,
-        },
-    };
-    if (windowPlacement) {
-        preferences.browser = {
-            window_placement: {
-                always_on_top: false,
-                ...windowPlacement,
-            },
-        };
-    }
-    return preferences;
-}
-exports.generateChromiumPreferencesFile = generateChromiumPreferencesFile;
 function createDownloadDirectory() {
     return fs.mkdtempSync(path.join(os.tmpdir(), `mablTestRun-${Date.now()}-`));
 }

package/commands/tests/tests_cmds/import.js

@@ -38,9 +38,9 @@ const RichPromise_1 = __importDefault(require("../../../util/RichPromise"));
 const pureUtil_1 = require("../../../util/pureUtil");
 const constants_1 = require("../../constants");
 const authenticationProvider_1 = require("../../../providers/authenticationProvider");
-const testsUtil_1 = require("../testsUtil");
 const asyncUtil_1 = require("../../../util/asyncUtil");
 const loggingProvider_1 = require("../../../providers/logging/loggingProvider");
+const chromiumBrowserEngine_1 = require("../../../browserEngines/chromiumBrowserEngine");
 const { MablTestRunner, MablTestsRunner } = require('../../../execution');
 const DEFAULT_ASYNC_TIMEOUT_MILLIS = 120000;
 const CommandArgAuto = 'auto-save';
@@ -245,7 +245,7 @@ async function runTests(workspaceId, name, apiClient, importedTests) {
     var _a, _b;
     const flows = importedTests.map((steps) => stepsToFlow(workspaceId, steps));
     const firstUrl = (_a = flows.find((flow) => flow.url)) === null || _a === void 0 ? void 0 : _a.url;
-    const browserPath = await (0, testsUtil_1.findChrome)();
+    const browserPath = await new chromiumBrowserEngine_1.ChromiumBrowserEngine().findBrowserExecutable();
     for (let flowIndex = 0; flowIndex < flows.length; flowIndex++) {
         loggingProvider_1.logger.info(`Running test ${flowIndex + 1} of ${flows.length}.`);
         const flow = flows[flowIndex];

package/commands/tests/tests_cmds/run.js

@@ -9,6 +9,7 @@ const mablApi_1 = require("../../../mablApi");
 const reporter_1 = require("../../../reporters/reporter");
 const browserTypes_1 = require("../../browserTypes");
 const execution_1 = require("../../../execution");
+const defaultEnv_1 = require("../../../env/defaultEnv");
 const chalk = require('chalk');
 const execution = require('../../../execution/index');
 exports.command = `run`;
@@ -161,25 +162,19 @@ exports.builder = (yargs) => {
         choices: Object.keys(mablApi_1.JourneyParameters.PageLoadWaitEnum).map((pageLoadWait) => pageLoadWait.toLowerCase()),
     })
         .option(constants_1.CommandArgBrowser, {
-        describe: 'Target browser to execute the test against [chrome,edge]',
+        describe: `Target browser to execute the test against, must be one of ${constants_1.ValidBrowserTypesForLocalRuns}, defaults to ${constants_1.DefaultBrowserType}`,
         type: 'string',
         nargs: 1,
-        choices: [browserTypes_1.BrowserType.Chrome, browserTypes_1.BrowserType.Edge],
+        choices: constants_1.ValidBrowserTypesForLocalRuns,
         hidden: true,
     })
         .check((argv) => {
         (0, testsUtil_1.validateRunCommandWithLabels)(argv[constants_1.CommandArgId], argv[constants_1.CommandArgLabelsInclude], argv[constants_1.CommandArgLabelsExclude], argv[constants_1.CommandArgTestRunId], argv[constants_1.CommandArgFromPlanId], true, argv[constants_1.CommandArgTestFile]);
-        validateBrowserInput(argv[constants_1.CommandArgBrowser]);
         const httpHeaders = argv[constants_1.CommandArgHttpHeaders];
         (0, util_1.validateArrayInputs)(httpHeaders, 'HTTP headers must be SPACE delimited, e.g. "--http-headers "foo:bar" "baz:qux"');
         argv[constants_1.CommandArgHttpHeaders] = (0, util_1.validateValuePairInputs)('HTTP header', httpHeaders);
         return true;
     });
-    function validateBrowserInput(browser) {
-        if (browser && !['chrome', 'edge'].includes(browser)) {
-            throw new Error('invalid browser type, valid browser types are [chrome,edge]');
-        }
-    }
 };
 const exitCodeOnError = 1;
 exports.handler = (0, util_1.failWrapper)(run, exitCodeOnError);
@@ -204,8 +199,14 @@ async function run(parsed) {
         case 'edge':
             browserType = browserTypes_1.BrowserType.Edge;
             break;
-        default:
+        case 'firefox':
+            browserType = browserTypes_1.BrowserType.Firefox;
+            break;
+        case 'chrome':
             browserType = browserTypes_1.BrowserType.Chrome;
+            break;
+        default:
+            browserType = constants_1.DefaultBrowserType;
     }
     const testRunnerConfig = {
         _cliCreated: true,
@@ -269,9 +270,13 @@ async function run(parsed) {
     if (results.numFailedTests) {
         results.testResults.forEach((result) => {
             if (result.status === 'failed') {
-                loggingProvider_1.logger.info(chalk.red(` - ${result.testName} (${(0, testsUtil_1.calculateTotalTimeSeconds)(result.startTime, result.endTime)}s)`));
+                loggingProvider_1.logger.info(chalk.red(` - ${result.testName} (${(0, testsUtil_1.calculateTotalTimeSeconds)(result.startTime, result.endTime)}s) - ${result.testId}`));
             }
         });
+        if (parsed.labels || parsed['from-plan-id'] || process.env.CI) {
+            loggingProvider_1.logger.info(`Rerun any failed test with the following command template:`);
+            loggingProvider_1.logger.info(`${chalk.magenta(generateRunCommandTemplate(parsed, results))}`);
+        }
     }
     loggingProvider_1.logger.info(`Total time: ${(0, testsUtil_1.calculateTotalTimeSeconds)(commandStartTime, Date.now())} seconds`);
     if (parsed.reporter) {
@@ -283,3 +288,23 @@ async function run(parsed) {
     return 'done';
 }
 exports.run = run;
+function generateRunCommandTemplate(parsed, testResults) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const testResult = testResults.testResults[0];
+    let templateCommand = `${defaultEnv_1.SCRIPT_NAME} ${parsed._.join(' ')} \\\n`;
+    if ((_a = testResult === null || testResult === void 0 ? void 0 : testResult.rerunConfig) === null || _a === void 0 ? void 0 : _a.environmentId) {
+        templateCommand = `${templateCommand} --${constants_1.CommandArgEnvironmentId} ${(_b = testResult === null || testResult === void 0 ? void 0 : testResult.rerunConfig) === null || _b === void 0 ? void 0 : _b.environmentId} \\\n`;
+    }
+    if ((_c = testResult === null || testResult === void 0 ? void 0 : testResult.rerunConfig) === null || _c === void 0 ? void 0 : _c.credentialsId) {
+        templateCommand = `${templateCommand} --${constants_1.CommandArgCredentials} ${(_d = testResult === null || testResult === void 0 ? void 0 : testResult.rerunConfig) === null || _d === void 0 ? void 0 : _d.credentialsId} \\\n`;
+    }
+    if ((_e = testResult === null || testResult === void 0 ? void 0 : testResult.rerunConfig) === null || _e === void 0 ? void 0 : _e.url) {
+        templateCommand = `${templateCommand} --${constants_1.CommandArgUrl} ${(_f = testResult === null || testResult === void 0 ? void 0 : testResult.rerunConfig) === null || _f === void 0 ? void 0 : _f.url} \\\n`;
+    }
+    if ((_g = testResult === null || testResult === void 0 ? void 0 : testResult.rerunConfig) === null || _g === void 0 ? void 0 : _g.branch) {
+        templateCommand = `${templateCommand} --${constants_1.CommandArgMablBranch} ${testResult.rerunConfig.branch} \\\n`;
+    }
+    const testIdVal = parsed.id ? parsed.id : '<TEST-ID>';
+    templateCommand = `${templateCommand} --${constants_1.CommandArgId} ${testIdVal}`;
+    return templateCommand;
+}

package/commands/workspaces/workspace_cmds/copy.js

@@ -33,8 +33,7 @@ function getTimestamp() {
 }
 function hasOwnerRoleInWorkspace(user, workspaceId) {
     var _a;
-    const hasOwnerRole = (_a = user.roles) === null || _a === void 0 ? void 0 : _a.some((role) => role.organization_id === workspaceId &&
-        role.role === mablApi_1.UserRole.RoleEnum.Owner);
+    const hasOwnerRole = (_a = user.roles) === null || _a === void 0 ? void 0 : _a.some((role) => role.organization_id === workspaceId && role.role === mablApi_1.UserRoleEnum.Owner);
     if (!hasOwnerRole) {
         loggingProvider_1.logger.warn(chalk_1.default.yellow(`You must be an owner in both workspaces to copy. You do not have owner permissions in workspace: ${workspaceId}`));
     }

package/core/messaging/messaging.js

@@ -1,9 +1,10 @@
 "use strict";
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDefaultLogMetadataForInfo = exports.MablCoreProcessAction = exports.MablCoreAction = exports.ObservationErrorSeverity = exports.ObservationErrorCode = exports.ExecutionPhase = exports.EventChannelMessageType = exports.getEmitter = exports.mablEventEmitter = exports.MablCoreEventEmitter = void 0;
+exports.createAssertFailureMessage = exports.getDefaultLogMetadataForInfo = exports.MablCoreProcessAction = exports.MablCoreAction = exports.ObservationErrorSeverity = exports.ObservationErrorCode = exports.ExecutionPhase = exports.EventChannelMessageType = exports.getEmitter = exports.mablEventEmitter = exports.MablCoreEventEmitter = void 0;
 const events_1 = require("events");
 const loggingProvider_1 = require("../../providers/logging/loggingProvider");
+const pureUtil_1 = require("../../util/pureUtil");
 const NO_ID_PLACEHOLDER = 'NO_ID_PROVIDED';
 class MablCoreEventEmitter {
     constructor(debug) {
@@ -101,3 +102,16 @@ function getDefaultLogMetadataForInfo(testId, testInvariantId) {
     };
 }
 exports.getDefaultLogMetadataForInfo = getDefaultLogMetadataForInfo;
+function createAssertFailureMessage(assertFailure) {
+    if (assertFailure) {
+        const { reason, expected, found, continueOnFailure } = assertFailure;
+        return {
+            reason,
+            expected: (0, pureUtil_1.stringifyIfPresent)(expected),
+            found: (0, pureUtil_1.stringifyIfPresent)(found),
+            continueOnFailure,
+        };
+    }
+    return;
+}
+exports.createAssertFailureMessage = createAssertFailureMessage;