appium-webdriveragent 15.1.6 → 16.0.1

package/lib/check-dependencies.ts

@@ -1,9 +1,11 @@
+import path from 'node:path';
+
 import {fs} from '@appium/support';
 import {exec} from 'teen_process';
-import path from 'node:path';
-import {WDA_SCHEME, SDK_SIMULATOR, WDA_RUNNER_APP} from './constants';
-import {BOOTSTRAP_PATH} from './utils';
-import type {XcodeBuild} from './xcodebuild';
+
+import {WDA_SCHEME, SDK_SIMULATOR, WDA_RUNNER_APP} from './constants.js';
+import {BOOTSTRAP_PATH} from './utils/index.js';
+import type {XcodeBuild} from './xcodebuild.js';
 
 /**
  * Ensure simulator WDA is built and return the resulting app bundle path.
@@ -13,13 +15,7 @@ export async function bundleWDASim(xcodebuild: XcodeBuild): Promise<string> {
   if (!derivedDataPath) {
     throw new Error('Cannot retrieve the path to the Xcode derived data folder');
   }
-  const wdaBundlePath = path.join(
-    derivedDataPath,
-    'Build',
-    'Products',
-    'Debug-iphonesimulator',
-    WDA_RUNNER_APP,
-  );
+  const wdaBundlePath = path.join(derivedDataPath, 'Build', 'Products', 'Debug-iphonesimulator', WDA_RUNNER_APP);
   if (await fs.exists(wdaBundlePath)) {
     return wdaBundlePath;
   }

package/lib/index.ts

@@ -1,7 +1,7 @@
-export {bundleWDASim} from './check-dependencies';
-export {NoSessionProxy} from './no-session-proxy';
-export {WebDriverAgent} from './webdriveragent';
-export {WDA_BASE_URL, WDA_RUNNER_APP, WDA_RUNNER_BUNDLE_ID, PROJECT_FILE} from './constants';
-export {resetTestProcesses, BOOTSTRAP_PATH} from './utils';
+export {bundleWDASim} from './check-dependencies.js';
+export {NoSessionProxy} from './no-session-proxy.js';
+export {WebDriverAgent} from './webdriveragent.js';
+export {WDA_BASE_URL, WDA_RUNNER_APP, WDA_RUNNER_BUNDLE_ID, PROJECT_FILE} from './constants.js';
+export {resetTestProcesses, BOOTSTRAP_PATH} from './utils/index.js';
 
-export * from './types';
+export * from './types.js';

package/lib/types.ts

@@ -23,8 +23,7 @@ export interface WDASettings {
   defaultAlertAction?: 'accept' | 'dismiss';
   acceptAlertButtonSelector?: string;
   dismissAlertButtonSelector?: string;
-  screenshotOrientation?:
-    'auto' | 'portrait' | 'portraitUpsideDown' | 'landscapeRight' | 'landscapeLeft';
+  screenshotOrientation?: 'auto' | 'portrait' | 'portraitUpsideDown' | 'landscapeRight' | 'landscapeLeft';
   waitForIdleTimeout?: number;
   animationCoolOffTimeout?: number;
   maxTypingFrequency?: number;
@@ -100,7 +99,10 @@ export interface AppleDevice {
 }
 
 export type WdaStartupStrategyName =
-  'existing-url' | 'simulator' | 'real-device-xcodebuild' | 'real-device-preinstalled';
+  | 'existing-url'
+  | 'simulator'
+  | 'real-device-xcodebuild'
+  | 'real-device-preinstalled';
 
 export type WdaLaunchEnvironment = Record<string, string | number>;
 

package/lib/utils/index.ts

@@ -1,16 +1,11 @@
-import {getWDAUpgradeTimestamp as getWDAUpgradeTimestampImpl} from './module';
+import {getWDAUpgradeTimestamp as getWDAUpgradeTimestampImpl} from './module.js';
 
-export {BOOTSTRAP_PATH} from './module';
-export {isTvOS} from './platform';
-export {getPIDsListeningOnPort, killAppUsingPattern, resetTestProcesses} from './processes';
-export {setRealDeviceSecurity} from './security';
-export {
-  getAdditionalRunContent,
-  getXctestrunFileName,
-  getXctestrunFilePath,
-  setXctestrunFile,
-} from './xctestrun';
-export type {XctestrunFileArgs} from './xctestrun';
+export {BOOTSTRAP_PATH} from './module.js';
+export {isTvOS} from './platform.js';
+export {getPIDsListeningOnPort, killAppUsingPattern, resetTestProcesses} from './processes.js';
+export {setRealDeviceSecurity} from './security.js';
+export {getAdditionalRunContent, getXctestrunFileName, getXctestrunFilePath, setXctestrunFile} from './xctestrun.js';
+export type {XctestrunFileArgs} from './xctestrun.js';
 
 /**
  * Retrieves WDA upgrade timestamp. The manifest only gets modified on package upgrade.

package/lib/utils/module.ts

@@ -1,14 +1,9 @@
-import {fs, node as supportNode} from '@appium/support';
 import path from 'node:path';
 import {fileURLToPath} from 'node:url';
 
-// Get current filename - works in both CommonJS and ESM
-const currentFilename =
-  typeof __filename !== 'undefined'
-    ? __filename
-    : fileURLToPath(new Function('return import.meta.url')());
+import {fs, node as supportNode} from '@appium/support';
 
-const moduleRoot = supportNode.getModuleRootSync('appium-webdriveragent', currentFilename);
+const moduleRoot = supportNode.getModuleRootSync('appium-webdriveragent', fileURLToPath(import.meta.url));
 
 if (!moduleRoot) {
   throw new Error('Cannot find the root folder of the appium-webdriveragent Node.js module');

package/lib/utils/platform.ts

@@ -1,4 +1,4 @@
-import {PLATFORM_NAME_TVOS} from '../constants';
+import {PLATFORM_NAME_TVOS} from '../constants.js';
 
 /**
  * Return true if the platformName is tvOS

package/lib/utils/processes.ts

@@ -1,6 +1,7 @@
 import {waitForCondition} from 'asyncbox';
 import {exec} from 'teen_process';
-import {log} from '../logger';
+
+import {log} from '../logger.js';
 
 /**
  * Find and terminate all processes matching the given pgrep pattern.
@@ -127,9 +128,7 @@ async function getPIDsUsingPattern(pattern: string): Promise<string[]> {
       .filter(Number.isInteger)
       .map((x) => `${x}`);
   } catch (err: any) {
-    log.debug(
-      `'pgrep ${args.join(' ')}' didn't detect any matching processes. Return code: ${err.code}`,
-    );
+    log.debug(`'pgrep ${args.join(' ')}' didn't detect any matching processes. Return code: ${err.code}`);
     return [];
   }
 }

package/lib/utils/security.ts

@@ -1,13 +1,11 @@
 import {exec} from 'teen_process';
-import {log} from '../logger';
+
+import {log} from '../logger.js';
 
 /**
  * Configure keychain access required for real-device code signing.
  */
