@manonero/chat-client-sdk 1.0.0-beta.0

package/dist/realtime/ChatHubClient.js

@@ -0,0 +1,182 @@
+// realtime/ChatHubClient.ts — Manages ChatHub SignalR connection
+import { HubConnection, HubConnectionBuilder, HubConnectionState, LogLevel, } from '@microsoft/signalr';
+import { TypedEventEmitter as EventEmitter } from '../utils/TypedEventEmitter.js';
+// ---------------------------------------------------------------------------
+// ChatHubClient
+// ---------------------------------------------------------------------------
+/**
+ * Typed client for the ChatHub (`/hubs/chat`).
+ *
+ * Responsibilities:
+ * - Manages HubConnection lifecycle (connect / disconnect / auto-reconnect)
+ * - Exposes typed Hub methods (Client → Server)
+ * - Exposes typed event subscription (Server → Client)
+ * - Tracks joined conversations so ReconnectionManager can re-join on reconnect
+ */
+export class ChatHubClient {
+    constructor(options) {
+        this.connection = null;
+        /** Set of conversationIds that have been joined in the current session */
+        this.joinedConversations = new Set();
+        this.options = options;
+        this.emitter = new EventEmitter();
+    }
+    // ---------------------------------------------------------------------------
+    // Connection state
+    // ---------------------------------------------------------------------------
+    get state() {
+        return this.connection?.state ?? HubConnectionState.Disconnected;
+    }
+    // ---------------------------------------------------------------------------
+    // Connection management
+    // ---------------------------------------------------------------------------
+    /** Build a new HubConnection using the latest token from tokenProvider */
+    buildConnection() {
+        const { hubUrl, tokenProvider, logLevel = LogLevel.Warning } = this.options;
+        return new HubConnectionBuilder()
+            .withUrl(hubUrl, {
+            accessTokenFactory: () => tokenProvider() ?? '',
+        })
+            .withAutomaticReconnect()
+            .configureLogging(logLevel)
+            .build();
+    }
+    /** Attach SignalR server→client event handlers to the connection */
+    attachHandlers(conn) {
+        // Message events
+        conn.on('MessageReceived', (msg) => this.emitter.emit('messageReceived', msg));
+        conn.on('MessageUpdated', (dto) => this.emitter.emit('messageUpdated', dto));
+        conn.on('MessageDeleted', (dto) => this.emitter.emit('messageDeleted', dto));
+        conn.on('MessageRecovered', (msg) => this.emitter.emit('messageRecovered', msg));
+        // Reaction events
+        conn.on('ReactionAdded', (dto) => this.emitter.emit('reactionAdded', dto));
+        conn.on('ReactionRemoved', (dto) => this.emitter.emit('reactionRemoved', dto));
+        // Typing events
+        conn.on('TypingStarted', (dto) => this.emitter.emit('typingStarted', dto));
+        conn.on('TypingStopped', (dto) => this.emitter.emit('typingStopped', dto));
+        // Read receipt
+        conn.on('ReadReceiptUpdated', (dto) => this.emitter.emit('readReceiptUpdated', dto));
+        // Streaming events
+        conn.on('StreamStarted', (dto) => this.emitter.emit('streamStarted', dto));
+        conn.on('StreamStatusUpdated', (dto) => this.emitter.emit('streamStatusUpdated', dto));
+        conn.on('StreamChunkReceived', (dto) => this.emitter.emit('streamChunkReceived', dto));
+        conn.on('StreamCompleted', (dto) => this.emitter.emit('streamCompleted', dto));
+        conn.on('StreamAborted', (dto) => this.emitter.emit('streamAborted', dto));
+        // Hub errors (server→client)
+        conn.on('Error', (error) => this.emitter.emit('error', error));
+        // Connection lifecycle
+        conn.onreconnecting((err) => this.emitter.emit('reconnecting', err));
+        conn.onreconnected((connectionId) => {
+            // Re-join all previously joined conversations after reconnect
+            this.rejoinConversations().catch(() => {
+                // Best-effort — errors will be surfaced via error events
+            });
+            this.emitter.emit('reconnected', connectionId);
+        });
+        conn.onclose((err) => this.emitter.emit('disconnected', err));
+    }
+    /**
+     * Connect to ChatHub. If already connected, resolves immediately.
+     * Builds a fresh connection using the current token.
+     */
+    async connect() {
+        if (this.connection && this.connection.state === HubConnectionState.Connected) {
+            return;
+        }
+        // Disconnect existing stale connection cleanly
+        if (this.connection) {
+            await this.safeStop();
+        }
+        const conn = this.buildConnection();
+        this.attachHandlers(conn);
+        this.connection = conn;
+        await conn.start();
+    }
+    /**
+     * Disconnect from ChatHub and clear joined conversation tracking.
+     */
+    async disconnect() {
+        this.joinedConversations.clear();
+        await this.safeStop();
+        this.connection = null;
+    }
+    async safeStop() {
+        try {
+            await this.connection?.stop();
+        }
+        catch {
+            // Ignore errors during stop
+        }
+    }
+    /**
+     * Re-join all tracked conversations. Called internally after reconnect.
+     * Called by ReconnectionManager as well.
+     */
+    async rejoinConversations() {
+        const ids = Array.from(this.joinedConversations);
+        for (const id of ids) {
+            try {
+                await this.invokeHub('JoinConversation', id);
+            }
+            catch {
+                // Best-effort
+            }
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Hub Methods (Client → Server)
+    // ---------------------------------------------------------------------------
+    async invokeHub(method, ...args) {
+        if (!this.connection || this.connection.state !== HubConnectionState.Connected) {
+            throw new Error(`ChatHub is not connected (state: ${this.connection?.state ?? 'null'})`);
+        }
+        return this.connection.invoke(method, ...args);
+    }
+    async joinConversation(conversationId) {
+        await this.invokeHub('JoinConversation', conversationId);
+        this.joinedConversations.add(conversationId);
+    }
+    async leaveConversation(conversationId) {
+        await this.invokeHub('LeaveConversation', conversationId);
+        this.joinedConversations.delete(conversationId);
+    }
+    async startTyping(conversationId) {
+        await this.invokeHub('StartTyping', conversationId);
+    }
+    async stopTyping(conversationId) {
+        await this.invokeHub('StopTyping', conversationId);
+    }
+    async markAsRead(conversationId, messageId) {
+        return this.invokeHub('MarkAsRead', conversationId, messageId);
+    }
+    async sendMessage(request) {
+        return this.invokeHub('SendMessage', request);
+    }
+    async editMessage(request) {
+        return this.invokeHub('EditMessage', request);
+    }
+    /** Server expects an object { messageId }, not a bare string */
+    async deleteMessage(request) {
+        return this.invokeHub('DeleteMessage', request);
+    }
+    /** Server expects an object { messageId }, not a bare string */
+    async recoverMessage(request) {
+        return this.invokeHub('RecoverMessage', request);
+    }
+    async addReaction(request) {
+        return this.invokeHub('AddReaction', request);
+    }
+    async removeReaction(request) {
+        return this.invokeHub('RemoveReaction', request);
+    }
+    // ---------------------------------------------------------------------------
+    // Event subscription (Server → Client)
+    // ---------------------------------------------------------------------------
+    on(event, handler) {
+        return this.emitter.on(event, handler);
+    }
+    off(event, handler) {
+        this.emitter.off(event, handler);
+    }
+}
+//# sourceMappingURL=ChatHubClient.js.map

package/dist/realtime/ChatHubClient.js.map

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

package/dist/realtime/NotificationHubClient.d.ts

@@ -0,0 +1,73 @@
+import { HubConnectionState, LogLevel } from '@microsoft/signalr';
+import type { Unsubscribe } from '../utils/TypedEventEmitter.js';
+import type { PresenceStateItem, PresenceChangedDto, NewMessageNotificationDto, MentionedNotificationDto, UnreadCountChangedDto, ConversationCreatedDto, ConversationUpdatedDto, ParticipantJoinedDto, ParticipantLeftDto, ConversationPinnedDto, ConversationUnpinnedDto, ReadStatusChangedDto } from '../types/notification-events.js';
+import type { HubErrorDto } from '../types/signalr.js';
+export interface NotificationHubEventMap {
+    presenceState: PresenceStateItem[];
+    presenceChanged: PresenceChangedDto;
+    newMessageNotification: NewMessageNotificationDto;
+    mentionedNotification: MentionedNotificationDto;
+    unreadCountChanged: UnreadCountChangedDto;
+    conversationCreated: ConversationCreatedDto;
+    conversationUpdated: ConversationUpdatedDto;
+    participantJoined: ParticipantJoinedDto;
+    participantLeft: ParticipantLeftDto;
+    conversationPinned: ConversationPinnedDto;
+    conversationUnpinned: ConversationUnpinnedDto;
+    readStatusChanged: ReadStatusChangedDto;
+    error: HubErrorDto;
+    reconnecting: Error | undefined;
+    reconnected: string | undefined;
+    disconnected: Error | undefined;
+}
+export interface NotificationHubClientOptions {
+    /** Full URL of the NotificationHub endpoint, e.g. "https://api.example.com/hubs/notifications" */
+    hubUrl: string;
+    /** Returns the current JWT token to use as access_token query param */
+    tokenProvider: () => string | null;
+    /** Minimum log level for SignalR internal logging (default: Warning) */
+    logLevel?: LogLevel;
+}
+/**
+ * Typed client for the NotificationHub (`/hubs/notifications`).
+ *
+ * Responsibilities:
+ * - Manages HubConnection lifecycle (connect / disconnect / auto-reconnect)
+ * - Exposes typed Hub methods: subscribeToPresence / unsubscribeFromPresence
+ * - Exposes typed event subscription (Server → Client)
+ * - Tracks subscribed presence participants for re-subscribe on reconnect
+ */
+export declare class NotificationHubClient {
+    private readonly options;
+    private connection;
+    private readonly emitter;
+    /** Set of participantIds currently subscribed to presence updates */
+    readonly subscribedPresenceIds: Set<string>;
+    constructor(options: NotificationHubClientOptions);
+    get state(): HubConnectionState;
+    /** Build a new HubConnection using the latest token from tokenProvider */
+    private buildConnection;
+    /** Attach SignalR server→client event handlers to the connection */
+    private attachHandlers;
+    /**
+     * Connect to NotificationHub. If already connected, resolves immediately.
+     * Connecting automatically marks the user as online on the server.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from NotificationHub. Automatically marks user as offline (server-side).
+     */
+    disconnect(): Promise<void>;
+    private safeStop;
+    /**
+     * Re-subscribe to all tracked presence participant IDs.
+     * Called internally after reconnect. Also callable by ReconnectionManager.
+     */
+    resubscribePresence(): Promise<void>;
+    private invokeHub;
+    subscribeToPresence(participantIds: string[]): Promise<void>;
+    unsubscribeFromPresence(participantIds: string[]): Promise<void>;
+    on<K extends keyof NotificationHubEventMap>(event: K, handler: (payload: NotificationHubEventMap[K]) => void): Unsubscribe;
+    off<K extends keyof NotificationHubEventMap>(event: K, handler: (payload: NotificationHubEventMap[K]) => void): void;
+}
+//# sourceMappingURL=NotificationHubClient.d.ts.map

package/dist/realtime/NotificationHubClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationHubClient.d.ts","sourceRoot":"","sources":["../../src/realtime/NotificationHubClient.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,kBAAkB,EAClB,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAqB,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEpF,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvD,MAAM,WAAW,uBAAuB;IAEtC,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,eAAe,EAAE,kBAAkB,CAAC;IAGpC,sBAAsB,EAAE,yBAAyB,CAAC;IAClD,qBAAqB,EAAE,wBAAwB,CAAC;IAChD,kBAAkB,EAAE,qBAAqB,CAAC;IAG1C,mBAAmB,EAAE,sBAAsB,CAAC;IAC5C,mBAAmB,EAAE,sBAAsB,CAAC;IAC5C,iBAAiB,EAAE,oBAAoB,CAAC;IACxC,eAAe,EAAE,kBAAkB,CAAC;IACpC,kBAAkB,EAAE,qBAAqB,CAAC;IAC1C,oBAAoB,EAAE,uBAAuB,CAAC;IAC9C,iBAAiB,EAAE,oBAAoB,CAAC;IAGxC,KAAK,EAAE,WAAW,CAAC;IAGnB,YAAY,EAAE,KAAK,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,EAAE,KAAK,GAAG,SAAS,CAAC;CACjC;AAMD,MAAM,WAAW,4BAA4B;IAC3C,kGAAkG;IAClG,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAMD;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE,qEAAqE;IACrE,QAAQ,CAAC,qBAAqB,cAAqB;gBAEvC,OAAO,EAAE,4BAA4B;IASjD,IAAI,KAAK,IAAI,kBAAkB,CAE9B;IAMD,0EAA0E;IAC1E,OAAO,CAAC,eAAe;IAWvB,oEAAoE;IACpE,OAAO,CAAC,cAAc;IA4CtB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAMnB,QAAQ;IAQtB;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;YAiB5B,SAAS;IASjB,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D,uBAAuB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IActE,EAAE,CAAC,CAAC,SAAS,MAAM,uBAAuB,EACxC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAAK,IAAI,GACrD,WAAW;IAId,GAAG,CAAC,CAAC,SAAS,MAAM,uBAAuB,EACzC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAAK,IAAI,GACrD,IAAI;CAGR"}

package/dist/realtime/NotificationHubClient.js

@@ -0,0 +1,162 @@
+// realtime/NotificationHubClient.ts — Manages NotificationHub SignalR connection
+import { HubConnection, HubConnectionBuilder, HubConnectionState, LogLevel, } from '@microsoft/signalr';
+import { TypedEventEmitter as EventEmitter } from '../utils/TypedEventEmitter.js';
+// ---------------------------------------------------------------------------
+// NotificationHubClient
+// ---------------------------------------------------------------------------
+/**
+ * Typed client for the NotificationHub (`/hubs/notifications`).
+ *
+ * Responsibilities:
+ * - Manages HubConnection lifecycle (connect / disconnect / auto-reconnect)
+ * - Exposes typed Hub methods: subscribeToPresence / unsubscribeFromPresence
+ * - Exposes typed event subscription (Server → Client)
+ * - Tracks subscribed presence participants for re-subscribe on reconnect
+ */
+export class NotificationHubClient {
+    constructor(options) {
+        this.connection = null;
+        /** Set of participantIds currently subscribed to presence updates */
+        this.subscribedPresenceIds = new Set();
+        this.options = options;
+        this.emitter = new EventEmitter();
+    }
+    // ---------------------------------------------------------------------------
+    // Connection state
+    // ---------------------------------------------------------------------------
+    get state() {
+        return this.connection?.state ?? HubConnectionState.Disconnected;
+    }
+    // ---------------------------------------------------------------------------
+    // Connection management
+    // ---------------------------------------------------------------------------
+    /** Build a new HubConnection using the latest token from tokenProvider */
+    buildConnection() {
+        const { hubUrl, tokenProvider, logLevel = LogLevel.Warning } = this.options;
+        return new HubConnectionBuilder()
+            .withUrl(hubUrl, {
+            accessTokenFactory: () => tokenProvider() ?? '',
+        })
+            .withAutomaticReconnect()
+            .configureLogging(logLevel)
+            .build();
+    }
+    /** Attach SignalR server→client event handlers to the connection */
+    attachHandlers(conn) {
+        // Presence events
+        conn.on('PresenceState', (states) => this.emitter.emit('presenceState', states));
+        conn.on('PresenceChanged', (dto) => this.emitter.emit('presenceChanged', dto));
+        // Message notifications
+        conn.on('NewMessageNotification', (dto) => this.emitter.emit('newMessageNotification', dto));
+        conn.on('MentionedNotification', (dto) => this.emitter.emit('mentionedNotification', dto));
+        conn.on('UnreadCountChanged', (dto) => this.emitter.emit('unreadCountChanged', dto));
+        // Conversation events
+        conn.on('ConversationCreated', (dto) => this.emitter.emit('conversationCreated', dto));
+        conn.on('ConversationUpdated', (dto) => this.emitter.emit('conversationUpdated', dto));
+        conn.on('ParticipantJoined', (dto) => this.emitter.emit('participantJoined', dto));
+        conn.on('ParticipantLeft', (dto) => this.emitter.emit('participantLeft', dto));
+        conn.on('ConversationPinned', (dto) => this.emitter.emit('conversationPinned', dto));
+        conn.on('ConversationUnpinned', (dto) => this.emitter.emit('conversationUnpinned', dto));
+        conn.on('ReadStatusChanged', (dto) => this.emitter.emit('readStatusChanged', dto));
+        // Hub errors (server→client)
+        conn.on('Error', (error) => this.emitter.emit('error', error));
+        // Connection lifecycle
+        conn.onreconnecting((err) => this.emitter.emit('reconnecting', err));
+        conn.onreconnected((connectionId) => {
+            // Re-subscribe presence for all tracked participants
+            this.resubscribePresence().catch(() => {
+                // Best-effort
+            });
+            this.emitter.emit('reconnected', connectionId);
+        });
+        conn.onclose((err) => this.emitter.emit('disconnected', err));
+    }
+    /**
+     * Connect to NotificationHub. If already connected, resolves immediately.
+     * Connecting automatically marks the user as online on the server.
+     */
+    async connect() {
+        if (this.connection && this.connection.state === HubConnectionState.Connected) {
+            return;
+        }
+        // Disconnect existing stale connection cleanly
+        if (this.connection) {
+            await this.safeStop();
+        }
+        const conn = this.buildConnection();
+        this.attachHandlers(conn);
+        this.connection = conn;
+        await conn.start();
+    }
+    /**
+     * Disconnect from NotificationHub. Automatically marks user as offline (server-side).
+     */
+    async disconnect() {
+        this.subscribedPresenceIds.clear();
+        await this.safeStop();
+        this.connection = null;
+    }
+    async safeStop() {
+        try {
+            await this.connection?.stop();
+        }
+        catch {
+            // Ignore errors during stop
+        }
+    }
+    /**
+     * Re-subscribe to all tracked presence participant IDs.
+     * Called internally after reconnect. Also callable by ReconnectionManager.
+     */
+    async resubscribePresence() {
+        const ids = Array.from(this.subscribedPresenceIds);
+        if (ids.length === 0)
+            return;
+        // Batch into chunks of 200 to respect the server limit
+        for (let i = 0; i < ids.length; i += 200) {
+            try {
+                await this.invokeHub('SubscribeToPresence', ids.slice(i, i + 200));
+            }
+            catch {
+                // Best-effort
+            }
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Hub Methods (Client → Server)
+    // ---------------------------------------------------------------------------
+    async invokeHub(method, ...args) {
+        if (!this.connection || this.connection.state !== HubConnectionState.Connected) {
+            throw new Error(`NotificationHub is not connected (state: ${this.connection?.state ?? 'null'})`);
+        }
+        return this.connection.invoke(method, ...args);
+    }
+    async subscribeToPresence(participantIds) {
+        if (participantIds.length > 200) {
+            throw new Error('Cannot subscribe to more than 200 participants at once');
+        }
+        await this.invokeHub('SubscribeToPresence', participantIds);
+        for (const id of participantIds) {
+            this.subscribedPresenceIds.add(id);
+        }
+    }
+    async unsubscribeFromPresence(participantIds) {
+        if (participantIds.length > 200) {
+            throw new Error('Cannot unsubscribe from more than 200 participants at once');
+        }
+        await this.invokeHub('UnsubscribeFromPresence', participantIds);
+        for (const id of participantIds) {
+            this.subscribedPresenceIds.delete(id);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Event subscription (Server → Client)
+    // ---------------------------------------------------------------------------
+    on(event, handler) {
+        return this.emitter.on(event, handler);
+    }
+    off(event, handler) {
+        this.emitter.off(event, handler);
+    }
+}
+//# sourceMappingURL=NotificationHubClient.js.map

package/dist/realtime/NotificationHubClient.js.map

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

package/dist/realtime/ReconnectionManager.d.ts

@@ -0,0 +1,65 @@
+import type { ChatHubClient } from './ChatHubClient.js';
+import type { NotificationHubClient } from './NotificationHubClient.js';
+export interface ReconnectionManagerOptions {
+    /** ChatHub client to manage */
+    chatHub: ChatHubClient;
+    /** NotificationHub client to manage */
+    notificationHub: NotificationHubClient;
+    /**
+     * Called when reconnect is rejected with 401 (token likely expired).
+     * Should return a fresh token, or null to cancel reconnect attempts.
+     *
+     * The returned token should be committed to the application's token store
+     * so that the shared tokenProvider reflects the new value immediately —
+     * the SDK will then pick it up on the next connect() call.
+     */
+    onTokenExpired?: () => Promise<string | null>;
+}
+/**
+ * ReconnectionManager coordinates reconnection for both ChatHub and NotificationHub.
+ *
+ * Responsibilities:
+ * 1. Listens for `disconnected` events from both hubs and attempts to reconnect.
+ * 2. After ChatHub reconnects, re-joins all previously joined conversations.
+ * 3. After NotificationHub reconnects, re-subscribes to all previously tracked presences.
+ * 4. On 401-style reconnect failures, calls `onTokenExpired` to obtain a fresh token,
+ *    then retries the connection once.
+ *
+ * Note on token propagation:
+ *   - SignalR tokens are provided at connect-time via accessTokenFactory.
+ *   - Both hub clients call tokenProvider() on every new connect(), so updating
+ *     the token in the provider is sufficient before calling connect() again.
+ *   - Existing active connections cannot receive a new token mid-session.
+ */
+export declare class ReconnectionManager {
+    private readonly chatHub;
+    private readonly notificationHub;
+    private readonly onTokenExpired?;
+    private unsubscribeChatDisconnected?;
+    private unsubscribeNotificationDisconnected?;
+    /** Whether the manager is actively managing reconnections */
+    private active;
+    constructor(options: ReconnectionManagerOptions);
+    /**
+     * Start managing reconnections. Attaches `disconnected` listeners to both hubs.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    start(): void;
+    /**
+     * Stop managing reconnections and detach all listeners.
+     */
+    stop(): void;
+    private handleChatDisconnected;
+    private handleNotificationDisconnected;
+    /**
+     * Determine if the disconnect error is likely due to token expiry (HTTP 401).
+     * SignalR surfaces this as an error message containing "401" or "Unauthorized".
+     */
+    private isTokenExpiredError;
+    /**
+     * Attempt to reconnect a hub with exponential backoff (max 3 retries).
+     * After a successful connect, calls `afterConnect` to restore subscriptions.
+     */
+    private reconnectHub;
+}
+//# sourceMappingURL=ReconnectionManager.d.ts.map

package/dist/realtime/ReconnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReconnectionManager.d.ts","sourceRoot":"","sources":["../../src/realtime/ReconnectionManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,MAAM,WAAW,0BAA0B;IACzC,+BAA+B;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,uCAAuC;IACvC,eAAe,EAAE,qBAAqB,CAAC;IACvC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA+B;IAE/D,OAAO,CAAC,2BAA2B,CAAC,CAAa;IACjD,OAAO,CAAC,mCAAmC,CAAC,CAAa;IAEzD,6DAA6D;IAC7D,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,0BAA0B;IAM/C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAeb;;OAEG;IACH,IAAI,IAAI,IAAI;YAYE,sBAAsB;YAiBtB,8BAA8B;IAmB5C;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;;OAGG;YACW,YAAY;CA2B3B"}

package/dist/realtime/ReconnectionManager.js

@@ -0,0 +1,118 @@
+// realtime/ReconnectionManager.ts — Coordinates auto-reconnect for both hubs
+import { HubConnectionState } from '@microsoft/signalr';
+/**
+ * ReconnectionManager coordinates reconnection for both ChatHub and NotificationHub.
+ *
+ * Responsibilities:
+ * 1. Listens for `disconnected` events from both hubs and attempts to reconnect.
+ * 2. After ChatHub reconnects, re-joins all previously joined conversations.
+ * 3. After NotificationHub reconnects, re-subscribes to all previously tracked presences.
+ * 4. On 401-style reconnect failures, calls `onTokenExpired` to obtain a fresh token,
+ *    then retries the connection once.
+ *
+ * Note on token propagation:
+ *   - SignalR tokens are provided at connect-time via accessTokenFactory.
+ *   - Both hub clients call tokenProvider() on every new connect(), so updating
+ *     the token in the provider is sufficient before calling connect() again.
+ *   - Existing active connections cannot receive a new token mid-session.
+ */
+export class ReconnectionManager {
+    constructor(options) {
+        /** Whether the manager is actively managing reconnections */
+        this.active = false;
+        this.chatHub = options.chatHub;
+        this.notificationHub = options.notificationHub;
+        this.onTokenExpired = options.onTokenExpired;
+    }
+    /**
+     * Start managing reconnections. Attaches `disconnected` listeners to both hubs.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    start() {
+        if (this.active)
+            return;
+        this.active = true;
+        this.unsubscribeChatDisconnected = this.chatHub.on('disconnected', (err) => void this.handleChatDisconnected(err));
+        this.unsubscribeNotificationDisconnected = this.notificationHub.on('disconnected', (err) => void this.handleNotificationDisconnected(err));
+    }
+    /**
+     * Stop managing reconnections and detach all listeners.
+     */
+    stop() {
+        this.active = false;
+        this.unsubscribeChatDisconnected?.();
+        this.unsubscribeNotificationDisconnected?.();
+        this.unsubscribeChatDisconnected = undefined;
+        this.unsubscribeNotificationDisconnected = undefined;
+    }
+    // ---------------------------------------------------------------------------
+    // Disconnect handlers
+    // ---------------------------------------------------------------------------
+    async handleChatDisconnected(err) {
+        if (!this.active)
+            return;
+        // withAutomaticReconnect already tried — this is a terminal disconnect.
+        // Attempt one more manual reconnect after optional token refresh.
+        if (this.isTokenExpiredError(err)) {
+            const newToken = await this.onTokenExpired?.();
+            if (!newToken)
+                return; // Client chose to abandon reconnect
+        }
+        await this.reconnectHub(() => this.chatHub.state, () => this.chatHub.connect(), () => this.chatHub.rejoinConversations());
+    }
+    async handleNotificationDisconnected(err) {
+        if (!this.active)
+            return;
+        if (this.isTokenExpiredError(err)) {
+            const newToken = await this.onTokenExpired?.();
+            if (!newToken)
+                return;
+        }
+        await this.reconnectHub(() => this.notificationHub.state, () => this.notificationHub.connect(), () => this.notificationHub.resubscribePresence());
+    }
+    // ---------------------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Determine if the disconnect error is likely due to token expiry (HTTP 401).
+     * SignalR surfaces this as an error message containing "401" or "Unauthorized".
+     */
+    isTokenExpiredError(err) {
+        if (!err)
+            return false;
+        const msg = err.message ?? '';
+        return msg.includes('401') || msg.toLowerCase().includes('unauthorized');
+    }
+    /**
+     * Attempt to reconnect a hub with exponential backoff (max 3 retries).
+     * After a successful connect, calls `afterConnect` to restore subscriptions.
+     */
+    async reconnectHub(getState, connect, afterConnect) {
+        if (getState() === HubConnectionState.Connected)
+            return;
+        const delays = [2000, 5000, 10000]; // ms — 2s, 5s, 10s
+        for (const delay of delays) {
+            if (!this.active)
+                return;
+            await sleep(delay);
+            if (getState() === HubConnectionState.Connected)
+                return;
+            try {
+                await connect();
+                // Successful connect — restore state
+                await afterConnect().catch(() => {
+                    // Best-effort: don't fail reconnect if re-subscribe fails
+                });
+                return;
+            }
+            catch {
+                // Retry after next delay
+            }
+        }
+        // All retries exhausted — emit is handled by the hub's onclose handler
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=ReconnectionManager.js.map

package/dist/realtime/ReconnectionManager.js.map

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