@deque/axe-appium3-webdriveragent 0.0.0-stage → 1.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (678) hide show
  1. package/Configurations/IOSSettings.xcconfig +31 -0
  2. package/Configurations/IOSTestSettings.xcconfig +1 -0
  3. package/Configurations/TVOSSettings.xcconfig +31 -0
  4. package/Configurations/TVOSTestSettings.xcconfig +1 -0
  5. package/LICENSE +66 -0
  6. package/LICENSE-3RD-PARTY.md +70 -0
  7. package/MySwiftFramework/JSONHelper.swift +31 -0
  8. package/MySwiftFramework/MySwiftFramework.h +18 -0
  9. package/PrivateHeaders/AccessibilityUtilities/AXSettings.h +15 -0
  10. package/PrivateHeaders/MobileCoreServices/LSApplicationWorkspace.h +127 -0
  11. package/PrivateHeaders/TextInput/TIPreferencesController.h +45 -0
  12. package/PrivateHeaders/UIKitCore/UIKeyboardImpl.h +27 -0
  13. package/PrivateHeaders/XCTest/CDStructures.h +7 -0
  14. package/PrivateHeaders/XCTest/NSFastEnumeration-Protocol.h +23 -0
  15. package/PrivateHeaders/XCTest/XCAXClient_iOS.h +91 -0
  16. package/PrivateHeaders/XCTest/XCApplicationQuery.h +30 -0
  17. package/PrivateHeaders/XCTest/XCDebugLogDelegate-Protocol.h +23 -0
  18. package/PrivateHeaders/XCTest/XCPointerEvent.h +63 -0
  19. package/PrivateHeaders/XCTest/XCPointerEventPath.h +65 -0
  20. package/PrivateHeaders/XCTest/XCSynthesizedEventRecord.h +55 -0
  21. package/PrivateHeaders/XCTest/XCTAggregateSuiteRunStatistics.h +38 -0
  22. package/PrivateHeaders/XCTest/XCTAttachmentManager.h +33 -0
  23. package/PrivateHeaders/XCTest/XCTCapabilities.h +35 -0
  24. package/PrivateHeaders/XCTest/XCTCapabilitiesProviding-Protocol.h +23 -0
  25. package/PrivateHeaders/XCTest/XCTElementSetTransformer-Protocol.h +35 -0
  26. package/PrivateHeaders/XCTest/XCTElementSnapshotAttributeDataSource-Protocol.h +33 -0
  27. package/PrivateHeaders/XCTest/XCTElementSnapshotProvider-Protocol.h +23 -0
  28. package/PrivateHeaders/XCTest/XCTExpectedFailureContextManager.h +35 -0
  29. package/PrivateHeaders/XCTest/XCTFuture.h +45 -0
  30. package/PrivateHeaders/XCTest/XCTHarnessEventReporting-Protocol.h +29 -0
  31. package/PrivateHeaders/XCTest/XCTIssue.h +49 -0
  32. package/PrivateHeaders/XCTest/XCTIssueHandling-Protocol.h +26 -0
  33. package/PrivateHeaders/XCTest/XCTMacCatalystStatusProviding-Protocol.h +23 -0
  34. package/PrivateHeaders/XCTest/XCTMeasureOptions.h +48 -0
  35. package/PrivateHeaders/XCTest/XCTMemoryChecker.h +50 -0
  36. package/PrivateHeaders/XCTest/XCTMemoryCheckerDelegate-Protocol.h +26 -0
  37. package/PrivateHeaders/XCTest/XCTMessagingChannel_IDEToRunner-Protocol.h +27 -0
  38. package/PrivateHeaders/XCTest/XCTMessagingChannel_RunnerToDaemon-Protocol.h +39 -0
  39. package/PrivateHeaders/XCTest/XCTMessagingChannel_RunnerToIDE-Protocol.h +32 -0
  40. package/PrivateHeaders/XCTest/XCTMessagingRole_ActivityReporting-Protocol.h +24 -0
  41. package/PrivateHeaders/XCTest/XCTMessagingRole_AttachmentFutureResultStatusUpdating-Protocol.h +23 -0
  42. package/PrivateHeaders/XCTest/XCTMessagingRole_BundleRequesting-Protocol.h +24 -0
  43. package/PrivateHeaders/XCTest/XCTMessagingRole_CapabilityExchange-Protocol.h +56 -0
  44. package/PrivateHeaders/XCTest/XCTMessagingRole_DebugLogging-Protocol.h +23 -0
  45. package/PrivateHeaders/XCTest/XCTMessagingRole_EventSynthesis-Protocol.h +34 -0
  46. package/PrivateHeaders/XCTest/XCTMessagingRole_ForcePressureSupportQuerying-Protocol.h +25 -0
  47. package/PrivateHeaders/XCTest/XCTMessagingRole_HIDEventRecording-Protocol.h +25 -0
  48. package/PrivateHeaders/XCTest/XCTMessagingRole_MemoryTesting-Protocol.h +23 -0
  49. package/PrivateHeaders/XCTest/XCTMessagingRole_PerformanceMeasurementReporting-Protocol.h +23 -0
  50. package/PrivateHeaders/XCTest/XCTMessagingRole_ProcessMonitoring-Protocol.h +25 -0
  51. package/PrivateHeaders/XCTest/XCTMessagingRole_ProtectedResourceAuthorization-Protocol.h +22 -0
  52. package/PrivateHeaders/XCTest/XCTMessagingRole_ScreenRecording-Protocol.h +24 -0
  53. package/PrivateHeaders/XCTest/XCTMessagingRole_SelfDiagnosisIssueReporting-Protocol.h +23 -0
  54. package/PrivateHeaders/XCTest/XCTMessagingRole_SignpostRequesting-Protocol.h +24 -0
  55. package/PrivateHeaders/XCTest/XCTMessagingRole_SiriAutomation-Protocol.h +27 -0
  56. package/PrivateHeaders/XCTest/XCTMessagingRole_SystemConfiguration-Protocol.h +27 -0
  57. package/PrivateHeaders/XCTest/XCTMessagingRole_TelemetrySending-Protocol.h +23 -0
  58. package/PrivateHeaders/XCTest/XCTMessagingRole_TestExecution-Protocol.h +28 -0
  59. package/PrivateHeaders/XCTest/XCTMessagingRole_TestReporting-Protocol.h +40 -0
  60. package/PrivateHeaders/XCTest/XCTMessagingRole_UIAutomation-Protocol.h +29 -0
  61. package/PrivateHeaders/XCTest/XCTMessagingRole_UIAutomationRunnerEventReporting-Protocol.h +27 -0
  62. package/PrivateHeaders/XCTest/XCTMessagingRole_UserPresence-Protocol.h +24 -0
  63. package/PrivateHeaders/XCTest/XCTMetricDiagnosticHelper.h +49 -0
  64. package/PrivateHeaders/XCTest/XCTNSPredicateExpectationObject-Protocol.h +23 -0
  65. package/PrivateHeaders/XCTest/XCTPromise.h +30 -0
  66. package/PrivateHeaders/XCTest/XCTRemoteSignpostListenerProxy-Protocol.h +29 -0
  67. package/PrivateHeaders/XCTest/XCTRepetitionPolicy.h +43 -0
  68. package/PrivateHeaders/XCTest/XCTReportingSession.h +50 -0
  69. package/PrivateHeaders/XCTest/XCTReportingSessionConfiguration-Protocol.h +27 -0
  70. package/PrivateHeaders/XCTest/XCTReportingSessionIssueReporter-Protocol.h +23 -0
  71. package/PrivateHeaders/XCTest/XCTReportingSessionTestContainer-Protocol.h +26 -0
  72. package/PrivateHeaders/XCTest/XCTReportingSessionTestReporter.h +51 -0
  73. package/PrivateHeaders/XCTest/XCTRunnerAutomationSession-Protocol.h +38 -0
  74. package/PrivateHeaders/XCTest/XCTRunnerDaemonSession.h +96 -0
  75. package/PrivateHeaders/XCTest/XCTRunnerDaemonSessionUIAutomationDelegate-Protocol.h +33 -0
  76. package/PrivateHeaders/XCTest/XCTRunnerIDESession.h +99 -0
  77. package/PrivateHeaders/XCTest/XCTRunnerIDESessionDelegate-Protocol.h +24 -0
  78. package/PrivateHeaders/XCTest/XCTRuntimeDiagnosticsPolicy.h +36 -0
  79. package/PrivateHeaders/XCTest/XCTRuntimeIssueDetectionPolicy.h +39 -0
  80. package/PrivateHeaders/XCTest/XCTScreenCapturePolicy.h +35 -0
  81. package/PrivateHeaders/XCTest/XCTSignpostListener-Protocol.h +25 -0
  82. package/PrivateHeaders/XCTest/XCTSkippedTestContext.h +37 -0
  83. package/PrivateHeaders/XCTest/XCTSourceCodeContext.h +39 -0
  84. package/PrivateHeaders/XCTest/XCTSourceCodeLocation.h +31 -0
  85. package/PrivateHeaders/XCTest/XCTTagSelection.h +41 -0
  86. package/PrivateHeaders/XCTest/XCTTestIdentifier.h +81 -0
  87. package/PrivateHeaders/XCTest/XCTTestIdentifierSet.h +54 -0
  88. package/PrivateHeaders/XCTest/XCTTestSelection.h +35 -0
  89. package/PrivateHeaders/XCTest/XCTWaiter.h +54 -0
  90. package/PrivateHeaders/XCTest/XCTWaiterManagement-Protocol.h +24 -0
  91. package/PrivateHeaders/XCTest/XCTWaiterManager-Protocol.h +25 -0
  92. package/PrivateHeaders/XCTest/XCTWaiterWait.h +40 -0
  93. package/PrivateHeaders/XCTest/XCTest.h +53 -0
  94. package/PrivateHeaders/XCTest/XCTestCase.h +180 -0
  95. package/PrivateHeaders/XCTest/XCTestCaseDiscoveryUIAutomationDelegate-Protocol.h +20 -0
  96. package/PrivateHeaders/XCTest/XCTestCaseRun.h +28 -0
  97. package/PrivateHeaders/XCTest/XCTestCaseUIAutomationDelegate-Protocol.h +25 -0
  98. package/PrivateHeaders/XCTest/XCTestCastMethodNamesUIAutomationDelegate-Protocol.h +24 -0
  99. package/PrivateHeaders/XCTest/XCTestConfiguration.h +94 -0
  100. package/PrivateHeaders/XCTest/XCTestDriver.h +64 -0
  101. package/PrivateHeaders/XCTest/XCTestExpectation.h +50 -0
  102. package/PrivateHeaders/XCTest/XCTestExpectationDelegate-Protocol.h +23 -0
  103. package/PrivateHeaders/XCTest/XCTestObservationCenter.h +60 -0
  104. package/PrivateHeaders/XCTest/XCTestRun.h +44 -0
  105. package/PrivateHeaders/XCTest/XCUIAXNotificationHandling-Protocol.h +25 -0
  106. package/PrivateHeaders/XCTest/XCUIAccessibilityInterface-Protocol.h +58 -0
  107. package/PrivateHeaders/XCTest/XCUIAlertMonitoring-Protocol.h +27 -0
  108. package/PrivateHeaders/XCTest/XCUIApplication.h +98 -0
  109. package/PrivateHeaders/XCTest/XCUIApplicationAutomationSessionProviding-Protocol.h +26 -0
  110. package/PrivateHeaders/XCTest/XCUIApplicationImpl.h +90 -0
  111. package/PrivateHeaders/XCTest/XCUIApplicationImplReporter-Protocol.h +26 -0
  112. package/PrivateHeaders/XCTest/XCUIApplicationManaging-Protocol.h +23 -0
  113. package/PrivateHeaders/XCTest/XCUIApplicationMonitor-Protocol.h +43 -0
  114. package/PrivateHeaders/XCTest/XCUIApplicationOpenRequest.h +34 -0
  115. package/PrivateHeaders/XCTest/XCUIApplicationPlatformServicesProviderDelegate-Protocol.h +25 -0
  116. package/PrivateHeaders/XCTest/XCUIApplicationProcess.h +105 -0
  117. package/PrivateHeaders/XCTest/XCUIApplicationProcessDelegate-Protocol.h +25 -0
  118. package/PrivateHeaders/XCTest/XCUIApplicationProcessManaging-Protocol.h +26 -0
  119. package/PrivateHeaders/XCTest/XCUIApplicationProcessTracker-Protocol.h +28 -0
  120. package/PrivateHeaders/XCTest/XCUIApplicationRegistry.h +32 -0
  121. package/PrivateHeaders/XCTest/XCUIButtonConsole.h +26 -0
  122. package/PrivateHeaders/XCTest/XCUICoordinate.h +49 -0
  123. package/PrivateHeaders/XCTest/XCUIDevice.h +134 -0
  124. package/PrivateHeaders/XCTest/XCUIDeviceAutomationModeInterface-Protocol.h +25 -0
  125. package/PrivateHeaders/XCTest/XCUIDeviceDelayedAttachmentTransferSupportInterface-Protocol.h +22 -0
  126. package/PrivateHeaders/XCTest/XCUIDeviceEventAndStateInterface-Protocol.h +40 -0
  127. package/PrivateHeaders/XCTest/XCUIElement.h +207 -0
  128. package/PrivateHeaders/XCTest/XCUIElementAttributesPrivate-Protocol.h +26 -0
  129. package/PrivateHeaders/XCTest/XCUIElementEventTarget-Protocol.h +38 -0
  130. package/PrivateHeaders/XCTest/XCUIElementQuery.h +166 -0
  131. package/PrivateHeaders/XCTest/XCUIElementTypeQueryProvider_Private-Protocol.h +24 -0
  132. package/PrivateHeaders/XCTest/XCUIEventRecording-Protocol.h +37 -0
  133. package/PrivateHeaders/XCTest/XCUIHitPointResult.h +25 -0
  134. package/PrivateHeaders/XCTest/XCUIInterruptionMonitoring-Protocol.h +27 -0
  135. package/PrivateHeaders/XCTest/XCUIIssueDiagnosticsProviding-Protocol.h +23 -0
  136. package/PrivateHeaders/XCTest/XCUIKnobControl.h +26 -0
  137. package/PrivateHeaders/XCTest/XCUILocation.h +24 -0
  138. package/PrivateHeaders/XCTest/XCUIPlatformApplicationServicesProviding-Protocol.h +33 -0
  139. package/PrivateHeaders/XCTest/XCUIRemoteAccessibilityInterface-Protocol.h +45 -0
  140. package/PrivateHeaders/XCTest/XCUIRemoteDeviceRunner-Protocol.h +24 -0
  141. package/PrivateHeaders/XCTest/XCUIRemoteSiriInterface-Protocol.h +30 -0
  142. package/PrivateHeaders/XCTest/XCUIResetAuthorizationStatusOfProtectedResourcesInterface-Protocol.h +22 -0
  143. package/PrivateHeaders/XCTest/XCUIScreen.h +53 -0
  144. package/PrivateHeaders/XCTest/XCUIScreenDataSource-Protocol.h +35 -0
  145. package/PrivateHeaders/XCTest/XCUISiriService.h +39 -0
  146. package/PrivateHeaders/XCTest/XCUISystem.h +26 -0
  147. package/PrivateHeaders/XCTest/XCUIXcodeApplicationManaging-Protocol.h +27 -0
  148. package/PrivateHeaders/XCTest/_TtC10XCTestCore19XCTReportingContext.h +26 -0
  149. package/PrivateHeaders/XCTest/_XCTMessaging_VoidProtocol-Protocol.h +20 -0
  150. package/PrivateHeaders/XCTest/_XCTestObservationInternal-Protocol.h +26 -0
  151. package/PrivateHeaders/XCTest/_XCTestObservationPrivate-Protocol.h +27 -0
  152. package/README.md +57 -2
  153. package/Scripts/build-webdriveragent.mjs +93 -0
  154. package/Scripts/build.sh +137 -0
  155. package/Scripts/bundle-mobile-assets.sh +35 -0
  156. package/Scripts/embed-runner-icon.sh +118 -0
  157. package/Scripts/fetch-prebuilt-wda.mjs +81 -0
  158. package/Scripts/update-wda-version.mjs +44 -0
  159. package/WebDriverAgent.xcodeproj/project.pbxproj +8522 -0
  160. package/WebDriverAgent.xcodeproj/project.xcworkspace/contents.xcworkspacedata +7 -0
  161. package/WebDriverAgent.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist +8 -0
  162. package/WebDriverAgent.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +5 -0
  163. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationApp.xcscheme +87 -0
  164. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationApp_tvOS.xcscheme +78 -0
  165. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationApp_watchOS.xcscheme +78 -0
  166. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationTests_1.xcscheme +93 -0
  167. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationTests_2.xcscheme +93 -0
  168. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationTests_3.xcscheme +93 -0
  169. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationTests_tvOS.xcscheme +93 -0
  170. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationTests_watchOS.xcscheme +93 -0
  171. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentLib.xcscheme +125 -0
  172. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentLib_tvOS.xcscheme +95 -0
  173. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentLib_watchOS.xcscheme +85 -0
  174. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner-nodebug.xcscheme +87 -0
  175. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner.xcscheme +132 -0
  176. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner_noauth.xcscheme +70 -0
  177. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner_tvOS.xcscheme +123 -0
  178. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner_watchOS.xcscheme +128 -0
  179. package/WebDriverAgentLib/Categories/FBXCElementSnapshotWrapper+Helpers.h +100 -0
  180. package/WebDriverAgentLib/Categories/FBXCElementSnapshotWrapper+Helpers.m +192 -0
  181. package/WebDriverAgentLib/Categories/NSDictionary+FBUtf8SafeDictionary.h +39 -0
  182. package/WebDriverAgentLib/Categories/NSDictionary+FBUtf8SafeDictionary.m +105 -0
  183. package/WebDriverAgentLib/Categories/NSExpression+FBFormat.h +29 -0
  184. package/WebDriverAgentLib/Categories/NSExpression+FBFormat.m +34 -0
  185. package/WebDriverAgentLib/Categories/NSString+FBVisualLength.h +18 -0
  186. package/WebDriverAgentLib/Categories/NSString+FBVisualLength.m +18 -0
  187. package/WebDriverAgentLib/Categories/NSString+FBXMLSafeString.h +27 -0
  188. package/WebDriverAgentLib/Categories/NSString+FBXMLSafeString.m +30 -0
  189. package/WebDriverAgentLib/Categories/XCAXClient_iOS+FBSnapshotReqParams.h +26 -0
  190. package/WebDriverAgentLib/Categories/XCAXClient_iOS+FBSnapshotReqParams.m +181 -0
  191. package/WebDriverAgentLib/Categories/XCTIssue+FBPatcher.h +17 -0
  192. package/WebDriverAgentLib/Categories/XCTIssue+FBPatcher.m +35 -0
  193. package/WebDriverAgentLib/Categories/XCUIApplication+FBAlert.h +47 -0
  194. package/WebDriverAgentLib/Categories/XCUIApplication+FBAlert.m +179 -0
  195. package/WebDriverAgentLib/Categories/XCUIApplication+FBFocused.h +23 -0
  196. package/WebDriverAgentLib/Categories/XCUIApplication+FBHelpers.h +186 -0
  197. package/WebDriverAgentLib/Categories/XCUIApplication+FBHelpers.m +674 -0
  198. package/WebDriverAgentLib/Categories/XCUIApplication+FBQuiescence.h +24 -0
  199. package/WebDriverAgentLib/Categories/XCUIApplication+FBQuiescence.m +28 -0
  200. package/WebDriverAgentLib/Categories/XCUIApplication+FBTouchAction.h +82 -0
  201. package/WebDriverAgentLib/Categories/XCUIApplication+FBTouchAction.m +198 -0
  202. package/WebDriverAgentLib/Categories/XCUIApplication+FBUIInterruptions.h +22 -0
  203. package/WebDriverAgentLib/Categories/XCUIApplication+FBUIInterruptions.m +31 -0
  204. package/WebDriverAgentLib/Categories/XCUIApplicationProcess+FBQuiescence.h +27 -0
  205. package/WebDriverAgentLib/Categories/XCUIApplicationProcess+FBQuiescence.m +111 -0
  206. package/WebDriverAgentLib/Categories/XCUIDevice+FBHealthCheck.h +30 -0
  207. package/WebDriverAgentLib/Categories/XCUIDevice+FBHealthCheck.m +47 -0
  208. package/WebDriverAgentLib/Categories/XCUIDevice+FBHelpers.h +236 -0
  209. package/WebDriverAgentLib/Categories/XCUIDevice+FBHelpers.m +478 -0
  210. package/WebDriverAgentLib/Categories/XCUIDevice+FBHinge.h +41 -0
  211. package/WebDriverAgentLib/Categories/XCUIDevice+FBHinge.m +215 -0
  212. package/WebDriverAgentLib/Categories/XCUIDevice+FBRotation.h +46 -0
  213. package/WebDriverAgentLib/Categories/XCUIDevice+FBRotation.m +108 -0
  214. package/WebDriverAgentLib/Categories/XCUIDevice+FBVoiceOver.h +66 -0
  215. package/WebDriverAgentLib/Categories/XCUIDevice+FBVoiceOver.m +218 -0
  216. package/WebDriverAgentLib/Categories/XCUIElement+FBAccessibility.h +29 -0
  217. package/WebDriverAgentLib/Categories/XCUIElement+FBAccessibility.m +50 -0
  218. package/WebDriverAgentLib/Categories/XCUIElement+FBCaching.h +19 -0
  219. package/WebDriverAgentLib/Categories/XCUIElement+FBCaching.m +36 -0
  220. package/WebDriverAgentLib/Categories/XCUIElement+FBClassChain.h +57 -0
  221. package/WebDriverAgentLib/Categories/XCUIElement+FBClassChain.m +239 -0
  222. package/WebDriverAgentLib/Categories/XCUIElement+FBCustomActions.h +27 -0
  223. package/WebDriverAgentLib/Categories/XCUIElement+FBCustomActions.m +127 -0
  224. package/WebDriverAgentLib/Categories/XCUIElement+FBFind.h +75 -0
  225. package/WebDriverAgentLib/Categories/XCUIElement+FBFind.m +146 -0
  226. package/WebDriverAgentLib/Categories/XCUIElement+FBForceTouch.h +38 -0
  227. package/WebDriverAgentLib/Categories/XCUIElement+FBForceTouch.m +55 -0
  228. package/WebDriverAgentLib/Categories/XCUIElement+FBIsVisible.h +28 -0
  229. package/WebDriverAgentLib/Categories/XCUIElement+FBIsVisible.m +78 -0
  230. package/WebDriverAgentLib/Categories/XCUIElement+FBMinMax.h +33 -0
  231. package/WebDriverAgentLib/Categories/XCUIElement+FBMinMax.m +75 -0
  232. package/WebDriverAgentLib/Categories/XCUIElement+FBPickerWheel.h +45 -0
  233. package/WebDriverAgentLib/Categories/XCUIElement+FBPickerWheel.m +59 -0
  234. package/WebDriverAgentLib/Categories/XCUIElement+FBResolve.h +37 -0
  235. package/WebDriverAgentLib/Categories/XCUIElement+FBResolve.m +51 -0
  236. package/WebDriverAgentLib/Categories/XCUIElement+FBScrolling.h +98 -0
  237. package/WebDriverAgentLib/Categories/XCUIElement+FBScrolling.m +465 -0
  238. package/WebDriverAgentLib/Categories/XCUIElement+FBSwiping.h +38 -0
  239. package/WebDriverAgentLib/Categories/XCUIElement+FBSwiping.m +56 -0
  240. package/WebDriverAgentLib/Categories/XCUIElement+FBTVFocuse.h +35 -0
  241. package/WebDriverAgentLib/Categories/XCUIElement+FBTVFocuse.m +71 -0
  242. package/WebDriverAgentLib/Categories/XCUIElement+FBTyping.h +97 -0
  243. package/WebDriverAgentLib/Categories/XCUIElement+FBTyping.m +233 -0
  244. package/WebDriverAgentLib/Categories/XCUIElement+FBUID.h +42 -0
  245. package/WebDriverAgentLib/Categories/XCUIElement+FBUID.m +85 -0
  246. package/WebDriverAgentLib/Categories/XCUIElement+FBUtilities.h +108 -0
  247. package/WebDriverAgentLib/Categories/XCUIElement+FBUtilities.m +175 -0
  248. package/WebDriverAgentLib/Categories/XCUIElement+FBVisibleFrame.h +35 -0
  249. package/WebDriverAgentLib/Categories/XCUIElement+FBVisibleFrame.m +61 -0
  250. package/WebDriverAgentLib/Categories/XCUIElement+FBWebDriverAttributes.h +32 -0
  251. package/WebDriverAgentLib/Categories/XCUIElement+FBWebDriverAttributes.m +299 -0
  252. package/WebDriverAgentLib/Categories/XCUIElementQuery+FBHelpers.h +28 -0
  253. package/WebDriverAgentLib/Categories/XCUIElementQuery+FBHelpers.m +47 -0
  254. package/WebDriverAgentLib/Commands/AxeAuthCommands.h +30 -0
  255. package/WebDriverAgentLib/Commands/AxeAuthCommands.m +175 -0
  256. package/WebDriverAgentLib/Commands/AxeAutoScanCommands.h +19 -0
  257. package/WebDriverAgentLib/Commands/AxeAutoScanCommands.m +143 -0
  258. package/WebDriverAgentLib/Commands/AxeProductDeclaration.h +21 -0
  259. package/WebDriverAgentLib/Commands/AxeProductDeclaration.m +40 -0
  260. package/WebDriverAgentLib/Commands/AxeReportCommands.h +20 -0
  261. package/WebDriverAgentLib/Commands/AxeReportCommands.m +62 -0
  262. package/WebDriverAgentLib/Commands/AxeScanCommands.h +20 -0
  263. package/WebDriverAgentLib/Commands/AxeScanCommands.m +386 -0
  264. package/WebDriverAgentLib/Commands/AxeUsageCommands.h +27 -0
  265. package/WebDriverAgentLib/Commands/AxeUsageCommands.m +90 -0
  266. package/WebDriverAgentLib/Commands/FBAlertViewCommands.h +19 -0
  267. package/WebDriverAgentLib/Commands/FBAlertViewCommands.m +104 -0
  268. package/WebDriverAgentLib/Commands/FBCustomCommands.h +19 -0
  269. package/WebDriverAgentLib/Commands/FBCustomCommands.m +848 -0
  270. package/WebDriverAgentLib/Commands/FBDebugCommands.h +19 -0
  271. package/WebDriverAgentLib/Commands/FBDebugCommands.m +81 -0
  272. package/WebDriverAgentLib/Commands/FBElementCommands.h +19 -0
  273. package/WebDriverAgentLib/Commands/FBElementCommands.m +775 -0
  274. package/WebDriverAgentLib/Commands/FBFindElementCommands.h +18 -0
  275. package/WebDriverAgentLib/Commands/FBFindElementCommands.m +186 -0
  276. package/WebDriverAgentLib/Commands/FBOrientationCommands.h +19 -0
  277. package/WebDriverAgentLib/Commands/FBOrientationCommands.m +192 -0
  278. package/WebDriverAgentLib/Commands/FBScreenshotCommands.h +19 -0
  279. package/WebDriverAgentLib/Commands/FBScreenshotCommands.m +40 -0
  280. package/WebDriverAgentLib/Commands/FBSessionCommands.h +19 -0
  281. package/WebDriverAgentLib/Commands/FBSessionCommands.m +519 -0
  282. package/WebDriverAgentLib/Commands/FBTouchActionCommands.h +19 -0
  283. package/WebDriverAgentLib/Commands/FBTouchActionCommands.m +41 -0
  284. package/WebDriverAgentLib/Commands/FBTouchIDCommands.h +19 -0
  285. package/WebDriverAgentLib/Commands/FBTouchIDCommands.m +30 -0
  286. package/WebDriverAgentLib/Commands/FBUnknownCommands.h +19 -0
  287. package/WebDriverAgentLib/Commands/FBUnknownCommands.m +39 -0
  288. package/WebDriverAgentLib/Commands/FBVideoCommands.h +19 -0
  289. package/WebDriverAgentLib/Commands/FBVideoCommands.m +84 -0
  290. package/WebDriverAgentLib/FBAlert.h +104 -0
  291. package/WebDriverAgentLib/FBAlert.m +454 -0
  292. package/WebDriverAgentLib/Info.plist +26 -0
  293. package/WebDriverAgentLib/Routing/FBCommandHandler.h +38 -0
  294. package/WebDriverAgentLib/Routing/FBCommandStatus.h +80 -0
  295. package/WebDriverAgentLib/Routing/FBCommandStatus.m +279 -0
  296. package/WebDriverAgentLib/Routing/FBElement.h +98 -0
  297. package/WebDriverAgentLib/Routing/FBElementCache.h +61 -0
  298. package/WebDriverAgentLib/Routing/FBElementCache.m +100 -0
  299. package/WebDriverAgentLib/Routing/FBElementUtils.h +76 -0
  300. package/WebDriverAgentLib/Routing/FBElementUtils.m +153 -0
  301. package/WebDriverAgentLib/Routing/FBExceptionHandler.h +29 -0
  302. package/WebDriverAgentLib/Routing/FBExceptionHandler.m +65 -0
  303. package/WebDriverAgentLib/Routing/FBExceptions.h +69 -0
  304. package/WebDriverAgentLib/Routing/FBExceptions.m +27 -0
  305. package/WebDriverAgentLib/Routing/FBHTTPServer.h +97 -0
  306. package/WebDriverAgentLib/Routing/FBHTTPServer.m +955 -0
  307. package/WebDriverAgentLib/Routing/FBHTTPStatusCodes.h +581 -0
  308. package/WebDriverAgentLib/Routing/FBResponseJSONPayload.h +29 -0
  309. package/WebDriverAgentLib/Routing/FBResponseJSONPayload.m +58 -0
  310. package/WebDriverAgentLib/Routing/FBResponsePayload.h +74 -0
  311. package/WebDriverAgentLib/Routing/FBResponsePayload.m +148 -0
  312. package/WebDriverAgentLib/Routing/FBRoute.h +86 -0
  313. package/WebDriverAgentLib/Routing/FBRoute.m +183 -0
  314. package/WebDriverAgentLib/Routing/FBRouteRequest-Private.h +20 -0
  315. package/WebDriverAgentLib/Routing/FBRouteRequest.h +39 -0
  316. package/WebDriverAgentLib/Routing/FBRouteRequest.m +32 -0
  317. package/WebDriverAgentLib/Routing/FBScreenRecordingContainer.h +65 -0
  318. package/WebDriverAgentLib/Routing/FBScreenRecordingContainer.m +88 -0
  319. package/WebDriverAgentLib/Routing/FBScreenRecordingPromise.h +29 -0
  320. package/WebDriverAgentLib/Routing/FBScreenRecordingPromise.m +31 -0
  321. package/WebDriverAgentLib/Routing/FBScreenRecordingRequest.h +39 -0
  322. package/WebDriverAgentLib/Routing/FBScreenRecordingRequest.m +99 -0
  323. package/WebDriverAgentLib/Routing/FBSession-Private.h +26 -0
  324. package/WebDriverAgentLib/Routing/FBSession.h +179 -0
  325. package/WebDriverAgentLib/Routing/FBSession.m +575 -0
  326. package/WebDriverAgentLib/Routing/FBTCPSocket.h +117 -0
  327. package/WebDriverAgentLib/Routing/FBTCPSocket.m +244 -0
  328. package/WebDriverAgentLib/Routing/FBWebServer.h +68 -0
  329. package/WebDriverAgentLib/Routing/FBWebServer.m +306 -0
  330. package/WebDriverAgentLib/Routing/FBXCAccessibilityElement.h +34 -0
  331. package/WebDriverAgentLib/Routing/FBXCAccessibilityElement.m +17 -0
  332. package/WebDriverAgentLib/Routing/FBXCDeviceEvent.h +34 -0
  333. package/WebDriverAgentLib/Routing/FBXCDeviceEvent.m +42 -0
  334. package/WebDriverAgentLib/Routing/FBXCElementSnapshot.h +82 -0
  335. package/WebDriverAgentLib/Routing/FBXCElementSnapshot.m +9 -0
  336. package/WebDriverAgentLib/Routing/FBXCElementSnapshotWrapper.h +29 -0
  337. package/WebDriverAgentLib/Routing/FBXCElementSnapshotWrapper.m +114 -0
  338. package/WebDriverAgentLib/Routing/RouteRequest.h +28 -0
  339. package/WebDriverAgentLib/Routing/RouteRequest.m +25 -0
  340. package/WebDriverAgentLib/Routing/RouteResponse.h +30 -0
  341. package/WebDriverAgentLib/Routing/RouteResponse.m +54 -0
  342. package/WebDriverAgentLib/Utilities/FBAccessibilityTraits.h +20 -0
  343. package/WebDriverAgentLib/Utilities/FBAccessibilityTraits.m +61 -0
  344. package/WebDriverAgentLib/Utilities/FBActiveAppDetectionPoint.h +56 -0
  345. package/WebDriverAgentLib/Utilities/FBActiveAppDetectionPoint.m +115 -0
  346. package/WebDriverAgentLib/Utilities/FBAlertsMonitor.h +51 -0
  347. package/WebDriverAgentLib/Utilities/FBAlertsMonitor.m +110 -0
  348. package/WebDriverAgentLib/Utilities/FBBaseActionsSynthesizer.h +132 -0
  349. package/WebDriverAgentLib/Utilities/FBBaseActionsSynthesizer.m +165 -0
  350. package/WebDriverAgentLib/Utilities/FBCapabilities.h +43 -0
  351. package/WebDriverAgentLib/Utilities/FBCapabilities.m +24 -0
  352. package/WebDriverAgentLib/Utilities/FBClassChainQueryParser.h +99 -0
  353. package/WebDriverAgentLib/Utilities/FBClassChainQueryParser.m +666 -0
  354. package/WebDriverAgentLib/Utilities/FBConfiguration.h +379 -0
  355. package/WebDriverAgentLib/Utilities/FBConfiguration.m +476 -0
  356. package/WebDriverAgentLib/Utilities/FBDebugLogDelegateDecorator.h +26 -0
  357. package/WebDriverAgentLib/Utilities/FBDebugLogDelegateDecorator.m +49 -0
  358. package/WebDriverAgentLib/Utilities/FBElementHelpers.h +29 -0
  359. package/WebDriverAgentLib/Utilities/FBElementHelpers.m +21 -0
  360. package/WebDriverAgentLib/Utilities/FBElementTypeTransformer.h +45 -0
  361. package/WebDriverAgentLib/Utilities/FBElementTypeTransformer.m +149 -0
  362. package/WebDriverAgentLib/Utilities/FBErrorBuilder.h +64 -0
  363. package/WebDriverAgentLib/Utilities/FBErrorBuilder.m +75 -0
  364. package/WebDriverAgentLib/Utilities/FBFailureProofTestCase.h +19 -0
  365. package/WebDriverAgentLib/Utilities/FBFailureProofTestCase.m +74 -0
  366. package/WebDriverAgentLib/Utilities/FBImageProcessor.h +55 -0
  367. package/WebDriverAgentLib/Utilities/FBImageProcessor.m +197 -0
  368. package/WebDriverAgentLib/Utilities/FBImageUtils.h +25 -0
  369. package/WebDriverAgentLib/Utilities/FBImageUtils.m +80 -0
  370. package/WebDriverAgentLib/Utilities/FBKeyboard.h +37 -0
  371. package/WebDriverAgentLib/Utilities/FBKeyboard.m +123 -0
  372. package/WebDriverAgentLib/Utilities/FBLogger.h +32 -0
  373. package/WebDriverAgentLib/Utilities/FBLogger.m +47 -0
  374. package/WebDriverAgentLib/Utilities/FBMacros.h +66 -0
  375. package/WebDriverAgentLib/Utilities/FBMathUtils.h +100 -0
  376. package/WebDriverAgentLib/Utilities/FBMathUtils.m +147 -0
  377. package/WebDriverAgentLib/Utilities/FBMjpegServer.h +36 -0
  378. package/WebDriverAgentLib/Utilities/FBMjpegServer.m +248 -0
  379. package/WebDriverAgentLib/Utilities/FBNotificationsHelper.h +37 -0
  380. package/WebDriverAgentLib/Utilities/FBNotificationsHelper.m +29 -0
  381. package/WebDriverAgentLib/Utilities/FBPasteboard.h +40 -0
  382. package/WebDriverAgentLib/Utilities/FBPasteboard.m +176 -0
  383. package/WebDriverAgentLib/Utilities/FBProtocolHelpers.h +46 -0
  384. package/WebDriverAgentLib/Utilities/FBProtocolHelpers.m +144 -0
  385. package/WebDriverAgentLib/Utilities/FBReflectionUtils.h +23 -0
  386. package/WebDriverAgentLib/Utilities/FBReflectionUtils.m +31 -0
  387. package/WebDriverAgentLib/Utilities/FBRunLoopSpinner.h +77 -0
  388. package/WebDriverAgentLib/Utilities/FBRunLoopSpinner.m +94 -0
  389. package/WebDriverAgentLib/Utilities/FBRuntimeUtils.h +79 -0
  390. package/WebDriverAgentLib/Utilities/FBRuntimeUtils.m +112 -0
  391. package/WebDriverAgentLib/Utilities/FBScreen.h +49 -0
  392. package/WebDriverAgentLib/Utilities/FBScreen.m +128 -0
  393. package/WebDriverAgentLib/Utilities/FBScreenshot.h +44 -0
  394. package/WebDriverAgentLib/Utilities/FBScreenshot.m +231 -0
  395. package/WebDriverAgentLib/Utilities/FBSettings.h +51 -0
  396. package/WebDriverAgentLib/Utilities/FBSettings.m +45 -0
  397. package/WebDriverAgentLib/Utilities/FBSettingsHandler.h +35 -0
  398. package/WebDriverAgentLib/Utilities/FBSettingsHandler.m +398 -0
  399. package/WebDriverAgentLib/Utilities/FBTVNavigationTracker-Private.h +37 -0
  400. package/WebDriverAgentLib/Utilities/FBTVNavigationTracker.h +77 -0
  401. package/WebDriverAgentLib/Utilities/FBTVNavigationTracker.m +177 -0
  402. package/WebDriverAgentLib/Utilities/FBUnattachedAppLauncher.h +26 -0
  403. package/WebDriverAgentLib/Utilities/FBUnattachedAppLauncher.m +21 -0
  404. package/WebDriverAgentLib/Utilities/FBW3CActionsHelpers.h +42 -0
  405. package/WebDriverAgentLib/Utilities/FBW3CActionsHelpers.m +119 -0
  406. package/WebDriverAgentLib/Utilities/FBW3CActionsSynthesizer.h +19 -0
  407. package/WebDriverAgentLib/Utilities/FBW3CActionsSynthesizer.m +1011 -0
  408. package/WebDriverAgentLib/Utilities/FBWebServerParams.h +22 -0
  409. package/WebDriverAgentLib/Utilities/FBWebServerParams.m +23 -0
  410. package/WebDriverAgentLib/Utilities/FBXCAXClientProxy.h +171 -0
  411. package/WebDriverAgentLib/Utilities/FBXCAXClientProxy.m +240 -0
  412. package/WebDriverAgentLib/Utilities/FBXCTestDaemonsProxy.h +45 -0
  413. package/WebDriverAgentLib/Utilities/FBXCTestDaemonsProxy.m +362 -0
  414. package/WebDriverAgentLib/Utilities/FBXCodeCompatibility.h +73 -0
  415. package/WebDriverAgentLib/Utilities/FBXCodeCompatibility.m +129 -0
  416. package/WebDriverAgentLib/Utilities/FBXMLGenerationOptions.h +45 -0
  417. package/WebDriverAgentLib/Utilities/FBXMLGenerationOptions.m +25 -0
  418. package/WebDriverAgentLib/Utilities/FBXPath-Private.h +61 -0
  419. package/WebDriverAgentLib/Utilities/FBXPath.h +59 -0
  420. package/WebDriverAgentLib/Utilities/FBXPath.m +1087 -0
  421. package/WebDriverAgentLib/Utilities/FBXPathExtensions.h +40 -0
  422. package/WebDriverAgentLib/Utilities/FBXPathExtensions.m +418 -0
  423. package/WebDriverAgentLib/Utilities/LRUCache/LRUCache.h +66 -0
  424. package/WebDriverAgentLib/Utilities/LRUCache/LRUCache.m +149 -0
  425. package/WebDriverAgentLib/Utilities/LRUCache/LRUCacheNode.h +43 -0
  426. package/WebDriverAgentLib/Utilities/LRUCache/LRUCacheNode.m +51 -0
  427. package/WebDriverAgentLib/Utilities/NSPredicate+FBFormat.h +42 -0
  428. package/WebDriverAgentLib/Utilities/NSPredicate+FBFormat.m +69 -0
  429. package/WebDriverAgentLib/Utilities/XCTestPrivateSymbols.h +78 -0
  430. package/WebDriverAgentLib/Utilities/XCTestPrivateSymbols.m +127 -0
  431. package/WebDriverAgentLib/Utilities/XCUIApplicationProcessDelay.h +37 -0
  432. package/WebDriverAgentLib/Utilities/XCUIApplicationProcessDelay.m +83 -0
  433. package/WebDriverAgentLib/WebDriverAgentLib.h +61 -0
  434. package/WebDriverAgentRunner/Assets.xcassets/AppIcon.appiconset/Contents.json +14 -0
  435. package/WebDriverAgentRunner/Assets.xcassets/AppIcon.appiconset/icon-1024.png +0 -0
  436. package/WebDriverAgentRunner/Assets.xcassets/Contents.json +6 -0
  437. package/WebDriverAgentRunner/Info.plist +30 -0
  438. package/WebDriverAgentRunner/UITestingUITests.m +58 -0
  439. package/WebDriverAgentTests/IntegrationApp/COORDINATE_PROBE.md +52 -0
  440. package/WebDriverAgentTests/IntegrationApp/Classes/AppDelegate.h +14 -0
  441. package/WebDriverAgentTests/IntegrationApp/Classes/AppDelegate.m +38 -0
  442. package/WebDriverAgentTests/IntegrationApp/Classes/FBAlertViewController.h +14 -0
  443. package/WebDriverAgentTests/IntegrationApp/Classes/FBAlertViewController.m +82 -0
  444. package/WebDriverAgentTests/IntegrationApp/Classes/FBCoordinateProbeViewController.h +4 -0
  445. package/WebDriverAgentTests/IntegrationApp/Classes/FBCoordinateProbeViewController.m +194 -0
  446. package/WebDriverAgentTests/IntegrationApp/Classes/FBNavigationController.h +12 -0
  447. package/WebDriverAgentTests/IntegrationApp/Classes/FBNavigationController.m +25 -0
  448. package/WebDriverAgentTests/IntegrationApp/Classes/FBScrollViewController.h +13 -0
  449. package/WebDriverAgentTests/IntegrationApp/Classes/FBScrollViewController.m +52 -0
  450. package/WebDriverAgentTests/IntegrationApp/Classes/FBTableDataSource.h +16 -0
  451. package/WebDriverAgentTests/IntegrationApp/Classes/FBTableDataSource.m +35 -0
  452. package/WebDriverAgentTests/IntegrationApp/Classes/SceneDelegate.h +20 -0
  453. package/WebDriverAgentTests/IntegrationApp/Classes/SceneDelegate.m +81 -0
  454. package/WebDriverAgentTests/IntegrationApp/Classes/TouchSpotView.h +17 -0
  455. package/WebDriverAgentTests/IntegrationApp/Classes/TouchSpotView.m +28 -0
  456. package/WebDriverAgentTests/IntegrationApp/Classes/TouchViewController.h +23 -0
  457. package/WebDriverAgentTests/IntegrationApp/Classes/TouchViewController.m +29 -0
  458. package/WebDriverAgentTests/IntegrationApp/Classes/TouchableView.h +30 -0
  459. package/WebDriverAgentTests/IntegrationApp/Classes/TouchableView.m +119 -0
  460. package/WebDriverAgentTests/IntegrationApp/Classes/ViewController.h +12 -0
  461. package/WebDriverAgentTests/IntegrationApp/Classes/ViewController.m +144 -0
  462. package/WebDriverAgentTests/IntegrationApp/Info.plist +71 -0
  463. package/WebDriverAgentTests/IntegrationApp/Resources/Base.lproj/Main.storyboard +650 -0
  464. package/WebDriverAgentTests/IntegrationApp/main.m +15 -0
  465. package/WebDriverAgentTests/IntegrationApp_tvOS/AppDelegate.h +13 -0
  466. package/WebDriverAgentTests/IntegrationApp_tvOS/AppDelegate.m +26 -0
  467. package/WebDriverAgentTests/IntegrationApp_tvOS/Info.plist +41 -0
  468. package/WebDriverAgentTests/IntegrationApp_tvOS/SceneDelegate.h +15 -0
  469. package/WebDriverAgentTests/IntegrationApp_tvOS/SceneDelegate.m +22 -0
  470. package/WebDriverAgentTests/IntegrationApp_tvOS/ViewController.h +13 -0
  471. package/WebDriverAgentTests/IntegrationApp_tvOS/ViewController.m +79 -0
  472. package/WebDriverAgentTests/IntegrationApp_tvOS/main.m +17 -0
  473. package/WebDriverAgentTests/IntegrationApp_watchOS/ContentView.swift +31 -0
  474. package/WebDriverAgentTests/IntegrationApp_watchOS/WatchSpikeApp.swift +18 -0
  475. package/WebDriverAgentTests/IntegrationTests/FBAlertTests.m +175 -0
  476. package/WebDriverAgentTests/IntegrationTests/FBAutoAlertsHandlerTests.m +79 -0
  477. package/WebDriverAgentTests/IntegrationTests/FBConfigurationTests.m +123 -0
  478. package/WebDriverAgentTests/IntegrationTests/FBDisplayGestureTests.m +541 -0
  479. package/WebDriverAgentTests/IntegrationTests/FBElementAttributeTests.m +273 -0
  480. package/WebDriverAgentTests/IntegrationTests/FBElementSwipingTests.m +222 -0
  481. package/WebDriverAgentTests/IntegrationTests/FBElementVisibilityTests.m +68 -0
  482. package/WebDriverAgentTests/IntegrationTests/FBFailureProofTestCaseTests.m +41 -0
  483. package/WebDriverAgentTests/IntegrationTests/FBForceTouchTests.m +88 -0
  484. package/WebDriverAgentTests/IntegrationTests/FBImageProcessorTests.m +116 -0
  485. package/WebDriverAgentTests/IntegrationTests/FBIntegrationAppTests.m +87 -0
  486. package/WebDriverAgentTests/IntegrationTests/FBIntegrationTestCase.h +101 -0
  487. package/WebDriverAgentTests/IntegrationTests/FBIntegrationTestCase.m +176 -0
  488. package/WebDriverAgentTests/IntegrationTests/FBKeyboardTests.m +61 -0
  489. package/WebDriverAgentTests/IntegrationTests/FBPasteboardTests.m +92 -0
  490. package/WebDriverAgentTests/IntegrationTests/FBPickerWheelSelectTests.m +55 -0
  491. package/WebDriverAgentTests/IntegrationTests/FBSafariAlertTests.m +77 -0
  492. package/WebDriverAgentTests/IntegrationTests/FBScreenTests.m +450 -0
  493. package/WebDriverAgentTests/IntegrationTests/FBScrollingTests.m +123 -0
  494. package/WebDriverAgentTests/IntegrationTests/FBSessionIntegrationTests.m +228 -0
  495. package/WebDriverAgentTests/IntegrationTests/FBTapTest.m +186 -0
  496. package/WebDriverAgentTests/IntegrationTests/FBTestMacros.h +33 -0
  497. package/WebDriverAgentTests/IntegrationTests/FBTypingTest.m +68 -0
  498. package/WebDriverAgentTests/IntegrationTests/FBVideoRecordingTests.m +63 -0
  499. package/WebDriverAgentTests/IntegrationTests/FBVoiceOverTests.m +103 -0
  500. package/WebDriverAgentTests/IntegrationTests/FBW3CMultiTouchActionsIntegrationTests.m +159 -0
  501. package/WebDriverAgentTests/IntegrationTests/FBW3CTouchActionsIntegrationTests.m +700 -0
  502. package/WebDriverAgentTests/IntegrationTests/FBW3CTypeActionsTests.m +184 -0
  503. package/WebDriverAgentTests/IntegrationTests/FBXPathIntegrationTests.m +260 -0
  504. package/WebDriverAgentTests/IntegrationTests/Info.plist +24 -0
  505. package/WebDriverAgentTests/IntegrationTests/XCElementSnapshotHelperTests.m +205 -0
  506. package/WebDriverAgentTests/IntegrationTests/XCElementSnapshotHitPointTests.m +30 -0
  507. package/WebDriverAgentTests/IntegrationTests/XCUIApplicationHelperTests.m +162 -0
  508. package/WebDriverAgentTests/IntegrationTests/XCUIDeviceHealthCheckTests.m +27 -0
  509. package/WebDriverAgentTests/IntegrationTests/XCUIDeviceHelperTests.m +236 -0
  510. package/WebDriverAgentTests/IntegrationTests/XCUIDeviceRotationTests.m +105 -0
  511. package/WebDriverAgentTests/IntegrationTests/XCUIElementAttributesTests.m +248 -0
  512. package/WebDriverAgentTests/IntegrationTests/XCUIElementFBFindTests.m +673 -0
  513. package/WebDriverAgentTests/IntegrationTests/XCUIElementHelperIntegrationTests.m +51 -0
  514. package/WebDriverAgentTests/IntegrationTests_tvOS/FBTVFocusIntegrationTests.m +84 -0
  515. package/WebDriverAgentTests/IntegrationTests_tvOS/Info.plist +24 -0
  516. package/WebDriverAgentTests/IntegrationTests_watchOS/IntegrationTests_watchOS-Bridging-Header.h +23 -0
  517. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAAlertIntegrationTests.swift +25 -0
  518. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAAppLifecycleIntegrationTests.swift +37 -0
  519. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAClickIntegrationTests.swift +25 -0
  520. package/WebDriverAgentTests/IntegrationTests_watchOS/WDADeviceIntegrationTests.swift +92 -0
  521. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAElementAttributeIntegrationTests.swift +39 -0
  522. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAFindIntegrationTests.swift +101 -0
  523. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAMjpegStreamingIntegrationTests.swift +81 -0
  524. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAScreenshotAndSourceIntegrationTests.swift +54 -0
  525. package/WebDriverAgentTests/IntegrationTests_watchOS/WDATypingIntegrationTests.swift +73 -0
  526. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAWatchInProcessTestCase.swift +51 -0
  527. package/WebDriverAgentTests/UnitTests/Doubles/XCElementSnapshotDouble.h +16 -0
  528. package/WebDriverAgentTests/UnitTests/Doubles/XCElementSnapshotDouble.m +110 -0
  529. package/WebDriverAgentTests/UnitTests/Doubles/XCUIApplicationDouble.h +17 -0
  530. package/WebDriverAgentTests/UnitTests/Doubles/XCUIApplicationDouble.m +66 -0
  531. package/WebDriverAgentTests/UnitTests/Doubles/XCUIElementDouble.h +55 -0
  532. package/WebDriverAgentTests/UnitTests/Doubles/XCUIElementDouble.m +114 -0
  533. package/WebDriverAgentTests/UnitTests/FBClassChainTests.m +313 -0
  534. package/WebDriverAgentTests/UnitTests/FBConfigurationTests.m +72 -0
  535. package/WebDriverAgentTests/UnitTests/FBCustomCommandsTests.m +144 -0
  536. package/WebDriverAgentTests/UnitTests/FBElementCacheTests.m +124 -0
  537. package/WebDriverAgentTests/UnitTests/FBElementTypeTransformerTests.m +45 -0
  538. package/WebDriverAgentTests/UnitTests/FBElementUtilitiesTests.m +76 -0
  539. package/WebDriverAgentTests/UnitTests/FBErrorBuilderTests.m +61 -0
  540. package/WebDriverAgentTests/UnitTests/FBExceptionHandlerTests.m +59 -0
  541. package/WebDriverAgentTests/UnitTests/FBHTTPServerSessionTests.m +151 -0
  542. package/WebDriverAgentTests/UnitTests/FBHTTPServerTests.m +458 -0
  543. package/WebDriverAgentTests/UnitTests/FBLRUCacheTests.m +161 -0
  544. package/WebDriverAgentTests/UnitTests/FBMathUtilsTests.m +196 -0
  545. package/WebDriverAgentTests/UnitTests/FBProtocolHelpersTests.m +81 -0
  546. package/WebDriverAgentTests/UnitTests/FBResponseJSONPayloadTests.m +76 -0
  547. package/WebDriverAgentTests/UnitTests/FBRouteTests.m +129 -0
  548. package/WebDriverAgentTests/UnitTests/FBRunLoopSpinnerTests.m +98 -0
  549. package/WebDriverAgentTests/UnitTests/FBRuntimeUtilsTests.m +45 -0
  550. package/WebDriverAgentTests/UnitTests/FBSDKVersionTests.m +66 -0
  551. package/WebDriverAgentTests/UnitTests/FBSessionTests.m +268 -0
  552. package/WebDriverAgentTests/UnitTests/FBTouchableViewTests.m +121 -0
  553. package/WebDriverAgentTests/UnitTests/FBXCAXClientProxyTests.m +90 -0
  554. package/WebDriverAgentTests/UnitTests/FBXMLSafeStringTests.m +35 -0
  555. package/WebDriverAgentTests/UnitTests/FBXPathTests.m +381 -0
  556. package/WebDriverAgentTests/UnitTests/Info.plist +24 -0
  557. package/WebDriverAgentTests/UnitTests/NSDictionaryFBUtf8SafeTests.m +77 -0
  558. package/WebDriverAgentTests/UnitTests/NSExpressionFBFormatTests.m +60 -0
  559. package/WebDriverAgentTests/UnitTests/NSPredicateFBFormatTests.m +72 -0
  560. package/WebDriverAgentTests/UnitTests/XCUIElementHelpersTests.m +50 -0
  561. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/FBXCAccessibilityElementDouble.h +27 -0
  562. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/FBXCAccessibilityElementDouble.m +23 -0
  563. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/FBXCElementSnapshotDouble.h +43 -0
  564. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/FBXCElementSnapshotDouble.m +24 -0
  565. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/XCUIElementDouble.h +47 -0
  566. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/XCUIElementDouble.m +81 -0
  567. package/WebDriverAgentTests/UnitTests_tvOS/FBTVNavigationTrackerTests.m +134 -0
  568. package/WebDriverAgentTests/UnitTests_tvOS/Info.plist +24 -0
  569. package/axeDevToolsXCUI.xcframework/Info.plist +50 -0
  570. package/axeDevToolsXCUI.xcframework/LICENSE-3RD-PARTY-axe-devtools-ios.md +29 -0
  571. package/axeDevToolsXCUI.xcframework/axe-devtools-ios-4.3.1.cdx.json +75 -0
  572. package/axeDevToolsXCUI.xcframework/axe-devtools-ios-4.3.1.spdx.json +67 -0
  573. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/HTMLReportTemplate.html +1912 -0
  574. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Headers/AxeTestBundleObserver.h +55 -0
  575. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Headers/axeDevToolsXCUI-Swift.h +1546 -0
  576. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Headers/axeDevToolsXCUI.h +17 -0
  577. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Info.plist +57 -0
  578. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/LICENSE.md +7 -0
  579. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios.abi.json +34308 -0
  580. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios.private.swiftinterface +927 -0
  581. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios.swiftdoc +0 -0
  582. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios.swiftinterface +927 -0
  583. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Modules/module.modulemap +10 -0
  584. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/axeDevToolsXCUI +0 -0
  585. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/HTMLReportTemplate.html +1912 -0
  586. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Headers/AxeTestBundleObserver.h +55 -0
  587. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Headers/axeDevToolsXCUI-Swift.h +3088 -0
  588. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Headers/axeDevToolsXCUI.h +17 -0
  589. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Info.plist +53 -0
  590. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/LICENSE.md +7 -0
  591. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios-simulator.abi.json +34308 -0
  592. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface +927 -0
  593. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios-simulator.swiftdoc +0 -0
  594. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios-simulator.swiftinterface +927 -0
  595. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/x86_64-apple-ios-simulator.abi.json +34308 -0
  596. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface +927 -0
  597. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/x86_64-apple-ios-simulator.swiftdoc +0 -0
  598. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/x86_64-apple-ios-simulator.swiftinterface +927 -0
  599. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/module.modulemap +10 -0
  600. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/_CodeSignature/CodeResources +278 -0
  601. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/axeDevToolsXCUI +0 -0
  602. package/build/lib/check-dependencies.d.ts +6 -0
  603. package/build/lib/check-dependencies.d.ts.map +1 -0
  604. package/build/lib/check-dependencies.js +50 -0
  605. package/build/lib/check-dependencies.js.map +1 -0
  606. package/build/lib/constants.d.ts +25 -0
  607. package/build/lib/constants.d.ts.map +1 -0
  608. package/build/lib/constants.js +28 -0
  609. package/build/lib/constants.js.map +1 -0
  610. package/build/lib/index.d.ts +7 -0
  611. package/build/lib/index.d.ts.map +1 -0
  612. package/build/lib/index.js +7 -0
  613. package/build/lib/index.js.map +1 -0
  614. package/build/lib/logger.d.ts +2 -0
  615. package/build/lib/logger.d.ts.map +1 -0
  616. package/build/lib/logger.js +3 -0
  617. package/build/lib/logger.js.map +1 -0
  618. package/build/lib/no-session-proxy.d.ts +7 -0
  619. package/build/lib/no-session-proxy.d.ts.map +1 -0
  620. package/build/lib/no-session-proxy.js +17 -0
  621. package/build/lib/no-session-proxy.js.map +1 -0
  622. package/build/lib/types.d.ts +206 -0
  623. package/build/lib/types.d.ts.map +1 -0
  624. package/build/lib/types.js +2 -0
  625. package/build/lib/types.js.map +1 -0
  626. package/build/lib/utils/index.d.ts +11 -0
  627. package/build/lib/utils/index.d.ts.map +1 -0
  628. package/build/lib/utils/index.js +13 -0
  629. package/build/lib/utils/index.js.map +1 -0
  630. package/build/lib/utils/module.d.ts +25 -0
  631. package/build/lib/utils/module.d.ts.map +1 -0
  632. package/build/lib/utils/module.js +47 -0
  633. package/build/lib/utils/module.js.map +1 -0
  634. package/build/lib/utils/platform.d.ts +19 -0
  635. package/build/lib/utils/platform.d.ts.map +1 -0
  636. package/build/lib/utils/platform.js +32 -0
  637. package/build/lib/utils/platform.js.map +1 -0
  638. package/build/lib/utils/processes.d.ts +34 -0
  639. package/build/lib/utils/processes.d.ts.map +1 -0
  640. package/build/lib/utils/processes.js +151 -0
  641. package/build/lib/utils/processes.js.map +1 -0
  642. package/build/lib/utils/security.d.ts +5 -0
  643. package/build/lib/utils/security.d.ts.map +1 -0
  644. package/build/lib/utils/security.js +12 -0
  645. package/build/lib/utils/security.js.map +1 -0
  646. package/build/lib/utils/xctestrun.d.ts +51 -0
  647. package/build/lib/utils/xctestrun.d.ts.map +1 -0
  648. package/build/lib/utils/xctestrun.js +135 -0
  649. package/build/lib/utils/xctestrun.js.map +1 -0
  650. package/build/lib/wda-strategies.d.ts +69 -0
  651. package/build/lib/wda-strategies.d.ts.map +1 -0
  652. package/build/lib/wda-strategies.js +247 -0
  653. package/build/lib/wda-strategies.js.map +1 -0
  654. package/build/lib/webdriveragent.d.ts +175 -0
  655. package/build/lib/webdriveragent.d.ts.map +1 -0
  656. package/build/lib/webdriveragent.js +540 -0
  657. package/build/lib/webdriveragent.js.map +1 -0
  658. package/build/lib/xcodebuild.d.ts +98 -0
  659. package/build/lib/xcodebuild.d.ts.map +1 -0
  660. package/build/lib/xcodebuild.js +562 -0
  661. package/build/lib/xcodebuild.js.map +1 -0
  662. package/build/tsconfig.tsbuildinfo +1 -0
  663. package/lib/check-dependencies.ts +64 -0
  664. package/lib/constants.ts +33 -0
  665. package/lib/index.ts +7 -0
  666. package/lib/logger.ts +3 -0
  667. package/lib/no-session-proxy.ts +19 -0
  668. package/lib/types.ts +238 -0
  669. package/lib/utils/index.ts +20 -0
  670. package/lib/utils/module.ts +66 -0
  671. package/lib/utils/platform.ts +34 -0
  672. package/lib/utils/processes.ts +174 -0
  673. package/lib/utils/security.ts +16 -0
  674. package/lib/utils/xctestrun.ts +188 -0
  675. package/lib/wda-strategies.ts +343 -0
  676. package/lib/webdriveragent.ts +642 -0
  677. package/lib/xcodebuild.ts +678 -0
  678. package/package.json +114 -3
