@fayz-ai/plugin-conversations 0.2.4 → 0.8.3

package/dist/index.js

@@ -1,24 +1,33 @@
 import React3 from 'react';
-import { registerTranslations, getSupabaseClientOptional, getActiveTenantId } from '@fayz-ai/core';
+import { registerTranslations, getSupabaseClientOptional, getActiveTenantId, useTranslation } from '@fayz-ai/core';
 import { useStore } from 'zustand';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { MessageSquare, Search, Inbox, ChevronLeft, Clock, Archive, PanelRight, Smile, Paperclip, Send, X, User, MapPin, Tag, StickyNote, Link2, Globe, Mail, Instagram, Phone } from 'lucide-react';
-import { cn, Input, Button } from '@fayz-ai/ui';
+import { MessageSquare, Plus, Search, Inbox, ChevronLeft, Clock, Archive, PanelRight, Send, X, User, MapPin, Tag, StickyNote, Link2, Globe, Mail, Instagram, Phone } from 'lucide-react';
+import { cn, Button, Input, Skeleton, Modal, ModalContent, toast } from '@fayz-ai/ui';
+import { PermissionGate, useLimitGuard, ContactPicker, invalidateLimit } from '@fayz-ai/saas';
 import { createStore } from 'zustand/vanilla';
 
 // src/index.ts
+var DEFAULT_CONVERSATIONS_CONFIG = {
+  contactKind: "contact"
+};
 var StoreContext = React3.createContext(null);
+var ConfigContext = React3.createContext(DEFAULT_CONVERSATIONS_CONFIG);
 function ConversationsContextProvider({
   store,
+  config = DEFAULT_CONVERSATIONS_CONFIG,
   children
 }) {
-  return /* @__PURE__ */ jsx(StoreContext.Provider, { value: store, children });
+  return /* @__PURE__ */ jsx(StoreContext.Provider, { value: store, children: /* @__PURE__ */ jsx(ConfigContext.Provider, { value: config, children }) });
 }
 function useConversationsStore(selector) {
   const store = React3.useContext(StoreContext);
   if (!store) throw new Error("useConversationsStore must be used within ConversationsPage");
   return useStore(store, selector);
 }
