Release 1.44.0

- SDK-1658 Added Support for VIEW_AD, INITIATE_STREAM, COMPLETE_STREAM and all V2 Events as Standard events
- SDK-1480 [iOS 16] Added UIPaste Support for NativeLink Flow

Author: NidhiDixit09

Branch-SDK/BNCConfig.m

@@ -11,4 +11,4 @@
 NSString * const BNC_API_BASE_URL    = @"https://api2.branch.io";
 NSString * const BNC_API_VERSION     = @"v1";
 NSString * const BNC_LINK_URL        = @"https://bnc.lt";
-NSString * const BNC_SDK_VERSION     = @"1.43.2";
+NSString * const BNC_SDK_VERSION     = @"1.44.0";

Branch-SDK/BNCPreferenceHelper.h

@@ -29,9 +29,10 @@ NSURL* /* _Nonnull */ BNCURLForBranchDirectory(void);
 @property (copy, nonatomic) NSString *sessionID;
 @property (copy, nonatomic) NSString *linkClickIdentifier;
 @property (copy, nonatomic) NSString *spotlightIdentifier;
-@property (copy, nonatomic)    NSString *universalLinkUrl;
-@property (copy, nonatomic)    NSString *initialReferrer;
+@property (copy, nonatomic) NSString *universalLinkUrl;
+@property (copy, nonatomic) NSString *initialReferrer;
 @property (copy, nonatomic) NSString *userUrl;
+@property (copy, nonatomic) NSString *localUrl;
 @property (copy, nonatomic) NSString *userIdentity;
 @property (copy, nonatomic) NSString *sessionParams;
 @property (copy, nonatomic) NSString *installParams;

Branch-SDK/BNCPreferenceHelper.m

@@ -36,6 +36,7 @@
 static NSString * const BRANCH_PREFS_KEY_LINK_CLICK_IDENTIFIER = @"bnc_link_click_identifier";
 static NSString * const BRANCH_PREFS_KEY_SPOTLIGHT_IDENTIFIER = @"bnc_spotlight_identifier";
 static NSString * const BRANCH_PREFS_KEY_UNIVERSAL_LINK_URL = @"bnc_universal_link_url";
+static NSString * const BRANCH_PREFS_KEY_LOCAL_URL = @"bnc_local_url";
 static NSString * const BRANCH_PREFS_KEY_INITIAL_REFERRER = @"bnc_initial_referrer";
 static NSString * const BRANCH_PREFS_KEY_SESSION_PARAMS = @"bnc_session_params";
 static NSString * const BRANCH_PREFS_KEY_INSTALL_PARAMS = @"bnc_install_params";
@@ -80,6 +81,7 @@ @implementation BNCPreferenceHelper
             installParams = _installParams,
             universalLinkUrl = _universalLinkUrl,
             initialReferrer = _initialReferrer,
+            localUrl = _localUrl,
             externalIntentURI = _externalIntentURI,
             isDebug = _isDebug,
             retryCount = _retryCount,
@@ -325,6 +327,14 @@ - (void)setUniversalLinkUrl:(NSString *)universalLinkUrl {
     [self writeObjectToDefaults:BRANCH_PREFS_KEY_UNIVERSAL_LINK_URL value:universalLinkUrl];
 }
 
+- (NSString *)localUrl {
+    return [self readStringFromDefaults:BRANCH_PREFS_KEY_LOCAL_URL];
+}
+
+- (void)setLocalUrl:(NSString *)localURL {
+    [self writeObjectToDefaults:BRANCH_PREFS_KEY_LOCAL_URL value:localURL];
+}
+
 - (NSString *)initialReferrer {
     return [self readStringFromDefaults:BRANCH_REQUEST_KEY_INITIAL_REFERRER];
 }

Branch-SDK/Branch.h

@@ -10,6 +10,7 @@
 @import Foundation;
 #else
 #import <Foundation/Foundation.h>
+#import <UniformTypeIdentifiers/UniformTypeIdentifiers.h>
 #endif
 
 #import "BNCCallbacks.h"
