react-native-mparticle 3.0.0 → 3.1.1

package/README.md

@@ -82,6 +82,7 @@ npx expo run:android
 | `dataPlanId`              | string   | No       | Data plan ID for validation                                         |
 | `dataPlanVersion`         | number   | No       | Data plan version                                                   |
 | `iosKits`                 | string[] | No       | iOS kit pod names (e.g., `['mParticle-Rokt']`)                      |
+| `customBaseUrl`           | string   | No       | Custom base URL for global CNAME setup on iOS and Android           |
 | `androidKits`             | string[] | No       | Android kit artifact names (e.g., `['android-rokt-kit']`)           |
 | `useEmptyIdentifyRequest` | boolean  | No       | Use empty user identify request at init (default: `true`)           |
 
@@ -109,17 +110,27 @@ npx expo run:android
 }
 ```
 
+For global CNAME setup, add the optional shared `customBaseUrl` setting:
+
+```json
+{
+  "customBaseUrl": "https://cname.example.com"
+}
+```
+
 ### What the Plugin Does
 
 **iOS:**
 
 - Adds mParticle SDK initialization to `AppDelegate` (supports both Swift and Objective-C)
+- Sets `MPNetworkOptions.customBaseURL` before startup when `customBaseUrl` is configured
 - Configures `pre_install` hook in Podfile for dynamic framework linking
 - Adds specified kit pod dependencies
 
 **Android:**
 
 - Adds mParticle SDK initialization to `MainApplication` (supports both Kotlin and Java)
+- Sets `NetworkOptions.setCustomBaseURL` before startup when `customBaseUrl` is configured
 - Adds specified kit Maven dependencies to `build.gradle`
 
 ### Version Support
@@ -219,6 +230,12 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
         mParticleOptions.onAttributionComplete = { (attributionResult, error) in
                     NSLog(@"Attribution Complete. attributionResults = %@", attributionResult.linkInfo)
         }
+
+        // Optional global CNAME setup. Configure before start.
+        let networkOptions = MPNetworkOptions()
+        networkOptions.customBaseURL = URL(string: "https://cname.example.com")
+        mParticleOptions.networkOptions = networkOptions
+
         MParticle.sharedInstance().start(with: mParticleOptions)
         return true
 }
@@ -260,12 +277,34 @@ Next, you'll need to start the SDK:
         NSLog(@"Attribution Complete. attributionResults = %@", attributionResult.linkInfo)
     }
 
+    // Optional global CNAME setup. Configure before start.
+    MPNetworkOptions *networkOptions = [[MPNetworkOptions alloc] init];
+    networkOptions.customBaseURL = [NSURL URLWithString:@"https://cname.example.com"];
+    mParticleOptions.networkOptions = networkOptions;
+
     [[MParticle sharedInstance] startWithOptions:mParticleOptions];
 
     return YES;
 }
 ```
 