+function useConversationsConfig() {
+  return React3.useContext(ConfigContext);
+}
 
 // src/types.ts
 var CHANNEL_LABELS = {
@@ -121,15 +130,147 @@ function dayLabel(iso) {
   if (dayDiff < 7) return d.toLocaleDateString([], { weekday: "long" });
   return d.toLocaleDateString([], { month: "short", day: "numeric", year: now.getFullYear() === d.getFullYear() ? void 0 : "numeric" });
 }
-var FILTERS = [
-  { id: "all", label: "All" },
-  { id: "whatsapp", label: "WhatsApp" },
-  { id: "sms", label: "SMS" },
-  { id: "instagram", label: "Instagram" },
-  { id: "email", label: "Email" },
-  { id: "webchat", label: "Web" }
-];
+var CHANNELS = ["whatsapp", "sms", "instagram", "email", "webchat"];
+function personHandleFor(channel, contact) {
+  if (!contact) return "";
+  if (channel === "email") return contact.email ?? "";
+  if (channel === "sms" || channel === "whatsapp") return contact.phone ?? "";
+  return "";
+}
+var HANDLE_LABEL_KEY = {
+  whatsapp: "conversations.new.handleLabel.phone",
+  sms: "conversations.new.handleLabel.phone",
+  email: "conversations.new.handleLabel.email",
+  instagram: "conversations.new.handleLabel.instagram",
+  webchat: "conversations.new.handleLabel.webchat"
+};
+function NewConversationModal({
+  open,
+  onOpenChange
+}) {
+  const t = useTranslation();
+  const create = useConversationsStore((s) => s.create);
+  const config = useConversationsConfig();
+  const guardConversations = useLimitGuard("conversations_month");
+  const [channel, setChannel] = React3.useState("whatsapp");
+  const [contact, setContact] = React3.useState(null);
+  const [typedHandle, setTypedHandle] = React3.useState("");
+  const [creatingContact, setCreatingContact] = React3.useState(false);
+  const [firstMessage, setFirstMessage] = React3.useState("");
+  const [submitting, setSubmitting] = React3.useState(false);
+  const [pickerKey, setPickerKey] = React3.useState(0);
+  React3.useEffect(() => {
+    if (open) {
+      setChannel("whatsapp");
+      setContact(null);
+      setTypedHandle("");
+      setCreatingContact(false);
+      setFirstMessage("");
+      setSubmitting(false);
+      setPickerKey((k) => k + 1);
+    }
+  }, [open]);
+  const derivedHandle = personHandleFor(channel, contact);
+  const effectiveHandle = derivedHandle || typedHandle;
+  const handleLabel = t(HANDLE_LABEL_KEY[channel]);
+  const canSubmit = (contact?.name.trim().length ?? 0) > 0 && !submitting;
+  async function handleSubmit(e) {
+    e.preventDefault();
+    if (!canSubmit) return;
+    setSubmitting(true);
+    try {
+      if (await guardConversations() === "blocked") return;
+      await create({
+        channel,
+        contactName: contact.name.trim(),
+        contactPersonId: contact?.id,
+        contactHandle: effectiveHandle.trim() || void 0,
+        firstMessage: firstMessage.trim() || void 0
+      });
+      invalidateLimit("conversations_month");
+      onOpenChange(false);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      toast.error(t("conversations.new.createFailed"), { description: message });
+    } finally {
+      setSubmitting(false);
+    }
+  }
+  return /* @__PURE__ */ jsx(Modal, { open, onOpenChange, children: /* @__PURE__ */ jsx(ModalContent, { size: "md", children: /* @__PURE__ */ jsxs("form", { onSubmit: handleSubmit, className: "flex flex-col gap-4", children: [
+    /* @__PURE__ */ jsx("h2", { className: "text-base font-semibold text-foreground", children: t("conversations.new.title") }),
+    /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx("label", { className: "mb-1.5 block text-xs font-medium text-muted-foreground", children: t("conversations.new.channel") }),
+      /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1.5", children: CHANNELS.map((ch) => {
+        const Icon = CHANNEL_ICON[ch];
+        const active = channel === ch;
+        return /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            onClick: () => setChannel(ch),
+            "aria-pressed": active,
+            className: cn(
+              "inline-flex items-center gap-1.5 rounded-full px-3 py-1.5 text-xs font-medium transition-colors",
+              active ? "text-white" : "bg-muted text-muted-foreground hover:bg-muted/70"
+            ),
+            style: active ? { backgroundColor: CHANNEL_ACCENT[ch].color } : void 0,
+            children: [
+              /* @__PURE__ */ jsx(Icon, { className: "h-3 w-3" }),
+              CHANNEL_LABELS[ch]
+            ]
+          },
+          ch
+        );
+      }) })
+    ] }),
+    /* @__PURE__ */ jsx(
+      ContactPicker,
+      {
+        value: contact,
+        onChange: setContact,
+        kind: config.contactKind,
+        extensionTable: config.contactExtensionTable,
+        lookup: config.contactLookup,
+        allowFreeText: true,
+        onCreatingChange: setCreatingContact,
+        autoFocus: true,
+        label: t("conversations.new.contactName"),
+        placeholder: t("conversations.new.contactNamePlaceholder"),
+        secondaryText: derivedHandle || void 0,
+        handleField: {
+          label: handleLabel,
+          derived: derivedHandle || void 0,
+          value: typedHandle,
+          onChange: setTypedHandle,
+          fieldLabel: t("conversations.new.handle"),
+          placeholder: t("conversations.new.handlePlaceholder")
+        }
+      },
+      pickerKey
+    ),
+    /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx("label", { htmlFor: "conv-first-message", className: "mb-1.5 block text-xs font-medium text-muted-foreground", children: t("conversations.new.firstMessage") }),
+      /* @__PURE__ */ jsx(
+        "textarea",
+        {
+          id: "conv-first-message",
+          value: firstMessage,
+          onChange: (e) => setFirstMessage(e.target.value),
+          rows: 3,
+          placeholder: t("conversations.new.firstMessagePlaceholder"),
+          className: "max-h-40 min-h-[64px] w-full resize-none rounded-md border border-border bg-background px-3 py-2 text-sm text-foreground outline-none focus:border-primary"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "mt-1 flex justify-end gap-2", children: [
+      /* @__PURE__ */ jsx(Button, { type: "button", variant: "outline", onClick: () => onOpenChange(false), children: t("conversations.new.cancel") }),
+      /* @__PURE__ */ jsx(Button, { type: "submit", disabled: !canSubmit, children: submitting ? t("conversations.new.creating") : t("conversations.new.create") })
+    ] })
+  ] }) }) });
+}
+var FILTERS = ["all", "whatsapp", "sms", "instagram", "email", "webchat"];
 function ConversationList({ className }) {
+  const t = useTranslation();
   const {
     conversations,
     selectedId,
@@ -140,8 +281,25 @@ function ConversationList({ className }) {
     setChannelFilter,
     setSearch
   } = useConversationsStore((s) => s);
+  const [newOpen, setNewOpen] = React3.useState(false);
   return /* @__PURE__ */ jsxs("aside", { className: cn("w-full shrink-0 flex-col border-r border-border bg-card lg:w-[320px]", className), children: [
     /* @__PURE__ */ jsxs("div", { className: "border-b border-border px-3 py-3", children: [
+      /* @__PURE__ */ jsxs("div", { className: "mb-2 flex items-center justify-between gap-2", children: [
+        /* @__PURE__ */ jsx("span", { className: "text-sm font-semibold text-foreground", children: t("conversations.title") }),
+        /* @__PURE__ */ jsx(PermissionGate, { feature: "conversations", action: "create", children: /* @__PURE__ */ jsxs(
+          Button,
+          {
+            size: "sm",
+            onClick: () => setNewOpen(true),
+            "aria-label": t("conversations.list.new"),
+            "data-testid": "conversations-new",
+            children: [
+              /* @__PURE__ */ jsx(Plus, { className: "h-3.5 w-3.5 sm:mr-1" }),
+              /* @__PURE__ */ jsx("span", { className: "hidden sm:inline", children: t("conversations.list.new") })
+            ]
+          }
+        ) })
+      ] }),
       /* @__PURE__ */ jsxs("div", { className: "relative", children: [
         /* @__PURE__ */ jsx(Search, { className: "pointer-events-none absolute left-2.5 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground" }),
         /* @__PURE__ */ jsx(
@@ -149,29 +307,39 @@ function ConversationList({ className }) {
           {
             value: search,
             onChange: (e) => setSearch(e.target.value),
-            placeholder: "Search conversations",
+            placeholder: t("conversations.list.search"),
             className: "pl-8"
           }
         )
       ] }),
-      /* @__PURE__ */ jsx("div", { className: "mt-2 flex flex-wrap gap-1", children: FILTERS.map((f) => /* @__PURE__ */ jsx(
+      /* @__PURE__ */ jsx("div", { className: "mt-2 flex flex-wrap gap-1", children: FILTERS.map((id) => /* @__PURE__ */ jsx(
         "button",
         {
-          onClick: () => setChannelFilter(f.id),
+          onClick: () => setChannelFilter(id),
           className: cn(
             "rounded-full px-2.5 py-1 text-xs font-medium transition-colors",
-            channelFilter === f.id ? "bg-primary text-primary-foreground" : "bg-muted text-muted-foreground hover:bg-muted/70"
+            channelFilter === id ? "bg-primary text-primary-foreground" : "bg-muted text-muted-foreground hover:bg-muted/70"
           ),
-          children: f.label
+          children: t(`conversations.filter.${id}`)
         },
-        f.id
+        id
       )) })
     ] }),
     /* @__PURE__ */ jsxs("div", { className: "min-h-0 flex-1 overflow-y-auto", children: [
-      loading && conversations.length === 0 && /* @__PURE__ */ jsx("p", { className: "p-4 text-sm text-muted-foreground", children: "Loading\u2026" }),
+      loading && conversations.length === 0 && Array.from({ length: 6 }, (_, i) => /* @__PURE__ */ jsxs("div", { className: "flex w-full items-start gap-3 border-b border-border/50 px-3 py-3", children: [
+        /* @__PURE__ */ jsx(Skeleton, { className: "h-10 w-10 shrink-0 rounded-full" }),
+        /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2", children: [
+            /* @__PURE__ */ jsx(Skeleton, { className: "h-4 w-28" }),
+            /* @__PURE__ */ jsx(Skeleton, { className: "h-3 w-8" })
+          ] }),
+          /* @__PURE__ */ jsx(Skeleton, { className: "mt-1.5 h-4 w-16 rounded-full" }),
+          /* @__PURE__ */ jsx(Skeleton, { className: "mt-1.5 h-3 w-3/4" })
+        ] })
+      ] }, i)),
       !loading && conversations.length === 0 && /* @__PURE__ */ jsxs("div", { className: "flex flex-col items-center gap-2 p-8 text-center text-muted-foreground", children: [
         /* @__PURE__ */ jsx(Inbox, { className: "h-6 w-6" }),
-        /* @__PURE__ */ jsx("p", { className: "text-sm", children: "No conversations" })
+        /* @__PURE__ */ jsx("p", { className: "text-sm", children: t("conversations.list.empty") })
       ] }),
       conversations.map((c) => {
         const active = c.id === selectedId;
@@ -193,7 +361,7 @@ function ConversationList({ className }) {
                 ] }),
                 /* @__PURE__ */ jsxs("div", { className: "mt-1 flex items-center gap-2", children: [
                   /* @__PURE__ */ jsx(ChannelBadge, { channel: c.channel }),
-                  c.status !== "open" && /* @__PURE__ */ jsx("span", { className: "text-[10px] uppercase tracking-wide text-muted-foreground/70", children: c.status })
+                  c.status !== "open" && /* @__PURE__ */ jsx("span", { className: "text-[10px] uppercase tracking-wide text-muted-foreground/70", children: t(`conversations.status.${c.status}`) })
                 ] }),
                 /* @__PURE__ */ jsxs("div", { className: "mt-1 flex items-center justify-between gap-2", children: [
                   /* @__PURE__ */ jsx("span", { className: cn("truncate text-xs", unread ? "text-foreground" : "text-muted-foreground"), children: c.lastMessagePreview }),
@@ -205,7 +373,8 @@ function ConversationList({ className }) {
           c.id
         );
       })
-    ] })
+    ] }),
+    /* @__PURE__ */ jsx(NewConversationModal, { open: newOpen, onOpenChange: setNewOpen })
   ] });
 }
 function buildRows(messages) {
@@ -226,6 +395,7 @@ function buildRows(messages) {
   return rows;
 }
 function MessageThread({ selected, onTogglePanel, panelOpen, onBack, className }) {
+  const t = useTranslation();
   const { messages, sending, send, setStatus } = useConversationsStore((s) => s);
   const [draft, setDraft] = React3.useState("");
   const threadRef = React3.useRef(null);
@@ -243,7 +413,7 @@ function MessageThread({ selected, onTogglePanel, panelOpen, onBack, className }
   return /* @__PURE__ */ jsxs("section", { className: cn("flex min-w-0 flex-1 flex-col bg-muted/20", className), children: [
     /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2 border-b border-border bg-card px-3 py-2.5 md:px-5", children: [
       /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 items-center gap-2 md:gap-3", children: [
-        onBack && /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon", className: "-ml-1 shrink-0 lg:hidden", onClick: onBack, "aria-label": "Back to conversations", children: /* @__PURE__ */ jsx(ChevronLeft, { className: "h-5 w-5" }) }),
+        onBack && /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon", className: "-ml-1 shrink-0 lg:hidden", onClick: onBack, "aria-label": t("conversations.thread.back"), children: /* @__PURE__ */ jsx(ChevronLeft, { className: "h-5 w-5" }) }),
         /* @__PURE__ */ jsx(Avatar, { name: selected.contactName, accent: selected.accent, size: "sm", channel: selected.channel }),
         /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
           /* @__PURE__ */ jsx("p", { className: "truncate text-sm font-semibold text-foreground", children: selected.contactName }),
@@ -254,15 +424,15 @@ function MessageThread({ selected, onTogglePanel, panelOpen, onBack, className }
         ] })
       ] }),
       /* @__PURE__ */ jsxs("div", { className: "flex shrink-0 items-center gap-1.5", children: [
-        /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", onClick: () => setStatus("snoozed"), "aria-label": "Snooze", children: [
+        /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", onClick: () => setStatus("snoozed"), "aria-label": t("conversations.thread.snooze"), children: [
           /* @__PURE__ */ jsx(Clock, { className: "h-3.5 w-3.5 sm:mr-1" }),
           " ",
-          /* @__PURE__ */ jsx("span", { className: "hidden sm:inline", children: "Snooze" })
+          /* @__PURE__ */ jsx("span", { className: "hidden sm:inline", children: t("conversations.thread.snooze") })
         ] }),
-        /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", onClick: () => setStatus("closed"), "aria-label": "Close conversation", children: [
+        /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", onClick: () => setStatus("closed"), "aria-label": t("conversations.thread.close"), children: [
           /* @__PURE__ */ jsx(Archive, { className: "h-3.5 w-3.5 sm:mr-1" }),
           " ",
-          /* @__PURE__ */ jsx("span", { className: "hidden sm:inline", children: "Close" })
+          /* @__PURE__ */ jsx("span", { className: "hidden sm:inline", children: t("conversations.thread.close") })
         ] }),
         /* @__PURE__ */ jsx(
           Button,
@@ -270,7 +440,7 @@ function MessageThread({ selected, onTogglePanel, panelOpen, onBack, className }
             variant: panelOpen ? "secondary" : "ghost",
             size: "icon",
             onClick: onTogglePanel,
-            "aria-label": "Toggle contact details",
+            "aria-label": t("conversations.thread.details"),
             children: /* @__PURE__ */ jsx(PanelRight, { className: "h-4 w-4" })
           }
         )
