@fayz-ai/plugin-conversations 0.2.4 → 0.8.3

package/src/data/supabase.ts

@@ -1,10 +1,13 @@
 import { getSupabaseClientOptional } from '@fayz-ai/core'
 import type { ConversationsProvider } from './types'
+import { T } from './tables'
+import { CHANNEL_ACCENT_HEX } from './accents'
 import type {
   Conversation,
   Message,
   ListConversationsQuery,
   SendMessageInput,
+  CreateConversationInput,
   ConversationStatus,
 } from '../types'
 
@@ -34,6 +37,7 @@ function mapConversation(r: Row): Conversation {
   return {
     id: String(r.id),
     contactName: (r.contact_name as string) ?? '',
+    contactPersonId: (r.contact_person_id as string | null) ?? undefined,
     contactHandle: (r.contact_handle as string) ?? '',
     channel: (r.channel as Conversation['channel']) ?? 'sms',
     lastMessagePreview: (r.last_message_preview as string) ?? '',
@@ -84,7 +88,7 @@ export function createSupabaseConversationsProvider(
 
   return {
     async listConversations(query?: ListConversationsQuery): Promise<Conversation[]> {
-      let q = (client().from('conversations') as { select: (s: string) => Row }).select('*')
+      let q = (client().from(T.conversations) as { select: (s: string) => Row }).select('*')
 
       const tenantId = resolveTenantId()
       if (tenantId) q = (q as { eq: (c: string, v: string) => Row }).eq('tenant_id', tenantId)
@@ -111,7 +115,7 @@ export function createSupabaseConversationsProvider(
 
     async getMessages(conversationId: string): Promise<Message[]> {
       const selected = (
-        client().from('conversation_messages') as { select: (s: string) => Row }
+        client().from(T.messages) as { select: (s: string) => Row }
       ).select('*')
       const filtered = (selected as { eq: (c: string, v: string) => Row }).eq(
         'conversation_id',
@@ -125,11 +129,69 @@ export function createSupabaseConversationsProvider(
       return (data ?? []).map(mapMessage)
     },
 
+    async createConversation(input: CreateConversationInput): Promise<Conversation> {
+      const tenantId = resolveTenantId()
+      // Insert with a null tenant_id fails the plg_conversations RLS WITH CHECK
+      // (tenant_id ∈ user_tenant_ids()) with an opaque Postgres error. When the
+      // active tenant hasn't resolved yet (bootstrap race), fail fast with an
+      // actionable message the compose modal can surface via toast.
+      if (!tenantId) {
+        throw new Error('[plugin-conversations] Active tenant not resolved — cannot create conversation. Try again in a moment.')
+      }
+      const now = new Date().toISOString()
+      const firstMessage = input.firstMessage?.trim()
+
+      const convRow: Row = {
+        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) as { insert: (r: Row) => Row }).insert(convRow) as {
+          select: () => { single: () => Promise<{ data: Row | null; error: unknown }> }
+        }
+      )
+        .select()
+        .single()) as { data: Row | null; error: unknown }
+      if (error) throw error
+      if (!created) throw new Error('Conversation not created')
+
+      // Seed the thread with the first outbound message when provided.
+      if (firstMessage) {
+        const msgRow: Row = {
+          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) as { insert: (r: Row) => Promise<unknown> }).insert(msgRow)
+      }
+
+      return mapConversation(created)
+    },
+
     async sendMessage(input: SendMessageInput): Promise<Message> {
       const tenantId = resolveTenantId()
 
       // Resolve the channel from the parent conversation so the message matches.
-      const convSelected = (client().from('conversations') as { select: (s: string) => Row }).select(
+      const convSelected = (client().from(T.conversations) as { select: (s: string) => Row }).select(
         'channel',
       )
       const convFiltered = (convSelected as { eq: (c: string, v: string) => Row }).eq(
@@ -153,7 +215,7 @@ export function createSupabaseConversationsProvider(
       if (tenantId) row.tenant_id = tenantId
 
       const { data: created, error } = (await (
-        (client().from('conversation_messages') as { insert: (r: Row) => Row }).insert(row) as {
+        (client().from(T.messages) as { insert: (r: Row) => Row }).insert(row) as {
           select: () => { single: () => Promise<{ data: Row | null; error: unknown }> }
         }
       )
@@ -163,7 +225,7 @@ export function createSupabaseConversationsProvider(
 
       // Roll the parent conversation forward (preview / timestamp / unread / reopen).
       await (
-        (client().from('conversations') as {
+        (client().from(T.conversations) as {
           update: (r: Row) => Row
         }).update({
           last_message_preview: input.body,
@@ -178,7 +240,7 @@ export function createSupabaseConversationsProvider(
 
     async markRead(conversationId: string): Promise<void> {
       const { error } = (await (
-        (client().from('conversations') as { update: (r: Row) => Row }).update({
+        (client().from(T.conversations) as { update: (r: Row) => Row }).update({
           unread_count: 0,
         }) as { eq: (c: string, v: string) => Promise<{ error: unknown }> }
       ).eq('id', conversationId)) as { error: unknown }
@@ -186,7 +248,7 @@ export function createSupabaseConversationsProvider(
     },
 
     async setStatus(conversationId: string, status: ConversationStatus): Promise<Conversation> {
-      const updated = (client().from('conversations') as { update: (r: Row) => Row }).update({
+      const updated = (client().from(T.conversations) as { update: (r: Row) => Row }).update({
         status,
       })
       const filtered = (updated as { eq: (c: string, v: string) => Row }).eq('id', conversationId)

package/src/data/tables.ts

@@ -0,0 +1,7 @@
+// Physical table names for the conversations plugin (plg_conversations* prefix).
+// Import T and reference T.<key> in the data provider so a rename lands in
+// exactly one place.
+export const T = {
+  conversations: 'plg_conversations',
+  messages: 'plg_conversation_messages',
+} as const

package/src/data/types.ts

@@ -3,12 +3,14 @@ import type {
   Message,
   ListConversationsQuery,
   SendMessageInput,
+  CreateConversationInput,
   ConversationStatus,
 } from '../types'
 
 export interface ConversationsProvider {
   listConversations(query?: ListConversationsQuery): Promise<Conversation[]>
   getMessages(conversationId: string): Promise<Message[]>
+  createConversation(input: CreateConversationInput): Promise<Conversation>
   sendMessage(input: SendMessageInput): Promise<Message>
   markRead(conversationId: string): Promise<void>
   setStatus(conversationId: string, status: ConversationStatus): Promise<Conversation>

package/src/index.ts

@@ -1,20 +1,25 @@
 import React from 'react'
 import type { PluginManifest, PluginScope, VerticalId } from '@fayz-ai/core'
 import { getActiveTenantId, getSupabaseClientOptional, registerTranslations } from '@fayz-ai/core'
+import type { EntityLookup } from '@fayz-ai/saas'
 import { ConversationsPage } from './ConversationsPage'
+import type { ResolvedConversationsConfig } from './ConversationsContext'
 import type { ConversationsProvider } from './data/types'
 import { createMockConversationsProvider } from './data/mock'
 import { createSupabaseConversationsProvider } from './data/supabase'
 import { createConversationsStore } from './store'
 import { conversationsLocales } from './locales'
+import { MIGRATION_001_CONVERSATIONS, MIGRATION_002_CONTACT_PERSON } from './migrations'
 
 // ---------------------------------------------------------------------------
 // @fayz-ai/plugin-conversations — the GoHighLevel "Conversations" equivalent:
 // one omni-channel inbox (SMS / WhatsApp / Instagram / Email / Web chat).
 // Universal plugin — reusable by any vertical (beauty, resto, agency…).
 //
-// M1 ships a full mock inbox. Real channel connectors (Twilio, WhatsApp Cloud,
-// Meta, IMAP) + Supabase-backed threads land in a later milestone.
+// Supabase-backed (plg_conversations / plg_conversation_messages, tenant-scoped
+// via RLS) when a client is registered; a persisted mock inbox otherwise. Real
+// channel connectors (Twilio, WhatsApp Cloud, Meta, IMAP) deliver inbound rows
+// out-of-band; this plugin is the read/compose surface.
 // ---------------------------------------------------------------------------
 
 export interface ConversationsPluginOptions {
@@ -24,16 +29,45 @@ export interface ConversationsPluginOptions {
   scope?: PluginScope
   verticalId?: VerticalId
   dataProvider?: ConversationsProvider
+
+  /**
+   * `people.kind` for contacts created from the compose modal's picker. Each
+   * vertical names its people differently (beauty 'client', agency 'lead'),
+   * hence a knob rather than a hardcoded value. Default: 'contact'.
+   */
+  contactKind?: string
+  /**
+   * Per-vertical extension table linked by `person_id` (e.g. 'clients'). Pools
+   * without it live off `public.people` alone — absent is not an error.
+   */
+  contactExtensionTable?: string
+  /** Custom search source for the picker. Defaults to the person archetype lookup. */
+  contactLookup?: EntityLookup
 }
 
 function createSafeProvider(): ConversationsProvider {
-  // Real data when a Supabase client is registered (reads/writes the
-  // `conversations` + `conversation_messages` tables, tenant-scoped via the
-  // active-org context); falls back to the mock inbox when no backend is wired.
-  if (getSupabaseClientOptional()) {
-    return createSupabaseConversationsProvider({ tenantId: () => getActiveTenantId() })
+  // Real data when a Supabase client is registered; mock inbox otherwise.
+  // Resolution is LAZY (per call): createConversationsPlugin runs at module
+  // scope in the app config, BEFORE the Supabase client is registered — an
+  // eager check here would capture the mock forever even on live backends.
+  let real: ConversationsProvider | null = null
+  let mock: ConversationsProvider | null = null
+  const resolve = (): ConversationsProvider => {
+    if (getSupabaseClientOptional()) {
+      real ??= createSupabaseConversationsProvider({ tenantId: () => getActiveTenantId() })
+      return real
+    }
+    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),
   }
-  return createMockConversationsProvider()
 }
 
 export function createConversationsPlugin(options?: ConversationsPluginOptions): PluginManifest {
@@ -41,8 +75,14 @@ export function createConversationsPlugin(options?: ConversationsPluginOptions):
   const provider = options?.dataProvider ?? createSafeProvider()
   const store = createConversationsStore(provider)
 
+  const config: ResolvedConversationsConfig = {
+    contactKind: options?.contactKind ?? 'contact',
+    contactExtensionTable: options?.contactExtensionTable,
+    contactLookup: options?.contactLookup,
+  }
+
   const PageComponent: React.ComponentType<unknown> = () =>
-    React.createElement(ConversationsPage, { store })
+    React.createElement(ConversationsPage, { store, config })
   PageComponent.displayName = 'ConversationsPage'
 
   return {
@@ -55,6 +95,10 @@ export function createConversationsPlugin(options?: ConversationsPluginOptions):
     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',
@@ -119,13 +163,27 @@ export function createConversationsPlugin(options?: ConversationsPluginOptions):
         permission: { feature: 'conversations', action: 'create' as const },
       },
     ],
+    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,
   }
 }
 
 export type { ConversationsProvider } from './data/types'
-export type { Conversation, Message, Channel } from './types'
-export { createMockConversationsProvider } from './data/mock'
+export type { Conversation, Message, Channel, CreateConversationInput } from './types'
+export { createMockConversationsProvider, type MockConversationsConfig } from './data/mock'
 export {
   createSupabaseConversationsProvider,
   type SupabaseConversationsConfig,

package/src/locales/en.ts

@@ -1,4 +1,68 @@
 export const en: Record<string, string> = {
   'conversations.title': 'Conversations',
   'conversations.subtitle': 'Unified inbox across every channel',
+
+  // Conversation list
+  'conversations.list.search': 'Search conversations',
+  'conversations.list.loading': 'Loading…',
+  '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}}…',
+  '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)…',
+  'conversations.new.cancel': 'Cancel',
+  'conversations.new.create': 'Start conversation',
+  'conversations.new.creating': 'Starting…',
+  'conversations.new.createFailed': 'Could not create the conversation',
 }

package/src/locales/index.ts

@@ -1,5 +1,7 @@
 import { en } from './en'
+import { ptBR } from './pt-BR'
 
 export const conversationsLocales: Record<string, Record<string, string>> = {
   en,
+  'pt-BR': ptBR,
 }

package/src/locales/pt-BR.ts

@@ -0,0 +1,68 @@
+export const ptBR: Record<string, string> = {
+  '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…',
+  '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çar a conversar',
+
+  // Thread
+  'conversations.thread.back': 'Voltar às 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}}…',
+  '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ável',
+  'conversations.contact.location': 'Localização',
+  '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ário / 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)…',
+  'conversations.new.cancel': 'Cancelar',
+  'conversations.new.create': 'Iniciar conversa',
+  'conversations.new.creating': 'Iniciando…',
+  'conversations.new.createFailed': 'Não foi possível criar a conversa',
+}

package/src/migrations/001_conversations.sql

@@ -0,0 +1,74 @@
+-- ============================================================================
+-- plugin-conversations 001: omni-channel inbox model (SMS / WhatsApp /
+-- Instagram / Email / Web chat). Prefix: plg_conversations / plg_conversation_messages.
+--   §1  plg_conversations          — one thread per contact+channel
+--   §2  plg_conversation_messages  — inbound/outbound messages within a thread
+--   §3  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.
+-- ============================================================================
+
+-- §1 — 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);
+
+-- §2 — 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);
+
+-- §3 — 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;

package/src/migrations/002_contact_person.sql

@@ -0,0 +1,22 @@
+-- ============================================================================
+-- 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:
+--   • rows created before this migration keep working (name/handle only);
+--   • an inbound message from an unknown number still opens a thread with no
+--     person attached — 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;

package/src/migrations/index.ts

@@ -0,0 +1,108 @@
+// AUTO-GENERATED from 001_conversations.sql, 002_contact_person.sql — regenerate with scripts/embed-migrations.mjs
+// SQL files are the source of truth; this inline copy lets the manifest declare
+// migrations as data. Do not edit by hand — run the embed script instead.
+
+export const MIGRATION_001_CONVERSATIONS = `-- ============================================================================
+-- plugin-conversations 001: omni-channel inbox model (SMS / WhatsApp /
+-- Instagram / Email / Web chat). Prefix: plg_conversations / plg_conversation_messages.
+--   §1  plg_conversations          — one thread per contact+channel
+--   §2  plg_conversation_messages  — inbound/outbound messages within a thread
+--   §3  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.
+-- ============================================================================
+
+-- §1 — 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);
+
+-- §2 — 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);
+
+-- §3 — 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;
+`
+
+export const 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:
+--   • rows created before this migration keep working (name/handle only);
+--   • an inbound message from an unknown number still opens a thread with no
+--     person attached — 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;
+`
+
+export const MIGRATIONS: Array<{ id: string; sql: string }> = [
+  { id: "001_conversations", sql: MIGRATION_001_CONVERSATIONS },
+  { id: "002_contact_person", sql: MIGRATION_002_CONTACT_PERSON },
+]