@cratis/arc 20.60.0 → 20.60.2

package/dist/cjs/queries/ServerSentEventHubConnection.js

@@ -8,6 +8,13 @@ var WebSocketHubConnection = require('./WebSocketHubConnection.js');
 
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * How many keep-alive intervals of silence are tolerated before the connection is considered dead.
+ *
+ * The server guarantees a message every interval, so this is pure slack for latency and jitter.
+ * It must stay above 1 — a threshold at or below the server's own cadence makes the client and
+ * server timers race, and the client tears down connections the server considers healthy.
+ */ const IDLE_THRESHOLD_FACTOR = 2;
 /**
  * A multiplexed SSE hub connection that uses EventSource for server→client streaming
  * and fetch POST requests for client→server subscribe/unsubscribe commands.
@@ -40,8 +47,9 @@ var WebSocketHubConnection = require('./WebSocketHubConnection.js');
      * @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} keepAliveIntervalMs The keep-alive cadence to assume until the server advertises
+     *   its own on the {@link HubMessageType.Connected} message (default: 30 000 ms). The connection is
+     *   considered stale after {@link IDLE_THRESHOLD_FACTOR} times this without any server message.
      * @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}).
@@ -56,18 +64,20 @@ var WebSocketHubConnection = require('./WebSocketHubConnection.js');
         // 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);
+        // The server guarantees a message at least every keep-alive interval, so the threshold
+        // only has to absorb network latency, timer jitter and server-side scheduling hiccups.
+        // A hard TCP drop surfaces immediately through `onerror`, so this watchdog only needs to
+        // catch silent black-holes — that makes a generous tolerance strictly better than a tight
+        // one, which would tear down healthy connections.
+        //
+        // The interval below is only the starting assumption; the server advertises its real
+        // cadence on the Connected message and {@link handleConnected} reconfigures from it.
         this._keepAlive = new HubConnectionKeepAlive.HubConnectionKeepAlive(keepAliveIntervalMs, ()=>{
             if (!this._disconnected && this._subscriptions.size > 0) {
-                console.warn(`SSE hub: no messages received for ${idleThresholdMs}ms, reconnecting '${this._sseUrl}'`);
+                console.warn(`SSE hub: no messages received for ${this._keepAlive.idleThresholdMs}ms, reconnecting '${this._sseUrl}'`);
                 this.reconnect();
             }
-        }, idleThresholdMs);
+        }, keepAliveIntervalMs * IDLE_THRESHOLD_FACTOR);
     }
     /** @inheritdoc */ get queryCount() {
         return this._subscriptions.size;
@@ -232,12 +242,30 @@ var WebSocketHubConnection = require('./WebSocketHubConnection.js');
         console.log(`SSE hub: connected with id '${this._connectionId}'`);
         // Connected message arrived — cancel the connect timeout.
         this.clearConnectTimeout();
+        this.applyServerKeepAliveInterval(message.keepAliveIntervalMs);
         // 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();
     }
