@cratis/arc 20.54.4 → 20.54.7

package/dist/cjs/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":";;MAoEa,kBAAkB,CAAA;AAWE,IAAA,YAAA;AAVZ,IAAA,QAAQ,GAAG,IAAI,GAAG,EAA2C;AACtE,IAAA,eAAe;AASvB,IAAA,WAAA,CAA6B,eAAuB,MAAM,EAAA;QAA7B,IAAA,CAAA,YAAY,GAAZ,YAAY;IACzC;IAUA,QAAQ,CAAC,aAAqB,EAAE,IAAa,EAAA;AACzC,QAAA,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE;YACzC,OAAO,CAAA,EAAG,aAAa,CAAA,EAAA,CAAI;QAC/B;AAEA,QAAA,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI;AAC1B,aAAA,IAAI;AACJ,aAAA,MAAM,CAA0B,CAAC,WAAW,EAAE,GAAG,KAAI;YAClD,WAAW,CAAC,GAAG,CAAC,GAAI,IAAgC,CAAC,GAAG,CAAC;AACzD,YAAA,OAAO,WAAW;QACtB,CAAC,EAAE,EAAE,CAAC;QAEV,OAAO,CAAA,EAAG,aAAa,CAAA,EAAA,EAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA,CAAE;IACxD;IAUA,WAAW,CACP,GAAkB,EAClB,OAAwB,EAAA;QAExB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AACzB,YAAA,MAAM,KAAK,GAA6B;gBACpC,QAAQ,EAAE,OAAO,EAAE;AACnB,gBAAA,UAAU,EAAE,SAAS;AACrB,gBAAA,eAAe,EAAE,CAAC;gBAClB,SAAS,EAAE,IAAI,GAAG,EAAE;AACpB,gBAAA,UAAU,EAAE,KAAK;aACpB;YAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;YAC7B,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAqB,EAAE,KAAK,EAAE,IAAI,EAAE;QACjE;QAEA,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAE;QACrC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAqB,EAAE,KAAK,EAAE,KAAK,EAAE;IAClE;AASA,IAAA,OAAO,CAAC,GAAkB,EAAA;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAEpC,IAAI,KAAK,EAAE;AACP,YAAA,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE;AACpC,gBAAA,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC;AAClC,gBAAA,KAAK,CAAC,cAAc,GAAG,SAAS;YACpC;YAEA,KAAK,CAAC,eAAe,EAAE;QAC3B;IACJ;AAQA,IAAA,aAAa,CAAY,GAAkB,EAAA;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,UAAyD;IAC5F;IAQA,aAAa,CAAY,GAAkB,EAAE,MAAuC,EAAA;QAChF,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAEpC,IAAI,KAAK,EAAE;AACP,YAAA,MAAM,cAAc,GAAG,KAAK,CAAC,UAAyD;AACtF,YAAA,KAAK,CAAC,UAAU,GAAG,MAAuC;YAK1D,IACI,cAAc,KAAK,SAAS;AAC5B,gBAAA,cAAc,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;AAC7C,gBAAA,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EACrE;gBACE;YACJ;AAEA,YAAA,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE;gBACnC,QAA0C,CAAC,MAAM,CAAC;YACvD;QACJ;IACJ;IAQA,WAAW,CAAY,GAAkB,EAAE,QAAuC,EAAA;QAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAEpC,IAAI,KAAK,EAAE;AACP,YAAA,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAuC,CAAC;QAChE;IACJ;IAQA,cAAc,CAAY,GAAkB,EAAE,QAAuC,EAAA;QACjF,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAEpC,IAAI,KAAK,EAAE;AACP,YAAA,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAuC,CAAC;QACnE;IACJ;IAQA,WAAW,CAAC,GAAkB,EAAE,QAAoB,EAAA;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAEpC,IAAI,KAAK,EAAE;AACP,YAAA,KAAK,CAAC,QAAQ,GAAG,QAAQ;AACzB,YAAA,KAAK,CAAC,UAAU,GAAG,IAAI;QAC3B;IACJ;AAOA,IAAA,YAAY,CAAC,GAAkB,EAAA;AAC3B,QAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,UAAU,IAAI,KAAK;IACtD;AAUA,IAAA,OAAO,CAAC,GAAkB,EAAA;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAEpC,IAAI,KAAK,EAAE;YACP,KAAK,CAAC,eAAe,EAAE;AAEvB,YAAA,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,EAAE;AAI5B,gBAAA,KAAK,CAAC,cAAc,GAAG,UAAU,CAAC,MAAK;oBACnC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;oBAEtC,IAAI,OAAO,IAAI,OAAO,CAAC,eAAe,IAAI,CAAC,EAAE;AACzC,wBAAA,OAAO,CAAC,UAAU,GAAG,KAAK;AAC1B,wBAAA,OAAO,CAAC,QAAQ,IAAI;AACpB,wBAAA,OAAO,CAAC,QAAQ,GAAG,SAAS;AAC5B,wBAAA,OAAO,CAAC,cAAc,GAAG,SAAS;AAClC,wBAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;oBAC7B;AACJ,gBAAA,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC;YACzB;QACJ;IACJ;AAOA,IAAA,GAAG,CAAC,GAAkB,EAAA;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;IACjC;IAYA,wBAAwB,GAAA;QACpB,KAAK,MAAM,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE;AACnC,YAAA,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE;AACpC,gBAAA,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC;AAClC,gBAAA,KAAK,CAAC,cAAc,GAAG,SAAS;YACpC;AAEA,YAAA,KAAK,CAAC,UAAU,GAAG,KAAK;AACxB,YAAA,KAAK,CAAC,QAAQ,IAAI;AAClB,YAAA,KAAK,CAAC,QAAQ,GAAG,SAAS;QAC9B;IACJ;IAOA,OAAO,GAAA;QACH,KAAK,MAAM,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE;AACnC,YAAA,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE;AACpC,gBAAA,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC;AAClC,gBAAA,KAAK,CAAC,cAAc,GAAG,SAAS;YACpC;AAEA,YAAA,KAAK,CAAC,UAAU,GAAG,KAAK;AACxB,YAAA,KAAK,CAAC,QAAQ,IAAI;AAClB,YAAA,KAAK,CAAC,QAAQ,GAAG,SAAS;QAC9B;AAEA,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;IACzB;IAWA,YAAY,GAAA;AACR,QAAA,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE;AACpC,YAAA,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC;QACtC;AAEA,QAAA,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,MAAK;AACnC,YAAA,IAAI,CAAC,eAAe,GAAG,SAAS;YAChC,IAAI,CAAC,OAAO,EAAE;QAClB,CAAC,EAAE,CAAC,CAAC;IACT;IAQA,oBAAoB,GAAA;AAChB,QAAA,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE;AACpC,YAAA,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC;AAClC,YAAA,IAAI,CAAC,eAAe,GAAG,SAAS;QACpC;IACJ;IAMA,sBAAsB,GAAA;QAClB,MAAM,OAAO,GAA4B,EAAE;QAC3C,IAAI,UAAU,GAAG,CAAC;QAClB,IAAI,cAAc,GAAG,CAAC;QAEtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE;YACtC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;YACpC,MAAM,SAAS,GAAG,UAAU,IAAI,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,GAAG;YAEtE,IAAI,cAAc,GAAG,CAAC;AACtB,YAAA,IAAI;AACA,gBAAA,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE;oBAChC,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM;gBAC5D;YACJ;AAAE,YAAA,MAAM;YAER;YAEA,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE;AAChD,gBAAA,cAAc,EAAE;YACpB;YAEA,UAAU,IAAI,cAAc;YAC5B,OAAO,CAAC,IAAI,CAAC;gBACT,GAAG;gBACH,SAAS;gBACT,eAAe,EAAE,KAAK,CAAC,eAAe;AACtC,gBAAA,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI;gBACnC,UAAU,EAAE,KAAK,CAAC,UAAU;AAC5B,gBAAA,SAAS,EAAE,KAAK,CAAC,UAAU,KAAK,SAAS;gBACzC,cAAc;AACjB,aAAA,CAAC;QACN;QAEA,OAAO;YACH,OAAO,EAAE,cAAc,KAAK,CAAC;AAC7B,YAAA,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;AAC9B,YAAA,cAAc,EAAE,UAAU;YAC1B,OAAO;SACV;IACL;AACH;;;;"}
+{"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":";;AAAA;AACA;AA2DA;;;;;;;AAOC,IACM,MAAMA,kBAAAA,CAAAA;;AACQC,IAAAA,QAAAA,GAAW,IAAIC,GAAAA,EAAAA;IACxBC,eAAAA;AAER;;;;;;AAMC,QACD,WAAA,CAA6BC,YAAAA,GAAuB,MAAM,CAAE;aAA/BA,YAAAA,GAAAA,YAAAA;AAC7B,IAAA;AAEA;;;;;;;AAOC,QACDC,QAAAA,CAASC,aAAqB,EAAEC,IAAa,EAAiB;QAC1D,IAAI,CAACA,QAAQC,MAAAA,CAAOC,IAAI,CAACF,IAAAA,CAAAA,CAAMG,MAAM,KAAK,CAAA,EAAG;YACzC,OAAO,CAAA,EAAGJ,aAAAA,CAAc,EAAE,CAAC;AAC/B,QAAA;QAEA,MAAMK,MAAAA,GAASH,MAAAA,CAAOC,IAAI,CAACF,IAAAA,CAAAA,CACtBK,IAAI,EAAA,CACJC,MAAM,CAA0B,CAACC,WAAAA,EAAaC,GAAAA,GAAAA;AAC3CD,YAAAA,WAAW,CAACC,GAAAA,CAAI,GAAG,IAAiC,CAACA,GAAAA,CAAI;YACzD,OAAOD,WAAAA;AACX,QAAA,CAAA,EAAG,EAAC,CAAA;AAER,QAAA,OAAO,GAAGR,aAAAA,CAAc,EAAE,EAAEU,IAAAA,CAAKC,SAAS,CAACN,MAAAA,CAAAA,CAAAA,CAAS;AACxD,IAAA;AAEA;;;;;;;AAOC,QACDO,WAAAA,CACIH,GAAkB,EAClBI,OAAwB,EACe;AACvC,QAAA,IAAI,CAAC,IAAI,CAAClB,QAAQ,CAACmB,GAAG,CAACL,GAAAA,CAAAA,EAAM;AACzB,YAAA,MAAMM,KAAAA,GAAkC;gBACpCC,QAAAA,EAAUH,OAAAA,EAAAA;gBACVI,UAAAA,EAAYC,SAAAA;gBACZC,eAAAA,EAAiB,CAAA;AACjBC,gBAAAA,SAAAA,EAAW,IAAIC,GAAAA,EAAAA;gBACfC,UAAAA,EAAY;AAChB,aAAA;AAEA,YAAA,IAAI,CAAC3B,QAAQ,CAAC4B,GAAG,CAACd,GAAAA,EAAKM,KAAAA,CAAAA;YACvB,OAAO;AAAEC,gBAAAA,QAAAA,EAAUD,MAAMC,QAAQ;gBAAeQ,KAAAA,EAAO;AAAK,aAAA;AAChE,QAAA;AAEA,QAAA,MAAMT,QAAQ,IAAI,CAACpB,QAAQ,CAAC8B,GAAG,CAAChB,GAAAA,CAAAA;QAChC,OAAO;AAAEO,YAAAA,QAAAA,EAAUD,MAAMC,QAAQ;YAAeQ,KAAAA,EAAO;AAAM,SAAA;AACjE,IAAA;AAEA;;;;;;QAOAE,OAAAA,CAAQjB,GAAkB,EAAQ;AAC9B,QAAA,MAAMM,QAAQ,IAAI,CAACpB,QAAQ,CAAC8B,GAAG,CAAChB,GAAAA,CAAAA;AAEhC,QAAA,IAAIM,KAAAA,EAAO;YACP,IAAIA,KAAAA,CAAMY,cAAc,KAAKT,SAAAA,EAAW;AACpCU,gBAAAA,YAAAA,CAAab,MAAMY,cAAc,CAAA;AACjCZ,gBAAAA,KAAAA,CAAMY,cAAc,GAAGT,SAAAA;AAC3B,YAAA;AAEAH,YAAAA,KAAAA,CAAMI,eAAe,EAAA;AACzB,QAAA;AACJ,IAAA;AAEA;;;;;QAMAU,aAAAA,CAAyBpB,GAAkB,EAA+C;AACtF,QAAA,OAAO,IAAI,CAACd,QAAQ,CAAC8B,GAAG,CAAChB,GAAAA,CAAAA,EAAMQ,UAAAA;AACnC,IAAA;AAEA;;;;;AAKC,QACDa,aAAAA,CAAyBrB,GAAkB,EAAEsB,MAAuC,EAAQ;AACxF,QAAA,MAAMhB,QAAQ,IAAI,CAACpB,QAAQ,CAAC8B,GAAG,CAAChB,GAAAA,CAAAA;AAEhC,QAAA,IAAIM,KAAAA,EAAO;YACP,MAAMiB,cAAAA,GAAiBjB,MAAME,UAAU;AACvCF,YAAAA,KAAAA,CAAME,UAAU,GAAGc,MAAAA;;;;AAKnB,YAAA,IACIC,mBAAmBd,SAAAA,IACnBc,cAAAA,CAAeC,SAAS,KAAKF,MAAAA,CAAOE,SAAS,IAC7CvB,IAAAA,CAAKC,SAAS,CAACqB,cAAAA,CAAeE,IAAI,CAAA,KAAMxB,IAAAA,CAAKC,SAAS,CAACoB,MAAAA,CAAOG,IAAI,CAAA,EACpE;AACE,gBAAA;AACJ,YAAA;AAEA,YAAA,KAAK,MAAMC,QAAAA,IAAYpB,KAAAA,CAAMK,SAAS,CAAE;gBACnCe,QAAAA,CAA2CJ,MAAAA,CAAAA;AAChD,YAAA;AACJ,QAAA;AACJ,IAAA;AAEA;;;;;AAKC,QACDK,WAAAA,CAAuB3B,GAAkB,EAAE0B,QAAuC,EAAQ;AACtF,QAAA,MAAMpB,QAAQ,IAAI,CAACpB,QAAQ,CAAC8B,GAAG,CAAChB,GAAAA,CAAAA;AAEhC,QAAA,IAAIM,KAAAA,EAAO;YACPA,KAAAA,CAAMK,SAAS,CAACiB,GAAG,CAACF,QAAAA,CAAAA;AACxB,QAAA;AACJ,IAAA;AAEA;;;;;AAKC,QACDG,cAAAA,CAA0B7B,GAAkB,EAAE0B,QAAuC,EAAQ;AACzF,QAAA,MAAMpB,QAAQ,IAAI,CAACpB,QAAQ,CAAC8B,GAAG,CAAChB,GAAAA,CAAAA;AAEhC,QAAA,IAAIM,KAAAA,EAAO;YACPA,KAAAA,CAAMK,SAAS,CAACmB,MAAM,CAACJ,QAAAA,CAAAA;AAC3B,QAAA;AACJ,IAAA;AAEA;;;;;AAKC,QACDK,WAAAA,CAAY/B,GAAkB,EAAEgC,QAAoB,EAAQ;AACxD,QAAA,MAAM1B,QAAQ,IAAI,CAACpB,QAAQ,CAAC8B,GAAG,CAAChB,GAAAA,CAAAA;AAEhC,QAAA,IAAIM,KAAAA,EAAO;AACPA,YAAAA,KAAAA,CAAM0B,QAAQ,GAAGA,QAAAA;AACjB1B,YAAAA,KAAAA,CAAMO,UAAU,GAAG,IAAA;AACvB,QAAA;AACJ,IAAA;AAEA;;;;QAKAoB,YAAAA,CAAajC,GAAkB,EAAW;AACtC,QAAA,OAAO,IAAI,CAACd,QAAQ,CAAC8B,GAAG,CAAChB,MAAMa,UAAAA,IAAc,KAAA;AACjD,IAAA;AAEA;;;;;;;QAQAqB,OAAAA,CAAQlC,GAAkB,EAAQ;AAC9B,QAAA,MAAMM,QAAQ,IAAI,CAACpB,QAAQ,CAAC8B,GAAG,CAAChB,GAAAA,CAAAA;AAEhC,QAAA,IAAIM,KAAAA,EAAO;AACPA,YAAAA,KAAAA,CAAMI,eAAe,EAAA;YAErB,IAAIJ,KAAAA,CAAMI,eAAe,IAAI,CAAA,EAAG;;;;gBAI5BJ,KAAAA,CAAMY,cAAc,GAAGiB,UAAAA,CAAW,IAAA;AAC9B,oBAAA,MAAMC,UAAU,IAAI,CAAClD,QAAQ,CAAC8B,GAAG,CAAChB,GAAAA,CAAAA;AAElC,oBAAA,IAAIoC,OAAAA,IAAWA,OAAAA,CAAQ1B,eAAe,IAAI,CAAA,EAAG;AACzC0B,wBAAAA,OAAAA,CAAQvB,UAAU,GAAG,KAAA;AACrBuB,wBAAAA,OAAAA,CAAQJ,QAAQ,IAAA;AAChBI,wBAAAA,OAAAA,CAAQJ,QAAQ,GAAGvB,SAAAA;AACnB2B,wBAAAA,OAAAA,CAAQlB,cAAc,GAAGT,SAAAA;AACzB,wBAAA,IAAI,CAACvB,QAAQ,CAAC4C,MAAM,CAAC9B,GAAAA,CAAAA;AACzB,oBAAA;gBACJ,CAAA,EAAG,IAAI,CAACX,YAAY,CAAA;AACxB,YAAA;AACJ,QAAA;AACJ,IAAA;AAEA;;;;QAKAgB,GAAAA,CAAIL,GAAkB,EAAW;AAC7B,QAAA,OAAO,IAAI,CAACd,QAAQ,CAACmB,GAAG,CAACL,GAAAA,CAAAA;AAC7B,IAAA;AAEA;;;;;;;;;AASC,QACDqC,wBAAAA,GAAiC;AAC7B,QAAA,KAAK,MAAM,GAAG/B,KAAAA,CAAM,IAAI,IAAI,CAACpB,QAAQ,CAAE;YACnC,IAAIoB,KAAAA,CAAMY,cAAc,KAAKT,SAAAA,EAAW;AACpCU,gBAAAA,YAAAA,CAAab,MAAMY,cAAc,CAAA;AACjCZ,gBAAAA,KAAAA,CAAMY,cAAc,GAAGT,SAAAA;AAC3B,YAAA;AAEAH,YAAAA,KAAAA,CAAMO,UAAU,GAAG,KAAA;AACnBP,YAAAA,KAAAA,CAAM0B,QAAQ,IAAA;AACd1B,YAAAA,KAAAA,CAAM0B,QAAQ,GAAGvB,SAAAA;AACrB,QAAA;AACJ,IAAA;AAEA;;;;AAIC,QACD6B,OAAAA,GAAgB;AACZ,QAAA,KAAK,MAAM,GAAGhC,KAAAA,CAAM,IAAI,IAAI,CAACpB,QAAQ,CAAE;YACnC,IAAIoB,KAAAA,CAAMY,cAAc,KAAKT,SAAAA,EAAW;AACpCU,gBAAAA,YAAAA,CAAab,MAAMY,cAAc,CAAA;AACjCZ,gBAAAA,KAAAA,CAAMY,cAAc,GAAGT,SAAAA;AAC3B,YAAA;AAEAH,YAAAA,KAAAA,CAAMO,UAAU,GAAG,KAAA;AACnBP,YAAAA,KAAAA,CAAM0B,QAAQ,IAAA;AACd1B,YAAAA,KAAAA,CAAM0B,QAAQ,GAAGvB,SAAAA;AACrB,QAAA;QAEA,IAAI,CAACvB,QAAQ,CAACqD,KAAK,EAAA;AACvB,IAAA;AAEA;;;;;;;;AAQC,QACDC,YAAAA,GAAqB;AACjB,QAAA,IAAI,IAAI,CAACpD,eAAe,KAAKqB,SAAAA,EAAW;YACpCU,YAAAA,CAAa,IAAI,CAAC/B,eAAe,CAAA;AACrC,QAAA;QAEA,IAAI,CAACA,eAAe,GAAG+C,UAAAA,CAAW,IAAA;YAC9B,IAAI,CAAC/C,eAAe,GAAGqB,SAAAA;AACvB,YAAA,IAAI,CAAC6B,OAAO,EAAA;QAChB,CAAA,EAAG,CAAA,CAAA;AACP,IAAA;AAEA;;;;;AAKC,QACDG,oBAAAA,GAA6B;AACzB,QAAA,IAAI,IAAI,CAACrD,eAAe,KAAKqB,SAAAA,EAAW;YACpCU,YAAAA,CAAa,IAAI,CAAC/B,eAAe,CAAA;YACjC,IAAI,CAACA,eAAe,GAAGqB,SAAAA;AAC3B,QAAA;AACJ,IAAA;AAEA;;;AAGC,QACDiC,sBAAAA,GAA2C;AACvC,QAAA,MAAMC,UAAmC,EAAE;AAC3C,QAAA,IAAIC,UAAAA,GAAa,CAAA;AACjB,QAAA,IAAIC,cAAAA,GAAiB,CAAA;QAErB,KAAK,MAAM,CAAC7C,GAAAA,EAAKM,KAAAA,CAAM,IAAI,IAAI,CAACpB,QAAQ,CAAE;YACtC,MAAM4D,UAAAA,GAAa9C,GAAAA,CAAI+C,OAAO,CAAC,IAAA,CAAA;AAC/B,YAAA,MAAMC,YAAYF,UAAAA,IAAc,CAAA,GAAI9C,IAAIiD,SAAS,CAAC,GAAGH,UAAAA,CAAAA,GAAc9C,GAAAA;AAEnE,YAAA,IAAIkD,cAAAA,GAAiB,CAAA;YACrB,IAAI;gBACA,IAAI5C,KAAAA,CAAME,UAAU,KAAKC,SAAAA,EAAW;AAChCyC,oBAAAA,cAAAA,GAAiBjD,KAAKC,SAAS,CAACI,KAAAA,CAAME,UAAU,EAAEb,MAAM;AAC5D,gBAAA;AACJ,YAAA,CAAA,CAAE,OAAM;;AAER,YAAA;AAEA,YAAA,IAAIW,MAAMI,eAAe,GAAG,KAAK,CAACJ,KAAAA,CAAMO,UAAU,EAAE;AAChDgC,gBAAAA,cAAAA,EAAAA;AACJ,YAAA;YAEAD,UAAAA,IAAcM,cAAAA;AACdP,YAAAA,OAAAA,CAAQQ,IAAI,CAAC;AACTnD,gBAAAA,GAAAA;AACAgD,gBAAAA,SAAAA;AACAtC,gBAAAA,eAAAA,EAAiBJ,MAAMI,eAAe;gBACtC0C,aAAAA,EAAe9C,KAAAA,CAAMK,SAAS,CAAC0C,IAAI;AACnCxC,gBAAAA,UAAAA,EAAYP,MAAMO,UAAU;gBAC5ByC,SAAAA,EAAWhD,KAAAA,CAAME,UAAU,KAAKC,SAAAA;AAChCyC,gBAAAA;AACJ,aAAA,CAAA;AACJ,QAAA;QAEA,OAAO;AACHK,YAAAA,OAAAA,EAASV,cAAAA,KAAmB,CAAA;AAC5BW,YAAAA,UAAAA,EAAY,IAAI,CAACtE,QAAQ,CAACmE,IAAI;YAC9BH,cAAAA,EAAgBN,UAAAA;AAChBD,YAAAA;AACJ,SAAA;AACJ,IAAA;AACJ;;;;"}

