@convivainc/conviva-react-native-appanalytics 0.2.10000 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 
 # Changelog
+## 0.3.0 (14/Apr/2026)
+- Babel plugin simplified to `@convivainc/conviva-react-native-appanalytics/plugin`; app-level `babel-types` and `babel-template` dependencies no longer needed.
+- `add-react-displayname` plugin no longer needed; absorbed internally by the Conviva plugin.
+- Using latest android(v1.3.1) and ios(v1.10.2) native packages.
+
+## 0.2.8 (06/Apr/2025)
+- Added trackRevenueEvent API to track purchase and revenue events.
+- Using latest android(v1.3.1) and ios(v1.10.1) native packages.
+
+## 0.2.7 (31/Dec/2025)
+- Supports network request url query params tracking.
+- Enhanced the remote configuration feature to support instant updates.
+- Using latest android(v1.2.6) and ios(v1.8.0) native packages.
+
+## 0.2.6 (16/Dec/2025)
+- Improves App Load Time metric by collecting more data. 
+- Using latest android(v1.2.6) and ios(v1.7.0) native packages.
+
+## 0.2.5 (25/Nov/2025)
+- Improved crash reporting and ANRs to deliver deeper insights and faster fixes for a more stable app experience. Applicable for:
+- Android 11 (API 30) and above
+- iOS 14 and above
+
+## 0.2.4 (16/Oct/2025)
+- Using latest android(v1.2.3) and ios(v1.5.0) native packages.
+
+## 0.2.3 (23/Sep/2025)
+- Resolved an issue where certain network requests on Apple mobile platforms were not being captured by the DPI module.
 
 ## 0.2.2 (27/Mar/2025)
 - Exposing getClientId and setClientId methods for ts.

package/README.md

@@ -76,22 +76,40 @@ tracker.trackPageView(pageViewEvent);
 ```
 
 ## Auto detect button clicks.
-Even though the React Native components can be natively mapped in Android and iOS, for the Auto detection of button clicks for **Button**, **TouchableHighlight**, **TouchableOpacity**, **TouchableWithoutFeedback** and **TouchableNativeFeedback** Components, needs explicit addition of babel transfomation. Add below plugin code in your application .babel.rc or babel.config.js file:
+Even though the React Native components can be natively mapped in Android and iOS, for the Auto detection of button clicks for **Button**, **TouchableHighlight**, **TouchableOpacity**, **TouchableWithoutFeedback** and **TouchableNativeFeedback** Components, needs explicit addition of babel transformation. Add below plugin code in your application `.babelrc` or `babel.config.js` file:
 
+**>= 0.3.0** - no extra dependencies needed in the app:
 ```js
 
-"plugins": ["./node_modules/@convivainc/conviva-react-native-appanalytics/instrumentation/index.js"]
+"plugins": ["@convivainc/conviva-react-native-appanalytics/plugin"]
 
 ```
 
-## Auto detect ScreenView Events for tracking screen navigation.
-To support Conviva to Auto Detect the Screen Name part of the ScreenView Events, add below plugin code in your application .babel.rc or babel.config.js file:
+**<= 0.2.8** - also required `babel-types` and `babel-template` as explicit app-level dependencies:
 ```js
 
+"plugins": ["./node_modules/@convivainc/conviva-react-native-appanalytics/instrumentation/index.js"]
+
+```
+```json
+
+"babel-types": "...",
+"babel-template": "..."
+
+```
+
+## `displayName` auto-detection
+**<= 0.2.8** - required as a separate entry in `.babelrc` / `babel.config.js`:
+```js
 "plugins": ["add-react-displayname"]
+```
 
+**>= 0.3.0** - no separate entry needed. `displayName` auto-detection is absorbed internally by the Conviva plugin:
+```js
+"plugins": ["@convivainc/conviva-react-native-appanalytics/plugin"]
 ```
 
+## Auto detect ScreenView Events for tracking screen navigation.
 For React Navigation versions 5 and above, to autocapture screenviews, wrap withReactNavigationAutotrack(autocaptureNavigationTrack) around the NavigationContainer:
 
 ```js
@@ -114,7 +132,7 @@ withReactNavigationAutotrack(autocaptureNavigationTrack)(NavigationContainer);
 </ConvivaNavigationContainer>
 ```
 
-For React Navigation versions below 5, wrap the AppContainer (the result of a call to React Navigation’s createAppContainer() method) with withReactNavigationAutotrack(autocaptureNavigationTrack)
+For React Navigation versions below 5, wrap the AppContainer (the result of a call to React Navigation's createAppContainer() method) with withReactNavigationAutotrack(autocaptureNavigationTrack)
 ```js
 
 let AppNavigator = createStackNavigator(
@@ -189,9 +207,9 @@ tracker.clearAllCustomTags();
 Event | Occurrence |
 ------|------------ |
 network_request | after receiving the network request response ; auto collected from the Native Sensors, Need android-plugin inclusion for Android|
-screen_view | when the screen is interacted on either first launch or relaunch ; auto collected from the Native Sensors + React Native Screens; Need add-react-displayname plugin and wrapping of Navigation Components |
+screen_view | when the screen is interacted on either first launch or relaunch ; auto collected from the Native Sensors + React Native Screens; Need Conviva `plugin.js` (includes `displayName` injection) and wrapping of Navigation Components |
 application_error | when an error occurrs in the application ; auto collected from the Native Sensors|
-button_click | on the button click callback ; auto collected from the Native Sensors + React Native **Button**, **TouchableHighlight**, **TouchableOpacity**, **TouchableWithoutFeedback** and **TouchableNativeFeedback** Components; Need Conviva index.js from the node_modules folder|
+button_click | on the button click callback ; auto collected from the Native Sensors + React Native **Button**, **TouchableHighlight**, **TouchableOpacity**, **TouchableWithoutFeedback** and **TouchableNativeFeedback** Components; Need Conviva `plugin.js` from the node_modules folder|
 application_background | when the application is taken to the background ; auto collected from the Native Sensors|
 application_foreground | when the application is taken to the foreground ; auto collected from the Native Sensors|
 application_install | when the application is launched for the first time after it's installed. (It's not the exact installed time.) |

