react-native-mparticle 3.1.2 → 3.1.4

package/README.md

@@ -71,20 +71,21 @@ npx expo run:android
 
 ### Plugin Configuration Options
 
-| Option                    | Type     | Required | Description                                                         |
-| ------------------------- | -------- | -------- | ------------------------------------------------------------------- |
-| `iosApiKey`               | string   | Yes      | iOS API key from mParticle dashboard                                |
-| `iosApiSecret`            | string   | Yes      | iOS API secret from mParticle dashboard                             |
-| `androidApiKey`           | string   | Yes      | Android API key from mParticle dashboard                            |
-| `androidApiSecret`        | string   | Yes      | Android API secret from mParticle dashboard                         |
-| `logLevel`                | string   | No       | Log level: `'none'`, `'error'`, `'warning'`, `'debug'`, `'verbose'` |
-| `environment`             | string   | No       | Environment: `'development'`, `'production'`, `'autoDetect'`        |
-| `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`)           |
+| Option                    | Type     | Required | Description                                                                                   |
+| ------------------------- | -------- | -------- | --------------------------------------------------------------------------------------------- |
+| `iosApiKey`               | string   | Yes      | iOS API key from mParticle dashboard                                                          |
+| `iosApiSecret`            | string   | Yes      | iOS API secret from mParticle dashboard                                                       |
+| `androidApiKey`           | string   | Yes      | Android API key from mParticle dashboard                                                      |
+| `androidApiSecret`        | string   | Yes      | Android API secret from mParticle dashboard                                                   |
+| `logLevel`                | string   | No       | Log level: `'none'`, `'error'`, `'warning'`, `'debug'`, `'verbose'`                           |
+| `environment`             | string   | No       | Environment: `'development'`, `'production'`, `'autoDetect'`                                  |
+| `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                                     |
+| `pinningDisabled`         | boolean  | No       | Disable SSL pinning (`MPNetworkOptions` on iOS; `setPinningDisabledInDevelopment` on 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`)                                     |
 
 ### Example with Kits
 
@@ -123,14 +124,14 @@ For global CNAME setup, add the optional shared `customBaseUrl` setting:
 **iOS:**
 
 - Adds mParticle SDK initialization to `AppDelegate` (supports both Swift and Objective-C)
-- Sets `MPNetworkOptions.customBaseURL` before startup when `customBaseUrl` is configured
+- Sets `MPNetworkOptions` (`customBaseURL` and/or `pinningDisabled`) before startup when those plugin options are 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
+- Sets `NetworkOptions` (`setCustomBaseURL` and/or `setPinningDisabledInDevelopment`) before startup when those plugin options are configured
 - Adds specified kit Maven dependencies to `build.gradle`
 
 ### Version Support

package/ios/RNMParticle/RNMParticle.mm

@@ -19,6 +19,13 @@
 - (void)setUserId:(NSNumber *)userId;
 @end
 
+// Forward declare so New Arch `logCommerceEvent` can use the same JS→native
+// mappings as `RCTConvert (MPCommerceEvent)` (defined later in this file).
+@interface RCTConvert (MPCommerceEvent)
++ (MPCommerceEventAction)MPCommerceEventAction:(id)json;
++ (MPPromotionAction)MPPromotionAction:(id)json;
+@end
+
 @implementation RNMParticle
 
 RCT_EXTERN void RCTRegisterModule(Class);
