@wdio/browserstack-service 9.29.1 → 9.30.0

package/build/insights-handler.d.ts

@@ -21,6 +21,8 @@ declare class _InsightsHandler {
     private listener;
     currentTestId: string | undefined;
     cbtQueue: Array<CBTData>;
+    private readonly _ltsActive;
+    private readonly _ltsSessionId;
     constructor(_browser: WebdriverIO.Browser | WebdriverIO.MultiRemoteBrowser, _framework?: string | undefined, _userCaps?: Capabilities.ResolvedTestrunnerCapabilities, _options?: BrowserstackConfig & BrowserstackOptions);
     _isAppAutomate(): boolean;
     registerListeners(): void;
@@ -94,4 +96,3 @@ declare class _InsightsHandler {
 declare const InsightsHandler: typeof _InsightsHandler;
 type InsightsHandler = _InsightsHandler;
 export default InsightsHandler;
-//# sourceMappingURL=insights-handler.d.ts.map

package/build/instrumentation/funnelInstrumentation.d.ts

@@ -14,4 +14,3 @@ interface AuthResult {
 }
 export declare function handleHealingInstrumentation(authResult: AuthResult, config: BrowserStackConfig, isSelfHealEnabled: boolean | undefined): void;
 export {};
-//# sourceMappingURL=funnelInstrumentation.d.ts.map

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

@@ -148,4 +148,3 @@ export declare const DISPATCHER_EVENTS: {
     LOG_CREATED: string;
     ENQUEUE_TEST: string;
 };
-//# sourceMappingURL=constants.d.ts.map

package/build/instrumentation/performance/performance-tester.d.ts

@@ -55,4 +55,3 @@ export default class PerformanceTester {
     static uploadEventsData(): Promise<void>;
 }
 export {};
-//# sourceMappingURL=performance-tester.d.ts.map

package/build/launcher.d.ts

@@ -46,4 +46,3 @@ export default class BrowserstackLauncherService implements Services.ServiceInst
     _getClientBuildUuid(): string;
 }
 export {};
-//# sourceMappingURL=launcher.d.ts.map

package/build/log4jsAppender.d.ts

@@ -4,4 +4,3 @@ export declare const configure: (config: {
         type: string;
     };
 }, layouts: any) => Function;
-//# sourceMappingURL=log4jsAppender.d.ts.map

package/build/logPatcher.d.ts

@@ -9,4 +9,3 @@ declare class logPatcher extends Transport {
     log: (...message: unknown[]) => void;
 }
 export default logPatcher;
-//# sourceMappingURL=logPatcher.d.ts.map

package/build/logReportingAPI.d.ts

@@ -12,4 +12,3 @@ declare class logReportingAPI extends Transport {
     error: (message: string | null) => void;
 }
 export default logReportingAPI;
-//# sourceMappingURL=logReportingAPI.d.ts.map

package/build/module-hook-tracker.d.ts

