zixflow-reactnative 1.0.0

package/ios/CustomerioReactnative.xcodeproj/project.pbxproj

@@ -0,0 +1,285 @@
+// !$*UTF8*$!
+{
+	archiveVersion = 1;
+	classes = {
+	};
+	objectVersion = 46;
+	objects = {
+
+/* Begin PBXBuildFile section */
+		F4FF95D7245B92E800C19C63 /* CustomerioReactnative.swift in Sources */ = {isa = PBXBuildFile; fileRef = F4FF95D6245B92E800C19C63 /* CustomerioReactnative.swift */; };
+		F70A0C4829CB88AF00743116 /* StringExtensions.swift in Sources */ = {isa = PBXBuildFile; fileRef = F70A0C4729CB88AF00743116 /* StringExtensions.swift */; };
+/* End PBXBuildFile section */
+
+/* Begin PBXCopyFilesBuildPhase section */
+		58B511D91A9E6C8500147676 /* CopyFiles */ = {
+			isa = PBXCopyFilesBuildPhase;
+			buildActionMask = 2147483647;
+			dstPath = "include/$(PRODUCT_NAME)";
+			dstSubfolderSpec = 16;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXCopyFilesBuildPhase section */
+
+/* Begin PBXFileReference section */
+		134814201AA4EA6300B7C361 /* libCustomerioReactnative.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libCustomerioReactnative.a; sourceTree = BUILT_PRODUCTS_DIR; };
+		4641179D284117EC00FB9CA9 /* CustomerioUtils.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CustomerioUtils.swift; sourceTree = "<group>"; };
+		B3E7B5891CC2AC0600A0062D /* CustomerioReactnative.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = CustomerioReactnative.m; sourceTree = "<group>"; };
+		F4FF95D5245B92E700C19C63 /* CustomerioReactnative-Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "CustomerioReactnative-Bridging-Header.h"; sourceTree = "<group>"; };
+		F4FF95D6245B92E800C19C63 /* CustomerioReactnative.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CustomerioReactnative.swift; sourceTree = "<group>"; };
+		F70A0C4729CB88AF00743116 /* StringExtensions.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = StringExtensions.swift; sourceTree = "<group>"; };
+/* End PBXFileReference section */
+
+/* Begin PBXFrameworksBuildPhase section */
+		58B511D81A9E6C8500147676 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+		134814211AA4EA7D00B7C361 /* Products */ = {
+			isa = PBXGroup;
+			children = (
+				134814201AA4EA6300B7C361 /* libCustomerioReactnative.a */,
+			);
+			name = Products;
+			sourceTree = "<group>";
+		};
+		58B511D21A9E6C8500147676 = {
+			isa = PBXGroup;
+			children = (
+				F70A0C4729CB88AF00743116 /* StringExtensions.swift */,
+				4641179D284117EC00FB9CA9 /* CustomerioUtils.swift */,
+				F4FF95D6245B92E800C19C63 /* CustomerioReactnative.swift */,
+				B3E7B5891CC2AC0600A0062D /* CustomerioReactnative.m */,
+				F4FF95D5245B92E700C19C63 /* CustomerioReactnative-Bridging-Header.h */,
+				134814211AA4EA7D00B7C361 /* Products */,
+			);
+			sourceTree = "<group>";
+		};
+/* End PBXGroup section */
+
+/* Begin PBXNativeTarget section */
+		58B511DA1A9E6C8500147676 /* CustomerioReactnative */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 58B511EF1A9E6C8500147676 /* Build configuration list for PBXNativeTarget "CustomerioReactnative" */;
+			buildPhases = (
+				58B511D71A9E6C8500147676 /* Sources */,
+				58B511D81A9E6C8500147676 /* Frameworks */,
+				58B511D91A9E6C8500147676 /* CopyFiles */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			name = CustomerioReactnative;
+			productName = RCTDataManager;
+			productReference = 134814201AA4EA6300B7C361 /* libCustomerioReactnative.a */;
+			productType = "com.apple.product-type.library.static";
+		};
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+		58B511D31A9E6C8500147676 /* Project object */ = {
+			isa = PBXProject;
+			attributes = {
+				LastUpgradeCheck = 0920;
+				ORGANIZATIONNAME = Facebook;
+				TargetAttributes = {
+					58B511DA1A9E6C8500147676 = {
+						CreatedOnToolsVersion = 6.1.1;
+					};
+				};
+			};
+			buildConfigurationList = 58B511D61A9E6C8500147676 /* Build configuration list for PBXProject "CustomerioReactnative" */;
+			compatibilityVersion = "Xcode 3.2";
+			developmentRegion = English;
+			hasScannedForEncodings = 0;
+			knownRegions = (
+				English,
+				en,
+			);
+			mainGroup = 58B511D21A9E6C8500147676;
+			productRefGroup = 58B511D21A9E6C8500147676;
+			projectDirPath = "";
+			projectRoot = "";
+			targets = (
+				58B511DA1A9E6C8500147676 /* CustomerioReactnative */,
+			);
+		};
+/* End PBXProject section */
+
+/* Begin PBXSourcesBuildPhase section */
+		58B511D71A9E6C8500147676 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				F70A0C4829CB88AF00743116 /* StringExtensions.swift in Sources */,
+				F4FF95D7245B92E800C19C63 /* CustomerioReactnative.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXSourcesBuildPhase section */
+
+/* Begin XCBuildConfiguration section */
+		58B511ED1A9E6C8500147676 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				COPY_PHASE_STRIP = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_SYMBOLS_PRIVATE_EXTERN = NO;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 8.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+			};
+			name = Debug;
+		};
+		58B511EE1A9E6C8500147676 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				COPY_PHASE_STRIP = YES;
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 8.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				VALIDATE_PRODUCT = YES;
+			};
+			name = Release;
+		};
+		58B511F01A9E6C8500147676 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				HEADER_SEARCH_PATHS = (
+					"$(inherited)",
+					/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include,
+					"$(SRCROOT)/../../../React/**",
+					"$(SRCROOT)/../../react-native/React/**",
+				);
+				LIBRARY_SEARCH_PATHS = "$(inherited)";
+				OTHER_LDFLAGS = "-ObjC";
+				PRODUCT_NAME = CustomerioReactnative;
+				SKIP_INSTALL = YES;
+				SWIFT_OBJC_BRIDGING_HEADER = "CustomerioReactnative-Bridging-Header.h";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+			};
+			name = Debug;
+		};
+		58B511F11A9E6C8500147676 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				HEADER_SEARCH_PATHS = (
+					"$(inherited)",
+					/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include,
+					"$(SRCROOT)/../../../React/**",
+					"$(SRCROOT)/../../react-native/React/**",
+				);
+				LIBRARY_SEARCH_PATHS = "$(inherited)";
+				OTHER_LDFLAGS = "-ObjC";
+				PRODUCT_NAME = CustomerioReactnative;
+				SKIP_INSTALL = YES;
+				SWIFT_OBJC_BRIDGING_HEADER = "CustomerioReactnative-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+			};
+			name = Release;
+		};
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+		58B511D61A9E6C8500147676 /* Build configuration list for PBXProject "CustomerioReactnative" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				58B511ED1A9E6C8500147676 /* Debug */,
+				58B511EE1A9E6C8500147676 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		58B511EF1A9E6C8500147676 /* Build configuration list for PBXNativeTarget "CustomerioReactnative" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				58B511F01A9E6C8500147676 /* Debug */,
+				58B511F11A9E6C8500147676 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+/* End XCConfigurationList section */
+	};
+	rootObject = 58B511D31A9E6C8500147676 /* Project object */;
+}

