appium-xcuitest-driver 12.2.0 → 12.3.0

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [12.3.0](https://github.com/appium/appium-xcuitest-driver/compare/v12.2.1...v12.3.0) (2026-08-08)
+
+### Features
+
+* Add customizable exponential backoff for tunnel reconnect retries ([#2936](https://github.com/appium/appium-xcuitest-driver/issues/2936)) ([84ed39d](https://github.com/appium/appium-xcuitest-driver/commit/84ed39dcaf274368f28fed85c980cf7d23ce470e))
+
+## [12.2.1](https://github.com/appium/appium-xcuitest-driver/compare/v12.2.0...v12.2.1) (2026-08-07)
+
+### Miscellaneous Chores
+
+* Drop chai ([#2935](https://github.com/appium/appium-xcuitest-driver/issues/2935)) ([d31bba4](https://github.com/appium/appium-xcuitest-driver/commit/d31bba46420d816098de8acc4bb0a27060c80b81))
+* rename safe occurrences of JWProxy ([#2937](https://github.com/appium/appium-xcuitest-driver/issues/2937)) ([b479f7b](https://github.com/appium/appium-xcuitest-driver/commit/b479f7b12ceb32eba97e08f0b6a1eb44b9652b81))
+
 ## [12.2.0](https://github.com/appium/appium-xcuitest-driver/compare/v12.1.4...v12.2.0) (2026-08-04)
 
 ### Features

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "appium-xcuitest-driver",
-  "version": "12.2.0",
+  "version": "12.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-xcuitest-driver",
-      "version": "12.2.0",
+      "version": "12.3.0",
       "license": "Apache-2.0",
       "dependencies": {
         "@appium/css-locator-to-native": "^1.0.1",
@@ -15,7 +15,7 @@
         "appium-ios-device": "^3.1.12",
         "appium-ios-simulator": "^9.0.0",
         "appium-remote-debugger": "^16.0.0",
-        "appium-webdriveragent": "^16.0.0",
+        "appium-webdriveragent": "^16.1.4",
         "appium-xcode": "^7.0.0",
         "async-lock": "^1.4.0",
         "asyncbox": "^6.3.0",
@@ -39,15 +39,11 @@
         "@appium/tsconfig": "^1.2.0",
         "@appium/types": "^1.5.0",
         "@types/async-lock": "1.4.2",
-        "@types/chai": "5.2.3",
-        "@types/chai-as-promised": "8.0.2",
         "@types/node": "^26.0.0",
         "@types/pem": "1.14.4",
         "@types/portscanner": "^2.1.1",
-        "@types/semver": "7.7.1",
+        "@types/semver": "7.8.0",
         "@types/sinon": "22.0.0",
-        "chai": "^6.0.0",
-        "chai-as-promised": "^8.0.0",
         "pem": "^1.14.8",
         "sharp": "^0.x",
         "sinon": "^22.0.0",
@@ -482,13 +478,16 @@
       }
     },
     "node_modules/ansi-styles": {
-      "version": "6.2.3",
-      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
-      "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
-      "devOptional": true,
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "extraneous": true,
       "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
       "engines": {
-        "node": ">=12"
+        "node": ">=8"
       },
       "funding": {
         "url": "https://github.com/chalk/ansi-styles?sponsor=1"
@@ -513,9 +512,9 @@
       }
     },
     "node_modules/appium-ios-remotexpc": {
-      "version": "5.13.3",
-      "resolved": "https://registry.npmjs.org/appium-ios-remotexpc/-/appium-ios-remotexpc-5.13.3.tgz",
-      "integrity": "sha512-ykUkvBTjGj69rzbgKJSoru+suT5kalaTpKSc9daKgvzHtRYRkXjyo/uFLtK2vCk+6UITD5c3iW31AhS+zbxwRg==",
+      "version": "5.13.6",
+      "resolved": "https://registry.npmjs.org/appium-ios-remotexpc/-/appium-ios-remotexpc-5.13.6.tgz",
+      "integrity": "sha512-leWj0oCe/DgIPlMZc3FCLvSnyZF57uW+Gq4OkZeqqFojpY1tgTN6YGN3AFYSk/VfF/uvbYtNhT1fn+R6Lf8zow==",
       "license": "Apache-2.0",
       "optional": true,
       "dependencies": {
@@ -527,8 +526,7 @@
         "axios": "^1.15.1",
         "commander": "^14.0.1",
         "minimatch": "^10.1.1",
-        "node-devicectl": "^1.2.0",
-        "npm-run-all2": "^8.0.4",
+        "node-devicectl": "^2.0.0",
         "path-to-regexp": "^8.3.0"
       },
       "engines": {
@@ -536,21 +534,6 @@
         "npm": ">=10"
       }
     },
-    "node_modules/appium-ios-remotexpc/node_modules/node-devicectl": {
-      "version": "1.4.3",
-      "resolved": "https://registry.npmjs.org/node-devicectl/-/node-devicectl-1.4.3.tgz",
-      "integrity": "sha512-AnyroE1FzGhQd5oJ9vo/IJl37XypMFFkTEU7PFcrSDpbJo0KCXdLd5twbgZyUyqtma1KgK7VuE6NsIoMpaBfGA==",
-      "license": "Apache-2.0",
-      "optional": true,
-      "dependencies": {
-        "@appium/logger": "^2.0.0-rc.1",
-        "teen_process": "^4.1.0"
-      },
-      "engines": {
-        "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
-        "npm": ">=10"
-      }
-    },
     "node_modules/appium-ios-simulator": {
       "version": "9.1.2",
       "resolved": "https://registry.npmjs.org/appium-ios-simulator/-/appium-ios-simulator-9.1.2.tgz",
@@ -589,9 +572,9 @@
       }
     },
     "node_modules/appium-remote-debugger": {
-      "version": "16.0.3",
-      "resolved": "https://registry.npmjs.org/appium-remote-debugger/-/appium-remote-debugger-16.0.3.tgz",
-      "integrity": "sha512-IJEHciiooDtA29WfXy/W9kEBpySWQ7rSmnNti2hSmh0+f3Xvi0QgW7aEsaYCHVxAc4lvmX7u8d8I2qrFS9BqyA==",
+      "version": "16.4.0",
+      "resolved": "https://registry.npmjs.org/appium-remote-debugger/-/appium-remote-debugger-16.4.0.tgz",
+      "integrity": "sha512-Rr0u0CNZPte2aEBozGIUJxRclzyqNUkBBrDZLo4rxwwEfnalFcpWfTJa9/f1YtkdakMfTRysJA3YFwmGuVFQ8w==",
       "license": "Apache-2.0",
       "dependencies": {
         "@appium/base-driver": "^10.0.0-rc.1",
@@ -610,9 +593,9 @@
       }
     },
     "node_modules/appium-webdriveragent": {
-      "version": "16.1.3",
-      "resolved": "https://registry.npmjs.org/appium-webdriveragent/-/appium-webdriveragent-16.1.3.tgz",
-      "integrity": "sha512-fn9jrX9CSS/5EMu897WMMwyZSJAuSxJG9sl5rHmh6xQtS19raNAIt0cebb6OnJH0OfW1Yi7C63kaf63+KBSJsg==",
+      "version": "16.1.5",
+      "resolved": "https://registry.npmjs.org/appium-webdriveragent/-/appium-webdriveragent-16.1.5.tgz",
+      "integrity": "sha512-R8SM8NEak5TAVbvnzBjTy9F5yJpgOE1d0kVahIcTvipFPU6g06Jg1moNPIZs0+nsykyRLIvED3zFZA0G/eNZCQ==",
       "license": "Apache-2.0",
       "dependencies": {
         "@appium/base-driver": "^10.3.0",
@@ -803,9 +786,9 @@
       }
     },
     "node_modules/bare-url": {
-      "version": "2.4.7",
-      "resolved": "https://registry.npmjs.org/bare-url/-/bare-url-2.4.7.tgz",
-      "integrity": "sha512-o8CRCiJtib+ycO3mE4A5UChtGX4dDP2XxsWVu9P+Zc3H8tcmKwNVEDoDTXmwN+uuMhfKeT7/i7Y26xS8W7ohoA==",
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/bare-url/-/bare-url-2.5.1.tgz",
+      "integrity": "sha512-cD5ciQuKlx+eumTCfqbfiL+fhQm+dHbVNB/cX4+d+I/nx4JsVop9VoFEPAs5RJ6I84QR6bZIBjpd2kjDOYeWcg==",
       "license": "Apache-2.0",
       "dependencies": {
         "bare-path": "^3.0.0"
@@ -979,42 +962,6 @@
         "url": "https://github.com/chalk/chalk?sponsor=1"
       }
     },
-    "node_modules/chalk/node_modules/ansi-styles": {
-      "version": "4.3.0",
-      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
-      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
-      "extraneous": true,
-      "license": "MIT",
-      "dependencies": {
-        "color-convert": "^2.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
-      }
-    },
-    "node_modules/chalk/node_modules/color-convert": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
-      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
-      "extraneous": true,
-      "license": "MIT",
-      "dependencies": {
-        "color-name": "~1.1.4"
-      },
-      "engines": {
-        "node": ">=7.0.0"
-      }
-    },
-    "node_modules/chalk/node_modules/color-name": {
-      "version": "1.1.4",
-      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
-      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
-      "extraneous": true,
-      "license": "MIT"
-    },
     "node_modules/cliui": {
       "version": "9.0.1",
       "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz",
@@ -1085,18 +1032,38 @@
       }
     },
     "node_modules/color-convert": {
-      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-3.1.3.tgz",
-      "integrity": "sha512-fasDH2ont2GqF5HpyO4w0+BcewlhHEZOFn9c1ckZdHpJ56Qb7MHhH/IcJZbBGgvdtwdwNbLvxiBEdg336iA9Sg==",
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "extraneous": true,
       "license": "MIT",
       "dependencies": {
-        "color-name": "^2.0.0"
+        "color-name": "~1.1.4"
       },
       "engines": {
-        "node": ">=14.6"
+        "node": ">=7.0.0"
       }
     },
     "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "extraneous": true,
+      "license": "MIT"
+    },
+    "node_modules/color-string": {
+      "version": "2.1.4",
+      "resolved": "https://registry.npmjs.org/color-string/-/color-string-2.1.4.tgz",
+      "integrity": "sha512-Bb6Cq8oq0IjDOe8wJmi4JeNn763Xs9cfrBcaylK1tPypWzyoy2G3l90v9k64kjphl/ZJjPIShFztenRomi8WTg==",
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/color-string/node_modules/color-name": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/color-name/-/color-name-2.1.1.tgz",
       "integrity": "sha512-p2FdgwVx1a9yWBHP2wI0VgShkDpgN4kZISkxdNipGBJWpa5G6b04OINlVWCyJj0JmfvcPrgqt95E9k8yvaOJFg==",
@@ -1105,16 +1072,25 @@
         "node": ">=12.20"
       }
     },
-    "node_modules/color-string": {
-      "version": "2.1.4",
-      "resolved": "https://registry.npmjs.org/color-string/-/color-string-2.1.4.tgz",
-      "integrity": "sha512-Bb6Cq8oq0IjDOe8wJmi4JeNn763Xs9cfrBcaylK1tPypWzyoy2G3l90v9k64kjphl/ZJjPIShFztenRomi8WTg==",
+    "node_modules/color/node_modules/color-convert": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-3.1.3.tgz",
+      "integrity": "sha512-fasDH2ont2GqF5HpyO4w0+BcewlhHEZOFn9c1ckZdHpJ56Qb7MHhH/IcJZbBGgvdtwdwNbLvxiBEdg336iA9Sg==",
       "license": "MIT",
       "dependencies": {
         "color-name": "^2.0.0"
       },
       "engines": {
-        "node": ">=18"
+        "node": ">=14.6"
+      }
+    },
+    "node_modules/color/node_modules/color-name": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-2.1.1.tgz",
+      "integrity": "sha512-p2FdgwVx1a9yWBHP2wI0VgShkDpgN4kZISkxdNipGBJWpa5G6b04OINlVWCyJj0JmfvcPrgqt95E9k8yvaOJFg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.20"
       }
     },
     "node_modules/combined-stream": {
@@ -1239,44 +1215,6 @@
         "node": ">=18"
       }
     },
