@cratis/arc 22.24.0 → 22.26.1

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

@@ -1 +1 @@
-{"version":3,"file":"QueryHttpMethodResolver.js","sources":["../../../queries/QueryHttpMethodResolver.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 { QueryHttpMethod } from './QueryHttpMethod';\n\n/**\n * The information a {@link QueryHttpMethodResolver} uses to decide the HTTP method for a query.\n */\nexport interface QueryHttpMethodResolverContext {\n    /** The URL the query would use as a GET request (arguments in the query string). */\n    readonly url: URL;\n    /** The route template for the query. */\n    readonly route: string;\n    /** The arguments for the query. */\n    readonly args: object;\n}\n\n/**\n * A policy that decides, per query, which {@link QueryHttpMethod} to use.\n * Consulted only when the query has no explicit method set via {@code setHttpMethod}.\n */\nexport type QueryHttpMethodResolver = (context: QueryHttpMethodResolverContext) => QueryHttpMethod;\n\n/**\n * The default URL length, in characters, above which {@link lengthBasedQueryHttpMethod} prefers QUERY.\n * 2000 is the widely-safe URL length across browsers, servers and proxies.\n */\nexport const defaultQueryHttpMethodUrlThreshold = 2000;\n\n/**\n * Options for {@link lengthBasedQueryHttpMethod}.\n */\nexport interface LengthBasedQueryHttpMethodOptions {\n    /** URL length (in characters) above which QUERY is preferred. Defaults to {@link defaultQueryHttpMethodUrlThreshold}. */\n    threshold?: number;\n    /** The method to use when the URL exceeds the threshold. Defaults to {@link QueryHttpMethod.Auto} so it still falls back to GET. */\n    whenLong?: QueryHttpMethod;\n}\n\n/**\n * Creates a {@link QueryHttpMethodResolver} that keeps short queries on GET and prefers QUERY only when\n * the GET URL would exceed a threshold — targeting the arguments-too-large-for-a-URL case while leaving\n * small, cacheable queries on GET.\n * @param options Optional {@link LengthBasedQueryHttpMethodOptions}.\n * @returns A {@link QueryHttpMethodResolver}.\n */\nexport function lengthBasedQueryHttpMethod(options?: LengthBasedQueryHttpMethodOptions): QueryHttpMethodResolver {\n    const threshold = options?.threshold ?? defaultQueryHttpMethodUrlThreshold;\n    const whenLong = options?.whenLong ?? QueryHttpMethod.Auto;\n    return context => (context.url.href.length > threshold ? whenLong : QueryHttpMethod.Get);\n}\n"],"names":["defaultQueryHttpMethodUrlThreshold","lengthBasedQueryHttpMethod","options","threshold","whenLong","QueryHttpMethod","Auto","context","url","href","length","Get"],"mappings":";;;;AAAA;AACA;AAsBA;;;IAIO,MAAMA,kCAAAA,GAAqC;AAYlD;;;;;;IAOO,SAASC,0BAAAA,CAA2BC,OAA2C,EAAA;IAClF,MAAMC,SAAAA,GAAYD,SAASC,SAAAA,IAAaH,kCAAAA;AACxC,IAAA,MAAMI,QAAAA,GAAWF,OAAAA,EAASE,QAAAA,IAAYC,+BAAAA,CAAgBC,IAAI;AAC1D,IAAA,OAAOC,CAAAA,OAAAA,GAAYA,OAAAA,CAAQC,GAAG,CAACC,IAAI,CAACC,MAAM,GAAGP,SAAAA,GAAYC,QAAAA,GAAWC,+BAAAA,CAAgBM,GAAG;AAC3F;;;"}
+{"version":3,"file":"QueryHttpMethodResolver.js","sources":["../../../queries/QueryHttpMethodResolver.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 { QueryHttpMethod } from './QueryHttpMethod.js';\n\n/**\n * The information a {@link QueryHttpMethodResolver} uses to decide the HTTP method for a query.\n */\nexport interface QueryHttpMethodResolverContext {\n    /** The URL the query would use as a GET request (arguments in the query string). */\n    readonly url: URL;\n    /** The route template for the query. */\n    readonly route: string;\n    /** The arguments for the query. */\n    readonly args: object;\n}\n\n/**\n * A policy that decides, per query, which {@link QueryHttpMethod} to use.\n * Consulted only when the query has no explicit method set via {@code setHttpMethod}.\n */\nexport type QueryHttpMethodResolver = (context: QueryHttpMethodResolverContext) => QueryHttpMethod;\n\n/**\n * The default URL length, in characters, above which {@link lengthBasedQueryHttpMethod} prefers QUERY.\n * 2000 is the widely-safe URL length across browsers, servers and proxies.\n */\nexport const defaultQueryHttpMethodUrlThreshold = 2000;\n\n/**\n * Options for {@link lengthBasedQueryHttpMethod}.\n */\nexport interface LengthBasedQueryHttpMethodOptions {\n    /** URL length (in characters) above which QUERY is preferred. Defaults to {@link defaultQueryHttpMethodUrlThreshold}. */\n    threshold?: number;\n    /** The method to use when the URL exceeds the threshold. Defaults to {@link QueryHttpMethod.Auto} so it still falls back to GET. */\n    whenLong?: QueryHttpMethod;\n}\n\n/**\n * Creates a {@link QueryHttpMethodResolver} that keeps short queries on GET and prefers QUERY only when\n * the GET URL would exceed a threshold — targeting the arguments-too-large-for-a-URL case while leaving\n * small, cacheable queries on GET.\n * @param options Optional {@link LengthBasedQueryHttpMethodOptions}.\n * @returns A {@link QueryHttpMethodResolver}.\n */\nexport function lengthBasedQueryHttpMethod(options?: LengthBasedQueryHttpMethodOptions): QueryHttpMethodResolver {\n    const threshold = options?.threshold ?? defaultQueryHttpMethodUrlThreshold;\n    const whenLong = options?.whenLong ?? QueryHttpMethod.Auto;\n    return context => (context.url.href.length > threshold ? whenLong : QueryHttpMethod.Get);\n}\n"],"names":["defaultQueryHttpMethodUrlThreshold","lengthBasedQueryHttpMethod","options","threshold","whenLong","QueryHttpMethod","Auto","context","url","href","length","Get"],"mappings":";;;;AAAA;AACA;AAsBA;;;IAIO,MAAMA,kCAAAA,GAAqC;AAYlD;;;;;;IAOO,SAASC,0BAAAA,CAA2BC,OAA2C,EAAA;IAClF,MAAMC,SAAAA,GAAYD,SAASC,SAAAA,IAAaH,kCAAAA;AACxC,IAAA,MAAMI,QAAAA,GAAWF,OAAAA,EAASE,QAAAA,IAAYC,+BAAAA,CAAgBC,IAAI;AAC1D,IAAA,OAAOC,CAAAA,OAAAA,GAAYA,OAAAA,CAAQC,GAAG,CAACC,IAAI,CAACC,MAAM,GAAGP,SAAAA,GAAYC,QAAAA,GAAWC,+BAAAA,CAAgBM,GAAG;AAC3F;;;"}

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