@@ -310,12 +480,10 @@ function MessageThread({ selected, onTogglePanel, panelOpen, onBack, className }
       }),
       rows.length === 0 && /* @__PURE__ */ jsxs("div", { className: "flex h-full flex-col items-center justify-center text-muted-foreground", children: [
         /* @__PURE__ */ jsx(MessageSquare, { className: "h-7 w-7" }),
-        /* @__PURE__ */ jsx("p", { className: "mt-2 text-sm", children: "No messages yet" })
+        /* @__PURE__ */ jsx("p", { className: "mt-2 text-sm", children: t("conversations.thread.empty") })
       ] })
     ] }),
     /* @__PURE__ */ jsx("div", { className: "border-t border-border bg-card px-4 py-3", children: /* @__PURE__ */ jsxs("div", { className: "flex items-end gap-2", children: [
-      /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon", className: "mb-0.5 text-muted-foreground", "aria-label": "Add emoji", children: /* @__PURE__ */ jsx(Smile, { className: "h-4 w-4" }) }),
-      /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon", className: "mb-0.5 text-muted-foreground", "aria-label": "Attach file", children: /* @__PURE__ */ jsx(Paperclip, { className: "h-4 w-4" }) }),
       /* @__PURE__ */ jsx(
         "textarea",
         {
@@ -328,11 +496,11 @@ function MessageThread({ selected, onTogglePanel, panelOpen, onBack, className }
             }
           },
           rows: 1,
-          placeholder: `Reply via ${CHANNEL_LABELS[selected.channel]}\u2026`,
+          placeholder: t("conversations.thread.reply", { channel: CHANNEL_LABELS[selected.channel] }),
           className: "max-h-32 min-h-[40px] flex-1 resize-none rounded-md border border-border bg-background px-3 py-2 text-sm text-foreground outline-none focus:border-primary"
         }
       ),
-      /* @__PURE__ */ jsx(Button, { onClick: () => void handleSend(), disabled: sending || !draft.trim(), "aria-label": "Send", children: /* @__PURE__ */ jsx(Send, { className: "h-4 w-4" }) })
+      /* @__PURE__ */ jsx(Button, { onClick: () => void handleSend(), disabled: sending || !draft.trim(), "aria-label": t("conversations.thread.send"), children: /* @__PURE__ */ jsx(Send, { className: "h-4 w-4" }) })
     ] }) })
   ] });
 }
