@fayz-ai/plugin-conversations 0.8.0 → 0.9.0-next.0

package/dist/migrations/index.d.ts

@@ -0,0 +1,7 @@
+export declare const MIGRATION_001_CONVERSATIONS = "-- ============================================================================\n-- plugin-conversations 001: omni-channel inbox model (SMS / WhatsApp /\n-- Instagram / Email / Web chat). Prefix: plg_conversations / plg_conversation_messages.\n--   \u00A71  plg_conversations          \u2014 one thread per contact+channel\n--   \u00A72  plg_conversation_messages  \u2014 inbound/outbound messages within a thread\n--   \u00A73  RLS: authenticated tenant-scoped CRUD on both tables + GRANTs\n--\n-- Column names mirror exactly what supabase.ts's mapConversation / mapMessage\n-- read. Real channel connectors (Twilio, WhatsApp Cloud, Meta, IMAP) deliver\n-- inbound rows here out-of-band; the provider is the read/compose surface.\n-- Idempotent + safe to re-run.\n-- ============================================================================\n\n-- \u00A71 \u2014 conversations (threads)\nCREATE TABLE IF NOT EXISTS public.plg_conversations (\n  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),\n  tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,\n  contact_name text NOT NULL,\n  contact_handle text,\n  channel text NOT NULL\n    CHECK (channel IN ('sms', 'whatsapp', 'instagram', 'email', 'webchat')),\n  last_message_preview text,\n  last_message_at timestamptz DEFAULT now(),\n  unread_count int DEFAULT 0,\n  status text DEFAULT 'open'\n    CHECK (status IN ('open', 'snoozed', 'closed')),\n  assigned_to text,\n  accent text,\n  tags text[],\n  location text,\n  note text,\n  created_at timestamptz NOT NULL DEFAULT now(),\n  updated_at timestamptz NOT NULL DEFAULT now()\n);\nALTER TABLE public.plg_conversations ENABLE ROW LEVEL SECURITY;\nCREATE INDEX IF NOT EXISTS idx_plg_conversations_tenant ON public.plg_conversations(tenant_id);\nCREATE INDEX IF NOT EXISTS idx_plg_conversations_tenant_recent ON public.plg_conversations(tenant_id, last_message_at DESC);\n\n-- \u00A72 \u2014 messages\nCREATE TABLE IF NOT EXISTS public.plg_conversation_messages (\n  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),\n  tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,\n  conversation_id uuid NOT NULL REFERENCES public.plg_conversations(id) ON DELETE CASCADE,\n  channel text\n    CHECK (channel IS NULL OR channel IN ('sms', 'whatsapp', 'instagram', 'email', 'webchat')),\n  direction text\n    CHECK (direction IN ('inbound', 'outbound')),\n  body text NOT NULL,\n  author text,\n  at timestamptz DEFAULT now()\n);\nALTER TABLE public.plg_conversation_messages ENABLE ROW LEVEL SECURITY;\nCREATE INDEX IF NOT EXISTS idx_plg_conversation_messages_thread ON public.plg_conversation_messages(conversation_id, at);\n\n-- \u00A73 \u2014 RLS: authenticated tenant CRUD (the inbox reads/writes here)\nDROP POLICY IF EXISTS plg_conversations_select ON public.plg_conversations;\nDROP POLICY IF EXISTS plg_conversations_insert ON public.plg_conversations;\nDROP POLICY IF EXISTS plg_conversations_update ON public.plg_conversations;\nDROP POLICY IF EXISTS plg_conversations_delete ON public.plg_conversations;\nCREATE POLICY plg_conversations_select ON public.plg_conversations FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));\nCREATE POLICY plg_conversations_insert ON public.plg_conversations FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));\nCREATE POLICY plg_conversations_update ON public.plg_conversations FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));\nCREATE POLICY plg_conversations_delete ON public.plg_conversations FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));\nGRANT SELECT, INSERT, UPDATE, DELETE ON public.plg_conversations TO authenticated;\n\nDROP POLICY IF EXISTS plg_conversation_messages_select ON public.plg_conversation_messages;\nDROP POLICY IF EXISTS plg_conversation_messages_insert ON public.plg_conversation_messages;\nDROP POLICY IF EXISTS plg_conversation_messages_update ON public.plg_conversation_messages;\nDROP POLICY IF EXISTS plg_conversation_messages_delete ON public.plg_conversation_messages;\nCREATE POLICY plg_conversation_messages_select ON public.plg_conversation_messages FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));\nCREATE POLICY plg_conversation_messages_insert ON public.plg_conversation_messages FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));\nCREATE POLICY plg_conversation_messages_update ON public.plg_conversation_messages FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));\nCREATE POLICY plg_conversation_messages_delete ON public.plg_conversation_messages FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));\nGRANT SELECT, INSERT, UPDATE, DELETE ON public.plg_conversation_messages TO authenticated;\n";
+export declare const MIGRATION_002_CONTACT_PERSON = "-- ============================================================================\n-- plugin-conversations 002: link a thread to a REAL person record.\n--\n-- The compose modal used to take a free-text name + handle, so a conversation\n-- with \"Maria\" had nothing to do with the Maria in the agenda, the CRM or the\n-- financial module. The shared ContactPicker (find-or-create over\n-- public.people) now resolves a person, and this column stores that link.\n--\n-- Nullable on purpose, in both directions of time:\n--   \u2022 rows created before this migration keep working (name/handle only);\n--   \u2022 an inbound message from an unknown number still opens a thread with no\n--     person attached \u2014 the contact panel can offer \"create contact\" later.\n-- ON DELETE SET NULL: deleting a person must never take their history with it.\n-- Idempotent + safe to re-run.\n-- ============================================================================\n\nALTER TABLE public.plg_conversations\n  ADD COLUMN IF NOT EXISTS contact_person_id uuid REFERENCES public.people(id) ON DELETE SET NULL;\n\nCREATE INDEX IF NOT EXISTS idx_plg_conversations_person\n  ON public.plg_conversations(tenant_id, contact_person_id)\n  WHERE contact_person_id IS NOT NULL;\n";
+export declare const MIGRATIONS: Array<{
+    id: string;
+    sql: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,2BAA2B,gyJA0EvC,CAAA;AAED,eAAO,MAAM,4BAA4B,mvCAsBxC,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAGzD,CAAA"}

package/dist/store.d.ts

@@ -1,6 +1,6 @@
 import { type StoreApi } from 'zustand/vanilla';
 import type { ConversationsProvider } from './data/types';
-import type { Conversation, Message, Channel, ConversationStatus } from './types';
+import type { Conversation, Message, Channel, ConversationStatus, CreateConversationInput } from './types';
 export interface ConversationsUIState {
     conversations: Conversation[];
     messages: Message[];
@@ -14,6 +14,7 @@ export interface ConversationsUIState {
     deselect(): void;
     setChannelFilter(channel: Channel | 'all'): Promise<void>;
     setSearch(search: string): Promise<void>;
+    create(input: CreateConversationInput): Promise<Conversation>;
     send(body: string): Promise<void>;
     setStatus(status: ConversationStatus): Promise<void>;
 }

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAEjF,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,EAAE,OAAO,GAAG,KAAK,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAEhB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,QAAQ,IAAI,IAAI,CAAA;IAChB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrD;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,qBAAqB,GAC9B,QAAQ,CAAC,oBAAoB,CAAC,CAoEhC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,OAAO,EACP,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,EAAE,OAAO,GAAG,KAAK,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAEhB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,QAAQ,IAAI,IAAI,CAAA;IAChB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC7D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrD;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,qBAAqB,GAC9B,QAAQ,CAAC,oBAAoB,CAAC,CAwGhC"}

package/dist/types.d.ts

@@ -4,6 +4,12 @@ export type MessageDirection = 'inbound' | 'outbound';
 export interface Conversation {
     id: string;
     contactName: string;
+    /**
+     * `public.people` id when the thread is tied to a real contact record (the
+     * compose modal resolves one via the shared ContactPicker). Absent for legacy
+     * threads and for inbound messages from an unknown handle.
+     */
+    contactPersonId?: string;
     /** Phone, @handle, or email depending on channel */
     contactHandle: string;
     channel: Channel;
@@ -36,5 +42,17 @@ export interface SendMessageInput {
     conversationId: string;
     body: string;
 }
+export interface CreateConversationInput {
+    contactName: string;
+    /** `public.people` id, when the contact was resolved/created by the picker. */
+    contactPersonId?: string;
+    /** Phone, @handle, or email depending on channel. */
+    contactHandle?: string;
+    channel: Channel;
+    /** Optional first outbound message; stamps preview + last_message_at. */
+    firstMessage?: string;
+    /** Optional free-text note surfaced in the contact panel. */
+    note?: string;
+}
 export declare const CHANNEL_LABELS: Record<Channel, string>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;AAE5E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE9D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,CAAA;AAErD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,EAAE,CAAA;IAEd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IACzB,MAAM,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAMlD,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;AAE5E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE9D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,CAAA;AAErD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,EAAE,CAAA;IAEd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IACzB,MAAM,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAMlD,CAAA"}

package/dist/views/ContactPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContactPanel.d.ts","sourceRoot":"","sources":["../../src/views/ContactPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAkB5C,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE;IAC5D,OAAO,EAAE,YAAY,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,qBAoEA"}
+{"version":3,"file":"ContactPanel.d.ts","sourceRoot":"","sources":["../../src/views/ContactPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAkB5C,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE;IAC5D,OAAO,EAAE,YAAY,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,qBAqEA"}

package/dist/views/ConversationList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConversationList.d.ts","sourceRoot":"","sources":["../../src/views/ConversationList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,qBA2FrE"}
+{"version":3,"file":"ConversationList.d.ts","sourceRoot":"","sources":["../../src/views/ConversationList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAYzB,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,qBA0HrE"}

package/dist/views/InboxView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InboxView.d.ts","sourceRoot":"","sources":["../../src/views/InboxView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,wBAAgB,SAAS,sBAoDxB"}
+{"version":3,"file":"InboxView.d.ts","sourceRoot":"","sources":["../../src/views/InboxView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB,wBAAgB,SAAS,sBAqDxB"}

package/dist/views/MessageThread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageThread.d.ts","sourceRoot":"","sources":["../../src/views/MessageThread.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,UAAU,CAAA;AA2BrD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;IACvF,QAAQ,EAAE,YAAY,CAAA;IACtB,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,qBAkIA"}
+{"version":3,"file":"MessageThread.d.ts","sourceRoot":"","sources":["../../src/views/MessageThread.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,UAAU,CAAA;AA2BrD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;IACvF,QAAQ,EAAE,YAAY,CAAA;IACtB,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,qBA+HA"}

package/dist/views/NewConversationModal.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+export declare function NewConversationModal({ open, onOpenChange, }: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}): React.JSX.Element;
+//# sourceMappingURL=NewConversationModal.d.ts.map

package/dist/views/NewConversationModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NewConversationModal.d.ts","sourceRoot":"","sources":["../../src/views/NewConversationModal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgCzB,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,YAAY,GACb,EAAE;IACD,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;CACtC,qBAqKA"}

package/package.json

@@ -3,18 +3,18 @@
   "fayz": {
     "status": "preview"
   },
-  "version": "0.8.0",
+  "version": "0.9.0-next.0",
   "description": "[experimental] Fayz SDK — unified conversations / omni-channel inbox plugin",
   "type": "module",
-  "main": "./dist/index.cjs",
+  "sideEffects": false,
+  "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "source": "./src/index.ts",
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": "./dist/index.js"
     }
   },
   "files": [
@@ -23,21 +23,24 @@
   ],
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "zustand": "^4.5.0",
+    "lucide-react": ">=0.400.0 <1.0.0"
   },
   "dependencies": {
-    "lucide-react": "^0.400.0",
-    "zustand": "^4.5.0",
-    "@fayz-ai/core": "^0.8.0",
-    "@fayz-ai/ui": "^0.8.0",
-    "@fayz-ai/saas": "^0.8.0"
+    "@fayz-ai/core": "^0.9.0-next.0",
+    "@fayz-ai/ui": "^0.9.0-next.0",
+    "@fayz-ai/saas": "^0.9.0-next.0"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",
     "react": "^18.3.0",
     "tsup": "^8.2.0",
     "typescript": "^5.5.0",
-    "@types/react-dom": "^18.3.0"
+    "@types/react-dom": "^18.3.0",
+    "vitest": "^2.1.9",
+    "zustand": "^4.5.0",
+    "lucide-react": "^0.400.0"
   },
   "license": "MIT",
   "keywords": [
@@ -52,6 +55,7 @@
     "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap --noEmit false",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
     "clean": "rm -rf dist"
   }
 }

package/src/ConversationsContext.tsx

@@ -1,17 +1,43 @@
 import React from 'react'
 import { useStore, type StoreApi } from 'zustand'
+import type { EntityLookup } from '@fayz-ai/saas'
 import type { ConversationsUIState } from './store'
 
+/**
+ * App-tunable knobs the inbox UI reads. Kept tiny on purpose: everything here
+ * describes the APP's data shape (which people are "contacts" in this vertical),
+ * never product policy.
+ */
+export interface ResolvedConversationsConfig {
+  /** `people.kind` used when the compose modal creates a contact. */
+  contactKind: string
+  /** Per-vertical extension table linked by `person_id` (skipped when absent). */
+  contactExtensionTable?: string
+  /** Search source for the contact picker. Defaults to the person archetype. */
+  contactLookup?: EntityLookup
+}
+
+export const DEFAULT_CONVERSATIONS_CONFIG: ResolvedConversationsConfig = {
+  contactKind: 'contact',
+}
+
 const StoreContext = React.createContext<StoreApi<ConversationsUIState> | null>(null)
+const ConfigContext = React.createContext<ResolvedConversationsConfig>(DEFAULT_CONVERSATIONS_CONFIG)
 
 export function ConversationsContextProvider({
   store,
+  config = DEFAULT_CONVERSATIONS_CONFIG,
   children,
 }: {
   store: StoreApi<ConversationsUIState>
+  config?: ResolvedConversationsConfig
   children?: React.ReactNode
 }) {
-  return <StoreContext.Provider value={store}>{children}</StoreContext.Provider>
+  return (
+    <StoreContext.Provider value={store}>
+      <ConfigContext.Provider value={config}>{children}</ConfigContext.Provider>
+    </StoreContext.Provider>
+  )
 }
 
 export function useConversationsStore<T>(selector: (state: ConversationsUIState) => T): T {
@@ -19,3 +45,7 @@ export function useConversationsStore<T>(selector: (state: ConversationsUIState)
   if (!store) throw new Error('useConversationsStore must be used within ConversationsPage')
   return useStore(store, selector)
 }
+
+export function useConversationsConfig(): ResolvedConversationsConfig {
+  return React.useContext(ConfigContext)
+}

package/src/ConversationsPage.tsx

@@ -1,17 +1,20 @@
 import React from 'react'
 import type { StoreApi } from 'zustand/vanilla'
-import { ConversationsContextProvider } from './ConversationsContext'
+import { ConversationsContextProvider, type ResolvedConversationsConfig } from './ConversationsContext'
 import type { ConversationsUIState } from './store'
 import { InboxView } from './views/InboxView'
 
-export function ConversationsPage({ store }: { store: StoreApi<ConversationsUIState> }) {
+export function ConversationsPage({ store, config }: {
+  store: StoreApi<ConversationsUIState>
+  config?: ResolvedConversationsConfig
+}) {
   React.useEffect(() => {
     void store.getState().load()
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [])
 
   return (
-    <ConversationsContextProvider store={store}>
+    <ConversationsContextProvider store={store} config={config}>
       <InboxView />
     </ConversationsContextProvider>
   )

package/src/data/accents.ts

@@ -0,0 +1,12 @@
+import type { Channel } from '../types'
+
+// Solid brand hex per channel — mirrors CHANNEL_ACCENT in ../channel.ts but
+// React-free so the data providers can stamp a sensible avatar accent on new
+// conversations without importing the icon layer.
+export const CHANNEL_ACCENT_HEX: Record<Channel, string> = {
+  whatsapp: '#22c55e',
+  sms: '#6366f1',
+  instagram: '#ec4899',
+  email: '#0ea5e9',
+  webchat: '#f59e0b',
+}

package/src/data/mock.test.ts

@@ -0,0 +1,90 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
+import { createMockConversationsProvider } from './mock'
+
+// Minimal localStorage shim so we can exercise the persistence path (the mock
+// guards on `typeof window`, degrading to pure memory when absent).
+function installLocalStorage(): void {
+  const store = new Map<string, string>()
+  const localStorage = {
+    getItem: (k: string) => (store.has(k) ? store.get(k)! : null),
+    setItem: (k: string, v: string) => void store.set(k, String(v)),
+    removeItem: (k: string) => void store.delete(k),
+    clear: () => void store.clear(),
+  }
+  ;(globalThis as unknown as { window: unknown }).window = { localStorage }
+}
+
+function uninstallLocalStorage(): void {
+  delete (globalThis as unknown as { window?: unknown }).window
+}
+
+describe('plugin-conversations · mock provider', () => {
+  it('ships a typed seed', async () => {
+    const provider = createMockConversationsProvider()
+    const list = await provider.listConversations()
+    expect(list.length).toBeGreaterThan(0)
+    expect(list[0].contactName).toBeTruthy()
+  })
+
+  it('createConversation → sendMessage → list persists within the session', async () => {
+    const provider = createMockConversationsProvider({ tenantId: 'test-tenant' })
+
+    const created = await provider.createConversation({
+      channel: 'sms',
+      contactName: 'Ada Lovelace',
+      contactHandle: '+1 555 010 0000',
+      firstMessage: 'Hello there',
+    })
+    expect(created.id).toBeTruthy()
+    expect(created.channel).toBe('sms')
+    expect(created.contactName).toBe('Ada Lovelace')
+    expect(created.lastMessagePreview).toBe('Hello there')
+
+    // The seeded first message is present.
+    const seededMsgs = await provider.getMessages(created.id)
+    expect(seededMsgs).toHaveLength(1)
+    expect(seededMsgs[0].direction).toBe('outbound')
+    expect(seededMsgs[0].body).toBe('Hello there')
+
+    // A follow-up reply rolls the thread + preview forward.
+    const reply = await provider.sendMessage({ conversationId: created.id, body: 'How are you?' })
+    expect(reply.direction).toBe('outbound')
+
+    const msgs = await provider.getMessages(created.id)
+    expect(msgs.map((m) => m.body)).toEqual(['Hello there', 'How are you?'])
+
+    // The new conversation surfaces in list() with the latest preview.
+    const list = await provider.listConversations()
+    const found = list.find((c) => c.id === created.id)
+    expect(found).toBeDefined()
+    expect(found!.lastMessagePreview).toBe('How are you?')
+  })
+
+  it('persists across provider instances via localStorage (reload survives)', async () => {
+    installLocalStorage()
+    try {
+      const first = createMockConversationsProvider({ tenantId: 'reload-tenant' })
+      const created = await first.createConversation({
+        channel: 'whatsapp',
+        contactName: 'Grace Hopper',
+        firstMessage: 'Compiling',
+      })
+
+      // Simulate a reload: a brand-new provider for the same tenant.
+      const second = createMockConversationsProvider({ tenantId: 'reload-tenant' })
+      const list = await second.listConversations()
+      const found = list.find((c) => c.id === created.id)
+      expect(found).toBeDefined()
+      expect(found!.contactName).toBe('Grace Hopper')
+
+      const msgs = await second.getMessages(created.id)
+      expect(msgs.map((m) => m.body)).toContain('Compiling')
+    } finally {
+      uninstallLocalStorage()
+    }
+  })
+})
+
+// Guard so the shim never leaks into other suites if this file is imported elsewhere.
+beforeEach(() => uninstallLocalStorage())
+afterEach(() => uninstallLocalStorage())

package/src/data/mock.ts

@@ -1,9 +1,11 @@
 import type { ConversationsProvider } from './types'
+import { CHANNEL_ACCENT_HEX } from './accents'
 import type {
   Conversation,
   Message,
   ListConversationsQuery,
   SendMessageInput,
+  CreateConversationInput,
   ConversationStatus,
 } from '../types'
 
@@ -82,13 +84,90 @@ function msg(
   return { id, conversationId, channel, direction, body, author, at }
 }
 
-export function createMockConversationsProvider(): ConversationsProvider {
-  const { conversations, messages } = seed()
-  let counter = 100
+export interface MockConversationsConfig {
+  /** Tenant id (value or getter) used to namespace the localStorage snapshot. */
+  tenantId?: string | (() => string | undefined)
+  /** Display name stamped as the author of outbound messages. */
+  selfAuthor?: string
+}
+
+interface Snapshot {
+  conversations: Conversation[]
+  messages: Message[]
+  counter: number
+}
+
+// ---------------------------------------------------------------------------
+// In-memory mock inbox with best-effort localStorage persistence, so a browser
+// reload keeps whatever the demo created/sent within the session. The store is
+// namespaced per tenant; SSR / no-window environments degrade to pure memory.
+// ---------------------------------------------------------------------------
+export function createMockConversationsProvider(
+  config?: MockConversationsConfig,
+): ConversationsProvider {
+  const selfAuthor = config?.selfAuthor ?? 'You'
+
+  function resolveTenant(): string {
+    const raw = typeof config?.tenantId === 'function' ? config.tenantId() : config?.tenantId
+    return raw || 'default'
+  }
+
+  const storageKey = () => `saas:mock:conversations:${resolveTenant()}`
+
+  function hasStorage(): boolean {
+    try {
+      return typeof window !== 'undefined' && !!window.localStorage
+    } catch {
+      return false
+    }
+  }
+
+  function load(): Snapshot {
+    if (hasStorage()) {
+      try {
+        const raw = window.localStorage.getItem(storageKey())
+        if (raw) {
+          const parsed = JSON.parse(raw) as Snapshot
+          if (Array.isArray(parsed.conversations) && Array.isArray(parsed.messages)) {
+            return {
+              conversations: parsed.conversations,
+              messages: parsed.messages,
+              counter: parsed.counter ?? 100,
+            }
+          }
+        }
+      } catch {
+        // Corrupt snapshot — fall through to a fresh seed.
+      }
+    }
+    const seeded = seed()
+    return { conversations: seeded.conversations, messages: seeded.messages, counter: 100 }
+  }
+
+  const state = load()
+
+  function persist(): void {
+    if (!hasStorage()) return
+    try {
+      window.localStorage.setItem(
+        storageKey(),
+        JSON.stringify({
+          conversations: state.conversations,
+          messages: state.messages,
+          counter: state.counter,
+        } satisfies Snapshot),
+      )
+    } catch {
+      // Quota / privacy mode — keep working in memory only.
+    }
+  }
+
+  // Persist the initial seed so a first reload is already stable.
+  persist()
 
   return {
     async listConversations(query?: ListConversationsQuery): Promise<Conversation[]> {
-      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) {
@@ -101,41 +180,81 @@ export function createMockConversationsProvider(): ConversationsProvider {
     },
 
     async getMessages(conversationId: string): Promise<Message[]> {
-      return messages
+      return state.messages
         .filter((m) => m.conversationId === conversationId)
         .sort((a, b) => a.at.localeCompare(b.at))
     },
 
+    async createConversation(input: CreateConversationInput): Promise<Conversation> {
+      const now = new Date().toISOString()
+      const firstMessage = input.firstMessage?.trim()
+      const id = `c${++state.counter}`
+      const conversation: 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() || undefined,
+      }
+      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: SendMessageInput): Promise<Message> {
-      const conv = conversations.find((c) => c.id === input.conversationId)
+      const conv = state.conversations.find((c) => c.id === input.conversationId)
       const created: Message = {
-        id: `m${++counter}`,
+        id: `m${++state.counter}`,
         conversationId: input.conversationId,
         channel: conv?.channel ?? 'sms',
         direction: 'outbound',
         body: input.body,
-        author: 'You',
+        author: selfAuthor,
         at: 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: string): Promise<void> {
-      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: string, status: ConversationStatus): Promise<Conversation> {
-      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
     },
   }