@fayz-ai/plugin-conversations 0.9.0-next.1 → 0.9.1

package/dist/{channel.d.ts → lib/channel.d.ts}

@@ -1,5 +1,5 @@
 import React from 'react';
-import { CHANNEL_LABELS, type Channel } from './types';
+import { CHANNEL_LABELS, type Channel } from '../types';
 export declare const CHANNEL_ICON: Record<Channel, React.ComponentType<{
     className?: string;
 }>>;

package/dist/lib/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/lib/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAA;AAQvD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAMrF,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa,CAMzD,CAAA;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/{ConversationsPage.d.ts → views/ConversationsPage.d.ts}

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { StoreApi } from 'zustand/vanilla';
-import { type ResolvedConversationsConfig } from './ConversationsContext';
-import type { ConversationsUIState } from './store';
+import { type ResolvedConversationsConfig } from '../context';
+import type { ConversationsUIState } from '../store';
 export declare function ConversationsPage({ store, config }: {
     store: StoreApi<ConversationsUIState>;
     config?: ResolvedConversationsConfig;

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationsPage.d.ts","sourceRoot":"","sources":["../../src/views/ConversationsPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAgC,KAAK,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAGpD,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IACnD,KAAK,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IACrC,MAAM,CAAC,EAAE,2BAA2B,CAAA;CACrC,qBAWA"}

package/package.json

@@ -3,7 +3,7 @@
   "fayz": {
     "status": "preview"
   },
-  "version": "0.9.0-next.1",
+  "version": "0.9.1",
   "description": "[experimental] Fayz SDK — unified conversations / omni-channel inbox plugin",
   "type": "module",
   "sideEffects": false,
@@ -12,14 +12,12 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -28,9 +26,9 @@
     "lucide-react": ">=0.400.0 <1.0.0"
   },
   "dependencies": {
-    "@fayz-ai/core": "^0.9.0-next.1",
-    "@fayz-ai/ui": "^0.9.0-next.1",
-    "@fayz-ai/saas": "^0.9.0-next.1"
+    "@fayz-ai/core": "^0.10.0",
+    "@fayz-ai/ui": "^0.10.0",
+    "@fayz-ai/admin": "^0.10.0"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",

package/dist/ConversationsContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConversationsContext.d.ts","sourceRoot":"","sources":["../src/ConversationsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAEnD;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAA;IACnB,gFAAgF;IAChF,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,8EAA8E;IAC9E,aAAa,CAAC,EAAE,YAAY,CAAA;CAC7B;AAED,eAAO,MAAM,4BAA4B,EAAE,2BAE1C,CAAA;AAKD,wBAAgB,4BAA4B,CAAC,EAC3C,KAAK,EACL,MAAqC,EACrC,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IACrC,MAAM,CAAC,EAAE,2BAA2B,CAAA;IACpC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B,qBAMA;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,CAAC,GAAG,CAAC,CAIxF;AAED,wBAAgB,sBAAsB,IAAI,2BAA2B,CAEpE"}

package/dist/ConversationsPage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConversationsPage.d.ts","sourceRoot":"","sources":["../src/ConversationsPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAgC,KAAK,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AACvG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAGnD,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IACnD,KAAK,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IACrC,MAAM,CAAC,EAAE,2BAA2B,CAAA;CACrC,qBAWA"}

package/dist/channel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAA;AAQtD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAMrF,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa,CAMzD,CAAA;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/src/ConversationsContext.tsx

@@ -1,51 +0,0 @@
-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}>
-      <ConfigContext.Provider value={config}>{children}</ConfigContext.Provider>
-    </StoreContext.Provider>
-  )
-}
-
-export function useConversationsStore<T>(selector: (state: ConversationsUIState) => T): T {
-  const store = React.useContext(StoreContext)
-  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,21 +0,0 @@
-import React from 'react'
-import type { StoreApi } from 'zustand/vanilla'
-import { ConversationsContextProvider, type ResolvedConversationsConfig } from './ConversationsContext'
-import type { ConversationsUIState } from './store'
-import { InboxView } from './views/InboxView'
-
-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} config={config}>
-      <InboxView />
-    </ConversationsContextProvider>
-  )
-}

package/src/channel.ts

