clevertap-react-native 3.1.1 → 3.3.0

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:**
     
@@ -107,43 +107,7 @@ Clevertap ReactNative SDK supports `AndroidX Media3` from `v3.0.0+` to replace t
 |  `com.google.android.exoplayer:exoplayer-ui:2.19.1` | `androidx.media3:media3-ui:1.1.1`  |
 
 
-### Troubleshooting  
-
-If you face the following crash at runtime -
-
-```java.lang.UnsatisfiedLinkError: couldn't find DSO to load: libhermes.so```
-
-Add the following in your app/build.gradle -
-
-```
-project.ext.react = [
-    entryFile: "index.js",
-    enableHermes: false //add this
-]
-def jscFlavor = 'org.webkit:android-jsc:+'
-def enableHermes = project.ext.react.get("enableHermes", false);
-def jscFlavor = 'org.webkit:android-jsc:+'
-def enableHermes = project.ext.react.get("enableHermes", false);
-dependencies {
-if (enableHermes) {
-      // For RN 0.60.x
-      def hermesPath = "../../node_modules/hermesvm/android/"
-      debugImplementation files(hermesPath + "hermes-debug.aar")
-      releaseImplementation files(hermesPath + "hermes-release.aar")
-    } else {
-      implementation jscFlavor
-    }
-}
-```
-In android/build.gradle add this -
-
-```
-maven {
-        url "$rootDir/../node_modules/jsc-android/dist"
-      }
-```
-
-## 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)).
@@ -167,4 +131,32 @@ dependencies {
 }
 ```
 
+### Troubleshooting
+#### Upgrading to clevertap-react-native v3.3.0
+
+To use `clevertap-react-native v3.3.0`, it is recommended to upgrade to **React Native v0.74+**.
+
+If you insist on using an older version of React Native, consider the following possible resolutions for common issues:
+
+##### For ReactNative v0.73
+**Error:** `Compiled with an incompatible version of Kotlin`
+
+**Resolution:** Force the Kotlin version in your root `build.gradle`:
+```gradle
+dependencies {
+  ....
+  classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:2.0.0"
+
+  // NOTE: Do not place your application dependencies here; they belong
+  // in the individual module build.gradle files
+}
+```
+
+##### For ReactNative v0.71 or v0.72
+**Error:** `java.lang.NullPointerException: Cannot invoke "String.length()" because "<parameter1>" is null`
+
+**Reference:** https://issuetracker.google.com/issues/342522142
+
+**Resolution:** Either upgrade to `AGP 8.0.0+` or use a specific version of D8/R8 compiler as recommended in [this comment](https://issuetracker.google.com/issues/342522142#comment8) 
+
 Now move on to [integrating the SDK](./integration.md).

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clevertap-react-native",
-  "version": "3.1.1",
+  "version": "3.3.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 = 30300;
 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) {