@orbitconnect/react 0.1.4 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog — @orbitconnect/react
+
+## 0.1.6 (2026-05-21)
+
+### Added — Conversation Context System
+
+- **Context Types** — New `ConversationContext`, `ContextActor`, and related type exports (`ConversationContextType`, `ConversationContextStatus`, `ContextActorType`)
+- **`ConversationContextCard` component** — Renders a contextual info card at the top of conversations showing business context (type, title, actor, status, subtitle)
+- **`conversation:context_updated` event** — Real-time context updates via WebSocket, automatically reflected in the conversation list
+- **`useConversations()` enhancements:**
+  - `Conversation` interface now includes `context` field
+  - `createDirect(participantId, context?)` — accepts optional context for contextual conversations
+  - `createGroup(participantIds, context?)` — new method for creating group conversations with context
+  - Listens to `conversation:context_updated` events and updates state in real time
+
+### New Exports
+
+- Types: `ConversationContext`, `ContextActor`, `ConversationContextType`, `ConversationContextStatus`, `ContextActorType`
+- Component: `ConversationContextCard`
+
+---
+
+## 0.1.5 (2025-05-21)
+
+### Added — Offline Messaging & Queueing System
+
+- **Offline Queue Engine** — Messages are now persisted locally (IndexedDB) before sending, guaranteeing crash safety, refresh survival, and reconnect recovery.
+- **Optimistic Messaging** — Messages appear instantly in the chat UI with visual status indicators (queued → sending → sent → delivered → read).
+- **Automatic Retries** — Failed messages retry with exponential backoff (2s → 5s → 15s → 30s → 60s), up to 5 attempts before marking as failed.
+- **Multi-Tab Coordination** — BroadcastChannel-based leader election prevents duplicate queue flushes and syncs message state across browser tabs.
+- **Network Awareness** — Monitors `navigator.onLine` and flushes the queue automatically when connectivity returns.
+- **Socket Reconnect Flush** — Queue automatically flushes when the WebSocket transitions from `reconnecting` → `connected`.
+- **Idempotency Deduplication** — Each message gets a unique `idempotencyKey` (sent as both body field and `Idempotency-Key` header) preventing duplicate sends on retry.
+- **ACK Reconciliation** — Incoming `message:new` WebSocket events are matched against pending optimistic messages by idempotency key, replacing the placeholder with the confirmed message.
+
+### New Exports
+
+- `useOfflineQueue()` hook — access queue operations (`enqueue`, `retryMessage`, `retryAll`, `pauseQueue`, `resumeQueue`, `getPendingMessages`, `clearFailedMessages`, `getQueueStatus`)
+- `OfflineQueueProvider` component — automatically mounted inside `OrbitProvider`
+- Types: `OrbitOfflineMessage`, `OfflineMessageStatus`, `QueueSendOptions`, `QueueEventType`
+
+### Enhanced
+
+- `useMessages()` hook now:
+  - Routes `sendMessage()` through the offline queue (persist → optimistic UI → send)
+  - Restores pending messages from IndexedDB on mount
+  - Deduplicates `message:new` events against optimistic messages
+  - Returns `isOnline`, `retryFailedMessage(localId)`, `retryAllFailed()`
+- `MessageBubble` component now renders offline status indicators:
+  - **queued** — clock icon (grey), reduced opacity
+  - **sending** — spinning circle (blue), reduced opacity
+  - **failed** — exclamation icon (red), dashed red border, "Not sent · Tap to retry" banner
+
+---
+
+## 0.1.4
+
+Initial public release with real-time chat, voice/video calls, meetings, E2E encryption, and theming.

package/dist/components/chat/ConversationContextCard.d.ts

@@ -0,0 +1,11 @@
+import type { ConversationContext } from '../../types/context';
+interface ConversationContextCardProps {
+    context: ConversationContext;
+    className?: string;
+}
+/**
+ * Renders a contextual info card at the top of a conversation.
+ * Shows business context like booking details, service info, purchase status, etc.
+ */
+export declare function ConversationContextCard({ context, className }: ConversationContextCardProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/components/chat/ConversationList.d.ts

@@ -17,6 +17,21 @@ export interface Conversation {
     presenceStatus?: 'online' | 'away' | 'offline';
     /** For direct conversations — the other participant's app_user_id, used to initiate calls */
     otherUserId?: string;
+    /** Business context attached to the conversation (booking, service, purchase, support) */
+    context?: {
+        type: string;
+        referenceId?: string;
+        title?: string;
+        subtitle?: string;
+        status?: string;
+        actor?: {
+            id: string;
+            type: string;
+            name: string;
+            avatar?: string;
+        };
+        metadata?: Record<string, unknown>;
+    } | null;
 }
 interface ConversationListProps {
     conversations: Conversation[];

package/dist/components/chat/index.d.ts

@@ -42,3 +42,4 @@ export { ImageViewer } from './ImageViewer';
 export { VideoViewer } from './VideoViewer';
 export { DocumentViewer } from './DocumentViewer';
 export type { ImageViewerProps, VideoViewerProps, DocumentViewerProps } from './mediaViewerRegistry';
+export { ConversationContextCard } from './ConversationContextCard';

package/dist/hooks/useConversations.d.ts

@@ -2,6 +2,7 @@ import type { Conversation } from '../components/chat/ConversationList';
 export declare function useConversations(): {
     conversations: Conversation[];
     loading: boolean;
-    createDirect: (participantId: string) => Promise<string>;
+    createDirect: (participantId: string, context?: Record<string, unknown>) => Promise<string>;
+    createGroup: (participantIds: string[], context?: Record<string, unknown>) => Promise<string>;
     refresh: () => void;
 };

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { Chat, VideoCall, MeetingWidget } from './widgets';
 export type { ChatProps, MeetingWidgetProps, ChatHeaderInfo } from './widgets';
 export { useMessages, useConversations, useCall, useMeeting, useCallHistory, usePresence, useRealtime, useMedia, useNotifications } from './hooks';
 export type { ActiveCall, CallState, ActiveMeeting, MeetingState, PresenceStatus, RealtimeSession, CreateSessionInput, TransitionType, MediaObject, OrbitNotification } from './hooks';
+export type { ConversationContext, ContextActor, ConversationContextType, ConversationContextStatus, ContextActorType } from './types';
 export { useOfflineQueue, OfflineQueueProvider } from './offline';
 export type { OrbitOfflineMessage, OfflineMessageStatus, QueueSendOptions, QueueEventType } from './offline';
 export { MeetingProvider, MeetingContext, useMeetingContext } from './meeting';