feat: added productUserDetails support

Author: Cello Dev

README.md

@@ -213,16 +213,55 @@ Next, rebuild your app as described in the ["Adding custom native code"](https:/
 
 ---
 
-### `Cello.initialize(productId, token)`
+### `Cello.initialize()`
 
 Initializes the Cello Referral Component in your product
 
-### Options
+### API Styles
+
+The `initialize` method supports two calling styles:
+
+#### 1. Object-based API (Recommended - New)
+
+```javascript
+import Cello from '@getcello/cello-react-native';
+
+const config = await Cello.initialize({
+  productId: 'your-product-id',
+  token: 'your-token',
+  productUserDetails: {
+    firstName: 'John',
+    lastName: 'Doe',
+    fullName: 'John Doe',
+    email: 'john.doe@example.com',
+  },
+});
+```
+
+#### 2. Argument-based API (Legacy - Still Supported)
+
+```javascript
+const config = await Cello.initialize('your-product-id', 'your-token');
+```
+
+### InitializeOptions
+
+| Property           | Type               | Required | Description                       |
+| ------------------ | ------------------ | -------- | --------------------------------- |
+| productId          | string             | yes      | Your product ID from Cello Portal |
+| token              | string             | yes      | User authentication token         |
+| productUserDetails | ProductUserDetails | no       | User details object (see below)   |
+
+### ProductUserDetails
+
+Optional object with user information:
 
-| Type      | Type   | Required |
-| --------- | ------ | -------- |
-| productId | string | yes      |
-| token     | string | yes      |
+| Property  | Type   | Description          |
+| --------- | ------ | -------------------- |
+| firstName | string | User's first name    |
+| lastName  | string | User's last name     |
+| fullName  | string | User's full name     |
+| email     | string | User's email address |
 
 ### Returns
 

android/src/main/java/com/celloreactnative/CelloReactNativeModule.kt

@@ -4,7 +4,9 @@ import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReadableMap
 import com.cello.cello_sdk.Cello
+import com.cello.cello_sdk.ProductUserDetails
 import kotlinx.coroutines.*
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.bridge.WritableNativeMap
@@ -16,15 +18,29 @@ class CelloReactNativeModule(reactContext: ReactApplicationContext) :
     return NAME
   }
   @ReactMethod
-  fun initialize(productId: String, token: String, environment: String?, promise: Promise) {
+  fun initialize(productId: String, token: String, environment: String?, productUserDetailsMap: ReadableMap?, promise: Promise) {
     val activity = currentActivity ?: run {
       promise.reject("ActivityError", "Activity is null")
       return
     }
 
     CoroutineScope(Dispatchers.IO).launch {
       try {
-        Cello.initialize(activity, productId, token, environment)
+        val productUserDetails = try {
+          productUserDetailsMap?.let { map ->
+            ProductUserDetails(
+              firstName = if (map.hasKey("firstName")) map.getString("firstName") else null,
+              lastName = if (map.hasKey("lastName")) map.getString("lastName") else null,
+              fullName = if (map.hasKey("fullName")) map.getString("fullName") else null,
+              email = if (map.hasKey("email")) map.getString("email") else null
+            )
+          }
+        } catch (e: Exception) {
+          android.util.Log.w("CelloReactNative", "Failed to parse productUserDetails: ${e.message}")
+          null
+        }
+
+        Cello.initialize(activity, productId, token, environment, productUserDetails)
         withContext(Dispatchers.Main) {
           val client = Cello.client()
           if (client != null) {

ios/CelloReactNative.mm

@@ -5,6 +5,7 @@ @interface RCT_EXTERN_MODULE(CelloReactNative, NSObject)
 RCT_EXTERN_METHOD(initialize:(NSString *)productId
                  withToken:(NSString *)token
                  withEnvironment:(nullable NSString *)environment
+                 withProductUserDetails:(nullable NSDictionary *)productUserDetails
                  withResolver:(RCTPromiseResolveBlock)resolve
                  withRejecter:(RCTPromiseRejectBlock)reject)
 

ios/CelloReactNative.swift

@@ -3,12 +3,24 @@ import CelloSDK
 @objc(CelloReactNative)
 class CelloReactNative: NSObject {
 
-  @objc(initialize:withToken:withEnvironment:withResolver:withRejecter:)
-  func initialize(productId: String, token: String, environment: String?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
+  @objc(initialize:withToken:withEnvironment:withProductUserDetails:withResolver:withRejecter:)
+  func initialize(productId: String, token: String, environment: String?, productUserDetailsDict: NSDictionary?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
     let resolver = resolve
     let rejecter = reject
 
-    Cello.initialize(for: productId, with: token, environment: environment) { result in
+    let productUserDetails: ProductUserDetails?
+    if let dict = productUserDetailsDict, dict.count > 0 {
+      productUserDetails = ProductUserDetails(
+        firstName: dict["firstName"] as? String,
+        lastName: dict["lastName"] as? String,
+        fullName: dict["fullName"] as? String,
+        email: dict["email"] as? String
+      )
+    } else {
+      productUserDetails = nil
+    }
+
+    Cello.initialize(for: productId, with: token, environment: environment, productUserDetails: productUserDetails) { result in
       switch result {
         case .success(let configuration):
           resolver(configuration)

src/index.tsx

@@ -1,5 +1,19 @@
 import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
 
+export interface ProductUserDetails {
+  firstName?: string;
+  lastName?: string;
+  fullName?: string;
+  email?: string;
+}
+
+export interface InitializeOptions {
+  productId: string;
+  token: string;
+  environment?: string;
+  productUserDetails?: ProductUserDetails;
+}
+
 const LINKING_ERROR =
   `The package 'cello-react-native' doesn't seem to be linked. Make sure: \n\n` +
   Platform.select({ ios: "- You have run 'pod install'\n", default: '' }) +
@@ -28,12 +42,35 @@ const CelloEventEmitter = NativeModules.CelloEventEmitter
       }
     );
 
+function initialize(options: InitializeOptions): Promise<any>;
 function initialize(
   productId: string,
   token: string,
   environment?: string
+): Promise<any>;
+
+function initialize(
+  productIdOrOptions: string | InitializeOptions,
+  token?: string,
+  environment?: string
 ): Promise<any> {
-  return CelloReactNative.initialize(productId, token, environment);
+  if (typeof productIdOrOptions === 'object') {
+    const options = productIdOrOptions;
+    return CelloReactNative.initialize(
+      options.productId,
+      options.token,
+      options.environment,
+      options.productUserDetails
+    );
+  }
+
+  // Old API doesn't support productUserDetails, pass undefined explicitly for RN bridge
+  return CelloReactNative.initialize(
+    productIdOrOptions,
+    token!,
+    environment,
+    undefined
+  );
 }
 
 function updateToken(token: string): Promise<any> {