@cratis/arc 22.24.0 → 22.26.1

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

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

package/dist/cjs/queries/ObservableQueryDiagnostics.d.ts

@@ -0,0 +1,21 @@
+import { Observable } from 'rxjs';
+import { QueryInstanceCache } from './QueryInstanceCache.js';
+import { ObservableQueryMultiplexer } from './ObservableQueryMultiplexer.js';
+import { IObservableQueryDiagnostics } from './IObservableQueryDiagnostics.js';
+import { ObservableQueryDiagnosticsSnapshot, TransportDiagnostics } from './ObservableQueryDiagnosticsSnapshot.js';
+export declare class ObservableQueryDiagnostics implements IObservableQueryDiagnostics {
+    private readonly _cache;
+    private readonly _getMultiplexer;
+    private readonly _getTransportConfig;
+    private readonly _snapshots;
+    private readonly _ownersByKey;
+    constructor(_cache: QueryInstanceCache, _getMultiplexer: () => ObservableQueryMultiplexer | undefined, _getTransportConfig: () => TransportDiagnostics);
+    get snapshots$(): Observable<ObservableQueryDiagnosticsSnapshot>;
+    getSnapshot(): ObservableQueryDiagnosticsSnapshot;
+    beginTracking(cacheKey: string, owner: string): void;
+    endTracking(cacheKey: string): void;
+    private _buildMultiplexerDiagnostics;
+    private _createSnapshot;
+    private _publishSnapshot;
+}
+//# sourceMappingURL=ObservableQueryDiagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ObservableQueryDiagnostics.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryDiagnostics.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAW,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EACH,kCAAkC,EAElC,oBAAoB,EAGvB,MAAM,yCAAyC,CAAC;AAMjD,qBAAa,0BAA2B,YAAW,2BAA2B;IAWtE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAZxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqD;IAChF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAQ1D,YACqB,MAAM,EAAE,kBAAkB,EAC1B,eAAe,EAAE,MAAM,0BAA0B,GAAG,SAAS,EAC7D,mBAAmB,EAAE,MAAM,oBAAoB,EAChE;IAKJ,IAAI,UAAU,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAE/D;IAGD,WAAW,IAAI,kCAAkC,CAIhD;IAGD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGnD;IAGD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGlC;IAED,OAAO,CAAC,4BAA4B;IAwBpC,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,gBAAgB;CAG3B"}

