appium-xcuitest-driver 10.14.12 → 10.14.13

package/lib/device/real-device-management.ts

@@ -565,10 +565,11 @@ export class RealDevice {
   }
 
   /**
-   * @param bundleName The name of CFBundleName in Info.plist
+   * ! This method is used by appium-webdriveragent package
    *
+   * @param bundleName The name of CFBundleName in Info.plist
    * @returns A list of User level apps' bundle ids which has
-   *                          'CFBundleName' attribute as 'bundleName'.
+   * 'CFBundleName' attribute as 'bundleName'.
    */
   async getUserInstalledBundleIdsByBundleName(bundleName: string): Promise<string[]> {
     const service = await services.startInstallationProxyService(this.udid);

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "appium-xcuitest-driver",
-  "version": "10.14.12",
+  "version": "10.14.13",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-xcuitest-driver",
-      "version": "10.14.12",
+      "version": "10.14.13",
       "license": "Apache-2.0",
       "dependencies": {
         "@appium/strongbox": "^1.0.0-rc.1",
@@ -692,9 +692,9 @@
       }
     },
     "node_modules/appium-ios-remotexpc": {
-      "version": "0.25.1",
-      "resolved": "https://registry.npmjs.org/appium-ios-remotexpc/-/appium-ios-remotexpc-0.25.1.tgz",
-      "integrity": "sha512-wlCe1593QZYC72LOyyrdawKu4ZXhuDnOLyLiexmtKcbtG8liyHMq7o6QWsEUsQKZSW3O2gke3lR2Ooln89UmDQ==",
+      "version": "0.25.2",
+      "resolved": "https://registry.npmjs.org/appium-ios-remotexpc/-/appium-ios-remotexpc-0.25.2.tgz",
+      "integrity": "sha512-mRMVjorxf70Q8qsDxoF8O5tDQ5N0hBYELQ6dUDnIUNI8YljcT1/SzlBnGLLfgZYuTK6ImyJhw/jifMJKjHEkrw==",
       "license": "Apache-2.0",
       "optional": true,
       "dependencies": {

package/package.json

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

package/scripts/build-wda.mjs

@@ -10,6 +10,13 @@ const log = logger.getLogger('WDA');
 async function build() {
   const customDevice = parseArgValue('name');
   const platformVersion = parseArgValue('sdk') || (await xcode.getMaxIOSSDK());
+
+  if (!platformVersion) {
+    throw new Error(
+      'Cannot determine iOS SDK version to build for. Please specify --sdk=<version> or ensure Xcode and its command-line tools are installed (try `xcodebuild -showsdks` or `xcode-select --print-path`).'
+    );
+  }
+
   const iosDevices = await new Simctl().getDevices(platformVersion, 'iOS');
   const verifyDevicePresence = (info) => {
     if (!info) {

package/scripts/download-wda-sim.mjs

@@ -14,11 +14,15 @@ const destZip = (platform) => {
 
 /**
  * Return installed appium-webdriveragent package version
- * @returns {number}
+ * @returns {Promise<number>}
  */
 async function webdriveragentPkgVersion() {
+  const moduleRoot = node.getModuleRootSync('appium-xcuitest-driver', import.meta.url);
+  if (!moduleRoot) {
+    throw new Error('Cannot resolve module root for appium-xcuitest-driver');
+  }
   const pkgPath = path.join(
-    node.getModuleRootSync('appium-xcuitest-driver', import.meta.url),
+    moduleRoot,
     'node_modules',
     'appium-webdriveragent',
     'package.json'
@@ -28,7 +32,7 @@ async function webdriveragentPkgVersion() {
 
 /**
  * Prepare the working root directory.
- * @returns {string} Root directory to download and unzip.
+ * @returns {Promise<string>} Root directory to download and unzip.
  */
 async function prepareRootDir() {
   const destDirRoot = parseArgValue('outdir');

package/scripts/tunnel-creation.mjs

@@ -52,7 +52,7 @@ class TunnelCreator {
 
   /**
    * Update tunnel registry with new tunnel information
-   * @type {import('appium-ios-remotexpc').TunnelResult[]} results - Array of tunnel results
+   * @param {import('appium-ios-remotexpc').TunnelResult[]} results - Array of tunnel results
    * @returns {Promise<import('appium-ios-remotexpc').TunnelRegistry>} Updated tunnel registry
    */
   async updateTunnelRegistry(results) {
@@ -141,11 +141,12 @@ class TunnelCreator {
 
   /**
    * Create tunnel for a single device
-   * @param {Device} device - Device object
+   * @param {import('appium-ios-remotexpc').UsbmuxDevice} device - Device object
    * @param {import('tls').ConnectionOptions} tlsOptions - TLS options
    * @returns {Promise<import('appium-ios-remotexpc').TunnelResult & { socket?: any; socketInfo?: import('appium-ios-remotexpc').SocketInfo }>} Tunnel result
    */
   async createTunnelForDevice(device, tlsOptions) {
+
     const udid = device.Properties.SerialNumber;
 
     log.info(`\n--- Processing device: ${udid} ---`);
@@ -330,6 +331,10 @@ async function main() {
     tunnelCreator.tunnelRegistryPort = parseInt(tunnelRegistryPort, 10);
   }
 
+  if (!BOOTSTRAP_PATH) {
+    throw new Error(`BOOTSTRAP_PATH is null`);
+  }
+
   const packageInfo = JSON.parse(
     fs.readFileSync(path.join(BOOTSTRAP_PATH, 'package.json'), 'utf8'),
   );

package/scripts/build-docs.js

@@ -1,56 +0,0 @@
-// for simplicity this file is not transpiled and is run directly via an npm script
-/* eslint-disable promise/prefer-await-to-callbacks */
-/* eslint-disable promise/prefer-await-to-then */
-
-const {deploy} = require('@appium/docutils');
-const {logger} = require('appium/support');
-const path = require('path');
-const semver = require('semver');
-const {version} = require('../package.json');
-
-const log = logger.getLogger('Docs');
-
-const DOCS_REMOTE = 'origin';
-const DOCS_BRANCH = 'docs-site';
-const DOCS_PREFIX = false;
-const REPO_DIR = path.resolve(__dirname, '..');
-const LATEST_ALIAS = 'latest';
-
-const packageJson = require.resolve('../package.json');
-
-const branch = process.env.APPIUM_DOCS_BRANCH ?? DOCS_BRANCH;
-const deployPrefix = process.env.APPIUM_DOCS_PREFIX ?? DOCS_PREFIX;
-const remote = process.env.APPIUM_DOCS_REMOTE ?? DOCS_REMOTE;
-
-const push = Boolean(process.env.APPIUM_DOCS_PUBLISH);
-
-async function main() {
-  log.info(`Building XCUI docs and committing to ${DOCS_BRANCH}`);
-  const {major, minor} = semver.parse(version);
-  const deployVersion = `${major}.${minor}`;
-
-  const mkdocsYml = path.join(REPO_DIR, 'mkdocs.yml');
-
-  log.info(`Building docs for version ${deployVersion}`);
-  await deploy({
-    mkDocsYml: mkdocsYml,
-    push,
-    branch,
-    deployPrefix,
-    remote,
-    packageJson,
-    deployVersion,
-    message: `docs: auto-build docs for appium-xcuitest-driver@${deployVersion}`,
-    alias: LATEST_ALIAS,
-  });
-  log.info(`Docs built`);
-}
-
-if (require.main === module) {
-  main().catch((err) => {
-    console.error(err); // eslint-disable-line no-console
-    process.exitCode = 1;
-  });
-}
-
-module.exports = main;