feat: Location enrichment

android/build.gradle

@@ -25,14 +25,21 @@ def getExtOrIntegerDefault(name) {
   return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties['customerio.reactnative.' + name]).toInteger()
 }
 
+ext.cioLocationEnabled = rootProject.hasProperty("customerio_location_enabled")
+
 android {
   namespace = 'io.customer.reactnative.sdk'
   compileSdkVersion getExtOrIntegerDefault('compileSdkVersion')
   defaultConfig {
     minSdkVersion getExtOrIntegerDefault('minSdkVersion')
     targetSdkVersion getExtOrIntegerDefault('targetSdkVersion')
+    buildConfigField "boolean", "CIO_LOCATION_ENABLED", "${project.cioLocationEnabled}"
+  }
+
+  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/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,13 +65,16 @@ 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.
-        val moduleNames: List<String> = listOf(
-            InlineInAppMessageViewManager.NAME,
-            NativeCustomerIOLoggingModule.NAME,
-            NativeCustomerIOModule.NAME,
-            NativeMessagingInAppModule.NAME,
-            NativeMessagingPushModule.NAME,
-        )
+        val moduleNames: List<String> = buildList {
+            add(InlineInAppMessageViewManager.NAME)
+            add(NativeCustomerIOLoggingModule.NAME)
+            add(NativeCustomerIOModule.NAME)
+            if (BuildConfig.CIO_LOCATION_ENABLED) {
+                add(NativeLocationModule.NAME)
+            }
+            add(NativeMessagingInAppModule.NAME)
+            add(NativeMessagingPushModule.NAME)
+        }
         return ReactModuleInfoProvider {
             // Register all ViewManagers and TurboModules
             moduleNames.associateWith { moduleName ->

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)
+        }
+    }
+}

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

ios/wrappers/NativeCustomerIO.swift

@@ -2,6 +2,9 @@ import CioAnalytics
 import CioDataPipelines
 import CioInternalCommon
 import CioMessagingInApp
