@primer-io/react-native 2.46.0 → 3.0.0-beta.0

package/ios/Sources/DataModels/PrimerSettings+Extensions.swift

@@ -1,4 +1,3 @@
-import PrimerFoundation
 import PrimerSDK
 
 extension PrimerSettings {
@@ -116,17 +115,6 @@ extension PrimerSettings {
           )
         }
 
-        var allowedCardTypes: [CardType]?
-        if let rnAllowedCardTypes = rnApplePayOptions["allowedCardTypes"] as? [String] {
-          let parsedCardTypes = rnAllowedCardTypes.compactMap { CardType(rawValue: $0) }
-          if parsedCardTypes.count != rnAllowedCardTypes.count {
-            PrimerLogging.shared.logger.warn(
-              message: "Some allowedCardTypes values cannot be filtered on Apple Pay and were ignored")
-          }
-          // empty maps to nil so Apple Pay falls open to all types
-          allowedCardTypes = parsedCardTypes.isEmpty ? nil : parsedCardTypes
-        }
-
         applePayOptions = PrimerApplePayOptions(
           merchantIdentifier: rnApplePayMerchantIdentifier,
           merchantName: rnApplePayMerchantName,
@@ -134,8 +122,7 @@ extension PrimerSettings {
           showApplePayForUnsupportedDevice: rnApplePayShowApplePayForUnsupportedDevice,
           checkProvidedNetworks: rnApplePayCheckProvidedNetworks,
           shippingOptions: shippingOptions,
-          billingOptions: billingOptions,
-          allowedCardTypes: allowedCardTypes
+          billingOptions: billingOptions
         )
       }
 