@@ -0,0 +1,21 @@
+import { Paging } from './Paging.js';
+import { Sorting } from './Sorting.js';
+import { QueryHttpMethod } from './QueryHttpMethod.js';
+export interface BuildQueryHttpRequestOptions {
+    route: string;
+    apiBasePath: string;
+    origin: string;
+    args: object;
+    parameterValues: object;
+    paging: Paging;
+    sorting: Sorting;
+    headers: HeadersInit;
+    signal?: AbortSignal;
+}
+export declare function buildQueryHttpRequest(method: QueryHttpMethod, options: BuildQueryHttpRequestOptions): {
+    url: URL;
+    init: RequestInit;
+};
+export declare function resetQueryHttpMethodResolution(): void;
+export declare function executeQueryHttpRequest(override: QueryHttpMethod | undefined, options: BuildQueryHttpRequestOptions): Promise<Response>;
+//# sourceMappingURL=QueryHttpRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryHttpRequest.d.ts","sourceRoot":"","sources":["../../../queries/QueryHttpRequest.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AASvD,MAAM,WAAW,4BAA4B;IAEzC,KAAK,EAAE,MAAM,CAAC;IAEd,WAAW,EAAE,MAAM,CAAC;IAEpB,MAAM,EAAE,MAAM,CAAC;IAEf,IAAI,EAAE,MAAM,CAAC;IAEb,eAAe,EAAE,MAAM,CAAC;IAExB,MAAM,EAAE,MAAM,CAAC;IAEf,OAAO,EAAE,OAAO,CAAC;IAEjB,OAAO,EAAE,WAAW,CAAC;IAErB,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAsBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,4BAA4B,GAAG;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAsDrI;AAqBD,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAuBD,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,EAAE,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,QAAQ,CAAC,CA6C7I"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryHttpRequest.js","sources":["../../../queries/QueryHttpRequest.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 { Paging } from './Paging';\nimport { Sorting } from './Sorting';\nimport { SortDirection } from './SortDirection';\nimport { QueryHttpMethod } from './QueryHttpMethod';\nimport { joinPaths } from '../joinPaths';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { Globals } from '../Globals';\nimport { isAbortError } from './isAbortError';\n\n/**\n * Options for building an HTTP request for a query.\n */\nexport interface BuildQueryHttpRequestOptions {\n    /** The route template for the query, possibly containing route parameters. */\n    route: string;\n    /** The base path for the API. */\n    apiBasePath: string;\n    /** The origin for the API. */\n    origin: string;\n    /** The arguments used for route-parameter substitution and as query arguments. */\n    args: object;\n    /** Descriptor-collected parameter values that also form query arguments. */\n    parameterValues: object;\n    /** The paging for the query. */\n    paging: Paging;\n    /** The sorting for the query. */\n    sorting: Sorting;\n    /** The HTTP headers to include. */\n    headers: HeadersInit;\n    /** Optional abort signal for the request. */\n    signal?: AbortSignal;\n}\n\ninterface QueryRequestPayload {\n    arguments: object;\n    paging?: { page: number; pageSize: number };\n    sorting?: { field: string; direction: string };\n}\n\nfunction directionToString(sorting: Sorting): string {\n    return sorting.direction === SortDirection.descending ? 'desc' : 'asc';\n}\n\n/**\n * Builds the URL and {@link RequestInit} for performing a query with the given HTTP method.\n *\n * For {@link QueryHttpMethod.Get}, arguments, paging and sorting are placed in the URL query string.\n * For {@link QueryHttpMethod.Query}, route parameters remain in the path while the arguments, paging\n * and sorting are carried in a JSON body envelope.\n * @param method The {@link QueryHttpMethod} to use.\n * @param options The {@link BuildQueryHttpRequestOptions} describing the request.\n * @returns The URL and {@link RequestInit} to pass to {@link fetch}.\n */\nexport function buildQueryHttpRequest(method: QueryHttpMethod, options: BuildQueryHttpRequestOptions): { url: URL; init: RequestInit } {\n    const { route, apiBasePath, origin, args, parameterValues, paging, sorting, headers, signal } = options;\n\n    const { route: replacedRoute, unusedParameters } = UrlHelpers.replaceRouteParameters(route, args);\n    const argumentValues = { ...unusedParameters, ...parameterValues };\n    let actualRoute = joinPaths(apiBasePath, replacedRoute);\n\n    if (method === QueryHttpMethod.Query) {\n        const url = UrlHelpers.createUrlFrom(origin, apiBasePath, actualRoute);\n        const payload: QueryRequestPayload = { arguments: argumentValues };\n        if (paging.hasPaging) {\n            payload.paging = { page: paging.page, pageSize: paging.pageSize };\n        }\n        if (sorting.hasSorting) {\n            payload.sorting = { field: sorting.field, direction: directionToString(sorting) };\n        }\n\n        const requestHeaders = new Headers(headers);\n        if (!requestHeaders.has('Content-Type')) {\n            requestHeaders.set('Content-Type', 'application/json');\n        }\n\n        const init: RequestInit = {\n            method: QueryHttpMethod.Query,\n            headers: requestHeaders,\n            body: JSON.stringify(payload),\n            signal\n        };\n        return { url, init };\n    }\n\n    const additionalParams: Record<string, string | number> = {};\n    if (paging.hasPaging) {\n        additionalParams.page = paging.page;\n        additionalParams.pageSize = paging.pageSize;\n    }\n    if (sorting.hasSorting) {\n        additionalParams.sortBy = sorting.field;\n        additionalParams.sortDirection = directionToString(sorting);\n    }\n\n    const queryParams = UrlHelpers.buildQueryParams(argumentValues, additionalParams);\n    const queryString = queryParams.toString();\n    if (queryString) {\n        actualRoute += (actualRoute.includes('?') ? '&' : '?') + queryString;\n    }\n\n    const url = UrlHelpers.createUrlFrom(origin, apiBasePath, actualRoute);\n    const init: RequestInit = {\n        method: QueryHttpMethod.Get,\n        headers,\n        signal\n    };\n    return { url, init };\n}\n\n/**\n * The transport learned for {@link QueryHttpMethod.Auto}, keyed by backend (origin + API base path).\n * Once QUERY is found to be unsupported for a backend it is pinned to GET for the rest of the session;\n * while QUERY works the backend stays absent so each attempt keeps verifying cheaply. Keying by backend\n * means one backend rejecting QUERY does not downgrade queries to other backends.\n */\nconst autoResolvedMethods = new Map<string, QueryHttpMethod>();\n\n// A NUL separator cannot occur in an origin or an API base path, so no pair of backends can\n// produce the same composite key. Written as an escape rather than a literal control byte,\n// which would make git classify this file as binary and hide every diff of it from review.\nfunction backendKey(options: BuildQueryHttpRequestOptions): string {\n    return `${options.origin}\\0${options.apiBasePath}`;\n}\n\n/**\n * Resets the transport learned for {@link QueryHttpMethod.Auto} for every backend, so the next Auto\n * query re-probes for QUERY support. Useful after a network change, or between tests.\n */\nexport function resetQueryHttpMethodResolution(): void {\n    autoResolvedMethods.clear();\n}\n\nfunction isMethodUnsupported(status: number): boolean {\n    // 405 Method Not Allowed / 501 Not Implemented — the server received the request but will not\n    // handle the verb (e.g. QUERY disabled). A missing intermediary surfaces as a thrown TypeError.\n    return status === 405 || status === 501;\n}\n\n/**\n * Performs the query HTTP request for the given method, resolving {@link QueryHttpMethod.Auto} by\n * preferring QUERY and falling back to GET when the server or network path does not support it.\n *\n * Explicit {@link QueryHttpMethod.Get} and {@link QueryHttpMethod.Query} are honored exactly, with no\n * fallback. For Auto, a transport-level failure — a `405`/`501` response, or a network/CORS error from\n * {@link fetch} — falls back to GET and pins the session to GET. Application-level errors (any other\n * status, returned as a normal {@link Response}) are never treated as a fallback signal.\n *\n * The method is resolved in order of precedence: an explicit per-query {@code override}, then\n * {@link Globals.queryHttpMethodResolver} (given the built GET URL), then {@link Globals.queryHttpMethod}.\n * @param override The explicit per-query {@link QueryHttpMethod}, or `undefined` to resolve from globals.\n * @param options The {@link BuildQueryHttpRequestOptions} describing the request.\n * @returns The {@link Response} from the request that was ultimately sent.\n */\nexport async function executeQueryHttpRequest(override: QueryHttpMethod | undefined, options: BuildQueryHttpRequestOptions): Promise<Response> {\n    // The GET request is built up front when a resolver needs the URL, and reused if GET is chosen.\n    let getRequest: { url: URL; init: RequestInit } | undefined;\n    let method: QueryHttpMethod;\n    if (override !== undefined) {\n        method = override;\n    } else if (Globals.queryHttpMethodResolver) {\n        getRequest = buildQueryHttpRequest(QueryHttpMethod.Get, options);\n        method = Globals.queryHttpMethodResolver({ url: getRequest.url, route: options.route, args: options.args });\n    } else {\n        method = Globals.queryHttpMethod;\n    }\n\n    const send = (httpMethod: QueryHttpMethod): Promise<Response> => {\n        if (httpMethod === QueryHttpMethod.Get && getRequest) {\n            return fetch(getRequest.url, getRequest.init);\n        }\n        const { url, init } = buildQueryHttpRequest(httpMethod, options);\n        return fetch(url, init);\n    };\n\n    if (method !== QueryHttpMethod.Auto) {\n        return send(method);\n    }\n\n    const key = backendKey(options);\n    if (autoResolvedMethods.get(key) === QueryHttpMethod.Get) {\n        return send(QueryHttpMethod.Get);\n    }\n\n    try {\n        const response = await send(QueryHttpMethod.Query);\n        if (isMethodUnsupported(response.status)) {\n            autoResolvedMethods.set(key, QueryHttpMethod.Get);\n            return send(QueryHttpMethod.Get);\n        }\n        autoResolvedMethods.set(key, QueryHttpMethod.Query);\n        return response;\n    } catch (error) {\n        if (isAbortError(error)) {\n            throw error;\n        }\n        autoResolvedMethods.set(key, QueryHttpMethod.Get);\n        return send(QueryHttpMethod.Get);\n    }\n}\n"],"names":["directionToString","sorting","direction","SortDirection","descending","buildQueryHttpRequest","method","options","route","apiBasePath","origin","args","parameterValues","paging","headers","signal","replacedRoute","unusedParameters","UrlHelpers","replaceRouteParameters","argumentValues","actualRoute","joinPaths","QueryHttpMethod","Query","url","createUrlFrom","payload","arguments","hasPaging","page","pageSize","hasSorting","field","requestHeaders","Headers","has","set","init","body","JSON","stringify","additionalParams","sortBy","sortDirection","queryParams","buildQueryParams","queryString","toString","includes","Get","autoResolvedMethods","Map","backendKey","resetQueryHttpMethodResolution","clear","isMethodUnsupported","status","executeQueryHttpRequest","override","getRequest","undefined","Globals","queryHttpMethodResolver","queryHttpMethod","send","httpMethod","fetch","Auto","key","get","response","error","isAbortError"],"mappings":"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"}
+{"version":3,"file":"QueryHttpRequest.js","sources":["../../../queries/QueryHttpRequest.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 { Paging } from './Paging.js';\nimport { Sorting } from './Sorting.js';\nimport { SortDirection } from './SortDirection.js';\nimport { QueryHttpMethod } from './QueryHttpMethod.js';\nimport { joinPaths } from '../joinPaths.js';\nimport { UrlHelpers } from '../UrlHelpers.js';\nimport { Globals } from '../Globals.js';\nimport { isAbortError } from './isAbortError.js';\n\n/**\n * Options for building an HTTP request for a query.\n */\nexport interface BuildQueryHttpRequestOptions {\n    /** The route template for the query, possibly containing route parameters. */\n    route: string;\n    /** The base path for the API. */\n    apiBasePath: string;\n    /** The origin for the API. */\n    origin: string;\n    /** The arguments used for route-parameter substitution and as query arguments. */\n    args: object;\n    /** Descriptor-collected parameter values that also form query arguments. */\n    parameterValues: object;\n    /** The paging for the query. */\n    paging: Paging;\n    /** The sorting for the query. */\n    sorting: Sorting;\n    /** The HTTP headers to include. */\n    headers: HeadersInit;\n    /** Optional abort signal for the request. */\n    signal?: AbortSignal;\n}\n\ninterface QueryRequestPayload {\n    arguments: object;\n    paging?: { page: number; pageSize: number };\n    sorting?: { field: string; direction: string };\n}\n\nfunction directionToString(sorting: Sorting): string {\n    return sorting.direction === SortDirection.descending ? 'desc' : 'asc';\n}\n\n/**\n * Builds the URL and {@link RequestInit} for performing a query with the given HTTP method.\n *\n * For {@link QueryHttpMethod.Get}, arguments, paging and sorting are placed in the URL query string.\n * For {@link QueryHttpMethod.Query}, route parameters remain in the path while the arguments, paging\n * and sorting are carried in a JSON body envelope.\n * @param method The {@link QueryHttpMethod} to use.\n * @param options The {@link BuildQueryHttpRequestOptions} describing the request.\n * @returns The URL and {@link RequestInit} to pass to {@link fetch}.\n */\nexport function buildQueryHttpRequest(method: QueryHttpMethod, options: BuildQueryHttpRequestOptions): { url: URL; init: RequestInit } {\n    const { route, apiBasePath, origin, args, parameterValues, paging, sorting, headers, signal } = options;\n\n    const { route: replacedRoute, unusedParameters } = UrlHelpers.replaceRouteParameters(route, args);\n    const argumentValues = { ...unusedParameters, ...parameterValues };\n    let actualRoute = joinPaths(apiBasePath, replacedRoute);\n\n    if (method === QueryHttpMethod.Query) {\n        const url = UrlHelpers.createUrlFrom(origin, apiBasePath, actualRoute);\n        const payload: QueryRequestPayload = { arguments: argumentValues };\n        if (paging.hasPaging) {\n            payload.paging = { page: paging.page, pageSize: paging.pageSize };\n        }\n        if (sorting.hasSorting) {\n            payload.sorting = { field: sorting.field, direction: directionToString(sorting) };\n        }\n\n        const requestHeaders = new Headers(headers);\n        if (!requestHeaders.has('Content-Type')) {\n            requestHeaders.set('Content-Type', 'application/json');\n        }\n\n        const init: RequestInit = {\n            method: QueryHttpMethod.Query,\n            headers: requestHeaders,\n            body: JSON.stringify(payload),\n            signal\n        };\n        return { url, init };\n    }\n\n    const additionalParams: Record<string, string | number> = {};\n    if (paging.hasPaging) {\n        additionalParams.page = paging.page;\n        additionalParams.pageSize = paging.pageSize;\n    }\n    if (sorting.hasSorting) {\n        additionalParams.sortBy = sorting.field;\n        additionalParams.sortDirection = directionToString(sorting);\n    }\n\n    const queryParams = UrlHelpers.buildQueryParams(argumentValues, additionalParams);\n    const queryString = queryParams.toString();\n    if (queryString) {\n        actualRoute += (actualRoute.includes('?') ? '&' : '?') + queryString;\n    }\n\n    const url = UrlHelpers.createUrlFrom(origin, apiBasePath, actualRoute);\n    const init: RequestInit = {\n        method: QueryHttpMethod.Get,\n        headers,\n        signal\n    };\n    return { url, init };\n}\n\n/**\n * The transport learned for {@link QueryHttpMethod.Auto}, keyed by backend (origin + API base path).\n * Once QUERY is found to be unsupported for a backend it is pinned to GET for the rest of the session;\n * while QUERY works the backend stays absent so each attempt keeps verifying cheaply. Keying by backend\n * means one backend rejecting QUERY does not downgrade queries to other backends.\n */\nconst autoResolvedMethods = new Map<string, QueryHttpMethod>();\n\n// A NUL separator cannot occur in an origin or an API base path, so no pair of backends can\n// produce the same composite key. Written as an escape rather than a literal control byte,\n// which would make git classify this file as binary and hide every diff of it from review.\nfunction backendKey(options: BuildQueryHttpRequestOptions): string {\n    return `${options.origin}\\0${options.apiBasePath}`;\n}\n\n/**\n * Resets the transport learned for {@link QueryHttpMethod.Auto} for every backend, so the next Auto\n * query re-probes for QUERY support. Useful after a network change, or between tests.\n */\nexport function resetQueryHttpMethodResolution(): void {\n    autoResolvedMethods.clear();\n}\n\nfunction isMethodUnsupported(status: number): boolean {\n    // 405 Method Not Allowed / 501 Not Implemented — the server received the request but will not\n    // handle the verb (e.g. QUERY disabled). A missing intermediary surfaces as a thrown TypeError.\n    return status === 405 || status === 501;\n}\n\n/**\n * Performs the query HTTP request for the given method, resolving {@link QueryHttpMethod.Auto} by\n * preferring QUERY and falling back to GET when the server or network path does not support it.\n *\n * Explicit {@link QueryHttpMethod.Get} and {@link QueryHttpMethod.Query} are honored exactly, with no\n * fallback. For Auto, a transport-level failure — a `405`/`501` response, or a network/CORS error from\n * {@link fetch} — falls back to GET and pins the session to GET. Application-level errors (any other\n * status, returned as a normal {@link Response}) are never treated as a fallback signal.\n *\n * The method is resolved in order of precedence: an explicit per-query {@code override}, then\n * {@link Globals.queryHttpMethodResolver} (given the built GET URL), then {@link Globals.queryHttpMethod}.\n * @param override The explicit per-query {@link QueryHttpMethod}, or `undefined` to resolve from globals.\n * @param options The {@link BuildQueryHttpRequestOptions} describing the request.\n * @returns The {@link Response} from the request that was ultimately sent.\n */\nexport async function executeQueryHttpRequest(override: QueryHttpMethod | undefined, options: BuildQueryHttpRequestOptions): Promise<Response> {\n    // The GET request is built up front when a resolver needs the URL, and reused if GET is chosen.\n    let getRequest: { url: URL; init: RequestInit } | undefined;\n    let method: QueryHttpMethod;\n    if (override !== undefined) {\n        method = override;\n    } else if (Globals.queryHttpMethodResolver) {\n        getRequest = buildQueryHttpRequest(QueryHttpMethod.Get, options);\n        method = Globals.queryHttpMethodResolver({ url: getRequest.url, route: options.route, args: options.args });\n    } else {\n        method = Globals.queryHttpMethod;\n    }\n\n    const send = (httpMethod: QueryHttpMethod): Promise<Response> => {\n        if (httpMethod === QueryHttpMethod.Get && getRequest) {\n            return fetch(getRequest.url, getRequest.init);\n        }\n        const { url, init } = buildQueryHttpRequest(httpMethod, options);\n        return fetch(url, init);\n    };\n\n    if (method !== QueryHttpMethod.Auto) {\n        return send(method);\n    }\n\n    const key = backendKey(options);\n    if (autoResolvedMethods.get(key) === QueryHttpMethod.Get) {\n        return send(QueryHttpMethod.Get);\n    }\n\n    try {\n        const response = await send(QueryHttpMethod.Query);\n        if (isMethodUnsupported(response.status)) {\n            autoResolvedMethods.set(key, QueryHttpMethod.Get);\n            return send(QueryHttpMethod.Get);\n        }\n        autoResolvedMethods.set(key, QueryHttpMethod.Query);\n        return response;\n    } catch (error) {\n        if (isAbortError(error)) {\n            throw error;\n        }\n        autoResolvedMethods.set(key, QueryHttpMethod.Get);\n        return send(QueryHttpMethod.Get);\n    }\n}\n"],"names":["directionToString","sorting","direction","SortDirection","descending","buildQueryHttpRequest","method","options","route","apiBasePath","origin","args","parameterValues","paging","headers","signal","replacedRoute","unusedParameters","UrlHelpers","replaceRouteParameters","argumentValues","actualRoute","joinPaths","QueryHttpMethod","Query","url","createUrlFrom","payload","arguments","hasPaging","page","pageSize","hasSorting","field","requestHeaders","Headers","has","set","init","body","JSON","stringify","additionalParams","sortBy","sortDirection","queryParams","buildQueryParams","queryString","toString","includes","Get","autoResolvedMethods","Map","backendKey","resetQueryHttpMethodResolution","clear","isMethodUnsupported","status","executeQueryHttpRequest","override","getRequest","undefined","Globals","queryHttpMethodResolver","queryHttpMethod","send","httpMethod","fetch","Auto","key","get","response","error","isAbortError"],"mappings":"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"}

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