@@ -347,10 +515,11 @@ function Section({ icon: Icon, title, children }) {
   ] });
 }
 function ContactPanel({ contact, onClose, className }) {
+  const t = useTranslation();
   return /* @__PURE__ */ jsxs("aside", { className: cn("flex shrink-0 flex-col overflow-y-auto border-l border-border bg-card", className), children: [
     onClose && /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between border-b border-border px-3 py-2 xl:hidden", children: [
-      /* @__PURE__ */ jsx("span", { className: "text-sm font-semibold text-foreground", children: "Details" }),
-      /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon", onClick: onClose, "aria-label": "Close details", children: /* @__PURE__ */ jsx(X, { className: "h-4 w-4" }) })
+      /* @__PURE__ */ jsx("span", { className: "text-sm font-semibold text-foreground", children: t("conversations.contact.details") }),
+      /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon", onClick: onClose, "aria-label": t("conversations.contact.closeDetails"), children: /* @__PURE__ */ jsx(X, { className: "h-4 w-4" }) })
     ] }),
     /* @__PURE__ */ jsxs("div", { className: "flex flex-col items-center gap-2 px-4 py-5 text-center", children: [
       /* @__PURE__ */ jsx(Avatar, { name: contact.contactName, accent: contact.accent, size: "lg", channel: contact.channel }),
@@ -360,33 +529,35 @@ function ContactPanel({ contact, onClose, className }) {
       ] }),
       /* @__PURE__ */ jsx(ChannelBadge, { channel: contact.channel })
     ] }),
-    /* @__PURE__ */ jsx(Section, { icon: User, title: "Details", children: /* @__PURE__ */ jsxs("dl", { className: "space-y-1.5 text-sm", children: [
+    /* @__PURE__ */ jsx(Section, { icon: User, title: t("conversations.contact.details"), children: /* @__PURE__ */ jsxs("dl", { className: "space-y-1.5 text-sm", children: [
       /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2", children: [
-        /* @__PURE__ */ jsx("dt", { className: "text-muted-foreground", children: "Channel" }),
+        /* @__PURE__ */ jsx("dt", { className: "text-muted-foreground", children: t("conversations.contact.channel") }),
         /* @__PURE__ */ jsx("dd", { className: "text-foreground", children: CHANNEL_LABELS[contact.channel] })
       ] }),
       /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2", children: [
-        /* @__PURE__ */ jsx("dt", { className: "text-muted-foreground", children: "Status" }),
-        /* @__PURE__ */ jsx("dd", { className: "capitalize text-foreground", children: contact.status })
+        /* @__PURE__ */ jsx("dt", { className: "text-muted-foreground", children: t("conversations.contact.status") }),
+        /* @__PURE__ */ jsx("dd", { className: "text-foreground", children: t(`conversations.status.${contact.status}`) })
       ] }),
       contact.assignedTo && /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2", children: [
-        /* @__PURE__ */ jsx("dt", { className: "text-muted-foreground", children: "Assigned to" }),
+        /* @__PURE__ */ jsx("dt", { className: "text-muted-foreground", children: t("conversations.contact.assignedTo") }),
         /* @__PURE__ */ jsx("dd", { className: "text-foreground", children: contact.assignedTo })
       ] }),
       contact.location && /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2", children: [
         /* @__PURE__ */ jsxs("dt", { className: "flex items-center gap-1 text-muted-foreground", children: [
           /* @__PURE__ */ jsx(MapPin, { className: "h-3 w-3" }),
-          " Location"
+          " ",
+          t("conversations.contact.location")
         ] }),
         /* @__PURE__ */ jsx("dd", { className: "text-foreground", children: contact.location })
       ] })
     ] }) }),
-    contact.tags.length > 0 && /* @__PURE__ */ jsx(Section, { icon: Tag, title: "Tags", children: /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1.5", children: contact.tags.map((tag) => /* @__PURE__ */ jsx("span", { className: "rounded-full bg-muted px-2 py-0.5 text-xs font-medium text-foreground", children: tag }, tag)) }) }),
-    contact.note && /* @__PURE__ */ jsx(Section, { icon: StickyNote, title: "Note", children: /* @__PURE__ */ jsx("p", { className: "text-sm text-foreground", children: contact.note }) }),
-    /* @__PURE__ */ jsx(Section, { icon: Link2, title: "Linked records", children: /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: "No linked records yet." }) })
+    contact.tags.length > 0 && /* @__PURE__ */ jsx(Section, { icon: Tag, title: t("conversations.contact.tags"), children: /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1.5", children: contact.tags.map((tag) => /* @__PURE__ */ jsx("span", { className: "rounded-full bg-muted px-2 py-0.5 text-xs font-medium text-foreground", children: tag }, tag)) }) }),
+    contact.note && /* @__PURE__ */ jsx(Section, { icon: StickyNote, title: t("conversations.contact.note"), children: /* @__PURE__ */ jsx("p", { className: "text-sm text-foreground", children: contact.note }) }),
+    /* @__PURE__ */ jsx(Section, { icon: Link2, title: t("conversations.contact.linkedRecords"), children: /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: t("conversations.contact.noLinkedRecords") }) })
   ] });
 }
 function InboxView() {
+  const t = useTranslation();
   const { conversations, selectedId, deselect } = useConversationsStore((s) => s);
   const isWidePanel = useMediaQuery("(min-width: 1280px)");
   const [panelOpen, setPanelOpen] = React3.useState(false);
@@ -407,7 +578,7 @@ function InboxView() {
       }
     ) : /* @__PURE__ */ jsxs("section", { className: "hidden min-w-0 flex-1 flex-col items-center justify-center bg-muted/20 text-muted-foreground lg:flex", children: [
       /* @__PURE__ */ jsx(MessageSquare, { className: "h-9 w-9" }),
-      /* @__PURE__ */ jsx("p", { className: "mt-2 text-sm", children: "Select a conversation to start chatting" })
+      /* @__PURE__ */ jsx("p", { className: "mt-2 text-sm", children: t("conversations.empty.select") })
     ] }),
     selected && panelOpen && /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsx(
@@ -429,13 +600,22 @@ function InboxView() {
     ] })
   ] });
 }
