rn-erxes-sdk 0.3.3 → 0.4.0

package/README.md

@@ -127,9 +127,15 @@ Supports the classic widget and the full-screen **chat mode** (with voice
 messages and header/drawer actions).
 
 ```tsx
-import { ErxesNativeIOS } from 'rn-erxes-sdk';
+import { ErxesMessenger } from 'rn-erxes-sdk';
 ```
 
+Two APIs are exported:
+
+- **`<ErxesMessenger />`** — a declarative React component that handles configure,
+  user identity, action taps, and the show/hide lifecycle. Recommended for most apps.
+- **`ErxesNativeIOS`** — the low-level native bridge for advanced/imperative control.
+
 ## Requirements
 
 | | |
@@ -174,7 +180,129 @@ cd ios && pod install
 npx expo run:ios
 ```
 
-## Usage
+## Usage — `<ErxesMessenger />` (recommended)
+
+Render the component where the messenger should be active. It configures the SDK on
+mount, dispatches action taps to your `onPress` handlers, and hides the messenger on
+unmount. It renders nothing — the messenger UI is presented natively over your app.
+
+```tsx
+import { ErxesMessenger } from 'rn-erxes-sdk';
+
+<ErxesMessenger
+  integrationId="YOUR_INTEGRATION_ID"
+  subDomain="yourcompany.erxes.io"
+  user={{ name: 'Jane Doe', email: 'user@example.com' }}
+/>
+```
+
+### Example 1 — Classic floating launcher
+
+Shows a draggable button over your app. Tapping it opens the messenger.
+
+```tsx
+<ErxesMessenger
+  integrationId={INTEGRATION_ID}
+  endpoint={ENDPOINT}
+  displayMode="classic"
+  launcherVisible
+  user={CURRENT_USER}
+/>
+```
+
+### Example 2 — Home screen full-screen chat
+
+Chat mode opens full-screen and auto-opens when connected. Bind `visible` to screen
+focus so the messenger shows/hides as the user navigates, and add a header action to
+jump to another screen.
+
+```tsx
+import { ActivityIndicator, View } from 'react-native';
+
+const isFocused = useIsFocused();
+
+<ErxesMessenger
+  visible={isFocused}
+  integrationId={INTEGRATION_ID}
+  endpoint={ENDPOINT}
+  displayMode="chat"
+  user={CURRENT_USER}
+  renderLoading={() => (
+    <View style={{ flex: 1, justifyContent: 'center' }}>
+      <ActivityIndicator />
+    </View>
+  )}
+  homeActions={[
+    {
+      id: 'profile',
+      title: 'Profile',
+      systemIcon: 'person.crop.circle',
+      onPress: async ({ hide }) => {
+        await hide();
+        navigation.navigate('Profile', { user: CURRENT_USER });
+      },
+    },
+  ]}
+/>
+```
+
+`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
+messenger and pops the screen.
+
+```tsx
+<ErxesMessenger
+  integrationId={INTEGRATION_ID}
+  endpoint={ENDPOINT}
+  displayMode="chat"
+  autoOpen
+  autoHideOnUnmount
+  user={CURRENT_USER}
+  homeActions={[
+    {
+      id: 'close',
+      title: 'Close',
+      systemIcon: 'xmark',
+      onPress: async ({ hide }) => {
+        await hide();
+        navigation.goBack();
+      },
+    },
+  ]}
+  onReady={() => console.log('erxes messenger ready')}
+  onError={(error) => console.log('erxes messenger error', error)}
+/>
+```
+
+### Props
+
+| Prop | Type | Notes |
+|---|---|---|
+| `integrationId` | `string` | Required. |
+| `endpoint` / `serverUrl` / `subDomain` | `string` | Provide one. `subDomain` accepts `'company.erxes.io'`. |
+| `displayMode` | `'classic' \| 'chat'` | Defaults to `'classic'`. |
+| `user` | `ErxesUser` | `{ name?, email?, phone?, customData? }`. |
+| `cachedCustomerId` | `string` | Reuse a cached customer. |
+| `primaryColor` | `string` | Hex accent, e.g. `'#3f78d9'`. |
+| `visible` | `boolean` | Controlled show/hide on change. |
+| `autoOpen` | `boolean` | Open after configure. Defaults to `true` in chat mode. |
+| `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`:
+`show`, `hide`, `showLauncher`, `hideLauncher`, `setUser`, `clearUser`.
+
+## Advanced — `ErxesNativeIOS` (low-level)
 
 Call `configure` once at startup. It connects in the background so the messenger opens instantly.
 
@@ -235,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/docs/native-ios.md