-    "node_modules/cross-spawn": {
-      "version": "7.0.6",
-      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
-      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "path-key": "^3.1.0",
-        "shebang-command": "^2.0.0",
-        "which": "^2.0.1"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/cross-spawn/node_modules/isexe": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
-      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
-      "license": "ISC",
-      "optional": true
-    },
-    "node_modules/cross-spawn/node_modules/which": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
-      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
-      "license": "ISC",
-      "optional": true,
-      "dependencies": {
-        "isexe": "^2.0.0"
-      },
-      "bin": {
-        "node-which": "bin/node-which"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
     "node_modules/css-selector-parser": {
       "version": "3.3.0",
       "resolved": "https://registry.npmjs.org/css-selector-parser/-/css-selector-parser-3.3.0.tgz",
@@ -2112,16 +2050,6 @@
         "ms": "^2.1.1"
       }
     },
-    "node_modules/json-parse-even-better-errors": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-4.0.0.tgz",
-      "integrity": "sha512-lR4MXjGNgkJc7tkQ97kb2nuEMnNCyU//XYVH0MKTGcXEiSudQ5MKGKen3C5QubYy0vmq+JGitUg92uuywGEwIA==",
-      "license": "MIT",
-      "optional": true,
-      "engines": {
-        "node": "^18.17.0 || >=20.5.0"
-      }
-    },
     "node_modules/json-schema": {
       "version": "0.4.0",
       "resolved": "https://registry.npmjs.org/json-schema/-/json-schema-0.4.0.tgz",
@@ -2267,15 +2195,6 @@
         "url": "https://opencollective.com/express"
       }
     },