package/dist/cjs/queries/QueryProvider.js

@@ -1,17 +1,27 @@
 'use strict';
 
-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/cjs/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/cjs/queries/QueryResult.js

@@ -4,7 +4,12 @@ var fundamentals = require('@cratis/fundamentals');
 var ValidationResult = require('../validation/ValidationResult.js');
 var PagingInfo = require('./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,
@@ -57,12 +62,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.ValidationResult(_.severity, _.message, _.members, _.state));
+        this.validationResults = result.validationResults.map((_)=>new ValidationResult.ValidationResult(_.severity, _.message, _.members, _.state));
         this.exceptionMessages = result.exceptionMessages;
         this.exceptionStackTrace = result.exceptionStackTrace;
         this.paging = new PagingInfo.PagingInfo();
@@ -75,48 +85,44 @@ class QueryResult {
             const isPrimitive = instanceType === String || instanceType === Number || instanceType === Boolean;
             if (enumerable) {
                 if (Array.isArray(result.data)) {
-                    data = isPrimitive
-                        ? Array.from(result.data)
-                        : fundamentals.JsonSerializer.deserializeArrayFromInstance(instanceType, data);
-                }
-                else {
+                    data = isPrimitive ? Array.from(result.data) : fundamentals.JsonSerializer.deserializeArrayFromInstance(instanceType, data);
+                } else {
                     data = [];
                 }
-            }
-            else {
+            } else {
                 data = isPrimitive ? data : fundamentals.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 ?? [])
-                    : fundamentals.JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.added ?? []),
-                replaced: isPrimitive
-                    ? Array.from(result.changeSet.replaced ?? [])
-                    : fundamentals.JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.replaced ?? []),
-                removed: isPrimitive
-                    ? Array.from(result.changeSet.removed ?? [])
-                    : fundamentals.JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.removed ?? []),
+                added: isPrimitive ? Array.from(result.changeSet.added ?? []) : fundamentals.JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.added ?? []),
+                replaced: isPrimitive ? Array.from(result.changeSet.replaced ?? []) : fundamentals.JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.replaced ?? []),
+                removed: isPrimitive ? Array.from(result.changeSet.removed ?? []) : fundamentals.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;

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