@@ -44,4 +44,3 @@ export declare class ModuleHookTracker {
  * Global instance export for convenience
  */
 export declare const moduleHookTracker: ModuleHookTracker;
-//# sourceMappingURL=module-hook-tracker.d.ts.map

package/build/reporter.d.ts

@@ -38,4 +38,3 @@ declare class _TestReporter extends WDIOReporter {
 declare const TestReporter: typeof _TestReporter;
 type TestReporter = _TestReporter;
 export default TestReporter;
-//# sourceMappingURL=reporter.d.ts.map

package/build/request-handler.d.ts

@@ -16,4 +16,3 @@ export default class RequestQueueHandler {
     removeEventBatchPolling(tag: string): void;
     shouldProceed(): boolean;
 }
-//# sourceMappingURL=request-handler.d.ts.map

package/build/scripts/accessibility-scripts.d.ts

@@ -34,4 +34,3 @@ declare class AccessibilityScripts {
 declare const _default: AccessibilityScripts;
 export default _default;
 export { Command };
-//# sourceMappingURL=accessibility-scripts.d.ts.map

package/build/service.d.ts

@@ -83,4 +83,3 @@ export default class BrowserstackService implements Services.ServiceInstance {
     private _executeCommand;
     private saveWorkerData;
 }
-//# sourceMappingURL=service.d.ts.map

package/build/testHub/utils.d.ts

@@ -17,4 +17,3 @@ export declare const getProductMapForBuildStartCall: (config: BrowserStackConfig
     [key: string]: boolean;
 };
 export {};
-//# sourceMappingURL=utils.d.ts.map

package/build/testOps/featureStats.d.ts

@@ -48,4 +48,3 @@ declare class FeatureStats {
     static fromJSON(json: Feature): FeatureStats;
 }
 export default FeatureStats;
-//# sourceMappingURL=featureStats.d.ts.map

package/build/testOps/featureUsage.d.ts

@@ -19,4 +19,3 @@ declare class FeatureUsage {
     };
 }
 export default FeatureUsage;
-//# sourceMappingURL=featureUsage.d.ts.map

package/build/testOps/listener.d.ts

@@ -37,4 +37,3 @@ declare class Listener {
     private getEventForHook;
 }
 export default Listener;
-//# sourceMappingURL=listener.d.ts.map

package/build/testOps/openRunsJournal.d.ts

@@ -0,0 +1,6 @@
+import type { TestData } from '../types.js';
+export declare const ORPHAN_FAILURE_REASON = "Test run did not complete: the process was interrupted or terminated before the test finished (finalized by BrowserStack SDK exit cleanup)";
+export declare function recordOpenRun(testData: TestData): void;
+export declare function clearOpenRun(uuid?: string): void;
+export declare function collectOrphanedRuns(): TestData[];
+export declare function finalizeOrphanedRuns(): Promise<number>;

package/build/testOps/requestUtils.d.ts

@@ -1,4 +1,3 @@
 import type { UploadType } from '../types.js';
 export declare function uploadEventData(eventData: UploadType | Array<UploadType>, eventUrl?: string): Promise<void>;
 export declare function sendScreenshots(eventData: Array<UploadType>): Promise<void>;
-//# sourceMappingURL=requestUtils.d.ts.map

package/build/testOps/testOpsConfig.d.ts

@@ -8,4 +8,3 @@ declare class TestOpsConfig {
     constructor(enabled?: boolean, manuallySet?: boolean);
 }
 export default TestOpsConfig;
-//# sourceMappingURL=testOpsConfig.d.ts.map

package/build/testOps/usageStats.d.ts

@@ -418,4 +418,3 @@ declare class UsageStats {
     static fromJSON(data: UsageStat): UsageStats;
 }
 export default UsageStats;
-//# sourceMappingURL=usageStats.d.ts.map

package/build/testorchestration/apply-orchestration.d.ts

@@ -4,4 +4,3 @@
  */
 export declare function applyOrchestrationIfEnabled(specs: string[], config: Record<string, any>): Promise<string[]>;
 export default applyOrchestrationIfEnabled;
-//# sourceMappingURL=apply-orchestration.d.ts.map

package/build/testorchestration/helpers.d.ts

@@ -50,4 +50,3 @@ export declare function getHostInfo(): {
  */
 export declare function getGitMetadataForAISelection(folders?: string[] | null): GitAISelectionResult[];
 export {};
-//# sourceMappingURL=helpers.d.ts.map

package/build/testorchestration/request-utils.d.ts

@@ -20,4 +20,3 @@ export declare class RequestUtils {
     }): Promise<Record<string, unknown> | string | null>;
 }
 export default RequestUtils;
-//# sourceMappingURL=request-utils.d.ts.map

package/build/testorchestration/test-ordering-server.d.ts

@@ -31,4 +31,3 @@ export declare class TestOrderingServer {
     getSplitTestsApiCallCount(): number;
 }
 export default TestOrderingServer;
-//# sourceMappingURL=test-ordering-server.d.ts.map

package/build/testorchestration/testorcherstrationhandler.d.ts

@@ -53,4 +53,3 @@ export declare class TestOrchestrationHandler {
     getOrderingInstrumentationData(): Record<string, OrderingInstrumentationValue>;
 }
 export default TestOrchestrationHandler;
-//# sourceMappingURL=testorcherstrationhandler.d.ts.map

package/build/testorchestration/testorcherstrationutils.d.ts

@@ -98,4 +98,3 @@ export declare class OrchestrationUtils {
     getBuildStartData(): Record<string, unknown>;
 }
 export default OrchestrationUtils;
-//# sourceMappingURL=testorcherstrationutils.d.ts.map

package/build/types.d.ts

@@ -53,13 +53,6 @@ export interface BrowserstackOptions extends Options.Testrunner {
     selfHeal?: boolean;
 }
 export interface BrowserstackConfig {
-    /**
-     * Absolute path to a CA certificate (PEM, single cert or bundle) to trust for outbound
-     * HTTPS when behind an SSL-inspecting corporate proxy (Zscaler/Netskope/Forcepoint).
-     * Overridable via the `BROWSERSTACK_EXTRA_CA_CERTS` env var. Merged with the system
-     * trust store (never replaces it).
-     */
-    proxyCaCertificate?: string;
     /**
      *`buildIdentifier` is a unique id to differentiate every execution that gets appended to
      * buildName. Choose your buildIdentifier format from the available expressions:
@@ -452,4 +445,3 @@ export interface FunnelData {
     event_properties: EventProperties;
 }
 export {};
-//# sourceMappingURL=types.d.ts.map

package/build/util.d.ts

@@ -3,7 +3,7 @@ import type { BeforeCommandArgs, AfterCommandArgs } from '@wdio/reporter';
 import type { ColorName } from 'chalk';
 import type { UploadType, BrowserstackConfig, BrowserstackOptions, LaunchResponse } from './types.js';
 import type { ITestCaseHookParameter } from './cucumber-types.js';
-import type { StartBinSessionResponse } from '@browserstack/wdio-browserstack-service';
+import type { StartBinSessionResponse } from './grpc/index.js';
 export type GitMetaData = {
     name: string;
     sha: string;
@@ -131,6 +131,8 @@ export declare function getCiInfo(): {
 export declare function getGitMetaData(): Promise<GitMetaData | undefined>;
 export declare function getUniqueIdentifier(test: Frameworks.Test, framework?: string): string;
 export declare function getUniqueIdentifierForCucumber(world: ITestCaseHookParameter): string;
+export declare function isLoadTestingSession(): boolean;
+export declare function getLtsSessionId(): string;
 export declare function getCloudProvider(browser: WebdriverIO.Browser | WebdriverIO.MultiRemoteBrowser): string;
 export declare function isBrowserstackSession(browser?: WebdriverIO.Browser | WebdriverIO.MultiRemoteBrowser): boolean | undefined;
 export declare function getScenarioExamples(world: ITestCaseHookParameter): string[] | undefined;
@@ -213,6 +215,14 @@ export declare function pollApi(url: string, params: Record<string, any>, header
 export declare function executeAccessibilityScript<ReturnType>(browser: any, fnBody: string, arg?: unknown): Promise<ReturnType>;
 export declare function generateHashCodeFromFields(fields: Array<string | object>): string;
 export declare function getBooleanValueFromString(value: string | undefined): boolean;
+/**
+ * SDK-3737: Coerce stringified booleans ('true'/'false', any case) in a flat
+ * options object to real booleans, leaving every other value untouched. Boolean-
+ * typed accessibility options (e.g. autoScanning) are commonly supplied as
+ * strings from JS config / env; without coercion they fail W3C caps validation
+ * and are silently dropped. Only the exact strings 'true'/'false' are converted.
+ */
+export declare function coerceStringBooleans<T extends Record<string, unknown>>(obj: T): T;
 /**
  * Validate boolean value from mixed types (boolean or string)
  * Only accepts true boolean or string "true" (case insensitive)
@@ -246,4 +256,3 @@ export declare const performO11ySync: (browser: WebdriverIO.Browser) => Promise<
  */
 export declare function isMultiRemoteCaps(capabilities: Capabilities.TestrunnerCapabilities): boolean;
 export {};
-//# sourceMappingURL=util.d.ts.map

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@wdio/browserstack-service",
-  "version": "9.29.1",
+  "version": "9.30.0",
   "description": "WebdriverIO service for better Browserstack integration",
-  "author": "Adam Bjerstedt <abjerstedt@gmail.com>",
-  "homepage": "https://github.com/webdriverio/webdriverio/tree/main/packages/wdio-browserstack-service",
+  "author": "BrowserStack <support@browserstack.com>",
+  "homepage": "https://github.com/browserstack/wdio-browserstack-service",
   "license": "MIT",
   "engines": {
     "node": ">=18.20.0"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/webdriverio/webdriverio.git",
-    "directory": "packages/wdio-browserstack-service"
+    "url": "git+https://github.com/browserstack/wdio-browserstack-service.git",
+    "directory": "packages/browserstack-service"
   },
   "keywords": [
     "webdriverio",
@@ -20,7 +20,7 @@
     "wdio-service"
   ],
   "bugs": {
-    "url": "https://github.com/webdriverio/webdriverio/issues"
+    "url": "https://github.com/browserstack/wdio-browserstack-service/issues"
   },
   "type": "module",
   "types": "./build/index.d.ts",
@@ -30,20 +30,35 @@
       "import": "./build/index.js"
     },
     "./cleanup": {
+      "types": "./build/cleanup.d.ts",
       "import": "./build/cleanup.js",
       "source": "./src/cleanup.ts"
     }
   },
   "typeScriptVersion": "3.8.3",