@@ -1838,6 +1839,16 @@ typedef NS_ENUM(NSUInteger, BranchCreditHistoryOrder) {
 // Read-only property exposed for unit testing.
 @property (strong, readonly) BNCServerInterface* serverInterface;
 - (void) clearNetworkQueue;
+
+#if !TARGET_OS_TV
+#pragma mark - UIPasteControl Support
+/**
+ This method is used to pass paste board items to Branch SDK when user implements UIPasteControl at their end. SDK retrives URL from these item providers if any to support native link functionality.
+ @param itemProviders - an array of item providers collected from pasteboard.
+ @warning This function works with  iOS 16 or above.
+ */
+- (void)passPasteItemProviders:(NSArray<NSItemProvider *> *)itemProviders API_AVAILABLE(ios(16));
+#endif
 @end
 
 NS_ASSUME_NONNULL_END

Branch-SDK/Branch.m

@@ -1592,6 +1592,30 @@ - (void)removeAllPrivateContentFromSpotLightWithCallback:(void (^)(NSError * err
 }
 #endif
 
+#if !TARGET_OS_TV
+#pragma mark - UIPasteControl Support methods
+
+- (void)passPasteItemProviders:(NSArray<NSItemProvider *> *)itemProviders {
+    
+   // 1. Extract URL from NSItemProvider arrary
+    for (NSItemProvider* item in itemProviders){
+        if ( [item hasItemConformingToTypeIdentifier: UTTypeURL.identifier] ) {
+            // 2. Check if URL is branch URL and if yes -> store it.
+            [item loadItemForTypeIdentifier:UTTypeURL.identifier options:NULL completionHandler:^(NSURL *url, NSError * _Null_unspecified error) {
+                if (error) {
+                    BNCLogError([NSString stringWithFormat:@"%@", error]);
+                }
+                else if ([Branch isBranchLink:url.absoluteString]) {
+                    [self.preferenceHelper setLocalUrl:[url absoluteString]];
+                    // 3. Send Open Event
+                    [[Branch getInstance] handleDeepLink:url];
+                }
+            }];
+        }
+    }
+}
+#endif
+
 #pragma mark - Private methods
 
 + (Branch *)getInstanceInternal:(NSString *)key {
@@ -2124,7 +2148,6 @@ - (void)initUserSessionAndCallCallback:(BOOL)callCallback sceneIdentifier:(NSStr
 
             // callback on main, this is generally what the client expects and maintains our previous behavior
             dispatch_async(dispatch_get_main_queue(), ^ {
-
                 if (self.sceneSessionInitWithCallback) {
                     BNCInitSessionResponse *response = [BNCInitSessionResponse new];
                     response.params = [self getLatestReferringParams];

Branch-SDK/BranchEvent.h

@@ -35,6 +35,9 @@ FOUNDATION_EXPORT BranchStandardEvent _Nonnull BranchStandardEventViewItem;
 FOUNDATION_EXPORT BranchStandardEvent _Nonnull BranchStandardEventViewItems;
 FOUNDATION_EXPORT BranchStandardEvent _Nonnull BranchStandardEventRate;
 FOUNDATION_EXPORT BranchStandardEvent _Nonnull BranchStandardEventShare;
+FOUNDATION_EXPORT BranchStandardEvent _Nonnull BranchStandardEventInitiateStream;
+FOUNDATION_EXPORT BranchStandardEvent _Nonnull BranchStandardEventCompleteStream;
+
 
 ///@name User Lifecycle Events
 

Branch-SDK/BranchEvent.m

@@ -36,6 +36,8 @@
 BranchStandardEvent BranchStandardEventViewItems          = @"VIEW_ITEMS";
 BranchStandardEvent BranchStandardEventRate               = @"RATE";
 BranchStandardEvent BranchStandardEventShare              = @"SHARE";
+BranchStandardEvent BranchStandardEventInitiateStream     = @"INITIATE_STREAM";
+BranchStandardEvent BranchStandardEventCompleteStream     = @"COMPLETE_STREAM";
 
 // User Lifecycle Events
 
@@ -245,6 +247,8 @@ - (NSDictionary*) dictionary {
         BranchStandardEventViewAd,
         BranchStandardEventOptOut,
         BranchStandardEventOptIn,
+        BranchStandardEventInitiateStream,
+        BranchStandardEventCompleteStream
     ];
 }
 

Branch-SDK/BranchInstallRequest.m

@@ -26,6 +26,7 @@ - (id)initWithCallback:(callbackWithStatus)callback {
 - (void)makeRequest:(BNCServerInterface *)serverInterface key:(NSString *)key callback:(BNCServerCallback)callback {
     BNCPreferenceHelper *preferenceHelper = [BNCPreferenceHelper sharedInstance];
     NSMutableDictionary *params = [[NSMutableDictionary alloc] init];
+    super.clearLocalURL = FALSE;
 
     [self safeSetValue:[BNCSystemObserver getBundleID] forKey:BRANCH_REQUEST_KEY_BUNDLE_ID onDict:params];
     [self safeSetValue:[BNCSystemObserver getTeamIdentifier] forKey:BRANCH_REQUEST_KEY_TEAM_ID onDict:params];
@@ -69,7 +70,19 @@ - (void)makeRequest:(BNCServerInterface *)serverInterface key:(NSString *)key ca
     }
 
     if ([BNCPasteboard sharedInstance].checkOnInstall) {
-        NSURL *pasteboardURL = [[BNCPasteboard sharedInstance] checkForBranchLink];
+        NSURL *pasteboardURL = nil;
+        if (@available(iOS 16.0, *)) {
+            NSString *localURLString = [[BNCPreferenceHelper sharedInstance] localUrl];
+            if(localURLString){
+                pasteboardURL = [[NSURL alloc] initWithString:localURLString];
+                super.clearLocalURL = TRUE;
+            } else {
+                pasteboardURL = [[BNCPasteboard sharedInstance] checkForBranchLink];
+            }
+        } else {
+            pasteboardURL = [[BNCPasteboard sharedInstance] checkForBranchLink];
+        }
+        
         if (pasteboardURL) {
             [self safeSetValue:pasteboardURL.absoluteString forKey:BRANCH_REQUEST_KEY_LOCAL_URL onDict:params];
         }

Branch-SDK/BranchOpenRequest.h

@@ -12,6 +12,7 @@
 @interface BranchOpenRequest : BNCServerRequest
 
 @property (nonatomic, copy) callbackWithStatus callback;
+@property (assign, nonatomic) BOOL clearLocalURL;
 
 + (void) waitForOpenResponseLock;
 + (void) releaseOpenResponseLock;

Branch-SDK/BranchOpenRequest.m

@@ -43,6 +43,7 @@ - (id)initWithCallback:(callbackWithStatus)callback isInstall:(BOOL)isInstall {
 }
 
 - (void)makeRequest:(BNCServerInterface *)serverInterface key:(NSString *)key callback:(BNCServerCallback)callback {
+    self.clearLocalURL = FALSE;
     NSMutableDictionary *params = [[NSMutableDictionary alloc] init];
 
     BNCPreferenceHelper *preferenceHelper = [BNCPreferenceHelper sharedInstance];
@@ -100,6 +101,17 @@ - (void)makeRequest:(BNCServerInterface *)serverInterface key:(NSString *)key ca
     if (partnerParameters.count > 0) {
         [self safeSetValue:partnerParameters forKey:BRANCH_REQUEST_KEY_PARTNER_PARAMETERS onDict:params];
     }
+        
+    if (@available(iOS 16.0, *)) {
+        NSString *localURLString = [[BNCPreferenceHelper sharedInstance] localUrl];
+        if(localURLString){
+            NSURL *localURL = [[NSURL alloc] initWithString:localURLString];
+            if (localURL) {
+                [self safeSetValue:localURL.absoluteString forKey:BRANCH_REQUEST_KEY_LOCAL_URL onDict:params];
+                self.clearLocalURL = TRUE;
+            }
+        }
+    }
 
     BNCApplication *application = [BNCApplication currentApplication];
     params[@"lastest_update_time"] = BNCWireFormatFromDate(application.currentBuildDate);
@@ -269,6 +281,13 @@ - (void)processResponse:(BNCServerResponse *)response error:(NSError *)error {
         preferenceHelper.randomizedBundleToken = string;
     }
 
+    if (self.clearLocalURL) {
+        preferenceHelper.localUrl = nil;
+#if !TARGET_OS_TV
+        UIPasteboard.generalPasteboard.URL = nil;
+#endif
+    }
+    
     [BranchOpenRequest releaseOpenResponseLock];
 
     BranchContentDiscoveryManifest *cdManifest = [BranchContentDiscoveryManifest getInstance];