[V3] Add Venmo install check (#78)

* Add venmo scheme to the allowlist in info.plist.

* Add URLOpenet protocol and uiapplication extension

* Add Venmo installed validation and pass it to the user script.

* Add docstring

* Use internal instead of static

* Remove bool description

* Update CHANGELOG

* Update README

* Update V3 migration guide

Author: richherrera

CHANGELOG.md

@@ -4,6 +4,7 @@
 * Bump minimum supported deployment target to iOS 16+
 * Require Xcode 16.2.0+ and Swift 5.10+
 * Add the `prefersEphemeralWebBrowserSession` property to the `POPPopupBridge` initializer, which specifies whether to request a private authentication session from the browser.
+* Add validation to check if the Venmo app is installed on the device.
 
 ## 2.2.0  (2025-02-05)
 * Require Xcode 15.0+ and Swift 5.9+ (per [App Store requirements](https://developer.apple.com/news/?id=khzvxn8a))

Demo/Demo/Info.plist

@@ -58,5 +58,9 @@
 		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
 	</array>
+	<key>LSApplicationQueriesSchemes</key>
+	<array>
+		<string>com.venmo.touch.v2</string>
+	</array>
 </dict>
 </plist>

PopupBridge.xcodeproj/project.pbxproj

@@ -11,6 +11,7 @@
 		45CD0C2E2D664D140072C5A4 /* Date+MilisecondTimestamp.swift in Sources */ = {isa = PBXBuildFile; fileRef = 45CD0C2D2D664CF50072C5A4 /* Date+MilisecondTimestamp.swift */; };
 		45CD0C302D6788A10072C5A4 /* Bundle+Extension.swift in Sources */ = {isa = PBXBuildFile; fileRef = 45CD0C2F2D67888F0072C5A4 /* Bundle+Extension.swift */; };
 		45CD0C322D6793FB0072C5A4 /* PopupBridgeAnalytics.swift in Sources */ = {isa = PBXBuildFile; fileRef = 45CD0C312D6793F90072C5A4 /* PopupBridgeAnalytics.swift */; };
+		45FC74C22D8347B500E50035 /* UIApplication+URLOpener.swift in Sources */ = {isa = PBXBuildFile; fileRef = 45FC74C12D8347AA00E50035 /* UIApplication+URLOpener.swift */; };
 		62D5EC522B9F753100D09C5D /* PrivacyInfo.xcprivacy in Resources */ = {isa = PBXBuildFile; fileRef = 62D5EC512B9F753100D09C5D /* PrivacyInfo.xcprivacy */; };
 		79DB9F7F53319F206CDE119E /* Pods_UnitTests.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 28245E4F1AC5126D54985D88 /* Pods_UnitTests.framework */; };
 		800A09D82995F143003ED16E /* POPPopupBridge.swift in Sources */ = {isa = PBXBuildFile; fileRef = 800A09D72995F143003ED16E /* POPPopupBridge.swift */; };
@@ -34,6 +35,7 @@
 		45CD0C2D2D664CF50072C5A4 /* Date+MilisecondTimestamp.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "Date+MilisecondTimestamp.swift"; sourceTree = "<group>"; };
 		45CD0C2F2D67888F0072C5A4 /* Bundle+Extension.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "Bundle+Extension.swift"; sourceTree = "<group>"; };
 		45CD0C312D6793F90072C5A4 /* PopupBridgeAnalytics.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PopupBridgeAnalytics.swift; sourceTree = "<group>"; };
+		45FC74C12D8347AA00E50035 /* UIApplication+URLOpener.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "UIApplication+URLOpener.swift"; sourceTree = "<group>"; };
 		4EF7C7DDAB0B99FF28DD6541 /* Pods-UnitTests.debug.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; name = "Pods-UnitTests.debug.xcconfig"; path = "Target Support Files/Pods-UnitTests/Pods-UnitTests.debug.xcconfig"; sourceTree = "<group>"; };
 		6003F58D195388D20070C39A /* Foundation.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Foundation.framework; path = System/Library/Frameworks/Foundation.framework; sourceTree = SDKROOT; };
 		6003F58F195388D20070C39A /* CoreGraphics.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = CoreGraphics.framework; path = System/Library/Frameworks/CoreGraphics.framework; sourceTree = SDKROOT; };
@@ -163,6 +165,7 @@
 		A775A08C1DEE4EF0009E67C2 /* PopupBridge */ = {
 			isa = PBXGroup;
 			children = (
+				45FC74C12D8347AA00E50035 /* UIApplication+URLOpener.swift */,
 				45CD0C2F2D67888F0072C5A4 /* Bundle+Extension.swift */,
 				45CD0C2D2D664CF50072C5A4 /* Date+MilisecondTimestamp.swift */,
 				45CD0C2B2D64F0810072C5A4 /* FPTIBatchData.swift */,
@@ -331,6 +334,7 @@
 				800E789F29E09A2A00D1B0FC /* URLDetailsPayload.swift in Sources */,
 				45CD0C302D6788A10072C5A4 /* Bundle+Extension.swift in Sources */,
 				BEF9ED232A2A6A2C005D54AB /* PopupBridgeConstants.swift in Sources */,
+				45FC74C22D8347B500E50035 /* UIApplication+URLOpener.swift in Sources */,
 				800A09D82995F143003ED16E /* POPPopupBridge.swift in Sources */,
 				BE8E37B62A17B79E00181FDA /* WebAuthenticationSession.swift in Sources */,
 				45CD0C2C2D64F08F0072C5A4 /* FPTIBatchData.swift in Sources */,

README.md

@@ -37,6 +37,16 @@ To integrate using Swift Package Manager, select File > Swift Packages > Add Pac
 
 If you look at your app target, you will see that `PopupBridge` is automatically linked as a framework to your app (see General > Frameworks, Libraries, and Embedded Content).
 
+### Allowlist Venmo URL scheme
+You must add the following to the queries schemes allowlist in your app's info.plist:
+
+``` xml
+<key>LSApplicationQueriesSchemes</key>
+<array>
+  <string>com.venmo.touch.v2</string>
+</array>
+```
+
 Sample App
 -------
 

Sources/PopupBridge/POPPopupBridge.swift

@@ -13,6 +13,7 @@ public class POPPopupBridge: NSObject, WKScriptMessageHandler {
     private let messageHandlerName = "POPPopupBridge"
     private let hostName = "popupbridgev1"    
     private let webView: WKWebView
+    private let application: URLOpener = UIApplication.shared
     private var webAuthenticationSession: WebAuthenticationSession = WebAuthenticationSession()
 
     private var returnBlock: ((URL) -> Void)? = nil
@@ -92,7 +93,8 @@ public class POPPopupBridge: NSObject, WKScriptMessageHandler {
         let javascript = PopupBridgeUserScript(
             scheme: PopupBridgeConstants.callbackURLScheme,
             scriptMessageHandlerName: messageHandlerName,
-            host: hostName
+            host: hostName,
+            isVenmoInstalled: application.isVenmoAppInstalled()
         ).rawJavascript
 
         let script = WKUserScript(

Sources/PopupBridge/PopupBridgeUserScript.swift

@@ -5,6 +5,7 @@ struct PopupBridgeUserScript {
     let scheme: String
     let scriptMessageHandlerName: String
     let host: String
+    let isVenmoInstalled: Bool
 
     var rawJavascript: String {
         """
@@ -15,6 +16,8 @@ struct PopupBridgeUserScript {
                 return '\(scheme)://\(host)/';
             };
             
+            window.popupBridge.isVenmoInstalled = \(isVenmoInstalled);
+            
             window.popupBridge.open = function open(url) {
                 window.webkit.messageHandlers.\(scriptMessageHandlerName)
                     .postMessage({

Sources/PopupBridge/UIApplication+URLOpener.swift

@@ -0,0 +1,17 @@
+import UIKit
+
+protocol URLOpener {
+    
+    func isVenmoAppInstalled() -> Bool
+}
+
+extension UIApplication: URLOpener {
+    
+    /// Indicates whether the Venmo App is installed.
+    func isVenmoAppInstalled() -> Bool {
+        guard let venmoURL = URL(string: "com.venmo.touch.v2://") else {
+            return false
+        }
+        return canOpenURL(venmoURL)
+    }
+}

V3_MIGRATION.md

@@ -5,3 +5,14 @@ See the [CHANGELOG](/CHANGELOG.md) for a complete list of changes. This migratio
 ## Supported Versions
 
 v3 supports a minimum deployment target of iOS 16+. It requires Xcode 16.2.0+ and Swift 5.10+. If your application contains Objective-C code, the `Enable Modules` build setting must be set to `YES`.
+
+## Venmo
+
+### Allowlist Venmo URL scheme
+You must add the following to the queries schemes allowlist in your app's info.plist:
+
+``` xml
+<key>LSApplicationQueriesSchemes</key>
+<array>
+  <string>com.venmo.touch.v2</string>
+</array>