@convivainc/conviva-react-native-appanalytics 0.1.5 → 0.2.0

package/CHANGELOG.md

@@ -1,6 +1,12 @@
 
 # Changelog
 
+## 0.2.0 (06/SEP/2024)
+- Introduces API for setting the conviva identifier
+- Internal enhancements for the Android Bridge
+*This feature needs the Android App SDK version of [0.9.5](https://github.com/Conviva/conviva-android-appanalytics)*
+*This feature needs the iOS App SDK version of [0.2.30](https://github.com/Conviva/conviva-ios-appanalytics)*
+
 ## 0.1.5 (07/JUN/2024)
 - Supports trackCustomEvent with JSONObject argument for [iOS Bridge](https://github.com/Conviva/conviva-ios-appanalytics)
 

package/README.md

@@ -133,7 +133,6 @@ let App = withReactNavigationAutotrack(autocaptureNavigationTrack)(AppNavigator)
 
 
 ## Custom event tracking to track your application specific events and state changes
-<strong>_*** Note: Supported only in Android right now ***_<br></strong><br>
 Use trackCustomEvent() API to track all kinds of events. This API provides 2 fields to describe the tracked events.
 
 eventName - Name of the custom event. (Mandatory)

package/android/src/main/java/com/conviva/react/apptracker/RNConvivaTrackerModule.java

@@ -22,7 +22,6 @@ import com.conviva.apptracker.event.ScreenView;
 import com.conviva.apptracker.event.SelfDescribing;
 import com.conviva.apptracker.event.Structured;
 import com.conviva.apptracker.event.Timing;
-import com.conviva.apptracker.globalcontexts.GlobalContext;
 import com.conviva.apptracker.internal.constants.TrackerConstants;
 import com.conviva.apptracker.network.CollectorCookieJar;
 import com.conviva.apptracker.network.HttpMethod;
@@ -89,8 +88,6 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
                 if (networkConfig.hasKey("customPostPath") && !networkConfig.isNull("customPostPath")) {
                     String customPostPath = networkConfig.getString("customPostPath");
                     networkConfiguration.customPostPath = customPostPath;
-                } else {
-                    networkConfiguration.customPostPath = (customerKey + "/" + TrackerConstants.CONVIVA_PROTOCOL_VERSION);
                 }
                 if (networkConfig.hasKey("requestHeaders") && !networkConfig.isNull("requestHeaders")) {
                     ReadableMap requestHeaders = networkConfig.getMap("requestHeaders");
@@ -180,8 +177,11 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
-
-            promise.resolve(ConvivaAppAnalytics.removeTracker(trackerController));
+            if (trackerController != null) {
+                promise.resolve(ConvivaAppAnalytics.removeTracker(trackerController));
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -200,23 +200,45 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         }
     }
 
+    @ReactMethod
+    public void setClientId(ReadableMap argmap, Promise promise) {
+        try {
+            promise.resolve(ConvivaAppAnalytics.setClientId(this.reactContext, argmap.getString("clientId")));
+        } catch (Throwable t) {
+            promise.reject("ERROR", t.getMessage());
+        }
+    }
+
+    @ReactMethod
+    public void getClientId(Promise promise) {
+        try {
+            promise.resolve(ConvivaAppAnalytics.getClientId(this.reactContext));
+        } catch (Throwable t) {
+            promise.reject("ERROR", t.getMessage());
+        }
+    }
+
     @ReactMethod
     public void trackSelfDescribingEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("eventData");
-            ReadableArray contexts = details.getArray("contexts");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("eventData");
+                ReadableArray contexts = details.getArray("contexts");
 
-            SelfDescribingJson sdj = EventUtil.createSelfDescribingJson(argmap);
-            SelfDescribing event = new SelfDescribing(sdj);
 
-            List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
-            event.customContexts.addAll(evCtxts);
+                SelfDescribingJson sdj = EventUtil.createSelfDescribingJson(argmap);
+                SelfDescribing event = new SelfDescribing(sdj);
 
-            trackerController.track(event);
-            promise.resolve(true);
+                List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
+                event.customContexts.addAll(evCtxts);
+
+                trackerController.track(event);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -227,18 +249,23 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackStructuredEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("eventData");
-            ReadableArray contexts = details.getArray("contexts");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            Structured event = EventUtil.createStructuredEvent(argmap);
+                ReadableMap argmap = details.getMap("eventData");
+                ReadableArray contexts = details.getArray("contexts");
 
-            List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
-            event.customContexts.addAll(evCtxts);
 
-            trackerController.track(event);
-            promise.resolve(true);
+                Structured event = EventUtil.createStructuredEvent(argmap);
+
+                List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
+                event.customContexts.addAll(evCtxts);
+
+                trackerController.track(event);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -249,18 +276,22 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackScreenViewEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("eventData");
-            ReadableArray contexts = details.getArray("contexts");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("eventData");
+                ReadableArray contexts = details.getArray("contexts");
 
-            ScreenView event = EventUtil.createScreenViewEvent(argmap);
 
-            List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
-            event.customContexts.addAll(evCtxts);
+                ScreenView event = EventUtil.createScreenViewEvent(argmap);
 
-            trackerController.track(event);
-            promise.resolve(true);
+                List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
+                event.customContexts.addAll(evCtxts);
+
+                trackerController.track(event);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -271,18 +302,22 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackPageView(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("eventData");
-            ReadableArray contexts = details.getArray("contexts");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("eventData");
+                ReadableArray contexts = details.getArray("contexts");
 
-            PageView event = EventUtil.createPageViewEvent(argmap);
 
-            List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
-            event.customContexts.addAll(evCtxts);
+                PageView event = EventUtil.createPageViewEvent(argmap);
 
-            trackerController.track(event);
-            promise.resolve(true);
+                List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
+                event.customContexts.addAll(evCtxts);
+
+                trackerController.track(event);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -293,18 +328,21 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackTimingEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("eventData");
-            ReadableArray contexts = details.getArray("contexts");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("eventData");
+                ReadableArray contexts = details.getArray("contexts");
 
-            Timing event = EventUtil.createTimingEvent(argmap);
+                Timing event = EventUtil.createTimingEvent(argmap);
 
-            List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
-            event.customContexts.addAll(evCtxts);
+                List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
+                event.customContexts.addAll(evCtxts);
 
-            trackerController.track(event);
-            promise.resolve(true);
+                trackerController.track(event);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -315,18 +353,22 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackConsentGrantedEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("eventData");
-            ReadableArray contexts = details.getArray("contexts");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("eventData");
+                ReadableArray contexts = details.getArray("contexts");
 
-            ConsentGranted event = EventUtil.createConsentGrantedEvent(argmap);
 
-            List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
-            event.customContexts.addAll(evCtxts);
+                ConsentGranted event = EventUtil.createConsentGrantedEvent(argmap);
 
-            trackerController.track(event);
-            promise.resolve(true);
+                List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
+                event.customContexts.addAll(evCtxts);
+
+                trackerController.track(event);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -337,18 +379,22 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackConsentWithdrawnEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("eventData");
-            ReadableArray contexts = details.getArray("contexts");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("eventData");
+                ReadableArray contexts = details.getArray("contexts");
 
-            ConsentWithdrawn event = EventUtil.createConsentWithdrawnEvent(argmap);
 
-            List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
-            event.customContexts.addAll(evCtxts);
+                ConsentWithdrawn event = EventUtil.createConsentWithdrawnEvent(argmap);
 
-            trackerController.track(event);
-            promise.resolve(true);
+                List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
+                event.customContexts.addAll(evCtxts);
+
+                trackerController.track(event);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -359,18 +405,22 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackEcommerceTransactionEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("eventData");
-            ReadableArray contexts = details.getArray("contexts");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("eventData");
+                ReadableArray contexts = details.getArray("contexts");
 
-            EcommerceTransaction event = EventUtil.createEcommerceTransactionEvent(argmap);
 
-            List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
-            event.customContexts.addAll(evCtxts);
+                EcommerceTransaction event = EventUtil.createEcommerceTransactionEvent(argmap);
 
-            trackerController.track(event);
-            promise.resolve(true);
+                List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
+                event.customContexts.addAll(evCtxts);
+
+                trackerController.track(event);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -381,18 +431,22 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackDeepLinkReceivedEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("eventData");
-            ReadableArray contexts = details.getArray("contexts");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("eventData");
+                ReadableArray contexts = details.getArray("contexts");
 
-            DeepLinkReceived event = EventUtil.createDeepLinkReceivedEvent(argmap);
 
-            List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
-            event.customContexts.addAll(evCtxts);
+                DeepLinkReceived event = EventUtil.createDeepLinkReceivedEvent(argmap);
 
-            trackerController.track(event);
-            promise.resolve(true);
+                List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
+                event.customContexts.addAll(evCtxts);
+
+                trackerController.track(event);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -403,18 +457,22 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackMessageNotificationEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("eventData");
-            ReadableArray contexts = details.getArray("contexts");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("eventData");
+                ReadableArray contexts = details.getArray("contexts");
 
-            MessageNotification event = EventUtil.createMessageNotificationEvent(argmap);
 
-            List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
-            event.customContexts.addAll(evCtxts);
+                MessageNotification event = EventUtil.createMessageNotificationEvent(argmap);
 
-            trackerController.track(event);
-            promise.resolve(true);
+                List<SelfDescribingJson> evCtxts = EventUtil.createContexts(contexts);
+                event.customContexts.addAll(evCtxts);
+
+                trackerController.track(event);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -425,15 +483,18 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackCustomEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            String eventName = details.getString("eventName");
-            ReadableMap argmap = details.getMap("eventData");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                String eventName = details.getString("eventName");
+                ReadableMap argmap = details.getMap("eventData");
 
-            HashMap<String, Object> eventData = argmap.toHashMap();
+                HashMap<String, Object> eventData = argmap.toHashMap();
 
-            trackerController.trackCustomEvent(eventName, JSONValue.toJSONString(eventData));
-            promise.resolve(true);
+                trackerController.trackCustomEvent(eventName, JSONValue.toJSONString(eventData));
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -444,14 +505,17 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void setCustomTags(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap argmap = details.getMap("tags");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("tags");
 
-            HashMap<String, Object> tags = argmap.toHashMap();
+                HashMap<String, Object> tags = argmap.toHashMap();
 
-            trackerController.setCustomTags(tags);
-            promise.resolve(true);
+                trackerController.setCustomTags(tags);
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -462,13 +526,17 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void clearCustomTags(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableArray argArray = details.getArray("tagKeys");
-
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableArray argArray = details.getArray("tagKeys");
 
-            List<String> tagKeys = EventUtil.createStrings(argArray);
-            trackerController.clearCustomTags(new HashSet<>(tagKeys));
-            promise.resolve(true);
+
+                List<String> tagKeys = EventUtil.createStrings(argArray);
+                trackerController.clearCustomTags(new HashSet<>(tagKeys));
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -480,9 +548,13 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            trackerController.clearAllCustomTags();
-            promise.resolve(true);
+                trackerController.clearAllCustomTags();
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -493,13 +565,18 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     public void trackClickEvent(ReadableMap details, Promise promise) {
         try {
             String namespace = details.getString("tracker");
-            ReadableMap eventMap = details.getMap("eventData");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap eventMap = details.getMap("eventData");
 
-            ButtonClick event = EventUtil.createButtonClickEvent(eventMap);
-            trackerController.track(event);
 
-            promise.resolve(true);
+                ButtonClick event = EventUtil.createButtonClickEvent(eventMap);
+                trackerController.track(event);
+
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -555,13 +632,17 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            if (details.isNull("userId")) {
-                trackerController.getSubject().setUserId(null);
+                if (details.isNull("userId")) {
+                    trackerController.getSubject().setUserId(null);
+                } else {
+                    trackerController.getSubject().setUserId(details.getString("userId"));
+                }
+                promise.resolve(true);
             } else {
-                trackerController.getSubject().setUserId(details.getString("userId"));
+                promise.reject("ERROR", "TrackerController is null");
             }
-            promise.resolve(true);
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -573,13 +654,17 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            if (details.isNull("networkUserId")) {
-                trackerController.getSubject().setNetworkUserId(null);
+                if (details.isNull("networkUserId")) {
+                    trackerController.getSubject().setNetworkUserId(null);
+                } else {
+                    trackerController.getSubject().setNetworkUserId(details.getString("networkUserId"));
+                }
+                promise.resolve(true);
             } else {
-                trackerController.getSubject().setNetworkUserId(details.getString("networkUserId"));
+                promise.reject("ERROR", "TrackerController is null");
             }
-            promise.resolve(true);
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -591,13 +676,17 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            if (details.isNull("domainUserId")) {
-                trackerController.getSubject().setDomainUserId(null);
+                if (details.isNull("domainUserId")) {
+                    trackerController.getSubject().setDomainUserId(null);
+                } else {
+                    trackerController.getSubject().setDomainUserId(details.getString("domainUserId"));
+                }
+                promise.resolve(true);
             } else {
-                trackerController.getSubject().setDomainUserId(details.getString("domainUserId"));
+                promise.reject("ERROR", "TrackerController is null");
             }
-            promise.resolve(true);
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -609,13 +698,17 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            if (details.isNull("ipAddress")) {
-                trackerController.getSubject().setIpAddress(null);
+                if (details.isNull("ipAddress")) {
+                    trackerController.getSubject().setIpAddress(null);
+                } else {
+                    trackerController.getSubject().setIpAddress(details.getString("ipAddress"));
+                }
+                promise.resolve(true);
             } else {
-                trackerController.getSubject().setIpAddress(details.getString("ipAddress"));
+                promise.reject("ERROR", "TrackerController is null");
             }
-            promise.resolve(true);
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -627,13 +720,17 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            if (details.isNull("useragent")) {
-                trackerController.getSubject().setUseragent(null);
+                if (details.isNull("useragent")) {
+                    trackerController.getSubject().setUseragent(null);
+                } else {
+                    trackerController.getSubject().setUseragent(details.getString("useragent"));
+                }
+                promise.resolve(true);
             } else {
-                trackerController.getSubject().setUseragent(details.getString("useragent"));
+                promise.reject("ERROR", "TrackerController is null");
             }
-            promise.resolve(true);
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -645,13 +742,17 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            if (details.isNull("timezone")) {
-                trackerController.getSubject().setTimezone(null);
+                if (details.isNull("timezone")) {
+                    trackerController.getSubject().setTimezone(null);
+                } else {
+                    trackerController.getSubject().setTimezone(details.getString("timezone"));
+                }
+                promise.resolve(true);
             } else {
-                trackerController.getSubject().setTimezone(details.getString("timezone"));
+                promise.reject("ERROR", "TrackerController is null");
             }
-            promise.resolve(true);
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -663,13 +764,17 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            if (details.isNull("language")) {
-                trackerController.getSubject().setLanguage(null);
+                if (details.isNull("language")) {
+                    trackerController.getSubject().setLanguage(null);
+                } else {
+                    trackerController.getSubject().setLanguage(details.getString("language"));
+                }
+                promise.resolve(true);
             } else {
-                trackerController.getSubject().setLanguage(details.getString("language"));
+                promise.reject("ERROR", "TrackerController is null");
             }
-            promise.resolve(true);
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -681,18 +786,22 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            if (details.isNull("screenResolution")) {
-                trackerController.getSubject().setScreenResolution(null);
-            } else {
-                ReadableArray screenRes = details.getArray("screenResolution");
-                int width = screenRes.getInt(0);
-                int height = screenRes.getInt(1);
-                Size screenR = new Size(width, height);
+                if (details.isNull("screenResolution")) {
+                    trackerController.getSubject().setScreenResolution(null);
+                } else {
+                    ReadableArray screenRes = details.getArray("screenResolution");
+                    int width = screenRes.getInt(0);
+                    int height = screenRes.getInt(1);
+                    Size screenR = new Size(width, height);
 
-                trackerController.getSubject().setScreenResolution(screenR);
+                    trackerController.getSubject().setScreenResolution(screenR);
+                }
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
             }
-            promise.resolve(true);
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -704,18 +813,22 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            if (details.isNull("screenViewport")) {
-                trackerController.getSubject().setScreenViewPort(null);
-            } else {
-                ReadableArray screenView = details.getArray("screenViewport");
-                int width = screenView.getInt(0);
-                int height = screenView.getInt(1);
-                Size screenVP = new Size(width, height);
+                if (details.isNull("screenViewport")) {
+                    trackerController.getSubject().setScreenViewPort(null);
+                } else {
+                    ReadableArray screenView = details.getArray("screenViewport");
+                    int width = screenView.getInt(0);
+                    int height = screenView.getInt(1);
+                    Size screenVP = new Size(width, height);
 
-                trackerController.getSubject().setScreenViewPort(screenVP);
+                    trackerController.getSubject().setScreenViewPort(screenVP);
+                }
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
             }
-            promise.resolve(true);
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -727,13 +840,17 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         try {
             String namespace = details.getString("tracker");
             TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
 
-            if (details.isNull("colorDepth")) {
-                trackerController.getSubject().setColorDepth(null);
+                if (details.isNull("colorDepth")) {
+                    trackerController.getSubject().setColorDepth(null);
+                } else {
+                    trackerController.getSubject().setColorDepth(details.getInt("colorDepth"));
+                }
+                promise.resolve(true);
             } else {
-                trackerController.getSubject().setColorDepth(details.getInt("colorDepth"));
+                promise.reject("ERROR", "TrackerController is null");
             }
-            promise.resolve(true);
 
         } catch (Throwable t) {
             promise.reject("ERROR", t.getMessage());
@@ -833,5 +950,4 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
     private TrackerController getTracker(String namespace) {
         return namespace == null ? ConvivaAppAnalytics.getDefaultTracker() : ConvivaAppAnalytics.getTracker(namespace);
     }
-
 }

package/android/src/main/java/com/conviva/react/apptracker/util/TrackerVersion.java

@@ -4,6 +4,6 @@ import com.conviva.react.apptracker.BuildConfig;
 
 public class TrackerVersion {
 
-    public final static String RN_CONVIVA_TRACKER_VERSION = "rn-0.1.5";
+    public final static String RN_CONVIVA_TRACKER_VERSION = "rn-0.2.0";
 
 }

package/conviva-react-native-appanalytics.d.ts

@@ -848,6 +848,19 @@ declare function removeTracker(trackerNamespace: string): Promise<boolean>;
  * @returns - A boolean promise
  */
 declare function removeAllTrackers(): Promise<boolean>;
+/**
+ * Gets the cliend id
+ *
+ * @returns - A string promise
+ */
+declare function getClientId(): Promise<string>;
+/**
+ * Sets the cliend id
+ *
+ * @param clientId {string}
+ * @returns - A boolean promise
+ */
+declare function setClientId(clientId: string): Promise<boolean>;
 declare const autocaptureNavigationTrack: (...args: any[]) => any;
 
 declare const _default: {

package/conviva-react-native-appanalytics.js

@@ -139,6 +139,8 @@ const logMessages = {
     // api error prefix
     createTracker: 'createTracker:',
     removeTracker: 'removeTracker: trackerNamespace can only be a string',
+    getClientId: 'getClientId: failed fetching client id',
+    setClientId: 'setClientId: clientId is invalid',
     // methods
     trackSelfDesc: 'trackSelfDescribingEvent:',
     trackScreenView: 'trackScreenViewEvent:',
@@ -164,6 +166,7 @@ const logMessages = {
     setScreenViewport: 'setScreenViewport: screenViewport can only be of ScreenSize type or null',
     setColorDepth: 'setColorDepth: colorDepth can only be a number(integer) or null',
     setSubjectData: 'setSubjectData:',
+    createTrackerNotSet: 'createTracker not invoked prior:'
 };
 
 /*
@@ -1282,6 +1285,7 @@ function setSubjectData$1(namespace, config) {
  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the Apache License Version 2.0 for the specific language governing permissions and limitations there under.
  */
+let isTrackerInitialised = false;
 /**
  * Create a tracker from specified initial configuration.
  *
@@ -1290,8 +1294,12 @@ function setSubjectData$1(namespace, config) {
  */
 function createTracker$1(initConfig) {
     return initValidate(initConfig)
-        .then(() => RNConvivaTracker.createTracker(initConfig))
+        .then(() => {
+        isTrackerInitialised = true;
+        return RNConvivaTracker.createTracker(initConfig);
+    })
         .catch((error) => {
+        isTrackerInitialised = false;
         throw new Error(`${logMessages.createTracker} ${error.message}.`);
     });
 }
@@ -1305,6 +1313,10 @@ function removeTracker$1(trackerNamespace) {
     if (typeof trackerNamespace !== 'string') {
         return Promise.reject(new Error(logMessages.removeTracker));
     }
+    if (!isTrackerInitialised) {
+        return Promise.reject(new Error(logMessages.createTrackerNotSet));
+    }
+    isTrackerInitialised = false;
     return Promise.resolve(RNConvivaTracker.removeTracker({ tracker: trackerNamespace }));
 }
 /**
@@ -1313,8 +1325,35 @@ function removeTracker$1(trackerNamespace) {
  * @returns - A void promise
  */
 function removeAllTrackers$1() {
+    if (!isTrackerInitialised) {
+        return Promise.reject(new Error(logMessages.createTrackerNotSet));
+    }
     return Promise.resolve(RNConvivaTracker.removeAllTrackers());
 }
+/**
+ * Get the client id which is in prescribed format.
+ *
+ * @returns - A promise string if the client if available or genetrated
+ */
+function getClientId$1() {
+    return Promise.resolve(RNConvivaTracker.getClientId())
+        .catch((error) => {
+        throw new Error(`${logMessages.getClientId} ${error.message}.`);
+    });
+}
+/**
+ * Set the client id which is in the prescribed format.
+ *
+ * @param clientId {string} - client id generated for the application in the device
+ * @returns - A promise fullfilled if the client id is valid
+ */
+function setClientId$1(clid) {
+    // have necessary checks in place
+    if (!clid || clid === "" || clid.split(".").length != 4 || !clid.split(".").every(part => part !== "" && !isNaN(Number(part)))) {
+        return Promise.reject(new Error(logMessages.setClientId));
+    }
+    return Promise.resolve(RNConvivaTracker.setClientId({ clientId: clid }));
+}
 /**
  * Returns a function to track a SelfDescribing event by a tracker
  *
@@ -1323,6 +1362,9 @@ function removeAllTrackers$1() {
  */
 function trackSelfDescribingEvent(namespace) {
     return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackSelfDescribingEvent$1(namespace, argmap, contexts);
     };
 }
@@ -1334,6 +1376,9 @@ function trackSelfDescribingEvent(namespace) {
  */
 function trackScreenViewEvent(namespace) {
     return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackScreenViewEvent$1(namespace, argmap, contexts);
     };
 }
@@ -1345,6 +1390,9 @@ function trackScreenViewEvent(namespace) {
  */
 function trackStructuredEvent(namespace) {
     return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackStructuredEvent$1(namespace, argmap, contexts);
     };
 }
@@ -1356,6 +1404,9 @@ function trackStructuredEvent(namespace) {
  */
 function trackPageView(namespace) {
     return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackPageView$1(namespace, argmap, contexts);
     };
 }
@@ -1367,6 +1418,9 @@ function trackPageView(namespace) {
  */
 function trackTimingEvent(namespace) {
     return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackTimingEvent$1(namespace, argmap, contexts);
     };
 }
@@ -1378,6 +1432,9 @@ function trackTimingEvent(namespace) {
  */
 function trackConsentGrantedEvent(namespace) {
     return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackConsentGrantedEvent$1(namespace, argmap, contexts);
     };
 }
@@ -1389,6 +1446,9 @@ function trackConsentGrantedEvent(namespace) {
  */
 function trackConsentWithdrawnEvent(namespace) {
     return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackConsentWithdrawnEvent$1(namespace, argmap, contexts);
     };
 }
@@ -1400,6 +1460,9 @@ function trackConsentWithdrawnEvent(namespace) {
  */
 function trackEcommerceTransactionEvent(namespace) {
     return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackEcommerceTransactionEvent$1(namespace, argmap, contexts);
     };
 }
@@ -1411,6 +1474,9 @@ function trackEcommerceTransactionEvent(namespace) {
  */
 function trackDeepLinkReceivedEvent(namespace) {
     return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackDeepLinkReceivedEvent$1(namespace, argmap, contexts);
     };
 }
@@ -1422,6 +1488,9 @@ function trackDeepLinkReceivedEvent(namespace) {
  */
 function trackMessageNotificationEvent(namespace) {
     return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackMessageNotificationEvent$1(namespace, argmap, contexts);
     };
 }
@@ -1433,26 +1502,41 @@ function trackMessageNotificationEvent(namespace) {
  */
 function trackCustomEvent(namespace) {
     return function (eventName, eventData, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackCustomEvent$1(namespace, eventName, eventData, contexts);
     };
 }
 function setCustomTags(namespace) {
     return function (tags, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return setCustomTags$1(namespace, tags, contexts);
     };
 }
 function setCustomTagsWithCategory(namespace) {
     return function (category, tags, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return setCustomTagsWithCategory$1(namespace, category, tags, contexts);
     };
 }
 function clearCustomTags(namespace) {
     return function (tagKeys, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return clearCustomTags$1(namespace, tagKeys, contexts);
     };
 }
 function clearAllCustomTags(namespace) {
     return function (contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return clearAllCustomTags$1(namespace, contexts);
     };
 }
@@ -1685,6 +1769,9 @@ function getForegroundIndex(namespace) {
  */
 function trackClickEvent(namespace) {
     return function (eventData) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
         return trackClickEvent$1(namespace, eventData);
     };
 }
@@ -2187,6 +2274,25 @@ function removeAllTrackers() {
     return removeAllTrackers$1()
         .catch((e) => errorHandler(e));
 }
+/**
+ * Gets the cliend id
+ *
+ * @returns - A string promise
+ */
+function getClientId() {
+    return Promise.resolve(getClientId$1())
+        .catch((e) => errorHandler(e));
+}
+/**
+ * Sets the cliend id
+ *
+ * @param clientId {string}
+ * @returns - A boolean promise
+ */
+function setClientId(clientId) {
+    return Promise.resolve(setClientId$1(clientId))
+        .catch((e) => errorHandler(e));
+}
 const autocaptureNavigationTrack = handleError((payload) => {
     checkDisplayNamePlugin();
     trackScreenViewEvent('CAT')(payload).catch((e) => errorHandler(e));
@@ -2200,5 +2306,5 @@ var index = {
     withReactNavigationAutotrack: withReactNavigationAutotrack(autocaptureNavigationTrack)
 };
 
-export { autocaptureNavigationTrack, createTracker, index as default, getWebViewCallback, removeAllTrackers, removeTracker, withReactNavigationAutotrack };
+export { autocaptureNavigationTrack, createTracker, index as default, getClientId, getWebViewCallback, removeAllTrackers, removeTracker, setClientId, withReactNavigationAutotrack };
 //# sourceMappingURL=conviva-react-native-appanalytics.js.map

package/ios/RNConvivaAppAnalytics.m

@@ -1074,6 +1074,44 @@ RCT_EXPORT_METHOD(getForegroundIndex:
     }
 }
 
+RCT_EXPORT_METHOD(getClientId: (RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+    
+    CATAppAnalytics *convivaAppAnalytics = [CATAppAnalytics sharedInstance];
+
+    if (convivaAppAnalytics != nil) {
+        NSString *clientId = [convivaAppAnalytics getClientId];
+        if (clientId != nil && clientId.length > 0) {
+            resolve(clientId);
+        }
+        else {
+            NSError* error = [NSError errorWithDomain:@"ConvivaAppAnalytics" code:200 userInfo:nil];
+            reject(@"ERROR", @"ClientId not found", error);
+        }
+    } else {
+        NSError* error = [NSError errorWithDomain:@"ConvivaAppAnalytics" code:200 userInfo:nil];
+        reject(@"ERROR", @"CATAppAnalytics not found", error);
+    }
+}
+
+RCT_EXPORT_METHOD(setClientId:
+                  (NSDictionary *)details
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    CATAppAnalytics *convivaAppAnalytics = [CATAppAnalytics sharedInstance];
+
+    if (convivaAppAnalytics != nil) {
+        NSString *newClientId = [details rncat_stringForKey:@"clientId" defaultValue:nil];
+        BOOL isClientIdSet = NO;
+        if (newClientId != nil && newClientId.length > 0) {
+             isClientIdSet = [convivaAppAnalytics setClientId: newClientId];
+        }
+        resolve(@(isClientIdSet));
+    } else {
+        NSError* error = [NSError errorWithDomain:@"ConvivaAppAnalytics" code:200 userInfo:nil];
+        reject(@"ERROR", @"tracker with given namespace not found", error);
+    }
+}
+
 - (nullable id<CATTrackerController>)trackerByNamespace:(NSString *)namespace {
     return [namespace isEqual:[NSNull null]] ? [CATAppAnalytics defaultTracker] : [CATAppAnalytics trackerByNamespace:namespace];
 }

package/ios/Util/RNTrackerVersion.m

@@ -22,6 +22,6 @@
 
 @implementation RNTrackerVersion
 
-NSString * const kRNTrackerVersion = @"rn-0.1.5";
+NSString * const kRNTrackerVersion = @"rn-0.2.0";
 
 @end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@convivainc/conviva-react-native-appanalytics",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "Conviva React Native Application Analytics Library",
   "main": "conviva-react-native-appanalytics.js",
   "repository": {