@applitools/core 4.1.0 → 4.3.0

package/CHANGELOG.md

@@ -1,5 +1,122 @@
 # Changelog
 
+## [4.3.0](https://github.com/applitools/eyes.sdk.javascript1/compare/js/core@4.2.0...js/core@4.3.0) (2023-12-05)
+
+
+### Features
+
+* add Eyes.getResults method ([#2046](https://github.com/applitools/eyes.sdk.javascript1/issues/2046)) ([#2069](https://github.com/applitools/eyes.sdk.javascript1/issues/2069)) ([4d263e1](https://github.com/applitools/eyes.sdk.javascript1/commit/4d263e19cb5e5708790a1a7ef90ff8f3eee50d91))
+
+
+### Dependencies
+
+* @applitools/utils bumped to 1.7.0
+  #### Features
+
+  * add Eyes.getResults method ([#2046](https://github.com/applitools/eyes.sdk.javascript1/issues/2046)) ([#2069](https://github.com/applitools/eyes.sdk.javascript1/issues/2069)) ([4d263e1](https://github.com/applitools/eyes.sdk.javascript1/commit/4d263e19cb5e5708790a1a7ef90ff8f3eee50d91))
+* @applitools/logger bumped to 2.0.14
+
+* @applitools/socket bumped to 1.1.14
+
+* @applitools/req bumped to 1.6.4
+
+* @applitools/image bumped to 1.1.9
+
+* @applitools/spec-driver-webdriver bumped to 1.0.51
+
+* @applitools/spec-driver-selenium bumped to 1.5.65
+
+* @applitools/spec-driver-puppeteer bumped to 1.3.1
+
+* @applitools/driver bumped to 1.15.2
+
+* @applitools/screenshoter bumped to 3.8.17
+
+* @applitools/nml-client bumped to 1.5.17
+
+* @applitools/tunnel-client bumped to 1.3.2
+
+* @applitools/ufg-client bumped to 1.9.9
+
+* @applitools/ec-client bumped to 1.7.17
+
+* @applitools/core-base bumped to 1.7.4
+  #### Bug Fixes
+
+  * do not block concurrency when server response is 503 ([#2049](https://github.com/applitools/eyes.sdk.javascript1/issues/2049)) ([f285009](https://github.com/applitools/eyes.sdk.javascript1/commit/f2850098f7522776c0d0a98bb1d958303628b149))
+
+
+
+
+## [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)
 
 

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/classic/check-and-close.js

@@ -161,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

@@ -162,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/classic/open-eyes.js

@@ -74,7 +74,7 @@ function makeOpenEyes({ core, spec, logger: mainLogger }) {
                 getBaseEyes: (0, get_base_eyes_1.makeGetBaseEyes)({ settings, eyes, logger }),
                 check: (0, check_1.makeCheck)({ eyes, target: driver, environments, spec, signal: controller.signal, logger }),
                 checkAndClose: (0, check_and_close_1.makeCheckAndClose)({ eyes, target: driver, environments, spec, signal: controller.signal, logger }),
-                close: (0, close_1.makeClose)({ eyes, target: driver, environments, logger }),
+                close: (0, close_1.makeClose)({ eyes, target: driver, environments, spec, logger }),
                 abort: (0, abort_1.makeAbort)({ eyes, target: driver, environments, spec, controller, logger }),
                 getResults: (0, get_results_1.makeGetResults)({ eyes, logger }),
             };

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

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.applitoolsLibConflictingCapabilitiesWarning = exports.requestedEnvironmentOutOfDriverBoundsWarning = exports.breakpointOutOfDriverBoundsWarning = exports.requestedEnvironmentSmallerThenBreakpointWarning = exports.edgeUfgEnvironmentDeprecatedWarning = exports.matchLevelContentDeprecatedWarning = void 0;
+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.`;

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

@@ -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

@@ -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/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.1.0",
+  "version": "4.3.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/core-base": "1.7.4",
     "@applitools/dom-capture": "11.2.4",
-    "@applitools/dom-snapshot": "4.7.13",
-    "@applitools/driver": "1.15.0",
-    "@applitools/ec-client": "1.7.15",
-    "@applitools/logger": "2.0.12",
-    "@applitools/nml-client": "1.5.15",
-    "@applitools/req": "1.6.2",
-    "@applitools/screenshoter": "3.8.15",
+    "@applitools/dom-snapshot": "4.7.14",
+    "@applitools/driver": "1.15.2",
+    "@applitools/ec-client": "1.7.17",
+    "@applitools/logger": "2.0.14",
+    "@applitools/nml-client": "1.5.17",
+    "@applitools/req": "1.6.4",
+    "@applitools/screenshoter": "3.8.17",
     "@applitools/snippets": "2.4.24",
-    "@applitools/socket": "1.1.12",
-    "@applitools/spec-driver-webdriver": "1.0.49",
-    "@applitools/ufg-client": "1.9.7",
-    "@applitools/utils": "1.6.2",
+    "@applitools/socket": "1.1.14",
+    "@applitools/spec-driver-webdriver": "1.0.51",
+    "@applitools/ufg-client": "1.9.9",
+    "@applitools/utils": "1.7.0",
     "@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.4",
+    "@applitools/bongo": "^5.7.6",
     "@applitools/sea": "^1.0.0",
-    "@applitools/spec-driver-puppeteer": "^1.2.5",
-    "@applitools/spec-driver-selenium": "^1.5.63",
+    "@applitools/spec-driver-puppeteer": "^1.3.1",
+    "@applitools/spec-driver-selenium": "^1.5.65",
     "@applitools/test-server": "^1.2.2",
     "@applitools/test-utils": "^1.5.17",
-    "@applitools/tunnel-client": "^1.3.0",
+    "@applitools/tunnel-client": "^1.3.2",
     "@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

@@ -1,5 +1,10 @@
 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: {

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 {};