+  "files": [
+    "build",
+    "src/proto/**/*.proto",
+    "browserstack-service.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "rimraf ./build src/grpc/generated",
+    "generate": "buf generate",
+    "build": "rimraf ./build src/grpc/generated && buf generate && node ./scripts/build.mjs && tsc -p tsconfig.prod.json",
+    "build:watch": "node ./scripts/build.mjs --watch",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "prepack": "npm run build"
+  },
   "dependencies": {
     "@browserstack/ai-sdk-node": "1.5.17",
-    "@browserstack/wdio-browserstack-service": "^2.0.2",
+    "@bufbuild/protobuf": "^2.5.2",
+    "@grpc/grpc-js": "1.13.3",
     "@percy/appium-app": "^2.0.9",
     "@percy/selenium-webdriver": "^2.2.2",
     "@types/gitconfiglocal": "^2.0.1",
-    "@wdio/logger": "9.29.1",
-    "@wdio/reporter": "9.29.1",
-    "@wdio/types": "9.29.1",
     "browserstack-local": "^1.5.1",
     "chalk": "^5.3.0",
     "csv-writer": "^1.6.0",
@@ -53,21 +68,34 @@
     "tar": "^7.5.11",
     "undici": "^6.24.0",
     "uuid": "^11.1.0",
-    "webdriverio": "9.29.1",
     "winston-transport": "^4.5.0",
-    "yauzl": "^3.0.0"
+    "yauzl": "^3.4.0",
+    "@wdio/logger": "^9.0.0",
+    "@wdio/reporter": "^9.0.0",
+    "@wdio/types": "^9.0.0",
+    "webdriverio": "^9.0.0"
   },
   "peerDependencies": {
     "@wdio/cli": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0 || ^9.0.0"
   },
   "devDependencies": {
+    "@bufbuild/buf": "^1.55.1",
+    "@changesets/cli": "^2.27.9",
     "@types/node": "^20.1.0",
     "@types/tar": "^7.0.87",
     "@types/yauzl": "^2.10.3",
-    "@wdio/globals": "9.29.1"
+    "@wdio/globals": "^9.0.0",
+    "@wdio/logger": "^9.0.0",
+    "@wdio/reporter": "^9.0.0",
+    "@wdio/types": "^9.0.0",
+    "esbuild": "^0.27.2",
+    "rimraf": "^6.0.1",
+    "ts-proto": "^2.7.5",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4",
+    "webdriverio": "^9.0.0"
   },
   "publishConfig": {
     "access": "public"
-  },
-  "gitHead": "cea4a759f7e78c798e7dd1a0794ae4aeec5acdbf"
+  }
 }