@@ -0,0 +1,40 @@
+import { QueryResultWithState } from './QueryResultWithState.js';
+import type { CacheDiagnostics } from './ObservableQueryDiagnosticsSnapshot.js';
+export type QueryCacheKey = string;
+export type QueryCacheListener<TDataType> = (result: QueryResultWithState<TDataType>) => void;
+export interface QueryCacheEntry<TDataType> {
+    readonly instance: unknown;
+    lastResult?: QueryResultWithState<TDataType>;
+    subscriberCount: number;
+    readonly listeners: Set<QueryCacheListener<TDataType>>;
+    teardown?: () => void;
+    subscribed: boolean;
+    pendingCleanup?: ReturnType<typeof setTimeout>;
+}
+export declare class QueryInstanceCache {
+    private readonly _retentionMs;
+    private readonly _entries;
+    private _pendingDispose?;
+    constructor(_retentionMs?: number);
+    buildKey(queryTypeName: string, args?: object): QueryCacheKey;
+    getOrCreate<TInstance>(key: QueryCacheKey, factory: () => TInstance): {
+        instance: TInstance;
+        isNew: boolean;
+    };
+    acquire(key: QueryCacheKey): void;
+    getLastResult<TDataType>(key: QueryCacheKey): QueryResultWithState<TDataType> | undefined;
+    setLastResult<TDataType>(key: QueryCacheKey, result: QueryResultWithState<TDataType>): void;
+    private withReconciledData;
+    addListener<TDataType>(key: QueryCacheKey, listener: QueryCacheListener<TDataType>): void;
+    removeListener<TDataType>(key: QueryCacheKey, listener: QueryCacheListener<TDataType>): void;
+    setTeardown(key: QueryCacheKey, teardown: () => void): void;
+    isSubscribed(key: QueryCacheKey): boolean;
+    release(key: QueryCacheKey): void;
+    has(key: QueryCacheKey): boolean;
+    teardownAllSubscriptions(): void;
+    dispose(): void;
+    deferDispose(): void;
+    cancelPendingDispose(): void;
+    getDiagnosticsSnapshot(): CacheDiagnostics;
+}
+//# sourceMappingURL=QueryInstanceCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryInstanceCache.d.ts","sourceRoot":"","sources":["../../../queries/QueryInstanceCache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EACR,gBAAgB,EAEnB,MAAM,yCAAyC,CAAC;AAMjD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAKnC,MAAM,MAAM,kBAAkB,CAAC,SAAS,IAAI,CACxC,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,KACtC,IAAI,CAAC;AAMV,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;IASxD,YAA6B,YAAY,GAAE,MAAe,EAAI;IAU9D,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAa5D;IAUD,WAAW,CAAC,SAAS,EACjB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,SAAS,GACzB;QAAE,QAAQ,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAgBzC;IASD,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAWhC;IAQD,aAAa,CAAC,SAAS,EACnB,GAAG,EAAE,aAAa,GACnB,oBAAoB,CAAC,SAAS,CAAC,GAAG,SAAS,CAI7C;IAQD,aAAa,CAAC,SAAS,EACnB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,GACxC,IAAI,CAqCN;IAUD,OAAO,CAAC,kBAAkB;IAgC1B,WAAW,CAAC,SAAS,EACjB,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,GACxC,IAAI,CAMN;IAQD,cAAc,CAAC,SAAS,EACpB,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,GACxC,IAAI,CAMN;IAQD,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAO1D;IAOD,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAExC;IAUD,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAuBhC;IAOD,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAE/B;IAYD,wBAAwB,IAAI,IAAI,CAW/B;IAOD,OAAO,IAAI,IAAI,CAad;IAWD,YAAY,IAAI,IAAI,CASnB;IAQD,oBAAoB,IAAI,IAAI,CAK3B;IAMD,sBAAsB,IAAI,gBAAgB,CAwCzC;CACJ"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryInstanceCache.js","sources":["../../../queries/QueryInstanceCache.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { QueryResultWithState } from './QueryResultWithState';\nimport type {\n    CacheDiagnostics,\n    CacheEntryDiagnostics,\n} from './ObservableQueryDiagnosticsSnapshot';\nimport { reconcileQueryData } from './reconcileQueryData';\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> = (\n    result: QueryResultWithState<TDataType>,\n) => 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     * Builds the cache key for a query.\n     * @param queryTypeName The stable type name for the query. Use the instance's `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>(\n        key: QueryCacheKey,\n    ): QueryResultWithState<TDataType> | undefined {\n        return this._entries.get(key)?.lastResult as\n            | QueryResultWithState<TDataType>\n            | 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>(\n        key: QueryCacheKey,\n        result: QueryResultWithState<TDataType>,\n    ): void {\n        const entry = this._entries.get(key);\n\n        if (!entry) {\n            return;\n        }\n\n        const previousResult = entry.lastResult as\n            | QueryResultWithState<TDataType>\n            | undefined;\n\n        // Reconcile the incoming payload against the one already held so items that did not actually\n        // change keep their previous references. A full snapshot — which is what the server re-sends\n        // whenever a subscription is re-established — otherwise arrives as all-new references and\n        // makes every consumer treat every item as changed.\n        const reconciled =\n            previousResult === undefined\n                ? result\n                : this.withReconciledData(previousResult, result);\n\n        entry.lastResult = reconciled as QueryResultWithState<unknown>;\n\n        // Reconciliation returns the previous data reference when nothing changed, so identity is\n        // enough to detect it. Data, success, and readiness affect what the user sees; changeSet is\n        // ephemeral and does not independently require a notification.\n        if (\n            previousResult !== undefined &&\n            previousResult.isSuccess === reconciled.isSuccess &&\n            previousResult.isReady === reconciled.isReady &&\n            previousResult.data === reconciled.data\n        ) {\n            return;\n        }\n\n        for (const listener of entry.listeners) {\n            (listener as QueryCacheListener<TDataType>)(reconciled);\n        }\n    }\n\n    /**\n     * Returns the incoming result with its data reconciled against the previous result, or the\n     * incoming result unchanged when reconciliation found nothing to carry over.\n     * @template TDataType The type of data returned by the query.\n     * @param previous The previously held result.\n     * @param next The freshly received result.\n     * @returns A result whose data preserves references for everything that did not change.\n     */\n    private withReconciledData<TDataType>(\n        previous: QueryResultWithState<TDataType>,\n        next: QueryResultWithState<TDataType>,\n    ): QueryResultWithState<TDataType> {\n        const reconciledData = reconcileQueryData(previous.data, next.data);\n\n        if (reconciledData === next.data) {\n            return next;\n        }\n\n        return new QueryResultWithState<TDataType>(\n            reconciledData,\n            next.paging,\n            next.isSuccess,\n            next.isAuthorized,\n            next.isValid,\n            next.validationResults,\n            next.hasExceptions,\n            next.exceptionMessages,\n            next.exceptionStackTrace,\n            next.isPerforming,\n            next.changeSet,\n            next.isReady,\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>(\n        key: QueryCacheKey,\n        listener: QueryCacheListener<TDataType>,\n    ): 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>(\n        key: QueryCacheKey,\n        listener: QueryCacheListener<TDataType>,\n    ): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.listeners.delete(listener as QueryCacheListener<unknown>);\n        }\n    }\n\n    /**\n     * Stores a teardown function for the given key and marks the entry as subscribed.\n     * Called automatically when the last subscriber releases the entry.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param teardown Cleanup function that disconnects the underlying query subscription.\n     */\n    setTeardown(key: QueryCacheKey, teardown: () => void): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.teardown = teardown;\n            entry.subscribed = true;\n        }\n    }\n\n    /**\n     * Returns whether an active subscription exists for the given key.\n     * @param key The cache key to check.\n     * @returns `true` if a subscription has been established; `false` otherwise.\n     */\n    isSubscribed(key: QueryCacheKey): boolean {\n        return this._entries.get(key)?.subscribed ?? false;\n    }\n\n    /**\n     * Decrements the subscriber count for the given key. When the count reaches zero, both teardown\n     * and eviction are deferred by one microtask so that React StrictMode re-mounts — in any build\n     * environment — can re-acquire the entry and cancel the cleanup before the timeout fires. This\n     * prevents an unnecessary disconnect/reconnect cycle during the synthetic unmount/remount that\n     * StrictMode performs.\n     * @param key The cache key produced by {@link buildKey}.\n     */\n    release(key: QueryCacheKey): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.subscriberCount--;\n\n            if (entry.subscriberCount <= 0) {\n                // Defer both teardown and eviction.  React StrictMode re-mounts can cancel by\n                // calling acquire() before the timeout fires.  A non-zero _retentionMs keeps the\n                // entry alive so users navigating back quickly see cached data immediately.\n                entry.pendingCleanup = setTimeout(() => {\n                    const current = this._entries.get(key);\n\n                    if (current && current.subscriberCount <= 0) {\n                        current.subscribed = false;\n                        current.teardown?.();\n                        current.teardown = undefined;\n                        current.pendingCleanup = undefined;\n                        this._entries.delete(key);\n                    }\n                }, this._retentionMs);\n            }\n        }\n    }\n\n    /**\n     * Returns whether an entry exists for the given key.\n     * @param key The cache key to check.\n     * @returns `true` if an entry exists; `false` otherwise.\n     */\n    has(key: QueryCacheKey): boolean {\n        return this._entries.has(key);\n    }\n\n    /**\n     * Tears down all active subscriptions and marks every entry as not subscribed,\n     * but preserves entries, subscriber counts, and listeners. This allows\n     * hooks whose effects re-run afterward to detect that the entry is no longer\n     * subscribed and re-establish a fresh connection.\n     *\n     * Use this when the underlying transport must be replaced (e.g. after an\n     * authentication change that requires new WebSocket connections with updated\n     * credentials).\n     */\n    teardownAllSubscriptions(): void {\n        for (const [, entry] of this._entries) {\n            if (entry.pendingCleanup !== undefined) {\n                clearTimeout(entry.pendingCleanup);\n                entry.pendingCleanup = undefined;\n            }\n\n            entry.subscribed = false;\n            entry.teardown?.();\n            entry.teardown = undefined;\n        }\n    }\n\n    /**\n     * Immediately tears down all subscriptions, cancels any pending deferred cleanups,\n     * and evicts all entries. Call when the owning component (e.g. the {@link Arc} provider)\n     * unmounts permanently so that all query connections are closed synchronously.\n     */\n    dispose(): void {\n        for (const [, entry] of this._entries) {\n            if (entry.pendingCleanup !== undefined) {\n                clearTimeout(entry.pendingCleanup);\n                entry.pendingCleanup = undefined;\n            }\n\n            entry.subscribed = false;\n            entry.teardown?.();\n            entry.teardown = undefined;\n        }\n\n        this._entries.clear();\n    }\n\n    /**\n     * Schedules a deferred {@link dispose} using {@code setTimeout(0)}.\n     *\n     * This allows React StrictMode re-mounts to call {@link cancelPendingDispose}\n     * before the dispose fires, avoiding the destruction of cache entries that child\n     * effects are about to re-acquire.\n     *\n     * If a deferred dispose is already pending, it is replaced.\n     */\n    deferDispose(): void {\n        if (this._pendingDispose !== undefined) {\n            clearTimeout(this._pendingDispose);\n        }\n\n        this._pendingDispose = setTimeout(() => {\n            this._pendingDispose = undefined;\n            this.dispose();\n        }, 0);\n    }\n\n    /**\n     * Cancels a pending deferred dispose scheduled by {@link deferDispose}.\n     *\n     * Call from the {@code useEffect} setup phase so that a StrictMode re-mount\n     * prevents the synthetic unmount's deferred dispose from firing.\n     */\n    cancelPendingDispose(): void {\n        if (this._pendingDispose !== undefined) {\n            clearTimeout(this._pendingDispose);\n            this._pendingDispose = undefined;\n        }\n    }\n\n    /**\n     * Returns a diagnostics snapshot of the current cache state.\n     * @returns A {@link CacheDiagnostics} describing all entries.\n     */\n    getDiagnosticsSnapshot(): CacheDiagnostics {\n        const entries: CacheEntryDiagnostics[] = [];\n        let totalBytes = 0;\n        let unhealthyCount = 0;\n\n        for (const [key, entry] of this._entries) {\n            const colonIndex = key.indexOf('::');\n            const queryName = colonIndex >= 0 ? key.substring(0, colonIndex) : key;\n\n            let estimatedBytes = 0;\n            try {\n                if (entry.lastResult !== undefined) {\n                    estimatedBytes = JSON.stringify(entry.lastResult).length;\n                }\n            } catch {\n                // Ignore serialization errors\n            }\n\n            if (entry.subscriberCount > 0 && !entry.subscribed) {\n                unhealthyCount++;\n            }\n\n            totalBytes += estimatedBytes;\n            entries.push({\n                key,\n                queryName,\n                subscriberCount: entry.subscriberCount,\n                listenerCount: entry.listeners.size,\n                subscribed: entry.subscribed,\n                hasResult: entry.lastResult !== undefined,\n                estimatedBytes,\n            });\n        }\n\n        return {\n            healthy: unhealthyCount === 0,\n            entryCount: this._entries.size,\n            estimatedBytes: totalBytes,\n            entries,\n        };\n    }\n}\n"],"names":["QueryInstanceCache","_entries","Map","_pendingDispose","_retentionMs","buildKey","queryTypeName","args","Object","keys","length","sorted","sort","reduce","accumulator","key","JSON","stringify","getOrCreate","factory","has","entry","instance","lastResult","undefined","subscriberCount","listeners","Set","subscribed","set","isNew","get","acquire","pendingCleanup","clearTimeout","getLastResult","setLastResult","result","previousResult","reconciled","withReconciledData","isSuccess","isReady","data","listener","previous","next","reconciledData","reconcileQueryData","QueryResultWithState","paging","isAuthorized","isValid","validationResults","hasExceptions","exceptionMessages","exceptionStackTrace","isPerforming","changeSet","addListener","add","removeListener","delete","setTeardown","teardown","isSubscribed","release","setTimeout","current","teardownAllSubscriptions","dispose","clear","deferDispose","cancelPendingDispose","getDiagnosticsSnapshot","entries","totalBytes","unhealthyCount","colonIndex","indexOf","queryName","substring","estimatedBytes","push","listenerCount","size","hasResult","healthy","entryCount"],"mappings":"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"}
+{"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.js';\nimport type {\n    CacheDiagnostics,\n    CacheEntryDiagnostics,\n} from './ObservableQueryDiagnosticsSnapshot.js';\nimport { reconcileQueryData } from './reconcileQueryData.js';\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> = (\n    result: QueryResultWithState<TDataType>,\n) => 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     * Builds the cache key for a query.\n     * @param queryTypeName The stable type name for the query. Use the instance's `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>(\n        key: QueryCacheKey,\n    ): QueryResultWithState<TDataType> | undefined {\n        return this._entries.get(key)?.lastResult as\n            | QueryResultWithState<TDataType>\n            | 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>(\n        key: QueryCacheKey,\n        result: QueryResultWithState<TDataType>,\n    ): void {\n        const entry = this._entries.get(key);\n\n        if (!entry) {\n            return;\n        }\n\n        const previousResult = entry.lastResult as\n            | QueryResultWithState<TDataType>\n            | undefined;\n\n        // Reconcile the incoming payload against the one already held so items that did not actually\n        // change keep their previous references. A full snapshot — which is what the server re-sends\n        // whenever a subscription is re-established — otherwise arrives as all-new references and\n        // makes every consumer treat every item as changed.\n        const reconciled =\n            previousResult === undefined\n                ? result\n                : this.withReconciledData(previousResult, result);\n\n        entry.lastResult = reconciled as QueryResultWithState<unknown>;\n\n        // Reconciliation returns the previous data reference when nothing changed, so identity is\n        // enough to detect it. Data, success, and readiness affect what the user sees; changeSet is\n        // ephemeral and does not independently require a notification.\n        if (\n            previousResult !== undefined &&\n            previousResult.isSuccess === reconciled.isSuccess &&\n            previousResult.isReady === reconciled.isReady &&\n            previousResult.data === reconciled.data\n        ) {\n            return;\n        }\n\n        for (const listener of entry.listeners) {\n            (listener as QueryCacheListener<TDataType>)(reconciled);\n        }\n    }\n\n    /**\n     * Returns the incoming result with its data reconciled against the previous result, or the\n     * incoming result unchanged when reconciliation found nothing to carry over.\n     * @template TDataType The type of data returned by the query.\n     * @param previous The previously held result.\n     * @param next The freshly received result.\n     * @returns A result whose data preserves references for everything that did not change.\n     */\n    private withReconciledData<TDataType>(\n        previous: QueryResultWithState<TDataType>,\n        next: QueryResultWithState<TDataType>,\n    ): QueryResultWithState<TDataType> {\n        const reconciledData = reconcileQueryData(previous.data, next.data);\n\n        if (reconciledData === next.data) {\n            return next;\n        }\n\n        return new QueryResultWithState<TDataType>(\n            reconciledData,\n            next.paging,\n            next.isSuccess,\n            next.isAuthorized,\n            next.isValid,\n            next.validationResults,\n            next.hasExceptions,\n            next.exceptionMessages,\n            next.exceptionStackTrace,\n            next.isPerforming,\n            next.changeSet,\n            next.isReady,\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>(\n        key: QueryCacheKey,\n        listener: QueryCacheListener<TDataType>,\n    ): 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>(\n        key: QueryCacheKey,\n        listener: QueryCacheListener<TDataType>,\n    ): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.listeners.delete(listener as QueryCacheListener<unknown>);\n        }\n    }\n\n    /**\n     * Stores a teardown function for the given key and marks the entry as subscribed.\n     * Called automatically when the last subscriber releases the entry.\n     * @param key The cache key produced by {@link buildKey}.\n     * @param teardown Cleanup function that disconnects the underlying query subscription.\n     */\n    setTeardown(key: QueryCacheKey, teardown: () => void): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.teardown = teardown;\n            entry.subscribed = true;\n        }\n    }\n\n    /**\n     * Returns whether an active subscription exists for the given key.\n     * @param key The cache key to check.\n     * @returns `true` if a subscription has been established; `false` otherwise.\n     */\n    isSubscribed(key: QueryCacheKey): boolean {\n        return this._entries.get(key)?.subscribed ?? false;\n    }\n\n    /**\n     * Decrements the subscriber count for the given key. When the count reaches zero, both teardown\n     * and eviction are deferred by one microtask so that React StrictMode re-mounts — in any build\n     * environment — can re-acquire the entry and cancel the cleanup before the timeout fires. This\n     * prevents an unnecessary disconnect/reconnect cycle during the synthetic unmount/remount that\n     * StrictMode performs.\n     * @param key The cache key produced by {@link buildKey}.\n     */\n    release(key: QueryCacheKey): void {\n        const entry = this._entries.get(key);\n\n        if (entry) {\n            entry.subscriberCount--;\n\n            if (entry.subscriberCount <= 0) {\n                // Defer both teardown and eviction.  React StrictMode re-mounts can cancel by\n                // calling acquire() before the timeout fires.  A non-zero _retentionMs keeps the\n                // entry alive so users navigating back quickly see cached data immediately.\n                entry.pendingCleanup = setTimeout(() => {\n                    const current = this._entries.get(key);\n\n                    if (current && current.subscriberCount <= 0) {\n                        current.subscribed = false;\n                        current.teardown?.();\n                        current.teardown = undefined;\n                        current.pendingCleanup = undefined;\n                        this._entries.delete(key);\n                    }\n                }, this._retentionMs);\n            }\n        }\n    }\n\n    /**\n     * Returns whether an entry exists for the given key.\n     * @param key The cache key to check.\n     * @returns `true` if an entry exists; `false` otherwise.\n     */\n    has(key: QueryCacheKey): boolean {\n        return this._entries.has(key);\n    }\n\n    /**\n     * Tears down all active subscriptions and marks every entry as not subscribed,\n     * but preserves entries, subscriber counts, and listeners. This allows\n     * hooks whose effects re-run afterward to detect that the entry is no longer\n     * subscribed and re-establish a fresh connection.\n     *\n     * Use this when the underlying transport must be replaced (e.g. after an\n     * authentication change that requires new WebSocket connections with updated\n     * credentials).\n     */\n    teardownAllSubscriptions(): void {\n        for (const [, entry] of this._entries) {\n            if (entry.pendingCleanup !== undefined) {\n                clearTimeout(entry.pendingCleanup);\n                entry.pendingCleanup = undefined;\n            }\n\n            entry.subscribed = false;\n            entry.teardown?.();\n            entry.teardown = undefined;\n        }\n    }\n\n    /**\n     * Immediately tears down all subscriptions, cancels any pending deferred cleanups,\n     * and evicts all entries. Call when the owning component (e.g. the {@link Arc} provider)\n     * unmounts permanently so that all query connections are closed synchronously.\n     */\n    dispose(): void {\n        for (const [, entry] of this._entries) {\n            if (entry.pendingCleanup !== undefined) {\n                clearTimeout(entry.pendingCleanup);\n                entry.pendingCleanup = undefined;\n            }\n\n            entry.subscribed = false;\n            entry.teardown?.();\n            entry.teardown = undefined;\n        }\n\n        this._entries.clear();\n    }\n\n    /**\n     * Schedules a deferred {@link dispose} using {@code setTimeout(0)}.\n     *\n     * This allows React StrictMode re-mounts to call {@link cancelPendingDispose}\n     * before the dispose fires, avoiding the destruction of cache entries that child\n     * effects are about to re-acquire.\n     *\n     * If a deferred dispose is already pending, it is replaced.\n     */\n    deferDispose(): void {\n        if (this._pendingDispose !== undefined) {\n            clearTimeout(this._pendingDispose);\n        }\n\n        this._pendingDispose = setTimeout(() => {\n            this._pendingDispose = undefined;\n            this.dispose();\n        }, 0);\n    }\n\n    /**\n     * Cancels a pending deferred dispose scheduled by {@link deferDispose}.\n     *\n     * Call from the {@code useEffect} setup phase so that a StrictMode re-mount\n     * prevents the synthetic unmount's deferred dispose from firing.\n     */\n    cancelPendingDispose(): void {\n        if (this._pendingDispose !== undefined) {\n            clearTimeout(this._pendingDispose);\n            this._pendingDispose = undefined;\n        }\n    }\n\n    /**\n     * Returns a diagnostics snapshot of the current cache state.\n     * @returns A {@link CacheDiagnostics} describing all entries.\n     */\n    getDiagnosticsSnapshot(): CacheDiagnostics {\n        const entries: CacheEntryDiagnostics[] = [];\n        let totalBytes = 0;\n        let unhealthyCount = 0;\n\n        for (const [key, entry] of this._entries) {\n            const colonIndex = key.indexOf('::');\n            const queryName = colonIndex >= 0 ? key.substring(0, colonIndex) : key;\n\n            let estimatedBytes = 0;\n            try {\n                if (entry.lastResult !== undefined) {\n                    estimatedBytes = JSON.stringify(entry.lastResult).length;\n                }\n            } catch {\n                // Ignore serialization errors\n            }\n\n            if (entry.subscriberCount > 0 && !entry.subscribed) {\n                unhealthyCount++;\n            }\n\n            totalBytes += estimatedBytes;\n            entries.push({\n                key,\n                queryName,\n                subscriberCount: entry.subscriberCount,\n                listenerCount: entry.listeners.size,\n                subscribed: entry.subscribed,\n                hasResult: entry.lastResult !== undefined,\n                estimatedBytes,\n            });\n        }\n\n        return {\n            healthy: unhealthyCount === 0,\n            entryCount: this._entries.size,\n            estimatedBytes: totalBytes,\n            entries,\n        };\n    }\n}\n"],"names":["QueryInstanceCache","_entries","Map","_pendingDispose","_retentionMs","buildKey","queryTypeName","args","Object","keys","length","sorted","sort","reduce","accumulator","key","JSON","stringify","getOrCreate","factory","has","entry","instance","lastResult","undefined","subscriberCount","listeners","Set","subscribed","set","isNew","get","acquire","pendingCleanup","clearTimeout","getLastResult","setLastResult","result","previousResult","reconciled","withReconciledData","isSuccess","isReady","data","listener","previous","next","reconciledData","reconcileQueryData","QueryResultWithState","paging","isAuthorized","isValid","validationResults","hasExceptions","exceptionMessages","exceptionStackTrace","isPerforming","changeSet","addListener","add","removeListener","delete","setTeardown","teardown","isSubscribed","release","setTimeout","current","teardownAllSubscriptions","dispose","clear","deferDispose","cancelPendingDispose","getDiagnosticsSnapshot","entries","totalBytes","unhealthyCount","colonIndex","indexOf","queryName","substring","estimatedBytes","push","listenerCount","size","hasResult","healthy","entryCount"],"mappings":"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"}

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

