@cratis/arc 20.17.3 → 20.17.5

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

@@ -14,6 +14,7 @@ export declare abstract class QueryFor<TDataType, TParameters = object> implemen
     private _origin;
     private _httpHeadersCallback;
     abstract readonly route: string;
+    readonly queryName?: string;
     readonly validation?: QueryValidator<any>;
     readonly roles: string[];
     abstract readonly parameterDescriptors: ParameterDescriptor[];

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

@@ -1 +1 @@
-{"version":3,"file":"QueryFor.d.ts","sourceRoot":"","sources":["../../../queries/QueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAOxE,8BAAsB,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;IAuB5F,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IAtBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAE1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,GAAG,SAAS,CAAC;gBAOf,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO;IAUzE,eAAe,CAAC,YAAY,EAAE,MAAM;IAKpC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAKhD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CA4FrE"}
+{"version":3,"file":"QueryFor.d.ts","sourceRoot":"","sources":["../../../queries/QueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAOxE,8BAAsB,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;IAyB5F,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IAxBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAE1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,GAAG,SAAS,CAAC;gBAOf,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO;IAUzE,eAAe,CAAC,YAAY,EAAE,MAAM;IAKpC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAKhD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CA4FrE"}

package/dist/cjs/queries/QueryFor.js

@@ -17,6 +17,7 @@ class QueryFor {
     _apiBasePath;
     _origin;
     _httpHeadersCallback;
+    queryName;
     validation;
     roles = [];
     abortController;

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

@@ -1 +1 @@
-{"version":3,"file":"QueryFor.js","sources":["../../../queries/QueryFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IQueryFor } from './IQueryFor';\nimport { QueryResult } from \"./QueryResult\";\nimport { QueryValidator } from './QueryValidator';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { Constructor } from '@cratis/fundamentals';\nimport { Paging } from './Paging';\nimport { Globals } from '../Globals';\nimport { Sorting } from './Sorting';\nimport { SortDirection } from './SortDirection';\nimport { joinPaths } from '../joinPaths';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class QueryFor<TDataType, TParameters = object> implements IQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _httpHeadersCallback: GetHttpHeaders;\n    abstract readonly route: string;\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    readonly validation?: QueryValidator<any>;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    readonly roles: string[] = [];\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    abstract defaultValue: TDataType;\n    abortController?: AbortController;\n    sorting: Sorting;\n    paging: Paging;\n    parameters: TParameters | undefined;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        args = args || this.parameters;\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return new QueryResult({\n                data: this.defaultValue as object,\n                isSuccess: false,\n                isAuthorized: true,\n                isValid: false,\n                hasExceptions: false,\n                validationResults: clientValidationErrors.map(_ => ({\n                    severity: _.severity,\n                    message: _.message,\n                    members: _.members,\n                    state: _.state\n                })),\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0\n                }\n            }, this.modelType, this.enumerable) as QueryResult<TDataType>;\n        }\n\n        if (!ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, args as object)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        if (this.abortController) {\n            this.abortController.abort();\n        }\n\n        this.abortController = new AbortController();\n\n        const { route, unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        let actualRoute = joinPaths(this._apiBasePath, route);\n        \n        const additionalParams: Record<string, string | number> = {};\n        if (this.paging.hasPaging) {\n            additionalParams.page = this.paging.page;\n            additionalParams.pageSize = this.paging.pageSize;\n        }\n\n        if (this.sorting.hasSorting) {\n            additionalParams.sortBy = this.sorting.field;\n            additionalParams.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const queryParams = UrlHelpers.buildQueryParams({ ...unusedParameters, ...parameterValues }, additionalParams);\n        const queryString = queryParams.toString();\n        if (queryString) {\n            actualRoute += (actualRoute.includes('?') ? '&' : '?') + queryString;\n        }\n        \n        const url = UrlHelpers.createUrlFrom(this._origin, this._apiBasePath, actualRoute);\n\n        const headers = {\n            ... this._httpHeadersCallback?.(), ...\n            {\n                'Accept': 'application/json',\n                'Content-Type': 'application/json'\n            }\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await fetch(url, {\n            method: 'GET',\n            headers,\n            signal: this.abortController.signal\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n}\n"],"names":["Sorting","Paging","Globals","QueryResult","ValidateRequestArguments","UrlHelpers","joinPaths","SortDirection","ParametersHelper"],"mappings":"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"}
+{"version":3,"file":"QueryFor.js","sources":["../../../queries/QueryFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IQueryFor } from './IQueryFor';\nimport { QueryResult } from \"./QueryResult\";\nimport { QueryValidator } from './QueryValidator';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { Constructor } from '@cratis/fundamentals';\nimport { Paging } from './Paging';\nimport { Globals } from '../Globals';\nimport { Sorting } from './Sorting';\nimport { SortDirection } from './SortDirection';\nimport { joinPaths } from '../joinPaths';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class QueryFor<TDataType, TParameters = object> implements IQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _httpHeadersCallback: GetHttpHeaders;\n    abstract readonly route: string;\n    /** Backend fully-qualified query name used as cache key. Overridden in generated proxies. */\n    readonly queryName?: string;\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    readonly validation?: QueryValidator<any>;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    readonly roles: string[] = [];\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    abstract defaultValue: TDataType;\n    abortController?: AbortController;\n    sorting: Sorting;\n    paging: Paging;\n    parameters: TParameters | undefined;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        args = args || this.parameters;\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return new QueryResult({\n                data: this.defaultValue as object,\n                isSuccess: false,\n                isAuthorized: true,\n                isValid: false,\n                hasExceptions: false,\n                validationResults: clientValidationErrors.map(_ => ({\n                    severity: _.severity,\n                    message: _.message,\n                    members: _.members,\n                    state: _.state\n                })),\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0\n                }\n            }, this.modelType, this.enumerable) as QueryResult<TDataType>;\n        }\n\n        if (!ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, args as object)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        if (this.abortController) {\n            this.abortController.abort();\n        }\n\n        this.abortController = new AbortController();\n\n        const { route, unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        let actualRoute = joinPaths(this._apiBasePath, route);\n        \n        const additionalParams: Record<string, string | number> = {};\n        if (this.paging.hasPaging) {\n            additionalParams.page = this.paging.page;\n            additionalParams.pageSize = this.paging.pageSize;\n        }\n\n        if (this.sorting.hasSorting) {\n            additionalParams.sortBy = this.sorting.field;\n            additionalParams.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const queryParams = UrlHelpers.buildQueryParams({ ...unusedParameters, ...parameterValues }, additionalParams);\n        const queryString = queryParams.toString();\n        if (queryString) {\n            actualRoute += (actualRoute.includes('?') ? '&' : '?') + queryString;\n        }\n        \n        const url = UrlHelpers.createUrlFrom(this._origin, this._apiBasePath, actualRoute);\n\n        const headers = {\n            ... this._httpHeadersCallback?.(), ...\n            {\n                'Accept': 'application/json',\n                'Content-Type': 'application/json'\n            }\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await fetch(url, {\n            method: 'GET',\n            headers,\n            signal: this.abortController.signal\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n}\n"],"names":["Sorting","Paging","Globals","QueryResult","ValidateRequestArguments","UrlHelpers","joinPaths","SortDirection","ParametersHelper"],"mappings":";;;;;;;;;;;;MAsBsB,QAAQ,CAAA;AAyBL,IAAA,SAAA;AAAiC,IAAA,UAAA;AAxB9C,IAAA,aAAa;AACb,IAAA,YAAY;AACZ,IAAA,OAAO;AACP,IAAA,oBAAoB;AAGnB,IAAA,SAAS;AAET,IAAA,UAAU;IAEV,KAAK,GAAa,EAAE;AAI7B,IAAA,eAAe;AACf,IAAA,OAAO;AACP,IAAA,MAAM;AACN,IAAA,UAAU;IAOV,WAAA,CAAqB,SAAsB,EAAW,UAAmB,EAAA;QAApD,IAAA,CAAA,SAAS,GAAT,SAAS;QAAwB,IAAA,CAAA,UAAU,GAAV,UAAU;AAC5D,QAAA,IAAI,CAAC,OAAO,GAAGA,eAAO,CAAC,IAAI;AAC3B,QAAA,IAAI,CAAC,MAAM,GAAGC,aAAM,CAAC,QAAQ;QAC7B,IAAI,CAAC,aAAa,GAAGC,eAAO,CAAC,YAAY,IAAI,EAAE;QAC/C,IAAI,CAAC,YAAY,GAAGA,eAAO,CAAC,WAAW,IAAI,EAAE;QAC7C,IAAI,CAAC,OAAO,GAAGA,eAAO,CAAC,MAAM,IAAI,EAAE;QACnC,IAAI,CAAC,oBAAoB,GAAG,OAAO,EAAE,CAAC;IAC1C;AAGA,IAAA,eAAe,CAAC,YAAoB,EAAA;AAChC,QAAA,IAAI,CAAC,aAAa,GAAG,YAAY;IACrC;AAGA,IAAA,cAAc,CAAC,WAAmB,EAAA;AAC9B,QAAA,IAAI,CAAC,YAAY,GAAG,WAAW;IACnC;AAGA,IAAA,SAAS,CAAC,MAAc,EAAA;AACpB,QAAA,IAAI,CAAC,OAAO,GAAG,MAAM;IACzB;AAGA,IAAA,sBAAsB,CAAC,QAAwB,EAAA;AAC3C,QAAA,IAAI,CAAC,oBAAoB,GAAG,QAAQ;IACxC;IAGA,MAAM,OAAO,CAAC,IAAkB,EAAA;AAC5B,QAAA,MAAM,SAAS,GAAG,EAAE,GAAGC,uBAAW,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,EAA4B;AAExG,QAAA,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,UAAU;AAE9B,QAAA,MAAM,sBAAsB,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAc,IAAI,EAAE,CAAC,IAAI,EAAE;AACpF,QAAA,IAAI,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE;YACnC,OAAO,IAAIA,uBAAW,CAAC;gBACnB,IAAI,EAAE,IAAI,CAAC,YAAsB;AACjC,gBAAA,SAAS,EAAE,KAAK;AAChB,gBAAA,YAAY,EAAE,IAAI;AAClB,gBAAA,OAAO,EAAE,KAAK;AACd,gBAAA,aAAa,EAAE,KAAK;gBACpB,iBAAiB,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC,KAAK;oBAChD,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,KAAK,EAAE,CAAC,CAAC;AACZ,iBAAA,CAAC,CAAC;AACH,gBAAA,iBAAiB,EAAE,EAAE;AACrB,gBAAA,mBAAmB,EAAE,EAAE;AACvB,gBAAA,MAAM,EAAE;AACJ,oBAAA,UAAU,EAAE,CAAC;AACb,oBAAA,UAAU,EAAE,CAAC;AACb,oBAAA,IAAI,EAAE,CAAC;AACP,oBAAA,IAAI,EAAE;AACT;aACJ,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAA2B;QACjE;AAEA,QAAA,IAAI,CAACC,iDAAwB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE,IAAc,CAAC,EAAE;AAClG,YAAA,OAAO,IAAI,OAAO,CAAyB,CAAC,OAAO,KAAI;gBACnD,OAAO,CAAC,SAAS,CAAC;AACtB,YAAA,CAAC,CAAC;QACN;AAEA,QAAA,IAAI,IAAI,CAAC,eAAe,EAAE;AACtB,YAAA,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE;QAChC;AAEA,QAAA,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,EAAE;AAE5C,QAAA,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAGC,qBAAU,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAc,CAAC;QACjG,IAAI,WAAW,GAAGC,mBAAS,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC;QAErD,MAAM,gBAAgB,GAAoC,EAAE;AAC5D,QAAA,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;YACvB,gBAAgB,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI;YACxC,gBAAgB,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ;QACpD;AAEA,QAAA,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;YACzB,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK;YAC5C,gBAAgB,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,KAAKC,2BAAa,CAAC,UAAU,IAAI,MAAM,GAAG,KAAK;QAC3G;QAGA,MAAM,eAAe,GAAGC,iCAAgB,CAAC,sBAAsB,CAAC,IAAI,CAAC;AAErE,QAAA,MAAM,WAAW,GAAGH,qBAAU,CAAC,gBAAgB,CAAC,EAAE,GAAG,gBAAgB,EAAE,GAAG,eAAe,EAAE,EAAE,gBAAgB,CAAC;AAC9G,QAAA,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE;QAC1C,IAAI,WAAW,EAAE;AACb,YAAA,WAAW,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,IAAI,WAAW;QACxE;AAEA,QAAA,MAAM,GAAG,GAAGA,qBAAU,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC;AAElF,QAAA,MAAM,OAAO,GAAG;AACZ,YAAA,GAAI,IAAI,CAAC,oBAAoB,IAAI,EAAE,GACnC;AACI,gBAAA,QAAQ,EAAE,kBAAkB;AAC5B,gBAAA,cAAc,EAAE;AACnB;SACJ;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,CAAC,EAAE;YAChC,OAAO,CAACH,eAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC,aAAa;QAChE;AAEA,QAAA,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;AAC9B,YAAA,MAAM,EAAE,KAAK;YACb,OAAO;AACP,YAAA,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC;AAChC,SAAA,CAAC;AAEF,QAAA,IAAI;AACA,YAAA,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE;AACpC,YAAA,OAAO,IAAIC,uBAAW,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC;QACnE;AAAE,QAAA,MAAM;AACJ,YAAA,OAAO,SAAS;QACpB;IACJ;AACH;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryInstanceCache.d.ts","sourceRoot":"","sources":["../../../queries/QueryInstanceCache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAK9D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAKnC,MAAM,MAAM,kBAAkB,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAM9F,MAAM,WAAW,eAAe,CAAC,SAAS;IAItC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAK3B,UAAU,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAK7C,eAAe,EAAE,MAAM,CAAC;IAKxB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;IAMvD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAKtB,UAAU,EAAE,OAAO,CAAC;IAOpB,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAClD;AAUD,qBAAa,kBAAkB;IAWf,OAAO,CAAC,QAAQ,CAAC,YAAY;IAVzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsD;IAC/E,OAAO,CAAC,eAAe,CAAC,CAAgC;gBAS3B,YAAY,GAAE,MAAe;IAS1D,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa;IAuB7D,WAAW,CAAC,SAAS,EACjB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,SAAS,GACzB;QAAE,QAAQ,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE;IAyB1C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAmBjC,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,SAAS;IAUzF,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,GAAG,IAAI;IA8B3F,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,GAAG,IAAI;IAczF,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,GAAG,IAAI;IAc5F,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAc3D,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAYzC,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IA8BjC,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAchC,wBAAwB,IAAI,IAAI;IAkBhC,OAAO,IAAI,IAAI;IAwBf,YAAY,IAAI,IAAI;IAiBpB,oBAAoB,IAAI,IAAI;CAM/B"}
+{"version":3,"file":"QueryInstanceCache.d.ts","sourceRoot":"","sources":["../../../queries/QueryInstanceCache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAK9D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAKnC,MAAM,MAAM,kBAAkB,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAM9F,MAAM,WAAW,eAAe,CAAC,SAAS;IAItC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAK3B,UAAU,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAK7C,eAAe,EAAE,MAAM,CAAC;IAKxB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;IAMvD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAKtB,UAAU,EAAE,OAAO,CAAC;IAOpB,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAClD;AAUD,qBAAa,kBAAkB;IAWf,OAAO,CAAC,QAAQ,CAAC,YAAY;IAVzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsD;IAC/E,OAAO,CAAC,eAAe,CAAC,CAAgC;gBAS3B,YAAY,GAAE,MAAe;IAW1D,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa;IAuB7D,WAAW,CAAC,SAAS,EACjB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,SAAS,GACzB;QAAE,QAAQ,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE;IAyB1C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAmBjC,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,SAAS;IAUzF,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,GAAG,IAAI;IA8B3F,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,GAAG,IAAI;IAczF,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,GAAG,IAAI;IAc5F,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAc3D,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAYzC,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IA8BjC,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAchC,wBAAwB,IAAI,IAAI;IAkBhC,OAAO,IAAI,IAAI;IAwBf,YAAY,IAAI,IAAI;IAiBpB,oBAAoB,IAAI,IAAI;CAM/B"}

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';\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 name of the query constructor (i.e. `constructor.name`).\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"],"names":[],"mappings":"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"}
+{"version":3,"file":"QueryInstanceCache.js","sources":["../../../queries/QueryInstanceCache.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { QueryResultWithState } from './QueryResultWithState';\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"],"names":[],"mappings":"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"}

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

@@ -14,6 +14,7 @@ export declare abstract class QueryFor<TDataType, TParameters = object> implemen
     private _origin;
     private _httpHeadersCallback;
     abstract readonly route: string;
+    readonly queryName?: string;
     readonly validation?: QueryValidator<any>;
     readonly roles: string[];
     abstract readonly parameterDescriptors: ParameterDescriptor[];

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

@@ -1 +1 @@
-{"version":3,"file":"QueryFor.d.ts","sourceRoot":"","sources":["../../../queries/QueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAOxE,8BAAsB,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;IAuB5F,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IAtBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAE1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,GAAG,SAAS,CAAC;gBAOf,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO;IAUzE,eAAe,CAAC,YAAY,EAAE,MAAM;IAKpC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAKhD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CA4FrE"}
+{"version":3,"file":"QueryFor.d.ts","sourceRoot":"","sources":["../../../queries/QueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAOxE,8BAAsB,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;IAyB5F,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IAxBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAE1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,GAAG,SAAS,CAAC;gBAOf,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO;IAUzE,eAAe,CAAC,YAAY,EAAE,MAAM;IAKpC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAKhD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CA4FrE"}

package/dist/esm/queries/QueryFor.js

@@ -15,6 +15,7 @@ class QueryFor {
     _apiBasePath;
     _origin;
     _httpHeadersCallback;
+    queryName;
     validation;
     roles = [];
     abortController;

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

@@ -1 +1 @@
-{"version":3,"file":"QueryFor.js","sources":["../../../queries/QueryFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IQueryFor } from './IQueryFor';\nimport { QueryResult } from \"./QueryResult\";\nimport { QueryValidator } from './QueryValidator';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { Constructor } from '@cratis/fundamentals';\nimport { Paging } from './Paging';\nimport { Globals } from '../Globals';\nimport { Sorting } from './Sorting';\nimport { SortDirection } from './SortDirection';\nimport { joinPaths } from '../joinPaths';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class QueryFor<TDataType, TParameters = object> implements IQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _httpHeadersCallback: GetHttpHeaders;\n    abstract readonly route: string;\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    readonly validation?: QueryValidator<any>;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    readonly roles: string[] = [];\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    abstract defaultValue: TDataType;\n    abortController?: AbortController;\n    sorting: Sorting;\n    paging: Paging;\n    parameters: TParameters | undefined;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        args = args || this.parameters;\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return new QueryResult({\n                data: this.defaultValue as object,\n                isSuccess: false,\n                isAuthorized: true,\n                isValid: false,\n                hasExceptions: false,\n                validationResults: clientValidationErrors.map(_ => ({\n                    severity: _.severity,\n                    message: _.message,\n                    members: _.members,\n                    state: _.state\n                })),\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0\n                }\n            }, this.modelType, this.enumerable) as QueryResult<TDataType>;\n        }\n\n        if (!ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, args as object)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        if (this.abortController) {\n            this.abortController.abort();\n        }\n\n        this.abortController = new AbortController();\n\n        const { route, unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        let actualRoute = joinPaths(this._apiBasePath, route);\n        \n        const additionalParams: Record<string, string | number> = {};\n        if (this.paging.hasPaging) {\n            additionalParams.page = this.paging.page;\n            additionalParams.pageSize = this.paging.pageSize;\n        }\n\n        if (this.sorting.hasSorting) {\n            additionalParams.sortBy = this.sorting.field;\n            additionalParams.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const queryParams = UrlHelpers.buildQueryParams({ ...unusedParameters, ...parameterValues }, additionalParams);\n        const queryString = queryParams.toString();\n        if (queryString) {\n            actualRoute += (actualRoute.includes('?') ? '&' : '?') + queryString;\n        }\n        \n        const url = UrlHelpers.createUrlFrom(this._origin, this._apiBasePath, actualRoute);\n\n        const headers = {\n            ... this._httpHeadersCallback?.(), ...\n            {\n                'Accept': 'application/json',\n                'Content-Type': 'application/json'\n            }\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await fetch(url, {\n            method: 'GET',\n            headers,\n            signal: this.abortController.signal\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"QueryFor.js","sources":["../../../queries/QueryFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IQueryFor } from './IQueryFor';\nimport { QueryResult } from \"./QueryResult\";\nimport { QueryValidator } from './QueryValidator';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { Constructor } from '@cratis/fundamentals';\nimport { Paging } from './Paging';\nimport { Globals } from '../Globals';\nimport { Sorting } from './Sorting';\nimport { SortDirection } from './SortDirection';\nimport { joinPaths } from '../joinPaths';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class QueryFor<TDataType, TParameters = object> implements IQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _httpHeadersCallback: GetHttpHeaders;\n    abstract readonly route: string;\n    /** Backend fully-qualified query name used as cache key. Overridden in generated proxies. */\n    readonly queryName?: string;\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    readonly validation?: QueryValidator<any>;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    readonly roles: string[] = [];\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    abstract defaultValue: TDataType;\n    abortController?: AbortController;\n    sorting: Sorting;\n    paging: Paging;\n    parameters: TParameters | undefined;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        args = args || this.parameters;\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return new QueryResult({\n                data: this.defaultValue as object,\n                isSuccess: false,\n                isAuthorized: true,\n                isValid: false,\n                hasExceptions: false,\n                validationResults: clientValidationErrors.map(_ => ({\n                    severity: _.severity,\n                    message: _.message,\n                    members: _.members,\n                    state: _.state\n                })),\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0\n                }\n            }, this.modelType, this.enumerable) as QueryResult<TDataType>;\n        }\n\n        if (!ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, args as object)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        if (this.abortController) {\n            this.abortController.abort();\n        }\n\n        this.abortController = new AbortController();\n\n        const { route, unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        let actualRoute = joinPaths(this._apiBasePath, route);\n        \n        const additionalParams: Record<string, string | number> = {};\n        if (this.paging.hasPaging) {\n            additionalParams.page = this.paging.page;\n            additionalParams.pageSize = this.paging.pageSize;\n        }\n\n        if (this.sorting.hasSorting) {\n            additionalParams.sortBy = this.sorting.field;\n            additionalParams.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const queryParams = UrlHelpers.buildQueryParams({ ...unusedParameters, ...parameterValues }, additionalParams);\n        const queryString = queryParams.toString();\n        if (queryString) {\n            actualRoute += (actualRoute.includes('?') ? '&' : '?') + queryString;\n        }\n        \n        const url = UrlHelpers.createUrlFrom(this._origin, this._apiBasePath, actualRoute);\n\n        const headers = {\n            ... this._httpHeadersCallback?.(), ...\n            {\n                'Accept': 'application/json',\n                'Content-Type': 'application/json'\n            }\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await fetch(url, {\n            method: 'GET',\n            headers,\n            signal: this.abortController.signal\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryInstanceCache.d.ts","sourceRoot":"","sources":["../../../queries/QueryInstanceCache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAK9D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAKnC,MAAM,MAAM,kBAAkB,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAM9F,MAAM,WAAW,eAAe,CAAC,SAAS;IAItC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAK3B,UAAU,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAK7C,eAAe,EAAE,MAAM,CAAC;IAKxB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;IAMvD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAKtB,UAAU,EAAE,OAAO,CAAC;IAOpB,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAClD;AAUD,qBAAa,kBAAkB;IAWf,OAAO,CAAC,QAAQ,CAAC,YAAY;IAVzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsD;IAC/E,OAAO,CAAC,eAAe,CAAC,CAAgC;gBAS3B,YAAY,GAAE,MAAe;IAS1D,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa;IAuB7D,WAAW,CAAC,SAAS,EACjB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,SAAS,GACzB;QAAE,QAAQ,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE;IAyB1C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAmBjC,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,SAAS;IAUzF,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,GAAG,IAAI;IA8B3F,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,GAAG,IAAI;IAczF,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,GAAG,IAAI;IAc5F,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAc3D,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAYzC,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IA8BjC,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAchC,wBAAwB,IAAI,IAAI;IAkBhC,OAAO,IAAI,IAAI;IAwBf,YAAY,IAAI,IAAI;IAiBpB,oBAAoB,IAAI,IAAI;CAM/B"}
+{"version":3,"file":"QueryInstanceCache.d.ts","sourceRoot":"","sources":["../../../queries/QueryInstanceCache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAK9D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAKnC,MAAM,MAAM,kBAAkB,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAM9F,MAAM,WAAW,eAAe,CAAC,SAAS;IAItC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAK3B,UAAU,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAK7C,eAAe,EAAE,MAAM,CAAC;IAKxB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;IAMvD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAKtB,UAAU,EAAE,OAAO,CAAC;IAOpB,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAClD;AAUD,qBAAa,kBAAkB;IAWf,OAAO,CAAC,QAAQ,CAAC,YAAY;IAVzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsD;IAC/E,OAAO,CAAC,eAAe,CAAC,CAAgC;gBAS3B,YAAY,GAAE,MAAe;IAW1D,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa;IAuB7D,WAAW,CAAC,SAAS,EACjB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,SAAS,GACzB;QAAE,QAAQ,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE;IAyB1C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAmBjC,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,SAAS;IAUzF,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,GAAG,IAAI;IA8B3F,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,GAAG,IAAI;IAczF,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,GAAG,IAAI;IAc5F,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAc3D,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAYzC,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IA8BjC,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAchC,wBAAwB,IAAI,IAAI;IAkBhC,OAAO,IAAI,IAAI;IAwBf,YAAY,IAAI,IAAI;IAiBpB,oBAAoB,IAAI,IAAI;CAM/B"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryInstanceCache.js","sources":["../../../queries/QueryInstanceCache.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { QueryResultWithState } from './QueryResultWithState';\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 name of the query constructor (i.e. `constructor.name`).\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"],"names":[],"mappings":"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"}
+{"version":3,"file":"QueryInstanceCache.js","sources":["../../../queries/QueryInstanceCache.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { QueryResultWithState } from './QueryResultWithState';\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"],"names":[],"mappings":"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"}