@@ -1 +1 @@
-{"version":3,"file":"QueryResult.js","sources":["../../../queries/QueryResult.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, JsonSerializer } from '@cratis/fundamentals';\nimport { ValidationResult } from '../validation/ValidationResult';\nimport { IQueryResult } from './IQueryResult';\nimport { PagingInfo } from './PagingInfo';\nimport { ChangeSet } from './ChangeSet';\n\ntype ServerQueryResult = {\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    data: any;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    isSuccess: boolean;\n    isAuthorized: boolean;\n    isValid: boolean;\n    hasExceptions: boolean;\n    validationResults: ServerValidationResult[];\n    exceptionMessages: string[];\n    exceptionStackTrace: string;\n    paging: ServerPagingInfo;\n    changeSet?: ServerChangeSet;\n}\n\ntype ServerChangeSet = {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    added: any[];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    replaced: any[];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    removed: any[];\n}\n\ntype ServerValidationResult = {\n    severity: number;\n    message: string;\n    members: string[];\n    state: object;\n}\n\ntype ServerPagingInfo = {\n    page: number;\n    size: number; \n    totalItems: number;\n    totalPages: number;\n}\n\n/**\n * Represents the result from executing a {@link IQueryFor}.\n * @template TDataType The data type.\n */\nexport class QueryResult<TDataType = object> implements IQueryResult<TDataType> {\n\n    static empty<TDataType>(defaultValue: TDataType): QueryResult<TDataType> {\n        return new QueryResult({\n            data: defaultValue as object,\n            isSuccess: true,\n            isAuthorized: true,\n            isValid: true,\n            hasExceptions: false,\n            validationResults: [],\n            exceptionMessages: [],\n            exceptionStackTrace: '',\n            paging: {\n                totalItems: 0,\n                totalPages: 0,\n                page: 0,\n                size: 0\n            }\n\n        }, Object, false);\n    }\n\n    static unauthorized<TDataType>(): QueryResult<TDataType> {\n        return new QueryResult({\n            data: null as unknown as object,\n            isSuccess: false,\n            isAuthorized: false,\n            isValid: true,\n            hasExceptions: false,\n            validationResults: [],\n            exceptionMessages: [],\n            exceptionStackTrace: '',\n            paging: {\n                totalItems: 0,\n                totalPages: 0,\n                page: 0,\n                size: 0\n            }\n        }, Object, false);\n    }\n\n    static noSuccess: QueryResult = new QueryResult({\n        data: {},\n        isSuccess: false,\n        isAuthorized: true,\n        isValid: true,\n        hasExceptions: false,\n        validationResults: [],\n        exceptionMessages: [],\n        exceptionStackTrace: '',\n        paging: {\n            totalItems: 0,\n            totalPages: 0,\n            page: 0,\n            size: 0\n        }\n    }, Object, false);\n\n    /**\n     * Creates an instance of query result.\n     * @param {*} result The raw result from the backend.\n     * @param {Constructor} instanceType The type of instance to deserialize.\n     * @param {boolean} enumerable Whether or not the result is supposed be an enumerable or not.\n     */\n    constructor(result: ServerQueryResult, instanceType: Constructor, enumerable: boolean) {\n        this.isSuccess = result.isSuccess;\n        this.isAuthorized = result.isAuthorized;\n        this.isValid = result.isValid;\n        this.hasExceptions = result.hasExceptions;\n        this.validationResults = result.validationResults.map(_ => new ValidationResult(_.severity, _.message, _.members, _.state));\n        this.exceptionMessages = result.exceptionMessages;\n        this.exceptionStackTrace = result.exceptionStackTrace;\n        this.paging = new PagingInfo();\n        this.paging.page = result.paging.page;\n        this.paging.size = result.paging.size;\n        this.paging.totalItems = result.paging.totalItems;\n        this.paging.totalPages = result.paging.totalPages;\n\n        if (result.data) {\n            let data: object = result.data;\n            const isPrimitive = instanceType === String || instanceType === Number || instanceType === Boolean;\n            if (enumerable) {\n                if (Array.isArray(result.data)) {\n                    data = isPrimitive\n                        ? Array.from(result.data)\n                        : JsonSerializer.deserializeArrayFromInstance(instanceType, data);\n                } else {\n                    data = [];\n                }\n            } else {\n                data = isPrimitive ? data : JsonSerializer.deserializeFromInstance(instanceType, data);\n            }\n\n            this.data = data as TDataType;\n        } else {\n            this.data = (enumerable ? [] : null) as TDataType;\n        }\n\n        if (enumerable && result.changeSet) {\n            const isPrimitive = instanceType === String || instanceType === Number || instanceType === Boolean;\n            this.changeSet = {\n                added: isPrimitive\n                    ? Array.from(result.changeSet.added ?? [])\n                    : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.added ?? []),\n                replaced: isPrimitive\n                    ? Array.from(result.changeSet.replaced ?? [])\n                    : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.replaced ?? []),\n                removed: isPrimitive\n                    ? Array.from(result.changeSet.removed ?? [])\n                    : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.removed ?? []),\n            } as ChangeSet<unknown>;\n        }\n    }\n\n    /** @inheritdoc */\n    readonly data: TDataType;\n\n    /** @inheritdoc */\n    readonly paging: PagingInfo;\n\n    /** @inheritdoc */\n    readonly isSuccess: boolean;\n\n    /** @inheritdoc */\n    readonly isAuthorized: boolean;\n\n    /** @inheritdoc */\n    readonly isValid: boolean;\n\n    /** @inheritdoc */\n    readonly hasExceptions: boolean;\n\n    /** @inheritdoc */\n    readonly validationResults: ValidationResult[];\n\n    /** @inheritdoc */\n    readonly exceptionMessages: string[];\n\n    /** @inheritdoc */\n    readonly exceptionStackTrace: string;\n\n    /**\n     * Gets the optional change set describing what changed since the previous update.\n     * Set by the server when the delta transfer mode is active.\n     * When present, clients can apply the delta to their local state rather than replacing\n     * the full dataset.\n     */\n    readonly changeSet?: ChangeSet<unknown>;\n\n    /**\n     * Gets whether or not the query has data.\n     */\n    get hasData(): boolean {\n        if (this.data) {\n            if (Array.isArray(this.data)) {\n                return this.data.length > 0;\n            }\n            return true;\n        }\n        return false;\n    }\n}\n"],"names":["ValidationResult","PagingInfo","JsonSerializer"],"mappings":"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"}
+{"version":3,"file":"QueryResult.js","sources":["../../../queries/QueryResult.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, JsonSerializer } from '@cratis/fundamentals';\nimport { ValidationResult } from '../validation/ValidationResult';\nimport { IQueryResult } from './IQueryResult';\nimport { PagingInfo } from './PagingInfo';\nimport { ChangeSet } from './ChangeSet';\n\ntype ServerQueryResult = {\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    data: any;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    isSuccess: boolean;\n    isAuthorized: boolean;\n    isValid: boolean;\n    hasExceptions: boolean;\n    validationResults: ServerValidationResult[];\n    exceptionMessages: string[];\n    exceptionStackTrace: string;\n    paging: ServerPagingInfo;\n    changeSet?: ServerChangeSet;\n}\n\ntype ServerChangeSet = {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    added: any[];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    replaced: any[];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    removed: any[];\n}\n\ntype ServerValidationResult = {\n    severity: number;\n    message: string;\n    members: string[];\n    state: object;\n}\n\ntype ServerPagingInfo = {\n    page: number;\n    size: number; \n    totalItems: number;\n    totalPages: number;\n}\n\n/**\n * Represents the result from executing a {@link IQueryFor}.\n * @template TDataType The data type.\n */\nexport class QueryResult<TDataType = object> implements IQueryResult<TDataType> {\n\n    static empty<TDataType>(defaultValue: TDataType): QueryResult<TDataType> {\n        return new QueryResult({\n            data: defaultValue as object,\n            isSuccess: true,\n            isAuthorized: true,\n            isValid: true,\n            hasExceptions: false,\n            validationResults: [],\n            exceptionMessages: [],\n            exceptionStackTrace: '',\n            paging: {\n                totalItems: 0,\n                totalPages: 0,\n                page: 0,\n                size: 0\n            }\n\n        }, Object, false);\n    }\n\n    static unauthorized<TDataType>(): QueryResult<TDataType> {\n        return new QueryResult({\n            data: null as unknown as object,\n            isSuccess: false,\n            isAuthorized: false,\n            isValid: true,\n            hasExceptions: false,\n            validationResults: [],\n            exceptionMessages: [],\n            exceptionStackTrace: '',\n            paging: {\n                totalItems: 0,\n                totalPages: 0,\n                page: 0,\n                size: 0\n            }\n        }, Object, false);\n    }\n\n    static noSuccess: QueryResult = new QueryResult({\n        data: {},\n        isSuccess: false,\n        isAuthorized: true,\n        isValid: true,\n        hasExceptions: false,\n        validationResults: [],\n        exceptionMessages: [],\n        exceptionStackTrace: '',\n        paging: {\n            totalItems: 0,\n            totalPages: 0,\n            page: 0,\n            size: 0\n        }\n    }, Object, false);\n\n    /**\n     * Creates an instance of query result.\n     * @param {*} result The raw result from the backend.\n     * @param {Constructor} instanceType The type of instance to deserialize.\n     * @param {boolean} enumerable Whether or not the result is supposed be an enumerable or not.\n     */\n    constructor(result: ServerQueryResult, instanceType: Constructor, enumerable: boolean) {\n        this.isSuccess = result.isSuccess;\n        this.isAuthorized = result.isAuthorized;\n        this.isValid = result.isValid;\n        this.hasExceptions = result.hasExceptions;\n        this.validationResults = result.validationResults.map(_ => new ValidationResult(_.severity, _.message, _.members, _.state));\n        this.exceptionMessages = result.exceptionMessages;\n        this.exceptionStackTrace = result.exceptionStackTrace;\n        this.paging = new PagingInfo();\n        this.paging.page = result.paging.page;\n        this.paging.size = result.paging.size;\n        this.paging.totalItems = result.paging.totalItems;\n        this.paging.totalPages = result.paging.totalPages;\n\n        if (result.data) {\n            let data: object = result.data;\n            const isPrimitive = instanceType === String || instanceType === Number || instanceType === Boolean;\n            if (enumerable) {\n                if (Array.isArray(result.data)) {\n                    data = isPrimitive\n                        ? Array.from(result.data)\n                        : JsonSerializer.deserializeArrayFromInstance(instanceType, data);\n                } else {\n                    data = [];\n                }\n            } else {\n                data = isPrimitive ? data : JsonSerializer.deserializeFromInstance(instanceType, data);\n            }\n\n            this.data = data as TDataType;\n        } else {\n            this.data = (enumerable ? [] : null) as TDataType;\n        }\n\n        if (enumerable && result.changeSet) {\n            const isPrimitive = instanceType === String || instanceType === Number || instanceType === Boolean;\n            this.changeSet = {\n                added: isPrimitive\n                    ? Array.from(result.changeSet.added ?? [])\n                    : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.added ?? []),\n                replaced: isPrimitive\n                    ? Array.from(result.changeSet.replaced ?? [])\n                    : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.replaced ?? []),\n                removed: isPrimitive\n                    ? Array.from(result.changeSet.removed ?? [])\n                    : JsonSerializer.deserializeArrayFromInstance(instanceType, result.changeSet.removed ?? []),\n            } as ChangeSet<unknown>;\n        }\n    }\n\n    /** @inheritdoc */\n    readonly data: TDataType;\n\n    /** @inheritdoc */\n    readonly paging: PagingInfo;\n\n    /** @inheritdoc */\n    readonly isSuccess: boolean;\n\n    /** @inheritdoc */\n    readonly isAuthorized: boolean;\n\n    /** @inheritdoc */\n    readonly isValid: boolean;\n\n    /** @inheritdoc */\n    readonly hasExceptions: boolean;\n\n    /** @inheritdoc */\n    readonly validationResults: ValidationResult[];\n\n    /** @inheritdoc */\n    readonly exceptionMessages: string[];\n\n    /** @inheritdoc */\n    readonly exceptionStackTrace: string;\n\n    /**\n     * Gets the optional change set describing what changed since the previous update.\n     * Set by the server when the delta transfer mode is active.\n     * When present, clients can apply the delta to their local state rather than replacing\n     * the full dataset.\n     */\n    readonly changeSet?: ChangeSet<unknown>;\n\n    /**\n     * Gets whether or not the query has data.\n     */\n    get hasData(): boolean {\n        if (this.data) {\n            if (Array.isArray(this.data)) {\n                return this.data.length > 0;\n            }\n            return true;\n        }\n        return false;\n    }\n}\n"],"names":["QueryResult","empty","defaultValue","data","isSuccess","isAuthorized","isValid","hasExceptions","validationResults","exceptionMessages","exceptionStackTrace","paging","totalItems","totalPages","page","size","Object","unauthorized","noSuccess","result","instanceType","enumerable","map","_","ValidationResult","severity","message","members","state","PagingInfo","isPrimitive","String","Number","Boolean","Array","isArray","from","JsonSerializer","deserializeArrayFromInstance","deserializeFromInstance","changeSet","added","replaced","removed","hasData","length"],"mappings":"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"}

