[MOB-12261] Add IterableEmbeddedManager class

example/src/components/Commerce/Commerce.tsx

@@ -1,4 +1,5 @@
 import { Alert, Image, Pressable, ScrollView, Text, View } from 'react-native';
+import { SafeAreaView } from 'react-native-safe-area-context';
 
 import { Iterable, IterableCommerceItem } from '@iterable/react-native-sdk';
 
@@ -32,35 +33,37 @@ export const Commerce = () => {
   };
 
   return (
-    <ScrollView>
-      <View style={styles.container}>
-        <Text style={styles.title}>Commerce</Text>
-        <Text style={styles.subtitle}>
-          Purchase will be tracked when &quot;Buy&quot; is clicked. See logs for
-          output.
-        </Text>
-        {items.map((item) => (
-          <View key={item.id} style={styles.cardContainer}>
-            <View style={styles.infoContainer}>
-              <View style={styles.imageContainer}>
-                <Image source={item.icon} style={styles.cardImage} />
-              </View>
-              <View style={styles.textContainer}>
-                <Text style={styles.cardTitle}>{item.name}</Text>
-                <Text style={styles.cardSubtitle}>{item.subtitle}</Text>
-                <Text style={styles.price}>${item.price}</Text>
-                <Pressable
-                  style={styles.button}
-                  onPress={() => handleClick(item)}
-                >
-                  <Text style={styles.buttonText}>Buy</Text>
-                </Pressable>
+    <SafeAreaView>
+      <ScrollView>
+        <View style={styles.container}>
+          <Text style={styles.title}>Commerce</Text>
+          <Text style={styles.subtitle}>
+            Purchase will be tracked when &quot;Buy&quot; is clicked. See logs for
+            output.
+          </Text>
+          {items.map((item) => (
+            <View key={item.id} style={styles.cardContainer}>
+              <View style={styles.infoContainer}>
+                <View style={styles.imageContainer}>
+                  <Image source={item.icon} style={styles.cardImage} />
+                </View>
+                <View style={styles.textContainer}>
+                  <Text style={styles.cardTitle}>{item.name}</Text>
+                  <Text style={styles.cardSubtitle}>{item.subtitle}</Text>
+                  <Text style={styles.price}>${item.price}</Text>
+                  <Pressable
+                    style={styles.button}
+                    onPress={() => handleClick(item)}
+                  >
+                    <Text style={styles.buttonText}>Buy</Text>
+                  </Pressable>
+                </View>
               </View>
             </View>
-          </View>
-        ))}
-      </View>
-    </ScrollView>
+          ))}
+        </View>
+      </ScrollView>
+    </SafeAreaView>
   );
 };
 

example/src/components/Embedded/Embedded.tsx

@@ -1,12 +1,21 @@
-import { Text, View } from 'react-native';
+import { Iterable } from '@iterable/react-native-sdk';
+import { Text } from 'react-native';
+import { SafeAreaView } from 'react-native-safe-area-context';
 
 import styles from './Embedded.styles';
 
 export const Embedded = () => {
   return (
-    <View style={styles.container}>
+    <SafeAreaView style={styles.container}>
       <Text style={styles.text}>EMBEDDED</Text>
-    </View>
+      <Text style={styles.text}>
+        Does embedded class exist? {Iterable.embeddedManager ? 'Yes' : 'No'}
+      </Text>
+      <Text style={styles.text}>
+        Is embedded manager enabled?{' '}
+        {Iterable.embeddedManager.isEnabled ? 'Yes' : 'No'}
+      </Text>
+    </SafeAreaView>
   );
 };
 

example/src/components/Login/Login.tsx

@@ -1,11 +1,12 @@
+import { useMemo } from 'react';
 import {
   ActivityIndicator,
   Pressable,
   Text,
   TextInput,
   View,
 } from 'react-native';
-import { useMemo } from 'react';
+import { SafeAreaView } from 'react-native-safe-area-context';
 
 import { colors, type Route } from '../../constants';
 import { useIterableApp } from '../../hooks';
