infobip-mobile-messaging-react-native-plugin 13.8.1 → 13.10.0

package/android/build.gradle

@@ -87,7 +87,7 @@ repositories {
 }
 
 dependencies {
-    def mmVersion = '14.1.3'
+    def mmVersion = '14.6.0'
     //react and mm dependencies clash
     if (!overrideKotlinVersion.empty) {
         constraints {

package/android/src/main/java/org/infobip/reactlibrary/mobilemessaging/RNMMChatModule.java

@@ -28,6 +28,8 @@ import org.infobip.mobile.messaging.chat.view.styles.InAppChatInputViewStyle;
 import org.infobip.mobile.messaging.chat.view.styles.InAppChatStyle;
 import org.infobip.mobile.messaging.chat.view.styles.InAppChatTheme;
 import org.infobip.mobile.messaging.chat.view.styles.InAppChatToolbarStyle;
+import org.infobip.mobile.messaging.chat.core.InAppChatException;
+import org.infobip.mobile.messaging.chat.view.InAppChatErrorsHandler;
 import org.infobip.mobile.messaging.chat.core.widget.LivechatWidgetLanguage;
 import org.infobip.mobile.messaging.mobileapi.MobileMessagingError;
 import org.infobip.mobile.messaging.mobileapi.Result;
@@ -50,7 +52,9 @@ import java.net.URL;
 
 public class RNMMChatModule extends ReactContextBaseJavaModule implements ActivityEventListener, LifecycleEventListener {
 
-    private static final String EVENT_INAPPCHAT_JWT_REQUESTED = "inAppChat.jwtRequested";
+    private static final String EVENT_INAPPCHAT_JWT_REQUESTED = "inAppChat.internal.jwtRequested";
+    private static final String EVENT_INAPPCHAT_EXCEPTION_RECEIVED = "inAppChat.internal.exceptionReceived";
+
     private static ReactApplicationContext reactContext;
     private final ChatJwtCallbackHolder chatJwtCallbackHolder = new ChatJwtCallbackHolder();
 
@@ -72,11 +76,6 @@ public class RNMMChatModule extends ReactContextBaseJavaModule implements Activi
         InAppChat.getInstance(reactContext).inAppChatScreen().show();
     }
 
-    @ReactMethod
-    public void showThreadsList() {
-        InAppChat.getInstance(reactContext).showThreadsList();
-    }
-
     @ReactMethod
     public void getMessageCounter(final Callback successCallback) {
         successCallback.invoke(InAppChat.getInstance(reactContext).getMessageCounter());
@@ -221,6 +220,44 @@ public class RNMMChatModule extends ReactContextBaseJavaModule implements Activi
         }
     }
 
+    @ReactMethod
+    public void setChatExceptionHandler(boolean isHandlerPresent) {
+        if (isHandlerPresent) {
+            InAppChat.getInstance(reactContext).inAppChatScreen().setErrorHandler(createErrorsHandler());
+        } else {
+            InAppChat.getInstance(reactContext).inAppChatScreen().setErrorHandler(null);
+        }
+    }
+
+    private InAppChatErrorsHandler createErrorsHandler() {
+        return new InAppChatErrorsHandler() {
+            @Override
+            public void handlerError(@NonNull String error) {
+                // Deprecated method
+            }
+
+            @Override
+            public void handlerWidgetError(@NonNull String error) {
+                // Deprecated method
+            }
+
+            @Override
+            public void handlerNoInternetConnectionError(boolean hasConnection) {
+                // Deprecated method
+            }
+
+            @Override
+            public boolean handleError(@NonNull InAppChatException exception) {
+                if (reactContext != null) {
+                    ReactNativeEvent.send(EVENT_INAPPCHAT_EXCEPTION_RECEIVED, reactContext, exception.toJSON());
+                } else {
+                    Log.e(Utils.TAG, "React context is null, cannot propagate chat exception.");
+                }
+                return true;
+            }
+        };
+    }
+
     @ReactMethod
     public void setWidgetTheme(String widgetTheme) {
         if (widgetTheme != null) {

package/android/src/main/java/org/infobip/reactlibrary/mobilemessaging/RNMMChatViewManager.java

@@ -15,6 +15,8 @@ import com.facebook.react.uimanager.annotations.ReactProp;
 class RNMMChatViewManager extends ViewGroupManager<ReactChatView> {
     public static final String COMMAND_ADD = "add";
     public static final String COMMAND_REMOVE = "remove";
+    public static final String COMMAND_SHOW_THREADS_LIST = "showThreadsList";
+    public static final String COMMAND_SET_EXCEPTION_HANDLER = "setExceptionHandler";
 
     public static final String VIEW_GROUP_MANAGER_NAME = "RNMMChatView";
     private ReactApplicationContext context;
@@ -42,20 +44,19 @@ class RNMMChatViewManager extends ViewGroupManager<ReactChatView> {
     @Override
     public void receiveCommand(@NonNull ReactChatView root, String commandId, @Nullable ReadableArray args) {
         super.receiveCommand(root, commandId, args);
-
-        if (args == null) {
-            Log.e(Utils.TAG, "RNMMChatViewManager received command without argumnents, Id: " + commandId);
-            return;
-        }
-        int reactNativeViewId = args.getInt(0);
-
         switch (commandId) {
             case COMMAND_ADD:
-                addChatFragment(root, reactNativeViewId);
+                addChatFragment(root);
                 break;
             case COMMAND_REMOVE:
                 removeChatFragment(root);
                 break;
+            case COMMAND_SHOW_THREADS_LIST:
+                showThreadsList(root);
+                break;
+            case COMMAND_SET_EXCEPTION_HANDLER:
+                setExceptionHandler(root, args.getBoolean(0));
+                break;
             default: {
                 Log.w(Utils.TAG, "RNMMChatViewManager received unsupported command with Id: " + commandId);
             }
@@ -72,15 +73,27 @@ class RNMMChatViewManager extends ViewGroupManager<ReactChatView> {
         view.setSendButtonColor(hexSendButtonColor, Utils.getFragmentActivity(this.context));
     }
 
-    private void addChatFragment(FrameLayout parentLayout, int reactNativeViewId) {
+    private void addChatFragment(ReactChatView chatView) {
+        if (chatView != null) {
+            chatView.addChatFragment(this.context, Utils.getFragmentActivity(this.context));
+        }
+    }
+
+    private void removeChatFragment(ReactChatView chatView) {
+        if (chatView != null) {
+            chatView.removeChatFragment(Utils.getFragmentActivity(this.context));
+        }
+    }
+
+    private void showThreadsList(ReactChatView chatView) {
         if (chatView != null) {
-            chatView.addChatFragment(parentLayout, reactNativeViewId, Utils.getFragmentActivity(this.context));
+            chatView.showThreadsList(Utils.getFragmentActivity(this.context));
         }
     }
 
-    private void removeChatFragment(FrameLayout parentLayout) {
+    private void setExceptionHandler(ReactChatView chatView, boolean isHandlerPresent) {
         if (chatView != null) {
-            chatView.removeChatFragment(parentLayout, Utils.getFragmentActivity(this.context));
+            chatView.setExceptionHandler(isHandlerPresent, this.context, Utils.getFragmentActivity(this.context));
         }
     }
 }

package/android/src/main/java/org/infobip/reactlibrary/mobilemessaging/ReactChatView.java

@@ -5,21 +5,32 @@ import android.os.Build;
 import android.util.AttributeSet;
 import android.util.Log;
 import android.view.ViewGroup;
+import android.view.ViewParent;
 import android.widget.FrameLayout;
+import android.view.ViewTreeObserver;
 
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 import androidx.annotation.RequiresApi;
 import androidx.fragment.app.Fragment;
+import androidx.fragment.app.FragmentContainerView;
 import androidx.fragment.app.FragmentActivity;
 import androidx.fragment.app.FragmentManager;
 import androidx.fragment.app.FragmentTransaction;
 
 import org.infobip.mobile.messaging.chat.InAppChat;
 import org.infobip.mobile.messaging.chat.view.InAppChatFragment;
+import org.infobip.mobile.messaging.chat.core.InAppChatException;
+import org.infobip.mobile.messaging.chat.view.InAppChatErrorsHandler;
+
+import com.facebook.react.bridge.ReactApplicationContext;
 
 class ReactChatView extends FrameLayout {
 
+    private InAppChatFragment fragment;
+    private boolean useCustomErrorHandler = false;
+    private static final String EVENT_INAPPCHAT_EXCEPTION_RECEIVED = "inAppChat.internal.exceptionReceived";
+
     public ReactChatView(@NonNull Context context) {
         super(context);
     }
@@ -37,56 +48,131 @@ class ReactChatView extends FrameLayout {
         super(context, attrs, defStyleAttr, defStyleRes);
     }
 
-    @Override
-    public void requestLayout() {
-        super.requestLayout();
-
-        //RN issue https://github.com/facebook/react-native/issues/17968
-        //Without this layout will not be called and view will not be displayed, because RN doesn't dispatches events to android views properly
-        post(measureAndLayout);
-    }
-
     public void setSendButtonColor(String hexColorString, @Nullable FragmentActivity fragmentActivity) {
         Log.d(Utils.TAG, "Not implemented for Android, use IB_AppTheme.Chat theme instead");
     }
 
-    public void addChatFragment(FrameLayout parentLayout, int reactNativeViewId, @Nullable FragmentActivity fragmentActivity) {
-        if (fragmentActivity == null) {
-            return;
+    private InAppChatFragment getFragment(FragmentActivity fragmentActivity) {
+        if (this.fragment != null) {
+            return this.fragment;
+        }
+        if (fragmentActivity != null) {
+            FragmentManager fragmentManager = fragmentActivity.getSupportFragmentManager();
+            if (fragmentManager != null) {
+                Fragment fragment = fragmentManager.findFragmentByTag(Utils.RN_IN_APP_CHAT_FRAGMENT_TAG);
+                if (fragment instanceof InAppChatFragment) {
+                    return (InAppChatFragment) fragment;
+                }
+            } else {
+                Log.e(Utils.TAG, "FragmentManager is null, cannot get InAppChatFragment.");
+            }
+        } else {
+            Log.e(Utils.TAG, "FragmentActivity is null, cannot get InAppChatFragment.");
         }
+        return null;
+    }
 
-        //RN issue https://github.com/facebook/react-native/issues/17968
-        //Without this layout will not be called and view will not be displayed, because RN doesn't dispatches events to android views properly
-        ViewGroup parentView = (ViewGroup) parentLayout.findViewById(reactNativeViewId).getParent();
-        setupLayoutHack(parentView);
+    public void addChatFragment(@Nullable ReactApplicationContext reactContext, @Nullable FragmentActivity fragmentActivity) {
+        fragment = getFragment(fragmentActivity);
+        if (fragment == null) {
+            fragment = new InAppChatFragment();
+        }
+        fragment.setWithToolbar(false);
+        fragment.setWithInput(true);
+        if (useCustomErrorHandler && reactContext != null) {
+            fragment.setErrorsHandler(createErrorsHandler(reactContext));
+        }
 
+        ViewParent parent = this.getParent();
+        if (parent instanceof ViewGroup) {
+            setupLayoutHack((ViewGroup) parent);
+        } else {
+            Log.e(Utils.TAG, "Parent is not ViewGroup, cannot show InAppChatFragment.");
+        }
         FragmentManager fragmentManager = fragmentActivity.getSupportFragmentManager();
-        InAppChat.getInstance(fragmentActivity.getApplicationContext()).showInAppChatFragment(fragmentManager, reactNativeViewId);
-        fragmentManager.executePendingTransactions();
-        Fragment inAppChatFragment = fragmentManager.findFragmentByTag(Utils.RN_IN_APP_CHAT_FRAGMENT_TAG);
-        Log.e(Utils.TAG, "InAppChatFragment found " + (inAppChatFragment != null));
-        if (inAppChatFragment instanceof InAppChatFragment) {
-            ((InAppChatFragment) inAppChatFragment).setWithToolbar(false);
+        if (fragmentManager != null) {
+            fragmentManager.beginTransaction()
+                    .replace(this.getId(), fragment, Utils.RN_IN_APP_CHAT_FRAGMENT_TAG)
+                    .commitNow();
+        } else {
+            Log.e(Utils.TAG, "FragmentManager is null, cannot add InAppChatFragment.");
         }
     }
 
-    public void removeChatFragment(FrameLayout parentLayout, @Nullable FragmentActivity fragmentActivity) {
-        if (fragmentActivity == null) {
-            return;
-        }
+    public void removeChatFragment(@Nullable FragmentActivity fragmentActivity) {
+        useCustomErrorHandler = false;
         FragmentManager fragmentManager = fragmentActivity.getSupportFragmentManager();
-        FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
-        Fragment fragment = fragmentManager.findFragmentByTag(Utils.RN_IN_APP_CHAT_FRAGMENT_TAG);
+        Fragment fragment = getFragment(fragmentActivity);
+        if (fragment != null && fragmentManager != null) {
+            fragmentManager.beginTransaction()
+                    .remove(fragment)
+                    .commitNow();
+        } else {
+            Log.e(Utils.TAG, "InAppChatFragment or FragmentManager is null, cannot remove InAppChatFragment.");
+        }
+    }
+
+    public void showThreadsList(@Nullable FragmentActivity fragmentActivity) {
+        InAppChatFragment fragment = getFragment(fragmentActivity);
         if (fragment != null) {
-            fragmentTransaction.remove(fragment);
+            fragment.showThreadList();
+        } else {
+            Log.e(Utils.TAG, "InAppChatFragment is null, cannot show threads list.");
+        }
+    }
+
+    public void setExceptionHandler(boolean isHandlerPresent, @Nullable ReactApplicationContext reactContext, @Nullable FragmentActivity fragmentActivity) {
+        //If exception handler is set before adding the fragment, it will be applied in addChatFragment()
+        useCustomErrorHandler = isHandlerPresent;
+        InAppChatFragment fragment = getFragment(fragmentActivity);
+        if (fragment != null && reactContext != null) {
+            if (isHandlerPresent) {
+                fragment.setErrorsHandler(createErrorsHandler(reactContext));
+            } else {
+                fragment.setErrorsHandler(fragment.getDefaultErrorsHandler());
+            }
         }
-        fragmentTransaction.commit();
+    }
+
+    private InAppChatFragment.ErrorsHandler createErrorsHandler(ReactApplicationContext reactContext) {
+        return new InAppChatFragment.ErrorsHandler() {
+            @Override
+            public void handlerError(@NonNull String error) {
+                // Deprecated method
+            }
+
+            @Override
+            public void handlerWidgetError(@NonNull String error) {
+                // Deprecated method
+            }
+
+            @Override
+            public void handlerNoInternetConnectionError(boolean hasConnection) {
+                // Deprecated method
+            }
+
+            @Override
+            public boolean handleError(@NonNull InAppChatException exception) {
+                ReactNativeEvent.send(EVENT_INAPPCHAT_EXCEPTION_RECEIVED, reactContext, exception.toJSON());
+                return true;
+            }
+        };
     }
 
     private void setupLayoutHack(final ViewGroup view) {
         view.getViewTreeObserver().addOnGlobalLayoutListener(view::requestLayout);
     }
 
+    @Override
+    public void requestLayout() {
+        super.requestLayout();
+
+        // RN issue https://github.com/facebook/react-native/issues/17968
+        // Without this layout will not be called and view will not be displayed,
+        // because RN doesn't dispatches events to android views properly
+        post(measureAndLayout);
+    }
+
     private final Runnable measureAndLayout = () -> {
         measure(
                 MeasureSpec.makeMeasureSpec(getWidth(), MeasureSpec.EXACTLY),

package/infobip-mobile-messaging-react-native-plugin.podspec

@@ -1,7 +1,7 @@
 require "json"
 
 package = JSON.parse(File.read(File.join(__dir__, "package.json")))
-mmVersion = "13.11.2"
+mmVersion = "13.12.0"
 
 Pod::Spec.new do |s|
   s.name         = "infobip-mobile-messaging-react-native-plugin"

package/ios/MobileMessagingPlugin/RNMMChat.swift

@@ -11,6 +11,7 @@ import MobileMessaging
 @objc(RNMMChat)
 class RNMMChat: NSObject  {
     private var willUseJWT = false
+    private var willUseChatExceptionHandler = false
     private var jwtRequestQueue: [((String?) -> Void)] = []
     private let jwtQueueLock = NSLock()
 
@@ -143,6 +144,12 @@ class RNMMChat: NSObject  {
         willUseJWT = true
     }
 
+    @objc(setChatExceptionHandler:)
+    func setChatExceptionHandler(isHandlerPresent: NSNumber) {
+        // NSNumber due to how RN bridge wraps JavaScript booleans
+        willUseChatExceptionHandler = isHandlerPresent.boolValue
+    }
+    
     @objc(setChatJwt:)
     func setChatJwt(jwt: String?) {
         jwtQueueLock.lock()
@@ -181,4 +188,22 @@ extension RNMMChat: MMInAppChatDelegate {
         _ = semaphore.wait(timeout: .now() + 45)
         return jwtResult
     }
+    
+    @objc public func didReceiveException(_ exception: MMChatException) -> MMChatExceptionDisplayMode {
+        guard willUseChatExceptionHandler else { return .displayDefaultAlert }
+        
+        var payload: [String: Any] = [:]
+        if let message = exception.message {
+            payload["message"] = message
+        }
+        if let name = exception.name {
+            payload["name"] = name
+        }
+        payload["code"] = exception.code
+        payload["origin"] = "LiveChat"
+        payload["platform"] = "Flutter"
+        
+        ReactNativeMobileMessaging.shared?.sendEvent(withName: EventName.inAppChat_exceptionReceived, body: payload)
+        return .noDisplay
+    }
 }

package/ios/MobileMessagingPlugin/RNMMChatBridge.m

@@ -23,6 +23,7 @@ RCT_EXTERN_METHOD(setChatCustomization:)
 RCT_EXTERN_METHOD(setLanguage:(NSString *)data onSuccess:(RCTResponseSenderBlock)successCallback onError:(RCTResponseSenderBlock)errorCallback)
 RCT_EXTERN_METHOD(setChatJwt:)
 RCT_EXTERN_METHOD(setChatJwtProvider)
+RCT_EXTERN_METHOD(setChatExceptionHandler:)
 RCT_EXTERN_METHOD(sendContextualData:(NSString *)data chatMultiThreadStrategy:(NSString *)chatMultiThreadStrategy onSuccess:(RCTResponseSenderBlock)successCallback onError:(RCTResponseSenderBlock)errorCallback)
 RCT_EXTERN_METHOD(showThreadsList)
 RCT_EXTERN_METHOD(restartConnection)

package/ios/MobileMessagingPlugin/RNMobileMessaging.swift

@@ -41,7 +41,8 @@ class ReactNativeMobileMessaging: RCTEventEmitter  {
             EventName.inAppChat_viewStateChanged,
             EventName.inAppChat_configurationSynced,
             EventName.inAppChat_registrationIdUpdated,
-            EventName.inAppChat_jwtRequested
+            EventName.inAppChat_jwtRequested,
+            EventName.inAppChat_exceptionReceived
         ]
     }
     

package/ios/MobileMessagingPlugin/RNMobileMessagingUtils.swift

@@ -107,7 +107,8 @@ struct EventName {
     static let inAppChat_viewStateChanged = "inAppChat.viewStateChanged"
     static let inAppChat_configurationSynced = "inAppChat.configurationSynced"
     static let inAppChat_registrationIdUpdated = "inAppChat.livechatRegistrationIdUpdated"
-    static let inAppChat_jwtRequested = "inAppChat.jwtRequested"
+    static let inAppChat_jwtRequested = "inAppChat.internal.jwtRequested"
+    static let inAppChat_exceptionReceived = "inAppChat.internal.exceptionReceived"
 }
 
 extension UIApplication {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "infobip-mobile-messaging-react-native-plugin",
   "title": "Infobip Mobile Messaging React Native Plugin",
-  "version": "13.8.1",
+  "version": "13.10.0",
   "description": "Infobip Mobile Messaging React Native Plugin",
   "main": "./src/index.js",
   "scripts": {

package/src/components/RNMMChatViewNativeComponent.js

@@ -1,51 +1,112 @@
 import PropTypes from 'prop-types';
-import React, { FC, useLayoutEffect, useRef } from "react";
+import React, { useLayoutEffect, useRef, useImperativeHandle, forwardRef } from "react";
 import codegenNativeCommands from 'react-native/Libraries/Utilities/codegenNativeCommands';
-import {findNodeHandle, requireNativeComponent} from 'react-native'
-
-interface RNMMChatViewProps {
-    sendButtonColor: ?string
-}
+import { requireNativeComponent, Platform, NativeEventEmitter, NativeModules } from 'react-native'
+import { mobileMessaging } from 'infobip-mobile-messaging-react-native-plugin';
 
 const RNMMChatViewCommands = codegenNativeCommands({
-    supportedCommands: ["add", "remove"],
+    supportedCommands: ["add", "remove", "showThreadsList", "setExceptionHandler"],
 });
 
-export const ChatView: FC<RNMMChatViewProps> = props => {
-    const ref = useRef(null);
+
+export const ChatView = forwardRef((props, ref) => {
+    const CHAT_EVENT_EXCEPTION_RECEIVED = 'inAppChat.internal.exceptionReceived';
+    const innerRef = useRef(null);
+    let eventEmitter = new NativeEventEmitter(NativeModules.ReactNativeMobileMessaging);
+
+    useImperativeHandle(ref, () => ({
+
+        /**
+         * Navigates to THREAD_LIST view in multithread widget.
+         * @name showThreadsList
+         */
+        showThreadsList: () => {
+            if (Platform.OS === "ios") {
+                mobileMessaging.showThreadsList();
+                return;
+            }
+            // Nothing to do if there is no chatView reference.
+            let chatViewRef = innerRef.current;
+            if (!chatViewRef) return;
+            RNMMChatViewCommands.showThreadsList(chatViewRef);
+        },
+
+        /**
+         * Sets the chat exception handler in case you want to intercept and
+         * display the errors coming from the chat on your own (instead of relying on the prebuild error banners).
+         * 
+         * The `exceptionHandler` is a function that receives the exception. Passing `null` will remove the previously set handler.
+         * 
+         * ```ts
+         * chatViewRef.current?.setChatExceptionHandler((exception) => {
+         *   console.log("ChatView exception occurred:", exception);
+         * });
+         * ```
+         * 
+         * @param exceptionHandler A function that receives an ChatException when it happens. Passing `null` will remove the previously set handler.
+         * @param onError Optional error handler for catching exceptions thrown when listening for exceptions.
+         */
+        setExceptionHandler(exceptionHandler, onError) {
+            // Not needed for iOS.
+            if (Platform.OS === "ios") {
+                mobileMessaging.setChatExceptionHandler(
+                 (exception) => console.log('ChatView exception received: ' + JSON.stringify(exception)),
+                 (error) => console.log('ChatView exception handler error: ' + error)
+                );
+                return;
+            }
+
+            // Nothing to do if there is no chatView reference.
+            let chatViewRef = innerRef.current;
+            if (!chatViewRef) return;
+
+            eventEmitter.removeAllListeners(CHAT_EVENT_EXCEPTION_RECEIVED);
+            let isHandlerPresent = typeof exceptionHandler === 'function';
+            if (isHandlerPresent) {
+                const handleError = (e) => {
+                    if (onError) {
+                        onError(e);
+                    } else {
+                        console.error('[RNMobileMessaging] Could not handle chat exception:', e);
+                    }
+                };
+
+                eventEmitter.addListener(CHAT_EVENT_EXCEPTION_RECEIVED, (chatException) => {
+                    try {
+                        exceptionHandler(chatException);
+                    } catch (e) {
+                        handleError(e);
+                    }
+                });
+            }
+            RNMMChatViewCommands.setExceptionHandler(chatViewRef, isHandlerPresent);
+        }
+    }));
 
     useLayoutEffect(() => {
         // Not needed for iOS.
         if (Platform.OS === "ios") return;
 
-        const chatViewRef = ref.current
         // Nothing to do if there is no chatView reference.
+        const chatViewRef = innerRef.current;
         if (!chatViewRef) return;
 
-        let addedViewId: ?number = null
-
         // Fix for android, sometimes it can't get parent view, which is needed
         // for proper relayout.
         setTimeout(() => {
-            const viewId = findNodeHandle(chatViewRef);
-            if (viewId !== null && viewId !== undefined) {
-                RNMMChatViewCommands.add(chatViewRef, viewId);
-                console.log(`Adding android viewId: ${viewId}.`);
-                addedViewId = viewId;
-            }
+            console.log(`add command called`);
+            RNMMChatViewCommands.add(chatViewRef);
         }, 100);
 
         return () => {
-            const viewId = addedViewId
-            if (viewId !== null && viewId !== undefined) {
-                console.log(`Removing android viewId: ${viewId}.`);
-                RNMMChatViewCommands.remove(chatViewRef, viewId);
-            }
+            console.log(`remove command called`);
+            eventEmitter.removeAllListeners(CHAT_EVENT_EXCEPTION_RECEIVED);
+            RNMMChatViewCommands.remove(chatViewRef);
         };
     }, []);
 
-    return <RNMMChatView {...props} ref={ref} />;
-};
+    return <RNMMChatView {...props} ref={innerRef} />;
+});
 
 ChatView.propTypes = {
     /**

package/src/index.d.ts

@@ -265,6 +265,14 @@ declare namespace MobileMessagingReactNative {
         chatInputCursorColor: string;
     }
 
+    export interface ChatException {
+        code?: number;
+        name?: string;
+        message?: string; 
+        origin?: string;
+        platform?: string;
+    }
+
     // To be deprecated in favour of ChatCustomization above
     export interface ChatCustomizationConfiguration {
         toolbarTitle: string;
@@ -635,6 +643,7 @@ declare namespace MobileMessagingReactNative {
         resetMessageCounter(): void;
 
         /**
+         * This method is iOS only and it has no effect in Android.
          * Navigates to THREAD_LIST view in multithread widget if in-app chat is shown as React Component.
          * @name showThreadsList
          */
@@ -670,6 +679,23 @@ declare namespace MobileMessagingReactNative {
          */
         setChatJwtProvider(jwtProvider: () => string | Promise<string>, onError?: (error: Error) => void): void;
 
+        /**
+         * Sets the chat exception handler in case you want to intercept and
+         * display the errors coming from the chat on your own (instead of relying on the prebuild error banners).
+         * 
+         * The `exceptionHandler` is a function that receives the exception. Passing `null` will remove the previously set handler.
+         * 
+         * ```ts
+         * mobileMessaging.setChatExceptionHandler((exception) => {
+         *   console.log("Chat exception occurred:", exception);
+         * });
+         * ```
+         * 
+         * @param exceptionHandler A function that receives an ChatException when it happens. Passing `null` will remove the previously set handler.
+         * @param onError Optional error handler for catching exceptions thrown when listening for exceptions.
+         */
+        setChatExceptionHandler(exceptionHandler?: (exception?: ChatException) => void, onError?: (error: Error) => void): void;
+
         /**
          * Registering for POST_NOTIFICATIONS permission for Android 13+
          */

package/src/index.js

@@ -639,15 +639,19 @@ class MobileMessaging {
 
 
     /**
+     * This method is iOS only and it has no effect in Android.
      * Navigates to THREAD_LIST view in multithread widget if in-app chat is shown as React Component.
      * @name showThreadsList
      */
     showThreadsList() {
+        if (Platform.OS === "android") {
+            return;
+        }
         RNMMChat.showThreadsList();
     };
 
     /**
-     * Private global variable holding reference to android jwt update events subscription.
+     * Private global variable holding reference to jwt update events subscription.
      */
     #jwtSubscription = null;
 
@@ -696,7 +700,7 @@ class MobileMessaging {
                 }
             };
 
-            this.#jwtSubscription = this.subscribe('inAppChat.jwtRequested', () => {
+            this.#jwtSubscription = this.subscribe('inAppChat.internal.jwtRequested', () => {
                 try {
                     const jwtPromise = jwtProvider();
                     if (jwtPromise && typeof jwtPromise.then === 'function') { // Handle asynchronous JWT provider of type Promise<string>
@@ -713,6 +717,53 @@ class MobileMessaging {
         }
     }
 
+    /**
+     * Private global variable holding reference to chat exceptions subscription.
+     */
+    #chatExceptionHandlerSubscription = null;
+
+    /**
+     * Sets the chat exception handler in case you want to intercept and
+     * display the errors coming from the chat on your own (instead of relying on the prebuild error banners).
+     * 
+     * The `exceptionHandler` is a function that receives the exception. Passing `null` will remove the previously set handler.
+     * 
+     * ```ts
+     * mobileMessaging.setChatExceptionHandler((exception) => {
+     *   console.log("Chat exception occurred:", exception);
+     * });
+     * ```
+     * 
+     * @param exceptionHandler A function that receives an ChatException when it happens. Passing `null` will remove the previously set handler.
+     * @param onError Optional error handler for catching exceptions thrown when listening for exceptions.
+     */
+    setChatExceptionHandler(exceptionHandler, onError) {
+        if (this.#chatExceptionHandlerSubscription != null) {
+            this.unsubscribe(this.#chatExceptionHandlerSubscription);
+            this.#chatExceptionHandlerSubscription = null;
+        }
+
+        let isHandlerPresent = typeof exceptionHandler === 'function';
+        if (isHandlerPresent) {
+            const handleError = (e) => {
+                if (onError) {
+                    onError(e);
+                } else {
+                    console.error('[RNMobileMessaging] Could not handle chat exception:', e);
+                }
+            };
+
+            this.#chatExceptionHandlerSubscription = this.subscribe('inAppChat.internal.exceptionReceived', (chatException) => {
+                try {
+                    exceptionHandler(chatException);    
+                } catch (e) {
+                    handleError(e);
+                }
+            });
+        }
+        RNMMChat.setChatExceptionHandler(isHandlerPresent);
+    }
+
     /**
      * Registering for POST_NOTIFICATIONS permission for Android 13+
      */