-export async function setRealDeviceSecurity(
-  keychainPath: string,
-  keychainPassword: string,
-): Promise<void> {
+export async function setRealDeviceSecurity(keychainPath: string, keychainPassword: string): Promise<void> {
   log.debug('Setting security for iOS device');
   await exec('security', ['-v', 'list-keychains', '-s', keychainPath]);
   await exec('security', ['-v', 'unlock-keychain', '-p', keychainPassword, keychainPath]);

package/lib/utils/xctestrun.ts

@@ -1,9 +1,11 @@
-import {fs, plist, util} from '@appium/support';
-import path from 'node:path';
 import {arch} from 'node:os';
-import {log} from '../logger';
-import type {DeviceInfo} from '../types';
-import {isTvOS} from './platform';
+import path from 'node:path';
+
+import {fs, plist, util} from '@appium/support';
+
+import {log} from '../logger.js';
+import type {DeviceInfo} from '../types.js';
+import {isTvOS} from './platform.js';
 
 /**
  * Arguments for setting xctestrun file
@@ -32,14 +34,7 @@ export interface XctestrunFileArgs {
  * then it will throw a file not found exception
  */
 export async function setXctestrunFile(args: XctestrunFileArgs): Promise<string> {
-  const {
-    deviceInfo,
-    sdkVersion,
-    bootstrapPath,
-    wdaRemotePort,
-    wdaBindingIP,
-    maxHttpRequestBodySize,
-  } = args;
+  const {deviceInfo, sdkVersion, bootstrapPath, wdaRemotePort, wdaBindingIP, maxHttpRequestBodySize} = args;
   const xctestrunFilePath = await getXctestrunFilePath(deviceInfo, sdkVersion, bootstrapPath);
   const xctestRunContent = await plist.parsePlistFile(xctestrunFilePath);
   const updateWDAPort = getAdditionalRunContent(
@@ -75,9 +70,7 @@ export function getAdditionalRunContent(
         // USE_PORT must be 'string'
         USE_PORT: `${wdaRemotePort}`,
         ...(wdaBindingIP ? {USE_IP: wdaBindingIP} : {}),
-        ...(maxHttpRequestBodySize
-          ? {MAX_HTTP_REQUEST_BODY_SIZE: `${maxHttpRequestBodySize}`}
-          : {}),
+        ...(maxHttpRequestBodySize ? {MAX_HTTP_REQUEST_BODY_SIZE: `${maxHttpRequestBodySize}`} : {}),
       },
     },
   };
@@ -110,10 +103,7 @@ export async function getXctestrunFilePath(
       log.info(`Using '${filePath}' as xctestrun file`);
       return filePath;
     }
-    const originalXctestrunFile = path.resolve(
-      bootstrapPath,
-      getXctestrunFileName(deviceInfo, version),
-    );
+    const originalXctestrunFile = path.resolve(bootstrapPath, getXctestrunFileName(deviceInfo, version));
     if (await fs.exists(originalXctestrunFile)) {
       // If this is first time run for given device, then first generate xctestrun file for device.
       // We need to have a xctestrun file **per device** because we cannot have same wda port for all devices.
@@ -143,10 +133,7 @@ export function getXctestrunFileName(deviceInfo: DeviceInfo, version: string): s
   return `WebDriverAgentRunner_${isTvOS(deviceInfo.platformName) ? 'tvOS_appletv' : 'iphone'}${archSuffix}.xctestrun`;
 }
 
-function mergeObjects<T extends Record<string, any>, U extends Record<string, any>>(
-  target: T,
-  source: U,
-): T & U {
+function mergeObjects<T extends Record<string, any>, U extends Record<string, any>>(target: T, source: U): T & U {
   const output: Record<string, any> = {...target};
   for (const [key, sourceValue] of Object.entries(source)) {
     const targetValue = output[key];

package/lib/wda-strategies.ts

@@ -1,9 +1,8 @@
-import {exec} from 'teen_process';
 import {fs} from '@appium/support';
 import type {AppiumLogger, StringRecord} from '@appium/types';
-import {getPIDsListeningOnPort, resetTestProcesses} from './utils';
-import type {NoSessionProxy} from './no-session-proxy';
-import type {XcodeBuild} from './xcodebuild';
+import {exec} from 'teen_process';
+
+import type {NoSessionProxy} from './no-session-proxy.js';
 import type {
   AppleDevice,
   RealDevicePreinstalledHostOps,
@@ -12,11 +11,12 @@ import type {
   WdaHostOps,
   WdaLaunchEnvironment,
   WdaStartupStrategyName,
-} from './types';
+} from './types.js';
+import {getPIDsListeningOnPort, resetTestProcesses} from './utils/index.js';
+import type {XcodeBuild} from './xcodebuild.js';
 
 const WDA_AGENT_PORT = 8100;
-const HOST_OPS_REQUIRED_MESSAGE =
-  'Host operations must be provided to launch or terminate preinstalled WebDriverAgent';
+const HOST_OPS_REQUIRED_MESSAGE = 'Host operations must be provided to launch or terminate preinstalled WebDriverAgent';
 
 export interface WdaStartupStrategy {
   readonly name: WdaStartupStrategyName;
@@ -220,9 +220,7 @@ export function createDefaultRealDeviceXcodebuildHostOps(): RealDeviceXcodebuild
     async cleanupObsoleteProcesses({udid, port, commandLineIncludes}) {
       const obsoletePids = await getPIDsListeningOnPort(
         port,
-        (cmdLine) =>
-          cmdLine.includes(commandLineIncludes) &&
-          !cmdLine.toLowerCase().includes(udid.toLowerCase()),
+        (cmdLine) => cmdLine.includes(commandLineIncludes) && !cmdLine.toLowerCase().includes(udid.toLowerCase()),
       );
 
       if (obsoletePids.length > 0) {
@@ -232,18 +230,13 @@ export function createDefaultRealDeviceXcodebuildHostOps(): RealDeviceXcodebuild
   };
 }
 
-async function launchWithXcodebuild(
-  ctx: WdaStartupStrategyContext,
-  sessionId: string,
-): Promise<StringRecord | null> {
+async function launchWithXcodebuild(ctx: WdaStartupStrategyContext, sessionId: string): Promise<StringRecord | null> {
   ctx.log.info('Launching WebDriverAgent on the device');
 
   ctx.setupProxies(sessionId);
 
   if (!ctx.useXctestrunFile && !(await fs.exists(ctx.agentPath))) {
-    throw new Error(
-      `Trying to use WebDriverAgent project at '${ctx.agentPath}' but the ` + 'file does not exist',
-    );
+    throw new Error(`Trying to use WebDriverAgent project at '${ctx.agentPath}' but the file does not exist`);
   }
 
   if (ctx.useXctestrunFile || ctx.usePrebuiltWDA) {

package/lib/webdriveragent.ts

@@ -1,33 +1,35 @@
-import {waitForCondition} from 'asyncbox';
 import path from 'node:path';
+
 import {JWProxy} from '@appium/base-driver';
+import {strongbox} from '@appium/strongbox';
 import {fs, util} from '@appium/support';
 import type {AppiumLogger, StringRecord} from '@appium/types';
-import {log as defaultLogger} from './logger';
-import {NoSessionProxy} from './no-session-proxy';
-import {BOOTSTRAP_PATH, getWDAUpgradeTimestamp} from './utils';
-import {XcodeBuild} from './xcodebuild';
 import AsyncLock from 'async-lock';
+import {waitForCondition} from 'asyncbox';
+
 import {
   WDA_RUNNER_BUNDLE_ID,
   WDA_BASE_URL,
   WDA_UPGRADE_TIMESTAMP_PATH,
   DEFAULT_TEST_BUNDLE_SUFFIX,
-} from './constants';
-import {strongbox} from '@appium/strongbox';
+} from './constants.js';
+import {log as defaultLogger} from './logger.js';
+import {NoSessionProxy} from './no-session-proxy.js';
 import type {
   WebDriverAgentArgs,
   AppleDevice,
   XcodeBuildSettings,
   RetrieveBuildSettingsOptions,
   WdaHostOps,
-} from './types';
+} from './types.js';
+import {BOOTSTRAP_PATH, getWDAUpgradeTimestamp} from './utils/index.js';
 import {
   createDefaultWdaHostOps,
   createWdaStartupStrategy,
   type WdaStartupStrategy,
   type WdaStartupStrategyContext,
-} from './wda-strategies';
+} from './wda-strategies.js';
+import {XcodeBuild} from './xcodebuild.js';
 
 const WDA_LAUNCH_TIMEOUT = 60 * 1000;
 const WDA_AGENT_PORT = 8100;
@@ -89,8 +91,7 @@ export class WebDriverAgent {
     this.setWDAPaths(args.bootstrapPath, args.agentPath);
 
     this.wdaLocalPort = args.wdaLocalPort;
-    this.wdaRemotePort =
-      ((this.isRealDevice ? args.wdaRemotePort : null) ?? args.wdaLocalPort) || WDA_AGENT_PORT;
+    this.wdaRemotePort = ((this.isRealDevice ? args.wdaRemotePort : null) ?? args.wdaLocalPort) || WDA_AGENT_PORT;
     this.wdaBaseUrl = args.wdaBaseUrl || WDA_BASE_URL;
     this.wdaBindingIP = args.wdaBindingIP;
     this.prebuildWDA = args.prebuildWDA;
@@ -223,9 +224,7 @@ export class WebDriverAgent {
       } else {
         const port = this.wdaLocalPort || WDA_AGENT_PORT;
         const parsedBaseUrl = this.toUrl(this.wdaBaseUrl || WDA_BASE_URL);
-        this._url = new URL(
-          `${parsedBaseUrl.protocol}//${this.wdaBindingIP || parsedBaseUrl.hostname}:${port}`,
-        );
+        this._url = new URL(`${parsedBaseUrl.protocol}//${this.wdaBindingIP || parsedBaseUrl.hostname}:${port}`);
       }
     }
     return this._url;
@@ -308,8 +307,8 @@ export class WebDriverAgent {
    * @returns `true` if source is fresh (all required files exist), `false` otherwise
    */
   async isSourceFresh(): Promise<boolean> {
-    const existsPromises = ['Resources', path.join('Resources', 'WebDriverAgent.bundle')].map(
-      (subPath) => fs.exists(path.resolve(this.bootstrapPath, subPath)),
+    const existsPromises = ['Resources', path.join('Resources', 'WebDriverAgent.bundle')].map((subPath) =>
+      fs.exists(path.resolve(this.bootstrapPath, subPath)),
     );
     return (await Promise.all(existsPromises)).every((v) => v === true);
   }
@@ -340,26 +339,13 @@ export class WebDriverAgent {
    * @param options - Optional scheme, SDK, configuration, or destination
    * @returns Build settings, or `undefined` if xcodebuild is skipped or settings cannot be determined
    */
-  async retrieveBuildSettings(
-    options?: RetrieveBuildSettingsOptions,
-  ): Promise<XcodeBuildSettings | undefined> {
+  async retrieveBuildSettings(options?: RetrieveBuildSettingsOptions): Promise<XcodeBuildSettings | undefined> {
     if (this.canSkipXcodebuild) {
       return;
     }
     return await this.xcodebuild.retrieveBuildSettings(options);
   }
 
-  /**
-   * @deprecated Use {@link retrieveBuildSettings} instead. Will be removed in a future release.
-   * @returns The derived data path, or `undefined` if xcodebuild is skipped
-   */
-  async retrieveDerivedDataPath(): Promise<string | undefined> {
-    if (this.canSkipXcodebuild) {
-      return;
-    }
-    return await this.xcodebuild.retrieveDerivedDataPath();
-  }
-
   /**
    * Reuse running WDA if it has the same bundle id with updatedWDABundleId.
    * Or reuse it if it has the default id without updatedWDABundleId.
@@ -456,10 +442,7 @@ export class WebDriverAgent {
       getStatus: async (timeoutMs) => await this.getStatus(timeoutMs),
       cleanupProjectIfFresh: async () => {
         const synchronizationKey = path.normalize(this.bootstrapPath);
-        await SHARED_RESOURCES_GUARD.acquire(
-          synchronizationKey,
-          async () => await this._cleanupProjectIfFresh(),
-        );
+        await SHARED_RESOURCES_GUARD.acquire(synchronizationKey, async () => await this._cleanupProjectIfFresh());
       },
       xcodebuild: () => this.xcodebuild,
       noSessionProxy: () => {
@@ -551,16 +534,13 @@ export class WebDriverAgent {
       headers: this.args.extraRequestHeaders,
     });
 
-    const sendGetStatus = async () =>
-      (await noSessionProxy.command('/status', 'GET')) as StringRecord;
+    const sendGetStatus = async () => (await noSessionProxy.command('/status', 'GET')) as StringRecord;
 
     if (timeoutMs == null || timeoutMs <= 0) {
       try {
         return await sendGetStatus();
       } catch (err: any) {
-        this.log.debug(
-          `WDA is not listening at '${this.url.href}'. Original error:: ${err.message}`,
-        );
+        this.log.debug(`WDA is not listening at '${this.url.href}'. Original error:: ${err.message}`);
         return null;
       }
     }
@@ -598,9 +578,7 @@ export class WebDriverAgent {
       return;
     }
 
-    const packageInfo = JSON.parse(
-      await fs.readFile(path.join(BOOTSTRAP_PATH, 'package.json'), 'utf8'),
-    );
+    const packageInfo = JSON.parse(await fs.readFile(path.join(BOOTSTRAP_PATH, 'package.json'), 'utf8'));
     const box = strongbox(packageInfo.name);
     let boxItem = box.getItem(RECENT_MODULE_VERSION_ITEM_NAME);
     if (!boxItem) {
@@ -616,9 +594,7 @@ export class WebDriverAgent {
           return;
         }
       } else {
-        this.log.info(
-          'There is no need to perform the project cleanup. A fresh install has been detected',
-        );
+        this.log.info('There is no need to perform the project cleanup. A fresh install has been detected');
         try {
           await box.createItemWithValue(RECENT_MODULE_VERSION_ITEM_NAME, packageInfo.version);
         } catch (e: any) {
@@ -633,9 +609,7 @@ export class WebDriverAgent {
       recentModuleVersion = util.coerceVersion(recentModuleVersion, true);
     } catch (e: any) {
       this.log.warn(`The persisted module version string has been damaged: ${e.message}`);
-      this.log.info(
-        `Updating it to '${packageInfo.version}' assuming the project clenup is not needed`,
-      );
+      this.log.info(`Updating it to '${packageInfo.version}' assuming the project clenup is not needed`);
       await boxItem.write(packageInfo.version);
       return;
     }

package/lib/xcodebuild.ts

@@ -1,19 +1,21 @@
-import {retryInterval} from 'asyncbox';
-import {SubProcess, exec} from 'teen_process';
+import path from 'node:path';
+
 import {logger, timing, util} from '@appium/support';
 import type {AppiumLogger, StringRecord} from '@appium/types';
-import {log as defaultLogger} from './logger';
-import {getWDAUpgradeTimestamp, isTvOS, setRealDeviceSecurity, setXctestrunFile} from './utils';
-import path from 'node:path';
-import {WDA_RUNNER_BUNDLE_ID} from './constants';
+import {retryInterval} from 'asyncbox';
+import {SubProcess, exec} from 'teen_process';
+
+import {WDA_RUNNER_BUNDLE_ID} from './constants.js';
+import {log as defaultLogger} from './logger.js';
+import type {NoSessionProxy} from './no-session-proxy.js';
 import type {
   AppleDevice,
   RetrieveBuildSettingsOptions,
   XcodeBuildArgs,
   XcodeBuildSettings,
   XcodeShowBuildSettingsEntry,
-} from './types';
-import type {NoSessionProxy} from './no-session-proxy';
+} from './types.js';
+import {getWDAUpgradeTimestamp, isTvOS, setRealDeviceSecurity, setXctestrunFile} from './utils/index.js';
 
 const DEFAULT_SIGNING_ID = 'iPhone Developer';
 const PREBUILD_DELAY = 0;
@@ -22,11 +24,7 @@ const LIB_SCHEME_IOS = 'WebDriverAgentLib';
 
 const ERROR_WRITING_ATTACHMENT = 'Error writing attachment data to file';
 const ERROR_COPYING_ATTACHMENT = 'Error copying testing attachment';
-const IGNORED_ERRORS = [
-  ERROR_WRITING_ATTACHMENT,
-  ERROR_COPYING_ATTACHMENT,
-  'Failed to remove screenshot at path',
-];
+const IGNORED_ERRORS = [ERROR_WRITING_ATTACHMENT, ERROR_COPYING_ATTACHMENT, 'Failed to remove screenshot at path'];
 const IGNORED_ERRORS_PATTERN = new RegExp(
   '(' + IGNORED_ERRORS.map((errStr) => util.escapeRegExp(errStr)).join('|') + ')',
 );
@@ -71,10 +69,7 @@ export class XcodeBuild {
   private readonly resultBundleVersion?: string;
   private _didBuildFail: boolean;
   private _didProcessExit: boolean;
-  private readonly _buildSettingsPromises = new Map<
-    string,
-    Promise<XcodeBuildSettings | undefined>
-  >();
+  private readonly _buildSettingsPromises = new Map<string, Promise<XcodeBuildSettings | undefined>>();
   private noSessionProxy?: NoSessionProxy;
   private xctestrunFilePath?: string;
 
@@ -121,8 +116,7 @@ export class XcodeBuild {
     this.mjpegServerPort = args.mjpegServerPort;
     this.maxHttpRequestBodySize = args.maxHttpRequestBodySize;
 
-    this.prebuildDelay =
-      typeof args.prebuildDelay === 'number' ? args.prebuildDelay : PREBUILD_DELAY;
+    this.prebuildDelay = typeof args.prebuildDelay === 'number' ? args.prebuildDelay : PREBUILD_DELAY;
 
     this.allowProvisioningDeviceRegistration = args.allowProvisioningDeviceRegistration;
 
@@ -165,9 +159,7 @@ export class XcodeBuild {
    * @param options - Optional scheme, SDK, configuration, or destination
    * @returns Build settings for the `build` action, or `undefined` if they cannot be determined
    */
-  async retrieveBuildSettings(
-    options?: RetrieveBuildSettingsOptions,
-  ): Promise<XcodeBuildSettings | undefined> {
+  async retrieveBuildSettings(options?: RetrieveBuildSettingsOptions): Promise<XcodeBuildSettings | undefined> {
     const cacheKey = buildSettingsCacheKey(options);
     let promise = this._buildSettingsPromises.get(cacheKey);
     if (!promise) {
@@ -314,9 +306,7 @@ export class XcodeBuild {
       if (!(err as Error)?.message?.includes(`Process didn't end after`)) {
         throw err;
       }
-      this.log.debug(
-        `xcodebuild process did not end in a timely fashion: '${(err as Error)?.message}'.`,
-      );
+      this.log.debug(`xcodebuild process did not end in a timely fashion: '${(err as Error)?.message}'.`);
     }
 
     try {
@@ -330,9 +320,7 @@ export class XcodeBuild {
     }
   }
 
-  private async fetchBuildSettings(
-    options?: RetrieveBuildSettingsOptions,
-  ): Promise<XcodeBuildSettings | undefined> {
+  private async fetchBuildSettings(options?: RetrieveBuildSettingsOptions): Promise<XcodeBuildSettings | undefined> {
     const schemeLabel = options?.scheme ?? 'default';
     let stdout: string;
     try {
@@ -344,9 +332,7 @@ export class XcodeBuild {
         ...buildSettingsArgsFromOptions(options),
       ]));
     } catch (err: any) {
-      this.log.warn(
-        `Cannot retrieve WDA build settings for scheme '${schemeLabel}'. Original error: ${err.message}`,
-      );
+      this.log.warn(`Cannot retrieve WDA build settings for scheme '${schemeLabel}'. Original error: ${err.message}`);
       return;
     }
 
@@ -409,9 +395,7 @@ export class XcodeBuild {
     }
     args.push('-destination', `id=${this.device.udid}`);
 
-    const versionMatch = this.platformVersion
-      ? new RegExp(/^(\d+)\.(\d+)/).exec(this.platformVersion)
-      : null;
+    const versionMatch = this.platformVersion ? new RegExp(/^(\d+)\.(\d+)/).exec(this.platformVersion) : null;
     if (versionMatch) {
       args.push(
         `${isTvOS(this.platformName || '') ? 'TV' : 'IPHONE'}OS_DEPLOYMENT_TARGET=${versionMatch[1]}.${versionMatch[2]}`,
@@ -429,10 +413,7 @@ export class XcodeBuild {
         args.push('-xcconfig', this.xcodeConfigFile);
       }
       if (this.xcodeOrgId && this.xcodeSigningId) {
-        args.push(
-          `DEVELOPMENT_TEAM=${this.xcodeOrgId}`,
-          `CODE_SIGN_IDENTITY=${this.xcodeSigningId}`,
-        );
+        args.push(`DEVELOPMENT_TEAM=${this.xcodeOrgId}`, `CODE_SIGN_IDENTITY=${this.xcodeSigningId}`);
       }
       if (this.updatedWDABundleId) {
         args.push(`PRODUCT_BUNDLE_IDENTIFIER=${this.updatedWDABundleId}`);
@@ -555,9 +536,7 @@ export class XcodeBuild {
         return currentStatus;
       }
 
-      this.log.debug(
-        `WebDriverAgent successfully started after ${timer.getDuration().asMilliSeconds.toFixed(0)}ms`,
-      );
+      this.log.debug(`WebDriverAgent successfully started after ${timer.getDuration().asMilliSeconds.toFixed(0)}ms`);
     } catch (err: any) {
       this.log.debug(err.stack);
       throw new Error(