@@ -18,7 +19,7 @@ export const Login = ({ navigation }: RootStackScreenProps<Route.Login>) => {
   const loginIsEnabled = useMemo(() => apiKey && userId, [apiKey, userId]);
 
   return (
-    <View style={styles.loginScreenContainer}>
+    <SafeAreaView style={styles.loginScreenContainer}>
       {loginInProgress ? (
         <View style={styles.loadingContainer}>
           <ActivityIndicator size="large" color={colors.brandPurple} />
@@ -66,7 +67,7 @@ export const Login = ({ navigation }: RootStackScreenProps<Route.Login>) => {
           </View>
         </>
       )}
-    </View>
+    </SafeAreaView>
   );
 };
 

example/src/components/User/User.tsx

@@ -1,6 +1,7 @@
 import { Iterable } from '@iterable/react-native-sdk';
 import { useEffect, useState } from 'react';
-import { Text, TouchableOpacity, View } from 'react-native';
+import { Text, TouchableOpacity } from 'react-native';
+import { SafeAreaView } from 'react-native-safe-area-context';
 
 import { useIterableApp } from '../../hooks';
 import styles from './User.styles';
@@ -18,13 +19,13 @@ export const User = () => {
   }, [isLoggedIn]);
 
   return (
-    <View style={styles.container}>
+    <SafeAreaView style={styles.container}>
       <Text style={styles.appName}>Welcome Iterator</Text>
       <Text style={styles.text}>Logged in as {loggedInAs}</Text>
       <TouchableOpacity style={styles.button} onPress={logout}>
         <Text style={styles.buttonText}>Logout</Text>
       </TouchableOpacity>
-    </View>
+    </SafeAreaView>
   );
 };
 

example/src/constants/styles/typography.ts

@@ -6,7 +6,6 @@ export const appName: TextStyle = {
   fontWeight: 'bold',
   fontSize: 14,
   width: '100%',
-  marginTop: 41,
   marginBottom: 64,
   textTransform: 'uppercase',
   letterSpacing: 2,

example/src/hooks/useIterableApp.tsx

@@ -192,6 +192,8 @@ export const IterableAppProvider: FunctionComponent<
 
       config.logLevel = IterableLogLevel.debug;
 
+      config.embeddedMessagingEnabled = true;
+
       config.inAppHandler = () => IterableInAppShowResponse.show;
 
       if (

src/core/classes/Iterable.test.ts

@@ -300,37 +300,39 @@ describe('Iterable', () => {
       // WHEN config is initialized
       const config = new IterableConfig();
       // THEN config has default values
-      expect(config.pushIntegrationName).toBe(undefined);
+      expect(config.allowedProtocols).toEqual([]);
+      expect(config.androidSdkUseInMemoryStorageForInApps).toBe(false);
+      expect(config.authHandler).toBe(undefined);
       expect(config.autoPushRegistration).toBe(true);
       expect(config.checkForDeferredDeeplink).toBe(false);
-      expect(config.inAppDisplayInterval).toBe(30.0);
-      expect(config.urlHandler).toBe(undefined);
       expect(config.customActionHandler).toBe(undefined);
+      expect(config.dataRegion).toBe(IterableDataRegion.US);
+      expect(config.embeddedMessagingEnabled).toBe(false);
+      expect(config.encryptionEnforced).toBe(false);
+      expect(config.expiringAuthTokenRefreshPeriod).toBe(60.0);
+      expect(config.inAppDisplayInterval).toBe(30.0);
       expect(config.inAppHandler).toBe(undefined);
-      expect(config.authHandler).toBe(undefined);
       expect(config.logLevel).toBe(IterableLogLevel.debug);
       expect(config.logReactNativeSdkCalls).toBe(true);
-      expect(config.expiringAuthTokenRefreshPeriod).toBe(60.0);
-      expect(config.allowedProtocols).toEqual([]);
-      expect(config.androidSdkUseInMemoryStorageForInApps).toBe(false);
+      expect(config.pushIntegrationName).toBe(undefined);
+      expect(config.urlHandler).toBe(undefined);
       expect(config.useInMemoryStorageForInApps).toBe(false);
-      expect(config.dataRegion).toBe(IterableDataRegion.US);
-      expect(config.encryptionEnforced).toBe(false);
       const configDict = config.toDict();
-      expect(configDict.pushIntegrationName).toBe(undefined);
+      expect(configDict.allowedProtocols).toEqual([]);
+      expect(configDict.androidSdkUseInMemoryStorageForInApps).toBe(false);
+      expect(configDict.authHandlerPresent).toBe(false);
       expect(configDict.autoPushRegistration).toBe(true);
-      expect(configDict.inAppDisplayInterval).toBe(30.0);
-      expect(configDict.urlHandlerPresent).toBe(false);
       expect(configDict.customActionHandlerPresent).toBe(false);
+      expect(configDict.dataRegion).toBe(IterableDataRegion.US);
+      expect(configDict.embeddedMessagingEnabled).toBe(false);
+      expect(configDict.encryptionEnforced).toBe(false);
+      expect(configDict.expiringAuthTokenRefreshPeriod).toBe(60.0);
+      expect(configDict.inAppDisplayInterval).toBe(30.0);
       expect(configDict.inAppHandlerPresent).toBe(false);
-      expect(configDict.authHandlerPresent).toBe(false);
       expect(configDict.logLevel).toBe(IterableLogLevel.debug);
-      expect(configDict.expiringAuthTokenRefreshPeriod).toBe(60.0);
-      expect(configDict.allowedProtocols).toEqual([]);
-      expect(configDict.androidSdkUseInMemoryStorageForInApps).toBe(false);
+      expect(configDict.pushIntegrationName).toBe(undefined);
+      expect(configDict.urlHandlerPresent).toBe(false);
       expect(configDict.useInMemoryStorageForInApps).toBe(false);
-      expect(configDict.dataRegion).toBe(IterableDataRegion.US);
-      expect(configDict.encryptionEnforced).toBe(false);
     });
   });
 