-    "node_modules/memorystream": {
-      "version": "0.3.1",
-      "resolved": "https://registry.npmjs.org/memorystream/-/memorystream-0.3.1.tgz",
-      "integrity": "sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw==",
-      "optional": true,
-      "engines": {
-        "node": ">= 0.10.0"
-      }
-    },
     "node_modules/merge-descriptors": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
@@ -2510,82 +2429,6 @@
         "node": ">=0.10.0"
       }
     },
-    "node_modules/npm-normalize-package-bin": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/npm-normalize-package-bin/-/npm-normalize-package-bin-4.0.0.tgz",
-      "integrity": "sha512-TZKxPvItzai9kN9H/TkmCtx/ZN/hvr3vUycjlfmH0ootY9yFBzNOpiXAdIn1Iteqsvk4lQn6B5PTrt+n6h8k/w==",
-      "license": "ISC",
-      "optional": true,
-      "engines": {
-        "node": "^18.17.0 || >=20.5.0"
-      }
-    },
-    "node_modules/npm-run-all2": {
-      "version": "8.0.4",
-      "resolved": "https://registry.npmjs.org/npm-run-all2/-/npm-run-all2-8.0.4.tgz",
-      "integrity": "sha512-wdbB5My48XKp2ZfJUlhnLVihzeuA1hgBnqB2J9ahV77wLS+/YAJAlN8I+X3DIFIPZ3m5L7nplmlbhNiFDmXRDA==",
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "ansi-styles": "^6.2.1",
-        "cross-spawn": "^7.0.6",
-        "memorystream": "^0.3.1",
-        "picomatch": "^4.0.2",
-        "pidtree": "^0.6.0",
-        "read-package-json-fast": "^4.0.0",
-        "shell-quote": "^1.7.3",
-        "which": "^5.0.0"
-      },
-      "bin": {
-        "npm-run-all": "bin/npm-run-all/index.js",
-        "npm-run-all2": "bin/npm-run-all/index.js",
-        "run-p": "bin/run-p/index.js",
-        "run-s": "bin/run-s/index.js"
-      },
-      "engines": {
-        "node": "^20.5.0 || >=22.0.0",
-        "npm": ">= 10"
-      }
-    },
-    "node_modules/npm-run-all2/node_modules/isexe": {
-      "version": "3.1.5",
-      "resolved": "https://registry.npmjs.org/isexe/-/isexe-3.1.5.tgz",
-      "integrity": "sha512-6B3tLtFqtQS4ekarvLVMZ+X+VlvQekbe4taUkf/rhVO3d/h0M2rfARm/pXLcPEsjjMsFgrFgSrhQIxcSVrBz8w==",
-      "license": "BlueOak-1.0.0",
-      "optional": true,
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/npm-run-all2/node_modules/picomatch": {
-      "version": "4.0.5",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.5.tgz",
-      "integrity": "sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==",
-      "license": "MIT",
-      "optional": true,
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
-    "node_modules/npm-run-all2/node_modules/which": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/which/-/which-5.0.0.tgz",
-      "integrity": "sha512-JEdGzHwwkrbWoGOlIHqQ5gtprKGOenpDHpxE9zVR1bWbOtYRyPPHMe9FaP6x61CmNaTThSkb0DAJte5jD+DmzQ==",
-      "license": "ISC",
-      "optional": true,
-      "dependencies": {
-        "isexe": "^3.1.1"
-      },
-      "bin": {
-        "node-which": "bin/which.js"
-      },
-      "engines": {
-        "node": "^18.17.0 || >=20.5.0"
-      }
-    },
     "node_modules/object-inspect": {
       "version": "1.13.4",
       "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
@@ -2682,16 +2525,6 @@
         "node": ">= 0.8"
       }
     },
