@cratis/arc 20.54.5 → 20.55.0

package/dist/esm/queries/NullObservableQueryConnection.js

@@ -1,21 +1,27 @@
 import { QueryResult } from './QueryResult.js';
 
-class NullObservableQueryConnection {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.
+ */ class NullObservableQueryConnection {
     defaultValue;
-    constructor(defaultValue) {
+    /**
+     * Initializes a new instance of the {@link NullObservableQueryConnection} class.
+     * @param {TDataType} defaultValue The default value to serve.
+     */ constructor(defaultValue){
         this.defaultValue = defaultValue;
     }
-    get lastPingLatency() {
+    /** @inheritdoc */ get lastPingLatency() {
         return 0;
     }
-    get averageLatency() {
+    /** @inheritdoc */ get averageLatency() {
         return 0;
     }
-    connect(dataReceived) {
+    /** @inheritdoc */ connect(dataReceived) {
         dataReceived(QueryResult.empty(this.defaultValue));
     }
-    disconnect() {
-    }
+    /** @inheritdoc */ /* eslint-disable @typescript-eslint/no-empty-function */ disconnect() {}
 }
 
 export { NullObservableQueryConnection };

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

@@ -1 +1 @@
-{"version":3,"file":"NullObservableQueryConnection.js","sources":["../../../queries/NullObservableQueryConnection.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 { DataReceived } from './ObservableQueryConnection';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { QueryResult } from './QueryResult';\n\n/**\n * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.\n */\n\nexport class NullObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    /**\n     * Initializes a new instance of the {@link NullObservableQueryConnection} class.\n     * @param {TDataType} defaultValue The default value to serve.\n     */\n    constructor(readonly defaultValue: TDataType) {\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>) {\n        dataReceived(QueryResult.empty(this.defaultValue));\n    }\n\n    /** @inheritdoc */\n    /* eslint-disable @typescript-eslint/no-empty-function */\n    disconnect() {\n    }\n}\n"],"names":[],"mappings":";;MAWa,6BAA6B,CAAA;AAKjB,IAAA,YAAA;AAArB,IAAA,WAAA,CAAqB,YAAuB,EAAA;QAAvB,IAAA,CAAA,YAAY,GAAZ,YAAY;IACjC;AAGA,IAAA,IAAI,eAAe,GAAA;AACf,QAAA,OAAO,CAAC;IACZ;AAGA,IAAA,IAAI,cAAc,GAAA;AACd,QAAA,OAAO,CAAC;IACZ;AAGA,IAAA,OAAO,CAAC,YAAqC,EAAA;QACzC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtD;IAIA,UAAU,GAAA;IACV;AACH;;;;"}
+{"version":3,"file":"NullObservableQueryConnection.js","sources":["../../../queries/NullObservableQueryConnection.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 { DataReceived } from './ObservableQueryConnection';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { QueryResult } from './QueryResult';\n\n/**\n * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.\n */\n\nexport class NullObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    /**\n     * Initializes a new instance of the {@link NullObservableQueryConnection} class.\n     * @param {TDataType} defaultValue The default value to serve.\n     */\n    constructor(readonly defaultValue: TDataType) {\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>) {\n        dataReceived(QueryResult.empty(this.defaultValue));\n    }\n\n    /** @inheritdoc */\n    /* eslint-disable @typescript-eslint/no-empty-function */\n    disconnect() {\n    }\n}\n"],"names":["NullObservableQueryConnection","defaultValue","lastPingLatency","averageLatency","connect","dataReceived","QueryResult","empty","disconnect"],"mappings":";;AAAA;AACA;AAMA;;AAEC,IAEM,MAAMA,6BAAAA,CAAAA;;AACT;;;QAIA,WAAA,CAAY,YAAgC,CAAE;aAAzBC,YAAAA,GAAAA,YAAAA;AACrB,IAAA;uBAGA,IAAIC,eAAAA,GAA0B;QAC1B,OAAO,CAAA;AACX,IAAA;uBAGA,IAAIC,cAAAA,GAAyB;QACzB,OAAO,CAAA;AACX,IAAA;uBAGAC,OAAAA,CAAQC,YAAqC,EAAE;AAC3CA,QAAAA,YAAAA,CAAaC,WAAAA,CAAYC,KAAK,CAAC,IAAI,CAACN,YAAY,CAAA,CAAA;AACpD,IAAA;AAEA,iFAEAO,UAAAA,GAAa,CACb;AACJ;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryConnection.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryConnection.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,MAAM,YAAY,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAK7E,qBAAa,yBAAyB,CAAC,SAAS,CAAE,YAAW,0BAA0B,CAAC,SAAS,CAAC;IAmBxE,OAAO,CAAC,QAAQ,CAAC,aAAa;IAA0C,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAjB/H,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,aAAa,CAAC,CAAiC;IACvD,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,oBAAoB,CAAC,CAAS;gBAS1B,GAAG,EAAE,GAAG,EAAmB,aAAa,EAAE,MAAM,EAAE,cAAc,GAAE,MAAc,EAAmB,gBAAgB,GAAE,gBAAwC;IAkBzK,OAAO;IAOP,IAAI,eAAe,IAAI,MAAM,CAE5B;IAKD,IAAI,cAAc,IAAI,MAAM,CAM3B;IAGD,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM;IA+CtE,UAAU;IAaV,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,UAAU;CAYrB"}
+{"version":3,"file":"ObservableQueryConnection.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryConnection.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,MAAM,YAAY,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAK7E,qBAAa,yBAAyB,CAAC,SAAS,CAAE,YAAW,0BAA0B,CAAC,SAAS,CAAC;IAmBxE,OAAO,CAAC,QAAQ,CAAC,aAAa;IAA0C,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAjB/H,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,aAAa,CAAC,CAAiC;IACvD,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,oBAAoB,CAAC,CAAS;IAStC,YAAY,GAAG,EAAE,GAAG,EAAmB,aAAa,EAAE,MAAM,EAAE,cAAc,GAAE,MAAc,EAAmB,gBAAgB,GAAE,gBAAwC,EAaxK;IAKD,OAAO,SAEN;IAKD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAKD,IAAI,cAAc,IAAI,MAAM,CAM3B;IAGD,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,QA4CrE;IAGD,UAAU,SAWT;IAED,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,UAAU;CAYrB"}

package/dist/esm/queries/ObservableQueryConnection.js

@@ -2,7 +2,11 @@ import { Globals } from '../Globals.js';
 import { ReconnectPolicy } from './ReconnectPolicy.js';
 import { WebSocketMessageType } from './WebSocketMessage.js';
 
-class ObservableQueryConnection {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents the connection for an observable query.
+ */ class ObservableQueryConnection {
     _microservice;
     _reconnectPolicy;
     _socket;
@@ -14,7 +18,13 @@ class ObservableQueryConnection {
     _lastPongLatency = 0;
     _latencySamples = [];
     _connectionStartTime;
-    constructor(url, _microservice, pingIntervalMs = 10000, _reconnectPolicy = new ReconnectPolicy()) {
+    /**
+     * Initializes a new instance of the {@link ObservableQueryConnection<TDataType>} class.
+     * @param {Url} url The fully qualified Url.
+     * @param {string} _microservice The microservice name.
+     * @param {number} pingIntervalMs The ping interval in milliseconds (default: 10000).
+     * @param {IReconnectPolicy} reconnectPolicy The reconnect policy to use (default: {@link ReconnectPolicy}).
+     */ constructor(url, _microservice, pingIntervalMs = 10000, _reconnectPolicy = new ReconnectPolicy()){
         this._microservice = _microservice;
         this._reconnectPolicy = _reconnectPolicy;
         this._pingIntervalMs = pingIntervalMs;
@@ -24,62 +34,63 @@ class ObservableQueryConnection {
             const microserviceParam = `${Globals.microserviceWSQueryArgument}=${this._microservice}`;
             if (this._url.indexOf('?') > 0) {
                 this._url = `${this._url}&${microserviceParam}`;
-            }
-            else {
+            } else {
                 this._url = `${this._url}?${microserviceParam}`;
             }
         }
     }
-    dispose() {
+    /**
+     * Disposes the connection.
+     */ dispose() {
         this.disconnect();
     }
-    get lastPingLatency() {
+    /**
+     * Gets the latency of the last ping/pong sequence in milliseconds.
+     */ get lastPingLatency() {
         return this._lastPongLatency;
     }
-    get averageLatency() {
+    /**
+     * Gets the average latency since the connection started in milliseconds.
+     */ get averageLatency() {
         if (this._latencySamples.length === 0) {
             return 0;
         }
-        const sum = this._latencySamples.reduce((acc, val) => acc + val, 0);
+        const sum = this._latencySamples.reduce((acc, val)=>acc + val, 0);
         return sum / this._latencySamples.length;
     }
-    connect(dataReceived, queryArguments) {
+    /** @inheritdoc */ connect(dataReceived, queryArguments) {
         let url = this._url;
         if (queryArguments) {
             if (url.indexOf('?') < 0) {
                 url = `${url}?`;
-            }
-            else {
+            } else {
                 url = `${url}&`;
             }
-            const query = Object.keys(queryArguments).map(key => `${key}=${queryArguments[key]}`).join('&');
+            const query = Object.keys(queryArguments).map((key)=>`${key}=${queryArguments[key]}`).join('&');
             url = `${url}${query}`;
         }
-        const connectSocket = () => {
+        const connectSocket = ()=>{
             this._socket = new WebSocket(url);
-            this._socket.onopen = () => {
-                if (this._disconnected)
-                    return;
+            this._socket.onopen = ()=>{
+                if (this._disconnected) return;
                 console.log(`Connection for '${url}' established`);
                 this._reconnectPolicy.reset();
                 this._connectionStartTime = Date.now();
                 this.startPinging();
             };
-            this._socket.onclose = () => {
-                if (this._disconnected)
-                    return;
+            this._socket.onclose = ()=>{
+                if (this._disconnected) return;
                 console.log(`Unexpected connection closed for route '${url}'`);
                 this.stopPinging();
                 this._reconnectPolicy.schedule(connectSocket, url);
             };
-            this._socket.onerror = (error) => {
-                if (this._disconnected)
-                    return;
+            this._socket.onerror = (error)=>{
+                if (this._disconnected) return;
                 console.log(`Error with connection for '${url}' - ${error}`);
                 this.stopPinging();
                 this._reconnectPolicy.schedule(connectSocket, url);
             };
-            this._socket.onmessage = (ev) => {
+            this._socket.onmessage = (ev)=>{
                 if (this._disconnected) {
                     console.log('Received message after closing connection');
                     return;
@@ -87,11 +98,10 @@ class ObservableQueryConnection {
                 this.handleMessage(ev.data, dataReceived);
             };
         };
-        if (this._disconnected)
-            return;
+        if (this._disconnected) return;
         connectSocket();
     }
-    disconnect() {
+    /** @inheritdoc */ disconnect() {
         if (this._disconnected) {
             return;
         }
@@ -105,7 +115,7 @@ class ObservableQueryConnection {
     }
     startPinging() {
         this.stopPinging();
-        this._pingInterval = setInterval(() => {
+        this._pingInterval = setInterval(()=>{
             this.sendPing();
         }, this._pingIntervalMs);
     }
@@ -129,15 +139,16 @@ class ObservableQueryConnection {
     handleMessage(rawData, dataReceived) {
         try {
             const message = JSON.parse(rawData);
+            // Handle messages based on type
             if (message.type === WebSocketMessageType.Pong) {
                 this.handlePong(message);
-            }
-            else if (message.type === WebSocketMessageType.Data || !message.type) {
+            } else if (message.type === WebSocketMessageType.Data || !message.type) {
+                // For new-style messages (type === 'Data') the query result is wrapped in message.data.
+                // For legacy/backward-compatible messages (no type) the entire message IS the query result.
                 const data = message.type === WebSocketMessageType.Data ? message.data : message;
                 dataReceived(data);
             }
-        }
-        catch (error) {
+        } catch (error) {
             console.error('Error parsing WebSocket message:', error);
         }
     }
@@ -146,6 +157,7 @@ class ObservableQueryConnection {
             const latency = Date.now() - message.timestamp;
             this._lastPongLatency = latency;
             this._latencySamples.push(latency);
+            // Keep only the last 100 samples for average calculation
             if (this._latencySamples.length > 100) {
                 this._latencySamples.shift();
             }

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryConnection.js","sources":["../../../queries/ObservableQueryConnection.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 { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { IReconnectPolicy } from './IReconnectPolicy';\nimport { ReconnectPolicy } from './ReconnectPolicy';\nimport { QueryResult } from './QueryResult';\nimport { WebSocketMessage, WebSocketMessageType } from './WebSocketMessage';\n\nexport type DataReceived<TDataType> = (data: QueryResult<TDataType>) => void;\n\n/**\n * Represents the connection for an observable query.\n */\nexport class ObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n\n    private _socket!: WebSocket;\n    private _disconnected = false;\n    private _url: string;\n    private _pingInterval?: ReturnType<typeof setInterval>;\n    private _pingIntervalMs: number = 10000;\n    private _lastPingSentTime?: number;\n    private _lastPongLatency: number = 0;\n    private _latencySamples: number[] = [];\n    private _connectionStartTime?: number;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryConnection<TDataType>} class.\n     * @param {Url} url The fully qualified Url.\n     * @param {string} _microservice The microservice name.\n     * @param {number} pingIntervalMs The ping interval in milliseconds (default: 10000).\n     * @param {IReconnectPolicy} reconnectPolicy The reconnect policy to use (default: {@link ReconnectPolicy}).\n     */\n    constructor(url: URL, private readonly _microservice: string, pingIntervalMs: number = 10000, private readonly _reconnectPolicy: IReconnectPolicy = new ReconnectPolicy()) {\n        this._pingIntervalMs = pingIntervalMs;\n        const secure = url.protocol?.indexOf('https') === 0 || false;\n\n        this._url = `${secure ? 'wss' : 'ws'}://${url.host}${url.pathname}${url.search}`;\n        if (this._microservice?.length > 0) {\n            const microserviceParam = `${Globals.microserviceWSQueryArgument}=${this._microservice}`;\n            if (this._url.indexOf('?') > 0) {\n                this._url = `${this._url}&${microserviceParam}`;\n            } else {\n                this._url = `${this._url}?${microserviceParam}`;\n            }\n        }\n    }\n\n    /**\n     * Disposes the connection.\n     */\n    dispose() {\n        this.disconnect();\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 average latency since the connection started in milliseconds.\n     */\n    get averageLatency(): number {\n        if (this._latencySamples.length === 0) {\n            return 0;\n        }\n        const sum = this._latencySamples.reduce((acc, val) => acc + val, 0);\n        return sum / this._latencySamples.length;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>, queryArguments?: object) {\n        let url = this._url;\n        if (queryArguments) {\n            if (url.indexOf('?') < 0) {\n                url = `${url}?`;\n            } else {\n                url = `${url}&`;\n            }\n            const query = Object.keys(queryArguments).map(key => `${key}=${queryArguments[key]}`).join('&');\n            url = `${url}${query}`;\n        }\n\n        const connectSocket = () => {\n            this._socket = new WebSocket(url);\n            this._socket.onopen = () => {\n                if (this._disconnected) return;\n                console.log(`Connection for '${url}' established`);\n                this._reconnectPolicy.reset();\n                this._connectionStartTime = Date.now();\n                this.startPinging();\n            };\n            this._socket.onclose = () => {\n                if (this._disconnected) return;\n                console.log(`Unexpected connection closed for route '${url}'`);\n                this.stopPinging();\n                this._reconnectPolicy.schedule(connectSocket, url);\n            };\n            this._socket.onerror = (error) => {\n                if (this._disconnected) return;\n                console.log(`Error with connection for '${url}' - ${error}`);\n                this.stopPinging();\n                this._reconnectPolicy.schedule(connectSocket, url);\n            };\n            this._socket.onmessage = (ev) => {\n                if (this._disconnected) {\n                    console.log('Received message after closing connection');\n                    return;\n                }\n                this.handleMessage(ev.data, dataReceived);\n            };\n        };\n\n        if (this._disconnected) return;\n        connectSocket();\n    }\n\n    /** @inheritdoc */\n    disconnect() {\n        if (this._disconnected) {\n            return;\n        }\n        console.log(`Disconnecting '${this._url}'`);\n        this._disconnected = true;\n        this._reconnectPolicy.cancel();\n        this.stopPinging();\n        this._socket?.close();\n        console.log(`Connection for '${this._url}' closed`);\n        this._socket = undefined!;\n    }\n\n    private startPinging() {\n        this.stopPinging();\n        this._pingInterval = setInterval(() => {\n            this.sendPing();\n        }, this._pingIntervalMs);\n    }\n\n    private stopPinging() {\n        if (this._pingInterval) {\n            clearInterval(this._pingInterval);\n            this._pingInterval = undefined;\n        }\n    }\n\n    private sendPing() {\n        if (this._disconnected || !this._socket || this._socket.readyState !== WebSocket.OPEN) {\n            return;\n        }\n\n        this._lastPingSentTime = Date.now();\n        const pingMessage: WebSocketMessage = {\n            type: WebSocketMessageType.Ping,\n            timestamp: this._lastPingSentTime\n        };\n\n        this._socket.send(JSON.stringify(pingMessage));\n    }\n\n    private handleMessage(rawData: string, dataReceived: DataReceived<TDataType>) {\n        try {\n            const message = JSON.parse(rawData) as WebSocketMessage;\n\n            // Handle messages based on type\n            if (message.type === WebSocketMessageType.Pong) {\n                this.handlePong(message);\n            } else if (message.type === WebSocketMessageType.Data || !message.type) {\n                // For new-style messages (type === 'Data') the query result is wrapped in message.data.\n                // For legacy/backward-compatible messages (no type) the entire message IS the query result.\n                const data = message.type === WebSocketMessageType.Data ? message.data : message;\n                dataReceived(data as QueryResult<TDataType>);\n            }\n        } catch (error) {\n            console.error('Error parsing WebSocket message:', error);\n        }\n    }\n\n    private handlePong(message: WebSocketMessage) {\n        if (message.timestamp && this._lastPingSentTime) {\n            const latency = Date.now() - message.timestamp;\n            this._lastPongLatency = latency;\n            this._latencySamples.push(latency);\n\n            // Keep only the last 100 samples for average calculation\n            if (this._latencySamples.length > 100) {\n                this._latencySamples.shift();\n            }\n        }\n    }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ObservableQueryConnection.js","sources":["../../../queries/ObservableQueryConnection.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 { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { IReconnectPolicy } from './IReconnectPolicy';\nimport { ReconnectPolicy } from './ReconnectPolicy';\nimport { QueryResult } from './QueryResult';\nimport { WebSocketMessage, WebSocketMessageType } from './WebSocketMessage';\n\nexport type DataReceived<TDataType> = (data: QueryResult<TDataType>) => void;\n\n/**\n * Represents the connection for an observable query.\n */\nexport class ObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n\n    private _socket!: WebSocket;\n    private _disconnected = false;\n    private _url: string;\n    private _pingInterval?: ReturnType<typeof setInterval>;\n    private _pingIntervalMs: number = 10000;\n    private _lastPingSentTime?: number;\n    private _lastPongLatency: number = 0;\n    private _latencySamples: number[] = [];\n    private _connectionStartTime?: number;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryConnection<TDataType>} class.\n     * @param {Url} url The fully qualified Url.\n     * @param {string} _microservice The microservice name.\n     * @param {number} pingIntervalMs The ping interval in milliseconds (default: 10000).\n     * @param {IReconnectPolicy} reconnectPolicy The reconnect policy to use (default: {@link ReconnectPolicy}).\n     */\n    constructor(url: URL, private readonly _microservice: string, pingIntervalMs: number = 10000, private readonly _reconnectPolicy: IReconnectPolicy = new ReconnectPolicy()) {\n        this._pingIntervalMs = pingIntervalMs;\n        const secure = url.protocol?.indexOf('https') === 0 || false;\n\n        this._url = `${secure ? 'wss' : 'ws'}://${url.host}${url.pathname}${url.search}`;\n        if (this._microservice?.length > 0) {\n            const microserviceParam = `${Globals.microserviceWSQueryArgument}=${this._microservice}`;\n            if (this._url.indexOf('?') > 0) {\n                this._url = `${this._url}&${microserviceParam}`;\n            } else {\n                this._url = `${this._url}?${microserviceParam}`;\n            }\n        }\n    }\n\n    /**\n     * Disposes the connection.\n     */\n    dispose() {\n        this.disconnect();\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 average latency since the connection started in milliseconds.\n     */\n    get averageLatency(): number {\n        if (this._latencySamples.length === 0) {\n            return 0;\n        }\n        const sum = this._latencySamples.reduce((acc, val) => acc + val, 0);\n        return sum / this._latencySamples.length;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>, queryArguments?: object) {\n        let url = this._url;\n        if (queryArguments) {\n            if (url.indexOf('?') < 0) {\n                url = `${url}?`;\n            } else {\n                url = `${url}&`;\n            }\n            const query = Object.keys(queryArguments).map(key => `${key}=${queryArguments[key]}`).join('&');\n            url = `${url}${query}`;\n        }\n\n        const connectSocket = () => {\n            this._socket = new WebSocket(url);\n            this._socket.onopen = () => {\n                if (this._disconnected) return;\n                console.log(`Connection for '${url}' established`);\n                this._reconnectPolicy.reset();\n                this._connectionStartTime = Date.now();\n                this.startPinging();\n            };\n            this._socket.onclose = () => {\n                if (this._disconnected) return;\n                console.log(`Unexpected connection closed for route '${url}'`);\n                this.stopPinging();\n                this._reconnectPolicy.schedule(connectSocket, url);\n            };\n            this._socket.onerror = (error) => {\n                if (this._disconnected) return;\n                console.log(`Error with connection for '${url}' - ${error}`);\n                this.stopPinging();\n                this._reconnectPolicy.schedule(connectSocket, url);\n            };\n            this._socket.onmessage = (ev) => {\n                if (this._disconnected) {\n                    console.log('Received message after closing connection');\n                    return;\n                }\n                this.handleMessage(ev.data, dataReceived);\n            };\n        };\n\n        if (this._disconnected) return;\n        connectSocket();\n    }\n\n    /** @inheritdoc */\n    disconnect() {\n        if (this._disconnected) {\n            return;\n        }\n        console.log(`Disconnecting '${this._url}'`);\n        this._disconnected = true;\n        this._reconnectPolicy.cancel();\n        this.stopPinging();\n        this._socket?.close();\n        console.log(`Connection for '${this._url}' closed`);\n        this._socket = undefined!;\n    }\n\n    private startPinging() {\n        this.stopPinging();\n        this._pingInterval = setInterval(() => {\n            this.sendPing();\n        }, this._pingIntervalMs);\n    }\n\n    private stopPinging() {\n        if (this._pingInterval) {\n            clearInterval(this._pingInterval);\n            this._pingInterval = undefined;\n        }\n    }\n\n    private sendPing() {\n        if (this._disconnected || !this._socket || this._socket.readyState !== WebSocket.OPEN) {\n            return;\n        }\n\n        this._lastPingSentTime = Date.now();\n        const pingMessage: WebSocketMessage = {\n            type: WebSocketMessageType.Ping,\n            timestamp: this._lastPingSentTime\n        };\n\n        this._socket.send(JSON.stringify(pingMessage));\n    }\n\n    private handleMessage(rawData: string, dataReceived: DataReceived<TDataType>) {\n        try {\n            const message = JSON.parse(rawData) as WebSocketMessage;\n\n            // Handle messages based on type\n            if (message.type === WebSocketMessageType.Pong) {\n                this.handlePong(message);\n            } else if (message.type === WebSocketMessageType.Data || !message.type) {\n                // For new-style messages (type === 'Data') the query result is wrapped in message.data.\n                // For legacy/backward-compatible messages (no type) the entire message IS the query result.\n                const data = message.type === WebSocketMessageType.Data ? message.data : message;\n                dataReceived(data as QueryResult<TDataType>);\n            }\n        } catch (error) {\n            console.error('Error parsing WebSocket message:', error);\n        }\n    }\n\n    private handlePong(message: WebSocketMessage) {\n        if (message.timestamp && this._lastPingSentTime) {\n            const latency = Date.now() - message.timestamp;\n            this._lastPongLatency = latency;\n            this._latencySamples.push(latency);\n\n            // Keep only the last 100 samples for average calculation\n            if (this._latencySamples.length > 100) {\n                this._latencySamples.shift();\n            }\n        }\n    }\n}\n"],"names":["ObservableQueryConnection","_socket","_disconnected","_url","_pingInterval","_pingIntervalMs","_lastPingSentTime","_lastPongLatency","_latencySamples","_connectionStartTime","url","_microservice","pingIntervalMs","_reconnectPolicy","ReconnectPolicy","secure","protocol","indexOf","host","pathname","search","length","microserviceParam","Globals","microserviceWSQueryArgument","dispose","disconnect","lastPingLatency","averageLatency","sum","reduce","acc","val","connect","dataReceived","queryArguments","query","Object","keys","map","key","join","connectSocket","WebSocket","onopen","console","log","reset","Date","now","startPinging","onclose","stopPinging","schedule","onerror","error","onmessage","ev","handleMessage","data","cancel","close","undefined","setInterval","sendPing","clearInterval","readyState","OPEN","pingMessage","type","WebSocketMessageType","Ping","timestamp","send","JSON","stringify","rawData","message","parse","Pong","handlePong","Data","latency","push","shift"],"mappings":"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"}

package/dist/esm/queries/ObservableQueryConnectionFactory.js

@@ -8,17 +8,36 @@ import { ServerSentEventHubConnection } from './ServerSentEventHubConnection.js'
 import { WebSocketHubConnection } from './WebSocketHubConnection.js';
 import { getOrCreateMultiplexer, WS_HUB_ROUTE, MultiplexedObservableQueryConnection } from './ObservableQueryMultiplexer.js';
 
-const SSE_SUBSCRIBE_ROUTE = '/.cratis/queries/sse/subscribe';
-const SSE_UNSUBSCRIBE_ROUTE = '/.cratis/queries/sse/unsubscribe';
-function createObservableQueryConnection(descriptor) {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The SSE subscribe POST endpoint route.
+ */ const SSE_SUBSCRIBE_ROUTE = '/.cratis/queries/sse/subscribe';
+/**
+ * The SSE unsubscribe POST endpoint route.
+ */ const SSE_UNSUBSCRIBE_ROUTE = '/.cratis/queries/sse/unsubscribe';
+/**
+ * Single entry-point for creating observable query connections.
+ *
+ * The transport is chosen as a 2x2 matrix of (direct | hub) x (WebSocket | SSE):
+ *
+ * |                | Direct (per-query URL)         | Hub (centralized endpoint)    |
+ * |----------------|-------------------------------|-------------------------------|
+ * | **WebSocket**  | ObservableQueryConnection                | MultiplexedObservableQueryConnection |
+ * | **SSE**        | ServerSentEventQueryConnection           | MultiplexedObservableQueryConnection |
+ *
+ * In multiplexed mode, both transports share the same multiplexer — it creates either
+ * WebSocket or SSE connections depending on the transport setting.
+ *
+ * {@link ObservableQueryFor} never needs to know which transport is in use.
+ */ function createObservableQueryConnection(descriptor) {
     const isSSE = Globals.queryTransportMethod === QueryTransportMethod.ServerSentEvents;
     if (Globals.queryDirectMode) {
-        return isSSE
-            ? createDirectSSEConnection(descriptor)
-            : createDirectWebSocketConnection(descriptor);
+        return isSSE ? createDirectSSEConnection(descriptor) : createDirectWebSocketConnection(descriptor);
     }
     return createMultiplexedConnection(descriptor, isSSE);
 }
+// ---- Direct mode: one connection per query, hitting the query's own URL ----
 function buildDirectUrl(descriptor) {
     const { route } = UrlHelpers.replaceRouteParameters(descriptor.route, descriptor.args);
     const actualRoute = joinPaths(descriptor.apiBasePath, route);
@@ -30,19 +49,23 @@ function createDirectWebSocketConnection(descriptor) {
 function createDirectSSEConnection(descriptor) {
     return new ServerSentEventQueryConnection(buildDirectUrl(descriptor));
 }
-const MAX_SAFE_SSE_CONNECTIONS = 4;
+// ---- Multiplexed mode: centralized endpoint, multiple queries share connections ----
+/**
+ * Maximum number of SSE hub connections that fits safely within the HTTP/1.1 browser
+ * per-origin connection limit (typically 6 for Chrome/Firefox). Each SSE EventSource
+ * occupies one persistent connection slot indefinitely. Exceeding this cap blocks the
+ * subscribe/unsubscribe POST requests that share the same pool, causing queries to hang.
+ * Servers configured for HTTP/2 do not have this restriction.
+ */ const MAX_SAFE_SSE_CONNECTIONS = 4;
 function createMultiplexedConnection(descriptor, isSSE) {
     const transport = isSSE ? 'sse' : 'ws';
     const requestedCount = Globals.queryConnectionCount;
     const effectiveCount = isSSE ? Math.min(requestedCount, MAX_SAFE_SSE_CONNECTIONS) : requestedCount;
     if (isSSE && requestedCount > MAX_SAFE_SSE_CONNECTIONS) {
-        console.warn(`[Arc] queryConnectionCount (${requestedCount}) exceeds the safe limit for SSE transport (${MAX_SAFE_SSE_CONNECTIONS}). ` +
-            `HTTP/1.1 browsers allow at most 6 concurrent connections per origin; ` +
-            `using more SSE connections blocks subscribe/unsubscribe requests, causing queries to hang. ` +
-            `Capping at ${MAX_SAFE_SSE_CONNECTIONS}. Enable HTTP/2 on your server to use a higher connection count.`);
+        console.warn(`[Arc] queryConnectionCount (${requestedCount}) exceeds the safe limit for SSE transport (${MAX_SAFE_SSE_CONNECTIONS}). ` + `HTTP/1.1 browsers allow at most 6 concurrent connections per origin; ` + `using more SSE connections blocks subscribe/unsubscribe requests, causing queries to hang. ` + `Capping at ${MAX_SAFE_SSE_CONNECTIONS}. Enable HTTP/2 on your server to use a higher connection count.`);
     }
     const cacheKey = `${requestedCount}|${transport}|${descriptor.origin}|${descriptor.apiBasePath}|${descriptor.microservice}`;
-    const multiplexer = getOrCreateMultiplexer(() => {
+    const multiplexer = getOrCreateMultiplexer(()=>{
         if (isSSE) {
             const sseRoute = joinPaths(descriptor.apiBasePath, SSE_HUB_ROUTE);
             const sseUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, sseRoute);
@@ -51,8 +74,7 @@ function createMultiplexedConnection(descriptor, isSSE) {
             const unsubscribeRoute = joinPaths(descriptor.apiBasePath, SSE_UNSUBSCRIBE_ROUTE);
             const unsubscribeUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, unsubscribeRoute);
             return new ServerSentEventHubConnection(sseUrl.toString(), subscribeUrl.toString(), unsubscribeUrl.toString(), descriptor.microservice);
-        }
-        else {
+        } else {
             const hubRoute = joinPaths(descriptor.apiBasePath, WS_HUB_ROUTE);
             const hubUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, hubRoute);
             const secure = hubUrl.protocol?.indexOf('https') === 0;

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryConnectionFactory.js","sources":["../../../queries/ObservableQueryConnectionFactory.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 { joinPaths } from '../joinPaths';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { ObservableQueryConnection } from './ObservableQueryConnection';\nimport { QueryTransportMethod } from './QueryTransportMethod';\nimport { ServerSentEventQueryConnection, SSE_HUB_ROUTE } from './ServerSentEventQueryConnection';\nimport { ServerSentEventHubConnection } from './ServerSentEventHubConnection';\nimport { WebSocketHubConnection } from './WebSocketHubConnection';\nimport { MultiplexedObservableQueryConnection, WS_HUB_ROUTE, getOrCreateMultiplexer } from './ObservableQueryMultiplexer';\n\n/**\n * The SSE subscribe POST endpoint route.\n */\nexport const SSE_SUBSCRIBE_ROUTE = '/.cratis/queries/sse/subscribe';\n\n/**\n * The SSE unsubscribe POST endpoint route.\n */\nexport const SSE_UNSUBSCRIBE_ROUTE = '/.cratis/queries/sse/unsubscribe';\n\n/**\n * Describes what the factory needs to know about a query in order to create\n * the right connection. Transport details are intentionally absent — the\n * factory reads those from {@link Globals}.\n */\nexport interface QueryConnectionDescriptor {\n    /** The route template (e.g. `/api/accounts/debit/all-accounts`). */\n    route: string;\n    /** Fully-qualified backend query name used by hub transports. */\n    queryName: string;\n    /** Origin base URL (e.g. `http://localhost:5000`). */\n    origin: string;\n    /** API base path prefix. */\n    apiBasePath: string;\n    /** Microservice identifier. */\n    microservice: string;\n    /** Route/query arguments for the current subscription. */\n    args?: object;\n}\n\n/**\n * Single entry-point for creating observable query connections.\n *\n * The transport is chosen as a 2x2 matrix of (direct | hub) x (WebSocket | SSE):\n *\n * |                | Direct (per-query URL)         | Hub (centralized endpoint)    |\n * |----------------|-------------------------------|-------------------------------|\n * | **WebSocket**  | ObservableQueryConnection                | MultiplexedObservableQueryConnection |\n * | **SSE**        | ServerSentEventQueryConnection           | MultiplexedObservableQueryConnection |\n *\n * In multiplexed mode, both transports share the same multiplexer — it creates either\n * WebSocket or SSE connections depending on the transport setting.\n *\n * {@link ObservableQueryFor} never needs to know which transport is in use.\n */\nexport function createObservableQueryConnection<TDataType>(descriptor: QueryConnectionDescriptor): IObservableQueryConnection<TDataType> {\n    const isSSE = Globals.queryTransportMethod === QueryTransportMethod.ServerSentEvents;\n\n    if (Globals.queryDirectMode) {\n        return isSSE\n            ? createDirectSSEConnection<TDataType>(descriptor)\n            : createDirectWebSocketConnection<TDataType>(descriptor);\n    }\n\n    return createMultiplexedConnection<TDataType>(descriptor, isSSE);\n}\n\n// ---- Direct mode: one connection per query, hitting the query's own URL ----\n\nfunction buildDirectUrl(descriptor: QueryConnectionDescriptor): URL {\n    const { route } = UrlHelpers.replaceRouteParameters(descriptor.route, descriptor.args as object);\n    const actualRoute = joinPaths(descriptor.apiBasePath, route);\n    return UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, actualRoute);\n}\n\nfunction createDirectWebSocketConnection<TDataType>(descriptor: QueryConnectionDescriptor): IObservableQueryConnection<TDataType> {\n    return new ObservableQueryConnection<TDataType>(buildDirectUrl(descriptor), descriptor.microservice);\n}\n\nfunction createDirectSSEConnection<TDataType>(descriptor: QueryConnectionDescriptor): IObservableQueryConnection<TDataType> {\n    return new ServerSentEventQueryConnection<TDataType>(buildDirectUrl(descriptor));\n}\n\n// ---- Multiplexed mode: centralized endpoint, multiple queries share connections ----\n\n/**\n * Maximum number of SSE hub connections that fits safely within the HTTP/1.1 browser\n * per-origin connection limit (typically 6 for Chrome/Firefox). Each SSE EventSource\n * occupies one persistent connection slot indefinitely. Exceeding this cap blocks the\n * subscribe/unsubscribe POST requests that share the same pool, causing queries to hang.\n * Servers configured for HTTP/2 do not have this restriction.\n */\nconst MAX_SAFE_SSE_CONNECTIONS = 4;\n\nfunction createMultiplexedConnection<TDataType>(descriptor: QueryConnectionDescriptor, isSSE: boolean): IObservableQueryConnection<TDataType> {\n    const transport = isSSE ? 'sse' : 'ws';\n    const requestedCount = Globals.queryConnectionCount;\n    const effectiveCount = isSSE ? Math.min(requestedCount, MAX_SAFE_SSE_CONNECTIONS) : requestedCount;\n\n    if (isSSE && requestedCount > MAX_SAFE_SSE_CONNECTIONS) {\n        console.warn(\n            `[Arc] queryConnectionCount (${requestedCount}) exceeds the safe limit for SSE transport (${MAX_SAFE_SSE_CONNECTIONS}). ` +\n            `HTTP/1.1 browsers allow at most 6 concurrent connections per origin; ` +\n            `using more SSE connections blocks subscribe/unsubscribe requests, causing queries to hang. ` +\n            `Capping at ${MAX_SAFE_SSE_CONNECTIONS}. Enable HTTP/2 on your server to use a higher connection count.`\n        );\n    }\n\n    const cacheKey = `${requestedCount}|${transport}|${descriptor.origin}|${descriptor.apiBasePath}|${descriptor.microservice}`;\n\n    const multiplexer = getOrCreateMultiplexer(() => {\n        if (isSSE) {\n            const sseRoute = joinPaths(descriptor.apiBasePath, SSE_HUB_ROUTE);\n            const sseUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, sseRoute);\n            const subscribeRoute = joinPaths(descriptor.apiBasePath, SSE_SUBSCRIBE_ROUTE);\n            const subscribeUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, subscribeRoute);\n            const unsubscribeRoute = joinPaths(descriptor.apiBasePath, SSE_UNSUBSCRIBE_ROUTE);\n            const unsubscribeUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, unsubscribeRoute);\n            return new ServerSentEventHubConnection(\n                sseUrl.toString(),\n                subscribeUrl.toString(),\n                unsubscribeUrl.toString(),\n                descriptor.microservice,\n            );\n        } else {\n            const hubRoute = joinPaths(descriptor.apiBasePath, WS_HUB_ROUTE);\n            const hubUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, hubRoute);\n            const secure = hubUrl.protocol?.indexOf('https') === 0;\n            const wsUrl = `${secure ? 'wss' : 'ws'}://${hubUrl.host}${hubUrl.pathname}${hubUrl.search}`;\n            return new WebSocketHubConnection(wsUrl, descriptor.microservice);\n        }\n    }, cacheKey, effectiveCount);\n\n    return new MultiplexedObservableQueryConnection<TDataType>(multiplexer, descriptor.queryName);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ObservableQueryConnectionFactory.js","sources":["../../../queries/ObservableQueryConnectionFactory.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 { joinPaths } from '../joinPaths';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { ObservableQueryConnection } from './ObservableQueryConnection';\nimport { QueryTransportMethod } from './QueryTransportMethod';\nimport { ServerSentEventQueryConnection, SSE_HUB_ROUTE } from './ServerSentEventQueryConnection';\nimport { ServerSentEventHubConnection } from './ServerSentEventHubConnection';\nimport { WebSocketHubConnection } from './WebSocketHubConnection';\nimport { MultiplexedObservableQueryConnection, WS_HUB_ROUTE, getOrCreateMultiplexer } from './ObservableQueryMultiplexer';\n\n/**\n * The SSE subscribe POST endpoint route.\n */\nexport const SSE_SUBSCRIBE_ROUTE = '/.cratis/queries/sse/subscribe';\n\n/**\n * The SSE unsubscribe POST endpoint route.\n */\nexport const SSE_UNSUBSCRIBE_ROUTE = '/.cratis/queries/sse/unsubscribe';\n\n/**\n * Describes what the factory needs to know about a query in order to create\n * the right connection. Transport details are intentionally absent — the\n * factory reads those from {@link Globals}.\n */\nexport interface QueryConnectionDescriptor {\n    /** The route template (e.g. `/api/accounts/debit/all-accounts`). */\n    route: string;\n    /** Fully-qualified backend query name used by hub transports. */\n    queryName: string;\n    /** Origin base URL (e.g. `http://localhost:5000`). */\n    origin: string;\n    /** API base path prefix. */\n    apiBasePath: string;\n    /** Microservice identifier. */\n    microservice: string;\n    /** Route/query arguments for the current subscription. */\n    args?: object;\n}\n\n/**\n * Single entry-point for creating observable query connections.\n *\n * The transport is chosen as a 2x2 matrix of (direct | hub) x (WebSocket | SSE):\n *\n * |                | Direct (per-query URL)         | Hub (centralized endpoint)    |\n * |----------------|-------------------------------|-------------------------------|\n * | **WebSocket**  | ObservableQueryConnection                | MultiplexedObservableQueryConnection |\n * | **SSE**        | ServerSentEventQueryConnection           | MultiplexedObservableQueryConnection |\n *\n * In multiplexed mode, both transports share the same multiplexer — it creates either\n * WebSocket or SSE connections depending on the transport setting.\n *\n * {@link ObservableQueryFor} never needs to know which transport is in use.\n */\nexport function createObservableQueryConnection<TDataType>(descriptor: QueryConnectionDescriptor): IObservableQueryConnection<TDataType> {\n    const isSSE = Globals.queryTransportMethod === QueryTransportMethod.ServerSentEvents;\n\n    if (Globals.queryDirectMode) {\n        return isSSE\n            ? createDirectSSEConnection<TDataType>(descriptor)\n            : createDirectWebSocketConnection<TDataType>(descriptor);\n    }\n\n    return createMultiplexedConnection<TDataType>(descriptor, isSSE);\n}\n\n// ---- Direct mode: one connection per query, hitting the query's own URL ----\n\nfunction buildDirectUrl(descriptor: QueryConnectionDescriptor): URL {\n    const { route } = UrlHelpers.replaceRouteParameters(descriptor.route, descriptor.args as object);\n    const actualRoute = joinPaths(descriptor.apiBasePath, route);\n    return UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, actualRoute);\n}\n\nfunction createDirectWebSocketConnection<TDataType>(descriptor: QueryConnectionDescriptor): IObservableQueryConnection<TDataType> {\n    return new ObservableQueryConnection<TDataType>(buildDirectUrl(descriptor), descriptor.microservice);\n}\n\nfunction createDirectSSEConnection<TDataType>(descriptor: QueryConnectionDescriptor): IObservableQueryConnection<TDataType> {\n    return new ServerSentEventQueryConnection<TDataType>(buildDirectUrl(descriptor));\n}\n\n// ---- Multiplexed mode: centralized endpoint, multiple queries share connections ----\n\n/**\n * Maximum number of SSE hub connections that fits safely within the HTTP/1.1 browser\n * per-origin connection limit (typically 6 for Chrome/Firefox). Each SSE EventSource\n * occupies one persistent connection slot indefinitely. Exceeding this cap blocks the\n * subscribe/unsubscribe POST requests that share the same pool, causing queries to hang.\n * Servers configured for HTTP/2 do not have this restriction.\n */\nconst MAX_SAFE_SSE_CONNECTIONS = 4;\n\nfunction createMultiplexedConnection<TDataType>(descriptor: QueryConnectionDescriptor, isSSE: boolean): IObservableQueryConnection<TDataType> {\n    const transport = isSSE ? 'sse' : 'ws';\n    const requestedCount = Globals.queryConnectionCount;\n    const effectiveCount = isSSE ? Math.min(requestedCount, MAX_SAFE_SSE_CONNECTIONS) : requestedCount;\n\n    if (isSSE && requestedCount > MAX_SAFE_SSE_CONNECTIONS) {\n        console.warn(\n            `[Arc] queryConnectionCount (${requestedCount}) exceeds the safe limit for SSE transport (${MAX_SAFE_SSE_CONNECTIONS}). ` +\n            `HTTP/1.1 browsers allow at most 6 concurrent connections per origin; ` +\n            `using more SSE connections blocks subscribe/unsubscribe requests, causing queries to hang. ` +\n            `Capping at ${MAX_SAFE_SSE_CONNECTIONS}. Enable HTTP/2 on your server to use a higher connection count.`\n        );\n    }\n\n    const cacheKey = `${requestedCount}|${transport}|${descriptor.origin}|${descriptor.apiBasePath}|${descriptor.microservice}`;\n\n    const multiplexer = getOrCreateMultiplexer(() => {\n        if (isSSE) {\n            const sseRoute = joinPaths(descriptor.apiBasePath, SSE_HUB_ROUTE);\n            const sseUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, sseRoute);\n            const subscribeRoute = joinPaths(descriptor.apiBasePath, SSE_SUBSCRIBE_ROUTE);\n            const subscribeUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, subscribeRoute);\n            const unsubscribeRoute = joinPaths(descriptor.apiBasePath, SSE_UNSUBSCRIBE_ROUTE);\n            const unsubscribeUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, unsubscribeRoute);\n            return new ServerSentEventHubConnection(\n                sseUrl.toString(),\n                subscribeUrl.toString(),\n                unsubscribeUrl.toString(),\n                descriptor.microservice,\n            );\n        } else {\n            const hubRoute = joinPaths(descriptor.apiBasePath, WS_HUB_ROUTE);\n            const hubUrl = UrlHelpers.createUrlFrom(descriptor.origin, descriptor.apiBasePath, hubRoute);\n            const secure = hubUrl.protocol?.indexOf('https') === 0;\n            const wsUrl = `${secure ? 'wss' : 'ws'}://${hubUrl.host}${hubUrl.pathname}${hubUrl.search}`;\n            return new WebSocketHubConnection(wsUrl, descriptor.microservice);\n        }\n    }, cacheKey, effectiveCount);\n\n    return new MultiplexedObservableQueryConnection<TDataType>(multiplexer, descriptor.queryName);\n}\n"],"names":["SSE_SUBSCRIBE_ROUTE","SSE_UNSUBSCRIBE_ROUTE","createObservableQueryConnection","descriptor","isSSE","Globals","queryTransportMethod","QueryTransportMethod","ServerSentEvents","queryDirectMode","createDirectSSEConnection","createDirectWebSocketConnection","createMultiplexedConnection","buildDirectUrl","route","UrlHelpers","replaceRouteParameters","args","actualRoute","joinPaths","apiBasePath","createUrlFrom","origin","ObservableQueryConnection","microservice","ServerSentEventQueryConnection","MAX_SAFE_SSE_CONNECTIONS","transport","requestedCount","queryConnectionCount","effectiveCount","Math","min","console","warn","cacheKey","multiplexer","getOrCreateMultiplexer","sseRoute","SSE_HUB_ROUTE","sseUrl","subscribeRoute","subscribeUrl","unsubscribeRoute","unsubscribeUrl","ServerSentEventHubConnection","toString","hubRoute","WS_HUB_ROUTE","hubUrl","secure","protocol","indexOf","wsUrl","host","pathname","search","WebSocketHubConnection","MultiplexedObservableQueryConnection","queryName"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryConnectionPool.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryConnectionPool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAuB3D,qBAAa,6BAA6B,CAAC,SAAS;IAU5C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAT7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;gBAQhC,IAAI,EAAE,MAAM,EACK,QAAQ,EAAE,MAAM,0BAA0B,CAAC,SAAS,CAAC;IAY1E,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI;CActF"}
+{"version":3,"file":"ObservableQueryConnectionPool.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryConnectionPool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAuB3D,qBAAa,6BAA6B,CAAC,SAAS;IAU5C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAT7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IAOpC,YACI,IAAI,EAAE,MAAM,EACK,QAAQ,EAAE,MAAM,0BAA0B,CAAC,SAAS,CAAC,EAGzE;IASD,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAalF;CACJ"}

package/dist/esm/queries/ObservableQueryConnectionPool.js

@@ -1,16 +1,47 @@
-class ObservableQueryConnectionPool {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents a pool of observable query connection factories distributed round-robin across N slots.
+ *
+ * Each call to {@link acquire} picks the slot with the fewest active queries (falling back to
+ * round-robin when counts are equal) and creates a fresh connection for that subscriber via the
+ * provided factory. The connection is a dedicated instance per subscriber; the pool only tracks
+ * slot utilization so future multiplexed transports (e.g. WebSocket) can share connections
+ * across a fixed number of physical hub connections.
+ *
+ * When {@link size} is 1 (the default), all queries are counted against a single slot — the
+ * natural behavior for a single multiplexed connection.
+ *
+ * @template TDataType The type of data received from the connections.
+ */ class ObservableQueryConnectionPool {
     _factory;
     _slots;
-    constructor(size, _factory) {
+    /**
+     * Initializes a new {@link ObservableQueryConnectionPool}.
+     * @param {number} size Number of logical slots (hub connections) in the pool.
+     * @param {() => IObservableQueryConnection<TDataType>} factory Factory that produces a new connection instance per subscriber.
+     */ constructor(size, _factory){
         this._factory = _factory;
-        this._slots = Array.from({ length: Math.max(1, size) }, () => ({ queryCount: 0 }));
+        this._slots = Array.from({
+            length: Math.max(1, size)
+        }, ()=>({
+                queryCount: 0
+            }));
     }
-    acquire(dataReceived, queryArguments) {
-        const slot = this._slots.reduce((min, current) => current.queryCount < min.queryCount ? current : min, this._slots[0]);
+    /**
+     * Picks the least-loaded pool slot, creates a fresh connection via the factory, and starts
+     * delivering data to the provided callback.
+     * @param {DataReceived<TDataType>} dataReceived Callback invoked for each message.
+     * @param {object} queryArguments Arguments forwarded to the connection.
+     * @returns A cleanup function that decrements the slot counter and disconnects the connection.
+     */ acquire(dataReceived, queryArguments) {
+        // Pick the slot with the fewest active queries.
+        const slot = this._slots.reduce((min, current)=>current.queryCount < min.queryCount ? current : min, this._slots[0]);
         slot.queryCount++;
+        // Each subscriber gets its own dedicated connection instance.
         const connection = this._factory();
         connection.connect(dataReceived, queryArguments);
-        return () => {
+        return ()=>{
             connection.disconnect();
             slot.queryCount = Math.max(0, slot.queryCount - 1);
         };

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryConnectionPool.js","sources":["../../../queries/ObservableQueryConnectionPool.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { DataReceived } from './ObservableQueryConnection';\n\n/**\n * Tracks the number of active subscribers assigned to each pool slot.\n */\ninterface PoolSlot {\n    queryCount: number;\n}\n\n/**\n * Represents a pool of observable query connection factories distributed round-robin across N slots.\n *\n * Each call to {@link acquire} picks the slot with the fewest active queries (falling back to\n * round-robin when counts are equal) and creates a fresh connection for that subscriber via the\n * provided factory. The connection is a dedicated instance per subscriber; the pool only tracks\n * slot utilization so future multiplexed transports (e.g. WebSocket) can share connections\n * across a fixed number of physical hub connections.\n *\n * When {@link size} is 1 (the default), all queries are counted against a single slot — the\n * natural behavior for a single multiplexed connection.\n *\n * @template TDataType The type of data received from the connections.\n */\nexport class ObservableQueryConnectionPool<TDataType> {\n    private readonly _slots: PoolSlot[];\n\n    /**\n     * Initializes a new {@link ObservableQueryConnectionPool}.\n     * @param {number} size Number of logical slots (hub connections) in the pool.\n     * @param {() => IObservableQueryConnection<TDataType>} factory Factory that produces a new connection instance per subscriber.\n     */\n    constructor(\n        size: number,\n        private readonly _factory: () => IObservableQueryConnection<TDataType>\n    ) {\n        this._slots = Array.from({ length: Math.max(1, size) }, () => ({ queryCount: 0 }));\n    }\n\n    /**\n     * Picks the least-loaded pool slot, creates a fresh connection via the factory, and starts\n     * delivering data to the provided callback.\n     * @param {DataReceived<TDataType>} dataReceived Callback invoked for each message.\n     * @param {object} queryArguments Arguments forwarded to the connection.\n     * @returns A cleanup function that decrements the slot counter and disconnects the connection.\n     */\n    acquire(dataReceived: DataReceived<TDataType>, queryArguments?: object): () => void {\n        // Pick the slot with the fewest active queries.\n        const slot = this._slots.reduce((min, current) => current.queryCount < min.queryCount ? current : min, this._slots[0]);\n        slot.queryCount++;\n\n        // Each subscriber gets its own dedicated connection instance.\n        const connection = this._factory();\n        connection.connect(dataReceived, queryArguments);\n\n        return () => {\n            connection.disconnect();\n            slot.queryCount = Math.max(0, slot.queryCount - 1);\n        };\n    }\n}\n"],"names":[],"mappings":"MA2Ba,6BAA6B,CAAA;AAUjB,IAAA,QAAA;AATJ,IAAA,MAAM;IAOvB,WAAA,CACI,IAAY,EACK,QAAqD,EAAA;QAArD,IAAA,CAAA,QAAQ,GAAR,QAAQ;AAEzB,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IACtF;IASA,OAAO,CAAC,YAAqC,EAAE,cAAuB,EAAA;AAElE,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,GAAG,OAAO,GAAG,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACtH,IAAI,CAAC,UAAU,EAAE;AAGjB,QAAA,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE;AAClC,QAAA,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC;AAEhD,QAAA,OAAO,MAAK;YACR,UAAU,CAAC,UAAU,EAAE;AACvB,YAAA,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;AACtD,QAAA,CAAC;IACL;AACH;;;;"}
+{"version":3,"file":"ObservableQueryConnectionPool.js","sources":["../../../queries/ObservableQueryConnectionPool.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { DataReceived } from './ObservableQueryConnection';\n\n/**\n * Tracks the number of active subscribers assigned to each pool slot.\n */\ninterface PoolSlot {\n    queryCount: number;\n}\n\n/**\n * Represents a pool of observable query connection factories distributed round-robin across N slots.\n *\n * Each call to {@link acquire} picks the slot with the fewest active queries (falling back to\n * round-robin when counts are equal) and creates a fresh connection for that subscriber via the\n * provided factory. The connection is a dedicated instance per subscriber; the pool only tracks\n * slot utilization so future multiplexed transports (e.g. WebSocket) can share connections\n * across a fixed number of physical hub connections.\n *\n * When {@link size} is 1 (the default), all queries are counted against a single slot — the\n * natural behavior for a single multiplexed connection.\n *\n * @template TDataType The type of data received from the connections.\n */\nexport class ObservableQueryConnectionPool<TDataType> {\n    private readonly _slots: PoolSlot[];\n\n    /**\n     * Initializes a new {@link ObservableQueryConnectionPool}.\n     * @param {number} size Number of logical slots (hub connections) in the pool.\n     * @param {() => IObservableQueryConnection<TDataType>} factory Factory that produces a new connection instance per subscriber.\n     */\n    constructor(\n        size: number,\n        private readonly _factory: () => IObservableQueryConnection<TDataType>\n    ) {\n        this._slots = Array.from({ length: Math.max(1, size) }, () => ({ queryCount: 0 }));\n    }\n\n    /**\n     * Picks the least-loaded pool slot, creates a fresh connection via the factory, and starts\n     * delivering data to the provided callback.\n     * @param {DataReceived<TDataType>} dataReceived Callback invoked for each message.\n     * @param {object} queryArguments Arguments forwarded to the connection.\n     * @returns A cleanup function that decrements the slot counter and disconnects the connection.\n     */\n    acquire(dataReceived: DataReceived<TDataType>, queryArguments?: object): () => void {\n        // Pick the slot with the fewest active queries.\n        const slot = this._slots.reduce((min, current) => current.queryCount < min.queryCount ? current : min, this._slots[0]);\n        slot.queryCount++;\n\n        // Each subscriber gets its own dedicated connection instance.\n        const connection = this._factory();\n        connection.connect(dataReceived, queryArguments);\n\n        return () => {\n            connection.disconnect();\n            slot.queryCount = Math.max(0, slot.queryCount - 1);\n        };\n    }\n}\n"],"names":["ObservableQueryConnectionPool","_slots","size","_factory","Array","from","length","Math","max","queryCount","acquire","dataReceived","queryArguments","slot","reduce","min","current","connection","connect","disconnect"],"mappings":"AAAA;AACA;AAYA;;;;;;;;;;;;;AAaC,IACM,MAAMA,6BAAAA,CAAAA;;IACQC,MAAAA;AAEjB;;;;AAIC,QACD,WAAA,CACIC,IAAY,EACKC,QAAqD,CACxE;aADmBA,QAAAA,GAAAA,QAAAA;AAEjB,QAAA,IAAI,CAACF,MAAM,GAAGG,KAAAA,CAAMC,IAAI,CAAC;YAAEC,MAAAA,EAAQC,IAAAA,CAAKC,GAAG,CAAC,CAAA,EAAGN,IAAAA;AAAM,SAAA,EAAG,KAAO;gBAAEO,UAAAA,EAAY;aAAE,CAAA,CAAA;AACnF,IAAA;AAEA;;;;;;AAMC,QACDC,OAAAA,CAAQC,YAAqC,EAAEC,cAAuB,EAAc;;QAEhF,MAAMC,IAAAA,GAAO,IAAI,CAACZ,MAAM,CAACa,MAAM,CAAC,CAACC,GAAAA,EAAKC,OAAAA,GAAYA,OAAAA,CAAQP,UAAU,GAAGM,GAAAA,CAAIN,UAAU,GAAGO,OAAAA,GAAUD,KAAK,IAAI,CAACd,MAAM,CAAC,CAAA,CAAE,CAAA;AACrHY,QAAAA,IAAAA,CAAKJ,UAAU,EAAA;;QAGf,MAAMQ,UAAAA,GAAa,IAAI,CAACd,QAAQ,EAAA;QAChCc,UAAAA,CAAWC,OAAO,CAACP,YAAAA,EAAcC,cAAAA,CAAAA;QAEjC,OAAO,IAAA;AACHK,YAAAA,UAAAA,CAAWE,UAAU,EAAA;YACrBN,IAAAA,CAAKJ,UAAU,GAAGF,IAAAA,CAAKC,GAAG,CAAC,CAAA,EAAGK,IAAAA,CAAKJ,UAAU,GAAG,CAAA,CAAA;AACpD,QAAA,CAAA;AACJ,IAAA;AACJ;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryDiagnostics.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryDiagnostics.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAW,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EACH,kCAAkC,EAElC,oBAAoB,EAGvB,MAAM,sCAAsC,CAAC;AAM9C,qBAAa,0BAA2B,YAAW,2BAA2B;IAWtE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAZxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqD;IAChF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBASrC,MAAM,EAAE,kBAAkB,EAC1B,eAAe,EAAE,MAAM,0BAA0B,GAAG,SAAS,EAC7D,mBAAmB,EAAE,MAAM,oBAAoB;IAMpE,IAAI,UAAU,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAE/D;IAGD,WAAW,IAAI,kCAAkC;IAOjD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMpD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC,OAAO,CAAC,4BAA4B;IAwBpC,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,gBAAgB;CAG3B"}
+{"version":3,"file":"ObservableQueryDiagnostics.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryDiagnostics.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAW,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EACH,kCAAkC,EAElC,oBAAoB,EAGvB,MAAM,sCAAsC,CAAC;AAM9C,qBAAa,0BAA2B,YAAW,2BAA2B;IAWtE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAZxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqD;IAChF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAQ1D,YACqB,MAAM,EAAE,kBAAkB,EAC1B,eAAe,EAAE,MAAM,0BAA0B,GAAG,SAAS,EAC7D,mBAAmB,EAAE,MAAM,oBAAoB,EAChE;IAKJ,IAAI,UAAU,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAE/D;IAGD,WAAW,IAAI,kCAAkC,CAIhD;IAGD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGnD;IAGD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGlC;IAED,OAAO,CAAC,4BAA4B;IAwBpC,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,gBAAgB;CAG3B"}

package/dist/esm/queries/ObservableQueryDiagnostics.js

@@ -1,29 +1,41 @@
 import { Subject } from 'rxjs';
 
-class ObservableQueryDiagnostics {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Implements the {@link IObservableQueryDiagnostics} contract by collecting live state from
+ * the {@link QueryInstanceCache} and the shared {@link ObservableQueryMultiplexer}.
+ */ class ObservableQueryDiagnostics {
     _cache;
     _getMultiplexer;
     _getTransportConfig;
     _snapshots = new Subject();
     _ownersByKey = new Map();
-    constructor(_cache, _getMultiplexer, _getTransportConfig) {
+    /**
+     * Initializes a new instance of {@link ObservableQueryDiagnostics}.
+     * @param _cache The {@link QueryInstanceCache} whose state will be reflected.
+     * @param _getMultiplexer Factory that returns the current shared multiplexer, or {@code undefined}.
+     * @param _getTransportConfig Factory that returns the current transport diagnostics.
+     */ constructor(_cache, _getMultiplexer, _getTransportConfig){
         this._cache = _cache;
         this._getMultiplexer = _getMultiplexer;
         this._getTransportConfig = _getTransportConfig;
     }
-    get snapshots$() {
+    /**
+     * Stream of diagnostics snapshots.
+     */ get snapshots$() {
         return this._snapshots.asObservable();
     }
-    getSnapshot() {
+    /** @inheritdoc */ getSnapshot() {
         const snapshot = this._createSnapshot();
         this._publishSnapshot(snapshot);
         return snapshot;
     }
-    beginTracking(cacheKey, owner) {
+    /** @inheritdoc */ beginTracking(cacheKey, owner) {
         this._ownersByKey.set(cacheKey, owner);
         this._publishSnapshot(this._createSnapshot());
     }
-    endTracking(cacheKey) {
+    /** @inheritdoc */ endTracking(cacheKey) {
         this._ownersByKey.delete(cacheKey);
         this._publishSnapshot(this._createSnapshot());
     }
@@ -35,17 +47,17 @@ class ObservableQueryDiagnostics {
                 configuredConnectionCount: 0,
                 effectiveConnectionCount: 0,
                 activeConnectionCount: 0,
-                connections: [],
+                connections: []
             };
         }
         const connections = mux.getConnectionsSnapshot();
-        const activeConnectionCount = connections.filter(c => c.isConnected).length;
+        const activeConnectionCount = connections.filter((c)=>c.isConnected).length;
         return {
             isConnected: activeConnectionCount > 0,
             configuredConnectionCount: connections.length,
             effectiveConnectionCount: connections.length,
             activeConnectionCount,
-            connections,
+            connections
         };
     }
     _createSnapshot() {
@@ -54,18 +66,21 @@ class ObservableQueryDiagnostics {
         const cache = this._cache.getDiagnosticsSnapshot();
         const ownersByQueryKey = {};
         const queriesByOwner = {};
-        for (const [key, owner] of this._ownersByKey) {
+        for (const [key, owner] of this._ownersByKey){
             ownersByQueryKey[key] = owner;
             if (!queriesByOwner[owner]) {
                 queriesByOwner[owner] = [];
             }
             queriesByOwner[owner].push(key);
         }
-        const ownership = { ownersByQueryKey, queriesByOwner };
-        const disconnectedQueryCount = multiplexer.connections.filter(c => !c.isConnected).length;
+        const ownership = {
+            ownersByQueryKey,
+            queriesByOwner
+        };
+        const disconnectedQueryCount = multiplexer.connections.filter((c)=>!c.isConnected).length;
         const health = {
             allQueriesConnected: multiplexer.isConnected && cache.healthy,
-            disconnectedQueryCount,
+            disconnectedQueryCount
         };
         return {
             health,
@@ -73,7 +88,7 @@ class ObservableQueryDiagnostics {
             multiplexer,
             cache,
             ownership,
-            timestamp: new Date().toISOString(),
+            timestamp: new Date().toISOString()
         };
     }
     _publishSnapshot(snapshot) {