package/RNConvivaAppAnalytics.podspec

@@ -20,5 +20,5 @@ Pod::Spec.new do |s|
   s.requires_arc = true
 
   s.dependency "React-Core"
-  s.dependency "ConvivaAppAnalytics", "1.1.10000"
+  s.dependency "ConvivaAppAnalytics", "1.10.2"
 end

package/android/build.gradle

@@ -16,6 +16,7 @@ buildscript {
 apply plugin: "com.android.library"
 
 android {
+    namespace "com.conviva.react.apptracker"
     compileSdkVersion safeExtGet('compileSdkVersion', 33)
     buildToolsVersion safeExtGet('buildToolsVersion', '30.0.2')
 
@@ -51,5 +52,5 @@ dependencies {
     implementation "com.squareup.okhttp3:okhttp:4.9.3"
     implementation "com.facebook.react:react-native:+"
     implementation 'com.googlecode.json-simple:json-simple:1.1'
-    implementation 'com.conviva.sdk:conviva-android-tracker:1.2.1'
+    implementation 'com.conviva.sdk:conviva-android-tracker:1.3.1'
 }

package/android/gradle.properties

@@ -1,2 +1,3 @@
 android.useAndroidX=true
-android.enableJetifier=true
+android.enableJetifier=true
+android.defaults.buildfeatures.buildconfig=true

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

@@ -13,6 +13,8 @@ import com.conviva.apptracker.configuration.TrackerConfiguration;
 import com.conviva.apptracker.controller.TrackerController;
 import com.conviva.apptracker.event.ButtonClick;
 import com.conviva.apptracker.event.ConsentGranted;
+import com.conviva.apptracker.revenue.ConvivaRevenueEvent;
+import com.conviva.apptracker.revenue.ConvivaRevenueEventItem;
 import com.conviva.apptracker.event.ConsentWithdrawn;
 import com.conviva.apptracker.event.DeepLinkReceived;
 import com.conviva.apptracker.event.EcommerceTransaction;
@@ -37,6 +39,7 @@ import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.ReadableMapKeySetIterator;
 
+import org.json.JSONObject;
 import org.json.simple.JSONValue;
 
 import java.util.ArrayList;
@@ -48,13 +51,40 @@ import java.util.concurrent.TimeUnit;
 import okhttp3.OkHttpClient;
 import okhttp3.Request;
 
+import com.facebook.react.bridge.ReactMarker;
+import com.facebook.react.bridge.ReactMarker.MarkerListener;
+import com.facebook.react.bridge.ReactMarkerConstants;
+
+
 public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
 
     private final ReactApplicationContext reactContext;
 
+    public static volatile long contentAppearedTimestamp;
+
+
     public RNConvivaTrackerModule(ReactApplicationContext reactContext) {
         super(reactContext);
         this.reactContext = reactContext;
+
+        addContentAppearedMarkerListener();
+    }
+
+    private void addContentAppearedMarkerListener() {
+        if (contentAppearedTimestamp <= 0) {
+            ReactMarker.addListener(new MarkerListener() {
+                @Override
+                public void logMarker(ReactMarkerConstants name, String tag, int instanceKey) {
+                    if (name == ReactMarkerConstants.CONTENT_APPEARED && contentAppearedTimestamp <= 0) {
+                        contentAppearedTimestamp = System.currentTimeMillis();
+                        TrackerController tracker = ConvivaAppAnalytics.getDefaultTracker();
+                        if (tracker != null) {
+                            tracker.setContentAppearedTimestamp(contentAppearedTimestamp);
+                        }
+                    }
+                }
+            });
+        }
     }
 
     @Override
@@ -163,7 +193,12 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
             }
 
             // create the tracker
-            ConvivaAppAnalytics.createTracker(this.reactContext, customerKey, appName, controllers.toArray(new Configuration[controllers.size()]));
+            TrackerController trackerController = ConvivaAppAnalytics.createTracker(this.reactContext, customerKey, appName, controllers.toArray(new Configuration[controllers.size()]));
+
+            //Set the contentAppearedTimestamp if already captured
+            if(trackerController != null && contentAppearedTimestamp > 0) {
+                trackerController.setContentAppearedTimestamp(contentAppearedTimestamp);
+            }
 
             promise.resolve(true);
 
@@ -188,6 +223,16 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         }
     }
 
+    @ReactMethod
+    public void cleanup(Promise promise) {
+        try {
+            // commented out deprecated methods
+            promise.resolve(true);
+
+        } catch (Throwable t) {
+            promise.reject("ERROR", t.getMessage());
+        }
+    }
     @ReactMethod
     public void removeAllTrackers(Promise promise) {
         try {
@@ -501,6 +546,78 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         }
     }
 
