assentify-sdk-react-native 1.0.0-Beta.4 → 1.0.0-Beta.41

package/ios/View/FaceMatchController.swift

@@ -4,22 +4,22 @@ import UIKit
 import AVFoundation
 import AssentifySdk
 
-class FaceMAtchController: UIViewController ,FaceMatchDelegate
+public class FaceMAtchController: UIViewController ,FaceMatchDelegate
 {
 
 
-  func onUploadingProgress(progress: Double) {
+  public func onUploadingProgress(progress: Double) {
           // NOTHING TODO
       }
      
-      func onCollectingManualImages(){
+      public func onCollectingManualImages(){
           // NOTHING TODO
       }
      
 
     private var assentifySdk:AssentifySdk?;
     private var secondImage:String = "";
-    private var nativeAssentifySdk:NativeAssentifySdk?;
+    private var nativeAssentifySdk:(any AssentifySdkEventEmitting)?;
     private var start:Bool = false;
     var infoLabel : UILabel?;
     var infoImage : UIImageView?;
@@ -34,7 +34,7 @@ class FaceMAtchController: UIViewController ,FaceMatchDelegate
     private var takePhotoButton: UIButton?;
 
 
-  init(assentifySdk: AssentifySdk, nativeAssentifySdk:NativeAssentifySdk?,holdHandColor: String,processingColor: String,secondImage:String,showCountDown:Bool,stepID:Int,manualClickColor:String) {
+  public init(assentifySdk: AssentifySdk, nativeAssentifySdk:(any AssentifySdkEventEmitting)?,holdHandColor: String,processingColor: String,secondImage:String,showCountDown:Bool,stepID:Int,manualClickColor:String) {
               self.assentifySdk = assentifySdk
               self.holdHandColor = holdHandColor
               self.processingColor = processingColor
@@ -48,14 +48,14 @@ class FaceMAtchController: UIViewController ,FaceMatchDelegate
 
 
 
-    required init?(coder: NSCoder) {
+    public required init?(coder: NSCoder) {
         fatalError("init(coder:) has not been implemented")
     }
 
-    override var prefersStatusBarHidden: Bool {
+    public override var prefersStatusBarHidden: Bool {
         return false
     }
-    override func viewDidLoad() {
+    public override func viewDidLoad() {
           super.viewDidLoad()
           self.view.backgroundColor = .clear
           UIApplication.shared.isStatusBarHidden = false;
@@ -134,7 +134,7 @@ class FaceMAtchController: UIViewController ,FaceMatchDelegate
 
       }
 
-      func onSend() {
+      public func onSend() {
           triggerEvent(eventName:"onSend",dataModel:nil)
            DispatchQueue.main.async {
               if(self.popUpMessage != nil){
@@ -145,7 +145,7 @@ class FaceMAtchController: UIViewController ,FaceMatchDelegate
           }
       }
 
-      func onError(dataModel: RemoteProcessingModel) {
+      public func onError(dataModel: RemoteProcessingModel) {
           triggerEvent(eventName:"onError",dataModel:dataModel)
           DispatchQueue.main.async {
               self.start = false;
@@ -155,7 +155,7 @@ class FaceMAtchController: UIViewController ,FaceMatchDelegate
       }
 
 
-      func onRetry(dataModel: RemoteProcessingModel) {
+      public func onRetry(dataModel: RemoteProcessingModel) {
           triggerEvent(eventName:"onRetry",dataModel:dataModel)
           DispatchQueue.main.async {
               self.start = false;
@@ -166,7 +166,7 @@ class FaceMAtchController: UIViewController ,FaceMatchDelegate
           }
       }
 
-      func onLivenessUpdate(dataModel: RemoteProcessingModel) {
+      public func onLivenessUpdate(dataModel: RemoteProcessingModel) {
           triggerEvent(eventName:"onLivenessUpdate",dataModel:dataModel)
           DispatchQueue.main.async {
               self.start = false;
@@ -176,21 +176,21 @@ class FaceMAtchController: UIViewController ,FaceMatchDelegate
       }
 
 
-    func onClipPreparationComplete(dataModel: RemoteProcessingModel) {
+    public func onClipPreparationComplete(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onClipPreparationComplete",dataModel:dataModel)
     }
 
-    func onStatusUpdated(dataModel: RemoteProcessingModel) {
+    public func onStatusUpdated(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onStatusUpdated",dataModel:dataModel)
     }
 
-    func onUpdated(dataModel: RemoteProcessingModel) {
+    public func onUpdated(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onUpdated",dataModel:dataModel)
     }
 
 
 
-     func onComplete(dataModel: FaceResponseModel) {
+     public func onComplete(dataModel: FaceResponseModel) {
 
         if let outputProperties = try? JSONSerialization.data(withJSONObject: dataModel.faceExtractedModel?.outputProperties, options: []) {
           if UserDefaults.standard.object(forKey: String(self.stepID)) != nil {
@@ -211,52 +211,52 @@ class FaceMAtchController: UIViewController ,FaceMatchDelegate
         }
     }
 
-    func onCardDetected(dataModel: RemoteProcessingModel) {
+    public func onCardDetected(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onCardDetected",dataModel:dataModel)
     }
 
-    func onMrzExtracted(dataModel: RemoteProcessingModel) {
+    public func onMrzExtracted(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onMrzExtracted",dataModel:dataModel)
     }
 
-    func onMrzDetected(dataModel: RemoteProcessingModel) {
+    public func onMrzDetected(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onMrzDetected",dataModel:dataModel)
     }
 
-    func onNoMrzDetected(dataModel: RemoteProcessingModel) {
+    public func onNoMrzDetected(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onNoMrzDetected",dataModel:dataModel)
     }
 
 
-    func onFaceDetected(dataModel: RemoteProcessingModel) {
+    public func onFaceDetected(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onFaceDetected",dataModel:dataModel)
     }
 
-    func onNoFaceDetected(dataModel: RemoteProcessingModel) {
+    public func onNoFaceDetected(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onNoFaceDetected",dataModel:dataModel)
     }
 
-    func onFaceExtracted(dataModel: RemoteProcessingModel) {
+    public func onFaceExtracted(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onFaceExtracted",dataModel:dataModel)
     }
 
-    func onQualityCheckAvailable(dataModel: RemoteProcessingModel) {
+    public func onQualityCheckAvailable(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onQualityCheckAvailable",dataModel:dataModel)
     }
 
-    func onDocumentCaptured(dataModel: RemoteProcessingModel) {
+    public func onDocumentCaptured(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onDocumentCaptured",dataModel:dataModel)
     }
 
-    func onDocumentCropped(dataModel: RemoteProcessingModel) {
+    public func onDocumentCropped(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onDocumentCropped",dataModel:dataModel)
     }
 
-    func onUploadFailed(dataModel: RemoteProcessingModel) {
+    public func onUploadFailed(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onUploadFailed",dataModel:dataModel)
     }
 
-  func onEnvironmentalConditionsChange(  brightnessEvents: BrightnessEvents,
+  public func onEnvironmentalConditionsChange(  brightnessEvents: BrightnessEvents,
                                            motion: MotionType,
                                            faceEvents: FaceEvents,
                                            zoom: ZoomType,
@@ -267,75 +267,75 @@ class FaceMAtchController: UIViewController ,FaceMatchDelegate
                 // Fetected Faces Handling
                 if (detectedFaces > 1 ) {
                             self.infoLabel?.text = "We detected more than one face.\nPlease keep just your face in view."
-                            self.infoImage!.image = UIImage(named: "info_icon")
+                            self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                 }
                 // Zoom Type Handling
                else if (zoom != ZoomType.SENDING && zoom != ZoomType.NO_DETECT) {
                     if (zoom == ZoomType.ZOOM_IN) {
                         self.infoLabel?.text = "Please Move Closer"
-                        self.infoImage!.image = UIImage(named: "zoom_in")
+                        self.infoImage!.image = UIImage(named: "zoom_in", in: Bundle.module, compatibleWith: nil)
                     }
                     if (zoom == ZoomType.ZOOM_OUT) {
                         self.infoLabel?.text = "Please Move Further"
-                        self.infoImage!.image = UIImage(named: "zoom_out")
+                        self.infoImage!.image = UIImage(named: "zoom_out", in: Bundle.module, compatibleWith: nil)
                     }
                 }
                 // Motion Type Handling
                 else if (motion != MotionType.SENDING && motion != MotionType.NO_DETECT) {
                     self.infoLabel?.text = "Please Hold Your Hand"
-                    self.infoImage!.image = UIImage(named: "info_icon")
+                    self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                 }
                 // Brightness Events Handling
                 else if (brightnessEvents != BrightnessEvents.Good) {
                     if (brightnessEvents == BrightnessEvents.TooDark) {
                         self.infoLabel?.text = "Please increase the lighting"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     }
                     if (brightnessEvents == BrightnessEvents.TooBright) {
                         self.infoLabel?.text = "Please reduce the lighting"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     }
                 }
                 // Face Events Handling
                 else if (faceEvents != FaceEvents.GOOD && faceEvents != FaceEvents.NO_DETECT) {
                     if (faceEvents == FaceEvents.ROLL_LEFT) {
                         self.infoLabel?.text = "Please tilt your head to the right"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     }
                     if (faceEvents == FaceEvents.ROLL_RIGHT) {
                         self.infoLabel?.text = "Please tilt your head to the left"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     }
                     if (faceEvents == FaceEvents.YAW_LEFT) {
                         self.infoLabel?.text = "Please turn your head to the right"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     }
                     if (faceEvents == FaceEvents.YAW_RIGHT) {
                         self.infoLabel?.text = "Please turn your head to the left"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     }
                     if (faceEvents == FaceEvents.PITCH_UP) {
                         self.infoLabel?.text = "Please lower your head"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     }
                     if (faceEvents == FaceEvents.PITCH_DOWN) {
                         self.infoLabel?.text = "Please raise your head"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     }
                 }
                 // Final Conditions
                 else {
                     if (motion == MotionType.SENDING && zoom == ZoomType.SENDING && brightnessEvents == BrightnessEvents.Good && faceEvents == FaceEvents.GOOD) {
                         self.infoLabel?.text = "Hold Steady"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     }
                     if (motion == MotionType.NO_DETECT && zoom == ZoomType.NO_DETECT && faceEvents == FaceEvents.NO_DETECT) {
                         self.infoLabel?.text = "Please face within circle"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     } else if(!isCentered){
                         self.start = false
                         self.infoLabel?.text = " Please center your face"
-                        self.infoImage!.image = UIImage(named: "info_icon")
+                        self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                     }
                 }
             } else {
@@ -348,33 +348,33 @@ class FaceMAtchController: UIViewController ,FaceMatchDelegate
         }
     }
     
-    func onCurrentLiveMoveChange(activeLiveEvents: ActiveLiveEvents) {
+    public func onCurrentLiveMoveChange(activeLiveEvents: ActiveLiveEvents) {
         DispatchQueue.main.async {
             self.currentActiveLiveEvents = activeLiveEvents
             switch activeLiveEvents {
             case .YAW_LEFT:
                 self.infoLabel?.text = "Please move your face left"
-                self.infoImage?.image = UIImage(named: "info_icon")
+                self.infoImage?.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
             case .YAW_RIGHT:
                 self.infoLabel?.text = "Please move your face right"
-                self.infoImage?.image = UIImage(named: "info_icon")
+                self.infoImage?.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
             case .PITCH_UP:
                 self.infoLabel?.text = "Please move your face up"
-                self.infoImage?.image = UIImage(named: "info_icon")
+                self.infoImage?.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
             case .PITCH_DOWN:
                 self.infoLabel?.text = "Please move your face down"
-                self.infoImage?.image = UIImage(named: "info_icon")
+                self.infoImage?.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
             case .GOOD:
                 break
             case .WINK_LEFT:
                           self.infoLabel?.text = "Please wink with your left eye"
-                          self.infoImage?.image = UIImage(named: "info_icon")
+                          self.infoImage?.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                         case .WINK_RIGHT:
                           self.infoLabel?.text = "Please wink with your right eye"
-                          self.infoImage?.image = UIImage(named: "info_icon")
+                          self.infoImage?.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                         case .BLINK:
                           self.infoLabel?.text = "Please blink your eyes"
-                          self.infoImage?.image = UIImage(named: "info_icon")
+                          self.infoImage?.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
              }
           
         }

package/ios/View/IDCardController.swift

@@ -4,10 +4,10 @@ import UIKit
 import AVFoundation
 import AssentifySdk
 
-class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControllerDelegate
+public class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControllerDelegate
 {
   
-  func onUploadingProgress(progress: Double) {
+  public func onUploadingProgress(progress: Double) {
          // NOTHING TODO
      }
   
@@ -26,7 +26,7 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
     private var showCountDown:Bool = true;
     private var templatesByCountry: TemplatesByCountry;
     private var titleID:String? = "";
-    private var nativeAssentifySdk:NativeAssentifySdk?;
+    private var nativeAssentifySdk:(any AssentifySdkEventEmitting)?;
     private var outputResultProperties: [String: Any]? = [:];
     private var scanID:ScanIDCard?;
     private var stepID:Int;
@@ -34,7 +34,7 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
     private var takePhotoButton: UIButton?;
     private var backIDPage: UIView?;
 
-  init(assentifySdk: AssentifySdk,nativeAssentifySdk:NativeAssentifySdk,holdHandColor: String,processingColor: String,templatesByCountry:TemplatesByCountry,language:String,flippingCard:Bool,titleID:String,showCountDown:Bool,apiKey:String,stepID:Int,manualClickColor:String) {
+  public init(assentifySdk: AssentifySdk,nativeAssentifySdk:any AssentifySdkEventEmitting,holdHandColor: String,processingColor: String,templatesByCountry:TemplatesByCountry,language:String,flippingCard:Bool,titleID:String,showCountDown:Bool,apiKey:String,stepID:Int,manualClickColor:String) {
           self.assentifySdk = assentifySdk
           self.nativeAssentifySdk = nativeAssentifySdk
           self.holdHandColor = holdHandColor
@@ -49,14 +49,14 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
           self.manualClickColor = manualClickColor;
           super.init(nibName: nil, bundle: nil)
       }
-    required init?(coder: NSCoder) {
+    public required init?(coder: NSCoder) {
         fatalError("init(coder:) has not been implemented")
     }
 
-    override var prefersStatusBarHidden: Bool {
+    public override var prefersStatusBarHidden: Bool {
         return false
     }
-    override func viewDidLoad() {
+    public override func viewDidLoad() {
             super.viewDidLoad()
             self.view.backgroundColor = .clear
             UIApplication.shared.isStatusBarHidden = false;
@@ -138,7 +138,7 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
 
         }
 
-        func onSend() {
+        public func onSend() {
             triggerEvent(eventName:"onSend",dataModel:nil)
             DispatchQueue.main.async {
                 if(self.popUpMessage != nil){
@@ -149,7 +149,7 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
             }
         }
 
-        func onError(dataModel: RemoteProcessingModel) {
+        public func onError(dataModel: RemoteProcessingModel) {
             triggerEvent(eventName:"onError",dataModel:dataModel)
             DispatchQueue.main.async {
                 self.start = false;
@@ -159,7 +159,7 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
         }
 
 
-        func onRetry(dataModel: RemoteProcessingModel) {
+        public func onRetry(dataModel: RemoteProcessingModel) {
             triggerEvent(eventName:"onRetry",dataModel:dataModel)
             DispatchQueue.main.async {
                 self.start = false;
@@ -170,16 +170,19 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
             }
         }
 
-        func onLivenessUpdate(dataModel: RemoteProcessingModel) {
+        public func onLivenessUpdate(dataModel: RemoteProcessingModel, image: UIImage?) {
             triggerEvent(eventName:"onLivenessUpdate",dataModel:dataModel)
             DispatchQueue.main.async {
+              self.scanID?.retryLiveness();
                 self.start = false;
+              if( self.popUpMessage != nil){
                 self.popUpMessage!.removeFromSuperview();
+              }
                 self.popUpMessage =  showPopUpMessage(view: self.view, title: "Please use your original physical ID card, not a photo or copy.", subTitle: "Please real ID (Not copy)",initialTextColorHex:self.processingColor,initialBackgroundColorHex:self.holdHandColor, iconName: "id_warning", isGif: false,target: self, action: #selector(self.dismissPopUpMessage))
             }
         }
 
-        func onWrongTemplate(dataModel:RemoteProcessingModel) {
+        public func onWrongTemplate(dataModel:RemoteProcessingModel) {
             triggerEvent(eventName:"onWrongTemplate",dataModel:dataModel)
             DispatchQueue.main.async {
                 self.start = false;
@@ -187,21 +190,21 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
                 self.popUpMessage =  showPopUpMessage(view: self.view, title: "Please double-check that you selected the correct ID type and are presenting this ID type.", subTitle: "Let's try again",initialTextColorHex:self.processingColor,initialBackgroundColorHex:self.holdHandColor, iconName: "id_warning", isGif: false,target: self, action: #selector(self.dismissPopUpMessage))
             }
         }
-    func onClipPreparationComplete(dataModel: RemoteProcessingModel) {
+    public func onClipPreparationComplete(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onClipPreparationComplete",dataModel:dataModel)
     }
 
-    func onStatusUpdated(dataModel: RemoteProcessingModel) {
+    public func onStatusUpdated(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onStatusUpdated",dataModel:dataModel)
     }
 
-    func onUpdated(dataModel: RemoteProcessingModel) {
+    public func onUpdated(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onUpdated",dataModel:dataModel)
     }
 
 
 
-  func onComplete(dataModel: IDResponseModel ,isFrontPage:Bool,isLastPage:Bool,classifiedTemplate: String) {
+  public func onComplete(dataModel: IDResponseModel ,isFrontPage:Bool,isLastPage:Bool,classifiedTemplate: String) {
 
     self.triggerCompleteEvent(eventName:"onComplete",dataModel:dataModel.iDExtractedModel,isFrontPage:isFrontPage,isLastPage: isLastPage ,classifiedTemplate:classifiedTemplate)
 
@@ -280,52 +283,105 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
 
     }
 
-    func onCardDetected(dataModel: RemoteProcessingModel) {
+    public func onCardDetected(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onCardDetected",dataModel:dataModel)
     }
 
-    func onMrzExtracted(dataModel: RemoteProcessingModel) {
+    public func onMrzExtracted(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onMrzExtracted",dataModel:dataModel)
     }
 
-    func onMrzDetected(dataModel: RemoteProcessingModel) {
+    public func onMrzDetected(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onMrzDetected",dataModel:dataModel)
     }
 
-    func onNoMrzDetected(dataModel: RemoteProcessingModel) {
+    public func onNoMrzDetected(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onNoMrzDetected",dataModel:dataModel)
     }
 
 
-    func onFaceDetected(dataModel: RemoteProcessingModel) {
+    public func onFaceDetected(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onFaceDetected",dataModel:dataModel)
     }
 
-    func onNoFaceDetected(dataModel: RemoteProcessingModel) {
+    public func onNoFaceDetected(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onNoFaceDetected",dataModel:dataModel)
     }
 
-    func onFaceExtracted(dataModel: RemoteProcessingModel) {
+    public func onFaceExtracted(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onFaceExtracted",dataModel:dataModel)
     }
 
-    func onQualityCheckAvailable(dataModel: RemoteProcessingModel) {
+    public func onQualityCheckAvailable(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onQualityCheckAvailable",dataModel:dataModel)
     }
 
-    func onDocumentCaptured(dataModel: RemoteProcessingModel) {
+    public func onDocumentCaptured(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onDocumentCaptured",dataModel:dataModel)
     }
 
-    func onDocumentCropped(dataModel: RemoteProcessingModel) {
+    public func onDocumentCropped(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onDocumentCropped",dataModel:dataModel)
     }
 
-    func onUploadFailed(dataModel: RemoteProcessingModel) {
+    public func onUploadFailed(dataModel: RemoteProcessingModel) {
         triggerEvent(eventName:"onUploadFailed",dataModel:dataModel)
     }
+  
+
+  private var livenessActive = false
+
+  
+  
+  public func onLivenessInstruction(instruction: IdLivenessInstruction, progress: Int) {
+      DispatchQueue.main.async {
+          // the liveness owns the message while it runs (not after "keep holding" / "barcode read": the result is coming)
+          self.livenessActive = instruction != .keepHolding && instruction != .barcodeRead
+
+          var text: String
+          switch instruction {
+          // ---------- position ----------
+          case .placeCard:       text = "Place the card\nin the frame"
+          // ---------- flat hold ----------
+          case .keepSteady:      text = "Keep it steady"
+          case .keepFlat:        text = "Hold the card flat"
+          case .adjustPosition:  text = "Tilt slightly\nto avoid glare"
+          // ---------- light ----------
+          case .doNotMove:       text = "Keep it steady\nLight is on"
+          // ---------- tilt ----------
+          case .liftRight:       text = "Lift the right edge\ntoward you"
+          case .liftTop:         text = "Lift the top edge\ntoward you"
+          case .liftBottom:      text = "Lift the bottom edge\ntoward you"
+          case .aBitMore:        text = "A bit more\nand hold"
+          case .holdThere:       text = "Hold it there"
+          case .otherEdge:       text = "Lift the other edge"
+          case .pickUp:          text = "Hold the card\nin your hand"
+          // ---------- done ----------
+          case .keepHolding:     text = "Keep holding\nAlmost done"
+          // ---------- ID back: the barcode ----------
+          case .readingBarcode:  text = "Reading the barcode\nKeep it steady"
+          case .barcodeRead:     text = "Barcode read"
+          // ---------- pauses (the SDK continues by itself after a few seconds) ----------
+          case .holdInHand:      text = "Hold it in your hand\nnot on the table"
+          case .phoneTurned:     text = "Keep the phone still\nTilt the card"
+          case .tooBright:       text = "Too much light\nMove to the shade"
+          @unknown default:      text = ""
+          }
+
+          // the tilt progress (0..100), on its own line, only while the card is being tilted
+          switch instruction {
+          case .liftRight, .liftTop, .liftBottom, .aBitMore, .holdThere, .otherEdge, .pickUp:
+              text += "\n\(progress)%"
+          default:
+              break
+          }
+
+          self.infoLabel?.text = text
+          self.infoImage?.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
+      }
+  }
 
-  func onEnvironmentalConditionsChange( brightnessEvents: BrightnessEvents,
+  public func onEnvironmentalConditionsChange( brightnessEvents: BrightnessEvents,
                                            motion: MotionType,
                                            zoom: ZoomType,
                                            isCentered: Bool,) {
@@ -335,42 +391,42 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
                      if (zoom == ZoomType.ZOOM_IN) {
                          self.start = false
                          self.infoLabel?.text = "Move ID Closer"
-                         self.infoImage!.image = UIImage(named: "zoom_in")
+                         self.infoImage!.image = UIImage(named: "zoom_in", in: Bundle.module, compatibleWith: nil)
                      }
                      if (zoom == ZoomType.ZOOM_OUT) {
                          self.start = false
                          self.infoLabel?.text = "Move ID Further"
-                         self.infoImage!.image = UIImage(named: "zoom_out")
+                         self.infoImage!.image = UIImage(named: "zoom_out", in: Bundle.module, compatibleWith: nil)
                      }
                  } else if (motion != MotionType.SENDING && motion != MotionType.NO_DETECT) {
                      self.start = false
                      self.infoLabel?.text = "Please Hold Your Hand"
-                     self.infoImage!.image = UIImage(named: "info_icon")
+                     self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                  } else if brightnessEvents != BrightnessEvents.Good {
                      if brightnessEvents == BrightnessEvents.TooDark {
                          self.start = false
                          self.infoLabel?.text = "Please increase the lighting"
-                         self.infoImage!.image = UIImage(named: "info_icon")
+                         self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                      }
                      if brightnessEvents == BrightnessEvents.TooBright {
                          self.start = false
                          self.infoLabel?.text = "Please reduce the lighting"
-                         self.infoImage!.image = UIImage(named: "info_icon")
+                         self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                      }
                  } else {
                      if (motion == MotionType.SENDING && zoom == ZoomType.SENDING && brightnessEvents == BrightnessEvents.Good) {
                          self.start = false
                          self.infoLabel?.text = "Hold Steady"
-                         self.infoImage!.image = UIImage(named: "info_icon")
+                         self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                      }
                      if (motion == MotionType.NO_DETECT && zoom == ZoomType.NO_DETECT) {
                          self.start = false
                          self.infoLabel?.text = "Please present ID"
-                         self.infoImage!.image = UIImage(named: "info_icon")
+                         self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                      } else if(!isCentered){
                          self.start = false
                          self.infoLabel?.text = " Please center your card"
-                         self.infoImage!.image = UIImage(named: "info_icon")
+                         self.infoImage!.image = UIImage(named: "info_icon", in: Bundle.module, compatibleWith: nil)
                      }
                  }
              } else {
@@ -418,7 +474,7 @@ class IDCardController: UIViewController ,ScanIDCardDelegate , ChildViewControll
 
 
     func playVideoInView(videoName: String, ofType fileType: String, in view: UIView, fullscreen: Bool) {
-        guard let path = Bundle.main.path(forResource: videoName, ofType: fileType) else {
+        guard let path = Bundle.module.path(forResource: videoName, ofType: fileType) else {
             print("Video file not found")
             return
         }