@cratis/arc 20.54.5 → 20.55.0

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryDiagnostics.js","sources":["../../../queries/ObservableQueryDiagnostics.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 { Observable, Subject } from 'rxjs';\nimport { QueryInstanceCache } from './QueryInstanceCache';\nimport { ObservableQueryMultiplexer } from './ObservableQueryMultiplexer';\nimport { IObservableQueryDiagnostics } from './IObservableQueryDiagnostics';\nimport {\n    ObservableQueryDiagnosticsSnapshot,\n    MultiplexerDiagnostics,\n    TransportDiagnostics,\n    HealthDiagnostics,\n    OwnershipDiagnostics,\n} from './ObservableQueryDiagnosticsSnapshot';\n\n/**\n * Implements the {@link IObservableQueryDiagnostics} contract by collecting live state from\n * the {@link QueryInstanceCache} and the shared {@link ObservableQueryMultiplexer}.\n */\nexport class ObservableQueryDiagnostics implements IObservableQueryDiagnostics {\n    private readonly _snapshots = new Subject<ObservableQueryDiagnosticsSnapshot>();\n    private readonly _ownersByKey = new Map<string, string>();\n\n    /**\n     * Initializes a new instance of {@link ObservableQueryDiagnostics}.\n     * @param _cache The {@link QueryInstanceCache} whose state will be reflected.\n     * @param _getMultiplexer Factory that returns the current shared multiplexer, or {@code undefined}.\n     * @param _getTransportConfig Factory that returns the current transport diagnostics.\n     */\n    constructor(\n        private readonly _cache: QueryInstanceCache,\n        private readonly _getMultiplexer: () => ObservableQueryMultiplexer | undefined,\n        private readonly _getTransportConfig: () => TransportDiagnostics,\n    ) {}\n\n    /**\n     * Stream of diagnostics snapshots.\n     */\n    get snapshots$(): Observable<ObservableQueryDiagnosticsSnapshot> {\n        return this._snapshots.asObservable();\n    }\n\n    /** @inheritdoc */\n    getSnapshot(): ObservableQueryDiagnosticsSnapshot {\n        const snapshot = this._createSnapshot();\n        this._publishSnapshot(snapshot);\n        return snapshot;\n    }\n\n    /** @inheritdoc */\n    beginTracking(cacheKey: string, owner: string): void {\n        this._ownersByKey.set(cacheKey, owner);\n        this._publishSnapshot(this._createSnapshot());\n    }\n\n    /** @inheritdoc */\n    endTracking(cacheKey: string): void {\n        this._ownersByKey.delete(cacheKey);\n        this._publishSnapshot(this._createSnapshot());\n    }\n\n    private _buildMultiplexerDiagnostics(): MultiplexerDiagnostics {\n        const mux = this._getMultiplexer();\n        if (!mux) {\n            return {\n                isConnected: false,\n                configuredConnectionCount: 0,\n                effectiveConnectionCount: 0,\n                activeConnectionCount: 0,\n                connections: [],\n            };\n        }\n\n        const connections = mux.getConnectionsSnapshot();\n        const activeConnectionCount = connections.filter(c => c.isConnected).length;\n\n        return {\n            isConnected: activeConnectionCount > 0,\n            configuredConnectionCount: connections.length,\n            effectiveConnectionCount: connections.length,\n            activeConnectionCount,\n            connections,\n        };\n    }\n\n    private _createSnapshot(): ObservableQueryDiagnosticsSnapshot {\n        const transport = this._getTransportConfig();\n        const multiplexer = this._buildMultiplexerDiagnostics();\n        const cache = this._cache.getDiagnosticsSnapshot();\n\n        const ownersByQueryKey: Record<string, string> = {};\n        const queriesByOwner: Record<string, string[]> = {};\n\n        for (const [key, owner] of this._ownersByKey) {\n            ownersByQueryKey[key] = owner;\n            if (!queriesByOwner[owner]) {\n                queriesByOwner[owner] = [];\n            }\n            queriesByOwner[owner].push(key);\n        }\n\n        const ownership: OwnershipDiagnostics = { ownersByQueryKey, queriesByOwner };\n\n        const disconnectedQueryCount = multiplexer.connections.filter(c => !c.isConnected).length;\n        const health: HealthDiagnostics = {\n            allQueriesConnected: multiplexer.isConnected && cache.healthy,\n            disconnectedQueryCount,\n        };\n\n        return {\n            health,\n            transport,\n            multiplexer,\n            cache,\n            ownership,\n            timestamp: new Date().toISOString(),\n        };\n    }\n\n    private _publishSnapshot(snapshot: ObservableQueryDiagnosticsSnapshot): void {\n        this._snapshots.next(snapshot);\n    }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ObservableQueryDiagnostics.js","sources":["../../../queries/ObservableQueryDiagnostics.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 { Observable, Subject } from 'rxjs';\nimport { QueryInstanceCache } from './QueryInstanceCache';\nimport { ObservableQueryMultiplexer } from './ObservableQueryMultiplexer';\nimport { IObservableQueryDiagnostics } from './IObservableQueryDiagnostics';\nimport {\n    ObservableQueryDiagnosticsSnapshot,\n    MultiplexerDiagnostics,\n    TransportDiagnostics,\n    HealthDiagnostics,\n    OwnershipDiagnostics,\n} from './ObservableQueryDiagnosticsSnapshot';\n\n/**\n * Implements the {@link IObservableQueryDiagnostics} contract by collecting live state from\n * the {@link QueryInstanceCache} and the shared {@link ObservableQueryMultiplexer}.\n */\nexport class ObservableQueryDiagnostics implements IObservableQueryDiagnostics {\n    private readonly _snapshots = new Subject<ObservableQueryDiagnosticsSnapshot>();\n    private readonly _ownersByKey = new Map<string, string>();\n\n    /**\n     * Initializes a new instance of {@link ObservableQueryDiagnostics}.\n     * @param _cache The {@link QueryInstanceCache} whose state will be reflected.\n     * @param _getMultiplexer Factory that returns the current shared multiplexer, or {@code undefined}.\n     * @param _getTransportConfig Factory that returns the current transport diagnostics.\n     */\n    constructor(\n        private readonly _cache: QueryInstanceCache,\n        private readonly _getMultiplexer: () => ObservableQueryMultiplexer | undefined,\n        private readonly _getTransportConfig: () => TransportDiagnostics,\n    ) {}\n\n    /**\n     * Stream of diagnostics snapshots.\n     */\n    get snapshots$(): Observable<ObservableQueryDiagnosticsSnapshot> {\n        return this._snapshots.asObservable();\n    }\n\n    /** @inheritdoc */\n    getSnapshot(): ObservableQueryDiagnosticsSnapshot {\n        const snapshot = this._createSnapshot();\n        this._publishSnapshot(snapshot);\n        return snapshot;\n    }\n\n    /** @inheritdoc */\n    beginTracking(cacheKey: string, owner: string): void {\n        this._ownersByKey.set(cacheKey, owner);\n        this._publishSnapshot(this._createSnapshot());\n    }\n\n    /** @inheritdoc */\n    endTracking(cacheKey: string): void {\n        this._ownersByKey.delete(cacheKey);\n        this._publishSnapshot(this._createSnapshot());\n    }\n\n    private _buildMultiplexerDiagnostics(): MultiplexerDiagnostics {\n        const mux = this._getMultiplexer();\n        if (!mux) {\n            return {\n                isConnected: false,\n                configuredConnectionCount: 0,\n                effectiveConnectionCount: 0,\n                activeConnectionCount: 0,\n                connections: [],\n            };\n        }\n\n        const connections = mux.getConnectionsSnapshot();\n        const activeConnectionCount = connections.filter(c => c.isConnected).length;\n\n        return {\n            isConnected: activeConnectionCount > 0,\n            configuredConnectionCount: connections.length,\n            effectiveConnectionCount: connections.length,\n            activeConnectionCount,\n            connections,\n        };\n    }\n\n    private _createSnapshot(): ObservableQueryDiagnosticsSnapshot {\n        const transport = this._getTransportConfig();\n        const multiplexer = this._buildMultiplexerDiagnostics();\n        const cache = this._cache.getDiagnosticsSnapshot();\n\n        const ownersByQueryKey: Record<string, string> = {};\n        const queriesByOwner: Record<string, string[]> = {};\n\n        for (const [key, owner] of this._ownersByKey) {\n            ownersByQueryKey[key] = owner;\n            if (!queriesByOwner[owner]) {\n                queriesByOwner[owner] = [];\n            }\n            queriesByOwner[owner].push(key);\n        }\n\n        const ownership: OwnershipDiagnostics = { ownersByQueryKey, queriesByOwner };\n\n        const disconnectedQueryCount = multiplexer.connections.filter(c => !c.isConnected).length;\n        const health: HealthDiagnostics = {\n            allQueriesConnected: multiplexer.isConnected && cache.healthy,\n            disconnectedQueryCount,\n        };\n\n        return {\n            health,\n            transport,\n            multiplexer,\n            cache,\n            ownership,\n            timestamp: new Date().toISOString(),\n        };\n    }\n\n    private _publishSnapshot(snapshot: ObservableQueryDiagnosticsSnapshot): void {\n        this._snapshots.next(snapshot);\n    }\n}\n"],"names":["ObservableQueryDiagnostics","_snapshots","Subject","_ownersByKey","Map","_cache","_getMultiplexer","_getTransportConfig","snapshots$","asObservable","getSnapshot","snapshot","_createSnapshot","_publishSnapshot","beginTracking","cacheKey","owner","set","endTracking","delete","_buildMultiplexerDiagnostics","mux","isConnected","configuredConnectionCount","effectiveConnectionCount","activeConnectionCount","connections","getConnectionsSnapshot","filter","c","length","transport","multiplexer","cache","getDiagnosticsSnapshot","ownersByQueryKey","queriesByOwner","key","push","ownership","disconnectedQueryCount","health","allQueriesConnected","healthy","timestamp","Date","toISOString","next"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryFor.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAK5E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKlC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AASxE,8BAAsB,kBAAkB,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC;IAsBhH,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IArBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAwC;IAC5D,OAAO,CAAC,oBAAoB,CAAiB;IAE7C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAE9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;gBAOM,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO;IAYzE,OAAO;IAKP,eAAe,CAAC,YAAY,EAAE,MAAM;IAKpC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAKtD,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,2BAA2B,CAAC,SAAS,CAAC;IAgD/G,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAyDlE,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,iBAAiB;CAW5B"}
+{"version":3,"file":"ObservableQueryFor.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAK5E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKlC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AASxE,8BAAsB,kBAAkB,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC;IAsBhH,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IArBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAwC;IAC5D,OAAO,CAAC,oBAAoB,CAAiB;IAE7C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAE9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IAOf,YAAqB,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO,EAOxE;IAKD,OAAO,SAEN;IAGD,eAAe,CAAC,YAAY,EAAE,MAAM,QAEnC;IAGD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAExC;IAGD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9B;IAGD,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAErD;IAGD,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,2BAA2B,CAAC,SAAS,CAAC,CA6CpH;IAGK,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAuDjE;IAED,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,iBAAiB;CAW5B"}