@@ -0,0 +1,955 @@
1
+ /**
2
+ * Copyright (c) 2015-present, Facebook, Inc.
3
+ * All rights reserved.
4
+ *
5
+ * This source code is licensed under the BSD-style license found in the
6
+ * LICENSE file in the root directory of this source tree.
7
+ */
8
+
9
+ #import "FBHTTPServer.h"
10
+
11
+ #import "FBCommandStatus.h"
12
+ #import "FBConfiguration.h"
13
+ #import "FBLogger.h"
14
+ #import "FBResponsePayload.h"
15
+ #import "FBTCPSocket.h"
16
+ #import "FBSession.h"
17
+
18
+ static NSData *FBCRLFCRLFData(void)
19
+ {
20
+ static NSData *data;
21
+ static dispatch_once_t onceToken;
22
+ dispatch_once(&onceToken, ^{
23
+ data = [@"\r\n\r\n" dataUsingEncoding:NSUTF8StringEncoding];
24
+ });
25
+ return data;
26
+ }
27
+
28
+ // -dataUsingEncoding:NSUTF8StringEncoding never actually returns nil; this just keeps the cast
29
+ // out of every call site below.
30
+ static NSData * _Nonnull FBUTF8Data(NSString *string)
31
+ {
32
+ return (NSData * _Nonnull)[string dataUsingEncoding:NSUTF8StringEncoding];
33
+ }
34
+
35
+ // Caps a request's header block, so a connection that never completes one cannot grow its buffer
36
+ // without limit. Matches node's default --max-http-header-size.
37
+ static const NSUInteger FBMaxRequestHeaderSize = 16 * 1024;
38
+
39
+ // ASCII decimal digits only. -integerValue must not be used here: it maps garbage silently
40
+ // ("bogus" -> 0, "12abc" -> 12), desyncing the framing of every later request on the connection.
41
+ static BOOL FBParseContentLength(NSString *value, NSUInteger *outLength)
42
+ {
43
+ if (value.length < 1) {
44
+ return NO;
45
+ }
46
+ NSUInteger result = 0;
47
+ for (NSUInteger i = 0; i < value.length; i++) {
48
+ unichar c = [value characterAtIndex:i];
49
+ if (c < '0' || c > '9') {
50
+ return NO;
51
+ }
52
+ NSUInteger digit = (NSUInteger)(c - '0');
53
+ // NSUInteger is 32-bit on watchOS (arm64_32), so this bounds truncation as well as overflow.
54
+ // Anything smaller is left to the caller's httpRequestBodySizeLimit check.
55
+ if (result > (NSUIntegerMax - digit) / 10) {
56
+ return NO;
57
+ }
58
+ result = result * 10 + digit;
59
+ }
60
+ *outLength = result;
61
+ return YES;
62
+ }
63
+
64
+ @interface FBHTTPRoute : NSObject
65
+ @property (nonatomic, copy) NSString *verb;
66
+ @property (nonatomic, strong) NSRegularExpression *regex;
67
+ @property (nonatomic, copy, nullable) NSArray<NSString *> *keys;
68
+ @property (nonatomic, copy) void (^block)(RouteRequest *request, RouteResponse *response);
69
+ @property (nonatomic, assign) BOOL isStandalone;
70
+ @end
71
+
72
+ @implementation FBHTTPRoute
73
+ @end
74
+
75
+
76
+ // Cached result of parsing a connection's request line + headers, kept around while its body is
77
+ // still streaming in so a slow body doesn't cause the header block to be re-found and re-parsed
78
+ // on every single incoming TCP segment.
79
+ @interface FBPendingHTTPRequestHeader : NSObject
80
+ @property (nonatomic, copy) NSString *method;
81
+ @property (nonatomic, copy) NSString *pathAndQuery;
82
+ @property (nonatomic) NSUInteger bodyStart;
83
+ @property (nonatomic) NSUInteger contentLength;
84
+ @end
85
+
86
+ @implementation FBPendingHTTPRequestHeader
87
+ @end
88
+
89
+
90
+ // One dispatched-but-not-yet-answered request. Default (pointer) identity, so two pipelined
91
+ // requests sharing a connection are never conflated into a single tracked entry.
92
+ @interface FBPendingRequest : NSObject
93
+ @property (nonatomic, strong, readonly) nw_connection_t client;
94
+ @end
95
+
96
+ @implementation FBPendingRequest
97
+
98
+ - (instancetype)initWithClient:(nw_connection_t)client
99
+ {
100
+ if ((self = [super init])) {
101
+ _client = client;
102
+ }
103
+ return self;
104
+ }
105
+
106
+ @end
107
+
108
+
109
+ @interface FBHTTPServer () <FBTCPSocketDelegate>
110
+
111
+ @property (nonatomic, nullable, strong) FBTCPSocket *socket;
112
+ @property (nonatomic, strong) NSMutableArray<FBHTTPRoute *> *routes;
113
+ @property (nonatomic, strong) NSMutableDictionary<NSString *, NSString *> *defaultHeaders;
114
+ @property (nonatomic, nullable) dispatch_queue_t routeQueue;
115
+ @property (nonatomic, copy, nullable) NSString *interface;
116
+ // nw_connection_t isn't NSCopying, so it can't be an NSDictionary key - use NSMapTable instead.
117
+ @property (nonatomic, strong) NSMapTable<id, NSMutableData *> *connectionBuffers;
118
+ // Per-client cache of the already-parsed request line + headers while its body is still
119
+ // arriving; nil while a client's next unread bytes start with an unparsed header block.
120
+ @property (nonatomic, strong) NSMapTable<id, FBPendingHTTPRequestHeader *> *pendingRequestHeaders;
121
+ // All buffer access - appending new data and -processBufferForClient:'s unlocked parse - is
122
+ // funneled through this one serial queue, so appends can never race a parse.
123
+ @property (nonatomic, strong) dispatch_queue_t bufferProcessingQueue;
124
+ // Connections with a request parsed off the buffer but not yet answered. Blocks
125
+ // -processBufferForClient: from starting the next pipelined request, so responses on one
126
+ // connection can't be written out of order. Guarded by @synchronized(self.connectionBuffers).
127
+ @property (nonatomic, strong) NSMutableSet *connectionsAwaitingResponse;
128
+ // Keyed by "METHOD path" - requests waiting on an already in-flight standalone request for that
129
+ // endpoint. Guarded by @synchronized(self.standaloneWaiters).
130
+ @property (nonatomic, strong) NSMutableDictionary<NSString *, NSMutableArray<FBPendingRequest *> *> *standaloneWaiters;
131
+ // Keyed by the "sessionID" path param - requests currently queued or executing for that session,
132
+ // standalone or not (except DELETE /session itself - see -dispatchMethod:). See
133
+ // -abandonPendingRequestsForSessionID:. Guarded by @synchronized(self.pendingSessionRequests).
134
+ @property (nonatomic, strong) NSMutableDictionary<NSString *, NSMutableSet<FBPendingRequest *> *> *pendingSessionRequests;
135
+ // When each connection started waiting for its current request. The reaper closes connections
136
+ // whose entry outlives FBIncompleteRequestTimeout; idle keep-alive connections have no entry and
137
+ // are exempt. Guarded by @synchronized(self.connectionBuffers).
138
+ @property (nonatomic, strong) NSMapTable<id, NSDate *> *incompleteRequestStarts;
139
+ @property (nonatomic, nullable) dispatch_source_t staleConnectionReaper;
140
+
141
+ @end
142
+
143
+ // How long a connection may take to deliver a complete request, matching the header read timeout
144
+ // the previous CocoaHTTPServer stack enforced.
145
+ static const NSTimeInterval FBIncompleteRequestTimeout = 30.0;
146
+ static const int64_t FBStaleConnectionSweepIntervalSec = 10;
147
+
148
+ @implementation FBHTTPServer
149
+
150
+ - (instancetype)init
151
+ {
152
+ if ((self = [super init])) {
153
+ _routes = [NSMutableArray array];
154
+ _defaultHeaders = [NSMutableDictionary dictionary];
155
+ _connectionBuffers = [NSMapTable mapTableWithKeyOptions:(NSPointerFunctionsOptions)(NSMapTableObjectPointerPersonality | NSMapTableStrongMemory)
156
+ valueOptions:(NSPointerFunctionsOptions)NSMapTableStrongMemory];
157
+ _pendingRequestHeaders = [NSMapTable mapTableWithKeyOptions:(NSPointerFunctionsOptions)(NSMapTableObjectPointerPersonality | NSMapTableStrongMemory)
158
+ valueOptions:(NSPointerFunctionsOptions)NSMapTableStrongMemory];
159
+ _bufferProcessingQueue = dispatch_queue_create("com.facebook.wda.http.bufferProcessing", DISPATCH_QUEUE_SERIAL);
160
+ _connectionsAwaitingResponse = [NSMutableSet set];
161
+ _standaloneWaiters = [NSMutableDictionary dictionary];
162
+ _pendingSessionRequests = [NSMutableDictionary dictionary];
163
+ _incompleteRequestStarts = [NSMapTable mapTableWithKeyOptions:(NSPointerFunctionsOptions)(NSMapTableObjectPointerPersonality | NSMapTableStrongMemory)
164
+ valueOptions:(NSPointerFunctionsOptions)NSMapTableStrongMemory];
165
+ }
166
+ return self;
167
+ }
168
+
169
+ - (void)setRouteQueue:(nullable dispatch_queue_t)queue
170
+ {
171
+ _routeQueue = queue;
172
+ }
173
+
174
+ - (void)setDefaultHeader:(NSString *)field value:(NSString *)value
175
+ {
176
+ self.defaultHeaders[field] = value;
177
+ }
178
+
179
+ - (void)setInterface:(nullable NSString *)interface
180
+ {
181
+ _interface = interface.copy;
182
+ }
183
+
184
+ #pragma mark - Route registration
185
+
186
+ - (FBHTTPRoute *)compiledRouteWithPath:(NSString *)path
187
+ {
188
+ FBHTTPRoute *route = [FBHTTPRoute new];
189
+ NSMutableArray<NSString *> *keys = [NSMutableArray array];
190
+
191
+ // Escape regex-significant characters before substituting :param placeholders.
192
+ NSRegularExpression *escapeRegex = [NSRegularExpression regularExpressionWithPattern:@"[.+()]"
193
+ options:(NSRegularExpressionOptions)0
194
+ error:nil];
195
+ NSString *escapedPath = [escapeRegex stringByReplacingMatchesInString:path
196
+ options:(NSMatchingOptions)0
197
+ range:NSMakeRange(0, path.length)
198
+ withTemplate:@"\\\\$0"];
199
+
200
+ NSRegularExpression *paramRegex = [NSRegularExpression regularExpressionWithPattern:@"(:(\\w+)|\\*)"
201
+ options:(NSRegularExpressionOptions)0
202
+ error:nil];
203
+ NSMutableString *regexPath = [NSMutableString stringWithString:escapedPath];
204
+ __block NSInteger diff = 0;
205
+ __block NSUInteger wildcardIndex = 0;
206
+ [paramRegex enumerateMatchesInString:escapedPath
207
+ options:(NSMatchingOptions)0
208
+ range:NSMakeRange(0, escapedPath.length)
209
+ usingBlock:^(NSTextCheckingResult * _Nullable result, NSMatchingFlags flags, BOOL * _Nonnull stop) {
210
+ NSRange replacementRange = NSMakeRange(diff + result.range.location, result.range.length);
211
+ NSString *capturedString = [escapedPath substringWithRange:result.range];
212
+ NSString *replacementString;
213
+ if ([capturedString isEqualToString:@"*"]) {
214
+ // Only the first wildcard keeps the plain "wildcards" name - later ones get an index
215
+ // suffix so multiple "*" segments in one path don't overwrite each other's capture.
216
+ NSString *wildcardKey = 0 == wildcardIndex ? @"wildcards" : [NSString stringWithFormat:@"wildcards%lu", (unsigned long)wildcardIndex];
217
+ wildcardIndex++;
218
+ [keys addObject:wildcardKey];
219
+ replacementString = @"(.*?)";
220
+ } else {
221
+ NSString *keyString = [escapedPath substringWithRange:[result rangeAtIndex:2]];
222
+ [keys addObject:keyString];
223
+ replacementString = @"([^/]+)";
224
+ }
225
+ [regexPath replaceCharactersInRange:replacementRange withString:replacementString];
226
+ diff += replacementString.length - result.range.length;
227
+ }];
228
+
229
+ NSString *anchoredPattern = [NSString stringWithFormat:@"^%@$", regexPath];
230
+ route.regex = [NSRegularExpression regularExpressionWithPattern:anchoredPattern
231
+ options:NSRegularExpressionCaseInsensitive
232
+ error:nil];
233
+ route.keys = keys.count > 0 ? keys.copy : nil;
234
+ return route;
235
+ }
236
+
237
+ - (void)handleMethod:(NSString *)method
238
+ withPath:(NSString *)path
239
+ block:(void (^)(RouteRequest *request, RouteResponse *response))block
240
+ {
241
+ [self handleMethod:method withPath:path standalone:NO block:block];
242
+ }
243
+
244
+ - (void)handleMethod:(NSString *)method
245
+ withPath:(NSString *)path
246
+ standalone:(BOOL)standalone
247
+ block:(void (^)(RouteRequest *request, RouteResponse *response))block
248
+ {
249
+ FBHTTPRoute *route = [self compiledRouteWithPath:path];
250
+ route.verb = method.uppercaseString;
251
+ route.block = block;
252
+ route.isStandalone = standalone;
253
+ [self.routes addObject:route];
254
+ }
255
+
256
+ - (void)get:(NSString *)path withBlock:(void (^)(RouteRequest *request, RouteResponse *response))block
257
+ {
258
+ [self handleMethod:@"GET" withPath:path block:block];
259
+ }
260
+
261
+ #pragma mark - Lifecycle
262
+
263
+ - (BOOL)start:(NSError **)error
264
+ {
265
+ FBTCPSocket *socket = [[FBTCPSocket alloc] initWithPort:self.port];
266
+ socket.interface = self.interface;
267
+ socket.delegate = self;
268
+ if (![socket startWithError:error]) {
269
+ return NO;
270
+ }
271
+ self.socket = socket;
272
+ dispatch_source_t reaper = dispatch_source_create(DISPATCH_SOURCE_TYPE_TIMER, 0, 0, self.bufferProcessingQueue);
273
+ dispatch_source_set_timer(reaper,
274
+ dispatch_time(DISPATCH_TIME_NOW, FBStaleConnectionSweepIntervalSec * NSEC_PER_SEC),
275
+ (uint64_t)FBStaleConnectionSweepIntervalSec * NSEC_PER_SEC,
276
+ NSEC_PER_SEC);
277
+ __weak typeof(self) weakSelf = self;
278
+ dispatch_source_set_event_handler(reaper, ^{
279
+ [weakSelf reapStaleConnections];
280
+ });
281
+ dispatch_resume(reaper);
282
+ self.staleConnectionReaper = reaper;
283
+ _isRunning = YES;
284
+ return YES;
285
+ }
286
+
287
+ - (void)reapStaleConnections
288
+ {
289
+ NSMutableArray *staleConnections = [NSMutableArray array];
290
+ @synchronized (self.connectionBuffers) {
291
+ for (id connection in self.incompleteRequestStarts) {
292
+ // Waiting on the handler, not the peer - never reap, however long the handler takes.
293
+ if ([self.connectionsAwaitingResponse containsObject:connection]) {
294
+ continue;
295
+ }
296
+ NSDate *start = [self.incompleteRequestStarts objectForKey:connection];
297
+ if (nil != start && -start.timeIntervalSinceNow > FBIncompleteRequestTimeout) {
298
+ [staleConnections addObject:connection];
299
+ }
300
+ }
301
+ }
302
+ for (id connection in staleConnections) {
303
+ [FBLogger logFmt:@"Closing a connection that did not deliver a complete request within %@ seconds", @(FBIncompleteRequestTimeout)];
304
+ [self closeClient:(nw_connection_t)connection];
305
+ }
306
+ }
307
+
308
+ - (void)stop:(BOOL)immediately
309
+ {
310
+ dispatch_source_t reaper = self.staleConnectionReaper;
311
+ if (nil != reaper) {
312
+ dispatch_source_cancel(reaper);
313
+ self.staleConnectionReaper = nil;
314
+ }
315
+ [self.socket stop];
316
+ self.socket = nil;
317
+ @synchronized (self.connectionBuffers) {
318
+ [self.connectionBuffers removeAllObjects];
319
+ [self.pendingRequestHeaders removeAllObjects];
320
+ [self.connectionsAwaitingResponse removeAllObjects];
321
+ [self.incompleteRequestStarts removeAllObjects];
322
+ }
323
+ _isRunning = NO;
324
+ }
325
+
326
+ #pragma mark - FBTCPSocketDelegate
327
+
328
+ - (void)didClientConnect:(nw_connection_t)newClient
329
+ {
330
+ @synchronized (self.connectionBuffers) {
331
+ [self.connectionBuffers setObject:[NSMutableData data] forKey:newClient];
332
+ // Starts at connect, so a peer that connects and then sends nothing is reaped too.
333
+ [self.incompleteRequestStarts setObject:[NSDate date] forKey:newClient];
334
+ }
335
+ }
336
+
337
+ - (void)didClientDisconnect:(nw_connection_t)client
338
+ {
339
+ // EOF must follow every receive already queued for this client. Otherwise it can
340
+ // remove the buffer before those bytes have even been appended and parsed.
341
+ __weak typeof(self) weakSelf = self;
342
+ dispatch_async(self.bufferProcessingQueue, ^{
343
+ __strong typeof(weakSelf) strongSelf = weakSelf;
344
+ if (nil == strongSelf) {
345
+ nw_connection_cancel(client);
346
+ return;
347
+ }
348
+ BOOL isAwaitingResponse;
349
+ @synchronized (strongSelf.connectionBuffers) {
350
+ isAwaitingResponse = [strongSelf.connectionsAwaitingResponse containsObject:client];
351
+ [strongSelf.connectionBuffers removeObjectForKey:client];
352
+ [strongSelf.pendingRequestHeaders removeObjectForKey:client];
353
+ [strongSelf.incompleteRequestStarts removeObjectForKey:client];
354
+ }
355
+ // A client that only stopped sending may still read the response to its in-flight request, so
356
+ // that response's send completion closes the connection instead (it finds no buffer left).
357
+ if (!isAwaitingResponse) {
358
+ nw_connection_cancel(client);
359
+ }
360
+ });
361
+ }
362
+
363
+ - (void)client:(nw_connection_t)client didReceiveData:(NSData *)data
364
+ {
365
+ // The append itself, not just the parse, must run on bufferProcessingQueue: otherwise a receive
366
+ // callback here could still mutate the buffer while -processBufferForClient: is reading it
367
+ // unlocked on that queue.
368
+ __weak typeof(self) weakSelf = self;
369
+ dispatch_async(self.bufferProcessingQueue, ^{
370
+ __strong typeof(weakSelf) strongSelf = weakSelf;
371
+ if (nil == strongSelf) {
372
+ return;
373
+ }
374
+ BOOL isOverBufferCap = NO;
375
+ @synchronized (strongSelf.connectionBuffers) {
376
+ NSMutableData *buffer = [strongSelf.connectionBuffers objectForKey:client];
377
+ if (nil == buffer) {
378
+ return;
379
+ }
380
+ [buffer appendData:data];
381
+ // One maximal header block plus one maximal body, plus headroom for a pipelined follow-up.
382
+ // The per-request checks don't run while a request is executing, so without this cap a
383
+ // client could pump data unboundedly for as long as its previous request takes.
384
+ uint64_t bufferCap = FBConfiguration.sharedInstance.httpRequestBodySizeLimit + 2 * (uint64_t)FBMaxRequestHeaderSize;
385
+ if (bufferCap < FBConfiguration.sharedInstance.httpRequestBodySizeLimit) {
386
+ bufferCap = UINT64_MAX;
387
+ }
388
+ isOverBufferCap = buffer.length > bufferCap;
389
+ // In the body phase the timeout is an idle bound, refreshed on progress: a declared body
390
+ // may legitimately be slow and its size is already capped by Content-Length. In the header
391
+ // phase the clock is only started, never refreshed, so drip-fed headers cannot outlive it.
392
+ BOOL isBodyPhase = nil != [strongSelf.pendingRequestHeaders objectForKey:client];
393
+ if (isBodyPhase || nil == [strongSelf.incompleteRequestStarts objectForKey:client]) {
394
+ [strongSelf.incompleteRequestStarts setObject:[NSDate date] forKey:client];
395
+ }
396
+ }
397
+ if (isOverBufferCap) {
398
+ // No response owed: a peer this far past any legitimate size is not reading anyway.
399
+ [FBLogger log:@"Closing a connection that overflowed its request buffer"];
400
+ [strongSelf closeClient:client];
401
+ return;
402
+ }
403
+ [strongSelf processBufferForClient:client];
404
+ });
405
+ }
406
+
407
+ #pragma mark - HTTP parsing
408
+
409
+ // Parses and dispatches at most one request per call; a connection with one already in flight is
410
+ // left alone (see -connectionsAwaitingResponse) until its response is written.
411
+ - (void)processBufferForClient:(nw_connection_t)client
412
+ {
413
+ NSMutableData *buffer;
414
+ FBPendingHTTPRequestHeader *pending;
415
+ @synchronized (self.connectionBuffers) {
416
+ if ([self.connectionsAwaitingResponse containsObject:client]) {
417
+ return;
418
+ }
419
+ buffer = [self.connectionBuffers objectForKey:client];
420
+ if (nil == buffer) {
421
+ return;
422
+ }
423
+ pending = [self.pendingRequestHeaders objectForKey:client];
424
+ }
425
+
426
+ if (nil == pending) {
427
+ pending = [self parsedRequestHeaderFromBuffer:buffer forClient:client];
428
+ if (nil == pending) {
429
+ // Either the header block is still incomplete, or it was rejected and answered already.
430
+ return;
431
+ }
432
+ @synchronized (self.connectionBuffers) {
433
+ [self.pendingRequestHeaders setObject:pending forKey:client];
434
+ }
435
+ }
436
+
437
+ [self dispatchBufferedRequestWithHeader:pending fromBuffer:buffer forClient:client];
438
+ }
439
+
440
+ // Locates the CRLFCRLF that ends the buffered header block and bounds the block's size. Returns
441
+ // NO when nothing can be parsed yet - either because more bytes are needed or because the block
442
+ // was rejected, in which case the 400 has already been written.
443
+ - (BOOL)findHeaderBlockEnd:(out NSRange *)outHeaderEndRange
444
+ inBuffer:(NSMutableData *)buffer
445
+ forClient:(nw_connection_t)client
446
+ {
447
+ NSRange headerEndRange = [buffer rangeOfData:FBCRLFCRLFData() options:(NSDataSearchOptions)0 range:NSMakeRange(0, buffer.length)];
448
+ if (NSNotFound == headerEndRange.location) {
449
+ if (buffer.length > FBMaxRequestHeaderSize) {
450
+ // Past any legitimate header block and still unterminated - stop buffering.
451
+ [self respondBadRequestToClient:client];
452
+ }
453
+ // Otherwise wait for the rest of the header block to arrive.
454
+ return NO;
455
+ }
456
+ if (headerEndRange.location > FBMaxRequestHeaderSize) {
457
+ // The check above only fires while the terminator is missing; one large receive can deliver
458
+ // an oversized block with it, so bound the completed block too before parsing it.
459
+ [self respondBadRequestToClient:client];
460
+ return NO;
461
+ }
462
+ *outHeaderEndRange = headerEndRange;
463
+ return YES;
464
+ }
465
+
466
+ // Turns the header lines that follow the request line into a lowercase-keyed dictionary.
467
+ // Returns nil for the malformed and ambiguous shapes, having written the 400 already.
468
+ - (nullable NSDictionary<NSString *, NSString *> *)parsedHeaderFieldsFromLines:(NSArray<NSString *> *)lines
469
+ forClient:(nw_connection_t)client
470
+ {
471
+ NSMutableDictionary<NSString *, NSString *> *requestHeaders = [NSMutableDictionary dictionary];
472
+ for (NSUInteger i = 1; i < lines.count; i++) {
473
+ NSString *line = lines[i];
474
+ NSRange colonRange = [line rangeOfString:@":"];
475
+ if (0 == line.length) {
476
+ continue;
477
+ }
478
+ if (NSNotFound == colonRange.location) {
479
+ // Malformed. Skipping it would drop what it meant to say: "Content-Length 5" would
480
+ // dispatch with an empty body, leaving its bytes to be parsed as another request.
481
+ [self respondBadRequestToClient:client];
482
+ return nil;
483
+ }
484
+ NSString *name = [line substringToIndex:colonRange.location];
485
+ // RFC 7230 (3.2.4): whitespace before the colon MUST be rejected. Storing "content-length "
486
+ // as its own key would drop the real header and desync the framing.
487
+ if (0 == name.length
488
+ || NSNotFound != [name rangeOfCharacterFromSet:NSCharacterSet.whitespaceAndNewlineCharacterSet].location) {
489
+ [self respondBadRequestToClient:client];
490
+ return nil;
491
+ }
492
+ NSString *value = [[line substringFromIndex:colonRange.location + 1]
493
+ stringByTrimmingCharactersInSet:NSCharacterSet.whitespaceCharacterSet];
494
+ NSString *normalizedName = name.lowercaseString;
495
+ // RFC 7230 (3.3.3): repeated framing fields are unrecoverable. Last-wins would let an empty
496
+ // "Transfer-Encoding:" mask an earlier "chunked", and the last Content-Length drive parsing.
497
+ if (([normalizedName isEqualToString:@"content-length"] || [normalizedName isEqualToString:@"transfer-encoding"])
498
+ && nil != requestHeaders[normalizedName]) {
499
+ [self respondBadRequestToClient:client];
500
+ return nil;
501
+ }
502
+ requestHeaders[normalizedName] = value;
503
+ }
504
+ return requestHeaders;
505
+ }
506
+
507
+ // Rejects framing this server cannot honour and resolves the declared body length from the
508
+ // remaining framing headers. Returns NO having written the closing error response already.
509
+ - (BOOL)resolveBodyLength:(out NSUInteger *)outBodyLength
510
+ fromHeaderFields:(NSDictionary<NSString *, NSString *> *)requestHeaders
511
+ forClient:(nw_connection_t)client
512
+ {
513
+ NSString *transferEncoding = requestHeaders[@"transfer-encoding"];
514
+ if (nil != transferEncoding) {
515
+ // No transfer decoder exists, so mere presence is rejected - including an empty value,
516
+ // which is not a valid encoding list and would let the body be misread as empty.
517
+ RouteResponse *notImplemented = [RouteResponse new];
518
+ id<FBResponsePayload> notImplementedPayload = FBResponseWithStatus([FBCommandStatus invalidArgumentErrorWithMessage:@"Transfer-Encoding is not supported"
519
+ traceback:nil]);
520
+ [notImplementedPayload dispatchWithResponse:notImplemented];
521
+ [self failClient:client withResponse:notImplemented];
522
+ return NO;
523
+ }
524
+
525
+ NSString *contentLengthValue = requestHeaders[@"content-length"];
526
+ NSUInteger contentLength = 0;
527
+ if (nil != contentLengthValue && !FBParseContentLength(contentLengthValue, &contentLength)) {
528
+ // The body's extent is unknowable, so the connection cannot be resynced - reject and close.
529
+ [self respondBadRequestToClient:client];
530
+ return NO;
531
+ }
532
+ if (contentLength > FBConfiguration.sharedInstance.httpRequestBodySizeLimit) {
533
+ // Closes the connection after responding, since the rest of the oversized body is still incoming.
534
+ RouteResponse *tooLarge = [RouteResponse new];
535
+ id<FBResponsePayload> tooLargePayload = FBResponseWithStatus([FBCommandStatus invalidArgumentErrorWithMessage:@"The request body exceeds the configured size limit"
536
+ traceback:nil]);
537
+ [tooLargePayload dispatchWithResponse:tooLarge];
538
+ [self failClient:client withResponse:tooLarge];
539
+ return NO;
540
+ }
541
+ *outBodyLength = contentLength;
542
+ return YES;
543
+ }
544
+
545
+ // Parses the request line and headers of the request at the head of the buffer. Returns nil
546
+ // while the header block is still incomplete, and for a rejected one, which is answered here.
547
+ - (nullable FBPendingHTTPRequestHeader *)parsedRequestHeaderFromBuffer:(NSMutableData *)buffer
548
+ forClient:(nw_connection_t)client
549
+ {
550
+ NSRange headerEndRange;
551
+ if (![self findHeaderBlockEnd:&headerEndRange inBuffer:buffer forClient:client]) {
552
+ return nil;
553
+ }
554
+
555
+ NSData *headerData = [buffer subdataWithRange:NSMakeRange(0, headerEndRange.location)];
556
+ NSString *headerString = [[NSString alloc] initWithData:headerData encoding:NSUTF8StringEncoding];
557
+ NSArray<NSString *> *lines = [headerString componentsSeparatedByString:@"\r\n"];
558
+ if (lines.count < 1) {
559
+ [self respondBadRequestToClient:client];
560
+ return nil;
561
+ }
562
+
563
+ NSArray<NSString *> *requestLineParts = [lines.firstObject componentsSeparatedByString:@" "];
564
+ if (requestLineParts.count < 2) {
565
+ [self respondBadRequestToClient:client];
566
+ return nil;
567
+ }
568
+
569
+ NSDictionary<NSString *, NSString *> *requestHeaders = [self parsedHeaderFieldsFromLines:lines forClient:client];
570
+ if (nil == requestHeaders) {
571
+ return nil;
572
+ }
573
+ NSUInteger contentLength = 0;
574
+ if (![self resolveBodyLength:&contentLength fromHeaderFields:requestHeaders forClient:client]) {
575
+ return nil;
576
+ }
577
+
578
+ FBPendingHTTPRequestHeader *pending = [FBPendingHTTPRequestHeader new];
579
+ pending.method = requestLineParts[0].uppercaseString;
580
+ pending.pathAndQuery = requestLineParts[1];
581
+ pending.bodyStart = headerEndRange.location + headerEndRange.length;
582
+ pending.contentLength = contentLength;
583
+ return pending;
584
+ }
585
+
586
+ // Consumes the already-parsed request from the head of the buffer and dispatches it, once its
587
+ // whole body has arrived. Returns with the cached header left in place while it hasn't.
588
+ - (void)dispatchBufferedRequestWithHeader:(FBPendingHTTPRequestHeader *)pending
589
+ fromBuffer:(NSMutableData *)buffer
590
+ forClient:(nw_connection_t)client
591
+ {
592
+ NSUInteger totalRequestLength = pending.bodyStart + pending.contentLength;
593
+ if (buffer.length < totalRequestLength) {
594
+ // Wait for the rest of the body to arrive - the parsed header stays cached, so this
595
+ // doesn't re-scan/re-parse the header block on every subsequently arriving chunk.
596
+ @synchronized (self.connectionBuffers) {
597
+ // The request is now in its body phase, which is idle-bounded rather than hard-bounded.
598
+ // -client:didReceiveData: samples that phase before this parse runs, so the receive that
599
+ // completed a slowly-delivered header (and carried the first body bytes) would otherwise
600
+ // leave the connection on its header-phase timestamp and let the sweep close it despite
601
+ // the body having just made progress.
602
+ [self.incompleteRequestStarts setObject:[NSDate date] forKey:client];
603
+ }
604
+ return;
605
+ }
606
+
607
+ NSData *body = pending.contentLength > 0 ? [buffer subdataWithRange:NSMakeRange(pending.bodyStart, pending.contentLength)] : [NSData data];
608
+
609
+ @synchronized (self.connectionBuffers) {
610
+ [buffer replaceBytesInRange:NSMakeRange(0, totalRequestLength) withBytes:NULL length:0];
611
+ [self.pendingRequestHeaders removeObjectForKey:client];
612
+ [self.connectionsAwaitingResponse addObject:client];
613
+ if (0 == buffer.length) {
614
+ // A complete request was delivered and nothing further is buffered: the connection is a
615
+ // healthy keep-alive and must not be reaped while idle.
616
+ [self.incompleteRequestStarts removeObjectForKey:client];
617
+ } else {
618
+ // Pipelined bytes of the next request are already buffered - restart its clock.
619
+ [self.incompleteRequestStarts setObject:[NSDate date] forKey:client];
620
+ }
621
+ }
622
+
623
+ [self dispatchMethod:pending.method pathAndQuery:pending.pathAndQuery body:body client:client];
624
+ }
625
+
626
+ // Removes the client's buffered state and responds with a closing error response. Removing the
627
+ // buffer synchronously ensures any request bytes still streaming in for this connection are
628
+ // dropped rather than being re-parsed and re-triggering this same response.
629
+ - (void)failClient:(nw_connection_t)client withResponse:(RouteResponse *)response
630
+ {
631
+ @synchronized (self.connectionBuffers) {
632
+ [self.connectionBuffers removeObjectForKey:client];
633
+ [self.pendingRequestHeaders removeObjectForKey:client];
634
+ }
635
+ [self applyDefaultHeadersToResponse:response];
636
+ [self writeResponse:response toClient:client thenCloseConnection:YES];
637
+ }
638
+
639
+ - (void)respondBadRequestToClient:(nw_connection_t)client
640
+ {
641
+ RouteResponse *badRequest = [RouteResponse new];
642
+ id<FBResponsePayload> payload = FBResponseWithStatus([FBCommandStatus invalidArgumentErrorWithMessage:@"The request could not be parsed as valid HTTP"
643
+ traceback:nil]);
644
+ [payload dispatchWithResponse:badRequest];
645
+ [self failClient:client withResponse:badRequest];
646
+ }
647
+
648
+ - (void)applyDefaultHeadersToResponse:(RouteResponse *)response
649
+ {
650
+ [self.defaultHeaders enumerateKeysAndObjectsUsingBlock:^(NSString *field, NSString *value, BOOL *stop) {
651
+ [response setHeader:field value:value];
652
+ }];
653
+ }
654
+
655
+ - (void)dispatchMethod:(NSString *)method pathAndQuery:(NSString *)pathAndQuery body:(NSData *)body client:(nw_connection_t)client
656
+ {
657
+ NSURLComponents *requestTarget = [NSURLComponents componentsWithString:pathAndQuery];
658
+ NSString *path = requestTarget.path ?: pathAndQuery;
659
+
660
+ for (FBHTTPRoute *route in self.routes) {
661
+ if (![route.verb isEqualToString:method]) {
662
+ continue;
663
+ }
664
+ NSTextCheckingResult *result = [route.regex firstMatchInString:path options:(NSMatchingOptions)0 range:NSMakeRange(0, path.length)];
665
+ if (nil == result) {
666
+ continue;
667
+ }
668
+
669
+ NSMutableDictionary<NSString *, NSString *> *params = [NSMutableDictionary dictionary];
670
+ for (NSURLQueryItem *queryItem in requestTarget.queryItems) {
671
+ params[queryItem.name] = queryItem.value ?: @"";
672
+ }
673
+ if (route.keys.count > 0 && result.numberOfRanges == route.keys.count + 1) {
674
+ NSUInteger index = 1;
675
+ for (NSString *key in route.keys) {
676
+ params[key] = [path substringWithRange:[result rangeAtIndex:index]];
677
+ index++;
678
+ }
679
+ }
680
+
681
+ NSURL *url = [NSURL URLWithString:path] ?: [NSURL URLWithString:@"/"];
682
+ RouteRequest *request = [[RouteRequest alloc] initWithURL:url params:params.copy body:body];
683
+ RouteResponse *response = [RouteResponse new];
684
+ [self applyDefaultHeadersToResponse:response];
685
+
686
+ NSString *sessionID = params[@"sessionID"];
687
+ if (route.isStandalone) {
688
+ // DELETE triggers -abandonPendingRequestsForSessionID: itself; tracking its own request
689
+ // would make it abandon itself and write a response twice.
690
+ NSString *trackedSessionID = [route.verb isEqualToString:@"DELETE"] ? nil : sessionID;
691
+ [self dispatchStandaloneRoute:route request:request response:response client:client method:method pathAndQuery:pathAndQuery sessionID:trackedSessionID];
692
+ return;
693
+ }
694
+
695
+ FBPendingRequest *pendingRequest = nil;
696
+ if (nil != sessionID) {
697
+ pendingRequest = [[FBPendingRequest alloc] initWithClient:client];
698
+ RouteResponse *abandonedResponse = [self trackPendingRequest:pendingRequest forSessionID:sessionID];
699
+ if (nil != abandonedResponse) {
700
+ [self writeResponse:abandonedResponse toClient:client];
701
+ return;
702
+ }
703
+ }
704
+
705
+ void (^invoke)(void) = ^{
706
+ route.block(request, response);
707
+ // Whoever untracks `pendingRequest` first "wins" and gets to respond - either this normal
708
+ // completion, or -abandonPendingRequestsForSessionID: on another thread.
709
+ BOOL shouldRespond = (nil == pendingRequest) || [self untrackPendingRequest:pendingRequest forSessionID:sessionID];
710
+ if (shouldRespond) {
711
+ [self writeResponse:response toClient:client];
712
+ }
713
+ };
714
+ dispatch_queue_t routeQueue = self.routeQueue;
715
+ if (routeQueue) {
716
+ dispatch_async((dispatch_queue_t _Nonnull)routeQueue, invoke);
717
+ } else {
718
+ invoke();
719
+ }
720
+ return;
721
+ }
722
+
723
+ RouteResponse *notFound = [RouteResponse new];
724
+ FBCommandStatus *status = [FBCommandStatus unknownCommandErrorWithMessage:nil
725
+ traceback:nil];
726
+ [FBResponseWithStatus(status) dispatchWithResponse:notFound];
727
+ [self applyDefaultHeadersToResponse:notFound];
728
+ [self writeResponse:notFound toClient:client];
729
+ }
730
+
731
+ #pragma mark - Session-scoped request cancellation
732
+
733
+ // Returns nil once `pendingRequest` is tracked, or the response an already-abandoned session was
734
+ // abandoned with, which the caller must deliver instead of dispatching.
735
+ - (nullable RouteResponse *)trackPendingRequest:(FBPendingRequest *)pendingRequest forSessionID:(NSString *)sessionID
736
+ {
737
+ @synchronized (self.pendingSessionRequests) {
738
+ // Checking the current session under this lock closes the admission/teardown
739
+ // race without retaining a tombstone and a full response for every past UUID.
740
+ // -kill clears the active session before posting its abandonment notification.
741
+ if (nil == [FBSession sessionWithIdentifier:sessionID]) {
742
+ RouteResponse *response = [RouteResponse new];
743
+ [FBResponseWithStatus([FBCommandStatus noSuchDriverErrorWithMessage:@"Session does not exist"
744
+ traceback:nil]) dispatchWithResponse:response];
745
+ [self applyDefaultHeadersToResponse:response];
746
+ return response;
747
+ }
748
+ NSMutableSet<FBPendingRequest *> *pendingRequests = self.pendingSessionRequests[sessionID];
749
+ if (nil == pendingRequests) {
750
+ pendingRequests = [NSMutableSet set];
751
+ self.pendingSessionRequests[sessionID] = pendingRequests;
752
+ }
753
+ [pendingRequests addObject:pendingRequest];
754
+ return nil;
755
+ }
756
+ }
757
+
758
+ // Returns YES if this caller won the race to respond, vs. -abandonPendingRequestsForSessionID:
759
+ // already having claimed `pendingRequest` on another thread.
760
+ - (BOOL)untrackPendingRequest:(FBPendingRequest *)pendingRequest forSessionID:(NSString *)sessionID
761
+ {
762
+ @synchronized (self.pendingSessionRequests) {
763
+ NSMutableSet<FBPendingRequest *> *pendingRequests = self.pendingSessionRequests[sessionID];
764
+ BOOL wasPending = [pendingRequests containsObject:pendingRequest];
765
+ if (wasPending) {
766
+ [pendingRequests removeObject:pendingRequest];
767
+ if (0 == pendingRequests.count) {
768
+ [self.pendingSessionRequests removeObjectForKey:sessionID];
769
+ }
770
+ }
771
+ return wasPending;
772
+ }
773
+ }
774
+
775
+ - (void)abandonPendingRequestsForSessionID:(NSString *)sessionID withResponse:(RouteResponse *)response
776
+ {
777
+ NSSet<FBPendingRequest *> *pendingRequests;
778
+ @synchronized (self.pendingSessionRequests) {
779
+ pendingRequests = [self.pendingSessionRequests[sessionID] copy];
780
+ [self.pendingSessionRequests removeObjectForKey:sessionID];
781
+ }
782
+ for (FBPendingRequest *pendingRequest in pendingRequests) {
783
+ [self writeResponse:response toClient:pendingRequest.client];
784
+ }
785
+ }
786
+
787
+ #pragma mark - Standalone route dispatch
788
+
789
+ - (void)dispatchStandaloneRoute:(FBHTTPRoute *)route
790
+ request:(RouteRequest *)request
791
+ response:(RouteResponse *)response
792
+ client:(nw_connection_t)client
793
+ method:(NSString *)method
794
+ pathAndQuery:(NSString *)pathAndQuery
795
+ sessionID:(nullable NSString *)sessionID
796
+ {
797
+ // Includes the query string so requests with different params are never coalesced together.
798
+ NSString *key = [NSString stringWithFormat:@"%@ %@", method, pathAndQuery];
799
+ FBPendingRequest *waiter = [[FBPendingRequest alloc] initWithClient:client];
800
+ if (nil != sessionID) {
801
+ RouteResponse *abandonedResponse = [self trackPendingRequest:waiter forSessionID:sessionID];
802
+ if (nil != abandonedResponse) {
803
+ [self writeResponse:abandonedResponse toClient:client];
804
+ return;
805
+ }
806
+ }
807
+
808
+ BOOL isInFlight = NO;
809
+ @synchronized (self.standaloneWaiters) {
810
+ NSMutableArray<FBPendingRequest *> *waiters = self.standaloneWaiters[key];
811
+ if (nil != waiters) {
812
+ [waiters addObject:waiter];
813
+ isInFlight = YES;
814
+ } else {
815
+ self.standaloneWaiters[key] = [NSMutableArray array];
816
+ }
817
+ }
818
+ if (isInFlight) {
819
+ // An identical request is already executing; it will deliver this connection's response too.
820
+ return;
821
+ }
822
+
823
+ dispatch_queue_t queue = dispatch_queue_create(key.UTF8String, DISPATCH_QUEUE_SERIAL);
824
+ __weak typeof(self) weakSelf = self;
825
+ dispatch_async(queue, ^{
826
+ route.block(request, response);
827
+ __strong typeof(weakSelf) strongSelf = weakSelf;
828
+ if (nil == strongSelf) {
829
+ return;
830
+ }
831
+ NSArray<FBPendingRequest *> *joinedWaiters;
832
+ @synchronized (strongSelf.standaloneWaiters) {
833
+ joinedWaiters = [strongSelf.standaloneWaiters[key] copy];
834
+ [strongSelf.standaloneWaiters removeObjectForKey:key];
835
+ }
836
+ for (FBPendingRequest *joinedWaiter in [@[waiter] arrayByAddingObjectsFromArray:joinedWaiters]) {
837
+ BOOL shouldRespond = (nil == sessionID) || [strongSelf untrackPendingRequest:joinedWaiter forSessionID:sessionID];
838
+ if (shouldRespond) {
839
+ [strongSelf writeResponse:response toClient:joinedWaiter.client];
840
+ }
841
+ }
842
+ });
843
+ }
844
+
845
+ - (void)writeResponse:(RouteResponse *)response toClient:(nw_connection_t)client
846
+ {
847
+ [self writeResponse:response toClient:client thenCloseConnection:NO];
848
+ }
849
+
850
+ - (void)writeResponse:(RouteResponse *)response toClient:(nw_connection_t)client thenCloseConnection:(BOOL)shouldClose
851
+ {
852
+ NSMutableData *payload = [NSMutableData data];
853
+ NSString *statusLine = [NSString stringWithFormat:@"HTTP/1.1 %ld %@\r\n",
854
+ (long)response.statusCode, [self reasonPhraseForStatusCode:response.statusCode]];
855
+ [payload appendData:FBUTF8Data(statusLine)];
856
+
857
+ NSData *body = response.responseData ?: [NSData data];
858
+ NSMutableDictionary<NSString *, NSString *> *headers = response.headers.mutableCopy;
859
+ if (nil == headers[@"Content-Length"]) {
860
+ headers[@"Content-Length"] = [NSString stringWithFormat:@"%lu", (unsigned long)body.length];
861
+ }
862
+ [headers enumerateKeysAndObjectsUsingBlock:^(NSString *field, NSString *value, BOOL *stop) {
863
+ NSString *headerLine = [NSString stringWithFormat:@"%@: %@\r\n", field, value];
864
+ [payload appendData:FBUTF8Data(headerLine)];
865
+ }];
866
+ [payload appendData:FBUTF8Data(@"\r\n")];
867
+ [payload appendData:body];
868
+
869
+ if (shouldClose) {
870
+ __weak typeof(self) weakSelf = self;
871
+ [self.socket writeData:payload toClient:client completion:^(BOOL didSucceed) {
872
+ [weakSelf closeClient:client];
873
+ }];
874
+ } else {
875
+ // Unblocked from the send's completion, not before it: ordering is preserved either way
876
+ // (nw_connection_send is FIFO per connection), but unblocking early lets a client that
877
+ // pipelines without reading responses pile up rendered responses inside Network.framework.
878
+ __weak typeof(self) weakSelf = self;
879
+ [self.socket writeData:payload toClient:client completion:^(BOOL didSucceed) {
880
+ __strong typeof(weakSelf) strongSelf = weakSelf;
881
+ if (nil == strongSelf) {
882
+ return;
883
+ }
884
+ if (!didSucceed) {
885
+ // The response never reached the peer, so running its next pipelined request - possibly
886
+ // a mutating one - would change device state for a client that can no longer be answered.
887
+ [FBLogger log:@"Failed to write a response; dropping the connection and its pending requests"];
888
+ [strongSelf closeClient:client];
889
+ return;
890
+ }
891
+ // Lifting the exemption and resuming parsing happen in one step on bufferProcessingQueue,
892
+ // the queue the reaper also runs on: doing it out here exposes the connection to a sweep
893
+ // queued ahead of the parse, which would judge a buffered request by the previous one's
894
+ // timestamp.
895
+ dispatch_async(strongSelf.bufferProcessingQueue, ^{
896
+ __strong typeof(weakSelf) queuedSelf = weakSelf;
897
+ if (nil == queuedSelf) {
898
+ return;
899
+ }
900
+ BOOL isDisconnected;
901
+ @synchronized (queuedSelf.connectionBuffers) {
902
+ [queuedSelf.connectionsAwaitingResponse removeObject:client];
903
+ isDisconnected = nil == [queuedSelf.connectionBuffers objectForKey:client];
904
+ // Mid-request connections get their window from when parsing could resume, not from the
905
+ // previous request. Absent entries stay absent, so idle keep-alives remain exempt.
906
+ if (nil != [queuedSelf.incompleteRequestStarts objectForKey:client]) {
907
+ [queuedSelf.incompleteRequestStarts setObject:[NSDate date] forKey:client];
908
+ }
909
+ }
910
+ if (isDisconnected) {
911
+ // The peer stopped sending while this request was in flight - see -didClientDisconnect:.
912
+ [queuedSelf closeClient:client];
913
+ return;
914
+ }
915
+ [queuedSelf processBufferForClient:client];
916
+ });
917
+ }];
918
+ }
919
+ }
920
+
921
+ - (void)closeClient:(nw_connection_t)client
922
+ {
923
+ @synchronized (self.connectionBuffers) {
924
+ [self.connectionBuffers removeObjectForKey:client];
925
+ [self.pendingRequestHeaders removeObjectForKey:client];
926
+ [self.connectionsAwaitingResponse removeObject:client];
927
+ [self.incompleteRequestStarts removeObjectForKey:client];
928
+ }
929
+ nw_connection_cancel(client);
930
+ }
931
+
932
+ - (NSString *)reasonPhraseForStatusCode:(HTTPStatusCode)statusCode
933
+ {
934
+ // if/else, not switch, to avoid having to list all ~90 HTTPStatusCode cases for -Wswitch-enum.
935
+ if (kHTTPStatusCodeOK == statusCode) {
936
+ return @"OK";
937
+ } else if (kHTTPStatusCodeBadRequest == statusCode) {
938
+ return @"Bad Request";
939
+ } else if (kHTTPStatusCodeNotFound == statusCode) {
940
+ return @"Not Found";
941
+ } else if (kHTTPStatusCodeMethodNotAllowed == statusCode) {
942
+ return @"Method Not Allowed";
943
+ } else if (kHTTPStatusCodeRequestTimeout == statusCode) {
944
+ return @"Request Timeout";
945
+ } else if (kHTTPStatusCodeRequestEntityTooLarge == statusCode) {
946
+ return @"Request Entity Too Large";
947
+ } else if (kHTTPStatusCodeNotImplemented == statusCode) {
948
+ return @"Not Implemented";
949
+ } else if (kHTTPStatusCodeInternalServerError == statusCode) {
950
+ return @"Internal Server Error";
951
+ }
952
+ return @"Status";
953
+ }
954
+
955
+ @end