@@ -1212,4 +1214,19 @@ describe('Iterable', () => {
       });
     });
   });
+
+  describe('embeddedManager', () => {
+    it('should be disabled by default', () => {
+      const config = new IterableConfig();
+      expect(config.embeddedMessagingEnabled).toBe(false);
+      expect(Iterable.embeddedManager.isEnabled).toBe(false);
+    });
+
+    it('should enable embeddedManager when config is set', async () => {
+      const config = new IterableConfig();
+      config.embeddedMessagingEnabled = true;
+      await Iterable.initialize('test-key', config);
+      expect(Iterable.embeddedManager.isEnabled).toBe(true);
+    });
+  });
 });

src/core/classes/Iterable.ts

@@ -20,6 +20,7 @@ import { IterableAuthResponse } from './IterableAuthResponse';
 import type { IterableCommerceItem } from './IterableCommerceItem';
 import { IterableConfig } from './IterableConfig';
 import { IterableLogger } from './IterableLogger';
+import { IterableEmbeddedManager } from '../../embedded/classes/IterableEmbeddedManager';
 
 const RNEventEmitter = new NativeEventEmitter(RNIterableAPI);
 
@@ -96,6 +97,27 @@ export class Iterable {
    */
   static authManager: IterableAuthManager = new IterableAuthManager();
 
+  /**
+   * Embedded message manager for the current user.
+   *
+   * This property provides access to embedded message functionality including
+   * retrieving messages, displaying messages, removing messages, and more.
+   *
+   * **Documentation**
+   * - [Embedded Messaging Overview](https://support.iterable.com/hc/en-us/articles/23060529977364-Embedded-Messaging-Overview)
+   * - [Android Embedded Messaging](https://support.iterable.com/hc/en-us/articles/23061877893652-Embedded-Messages-with-Iterable-s-Android-SDK)
+   * - [iOS Embedded Messaging](https://support.iterable.com/hc/en-us/articles/23061840746900-Embedded-Messages-with-Iterable-s-iOS-SDK)
+   *
+   * @example
+   * ```typescript
+   * Iterable.embeddedManager.getMessages().then(messages => {
+   *   console.log('Messages:', messages);
+   * });
+   * ```
+   */
+  static embeddedManager: IterableEmbeddedManager =
+    new IterableEmbeddedManager();
+
   /**
    * Initializes the Iterable React Native SDK in your app's Javascript or Typescript code.
    *
@@ -172,6 +194,10 @@ export class Iterable {
 
       IterableLogger.setLoggingEnabled(config.logReactNativeSdkCalls ?? true);
       IterableLogger.setLogLevel(config.logLevel);
+
+      Iterable.embeddedManager.setEnabled(
+        config.embeddedMessagingEnabled ?? false
+      );
     }
 
     this.setupEventHandlers();

src/core/classes/IterableConfig.ts

@@ -329,6 +329,16 @@ export class IterableConfig {
    */
   encryptionEnforced = false;
 
+  /**
+   * Should the SDK enable and use embedded messaging?
+   *
+   * **Documentation**
+   * - [Embedded Messaging Overview](https://support.iterable.com/hc/en-us/articles/23060529977364-Embedded-Messaging-Overview)
+   * - [Android Embedded Messaging](https://support.iterable.com/hc/en-us/articles/23061877893652-Embedded-Messages-with-Iterable-s-Android-SDK)
+   * - [iOS Embedded Messaging](https://support.iterable.com/hc/en-us/articles/23061840746900-Embedded-Messages-with-Iterable-s-iOS-SDK)
+   */
+  embeddedMessagingEnabled = false;
+
   /**
    * Converts the IterableConfig instance to a dictionary object.
    *
@@ -378,6 +388,7 @@ export class IterableConfig {
       pushPlatform: this.pushPlatform,
       encryptionEnforced: this.encryptionEnforced,
       retryPolicy: this.retryPolicy,
+      embeddedMessagingEnabled: this.embeddedMessagingEnabled,
     };
   }
 }

src/embedded/classes/IterableEmbeddedManager.test.ts

@@ -0,0 +1,59 @@
+import { IterableEmbeddedManager } from './IterableEmbeddedManager';
+
+describe('IterableEmbeddedManager', () => {
+  let embeddedManager: IterableEmbeddedManager;
+
+  beforeEach(() => {
+    embeddedManager = new IterableEmbeddedManager();
+  });
+
+  describe('isEnabled', () => {
+    it('should be false by default', () => {
+      expect(embeddedManager.isEnabled).toBe(false);
+    });
+
+    it('should return true after being enabled', () => {
+      embeddedManager.setEnabled(true);
+      expect(embeddedManager.isEnabled).toBe(true);
+    });
+
+    it('should return false after being disabled', () => {
+      embeddedManager.setEnabled(false);
+      expect(embeddedManager.isEnabled).toBe(false);
+    });
+  });
+
+  describe('setEnabled', () => {
+    it('should enable the embedded manager', () => {
+      embeddedManager.setEnabled(true);
+      expect(embeddedManager.isEnabled).toBe(true);
+    });
+
+    it('should disable the embedded manager', () => {
+      embeddedManager.setEnabled(false);
+      expect(embeddedManager.isEnabled).toBe(false);
+    });
+
+    it('should toggle enabled state multiple times', () => {
+      embeddedManager.setEnabled(true);
+      expect(embeddedManager.isEnabled).toBe(true);
+
+      embeddedManager.setEnabled(false);
+      expect(embeddedManager.isEnabled).toBe(false);
+
+      embeddedManager.setEnabled(true);
+      expect(embeddedManager.isEnabled).toBe(true);
+    });
+
+    it('should handle setting the same state multiple times', () => {
+      embeddedManager.setEnabled(true);
+      embeddedManager.setEnabled(true);
+      expect(embeddedManager.isEnabled).toBe(true);
+
+      embeddedManager.setEnabled(false);
+      embeddedManager.setEnabled(false);
+      expect(embeddedManager.isEnabled).toBe(false);
+    });
+  });
+});
+