@@ -1,34 +0,0 @@
-import React from 'react'
-import { MessageSquare, Phone, Instagram, Mail, Globe } from 'lucide-react'
-import { CHANNEL_LABELS, type Channel } from './types'
-
-// ---------------------------------------------------------------------------
-// Shared channel visuals — one source of truth for the icon + accent color of
-// each channel, reused by the conversation list, thread header and contact
-// panel. Keeps the omni-channel inbox visually consistent.
-// ---------------------------------------------------------------------------
-
-export const CHANNEL_ICON: Record<Channel, React.ComponentType<{ className?: string }>> = {
-  sms: Phone,
-  whatsapp: MessageSquare,
-  instagram: Instagram,
-  email: Mail,
-  webchat: Globe,
-}
-
-export interface ChannelAccent {
-  /** Solid brand color (hex) — bubbles, dots, header chips. */
-  color: string
-  /** Soft tinted background classes for badges. */
-  badge: string
-}
-
-export const CHANNEL_ACCENT: Record<Channel, ChannelAccent> = {
-  whatsapp: { color: '#22c55e', badge: 'bg-[#22c55e]/12 text-[#15803d] dark:text-[#4ade80]' },
-  sms: { color: '#6366f1', badge: 'bg-[#6366f1]/12 text-[#4338ca] dark:text-[#a5b4fc]' },
-  instagram: { color: '#ec4899', badge: 'bg-[#ec4899]/12 text-[#be185d] dark:text-[#f9a8d4]' },
-  email: { color: '#0ea5e9', badge: 'bg-[#0ea5e9]/12 text-[#0369a1] dark:text-[#7dd3fc]' },
-  webchat: { color: '#f59e0b', badge: 'bg-[#f59e0b]/12 text-[#b45309] dark:text-[#fcd34d]' },
-}
-
-export { CHANNEL_LABELS }

package/src/data/accents.ts

@@ -1,12 +0,0 @@
-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