@@ -0,0 +1,13 @@
+import { Constructor } from '@cratis/fundamentals';
+import { IQueryProvider } from './IQueryProvider.js';
+import { IQuery } from './IQuery.js';
+import { GetHttpHeaders } from '../GetHttpHeaders.js';
+export declare class QueryProvider implements IQueryProvider {
+    private readonly _microservice;
+    private readonly _apiBasePath;
+    private readonly _origin;
+    private readonly _httpHeadersCallback;
+    constructor(_microservice: string, _apiBasePath: string, _origin: string, _httpHeadersCallback: GetHttpHeaders);
+    get<T extends IQuery>(queryType: Constructor<T>): T;
+}
+//# sourceMappingURL=QueryProvider.d.ts.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"QueryProvider.js","sources":["../../../queries/QueryProvider.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\nimport { IQueryProvider } from './IQueryProvider';\nimport { IQuery } from './IQuery';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\n\n/**\n * Represents an implementation of {@link IQueryProvider}\n */\nexport class QueryProvider implements IQueryProvider {\n\n    /**\n     * Initializes a new instance of {@link QueryProvider}\n     * @param _microservice Name of the microservice to provide queries for.\n     * @param _apiBasePath Base path for the API to use for the query.\n     * @param _origin Origin to use for the query.\n     * @param _httpHeadersCallback Callback to get HTTP headers for the query.\n     */\n    constructor(\n        private readonly _microservice: string,\n        private readonly _apiBasePath: string,\n        private readonly _origin: string,\n        private readonly _httpHeadersCallback: GetHttpHeaders) { }\n\n    /** @inheritdoc */\n    get<T extends IQuery>(queryType: Constructor<T>): T {\n        const query = new queryType();\n        query.setMicroservice(this._microservice);\n        query.setApiBasePath(this._apiBasePath);\n        query.setOrigin(this._origin);\n        query.setHttpHeadersCallback(this._httpHeadersCallback);\n        return query;\n    }\n}"],"names":["QueryProvider","_microservice","_origin","_apiBasePath","_httpHeadersCallback","get","queryType","query","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback"],"mappings":";;AAAA;AACA;AAOA;;AAEC,IACM,MAAMA,aAAAA,CAAAA;;;;;AAET;;;;;;AAMC,QACD,WAAA,CACqBC,aAAqB,EACtC,YAAqC,EACpBC,OAAe,EAChC,oBAAqD,CAAE;aAHtCD,aAAAA,GAAAA,aAAAA;aACAE,YAAAA,GAAAA,YAAAA;aACAD,OAAAA,GAAAA,OAAAA;aACAE,oBAAAA,GAAAA,oBAAAA;AAAwC,IAAA;uBAG7DC,GAAAA,CAAsBC,SAAyB,EAAK;AAChD,QAAA,MAAMC,QAAQ,IAAID,SAAAA,EAAAA;AAClBC,QAAAA,KAAAA,CAAMC,eAAe,CAAC,IAAI,CAACP,aAAa,CAAA;AACxCM,QAAAA,KAAAA,CAAME,cAAc,CAAC,IAAI,CAACN,YAAY,CAAA;AACtCI,QAAAA,KAAAA,CAAMG,SAAS,CAAC,IAAI,CAACR,OAAO,CAAA;AAC5BK,QAAAA,KAAAA,CAAMI,sBAAsB,CAAC,IAAI,CAACP,oBAAoB,CAAA;QACtD,OAAOG,KAAAA;AACX,IAAA;AACJ;;"}
+{"version":3,"file":"QueryProvider.js","sources":["../../../queries/QueryProvider.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\nimport { IQueryProvider } from './IQueryProvider.js';\nimport { IQuery } from './IQuery.js';\nimport { GetHttpHeaders } from '../GetHttpHeaders.js';\n\n/**\n * Represents an implementation of {@link IQueryProvider}\n */\nexport class QueryProvider implements IQueryProvider {\n\n    /**\n     * Initializes a new instance of {@link QueryProvider}\n     * @param _microservice Name of the microservice to provide queries for.\n     * @param _apiBasePath Base path for the API to use for the query.\n     * @param _origin Origin to use for the query.\n     * @param _httpHeadersCallback Callback to get HTTP headers for the query.\n     */\n    constructor(\n        private readonly _microservice: string,\n        private readonly _apiBasePath: string,\n        private readonly _origin: string,\n        private readonly _httpHeadersCallback: GetHttpHeaders) { }\n\n    /** @inheritdoc */\n    get<T extends IQuery>(queryType: Constructor<T>): T {\n        const query = new queryType();\n        query.setMicroservice(this._microservice);\n        query.setApiBasePath(this._apiBasePath);\n        query.setOrigin(this._origin);\n        query.setHttpHeadersCallback(this._httpHeadersCallback);\n        return query;\n    }\n}"],"names":["QueryProvider","_microservice","_origin","_apiBasePath","_httpHeadersCallback","get","queryType","query","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback"],"mappings":";;AAAA;AACA;AAOA;;AAEC,IACM,MAAMA,aAAAA,CAAAA;;;;;AAET;;;;;;AAMC,QACD,WAAA,CACqBC,aAAqB,EACtC,YAAqC,EACpBC,OAAe,EAChC,oBAAqD,CAAE;aAHtCD,aAAAA,GAAAA,aAAAA;aACAE,YAAAA,GAAAA,YAAAA;aACAD,OAAAA,GAAAA,OAAAA;aACAE,oBAAAA,GAAAA,oBAAAA;AAAwC,IAAA;uBAG7DC,GAAAA,CAAsBC,SAAyB,EAAK;AAChD,QAAA,MAAMC,QAAQ,IAAID,SAAAA,EAAAA;AAClBC,QAAAA,KAAAA,CAAMC,eAAe,CAAC,IAAI,CAACP,aAAa,CAAA;AACxCM,QAAAA,KAAAA,CAAME,cAAc,CAAC,IAAI,CAACN,YAAY,CAAA;AACtCI,QAAAA,KAAAA,CAAMG,SAAS,CAAC,IAAI,CAACR,OAAO,CAAA;AAC5BK,QAAAA,KAAAA,CAAMI,sBAAsB,CAAC,IAAI,CAACP,oBAAoB,CAAA;QACtD,OAAOG,KAAAA;AACX,IAAA;AACJ;;"}

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

