@wdio/browserstack-service 0.0.0-canary-20260722132416

package/build/cli/cliUtils.d.ts

@@ -0,0 +1,64 @@
+import fs from 'node:fs';
+import type { Options, Capabilities } from '@wdio/types';
+import type { BrowserstackConfig, BrowserstackOptions, TestObservabilityOptions } from '../types.js';
+export declare class CLIUtils {
+    static automationFrameworkDetail: {};
+    static testFrameworkDetail: {};
+    static CLISupportedFrameworks: string[];
+    static isDevelopmentEnv(): boolean;
+    static getCLIParamsForDevEnv(): Record<string, string>;
+    /**
+     * Build config object for binary session request
+     * @returns {string}
+     * @throws {Error}
+     */
+    static getBinConfig(config: Options.Testrunner, capabilities: Capabilities.RemoteCapabilities, options: BrowserstackConfig & BrowserstackOptions, buildTag?: string): string;
+    static getSdkVersion(): any;
+    static getSdkLanguage(): string;
+    static setupCliPath(config: Options.Testrunner): Promise<string | null>;
+    static checkAndUpdateCli(existingCliPath: string, cliDir: string, config: Options.Testrunner): Promise<string | null>;
+    static getCliDir(): string;
+    static getWritableDir(): string | null | undefined;
+    static getExistingCliPath(cliDir: string): string;
+    static requestToUpdateCLI: (queryParams: Record<string, string>, config: Options.Testrunner) => Promise<any>;
+    static runShellCommand(cmdCommand: string, workingDir?: string): Promise<string>;
+    static downloadLatestBinary: (binDownloadUrl: string, cliDir: string) => Promise<string | null>;
+    static downloadFileStream(downloadedFileStream: fs.WriteStream, binaryName: string | null, zipFilePath: string, cliDir: string, resolve: (path: string) => void, reject: (reason?: Error) => void): void;
+    static getTestFrameworkDetail(): any;
+    static getAutomationFrameworkDetail(): any;
+    static setFrameworkDetail(testFramework: string, automationFramework: string): void;
+    /**
+     * Get the current instance name using thread id and processId
+     * @returns {string}
+     */
+    static getCurrentInstanceName(): string;
+    /**
+     * Generate a unique client worker identifier combining thread ID and process ID.
+     * This identifier is used to track worker-specific events and performance metrics
+     * across distributed test execution. Format matches the Python SDK implementation
+     * for consistency across SDKs.
+     *
+     * Format: "threadId-processId"
+     *
+     * @param context - Optional execution context with threadId and processId
+     * @returns Worker ID string in format "threadId-processId"
+     * @example
+     * const workerId = CLIUtils.getClientWorkerId() // Returns "1-12345"
+     * const workerId = CLIUtils.getClientWorkerId({ threadId: 123, processId: 456 }) // Returns "123-456"
+     */
+    static getClientWorkerId(context?: {
+        threadId?: string | number;
+        processId?: string | number;
+    }): string;
+    /**
+     *
+     * @param {TestFrameworkState | AutomationFrameworkState} frameworkState
+     * @param {HookState} hookState
+     * @returns {string}
+     */
+    static getHookRegistryKey(frameworkState: State, hookState: State): string;
+    static matchHookRegex(hookState: string): boolean;
+    static getObservabilityBuildTags(observabilityOptions: TestObservabilityOptions, bstackBuildTag?: string): string[];
+    static checkCLISupportedFrameworks(framework: string | undefined): boolean;
+}
+//# sourceMappingURL=cliUtils.d.ts.map