package/ios/CustomerioReactnative.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+</Workspace>

package/ios/CustomerioReactnative.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>

package/ios/wrappers/CustomerioReactnative-Bridging-Header.h

@@ -0,0 +1,2 @@
+#import <React/RCTBridgeModule.h>
+#import <React/RCTViewManager.h>

package/ios/wrappers/NativeCustomerIO.mm

@@ -0,0 +1,100 @@
+#import "utils/RCTCustomerIOUtils.h"
+#import <React/RCTBridgeModule.h>
+#import <RNZixflowSpec/RNZixflowSpec.h>
+
+// Objective-C wrapper for new architecture TurboModule implementation
+@interface RCTNativeCustomerIO : NSObject <NativeCustomerIOSpec>
+// Bridge to Swift implementation for cross-language compatibility
+@property(nonatomic, strong) id<NativeCustomerIOSpec> swiftBridge;
+@end
+
+@implementation RCTNativeCustomerIO
+
+RCT_EXPORT_MODULE()
+
+// Create TurboModule instance for new architecture JSI integration
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params {
+  return std::make_shared<facebook::react::NativeCustomerIOSpecJSI>(params);
+}
+
+// Validates Swift bridge is available before method calls
+- (void)assertBridgeAvailable:(NSString *)context {
+  RCT_ASSERT_BRIDGE_AVAILABLE(self.swiftBridge, context);
+}
+
+- (instancetype)init {
+  if (self = [super init]) {
+    // Use runtime class lookup to avoid import issues and circular dependencies
+    Class swiftClass = NSClassFromString(@"NativeCustomerIO");
+    RCT_ASSERT_NOT_NIL(swiftClass, @"NativeCustomerIO Swift class", @"during runtime lookup");
+    _swiftBridge = [[swiftClass alloc] init];
+    [self assertBridgeAvailable:@"creating NativeCustomerIO Swift instance"];
+  }
+  return self;
+}
+
+// Module initialization can happen on background thread
++ (BOOL)requiresMainQueueSetup {
+  return NO;
+}
+
+- (void)initialize:(NSDictionary *)config
+              args:(NSDictionary *)args
+           resolve:(RCTPromiseResolveBlock)resolve
+            reject:(RCTPromiseRejectBlock)reject {
+  [self assertBridgeAvailable:@"during initialize"];
+  [_swiftBridge initialize:config args:args resolve:resolve reject:reject];
+}
+
+- (void)identify:(NSDictionary *)params {
+  [self assertBridgeAvailable:@"during identify"];
+  [_swiftBridge identify:params];
+}
+
+- (void)clearIdentify {
+  [self assertBridgeAvailable:@"during clearIdentify"];
+  [_swiftBridge clearIdentify];
+}
+
+- (void)track:(NSString *)name properties:(NSDictionary *)properties {
+  [self assertBridgeAvailable:@"during track"];
+  [_swiftBridge track:name properties:properties];
+}
+
+- (void)screen:(NSString *)title properties:(NSDictionary *)properties {
+  [self assertBridgeAvailable:@"during screen"];
+  [_swiftBridge screen:title properties:properties];
+}
+
+- (void)setProfileAttributes:(NSDictionary *)attributes {
+  [self assertBridgeAvailable:@"during setProfileAttributes"];
+  [_swiftBridge setProfileAttributes:attributes];
+}
+
+- (void)setDeviceAttributes:(NSDictionary *)attributes {
+  [self assertBridgeAvailable:@"during setDeviceAttributes"];
+  [_swiftBridge setDeviceAttributes:attributes];
+}
+
+- (void)registerDeviceToken:(NSString *)token {
+  [self assertBridgeAvailable:@"during registerDeviceToken"];
+  [_swiftBridge registerDeviceToken:token];
+}
+
+- (void)trackMetric:(NSString *)deliveryID
+        deviceToken:(NSString *)deviceToken
+              event:(NSString *)event {
+  [self assertBridgeAvailable:@"during trackMetric"];
+  [_swiftBridge trackMetric:deliveryID deviceToken:deviceToken event:event];
+}
+
+- (void)deleteDeviceToken {
+  [self assertBridgeAvailable:@"during deleteDeviceToken"];
+  [_swiftBridge deleteDeviceToken];
+}
+
+// Export class factory function for React Native component registration
+Class<RCTBridgeModule> NativeCustomerIOCls(void) { return RCTNativeCustomerIO.class; }
+
+@end