package/src/proto/browserstack/sdk/v1/sdk-messages-accessibility.proto

@@ -0,0 +1,71 @@
+syntax = "proto3";
+
+package browserstack.sdk.v1;
+
+import "sdk-messages-observability.proto";
+import "sdk-messages-testhub.proto";
+
+message Accessibility {
+    bool success = 1;
+    optional AccessibilityOptions options = 2;
+    optional string error_trace_id = 3;
+    optional string code = 4;
+    repeated KeyMessage errors = 5;
+    optional bool is_app_accessibility = 6;
+
+    message AccessibilityOptions {
+        optional string status = 1;
+        repeated AccessibilityCapability capabilities = 2;
+        repeated AccessibilityScript scripts = 3;
+        optional AccessibilityCommandsToWrap commands_to_wrap = 4;
+
+        message AccessibilityCommandsToWrap {
+            repeated string scripts_to_run = 1;
+            repeated AccessibilityCommand commands = 2;
+        }
+
+        message AccessibilityCommand {
+            string name = 1;
+            string library = 2;
+            string module = 3;
+            string class = 4;
+            string method = 5;
+        }
+
+        message AccessibilityScript {
+            string name = 1;
+            string command = 2;
+        }
+
+        message AccessibilityCapability {
+            string name = 1;
+            string value = 2;
+        }
+    }
+}
+
+message AccessibilityConfigRequest {
+    string bin_session_id = 1;
+    uint32 platform_index = 2;
+    string framework_name = 3;
+    string framework_version = 4;
+    string hub_url = 5;
+}
+
+message AccessibilityConfigResponse {
+    bool success = 1;
+    optional TestHub testhub = 2;
+    optional Accessibility accessibility = 3;
+}
+
+message AccessibilityResultRequest {
+    string bin_session_id = 1;
+    string test_run_id = 2;
+    string session_id = 3;
+    string result_type = 4;
+}
+
+message AccessibilityResultResponse {
+    bool success = 1;
+    bytes result_response = 2;
+}

