@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/NSExpressionFBFormatTests.m

@@ -0,0 +1,60 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <XCTest/XCTest.h>
+
+#import "NSExpression+FBFormat.h"
+#import "FBElementUtils.h"
+
+@interface NSExpressionFBFormatTests : XCTestCase
+@end
+
+@implementation NSExpressionFBFormatTests
+
+- (void)testFormattingForExistingProperty
+{
+  NSExpression *expr = [NSExpression expressionWithFormat:@"wdName"];
+  NSExpression *prop = [NSExpression fb_wdExpressionWithExpression:expr];
+  XCTAssertEqualObjects([prop keyPath], @"wdName");
+}
+
+- (void)testFormattingForExistingPropertyShortcut
+{
+  NSExpression *expr = [NSExpression expressionWithFormat:@"visible"];
+  NSExpression *prop = [NSExpression fb_wdExpressionWithExpression:expr];
+  XCTAssertEqualObjects([prop keyPath], @"isWDVisible");
+}
+
+- (void)testFormattingForValidExpressionWOKeys
+{
+  NSExpression *expr = [NSExpression expressionWithFormat:@"1"];
+  NSExpression *prop = [NSExpression fb_wdExpressionWithExpression:expr];
+  XCTAssertEqualObjects([prop constantValue], [NSNumber numberWithInt:1]);
+}
+
+- (void)testFormattingForExistingComplexProperty
+{
+  NSExpression *expr = [NSExpression expressionWithFormat:@"wdRect.x"];
+  NSExpression *prop = [NSExpression fb_wdExpressionWithExpression:expr];
+  XCTAssertEqualObjects([prop keyPath], @"wdRect.x");
+}
+
+- (void)testFormattingForExistingComplexPropertyWOPrefix
+{
+  NSExpression *expr = [NSExpression expressionWithFormat:@"rect.x"];
+  NSExpression *prop = [NSExpression fb_wdExpressionWithExpression:expr];
+  XCTAssertEqualObjects([prop keyPath], @"wdRect.x");
+}
+
+- (void)testFormattingForPredicateWithUnknownKey
+{
+  NSExpression *expr = [NSExpression expressionWithFormat:@"title"];
+  XCTAssertThrowsSpecificNamed([NSExpression fb_wdExpressionWithExpression:expr], NSException, FBUnknownAttributeException);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/NSPredicateFBFormatTests.m

@@ -0,0 +1,72 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <XCTest/XCTest.h>
+
+#import "NSPredicate+FBFormat.h"
+
+@interface NSPredicateFBFormatTests : XCTestCase
+@end
+
+@implementation NSPredicateFBFormatTests
+
+- (void)testFormattingForExistingProperty
+{
+  NSPredicate *expr = [NSPredicate predicateWithFormat:@"wdName == 'blabla'"];
+  XCTAssertNotNil([NSPredicate fb_formatSearchPredicate:expr]);
+}
+
+- (void)testFormattingForExistingPropertyOnTheRightSide
+{
+  NSPredicate *expr = [NSPredicate predicateWithFormat:@"0 == wdAccessible"];
+  XCTAssertNotNil([NSPredicate fb_formatSearchPredicate:expr]);
+}
+
+- (void)testFormattingForExistingPropertyShortcut
+{
+  NSPredicate *expr = [NSPredicate predicateWithFormat:@"visible == 1"];
+  XCTAssertNotNil([NSPredicate fb_formatSearchPredicate:expr]);
+}
+
+- (void)testFormattingForComplexExpression
+{
+  NSPredicate *expr = [NSPredicate predicateWithFormat:@"visible == 1 AND NOT (type == 'blabla' OR NOT (label IN {'3', '4'}))"];
+  XCTAssertNotNil([NSPredicate fb_formatSearchPredicate:expr]);
+}
+
+- (void)testFormattingForValidExpressionWOKeys
+{
+  NSPredicate *expr = [NSPredicate predicateWithFormat:@"1 = 1"];
+  XCTAssertNotNil([NSPredicate fb_formatSearchPredicate:expr]);
+}
+
+- (void)testFormattingForExistingComplexProperty
+{
+  NSPredicate *expr = [NSPredicate predicateWithFormat:@"wdRect.x == '0'"];
+  XCTAssertNotNil([NSPredicate fb_formatSearchPredicate:expr]);
+}
+
+- (void)testFormattingForExistingComplexPropertyWOPrefix
+{
+  NSPredicate *expr = [NSPredicate predicateWithFormat:@"rect.x == '0'"];
+  XCTAssertNotNil([NSPredicate fb_formatSearchPredicate:expr]);
+}
+                       
+- (void)testFormattingForPredicateWithUnknownKey
+{
+  NSPredicate *expr = [NSPredicate predicateWithFormat:@"title == 'blabla'"];
+  XCTAssertThrows([NSPredicate fb_formatSearchPredicate:expr]);
+}
+
+- (void)testBlockPredicateCreation
+{
+  NSPredicate *expr = [NSPredicate predicateWithFormat:@"rect.x == '0'"];
+  XCTAssertNotNil([NSPredicate fb_snapshotBlockPredicateWithPredicate:expr]);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/XCUIElementHelpersTests.m

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <XCTest/XCTest.h>
+
+#import "FBElementUtils.h"
+
+@interface XCUIElementHelpersTests : XCTestCase
+@property (nonatomic) NSDictionary *namesMapping;
+@end
+
+@implementation XCUIElementHelpersTests
+
+- (void)setUp
+{
+  [super setUp];
+  self.namesMapping = [FBElementUtils wdAttributeNamesMapping];
+}
+
+- (void)testMappingContainsNamesAndAliases
+{
+  XCTAssertTrue([self.namesMapping.allKeys containsObject:@"wdName"]);
+  XCTAssertTrue([self.namesMapping.allKeys containsObject:@"name"]);
+}
+
+- (void)testMappingContainsCorrectValueForAttrbutesWithoutGetters
+{
+  XCTAssertTrue([[self.namesMapping objectForKey:@"label"] isEqualToString:@"wdLabel"]);
+  XCTAssertTrue([[self.namesMapping objectForKey:@"wdLabel"] isEqualToString:@"wdLabel"]);
+}
+
+- (void)testMappingContainsCorrectValueForAttrbutesWithGetters
+{
+  XCTAssertTrue([[self.namesMapping objectForKey:@"visible"] isEqualToString:@"isWDVisible"]);
+  XCTAssertTrue([[self.namesMapping objectForKey:@"wdVisible"] isEqualToString:@"isWDVisible"]);
+}
+
+- (void)testEachPropertyHasAlias
+{
+  NSArray *aliases = [self.namesMapping.allKeys filteredArrayUsingPredicate:[NSPredicate predicateWithFormat:@"NOT(SELF beginsWith[c] 'wd')"]];
+  NSArray *names = [self.namesMapping.allKeys filteredArrayUsingPredicate:[NSPredicate predicateWithFormat:@"SELF beginsWith[c] 'wd'"]];
+  XCTAssertEqual(aliases.count, names.count);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests_tvOS/Doubles/XCUIElementDouble.h

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2018-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <Foundation/Foundation.h>
+#import <WebDriverAgentLib/FBElement.h>
+#import <XCTest/XCUIElementTypes.h>
+
+@class XCUIApplication;
+
+@interface XCUIElementDouble : NSObject<FBElement>
+@property (nonatomic, strong, nonnull) XCUIApplication *application;
+@property (nonatomic, readwrite, assign) CGRect frame;
+@property (nonatomic, readwrite, nullable) id lastSnapshot;
+@property (nonatomic, assign) BOOL fb_isObstructedByAlert;
+@property (nonatomic, readwrite, copy, nonnull) NSDictionary *wdRect;
+@property (nonatomic, readwrite, assign) CGRect wdFrame;
+@property (nonatomic, readwrite, copy, nonnull) NSString *wdUID;
+@property (nonatomic, copy, readwrite, nullable) NSString *wdName;
+@property (nonatomic, copy, readwrite, nullable) NSString *wdLabel;
+@property (nonatomic, copy, readwrite, nonnull) NSString *wdType;
+@property (nonatomic, strong, readwrite, nullable) NSString *wdValue;
+@property (nonatomic, readwrite, getter=isWDEnabled) BOOL wdEnabled;
+@property (nonatomic, readwrite, getter=isWDSelected) BOOL wdSelected;
+@property (nonatomic, readwrite) NSUInteger wdIndex;
+@property (nonatomic, readwrite, getter=isWDVisible) BOOL wdVisible;
+@property (nonatomic, readwrite, getter=isWDAccessible) BOOL wdAccessible;
+@property (nonatomic, readwrite, getter=isWDFocused) BOOL wdFocused;
+@property (nonatomic, readwrite, getter = isWDHittable) BOOL wdHittable;
+@property (copy, nonnull) NSArray *children;
+@property (nonatomic, readwrite, assign) XCUIElementType elementType;
+@property (nonatomic, readwrite, getter=isWDAccessibilityContainer) BOOL wdAccessibilityContainer;
+@property (nonatomic, strong, readwrite, nullable) NSString *wdCustomActions;
+
+- (void)resolve;
+- (id _Nonnull)fb_standardSnapshot;
+- (id _Nonnull)fb_customSnapshot;
+
+// Checks
+@property (nonatomic, assign, readonly) BOOL didResolve;
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests_tvOS/Doubles/XCUIElementDouble.m

@@ -0,0 +1,80 @@
+/**
+ * Copyright (c) 2018-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "XCUIElementDouble.h"
+
+@interface XCUIElementDouble ()
+@property (nonatomic, assign, readwrite) BOOL didResolve;
+@end
+
+@implementation XCUIElementDouble
+
+- (id)init
+{
+  self = [super init];
+  if (self) {
+    self.wdFrame = CGRectMake(0, 0, 0, 0);
+    self.wdName = @"testName";
+    self.wdLabel = @"testLabel";
+    self.wdValue = @"magicValue";
+    self.wdVisible = YES;
+    self.wdAccessible = YES;
+    self.wdEnabled = YES;
+    self.wdSelected = YES;
+    self.wdHittable = YES;
+    self.wdIndex = 0;
+    self.wdCustomActions = nil;
+#if TARGET_OS_TV
+    self.wdFocused = YES;
+#endif
+    self.children = @[];
+    self.wdRect =  @{@"x": @0,
+                     @"y": @0,
+                     @"width": @0,
+                     @"height": @0,
+                     };
+    self.wdAccessibilityContainer = NO;
+    self.elementType = XCUIElementTypeOther;
+    self.wdType = @"XCUIElementTypeOther";
+    self.wdUID = @"0";
+    self.lastSnapshot = nil;
+  }
+  return self;
+}
+
+- (id)fb_valueForWDAttributeName:(NSString *)name
+{
+  return @"test";
+}
+
+- (id)fb_standardSnapshot
+{
+  return [self lastSnapshot];
+}
+
+- (id)fb_customSnapshot
+{
+  return [self lastSnapshot];
+}
+
+- (void)resolve
+{
+  self.didResolve = YES;
+}
+
+- (id)lastSnapshot
+{
+  return self;
+}
+
+- (id)fb_uid
+{
+  return self.wdUID;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests_tvOS/FBTVNavigationTrackerTests.m

@@ -0,0 +1,86 @@
+/**
+ * Copyright (c) 2018-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <XCTest/XCTest.h>
+
+#import "XCUIElementDouble.h"
+#import "FBTVNavigationTracker.h"
+#import "FBTVNavigationTracker-Private.h"
+
+@interface FBTVNavigationTrackerTests : XCTestCase
+@end
+
+@implementation FBTVNavigationTrackerTests
+
+- (void)testHorizontalDirectionWithItemShouldBeRight
+{
+  XCUIElementDouble *el1 = XCUIElementDouble.new;
+
+  FBTVNavigationItem *item = [FBTVNavigationItem itemWithUid:@"123456789"];
+  FBTVNavigationTracker *tracker = [FBTVNavigationTracker trackerWithTargetElement:(XCUIElement *)el1];
+
+  FBTVDirection direction = [tracker horizontalDirectionWithItem:item andDelta:0.1];
+  XCTAssertEqual(FBTVDirectionRight, direction);
+}
+
+- (void)testHorizontalDirectionWithItemShouldBeLeft
+{
+  XCUIElementDouble *el1 = XCUIElementDouble.new;
+
+  FBTVNavigationItem *item = [FBTVNavigationItem itemWithUid:@"123456789"];
+  FBTVNavigationTracker *tracker = [FBTVNavigationTracker trackerWithTargetElement:(XCUIElement *)el1];
+
+  FBTVDirection direction = [tracker horizontalDirectionWithItem:item andDelta:-0.1];
+  XCTAssertEqual(FBTVDirectionLeft, direction);
+}
+
+- (void)testHorizontalDirectionWithItemShouldBeNone
+{
+  XCUIElementDouble *el1 = XCUIElementDouble.new;
+
+  FBTVNavigationItem *item = [FBTVNavigationItem itemWithUid:@"123456789"];
+  FBTVNavigationTracker *tracker = [FBTVNavigationTracker trackerWithTargetElement:(XCUIElement *)el1];
+
+  FBTVDirection direction = [tracker horizontalDirectionWithItem:item andDelta:DBL_EPSILON];
+  XCTAssertEqual(FBTVDirectionNone, direction);
+}
+
+- (void)testVerticalDirectionWithItemShouldBeDown
+{
+  XCUIElementDouble *el1 = XCUIElementDouble.new;
+
+  FBTVNavigationItem *item = [FBTVNavigationItem itemWithUid:@"123456789"];
+  FBTVNavigationTracker *tracker = [FBTVNavigationTracker trackerWithTargetElement:(XCUIElement *)el1];
+
+  FBTVDirection direction = [tracker verticalDirectionWithItem:item andDelta:0.1];
+  XCTAssertEqual(FBTVDirectionDown, direction);
+}
+
+- (void)testVerticalDirectionWithItemShouldBeUp
+{
+  XCUIElementDouble *el1 = XCUIElementDouble.new;
+
+  FBTVNavigationItem *item = [FBTVNavigationItem itemWithUid:@"123456789"];
+  FBTVNavigationTracker *tracker = [FBTVNavigationTracker trackerWithTargetElement:(XCUIElement *)el1];
+
+  FBTVDirection direction = [tracker verticalDirectionWithItem:item andDelta:-0.1];
+  XCTAssertEqual(FBTVDirectionUp, direction);
+}
+
+- (void)testVerticalDirectionWithItemShouldBeNone
+{
+  XCUIElementDouble *el1 = XCUIElementDouble.new;
+
+  FBTVNavigationItem *item = [FBTVNavigationItem itemWithUid:@"123456789"];
+  FBTVNavigationTracker *tracker = [FBTVNavigationTracker trackerWithTargetElement:(XCUIElement *)el1];
+
+  FBTVDirection direction = [tracker verticalDirectionWithItem:item andDelta:DBL_EPSILON];
+  XCTAssertEqual(FBTVDirectionNone, direction);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests_tvOS/Info.plist

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>com.facebook.wda.unitTests</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>BNDL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+</dict>
+</plist>

package/drivers/ios/WebDriverAgent/eslint.config.mjs

@@ -0,0 +1,13 @@
+import appiumConfig from '@appium/eslint-config-appium-ts';
+
+export default [
+  ...appiumConfig,
+  {
+    ignores: [
+      'Configurations/**',
+      'Fastlane/**',
+      'PrivateHeaders/**',
+      'WebDriverAgent*/**'
+    ],
+  },
+];