package/dist/esm/queries/ObservableQueryFor.js

@@ -12,7 +12,12 @@ import { joinPaths } from '../joinPaths.js';
 import { UrlHelpers } from '../UrlHelpers.js';
 import { ParametersHelper } from '../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;
@@ -21,10 +26,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.none;
@@ -32,64 +41,77 @@ class ObservableQueryFor {
         this._microservice = Globals.microservice ?? '';
         this._apiBasePath = Globals.apiBasePath ?? '';
         this._origin = 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(this.defaultValue);
-        }
-        else {
+        } else {
             this._connection = 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.collectParameterValues(this);
         const { unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args);
         const connectionQueryArguments = {
             ...parameterValues,
-            ...(Globals.queryDirectMode ? unusedParameters : args || {}),
+            ...Globals.queryDirectMode ? unusedParameters : args || {},
             ...this.buildQueryArguments()
         };
         const subscriber = new 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.noSuccess, ...{ data: this.defaultValue } };
+    /** @inheritdoc */ async perform(args) {
+        const noSuccess = {
+            ...QueryResult.noSuccess,
+            ...{
+                data: this.defaultValue
+            }
+        };
         if (!this.validateArguments(args)) {
-            return new Promise((resolve) => {
+            return new Promise((resolve)=>{
                 resolve(noSuccess);
             });
         }
@@ -102,17 +124,21 @@ class ObservableQueryFor {
         }
         if (this.sorting.hasSorting) {
             additionalParams.sortBy = this.sorting.field;
-            additionalParams.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';
+            additionalParams.sortDirection = this.sorting.direction === SortDirection.descending ? 'desc' : 'asc';
         }
+        // Collect parameter values from parameterDescriptors that are set
         const parameterValues = ParametersHelper.collectParameterValues(this);
-        const queryParams = UrlHelpers.buildQueryParams({ ...unusedParameters, ...parameterValues }, additionalParams);
+        const queryParams = UrlHelpers.buildQueryParams({
+            ...unusedParameters,
+            ...parameterValues
+        }, additionalParams);
         const queryString = queryParams.toString();
         if (queryString) {
             actualRoute += (actualRoute.includes('?') ? '&' : '?') + queryString;
         }
         const url = UrlHelpers.createUrlFrom(this._origin, this._apiBasePath, actualRoute);
         const headers = {
-            ...(this._httpHeadersCallback?.() || {}),
+            ...this._httpHeadersCallback?.() || {},
             'Accept': 'application/json',
             'Content-Type': 'application/json'
         };
@@ -126,14 +152,16 @@ class ObservableQueryFor {
         try {
             const result = await response.json();
             return new QueryResult(result, this.modelType, this.enumerable);
-        }
-        catch {
+        } catch  {
             return noSuccess;
         }
     }
     validateArguments(args) {
         const parameterValues = ParametersHelper.collectParameterValues(this);
-        const combinedArgs = { ...(args || {}), ...parameterValues };
+        const combinedArgs = {
+            ...args || {},
+            ...parameterValues
+        };
         return ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, combinedArgs);
     }
     buildQueryArguments() {
@@ -144,7 +172,7 @@ class ObservableQueryFor {
         }
         if (this.sorting.hasSorting) {
             queryArguments.sortBy = this.sorting.field;
-            queryArguments.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';
+            queryArguments.sortDirection = this.sorting.direction === SortDirection.descending ? 'desc' : 'asc';
         }
         return queryArguments;
     }
@@ -152,12 +180,10 @@ class ObservableQueryFor {
         if (this.enumerable) {
             if (Array.isArray(result.data)) {
                 result.data = JsonSerializer.deserializeArrayFromInstance(this.modelType, result.data);
-            }
-            else {
+            } else {
                 result.data = [];
             }
-        }
-        else if (result.data) {
+        } else if (result.data) {
             result.data = JsonSerializer.deserializeFromInstance(this.modelType, result.data);
         }
     }

package/dist/esm/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":[],"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/esm/queries/ObservableQueryMultiplexer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryMultiplexer.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryMultiplexer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAOlF,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAUlD,qBAAa,0BAA0B;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAOnB,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,6BAA6B;IAQhF,IAAI,IAAI,IAAI,MAAM,CAEjB;IAKD,IAAI,eAAe,IAAI,MAAM,CAK5B;IAKD,IAAI,cAAc,IAAI,MAAM,CAI3B;IAUD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI;IAezG,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,wBAAwB;IAsChC,sBAAsB,IAAI,0BAA0B,EAAE;CAOzD;AAOD,qBAAa,oCAAoC,CAAC,SAAS,CAAE,YAAW,0BAA0B,CAAC,SAAS,CAAC;IASrG,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAT/B,OAAO,CAAC,QAAQ,CAAC,CAAa;gBAQT,KAAK,EAAE,0BAA0B,EACjC,UAAU,EAAE,MAAM;IAKvC,IAAI,eAAe,IAAI,MAAM,CAE5B;IAGD,IAAI,cAAc,IAAI,MAAM,CAE3B;IAGD,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAS7E,UAAU,IAAI,IAAI;CAIrB;AAeD,wBAAgB,sBAAsB,CAAC,iBAAiB,EAAE,MAAM,6BAA6B,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAqC,GAAG,0BAA0B,CASxL;AAMD,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAKD,wBAAgB,oBAAoB,IAAI,0BAA0B,GAAG,SAAS,CAE7E"}
+{"version":3,"file":"ObservableQueryMultiplexer.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryMultiplexer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAOlF,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAUlD,qBAAa,0BAA0B;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAO/B,YAAY,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,EAG/E;IAKD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAKD,IAAI,eAAe,IAAI,MAAM,CAK5B;IAKD,IAAI,cAAc,IAAI,MAAM,CAI3B;IAUD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAUxG;IAKD,OAAO,IAAI,IAAI,CAId;IAED,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,wBAAwB;IAsChC,sBAAsB,IAAI,0BAA0B,EAAE,CAMrD;CACJ;AAOD,qBAAa,oCAAoC,CAAC,SAAS,CAAE,YAAW,0BAA0B,CAAC,SAAS,CAAC;IASrG,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAT/B,OAAO,CAAC,QAAQ,CAAC,CAAa;IAO9B,YACqB,KAAK,EAAE,0BAA0B,EACjC,UAAU,EAAE,MAAM,EAEtC;IAGD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAGD,IAAI,cAAc,IAAI,MAAM,CAE3B;IAGD,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAM5E;IAGD,UAAU,IAAI,IAAI,CAGjB;CACJ;AAeD,wBAAgB,sBAAsB,CAAC,iBAAiB,EAAE,MAAM,6BAA6B,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAqC,GAAG,0BAA0B,CASxL;AAMD,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAKD,wBAAgB,oBAAoB,IAAI,0BAA0B,GAAG,SAAS,CAE7E"}

package/dist/esm/queries/ObservableQueryMultiplexer.js

@@ -1,70 +1,104 @@
 import { Globals } from '../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.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;
         }
@@ -73,39 +107,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.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.queryConnectionCount) {
     if (_sharedMultiplexer && _sharedMultiplexerKey === cacheKey) {
         return _sharedMultiplexer;
     }
@@ -114,12 +167,17 @@ function getOrCreateMultiplexer(connectionFactory, cacheKey, size = Globals.quer
     _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;
 }