clevertap-react-native 3.3.0 → 3.5.0

package/CHANGELOG.md

@@ -1,6 +1,35 @@
 Change Log
 ==========
 
+Version 3.5.0 *(June 27 2025)*
+-------------------------------------------
+**What's new**
+* **[Android Platform]**
+  * Supports [CleverTap Android SDK v7.4.1](https://github.com/CleverTap/clevertap-android-sdk/blob/master/docs/CTCORECHANGELOG.md#version-741-june-27-2025).
+
+* **[iOS Platform]**
+  * Supports [CleverTap iOS SDK v7.2.1](https://github.com/CleverTap/clevertap-ios-sdk/blob/master/CHANGELOG.md#version-721-june-27-2025).
+
+Version 3.4.0 *(28 March 2025)*
+-------------------------------------------
+> ⚠️ **NOTE**  
+> Please refer to [this guide](https://developer.clevertap.com/docs/clevertap-huawei-push-integration) for changed integration steps for Huawei PushProvider for android.
+
+**What's new**
+* **[Android Platform]**
+  * Supports [CleverTap Android SDK v7.3.1](https://github.com/CleverTap/clevertap-android-sdk/blob/master/docs/CTCORECHANGELOG.md#version-731-march-27-2025).
+
+* **[iOS Platform]**
+  * Supports [CleverTap iOS SDK v7.1.1](https://github.com/CleverTap/clevertap-ios-sdk/blob/master/CHANGELOG.md#version-711-march-17-2024).
+
+**API changes**
+* **[Android and iOS Platform]**
+  * Adds new API to register push tokens
+    * `pushRegistrationToken(your_token, pushType)`: Register the token for providers other than `FCM`. Refer [here](docs/usage.md#registering-hpsbaidu-token) for example usage.
+    * `setFCMPushToken(your_token)`: Register the token for `FCM` only. Refer [here](docs/usage.md#registering-fcm-token) for example usage.
+  * **Removes:** The legacy token registration APIs have been removed to make push providers injectable. The above mentioned APIs should be used in it's place. The removed APIs include:
+    - `setPushToken(value, type)`
+
 Version 3.3.0 *(17 March 2025)*
 -------------------------------------------
 Refer to the [troubleshoot guide](docs/install.md#troubleshooting) if you encounter any errors while upgrading to this version.

package/android/build.gradle

@@ -35,8 +35,8 @@ android {
     defaultConfig {
         minSdkVersion 21
         targetSdkVersion 35
-        versionCode 330
-        versionName "3.3.0"
+        versionCode 350
+        versionName "3.5.0"
         buildConfigField("boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString())
     }
 
@@ -54,7 +54,7 @@ android {
 }
 
 dependencies {
-    api 'com.clevertap.android:clevertap-android-sdk:7.2.2'
+    api 'com.clevertap.android:clevertap-android-sdk:7.4.1'
     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

@@ -2,9 +2,7 @@ package com.clevertap.react;
 
 import static com.clevertap.react.CleverTapUtils.convertObjectToWritableMap;
 import static com.clevertap.react.CleverTapUtils.getWritableArrayFromDisplayUnitList;
-import static com.clevertap.react.Constants.BPS;
 import static com.clevertap.react.Constants.FCM;
-import static com.clevertap.react.Constants.HPS;
 import static com.clevertap.react.Constants.REACT_MODULE_NAME;
 
 import android.annotation.SuppressLint;
@@ -32,6 +30,7 @@ import com.clevertap.android.sdk.inapp.customtemplates.CustomTemplateContext;
 import com.clevertap.android.sdk.inbox.CTInboxMessage;
 import com.clevertap.android.sdk.interfaces.OnInitCleverTapIDListener;
 import com.clevertap.android.sdk.product_config.CTProductConfigController;
+import com.clevertap.android.sdk.pushnotification.PushType;
 import com.clevertap.android.sdk.usereventlogs.UserEventLog;
 import com.clevertap.android.sdk.variables.CTVariableUtils;
 import com.clevertap.android.sdk.variables.Var;
@@ -105,8 +104,6 @@ public class CleverTapModuleImpl {
             constants.put(event.getEventName(), event.getEventName());
         }
         constants.put(FCM, FCM);
-        constants.put(BPS, BPS);
-        constants.put(HPS, HPS);
         return constants;
     }
 
@@ -1084,28 +1081,26 @@ public class CleverTapModuleImpl {
         clevertap.setOptOut(value);
     }
 
-
-    public void setPushTokenAsString(String token, String type) {
-        Logger.v("setPushTokenAsString() called with: token = [" + token + "], type = [" + type + "]");
+    public void pushRegistrationToken(String token, ReadableMap type) {
+        Logger.v("pushRegistrationToken called with: token = [" + token + "], type = [" + type + "]");
         CleverTapAPI clevertap = getCleverTapAPI();
         if (clevertap == null || token == null || type == null) {
             return;
         }
 
-        switch (type) {
-            case FCM:
-                clevertap.pushFcmRegistrationId(token, true);
-                break;
-            case BPS:
-                clevertap.pushBaiduRegistrationId(token, true);
-                break;
-            case HPS:
-                clevertap.pushHuaweiRegistrationId(token, true);
-                break;
-            default:
-                Log.e(TAG, "Unknown push token type " + type);
-                break;
+        PushType pushType = pushTypeFromReadableMap(type);
+        if (pushType != null) {
+            clevertap.pushRegistrationToken(token, pushType, true);
+        }
+    }
+
+    public void setFCMPushTokenAsString(String token) {
+        Logger.v("setFCMPushTokenAsString called with: token = [" + token + "]");
+        CleverTapAPI clevertap = getCleverTapAPI();
+        if (clevertap == null || token == null) {
+            return;
         }
+        clevertap.pushFcmRegistrationId(token, true);
     }
 
     // Increment/Decrement Operator
@@ -1537,6 +1532,21 @@ public class CleverTapModuleImpl {
         return true;
     }
 
+    private PushType pushTypeFromReadableMap(ReadableMap readableMap) {
+        String type = readableMap.getString("type");
+        String prefKey =  readableMap.getString("prefKey");
+
+        if (type == null || prefKey == null) {
+            return null;
+        }
+
+        return new PushType(
+                type,
+                prefKey,
+                readableMap.getString("className"),
+                readableMap.getString("messagingSDKClassName"));
+    }
+
     @SuppressWarnings("SameParameterValue")
     private <T> HashMap<String, T> eventPropsFromReadableMap(ReadableMap propsMap, Class<T> tClass) {
         if (propsMap == null) {
@@ -1708,7 +1718,7 @@ public class CleverTapModuleImpl {
         CTLocalInApp.InAppType inAppType = null;
         String titleText = null, messageText = null, positiveBtnText = null, negativeBtnText = null,
                 backgroundColor = null, btnBorderColor = null, titleTextColor = null, messageTextColor = null,
-                btnTextColor = null, imageUrl = null, btnBackgroundColor = null, btnBorderRadius = null;
+                btnTextColor = null, imageUrl = null, btnBackgroundColor = null, btnBorderRadius = null, altText = null;
         boolean fallbackToSettings = false, followDeviceOrientation = false;
 
         ReadableMapKeySetIterator iterator = readableMap.keySetIterator();
@@ -1755,6 +1765,9 @@ public class CleverTapModuleImpl {
                 if ("imageUrl".equals(configKey) && readableType == ReadableType.String) {
                     imageUrl = readableMap.getString(configKey);
                 }
+                if ("altText".equals(configKey) && readableType == ReadableType.String) {
+                    altText = readableMap.getString(configKey);
+                }
                 if ("btnBackgroundColor".equals(configKey) && readableType == ReadableType.String) {
                     btnBackgroundColor = readableMap.getString(configKey);
                 }
@@ -1789,7 +1802,7 @@ public class CleverTapModuleImpl {
             builderWithRequiredParams.setBtnTextColor(btnTextColor);
         }
         if (imageUrl != null) {
-            builderWithRequiredParams.setImageUrl(imageUrl);
+            builderWithRequiredParams.setImageUrl(imageUrl, altText);
         }
         if (btnBackgroundColor != null) {
             builderWithRequiredParams.setBtnBackgroundColor(btnBackgroundColor);

package/android/src/main/java/com/clevertap/react/Constants.kt

@@ -10,6 +10,4 @@ object Constants {
     const val REACT_MODULE_NAME = "CleverTapReact"
 
     const val FCM = "FCM"
-    const val BPS = "BPS"
-    const val HPS = "HPS"
 }

package/android/src/newarch/CleverTapModule.kt

@@ -404,8 +404,12 @@ class CleverTapModule(reactContext: ReactApplicationContext?) :
         cleverTapModuleImpl.setOptOut(value)
     }
 
-    override fun setPushTokenAsString(token: String?, type: String?) {
-        cleverTapModuleImpl.setPushTokenAsString(token, type)
+    override fun pushRegistrationToken(token: String?, pushType: ReadableMap?) {
+        cleverTapModuleImpl.pushRegistrationToken(token, pushType)
+    }
+
+    override fun setFCMPushTokenAsString(token: String?) {
+        cleverTapModuleImpl.setFCMPushTokenAsString(token)
     }
 
     // Increment/Decrement Operator

package/android/src/oldarch/CleverTapModule.kt

@@ -477,8 +477,13 @@ class CleverTapModule(reactContext: ReactApplicationContext?) :
     }
 
     @ReactMethod
-    fun setPushTokenAsString(token: String?, type: String?) {
-        cleverTapModuleImpl.setPushTokenAsString(token, type)
+    fun pushRegistrationToken(token: String?, type: ReadableMap?) {
+        cleverTapModuleImpl.pushRegistrationToken(token, type)
+    }
+
+    @ReactMethod
+    fun setFCMPushTokenAsString(token: String?) {
+        cleverTapModuleImpl.setFCMPushTokenAsString(token)
     }
 
     // Increment/Decrement Operator

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.1.0'
+  s.dependency 'CleverTap-iOS-SDK', '7.2.1'
 
   if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
     s.pod_target_xcconfig = {

package/docs/install.md

@@ -86,7 +86,7 @@ dependencies {
 
 
     //clevertap
-    implementation 'com.clevertap.android:clevertap-android-sdk:7.0.1'
+    implementation 'com.clevertap.android:clevertap-android-sdk:7.4.1'
 
 
     // other libs

package/docs/pushprimer.md

@@ -24,6 +24,8 @@ let localInApp = {
               btnBackgroundColor: '#0000FF',
               btnBorderRadius: '2',
               fallbackToSettings: true,
+              imageUrl: 'https://icons.iconarchive.com/icons/treetog/junior/64/camera-icon.png',
+              altText: 'Altenate Image'
             };
 
 CleverTap.promptPushPrimer(localInApp);

package/docs/usage.md

@@ -301,7 +301,25 @@ CleverTap.deleteNotificationChannelGroup(String groupId);
 #### Registering Fcm Token
 
 ```javascript 
-CleverTap.setPushToken("<Replace with FCM Token value>", CleverTap.FCM);
+CleverTap.setFCMPushToken("<Replace with FCM Token value>");
+```
+
+#### Registering HPS/Baidu token
+
+```javascript 
+CleverTap.pushRegistrationToken("my_hms_token", {
+  type: 'hps',
+  prefKey: 'hps_token',
+  className: 'com.clevertap.android.hms.HmsPushProvider',
+  messagingSDKClassName: 'com.huawei.hms.push.HmsMessageService'
+});
+
+CleverTap.pushRegistrationToken("my_bps_token", {
+  type: 'bps',
+  prefKey: 'bps_token',
+  className: 'com.clevertap.android.bps.BaiduPushProvider',
+  messagingSDKClassName: 'com.baidu.android.pushservice.PushMessageReceiver'
+});
 ```
 
 -----------

package/ios/CleverTapReact/CleverTapReact.mm

@@ -164,12 +164,20 @@ RCT_EXPORT_METHOD(registerForPush) {
     }
 }
 
-RCT_EXPORT_METHOD(setPushTokenAsString:(NSString*)token withType:(NSString *)type) {
-    // type is a no-op in iOS
+RCT_EXPORT_METHOD(setFCMPushTokenAsString:(NSString*)token) {
     RCTLogInfo(@"[CleverTap setPushTokenAsString: %@]", token);
     [[self cleverTapInstance] setPushTokenAsString:token];
 }
 
+RCT_EXPORT_METHOD(pushRegistrationToken:(NSString*)token withPushType:(NSDictionary*)pushType) {
+    NSString *type = pushType[@"type"];
+    if ([type isEqualToString:@"fcm"]) {
+        [self setFCMPushTokenAsString:token];
+    } else {
+        RCTLogInfo(@"[CleverTap pushRegistrationToken for types other than FCM is no-op in iOS]");
+    }
+}
+
 // setPushTokenAsStringWithRegion is a no-op in iOS
 RCT_EXPORT_METHOD(setPushTokenAsStringWithRegion:(NSString*)token withType:(NSString *)type withRegion:(NSString *)region){
     RCTLogInfo(@"[CleverTap setPushTokenAsStringWithRegion is no-op in iOS]");
@@ -955,7 +963,7 @@ RCT_EXPORT_METHOD(clearInAppResources:(BOOL)expiredOnly) {
     //Required parameters
     NSString *titleText = nil, *messageText = nil, *followDeviceOrientation = nil, *positiveBtnText = nil, *negativeBtnText = nil;
     //Additional parameters
-    NSString *fallbackToSettings = nil, *backgroundColor = nil, *btnBorderColor = nil, *titleTextColor = nil, *messageTextColor = nil, *btnTextColor = nil, *imageUrl = nil, *btnBackgroundColor = nil, *btnBorderRadius = nil;
+    NSString *fallbackToSettings = nil, *backgroundColor = nil, *btnBorderColor = nil, *titleTextColor = nil, *messageTextColor = nil, *btnTextColor = nil, *imageUrl = nil, *btnBackgroundColor = nil, *btnBorderRadius = nil, *altText = nil;
     
     if ([json[@"inAppType"]  isEqual: @"half-interstitial"]){
         inAppType = HALF_INTERSTITIAL;
@@ -1013,10 +1021,16 @@ RCT_EXPORT_METHOD(clearInAppResources:(BOOL)expiredOnly) {
         btnTextColor = [json valueForKey:@"btnTextColor"];
         [inAppBuilder setBtnTextColor:btnTextColor];
     }
+    
+    if (json[@"altText"]) {
+        altText = [json valueForKey:@"altText"];
+    }
+    
     if (json[@"imageUrl"]) {
         imageUrl = [json valueForKey:@"imageUrl"];
-        [inAppBuilder setImageUrl:imageUrl];
+        [inAppBuilder setImageUrl:imageUrl contentDescription:altText];
     }
+
     if (json[@"btnBackgroundColor"]) {
         btnBackgroundColor = [json valueForKey:@"btnBackgroundColor"];
         [inAppBuilder setBtnBackgroundColor:btnBackgroundColor];

package/package.json

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

package/src/NativeCleverTapModule.ts

@@ -28,9 +28,7 @@ export interface Spec extends TurboModule {
     CleverTapOnVariablesChangedAndNoDownloadsPending: string;
     CleverTapOnceVariablesChangedAndNoDownloadsPending: string;
     CleverTapOnFileValueChanged: string;
-    HPS: string;
     FCM: string;
-    BPS: string;
   };
   
   setInstanceWithAccountId(accountId: string): void;
@@ -38,7 +36,8 @@ export interface Spec extends TurboModule {
   setLibrary(name: string, andVersion: number): void;
   setLocale(locale: string): void;
   registerForPush(): void;
-  setPushTokenAsString(token: string, withType: string): void;
+  setFCMPushTokenAsString(token: string): void;
+  pushRegistrationToken(token: string, pushType: Object | null): void;
   setPushTokenAsStringWithRegion(token: string, withType: string, withRegion: string): void;
   enablePersonalization(): void;
   disablePersonalization(): void;

package/src/index.d.ts

@@ -69,11 +69,17 @@
   export function registerForPush(): void;
 
   /**
-   * Manually set the push token on the CleverTap user profile
+   * Manually set the FCM push token on the CleverTap user profile
    * @param {string} token - the device token
-   * @param {string} type - for Android only, specifying the type of push service token. Values can be CleverTap.FCM for Firebase or CleverTap.BPS for Baidu or CleverTap.HPS for Huawei,
    */
-  export function setPushToken(token: string, type: string): void;
+  export function setFCMPushToken(token: string): void;
+
+    /**
+     * Manually set the push token on the CleverTap user profile for providers other than FCM
+     * @param {string} token - the device token
+     * @param {any} type - object with the following keys "type", "prefKey", "className", "messagingSDKClassName";
+     */
+    export function pushRegistrationToken(token: string, pushType: any): void;
 
   /**
    * Create Notification Channel for Android O+
@@ -963,8 +969,6 @@ export function isPushPermissionGranted(callback: CallbackString): void;
   type CallbackString = (err: object, res: string) => void;
 
   export const FCM: string;
-  export const BPS: string;
-  export const HPS: string;
   export const CleverTapProfileDidInitialize: string;
   export const CleverTapProfileSync: string;
   export const CleverTapInAppNotificationDismissed: string;

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 = 30300;
+const libVersion = 30500;
 CleverTapReact.setLibrary(libName,libVersion);
 
 function defaultCallback(method, err, res) {
@@ -55,8 +55,6 @@ var CleverTap = {
     CleverTapCustomFunctionPresent: CleverTapReact.getConstants().CleverTapCustomFunctionPresent,
     CleverTapCustomTemplateClose: CleverTapReact.getConstants().CleverTapCustomTemplateClose,
     FCM: CleverTapReact.getConstants().FCM,
-    BPS: CleverTapReact.getConstants().BPS,
-    HPS: CleverTapReact.getConstants().HPS,
     CleverTapInboxDidInitialize: CleverTapReact.getConstants().CleverTapInboxDidInitialize,
     CleverTapInboxMessagesDidUpdate: CleverTapReact.getConstants().CleverTapInboxMessagesDidUpdate,
     CleverTapInboxMessageButtonTapped: CleverTapReact.getConstants().CleverTapInboxMessageButtonTapped,
@@ -147,11 +145,20 @@ var CleverTap = {
     /**
      * Manually set the push token on the CleverTap user profile
      * @param {string} token - the device token
-     * @param {string} type - for Android only, specifying the type of push service token. Values can be CleverTap.FCM for Firebase or CleverTap.BPS for Baidu or CleverTap.HPS for Huawei,
+     * @param {object} pushType - object with the following keys "type", "prefKey", "className", "messagingSDKClassName";
      */
-    setPushToken: function (token, type) {
-        console.log(`CleverTap RN | setPushToken | received : token: '${token}' | type:'${type}' `)
-        CleverTapReact.setPushTokenAsString(token, type);
+    pushRegistrationToken: function (token, pushType) {
+        console.log(`CleverTap RN | pushRegistrationToken| received : token: '${token}'`)
+        CleverTapReact.pushRegistrationToken(token, pushType);
+    },
+
+    /**
+     * Manually set the push token on the CleverTap user profile
+     * @param {string} token - the fcm device token
+     */
+    setFCMPushToken: function (token) {
+        console.log(`CleverTap RN | setFCMPushToken | received : token: '${token}'`)
+        CleverTapReact.setFCMPushTokenAsString(token);
     },
 
     /**

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

@@ -1,2 +0,0 @@
-#Tue Mar 05 15:27:26 IST 2024
-gradle.version=8.2

package/android/.gradle/config.properties

@@ -1,2 +0,0 @@
-#Mon Sep 02 11:39:00 IST 2024
-java.home=/Applications/Android Studio.app/Contents/jbr/Contents/Home

package/android/.settings/org.eclipse.buildship.core.prefs

@@ -1,2 +0,0 @@
-connection.project.dir=../../../android
-eclipse.preferences.version=1

package/android/build/generated/source/buildConfig/debug/com/clevertap/react/BuildConfig.java

@@ -1,12 +0,0 @@
-/**
- * Automatically generated file. DO NOT MODIFY
- */
-package com.clevertap.react;
-
-public final class BuildConfig {
-  public static final boolean DEBUG = Boolean.parseBoolean("true");
-  public static final String LIBRARY_PACKAGE_NAME = "com.clevertap.react";
-  public static final String BUILD_TYPE = "debug";
-  // Field from default config.
-  public static final boolean IS_NEW_ARCHITECTURE_ENABLED = true;
-}