@applitools/ec-client 1.12.20 → 1.12.22

package/CHANGELOG.md

@@ -1,5 +1,112 @@
 # Changelog
 
+## [1.12.22](https://github.com/Applitools-Dev/sdk/compare/js/ec-client@1.12.21...js/ec-client@1.12.22) (2026-03-12)
+
+
+### Dependencies
+
+* @applitools/snippets bumped to 2.8.0
+  #### Features
+
+  * support coded regions within iframes and shadow DOM | FLD-4019 ([#3542](https://github.com/Applitools-Dev/sdk/issues/3542)) ([7c5639a](https://github.com/Applitools-Dev/sdk/commit/7c5639a8a4c135bc9331d9ff93f1824906549568))
+* @applitools/driver bumped to 1.25.3
+  #### Bug Fixes
+
+  * enhance NML error messages for better user-facing diagnostics | FLD-4279 ([#3622](https://github.com/Applitools-Dev/sdk/issues/3622)) ([2aef039](https://github.com/Applitools-Dev/sdk/commit/2aef0395875fd0ff0b4f657d769bda23d66660ad))
+
+
+
+* @applitools/spec-driver-webdriver bumped to 1.5.8
+
+* @applitools/core-base bumped to 1.32.2
+  #### Bug Fixes
+
+  * logEventBatch leaks to console | FLD-4175 ([#3608](https://github.com/Applitools-Dev/sdk/issues/3608)) ([f749d28](https://github.com/Applitools-Dev/sdk/commit/f749d287bf8a8e91ab819c04b13f8246f3d3a244))
+
+## [1.12.21](https://github.com/Applitools-Dev/sdk/compare/js/ec-client@1.12.20...js/ec-client@1.12.21) (2026-03-08)
+
+
+### Bug Fixes
+
+* audit fix for fastify node >=20 ([#3578](https://github.com/Applitools-Dev/sdk/issues/3578)) ([7c7b9b2](https://github.com/Applitools-Dev/sdk/commit/7c7b9b295b68285d585092dd71b99a4e148c6f55))
+* unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+
+
+### Dependencies
+
+* @applitools/utils bumped to 1.14.2
+  #### Bug Fixes
+
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+* @applitools/logger bumped to 2.2.9
+  #### Bug Fixes
+
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+
+
+
+* @applitools/socket bumped to 1.3.10
+  #### Bug Fixes
+
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+
+
+
+* @applitools/req bumped to 1.9.1
+  #### Bug Fixes
+
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+
+
+
+* @applitools/image bumped to 1.2.8
+  #### Bug Fixes
+
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+
+
+
+* @applitools/snippets bumped to 2.7.1
+  #### Bug Fixes
+
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+* @applitools/driver bumped to 1.25.2
+  #### Bug Fixes
+
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+
+
+
+* @applitools/spec-driver-webdriver bumped to 1.5.7
+  #### Bug Fixes
+
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+
+
+
+* @applitools/tunnel-client bumped to 1.11.8
+  #### Bug Fixes
+
+  * audit fix for fastify node >=20 ([#3578](https://github.com/Applitools-Dev/sdk/issues/3578)) ([7c7b9b2](https://github.com/Applitools-Dev/sdk/commit/7c7b9b295b68285d585092dd71b99a4e148c6f55))
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+
+
+
+* @applitools/core-base bumped to 1.32.1
+  #### Bug Fixes
+
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+
+
+
+* @applitools/test-server bumped to 1.4.1
+  #### Bug Fixes
+
+  * unskip js/mcp ([#3618](https://github.com/Applitools-Dev/sdk/issues/3618)) ([103f9e2](https://github.com/Applitools-Dev/sdk/commit/103f9e2f18cddc225aba2f2f59556e5fa38965c0))
+
+
+
+
 ## [1.12.20](https://github.com/Applitools-Dev/sdk/compare/js/ec-client@1.12.19...js/ec-client@1.12.20) (2026-03-02)
 
 

package/dist/server.js

@@ -54,9 +54,16 @@ async function makeServer({ settings, logger: mainLogger, }) {
         useDnsCache: settings.useDnsCache,
     });
     const core = (0, core_base_1.makeCore)({ agentId: `js/ec-client/${require('../package.json').version}` });
-    const tunnels = ((_a = settings.tunnel) === null || _a === void 0 ? void 0 : _a.serviceUrl)
-        ? await (0, manager_1.makeTunnelManager)({ settings: settings.tunnel, logger: serverLogger })
-        : await (0, manager_client_1.makeTunnelManagerClient)({ settings: settings.tunnel, logger: serverLogger });
+    let tunnels;
+    try {
+        tunnels = ((_a = settings.tunnel) === null || _a === void 0 ? void 0 : _a.serviceUrl)
+            ? await (0, manager_1.makeTunnelManager)({ settings: settings.tunnel, logger: serverLogger })
+            : await (0, manager_client_1.makeTunnelManagerClient)({ settings: settings.tunnel, logger: serverLogger });
+    }
+    catch (error) {
+        serverLogger.warn('Tunnel manager could not be initialized. Tunnel functionality will be disabled.', error.message);
+        tunnels = undefined;
+    }
     const sessions = new Map();
     const commands = {
         startSession: (0, start_session_1.makeStartSession)({ settings, req, tunnels }),

package/dist/tunnels/loader.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMakeTunnelClient = void 0;
+const TUNNEL_CLIENT_PACKAGE = '@applitools/tunnel-client';
+let tunnelClientModule = null;
+let loadError = null;
+async function loadTunnelClient() {
+    var _a;
+    if (tunnelClientModule) {
+        return tunnelClientModule;
+    }
+    if (loadError) {
+        throw loadError;
+    }
+    try {
+        tunnelClientModule = await import(TUNNEL_CLIENT_PACKAGE);
+        if (!tunnelClientModule || !tunnelClientModule.makeTunnelClient) {
+            throw new Error(`Invalid ${TUNNEL_CLIENT_PACKAGE} module structure`);
+        }
+        return tunnelClientModule;
+    }
+    catch (error) {
+        if (error.code === 'MODULE_NOT_FOUND' || ((_a = error.message) === null || _a === void 0 ? void 0 : _a.includes('Cannot find module'))) {
+            loadError = new Error(`The tunnel client functionality requires the optional dependency '${TUNNEL_CLIENT_PACKAGE}' to be installed. ` +
+                `Please install it using: npm install ${TUNNEL_CLIENT_PACKAGE}`);
+        }
+        else {
+            const currentNodeVersion = parseInt(process.version.slice(1).split('.')[0], 10);
+            if (currentNodeVersion < 20) {
+                const compatibilityMessage = `You are running an old version of Node.js (${process.version}). ` +
+                    `You need to manually install ${TUNNEL_CLIENT_PACKAGE} with a version that is compatible with your version of Node.js.\n\n`;
+                loadError = new Error(compatibilityMessage + `Original error: ${error.message}`);
+            }
+            else {
+                loadError = error;
+            }
+        }
+        throw loadError;
+    }
+}
+async function getMakeTunnelClient() {
+    const module = await loadTunnelClient();
+    return module.makeTunnelClient;
+}
+exports.getMakeTunnelClient = getMakeTunnelClient;

package/dist/tunnels/manager-client.js

@@ -10,30 +10,55 @@ async function makeTunnelManagerClient({ settings, logger, }) {
         (process.platform === 'win32' ? '\\\\.\\pipe\\applitools-tunnel-manager' : '/tmp/applitools-tunnel-manager.sock');
     const socket = (0, socket_1.makeSocket)((0, net_1.createConnection)({ path }), { transport: 'ipc' });
     let server;
-    socket.once('error', async (error) => {
-        try {
-            if (['ECONNREFUSED', 'ENOENT'].includes(error.code)) {
-                if (error.code === 'ECONNREFUSED') {
+    let initializationError;
+    await new Promise((resolve, reject) => {
+        socket.once('error', async (error) => {
+            let shouldReconnect = true;
+            try {
+                if (['ECONNREFUSED', 'ENOENT'].includes(error.code)) {
+                    if (error.code === 'ECONNREFUSED') {
+                        try {
+                            await fs_1.promises.unlink(path);
+                        }
+                        catch { }
+                    }
+                    logger.log(`Starting tunnel manager in separate process using path ${path} and settings`, settings);
                     try {
-                        await fs_1.promises.unlink(path);
+                        server = await (0, manager_server_1.makeTunnelManagerServerProcess)({ settings, path });
+                        resolve();
+                    }
+                    catch (error) {
+                        if (error.code !== 'EADDRINUSE') {
+                            logger.error('Failed to start tunnel manager server', error);
+                            shouldReconnect = false;
+                            initializationError = error;
+                            reject(error);
+                        }
+                        else {
+                            shouldReconnect = true;
+                        }
                     }
-                    catch { }
                 }
-                logger.log(`Starting tunnel manager in separate process using path ${path} and settings`, settings);
-                try {
-                    server = await (0, manager_server_1.makeTunnelManagerServerProcess)({ settings, path });
+                else {
+                    shouldReconnect = false;
+                    initializationError = error;
+                    reject(error);
+                }
+            }
+            finally {
+                if (shouldReconnect) {
+                    socket.use((0, net_1.createConnection)({ path }));
                 }
-                catch (error) {
-                    if (error.code !== 'EADDRINUSE')
-                        throw error;
+                else if (initializationError) {
+                    socket.cleanup();
                 }
             }
-        }
-        finally {
-            socket.use((0, net_1.createConnection)({ path }));
-        }
+        });
+        socket.once('ready', () => {
+            socket.target.unref();
+            resolve();
+        });
     });
-    socket.once('ready', () => socket.target.unref());
     return {
         acquire: (options) => socket.request('Tunnel.acquire', options),
         release: (options) => socket.request('Tunnel.release', options),

package/dist/tunnels/manager.js

@@ -24,10 +24,11 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeTunnelManager = void 0;
-const tunnel_client_1 = require("@applitools/tunnel-client");
+const loader_1 = require("./loader");
 const utils = __importStar(require("@applitools/utils"));
 async function makeTunnelManager({ settings, logger, }) {
-    const client = (0, tunnel_client_1.makeTunnelClient)({ settings, logger });
+    const createTunnelClient = await (0, loader_1.getMakeTunnelClient)();
+    const client = createTunnelClient({ settings, logger });
     const pools = new Map();
     return { acquire, release, close: client.close };
     async function acquire(credentials) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/ec-client",
-  "version": "1.12.20",
+  "version": "1.12.22",
   "homepage": "https://applitools.com",
   "bugs": {
     "url": "https://github.com/applitools/eyes.sdk.javascript1/issues"
@@ -52,21 +52,21 @@
     "test:it": "MOCHA_GROUP=it run --top-level mocha './test/it/*.spec.ts'"
   },
   "dependencies": {
-    "@applitools/core-base": "1.32.0",
-    "@applitools/driver": "1.25.1",
-    "@applitools/logger": "2.2.8",
-    "@applitools/req": "1.9.0",
-    "@applitools/socket": "1.3.9",
-    "@applitools/spec-driver-webdriver": "1.5.6",
-    "@applitools/tunnel-client": "1.11.7",
-    "@applitools/utils": "1.14.1",
+    "@applitools/core-base": "1.32.2",
+    "@applitools/driver": "1.25.3",
+    "@applitools/logger": "2.2.9",
+    "@applitools/req": "1.9.1",
+    "@applitools/socket": "1.3.10",
+    "@applitools/spec-driver-webdriver": "1.5.8",
+    "@applitools/utils": "1.14.2",
     "abort-controller": "3.0.0",
     "webdriver": "7.31.1",
     "yargs": "^17.7.2"
   },
   "devDependencies": {
-    "@applitools/test-server": "^1.4.0",
+    "@applitools/test-server": "^1.4.1",
     "@applitools/test-utils": "^1.5.17",
+    "@applitools/tunnel-client": "1.11.8",
     "@types/node": "^12.20.55",
     "@types/node-fetch": "^2.6.1",
     "@types/selenium-webdriver": "^4.0.19",
@@ -74,6 +74,9 @@
     "nock": "^13.3.2",
     "selenium-webdriver": "^4.15.0"
   },
+  "optionalDependencies": {
+    "@applitools/tunnel-client": ">=1.11.8"
+  },
   "engines": {
     "node": ">=12.13.0"
   },

package/types/tunnels/loader.d.ts

@@ -0,0 +1,10 @@
+import type { TunnelClient } from '@applitools/tunnel-client';
+import { type Logger } from '@applitools/logger';
+interface TunnelClientModule {
+    makeTunnelClient: (options: {
+        settings?: any;
+        logger: Logger;
+    }) => TunnelClient;
+}
+export declare function getMakeTunnelClient(): Promise<TunnelClientModule['makeTunnelClient']>;
+export {};

package/types/tunnels/manager.d.ts

@@ -1,6 +1,6 @@
 import type { TunnelManagerSettings } from '../types';
 import { type Logger } from '@applitools/logger';
-import { type Tunnel, type TunnelCredentials } from '@applitools/tunnel-client';
+import type { Tunnel, TunnelCredentials } from '@applitools/tunnel-client';
 export interface TunnelManager {
     acquire(credentials: TunnelCredentials): Promise<Tunnel[]>;
     release(tunnels: Tunnel[]): Promise<void>;

package/types/types.d.ts

@@ -1,6 +1,6 @@
 import { type Proxy } from '@applitools/req';
 import { type Batch, type FunctionalSession } from '@applitools/core-base';
-import { type TunnelClientSettings, type Tunnel } from '@applitools/tunnel-client';
+import type { TunnelClientSettings, Tunnel } from '@applitools/tunnel-client';
 export interface ECClient {
     readonly url: string;
     readonly port: number;