package/build/cli/cliUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliUtils.d.ts","sourceRoot":"","sources":["../../src/cli/cliUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AAiCxB,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAyB,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAI3H,qBAAa,QAAQ;IACjB,MAAM,CAAC,yBAAyB,KAAK;IACrC,MAAM,CAAC,mBAAmB,KAAK;IAC/B,MAAM,CAAC,sBAAsB,WAAY;IAEzC,MAAM,CAAC,gBAAgB;IAIvB,MAAM,CAAC,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOtD;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,GAAG,mBAAmB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAqFnK,MAAM,CAAC,aAAa;IAIpB,MAAM,CAAC,cAAc;WAIR,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,GAAC,IAAI,CAAC;WAuB9D,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,GAAC,IAAI,CAAC;IAgCzH,MAAM,CAAC,SAAS;IAiBhB,MAAM,CAAC,cAAc;IAsCrB,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM;IAyCxC,MAAM,CAAC,kBAAkB,GAAU,aAAa,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,OAAO,CAAC,UAAU,kBAejG;IAED,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB5E,MAAM,CAAC,oBAAoB,GAAU,gBAAgB,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,GAAC,IAAI,CAAC,CAmCjG;IAED,MAAM,CAAC,kBAAkB,CAAC,oBAAoB,EAAE,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,GAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,IAAI;IA4D/L,MAAM,CAAC,sBAAsB;IAO7B,MAAM,CAAC,4BAA4B;IAOnC,MAAM,CAAC,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM;IAmB5E;;;OAGG;IACH,MAAM,CAAC,sBAAsB;IAI7B;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,MAAM;IAMvG;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK;IAIjE,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM;IAMvC,MAAM,CAAC,yBAAyB,CAAC,oBAAoB,EAAE,wBAAwB,EAAE,cAAc,CAAC,EAAE,MAAM;IAaxG,MAAM,CAAC,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;CAOnE"}

package/build/cli/cliUtils.js