+    /**
+     * Align the idle watchdog with the keep-alive cadence the server actually runs on.
+     *
+     * Without this the client assumes the default interval, so a server configured with a longer
+     * interval — or with keep-alive switched off entirely — would look silent and be reconnected
+     * on a loop even though it is perfectly healthy.
+     * @param {number | undefined} serverIntervalMs The interval advertised by the server, if any.
+     */ applyServerKeepAliveInterval(serverIntervalMs) {
+        if (serverIntervalMs === undefined) return;
+        // Keep-alive disabled server-side: silence is expected, so watching for it would guarantee
+        // an endless reconnect loop. Hard drops still surface through `onerror`.
+        if (serverIntervalMs <= 0) {
+            this._keepAlive.stop();
+            return;
+        }
+        this._keepAlive.reconfigure(serverIntervalMs, serverIntervalMs * IDLE_THRESHOLD_FACTOR);
+    }
     handleQueryResult(message) {
         if (!message.queryId) return;
         const sub = this._subscriptions.get(message.queryId);

package/dist/cjs/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":["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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"}
+{"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 * How many keep-alive intervals of silence are tolerated before the connection is considered dead.\n *\n * The server guarantees a message every interval, so this is pure slack for latency and jitter.\n * It must stay above 1 — a threshold at or below the server's own cadence makes the client and\n * server timers race, and the client tears down connections the server considers healthy.\n */\nconst IDLE_THRESHOLD_FACTOR = 2;\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 The keep-alive cadence to assume until the server advertises\n     *   its own on the {@link HubMessageType.Connected} message (default: 30 000 ms). The connection is\n     *   considered stale after {@link IDLE_THRESHOLD_FACTOR} times this without any server message.\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 server guarantees a message at least every keep-alive interval, so the threshold\n        // only has to absorb network latency, timer jitter and server-side scheduling hiccups.\n        // A hard TCP drop surfaces immediately through `onerror`, so this watchdog only needs to\n        // catch silent black-holes — that makes a generous tolerance strictly better than a tight\n        // one, which would tear down healthy connections.\n        //\n        // The interval below is only the starting assumption; the server advertises its real\n        // cadence on the Connected message and {@link handleConnected} reconfigures from it.\n        this._keepAlive = new HubConnectionKeepAlive(keepAliveIntervalMs, () => {\n            if (!this._disconnected && this._subscriptions.size > 0) {\n                console.warn(`SSE hub: no messages received for ${this._keepAlive.idleThresholdMs}ms, reconnecting '${this._sseUrl}'`);\n                this.reconnect();\n            }\n        }, keepAliveIntervalMs * IDLE_THRESHOLD_FACTOR);\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        this.applyServerKeepAliveInterval(message.keepAliveIntervalMs);\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    /**\n     * Align the idle watchdog with the keep-alive cadence the server actually runs on.\n     *\n     * Without this the client assumes the default interval, so a server configured with a longer\n     * interval — or with keep-alive switched off entirely — would look silent and be reconnected\n     * on a loop even though it is perfectly healthy.\n     * @param {number | undefined} serverIntervalMs The interval advertised by the server, if any.\n     */\n    private applyServerKeepAliveInterval(serverIntervalMs?: number): void {\n        if (serverIntervalMs === undefined) return;\n\n        // Keep-alive disabled server-side: silence is expected, so watching for it would guarantee\n        // an endless reconnect loop. Hard drops still surface through `onerror`.\n        if (serverIntervalMs <= 0) {\n            this._keepAlive.stop();\n            return;\n        }\n\n        this._keepAlive.reconfigure(serverIntervalMs, serverIntervalMs * IDLE_THRESHOLD_FACTOR);\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":["IDLE_THRESHOLD_FACTOR","ServerSentEventHubConnection","_eventSource","_connectionId","_disconnected","_subscriptions","Map","_pendingSubscriptions","_lastPongLatency","_latencySamples","_connectTimeoutTimer","_keepAlive","_subscribeUrl","_unsubscribeUrl","keepAliveIntervalMs","_connectTimeoutMs","_policy","ReconnectPolicy","_sseUrl","_microservice","HubConnectionKeepAlive","size","console","warn","idleThresholdMs","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","applyServerKeepAliveInterval","serverIntervalMs","reconfigure","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/cjs/queries/WebSocketHubConnection.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebSocketHubConnection.js","sources":["../../../queries/WebSocketHubConnection.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 { DataReceived } from './ObservableQueryConnection';\nimport { HubConnectionKeepAlive } from './HubConnectionKeepAlive';\nimport { IReconnectPolicy } from './IReconnectPolicy';\nimport { ReconnectPolicy } from './ReconnectPolicy';\nimport { QueryResult } from './QueryResult';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Message types matching the backend {@link ObservableQueryHubMessageType} enum.\n * Serialized as strings by the JsonStringEnumConverter on the server.\n */\nexport enum HubMessageType {\n    Subscribe = 'Subscribe',\n    Unsubscribe = 'Unsubscribe',\n    QueryResult = 'QueryResult',\n    Unauthorized = 'Unauthorized',\n    Error = 'Error',\n    Ping = 'Ping',\n    Pong = 'Pong',\n    Connected = 'Connected',\n}\n\n/**\n * Wire format for messages exchanged over the {@link WebSocketHubConnection}.\n */\nexport interface HubMessage {\n    type: HubMessageType;\n    queryId?: string;\n    payload?: any;\n    timestamp?: number;\n}\n\n/**\n * Matches the backend {@link ObservableQuerySubscriptionRequest} record.\n */\nexport interface SubscriptionRequest {\n    queryName: string;\n    arguments?: Record<string, string | null>;\n    page?: number;\n    pageSize?: number;\n    sortBy?: string;\n    sortDirection?: string;\n    transferMode?: string;\n}\n\ninterface ActiveSubscription {\n    request: SubscriptionRequest;\n    callback: DataReceived<any>;\n}\n\n/**\n * Represents a single multiplexed WebSocket connection to the observable query hub\n * at {@code /.cratis/queries/ws}.\n *\n * Multiple query subscriptions are carried over the same physical WebSocket. Each subscription\n * is identified by a client-generated {@code queryId}; the server tags every result message with\n * the same id so responses can be routed to the correct callback.\n */\nexport class WebSocketHubConnection {\n    private _socket?: WebSocket;\n    private _disconnected = false;\n    private _subscriptions: Map<string, ActiveSubscription> = new Map();\n    private readonly _keepAlive: HubConnectionKeepAlive;\n    private _lastPingSentTime?: number;\n    private _lastPongLatency: number = 0;\n    private _latencySamples: number[] = [];\n\n    /**\n     * Initializes a new instance of {@link WebSocketHubConnection}.\n     * @param {string} url The WebSocket URL of the hub endpoint (e.g. {@code ws://localhost:5000/.cratis/queries/ws}).\n     * @param {string} microservice The microservice name to pass as a query argument.\n     * @param {number} pingIntervalMs How often to send keep-alive pings when the connection is idle (default: 10 000 ms).\n     * @param {IReconnectPolicy} reconnectPolicy The reconnect policy to use (default: {@link ReconnectPolicy}).\n     */\n    constructor(\n        private readonly _url: string,\n        private readonly _microservice: string,\n        pingIntervalMs: number = 10000,\n        private readonly _policy: IReconnectPolicy = new ReconnectPolicy()\n    ) {\n        this._keepAlive = new HubConnectionKeepAlive(pingIntervalMs, () => {\n            if (this._socket?.readyState === WebSocket.OPEN) {\n                this._lastPingSentTime = Date.now();\n                this.sendMessage({ type: HubMessageType.Ping, timestamp: this._lastPingSentTime });\n            }\n        });\n    }\n\n    /**\n     * Gets the number of active query subscriptions on this connection.\n     */\n    get queryCount(): number {\n        return this._subscriptions.size;\n    }\n\n    /**\n     * Gets whether the WebSocket connection is currently open.\n     */\n    get isConnected(): boolean {\n        return this._socket?.readyState === WebSocket.OPEN;\n    }\n\n    /**\n     * Gets the latency of the last ping/pong sequence in milliseconds.\n     */\n    get lastPingLatency(): number {\n        return this._lastPongLatency;\n    }\n\n    /**\n     * Gets the rolling average latency in milliseconds.\n     */\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    /**\n     * Subscribe to a query on this hub connection.\n     * If the WebSocket is not yet open, the subscribe message will be sent once the connection is established.\n     * @param {string} queryId Client-generated unique identifier for this subscription.\n     * @param {SubscriptionRequest} request The subscription request payload.\n     * @param {DataReceived<any>} callback Callback invoked whenever the server pushes a result for this query.\n     */\n    subscribe(queryId: string, request: SubscriptionRequest, callback: DataReceived<any>): void {\n        this._subscriptions.set(queryId, { request, callback });\n        this.ensureConnected();\n\n        if (this._socket?.readyState === WebSocket.OPEN) {\n            this.sendSubscribeMessage(queryId, request);\n        }\n        // If not yet open, sendAllSubscriptions will fire in onopen.\n    }\n\n    /**\n     * Unsubscribe from a query on this hub connection.\n     * @param {string} queryId The identifier of the subscription to cancel.\n     */\n    unsubscribe(queryId: string): void {\n        this._subscriptions.delete(queryId);\n\n        if (this._socket?.readyState === WebSocket.OPEN) {\n            this.sendMessage({ type: HubMessageType.Unsubscribe, queryId });\n        }\n\n        // If no subscriptions remain, close the connection to free resources.\n        if (this._subscriptions.size === 0) {\n            this.close();\n        }\n    }\n\n    /**\n     * Permanently close this hub connection and clean up all subscriptions.\n     */\n    dispose(): void {\n        this._disconnected = true;\n        this._subscriptions.clear();\n        this._keepAlive.stop();\n        this._policy.cancel();\n        this._socket?.close();\n        this._socket = undefined;\n    }\n\n    private ensureConnected(): void {\n        if (this._disconnected) {\n            // Reset disconnected flag when a new subscription comes in\n            this._disconnected = false;\n        }\n\n        if (this._socket && (this._socket.readyState === WebSocket.OPEN || this._socket.readyState === WebSocket.CONNECTING)) {\n            return;\n        }\n\n        this.openSocket();\n    }\n\n    private close(): void {\n        this._disconnected = true;\n        this._keepAlive.stop();\n        this._policy.cancel();\n        if (this._socket) {\n            // Detach all handlers BEFORE closing so that the async onclose event cannot\n            // fire after a new subscription has reset _disconnected to false and opened a\n            // fresh socket. Without this, the stale onclose triggers an unintended\n            // reconnect via the back-off policy, causing a 1-10 second delay before the\n            // new page's queries receive their first data.\n            this._socket.onopen = null;\n            this._socket.onclose = null;\n            this._socket.onerror = null;\n            this._socket.onmessage = null;\n            this._socket.close();\n        }\n        this._socket = undefined;\n    }\n\n    private openSocket(): void {\n        let url = this._url;\n        if (this._microservice?.length > 0) {\n            const param = `${Globals.microserviceWSQueryArgument}=${encodeURIComponent(this._microservice)}`;\n            url += (url.includes('?') ? '&' : '?') + param;\n        }\n\n        this._socket = new WebSocket(url);\n\n        this._socket.onopen = () => {\n            if (this._disconnected) return;\n            console.log(`Hub connection established: '${url}'`);\n            this._policy.reset();\n            this._keepAlive.start();\n            this.sendAllSubscriptions();\n        };\n\n        this._socket.onclose = () => {\n            if (this._disconnected) return;\n            console.log(`Hub connection closed: '${url}'`);\n            this._keepAlive.stop();\n            if (this._subscriptions.size === 0) return;\n            this._policy.schedule(() => {\n                if (!this._disconnected && this._subscriptions.size > 0) {\n                    this.openSocket();\n                }\n            }, this._url);\n        };\n\n        this._socket.onerror = (error) => {\n            if (this._disconnected) return;\n            console.error(`Hub connection error: '${url}'`, error);\n            this._keepAlive.stop();\n            // onclose will fire after onerror, triggering reconnect\n        };\n\n        this._socket.onmessage = (ev) => {\n            if (this._disconnected) return;\n            this.handleMessage(ev.data as string);\n        };\n    }\n\n    private sendAllSubscriptions(): void {\n        for (const [queryId, sub] of this._subscriptions) {\n            this.sendSubscribeMessage(queryId, sub.request);\n        }\n    }\n\n    private sendSubscribeMessage(queryId: string, request: SubscriptionRequest): void {\n        this.sendMessage({\n            type: HubMessageType.Subscribe,\n            queryId,\n            payload: request,\n        });\n    }\n\n    private sendMessage(message: HubMessage): void {\n        if (this._socket?.readyState === WebSocket.OPEN) {\n            this._socket.send(JSON.stringify(message));\n        }\n    }\n\n    private handleMessage(rawData: string): void {\n        try {\n            const message = JSON.parse(rawData) as HubMessage;\n\n            // Every received message is activity — skip keep-alive ping if data is flowing.\n            this._keepAlive.recordActivity();\n\n            switch (message.type) {\n                case HubMessageType.QueryResult:\n                    this.handleQueryResult(message);\n                    break;\n                case HubMessageType.Pong:\n                    this.handlePong(message);\n                    break;\n                case HubMessageType.Unauthorized:\n                    console.warn(`Hub: query '${message.queryId}' unauthorized`);\n                    this.handleUnauthorized(message);\n                    break;\n                case HubMessageType.Error:\n                    console.error(`Hub: query '${message.queryId}' error:`, message.payload);\n                    break;\n            }\n        } catch (error) {\n            console.error('Hub: error parsing message', error);\n        }\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        sub.callback(QueryResult.unauthorized());\n    }\n\n    private handlePong(message: HubMessage): void {\n        if (message.timestamp && this._lastPingSentTime) {\n            const latency = Date.now() - message.timestamp;\n            this._lastPongLatency = latency;\n            this._latencySamples.push(latency);\n\n            if (this._latencySamples.length > 100) {\n                this._latencySamples.shift();\n            }\n        }\n    }\n}\n"],"names":["HubMessageType","WebSocketHubConnection","_socket","_disconnected","_subscriptions","Map","_keepAlive","_lastPingSentTime","_lastPongLatency","_latencySamples","_url","pingIntervalMs","_policy","ReconnectPolicy","_microservice","HubConnectionKeepAlive","readyState","WebSocket","OPEN","Date","now","sendMessage","type","timestamp","queryCount","size","isConnected","lastPingLatency","averageLatency","length","reduce","a","b","subscribe","queryId","request","callback","set","ensureConnected","sendSubscribeMessage","unsubscribe","delete","close","dispose","clear","stop","cancel","undefined","CONNECTING","openSocket","onopen","onclose","onerror","onmessage","url","param","Globals","microserviceWSQueryArgument","encodeURIComponent","includes","console","log","reset","start","sendAllSubscriptions","schedule","error","ev","handleMessage","data","sub","payload","message","send","JSON","stringify","rawData","parse","recordActivity","handleQueryResult","handlePong","warn","handleUnauthorized","get","result","QueryResult","unauthorized","latency","push","shift"],"mappings":"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"}
+{"version":3,"file":"WebSocketHubConnection.js","sources":["../../../queries/WebSocketHubConnection.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 { DataReceived } from './ObservableQueryConnection';\nimport { HubConnectionKeepAlive } from './HubConnectionKeepAlive';\nimport { IReconnectPolicy } from './IReconnectPolicy';\nimport { ReconnectPolicy } from './ReconnectPolicy';\nimport { QueryResult } from './QueryResult';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Message types matching the backend {@link ObservableQueryHubMessageType} enum.\n * Serialized as strings by the JsonStringEnumConverter on the server.\n */\nexport enum HubMessageType {\n    Subscribe = 'Subscribe',\n    Unsubscribe = 'Unsubscribe',\n    QueryResult = 'QueryResult',\n    Unauthorized = 'Unauthorized',\n    Error = 'Error',\n    Ping = 'Ping',\n    Pong = 'Pong',\n    Connected = 'Connected',\n}\n\n/**\n * Wire format for messages exchanged over the {@link WebSocketHubConnection}.\n */\nexport interface HubMessage {\n    type: HubMessageType;\n    queryId?: string;\n    payload?: any;\n    timestamp?: number;\n\n    /**\n     * The server's keep-alive interval in milliseconds, or 0 when keep-alive is disabled.\n     * Only present on {@link HubMessageType.Connected} messages.\n     */\n    keepAliveIntervalMs?: number;\n}\n\n/**\n * Matches the backend {@link ObservableQuerySubscriptionRequest} record.\n */\nexport interface SubscriptionRequest {\n    queryName: string;\n    arguments?: Record<string, string | null>;\n    page?: number;\n    pageSize?: number;\n    sortBy?: string;\n    sortDirection?: string;\n    transferMode?: string;\n}\n\ninterface ActiveSubscription {\n    request: SubscriptionRequest;\n    callback: DataReceived<any>;\n}\n\n/**\n * Represents a single multiplexed WebSocket connection to the observable query hub\n * at {@code /.cratis/queries/ws}.\n *\n * Multiple query subscriptions are carried over the same physical WebSocket. Each subscription\n * is identified by a client-generated {@code queryId}; the server tags every result message with\n * the same id so responses can be routed to the correct callback.\n */\nexport class WebSocketHubConnection {\n    private _socket?: WebSocket;\n    private _disconnected = false;\n    private _subscriptions: Map<string, ActiveSubscription> = new Map();\n    private readonly _keepAlive: HubConnectionKeepAlive;\n    private _lastPingSentTime?: number;\n    private _lastPongLatency: number = 0;\n    private _latencySamples: number[] = [];\n\n    /**\n     * Initializes a new instance of {@link WebSocketHubConnection}.\n     * @param {string} url The WebSocket URL of the hub endpoint (e.g. {@code ws://localhost:5000/.cratis/queries/ws}).\n     * @param {string} microservice The microservice name to pass as a query argument.\n     * @param {number} pingIntervalMs How often to send keep-alive pings when the connection is idle (default: 10 000 ms).\n     * @param {IReconnectPolicy} reconnectPolicy The reconnect policy to use (default: {@link ReconnectPolicy}).\n     */\n    constructor(\n        private readonly _url: string,\n        private readonly _microservice: string,\n        pingIntervalMs: number = 10000,\n        private readonly _policy: IReconnectPolicy = new ReconnectPolicy()\n    ) {\n        this._keepAlive = new HubConnectionKeepAlive(pingIntervalMs, () => {\n            if (this._socket?.readyState === WebSocket.OPEN) {\n                this._lastPingSentTime = Date.now();\n                this.sendMessage({ type: HubMessageType.Ping, timestamp: this._lastPingSentTime });\n            }\n        });\n    }\n\n    /**\n     * Gets the number of active query subscriptions on this connection.\n     */\n    get queryCount(): number {\n        return this._subscriptions.size;\n    }\n\n    /**\n     * Gets whether the WebSocket connection is currently open.\n     */\n    get isConnected(): boolean {\n        return this._socket?.readyState === WebSocket.OPEN;\n    }\n\n    /**\n     * Gets the latency of the last ping/pong sequence in milliseconds.\n     */\n    get lastPingLatency(): number {\n        return this._lastPongLatency;\n    }\n\n    /**\n     * Gets the rolling average latency in milliseconds.\n     */\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    /**\n     * Subscribe to a query on this hub connection.\n     * If the WebSocket is not yet open, the subscribe message will be sent once the connection is established.\n     * @param {string} queryId Client-generated unique identifier for this subscription.\n     * @param {SubscriptionRequest} request The subscription request payload.\n     * @param {DataReceived<any>} callback Callback invoked whenever the server pushes a result for this query.\n     */\n    subscribe(queryId: string, request: SubscriptionRequest, callback: DataReceived<any>): void {\n        this._subscriptions.set(queryId, { request, callback });\n        this.ensureConnected();\n\n        if (this._socket?.readyState === WebSocket.OPEN) {\n            this.sendSubscribeMessage(queryId, request);\n        }\n        // If not yet open, sendAllSubscriptions will fire in onopen.\n    }\n\n    /**\n     * Unsubscribe from a query on this hub connection.\n     * @param {string} queryId The identifier of the subscription to cancel.\n     */\n    unsubscribe(queryId: string): void {\n        this._subscriptions.delete(queryId);\n\n        if (this._socket?.readyState === WebSocket.OPEN) {\n            this.sendMessage({ type: HubMessageType.Unsubscribe, queryId });\n        }\n\n        // If no subscriptions remain, close the connection to free resources.\n        if (this._subscriptions.size === 0) {\n            this.close();\n        }\n    }\n\n    /**\n     * Permanently close this hub connection and clean up all subscriptions.\n     */\n    dispose(): void {\n        this._disconnected = true;\n        this._subscriptions.clear();\n        this._keepAlive.stop();\n        this._policy.cancel();\n        this._socket?.close();\n        this._socket = undefined;\n    }\n\n    private ensureConnected(): void {\n        if (this._disconnected) {\n            // Reset disconnected flag when a new subscription comes in\n            this._disconnected = false;\n        }\n\n        if (this._socket && (this._socket.readyState === WebSocket.OPEN || this._socket.readyState === WebSocket.CONNECTING)) {\n            return;\n        }\n\n        this.openSocket();\n    }\n\n    private close(): void {\n        this._disconnected = true;\n        this._keepAlive.stop();\n        this._policy.cancel();\n        if (this._socket) {\n            // Detach all handlers BEFORE closing so that the async onclose event cannot\n            // fire after a new subscription has reset _disconnected to false and opened a\n            // fresh socket. Without this, the stale onclose triggers an unintended\n            // reconnect via the back-off policy, causing a 1-10 second delay before the\n            // new page's queries receive their first data.\n            this._socket.onopen = null;\n            this._socket.onclose = null;\n            this._socket.onerror = null;\n            this._socket.onmessage = null;\n            this._socket.close();\n        }\n        this._socket = undefined;\n    }\n\n    private openSocket(): void {\n        let url = this._url;\n        if (this._microservice?.length > 0) {\n            const param = `${Globals.microserviceWSQueryArgument}=${encodeURIComponent(this._microservice)}`;\n            url += (url.includes('?') ? '&' : '?') + param;\n        }\n\n        this._socket = new WebSocket(url);\n\n        this._socket.onopen = () => {\n            if (this._disconnected) return;\n            console.log(`Hub connection established: '${url}'`);\n            this._policy.reset();\n            this._keepAlive.start();\n            this.sendAllSubscriptions();\n        };\n\n        this._socket.onclose = () => {\n            if (this._disconnected) return;\n            console.log(`Hub connection closed: '${url}'`);\n            this._keepAlive.stop();\n            if (this._subscriptions.size === 0) return;\n            this._policy.schedule(() => {\n                if (!this._disconnected && this._subscriptions.size > 0) {\n                    this.openSocket();\n                }\n            }, this._url);\n        };\n\n        this._socket.onerror = (error) => {\n            if (this._disconnected) return;\n            console.error(`Hub connection error: '${url}'`, error);\n            this._keepAlive.stop();\n            // onclose will fire after onerror, triggering reconnect\n        };\n\n        this._socket.onmessage = (ev) => {\n            if (this._disconnected) return;\n            this.handleMessage(ev.data as string);\n        };\n    }\n\n    private sendAllSubscriptions(): void {\n        for (const [queryId, sub] of this._subscriptions) {\n            this.sendSubscribeMessage(queryId, sub.request);\n        }\n    }\n\n    private sendSubscribeMessage(queryId: string, request: SubscriptionRequest): void {\n        this.sendMessage({\n            type: HubMessageType.Subscribe,\n            queryId,\n            payload: request,\n        });\n    }\n\n    private sendMessage(message: HubMessage): void {\n        if (this._socket?.readyState === WebSocket.OPEN) {\n            this._socket.send(JSON.stringify(message));\n        }\n    }\n\n    private handleMessage(rawData: string): void {\n        try {\n            const message = JSON.parse(rawData) as HubMessage;\n\n            // Every received message is activity — skip keep-alive ping if data is flowing.\n            this._keepAlive.recordActivity();\n\n            switch (message.type) {\n                case HubMessageType.QueryResult:\n                    this.handleQueryResult(message);\n                    break;\n                case HubMessageType.Pong:\n                    this.handlePong(message);\n                    break;\n                case HubMessageType.Unauthorized:\n                    console.warn(`Hub: query '${message.queryId}' unauthorized`);\n                    this.handleUnauthorized(message);\n                    break;\n                case HubMessageType.Error:\n                    console.error(`Hub: query '${message.queryId}' error:`, message.payload);\n                    break;\n            }\n        } catch (error) {\n            console.error('Hub: error parsing message', error);\n        }\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        sub.callback(QueryResult.unauthorized());\n    }\n\n    private handlePong(message: HubMessage): void {\n        if (message.timestamp && this._lastPingSentTime) {\n            const latency = Date.now() - message.timestamp;\n            this._lastPongLatency = latency;\n            this._latencySamples.push(latency);\n\n            if (this._latencySamples.length > 100) {\n                this._latencySamples.shift();\n            }\n        }\n    }\n}\n"],"names":["HubMessageType","WebSocketHubConnection","_socket","_disconnected","_subscriptions","Map","_keepAlive","_lastPingSentTime","_lastPongLatency","_latencySamples","_url","pingIntervalMs","_policy","ReconnectPolicy","_microservice","HubConnectionKeepAlive","readyState","WebSocket","OPEN","Date","now","sendMessage","type","timestamp","queryCount","size","isConnected","lastPingLatency","averageLatency","length","reduce","a","b","subscribe","queryId","request","callback","set","ensureConnected","sendSubscribeMessage","unsubscribe","delete","close","dispose","clear","stop","cancel","undefined","CONNECTING","openSocket","onopen","onclose","onerror","onmessage","url","param","Globals","microserviceWSQueryArgument","encodeURIComponent","includes","console","log","reset","start","sendAllSubscriptions","schedule","error","ev","handleMessage","data","sub","payload","message","send","JSON","stringify","rawData","parse","recordActivity","handleQueryResult","handlePong","warn","handleUnauthorized","get","result","QueryResult","unauthorized","latency","push","shift"],"mappings":"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"}

package/dist/cjs/queries/index.js

@@ -26,6 +26,7 @@ var ObservableQuerySubscription = require('./ObservableQuerySubscription.js');
 var WebSocketMessage = require('./WebSocketMessage.js');
 var QueryTransportMethod = require('./QueryTransportMethod.js');
 var QueryInstanceCache = require('./QueryInstanceCache.js');
+var reconcileQueryData = require('./reconcileQueryData.js');
 var IQueryProvider = require('./IQueryProvider.js');
 var QueryProvider = require('./QueryProvider.js');
 var QueryValidator = require('./QueryValidator.js');
@@ -73,6 +74,7 @@ exports.ObservableQuerySubscription = ObservableQuerySubscription.ObservableQuer
 exports.WebSocketMessageType = WebSocketMessage.WebSocketMessageType;
 exports.QueryTransportMethod = QueryTransportMethod.QueryTransportMethod;
 exports.QueryInstanceCache = QueryInstanceCache.QueryInstanceCache;
+exports.reconcileQueryData = reconcileQueryData.reconcileQueryData;
 exports.IQueryProvider = IQueryProvider.IQueryProvider;
 exports.QueryProvider = QueryProvider.QueryProvider;
 exports.QueryValidator = QueryValidator.QueryValidator;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../queries/index.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\nexport * from './ChangeSet';\nexport * from './IChangeStreamFor';\nexport * from './IQuery';\nexport * from './IQueryFor';\nexport * from './Paging';\nexport * from './Sorting';\nexport * from './SortDirection';\nexport * from './SortingActions';\nexport * from './SortingActionsForQuery';\nexport * from './SortingActionsForObservableQuery';\nexport * from './QueryFor';\nexport * from './QueryHttpMethod';\nexport * from './QueryHttpMethodResolver';\nexport * from './QueryHttpRequest';\nexport * from './QueryResult';\nexport * from './QueryResultWithState';\nexport * from './IObservableQueryFor';\nexport * from './ObservableQueryFor';\nexport * from './IObservableQueryConnection';\nexport * from './IObservableQueryHubConnection';\nexport * from './IReconnectPolicy';\nexport * from './ReconnectPolicy';\nexport * from './HubConnectionKeepAlive';\nexport * from './ObservableQueryConnection';\nexport * from './ObservableQueryConnectionFactory';\nexport * from './ObservableQueryConnectionPool';\nexport * from './ServerSentEventQueryConnection';\nexport * from './ServerSentEventHubConnection';\nexport * from './WebSocketHubConnection';\nexport * from './ObservableQueryMultiplexer';\nexport * from './ObservableQuerySubscription';\nexport * from './WebSocketMessage';\nexport * from './QueryTransportMethod';\nexport * from './QueryInstanceCache';\nexport * from './IQueryProvider';\nexport * from './QueryProvider';\nexport * from './QueryValidator';\nexport * from './IObservableQueryDiagnostics';\nexport * from './ObservableQueryDiagnostics';\nexport * from './ObservableQueryDiagnosticsSnapshot';\nimport '../validation';"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":["../../../queries/index.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\nexport * from './ChangeSet';\nexport * from './IChangeStreamFor';\nexport * from './IQuery';\nexport * from './IQueryFor';\nexport * from './Paging';\nexport * from './Sorting';\nexport * from './SortDirection';\nexport * from './SortingActions';\nexport * from './SortingActionsForQuery';\nexport * from './SortingActionsForObservableQuery';\nexport * from './QueryFor';\nexport * from './QueryHttpMethod';\nexport * from './QueryHttpMethodResolver';\nexport * from './QueryHttpRequest';\nexport * from './QueryResult';\nexport * from './QueryResultWithState';\nexport * from './IObservableQueryFor';\nexport * from './ObservableQueryFor';\nexport * from './IObservableQueryConnection';\nexport * from './IObservableQueryHubConnection';\nexport * from './IReconnectPolicy';\nexport * from './ReconnectPolicy';\nexport * from './HubConnectionKeepAlive';\nexport * from './ObservableQueryConnection';\nexport * from './ObservableQueryConnectionFactory';\nexport * from './ObservableQueryConnectionPool';\nexport * from './ServerSentEventQueryConnection';\nexport * from './ServerSentEventHubConnection';\nexport * from './WebSocketHubConnection';\nexport * from './ObservableQueryMultiplexer';\nexport * from './ObservableQuerySubscription';\nexport * from './WebSocketMessage';\nexport * from './QueryTransportMethod';\nexport * from './QueryInstanceCache';\nexport * from './reconcileQueryData';\nexport * from './IQueryProvider';\nexport * from './QueryProvider';\nexport * from './QueryValidator';\nexport * from './IObservableQueryDiagnostics';\nexport * from './ObservableQueryDiagnostics';\nexport * from './ObservableQueryDiagnosticsSnapshot';\nimport '../validation';"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/queries/reconcileQueryData.js

@@ -0,0 +1,84 @@
+'use strict';
+
+var deepEqual = require('../deepEqual.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Resolves the conventional identity of an item so it can be matched against its previous version.
+ *
+ * Uses the `id` property, the same strategy the server-side change-set computation applies, and
+ * reduces concept-style identities (objects with a meaningful `toString()`) to a comparable value.
+ * @param {unknown} item The item to resolve identity for.
+ * @returns {unknown} The identity value, or `undefined` when the item carries no usable identity.
+ */ function getIdentity(item) {
+    const id = item?.id;
+    if (id === null || id === undefined) {
+        return undefined;
+    }
+    if (typeof id === 'object') {
+        const stringValue = id.toString();
+        return stringValue !== '[object Object]' ? stringValue : JSON.stringify(id);
+    }
+    return id;
+}
+/**
+ * Reconciles a full payload against the previous one, carrying over the previous object references
+ * for every item that did not actually change.
+ *
+ * Observable queries re-deliver a complete snapshot whenever a subscription is (re-)established.
+ * Deserializing that snapshot produces entirely new object references, so consumers that compare by
+ * reference — memoized components, effect dependencies — treat every item as changed even when the
+ * payload is identical to what they already display. Reconciling restores referential stability:
+ * unchanged items keep their previous reference, and when nothing changed at all the previous
+ * payload itself is returned so callers can detect "no change" with a single `===`.
+ *
+ * Items are matched by their `id` when present, falling back to position for identity-less items.
+ * @template T The payload type.
+ * @param {T} previous The payload currently held.
+ * @param {T} next The freshly received payload.
+ * @returns {T} `previous` when nothing changed; otherwise the new payload with unchanged items carried over by reference.
+ */ function reconcileQueryData(previous, next) {
+    if (previous === next) {
+        return previous;
+    }
+    if (Array.isArray(previous) && Array.isArray(next)) {
+        return reconcileArray(previous, next);
+    }
+    return deepEqual.deepEqual(previous, next) ? previous : next;
+}
+/**
+ * Reconciles two arrays element by element, preserving previous references for unchanged items.
+ * @param {unknown[]} previous The array currently held.
+ * @param {unknown[]} next The freshly received array.
+ * @returns {unknown[]} `previous` when the arrays are equivalent; otherwise a new array reusing unchanged items.
+ */ function reconcileArray(previous, next) {
+    const previousByIdentity = new Map();
+    for (const item of previous){
+        const identity = getIdentity(item);
+        // Keep the first occurrence — duplicate identities are not a shape we can reconcile
+        // meaningfully, and preferring the first keeps the result deterministic.
+        if (identity !== undefined && !previousByIdentity.has(identity)) {
+            previousByIdentity.set(identity, item);
+        }
+    }
+    let changed = previous.length !== next.length;
+    const reconciled = next.map((item, index)=>{
+        const identity = getIdentity(item);
+        const candidate = identity !== undefined ? previousByIdentity.get(identity) : previous[index];
+        if (candidate !== undefined && deepEqual.deepEqual(candidate, item)) {
+            // An unchanged item that moved still leaves the collection changed as a whole, but the
+            // item itself keeps its reference so only the ordering re-renders, not its content.
+            if (candidate !== previous[index]) {
+                changed = true;
+            }
+            return candidate;
+        }
+        changed = true;
+        return item;
+    });
+    return changed ? reconciled : previous;
+}
+
+exports.reconcileQueryData = reconcileQueryData;
+//# sourceMappingURL=reconcileQueryData.js.map

package/dist/cjs/queries/reconcileQueryData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcileQueryData.js","sources":["../../../queries/reconcileQueryData.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 { deepEqual } from '../deepEqual';\n\n/**\n * Resolves the conventional identity of an item so it can be matched against its previous version.\n *\n * Uses the `id` property, the same strategy the server-side change-set computation applies, and\n * reduces concept-style identities (objects with a meaningful `toString()`) to a comparable value.\n * @param {unknown} item The item to resolve identity for.\n * @returns {unknown} The identity value, or `undefined` when the item carries no usable identity.\n */\nfunction getIdentity(item: unknown): unknown {\n    const id = (item as Record<string, unknown>)?.id;\n\n    if (id === null || id === undefined) {\n        return undefined;\n    }\n\n    if (typeof id === 'object') {\n        const stringValue = id.toString();\n        return stringValue !== '[object Object]' ? stringValue : JSON.stringify(id);\n    }\n\n    return id;\n}\n\n/**\n * Reconciles a full payload against the previous one, carrying over the previous object references\n * for every item that did not actually change.\n *\n * Observable queries re-deliver a complete snapshot whenever a subscription is (re-)established.\n * Deserializing that snapshot produces entirely new object references, so consumers that compare by\n * reference — memoized components, effect dependencies — treat every item as changed even when the\n * payload is identical to what they already display. Reconciling restores referential stability:\n * unchanged items keep their previous reference, and when nothing changed at all the previous\n * payload itself is returned so callers can detect \"no change\" with a single `===`.\n *\n * Items are matched by their `id` when present, falling back to position for identity-less items.\n * @template T The payload type.\n * @param {T} previous The payload currently held.\n * @param {T} next The freshly received payload.\n * @returns {T} `previous` when nothing changed; otherwise the new payload with unchanged items carried over by reference.\n */\nexport function reconcileQueryData<T>(previous: T, next: T): T {\n    if (previous === next) {\n        return previous;\n    }\n\n    if (Array.isArray(previous) && Array.isArray(next)) {\n        return reconcileArray(previous, next) as T;\n    }\n\n    return deepEqual(previous, next) ? previous : next;\n}\n\n/**\n * Reconciles two arrays element by element, preserving previous references for unchanged items.\n * @param {unknown[]} previous The array currently held.\n * @param {unknown[]} next The freshly received array.\n * @returns {unknown[]} `previous` when the arrays are equivalent; otherwise a new array reusing unchanged items.\n */\nfunction reconcileArray(previous: unknown[], next: unknown[]): unknown[] {\n    const previousByIdentity = new Map<unknown, unknown>();\n\n    for (const item of previous) {\n        const identity = getIdentity(item);\n\n        // Keep the first occurrence — duplicate identities are not a shape we can reconcile\n        // meaningfully, and preferring the first keeps the result deterministic.\n        if (identity !== undefined && !previousByIdentity.has(identity)) {\n            previousByIdentity.set(identity, item);\n        }\n    }\n\n    let changed = previous.length !== next.length;\n\n    const reconciled = next.map((item, index) => {\n        const identity = getIdentity(item);\n        const candidate = identity !== undefined ? previousByIdentity.get(identity) : previous[index];\n\n        if (candidate !== undefined && deepEqual(candidate, item)) {\n            // An unchanged item that moved still leaves the collection changed as a whole, but the\n            // item itself keeps its reference so only the ordering re-renders, not its content.\n            if (candidate !== previous[index]) {\n                changed = true;\n            }\n\n            return candidate;\n        }\n\n        changed = true;\n        return item;\n    });\n\n    return changed ? reconciled : previous;\n}\n"],"names":["getIdentity","item","id","undefined","stringValue","toString","JSON","stringify","reconcileQueryData","previous","next","Array","isArray","reconcileArray","deepEqual","previousByIdentity","Map","identity","has","set","changed","length","reconciled","map","index","candidate","get"],"mappings":";;;;AAAA;AACA;AAIA;;;;;;;IAQA,SAASA,YAAYC,IAAa,EAAA;AAC9B,IAAA,MAAMC,KAAMD,IAAAA,EAAkCC,EAAAA;IAE9C,IAAIA,EAAAA,KAAO,IAAA,IAAQA,EAAAA,KAAOC,SAAAA,EAAW;QACjC,OAAOA,SAAAA;AACX,IAAA;IAEA,IAAI,OAAOD,OAAO,QAAA,EAAU;QACxB,MAAME,WAAAA,GAAcF,GAAGG,QAAQ,EAAA;AAC/B,QAAA,OAAOD,WAAAA,KAAgB,iBAAA,GAAoBA,WAAAA,GAAcE,IAAAA,CAAKC,SAAS,CAACL,EAAAA,CAAAA;AAC5E,IAAA;IAEA,OAAOA,EAAAA;AACX;AAEA;;;;;;;;;;;;;;;;AAgBC,IACM,SAASM,kBAAAA,CAAsBC,QAAW,EAAEC,IAAO,EAAA;AACtD,IAAA,IAAID,aAAaC,IAAAA,EAAM;QACnB,OAAOD,QAAAA;AACX,IAAA;AAEA,IAAA,IAAIE,MAAMC,OAAO,CAACH,aAAaE,KAAAA,CAAMC,OAAO,CAACF,IAAAA,CAAAA,EAAO;AAChD,QAAA,OAAOG,eAAeJ,QAAAA,EAAUC,IAAAA,CAAAA;AACpC,IAAA;IAEA,OAAOI,mBAAAA,CAAUL,QAAAA,EAAUC,IAAAA,CAAAA,GAAQD,QAAAA,GAAWC,IAAAA;AAClD;AAEA;;;;;AAKC,IACD,SAASG,cAAAA,CAAeJ,QAAmB,EAAEC,IAAe,EAAA;AACxD,IAAA,MAAMK,qBAAqB,IAAIC,GAAAA,EAAAA;IAE/B,KAAK,MAAMf,QAAQQ,QAAAA,CAAU;AACzB,QAAA,MAAMQ,WAAWjB,WAAAA,CAAYC,IAAAA,CAAAA;;;AAI7B,QAAA,IAAIgB,aAAad,SAAAA,IAAa,CAACY,kBAAAA,CAAmBG,GAAG,CAACD,QAAAA,CAAAA,EAAW;YAC7DF,kBAAAA,CAAmBI,GAAG,CAACF,QAAAA,EAAUhB,IAAAA,CAAAA;AACrC,QAAA;AACJ,IAAA;AAEA,IAAA,IAAImB,OAAAA,GAAUX,QAAAA,CAASY,MAAM,KAAKX,KAAKW,MAAM;AAE7C,IAAA,MAAMC,UAAAA,GAAaZ,IAAAA,CAAKa,GAAG,CAAC,CAACtB,IAAAA,EAAMuB,KAAAA,GAAAA;AAC/B,QAAA,MAAMP,WAAWjB,WAAAA,CAAYC,IAAAA,CAAAA;QAC7B,MAAMwB,SAAAA,GAAYR,aAAad,SAAAA,GAAYY,kBAAAA,CAAmBW,GAAG,CAACT,QAAAA,CAAAA,GAAYR,QAAQ,CAACe,KAAAA,CAAM;AAE7F,QAAA,IAAIC,SAAAA,KAActB,SAAAA,IAAaW,mBAAAA,CAAUW,SAAAA,EAAWxB,IAAAA,CAAAA,EAAO;;;AAGvD,YAAA,IAAIwB,SAAAA,KAAchB,QAAQ,CAACe,KAAAA,CAAM,EAAE;gBAC/BJ,OAAAA,GAAU,IAAA;AACd,YAAA;YAEA,OAAOK,SAAAA;AACX,QAAA;QAEAL,OAAAA,GAAU,IAAA;QACV,OAAOnB,IAAAA;AACX,IAAA,CAAA,CAAA;AAEA,IAAA,OAAOmB,UAAUE,UAAAA,GAAab,QAAAA;AAClC;;;;"}

package/dist/esm/queries/HubConnectionKeepAlive.d.ts

@@ -1,10 +1,12 @@
 export declare class HubConnectionKeepAlive {
-    private readonly _intervalMs;
     private readonly _onIdle;
     private _lastActivityTime;
     private _timer?;
-    private readonly _idleThresholdMs;
-    constructor(_intervalMs: number, _onIdle: () => void, idleThresholdMs?: number);
+    private _intervalMs;
+    private _idleThresholdMs;
+    constructor(intervalMs: number, _onIdle: () => void, idleThresholdMs?: number);
+    get idleThresholdMs(): number;
+    reconfigure(intervalMs: number, idleThresholdMs: number): void;
     start(): void;
     stop(): void;
     recordActivity(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"HubConnectionKeepAlive.d.ts","sourceRoot":"","sources":["../../../queries/HubConnectionKeepAlive.ts"],"names":[],"mappings":"AAqBA,qBAAa,sBAAsB;IAgB3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhB5B,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,MAAM,CAAC,CAAiC;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAY1C,YACqB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,IAAI,EACpC,eAAe,CAAC,EAAE,MAAM,EAG3B;IAKD,KAAK,IAAI,IAAI,CAQZ;IAKD,IAAI,IAAI,IAAI,CAKX;IAMD,cAAc,IAAI,IAAI,CAErB;CACJ"}
+{"version":3,"file":"HubConnectionKeepAlive.d.ts","sourceRoot":"","sources":["../../../queries/HubConnectionKeepAlive.ts"],"names":[],"mappings":"AAqBA,qBAAa,sBAAsB;IAkB3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAjB5B,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,MAAM,CAAC,CAAiC;IAChD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAS;IAYjC,YACI,UAAU,EAAE,MAAM,EACD,OAAO,EAAE,MAAM,IAAI,EACpC,eAAe,CAAC,EAAE,MAAM,EAI3B;IAKD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAUD,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAQ7D;IAKD,KAAK,IAAI,IAAI,CAQZ;IAKD,IAAI,IAAI,IAAI,CAKX;IAMD,cAAc,IAAI,IAAI,CAErB;CACJ"}

package/dist/esm/queries/HubConnectionKeepAlive.js

@@ -18,10 +18,10 @@
  * of this class so the keep-alive logic is written once and behaves identically for both
  * transports.
  */ class HubConnectionKeepAlive {
-    _intervalMs;
     _onIdle;
     _lastActivityTime = Date.now();
     _timer;
+    _intervalMs;
     _idleThresholdMs;
     /**
      * Initializes a new instance of {@link HubConnectionKeepAlive}.
@@ -32,10 +32,30 @@
      *   before the connection is considered idle. Defaults to {@link intervalMs}. Set this
      *   higher than {@link intervalMs} when the peer sends keep-alive messages on a similar
      *   cadence to account for network latency and timer jitter.
-     */ constructor(_intervalMs, _onIdle, idleThresholdMs){
-        this._intervalMs = _intervalMs;
+     */ constructor(intervalMs, _onIdle, idleThresholdMs){
         this._onIdle = _onIdle;
-        this._idleThresholdMs = idleThresholdMs ?? _intervalMs;
+        this._intervalMs = intervalMs;
+        this._idleThresholdMs = idleThresholdMs ?? intervalMs;
+    }
+    /**
+     * Gets how long (in milliseconds) without activity before the connection is considered idle.
+     */ get idleThresholdMs() {
+        return this._idleThresholdMs;
+    }
+    /**
+     * Change the check interval and idle threshold, restarting the timer when it is already running.
+     *
+     * Used when the peer advertises its actual keep-alive cadence after connecting, so the client
+     * stops relying on an assumed default that may not match the server's configuration.
+     * @param {number} intervalMs How often (in milliseconds) to check for idle connections.
+     * @param {number} idleThresholdMs How long (in milliseconds) without activity before the connection is considered idle.
+     */ reconfigure(intervalMs, idleThresholdMs) {
+        const wasRunning = this._timer !== undefined;
+        this._intervalMs = intervalMs;
+        this._idleThresholdMs = idleThresholdMs;
+        if (wasRunning) {
+            this.start();
+        }
     }
     /**
      * Start the keep-alive timer. Safe to call multiple times — a running timer is stopped first.

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

@@ -1 +1 @@
-{"version":3,"file":"HubConnectionKeepAlive.js","sources":["../../../queries/HubConnectionKeepAlive.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 * Manages keep-alive behavior for hub connections (both WebSocket and Server-Sent Events).\n *\n * Records connection activity (any message received or sent). An interval fires every\n * {@link intervalMs} milliseconds; if no activity has been recorded since the last\n * {@link idleThresholdMs} milliseconds the provided {@link onIdle} callback is invoked —\n * the caller decides whether to send a ping, trigger a reconnect, or take some other action.\n *\n * The idle threshold defaults to the check interval but can be set higher to tolerate\n * network latency between the server's keep-alive ping and the client's idle check.\n * For SSE connections, where the idle callback triggers a reconnect, a tolerance of\n * 1.5× the server's keep-alive interval prevents spurious reconnects caused by the\n * client's timer firing just before the server's ping arrives.\n *\n * Both {@link WebSocketHubConnection} and {@link ServerSentEventHubConnection} own one instance\n * of this class so the keep-alive logic is written once and behaves identically for both\n * transports.\n */\nexport class HubConnectionKeepAlive {\n    private _lastActivityTime = Date.now();\n    private _timer?: ReturnType<typeof setInterval>;\n    private readonly _idleThresholdMs: number;\n\n    /**\n     * Initializes a new instance of {@link HubConnectionKeepAlive}.\n     * @param {number} intervalMs How often (in milliseconds) to check for idle connections.\n     * @param {() => void} onIdle Callback invoked when the interval fires and no activity has\n     *   been recorded within the idle threshold.\n     * @param {number} idleThresholdMs Optional. How long (in milliseconds) without activity\n     *   before the connection is considered idle. Defaults to {@link intervalMs}. Set this\n     *   higher than {@link intervalMs} when the peer sends keep-alive messages on a similar\n     *   cadence to account for network latency and timer jitter.\n     */\n    constructor(\n        private readonly _intervalMs: number,\n        private readonly _onIdle: () => void,\n        idleThresholdMs?: number,\n    ) {\n        this._idleThresholdMs = idleThresholdMs ?? _intervalMs;\n    }\n\n    /**\n     * Start the keep-alive timer. Safe to call multiple times — a running timer is stopped first.\n     */\n    start(): void {\n        this.stop();\n        this._lastActivityTime = Date.now();\n        this._timer = setInterval(() => {\n            if (Date.now() - this._lastActivityTime >= this._idleThresholdMs) {\n                this._onIdle();\n            }\n        }, this._intervalMs);\n    }\n\n    /**\n     * Stop the keep-alive timer.\n     */\n    stop(): void {\n        if (this._timer !== undefined) {\n            clearInterval(this._timer);\n            this._timer = undefined;\n        }\n    }\n\n    /**\n     * Record that the connection has been active (message sent or received).\n     * Resets the idle timer so that a keep-alive is not sent while data is already flowing.\n     */\n    recordActivity(): void {\n        this._lastActivityTime = Date.now();\n    }\n}\n"],"names":["HubConnectionKeepAlive","_lastActivityTime","Date","now","_timer","_idleThresholdMs","idleThresholdMs","_intervalMs","_onIdle","start","stop","setInterval","undefined","clearInterval","recordActivity"],"mappings":"AAAA;AACA;AAEA;;;;;;;;;;;;;;;;;AAiBC,IACM,MAAMA,sBAAAA,CAAAA;;;IACDC,iBAAAA,GAAoBC,IAAAA,CAAKC,GAAG,EAAA;IAC5BC,MAAAA;IACSC,gBAAAA;AAEjB;;;;;;;;;QAUA,WAAA,CACI,WAAoC,EACpC,OAAoC,EACpCC,eAAwB,CAC1B;aAHmBC,WAAAA,GAAAA,WAAAA;aACAC,OAAAA,GAAAA,OAAAA;QAGjB,IAAI,CAACH,gBAAgB,GAAGC,eAAAA,IAAmBC,WAAAA;AAC/C,IAAA;AAEA;;AAEC,QACDE,KAAAA,GAAc;AACV,QAAA,IAAI,CAACC,IAAI,EAAA;AACT,QAAA,IAAI,CAACT,iBAAiB,GAAGC,IAAAA,CAAKC,GAAG,EAAA;QACjC,IAAI,CAACC,MAAM,GAAGO,WAAAA,CAAY,IAAA;YACtB,IAAIT,IAAAA,CAAKC,GAAG,EAAA,GAAK,IAAI,CAACF,iBAAiB,IAAI,IAAI,CAACI,gBAAgB,EAAE;AAC9D,gBAAA,IAAI,CAACG,OAAO,EAAA;AAChB,YAAA;QACJ,CAAA,EAAG,IAAI,CAACD,WAAW,CAAA;AACvB,IAAA;AAEA;;AAEC,QACDG,IAAAA,GAAa;AACT,QAAA,IAAI,IAAI,CAACN,MAAM,KAAKQ,SAAAA,EAAW;YAC3BC,aAAAA,CAAc,IAAI,CAACT,MAAM,CAAA;YACzB,IAAI,CAACA,MAAM,GAAGQ,SAAAA;AAClB,QAAA;AACJ,IAAA;AAEA;;;AAGC,QACDE,cAAAA,GAAuB;AACnB,QAAA,IAAI,CAACb,iBAAiB,GAAGC,IAAAA,CAAKC,GAAG,EAAA;AACrC,IAAA;AACJ;;;;"}
+{"version":3,"file":"HubConnectionKeepAlive.js","sources":["../../../queries/HubConnectionKeepAlive.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 * Manages keep-alive behavior for hub connections (both WebSocket and Server-Sent Events).\n *\n * Records connection activity (any message received or sent). An interval fires every\n * {@link intervalMs} milliseconds; if no activity has been recorded since the last\n * {@link idleThresholdMs} milliseconds the provided {@link onIdle} callback is invoked —\n * the caller decides whether to send a ping, trigger a reconnect, or take some other action.\n *\n * The idle threshold defaults to the check interval but can be set higher to tolerate\n * network latency between the server's keep-alive ping and the client's idle check.\n * For SSE connections, where the idle callback triggers a reconnect, a tolerance of\n * 1.5× the server's keep-alive interval prevents spurious reconnects caused by the\n * client's timer firing just before the server's ping arrives.\n *\n * Both {@link WebSocketHubConnection} and {@link ServerSentEventHubConnection} own one instance\n * of this class so the keep-alive logic is written once and behaves identically for both\n * transports.\n */\nexport class HubConnectionKeepAlive {\n    private _lastActivityTime = Date.now();\n    private _timer?: ReturnType<typeof setInterval>;\n    private _intervalMs: number;\n    private _idleThresholdMs: number;\n\n    /**\n     * Initializes a new instance of {@link HubConnectionKeepAlive}.\n     * @param {number} intervalMs How often (in milliseconds) to check for idle connections.\n     * @param {() => void} onIdle Callback invoked when the interval fires and no activity has\n     *   been recorded within the idle threshold.\n     * @param {number} idleThresholdMs Optional. How long (in milliseconds) without activity\n     *   before the connection is considered idle. Defaults to {@link intervalMs}. Set this\n     *   higher than {@link intervalMs} when the peer sends keep-alive messages on a similar\n     *   cadence to account for network latency and timer jitter.\n     */\n    constructor(\n        intervalMs: number,\n        private readonly _onIdle: () => void,\n        idleThresholdMs?: number,\n    ) {\n        this._intervalMs = intervalMs;\n        this._idleThresholdMs = idleThresholdMs ?? intervalMs;\n    }\n\n    /**\n     * Gets how long (in milliseconds) without activity before the connection is considered idle.\n     */\n    get idleThresholdMs(): number {\n        return this._idleThresholdMs;\n    }\n\n    /**\n     * Change the check interval and idle threshold, restarting the timer when it is already running.\n     *\n     * Used when the peer advertises its actual keep-alive cadence after connecting, so the client\n     * stops relying on an assumed default that may not match the server's configuration.\n     * @param {number} intervalMs How often (in milliseconds) to check for idle connections.\n     * @param {number} idleThresholdMs How long (in milliseconds) without activity before the connection is considered idle.\n     */\n    reconfigure(intervalMs: number, idleThresholdMs: number): void {\n        const wasRunning = this._timer !== undefined;\n        this._intervalMs = intervalMs;\n        this._idleThresholdMs = idleThresholdMs;\n\n        if (wasRunning) {\n            this.start();\n        }\n    }\n\n    /**\n     * Start the keep-alive timer. Safe to call multiple times — a running timer is stopped first.\n     */\n    start(): void {\n        this.stop();\n        this._lastActivityTime = Date.now();\n        this._timer = setInterval(() => {\n            if (Date.now() - this._lastActivityTime >= this._idleThresholdMs) {\n                this._onIdle();\n            }\n        }, this._intervalMs);\n    }\n\n    /**\n     * Stop the keep-alive timer.\n     */\n    stop(): void {\n        if (this._timer !== undefined) {\n            clearInterval(this._timer);\n            this._timer = undefined;\n        }\n    }\n\n    /**\n     * Record that the connection has been active (message sent or received).\n     * Resets the idle timer so that a keep-alive is not sent while data is already flowing.\n     */\n    recordActivity(): void {\n        this._lastActivityTime = Date.now();\n    }\n}\n"],"names":["HubConnectionKeepAlive","_lastActivityTime","Date","now","_timer","_intervalMs","_idleThresholdMs","intervalMs","idleThresholdMs","_onIdle","reconfigure","wasRunning","undefined","start","stop","setInterval","clearInterval","recordActivity"],"mappings":"AAAA;AACA;AAEA;;;;;;;;;;;;;;;;;AAiBC,IACM,MAAMA,sBAAAA,CAAAA;;IACDC,iBAAAA,GAAoBC,IAAAA,CAAKC,GAAG,EAAA;IAC5BC,MAAAA;IACAC,WAAAA;IACAC,gBAAAA;AAER;;;;;;;;;AASC,QACD,YACIC,UAAkB,EAClB,OAAoC,EACpCC,eAAwB,CAC1B;aAFmBC,OAAAA,GAAAA,OAAAA;QAGjB,IAAI,CAACJ,WAAW,GAAGE,UAAAA;QACnB,IAAI,CAACD,gBAAgB,GAAGE,eAAAA,IAAmBD,UAAAA;AAC/C,IAAA;AAEA;;AAEC,QACD,IAAIC,eAAAA,GAA0B;QAC1B,OAAO,IAAI,CAACF,gBAAgB;AAChC,IAAA;AAEA;;;;;;;AAOC,QACDI,WAAAA,CAAYH,UAAkB,EAAEC,eAAuB,EAAQ;AAC3D,QAAA,MAAMG,UAAAA,GAAa,IAAI,CAACP,MAAM,KAAKQ,SAAAA;QACnC,IAAI,CAACP,WAAW,GAAGE,UAAAA;QACnB,IAAI,CAACD,gBAAgB,GAAGE,eAAAA;AAExB,QAAA,IAAIG,UAAAA,EAAY;AACZ,YAAA,IAAI,CAACE,KAAK,EAAA;AACd,QAAA;AACJ,IAAA;AAEA;;AAEC,QACDA,KAAAA,GAAc;AACV,QAAA,IAAI,CAACC,IAAI,EAAA;AACT,QAAA,IAAI,CAACb,iBAAiB,GAAGC,IAAAA,CAAKC,GAAG,EAAA;QACjC,IAAI,CAACC,MAAM,GAAGW,WAAAA,CAAY,IAAA;YACtB,IAAIb,IAAAA,CAAKC,GAAG,EAAA,GAAK,IAAI,CAACF,iBAAiB,IAAI,IAAI,CAACK,gBAAgB,EAAE;AAC9D,gBAAA,IAAI,CAACG,OAAO,EAAA;AAChB,YAAA;QACJ,CAAA,EAAG,IAAI,CAACJ,WAAW,CAAA;AACvB,IAAA;AAEA;;AAEC,QACDS,IAAAA,GAAa;AACT,QAAA,IAAI,IAAI,CAACV,MAAM,KAAKQ,SAAAA,EAAW;YAC3BI,aAAAA,CAAc,IAAI,CAACZ,MAAM,CAAA;YACzB,IAAI,CAACA,MAAM,GAAGQ,SAAAA;AAClB,QAAA;AACJ,IAAA;AAEA;;;AAGC,QACDK,cAAAA,GAAuB;AACnB,QAAA,IAAI,CAAChB,iBAAiB,GAAGC,IAAAA,CAAKC,GAAG,EAAA;AACrC,IAAA;AACJ;;;;"}

package/dist/esm/queries/NullObservableQueryConnection.d.ts

@@ -1,8 +1,10 @@
 import { DataReceived } from './ObservableQueryConnection';
 import { IObservableQueryConnection } from './IObservableQueryConnection';
+import { QueryResult } from './QueryResult';
 export declare class NullObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {
     readonly defaultValue: TDataType;
-    constructor(defaultValue: TDataType);
+    readonly result?: QueryResult<TDataType> | undefined;
+    constructor(defaultValue: TDataType, result?: QueryResult<TDataType> | undefined);
     get lastPingLatency(): number;
     get averageLatency(): number;
     connect(dataReceived: DataReceived<TDataType>): void;

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

@@ -1 +1 @@
-{"version":3,"file":"NullObservableQueryConnection.d.ts","sourceRoot":"","sources":["../../../queries/NullObservableQueryConnection.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAO1E,qBAAa,6BAA6B,CAAC,SAAS,CAAE,YAAW,0BAA0B,CAAC,SAAS,CAAC;IAKtF,QAAQ,CAAC,YAAY,EAAE,SAAS;IAA5C,YAAqB,YAAY,EAAE,SAAS,EAC3C;IAGD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAGD,IAAI,cAAc,IAAI,MAAM,CAE3B;IAGD,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,QAE5C;IAID,UAAU,SACT;CACJ"}
+{"version":3,"file":"NullObservableQueryConnection.d.ts","sourceRoot":"","sources":["../../../queries/NullObservableQueryConnection.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,qBAAa,6BAA6B,CAAC,SAAS,CAAE,YAAW,0BAA0B,CAAC,SAAS,CAAC;IAQtF,QAAQ,CAAC,YAAY,EAAE,SAAS;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC;IAAtF,YAAqB,YAAY,EAAE,SAAS,EAAW,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,YAAA,EACrF;IAGD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAGD,IAAI,cAAc,IAAI,MAAM,CAE3B;IAGD,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,QAE5C;IAID,UAAU,SACT;CACJ"}