rn-erxes-sdk 0.3.4 → 0.4.0

package/README.md

@@ -217,6 +217,8 @@ focus so the messenger shows/hides as the user navigates, and add a header actio
 jump to another screen.
 
 ```tsx
+import { ActivityIndicator, View } from 'react-native';
+
 const isFocused = useIsFocused();
 
 <ErxesMessenger
@@ -225,6 +227,11 @@ const isFocused = useIsFocused();
   endpoint={ENDPOINT}
   displayMode="chat"
   user={CURRENT_USER}
+  renderLoading={() => (
+    <View style={{ flex: 1, justifyContent: 'center' }}>
+      <ActivityIndicator />
+    </View>
+  )}
   homeActions={[
     {
       id: 'profile',
@@ -239,6 +246,10 @@ const isFocused = useIsFocused();
 />
 ```
 
+`renderLoading` shows your own UI until the connection handshake completes
+(`onReady`). Note that chat mode also shows its own loading indicator inside the
+full-screen native view, so `renderLoading` is most useful in classic mode.
+
 ### Example 3 — Settings → Support screen with a close button
 
 Open chat on mount, hide it on unmount, and add an `X` action that closes the
@@ -283,7 +294,9 @@ messenger and pops the screen.
 | `autoHideOnUnmount` | `boolean` | Hide on unmount. Defaults to `true`. |
 | `launcherVisible` | `boolean` | Show/hide the floating launcher after configure. |
 | `homeActions` / `drawerActions` | `ErxesAction[]` | `{ id, title, systemIcon, onPress? }`. Chat mode only. |
+| `renderLoading` | `() => ReactNode` | Rendered while configuring (between `onLoad` and `onReady`/`onError`), e.g. a spinner. Defaults to nothing. |
 | `onLoad` / `onReady` / `onOpen` / `onClose` / `onError` | callbacks | Lifecycle events. |
+| `onLoadingChange` | `(loading: boolean) => void` | Fired when the loading state changes (`true` while configuring). |
 | `onAction` | `(id, helpers) => void` | Fallback for tapped actions with no `onPress`. |
 
 Action `onPress` (and `onAction`) receive `ErxesMessengerHelpers`:
