appium-xcuitest-driver 11.14.0 → 11.14.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [11.14.1](https://github.com/appium/appium-xcuitest-driver/compare/v11.14.0...v11.14.1) (2026-06-24)
+
+### Bug Fixes
+
+* Only assert root after arguments parsing is finished ([#2886](https://github.com/appium/appium-xcuitest-driver/issues/2886)) ([6d9f317](https://github.com/appium/appium-xcuitest-driver/commit/6d9f317e8864d7161404a15c8a841e1b95815f26))
+
 ## [11.14.0](https://github.com/appium/appium-xcuitest-driver/compare/v11.13.0...v11.14.0) (2026-06-23)
 
 ### Features

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "appium-xcuitest-driver",
-  "version": "11.14.0",
+  "version": "11.14.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-xcuitest-driver",
-      "version": "11.14.0",
+      "version": "11.14.1",
       "license": "Apache-2.0",
       "dependencies": {
         "@appium/css-locator-to-native": "^1.0.1",
@@ -549,9 +549,9 @@
       }
     },
     "node_modules/appium-ios-remotexpc": {
-      "version": "5.2.0",
-      "resolved": "https://registry.npmjs.org/appium-ios-remotexpc/-/appium-ios-remotexpc-5.2.0.tgz",
-      "integrity": "sha512-6E1hkewEeGvurAUnfRNm8e0ten2bA0y7uqdyp6MyL+Oz9Ts+Ym4MBfbzF8qIqL5aO01AiBfOEmR/SonhWkirTQ==",
+      "version": "5.2.2",
+      "resolved": "https://registry.npmjs.org/appium-ios-remotexpc/-/appium-ios-remotexpc-5.2.2.tgz",
+      "integrity": "sha512-WSAL/BCzD380vk28g2Ec7EFmiRmqvSn76Nx5nWVipuwGD+9M0gTrqWXi9T7yc4DbJYNYA9ZQN1uSzDMHiINHWA==",
       "license": "Apache-2.0",
       "optional": true,
       "dependencies": {

package/package.json

@@ -8,7 +8,7 @@
     "xcuitest",
     "xctest"
   ],
-  "version": "11.14.0",
+  "version": "11.14.1",
   "author": "Appium Contributors",
   "license": "Apache-2.0",
   "repository": {

package/scripts/lib/root.mjs

@@ -1,15 +1,37 @@
+import { exec } from 'teen_process';
+
+const COMMAND_PREFIX = 'appium driver run xcuitest';
+
 /**
- * Ensures a driver helper script is run with elevated privileges on platforms that expose getuid.
+ * Ensures a helper script is run with elevated privileges.
  *
  * @param {string} scriptName
  */
-export function assertRoot(scriptName) {
+export async function assertRoot(scriptName) {
+  if (process.platform === 'win32') {
+    await assertWindowsAdmin(scriptName);
+    return;
+  }
+
   if (typeof process.getuid !== 'function') {
     return;
   }
   if (process.getuid() !== 0) {
     throw new Error(
-      `This script must be run as root (e.g. sudo appium driver run xcuitest ${scriptName} ...).`,
+      `This script must be run as root/admin (e.g. sudo ${COMMAND_PREFIX} "${scriptName}").`
+    );
+  }
+}
+
+/**
+ * @param {string} scriptName
+ */
+async function assertWindowsAdmin(scriptName) {
+  try {
+    await exec('net', ['session']);
+  } catch {
+    throw new Error(
+      `This script must be run as Administrator (e.g. from an elevated terminal: ${COMMAND_PREFIX} "${scriptName}").`,
     );
   }
 }

package/scripts/pair-appletv.mjs

@@ -23,7 +23,8 @@
 import {logger} from 'appium/support.js';
 import {Command} from 'commander';
 import {AppleTVPairingService, UserInputService} from 'appium-ios-remotexpc';
-
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
 import {parsePositiveIntegerOption} from './lib/options.mjs';
 import {startTimeoutProgressLogger} from './lib/progress.mjs';
 import {assertRoot} from './lib/root.mjs';
@@ -35,7 +36,6 @@ const DEFAULT_APPLETV_PAIRING_DISCOVERY_TIMEOUT_MS =
 const APPLETV_PAIRING_DISCOVERY_PROGRESS_BAR_WIDTH = 24;
 
 async function main() {
-  assertRoot('pair-appletv');
   const program = new Command();
   program
     .name('appium driver run xcuitest pair-appletv')
@@ -54,6 +54,8 @@ async function main() {
   program.parse(process.argv);
   const options = program.opts();
 
+  await assertRoot(path.parse(fileURLToPath(import.meta.url)).name);
+
   const userInput = new UserInputService();
   const pairingService = new AppleTVPairingService(userInput);
 

package/scripts/tunnel-creation.mjs

@@ -6,6 +6,8 @@
  * Must be run as root (e.g. sudo appium driver run xcuitest tunnel-creation).
  */
 import {logger} from 'appium/support.js';
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
 
 import {
   AppleTVTunnelService,
@@ -886,7 +888,6 @@ function setupCleanupHandlers(tunnelCreator) {
 }
 
 async function main() {
-  assertRoot('tunnel-creation');
   const program = new Command();
   program
     .name('appium driver run xcuitest tunnel-creation')
@@ -937,6 +938,8 @@ async function main() {
   const shouldRunUsbFlow = !hasRequestedAppleTVIds || hasRequestedUdids;
   const shouldRunAppleTVFlow = !hasRequestedUdids || hasRequestedAppleTVIds;
 
+  await assertRoot(path.parse(fileURLToPath(import.meta.url)).name);
+
   const tunnelCreator = new TunnelCreator({
     appleTVDiscoveryTimeoutMs: options.appletvDiscoveryTimeoutMs,
   });