package/drivers/ios/WebDriverAgent/index.ts

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

package/drivers/ios/WebDriverAgent/lib/check-dependencies.ts

@@ -0,0 +1,34 @@
+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';
+
+async function buildWDASim (): Promise<void> {
+  const args = [
+    '-project', path.join(BOOTSTRAP_PATH, 'WebDriverAgent.xcodeproj'),
+    '-scheme', WDA_SCHEME,
+    '-sdk', SDK_SIMULATOR,
+    'CODE_SIGN_IDENTITY=""',
+    'CODE_SIGNING_REQUIRED="NO"',
+    'GCC_TREAT_WARNINGS_AS_ERRORS=0',
+  ];
+  await exec('xcodebuild', args);
+}
+
+export async function bundleWDASim (xcodebuild: XcodeBuild): Promise<string> {
+  const derivedDataPath = await xcodebuild.retrieveDerivedDataPath();
+  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);
+  if (await fs.exists(wdaBundlePath)) {
+    return wdaBundlePath;
+  }
+  await buildWDASim();
+  return wdaBundlePath;
+}
+

package/drivers/ios/WebDriverAgent/lib/constants.ts

@@ -0,0 +1,18 @@
+import path from 'node:path';
+
+export const DEFAULT_TEST_BUNDLE_SUFFIX = '.xctrunner';
+export const WDA_RUNNER_BUNDLE_ID = 'com.facebook.WebDriverAgentRunner';
+export const WDA_RUNNER_BUNDLE_ID_FOR_XCTEST = `${WDA_RUNNER_BUNDLE_ID}${DEFAULT_TEST_BUNDLE_SUFFIX}`;
+export const WDA_RUNNER_APP = 'WebDriverAgentRunner-Runner.app';
+export const WDA_SCHEME = 'WebDriverAgentRunner';
+export const PROJECT_FILE = 'project.pbxproj';
+export const WDA_BASE_URL = 'http://127.0.0.1';
+
+export const PLATFORM_NAME_TVOS = 'tvOS';
+export const PLATFORM_NAME_IOS = 'iOS';
+
+export const SDK_SIMULATOR = 'iphonesimulator';
+export const SDK_DEVICE = 'iphoneos';
+
+export const WDA_UPGRADE_TIMESTAMP_PATH = path.join('.appium', 'webdriveragent', 'upgrade.time');
+