package/dist/cjs/queries/QueryResultWithState.js

@@ -2,7 +2,11 @@
 
 var PagingInfo = require('./PagingInfo.js');
 
-class QueryResultWithState {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents a specialized {@link QueryResult<TDataType>} that holds state for its execution
+ */ class QueryResultWithState {
     data;
     paging;
     isSuccess;
@@ -20,7 +24,20 @@ class QueryResultWithState {
     static initial(defaultValue) {
         return new QueryResultWithState(defaultValue, PagingInfo.PagingInfo.noPaging, true, true, true, [], false, [], '', true);
     }
-    constructor(data, paging, isSuccess, isAuthorized, isValid, validationResults, hasExceptions, exceptionMessages, exceptionStackTrace, isPerforming, changeSet) {
+    /**
+     * Initializes an instance of {@link QueryResultWithState<TDataType>}.
+     * @param {TDataType} data The items returned, if any - can be empty.
+     * @param {PagingInfo} paging The paging info.
+     * @param {boolean} isSuccess Whether or not the query was successful.
+     * @param {boolean} isAuthorized Whether or not the query was authorized.
+     * @param {boolean} isValid Whether or not it is valid.
+     * @param {ValidationResult[]} validationResults Any validation errors.
+     * @param {boolean} hasExceptions Whether or not it has exceptions.
+     * @param {string[]} exceptionMessages Any exception messages.
+     * @param {string} exceptionStackTrace Exception stack trace, if any.
+     * @param {boolean} isPerforming Whether or not the query is being performed. True if its performing, false if it is done.
+     * @param {ChangeSet<unknown> | undefined} changeSet Optional change set from the server describing the delta since the last update.
+     */ constructor(data, paging, isSuccess, isAuthorized, isValid, validationResults, hasExceptions, exceptionMessages, exceptionStackTrace, isPerforming, changeSet){
         this.data = data;
         this.paging = paging;
         this.isSuccess = isSuccess;
@@ -33,13 +50,18 @@ class QueryResultWithState {
         this.isPerforming = isPerforming;
         this.changeSet = changeSet;
     }
-    get hasData() {
+    /** @inheritdoc */ get hasData() {
         if (Array.isArray(this.data)) {
             return this.data.length > 0;
         }
         return !!this.data;
     }
-    static fromQueryResult(queryResult, isPerforming) {
+    /**
+     * Create a new {@link QueryResultWithState<TDataType>} from {@link QueryResult<TDataType>}.
+     * @param queryResult The original query result.
+     * @param isPerforming Whether or not the query is performing.
+     * @returns A new {@link QueryResultWithState<TDataType>}
+     */ static fromQueryResult(queryResult, isPerforming) {
         return new QueryResultWithState(queryResult.data, queryResult.paging, queryResult.isSuccess, queryResult.isAuthorized, queryResult.isValid, queryResult.validationResults, queryResult.hasExceptions, queryResult.exceptionMessages, queryResult.exceptionStackTrace, isPerforming, queryResult.changeSet);
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"QueryResultWithState.js","sources":["../../../queries/QueryResultWithState.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 { ValidationResult } from '../validation/ValidationResult';\nimport { IQueryResult } from './IQueryResult';\nimport { PagingInfo } from './PagingInfo';\nimport { QueryResult } from './QueryResult';\nimport { ChangeSet } from './ChangeSet';\n\n/**\n * Represents a specialized {@link QueryResult<TDataType>} that holds state for its execution\n */\nexport class QueryResultWithState<TDataType> implements IQueryResult<TDataType> {\n\n    static empty<TDataType>(defaultValue: TDataType): QueryResultWithState<TDataType> {\n        return new QueryResultWithState(\n            defaultValue,\n            PagingInfo.noPaging,\n            true,\n            true,\n            true,\n            [],\n            false,\n            [],\n            '',\n            false);\n    }\n\n    static initial<TDataType>(defaultValue: TDataType): QueryResultWithState<TDataType> {\n        return new QueryResultWithState(\n            defaultValue,\n            PagingInfo.noPaging,\n            true,\n            true,\n            true,\n            [],\n            false,\n            [],\n            '',\n            true);\n    }\n\n    /**\n     * Initializes an instance of {@link QueryResultWithState<TDataType>}.\n     * @param {TDataType} data The items returned, if any - can be empty.\n     * @param {PagingInfo} paging The paging info.\n     * @param {boolean} isSuccess Whether or not the query was successful.\n     * @param {boolean} isAuthorized Whether or not the query was authorized.\n     * @param {boolean} isValid Whether or not it is valid.\n     * @param {ValidationResult[]} validationResults Any validation errors.\n     * @param {boolean} hasExceptions Whether or not it has exceptions.\n     * @param {string[]} exceptionMessages Any exception messages.\n     * @param {string} exceptionStackTrace Exception stack trace, if any.\n     * @param {boolean} isPerforming Whether or not the query is being performed. True if its performing, false if it is done.\n     * @param {ChangeSet<unknown> | undefined} changeSet Optional change set from the server describing the delta since the last update.\n     */\n    constructor(\n        readonly data: TDataType,\n        readonly paging: PagingInfo,\n        readonly isSuccess: boolean,\n        readonly isAuthorized: boolean,\n        readonly isValid: boolean,\n        readonly validationResults: ValidationResult[],\n        readonly hasExceptions: boolean,\n        readonly exceptionMessages: string[],\n        readonly exceptionStackTrace: string,\n        readonly isPerforming: boolean,\n        readonly changeSet?: ChangeSet<unknown>) {\n    }\n\n    /** @inheritdoc */\n    get hasData(): boolean {\n        if (Array.isArray(this.data)) {\n            return this.data.length > 0;\n        }\n        return !!this.data;\n    }\n\n    /**\n     * Create a new {@link QueryResultWithState<TDataType>} from {@link QueryResult<TDataType>}.\n     * @param queryResult The original query result.\n     * @param isPerforming Whether or not the query is performing.\n     * @returns A new {@link QueryResultWithState<TDataType>}\n     */\n    static fromQueryResult<TDataType>(queryResult: QueryResult<TDataType>, isPerforming: boolean) {\n        return new QueryResultWithState<TDataType>(\n            queryResult.data,\n            queryResult.paging,\n            queryResult.isSuccess,\n            queryResult.isAuthorized,\n            queryResult.isValid,\n            queryResult.validationResults,\n            queryResult.hasExceptions,\n            queryResult.exceptionMessages,\n            queryResult.exceptionStackTrace,\n            isPerforming,\n            queryResult.changeSet);\n    }\n}\n"],"names":["PagingInfo"],"mappings":";;;;MAYa,oBAAoB,CAAA;AA6ChB,IAAA,IAAA;AACA,IAAA,MAAA;AACA,IAAA,SAAA;AACA,IAAA,YAAA;AACA,IAAA,OAAA;AACA,IAAA,iBAAA;AACA,IAAA,aAAA;AACA,IAAA,iBAAA;AACA,IAAA,mBAAA;AACA,IAAA,YAAA;AACA,IAAA,SAAA;IArDb,OAAO,KAAK,CAAY,YAAuB,EAAA;QAC3C,OAAO,IAAI,oBAAoB,CAC3B,YAAY,EACZA,qBAAU,CAAC,QAAQ,EACnB,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,EAAE,EACF,KAAK,EACL,EAAE,EACF,EAAE,EACF,KAAK,CAAC;IACd;IAEA,OAAO,OAAO,CAAY,YAAuB,EAAA;QAC7C,OAAO,IAAI,oBAAoB,CAC3B,YAAY,EACZA,qBAAU,CAAC,QAAQ,EACnB,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,EAAE,EACF,KAAK,EACL,EAAE,EACF,EAAE,EACF,IAAI,CAAC;IACb;IAgBA,WAAA,CACa,IAAe,EACf,MAAkB,EAClB,SAAkB,EAClB,YAAqB,EACrB,OAAgB,EAChB,iBAAqC,EACrC,aAAsB,EACtB,iBAA2B,EAC3B,mBAA2B,EAC3B,YAAqB,EACrB,SAA8B,EAAA;QAV9B,IAAA,CAAA,IAAI,GAAJ,IAAI;QACJ,IAAA,CAAA,MAAM,GAAN,MAAM;QACN,IAAA,CAAA,SAAS,GAAT,SAAS;QACT,IAAA,CAAA,YAAY,GAAZ,YAAY;QACZ,IAAA,CAAA,OAAO,GAAP,OAAO;QACP,IAAA,CAAA,iBAAiB,GAAjB,iBAAiB;QACjB,IAAA,CAAA,aAAa,GAAb,aAAa;QACb,IAAA,CAAA,iBAAiB,GAAjB,iBAAiB;QACjB,IAAA,CAAA,mBAAmB,GAAnB,mBAAmB;QACnB,IAAA,CAAA,YAAY,GAAZ,YAAY;QACZ,IAAA,CAAA,SAAS,GAAT,SAAS;IACtB;AAGA,IAAA,IAAI,OAAO,GAAA;QACP,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;AAC1B,YAAA,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAC/B;AACA,QAAA,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI;IACtB;AAQA,IAAA,OAAO,eAAe,CAAY,WAAmC,EAAE,YAAqB,EAAA;QACxF,OAAO,IAAI,oBAAoB,CAC3B,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,MAAM,EAClB,WAAW,CAAC,SAAS,EACrB,WAAW,CAAC,YAAY,EACxB,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,iBAAiB,EAC7B,WAAW,CAAC,aAAa,EACzB,WAAW,CAAC,iBAAiB,EAC7B,WAAW,CAAC,mBAAmB,EAC/B,YAAY,EACZ,WAAW,CAAC,SAAS,CAAC;IAC9B;AACH;;;;"}
+{"version":3,"file":"QueryResultWithState.js","sources":["../../../queries/QueryResultWithState.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 { ValidationResult } from '../validation/ValidationResult';\nimport { IQueryResult } from './IQueryResult';\nimport { PagingInfo } from './PagingInfo';\nimport { QueryResult } from './QueryResult';\nimport { ChangeSet } from './ChangeSet';\n\n/**\n * Represents a specialized {@link QueryResult<TDataType>} that holds state for its execution\n */\nexport class QueryResultWithState<TDataType> implements IQueryResult<TDataType> {\n\n    static empty<TDataType>(defaultValue: TDataType): QueryResultWithState<TDataType> {\n        return new QueryResultWithState(\n            defaultValue,\n            PagingInfo.noPaging,\n            true,\n            true,\n            true,\n            [],\n            false,\n            [],\n            '',\n            false);\n    }\n\n    static initial<TDataType>(defaultValue: TDataType): QueryResultWithState<TDataType> {\n        return new QueryResultWithState(\n            defaultValue,\n            PagingInfo.noPaging,\n            true,\n            true,\n            true,\n            [],\n            false,\n            [],\n            '',\n            true);\n    }\n\n    /**\n     * Initializes an instance of {@link QueryResultWithState<TDataType>}.\n     * @param {TDataType} data The items returned, if any - can be empty.\n     * @param {PagingInfo} paging The paging info.\n     * @param {boolean} isSuccess Whether or not the query was successful.\n     * @param {boolean} isAuthorized Whether or not the query was authorized.\n     * @param {boolean} isValid Whether or not it is valid.\n     * @param {ValidationResult[]} validationResults Any validation errors.\n     * @param {boolean} hasExceptions Whether or not it has exceptions.\n     * @param {string[]} exceptionMessages Any exception messages.\n     * @param {string} exceptionStackTrace Exception stack trace, if any.\n     * @param {boolean} isPerforming Whether or not the query is being performed. True if its performing, false if it is done.\n     * @param {ChangeSet<unknown> | undefined} changeSet Optional change set from the server describing the delta since the last update.\n     */\n    constructor(\n        readonly data: TDataType,\n        readonly paging: PagingInfo,\n        readonly isSuccess: boolean,\n        readonly isAuthorized: boolean,\n        readonly isValid: boolean,\n        readonly validationResults: ValidationResult[],\n        readonly hasExceptions: boolean,\n        readonly exceptionMessages: string[],\n        readonly exceptionStackTrace: string,\n        readonly isPerforming: boolean,\n        readonly changeSet?: ChangeSet<unknown>) {\n    }\n\n    /** @inheritdoc */\n    get hasData(): boolean {\n        if (Array.isArray(this.data)) {\n            return this.data.length > 0;\n        }\n        return !!this.data;\n    }\n\n    /**\n     * Create a new {@link QueryResultWithState<TDataType>} from {@link QueryResult<TDataType>}.\n     * @param queryResult The original query result.\n     * @param isPerforming Whether or not the query is performing.\n     * @returns A new {@link QueryResultWithState<TDataType>}\n     */\n    static fromQueryResult<TDataType>(queryResult: QueryResult<TDataType>, isPerforming: boolean) {\n        return new QueryResultWithState<TDataType>(\n            queryResult.data,\n            queryResult.paging,\n            queryResult.isSuccess,\n            queryResult.isAuthorized,\n            queryResult.isValid,\n            queryResult.validationResults,\n            queryResult.hasExceptions,\n            queryResult.exceptionMessages,\n            queryResult.exceptionStackTrace,\n            isPerforming,\n            queryResult.changeSet);\n    }\n}\n"],"names":["QueryResultWithState","empty","defaultValue","PagingInfo","noPaging","initial","data","isAuthorized","hasExceptions","changeSet","paging","isSuccess","isValid","validationResults","exceptionMessages","exceptionStackTrace","isPerforming","hasData","Array","isArray","length","fromQueryResult","queryResult"],"mappings":";;;;AAAA;AACA;AAQA;;AAEC,IACM,MAAMA,oBAAAA,CAAAA;;;;;;;;;;;;IAET,OAAOC,KAAAA,CAAiBC,YAAuB,EAAmC;AAC9E,QAAA,OAAO,IAAIF,oBAAAA,CACPE,YAAAA,EACAC,qBAAAA,CAAWC,QAAQ,EACnB,IAAA,EACA,IAAA,EACA,IAAA,EACA,EAAE,EACF,KAAA,EACA,EAAE,EACF,EAAA,EACA,KAAA,CAAA;AACR,IAAA;IAEA,OAAOC,OAAAA,CAAmBH,YAAuB,EAAmC;AAChF,QAAA,OAAO,IAAIF,oBAAAA,CACPE,YAAAA,EACAC,qBAAAA,CAAWC,QAAQ,EACnB,IAAA,EACA,IAAA,EACA,IAAA,EACA,EAAE,EACF,KAAA,EACA,EAAE,EACF,EAAA,EACA,IAAA,CAAA;AACR,IAAA;AAEA;;;;;;;;;;;;;AAaC,QACD,WAAA,CACaE,IAAe,EACxB,MAA2B,EAC3B,SAA2B,EAClBC,YAAqB,EAC9B,OAAyB,EACzB,iBAA8C,EACrCC,aAAsB,EAC/B,iBAAoC,EACpC,mBAAoC,EACpC,YAA8B,EACrBC,SAA8B,CAAE;aAVhCH,IAAAA,GAAAA,IAAAA;aACAI,MAAAA,GAAAA,MAAAA;aACAC,SAAAA,GAAAA,SAAAA;aACAJ,YAAAA,GAAAA,YAAAA;aACAK,OAAAA,GAAAA,OAAAA;aACAC,iBAAAA,GAAAA,iBAAAA;aACAL,aAAAA,GAAAA,aAAAA;aACAM,iBAAAA,GAAAA,iBAAAA;aACAC,mBAAAA,GAAAA,mBAAAA;aACAC,YAAAA,GAAAA,YAAAA;aACAP,SAAAA,GAAAA,SAAAA;AACb,IAAA;uBAGA,IAAIQ,OAAAA,GAAmB;AACnB,QAAA,IAAIC,MAAMC,OAAO,CAAC,IAAI,CAACb,IAAI,CAAA,EAAG;AAC1B,YAAA,OAAO,IAAI,CAACA,IAAI,CAACc,MAAM,GAAG,CAAA;AAC9B,QAAA;AACA,QAAA,OAAO,CAAC,CAAC,IAAI,CAACd,IAAI;AACtB,IAAA;AAEA;;;;;AAKC,QACD,OAAOe,eAAAA,CAA2BC,WAAmC,EAAEN,YAAqB,EAAE;AAC1F,QAAA,OAAO,IAAIhB,oBAAAA,CACPsB,WAAAA,CAAYhB,IAAI,EAChBgB,WAAAA,CAAYZ,MAAM,EAClBY,WAAAA,CAAYX,SAAS,EACrBW,WAAAA,CAAYf,YAAY,EACxBe,WAAAA,CAAYV,OAAO,EACnBU,WAAAA,CAAYT,iBAAiB,EAC7BS,WAAAA,CAAYd,aAAa,EACzBc,WAAAA,CAAYR,iBAAiB,EAC7BQ,WAAAA,CAAYP,mBAAmB,EAC/BC,YAAAA,EACAM,YAAYb,SAAS,CAAA;AAC7B,IAAA;AACJ;;;;"}

package/dist/cjs/queries/QueryTransportMethod.js

@@ -1,8 +1,18 @@
 'use strict';
 
-exports.QueryTransportMethod = void 0;
-(function (QueryTransportMethod) {
-    QueryTransportMethod["WebSocket"] = "webSocket";
-    QueryTransportMethod["ServerSentEvents"] = "serverSentEvents";
-})(exports.QueryTransportMethod || (exports.QueryTransportMethod = {}));
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Defines the transport method used for observable query connections.
+ */ var QueryTransportMethod = /*#__PURE__*/ function(QueryTransportMethod) {
+    /**
+     * Use WebSocket for real-time data streaming.
+     */ QueryTransportMethod["WebSocket"] = "webSocket";
+    /**
+     * Use Server-Sent Events (SSE) for real-time data streaming.
+     */ QueryTransportMethod["ServerSentEvents"] = "serverSentEvents";
+    return QueryTransportMethod;
+}({});
+
+exports.QueryTransportMethod = QueryTransportMethod;
 //# sourceMappingURL=QueryTransportMethod.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"QueryTransportMethod.js","sources":["../../../queries/QueryTransportMethod.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\n/**\n * Defines the transport method used for observable query connections.\n */\nexport enum QueryTransportMethod {\n    /**\n     * Use WebSocket for real-time data streaming.\n     */\n    WebSocket = 'webSocket',\n\n    /**\n     * Use Server-Sent Events (SSE) for real-time data streaming.\n     */\n    ServerSentEvents = 'serverSentEvents',\n}\n"],"names":["QueryTransportMethod"],"mappings":";;AAMYA;AAAZ,CAAA,UAAY,oBAAoB,EAAA;AAI5B,IAAA,oBAAA,CAAA,WAAA,CAAA,GAAA,WAAuB;AAKvB,IAAA,oBAAA,CAAA,kBAAA,CAAA,GAAA,kBAAqC;AACzC,CAAC,EAVWA,4BAAoB,KAApBA,4BAAoB,GAAA,EAAA,CAAA,CAAA;;"}
+{"version":3,"file":"QueryTransportMethod.js","sources":["../../../queries/QueryTransportMethod.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\n/**\n * Defines the transport method used for observable query connections.\n */\nexport enum QueryTransportMethod {\n    /**\n     * Use WebSocket for real-time data streaming.\n     */\n    WebSocket = 'webSocket',\n\n    /**\n     * Use Server-Sent Events (SSE) for real-time data streaming.\n     */\n    ServerSentEvents = 'serverSentEvents',\n}\n"],"names":["QueryTransportMethod"],"mappings":";;AAAA;AACA;AAEA;;IAGO,IAAKA,oBAAAA,iBAAAA,SAAAA,oBAAAA,EAAAA;AACR;;AAEC,QAAA,oBAAA,CAAA,WAAA,CAAA,GAAA,WAAA;AAGD;;AAEC,QAAA,oBAAA,CAAA,kBAAA,CAAA,GAAA,kBAAA;AAROA,IAAAA,OAAAA,oBAAAA;AAUX,CAAA,CAAA,EAAA;;;;"}

package/dist/cjs/queries/QueryValidator.js

@@ -2,8 +2,16 @@
 
 var Validator = require('../validation/Validator.js');
 
-class QueryValidator extends Validator.Validator {
-    validate(query) {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents the query validator
+ */ class QueryValidator extends Validator.Validator {
+    /**
+     * Validate the query parameters.
+     * @param query The query to validate.
+     * @returns An array of validation results, empty if valid.
+     */ validate(query) {
         return super.validate(query);
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"QueryValidator.js","sources":["../../../queries/QueryValidator.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 { Validator } from '../validation/Validator';\nimport { ValidationResult } from '../validation/ValidationResult';\n\n/**\n * Represents the query validator\n */\nexport abstract class QueryValidator<T = object> extends Validator<T> {\n    /**\n     * Validate the query parameters.\n     * @param query The query to validate.\n     * @returns An array of validation results, empty if valid.\n     */\n    validate(query: T): ValidationResult[] {\n        return super.validate(query);\n    }\n}\n"],"names":["Validator"],"mappings":";;;;AASM,MAAgB,cAA2B,SAAQA,mBAAY,CAAA;AAMjE,IAAA,QAAQ,CAAC,KAAQ,EAAA;AACb,QAAA,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;IAChC;AACH;;;;"}
+{"version":3,"file":"QueryValidator.js","sources":["../../../queries/QueryValidator.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 { Validator } from '../validation/Validator';\nimport { ValidationResult } from '../validation/ValidationResult';\n\n/**\n * Represents the query validator\n */\nexport abstract class QueryValidator<T = object> extends Validator<T> {\n    /**\n     * Validate the query parameters.\n     * @param query The query to validate.\n     * @returns An array of validation results, empty if valid.\n     */\n    validate(query: T): ValidationResult[] {\n        return super.validate(query);\n    }\n}\n"],"names":["QueryValidator","Validator","validate","query"],"mappings":";;;;AAAA;AACA;AAKA;;IAGO,MAAeA,cAAAA,SAAmCC,mBAAAA,CAAAA;AACrD;;;;QAKAC,QAAAA,CAASC,KAAQ,EAAsB;QACnC,OAAO,KAAK,CAACD,QAAAA,CAASC,KAAAA,CAAAA;AAC1B,IAAA;AACJ;;;;"}

package/dist/cjs/queries/ReconnectPolicy.js

@@ -1,26 +1,47 @@
 'use strict';
 
-class ReconnectPolicy {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Default exponential back-off reconnect policy shared by all observable query connections.
+ *
+ * Delay formula: `Math.min(initialDelayMs + delayStepMs * attempt, maxDelayMs)`
+ *
+ * With the default parameters:
+ * - Attempt 1 → 1 000 ms
+ * - Attempt 2 → 1 500 ms
+ * - …
+ * - Attempt 19+ → 10 000 ms (capped)
+ * - After 100 attempts → abandoned (returns `false`)
+ */ class ReconnectPolicy {
     _maxAttempts;
     _initialDelayMs;
     _delayStepMs;
     _maxDelayMs;
     _attempt = 0;
     _timer;
-    constructor(_maxAttempts = 100, _initialDelayMs = 500, _delayStepMs = 500, _maxDelayMs = 10_000) {
+    /**
+     * Initializes a new instance of {@link ReconnectPolicy}.
+     * @param {number} maxAttempts Maximum number of reconnect attempts before giving up (default: 100).
+     * @param {number} initialDelayMs Base delay in milliseconds added to every attempt (default: 500).
+     * @param {number} delayStepMs Additional delay per attempt in milliseconds (default: 500).
+     * @param {number} maxDelayMs Upper bound on the computed delay in milliseconds (default: 10 000).
+     */ constructor(_maxAttempts = 100, _initialDelayMs = 500, _delayStepMs = 500, _maxDelayMs = 10_000){
         this._maxAttempts = _maxAttempts;
         this._initialDelayMs = _initialDelayMs;
         this._delayStepMs = _delayStepMs;
         this._maxDelayMs = _maxDelayMs;
     }
-    get attempt() {
+    /** @inheritdoc */ get attempt() {
         return this._attempt;
     }
-    schedule(onReconnect, label) {
+    /** @inheritdoc */ schedule(onReconnect, label) {
         if (this._attempt >= this._maxAttempts) {
             console.log(`Reconnect: abandoned after ${this._maxAttempts} attempts for '${label}'`);
             return false;
         }
+        // Cancel any pending reconnect timer so we don't fire multiple
+        // concurrent reconnect attempts when schedule() is called rapidly.
         this.cancel();
         this._attempt++;
         const delay = Math.min(this._initialDelayMs + this._delayStepMs * this._attempt, this._maxDelayMs);
@@ -28,11 +49,11 @@ class ReconnectPolicy {
         this._timer = setTimeout(onReconnect, delay);
         return true;
     }
-    reset() {
+    /** @inheritdoc */ reset() {
         this._attempt = 0;
         this.cancel();
     }
-    cancel() {
+    /** @inheritdoc */ cancel() {
         if (this._timer) {
             clearTimeout(this._timer);
             this._timer = undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"ReconnectPolicy.js","sources":["../../../queries/ReconnectPolicy.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 { IReconnectPolicy, ReconnectCallback } from './IReconnectPolicy';\n\n/**\n * Default exponential back-off reconnect policy shared by all observable query connections.\n *\n * Delay formula: `Math.min(initialDelayMs + delayStepMs * attempt, maxDelayMs)`\n *\n * With the default parameters:\n * - Attempt 1 → 1 000 ms\n * - Attempt 2 → 1 500 ms\n * - …\n * - Attempt 19+ → 10 000 ms (capped)\n * - After 100 attempts → abandoned (returns `false`)\n */\nexport class ReconnectPolicy implements IReconnectPolicy {\n    private _attempt = 0;\n    private _timer?: ReturnType<typeof setTimeout>;\n\n    /**\n     * Initializes a new instance of {@link ReconnectPolicy}.\n     * @param {number} maxAttempts Maximum number of reconnect attempts before giving up (default: 100).\n     * @param {number} initialDelayMs Base delay in milliseconds added to every attempt (default: 500).\n     * @param {number} delayStepMs Additional delay per attempt in milliseconds (default: 500).\n     * @param {number} maxDelayMs Upper bound on the computed delay in milliseconds (default: 10 000).\n     */\n    constructor(\n        private readonly _maxAttempts: number = 100,\n        private readonly _initialDelayMs: number = 500,\n        private readonly _delayStepMs: number = 500,\n        private readonly _maxDelayMs: number = 10_000,\n    ) {}\n\n    /** @inheritdoc */\n    get attempt(): number {\n        return this._attempt;\n    }\n\n    /** @inheritdoc */\n    schedule(onReconnect: ReconnectCallback, label: string): boolean {\n        if (this._attempt >= this._maxAttempts) {\n            console.log(`Reconnect: abandoned after ${this._maxAttempts} attempts for '${label}'`);\n            return false;\n        }\n\n        // Cancel any pending reconnect timer so we don't fire multiple\n        // concurrent reconnect attempts when schedule() is called rapidly.\n        this.cancel();\n\n        this._attempt++;\n        const delay = Math.min(this._initialDelayMs + this._delayStepMs * this._attempt, this._maxDelayMs);\n        console.log(`Reconnect: attempt ${this._attempt} in ${delay}ms for '${label}'`);\n        this._timer = setTimeout(onReconnect, delay);\n        return true;\n    }\n\n    /** @inheritdoc */\n    reset(): void {\n        this._attempt = 0;\n        this.cancel();\n    }\n\n    /** @inheritdoc */\n    cancel(): void {\n        if (this._timer) {\n            clearTimeout(this._timer);\n            this._timer = undefined;\n        }\n    }\n}\n"],"names":[],"mappings":";;MAiBa,eAAe,CAAA;AAYH,IAAA,YAAA;AACA,IAAA,eAAA;AACA,IAAA,YAAA;AACA,IAAA,WAAA;IAdb,QAAQ,GAAG,CAAC;AACZ,IAAA,MAAM;IASd,WAAA,CACqB,YAAA,GAAuB,GAAG,EAC1B,eAAA,GAA0B,GAAG,EAC7B,YAAA,GAAuB,GAAG,EAC1B,WAAA,GAAsB,MAAM,EAAA;QAH5B,IAAA,CAAA,YAAY,GAAZ,YAAY;QACZ,IAAA,CAAA,eAAe,GAAf,eAAe;QACf,IAAA,CAAA,YAAY,GAAZ,YAAY;QACZ,IAAA,CAAA,WAAW,GAAX,WAAW;IAC7B;AAGH,IAAA,IAAI,OAAO,GAAA;QACP,OAAO,IAAI,CAAC,QAAQ;IACxB;IAGA,QAAQ,CAAC,WAA8B,EAAE,KAAa,EAAA;QAClD,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,YAAY,EAAE;YACpC,OAAO,CAAC,GAAG,CAAC,CAAA,2BAAA,EAA8B,IAAI,CAAC,YAAY,CAAA,eAAA,EAAkB,KAAK,CAAA,CAAA,CAAG,CAAC;AACtF,YAAA,OAAO,KAAK;QAChB;QAIA,IAAI,CAAC,MAAM,EAAE;QAEb,IAAI,CAAC,QAAQ,EAAE;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;AAClG,QAAA,OAAO,CAAC,GAAG,CAAC,CAAA,mBAAA,EAAsB,IAAI,CAAC,QAAQ,CAAA,IAAA,EAAO,KAAK,CAAA,QAAA,EAAW,KAAK,CAAA,CAAA,CAAG,CAAC;QAC/E,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC;AAC5C,QAAA,OAAO,IAAI;IACf;IAGA,KAAK,GAAA;AACD,QAAA,IAAI,CAAC,QAAQ,GAAG,CAAC;QACjB,IAAI,CAAC,MAAM,EAAE;IACjB;IAGA,MAAM,GAAA;AACF,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;AACb,YAAA,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;AACzB,YAAA,IAAI,CAAC,MAAM,GAAG,SAAS;QAC3B;IACJ;AACH;;;;"}
+{"version":3,"file":"ReconnectPolicy.js","sources":["../../../queries/ReconnectPolicy.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 { IReconnectPolicy, ReconnectCallback } from './IReconnectPolicy';\n\n/**\n * Default exponential back-off reconnect policy shared by all observable query connections.\n *\n * Delay formula: `Math.min(initialDelayMs + delayStepMs * attempt, maxDelayMs)`\n *\n * With the default parameters:\n * - Attempt 1 → 1 000 ms\n * - Attempt 2 → 1 500 ms\n * - …\n * - Attempt 19+ → 10 000 ms (capped)\n * - After 100 attempts → abandoned (returns `false`)\n */\nexport class ReconnectPolicy implements IReconnectPolicy {\n    private _attempt = 0;\n    private _timer?: ReturnType<typeof setTimeout>;\n\n    /**\n     * Initializes a new instance of {@link ReconnectPolicy}.\n     * @param {number} maxAttempts Maximum number of reconnect attempts before giving up (default: 100).\n     * @param {number} initialDelayMs Base delay in milliseconds added to every attempt (default: 500).\n     * @param {number} delayStepMs Additional delay per attempt in milliseconds (default: 500).\n     * @param {number} maxDelayMs Upper bound on the computed delay in milliseconds (default: 10 000).\n     */\n    constructor(\n        private readonly _maxAttempts: number = 100,\n        private readonly _initialDelayMs: number = 500,\n        private readonly _delayStepMs: number = 500,\n        private readonly _maxDelayMs: number = 10_000,\n    ) {}\n\n    /** @inheritdoc */\n    get attempt(): number {\n        return this._attempt;\n    }\n\n    /** @inheritdoc */\n    schedule(onReconnect: ReconnectCallback, label: string): boolean {\n        if (this._attempt >= this._maxAttempts) {\n            console.log(`Reconnect: abandoned after ${this._maxAttempts} attempts for '${label}'`);\n            return false;\n        }\n\n        // Cancel any pending reconnect timer so we don't fire multiple\n        // concurrent reconnect attempts when schedule() is called rapidly.\n        this.cancel();\n\n        this._attempt++;\n        const delay = Math.min(this._initialDelayMs + this._delayStepMs * this._attempt, this._maxDelayMs);\n        console.log(`Reconnect: attempt ${this._attempt} in ${delay}ms for '${label}'`);\n        this._timer = setTimeout(onReconnect, delay);\n        return true;\n    }\n\n    /** @inheritdoc */\n    reset(): void {\n        this._attempt = 0;\n        this.cancel();\n    }\n\n    /** @inheritdoc */\n    cancel(): void {\n        if (this._timer) {\n            clearTimeout(this._timer);\n            this._timer = undefined;\n        }\n    }\n}\n"],"names":["ReconnectPolicy","_attempt","_timer","_maxAttempts","_initialDelayMs","_delayStepMs","_maxDelayMs","attempt","schedule","onReconnect","label","console","log","cancel","delay","Math","min","setTimeout","reset","clearTimeout","undefined"],"mappings":";;AAAA;AACA;AAIA;;;;;;;;;;;AAWC,IACM,MAAMA,eAAAA,CAAAA;;;;;AACDC,IAAAA,QAAAA,GAAW,CAAA;IACXC,MAAAA;AAER;;;;;;AAMC,QACD,YACI,YAAiBC,GAAuB,GAAG,EAC3C,eAAiBC,GAA0B,GAAG,EAC7BC,eAAuB,GAAG,EAC3C,WAAiBC,GAAsB,MAAM,CAC/C;aAJmBH,YAAAA,GAAAA,YAAAA;aACAC,eAAAA,GAAAA,eAAAA;aACAC,YAAAA,GAAAA,YAAAA;aACAC,WAAAA,GAAAA,WAAAA;AAClB,IAAA;uBAGH,IAAIC,OAAAA,GAAkB;QAClB,OAAO,IAAI,CAACN,QAAQ;AACxB,IAAA;AAEA,uBACAO,QAAAA,CAASC,WAA8B,EAAEC,KAAa,EAAW;AAC7D,QAAA,IAAI,IAAI,CAACT,QAAQ,IAAI,IAAI,CAACE,YAAY,EAAE;AACpCQ,YAAAA,OAAAA,CAAQC,GAAG,CAAC,CAAC,2BAA2B,EAAE,IAAI,CAACT,YAAY,CAAC,eAAe,EAAEO,KAAAA,CAAM,CAAC,CAAC,CAAA;YACrF,OAAO,KAAA;AACX,QAAA;;;AAIA,QAAA,IAAI,CAACG,MAAM,EAAA;AAEX,QAAA,IAAI,CAACZ,QAAQ,EAAA;AACb,QAAA,MAAMa,QAAQC,IAAAA,CAAKC,GAAG,CAAC,IAAI,CAACZ,eAAe,GAAG,IAAI,CAACC,YAAY,GAAG,IAAI,CAACJ,QAAQ,EAAE,IAAI,CAACK,WAAW,CAAA;AACjGK,QAAAA,OAAAA,CAAQC,GAAG,CAAC,CAAC,mBAAmB,EAAE,IAAI,CAACX,QAAQ,CAAC,IAAI,EAAEa,KAAAA,CAAM,QAAQ,EAAEJ,KAAAA,CAAM,CAAC,CAAC,CAAA;AAC9E,QAAA,IAAI,CAACR,MAAM,GAAGe,UAAAA,CAAWR,WAAAA,EAAaK,KAAAA,CAAAA;QACtC,OAAO,IAAA;AACX,IAAA;AAEA,uBACAI,KAAAA,GAAc;QACV,IAAI,CAACjB,QAAQ,GAAG,CAAA;AAChB,QAAA,IAAI,CAACY,MAAM,EAAA;AACf,IAAA;AAEA,uBACAA,MAAAA,GAAe;QACX,IAAI,IAAI,CAACX,MAAM,EAAE;YACbiB,YAAAA,CAAa,IAAI,CAACjB,MAAM,CAAA;YACxB,IAAI,CAACA,MAAM,GAAGkB,SAAAA;AAClB,QAAA;AACJ,IAAA;AACJ;;;;"}