@banbox/chat 1.0.11 → 1.0.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@banbox/chat",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "Banbox Chat UI components — reusable across all Banbox React/Next.js projects",
   "type": "module",
   "license": "UNLICENSED",

package/src/chat/ChatRoot.tsx

@@ -11,41 +11,44 @@ import SinglePopup from "./SinglePopup";
 import type { ChatTheme } from "./InboxPopup";
 
 export type ChatRootProps = {
-  /**
-   * The unified data adapter — provides all threads, messages, and send logic.
-   */
+  /** The unified data adapter — provides all threads, messages, and send logic. */
   adapter: ChatAdapter;
 
+  /** Optional UI callbacks — toast, navigation, kebab menu. */
+  uiCallbacks?: ChatUICallbacks;
+
   /**
-   * Optional UI callbacks — controls toast notifications, navigation,
-   * and the kebab (⋮) menu renderer.
+   * Visual theme: "marketplace" | "admin" | { primary, primaryActive, surfaceLow }
+   * @example <ChatRoot adapter={adapter} theme="admin" />
    */
-  uiCallbacks?: ChatUICallbacks;
+  theme?: ChatTheme;
 
   /**
-   * Visual theme:
-   * - "marketplace" (default) — orange primary (#ff5300)
-   * - "admin"                 — black primary (#1a1a1a)
-   * - custom object           — { primary, primaryActive, surfaceLow }
+   * Allow-list of toolbar buttons shown in the **InboxPopup** footer.
+   *
+   * Keys: "attachment" | "emoji" | "businessCard" | "addressCard" | "translate"
+   * Default: ["attachment", "emoji", "translate"]
    *
    * @example
-   * <ChatRoot adapter={adapter} theme="admin" />
+   * // Seller inbox — no cards at all:
+   * inboxFooterActions={["attachment", "emoji", "translate"]}
    */
-  theme?: ChatTheme;
+  inboxFooterActions?: string[];
 
   /**
-   * Keys of footer toolbar actions to hide.
+   * Allow-list of toolbar buttons shown in the **SinglePopup** footer.
    *
-   * Available keys: "attachment" | "emoji" | "businessCard" | "addressCard" | "translate"
+   * Keys: "attachment" | "emoji" | "businessCard" | "addressCard" | "translate"
+   * Default: ["attachment", "emoji", "translate"]
    *
    * @example
-   * // Hide the Delivery Address button in the seller app:
-   * <ChatRoot hiddenActionKeys={["addressCard"]} ... />
+   * // Single chat with location sharing enabled:
+   * singleFooterActions={["attachment", "emoji", "translate", "addressCard"]}
    */
-  hiddenActionKeys?: string[];
+  singleFooterActions?: string[];
 };
 