@@ -4,6 +4,11 @@
 ([`erxes/erxes-ios-sdk`](https://github.com/erxes/erxes-ios-sdk) `0.30.7`)
 into your React Native app.
 
+> **Most apps should use the `<ErxesMessenger />` component instead** — it wraps
+> this bridge and manages configure, user identity, action taps, and the show/hide
+> lifecycle declaratively. See the [README](../README.md#usage--erxesmessenger-recommended).
+> This guide documents the low-level `ErxesNativeIOS` API for advanced/imperative use.
+
 ## Requirements
 
 | | |

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

@@ -0,0 +1,234 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ErxesMessenger = ErxesMessenger;
+var _react = require("react");
+var _reactNative = require("react-native");
+var _nativeIos = require("./nativeIos");
+/**
+ * The identified end user. Same shape the native bridge expects — passing
+ * `undefined` leaves the visitor anonymous until you call `setUser` later.
+ */
+
+/**
+ * Helpers handed to action `onPress` callbacks (and `onAction`) so you can drive
+ * the messenger imperatively from inside a tap handler — show/hide it, toggle the
+ * launcher, or swap the user.
+ */
+
+/**
+ * A chat-mode action rendered in the header (`homeActions`) or drawer
+ * (`drawerActions`). Only `id`/`title`/`systemIcon` cross the native bridge; the
+ * `onPress` callback stays in JS and runs when the matching action is tapped.
+ */
+
+/**
+ * Drop `onPress` so only the data-only fields the native bridge understands
+ * (`id`/`title`/`systemIcon`) cross over. React Native cannot send JS functions
+ * to native, so `onPress` is dispatched on the JS side via the action listener.
+ */
+function stripActions(actions) {
+  return actions.map(_ref => {
+    let {
+      onPress: _onPress,
+      ...nativeAction
+    } = _ref;
+    return nativeAction;
+  });
+}
+
+/**
+ * Declarative wrapper around {@link ErxesNativeIOS}. Configures the native erxes
+ * messenger, wires up action taps, and manages the show/hide lifecycle so app
+ * code stays a single component. Renders nothing — the messenger UI is presented
+ * natively over your app.
+ *
+ * For advanced/imperative control, use `ErxesNativeIOS` directly.
+ */
+function ErxesMessenger(_ref2) {
+  let {
+    integrationId,
+    endpoint,
+    serverUrl,
+    subDomain,
+    displayMode = 'classic',
+    user,
+    cachedCustomerId,
+    primaryColor,
+    visible,
+    autoOpen = displayMode === 'chat',
+    autoHideOnUnmount = true,
+    launcherVisible,
+    homeActions = [],
+    drawerActions = [],
+    renderLoading,
+    onLoad,
+    onReady,
+    onOpen,
+    onClose,
+    onError,
+    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;
+  }, [homeActions, drawerActions, onAction]);
+  (0, _react.useEffect)(() => {
+    if (_reactNative.Platform.OS !== 'ios') {
+      return;
+    }
+    setConfigured(false);
+    const helpers = {
+      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),
+      clearUser: () => _nativeIos.ErxesNativeIOS.clearUser()
+    };
+    const sub = _nativeIos.ErxesNativeIOS.addActionListener(async id => {
+      var _onActionRef$current;
+      const action = actionsRef.current.find(item => item.id === id);
+      if (action !== null && action !== void 0 && action.onPress) {
+        await action.onPress(helpers);
+        return;
+      }
+      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);
+        }
+        await _nativeIos.ErxesNativeIOS.configure({
+          integrationId,
+          endpoint,
+          serverUrl,
+          subDomain,
+          cachedCustomerId,
+          displayMode,
+          primaryColor,
+          homeActions: stripActions(homeActions),
+          drawerActions: stripActions(drawerActions)
+        });
+
+        // `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();
+      readySub.remove();
+      if (autoHideOnUnmount && shownRef.current) {
+        _nativeIos.ErxesNativeIOS.hideMessenger();
+        shownRef.current = false;
+        onClose === null || onClose === void 0 ? void 0 : onClose();
+      }
+    };
+    // Re-run setup only when the native config identity changes; callbacks and
+    // actions are read through refs so they don't need to be deps here.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [integrationId, endpoint, serverUrl, subDomain, displayMode]);
+  (0, _react.useEffect)(() => {
+    // 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 && !shownRef.current) {
+      _nativeIos.ErxesNativeIOS.showMessenger();
+      shownRef.current = true;
+      onOpen === null || onOpen === void 0 ? void 0 : onOpen();
+    } 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, configured]);
+  if (loading && renderLoading) {
+    return renderLoading();
+  }
+  return null;
+}
+//# sourceMappingURL=ErxesMessenger.js.map

package/lib/commonjs/ErxesMessenger.js.map

@@ -0,0 +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","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/index.js

@@ -3,6 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "ErxesMessenger", {
+  enumerable: true,
+  get: function () {
+    return _ErxesMessenger.ErxesMessenger;
+  }
+});
 Object.defineProperty(exports, "ErxesNativeIOS", {
   enumerable: true,
   get: function () {
@@ -10,4 +16,5 @@ Object.defineProperty(exports, "ErxesNativeIOS", {
   }
 });
 var _nativeIos = require("./nativeIos");
+var _ErxesMessenger = require("./ErxesMessenger");
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_nativeIos","require"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;AAAA,IAAAA,UAAA,GAAAC,OAAA"}
+{"version":3,"names":["_nativeIos","require","_ErxesMessenger"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;AAAA,IAAAA,UAAA,GAAAC,OAAA;AAOA,IAAAC,eAAA,GAAAD,OAAA"}

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"}