wexa-chat 0.1.32 → 0.1.34

package/README.md

@@ -1,24 +1,16 @@
 # wexa-chat (Chat Core)
 
-TypeScript chat core for MongoDB with optional Redis and a built‑in WebSocket transport. Ships server APIs and a lightweight browser client bundle.
+TypeScript chat core for MongoDB with optional Redis and a built‑in WebSocket transport. Ships server APIs and a lightweight browser client bundle used by the demo app.
 
 - Server: `import { initChat } from 'wexa-chat'`
 - Client: `import { SocketProvider, useSocket, getSocketManager, type ChatEvent } from 'wexa-chat/client'`
 
-## Key Features
-
-- Single socket connection per user ID - no need to join individual conversations
-- Direct communication between users via unique identifiers
-- Messages are stored with conversationId for organization and retrieval
-- Support for various ID types (userId, organizationId, candidateId, applicationId)
-- Simplified Redis pub/sub for cross-instance communication
+This README mirrors the integration used in the Next.js demo app.
 
 ## Installation
 
 ```bash
 npm install wexa-chat mongoose ioredis
-# or with pnpm
-pnpm add wexa-chat mongoose ioredis
 ```
 
 ## Server usage
@@ -37,13 +29,15 @@ export async function getChatInstance(httpServer?: HTTPServer) {
     // Attach WS transport when server becomes available
     if (httpServer && !(chatInstance.transport as any).socket) {
       chatInstance = await initChat(mongoose, {
+        participantModels: ['User'],
+        memberRoles: ['member', 'admin'],
         mongoUri: process.env.MONGODB_URI!,
         // Optional Redis for cross‑instance fanout
         redis: process.env.REDIS_URL || process.env.REDIS_HOST
           ? { url: process.env.REDIS_URL, host: process.env.REDIS_HOST, port: Number(process.env.REDIS_PORT || 6379) }
           : undefined,
-        // IMPORTANT: must match the client endpoint
-        socket: { path: '/api/socket' },
+        // IMPORTANT: must match the client (recommended '/ws')
+        socket: { path: '/ws' },
         enableTextSearch: true,
       }, httpServer);
     }
@@ -52,11 +46,13 @@ export async function getChatInstance(httpServer?: HTTPServer) {
 
   // First‑time init; only pass socket when server exists
   chatInstance = await initChat(mongoose, {
+    participantModels: ['User'],
+    memberRoles: ['member', 'admin'],
     mongoUri: process.env.MONGODB_URI!,
     redis: process.env.REDIS_URL || process.env.REDIS_HOST
       ? { url: process.env.REDIS_URL, host: process.env.REDIS_HOST, port: Number(process.env.REDIS_PORT || 6379) }
       : undefined,
-    socket: httpServer ? { path: '/api/socket' } : undefined,
+    socket: httpServer ? { path: '/ws' } : undefined,
     enableTextSearch: true,
   }, httpServer);
 
@@ -67,8 +63,8 @@ export async function getChatInstance(httpServer?: HTTPServer) {
 ### WebSocket transport
 
 - Transport uses native `ws` and attaches an HTTP upgrade listener when `httpServer` is provided.
-- Set `socket.path` to the URL path for upgrades. The client bundle expects `/api/socket`.
-- Authentication: client connects to `ws(s)://host/api/socket?userId=...`. The server validates the handshake and associates the user.
+- Set `socket.path` to the URL path for upgrades. The client bundle expects `/ws`; configure the same on the server.
+- Authentication: client connects to `ws(s)://host/ws?userId=...&userModel=User`. The server validates the handshake and associates the user.
 
 ### Next.js warm‑up route
 
@@ -89,7 +85,7 @@ export default async function handler(_req: NextApiRequest, res: NextApiResponse
 }
 ```
 
-The browser client performs a one-time GET of `/api/socket` before opening the WebSocket.
+The browser client performs a one‑time GET of `/api/socket` before opening the WebSocket.
 
 ## Options overview (see `src/types/init.ts`)
 
@@ -100,6 +96,8 @@ export type SocketConfig = {
 };
 
 export type InitOptions = {
+  participantModels: string[];               // e.g. ['User']
+  memberRoles: string[];                     // e.g. ['member', 'admin']
   mongoUri: string;                          // MongoDB connection
   enableTextSearch?: boolean;
   redis?: {                                  // optional
@@ -107,6 +105,7 @@ export type InitOptions = {
     socketConnectTimeout?: number; keepAlive?: number;
   };
   socket?: SocketConfig;                     // WebSocket config
+  presence?: { enabled?: boolean; heartbeatSec?: number };
   rateLimit?: { sendPerMin?: number; typingPerMin?: number };
 }
 ```
@@ -122,26 +121,125 @@ export type InitOptions = {
   - `searchByParticipantPair({ organizationId, a, b })`
 
 - Messages
-  - `sendMessage({ organizationId, conversationId, senderModel, senderId, text, targetUserId, kind?, parentMessageId?, rootThreadId? })`
+  - `sendMessage({ organizationId, conversationId, senderModel, senderId, text, kind?, parentMessageId?, rootThreadId? })`
   - `listMessages({ organizationId, conversationId, limit?, cursor? })`
   - `listMessagesWithSenders({ organizationId, conversationId, limit?, cursor?, populateSenders: true, populateOptions? })`
+  - `markRead({ organizationId, conversationId, participantModel, participantId, messageId })`
 
 DTO types live in `src/types/dto.ts`.
 
-### Sending Messages with Direct Routing
+### Populating Message Senders with Infinite Scroll Support
+
+The `listMessagesWithSenders` method allows you to retrieve messages with populated sender details, optimized for infinite scroll in chat interfaces. The implementation uses efficient batched lookups:
+
+```ts
+// Basic usage
+const messagesWithSenders = await chat.services.messages.listMessagesWithSenders({
+  organizationId: 'org-123',
+  conversationId: 'conv-456',
+  populateSenders: true // Required to enable population
+});
+
+// With customization
+const messagesWithCustomSenders = await chat.services.messages.listMessagesWithSenders({
+  organizationId: 'org-123',
+  conversationId: 'conv-456',
+  populateSenders: true,
+  populateOptions: {
+    fields: '_id name email profilePicture', // Fields to select from sender model
+    modelMapping: {
+      'User': 'CustomUserModel', // If your senderModel doesn't match the actual Mongoose model name
+      'Bot': 'BotModel'
+    }
+  }
+});
+
+// Accessing populated data
+messagesWithSenders.items.forEach(message => {
+  console.log(`Message from ${message.sender?.name}: ${message.text}`);
+});
+```
+
+The populated sender data is available in the `sender` property of each message. The implementation uses a batched approach that:
 
-The `sendMessage` method now supports direct routing to specific users with the new `targetUserId` parameter:
+1. Fetches messages using MongoDB aggregation
+2. Groups messages by sender model type
+3. Loads all senders for each model type in a single query per model
+4. Attaches sender data to each message efficiently
+
+This approach minimizes database queries and maximizes performance, even with multiple sender types.
+
+#### Infinite Scroll Implementation
+
+The returned data structure supports infinite scroll with cursor-based pagination:
 
 ```ts
-// Send a message to a specific user
-await chat.services.messages.sendMessage({
+// First load
+const firstPage = await chat.services.messages.listMessagesWithSenders({
   organizationId: 'org-123',
   conversationId: 'conv-456',
-  senderModel: 'User',
-  senderId: 'user-789',
-  text: 'Hello there!',
-  targetUserId: 'org-321', // Target recipient ID (userId, organizationId, applicationId, etc.)
+  populateSenders: true,
+  limit: 20 // Number of messages per "page"
 });
+
+// Display messages in your UI
+displayMessages(firstPage.items);
+
+// When user scrolls and needs more messages
+if (firstPage.hasMore) {
+  // Load next batch using the cursor
+  const nextPage = await chat.services.messages.listMessagesWithSenders({
+    organizationId: 'org-123',
+    conversationId: 'conv-456', 
+    populateSenders: true,
+    limit: 20,
+    cursor: firstPage.nextCursor // Pass the cursor from previous batch
+  });
+  
+  // Append these messages to your UI
+  displayMessages([...existingMessages, ...nextPage.items]);
+  
+  // Store the new cursor for further loading
+  nextCursor = nextPage.nextCursor;
+  hasMore = nextPage.hasMore;
+}
+```
+
+The method returns messages sorted by creation time (newest first), making it ideal for chat interfaces where newer messages appear at the bottom. The cursor-based pagination ensures efficient loading of large conversation histories.
+
+The type `MessageWithSender` is exported from the package for proper TypeScript support.
+
+## Models
+
+The package exports the following model types which can be imported directly:
+
+```ts
+import { 
+  // Model interfaces (document structures)
+  type IConversation, 
+  type IMessage,
+  
+  // Mongoose model types
+  type ConversationModel,
+  type MessageModel,
+  
+  // Extended types
+  type MessageWithSender // Message with populated sender data
+} from 'wexa-chat';
+```
+
+To access the actual models:
+
+```ts
+// Initialize the chat system
+const chat = await initChat(mongoose, options);
+
+// Access models
+const { Conversation, Message } = chat.models;
+
+// Example usage
+const conversations = await Conversation.find({ organizationId }).lean();
+const messages = await Message.find({ conversationId }).sort({ createdAt: -1 }).lean();
 ```
 
 ## Browser client
@@ -165,72 +263,44 @@ Use in components:
 import { useEffect } from 'react';
 import { useSocket, type ChatEvent } from 'wexa-chat/client';
 
-export function ChatWindow({ conversationId, otherUserId }: { conversationId: string, otherUserId: string }) {
+export function ChatWindow({ conversationId }: { conversationId: string }) {
   const { isConnected, send, onEvent } = useSocket();
 
   useEffect(() => {
-    if (!isConnected) return;
-    
+    if (!conversationId) return;
+    if (isConnected) send({ type: 'join-conversation', conversationId });
     const off = onEvent((e: ChatEvent) => {
-      if (e.type === 'message:received' && e.conversationId === conversationId) {
-        // update UI with new message
-        console.log('New message:', e.message);
-      }
-      if (e.type === 'typing' && e.conversationId === conversationId) {
-        // update typing indicator
-        console.log('Typing status:', e.state, 'from:', e.senderId);
+      if (e.type === 'message:created' && e.message?.conversationId === conversationId) {
+        // update UI
       }
     });
-    
     return off;
-  }, [conversationId, isConnected, onEvent]);
-
-  // Send a message to the other user
-  const sendMessage = (text: string) => {
-    if (isConnected) {
-      send({ 
-        type: 'send-message', 
-        conversationId, 
-        targetUserId: otherUserId, 
-        text 
-      });
-    }
-  };
-
-  // Send typing indicator
-  const sendTyping = (isTyping: boolean) => {
-    if (isConnected) {
-      send({ 
-        type: 'typing', 
-        conversationId, 
-        targetUserId: otherUserId, 
-        isTyping 
-      });
-    }
-  };
+  }, [conversationId, isConnected, send, onEvent]);
 
   return null;
 }
 ```
 
-## Events
-
-### Client → Server
+You can also send:
 
-- `send-message` — `{ type: 'send-message', conversationId, targetUserId, text }`
-- `typing` — `{ type: 'typing', conversationId, targetUserId, isTyping: boolean }`
+```ts
+send({ type: 'leave-conversation', conversationId });
+send({ type: 'typing', conversationId, isTyping: true });
+```
 
-### Server → Client
+## Events (server → client)
 
-- `message:received` — `{ type: 'message:received', message, conversationId, senderId }`
-- `typing` — `{ type: 'typing', conversationId, senderId, state: 'start' | 'stop', at }`
+- `message:created` — `{ type: 'message:created', message }`
+- `conversation:read` — `{ type: 'conversation:read', conversationId, messageId, participantModel, participantId, at }`
+- `typing` — `{ type: 'typing', conversationId, participantModel, participantId, state: 'start' | 'stop' }`
+- `presence:join` / `presence:leave` — `{ type, organizationId, participantModel, participantId, at }`
 
 If Redis is configured, events are pub/sub‑broadcast across instances.
 
 ## Build
 
 ```bash
-pnpm build
+npm run build
 ```
 
 Exports (from `package.json`):
@@ -248,8 +318,8 @@ Exports (from `package.json`):
 
 - `MONGODB_URI`
 - `REDIS_URL` or `REDIS_HOST`/`REDIS_PORT`/`REDIS_PASSWORD`/`REDIS_DB`
-- Ensure `socket.path` matches the client (recommended `/api/socket`).
+- Ensure `socket.path` matches the client (recommended `/ws`).
 
 ## License
 
-MIT
+MIT

package/dist/client/index.d.ts

@@ -1,15 +1,19 @@
 import { ReactNode } from 'react';
 
 type ChatEvent = {
-    type: 'message:received';
-    message: any;
-    conversationId: string;
+    type: 'message:created';
+    [k: string]: any;
+} | {
+    type: 'conversation:read';
     [k: string]: any;
 } | {
     type: 'typing';
-    conversationId: string;
-    senderId: string;
-    state: string;
+    [k: string]: any;
+} | {
+    type: 'presence:join';
+    [k: string]: any;
+} | {
+    type: 'presence:leave';
     [k: string]: any;
 };
 type Listener<T> = (v: T) => void;

package/dist/client/index.js

@@ -33,7 +33,7 @@ var SocketManager = class {
         return;
       const protocol = window.location.protocol === "https:" ? "wss" : "ws";
       const ws = new WebSocket(
-        `${protocol}://${window.location.host}/api/socket?userId=${encodeURIComponent(userId)}`
+        `${protocol}://${window.location.host}/ws?userId=${encodeURIComponent(userId)}`
       );
       this.ws = ws;
       this.connecting = true;

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/socketManager.ts","../../src/client/SocketProvider.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export type ChatEvent =\n  | { type: 'message:received'; message: any; conversationId: string; [k: string]: any }\n  | { type: 'typing'; conversationId: string; senderId: string; state: string; [k: string]: any };\n\ntype Listener<T> = (v: T) => void;\n\nclass SocketManager {\n  private ws: WebSocket | null = null;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private manualClose = false;\n  private attempt = 0;\n  private warmedUp = false;\n  private connecting = false;\n\n  private connListeners = new Set<Listener<boolean>>();\n  private eventListeners = new Set<Listener<ChatEvent>>();\n\n  private getUserId: () => string | undefined = () => undefined;\n\n  constructor(getUserId?: () => string | undefined) {\n    if (getUserId) this.getUserId = getUserId;\n  }\n\n  setGetUserId = (fn: () => string | undefined) => {\n    this.getUserId = fn;\n  };\n\n  private notifyConn(v: boolean) {\n    this.connListeners.forEach((l) => l(v));\n  }\n  private notifyEvent(e: ChatEvent) {\n    this.eventListeners.forEach((l) => l(e));\n  }\n\n  addConnListener(l: Listener<boolean>) {\n    this.connListeners.add(l);\n    return () => this.connListeners.delete(l);\n  }\n  addEventListener(l: Listener<ChatEvent>) {\n    this.eventListeners.add(l);\n    return () => this.eventListeners.delete(l);\n  }\n\n  connect = async () => {\n    const userId = this.getUserId();\n    if (!userId || typeof window === 'undefined') return;\n\n    // Prevent overlapping connect attempts\n    if (this.connecting) return;\n\n    if (!this.warmedUp) {\n      try {\n        await fetch('/api/socket', { method: 'GET', keepalive: true });\n      } catch {}\n      this.warmedUp = true;\n    }\n\n    if (\n      this.ws &&\n      (this.ws.readyState === WebSocket.OPEN ||\n        this.ws.readyState === WebSocket.CONNECTING ||\n        this.ws.readyState === WebSocket.CLOSING)\n    )\n      return;\n\n    const protocol = window.location.protocol === 'https:' ? 'wss' : 'ws';\n    const ws = new WebSocket(\n      `${protocol}://${window.location.host}/api/socket?userId=${encodeURIComponent(userId)}`,\n    );\n    this.ws = ws;\n    this.connecting = true;\n\n    ws.onopen = () => {\n      if (this.ws !== ws) return;\n      this.attempt = 0;\n      this.manualClose = false;\n      this.notifyConn(true);\n      this.connecting = false;\n    };\n    ws.onmessage = (msg) => {\n      if (this.ws !== ws) return;\n      try {\n        this.notifyEvent(JSON.parse(msg.data as string));\n      } catch {}\n    };\n    ws.onclose = () => {\n      if (this.ws !== ws) return;\n      this.notifyConn(false);\n      this.ws = null;\n      this.connecting = false;\n      if (this.manualClose) return;\n      this.attempt += 1;\n      const delay = Math.min(5000, 500 * Math.pow(2, this.attempt));\n      if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = setTimeout(this.connect, delay);\n    };\n    ws.onerror = () => {\n      try {\n        ws.close();\n      } catch {}\n      if (this.ws === ws) {\n        this.connecting = false;\n      }\n    };\n  };\n\n  send = (payload: unknown) => {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return false;\n    try {\n      this.ws.send(JSON.stringify(payload));\n      return true;\n    } catch {\n      return false;\n    }\n  };\n\n  close = () => {\n    this.manualClose = true;\n    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n    this.reconnectTimer = null;\n    try {\n      this.ws?.close();\n    } catch {}\n    this.ws = null;\n  };\n}\n\nexport default SocketManager;\n\n// Singleton accessor that survives Next.js Fast Refresh by storing on globalThis\ndeclare const globalThis: typeof global & {\n  __socketManagerSingleton?: SocketManager | null;\n};\n\nexport function getSocketManager(getUserId?: () => string | undefined) {\n  if (!globalThis.__socketManagerSingleton) {\n    globalThis.__socketManagerSingleton = new SocketManager(getUserId);\n  } else if (getUserId) {\n    globalThis.__socketManagerSingleton.setGetUserId(getUserId);\n  }\n  return globalThis.__socketManagerSingleton;\n}\n","'use client';\n\nimport { createContext, useContext, useEffect, useMemo, useState, useCallback, type ReactNode } from 'react';\nimport { getSocketManager } from './socketManager';\nimport type { ChatEvent } from './socketManager';\n\nexport type SocketCtxShape = {\n  isConnected: boolean;\n  send: (payload: unknown) => boolean;\n  onEvent: (cb: (e: ChatEvent) => void) => () => void;\n};\n\nconst SocketCtx = createContext<SocketCtxShape | null>(null);\n\nexport function SocketProvider({\n  children,\n  getUserId,\n}: {\n  children: ReactNode;\n  getUserId: () => string | undefined;\n}) {\n  const [isConnected, setIsConnected] = useState(false);\n\n  // Singleton manager for this tab\n  const mgr = useMemo(() => getSocketManager(getUserId), [getUserId]);\n\n  useEffect(() => {\n    // keep user id up to date and ensure connection\n    mgr.setGetUserId(getUserId);\n    if (getUserId()) mgr.connect();\n    // Note: we intentionally DO NOT close the socket on unmount to avoid\n    // duplicate connects under React Strict Mode/Fast Refresh.\n  }, [mgr, getUserId]);\n\n  useEffect(() => {\n    const off = mgr.addConnListener(setIsConnected);\n    return () => {\n      off();\n    };\n  }, [mgr]);\n\n  const sendFn = useCallback<SocketCtxShape['send']>((payload: unknown) => mgr.send(payload), [mgr]);\n  const onEventFn = useCallback<SocketCtxShape['onEvent']>((cb: (e: ChatEvent) => void) => mgr.addEventListener(cb), [mgr]);\n\n  const value = useMemo<SocketCtxShape>(\n    () => ({\n      isConnected,\n      send: sendFn,\n      onEvent: onEventFn,\n    }),\n    [isConnected, sendFn, onEventFn],\n  );\n\n  return <SocketCtx.Provider value={value}>{children}</SocketCtx.Provider>;\n}\n\nexport function useSocket() {\n  const ctx = useContext(SocketCtx);\n  if (!ctx) throw new Error('useSocket must be used within <SocketProvider />');\n  return ctx;\n}\n"]}
+{"version":3,"sources":["../../src/client/socketManager.ts","../../src/client/SocketProvider.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export type ChatEvent =\n  | { type: 'message:created'; [k: string]: any }\n  | { type: 'conversation:read'; [k: string]: any }\n  | { type: 'typing'; [k: string]: any }\n  | { type: 'presence:join'; [k: string]: any }\n  | { type: 'presence:leave'; [k: string]: any };\n\ntype Listener<T> = (v: T) => void;\n\nclass SocketManager {\n  private ws: WebSocket | null = null;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private manualClose = false;\n  private attempt = 0;\n  private warmedUp = false;\n  private connecting = false;\n\n  private connListeners = new Set<Listener<boolean>>();\n  private eventListeners = new Set<Listener<ChatEvent>>();\n\n  private getUserId: () => string | undefined = () => undefined;\n\n  constructor(getUserId?: () => string | undefined) {\n    if (getUserId) this.getUserId = getUserId;\n  }\n\n  setGetUserId = (fn: () => string | undefined) => {\n    this.getUserId = fn;\n  };\n\n  private notifyConn(v: boolean) {\n    this.connListeners.forEach((l) => l(v));\n  }\n  private notifyEvent(e: ChatEvent) {\n    this.eventListeners.forEach((l) => l(e));\n  }\n\n  addConnListener(l: Listener<boolean>) {\n    this.connListeners.add(l);\n    return () => this.connListeners.delete(l);\n  }\n  addEventListener(l: Listener<ChatEvent>) {\n    this.eventListeners.add(l);\n    return () => this.eventListeners.delete(l);\n  }\n\n  connect = async () => {\n    const userId = this.getUserId();\n    if (!userId || typeof window === 'undefined') return;\n\n    // Prevent overlapping connect attempts\n    if (this.connecting) return;\n\n    if (!this.warmedUp) {\n      try {\n        await fetch('/api/socket', { method: 'GET', keepalive: true });\n      } catch {}\n      this.warmedUp = true;\n    }\n\n    if (\n      this.ws &&\n      (this.ws.readyState === WebSocket.OPEN ||\n        this.ws.readyState === WebSocket.CONNECTING ||\n        this.ws.readyState === WebSocket.CLOSING)\n    )\n      return;\n\n    const protocol = window.location.protocol === 'https:' ? 'wss' : 'ws';\n    const ws = new WebSocket(\n      `${protocol}://${window.location.host}/ws?userId=${encodeURIComponent(userId)}`,\n    );\n    this.ws = ws;\n    this.connecting = true;\n\n    ws.onopen = () => {\n      if (this.ws !== ws) return;\n      this.attempt = 0;\n      this.manualClose = false;\n      this.notifyConn(true);\n      this.connecting = false;\n    };\n    ws.onmessage = (msg) => {\n      if (this.ws !== ws) return;\n      try {\n        this.notifyEvent(JSON.parse(msg.data as string));\n      } catch {}\n    };\n    ws.onclose = () => {\n      if (this.ws !== ws) return;\n      this.notifyConn(false);\n      this.ws = null;\n      this.connecting = false;\n      if (this.manualClose) return;\n      this.attempt += 1;\n      const delay = Math.min(5000, 500 * Math.pow(2, this.attempt));\n      if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = setTimeout(this.connect, delay);\n    };\n    ws.onerror = () => {\n      try {\n        ws.close();\n      } catch {}\n      if (this.ws === ws) {\n        this.connecting = false;\n      }\n    };\n  };\n\n  send = (payload: unknown) => {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return false;\n    try {\n      this.ws.send(JSON.stringify(payload));\n      return true;\n    } catch {\n      return false;\n    }\n  };\n\n  close = () => {\n    this.manualClose = true;\n    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n    this.reconnectTimer = null;\n    try {\n      this.ws?.close();\n    } catch {}\n    this.ws = null;\n  };\n}\n\nexport default SocketManager;\n\n// Singleton accessor that survives Next.js Fast Refresh by storing on globalThis\ndeclare const globalThis: typeof global & {\n  __socketManagerSingleton?: SocketManager | null;\n};\n\nexport function getSocketManager(getUserId?: () => string | undefined) {\n  if (!globalThis.__socketManagerSingleton) {\n    globalThis.__socketManagerSingleton = new SocketManager(getUserId);\n  } else if (getUserId) {\n    globalThis.__socketManagerSingleton.setGetUserId(getUserId);\n  }\n  return globalThis.__socketManagerSingleton;\n}\n","'use client';\n\nimport { createContext, useContext, useEffect, useMemo, useState, useCallback, type ReactNode } from 'react';\nimport { getSocketManager } from './socketManager';\nimport type { ChatEvent } from './socketManager';\n\nexport type SocketCtxShape = {\n  isConnected: boolean;\n  send: (payload: unknown) => boolean;\n  onEvent: (cb: (e: ChatEvent) => void) => () => void;\n};\n\nconst SocketCtx = createContext<SocketCtxShape | null>(null);\n\nexport function SocketProvider({\n  children,\n  getUserId,\n}: {\n  children: ReactNode;\n  getUserId: () => string | undefined;\n}) {\n  const [isConnected, setIsConnected] = useState(false);\n\n  // Singleton manager for this tab\n  const mgr = useMemo(() => getSocketManager(getUserId), [getUserId]);\n\n  useEffect(() => {\n    // keep user id up to date and ensure connection\n    mgr.setGetUserId(getUserId);\n    if (getUserId()) mgr.connect();\n    // Note: we intentionally DO NOT close the socket on unmount to avoid\n    // duplicate connects under React Strict Mode/Fast Refresh.\n  }, [mgr, getUserId]);\n\n  useEffect(() => {\n    const off = mgr.addConnListener(setIsConnected);\n    return () => {\n      off();\n    };\n  }, [mgr]);\n\n  const sendFn = useCallback<SocketCtxShape['send']>((payload: unknown) => mgr.send(payload), [mgr]);\n  const onEventFn = useCallback<SocketCtxShape['onEvent']>((cb: (e: ChatEvent) => void) => mgr.addEventListener(cb), [mgr]);\n\n  const value = useMemo<SocketCtxShape>(\n    () => ({\n      isConnected,\n      send: sendFn,\n      onEvent: onEventFn,\n    }),\n    [isConnected, sendFn, onEventFn],\n  );\n\n  return <SocketCtx.Provider value={value}>{children}</SocketCtx.Provider>;\n}\n\nexport function useSocket() {\n  const ctx = useContext(SocketCtx);\n  if (!ctx) throw new Error('useSocket must be used within <SocketProvider />');\n  return ctx;\n}\n"]}

package/dist/index.d.cts

@@ -70,6 +70,14 @@ type SocketConfig$1 = {
     };
 };
 type InitOptions = {
+    /**
+     * Models that can participate in conversations
+     */
+    participantModels: string[];
+    /**
+     * Valid roles for conversation participants
+     */
+    memberRoles: string[];
     /**
      * MongoDB connection URI
      */
@@ -83,9 +91,16 @@ type InitOptions = {
      */
     redis?: RedisConfig;
     /**
-     * Socket configuration
+     * Socket.IO configuration
      */
     socket?: SocketConfig$1;
+    /**
+     * Presence tracking configuration
+     */
+    presence?: {
+        enabled?: boolean;
+        heartbeatSec?: number;
+    };
     /**
      * Rate limiting configuration
      */
@@ -113,7 +128,6 @@ type SendMessageArgs = {
     senderId: string;
     text: string;
     kind?: "text" | "system";
-    targetUserId?: string;
     parentMessageId?: string;
     rootThreadId?: string;
 };
@@ -128,6 +142,13 @@ type ListMessagesArgs = {
         modelMapping?: Record<string, string>;
     };
 };
+type MarkReadArgs = {
+    organizationId: string;
+    conversationId: string;
+    participantModel: string;
+    participantId: string;
+    messageId: string;
+};
 type SearchMessagesArgs = {
     organizationId: string;
     query?: string;
@@ -260,7 +281,10 @@ declare function createConversationsService(models: {
  * Message service hooks interface
  */
 interface MessageServiceHooks {
-    onMessageCreated?: (message: IMessage, targetUserId?: string) => void | Promise<void>;
+    onMessageCreated?: (message: IMessage) => void;
+    onMessageRead?: (args: MarkReadArgs & {
+        at: Date;
+    }) => void;
 }
 /**
  * Message with populated sender information
@@ -277,6 +301,7 @@ interface MessagesService {
     listMessagesWithSenders(args: ListMessagesArgs & {
         populateSenders: true;
     }): Promise<PaginatedResult<MessageWithSender>>;
+    markRead(args: MarkReadArgs): Promise<void>;
 }
 /**
  * Create messages service
@@ -290,58 +315,46 @@ declare function createMessagesService(models: {
 }, hooks?: MessageServiceHooks): MessagesService;
 
 /**
- * In-memory subscription maps for users and sockets
+ * In-memory subscription maps for conversations and sockets
  */
 /**
- * Subscribe a socket to a user's messages
- * @param userId The user ID to subscribe to
+ * Subscribe a socket to a conversation
+ * @param conversationId The conversation ID to subscribe to
  * @param socketId The socket ID to subscribe
  */
-declare function subscribeToUser(userId: string, socketId: string): void;
+declare function subscribeLocal(conversationId: string, socketId: string): void;
 /**
- * Unsubscribe a socket from a user's messages
- * @param userId The user ID to unsubscribe from
+ * Unsubscribe a socket from a conversation
+ * @param conversationId The conversation ID to unsubscribe from
  * @param socketId The socket ID to unsubscribe
  */
-declare function unsubscribeFromUser(userId: string, socketId: string): void;
+declare function unsubscribeLocal(conversationId: string, socketId: string): void;
 /**
  * Clean up all subscriptions for a socket
  * @param socketId The socket ID to clean up
  */
 declare function cleanupLocal(socketId: string): void;
 /**
- * Check if a socket is subscribed to a user
- * @param userId The user ID to check
- * @param socketId The socket ID to check
- */
-declare function isSubscribedToUser(userId: string, socketId: string): boolean;
-/**
- * Get all sockets subscribed to a user
- * @param userId The user ID
- */
-declare function getSocketsForUser(userId: string): Set<string>;
-/**
- * Fan out a message to all local subscribers of a user
- * @param userId The user ID to fan out to
+ * Fan out a message to all local subscribers of a conversation
+ * @param conversationId The conversation ID to fan out to
  * @param payload The payload to send
  * @param emitter Function to emit events to socket IDs
  */
-declare function fanoutToUser(userId: string, payload: any, emitter: (toSocketId: string, event: any) => void): void;
-declare function subscribeLocal(_conversationId: string, _socketId: string): void;
-declare function unsubscribeLocal(_conversationId: string, _socketId: string): void;
-declare function fanoutLocal(_conversationId: string, payload: any, emitter: (toSocketId: string, event: any) => void): void;
+declare function fanoutLocal(conversationId: string, payload: any, emitter: (toSocketId: string, event: any) => void): void;
 
 interface SocketConfig {
     path?: string;
 }
 interface SocketUser {
     id: string;
+    model: string;
 }
 declare class SocketTransport {
     private wss;
     private transport;
     private sockets;
     private users;
+    private joinedConversations;
     private authenticate?;
     private ioShim;
     constructor(server: Server, transport: Transport, config?: SocketConfig);
@@ -357,10 +370,6 @@ declare class SocketTransport {
      * Get Socket.IO server instance
      */
     getIO(): any;
-    /**
-     * Send a message to a specific user
-     */
-    sendToUser(userId: string, payload: any): void;
     /**
      * Close Socket.IO server
      */
@@ -382,11 +391,6 @@ interface Transport {
     unsubscribeLocal: typeof unsubscribeLocal;
     cleanupLocal: typeof cleanupLocal;
     fanoutLocal: typeof fanoutLocal;
-    subscribeToUser: typeof subscribeToUser;
-    unsubscribeFromUser: typeof unsubscribeFromUser;
-    isSubscribedToUser: typeof isSubscribedToUser;
-    getSocketsForUser: typeof getSocketsForUser;
-    fanoutToUser: typeof fanoutToUser;
     publishToConversation: (conversationId: string, payload: any) => Promise<number>;
     startRedisListener: (onEvent: (conversationId: string, payload: any) => void) => (() => void) | null;
 }
@@ -473,6 +477,12 @@ declare function validateSendMessageArgs(args: SendMessageArgs): string | null;
  * @returns Validation error message or null if valid
  */
 declare function validateCreateConversationArgs(args: CreateConversationArgs): string | null;
+/**
+ * Validates mark read arguments
+ * @param args Mark read arguments to validate
+ * @returns Validation error message or null if valid
+ */
+declare function validateMarkReadArgs(args: MarkReadArgs): string | null;
 /**
  * Validates pagination parameters
  * @param limit Pagination limit
@@ -536,4 +546,4 @@ interface ChatServices {
  */
 declare function initChat(mongooseInstance: typeof mongoose, options: InitOptions, server?: Server): Promise<ChatServices>;
 
-export { type Actor, type ChatServices, type ConversationModel, type ConversationReadEvent, type ConversationsService, type CreateConversationArgs, type EnvironmentConfig, type IConversation, type IMessage, type InitOptions, type ListMessagesArgs, type MessageCreatedEvent, type MessageModel, type MessageServiceHooks, type MessageWithSender, type MessagesService, type PaginatedResult, type PresenceEvent, type RedisConfig, type SearchConversationsArgs, type SearchMessagesArgs, type SendMessageArgs, type SocketConfig$1 as SocketConfig, type Transport, type TransportConfig, type TypingEvent, createConversationId, createConversationModel, createConversationsService, createCursor, createMessageId, createMessageModel, createMessagesService, createModels, createPaginatedResponse, createThreadId, createTransport, ensureIndexes, generateId, getRedisConfig, initChat, modelRegistry, parseCursor, searchByParticipantPair, searchConversations, searchMessages, validateCreateConversationArgs, validateInitOptions, validatePagination, validateSendMessageArgs };
+export { type Actor, type ChatServices, type ConversationModel, type ConversationReadEvent, type ConversationsService, type CreateConversationArgs, type EnvironmentConfig, type IConversation, type IMessage, type InitOptions, type ListMessagesArgs, type MarkReadArgs, type MessageCreatedEvent, type MessageModel, type MessageServiceHooks, type MessageWithSender, type MessagesService, type PaginatedResult, type PresenceEvent, type RedisConfig, type SearchConversationsArgs, type SearchMessagesArgs, type SendMessageArgs, type SocketConfig$1 as SocketConfig, type Transport, type TransportConfig, type TypingEvent, createConversationId, createConversationModel, createConversationsService, createCursor, createMessageId, createMessageModel, createMessagesService, createModels, createPaginatedResponse, createThreadId, createTransport, ensureIndexes, generateId, getRedisConfig, initChat, modelRegistry, parseCursor, searchByParticipantPair, searchConversations, searchMessages, validateCreateConversationArgs, validateInitOptions, validateMarkReadArgs, validatePagination, validateSendMessageArgs };