@wdio/browserstack-service 8.47.1 → 8.48.3

package/build/cli/modules/accessibilityModule.js

@@ -1,5 +1,6 @@
 /// <reference path="../../@types/bstack-service-types.d.ts" />
 import BaseModule from './baseModule.js';
+import { BrowserstackCLI } from '../index.js';
 import { BStackLogger } from '../cliLogger.js';
 import TestFramework from '../frameworks/testFramework.js';
 import AutomationFramework from '../frameworks/automationFramework.js';
@@ -7,7 +8,7 @@ import { TestFrameworkState } from '../states/testFrameworkState.js';
 import { AutomationFrameworkState } from '../states/automationFrameworkState.js';
 import { HookState } from '../states/hookState.js';
 import accessibilityScripts from '../../scripts/accessibility-scripts.js';
-import { _getParamsForAppAccessibility, formatString, getAppA11yResults, getAppA11yResultsSummary, shouldScanTestForAccessibility, validateCapsWithA11y, validateCapsWithAppA11y, validateCapsWithNonBstackA11y } from '../../util.js';
+import { _getParamsForAppAccessibility, formatString, getAppA11yResults, getAppA11yResultsSummary, shouldScanTestForAccessibility, validateCapsWithA11y, validateCapsWithAppA11y, validateCapsWithNonBstackA11y, setBrowserstackAnnotation } from '../../util.js';
 import { AutomationFrameworkConstants } from '../frameworks/constants/automationFrameworkConstants.js';
 import util from 'node:util';
 import PerformanceTester from '../../instrumentation/performance/performance-tester.js';