@@ -350,6 +363,16 @@ const sub = ErxesNativeIOS.addActionListener((id) => {
 // sub.remove() on cleanup
 ```
 
+To know when the messenger has finished connecting (e.g. to hide your own
+spinner), listen for the ready event:
+
+```tsx
+const readySub = ErxesNativeIOS.addReadyListener(() => {
+  // connection handshake complete — messenger is ready
+});
+// readySub.remove() on cleanup
+```
+
 Chat mode also supports voice messages — see the [Native iOS guide](docs/native-ios.md) for the required `Info.plist` permissions.
 
 On logout:

package/ios/RnErxesSdk.swift

@@ -1,3 +1,4 @@
+import Combine
 import Foundation
 import MessengerSDK
 import UIKit
@@ -8,15 +9,21 @@ final class RnErxesSdk: RCTEventEmitter {
     /// JS event fired when a chat-mode action (homeActions/drawerActions) is tapped.
     private static let actionEvent = "onErxesAction"
 
+    /// JS event fired when the connect handshake completes (`MessengerSDK.isReady`).
+    private static let readyEvent = "onErxesReady"
+
     /// True while JS has at least one listener attached, so we don't emit into the void.
     private var hasListeners = false
 
+    /// Observes `MessengerSDK.shared.isReady` so we can forward readiness to JS.
+    private var readyCancellable: AnyCancellable?
+
     override static func requiresMainQueueSetup() -> Bool {
         true
     }
 
     override func supportedEvents() -> [String] {
-        [Self.actionEvent]
+        [Self.actionEvent, Self.readyEvent]
     }
 
     override func startObserving() {
@@ -62,6 +69,18 @@ final class RnErxesSdk: RCTEventEmitter {
                 self.sendEvent(withName: Self.actionEvent, body: ["id": id])
             }
 
+            // Forward the connect handshake to JS as `onErxesReady`. `$isReady`
+            // emits its current value on subscribe, so a `configure()` after the
+            // SDK is already connected still notifies JS. `removeDuplicates`
+            // collapses repeated `true`s into a single emission per connection.
+            self.readyCancellable = MessengerSDK.shared.$isReady
+                .removeDuplicates()
+                .filter { $0 }
+                .sink { [weak self] _ in
+                    guard let self, self.hasListeners else { return }
+                    self.sendEvent(withName: Self.readyEvent, body: nil)
+                }
+
             MessengerSDK.configure(
                 MessengerConfig(
                     endpoint: endpoint,

package/lib/commonjs/ErxesMessenger.js

@@ -63,17 +63,40 @@ function ErxesMessenger(_ref2) {
     launcherVisible,
     homeActions = [],
     drawerActions = [],
+    renderLoading,
     onLoad,
     onReady,
     onOpen,
     onClose,
     onError,
-    onAction
+    onAction,
+    onLoadingChange
   } = _ref2;
   // Keep the latest actions/callback in refs so the action listener (registered
   // once below) always dispatches against current props without re-subscribing.
   const actionsRef = (0, _react.useRef)([]);
   const onActionRef = (0, _react.useRef)(onAction);
+  const onLoadingChangeRef = (0, _react.useRef)(onLoadingChange);
+  // Tracks whether we believe the messenger is currently presented, so we never
+  // double-present (chat mode auto-presents inside `configure()`) or fire a
+  // redundant show/hide. Native gives us no presentation callback, so this is our
+  // best-effort intent mirror.
+  const shownRef = (0, _react.useRef)(false);
+
+  // Flips true only after native `configure()` resolves. The controlled-`visible`
+  // effect gates on this so it never calls `showMessenger()` before `configure()`
+  // (the native SDK asserts on that ordering).
+  const [configured, setConfigured] = (0, _react.useState)(false);
+  // True while configuring (between `onLoad` and `onReady`/`onError`); drives
+  // `renderLoading`.
+  const [loading, setLoading] = (0, _react.useState)(false);
+  (0, _react.useEffect)(() => {
+    onLoadingChangeRef.current = onLoadingChange;
+  }, [onLoadingChange]);
+  (0, _react.useEffect)(() => {
+    var _onLoadingChangeRef$c;
+    (_onLoadingChangeRef$c = onLoadingChangeRef.current) === null || _onLoadingChangeRef$c === void 0 ? void 0 : _onLoadingChangeRef$c.call(onLoadingChangeRef, loading);
+  }, [loading]);
   (0, _react.useEffect)(() => {
     actionsRef.current = [...homeActions, ...drawerActions];
     onActionRef.current = onAction;
@@ -82,9 +105,16 @@ function ErxesMessenger(_ref2) {
     if (_reactNative.Platform.OS !== 'ios') {
       return;
     }
+    setConfigured(false);
     const helpers = {
-      show: () => _nativeIos.ErxesNativeIOS.showMessenger(),
-      hide: () => _nativeIos.ErxesNativeIOS.hideMessenger(),
+      show: async () => {
+        await _nativeIos.ErxesNativeIOS.showMessenger();
+        shownRef.current = true;
+      },
+      hide: async () => {
+        await _nativeIos.ErxesNativeIOS.hideMessenger();
+        shownRef.current = false;
+      },
       showLauncher: () => _nativeIos.ErxesNativeIOS.showLauncher(),
       hideLauncher: () => _nativeIos.ErxesNativeIOS.hideLauncher(),
       setUser: nextUser => _nativeIos.ErxesNativeIOS.setUser(nextUser),
@@ -99,8 +129,16 @@ function ErxesMessenger(_ref2) {
       }
       await ((_onActionRef$current = onActionRef.current) === null || _onActionRef$current === void 0 ? void 0 : _onActionRef$current.call(onActionRef, id, helpers));
     });
+
+    // Connection complete (native `MessengerSDK.isReady`): the messenger is
+    // truly ready, so end the loading state and notify the host.
+    const readySub = _nativeIos.ErxesNativeIOS.addReadyListener(() => {
+      setLoading(false);
+      onReady === null || onReady === void 0 ? void 0 : onReady();
+    });
     async function setup() {
       try {
+        setLoading(true);
         onLoad === null || onLoad === void 0 ? void 0 : onLoad();
         if (user) {
           await _nativeIos.ErxesNativeIOS.setUser(user);
@@ -116,25 +154,53 @@ function ErxesMessenger(_ref2) {
           homeActions: stripActions(homeActions),
           drawerActions: stripActions(drawerActions)
         });
-        onReady === null || onReady === void 0 ? void 0 : onReady();
-        if (autoOpen) {
-          await _nativeIos.ErxesNativeIOS.showMessenger();
-          onOpen === null || onOpen === void 0 ? void 0 : onOpen();
-        }
-        if (launcherVisible === true) {
-          await _nativeIos.ErxesNativeIOS.showLauncher();
-        } else if (launcherVisible === false) {
-          await _nativeIos.ErxesNativeIOS.hideLauncher();
+
+        // `configure()` only kicks off the async connect; `onReady` and the end
+        // of `loading` are driven by the ready listener above, not here.
+
+        // Decide the initial open state. If `visible` is controlled it wins;
+        // otherwise fall back to `autoOpen` (defaults to true in chat mode).
+        const shouldOpen = visible ?? autoOpen;
+        if (displayMode === 'chat') {
+          // Chat mode auto-presents itself inside `configure()` — never call
+          // `showMessenger()` for the initial open or we'd present a second one.
+          if (shouldOpen) {
+            shownRef.current = true;
+            onOpen === null || onOpen === void 0 ? void 0 : onOpen();
+          } else {
+            // Caller wants it closed: undo the native auto-present.
+            await _nativeIos.ErxesNativeIOS.hideMessenger();
+            shownRef.current = false;
+          }
+        } else {
+          // Classic mode: configure does not open anything. Show the launcher
+          // and/or present the sheet explicitly.
+          if (launcherVisible === true) {
+            await _nativeIos.ErxesNativeIOS.showLauncher();
+          } else if (launcherVisible === false) {
+            await _nativeIos.ErxesNativeIOS.hideLauncher();
+          }
+          if (shouldOpen) {
+            await _nativeIos.ErxesNativeIOS.showMessenger();
+            shownRef.current = true;
+            onOpen === null || onOpen === void 0 ? void 0 : onOpen();
+          }
         }
+        setConfigured(true);
       } catch (error) {
+        // Setup failed before the connection could complete — end loading here
+        // since the ready listener will never fire.
+        setLoading(false);
         onError === null || onError === void 0 ? void 0 : onError(error);
       }
     }
     setup();
     return () => {
       sub.remove();
-      if (autoHideOnUnmount) {
+      readySub.remove();
+      if (autoHideOnUnmount && shownRef.current) {
         _nativeIos.ErxesNativeIOS.hideMessenger();
+        shownRef.current = false;
         onClose === null || onClose === void 0 ? void 0 : onClose();
       }
     };
@@ -143,18 +209,26 @@ function ErxesMessenger(_ref2) {
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [integrationId, endpoint, serverUrl, subDomain, displayMode]);
   (0, _react.useEffect)(() => {
-    if (_reactNative.Platform.OS !== 'ios' || visible === undefined) {
+    // Wait until `configure()` has resolved — otherwise `showMessenger()` would
+    // race ahead of it and trip the native configure-before-show assertion. The
+    // initial open is handled in `setup()`; this only reacts to later changes.
+    if (_reactNative.Platform.OS !== 'ios' || visible === undefined || !configured) {
       return;
     }
-    if (visible) {
+    if (visible && !shownRef.current) {
       _nativeIos.ErxesNativeIOS.showMessenger();
+      shownRef.current = true;
       onOpen === null || onOpen === void 0 ? void 0 : onOpen();
-    } else {
+    } else if (!visible && shownRef.current) {
       _nativeIos.ErxesNativeIOS.hideMessenger();
+      shownRef.current = false;
       onClose === null || onClose === void 0 ? void 0 : onClose();
     }
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [visible]);
+  }, [visible, configured]);
+  if (loading && renderLoading) {
+    return renderLoading();
+  }
   return null;
 }
 //# sourceMappingURL=ErxesMessenger.js.map

package/lib/commonjs/ErxesMessenger.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_reactNative","_nativeIos","stripActions","actions","map","_ref","onPress","_onPress","nativeAction","ErxesMessenger","_ref2","integrationId","endpoint","serverUrl","subDomain","displayMode","user","cachedCustomerId","primaryColor","visible","autoOpen","autoHideOnUnmount","launcherVisible","homeActions","drawerActions","onLoad","onReady","onOpen","onClose","onError","onAction","actionsRef","useRef","onActionRef","useEffect","current","Platform","OS","helpers","show","ErxesNativeIOS","showMessenger","hide","hideMessenger","showLauncher","hideLauncher","setUser","nextUser","clearUser","sub","addActionListener","id","_onActionRef$current","action","find","item","call","setup","configure","error","remove","undefined"],"sourceRoot":"../../src","sources":["ErxesMessenger.tsx"],"mappings":"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"}
+{"version":3,"names":["_react","require","_reactNative","_nativeIos","stripActions","actions","map","_ref","onPress","_onPress","nativeAction","ErxesMessenger","_ref2","integrationId","endpoint","serverUrl","subDomain","displayMode","user","cachedCustomerId","primaryColor","visible","autoOpen","autoHideOnUnmount","launcherVisible","homeActions","drawerActions","renderLoading","onLoad","onReady","onOpen","onClose","onError","onAction","onLoadingChange","actionsRef","useRef","onActionRef","onLoadingChangeRef","shownRef","configured","setConfigured","useState","loading","setLoading","useEffect","current","_onLoadingChangeRef$c","call","Platform","OS","helpers","show","ErxesNativeIOS","showMessenger","hide","hideMessenger","showLauncher","hideLauncher","setUser","nextUser","clearUser","sub","addActionListener","id","_onActionRef$current","action","find","item","readySub","addReadyListener","setup","configure","shouldOpen","error","remove","undefined"],"sourceRoot":"../../src","sources":["ErxesMessenger.tsx"],"mappings":"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"}

package/lib/commonjs/nativeIos.js

@@ -13,6 +13,9 @@ var _reactNative = require("react-native");
 
 /** Native event name emitted when a chat-mode action is tapped. */
 const ACTION_EVENT = 'onErxesAction';
+
+/** Native event name emitted when the connect handshake completes. */
+const READY_EVENT = 'onErxesReady';
 const LINKING_ERROR = "The rn-erxes-sdk native iOS module is not linked. Run `pod install` in your app's ios directory and rebuild the app.";
 const nativeModule = _reactNative.NativeModules.RnErxesSdk;
 function getNativeModule() {
@@ -65,6 +68,16 @@ const ErxesNativeIOS = {
   addActionListener(handler) {
     const emitter = new _reactNative.NativeEventEmitter(getNativeModule());
     return emitter.addListener(ACTION_EVENT, event => handler(event.id));
+  },
+  /**
+   * Listen for the connect handshake completing — i.e. the messenger is ready
+   * (`MessengerSDK.isReady`). Fires once per connection; if already connected
+   * when you subscribe via a fresh `configure`, it fires again. Returns a
+   * subscription — call `.remove()` to stop listening.
+   */
+  addReadyListener(handler) {
+    const emitter = new _reactNative.NativeEventEmitter(getNativeModule());
+    return emitter.addListener(READY_EVENT, () => handler());
   }
 };
 exports.ErxesNativeIOS = ErxesNativeIOS;

package/lib/commonjs/nativeIos.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","ACTION_EVENT","LINKING_ERROR","nativeModule","NativeModules","RnErxesSdk","getNativeModule","Platform","OS","Error","ErxesNativeIOS","configure","options","setUser","customData","Object","fromEntries","entries","filter","_ref","value","undefined","map","_ref2","key","String","clearUser","showMessenger","showLauncher","hideLauncher","hideMessenger","addActionListener","handler","emitter","NativeEventEmitter","addListener","event","id","exports"],"sourceRoot":"../../src","sources":["nativeIos.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAQA;AACA;AACA;AACA;AACA;;AA2CA;AACA,MAAMC,YAAY,GAAG,eAAe;AAEpC,MAAMC,aAAa,GACjB,sHAAsH;AAExH,MAAMC,YAAY,GAAGC,0BAAa,CAACC,UAAyC;AAE5E,SAASC,eAAeA,CAAA,EAAoB;EAC1C,IAAIC,qBAAQ,CAACC,EAAE,KAAK,KAAK,EAAE;IACzB,MAAM,IAAIC,KAAK,CAAC,kDAAkD,CAAC;EACrE;EAEA,IAAI,CAACN,YAAY,EAAE;IACjB,MAAM,IAAIM,KAAK,CAACP,aAAa,CAAC;EAChC;EAEA,OAAOC,YAAY;AACrB;AAEO,MAAMO,cAAc,GAAG;EAC5BC,SAASA,CAACC,OAAwB,EAAE;IAClC,OAAON,eAAe,CAAC,CAAC,CAACK,SAAS,CAACC,OAAO,CAAC;EAC7C,CAAC;EACDC,OAAOA,CAACD,OAAsB,EAAE;IAC9B,MAAME,UAAU,GAAGC,MAAM,CAACC,WAAW,CACnCD,MAAM,CAACE,OAAO,CAACL,OAAO,CAACE,UAAU,IAAI,CAAC,CAAC,CAAC,CACrCI,MAAM,CAACC,IAAA;MAAA,IAAC,GAAGC,KAAK,CAAC,GAAAD,IAAA;MAAA,OAAKC,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS;IAAA,EAAC,CAC5DC,GAAG,CAACC,KAAA;MAAA,IAAC,CAACC,GAAG,EAAEJ,KAAK,CAAC,GAAAG,KAAA;MAAA,OAAK,CAACC,GAAG,EAAEC,MAAM,CAACL,KAAK,CAAC,CAAC;IAAA,EAC/C,CAAC;IAED,OAAOd,eAAe,CAAC,CAAC,CAACO,OAAO,CAAC;MAC/B,GAAGD,OAAO;MACVE;IACF,CAAC,CAAC;EACJ,CAAC;EACDY,SAASA,CAAA,EAAG;IACV,OAAOpB,eAAe,CAAC,CAAC,CAACoB,SAAS,CAAC,CAAC;EACtC,CAAC;EACDC,aAAaA,CAAA,EAAG;IACd,OAAOrB,eAAe,CAAC,CAAC,CAACqB,aAAa,CAAC,CAAC;EAC1C,CAAC;EACDC,YAAYA,CAAA,EAAG;IACb,OAAOtB,eAAe,CAAC,CAAC,CAACsB,YAAY,CAAC,CAAC;EACzC,CAAC;EACDC,YAAYA,CAAA,EAAG;IACb,OAAOvB,eAAe,CAAC,CAAC,CAACuB,YAAY,CAAC,CAAC;EACzC,CAAC;EACDC,aAAaA,CAAA,EAAG;IACd,OAAOxB,eAAe,CAAC,CAAC,CAACwB,aAAa,CAAC,CAAC;EAC1C,CAAC;EACD;AACF;AACA;AACA;AACA;AACA;EACEC,iBAAiBA,CAACC,OAA6B,EAAuB;IACpE,MAAMC,OAAO,GAAG,IAAIC,+BAAkB,CACpC5B,eAAe,CAAC,CAClB,CAAC;IACD,OAAO2B,OAAO,CAACE,WAAW,CAAClC,YAAY,EAAGmC,KAAqB,IAC7DJ,OAAO,CAACI,KAAK,CAACC,EAAE,CAClB,CAAC;EACH;AACF,CAAC;AAACC,OAAA,CAAA5B,cAAA,GAAAA,cAAA"}
+{"version":3,"names":["_reactNative","require","ACTION_EVENT","READY_EVENT","LINKING_ERROR","nativeModule","NativeModules","RnErxesSdk","getNativeModule","Platform","OS","Error","ErxesNativeIOS","configure","options","setUser","customData","Object","fromEntries","entries","filter","_ref","value","undefined","map","_ref2","key","String","clearUser","showMessenger","showLauncher","hideLauncher","hideMessenger","addActionListener","handler","emitter","NativeEventEmitter","addListener","event","id","addReadyListener","exports"],"sourceRoot":"../../src","sources":["nativeIos.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAQA;AACA;AACA;AACA;AACA;;AA2CA;AACA,MAAMC,YAAY,GAAG,eAAe;;AAEpC;AACA,MAAMC,WAAW,GAAG,cAAc;AAElC,MAAMC,aAAa,GACjB,sHAAsH;AAExH,MAAMC,YAAY,GAAGC,0BAAa,CAACC,UAAyC;AAE5E,SAASC,eAAeA,CAAA,EAAoB;EAC1C,IAAIC,qBAAQ,CAACC,EAAE,KAAK,KAAK,EAAE;IACzB,MAAM,IAAIC,KAAK,CAAC,kDAAkD,CAAC;EACrE;EAEA,IAAI,CAACN,YAAY,EAAE;IACjB,MAAM,IAAIM,KAAK,CAACP,aAAa,CAAC;EAChC;EAEA,OAAOC,YAAY;AACrB;AAEO,MAAMO,cAAc,GAAG;EAC5BC,SAASA,CAACC,OAAwB,EAAE;IAClC,OAAON,eAAe,CAAC,CAAC,CAACK,SAAS,CAACC,OAAO,CAAC;EAC7C,CAAC;EACDC,OAAOA,CAACD,OAAsB,EAAE;IAC9B,MAAME,UAAU,GAAGC,MAAM,CAACC,WAAW,CACnCD,MAAM,CAACE,OAAO,CAACL,OAAO,CAACE,UAAU,IAAI,CAAC,CAAC,CAAC,CACrCI,MAAM,CAACC,IAAA;MAAA,IAAC,GAAGC,KAAK,CAAC,GAAAD,IAAA;MAAA,OAAKC,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS;IAAA,EAAC,CAC5DC,GAAG,CAACC,KAAA;MAAA,IAAC,CAACC,GAAG,EAAEJ,KAAK,CAAC,GAAAG,KAAA;MAAA,OAAK,CAACC,GAAG,EAAEC,MAAM,CAACL,KAAK,CAAC,CAAC;IAAA,EAC/C,CAAC;IAED,OAAOd,eAAe,CAAC,CAAC,CAACO,OAAO,CAAC;MAC/B,GAAGD,OAAO;MACVE;IACF,CAAC,CAAC;EACJ,CAAC;EACDY,SAASA,CAAA,EAAG;IACV,OAAOpB,eAAe,CAAC,CAAC,CAACoB,SAAS,CAAC,CAAC;EACtC,CAAC;EACDC,aAAaA,CAAA,EAAG;IACd,OAAOrB,eAAe,CAAC,CAAC,CAACqB,aAAa,CAAC,CAAC;EAC1C,CAAC;EACDC,YAAYA,CAAA,EAAG;IACb,OAAOtB,eAAe,CAAC,CAAC,CAACsB,YAAY,CAAC,CAAC;EACzC,CAAC;EACDC,YAAYA,CAAA,EAAG;IACb,OAAOvB,eAAe,CAAC,CAAC,CAACuB,YAAY,CAAC,CAAC;EACzC,CAAC;EACDC,aAAaA,CAAA,EAAG;IACd,OAAOxB,eAAe,CAAC,CAAC,CAACwB,aAAa,CAAC,CAAC;EAC1C,CAAC;EACD;AACF;AACA;AACA;AACA;AACA;EACEC,iBAAiBA,CAACC,OAA6B,EAAuB;IACpE,MAAMC,OAAO,GAAG,IAAIC,+BAAkB,CACpC5B,eAAe,CAAC,CAClB,CAAC;IACD,OAAO2B,OAAO,CAACE,WAAW,CAACnC,YAAY,EAAGoC,KAAqB,IAC7DJ,OAAO,CAACI,KAAK,CAACC,EAAE,CAClB,CAAC;EACH,CAAC;EACD;AACF;AACA;AACA;AACA;AACA;EACEC,gBAAgBA,CAACN,OAAmB,EAAuB;IACzD,MAAMC,OAAO,GAAG,IAAIC,+BAAkB,CACpC5B,eAAe,CAAC,CAClB,CAAC;IACD,OAAO2B,OAAO,CAACE,WAAW,CAAClC,WAAW,EAAE,MAAM+B,OAAO,CAAC,CAAC,CAAC;EAC1D;AACF,CAAC;AAACO,OAAA,CAAA7B,cAAA,GAAAA,cAAA"}

package/lib/module/ErxesMessenger.js

@@ -1,4 +1,4 @@
-import { useEffect, useRef } from 'react';
+import { useEffect, useRef, useState } from 'react';
 import { Platform } from 'react-native';
 import { ErxesNativeIOS } from './nativeIos';
 
@@ -58,17 +58,40 @@ export function ErxesMessenger(_ref2) {
     launcherVisible,
     homeActions = [],
     drawerActions = [],
+    renderLoading,
     onLoad,
     onReady,
     onOpen,
     onClose,
     onError,
-    onAction
+    onAction,
+    onLoadingChange
   } = _ref2;
   // Keep the latest actions/callback in refs so the action listener (registered
   // once below) always dispatches against current props without re-subscribing.
   const actionsRef = useRef([]);
   const onActionRef = useRef(onAction);
+  const onLoadingChangeRef = useRef(onLoadingChange);
+  // Tracks whether we believe the messenger is currently presented, so we never
+  // double-present (chat mode auto-presents inside `configure()`) or fire a
+  // redundant show/hide. Native gives us no presentation callback, so this is our
+  // best-effort intent mirror.
+  const shownRef = useRef(false);
+
+  // Flips true only after native `configure()` resolves. The controlled-`visible`
+  // effect gates on this so it never calls `showMessenger()` before `configure()`
+  // (the native SDK asserts on that ordering).
+  const [configured, setConfigured] = useState(false);
+  // True while configuring (between `onLoad` and `onReady`/`onError`); drives
+  // `renderLoading`.
+  const [loading, setLoading] = useState(false);
+  useEffect(() => {
+    onLoadingChangeRef.current = onLoadingChange;
+  }, [onLoadingChange]);
+  useEffect(() => {
+    var _onLoadingChangeRef$c;
+    (_onLoadingChangeRef$c = onLoadingChangeRef.current) === null || _onLoadingChangeRef$c === void 0 ? void 0 : _onLoadingChangeRef$c.call(onLoadingChangeRef, loading);
+  }, [loading]);
   useEffect(() => {
     actionsRef.current = [...homeActions, ...drawerActions];
     onActionRef.current = onAction;
@@ -77,9 +100,16 @@ export function ErxesMessenger(_ref2) {
     if (Platform.OS !== 'ios') {
       return;
     }
+    setConfigured(false);
     const helpers = {
-      show: () => ErxesNativeIOS.showMessenger(),
-      hide: () => ErxesNativeIOS.hideMessenger(),
+      show: async () => {
+        await ErxesNativeIOS.showMessenger();
+        shownRef.current = true;
+      },
+      hide: async () => {
+        await ErxesNativeIOS.hideMessenger();
+        shownRef.current = false;
+      },
       showLauncher: () => ErxesNativeIOS.showLauncher(),
       hideLauncher: () => ErxesNativeIOS.hideLauncher(),
       setUser: nextUser => ErxesNativeIOS.setUser(nextUser),
@@ -94,8 +124,16 @@ export function ErxesMessenger(_ref2) {
       }
       await ((_onActionRef$current = onActionRef.current) === null || _onActionRef$current === void 0 ? void 0 : _onActionRef$current.call(onActionRef, id, helpers));
     });
+
+    // Connection complete (native `MessengerSDK.isReady`): the messenger is
+    // truly ready, so end the loading state and notify the host.
+    const readySub = ErxesNativeIOS.addReadyListener(() => {
+      setLoading(false);
+      onReady === null || onReady === void 0 ? void 0 : onReady();
+    });
     async function setup() {
       try {
+        setLoading(true);
         onLoad === null || onLoad === void 0 ? void 0 : onLoad();
         if (user) {
           await ErxesNativeIOS.setUser(user);
@@ -111,25 +149,53 @@ export function ErxesMessenger(_ref2) {
           homeActions: stripActions(homeActions),
           drawerActions: stripActions(drawerActions)
         });
-        onReady === null || onReady === void 0 ? void 0 : onReady();
-        if (autoOpen) {
-          await ErxesNativeIOS.showMessenger();
-          onOpen === null || onOpen === void 0 ? void 0 : onOpen();
-        }
-        if (launcherVisible === true) {
-          await ErxesNativeIOS.showLauncher();
-        } else if (launcherVisible === false) {
-          await ErxesNativeIOS.hideLauncher();
+
+        // `configure()` only kicks off the async connect; `onReady` and the end
+        // of `loading` are driven by the ready listener above, not here.
+
+        // Decide the initial open state. If `visible` is controlled it wins;
+        // otherwise fall back to `autoOpen` (defaults to true in chat mode).
+        const shouldOpen = visible ?? autoOpen;
+        if (displayMode === 'chat') {
+          // Chat mode auto-presents itself inside `configure()` — never call
+          // `showMessenger()` for the initial open or we'd present a second one.
+          if (shouldOpen) {
+            shownRef.current = true;
+            onOpen === null || onOpen === void 0 ? void 0 : onOpen();
+          } else {
+            // Caller wants it closed: undo the native auto-present.
+            await ErxesNativeIOS.hideMessenger();
+            shownRef.current = false;
+          }
+        } else {
+          // Classic mode: configure does not open anything. Show the launcher
+          // and/or present the sheet explicitly.
+          if (launcherVisible === true) {
+            await ErxesNativeIOS.showLauncher();
+          } else if (launcherVisible === false) {
+            await ErxesNativeIOS.hideLauncher();
+          }
+          if (shouldOpen) {
+            await ErxesNativeIOS.showMessenger();
+            shownRef.current = true;
+            onOpen === null || onOpen === void 0 ? void 0 : onOpen();
+          }
         }
+        setConfigured(true);
       } catch (error) {
+        // Setup failed before the connection could complete — end loading here
+        // since the ready listener will never fire.
+        setLoading(false);
         onError === null || onError === void 0 ? void 0 : onError(error);
       }
     }
     setup();
     return () => {
       sub.remove();
-      if (autoHideOnUnmount) {
+      readySub.remove();
+      if (autoHideOnUnmount && shownRef.current) {
         ErxesNativeIOS.hideMessenger();
+        shownRef.current = false;
         onClose === null || onClose === void 0 ? void 0 : onClose();
       }
     };
@@ -138,18 +204,26 @@ export function ErxesMessenger(_ref2) {
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [integrationId, endpoint, serverUrl, subDomain, displayMode]);
   useEffect(() => {
-    if (Platform.OS !== 'ios' || visible === undefined) {
+    // Wait until `configure()` has resolved — otherwise `showMessenger()` would
+    // race ahead of it and trip the native configure-before-show assertion. The
+    // initial open is handled in `setup()`; this only reacts to later changes.
+    if (Platform.OS !== 'ios' || visible === undefined || !configured) {
       return;
     }
-    if (visible) {
+    if (visible && !shownRef.current) {
       ErxesNativeIOS.showMessenger();
+      shownRef.current = true;
       onOpen === null || onOpen === void 0 ? void 0 : onOpen();
-    } else {
+    } else if (!visible && shownRef.current) {
       ErxesNativeIOS.hideMessenger();
+      shownRef.current = false;
       onClose === null || onClose === void 0 ? void 0 : onClose();
     }
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [visible]);
+  }, [visible, configured]);
+  if (loading && renderLoading) {
+    return renderLoading();
+  }
   return null;
 }
 //# sourceMappingURL=ErxesMessenger.js.map

package/lib/module/ErxesMessenger.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useRef","Platform","ErxesNativeIOS","stripActions","actions","map","_ref","onPress","_onPress","nativeAction","ErxesMessenger","_ref2","integrationId","endpoint","serverUrl","subDomain","displayMode","user","cachedCustomerId","primaryColor","visible","autoOpen","autoHideOnUnmount","launcherVisible","homeActions","drawerActions","onLoad","onReady","onOpen","onClose","onError","onAction","actionsRef","onActionRef","current","OS","helpers","show","showMessenger","hide","hideMessenger","showLauncher","hideLauncher","setUser","nextUser","clearUser","sub","addActionListener","id","_onActionRef$current","action","find","item","call","setup","configure","error","remove","undefined"],"sourceRoot":"../../src","sources":["ErxesMessenger.tsx"],"mappings":"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"}
+{"version":3,"names":["useEffect","useRef","useState","Platform","ErxesNativeIOS","stripActions","actions","map","_ref","onPress","_onPress","nativeAction","ErxesMessenger","_ref2","integrationId","endpoint","serverUrl","subDomain","displayMode","user","cachedCustomerId","primaryColor","visible","autoOpen","autoHideOnUnmount","launcherVisible","homeActions","drawerActions","renderLoading","onLoad","onReady","onOpen","onClose","onError","onAction","onLoadingChange","actionsRef","onActionRef","onLoadingChangeRef","shownRef","configured","setConfigured","loading","setLoading","current","_onLoadingChangeRef$c","call","OS","helpers","show","showMessenger","hide","hideMessenger","showLauncher","hideLauncher","setUser","nextUser","clearUser","sub","addActionListener","id","_onActionRef$current","action","find","item","readySub","addReadyListener","setup","configure","shouldOpen","error","remove","undefined"],"sourceRoot":"../../src","sources":["ErxesMessenger.tsx"],"mappings":"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"}

package/lib/module/nativeIos.js

@@ -8,6 +8,9 @@ import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
 
 /** Native event name emitted when a chat-mode action is tapped. */
 const ACTION_EVENT = 'onErxesAction';
+
+/** Native event name emitted when the connect handshake completes. */
+const READY_EVENT = 'onErxesReady';
 const LINKING_ERROR = "The rn-erxes-sdk native iOS module is not linked. Run `pod install` in your app's ios directory and rebuild the app.";
 const nativeModule = NativeModules.RnErxesSdk;
 function getNativeModule() {
@@ -60,6 +63,16 @@ export const ErxesNativeIOS = {
   addActionListener(handler) {
     const emitter = new NativeEventEmitter(getNativeModule());
     return emitter.addListener(ACTION_EVENT, event => handler(event.id));
+  },
+  /**
+   * Listen for the connect handshake completing — i.e. the messenger is ready
+   * (`MessengerSDK.isReady`). Fires once per connection; if already connected
+   * when you subscribe via a fresh `configure`, it fires again. Returns a
+   * subscription — call `.remove()` to stop listening.
+   */
+  addReadyListener(handler) {
+    const emitter = new NativeEventEmitter(getNativeModule());
+    return emitter.addListener(READY_EVENT, () => handler());
   }
 };
 //# sourceMappingURL=nativeIos.js.map

package/lib/module/nativeIos.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","NativeModules","Platform","ACTION_EVENT","LINKING_ERROR","nativeModule","RnErxesSdk","getNativeModule","OS","Error","ErxesNativeIOS","configure","options","setUser","customData","Object","fromEntries","entries","filter","_ref","value","undefined","map","_ref2","key","String","clearUser","showMessenger","showLauncher","hideLauncher","hideMessenger","addActionListener","handler","emitter","addListener","event","id"],"sourceRoot":"../../src","sources":["nativeIos.ts"],"mappings":"AAAA,SACEA,kBAAkB,EAClBC,aAAa,EACbC,QAAQ,QAGH,cAAc;;AAErB;AACA;AACA;AACA;AACA;;AA2CA;AACA,MAAMC,YAAY,GAAG,eAAe;AAEpC,MAAMC,aAAa,GACjB,sHAAsH;AAExH,MAAMC,YAAY,GAAGJ,aAAa,CAACK,UAAyC;AAE5E,SAASC,eAAeA,CAAA,EAAoB;EAC1C,IAAIL,QAAQ,CAACM,EAAE,KAAK,KAAK,EAAE;IACzB,MAAM,IAAIC,KAAK,CAAC,kDAAkD,CAAC;EACrE;EAEA,IAAI,CAACJ,YAAY,EAAE;IACjB,MAAM,IAAII,KAAK,CAACL,aAAa,CAAC;EAChC;EAEA,OAAOC,YAAY;AACrB;AAEA,OAAO,MAAMK,cAAc,GAAG;EAC5BC,SAASA,CAACC,OAAwB,EAAE;IAClC,OAAOL,eAAe,CAAC,CAAC,CAACI,SAAS,CAACC,OAAO,CAAC;EAC7C,CAAC;EACDC,OAAOA,CAACD,OAAsB,EAAE;IAC9B,MAAME,UAAU,GAAGC,MAAM,CAACC,WAAW,CACnCD,MAAM,CAACE,OAAO,CAACL,OAAO,CAACE,UAAU,IAAI,CAAC,CAAC,CAAC,CACrCI,MAAM,CAACC,IAAA;MAAA,IAAC,GAAGC,KAAK,CAAC,GAAAD,IAAA;MAAA,OAAKC,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS;IAAA,EAAC,CAC5DC,GAAG,CAACC,KAAA;MAAA,IAAC,CAACC,GAAG,EAAEJ,KAAK,CAAC,GAAAG,KAAA;MAAA,OAAK,CAACC,GAAG,EAAEC,MAAM,CAACL,KAAK,CAAC,CAAC;IAAA,EAC/C,CAAC;IAED,OAAOb,eAAe,CAAC,CAAC,CAACM,OAAO,CAAC;MAC/B,GAAGD,OAAO;MACVE;IACF,CAAC,CAAC;EACJ,CAAC;EACDY,SAASA,CAAA,EAAG;IACV,OAAOnB,eAAe,CAAC,CAAC,CAACmB,SAAS,CAAC,CAAC;EACtC,CAAC;EACDC,aAAaA,CAAA,EAAG;IACd,OAAOpB,eAAe,CAAC,CAAC,CAACoB,aAAa,CAAC,CAAC;EAC1C,CAAC;EACDC,YAAYA,CAAA,EAAG;IACb,OAAOrB,eAAe,CAAC,CAAC,CAACqB,YAAY,CAAC,CAAC;EACzC,CAAC;EACDC,YAAYA,CAAA,EAAG;IACb,OAAOtB,eAAe,CAAC,CAAC,CAACsB,YAAY,CAAC,CAAC;EACzC,CAAC;EACDC,aAAaA,CAAA,EAAG;IACd,OAAOvB,eAAe,CAAC,CAAC,CAACuB,aAAa,CAAC,CAAC;EAC1C,CAAC;EACD;AACF;AACA;AACA;AACA;AACA;EACEC,iBAAiBA,CAACC,OAA6B,EAAuB;IACpE,MAAMC,OAAO,GAAG,IAAIjC,kBAAkB,CACpCO,eAAe,CAAC,CAClB,CAAC;IACD,OAAO0B,OAAO,CAACC,WAAW,CAAC/B,YAAY,EAAGgC,KAAqB,IAC7DH,OAAO,CAACG,KAAK,CAACC,EAAE,CAClB,CAAC;EACH;AACF,CAAC"}
+{"version":3,"names":["NativeEventEmitter","NativeModules","Platform","ACTION_EVENT","READY_EVENT","LINKING_ERROR","nativeModule","RnErxesSdk","getNativeModule","OS","Error","ErxesNativeIOS","configure","options","setUser","customData","Object","fromEntries","entries","filter","_ref","value","undefined","map","_ref2","key","String","clearUser","showMessenger","showLauncher","hideLauncher","hideMessenger","addActionListener","handler","emitter","addListener","event","id","addReadyListener"],"sourceRoot":"../../src","sources":["nativeIos.ts"],"mappings":"AAAA,SACEA,kBAAkB,EAClBC,aAAa,EACbC,QAAQ,QAGH,cAAc;;AAErB;AACA;AACA;AACA;AACA;;AA2CA;AACA,MAAMC,YAAY,GAAG,eAAe;;AAEpC;AACA,MAAMC,WAAW,GAAG,cAAc;AAElC,MAAMC,aAAa,GACjB,sHAAsH;AAExH,MAAMC,YAAY,GAAGL,aAAa,CAACM,UAAyC;AAE5E,SAASC,eAAeA,CAAA,EAAoB;EAC1C,IAAIN,QAAQ,CAACO,EAAE,KAAK,KAAK,EAAE;IACzB,MAAM,IAAIC,KAAK,CAAC,kDAAkD,CAAC;EACrE;EAEA,IAAI,CAACJ,YAAY,EAAE;IACjB,MAAM,IAAII,KAAK,CAACL,aAAa,CAAC;EAChC;EAEA,OAAOC,YAAY;AACrB;AAEA,OAAO,MAAMK,cAAc,GAAG;EAC5BC,SAASA,CAACC,OAAwB,EAAE;IAClC,OAAOL,eAAe,CAAC,CAAC,CAACI,SAAS,CAACC,OAAO,CAAC;EAC7C,CAAC;EACDC,OAAOA,CAACD,OAAsB,EAAE;IAC9B,MAAME,UAAU,GAAGC,MAAM,CAACC,WAAW,CACnCD,MAAM,CAACE,OAAO,CAACL,OAAO,CAACE,UAAU,IAAI,CAAC,CAAC,CAAC,CACrCI,MAAM,CAACC,IAAA;MAAA,IAAC,GAAGC,KAAK,CAAC,GAAAD,IAAA;MAAA,OAAKC,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS;IAAA,EAAC,CAC5DC,GAAG,CAACC,KAAA;MAAA,IAAC,CAACC,GAAG,EAAEJ,KAAK,CAAC,GAAAG,KAAA;MAAA,OAAK,CAACC,GAAG,EAAEC,MAAM,CAACL,KAAK,CAAC,CAAC;IAAA,EAC/C,CAAC;IAED,OAAOb,eAAe,CAAC,CAAC,CAACM,OAAO,CAAC;MAC/B,GAAGD,OAAO;MACVE;IACF,CAAC,CAAC;EACJ,CAAC;EACDY,SAASA,CAAA,EAAG;IACV,OAAOnB,eAAe,CAAC,CAAC,CAACmB,SAAS,CAAC,CAAC;EACtC,CAAC;EACDC,aAAaA,CAAA,EAAG;IACd,OAAOpB,eAAe,CAAC,CAAC,CAACoB,aAAa,CAAC,CAAC;EAC1C,CAAC;EACDC,YAAYA,CAAA,EAAG;IACb,OAAOrB,eAAe,CAAC,CAAC,CAACqB,YAAY,CAAC,CAAC;EACzC,CAAC;EACDC,YAAYA,CAAA,EAAG;IACb,OAAOtB,eAAe,CAAC,CAAC,CAACsB,YAAY,CAAC,CAAC;EACzC,CAAC;EACDC,aAAaA,CAAA,EAAG;IACd,OAAOvB,eAAe,CAAC,CAAC,CAACuB,aAAa,CAAC,CAAC;EAC1C,CAAC;EACD;AACF;AACA;AACA;AACA;AACA;EACEC,iBAAiBA,CAACC,OAA6B,EAAuB;IACpE,MAAMC,OAAO,GAAG,IAAIlC,kBAAkB,CACpCQ,eAAe,CAAC,CAClB,CAAC;IACD,OAAO0B,OAAO,CAACC,WAAW,CAAChC,YAAY,EAAGiC,KAAqB,IAC7DH,OAAO,CAACG,KAAK,CAACC,EAAE,CAClB,CAAC;EACH,CAAC;EACD;AACF;AACA;AACA;AACA;AACA;EACEC,gBAAgBA,CAACL,OAAmB,EAAuB;IACzD,MAAMC,OAAO,GAAG,IAAIlC,kBAAkB,CACpCQ,eAAe,CAAC,CAClB,CAAC;IACD,OAAO0B,OAAO,CAACC,WAAW,CAAC/B,WAAW,EAAE,MAAM6B,OAAO,CAAC,CAAC,CAAC;EAC1D;AACF,CAAC"}

package/lib/typescript/ErxesMessenger.d.ts

@@ -1,3 +1,4 @@
+import { type ReactNode } from 'react';
 import { type NativeIOSUser } from './nativeIos';
 /**
  * The identified end user. Same shape the native bridge expects — passing
@@ -61,10 +62,18 @@ export type ErxesMessengerProps = {
     homeActions?: ErxesAction[];
     /** Chat-mode drawer top action rows. Ignored in `'classic'`. */
     drawerActions?: ErxesAction[];
+    /**
+     * Rendered while the SDK is configuring (between `onLoad` and
+     * `onReady`/`onError`), e.g. a spinner shown before the native messenger
+     * appears. Returns `null` otherwise. Defaults to rendering nothing.
+     */
+    renderLoading?: () => ReactNode;
     /** Fired when setup starts. */
     onLoad?: () => void;
-    /** Fired after native `configure` succeeds. */
+    /** Fired when the connection handshake completes (the messenger is ready). */
     onReady?: () => void;
+    /** Fired when the loading state changes (`true` while configuring). */
+    onLoadingChange?: (loading: boolean) => void;
     /** Fired when the messenger is shown. */
     onOpen?: () => void;
     /** Fired when the messenger is hidden. */
@@ -82,5 +91,5 @@ export type ErxesMessengerProps = {
  *
  * For advanced/imperative control, use `ErxesNativeIOS` directly.
  */
-export declare function ErxesMessenger({ integrationId, endpoint, serverUrl, subDomain, displayMode, user, cachedCustomerId, primaryColor, visible, autoOpen, autoHideOnUnmount, launcherVisible, homeActions, drawerActions, onLoad, onReady, onOpen, onClose, onError, onAction, }: ErxesMessengerProps): null;
+export declare function ErxesMessenger({ integrationId, endpoint, serverUrl, subDomain, displayMode, user, cachedCustomerId, primaryColor, visible, autoOpen, autoHideOnUnmount, launcherVisible, homeActions, drawerActions, renderLoading, onLoad, onReady, onOpen, onClose, onError, onAction, onLoadingChange, }: ErxesMessengerProps): ReactNode;
 //# sourceMappingURL=ErxesMessenger.d.ts.map

package/lib/typescript/ErxesMessenger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErxesMessenger.d.ts","sourceRoot":"","sources":["../../src/ErxesMessenger.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ErxesMessenger.d.ts","sourceRoot":"","sources":["../../src/ErxesMessenger.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGpE,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC;AAEtC;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IAEtB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAEjC,2CAA2C;IAC3C,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;IAC5B,gEAAgE;IAChE,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAE9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,SAAS,CAAC;IAEhC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,uEAAuE;IACvE,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,wCAAwC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,CACT,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,qBAAqB,KAC3B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAWF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAC7B,aAAa,EACb,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAuB,EACvB,IAAI,EACJ,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,QAAiC,EACjC,iBAAwB,EACxB,eAAe,EACf,WAAgB,EAChB,aAAkB,EAClB,aAAa,EACb,MAAM,EACN,OAAO,EACP,MAAM,EACN,OAAO,EACP,OAAO,EACP,QAAQ,EACR,eAAe,GAChB,EAAE,mBAAmB,aAmLrB"}

package/lib/typescript/nativeIos.d.ts

@@ -48,6 +48,13 @@ export declare const ErxesNativeIOS: {
      * to stop listening.
      */
     addActionListener(handler: (id: string) => void): EmitterSubscription;
+    /**
+     * Listen for the connect handshake completing — i.e. the messenger is ready
+     * (`MessengerSDK.isReady`). Fires once per connection; if already connected
+     * when you subscribe via a fresh `configure`, it fires again. Returns a
+     * subscription — call `.remove()` to stop listening.
+     */
+    addReadyListener(handler: () => void): EmitterSubscription;
 };
 export type { NativeIOSAction, NativeIOSConfig, NativeIOSUser };
 //# sourceMappingURL=nativeIos.d.ts.map

package/lib/typescript/nativeIos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nativeIos.d.ts","sourceRoot":"","sources":["../../src/nativeIos.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,mBAAmB,EAEzB,MAAM,cAAc,CAAC;AAEtB;;;;GAIG;AACH,KAAK,eAAe,GAAG;IACrB,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACjC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,gEAAgE;IAChE,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CAC3E,CAAC;AAgCF,eAAO,MAAM,cAAc;uBACN,eAAe;qBAGjB,aAAa;;;;;;IA2B9B;;;;;OAKG;oCAC6B,MAAM,KAAK,IAAI,GAAG,mBAAmB;CAQtE,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"nativeIos.d.ts","sourceRoot":"","sources":["../../src/nativeIos.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,mBAAmB,EAEzB,MAAM,cAAc,CAAC;AAEtB;;;;GAIG;AACH,KAAK,eAAe,GAAG;IACrB,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACjC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,gEAAgE;IAChE,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CAC3E,CAAC;AAmCF,eAAO,MAAM,cAAc;uBACN,eAAe;qBAGjB,aAAa;;;;;;IA2B9B;;;;;OAKG;oCAC6B,MAAM,KAAK,IAAI,GAAG,mBAAmB;IAQrE;;;;;OAKG;8BACuB,MAAM,IAAI,GAAG,mBAAmB;CAM3D,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rn-erxes-sdk",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "react-native erxes sdk",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/ErxesMessenger.tsx

@@ -1,4 +1,4 @@
-import { useEffect, useRef } from 'react';
+import { useEffect, useRef, useState, type ReactNode } from 'react';
 import { Platform } from 'react-native';
 
 import { ErxesNativeIOS, type NativeIOSUser } from './nativeIos';
@@ -75,10 +75,19 @@ export type ErxesMessengerProps = {
   /** Chat-mode drawer top action rows. Ignored in `'classic'`. */
   drawerActions?: ErxesAction[];
 
+  /**
+   * Rendered while the SDK is configuring (between `onLoad` and
+   * `onReady`/`onError`), e.g. a spinner shown before the native messenger
+   * appears. Returns `null` otherwise. Defaults to rendering nothing.
+   */
+  renderLoading?: () => ReactNode;
+
   /** Fired when setup starts. */
   onLoad?: () => void;
-  /** Fired after native `configure` succeeds. */
+  /** Fired when the connection handshake completes (the messenger is ready). */
   onReady?: () => void;
+  /** Fired when the loading state changes (`true` while configuring). */
+  onLoadingChange?: (loading: boolean) => void;
   /** Fired when the messenger is shown. */
   onOpen?: () => void;
   /** Fired when the messenger is hidden. */
@@ -124,17 +133,41 @@ export function ErxesMessenger({
   launcherVisible,
   homeActions = [],
   drawerActions = [],
+  renderLoading,
   onLoad,
   onReady,
   onOpen,
   onClose,
   onError,
   onAction,
+  onLoadingChange,
 }: ErxesMessengerProps) {
   // Keep the latest actions/callback in refs so the action listener (registered
   // once below) always dispatches against current props without re-subscribing.
   const actionsRef = useRef<ErxesAction[]>([]);
   const onActionRef = useRef(onAction);
+  const onLoadingChangeRef = useRef(onLoadingChange);
+  // Tracks whether we believe the messenger is currently presented, so we never
+  // double-present (chat mode auto-presents inside `configure()`) or fire a
+  // redundant show/hide. Native gives us no presentation callback, so this is our
+  // best-effort intent mirror.
+  const shownRef = useRef(false);
+
+  // Flips true only after native `configure()` resolves. The controlled-`visible`
+  // effect gates on this so it never calls `showMessenger()` before `configure()`
+  // (the native SDK asserts on that ordering).
+  const [configured, setConfigured] = useState(false);
+  // True while configuring (between `onLoad` and `onReady`/`onError`); drives
+  // `renderLoading`.
+  const [loading, setLoading] = useState(false);
+
+  useEffect(() => {
+    onLoadingChangeRef.current = onLoadingChange;
+  }, [onLoadingChange]);
+
+  useEffect(() => {
+    onLoadingChangeRef.current?.(loading);
+  }, [loading]);
 
   useEffect(() => {
     actionsRef.current = [...homeActions, ...drawerActions];
@@ -146,9 +179,17 @@ export function ErxesMessenger({
       return;
     }
 
+    setConfigured(false);
+
     const helpers: ErxesMessengerHelpers = {
-      show: () => ErxesNativeIOS.showMessenger(),
-      hide: () => ErxesNativeIOS.hideMessenger(),
+      show: async () => {
+        await ErxesNativeIOS.showMessenger();
+        shownRef.current = true;
+      },
+      hide: async () => {
+        await ErxesNativeIOS.hideMessenger();
+        shownRef.current = false;
+      },
       showLauncher: () => ErxesNativeIOS.showLauncher(),
       hideLauncher: () => ErxesNativeIOS.hideLauncher(),
       setUser: (nextUser) => ErxesNativeIOS.setUser(nextUser),
@@ -166,8 +207,16 @@ export function ErxesMessenger({
       await onActionRef.current?.(id, helpers);
     });
 
+    // Connection complete (native `MessengerSDK.isReady`): the messenger is
+    // truly ready, so end the loading state and notify the host.
+    const readySub = ErxesNativeIOS.addReadyListener(() => {
+      setLoading(false);
+      onReady?.();
+    });
+
     async function setup() {
       try {
+        setLoading(true);
         onLoad?.();
 
         if (user) {
@@ -186,19 +235,45 @@ export function ErxesMessenger({
           drawerActions: stripActions(drawerActions),
         });
 
-        onReady?.();
-
-        if (autoOpen) {
-          await ErxesNativeIOS.showMessenger();
-          onOpen?.();
+        // `configure()` only kicks off the async connect; `onReady` and the end
+        // of `loading` are driven by the ready listener above, not here.
+
+        // Decide the initial open state. If `visible` is controlled it wins;
+        // otherwise fall back to `autoOpen` (defaults to true in chat mode).
+        const shouldOpen = visible ?? autoOpen;
+
+        if (displayMode === 'chat') {
+          // Chat mode auto-presents itself inside `configure()` — never call
+          // `showMessenger()` for the initial open or we'd present a second one.
+          if (shouldOpen) {
+            shownRef.current = true;
+            onOpen?.();
+          } else {
+            // Caller wants it closed: undo the native auto-present.
+            await ErxesNativeIOS.hideMessenger();
+            shownRef.current = false;
+          }
+        } else {
+          // Classic mode: configure does not open anything. Show the launcher
+          // and/or present the sheet explicitly.
+          if (launcherVisible === true) {
+            await ErxesNativeIOS.showLauncher();
+          } else if (launcherVisible === false) {
+            await ErxesNativeIOS.hideLauncher();
+          }
+
+          if (shouldOpen) {
+            await ErxesNativeIOS.showMessenger();
+            shownRef.current = true;
+            onOpen?.();
+          }
         }
 
-        if (launcherVisible === true) {
-          await ErxesNativeIOS.showLauncher();
-        } else if (launcherVisible === false) {
-          await ErxesNativeIOS.hideLauncher();
-        }
+        setConfigured(true);
       } catch (error) {
+        // Setup failed before the connection could complete — end loading here
+        // since the ready listener will never fire.
+        setLoading(false);
         onError?.(error);
       }
     }
@@ -207,9 +282,11 @@ export function ErxesMessenger({
 
     return () => {
       sub.remove();
+      readySub.remove();
 
-      if (autoHideOnUnmount) {
+      if (autoHideOnUnmount && shownRef.current) {
         ErxesNativeIOS.hideMessenger();
+        shownRef.current = false;
         onClose?.();
       }
     };
@@ -219,19 +296,28 @@ export function ErxesMessenger({
   }, [integrationId, endpoint, serverUrl, subDomain, displayMode]);
 
   useEffect(() => {
-    if (Platform.OS !== 'ios' || visible === undefined) {
+    // Wait until `configure()` has resolved — otherwise `showMessenger()` would
+    // race ahead of it and trip the native configure-before-show assertion. The
+    // initial open is handled in `setup()`; this only reacts to later changes.
+    if (Platform.OS !== 'ios' || visible === undefined || !configured) {
       return;
     }
 
-    if (visible) {
+    if (visible && !shownRef.current) {
       ErxesNativeIOS.showMessenger();
+      shownRef.current = true;
       onOpen?.();
-    } else {
+    } else if (!visible && shownRef.current) {
       ErxesNativeIOS.hideMessenger();
+      shownRef.current = false;
       onClose?.();
     }
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [visible]);
+  }, [visible, configured]);
+
+  if (loading && renderLoading) {
+    return renderLoading();
+  }
 
   return null;
 }

package/src/nativeIos.ts

@@ -56,6 +56,9 @@ type NativeIOSModule = {
 /** Native event name emitted when a chat-mode action is tapped. */
 const ACTION_EVENT = 'onErxesAction';
 
+/** Native event name emitted when the connect handshake completes. */
+const READY_EVENT = 'onErxesReady';
+
 const LINKING_ERROR =
   "The rn-erxes-sdk native iOS module is not linked. Run `pod install` in your app's ios directory and rebuild the app.";
 
@@ -118,6 +121,18 @@ export const ErxesNativeIOS = {
       handler(event.id)
     );
   },
+  /**
+   * Listen for the connect handshake completing — i.e. the messenger is ready
+   * (`MessengerSDK.isReady`). Fires once per connection; if already connected
+   * when you subscribe via a fresh `configure`, it fires again. Returns a
+   * subscription — call `.remove()` to stop listening.
+   */
+  addReadyListener(handler: () => void): EmitterSubscription {
+    const emitter = new NativeEventEmitter(
+      getNativeModule() as unknown as NativeModule
+    );
+    return emitter.addListener(READY_EVENT, () => handler());
+  },
 };
 
 export type { NativeIOSAction, NativeIOSConfig, NativeIOSUser };