@cratis/arc 20.54.5 → 20.55.0

package/dist/cjs/queries/ObservableQueryFor.js

@@ -14,7 +14,12 @@ var joinPaths = require('../joinPaths.js');
 var UrlHelpers = require('../UrlHelpers.js');
 var ParametersHelper = require('../reflection/ParametersHelper.js');
 
-class ObservableQueryFor {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/* eslint-disable @typescript-eslint/no-explicit-any */ /**
+ * Represents an implementation of {@link IQueryFor}.
+ * @template TDataType Type of data returned by the query.
+ */ class ObservableQueryFor {
     modelType;
     enumerable;
     _microservice;
@@ -23,10 +28,14 @@ class ObservableQueryFor {
     _connection;
     _httpHeadersCallback;
     roles = [];
-    queryName;
+    /** Backend fully-qualified query name used when subscribing via the SSE hub. Overridden in generated proxies. */ queryName;
     sorting;
     paging;
-    constructor(modelType, enumerable) {
+    /**
+     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.
+     * @param modelType Type of model, if an enumerable, this is the instance type.
+     * @param enumerable Whether or not it is an enumerable.
+     */ constructor(modelType, enumerable){
         this.modelType = modelType;
         this.enumerable = enumerable;
         this.sorting = Sorting.Sorting.none;
@@ -34,64 +43,77 @@ class ObservableQueryFor {
         this._microservice = Globals.Globals.microservice ?? '';
         this._apiBasePath = Globals.Globals.apiBasePath ?? '';
         this._origin = Globals.Globals.origin ?? '';
-        this._httpHeadersCallback = () => ({});
+        this._httpHeadersCallback = ()=>({});
     }
-    dispose() {
+    /**
+     * Disposes the query.
+     */ dispose() {
         this._connection?.disconnect();
     }
-    setMicroservice(microservice) {
+    /** @inheritdoc */ setMicroservice(microservice) {
         this._microservice = microservice;
     }
-    setApiBasePath(apiBasePath) {
+    /** @inheritdoc */ setApiBasePath(apiBasePath) {
         this._apiBasePath = apiBasePath;
     }
-    setOrigin(origin) {
+    /** @inheritdoc */ setOrigin(origin) {
         this._origin = origin;
     }
-    setHttpHeadersCallback(callback) {
+    /** @inheritdoc */ setHttpHeadersCallback(callback) {
         this._httpHeadersCallback = callback;
     }
-    subscribe(callback, args) {
+    /** @inheritdoc */ subscribe(callback, args) {
         if (this._connection) {
             this._connection.disconnect();
         }
         if (!this.validateArguments(args)) {
             this._connection = new NullObservableQueryConnection.NullObservableQueryConnection(this.defaultValue);
-        }
-        else {
+        } else {
             this._connection = ObservableQueryConnectionFactory.createObservableQueryConnection({
                 route: this.route,
                 queryName: this.queryName ?? this.constructor.name,
                 origin: this._origin,
                 apiBasePath: this._apiBasePath,
                 microservice: this._microservice,
-                args: args,
+                args: args
             });
         }
+        // Descriptor-backed instance properties provide defaults; fresh args passed to subscribe()
+        // must take precedence over any stale instance property values. Spread parameterValues
+        // first so that the caller-supplied args can override them.
+        //
+        // In direct mode the route arguments are already embedded in the URL path, so only
+        // the unused (non-route) parameters are appended as additional query arguments.
+        // In multiplexed mode ALL arguments — including route-derived ones — must be included
+        // in the subscribe payload so the server can execute the query correctly.
         const parameterValues = ParametersHelper.ParametersHelper.collectParameterValues(this);
         const { unusedParameters } = UrlHelpers.UrlHelpers.replaceRouteParameters(this.route, args);
         const connectionQueryArguments = {
             ...parameterValues,
-            ...(Globals.Globals.queryDirectMode ? unusedParameters : args || {}),
+            ...Globals.Globals.queryDirectMode ? unusedParameters : args || {},
             ...this.buildQueryArguments()
         };
         const subscriber = new ObservableQuerySubscription.ObservableQuerySubscription(this._connection);
-        this._connection.connect(data => {
+        this._connection.connect((data)=>{
             const result = data;
             try {
                 this.deserializeResult(result);
                 callback(result);
-            }
-            catch (ex) {
+            } catch (ex) {
                 console.log(ex);
             }
         }, connectionQueryArguments);
         return subscriber;
     }
-    async perform(args) {
-        const noSuccess = { ...QueryResult.QueryResult.noSuccess, ...{ data: this.defaultValue } };
+    /** @inheritdoc */ async perform(args) {
+        const noSuccess = {
+            ...QueryResult.QueryResult.noSuccess,
+            ...{
+                data: this.defaultValue
+            }
+        };
         if (!this.validateArguments(args)) {
-            return new Promise((resolve) => {
+            return new Promise((resolve)=>{
                 resolve(noSuccess);
             });
         }
@@ -104,17 +126,21 @@ class ObservableQueryFor {
         }
         if (this.sorting.hasSorting) {
             additionalParams.sortBy = this.sorting.field;
-            additionalParams.sortDirection = (this.sorting.direction === SortDirection.SortDirection.descending) ? 'desc' : 'asc';
+            additionalParams.sortDirection = this.sorting.direction === SortDirection.SortDirection.descending ? 'desc' : 'asc';
         }
+        // Collect parameter values from parameterDescriptors that are set
         const parameterValues = ParametersHelper.ParametersHelper.collectParameterValues(this);
-        const queryParams = UrlHelpers.UrlHelpers.buildQueryParams({ ...unusedParameters, ...parameterValues }, additionalParams);
+        const queryParams = UrlHelpers.UrlHelpers.buildQueryParams({
+            ...unusedParameters,
+            ...parameterValues
+        }, additionalParams);
         const queryString = queryParams.toString();
         if (queryString) {
             actualRoute += (actualRoute.includes('?') ? '&' : '?') + queryString;
         }
         const url = UrlHelpers.UrlHelpers.createUrlFrom(this._origin, this._apiBasePath, actualRoute);
         const headers = {
-            ...(this._httpHeadersCallback?.() || {}),
+            ...this._httpHeadersCallback?.() || {},
             'Accept': 'application/json',
             'Content-Type': 'application/json'
         };
@@ -128,14 +154,16 @@ class ObservableQueryFor {
         try {
             const result = await response.json();
             return new QueryResult.QueryResult(result, this.modelType, this.enumerable);
-        }
-        catch {
+        } catch  {
             return noSuccess;
         }
     }
     validateArguments(args) {
         const parameterValues = ParametersHelper.ParametersHelper.collectParameterValues(this);
-        const combinedArgs = { ...(args || {}), ...parameterValues };
+        const combinedArgs = {
+            ...args || {},
+            ...parameterValues
+        };
         return ValidateRequestArguments.ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, combinedArgs);
     }
     buildQueryArguments() {
@@ -146,7 +174,7 @@ class ObservableQueryFor {
         }
         if (this.sorting.hasSorting) {
             queryArguments.sortBy = this.sorting.field;
-            queryArguments.sortDirection = (this.sorting.direction === SortDirection.SortDirection.descending) ? 'desc' : 'asc';
+            queryArguments.sortDirection = this.sorting.direction === SortDirection.SortDirection.descending ? 'desc' : 'asc';
         }
         return queryArguments;
     }
@@ -154,12 +182,10 @@ class ObservableQueryFor {
         if (this.enumerable) {
             if (Array.isArray(result.data)) {
                 result.data = fundamentals.JsonSerializer.deserializeArrayFromInstance(this.modelType, result.data);
-            }
-            else {
+            } else {
                 result.data = [];
             }
-        }
-        else if (result.data) {
+        } else if (result.data) {
             result.data = fundamentals.JsonSerializer.deserializeFromInstance(this.modelType, result.data);
         }
     }

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryFor.js","sources":["../../../queries/ObservableQueryFor.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 { IObservableQueryFor, OnNextResult } from './IObservableQueryFor';\nimport { ObservableQuerySubscription } from './ObservableQuerySubscription';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { NullObservableQueryConnection } from './NullObservableQueryConnection';\nimport { createObservableQueryConnection } from './ObservableQueryConnectionFactory';\nimport { Constructor } from '@cratis/fundamentals';\nimport { JsonSerializer } from '@cratis/fundamentals';\nimport { QueryResult } from './QueryResult';\nimport { Sorting } from './Sorting';\nimport { Paging } from './Paging';\nimport { SortDirection } from './SortDirection';\nimport { Globals } from '../Globals';\nimport { joinPaths } from '../joinPaths';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class ObservableQueryFor<TDataType, TParameters = object> implements IObservableQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _connection?: IObservableQueryConnection<TDataType>;\n    private _httpHeadersCallback: GetHttpHeaders;\n\n    abstract readonly route: string;\n    abstract readonly defaultValue: TDataType;\n    readonly roles: string[] = [];\n    /** Backend fully-qualified query name used when subscribing via the SSE hub. Overridden in generated proxies. */\n    readonly queryName?: string;\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    sorting: Sorting;\n    paging: Paging;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /**\n     * Disposes the query.\n     */\n    dispose() {\n        this._connection?.disconnect();\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    subscribe(callback: OnNextResult<QueryResult<TDataType>>, args?: TParameters): ObservableQuerySubscription<TDataType> {\n        if (this._connection) {\n            this._connection.disconnect();\n        }\n\n        if (!this.validateArguments(args)) {\n            this._connection = new NullObservableQueryConnection(this.defaultValue);\n        } else {\n            this._connection = createObservableQueryConnection({\n                route: this.route,\n                queryName: this.queryName ?? this.constructor.name,\n                origin: this._origin,\n                apiBasePath: this._apiBasePath,\n                microservice: this._microservice,\n                args: args as object,\n            });\n        }\n\n        // Descriptor-backed instance properties provide defaults; fresh args passed to subscribe()\n        // must take precedence over any stale instance property values. Spread parameterValues\n        // first so that the caller-supplied args can override them.\n        //\n        // In direct mode the route arguments are already embedded in the URL path, so only\n        // the unused (non-route) parameters are appended as additional query arguments.\n        // In multiplexed mode ALL arguments — including route-derived ones — must be included\n        // in the subscribe payload so the server can execute the query correctly.\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const { unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        const connectionQueryArguments: any = {\n            ...parameterValues,\n            ...(Globals.queryDirectMode ? unusedParameters : (args as object) || {}),\n            ...this.buildQueryArguments()\n        };\n\n        const subscriber = new ObservableQuerySubscription(this._connection);\n        this._connection.connect(data => {\n            const result: any = data;\n            try {\n                this.deserializeResult(result);\n                callback(result);\n            } catch (ex) {\n                console.log(ex);\n            }\n        }, connectionQueryArguments);\n        return subscriber;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        if (!this.validateArguments(args)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        const { route, unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        let actualRoute = joinPaths(this._apiBasePath, route);\n        \n        const additionalParams: Record<string, string | number> = {};\n        if (this.paging.hasPaging) {\n            additionalParams.page = this.paging.page;\n            additionalParams.pageSize = this.paging.pageSize;\n        }\n\n        if (this.sorting.hasSorting) {\n            additionalParams.sortBy = this.sorting.field;\n            additionalParams.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const queryParams = UrlHelpers.buildQueryParams({ ...unusedParameters, ...parameterValues }, additionalParams);\n        const queryString = queryParams.toString();\n        if (queryString) {\n            actualRoute += (actualRoute.includes('?') ? '&' : '?') + queryString;\n        }\n\n        const url = UrlHelpers.createUrlFrom(this._origin, this._apiBasePath, actualRoute);\n\n        const headers = {\n            ...(this._httpHeadersCallback?.() || {}),\n            'Accept': 'application/json',\n            'Content-Type': 'application/json'\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await fetch(url, {\n            method: 'GET',\n            headers\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n\n    private validateArguments(args?: TParameters): boolean {\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const combinedArgs = { ...(args as object || {}), ...parameterValues };\n        return ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, combinedArgs as object);\n    }\n\n    private buildQueryArguments(): any {\n        const queryArguments: any = {};\n\n        if (this.paging && this.paging.pageSize > 0) {\n            queryArguments.pageSize = this.paging.pageSize;\n            queryArguments.page = this.paging.page;\n        }\n\n        if (this.sorting.hasSorting) {\n            queryArguments.sortBy = this.sorting.field;\n            queryArguments.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        return queryArguments;\n    }\n\n    private deserializeResult(result: any): void {\n        if (this.enumerable) {\n            if (Array.isArray(result.data)) {\n                result.data = JsonSerializer.deserializeArrayFromInstance(this.modelType, result.data);\n            } else {\n                result.data = [];\n            }\n        } else if (result.data) {\n            result.data = JsonSerializer.deserializeFromInstance(this.modelType, result.data);\n        }\n    }\n}\n"],"names":["Sorting","Paging","Globals","NullObservableQueryConnection","createObservableQueryConnection","ParametersHelper","UrlHelpers","ObservableQuerySubscription","QueryResult","joinPaths","SortDirection","ValidateRequestArguments","JsonSerializer"],"mappings":"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"}
+{"version":3,"file":"ObservableQueryFor.js","sources":["../../../queries/ObservableQueryFor.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 { IObservableQueryFor, OnNextResult } from './IObservableQueryFor';\nimport { ObservableQuerySubscription } from './ObservableQuerySubscription';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { NullObservableQueryConnection } from './NullObservableQueryConnection';\nimport { createObservableQueryConnection } from './ObservableQueryConnectionFactory';\nimport { Constructor } from '@cratis/fundamentals';\nimport { JsonSerializer } from '@cratis/fundamentals';\nimport { QueryResult } from './QueryResult';\nimport { Sorting } from './Sorting';\nimport { Paging } from './Paging';\nimport { SortDirection } from './SortDirection';\nimport { Globals } from '../Globals';\nimport { joinPaths } from '../joinPaths';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class ObservableQueryFor<TDataType, TParameters = object> implements IObservableQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _connection?: IObservableQueryConnection<TDataType>;\n    private _httpHeadersCallback: GetHttpHeaders;\n\n    abstract readonly route: string;\n    abstract readonly defaultValue: TDataType;\n    readonly roles: string[] = [];\n    /** Backend fully-qualified query name used when subscribing via the SSE hub. Overridden in generated proxies. */\n    readonly queryName?: string;\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    sorting: Sorting;\n    paging: Paging;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /**\n     * Disposes the query.\n     */\n    dispose() {\n        this._connection?.disconnect();\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    subscribe(callback: OnNextResult<QueryResult<TDataType>>, args?: TParameters): ObservableQuerySubscription<TDataType> {\n        if (this._connection) {\n            this._connection.disconnect();\n        }\n\n        if (!this.validateArguments(args)) {\n            this._connection = new NullObservableQueryConnection(this.defaultValue);\n        } else {\n            this._connection = createObservableQueryConnection({\n                route: this.route,\n                queryName: this.queryName ?? this.constructor.name,\n                origin: this._origin,\n                apiBasePath: this._apiBasePath,\n                microservice: this._microservice,\n                args: args as object,\n            });\n        }\n\n        // Descriptor-backed instance properties provide defaults; fresh args passed to subscribe()\n        // must take precedence over any stale instance property values. Spread parameterValues\n        // first so that the caller-supplied args can override them.\n        //\n        // In direct mode the route arguments are already embedded in the URL path, so only\n        // the unused (non-route) parameters are appended as additional query arguments.\n        // In multiplexed mode ALL arguments — including route-derived ones — must be included\n        // in the subscribe payload so the server can execute the query correctly.\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const { unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        const connectionQueryArguments: any = {\n            ...parameterValues,\n            ...(Globals.queryDirectMode ? unusedParameters : (args as object) || {}),\n            ...this.buildQueryArguments()\n        };\n\n        const subscriber = new ObservableQuerySubscription(this._connection);\n        this._connection.connect(data => {\n            const result: any = data;\n            try {\n                this.deserializeResult(result);\n                callback(result);\n            } catch (ex) {\n                console.log(ex);\n            }\n        }, connectionQueryArguments);\n        return subscriber;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        if (!this.validateArguments(args)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        const { route, unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        let actualRoute = joinPaths(this._apiBasePath, route);\n        \n        const additionalParams: Record<string, string | number> = {};\n        if (this.paging.hasPaging) {\n            additionalParams.page = this.paging.page;\n            additionalParams.pageSize = this.paging.pageSize;\n        }\n\n        if (this.sorting.hasSorting) {\n            additionalParams.sortBy = this.sorting.field;\n            additionalParams.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const queryParams = UrlHelpers.buildQueryParams({ ...unusedParameters, ...parameterValues }, additionalParams);\n        const queryString = queryParams.toString();\n        if (queryString) {\n            actualRoute += (actualRoute.includes('?') ? '&' : '?') + queryString;\n        }\n\n        const url = UrlHelpers.createUrlFrom(this._origin, this._apiBasePath, actualRoute);\n\n        const headers = {\n            ...(this._httpHeadersCallback?.() || {}),\n            'Accept': 'application/json',\n            'Content-Type': 'application/json'\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await fetch(url, {\n            method: 'GET',\n            headers\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n\n    private validateArguments(args?: TParameters): boolean {\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const combinedArgs = { ...(args as object || {}), ...parameterValues };\n        return ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, combinedArgs as object);\n    }\n\n    private buildQueryArguments(): any {\n        const queryArguments: any = {};\n\n        if (this.paging && this.paging.pageSize > 0) {\n            queryArguments.pageSize = this.paging.pageSize;\n            queryArguments.page = this.paging.page;\n        }\n\n        if (this.sorting.hasSorting) {\n            queryArguments.sortBy = this.sorting.field;\n            queryArguments.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        return queryArguments;\n    }\n\n    private deserializeResult(result: any): void {\n        if (this.enumerable) {\n            if (Array.isArray(result.data)) {\n                result.data = JsonSerializer.deserializeArrayFromInstance(this.modelType, result.data);\n            } else {\n                result.data = [];\n            }\n        } else if (result.data) {\n            result.data = JsonSerializer.deserializeFromInstance(this.modelType, result.data);\n        }\n    }\n}\n"],"names":["ObservableQueryFor","_microservice","_apiBasePath","_origin","_connection","_httpHeadersCallback","roles","queryName","sorting","paging","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","dispose","disconnect","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","subscribe","args","validateArguments","NullObservableQueryConnection","defaultValue","createObservableQueryConnection","route","name","parameterValues","ParametersHelper","collectParameterValues","unusedParameters","UrlHelpers","replaceRouteParameters","connectionQueryArguments","queryDirectMode","buildQueryArguments","subscriber","ObservableQuerySubscription","connect","data","result","deserializeResult","ex","console","log","perform","noSuccess","QueryResult","Promise","resolve","actualRoute","joinPaths","additionalParams","hasPaging","page","pageSize","hasSorting","sortBy","field","sortDirection","direction","SortDirection","descending","queryParams","buildQueryParams","queryString","toString","includes","url","createUrlFrom","headers","length","microserviceHttpHeader","response","fetch","method","json","combinedArgs","ValidateRequestArguments","requiredRequestParameters","queryArguments","Array","isArray","JsonSerializer","deserializeArrayFromInstance","deserializeFromInstance"],"mappings":"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"}

package/dist/cjs/queries/ObservableQueryMultiplexer.js

@@ -2,71 +2,105 @@
 
 var Globals = require('../Globals.js');
 
-const WS_HUB_ROUTE = '/.cratis/queries/ws';
-class ObservableQueryMultiplexer {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/* eslint-disable @typescript-eslint/no-explicit-any */ /**
+ * The WebSocket demultiplexer route used when connecting through the multiplexed observable query endpoint.
+ */ const WS_HUB_ROUTE = '/.cratis/queries/ws';
+/**
+ * Multiplexes multiple observable query subscriptions across a bounded pool of physical
+ * connections (WebSocket or SSE) to the backend demultiplexer.
+ *
+ * Each pool slot is a single multiplexed connection. When a new subscription is requested,
+ * the slot with the fewest active queries is chosen. This balances load across N physical
+ * connections while keeping the total connection count bounded.
+ */ class ObservableQueryMultiplexer {
     _connections;
     _size;
-    constructor(size, connectionFactory) {
+    /**
+     * Initializes a new {@link ObservableQueryMultiplexer}.
+     * @param {number} size Number of physical connections (pool slots).
+     * @param {() => IObservableQueryHubConnection} connectionFactory Factory function to create each connection.
+     */ constructor(size, connectionFactory){
         this._size = Math.max(1, size);
-        this._connections = Array.from({ length: this._size }, () => connectionFactory());
+        this._connections = Array.from({
+            length: this._size
+        }, ()=>connectionFactory());
     }
-    get size() {
+    /**
+     * Gets the pool size.
+     */ get size() {
         return this._size;
     }
-    get lastPingLatency() {
-        return this._connections.reduce((min, c) => c.lastPingLatency > 0 && c.lastPingLatency < min ? c.lastPingLatency : min, Number.MAX_SAFE_INTEGER);
-    }
-    get averageLatency() {
-        const active = this._connections.filter(c => c.averageLatency > 0);
-        if (active.length === 0)
-            return 0;
-        return active.reduce((sum, c) => sum + c.averageLatency, 0) / active.length;
-    }
-    subscribe(queryName, queryArguments, callback) {
+    /**
+     * Gets the best available ping latency across all connections.
+     */ get lastPingLatency() {
+        return this._connections.reduce((min, c)=>c.lastPingLatency > 0 && c.lastPingLatency < min ? c.lastPingLatency : min, Number.MAX_SAFE_INTEGER);
+    }
+    /**
+     * Gets the average latency across all connections.
+     */ get averageLatency() {
+        const active = this._connections.filter((c)=>c.averageLatency > 0);
+        if (active.length === 0) return 0;
+        return active.reduce((sum, c)=>sum + c.averageLatency, 0) / active.length;
+    }
+    /**
+     * Subscribe to a query through the multiplexer. Picks the least-loaded connection
+     * and sends a Subscribe message on it.
+     * @param {string} queryName Fully qualified backend query name.
+     * @param {object} queryArguments Flat query arguments (incl. page, pageSize, sortBy, sortDirection).
+     * @param {DataReceived<any>} callback Callback invoked for each result.
+     * @returns A cleanup function that unsubscribes from the query.
+     */ subscribe(queryName, queryArguments, callback) {
         const request = this.buildSubscriptionRequest(queryName, queryArguments);
         const conn = this.leastLoaded();
         const queryId = this.generateQueryId();
         conn.subscribe(queryId, request, callback);
-        return () => {
+        return ()=>{
             conn.unsubscribe(queryId);
         };
     }
-    dispose() {
-        for (const conn of this._connections) {
+    /**
+     * Dispose all connections in the multiplexer.
+     */ dispose() {
+        for (const conn of this._connections){
             conn.dispose();
         }
     }
     leastLoaded() {
-        return this._connections.reduce((min, c) => c.queryCount < min.queryCount ? c : min, this._connections[0]);
+        return this._connections.reduce((min, c)=>c.queryCount < min.queryCount ? c : min, this._connections[0]);
     }
     generateQueryId() {
+        // Use crypto.randomUUID when available, fall back to timestamp + random
         if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
             return crypto.randomUUID();
         }
         return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
     }
     buildSubscriptionRequest(queryName, args) {
-        const request = { queryName };
+        const request = {
+            queryName
+        };
+        // Always include the transfer mode so the server knows which emission strategy to use.
         request.transferMode = Globals.Globals.observableQueryTransferMode;
-        if (!args)
-            return request;
+        if (!args) return request;
         const a = args;
-        const pagingAndSortingKeys = new Set(['page', 'pageSize', 'sortBy', 'sortDirection']);
-        if (a.page !== undefined && a.page !== null)
-            request.page = Number(a.page);
-        if (a.pageSize !== undefined && a.pageSize !== null)
-            request.pageSize = Number(a.pageSize);
-        if (a.sortBy !== undefined && a.sortBy !== null)
-            request.sortBy = String(a.sortBy);
-        if (a.sortDirection !== undefined && a.sortDirection !== null)
-            request.sortDirection = String(a.sortDirection);
+        const pagingAndSortingKeys = new Set([
+            'page',
+            'pageSize',
+            'sortBy',
+            'sortDirection'
+        ]);
+        if (a.page !== undefined && a.page !== null) request.page = Number(a.page);
+        if (a.pageSize !== undefined && a.pageSize !== null) request.pageSize = Number(a.pageSize);
+        if (a.sortBy !== undefined && a.sortBy !== null) request.sortBy = String(a.sortBy);
+        if (a.sortDirection !== undefined && a.sortDirection !== null) request.sortDirection = String(a.sortDirection);
+        // Everything else goes into arguments as string key-value pairs
         const remaining = {};
         let hasRemaining = false;
-        for (const [key, value] of Object.entries(a)) {
-            if (pagingAndSortingKeys.has(key))
-                continue;
-            if (value === undefined || value === null)
-                continue;
+        for (const [key, value] of Object.entries(a)){
+            if (pagingAndSortingKeys.has(key)) continue;
+            if (value === undefined || value === null) continue;
             remaining[key] = String(value);
             hasRemaining = true;
         }
@@ -75,39 +109,58 @@ class ObservableQueryMultiplexer {
         }
         return request;
     }
-    getConnectionsSnapshot() {
-        return this._connections.map((conn, index) => ({
-            index,
-            isConnected: conn.isConnected,
-            queryCount: conn.queryCount,
-        }));
+    /**
+     * Returns a snapshot of the per-connection state for diagnostics.
+     * @returns An array describing each slot in the connection pool.
+     */ getConnectionsSnapshot() {
+        return this._connections.map((conn, index)=>({
+                index,
+                isConnected: conn.isConnected,
+                queryCount: conn.queryCount
+            }));
     }
 }
-class MultiplexedObservableQueryConnection {
+/**
+ * Wraps an {@link ObservableQueryMultiplexer} subscription as an {@link IObservableQueryConnection},
+ * allowing the multiplexed transport to plug into the existing query subscription pipeline
+ * without changes to callers.
+ */ class MultiplexedObservableQueryConnection {
     _pool;
     _queryName;
     _cleanup;
-    constructor(_pool, _queryName) {
+    /**
+     * Initializes a new {@link MultiplexedObservableQueryConnection}.
+     * @param {ObservableQueryMultiplexer} multiplexer The shared multiplexer.
+     * @param {string} queryName The fully qualified backend query name.
+     */ constructor(_pool, _queryName){
         this._pool = _pool;
         this._queryName = _queryName;
     }
-    get lastPingLatency() {
+    /** @inheritdoc */ get lastPingLatency() {
         return this._pool.lastPingLatency;
     }
-    get averageLatency() {
+    /** @inheritdoc */ get averageLatency() {
         return this._pool.averageLatency;
     }
-    connect(dataReceived, queryArguments) {
+    /** @inheritdoc */ connect(dataReceived, queryArguments) {
         this._cleanup = this._pool.subscribe(this._queryName, queryArguments, dataReceived);
     }
-    disconnect() {
+    /** @inheritdoc */ disconnect() {
         this._cleanup?.();
         this._cleanup = undefined;
     }
 }
+// ----- Shared pool singleton management -----
 let _sharedMultiplexer;
 let _sharedMultiplexerKey = '';
-function getOrCreateMultiplexer(connectionFactory, cacheKey, size = Globals.Globals.queryConnectionCount) {
+/**
+ * Returns the shared {@link ObservableQueryMultiplexer}, creating or re-creating it when the
+ * configuration (connection count, origin, base path, microservice, transport) changes.
+ * @param {() => IObservableQueryHubConnection} connectionFactory Factory to create individual connections.
+ * @param {string} cacheKey A string that identifies the current configuration for invalidation.
+ * @param {number} size Number of physical connections to create. Defaults to {@link Globals.queryConnectionCount}.
+ * @returns The shared multiplexer instance.
+ */ function getOrCreateMultiplexer(connectionFactory, cacheKey, size = Globals.Globals.queryConnectionCount) {
     if (_sharedMultiplexer && _sharedMultiplexerKey === cacheKey) {
         return _sharedMultiplexer;
     }
@@ -116,12 +169,17 @@ function getOrCreateMultiplexer(connectionFactory, cacheKey, size = Globals.Glob
     _sharedMultiplexerKey = cacheKey;
     return _sharedMultiplexer;
 }
-function resetSharedMultiplexer() {
+/**
+ * Disposes and clears the shared multiplexer singleton.
+ * Intended for use in test teardown to prevent state leakage across tests.
+ */ function resetSharedMultiplexer() {
     _sharedMultiplexer?.dispose();
     _sharedMultiplexer = undefined;
     _sharedMultiplexerKey = '';
 }
-function getSharedMultiplexer() {
+/**
+ * Returns the current shared multiplexer instance, or {@code undefined} if none has been created yet.
+ */ function getSharedMultiplexer() {
     return _sharedMultiplexer;
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryMultiplexer.js","sources":["../../../queries/ObservableQueryMultiplexer.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 { IObservableQueryHubConnection } from './IObservableQueryHubConnection';\nimport { DataReceived } from './ObservableQueryConnection';\nimport { SubscriptionRequest } from './WebSocketHubConnection';\nimport { Globals } from '../Globals';\nimport { MultiplexerConnectionState } from './ObservableQueryDiagnosticsSnapshot';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * The WebSocket demultiplexer route used when connecting through the multiplexed observable query endpoint.\n */\nexport const WS_HUB_ROUTE = '/.cratis/queries/ws';\n\n/**\n * Multiplexes multiple observable query subscriptions across a bounded pool of physical\n * connections (WebSocket or SSE) to the backend demultiplexer.\n *\n * Each pool slot is a single multiplexed connection. When a new subscription is requested,\n * the slot with the fewest active queries is chosen. This balances load across N physical\n * connections while keeping the total connection count bounded.\n */\nexport class ObservableQueryMultiplexer {\n    private readonly _connections: IObservableQueryHubConnection[];\n    private readonly _size: number;\n\n    /**\n     * Initializes a new {@link ObservableQueryMultiplexer}.\n     * @param {number} size Number of physical connections (pool slots).\n     * @param {() => IObservableQueryHubConnection} connectionFactory Factory function to create each connection.\n     */\n    constructor(size: number, connectionFactory: () => IObservableQueryHubConnection) {\n        this._size = Math.max(1, size);\n        this._connections = Array.from({ length: this._size }, () => connectionFactory());\n    }\n\n    /**\n     * Gets the pool size.\n     */\n    get size(): number {\n        return this._size;\n    }\n\n    /**\n     * Gets the best available ping latency across all connections.\n     */\n    get lastPingLatency(): number {\n        return this._connections.reduce((min, c) =>\n            c.lastPingLatency > 0 && c.lastPingLatency < min ? c.lastPingLatency : min,\n            Number.MAX_SAFE_INTEGER\n        );\n    }\n\n    /**\n     * Gets the average latency across all connections.\n     */\n    get averageLatency(): number {\n        const active = this._connections.filter(c => c.averageLatency > 0);\n        if (active.length === 0) return 0;\n        return active.reduce((sum, c) => sum + c.averageLatency, 0) / active.length;\n    }\n\n    /**\n     * Subscribe to a query through the multiplexer. Picks the least-loaded connection\n     * and sends a Subscribe message on it.\n     * @param {string} queryName Fully qualified backend query name.\n     * @param {object} queryArguments Flat query arguments (incl. page, pageSize, sortBy, sortDirection).\n     * @param {DataReceived<any>} callback Callback invoked for each result.\n     * @returns A cleanup function that unsubscribes from the query.\n     */\n    subscribe(queryName: string, queryArguments: object | undefined, callback: DataReceived<any>): () => void {\n        const request = this.buildSubscriptionRequest(queryName, queryArguments);\n        const conn = this.leastLoaded();\n        const queryId = this.generateQueryId();\n\n        conn.subscribe(queryId, request, callback);\n\n        return () => {\n            conn.unsubscribe(queryId);\n        };\n    }\n\n    /**\n     * Dispose all connections in the multiplexer.\n     */\n    dispose(): void {\n        for (const conn of this._connections) {\n            conn.dispose();\n        }\n    }\n\n    private leastLoaded(): IObservableQueryHubConnection {\n        return this._connections.reduce((min, c) =>\n            c.queryCount < min.queryCount ? c : min, this._connections[0]);\n    }\n\n    private generateQueryId(): string {\n        // Use crypto.randomUUID when available, fall back to timestamp + random\n        if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n            return crypto.randomUUID();\n        }\n        return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;\n    }\n\n    private buildSubscriptionRequest(queryName: string, args?: object): SubscriptionRequest {\n        const request: SubscriptionRequest = { queryName };\n\n        // Always include the transfer mode so the server knows which emission strategy to use.\n        request.transferMode = Globals.observableQueryTransferMode;\n\n        if (!args) return request;\n\n        const a = args as Record<string, any>;\n        const pagingAndSortingKeys = new Set(['page', 'pageSize', 'sortBy', 'sortDirection']);\n\n        if (a.page !== undefined && a.page !== null) request.page = Number(a.page);\n        if (a.pageSize !== undefined && a.pageSize !== null) request.pageSize = Number(a.pageSize);\n        if (a.sortBy !== undefined && a.sortBy !== null) request.sortBy = String(a.sortBy);\n        if (a.sortDirection !== undefined && a.sortDirection !== null) request.sortDirection = String(a.sortDirection);\n\n        // Everything else goes into arguments as string key-value pairs\n        const remaining: Record<string, string | null> = {};\n        let hasRemaining = false;\n\n        for (const [key, value] of Object.entries(a)) {\n            if (pagingAndSortingKeys.has(key)) continue;\n            if (value === undefined || value === null) continue;\n            remaining[key] = String(value);\n            hasRemaining = true;\n        }\n\n        if (hasRemaining) {\n            request.arguments = remaining;\n        }\n\n        return request;\n    }\n\n    /**\n     * Returns a snapshot of the per-connection state for diagnostics.\n     * @returns An array describing each slot in the connection pool.\n     */\n    getConnectionsSnapshot(): MultiplexerConnectionState[] {\n        return this._connections.map((conn, index) => ({\n            index,\n            isConnected: conn.isConnected,\n            queryCount: conn.queryCount,\n        }));\n    }\n}\n\n/**\n * Wraps an {@link ObservableQueryMultiplexer} subscription as an {@link IObservableQueryConnection},\n * allowing the multiplexed transport to plug into the existing query subscription pipeline\n * without changes to callers.\n */\nexport class MultiplexedObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    private _cleanup?: () => void;\n\n    /**\n     * Initializes a new {@link MultiplexedObservableQueryConnection}.\n     * @param {ObservableQueryMultiplexer} multiplexer The shared multiplexer.\n     * @param {string} queryName The fully qualified backend query name.\n     */\n    constructor(\n        private readonly _pool: ObservableQueryMultiplexer,\n        private readonly _queryName: string,\n    ) {\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return this._pool.lastPingLatency;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        return this._pool.averageLatency;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>, queryArguments?: object): void {\n        this._cleanup = this._pool.subscribe(\n            this._queryName,\n            queryArguments,\n            dataReceived as DataReceived<any>,\n        );\n    }\n\n    /** @inheritdoc */\n    disconnect(): void {\n        this._cleanup?.();\n        this._cleanup = undefined;\n    }\n}\n\n// ----- Shared pool singleton management -----\n\nlet _sharedMultiplexer: ObservableQueryMultiplexer | undefined;\nlet _sharedMultiplexerKey = '';\n\n/**\n * Returns the shared {@link ObservableQueryMultiplexer}, creating or re-creating it when the\n * configuration (connection count, origin, base path, microservice, transport) changes.\n * @param {() => IObservableQueryHubConnection} connectionFactory Factory to create individual connections.\n * @param {string} cacheKey A string that identifies the current configuration for invalidation.\n * @param {number} size Number of physical connections to create. Defaults to {@link Globals.queryConnectionCount}.\n * @returns The shared multiplexer instance.\n */\nexport function getOrCreateMultiplexer(connectionFactory: () => IObservableQueryHubConnection, cacheKey: string, size: number = Globals.queryConnectionCount): ObservableQueryMultiplexer {\n    if (_sharedMultiplexer && _sharedMultiplexerKey === cacheKey) {\n        return _sharedMultiplexer;\n    }\n\n    _sharedMultiplexer?.dispose();\n    _sharedMultiplexer = new ObservableQueryMultiplexer(size, connectionFactory);\n    _sharedMultiplexerKey = cacheKey;\n    return _sharedMultiplexer;\n}\n\n/**\n * Disposes and clears the shared multiplexer singleton.\n * Intended for use in test teardown to prevent state leakage across tests.\n */\nexport function resetSharedMultiplexer(): void {\n    _sharedMultiplexer?.dispose();\n    _sharedMultiplexer = undefined;\n    _sharedMultiplexerKey = '';\n}\n\n/**\n * Returns the current shared multiplexer instance, or {@code undefined} if none has been created yet.\n */\nexport function getSharedMultiplexer(): ObservableQueryMultiplexer | undefined {\n    return _sharedMultiplexer;\n}\n"],"names":["Globals"],"mappings":"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"}
+{"version":3,"file":"ObservableQueryMultiplexer.js","sources":["../../../queries/ObservableQueryMultiplexer.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 { IObservableQueryHubConnection } from './IObservableQueryHubConnection';\nimport { DataReceived } from './ObservableQueryConnection';\nimport { SubscriptionRequest } from './WebSocketHubConnection';\nimport { Globals } from '../Globals';\nimport { MultiplexerConnectionState } from './ObservableQueryDiagnosticsSnapshot';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * The WebSocket demultiplexer route used when connecting through the multiplexed observable query endpoint.\n */\nexport const WS_HUB_ROUTE = '/.cratis/queries/ws';\n\n/**\n * Multiplexes multiple observable query subscriptions across a bounded pool of physical\n * connections (WebSocket or SSE) to the backend demultiplexer.\n *\n * Each pool slot is a single multiplexed connection. When a new subscription is requested,\n * the slot with the fewest active queries is chosen. This balances load across N physical\n * connections while keeping the total connection count bounded.\n */\nexport class ObservableQueryMultiplexer {\n    private readonly _connections: IObservableQueryHubConnection[];\n    private readonly _size: number;\n\n    /**\n     * Initializes a new {@link ObservableQueryMultiplexer}.\n     * @param {number} size Number of physical connections (pool slots).\n     * @param {() => IObservableQueryHubConnection} connectionFactory Factory function to create each connection.\n     */\n    constructor(size: number, connectionFactory: () => IObservableQueryHubConnection) {\n        this._size = Math.max(1, size);\n        this._connections = Array.from({ length: this._size }, () => connectionFactory());\n    }\n\n    /**\n     * Gets the pool size.\n     */\n    get size(): number {\n        return this._size;\n    }\n\n    /**\n     * Gets the best available ping latency across all connections.\n     */\n    get lastPingLatency(): number {\n        return this._connections.reduce((min, c) =>\n            c.lastPingLatency > 0 && c.lastPingLatency < min ? c.lastPingLatency : min,\n            Number.MAX_SAFE_INTEGER\n        );\n    }\n\n    /**\n     * Gets the average latency across all connections.\n     */\n    get averageLatency(): number {\n        const active = this._connections.filter(c => c.averageLatency > 0);\n        if (active.length === 0) return 0;\n        return active.reduce((sum, c) => sum + c.averageLatency, 0) / active.length;\n    }\n\n    /**\n     * Subscribe to a query through the multiplexer. Picks the least-loaded connection\n     * and sends a Subscribe message on it.\n     * @param {string} queryName Fully qualified backend query name.\n     * @param {object} queryArguments Flat query arguments (incl. page, pageSize, sortBy, sortDirection).\n     * @param {DataReceived<any>} callback Callback invoked for each result.\n     * @returns A cleanup function that unsubscribes from the query.\n     */\n    subscribe(queryName: string, queryArguments: object | undefined, callback: DataReceived<any>): () => void {\n        const request = this.buildSubscriptionRequest(queryName, queryArguments);\n        const conn = this.leastLoaded();\n        const queryId = this.generateQueryId();\n\n        conn.subscribe(queryId, request, callback);\n\n        return () => {\n            conn.unsubscribe(queryId);\n        };\n    }\n\n    /**\n     * Dispose all connections in the multiplexer.\n     */\n    dispose(): void {\n        for (const conn of this._connections) {\n            conn.dispose();\n        }\n    }\n\n    private leastLoaded(): IObservableQueryHubConnection {\n        return this._connections.reduce((min, c) =>\n            c.queryCount < min.queryCount ? c : min, this._connections[0]);\n    }\n\n    private generateQueryId(): string {\n        // Use crypto.randomUUID when available, fall back to timestamp + random\n        if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n            return crypto.randomUUID();\n        }\n        return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;\n    }\n\n    private buildSubscriptionRequest(queryName: string, args?: object): SubscriptionRequest {\n        const request: SubscriptionRequest = { queryName };\n\n        // Always include the transfer mode so the server knows which emission strategy to use.\n        request.transferMode = Globals.observableQueryTransferMode;\n\n        if (!args) return request;\n\n        const a = args as Record<string, any>;\n        const pagingAndSortingKeys = new Set(['page', 'pageSize', 'sortBy', 'sortDirection']);\n\n        if (a.page !== undefined && a.page !== null) request.page = Number(a.page);\n        if (a.pageSize !== undefined && a.pageSize !== null) request.pageSize = Number(a.pageSize);\n        if (a.sortBy !== undefined && a.sortBy !== null) request.sortBy = String(a.sortBy);\n        if (a.sortDirection !== undefined && a.sortDirection !== null) request.sortDirection = String(a.sortDirection);\n\n        // Everything else goes into arguments as string key-value pairs\n        const remaining: Record<string, string | null> = {};\n        let hasRemaining = false;\n\n        for (const [key, value] of Object.entries(a)) {\n            if (pagingAndSortingKeys.has(key)) continue;\n            if (value === undefined || value === null) continue;\n            remaining[key] = String(value);\n            hasRemaining = true;\n        }\n\n        if (hasRemaining) {\n            request.arguments = remaining;\n        }\n\n        return request;\n    }\n\n    /**\n     * Returns a snapshot of the per-connection state for diagnostics.\n     * @returns An array describing each slot in the connection pool.\n     */\n    getConnectionsSnapshot(): MultiplexerConnectionState[] {\n        return this._connections.map((conn, index) => ({\n            index,\n            isConnected: conn.isConnected,\n            queryCount: conn.queryCount,\n        }));\n    }\n}\n\n/**\n * Wraps an {@link ObservableQueryMultiplexer} subscription as an {@link IObservableQueryConnection},\n * allowing the multiplexed transport to plug into the existing query subscription pipeline\n * without changes to callers.\n */\nexport class MultiplexedObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    private _cleanup?: () => void;\n\n    /**\n     * Initializes a new {@link MultiplexedObservableQueryConnection}.\n     * @param {ObservableQueryMultiplexer} multiplexer The shared multiplexer.\n     * @param {string} queryName The fully qualified backend query name.\n     */\n    constructor(\n        private readonly _pool: ObservableQueryMultiplexer,\n        private readonly _queryName: string,\n    ) {\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return this._pool.lastPingLatency;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        return this._pool.averageLatency;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>, queryArguments?: object): void {\n        this._cleanup = this._pool.subscribe(\n            this._queryName,\n            queryArguments,\n            dataReceived as DataReceived<any>,\n        );\n    }\n\n    /** @inheritdoc */\n    disconnect(): void {\n        this._cleanup?.();\n        this._cleanup = undefined;\n    }\n}\n\n// ----- Shared pool singleton management -----\n\nlet _sharedMultiplexer: ObservableQueryMultiplexer | undefined;\nlet _sharedMultiplexerKey = '';\n\n/**\n * Returns the shared {@link ObservableQueryMultiplexer}, creating or re-creating it when the\n * configuration (connection count, origin, base path, microservice, transport) changes.\n * @param {() => IObservableQueryHubConnection} connectionFactory Factory to create individual connections.\n * @param {string} cacheKey A string that identifies the current configuration for invalidation.\n * @param {number} size Number of physical connections to create. Defaults to {@link Globals.queryConnectionCount}.\n * @returns The shared multiplexer instance.\n */\nexport function getOrCreateMultiplexer(connectionFactory: () => IObservableQueryHubConnection, cacheKey: string, size: number = Globals.queryConnectionCount): ObservableQueryMultiplexer {\n    if (_sharedMultiplexer && _sharedMultiplexerKey === cacheKey) {\n        return _sharedMultiplexer;\n    }\n\n    _sharedMultiplexer?.dispose();\n    _sharedMultiplexer = new ObservableQueryMultiplexer(size, connectionFactory);\n    _sharedMultiplexerKey = cacheKey;\n    return _sharedMultiplexer;\n}\n\n/**\n * Disposes and clears the shared multiplexer singleton.\n * Intended for use in test teardown to prevent state leakage across tests.\n */\nexport function resetSharedMultiplexer(): void {\n    _sharedMultiplexer?.dispose();\n    _sharedMultiplexer = undefined;\n    _sharedMultiplexerKey = '';\n}\n\n/**\n * Returns the current shared multiplexer instance, or {@code undefined} if none has been created yet.\n */\nexport function getSharedMultiplexer(): ObservableQueryMultiplexer | undefined {\n    return _sharedMultiplexer;\n}\n"],"names":["WS_HUB_ROUTE","ObservableQueryMultiplexer","_connections","_size","size","connectionFactory","Math","max","Array","from","length","lastPingLatency","reduce","min","c","Number","MAX_SAFE_INTEGER","averageLatency","active","filter","sum","subscribe","queryName","queryArguments","callback","request","buildSubscriptionRequest","conn","leastLoaded","queryId","generateQueryId","unsubscribe","dispose","queryCount","crypto","randomUUID","Date","now","random","toString","substring","args","transferMode","Globals","observableQueryTransferMode","a","pagingAndSortingKeys","Set","page","undefined","pageSize","sortBy","String","sortDirection","remaining","hasRemaining","key","value","Object","entries","has","arguments","getConnectionsSnapshot","map","index","isConnected","MultiplexedObservableQueryConnection","_cleanup","_queryName","_pool","connect","dataReceived","disconnect","_sharedMultiplexer","_sharedMultiplexerKey","getOrCreateMultiplexer","cacheKey","queryConnectionCount","resetSharedMultiplexer","getSharedMultiplexer"],"mappings":"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"}

package/dist/cjs/queries/ObservableQuerySubscription.js

@@ -1,11 +1,20 @@
 'use strict';
 
-class ObservableQuerySubscription {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents a subscription for an observable query.
+ */ class ObservableQuerySubscription {
     _connection;
-    constructor(_connection) {
+    /**
+     * Initializes a new instance of the {@link ObservableQuerySubscription} class.
+     * @param {ObservableQueryConnection<TDataType> _connection The connection to use.
+     */ constructor(_connection){
         this._connection = _connection;
     }
-    unsubscribe() {
+    /**
+     * Unsubscribe subscription.
+     */ unsubscribe() {
         if (this._connection) {
             this._connection.disconnect();
             this._connection = undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQuerySubscription.js","sources":["../../../queries/ObservableQuerySubscription.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';\n\n/**\n * Represents a subscription for an observable query.\n */\nexport class ObservableQuerySubscription<TDataType> {\n\n    /**\n     * Initializes a new instance of the {@link ObservableQuerySubscription} class.\n     * @param {ObservableQueryConnection<TDataType> _connection The connection to use.\n     */\n    constructor(private _connection: IObservableQueryConnection<TDataType>) {\n    }\n\n    /**\n     * Unsubscribe subscription.\n     */\n    unsubscribe() {\n        if (this._connection) {\n            this._connection.disconnect();\n            this._connection = undefined!;\n        }\n    }\n}\n"],"names":[],"mappings":";;MAQa,2BAA2B,CAAA;AAMhB,IAAA,WAAA;AAApB,IAAA,WAAA,CAAoB,WAAkD,EAAA;QAAlD,IAAA,CAAA,WAAW,GAAX,WAAW;IAC/B;IAKA,WAAW,GAAA;AACP,QAAA,IAAI,IAAI,CAAC,WAAW,EAAE;AAClB,YAAA,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE;AAC7B,YAAA,IAAI,CAAC,WAAW,GAAG,SAAU;QACjC;IACJ;AACH;;;;"}
+{"version":3,"file":"ObservableQuerySubscription.js","sources":["../../../queries/ObservableQuerySubscription.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';\n\n/**\n * Represents a subscription for an observable query.\n */\nexport class ObservableQuerySubscription<TDataType> {\n\n    /**\n     * Initializes a new instance of the {@link ObservableQuerySubscription} class.\n     * @param {ObservableQueryConnection<TDataType> _connection The connection to use.\n     */\n    constructor(private _connection: IObservableQueryConnection<TDataType>) {\n    }\n\n    /**\n     * Unsubscribe subscription.\n     */\n    unsubscribe() {\n        if (this._connection) {\n            this._connection.disconnect();\n            this._connection = undefined!;\n        }\n    }\n}\n"],"names":["ObservableQuerySubscription","_connection","unsubscribe","disconnect","undefined"],"mappings":";;AAAA;AACA;AAIA;;AAEC,IACM,MAAMA,2BAAAA,CAAAA;;AAET;;;QAIA,WAAA,CAAY,WAA0D,CAAE;aAApDC,WAAAA,GAAAA,WAAAA;AACpB,IAAA;AAEA;;AAEC,QACDC,WAAAA,GAAc;QACV,IAAI,IAAI,CAACD,WAAW,EAAE;YAClB,IAAI,CAACA,WAAW,CAACE,UAAU,EAAA;YAC3B,IAAI,CAACF,WAAW,GAAGG,SAAAA;AACvB,QAAA;AACJ,IAAA;AACJ;;;;"}