@capacitor-community/stripe-terminal 6.1.0 → 6.2.1

package/ios/Plugin/StripeTerminal.swift

@@ -2,20 +2,24 @@ import Foundation
 import Capacitor
 import StripeTerminal
 
-public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDelegate, BluetoothReaderDelegate, TerminalDelegate {
+public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDelegate, BluetoothReaderDelegate, TerminalDelegate, ReconnectionDelegate {
 
     weak var plugin: StripeTerminalPlugin?
     private let apiClient = APIClient()
+
     var discoverCancelable: Cancelable?
+    var collectCancelable: Cancelable?
+    var installUpdateCancelable: Cancelable?
+    var cancelReaderConnectionCancellable: Cancelable?
+
     var discoverCall: CAPPluginCall?
     var locationId: String?
     var isTest: Bool?
-    var collectCancelable: Cancelable?
     var type: DiscoveryMethod?
     var isInitialize: Bool = false
     var paymentIntent: PaymentIntent?
 
-    var readers: [Reader]?
+    var discoveredReadersList: [Reader]?
 
     @objc public func initialize(_ call: CAPPluginCall) {
         self.isTest = call.getBool("isTest", true)
@@ -61,38 +65,21 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
                 call.reject(error.localizedDescription)
                 self.discoverCall = nil
             } else {
+                // This call is passed to discoverCall. So not resolve.
             }
         }
     }
 
-    func cancelDiscoverReaders(_ call: CAPPluginCall) {
-
-        if let cancelable = self.discoverCancelable {
-            cancelable.cancel { error in
-                if let error = error {
-                    call.reject(error.localizedDescription)
-                } else {
-                    self.collectCancelable = nil
-                    call.resolve()
-                }
-            }
-            return
-        }
-
-        call.resolve()
-    }
-
     public func terminal(_ terminal: Terminal, didUpdateDiscoveredReaders readers: [Reader]) {
         var readersJSObject: JSArray = []
         var i = 0
         for reader in readers {
             readersJSObject.append([
-                "index": i,
-                "serialNumber": reader.serialNumber
-            ])
+                "index": i
+            ].merging(self.convertReaderInterface(reader: reader)) { (_, new) in new })
             i += 1
         }
