Merge branch 'main' into DX-809

lloyd-cio · web-flow · commit 12daa5c48dfd · 2025-11-20T16:27:27.000-07:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,15 @@
+## [5.2.0](https://github.com/customerio/customerio-reactnative/compare/5.1.1...5.2.0) (2025-11-20)
+
+### Features
+
+* add trackMetric method for manual push metric tracking ([#539](https://github.com/customerio/customerio-reactnative/issues/539)) ([43deefe](https://github.com/customerio/customerio-reactnative/commit/43deefef5afe66161ed954948c5f0388ba79be37))
+
+## [5.1.1](https://github.com/customerio/customerio-reactnative/compare/5.1.0...5.1.1) (2025-11-14)
+
+### Bug Fixes
+
+* expose in-app listener for expo ([#538](https://github.com/customerio/customerio-reactnative/issues/538)) ([48687f0](https://github.com/customerio/customerio-reactnative/commit/48687f07556645f58c569fd11bea7720494da829))
+
 ## [5.1.0](https://github.com/customerio/customerio-reactnative/compare/5.0.1...5.1.0) (2025-10-30)
 
 ### Features
diff --git a/android/src/main/java/io/customer/reactnative/sdk/NativeCustomerIOModuleImpl.kt b/android/src/main/java/io/customer/reactnative/sdk/NativeCustomerIOModuleImpl.kt
@@ -17,6 +17,9 @@ import io.customer.sdk.core.di.SDKComponent
 import io.customer.sdk.core.util.CioLogLevel
 import io.customer.sdk.core.util.Logger
 import io.customer.sdk.data.model.Region
+import io.customer.sdk.events.Metric
+import io.customer.sdk.events.TrackMetric
+import io.customer.sdk.events.serializedName
 
 /**
  * Shared implementation logic for Customer.io Native SDK communication in React Native.
@@ -156,6 +159,28 @@ internal object NativeCustomerIOModuleImpl {
         requireSDKInstance()?.registerDeviceToken(deviceToken)
     }
 
+    fun trackMetric(deliveryId: String?, deviceToken: String?, eventName: String?) {
+        try {
+            if (deliveryId == null || deviceToken == null || eventName == null) {
+                throw IllegalArgumentException("Missing required parameters")
+            }
+
+            val event = Metric.values().find {
+                it.serializedName.equals(eventName, true)
+            } ?: throw IllegalArgumentException("Invalid metric event name")
+
+            requireSDKInstance()?.trackMetric(
+                event = TrackMetric.Push(
+                    deliveryId = deliveryId,
+                    deviceToken = deviceToken,
+                    metric = event
+                )
+            )
+        } catch (e: Exception) {
+            logger.error("Error tracking push metric: ${e.message}")
+        }
+    }
+
     fun deleteDeviceToken() {
         requireSDKInstance()?.deleteDeviceToken()
     }
diff --git a/android/src/main/java/io/customer/reactnative/sdk/messaginginapp/NativeMessagingInAppModuleImpl.kt b/android/src/main/java/io/customer/reactnative/sdk/messaginginapp/NativeMessagingInAppModuleImpl.kt
@@ -19,7 +19,7 @@ object NativeMessagingInAppModuleImpl {
 
     private val inAppMessagingModule: ModuleMessagingInApp?
         get() = kotlin.runCatching { CustomerIO.instance().inAppMessaging() }.getOrNull()
-    internal val inAppEventListener = ReactInAppEventListener()
+    val inAppEventListener = ReactInAppEventListener()
 
     /**
      * Adds InAppMessaging module to native Android SDK based on configuration provided by customer
diff --git a/android/src/main/res/values/customer_io_config.xml b/android/src/main/res/values/customer_io_config.xml
@@ -9,5 +9,5 @@
     This will be updated by update-version script with React Native package version
     whenever new version of React Native package is released
     -->
-    <string name="customer_io_react_native_sdk_client_version">5.1.0</string>
+    <string name="customer_io_react_native_sdk_client_version">5.2.0</string>
 </resources>
diff --git a/android/src/newarch/io/customer/reactnative/sdk/NativeCustomerIOModule.kt b/android/src/newarch/io/customer/reactnative/sdk/NativeCustomerIOModule.kt
@@ -48,6 +48,10 @@ class NativeCustomerIOModule(
         NativeCustomerIOModuleImpl.registerDeviceToken(token)
     }
 
+    override fun trackMetric(deliveryID: String?, deviceToken: String?, event: String?) {
+        NativeCustomerIOModuleImpl.trackMetric(deliveryID, deviceToken, event)
+    }
+
     override fun deleteDeviceToken() {
         NativeCustomerIOModuleImpl.deleteDeviceToken()
     }
diff --git a/android/src/oldarch/io/customer/reactnative/sdk/NativeCustomerIOModule.kt b/android/src/oldarch/io/customer/reactnative/sdk/NativeCustomerIOModule.kt
@@ -62,6 +62,11 @@ class NativeCustomerIOModule(
         NativeCustomerIOModuleImpl.registerDeviceToken(token)
     }
 
+    @ReactMethod
+    fun trackMetric(deliveryID: String, deviceToken: String, event: String) {
+        NativeCustomerIOModuleImpl.trackMetric(deliveryID, deviceToken, event)
+    }
+
     @ReactMethod
     fun deleteDeviceToken() {
         NativeCustomerIOModuleImpl.deleteDeviceToken()
diff --git a/api-extractor-output/customerio-reactnative.api.md b/api-extractor-output/customerio-reactnative.api.md
@@ -87,6 +87,11 @@ export class CustomerIO {
     static readonly setDeviceAttributes: (attributes: Record<string, any>) => Promise<any>;
     static readonly setProfileAttributes: (attributes: Record<string, any>) => Promise<any>;
     static readonly track: (name: string, properties?: Record<string, any>) => Promise<any>;
+    static readonly trackMetric: ({ deliveryID, deviceToken, event, }: {
+        deliveryID: string;
+        deviceToken: string;
+        event: MetricEvent;
+    }) => Promise<void>;
 }
 
 // Warning: (ae-forgotten-export) The symbol "NativeInAppSpec" needs to be exported by the entry point index.d.ts
@@ -172,6 +177,13 @@ export interface InlineInAppMessageViewProps extends Omit<NativeProps, 'onSizeCh
     onActionClick?: (message: InAppMessage, actionValue: string, actionName: string) => void;
 }
 
+// @public
+export enum MetricEvent {
+    Converted = "converted",
+    Delivered = "delivered",
+    Opened = "opened"
+}
+
 // @public
 export enum PushClickBehaviorAndroid {
     ActivityNoFlags = "ACTIVITY_NO_FLAGS",
diff --git a/example/package-lock.json b/example/package-lock.json
diff --git a/ios/wrappers/NativeCustomerIO.mm b/ios/wrappers/NativeCustomerIO.mm
@@ -85,6 +85,13 @@ - (void)registerDeviceToken:(NSString *)token {
   [_swiftBridge registerDeviceToken:token];
 }
 
+- (void)trackMetric:(NSString *)deliveryID
+        deviceToken:(NSString *)deviceToken
+              event:(NSString *)event {
+  [self assertBridgeAvailable:@"during trackMetric"];
+  [_swiftBridge trackMetric:deliveryID deviceToken:deviceToken event:event];
+}
+
 - (void)deleteDeviceToken {
   [self assertBridgeAvailable:@"during deleteDeviceToken"];
   [_swiftBridge deleteDeviceToken];
@@ -114,6 +121,7 @@ @interface RCT_EXTERN_REMAP_MODULE (NativeCustomerIO, NativeCustomerIO, NSObject
 RCT_EXTERN_METHOD(setProfileAttributes : (NSDictionary *)attributes)
 RCT_EXTERN_METHOD(setDeviceAttributes : (NSDictionary *)attributes)
 RCT_EXTERN_METHOD(registerDeviceToken : (NSString *)token)
+RCT_EXTERN_METHOD(trackMetric : (NSString *)deliveryID deviceToken : (NSString *)deviceToken event : (NSString *)event)
 RCT_EXTERN_METHOD(deleteDeviceToken)
 
 // Module initialization can happen on background thread
diff --git a/ios/wrappers/NativeCustomerIO.swift b/ios/wrappers/NativeCustomerIO.swift
@@ -126,6 +126,17 @@ public class NativeCustomerIO: NSObject {
         CustomerIO.shared.registerDeviceToken(token)
     }
 
+    @objc
+    func trackMetric(_ deliveryId: String, deviceToken: String, event: String) {
+        guard ensureInitialized() else { return }
+        guard let metricEvent = Metric.getEvent(from: event) else {
+            logger.error("Invalid metric event: \(event)")
+            return
+        }
+
+        CustomerIO.shared.trackMetric(deliveryID: deliveryId, event: metricEvent, deviceToken: deviceToken)
+    }
+
     @objc
     func deleteDeviceToken() {
         guard ensureInitialized() else { return }
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "customerio-reactnative",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "Official Customer.io SDK using React Native. Track customers and send messages to your iOS/Android apps.",
   "source": "./src/index.ts",
   "main": "./lib/commonjs/index.js",
diff --git a/src/customerio-cdp.ts b/src/customerio-cdp.ts
@@ -7,6 +7,7 @@ import {
 } from './specs/modules/NativeCustomerIO';
 import {
   CioLogLevel,
+  MetricEvent,
   type CioConfig,
   type CustomAttributes,
   type IdentifyParams,
@@ -150,6 +151,25 @@ export class CustomerIO {
     return withNativeModule((native) => native.deleteDeviceToken());
   };
 
+  /** Track push notification metrics for delivered, opened, or converted events. */
+  static readonly trackMetric = async ({
+    deliveryID,
+    deviceToken,
+    event,
+  }: {
+    deliveryID: string;
+    deviceToken: string;
+    event: MetricEvent;
+  }) => {
+    assert.string(deliveryID, 'deliveryID', { usage: 'Track Metric' });
+    assert.string(deviceToken, 'deviceToken', { usage: 'Track Metric' });
+    assert.string(event, 'event', { usage: 'Track Metric' });
+
+    return withNativeModule((native) =>
+      native.trackMetric(deliveryID, deviceToken, event)
+    );
+  };
+
   /**
    * Check if the CustomerIO SDK has been initialized.
    * @deprecated This method will be removed in a future version. If you need this functionality, please contact us.
diff --git a/src/specs/modules/NativeCustomerIO.ts b/src/specs/modules/NativeCustomerIO.ts
@@ -1,5 +1,4 @@
 import { TurboModuleRegistry, type TurboModule } from 'react-native';
-/* eslint-disable @react-native/no-deep-imports */
 import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
 
 /**
@@ -49,6 +48,7 @@ export interface Spec extends TurboModule {
   setProfileAttributes(attributes: NativeBridgeObject): void;
   setDeviceAttributes(attributes: NativeBridgeObject): void;
   registerDeviceToken(token: string): void;
+  trackMetric(deliveryID: string, deviceToken: string, event: string): void;
   deleteDeviceToken(): void;
 }
 
diff --git a/src/specs/modules/NativeCustomerIOLogging.ts b/src/specs/modules/NativeCustomerIOLogging.ts
@@ -1,5 +1,4 @@
 import { TurboModuleRegistry, type TurboModule } from 'react-native';
-/* eslint-disable @react-native/no-deep-imports */
 import type {
   Double,
   EventEmitter,
diff --git a/src/specs/modules/NativeCustomerIOMessagingInApp.ts b/src/specs/modules/NativeCustomerIOMessagingInApp.ts
@@ -1,5 +1,4 @@
 import { TurboModuleRegistry, type TurboModule } from 'react-native';
-/* eslint-disable @react-native/no-deep-imports */
 import type {
   Double,
   EventEmitter,
diff --git a/src/specs/modules/NativeCustomerIOMessagingPush.ts b/src/specs/modules/NativeCustomerIOMessagingPush.ts
@@ -1,5 +1,4 @@
 import { TurboModuleRegistry, type TurboModule } from 'react-native';
-/* eslint-disable @react-native/no-deep-imports */
 import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
 
 /**
diff --git a/src/types/data-pipelines.ts b/src/types/data-pipelines.ts
@@ -112,3 +112,17 @@ export enum ScreenView {
   /** Only display in-app messages, don't send to destinations */
   InApp = 'inApp',
 }
+
+/**
+ * Enum to specify the type of metric for tracking
+ *
+ * @public
+ */
+export enum MetricEvent {
+  /** Push notification was delivered to the device */
+  Delivered = 'delivered',
+  /** Push notification was opened by the user */
+  Opened = 'opened',
+  /** Push notification resulted in a conversion */
+  Converted = 'converted',
+}

Original file line number	Diff line number	Diff line change
`@@ -48,6 +48,10 @@ class NativeCustomerIOModule(`
`48`	`48`	`NativeCustomerIOModuleImpl.registerDeviceToken(token)`
`49`	`49`	`}`
`50`	`50`
	`51`	`+ override fun trackMetric(deliveryID: String?, deviceToken: String?, event: String?) {`
	`52`	`+ NativeCustomerIOModuleImpl.trackMetric(deliveryID, deviceToken, event)`
	`53`	`+ }`
	`54`	`+`
`51`	`55`	`override fun deleteDeviceToken() {`
`52`	`56`	`NativeCustomerIOModuleImpl.deleteDeviceToken()`
`53`	`57`	`}`