-export default function ChatRoot({ adapter, uiCallbacks, theme, hiddenActionKeys }: ChatRootProps) {
+export default function ChatRoot({ adapter, uiCallbacks, theme, inboxFooterActions, singleFooterActions }: ChatRootProps) {
   const { isOpen, variant } = useChatUI();
 
   // Lock page scroll whenever the chat is open
@@ -56,7 +59,6 @@ export default function ChatRoot({ adapter, uiCallbacks, theme, hiddenActionKeys
   }
 
   return createPortal(
-    // GalleryProvider is scoped to the chat only.
     <GalleryProvider>
       <AnimatePresence mode="wait">
         {isOpen && (
@@ -66,7 +68,7 @@ export default function ChatRoot({ adapter, uiCallbacks, theme, hiddenActionKeys
               adapter={adapter}
               uiCallbacks={uiCallbacks}
               theme={theme}
-              hiddenActionKeys={hiddenActionKeys}
+              footerActions={inboxFooterActions}
             />
           ) : (
             <SinglePopup
@@ -74,7 +76,7 @@ export default function ChatRoot({ adapter, uiCallbacks, theme, hiddenActionKeys
               adapter={adapter}
               uiCallbacks={uiCallbacks}
               theme={theme}
-              hiddenActionKeys={hiddenActionKeys}
+              footerActions={singleFooterActions}
             />
           )
         )}

package/src/chat/InboxPopup.tsx

@@ -34,8 +34,11 @@ export type InboxPopupProps = {
   adapter: ChatAdapter;
   uiCallbacks?: ChatUICallbacks;
   theme?: ChatTheme;
-  /** Keys of footer toolbar actions to hide. e.g. ["addressCard", "translate"] */
-  hiddenActionKeys?: string[];
+  /**
+   * Allow-list of footer toolbar keys. Defaults to ["attachment", "emoji", "translate"].
+   * Pass e.g. ["attachment", "emoji", "translate", "businessCard"] to opt-in to more.
+   */
+  footerActions?: string[];
 };
 
 /* ─── Helpers ─── */
@@ -52,7 +55,7 @@ const avatarBgByInitial: Record<string, string> = {
 /* ══════════════════════════════════════════════════
    Component
 ══════════════════════════════════════════════════ */
-const InboxPopup: React.FC<InboxPopupProps> = ({ adapter, uiCallbacks, theme, hiddenActionKeys }) => {
+const InboxPopup: React.FC<InboxPopupProps> = ({ adapter, uiCallbacks, theme, footerActions }) => {
   const { close, selectThread, selectedThreadId, reference } = useChatUI();
   const { isOpen: isGalleryOpen, closeGallery } = useGallery();
 
@@ -339,7 +342,7 @@ const InboxPopup: React.FC<InboxPopupProps> = ({ adapter, uiCallbacks, theme, hi
                   replyTo={replyTo}
                   clearReply={() => setReplyTo(undefined)}
                   onAfterSend={() => setRev((v) => v + 1)}
-                  hiddenActionKeys={hiddenActionKeys}
+                  enabledActions={footerActions}
                   onSend={(payload) => {
                     if (activeId) adapter.messages.send(activeId, payload);
                   }}

package/src/chat/SinglePopup.tsx

@@ -55,14 +55,17 @@ export type SinglePopupProps = {
   adapter: ChatAdapter;
   uiCallbacks?: ChatUICallbacks;
   theme?: ChatTheme;
-  /** Keys of footer toolbar actions to hide. e.g. ["addressCard", "translate"] */
-  hiddenActionKeys?: string[];
+  /**
+   * Allow-list of footer toolbar keys. Defaults to ["attachment", "emoji", "translate"].
+   * Pass e.g. ["attachment", "emoji", "translate", "addressCard"] to add location sharing.
+   */
+  footerActions?: string[];
 };
 
 /* ══════════════════════════════════════════════════
    Component
 ══════════════════════════════════════════════════ */
-const SinglePopup: React.FC<SinglePopupProps> = ({ adapter, uiCallbacks, theme, hiddenActionKeys }) => {
+const SinglePopup: React.FC<SinglePopupProps> = ({ adapter, uiCallbacks, theme, footerActions }) => {
   const { close, reference } = useChatUI();
   const { isOpen: isGalleryOpen, closeGallery } = useGallery();
 
@@ -260,7 +263,7 @@ const SinglePopup: React.FC<SinglePopupProps> = ({ adapter, uiCallbacks, theme,
               replyTo={replyTo}
               clearReply={() => setReplyTo(undefined)}
               onAfterSend={handleAfterSend}
-              hiddenActionKeys={hiddenActionKeys}
+              enabledActions={footerActions}
               onSend={(payload) => {
                 if (activeId) adapter.messages.send(activeId, payload);
               }}

package/src/ui/ChatFooter.tsx

@@ -39,9 +39,26 @@ type Props = {
   /** Called after send completes — triggers parent re-render / scroll */
   onAfterSend?: () => void;
 
-  actions?: FooterAction[];
-  /** Keys of actions to hide from the toolbar, e.g. ["businessCard", "addressCard"] */
-  hiddenActionKeys?: string[];
+  /**
+   * Allow-list of toolbar action keys to show.
+   * If omitted, defaults to ["attachment", "emoji", "translate"].
+   *
+   * Available keys:
+   *   "attachment"   — 📎 Attach file / image
+   *   "emoji"        — 😊 Emoji picker
+   *   "businessCard" — 👤 Share business card  (opt-in)
+   *   "addressCard"  — 📍 Share address card   (opt-in)
+   *   "translate"    — 🌐 Translation settings
+   *
+   * @example
+   * // InboxPopup: no location, no business card
+   * enabledActions={["attachment", "emoji", "translate"]}
+   *
+   * // SinglePopup: add location button
+   * enabledActions={["attachment", "emoji", "translate", "addressCard"]}
+   */
+  enabledActions?: string[];
+
   className?: string;
   maxRows?: number;
 
@@ -50,6 +67,13 @@ type Props = {
   clearReply?: () => void;
 };
 
+/**
+ * Default toolbar actions when `enabledActions` is not specified.
+ * businessCard and addressCard are opt-in (not shown by default).
+ */
+export const DEFAULT_FOOTER_ACTIONS: string[] = ["attachment", "emoji", "translate"];
+
+
 /* ────────────────────────── Utilities ─────────────────────────── */
 
 const fmtTime = (s: number) => `${Math.floor(s / 60)}:${String(s % 60).padStart(2, "0")}`;
@@ -69,36 +93,22 @@ const ChatFooter: React.FC<Props> = ({
   onAfterSend,
   className,
   maxRows = 4,
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  actions: _actions,
-  hiddenActionKeys = [],
+  enabledActions,
   replyTo,
   clearReply,
 }) => {
   const allActions: FooterAction[] = [
     { key: "attachment", title: "Attach file", icon: <AttachIcon className="h-4 w-4" /> },
-    { key: "emoji", title: "Add emoji", icon: <SmileIcon className="h-4 w-4" /> },
-    {
-      key: "businessCard",
-      title: "Share business card",
-      icon: <ProfileCardIcon className="h-4 w-4" />,
-    },
-    {
-      key: "addressCard",
-      title: "Share address",
-      icon: <MapIcon2 className="h-4 w-4" />,
-    },
-    {
-      key: "translate",
-      title: "Translation settings",
-      icon: <NewLanguageIcon className="h-4 w-4" />,
-    },
+    { key: "emoji",      title: "Add emoji",   icon: <SmileIcon className="h-4 w-4" /> },
+    { key: "businessCard", title: "Share business card", icon: <ProfileCardIcon className="h-4 w-4" /> },
+    { key: "addressCard",  title: "Share address",       icon: <MapIcon2 className="h-4 w-4" /> },
+    { key: "translate",    title: "Translation settings", icon: <NewLanguageIcon className="h-4 w-4" /> },
   ];
 
-  // Filter hidden actions
-  const actionData = hiddenActionKeys.length
-    ? allActions.filter((a) => !hiddenActionKeys.includes(a.key))
-    : allActions;
+  // Allow-list filter: show only explicitly requested keys.
+  // Falls back to DEFAULT_FOOTER_ACTIONS when enabledActions is not provided.
+  const allowed = enabledActions ?? DEFAULT_FOOTER_ACTIONS;
+  const actionData = allActions.filter((a) => allowed.includes(a.key));
 
   const textRef = useRef<HTMLTextAreaElement>(null);
   const emojiBtnRef = useRef<HTMLButtonElement | null>(null);