[feature] embedded messaging

android/src/main/java/com/iterable/reactnative/RNIterableAPIModule.java

@@ -482,6 +482,36 @@ public void updateVisibleRows(ReadableArray visibleRows) {
     // ---------------------------------------------------------------------------------------
     // endregion
 
+    // ---------------------------------------------------------------------------------------
+    // region Embedded APIs
+
+    @ReactMethod
+    public void getEmbeddedPlacements(Promise promise) {
+        IterableLogger.d(TAG, "getEmbeddedPlacements");
+
+        JSONArray testPlacements = new JSONArray();
+        int[] testPlacementIds = {808, 1121, 112};
+
+        try {
+            for (int placementId : testPlacementIds) {
+                testPlacements.put(createTestPlacement(placementId));
+            }
+
+            promise.resolve(Serialization.convertJsonToArray(testPlacements));
+        } catch (JSONException e) {
+            promise.reject("", "Failed to create test placements");
+        }
+    }
+
+    private JSONObject createTestPlacement(int placementId) throws JSONException {
+        JSONObject placement = new JSONObject();
+        placement.put("placementId", placementId);
+        return placement;
+    }
+
+    // ---------------------------------------------------------------------------------------
+    // endregion
+
     // ---------------------------------------------------------------------------------------
     // region Private Serialization Functions
 

android/src/main/java/com/iterable/reactnative/Serialization.java

@@ -221,6 +221,10 @@ static IterableConfig.Builder getConfigFromReadableMap(ReadableMap iterableConte
                 configBuilder.setEncryptionEnforced(iterableContextJSON.optBoolean("encryptionEnforced"));
             }
 
+            if (iterableContextJSON.has("enableEmbeddedMessaging")) {
+                configBuilder.setEnableEmbeddedMessaging(iterableContextJSON.optBoolean("enableEmbeddedMessaging"));
+            }
+
             return configBuilder;
         } catch (JSONException e) {
             e.printStackTrace();

ios/RNIterableAPI/RNIterableAPI.m

@@ -133,6 +133,11 @@ @interface RCT_EXTERN_REMAP_MODULE(RNIterableAPI, ReactIterableAPI, NSObject)
 
 RCT_EXTERN_METHOD(updateVisibleRows: (nonnull NSArray *) visibleRows)
 
+// MARK: - SDK Embedded Manager Functions
+
+RCT_EXTERN_METHOD(getEmbeddedPlacements: (RCTPromiseResolveBlock) resolve
+                  rejecter: (RCTPromiseRejectBlock) reject)
+
 // MARK: - SDK Auth Manager Functions
 
 RCT_EXTERN_METHOD(passAlongAuthToken: (NSString *) authToken)

ios/RNIterableAPI/ReactIterableAPI.swift

@@ -470,6 +470,22 @@ class ReactIterableAPI: RCTEventEmitter {
 
         inboxSessionManager.updateVisibleRows(visibleRows: serializedRows)
     }
+
+    // MARK: - SDK Embedded Manager Functions
+
+    @objc(getEmbeddedPlacements:rejecter:)
+    func getEmbeddedPlacements(resolver: @escaping RCTPromiseResolveBlock,
+                             rejecter: @escaping RCTPromiseRejectBlock) {
+        ITBInfo()
+
+        // Create test data
+        let testPlacements: [[String: Any]] = [
+            ["placementId": "meow"],
+            ["placementId": "woof woof"]
+        ]
+
+        resolver(testPlacements)
+    }
 
     // MARK: - SDK Auth Manager Functions
 

src/core/classes/IterableConfig.ts

@@ -294,6 +294,13 @@ export class IterableConfig {
    */
   encryptionEnforced = false;
 
+  /**
+   * This specifies whether the SDK should enable embedded messaging.
+   *
+   * By default, the SDK will not enable embedded messaging.
+   */
+  enableEmbeddedMessaging = false;
+
   /**
    * Converts the IterableConfig instance to a dictionary object.
    *
@@ -342,6 +349,7 @@ export class IterableConfig {
       dataRegion: this.dataRegion,
       pushPlatform: this.pushPlatform,
       encryptionEnforced: this.encryptionEnforced,
+      enableEmbeddedMessaging: this.enableEmbeddedMessaging,
     };
   }
 }

src/embedded/classes/IterableEmbeddedManager.ts

@@ -0,0 +1,24 @@
+import { NativeModules } from 'react-native';
+
+import { Iterable } from '../../core/classes/Iterable';
+import { IterableEmbeddedPlacement } from './IterableEmbeddedPlacement';
+
+const RNIterableAPI = NativeModules.RNIterableAPI;
+
+/**
+ * Manages embedded messages for the current user.
+ *
+ * This class provides methods to interact with embedded messages, including retrieving placements.
+ */
+export class IterableEmbeddedManager {
+  /**
+   * Retrieve the current user's list of embedded placements.
+   *
+   * @returns A Promise that resolves to an array of embedded placements.
+   */
+  getPlacements(): Promise<IterableEmbeddedPlacement[]> {
+    Iterable?.logger?.log('EmbeddedManager.getPlacements');
+
+    return RNIterableAPI.getEmbeddedPlacements();
+  }
+}

src/embedded/classes/IterableEmbeddedPlacement.ts

@@ -0,0 +1,11 @@
+/**
+ * Iterable embedded placement
+ * Contains placement id and the associated embedded messages
+ */
+export class IterableEmbeddedPlacement {
+  readonly placementId: number;
+
+  constructor(placementId: number) {
+    this.placementId = placementId;
+  }
+}

src/embedded/classes/index.ts

@@ -0,0 +1,2 @@
+export * from './IterableEmbeddedManager';
+export * from './IterableEmbeddedPlacement';

src/embedded/index.ts

@@ -0,0 +1 @@
+export * from './classes';

src/index.tsx

@@ -25,6 +25,10 @@ export {
   type IterableDeviceOrientation,
 } from './core/hooks';
 export { type IterableEdgeInsetDetails } from './core/types';
+export {
+  IterableEmbeddedManager,
+  IterableEmbeddedPlacement,
+} from './embedded/classes';
 export {
   IterableHtmlInAppContent,
   IterableInAppCloseSource,