@@ -447,11 +454,14 @@ RCT_EXPORT_METHOD(getSession:(RCTResponseSenderBlock)completion)
     MPCommerceEvent *mpCommerceEvent = [[MPCommerceEvent alloc] init];
 
     if (commerceEvent.productActionType().has_value()) {
-        mpCommerceEvent.action = (MPCommerceEventAction)commerceEvent.productActionType().value();
+        mpCommerceEvent.action = [RCTConvert MPCommerceEventAction:@(commerceEvent.productActionType().value())];
     }
 
     if (commerceEvent.promotionActionType().has_value()) {
-        mpCommerceEvent.promotionContainer = [[MPPromotionContainer alloc] initWithAction:(MPPromotionAction)commerceEvent.promotionActionType().value() promotion:nil];
+        MPPromotionAction promotionAction =
+            [RCTConvert MPPromotionAction:@(commerceEvent.promotionActionType().value())];
+        mpCommerceEvent.promotionContainer =
+            [[MPPromotionContainer alloc] initWithAction:promotionAction promotion:nil];
     }
 
     if (commerceEvent.products().has_value()) {
@@ -778,7 +788,7 @@ RCT_EXPORT_METHOD(setCCPAConsentState:(MPCCPAConsent *)consent)
     MPCommerceEvent *commerceEvent = [[MPCommerceEvent alloc] init];
 
     if (dict[@"productActionType"] && dict[@"productActionType"] != [NSNull null]) {
-        commerceEvent.action = (MPCommerceEventAction)[dict[@"productActionType"] integerValue];
+        commerceEvent.action = [RCTConvert MPCommerceEventAction:dict[@"productActionType"]];
     }
 
     if (dict[@"products"] && dict[@"products"] != [NSNull null]) {
@@ -920,6 +930,7 @@ typedef NS_ENUM(NSUInteger, MPReactCommerceEventAction) {
 + (MPTransactionAttributes *)MPTransactionAttributes:(id)json;
 + (MPProduct *)MPProduct:(id)json;
 + (MPCommerceEventAction)MPCommerceEventAction:(id)json;
++ (MPPromotionAction)MPPromotionAction:(id)json;
 + (MPIdentityApiRequest *)MPIdentityApiRequest:(id)json;
 + (MPIdentityApiResult *)MPIdentityApiResult:(id)json;
 + (MPAliasRequest *)MPAliasRequest:(id)json;
@@ -989,7 +1000,7 @@ typedef NS_ENUM(NSUInteger, MPReactCommerceEventAction) {
 }
 
 + (MPPromotionContainer *)MPPromotionContainer:(id)json {
-    MPPromotionAction promotionAction = (MPPromotionAction)[json[@"promotionActionType"] intValue];
+    MPPromotionAction promotionAction = [RCTConvert MPPromotionAction:json[@"promotionActionType"]];
     MPPromotionContainer *promotionContainer = [[MPPromotionContainer alloc] initWithAction:promotionAction promotion:nil];
     NSArray *jsonPromotions = json[@"promotions"];
     [jsonPromotions enumerateObjectsUsingBlock:^(id  _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
@@ -1039,6 +1050,20 @@ typedef NS_ENUM(NSUInteger, MPReactCommerceEventAction) {
     return product;
 }
 
++ (MPPromotionAction)MPPromotionAction:(NSNumber *)json {
+    // JS `PromotionActionType`: View = 0, Click = 1 (js/index.tsx).
+    // Apple `MPPromotionAction`: Click = 0, View = 1 (MPPromotion.h).
+    switch ([json intValue]) {
+        case 0:
+            return MPPromotionActionView;
+        case 1:
+            return MPPromotionActionClick;
+        default:
+            // Match Android `convertPromotionActionType`: non-zero → Click
+            return MPPromotionActionClick;
+    }
+}
+
 + (MPCommerceEventAction)MPCommerceEventAction:(NSNumber *)json {
     int actionInt = [json intValue];
     MPCommerceEventAction action;

package/package.json

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

package/plugin/build/withMParticle.d.ts

@@ -48,6 +48,14 @@ export interface MParticlePluginProps {
      * @example 'https://your-cname.example.com'
      */
     customBaseUrl?: string;
+    /**
+     * When true, disables SSL certificate pinning for mParticle network traffic.
+     *
+     * - **iOS:** Sets `MPNetworkOptions.pinningDisabled` before startup.
+     * - **Android:** Sets `NetworkOptions.Builder.setPinningDisabledInDevelopment(true)`
+     *   (mParticle's Android API for proxy/debug builds; see Android SDK docs).
+     */
+    pinningDisabled?: boolean;
     /**
      * Android kit artifact names to include (version auto-detected from core SDK)
      * @example ['android-rokt-kit', 'android-amplitude-kit']

package/plugin/build/withMParticleAndroid.js

@@ -6,6 +6,9 @@ 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';
+function shouldEmitNetworkOptions(props) {
+    return Boolean((0, customBaseUrl_1.getCustomBaseUrl)(props) || props.pinningDisabled === true);
+}
 /**
  * Get the mParticle log level string for Android
  */
@@ -46,6 +49,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 pinningDisabled = props.pinningDisabled === true;
     const lines = [
         '// mParticle SDK initialization',
         'val mParticleOptions = MParticleOptions.builder(this)',
@@ -63,10 +67,15 @@ function generateKotlinInitCode(props) {
         const versionParam = dataPlanVersion ? `, ${dataPlanVersion}` : '';
         lines.push(`    .dataplan("${dataPlanId}"${versionParam})`);
     }
-    if (customBaseUrl) {
+    if (shouldEmitNetworkOptions(props)) {
         lines.push('    .networkOptions(');
         lines.push('        NetworkOptions.builder()');
-        lines.push(`            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`);
+        if (customBaseUrl) {
+            lines.push(`            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`);
+        }
+        if (pinningDisabled) {
+            lines.push('            .setPinningDisabledInDevelopment(true)');
+        }
         lines.push('            .build()');
         lines.push('    )');
     }
@@ -83,6 +92,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 pinningDisabled = props.pinningDisabled === true;
     const lines = [
         '// mParticle SDK initialization',
         'MParticleOptions.Builder optionsBuilder = MParticleOptions.builder(this)',
@@ -100,10 +110,15 @@ function generateJavaInitCode(props) {
         const versionParam = dataPlanVersion ? `, ${dataPlanVersion}` : '';
         lines.push(`    .dataplan("${dataPlanId}"${versionParam})`);
     }
-    if (customBaseUrl) {
+    if (shouldEmitNetworkOptions(props)) {
         lines.push('    .networkOptions(');
         lines.push('        NetworkOptions.builder()');
-        lines.push(`            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`);
+        if (customBaseUrl) {
+            lines.push(`            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`);
+        }
+        if (pinningDisabled) {
+            lines.push('            .setPinningDisabledInDevelopment(true)');
+        }
         lines.push('            .build()');
         lines.push('    )');
     }
@@ -124,7 +139,7 @@ function getKotlinImports(props) {
         'import com.mparticle.MParticleOptions',
         'import com.mparticle.identity.IdentityApiRequest',
     ];
-    if ((0, customBaseUrl_1.getCustomBaseUrl)(props)) {
+    if (shouldEmitNetworkOptions(props)) {
         imports.push('import com.mparticle.networking.NetworkOptions');
     }
     return imports.join('\n');
@@ -138,7 +153,7 @@ function getJavaImports(props) {
         'import com.mparticle.MParticleOptions;',
         'import com.mparticle.identity.IdentityApiRequest;',
     ];
-    if ((0, customBaseUrl_1.getCustomBaseUrl)(props)) {
+    if (shouldEmitNetworkOptions(props)) {
         imports.push('import com.mparticle.networking.NetworkOptions;');
     }
     return imports.join('\n');

package/plugin/build/withMParticleIOS.js

@@ -127,9 +127,15 @@ function generateSwiftInitCode(props) {
         lines.push('mParticleOptions.identifyRequest = identifyRequest');
     }
     const customBaseUrl = (0, customBaseUrl_1.getCustomBaseUrl)(props);
-    if (customBaseUrl) {
+    const pinningDisabled = props.pinningDisabled === true;
+    if (customBaseUrl || pinningDisabled) {
         lines.push('let networkOptions = MPNetworkOptions()');
-        lines.push(`networkOptions.customBaseURL = URL(string: ${JSON.stringify(customBaseUrl)})`);
+        if (customBaseUrl) {
+            lines.push(`networkOptions.customBaseURL = URL(string: ${JSON.stringify(customBaseUrl)})`);
+        }
+        if (pinningDisabled) {
+            lines.push('networkOptions.pinningDisabled = true');
+        }
         lines.push('mParticleOptions.networkOptions = networkOptions');
     }
     lines.push('MParticle.sharedInstance().start(with: mParticleOptions)');
@@ -164,9 +170,15 @@ function generateObjcInitCode(props) {
         lines.push('mParticleOptions.identifyRequest = identifyRequest;');
     }
     const customBaseUrl = (0, customBaseUrl_1.getCustomBaseUrl)(props);
-    if (customBaseUrl) {
+    const pinningDisabled = props.pinningDisabled === true;
+    if (customBaseUrl || pinningDisabled) {
         lines.push('MPNetworkOptions *networkOptions = [[MPNetworkOptions alloc] init];');
-        lines.push(`networkOptions.customBaseURL = [NSURL URLWithString:@${JSON.stringify(customBaseUrl)}];`);
+        if (customBaseUrl) {
+            lines.push(`networkOptions.customBaseURL = [NSURL URLWithString:@${JSON.stringify(customBaseUrl)}];`);
+        }
+        if (pinningDisabled) {
+            lines.push('networkOptions.pinningDisabled = YES;');
+        }
         lines.push('mParticleOptions.networkOptions = networkOptions;');
     }
     lines.push('[[MParticle sharedInstance] startWithOptions:mParticleOptions];');

package/plugin/src/withMParticle.ts

@@ -63,6 +63,15 @@ export interface MParticlePluginProps {
    */
   customBaseUrl?: string;
 
+  /**
+   * When true, disables SSL certificate pinning for mParticle network traffic.
+   *
+   * - **iOS:** Sets `MPNetworkOptions.pinningDisabled` before startup.
+   * - **Android:** Sets `NetworkOptions.Builder.setPinningDisabledInDevelopment(true)`
+   *   (mParticle's Android API for proxy/debug builds; see Android SDK docs).
+   */
+  pinningDisabled?: boolean;
+
   /**
    * Android kit artifact names to include (version auto-detected from core SDK)
    * @example ['android-rokt-kit', 'android-amplitude-kit']

package/plugin/src/withMParticleAndroid.ts

@@ -10,6 +10,10 @@ import { getCustomBaseUrl } from './customBaseUrl';
 // Tag used for mergeContents to identify code blocks added by this plugin
 const MPARTICLE_TAG = 'react-native-mparticle';
 
+function shouldEmitNetworkOptions(props: MParticlePluginProps): boolean {
+  return Boolean(getCustomBaseUrl(props) || props.pinningDisabled === true);
+}
+
 /**
  * Get the mParticle log level string for Android
  */
@@ -64,6 +68,7 @@ function generateKotlinInitCode(props: MParticlePluginProps): string {
     dataPlanVersion,
   } = props;
   const customBaseUrl = getCustomBaseUrl(props);
+  const pinningDisabled = props.pinningDisabled === true;
 
   const lines: string[] = [
     '// mParticle SDK initialization',
@@ -86,12 +91,17 @@ function generateKotlinInitCode(props: MParticlePluginProps): string {
     lines.push(`    .dataplan("${dataPlanId}"${versionParam})`);
   }
 
-  if (customBaseUrl) {
+  if (shouldEmitNetworkOptions(props)) {
     lines.push('    .networkOptions(');
     lines.push('        NetworkOptions.builder()');
-    lines.push(
-      `            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`
-    );
+    if (customBaseUrl) {
+      lines.push(
+        `            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`
+      );
+    }
+    if (pinningDisabled) {
+      lines.push('            .setPinningDisabledInDevelopment(true)');
+    }
     lines.push('            .build()');
     lines.push('    )');
   }
@@ -120,6 +130,7 @@ function generateJavaInitCode(props: MParticlePluginProps): string {
     dataPlanVersion,
   } = props;
   const customBaseUrl = getCustomBaseUrl(props);
+  const pinningDisabled = props.pinningDisabled === true;
 
   const lines: string[] = [
     '// mParticle SDK initialization',
@@ -142,12 +153,17 @@ function generateJavaInitCode(props: MParticlePluginProps): string {
     lines.push(`    .dataplan("${dataPlanId}"${versionParam})`);
   }
 
-  if (customBaseUrl) {
+  if (shouldEmitNetworkOptions(props)) {
     lines.push('    .networkOptions(');
     lines.push('        NetworkOptions.builder()');
-    lines.push(
-      `            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`
-    );
+    if (customBaseUrl) {
+      lines.push(
+        `            .setCustomBaseURL(${JSON.stringify(customBaseUrl)})`
+      );
+    }
+    if (pinningDisabled) {
+      lines.push('            .setPinningDisabledInDevelopment(true)');
+    }
     lines.push('            .build()');
     lines.push('    )');
   }
@@ -173,7 +189,7 @@ function getKotlinImports(props: MParticlePluginProps): string {
     'import com.mparticle.identity.IdentityApiRequest',
   ];
 
-  if (getCustomBaseUrl(props)) {
+  if (shouldEmitNetworkOptions(props)) {
     imports.push('import com.mparticle.networking.NetworkOptions');
   }
 
@@ -190,7 +206,7 @@ function getJavaImports(props: MParticlePluginProps): string {
     'import com.mparticle.identity.IdentityApiRequest;',
   ];
 
-  if (getCustomBaseUrl(props)) {
+  if (shouldEmitNetworkOptions(props)) {
     imports.push('import com.mparticle.networking.NetworkOptions;');
   }
 

package/plugin/src/withMParticleIOS.ts

@@ -136,13 +136,19 @@ function generateSwiftInitCode(props: MParticlePluginProps): string {
   }
 
   const customBaseUrl = getCustomBaseUrl(props);
-  if (customBaseUrl) {
+  const pinningDisabled = props.pinningDisabled === true;
+  if (customBaseUrl || pinningDisabled) {
     lines.push('let networkOptions = MPNetworkOptions()');
-    lines.push(
-      `networkOptions.customBaseURL = URL(string: ${JSON.stringify(
-        customBaseUrl
-      )})`
-    );
+    if (customBaseUrl) {
+      lines.push(
+        `networkOptions.customBaseURL = URL(string: ${JSON.stringify(
+          customBaseUrl
+        )})`
+      );
+    }
+    if (pinningDisabled) {
+      lines.push('networkOptions.pinningDisabled = true');
+    }
     lines.push('mParticleOptions.networkOptions = networkOptions');
   }
 
@@ -196,15 +202,21 @@ function generateObjcInitCode(props: MParticlePluginProps): string {
   }
 
   const customBaseUrl = getCustomBaseUrl(props);
-  if (customBaseUrl) {
+  const pinningDisabled = props.pinningDisabled === true;
+  if (customBaseUrl || pinningDisabled) {
     lines.push(
       'MPNetworkOptions *networkOptions = [[MPNetworkOptions alloc] init];'
     );
-    lines.push(
-      `networkOptions.customBaseURL = [NSURL URLWithString:@${JSON.stringify(
-        customBaseUrl
-      )}];`
-    );
+    if (customBaseUrl) {
+      lines.push(
+        `networkOptions.customBaseURL = [NSURL URLWithString:@${JSON.stringify(
+          customBaseUrl
+        )}];`
+      );
+    }
+    if (pinningDisabled) {
+      lines.push('networkOptions.pinningDisabled = YES;');
+    }
     lines.push('mParticleOptions.networkOptions = networkOptions;');
   }