package/src/proto/browserstack/sdk/v1/sdk-messages-ai.proto

@@ -0,0 +1,48 @@
+syntax = "proto3";
+
+package browserstack.sdk.v1;
+
+message AIBrowserExtensionRequest {
+    string bin_session_id = 1;
+    string browser_name = 2;
+    string browser_version = 3;
+}
+
+message AIBrowserExtensionResponse {
+    bool success = 1;
+    optional string extension = 2;
+    optional string error = 3;
+}
+
+message AISelfHealGetRequest {
+    string bin_session_id = 1;
+    optional string platform_index = 2;
+
+    string framework_session_id = 3;
+    string locator_type = 4;
+}
+
+message AISelfHealGetResponse {
+    bool success = 1;
+    string framework_session_id = 2;
+    optional string locator_type = 3;
+    optional string locator_value = 4;
+    optional bool ai_healing = 5;
+    optional string error = 6;
+}
+
+message AISelfHealStepRequest {
+    string bin_session_id = 1;
+    optional string platform_index = 2;
+
+    string framework_session_id = 3;
+    bool is_success = 4;
+    string locator_type = 5;
+    string locator_value = 6;
+    string test_name = 7;
+}
+
+message AISelfHealStepResponse {
+    string framework_session_id = 1;
+    string execute_script = 2;
+}

package/src/proto/browserstack/sdk/v1/sdk-messages-observability.proto

@@ -0,0 +1,39 @@
+syntax = "proto3";
+
+package browserstack.sdk.v1;
+
+import "sdk-messages-testhub.proto";
+
+message KeyMessage {
+    string key = 1;
+    string message = 2;
+}
+
+message Observability {
+    bool success = 1;
+    optional ObservabilityOptions options = 2;
+    optional string error_trace_id = 3;
+    optional string code = 4;
+    repeated KeyMessage errors = 5;
+    optional bytes options_as_bytes = 6;
+
+    message ObservabilityOptions {
+        optional string allow_screenshots = 1;
+    }
+}
+
+message ObservabilityConfigRequest {
+    string bin_session_id = 1;
+    uint32 platform_index = 2;
+    string test_framework_name = 3;
+    string test_framework_version = 4;
+    optional string hub_url = 5;
+    optional string capabilities = 6;
+}
+
+message ObservabilityConfigResponse {
+    bool success = 1;
+    optional TestHub testhub = 2;
+    optional Observability observability = 3;
+    optional string capabilities = 4;
+}

package/src/proto/browserstack/sdk/v1/sdk-messages-percy.proto

@@ -0,0 +1,10 @@
+syntax = "proto3";
+
+package browserstack.sdk.v1;
+
+message Percy {
+    bool success = 1;
+    string percy_capture_mode = 2;
+    string percy_build_id = 3;
+    bool is_percy_auto_enabled = 4;
+}

package/src/proto/browserstack/sdk/v1/sdk-messages-testhub.proto

@@ -0,0 +1,10 @@
+syntax = "proto3";
+
+package browserstack.sdk.v1;
+
+message TestHub {
+    string jwt = 1;
+    string build_hashed_id = 2;
+    bool testhub_events = 3;
+    bytes errors = 4;
+}