@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Commands/FBTouchIDCommands.m

@@ -0,0 +1,30 @@
+/**
+ * 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 "FBTouchIDCommands.h"
+
+#import "FBRouteRequest.h"
+
+#import "XCUIDevice+FBHelpers.h"
+
+@implementation FBTouchIDCommands
+
++ (NSArray *)routes
+{
+  return @[
+    [[FBRoute POST:@"/wda/touch_id"] respondWithBlock: ^ id<FBResponsePayload> (FBRouteRequest *request) {
+      BOOL isMatch = [request.arguments[@"match"] boolValue];
+      if (![[XCUIDevice sharedDevice] fb_fingerTouchShouldMatch:isMatch]) {
+        return FBResponseWithUnknownErrorFormat(@"Cannot perform Touch Id %@match", isMatch ? @"" : @"non-");
+      }
+      return FBResponseWithOK();
+    }],
+  ];
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Commands/FBUnknownCommands.h

@@ -0,0 +1,19 @@
+/**
+ * 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 <Foundation/Foundation.h>
+
+#import <WebDriverAgentLib/FBCommandHandler.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FBUnknownCommands : NSObject <FBCommandHandler>
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Commands/FBUnknownCommands.m

@@ -0,0 +1,39 @@
+/**
+ * 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 "FBUnknownCommands.h"
+
+#import "FBRouteRequest.h"
+
+@implementation FBUnknownCommands
+
+#pragma mark - <FBCommandHandler>
+
++ (BOOL)shouldRegisterAutomatically
+{
+  return NO;
+}
+
++ (NSArray *)routes
+{
+  return
+  @[
+    [[FBRoute GET:@"/*"].withoutSession respondWithTarget:self action:@selector(unhandledHandler:)],
+    [[FBRoute POST:@"/*"].withoutSession respondWithTarget:self action:@selector(unhandledHandler:)],
+    [[FBRoute PUT:@"/*"].withoutSession respondWithTarget:self action:@selector(unhandledHandler:)],
+    [[FBRoute DELETE:@"/*"].withoutSession respondWithTarget:self action:@selector(unhandledHandler:)]
+  ];
+}
+
++ (id<FBResponsePayload>)unhandledHandler:(FBRouteRequest *)request
+{
+  return FBResponseWithStatus([FBCommandStatus unknownCommandErrorWithMessage:[NSString stringWithFormat:@"Unhandled endpoint: %@ with parameters %@", request.URL, request.parameters]
+                                                                    traceback:nil]);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Commands/FBVideoCommands.h

@@ -0,0 +1,19 @@
+/**
+ * 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 <Foundation/Foundation.h>
+
+#import <WebDriverAgentLib/FBCommandHandler.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FBVideoCommands : NSObject <FBCommandHandler>
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Commands/FBVideoCommands.m

@@ -0,0 +1,84 @@
+/**
+ * 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 "FBVideoCommands.h"
+
+#import "FBRouteRequest.h"
+#import "FBScreenRecordingContainer.h"
+#import "FBScreenRecordingPromise.h"
+#import "FBScreenRecordingRequest.h"
+#import "FBSession.h"
+#import "FBXCTestDaemonsProxy.h"
+
+const NSUInteger DEFAULT_FPS = 24;
+const NSUInteger DEFAULT_CODEC = 0;
+
+@implementation FBVideoCommands
+
++ (NSArray *)routes
+{
+  return
+  @[
+    [[FBRoute POST:@"/wda/video/start"] respondWithTarget:self action:@selector(handleStartVideoRecording:)],
+    [[FBRoute POST:@"/wda/video/stop"] respondWithTarget:self action:@selector(handleStopVideoRecording:)],
+    [[FBRoute GET:@"/wda/video"] respondWithTarget:self action:@selector(handleGetVideoRecording:)],
+
+    [[FBRoute POST:@"/wda/video/start"].withoutSession respondWithTarget:self action:@selector(handleStartVideoRecording:)],
+    [[FBRoute POST:@"/wda/video/stop"].withoutSession respondWithTarget:self action:@selector(handleStopVideoRecording:)],
+    [[FBRoute GET:@"/wda/video"].withoutSession respondWithTarget:self action:@selector(handleGetVideoRecording:)],
+  ];
+}
+
++ (id<FBResponsePayload>)handleStartVideoRecording:(FBRouteRequest *)request
+{
+  FBScreenRecordingPromise *activeScreenRecording = FBScreenRecordingContainer.sharedInstance.screenRecordingPromise;
+  if (nil != activeScreenRecording) {
+    return FBResponseWithObject([FBScreenRecordingContainer.sharedInstance toDictionary] ?: [NSNull null]);
+  }
+
+  NSNumber *fps = (NSNumber *)request.arguments[@"fps"] ?: @(DEFAULT_FPS);
+  NSNumber *codec = (NSNumber *)request.arguments[@"codec"] ?: @(DEFAULT_CODEC);
+  FBScreenRecordingRequest *recordingRequest = [[FBScreenRecordingRequest alloc] initWithFps:fps.integerValue
+                                                                                       codec:codec.longLongValue];
+  NSError *error;
+  FBScreenRecordingPromise* promise = [FBXCTestDaemonsProxy startScreenRecordingWithRequest:recordingRequest
+                                                                                      error:&error];
+  if (nil == promise) {
+    [FBScreenRecordingContainer.sharedInstance reset];
+    return FBResponseWithUnknownError(error);
+  }
+  [FBScreenRecordingContainer.sharedInstance storeScreenRecordingPromise:promise
+                                                                     fps:fps.integerValue
+                                                                   codec:codec.longLongValue];
+  return FBResponseWithObject([FBScreenRecordingContainer.sharedInstance toDictionary]);
+}
+
++ (id<FBResponsePayload>)handleStopVideoRecording:(FBRouteRequest *)request
+{
+  FBScreenRecordingPromise *activeScreenRecording = FBScreenRecordingContainer.sharedInstance.screenRecordingPromise;
+  if (nil == activeScreenRecording) {
+    return FBResponseWithOK();
+  }
+
+  NSUUID *recordingId = activeScreenRecording.identifier;
+  NSDictionary *response = [FBScreenRecordingContainer.sharedInstance toDictionary];
+  NSError *error;
+  if (![FBXCTestDaemonsProxy stopScreenRecordingWithUUID:recordingId error:&error]) {
+    [FBScreenRecordingContainer.sharedInstance reset];
+    return FBResponseWithUnknownError(error);
+  }
+  [FBScreenRecordingContainer.sharedInstance reset];
+  return FBResponseWithObject(response);
+}
+
++ (id<FBResponsePayload>)handleGetVideoRecording:(FBRouteRequest *)request
+{
+  return FBResponseWithObject([FBScreenRecordingContainer.sharedInstance toDictionary] ?: [NSNull null]);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/FBAlert.h

@@ -0,0 +1,91 @@
+/**
+ * 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 <Foundation/Foundation.h>
+
+@class XCUIApplication;
+@class XCUIElement;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Alert helper class that abstracts alert handling
+ */
+@interface FBAlert : NSObject
+
+/**
+ Creates alert helper for given application
+
+ @param application The application that contains the alert
+ */
++ (instancetype)alertWithApplication:(XCUIApplication *)application;
+
+/**
+ Creates alert helper for given application
+
+ @param element The element which represents the alert
+ */
++ (instancetype)alertWithElement:(XCUIElement *)element;
+
+/**
+ Determines whether alert is present
+ */
+- (BOOL)isPresent;
+
+/**
+ Gets the labels of the buttons visible in the alert
+ */
+- (nullable NSArray *)buttonLabels;
+
+/**
+ Returns alert's title and description separated by new lines
+ */
+- (nullable NSString *)text;
+
+/**
+ Accepts alert, if present
+
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if the operation succeeds, otherwise NO.
+ */
+- (BOOL)acceptWithError:(NSError **)error;
+
+/**
+ Dismisses alert, if present
+
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if the operation succeeds, otherwise NO.
+ */
+- (BOOL)dismissWithError:(NSError **)error;
+
+/**
+ Clicks on an alert button, if present
+ 
+ @param label The label of the button on which to click.
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if the operation suceeds, otherwise NO.
+ */
+- (BOOL)clickAlertButton:(NSString *)label error:(NSError **)error;
+
+/**
+ XCUElement that represents alert
+ */
+- (nullable XCUIElement *)alertElement;
+
+/**
+ Types a text into an input inside the alert container, if it is present
+
+ @param text the text to type
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if the operation succeeds, otherwise NO.
+ */
+- (BOOL)typeText:(NSString *)text error:(NSError **)error;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/FBAlert.m

