@osise/api-client 0.0.9 → 0.0.11

package/dist/cjs/realtime/client.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * Real-time client for Osise SignalR hubs
+ * Provides typed connections to ChatHub and NotificationHub
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OsiseRealTimeClient = void 0;
+const signalr_1 = require("@microsoft/signalr");
+/**
+ * Manages SignalR connections to the Osise real-time hubs.
+ *
+ * Messages flow through REST API (not through SignalR). The hubs push
+ * server-side events to connected clients in real-time.
+ *
+ * @example
+ * ```typescript
+ * const realtime = new OsiseRealTimeClient({
+ *   baseUrl: 'https://api.osise.com',
+ *   accessTokenFactory: () => client.getAccessToken(),
+ * });
+ *
+ * realtime.chat.onMessage = (msg) => console.log('New message:', msg);
+ * realtime.notifications.onNotification = (n) => console.log('Notification:', n);
+ *
+ * await realtime.connect();
+ * ```
+ */
+class OsiseRealTimeClient {
+    constructor(config) {
+        this.chatConnection = null;
+        this.notificationConnection = null;
+        /** Chat hub event handlers */
+        this.chat = {};
+        /** Notification hub event handlers */
+        this.notifications = {};
+        /** Connection lifecycle event handlers */
+        this.connection = {};
+        /** Current chat hub connection state */
+        this.chatState = 'disconnected';
+        /** Current notification hub connection state */
+        this.notificationState = 'disconnected';
+        this.config = {
+            autoReconnect: true,
+            reconnectDelays: [0, 2000, 5000, 10000, 30000],
+            debug: false,
+            ...config,
+        };
+    }
+    // ==================== Connection Management ====================
+    /**
+     * Connect to both chat and notification hubs.
+     * Call this after the user is authenticated.
+     */
+    async connect() {
+        await Promise.all([
+            this.connectChat(),
+            this.connectNotifications(),
+        ]);
+    }
+    /**
+     * Disconnect from both hubs.
+     * Call this on logout or when real-time features are no longer needed.
+     */
+    async disconnect() {
+        await Promise.all([
+            this.disconnectChat(),
+            this.disconnectNotifications(),
+        ]);
+    }
+    /**
+     * Connect to the chat hub only.
+     */
+    async connectChat() {
+        if (this.chatConnection?.state === signalr_1.HubConnectionState.Connected)
+            return;
+        this.chatConnection = this.buildConnection('/hubs/chat');
+        this.registerChatHandlers(this.chatConnection);
+        this.registerConnectionHandlers(this.chatConnection, 'chat');
+        this.chatState = 'connecting';
+        await this.chatConnection.start();
+        this.chatState = 'connected';
+    }
+    /**
+     * Connect to the notification hub only.
+     */
+    async connectNotifications() {
+        if (this.notificationConnection?.state === signalr_1.HubConnectionState.Connected)
+            return;
+        this.notificationConnection = this.buildConnection('/hubs/notifications');
+        this.registerNotificationHandlers(this.notificationConnection);
+        this.registerConnectionHandlers(this.notificationConnection, 'notifications');
+        this.notificationState = 'connecting';
+        await this.notificationConnection.start();
+        this.notificationState = 'connected';
+    }
+    /**
+     * Disconnect from the chat hub.
+     */
+    async disconnectChat() {
+        if (this.chatConnection) {
+            await this.chatConnection.stop();
+            this.chatConnection = null;
+            this.chatState = 'disconnected';
+        }
+    }
+    /**
+     * Disconnect from the notification hub.
+     */
+    async disconnectNotifications() {
+        if (this.notificationConnection) {
+            await this.notificationConnection.stop();
+            this.notificationConnection = null;
+            this.notificationState = 'disconnected';
+        }
+    }
+    // ==================== Chat Hub Client → Server Methods ====================
+    /**
+     * Send a typing indicator to another user.
+     *
+     * @param conversationId - The conversation where typing is happening
+     * @param recipientUserId - The other participant's user ID
+     * @param isTyping - Whether the user is currently typing
+     */
+    async sendTypingIndicator(conversationId, recipientUserId, isTyping) {
+        this.ensureChatConnected();
+        await this.chatConnection.invoke('SendTypingIndicator', conversationId, recipientUserId, isTyping);
+    }
+    /**
+     * Join a conversation group to receive targeted events.
+     * Call this when the user opens a conversation.
+     *
+     * @param conversationId - The conversation to join
+     */
+    async joinConversation(conversationId) {
+        this.ensureChatConnected();
+        await this.chatConnection.invoke('JoinConversation', conversationId);
+    }
+    /**
+     * Leave a conversation group.
+     * Call this when the user navigates away from a conversation.
+     *
+     * @param conversationId - The conversation to leave
+     */
+    async leaveConversation(conversationId) {
+        this.ensureChatConnected();
+        await this.chatConnection.invoke('LeaveConversation', conversationId);
+    }
+    // ==================== Notification Hub Client → Server Methods ====================
+    /**
+     * Acknowledge receipt of a notification.
+     *
+     * @param notificationId - The notification to acknowledge
+     */
+    async acknowledgeNotification(notificationId) {
+        this.ensureNotificationConnected();
+        await this.notificationConnection.invoke('AcknowledgeNotification', notificationId);
+    }
+    // ==================== Private Helpers ====================
+    buildConnection(hubPath) {
+        const url = `${this.config.baseUrl}${hubPath}`;
+        const logLevel = this.config.debug ? signalr_1.LogLevel.Debug : signalr_1.LogLevel.Warning;
+        let builder = new signalr_1.HubConnectionBuilder()
+            .withUrl(url, {
+            accessTokenFactory: () => this.config.accessTokenFactory() ?? '',
+        })
+            .configureLogging(logLevel);
+        if (this.config.autoReconnect) {
+            builder = builder.withAutomaticReconnect(this.config.reconnectDelays);
+        }
+        return builder.build();
+    }
+    registerChatHandlers(connection) {
+        connection.on('ReceiveMessage', (message) => {
+            this.chat.onMessage?.(message);
+        });
+        connection.on('TypingIndicator', (event) => {
+            this.chat.onTypingIndicator?.(event);
+        });
+        connection.on('MessageDelivered', (event) => {
+            this.chat.onMessageDelivered?.(event);
+        });
+        connection.on('MessagesRead', (event) => {
+            this.chat.onMessagesRead?.(event);
+        });
+        connection.on('MessageEdited', (event) => {
+            this.chat.onMessageEdited?.(event);
+        });
+        connection.on('MessageDeleted', (event) => {
+            this.chat.onMessageDeleted?.(event);
+        });
+        connection.on('UserPresenceChanged', (event) => {
+            this.chat.onUserPresenceChanged?.(event);
+        });
+    }
+    registerNotificationHandlers(connection) {
+        connection.on('ReceiveNotification', (notification) => {
+            this.notifications.onNotification?.(notification);
+        });
+        connection.on('NotificationCountUpdated', (event) => {
+            this.notifications.onNotificationCountUpdated?.(event);
+        });
+    }
+    registerConnectionHandlers(connection, hub) {
+        connection.onclose((error) => {
+            if (hub === 'chat')
+                this.chatState = 'disconnected';
+            else
+                this.notificationState = 'disconnected';
+            this.connection.onDisconnected?.(error);
+        });
+        connection.onreconnecting((error) => {
+            if (hub === 'chat')
+                this.chatState = 'reconnecting';
+            else
+                this.notificationState = 'reconnecting';
+            this.connection.onReconnecting?.(error);
+        });
+        connection.onreconnected((connectionId) => {
+            if (hub === 'chat')
+                this.chatState = 'connected';
+            else
+                this.notificationState = 'connected';
+            this.connection.onReconnected?.(connectionId);
+        });
+    }
+    ensureChatConnected() {
+        if (this.chatConnection?.state !== signalr_1.HubConnectionState.Connected) {
+            throw new Error('Chat hub is not connected. Call connectChat() first.');
+        }
+    }
+    ensureNotificationConnected() {
+        if (this.notificationConnection?.state !== signalr_1.HubConnectionState.Connected) {
+            throw new Error('Notification hub is not connected. Call connectNotifications() first.');
+        }
+    }
+}
+exports.OsiseRealTimeClient = OsiseRealTimeClient;
+//# sourceMappingURL=client.js.map

