feat: add onBrowserPageNavigationCompleted event

Author: andredestro

OSInAppBrowserLib/RouterAdapters/OSIABApplicationRouterAdapter.swift

@@ -9,7 +9,7 @@ public protocol OSIABApplicationDelegate: AnyObject {
 
 /// Provide a default implementations that abstracts the options parameter.
 extension OSIABApplicationDelegate {
-    func open(_ url: URL, options: [UIApplication.OpenExternalURLOptionsKey: Any] = [:], completionHandler completion: ((Bool) -> Void)?) {
+    public func open(_ url: URL, options: [UIApplication.OpenExternalURLOptionsKey: Any] = [:], completionHandler completion: ((Bool) -> Void)?) {
         self.open(url, options: options, completionHandler: completion)
     }
 }

OSInAppBrowserLib/WebView/OSIABWebViewCallbackHandler.swift

@@ -10,7 +10,9 @@ public struct OSIABWebViewCallbackHandler {
     let onBrowserPageLoad: () -> Void
     /// Callback to trigger when the browser is closed. The boolean arguments indicates if the browser was already close or still needs to be.
     let onBrowserClosed: (Bool) -> Void
-    
+    /// Callback to trigger when the browser finishes navigation. The argument can be used to send data back to OS
+    let onBrowserPageNavigationCompleted: ([String:String]?) -> Void
+
     /// Constructor method.
     /// - Parameters:
     ///   - onDelegateURL: Callback to trigger when the an URL needs to be delegates to its callers.
@@ -21,11 +23,13 @@ public struct OSIABWebViewCallbackHandler {
         onDelegateURL: @escaping (URL) -> Void,
         onDelegateAlertController: @escaping (UIAlertController) -> Void,
         onBrowserPageLoad: @escaping () -> Void,
-        onBrowserClosed: @escaping (Bool) -> Void // boolean indicates if the browser is already closed.
+        onBrowserClosed: @escaping (Bool) -> Void, // boolean indicates if the browser is already closed.
+        onBrowserPageNavigationCompleted: @escaping ([String:String]?) -> Void
     ) {
         self.onDelegateURL = onDelegateURL
         self.onDelegateAlertController = onDelegateAlertController
         self.onBrowserPageLoad = onBrowserPageLoad
         self.onBrowserClosed = onBrowserClosed
+        self.onBrowserPageNavigationCompleted = onBrowserPageNavigationCompleted
     }
 }

OSInAppBrowserLib/WebView/OSIABWebViewModel.swift

@@ -182,6 +182,9 @@ extension OSIABWebViewModel: WKNavigationDelegate {
         if !self.firstLoadDone {
             self.callbackHandler.onBrowserPageLoad()
             self.firstLoadDone = true
+        } else {
+            let data = ["url": url.absoluteString]
+            self.callbackHandler.onBrowserPageNavigationCompleted(data)
         }
         error = nil
     }

OSInAppBrowserLib/WebView/Views/OSIABWebView.swift

@@ -96,7 +96,8 @@ private extension OSIABWebViewModel {
                 onDelegateURL: { _ in },
                 onDelegateAlertController: { _ in },
                 onBrowserPageLoad: {},
-                onBrowserClosed: onBrowserClosed
+                onBrowserClosed: onBrowserClosed,
+                onBrowserPageNavigationCompleted: { _ in }
             )
         )
     }

OSInAppBrowserLib/WebView/Views/OSIABWebView13WrapperView.swift

@@ -58,7 +58,8 @@ private extension OSIABWebViewModel {
                 onDelegateURL: { _ in },
                 onDelegateAlertController: { _ in },
                 onBrowserPageLoad: {},
-                onBrowserClosed: { _ in }
+                onBrowserClosed: { _ in },
+                onBrowserPageNavigationCompleted: { _ in }
             )
         )
     }
@@ -73,7 +74,8 @@ private extension OSIABWebViewModel {
                 onDelegateURL: { _ in },
                 onDelegateAlertController: { _ in },
                 onBrowserPageLoad: {},
-                onBrowserClosed: { _ in }
+                onBrowserClosed: { _ in },
+                onBrowserPageNavigationCompleted:  { _ in }
             )
         )
     }

OSInAppBrowserLib/WebView/Views/OSIABWebViewWrapperView.swift

@@ -35,7 +35,8 @@ private extension OSIABWebViewModel {
                 onDelegateURL: { _ in },
                 onDelegateAlertController: { _ in },
                 onBrowserPageLoad: {},
-                onBrowserClosed: { _ in }
+                onBrowserClosed: { _ in },
+                onBrowserPageNavigationCompleted: { _ in }
             )
         )
     }
@@ -50,7 +51,8 @@ private extension OSIABWebViewModel {
                 onDelegateURL: { _ in },
                 onDelegateAlertController: { _ in },
                 onBrowserPageLoad: {},
-                onBrowserClosed: { _ in }
+                onBrowserClosed: { _ in },
+                onBrowserPageNavigationCompleted: { _ in }
             )
         )
     }