@@ -0,0 +1,62 @@
+import { Constructor } from '@cratis/fundamentals';
+import { ValidationResult } from '../validation/ValidationResult.js';
+import { IQueryResult } from './IQueryResult.js';
+import { PagingInfo } from './PagingInfo.js';
+import { ChangeSet } from './ChangeSet.js';
+type ServerQueryResult = {
+    data: any;
+    isSuccess: boolean;
+    isReady?: boolean;
+    isAuthorized: boolean;
+    isValid: boolean;
+    hasExceptions: boolean;
+    validationResults: ServerValidationResult[];
+    exceptionMessages: string[];
+    exceptionStackTrace: string;
+    paging: ServerPagingInfo;
+    changeSet?: ServerChangeSet;
+};
+type ServerChangeSet = {
+    added: any[];
+    replaced: any[];
+    removed: any[];
+};
+type ServerValidationResult = {
+    severity: number;
+    message: string;
+    members: string[];
+    state: object;
+    reason?: string;
+    reasonDetail?: string;
+};
+type ServerPagingInfo = {
+    page: number;
+    size: number;
+    totalItems: number;
+    totalPages: number;
+};
+export declare class QueryResult<TDataType = object> implements IQueryResult<TDataType> {
+    static empty<TDataType>(defaultValue: TDataType): QueryResult<TDataType>;
+    static validationFailed<TDataType>(validationResults: ValidationResult[], query: {
+        readonly defaultValue: TDataType;
+        readonly modelType: Constructor;
+        readonly enumerable: boolean;
+    }): QueryResult<TDataType>;
+    static unauthorized<TDataType>(): QueryResult<TDataType>;
+    static noSuccess: QueryResult;
+    constructor(result: ServerQueryResult, instanceType: Constructor, enumerable: boolean);
+    readonly data: TDataType;
+    readonly paging: PagingInfo;
+    readonly isSuccess: boolean;
+    readonly isReady: boolean;
+    readonly isAuthorized: boolean;
+    readonly isValid: boolean;
+    readonly hasExceptions: boolean;
+    readonly validationResults: ValidationResult[];
+    readonly exceptionMessages: string[];
+    readonly exceptionStackTrace: string;
+    readonly changeSet?: ChangeSet<unknown>;
+    get hasData(): boolean;
+}
+export {};
+//# sourceMappingURL=QueryResult.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryResult.d.ts","sourceRoot":"","sources":["../../../queries/QueryResult.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryResult.js","sources":["../../../queries/QueryResult.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\nimport { ValidationResult } from '../validation/ValidationResult';\nimport { IQueryResult } from './IQueryResult';\nimport { PagingInfo } from './PagingInfo';\nimport { ChangeSet } from './ChangeSet';\nimport { deserializeQueryModel, deserializeQueryModels } from './deserializeQueryModel';\n\ntype ServerQueryResult = {\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    data: any;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    isSuccess: boolean;\n    isReady?: boolean;\n    isAuthorized: boolean;\n    isValid: boolean;\n    hasExceptions: boolean;\n    validationResults: ServerValidationResult[];\n    exceptionMessages: string[];\n    exceptionStackTrace: string;\n    paging: ServerPagingInfo;\n    changeSet?: ServerChangeSet;\n};\n\ntype ServerChangeSet = {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    added: any[];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    replaced: any[];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    removed: any[];\n};\n\ntype ServerValidationResult = {\n    severity: number;\n    message: string;\n    members: string[];\n    state: object;\n    reason?: string;\n    reasonDetail?: string;\n};\n\ntype ServerPagingInfo = {\n    page: number;\n    size: number;\n    totalItems: number;\n    totalPages: number;\n};\n\n/**\n * Represents the result from executing a {@link IQueryFor}.\n * @template TDataType The data type.\n */\nexport class QueryResult<TDataType = object> implements IQueryResult<TDataType> {\n    /**\n     * Creates a settled empty result. It is ready because no server result is pending.\n     * @param defaultValue The query's empty data value.\n     * @returns A ready empty result.\n     */\n    static empty<TDataType>(defaultValue: TDataType): QueryResult<TDataType> {\n        return new QueryResult(\n            {\n                data: defaultValue as object,\n                isSuccess: true,\n                isReady: true,\n                isAuthorized: true,\n                isValid: true,\n                hasExceptions: false,\n                validationResults: [],\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0,\n                },\n            },\n            Object,\n            false,\n        );\n    }\n\n    /**\n     * Creates a {@link QueryResult} representing a query rejected by client-side validation, mirroring\n     * {@link CommandResult.validationFailed} so a caller reads a failed query the same way it reads a failed command.\n     * @param {ValidationResult[]} validationResults The validation results that caused the failure.\n     * @param {object} query The query being rejected, which describes how to shape its own result.\n     * @returns {QueryResult<TDataType>} A ready result that is neither successful nor valid.\n     */\n    static validationFailed<TDataType>(\n        validationResults: ValidationResult[],\n        query: {\n            readonly defaultValue: TDataType;\n            readonly modelType: Constructor;\n            readonly enumerable: boolean;\n        },\n    ): QueryResult<TDataType> {\n        const { defaultValue, modelType, enumerable } = query;\n        return new QueryResult(\n            {\n                data: defaultValue as object,\n                isSuccess: false,\n                isReady: true,\n                isAuthorized: true,\n                isValid: false,\n                hasExceptions: false,\n                validationResults: validationResults.map((_) => ({\n                    severity: _.severity,\n                    message: _.message,\n                    members: _.members,\n                    state: _.state,\n                    reason: _.reason,\n                    reasonDetail: _.reasonDetail,\n                })),\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0,\n                },\n            },\n            modelType,\n            enumerable,\n        ) as QueryResult<TDataType>;\n    }\n\n    /**\n     * Creates a settled unauthorized result. Authorization rejection is terminal, so the result is ready.\n     * @returns A ready unauthorized result.\n     */\n    static unauthorized<TDataType>(): QueryResult<TDataType> {\n        return new QueryResult(\n            {\n                // SAFETY: An unauthorized result intentionally has no data, while the wire envelope uses object.\n                data: null as unknown as object,\n                isSuccess: false,\n                isReady: true,\n                isAuthorized: false,\n                isValid: true,\n                hasExceptions: false,\n                validationResults: [],\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0,\n                },\n            },\n            Object,\n            false,\n        );\n    }\n\n    /**\n     * A settled unsuccessful result used for client-side and transport failures. These failures are ready because\n     * the client has completed the attempt; they are not the server's transient not-ready state.\n     */\n    static noSuccess: QueryResult = new QueryResult(\n        {\n            data: {},\n            isSuccess: false,\n            isReady: true,\n            isAuthorized: true,\n            isValid: true,\n            hasExceptions: false,\n            validationResults: [],\n            exceptionMessages: [],\n            exceptionStackTrace: '',\n            paging: {\n                totalItems: 0,\n                totalPages: 0,\n                page: 0,\n                size: 0,\n            },\n        },\n        Object,\n        false,\n    );\n\n    /**\n     * Creates an instance of query result.\n     * @param {*} result The raw result from the backend.\n     * @param {Constructor} instanceType The type of instance to deserialize.\n     * @param {boolean} enumerable Whether or not the result is supposed be an enumerable or not.\n     */\n    constructor(\n        result: ServerQueryResult,\n        instanceType: Constructor,\n        enumerable: boolean,\n    ) {\n        this.isSuccess = result.isSuccess;\n        // Older servers and hand-built envelopes do not carry readiness. Those results predate\n        // the transient not-ready state and are therefore complete from the client's perspective.\n        this.isReady = result.isReady ?? true;\n        this.isAuthorized = result.isAuthorized;\n        this.isValid = result.isValid;\n        this.hasExceptions = result.hasExceptions;\n        this.validationResults = result.validationResults.map(\n            (_) =>\n                new ValidationResult(\n                    _.severity,\n                    _.message,\n                    _.members,\n                    _.state,\n                    _.reason,\n                    _.reasonDetail,\n                ),\n        );\n        this.exceptionMessages = result.exceptionMessages;\n        this.exceptionStackTrace = result.exceptionStackTrace;\n        this.paging = new PagingInfo();\n        this.paging.page = result.paging.page;\n        this.paging.size = result.paging.size;\n        this.paging.totalItems = result.paging.totalItems;\n        this.paging.totalPages = result.paging.totalPages;\n\n        if (result.data) {\n            this.data = (\n                enumerable\n                    ? deserializeQueryModels(instanceType, result.data)\n                    : deserializeQueryModel(instanceType, result.data)\n            ) as TDataType;\n        } else {\n            this.data = (enumerable ? [] : null) as TDataType;\n        }\n\n        if (enumerable && result.changeSet) {\n            this.changeSet = {\n                added: deserializeQueryModels(instanceType, result.changeSet.added ?? []),\n                replaced: deserializeQueryModels(\n                    instanceType,\n                    result.changeSet.replaced ?? [],\n                ),\n                removed: deserializeQueryModels(\n                    instanceType,\n                    result.changeSet.removed ?? [],\n                ),\n            } as ChangeSet<unknown>;\n        }\n    }\n\n    /** @inheritdoc */\n    readonly data: TDataType;\n\n    /** @inheritdoc */\n    readonly paging: PagingInfo;\n\n    /** @inheritdoc */\n    readonly isSuccess: boolean;\n\n    /** @inheritdoc */\n    readonly isReady: boolean;\n\n    /** @inheritdoc */\n    readonly isAuthorized: boolean;\n\n    /** @inheritdoc */\n    readonly isValid: boolean;\n\n    /** @inheritdoc */\n    readonly hasExceptions: boolean;\n\n    /** @inheritdoc */\n    readonly validationResults: ValidationResult[];\n\n    /** @inheritdoc */\n    readonly exceptionMessages: string[];\n\n    /** @inheritdoc */\n    readonly exceptionStackTrace: string;\n\n    /**\n     * Gets the optional change set describing what changed since the previous update.\n     * Set by the server when the delta transfer mode is active.\n     * When present, clients can apply the delta to their local state rather than replacing\n     * the full dataset.\n     */\n    readonly changeSet?: ChangeSet<unknown>;\n\n    /**\n     * Gets whether or not the query has data.\n     */\n    get hasData(): boolean {\n        if (this.data) {\n            if (Array.isArray(this.data)) {\n                return this.data.length > 0;\n            }\n            return true;\n        }\n        return false;\n    }\n}\n"],"names":["QueryResult","empty","defaultValue","data","isSuccess","isReady","isAuthorized","isValid","hasExceptions","validationResults","exceptionMessages","exceptionStackTrace","paging","totalItems","totalPages","page","size","Object","validationFailed","query","modelType","enumerable","map","_","severity","message","members","state","reason","reasonDetail","unauthorized","noSuccess","result","instanceType","ValidationResult","PagingInfo","deserializeQueryModels","deserializeQueryModel","changeSet","added","replaced","removed","hasData","Array","isArray","length"],"mappings":"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"}
+{"version":3,"file":"QueryResult.js","sources":["../../../queries/QueryResult.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\nimport { ValidationResult } from '../validation/ValidationResult.js';\nimport { IQueryResult } from './IQueryResult.js';\nimport { PagingInfo } from './PagingInfo.js';\nimport { ChangeSet } from './ChangeSet.js';\nimport { deserializeQueryModel, deserializeQueryModels } from './deserializeQueryModel.js';\n\ntype ServerQueryResult = {\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    data: any;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    isSuccess: boolean;\n    isReady?: boolean;\n    isAuthorized: boolean;\n    isValid: boolean;\n    hasExceptions: boolean;\n    validationResults: ServerValidationResult[];\n    exceptionMessages: string[];\n    exceptionStackTrace: string;\n    paging: ServerPagingInfo;\n    changeSet?: ServerChangeSet;\n};\n\ntype ServerChangeSet = {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    added: any[];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    replaced: any[];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    removed: any[];\n};\n\ntype ServerValidationResult = {\n    severity: number;\n    message: string;\n    members: string[];\n    state: object;\n    reason?: string;\n    reasonDetail?: string;\n};\n\ntype ServerPagingInfo = {\n    page: number;\n    size: number;\n    totalItems: number;\n    totalPages: number;\n};\n\n/**\n * Represents the result from executing a {@link IQueryFor}.\n * @template TDataType The data type.\n */\nexport class QueryResult<TDataType = object> implements IQueryResult<TDataType> {\n    /**\n     * Creates a settled empty result. It is ready because no server result is pending.\n     * @param defaultValue The query's empty data value.\n     * @returns A ready empty result.\n     */\n    static empty<TDataType>(defaultValue: TDataType): QueryResult<TDataType> {\n        return new QueryResult(\n            {\n                data: defaultValue as object,\n                isSuccess: true,\n                isReady: true,\n                isAuthorized: true,\n                isValid: true,\n                hasExceptions: false,\n                validationResults: [],\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0,\n                },\n            },\n            Object,\n            false,\n        );\n    }\n\n    /**\n     * Creates a {@link QueryResult} representing a query rejected by client-side validation, mirroring\n     * {@link CommandResult.validationFailed} so a caller reads a failed query the same way it reads a failed command.\n     * @param {ValidationResult[]} validationResults The validation results that caused the failure.\n     * @param {object} query The query being rejected, which describes how to shape its own result.\n     * @returns {QueryResult<TDataType>} A ready result that is neither successful nor valid.\n     */\n    static validationFailed<TDataType>(\n        validationResults: ValidationResult[],\n        query: {\n            readonly defaultValue: TDataType;\n            readonly modelType: Constructor;\n            readonly enumerable: boolean;\n        },\n    ): QueryResult<TDataType> {\n        const { defaultValue, modelType, enumerable } = query;\n        return new QueryResult(\n            {\n                data: defaultValue as object,\n                isSuccess: false,\n                isReady: true,\n                isAuthorized: true,\n                isValid: false,\n                hasExceptions: false,\n                validationResults: validationResults.map((_) => ({\n                    severity: _.severity,\n                    message: _.message,\n                    members: _.members,\n                    state: _.state,\n                    reason: _.reason,\n                    reasonDetail: _.reasonDetail,\n                })),\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0,\n                },\n            },\n            modelType,\n            enumerable,\n        ) as QueryResult<TDataType>;\n    }\n\n    /**\n     * Creates a settled unauthorized result. Authorization rejection is terminal, so the result is ready.\n     * @returns A ready unauthorized result.\n     */\n    static unauthorized<TDataType>(): QueryResult<TDataType> {\n        return new QueryResult(\n            {\n                // SAFETY: An unauthorized result intentionally has no data, while the wire envelope uses object.\n                data: null as unknown as object,\n                isSuccess: false,\n                isReady: true,\n                isAuthorized: false,\n                isValid: true,\n                hasExceptions: false,\n                validationResults: [],\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0,\n                },\n            },\n            Object,\n            false,\n        );\n    }\n\n    /**\n     * A settled unsuccessful result used for client-side and transport failures. These failures are ready because\n     * the client has completed the attempt; they are not the server's transient not-ready state.\n     */\n    static noSuccess: QueryResult = new QueryResult(\n        {\n            data: {},\n            isSuccess: false,\n            isReady: true,\n            isAuthorized: true,\n            isValid: true,\n            hasExceptions: false,\n            validationResults: [],\n            exceptionMessages: [],\n            exceptionStackTrace: '',\n            paging: {\n                totalItems: 0,\n                totalPages: 0,\n                page: 0,\n                size: 0,\n            },\n        },\n        Object,\n        false,\n    );\n\n    /**\n     * Creates an instance of query result.\n     * @param {*} result The raw result from the backend.\n     * @param {Constructor} instanceType The type of instance to deserialize.\n     * @param {boolean} enumerable Whether or not the result is supposed be an enumerable or not.\n     */\n    constructor(\n        result: ServerQueryResult,\n        instanceType: Constructor,\n        enumerable: boolean,\n    ) {\n        this.isSuccess = result.isSuccess;\n        // Older servers and hand-built envelopes do not carry readiness. Those results predate\n        // the transient not-ready state and are therefore complete from the client's perspective.\n        this.isReady = result.isReady ?? true;\n        this.isAuthorized = result.isAuthorized;\n        this.isValid = result.isValid;\n        this.hasExceptions = result.hasExceptions;\n        this.validationResults = result.validationResults.map(\n            (_) =>\n                new ValidationResult(\n                    _.severity,\n                    _.message,\n                    _.members,\n                    _.state,\n                    _.reason,\n                    _.reasonDetail,\n                ),\n        );\n        this.exceptionMessages = result.exceptionMessages;\n        this.exceptionStackTrace = result.exceptionStackTrace;\n        this.paging = new PagingInfo();\n        this.paging.page = result.paging.page;\n        this.paging.size = result.paging.size;\n        this.paging.totalItems = result.paging.totalItems;\n        this.paging.totalPages = result.paging.totalPages;\n\n        if (result.data) {\n            this.data = (\n                enumerable\n                    ? deserializeQueryModels(instanceType, result.data)\n                    : deserializeQueryModel(instanceType, result.data)\n            ) as TDataType;\n        } else {\n            this.data = (enumerable ? [] : null) as TDataType;\n        }\n\n        if (enumerable && result.changeSet) {\n            this.changeSet = {\n                added: deserializeQueryModels(instanceType, result.changeSet.added ?? []),\n                replaced: deserializeQueryModels(\n                    instanceType,\n                    result.changeSet.replaced ?? [],\n                ),\n                removed: deserializeQueryModels(\n                    instanceType,\n                    result.changeSet.removed ?? [],\n                ),\n            } as ChangeSet<unknown>;\n        }\n    }\n\n    /** @inheritdoc */\n    readonly data: TDataType;\n\n    /** @inheritdoc */\n    readonly paging: PagingInfo;\n\n    /** @inheritdoc */\n    readonly isSuccess: boolean;\n\n    /** @inheritdoc */\n    readonly isReady: boolean;\n\n    /** @inheritdoc */\n    readonly isAuthorized: boolean;\n\n    /** @inheritdoc */\n    readonly isValid: boolean;\n\n    /** @inheritdoc */\n    readonly hasExceptions: boolean;\n\n    /** @inheritdoc */\n    readonly validationResults: ValidationResult[];\n\n    /** @inheritdoc */\n    readonly exceptionMessages: string[];\n\n    /** @inheritdoc */\n    readonly exceptionStackTrace: string;\n\n    /**\n     * Gets the optional change set describing what changed since the previous update.\n     * Set by the server when the delta transfer mode is active.\n     * When present, clients can apply the delta to their local state rather than replacing\n     * the full dataset.\n     */\n    readonly changeSet?: ChangeSet<unknown>;\n\n    /**\n     * Gets whether or not the query has data.\n     */\n    get hasData(): boolean {\n        if (this.data) {\n            if (Array.isArray(this.data)) {\n                return this.data.length > 0;\n            }\n            return true;\n        }\n        return false;\n    }\n}\n"],"names":["QueryResult","empty","defaultValue","data","isSuccess","isReady","isAuthorized","isValid","hasExceptions","validationResults","exceptionMessages","exceptionStackTrace","paging","totalItems","totalPages","page","size","Object","validationFailed","query","modelType","enumerable","map","_","severity","message","members","state","reason","reasonDetail","unauthorized","noSuccess","result","instanceType","ValidationResult","PagingInfo","deserializeQueryModels","deserializeQueryModel","changeSet","added","replaced","removed","hasData","Array","isArray","length"],"mappings":";;;;;;AAAA;AACA;AAkDA;;;AAGC,IACM,MAAMA,WAAAA,CAAAA;AACT;;;;QAKA,OAAOC,KAAAA,CAAiBC,YAAuB,EAA0B;AACrE,QAAA,OAAO,IAAIF,WAAAA,CACP;YACIG,IAAAA,EAAMD,YAAAA;YACNE,SAAAA,EAAW,IAAA;YACXC,OAAAA,EAAS,IAAA;YACTC,YAAAA,EAAc,IAAA;YACdC,OAAAA,EAAS,IAAA;YACTC,aAAAA,EAAe,KAAA;AACfC,YAAAA,iBAAAA,EAAmB,EAAE;AACrBC,YAAAA,iBAAAA,EAAmB,EAAE;YACrBC,mBAAAA,EAAqB,EAAA;YACrBC,MAAAA,EAAQ;gBACJC,UAAAA,EAAY,CAAA;gBACZC,UAAAA,EAAY,CAAA;gBACZC,IAAAA,EAAM,CAAA;gBACNC,IAAAA,EAAM;AACV;AACJ,SAAA,EACAC,MAAAA,EACA,KAAA,CAAA;AAER,IAAA;AAEA;;;;;;AAMC,QACD,OAAOC,gBAAAA,CACHT,iBAAqC,EACrCU,KAIC,EACqB;AACtB,QAAA,MAAM,EAAEjB,YAAY,EAAEkB,SAAS,EAAEC,UAAU,EAAE,GAAGF,KAAAA;AAChD,QAAA,OAAO,IAAInB,WAAAA,CACP;YACIG,IAAAA,EAAMD,YAAAA;YACNE,SAAAA,EAAW,KAAA;YACXC,OAAAA,EAAS,IAAA;YACTC,YAAAA,EAAc,IAAA;YACdC,OAAAA,EAAS,KAAA;YACTC,aAAAA,EAAe,KAAA;AACfC,YAAAA,iBAAAA,EAAmBA,iBAAAA,CAAkBa,GAAG,CAAC,CAACC,KAAO;AAC7CC,oBAAAA,QAAAA,EAAUD,EAAEC,QAAQ;AACpBC,oBAAAA,OAAAA,EAASF,EAAEE,OAAO;AAClBC,oBAAAA,OAAAA,EAASH,EAAEG,OAAO;AAClBC,oBAAAA,KAAAA,EAAOJ,EAAEI,KAAK;AACdC,oBAAAA,MAAAA,EAAQL,EAAEK,MAAM;AAChBC,oBAAAA,YAAAA,EAAcN,EAAEM;iBACpB,CAAA,CAAA;AACAnB,YAAAA,iBAAAA,EAAmB,EAAE;YACrBC,mBAAAA,EAAqB,EAAA;YACrBC,MAAAA,EAAQ;gBACJC,UAAAA,EAAY,CAAA;gBACZC,UAAAA,EAAY,CAAA;gBACZC,IAAAA,EAAM,CAAA;gBACNC,IAAAA,EAAM;AACV;AACJ,SAAA,EACAI,SAAAA,EACAC,UAAAA,CAAAA;AAER,IAAA;AAEA;;;AAGC,QACD,OAAOS,YAAAA,GAAkD;AACrD,QAAA,OAAO,IAAI9B,WAAAA,CACP;;YAEIG,IAAAA,EAAM,IAAA;YACNC,SAAAA,EAAW,KAAA;YACXC,OAAAA,EAAS,IAAA;YACTC,YAAAA,EAAc,KAAA;YACdC,OAAAA,EAAS,IAAA;YACTC,aAAAA,EAAe,KAAA;AACfC,YAAAA,iBAAAA,EAAmB,EAAE;AACrBC,YAAAA,iBAAAA,EAAmB,EAAE;YACrBC,mBAAAA,EAAqB,EAAA;YACrBC,MAAAA,EAAQ;gBACJC,UAAAA,EAAY,CAAA;gBACZC,UAAAA,EAAY,CAAA;gBACZC,IAAAA,EAAM,CAAA;gBACNC,IAAAA,EAAM;AACV;AACJ,SAAA,EACAC,MAAAA,EACA,KAAA,CAAA;AAER,IAAA;AAEA;;;QAIA,OAAOc,SAAAA,GAAyB,IAAI/B,WAAAA,CAChC;AACIG,QAAAA,IAAAA,EAAM,EAAC;QACPC,SAAAA,EAAW,KAAA;QACXC,OAAAA,EAAS,IAAA;QACTC,YAAAA,EAAc,IAAA;QACdC,OAAAA,EAAS,IAAA;QACTC,aAAAA,EAAe,KAAA;AACfC,QAAAA,iBAAAA,EAAmB,EAAE;AACrBC,QAAAA,iBAAAA,EAAmB,EAAE;QACrBC,mBAAAA,EAAqB,EAAA;QACrBC,MAAAA,EAAQ;YACJC,UAAAA,EAAY,CAAA;YACZC,UAAAA,EAAY,CAAA;YACZC,IAAAA,EAAM,CAAA;YACNC,IAAAA,EAAM;AACV;AACJ,KAAA,EACAC,QACA,KAAA,CAAA;AAGJ;;;;;AAKC,QACD,YACIe,MAAyB,EACzBC,YAAyB,EACzBZ,UAAmB,CACrB;AACE,QAAA,IAAI,CAACjB,SAAS,GAAG4B,MAAAA,CAAO5B,SAAS;;;AAGjC,QAAA,IAAI,CAACC,OAAO,GAAG2B,MAAAA,CAAO3B,OAAO,IAAI,IAAA;AACjC,QAAA,IAAI,CAACC,YAAY,GAAG0B,MAAAA,CAAO1B,YAAY;AACvC,QAAA,IAAI,CAACC,OAAO,GAAGyB,MAAAA,CAAOzB,OAAO;AAC7B,QAAA,IAAI,CAACC,aAAa,GAAGwB,MAAAA,CAAOxB,aAAa;AACzC,QAAA,IAAI,CAACC,iBAAiB,GAAGuB,MAAAA,CAAOvB,iBAAiB,CAACa,GAAG,CACjD,CAACC,CAAAA,GACG,IAAIW,iCAAAA,CACAX,CAAAA,CAAEC,QAAQ,EACVD,CAAAA,CAAEE,OAAO,EACTF,CAAAA,CAAEG,OAAO,EACTH,CAAAA,CAAEI,KAAK,EACPJ,CAAAA,CAAEK,MAAM,EACRL,CAAAA,CAAEM,YAAY,CAAA,CAAA;AAG1B,QAAA,IAAI,CAACnB,iBAAiB,GAAGsB,MAAAA,CAAOtB,iBAAiB;AACjD,QAAA,IAAI,CAACC,mBAAmB,GAAGqB,MAAAA,CAAOrB,mBAAmB;QACrD,IAAI,CAACC,MAAM,GAAG,IAAIuB,qBAAAA,EAAAA;QAClB,IAAI,CAACvB,MAAM,CAACG,IAAI,GAAGiB,MAAAA,CAAOpB,MAAM,CAACG,IAAI;QACrC,IAAI,CAACH,MAAM,CAACI,IAAI,GAAGgB,MAAAA,CAAOpB,MAAM,CAACI,IAAI;QACrC,IAAI,CAACJ,MAAM,CAACC,UAAU,GAAGmB,MAAAA,CAAOpB,MAAM,CAACC,UAAU;QACjD,IAAI,CAACD,MAAM,CAACE,UAAU,GAAGkB,MAAAA,CAAOpB,MAAM,CAACE,UAAU;QAEjD,IAAIkB,MAAAA,CAAO7B,IAAI,EAAE;AACb,YAAA,IAAI,CAACA,IAAI,GACLkB,UAAAA,GACMe,4CAAAA,CAAuBH,YAAAA,EAAcD,MAAAA,CAAO7B,IAAI,CAAA,GAChDkC,2CAAAA,CAAsBJ,YAAAA,EAAcD,MAAAA,CAAO7B,IAAI,CAAA;QAE7D,CAAA,MAAO;AACH,YAAA,IAAI,CAACA,IAAI,GAAIkB,UAAAA,GAAa,EAAE,GAAG,IAAA;AACnC,QAAA;QAEA,IAAIA,UAAAA,IAAcW,MAAAA,CAAOM,SAAS,EAAE;YAChC,IAAI,CAACA,SAAS,GAAG;AACbC,gBAAAA,KAAAA,EAAOH,6CAAuBH,YAAAA,EAAcD,MAAAA,CAAOM,SAAS,CAACC,KAAK,IAAI,EAAE,CAAA;AACxEC,gBAAAA,QAAAA,EAAUJ,6CACNH,YAAAA,EACAD,MAAAA,CAAOM,SAAS,CAACE,QAAQ,IAAI,EAAE,CAAA;AAEnCC,gBAAAA,OAAAA,EAASL,6CACLH,YAAAA,EACAD,MAAAA,CAAOM,SAAS,CAACG,OAAO,IAAI,EAAE;AAEtC,aAAA;AACJ,QAAA;AACJ,IAAA;uBAGA,IAAStC;uBAGT,MAASS;uBAGT,SAASR;uBAGT,OAASC;uBAGT,YAASC;uBAGT,OAASC;uBAGT,aAASC;uBAGT,iBAASC;uBAGT,iBAASC;uBAGT,mBAASC;AAET;;;;;AAKC,QACD,SAAS2B;AAET;;AAEC,QACD,IAAII,OAAAA,GAAmB;QACnB,IAAI,IAAI,CAACvC,IAAI,EAAE;AACX,YAAA,IAAIwC,MAAMC,OAAO,CAAC,IAAI,CAACzC,IAAI,CAAA,EAAG;AAC1B,gBAAA,OAAO,IAAI,CAACA,IAAI,CAAC0C,MAAM,GAAG,CAAA;AAC9B,YAAA;YACA,OAAO,IAAA;AACX,QAAA;QACA,OAAO,KAAA;AACX,IAAA;AACJ;;"}

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