+### Rokt iOS Setup
+
+For standard Rokt placements, add the mParticle Rokt kit:
+
+```ruby
+pod 'mParticle-Rokt', '~> 9.2'
+```
+
+In Expo apps, use `iosKits: ["mParticle-Rokt"]` for standard Rokt placements. The Expo plugin does not add payment-extension pods or URL callback forwarding in this release.
+
+See [MIGRATING.md](./MIGRATING.md) for release-specific migration guidance.
+
+For Android integrations that use `MParticle.Rokt.setSessionId()` or
+`MParticle.Rokt.getSessionId()`, `android-core` and `android-rokt-kit`
+`5.79.0` or newer are required. Android CNAME setup through
+`customBaseUrl` also requires `android-core` `5.79.0` or newer.
+
 See [Identity](http://docs.mparticle.com/developers/sdk/ios/identity/) for more information on supplying an `MPIdentityApiRequest` object during SDK initialization.
 
 4. Remember to start Metro with:
@@ -285,13 +324,15 @@ and build your workspace from xCode.
 For more help, see [the Android set up docs](https://docs.mparticle.com/developers/sdk/android/getting-started/#create-an-input).
 
 ```kotlin
-package com.example.myapp;
+package com.example.myapp
 
-import android.app.Application;
-import com.mparticle.MParticle;
+import android.app.Application
+import com.mparticle.MParticle
+import com.mparticle.MParticleOptions
+import com.mparticle.networking.NetworkOptions
 
 class MyApplication : Application() {
-    fun onCreate() {
+    override fun onCreate() {
         super.onCreate()
         val options: MParticleOptions = MParticleOptions.builder(this)
             .credentials("REPLACE ME WITH KEY", "REPLACE ME WITH SECRET")
@@ -299,6 +340,12 @@ class MyApplication : Application() {
             .logLevel(MParticle.LogLevel.VERBOSE)
             //optional
             .identify(identifyRequest)
+            //optional global CNAME setup
+            .networkOptions(
+                NetworkOptions.builder()
+                    .setCustomBaseURL("https://cname.example.com")
+                    .build()
+            )
             //optional
             .identifyTask(
                 BaseIdentityTask()

package/android/build.gradle

@@ -118,7 +118,9 @@ dependencies {
     //
     // (See https://github.com/mparticle/mparticle-android-sdk for the latest version)
     //
-    api 'com.mparticle:android-core:[5.9.3, )'
+    // Bounded upper bound prevents resolving to 6.0.0-rc.1+ on Maven Central.
+    // 6.x removed deprecated symbols (e.g. UserAttributeListener); see #710.
+    api 'com.mparticle:android-core:[5.79.0, 6.0)'
 
     //
     // And, if you want to include kits, you can do so as follows:
@@ -134,6 +136,6 @@ dependencies {
     testImplementation 'junit:junit:4.13.2'
     testImplementation files('libs/java-json.jar')
 
-    testImplementation 'com.mparticle:android-core:5+'
+    testImplementation 'com.mparticle:android-core:5.79.0'
     testImplementation("com.facebook.react:react-android:+")
 }

package/android/gradle.properties

@@ -10,7 +10,7 @@
 # Specifies the JVM arguments used for the daemon process.
 # The setting is particularly useful for tweaking memory settings.
 # Default value: -Xmx512m -XX:MaxMetaspaceSize=256m
-org.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=512m
+org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m
 
 # When configured, Gradle will run in incubating parallel mode.
 # This option should only be used with decoupled projects. More details, visit

package/android/src/main/java/com/mparticle/react/rokt/MPRoktModuleImpl.kt

@@ -6,6 +6,7 @@ import androidx.lifecycle.LifecycleOwner
 import androidx.lifecycle.lifecycleScope
 import androidx.lifecycle.repeatOnLifecycle
 import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContext
 import com.facebook.react.bridge.ReadableMap
@@ -56,6 +57,23 @@ class MPRoktModuleImpl(
         MParticle.getInstance()?.Rokt()?.purchaseFinalized(placementId, catalogItemId, success)
     }
 
+    fun close(promise: Promise) {
+        MParticle.getInstance()?.Rokt()?.close()
+        promise.resolve(null)
+    }
+
+    fun setSessionId(
+        sessionId: String,
+        promise: Promise,
+    ) {
+        MParticle.getInstance()?.Rokt()?.setSessionId(sessionId)
+        promise.resolve(null)
+    }
+
+    fun getSessionId(promise: Promise) {
+        promise.resolve(MParticle.getInstance()?.Rokt()?.getSessionId())
+    }
+
     fun setRoktEventHandler(roktEventHandler: MpRoktEventCallback) {
         this.roktEventHandler = roktEventHandler
     }

package/android/src/newarch/java/com/mparticle/react/rokt/MPRoktModule.kt

@@ -1,5 +1,6 @@
 package com.mparticle.react.rokt
 
+import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.ReadableMap
@@ -68,6 +69,24 @@ class MPRoktModule(
         impl.purchaseFinalized(placementId, catalogItemId, success)
     }
 
+    @ReactMethod
+    override fun close(promise: Promise) {
+        impl.close(promise)
+    }
+
+    @ReactMethod
+    override fun setSessionId(
+        sessionId: String,
+        promise: Promise,
+    ) {
+        impl.setSessionId(sessionId, promise)
+    }
+
+    @ReactMethod
+    override fun getSessionId(promise: Promise) {
+        impl.getSessionId(promise)
+    }
+
     /**
      * Process placeholders from ReadableMap to a map of Widgets for use with Rokt.
      * This method handles the Fabric-specific view resolution.

package/android/src/oldarch/java/com/mparticle/react/NativeMPRoktSpec.kt

@@ -1,5 +1,6 @@
 package com.mparticle.react
 
+import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReadableMap
@@ -32,4 +33,13 @@ abstract class NativeMPRoktSpec(
         catalogItemId: String,
         success: Boolean,
     )
+
+    abstract fun close(promise: Promise)
+
+    abstract fun setSessionId(
+        sessionId: String,
+        promise: Promise,
+    )
+
+    abstract fun getSessionId(promise: Promise)
 }

package/android/src/oldarch/java/com/mparticle/react/rokt/MPRoktModule.kt

@@ -1,5 +1,6 @@
 package com.mparticle.react.rokt
 
+import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.ReadableMap
@@ -66,6 +67,24 @@ class MPRoktModule(
         impl.purchaseFinalized(placementId, catalogItemId, success)
     }
 
+    @ReactMethod
+    override fun close(promise: Promise) {
+        impl.close(promise)
+    }
+
+    @ReactMethod
+    override fun setSessionId(
+        sessionId: String,
+        promise: Promise,
+    ) {
+        impl.setSessionId(sessionId, promise)
+    }
+
+    @ReactMethod
+    override fun getSessionId(promise: Promise) {
+        impl.getSessionId(promise)
+    }
+
     private fun safeUnwrapPlaceholders(
         placeholders: ReadableMap?,
         nativeViewHierarchyManager: NativeViewHierarchyManager,

package/ios/RNMParticle/RNMPRokt.mm

@@ -16,6 +16,7 @@
     #import <RoktContracts/RoktContracts.h>
 #endif
 #import <React/RCTConvert.h>
+#import <React/RCTBridgeModule.h>
 #import <React/RCTEventEmitter.h>
 #import <React/RCTViewManager.h>
 #import <React/RCTUIManager.h>
@@ -209,6 +210,63 @@ RCT_EXPORT_METHOD(selectShoppableAds:(NSString *)identifier attributes:(NSDictio
     }];
 }
 
+#ifdef RCT_NEW_ARCH_ENABLED
+- (void)close:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject
+{
+    (void)reject;
+    [self closeWithResolve:resolve];
+}
+
+- (void)setSessionId:(NSString *)sessionId resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject
+{
+    (void)reject;
+    [self setSessionIdWithString:sessionId resolve:resolve];
+}
+
+- (void)getSessionId:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject
+{
+    (void)reject;
+    [self getSessionIdWithResolve:resolve];
+}
+#else
+RCT_EXPORT_METHOD(close:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+{
+    (void)reject;
+    [self closeWithResolve:resolve];
+}
+
+RCT_EXPORT_METHOD(setSessionId:(NSString *)sessionId resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+{
+    (void)reject;
+    [self setSessionIdWithString:sessionId resolve:resolve];
+}
+
+RCT_EXPORT_METHOD(getSessionId:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+{
+    (void)reject;
+    [self getSessionIdWithResolve:resolve];
+}
+#endif
+
+- (void)closeWithResolve:(RCTPromiseResolveBlock)resolve
+{
+    [[[MParticle sharedInstance] rokt] close];
+    resolve(nil);
+}
+
+- (void)setSessionIdWithString:(NSString *)sessionId
+                       resolve:(RCTPromiseResolveBlock)resolve
+{
+    [[[MParticle sharedInstance] rokt] setSessionId:sessionId ?: @""];
+    resolve(nil);
+}
+
+- (void)getSessionIdWithResolve:(RCTPromiseResolveBlock)resolve
+{
+    NSString *sessionId = [[[MParticle sharedInstance] rokt] getSessionId];
+    resolve(sessionId ?: [NSNull null]);
+}
+
 RCT_EXPORT_METHOD(purchaseFinalized : (NSString *)placementId catalogItemId : (
     NSString *)catalogItemId success : (BOOL)success) {
     [[[MParticle sharedInstance] rokt] purchaseFinalized:placementId

package/js/codegenSpecs/NativeMParticle.ts

@@ -150,10 +150,7 @@ export interface Spec extends TurboModule {
   setUserAttributeArray(mpid: string, key: string, value: Array<string>): void;
   getUserAttributes(
     mpid: string,
-    callback: (
-      error: CallbackError | null,
-      result: UserAttributes
-    ) => void
+    callback: (error: CallbackError | null, result: UserAttributes) => void
   ): void;
   setUserTag(mpid: string, tag: string): void;
   incrementUserAttribute(mpid: string, key: string, value: number): void;

package/js/codegenSpecs/rokt/NativeMPRokt.ts

@@ -33,6 +33,12 @@ export interface Spec extends TurboModule {
     attributes: { [key: string]: string },
     roktConfig?: RoktConfigType
   ): void;
+
+  close(): Promise<void>;
+
+  setSessionId(sessionId: string): Promise<void>;
+
+  getSessionId(): Promise<string | null>;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('RNMPRokt');

package/js/rokt/rokt.ts

@@ -47,6 +47,18 @@ export abstract class Rokt {
     MPRokt.purchaseFinalized(placementId, catalogItemId, success);
   }
 
+  static close(): Promise<void> {
+    return MPRokt.close();
+  }
+
+  static setSessionId(sessionId: string): Promise<void> {
+    return MPRokt.setSessionId(sessionId);
+  }
+
+  static getSessionId(): Promise<string | null> {
+    return MPRokt.getSessionId();
+  }
+
   static createRoktConfig(colorMode?: ColorMode, cacheConfig?: CacheConfig) {
     return new RoktConfig(colorMode ?? 'system', cacheConfig);
   }

package/lib/codegenSpecs/NativeMParticle.js.map

@@ -1 +1 @@
-{"version":3,"file":"NativeMParticle.js","sourceRoot":"","sources":["../../js/codegenSpecs/NativeMParticle.ts"],"names":[],"mappings":";;AACA,+CAAmD;AAmNnD,kBAAe,kCAAmB,CAAC,YAAY,CAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"NativeMParticle.js","sourceRoot":"","sources":["../../js/codegenSpecs/NativeMParticle.ts"],"names":[],"mappings":";;AACA,+CAAmD;AAgNnD,kBAAe,kCAAmB,CAAC,YAAY,CAAO,aAAa,CAAC,CAAC"}

package/lib/codegenSpecs/rokt/NativeMPRokt.d.ts

@@ -22,6 +22,9 @@ export interface Spec extends TurboModule {
     selectShoppableAds(identifier: string, attributes: {
         [key: string]: string;
     }, roktConfig?: RoktConfigType): void;
+    close(): Promise<void>;
+    setSessionId(sessionId: string): Promise<void>;
+    getSessionId(): Promise<string | null>;
 }
 declare const _default: Spec;
 export default _default;

package/lib/codegenSpecs/rokt/NativeMPRokt.js.map

@@ -1 +1 @@
-{"version":3,"file":"NativeMPRokt.js","sourceRoot":"","sources":["../../../js/codegenSpecs/rokt/NativeMPRokt.ts"],"names":[],"mappings":";;AACA,+CAAmD;AAoCnD,kBAAe,kCAAmB,CAAC,YAAY,CAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"NativeMPRokt.js","sourceRoot":"","sources":["../../../js/codegenSpecs/rokt/NativeMPRokt.ts"],"names":[],"mappings":";;AACA,+CAAmD;AA0CnD,kBAAe,kCAAmB,CAAC,YAAY,CAAO,UAAU,CAAC,CAAC"}

package/lib/rokt/rokt.d.ts

@@ -12,6 +12,9 @@ export declare abstract class Rokt {
     static selectPlacements(identifier: string, attributes: Record<string, string>, placeholders?: Record<string, number | null>, roktConfig?: IRoktConfig, fontFilesMap?: Record<string, string>): Promise<void>;
     static selectShoppableAds(identifier: string, attributes: Record<string, string>, roktConfig?: IRoktConfig): Promise<void>;
     static purchaseFinalized(placementId: string, catalogItemId: string, success: boolean): Promise<void>;
+    static close(): Promise<void>;
+    static setSessionId(sessionId: string): Promise<void>;
+    static getSessionId(): Promise<string | null>;
     static createRoktConfig(colorMode?: ColorMode, cacheConfig?: CacheConfig): RoktConfig;
     static createCacheConfig(cacheDurationInSeconds: number, cacheAttributes: Record<string, string>): CacheConfig;
 }

package/lib/rokt/rokt.js

@@ -24,6 +24,15 @@ class Rokt {
     static async purchaseFinalized(placementId, catalogItemId, success) {
         MPRokt.purchaseFinalized(placementId, catalogItemId, success);
     }
+    static close() {
+        return MPRokt.close();
+    }
+    static setSessionId(sessionId) {
+        return MPRokt.setSessionId(sessionId);
+    }
+    static getSessionId() {
+        return MPRokt.getSessionId();
+    }
     static createRoktConfig(colorMode, cacheConfig) {
         return new RoktConfig(colorMode !== null && colorMode !== void 0 ? colorMode : 'system', cacheConfig);
     }

package/lib/rokt/rokt.js.map

@@ -1 +1 @@
-{"version":3,"file":"rokt.js","sourceRoot":"","sources":["../../js/rokt/rokt.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAC7C,wDAAwD;AAGxD,MAAM,MAAM,GAAG,IAAA,8BAAe,EAAwB,UAAU,CAAC,CAAC;AAElE,MAAsB,IAAI;IACxB;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAC3B,UAAkB,EAClB,UAAkC,EAClC,YAA4C,EAC5C,UAAwB,EACxB,YAAqC;QAErC,MAAM,CAAC,gBAAgB,CACrB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,CACb,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAC7B,UAAkB,EAClB,UAAkC,EAClC,UAAwB;QAExB,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAC5B,WAAmB,EACnB,aAAqB,EACrB,OAAgB;QAEhB,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,SAAqB,EAAE,WAAyB;QACtE,OAAO,IAAI,UAAU,CAAC,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,iBAAiB,CACtB,sBAA8B,EAC9B,eAAuC;QAEvC,OAAO,IAAI,WAAW,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;IAClE,CAAC;CACF;AArDD,oBAqDC;AAQD;;GAEG;AACH,MAAa,WAAW;IACtB;;;OAGG;IACH,YACkB,sBAA+B,EAC/B,eAAwC;QADxC,2BAAsB,GAAtB,sBAAsB,CAAS;QAC/B,oBAAe,GAAf,eAAe,CAAyB;IACvD,CAAC;CACL;AATD,kCASC;AAED,MAAM,UAAU;IAId,YAAY,SAAoB,EAAE,WAAyB;QACzD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AACD,MAAM,EAAE,gBAAgB,EAAE,GAAG,4BAAa,CAAC;AAElC,4CAAgB"}
+{"version":3,"file":"rokt.js","sourceRoot":"","sources":["../../js/rokt/rokt.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAC7C,wDAAwD;AAGxD,MAAM,MAAM,GAAG,IAAA,8BAAe,EAAwB,UAAU,CAAC,CAAC;AAElE,MAAsB,IAAI;IACxB;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAC3B,UAAkB,EAClB,UAAkC,EAClC,YAA4C,EAC5C,UAAwB,EACxB,YAAqC;QAErC,MAAM,CAAC,gBAAgB,CACrB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,CACb,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAC7B,UAAkB,EAClB,UAAkC,EAClC,UAAwB;QAExB,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAC5B,WAAmB,EACnB,aAAqB,EACrB,OAAgB;QAEhB,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,KAAK;QACV,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,SAAiB;QACnC,OAAO,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,MAAM,CAAC,YAAY,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,SAAqB,EAAE,WAAyB;QACtE,OAAO,IAAI,UAAU,CAAC,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,iBAAiB,CACtB,sBAA8B,EAC9B,eAAuC;QAEvC,OAAO,IAAI,WAAW,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;IAClE,CAAC;CACF;AAjED,oBAiEC;AAQD;;GAEG;AACH,MAAa,WAAW;IACtB;;;OAGG;IACH,YACkB,sBAA+B,EAC/B,eAAwC;QADxC,2BAAsB,GAAtB,sBAAsB,CAAS;QAC/B,oBAAe,GAAf,eAAe,CAAyB;IACvD,CAAC;CACL;AATD,kCASC;AAED,MAAM,UAAU;IAId,YAAY,SAAoB,EAAE,WAAyB;QACzD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AACD,MAAM,EAAE,gBAAgB,EAAE,GAAG,4BAAa,CAAC;AAElC,4CAAgB"}

package/package.json

@@ -4,7 +4,7 @@
   "homepage": "https://www.mparticle.com",
   "license": "Apache-2.0",
   "repository": "mParticle/react-native-mparticle",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "react-native": "js/index",

package/plugin/build/customBaseUrl.d.ts

@@ -0,0 +1,4 @@
+export interface CustomBaseUrlProps {
+    customBaseUrl?: string;
+}
+export declare function getCustomBaseUrl(props: CustomBaseUrlProps): string | null;

package/plugin/build/customBaseUrl.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCustomBaseUrl = void 0;
+function getCustomBaseUrl(props) {
+    const customBaseUrl = props.customBaseUrl?.trim();
+    if (!customBaseUrl) {
+        return null;
+    }
+    let parsedCustomBaseUrl;
+    try {
+        parsedCustomBaseUrl = new URL(customBaseUrl);
+    }
+    catch {
+        throw new Error('react-native-mparticle customBaseUrl must be a valid https URL');
+    }
+    if (parsedCustomBaseUrl.protocol !== 'https:' ||
+        !parsedCustomBaseUrl.hostname) {
+        throw new Error('react-native-mparticle customBaseUrl must be a valid https URL');
+    }
+    return customBaseUrl;
+}
+exports.getCustomBaseUrl = getCustomBaseUrl;

package/plugin/build/withMParticle.d.ts

@@ -42,6 +42,12 @@ export interface MParticlePluginProps {
      * @example ['mParticle-Rokt', 'mParticle-Amplitude']
      */
     iosKits?: string[];
+    /**
+     * Custom base URL for global CNAME setup.
+     * This is applied before mParticle starts on iOS and Android.
+     * @example 'https://your-cname.example.com'
+     */
+    customBaseUrl?: string;
     /**
      * Android kit artifact names to include (version auto-detected from core SDK)
      * @example ['android-rokt-kit', 'android-amplitude-kit']

package/plugin/build/withMParticleAndroid.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.withMParticleAndroid = void 0;
 const config_plugins_1 = require("@expo/config-plugins");
 const generateCode_1 = require("@expo/config-plugins/build/utils/generateCode");
+const customBaseUrl_1 = require("./customBaseUrl");
 // Tag used for mergeContents to identify code blocks added by this plugin
 const MPARTICLE_TAG = 'react-native-mparticle';
 /**
@@ -44,6 +45,7 @@ function getAndroidEnvironment(environment) {
  */
 function generateKotlinInitCode(props) {
     const { androidApiKey, androidApiSecret, logLevel, environment, useEmptyIdentifyRequest = true, dataPlanId, dataPlanVersion, } = props;
+    const customBaseUrl = (0, customBaseUrl_1.getCustomBaseUrl)(props);
     const lines = [
         '// mParticle SDK initialization',
         'val mParticleOptions = MParticleOptions.builder(this)',
@@ -61,6 +63,13 @@ function generateKotlinInitCode(props) {
         const versionParam = dataPlanVersion ? `, ${dataPlanVersion}` : '';
         lines.push(`    .dataplan("${dataPlanId}"${versionParam})`);
     }
+    if (customBaseUrl) {
+        lines.push('    .networkOptions(');
+        lines.push('        NetworkOptions.builder()');
+        lines.push(`            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`);
+        lines.push('            .build()');
+        lines.push('    )');
+    }
     if (useEmptyIdentifyRequest) {
         lines.push('    .identify(IdentityApiRequest.withEmptyUser().build())');
     }
@@ -73,6 +82,7 @@ function generateKotlinInitCode(props) {
  */
 function generateJavaInitCode(props) {
     const { androidApiKey, androidApiSecret, logLevel, environment, useEmptyIdentifyRequest = true, dataPlanId, dataPlanVersion, } = props;
+    const customBaseUrl = (0, customBaseUrl_1.getCustomBaseUrl)(props);
     const lines = [
         '// mParticle SDK initialization',
         'MParticleOptions.Builder optionsBuilder = MParticleOptions.builder(this)',
@@ -90,6 +100,13 @@ function generateJavaInitCode(props) {
         const versionParam = dataPlanVersion ? `, ${dataPlanVersion}` : '';
         lines.push(`    .dataplan("${dataPlanId}"${versionParam})`);
     }
+    if (customBaseUrl) {
+        lines.push('    .networkOptions(');
+        lines.push('        NetworkOptions.builder()');
+        lines.push(`            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`);
+        lines.push('            .build()');
+        lines.push('    )');
+    }
     if (useEmptyIdentifyRequest) {
         lines.push('    .identify(IdentityApiRequest.withEmptyUser().build())');
     }
@@ -101,18 +118,30 @@ function generateJavaInitCode(props) {
 /**
  * Generate mParticle import statements for Kotlin
  */
-function getKotlinImports() {
-    return `import com.mparticle.MParticle
-import com.mparticle.MParticleOptions
-import com.mparticle.identity.IdentityApiRequest`;
+function getKotlinImports(props) {
+    const imports = [
+        'import com.mparticle.MParticle',
+        'import com.mparticle.MParticleOptions',
+        'import com.mparticle.identity.IdentityApiRequest',
+    ];
+    if ((0, customBaseUrl_1.getCustomBaseUrl)(props)) {
+        imports.push('import com.mparticle.networking.NetworkOptions');
+    }
+    return imports.join('\n');
 }
 /**
  * Generate mParticle import statements for Java
  */
-function getJavaImports() {
-    return `import com.mparticle.MParticle;
-import com.mparticle.MParticleOptions;
-import com.mparticle.identity.IdentityApiRequest;`;
+function getJavaImports(props) {
+    const imports = [
+        'import com.mparticle.MParticle;',
+        'import com.mparticle.MParticleOptions;',
+        'import com.mparticle.identity.IdentityApiRequest;',
+    ];
+    if ((0, customBaseUrl_1.getCustomBaseUrl)(props)) {
+        imports.push('import com.mparticle.networking.NetworkOptions;');
+    }
+    return imports.join('\n');
 }
 /**
  * Add mParticle configuration to MainApplication
@@ -147,7 +176,7 @@ function addMParticleToKotlinMainApplication(contents, props) {
     // Add import statements using mergeContents
     const withImports = (0, generateCode_1.mergeContents)({
         src: contents,
-        newSrc: getKotlinImports(),
+        newSrc: getKotlinImports(props),
         anchor: /^package .+$/m,
         offset: 1,
         tag: `${MPARTICLE_TAG}-import`,
@@ -189,7 +218,7 @@ function addMParticleToJavaMainApplication(contents, props) {
     // Add import statements using mergeContents
     const withImports = (0, generateCode_1.mergeContents)({
         src: contents,
-        newSrc: getJavaImports(),
+        newSrc: getJavaImports(props),
         anchor: /^package .+;$/m,
         offset: 1,
         tag: `${MPARTICLE_TAG}-import`,

package/plugin/build/withMParticleIOS.js

@@ -26,6 +26,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.withMParticleIOS = void 0;
 const config_plugins_1 = require("@expo/config-plugins");
 const generateCode_1 = require("@expo/config-plugins/build/utils/generateCode");
+const customBaseUrl_1 = require("./customBaseUrl");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 // Tag used for mergeContents to identify code blocks added by this plugin
@@ -125,6 +126,12 @@ function generateSwiftInitCode(props) {
         lines.push('let identifyRequest = MPIdentityApiRequest.withEmptyUser()');
         lines.push('mParticleOptions.identifyRequest = identifyRequest');
     }
+    const customBaseUrl = (0, customBaseUrl_1.getCustomBaseUrl)(props);
+    if (customBaseUrl) {
+        lines.push('let networkOptions = MPNetworkOptions()');
+        lines.push(`networkOptions.customBaseURL = URL(string: ${JSON.stringify(customBaseUrl)})`);
+        lines.push('mParticleOptions.networkOptions = networkOptions');
+    }
     lines.push('MParticle.sharedInstance().start(with: mParticleOptions)');
     return lines.join('\n    ');
 }
@@ -156,6 +163,12 @@ function generateObjcInitCode(props) {
         lines.push('MPIdentityApiRequest *identifyRequest = [MPIdentityApiRequest requestWithEmptyUser];');
         lines.push('mParticleOptions.identifyRequest = identifyRequest;');
     }
+    const customBaseUrl = (0, customBaseUrl_1.getCustomBaseUrl)(props);
+    if (customBaseUrl) {
+        lines.push('MPNetworkOptions *networkOptions = [[MPNetworkOptions alloc] init];');
+        lines.push(`networkOptions.customBaseURL = [NSURL URLWithString:@${JSON.stringify(customBaseUrl)}];`);
+        lines.push('mParticleOptions.networkOptions = networkOptions;');
+    }
     lines.push('[[MParticle sharedInstance] startWithOptions:mParticleOptions];');
     return lines.join('\n  ');
 }
@@ -283,6 +296,9 @@ const KIT_TRANSITIVE_DEPENDENCIES = {
     // "mParticle-Amplitude": [],
     // "mParticle-Braze": [],
 };
+const KIT_VERSION_REQUIREMENTS = {
+    'mParticle-Rokt': "'~> 9.2'",
+};
 /**
  * Get all pods that need dynamic framework linking
  */
@@ -304,6 +320,12 @@ function getDynamicFrameworkPods(iosKits) {
     }
     return [...new Set(pods)]; // Remove duplicates
 }
+function getKitPodDeclaration(kit) {
+    const versionRequirement = KIT_VERSION_REQUIREMENTS[kit];
+    return versionRequirement
+        ? `  pod '${kit}', ${versionRequirement}`
+        : `  pod '${kit}'`;
+}
 /**
  * Add kit pods and pre_install hook to Podfile
  */
@@ -343,7 +365,7 @@ end
             }
             // Add kit pods if specified
             if (props.iosKits && props.iosKits.length > 0) {
-                const kitPods = props.iosKits.map(kit => `  pod '${kit}'`).join('\n');
+                const kitPods = props.iosKits.map(getKitPodDeclaration).join('\n');
                 // Check if kits are already added
                 const kitsAlreadyAdded = props.iosKits.every(kit => podfileContent.includes(`pod '${kit}'`));
                 if (!kitsAlreadyAdded) {

package/plugin/src/customBaseUrl.ts

@@ -0,0 +1,31 @@
+export interface CustomBaseUrlProps {
+  customBaseUrl?: string;
+}
+
+export function getCustomBaseUrl(props: CustomBaseUrlProps): string | null {
+  const customBaseUrl = props.customBaseUrl?.trim();
+
+  if (!customBaseUrl) {
+    return null;
+  }
+
+  let parsedCustomBaseUrl: URL;
+  try {
+    parsedCustomBaseUrl = new URL(customBaseUrl);
+  } catch {
+    throw new Error(
+      'react-native-mparticle customBaseUrl must be a valid https URL'
+    );
+  }
+
+  if (
+    parsedCustomBaseUrl.protocol !== 'https:' ||
+    !parsedCustomBaseUrl.hostname
+  ) {
+    throw new Error(
+      'react-native-mparticle customBaseUrl must be a valid https URL'
+    );
+  }
+
+  return customBaseUrl;
+}

package/plugin/src/withMParticle.ts

@@ -56,6 +56,13 @@ export interface MParticlePluginProps {
    */
   iosKits?: string[];
 
+  /**
+   * Custom base URL for global CNAME setup.
+   * This is applied before mParticle starts on iOS and Android.
+   * @example 'https://your-cname.example.com'
+   */
+  customBaseUrl?: string;
+
   /**
    * Android kit artifact names to include (version auto-detected from core SDK)
    * @example ['android-rokt-kit', 'android-amplitude-kit']

package/plugin/src/withMParticleAndroid.ts

@@ -5,6 +5,7 @@ import {
 } from '@expo/config-plugins';
 import { mergeContents } from '@expo/config-plugins/build/utils/generateCode';
 import { MParticlePluginProps } from './withMParticle';
+import { getCustomBaseUrl } from './customBaseUrl';
 
 // Tag used for mergeContents to identify code blocks added by this plugin
 const MPARTICLE_TAG = 'react-native-mparticle';
@@ -62,6 +63,7 @@ function generateKotlinInitCode(props: MParticlePluginProps): string {
     dataPlanId,
     dataPlanVersion,
   } = props;
+  const customBaseUrl = getCustomBaseUrl(props);
 
   const lines: string[] = [
     '// mParticle SDK initialization',
@@ -84,6 +86,16 @@ function generateKotlinInitCode(props: MParticlePluginProps): string {
     lines.push(`    .dataplan("${dataPlanId}"${versionParam})`);
   }
 
+  if (customBaseUrl) {
+    lines.push('    .networkOptions(');
+    lines.push('        NetworkOptions.builder()');
+    lines.push(
+      `            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`
+    );
+    lines.push('            .build()');
+    lines.push('    )');
+  }
+
   if (useEmptyIdentifyRequest) {
     lines.push('    .identify(IdentityApiRequest.withEmptyUser().build())');
   }
@@ -107,6 +119,7 @@ function generateJavaInitCode(props: MParticlePluginProps): string {
     dataPlanId,
     dataPlanVersion,
   } = props;
+  const customBaseUrl = getCustomBaseUrl(props);
 
   const lines: string[] = [
     '// mParticle SDK initialization',
@@ -129,6 +142,16 @@ function generateJavaInitCode(props: MParticlePluginProps): string {
     lines.push(`    .dataplan("${dataPlanId}"${versionParam})`);
   }
 
+  if (customBaseUrl) {
+    lines.push('    .networkOptions(');
+    lines.push('        NetworkOptions.builder()');
+    lines.push(
+      `            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`
+    );
+    lines.push('            .build()');
+    lines.push('    )');
+  }
+
   if (useEmptyIdentifyRequest) {
     lines.push('    .identify(IdentityApiRequest.withEmptyUser().build())');
   }
@@ -143,19 +166,35 @@ function generateJavaInitCode(props: MParticlePluginProps): string {
 /**
  * Generate mParticle import statements for Kotlin
  */
-function getKotlinImports(): string {
-  return `import com.mparticle.MParticle
-import com.mparticle.MParticleOptions
-import com.mparticle.identity.IdentityApiRequest`;
+function getKotlinImports(props: MParticlePluginProps): string {
+  const imports = [
+    'import com.mparticle.MParticle',
+    'import com.mparticle.MParticleOptions',
+    'import com.mparticle.identity.IdentityApiRequest',
+  ];
+
+  if (getCustomBaseUrl(props)) {
+    imports.push('import com.mparticle.networking.NetworkOptions');
+  }
+
+  return imports.join('\n');
 }
 
 /**
  * Generate mParticle import statements for Java
  */
-function getJavaImports(): string {
-  return `import com.mparticle.MParticle;
-import com.mparticle.MParticleOptions;
-import com.mparticle.identity.IdentityApiRequest;`;
+function getJavaImports(props: MParticlePluginProps): string {
+  const imports = [
+    'import com.mparticle.MParticle;',
+    'import com.mparticle.MParticleOptions;',
+    'import com.mparticle.identity.IdentityApiRequest;',
+  ];
+
+  if (getCustomBaseUrl(props)) {
+    imports.push('import com.mparticle.networking.NetworkOptions;');
+  }
+
+  return imports.join('\n');
 }
 
 /**
@@ -210,7 +249,7 @@ function addMParticleToKotlinMainApplication(
   // Add import statements using mergeContents
   const withImports = mergeContents({
     src: contents,
-    newSrc: getKotlinImports(),
+    newSrc: getKotlinImports(props),
     anchor: /^package .+$/m,
     offset: 1, // Add after package declaration
     tag: `${MPARTICLE_TAG}-import`,
@@ -261,7 +300,7 @@ function addMParticleToJavaMainApplication(
   // Add import statements using mergeContents
   const withImports = mergeContents({
     src: contents,
-    newSrc: getJavaImports(),
+    newSrc: getJavaImports(props),
     anchor: /^package .+;$/m,
     offset: 1, // Add after package declaration
     tag: `${MPARTICLE_TAG}-import`,

package/plugin/src/withMParticleIOS.ts

@@ -5,6 +5,7 @@ import {
 } from '@expo/config-plugins';
 import { mergeContents } from '@expo/config-plugins/build/utils/generateCode';
 import { MParticlePluginProps } from './withMParticle';
+import { getCustomBaseUrl } from './customBaseUrl';
 import * as fs from 'fs';
 import * as path from 'path';
 
@@ -134,6 +135,17 @@ function generateSwiftInitCode(props: MParticlePluginProps): string {
     lines.push('mParticleOptions.identifyRequest = identifyRequest');
   }
 
+  const customBaseUrl = getCustomBaseUrl(props);
+  if (customBaseUrl) {
+    lines.push('let networkOptions = MPNetworkOptions()');
+    lines.push(
+      `networkOptions.customBaseURL = URL(string: ${JSON.stringify(
+        customBaseUrl
+      )})`
+    );
+    lines.push('mParticleOptions.networkOptions = networkOptions');
+  }
+
   lines.push('MParticle.sharedInstance().start(with: mParticleOptions)');
 
   return lines.join('\n    ');
@@ -183,6 +195,19 @@ function generateObjcInitCode(props: MParticlePluginProps): string {
     lines.push('mParticleOptions.identifyRequest = identifyRequest;');
   }
 
+  const customBaseUrl = getCustomBaseUrl(props);
+  if (customBaseUrl) {
+    lines.push(
+      'MPNetworkOptions *networkOptions = [[MPNetworkOptions alloc] init];'
+    );
+    lines.push(
+      `networkOptions.customBaseURL = [NSURL URLWithString:@${JSON.stringify(
+        customBaseUrl
+      )}];`
+    );
+    lines.push('mParticleOptions.networkOptions = networkOptions;');
+  }
+
   lines.push('[[MParticle sharedInstance] startWithOptions:mParticleOptions];');
 
   return lines.join('\n  ');
@@ -349,6 +374,10 @@ const KIT_TRANSITIVE_DEPENDENCIES: Record<string, string[]> = {
   // "mParticle-Braze": [],
 };
 
+const KIT_VERSION_REQUIREMENTS: Record<string, string> = {
+  'mParticle-Rokt': "'~> 9.2'",
+};
+
 /**
  * Get all pods that need dynamic framework linking
  */
@@ -373,6 +402,13 @@ function getDynamicFrameworkPods(iosKits?: string[]): string[] {
   return [...new Set(pods)]; // Remove duplicates
 }
 
+function getKitPodDeclaration(kit: string): string {
+  const versionRequirement = KIT_VERSION_REQUIREMENTS[kit];
+  return versionRequirement
+    ? `  pod '${kit}', ${versionRequirement}`
+    : `  pod '${kit}'`;
+}
+
 /**
  * Add kit pods and pre_install hook to Podfile
  */
@@ -427,7 +463,7 @@ end
 
       // Add kit pods if specified
       if (props.iosKits && props.iosKits.length > 0) {
-        const kitPods = props.iosKits.map(kit => `  pod '${kit}'`).join('\n');
+        const kitPods = props.iosKits.map(getKitPodDeclaration).join('\n');
 
         // Check if kits are already added
         const kitsAlreadyAdded = props.iosKits.every(kit =>

package/react-native-mparticle.podspec

@@ -25,6 +25,6 @@ Pod::Spec.new do |s|
     s.dependency "React-Core"
   end
 
-  s.dependency 'mParticle-Apple-SDK-ObjC', '~> 9.0'
-  s.dependency 'RoktContracts', '~> 0.1'
+  s.dependency 'mParticle-Apple-SDK-ObjC', '~> 9.2'
+  s.dependency 'RoktContracts', '~> 2.0'
 end