feat: Location enrichment

android/build.gradle

@@ -25,14 +25,22 @@ def getExtOrIntegerDefault(name) {
   return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties['customerio.reactnative.' + name]).toInteger()
 }
 
+ext.cioLocationEnabled = rootProject.findProperty("customerio_location_enabled")?.toBoolean() ?: false
+
 android {
   namespace = 'io.customer.reactnative.sdk'
   compileSdkVersion getExtOrIntegerDefault('compileSdkVersion')
   defaultConfig {
     minSdkVersion getExtOrIntegerDefault('minSdkVersion')
     targetSdkVersion getExtOrIntegerDefault('targetSdkVersion')
+    buildConfigField "boolean", "CIO_LOCATION_ENABLED", "${project.cioLocationEnabled}"
+    consumerProguardFiles 'consumer-rules.pro'
+  }
+
+  buildFeatures {
+    buildConfig true
   }
-  
+
   buildTypes {
     release {
       minifyEnabled false

android/cio-core.gradle

@@ -2,4 +2,11 @@ dependencies {
     api "io.customer.android:datapipelines:$cioAndroidSDKVersion"
     api "io.customer.android:messaging-push-fcm:$cioAndroidSDKVersion"
     api "io.customer.android:messaging-in-app:$cioAndroidSDKVersion"
+    // Location module is optional - customers enable it by adding
+    // customerio_location_enabled=true in their gradle.properties
+    if (project.cioLocationEnabled) {
+        implementation "io.customer.android:location:$cioAndroidSDKVersion"
+    } else {
+        compileOnly "io.customer.android:location:$cioAndroidSDKVersion"
+    }
 }

android/consumer-rules.pro

@@ -0,0 +1,3 @@
+# Location module is an optional compileOnly dependency.
+# When not enabled, R8 must not fail on missing location classes.
+-dontwarn io.customer.location.**

android/gradle.properties

@@ -2,4 +2,4 @@ customerio.reactnative.kotlinVersion=2.1.20
 customerio.reactnative.compileSdkVersion=36
 customerio.reactnative.targetSdkVersion=36
 customerio.reactnative.minSdkVersion=21
-customerio.reactnative.cioSDKVersionAndroid=4.16.0
+customerio.reactnative.cioSDKVersionAndroid=4.17.0

android/src/main/java/io/customer/reactnative/sdk/CustomerIOReactNativePackage.kt

@@ -6,6 +6,7 @@ import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.module.model.ReactModuleInfo
 import com.facebook.react.module.model.ReactModuleInfoProvider
 import com.facebook.react.uimanager.ViewManager
+import io.customer.reactnative.sdk.location.NativeLocationModule
 import io.customer.reactnative.sdk.logging.NativeCustomerIOLoggingModule
 import io.customer.reactnative.sdk.messaginginapp.InlineInAppMessageViewManager
 import io.customer.reactnative.sdk.messaginginapp.NativeMessagingInAppModule
@@ -32,6 +33,9 @@ class CustomerIOReactNativePackage : BaseReactPackage() {
             InlineInAppMessageViewManager.NAME -> InlineInAppMessageViewManager()
             NativeCustomerIOLoggingModule.NAME -> NativeCustomerIOLoggingModule(reactContext)
             NativeCustomerIOModule.NAME -> NativeCustomerIOModule(reactContext = reactContext)
+            NativeLocationModule.NAME -> if (BuildConfig.CIO_LOCATION_ENABLED) {
+                NativeLocationModule(reactContext)
+            } else null
             NativeMessagingInAppModule.NAME -> NativeMessagingInAppModule(reactContext)
             NativeMessagingPushModule.NAME -> NativeMessagingPushModule(reactContext)
             else -> assertNotNull<NativeModule>(value = null) { "Unknown module name: $name" }
@@ -61,10 +65,13 @@ class CustomerIOReactNativePackage : BaseReactPackage() {
     override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
         // List of all Fabric ViewManagers and TurboModules registered in this package.
         // Used by React Native to identify and instantiate the modules.
+        // Location module is always registered so TurboModuleRegistry.getEnforcing()
+        // doesn't crash at import time. getModule() returns null when disabled.
         val moduleNames: List<String> = listOf(
             InlineInAppMessageViewManager.NAME,
             NativeCustomerIOLoggingModule.NAME,
             NativeCustomerIOModule.NAME,
+            NativeLocationModule.NAME,
             NativeMessagingInAppModule.NAME,
             NativeMessagingPushModule.NAME,
         )

android/src/main/java/io/customer/reactnative/sdk/NativeCustomerIOModule.kt

@@ -8,6 +8,7 @@ import io.customer.datapipelines.config.ScreenView
 import io.customer.reactnative.sdk.constant.Keys
 import io.customer.reactnative.sdk.extension.getTypedValue
 import io.customer.reactnative.sdk.extension.toMap
+import io.customer.reactnative.sdk.location.NativeLocationModule
 import io.customer.reactnative.sdk.messaginginapp.NativeMessagingInAppModule
 import io.customer.reactnative.sdk.messagingpush.NativeMessagingPushModule
 import io.customer.reactnative.sdk.util.assertNotNull
@@ -99,6 +100,15 @@ class NativeCustomerIOModule(
                         region = region
                     )
                 }
+                // Configure location module if enabled via gradle property
+                if (BuildConfig.CIO_LOCATION_ENABLED) {
+                    packageConfig.getTypedValue<Map<String, Any>>(key = "location")?.let { locationConfig ->
+                        NativeLocationModule.addNativeModuleFromConfig(
+                            builder = this,
+                            config = locationConfig
+                        )
+                    }
+                }
             }.build()
 
             logger.info("Customer.io instance initialized successfully from app")

android/src/main/java/io/customer/reactnative/sdk/location/NativeLocationModule.kt

@@ -0,0 +1,66 @@
+package io.customer.reactnative.sdk.location
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.annotations.ReactModule
+import io.customer.location.LocationModuleConfig
+import io.customer.location.LocationTrackingMode
+import io.customer.location.ModuleLocation
+import io.customer.reactnative.sdk.NativeCustomerIOLocationSpec
+import io.customer.reactnative.sdk.extension.getTypedValue
+import io.customer.sdk.CustomerIOBuilder
+import io.customer.sdk.core.di.SDKComponent
+import io.customer.sdk.core.util.Logger
+
+/**
+ * React Native module implementation for Customer.io Location Native SDK
+ * using TurboModules with new architecture.
+ */
+@ReactModule(name = NativeLocationModule.NAME)
+class NativeLocationModule(
+    private val reactContext: ReactApplicationContext,
+) : NativeCustomerIOLocationSpec(reactContext) {
+    private val logger: Logger
+        get() = SDKComponent.logger
+
+    private fun getLocationServices() = runCatching {
+        ModuleLocation.instance().locationServices
+    }.onFailure {
+        logger.error("Location module is not initialized. Ensure location config is provided during SDK initialization.")
+    }.getOrNull()
+
+    override fun setLastKnownLocation(latitude: Double, longitude: Double) {
+        getLocationServices()?.setLastKnownLocation(latitude, longitude)
+    }
+
+    override fun requestLocationUpdate() {
+        getLocationServices()?.requestLocationUpdate()
+    }
+
+    companion object {
+        const val NAME = "NativeCustomerIOLocation"
+
+        /**
+         * Adds location module to native Android SDK based on the configuration provided by
+         * customer app.
+         *
+         * @param builder instance of CustomerIOBuilder to add location module.
+         * @param config configuration provided by customer app for location module.
+         */
+        internal fun addNativeModuleFromConfig(
+            builder: CustomerIOBuilder,
+            config: Map<String, Any>
+        ) {
+            val trackingModeValue = config.getTypedValue<String>("trackingMode")
+            val trackingMode = trackingModeValue?.let { value ->
+                runCatching { enumValueOf<LocationTrackingMode>(value) }.getOrNull()
+            } ?: LocationTrackingMode.MANUAL
+
+            val module = ModuleLocation(
+                LocationModuleConfig.Builder()
+                    .setLocationTrackingMode(trackingMode)
+                    .build()
+            )
+            builder.addCustomerIOModule(module)
+        }
+    }
+}

api-extractor-output/customerio-reactnative.api.md

@@ -34,8 +34,18 @@ export type CioConfig = {
             pushClickBehavior?: PushClickBehaviorAndroid;
         };
     };
+    location?: {
+        trackingMode?: CioLocationTrackingMode;
+    };
 };
 
+// @public
+export enum CioLocationTrackingMode {
+    Manual = "MANUAL",
+    Off = "OFF",
+    OnAppStart = "ON_APP_START"
+}
+
 // @public
 export enum CioLogLevel {
     Debug = "debug",
@@ -74,20 +84,22 @@ export type CustomAttributes = Record<string, any>;
 export class CustomerIO {
     static readonly clearIdentify: () => Promise<any>;
     static readonly deleteDeviceToken: () => Promise<void>;
-    static readonly identify: ({ userId, traits, }?: IdentifyParams) => Promise<any>;
+    static readonly identify: (input?: IdentifyParams) => Promise<any>;
     // (undocumented)
     static readonly inAppMessaging: CustomerIOInAppMessaging;
     static readonly initialize: (config: CioConfig) => Promise<void>;
     // @deprecated
     static readonly isInitialized: () => boolean;
     // (undocumented)
+    static readonly location: CustomerIOLocation;
+    // (undocumented)
     static readonly pushMessaging: CustomerIOPushMessaging;
     static readonly registerDeviceToken: (token: string) => Promise<void>;
     static readonly screen: (title: string, properties?: Record<string, any>) => Promise<any>;
     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, }: {
+    static readonly trackMetric: (input: {
         deliveryID: string;
         deviceToken: string;
         event: MetricEvent;
@@ -104,6 +116,14 @@ export class CustomerIOInAppMessaging implements NativeInAppSpec {
     registerEventsListener(listener: (event: InAppMessageEvent) => void): EventSubscription;
 }
 
+// Warning: (ae-forgotten-export) The symbol "NativeLocationSpec" needs to be exported by the entry point index.d.ts
+//
+// @public (undocumented)
+export class CustomerIOLocation implements NativeLocationSpec {
+    requestLocationUpdate(): void;
+    setLastKnownLocation(latitude: number, longitude: number): void;
+}
+
 // Warning: (ae-forgotten-export) The symbol "NativePushSpec" needs to be exported by the entry point index.d.ts
 //
 // @public (undocumented)

customerio-reactnative.podspec

@@ -49,4 +49,12 @@ Pod::Spec.new do |s|
     # Customer.io Firebase Wrapper - provides Firebase integration
     ss.dependency "CioFirebaseWrapper", package["cioiOSFirebaseWrapperSdkVersion"]
   end
+
+  # Location module is optional - customers must opt in by adding this subspec.
+  s.subspec "location" do |ss|
+    ss.dependency "CustomerIO/Location", package["cioNativeiOSSdkVersion"]
+    ss.pod_target_xcconfig = {
+      'OTHER_SWIFT_FLAGS' => '$(inherited) -DCIO_LOCATION_ENABLED'
+    }
+  end
 end