8314 Expose Stripe checkSupport func from Hardware

We will need the checkSupport function Stripe provide to check whether a given device supports the built-in card reader. The simpler Apple version is more permissive, e.g. it says support is available from iOS 15.5, however via Stripe, 16.0 is the minimum.

Author: joshheald

Hardware/Hardware/CardReader/CardReaderService.swift

@@ -18,6 +18,12 @@ public protocol CardReaderService {
 
     // MARK: - Commands
 
+    /// Checks for support of a given reader type and discovery method combination. Does not start discovery.
+    ///
+    func checkSupport(for cardReaderType: CardReaderType,
+                      configProvider: CardReaderConfigProvider,
+                      discoveryMethod: CardReaderDiscoveryMethod) -> Bool
+
     /// Starts the service.
     /// That could imply, for example, that the reader discovery process starts
     func start(_ configProvider: CardReaderConfigProvider, discoveryMethod: CardReaderDiscoveryMethod) throws

Hardware/Hardware/CardReader/StripeCardReader/CardReaderType+Stripe.swift

@@ -19,5 +19,20 @@ extension CardReaderType {
             return .other
         }
     }
+
+    func toStripe() -> DeviceType? {
+        switch self {
+        case .chipper:
+            return .chipper2X
+        case .stripeM2:
+            return .stripeM2
+        case .wisepad3:
+            return .wisePad3
+        case .appleBuiltIn:
+            return .appleBuiltIn
+        case .other:
+            return nil
+        }
+    }
 }
 #endif

Hardware/Hardware/CardReader/StripeCardReader/NoOpCardReaderService.swift

@@ -1,5 +1,5 @@
 import Combine
-/// The adapter wrapping the Stripe Terminal SDK
+/// A no-op replacement for the adapter wrapping the Stripe Terminal SDK
 public struct NoOpCardReaderService: CardReaderService {
     // MARK: - Queries
     /// The publisher that emits the list of discovered readers whenever the service discovers a new reader.
@@ -18,6 +18,12 @@ public struct NoOpCardReaderService: CardReaderService {
     public init() {}
     // MARK: - Commands
 
+    public func checkSupport(for cardReaderType: CardReaderType,
+                             configProvider: CardReaderConfigProvider,
+                             discoveryMethod: CardReaderDiscoveryMethod) -> Bool {
+        return false
+    }
+
     /// Starts the service.
     /// That could imply, for example, that the reader discovery process starts
     public func start(_ configProvider: CardReaderConfigProvider, discoveryMethod: CardReaderDiscoveryMethod) throws {

Hardware/Hardware/CardReader/StripeCardReader/StripeCardReaderService.swift

@@ -62,8 +62,27 @@ extension StripeCardReaderService: CardReaderService {
 
     // MARK: - CardReaderService conformance. Commands
 
-    public func start(_ configProvider: CardReaderConfigProvider,
-                      discoveryMethod: CardReaderDiscoveryMethod) throws {
+    public func checkSupport(for cardReaderType: CardReaderType,
+                             configProvider: CardReaderConfigProvider,
+                             discoveryMethod: CardReaderDiscoveryMethod) -> Bool {
+        guard let deviceType = cardReaderType.toStripe() else {
+            return false
+        }
+
+        prepare(using: configProvider)
+
+        let result = Terminal.shared.supportsReaders(of: deviceType,
+                                                     discoveryMethod: discoveryMethod.toStripe(),
+                                                     simulated: shouldUseSimulatedCardReader)
+        switch result {
+        case .success:
+            return true
+        case .failure:
+            return false
+        }
+    }
+
+    func prepare(using configProvider: CardReaderConfigProvider) {
         setConfigProvider(configProvider)
 
         Terminal.setLogListener {  message in
@@ -75,6 +94,11 @@ extension StripeCardReaderService: CardReaderService {
             DDLogDebug("💳 [StripeTerminal] \(message)")
         }
         Terminal.shared.logLevel = terminalLogLevel
+    }
+
+    public func start(_ configProvider: CardReaderConfigProvider,
+                      discoveryMethod: CardReaderDiscoveryMethod) throws {
+        prepare(using: configProvider)
 
         if shouldUseSimulatedCardReader {
             // You can test with different reader software update scenarios.

Yosemite/YosemiteTests/Mocks/CardPresentPayments/MockCardReaderService.swift

@@ -50,6 +50,12 @@ final class MockCardReaderService: CardReaderService {
     /// The publisher to return in `capturePayment`.
     private var capturePaymentPublisher: AnyPublisher<PaymentIntent, Error>?
 
+
+    var didCheckSupport = false
+    var spyCheckSupportCardReaderType: CardReaderType? = nil
+    var spyCheckSupportConfigProvider: CardReaderConfigProvider? = nil
+    var spyCheckSupportDiscoveryMethod: CardReaderDiscoveryMethod? = nil
+
     /// The future to return in `waitForInsertedCardToBeRemoved`.
     private var waitForInsertedCardToBeRemovedFuture: Future<Void, Never>?
 
@@ -61,6 +67,17 @@ final class MockCardReaderService: CardReaderService {
 
     }
 
+    func checkSupport(for cardReaderType: Hardware.CardReaderType,
+                      configProvider: Hardware.CardReaderConfigProvider,
+                      discoveryMethod: Hardware.CardReaderDiscoveryMethod) -> Bool {
+        didCheckSupport = true
+        spyCheckSupportCardReaderType = cardReaderType
+        spyCheckSupportConfigProvider = configProvider
+        spyCheckSupportDiscoveryMethod = discoveryMethod
+
+        return true
+    }
+
     func start(_ configProvider: Hardware.CardReaderConfigProvider, discoveryMethod: Hardware.CardReaderDiscoveryMethod) throws {
         didHitStart = true
         didReceiveAConfigurationProvider = true