@cratis/arc 20.54.5 → 20.55.0

package/dist/esm/queries/QueryInstanceCache.js

@@ -1,38 +1,77 @@
-class QueryInstanceCache {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Provides a cache for query instances, keyed by query type and serialized arguments.
+ *
+ * Two callers requesting the same query type with identical arguments receive the same
+ * cached instance and immediately see the last known result — without an additional
+ * round trip to the server. When the last subscriber releases its reference the entry
+ * is evicted.
+ */ class QueryInstanceCache {
     _retentionMs;
     _entries = new Map();
     _pendingDispose;
-    constructor(_retentionMs = 30_000) {
+    /**
+     * Initializes a new instance of {@link QueryInstanceCache}.
+     * @param retentionMs How long in milliseconds to keep a cache entry alive after the last
+     *   subscriber releases it before evicting the subscription and cached data.  A non-zero
+     *   value lets users navigate away and back without losing cached data.  Defaults to
+     *   30 000 ms.  Pass 0 for immediate eviction.
+     */ constructor(_retentionMs = 30_000){
         this._retentionMs = _retentionMs;
     }
-    buildKey(queryTypeName, args) {
+    /**
+     * Builds the cache key for a query.
+     * @param queryTypeName The stable type name for the query. Use the instance's {@link queryName}
+     *   (a hardcoded fully-qualified string in generated proxies) rather than {@link Function.name},
+     *   which is unstable under minification.
+     * @param args Optional arguments supplied to the query.
+     * @returns A stable string key.
+     */ buildKey(queryTypeName, args) {
         if (!args || Object.keys(args).length === 0) {
             return `${queryTypeName}::`;
         }
-        const sorted = Object.keys(args)
-            .sort()
-            .reduce((accumulator, key) => {
+        const sorted = Object.keys(args).sort().reduce((accumulator, key)=>{
             accumulator[key] = args[key];
             return accumulator;
         }, {});
         return `${queryTypeName}::${JSON.stringify(sorted)}`;
     }
-    getOrCreate(key, factory) {
+    /**
+     * Returns a cached instance for the given key, or creates a new one using the provided factory.
+     * The subscriber count of the entry is incremented.
+     * @template TInstance The type of the query instance.
+     * @param key The cache key produced by {@link buildKey}.
+     * @param factory A zero-argument factory that creates a fresh query instance when one is not yet cached.
+     * @returns The cached (or newly created) instance and whether it was newly created.
+     */ getOrCreate(key, factory) {
         if (!this._entries.has(key)) {
             const entry = {
                 instance: factory(),
                 lastResult: undefined,
                 subscriberCount: 0,
                 listeners: new Set(),
-                subscribed: false,
+                subscribed: false
             };
             this._entries.set(key, entry);
-            return { instance: entry.instance, isNew: true };
+            return {
+                instance: entry.instance,
+                isNew: true
+            };
         }
         const entry = this._entries.get(key);
-        return { instance: entry.instance, isNew: false };
+        return {
+            instance: entry.instance,
+            isNew: false
+        };
     }
-    acquire(key) {
+    /**
+     * Increments the active subscriber count for the given key.
+     * If a deferred cleanup was pending (from a recent {@link release}),
+     * it is cancelled so the existing subscription is reused.
+     * Call from `useEffect` setup to pair with {@link release} in the cleanup.
+     * @param key The cache key produced by {@link buildKey}.
+     */ acquire(key) {
         const entry = this._entries.get(key);
         if (entry) {
             if (entry.pendingCleanup !== undefined) {
@@ -42,52 +81,92 @@ class QueryInstanceCache {
             entry.subscriberCount++;
         }
     }
-    getLastResult(key) {
+    /**
+     * Returns the last cached result for the given key, or `undefined` if no result has been stored yet.
+     * @template TDataType The type of data returned by the query.
+     * @param key The cache key produced by {@link buildKey}.
+     * @returns The last {@link QueryResultWithState}, or `undefined`.
+     */ getLastResult(key) {
         return this._entries.get(key)?.lastResult;
     }
-    setLastResult(key, result) {
+    /**
+     * Stores the most recent result for the given key and notifies all registered listeners.
+     * @template TDataType The type of data returned by the query.
+     * @param key The cache key produced by {@link buildKey}.
+     * @param result The result to store.
+     */ setLastResult(key, result) {
         const entry = this._entries.get(key);
         if (entry) {
             const previousResult = entry.lastResult;
             entry.lastResult = result;
-            if (previousResult !== undefined &&
-                previousResult.isSuccess === result.isSuccess &&
-                JSON.stringify(previousResult.data) === JSON.stringify(result.data)) {
+            // Suppress re-renders when the server re-sends identical data after a reconnect.
+            // We only compare `data` and `isSuccess` — other fields (e.g. changeSet) are
+            // ephemeral and do not affect what the user sees.
+            if (previousResult !== undefined && previousResult.isSuccess === result.isSuccess && JSON.stringify(previousResult.data) === JSON.stringify(result.data)) {
                 return;
             }
-            for (const listener of entry.listeners) {
+            for (const listener of entry.listeners){
                 listener(result);
             }
         }
     }
-    addListener(key, listener) {
+    /**
+     * Registers a listener that is invoked whenever the cached result for the given key changes.
+     * @template TDataType The type of data returned by the query.
+     * @param key The cache key produced by {@link buildKey}.
+     * @param listener The callback to register.
+     */ addListener(key, listener) {
         const entry = this._entries.get(key);
         if (entry) {
             entry.listeners.add(listener);
         }
     }
-    removeListener(key, listener) {
+    /**
+     * Removes a previously registered listener.
+     * @template TDataType The type of data returned by the query.
+     * @param key The cache key produced by {@link buildKey}.
+     * @param listener The callback to remove.
+     */ removeListener(key, listener) {
         const entry = this._entries.get(key);
         if (entry) {
             entry.listeners.delete(listener);
         }
     }
-    setTeardown(key, teardown) {
+    /**
+     * Stores a teardown function for the given key and marks the entry as subscribed.
+     * Called automatically when the last subscriber releases the entry.
+     * @param key The cache key produced by {@link buildKey}.
+     * @param teardown Cleanup function that disconnects the underlying query subscription.
+     */ setTeardown(key, teardown) {
         const entry = this._entries.get(key);
         if (entry) {
             entry.teardown = teardown;
             entry.subscribed = true;
         }
     }
-    isSubscribed(key) {
+    /**
+     * Returns whether an active subscription exists for the given key.
+     * @param key The cache key to check.
+     * @returns `true` if a subscription has been established; `false` otherwise.
+     */ isSubscribed(key) {
         return this._entries.get(key)?.subscribed ?? false;
     }
-    release(key) {
+    /**
+     * Decrements the subscriber count for the given key. When the count reaches zero, both teardown
+     * and eviction are deferred by one microtask so that React StrictMode re-mounts — in any build
+     * environment — can re-acquire the entry and cancel the cleanup before the timeout fires. This
+     * prevents an unnecessary disconnect/reconnect cycle during the synthetic unmount/remount that
+     * StrictMode performs.
+     * @param key The cache key produced by {@link buildKey}.
+     */ release(key) {
         const entry = this._entries.get(key);
         if (entry) {
             entry.subscriberCount--;
             if (entry.subscriberCount <= 0) {
-                entry.pendingCleanup = setTimeout(() => {
+                // Defer both teardown and eviction.  React StrictMode re-mounts can cancel by
+                // calling acquire() before the timeout fires.  A non-zero _retentionMs keeps the
+                // entry alive so users navigating back quickly see cached data immediately.
+                entry.pendingCleanup = setTimeout(()=>{
                     const current = this._entries.get(key);
                     if (current && current.subscriberCount <= 0) {
                         current.subscribed = false;
@@ -100,11 +179,24 @@ class QueryInstanceCache {
             }
         }
     }
-    has(key) {
+    /**
+     * Returns whether an entry exists for the given key.
+     * @param key The cache key to check.
+     * @returns `true` if an entry exists; `false` otherwise.
+     */ has(key) {
         return this._entries.has(key);
     }
-    teardownAllSubscriptions() {
-        for (const [, entry] of this._entries) {
+    /**
+     * Tears down all active subscriptions and marks every entry as not subscribed,
+     * but preserves entries, subscriber counts, and listeners. This allows
+     * hooks whose effects re-run afterward to detect that the entry is no longer
+     * subscribed and re-establish a fresh connection.
+     *
+     * Use this when the underlying transport must be replaced (e.g. after an
+     * authentication change that requires new WebSocket connections with updated
+     * credentials).
+     */ teardownAllSubscriptions() {
+        for (const [, entry] of this._entries){
             if (entry.pendingCleanup !== undefined) {
                 clearTimeout(entry.pendingCleanup);
                 entry.pendingCleanup = undefined;
@@ -114,8 +206,12 @@ class QueryInstanceCache {
             entry.teardown = undefined;
         }
     }
-    dispose() {
-        for (const [, entry] of this._entries) {
+    /**
+     * Immediately tears down all subscriptions, cancels any pending deferred cleanups,
+     * and evicts all entries. Call when the owning component (e.g. the {@link Arc} provider)
+     * unmounts permanently so that all query connections are closed synchronously.
+     */ dispose() {
+        for (const [, entry] of this._entries){
             if (entry.pendingCleanup !== undefined) {
                 clearTimeout(entry.pendingCleanup);
                 entry.pendingCleanup = undefined;
@@ -126,26 +222,42 @@ class QueryInstanceCache {
         }
         this._entries.clear();
     }
-    deferDispose() {
+    /**
+     * Schedules a deferred {@link dispose} using {@code setTimeout(0)}.
+     *
+     * This allows React StrictMode re-mounts to call {@link cancelPendingDispose}
+     * before the dispose fires, avoiding the destruction of cache entries that child
+     * effects are about to re-acquire.
+     *
+     * If a deferred dispose is already pending, it is replaced.
+     */ deferDispose() {
         if (this._pendingDispose !== undefined) {
             clearTimeout(this._pendingDispose);
         }
-        this._pendingDispose = setTimeout(() => {
+        this._pendingDispose = setTimeout(()=>{
             this._pendingDispose = undefined;
             this.dispose();
         }, 0);
     }
-    cancelPendingDispose() {
+    /**
+     * Cancels a pending deferred dispose scheduled by {@link deferDispose}.
+     *
+     * Call from the {@code useEffect} setup phase so that a StrictMode re-mount
+     * prevents the synthetic unmount's deferred dispose from firing.
+     */ cancelPendingDispose() {
         if (this._pendingDispose !== undefined) {
             clearTimeout(this._pendingDispose);
             this._pendingDispose = undefined;
         }
     }
-    getDiagnosticsSnapshot() {
+    /**
+     * Returns a diagnostics snapshot of the current cache state.
+     * @returns A {@link CacheDiagnostics} describing all entries.
+     */ getDiagnosticsSnapshot() {
         const entries = [];
         let totalBytes = 0;
         let unhealthyCount = 0;
-        for (const [key, entry] of this._entries) {
+        for (const [key, entry] of this._entries){
             const colonIndex = key.indexOf('::');
             const queryName = colonIndex >= 0 ? key.substring(0, colonIndex) : key;
             let estimatedBytes = 0;
@@ -153,8 +265,8 @@ class QueryInstanceCache {
                 if (entry.lastResult !== undefined) {
                     estimatedBytes = JSON.stringify(entry.lastResult).length;
                 }
-            }
-            catch {
+            } catch  {
+            // Ignore serialization errors
             }
             if (entry.subscriberCount > 0 && !entry.subscribed) {
                 unhealthyCount++;
@@ -167,14 +279,14 @@ class QueryInstanceCache {
                 listenerCount: entry.listeners.size,
                 subscribed: entry.subscribed,
                 hasResult: entry.lastResult !== undefined,
-                estimatedBytes,
+                estimatedBytes
             });
         }
         return {
             healthy: unhealthyCount === 0,
             entryCount: this._entries.size,
             estimatedBytes: totalBytes,
-            entries,
+            entries
         };
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"QueryInstanceCache.js","sources":["../../../queries/QueryInstanceCache.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 { QueryResultWithState } from './QueryResultWithState';\nimport { CacheDiagnostics, CacheEntryDiagnostics } from './ObservableQueryDiagnosticsSnapshot';\n\n/**\n * Represents a key that uniquely identifies a query instance in the cache, based on the query type name and its serialized arguments.\n */\nexport type QueryCacheKey = string;\n\n/**\n * Callback invoked when the cached result for an entry changes.\n */\nexport type QueryCacheListener<TDataType> = (result: QueryResultWithState<TDataType>) => void;\n\n/**\n * Represents a single entry in the {@link QueryInstanceCache}.\n * @template TDataType The type of data returned by the query.\n */\nexport interface QueryCacheEntry<TDataType> {\n    /**\n     * The cached query instance.\n     */\n    readonly instance: unknown;\n\n    /**\n     * The last result received from the query, if any.\n     */\n    lastResult?: QueryResultWithState<TDataType>;\n\n    /**\n     * The number of active subscribers holding a reference to this entry.\n     */\n    subscriberCount: number;\n\n    /**\n     * Set of listener callbacks that are notified when {@link lastResult} changes.\n     */\n    readonly listeners: Set<QueryCacheListener<TDataType>>;\n\n    /**\n     * Cleanup function returned by the first subscriber that starts the query connection.\n     * Called when the last subscriber releases the entry.\n     */\n    teardown?: () => void;\n\n    /**\n     * Whether an active subscription has been established for this entry.\n     */\n    subscribed: boolean;\n\n    /**\n     * Timer handle for deferred cleanup. Allows React StrictMode re-mounts (in any build\n     * environment) to cancel the pending teardown so the connection is reused instead of\n     * torn down and recreated.\n     */\n    pendingCleanup?: ReturnType<typeof setTimeout>;\n}\n\n/**\n * Provides a cache for query instances, keyed by query type and serialized arguments.\n *\n * Two callers requesting the same query type with identical arguments receive the same\n * cached instance and immediately see the last known result — without an additional\n * round trip to the server. When the last subscriber releases its reference the entry\n * is evicted.\n */\nexport class QueryInstanceCache {\n    private readonly _entries = new Map<QueryCacheKey, QueryCacheEntry<unknown>>();\n    private _pendingDispose?: ReturnType<typeof setTimeout>;\n\n    /**\n     * Initializes a new instance of {@link QueryInstanceCache}.\n     * @param retentionMs How long in milliseconds to keep a cache entry alive after the last\n     *   subscriber releases it before evicting the subscription and cached data.  A non-zero\n     *   value lets users navigate away and back without losing cached data.  Defaults to\n     *   30 000 ms.  Pass 0 for immediate eviction.\n     */\n    constructor(private readonly _retentionMs: number = 30_000) {\n    }\n\n    /**\n     * Builds the cache key for a query.\n     * @param queryTypeName The stable type name for the query. Use the instance's {@link queryName}\n     *   (a hardcoded fully-qualified string in generated proxies) rather than {@link Function.name},\n     *   which is unstable under minification.\n     * @param args Optional arguments supplied to the query.\n     * @returns A stable string key.\n     */\n    buildKey(queryTypeName: string, args?: object): QueryCacheKey {\n        if (!args || Object.keys(args).length === 0) {\n            return `${queryTypeName}::`;\n        }\n\n        const sorted = Object.keys(args)\n            .sort()\n            .reduce<Record<string, unknown>>((accumulator, key) => {\n                accumulator[key] = (args as Record<string, unknown>)[key];\n                return accumulator;\n            }, {});\n\n        return `${queryTypeName}::${JSON.stringify(sorted)}`;\n    }\n\n    /**\n     * Returns a cached instance for the given key, or creates a new one using the provided factory.\n     * The subscriber count of the entry is incremented.\n     * @template TInstance The type of the query instance.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param factory A zero-argument factory that creates a fresh query instance when one is not yet cached.\n     * @returns The cached (or newly created) instance and whether it was newly created.\n     */\n    getOrCreate<TInstance>(\n        key: QueryCacheKey,\n        factory: () => TInstance\n    ): { instance: TInstance; isNew: boolean } {\n        if (!this._entries.has(key)) {\n            const entry: QueryCacheEntry<unknown> = {\n                instance: factory(),\n                lastResult: undefined,\n                subscriberCount: 0,\n                listeners: new Set(),\n                subscribed: false,\n            };\n\n            this._entries.set(key, entry);\n            return { instance: entry.instance as TInstance, isNew: true };\n        }\n\n        const entry = this._entries.get(key)!;\n        return { instance: entry.instance as TInstance, isNew: false };\n    }\n\n    /**\n     * Increments the active subscriber count for the given key.\n     * If a deferred cleanup was pending (from a recent {@link release}),\n     * it is cancelled so the existing subscription is reused.\n     * Call from `useEffect` setup to pair with {@link release} in the cleanup.\n     * @param key The cache key produced by {@link buildKey}.\n     */\n    acquire(key: QueryCacheKey): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            if (entry.pendingCleanup !== undefined) {\n                clearTimeout(entry.pendingCleanup);\n                entry.pendingCleanup = undefined;\n            }\n\n            entry.subscriberCount++;\n        }\n    }\n\n    /**\n     * Returns the last cached result for the given key, or `undefined` if no result has been stored yet.\n     * @template TDataType The type of data returned by the query.\n     * @param key The cache key produced by {@link buildKey}.\n     * @returns The last {@link QueryResultWithState}, or `undefined`.\n     */\n    getLastResult<TDataType>(key: QueryCacheKey): QueryResultWithState<TDataType> | undefined {\n        return this._entries.get(key)?.lastResult as QueryResultWithState<TDataType> | undefined;\n    }\n\n    /**\n     * Stores the most recent result for the given key and notifies all registered listeners.\n     * @template TDataType The type of data returned by the query.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param result The result to store.\n     */\n    setLastResult<TDataType>(key: QueryCacheKey, result: QueryResultWithState<TDataType>): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            const previousResult = entry.lastResult as QueryResultWithState<TDataType> | undefined;\n            entry.lastResult = result as QueryResultWithState<unknown>;\n\n            // Suppress re-renders when the server re-sends identical data after a reconnect.\n            // We only compare `data` and `isSuccess` — other fields (e.g. changeSet) are\n            // ephemeral and do not affect what the user sees.\n            if (\n                previousResult !== undefined &&\n                previousResult.isSuccess === result.isSuccess &&\n                JSON.stringify(previousResult.data) === JSON.stringify(result.data)\n            ) {\n                return;\n            }\n\n            for (const listener of entry.listeners) {\n                (listener as QueryCacheListener<TDataType>)(result);\n            }\n        }\n    }\n\n    /**\n     * Registers a listener that is invoked whenever the cached result for the given key changes.\n     * @template TDataType The type of data returned by the query.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param listener The callback to register.\n     */\n    addListener<TDataType>(key: QueryCacheKey, listener: QueryCacheListener<TDataType>): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.listeners.add(listener as QueryCacheListener<unknown>);\n        }\n    }\n\n    /**\n     * Removes a previously registered listener.\n     * @template TDataType The type of data returned by the query.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param listener The callback to remove.\n     */\n    removeListener<TDataType>(key: QueryCacheKey, listener: QueryCacheListener<TDataType>): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.listeners.delete(listener as QueryCacheListener<unknown>);\n        }\n    }\n\n    /**\n     * Stores a teardown function for the given key and marks the entry as subscribed.\n     * Called automatically when the last subscriber releases the entry.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param teardown Cleanup function that disconnects the underlying query subscription.\n     */\n    setTeardown(key: QueryCacheKey, teardown: () => void): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.teardown = teardown;\n            entry.subscribed = true;\n        }\n    }\n\n    /**\n     * Returns whether an active subscription exists for the given key.\n     * @param key The cache key to check.\n     * @returns `true` if a subscription has been established; `false` otherwise.\n     */\n    isSubscribed(key: QueryCacheKey): boolean {\n        return this._entries.get(key)?.subscribed ?? false;\n    }\n\n    /**\n     * Decrements the subscriber count for the given key. When the count reaches zero, both teardown\n     * and eviction are deferred by one microtask so that React StrictMode re-mounts — in any build\n     * environment — can re-acquire the entry and cancel the cleanup before the timeout fires. This\n     * prevents an unnecessary disconnect/reconnect cycle during the synthetic unmount/remount that\n     * StrictMode performs.\n     * @param key The cache key produced by {@link buildKey}.\n     */\n    release(key: QueryCacheKey): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.subscriberCount--;\n\n            if (entry.subscriberCount <= 0) {\n                // Defer both teardown and eviction.  React StrictMode re-mounts can cancel by\n                // calling acquire() before the timeout fires.  A non-zero _retentionMs keeps the\n                // entry alive so users navigating back quickly see cached data immediately.\n                entry.pendingCleanup = setTimeout(() => {\n                    const current = this._entries.get(key);\n\n                    if (current && current.subscriberCount <= 0) {\n                        current.subscribed = false;\n                        current.teardown?.();\n                        current.teardown = undefined;\n                        current.pendingCleanup = undefined;\n                        this._entries.delete(key);\n                    }\n                }, this._retentionMs);\n            }\n        }\n    }\n\n    /**\n     * Returns whether an entry exists for the given key.\n     * @param key The cache key to check.\n     * @returns `true` if an entry exists; `false` otherwise.\n     */\n    has(key: QueryCacheKey): boolean {\n        return this._entries.has(key);\n    }\n\n    /**\n     * Tears down all active subscriptions and marks every entry as not subscribed,\n     * but preserves entries, subscriber counts, and listeners. This allows\n     * hooks whose effects re-run afterward to detect that the entry is no longer\n     * subscribed and re-establish a fresh connection.\n     *\n     * Use this when the underlying transport must be replaced (e.g. after an\n     * authentication change that requires new WebSocket connections with updated\n     * credentials).\n     */\n    teardownAllSubscriptions(): void {\n        for (const [, entry] of this._entries) {\n            if (entry.pendingCleanup !== undefined) {\n                clearTimeout(entry.pendingCleanup);\n                entry.pendingCleanup = undefined;\n            }\n\n            entry.subscribed = false;\n            entry.teardown?.();\n            entry.teardown = undefined;\n        }\n    }\n\n    /**\n     * Immediately tears down all subscriptions, cancels any pending deferred cleanups,\n     * and evicts all entries. Call when the owning component (e.g. the {@link Arc} provider)\n     * unmounts permanently so that all query connections are closed synchronously.\n     */\n    dispose(): void {\n        for (const [, entry] of this._entries) {\n            if (entry.pendingCleanup !== undefined) {\n                clearTimeout(entry.pendingCleanup);\n                entry.pendingCleanup = undefined;\n            }\n\n            entry.subscribed = false;\n            entry.teardown?.();\n            entry.teardown = undefined;\n        }\n\n        this._entries.clear();\n    }\n\n    /**\n     * Schedules a deferred {@link dispose} using {@code setTimeout(0)}.\n     *\n     * This allows React StrictMode re-mounts to call {@link cancelPendingDispose}\n     * before the dispose fires, avoiding the destruction of cache entries that child\n     * effects are about to re-acquire.\n     *\n     * If a deferred dispose is already pending, it is replaced.\n     */\n    deferDispose(): void {\n        if (this._pendingDispose !== undefined) {\n            clearTimeout(this._pendingDispose);\n        }\n\n        this._pendingDispose = setTimeout(() => {\n            this._pendingDispose = undefined;\n            this.dispose();\n        }, 0);\n    }\n\n    /**\n     * Cancels a pending deferred dispose scheduled by {@link deferDispose}.\n     *\n     * Call from the {@code useEffect} setup phase so that a StrictMode re-mount\n     * prevents the synthetic unmount's deferred dispose from firing.\n     */\n    cancelPendingDispose(): void {\n        if (this._pendingDispose !== undefined) {\n            clearTimeout(this._pendingDispose);\n            this._pendingDispose = undefined;\n        }\n    }\n\n    /**\n     * Returns a diagnostics snapshot of the current cache state.\n     * @returns A {@link CacheDiagnostics} describing all entries.\n     */\n    getDiagnosticsSnapshot(): CacheDiagnostics {\n        const entries: CacheEntryDiagnostics[] = [];\n        let totalBytes = 0;\n        let unhealthyCount = 0;\n\n        for (const [key, entry] of this._entries) {\n            const colonIndex = key.indexOf('::');\n            const queryName = colonIndex >= 0 ? key.substring(0, colonIndex) : key;\n\n            let estimatedBytes = 0;\n            try {\n                if (entry.lastResult !== undefined) {\n                    estimatedBytes = JSON.stringify(entry.lastResult).length;\n                }\n            } catch {\n                // Ignore serialization errors\n            }\n\n            if (entry.subscriberCount > 0 && !entry.subscribed) {\n                unhealthyCount++;\n            }\n\n            totalBytes += estimatedBytes;\n            entries.push({\n                key,\n                queryName,\n                subscriberCount: entry.subscriberCount,\n                listenerCount: entry.listeners.size,\n                subscribed: entry.subscribed,\n                hasResult: entry.lastResult !== undefined,\n                estimatedBytes,\n            });\n        }\n\n        return {\n            healthy: unhealthyCount === 0,\n            entryCount: this._entries.size,\n            estimatedBytes: totalBytes,\n            entries,\n        };\n    }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"QueryInstanceCache.js","sources":["../../../queries/QueryInstanceCache.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 { QueryResultWithState } from './QueryResultWithState';\nimport { CacheDiagnostics, CacheEntryDiagnostics } from './ObservableQueryDiagnosticsSnapshot';\n\n/**\n * Represents a key that uniquely identifies a query instance in the cache, based on the query type name and its serialized arguments.\n */\nexport type QueryCacheKey = string;\n\n/**\n * Callback invoked when the cached result for an entry changes.\n */\nexport type QueryCacheListener<TDataType> = (result: QueryResultWithState<TDataType>) => void;\n\n/**\n * Represents a single entry in the {@link QueryInstanceCache}.\n * @template TDataType The type of data returned by the query.\n */\nexport interface QueryCacheEntry<TDataType> {\n    /**\n     * The cached query instance.\n     */\n    readonly instance: unknown;\n\n    /**\n     * The last result received from the query, if any.\n     */\n    lastResult?: QueryResultWithState<TDataType>;\n\n    /**\n     * The number of active subscribers holding a reference to this entry.\n     */\n    subscriberCount: number;\n\n    /**\n     * Set of listener callbacks that are notified when {@link lastResult} changes.\n     */\n    readonly listeners: Set<QueryCacheListener<TDataType>>;\n\n    /**\n     * Cleanup function returned by the first subscriber that starts the query connection.\n     * Called when the last subscriber releases the entry.\n     */\n    teardown?: () => void;\n\n    /**\n     * Whether an active subscription has been established for this entry.\n     */\n    subscribed: boolean;\n\n    /**\n     * Timer handle for deferred cleanup. Allows React StrictMode re-mounts (in any build\n     * environment) to cancel the pending teardown so the connection is reused instead of\n     * torn down and recreated.\n     */\n    pendingCleanup?: ReturnType<typeof setTimeout>;\n}\n\n/**\n * Provides a cache for query instances, keyed by query type and serialized arguments.\n *\n * Two callers requesting the same query type with identical arguments receive the same\n * cached instance and immediately see the last known result — without an additional\n * round trip to the server. When the last subscriber releases its reference the entry\n * is evicted.\n */\nexport class QueryInstanceCache {\n    private readonly _entries = new Map<QueryCacheKey, QueryCacheEntry<unknown>>();\n    private _pendingDispose?: ReturnType<typeof setTimeout>;\n\n    /**\n     * Initializes a new instance of {@link QueryInstanceCache}.\n     * @param retentionMs How long in milliseconds to keep a cache entry alive after the last\n     *   subscriber releases it before evicting the subscription and cached data.  A non-zero\n     *   value lets users navigate away and back without losing cached data.  Defaults to\n     *   30 000 ms.  Pass 0 for immediate eviction.\n     */\n    constructor(private readonly _retentionMs: number = 30_000) {\n    }\n\n    /**\n     * Builds the cache key for a query.\n     * @param queryTypeName The stable type name for the query. Use the instance's {@link queryName}\n     *   (a hardcoded fully-qualified string in generated proxies) rather than {@link Function.name},\n     *   which is unstable under minification.\n     * @param args Optional arguments supplied to the query.\n     * @returns A stable string key.\n     */\n    buildKey(queryTypeName: string, args?: object): QueryCacheKey {\n        if (!args || Object.keys(args).length === 0) {\n            return `${queryTypeName}::`;\n        }\n\n        const sorted = Object.keys(args)\n            .sort()\n            .reduce<Record<string, unknown>>((accumulator, key) => {\n                accumulator[key] = (args as Record<string, unknown>)[key];\n                return accumulator;\n            }, {});\n\n        return `${queryTypeName}::${JSON.stringify(sorted)}`;\n    }\n\n    /**\n     * Returns a cached instance for the given key, or creates a new one using the provided factory.\n     * The subscriber count of the entry is incremented.\n     * @template TInstance The type of the query instance.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param factory A zero-argument factory that creates a fresh query instance when one is not yet cached.\n     * @returns The cached (or newly created) instance and whether it was newly created.\n     */\n    getOrCreate<TInstance>(\n        key: QueryCacheKey,\n        factory: () => TInstance\n    ): { instance: TInstance; isNew: boolean } {\n        if (!this._entries.has(key)) {\n            const entry: QueryCacheEntry<unknown> = {\n                instance: factory(),\n                lastResult: undefined,\n                subscriberCount: 0,\n                listeners: new Set(),\n                subscribed: false,\n            };\n\n            this._entries.set(key, entry);\n            return { instance: entry.instance as TInstance, isNew: true };\n        }\n\n        const entry = this._entries.get(key)!;\n        return { instance: entry.instance as TInstance, isNew: false };\n    }\n\n    /**\n     * Increments the active subscriber count for the given key.\n     * If a deferred cleanup was pending (from a recent {@link release}),\n     * it is cancelled so the existing subscription is reused.\n     * Call from `useEffect` setup to pair with {@link release} in the cleanup.\n     * @param key The cache key produced by {@link buildKey}.\n     */\n    acquire(key: QueryCacheKey): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            if (entry.pendingCleanup !== undefined) {\n                clearTimeout(entry.pendingCleanup);\n                entry.pendingCleanup = undefined;\n            }\n\n            entry.subscriberCount++;\n        }\n    }\n\n    /**\n     * Returns the last cached result for the given key, or `undefined` if no result has been stored yet.\n     * @template TDataType The type of data returned by the query.\n     * @param key The cache key produced by {@link buildKey}.\n     * @returns The last {@link QueryResultWithState}, or `undefined`.\n     */\n    getLastResult<TDataType>(key: QueryCacheKey): QueryResultWithState<TDataType> | undefined {\n        return this._entries.get(key)?.lastResult as QueryResultWithState<TDataType> | undefined;\n    }\n\n    /**\n     * Stores the most recent result for the given key and notifies all registered listeners.\n     * @template TDataType The type of data returned by the query.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param result The result to store.\n     */\n    setLastResult<TDataType>(key: QueryCacheKey, result: QueryResultWithState<TDataType>): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            const previousResult = entry.lastResult as QueryResultWithState<TDataType> | undefined;\n            entry.lastResult = result as QueryResultWithState<unknown>;\n\n            // Suppress re-renders when the server re-sends identical data after a reconnect.\n            // We only compare `data` and `isSuccess` — other fields (e.g. changeSet) are\n            // ephemeral and do not affect what the user sees.\n            if (\n                previousResult !== undefined &&\n                previousResult.isSuccess === result.isSuccess &&\n                JSON.stringify(previousResult.data) === JSON.stringify(result.data)\n            ) {\n                return;\n            }\n\n            for (const listener of entry.listeners) {\n                (listener as QueryCacheListener<TDataType>)(result);\n            }\n        }\n    }\n\n    /**\n     * Registers a listener that is invoked whenever the cached result for the given key changes.\n     * @template TDataType The type of data returned by the query.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param listener The callback to register.\n     */\n    addListener<TDataType>(key: QueryCacheKey, listener: QueryCacheListener<TDataType>): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.listeners.add(listener as QueryCacheListener<unknown>);\n        }\n    }\n\n    /**\n     * Removes a previously registered listener.\n     * @template TDataType The type of data returned by the query.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param listener The callback to remove.\n     */\n    removeListener<TDataType>(key: QueryCacheKey, listener: QueryCacheListener<TDataType>): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.listeners.delete(listener as QueryCacheListener<unknown>);\n        }\n    }\n\n    /**\n     * Stores a teardown function for the given key and marks the entry as subscribed.\n     * Called automatically when the last subscriber releases the entry.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param teardown Cleanup function that disconnects the underlying query subscription.\n     */\n    setTeardown(key: QueryCacheKey, teardown: () => void): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.teardown = teardown;\n            entry.subscribed = true;\n        }\n    }\n\n    /**\n     * Returns whether an active subscription exists for the given key.\n     * @param key The cache key to check.\n     * @returns `true` if a subscription has been established; `false` otherwise.\n     */\n    isSubscribed(key: QueryCacheKey): boolean {\n        return this._entries.get(key)?.subscribed ?? false;\n    }\n\n    /**\n     * Decrements the subscriber count for the given key. When the count reaches zero, both teardown\n     * and eviction are deferred by one microtask so that React StrictMode re-mounts — in any build\n     * environment — can re-acquire the entry and cancel the cleanup before the timeout fires. This\n     * prevents an unnecessary disconnect/reconnect cycle during the synthetic unmount/remount that\n     * StrictMode performs.\n     * @param key The cache key produced by {@link buildKey}.\n     */\n    release(key: QueryCacheKey): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.subscriberCount--;\n\n            if (entry.subscriberCount <= 0) {\n                // Defer both teardown and eviction.  React StrictMode re-mounts can cancel by\n                // calling acquire() before the timeout fires.  A non-zero _retentionMs keeps the\n                // entry alive so users navigating back quickly see cached data immediately.\n                entry.pendingCleanup = setTimeout(() => {\n                    const current = this._entries.get(key);\n\n                    if (current && current.subscriberCount <= 0) {\n                        current.subscribed = false;\n                        current.teardown?.();\n                        current.teardown = undefined;\n                        current.pendingCleanup = undefined;\n                        this._entries.delete(key);\n                    }\n                }, this._retentionMs);\n            }\n        }\n    }\n\n    /**\n     * Returns whether an entry exists for the given key.\n     * @param key The cache key to check.\n     * @returns `true` if an entry exists; `false` otherwise.\n     */\n    has(key: QueryCacheKey): boolean {\n        return this._entries.has(key);\n    }\n\n    /**\n     * Tears down all active subscriptions and marks every entry as not subscribed,\n     * but preserves entries, subscriber counts, and listeners. This allows\n     * hooks whose effects re-run afterward to detect that the entry is no longer\n     * subscribed and re-establish a fresh connection.\n     *\n     * Use this when the underlying transport must be replaced (e.g. after an\n     * authentication change that requires new WebSocket connections with updated\n     * credentials).\n     */\n    teardownAllSubscriptions(): void {\n        for (const [, entry] of this._entries) {\n            if (entry.pendingCleanup !== undefined) {\n                clearTimeout(entry.pendingCleanup);\n                entry.pendingCleanup = undefined;\n            }\n\n            entry.subscribed = false;\n            entry.teardown?.();\n            entry.teardown = undefined;\n        }\n    }\n\n    /**\n     * Immediately tears down all subscriptions, cancels any pending deferred cleanups,\n     * and evicts all entries. Call when the owning component (e.g. the {@link Arc} provider)\n     * unmounts permanently so that all query connections are closed synchronously.\n     */\n    dispose(): void {\n        for (const [, entry] of this._entries) {\n            if (entry.pendingCleanup !== undefined) {\n                clearTimeout(entry.pendingCleanup);\n                entry.pendingCleanup = undefined;\n            }\n\n            entry.subscribed = false;\n            entry.teardown?.();\n            entry.teardown = undefined;\n        }\n\n        this._entries.clear();\n    }\n\n    /**\n     * Schedules a deferred {@link dispose} using {@code setTimeout(0)}.\n     *\n     * This allows React StrictMode re-mounts to call {@link cancelPendingDispose}\n     * before the dispose fires, avoiding the destruction of cache entries that child\n     * effects are about to re-acquire.\n     *\n     * If a deferred dispose is already pending, it is replaced.\n     */\n    deferDispose(): void {\n        if (this._pendingDispose !== undefined) {\n            clearTimeout(this._pendingDispose);\n        }\n\n        this._pendingDispose = setTimeout(() => {\n            this._pendingDispose = undefined;\n            this.dispose();\n        }, 0);\n    }\n\n    /**\n     * Cancels a pending deferred dispose scheduled by {@link deferDispose}.\n     *\n     * Call from the {@code useEffect} setup phase so that a StrictMode re-mount\n     * prevents the synthetic unmount's deferred dispose from firing.\n     */\n    cancelPendingDispose(): void {\n        if (this._pendingDispose !== undefined) {\n            clearTimeout(this._pendingDispose);\n            this._pendingDispose = undefined;\n        }\n    }\n\n    /**\n     * Returns a diagnostics snapshot of the current cache state.\n     * @returns A {@link CacheDiagnostics} describing all entries.\n     */\n    getDiagnosticsSnapshot(): CacheDiagnostics {\n        const entries: CacheEntryDiagnostics[] = [];\n        let totalBytes = 0;\n        let unhealthyCount = 0;\n\n        for (const [key, entry] of this._entries) {\n            const colonIndex = key.indexOf('::');\n            const queryName = colonIndex >= 0 ? key.substring(0, colonIndex) : key;\n\n            let estimatedBytes = 0;\n            try {\n                if (entry.lastResult !== undefined) {\n                    estimatedBytes = JSON.stringify(entry.lastResult).length;\n                }\n            } catch {\n                // Ignore serialization errors\n            }\n\n            if (entry.subscriberCount > 0 && !entry.subscribed) {\n                unhealthyCount++;\n            }\n\n            totalBytes += estimatedBytes;\n            entries.push({\n                key,\n                queryName,\n                subscriberCount: entry.subscriberCount,\n                listenerCount: entry.listeners.size,\n                subscribed: entry.subscribed,\n                hasResult: entry.lastResult !== undefined,\n                estimatedBytes,\n            });\n        }\n\n        return {\n            healthy: unhealthyCount === 0,\n            entryCount: this._entries.size,\n            estimatedBytes: totalBytes,\n            entries,\n        };\n    }\n}\n"],"names":["QueryInstanceCache","_entries","Map","_pendingDispose","_retentionMs","buildKey","queryTypeName","args","Object","keys","length","sorted","sort","reduce","accumulator","key","JSON","stringify","getOrCreate","factory","has","entry","instance","lastResult","undefined","subscriberCount","listeners","Set","subscribed","set","isNew","get","acquire","pendingCleanup","clearTimeout","getLastResult","setLastResult","result","previousResult","isSuccess","data","listener","addListener","add","removeListener","delete","setTeardown","teardown","isSubscribed","release","setTimeout","current","teardownAllSubscriptions","dispose","clear","deferDispose","cancelPendingDispose","getDiagnosticsSnapshot","entries","totalBytes","unhealthyCount","colonIndex","indexOf","queryName","substring","estimatedBytes","push","listenerCount","size","hasResult","healthy","entryCount"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryProvider.d.ts","sourceRoot":"","sources":["../../../queries/QueryProvider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKnD,qBAAa,aAAc,YAAW,cAAc;IAU5C,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAHpB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,cAAc;IAGzD,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;CAQtD"}
+{"version":3,"file":"QueryProvider.d.ts","sourceRoot":"","sources":["../../../queries/QueryProvider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKnD,qBAAa,aAAc,YAAW,cAAc;IAU5C,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IAJzC,YACqB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,cAAc,EAAK;IAG9D,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAOlD;CACJ"}

package/dist/esm/queries/QueryProvider.js

@@ -1,15 +1,25 @@
-class QueryProvider {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents an implementation of {@link IQueryProvider}
+ */ class QueryProvider {
     _microservice;
     _apiBasePath;
     _origin;
     _httpHeadersCallback;
-    constructor(_microservice, _apiBasePath, _origin, _httpHeadersCallback) {
+    /**
+     * Initializes a new instance of {@link QueryProvider}
+     * @param _microservice Name of the microservice to provide queries for.
+     * @param _apiBasePath Base path for the API to use for the query.
+     * @param _origin Origin to use for the query.
+     * @param _httpHeadersCallback Callback to get HTTP headers for the query.
+     */ constructor(_microservice, _apiBasePath, _origin, _httpHeadersCallback){
         this._microservice = _microservice;
         this._apiBasePath = _apiBasePath;
         this._origin = _origin;
         this._httpHeadersCallback = _httpHeadersCallback;
     }
-    get(queryType) {
+    /** @inheritdoc */ get(queryType) {
         const query = new queryType();
         query.setMicroservice(this._microservice);
         query.setApiBasePath(this._apiBasePath);

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

@@ -1 +1 @@
-{"version":3,"file":"QueryProvider.js","sources":["../../../queries/QueryProvider.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 { Constructor } from '@cratis/fundamentals';\nimport { IQueryProvider } from './IQueryProvider';\nimport { IQuery } from './IQuery';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\n\n/**\n * Represents an implementation of {@link IQueryProvider}\n */\nexport class QueryProvider implements IQueryProvider {\n\n    /**\n     * Initializes a new instance of {@link QueryProvider}\n     * @param _microservice Name of the microservice to provide queries for.\n     * @param _apiBasePath Base path for the API to use for the query.\n     * @param _origin Origin to use for the query.\n     * @param _httpHeadersCallback Callback to get HTTP headers for the query.\n     */\n    constructor(\n        private readonly _microservice: string,\n        private readonly _apiBasePath: string,\n        private readonly _origin: string,\n        private readonly _httpHeadersCallback: GetHttpHeaders) { }\n\n    /** @inheritdoc */\n    get<T extends IQuery>(queryType: Constructor<T>): T {\n        const query = new queryType();\n        query.setMicroservice(this._microservice);\n        query.setApiBasePath(this._apiBasePath);\n        query.setOrigin(this._origin);\n        query.setHttpHeadersCallback(this._httpHeadersCallback);\n        return query;\n    }\n}"],"names":[],"mappings":"MAWa,aAAa,CAAA;AAUD,IAAA,aAAA;AACA,IAAA,YAAA;AACA,IAAA,OAAA;AACA,IAAA,oBAAA;AAJrB,IAAA,WAAA,CACqB,aAAqB,EACrB,YAAoB,EACpB,OAAe,EACf,oBAAoC,EAAA;QAHpC,IAAA,CAAA,aAAa,GAAb,aAAa;QACb,IAAA,CAAA,YAAY,GAAZ,YAAY;QACZ,IAAA,CAAA,OAAO,GAAP,OAAO;QACP,IAAA,CAAA,oBAAoB,GAApB,oBAAoB;IAAoB;AAG7D,IAAA,GAAG,CAAmB,SAAyB,EAAA;AAC3C,QAAA,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE;AAC7B,QAAA,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC;AACzC,QAAA,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC;AACvC,QAAA,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;AAC7B,QAAA,KAAK,CAAC,sBAAsB,CAAC,IAAI,CAAC,oBAAoB,CAAC;AACvD,QAAA,OAAO,KAAK;IAChB;AACH;;;;"}
+{"version":3,"file":"QueryProvider.js","sources":["../../../queries/QueryProvider.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 { Constructor } from '@cratis/fundamentals';\nimport { IQueryProvider } from './IQueryProvider';\nimport { IQuery } from './IQuery';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\n\n/**\n * Represents an implementation of {@link IQueryProvider}\n */\nexport class QueryProvider implements IQueryProvider {\n\n    /**\n     * Initializes a new instance of {@link QueryProvider}\n     * @param _microservice Name of the microservice to provide queries for.\n     * @param _apiBasePath Base path for the API to use for the query.\n     * @param _origin Origin to use for the query.\n     * @param _httpHeadersCallback Callback to get HTTP headers for the query.\n     */\n    constructor(\n        private readonly _microservice: string,\n        private readonly _apiBasePath: string,\n        private readonly _origin: string,\n        private readonly _httpHeadersCallback: GetHttpHeaders) { }\n\n    /** @inheritdoc */\n    get<T extends IQuery>(queryType: Constructor<T>): T {\n        const query = new queryType();\n        query.setMicroservice(this._microservice);\n        query.setApiBasePath(this._apiBasePath);\n        query.setOrigin(this._origin);\n        query.setHttpHeadersCallback(this._httpHeadersCallback);\n        return query;\n    }\n}"],"names":["QueryProvider","_microservice","_origin","_apiBasePath","_httpHeadersCallback","get","queryType","query","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback"],"mappings":"AAAA;AACA;AAOA;;AAEC,IACM,MAAMA,aAAAA,CAAAA;;;;;AAET;;;;;;AAMC,QACD,WAAA,CACqBC,aAAqB,EACtC,YAAqC,EACpBC,OAAe,EAChC,oBAAqD,CAAE;aAHtCD,aAAAA,GAAAA,aAAAA;aACAE,YAAAA,GAAAA,YAAAA;aACAD,OAAAA,GAAAA,OAAAA;aACAE,oBAAAA,GAAAA,oBAAAA;AAAwC,IAAA;uBAG7DC,GAAAA,CAAsBC,SAAyB,EAAK;AAChD,QAAA,MAAMC,QAAQ,IAAID,SAAAA,EAAAA;AAClBC,QAAAA,KAAAA,CAAMC,eAAe,CAAC,IAAI,CAACP,aAAa,CAAA;AACxCM,QAAAA,KAAAA,CAAME,cAAc,CAAC,IAAI,CAACN,YAAY,CAAA;AACtCI,QAAAA,KAAAA,CAAMG,SAAS,CAAC,IAAI,CAACR,OAAO,CAAA;AAC5BK,QAAAA,KAAAA,CAAMI,sBAAsB,CAAC,IAAI,CAACP,oBAAoB,CAAA;QACtD,OAAOG,KAAAA;AACX,IAAA;AACJ;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryResult.d.ts","sourceRoot":"","sources":["../../../queries/QueryResult.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAkB,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,KAAK,iBAAiB,GAAG;IAErB,IAAI,EAAE,GAAG,CAAC;IAEV,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B,CAAA;AAED,KAAK,eAAe,GAAG;IAEnB,KAAK,EAAE,GAAG,EAAE,CAAC;IAEb,QAAQ,EAAE,GAAG,EAAE,CAAC;IAEhB,OAAO,EAAE,GAAG,EAAE,CAAC;CAClB,CAAA;AAED,KAAK,sBAAsB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAA;AAED,KAAK,gBAAgB,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAA;AAMD,qBAAa,WAAW,CAAC,SAAS,GAAG,MAAM,CAAE,YAAW,YAAY,CAAC,SAAS,CAAC;IAE3E,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;IAoBxE,MAAM,CAAC,YAAY,CAAC,SAAS,KAAK,WAAW,CAAC,SAAS,CAAC;IAmBxD,MAAM,CAAC,SAAS,EAAE,WAAW,CAeX;gBAQN,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO;IAmDrF,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAGzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAG5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAG5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAG/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAG1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAGhC,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAG/C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAGrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAQrC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAKxC,IAAI,OAAO,IAAI,OAAO,CAQrB;CACJ"}
+{"version":3,"file":"QueryResult.d.ts","sourceRoot":"","sources":["../../../queries/QueryResult.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAkB,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,KAAK,iBAAiB,GAAG;IAErB,IAAI,EAAE,GAAG,CAAC;IAEV,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B,CAAA;AAED,KAAK,eAAe,GAAG;IAEnB,KAAK,EAAE,GAAG,EAAE,CAAC;IAEb,QAAQ,EAAE,GAAG,EAAE,CAAC;IAEhB,OAAO,EAAE,GAAG,EAAE,CAAC;CAClB,CAAA;AAED,KAAK,sBAAsB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAA;AAED,KAAK,gBAAgB,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAA;AAMD,qBAAa,WAAW,CAAC,SAAS,GAAG,MAAM,CAAE,YAAW,YAAY,CAAC,SAAS,CAAC;IAE3E,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAkBvE;IAED,MAAM,CAAC,YAAY,CAAC,SAAS,KAAK,WAAW,CAAC,SAAS,CAAC,CAiBvD;IAED,MAAM,CAAC,SAAS,EAAE,WAAW,CAeX;IAQlB,YAAY,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAgDpF;IAGD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAGzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAG5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAG5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAG/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAG1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAGhC,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAG/C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAGrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAQrC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAKxC,IAAI,OAAO,IAAI,OAAO,CAQrB;CACJ"}

package/dist/esm/queries/QueryResult.js

@@ -2,7 +2,12 @@ import { JsonSerializer } from '@cratis/fundamentals';
 import { ValidationResult } from '../validation/ValidationResult.js';
 import { PagingInfo } from './PagingInfo.js';
 
-class QueryResult {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents the result from executing a {@link IQueryFor}.
+ * @template TDataType The data type.
+ */ class QueryResult {
     static empty(defaultValue) {
         return new QueryResult({
             data: defaultValue,
@@ -55,12 +60,17 @@ class QueryResult {
             size: 0
         }
     }, Object, false);
-    constructor(result, instanceType, enumerable) {
+    /**
+     * Creates an instance of query result.
+     * @param {*} result The raw result from the backend.
+     * @param {Constructor} instanceType The type of instance to deserialize.
+     * @param {boolean} enumerable Whether or not the result is supposed be an enumerable or not.
+     */ constructor(result, instanceType, enumerable){
         this.isSuccess = result.isSuccess;
         this.isAuthorized = result.isAuthorized;
         this.isValid = result.isValid;
         this.hasExceptions = result.hasExceptions;
-        this.validationResults = result.validationResults.map(_ => new ValidationResult(_.severity, _.message, _.members, _.state));
+        this.validationResults = result.validationResults.map((_)=>new ValidationResult(_.severity, _.message, _.members, _.state));
         this.exceptionMessages = result.exceptionMessages;
         this.exceptionStackTrace = result.exceptionStackTrace;
         this.paging = new PagingInfo();
@@ -73,48 +83,44 @@ class QueryResult {
             const isPrimitive = instanceType === String || instanceType === Number || instanceType === Boolean;
             if (enumerable) {
                 if (Array.isArray(result.data)) {
-                    data = isPrimitive
-                        ? Array.from(result.data)
-                        : JsonSerializer.deserializeArrayFromInstance(instanceType, data);
-                }
-                else {
+                    data = isPrimitive ? Array.from(result.data) : JsonSerializer.deserializeArrayFromInstance(instanceType, data);
+                } else {
                     data = [];
                 }
-            }
-            else {
+            } else {
                 data = isPrimitive ? data : JsonSerializer.deserializeFromInstance(instanceType, data);
             }
             this.data = data;
-        }
-        else {
-            this.data = (enumerable ? [] : null);
+        } else {
+            this.data = enumerable ? [] : null;
         }
         if (enumerable && result.changeSet) {
             const isPrimitive = instanceType === String || instanceType === Number || instanceType === Boolean;
             this.changeSet = {
-                added: isPrimitive
-                    ? Array.from(result.changeSet.added ?? [])
-                    : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.added ?? []),
-                replaced: isPrimitive
-                    ? Array.from(result.changeSet.replaced ?? [])
-                    : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.replaced ?? []),
-                removed: isPrimitive
-                    ? Array.from(result.changeSet.removed ?? [])
-                    : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.removed ?? []),
+                added: isPrimitive ? Array.from(result.changeSet.added ?? []) : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.added ?? []),
+                replaced: isPrimitive ? Array.from(result.changeSet.replaced ?? []) : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.replaced ?? []),
+                removed: isPrimitive ? Array.from(result.changeSet.removed ?? []) : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.removed ?? [])
             };
         }
     }
-    data;
-    paging;
-    isSuccess;
-    isAuthorized;
-    isValid;
-    hasExceptions;
-    validationResults;
-    exceptionMessages;
-    exceptionStackTrace;
-    changeSet;
-    get hasData() {
+    /** @inheritdoc */ data;
+    /** @inheritdoc */ paging;
+    /** @inheritdoc */ isSuccess;
+    /** @inheritdoc */ isAuthorized;
+    /** @inheritdoc */ isValid;
+    /** @inheritdoc */ hasExceptions;
+    /** @inheritdoc */ validationResults;
+    /** @inheritdoc */ exceptionMessages;
+    /** @inheritdoc */ exceptionStackTrace;
+    /**
+     * Gets the optional change set describing what changed since the previous update.
+     * Set by the server when the delta transfer mode is active.
+     * When present, clients can apply the delta to their local state rather than replacing
+     * the full dataset.
+     */ changeSet;
+    /**
+     * Gets whether or not the query has data.
+     */ get hasData() {
         if (this.data) {
             if (Array.isArray(this.data)) {
                 return this.data.length > 0;