-        self.readers = readers
+        self.discoveredReadersList = readers
 
         self.plugin?.notifyListeners(TerminalEvents.DiscoveredReaders.rawValue, data: ["readers": readersJSObject])
         self.discoverCall?.resolve([
@@ -113,9 +100,7 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
 
     public func getConnectedReader(_ call: CAPPluginCall) {
         if let reader = Terminal.shared.connectedReader {
-            call.resolve(["reader": [
-                "serialNumber": reader.serialNumber
-            ]])
+            call.resolve(["reader": self.convertReaderInterface(reader: reader)])
         } else {
             call.resolve(["reader": nil])
         }
@@ -140,11 +125,25 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
     }
 
     private func connectLocalMobileReader(_ call: CAPPluginCall) {
-        let connectionConfig = try! LocalMobileConnectionConfigurationBuilder.init(locationId: self.locationId!).build()
+        let autoReconnectOnUnexpectedDisconnect = call.getBool("autoReconnectOnUnexpectedDisconnect", false)
+        let merchantDisplayName: String? = call.getString("merchantDisplayName")
+        let onBehalfOf: String? = call.getString("onBehalfOf")
         let reader: JSObject = call.getObject("reader")!
-        let index: Int = reader["index"] as! Int
+        let serialNumber: String = reader["serialNumber"] as! String
 
-        Terminal.shared.connectLocalMobileReader(self.readers![index], delegate: self, connectionConfig: connectionConfig) { reader, error in
+        let connectionConfig = try! LocalMobileConnectionConfigurationBuilder.init(locationId: self.locationId!)
+            .setMerchantDisplayName(merchantDisplayName ?? nil)
+            .setOnBehalfOf(onBehalfOf ?? nil)
+            .setAutoReconnectOnUnexpectedDisconnect(autoReconnectOnUnexpectedDisconnect)
+            .setAutoReconnectionDelegate(autoReconnectOnUnexpectedDisconnect ? self : nil)
+            .build()
+
+        guard let foundReader = self.discoveredReadersList?.first(where: { $0.serialNumber == serialNumber }) else {
+            call.reject("reader is not match from descovered readers.")
+            return
+        }
+
+        Terminal.shared.connectLocalMobileReader(foundReader, delegate: self, connectionConfig: connectionConfig) { reader, error in
             if let reader = reader {
                 self.plugin?.notifyListeners(TerminalEvents.ConnectedReader.rawValue, data: [:])
                 call.resolve()
@@ -155,13 +154,19 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
     }
 
     private func connectInternetReader(_ call: CAPPluginCall) {
+        let reader: JSObject = call.getObject("reader")!
+        let serialNumber: String = reader["serialNumber"] as! String
+
+        guard let foundReader = self.discoveredReadersList?.first(where: { $0.serialNumber == serialNumber }) else {
+            call.reject("reader is not match from descovered readers.")
+            return
+        }
+
         let config = try! InternetConnectionConfigurationBuilder()
             .setFailIfInUse(true)
             .build()
-        let reader: JSObject = call.getObject("reader")!
-        let index: Int = reader["index"] as! Int
 
-        Terminal.shared.connectInternetReader(self.readers![index], connectionConfig: config) { reader, error in
+        Terminal.shared.connectInternetReader(foundReader, connectionConfig: config) { reader, error in
             if let reader = reader {
                 self.plugin?.notifyListeners(TerminalEvents.ConnectedReader.rawValue, data: [:])
                 call.resolve()
@@ -172,11 +177,24 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
     }
 
     private func connectBluetoothReader(_ call: CAPPluginCall) {
-        let config = try! BluetoothConnectionConfigurationBuilder(locationId: self.locationId!).build()
         let reader: JSObject = call.getObject("reader")!
-        let index: Int = reader["index"] as! Int
+        let serialNumber: String = reader["serialNumber"] as! String
+
+        guard let foundReader = self.discoveredReadersList?.first(where: { $0.serialNumber == serialNumber }) else {
+            call.reject("reader is not match from descovered readers.")
+            return
+        }
+
+        let autoReconnectOnUnexpectedDisconnect = call.getBool("autoReconnectOnUnexpectedDisconnect", false)
+        let merchantDisplayName: String? = call.getString("merchantDisplayName")
+        let onBehalfOf: String? = call.getString("onBehalfOf")
 
-        Terminal.shared.connectBluetoothReader(self.readers![index], delegate: self, connectionConfig: config) { reader, error in
+        let config = try! BluetoothConnectionConfigurationBuilder(locationId: self.locationId!)
+            .setAutoReconnectOnUnexpectedDisconnect(autoReconnectOnUnexpectedDisconnect)
+            .setAutoReconnectionDelegate(autoReconnectOnUnexpectedDisconnect ? self : nil)
+            .build()
+
+        Terminal.shared.connectBluetoothReader(foundReader, delegate: self, connectionConfig: config) { reader, error in
             if let reader = reader {
                 self.plugin?.notifyListeners(TerminalEvents.ConnectedReader.rawValue, data: [:])
                 call.resolve()
@@ -190,6 +208,7 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
         Terminal.shared.retrievePaymentIntent(clientSecret: call.getString("paymentIntent")!) { retrieveResult, retrieveError in
             if let error = retrieveError {
                 print("retrievePaymentIntent failed: \(error)")
+                call.reject(error.localizedDescription)
             } else if let paymentIntent = retrieveResult {
                 self.collectCancelable = Terminal.shared.collectPaymentMethod(paymentIntent) { collectResult, collectError in
                     if let error = collectError {
@@ -205,23 +224,6 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
         }
     }
 
-    public func cancelCollectPaymentMethod(_ call: CAPPluginCall) {
-        if let cancelable = self.collectCancelable {
-            cancelable.cancel { error in
-                if let error = error {
-                    call.reject(error.localizedDescription)
-                } else {
-                    self.plugin?.notifyListeners(TerminalEvents.Canceled.rawValue, data: [:])
-                    self.collectCancelable = nil
-                    self.paymentIntent = nil
-                    call.resolve()
-                }
-            }
-            return
-        }
-        call.resolve()
-    }
-
     public func confirmPaymentIntent(_ call: CAPPluginCall) {
         if let paymentIntent = self.paymentIntent {
             Terminal.shared.confirmPaymentIntent(paymentIntent) { confirmResult, confirmError in
@@ -250,6 +252,151 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
         call.resolve([:])
     }
 
+    public func installAvailableUpdate(_ call: CAPPluginCall) {
+        Terminal.shared.installAvailableUpdate()
+        call.resolve([:])
+    }
+
+    public func setReaderDisplay(_ call: CAPPluginCall) {
+        guard let currency = call.getString("currency") else {
+            call.reject("You must provide a currency value")
+            return
+        }
+        guard let tax = call.getInt("tax") as? NSNumber else {
+            call.reject("You must provide a tax value")
+            return
+        }
+        guard let total = call.getInt("total") as? NSNumber else {
+            call.reject("You must provide a total value")
+            return
+        }
+
+        let cartBuilder = CartBuilder(currency: currency)
+            .setTax(Int(truncating: tax))
+            .setTotal(Int(truncating: total))
+
+        let cartLineItems = TerminalMappers.mapToCartLineItems(call.getArray("lineItems") ?? JSArray())
+
+        cartBuilder.setLineItems(cartLineItems)
+
+        let cart: Cart
+        do {
+            cart = try cartBuilder.build()
+        } catch {
+            call.reject(error.localizedDescription)
+            return
+        }
+
+        Terminal.shared.setReaderDisplay(cart) { error in
+            if let error = error as NSError? {
+                call.reject(error.localizedDescription)
+            } else {
+                call.resolve([:])
+            }
+        }
+
+    }
+
+    public func clearReaderDisplay(_ call: CAPPluginCall) {
+        Terminal.shared.clearReaderDisplay { error in
+            if let error = error as NSError? {
+                call.reject(error.localizedDescription)
+            } else {
+                call.resolve([:])
+            }
+        }
+    }
+
+    public func rebootReader(_ call: CAPPluginCall) {
+        Terminal.shared.rebootReader { error in
+            if let error = error as NSError? {
+                call.reject(error.localizedDescription)
+            } else {
+                self.paymentIntent = nil
+                call.resolve([:])
+            }
+        }
+    }
+
+    /**
+     *  Cancelable
+     */
+    public func cancelInstallUpdate(_ call: CAPPluginCall) {
+        if let cancelable = self.installUpdateCancelable {
+            if cancelable.completed {
+                call.resolve()
+                return
+            }
+            cancelable.cancel { error in
+                if let error = error as NSError? {
+                    call.reject(error.localizedDescription)
+                } else {
+                    call.resolve([:])
+                }
+            }
+            return
+        }
+        call.resolve([:])
+    }
+
+    public func cancelCollectPaymentMethod(_ call: CAPPluginCall) {
+        if let cancelable = self.collectCancelable {
+            if cancelable.completed {
+                call.resolve()
+                return
+            }
+            cancelable.cancel { error in
+                if let error = error {
+                    call.reject(error.localizedDescription)
+                } else {
+                    self.plugin?.notifyListeners(TerminalEvents.Canceled.rawValue, data: [:])
+                    self.paymentIntent = nil
+                    call.resolve()
+                }
+            }
+            return
+        }
+        call.resolve()
+    }
+
+    func cancelDiscoverReaders(_ call: CAPPluginCall) {
+        if let cancelable = self.discoverCancelable {
+            if cancelable.completed {
+                call.resolve()
+                return
+            }
+            cancelable.cancel { error in
+                if let error = error {
+                    call.reject(error.localizedDescription)
+                } else {
+                    call.resolve()
+                }
+            }
+            return
+        }
+
+        call.resolve()
+    }
+
+    public func cancelReaderReconnection(_ call: CAPPluginCall) {
+        if let cancelable = self.cancelReaderConnectionCancellable {
+            if cancelable.completed {
+                call.resolve()
+                return
+            }
+            cancelable.cancel { error in
+                if let error = error as NSError? {
+                    call.reject(error.localizedDescription)
+                } else {
+                    call.resolve([:])
+                }
+            }
+            return
+        }
+
+        call.resolve()
+    }
+
     /*
      * Terminal
      */
@@ -270,7 +417,10 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
      */
 
     public func localMobileReader(_ reader: Reader, didStartInstallingUpdate update: ReaderSoftwareUpdate, cancelable: Cancelable?) {
-        self.plugin?.notifyListeners(TerminalEvents.StartInstallingUpdate.rawValue, data: self.convertReaderSoftwareUpdate(update: update))
+        self.installUpdateCancelable = cancelable
+        self.plugin?.notifyListeners(TerminalEvents.StartInstallingUpdate.rawValue, data: [
+            "update": self.convertReaderSoftwareUpdate(update: update)
+        ])
     }
 
     public func localMobileReader(_ reader: Reader, didReportReaderSoftwareUpdateProgress progress: Float) {
@@ -307,11 +457,16 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
      */
 
     public func reader(_: Reader, didReportAvailableUpdate update: ReaderSoftwareUpdate) {
-        self.plugin?.notifyListeners(TerminalEvents.ReportAvailableUpdate.rawValue, data: self.convertReaderSoftwareUpdate(update: update))
+        self.plugin?.notifyListeners(TerminalEvents.ReportAvailableUpdate.rawValue, data: [
+            "update": self.convertReaderSoftwareUpdate(update: update)
+        ])
     }
 
     public func reader(_: Reader, didStartInstallingUpdate update: ReaderSoftwareUpdate, cancelable: Cancelable?) {
-        self.plugin?.notifyListeners(TerminalEvents.StartInstallingUpdate.rawValue, data: self.convertReaderSoftwareUpdate(update: update))
+        self.installUpdateCancelable = cancelable
+        self.plugin?.notifyListeners(TerminalEvents.StartInstallingUpdate.rawValue, data: [
+            "update": self.convertReaderSoftwareUpdate(update: update)
+        ])
     }
 
     public func reader(_: Reader, didReportReaderSoftwareUpdateProgress progress: Float) {
@@ -363,19 +518,49 @@ public class StripeTerminal: NSObject, DiscoveryDelegate, LocalMobileReaderDeleg
         ])
     }
 
-    private func convertReaderInterface(reader: Reader) -> [String: String] {
-        return ["serialNumber": reader.serialNumber]
+    /*
+     * Reconnection
+     */
+    public func reader(_ reader: Reader, didStartReconnect cancelable: Cancelable, disconnectReason: DisconnectReason) {
+        self.cancelReaderConnectionCancellable = cancelable
+        self.plugin?.notifyListeners(TerminalEvents.ReaderReconnectStarted.rawValue, data: ["reader": self.convertReaderInterface(reader: reader), "reason": disconnectReason.rawValue])
+    }
+
+    public func readerDidSucceedReconnect(_ reader: Reader) {
+        self.plugin?.notifyListeners(TerminalEvents.ReaderReconnectSucceeded.rawValue, data: ["reader": self.convertReaderInterface(reader: reader)])
+    }
+
+    public func readerDidFailReconnect(_ reader: Reader) {
+        self.plugin?.notifyListeners(TerminalEvents.ReaderReconnectFailed.rawValue, data: ["reader": self.convertReaderInterface(reader: reader)])
     }
 
-    private func convertReaderSoftwareUpdate(update: ReaderSoftwareUpdate) -> [String: String] {
+    /*
+     * Private
+     */
+    private func convertReaderInterface(reader: Reader) -> JSObject {
         return [
-            "version": update.deviceSoftwareVersion,
-            "settingsVersion": update.deviceSoftwareVersion,
-            "requiredAt": update.requiredAt.description,
-            "timeEstimate": TerminalMappers.mapFromUpdateTimeEstimate(update.estimatedUpdateTime)
+            "label": reader.label ?? NSNull(),
+            "batteryLevel": (reader.batteryLevel ?? 0).intValue,
+            "batteryStatus": TerminalMappers.mapFromBatteryStatus(reader.batteryStatus),
+            "simulated": reader.simulated,
+            "serialNumber": reader.serialNumber,
+            "isCharging": (reader.isCharging ?? 0).intValue,
+            "id": reader.stripeId ?? NSNull(),
+            "availableUpdate": TerminalMappers.mapFromReaderSoftwareUpdate(reader.availableUpdate),
+            "locationId": reader.locationId ?? NSNull(),
+            "ipAddress": reader.ipAddress ?? NSNull(),
+            "status": TerminalMappers.mapFromReaderNetworkStatus(reader.status),
+            "location": TerminalMappers.mapFromLocation(reader.location),
+            "locationStatus": TerminalMappers.mapFromLocationStatus(reader.locationStatus),
+            "deviceType": TerminalMappers.mapFromDeviceType(reader.deviceType),
+            "deviceSoftwareVersion": reader.deviceSoftwareVersion ?? NSNull()
         ]
     }
 
+    private func convertReaderSoftwareUpdate(update: ReaderSoftwareUpdate) -> JSObject {
+        return TerminalMappers.mapFromReaderSoftwareUpdate(update)
+    }
+
 }
 
 class APIClient: ConnectionTokenProvider {

package/ios/Plugin/StripeTerminalPlugin.m

@@ -15,4 +15,10 @@ CAP_PLUGIN(StripeTerminalPlugin, "StripeTerminal",
            CAP_PLUGIN_METHOD(cancelCollectPaymentMethod, CAPPluginReturnPromise);
            CAP_PLUGIN_METHOD(confirmPaymentIntent, CAPPluginReturnPromise);
            CAP_PLUGIN_METHOD(setSimulatorConfiguration, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(installAvailableUpdate, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(cancelInstallUpdate, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(setReaderDisplay, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(clearReaderDisplay, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(rebootReader, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(cancelReaderReconnection, CAPPluginReturnPromise);
 )

package/ios/Plugin/StripeTerminalPlugin.swift

@@ -3,10 +3,6 @@ import StripeTerminal
 import Capacitor
 import PassKit
 
-/**
- * Please read the Capacitor iOS Plugin Development Guide
- * here: https://capacitorjs.com/docs/plugins/ios
- */
 @objc(StripeTerminalPlugin)
 public class StripeTerminalPlugin: CAPPlugin {
     private let implementation = StripeTerminal()
@@ -64,4 +60,29 @@ public class StripeTerminalPlugin: CAPPlugin {
     @objc func confirmPaymentIntent(_ call: CAPPluginCall) {
         self.implementation.confirmPaymentIntent(call)
     }
+
+    @objc func installAvailableUpdate(_ call: CAPPluginCall) {
+        self.implementation.installAvailableUpdate(call)
+    }
+
+    @objc func cancelInstallUpdate(_ call: CAPPluginCall) {
+        self.implementation.cancelInstallUpdate(call)
+    }
+
+    @objc func setReaderDisplay(_ call: CAPPluginCall) {
+        self.implementation.setReaderDisplay(call)
+    }
+
+    @objc func clearReaderDisplay(_ call: CAPPluginCall) {
+        self.implementation.clearReaderDisplay(call)
+    }
+
+    @objc func rebootReader(_ call: CAPPluginCall) {
+        self.implementation.rebootReader(call)
+    }
+
+    @objc func cancelReaderReconnection(_ call: CAPPluginCall) {
+        self.implementation.cancelReaderReconnection(call)
+    }
+
 }

package/ios/Plugin/TerminalEvents.swift

@@ -19,4 +19,7 @@ public enum TerminalEvents: String {
     case RequestDisplayMessage = "terminalRequestDisplayMessage"
     case RequestReaderInput = "terminalRequestReaderInput"
     case PaymentStatusChange = "terminalPaymentStatusChange"
+    case ReaderReconnectStarted = "terminalReaderReconnectStarted"
+    case ReaderReconnectSucceeded = "terminalReaderReconnectSucceeded"
+    case ReaderReconnectFailed = "terminalReaderReconnectFailed"
 }

package/ios/Plugin/TerminalMappers.swift

@@ -2,6 +2,133 @@ import StripeTerminal
 import Capacitor
 
 class TerminalMappers {
+    class func mapFromDeviceType(_ type: DeviceType) -> String {
+        switch type {
+        case DeviceType.appleBuiltIn: return "appleBuiltIn"
+        case DeviceType.chipper1X: return "chipper1X"
+        case DeviceType.chipper2X: return "chipper2X"
+        case DeviceType.etna: return "etna"
+        case DeviceType.stripeM2: return "stripeM2"
+        case DeviceType.stripeS700: return "stripeS700"
+        case DeviceType.stripeS700DevKit: return "stripeS700Devkit"
+        case DeviceType.verifoneP400: return "verifoneP400"
+        case DeviceType.wiseCube: return "wiseCube"
+        case DeviceType.wisePad3: return "wisePad3"
+        case DeviceType.wisePosE: return "wisePosE"
+        case DeviceType.wisePosEDevKit: return "wisePosEDevkit"
+        default: return "unknown"
+        }
+    }
+
+    class func mapFromAddress(_ address: Address?) -> JSObject {
+        if let address = address {
+            let result: JSObject = [
+                "city": address.city ?? NSNull(),
+                "country": address.country ?? NSNull(),
+                "postalCode": address.postalCode ?? NSNull(),
+                "line1": address.line1 ?? NSNull(),
+                "line2": address.line2 ?? NSNull(),
+                "state": address.state ?? NSNull()
+            ]
+            return result
+        } else {
+            return JSObject()
+        }
+    }
+
+    class func mapFromLocation(_ location: Location?) -> JSObject {
+        guard let unwrappedLocation = location else {
+            return [:]
+        }
+        let result: JSObject = [
+            "displayName": unwrappedLocation.displayName ?? NSNull(),
+            "id": unwrappedLocation.stripeId,
+            "livemode": unwrappedLocation.livemode,
+            "address": mapFromAddress(unwrappedLocation.address)
+        ]
+        return result
+    }
+
+    class func mapFromLocationStatus(_ status: LocationStatus) -> String {
+        switch status {
+        case LocationStatus.notSet: return "NOT_SET"
+        case LocationStatus.set: return "SET"
+        case LocationStatus.unknown: return "UNKNOWN"
+        default: return "UNKNOWN"
+        }
+    }
+
+    class func mapFromLocationsList(_ locations: [Location]) -> JSArray {
+        var list: JSArray = []
+
+        for location in locations {
+            let result = mapFromLocation(location)
+            if result.count != 0 {
+                list.append(result)
+            }
+        }
+
+        return list
+    }
+
+    class func mapFromReaderNetworkStatus(_ status: ReaderNetworkStatus) -> String {
+        switch status {
+        case ReaderNetworkStatus.offline: return "OFFLINE"
+        case ReaderNetworkStatus.online: return "ONLINE"
+        default: return "UNKNOWN"
+        }
+    }
+
+    class func convertDateToUnixTimestamp(date: Date?) -> String {
+        if let date = date {
+            let value = date.timeIntervalSince1970 * 1000.0
+            return String(format: "%.0f", value)
+        }
+        return ""
+    }
+
+    class func mapFromReaderSoftwareUpdate(_ update: ReaderSoftwareUpdate?) -> JSObject {
+        guard let unwrappedUpdate = update else {
+            return JSObject()
+        }
+        let result: JSObject = [
+            "deviceSoftwareVersion": unwrappedUpdate.deviceSoftwareVersion,
+            "estimatedUpdateTime": mapFromUpdateTimeEstimate(unwrappedUpdate.estimatedUpdateTime),
+            "requiredAt": convertDateToUnixTimestamp(date: unwrappedUpdate.requiredAt)
+        ]
+        return result
+    }
+
+    class func mapToCartLineItem(_ cartLineItem: NSDictionary) -> CartLineItem? {
+        guard let displayName = cartLineItem["displayName"] as? String else { return nil }
+        guard let quantity = cartLineItem["quantity"] as? NSNumber else { return nil }
+        guard let amount = cartLineItem["amount"] as? NSNumber else { return nil }
+
+        do {
+            let lineItem = try CartLineItemBuilder(displayName: displayName)
+                .setQuantity(Int(truncating: quantity))
+                .setAmount(Int(truncating: amount))
+                .build()
+            return lineItem
+        } catch {
+            print("Error wihle building CartLineItem, error:\(error)")
+            return nil
+        }
+    }
+
+    class func mapToCartLineItems(_ cartLineItems: JSArray) -> [CartLineItem] {
+        var items = [CartLineItem]()
+
+        cartLineItems.forEach {
+            if let item = $0 as? NSDictionary {
+                if let lineItem = TerminalMappers.mapToCartLineItem(item) {
+                    items.append(lineItem)
+                }
+            }
+        }
+        return items
+    }
+
     class func mapToSimulateReaderUpdate(_ update: String) -> SimulateReaderUpdate {
         switch update {
         case "UPDATE_AVAILABLE": return SimulateReaderUpdate.available

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capacitor-community/stripe-terminal",
-  "version": "6.1.0",
+  "version": "6.2.1",
   "engines": {
     "node": ">=18.0.0"
   },
@@ -77,5 +77,8 @@
     "android": {
       "src": "android"
     }
+  },
+  "dependencies": {
+    "@stripe/terminal-js": "^0.13.0"
   }
 }