[SDK-2252] Expose the setDMAParamsForEEA method (#138)

* Added setDMAParamsForEEA() and bumped native SDKs

* Update BranchService.swift

* Update Plugin.swift

* Updated android implementation

* Updated changelog and package version

* updated web.ts

* Updated iOS SDK to 3.2.0

* Added checks

Author: nsingh-branch

CHANGELOG.md

@@ -1,5 +1,11 @@
 Branch Capacitor SDK change log
 
+- 7.1.0
+
+  - Added new method, setDMAParamsForEEA(), for setting DMA compliance parameters.
+  - Branch Android SDK bumped to 5.9.0
+  - Branch iOS SDK bumped to 3.2.0
+
 - 7.0.0
 
   - Branch Android SDK bumped to 5.7.5

android/build.gradle

@@ -66,7 +66,7 @@ dependencies {
     implementation project(':capacitor-android')
     implementation 'androidx.annotation:annotation:1.4.0'
     implementation 'androidx.appcompat:appcompat:1.5.0'
-    api 'io.branch.sdk.android:library:5.7.5'
+    api 'io.branch.sdk.android:library:5.9.0'
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

android/src/main/java/co/boundstate/BranchDeepLinks.java

@@ -532,4 +532,21 @@ public void getFirstReferringParams(PluginCall call) {
         ret.put("referringParams", Branch.getInstance().getFirstReferringParams());
         call.resolve(ret);
     }
+
+    @PluginMethod
+    public void setDMAParamsForEEA(PluginCall call) {
+        Boolean eeaRegion = call.getBoolean("eeaRegion");
+        Boolean adPersonalizationConsent = call.getBoolean("adPersonalizationConsent");
+        Boolean adUserDataUsageConsent = call.getBoolean("adUserDataUsageConsent");
+
+        if (eeaRegion == null || adPersonalizationConsent == null || adUserDataUsageConsent == null) {
+            call.reject("Must provide valid eeaRegion, adPersonalizationConsent, and adUserDataUsageConsent");
+            return;
+        }
+
+        Branch branch = Branch.getInstance();
+        branch.setDMAParamsForEEA(eeaRegion, adPersonalizationConsent, adUserDataUsageConsent);
+
+        call.resolve();
+    }
 }

ios/Plugin/BranchService.swift

@@ -57,4 +57,8 @@ class BranchService {
         let params = Branch.getInstance().getFirstReferringParams() ?? [:]
         completion(params)
     }
+
+    func setDMAParamsForEEA(eeaRegion: Bool, adPersonalizationConsent: Bool, adUserDataUsageConsent: Bool) -> Void {
+        Branch.setDMAParamsForEEA(eeaRegion, adPersonalizationConsent: adPersonalizationConsent, adUserDataUsageConsent: adUserDataUsageConsent)
+    }
 }

ios/Plugin/Plugin.m

@@ -15,4 +15,5 @@
            CAP_PLUGIN_METHOD(getBranchQRCode, CAPPluginReturnPromise);
            CAP_PLUGIN_METHOD(getLatestReferringParams, CAPPluginReturnPromise);
            CAP_PLUGIN_METHOD(getFirstReferringParams, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(setDMAParamsForEEA, CAPPluginReturnPromise);
 )

ios/Plugin/Plugin.swift

@@ -87,10 +87,10 @@ public class BranchDeepLinks: CAPPlugin {
 
         let buo = BranchUniversalObject.init()
         DispatchQueue.main.async {
-            buo.showShareSheet(with: linkProperties, andShareText: shareText, from: self.bridge?.viewController, completion: nil)
+            buo.showShareSheet(with: linkProperties, andShareText: shareText, from: self.bridge?.viewController)
         }
 
-        call.success()
+        call.resolve()
     }
 
     @objc func getStandardEvents(_ call: CAPPluginCall) {
@@ -165,7 +165,7 @@ public class BranchDeepLinks: CAPPlugin {
         }
 
         event.logEvent()
-        call.success()
+        call.resolve()
     }
 
     @objc func disableTracking(_ call: CAPPluginCall) {
@@ -329,4 +329,15 @@ public class BranchDeepLinks: CAPPlugin {
             ])
         }
     }
+
+    @objc func setDMAParamsForEEA(_ call: CAPPluginCall) {
+
+        guard let eeaRegion = call.getBool("eeaRegion"), let adPersonalizationConsent = call.getBool("adPersonalizationConsent"), let adUserDataUsageConsent = call.getBool("adUserDataUsageConsent") else {
+            call.reject("One or more DMA parameters are missing")
+            return
+        }
+
+        branchService.setDMAParamsForEEA(eeaRegion: eeaRegion, adPersonalizationConsent: adPersonalizationConsent, adUserDataUsageConsent: adUserDataUsageConsent)
+        call.resolve()
+    }
 }

ios/Podfile

@@ -4,7 +4,7 @@ def capacitor_pods
   use_frameworks!
   pod 'Capacitor', :path => '../node_modules/@capacitor/ios'
   pod 'CapacitorCordova', :path => '../node_modules/@capacitor/ios'
-  pod 'BranchSDK', '~> 3.0.1'
+  pod 'BranchSDK', '~> 3.2.0'
 end
 
 target 'Plugin' do

package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-branch-deep-links",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "description": "Capacitor plugin for Branch.io deep links",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",

src/definitions.ts

@@ -75,6 +75,12 @@ export interface BranchQRCodeResponse {
   qrCode: String;
 }
 
+export interface BranchDMAParams {
+  eeaRegion: boolean;
+  adPersonalizationConsent: boolean;
+  adUserDataUsageConsent: boolean;
+}
+
 export interface BranchInitEvent extends BranchReferringParamsResponse {}
 
 export type BranchATTAuthorizationStatus = 0 | 1 | 2 | 3;
@@ -111,4 +117,5 @@ export interface BranchDeepLinksPlugin {
   getBranchQRCode(options: BranchQRCodeParams): Promise<BranchQRCodeResponse>;
   getLatestReferringParams(): Promise<BranchReferringParamsResponse>;
   getFirstReferringParams(): Promise<BranchReferringParamsResponse>;
+  setDMAParamsForEEA: (options: BranchDMAParams) => void;
 }

src/web.ts

@@ -11,6 +11,7 @@ import {
   BranchTrackingResponse,
   BranchQRCodeParams,
   BranchQRCodeResponse,
+  BranchDMAParams,
 } from './definitions';
 
 export class BranchDeepLinksWeb
@@ -100,4 +101,10 @@ export class BranchDeepLinksWeb
       new Error('BranchDeepLinks does not have web implementation'),
     );
   }
+
+  setDMAParamsForEEA(_: BranchDMAParams): Promise<void> {
+    return Promise.reject(
+      new Error('BranchDeepLinks does not have web implementation'),
+    );
+  }
 }