@@ -0,0 +1,24 @@
+import { ValidationResult } from '../validation/ValidationResult.js';
+import { IQueryResult } from './IQueryResult.js';
+import { PagingInfo } from './PagingInfo.js';
+import { ChangeSet } from './ChangeSet.js';
+export declare class QueryResultWithState<TDataType> implements IQueryResult<TDataType> {
+    readonly data: TDataType;
+    readonly paging: PagingInfo;
+    readonly isSuccess: boolean;
+    readonly isAuthorized: boolean;
+    readonly isValid: boolean;
+    readonly validationResults: ValidationResult[];
+    readonly hasExceptions: boolean;
+    readonly exceptionMessages: string[];
+    readonly exceptionStackTrace: string;
+    readonly isPerforming: boolean;
+    readonly changeSet?: ChangeSet<unknown> | undefined;
+    readonly isReady: boolean;
+    static empty<TDataType>(defaultValue: TDataType): QueryResultWithState<TDataType>;
+    static initial<TDataType>(defaultValue: TDataType): QueryResultWithState<TDataType>;
+    constructor(data: TDataType, paging: PagingInfo, isSuccess: boolean, isAuthorized: boolean, isValid: boolean, validationResults: ValidationResult[], hasExceptions: boolean, exceptionMessages: string[], exceptionStackTrace: string, isPerforming: boolean, changeSet?: ChangeSet<unknown> | undefined, isReady?: boolean);
+    get hasData(): boolean;
+    static fromQueryResult<TDataType>(queryResult: IQueryResult<TDataType>, isPerforming: boolean): QueryResultWithState<TDataType>;
+}
+//# sourceMappingURL=QueryResultWithState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryResultWithState.d.ts","sourceRoot":"","sources":["../../../queries/QueryResultWithState.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK3C,qBAAa,oBAAoB,CAAC,SAAS,CAAE,YAAW,YAAY,CAAC,SAAS,CAAC;IA+DvE,QAAQ,CAAC,IAAI,EAAE,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO;IACzB,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,EAAE;IAC9C,QAAQ,CAAC,aAAa,EAAE,OAAO;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM;IACpC,QAAQ,CAAC,YAAY,EAAE,OAAO;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO;IApE7B,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAehF;IAQD,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAelF;IAkBD,YACa,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,OAAO,EAChB,iBAAiB,EAAE,gBAAgB,EAAE,EACrC,aAAa,EAAE,OAAO,EACtB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,mBAAmB,EAAE,MAAM,EAC3B,YAAY,EAAE,OAAO,EACrB,SAAS,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,YAAA,EAC9B,OAAO,GAAE,OAAc,EAChC;IAGJ,IAAI,OAAO,IAAI,OAAO,CAKrB;IAQD,MAAM,CAAC,eAAe,CAAC,SAAS,EAC5B,WAAW,EAAE,YAAY,CAAC,SAAS,CAAC,EACpC,YAAY,EAAE,OAAO,mCAgBxB;CACJ"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryResultWithState.js","sources":["../../../queries/QueryResultWithState.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ValidationResult } from '../validation/ValidationResult';\nimport { IQueryResult } from './IQueryResult';\nimport { PagingInfo } from './PagingInfo';\nimport { ChangeSet } from './ChangeSet';\n\n/**\n * Represents a specialized {@link QueryResult<TDataType>} that holds state for its execution\n */\nexport class QueryResultWithState<TDataType> implements IQueryResult<TDataType> {\n    /**\n     * Creates a settled empty state, such as the state returned by a disabled query.\n     * @param defaultValue The query's empty data value.\n     * @returns A ready state that is not performing.\n     */\n    static empty<TDataType>(defaultValue: TDataType): QueryResultWithState<TDataType> {\n        return new QueryResultWithState(\n            defaultValue,\n            PagingInfo.noPaging,\n            true,\n            true,\n            true,\n            [],\n            false,\n            [],\n            '',\n            false,\n            undefined,\n            true,\n        );\n    }\n\n    /**\n     * Creates the local initial state before any server result has been received. This state is not ready because\n     * no result exists yet; its performing state independently describes the active client request.\n     * @param defaultValue The query's initial data value.\n     * @returns A not-ready state that is performing.\n     */\n    static initial<TDataType>(defaultValue: TDataType): QueryResultWithState<TDataType> {\n        return new QueryResultWithState(\n            defaultValue,\n            PagingInfo.noPaging,\n            true,\n            true,\n            true,\n            [],\n            false,\n            [],\n            '',\n            true,\n            undefined,\n            false,\n        );\n    }\n\n    /**\n     * Initializes an instance of {@link QueryResultWithState<TDataType>}.\n     * @param {TDataType} data The items returned, if any - can be empty.\n     * @param {PagingInfo} paging The paging info.\n     * @param {boolean} isSuccess Whether or not the query was successful.\n     * @param {boolean} isAuthorized Whether or not the query was authorized.\n     * @param {boolean} isValid Whether or not it is valid.\n     * @param {ValidationResult[]} validationResults Any validation errors.\n     * @param {boolean} hasExceptions Whether or not it has exceptions.\n     * @param {string[]} exceptionMessages Any exception messages.\n     * @param {string} exceptionStackTrace Exception stack trace, if any.\n     * @param {boolean} isPerforming Whether or not the query is being performed. True if its performing, false if it is done.\n     * @param {ChangeSet<unknown> | undefined} changeSet Optional change set from the server describing the delta since the last update.\n     * @param {boolean} isReady Whether the query has produced a result. Defaults to true so existing constructor calls\n     * represent settled synthetic states; {@link initial} explicitly uses false because no server result exists yet.\n     */\n    constructor(\n        readonly data: TDataType,\n        readonly paging: PagingInfo,\n        readonly isSuccess: boolean,\n        readonly isAuthorized: boolean,\n        readonly isValid: boolean,\n        readonly validationResults: ValidationResult[],\n        readonly hasExceptions: boolean,\n        readonly exceptionMessages: string[],\n        readonly exceptionStackTrace: string,\n        readonly isPerforming: boolean,\n        readonly changeSet?: ChangeSet<unknown>,\n        readonly isReady: boolean = true,\n    ) {}\n\n    /** @inheritdoc */\n    get hasData(): boolean {\n        if (Array.isArray(this.data)) {\n            return this.data.length > 0;\n        }\n        return !!this.data;\n    }\n\n    /**\n     * Create a new {@link QueryResultWithState<TDataType>} from an {@link IQueryResult<TDataType>}.\n     * @param queryResult The original query result.\n     * @param isPerforming Whether or not the query is performing.\n     * @returns A new {@link QueryResultWithState<TDataType>}\n     */\n    static fromQueryResult<TDataType>(\n        queryResult: IQueryResult<TDataType>,\n        isPerforming: boolean,\n    ) {\n        return new QueryResultWithState<TDataType>(\n            queryResult.data,\n            queryResult.paging,\n            queryResult.isSuccess,\n            queryResult.isAuthorized,\n            queryResult.isValid,\n            queryResult.validationResults,\n            queryResult.hasExceptions,\n            queryResult.exceptionMessages,\n            queryResult.exceptionStackTrace,\n            isPerforming,\n            queryResult.changeSet,\n            queryResult.isReady ?? true,\n        );\n    }\n}\n"],"names":["QueryResultWithState","empty","defaultValue","PagingInfo","noPaging","undefined","initial","paging","isSuccess","hasExceptions","exceptionMessages","isReady","data","isAuthorized","isValid","validationResults","exceptionStackTrace","isPerforming","changeSet","hasData","Array","isArray","length","fromQueryResult","queryResult"],"mappings":";;;;AAAA;AACA;AAOA;;AAEC,IACM,MAAMA,oBAAAA,CAAAA;;;;;;;;;;;;;AACT;;;;QAKA,OAAOC,KAAAA,CAAiBC,YAAuB,EAAmC;AAC9E,QAAA,OAAO,IAAIF,oBAAAA,CACPE,YAAAA,EACAC,qBAAAA,CAAWC,QAAQ,EACnB,IAAA,EACA,IAAA,EACA,IAAA,EACA,EAAE,EACF,KAAA,EACA,EAAE,EACF,EAAA,EACA,OACAC,SAAAA,EACA,IAAA,CAAA;AAER,IAAA;AAEA;;;;;QAMA,OAAOC,OAAAA,CAAmBJ,YAAuB,EAAmC;AAChF,QAAA,OAAO,IAAIF,oBAAAA,CACPE,YAAAA,EACAC,qBAAAA,CAAWC,QAAQ,EACnB,IAAA,EACA,IAAA,EACA,IAAA,EACA,EAAE,EACF,KAAA,EACA,EAAE,EACF,EAAA,EACA,MACAC,SAAAA,EACA,KAAA,CAAA;AAER,IAAA;AAEA;;;;;;;;;;;;;;;AAeC,QACD,YACI,IAAwB,EACfE,MAAkB,EAClBC,SAAkB,EAC3B,YAA8B,EAC9B,OAAyB,EACzB,iBAA8C,EACrCC,aAAsB,EACtBC,iBAA2B,EACpC,mBAAoC,EACpC,YAA8B,EAC9B,SAAuC,EACvC,OAASC,GAAmB,IAAI,CAClC;aAZWC,IAAAA,GAAAA,IAAAA;aACAL,MAAAA,GAAAA,MAAAA;aACAC,SAAAA,GAAAA,SAAAA;aACAK,YAAAA,GAAAA,YAAAA;aACAC,OAAAA,GAAAA,OAAAA;aACAC,iBAAAA,GAAAA,iBAAAA;aACAN,aAAAA,GAAAA,aAAAA;aACAC,iBAAAA,GAAAA,iBAAAA;aACAM,mBAAAA,GAAAA,mBAAAA;aACAC,YAAAA,GAAAA,YAAAA;aACAC,SAAAA,GAAAA,SAAAA;aACAP,OAAAA,GAAAA,OAAAA;AACV,IAAA;uBAGH,IAAIQ,OAAAA,GAAmB;AACnB,QAAA,IAAIC,MAAMC,OAAO,CAAC,IAAI,CAACT,IAAI,CAAA,EAAG;AAC1B,YAAA,OAAO,IAAI,CAACA,IAAI,CAACU,MAAM,GAAG,CAAA;AAC9B,QAAA;AACA,QAAA,OAAO,CAAC,CAAC,IAAI,CAACV,IAAI;AACtB,IAAA;AAEA;;;;;AAKC,QACD,OAAOW,eAAAA,CACHC,WAAoC,EACpCP,YAAqB,EACvB;AACE,QAAA,OAAO,IAAIjB,oBAAAA,CACPwB,WAAAA,CAAYZ,IAAI,EAChBY,WAAAA,CAAYjB,MAAM,EAClBiB,WAAAA,CAAYhB,SAAS,EACrBgB,WAAAA,CAAYX,YAAY,EACxBW,YAAYV,OAAO,EACnBU,WAAAA,CAAYT,iBAAiB,EAC7BS,WAAAA,CAAYf,aAAa,EACzBe,WAAAA,CAAYd,iBAAiB,EAC7Bc,WAAAA,CAAYR,mBAAmB,EAC/BC,cACAO,WAAAA,CAAYN,SAAS,EACrBM,WAAAA,CAAYb,OAAO,IAAI,IAAA,CAAA;AAE/B,IAAA;AACJ;;"}
+{"version":3,"file":"QueryResultWithState.js","sources":["../../../queries/QueryResultWithState.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ValidationResult } from '../validation/ValidationResult.js';\nimport { IQueryResult } from './IQueryResult.js';\nimport { PagingInfo } from './PagingInfo.js';\nimport { ChangeSet } from './ChangeSet.js';\n\n/**\n * Represents a specialized {@link QueryResult<TDataType>} that holds state for its execution\n */\nexport class QueryResultWithState<TDataType> implements IQueryResult<TDataType> {\n    /**\n     * Creates a settled empty state, such as the state returned by a disabled query.\n     * @param defaultValue The query's empty data value.\n     * @returns A ready state that is not performing.\n     */\n    static empty<TDataType>(defaultValue: TDataType): QueryResultWithState<TDataType> {\n        return new QueryResultWithState(\n            defaultValue,\n            PagingInfo.noPaging,\n            true,\n            true,\n            true,\n            [],\n            false,\n            [],\n            '',\n            false,\n            undefined,\n            true,\n        );\n    }\n\n    /**\n     * Creates the local initial state before any server result has been received. This state is not ready because\n     * no result exists yet; its performing state independently describes the active client request.\n     * @param defaultValue The query's initial data value.\n     * @returns A not-ready state that is performing.\n     */\n    static initial<TDataType>(defaultValue: TDataType): QueryResultWithState<TDataType> {\n        return new QueryResultWithState(\n            defaultValue,\n            PagingInfo.noPaging,\n            true,\n            true,\n            true,\n            [],\n            false,\n            [],\n            '',\n            true,\n            undefined,\n            false,\n        );\n    }\n\n    /**\n     * Initializes an instance of {@link QueryResultWithState<TDataType>}.\n     * @param {TDataType} data The items returned, if any - can be empty.\n     * @param {PagingInfo} paging The paging info.\n     * @param {boolean} isSuccess Whether or not the query was successful.\n     * @param {boolean} isAuthorized Whether or not the query was authorized.\n     * @param {boolean} isValid Whether or not it is valid.\n     * @param {ValidationResult[]} validationResults Any validation errors.\n     * @param {boolean} hasExceptions Whether or not it has exceptions.\n     * @param {string[]} exceptionMessages Any exception messages.\n     * @param {string} exceptionStackTrace Exception stack trace, if any.\n     * @param {boolean} isPerforming Whether or not the query is being performed. True if its performing, false if it is done.\n     * @param {ChangeSet<unknown> | undefined} changeSet Optional change set from the server describing the delta since the last update.\n     * @param {boolean} isReady Whether the query has produced a result. Defaults to true so existing constructor calls\n     * represent settled synthetic states; {@link initial} explicitly uses false because no server result exists yet.\n     */\n    constructor(\n        readonly data: TDataType,\n        readonly paging: PagingInfo,\n        readonly isSuccess: boolean,\n        readonly isAuthorized: boolean,\n        readonly isValid: boolean,\n        readonly validationResults: ValidationResult[],\n        readonly hasExceptions: boolean,\n        readonly exceptionMessages: string[],\n        readonly exceptionStackTrace: string,\n        readonly isPerforming: boolean,\n        readonly changeSet?: ChangeSet<unknown>,\n        readonly isReady: boolean = true,\n    ) {}\n\n    /** @inheritdoc */\n    get hasData(): boolean {\n        if (Array.isArray(this.data)) {\n            return this.data.length > 0;\n        }\n        return !!this.data;\n    }\n\n    /**\n     * Create a new {@link QueryResultWithState<TDataType>} from an {@link IQueryResult<TDataType>}.\n     * @param queryResult The original query result.\n     * @param isPerforming Whether or not the query is performing.\n     * @returns A new {@link QueryResultWithState<TDataType>}\n     */\n    static fromQueryResult<TDataType>(\n        queryResult: IQueryResult<TDataType>,\n        isPerforming: boolean,\n    ) {\n        return new QueryResultWithState<TDataType>(\n            queryResult.data,\n            queryResult.paging,\n            queryResult.isSuccess,\n            queryResult.isAuthorized,\n            queryResult.isValid,\n            queryResult.validationResults,\n            queryResult.hasExceptions,\n            queryResult.exceptionMessages,\n            queryResult.exceptionStackTrace,\n            isPerforming,\n            queryResult.changeSet,\n            queryResult.isReady ?? true,\n        );\n    }\n}\n"],"names":["QueryResultWithState","empty","defaultValue","PagingInfo","noPaging","undefined","initial","paging","isSuccess","hasExceptions","exceptionMessages","isReady","data","isAuthorized","isValid","validationResults","exceptionStackTrace","isPerforming","changeSet","hasData","Array","isArray","length","fromQueryResult","queryResult"],"mappings":";;;;AAAA;AACA;AAOA;;AAEC,IACM,MAAMA,oBAAAA,CAAAA;;;;;;;;;;;;;AACT;;;;QAKA,OAAOC,KAAAA,CAAiBC,YAAuB,EAAmC;AAC9E,QAAA,OAAO,IAAIF,oBAAAA,CACPE,YAAAA,EACAC,qBAAAA,CAAWC,QAAQ,EACnB,IAAA,EACA,IAAA,EACA,IAAA,EACA,EAAE,EACF,KAAA,EACA,EAAE,EACF,EAAA,EACA,OACAC,SAAAA,EACA,IAAA,CAAA;AAER,IAAA;AAEA;;;;;QAMA,OAAOC,OAAAA,CAAmBJ,YAAuB,EAAmC;AAChF,QAAA,OAAO,IAAIF,oBAAAA,CACPE,YAAAA,EACAC,qBAAAA,CAAWC,QAAQ,EACnB,IAAA,EACA,IAAA,EACA,IAAA,EACA,EAAE,EACF,KAAA,EACA,EAAE,EACF,EAAA,EACA,MACAC,SAAAA,EACA,KAAA,CAAA;AAER,IAAA;AAEA;;;;;;;;;;;;;;;AAeC,QACD,YACI,IAAwB,EACfE,MAAkB,EAClBC,SAAkB,EAC3B,YAA8B,EAC9B,OAAyB,EACzB,iBAA8C,EACrCC,aAAsB,EACtBC,iBAA2B,EACpC,mBAAoC,EACpC,YAA8B,EAC9B,SAAuC,EACvC,OAASC,GAAmB,IAAI,CAClC;aAZWC,IAAAA,GAAAA,IAAAA;aACAL,MAAAA,GAAAA,MAAAA;aACAC,SAAAA,GAAAA,SAAAA;aACAK,YAAAA,GAAAA,YAAAA;aACAC,OAAAA,GAAAA,OAAAA;aACAC,iBAAAA,GAAAA,iBAAAA;aACAN,aAAAA,GAAAA,aAAAA;aACAC,iBAAAA,GAAAA,iBAAAA;aACAM,mBAAAA,GAAAA,mBAAAA;aACAC,YAAAA,GAAAA,YAAAA;aACAC,SAAAA,GAAAA,SAAAA;aACAP,OAAAA,GAAAA,OAAAA;AACV,IAAA;uBAGH,IAAIQ,OAAAA,GAAmB;AACnB,QAAA,IAAIC,MAAMC,OAAO,CAAC,IAAI,CAACT,IAAI,CAAA,EAAG;AAC1B,YAAA,OAAO,IAAI,CAACA,IAAI,CAACU,MAAM,GAAG,CAAA;AAC9B,QAAA;AACA,QAAA,OAAO,CAAC,CAAC,IAAI,CAACV,IAAI;AACtB,IAAA;AAEA;;;;;AAKC,QACD,OAAOW,eAAAA,CACHC,WAAoC,EACpCP,YAAqB,EACvB;AACE,QAAA,OAAO,IAAIjB,oBAAAA,CACPwB,WAAAA,CAAYZ,IAAI,EAChBY,WAAAA,CAAYjB,MAAM,EAClBiB,WAAAA,CAAYhB,SAAS,EACrBgB,WAAAA,CAAYX,YAAY,EACxBW,YAAYV,OAAO,EACnBU,WAAAA,CAAYT,iBAAiB,EAC7BS,WAAAA,CAAYf,aAAa,EACzBe,WAAAA,CAAYd,iBAAiB,EAC7Bc,WAAAA,CAAYR,mBAAmB,EAC/BC,cACAO,WAAAA,CAAYN,SAAS,EACrBM,WAAAA,CAAYb,OAAO,IAAI,IAAA,CAAA;AAE/B,IAAA;AACJ;;"}

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

