CORE-2088 add willShowPasteboardToast method

Author: echo-branch

Branch-SDK/BNCPasteboard.h

@@ -12,9 +12,13 @@ NS_ASSUME_NONNULL_BEGIN
 
 @interface BNCPasteboard : NSObject
 
-// For v1, we only allow check on install requests
+// For v1, we only allow check on install requests. By default, this is NO
 @property (nonatomic,assign) BOOL checkOnInstall;
 
+@property (nonatomic, assign, nullable) NSURL *branchLink;
+
+- (BOOL)isUrlOnPasteboard;
+
 - (nullable NSURL *)checkForBranchLink;
 
 + (BNCPasteboard *)sharedInstance;

Branch-SDK/BNCPasteboard.m

@@ -29,20 +29,26 @@ - (instancetype)init {
     return self;
 }
 
-- (nullable NSURL *)checkForBranchLink {
-    
+- (BOOL)isUrlOnPasteboard {
 #if !TARGET_OS_TV
     if (@available(iOS 10.0, *)) {
         if ([UIPasteboard.generalPasteboard hasURLs]) {
-            
-            // triggers the end user toast message
-            NSURL *tmp = UIPasteboard.generalPasteboard.URL;
-            if ([Branch isBranchLink:tmp.absoluteString]) {
-                return tmp;
-            }
+            return YES;
         }
     }
 #endif
+    return NO;
+}
+
+- (nullable NSURL *)checkForBranchLink {
+    if ([self isUrlOnPasteboard]) {
+        // triggers the end user toast message
+        NSURL *tmp = UIPasteboard.generalPasteboard.URL;
+        if ([Branch isBranchLink:tmp.absoluteString]) {
+            self.branchLink = tmp;
+            return tmp;
+        }
+    }
     return nil;
 }
 

Branch-SDK/Branch.h

@@ -684,6 +684,16 @@ typedef NS_ENUM(NSUInteger, BranchCreditHistoryOrder) {
  */
 - (void)checkPasteboardOnInstall;
 
+/**
+ Let's client know if the Branch SDK will trigger a pasteboard toast to the end user.
+ All of the following conditions must be true.
+ 
+ 1. Developer called checkPastboardOnInstall before initSession
+ 2. A URL is on the pasteboard
+ 3. First time app is run with Branch SDK
+ */
+- (BOOL)willShowPasteboardToast;
+
 /**
  Set the AppGroup used to share data between the App Clip and the Full App.
  

Branch-SDK/Branch.m

@@ -949,6 +949,15 @@ - (void)checkPasteboardOnInstall {
     [BNCPasteboard sharedInstance].checkOnInstall = YES;
 }
 
+- (BOOL)willShowPasteboardToast {
+    if (!self.preferenceHelper.identityID &&
+        [BNCPasteboard sharedInstance].checkOnInstall &&
+        [BNCPasteboard sharedInstance].isUrlOnPasteboard) {
+        return YES;
+    }
+    return NO;
+}
+
 - (void)checkAppleSearchAdsAttribution {
     #if !TARGET_OS_TV
     if (![BNCAppleSearchAds sharedInstance].enableAppleSearchAdsCheck) {