@manonero/chat-client-sdk 0.0.1-beta.1

package/dist/realtime/ChatHubClient.js

@@ -0,0 +1,365 @@
+// realtime/ChatHubClient.ts — Manages ChatHub SignalR connection
+import { HubConnection, HubConnectionBuilder, HubConnectionState, LogLevel, } from '@microsoft/signalr';
+import { TypedEventEmitter as EventEmitter } from '../utils/TypedEventEmitter.js';
+import { normalizeBlocksForSend } from '../types/block.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;
+        /** In-flight connect Promise, used to dedupe concurrent connect() calls. */
+        this.connectingPromise = null;
+        /**
+         * True after a user-initiated disconnect() until the next connect() begins.
+         * ReconnectionManager uses this to skip auto-reconnect when the close was
+         * intentional rather than caused by a transport failure.
+         */
+        this._intentionallyClosed = false;
+        /** Set of conversationIds that have been joined in the current session */
+        this.joinedConversations = new Set();
+        /**
+         * Tracks join attempts that resolved successfully but may still be revoked by
+         * a follow-up server `Error` event (FORBIDDEN/UNAUTHORIZED). Entries auto-expire
+         * after PENDING_JOIN_TTL_MS to bound memory.
+         */
+        this.pendingJoinAttempts = new Map();
+        this.options = options;
+        this.emitter = new EventEmitter();
+    }
+    // ---------------------------------------------------------------------------
+    // Connection state
+    // ---------------------------------------------------------------------------
+    get state() {
+        return this.connection?.state ?? HubConnectionState.Disconnected;
+    }
+    /**
+     * True after a user-initiated disconnect() and until the next connect() starts.
+     * ReconnectionManager honors this to avoid reconnecting after an intentional close.
+     */
+    get intentionallyClosed() {
+        return this._intentionallyClosed;
+    }
+    // ---------------------------------------------------------------------------
+    // 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, {
+            // Throw rather than return '' so SignalR fails the request loudly with
+            // a useful error instead of sending an empty `Authorization: Bearer ` header.
+            accessTokenFactory: () => {
+                const t = tokenProvider();
+                if (!t) {
+                    throw new Error('ChatHub: no authentication token available');
+                }
+                return t;
+            },
+        })
+            .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));
+        conn.on('MessageThumbnailsReady', (dto) => this.emitter.emit('messageThumbnailsReady', dto));
+        // 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));
+        // 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('StreamChunkBatchReceived', (dto) => this.emitter.emit('streamChunkBatchReceived', dto));
+        conn.on('StreamCompleted', (dto) => this.emitter.emit('streamCompleted', dto));
+        conn.on('StreamAborted', (dto) => this.emitter.emit('streamAborted', dto));
+        // Hub errors (server→client) — also revert pending joins on FORBIDDEN/UNAUTHORIZED
+        conn.on('Error', (error) => {
+            this.handlePotentialJoinFailure(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.
+     * Concurrent calls share a single in-flight Promise — building two
+     * connections at once would leak handlers.
+     * Builds a fresh connection using the current token.
+     *
+     * Throws synchronously when no authentication token is available so the
+     * caller gets a clear error rather than a malformed Authorization header.
+     */
+    async connect() {
+        if (this.connection && this.connection.state === HubConnectionState.Connected) {
+            return;
+        }
+        if (this.connectingPromise) {
+            return this.connectingPromise;
+        }
+        if (!this.options.tokenProvider()) {
+            throw new Error('ChatHubClient.connect(): no authentication token available. ' +
+                'Provide one via ChatClient.setToken() or the tokenProvider option.');
+        }
+        // The user is explicitly opening a connection — clear any prior
+        // intentional-close flag so ReconnectionManager will manage future drops.
+        this._intentionallyClosed = false;
+        const promise = (async () => {
+            try {
+                // Disconnect existing stale connection cleanly
+                if (this.connection) {
+                    await this.safeStop();
+                }
+                const conn = this.buildConnection();
+                this.attachHandlers(conn);
+                this.connection = conn;
+                await conn.start();
+            }
+            finally {
+                this.connectingPromise = null;
+            }
+        })();
+        this.connectingPromise = promise;
+        return promise;
+    }
+    /**
+     * Disconnect from ChatHub and clear joined conversation tracking.
+     * If a connect is in flight, it is awaited first so we always tear down a
+     * fully-formed connection (not a half-built one).
+     *
+     * Sets `intentionallyClosed` so ReconnectionManager skips its reconnect
+     * attempt for the resulting `disconnected` event.
+     */
+    async disconnect() {
+        // Mark intentional BEFORE awaiting the in-flight connect so any
+        // disconnected events that fire during teardown are not auto-reconnected.
+        this._intentionallyClosed = true;
+        if (this.connectingPromise) {
+            try {
+                await this.connectingPromise;
+            }
+            catch {
+                // The connect failed — there's nothing established to tear down,
+                // but still proceed to clear local state below.
+            }
+        }
+        this.joinedConversations.clear();
+        this.clearPendingJoinAttempts();
+        await this.safeStop();
+        this.connection = null;
+    }
+    /** Detach all server→client method handlers registered via attachHandlers(). */
+    detachHandlers(conn) {
+        for (const name of ChatHubClient.HUB_EVENT_NAMES) {
+            conn.off(name);
+        }
+    }
+    async safeStop() {
+        if (!this.connection)
+            return;
+        // Detach handlers first so any late events on this connection are dropped.
+        this.detachHandlers(this.connection);
+        try {
+            await this.connection.stop();
+        }
+        catch {
+            // Ignore errors during stop
+        }
+    }
+    /**
+     * Re-join all tracked conversations. Called internally after reconnect.
+     * Called by ReconnectionManager as well.
+     *
+     * If a rejoin fails with an access-denied style error (e.g. user was kicked
+     * between disconnect and reconnect), the conversation is purged from
+     * `joinedConversations` so we do not retry it forever on every reconnect.
+     * Other errors keep the entry — the next reconnect will try again.
+     */
+    async rejoinConversations() {
+        const ids = Array.from(this.joinedConversations);
+        for (const id of ids) {
+            try {
+                await this.invokeHub('JoinConversation', id);
+            }
+            catch (err) {
+                if (this.isAccessDeniedError(err)) {
+                    this.joinedConversations.delete(id);
+                }
+                // Other errors: keep tracking so a later reconnect retries.
+            }
+        }
+    }
+    isAccessDeniedError(err) {
+        if (!(err instanceof Error))
+            return false;
+        const msg = err.message.toLowerCase();
+        return (msg.includes('forbidden') ||
+            msg.includes('not a participant') ||
+            msg.includes('unauthorized') ||
+            msg.includes('access denied'));
+    }
+    // ---------------------------------------------------------------------------
+    // 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);
+        // Track as pending so a follow-up FORBIDDEN/UNAUTHORIZED Error event can revert it.
+        this.markJoinPending(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 sendMessage(request) {
+        // Spec §6: `$type` must be the first property in each block when sent to
+        // the server, otherwise the polymorphic deserializer rejects the payload.
+        const normalized = {
+            ...request,
+            blocks: normalizeBlocksForSend(request.blocks),
+        };
+        return this.invokeHub('SendMessage', normalized);
+    }
+    async editMessage(request) {
+        const normalized = {
+            ...request,
+            newBlocks: normalizeBlocksForSend(request.newBlocks),
+        };
+        return this.invokeHub('EditMessage', normalized);
+    }
+    /** 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);
+    }
+    // ---------------------------------------------------------------------------
+    // Pending join cleanup — guards against the spec edge case where the server
+    // accepts the JoinConversation invoke but later rejects via an `Error` event
+    // (e.g. FORBIDDEN — user is not a participant). Without this, the conversation
+    // would stay in `joinedConversations` and be wrongly auto-rejoined on reconnect.
+    // ---------------------------------------------------------------------------
+    markJoinPending(conversationId) {
+        const existing = this.pendingJoinAttempts.get(conversationId);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => this.pendingJoinAttempts.delete(conversationId), ChatHubClient.PENDING_JOIN_TTL_MS);
+        this.pendingJoinAttempts.set(conversationId, timer);
+    }
+    clearPendingJoinAttempts() {
+        for (const timer of this.pendingJoinAttempts.values())
+            clearTimeout(timer);
+        this.pendingJoinAttempts.clear();
+    }
+    revertJoin(conversationId) {
+        this.joinedConversations.delete(conversationId);
+        const timer = this.pendingJoinAttempts.get(conversationId);
+        if (timer)
+            clearTimeout(timer);
+        this.pendingJoinAttempts.delete(conversationId);
+    }
+    /**
+     * If a server-emitted Error indicates a join was rejected, remove the
+     * conversation from `joinedConversations` to prevent auto-rejoin on reconnect.
+     *
+     * Strategy:
+     *   1. If `error.details.conversationId` is provided AND matches a pending
+     *      join attempt → revert that one (most reliable signal).
+     *   2. Else, if the message matches the spec's documented FORBIDDEN text
+     *      ("not a participant") AND there is exactly one pending join → revert it.
+     *   3. Otherwise do nothing — we cannot safely correlate the error to a join.
+     */
+    handlePotentialJoinFailure(error) {
+        if (error.code !== 'FORBIDDEN' && error.code !== 'UNAUTHORIZED')
+            return;
+        const detailsConvId = error.details && typeof error.details === 'object'
+            ? error.details.conversationId
+            : undefined;
+        if (typeof detailsConvId === 'string' && this.pendingJoinAttempts.has(detailsConvId)) {
+            this.revertJoin(detailsConvId);
+            return;
+        }
+        if (/not a participant/i.test(error.message) && this.pendingJoinAttempts.size === 1) {
+            const onlyId = this.pendingJoinAttempts.keys().next().value;
+            if (onlyId)
+                this.revertJoin(onlyId);
+        }
+    }
+}
+ChatHubClient.PENDING_JOIN_TTL_MS = 2000;
+/** Server→client method names registered via conn.on() — used for cleanup. */
+ChatHubClient.HUB_EVENT_NAMES = [
+    'MessageReceived',
+    'MessageUpdated',
+    'MessageDeleted',
+    'MessageRecovered',
+    'MessageThumbnailsReady',
+    'ReactionAdded',
+    'ReactionRemoved',
+    'TypingStarted',
+    'TypingStopped',
+    'StreamStarted',
+    'StreamStatusUpdated',
+    'StreamChunkReceived',
+    'StreamChunkBatchReceived',
+    'StreamCompleted',
+    'StreamAborted',
+    'Error',
+];
+//# 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,89 @@
+import { HubConnectionState, LogLevel } from '@microsoft/signalr';
+import type { Unsubscribe } from '../utils/TypedEventEmitter.js';
+import type { NewMessageNotificationDto, MentionedNotificationDto, ConversationCreatedDto, ConversationUpdatedDto, ParticipantJoinedDto, ParticipantLeftDto, ConversationPinnedDto, ConversationUnpinnedDto } from '../types/notification-events.js';
+export interface NotificationHubEventMap {
+    newMessageNotification: NewMessageNotificationDto;
+    mentionedNotification: MentionedNotificationDto;
+    conversationCreated: ConversationCreatedDto;
+    conversationUpdated: ConversationUpdatedDto;
+    participantJoined: ParticipantJoinedDto;
+    participantLeft: ParticipantLeftDto;
+    conversationPinned: ConversationPinnedDto;
+    conversationUnpinned: ConversationUnpinnedDto;
+    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`).
+ *
+ * Per spec §4: NotificationHub has **no client-callable hub methods** —
+ * after connecting, the server automatically pushes events to the user's
+ * personal group (`participant:{userId}`). There is also no `Error` event
+ * on this hub: invalid/expired JWT is rejected at the gateway (HTTP 401)
+ * and a missing `sub` claim aborts the connection — both silent on the
+ * wire. Register the `Error` listener on ChatHub instead.
+ *
+ * Responsibilities:
+ * - Manages HubConnection lifecycle (connect / disconnect / auto-reconnect)
+ * - Exposes typed event subscription (Server → Client)
+ */
+export declare class NotificationHubClient {
+    private readonly options;
+    private connection;
+    private readonly emitter;
+    /** In-flight connect Promise, used to dedupe concurrent connect() calls. */
+    private connectingPromise;
+    /**
+     * True after a user-initiated disconnect() until the next connect() begins.
+     * ReconnectionManager uses this to skip auto-reconnect when the close was
+     * intentional rather than caused by a transport failure.
+     */
+    private _intentionallyClosed;
+    /** Server→client method names registered via conn.on() — used for cleanup. */
+    private static readonly HUB_EVENT_NAMES;
+    constructor(options: NotificationHubClientOptions);
+    get state(): HubConnectionState;
+    /**
+     * True after a user-initiated disconnect() and until the next connect() starts.
+     * ReconnectionManager honors this to avoid reconnecting after an intentional close.
+     */
+    get intentionallyClosed(): boolean;
+    /** 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.
+     * Concurrent calls share a single in-flight Promise — building two
+     * connections at once would leak handlers.
+     * Builds a fresh connection using the current token.
+     *
+     * Throws synchronously when no authentication token is available so the
+     * caller gets a clear error rather than a malformed Authorization header.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from NotificationHub.
+     * If a connect is in flight, it is awaited first so we always tear down a
+     * fully-formed connection (not a half-built one).
+     *
+     * Sets `intentionallyClosed` so ReconnectionManager skips its reconnect
+     * attempt for the resulting `disconnected` event.
+     */
+    disconnect(): Promise<void>;
+    /** Detach all server→client method handlers registered via attachHandlers(). */
+    private detachHandlers;
+    private safeStop;
+    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,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,iCAAiC,CAAC;AAMzC,MAAM,WAAW,uBAAuB;IAEtC,sBAAsB,EAAE,yBAAyB,CAAC;IAClD,qBAAqB,EAAE,wBAAwB,CAAC;IAGhD,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;IAG9C,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;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE,4EAA4E;IAC5E,OAAO,CAAC,iBAAiB,CAA8B;IAEvD;;;;OAIG;IACH,OAAO,CAAC,oBAAoB,CAAS;IAErC,8EAA8E;IAC9E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAS5B;gBAEC,OAAO,EAAE,4BAA4B;IASjD,IAAI,KAAK,IAAI,kBAAkB,CAE9B;IAED;;;OAGG;IACH,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAMD,0EAA0E;IAC1E,OAAO,CAAC,eAAe;IAmBvB,oEAAoE;IACpE,OAAO,CAAC,cAAc;IA2BtB;;;;;;;;OAQG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC9B;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBjC,gFAAgF;IAChF,OAAO,CAAC,cAAc;YAMR,QAAQ;IAetB,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,191 @@
+// 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`).
+ *
+ * Per spec §4: NotificationHub has **no client-callable hub methods** —
+ * after connecting, the server automatically pushes events to the user's
+ * personal group (`participant:{userId}`). There is also no `Error` event
+ * on this hub: invalid/expired JWT is rejected at the gateway (HTTP 401)
+ * and a missing `sub` claim aborts the connection — both silent on the
+ * wire. Register the `Error` listener on ChatHub instead.
+ *
+ * Responsibilities:
+ * - Manages HubConnection lifecycle (connect / disconnect / auto-reconnect)
+ * - Exposes typed event subscription (Server → Client)
+ */
+export class NotificationHubClient {
+    constructor(options) {
+        this.connection = null;
+        /** In-flight connect Promise, used to dedupe concurrent connect() calls. */
+        this.connectingPromise = null;
+        /**
+         * True after a user-initiated disconnect() until the next connect() begins.
+         * ReconnectionManager uses this to skip auto-reconnect when the close was
+         * intentional rather than caused by a transport failure.
+         */
+        this._intentionallyClosed = false;
+        this.options = options;
+        this.emitter = new EventEmitter();
+    }
+    // ---------------------------------------------------------------------------
+    // Connection state
+    // ---------------------------------------------------------------------------
+    get state() {
+        return this.connection?.state ?? HubConnectionState.Disconnected;
+    }
+    /**
+     * True after a user-initiated disconnect() and until the next connect() starts.
+     * ReconnectionManager honors this to avoid reconnecting after an intentional close.
+     */
+    get intentionallyClosed() {
+        return this._intentionallyClosed;
+    }
+    // ---------------------------------------------------------------------------
+    // 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, {
+            // Throw rather than return '' so SignalR fails the request loudly with
+            // a useful error instead of sending an empty `Authorization: Bearer ` header.
+            accessTokenFactory: () => {
+                const t = tokenProvider();
+                if (!t) {
+                    throw new Error('NotificationHub: no authentication token available');
+                }
+                return t;
+            },
+        })
+            .withAutomaticReconnect()
+            .configureLogging(logLevel)
+            .build();
+    }
+    /** Attach SignalR server→client event handlers to the connection */
+    attachHandlers(conn) {
+        // Message notifications
+        conn.on('NewMessageNotification', (dto) => this.emitter.emit('newMessageNotification', dto));
+        conn.on('MentionedNotification', (dto) => this.emitter.emit('mentionedNotification', 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));
+        // Connection lifecycle
+        conn.onreconnecting((err) => this.emitter.emit('reconnecting', err));
+        conn.onreconnected((connectionId) => this.emitter.emit('reconnected', connectionId));
+        conn.onclose((err) => this.emitter.emit('disconnected', err));
+    }
+    /**
+     * Connect to NotificationHub. If already connected, resolves immediately.
+     * Concurrent calls share a single in-flight Promise — building two
+     * connections at once would leak handlers.
+     * Builds a fresh connection using the current token.
+     *
+     * Throws synchronously when no authentication token is available so the
+     * caller gets a clear error rather than a malformed Authorization header.
+     */
+    async connect() {
+        if (this.connection && this.connection.state === HubConnectionState.Connected) {
+            return;
+        }
+        if (this.connectingPromise) {
+            return this.connectingPromise;
+        }
+        if (!this.options.tokenProvider()) {
+            throw new Error('NotificationHubClient.connect(): no authentication token available. ' +
+                'Provide one via ChatClient.setToken() or the tokenProvider option.');
+        }
+        // The user is explicitly opening a connection — clear any prior
+        // intentional-close flag so ReconnectionManager will manage future drops.
+        this._intentionallyClosed = false;
+        const promise = (async () => {
+            try {
+                // Disconnect existing stale connection cleanly
+                if (this.connection) {
+                    await this.safeStop();
+                }
+                const conn = this.buildConnection();
+                this.attachHandlers(conn);
+                this.connection = conn;
+                await conn.start();
+            }
+            finally {
+                this.connectingPromise = null;
+            }
+        })();
+        this.connectingPromise = promise;
+        return promise;
+    }
+    /**
+     * Disconnect from NotificationHub.
+     * If a connect is in flight, it is awaited first so we always tear down a
+     * fully-formed connection (not a half-built one).
+     *
+     * Sets `intentionallyClosed` so ReconnectionManager skips its reconnect
+     * attempt for the resulting `disconnected` event.
+     */
+    async disconnect() {
+        // Mark intentional BEFORE awaiting the in-flight connect so any
+        // disconnected events that fire during teardown are not auto-reconnected.
+        this._intentionallyClosed = true;
+        if (this.connectingPromise) {
+            try {
+                await this.connectingPromise;
+            }
+            catch {
+                // The connect failed — there's nothing established to tear down,
+                // but still proceed to clear local state below.
+            }
+        }
+        await this.safeStop();
+        this.connection = null;
+    }
+    /** Detach all server→client method handlers registered via attachHandlers(). */
+    detachHandlers(conn) {
+        for (const name of NotificationHubClient.HUB_EVENT_NAMES) {
+            conn.off(name);
+        }
+    }
+    async safeStop() {
+        if (!this.connection)
+            return;
+        // Detach handlers first so any late events on this connection are dropped.
+        this.detachHandlers(this.connection);
+        try {
+            await this.connection.stop();
+        }
+        catch {
+            // Ignore errors during stop
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Event subscription (Server → Client)
+    // ---------------------------------------------------------------------------
+    on(event, handler) {
+        return this.emitter.on(event, handler);
+    }
+    off(event, handler) {
+        this.emitter.off(event, handler);
+    }
+}
+/** Server→client method names registered via conn.on() — used for cleanup. */
+NotificationHubClient.HUB_EVENT_NAMES = [
+    'NewMessageNotification',
+    'MentionedNotification',
+    'ConversationCreated',
+    'ConversationUpdated',
+    'ParticipantJoined',
+    'ParticipantLeft',
+    'ConversationPinned',
+    'ConversationUnpinned',
+];
+//# sourceMappingURL=NotificationHubClient.js.map