-    "node_modules/path-key": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
-      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
-      "license": "MIT",
-      "optional": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
     "node_modules/path-scurry": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.2.tgz",
@@ -2724,19 +2557,6 @@
       "integrity": "sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==",
       "license": "MIT"
     },
-    "node_modules/pidtree": {
-      "version": "0.6.1",
-      "resolved": "https://registry.npmjs.org/pidtree/-/pidtree-0.6.1.tgz",
-      "integrity": "sha512-e0F9AOF1JMrCfBsyJOwU9lNvQ0WtXTq0j/4jk0BQ5JSI9VAybPXmDpPRw/2FQ3e5d3ZFN1mLh7jW99m/jjaptw==",
-      "license": "MIT",
-      "optional": true,
-      "bin": {
-        "pidtree": "bin/pidtree.js"
-      },
-      "engines": {
-        "node": ">=0.10"
-      }
-    },
     "node_modules/plist": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/plist/-/plist-4.0.0.tgz",
@@ -2863,20 +2683,6 @@
         "node": ">= 0.10"
       }
     },
-    "node_modules/read-package-json-fast": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/read-package-json-fast/-/read-package-json-fast-4.0.0.tgz",
-      "integrity": "sha512-qpt8EwugBWDw2cgE2W+/3oxC+KTez2uSVR8JU9Q36TXPAGCaozfQUs59v4j4GFpWTaw0i6hAZSvOmu1J0uOEUg==",
-      "license": "ISC",
-      "optional": true,
-      "dependencies": {
-        "json-parse-even-better-errors": "^4.0.0",
-        "npm-normalize-package-bin": "^4.0.0"
-      },
-      "engines": {
-        "node": "^18.17.0 || >=20.5.0"
-      }
-    },
     "node_modules/readable-stream": {
       "version": "4.7.0",
       "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-4.7.0.tgz",
@@ -3162,29 +2968,6 @@
         }
       }
     },