@@ -162,8 +149,7 @@ extension PrimerSettings {
         var cardFormUIOptions: PrimerCardFormUIOptions?
         if let rnCardFormUIOptions = rnUIOptions["cardFormUIOptions"] as? [String: Any] {
             let rnCardFormUIOptionsData = try (JSONSerialization.data(withJSONObject: rnCardFormUIOptions))
-            let rnCardFormUIOptions = try JSONDecoder().decode(
-              PrimerCardFormUIOptionsRN.self, from: rnCardFormUIOptionsData)
+            let rnCardFormUIOptions = try JSONDecoder().decode(PrimerCardFormUIOptionsRN.self, from: rnCardFormUIOptionsData)
             cardFormUIOptions = rnCardFormUIOptions.asPrimerCardFormUIOptions()
         }
 

package/ios/Sources/Headless Universal Checkout/Managers/Assets Manager/RNTAssetsManager.m

@@ -10,10 +10,17 @@
 
 @interface RCT_EXTERN_MODULE(RNTPrimerHeadlessUniversalCheckoutAssetsManager, RCTEventEmitter)
 
+RCT_EXTERN_METHOD(getCardNetworkTraits:(NSString *)cardNetworkStr
+                      resolver:(RCTPromiseResolveBlock)resolver
+                      rejecter:(RCTPromiseRejectBlock)rejecter)
+
 RCT_EXTERN_METHOD(getCardNetworkImage:(NSString *)cardNetworkStr
                       resolver:(RCTPromiseResolveBlock)resolver
                       rejecter:(RCTPromiseRejectBlock)rejecter)
 
+RCT_EXTERN_METHOD(getOrderedAllowedCardNetworks:(RCTPromiseResolveBlock)resolver
+                      rejecter:(RCTPromiseRejectBlock)rejecter)
+
 RCT_EXTERN_METHOD(getPaymentMethodAsset:(NSString *)paymentMethodType
                       resolver:(RCTPromiseResolveBlock)resolver
                       rejecter:(RCTPromiseRejectBlock)rejecter)

package/ios/Sources/Headless Universal Checkout/Managers/Assets Manager/RNTAssetsManager.swift

@@ -6,7 +6,7 @@
 //
 
 import Foundation
-import PrimerSDK
+@_spi(PrimerInternal) import PrimerSDK
 import React
 
 // swiftlint:disable type_name
@@ -23,24 +23,57 @@ class RNTPrimerHeadlessUniversalCheckoutAssetsManager: RCTEventEmitter {
     }
 
     @objc
-    func getCardNetworkImage(
+    func getCardNetworkTraits(
         _ cardNetworkStr: String,
         resolver: RCTPromiseResolveBlock,
         rejecter: RCTPromiseRejectBlock
     ) {
-        do {
+        guard let traits = PrimerSDK.PrimerHeadlessUniversalCheckout.AssetsManager
+            .getCardNetworkTraits(cardNetworkString: cardNetworkStr) else {
+            resolver(nil)
+            return
+        }
+        resolver([
+            "cardNetwork": traits.cardNetwork.rawValue,
+            "displayName": traits.displayName,
+            "panLengths": traits.panLengths,
+            "gapPattern": traits.gapPattern,
+            "cvvLength": traits.cvvLength,
+            "cvvLabel": traits.cvvLabel
+        ])
+    }
 
-            guard let cardNetwork = CardNetwork(rawValue: cardNetworkStr) else {
-                let err = RNTNativeError(
-                    errorId: "native-ios",
-                    errorDescription: "Failed to find asset of \(cardNetworkStr).",
-                    recoverySuggestion: nil)
-                throw err
-            }
+    @objc
+    func getOrderedAllowedCardNetworks(
+        _ resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        guard #available(iOS 15.0, *) else {
+            resolver(["networks": NSNull()])
+            return
+        }
+        if let networks = ComponentsClientSessionBridge().getOrderedAllowedCardNetworks() {
+            resolver(["networks": networks])
+        } else {
+            resolver(["networks": NSNull()])
+        }
+    }
 
+    @objc
+    func getCardNetworkImage(
+        _ cardNetworkStr: String,
+        resolver: RCTPromiseResolveBlock,
+        rejecter: RCTPromiseRejectBlock
+    ) {
+        do {
+            // Use the non-deprecated getCardNetworkAsset API. The deprecated
+            // getCardNetworkImage(for:) concatenates rawValue uppercase with a lowercase
+            // bundle filename (e.g. "VISA-logo-colored" vs "visa-logo-colored.imageset"),
+            // which always misses on iOS's case-sensitive asset lookup.
             guard
-                let cardNetworkImage = try PrimerSDK.PrimerHeadlessUniversalCheckout.AssetsManager
-                    .getCardNetworkImage(for: cardNetwork)
+                let cardNetworkAsset = PrimerSDK.PrimerHeadlessUniversalCheckout.AssetsManager
+                    .getCardNetworkAsset(cardNetworkString: cardNetworkStr),
+                let cardNetworkImage = cardNetworkAsset.cardImage
             else {
                 let err = RNTNativeError(
                     errorId: "native-ios",
@@ -49,7 +82,7 @@ class RNTPrimerHeadlessUniversalCheckoutAssetsManager: RCTEventEmitter {
                 throw err
             }
 
-            let localUrl = try cardNetworkImage.store(withName: cardNetwork.rawValue)
+            let localUrl = try cardNetworkImage.store(withName: cardNetworkAsset.cardNetwork.rawValue)
             resolver(["cardNetworkImageURL": localUrl.absoluteString])
 
         } catch {

package/ios/Sources/Headless Universal Checkout/Managers/Payment Method Managers/RNPrimerHeadlessUniversalCheckoutVaultManager.m

@@ -22,4 +22,6 @@ RCT_EXTERN_METHOD(startPaymentFlow:(NSString *)vaultedPaymentMethodId resolver:(
 
 RCT_EXTERN_METHOD(startPaymentFlowWithAdditionalData:(NSString *)vaultedPaymentMethodId additionalDataStr:(NSString *)additionalDataStr resolver:(RCTPromiseResolveBlock)resolver rejecter:(RCTPromiseRejectBlock)rejecter)
 
+RCT_EXTERN_METHOD(requiresVaultedCardCvv:(RCTPromiseResolveBlock)resolver rejecter:(RCTPromiseRejectBlock)rejecter)
+
 @end

package/ios/Sources/Headless Universal Checkout/Managers/Payment Method Managers/RNPrimerHeadlessUniversalCheckoutVaultManager.swift

@@ -1,4 +1,4 @@
-import PrimerSDK
+@_spi(PrimerInternal) import PrimerSDK
 import React
 
 // swiftlint:disable type_name
@@ -105,4 +105,15 @@ class RNPrimerHeadlessUniversalCheckoutVaultManager: RCTEventEmitter {
       rejecter(error.rnError["errorId"]!, error.rnError["description"], error)
     }
   }
+
+  @objc
+  func requiresVaultedCardCvv(
+    _ resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock
+  ) {
+    guard #available(iOS 15.0, *) else {
+      resolver(false)
+      return
+    }
+    resolver(ComponentsClientSessionBridge().getCaptureVaultedCardCvv())
+  }
 }

package/ios/Sources/Headless Universal Checkout/Managers/Payment Method Managers/RNTRawDataManager.m

@@ -18,6 +18,8 @@ RCT_EXTERN_METHOD(setRawData:(NSString *)rawDataStr resolver:(RCTPromiseResolveB
 
 RCT_EXTERN_METHOD(submit:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(setBillingAddress:(NSString *)billingAddressStr resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+
 RCT_EXTERN_METHOD(cleanUp:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 
 @end

package/ios/Sources/Headless Universal Checkout/Managers/Payment Method Managers/RNTRawDataManager.swift

@@ -6,7 +6,7 @@
 //
 
 import Foundation
-import PrimerSDK
+@_spi(PrimerInternal) import PrimerSDK
 import React
 
 // swiftlint:disable type_name
@@ -165,12 +165,55 @@ class RNTPrimerHeadlessUniversalCheckoutRawDataManager: RCTEventEmitter {
     resolver(nil)
   }
 
+  @objc
+  public func setBillingAddress(
+    _ billingAddressStr: String,
+    resolver: @escaping RCTPromiseResolveBlock,
+    rejecter: @escaping RCTPromiseRejectBlock
+  ) {
+    guard rawDataManager != nil else {
+      let err = RNTNativeError(
+        errorId: "native-ios",
+        errorDescription: "The RawDataManager has not been initialized",
+        recoverySuggestion: "Make sure you have called initialized the `RawDataManager' first.")
+      rejecter(err.rnError["errorId"]!, err.rnError["description"], err)
+      return
+    }
+
+    guard let billingAddress = PrimerAddress(billingAddressStr: billingAddressStr) else {
+      let err = RNTNativeError(
+        errorId: "native-ios",
+        errorDescription: "Failed to decode billing address JSON.",
+        recoverySuggestion: "Make sure you're providing a valid billing address object.")
+      rejecter(err.rnError["errorId"]!, err.rnError["description"], err)
+      return
+    }
+
+    guard #available(iOS 15.0, *) else {
+      let err = RNTNativeError(
+        errorId: "native-ios",
+        errorDescription: "setBillingAddress requires iOS 15.0 or later.",
+        recoverySuggestion: "Update the deployment target or run on iOS 15+.")
+      rejecter(err.rnError["errorId"]!, err.rnError["description"], err)
+      return
+    }
+
+    Task {
+      do {
+        try await ComponentsBillingAddressBridge().setBillingAddress(billingAddress)
+        resolver(nil)
+      } catch {
+        rejecter(error.rnError["errorId"]!, error.rnError["description"], error)
+      }
+    }
+  }
+
   @objc
   public func cleanUp(
     _ resolver: RCTPromiseResolveBlock,
     rejecter: RCTPromiseRejectBlock
   ) {
-
+    resolver(nil)
   }
 
 }

package/ios/Sources/Headless Universal Checkout/RNTPrimerHeadlessUniversalCheckout.swift

@@ -6,7 +6,7 @@
 //
 
 import Foundation
-import PrimerSDK
+@_spi(PrimerInternal) import PrimerSDK
 import React
 
 // swiftlint:disable file_length
@@ -265,6 +265,30 @@ extension RNTPrimerHeadlessUniversalCheckout: PrimerHeadlessUniversalCheckoutDel
       self.sendEvent(
         withName: rnCallbackName,
         body: ["availablePaymentMethods": paymentMethods.compactMap({ $0.toJsonObject() })])
+
+      // The native SDK only fires `primerHeadlessUniversalCheckoutDidUpdateClientSession`
+      // on subsequent updates, never on initial load. Read the current session via
+      // `ComponentsClientSessionBridge` and synthesize the update event so JS receives
+      // the initial session at startup. iOS < 15 has no bridge access; the JS-side
+      // `onClientSessionUpdate` callback then fires only on subsequent updates.
+      if self.implementedRNCallbacks?.isOnClientSessionUpdateImplemented == true,
+         #available(iOS 15.0, *) {
+        let bridge = ComponentsClientSessionBridge()
+        if let initialClientSession = bridge.getClientSession() {
+          let updateCallbackName = PrimerHeadlessUniversalCheckoutEvents.onClientSessionUpdate.stringValue
+          do {
+            let payload = try Self.makeClientSessionPayload(
+              clientSession: initialClientSession,
+              checkoutModules: bridge.getCheckoutModules()
+            )
+            self.sendEvent(
+              withName: updateCallbackName,
+              body: [Self.clientSessionPayloadKey: payload])
+          } catch {
+            self.handleRNBridgeError(error, checkoutData: nil, stopOnDebug: true)
+          }
+        }
+      }
     }
   }
 
@@ -530,10 +554,19 @@ extension RNTPrimerHeadlessUniversalCheckout: PrimerHeadlessUniversalCheckoutDel
     DispatchQueue.main.async {
       if self.implementedRNCallbacks?.isOnClientSessionUpdateImplemented == true {
         do {
-          let json = try clientSession.toJsonObject()
+          // Augment the SDK-provided `clientSession` with `checkoutModules` from the
+          // bridge — these are not surfaced on the public `PrimerClientSession` type.
+          var checkoutModules: [ComponentsCheckoutModule]?
+          if #available(iOS 15.0, *) {
+            checkoutModules = ComponentsClientSessionBridge().getCheckoutModules()
+          }
+          let payload = try Self.makeClientSessionPayload(
+            clientSession: clientSession,
+            checkoutModules: checkoutModules
+          )
           self.sendEvent(
             withName: rnCallbackName,
-            body: ["clientSession": json])
+            body: [Self.clientSessionPayloadKey: payload])
 
         } catch {
           self.handleRNBridgeError(error, checkoutData: nil, stopOnDebug: true)
@@ -542,6 +575,31 @@ extension RNTPrimerHeadlessUniversalCheckout: PrimerHeadlessUniversalCheckoutDel
     }
   }
 
+  private static let clientSessionPayloadKey = "clientSession"
+
+  // Merges a `PrimerClientSession`'s JSON representation with `checkoutModules`
+  // surfaced by `ComponentsClientSessionBridge`. The bridge returns a value-typed
+  // `ComponentsCheckoutModule` parameter under SPI, so the parameter is `Any?` in
+  // the public signature to avoid leaking SPI types into call-site availability.
+  private static func makeClientSessionPayload(
+    clientSession: PrimerClientSession,
+    checkoutModules: Any?
+  ) throws -> [String: Any] {
+    let json = try clientSession.toJsonObject()
+    var dict = (json as? [String: Any]) ?? [:]
+
+    if #available(iOS 15.0, *), let modules = checkoutModules as? [ComponentsCheckoutModule] {
+      dict["checkoutModules"] = modules.map { module -> [String: Any] in
+        var moduleDict: [String: Any] = ["type": module.type]
+        if let options = module.options {
+          moduleDict["options"] = options
+        }
+        return moduleDict
+      }
+    }
+    return dict
+  }
+
   // case onBeforePaymentCreate
   func primerHeadlessUniversalCheckoutWillCreatePaymentWithData(
     _ data: PrimerCheckoutPaymentMethodData,

package/ios/Sources/NativePrimer/RCTNativePrimer.mm

@@ -128,6 +128,36 @@ RCT_EXPORT_METHOD(cleanUp:(RCTPromiseResolveBlock)resolve
     resolve(nil);
 }
 
+RCT_EXPORT_METHOD(trackAnalyticsEvent:(NSString *)eventName
+                  metadata:(NSString *)metadata
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    [self.primer trackAnalyticsEvent:eventName metadata:metadata resolver:resolve rejecter:reject];
+}
+
+RCT_EXPORT_METHOD(sendLog:(NSString *)message
+                  event:(NSString *)event
+                  initDurationMs:(NSNumber * _Nullable)initDurationMs
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    [self.primer sendLog:message event:event initDurationMs:initDurationMs resolver:resolve rejecter:reject];
+}
+
+RCT_EXPORT_METHOD(sendErrorLog:(NSString *)message
+                  event:(NSString * _Nullable)event
+                  errorMessage:(NSString * _Nullable)errorMessage
+                  stack:(NSString * _Nullable)stack
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    [self.primer sendErrorLog:message event:event errorMessage:errorMessage stack:stack resolver:resolve rejecter:reject];
+}
+
+RCT_EXPORT_METHOD(setupAnalyticsLoggingBridge:(NSString *)clientToken
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    [self.primer setupAnalyticsLoggingBridge:clientToken resolver:resolve rejecter:reject];
+}
+
 #ifdef RCT_NEW_ARCH_ENABLED
 #pragma mark - New Architecture Protocol Methods
 
@@ -182,10 +212,26 @@ RCT_EXPORT_METHOD(cleanUp:(RCTPromiseResolveBlock)resolve
 - (void)showVaultManagerWithClientToken:(nonnull NSString *)clientToken resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject { 
     [self.primer showVaultManagerWithClientToken:clientToken resolver:resolve rejecter:reject];
 }
-- (void)showPaymentMethod:(nonnull NSString *)paymentMethod intent:(nonnull NSString *)intent clientToken:(nonnull NSString *)clientToken resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject { 
+- (void)showPaymentMethod:(nonnull NSString *)paymentMethod intent:(nonnull NSString *)intent clientToken:(nonnull NSString *)clientToken resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
     [self.primer showPaymentMethod:paymentMethod intent:intent clientToken:clientToken resolver:resolve rejecter:reject];
 }
 
+- (void)trackAnalyticsEvent:(nonnull NSString *)eventName metadata:(NSString *)metadata resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
+    [self.primer trackAnalyticsEvent:eventName metadata:metadata resolver:resolve rejecter:reject];
+}
+
+- (void)sendLog:(nonnull NSString *)message event:(nonnull NSString *)event initDurationMs:(NSNumber *)initDurationMs resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
+    [self.primer sendLog:message event:event initDurationMs:initDurationMs resolver:resolve rejecter:reject];
+}
+
+- (void)sendErrorLog:(nonnull NSString *)message event:(NSString *)event errorMessage:(NSString *)errorMessage stack:(NSString *)stack resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
+    [self.primer sendErrorLog:message event:event errorMessage:errorMessage stack:stack resolver:resolve rejecter:reject];
+}
+
+- (void)setupAnalyticsLoggingBridge:(nonnull NSString *)clientToken resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
+    [self.primer setupAnalyticsLoggingBridge:clientToken resolver:resolve rejecter:reject];
+}
+
 #pragma mark - TurboModule
 - (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
     (const facebook::react::ObjCTurboModule::InitParams &)params

package/ios/Sources/PrimerViewUtils/RCTPrimerViewUtils.h

@@ -0,0 +1,10 @@
+#import <React/RCTBridgeModule.h>
+
+#ifdef RCT_NEW_ARCH_ENABLED
+#import <NativePrimerSpec/NativePrimerSpec.h>
+@interface RCTPrimerViewUtils : NSObject <RCTBridgeModule, NativePrimerViewUtilsSpec>
+#else
+@interface RCTPrimerViewUtils : NSObject <RCTBridgeModule>
+#endif
+
+@end

package/ios/Sources/PrimerViewUtils/RCTPrimerViewUtils.mm

@@ -0,0 +1,41 @@
+#import "RCTPrimerViewUtils.h"
+#import "PrimerSwiftInterop.h"
+
+@interface RCTPrimerViewUtils ()
+@property (nonatomic, strong) RNTPrimerViewUtils *viewUtils;
+@end
+
+@implementation RCTPrimerViewUtils
+
+RCT_EXPORT_MODULE(PrimerViewUtils)
+
+- (instancetype)init {
+    if (self = [super init]) {
+        _viewUtils = [[RNTPrimerViewUtils alloc] init];
+    }
+    return self;
+}
+
++ (BOOL)requiresMainQueueSetup {
+    return NO;
+}
+
+RCT_EXPORT_METHOD(getBottomSafeAreaInset:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    [self.viewUtils getBottomSafeAreaInset:resolve rejecter:reject];
+}
+
+#ifdef RCT_NEW_ARCH_ENABLED
+- (void)getBottomSafeAreaInset:(RCTPromiseResolveBlock)resolve
+                        reject:(RCTPromiseRejectBlock)reject {
+    [self.viewUtils getBottomSafeAreaInset:resolve rejecter:reject];
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativePrimerViewUtilsSpecJSI>(params);
+}
+#endif
+
+@end

package/ios/Sources/PrimerViewUtils/RNTPrimerViewUtils.swift

@@ -0,0 +1,23 @@
+import UIKit
+
+@objc public class RNTPrimerViewUtils: NSObject {
+
+  @objc public static func requiresMainQueueSetup() -> Bool {
+    return false
+  }
+
+  @objc public func getBottomSafeAreaInset(
+    _ resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    DispatchQueue.main.async {
+      let bottom = UIApplication.shared.connectedScenes
+        .compactMap { $0 as? UIWindowScene }
+        .first?
+        .windows
+        .first { $0.isKeyWindow }?
+        .safeAreaInsets.bottom ?? 0
+      resolve(bottom)
+    }
+  }
+}

package/ios/Sources/RNTPrimer.swift

@@ -6,7 +6,7 @@
 //
 
 import Foundation
-import PrimerSDK
+@_spi(PrimerInternal) import PrimerSDK
 import UIKit
 import React
 
@@ -63,6 +63,7 @@ enum PrimerEvents: Int, CaseIterable {
     var primerDidResumeWithDecisionHandler: ((_ resumeToken: String?, _ errorMessage: String?) -> Void)?
     var primerDidFailWithErrorDecisionHandler: ((_ errorMessage: String) -> Void)?
     var implementedRNCallbacks: ImplementedRNCallbacks?
+    private var analyticsLoggingBridge: ComponentsAnalyticsLoggingBridge?
 
     // MARK: - INITIALIZATION & REACT NATIVE SUPPORT
 
@@ -339,6 +340,84 @@ enum PrimerEvents: Int, CaseIterable {
         }
     }
 
+    // MARK: - Analytics Bridge
+
+    @objc
+    public func trackAnalyticsEvent(
+        _ eventName: String,
+        metadata: String?,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        DispatchQueue.main.async {
+            let metadataDict: [String: String]?
+            if let metadata = metadata,
+               let data = metadata.data(using: .utf8),
+               let dict = try? JSONSerialization.jsonObject(with: data) as? [String: String] {
+                metadataDict = dict
+            } else {
+                metadataDict = nil
+            }
+            Task { await self.analyticsLoggingBridge?.trackEvent(eventName, metadata: metadataDict) }
+            resolver(nil)
+        }
+    }
+
+    @objc
+    public func sendLog(
+        _ message: String,
+        event: String,
+        initDurationMs: NSNumber?,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        DispatchQueue.main.async {
+            let userInfo: [String: Any]? = initDurationMs.map { ["init_duration_ms": $0.intValue] }
+            Task { await self.analyticsLoggingBridge?.logInfo(message: message, event: event, userInfo: userInfo) }
+            resolver(nil)
+        }
+    }
+
+    @objc
+    // resolver + rejecter are framework-mandated on RN promise bridges.
+    // swiftlint:disable:next function_parameter_count
+    public func sendErrorLog(
+        _ message: String,
+        event: String?,
+        errorMessage: String?,
+        stack: String?,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        DispatchQueue.main.async {
+            Task {
+                await self.analyticsLoggingBridge?.logError(
+                    message: message,
+                    event: event,
+                    errorMessage: errorMessage,
+                    stack: stack
+                )
+            }
+            resolver(nil)
+        }
+    }
+
+    @objc
+    public func setupAnalyticsLoggingBridge(
+        _ clientToken: String,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        DispatchQueue.main.async {
+            let bridge = ComponentsAnalyticsLoggingBridge()
+            self.analyticsLoggingBridge = bridge
+            Task {
+                await bridge.setup(clientToken: clientToken)
+                resolver(nil)
+            }
+        }
+    }
+
     private func handleRNBridgeError(_ error: Error, checkoutData: PrimerCheckoutData?, stopOnDebug: Bool) {
         DispatchQueue.main.async {
             if stopOnDebug {
@@ -367,7 +446,10 @@ extension RNTPrimer: PrimerDelegate {
                 do {
                     let checkoutData = try JSONEncoder().encode(data)
                     let checkoutJson = try JSONSerialization.jsonObject(with: checkoutData, options: .allowFragments)
-                    self.eventDelegate.sendEvent(withName: PrimerEvents.onCheckoutComplete.stringValue, body: checkoutJson)
+                    self.eventDelegate.sendEvent(
+                        withName: PrimerEvents.onCheckoutComplete.stringValue,
+                        body: checkoutJson
+                    )
                 } catch {
                     self.handleRNBridgeError(error, checkoutData: data, stopOnDebug: true)
                 }
@@ -522,7 +604,10 @@ extension RNTPrimer: PrimerDelegate {
             }
 
             DispatchQueue.main.async {
-              self.eventDelegate.sendEvent(withName: PrimerEvents.onResumeSuccess.stringValue, body: ["resumeToken": resumeToken])
+              self.eventDelegate.sendEvent(
+                  withName: PrimerEvents.onResumeSuccess.stringValue,
+                  body: ["resumeToken": resumeToken]
+              )
             }
         } else {
             // RN dev hasn't opted in on listening the tokenization callback.

package/ios/Sources/version.swift

@@ -1,2 +1,2 @@
 // swiftlint:disable:next identifier_name
-public let PrimerReactNativeSDKVersion = "2.46.0"
+public let PrimerReactNativeSDKVersion = "3.0.0-beta.0"