package/dist/cjs/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":["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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"}
+{"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.js';\nimport { ObservableQueryMultiplexer } from './ObservableQueryMultiplexer.js';\nimport { IObservableQueryDiagnostics } from './IObservableQueryDiagnostics.js';\nimport {\n    ObservableQueryDiagnosticsSnapshot,\n    MultiplexerDiagnostics,\n    TransportDiagnostics,\n    HealthDiagnostics,\n    OwnershipDiagnostics,\n} from './ObservableQueryDiagnosticsSnapshot.js';\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/cjs/queries/ObservableQueryDiagnosticsSnapshot.d.ts

@@ -0,0 +1,48 @@
+export interface MultiplexerConnectionState {
+    index: number;
+    isConnected: boolean;
+    queryCount: number;
+}
+export interface MultiplexerDiagnostics {
+    isConnected: boolean;
+    configuredConnectionCount: number;
+    effectiveConnectionCount: number;
+    activeConnectionCount: number;
+    connections: MultiplexerConnectionState[];
+}
+export interface CacheEntryDiagnostics {
+    key: string;
+    queryName: string;
+    subscriberCount: number;
+    listenerCount: number;
+    subscribed: boolean;
+    hasResult: boolean;
+    estimatedBytes: number;
+}
+export interface CacheDiagnostics {
+    healthy: boolean;
+    entryCount: number;
+    estimatedBytes: number;
+    entries: CacheEntryDiagnostics[];
+}
+export interface TransportDiagnostics {
+    queryTransportMethod: string;
+    queryDirectMode: boolean;
+}
+export interface HealthDiagnostics {
+    allQueriesConnected: boolean;
+    disconnectedQueryCount: number;
+}
+export interface OwnershipDiagnostics {
+    ownersByQueryKey: Record<string, string>;
+    queriesByOwner: Record<string, string[]>;
+}
+export interface ObservableQueryDiagnosticsSnapshot {
+    health: HealthDiagnostics;
+    transport: TransportDiagnostics;
+    multiplexer: MultiplexerDiagnostics;
+    cache: CacheDiagnostics;
+    ownership: OwnershipDiagnostics;
+    timestamp: string;
+}
+//# sourceMappingURL=ObservableQueryDiagnosticsSnapshot.d.ts.map

package/dist/cjs/queries/ObservableQueryDiagnosticsSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservableQueryDiagnosticsSnapshot.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryDiagnosticsSnapshot.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,0BAA0B;IAEvC,KAAK,EAAE,MAAM,CAAC;IAEd,WAAW,EAAE,OAAO,CAAC;IAErB,UAAU,EAAE,MAAM,CAAC;CACtB;AAKD,MAAM,WAAW,sBAAsB;IAEnC,WAAW,EAAE,OAAO,CAAC;IAErB,yBAAyB,EAAE,MAAM,CAAC;IAElC,wBAAwB,EAAE,MAAM,CAAC;IAEjC,qBAAqB,EAAE,MAAM,CAAC;IAE9B,WAAW,EAAE,0BAA0B,EAAE,CAAC;CAC7C;AAKD,MAAM,WAAW,qBAAqB;IAElC,GAAG,EAAE,MAAM,CAAC;IAEZ,SAAS,EAAE,MAAM,CAAC;IAElB,eAAe,EAAE,MAAM,CAAC;IAExB,aAAa,EAAE,MAAM,CAAC;IAEtB,UAAU,EAAE,OAAO,CAAC;IAEpB,SAAS,EAAE,OAAO,CAAC;IAEnB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAKD,MAAM,WAAW,gBAAgB;IAE7B,OAAO,EAAE,OAAO,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAEnB,cAAc,EAAE,MAAM,CAAC;IAEvB,OAAO,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAKD,MAAM,WAAW,oBAAoB;IAEjC,oBAAoB,EAAE,MAAM,CAAC;IAE7B,eAAe,EAAE,OAAO,CAAC;CAC5B;AAKD,MAAM,WAAW,iBAAiB;IAE9B,mBAAmB,EAAE,OAAO,CAAC;IAE7B,sBAAsB,EAAE,MAAM,CAAC;CAClC;AAKD,MAAM,WAAW,oBAAoB;IAEjC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC5C;AAKD,MAAM,WAAW,kCAAkC;IAE/C,MAAM,EAAE,iBAAiB,CAAC;IAE1B,SAAS,EAAE,oBAAoB,CAAC;IAEhC,WAAW,EAAE,sBAAsB,CAAC;IAEpC,KAAK,EAAE,gBAAgB,CAAC;IAExB,SAAS,EAAE,oBAAoB,CAAC;IAEhC,SAAS,EAAE,MAAM,CAAC;CACrB"}

package/dist/cjs/queries/ObservableQueryFor.d.ts

@@ -0,0 +1,42 @@
+import type { IObservableQueryFor, OnNextResult } from './IObservableQueryFor.js';
+import { ObservableQuerySubscription } from './ObservableQuerySubscription.js';
+import type { QueryValidator } from './QueryValidator.js';
+import type { Constructor } from '@cratis/fundamentals';
+import { QueryResult } from './QueryResult.js';
+import { Sorting } from './Sorting.js';
+import { Paging } from './Paging.js';
+import type { GetHttpHeaders } from '../GetHttpHeaders.js';
+import type { ParameterDescriptor } from '../reflection/ParameterDescriptor.js';
+import type { QueryHttpMethod } from './QueryHttpMethod.js';
+export declare abstract class ObservableQueryFor<TDataType, TParameters = object> implements IObservableQueryFor<TDataType, TParameters> {
+    readonly modelType: Constructor;
+    readonly enumerable: boolean;
+    private _microservice;
+    private _apiBasePath;
+    private _origin;
+    private _connection?;
+    private _httpHeadersCallback;
+    private _httpMethod?;
+    abstract readonly route: string;
+    abstract readonly defaultValue: TDataType;
+    readonly roles: string[];
+    readonly validation?: QueryValidator<any>;
+    readonly queryName?: string;
+    abstract readonly parameterDescriptors: ParameterDescriptor[];
+    abstract get requiredRequestParameters(): string[];
+    sorting: Sorting;
+    paging: Paging;
+    constructor(modelType: Constructor, enumerable: boolean);
+    dispose(): void;
+    setMicroservice(microservice: string): void;
+    setApiBasePath(apiBasePath: string): void;
+    setOrigin(origin: string): void;
+    setHttpHeadersCallback(callback: GetHttpHeaders): void;
+    setHttpMethod(method: QueryHttpMethod): void;
+    subscribe(callback: OnNextResult<QueryResult<TDataType>>, args?: TParameters): ObservableQuerySubscription<TDataType>;
+    perform(args?: TParameters): Promise<QueryResult<TDataType>>;
+    private validateArguments;
+    private buildQueryArguments;
+    private deserializeResult;
+}
+//# sourceMappingURL=ObservableQueryFor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ObservableQueryFor.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAS5D,8BAAsB,kBAAkB,CACpC,SAAS,EACT,WAAW,GAAG,MAAM,CACtB,YAAW,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC;IAyBhD,QAAQ,CAAC,SAAS,EAAE,WAAW;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO;IAzBhC,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;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAkB;IAEtC,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;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAE1C,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,YACa,SAAS,EAAE,WAAW,EACtB,UAAU,EAAE,OAAO,EAQ/B;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,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAE3C;IAGD,SAAS,CACL,QAAQ,EAAE,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAC9C,IAAI,CAAC,EAAE,WAAW,GACnB,2BAA2B,CAAC,SAAS,CAAC,CA8DxC;IAGK,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAgDjE;IAED,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,iBAAiB;CAO5B"}

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 type { IObservableQueryFor, OnNextResult } from './IObservableQueryFor';\nimport { ObservableQuerySubscription } from './ObservableQuerySubscription';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport type { QueryValidator } from './QueryValidator';\nimport type { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { NullObservableQueryConnection } from './NullObservableQueryConnection';\nimport { createObservableQueryConnection } from './ObservableQueryConnectionFactory';\nimport type { Constructor } from '@cratis/fundamentals';\nimport { deserializeQueryModel, deserializeQueryModels } from './deserializeQueryModel';\nimport { QueryResult } from './QueryResult';\nimport { Sorting } from './Sorting';\nimport { Paging } from './Paging';\nimport { SortDirection } from './SortDirection';\nimport { Globals } from '../Globals';\nimport { UrlHelpers } from '../UrlHelpers';\nimport type { GetHttpHeaders } from '../GetHttpHeaders';\nimport type { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\nimport type { QueryHttpMethod } from './QueryHttpMethod';\nimport { executeQueryHttpRequest } from './QueryHttpRequest';\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<\n    TDataType,\n    TParameters = object,\n> 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    private _httpMethod?: QueryHttpMethod;\n\n    abstract readonly route: string;\n    abstract readonly defaultValue: TDataType;\n    readonly roles: string[] = [];\n    readonly validation?: QueryValidator<any>;\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(\n        readonly modelType: Constructor,\n        readonly enumerable: boolean,\n    ) {\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    setHttpMethod(method: QueryHttpMethod): void {\n        this._httpMethod = method;\n    }\n\n    /** @inheritdoc */\n    subscribe(\n        callback: OnNextResult<QueryResult<TDataType>>,\n        args?: TParameters,\n    ): ObservableQuerySubscription<TDataType> {\n        if (this._connection) {\n            this._connection.disconnect();\n        }\n\n        const clientValidationErrors =\n            this.validation?.validate((args as object) || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            // Serve the failure through the connection rather than throwing, so a subscriber sees an invalid result\n            // on its normal callback path instead of the empty result an unestablished connection would emit.\n            this._connection = new NullObservableQueryConnection(\n                this.defaultValue,\n                QueryResult.validationFailed(clientValidationErrors, this),\n            );\n        } else if (this.validateArguments(args)) {\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        } else {\n            this._connection = new NullObservableQueryConnection(this.defaultValue);\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(\n            this.route,\n            args as object,\n        );\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                // Observable transports deliver structural query-result envelopes directly instead of\n                // constructing QueryResult. Servers predating readiness therefore omit the member;\n                // those results are complete by definition and must be normalized before subscribers\n                // observe them. Preserve an explicit false transient state from newer servers.\n                result.isReady ??= true;\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 = {\n            ...QueryResult.noSuccess,\n            ...{ data: this.defaultValue },\n        } as QueryResult<TDataType>;\n\n        const clientValidationErrors =\n            this.validation?.validate((args as object) || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return QueryResult.validationFailed(clientValidationErrors, this);\n        }\n\n        if (!this.validateArguments(args)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\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 executeQueryHttpRequest(this._httpMethod, {\n            route: this.route,\n            apiBasePath: this._apiBasePath,\n            origin: this._origin,\n            args: (args as object) ?? {},\n            parameterValues,\n            paging: this.paging,\n            sorting: this.sorting,\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(\n            this.constructor.name,\n            this.requiredRequestParameters,\n            combinedArgs as object,\n        );\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 =\n                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            result.data = deserializeQueryModels(this.modelType, result.data);\n        } else if (result.data) {\n            result.data = deserializeQueryModel(this.modelType, result.data);\n        }\n    }\n}\n"],"names":["ObservableQueryFor","_microservice","_apiBasePath","_origin","_connection","_httpHeadersCallback","_httpMethod","roles","validation","queryName","sorting","paging","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","dispose","disconnect","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","setHttpMethod","method","subscribe","args","clientValidationErrors","validate","length","NullObservableQueryConnection","defaultValue","QueryResult","validationFailed","validateArguments","createObservableQueryConnection","route","name","parameterValues","ParametersHelper","collectParameterValues","unusedParameters","UrlHelpers","replaceRouteParameters","connectionQueryArguments","queryDirectMode","buildQueryArguments","subscriber","ObservableQuerySubscription","connect","data","result","isReady","deserializeResult","ex","console","log","perform","noSuccess","Promise","resolve","headers","Accept","microserviceHttpHeader","response","executeQueryHttpRequest","json","combinedArgs","ValidateRequestArguments","requiredRequestParameters","queryArguments","pageSize","page","hasSorting","sortBy","field","sortDirection","direction","SortDirection","descending","deserializeQueryModels","deserializeQueryModel"],"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 type { IObservableQueryFor, OnNextResult } from './IObservableQueryFor.js';\nimport { ObservableQuerySubscription } from './ObservableQuerySubscription.js';\nimport { ValidateRequestArguments } from './ValidateRequestArguments.js';\nimport type { QueryValidator } from './QueryValidator.js';\nimport type { IObservableQueryConnection } from './IObservableQueryConnection.js';\nimport { NullObservableQueryConnection } from './NullObservableQueryConnection.js';\nimport { createObservableQueryConnection } from './ObservableQueryConnectionFactory.js';\nimport type { Constructor } from '@cratis/fundamentals';\nimport { deserializeQueryModel, deserializeQueryModels } from './deserializeQueryModel.js';\nimport { QueryResult } from './QueryResult.js';\nimport { Sorting } from './Sorting.js';\nimport { Paging } from './Paging.js';\nimport { SortDirection } from './SortDirection.js';\nimport { Globals } from '../Globals.js';\nimport { UrlHelpers } from '../UrlHelpers.js';\nimport type { GetHttpHeaders } from '../GetHttpHeaders.js';\nimport type { ParameterDescriptor } from '../reflection/ParameterDescriptor.js';\nimport { ParametersHelper } from '../reflection/ParametersHelper.js';\nimport type { QueryHttpMethod } from './QueryHttpMethod.js';\nimport { executeQueryHttpRequest } from './QueryHttpRequest.js';\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<\n    TDataType,\n    TParameters = object,\n> 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    private _httpMethod?: QueryHttpMethod;\n\n    abstract readonly route: string;\n    abstract readonly defaultValue: TDataType;\n    readonly roles: string[] = [];\n    readonly validation?: QueryValidator<any>;\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(\n        readonly modelType: Constructor,\n        readonly enumerable: boolean,\n    ) {\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    setHttpMethod(method: QueryHttpMethod): void {\n        this._httpMethod = method;\n    }\n\n    /** @inheritdoc */\n    subscribe(\n        callback: OnNextResult<QueryResult<TDataType>>,\n        args?: TParameters,\n    ): ObservableQuerySubscription<TDataType> {\n        if (this._connection) {\n            this._connection.disconnect();\n        }\n\n        const clientValidationErrors =\n            this.validation?.validate((args as object) || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            // Serve the failure through the connection rather than throwing, so a subscriber sees an invalid result\n            // on its normal callback path instead of the empty result an unestablished connection would emit.\n            this._connection = new NullObservableQueryConnection(\n                this.defaultValue,\n                QueryResult.validationFailed(clientValidationErrors, this),\n            );\n        } else if (this.validateArguments(args)) {\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        } else {\n            this._connection = new NullObservableQueryConnection(this.defaultValue);\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(\n            this.route,\n            args as object,\n        );\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                // Observable transports deliver structural query-result envelopes directly instead of\n                // constructing QueryResult. Servers predating readiness therefore omit the member;\n                // those results are complete by definition and must be normalized before subscribers\n                // observe them. Preserve an explicit false transient state from newer servers.\n                result.isReady ??= true;\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 = {\n            ...QueryResult.noSuccess,\n            ...{ data: this.defaultValue },\n        } as QueryResult<TDataType>;\n\n        const clientValidationErrors =\n            this.validation?.validate((args as object) || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return QueryResult.validationFailed(clientValidationErrors, this);\n        }\n\n        if (!this.validateArguments(args)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\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 executeQueryHttpRequest(this._httpMethod, {\n            route: this.route,\n            apiBasePath: this._apiBasePath,\n            origin: this._origin,\n            args: (args as object) ?? {},\n            parameterValues,\n            paging: this.paging,\n            sorting: this.sorting,\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(\n            this.constructor.name,\n            this.requiredRequestParameters,\n            combinedArgs as object,\n        );\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 =\n                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            result.data = deserializeQueryModels(this.modelType, result.data);\n        } else if (result.data) {\n            result.data = deserializeQueryModel(this.modelType, result.data);\n        }\n    }\n}\n"],"names":["ObservableQueryFor","_microservice","_apiBasePath","_origin","_connection","_httpHeadersCallback","_httpMethod","roles","validation","queryName","sorting","paging","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","dispose","disconnect","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","setHttpMethod","method","subscribe","args","clientValidationErrors","validate","length","NullObservableQueryConnection","defaultValue","QueryResult","validationFailed","validateArguments","createObservableQueryConnection","route","name","parameterValues","ParametersHelper","collectParameterValues","unusedParameters","UrlHelpers","replaceRouteParameters","connectionQueryArguments","queryDirectMode","buildQueryArguments","subscriber","ObservableQuerySubscription","connect","data","result","isReady","deserializeResult","ex","console","log","perform","noSuccess","Promise","resolve","headers","Accept","microserviceHttpHeader","response","executeQueryHttpRequest","json","combinedArgs","ValidateRequestArguments","requiredRequestParameters","queryArguments","pageSize","page","hasSorting","sortBy","field","sortDirection","direction","SortDirection","descending","deserializeQueryModels","deserializeQueryModel"],"mappings":"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"}

package/dist/cjs/queries/ObservableQueryMultiplexer.d.ts

@@ -0,0 +1,33 @@
+import { IObservableQueryConnection } from './IObservableQueryConnection.js';
+import { IObservableQueryHubConnection } from './IObservableQueryHubConnection.js';
+import { DataReceived } from './ObservableQueryConnection.js';
+import { MultiplexerConnectionState } from './ObservableQueryDiagnosticsSnapshot.js';
+export declare const WS_HUB_ROUTE = "/.cratis/queries/ws";
+export declare class ObservableQueryMultiplexer {
+    private readonly _connections;
+    private readonly _size;
+    constructor(size: number, connectionFactory: () => IObservableQueryHubConnection);
+    get size(): number;
+    get lastPingLatency(): number;
+    get averageLatency(): number;
+    subscribe(queryName: string, queryArguments: object | undefined, callback: DataReceived<any>): () => void;
+    dispose(): void;
+    private leastLoaded;
+    private generateQueryId;
+    private buildSubscriptionRequest;
+    getConnectionsSnapshot(): MultiplexerConnectionState[];
+}
+export declare class MultiplexedObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {
+    private readonly _pool;
+    private readonly _queryName;
+    private _cleanup?;
+    constructor(_pool: ObservableQueryMultiplexer, _queryName: string);
+    get lastPingLatency(): number;
+    get averageLatency(): number;
+    connect(dataReceived: DataReceived<TDataType>, queryArguments?: object): void;
+    disconnect(): void;
+}
+export declare function getOrCreateMultiplexer(connectionFactory: () => IObservableQueryHubConnection, cacheKey: string, size?: number): ObservableQueryMultiplexer;
+export declare function resetSharedMultiplexer(): void;
+export declare function getSharedMultiplexer(): ObservableQueryMultiplexer | undefined;
+//# sourceMappingURL=ObservableQueryMultiplexer.d.ts.map

package/dist/cjs/queries/ObservableQueryMultiplexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservableQueryMultiplexer.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryMultiplexer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAOrF,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/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":["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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"}
+{"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.js';\nimport { IObservableQueryHubConnection } from './IObservableQueryHubConnection.js';\nimport { DataReceived } from './ObservableQueryConnection.js';\nimport { SubscriptionRequest } from './WebSocketHubConnection.js';\nimport { Globals } from '../Globals.js';\nimport { MultiplexerConnectionState } from './ObservableQueryDiagnosticsSnapshot.js';\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.d.ts

@@ -0,0 +1,7 @@
+import { IObservableQueryConnection } from './IObservableQueryConnection.js';
+export declare class ObservableQuerySubscription<TDataType> {
+    private _connection;
+    constructor(_connection: IObservableQueryConnection<TDataType>);
+    unsubscribe(): void;
+}
+//# sourceMappingURL=ObservableQuerySubscription.d.ts.map

package/dist/cjs/queries/ObservableQuerySubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservableQuerySubscription.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQuerySubscription.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAK7E,qBAAa,2BAA2B,CAAC,SAAS;IAMlC,OAAO,CAAC,WAAW;IAA/B,YAAoB,WAAW,EAAE,0BAA0B,CAAC,SAAS,CAAC,EACrE;IAKD,WAAW,SAKV;CACJ"}

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":["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;;"}
+{"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.js';\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;;"}

package/dist/cjs/queries/Paging.d.ts

@@ -0,0 +1,8 @@
+export declare class Paging {
+    static noPaging: Paging;
+    constructor(page?: number, pageSize?: number);
+    page: number;
+    pageSize: number;
+    get hasPaging(): boolean;
+}
+//# sourceMappingURL=Paging.d.ts.map

package/dist/cjs/queries/Paging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paging.d.ts","sourceRoot":"","sources":["../../../queries/Paging.ts"],"names":[],"mappings":"AAMA,qBAAa,MAAM;IAKf,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAoB;IAK3C,YAAY,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAG3C;IAKD,IAAI,EAAE,MAAM,CAAC;IAKb,QAAQ,EAAE,MAAM,CAAC;IAKjB,IAAI,SAAS,IAAI,OAAO,CAEvB;CACJ"}

package/dist/cjs/queries/PagingInfo.d.ts

@@ -0,0 +1,9 @@
+export declare class PagingInfo {
+    static readonly noPaging: PagingInfo;
+    constructor();
+    page: number;
+    size: number;
+    totalItems: number;
+    totalPages: number;
+}
+//# sourceMappingURL=PagingInfo.d.ts.map

package/dist/cjs/queries/PagingInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PagingInfo.d.ts","sourceRoot":"","sources":["../../../queries/PagingInfo.ts"],"names":[],"mappings":"AAMA,qBAAa,UAAU;IAKnB,MAAM,CAAC,QAAQ,CAAC,QAAQ,aAAoB;IAK5C,cAKC;IAKD,IAAI,EAAE,MAAM,CAAC;IAKb,IAAI,EAAE,MAAM,CAAC;IAKb,UAAU,EAAE,MAAM,CAAC;IAKnB,UAAU,EAAE,MAAM,CAAC;CACtB"}

package/dist/cjs/queries/QueryFor.d.ts

@@ -0,0 +1,37 @@
+import { IQueryFor } from './IQueryFor.js';
+import { QueryResult } from "./QueryResult.js";
+import { QueryValidator } from './QueryValidator.js';
+import { Constructor } from '@cratis/fundamentals';
+import { Paging } from './Paging.js';
+import { Sorting } from './Sorting.js';
+import { GetHttpHeaders } from '../GetHttpHeaders.js';
+import { ParameterDescriptor } from '../reflection/ParameterDescriptor.js';
+import { QueryHttpMethod } from './QueryHttpMethod.js';
+export declare abstract class QueryFor<TDataType, TParameters = object> implements IQueryFor<TDataType, TParameters> {
+    readonly modelType: Constructor;
+    readonly enumerable: boolean;
+    private _microservice;
+    private _apiBasePath;
+    private _origin;
+    private _httpHeadersCallback;
+    private _httpMethod?;
+    abstract readonly route: string;
+    readonly queryName?: string;
+    readonly validation?: QueryValidator<any>;
+    readonly roles: string[];
+    abstract readonly parameterDescriptors: ParameterDescriptor[];
+    abstract get requiredRequestParameters(): string[];
+    abstract defaultValue: TDataType;
+    abortController?: AbortController;
+    sorting: Sorting;
+    paging: Paging;
+    parameters: TParameters | undefined;
+    constructor(modelType: Constructor, enumerable: boolean);
+    setMicroservice(microservice: string): void;
+    setApiBasePath(apiBasePath: string): void;
+    setOrigin(origin: string): void;
+    setHttpHeadersCallback(callback: GetHttpHeaders): void;
+    setHttpMethod(method: QueryHttpMethod): void;
+    perform(args?: TParameters): Promise<QueryResult<TDataType>>;
+}
+//# sourceMappingURL=QueryFor.d.ts.map

package/dist/cjs/queries/QueryFor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryFor.d.ts","sourceRoot":"","sources":["../../../queries/QueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQvD,8BAAsB,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;IA0B5F,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IAzBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAE1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,GAAG,SAAS,CAAC;IAOpC,YAAqB,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO,EAOxE;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,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAE3C;IAGK,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CA8FjE;CACJ"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryFor.js","sources":["../../../queries/QueryFor.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 { IQueryFor } from './IQueryFor';\nimport { QueryResult } from \"./QueryResult\";\nimport { QueryValidator } from './QueryValidator';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { Constructor } from '@cratis/fundamentals';\nimport { Paging } from './Paging';\nimport { Globals } from '../Globals';\nimport { Sorting } from './Sorting';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\nimport { QueryHttpMethod } from './QueryHttpMethod';\nimport { executeQueryHttpRequest } from './QueryHttpRequest';\nimport { isAbortError } from './isAbortError';\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class QueryFor<TDataType, TParameters = object> implements IQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _httpHeadersCallback: GetHttpHeaders;\n    private _httpMethod?: QueryHttpMethod;\n    abstract readonly route: string;\n    /** Backend fully-qualified query name used as cache key. Overridden in generated proxies. */\n    readonly queryName?: string;\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    readonly validation?: QueryValidator<any>;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    readonly roles: string[] = [];\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    abstract defaultValue: TDataType;\n    abortController?: AbortController;\n    sorting: Sorting;\n    paging: Paging;\n    parameters: TParameters | undefined;\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    /** @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    setHttpMethod(method: QueryHttpMethod): void {\n        this._httpMethod = method;\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        args = args || this.parameters;\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return QueryResult.validationFailed(clientValidationErrors, this);\n        }\n\n        if (!ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, args as object)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        if (this.abortController) {\n            this.abortController.abort();\n        }\n\n        this.abortController = new AbortController();\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const headers = {\n            ... this._httpHeadersCallback?.(), ...\n            {\n                'Accept': 'application/json',\n                'Content-Type': 'application/json'\n            }\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        let response: Response;\n\n        try {\n            response = await executeQueryHttpRequest(this._httpMethod, {\n                route: this.route,\n                apiBasePath: this._apiBasePath,\n                origin: this._origin,\n                args: (args as object) ?? {},\n                parameterValues,\n                paging: this.paging,\n                sorting: this.sorting,\n                headers,\n                signal: this.abortController.signal\n            });\n        } catch (error) {\n            // An abort is not a failure - it is this query superseding its own in-flight request above.\n            // Rethrowing lets the caller discard the superseded request so it cannot settle over the\n            // newer one that now owns the result.\n            if (isAbortError(error)) {\n                throw error;\n            }\n\n            // A dead network, a CORS rejection or a DNS failure never reaches the server, so it is\n            // neither an authorization nor a validation outcome - it is reported as an exception, with\n            // the default value as data, exactly as every other unsuccessful result from here does.\n            // Destructuring a nullish rejection value throws, which would make the `String(error)`\n            // fallback written for exactly that case unreachable - so it is coerced to an object first.\n            const { message } = (error ?? {}) as { message?: string };\n            const failure = {\n                ...QueryResult.noSuccess,\n                data: this.defaultValue,\n                isSuccess: false,\n                isAuthorized: true,\n                isValid: true,\n                hasExceptions: true,\n                exceptionMessages: [message ?? String(error)],\n                // Left empty on purpose. Every result the server returns has its stack trace blanked\n                // unless exception detail is explicitly exposed, and consumers are told to forward\n                // this field to a logger - so filling it in here would make a failure that never\n                // reached the server the one case that escapes that policy. The message is what\n                // diagnoses a transport failure; the browser's own frames add nothing.\n                exceptionStackTrace: ''\n            };\n\n            // `hasData` is a prototype getter, and a spread copies own properties only - so the literal\n            // above would hand every consumer of this public `IQueryResult` member `undefined` instead\n            // of a boolean. Restoring the prototype makes it a real {@link QueryResult} again while\n            // leaving every field value exactly as it is.\n            return Object.setPrototypeOf(failure, QueryResult.prototype) as QueryResult<TDataType>;\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"],"names":["QueryFor","_microservice","_apiBasePath","_origin","_httpHeadersCallback","_httpMethod","queryName","validation","roles","abortController","sorting","paging","parameters","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","setHttpMethod","method","perform","args","noSuccess","QueryResult","data","defaultValue","clientValidationErrors","validate","length","validationFailed","ValidateRequestArguments","name","requiredRequestParameters","Promise","resolve","abort","AbortController","parameterValues","ParametersHelper","collectParameterValues","headers","microserviceHttpHeader","response","executeQueryHttpRequest","route","signal","error","isAbortError","message","failure","isSuccess","isAuthorized","isValid","hasExceptions","exceptionMessages","String","exceptionStackTrace","Object","setPrototypeOf","prototype","result","json"],"mappings":"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"}
+{"version":3,"file":"QueryFor.js","sources":["../../../queries/QueryFor.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 { IQueryFor } from './IQueryFor.js';\nimport { QueryResult } from \"./QueryResult.js\";\nimport { QueryValidator } from './QueryValidator.js';\nimport { ValidateRequestArguments } from './ValidateRequestArguments.js';\nimport { Constructor } from '@cratis/fundamentals';\nimport { Paging } from './Paging.js';\nimport { Globals } from '../Globals.js';\nimport { Sorting } from './Sorting.js';\nimport { GetHttpHeaders } from '../GetHttpHeaders.js';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor.js';\nimport { ParametersHelper } from '../reflection/ParametersHelper.js';\nimport { QueryHttpMethod } from './QueryHttpMethod.js';\nimport { executeQueryHttpRequest } from './QueryHttpRequest.js';\nimport { isAbortError } from './isAbortError.js';\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class QueryFor<TDataType, TParameters = object> implements IQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _httpHeadersCallback: GetHttpHeaders;\n    private _httpMethod?: QueryHttpMethod;\n    abstract readonly route: string;\n    /** Backend fully-qualified query name used as cache key. Overridden in generated proxies. */\n    readonly queryName?: string;\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    readonly validation?: QueryValidator<any>;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    readonly roles: string[] = [];\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    abstract defaultValue: TDataType;\n    abortController?: AbortController;\n    sorting: Sorting;\n    paging: Paging;\n    parameters: TParameters | undefined;\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    /** @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    setHttpMethod(method: QueryHttpMethod): void {\n        this._httpMethod = method;\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        args = args || this.parameters;\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return QueryResult.validationFailed(clientValidationErrors, this);\n        }\n\n        if (!ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, args as object)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        if (this.abortController) {\n            this.abortController.abort();\n        }\n\n        this.abortController = new AbortController();\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const headers = {\n            ... this._httpHeadersCallback?.(), ...\n            {\n                'Accept': 'application/json',\n                'Content-Type': 'application/json'\n            }\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        let response: Response;\n\n        try {\n            response = await executeQueryHttpRequest(this._httpMethod, {\n                route: this.route,\n                apiBasePath: this._apiBasePath,\n                origin: this._origin,\n                args: (args as object) ?? {},\n                parameterValues,\n                paging: this.paging,\n                sorting: this.sorting,\n                headers,\n                signal: this.abortController.signal\n            });\n        } catch (error) {\n            // An abort is not a failure - it is this query superseding its own in-flight request above.\n            // Rethrowing lets the caller discard the superseded request so it cannot settle over the\n            // newer one that now owns the result.\n            if (isAbortError(error)) {\n                throw error;\n            }\n\n            // A dead network, a CORS rejection or a DNS failure never reaches the server, so it is\n            // neither an authorization nor a validation outcome - it is reported as an exception, with\n            // the default value as data, exactly as every other unsuccessful result from here does.\n            // Destructuring a nullish rejection value throws, which would make the `String(error)`\n            // fallback written for exactly that case unreachable - so it is coerced to an object first.\n            const { message } = (error ?? {}) as { message?: string };\n            const failure = {\n                ...QueryResult.noSuccess,\n                data: this.defaultValue,\n                isSuccess: false,\n                isAuthorized: true,\n                isValid: true,\n                hasExceptions: true,\n                exceptionMessages: [message ?? String(error)],\n                // Left empty on purpose. Every result the server returns has its stack trace blanked\n                // unless exception detail is explicitly exposed, and consumers are told to forward\n                // this field to a logger - so filling it in here would make a failure that never\n                // reached the server the one case that escapes that policy. The message is what\n                // diagnoses a transport failure; the browser's own frames add nothing.\n                exceptionStackTrace: ''\n            };\n\n            // `hasData` is a prototype getter, and a spread copies own properties only - so the literal\n            // above would hand every consumer of this public `IQueryResult` member `undefined` instead\n            // of a boolean. Restoring the prototype makes it a real {@link QueryResult} again while\n            // leaving every field value exactly as it is.\n            return Object.setPrototypeOf(failure, QueryResult.prototype) as QueryResult<TDataType>;\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"],"names":["QueryFor","_microservice","_apiBasePath","_origin","_httpHeadersCallback","_httpMethod","queryName","validation","roles","abortController","sorting","paging","parameters","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","setHttpMethod","method","perform","args","noSuccess","QueryResult","data","defaultValue","clientValidationErrors","validate","length","validationFailed","ValidateRequestArguments","name","requiredRequestParameters","Promise","resolve","abort","AbortController","parameterValues","ParametersHelper","collectParameterValues","headers","microserviceHttpHeader","response","executeQueryHttpRequest","route","signal","error","isAbortError","message","failure","isSuccess","isAuthorized","isValid","hasExceptions","exceptionMessages","String","exceptionStackTrace","Object","setPrototypeOf","prototype","result","json"],"mappings":"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"}

package/dist/cjs/queries/QueryHttpMethod.d.ts

@@ -0,0 +1,6 @@
+export declare enum QueryHttpMethod {
+    Get = "GET",
+    Query = "QUERY",
+    Auto = "AUTO"
+}
+//# sourceMappingURL=QueryHttpMethod.d.ts.map

package/dist/cjs/queries/QueryHttpMethod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryHttpMethod.d.ts","sourceRoot":"","sources":["../../../queries/QueryHttpMethod.ts"],"names":[],"mappings":"AAMA,oBAAY,eAAe;IAIvB,GAAG,QAAQ;IAKX,KAAK,UAAU;IAOf,IAAI,SAAS;CAChB"}

package/dist/cjs/queries/QueryHttpMethodResolver.d.ts

@@ -0,0 +1,14 @@
+import { QueryHttpMethod } from './QueryHttpMethod.js';
+export interface QueryHttpMethodResolverContext {
+    readonly url: URL;
+    readonly route: string;
+    readonly args: object;
+}
+export type QueryHttpMethodResolver = (context: QueryHttpMethodResolverContext) => QueryHttpMethod;
+export declare const defaultQueryHttpMethodUrlThreshold = 2000;
+export interface LengthBasedQueryHttpMethodOptions {
+    threshold?: number;
+    whenLong?: QueryHttpMethod;
+}
+export declare function lengthBasedQueryHttpMethod(options?: LengthBasedQueryHttpMethodOptions): QueryHttpMethodResolver;
+//# sourceMappingURL=QueryHttpMethodResolver.d.ts.map

package/dist/cjs/queries/QueryHttpMethodResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryHttpMethodResolver.d.ts","sourceRoot":"","sources":["../../../queries/QueryHttpMethodResolver.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAKvD,MAAM,WAAW,8BAA8B;IAE3C,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAElB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAMD,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,8BAA8B,KAAK,eAAe,CAAC;AAMnG,eAAO,MAAM,kCAAkC,OAAO,CAAC;AAKvD,MAAM,WAAW,iCAAiC;IAE9C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC9B;AASD,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,iCAAiC,GAAG,uBAAuB,CAI/G"}