@@ -0,0 +1,5 @@
+export declare enum QueryTransportMethod {
+    WebSocket = "webSocket",
+    ServerSentEvents = "serverSentEvents"
+}
+//# sourceMappingURL=QueryTransportMethod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryTransportMethod.d.ts","sourceRoot":"","sources":["../../../queries/QueryTransportMethod.ts"],"names":[],"mappings":"AAMA,oBAAY,oBAAoB;IAI5B,SAAS,cAAc;IAKvB,gBAAgB,qBAAqB;CACxC"}

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

@@ -0,0 +1,6 @@
+import { Validator } from '../validation/Validator.js';
+import { ValidationResult } from '../validation/ValidationResult.js';
+export declare abstract class QueryValidator<T = object> extends Validator<T> {
+    validate(query: T): ValidationResult[];
+}
+//# sourceMappingURL=QueryValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryValidator.d.ts","sourceRoot":"","sources":["../../../queries/QueryValidator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAKrE,8BAAsB,cAAc,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAMjE,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,gBAAgB,EAAE,CAErC;CACJ"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryValidator.js","sources":["../../../queries/QueryValidator.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Validator } from '../validation/Validator';\nimport { ValidationResult } from '../validation/ValidationResult';\n\n/**\n * Represents the query validator\n */\nexport abstract class QueryValidator<T = object> extends Validator<T> {\n    /**\n     * Validate the query parameters.\n     * @param query The query to validate.\n     * @returns An array of validation results, empty if valid.\n     */\n    validate(query: T): ValidationResult[] {\n        return super.validate(query);\n    }\n}\n"],"names":["QueryValidator","Validator","validate","query"],"mappings":";;;;AAAA;AACA;AAKA;;IAGO,MAAeA,cAAAA,SAAmCC,mBAAAA,CAAAA;AACrD;;;;QAKAC,QAAAA,CAASC,KAAQ,EAAsB;QACnC,OAAO,KAAK,CAACD,QAAAA,CAASC,KAAAA,CAAAA;AAC1B,IAAA;AACJ;;"}
+{"version":3,"file":"QueryValidator.js","sources":["../../../queries/QueryValidator.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Validator } from '../validation/Validator.js';\nimport { ValidationResult } from '../validation/ValidationResult.js';\n\n/**\n * Represents the query validator\n */\nexport abstract class QueryValidator<T = object> extends Validator<T> {\n    /**\n     * Validate the query parameters.\n     * @param query The query to validate.\n     * @returns An array of validation results, empty if valid.\n     */\n    validate(query: T): ValidationResult[] {\n        return super.validate(query);\n    }\n}\n"],"names":["QueryValidator","Validator","validate","query"],"mappings":";;;;AAAA;AACA;AAKA;;IAGO,MAAeA,cAAAA,SAAmCC,mBAAAA,CAAAA;AACrD;;;;QAKAC,QAAAA,CAASC,KAAQ,EAAsB;QACnC,OAAO,KAAK,CAACD,QAAAA,CAASC,KAAAA,CAAAA;AAC1B,IAAA;AACJ;;"}

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

@@ -0,0 +1,15 @@
+import { IReconnectPolicy, ReconnectCallback } from './IReconnectPolicy.js';
+export declare class ReconnectPolicy implements IReconnectPolicy {
+    private readonly _maxAttempts;
+    private readonly _initialDelayMs;
+    private readonly _delayStepMs;
+    private readonly _maxDelayMs;
+    private _attempt;
+    private _timer?;
+    constructor(_maxAttempts?: number, _initialDelayMs?: number, _delayStepMs?: number, _maxDelayMs?: number);
+    get attempt(): number;
+    schedule(onReconnect: ReconnectCallback, label: string): boolean;
+    reset(): void;
+    cancel(): void;
+}
+//# sourceMappingURL=ReconnectPolicy.d.ts.map