@cratis/arc 20.54.5 → 20.55.0

package/dist/esm/queries/ServerSentEventHubConnection.js

@@ -4,7 +4,19 @@ import { ReconnectPolicy } from './ReconnectPolicy.js';
 import { QueryResult } from './QueryResult.js';
 import { HubMessageType } from './WebSocketHubConnection.js';
 
-class ServerSentEventHubConnection {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * A multiplexed SSE hub connection that uses EventSource for server→client streaming
+ * and fetch POST requests for client→server subscribe/unsubscribe commands.
+ *
+ * Protocol:
+ * 1. Open EventSource to the SSE hub endpoint.
+ * 2. Server sends a {@link HubMessageType.Connected} message with the connection identifier.
+ * 3. Client sends POST to subscribe/unsubscribe endpoints using the connection identifier.
+ * 4. Server streams {@link HubMessageType.QueryResult} messages tagged with queryId.
+ * 5. When EventSource closes, server cleans up all subscriptions for this connection.
+ */ class ServerSentEventHubConnection {
     _sseUrl;
     _subscribeUrl;
     _unsubscribeUrl;
@@ -20,47 +32,69 @@ class ServerSentEventHubConnection {
     _latencySamples = [];
     _connectTimeoutTimer;
     _keepAlive;
-    constructor(_sseUrl, _subscribeUrl, _unsubscribeUrl, _microservice, keepAliveIntervalMs = 30000, _connectTimeoutMs = 15000, _policy = new ReconnectPolicy()) {
+    /**
+     * Initializes a new instance of {@link ServerSentEventHubConnection}.
+     * @param {string} _sseUrl The SSE hub endpoint URL (e.g. `http://localhost:5000/.cratis/queries/sse`).
+     * @param {string} _subscribeUrl The subscribe POST endpoint URL.
+     * @param {string} _unsubscribeUrl The unsubscribe POST endpoint URL.
+     * @param {string} _microservice The microservice name to pass as a query argument.
+     * @param {number} keepAliveIntervalMs How long without any server message before the connection
+     *   is considered stale and a reconnect is forced (default: 30 000 ms).
+     * @param {number} connectTimeoutMs How long to wait for the {@link HubMessageType.Connected}
+     *   message after the HTTP connection opens before giving up and retrying (default: 15 000 ms).
+     * @param {IReconnectPolicy} _policy The reconnect policy to use (default: {@link ReconnectPolicy}).
+     */ constructor(_sseUrl, _subscribeUrl, _unsubscribeUrl, _microservice, keepAliveIntervalMs = 30000, _connectTimeoutMs = 15000, _policy = new ReconnectPolicy()){
         this._sseUrl = _sseUrl;
         this._subscribeUrl = _subscribeUrl;
         this._unsubscribeUrl = _unsubscribeUrl;
         this._microservice = _microservice;
         this._connectTimeoutMs = _connectTimeoutMs;
         this._policy = _policy;
+        // SSE is server→client only: the client cannot send pings. Instead we watch for
+        // inactivity — if the server stops sending messages (including its own keep-alive
+        // pings) for the entire idle threshold, the connection is stale and we reconnect.
+        //
+        // The idle threshold is set to 1.5× the check interval so the server's keep-alive
+        // ping (which fires on the same cadence) has time to arrive over the network before
+        // the client declares the connection dead. Without this tolerance the client's timer
+        // and the server's timer race — the client often fires first and reconnects
+        // unnecessarily.
         const idleThresholdMs = Math.round(keepAliveIntervalMs * 1.5);
-        this._keepAlive = new HubConnectionKeepAlive(keepAliveIntervalMs, () => {
+        this._keepAlive = new HubConnectionKeepAlive(keepAliveIntervalMs, ()=>{
             if (!this._disconnected && this._subscriptions.size > 0) {
                 console.warn(`SSE hub: no messages received for ${idleThresholdMs}ms, reconnecting '${this._sseUrl}'`);
                 this.reconnect();
             }
         }, idleThresholdMs);
     }
-    get queryCount() {
+    /** @inheritdoc */ get queryCount() {
         return this._subscriptions.size;
     }
-    get isConnected() {
+    /** @inheritdoc */ get isConnected() {
         return this._connectionId !== undefined && this._eventSource?.readyState === EventSource.OPEN;
     }
-    get lastPingLatency() {
+    /** @inheritdoc */ get lastPingLatency() {
         return this._lastPongLatency;
     }
-    get averageLatency() {
-        if (this._latencySamples.length === 0)
-            return 0;
-        return this._latencySamples.reduce((a, b) => a + b, 0) / this._latencySamples.length;
+    /** @inheritdoc */ get averageLatency() {
+        if (this._latencySamples.length === 0) return 0;
+        return this._latencySamples.reduce((a, b)=>a + b, 0) / this._latencySamples.length;
     }
-    subscribe(queryId, request, callback) {
-        const sub = { request, callback };
+    /** @inheritdoc */ subscribe(queryId, request, callback) {
+        const sub = {
+            request,
+            callback
+        };
         this._subscriptions.set(queryId, sub);
         this.ensureConnected();
         if (this._connectionId) {
             this.sendSubscribe(queryId, request);
-        }
-        else {
+        } else {
+            // Not yet connected, queue for when Connected message arrives.
             this._pendingSubscriptions.set(queryId, sub);
         }
     }
-    unsubscribe(queryId) {
+    /** @inheritdoc */ unsubscribe(queryId) {
         this._subscriptions.delete(queryId);
         this._pendingSubscriptions.delete(queryId);
         if (this._connectionId) {
@@ -70,7 +104,7 @@ class ServerSentEventHubConnection {
             this.close();
         }
     }
-    dispose() {
+    /** @inheritdoc */ dispose() {
         this._disconnected = true;
         this._subscriptions.clear();
         this._pendingSubscriptions.clear();
@@ -96,6 +130,10 @@ class ServerSentEventHubConnection {
         this._keepAlive.stop();
         this.clearConnectTimeout();
         if (this._eventSource) {
+            // Detach all handlers BEFORE closing so that the async onerror / onmessage
+            // events that fire after close() cannot observe the new _disconnected=false
+            // state set by an immediately following ensureConnected() call. Without this,
+            // a stale onerror triggers an unintended reconnect with exponential back-off.
             this._eventSource.onopen = null;
             this._eventSource.onmessage = null;
             this._eventSource.onerror = null;
@@ -112,29 +150,28 @@ class ServerSentEventHubConnection {
         }
         this._connectionId = undefined;
         this._eventSource = new EventSource(url);
-        this._eventSource.onopen = () => {
-            if (this._disconnected)
-                return;
+        this._eventSource.onopen = ()=>{
+            if (this._disconnected) return;
             console.log(`SSE hub connection established: '${url}'`);
             this._policy.reset();
             this._keepAlive.start();
+            // If the server does not send a Connected message within the timeout, the
+            // connection is broken. Close and retry via the reconnect policy.
             this.clearConnectTimeout();
-            this._connectTimeoutTimer = setTimeout(() => {
+            this._connectTimeoutTimer = setTimeout(()=>{
                 if (!this._disconnected && !this._connectionId) {
                     console.warn(`SSE hub: no Connected message within ${this._connectTimeoutMs}ms, retrying '${url}'`);
                     this.reconnect();
                 }
             }, this._connectTimeoutMs);
         };
-        this._eventSource.onmessage = (event) => {
-            if (this._disconnected)
-                return;
+        this._eventSource.onmessage = (event)=>{
+            if (this._disconnected) return;
             this._keepAlive.recordActivity();
             this.handleMessage(event.data);
         };
-        this._eventSource.onerror = () => {
-            if (this._disconnected)
-                return;
+        this._eventSource.onerror = ()=>{
+            if (this._disconnected) return;
             console.warn(`SSE hub connection error: '${url}'`);
             this.reconnect();
         };
@@ -142,15 +179,17 @@ class ServerSentEventHubConnection {
     reconnect() {
         this._keepAlive.stop();
         this.clearConnectTimeout();
+        // Close the EventSource so the reconnect policy manages the schedule.
         this._eventSource?.close();
         this._eventSource = undefined;
         this._connectionId = undefined;
-        for (const [queryId, sub] of this._subscriptions) {
+        // Move all active subscriptions to pending so they re-subscribe when
+        // the next Connected message arrives after the managed reconnect.
+        for (const [queryId, sub] of this._subscriptions){
             this._pendingSubscriptions.set(queryId, sub);
         }
-        if (this._subscriptions.size === 0)
-            return;
-        this._policy.schedule(() => {
+        if (this._subscriptions.size === 0) return;
+        this._policy.schedule(()=>{
             if (!this._disconnected && this._subscriptions.size > 0) {
                 this.openEventSource();
             }
@@ -165,7 +204,7 @@ class ServerSentEventHubConnection {
     handleMessage(rawData) {
         try {
             const message = JSON.parse(rawData);
-            switch (message.type) {
+            switch(message.type){
                 case HubMessageType.Connected:
                     this.handleConnected(message);
                     break;
@@ -182,88 +221,95 @@ class ServerSentEventHubConnection {
                     console.error(`SSE hub: query '${message.queryId}' error:`, message.payload);
                     break;
             }
-        }
-        catch (error) {
+        } catch (error) {
             console.error('SSE hub: error parsing message', error);
         }
     }
     handleConnected(message) {
         this._connectionId = message.payload;
         console.log(`SSE hub: connected with id '${this._connectionId}'`);
+        // Connected message arrived — cancel the connect timeout.
         this.clearConnectTimeout();
-        for (const [queryId, sub] of this._pendingSubscriptions) {
+        // Send all pending subscriptions now that we have a connection ID.
+        for (const [queryId, sub] of this._pendingSubscriptions){
             this.sendSubscribe(queryId, sub.request);
         }
         this._pendingSubscriptions.clear();
     }
     handleQueryResult(message) {
-        if (!message.queryId)
-            return;
+        if (!message.queryId) return;
         const sub = this._subscriptions.get(message.queryId);
-        if (!sub)
-            return;
+        if (!sub) return;
         const result = message.payload;
         sub.callback(result);
     }
     handleUnauthorized(message) {
-        if (!message.queryId)
-            return;
+        if (!message.queryId) return;
         const sub = this._subscriptions.get(message.queryId);
-        if (!sub)
-            return;
+        if (!sub) return;
         this._subscriptions.delete(message.queryId);
         this._pendingSubscriptions.delete(message.queryId);
         sub.callback(QueryResult.unauthorized());
     }
     sendSubscribe(queryId, request, attempt = 0) {
-        if (!this._connectionId || this._disconnected)
-            return;
+        if (!this._connectionId || this._disconnected) return;
+        // Capture the connection ID so retries can detect if a reconnect has already fired
+        // for a different reason and made this retry obsolete.
         const connectionId = this._connectionId;
         const body = {
             connectionId,
             queryId,
-            request,
+            request
         };
         const customHeaders = Globals.httpHeadersCallback?.() ?? {};
+        // Maximum number of subscribe retries before falling back to a full SSE reconnect.
+        // In a round-robin load-balanced deployment the subscribe POST may land on a different
+        // backend instance than the one holding the SSE connection.  Retrying gives the load
+        // balancer the chance to route a subsequent attempt to the correct instance without
+        // tearing down the SSE connection unnecessarily.  With N backend instances at most
+        // N-1 retries are needed, so 3 retries covers deployments with up to 4 replicas.
         const maxRetries = 3;
         const retryDelayMs = 200;
         fetch(this._subscribeUrl, {
             method: 'POST',
-            headers: { 'Content-Type': 'application/json', ...customHeaders },
-            body: JSON.stringify(body),
-        }).then(response => {
+            headers: {
+                'Content-Type': 'application/json',
+                ...customHeaders
+            },
+            body: JSON.stringify(body)
+        }).then((response)=>{
             if (!response.ok) {
                 if (attempt < maxRetries && this._connectionId === connectionId && !this._disconnected) {
-                    setTimeout(() => this.sendSubscribe(queryId, request, attempt + 1), retryDelayMs * (attempt + 1));
-                }
-                else if (this._connectionId === connectionId && !this._disconnected) {
+                    setTimeout(()=>this.sendSubscribe(queryId, request, attempt + 1), retryDelayMs * (attempt + 1));
+                } else if (this._connectionId === connectionId && !this._disconnected) {
                     console.warn(`SSE hub: subscribe POST for '${queryId}' returned ${response.status} after ${attempt + 1} attempt(s), reconnecting`);
                     this.reconnect();
                 }
             }
-        }).catch(error => {
+        }).catch((error)=>{
             if (attempt < maxRetries && this._connectionId === connectionId && !this._disconnected) {
-                setTimeout(() => this.sendSubscribe(queryId, request, attempt + 1), retryDelayMs * (attempt + 1));
-            }
-            else if (this._connectionId === connectionId && !this._disconnected) {
+                setTimeout(()=>this.sendSubscribe(queryId, request, attempt + 1), retryDelayMs * (attempt + 1));
+            } else if (this._connectionId === connectionId && !this._disconnected) {
                 console.error(`SSE hub: subscribe POST failed for '${queryId}' after ${attempt + 1} attempt(s), reconnecting`, error);
                 this.reconnect();
             }
         });
     }
     sendUnsubscribe(queryId) {
-        if (!this._connectionId)
-            return;
+        if (!this._connectionId) return;
         const body = {
             connectionId: this._connectionId,
-            queryId,
+            queryId
         };
         const customHeaders = Globals.httpHeadersCallback?.() ?? {};
         fetch(this._unsubscribeUrl, {
             method: 'POST',
-            headers: { 'Content-Type': 'application/json', ...customHeaders },
-            body: JSON.stringify(body),
-        }).catch(error => {
+            headers: {
+                'Content-Type': 'application/json',
+                ...customHeaders
+            },
+            body: JSON.stringify(body)
+        }).catch((error)=>{
             console.error(`SSE hub: unsubscribe POST failed for '${queryId}'`, error);
         });
     }

package/dist/esm/queries/ServerSentEventHubConnection.js.map

@@ -1 +1 @@
-{"version":3,"file":"ServerSentEventHubConnection.js","sources":["../../../queries/ServerSentEventHubConnection.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Globals } from '../Globals';\nimport { IObservableQueryHubConnection } from './IObservableQueryHubConnection';\nimport { DataReceived } from './ObservableQueryConnection';\nimport { HubConnectionKeepAlive } from './HubConnectionKeepAlive';\nimport { IReconnectPolicy } from './IReconnectPolicy';\nimport { ReconnectPolicy } from './ReconnectPolicy';\nimport { QueryResult } from './QueryResult';\nimport { HubMessage, HubMessageType, SubscriptionRequest } from './WebSocketHubConnection';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\ninterface ActiveSubscription {\n    request: SubscriptionRequest;\n    callback: DataReceived<any>;\n}\n\n/**\n * A multiplexed SSE hub connection that uses EventSource for server→client streaming\n * and fetch POST requests for client→server subscribe/unsubscribe commands.\n *\n * Protocol:\n * 1. Open EventSource to the SSE hub endpoint.\n * 2. Server sends a {@link HubMessageType.Connected} message with the connection identifier.\n * 3. Client sends POST to subscribe/unsubscribe endpoints using the connection identifier.\n * 4. Server streams {@link HubMessageType.QueryResult} messages tagged with queryId.\n * 5. When EventSource closes, server cleans up all subscriptions for this connection.\n */\nexport class ServerSentEventHubConnection implements IObservableQueryHubConnection {\n    private _eventSource?: EventSource;\n    private _connectionId?: string;\n    private _disconnected = false;\n    private _subscriptions: Map<string, ActiveSubscription> = new Map();\n    private _pendingSubscriptions: Map<string, ActiveSubscription> = new Map();\n    private _lastPongLatency: number = 0;\n    private _latencySamples: number[] = [];\n    private _connectTimeoutTimer?: ReturnType<typeof setTimeout>;\n    private readonly _keepAlive: HubConnectionKeepAlive;\n\n    /**\n     * Initializes a new instance of {@link ServerSentEventHubConnection}.\n     * @param {string} _sseUrl The SSE hub endpoint URL (e.g. `http://localhost:5000/.cratis/queries/sse`).\n     * @param {string} _subscribeUrl The subscribe POST endpoint URL.\n     * @param {string} _unsubscribeUrl The unsubscribe POST endpoint URL.\n     * @param {string} _microservice The microservice name to pass as a query argument.\n     * @param {number} keepAliveIntervalMs How long without any server message before the connection\n     *   is considered stale and a reconnect is forced (default: 30 000 ms).\n     * @param {number} connectTimeoutMs How long to wait for the {@link HubMessageType.Connected}\n     *   message after the HTTP connection opens before giving up and retrying (default: 15 000 ms).\n     * @param {IReconnectPolicy} _policy The reconnect policy to use (default: {@link ReconnectPolicy}).\n     */\n    constructor(\n        private readonly _sseUrl: string,\n        private readonly _subscribeUrl: string,\n        private readonly _unsubscribeUrl: string,\n        private readonly _microservice: string,\n        keepAliveIntervalMs: number = 30000,\n        private readonly _connectTimeoutMs: number = 15000,\n        private readonly _policy: IReconnectPolicy = new ReconnectPolicy()\n    ) {\n        // SSE is server→client only: the client cannot send pings. Instead we watch for\n        // inactivity — if the server stops sending messages (including its own keep-alive\n        // pings) for the entire idle threshold, the connection is stale and we reconnect.\n        //\n        // The idle threshold is set to 1.5× the check interval so the server's keep-alive\n        // ping (which fires on the same cadence) has time to arrive over the network before\n        // the client declares the connection dead. Without this tolerance the client's timer\n        // and the server's timer race — the client often fires first and reconnects\n        // unnecessarily.\n        const idleThresholdMs = Math.round(keepAliveIntervalMs * 1.5);\n        this._keepAlive = new HubConnectionKeepAlive(keepAliveIntervalMs, () => {\n            if (!this._disconnected && this._subscriptions.size > 0) {\n                console.warn(`SSE hub: no messages received for ${idleThresholdMs}ms, reconnecting '${this._sseUrl}'`);\n                this.reconnect();\n            }\n        }, idleThresholdMs);\n    }\n\n    /** @inheritdoc */\n    get queryCount(): number {\n        return this._subscriptions.size;\n    }\n\n    /** @inheritdoc */\n    get isConnected(): boolean {\n        return this._connectionId !== undefined && this._eventSource?.readyState === EventSource.OPEN;\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return this._lastPongLatency;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        if (this._latencySamples.length === 0) return 0;\n        return this._latencySamples.reduce((a, b) => a + b, 0) / this._latencySamples.length;\n    }\n\n    /** @inheritdoc */\n    subscribe(queryId: string, request: SubscriptionRequest, callback: DataReceived<any>): void {\n        const sub: ActiveSubscription = { request, callback };\n        this._subscriptions.set(queryId, sub);\n\n        this.ensureConnected();\n\n        if (this._connectionId) {\n            this.sendSubscribe(queryId, request);\n        } else {\n            // Not yet connected, queue for when Connected message arrives.\n            this._pendingSubscriptions.set(queryId, sub);\n        }\n    }\n\n    /** @inheritdoc */\n    unsubscribe(queryId: string): void {\n        this._subscriptions.delete(queryId);\n        this._pendingSubscriptions.delete(queryId);\n\n        if (this._connectionId) {\n            this.sendUnsubscribe(queryId);\n        }\n\n        if (this._subscriptions.size === 0) {\n            this.close();\n        }\n    }\n\n    /** @inheritdoc */\n    dispose(): void {\n        this._disconnected = true;\n        this._subscriptions.clear();\n        this._pendingSubscriptions.clear();\n        this._policy.cancel();\n        this._keepAlive.stop();\n        this.clearConnectTimeout();\n        this._eventSource?.close();\n        this._eventSource = undefined;\n        this._connectionId = undefined;\n    }\n\n    private ensureConnected(): void {\n        if (this._disconnected) {\n            this._disconnected = false;\n        }\n\n        if (this._eventSource && this._eventSource.readyState !== EventSource.CLOSED) {\n            return;\n        }\n\n        this.openEventSource();\n    }\n\n    private close(): void {\n        this._disconnected = true;\n        this._policy.cancel();\n        this._keepAlive.stop();\n        this.clearConnectTimeout();\n        if (this._eventSource) {\n            // Detach all handlers BEFORE closing so that the async onerror / onmessage\n            // events that fire after close() cannot observe the new _disconnected=false\n            // state set by an immediately following ensureConnected() call. Without this,\n            // a stale onerror triggers an unintended reconnect with exponential back-off.\n            this._eventSource.onopen = null;\n            this._eventSource.onmessage = null;\n            this._eventSource.onerror = null;\n            this._eventSource.close();\n        }\n        this._eventSource = undefined;\n        this._connectionId = undefined;\n    }\n\n    private openEventSource(): void {\n        let url = this._sseUrl;\n        if (this._microservice?.length > 0) {\n            const param = `${Globals.microserviceWSQueryArgument}=${encodeURIComponent(this._microservice)}`;\n            url += (url.includes('?') ? '&' : '?') + param;\n        }\n\n        this._connectionId = undefined;\n        this._eventSource = new EventSource(url);\n\n        this._eventSource.onopen = () => {\n            if (this._disconnected) return;\n            console.log(`SSE hub connection established: '${url}'`);\n            this._policy.reset();\n            this._keepAlive.start();\n\n            // If the server does not send a Connected message within the timeout, the\n            // connection is broken. Close and retry via the reconnect policy.\n            this.clearConnectTimeout();\n            this._connectTimeoutTimer = setTimeout(() => {\n                if (!this._disconnected && !this._connectionId) {\n                    console.warn(`SSE hub: no Connected message within ${this._connectTimeoutMs}ms, retrying '${url}'`);\n                    this.reconnect();\n                }\n            }, this._connectTimeoutMs);\n        };\n\n        this._eventSource.onmessage = (event: MessageEvent) => {\n            if (this._disconnected) return;\n            this._keepAlive.recordActivity();\n            this.handleMessage(event.data as string);\n        };\n\n        this._eventSource.onerror = () => {\n            if (this._disconnected) return;\n            console.warn(`SSE hub connection error: '${url}'`);\n            this.reconnect();\n        };\n    }\n\n    private reconnect(): void {\n        this._keepAlive.stop();\n        this.clearConnectTimeout();\n\n        // Close the EventSource so the reconnect policy manages the schedule.\n        this._eventSource?.close();\n        this._eventSource = undefined;\n        this._connectionId = undefined;\n\n        // Move all active subscriptions to pending so they re-subscribe when\n        // the next Connected message arrives after the managed reconnect.\n        for (const [queryId, sub] of this._subscriptions) {\n            this._pendingSubscriptions.set(queryId, sub);\n        }\n\n        if (this._subscriptions.size === 0) return;\n\n        this._policy.schedule(() => {\n            if (!this._disconnected && this._subscriptions.size > 0) {\n                this.openEventSource();\n            }\n        }, this._sseUrl);\n    }\n\n    private clearConnectTimeout(): void {\n        if (this._connectTimeoutTimer !== undefined) {\n            clearTimeout(this._connectTimeoutTimer);\n            this._connectTimeoutTimer = undefined;\n        }\n    }\n\n    private handleMessage(rawData: string): void {\n        try {\n            const message = JSON.parse(rawData) as HubMessage;\n\n            switch (message.type) {\n                case HubMessageType.Connected:\n                    this.handleConnected(message);\n                    break;\n                case HubMessageType.QueryResult:\n                    this.handleQueryResult(message);\n                    break;\n                case HubMessageType.Ping:\n                    // Server-sent keep-alive ping — activity already recorded in onmessage.\n                    break;\n                case HubMessageType.Unauthorized:\n                    console.warn(`SSE hub: query '${message.queryId}' unauthorized`);\n                    this.handleUnauthorized(message);\n                    break;\n                case HubMessageType.Error:\n                    console.error(`SSE hub: query '${message.queryId}' error:`, message.payload);\n                    break;\n            }\n        } catch (error) {\n            console.error('SSE hub: error parsing message', error);\n        }\n    }\n\n    private handleConnected(message: HubMessage): void {\n        this._connectionId = message.payload as string;\n        console.log(`SSE hub: connected with id '${this._connectionId}'`);\n\n        // Connected message arrived — cancel the connect timeout.\n        this.clearConnectTimeout();\n\n        // Send all pending subscriptions now that we have a connection ID.\n        for (const [queryId, sub] of this._pendingSubscriptions) {\n            this.sendSubscribe(queryId, sub.request);\n        }\n        this._pendingSubscriptions.clear();\n    }\n\n    private handleQueryResult(message: HubMessage): void {\n        if (!message.queryId) return;\n\n        const sub = this._subscriptions.get(message.queryId);\n        if (!sub) return;\n\n        const result = message.payload as QueryResult<any>;\n        sub.callback(result);\n    }\n\n    private handleUnauthorized(message: HubMessage): void {\n        if (!message.queryId) return;\n\n        const sub = this._subscriptions.get(message.queryId);\n        if (!sub) return;\n\n        this._subscriptions.delete(message.queryId);\n        this._pendingSubscriptions.delete(message.queryId);\n        sub.callback(QueryResult.unauthorized());\n    }\n\n    private sendSubscribe(queryId: string, request: SubscriptionRequest, attempt: number = 0): void {\n        if (!this._connectionId || this._disconnected) return;\n\n        // Capture the connection ID so retries can detect if a reconnect has already fired\n        // for a different reason and made this retry obsolete.\n        const connectionId = this._connectionId;\n\n        const body = {\n            connectionId,\n            queryId,\n            request,\n        };\n\n        const customHeaders = Globals.httpHeadersCallback?.() ?? {};\n\n        // Maximum number of subscribe retries before falling back to a full SSE reconnect.\n        // In a round-robin load-balanced deployment the subscribe POST may land on a different\n        // backend instance than the one holding the SSE connection.  Retrying gives the load\n        // balancer the chance to route a subsequent attempt to the correct instance without\n        // tearing down the SSE connection unnecessarily.  With N backend instances at most\n        // N-1 retries are needed, so 3 retries covers deployments with up to 4 replicas.\n        const maxRetries = 3;\n        const retryDelayMs = 200;\n\n        fetch(this._subscribeUrl, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json', ...customHeaders },\n            body: JSON.stringify(body),\n        }).then(response => {\n            if (!response.ok) {\n                if (attempt < maxRetries && this._connectionId === connectionId && !this._disconnected) {\n                    setTimeout(() => this.sendSubscribe(queryId, request, attempt + 1), retryDelayMs * (attempt + 1));\n                } else if (this._connectionId === connectionId && !this._disconnected) {\n                    console.warn(`SSE hub: subscribe POST for '${queryId}' returned ${response.status} after ${attempt + 1} attempt(s), reconnecting`);\n                    this.reconnect();\n                }\n            }\n        }).catch(error => {\n            if (attempt < maxRetries && this._connectionId === connectionId && !this._disconnected) {\n                setTimeout(() => this.sendSubscribe(queryId, request, attempt + 1), retryDelayMs * (attempt + 1));\n            } else if (this._connectionId === connectionId && !this._disconnected) {\n                console.error(`SSE hub: subscribe POST failed for '${queryId}' after ${attempt + 1} attempt(s), reconnecting`, error);\n                this.reconnect();\n            }\n        });\n    }\n\n    private sendUnsubscribe(queryId: string): void {\n        if (!this._connectionId) return;\n\n        const body = {\n            connectionId: this._connectionId,\n            queryId,\n        };\n\n        const customHeaders = Globals.httpHeadersCallback?.() ?? {};\n\n        fetch(this._unsubscribeUrl, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json', ...customHeaders },\n            body: JSON.stringify(body),\n        }).catch(error => {\n            console.error(`SSE hub: unsubscribe POST failed for '${queryId}'`, error);\n        });\n    }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ServerSentEventHubConnection.js","sources":["../../../queries/ServerSentEventHubConnection.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Globals } from '../Globals';\nimport { IObservableQueryHubConnection } from './IObservableQueryHubConnection';\nimport { DataReceived } from './ObservableQueryConnection';\nimport { HubConnectionKeepAlive } from './HubConnectionKeepAlive';\nimport { IReconnectPolicy } from './IReconnectPolicy';\nimport { ReconnectPolicy } from './ReconnectPolicy';\nimport { QueryResult } from './QueryResult';\nimport { HubMessage, HubMessageType, SubscriptionRequest } from './WebSocketHubConnection';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\ninterface ActiveSubscription {\n    request: SubscriptionRequest;\n    callback: DataReceived<any>;\n}\n\n/**\n * A multiplexed SSE hub connection that uses EventSource for server→client streaming\n * and fetch POST requests for client→server subscribe/unsubscribe commands.\n *\n * Protocol:\n * 1. Open EventSource to the SSE hub endpoint.\n * 2. Server sends a {@link HubMessageType.Connected} message with the connection identifier.\n * 3. Client sends POST to subscribe/unsubscribe endpoints using the connection identifier.\n * 4. Server streams {@link HubMessageType.QueryResult} messages tagged with queryId.\n * 5. When EventSource closes, server cleans up all subscriptions for this connection.\n */\nexport class ServerSentEventHubConnection implements IObservableQueryHubConnection {\n    private _eventSource?: EventSource;\n    private _connectionId?: string;\n    private _disconnected = false;\n    private _subscriptions: Map<string, ActiveSubscription> = new Map();\n    private _pendingSubscriptions: Map<string, ActiveSubscription> = new Map();\n    private _lastPongLatency: number = 0;\n    private _latencySamples: number[] = [];\n    private _connectTimeoutTimer?: ReturnType<typeof setTimeout>;\n    private readonly _keepAlive: HubConnectionKeepAlive;\n\n    /**\n     * Initializes a new instance of {@link ServerSentEventHubConnection}.\n     * @param {string} _sseUrl The SSE hub endpoint URL (e.g. `http://localhost:5000/.cratis/queries/sse`).\n     * @param {string} _subscribeUrl The subscribe POST endpoint URL.\n     * @param {string} _unsubscribeUrl The unsubscribe POST endpoint URL.\n     * @param {string} _microservice The microservice name to pass as a query argument.\n     * @param {number} keepAliveIntervalMs How long without any server message before the connection\n     *   is considered stale and a reconnect is forced (default: 30 000 ms).\n     * @param {number} connectTimeoutMs How long to wait for the {@link HubMessageType.Connected}\n     *   message after the HTTP connection opens before giving up and retrying (default: 15 000 ms).\n     * @param {IReconnectPolicy} _policy The reconnect policy to use (default: {@link ReconnectPolicy}).\n     */\n    constructor(\n        private readonly _sseUrl: string,\n        private readonly _subscribeUrl: string,\n        private readonly _unsubscribeUrl: string,\n        private readonly _microservice: string,\n        keepAliveIntervalMs: number = 30000,\n        private readonly _connectTimeoutMs: number = 15000,\n        private readonly _policy: IReconnectPolicy = new ReconnectPolicy()\n    ) {\n        // SSE is server→client only: the client cannot send pings. Instead we watch for\n        // inactivity — if the server stops sending messages (including its own keep-alive\n        // pings) for the entire idle threshold, the connection is stale and we reconnect.\n        //\n        // The idle threshold is set to 1.5× the check interval so the server's keep-alive\n        // ping (which fires on the same cadence) has time to arrive over the network before\n        // the client declares the connection dead. Without this tolerance the client's timer\n        // and the server's timer race — the client often fires first and reconnects\n        // unnecessarily.\n        const idleThresholdMs = Math.round(keepAliveIntervalMs * 1.5);\n        this._keepAlive = new HubConnectionKeepAlive(keepAliveIntervalMs, () => {\n            if (!this._disconnected && this._subscriptions.size > 0) {\n                console.warn(`SSE hub: no messages received for ${idleThresholdMs}ms, reconnecting '${this._sseUrl}'`);\n                this.reconnect();\n            }\n        }, idleThresholdMs);\n    }\n\n    /** @inheritdoc */\n    get queryCount(): number {\n        return this._subscriptions.size;\n    }\n\n    /** @inheritdoc */\n    get isConnected(): boolean {\n        return this._connectionId !== undefined && this._eventSource?.readyState === EventSource.OPEN;\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return this._lastPongLatency;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        if (this._latencySamples.length === 0) return 0;\n        return this._latencySamples.reduce((a, b) => a + b, 0) / this._latencySamples.length;\n    }\n\n    /** @inheritdoc */\n    subscribe(queryId: string, request: SubscriptionRequest, callback: DataReceived<any>): void {\n        const sub: ActiveSubscription = { request, callback };\n        this._subscriptions.set(queryId, sub);\n\n        this.ensureConnected();\n\n        if (this._connectionId) {\n            this.sendSubscribe(queryId, request);\n        } else {\n            // Not yet connected, queue for when Connected message arrives.\n            this._pendingSubscriptions.set(queryId, sub);\n        }\n    }\n\n    /** @inheritdoc */\n    unsubscribe(queryId: string): void {\n        this._subscriptions.delete(queryId);\n        this._pendingSubscriptions.delete(queryId);\n\n        if (this._connectionId) {\n            this.sendUnsubscribe(queryId);\n        }\n\n        if (this._subscriptions.size === 0) {\n            this.close();\n        }\n    }\n\n    /** @inheritdoc */\n    dispose(): void {\n        this._disconnected = true;\n        this._subscriptions.clear();\n        this._pendingSubscriptions.clear();\n        this._policy.cancel();\n        this._keepAlive.stop();\n        this.clearConnectTimeout();\n        this._eventSource?.close();\n        this._eventSource = undefined;\n        this._connectionId = undefined;\n    }\n\n    private ensureConnected(): void {\n        if (this._disconnected) {\n            this._disconnected = false;\n        }\n\n        if (this._eventSource && this._eventSource.readyState !== EventSource.CLOSED) {\n            return;\n        }\n\n        this.openEventSource();\n    }\n\n    private close(): void {\n        this._disconnected = true;\n        this._policy.cancel();\n        this._keepAlive.stop();\n        this.clearConnectTimeout();\n        if (this._eventSource) {\n            // Detach all handlers BEFORE closing so that the async onerror / onmessage\n            // events that fire after close() cannot observe the new _disconnected=false\n            // state set by an immediately following ensureConnected() call. Without this,\n            // a stale onerror triggers an unintended reconnect with exponential back-off.\n            this._eventSource.onopen = null;\n            this._eventSource.onmessage = null;\n            this._eventSource.onerror = null;\n            this._eventSource.close();\n        }\n        this._eventSource = undefined;\n        this._connectionId = undefined;\n    }\n\n    private openEventSource(): void {\n        let url = this._sseUrl;\n        if (this._microservice?.length > 0) {\n            const param = `${Globals.microserviceWSQueryArgument}=${encodeURIComponent(this._microservice)}`;\n            url += (url.includes('?') ? '&' : '?') + param;\n        }\n\n        this._connectionId = undefined;\n        this._eventSource = new EventSource(url);\n\n        this._eventSource.onopen = () => {\n            if (this._disconnected) return;\n            console.log(`SSE hub connection established: '${url}'`);\n            this._policy.reset();\n            this._keepAlive.start();\n\n            // If the server does not send a Connected message within the timeout, the\n            // connection is broken. Close and retry via the reconnect policy.\n            this.clearConnectTimeout();\n            this._connectTimeoutTimer = setTimeout(() => {\n                if (!this._disconnected && !this._connectionId) {\n                    console.warn(`SSE hub: no Connected message within ${this._connectTimeoutMs}ms, retrying '${url}'`);\n                    this.reconnect();\n                }\n            }, this._connectTimeoutMs);\n        };\n\n        this._eventSource.onmessage = (event: MessageEvent) => {\n            if (this._disconnected) return;\n            this._keepAlive.recordActivity();\n            this.handleMessage(event.data as string);\n        };\n\n        this._eventSource.onerror = () => {\n            if (this._disconnected) return;\n            console.warn(`SSE hub connection error: '${url}'`);\n            this.reconnect();\n        };\n    }\n\n    private reconnect(): void {\n        this._keepAlive.stop();\n        this.clearConnectTimeout();\n\n        // Close the EventSource so the reconnect policy manages the schedule.\n        this._eventSource?.close();\n        this._eventSource = undefined;\n        this._connectionId = undefined;\n\n        // Move all active subscriptions to pending so they re-subscribe when\n        // the next Connected message arrives after the managed reconnect.\n        for (const [queryId, sub] of this._subscriptions) {\n            this._pendingSubscriptions.set(queryId, sub);\n        }\n\n        if (this._subscriptions.size === 0) return;\n\n        this._policy.schedule(() => {\n            if (!this._disconnected && this._subscriptions.size > 0) {\n                this.openEventSource();\n            }\n        }, this._sseUrl);\n    }\n\n    private clearConnectTimeout(): void {\n        if (this._connectTimeoutTimer !== undefined) {\n            clearTimeout(this._connectTimeoutTimer);\n            this._connectTimeoutTimer = undefined;\n        }\n    }\n\n    private handleMessage(rawData: string): void {\n        try {\n            const message = JSON.parse(rawData) as HubMessage;\n\n            switch (message.type) {\n                case HubMessageType.Connected:\n                    this.handleConnected(message);\n                    break;\n                case HubMessageType.QueryResult:\n                    this.handleQueryResult(message);\n                    break;\n                case HubMessageType.Ping:\n                    // Server-sent keep-alive ping — activity already recorded in onmessage.\n                    break;\n                case HubMessageType.Unauthorized:\n                    console.warn(`SSE hub: query '${message.queryId}' unauthorized`);\n                    this.handleUnauthorized(message);\n                    break;\n                case HubMessageType.Error:\n                    console.error(`SSE hub: query '${message.queryId}' error:`, message.payload);\n                    break;\n            }\n        } catch (error) {\n            console.error('SSE hub: error parsing message', error);\n        }\n    }\n\n    private handleConnected(message: HubMessage): void {\n        this._connectionId = message.payload as string;\n        console.log(`SSE hub: connected with id '${this._connectionId}'`);\n\n        // Connected message arrived — cancel the connect timeout.\n        this.clearConnectTimeout();\n\n        // Send all pending subscriptions now that we have a connection ID.\n        for (const [queryId, sub] of this._pendingSubscriptions) {\n            this.sendSubscribe(queryId, sub.request);\n        }\n        this._pendingSubscriptions.clear();\n    }\n\n    private handleQueryResult(message: HubMessage): void {\n        if (!message.queryId) return;\n\n        const sub = this._subscriptions.get(message.queryId);\n        if (!sub) return;\n\n        const result = message.payload as QueryResult<any>;\n        sub.callback(result);\n    }\n\n    private handleUnauthorized(message: HubMessage): void {\n        if (!message.queryId) return;\n\n        const sub = this._subscriptions.get(message.queryId);\n        if (!sub) return;\n\n        this._subscriptions.delete(message.queryId);\n        this._pendingSubscriptions.delete(message.queryId);\n        sub.callback(QueryResult.unauthorized());\n    }\n\n    private sendSubscribe(queryId: string, request: SubscriptionRequest, attempt: number = 0): void {\n        if (!this._connectionId || this._disconnected) return;\n\n        // Capture the connection ID so retries can detect if a reconnect has already fired\n        // for a different reason and made this retry obsolete.\n        const connectionId = this._connectionId;\n\n        const body = {\n            connectionId,\n            queryId,\n            request,\n        };\n\n        const customHeaders = Globals.httpHeadersCallback?.() ?? {};\n\n        // Maximum number of subscribe retries before falling back to a full SSE reconnect.\n        // In a round-robin load-balanced deployment the subscribe POST may land on a different\n        // backend instance than the one holding the SSE connection.  Retrying gives the load\n        // balancer the chance to route a subsequent attempt to the correct instance without\n        // tearing down the SSE connection unnecessarily.  With N backend instances at most\n        // N-1 retries are needed, so 3 retries covers deployments with up to 4 replicas.\n        const maxRetries = 3;\n        const retryDelayMs = 200;\n\n        fetch(this._subscribeUrl, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json', ...customHeaders },\n            body: JSON.stringify(body),\n        }).then(response => {\n            if (!response.ok) {\n                if (attempt < maxRetries && this._connectionId === connectionId && !this._disconnected) {\n                    setTimeout(() => this.sendSubscribe(queryId, request, attempt + 1), retryDelayMs * (attempt + 1));\n                } else if (this._connectionId === connectionId && !this._disconnected) {\n                    console.warn(`SSE hub: subscribe POST for '${queryId}' returned ${response.status} after ${attempt + 1} attempt(s), reconnecting`);\n                    this.reconnect();\n                }\n            }\n        }).catch(error => {\n            if (attempt < maxRetries && this._connectionId === connectionId && !this._disconnected) {\n                setTimeout(() => this.sendSubscribe(queryId, request, attempt + 1), retryDelayMs * (attempt + 1));\n            } else if (this._connectionId === connectionId && !this._disconnected) {\n                console.error(`SSE hub: subscribe POST failed for '${queryId}' after ${attempt + 1} attempt(s), reconnecting`, error);\n                this.reconnect();\n            }\n        });\n    }\n\n    private sendUnsubscribe(queryId: string): void {\n        if (!this._connectionId) return;\n\n        const body = {\n            connectionId: this._connectionId,\n            queryId,\n        };\n\n        const customHeaders = Globals.httpHeadersCallback?.() ?? {};\n\n        fetch(this._unsubscribeUrl, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json', ...customHeaders },\n            body: JSON.stringify(body),\n        }).catch(error => {\n            console.error(`SSE hub: unsubscribe POST failed for '${queryId}'`, error);\n        });\n    }\n}\n"],"names":["ServerSentEventHubConnection","_eventSource","_connectionId","_disconnected","_subscriptions","Map","_pendingSubscriptions","_lastPongLatency","_latencySamples","_connectTimeoutTimer","_keepAlive","_subscribeUrl","_unsubscribeUrl","keepAliveIntervalMs","_connectTimeoutMs","_policy","ReconnectPolicy","_sseUrl","_microservice","idleThresholdMs","Math","round","HubConnectionKeepAlive","size","console","warn","reconnect","queryCount","isConnected","undefined","readyState","EventSource","OPEN","lastPingLatency","averageLatency","length","reduce","a","b","subscribe","queryId","request","callback","sub","set","ensureConnected","sendSubscribe","unsubscribe","delete","sendUnsubscribe","close","dispose","clear","cancel","stop","clearConnectTimeout","CLOSED","openEventSource","onopen","onmessage","onerror","url","param","Globals","microserviceWSQueryArgument","encodeURIComponent","includes","log","reset","start","setTimeout","event","recordActivity","handleMessage","data","schedule","clearTimeout","rawData","message","JSON","parse","type","HubMessageType","Connected","handleConnected","QueryResult","handleQueryResult","Ping","Unauthorized","handleUnauthorized","Error","error","payload","get","result","unauthorized","attempt","connectionId","body","customHeaders","httpHeadersCallback","maxRetries","retryDelayMs","fetch","method","headers","stringify","then","response","ok","status","catch"],"mappings":"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"}

package/dist/esm/queries/ServerSentEventQueryConnection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServerSentEventQueryConnection.d.ts","sourceRoot":"","sources":["../../../queries/ServerSentEventQueryConnection.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAM3D,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAWpD,qBAAa,8BAA8B,CAAC,SAAS,CAAE,YAAW,0BAA0B,CAAC,SAAS,CAAC;IAcvF,OAAO,CAAC,QAAQ,CAAC,IAAI;IAbjC,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,aAAa,CAAS;IAG9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAK;IAGrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAK;gBAMP,IAAI,EAAE,GAAG;IAGtC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAuC7E,UAAU,IAAI,IAAI;CAMrB"}
+{"version":3,"file":"ServerSentEventQueryConnection.d.ts","sourceRoot":"","sources":["../../../queries/ServerSentEventQueryConnection.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAM3D,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAWpD,qBAAa,8BAA8B,CAAC,SAAS,CAAE,YAAW,0BAA0B,CAAC,SAAS,CAAC;IAcvF,OAAO,CAAC,QAAQ,CAAC,IAAI;IAbjC,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,aAAa,CAAS;IAG9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAK;IAGrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAK;IAMpC,YAA6B,IAAI,EAAE,GAAG,EAAI;IAG1C,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAoC5E;IAGD,UAAU,IAAI,IAAI,CAKjB;CACJ"}

package/dist/esm/queries/ServerSentEventQueryConnection.js

@@ -1,51 +1,59 @@
-const SSE_HUB_ROUTE = '/.cratis/queries/sse';
-class ServerSentEventQueryConnection {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The SSE demultiplexer route used when connecting through the multiplexed observable query endpoint.
+ */ const SSE_HUB_ROUTE = '/.cratis/queries/sse';
+/**
+ * Represents a direct Server-Sent Events (SSE) connection for a single observable query.
+ *
+ * In direct mode the URL points to the per-query endpoint (e.g. `/api/queries/latest`).
+ * The backend detects the `Accept: text/event-stream` header and streams results directly.
+ *
+ * The caller (typically {@link createObservableQueryConnection}) decides which URL to use;
+ * this class is transport-agnostic beyond being SSE.
+ */ class ServerSentEventQueryConnection {
     _url;
     _eventSource;
     _disconnected = false;
-    lastPingLatency = 0;
-    averageLatency = 0;
-    constructor(_url) {
+    /** @inheritdoc */ lastPingLatency = 0;
+    /** @inheritdoc */ averageLatency = 0;
+    /**
+     * Initializes a new instance of {@link ServerSentEventQueryConnection}.
+     * @param {URL} url The fully qualified URL of the SSE endpoint (including query parameters).
+     */ constructor(_url){
         this._url = _url;
     }
-    connect(dataReceived, queryArguments) {
-        if (this._disconnected)
-            return;
+    /** @inheritdoc */ connect(dataReceived, queryArguments) {
+        if (this._disconnected) return;
+        // Guard against environments where EventSource is not available (e.g. Node.js, SSR).
         if (typeof EventSource === 'undefined') {
             return;
         }
         let url = this._url.toString();
         if (queryArguments) {
             const separator = url.includes('?') ? '&' : '?';
-            const query = Object.entries(queryArguments)
-                .filter(([, value]) => value !== undefined && value !== null)
-                .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
-                .join('&');
+            const query = Object.entries(queryArguments).filter(([, value])=>value !== undefined && value !== null).map(([key, value])=>`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`).join('&');
             if (query) {
                 url = `${url}${separator}${query}`;
             }
         }
         this._eventSource = new EventSource(url);
-        this._eventSource.onmessage = (event) => {
-            if (this._disconnected)
-                return;
+        this._eventSource.onmessage = (event)=>{
+            if (this._disconnected) return;
             try {
                 const result = JSON.parse(event.data);
                 dataReceived(result);
-            }
-            catch (error) {
+            } catch (error) {
                 console.error('SSE: error parsing message', error);
             }
         };
-        this._eventSource.onerror = () => {
-            if (this._disconnected)
-                return;
+        this._eventSource.onerror = ()=>{
+            if (this._disconnected) return;
             console.warn(`SSE: connection error for '${url}', EventSource will retry automatically.`);
         };
     }
-    disconnect() {
-        if (this._disconnected)
-            return;
+    /** @inheritdoc */ disconnect() {
+        if (this._disconnected) return;
         this._disconnected = true;
         this._eventSource?.close();
         this._eventSource = undefined;

package/dist/esm/queries/ServerSentEventQueryConnection.js.map

@@ -1 +1 @@
-{"version":3,"file":"ServerSentEventQueryConnection.js","sources":["../../../queries/ServerSentEventQueryConnection.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { DataReceived } from './ObservableQueryConnection';\nimport { QueryResult } from './QueryResult';\n\n/**\n * The SSE demultiplexer route used when connecting through the multiplexed observable query endpoint.\n */\nexport const SSE_HUB_ROUTE = '/.cratis/queries/sse';\n\n/**\n * Represents a direct Server-Sent Events (SSE) connection for a single observable query.\n *\n * In direct mode the URL points to the per-query endpoint (e.g. `/api/queries/latest`).\n * The backend detects the `Accept: text/event-stream` header and streams results directly.\n *\n * The caller (typically {@link createObservableQueryConnection}) decides which URL to use;\n * this class is transport-agnostic beyond being SSE.\n */\nexport class ServerSentEventQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    private _eventSource?: EventSource;\n    private _disconnected = false;\n\n    /** @inheritdoc */\n    readonly lastPingLatency: number = 0;\n\n    /** @inheritdoc */\n    readonly averageLatency: number = 0;\n\n    /**\n     * Initializes a new instance of {@link ServerSentEventQueryConnection}.\n     * @param {URL} url The fully qualified URL of the SSE endpoint (including query parameters).\n     */\n    constructor(private readonly _url: URL) {}\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>, queryArguments?: object): void {\n        if (this._disconnected) return;\n\n        // Guard against environments where EventSource is not available (e.g. Node.js, SSR).\n        if (typeof EventSource === 'undefined') {\n            return;\n        }\n\n        let url = this._url.toString();\n        if (queryArguments) {\n            const separator = url.includes('?') ? '&' : '?';\n            const query = Object.entries(queryArguments)\n                .filter(([, value]) => value !== undefined && value !== null)\n                .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)\n                .join('&');\n            if (query) {\n                url = `${url}${separator}${query}`;\n            }\n        }\n\n        this._eventSource = new EventSource(url);\n\n        this._eventSource.onmessage = (event: MessageEvent) => {\n            if (this._disconnected) return;\n            try {\n                const result = JSON.parse(event.data as string) as QueryResult<TDataType>;\n                dataReceived(result);\n            } catch (error) {\n                console.error('SSE: error parsing message', error);\n            }\n        };\n\n        this._eventSource.onerror = () => {\n            if (this._disconnected) return;\n            console.warn(`SSE: connection error for '${url}', EventSource will retry automatically.`);\n        };\n    }\n\n    /** @inheritdoc */\n    disconnect(): void {\n        if (this._disconnected) return;\n        this._disconnected = true;\n        this._eventSource?.close();\n        this._eventSource = undefined;\n    }\n}\n"],"names":[],"mappings":"AAUO,MAAM,aAAa,GAAG;MAWhB,8BAA8B,CAAA;AAcV,IAAA,IAAA;AAbrB,IAAA,YAAY;IACZ,aAAa,GAAG,KAAK;IAGpB,eAAe,GAAW,CAAC;IAG3B,cAAc,GAAW,CAAC;AAMnC,IAAA,WAAA,CAA6B,IAAS,EAAA;QAAT,IAAA,CAAA,IAAI,GAAJ,IAAI;IAAQ;IAGzC,OAAO,CAAC,YAAqC,EAAE,cAAuB,EAAA;QAClE,IAAI,IAAI,CAAC,aAAa;YAAE;AAGxB,QAAA,IAAI,OAAO,WAAW,KAAK,WAAW,EAAE;YACpC;QACJ;QAEA,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;QAC9B,IAAI,cAAc,EAAE;AAChB,YAAA,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG;AAC/C,YAAA,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc;AACtC,iBAAA,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;iBAC3D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAA,EAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA,CAAA,EAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA,CAAE;iBACvF,IAAI,CAAC,GAAG,CAAC;YACd,IAAI,KAAK,EAAE;gBACP,GAAG,GAAG,GAAG,GAAG,CAAA,EAAG,SAAS,CAAA,EAAG,KAAK,EAAE;YACtC;QACJ;QAEA,IAAI,CAAC,YAAY,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC;QAExC,IAAI,CAAC,YAAY,CAAC,SAAS,GAAG,CAAC,KAAmB,KAAI;YAClD,IAAI,IAAI,CAAC,aAAa;gBAAE;AACxB,YAAA,IAAI;gBACA,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAc,CAA2B;gBACzE,YAAY,CAAC,MAAM,CAAC;YACxB;YAAE,OAAO,KAAK,EAAE;AACZ,gBAAA,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC;YACtD;AACJ,QAAA,CAAC;AAED,QAAA,IAAI,CAAC,YAAY,CAAC,OAAO,GAAG,MAAK;YAC7B,IAAI,IAAI,CAAC,aAAa;gBAAE;AACxB,YAAA,OAAO,CAAC,IAAI,CAAC,8BAA8B,GAAG,CAAA,wCAAA,CAA0C,CAAC;AAC7F,QAAA,CAAC;IACL;IAGA,UAAU,GAAA;QACN,IAAI,IAAI,CAAC,aAAa;YAAE;AACxB,QAAA,IAAI,CAAC,aAAa,GAAG,IAAI;AACzB,QAAA,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE;AAC1B,QAAA,IAAI,CAAC,YAAY,GAAG,SAAS;IACjC;AACH;;;;"}
+{"version":3,"file":"ServerSentEventQueryConnection.js","sources":["../../../queries/ServerSentEventQueryConnection.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { DataReceived } from './ObservableQueryConnection';\nimport { QueryResult } from './QueryResult';\n\n/**\n * The SSE demultiplexer route used when connecting through the multiplexed observable query endpoint.\n */\nexport const SSE_HUB_ROUTE = '/.cratis/queries/sse';\n\n/**\n * Represents a direct Server-Sent Events (SSE) connection for a single observable query.\n *\n * In direct mode the URL points to the per-query endpoint (e.g. `/api/queries/latest`).\n * The backend detects the `Accept: text/event-stream` header and streams results directly.\n *\n * The caller (typically {@link createObservableQueryConnection}) decides which URL to use;\n * this class is transport-agnostic beyond being SSE.\n */\nexport class ServerSentEventQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    private _eventSource?: EventSource;\n    private _disconnected = false;\n\n    /** @inheritdoc */\n    readonly lastPingLatency: number = 0;\n\n    /** @inheritdoc */\n    readonly averageLatency: number = 0;\n\n    /**\n     * Initializes a new instance of {@link ServerSentEventQueryConnection}.\n     * @param {URL} url The fully qualified URL of the SSE endpoint (including query parameters).\n     */\n    constructor(private readonly _url: URL) {}\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>, queryArguments?: object): void {\n        if (this._disconnected) return;\n\n        // Guard against environments where EventSource is not available (e.g. Node.js, SSR).\n        if (typeof EventSource === 'undefined') {\n            return;\n        }\n\n        let url = this._url.toString();\n        if (queryArguments) {\n            const separator = url.includes('?') ? '&' : '?';\n            const query = Object.entries(queryArguments)\n                .filter(([, value]) => value !== undefined && value !== null)\n                .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)\n                .join('&');\n            if (query) {\n                url = `${url}${separator}${query}`;\n            }\n        }\n\n        this._eventSource = new EventSource(url);\n\n        this._eventSource.onmessage = (event: MessageEvent) => {\n            if (this._disconnected) return;\n            try {\n                const result = JSON.parse(event.data as string) as QueryResult<TDataType>;\n                dataReceived(result);\n            } catch (error) {\n                console.error('SSE: error parsing message', error);\n            }\n        };\n\n        this._eventSource.onerror = () => {\n            if (this._disconnected) return;\n            console.warn(`SSE: connection error for '${url}', EventSource will retry automatically.`);\n        };\n    }\n\n    /** @inheritdoc */\n    disconnect(): void {\n        if (this._disconnected) return;\n        this._disconnected = true;\n        this._eventSource?.close();\n        this._eventSource = undefined;\n    }\n}\n"],"names":["SSE_HUB_ROUTE","ServerSentEventQueryConnection","_eventSource","_disconnected","lastPingLatency","averageLatency","_url","connect","dataReceived","queryArguments","EventSource","url","toString","separator","includes","query","Object","entries","filter","value","undefined","map","key","encodeURIComponent","String","join","onmessage","event","result","JSON","parse","data","error","console","onerror","warn","disconnect","close"],"mappings":"AAAA;AACA;AAMA;;IAGO,MAAMA,aAAAA,GAAgB;AAE7B;;;;;;;;AAQC,IACM,MAAMC,8BAAAA,CAAAA;;IACDC,YAAAA;AACAC,IAAAA,aAAAA,GAAgB,KAAA;uBAGxB,eAASC,GAA0B,CAAA;uBAGnC,cAASC,GAAyB,CAAA;AAElC;;;QAIA,WAAA,CAAY,IAA0B,CAAE;aAAXC,IAAAA,GAAAA,IAAAA;AAAY,IAAA;AAEzC,uBACAC,OAAAA,CAAQC,YAAqC,EAAEC,cAAuB,EAAQ;QAC1E,IAAI,IAAI,CAACN,aAAa,EAAE;;QAGxB,IAAI,OAAOO,gBAAgB,WAAA,EAAa;AACpC,YAAA;AACJ,QAAA;AAEA,QAAA,IAAIC,GAAAA,GAAM,IAAI,CAACL,IAAI,CAACM,QAAQ,EAAA;AAC5B,QAAA,IAAIH,cAAAA,EAAgB;AAChB,YAAA,MAAMI,SAAAA,GAAYF,GAAAA,CAAIG,QAAQ,CAAC,OAAO,GAAA,GAAM,GAAA;AAC5C,YAAA,MAAMC,KAAAA,GAAQC,MAAAA,CAAOC,OAAO,CAACR,gBACxBS,MAAM,CAAC,CAAC,GAAGC,KAAAA,CAAM,GAAKA,KAAAA,KAAUC,SAAAA,IAAaD,UAAU,IAAA,CAAA,CACvDE,GAAG,CAAC,CAAC,CAACC,GAAAA,EAAKH,KAAAA,CAAM,GAAK,GAAGI,kBAAAA,CAAmBD,GAAAA,CAAAA,CAAK,CAAC,EAAEC,kBAAAA,CAAmBC,MAAAA,CAAOL,KAAAA,CAAAA,CAAAA,CAAAA,CAAS,CAAA,CACvFM,IAAI,CAAC,GAAA,CAAA;AACV,YAAA,IAAIV,KAAAA,EAAO;gBACPJ,GAAAA,GAAM,CAAA,EAAGA,GAAAA,CAAAA,EAAME,SAAAA,CAAAA,EAAYE,KAAAA,CAAAA,CAAO;AACtC,YAAA;AACJ,QAAA;AAEA,QAAA,IAAI,CAACb,YAAY,GAAG,IAAIQ,WAAAA,CAAYC,GAAAA,CAAAA;AAEpC,QAAA,IAAI,CAACT,YAAY,CAACwB,SAAS,GAAG,CAACC,KAAAA,GAAAA;YAC3B,IAAI,IAAI,CAACxB,aAAa,EAAE;YACxB,IAAI;AACA,gBAAA,MAAMyB,MAAAA,GAASC,IAAAA,CAAKC,KAAK,CAACH,MAAMI,IAAI,CAAA;gBACpCvB,YAAAA,CAAaoB,MAAAA,CAAAA;AACjB,YAAA,CAAA,CAAE,OAAOI,KAAAA,EAAO;gBACZC,OAAAA,CAAQD,KAAK,CAAC,4BAAA,EAA8BA,KAAAA,CAAAA;AAChD,YAAA;AACJ,QAAA,CAAA;AAEA,QAAA,IAAI,CAAC9B,YAAY,CAACgC,OAAO,GAAG,IAAA;YACxB,IAAI,IAAI,CAAC/B,aAAa,EAAE;AACxB8B,YAAAA,OAAAA,CAAQE,IAAI,CAAC,CAAC,2BAA2B,EAAExB,GAAAA,CAAI,wCAAwC,CAAC,CAAA;AAC5F,QAAA,CAAA;AACJ,IAAA;AAEA,uBACAyB,UAAAA,GAAmB;QACf,IAAI,IAAI,CAACjC,aAAa,EAAE;QACxB,IAAI,CAACA,aAAa,GAAG,IAAA;QACrB,IAAI,CAACD,YAAY,EAAEmC,KAAAA,EAAAA;QACnB,IAAI,CAACnC,YAAY,GAAGkB,SAAAA;AACxB,IAAA;AACJ;;;;"}

package/dist/esm/queries/SortDirection.js

@@ -1,9 +1,19 @@
-var SortDirection;
-(function (SortDirection) {
-    SortDirection[SortDirection["unspecified"] = 0] = "unspecified";
-    SortDirection[SortDirection["ascending"] = 1] = "ascending";
-    SortDirection[SortDirection["descending"] = 2] = "descending";
-})(SortDirection || (SortDirection = {}));
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Defines the direction of sorting.
+ */ var SortDirection = /*#__PURE__*/ function(SortDirection) {
+    /**
+     * Unspecified sort direction.
+     */ SortDirection[SortDirection["unspecified"] = 0] = "unspecified";
+    /**
+     * Sort in ascending order.
+     */ SortDirection[SortDirection["ascending"] = 1] = "ascending";
+    /**
+     * Sort in descending order.
+     */ SortDirection[SortDirection["descending"] = 2] = "descending";
+    return SortDirection;
+}({});
 
 export { SortDirection };
 //# sourceMappingURL=SortDirection.js.map

package/dist/esm/queries/SortDirection.js.map

@@ -1 +1 @@
-{"version":3,"file":"SortDirection.js","sources":["../../../queries/SortDirection.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/**\n * Defines the direction of sorting.\n */\nexport enum SortDirection {\n    /**\n     * Unspecified sort direction.\n     */\n    unspecified = 0,\n\n    /**\n     * Sort in ascending order.\n     */\n    ascending = 1,\n\n    /**\n     * Sort in descending order.\n     */\n    descending = 2,\n}"],"names":[],"mappings":"IAMY;AAAZ,CAAA,UAAY,aAAa,EAAA;AAIrB,IAAA,aAAA,CAAA,aAAA,CAAA,aAAA,CAAA,GAAA,CAAA,CAAA,GAAA,aAAe;AAKf,IAAA,aAAA,CAAA,aAAA,CAAA,WAAA,CAAA,GAAA,CAAA,CAAA,GAAA,WAAa;AAKb,IAAA,aAAA,CAAA,aAAA,CAAA,YAAA,CAAA,GAAA,CAAA,CAAA,GAAA,YAAc;AAClB,CAAC,EAfW,aAAa,KAAb,aAAa,GAAA,EAAA,CAAA,CAAA;;;;"}
+{"version":3,"file":"SortDirection.js","sources":["../../../queries/SortDirection.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/**\n * Defines the direction of sorting.\n */\nexport enum SortDirection {\n    /**\n     * Unspecified sort direction.\n     */\n    unspecified = 0,\n\n    /**\n     * Sort in ascending order.\n     */\n    ascending = 1,\n\n    /**\n     * Sort in descending order.\n     */\n    descending = 2,\n}"],"names":["SortDirection"],"mappings":"AAAA;AACA;AAEA;;IAGO,IAAKA,aAAAA,iBAAAA,SAAAA,aAAAA,EAAAA;AACR;;AAEC,QAAA,aAAA,CAAA,aAAA,CAAA,aAAA,CAAA,GAAA,CAAA,CAAA,GAAA,aAAA;AAGD;;AAEC,QAAA,aAAA,CAAA,aAAA,CAAA,WAAA,CAAA,GAAA,CAAA,CAAA,GAAA,WAAA;AAGD;;AAEC,QAAA,aAAA,CAAA,aAAA,CAAA,YAAA,CAAA,GAAA,CAAA,CAAA,GAAA,YAAA;AAbOA,IAAAA,OAAAA,aAAAA;AAeX,CAAA,CAAA,EAAA;;;;"}

package/dist/esm/queries/Sorting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sorting.d.ts","sourceRoot":"","sources":["../../../queries/Sorting.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKhD,qBAAa,OAAO;IAYJ,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,SAAS,EAAE,aAAa;IAPrE,MAAM,CAAC,IAAI,EAAE,OAAO,CAA4C;gBAO3C,KAAK,EAAE,MAAM,EAAW,SAAS,EAAE,aAAa;IAMrE,IAAI,UAAU,IAAI,OAAO,CAExB;CACJ"}
+{"version":3,"file":"Sorting.d.ts","sourceRoot":"","sources":["../../../queries/Sorting.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKhD,qBAAa,OAAO;IAYJ,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,SAAS,EAAE,aAAa;IAPrE,MAAM,CAAC,IAAI,EAAE,OAAO,CAA4C;IAOhE,YAAqB,KAAK,EAAE,MAAM,EAAW,SAAS,EAAE,aAAa,EACpE;IAKD,IAAI,UAAU,IAAI,OAAO,CAExB;CACJ"}