From e4ac22aa6867c14b7ad24342d9693e7d46d78aa3 Mon Sep 17 00:00:00 2001
From: rounak bhatia <rounak@browserstack.com>
Date: Thu, 24 Sep 2026 17:57:42 +0530
Subject: [PATCH 1/2] fix(percy): float @percy/webdriverio to ^3.3.4

Removes the temporary >=3.3.0 <3.3.3 pin now that Percy has fixed the
broken 3.3.3 packaging (missing _iframe_shim.js) in 3.3.4. Restores Percy
web snapshot capture on WebdriverIO without the version cap.

SDK-7711

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 package-lock.json                          | 43 ++++++++++++++--------
 packages/browserstack-service/package.json |  2 +-
 2 files changed, 28 insertions(+), 17 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 18f0a289..6c7bc729 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1785,20 +1785,6 @@
         "node": ">=14"
       }
     },
-    "node_modules/@percy/webdriverio": {
-      "version": "3.3.2",
-      "resolved": "https://registry.npmjs.org/@percy/webdriverio/-/webdriverio-3.3.2.tgz",
-      "integrity": "sha512-YpnrUv6tRvITqSo3fNz2jLh1qy1Rmd5QfblOPsthbXNPQ1quMScuZwM8HGPTGiiqouZXByBzkUCIss/mGgJlkQ==",
-      "dependencies": {
-        "@percy/sdk-utils": "^1.30.3"
-      },
-      "engines": {
-        "node": ">=14"
-      },
-      "peerDependencies": {
-        "webdriverio": "~6 || ~7 || ~8 || ~ 9"
-      }
-    },
     "node_modules/@pkgjs/parseargs": {
       "version": "0.11.0",
       "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz",
@@ -12919,7 +12905,7 @@
     },
     "packages/browserstack-service": {
       "name": "@wdio/browserstack-service",
-      "version": "9.36.2",
+      "version": "9.37.0",
       "license": "MIT",
       "dependencies": {
         "@browserstack/ai-sdk-node": "1.5.17",
@@ -12927,7 +12913,7 @@
         "@grpc/grpc-js": "~1.13.5",
         "@percy/appium-app": "^2.0.9",
         "@percy/selenium-webdriver": "^2.2.2",
-        "@percy/webdriverio": ">=3.3.0 <3.3.3",
+        "@percy/webdriverio": "^3.3.4",
         "@types/gitconfiglocal": "^2.0.1",
         "@wdio/logger": "^9.0.0",
         "@wdio/reporter": "^9.0.0",
@@ -13409,6 +13395,31 @@
         "node": ">=18"
       }
     },
+    "packages/browserstack-service/node_modules/@percy/sdk-utils": {
+      "version": "1.32.10",
+      "resolved": "https://registry.npmjs.org/@percy/sdk-utils/-/sdk-utils-1.32.10.tgz",
+      "integrity": "sha512-AO6gLgwS3OzleOi5A3BFwQATpkR56rYGji78pXLas9dhN4WjB8C/SfWESBloLk6Yz9eHGy+24z4nhDmDJ/Q5Dw==",
+      "dependencies": {
+        "pac-proxy-agent": "^7.0.2"
+      },
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "packages/browserstack-service/node_modules/@percy/webdriverio": {
+      "version": "3.3.4",
+      "resolved": "https://registry.npmjs.org/@percy/webdriverio/-/webdriverio-3.3.4.tgz",
+      "integrity": "sha512-SoRkeZO2cUzgvjtf5uWULqW2JXgUhZL2tEgAKqpccfu2hBYw4CerR/SqdZBtgXiP5n/5CeHv5cPbU3hDpP4jVA==",
+      "dependencies": {
+        "@percy/sdk-utils": "^1.32.0"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "peerDependencies": {
+        "webdriverio": "~6 || ~7 || ~8 || ~ 9"
+      }
+    },
     "packages/browserstack-service/node_modules/@vitest/pretty-format": {
       "version": "3.2.6",
       "dev": true,
diff --git a/packages/browserstack-service/package.json b/packages/browserstack-service/package.json
index 7b2432f2..09811e37 100644
--- a/packages/browserstack-service/package.json
+++ b/packages/browserstack-service/package.json
@@ -58,7 +58,7 @@
     "@grpc/grpc-js": "~1.13.5",
     "@percy/appium-app": "^2.0.9",
     "@percy/selenium-webdriver": "^2.2.2",
-    "@percy/webdriverio": ">=3.3.0 <3.3.3",
+    "@percy/webdriverio": "^3.3.4",
     "@types/gitconfiglocal": "^2.0.1",
     "@wdio/logger": "^9.0.0",
     "@wdio/reporter": "^9.0.0",

From 1a103aaab68675eba0835f16cdd24a4ae5a3ae29 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 24 Sep 2026 12:29:03 +0000
Subject: [PATCH 2/2] chore(changeset): auto-generate from PR template (patch)

---
 .changeset/pr-228.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/pr-228.md

diff --git a/.changeset/pr-228.md b/.changeset/pr-228.md
new file mode 100644
index 00000000..c27ab064
--- /dev/null
+++ b/.changeset/pr-228.md
@@ -0,0 +1,5 @@
+---
+"@wdio/browserstack-service": patch
+---
+
+- Restored Percy visual snapshots on WebdriverIO by picking up the fixed `@percy/webdriverio@3.3.4`.