@@ -1,90 +0,0 @@
-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,261 +0,0 @@
-import type { ConversationsProvider } from './types'
-import { CHANNEL_ACCENT_HEX } from './accents'
-import type {
-  Conversation,
-  Message,
-  ListConversationsQuery,
-  SendMessageInput,
-  CreateConversationInput,
-  ConversationStatus,
-} from '../types'
-
-// Deterministic relative timestamps (no Date.now at module init for stable seeds).
-function minutesAgo(base: number, mins: number): string {
-  return new Date(base - mins * 60_000).toISOString()
-}
-
-function seed(): { conversations: Conversation[]; messages: Message[] } {
-  const base = new Date('2026-06-16T14:00:00Z').getTime()
-
-  const conversations: Conversation[] = [
-    {
-      id: 'c1', contactName: 'Marina Alves', contactHandle: '+55 11 99876-1020', channel: 'whatsapp',
-      lastMessagePreview: 'Perfect, can we book for Friday at 3pm?', lastMessageAt: minutesAgo(base, 4),
-      unreadCount: 2, status: 'open', assignedTo: 'You', accent: '#22c55e', tags: ['Hot lead'],
-      location: 'São Paulo, BR', note: 'Referred by Instagram ad — interested in full color + cut.',
-    },
-    {
-      id: 'c2', contactName: 'Jordan Pierce', contactHandle: '+1 (415) 555-0142', channel: 'sms',
-      lastMessagePreview: 'Got it — sending the deposit now.', lastMessageAt: minutesAgo(base, 22),
-      unreadCount: 0, status: 'open', assignedTo: 'You', accent: '#6366f1', tags: ['Customer'],
-      location: 'San Francisco, US',
-    },
-    {
-      id: 'c3', contactName: '@thehairloft', contactHandle: 'thehairloft', channel: 'instagram',
-      lastMessagePreview: 'Do you offer balayage on weekends?', lastMessageAt: minutesAgo(base, 51),
-      unreadCount: 1, status: 'open', accent: '#ec4899', tags: ['New'],
-    },
-    {
-      id: 'c4', contactName: 'David Whitman', contactHandle: 'david@whitman.co', channel: 'email',
-      lastMessagePreview: 'Re: Proposal — looks great, one question on pricing…', lastMessageAt: minutesAgo(base, 95),
-      unreadCount: 0, status: 'open', assignedTo: 'Sofia', accent: '#0ea5e9', tags: ['Proposal'],
-      location: 'Austin, US', note: 'Evaluating the retainer tier. Decision expected this week.',
-    },
-    {
-      id: 'c5', contactName: 'Website visitor', contactHandle: 'live chat · acme.com', channel: 'webchat',
-      lastMessagePreview: 'Is anyone available to chat?', lastMessageAt: minutesAgo(base, 140),
-      unreadCount: 0, status: 'snoozed', accent: '#f59e0b', tags: [],
-    },
-    {
-      id: 'c6', contactName: 'Priya Nair', contactHandle: '+44 7700 900123', channel: 'whatsapp',
-      lastMessagePreview: 'Thank you! See you next week 🙌', lastMessageAt: minutesAgo(base, 1440),
-      unreadCount: 0, status: 'closed', assignedTo: 'You', accent: '#14b8a6', tags: ['Customer'],
-      location: 'London, UK',
-    },
-  ]
-
-  const messages: Message[] = [
-    msg('m1', 'c1', 'whatsapp', 'inbound', 'Hi! I saw your ad — do you have availability this week?', 'Marina Alves', minutesAgo(base, 18)),
-    msg('m2', 'c1', 'whatsapp', 'outbound', 'Hi Marina! Yes, we do. What service are you interested in?', 'You', minutesAgo(base, 15)),
-    msg('m3', 'c1', 'whatsapp', 'inbound', 'A full color + cut.', 'Marina Alves', minutesAgo(base, 9)),
-    msg('m4', 'c1', 'whatsapp', 'inbound', 'Perfect, can we book for Friday at 3pm?', 'Marina Alves', minutesAgo(base, 4)),
-
-    msg('m5', 'c2', 'sms', 'outbound', 'Your appointment is confirmed for tomorrow at 10am.', 'You', minutesAgo(base, 40)),
-    msg('m6', 'c2', 'sms', 'inbound', 'Got it — sending the deposit now.', 'Jordan Pierce', minutesAgo(base, 22)),
-
-    msg('m7', 'c3', 'instagram', 'inbound', 'Do you offer balayage on weekends?', '@thehairloft', minutesAgo(base, 51)),
-
-    msg('m8', 'c4', 'email', 'inbound', 'Re: Proposal — looks great, one question on pricing for the retainer tier.', 'David Whitman', minutesAgo(base, 95)),
-    msg('m9', 'c4', 'email', 'outbound', 'Happy to walk you through it — are you free for a quick call tomorrow?', 'Sofia', minutesAgo(base, 80)),
-
-    msg('m10', 'c5', 'webchat', 'inbound', 'Is anyone available to chat?', 'Website visitor', minutesAgo(base, 140)),
-
-    msg('m11', 'c6', 'whatsapp', 'outbound', 'You are all set for next Tuesday. Anything else?', 'You', minutesAgo(base, 1500)),
-    msg('m12', 'c6', 'whatsapp', 'inbound', 'Thank you! See you next week 🙌', 'Priya Nair', minutesAgo(base, 1440)),
-  ]
-
-  return { conversations, messages }
-}
-
-function msg(
-  id: string, conversationId: string, channel: Message['channel'],
-  direction: Message['direction'], body: string, author: string, at: string,
-): Message {
-  return { id, conversationId, channel, direction, body, author, at }
-}
-
-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 = [...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) {
-        const q = query.search.toLowerCase()
-        list = list.filter(
-          (c) => c.contactName.toLowerCase().includes(q) || c.lastMessagePreview.toLowerCase().includes(q),
-        )
-      }
-      return list.sort((a, b) => b.lastMessageAt.localeCompare(a.lastMessageAt))
-    },
-
-    async getMessages(conversationId: string): Promise<Message[]> {
-      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 = state.conversations.find((c) => c.id === input.conversationId)
-      const created: Message = {
-        id: `m${++state.counter}`,
-        conversationId: input.conversationId,
-        channel: conv?.channel ?? 'sms',
-        direction: 'outbound',
-        body: input.body,
-        author: selfAuthor,
-        at: new Date().toISOString(),
-      }
-      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 = 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 = state.conversations.find((c) => c.id === conversationId)
-      if (!conv) throw new Error('Conversation not found')
-      conv.status = status
-      persist()
-      return conv
-    },
-  }
-}