+#if CIO_LOCATION_ENABLED
+import CioLocation
+#endif
 
 @objc(NativeCustomerIO)
 public class NativeCustomerIO: NSObject {
@@ -47,6 +50,24 @@ public class NativeCustomerIO: NSObject {
             }
 
             let sdkConfigBuilder = try SDKConfigBuilder.create(from: config)
+
+            #if CIO_LOCATION_ENABLED
+            // Add location module to config builder if location config is provided
+            if let locationConfig = config["location"] as? [String: Any] {
+                let trackingModeValue = locationConfig["trackingMode"] as? String
+                let mode: LocationTrackingMode
+                switch trackingModeValue?.uppercased() {
+                case "OFF":
+                    mode = .off
+                case "ON_APP_START":
+                    mode = .onAppStart
+                default:
+                    mode = .manual
+                }
+                _ = sdkConfigBuilder.addModule(LocationModule(config: LocationConfig(mode: mode)))
+            }
+            #endif
+
             CustomerIO.initialize(withConfig: sdkConfigBuilder.build())
 
             do {
@@ -58,6 +79,7 @@ public class NativeCustomerIO: NSObject {
             } catch {
                 logger.error("[InApp] Failed to initialize module with error: \(error)")
             }
+
             logger.debug(
                 "Customer.io SDK (\(packageSource ?? "") \(packageVersion ?? "")) initialized with config: \(config)"
             )

ios/wrappers/location/NativeLocation.mm

@@ -0,0 +1,52 @@
+#import <React/RCTBridgeModule.h>
+#import <RNCustomerIOSpec/RNCustomerIOSpec.h>
+
+// Objective-C wrapper for new architecture TurboModule implementation
+@interface RCTNativeCustomerIOLocation : NSObject <NativeCustomerIOLocationSpec>
+// Bridge to Swift implementation for cross-language compatibility
+@property(nonatomic, strong) id<NativeCustomerIOLocationSpec> swiftBridge;
+@end
+
+@implementation RCTNativeCustomerIOLocation
+
+RCT_EXPORT_MODULE()
+
+// Create TurboModule instance for new architecture JSI integration
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params {
+  return std::make_shared<facebook::react::NativeCustomerIOLocationSpecJSI>(params);
+}
+
+- (instancetype)init {
+  if (self = [super init]) {
+    // Use runtime class lookup - NativeLocation class only exists when CioLocation subspec is installed
+    Class swiftClass = NSClassFromString(@"NativeCustomerIOLocation");
+    if (swiftClass) {
+      _swiftBridge = [[swiftClass alloc] init];
+    }
+  }
+  return self;
+}
+
+// Module initialization can happen on background thread
++ (BOOL)requiresMainQueueSetup {
+  return NO;
+}
+
+- (void)setLastKnownLocation:(double)latitude
+                    longitude:(double)longitude {
+  if (!_swiftBridge) return;
+  [_swiftBridge setLastKnownLocation:latitude longitude:longitude];
+}
+
+- (void)requestLocationUpdate {
+  if (!_swiftBridge) return;
+  [_swiftBridge requestLocationUpdate];
+}
+
+// Export class factory function for React Native component registration
+Class<RCTBridgeModule> NativeCustomerIOLocationCls(void) {
+  return RCTNativeCustomerIOLocation.class;
+}
+
+@end

ios/wrappers/location/NativeLocation.swift

@@ -0,0 +1,19 @@
+#if CIO_LOCATION_ENABLED
+import CioLocation
+import CoreLocation
+
+@objc(NativeCustomerIOLocation)
+public class NativeLocation: NSObject {
+
+    @objc
+    func setLastKnownLocation(_ latitude: Double, longitude: Double) {
+        let location = CLLocation(latitude: latitude, longitude: longitude)
+        CustomerIO.location.setLastKnownLocation(location)
+    }
+
+    @objc
+    func requestLocationUpdate() {
+        CustomerIO.location.requestLocationUpdate()
+    }
+}
+#endif

src/components/InlineInAppMessageView.tsx

@@ -20,10 +20,11 @@ import type { InAppMessage } from '../types';
  * Props for the InlineInAppMessageView component.
  */
 /** @public */
-export interface InlineInAppMessageViewProps extends Omit<
-  NativeProps,
-  'onSizeChange' | 'onStateChange' | 'onActionClick'
-> {
+export interface InlineInAppMessageViewProps
+  extends Omit<
+    NativeProps,
+    'onSizeChange' | 'onStateChange' | 'onActionClick'
+  > {
   /** Custom loading component to display while message is loading */
   loadingComponent?: React.ReactNode;
   /** Props for the default ActivityIndicator with optional minimum height */

src/customerio-cdp.ts

@@ -1,4 +1,5 @@
 import { CustomerIOInAppMessaging } from './customerio-inapp';
+import { CustomerIOLocation } from './customerio-location';
 import { CustomerIOPushMessaging } from './customerio-push';
 import { NativeLoggerListener } from './native-logger-listener';
 import {
@@ -177,6 +178,7 @@ export class CustomerIO {
   static readonly isInitialized = () => _initialized;
 
   static readonly inAppMessaging = new CustomerIOInAppMessaging();
+  static readonly location = new CustomerIOLocation();
   static readonly pushMessaging = new CustomerIOPushMessaging();
 }
 

src/customerio-inapp.ts

@@ -16,10 +16,11 @@ import { callNativeModule, ensureNativeModule } from './utils/native-bridge';
  *
  * @internal
  */
-interface NativeInAppSpec extends Omit<
-  CodegenSpec,
-  keyof TurboModule | NotificationInboxSpec | 'onInAppEventReceived'
-> {}
+interface NativeInAppSpec
+  extends Omit<
+    CodegenSpec,
+    keyof TurboModule | NotificationInboxSpec | 'onInAppEventReceived'
+  > {}
 
 // Reference to the native CustomerIO Data Pipelines module for SDK operations
 const nativeModule = ensureNativeModule(NativeCustomerIOMessagingInApp);

src/customerio-location.ts

@@ -0,0 +1,47 @@
+import { type TurboModule } from 'react-native';
+import {
+  default as NativeModule,
+  type Spec as CodegenSpec,
+} from './specs/modules/NativeCustomerIOLocation';
+import { callNativeModule, ensureNativeModule } from './utils/native-bridge';
+
+/**
+ * Ensures all methods defined in codegen spec are implemented by the public module
+ *
+ * @internal
+ */
+interface NativeLocationSpec extends Omit<CodegenSpec, keyof TurboModule> {}
+
+const nativeModule = ensureNativeModule(NativeModule);
+
+const withNativeModule = <R>(fn: (native: CodegenSpec) => R): R => {
+  return callNativeModule(nativeModule, fn);
+};
+
+/** @public */
+export class CustomerIOLocation implements NativeLocationSpec {
+  /**
+   * Sets the last known location from the host app's existing location system.
+   * Use this when your app already manages location and you want to send that data
+   * to Customer.io without the SDK managing location permissions directly.
+   *
+   * @param latitude - Latitude in degrees, must be between -90 and 90
+   * @param longitude - Longitude in degrees, must be between -180 and 180
+   */
+  setLastKnownLocation(latitude: number, longitude: number): void {
+    return withNativeModule((native) =>
+      native.setLastKnownLocation(latitude, longitude)
+    );
+  }
+
+  /**
+   * Requests a single location update and sends the result to Customer.io.
+   * No-ops if location tracking is disabled or permission is not granted.
+   *
+   * The SDK does not request location permission. The host app must request
+   * runtime permissions and only call this when permission is granted.
+   */
+  requestLocationUpdate(): void {
+    return withNativeModule((native) => native.requestLocationUpdate());
+  }
+}

src/index.ts

@@ -3,5 +3,6 @@
  */
 export * from './customerio-cdp';
 export * from './customerio-inapp';
+export * from './customerio-location';
 export * from './customerio-push';
 export * from './types';