package/ios/wrappers/NativeCustomerIO.swift

@@ -0,0 +1,162 @@
+import CioAnalytics
+import CioDataPipelines
+import CioInternalCommon
+import CioMessagingInApp
+
+@objc(NativeCustomerIO)
+public class NativeCustomerIO: NSObject {
+    private let logger: CioInternalCommon.Logger = DIGraphShared.shared.logger
+    /// Checks whether the CustomerIO SDK has been initialized.
+    /// Returns `true` if the SDK has been successfully initialized, `false` otherwise.
+    private var isInitialized: Bool { CustomerIO.shared.implementation != nil }
+
+    /// Ensures that the CustomerIO SDK is initialized before performing operations.
+    /// Logs an error and returns false if the SDK is not initialized.
+    private func ensureInitialized() -> Bool {
+        guard isInitialized else {
+            logger.error("CustomerIO SDK is not initialized. Please call initialize() first.")
+            return false
+        }
+        return true
+    }
+
+    @objc
+    func initialize(
+        _ config: [String: Any],
+        args: [String: Any],
+        resolve: @escaping (RCTPromiseResolveBlock),
+        reject: @escaping (RCTPromiseRejectBlock)
+    ) {
+        // Skip initialization if already initialized
+        if isInitialized {
+            logger.info("CustomerIO SDK is already initialized. Skipping initialization.")
+            resolve(true)
+            return
+        }
+
+        do {
+            let packageSource = args["packageSource"] as? String
+            let packageVersion = args["packageVersion"] as? String
+
+            // Override SDK client info to include wrapper metadata in user agent
+            if let source = packageSource, let sdkVersion = packageVersion {
+                DIGraphShared.shared.override(
+                    value: CustomerIOSdkClient(source: source, sdkVersion: sdkVersion),
+                    forType: SdkClient.self
+                )
+            }
+
+            let sdkConfigBuilder = try SDKConfigBuilder.create(from: config)
+
+            #if CIO_LOCATION_ENABLED
+            if let locationModule = NativeLocation.module(from: config) {
+                _ = sdkConfigBuilder.addModule(locationModule)
+            }
+            #endif
+
+            let builtConfig = sdkConfigBuilder.build()
+
+            // Only CustomerIO.initialize must run on the main thread (e.g. for Location module).
+            DispatchQueue.main.async { [weak self] in
+                guard let self = self else {
+                    reject(CustomerioConstants.cioTag, "Error initializing Customer.io SDK", nil)
+                    return
+                }
+                CustomerIO.initialize(withConfig: builtConfig)
+
+                do {
+                    // Initialize in-app messaging if config provided
+                    if let inAppConfig = try MessagingInAppConfigBuilder.build(from: config) {
+                        MessagingInApp.initialize(withConfig: inAppConfig)
+                        MessagingInApp.shared.setEventListener(ReactInAppEventListener.shared)
+                    }
+                } catch {
+                    self.logger.error("[InApp] Failed to initialize module with error: \(error)")
+                }
+
+                self.logger.debug(
+                    "Customer.io SDK (\(packageSource ?? "") \(packageVersion ?? "")) initialized with config: \(config)"
+                )
+                resolve(true)
+            }
+        } catch {
+            logger.error("Initializing Customer.io SDK failed with error: \(error)")
+            reject(CustomerioConstants.cioTag, "Error initializing Customer.io SDK", nil)
+        }
+    }
+
+    @objc
+    func identify(_ params: [String: Any]?) {
+        guard ensureInitialized() else { return }
+
+        let userId = params?["userId"] as? String
+        let traits = params?["traits"] as? [String: Any]
+
+        if let userId = userId {
+            // Identify with userId and optional traits
+            CustomerIO.shared.identify(userId: userId, traits: traits)
+        } else if traits != nil {
+            // Anonymous profile identification with traits only
+            if let traitsJson = try? JSON(traits as Any) {
+                CustomerIO.shared.identify(traits: traitsJson)
+            } else {
+                logger.error("Unable to parse traits to JSON: \(String(describing: traits))")
+            }
+        } else {
+            logger.error("Provide id or traits to identify a user profile.")
+        }
+    }
+
+    @objc
+    func clearIdentify() {
+        guard ensureInitialized() else { return }
+        CustomerIO.shared.clearIdentify()
+    }
+
+    @objc
+    func track(_ name: String, properties: [String: Any]?) {
+        guard ensureInitialized() else { return }
+        CustomerIO.shared.track(name: name, properties: properties)
+    }
+
+    @objc
+    func screen(_ title: String, properties: [String: Any]?) {
+        guard ensureInitialized() else { return }
+        CustomerIO.shared.screen(title: title, properties: properties)
+    }
+
+    @objc
+    func setProfileAttributes(_ attributes: [String: Any]) {
+        guard ensureInitialized() else { return }
+        CustomerIO.shared.setProfileAttributes(attributes)
+    }
+
+    @objc
+    func setDeviceAttributes(_ attributes: [String: Any]) {
+        guard ensureInitialized() else { return }
+        CustomerIO.shared.setDeviceAttributes(attributes)
+    }
+
+    @objc
+    func registerDeviceToken(_ token: String) {
+        guard ensureInitialized() else { return }
+        CustomerIO.shared.registerDeviceToken(token)
+    }
+
+    @objc
+    func trackMetric(_ deliveryId: String, deviceToken: String, event: String) {
+        guard ensureInitialized() else { return }
+        guard let metricEvent = Metric.getEvent(from: event) else {
+            logger.error("Invalid metric event: \(event)")
+            return
+        }
+
+        CustomerIO.shared.trackMetric(deliveryID: deliveryId, event: metricEvent, deviceToken: deviceToken)
+    }
+
+    @objc
+    func deleteDeviceToken() {
+        guard ensureInitialized() else { return }
+        CustomerIO.shared.deleteDeviceToken()
+    }
+}

package/ios/wrappers/inapp/InboxMessage+Conversion.swift

@@ -0,0 +1,22 @@
+import CioMessagingInApp
+import Foundation
+
+// MARK: - InboxMessage Conversion Extension
+
+extension InboxMessage {
+    /// Converts InboxMessage to dictionary for React Native bridge
+    /// Note: Uses NSNull for nil optional values to match Android behavior (explicit null vs undefined)
+    func toDictionary() -> [String: Any] {
+        return [
+            "queueId": queueId,
+            "deliveryId": deliveryId ?? NSNull(),
+            "sentAt": sentAt.timeIntervalSince1970 * 1000, // Convert to milliseconds
+            "expiry": expiry.map { $0.timeIntervalSince1970 * 1000 } ?? NSNull(),
+            "type": type,
+            "opened": opened,
+            "topics": topics,
+            "priority": priority ?? NSNull(),
+            "properties": properties
+        ]
+    }
+}