clevertap-react-native 3.1.1 → 3.2.0

package/CHANGELOG.md

@@ -1,6 +1,37 @@
 Change Log
 ==========
 
+Version 3.2.0 *(5 February 2025)*
+-------------------------------------------
+**What's new**
+
+* **[Android Platform]**
+  * Supports [CleverTap Android SDK v7.1.2](https://github.com/CleverTap/clevertap-android-sdk/blob/master/docs/CTCORECHANGELOG.md#version-712-january-29-2025).
+  * Adds support to hide large icon in android notifications by sending `wzrk_hide_large_icon` key in notification payload.
+  
+* **[iOS Platform]**
+  * Supports [CleverTap iOS SDK v7.1.0](https://github.com/CleverTap/clevertap-ios-sdk/blob/master/CHANGELOG.md#version-710-january-21-2024).
+
+* **[Android and iOS Platform]**
+- Adds support for triggering InApps based on first-time event filtering in multiple triggers. Now you can create campaign triggers that combine recurring and first-time events. For example: Trigger a campaign when "Charged" occurs (every time) OR "App Launched" occurs (first time only).
+- Adds new user-level event log tracking system to store and manage user event history. New APIs include:
+  - `getUserEventLog(<eventName>)`: Get details about a specific event
+  - `getUserEventLogCount(<eventName>)`: Get count of times an event occurred
+  - `getUserLastVisitTs()`: Get timestamp of user's last app visit
+  - `getUserAppLaunchCount()`: Get total number of times user has launched the app
+  - `getUserEventLogHistory()`: Get full event history for current user
+
+#### API Changes
+
+- **Deprecates:**  The old event tracking APIs tracked events at the device level rather than the user level, making it difficult to maintain accurate user-specific event histories, especially in multi-user scenarios. The following methods have been deprecated in favor of new user-specific event tracking APIs that provide more accurate, user-level analytics. These deprecated methods will be removed in future versions with prior notice:
+  - `eventGetDetail()`: Use `getUserEventLog()` instead for user-specific event details
+  - `eventGetOccurrences()`: Use `getUserEventLogCount()` instead for user-specific event counts
+  - `eventGetFirstTime()`: Use `getUserEventLog()` instead for user-specific first occurrence timestamp
+  - `eventGetLastTime()`: Use `getUserEventLog()` instead for user-specific last occurrence timestamp
+  - `sessionGetPreviousVisitTime()`: Use `getUserLastVisitTs()` instead for user-specific last visit timestamp
+  - `sessionGetTotalVisits()`: Use `getUserAppLaunchCount()` instead for user-specific app launch count
+  - `getEventHistory()`: Use `getUserEventLogHistory()` instead for user-specific event history
+
 Version 3.1.1 *(6 November 2024)*
 -------------------------------------------
 **Bug Fixes**

package/README.md

@@ -22,8 +22,8 @@ To get started, sign up [here](https://clevertap.com/live-product-demo/).
 3. Follow the [integration instructions](./docs/integration.md)
 
 ## 📚 Additional Resources
-- [CleverTap iOS SDK Integration guide](https://support.clevertap.com/docs/ios/getting-started.html)
-- [CleverTap Android SDK Integration guide](https://support.clevertap.com/docs/android/getting-started.html)
+- [CleverTap iOS SDK Integration guide](https://developer.clevertap.com/docs/ios)
+- [CleverTap Android SDK Integration guide](https://developer.clevertap.com/docs/android)
 
 ## 📲 CleverTap iOS Push Templates SDK
 

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

@@ -0,0 +1,2 @@
+#Tue Feb 04 15:23:26 IST 2025
+gradle.version=8.5

package/android/.gradle/nb-cache/trust/78DD44AAC81C568A008B13ED64740D37310990B04E1F70028E68455541C79400

@@ -0,0 +1 @@
+DCC73873EEDDA3B877B3B1661F94F060C0B645A5A1CEFC1A3367BF88075D1DE9

package/android/build.gradle

@@ -35,8 +35,8 @@ android {
     defaultConfig {
         minSdkVersion 19
         targetSdkVersion 34
-        versionCode 311
-        versionName "3.1.1"
+        versionCode 320
+        versionName "3.2.0"
         buildConfigField("boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString())
     }
 
@@ -54,7 +54,7 @@ android {
 }
 
 dependencies {
-    api 'com.clevertap.android:clevertap-android-sdk:7.0.2'
+    api 'com.clevertap.android:clevertap-android-sdk:7.1.2'
     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/CleverTapEventEmitter.kt

@@ -57,9 +57,11 @@ object CleverTapEventEmitter {
      */
     fun flushBuffer(event: CleverTapEvent) {
         val buffer = eventsBuffers[event] ?: return
-        while (buffer.size() > 0) {
-            val params = buffer.remove()
-            sendEvent(event, params)
+        synchronized(buffer) {
+            while (buffer.size() > 0) {
+                val params = buffer.remove()
+                sendEvent(event, params)
+            }
         }
     }
 

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

@@ -32,6 +32,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.usereventlogs.UserEventLog;
 import com.clevertap.android.sdk.variables.CTVariableUtils;
 import com.clevertap.android.sdk.variables.Var;
 import com.clevertap.android.sdk.variables.callbacks.FetchVariablesCallback;
@@ -295,6 +296,75 @@ public class CleverTapModuleImpl {
         clevertap.enablePersonalization();
     }
 
+
+    public void getUserEventLog(String eventName, Callback callback) {
+        String error = null;
+        WritableMap result = null;
+
+        CleverTapAPI clevertap = getCleverTapAPI();
+        if (clevertap != null) {
+            UserEventLog eventLog = clevertap.getUserEventLog(eventName);
+            result = eventLogToWritableMap(eventLog);
+        } else {
+            error = "CleverTap not initialized";
+        }
+        callbackWithErrorAndResult(callback, error, result);
+    }
+
+    public void getUserEventLogCount(String eventName, Callback callback) {
+        String error = null;
+        int result = -1;
+
+        CleverTapAPI clevertap = getCleverTapAPI();
+        if (clevertap != null) {
+            result = clevertap.getUserEventLogCount(eventName);
+        } else {
+            error = "CleverTap not initialized";
+        }
+        callbackWithErrorAndResult(callback, error, result);
+    }
+
+    public void getUserLastVisitTs(Callback callback) {
+        String error = null;
+        double result = -1;
+
+        CleverTapAPI clevertap = getCleverTapAPI();
+        if (clevertap != null) {
+            result = clevertap.getUserLastVisitTs();
+        } else {
+            error = "CleverTap not initialized";
+        }
+        callbackWithErrorAndResult(callback, error, result);
+    }
+
+    public void getUserAppLaunchCount(Callback callback) {
+        String error = null;
+        int result = -1;
+
+        CleverTapAPI clevertap = getCleverTapAPI();
+        if (clevertap != null) {
+            result = clevertap.getUserAppLaunchCount();
+        } else {
+            error = "CleverTap not initialized";
+        }
+        callbackWithErrorAndResult(callback, error, result);
+    }
+
+    public void getUserEventLogHistory(Callback callback) {
+        String error = null;
+        WritableMap result = null;
+
+        CleverTapAPI clevertap = getCleverTapAPI();
+        if (clevertap != null) {
+            Map<String, UserEventLog> history = clevertap.getUserEventLogHistory();
+            result = eventLogHistoryToWritableMap(history);
+        } else {
+            error = "CleverTap not initialized";
+        }
+        callbackWithErrorAndResult(callback, error, result);
+    }
+
+    @Deprecated(since = "3.2.0")
     public void eventGetDetail(String eventName, Callback callback) {
         String error = null;
         WritableMap result = null;
@@ -309,6 +379,8 @@ public class CleverTapModuleImpl {
         callbackWithErrorAndResult(callback, error, result);
     }
 
+
+    @Deprecated(since = "3.2.0")
     public void eventGetFirstTime(String eventName, Callback callback) {
         String error = null;
         int result = -1;
@@ -322,6 +394,7 @@ public class CleverTapModuleImpl {
         callbackWithErrorAndResult(callback, error, result);
     }
 
+    @Deprecated(since = "3.2.0")
     public void eventGetLastTime(String eventName, Callback callback) {
         String error = null;
         int result = -1;
@@ -335,6 +408,7 @@ public class CleverTapModuleImpl {
         callbackWithErrorAndResult(callback, error, result);
     }
 
+    @Deprecated(since = "3.2.0")
     public void eventGetOccurrences(String eventName, Callback callback) {
         String error = null;
         int result = -1;
@@ -440,6 +514,7 @@ public class CleverTapModuleImpl {
         callbackWithErrorAndResult(callback, error, result);
     }
 
+    @Deprecated(since = "3.2.0")
     public void getEventHistory(Callback callback) {
         String error = null;
         WritableMap result = null;
@@ -890,6 +965,7 @@ public class CleverTapModuleImpl {
         productConfigController.reset();
     }
 
+    @Deprecated(since = "3.2.0")
     public void sessionGetPreviousVisitTime(Callback callback) {
         String error = null;
         int result = -1;
@@ -929,6 +1005,7 @@ public class CleverTapModuleImpl {
         callbackWithErrorAndResult(callback, error, result);
     }
 
+    @Deprecated(since = "3.2.0")
     public void sessionGetTotalVisits(Callback callback) {
         String error = null;
         int result = -1;
@@ -1866,6 +1943,32 @@ public class CleverTapModuleImpl {
         return array;
     }
 
+    private static WritableMap eventLogToWritableMap(UserEventLog eventLog) {
+        WritableMap ret = Arguments.createMap();
+
+        if (eventLog != null) {
+            ret.putString("eventName", eventLog.getEventName());
+            ret.putString("normalizedEventName", eventLog.getNormalizedEventName());
+            ret.putDouble("firstTime", eventLog.getFirstTs());
+            ret.putDouble("lastTime", eventLog.getLastTs());
+            ret.putInt("count", eventLog.getCountOfEvents());
+            ret.putString("deviceID", eventLog.getDeviceID());
+        }
+        return ret;
+    }
+
+    private static WritableMap eventLogHistoryToWritableMap(Map<String, UserEventLog> history) {
+        WritableMap ret = Arguments.createMap();
+
+        if (history != null) {
+            for (String key : history.keySet()) {
+                ret.putMap(key, eventLogToWritableMap(history.get(key)));
+            }
+        }
+        return ret;
+    }
+
+    @Deprecated(since = "3.2.0")
     private static WritableMap eventDetailToWritableMap(EventDetail details) {
         WritableMap ret = Arguments.createMap();
 
@@ -1878,6 +1981,7 @@ public class CleverTapModuleImpl {
         return ret;
     }
 
+    @Deprecated(since = "3.2.0")
     private static WritableMap eventHistoryToWritableMap(Map<String, EventDetail> history) {
         WritableMap ret = Arguments.createMap();
 

package/android/src/newarch/CleverTapModule.kt

@@ -587,6 +587,27 @@ class CleverTapModule(reactContext: ReactApplicationContext?) :
         return
     }
 
+    override fun getUserEventLog(eventName: String, callback: Callback?) {
+        cleverTapModuleImpl.getUserEventLog(eventName, callback)
+    }
+
+    override fun getUserEventLogCount(eventName: String, callback: Callback?) {
+        cleverTapModuleImpl.getUserEventLogCount(eventName, callback)
+    }
+
+    override fun getUserLastVisitTs(callback: Callback?) {
+        cleverTapModuleImpl.getUserLastVisitTs(callback)
+    }
+
+    override fun getUserAppLaunchCount(callback: Callback?) {
+        cleverTapModuleImpl.getUserAppLaunchCount(callback)
+    }
+
+    override fun getUserEventLogHistory(callback: Callback?) {
+        cleverTapModuleImpl.getUserEventLogHistory(callback)
+    }
+
+
     override fun getTypedExportedConstants(): Map<String, Any> {
         return cleverTapModuleImpl.getClevertapConstants()
     }

package/android/src/oldarch/CleverTapModule.kt

@@ -675,6 +675,31 @@ class CleverTapModule(reactContext: ReactApplicationContext?) :
         cleverTapModuleImpl.onEventListenerAdded(eventName)
     }
 
+    @ReactMethod
+    fun getUserEventLog(eventName: String, callback: Callback) {
+        cleverTapModuleImpl.getUserEventLog(eventName, callback)
+    }
+
+    @ReactMethod
+    fun getUserEventLogCount(eventName: String, callback: Callback) {
+        cleverTapModuleImpl.getUserEventLogCount(eventName, callback)
+    }
+
+    @ReactMethod
+    fun getUserLastVisitTs(callback: Callback) {
+        cleverTapModuleImpl.getUserLastVisitTs(callback)
+    }
+
+    @ReactMethod
+    fun getUserAppLaunchCount(callback: Callback) {
+        cleverTapModuleImpl.getUserAppLaunchCount(callback)
+    }
+
+    @ReactMethod
+    fun getUserEventLogHistory(callback: Callback) {
+        cleverTapModuleImpl.getUserEventLogHistory(callback)
+    }
+
     override fun getConstants(): Map<String, Any> {
         return cleverTapModuleImpl.getClevertapConstants()
     }

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

package/docs/install.md

@@ -4,7 +4,7 @@
 
      Link CleverTap for React Native 0.59 or below & Not Using Cocoapods
 
-2. `react-native link clevertap-react-native` **or** [follow the manual linking instructions below](#manual-linking).
+2. `react-native link clevertap-react-native` **or** [follow the manual linking instructions below](install.md#manual-linking).
 
     **Note:**
     
@@ -143,7 +143,7 @@ maven {
       }
 ```
 
-## Manual Linking ##
+## Manual Linking
 
 #### iOS:
 - Drag and Drop node_modules/clevertap-react-native/ios/CleverTapReact.xcodeproj into the Libraries folder of your project in XCode ([see Step 1 here](http://facebook.github.io/react-native/docs/linking-libraries-ios.html#manual-linking)).

package/docs/integration.md

@@ -8,7 +8,7 @@ Clevertap supports the [ReactNative New Architecture](https://reactnative.dev/do
 
 
 ### iOS
-1. Follow the integration instructions [starting with Step 2 here](https://support.clevertap.com/docs/ios/getting-started.html).
+1. Follow the integration instructions [here](https://developer.clevertap.com/docs/react-native-quick-start-guide#ios-integration).
 2. In your `AppDelegate didFinishLaunchingWithOptions:` notify the CleverTap React SDK of application launch:
 ```objc
 [CleverTap autoIntegrate]; // integrate CleverTap SDK using the autoIntegrate option
@@ -22,10 +22,10 @@ NOTE:  Don't forget to add the CleverTap imports at the top of the file.
 
 Note: Need to use **@import CleverTapSDK;** instead of **#import <CleverTap-iOS-SDK/CleverTap.h>** and **@import CleverTapReact;** instead of **#import <clevertap-react-native/CleverTapReactManager.h>** in the AppDelegate class in case if using ```use_modular_headers!``` in the podfile.
 
-[See the Example Project](/Example/ios/Example/AppDelegate.m).
+[See the Example Project](/Example/ios/Example/AppDelegate.mm).
 
 ### Android
-1. Follow the integration instructions [starting with Step 2 here](https://support.clevertap.com/docs/android/getting-started.html).
+1. Follow the integration instructions [here](https://developer.clevertap.com/docs/react-native-quick-start-guide#android-integration).
 
 2. Add CleverTapPackage to the packages list in MainApplication.java (`android/app/src/[...]/MainApplication.java`)
     ```java
@@ -118,5 +118,5 @@ Note: Need to use **@import CleverTapSDK;** instead of **#import <CleverTap-iOS-
     }
     ```
 
-[See the Example Project](/Example/App.js) 
+[See the Example Project](/Example/app/App.js) 
 

package/docs/usage.md

@@ -500,6 +500,6 @@ CleverTap.resumeInAppNotifications();
 
 
 ### For more information,
- - [See included Example Application](/Example/App.js) 
- - [See CleverTap JS interface](/index.js)
- - [See CleverTap TS interface](/index.d.ts)
+ - [See included Example Application](/Example/app/App.js) 
+ - [See CleverTap JS interface](/src/index.js)
+ - [See CleverTap TS interface](/src/index.d.ts)

package/ios/CleverTapReact/CleverTapReact.mm

@@ -264,6 +264,43 @@ RCT_EXPORT_METHOD(getEventHistory:(RCTResponseSenderBlock)callback) {
     [self returnResult:result withCallback:callback andError:nil];
 }
 
+RCT_EXPORT_METHOD(getUserEventLog:(NSString*)eventName callback:(RCTResponseSenderBlock)callback) {
+    RCTLogInfo(@"[CleverTap getUserEventLog: %@]", eventName);
+    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
+        CleverTapEventDetail *detail = [[self cleverTapInstance] getUserEventLog:eventName];
+        NSDictionary *result = [self _eventDetailToDict:detail];
+        dispatch_async(dispatch_get_main_queue(), ^{
+            [self returnResult:result withCallback:callback andError:nil];
+        });
+    });
+}
+
+RCT_EXPORT_METHOD(getUserEventLogCount:(NSString*)eventName callback:(RCTResponseSenderBlock)callback) {
+    RCTLogInfo(@"[CleverTap getUserEventLogCount: %@]", eventName);
+    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
+        int result = [[self cleverTapInstance] getUserEventLogCount:eventName];
+        dispatch_async(dispatch_get_main_queue(), ^{
+            [self returnResult:@(result) withCallback:callback andError:nil];
+        });
+    });
+}
+
+RCT_EXPORT_METHOD(getUserEventLogHistory:(RCTResponseSenderBlock)callback) {
+    RCTLogInfo(@"[CleverTap getUserEventLogHistory]");
+    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
+        NSDictionary *history = [[self cleverTapInstance] getUserEventLogHistory];
+        NSMutableDictionary *result = [NSMutableDictionary new];
+    
+        for (NSString *eventName in [history keyEnumerator]) {
+            CleverTapEventDetail *detail = history[eventName];
+            NSDictionary * _inner = [self _eventDetailToDict:detail];
+            result[eventName] = _inner;
+        }
+        dispatch_async(dispatch_get_main_queue(), ^{
+            [self returnResult:result withCallback:callback andError:nil];
+        });
+    });
+}
 
 #pragma mark - Profile API
 
@@ -387,6 +424,21 @@ RCT_EXPORT_METHOD(sessionGetUTMDetails:(RCTResponseSenderBlock)callback) {
     [self returnResult:result withCallback:callback andError:nil];
 }
 
+RCT_EXPORT_METHOD(getUserLastVisitTs:(RCTResponseSenderBlock)callback) {
+    RCTLogInfo(@"[CleverTap getUserLastVisitTs]");
+    NSTimeInterval result = [[self cleverTapInstance] getUserLastVisitTs];
+    [self returnResult:@(result) withCallback:callback andError:nil];
+}
+
+RCT_EXPORT_METHOD(getUserAppLaunchCount:(RCTResponseSenderBlock)callback) {
+    RCTLogInfo(@"[CleverTap getUserAppLaunchCount]");
+    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
+        int result = [[self cleverTapInstance] getUserAppLaunchCount];
+        dispatch_async(dispatch_get_main_queue(), ^{
+            [self returnResult:@(result) withCallback:callback andError:nil];
+        });
+    });
+}
 
 #pragma mark - no-op Android O methods
 
@@ -451,6 +503,10 @@ RCT_EXPORT_METHOD(setDebugLevel:(double)level) {
             [_dict setObject:detail.eventName forKey:@"eventName"];
         }
         
+        if(detail.normalizedEventName){
+            [_dict setObject:detail.normalizedEventName forKey:@"normalizedEventName"];
+        }
+        
         if(detail.firstTime){
             [_dict setObject:@(detail.firstTime) forKey:@"firstTime"];
         }
@@ -462,6 +518,10 @@ RCT_EXPORT_METHOD(setDebugLevel:(double)level) {
         if(detail.count){
             [_dict setObject:@(detail.count) forKey:@"count"];
         }
+        
+        if(detail.deviceID){
+            [_dict setObject:detail.deviceID forKey:@"deviceID"];
+        }
     }
     
     return _dict;

package/ios/CleverTapReact.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "self:">
+   </FileRef>
+</Workspace>

package/ios/CleverTapReact.xcodeproj/xcuserdata/kushagra.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>SchemeUserState</key>
+	<dict>
+		<key>CleverTapReact.xcscheme_^#shared#^_</key>
+		<dict>
+			<key>orderHint</key>
+			<integer>0</integer>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/package.json

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

package/src/NativeCleverTapModule.ts

@@ -70,7 +70,16 @@ export interface Spec extends TurboModule {
     eventName: string,
     callback: ((error: Object, result: boolean) => void) | null
   ): void;
+  getUserEventLog(
+    eventName: string,
+    callback: ((error: Object, result: boolean) => void) | null
+  ): void;
+  getUserEventLogCount(
+    eventName: string,
+    callback: ((error: Object, result: boolean) => void) | null
+  ): void;
   getEventHistory(callback: ((error: Object, result: boolean) => void) | null): void;
+  getUserEventLogHistory(callback: ((error: Object, result: boolean) => void) | null): void;
   setLocation(location: number, longitude: number): void;
   profileGetCleverTapAttributionIdentifier(callback: ((error: Object, result: boolean) => void) | null): void;
   profileGetCleverTapID(callback: ((error: Object, result: boolean) => void) | null): void;
@@ -104,6 +113,8 @@ export interface Spec extends TurboModule {
   sessionGetScreenCount(callback: ((error: Object, result: boolean) => void) | null): void;
   sessionGetPreviousVisitTime(callback: ((error: Object, result: boolean) => void) | null): void;
   sessionGetUTMDetails(callback: ((error: Object, result: boolean) => void) | null): void;
+  getUserLastVisitTs(callback: ((error: Object, result: boolean) => void) | null): void;
+  getUserAppLaunchCount(callback: ((error: Object, result: boolean) => void) | null): void;
   createNotificationChannel(
     channelId: string,
     withChannelName: string,

package/src/index.d.ts

@@ -224,6 +224,8 @@ export function isPushPermissionGranted(callback: CallbackString): void;
   ): void;
 
   /**
+   * @deprecated
+   * Since version 3.2.0. Use `getUserEventLog()` instead.
    * Get Event First Time
    * @param eventName {string}
    * callback returns epoch seconds or -1
@@ -231,6 +233,8 @@ export function isPushPermissionGranted(callback: CallbackString): void;
   export function eventGetFirstTime(eventName: string, callback: Callback): void;
 
   /**
+   * @deprecated
+   * Since version 3.2.0. Use `getUserEventLog()` instead.
    * Get Event Last Time
    * @param eventName {string}
    * callback returns epoch seconds or -1
@@ -238,6 +242,8 @@ export function isPushPermissionGranted(callback: CallbackString): void;
   export function eventGetLastTime(eventName: string, callback: Callback): void;
 
   /**
+   * @deprecated
+   * Since version 3.2.0. Use `getUserEventLogCount()` instead.
    * Get Event Number of Occurrences
    * @param eventName {string}
    * calls back with int or -1
@@ -245,6 +251,9 @@ export function isPushPermissionGranted(callback: CallbackString): void;
   export function eventGetOccurrences(eventName: string, callback: Callback): void;
 
   /**
+   * @deprecated
+   * Since version 3.2.0. Use `getUserEventLog()` instead.
+   *
    * Get Event Details
    * @param eventName {string}
    * calls back with object {"eventName": <string>, "firstTime":<epoch seconds>, "lastTime": <epoch seconds>, "count": <int>} or empty object
@@ -252,10 +261,32 @@ export function isPushPermissionGranted(callback: CallbackString): void;
   export function eventGetDetail(eventName: string, callback: Callback): void;
 
   /**
+   * @deprecated
+   * Since version 3.2.0. Use `getUserEventLogHistory()` instead.
    * Get Event History
    * calls back with object {"eventName1":<event1 details object>, "eventName2":<event2 details object>}
    */
   export function getEventHistory(callback: Callback): void;
+  /**
+   *
+   * Get Event Details
+   * @param eventName {string}
+   * calls back with object {"eventName": <string>, "firstTime":<epoch seconds>, "lastTime": <epoch seconds>, "count": <int>, "deviceID": <string>, "normalizedEventName": <string>} or empty object
+   */
+  export function getUserEventLog(eventName: string, callback: Callback): void;
+    
+  /**
+   * Get count of times an event occured
+   * @param eventName {string}
+   * calls back with int or -1
+   */
+  export function getUserEventLogCount(eventName: string, callback: Callback): void;
+
+  /**
+   * Get Event History
+   * calls back with object {"eventName1":<event1 details object>, "eventName2":<event2 details object>}
+   */
+  export function getUserEventLogHistory(callback: Callback): void;
 
   /**
    * Set location
@@ -395,11 +426,25 @@ export function isPushPermissionGranted(callback: CallbackString): void;
   export function sessionGetTimeElapsed(callback: Callback): void;
 
   /**
-   * Get Session Total Visits
+   * Get timestamp of user's last app visit
+   * calls back with epoch seconds or -1
+   */
+  export function getUserLastVisitTs(callback: Callback): void;
+
+  /**
+   * Get total number of times user has lanched the app
    * calls back with int or -1
    */
-  export function sessionGetTotalVisits(callback: Callback): void;
+  export function getUserAppLaunchCount(callback: Callback): void;
 
+  /**
+   * @deprecated
+   * Since version 3.2.0. Use `getUserAppLaunchCount()` instead.
+   * Get Session Total Visits
+   * calls back with int or -1
+   */
+    export function sessionGetTotalVisits(callback: Callback): void;
+  
   /**
    * Get Session Screen Count
    * calls back with with int
@@ -407,6 +452,8 @@ export function isPushPermissionGranted(callback: CallbackString): void;
   export function sessionGetScreenCount(callback: Callback): void;
 
   /**
+   * @deprecated
+   * Since version 3.2.0. Use `getUserLastVisits()` instead.
    * Get Session Previous Visit Time
    * calls back with epoch seconds or -1
    */

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 = 30101;
+const libVersion = 30200;
 CleverTapReact.setLibrary(libName,libVersion);
 
 function defaultCallback(method, err, res) {
@@ -338,6 +338,7 @@ var CleverTap = {
 
     /**
     * Get the time of the first occurrence of an event
+    * @deprecated - Since version 3.2.0. Use getUserEventLog() instead
     * @param {string} eventName - the name of the event
     * @param {function(err, res)} callback that returns a res of epoch seconds or -1
     */
@@ -347,6 +348,7 @@ var CleverTap = {
 
     /**
     * Get the time of the most recent occurrence of an event
+    * @deprecated - Since version 3.2.0. Use getUserEventLog() instead
     * @param {string} eventName - the name of the event
     * @param {function(err, res)} callback that returns a res of epoch seconds or -1
     */
@@ -356,6 +358,7 @@ var CleverTap = {
 
     /**
     * Get the number of occurrences of an event
+    * @deprecated - Since version 3.2.0. Use getUserEventLogCount() instead
     * @param {string} eventName - the name of the event
     * @param {function(err, res)} callback that returns a res of int
     */
@@ -365,6 +368,7 @@ var CleverTap = {
 
     /**
     * Get the summary details of an event
+    * @deprecated - Since version 3.2.0. Use getUserEventLog() instead
     * @param {string} eventName - the name of the event
     * @param {function(err, res)} callback that returns a res of object {"eventName": <string>, "firstTime":<epoch seconds>, "lastTime": <epoch seconds>, "count": <int>} or empty object
     */
@@ -374,11 +378,37 @@ var CleverTap = {
 
     /**
     * Get the user's event history
+    * @deprecated - Since version 3.2.0. Use getUserEventLogHistory() instead
     * @param {function(err, res)} callback that returns a res of object {"eventName1":<event1 details object>, "eventName2":<event2 details object>}
     */
     getEventHistory: function (callback) {
         callWithCallback('getEventHistory', null, callback);
     },
+    /**
+    * Get the details of a specific event
+    * @param {string} eventName - the name of the event
+    * @param {function(err, res)} callback that returns a res of object {"eventName": <string>, "firstTime":<epoch seconds>, "lastTime": <epoch seconds>, "count": <int>, "deviceID": <string>, "normalizedEventName": <string>} or empty object
+    */
+    getUserEventLog: function (eventName, callback) {
+        callWithCallback('getUserEventLog', [eventName], callback);
+    },
+    
+    /**
+    * Get the count of times an event occured
+    * @param {string} eventName - the name of the event
+    * @param {function(err, res)} callback that returns a res of int
+    */
+    getUserEventLogCount: function (eventName, callback) {
+        callWithCallback('getUserEventLogCount', [eventName], callback);
+    },
+
+    /**
+    * Get full event hostory for current user
+    * @param {function(err, res)} callback that returns a res of object {"eventName1":<event1 details object>, "eventName2":<event2 details object>}
+    */
+    getUserEventLogHistory: function (callback) {
+        callWithCallback('getUserEventLogHistory', null, callback);
+    },
 
     /**
     * Set the user's location as a latitude,longitude coordinate
@@ -539,12 +569,29 @@ var CleverTap = {
 
     /**
     * Get the total number of vists by the user
+    * @deprecated - Since version 3.2.0. Use getUserAppLaunchCount() instead
     * @param {function(err, res)} callback that returns a res of int
     */
     sessionGetTotalVisits: function (callback) {
         callWithCallback('sessionGetTotalVisits', null, callback);
     },
 
+    /**
+    * Get timestamp of user's last app visit
+    * @param {function(err, res)} callback that returns a res of epoch seconds or -1
+    */
+    getUserLastVisitTs: function (callback) {
+        callWithCallback('getUserLastVisitTs', null, callback);
+    },
+    
+    /**
+    * Get the total number of times user has launched the app
+    * @param {function(err, res)} callback that returns a res of int
+    */
+    getUserAppLaunchCount: function (callback) {
+        callWithCallback('getUserAppLaunchCount', null, callback);
+    },
+
     /**
     * Get the number of screens viewed by the user during the session
     * @param {function(err, res)} callback that returns a res of int
@@ -555,6 +602,7 @@ var CleverTap = {
 
     /**
     * Get the most recent previous visit time of the user
+    * @deprecated - Since version 3.2.0. Use getUserLastVisits() instead
     * @param {function(err, res)} callback that returns a res of epoch seconds or -1
     */
     sessionGetPreviousVisitTime: function (callback) {