@@ -0,0 +1,274 @@
+/**
+ * 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 "FBAlert.h"
+
+#import "FBConfiguration.h"
+#import "FBErrorBuilder.h"
+#import "FBLogger.h"
+#import "FBXCElementSnapshotWrapper+Helpers.h"
+#import "FBXCodeCompatibility.h"
+#import "XCUIApplication.h"
+#import "XCUIApplication+FBAlert.h"
+#import "XCUIElement+FBClassChain.h"
+#import "XCUIElement+FBTyping.h"
+#import "XCUIElement+FBUtilities.h"
+#import "XCUIElement+FBWebDriverAttributes.h"
+
+
+@interface FBAlert ()
+@property (nonatomic, strong) XCUIApplication *application;
+@property (nonatomic, strong, nullable) XCUIElement *element;
+@end
+
+@implementation FBAlert
+
++ (instancetype)alertWithApplication:(XCUIApplication *)application
+{
+  FBAlert *alert = [FBAlert new];
+  alert.application = application;
+  return alert;
+}
+
++ (instancetype)alertWithElement:(XCUIElement *)element
+{
+  FBAlert *alert = [FBAlert new];
+  alert.element = element;
+  alert.application = element.application;
+  return alert;
+}
+
+- (BOOL)isPresent
+{
+  @try {
+    if (nil == self.alertElement) {
+      return NO;
+    }
+    [self.alertElement fb_customSnapshot];
+    return YES;
+  } @catch (NSException *) {
+    return NO;
+  }
+}
+
+- (BOOL)notPresentWithError:(NSError **)error
+{
+  return [[[FBErrorBuilder builder]
+           withDescriptionFormat:@"No alert is open"]
+          buildError:error];
+}
+
++ (BOOL)isSafariWebAlertWithSnapshot:(id<FBXCElementSnapshot>)snapshot
+{
+  if (snapshot.elementType != XCUIElementTypeOther) {
+    return NO;
+  }
+
+  FBXCElementSnapshotWrapper *snapshotWrapper = [FBXCElementSnapshotWrapper ensureWrapped:snapshot];
+  id<FBXCElementSnapshot> application = [snapshotWrapper fb_parentMatchingType:XCUIElementTypeApplication];
+  return nil != application && [application.label isEqualToString:FB_SAFARI_APP_NAME];
+}
+
+- (NSString *)text
+{
+  if (!self.isPresent) {
+    return nil;
+  }
+
+  NSMutableArray<NSString *> *resultText = [NSMutableArray array];
+  id<FBXCElementSnapshot> snapshot = self.alertElement.lastSnapshot ?: [self.alertElement fb_customSnapshot];
+  BOOL isSafariAlert = [self.class isSafariWebAlertWithSnapshot:snapshot];
+  [snapshot enumerateDescendantsUsingBlock:^(id<FBXCElementSnapshot> descendant) {
+    XCUIElementType elementType = descendant.elementType;
+    if (!(elementType == XCUIElementTypeTextView || elementType == XCUIElementTypeStaticText)) {
+      return;
+    }
+    
+    FBXCElementSnapshotWrapper *descendantWrapper = [FBXCElementSnapshotWrapper ensureWrapped:descendant];
+    if (elementType == XCUIElementTypeStaticText
+        && nil != [descendantWrapper fb_parentMatchingType:XCUIElementTypeButton]) {
+      return;
+    }
+
+    NSString *text = descendantWrapper.wdLabel ?: descendantWrapper.wdValue;
+    if (isSafariAlert && nil != descendant.parent) {
+      FBXCElementSnapshotWrapper *descendantParentWrapper = [FBXCElementSnapshotWrapper ensureWrapped:descendant.parent];
+      NSString *parentText = descendantParentWrapper.wdLabel ?: descendantParentWrapper.wdValue;
+      if ([parentText isEqualToString:text]) {
+        // Avoid duplicated texts on Safari alerts
+        return;
+      }
+    }
+
+    if (nil != text) {
+      [resultText addObject:[NSString stringWithFormat:@"%@", text]];
+    }
+  }];
+  return [resultText componentsJoinedByString:@"\n"];
+}
+
+- (BOOL)typeText:(NSString *)text error:(NSError **)error
+{
+  if (!self.isPresent) {
+    return [self notPresentWithError:error];
+  }
+
+  NSPredicate *textCollectorPredicate = [NSPredicate predicateWithFormat:@"elementType IN {%lu,%lu}",
+                                         XCUIElementTypeTextField, XCUIElementTypeSecureTextField];
+  NSArray<XCUIElement *> *dstFields = [[self.alertElement descendantsMatchingType:XCUIElementTypeAny]
+                                       matchingPredicate:textCollectorPredicate].allElementsBoundByIndex;
+  if (dstFields.count > 1) {
+    return [[[FBErrorBuilder builder]
+      withDescriptionFormat:@"The alert contains more than one input field"]
+     buildError:error];
+  }
+  if (0 == dstFields.count) {
+    return [[[FBErrorBuilder builder]
+             withDescriptionFormat:@"The alert contains no input fields"]
+            buildError:error];
+  }
+  return [dstFields.firstObject fb_typeText:text
+                                shouldClear:YES
+                                      error:error];
+}
+
+- (NSArray *)buttonLabels
+{
+  if (!self.isPresent) {
+    return nil;
+  }
+
+  NSMutableArray<NSString *> *labels = [NSMutableArray array];
+  id<FBXCElementSnapshot> alertSnapshot = self.alertElement.lastSnapshot ?: [self.alertElement fb_customSnapshot];
+  [alertSnapshot enumerateDescendantsUsingBlock:^(id<FBXCElementSnapshot> descendant) {
+    if (descendant.elementType != XCUIElementTypeButton) {
+      return;
+    }
+    NSString *label = [FBXCElementSnapshotWrapper ensureWrapped:descendant].wdLabel;
+    if (nil != label) {
+      [labels addObject:[NSString stringWithFormat:@"%@", label]];
+    }
+  }];
+  return labels.copy;
+}
+
+- (BOOL)acceptWithError:(NSError **)error
+{
+  if (!self.isPresent) {
+    return [self notPresentWithError:error];
+  }
+
+  id<FBXCElementSnapshot> alertSnapshot = self.alertElement.lastSnapshot ?: [self.alertElement fb_customSnapshot];
+  XCUIElement *acceptButton = nil;
+  if (FBConfiguration.acceptAlertButtonSelector.length) {
+    NSString *errorReason = nil;
+    @try {
+      acceptButton = [[self.alertElement fb_descendantsMatchingClassChain:FBConfiguration.acceptAlertButtonSelector
+                                         shouldReturnAfterFirstMatch:YES] firstObject];
+    } @catch (NSException *ex) {
+      errorReason = ex.reason;
+    }
+    if (nil == acceptButton) {
+      [FBLogger logFmt:@"Cannot find any match for Accept alert button using the class chain selector '%@'",
+       FBConfiguration.acceptAlertButtonSelector];
+      if (nil != errorReason) {
+        [FBLogger logFmt:@"Original error: %@", errorReason];
+      }
+      [FBLogger log:@"Will fallback to the default button location algorithm"];
+   }
+  }
+  if (nil == acceptButton) {
+    NSArray<XCUIElement *> *buttons = [self.alertElement.fb_query
+                                       descendantsMatchingType:XCUIElementTypeButton].allElementsBoundByIndex;
+    acceptButton = (alertSnapshot.elementType == XCUIElementTypeAlert || [self.class isSafariWebAlertWithSnapshot:alertSnapshot])
+      ? buttons.lastObject
+      : buttons.firstObject;
+  }
+  if (nil == acceptButton) {
+    return [[[FBErrorBuilder builder]
+        withDescriptionFormat:@"Failed to find accept button for alert: %@", self.alertElement]
+       buildError:error];
+  }
+  [acceptButton tap];
+  return YES;
+}
+
+- (BOOL)dismissWithError:(NSError **)error
+{
+  if (!self.isPresent) {
+    return [self notPresentWithError:error];
+  }
+
+  id<FBXCElementSnapshot> alertSnapshot = self.alertElement.lastSnapshot ?: [self.alertElement fb_customSnapshot];
+  XCUIElement *dismissButton = nil;
+  if (FBConfiguration.dismissAlertButtonSelector.length) {
+    NSString *errorReason = nil;
+    @try {
+      dismissButton = [[self.alertElement fb_descendantsMatchingClassChain:FBConfiguration.dismissAlertButtonSelector
+                                          shouldReturnAfterFirstMatch:YES] firstObject];
+    } @catch (NSException *ex) {
+      errorReason = ex.reason;
+    }
+    if (nil == dismissButton) {
+      [FBLogger logFmt:@"Cannot find any match for Dismiss alert button using the class chain selector '%@'",
+       FBConfiguration.dismissAlertButtonSelector];
+      if (nil != errorReason) {
+        [FBLogger logFmt:@"Original error: %@", errorReason];
+      }
+      [FBLogger log:@"Will fallback to the default button location algorithm"];
+    }
+  }
+  if (nil == dismissButton) {
+    NSArray<XCUIElement *> *buttons = [self.alertElement.fb_query
+                                       descendantsMatchingType:XCUIElementTypeButton].allElementsBoundByIndex;
+    dismissButton = (alertSnapshot.elementType == XCUIElementTypeAlert || [self.class isSafariWebAlertWithSnapshot:alertSnapshot])
+      ? buttons.firstObject
+      : buttons.lastObject;
+  }
+
+  if (nil == dismissButton) {
+    return [[[FBErrorBuilder builder]
+        withDescriptionFormat:@"Failed to find dismiss button for alert: %@", self.alertElement]
+            buildError:error];
+  }
+  [dismissButton tap];
+  return YES;
+}
+
+- (BOOL)clickAlertButton:(NSString *)label error:(NSError **)error
+{
+  if (!self.isPresent) {
+    return [self notPresentWithError:error];
+  }
+
+  NSPredicate *predicate = [NSPredicate predicateWithFormat:@"label == %@", label];
+  XCUIElement *requestedButton = [[self.alertElement descendantsMatchingType:XCUIElementTypeButton]
+                                  matchingPredicate:predicate].allElementsBoundByIndex.firstObject;
+  if (!requestedButton) {
+    return [[[FBErrorBuilder builder]
+             withDescriptionFormat:@"Failed to find button with label '%@' for alert: %@", label, self.alertElement]
+            buildError:error];
+  }
+  [requestedButton tap];
+  return YES;
+}
+
+- (XCUIElement *)alertElement
+{
+  if (nil == self.element) {
+    XCUIApplication *systemApp = XCUIApplication.fb_systemApplication;
+    if ([systemApp fb_isSameAppAs:self.application]) {
+      self.element = systemApp.fb_alertElement;
+    } else {
+      self.element = systemApp.fb_alertElement ?: self.application.fb_alertElement;
+    }
+  }
+  return self.element;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Info.plist

@@ -0,0 +1,26 @@
+<?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>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleName</key>
+    <string>$(PRODUCT_NAME)</string>
+    <key>CFBundlePackageType</key>
+    <string>FMWK</string>
+    <key>CFBundleShortVersionString</key>
+    <string>11.1.3</string>
+    <key>CFBundleSignature</key>
+    <string>????</string>
+    <key>CFBundleVersion</key>
+    <string>11.1.3</string>
+    <key>NSPrincipalClass</key>
+    <string/>
+  </dict>
+</plist>

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Routing/FBCommandHandler.h

@@ -0,0 +1,38 @@
+/**
+ * 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 <Foundation/Foundation.h>
+
+#import <WebDriverAgentLib/FBCommandStatus.h>
+#import <WebDriverAgentLib/FBResponsePayload.h>
+#import <WebDriverAgentLib/FBRoute.h>
+#import <WebDriverAgentLib/FBResponsePayload.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Protocol for Classes to declare intent to implement responses to commands
+ */
+@protocol FBCommandHandler <NSObject>
+
+/**
+ * Should return map of FBRouteCommandHandler block with keys as supported routes
+ *
+ * @return map an NSArray<FBRoute *> of routes.
+ */
++ (NSArray *)routes;
+
+@optional
+/**
+ * @return BOOL deciding if class should be added to route handlers automatically, default (if not implemented) is YES
+ */
++ (BOOL)shouldRegisterAutomatically;
+
+@end
+
+NS_ASSUME_NONNULL_END