@@ -18,12 +19,16 @@ export default class AccessibilityModule extends BaseModule {
     name;
     scriptInstance;
     accessibility = false;
+    autoScanning = true;
     isAppAccessibility;
     isNonBstackA11y;
     accessibilityConfig;
     static MODULE_NAME = 'AccessibilityModule';
     accessibilityMap;
     LOG_DISABLED_SHOWN;
+    testMetadata = {};
+    centralAuthA11yConfig = {};
+    centralAuthConfigFetched = false;
     constructor(accessibilityConfig, isNonBstackA11y) {
         super();
         this.name = 'AccessibilityModule';
@@ -31,7 +36,9 @@ export default class AccessibilityModule extends BaseModule {
         AutomationFramework.registerObserver(AutomationFrameworkState.CREATE, HookState.POST, this.onBeforeExecute.bind(this));
         TestFramework.registerObserver(TestFrameworkState.TEST, HookState.PRE, this.onBeforeTest.bind(this));
         TestFramework.registerObserver(TestFrameworkState.TEST, HookState.POST, this.onAfterTest.bind(this));
-        this.accessibility = true;
+        this.accessibility = Boolean(accessibilityConfig);
+        const accessibilityOptions = BrowserstackCLI.getInstance().options?.accessibilityOptions;
+        this.autoScanning = accessibilityOptions?.autoScanning ?? true;
         this.scriptInstance = accessibilityScripts;
         this.accessibilityMap = new Map();
         this.LOG_DISABLED_SHOWN = new Map();
@@ -89,8 +96,23 @@ export default class AccessibilityModule extends BaseModule {
             };
             //patching performScan
             browser.performScan = async () => {
+                if (!this.accessibility && !this.isAppAccessibility) {
+                    return;
+                }
                 return await this.performScanCli(browser);
             };
+            browser.startA11yScanning = async () => {
+                if (!this.accessibility && !this.isAppAccessibility) {
+                    return;
+                }
+                this.logger.warn('Accessibility scanning cannot be started from outside the test');
+            };
+            browser.stopA11yScanning = async () => {
+                if (!this.accessibility && !this.isAppAccessibility) {
+                    return;
+                }
+                this.logger.warn('Accessibility scanning cannot be stopped from outside the test');
+            };
             if (!this.accessibility) {
                 this.logger.info('Accessibility automation is disabled for this session.');
                 return;
@@ -149,16 +171,52 @@ export default class AccessibilityModule extends BaseModule {
             const testInstance = TestFramework.getTrackedInstance();
             const sessionId = AutomationFramework.getState(autoInstance, AutomationFrameworkConstants.KEY_FRAMEWORK_SESSION_ID);
             const accessibilityOptions = this.config.accessibilityOptions;
-            const shouldScanTest = shouldScanTestForAccessibility(suiteTitle, test.title, accessibilityOptions) && this.accessibility;
+            const shouldScanTest = this.autoScanning && shouldScanTestForAccessibility(suiteTitle, test.title, accessibilityOptions) && this.accessibility;
+            this.accessibilityMap.set(sessionId, shouldScanTest);
             // Create test metadata similar to accessibility-handler
-            const testIdentifier = testInstance.getContext().getId();
-            const testMetadata = {
+            const testIdentifier = String(testInstance.getContext().getId());
+            this.testMetadata[testIdentifier] = {
                 scanTestForAccessibility: shouldScanTest,
                 accessibilityScanStarted: shouldScanTest
             };
+            const browser = AutomationFramework.getDriver(autoInstance);
+            browser.startA11yScanning = async () => {
+                if (!this.accessibility && !this.isAppAccessibility) {
+                    return;
+                }
+                this.accessibilityMap.set(sessionId, true);
+                this.testMetadata[testIdentifier] = {
+                    scanTestForAccessibility: true,
+                    accessibilityScanStarted: true
+                };
+                TestFramework.setState(testInstance, `accessibility_metadata_${testIdentifier}`, this.testMetadata[testIdentifier]);
+                await this._setAnnotation('Accessibility scanning has started');
+            };
+            browser.stopA11yScanning = async () => {
+                if (!this.accessibility && !this.isAppAccessibility) {
+                    return;
+                }
+                this.accessibilityMap.set(sessionId, false);
+                await this._setAnnotation('Accessibility scanning has stopped');
+            };
+            browser.performScan = async () => {
+                if (!this.accessibility && !this.isAppAccessibility) {
+                    return;
+                }
+                const results = await this.performScanCli(browser);
+                if (results) {
+                    const testIdentifier = String(testInstance.getContext().getId());
+                    this.testMetadata[testIdentifier] = {
+                        scanTestForAccessibility: true,
+                        accessibilityScanStarted: true
+                    };
+                    TestFramework.setState(testInstance, `accessibility_metadata_${testIdentifier}`, this.testMetadata[testIdentifier]);
+                    await this._setAnnotation('Accessibility scanning was triggered manually');
+                }
+                return results;
+            };
             // Store test metadata in test instance
-            TestFramework.setState(testInstance, `accessibility_metadata_${testIdentifier}`, testMetadata);
-            this.accessibilityMap.set(sessionId, shouldScanTest);
+            TestFramework.setState(testInstance, `accessibility_metadata_${testIdentifier}`, this.testMetadata[testIdentifier]);
             // Log if accessibility scan is enabled for this test
             if (shouldScanTest) {
                 this.logger.info('Accessibility test case execution has started.');
@@ -183,7 +241,7 @@ export default class AccessibilityModule extends BaseModule {
                 return;
             }
             // Get test metadata that was stored in onBeforeTest
-            const testIdentifier = testInstance.getContext().getId();
+            const testIdentifier = String(testInstance.getContext().getId());
             const testMetadata = testInstance.getData(`accessibility_metadata_${testIdentifier}`);
             if (!testMetadata) {
                 this.logger.debug('No accessibility metadata found for this test');
@@ -204,7 +262,7 @@ export default class AccessibilityModule extends BaseModule {
                         'thBuildUuid': process.env.BROWSERSTACK_TESTHUB_UUID,
                         'thJwtToken': process.env.BROWSERSTACK_TESTHUB_JWT
                     };
-                    const driverExecuteParams = await this.getDriverExecuteParams();
+                    const driverExecuteParams = await this.getDriverExecuteParams('saveResults');
                     dataForExtension = { ...dataForExtension, ...driverExecuteParams };
                     // final scan and saving the results
                     await this.sendTestStopEvent(browser, dataForExtension);
@@ -257,12 +315,23 @@ export default class AccessibilityModule extends BaseModule {
     async performScanCli(browser, commandName) {
         return await PerformanceTester.measureWrapper(PERFORMANCE_SDK_EVENTS.A11Y_EVENTS.PERFORM_SCAN, async () => {
             try {
+                // Fetch central auth accessibility configuration
+                const centralAuthConfig = await this.fetchCentralAuthA11yConfig('scan');
                 if (!this.accessibility) {
                     this.logger.debug('Not an Accessibility Automation session.');
                     return;
                 }
                 if (this.isAppAccessibility) {
-                    const results = await browser.execute(formatString(this.scriptInstance.performScan, JSON.stringify(_getParamsForAppAccessibility(commandName))), {});
+                    // Get app accessibility params and merge with central auth config
+                    const appAccessibilityParams = _getParamsForAppAccessibility(commandName);
+                    // Merge with central auth config
+                    const mergedParams = { ...appAccessibilityParams, ...centralAuthConfig };
+                    // Use centralAuthToken if available
+                    if (centralAuthConfig.centralAuthToken) {
+                        // Set the auth header with the token value
+                        mergedParams.centralAuthHeader = centralAuthConfig.centralAuthToken;
+                    }
+                    const results = await browser.execute(formatString(this.scriptInstance.performScan, JSON.stringify(mergedParams)), {});
                     BStackLogger.debug(util.format(results));
                     return results;
                 }
@@ -277,12 +346,16 @@ export default class AccessibilityModule extends BaseModule {
     }
     async sendTestStopEvent(browser, dataForExtension) {
         try {
+            const autoInstance = AutomationFramework.getTrackedInstance();
+            const sessionId = AutomationFramework.getState(autoInstance, AutomationFrameworkConstants.KEY_FRAMEWORK_SESSION_ID);
             if (!this.accessibility) {
                 this.logger.debug('Not an Accessibility Automation session.');
                 return;
             }
-            this.logger.debug('Performing scan before saving results');
-            await this.performScanCli(browser);
+            if (sessionId && this.accessibilityMap.get(sessionId)) {
+                this.logger.debug('Performing scan before saving results');
+                await this.performScanCli(browser);
+            }
             if (this.isAppAccessibility) {
                 return;
             }
@@ -332,10 +405,10 @@ export default class AccessibilityModule extends BaseModule {
             }
         })();
     }
-    async getDriverExecuteParams() {
+    async getDriverExecuteParams(scriptName) {
         const payload = {
             product: 'accessibility',
-            scriptName: 'saveResults'
+            scriptName: scriptName
         };
         const response = await GrpcClient.getInstance().fetchDriverExecuteParamsEvent(payload);
         if (response.success) {
@@ -344,4 +417,30 @@ export default class AccessibilityModule extends BaseModule {
         this.logger.error(`Failed to fetch driver execute params: ${response.error || 'Unknown error'}`);
         return {};
     }
+    async _setAnnotation(message) {
+        const autoInstance = AutomationFramework.getTrackedInstance();
+        const browser = AutomationFramework.getDriver(autoInstance);
+        await setBrowserstackAnnotation(browser, message, this.accessibility);
+    }
+    /**
+     * Fetch central auth accessibility configuration for the given script name.
+     * Returns cached config if already fetched, otherwise loads and caches it.
+     *
+     * @param scriptName - Name of the script to fetch config for
+     * @returns Configuration object, empty object if error occurs
+     */
+    async fetchCentralAuthA11yConfig(scriptName) {
+        try {
+            if (this.centralAuthConfigFetched) {
+                return this.centralAuthA11yConfig;
+            }
+            this.centralAuthA11yConfig = await this.getDriverExecuteParams(scriptName);
+            this.centralAuthConfigFetched = true;
+            return this.centralAuthA11yConfig;
+        }
+        catch (error) {
+            this.logger.error(`fetchCentralAuthA11yConfig: Failed to fetch driver execute params for ${scriptName}: ${util.format(error)}`);
+            return {};
+        }
+    }
 }

package/build/constants.d.ts

@@ -19,6 +19,7 @@ export declare const BSTACK_SERVICE_VERSION: any;
 export declare const UPDATED_CLI_ENDPOINT = "sdk/v1/update_cli";
 export declare const CLI_STOP_TIMEOUT = 3000;
 export declare const NOT_ALLOWED_KEYS_IN_CAPS: string[];
+export declare const BROWSERSTACK_TEST_PLAN_ID = "BROWSERSTACK_TEST_PLAN_ID";
 export declare const LOGS_FILE = "logs/bstack-wdio-service.log";
 export declare const CLI_DEBUG_LOGS_FILE = "log/sdk-cli-debug.log";
 export declare const UPLOAD_LOGS_ADDRESS = "https://upload-observability.browserstack.com";
@@ -65,4 +66,31 @@ export declare const MAX_GIT_META_DATA_SIZE_IN_BYTES: number;
 export declare const GIT_META_DATA_TRUNCATED = "...[TRUNCATED]";
 export declare const WDIO_NAMING_PREFIX = "WebdriverIO-";
 export declare const PERF_METRICS_WAIT_TIME = 2000;
+/**
+ * Module Hook Events - Performance event names for module lifecycle tracking
+ * Used by module-hook-tracker.ts to instrument module initialization and cleanup
+ */
+export declare const MODULE_HOOK_EVENTS: {
+    readonly INSTRUMENTATION_ON_START: "MODULE_INSTRUMENTATION_ON_START";
+    readonly INSTRUMENTATION_ON_STOP: "MODULE_INSTRUMENTATION_ON_STOP";
+    readonly TESTHUB_ON_START: "MODULE_TESTHUB_ON_START";
+    readonly TESTHUB_ON_STOP: "MODULE_TESTHUB_ON_STOP";
+    readonly OBSERVABILITY_ON_START: "MODULE_OBSERVABILITY_ON_START";
+    readonly OBSERVABILITY_ON_STOP: "MODULE_OBSERVABILITY_ON_STOP";
+    readonly PERCY_ON_START: "MODULE_PERCY_ON_START";
+    readonly PERCY_ON_STOP: "MODULE_PERCY_ON_STOP";
+    readonly ACCESSIBILITY_ON_START: "MODULE_ACCESSIBILITY_ON_START";
+    readonly ACCESSIBILITY_ON_STOP: "MODULE_ACCESSIBILITY_ON_STOP";
+    readonly ACCESSIBILITY_ON_DRIVER_INIT: "MODULE_ACCESSIBILITY_ON_DRIVER_INIT";
+    readonly AI_ON_START: "MODULE_AI_ON_START";
+    readonly AI_ON_STOP: "MODULE_AI_ON_STOP";
+    readonly AI_BEFORE_SESSION: "MODULE_AI_BEFORE_SESSION";
+    readonly AI_ON_DRIVER_INIT: "MODULE_AI_ON_DRIVER_INIT";
+    readonly LOCAL_ON_START: "MODULE_LOCAL_ON_START";
+    readonly LOCAL_ON_STOP: "MODULE_LOCAL_ON_STOP";
+    readonly LOCAL_INIT_SESSION: "MODULE_LOCAL_INIT_SESSION";
+    readonly LOCAL_ON_DRIVER_INIT: "MODULE_LOCAL_ON_DRIVER_INIT";
+    readonly APPAUTOMATE_ON_START: "MODULE_APPAUTOMATE_ON_START";
+    readonly APPAUTOMATE_ON_DRIVER_INIT: "MODULE_APPAUTOMATE_ON_DRIVER_INIT";
+};
 //# sourceMappingURL=constants.d.ts.map

package/build/constants.d.ts.map

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

package/build/constants.js

@@ -39,7 +39,8 @@ export const DEFAULT_WAIT_INTERVAL_FOR_PENDING_UPLOADS = 100; // 100ms
 export const BSTACK_SERVICE_VERSION = bstackServiceVersion;
 export const UPDATED_CLI_ENDPOINT = 'sdk/v1/update_cli';
 export const CLI_STOP_TIMEOUT = 3000;
-export const NOT_ALLOWED_KEYS_IN_CAPS = ['includeTagsInTestingScope', 'excludeTagsInTestingScope'];
+export const NOT_ALLOWED_KEYS_IN_CAPS = ['includeTagsInTestingScope', 'excludeTagsInTestingScope', 'testManagementOptions'];
+export const BROWSERSTACK_TEST_PLAN_ID = 'BROWSERSTACK_TEST_PLAN_ID';
 export const LOGS_FILE = 'logs/bstack-wdio-service.log';
 export const CLI_DEBUG_LOGS_FILE = 'log/sdk-cli-debug.log';
 export const UPLOAD_LOGS_ADDRESS = 'https://upload-observability.browserstack.com';
@@ -117,3 +118,38 @@ MAX_GIT_META_DATA_SIZE_IN_BYTES
 export const GIT_META_DATA_TRUNCATED = '...[TRUNCATED]';
 export const WDIO_NAMING_PREFIX = 'WebdriverIO-';
 export const PERF_METRICS_WAIT_TIME = 2000;
+/**
+ * Module Hook Events - Performance event names for module lifecycle tracking
+ * Used by module-hook-tracker.ts to instrument module initialization and cleanup
+ */
+export const MODULE_HOOK_EVENTS = {
+    // Instrumentation module
+    INSTRUMENTATION_ON_START: 'MODULE_INSTRUMENTATION_ON_START',
+    INSTRUMENTATION_ON_STOP: 'MODULE_INSTRUMENTATION_ON_STOP',
+    // TestHub module
+    TESTHUB_ON_START: 'MODULE_TESTHUB_ON_START',
+    TESTHUB_ON_STOP: 'MODULE_TESTHUB_ON_STOP',
+    // Observability module
+    OBSERVABILITY_ON_START: 'MODULE_OBSERVABILITY_ON_START',
+    OBSERVABILITY_ON_STOP: 'MODULE_OBSERVABILITY_ON_STOP',
+    // Percy module
+    PERCY_ON_START: 'MODULE_PERCY_ON_START',
+    PERCY_ON_STOP: 'MODULE_PERCY_ON_STOP',
+    // Accessibility module
+    ACCESSIBILITY_ON_START: 'MODULE_ACCESSIBILITY_ON_START',
+    ACCESSIBILITY_ON_STOP: 'MODULE_ACCESSIBILITY_ON_STOP',
+    ACCESSIBILITY_ON_DRIVER_INIT: 'MODULE_ACCESSIBILITY_ON_DRIVER_INIT',
+    // AI module
+    AI_ON_START: 'MODULE_AI_ON_START',
+    AI_ON_STOP: 'MODULE_AI_ON_STOP',
+    AI_BEFORE_SESSION: 'MODULE_AI_BEFORE_SESSION',
+    AI_ON_DRIVER_INIT: 'MODULE_AI_ON_DRIVER_INIT',
+    // Local testing module
+    LOCAL_ON_START: 'MODULE_LOCAL_ON_START',
+    LOCAL_ON_STOP: 'MODULE_LOCAL_ON_STOP',
+    LOCAL_INIT_SESSION: 'MODULE_LOCAL_INIT_SESSION',
+    LOCAL_ON_DRIVER_INIT: 'MODULE_LOCAL_ON_DRIVER_INIT',
+    // App Automate module
+    APPAUTOMATE_ON_START: 'MODULE_APPAUTOMATE_ON_START',
+    APPAUTOMATE_ON_DRIVER_INIT: 'MODULE_APPAUTOMATE_ON_DRIVER_INIT',
+};

package/build/exitHandler.d.ts

@@ -1,4 +1,4 @@
 import BrowserStackConfig from './config.js';
 export declare function setupExitHandlers(): void;
-export declare function shouldCallCleanup(config: BrowserStackConfig): string[];
+export declare function shouldCallCleanup(config: BrowserStackConfig, isCLIEnabled?: boolean): string[];
 //# sourceMappingURL=exitHandler.d.ts.map

package/build/exitHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exitHandler.d.ts","sourceRoot":"","sources":["../src/exitHandler.ts"],"names":[],"mappings":"AAEA,OAAO,kBAAkB,MAAM,aAAa,CAAA;AA4B5C,wBAAgB,iBAAiB,SA0DhC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAmBtE"}
+{"version":3,"file":"exitHandler.d.ts","sourceRoot":"","sources":["../src/exitHandler.ts"],"names":[],"mappings":"AAEA,OAAO,kBAAkB,MAAM,aAAa,CAAA;AA4B5C,wBAAgB,iBAAiB,SA2DhC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,EAAE,YAAY,UAAQ,GAAG,MAAM,EAAE,CAmB5F"}

package/build/exitHandler.js

@@ -39,8 +39,8 @@ export function setupExitHandlers() {
                         BStackLogger.debug('CLI process terminated successfully with SIGTERM (Windows)');
                     }
                     else {
-                        cliProcess.kill('SIGKILL');
-                        BStackLogger.debug('CLI process terminated successfully with SIGKILL (Unix)');
+                        cliProcess.kill('SIGINT');
+                        BStackLogger.debug('CLI process terminated successfully with SIGINT (Unix)');
                     }
                 }
                 catch (processError) {
@@ -64,8 +64,9 @@ export function setupExitHandlers() {
     };
     process.on('exit', () => {
         BStackLogger.debug('Exit handler called');
+        const isCLIEnabled = BrowserstackCLI.getInstance().isRunning();
         handleCLICleanup();
-        const args = shouldCallCleanup(BrowserStackConfig.getInstance());
+        const args = shouldCallCleanup(BrowserStackConfig.getInstance(), isCLIEnabled);
         if (Array.isArray(args) && args.length) {
             BStackLogger.debug(`Spawning cleanup.js with args: ${args.join(', ')}`);
             const childProcess = spawn('node', [`${path.join(__dirname, 'cleanup.js')}`, ...args], {
@@ -84,13 +85,13 @@ export function setupExitHandlers() {
     });
     BStackLogger.debug('Exit handlers registered');
 }
-export function shouldCallCleanup(config) {
+export function shouldCallCleanup(config, isCLIEnabled = false) {
     const args = [];
     if (!!process.env[BROWSERSTACK_TESTHUB_JWT] && !config.testObservability.buildStopped) {
         args.push('--observability');
     }
     if (config.userName && config.accessKey && !config.funnelDataSent) {
-        const savedFilePath = saveFunnelData('SDKTestSuccessful', config);
+        const savedFilePath = saveFunnelData('SDKTestSuccessful', config, isCLIEnabled);
         args.push('--funnelData', savedFilePath);
     }
     if (PerformanceTester.isEnabled()) {

package/build/insights-handler.d.ts.map

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

package/build/insights-handler.js

@@ -8,6 +8,8 @@ import { TESTOPS_SCREENSHOT_ENV } from './constants.js';
 import { BrowserstackCLI } from './cli/index.js';
 import { TestFrameworkState } from './cli/states/testFrameworkState.js';
 import { HookState } from './cli/states/hookState.js';
+import PerformanceTester from './instrumentation/performance/performance-tester.js';
+import * as PERFORMANCE_SDK_EVENTS from './instrumentation/performance/constants.js';
 class _InsightsHandler {
     _browser;
     _framework;
@@ -37,7 +39,7 @@ class _InsightsHandler {
         this._userCaps = _userCaps;
         this._options = _options;
         this._platformMeta = {
-            browserName: caps.browserName,
+            browserName: caps?.browserName,
             browserVersion: caps?.browserVersion,
             platformName: caps?.platformName,
             caps: caps,
@@ -68,6 +70,7 @@ class _InsightsHandler {
         }
     }
     async before() {
+        PerformanceTester.start(PERFORMANCE_SDK_EVENTS.CONFIG_EVENTS.OBSERVABILITY);
         if (isBrowserstackSession(this._browser)) {
             await this._browser.execute(`browserstack_executor: ${JSON.stringify({
                 action: 'annotate',
@@ -81,6 +84,7 @@ class _InsightsHandler {
         if (gitMeta) {
             this._gitConfigPath = gitMeta.root;
         }
+        PerformanceTester.end(PERFORMANCE_SDK_EVENTS.CONFIG_EVENTS.OBSERVABILITY);
     }
     getCucumberHookType(test) {
         let hookType = null;
@@ -484,12 +488,34 @@ class _InsightsHandler {
         const body = 'body' in args ? args.body : undefined;
         const result = 'result' in args ? args.result : undefined;
         if (Boolean(process.env[TESTOPS_SCREENSHOT_ENV]) && isScreenshotCommand(args) && result?.value) {
-            await this.listener.onScreenshot([{
-                    test_run_uuid: testMeta.uuid,
-                    timestamp: new Date().toISOString(),
-                    message: result.value,
-                    kind: 'TEST_SCREENSHOT'
-                }]);
+            /**
+             * SDK-6277: in the CLI/binary (v8) flow, forward the screenshot to the binary over gRPC
+             * as a TEST_SCREENSHOT log. The binary uploads it via its own authorized testhub session.
+             * The direct-HTTP listener.onScreenshot() path 401s in CLI mode (the worker's binary-issued
+             * JWT is not valid for direct collector POSTs).
+             */
+            await (BrowserstackCLI.getInstance().isRunning()
+                ? BrowserstackCLI.getInstance().getTestFramework().trackEvent(TestFrameworkState.LOG, HookState.POST, {
+                    logEntry: {
+                        kind: 'TEST_SCREENSHOT',
+                        message: result.value,
+                        level: 'INFO',
+                        timestamp: new Date().toISOString()
+                    }
+                })
+                : this.listener.onScreenshot([{
+                        test_run_uuid: testMeta.uuid,
+                        timestamp: new Date().toISOString(),
+                        message: result.value,
+                        kind: 'TEST_SCREENSHOT'
+                    }]));
+        }
+        if (BrowserstackCLI.getInstance().isRunning()) {
+            /**
+             * SDK-6277: in CLI mode the binary captures command/network logs itself; the service only
+             * forwards the screenshot above. The direct-HTTP per-command logCreated() path 401s here.
+             */
+            return;
         }
         const requestData = this._commands[dataKey];
         if (!requestData) {

package/build/instrumentation/funnelInstrumentation.d.ts

@@ -1,8 +1,8 @@
 import type BrowserStackConfig from '../config.js';
 import type { BrowserstackHealing } from '@browserstack/ai-sdk-node';
 export declare function sendStart(config: BrowserStackConfig): Promise<void>;
-export declare function sendFinish(config: BrowserStackConfig): Promise<void>;
-export declare function saveFunnelData(eventType: string, config: BrowserStackConfig): string;
+export declare function sendFinish(config: BrowserStackConfig, isCLIEnabled?: boolean): Promise<void>;
+export declare function saveFunnelData(eventType: string, config: BrowserStackConfig, isCLIEnabled?: boolean): string;
 export declare function fireFunnelRequest(data: any): Promise<void>;
 export declare function handleHealingInstrumentation(authResult: BrowserstackHealing.InitErrorResponse | BrowserstackHealing.InitSuccessResponse, config: BrowserStackConfig, isSelfHealEnabled: boolean | undefined): void;
 //# sourceMappingURL=funnelInstrumentation.d.ts.map

package/build/instrumentation/funnelInstrumentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"funnelInstrumentation.d.ts","sourceRoot":"","sources":["../../src/instrumentation/funnelInstrumentation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,kBAAkB,MAAM,cAAc,CAAA;AAIlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAqBpE,wBAAsB,SAAS,CAAC,MAAM,EAAE,kBAAkB,iBAIzD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,kBAAkB,iBAE1D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAOpF;AAeD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAShE;AAoJD,wBAAgB,4BAA4B,CACxC,UAAU,EAAE,mBAAmB,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,mBAAmB,EAC3F,MAAM,EAAE,kBAAkB,EAC1B,iBAAiB,EAAE,OAAO,GAAG,SAAS,QA6BzC"}
+{"version":3,"file":"funnelInstrumentation.d.ts","sourceRoot":"","sources":["../../src/instrumentation/funnelInstrumentation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,kBAAkB,MAAM,cAAc,CAAA;AAIlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAuBpE,wBAAsB,SAAS,CAAC,MAAM,EAAE,kBAAkB,iBAazD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,kBAAkB,EAAE,YAAY,UAAQ,iBAUhF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,YAAY,UAAQ,GAAG,MAAM,CAO1G;AAeD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAShE;AAuJD,wBAAgB,4BAA4B,CACxC,UAAU,EAAE,mBAAmB,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,mBAAmB,EAC3F,MAAM,EAAE,kBAAkB,EAC1B,iBAAiB,EAAE,OAAO,GAAG,SAAS,QA6BzC"}

package/build/instrumentation/funnelInstrumentation.js

@@ -10,13 +10,15 @@ import { BSTACK_A11Y_POLLING_TIMEOUT, BSTACK_SERVICE_VERSION, WDIO_NAMING_PREFIX
 import { getDataFromWorkers, removeWorkersDataDir } from '../data-store.js';
 import { getProductMap } from '../testHub/utils.js';
 import APIUtils from '../cli/apiUtils.js';
-async function fireFunnelTestEvent(eventType, config) {
+import PerformanceTester from './performance/performance-tester.js';
+import { EVENTS } from './performance/constants.js';
+async function fireFunnelTestEvent(eventType, config, isCLIEnabled = false) {
     if (!config.userName || !config.accessKey) {
         BStackLogger.debug('username/accesskey not passed');
         return;
     }
     try {
-        const data = buildEventData(eventType, config);
+        const data = buildEventData(eventType, config, isCLIEnabled);
         await fireFunnelRequest(data);
         BStackLogger.debug('Funnel event success');
         if (eventType === 'SDKTestSuccessful') {
@@ -30,13 +32,31 @@ async function fireFunnelTestEvent(eventType, config) {
 export async function sendStart(config) {
     // Remove Workers folder if exists
     removeWorkersDataDir();
-    await fireFunnelTestEvent('SDKTestAttempted', config);
+    // Track funnel test attempted event
+    PerformanceTester.start(EVENTS.SDK_FUNNEL_TEST_ATTEMPTED);
+    try {
+        await fireFunnelTestEvent('SDKTestAttempted', config);
+        PerformanceTester.end(EVENTS.SDK_FUNNEL_TEST_ATTEMPTED, true);
+    }
+    catch (error) {
+        PerformanceTester.end(EVENTS.SDK_FUNNEL_TEST_ATTEMPTED, false, error);
+        throw error;
+    }
 }
-export async function sendFinish(config) {
-    await fireFunnelTestEvent('SDKTestSuccessful', config);
+export async function sendFinish(config, isCLIEnabled = false) {
+    // Track funnel test successful event
+    PerformanceTester.start(EVENTS.SDK_FUNNEL_TEST_SUCCESSFUL);
+    try {
+        await fireFunnelTestEvent('SDKTestSuccessful', config, isCLIEnabled);
+        PerformanceTester.end(EVENTS.SDK_FUNNEL_TEST_SUCCESSFUL, true);
+    }
+    catch (error) {
+        PerformanceTester.end(EVENTS.SDK_FUNNEL_TEST_SUCCESSFUL, false, error);
+        throw error;
+    }
 }
-export function saveFunnelData(eventType, config) {
-    const data = buildEventData(eventType, config);
+export function saveFunnelData(eventType, config, isCLIEnabled = false) {
+    const data = buildEventData(eventType, config, isCLIEnabled);
     BStackLogger.ensureLogsFolder();
     const filePath = path.join(BStackLogger.logFolderPath, 'funnelData.json');
     fs.writeFileSync(filePath, JSON.stringify(data));
@@ -83,7 +103,7 @@ function getProductList(config) {
     }
     return products;
 }
-function buildEventData(eventType, config) {
+function buildEventData(eventType, config, isCLIEnabled = false) {
     const eventProperties = {
         // Framework Details
         language_framework: getLanguageFramework(config.framework),
@@ -102,6 +122,8 @@ function buildEventData(eventType, config) {
         product: getProductList(config),
         // framework details
         framework: config.framework,
+        // CLI details
+        isCLIEnabled: isCLIEnabled,
     };
     if (TestOpsConfig.getInstance().buildHashedId) {
         eventProperties.testhub_uuid = TestOpsConfig.getInstance().buildHashedId;

package/build/instrumentation/performance/constants.d.ts

@@ -25,6 +25,36 @@ export declare const EVENTS: {
     SDK_CLI_ON_STOP: string;
     SDK_START_BIN_SESSION: string;
     SDK_CONNECT_BIN_SESSION: string;
+    SDK_DRIVER_INIT: string;
+    SDK_FIND_NEAREST_HUB: string;
+    SDK_AUTOMATION_FRAMEWORK_INIT: string;
+    SDK_AUTOMATION_FRAMEWORK_START: string;
+    SDK_AUTOMATION_FRAMEWORK_STOP: string;
+    SDK_ACCESSIBILITY_CONFIG: string;
+    SDK_OBSERVABILITY_CONFIG: string;
+    SDK_AI_SELF_HEAL_STEP: string;
+    SDK_AI_SELF_HEAL_GET_RESULT: string;
+    SDK_TEST_FRAMEWORK_EVENT: string;
+    SDK_TEST_SESSION_EVENT: string;
+    SDK_CLI_LOG_CREATED_EVENT: string;
+    SDK_CLI_ENQUEUE_TEST_EVENT: string;
+    SDK_ON_STOP: string;
+    SDK_SEND_LOGS: string;
+    SDK_FUNNEL_TEST_ATTEMPTED: string;
+    SDK_FUNNEL_TEST_SUCCESSFUL: string;
+    SDK_UPLOAD_LOGS: string;
+    SDK_SEND_KEY_METRICS: string;
+    SDK_KEY_METRICS_PREPARATION: string;
+    SDK_KEY_METRICS_UPLOAD: string;
+    SDK_CLI_DOWNLOAD_BINARY: string;
+    SDK_CLI_BINARY_VERIFICATION: string;
+    SDK_LISTENER_WORKER_END: string;
+    SDK_PERCY_TEARDOWN: string;
+    SDK_WORKER_SAVE_DATA: string;
+    SDK_PERFORMANCE_REPORT_GEN: string;
+    SDK_PERFORMANCE_JSON_WRITE: string;
+    SDK_PERFORMANCE_HTML_GEN: string;
+    SDK_DEVICE_ALLOCATION: string;
 };
 export declare const TESTHUB_EVENTS: {
     START: string;
@@ -83,5 +113,39 @@ export declare const DRIVER_EVENT: {
     GET: string;
     PRE_EXECUTE: string;
     POST_EXECUTE: string;
+    INIT: string;
+    PRE_INITIALIZE: string;
+    POST_INITIALIZE: string;
+};
+/**
+ * Framework lifecycle events for automation framework tracking
+ */
+export declare const FRAMEWORK_EVENTS: {
+    INIT: string;
+    START: string;
+    STOP: string;
+};
+/**
+ * Module configuration events
+ */
+export declare const CONFIG_EVENTS: {
+    ACCESSIBILITY: string;
+    OBSERVABILITY: string;
+};
+/**
+ * AI self-healing events
+ */
+export declare const AI_EVENTS: {
+    SELF_HEAL_STEP: string;
+    SELF_HEAL_GET_RESULT: string;
+};
+/**
+ * Event dispatcher events for test framework and session tracking
+ */
+export declare const DISPATCHER_EVENTS: {
+    TEST_FRAMEWORK: string;
+    TEST_SESSION: string;
+    LOG_CREATED: string;
+    ENQUEUE_TEST: string;
 };
 //# sourceMappingURL=constants.d.ts.map

package/build/instrumentation/performance/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/instrumentation/performance/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BlB,CAAA;AAED,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;CAY3B,CAAA;AAED,eAAO,MAAM,WAAW;;;;;CAKvB,CAAA;AAED,eAAO,MAAM,YAAY;;;;;;;;CAQxB,CAAA;AAED,eAAO,MAAM,WAAW;;;;CAIvB,CAAA;AAED,eAAO,MAAM,WAAW;;;;;;;CAOvB,CAAA;AAED,eAAO,MAAM,iBAAiB;;;CAG7B,CAAA;AAED,eAAO,MAAM,mBAAmB;;CAE/B,CAAA;AAED,eAAO,MAAM,YAAY;;;;;CAKxB,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/instrumentation/performance/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgElB,CAAA;AAED,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;CAY3B,CAAA;AAED,eAAO,MAAM,WAAW;;;;;CAKvB,CAAA;AAED,eAAO,MAAM,YAAY;;;;;;;;CAQxB,CAAA;AAED,eAAO,MAAM,WAAW;;;;CAIvB,CAAA;AAED,eAAO,MAAM,WAAW;;;;;;;CAOvB,CAAA;AAED,eAAO,MAAM,iBAAiB;;;CAG7B,CAAA;AAED,eAAO,MAAM,mBAAmB;;CAE/B,CAAA;AAED,eAAO,MAAM,YAAY;;;;;;;;CAQxB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;CAGzB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;CAGrB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;CAK7B,CAAA"}