feat(rokt): add selectShoppableAds interface and iOS bridge

Expose selectShoppableAds in the Flutter API with iOS native implementation, Android no-op parity, and platform tests while keeping pod dependencies minimal via transitive resolution.

Made-with: Cursor

Author: denischilik

android/src/main/kotlin/com/mparticle/mparticle_flutter_sdk/MparticleFlutterSdkPlugin.kt

@@ -235,6 +235,7 @@ class MparticleFlutterSdkPlugin: FlutterPlugin, MethodCallHandler, ActivityAware
         result.success(true)
       }
       "roktSelectPlacements" -> this.roktSelectPlacements(call, result)
+      "roktSelectShoppableAds" -> this.roktSelectShoppableAds(call, result)
       "roktPurchaseFinalized" -> this.roktPurchaseFinalized(call, result)
       else -> {
         result.notImplemented()
@@ -806,6 +807,11 @@ class MparticleFlutterSdkPlugin: FlutterPlugin, MethodCallHandler, ActivityAware
     }
   }
 
+  private fun roktSelectShoppableAds(call: MethodCall, result: Result) {
+    // Parity with RN bridge: Android API is exposed but not implemented yet.
+    result.success(true)
+  }
+
   private fun String.toColorMode(): RoktConfig.ColorMode =
     when (this) {
       "dark" -> RoktConfig.ColorMode.DARK

ios/Classes/SwiftMparticleFlutterSdkPlugin.swift

@@ -561,6 +561,28 @@ public class SwiftMparticleFlutterSdkPlugin: NSObject, FlutterPlugin {
             print("Incorrect argument for \(call.method) iOS method")
             result(FlutterError(code: "INVALID_ARGUMENTS", message: "Missing placementId or catalogItemId or success", details: nil))
         }
+    case "roktSelectShoppableAds":
+        if let callArguments = call.arguments as? [String: Any],
+           let placementId = callArguments["placementId"] as? String {
+            let attributes = callArguments["attributes"] as? [String: String] ?? [:]
+            var roktConfig: RoktConfig?
+            if let configMap = callArguments["config"] as? [String: Any] {
+                roktConfig = buildRoktConfig(configMap: configMap)
+            }
+
+            roktEventHandler.subscribeToEvents(identifier: placementId)
+            MParticle.sharedInstance().rokt.selectShoppableAds(
+                placementId,
+                attributes: attributes,
+                config: roktConfig
+            ) { _ in
+                // Event propagation is handled by subscribeToEvents(identifier:)
+            }
+            result(true)
+        } else {
+            print("Incorrect argument for \(call.method) iOS method")
+            result(FlutterError(code: "INVALID_ARGUMENTS", message: "Missing placementId", details: nil))
+        }
     default:
         print("mParticle flutter SDK for iOS does not support \(call.method)")
     }

ios/mparticle_flutter_sdk.podspec

@@ -15,10 +15,8 @@ mParticle Flutter Wrapper
   s.source           = { :path => '.' }
   s.source_files = 'Classes/**/*'
   s.dependency 'Flutter'
-  # SDK 9.0 split requires both umbrella and ObjC pods.
+  # SDK 9.0 umbrella pod pulls required transitive dependencies.
   s.dependency 'mParticle-Apple-SDK', '~> 9.0'
-  s.dependency 'mParticle-Apple-SDK-ObjC', '~> 9.0'
-  s.dependency 'RoktContracts', '~> 0.1'
   s.platform = :ios, '15.6'
 
   # Flutter.framework does not contain a i386 slice.

lib/mparticle_flutter_sdk.dart

@@ -331,6 +331,22 @@ class Rokt {
     return await _channel.invokeMethod('roktSelectPlacements', params);
   }
 
+  /// Selects shoppable ads with a [identifier], optional [attributes], and optional [roktConfig].
+  ///
+  /// This method currently has native implementation on iOS.
+  /// Android keeps a no-op bridge for cross-platform API compatibility.
+  Future<void> selectShoppableAds({
+    required String identifier,
+    Map<String, dynamic>? attributes,
+    RoktConfig? roktConfig,
+  }) async {
+    return await _channel.invokeMethod('roktSelectShoppableAds', {
+      'placementId': identifier,
+      'attributes': attributes,
+      'config': _roktConfigToMap(config: roktConfig),
+    });
+  }
+
   /// Notifies Rokt that a purchase has been finalized
   ///
   /// Use this method to inform Rokt that a purchase has been completed or failed

lib/mparticle_flutter_sdk_web.dart

@@ -536,6 +536,18 @@ class MparticleFlutterSdkWeb {
           })
         ]);
         break;
+      case 'roktSelectShoppableAds':
+        final mpRokt = JsObject.fromBrowserObject(context['mParticle']['Rokt']);
+        final placementId = call.arguments['placementId'];
+        final attributes = call.arguments['attributes'] ?? {};
+
+        mpRokt.callMethod('selectShoppableAds', [
+          JsObject.jsify({
+            'identifier': placementId,
+            'attributes': attributes
+          })
+        ]);
+        break;
       default:
         throw PlatformException(
           code: 'Unimplemented',

test/mparticle_flutter_sdk_test.dart

@@ -502,5 +502,33 @@ void main() {
             'success': true,
           }));
     });
+
+    test('rokt select shoppable ads', () async {
+      final roktConfig = RoktConfig(
+          colorMode: ColorMode.dark,
+          cacheConfig: CacheConfig(
+              cacheDurationInSeconds: 100,
+              cacheAttributes: {'key1': 'value1'}));
+
+      await mp.rokt.selectShoppableAds(
+        identifier: 'placement1',
+        attributes: {'attr1': 'val1'},
+        roktConfig: roktConfig,
+      );
+
+      expect(
+          methodCall,
+          isMethodCall('roktSelectShoppableAds', arguments: {
+            'placementId': 'placement1',
+            'attributes': {'attr1': 'val1'},
+            'config': {
+              'colorMode': 'dark',
+              'cacheConfig': {
+                'cacheDurationInSeconds': 100,
+                'cacheAttributes': {'key1': 'value1'}
+              }
+            },
+          }));
+    });
   });
 }