package/dist/cjs/realtime/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/realtime/client.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types/index.js

@@ -50,4 +50,6 @@ __exportStar(require("./communication"), exports);
 __exportStar(require("./location"), exports);
 // Paystack integration types
 __exportStar(require("./paystack"), exports);
+// Real-time types (SignalR)
+__exportStar(require("./realtime"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,QAAQ;AACR,0CAAwB;AAExB,eAAe;AACf,2CAAyB;AAEzB,aAAa;AACb,yCAAuB;AAEvB,iBAAiB;AACjB,6CAA2B;AAE3B,gBAAgB;AAChB,4CAA0B;AAE1B,cAAc;AACd,0CAAwB;AAkFxB,gBAAgB;AAChB,4CAA0B;AAE1B,0BAA0B;AAC1B,kDAAgC;AAEhC,qBAAqB;AACrB,iDAA+B;AAE/B,sBAAsB;AACtB,kDAAgC;AAEhC,iCAAiC;AACjC,wCAAsB;AAEtB,wBAAwB;AACxB,uCAAqB;AAErB,gBAAgB;AAChB,4CAA0B;AAE1B,iEAAiE;AACjE,kDAAgC;AAEhC,iBAAiB;AACjB,6CAA2B;AAE3B,6BAA6B;AAC7B,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,QAAQ;AACR,0CAAwB;AAExB,eAAe;AACf,2CAAyB;AAEzB,aAAa;AACb,yCAAuB;AAEvB,iBAAiB;AACjB,6CAA2B;AAE3B,gBAAgB;AAChB,4CAA0B;AAE1B,cAAc;AACd,0CAAwB;AAkFxB,gBAAgB;AAChB,4CAA0B;AAE1B,0BAA0B;AAC1B,kDAAgC;AAEhC,qBAAqB;AACrB,iDAA+B;AAE/B,sBAAsB;AACtB,kDAAgC;AAEhC,iCAAiC;AACjC,wCAAsB;AAEtB,wBAAwB;AACxB,uCAAqB;AAErB,gBAAgB;AAChB,4CAA0B;AAE1B,iEAAiE;AACjE,kDAAgC;AAEhC,iBAAiB;AACjB,6CAA2B;AAE3B,6BAA6B;AAC7B,6CAA2B;AAE3B,4BAA4B;AAC5B,6CAA2B"}

package/dist/cjs/types/realtime.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Real-time types for SignalR communication
+ * Defines event payloads for chat and notification hubs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=realtime.js.map

package/dist/cjs/types/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../../src/types/realtime.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/esm/hooks/index.js

@@ -2034,4 +2034,282 @@ export function useRateArtisanTicket() {
     const client = useOsiseClient();
     return useMutation(({ ticketId, data }) => client.artisanSupport.rateTicket(ticketId, data));
 }
+/**
+ * Hook to access the real-time client from the Osise provider.
+ *
+ * @example
+ * ```tsx
+ * const realtime = useRealTime();
+ * await realtime.connect();
+ * ```
+ */
+export function useRealTime() {
+    const client = useOsiseClient();
+    return client.realtime;
+}
+/**
+ * Hook that manages the SignalR connection lifecycle.
+ * Connects when the user is authenticated and disconnects on logout or unmount.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { chatState, notificationState } = useRealTimeConnection();
+ *   return <div>Chat: {chatState}, Notifications: {notificationState}</div>;
+ * }
+ * ```
+ */
+export function useRealTimeConnection() {
+    const client = useOsiseClient();
+    const isAuthenticated = useIsAuthenticated();
+    const realtime = client.realtime;
+    const [chatState, setChatState] = useState('disconnected');
+    const [notificationState, setNotificationState] = useState('disconnected');
+    useEffect(() => {
+        if (!isAuthenticated)
+            return;
+        realtime.connection.onDisconnected = () => {
+            setChatState(realtime.chatState);
+            setNotificationState(realtime.notificationState);
+        };
+        realtime.connection.onReconnecting = () => {
+            setChatState(realtime.chatState);
+            setNotificationState(realtime.notificationState);
+        };
+        realtime.connection.onReconnected = () => {
+            setChatState(realtime.chatState);
+            setNotificationState(realtime.notificationState);
+        };
+        realtime.connect().then(() => {
+            setChatState(realtime.chatState);
+            setNotificationState(realtime.notificationState);
+        }).catch(() => {
+            setChatState('disconnected');
+            setNotificationState('disconnected');
+        });
+        return () => {
+            realtime.disconnect();
+            setChatState('disconnected');
+            setNotificationState('disconnected');
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [isAuthenticated]);
+    return { chatState, notificationState, realtime };
+}
+/**
+ * Hook that subscribes to incoming chat messages.
+ *
+ * @example
+ * ```tsx
+ * const messages = useChatMessages();
+ * // messages is an array of received messages since mount
+ * ```
+ */
+export function useChatMessages() {
+    const realtime = useRealTime();
+    const [messages, setMessages] = useState([]);
+    useEffect(() => {
+        const prev = realtime.chat.onMessage;
+        realtime.chat.onMessage = (msg) => {
+            setMessages((m) => [...m, msg]);
+            prev?.(msg);
+        };
+        return () => {
+            realtime.chat.onMessage = prev;
+        };
+    }, [realtime]);
+    const clear = useCallback(() => setMessages([]), []);
+    return { messages, clear };
+}
+/**
+ * Hook that tracks typing indicators for a specific conversation.
+ *
+ * @param conversationId - The conversation to monitor
+ *
+ * @example
+ * ```tsx
+ * const { typingUsers, sendTyping } = useTypingIndicator(conversationId, recipientId);
+ * // typingUsers is a Set<string> of user IDs currently typing
+ * ```
+ */
+export function useTypingIndicator(conversationId, recipientUserId) {
+    const realtime = useRealTime();
+    const [typingUsers, setTypingUsers] = useState(new Set());
+    const timersRef = useRef(new Map());
+    useEffect(() => {
+        const prev = realtime.chat.onTypingIndicator;
+        realtime.chat.onTypingIndicator = (event) => {
+            if (event.conversationId === conversationId) {
+                setTypingUsers((current) => {
+                    const next = new Set(current);
+                    if (event.isTyping) {
+                        next.add(event.userId);
+                        // Auto-clear after 5s if no stop event
+                        const existing = timersRef.current.get(event.userId);
+                        if (existing)
+                            clearTimeout(existing);
+                        timersRef.current.set(event.userId, setTimeout(() => {
+                            setTypingUsers((c) => {
+                                const n = new Set(c);
+                                n.delete(event.userId);
+                                return n;
+                            });
+                            timersRef.current.delete(event.userId);
+                        }, 5000));
+                    }
+                    else {
+                        next.delete(event.userId);
+                        const existing = timersRef.current.get(event.userId);
+                        if (existing) {
+                            clearTimeout(existing);
+                            timersRef.current.delete(event.userId);
+                        }
+                    }
+                    return next;
+                });
+            }
+            prev?.(event);
+        };
+        return () => {
+            realtime.chat.onTypingIndicator = prev;
+            timersRef.current.forEach((timer) => clearTimeout(timer));
+            timersRef.current.clear();
+        };
+    }, [realtime, conversationId]);
+    const sendTyping = useCallback(async (isTyping) => {
+        if (recipientUserId) {
+            await realtime.sendTypingIndicator(conversationId, recipientUserId, isTyping);
+        }
+    }, [realtime, conversationId, recipientUserId]);
+    return { typingUsers, sendTyping };
+}
+/**
+ * Hook that tracks online/offline presence for specific user IDs.
+ *
+ * @param userIds - User IDs to track presence for
+ *
+ * @example
+ * ```tsx
+ * const presence = usePresence([artisanId]);
+ * // presence.get(artisanId) → { isOnline: true, lastSeenAt: '...' }
+ * ```
+ */
+export function usePresence(userIds) {
+    const realtime = useRealTime();
+    const [presence, setPresence] = useState(new Map());
+    useEffect(() => {
+        const prev = realtime.chat.onUserPresenceChanged;
+        realtime.chat.onUserPresenceChanged = (event) => {
+            if (userIds.includes(event.userId)) {
+                setPresence((current) => {
+                    const next = new Map(current);
+                    next.set(event.userId, { isOnline: event.isOnline, lastSeenAt: event.lastSeenAt });
+                    return next;
+                });
+            }
+            prev?.(event);
+        };
+        return () => {
+            realtime.chat.onUserPresenceChanged = prev;
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [realtime, ...userIds]);
+    return presence;
+}
+/**
+ * Hook that subscribes to incoming notifications in real-time.
+ *
+ * @example
+ * ```tsx
+ * const { notifications, unreadCount } = useRealtimeNotifications();
+ * ```
+ */
+export function useRealtimeNotifications() {
+    const realtime = useRealTime();
+    const [notifications, setNotifications] = useState([]);
+    const [unreadCount, setUnreadCount] = useState(null);
+    useEffect(() => {
+        const prevNotif = realtime.notifications.onNotification;
+        const prevCount = realtime.notifications.onNotificationCountUpdated;
+        realtime.notifications.onNotification = (notification) => {
+            setNotifications((n) => [notification, ...n]);
+            prevNotif?.(notification);
+        };
+        realtime.notifications.onNotificationCountUpdated = (event) => {
+            setUnreadCount(event.unreadCount);
+            prevCount?.(event);
+        };
+        return () => {
+            realtime.notifications.onNotification = prevNotif;
+            realtime.notifications.onNotificationCountUpdated = prevCount;
+        };
+    }, [realtime]);
+    const clear = useCallback(() => setNotifications([]), []);
+    return { notifications, unreadCount, clear };
+}
+/**
+ * Hook that manages joining/leaving a conversation and provides
+ * delivery and read receipt events for that conversation.
+ *
+ * @param conversationId - The conversation to join
+ *
+ * @example
+ * ```tsx
+ * const { deliveredIds, readMessageIds } = useConversation(conversationId);
+ * ```
+ */
+export function useConversation(conversationId) {
+    const realtime = useRealTime();
+    const [deliveredIds, setDeliveredIds] = useState(new Set());
+    const [readMessageIds, setReadMessageIds] = useState(new Set());
+    const [editedMessages, setEditedMessages] = useState(new Map());
+    const [deletedIds, setDeletedIds] = useState(new Set());
+    useEffect(() => {
+        realtime.joinConversation(conversationId).catch(() => { });
+        const prevDelivered = realtime.chat.onMessageDelivered;
+        const prevRead = realtime.chat.onMessagesRead;
+        const prevEdited = realtime.chat.onMessageEdited;
+        const prevDeleted = realtime.chat.onMessageDeleted;
+        realtime.chat.onMessageDelivered = (event) => {
+            if (event.conversationId === conversationId) {
+                setDeliveredIds((s) => new Set(s).add(event.messageId));
+            }
+            prevDelivered?.(event);
+        };
+        realtime.chat.onMessagesRead = (event) => {
+            if (event.conversationId === conversationId) {
+                setReadMessageIds((s) => {
+                    const next = new Set(s);
+                    event.messageIds.forEach((id) => next.add(id));
+                    return next;
+                });
+            }
+            prevRead?.(event);
+        };
+        realtime.chat.onMessageEdited = (event) => {
+            if (event.conversationId === conversationId) {
+                setEditedMessages((m) => {
+                    const next = new Map(m);
+                    next.set(event.messageId, { content: event.newContent, editedAt: event.editedAt });
+                    return next;
+                });
+            }
+            prevEdited?.(event);
+        };
+        realtime.chat.onMessageDeleted = (event) => {
+            if (event.conversationId === conversationId) {
+                setDeletedIds((s) => new Set(s).add(event.messageId));
+            }
+            prevDeleted?.(event);
+        };
+        return () => {
+            realtime.leaveConversation(conversationId).catch(() => { });
+            realtime.chat.onMessageDelivered = prevDelivered;
+            realtime.chat.onMessagesRead = prevRead;
+            realtime.chat.onMessageEdited = prevEdited;
+            realtime.chat.onMessageDeleted = prevDeleted;
+        };
+    }, [realtime, conversationId]);
+    return { deliveredIds, readMessageIds, editedMessages, deletedIds };
+}
 //# sourceMappingURL=index.js.map