-function ConversationsPage({ store }) {
+function ConversationsPage({ store, config }) {
   React3.useEffect(() => {
     void store.getState().load();
   }, []);
-  return /* @__PURE__ */ jsx(ConversationsContextProvider, { store, children: /* @__PURE__ */ jsx(InboxView, {}) });
+  return /* @__PURE__ */ jsx(ConversationsContextProvider, { store, config, children: /* @__PURE__ */ jsx(InboxView, {}) });
 }
 
+// src/data/accents.ts
+var CHANNEL_ACCENT_HEX = {
+  whatsapp: "#22c55e",
+  sms: "#6366f1",
+  instagram: "#ec4899",
+  email: "#0ea5e9",
+  webchat: "#f59e0b"
+};
+
 // src/data/mock.ts
 function minutesAgo(base, mins) {
   return new Date(base - mins * 6e4).toISOString();
@@ -545,12 +725,59 @@ function seed() {
 function msg(id, conversationId, channel, direction, body, author, at) {
   return { id, conversationId, channel, direction, body, author, at };
 }
-function createMockConversationsProvider() {
-  const { conversations, messages } = seed();
-  let counter = 100;
+function createMockConversationsProvider(config) {
+  const selfAuthor = config?.selfAuthor ?? "You";
+  function resolveTenant() {
+    const raw = typeof config?.tenantId === "function" ? config.tenantId() : config?.tenantId;
+    return raw || "default";
+  }
+  const storageKey = () => `saas:mock:conversations:${resolveTenant()}`;
+  function hasStorage() {
+    try {
+      return typeof window !== "undefined" && !!window.localStorage;
+    } catch {
+      return false;
+    }
+  }
+  function load() {
+    if (hasStorage()) {
+      try {
+        const raw = window.localStorage.getItem(storageKey());
+        if (raw) {
+          const parsed = JSON.parse(raw);
+          if (Array.isArray(parsed.conversations) && Array.isArray(parsed.messages)) {
+            return {
+              conversations: parsed.conversations,
+              messages: parsed.messages,
+              counter: parsed.counter ?? 100
+            };
+          }
+        }
+      } catch {
+      }
+    }
+    const seeded = seed();
+    return { conversations: seeded.conversations, messages: seeded.messages, counter: 100 };
+  }
+  const state = load();
+  function persist() {
+    if (!hasStorage()) return;
+    try {
+      window.localStorage.setItem(
+        storageKey(),
+        JSON.stringify({
+          conversations: state.conversations,
+          messages: state.messages,
+          counter: state.counter
+        })
+      );
+    } catch {
+    }
+  }
+  persist();
   return {
     async listConversations(query) {
-      let list = [...conversations];
+      let list = [...state.conversations];
       if (query?.channel && query.channel !== "all") list = list.filter((c) => c.channel === query.channel);
       if (query?.status && query.status !== "all") list = list.filter((c) => c.status === query.status);
       if (query?.search) {
@@ -562,44 +789,92 @@ function createMockConversationsProvider() {
       return list.sort((a, b) => b.lastMessageAt.localeCompare(a.lastMessageAt));
     },
     async getMessages(conversationId) {
-      return messages.filter((m) => m.conversationId === conversationId).sort((a, b) => a.at.localeCompare(b.at));
+      return state.messages.filter((m) => m.conversationId === conversationId).sort((a, b) => a.at.localeCompare(b.at));
+    },
+    async createConversation(input) {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const firstMessage = input.firstMessage?.trim();
+      const id = `c${++state.counter}`;
+      const conversation = {
+        id,
+        contactName: input.contactName.trim(),
+        contactPersonId: input.contactPersonId,
+        contactHandle: input.contactHandle?.trim() ?? "",
+        channel: input.channel,
+        lastMessagePreview: firstMessage ?? "",
+        lastMessageAt: now,
+        unreadCount: 0,
+        status: "open",
+        assignedTo: selfAuthor,
+        accent: CHANNEL_ACCENT_HEX[input.channel],
+        tags: [],
+        note: input.note?.trim() || void 0
+      };
+      state.conversations.unshift(conversation);
+      if (firstMessage) {
+        state.messages.push({
+          id: `m${++state.counter}`,
+          conversationId: id,
+          channel: input.channel,
+          direction: "outbound",
+          body: firstMessage,
+          author: selfAuthor,
+          at: now
+        });
+      }
+      persist();
+      return conversation;
     },
     async sendMessage(input) {
-      const conv = conversations.find((c) => c.id === input.conversationId);
+      const conv = state.conversations.find((c) => c.id === input.conversationId);
       const created = {
-        id: `m${++counter}`,
+        id: `m${++state.counter}`,
         conversationId: input.conversationId,
         channel: conv?.channel ?? "sms",
         direction: "outbound",
         body: input.body,
-        author: "You",
+        author: selfAuthor,
         at: (/* @__PURE__ */ new Date()).toISOString()
       };
-      messages.push(created);
+      state.messages.push(created);
       if (conv) {
         conv.lastMessagePreview = input.body;
         conv.lastMessageAt = created.at;
         conv.unreadCount = 0;
         if (conv.status === "closed") conv.status = "open";
       }
+      persist();
       return created;
     },
     async markRead(conversationId) {
-      const conv = conversations.find((c) => c.id === conversationId);
-      if (conv) conv.unreadCount = 0;
+      const conv = state.conversations.find((c) => c.id === conversationId);
+      if (conv && conv.unreadCount !== 0) {
+        conv.unreadCount = 0;
+        persist();
+      }
     },
     async setStatus(conversationId, status) {
-      const conv = conversations.find((c) => c.id === conversationId);
+      const conv = state.conversations.find((c) => c.id === conversationId);
       if (!conv) throw new Error("Conversation not found");
       conv.status = status;
+      persist();
       return conv;
     }
   };
 }
+
+// src/data/tables.ts
+var T = {
+  conversations: "plg_conversations",
+  messages: "plg_conversation_messages"
+};
+
+// src/data/supabase.ts
 function mapConversation(r) {
   return {
     id: String(r.id),
     contactName: r.contact_name ?? "",
+    contactPersonId: r.contact_person_id ?? void 0,
     contactHandle: r.contact_handle ?? "",
     channel: r.channel ?? "sms",
     lastMessagePreview: r.last_message_preview ?? "",
@@ -641,7 +916,7 @@ function createSupabaseConversationsProvider(config) {
   }
   return {
     async listConversations(query) {
-      let q = client().from("conversations").select("*");
+      let q = client().from(T.conversations).select("*");
       const tenantId = resolveTenantId();
       if (tenantId) q = q.eq("tenant_id", tenantId);
       if (query?.channel && query.channel !== "all") {
@@ -664,7 +939,7 @@ function createSupabaseConversationsProvider(config) {
       return (data ?? []).map(mapConversation);
     },
     async getMessages(conversationId) {
-      const selected = client().from("conversation_messages").select("*");
+      const selected = client().from(T.messages).select("*");
       const filtered = selected.eq(
         "conversation_id",
         conversationId
@@ -676,9 +951,51 @@ function createSupabaseConversationsProvider(config) {
       if (error) throw error;
       return (data ?? []).map(mapMessage);
     },
+    async createConversation(input) {
+      const tenantId = resolveTenantId();
+      if (!tenantId) {
+        throw new Error("[plugin-conversations] Active tenant not resolved \u2014 cannot create conversation. Try again in a moment.");
+      }
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const firstMessage = input.firstMessage?.trim();
+      const convRow = {
+        contact_name: input.contactName.trim(),
+        // Only written when the picker resolved a real person — an app that
+        // hasn't run migration 002 yet would reject an unknown column, and
+        // omitting it keeps the free-text path working there.
+        ...input.contactPersonId ? { contact_person_id: input.contactPersonId } : {},
+        contact_handle: input.contactHandle?.trim() || null,
+        channel: input.channel,
+        last_message_preview: firstMessage || null,
+        last_message_at: now,
+        unread_count: 0,
+        status: "open",
+        assigned_to: selfAuthor,
+        accent: CHANNEL_ACCENT_HEX[input.channel],
+        tags: [],
+        note: input.note?.trim() || null
+      };
+      if (tenantId) convRow.tenant_id = tenantId;
+      const { data: created, error } = await client().from(T.conversations).insert(convRow).select().single();
+      if (error) throw error;
+      if (!created) throw new Error("Conversation not created");
+      if (firstMessage) {
+        const msgRow = {
+          conversation_id: String(created.id),
+          channel: input.channel,
+          direction: "outbound",
+          body: firstMessage,
+          author: selfAuthor,
+          at: now
+        };
+        if (tenantId) msgRow.tenant_id = tenantId;
+        await client().from(T.messages).insert(msgRow);
+      }
+      return mapConversation(created);
+    },
     async sendMessage(input) {
       const tenantId = resolveTenantId();
-      const convSelected = client().from("conversations").select(
+      const convSelected = client().from(T.conversations).select(
         "channel"
       );
       const convFiltered = convSelected.eq(
@@ -697,9 +1014,9 @@ function createSupabaseConversationsProvider(config) {
         at
       };
       if (tenantId) row.tenant_id = tenantId;
-      const { data: created, error } = await client().from("conversation_messages").insert(row).select().single();
+      const { data: created, error } = await client().from(T.messages).insert(row).select().single();
       if (error) throw error;
-      await client().from("conversations").update({
+      await client().from(T.conversations).update({
         last_message_preview: input.body,
         last_message_at: at,
         unread_count: 0,
@@ -708,13 +1025,13 @@ function createSupabaseConversationsProvider(config) {
       return mapMessage(created ?? row);
     },
     async markRead(conversationId) {
-      const { error } = await client().from("conversations").update({
+      const { error } = await client().from(T.conversations).update({
         unread_count: 0
       }).eq("id", conversationId);
       if (error) throw error;
     },
     async setStatus(conversationId, status) {
-      const updated = client().from("conversations").update({
+      const updated = client().from(T.conversations).update({
         status
       });
       const filtered = updated.eq("id", conversationId);
@@ -765,6 +1082,25 @@ function createConversationsStore(provider) {
       set({ search });
       await get().load();
     },
+    async create(input) {
+      const created = await provider.createConversation(input);
+      set((s) => ({
+        channelFilter: "all",
+        search: "",
+        conversations: [created, ...s.conversations.filter((c) => c.id !== created.id)],
+        selectedId: created.id
+      }));
+      void (async () => {
+        try {
+          const conversations = await provider.listConversations({});
+          const merged = conversations.some((c) => c.id === created.id) ? conversations : [created, ...conversations];
+          set({ conversations: merged });
+          await get().select(created.id);
+        } catch {
+        }
+      })();
+      return created;
+    },
     async send(body) {
       const id = get().selectedId;
       if (!id || !body.trim()) return;
@@ -792,26 +1128,266 @@ function createConversationsStore(provider) {
 // src/locales/en.ts
 var en = {
   "conversations.title": "Conversations",
-  "conversations.subtitle": "Unified inbox across every channel"
+  "conversations.subtitle": "Unified inbox across every channel",
+  // Conversation list
+  "conversations.list.search": "Search conversations",
+  "conversations.list.loading": "Loading\u2026",
+  "conversations.list.empty": "No conversations",
+  "conversations.list.new": "New conversation",
+  // Channel filters
+  "conversations.filter.all": "All",
+  "conversations.filter.whatsapp": "WhatsApp",
+  "conversations.filter.sms": "SMS",
+  "conversations.filter.instagram": "Instagram",
+  "conversations.filter.email": "Email",
+  "conversations.filter.webchat": "Web",
+  // Status labels
+  "conversations.status.open": "Open",
+  "conversations.status.snoozed": "Snoozed",
+  "conversations.status.closed": "Closed",
+  // Empty state
+  "conversations.empty.select": "Select a conversation to start chatting",
+  // Thread
+  "conversations.thread.back": "Back to conversations",
+  "conversations.thread.snooze": "Snooze",
+  "conversations.thread.close": "Close",
+  "conversations.thread.details": "Toggle contact details",
+  "conversations.thread.empty": "No messages yet",
+  "conversations.thread.reply": "Reply via {{channel}}\u2026",
+  "conversations.thread.send": "Send",
+  // Contact panel
+  "conversations.contact.details": "Details",
+  "conversations.contact.closeDetails": "Close details",
+  "conversations.contact.channel": "Channel",
+  "conversations.contact.status": "Status",
+  "conversations.contact.assignedTo": "Assigned to",
+  "conversations.contact.location": "Location",
+  "conversations.contact.tags": "Tags",
+  "conversations.contact.note": "Note",
+  "conversations.contact.linkedRecords": "Linked records",
+  "conversations.contact.noLinkedRecords": "No linked records yet.",
+  // New-conversation modal
+  "conversations.new.title": "New conversation",
+  "conversations.new.channel": "Channel",
+  "conversations.new.contactName": "Contact name",
+  "conversations.new.contactNamePlaceholder": "e.g. Jane Doe",
+  "conversations.new.handle": "Phone / handle / email",
+  "conversations.new.handlePlaceholder": "+1 555 000 0000",
+  // The handle field only surfaces when the picked contact has nothing usable
+  // for the active channel — otherwise it is derived and shown on the chip.
+  "conversations.new.addHandle": "Add {label}",
+  "conversations.new.handleLabel.phone": "phone",
+  "conversations.new.handleLabel.email": "email",
+  "conversations.new.handleLabel.instagram": "Instagram handle",
+  "conversations.new.handleLabel.webchat": "web chat id",
+  "conversations.new.firstMessage": "First message",
+  "conversations.new.firstMessagePlaceholder": "Write the first message (optional)\u2026",
+  "conversations.new.cancel": "Cancel",
+  "conversations.new.create": "Start conversation",
+  "conversations.new.creating": "Starting\u2026",
+  "conversations.new.createFailed": "Could not create the conversation"
+};
+
+// src/locales/pt-BR.ts
+var ptBR = {
+  "conversations.title": "Conversas",
+  "conversations.subtitle": "Caixa de entrada unificada de todos os canais",
+  // Lista de conversas
+  "conversations.list.search": "Buscar conversas",
+  "conversations.list.loading": "Carregando\u2026",
+  "conversations.list.empty": "Nenhuma conversa",
+  "conversations.list.new": "Nova conversa",
+  // Filtros de canal
+  "conversations.filter.all": "Todas",
+  "conversations.filter.whatsapp": "WhatsApp",
+  "conversations.filter.sms": "SMS",
+  "conversations.filter.instagram": "Instagram",
+  "conversations.filter.email": "E-mail",
+  "conversations.filter.webchat": "Web",
+  // Rótulos de status
+  "conversations.status.open": "Aberta",
+  "conversations.status.snoozed": "Adiada",
+  "conversations.status.closed": "Encerrada",
+  // Estado vazio
+  "conversations.empty.select": "Selecione uma conversa para come\xE7ar a conversar",
+  // Thread
+  "conversations.thread.back": "Voltar \xE0s conversas",
+  "conversations.thread.snooze": "Adiar",
+  "conversations.thread.close": "Encerrar",
+  "conversations.thread.details": "Alternar detalhes do contato",
+  "conversations.thread.empty": "Nenhuma mensagem ainda",
+  "conversations.thread.reply": "Responder via {{channel}}\u2026",
+  "conversations.thread.send": "Enviar",
+  // Painel do contato
+  "conversations.contact.details": "Detalhes",
+  "conversations.contact.closeDetails": "Fechar detalhes",
+  "conversations.contact.channel": "Canal",
+  "conversations.contact.status": "Status",
+  "conversations.contact.assignedTo": "Respons\xE1vel",
+  "conversations.contact.location": "Localiza\xE7\xE3o",
+  "conversations.contact.tags": "Etiquetas",
+  "conversations.contact.note": "Nota",
+  "conversations.contact.linkedRecords": "Registros vinculados",
+  "conversations.contact.noLinkedRecords": "Nenhum registro vinculado ainda.",
+  // Modal de nova conversa
+  "conversations.new.title": "Nova conversa",
+  "conversations.new.channel": "Canal",
+  "conversations.new.contactName": "Nome do contato",
+  "conversations.new.contactNamePlaceholder": "ex.: Maria Silva",
+  "conversations.new.handle": "Telefone / usu\xE1rio / e-mail",
+  "conversations.new.handlePlaceholder": "+55 11 99999-0000",
+  // O campo de handle só aparece quando o contato escolhido não tem o dado do
+  // canal ativo — caso contrário ele é derivado e mostrado no chip.
+  "conversations.new.addHandle": "Adicionar {label}",
+  "conversations.new.handleLabel.phone": "telefone",
+  "conversations.new.handleLabel.email": "e-mail",
+  "conversations.new.handleLabel.instagram": "@ do Instagram",
+  "conversations.new.handleLabel.webchat": "id do chat",
+  "conversations.new.firstMessage": "Primeira mensagem",
+  "conversations.new.firstMessagePlaceholder": "Escreva a primeira mensagem (opcional)\u2026",
+  "conversations.new.cancel": "Cancelar",
+  "conversations.new.create": "Iniciar conversa",
+  "conversations.new.creating": "Iniciando\u2026",
+  "conversations.new.createFailed": "N\xE3o foi poss\xEDvel criar a conversa"
 };
 
 // src/locales/index.ts
 var conversationsLocales = {
-  en
+  en,
+  "pt-BR": ptBR
 };
 
+// src/migrations/index.ts
+var MIGRATION_001_CONVERSATIONS = `-- ============================================================================
+-- plugin-conversations 001: omni-channel inbox model (SMS / WhatsApp /
+-- Instagram / Email / Web chat). Prefix: plg_conversations / plg_conversation_messages.
+--   \xA71  plg_conversations          \u2014 one thread per contact+channel
+--   \xA72  plg_conversation_messages  \u2014 inbound/outbound messages within a thread
+--   \xA73  RLS: authenticated tenant-scoped CRUD on both tables + GRANTs
+--
+-- Column names mirror exactly what supabase.ts's mapConversation / mapMessage
+-- read. Real channel connectors (Twilio, WhatsApp Cloud, Meta, IMAP) deliver
+-- inbound rows here out-of-band; the provider is the read/compose surface.
+-- Idempotent + safe to re-run.
+-- ============================================================================
+
+-- \xA71 \u2014 conversations (threads)
+CREATE TABLE IF NOT EXISTS public.plg_conversations (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
+  contact_name text NOT NULL,
+  contact_handle text,
+  channel text NOT NULL
+    CHECK (channel IN ('sms', 'whatsapp', 'instagram', 'email', 'webchat')),
+  last_message_preview text,
+  last_message_at timestamptz DEFAULT now(),
+  unread_count int DEFAULT 0,
+  status text DEFAULT 'open'
+    CHECK (status IN ('open', 'snoozed', 'closed')),
+  assigned_to text,
+  accent text,
+  tags text[],
+  location text,
+  note text,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.plg_conversations ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_plg_conversations_tenant ON public.plg_conversations(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_plg_conversations_tenant_recent ON public.plg_conversations(tenant_id, last_message_at DESC);
+
+-- \xA72 \u2014 messages
+CREATE TABLE IF NOT EXISTS public.plg_conversation_messages (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
+  conversation_id uuid NOT NULL REFERENCES public.plg_conversations(id) ON DELETE CASCADE,
+  channel text
+    CHECK (channel IS NULL OR channel IN ('sms', 'whatsapp', 'instagram', 'email', 'webchat')),
+  direction text
+    CHECK (direction IN ('inbound', 'outbound')),
+  body text NOT NULL,
+  author text,
+  at timestamptz DEFAULT now()
+);
+ALTER TABLE public.plg_conversation_messages ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_plg_conversation_messages_thread ON public.plg_conversation_messages(conversation_id, at);
+
+-- \xA73 \u2014 RLS: authenticated tenant CRUD (the inbox reads/writes here)
+DROP POLICY IF EXISTS plg_conversations_select ON public.plg_conversations;
+DROP POLICY IF EXISTS plg_conversations_insert ON public.plg_conversations;
+DROP POLICY IF EXISTS plg_conversations_update ON public.plg_conversations;
+DROP POLICY IF EXISTS plg_conversations_delete ON public.plg_conversations;
+CREATE POLICY plg_conversations_select ON public.plg_conversations FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_conversations_insert ON public.plg_conversations FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_conversations_update ON public.plg_conversations FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_conversations_delete ON public.plg_conversations FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+GRANT SELECT, INSERT, UPDATE, DELETE ON public.plg_conversations TO authenticated;
+
+DROP POLICY IF EXISTS plg_conversation_messages_select ON public.plg_conversation_messages;
+DROP POLICY IF EXISTS plg_conversation_messages_insert ON public.plg_conversation_messages;
+DROP POLICY IF EXISTS plg_conversation_messages_update ON public.plg_conversation_messages;
+DROP POLICY IF EXISTS plg_conversation_messages_delete ON public.plg_conversation_messages;
+CREATE POLICY plg_conversation_messages_select ON public.plg_conversation_messages FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_conversation_messages_insert ON public.plg_conversation_messages FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_conversation_messages_update ON public.plg_conversation_messages FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_conversation_messages_delete ON public.plg_conversation_messages FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+GRANT SELECT, INSERT, UPDATE, DELETE ON public.plg_conversation_messages TO authenticated;
+`;
+var MIGRATION_002_CONTACT_PERSON = `-- ============================================================================
+-- plugin-conversations 002: link a thread to a REAL person record.
+--
+-- The compose modal used to take a free-text name + handle, so a conversation
+-- with "Maria" had nothing to do with the Maria in the agenda, the CRM or the
+-- financial module. The shared ContactPicker (find-or-create over
+-- public.people) now resolves a person, and this column stores that link.
+--
+-- Nullable on purpose, in both directions of time:
+--   \u2022 rows created before this migration keep working (name/handle only);
+--   \u2022 an inbound message from an unknown number still opens a thread with no
+--     person attached \u2014 the contact panel can offer "create contact" later.
+-- ON DELETE SET NULL: deleting a person must never take their history with it.
+-- Idempotent + safe to re-run.
+-- ============================================================================
+
+ALTER TABLE public.plg_conversations
+  ADD COLUMN IF NOT EXISTS contact_person_id uuid REFERENCES public.people(id) ON DELETE SET NULL;
+
+CREATE INDEX IF NOT EXISTS idx_plg_conversations_person
+  ON public.plg_conversations(tenant_id, contact_person_id)
+  WHERE contact_person_id IS NOT NULL;
+`;
+
 // src/index.ts
 function createSafeProvider() {
-  if (getSupabaseClientOptional()) {
-    return createSupabaseConversationsProvider({ tenantId: () => getActiveTenantId() });
-  }
-  return createMockConversationsProvider();
+  let real = null;
+  let mock = null;
+  const resolve = () => {
+    if (getSupabaseClientOptional()) {
+      real ?? (real = createSupabaseConversationsProvider({ tenantId: () => getActiveTenantId() }));
+      return real;
+    }
+    mock ?? (mock = createMockConversationsProvider({ tenantId: () => getActiveTenantId() }));
+    return mock;
+  };
+  return {
+    listConversations: (...a) => resolve().listConversations(...a),
+    getMessages: (...a) => resolve().getMessages(...a),
+    sendMessage: (...a) => resolve().sendMessage(...a),
+    markRead: (...a) => resolve().markRead(...a),
+    setStatus: (...a) => resolve().setStatus(...a),
+    createConversation: (...a) => resolve().createConversation(...a)
+  };
 }
 function createConversationsPlugin(options) {
   registerTranslations(conversationsLocales);
   const provider = options?.dataProvider ?? createSafeProvider();
   const store = createConversationsStore(provider);
-  const PageComponent = () => React3.createElement(ConversationsPage, { store });
+  const config = {
+    contactKind: options?.contactKind ?? "contact",
+    contactExtensionTable: options?.contactExtensionTable,
+    contactLookup: options?.contactLookup
+  };
+  const PageComponent = () => React3.createElement(ConversationsPage, { store, config });
   PageComponent.displayName = "ConversationsPage";
   return {
     id: "conversations",
@@ -823,6 +1399,10 @@ function createConversationsPlugin(options) {
     defaultEnabled: true,
     dependencies: [],
     declaredFeatures: [{ id: "conversations", label: "Conversations", group: "Engage" }],
+    // Recurring monthly quota — counts conversation threads created this month.
+    declaredLimits: [
+      { key: "conversations_month", label: "Conversations this month", table: "plg_conversations", period: "month" }
+    ],
     navigation: [
       {
         section: options?.navSection ?? "main",
@@ -887,6 +1467,20 @@ function createConversationsPlugin(options) {
         permission: { feature: "conversations", action: "create" }
       }
     ],
+    migrations: [
+      {
+        id: "conversations-001-base-tables",
+        version: "1.0.0",
+        sql: MIGRATION_001_CONVERSATIONS,
+        description: "Create plg_conversations and plg_conversation_messages (tenant-scoped RLS)"
+      },
+      {
+        id: "conversations-002-contact-person",
+        version: "1.1.0",
+        sql: MIGRATION_002_CONTACT_PERSON,
+        description: "Link threads to public.people via contact_person_id (nullable, ON DELETE SET NULL)"
+      }
+    ],
     locales: conversationsLocales
   };
 }