@@ -0,0 +1,461 @@
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import { platform, arch, homedir } from 'node:os';
+import path from 'node:path';
+import util, { promisify } from 'node:util';
+import { exec } from 'node:child_process';
+import yauzl from 'yauzl';
+import got from 'got';
+import { threadId } from 'node:worker_threads';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const { version: bstackServiceVersion } = require('../../package.json');
+import { isNullOrEmpty, nestedKeyValue, createDir, isWritable, setReadWriteAccess, isTrue, nodeRequest, getBrowserStackUser, getBrowserStackKey, isFalse, isTurboScale, shouldAddServiceVersion, } from '../util.js';
+import PerformanceTester from '../instrumentation/performance/performance-tester.js';
+import { EVENTS as PerformanceEvents } from '../instrumentation/performance/constants.js';
+import { BStackLogger as logger } from './cliLogger.js';
+import { UPDATED_CLI_ENDPOINT } from '../constants.js';
+import { TestFrameworkConstants } from './frameworks/constants/testFrameworkConstants.js';
+import APIUtils from './apiUtils.js';
+export class CLIUtils {
+    static automationFrameworkDetail = {};
+    static testFrameworkDetail = {};
+    static CLISupportedFrameworks = ['mocha'];
+    static isDevelopmentEnv() {
+        return process.env.BROWSERSTACK_CLI_ENV === 'development';
+    }
+    static getCLIParamsForDevEnv() {
+        return {
+            id: process.env.BROWSERSTACK_CLI_ENV || '',
+            listen: `unix:/tmp/sdk-platform-${process.env.BROWSERSTACK_CLI_ENV}.sock`
+        };
+    }
+    /**
+     * Build config object for binary session request
+     * @returns {string}
+     * @throws {Error}
+     */
+    static getBinConfig(config, capabilities, options, buildTag) {
+        const modifiedOpts = { ...options };
+        if (modifiedOpts.opts) {
+            modifiedOpts.browserStackLocalOptions = modifiedOpts.opts;
+            delete modifiedOpts.opts;
+        }
+        delete modifiedOpts.testManagementOptions;
+        modifiedOpts.testContextOptions = {
+            skipSessionName: isFalse(modifiedOpts.setSessionName),
+            skipSessionStatus: isFalse(modifiedOpts.setSessionStatus),
+            sessionNameOmitTestTitle: modifiedOpts.sessionNameOmitTestTitle || false,
+            sessionNamePrependTopLevelSuiteTitle: modifiedOpts.sessionNamePrependTopLevelSuiteTitle || false,
+            sessionNameFormat: modifiedOpts.sessionNameFormat || ''
+        };
+        const commonBstackOptions = (() => {
+            const caps = config.capabilities;
+            if (caps &&
+                !Array.isArray(caps) &&
+                typeof caps === 'object' &&
+                'bstack:options' in caps) {
+                // Cast after guard to satisfy TypeScript
+                return caps['bstack:options'] || {};
+            }
+            return {};
+        })();
+        const isNonBstackA11y = isTurboScale(options) || !shouldAddServiceVersion(config, options.testObservability);
+        const observabilityOptions = options.testObservabilityOptions || {};
+        const testManagementOptions = options.testManagementOptions || {};
+        const testPlanId = typeof testManagementOptions.testPlanId === 'string'
+            ? testManagementOptions.testPlanId.trim()
+            : '';
+        const binconfig = {
+            userName: observabilityOptions.user || config.user,
+            accessKey: observabilityOptions.key || config.key,
+            platforms: [],
+            isNonBstackA11yWDIO: isNonBstackA11y,
+            ...modifiedOpts,
+            ...commonBstackOptions,
+        };
+        binconfig.buildName = observabilityOptions.buildName || binconfig.buildName;
+        binconfig.projectName = observabilityOptions.projectName || binconfig.projectName;
+        binconfig.buildTag = this.getObservabilityBuildTags(observabilityOptions, buildTag) || [];
+        if (testPlanId.length > 0) {
+            binconfig.testManagementOptions = {
+                testPlanId
+            };
+        }
+        let caps = capabilities;
+        if (capabilities && !Array.isArray(capabilities)) {
+            caps = [capabilities];
+        }
+        if (Array.isArray(caps)) {
+            for (const cap of caps) {
+                const platform = {};
+                const capability = cap;
+                Object.keys(capability)
+                    .filter((key) => (key !== 'bstack:options'))
+                    .forEach((key) => {
+                    if (binconfig[key] === undefined) {
+                        platform[key] = capability[key];
+                    }
+                });
+                if (capability['bstack:options']) {
+                    Object.keys(capability['bstack:options'])
+                        .forEach((key) => {
+                        if (binconfig[key] === undefined) {
+                            platform[key] = capability['bstack:options'][key];
+                        }
+                    });
+                }
+                binconfig.platforms.push(platform);
+            }
+        }
+        return JSON.stringify(binconfig);
+    }
+    static getSdkVersion() {
+        return bstackServiceVersion;
+    }
+    static getSdkLanguage() {
+        return 'ECMAScript';
+    }
+    static async setupCliPath(config) {
+        logger.debug('Configuring Cli path.');
+        const developmentBinaryPath = process.env.SDK_CLI_BIN_PATH || null;
+        if (!isNullOrEmpty(developmentBinaryPath)) {
+            logger.debug(`Development Cli Path: ${developmentBinaryPath}`);
+            return developmentBinaryPath;
+        }
+        try {
+            const cliDir = this.getCliDir();
+            if (isNullOrEmpty(cliDir)) {
+                throw new Error('No writable directory available for the CLI');
+            }
+            const existingCliPath = this.getExistingCliPath(cliDir);
+            const finalBinaryPath = await this.checkAndUpdateCli(existingCliPath, cliDir, config);
+            logger.debug(`Resolved binary path: ${finalBinaryPath}`);
+            return finalBinaryPath;
+        }
+        catch (err) {
+            logger.debug(`Error in setting up cli path directory, Exception: ${util.format(err)}`);
+        }
+        return null;
+    }
+    static async checkAndUpdateCli(existingCliPath, cliDir, config) {
+        PerformanceTester.start(PerformanceEvents.SDK_CLI_CHECK_UPDATE);
+        logger.info(`Current CLI Path Found: ${existingCliPath}`);
+        const queryParams = {
+            sdk_version: CLIUtils.getSdkVersion(),
+            os: platform(),
+            os_arch: arch(),
+            cli_version: '0',
+            sdk_language: this.getSdkLanguage(),
+        };
+        if (!isNullOrEmpty(existingCliPath)) {
+            const nullDevice = platform() === 'win32' ? 'NUL' : '/dev/null';
+            queryParams.cli_version = await this.runShellCommand(`${existingCliPath} version 2>${nullDevice}`);
+        }
+        const response = await this.requestToUpdateCLI(queryParams, config);
+        if (nestedKeyValue(response, ['updated_cli_version'])) {
+            logger.debug(`Need to update binary, current binary version: ${queryParams.cli_version}`);
+            const browserStackBinaryUrl = process.env.BROWSERSTACK_BINARY_URL || null;
+            if (!isNullOrEmpty(browserStackBinaryUrl)) {
+                logger.debug(`Using BROWSERSTACK_BINARY_URL: ${browserStackBinaryUrl}`);
+                response.url = browserStackBinaryUrl;
+            }
+            const finalBinaryPath = await this.downloadLatestBinary(nestedKeyValue(response, ['url']), cliDir);
+            PerformanceTester.end(PerformanceEvents.SDK_CLI_CHECK_UPDATE);
+            return finalBinaryPath;
+        }
+        PerformanceTester.end(PerformanceEvents.SDK_CLI_CHECK_UPDATE);
+        return existingCliPath;
+    }
+    static getCliDir() {
+        const writableDir = this.getWritableDir();
+        try {
+            if (isNullOrEmpty(writableDir)) {
+                throw new Error('No writable directory available for the CLI');
+            }
+            const cliDirPath = path.join(writableDir, 'cli');
+            if (!fs.existsSync(cliDirPath)) {
+                createDir(cliDirPath);
+            }
+            return cliDirPath;
+        }
+        catch (err) {
+            logger.error(`Error in getting writable directory, writableDir=${util.format(err)}`);
+            return '';
+        }
+    }
+    static getWritableDir() {
+        const writableDirOptions = [
+            process.env.BROWSERSTACK_FILES_DIR,
+            path.join(homedir(), '.browserstack'),
+            path.join('tmp', '.browserstack'),
+        ];
+        for (const path of writableDirOptions) {
+            if (isNullOrEmpty(path)) {
+                continue;
+            }
+            try {
+                if (fs.existsSync(path)) {
+                    logger.debug(`File ${path} already exist`);
+                    if (!isWritable(path)) {
+                        logger.debug(`Giving write permission to ${path}`);
+                        const success = setReadWriteAccess(path);
+                        if (!isTrue(success)) {
+                            logger.warn(`Unable to provide write permission to ${path}`);
+                        }
+                    }
+                }
+                else {
+                    logger.debug(`File does not exist: ${path}`);
+                    createDir(path);
+                    logger.debug(`Giving write permission to ${path}`);
+                    const success = setReadWriteAccess(path);
+                    if (!isTrue(success)) {
+                        logger.warn(`Unable to provide write permission to ${path}`);
+                    }
+                }
+                return path;
+            }
+            catch (err) {
+                logger.error(`Unable to get writable directory, exception ${util.format(err)}`);
+            }
+        }
+        return null;
+    }
+    static getExistingCliPath(cliDir) {
+        try {
+            // Check if the path exists and is a directory
+            if (!fs.existsSync(cliDir) || !fs.statSync(cliDir).isDirectory()) {
+                return '';
+            }
+            // List all files in the directory that start with "binary-"
+            const allBinaries = fs
+                .readdirSync(cliDir)
+                .map((file) => path.join(cliDir, file))
+                .filter((filePath) => fs.statSync(filePath).isFile() && path.basename(filePath).startsWith('binary-'));
+            if (allBinaries.length > 0) {
+                // Get the latest binary by comparing the last modified time
+                const latestBinary = allBinaries
+                    .map((filePath) => ({
+                    filePath,
+                    mtime: fs.statSync(filePath).mtime,
+                }))
+                    .reduce((latest, current) => {
+                    if (!latest || !latest.mtime) {
+                        return current;
+                    }
+                    if (current.mtime > latest.mtime) {
+                        return current;
+                    }
+                    return latest;
+                }, null);
+                return latestBinary ? latestBinary.filePath : '';
+            }
+            return ''; // No binary present
+        }
+        catch (err) {
+            logger.error(`Error while reading CLI path: ${util.format(err)}`);
+            return '';
+        }
+    }
+    static requestToUpdateCLI = async (queryParams, config) => {
+        const params = new URLSearchParams(queryParams);
+        const requestInit = {
+            headers: {
+                Authorization: `Basic ${Buffer.from(`${getBrowserStackUser(config)}:${getBrowserStackKey(config)}`).toString('base64')}`,
+            },
+        };
+        const response = await nodeRequest('GET', `${UPDATED_CLI_ENDPOINT}?${params.toString()}`, requestInit, APIUtils.BROWSERSTACK_AUTOMATE_API_URL);
+        logger.debug(`response ${JSON.stringify(response)}`);
+        return response;
+    };
+    static runShellCommand(cmdCommand, workingDir = '') {
+        return new Promise((resolve) => {
+            const process = exec(cmdCommand, { cwd: workingDir, timeout: 5000 }, (error, stdout, stderr) => {
+                if (error) {
+                    resolve(stderr.trim() || 'SHELL_EXECUTE_ERROR');
+                }
+                else {
+                    resolve(stdout.trim());
+                }
+            });
+            // Ensure the process is killed if it exceeds the timeout
+            process.on('error', () => {
+                resolve('SHELL_EXECUTE_ERROR');
+            });
+        });
+    }
+    static downloadLatestBinary = async (binDownloadUrl, cliDir) => {
+        PerformanceTester.start(PerformanceEvents.SDK_CLI_DOWNLOAD);
+        logger.debug(`Downloading SDK binary from: ${binDownloadUrl}`);
+        try {
+            const zipFilePath = path.join(cliDir, 'downloaded_file.zip');
+            const downloadedFileStream = fs.createWriteStream(zipFilePath);
+            return new Promise((resolve, reject) => {
+                const binaryName = null;
+                const stream = got.stream(binDownloadUrl, {
+                    followRedirect: true
+                });
+                stream.pipe(downloadedFileStream);
+                downloadedFileStream.on('error', function (err) {
+                    logger.error('Got Error while downloading percy binary file' + err);
+                    PerformanceTester.end(PerformanceEvents.SDK_CLI_DOWNLOAD, false, util.format(err));
+                    reject(err);
+                });
+                stream.on('error', (err) => {
+                    logger.error(`Got Error in cli binary downloading request ${util.format(err)}`);
+                    PerformanceTester.end(PerformanceEvents.SDK_CLI_DOWNLOAD, false, util.format(err));
+                    reject(err);
+                });
+                CLIUtils.downloadFileStream(downloadedFileStream, binaryName, zipFilePath, cliDir, resolve, reject);
+                PerformanceTester.end(PerformanceEvents.SDK_CLI_DOWNLOAD);
+            });
+        }
+        catch (err) {
+            PerformanceTester.end(PerformanceEvents.SDK_CLI_DOWNLOAD, false, util.format(err));
+            logger.debug(`Failed to download binary, Exception: ${util.format(err)}`);
+            return null;
+        }
+    };
+    static downloadFileStream(downloadedFileStream, binaryName, zipFilePath, cliDir, resolve, reject) {
+        downloadedFileStream.on('close', async function () {
+            const yauzlOpenPromise = promisify(yauzl.open);
+            try {
+                const zipfile = await yauzlOpenPromise(zipFilePath, { lazyEntries: true });
+                zipfile.readEntry();
+                zipfile.on('entry', async (entry) => {
+                    if (!binaryName) {
+                        binaryName = entry.fileName;
+                    }
+                    if (/\/$/.test(entry.fileName)) {
+                        // Directory file names end with '/'.
+                        zipfile.readEntry();
+                    }
+                    else {
+                        // file entry
+                        const writeStream = fs.createWriteStream(path.join(cliDir, entry.fileName));
+                        const openReadStreamPromise = promisify(zipfile.openReadStream).bind(zipfile);
+                        try {
+                            const readStream = await openReadStreamPromise(entry);
+                            readStream.on('end', function () {
+                                writeStream.close();
+                                zipfile.readEntry();
+                            });
+                            readStream.pipe(writeStream);
+                        }
+                        catch (zipErr) {
+                            reject(zipErr);
+                        }
+                        if (entry.fileName === binaryName) {
+                            zipfile.close();
+                        }
+                    }
+                });
+                zipfile.on('error', (zipErr) => {
+                    reject(zipErr);
+                });
+                zipfile.once('end', () => {
+                    fsp.unlink(zipFilePath)
+                        .catch(() => {
+                        logger.warn(`Failed to delete zip file: ${zipFilePath}`);
+                    });
+                    fsp.chmod(`${cliDir}/${binaryName}`, '0755')
+                        .then(() => {
+                        resolve(`${cliDir}/${binaryName}`);
+                    }).catch((err) => {
+                        reject(err);
+                    });
+                    zipfile.close();
+                });
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    static getTestFrameworkDetail() {
+        if (process.env.BROWSERSTACK_TEST_FRAMEWORK_DETAIL) {
+            return JSON.parse(process.env.BROWSERSTACK_TEST_FRAMEWORK_DETAIL);
+        }
+        return this.testFrameworkDetail;
+    }
+    static getAutomationFrameworkDetail() {
+        if (process.env.BROWSERSTACK_AUTOMATION_FRAMEWORK_DETAIL) {
+            return JSON.parse(process.env.BROWSERSTACK_AUTOMATION_FRAMEWORK_DETAIL);
+        }
+        return this.automationFrameworkDetail;
+    }
+    static setFrameworkDetail(testFramework, automationFramework) {
+        if (!testFramework || !automationFramework) {
+            logger.debug(`Test or Automation framework not provided testFramework=${testFramework}, automationFramework=${automationFramework}`);
+        }
+        this.testFrameworkDetail = {
+            name: testFramework,
+            version: { [testFramework]: CLIUtils.getSdkVersion() },
+        };
+        this.automationFrameworkDetail = {
+            name: automationFramework,
+            version: { [automationFramework]: CLIUtils.getSdkVersion() },
+        };
+        process.env.BROWSERSTACK_AUTOMATION_FRAMEWORK_DETAIL = JSON.stringify(this.automationFrameworkDetail);
+        process.env.BROWSERSTACK_TEST_FRAMEWORK_DETAIL = JSON.stringify(this.testFrameworkDetail);
+    }
+    /**
+     * Get the current instance name using thread id and processId
+     * @returns {string}
+     */
+    static getCurrentInstanceName() {
+        return `${process.pid}:${threadId}`;
+    }
+    /**
+     * Generate a unique client worker identifier combining thread ID and process ID.
+     * This identifier is used to track worker-specific events and performance metrics
+     * across distributed test execution. Format matches the Python SDK implementation
+     * for consistency across SDKs.
+     *
+     * Format: "threadId-processId"
+     *
+     * @param context - Optional execution context with threadId and processId
+     * @returns Worker ID string in format "threadId-processId"
+     * @example
+     * const workerId = CLIUtils.getClientWorkerId() // Returns "1-12345"
+     * const workerId = CLIUtils.getClientWorkerId({ threadId: 123, processId: 456 }) // Returns "123-456"
+     */
+    static getClientWorkerId(context) {
+        const workerThreadId = context?.threadId?.toString() || threadId.toString();
+        const workerProcessId = context?.processId?.toString() || process.pid.toString();
+        return `${workerThreadId}-${workerProcessId}`;
+    }
+    /**
+     *
+     * @param {TestFrameworkState | AutomationFrameworkState} frameworkState
+     * @param {HookState} hookState
+     * @returns {string}
+     */
+    static getHookRegistryKey(frameworkState, hookState) {
+        return `${frameworkState}:${hookState}`;
+    }
+    static matchHookRegex(hookState) {
+        const pattern = new RegExp(TestFrameworkConstants.HOOK_REGEX);
+        return pattern.test(hookState);
+    }
+    static getObservabilityBuildTags(observabilityOptions, bstackBuildTag) {
+        if (process.env.TEST_OBSERVABILITY_BUILD_TAG) {
+            return process.env.TEST_OBSERVABILITY_BUILD_TAG.split(',');
+        }
+        if (observabilityOptions.buildTag) {
+            return observabilityOptions.buildTag;
+        }
+        if (bstackBuildTag) {
+            return [bstackBuildTag];
+        }
+        return [];
+    }
+    static checkCLISupportedFrameworks(framework) {
+        if (framework === undefined) {
+            return false;
+        }
+        return this.CLISupportedFrameworks.includes(framework);
+    }
+}
+//# sourceMappingURL=cliUtils.js.map

package/build/cli/cliUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliUtils.js","sourceRoot":"","sources":["../../src/cli/cliUtils.ts"],"names":[],"mappings":"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"}

package/build/cli/eventDispatcher.d.ts

@@ -0,0 +1,28 @@
+/**
+ * EventDispatcher - Singleton class for event handling
+ */
+declare class EventDispatcher {
+    #private;
+    observers: Record<string, Function[]>;
+    constructor();
+    /**
+   * Get the EventDispatcher singleton instance
+   * @returns {EventDispatcher} The singleton instance
+   */
+    static getInstance(): EventDispatcher;
+    /**
+   * Add event observer
+   * @param {string} event - Event name
+   * @param {Function} callback - Callback function
+   */
+    registerObserver(hookRegistryKey: string, callback: Function): void;
+    /**
+   * Notify registered observers on an event
+   * @param {string} event - Event name
+   * @param {*} data - Event data
+   */
+    notifyObserver(event: string, args: unknown): Promise<void>;
+}
+export declare const eventDispatcher: EventDispatcher;
+export {};
+//# sourceMappingURL=eventDispatcher.d.ts.map

package/build/cli/eventDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventDispatcher.d.ts","sourceRoot":"","sources":["../../src/cli/eventDispatcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAM,eAAe;;IAGjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;;IAMrC;;;KAGC;IACD,MAAM,CAAC,WAAW;IAOlB;;;;KAIC;IACD,gBAAgB,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;IAQ5D;;;;KAIC;IACK,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAQpD;AAGD,eAAO,MAAM,eAAe,iBAAgC,CAAA"}

package/build/cli/eventDispatcher.js

@@ -0,0 +1,49 @@
+/**
+ * EventDispatcher - Singleton class for event handling
+ */
+class EventDispatcher {
+    static #instance = null;
+    observers;
+    constructor() {
+        this.observers = {};
+    }
+    /**
+   * Get the EventDispatcher singleton instance
+   * @returns {EventDispatcher} The singleton instance
+   */
+    static getInstance() {
+        if (!EventDispatcher.#instance) {
+            EventDispatcher.#instance = new EventDispatcher();
+        }
+        return EventDispatcher.#instance;
+    }
+    /**
+   * Add event observer
+   * @param {string} event - Event name
+   * @param {Function} callback - Callback function
+   */
+    registerObserver(hookRegistryKey, callback) {
+        if (!this.observers[hookRegistryKey]) {
+            this.observers[hookRegistryKey] = [];
+        }
+        this.observers[hookRegistryKey].push(callback);
+    }
+    /**
+   * Notify registered observers on an event
+   * @param {string} event - Event name
+   * @param {*} data - Event data
+   */
+    async notifyObserver(event, args) {
+        if (this.observers[event]) {
+            for (const callback of this.observers[event]) {
+                await callback(args);
+            }
+            return;
+        }
+    }
+}
+// Create the singleton instance
+export const eventDispatcher = EventDispatcher.getInstance();
+// Object.freeze to prevent modification of the instance
+Object.freeze(eventDispatcher);
+//# sourceMappingURL=eventDispatcher.js.map

package/build/cli/eventDispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventDispatcher.js","sourceRoot":"","sources":["../../src/cli/eventDispatcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,eAAe;IAEjB,MAAM,CAAC,SAAS,GAAyB,IAAI,CAAA;IAC7C,SAAS,CAA4B;IAErC;QACI,IAAI,CAAC,SAAS,GAAG,EAAE,CAAA;IACvB,CAAC;IAED;;;KAGC;IACD,MAAM,CAAC,WAAW;QACd,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC;YAC7B,eAAe,CAAC,SAAS,GAAG,IAAI,eAAe,EAAE,CAAA;QACrD,CAAC;QACD,OAAO,eAAe,CAAC,SAAS,CAAA;IACpC,CAAC;IAED;;;;KAIC;IACD,gBAAgB,CAAC,eAAuB,EAAE,QAAkB;QACxD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,CAAA;QACxC,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAClD,CAAC;IAED;;;;KAIC;IACD,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,IAAa;QAC7C,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;YACxB,CAAC;YACD,OAAM;QACV,CAAC;IACL,CAAC;;AAGL,gCAAgC;AAChC,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC,WAAW,EAAE,CAAA;AAE5D,wDAAwD;AACxD,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA"}