@applitools/core 4.0.2 → 4.2.0

package/CHANGELOG.md

@@ -1,5 +1,129 @@
 # Changelog
 
+## [4.2.0](https://github.com/applitools/eyes.sdk.javascript1/compare/js/core@4.1.0...js/core@4.2.0) (2023-11-21)
+
+
+### Features
+
+* added notification about outdated sdk version ([#2012](https://github.com/applitools/eyes.sdk.javascript1/issues/2012)) ([0f0a646](https://github.com/applitools/eyes.sdk.javascript1/commit/0f0a6462a56e7c97f9a22173c3b63af91e220adb))
+* log driver environment info to splank ([#2023](https://github.com/applitools/eyes.sdk.javascript1/issues/2023)) ([11d0546](https://github.com/applitools/eyes.sdk.javascript1/commit/11d0546e76962b4c231e140b0229b8402da27f69))
+
+
+### Bug Fixes
+
+* return result when error in the ufg ([#2020](https://github.com/applitools/eyes.sdk.javascript1/issues/2020)) ([28cdcc5](https://github.com/applitools/eyes.sdk.javascript1/commit/28cdcc5a859641d0edde032165c5068fcc580c8d))
+
+
+### Dependencies
+
+* @applitools/utils bumped to 1.6.3
+  #### Bug Fixes
+
+  * don't throw error for missing configuration file ([#2034](https://github.com/applitools/eyes.sdk.javascript1/issues/2034)) ([d084e7b](https://github.com/applitools/eyes.sdk.javascript1/commit/d084e7bf6e1727e3969622b4e597881f18241eb3))
+* @applitools/socket bumped to 1.1.13
+
+* @applitools/dom-snapshot bumped to 4.7.14
+  #### Bug Fixes
+
+  * preserve css declarations order in dom-snapshot ([#2037](https://github.com/applitools/eyes.sdk.javascript1/issues/2037)) ([1381851](https://github.com/applitools/eyes.sdk.javascript1/commit/1381851d46f28ea7e7724025c4eab33c81c4e144))
+* @applitools/spec-driver-webdriver bumped to 1.0.50
+  #### Bug Fixes
+
+  * send devtool commands in chromium ([#2039](https://github.com/applitools/eyes.sdk.javascript1/issues/2039)) ([ff42043](https://github.com/applitools/eyes.sdk.javascript1/commit/ff42043c3d9f110eb7b22ab1a8448d77859923b4))
+
+
+
+* @applitools/spec-driver-puppeteer bumped to 1.3.0
+  #### Features
+
+  * added notification about outdated sdk version ([#2012](https://github.com/applitools/eyes.sdk.javascript1/issues/2012)) ([0f0a646](https://github.com/applitools/eyes.sdk.javascript1/commit/0f0a6462a56e7c97f9a22173c3b63af91e220adb))
+
+
+
+* @applitools/logger bumped to 2.0.13
+
+* @applitools/req bumped to 1.6.3
+
+* @applitools/image bumped to 1.1.8
+
+* @applitools/spec-driver-selenium bumped to 1.5.64
+
+* @applitools/driver bumped to 1.15.1
+
+* @applitools/screenshoter bumped to 3.8.16
+
+* @applitools/nml-client bumped to 1.5.16
+
+* @applitools/tunnel-client bumped to 1.3.1
+
+* @applitools/ufg-client bumped to 1.9.8
+
+* @applitools/ec-client bumped to 1.7.16
+
+* @applitools/core-base bumped to 1.7.3
+  #### Bug Fixes
+
+  * remove connection timeout in case of a long running tasks ([#2006](https://github.com/applitools/eyes.sdk.javascript1/issues/2006)) ([49a596a](https://github.com/applitools/eyes.sdk.javascript1/commit/49a596ac1b022a66b5c07ecfee458cc061891ce0))
+  * return result when error in the ufg ([#2020](https://github.com/applitools/eyes.sdk.javascript1/issues/2020)) ([28cdcc5](https://github.com/applitools/eyes.sdk.javascript1/commit/28cdcc5a859641d0edde032165c5068fcc580c8d))
+
+
+
+
+## [4.1.0](https://github.com/applitools/eyes.sdk.javascript1/compare/js/core@4.0.2...js/core@4.1.0) (2023-11-07)
+
+
+### Features
+
+* added warning when driver used with capabilities that may conflict with applitools lib workflow ([#2011](https://github.com/applitools/eyes.sdk.javascript1/issues/2011)) ([081006d](https://github.com/applitools/eyes.sdk.javascript1/commit/081006d879894db03a2713129b66586496b6eb02))
+
+
+### Bug Fixes
+
+* fixed issue that caused dom snapshots to be taken for different viewport sizes when layout breakpoints were explicitly turned off ([4121876](https://github.com/applitools/eyes.sdk.javascript1/commit/4121876189f133b6023cfea52ca91c02c31079fb))
+
+
+### Dependencies
+
+* @applitools/dom-shared bumped to 1.0.11
+  #### Bug Fixes
+
+  * (java/eyes-appium-java5): fix incorrect stitchMode mapping in checkSettings ([c70428e](https://github.com/applitools/eyes.sdk.javascript1/commit/c70428ec83e26b8b5e398ff11814f8376ca97d56))
+* @applitools/dom-capture bumped to 11.2.4
+  #### Bug Fixes
+
+  * (java/eyes-appium-java5): fix incorrect stitchMode mapping in checkSettings ([c70428e](https://github.com/applitools/eyes.sdk.javascript1/commit/c70428ec83e26b8b5e398ff11814f8376ca97d56))
+
+
+
+* @applitools/dom-snapshot bumped to 4.7.13
+  #### Bug Fixes
+
+  * (java/eyes-appium-java5): fix incorrect stitchMode mapping in checkSettings ([c70428e](https://github.com/applitools/eyes.sdk.javascript1/commit/c70428ec83e26b8b5e398ff11814f8376ca97d56))
+  * handled duplicated style properties in inline style tags ([#2014](https://github.com/applitools/eyes.sdk.javascript1/issues/2014)) ([2f8bada](https://github.com/applitools/eyes.sdk.javascript1/commit/2f8bada9cd44c65a69e54cbd08f57534632f12d2))
+
+
+
+* @applitools/spec-driver-webdriver bumped to 1.0.49
+
+* @applitools/spec-driver-selenium bumped to 1.5.63
+
+* @applitools/spec-driver-puppeteer bumped to 1.2.5
+
+* @applitools/driver bumped to 1.15.0
+  #### Features
+
+  * added warning when driver used with capabilities that may conflict with applitools lib workflow ([#2011](https://github.com/applitools/eyes.sdk.javascript1/issues/2011)) ([081006d](https://github.com/applitools/eyes.sdk.javascript1/commit/081006d879894db03a2713129b66586496b6eb02))
+* @applitools/ufg-client bumped to 1.9.7
+  #### Bug Fixes
+
+  * added retries on ufg requests that respond with 503 status code ([7d78917](https://github.com/applitools/eyes.sdk.javascript1/commit/7d78917d559fa182c6723ca34cef2118cf08a036))
+* @applitools/screenshoter bumped to 3.8.15
+
+* @applitools/nml-client bumped to 1.5.15
+
+* @applitools/ec-client bumped to 1.7.15
+
+
 ## [4.0.2](https://github.com/applitools/eyes.sdk.javascript1/compare/js/core@4.0.1...js/core@4.0.2) (2023-10-30)
 
 

package/dist/automation/get-results.js

@@ -1,25 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeGetResults = void 0;
-const abort_error_1 = require("../errors/abort-error");
 function makeGetResults({ eyes, logger: mainLogger }) {
     return async function getResults({ settings, logger = mainLogger, } = {}) {
         logger = logger.extend(mainLogger);
         logger.log('Command "getResults" is called with settings', settings);
         return Promise.all(Array.from(eyes.storage.values(), async (item) => {
-            var _a;
             try {
                 const [eyes] = await Promise.all([item.eyes, ...item.jobs]);
                 const [result] = await eyes.getResults({ settings, logger });
                 return { ...result, environment: eyes.test.environment };
             }
             catch (error) {
-                if (error instanceof abort_error_1.AbortError && ((_a = error.info) === null || _a === void 0 ? void 0 : _a.eyes)) {
-                    logger.warn('Command "getResults" received an abort error during performing', settings);
-                    const [result] = await error.info.eyes.getResults({ settings, logger });
-                    return { ...result, environment: error.info.environment };
-                }
-                logger.fatal('Command "getResults" received an error during performing', settings);
+                logger.fatal('Command "getResults" received an error', error, 'during performing with settings', settings);
                 throw error;
             }
         }));

package/dist/check.js

@@ -29,6 +29,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeCheck = void 0;
 const driver_1 = require("@applitools/driver");
 const utils = __importStar(require("@applitools/utils"));
+const lang = __importStar(require("./lang"));
 const chalk_1 = __importDefault(require("chalk"));
 function makeCheck({ type: defaultType = 'classic', eyes, target: defaultTarget, spec, logger: mainLogger, }) {
     let stepIndex = 0;
@@ -57,7 +58,7 @@ function makeCheck({ type: defaultType = 'classic', eyes, target: defaultTarget,
         settings.stepIndex = stepIndex++;
         (_p = settings.waitBetweenStitches) !== null && _p !== void 0 ? _p : (settings.waitBetweenStitches = utils.types.isObject(settings.lazyLoad) ? settings.lazyLoad.waitingTime : 100);
         if (settings.matchLevel === 'Content') {
-            logger.console.log(chalk_1.default.yellow(`The "Content" match level value has been deprecated, use "IgnoreColors" instead.`));
+            logger.console.log(chalk_1.default.yellow(lang.matchLevelContentDeprecatedWarning));
         }
         const driver = (0, driver_1.isDriver)(target, spec)
             ? await (0, driver_1.makeDriver)({ spec, driver: target, reset: target === defaultTarget, logger })

package/dist/classic/check-and-close.js

@@ -22,6 +22,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeCheckAndClose = void 0;
 const driver_1 = require("@applitools/driver");
@@ -31,10 +34,12 @@ const wait_for_lazy_load_1 = require("../automation/utils/wait-for-lazy-load");
 const uniquify_environments_1 = require("../automation/utils/uniquify-environments");
 const to_environment_key_1 = require("../automation/utils/to-environment-key");
 const abort_error_1 = require("../errors/abort-error");
+const chalk_1 = __importDefault(require("chalk"));
 const utils = __importStar(require("@applitools/utils"));
+const lang = __importStar(require("../lang"));
 function makeCheckAndClose({ eyes, target: defaultTarget, environments: defaultEnvironments = [], spec, signal, logger: mainLogger, }) {
     return async function checkAndClose({ target = defaultTarget, settings = {}, logger = mainLogger, } = {}) {
-        var _a, _b;
+        var _a, _b, _c;
         logger = logger.extend(mainLogger);
         logger.log('Command "checkAndClose" is called with settings', settings);
         if (!target)
@@ -70,7 +75,9 @@ function makeCheckAndClose({ eyes, target: defaultTarget, environments: defaultE
                 });
             }
             const { elementReferencesToCalculate, getBaseCheckSettings } = (0, to_base_check_settings_1.toBaseCheckSettings)({ settings });
-            if (driverEnvironment.isWeb || !driverEnvironment.isApplitoolsLib || settings.screenshotMode === 'default') {
+            if (driverEnvironment.isWeb ||
+                !((_c = driverEnvironment.applitoolsLib) === null || _c === void 0 ? void 0 : _c.instrumented) ||
+                settings.screenshotMode === 'default') {
                 const screenshots = await (0, take_screenshots_1.takeScreenshots)({
                     driver,
                     settings: {
@@ -89,6 +96,13 @@ function makeCheckAndClose({ eyes, target: defaultTarget, environments: defaultE
                 });
             }
             else {
+                if (driverEnvironment.applitoolsLib.conflictingCapabilities) {
+                    const message = lang.applitoolsLibConflictingCapabilitiesWarning({
+                        conflictingCapabilities: driverEnvironment.applitoolsLib.conflictingCapabilities,
+                    });
+                    logger.console.log(chalk_1.default.yellow(message));
+                    logger.log(message);
+                }
                 const nmlClient = await eyes.core.getNMLClient({
                     driver,
                     settings: { ...eyes.test.eyesServer, supportedEnvironmentsUrl: eyes.test.supportedEnvironmentsUrl },
@@ -147,9 +161,8 @@ function makeCheckAndClose({ eyes, target: defaultTarget, environments: defaultE
                 }
                 catch (error) {
                     environmentLogger.error(`Check on environment with id "${(_c = baseEyes.test.environment) === null || _c === void 0 ? void 0 : _c.environmentId}" failed due to an error`, error);
-                    await baseEyes.abort({ logger: environmentLogger });
-                    error.info = { eyes: baseEyes };
-                    throw error;
+                    if (baseEyes.running && !(signal === null || signal === void 0 ? void 0 : signal.aborted))
+                        await baseEyes.abort({ logger: environmentLogger, settings: { reason: error } });
                 }
             }
             catch (error) {

package/dist/classic/check.js

@@ -22,6 +22,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeCheck = void 0;
 const driver_1 = require("@applitools/driver");
@@ -31,10 +34,12 @@ const wait_for_lazy_load_1 = require("../automation/utils/wait-for-lazy-load");
 const uniquify_environments_1 = require("../automation/utils/uniquify-environments");
 const to_environment_key_1 = require("../automation/utils/to-environment-key");
 const abort_error_1 = require("../errors/abort-error");
+const chalk_1 = __importDefault(require("chalk"));
 const utils = __importStar(require("@applitools/utils"));
+const lang = __importStar(require("../lang"));
 function makeCheck({ eyes, target: defaultTarget, environments: defaultEnvironments = [], spec, signal, logger: mainLogger, }) {
     return async function check({ target = defaultTarget, settings = {}, logger = mainLogger, } = {}) {
-        var _a, _b;
+        var _a, _b, _c;
         logger = logger.extend(mainLogger);
         logger.log('Command "check" is called with settings', settings);
         if (!target)
@@ -70,7 +75,9 @@ function makeCheck({ eyes, target: defaultTarget, environments: defaultEnvironme
                 });
             }
             const { elementReferencesToCalculate, getBaseCheckSettings } = (0, to_base_check_settings_1.toBaseCheckSettings)({ settings });
-            if (driverEnvironment.isWeb || !driverEnvironment.isApplitoolsLib || settings.screenshotMode === 'default') {
+            if (driverEnvironment.isWeb ||
+                !((_c = driverEnvironment.applitoolsLib) === null || _c === void 0 ? void 0 : _c.instrumented) ||
+                settings.screenshotMode === 'default') {
                 const screenshots = await (0, take_screenshots_1.takeScreenshots)({
                     driver,
                     settings: {
@@ -89,6 +96,13 @@ function makeCheck({ eyes, target: defaultTarget, environments: defaultEnvironme
                 });
             }
             else {
+                if (driverEnvironment.applitoolsLib.conflictingCapabilities) {
+                    const message = lang.applitoolsLibConflictingCapabilitiesWarning({
+                        conflictingCapabilities: driverEnvironment.applitoolsLib.conflictingCapabilities,
+                    });
+                    logger.console.log(chalk_1.default.yellow(message));
+                    logger.log(message);
+                }
                 const nmlClient = await eyes.core.getNMLClient({
                     driver,
                     settings: { ...eyes.test.eyesServer, supportedEnvironmentsUrl: eyes.test.supportedEnvironmentsUrl },
@@ -148,9 +162,7 @@ function makeCheck({ eyes, target: defaultTarget, environments: defaultEnvironme
                 catch (error) {
                     environmentLogger.error(`Check on environment with id "${(_c = baseEyes.test.environment) === null || _c === void 0 ? void 0 : _c.environmentId}" failed due to an error`, error);
                     if (baseEyes.running && !(signal === null || signal === void 0 ? void 0 : signal.aborted))
-                        await baseEyes.abort({ logger: environmentLogger });
-                    error.info = { eyes: baseEyes };
-                    throw error;
+                        await baseEyes.abort({ logger: environmentLogger, settings: { reason: error } });
                 }
             }
             catch (error) {

package/dist/core.js

@@ -39,11 +39,14 @@ const make_manager_1 = require("./make-manager");
 const close_batch_1 = require("./close-batch");
 const delete_test_1 = require("./delete-test");
 const extract_test_environment_1 = require("./utils/extract-test-environment");
+const validate_sdk_version_1 = require("./utils/validate-sdk-version");
 const utils = __importStar(require("@applitools/utils"));
 function makeCore({ spec, clients, concurrency, base: defaultBase, environment: defaultEnvironment, agentId = 'core', cwd = process.cwd(), logger: defaultLogger, asyncCache, } = {}) {
     const logger = (0, logger_1.makeLogger)({ logger: defaultLogger, format: { label: 'core' } });
     const environment = (0, extract_test_environment_1.extractTestEnvironment)(defaultEnvironment);
     logger.log(`Core is initialized ${defaultBase ? 'with' : 'without'} custom base core and environment`, environment);
+    if (environment.sdk)
+        (0, validate_sdk_version_1.validateSdkVersion)(environment.sdk, { logger });
     const base = defaultBase !== null && defaultBase !== void 0 ? defaultBase : (0, core_base_1.makeCore)({ agentId, cwd, logger });
     return utils.general.extend(base, core => {
         return {

package/dist/get-eyes-results.js

@@ -33,8 +33,9 @@ function makeGetEyesResults({ eyes, logger: mainLogger, }) {
         const results = await typedEyes.getResults({ settings, logger });
         if (settings === null || settings === void 0 ? void 0 : settings.throwErr) {
             results.forEach(result => {
+                var _a;
                 if (result.status !== 'Passed')
-                    throw new test_error_1.TestError(result);
+                    throw (_a = result === null || result === void 0 ? void 0 : result.reason) !== null && _a !== void 0 ? _a : new test_error_1.TestError(result);
             });
         }
         return results;

package/dist/get-manager-results.js

@@ -36,12 +36,15 @@ function makeGetManagerResults({ core, storage, logger: mainLogger, }) {
             try {
                 const results = await eyes.getResults({ settings: { ...settings, throwErr: false }, logger });
                 return promise.then(containers => {
-                    return containers.concat(results.map(result => ({
-                        result,
-                        error: result.status !== 'Passed' ? new test_error_1.TestError(result) : undefined,
-                        userTestId: result.userTestId,
-                        environment: result.environment,
-                    })));
+                    return containers.concat(results.map(result => {
+                        var _a;
+                        return ({
+                            result,
+                            error: result.status !== 'Passed' ? (_a = result.reason) !== null && _a !== void 0 ? _a : new test_error_1.TestError(result) : undefined,
+                            userTestId: result.userTestId,
+                            environment: result.environment,
+                        });
+                    }));
                 });
             }
             catch (error) {

package/dist/lang.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applitoolsLibConflictingCapabilitiesWarning = exports.requestedEnvironmentOutOfDriverBoundsWarning = exports.breakpointOutOfDriverBoundsWarning = exports.requestedEnvironmentSmallerThenBreakpointWarning = exports.outdatedSdkVersionWarning = exports.edgeUfgEnvironmentDeprecatedWarning = exports.matchLevelContentDeprecatedWarning = void 0;
+exports.matchLevelContentDeprecatedWarning = `The "Content" match level value has been deprecated, use "IgnoreColors" instead.`;
+exports.edgeUfgEnvironmentDeprecatedWarning = `The 'edge' option that is being used in your browsers' configuration will soon be deprecated. Please change it to either 'edgelegacy' for the legacy version or to 'edgechromium' for the new Chromium-based version. Please note, when using the built-in BrowserType enum, then the values are BrowserType.EDGE_LEGACY and BrowserType.EDGE_CHROMIUM, respectively.`;
+const outdatedSdkVersionWarning = (options) => {
+    return `You are using "${options.currentVersion}" and there is a newer version "${options.latestVersion}" of the "${options.name}" SDK.`;
+};
+exports.outdatedSdkVersionWarning = outdatedSdkVersionWarning;
+const requestedEnvironmentSmallerThenBreakpointWarning = (options) => {
+    const browsers = options.browsers.map(({ name, width }) => `(${name}, ${width})`).join(', ');
+    return `The following configuration's viewport-widths are smaller than the smallest configured layout breakpoint (${options.breakpoint} pixels): [${browsers}]. As a fallback, the resources that will be used for these configurations have been captured on a viewport-width of ${options.breakpoint} - 1 pixels. If an additional layout breakpoint is needed for you to achieve better results - please add it to your configuration.`;
+};
+exports.requestedEnvironmentSmallerThenBreakpointWarning = requestedEnvironmentSmallerThenBreakpointWarning;
+const breakpointOutOfDriverBoundsWarning = (options) => {
+    const browsers = options.browsers.map(({ name, width }) => `(${name}, ${width})`).join(', ');
+    return `One of the configured layout breakpoints is ${options.requiredWidth} pixels, while your local browser has a limit of ${options.actualWidth}, so the SDK couldn't resize it to the desired size. As a fallback, the resources that will be used for the following configurations: [${browsers}] have been captured on the browser's limit (${options.actualWidth} pixels). To resolve this, you may use a headless browser as it can be resized to any size.`;
+};
+exports.breakpointOutOfDriverBoundsWarning = breakpointOutOfDriverBoundsWarning;
+const requestedEnvironmentOutOfDriverBoundsWarning = (options) => {
+    const browsers = options.browsers.map(({ name }) => `(${name})`).join(', ');
+    return `The following configurations [${browsers}] have a viewport-width of ${options.requiredWidth} pixels, while your local browser has a limit of ${options.actualWidth} pixels, so the SDK couldn't resize it to the desired size. As a fallback, the resources that will be used for these checkpoints have been captured on the browser's limit (${options.actualWidth} pixels). To resolve this, you may use a headless browser as it can be resized to any size.`;
+};
+exports.requestedEnvironmentOutOfDriverBoundsWarning = requestedEnvironmentOutOfDriverBoundsWarning;
+const applitoolsLibConflictingCapabilitiesWarning = (options) => {
+    const conflictingCapabilities = Object.entries(options.conflictingCapabilities)
+        .map(entry => entry.join(': '))
+        .join(', ');
+    return `We have identified ${conflictingCapabilities} in your driver capabilities, this may prevent Applitools Native Library from loading. If you are not sure whether this will cause a problem, contact Support.`;
+};
+exports.applitoolsLibConflictingCapabilitiesWarning = applitoolsLibConflictingCapabilitiesWarning;

package/dist/open-eyes.js

@@ -56,16 +56,27 @@ function makeOpenEyes({ type: defaultType = 'classic', clients, concurrency, bat
         (_r = settings.ignoreBaseline) !== null && _r !== void 0 ? _r : (settings.ignoreBaseline = false);
         (_s = settings.compareWithParentBranch) !== null && _s !== void 0 ? _s : (settings.compareWithParentBranch = false);
         const driver = target && (await (0, driver_1.makeDriver)({ spec, driver: target, logger, customConfig: settings }));
-        const environments = (_t = config === null || config === void 0 ? void 0 : config.check) === null || _t === void 0 ? void 0 : _t.environments;
+        const driverEnvironment = await (driver === null || driver === void 0 ? void 0 : driver.getEnvironment());
+        const driverUrl = await (driver === null || driver === void 0 ? void 0 : driver.getDriverUrl());
         core.logEvent({
             settings: {
                 ...settings,
                 level: 'Notice',
                 event: {
                     type: 'openEyes',
-                    environment,
+                    userTestId: settings.userTestId,
                     concurrency,
-                    driverUrl: await (driver === null || driver === void 0 ? void 0 : driver.getDriverUrl()),
+                    environment,
+                    driver: {
+                        deviceName: driverEnvironment === null || driverEnvironment === void 0 ? void 0 : driverEnvironment.deviceName,
+                        browserName: driverEnvironment === null || driverEnvironment === void 0 ? void 0 : driverEnvironment.browserName,
+                        browserVersion: driverEnvironment === null || driverEnvironment === void 0 ? void 0 : driverEnvironment.browserVersion,
+                        platformName: driverEnvironment === null || driverEnvironment === void 0 ? void 0 : driverEnvironment.platformName,
+                        platformVersion: driverEnvironment === null || driverEnvironment === void 0 ? void 0 : driverEnvironment.platformVersion,
+                        isApplitoolsLib: (_t = driverEnvironment === null || driverEnvironment === void 0 ? void 0 : driverEnvironment.applitoolsLib) === null || _t === void 0 ? void 0 : _t.instrumented,
+                        isEC: driverEnvironment === null || driverEnvironment === void 0 ? void 0 : driverEnvironment.isEC,
+                    },
+                    driverUrl,
                 },
             },
             logger,
@@ -81,14 +92,17 @@ function makeOpenEyes({ type: defaultType = 'classic', clients, concurrency, bat
             logger,
         });
         const eyes = await getTypedEyes({ logger });
-        return utils.general.extend(eyes, eyes => ({
-            getTypedEyes,
-            check: (0, check_1.makeCheck)({ type, eyes, target: driver, spec, logger }),
-            checkAndClose: (0, check_and_close_1.makeCheckAndClose)({ type, eyes, target: driver, spec, logger }),
-            close: (0, close_1.makeClose)({ eyes, environments, logger }),
-            abort: (0, abort_1.makeAbort)({ eyes, environments, logger }),
-            getResults: (0, get_eyes_results_1.makeGetEyesResults)({ eyes, logger }),
-        })); // TODO solve the types issue
+        return utils.general.extend(eyes, eyes => {
+            var _a, _b;
+            return ({
+                getTypedEyes,
+                check: (0, check_1.makeCheck)({ type, eyes, target: driver, spec, logger }),
+                checkAndClose: (0, check_and_close_1.makeCheckAndClose)({ type, eyes, target: driver, spec, logger }),
+                close: (0, close_1.makeClose)({ eyes, environments: (_a = config === null || config === void 0 ? void 0 : config.check) === null || _a === void 0 ? void 0 : _a.environments, logger }),
+                abort: (0, abort_1.makeAbort)({ eyes, environments: (_b = config === null || config === void 0 ? void 0 : config.check) === null || _b === void 0 ? void 0 : _b.environments, logger }),
+                getResults: (0, get_eyes_results_1.makeGetEyesResults)({ eyes, logger }),
+            });
+        }); // TODO solve the types issue
     };
 }
 exports.makeOpenEyes = makeOpenEyes;

package/dist/ufg/check-and-close.js

@@ -34,6 +34,7 @@ const uniquify_environments_1 = require("../automation/utils/uniquify-environmen
 const to_environment_key_1 = require("../automation/utils/to-environment-key");
 const abort_error_1 = require("../errors/abort-error");
 const utils = __importStar(require("@applitools/utils"));
+const lang = __importStar(require("../lang"));
 const chalk_1 = __importDefault(require("chalk"));
 function makeCheckAndClose({ eyes, target: defaultTarget, environments: defaultEnvironments = [], spec, signal, logger: mainLogger, }) {
     return async function checkAndClose({ target = defaultTarget, settings = {}, logger = mainLogger, } = {}) {
@@ -132,8 +133,7 @@ function makeCheckAndClose({ eyes, target: defaultTarget, environments: defaultE
             const environmentLogger = logger.extend({ tags: [`environment-${utils.general.shortid()}`] });
             const ufgEnvironment = environment;
             if (utils.types.has(ufgEnvironment, 'name') && ufgEnvironment.name === 'edge') {
-                const message = chalk_1.default.yellow(`The 'edge' option that is being used in your browsers' configuration will soon be deprecated. Please change it to either 'edgelegacy' for the legacy version or to 'edgechromium' for the new Chromium-based version. Please note, when using the built-in BrowserType enum, then the values are BrowserType.EDGE_LEGACY and BrowserType.EDGE_CHROMIUM, respectively.`);
-                environmentLogger.console.log(message);
+                environmentLogger.console.log(chalk_1.default.yellow(lang.edgeUfgEnvironmentDeprecatedWarning));
             }
             try {
                 if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
@@ -226,9 +226,8 @@ function makeCheckAndClose({ eyes, target: defaultTarget, environments: defaultE
                 }
                 catch (error) {
                     environmentLogger.error(`Render on environment with id "${(_h = baseEyes.test.environment) === null || _h === void 0 ? void 0 : _h.environmentId}" failed due to an error`, error);
-                    await baseEyes.abort({ logger: environmentLogger });
-                    error.info = { eyes: baseEyes };
-                    throw error;
+                    if (baseEyes.running && !(signal === null || signal === void 0 ? void 0 : signal.aborted))
+                        await baseEyes.abort({ logger: environmentLogger, settings: { reason: error } });
                 }
             }
             catch (error) {

package/dist/ufg/check.js

@@ -34,6 +34,7 @@ const uniquify_environments_1 = require("../automation/utils/uniquify-environmen
 const to_environment_key_1 = require("../automation/utils/to-environment-key");
 const abort_error_1 = require("../errors/abort-error");
 const utils = __importStar(require("@applitools/utils"));
+const lang = __importStar(require("../lang"));
 const chalk_1 = __importDefault(require("chalk"));
 function makeCheck({ eyes, target: defaultTarget, environments: defaultEnvironments = [], spec, signal, logger: mainLogger, }) {
     return async function check({ target = defaultTarget, settings = {}, logger = mainLogger, } = {}) {
@@ -132,8 +133,7 @@ function makeCheck({ eyes, target: defaultTarget, environments: defaultEnvironme
             const environmentLogger = logger.extend({ tags: [`environment-${utils.general.shortid()}`] });
             const ufgEnvironment = environment;
             if (utils.types.has(ufgEnvironment, 'name') && ufgEnvironment.name === 'edge') {
-                const message = chalk_1.default.yellow(`The 'edge' option that is being used in your browsers' configuration will soon be deprecated. Please change it to either 'edgelegacy' for the legacy version or to 'edgechromium' for the new Chromium-based version. Please note, when using the built-in BrowserType enum, then the values are BrowserType.EDGE_LEGACY and BrowserType.EDGE_CHROMIUM, respectively.`);
-                environmentLogger.console.log(message);
+                environmentLogger.console.log(chalk_1.default.yellow(lang.edgeUfgEnvironmentDeprecatedWarning));
             }
             try {
                 if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
@@ -227,9 +227,7 @@ function makeCheck({ eyes, target: defaultTarget, environments: defaultEnvironme
                 catch (error) {
                     environmentLogger.error(`Render on environment with id "${(_h = baseEyes.test.environment) === null || _h === void 0 ? void 0 : _h.environmentId}" failed due to an error`, error);
                     if (baseEyes.running && !(signal === null || signal === void 0 ? void 0 : signal.aborted))
-                        await baseEyes.abort({ logger: environmentLogger });
-                    error.info = { eyes: baseEyes };
-                    throw error;
+                        await baseEyes.abort({ logger: environmentLogger, settings: { reason: error } });
                 }
             }
             catch (error) {

package/dist/ufg/utils/take-dom-snapshots.js

@@ -35,9 +35,10 @@ const calculate_regions_1 = require("./calculate-regions");
 const wait_for_lazy_load_1 = require("../../automation/utils/wait-for-lazy-load");
 const chalk_1 = __importDefault(require("chalk"));
 const utils = __importStar(require("@applitools/utils"));
+const lang = __importStar(require("../../lang"));
 __exportStar(require("./take-dom-snapshot"), exports);
 async function takeDomSnapshots({ driver, settings, hooks, provides, logger, }) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f, _g;
     // calculating cookies here once so that we (a) don't do it for each dom snapshot, and (b) do it before generating safe selectors
     const features = await driver.getFeatures();
     settings.cookies = features.allCookies ? await driver.getCookies().catch(() => []) : [];
@@ -58,9 +59,9 @@ async function takeDomSnapshots({ driver, settings, hooks, provides, logger, })
             logger,
         });
     }
-    if (!settings.layoutBreakpoints) {
+    if (!((_a = settings.layoutBreakpoints) === null || _a === void 0 ? void 0 : _a.breakpoints)) {
         logger.log(`taking single dom snapshot`);
-        await ((_a = hooks === null || hooks === void 0 ? void 0 : hooks.beforeEachSnapshot) === null || _a === void 0 ? void 0 : _a.call(hooks));
+        await ((_b = hooks === null || hooks === void 0 ? void 0 : hooks.beforeEachSnapshot) === null || _b === void 0 ? void 0 : _b.call(hooks));
         await waitBeforeCapture();
         // it's important that we calculate safe selectors as close as possible to taking the dom snapshot
         if (settings.calculateRegionsOptions) {
@@ -70,10 +71,10 @@ async function takeDomSnapshots({ driver, settings, hooks, provides, logger, })
             });
         }
         const snapshot = await (0, take_dom_snapshot_1.takeDomSnapshot)({ context: currentContext, settings, logger });
-        await ((_b = calculateRegionsResults === null || calculateRegionsResults === void 0 ? void 0 : calculateRegionsResults.cleanupGeneratedSelectors) === null || _b === void 0 ? void 0 : _b.call(calculateRegionsResults));
+        await ((_c = calculateRegionsResults === null || calculateRegionsResults === void 0 ? void 0 : calculateRegionsResults.cleanupGeneratedSelectors) === null || _c === void 0 ? void 0 : _c.call(calculateRegionsResults));
         return Array(settings.environments.length).fill({ snapshot, ...calculateRegionsResults });
     }
-    const isStrictBreakpoints = utils.types.isArray((_c = settings.layoutBreakpoints) === null || _c === void 0 ? void 0 : _c.breakpoints);
+    const isStrictBreakpoints = utils.types.isArray((_d = settings.layoutBreakpoints) === null || _d === void 0 ? void 0 : _d.breakpoints);
     const requiredWidths = await settings.environments.reduce(async (prev, environment, index) => {
         const { name, width } = (await extractEnvironmentInfo(environment));
         const requiredWidths = await prev;
@@ -88,12 +89,11 @@ async function takeDomSnapshots({ driver, settings, hooks, provides, logger, })
     }, Promise.resolve(new Map()));
     const smallestBreakpoint = Math.min(...(isStrictBreakpoints ? settings.layoutBreakpoints.breakpoints : []));
     if (isStrictBreakpoints && requiredWidths.has(smallestBreakpoint - 1)) {
-        const smallestBrowsers = requiredWidths
-            .get(smallestBreakpoint - 1)
-            .map(({ name, width }) => `(${name}, ${width})`)
-            .join(', ');
-        const message = chalk_1.default.yellow(`The following configuration's viewport-widths are smaller than the smallest configured layout breakpoint (${smallestBreakpoint} pixels): [${smallestBrowsers}]. As a fallback, the resources that will be used for these configurations have been captured on a viewport-width of ${smallestBreakpoint} - 1 pixels. If an additional layout breakpoint is needed for you to achieve better results - please add it to your configuration.`);
-        logger.console.log(message);
+        const message = lang.requestedEnvironmentSmallerThenBreakpointWarning({
+            breakpoint: smallestBreakpoint,
+            browsers: requiredWidths.get(smallestBreakpoint - 1),
+        });
+        logger.console.log(chalk_1.default.yellow(message));
     }
     logger.log(`taking multiple dom snapshots for breakpoints:`, settings.layoutBreakpoints.breakpoints);
     logger.log(`required widths: ${[...requiredWidths.keys()].join(', ')}`);
@@ -101,7 +101,7 @@ async function takeDomSnapshots({ driver, settings, hooks, provides, logger, })
     const snapshotsResults = Array(settings.environments.length);
     if (requiredWidths.has(viewportSize.width)) {
         logger.log(`taking dom snapshot for existing width ${viewportSize.width}`);
-        await ((_d = hooks === null || hooks === void 0 ? void 0 : hooks.beforeEachSnapshot) === null || _d === void 0 ? void 0 : _d.call(hooks));
+        await ((_e = hooks === null || hooks === void 0 ? void 0 : hooks.beforeEachSnapshot) === null || _e === void 0 ? void 0 : _e.call(hooks));
         await waitBeforeCapture();
         // it's important that we calculate safe selectors as close as possible to taking the dom snapshot
         if (settings.calculateRegionsOptions) {
@@ -120,26 +120,32 @@ async function takeDomSnapshots({ driver, settings, hooks, provides, logger, })
         try {
             await driver.setViewportSize({ width: requiredWidth, height: viewportSize.height });
         }
-        catch (err) {
-            logger.error(err);
+        catch (error) {
+            logger.error(`Failed to set viewport size to ${requiredWidth} du to error: `, error);
             const actualViewportSize = await driver.getViewportSize();
             if (isStrictBreakpoints) {
-                const failedBrowsers = browsersInfo.map(({ name, width }) => `(${name}, ${width})`).join(', ');
-                const message = chalk_1.default.yellow(`One of the configured layout breakpoints is ${requiredWidth} pixels, while your local browser has a limit of ${actualViewportSize.width}, so the SDK couldn't resize it to the desired size. As a fallback, the resources that will be used for the following configurations: [${failedBrowsers}] have been captured on the browser's limit (${actualViewportSize.width} pixels). To resolve this, you may use a headless browser as it can be resized to any size.`);
-                logger.console.log(message);
+                const message = lang.breakpointOutOfDriverBoundsWarning({
+                    requiredWidth,
+                    actualWidth: actualViewportSize.width,
+                    browsers: browsersInfo,
+                });
+                logger.console.log(chalk_1.default.yellow(message));
                 logger.log(message);
             }
             else {
-                const failedBrowsers = browsersInfo.map(({ name }) => `(${name})`).join(', ');
-                const message = chalk_1.default.yellow(`The following configurations [${failedBrowsers}] have a viewport-width of ${requiredWidth} pixels, while your local browser has a limit of ${actualViewportSize.width} pixels, so the SDK couldn't resize it to the desired size. As a fallback, the resources that will be used for these checkpoints have been captured on the browser's limit (${actualViewportSize.width} pixels). To resolve this, you may use a headless browser as it can be resized to any size.`);
-                logger.console.log(message);
+                const message = lang.requestedEnvironmentOutOfDriverBoundsWarning({
+                    requiredWidth,
+                    actualWidth: actualViewportSize.width,
+                    browsers: browsersInfo,
+                });
+                logger.console.log(chalk_1.default.yellow(message));
                 logger.log(message);
             }
         }
         if (settings.layoutBreakpoints.reload) {
             await driver.reloadPage();
         }
-        await ((_e = hooks === null || hooks === void 0 ? void 0 : hooks.beforeEachSnapshot) === null || _e === void 0 ? void 0 : _e.call(hooks));
+        await ((_f = hooks === null || hooks === void 0 ? void 0 : hooks.beforeEachSnapshot) === null || _f === void 0 ? void 0 : _f.call(hooks));
         await waitBeforeCapture();
         if (settings.layoutBreakpoints.reload) {
             // it's important that we calculate safe selectors as close as possible to taking the dom snapshot
@@ -161,7 +167,7 @@ async function takeDomSnapshots({ driver, settings, hooks, provides, logger, })
         await waitBeforeCapture();
     }
     else {
-        (_f = calculateRegionsResults === null || calculateRegionsResults === void 0 ? void 0 : calculateRegionsResults.cleanupGeneratedSelectors) === null || _f === void 0 ? void 0 : _f.call(calculateRegionsResults);
+        (_g = calculateRegionsResults === null || calculateRegionsResults === void 0 ? void 0 : calculateRegionsResults.cleanupGeneratedSelectors) === null || _g === void 0 ? void 0 : _g.call(calculateRegionsResults);
     }
     return snapshotsResults;
     function calculateBreakpoint({ breakpoints, value }) {

package/dist/universal/core-server.js

@@ -14,7 +14,7 @@ const refer_1 = require("./refer");
 const history_1 = require("./history");
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
-async function makeCoreServer({ environment: defaultEnvironment, debug = false, shutdownMode = 'lazy', idleTimeout = 900000, // 15min
+async function makeCoreServer({ environment: defaultEnvironment, agentIdPrefix = `eyes-universal/${require('../../package.json').version}`, debug = false, shutdownMode = 'lazy', idleTimeout = 900000, // 15min
 printStdout = false, isProcess = false, ...handlerOptions } = {}) {
     var _a, _b;
     const logDirname = (_a = process.env.APPLITOOLS_LOG_DIR) !== null && _a !== void 0 ? _a : path_1.default.resolve(os_1.default.tmpdir(), `applitools-logs`);
@@ -88,7 +88,7 @@ printStdout = false, isProcess = false, ...handlerOptions } = {}) {
         const corePromise = socket.wait('Core.makeCore', ({ spec, agentId, environment, cwd }) => {
             return (0, core_1.makeCore)({
                 spec: spec === 'webdriver' ? spec_driver_webdriver_1.default : (0, spec_driver_1.makeSpec)({ socket, spec }),
-                agentId: `eyes-universal/${require('../../package.json').version}/${agentId}`,
+                agentId: `${agentIdPrefix}/${agentId}`,
                 cwd,
                 environment: {
                     ...defaultEnvironment,
@@ -143,7 +143,11 @@ printStdout = false, isProcess = false, ...handlerOptions } = {}) {
             return { url: client.url };
         });
         socket.command('Core.makeManager', async (options) => {
+            var _a;
             const core = await corePromise;
+            if ((_a = options.settings) === null || _a === void 0 ? void 0 : _a.agentId) {
+                options.settings.agentId = `${agentIdPrefix}/${options.settings.agentId}`;
+            }
             return refer.ref(await core.makeManager(options));
         });
         socket.command('EyesManager.openEyes', async ({ manager, ...options }) => {

package/dist/utils/validate-sdk-version.js

@@ -0,0 +1,89 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractLatestRubyPackageVersion = exports.extractLatestPythonPackageVersion = exports.extractLatestDotNetPackageVersion = exports.extractLatestJavaPackageVersion = exports.extractLatestJsPackageVersion = exports.validateSdkVersion = void 0;
+const req_1 = require("@applitools/req");
+const lt_1 = __importDefault(require("semver/functions/lt"));
+const chalk_1 = __importDefault(require("chalk"));
+const utils = __importStar(require("@applitools/utils"));
+const lang = __importStar(require("../lang"));
+const extractors = {
+    js: utils.general.cachify(extractLatestJsPackageVersion),
+    java: utils.general.cachify(extractLatestJavaPackageVersion),
+    dotnet: utils.general.cachify(extractLatestDotNetPackageVersion),
+    python: utils.general.cachify(extractLatestPythonPackageVersion),
+    ruby: utils.general.cachify(extractLatestRubyPackageVersion),
+};
+async function validateSdkVersion(sdk, { logger }) {
+    try {
+        if (!sdk.latestVersion) {
+            logger.log(`Extracting latest version of ${sdk.lang}/${sdk.name}`);
+            sdk.latestVersion = await extractors[sdk.lang](sdk.name);
+        }
+        logger.log(`Latest version of ${sdk.lang}/${sdk.name} is ${sdk.latestVersion}`);
+        if ((0, lt_1.default)(sdk.currentVersion, sdk.latestVersion)) {
+            const message = lang.outdatedSdkVersionWarning(sdk);
+            logger.console.warn(chalk_1.default.yellow(message));
+            logger.warn(message);
+        }
+    }
+    catch (error) {
+        logger.error(`Failed to extract latest version of ${sdk.lang}/${sdk.name} due to the error: `, error);
+    }
+}
+exports.validateSdkVersion = validateSdkVersion;
+async function extractLatestJsPackageVersion(name) {
+    const response = await (0, req_1.req)(`https://registry.npmjs.org/${name}/latest`);
+    const info = await response.json();
+    return info.version;
+}
+exports.extractLatestJsPackageVersion = extractLatestJsPackageVersion;
+async function extractLatestJavaPackageVersion(name) {
+    const response = await (0, req_1.req)(`https://search.maven.org/solrsearch/select?q=a:${name}&wt=json`);
+    const info = await response.json();
+    return info.response.docs[0].latestVersion;
+}
+exports.extractLatestJavaPackageVersion = extractLatestJavaPackageVersion;
+async function extractLatestDotNetPackageVersion(name) {
+    const response = await (0, req_1.req)(`https://api.nuget.org/v3-flatcontainer/${name.toLowerCase()}/index.json`);
+    const info = await response.json();
+    return info.versions[info.versions.length - 1];
+}
+exports.extractLatestDotNetPackageVersion = extractLatestDotNetPackageVersion;
+async function extractLatestPythonPackageVersion(name) {
+    const response = await (0, req_1.req)(`https://pypi.org/pypi/${name}/json`);
+    const info = await response.json();
+    return info.info.version;
+}
+exports.extractLatestPythonPackageVersion = extractLatestPythonPackageVersion;
+async function extractLatestRubyPackageVersion(name) {
+    const response = await (0, req_1.req)(`https://rubygems.org/api/v1/gems/${name}.json`);
+    const info = await response.json();
+    return info.version;
+}
+exports.extractLatestRubyPackageVersion = extractLatestRubyPackageVersion;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/core",
-  "version": "4.0.2",
+  "version": "4.2.0",
   "homepage": "https://applitools.com",
   "bugs": {
     "url": "https://github.com/applitools/eyes.sdk.javascript1/issues"
@@ -68,43 +68,45 @@
     }
   },
   "dependencies": {
-    "@applitools/core-base": "1.7.2",
-    "@applitools/dom-capture": "11.2.3",
-    "@applitools/dom-snapshot": "4.7.12",
-    "@applitools/driver": "1.14.4",
-    "@applitools/ec-client": "1.7.14",
-    "@applitools/logger": "2.0.12",
-    "@applitools/nml-client": "1.5.14",
-    "@applitools/req": "1.6.2",
-    "@applitools/screenshoter": "3.8.14",
+    "@applitools/core-base": "1.7.3",
+    "@applitools/dom-capture": "11.2.4",
+    "@applitools/dom-snapshot": "4.7.14",
+    "@applitools/driver": "1.15.1",
+    "@applitools/ec-client": "1.7.16",
+    "@applitools/logger": "2.0.13",
+    "@applitools/nml-client": "1.5.16",
+    "@applitools/req": "1.6.3",
+    "@applitools/screenshoter": "3.8.16",
     "@applitools/snippets": "2.4.24",
-    "@applitools/socket": "1.1.12",
-    "@applitools/spec-driver-webdriver": "1.0.48",
-    "@applitools/ufg-client": "1.9.6",
-    "@applitools/utils": "1.6.2",
+    "@applitools/socket": "1.1.13",
+    "@applitools/spec-driver-webdriver": "1.0.50",
+    "@applitools/ufg-client": "1.9.8",
+    "@applitools/utils": "1.6.3",
     "@types/ws": "8.5.5",
     "abort-controller": "3.0.0",
     "chalk": "4.1.2",
     "node-fetch": "2.6.7",
+    "semver": "7.5.4",
     "webdriver": "7.31.1",
     "ws": "8.13.0",
     "yargs": "17.7.2"
   },
   "devDependencies": {
-    "@applitools/bongo": "^5.7.0",
+    "@applitools/bongo": "^5.7.6",
     "@applitools/sea": "^1.0.0",
-    "@applitools/spec-driver-puppeteer": "^1.2.4",
-    "@applitools/spec-driver-selenium": "^1.5.62",
+    "@applitools/spec-driver-puppeteer": "^1.3.0",
+    "@applitools/spec-driver-selenium": "^1.5.64",
     "@applitools/test-server": "^1.2.2",
     "@applitools/test-utils": "^1.5.17",
-    "@applitools/tunnel-client": "^1.3.0",
+    "@applitools/tunnel-client": "^1.3.1",
     "@types/node": "^12.20.55",
     "@types/selenium-webdriver": "^4.1.2",
+    "@types/semver": "^7.5.4",
     "@types/yargs": "^17.0.22",
     "nock": "^13.3.2",
     "png-async": "^0.9.4",
     "puppeteer": "^19.11.1",
-    "selenium-webdriver": "4.4"
+    "selenium-webdriver": "^4.15.0"
   },
   "engines": {
     "node": ">=12.13.0"

package/types/lang.d.ts

@@ -0,0 +1,32 @@
+export declare const matchLevelContentDeprecatedWarning = "The \"Content\" match level value has been deprecated, use \"IgnoreColors\" instead.";
+export declare const edgeUfgEnvironmentDeprecatedWarning = "The 'edge' option that is being used in your browsers' configuration will soon be deprecated. Please change it to either 'edgelegacy' for the legacy version or to 'edgechromium' for the new Chromium-based version. Please note, when using the built-in BrowserType enum, then the values are BrowserType.EDGE_LEGACY and BrowserType.EDGE_CHROMIUM, respectively.";
+export declare const outdatedSdkVersionWarning: (options: {
+    name: string;
+    currentVersion: string;
+    latestVersion: string;
+}) => string;
+export declare const requestedEnvironmentSmallerThenBreakpointWarning: (options: {
+    breakpoint: number;
+    browsers: {
+        name: string;
+        width: number;
+    }[];
+}) => string;
+export declare const breakpointOutOfDriverBoundsWarning: (options: {
+    requiredWidth: number;
+    actualWidth: number;
+    browsers: {
+        name: string;
+        width: number;
+    }[];
+}) => string;
+export declare const requestedEnvironmentOutOfDriverBoundsWarning: (options: {
+    requiredWidth: number;
+    actualWidth: number;
+    browsers: {
+        name: string;
+    }[];
+}) => string;
+export declare const applitoolsLibConflictingCapabilitiesWarning: (options: {
+    conflictingCapabilities: Record<string, any>;
+}) => string;

package/types/types.d.ts

@@ -122,7 +122,7 @@ export type GetManagerResultsSettings<TType extends 'classic' | 'ufg'> = GetEyes
 };
 export type TestResult<TType extends 'classic' | 'ufg'> = TType extends 'ufg' ? UFGCore.TestResult : ClassicCore.TestResult;
 export interface TestResultContainer<TType extends 'classic' | 'ufg'> {
-    readonly error?: Error;
+    readonly error?: unknown;
     readonly result?: TestResult<TType>;
     readonly environment: AutomationCore.ExactEnvironment;
     readonly userTestId?: string;

package/types/universal/core-server.d.ts

@@ -1,13 +1,14 @@
 import { type ServerOptions } from './ws-server';
 export type Options = ServerOptions & {
     environment?: Record<string, any>;
+    agentIdPrefix?: string;
     debug?: boolean;
     shutdownMode?: 'lazy' | 'stdin';
     idleTimeout?: number;
     printStdout?: boolean;
     isProcess?: boolean;
 };
-export declare function makeCoreServer({ environment: defaultEnvironment, debug, shutdownMode, idleTimeout, // 15min
+export declare function makeCoreServer({ environment: defaultEnvironment, agentIdPrefix, debug, shutdownMode, idleTimeout, // 15min
 printStdout, isProcess, ...handlerOptions }?: Options): Promise<{
     port: number;
     close?: () => void;

package/types/utils/validate-sdk-version.d.ts

@@ -0,0 +1,42 @@
+import { type Logger } from '@applitools/logger';
+declare const extractors: {
+    js: typeof extractLatestJsPackageVersion & {
+        getCachedValues(): Promise<string>[];
+        setCachedValue(key: any, value: Promise<string>): void;
+        clearCache(): void;
+    };
+    java: typeof extractLatestJavaPackageVersion & {
+        getCachedValues(): Promise<string>[];
+        setCachedValue(key: any, value: Promise<string>): void;
+        clearCache(): void;
+    };
+    dotnet: typeof extractLatestDotNetPackageVersion & {
+        getCachedValues(): Promise<string>[];
+        setCachedValue(key: any, value: Promise<string>): void;
+        clearCache(): void;
+    };
+    python: typeof extractLatestPythonPackageVersion & {
+        getCachedValues(): Promise<string>[];
+        setCachedValue(key: any, value: Promise<string>): void;
+        clearCache(): void;
+    };
+    ruby: typeof extractLatestRubyPackageVersion & {
+        getCachedValues(): Promise<string>[];
+        setCachedValue(key: any, value: Promise<string>): void;
+        clearCache(): void;
+    };
+};
+export declare function validateSdkVersion(sdk: {
+    lang: keyof typeof extractors;
+    name: string;
+    currentVersion: string;
+    latestVersion?: string;
+}, { logger }: {
+    logger: Logger;
+}): Promise<void>;
+export declare function extractLatestJsPackageVersion(name: string): Promise<string>;
+export declare function extractLatestJavaPackageVersion(name: string): Promise<string>;
+export declare function extractLatestDotNetPackageVersion(name: string): Promise<string>;
+export declare function extractLatestPythonPackageVersion(name: string): Promise<string>;
+export declare function extractLatestRubyPackageVersion(name: string): Promise<string>;
+export {};