feat: add support for embedded messaging disabled callback and event handling

Author: lposen

ios/RNIterableAPI/ReactIterableAPI.swift

@@ -34,6 +34,7 @@ import React
     case handleAuthSuccessCalled
     case handleAuthFailureCalled
     case handleEmbeddedMessageUpdateCalled
+    case handleEmbeddedMessagingDisabledCalled
   }
 
   @objc public static var supportedEvents: [String] {
@@ -651,11 +652,12 @@ import React
       }
 
       IterableAPI.setDeviceAttribute(name: "reactNativeSDKVersion", value: version)
-
-      // Add embedded update listener if callback is present
-      if let onEmbeddedMessageUpdatePresent = configDict["onEmbeddedMessageUpdatePresent"] as? Bool,
-        onEmbeddedMessageUpdatePresent == true
-      {
+      
+      // Add embedded update listener if any callback is present
+      let onEmbeddedMessageUpdatePresent = configDict["onEmbeddedMessageUpdatePresent"] as? Bool ?? false
+      let onEmbeddedMessagingDisabledPresent = configDict["onEmbeddedMessagingDisabledPresent"] as? Bool ?? false
+      
+      if onEmbeddedMessageUpdatePresent || onEmbeddedMessagingDisabledPresent {
         IterableAPI.embeddedManager.addUpdateListener(self)
       }
     }
@@ -826,9 +828,14 @@ extension ReactIterableAPI: IterableEmbeddedUpdateDelegate {
       withName: EventName.handleEmbeddedMessageUpdateCalled.rawValue,
       body: nil as Any?)
   }
-
+  
   public func onEmbeddedMessagingDisabled() {
     ITBInfo()
-    // This is called when embedded messaging is disabled, we don't need to do anything here for now
+    guard shouldEmit else {
+      return
+    }
+    delegate?.sendEvent(
+      withName: EventName.handleEmbeddedMessagingDisabledCalled.rawValue,
+      body: nil as Any?)
   }
 }

src/core/classes/Iterable.ts

@@ -953,6 +953,9 @@ export class Iterable {
     RNEventEmitter.removeAllListeners(
       IterableEventName.handleEmbeddedMessageUpdateCalled
     );
+    RNEventEmitter.removeAllListeners(
+      IterableEventName.handleEmbeddedMessagingDisabledCalled
+    );
   }
 
   /**
@@ -1095,6 +1098,15 @@ export class Iterable {
         }
       );
     }
+
+    if (Iterable.savedConfig.onEmbeddedMessagingDisabled) {
+      RNEventEmitter.addListener(
+        IterableEventName.handleEmbeddedMessagingDisabledCalled,
+        () => {
+          Iterable.savedConfig.onEmbeddedMessagingDisabled?.();
+        }
+      );
+    }
   }
 
   /**

src/core/classes/IterableConfig.ts

@@ -357,6 +357,24 @@ export class IterableConfig {
    */
   onEmbeddedMessageUpdate?: () => void;
 
+  /**
+   * A callback function that is called when embedded messaging is disabled.
+   *
+   * This callback is triggered when embedded messaging becomes unavailable,
+   * which can happen due to configuration issues or API errors.
+   *
+   * @example
+   * ```typescript
+   * const config = new IterableConfig();
+   * config.onEmbeddedMessagingDisabled = () => {
+   *   console.warn('Embedded messaging has been disabled');
+   *   // Hide embedded message UI or show error state
+   * };
+   * Iterable.initialize('<YOUR_API_KEY>', config);
+   * ```
+   */
+  onEmbeddedMessagingDisabled?: () => void;
+
   /**
    * Converts the IterableConfig instance to a dictionary object.
    *
@@ -402,6 +420,14 @@ export class IterableConfig {
        */
       // eslint-disable-next-line eqeqeq
       onEmbeddedMessageUpdatePresent: this.onEmbeddedMessageUpdate != undefined,
+      /**
+       * A boolean indicating if an embedded messaging disabled callback is present.
+       *
+       * TODO: Figure out if this is purposeful
+       */
+      // eslint-disable-next-line eqeqeq
+      onEmbeddedMessagingDisabledPresent:
+        this.onEmbeddedMessagingDisabled != undefined,
       /** The log level for the SDK. */
       logLevel: this.logLevel,
       expiringAuthTokenRefreshPeriod: this.expiringAuthTokenRefreshPeriod,

src/core/enums/IterableEventName.ts

@@ -21,4 +21,6 @@ export enum IterableEventName {
   handleAuthFailureCalled = 'handleAuthFailureCalled',
   /** Event that fires when embedded messages are updated */
   handleEmbeddedMessageUpdateCalled = 'handleEmbeddedMessageUpdateCalled',
+  /** Event that fires when embedded messaging is disabled */
+  handleEmbeddedMessagingDisabledCalled = 'handleEmbeddedMessagingDisabledCalled',
 }