Eve library

Chat Sync Patterns (Mobile)

Guide

Revision 1

On this page

Three building blocks exist and serve different purposes:

  • ChatSyncService (src/services/chat/ChatSyncService.ts) — client state machine for a single device. Manages connection, pending operations, typing/presence, and delivers events via ChatSyncEventBus. Use this inside UI/hooks (useChatSync) for local session sync.
  • CrossDeviceChatSyncHub (src/services/chat/CrossDeviceChatSyncHub.ts) — in-memory hub to relay payloads across multiple event buses (e.g., mobile/web). Maintains pending queues per device and deduplicates origin events. Use in tests or local multi-endpoint simulation.
  • ChatSyncHubBridge (src/services/chat/ChatSyncHubBridge.ts) — adapter that connects a ChatSyncEventBus to a hub, publishing outbound payloads and applying inbound ones. Instantiate per device, passing its bus and the shared hub.