-    "node_modules/shebang-command": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
-      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "shebang-regex": "^3.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/shebang-regex": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
-      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
-      "license": "MIT",
-      "optional": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
     "node_modules/shell-quote": {
       "version": "1.10.0",
       "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.10.0.tgz",
@@ -3776,6 +3559,19 @@
         "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
       }
     },
+    "node_modules/wrap-ansi/node_modules/ansi-styles": {
+      "version": "6.2.3",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
+      "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
     "node_modules/wrap-ansi/node_modules/emoji-regex": {
       "version": "10.6.0",
       "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz",
@@ -3824,9 +3620,9 @@
       "license": "ISC"
     },
     "node_modules/ws": {
-      "version": "8.21.2",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.2.tgz",
-      "integrity": "sha512-54dMVAo4WIe6SKy3vBgN+9bJZqqQ8IMRevAkOLQALhi49qkkQDQfWdAZ8KQlXiEabw88ARXXdUrlvtbKQX+aKw==",
+      "version": "8.21.3",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.3.tgz",
+      "integrity": "sha512-201TZ/kPWxoPr/OKWjquZR1SWKXcvxdH+e1xrx89b3YbmzLMFCLfnaG1HFIgWzJOEWZ7MvpK++odZufgYR50Rw==",
       "license": "MIT",
       "engines": {
         "node": ">=10.0.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-xcuitest-driver",
-  "version": "12.2.0",
+  "version": "12.3.0",
   "description": "Appium driver for iOS using XCUITest for backend",
   "keywords": [
     "appium",
@@ -74,7 +74,7 @@
     "appium-ios-device": "^3.1.12",
     "appium-ios-simulator": "^9.0.0",
     "appium-remote-debugger": "^16.0.0",
-    "appium-webdriveragent": "^16.0.0",
+    "appium-webdriveragent": "^16.1.4",
     "appium-xcode": "^7.0.0",
     "async-lock": "^1.4.0",
     "asyncbox": "^6.3.0",
@@ -98,15 +98,11 @@
     "@appium/tsconfig": "^1.2.0",
     "@appium/types": "^1.5.0",
     "@types/async-lock": "1.4.2",
-    "@types/chai": "5.2.3",
-    "@types/chai-as-promised": "8.0.2",
     "@types/node": "^26.0.0",
     "@types/pem": "1.14.4",
     "@types/portscanner": "^2.1.1",
-    "@types/semver": "7.7.1",
+    "@types/semver": "7.8.0",
     "@types/sinon": "22.0.0",
-    "chai": "^6.0.0",
-    "chai-as-promised": "^8.0.0",
     "pem": "^1.14.8",
     "sharp": "^0.x",
     "sinon": "^22.0.0",

package/scripts/lib/retry-policy.mjs

@@ -0,0 +1,127 @@
+export const DEFAULT_DISCONNECT_RETRY_INTERVAL_MS = 1000;
+export const DEFAULT_DISCONNECT_RETRY_BACKOFF_MULTIPLIER = 2;
+export const DEFAULT_DISCONNECT_RETRY_BACKOFF_MAX_INTERVAL_MS = 30_000;
+export const DEFAULT_DISCONNECT_RETRY_BACKOFF_JITTER = 0.5;
+
+/**
+ * @abstract
+ * Common attempt-counting behavior shared by all retry policies. Subclasses only need to implement
+ * `getDelayMs()`.
+ */
+export class RetryPolicy {
+  /**
+   * @param {{maxAttempts: number | null, intervalMs: number}} opts - maxAttempts: null disables
+   * retries entirely; 0 means unlimited retries
+   */
+  constructor({maxAttempts, intervalMs}) {
+    if (new.target === RetryPolicy) {
+      throw new TypeError('RetryPolicy is abstract and cannot be instantiated directly');
+    }
+    this.maxAttempts = maxAttempts;
+    this._intervalMs = intervalMs;
+  }
+
+  get isEnabled() {
+    return this.maxAttempts !== null;
+  }
+
+  /**
+   * @param {number} attemptsMade - number of attempts already made
+   * @returns {boolean}
+   */
+  hasAttemptsRemaining(attemptsMade) {
+    const {maxAttempts} = this;
+    if (maxAttempts === null) {
+      return false;
+    }
+    return maxAttempts === 0 || attemptsMade < maxAttempts;
+  }
+
+  /**
+   * @abstract
+   * @param {number} _attempt - 1-based number of the attempt about to be made
+   * @returns {number}
+   */
+  getDelayMs(_attempt) {
+    throw new Error('Not implemented');
+  }
+}
+
+/**
+ * Fixed-interval retry policy: waits the same delay between every attempt.
+ */
+export class FixedIntervalRetryPolicy extends RetryPolicy {
+  /**
+   * @param {number} _attempt - 1-based number of the attempt about to be made
+   * @returns {number}
+   */
+  getDelayMs(_attempt) {
+    return this._intervalMs;
+  }
+}
+
+/**
+ * Exponential-backoff retry policy: the delay grows by a multiplier on each attempt, capped at a
+ * configured maximum.
+ */
+export class ExponentialBackoffRetryPolicy extends RetryPolicy {
+  /**
+   * @param {{maxAttempts: number | null, intervalMs: number, backoffMultiplier: number, backoffMaxIntervalMs: number, jitter: number}} opts
+   * - jitter: fraction of the delay to randomize away, in [0, 1]. 0 always returns the exact
+   * computed delay; 1 returns a value uniformly distributed between 0 and the computed delay.
+   * Jitter spreads out devices that dropped together instead of having them retry in lockstep and
+   * stay synchronised once they reach the cap.
+   */
+  constructor({maxAttempts, intervalMs, backoffMultiplier, backoffMaxIntervalMs, jitter}) {
+    super({maxAttempts, intervalMs});
+    if (backoffMaxIntervalMs < intervalMs) {
+      throw new Error(
+        `Invalid disconnect retry backoff max interval: ${backoffMaxIntervalMs}. ` +
+          `Expected a value >= the initial interval (${intervalMs}).`,
+      );
+    }
+    if (jitter < 0 || jitter > 1) {
+      throw new Error(`Invalid disconnect retry backoff jitter: ${jitter}. Expected a value between 0 and 1.`);
+    }
+    this._backoffMultiplier = backoffMultiplier;
+    this._backoffMaxIntervalMs = backoffMaxIntervalMs;
+    this._jitter = jitter;
+  }
+
+  /**
+   * @param {number} attempt - 1-based number of the attempt about to be made
+   * @returns {number}
+   */
+  getDelayMs(attempt) {
+    const delayMs = this._intervalMs * this._backoffMultiplier ** (attempt - 1);
+    const cappedDelayMs = Math.min(delayMs, this._backoffMaxIntervalMs);
+    return Math.round(cappedDelayMs * (1 - this._jitter * Math.random()));
+  }
+}
+
+/**
+ * @param {{strategy: 'fixed' | 'exponential', maxAttempts: number | null, intervalMs: number, backoffMultiplier?: number, backoffMaxIntervalMs?: number, jitter?: number}} opts
+ * @returns {RetryPolicy}
+ */
+export function createDisconnectRetryPolicy({
+  strategy,
+  maxAttempts,
+  intervalMs,
+  backoffMultiplier = DEFAULT_DISCONNECT_RETRY_BACKOFF_MULTIPLIER,
+  backoffMaxIntervalMs = DEFAULT_DISCONNECT_RETRY_BACKOFF_MAX_INTERVAL_MS,
+  jitter = DEFAULT_DISCONNECT_RETRY_BACKOFF_JITTER,
+}) {
+  if (strategy === 'fixed') {
+    return new FixedIntervalRetryPolicy({maxAttempts, intervalMs});
+  }
+  if (strategy === 'exponential') {
+    return new ExponentialBackoffRetryPolicy({
+      maxAttempts,
+      intervalMs,
+      backoffMultiplier,
+      backoffMaxIntervalMs,
+      jitter,
+    });
+  }
+  throw new Error(`Invalid disconnect retry strategy: ${strategy}. Expected 'fixed' or 'exponential'.`);
+}

package/scripts/tunnel-creation.mjs

@@ -27,6 +27,14 @@ import {Command} from 'commander';
 
 import {parsePositiveIntegerOption} from './lib/options.mjs';
 import {startTimeoutProgressLogger} from './lib/progress.mjs';
+import {
+  createDisconnectRetryPolicy,
+  DEFAULT_DISCONNECT_RETRY_BACKOFF_JITTER,
+  DEFAULT_DISCONNECT_RETRY_BACKOFF_MAX_INTERVAL_MS,
+  DEFAULT_DISCONNECT_RETRY_BACKOFF_MULTIPLIER,
+  DEFAULT_DISCONNECT_RETRY_INTERVAL_MS,
+  FixedIntervalRetryPolicy,
+} from './lib/retry-policy.mjs';
 import {assertRoot} from './lib/root.mjs';
 
 const log = logger.getLogger('TunnelCreation');
@@ -65,9 +73,11 @@ class TunnelCreator {
     /** @type {Map<string, import('appium-ios-remotexpc').AppleTVTunnelService>} */
     this._appletvTunnelServicesByUdid = new Map();
     this._isCleaningUp = false;
-    /** @type {number | null} */
-    this._disconnectRetryMaxAttempts = null;
-    this._disconnectRetryIntervalMs = 1000;
+    /** @type {import('./lib/retry-policy.mjs').RetryPolicy} */
+    this._disconnectRetryPolicy = new FixedIntervalRetryPolicy({
+      maxAttempts: null,
+      intervalMs: DEFAULT_DISCONNECT_RETRY_INTERVAL_MS,
+    });
   }
 
   get tunnelRegistryPort() {
@@ -83,12 +93,10 @@ class TunnelCreator {
   }
 
   /**
-   * @param {number | null} maxAttempts - null disables retries; 0 means unlimited retries
-   * @param {number} intervalMs
+   * @param {import('./lib/retry-policy.mjs').RetryPolicy} policy
    */
-  setDisconnectRetryPolicy(maxAttempts, intervalMs) {
-    this._disconnectRetryMaxAttempts = maxAttempts;
-    this._disconnectRetryIntervalMs = intervalMs;
+  setDisconnectRetryPolicy(policy) {
+    this._disconnectRetryPolicy = policy;
   }
 
   /**
@@ -576,10 +584,6 @@ class TunnelCreator {
         if (!this._isRetryEnabledForUdid(udid)) {
           return;
         }
-        const maxAttempts = this._disconnectRetryMaxAttempts;
-        if (maxAttempts === null) {
-          return;
-        }
 
         const device = this._usbDevicesByUdid.get(udid);
         const isAppleTV = this._appleTVDeviceIds.has(udid);
@@ -587,17 +591,19 @@ class TunnelCreator {
           return;
         }
 
-        let attempt = 0;
+        const policy = this._disconnectRetryPolicy;
+        let attemptsMade = 0;
         while (!this._isCleaningUp) {
-          if (maxAttempts !== 0 && attempt >= maxAttempts) {
+          if (!policy.hasAttemptsRemaining(attemptsMade)) {
             log.warn(`Retry limit reached for ${udid}; keeping it removed from the registry`);
             return;
           }
-          attempt += 1;
+          attemptsMade += 1;
+          const delayMs = policy.getDelayMs(attemptsMade);
           log.warn(
-            `Retrying tunnel creation for ${udid} (attempt ${attempt}${maxAttempts === 0 ? ', unlimited' : `/${maxAttempts}`}) in ${this._disconnectRetryIntervalMs}ms...`,
+            `Retrying tunnel creation for ${udid} (attempt ${attemptsMade}${policy.maxAttempts === 0 ? ', unlimited' : `/${policy.maxAttempts}`}) in ${delayMs}ms...`,
           );
-          await sleep(this._disconnectRetryIntervalMs);
+          await sleep(delayMs);
 
           try {
             this._registryServer?.markTunnelPending(udid);
@@ -635,8 +641,7 @@ class TunnelCreator {
    */
   _isRetryEnabledForUdid(udid) {
     return (
-      (this._usbDevicesByUdid.has(udid) || this._appleTVDeviceIds.has(udid)) &&
-      this._disconnectRetryMaxAttempts !== null
+      (this._usbDevicesByUdid.has(udid) || this._appleTVDeviceIds.has(udid)) && this._disconnectRetryPolicy.isEnabled
     );
   }
 
@@ -800,6 +805,43 @@ function parseNonNegativeIntegerOption(value, label) {
   return count;
 }
 
+/**
+ * @param {string} value
+ * @returns {'fixed' | 'exponential'}
+ */
+function parseRetryStrategyOption(value) {
+  if (value !== 'fixed' && value !== 'exponential') {
+    throw new Error(`Invalid disconnect retry strategy: ${value}. Expected 'fixed' or 'exponential'.`);
+  }
+  return value;
+}
+
+/**
+ * @param {string} value
+ * @param {string} label
+ * @returns {number}
+ */
+function parseRetryBackoffMultiplierOption(value, label) {
+  const multiplier = Number.parseFloat(value);
+  if (!Number.isFinite(multiplier) || multiplier <= 1) {
+    throw new Error(`Invalid ${label}: ${value}. Expected a number greater than 1.`);
+  }
+  return multiplier;
+}
+
+/**
+ * @param {string} value
+ * @param {string} label
+ * @returns {number}
+ */
+function parseRetryBackoffJitterOption(value, label) {
+  const jitter = Number.parseFloat(value);
+  if (!Number.isFinite(jitter) || jitter < 0 || jitter > 1) {
+    throw new Error(`Invalid ${label}: ${value}. Expected a number between 0 and 1.`);
+  }
+  return jitter;
+}
+
 /**
  * @param {string} value
  * @param {string[]} previous
@@ -906,11 +948,38 @@ async function main() {
       'Max tunnel recreation attempts after unexpected disconnect: 0 = unlimited; omit to disable retries',
       (value) => parseNonNegativeIntegerOption(value, 'disconnect retry max attempts'),
     )
+    .option(
+      '--disconnect-retry-strategy <strategy>',
+      "Delay strategy between tunnel recreation attempts: 'fixed' or 'exponential'",
+      (value) => parseRetryStrategyOption(value),
+      'fixed',
+    )
     .option(
       '--disconnect-retry-interval-ms <ms>',
-      'Delay between tunnel recreation attempts in milliseconds (default 1000)',
+      'Delay between tunnel recreation attempts in milliseconds. ' +
+        'With --disconnect-retry-strategy exponential, this is the initial delay, before it starts growing',
       (value) => parsePositiveIntegerOption(value, 'disconnect retry interval'),
-      1000,
+      DEFAULT_DISCONNECT_RETRY_INTERVAL_MS,
+    )
+    .option(
+      '--disconnect-retry-backoff-multiplier <factor>',
+      'Factor the delay grows by on each attempt when --disconnect-retry-strategy is exponential (must be > 1)',
+      (value) => parseRetryBackoffMultiplierOption(value, 'disconnect retry backoff multiplier'),
+      DEFAULT_DISCONNECT_RETRY_BACKOFF_MULTIPLIER,
+    )
+    .option(
+      '--disconnect-retry-backoff-max-interval-ms <ms>',
+      'Upper bound on the delay between tunnel recreation attempts when --disconnect-retry-strategy is exponential',
+      (value) => parsePositiveIntegerOption(value, 'disconnect retry backoff max interval'),
+      DEFAULT_DISCONNECT_RETRY_BACKOFF_MAX_INTERVAL_MS,
+    )
+    .option(
+      '--disconnect-retry-backoff-jitter <factor>',
+      'Fraction of the delay to randomize away on each attempt when --disconnect-retry-strategy is exponential, ' +
+        'between 0 (no jitter) and 1 (full jitter). Spreads out devices that dropped together instead of having ' +
+        'them retry in lockstep',
+      (value) => parseRetryBackoffJitterOption(value, 'disconnect retry backoff jitter'),
+      DEFAULT_DISCONNECT_RETRY_BACKOFF_JITTER,
     );
 
   program.parse(process.argv);
@@ -922,6 +991,24 @@ async function main() {
   const shouldRunUsbFlow = !hasRequestedAppleTVIds || hasRequestedUdids;
   const shouldRunAppleTVFlow = !hasRequestedUdids || hasRequestedAppleTVIds;
 
+  /** @type {import('./lib/retry-policy.mjs').RetryPolicy} */
+  let disconnectRetryPolicy;
+  try {
+    disconnectRetryPolicy = createDisconnectRetryPolicy({
+      strategy: options.disconnectRetryStrategy,
+      maxAttempts: options.disconnectRetryMaxAttempts ?? null,
+      intervalMs: options.disconnectRetryIntervalMs,
+      backoffMultiplier: options.disconnectRetryBackoffMultiplier,
+      backoffMaxIntervalMs: options.disconnectRetryBackoffMaxIntervalMs,
+      jitter: options.disconnectRetryBackoffJitter,
+    });
+  } catch (err) {
+    // program.error() never returns (it exits the process); the throw below is unreachable and
+    // only here so TS can see disconnectRetryPolicy is always assigned past this point.
+    program.error(/** @type {Error} */ (err).message);
+    throw err;
+  }
+
   await assertRoot(path.parse(fileURLToPath(import.meta.url)).name);
 
   const tunnelCreator = new TunnelCreator({
@@ -953,10 +1040,7 @@ async function main() {
       });
     }
 
-    tunnelCreator.setDisconnectRetryPolicy(
-      options.disconnectRetryMaxAttempts ?? null,
-      options.disconnectRetryIntervalMs,
-    );
+    tunnelCreator.setDisconnectRetryPolicy(disconnectRetryPolicy);
 
     await tunnelCreator.startRegistryServer();