clevertap-react-native 3.5.0 → 3.6.0

package/CHANGELOG.md

@@ -1,6 +1,25 @@
 Change Log
 ==========
 
+Version 3.6.0 *(July 17 2025)*
+-------------------------------------------
+**What's new**
+* **[Android Platform]**
+  * Supports [CleverTap Android SDK v7.5.0](https://github.com/CleverTap/clevertap-android-sdk/blob/master/docs/CTCORECHANGELOG.md#version-750-july-11-2025).
+
+* **[iOS Platform]**
+  * Supports [CleverTap iOS SDK v7.3.1](https://github.com/CleverTap/clevertap-ios-sdk/blob/master/CHANGELOG.md#version-731-july-15-2025).
+
+**API changes**
+* **[Android and iOS Platform]**
+  * Updates the `setOptOut(userOptOut)` API. This upgraded API improves GDPR opt-out functionality by allowing you to control whether critical system events (such as app installs, uninstalls, and push notification registration) are still sent to CleverTap, even when a user has opted out of tracking. This helps you respect user privacy choices while still maintaining essential app functionality and compliance with regulations. This is non-breaking change.
+    * `setOptOut(userOptOut, allowSystemEvents)`
+    
+**Bug Fixes**
+* **[iOS Platform]**
+   * Fixes a `No new templates are synced` error while syncing new custom templates.
+   * Fixes a Local Push Primer crash when asking for push permission using promptForPushPermission.
+
 Version 3.5.0 *(June 27 2025)*
 -------------------------------------------
 **What's new**
@@ -235,7 +254,7 @@ Version 1.2.1 *(25 October 2023)*
 **What's new**
 * **[Android Platform]**
   * Supports [CleverTap Android SDK v5.2.1](https://github.com/CleverTap/clevertap-android-sdk/blob/master/docs/CTCORECHANGELOG.md#version-521-october-12-2023).
-  * Adds Custom Proxy Domain functionality for Push Impressions and Events raised from CleverTap Android SDK. Please refer to [Usage.md](docs/Usage.md#integrate-custom-proxy-domain) file to read more on how to configure custom proxy domains in Android.
+  * Adds Custom Proxy Domain functionality for Push Impressions and Events raised from CleverTap Android SDK. Please refer to [Usage.md](docs/usage.md#integrate-custom-proxy-domain) file to read more on how to configure custom proxy domains in Android.
 
 * **[iOS Platform]**
   * Supports [CleverTap iOS SDK v5.2.1](https://github.com/CleverTap/clevertap-ios-sdk/releases/tag/5.2.1).

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Mon Jul 14 18:30:02 IST 2025
+gradle.version=8.5

package/android/build.gradle

@@ -35,8 +35,8 @@ android {
     defaultConfig {
         minSdkVersion 21
         targetSdkVersion 35
-        versionCode 350
-        versionName "3.5.0"
+        versionCode 360
+        versionName "3.6.0"
         buildConfigField("boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString())
     }
 
@@ -54,7 +54,7 @@ android {
 }
 
 dependencies {
-    api 'com.clevertap.android:clevertap-android-sdk:7.4.1'
+    api 'com.clevertap.android:clevertap-android-sdk:7.5.0'
     implementation 'com.android.installreferrer:installreferrer:2.2'
     //compile 'com.android.support:appcompat-v7:28.0.0'
     implementation 'com.facebook.react:react-native:+'

package/android/src/main/java/com/clevertap/react/CleverTapModuleImpl.java

@@ -1073,12 +1073,17 @@ public class CleverTapModuleImpl {
         clevertap.setOffline(value);
     }
 
-    public void setOptOut(boolean value) {
+    public void setOptOut(boolean userOptOut, Boolean allowSystemEvents) {
         CleverTapAPI clevertap = getCleverTapAPI();
         if (clevertap == null) {
             return;
         }
-        clevertap.setOptOut(value);
+
+        if (allowSystemEvents != null) {
+            clevertap.setOptOut(userOptOut, allowSystemEvents);
+        } else {
+            clevertap.setOptOut(userOptOut);
+        }
     }
 
     public void pushRegistrationToken(String token, ReadableMap type) {

package/android/src/newarch/CleverTapModule.kt

@@ -400,8 +400,8 @@ class CleverTapModule(reactContext: ReactApplicationContext?) :
         cleverTapModuleImpl.setOffline(value)
     }
 
-    override fun setOptOut(value: Boolean) {
-        cleverTapModuleImpl.setOptOut(value)
+    override fun setOptOut(userOptOut: Boolean, allowSystemEvents: Boolean?) {
+        cleverTapModuleImpl.setOptOut(userOptOut, allowSystemEvents)
     }
 
     override fun pushRegistrationToken(token: String?, pushType: ReadableMap?) {

package/android/src/oldarch/CleverTapModule.kt

@@ -472,8 +472,8 @@ class CleverTapModule(reactContext: ReactApplicationContext?) :
     }
 
     @ReactMethod
-    fun setOptOut(value: Boolean) {
-        cleverTapModuleImpl.setOptOut(value)
+    fun setOptOut(userOptOut: Boolean, allowSystemEvents: Boolean?) {
+        cleverTapModuleImpl.setOptOut(userOptOut, allowSystemEvents)
     }
 
     @ReactMethod

package/clevertap-react-native.podspec

@@ -24,7 +24,7 @@ Pod::Spec.new do |s|
     s.dependency 'React-Core'
   end
 
-  s.dependency 'CleverTap-iOS-SDK', '7.2.1'
+  s.dependency 'CleverTap-iOS-SDK', '7.3.1'
 
   if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
     s.pod_target_xcconfig = {

package/ios/CleverTapReact/CleverTapReact.mm

@@ -206,9 +206,13 @@ RCT_EXPORT_METHOD(setOffline:(BOOL)enabled) {
 
 #pragma mark - OptOut API
 
-RCT_EXPORT_METHOD(setOptOut:(BOOL)enabled) {
-    RCTLogInfo(@"[CleverTap setOptOut:  %i]", enabled);
-    [[self cleverTapInstance] setOptOut:enabled];
+RCT_EXPORT_METHOD(setOptOut:(BOOL)userOptOut allowSystemEvents:(NSNumber *)allowSystemEvents) {
+    RCTLogInfo(@"[CleverTap setOptOut and allowSystemEvents:  %i, %@]", userOptOut, allowSystemEvents);
+    if (allowSystemEvents != nil) {
+        [[self cleverTapInstance] setOptOut:userOptOut allowSystemEvents:[allowSystemEvents boolValue]];
+    } else {
+        [[self cleverTapInstance] setOptOut:userOptOut];
+    }
 }
 
 RCT_EXPORT_METHOD(enableDeviceNetworkInfoReporting:(BOOL)enabled) {

package/logs/browserstack-plugin.log

@@ -0,0 +1,2 @@
+12:04:49.152 [AWT-EventQueue-0] INFO  c.b.actions.DisableBrowserStack - Setting disable browserstack run update
+12:04:49.157 [AWT-EventQueue-0] INFO  c.b.actions.EnableBrowserStack - Setting enable browserstack run update

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clevertap-react-native",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "CleverTap React Native SDK.",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/NativeCleverTapModule.ts

@@ -42,7 +42,7 @@ export interface Spec extends TurboModule {
   enablePersonalization(): void;
   disablePersonalization(): void;
   setOffline(enabled: boolean): void;
-  setOptOut(enabled: boolean): void;
+  setOptOut(userOptOut: boolean, allowSystemEvents?: boolean): void;
   enableDeviceNetworkInfoReporting(enabled: boolean): void;
   recordScreenView(screenName: string): void;
   recordEvent(

package/src/index.d.ts

@@ -48,10 +48,36 @@
   export function enablePersonalization(): void;
 
   /**
-   * Enables tracking opt out for the currently active user.
-   * @param optOut {boolean}
+   * Sets the user's consent for event and profile tracking.
+   *
+   * You must call this method separately for each active user profile,
+   * for example, when switching user profiles using `onUserLogin`.
+   *
+   * Consent Scenarios:
+   *
+   * 1. **Complete Opt-Out**  
+   *    `userOptOut = true`, `allowSystemEvents = false`  
+   *    → No events (custom or system) are saved locally or remotely. Maximum privacy.
+   *
+   * 2. **Full Opt-In**  
+   *    `userOptOut = false`, `allowSystemEvents = true`  
+   *    → All events (custom and system) are tracked. Default behavior.
+   *
+   * 3. **Partial Opt-In**  
+   *    `userOptOut = true`, `allowSystemEvents = true`  
+   *    → Only system events (e.g., app launch, notification viewed) are tracked. Custom events are ignored.
+   *
+   * ⚠️ The combination `userOptOut = false` and `allowSystemEvents = false` is invalid.  
+   * In such cases, the SDK defaults to **Full Opt-In**.
+   *
+   * To re-enable full tracking after opting out, call with:  
+   * `userOptOut = false`, `allowSystemEvents = true`.
+   *
+   * @param {boolean} userOptOut - Set to `true` to disable custom event tracking.
+   * @param {boolean} allowSystemEvents - Set to `true` to allow system-level event tracking.
+   * @returns {void}
    */
-  export function setOptOut(optOut: boolean): void;
+    export function setOptOut(userOptOut: boolean, allowSystemEvents?: boolean): void;
 
   /**
    * Enables the reporting of device network related information, including IP address.  This reporting is disabled by default.

package/src/index.js

@@ -12,7 +12,7 @@ const EventEmitter = Platform.select({
 * @param {int} libVersion - The updated library version. If current version is 1.1.0 then pass as 10100  
 */
 const libName = 'React-Native';
-const libVersion = 30500;
+const libVersion = 30600;
 CleverTapReact.setLibrary(libName,libVersion);
 
 function defaultCallback(method, err, res) {
@@ -272,11 +272,37 @@ var CleverTap = {
     },
 
     /**
-    * Enables tracking opt out for the currently active user.
-    * @param {boolean} value - A boolean for enabling or disabling tracking for current user
-    */
-    setOptOut: function (value) {
-        CleverTapReact.setOptOut(value);
+     * Sets the user's consent for event and profile tracking.
+     *
+     * You must call this method separately for each active user profile,
+     * for example, when switching user profiles using `onUserLogin`.
+     *
+     * Consent Scenarios:
+     *
+     * 1. **Complete Opt-Out**  
+     *    `userOptOut = true`, `allowSystemEvents = false`  
+     *    → No events (custom or system) are saved locally or remotely. Maximum privacy.
+     *
+     * 2. **Full Opt-In**  
+     *    `userOptOut = false`, `allowSystemEvents = true`  
+     *    → All events (custom and system) are tracked. Default behavior.
+     *
+     * 3. **Partial Opt-In**  
+     *    `userOptOut = true`, `allowSystemEvents = true`  
+     *    → Only system events (e.g., app launch, notification viewed) are tracked. Custom events are ignored.
+     *
+     * ⚠️ The combination `userOptOut = false` and `allowSystemEvents = false` is invalid.  
+     * In such cases, the SDK defaults to **Full Opt-In**.
+     *
+     * To re-enable full tracking after opting out, call with:  
+     * `userOptOut = false`, `allowSystemEvents = true`.
+     *
+     * @param {boolean} userOptOut - Set to `true` to disable custom event tracking.
+     * @param {boolean} allowSystemEvents - Set to `true` to allow system-level event tracking.
+     * @returns {void}
+ */
+    setOptOut: function(userOptOut, allowSystemEvents) {
+        CleverTapReact.setOptOut(userOptOut, allowSystemEvents);
     },
 
     /**