feat(expo): add shared custom base URL support

Add a shared Expo customBaseUrl option for CNAME setup so iOS and Android use the same configuration value during mParticle startup.

Update Android integration requirements to 5.79.0 and align the sample and documentation with the new shared setting.

#agentic

Author: thomson-t

ExpoTestApp/README.md

@@ -42,7 +42,6 @@ This app tests the Expo config plugin integration for the mParticle React Native
              "androidApiSecret": "YOUR_ANDROID_API_SECRET",
              "logLevel": "verbose",
              "environment": "development",
-             "iosCustomBaseURL": "https://cname.example.com",
              "iosKits": ["mParticle-Rokt"],
              "androidKits": ["android-rokt-kit"]
            }
@@ -100,7 +99,9 @@ The Rokt section also demonstrates:
 - Using `RoktLayoutView` as an embedded placeholder component
 
 On Android, the Rokt session APIs require `android-core` and
-`android-rokt-kit` `5.77.0` or newer.
+`android-rokt-kit` `5.79.0` or newer. If configured, the shared Expo
+`customBaseUrl` setting is applied to Android through
+`NetworkOptions.setCustomBaseURL`.
 
 ### Implementation guide: Shoppable Ads (`selectShoppableAds`)
 
@@ -156,9 +157,6 @@ Check `ios/MParticleExpoTest/AppDelegate.swift` for:
   mParticleOptions.environment = .development
   let identifyRequest = MPIdentityApiRequest.withEmptyUser()
   mParticleOptions.identifyRequest = identifyRequest
-  let networkOptions = MPNetworkOptions()
-  networkOptions.customBaseURL = URL(string: "https://cname.example.com")
-  mParticleOptions.networkOptions = networkOptions
   MParticle.sharedInstance().start(with: mParticleOptions)
   ```
 
@@ -181,9 +179,6 @@ For older Expo SDK versions, check `ios/MParticleExpoTest/AppDelegate.mm` for:
   mParticleOptions.environment = MPEnvironmentDevelopment;
   MPIdentityApiRequest *identifyRequest = [MPIdentityApiRequest requestWithEmptyUser];
   mParticleOptions.identifyRequest = identifyRequest;
-  MPNetworkOptions *networkOptions = [[MPNetworkOptions alloc] init];
-  networkOptions.customBaseURL = [NSURL URLWithString:@"https://cname.example.com"];
-  mParticleOptions.networkOptions = networkOptions;
   [[MParticle sharedInstance] startWithOptions:mParticleOptions];
   ```
 
@@ -285,5 +280,5 @@ dependencies {
 | `dataPlanId`              | string   | Data plan ID for validation                               |
 | `dataPlanVersion`         | number   | Data plan version                                         |
 | `iosKits`                 | string[] | iOS kit pod names (e.g., `["mParticle-Rokt"]`)            |
-| `iosCustomBaseURL`        | string   | iOS custom base URL for global CNAME setup                |
+| `customBaseUrl`           | string   | Custom base URL for global CNAME setup on iOS and Android |
 | `androidKits`             | string[] | Android kit dependencies (e.g., `["android-rokt-kit"]`)   |

ExpoTestApp/app.json

@@ -45,7 +45,6 @@
           "logLevel": "verbose",
           "useEmptyIdentifyRequest": true,
           "environment": "development",
-          "iosCustomBaseURL": "https://cname.example.com",
           "iosKits": ["mParticle-Rokt"],
           "androidKits": ["android-rokt-kit"]
         }

MIGRATING.md

@@ -32,7 +32,7 @@ MParticle.Rokt.getSessionId(): Promise<string | null>
 
 `close()` is supported on iOS and Android. Session APIs are backed by the iOS
 mParticle Rokt kit. On Android, apps that use these session APIs must use
-`android-core` and `android-rokt-kit` `5.77.0` or newer.
+`android-core` and `android-rokt-kit` `5.79.0` or newer.
 
 ### Expo Config Plugin
 
@@ -52,17 +52,18 @@ Use `iosKits: ["mParticle-Rokt"]` for standard Rokt placements:
 The plugin pins generated `mParticle-Rokt` pods to `~> 9.2`. It does not add
 payment-extension pods or URL callback forwarding in this release.
 
-For global CNAME setup, configure `iosCustomBaseURL`:
+For global CNAME setup, configure the shared `customBaseUrl` setting:
 
 ```json
 {
-  "iosCustomBaseURL": "https://cname.example.com"
+  "customBaseUrl": "https://cname.example.com"
 }
 ```
 
-The plugin applies this through `MPNetworkOptions.customBaseURL` before
-mParticle starts. There is no runtime JavaScript setter because the Rokt kit
-reads this setting during initialization.
+The plugin applies this through `MPNetworkOptions.customBaseURL` on iOS and
+`NetworkOptions.setCustomBaseURL` on Android before mParticle starts. There is
+no runtime JavaScript setter because the Rokt kit reads this setting during
+initialization.
 
 ### Notes
 

README.md

@@ -82,7 +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']`)                      |
-| `iosCustomBaseURL`        | string   | No       | iOS custom base URL for global CNAME setup                          |
+| `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`)           |
 
@@ -101,7 +101,6 @@ npx expo run:android
           "androidApiSecret": "YOUR_ANDROID_API_SECRET",
           "environment": "development",
           "logLevel": "verbose",
-          "iosCustomBaseURL": "https://cname.example.com",
           "iosKits": ["mParticle-Rokt", "mParticle-Amplitude"],
           "androidKits": ["android-rokt-kit", "android-amplitude-kit"]
         }
@@ -111,18 +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 `iosCustomBaseURL` is configured
+- 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
@@ -294,7 +302,8 @@ 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.77.0` or newer are required.
+`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.
 
@@ -315,20 +324,28 @@ 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")
             //optional
             .logLevel(MParticle.LogLevel.VERBOSE)
             //optional
             .identify(identifyRequest)
+            //optional global CNAME setup
+            .networkOptions(
+                NetworkOptions.builder()
+                    .setCustomBaseURL("https://cname.example.com")
+                    .build()
+            )
             //optional
             .identifyTask(
                 BaseIdentityTask()

android/build.gradle

@@ -118,7 +118,7 @@ dependencies {
     //
     // (See https://github.com/mparticle/mparticle-android-sdk for the latest version)
     //
-    api 'com.mparticle:android-core:[5.9.3, )'
+    api 'com.mparticle:android-core:[5.79.0, )'
 
     //
     // And, if you want to include kits, you can do so as follows:
@@ -134,6 +134,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:+")
 }

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

plugin/src/withMParticle.ts

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

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`,