+    @ReactMethod
+    public void trackRevenueEvent(ReadableMap details, Promise promise) {
+        try {
+            String namespace = details.getString("tracker");
+            TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                ReadableMap argmap = details.getMap("eventData");
+
+                double totalOrderAmount = argmap.getDouble("totalOrderAmount");
+                String transactionId = argmap.getString("transactionId");
+                String currency = argmap.getString("currency");
+
+                ConvivaRevenueEvent.Builder builder =
+                    ConvivaRevenueEvent.builder(totalOrderAmount, transactionId, currency);
+
+                if (argmap.hasKey("taxAmount") && !argmap.isNull("taxAmount"))
+                    builder.taxAmount(argmap.getDouble("taxAmount"));
+                if (argmap.hasKey("shippingCost") && !argmap.isNull("shippingCost"))
+                    builder.shippingCost(argmap.getDouble("shippingCost"));
+                if (argmap.hasKey("discount") && !argmap.isNull("discount"))
+                    builder.discount(argmap.getDouble("discount"));
+                if (argmap.hasKey("cartSize") && !argmap.isNull("cartSize"))
+                    builder.cartSize(argmap.getInt("cartSize"));
+                if (argmap.hasKey("paymentMethod") && !argmap.isNull("paymentMethod"))
+                    builder.paymentMethod(argmap.getString("paymentMethod"));
+                if (argmap.hasKey("paymentProvider") && !argmap.isNull("paymentProvider"))
+                    builder.paymentProvider(argmap.getString("paymentProvider"));
+                if (argmap.hasKey("extraMetadata") && !argmap.isNull("extraMetadata"))
+                    builder.extraMetadata(new JSONObject(argmap.getMap("extraMetadata").toHashMap()));
+
+                if (argmap.hasKey("items") && !argmap.isNull("items")) {
+                    ReadableArray itemsArray = argmap.getArray("items");
+                    List<ConvivaRevenueEventItem> items = new ArrayList<>();
+                    for (int i = 0; i < itemsArray.size(); i++) {
+                        ReadableMap itemDict = itemsArray.getMap(i);
+                        ConvivaRevenueEventItem.Builder itemBuilder = ConvivaRevenueEventItem.builder();
+                        if (itemDict.hasKey("productId") && !itemDict.isNull("productId"))
+                            itemBuilder.productId(itemDict.getString("productId"));
+                        if (itemDict.hasKey("name") && !itemDict.isNull("name"))
+                            itemBuilder.name(itemDict.getString("name"));
+                        if (itemDict.hasKey("sku") && !itemDict.isNull("sku"))
+                            itemBuilder.sku(itemDict.getString("sku"));
+                        if (itemDict.hasKey("category") && !itemDict.isNull("category"))
+                            itemBuilder.category(EventUtil.createStrings(itemDict.getArray("category")));
+                        if (itemDict.hasKey("unitPrice") && !itemDict.isNull("unitPrice"))
+                            itemBuilder.unitPrice(itemDict.getDouble("unitPrice"));
+                        if (itemDict.hasKey("quantity") && !itemDict.isNull("quantity"))
+                            itemBuilder.quantity(itemDict.getInt("quantity"));
+                        if (itemDict.hasKey("discount") && !itemDict.isNull("discount"))
+                            itemBuilder.discount(itemDict.getDouble("discount"));
+                        if (itemDict.hasKey("brand") && !itemDict.isNull("brand"))
+                            itemBuilder.brand(itemDict.getString("brand"));
+                        if (itemDict.hasKey("variant") && !itemDict.isNull("variant"))
+                            itemBuilder.variant(itemDict.getString("variant"));
+                        if (itemDict.hasKey("extraMetadata") && !itemDict.isNull("extraMetadata"))
+                            itemBuilder.extraMetadata(new JSONObject(itemDict.getMap("extraMetadata").toHashMap()));
+                        items.add(itemBuilder.build());
+                    }
+                    builder.items(items);
+                }
+
+                trackerController.trackRevenueEvent(builder.build());
+                promise.resolve(true);
+            } else {
+                promise.reject("ERROR", "TrackerController is null");
+            }
+
+        } catch (Throwable t) {
+            promise.reject("ERROR", t.getMessage());
+        }
+    }
+
     @ReactMethod
     public void setCustomTags(ReadableMap details, Promise promise) {
         try {
@@ -947,6 +1064,21 @@ public class RNConvivaTrackerModule extends ReactContextBaseJavaModule {
         }
     }
 
+    @ReactMethod
+    private void setContentAppearedTimestamp(ReadableMap argmap, Promise promise) {
+        try {
+            String namespace = argmap.getString("tracker");
+            long contentAppearedTimestamp = (long) argmap.getDouble("contentAppearedTimestamp");
+            TrackerController trackerController = getTracker(namespace);
+            if (trackerController != null) {
+                trackerController.setContentAppearedTimestamp(contentAppearedTimestamp);
+            }
+            promise.resolve(true);
+        } catch (Throwable t) {
+            promise.reject("ERROR", t.getMessage());
+        }
+    }
+
     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.2.2";
+    public final static String RN_CONVIVA_TRACKER_VERSION = "rn-0.3.0";
 
 }

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

@@ -71,6 +71,11 @@ interface NetworkConfiguration {
      */
     requestHeaders?: Record<string, string>;
 }
+interface TraceparentConfiguration {
+    force: Boolean;
+    enabled: Boolean;
+    targetUrl: string[];
+}
 /**
  * TrackerConfiguration
  */