package/drivers/ios/WebDriverAgent/lib/logger.ts

@@ -0,0 +1,3 @@
+import { logger } from '@appium/support';
+
+export const log = logger.getLogger('WebDriverAgent');

package/drivers/ios/WebDriverAgent/lib/no-session-proxy.ts

@@ -0,0 +1,25 @@
+import { JWProxy } from '@appium/base-driver';
+import type { ProxyOptions } from '@appium/types';
+
+
+export class NoSessionProxy extends JWProxy {
+  constructor (opts: ProxyOptions = {}) {
+    super(opts);
+  }
+
+  override getUrlForProxy (url: string): string {
+    if (url === '') {
+      url = '/';
+    }
+    const proxyBase = `${this.scheme}://${this.server}:${this.port}${this.base}`;
+    let remainingUrl = '';
+    if ((new RegExp('^/')).test(url)) {
+      remainingUrl = url;
+    } else {
+      throw new Error(`Did not know what to do with url '${url}'`);
+    }
+    remainingUrl = remainingUrl.replace(/\/$/, ''); // can't have trailing slashes
+    return proxyBase + remainingUrl;
+  }
+}
+

package/drivers/ios/WebDriverAgent/lib/types.ts

@@ -0,0 +1,139 @@
+// WebDriverAgentLib/Utilities/FBSettings.h
+export interface WDASettings {
+  elementResponseAttribute?: string;
+  shouldUseCompactResponses?: boolean;
+  mjpegServerScreenshotQuality?: number;
+  mjpegServerFramerate?: number;
+  screenshotQuality?: number;
+  elementResponseAttributes?: string;
+  mjpegScalingFactor?: number;
+  mjpegFixOrientation?: boolean;
+  keyboardAutocorrection?: boolean;
+  keyboardPrediction?: boolean;
+  customSnapshotTimeout?: number;
+  snapshotMaxDepth?: number;
+  useFirstMatch?: boolean;
+  boundElementsByIndex?: boolean;
+  reduceMotion?: boolean;
+  defaultActiveApplication?: string;
+  activeAppDetectionPoint?: string;
+  includeNonModalElements?: boolean;
+  defaultAlertAction?: 'accept' | 'dismiss';
+  acceptAlertButtonSelector?: string;
+  dismissAlertButtonSelector?: string;
+  screenshotOrientation?: 'auto' | 'portrait' | 'portraitUpsideDown' | 'landscapeRight' | 'landscapeLeft'
+  waitForIdleTimeout?: number;
+  animationCoolOffTimeout?: number;
+  maxTypingFrequency?: number;
+  useClearTextShortcut?: boolean;
+}
+
+// WebDriverAgentLib/Utilities/FBCapabilities.h
+export interface WDACapabilities {
+  bundleId?: string;
+  initialUrl?: string;
+  arguments?: string[];
+  environment?: Record<string, string>;
+  eventloopIdleDelaySec?: number;
+  shouldWaitForQuiescence?: boolean;
+  shouldUseTestManagerForVisibilityDetection?: boolean;
+  maxTypingFrequency?: number;
+  shouldUseSingletonTestManager?: boolean;
+  waitForIdleTimeout?: number;
+  shouldUseCompactResponses?: number;
+  elementResponseFields?: unknown;
+  disableAutomaticScreenshots?: boolean;
+  shouldTerminateApp?: boolean;
+  forceAppLaunch?: boolean;
+  useNativeCachingStrategy?: boolean;
+  forceSimulatorSoftwareKeyboardPresence?: boolean;
+  defaultAlertAction?: 'accept' | 'dismiss';
+  appLaunchStateTimeoutSec?: number;
+}
+
+export interface WebDriverAgentArgs {
+  device: AppleDevice; // Required
+  platformVersion?: string;
+  platformName?: string;
+  iosSdkVersion?: string;
+  host?: string;
+  realDevice?: boolean;
+  wdaBundlePath?: string;
+  bootstrapPath?: string;
+  agentPath?: string;
+  wdaLocalPort?: number;
+  wdaRemotePort?: number;
+  wdaBaseUrl?: string;
+  wdaBindingIP?: string;
+  prebuildWDA?: boolean;
+  webDriverAgentUrl?: string;
+  wdaConnectionTimeout?: number;
+  useXctestrunFile?: boolean;
+  usePrebuiltWDA?: boolean;
+  derivedDataPath?: string;
+  mjpegServerPort?: number;
+  updatedWDABundleId?: string;
+  wdaLaunchTimeout?: number;
+  usePreinstalledWDA?: boolean;
+  updatedWDABundleIdSuffix?: string;
+  showXcodeLog?: boolean;
+  xcodeConfigFile?: string;
+  xcodeOrgId?: string;
+  xcodeSigningId?: string;
+  keychainPath?: string;
+  keychainPassword?: string;
+  useSimpleBuildTest?: boolean;
+  allowProvisioningDeviceRegistration?: boolean;
+  resultBundlePath?: string;
+  resultBundleVersion?: string;
+  reqBasePath?: string;
+  launchTimeout?: number;
+}
+
+export interface AppleDevice {
+  udid: string;
+  simctl?: any;
+  devicectl?: any;
+  /** @deprecated We'll stop supporting idb */
+  idb?: any;
+  [key: string]: any;
+}
+
+/**
+ * Information of the device under test
+ */
+export interface DeviceInfo {
+  isRealDevice: boolean;
+  udid: string;
+  platformVersion: string;
+  platformName: string;
+}
+
+export interface XcodeBuildArgs {
+  realDevice: boolean; // Required
+  agentPath: string; // Required
+  bootstrapPath: string; // Required
+  platformVersion?: string;
+  platformName?: string;
+  iosSdkVersion?: string;
+  showXcodeLog?: boolean;
+  xcodeConfigFile?: string;
+  xcodeOrgId?: string;
+  xcodeSigningId?: string;
+  keychainPath?: string;
+  keychainPassword?: string;
+  prebuildWDA?: boolean;
+  usePrebuiltWDA?: boolean;
+  useSimpleBuildTest?: boolean;
+  useXctestrunFile?: boolean;
+  launchTimeout?: number;
+  wdaRemotePort?: number;
+  wdaBindingIP?: string;
+  updatedWDABundleId?: string;
+  derivedDataPath?: string;
+  mjpegServerPort?: number;
+  prebuildDelay?: number;
+  allowProvisioningDeviceRegistration?: boolean;
+  resultBundlePath?: string;
+  resultBundleVersion?: string;
+}