rn-erxes-sdk 0.2.5 → 0.3.2

package/README.md

@@ -85,16 +85,46 @@ erxes is composed of 2 main components: **XOS** & **Plugins**
 - **Knowledgebase** - Educate your customers and staff by creating a help center related to your brands, products, and services to reach a higher level of satisfaction.
 - **Task Management** - Create a more collaborative, self-reliant and cross-linked team. **<a href="https://erxes.io/marketplace" >See more on our website</a>**.
 
-## Usage
+## Screenshots
+
+### iOS ✅ Available
+
+Screenshots from the native [`erxes/erxes-ios-sdk`](https://github.com/erxes/erxes-ios-sdk).
 
-<img src="https://raw.githubusercontent.com/erxes/rn-erxes-sdk/main/MOBILE-SDK.png" alt="rn-erxes-sdk messenger screenshot" width="350">
+**Classic mode** (`displayMode: 'classic'`)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/erxes/erxes-ios-sdk/main/screenshots/home.png" width="220" alt="Home">
+  <img src="https://raw.githubusercontent.com/erxes/erxes-ios-sdk/main/screenshots/messages.png" width="220" alt="Messages">
+  <img src="https://raw.githubusercontent.com/erxes/erxes-ios-sdk/main/screenshots/tickets.png" width="220" alt="Tickets">
+</p>
+
+**Chat mode** (`displayMode: 'chat'`)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/erxes/erxes-ios-sdk/main/screenshots/new-chat.png" width="220" alt="New Chat">
+  <img src="https://raw.githubusercontent.com/erxes/erxes-ios-sdk/main/screenshots/recent-chats.png" width="220" alt="Recent Chats">
+</p>
+
+### Android 🚧 Upcoming
+
+_Coming soon._
+
+> **Platform support:** iOS is fully supported (native SwiftUI messenger). Android support is on the roadmap — see the [TODO](#roadmap) below.
+
+## Roadmap
+
+- [x] iOS native messenger (classic widget + chat mode)
+- [ ] Android native messenger
 
 ---
 
 # rn-erxes-sdk
 
 A React Native bridge for the native SwiftUI erxes messenger
-([`erxes/erxes-ios-sdk`](https://github.com/erxes/erxes-ios-sdk) `0.30.0`).
+([`erxes/erxes-ios-sdk`](https://github.com/erxes/erxes-ios-sdk) `0.30.7`).
+Supports the classic widget and the full-screen **chat mode** (with voice
+messages and header/drawer actions).
 
 ```tsx
 import { ErxesNativeIOS } from 'rn-erxes-sdk';
@@ -184,6 +214,29 @@ If you have a custom trigger in your UI, call `showMessenger()` directly:
 <Button title="Support" onPress={() => ErxesNativeIOS.showMessenger()} />
 ```
 
+### Chat mode
+
+Pass `displayMode: 'chat'` for the full-screen assistant shell (it auto-opens
+when connected, so `showLauncher()` is a no-op). You can add header/drawer
+actions and react to taps by `id`:
+
+```tsx
+ErxesNativeIOS.configure({
+  integrationId: 'YOUR_INTEGRATION_ID',
+  subDomain: 'yourcompany.erxes.io',
+  displayMode: 'chat',
+  homeActions: [{ id: 'orders', title: 'My Orders', systemIcon: 'bag' }],
+  drawerActions: [{ id: 'settings', title: 'Settings', systemIcon: 'gearshape' }],
+});
+
+const sub = ErxesNativeIOS.addActionListener((id) => {
+  // navigate / open a modal based on id
+});
+// sub.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:
 
 ```tsx
@@ -254,25 +307,6 @@ yarn install
 npx expo start --clear
 ```
 
-### Release
-
-```bash
-npm login
-npm whoami
-
-npm version patch
-npm publish
-
-npm view rn-erxes-sdk version
-git push origin main --follow-tags
-```
-
-- Pushing to GitHub does **not** publish to npm.
-- npmjs displays the README from the **published** package version.
-- Each release requires a new version; a published version cannot be republished.
-- `npm version patch` is appropriate for backward-compatible fixes and documentation updates.
-- `npm publish` may require 2FA or a granular access token with publish permission.
-- Do not repeatedly run `npm version patch` after a failed publish unless a genuinely new version is needed.
 ## Become a partner
 
 Offer your expertise to the world and introduce your community to erxes.

package/docs/native-ios.md

@@ -1,7 +1,7 @@
 # Native iOS Guide
 
 `ErxesNativeIOS` bridges the native SwiftUI erxes messenger
-([`erxes/erxes-ios-sdk`](https://github.com/erxes/erxes-ios-sdk) `0.30.0`)
+([`erxes/erxes-ios-sdk`](https://github.com/erxes/erxes-ios-sdk) `0.30.7`)
 into your React Native app.
 
 ## Requirements
@@ -119,6 +119,104 @@ ErxesNativeIOS.configure({ integrationId, subDomain });
 
 ---
 
+## Chat mode (`displayMode: 'chat'`)
+
+Set `displayMode: 'chat'` to present an AI-assistant-style full-screen shell
+instead of the classic 4-tab sheet widget. In chat mode the messenger opens
+**itself** full-screen as soon as the connect handshake succeeds — there is no
+floating launcher, so `showLauncher()` is a no-op (the messenger is already up).
+Omit `displayMode` (or pass `'classic'`) to keep the classic widget.
+
+### Header / drawer actions
+
+Chat mode can render host-configurable actions in the header (`homeActions`) and
+the left drawer (`drawerActions`). Actions cross the JS↔native bridge as **plain
+data** (`id`, `title`, `systemIcon`) — never as functions. Tapping an action
+fires a single native event carrying just the tapped `id`; your JS code decides
+what happens (navigate, open a modal, etc.) by switching on that `id`.
+
+Use `ErxesNativeIOS.addActionListener` to subscribe — it returns a subscription
+you `.remove()` on cleanup.
+
+```tsx
+import { useEffect } from 'react';
+import { useNavigation } from '@react-navigation/native';
+import { ErxesNativeIOS } from 'rn-erxes-sdk';
+
+function App() {
+  const navigation = useNavigation();
+
+  useEffect(() => {
+    // 1. Configure with data-only action descriptors (id/title/icon — no functions)
+    ErxesNativeIOS.configure({
+      integrationId: 'YOUR_INTEGRATION_ID',
+      subDomain: 'yourcompany.erxes.io',
+      displayMode: 'chat',
+      homeActions: [
+        { id: 'orders', title: 'My Orders', systemIcon: 'bag' },
+        { id: 'profile', title: 'Profile', systemIcon: 'person' },
+      ],
+      drawerActions: [
+        { id: 'settings', title: 'Settings', systemIcon: 'gearshape' },
+      ],
+    });
+
+    // 2. Listen for taps — native only ever sends the id back
+    const sub = ErxesNativeIOS.addActionListener((id) => {
+      switch (id) {
+        case 'orders':
+          navigation.navigate('Orders');
+          break;
+        case 'profile':
+          navigation.navigate('Profile');
+          break;
+        case 'settings':
+          openSettingsModal(); // your own modal trigger
+          break;
+      }
+    });
+
+    return () => sub.remove();
+  }, [navigation]);
+
+  return null;
+}
+```
+
+`systemIcon` is an [SF Symbol](https://developer.apple.com/sf-symbols/) name
+(e.g. `"bag"`, `"gearshape"`).
+
+---
+
+## Voice messages
+
+In chat mode the messenger supports **voice messages** (audio playback) and
+**speech-to-text** dictation in the composer. These use the microphone and speech
+recognition, so your host app must declare the matching usage descriptions in its
+`Info.plist`:
+
+```xml
+<key>NSMicrophoneUsageDescription</key>
+<string>Record voice messages in support chat.</string>
+<key>NSSpeechRecognitionUsageDescription</key>
+<string>Transcribe your voice into chat messages.</string>
+```
+
+For Expo, add them under `ios.infoPlist` in `app.json`:
+
+```json
+{
+  "ios": {
+    "infoPlist": {
+      "NSMicrophoneUsageDescription": "Record voice messages in support chat.",
+      "NSSpeechRecognitionUsageDescription": "Transcribe your voice into chat messages."
+    }
+  }
+}
+```
+
+---
+
 ## Logout
 
 Clear the user when they log out of your app:

package/ios/RnErxesSdk.m

@@ -1,6 +1,7 @@
 #import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
 
-@interface RCT_EXTERN_MODULE(RnErxesSdk, NSObject)
+@interface RCT_EXTERN_MODULE(RnErxesSdk, RCTEventEmitter)
 
 RCT_EXTERN_METHOD(configure:(NSDictionary *)options
                   resolver:(RCTPromiseResolveBlock)resolve

package/ios/RnErxesSdk.swift

@@ -4,12 +4,29 @@ import UIKit
 import React
 
 @objc(RnErxesSdk)
-final class RnErxesSdk: NSObject {
-    @objc
-    static func requiresMainQueueSetup() -> Bool {
+final class RnErxesSdk: RCTEventEmitter {
+    /// JS event fired when a chat-mode action (homeActions/drawerActions) is tapped.
+    private static let actionEvent = "onErxesAction"
+
+    /// True while JS has at least one listener attached, so we don't emit into the void.
+    private var hasListeners = false
+
+    override static func requiresMainQueueSetup() -> Bool {
         true
     }
 
+    override func supportedEvents() -> [String] {
+        [Self.actionEvent]
+    }
+
+    override func startObserving() {
+        hasListeners = true
+    }
+
+    override func stopObserving() {
+        hasListeners = false
+    }
+
     @objc(configure:resolver:rejecter:)
     func configure(
         _ options: NSDictionary,
@@ -28,12 +45,32 @@ final class RnErxesSdk: NSObject {
             }
 
             let cachedCustomerId = Self.string(options["cachedCustomerId"])
+            let displayMode = Self.string(options["displayMode"])
+                .flatMap(DisplayMode.init(rawValue:)) ?? .classic
+            let homeActions = Self.actionItems(options["homeActions"])
+            let drawerActions = Self.actionItems(options["drawerActions"])
+
+            var appearance = MessengerConfig.Appearance()
+            if let primaryColor = Self.hexColor(options["primaryColor"]) {
+                appearance.primaryColor = primaryColor
+            }
+
+            // Route chat-mode action taps to JS as `onErxesAction` events. The SDK
+            // only hands back the tapped action's id (data-only across the bridge).
+            MessengerSDK.shared.onAction = { [weak self] id in
+                guard let self, self.hasListeners else { return }
+                self.sendEvent(withName: Self.actionEvent, body: ["id": id])
+            }
 
             MessengerSDK.configure(
                 MessengerConfig(
                     endpoint: endpoint,
                     integrationId: integrationId,
-                    cachedCustomerId: cachedCustomerId
+                    cachedCustomerId: cachedCustomerId,
+                    appearance: appearance,
+                    displayMode: displayMode,
+                    homeActions: homeActions,
+                    drawerActions: drawerActions
                 )
             )
 
@@ -145,6 +182,54 @@ final class RnErxesSdk: NSObject {
         return nil
     }
 
+    /// Parse `[{ id, title, systemIcon }]` from JS into `[ActionItem]`.
+    /// Entries without an `id` are skipped; `title`/`systemIcon` default to empty.
+    private static func actionItems(_ value: Any?) -> [ActionItem] {
+        guard let array = value as? [[String: Any]] else {
+            return []
+        }
+
+        return array.compactMap { item in
+            guard let id = string(item["id"]) else { return nil }
+            return ActionItem(
+                id: id,
+                title: string(item["title"]) ?? "",
+                systemIcon: string(item["systemIcon"]) ?? ""
+            )
+        }
+    }
+
+    /// Parse a `#RGB`/`#RRGGBB`/`#RRGGBBAA` hex string into a UIColor.
+    private static func hexColor(_ value: Any?) -> UIColor? {
+        guard var hex = string(value) else { return nil }
+        if hex.hasPrefix("#") { hex.removeFirst() }
+
+        // Expand shorthand #RGB to #RRGGBB.
+        if hex.count == 3 {
+            hex = hex.map { "\($0)\($0)" }.joined()
+        }
+
+        guard hex.count == 6 || hex.count == 8,
+              let intValue = UInt64(hex, radix: 16) else {
+            return nil
+        }
+
+        let hasAlpha = hex.count == 8
+        let r, g, b, a: CGFloat
+        if hasAlpha {
+            r = CGFloat((intValue >> 24) & 0xFF) / 255
+            g = CGFloat((intValue >> 16) & 0xFF) / 255
+            b = CGFloat((intValue >> 8) & 0xFF) / 255
+            a = CGFloat(intValue & 0xFF) / 255
+        } else {
+            r = CGFloat((intValue >> 16) & 0xFF) / 255
+            g = CGFloat((intValue >> 8) & 0xFF) / 255
+            b = CGFloat(intValue & 0xFF) / 255
+            a = 1
+        }
+        return UIColor(red: r, green: g, blue: b, alpha: a)
+    }
+
     private static func stringDictionary(_ value: Any?) -> [String: String] {
         guard let dictionary = value as? [String: Any] else {
             return [:]

package/lib/commonjs/nativeIos.js

@@ -5,6 +5,14 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.ErxesNativeIOS = void 0;
 var _reactNative = require("react-native");
+/**
+ * A chat-mode action rendered in the header (`homeActions`) or drawer
+ * (`drawerActions`). Kept data-only so it can cross the native bridge — tapping
+ * it fires the `onErxesAction` event with this `id` (see `addActionListener`).
+ */
+
+/** Native event name emitted when a chat-mode action is tapped. */
+const ACTION_EVENT = 'onErxesAction';
 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() {
@@ -44,6 +52,16 @@ const ErxesNativeIOS = {
   },
   hideLauncher() {
     return getNativeModule().hideLauncher();
+  },
+  /**
+   * Listen for chat-mode action taps (`homeActions` / `drawerActions`). The
+   * handler receives the tapped action's `id`; your code decides what happens
+   * (navigate, open a modal, etc.). Returns a subscription — call `.remove()`
+   * to stop listening.
+   */
+  addActionListener(handler) {
+    const emitter = new _reactNative.NativeEventEmitter(getNativeModule());
+    return emitter.addListener(ACTION_EVENT, event => handler(event.id));
   }
 };
 exports.ErxesNativeIOS = ErxesNativeIOS;

package/lib/commonjs/nativeIos.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","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","exports"],"sourceRoot":"../../src","sources":["nativeIos.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AA0BA,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;AACF,CAAC;AAACC,OAAA,CAAApB,cAAA,GAAAA,cAAA"}
+{"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","addActionListener","handler","emitter","NativeEventEmitter","addListener","event","id","exports"],"sourceRoot":"../../src","sources":["nativeIos.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAQA;AACA;AACA;AACA;AACA;;AA0CA;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;EACD;AACF;AACA;AACA;AACA;AACA;EACEC,iBAAiBA,CAACC,OAA6B,EAAuB;IACpE,MAAMC,OAAO,GAAG,IAAIC,+BAAkB,CACpC3B,eAAe,CAAC,CAClB,CAAC;IACD,OAAO0B,OAAO,CAACE,WAAW,CAACjC,YAAY,EAAGkC,KAAqB,IAC7DJ,OAAO,CAACI,KAAK,CAACC,EAAE,CAClB,CAAC;EACH;AACF,CAAC;AAACC,OAAA,CAAA3B,cAAA,GAAAA,cAAA"}

package/lib/module/nativeIos.js

@@ -1,4 +1,13 @@
-import { NativeModules, Platform } from 'react-native';
+import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
+
+/**
+ * A chat-mode action rendered in the header (`homeActions`) or drawer
+ * (`drawerActions`). Kept data-only so it can cross the native bridge — tapping
+ * it fires the `onErxesAction` event with this `id` (see `addActionListener`).
+ */
+
+/** Native event name emitted when a chat-mode action is tapped. */
+const ACTION_EVENT = 'onErxesAction';
 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() {
@@ -38,6 +47,16 @@ export const ErxesNativeIOS = {
   },
   hideLauncher() {
     return getNativeModule().hideLauncher();
+  },
+  /**
+   * Listen for chat-mode action taps (`homeActions` / `drawerActions`). The
+   * handler receives the tapped action's `id`; your code decides what happens
+   * (navigate, open a modal, etc.). Returns a subscription — call `.remove()`
+   * to stop listening.
+   */
+  addActionListener(handler) {
+    const emitter = new NativeEventEmitter(getNativeModule());
+    return emitter.addListener(ACTION_EVENT, event => handler(event.id));
   }
 };
 //# sourceMappingURL=nativeIos.js.map

package/lib/module/nativeIos.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","Platform","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"],"sourceRoot":"../../src","sources":["nativeIos.ts"],"mappings":"AAAA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AA0BtD,MAAMC,aAAa,GACjB,sHAAsH;AAExH,MAAMC,YAAY,GAAGH,aAAa,CAACI,UAAyC;AAE5E,SAASC,eAAeA,CAAA,EAAoB;EAC1C,IAAIJ,QAAQ,CAACK,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;AACF,CAAC"}
+{"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","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;;AA0CA;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;EACD;AACF;AACA;AACA;AACA;AACA;EACEC,iBAAiBA,CAACC,OAA6B,EAAuB;IACpE,MAAMC,OAAO,GAAG,IAAIhC,kBAAkB,CACpCO,eAAe,CAAC,CAClB,CAAC;IACD,OAAOyB,OAAO,CAACC,WAAW,CAAC9B,YAAY,EAAG+B,KAAqB,IAC7DH,OAAO,CAACG,KAAK,CAACC,EAAE,CAClB,CAAC;EACH;AACF,CAAC"}

package/lib/typescript/index.d.ts

@@ -1,3 +1,3 @@
 export { ErxesNativeIOS } from './nativeIos';
-export type { NativeIOSConfig, NativeIOSUser } from './nativeIos';
+export type { NativeIOSAction, NativeIOSConfig, NativeIOSUser, } from './nativeIos';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACV,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC"}

package/lib/typescript/nativeIos.d.ts

@@ -1,9 +1,31 @@
+import { type EmitterSubscription } from 'react-native';
+/**
+ * A chat-mode action rendered in the header (`homeActions`) or drawer
+ * (`drawerActions`). Kept data-only so it can cross the native bridge — tapping
+ * it fires the `onErxesAction` event with this `id` (see `addActionListener`).
+ */
+type NativeIOSAction = {
+    /** Identifier echoed back when the action is tapped. */
+    id: string;
+    /** Display title (drawer rows / accessibility label for header icons). */
+    title: string;
+    /** SF Symbol name, e.g. "magnifyingglass". */
+    systemIcon: string;
+};
 type NativeIOSConfig = {
     integrationId: string;
     endpoint?: string;
     serverUrl?: string;
     subDomain?: string;
     cachedCustomerId?: string;
+    /** UI shell to present. Defaults to `'classic'` (the sheet-based widget). */
+    displayMode?: 'classic' | 'chat';
+    /** Chat-mode header-right actions. Ignored in `'classic'`. */
+    homeActions?: NativeIOSAction[];
+    /** Chat-mode drawer top action rows. Ignored in `'classic'`. */
+    drawerActions?: NativeIOSAction[];
+    /** Primary accent color as a hex string, e.g. `'#3f78d9'`. */
+    primaryColor?: string;
 };
 type NativeIOSUser = {
     email?: string;
@@ -18,6 +40,13 @@ export declare const ErxesNativeIOS: {
     showMessenger(): Promise<void>;
     showLauncher(): Promise<void>;
     hideLauncher(): Promise<void>;
+    /**
+     * Listen for chat-mode action taps (`homeActions` / `drawerActions`). The
+     * handler receives the tapped action's `id`; your code decides what happens
+     * (navigate, open a modal, etc.). Returns a subscription — call `.remove()`
+     * to stop listening.
+     */
+    addActionListener(handler: (id: string) => void): EmitterSubscription;
 };
-export type { NativeIOSConfig, NativeIOSUser };
+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":"AAEA,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;CAC3B,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;AA4BF,eAAO,MAAM,cAAc;uBACN,eAAe;qBAGjB,aAAa;;;;;CAwB/B,CAAC;AAEF,YAAY,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;AA+BF,eAAO,MAAM,cAAc;uBACN,eAAe;qBAGjB,aAAa;;;;;IAwB9B;;;;;OAKG;oCAC6B,MAAM,KAAK,IAAI,GAAG,mBAAmB;CAQtE,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rn-erxes-sdk",
-  "version": "0.2.5",
+  "version": "0.3.2",
   "description": "react-native erxes sdk",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -53,7 +53,8 @@
   },
   "homepage": "https://github.com/erxes/rn-erxes-sdk#readme",
   "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
   },
   "devDependencies": {
     "@babel/core": "^7.26.0",

package/rn-erxes-sdk.podspec

@@ -36,10 +36,10 @@ Pod::Spec.new do |s|
     spm_dependency(
       s,
       url: 'https://github.com/erxes/erxes-ios-sdk.git',
-      requirement: { :kind => 'exactVersion', :version => '0.30.5' },
+      requirement: { :kind => 'exactVersion', :version => '0.30.7' },
       products: ['MessengerSDK']
     )
   else
-    raise 'rn-erxes-sdk requires React Native 0.81+ CocoaPods SPM support to install MessengerSDK 0.0.1'
+    raise 'rn-erxes-sdk requires React Native 0.81+ CocoaPods SPM support to install MessengerSDK 0.30.7'
   end
 end

package/src/index.tsx

@@ -1,2 +1,6 @@
 export { ErxesNativeIOS } from './nativeIos';
-export type { NativeIOSConfig, NativeIOSUser } from './nativeIos';
+export type {
+  NativeIOSAction,
+  NativeIOSConfig,
+  NativeIOSUser,
+} from './nativeIos';

package/src/nativeIos.ts

@@ -1,4 +1,24 @@
-import { NativeModules, Platform } from 'react-native';
+import {
+  NativeEventEmitter,
+  NativeModules,
+  Platform,
+  type EmitterSubscription,
+  type NativeModule,
+} from 'react-native';
+
+/**
+ * A chat-mode action rendered in the header (`homeActions`) or drawer
+ * (`drawerActions`). Kept data-only so it can cross the native bridge — tapping
+ * it fires the `onErxesAction` event with this `id` (see `addActionListener`).
+ */
+type NativeIOSAction = {
+  /** Identifier echoed back when the action is tapped. */
+  id: string;
+  /** Display title (drawer rows / accessibility label for header icons). */
+  title: string;
+  /** SF Symbol name, e.g. "magnifyingglass". */
+  systemIcon: string;
+};
 
 type NativeIOSConfig = {
   integrationId: string;
@@ -6,6 +26,14 @@ type NativeIOSConfig = {
   serverUrl?: string;
   subDomain?: string;
   cachedCustomerId?: string;
+  /** UI shell to present. Defaults to `'classic'` (the sheet-based widget). */
+  displayMode?: 'classic' | 'chat';
+  /** Chat-mode header-right actions. Ignored in `'classic'`. */
+  homeActions?: NativeIOSAction[];
+  /** Chat-mode drawer top action rows. Ignored in `'classic'`. */
+  drawerActions?: NativeIOSAction[];
+  /** Primary accent color as a hex string, e.g. `'#3f78d9'`. */
+  primaryColor?: string;
 };
 
 type NativeIOSUser = {
@@ -24,6 +52,9 @@ type NativeIOSModule = {
   hideLauncher(): Promise<void>;
 };
 
+/** Native event name emitted when a chat-mode action is tapped. */
+const ACTION_EVENT = 'onErxesAction';
+
 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.";
 
@@ -69,6 +100,20 @@ export const ErxesNativeIOS = {
   hideLauncher() {
     return getNativeModule().hideLauncher();
   },
+  /**
+   * Listen for chat-mode action taps (`homeActions` / `drawerActions`). The
+   * handler receives the tapped action's `id`; your code decides what happens
+   * (navigate, open a modal, etc.). Returns a subscription — call `.remove()`
+   * to stop listening.
+   */
+  addActionListener(handler: (id: string) => void): EmitterSubscription {
+    const emitter = new NativeEventEmitter(
+      getNativeModule() as unknown as NativeModule
+    );
+    return emitter.addListener(ACTION_EVENT, (event: { id: string }) =>
+      handler(event.id)
+    );
+  },
 };
 
-export type { NativeIOSConfig, NativeIOSUser };
+export type { NativeIOSAction, NativeIOSConfig, NativeIOSUser };