@@ -304,6 +309,7 @@ interface RemoteConfiguration {
  */
 interface TrackerControllerConfiguration {
     networkConfig?: NetworkConfiguration;
+    traceparentConfig?: TraceparentConfiguration;
     trackerConfig?: TrackerConfiguration;
     sessionConfig?: SessionConfiguration;
     emitterConfig?: EmitterConfiguration;
@@ -572,6 +578,39 @@ type MessageNotificationProps = {
      */
     trigger: Trigger;
 };
+/**
+ * RevenueEventItem properties.
+ * All fields are optional.
+ */
+type RevenueEventItemProps = {
+    productId?: string;
+    name?: string;
+    sku?: string;
+    category?: string[];
+    unitPrice?: number;
+    quantity?: number;
+    discount?: number;
+    brand?: string;
+    variant?: string;
+    extraMetadata?: Record<string, unknown>;
+};
+/**
+ * RevenueEvent properties.
+ * Required: totalOrderAmount, transactionId, currency.
+ */
+type RevenueEventProps = {
+    totalOrderAmount: number;
+    transactionId: string;
+    currency: string;
+    taxAmount?: number;
+    shippingCost?: number;
+    discount?: number;
+    cartSize?: number;
+    paymentMethod?: string;
+    paymentProvider?: string;
+    items?: RevenueEventItemProps[];
+    extraMetadata?: Record<string, unknown>;
+};
 /**
  * The ReactNativeTracker type
  */
@@ -656,6 +695,13 @@ type ReactNativeTracker = {
      * @returns {Promise}
      */
     readonly trackCustomEvent: (eventName: string, eventData: any, contexts?: EventContext[]) => Promise<void>;
+    /**
+     * Tracks a revenue event
+     *
+     * @param argmap - The revenue event properties
+     * @param contexts - The array of event contexts
+     */
+    readonly trackRevenueEvent: (argmap: RevenueEventProps, contexts?: EventContext[]) => Promise<void>;
     /**
      * Sets custom tags
      *
@@ -848,6 +894,12 @@ declare function removeTracker(trackerNamespace: string): Promise<boolean>;
  * @returns - A boolean promise
  */
 declare function removeAllTrackers(): Promise<boolean>;
+/**
+ * Cleanup
+ *
+ * @returns - A boolean promise
+ */
+declare function cleanup(): Promise<boolean>;
 /**
  * Gets the cliend id
  *
@@ -868,4 +920,4 @@ declare const _default: {
     withReactNavigationAutotrack: (AppContainer: any) => react.ForwardRefExoticComponent<react.RefAttributes<any>>;
 };
 
-export { Basis, BufferOption, ConsentDocument, ConsentGrantedProps, ConsentWithdrawnProps, DeepLinkReceivedProps, DevicePlatform, EcommerceItem, EcommerceTransactionProps, EmitterConfiguration, EventContext, GCConfiguration, GdprConfiguration, GlobalContext, HttpMethod, LogLevel, MessageNotificationProps, NetworkConfiguration, PageViewProps, ReactNativeTracker, ScreenSize, ScreenViewProps, SelfDescribing, SessionConfiguration, StructuredProps, SubjectConfiguration, TimingProps, TrackerConfiguration, TrackerControllerConfiguration, Trigger, autocaptureNavigationTrack, createTracker, _default as default, getWebViewCallback, removeAllTrackers, removeTracker, withReactNavigationAutotrack, getClientId, setClientId};
+export { Basis, BufferOption, ConsentDocument, ConsentGrantedProps, ConsentWithdrawnProps, DeepLinkReceivedProps, DevicePlatform, EcommerceItem, EcommerceTransactionProps, EmitterConfiguration, EventContext, GCConfiguration, GdprConfiguration, GlobalContext, HttpMethod, LogLevel, MessageNotificationProps, NetworkConfiguration, PageViewProps, ReactNativeTracker, RevenueEventItemProps, RevenueEventProps, ScreenSize, ScreenViewProps, SelfDescribing, SessionConfiguration, StructuredProps, SubjectConfiguration, TimingProps, TrackerConfiguration, TrackerControllerConfiguration, Trigger, autocaptureNavigationTrack, cleanup, createTracker, _default as default, getClientId, getWebViewCallback, removeAllTrackers, removeTracker, setClientId, withReactNavigationAutotrack };

package/conviva-react-native-appanalytics.js

@@ -52,11 +52,11 @@ function safeWaitCallback(callPromise, errHandle) {
  * Handles an error.
  *
  * @param err - The error to be handled.
+ * @param alwaysLog - When true, the error is logged regardless of the __DEV__ flag.
  */
-function errorHandler(err) {
-    if (__DEV__) {
+function errorHandler(err, alwaysLog = false) {
+    if (__DEV__ || alwaysLog) {
         console.warn('ConvivaTracker:' + err.message);
-        return undefined;
     }
     return undefined;
 }
@@ -128,6 +128,10 @@ const logMessages = {
     deepLinkReq: 'deepLinkReceived event requires the url parameter to be set',
     messageNotificationReq: 'messageNotification event requires title, body, and trigger parameters to be set',
     trackCustomEvent: 'trackCustomEvent event requires name and data',
+    revenueEventNullEvent: 'event is null. Event not sent.',
+    revenueEventInvalidTotalOrderAmount: 'Must be a finite number. Event not sent.',
+    revenueEventInvalidTransactionId: 'Must be a non-empty string. Event not sent.',
+    revenueEventInvalidCurrency: 'Must be a non-empty string. Event not sent.',
     trackClickEvent: 'click event requires atleast one attribute',
     // custom tags contexts
     setCustomTags: 'setCustomTags requires tags',
@@ -152,6 +156,7 @@ const logMessages = {
     trackEcommerceTransaction: 'trackEcommerceTransaction:',
     trackDeepLinkReceived: 'trackDeepLinkReceivedEvent:',
     trackMessageNotification: 'trackMessageNotificationEvent:',
+    trackRevenueEvent: 'trackRevenueEvent:',
     removeGlobalContexts: 'removeGlobalContexts:',
     addGlobalContexts: 'addGlobalContexts:',
     // setters
@@ -413,11 +418,26 @@ function validateEcommerceTransaction(argmap) {
     return Promise.resolve(true);
 }
 /**
- * Validates a custom event
+ * Validates a revenue event
  *
  * @param argmap {Object} - the object to validate
  * @returns - boolean promise
  */
+function validateRevenueEvent(argmap) {
+    if (!isObject(argmap)) {
+        return Promise.reject(new Error(logMessages.revenueEventNullEvent));
+    }
+    if (typeof argmap.totalOrderAmount !== 'number' || !Number.isFinite(argmap.totalOrderAmount)) {
+        return Promise.reject(new Error(`invalid totalOrderAmount "${argmap.totalOrderAmount}". ${logMessages.revenueEventInvalidTotalOrderAmount}`));
+    }
+    if (typeof argmap.transactionId !== 'string' || argmap.transactionId.trim() === '') {
+        return Promise.reject(new Error(`invalid transactionId "${argmap.transactionId}". ${logMessages.revenueEventInvalidTransactionId}`));
+    }
+    if (typeof argmap.currency !== 'string' || argmap.currency.trim() === '') {
+        return Promise.reject(new Error(`invalid currency "${argmap.currency}". ${logMessages.revenueEventInvalidCurrency}`));
+    }
+    return Promise.resolve(true);
+}
 function validateCustomEvent(argmap) {
     // validate type
     if (!isObject(argmap)) {
@@ -954,6 +974,26 @@ function trackCustomEvent$1(namespace, name, arg, contexts = []) {
         throw new Error(`${logMessages.trackCustomEvent} ${error.message}`);
     });
 }
+/**
+ * Tracks a revenue event
+ *
+ * @param namespace {string} - the tracker namespace
+ * @param argmap {Object} - the event data
+ * @param contexts {Array}- the event contexts
+ * @returns {Promise}
+ */
+function trackRevenueEvent$1(namespace, argmap, contexts = []) {
+    return validateRevenueEvent(argmap)
+        .then(() => validateContexts(contexts))
+        .then(() => RNConvivaTracker.trackRevenueEvent({
+        tracker: namespace,
+        eventData: argmap,
+        contexts: contexts
+    }))
+        .catch((error) => {
+        throw new Error(`${logMessages.trackRevenueEvent} ${error.message}`);
+    });
+}
 /**
  * Sets custom tags
  *
@@ -1330,6 +1370,14 @@ function removeAllTrackers$1() {
     }
     return Promise.resolve(RNConvivaTracker.removeAllTrackers());
 }
+/**
+ * Cleanup
+ *
+ * @returns - A void promise
+ */
+function cleanup$1() {
+    return Promise.resolve(RNConvivaTracker.cleanup());
+}
 /**
  * Get the client id which is in prescribed format.
  *
@@ -1508,6 +1556,20 @@ function trackCustomEvent(namespace) {
         return trackCustomEvent$1(namespace, eventName, eventData, contexts);
     };
 }
+/**
+ * Returns a function to track a RevenueEvent by a tracker
+ *
+ * @param namespace {string} - The tracker namespace
+ * @returns - A function to track a RevenueEvent
+ */
+function trackRevenueEvent(namespace) {
+    return function (argmap, contexts = []) {
+        if (!isTrackerInitialised) {
+            return Promise.reject(new Error(logMessages.createTrackerNotSet));
+        }
+        return trackRevenueEvent$1(namespace, argmap, contexts);
+    };
+}
 function setCustomTags(namespace) {
     return function (tags, contexts = []) {
         if (!isTrackerInitialised) {
@@ -2015,7 +2077,7 @@ class NavigationUtil {
     }
 }
 
-const version = "0.22.6";
+const version = "0.3.0";
 
 const { Platform } = require('react-native');
 let reactNativeVersionString = null;
@@ -2174,6 +2236,8 @@ controllerConfig = {}) {
     }));
     // mkMethod creates methods subscribed to the initTrackerPromise
     const mkMethod = safeWait(initTrackerPromise, errorHandler);
+    // mkMethodAlwaysLog creates methods that always log errors, regardless of __DEV__
+    const mkMethodAlwaysLog = safeWait(initTrackerPromise, (err) => errorHandler(err, true));
     // mkCallback creates callbacks subscribed to the initTrackerPromise
     const mkCallback = safeWaitCallback(initTrackerPromise, errorHandler);
     // track methods
@@ -2189,6 +2253,7 @@ controllerConfig = {}) {
     const trackDeepLinkReceivedEvent$1 = mkMethod(trackDeepLinkReceivedEvent(namespace));
     const trackMessageNotificationEvent$1 = mkMethod(trackMessageNotificationEvent(namespace));
     const trackCustomEvent$1 = mkMethod(trackCustomEvent(namespace));
+    const trackRevenueEvent$1 = mkMethodAlwaysLog(trackRevenueEvent(namespace));
     const trackClickEvent$1 = mkMethod(trackClickEvent(namespace));
     // custom tags contexts
     const setCustomTags$1 = mkMethod(setCustomTags(namespace));
@@ -2229,6 +2294,7 @@ controllerConfig = {}) {
         trackDeepLinkReceivedEvent: trackDeepLinkReceivedEvent$1,
         trackMessageNotificationEvent: trackMessageNotificationEvent$1,
         trackCustomEvent: trackCustomEvent$1,
+        trackRevenueEvent: trackRevenueEvent$1,
         setCustomTags: setCustomTags$1,
         setCustomTagsWithCategory: setCustomTagsWithCategory$1,
         clearCustomTags: clearCustomTags$1,
@@ -2274,6 +2340,15 @@ function removeAllTrackers() {
     return removeAllTrackers$1()
         .catch((e) => errorHandler(e));
 }
+/**
+ * Cleanup
+ *
+ * @returns - A boolean promise
+ */
+function cleanup() {
+    return cleanup$1()
+        .catch((e) => errorHandler(e));
+}
 /**
  * Gets the cliend id
  *
@@ -2298,7 +2373,6 @@ const autocaptureNavigationTrack = handleError((payload) => {
     trackScreenViewEvent('CAT')(payload).catch((e) => errorHandler(e));
 }, 'Event autocapture', true);
 const autocaptureTrack = handleError((payload) => {
-    checkDisplayNamePlugin();
     trackClickEvent('CAT')(payload).catch((e) => errorHandler(e));
 }, 'Event autocapture', true);
 var index = {
@@ -2306,5 +2380,5 @@ var index = {
     withReactNavigationAutotrack: withReactNavigationAutotrack(autocaptureNavigationTrack)
 };
 
-export { autocaptureNavigationTrack, createTracker, index as default, getClientId, getWebViewCallback, removeAllTrackers, removeTracker, setClientId, withReactNavigationAutotrack };
+export { autocaptureNavigationTrack, cleanup, createTracker, index as default, getClientId, getWebViewCallback, removeAllTrackers, removeTracker, setClientId, withReactNavigationAutotrack };
 //# sourceMappingURL=conviva-react-native-appanalytics.js.map

package/instrumentation/index.js

@@ -1,66 +1,4 @@
-const t = require('babel-types');
-const template = require('babel-template');
-
-const convivaLibImport = template(`(
-  require('@convivainc/conviva-react-native-appanalytics').default || {
-    HIGHER_ORDER_COMP: (Component) => Component,
-  }
-)`);
-
-const createHigherOrderComponent = template(`
-  const COMPONENT_ID = HIGHER_ORDER_COMP_CALL_EXPRESSION;
-`);
-
-const ALLOWED_TOUCHABLE_COMPONENTS = [
-  'TouchableOpacity',
-  'TouchableNativeFeedback',
-  'TouchableWithoutFeedback',
-  'TouchableHighlight',
-];
-
-const replaceWithTouchableAutoTrackHigherOrderComponent = path => {
-  
-  if (!ALLOWED_TOUCHABLE_COMPONENTS.includes(path.node.id.name)) {
-    return;
-  }
-  // console.log("replaceWithTouchableAutoTrackHigherOrderComponent++");
-
-  const equivalentExpression = t.classExpression(
-    path.node.id,
-    path.node.superClass,
-    path.node.body,
-    path.node.decorators || []
-  );
-
-  const hocID = t.identifier('convivaTouchableAutoTrack');
-
-  const convivaImport = convivaLibImport({
-    HIGHER_ORDER_COMP: hocID,
-  });
-
-  const autotrackExpression = t.callExpression(
-    t.memberExpression(convivaImport.expression, hocID),
-    [equivalentExpression]
-  );
-
-  const replacement = createHigherOrderComponent({
-    COMPONENT_ID: path.node.id,
-    HIGHER_ORDER_COMP_CALL_EXPRESSION: autotrackExpression,
-  });
-
-  path.replaceWith(replacement);
-
-  // console.log("replaceWithTouchableAutoTrackHigherOrderComponent--");
-};
-
-function transform(babel) {
-  return {
-    visitor: {
-      ClassDeclaration(path) {
-        replaceWithTouchableAutoTrackHigherOrderComponent(path);
-      },
-    },
-  };
-}
-
-module.exports = transform;
+'use strict';
+// Backward-compatibility shim. The canonical implementation lives in plugin.js.
+// Existing integrations that reference this path directly continue to work.
+module.exports = require('../plugin.js');

package/ios/RNConvivaAppAnalytics.m

@@ -45,6 +45,8 @@
 #import <ConvivaAppAnalytics/CATEcommerce.h>
 #import <ConvivaAppAnalytics/CATDeepLinkReceived.h>
 #import <ConvivaAppAnalytics/CATMessageNotification.h>
+#import <ConvivaAppAnalytics/CATRevenueEvent.h>
+#import <ConvivaAppAnalytics/CATRevenueEventItem.h>
 #import <Foundation/NSObject.h>
 
 @implementation RNConvivaTracker
@@ -173,6 +175,11 @@ RCT_EXPORT_METHOD(removeAllTrackers: (RCTPromiseResolveBlock)resolve rejecter:(R
     resolve(@YES);
 }
 
+RCT_EXPORT_METHOD(cleanup: (RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+    [CATAppAnalytics cleanup];
+    resolve(@YES);
+}
+
 RCT_EXPORT_METHOD(trackSelfDescribingEvent:
                   (NSDictionary *)details
                   resolver:(RCTPromiseResolveBlock)resolve
@@ -650,6 +657,101 @@ RCT_EXPORT_METHOD(trackCustomEvent:
     }
 }
 
+RCT_EXPORT_METHOD(trackRevenueEvent:
+    (NSDictionary *)details
+            resolver:(RCTPromiseResolveBlock)resolve
+            rejecter:(RCTPromiseRejectBlock)reject) {
+
+    NSString *namespace = [details objectForKey:@"tracker"];
+
+    id<CATTrackerController> trackerController = [self trackerByNamespace:namespace];
+
+    if (trackerController != nil) {
+        NSDictionary *argmap = [details objectForKey:@"eventData"];
+
+        NSNumber *totalOrderAmount = [argmap objectForKey:@"totalOrderAmount"];
+        NSString *transactionId = [argmap objectForKey:@"transactionId"];
+        NSString *currency = [argmap objectForKey:@"currency"];
+        
+        CATRevenueEvent *event = [[CATRevenueEvent alloc]
+                                  initWithTotalOrderAmount:totalOrderAmount
+                                  transactionId:transactionId
+                                  currency:currency];
+
+        if ([argmap objectForKey:@"taxAmount"] && ![[argmap objectForKey:@"taxAmount"] isEqual:[NSNull null]]) {
+            event.taxAmount = [argmap objectForKey:@"taxAmount"];
+        }
+        if ([argmap objectForKey:@"shippingCost"] && ![[argmap objectForKey:@"shippingCost"] isEqual:[NSNull null]]) {
+            event.shippingCost = [argmap objectForKey:@"shippingCost"];
+        }
+        if ([argmap objectForKey:@"discount"] && ![[argmap objectForKey:@"discount"] isEqual:[NSNull null]]) {
+            event.discount = [argmap objectForKey:@"discount"];
+        }
+        if ([argmap objectForKey:@"cartSize"] && ![[argmap objectForKey:@"cartSize"] isEqual:[NSNull null]]) {
+            event.cartSize = [argmap objectForKey:@"cartSize"];
+        }
+        if ([argmap objectForKey:@"paymentMethod"] && ![[argmap objectForKey:@"paymentMethod"] isEqual:[NSNull null]]) {
+            event.paymentMethod = [argmap objectForKey:@"paymentMethod"];
+        }
+        if ([argmap objectForKey:@"paymentProvider"] && ![[argmap objectForKey:@"paymentProvider"] isEqual:[NSNull null]]) {
+            event.paymentProvider = [argmap objectForKey:@"paymentProvider"];
+        }
+        if ([argmap objectForKey:@"extraMetadata"] && ![[argmap objectForKey:@"extraMetadata"] isEqual:[NSNull null]]) {
+            event.extraMetadata = [argmap objectForKey:@"extraMetadata"];
+        }
+
+        NSArray *itemsArray = [argmap objectForKey:@"items"];
+        if (itemsArray && ![itemsArray isEqual:[NSNull null]] && [itemsArray isKindOfClass:[NSArray class]]) {
+            NSMutableArray<CATRevenueEventItem *> *items = [NSMutableArray array];
+            for (NSDictionary *itemDict in itemsArray) {
+                if (![itemDict isKindOfClass:[NSDictionary class]]) continue;
+
+                CATRevenueEventItem *item = [[CATRevenueEventItem alloc] init];
+
+                if ([itemDict objectForKey:@"productId"] && ![[itemDict objectForKey:@"productId"] isEqual:[NSNull null]]) {
+                    item.productId = [itemDict objectForKey:@"productId"];
+                }
+                if ([itemDict objectForKey:@"name"] && ![[itemDict objectForKey:@"name"] isEqual:[NSNull null]]) {
+                    item.name = [itemDict objectForKey:@"name"];
+                }
+                if ([itemDict objectForKey:@"sku"] && ![[itemDict objectForKey:@"sku"] isEqual:[NSNull null]]) {
+                    item.sku = [itemDict objectForKey:@"sku"];
+                }
+                if ([itemDict objectForKey:@"category"] && ![[itemDict objectForKey:@"category"] isEqual:[NSNull null]]) {
+                    item.category = [itemDict objectForKey:@"category"];
+                }
+                if ([itemDict objectForKey:@"unitPrice"] && ![[itemDict objectForKey:@"unitPrice"] isEqual:[NSNull null]]) {
+                    item.unitPrice = [itemDict objectForKey:@"unitPrice"];
+                }
+                if ([itemDict objectForKey:@"quantity"] && ![[itemDict objectForKey:@"quantity"] isEqual:[NSNull null]]) {
+                    item.quantity = [itemDict objectForKey:@"quantity"];
+                }
+                if ([itemDict objectForKey:@"discount"] && ![[itemDict objectForKey:@"discount"] isEqual:[NSNull null]]) {
+                    item.discount = [itemDict objectForKey:@"discount"];
+                }
+                if ([itemDict objectForKey:@"brand"] && ![[itemDict objectForKey:@"brand"] isEqual:[NSNull null]]) {
+                    item.brand = [itemDict objectForKey:@"brand"];
+                }
+                if ([itemDict objectForKey:@"variant"] && ![[itemDict objectForKey:@"variant"] isEqual:[NSNull null]]) {
+                    item.variant = [itemDict objectForKey:@"variant"];
+                }
+                if ([itemDict objectForKey:@"extraMetadata"] && ![[itemDict objectForKey:@"extraMetadata"] isEqual:[NSNull null]]) {
+                    item.extraMetadata = [itemDict objectForKey:@"extraMetadata"];
+                }
+
+                [items addObject:item];
+            }
+            event.items = items;
+        }
+
+        [trackerController trackRevenueEvent:event];
+        resolve(@YES);
+    } else {
+        NSError* error = [NSError errorWithDomain:@"ConvivaAppAnalytics" code:200 userInfo:nil];
+        reject(@"ERROR", @"tracker with given namespace not found", error);
+    }
+}
+
 RCT_EXPORT_METHOD(setCustomTags:
     (NSDictionary *)details
             resolver:(RCTPromiseResolveBlock)resolve
@@ -1021,7 +1123,7 @@ RCT_EXPORT_METHOD(getIsInBackground:
 //        NSError* error = [NSError errorWithDomain:@"ConvivaAppAnalytics" code:200 userInfo:nil];
 //        reject(@"ERROR", @"tracker with given namespace not found", error);
 //    }
-
+    
     @try {
         resolve(@(YES));
     } @catch (NSException *exception) {

package/ios/Util/RNTrackerVersion.m

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

package/package.json

@@ -1,12 +1,18 @@
 {
   "name": "@convivainc/conviva-react-native-appanalytics",
-  "version": "0.2.10000",
+  "version": "0.3.0",
   "description": "Conviva React Native Application Analytics Library",
   "main": "conviva-react-native-appanalytics.js",
   "repository": {
     "type": "git",
     "url": "git+github.com:Conviva/conviva-react-native-appanalytics.git"
   },
+  "dependencies": {
+    "@babel/plugin-transform-react-display-name": "^7.0.0",
+    "hoist-non-react-statics": "^3.3.2",
+    "lodash": "^4.17.21",
+    "tslib": "^2.6.0"
+  },
   "keywords": [
     "Conviva",
     "Application",

package/plugin.js

@@ -0,0 +1,140 @@
+'use strict';
+
+// Resolve babel-types and babel-template in a version-agnostic way.
+// Priority order:
+//   1. Use types/template injected by Babel itself (Babel 7 plugin API).
+//   2. Fall back to @babel/types / @babel/template (Babel 7 standalone packages).
+//   3. Fall back to babel-types / babel-template (Babel 6 legacy packages,
+//      guaranteed present via this package's own dependencies).
+// The fallback chain means the plugin works whether the host project uses
+// Babel 6 or Babel 7, without requiring either legacy package to be installed
+// explicitly by the consuming app.
+
+function resolveTypes(babel) {
+  if (babel && babel.types) {
+    return babel.types;
+  }
+  try { return require('@babel/types'); } catch (_) {}
+  try { return require('babel-types'); } catch (_) {}
+  throw new Error('[conviva] Could not resolve babel types. Install @babel/types (Babel 7) or babel-types (Babel 6).');
+}
+
+function resolveTemplate(babel) {
+  if (babel && babel.template) {
+    return babel.template;
+  }
+  try { return require('@babel/template').default || require('@babel/template'); } catch (_) {}
+  try { return require('babel-template'); } catch (_) {}
+  throw new Error('[conviva] Could not resolve babel template. Install @babel/template (Babel 7) or babel-template (Babel 6).');
+}
+
+const ALLOWED_TOUCHABLE_COMPONENTS = [
+  'TouchableOpacity',
+  'TouchableNativeFeedback',
+  'TouchableWithoutFeedback',
+  'TouchableHighlight',
+];
+
+function replaceWithTouchableAutoTrackHigherOrderComponent(path, t, template) {
+  if (!ALLOWED_TOUCHABLE_COMPONENTS.includes(path.node.id.name)) {
+    return;
+  }
+
+  const convivaLibImport = template(`(
+    require('@convivainc/conviva-react-native-appanalytics').default || {
+      HIGHER_ORDER_COMP: (Component) => Component,
+    }
+  )`);
+
+  const createHigherOrderComponent = template(`
+    const COMPONENT_ID = HIGHER_ORDER_COMP_CALL_EXPRESSION;
+  `);
+
+  const equivalentExpression = t.classExpression(
+    path.node.id,
+    path.node.superClass,
+    path.node.body,
+    path.node.decorators || []
+  );
+
+  const hocID = t.identifier('convivaTouchableAutoTrack');
+
+  const convivaImport = convivaLibImport({
+    HIGHER_ORDER_COMP: hocID,
+  });
+
+  const autotrackExpression = t.callExpression(
+    t.memberExpression(convivaImport.expression, hocID),
+    [equivalentExpression]
+  );
+
+  const replacement = createHigherOrderComponent({
+    COMPONENT_ID: path.node.id,
+    HIGHER_ORDER_COMP_CALL_EXPRESSION: autotrackExpression,
+  });
+
+  path.replaceWith(replacement);
+}
+
+// @babel/plugin-transform-react-display-name is listed in this package's
+// dependencies, so it is always present in the package's own node_modules.
+function resolveDisplayNamePlugin() {
+  try {
+    const mod = require('@babel/plugin-transform-react-display-name');
+    return mod.default || mod;
+  } catch (_) {}
+  throw new Error(
+    '[conviva] Could not resolve @babel/plugin-transform-react-display-name. ' +
+    'Make sure it is installed: npm install --save-dev @babel/plugin-transform-react-display-name'
+  );
+}
+
+// Injects `ClassName.displayName = 'ClassName'` after ES6 class declarations
+// that contain a render() method. This covers the gap left by
+// @babel/plugin-transform-react-display-name v7.x, which only handles
+// React.createClass() / createReactClass() call patterns and has no
+// ClassDeclaration visitor.
+// Touchable components are skipped because they are replaced entirely by the
+// HOC wrapping logic above.
+function injectClassDisplayName(path, t) {
+  const className = path.node.id && path.node.id.name;
+  if (!className || ALLOWED_TOUCHABLE_COMPONENTS.includes(className)) return;
+
+  const hasRenderMethod = path.node.body.body.some(
+    member =>
+      member.type === 'ClassMethod' &&
+      member.key &&
+      member.key.name === 'render'
+  );
+  if (!hasRenderMethod) return;
+
+  path.insertAfter(
+    t.expressionStatement(
+      t.assignmentExpression(
+        '=',
+        t.memberExpression(t.identifier(className), t.identifier('displayName')),
+        t.stringLiteral(className)
+      )
+    )
+  );
+}
+
+function transform(babel) {
+  const t = resolveTypes(babel);
+  const template = resolveTemplate(babel);
+
+  return {
+    // Bundles @babel/plugin-transform-react-display-name so consumers don't
+    // need to add it separately - display name injection is a Conviva concern
+    // required for screen_view auto-detection via ConvivaNavigationContainer.
+    inherits: resolveDisplayNamePlugin(),
+    visitor: {
+      ClassDeclaration(path) {
+        replaceWithTouchableAutoTrackHigherOrderComponent(path, t, template);
+        injectClassDisplayName(path, t);
+      },
+    },
+  };
+}
+
+module.exports = transform;