@cratis/arc 20.59.1 → 20.60.1

package/dist/cjs/queries/NullObservableQueryConnection.js

@@ -8,11 +8,16 @@ var QueryResult = require('./QueryResult.js');
  * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.
  */ class NullObservableQueryConnection {
     defaultValue;
+    result;
     /**
      * Initializes a new instance of the {@link NullObservableQueryConnection} class.
      * @param {TDataType} defaultValue The default value to serve.
-     */ constructor(defaultValue){
+     * @param {QueryResult<TDataType>} result Optional result to serve instead of an empty one. Supply it when the
+     * subscription failed for a reason the subscriber must be able to see — client-side validation in particular,
+     * which would otherwise be indistinguishable from a query that simply has no data yet.
+     */ constructor(defaultValue, result){
         this.defaultValue = defaultValue;
+        this.result = result;
     }
     /** @inheritdoc */ get lastPingLatency() {
         return 0;
@@ -21,7 +26,7 @@ var QueryResult = require('./QueryResult.js');
         return 0;
     }
     /** @inheritdoc */ connect(dataReceived) {
-        dataReceived(QueryResult.QueryResult.empty(this.defaultValue));
+        dataReceived(this.result ?? QueryResult.QueryResult.empty(this.defaultValue));
     }
     /** @inheritdoc */ /* eslint-disable @typescript-eslint/no-empty-function */ disconnect() {}
 }

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

@@ -1 +1 @@
-{"version":3,"file":"NullObservableQueryConnection.js","sources":["../../../queries/NullObservableQueryConnection.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 { DataReceived } from './ObservableQueryConnection';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { QueryResult } from './QueryResult';\n\n/**\n * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.\n */\n\nexport class NullObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    /**\n     * Initializes a new instance of the {@link NullObservableQueryConnection} class.\n     * @param {TDataType} defaultValue The default value to serve.\n     */\n    constructor(readonly defaultValue: TDataType) {\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>) {\n        dataReceived(QueryResult.empty(this.defaultValue));\n    }\n\n    /** @inheritdoc */\n    /* eslint-disable @typescript-eslint/no-empty-function */\n    disconnect() {\n    }\n}\n"],"names":["NullObservableQueryConnection","defaultValue","lastPingLatency","averageLatency","connect","dataReceived","QueryResult","empty","disconnect"],"mappings":";;;;AAAA;AACA;AAMA;;AAEC,IAEM,MAAMA,6BAAAA,CAAAA;;AACT;;;QAIA,WAAA,CAAY,YAAgC,CAAE;aAAzBC,YAAAA,GAAAA,YAAAA;AACrB,IAAA;uBAGA,IAAIC,eAAAA,GAA0B;QAC1B,OAAO,CAAA;AACX,IAAA;uBAGA,IAAIC,cAAAA,GAAyB;QACzB,OAAO,CAAA;AACX,IAAA;uBAGAC,OAAAA,CAAQC,YAAqC,EAAE;AAC3CA,QAAAA,YAAAA,CAAaC,uBAAAA,CAAYC,KAAK,CAAC,IAAI,CAACN,YAAY,CAAA,CAAA;AACpD,IAAA;AAEA,iFAEAO,UAAAA,GAAa,CACb;AACJ;;;;"}
+{"version":3,"file":"NullObservableQueryConnection.js","sources":["../../../queries/NullObservableQueryConnection.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 { DataReceived } from './ObservableQueryConnection';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { QueryResult } from './QueryResult';\n\n/**\n * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.\n */\n\nexport class NullObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    /**\n     * Initializes a new instance of the {@link NullObservableQueryConnection} class.\n     * @param {TDataType} defaultValue The default value to serve.\n     * @param {QueryResult<TDataType>} result Optional result to serve instead of an empty one. Supply it when the\n     * subscription failed for a reason the subscriber must be able to see — client-side validation in particular,\n     * which would otherwise be indistinguishable from a query that simply has no data yet.\n     */\n    constructor(readonly defaultValue: TDataType, readonly result?: QueryResult<TDataType>) {\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>) {\n        dataReceived(this.result ?? QueryResult.empty(this.defaultValue));\n    }\n\n    /** @inheritdoc */\n    /* eslint-disable @typescript-eslint/no-empty-function */\n    disconnect() {\n    }\n}\n"],"names":["NullObservableQueryConnection","result","defaultValue","lastPingLatency","averageLatency","connect","dataReceived","QueryResult","empty","disconnect"],"mappings":";;;;AAAA;AACA;AAMA;;AAEC,IAEM,MAAMA,6BAAAA,CAAAA;;;AACT;;;;;;AAMC,QACD,YAAY,YAAgC,EAAWC,MAA+B,CAAE;aAAnEC,YAAAA,GAAAA,YAAAA;aAAkCD,MAAAA,GAAAA,MAAAA;AACvD,IAAA;uBAGA,IAAIE,eAAAA,GAA0B;QAC1B,OAAO,CAAA;AACX,IAAA;uBAGA,IAAIC,cAAAA,GAAyB;QACzB,OAAO,CAAA;AACX,IAAA;uBAGAC,OAAAA,CAAQC,YAAqC,EAAE;QAC3CA,YAAAA,CAAa,IAAI,CAACL,MAAM,IAAIM,wBAAYC,KAAK,CAAC,IAAI,CAACN,YAAY,CAAA,CAAA;AACnE,IAAA;AAEA,iFAEAO,UAAAA,GAAa,CACb;AACJ;;;;"}

package/dist/cjs/queries/ObservableQueryFor.js

@@ -29,6 +29,7 @@ var QueryHttpRequest = require('./QueryHttpRequest.js');
     _httpHeadersCallback;
     _httpMethod;
     roles = [];
+    validation;
     /** Backend fully-qualified query name used when subscribing via the SSE hub. Overridden in generated proxies. */ queryName;
     sorting;
     paging;
@@ -70,7 +71,12 @@ var QueryHttpRequest = require('./QueryHttpRequest.js');
         if (this._connection) {
             this._connection.disconnect();
         }
-        if (!this.validateArguments(args)) {
+        const clientValidationErrors = this.validation?.validate(args || {}) || [];
+        if (clientValidationErrors.length > 0) {
+            // Serve the failure through the connection rather than throwing, so a subscriber sees an invalid result
+            // on its normal callback path instead of the empty result an unestablished connection would emit.
+            this._connection = new NullObservableQueryConnection.NullObservableQueryConnection(this.defaultValue, QueryResult.QueryResult.validationFailed(clientValidationErrors, this));
+        } else if (!this.validateArguments(args)) {
             this._connection = new NullObservableQueryConnection.NullObservableQueryConnection(this.defaultValue);
         } else {
             this._connection = ObservableQueryConnectionFactory.createObservableQueryConnection({
@@ -116,6 +122,10 @@ var QueryHttpRequest = require('./QueryHttpRequest.js');
                 data: this.defaultValue
             }
         };
+        const clientValidationErrors = this.validation?.validate(args || {}) || [];
+        if (clientValidationErrors.length > 0) {
+            return QueryResult.QueryResult.validationFailed(clientValidationErrors, this);
+        }
         if (!this.validateArguments(args)) {
             return new Promise((resolve)=>{
                 resolve(noSuccess);

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryFor.js","sources":["../../../queries/ObservableQueryFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IObservableQueryFor, OnNextResult } from './IObservableQueryFor';\nimport { ObservableQuerySubscription } from './ObservableQuerySubscription';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { NullObservableQueryConnection } from './NullObservableQueryConnection';\nimport { createObservableQueryConnection } from './ObservableQueryConnectionFactory';\nimport { Constructor } from '@cratis/fundamentals';\nimport { JsonSerializer } from '@cratis/fundamentals';\nimport { QueryResult } from './QueryResult';\nimport { Sorting } from './Sorting';\nimport { Paging } from './Paging';\nimport { SortDirection } from './SortDirection';\nimport { Globals } from '../Globals';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\nimport { QueryHttpMethod } from './QueryHttpMethod';\nimport { executeQueryHttpRequest } from './QueryHttpRequest';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class ObservableQueryFor<TDataType, TParameters = object> implements IObservableQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _connection?: IObservableQueryConnection<TDataType>;\n    private _httpHeadersCallback: GetHttpHeaders;\n    private _httpMethod?: QueryHttpMethod;\n\n    abstract readonly route: string;\n    abstract readonly defaultValue: TDataType;\n    readonly roles: string[] = [];\n    /** Backend fully-qualified query name used when subscribing via the SSE hub. Overridden in generated proxies. */\n    readonly queryName?: string;\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    sorting: Sorting;\n    paging: Paging;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /**\n     * Disposes the query.\n     */\n    dispose() {\n        this._connection?.disconnect();\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    setHttpMethod(method: QueryHttpMethod): void {\n        this._httpMethod = method;\n    }\n\n    /** @inheritdoc */\n    subscribe(callback: OnNextResult<QueryResult<TDataType>>, args?: TParameters): ObservableQuerySubscription<TDataType> {\n        if (this._connection) {\n            this._connection.disconnect();\n        }\n\n        if (!this.validateArguments(args)) {\n            this._connection = new NullObservableQueryConnection(this.defaultValue);\n        } else {\n            this._connection = createObservableQueryConnection({\n                route: this.route,\n                queryName: this.queryName ?? this.constructor.name,\n                origin: this._origin,\n                apiBasePath: this._apiBasePath,\n                microservice: this._microservice,\n                args: args as object,\n            });\n        }\n\n        // Descriptor-backed instance properties provide defaults; fresh args passed to subscribe()\n        // must take precedence over any stale instance property values. Spread parameterValues\n        // first so that the caller-supplied args can override them.\n        //\n        // In direct mode the route arguments are already embedded in the URL path, so only\n        // the unused (non-route) parameters are appended as additional query arguments.\n        // In multiplexed mode ALL arguments — including route-derived ones — must be included\n        // in the subscribe payload so the server can execute the query correctly.\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const { unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        const connectionQueryArguments: any = {\n            ...parameterValues,\n            ...(Globals.queryDirectMode ? unusedParameters : (args as object) || {}),\n            ...this.buildQueryArguments()\n        };\n\n        const subscriber = new ObservableQuerySubscription(this._connection);\n        this._connection.connect(data => {\n            const result: any = data;\n            try {\n                this.deserializeResult(result);\n                callback(result);\n            } catch (ex) {\n                console.log(ex);\n            }\n        }, connectionQueryArguments);\n        return subscriber;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        if (!this.validateArguments(args)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const headers = {\n            ...(this._httpHeadersCallback?.() || {}),\n            'Accept': 'application/json',\n            'Content-Type': 'application/json'\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await executeQueryHttpRequest(this._httpMethod, {\n            route: this.route,\n            apiBasePath: this._apiBasePath,\n            origin: this._origin,\n            args: (args as object) ?? {},\n            parameterValues,\n            paging: this.paging,\n            sorting: this.sorting,\n            headers\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n\n    private validateArguments(args?: TParameters): boolean {\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const combinedArgs = { ...(args as object || {}), ...parameterValues };\n        return ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, combinedArgs as object);\n    }\n\n    private buildQueryArguments(): any {\n        const queryArguments: any = {};\n\n        if (this.paging && this.paging.pageSize > 0) {\n            queryArguments.pageSize = this.paging.pageSize;\n            queryArguments.page = this.paging.page;\n        }\n\n        if (this.sorting.hasSorting) {\n            queryArguments.sortBy = this.sorting.field;\n            queryArguments.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        return queryArguments;\n    }\n\n    private deserializeResult(result: any): void {\n        if (this.enumerable) {\n            if (Array.isArray(result.data)) {\n                result.data = JsonSerializer.deserializeArrayFromInstance(this.modelType, result.data);\n            } else {\n                result.data = [];\n            }\n        } else if (result.data) {\n            result.data = JsonSerializer.deserializeFromInstance(this.modelType, result.data);\n        }\n    }\n}\n"],"names":["ObservableQueryFor","_microservice","_apiBasePath","_origin","_connection","_httpHeadersCallback","_httpMethod","roles","queryName","sorting","paging","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","dispose","disconnect","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","setHttpMethod","method","subscribe","args","validateArguments","NullObservableQueryConnection","defaultValue","createObservableQueryConnection","route","name","parameterValues","ParametersHelper","collectParameterValues","unusedParameters","UrlHelpers","replaceRouteParameters","connectionQueryArguments","queryDirectMode","buildQueryArguments","subscriber","ObservableQuerySubscription","connect","data","result","deserializeResult","ex","console","log","perform","noSuccess","QueryResult","Promise","resolve","headers","length","microserviceHttpHeader","response","executeQueryHttpRequest","json","combinedArgs","ValidateRequestArguments","requiredRequestParameters","queryArguments","pageSize","page","hasSorting","sortBy","field","sortDirection","direction","SortDirection","descending","Array","isArray","JsonSerializer","deserializeArrayFromInstance","deserializeFromInstance"],"mappings":"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"}
+{"version":3,"file":"ObservableQueryFor.js","sources":["../../../queries/ObservableQueryFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IObservableQueryFor, OnNextResult } from './IObservableQueryFor';\nimport { ObservableQuerySubscription } from './ObservableQuerySubscription';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { QueryValidator } from './QueryValidator';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { NullObservableQueryConnection } from './NullObservableQueryConnection';\nimport { createObservableQueryConnection } from './ObservableQueryConnectionFactory';\nimport { Constructor } from '@cratis/fundamentals';\nimport { JsonSerializer } from '@cratis/fundamentals';\nimport { QueryResult } from './QueryResult';\nimport { Sorting } from './Sorting';\nimport { Paging } from './Paging';\nimport { SortDirection } from './SortDirection';\nimport { Globals } from '../Globals';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\nimport { QueryHttpMethod } from './QueryHttpMethod';\nimport { executeQueryHttpRequest } from './QueryHttpRequest';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class ObservableQueryFor<TDataType, TParameters = object> implements IObservableQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _connection?: IObservableQueryConnection<TDataType>;\n    private _httpHeadersCallback: GetHttpHeaders;\n    private _httpMethod?: QueryHttpMethod;\n\n    abstract readonly route: string;\n    abstract readonly defaultValue: TDataType;\n    readonly roles: string[] = [];\n    readonly validation?: QueryValidator<any>;\n    /** Backend fully-qualified query name used when subscribing via the SSE hub. Overridden in generated proxies. */\n    readonly queryName?: string;\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    sorting: Sorting;\n    paging: Paging;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /**\n     * Disposes the query.\n     */\n    dispose() {\n        this._connection?.disconnect();\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    setHttpMethod(method: QueryHttpMethod): void {\n        this._httpMethod = method;\n    }\n\n    /** @inheritdoc */\n    subscribe(callback: OnNextResult<QueryResult<TDataType>>, args?: TParameters): ObservableQuerySubscription<TDataType> {\n        if (this._connection) {\n            this._connection.disconnect();\n        }\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            // Serve the failure through the connection rather than throwing, so a subscriber sees an invalid result\n            // on its normal callback path instead of the empty result an unestablished connection would emit.\n            this._connection = new NullObservableQueryConnection(\n                this.defaultValue,\n                QueryResult.validationFailed(clientValidationErrors, this));\n        } else if (!this.validateArguments(args)) {\n            this._connection = new NullObservableQueryConnection(this.defaultValue);\n        } else {\n            this._connection = createObservableQueryConnection({\n                route: this.route,\n                queryName: this.queryName ?? this.constructor.name,\n                origin: this._origin,\n                apiBasePath: this._apiBasePath,\n                microservice: this._microservice,\n                args: args as object,\n            });\n        }\n\n        // Descriptor-backed instance properties provide defaults; fresh args passed to subscribe()\n        // must take precedence over any stale instance property values. Spread parameterValues\n        // first so that the caller-supplied args can override them.\n        //\n        // In direct mode the route arguments are already embedded in the URL path, so only\n        // the unused (non-route) parameters are appended as additional query arguments.\n        // In multiplexed mode ALL arguments — including route-derived ones — must be included\n        // in the subscribe payload so the server can execute the query correctly.\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const { unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        const connectionQueryArguments: any = {\n            ...parameterValues,\n            ...(Globals.queryDirectMode ? unusedParameters : (args as object) || {}),\n            ...this.buildQueryArguments()\n        };\n\n        const subscriber = new ObservableQuerySubscription(this._connection);\n        this._connection.connect(data => {\n            const result: any = data;\n            try {\n                this.deserializeResult(result);\n                callback(result);\n            } catch (ex) {\n                console.log(ex);\n            }\n        }, connectionQueryArguments);\n        return subscriber;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return QueryResult.validationFailed(clientValidationErrors, this);\n        }\n\n        if (!this.validateArguments(args)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const headers = {\n            ...(this._httpHeadersCallback?.() || {}),\n            'Accept': 'application/json',\n            'Content-Type': 'application/json'\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await executeQueryHttpRequest(this._httpMethod, {\n            route: this.route,\n            apiBasePath: this._apiBasePath,\n            origin: this._origin,\n            args: (args as object) ?? {},\n            parameterValues,\n            paging: this.paging,\n            sorting: this.sorting,\n            headers\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n\n    private validateArguments(args?: TParameters): boolean {\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const combinedArgs = { ...(args as object || {}), ...parameterValues };\n        return ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, combinedArgs as object);\n    }\n\n    private buildQueryArguments(): any {\n        const queryArguments: any = {};\n\n        if (this.paging && this.paging.pageSize > 0) {\n            queryArguments.pageSize = this.paging.pageSize;\n            queryArguments.page = this.paging.page;\n        }\n\n        if (this.sorting.hasSorting) {\n            queryArguments.sortBy = this.sorting.field;\n            queryArguments.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        return queryArguments;\n    }\n\n    private deserializeResult(result: any): void {\n        if (this.enumerable) {\n            if (Array.isArray(result.data)) {\n                result.data = JsonSerializer.deserializeArrayFromInstance(this.modelType, result.data);\n            } else {\n                result.data = [];\n            }\n        } else if (result.data) {\n            result.data = JsonSerializer.deserializeFromInstance(this.modelType, result.data);\n        }\n    }\n}\n"],"names":["ObservableQueryFor","_microservice","_apiBasePath","_origin","_connection","_httpHeadersCallback","_httpMethod","roles","validation","queryName","sorting","paging","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","dispose","disconnect","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","setHttpMethod","method","subscribe","args","clientValidationErrors","validate","length","NullObservableQueryConnection","defaultValue","QueryResult","validationFailed","validateArguments","createObservableQueryConnection","route","name","parameterValues","ParametersHelper","collectParameterValues","unusedParameters","UrlHelpers","replaceRouteParameters","connectionQueryArguments","queryDirectMode","buildQueryArguments","subscriber","ObservableQuerySubscription","connect","data","result","deserializeResult","ex","console","log","perform","noSuccess","Promise","resolve","headers","microserviceHttpHeader","response","executeQueryHttpRequest","json","combinedArgs","ValidateRequestArguments","requiredRequestParameters","queryArguments","pageSize","page","hasSorting","sortBy","field","sortDirection","direction","SortDirection","descending","Array","isArray","JsonSerializer","deserializeArrayFromInstance","deserializeFromInstance"],"mappings":"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"}

package/dist/cjs/queries/QueryFor.js

@@ -67,27 +67,7 @@ var QueryHttpRequest = require('./QueryHttpRequest.js');
         args = args || this.parameters;
         const clientValidationErrors = this.validation?.validate(args || {}) || [];
         if (clientValidationErrors.length > 0) {
-            return new QueryResult.QueryResult({
-                data: this.defaultValue,
-                isSuccess: false,
-                isAuthorized: true,
-                isValid: false,
-                hasExceptions: false,
-                validationResults: clientValidationErrors.map((_)=>({
-                        severity: _.severity,
-                        message: _.message,
-                        members: _.members,
-                        state: _.state
-                    })),
-                exceptionMessages: [],
-                exceptionStackTrace: '',
-                paging: {
-                    totalItems: 0,
-                    totalPages: 0,
-                    page: 0,
-                    size: 0
-                }
-            }, this.modelType, this.enumerable);
+            return QueryResult.QueryResult.validationFailed(clientValidationErrors, this);
         }
         if (!ValidateRequestArguments.ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, args)) {
             return new Promise((resolve)=>{

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

@@ -1 +1 @@
-{"version":3,"file":"QueryFor.js","sources":["../../../queries/QueryFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IQueryFor } from './IQueryFor';\nimport { QueryResult } from \"./QueryResult\";\nimport { QueryValidator } from './QueryValidator';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { Constructor } from '@cratis/fundamentals';\nimport { Paging } from './Paging';\nimport { Globals } from '../Globals';\nimport { Sorting } from './Sorting';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\nimport { QueryHttpMethod } from './QueryHttpMethod';\nimport { executeQueryHttpRequest } from './QueryHttpRequest';\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class QueryFor<TDataType, TParameters = object> implements IQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _httpHeadersCallback: GetHttpHeaders;\n    private _httpMethod?: QueryHttpMethod;\n    abstract readonly route: string;\n    /** Backend fully-qualified query name used as cache key. Overridden in generated proxies. */\n    readonly queryName?: string;\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    readonly validation?: QueryValidator<any>;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    readonly roles: string[] = [];\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    abstract defaultValue: TDataType;\n    abortController?: AbortController;\n    sorting: Sorting;\n    paging: Paging;\n    parameters: TParameters | undefined;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    setHttpMethod(method: QueryHttpMethod): void {\n        this._httpMethod = method;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        args = args || this.parameters;\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return new QueryResult({\n                data: this.defaultValue as object,\n                isSuccess: false,\n                isAuthorized: true,\n                isValid: false,\n                hasExceptions: false,\n                validationResults: clientValidationErrors.map(_ => ({\n                    severity: _.severity,\n                    message: _.message,\n                    members: _.members,\n                    state: _.state\n                })),\n                exceptionMessages: [],\n                exceptionStackTrace: '',\n                paging: {\n                    totalItems: 0,\n                    totalPages: 0,\n                    page: 0,\n                    size: 0\n                }\n            }, this.modelType, this.enumerable) as QueryResult<TDataType>;\n        }\n\n        if (!ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, args as object)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        if (this.abortController) {\n            this.abortController.abort();\n        }\n\n        this.abortController = new AbortController();\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const headers = {\n            ... this._httpHeadersCallback?.(), ...\n            {\n                'Accept': 'application/json',\n                'Content-Type': 'application/json'\n            }\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await executeQueryHttpRequest(this._httpMethod, {\n            route: this.route,\n            apiBasePath: this._apiBasePath,\n            origin: this._origin,\n            args: (args as object) ?? {},\n            parameterValues,\n            paging: this.paging,\n            sorting: this.sorting,\n            headers,\n            signal: this.abortController.signal\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n}\n"],"names":["QueryFor","_microservice","_apiBasePath","_origin","_httpHeadersCallback","_httpMethod","queryName","validation","roles","abortController","sorting","paging","parameters","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","setHttpMethod","method","perform","args","noSuccess","QueryResult","data","defaultValue","clientValidationErrors","validate","length","isSuccess","isAuthorized","isValid","hasExceptions","validationResults","map","_","severity","message","members","state","exceptionMessages","exceptionStackTrace","totalItems","totalPages","page","size","ValidateRequestArguments","name","requiredRequestParameters","Promise","resolve","abort","AbortController","parameterValues","ParametersHelper","collectParameterValues","headers","microserviceHttpHeader","response","executeQueryHttpRequest","route","signal","result","json"],"mappings":"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"}
+{"version":3,"file":"QueryFor.js","sources":["../../../queries/QueryFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IQueryFor } from './IQueryFor';\nimport { QueryResult } from \"./QueryResult\";\nimport { QueryValidator } from './QueryValidator';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { Constructor } from '@cratis/fundamentals';\nimport { Paging } from './Paging';\nimport { Globals } from '../Globals';\nimport { Sorting } from './Sorting';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\nimport { QueryHttpMethod } from './QueryHttpMethod';\nimport { executeQueryHttpRequest } from './QueryHttpRequest';\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class QueryFor<TDataType, TParameters = object> implements IQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _httpHeadersCallback: GetHttpHeaders;\n    private _httpMethod?: QueryHttpMethod;\n    abstract readonly route: string;\n    /** Backend fully-qualified query name used as cache key. Overridden in generated proxies. */\n    readonly queryName?: string;\n    /* eslint-disable @typescript-eslint/no-explicit-any */\n    readonly validation?: QueryValidator<any>;\n    /* eslint-enable @typescript-eslint/no-explicit-any */\n    readonly roles: string[] = [];\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    abstract defaultValue: TDataType;\n    abortController?: AbortController;\n    sorting: Sorting;\n    paging: Paging;\n    parameters: TParameters | undefined;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    setHttpMethod(method: QueryHttpMethod): void {\n        this._httpMethod = method;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        args = args || this.parameters;\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return QueryResult.validationFailed(clientValidationErrors, this);\n        }\n\n        if (!ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, args as object)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        if (this.abortController) {\n            this.abortController.abort();\n        }\n\n        this.abortController = new AbortController();\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const headers = {\n            ... this._httpHeadersCallback?.(), ...\n            {\n                'Accept': 'application/json',\n                'Content-Type': 'application/json'\n            }\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await executeQueryHttpRequest(this._httpMethod, {\n            route: this.route,\n            apiBasePath: this._apiBasePath,\n            origin: this._origin,\n            args: (args as object) ?? {},\n            parameterValues,\n            paging: this.paging,\n            sorting: this.sorting,\n            headers,\n            signal: this.abortController.signal\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n}\n"],"names":["QueryFor","_microservice","_apiBasePath","_origin","_httpHeadersCallback","_httpMethod","queryName","validation","roles","abortController","sorting","paging","parameters","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","setHttpMethod","method","perform","args","noSuccess","QueryResult","data","defaultValue","clientValidationErrors","validate","length","validationFailed","ValidateRequestArguments","name","requiredRequestParameters","Promise","resolve","abort","AbortController","parameterValues","ParametersHelper","collectParameterValues","headers","microserviceHttpHeader","response","executeQueryHttpRequest","route","signal","result","json"],"mappings":";;;;;;;;;;AAAA;AACA;AAgBA;;;AAGC,IACM,MAAeA,QAAAA,CAAAA;;;IACVC,aAAAA;IACAC,YAAAA;IACAC,OAAAA;IACAC,oBAAAA;IACAC,WAAAA;kGAGR,SAASC;4DAET,UAASC;AACT,2DACSC,KAAAA,GAAkB,EAAE;IAI7BC,eAAAA;IACAC,OAAAA;IACAC,MAAAA;IACAC,UAAAA;AAEA;;;;AAIC,QACD,YAAY,SAA+B,EAAWC,UAAmB,CAAE;aAAtDC,SAAAA,GAAAA,SAAAA;aAAiCD,UAAAA,GAAAA,UAAAA;AAClD,QAAA,IAAI,CAACH,OAAO,GAAGK,eAAAA,CAAQC,IAAI;AAC3B,QAAA,IAAI,CAACL,MAAM,GAAGM,aAAAA,CAAOC,QAAQ;AAC7B,QAAA,IAAI,CAACjB,aAAa,GAAGkB,eAAAA,CAAQC,YAAY,IAAI,EAAA;AAC7C,QAAA,IAAI,CAAClB,YAAY,GAAGiB,eAAAA,CAAQE,WAAW,IAAI,EAAA;AAC3C,QAAA,IAAI,CAAClB,OAAO,GAAGgB,eAAAA,CAAQG,MAAM,IAAI,EAAA;AACjC,QAAA,IAAI,CAAClB,oBAAoB,GAAG,KAAO,EAAC,CAAA;AACxC,IAAA;uBAGAmB,eAAAA,CAAgBH,YAAoB,EAAE;QAClC,IAAI,CAACnB,aAAa,GAAGmB,YAAAA;AACzB,IAAA;uBAGAI,cAAAA,CAAeH,WAAmB,EAAQ;QACtC,IAAI,CAACnB,YAAY,GAAGmB,WAAAA;AACxB,IAAA;uBAGAI,SAAAA,CAAUH,MAAc,EAAQ;QAC5B,IAAI,CAACnB,OAAO,GAAGmB,MAAAA;AACnB,IAAA;uBAGAI,sBAAAA,CAAuBC,QAAwB,EAAQ;QACnD,IAAI,CAACvB,oBAAoB,GAAGuB,QAAAA;AAChC,IAAA;uBAGAC,aAAAA,CAAcC,MAAuB,EAAQ;QACzC,IAAI,CAACxB,WAAW,GAAGwB,MAAAA;AACvB,IAAA;AAEA,uBACA,MAAMC,OAAAA,CAAQC,IAAkB,EAAmC;AAC/D,QAAA,MAAMC,SAAAA,GAAY;AAAE,YAAA,GAAGC,wBAAYD,SAAS;YAAE,GAAG;gBAAEE,IAAAA,EAAM,IAAI,CAACC;;AAAe,SAAA;QAE7EJ,IAAAA,GAAOA,IAAAA,IAAQ,IAAI,CAACnB,UAAU;QAE9B,MAAMwB,sBAAAA,GAAyB,IAAI,CAAC7B,UAAU,EAAE8B,QAAAA,CAASN,IAAAA,IAAkB,EAAC,CAAA,IAAM,EAAE;QACpF,IAAIK,sBAAAA,CAAuBE,MAAM,GAAG,CAAA,EAAG;AACnC,YAAA,OAAOL,uBAAAA,CAAYM,gBAAgB,CAACH,sBAAAA,EAAwB,IAAI,CAAA;AACpE,QAAA;AAEA,QAAA,IAAI,CAACI,iDAAAA,CAAyB,IAAI,CAAC,WAAW,CAACC,IAAI,EAAE,IAAI,CAACC,yBAAyB,EAAEX,IAAAA,CAAAA,EAAiB;YAClG,OAAO,IAAIY,QAAgC,CAACC,OAAAA,GAAAA;gBACxCA,OAAAA,CAAQZ,SAAAA,CAAAA;AACZ,YAAA,CAAA,CAAA;AACJ,QAAA;QAEA,IAAI,IAAI,CAACvB,eAAe,EAAE;YACtB,IAAI,CAACA,eAAe,CAACoC,KAAK,EAAA;AAC9B,QAAA;QAEA,IAAI,CAACpC,eAAe,GAAG,IAAIqC,eAAAA,EAAAA;;AAG3B,QAAA,MAAMC,eAAAA,GAAkBC,iCAAAA,CAAiBC,sBAAsB,CAAC,IAAI,CAAA;AAEpE,QAAA,MAAMC,OAAAA,GAAU;YACZ,GAAI,IAAI,CAAC9C,oBAAoB,IAAI;YAAE,GACnC;gBACI,QAAA,EAAU,kBAAA;gBACV,cAAA,EAAgB;;AAExB,SAAA;AAEA,QAAA,IAAI,IAAI,CAACH,aAAa,EAAEqC,SAAS,CAAA,EAAG;AAChCY,YAAAA,OAAO,CAAC/B,eAAAA,CAAQgC,sBAAsB,CAAC,GAAG,IAAI,CAAClD,aAAa;AAChE,QAAA;AAEA,QAAA,MAAMmD,WAAW,MAAMC,wCAAAA,CAAwB,IAAI,CAAChD,WAAW,EAAE;YAC7DiD,KAAAA,EAAO,IAAI,CAACA,KAAK;YACjBjC,WAAAA,EAAa,IAAI,CAACnB,YAAY;YAC9BoB,MAAAA,EAAQ,IAAI,CAACnB,OAAO;YACpB4B,IAAAA,EAAOA,QAAmB,EAAC;AAC3BgB,YAAAA,eAAAA;YACApC,MAAAA,EAAQ,IAAI,CAACA,MAAM;YACnBD,OAAAA,EAAS,IAAI,CAACA,OAAO;AACrBwC,YAAAA,OAAAA;AACAK,YAAAA,MAAAA,EAAQ,IAAI,CAAC9C,eAAe,CAAC8C;AACjC,SAAA,CAAA;QAEA,IAAI;YACA,MAAMC,MAAAA,GAAS,MAAMJ,QAAAA,CAASK,IAAI,EAAA;YAClC,OAAO,IAAIxB,wBAAYuB,MAAAA,EAAQ,IAAI,CAAC1C,SAAS,EAAE,IAAI,CAACD,UAAU,CAAA;AAClE,QAAA,CAAA,CAAE,OAAM;YACJ,OAAOmB,SAAAA;AACX,QAAA;AACJ,IAAA;AACJ;;;;"}

package/dist/cjs/queries/QueryResult.js

@@ -28,6 +28,36 @@ var PagingInfo = require('./PagingInfo.js');
             }
         }, Object, false);
     }
+    /**
+     * Creates a {@link QueryResult} representing a query rejected by client-side validation, mirroring
+     * {@link CommandResult.validationFailed} so a caller reads a failed query the same way it reads a failed command.
+     * @param {ValidationResult[]} validationResults The validation results that caused the failure.
+     * @param {object} query The query being rejected, which describes how to shape its own result.
+     * @returns {QueryResult<TDataType>} A result that is neither successful nor valid.
+     */ static validationFailed(validationResults, query) {
+        const { defaultValue, modelType, enumerable } = query;
+        return new QueryResult({
+            data: defaultValue,
+            isSuccess: false,
+            isAuthorized: true,
+            isValid: false,
+            hasExceptions: false,
+            validationResults: validationResults.map((_)=>({
+                    severity: _.severity,
+                    message: _.message,
+                    members: _.members,
+                    state: _.state
+                })),
+            exceptionMessages: [],
+            exceptionStackTrace: '',
+            paging: {
+                totalItems: 0,
+                totalPages: 0,
+                page: 0,
+                size: 0
+            }
+        }, modelType, enumerable);
+    }
     static unauthorized() {
         return new QueryResult({
             data: null,

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

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

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

@@ -1,8 +1,10 @@
 import { DataReceived } from './ObservableQueryConnection';
 import { IObservableQueryConnection } from './IObservableQueryConnection';
+import { QueryResult } from './QueryResult';
 export declare class NullObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {
     readonly defaultValue: TDataType;
-    constructor(defaultValue: TDataType);
+    readonly result?: QueryResult<TDataType> | undefined;
+    constructor(defaultValue: TDataType, result?: QueryResult<TDataType> | undefined);
     get lastPingLatency(): number;
     get averageLatency(): number;
     connect(dataReceived: DataReceived<TDataType>): void;

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

@@ -1 +1 @@
-{"version":3,"file":"NullObservableQueryConnection.d.ts","sourceRoot":"","sources":["../../../queries/NullObservableQueryConnection.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAO1E,qBAAa,6BAA6B,CAAC,SAAS,CAAE,YAAW,0BAA0B,CAAC,SAAS,CAAC;IAKtF,QAAQ,CAAC,YAAY,EAAE,SAAS;IAA5C,YAAqB,YAAY,EAAE,SAAS,EAC3C;IAGD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAGD,IAAI,cAAc,IAAI,MAAM,CAE3B;IAGD,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,QAE5C;IAID,UAAU,SACT;CACJ"}
+{"version":3,"file":"NullObservableQueryConnection.d.ts","sourceRoot":"","sources":["../../../queries/NullObservableQueryConnection.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,qBAAa,6BAA6B,CAAC,SAAS,CAAE,YAAW,0BAA0B,CAAC,SAAS,CAAC;IAQtF,QAAQ,CAAC,YAAY,EAAE,SAAS;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC;IAAtF,YAAqB,YAAY,EAAE,SAAS,EAAW,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,YAAA,EACrF;IAGD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAGD,IAAI,cAAc,IAAI,MAAM,CAE3B;IAGD,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,QAE5C;IAID,UAAU,SACT;CACJ"}

package/dist/esm/queries/NullObservableQueryConnection.js

@@ -6,11 +6,16 @@ import { QueryResult } from './QueryResult.js';
  * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.
  */ class NullObservableQueryConnection {
     defaultValue;
+    result;
     /**
      * Initializes a new instance of the {@link NullObservableQueryConnection} class.
      * @param {TDataType} defaultValue The default value to serve.
-     */ constructor(defaultValue){
+     * @param {QueryResult<TDataType>} result Optional result to serve instead of an empty one. Supply it when the
+     * subscription failed for a reason the subscriber must be able to see — client-side validation in particular,
+     * which would otherwise be indistinguishable from a query that simply has no data yet.
+     */ constructor(defaultValue, result){
         this.defaultValue = defaultValue;
+        this.result = result;
     }
     /** @inheritdoc */ get lastPingLatency() {
         return 0;
@@ -19,7 +24,7 @@ import { QueryResult } from './QueryResult.js';
         return 0;
     }
     /** @inheritdoc */ connect(dataReceived) {
-        dataReceived(QueryResult.empty(this.defaultValue));
+        dataReceived(this.result ?? QueryResult.empty(this.defaultValue));
     }
     /** @inheritdoc */ /* eslint-disable @typescript-eslint/no-empty-function */ disconnect() {}
 }

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

@@ -1 +1 @@
-{"version":3,"file":"NullObservableQueryConnection.js","sources":["../../../queries/NullObservableQueryConnection.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 { DataReceived } from './ObservableQueryConnection';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { QueryResult } from './QueryResult';\n\n/**\n * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.\n */\n\nexport class NullObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    /**\n     * Initializes a new instance of the {@link NullObservableQueryConnection} class.\n     * @param {TDataType} defaultValue The default value to serve.\n     */\n    constructor(readonly defaultValue: TDataType) {\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>) {\n        dataReceived(QueryResult.empty(this.defaultValue));\n    }\n\n    /** @inheritdoc */\n    /* eslint-disable @typescript-eslint/no-empty-function */\n    disconnect() {\n    }\n}\n"],"names":["NullObservableQueryConnection","defaultValue","lastPingLatency","averageLatency","connect","dataReceived","QueryResult","empty","disconnect"],"mappings":";;AAAA;AACA;AAMA;;AAEC,IAEM,MAAMA,6BAAAA,CAAAA;;AACT;;;QAIA,WAAA,CAAY,YAAgC,CAAE;aAAzBC,YAAAA,GAAAA,YAAAA;AACrB,IAAA;uBAGA,IAAIC,eAAAA,GAA0B;QAC1B,OAAO,CAAA;AACX,IAAA;uBAGA,IAAIC,cAAAA,GAAyB;QACzB,OAAO,CAAA;AACX,IAAA;uBAGAC,OAAAA,CAAQC,YAAqC,EAAE;AAC3CA,QAAAA,YAAAA,CAAaC,WAAAA,CAAYC,KAAK,CAAC,IAAI,CAACN,YAAY,CAAA,CAAA;AACpD,IAAA;AAEA,iFAEAO,UAAAA,GAAa,CACb;AACJ;;;;"}
+{"version":3,"file":"NullObservableQueryConnection.js","sources":["../../../queries/NullObservableQueryConnection.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 { DataReceived } from './ObservableQueryConnection';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { QueryResult } from './QueryResult';\n\n/**\n * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.\n */\n\nexport class NullObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    /**\n     * Initializes a new instance of the {@link NullObservableQueryConnection} class.\n     * @param {TDataType} defaultValue The default value to serve.\n     * @param {QueryResult<TDataType>} result Optional result to serve instead of an empty one. Supply it when the\n     * subscription failed for a reason the subscriber must be able to see — client-side validation in particular,\n     * which would otherwise be indistinguishable from a query that simply has no data yet.\n     */\n    constructor(readonly defaultValue: TDataType, readonly result?: QueryResult<TDataType>) {\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>) {\n        dataReceived(this.result ?? QueryResult.empty(this.defaultValue));\n    }\n\n    /** @inheritdoc */\n    /* eslint-disable @typescript-eslint/no-empty-function */\n    disconnect() {\n    }\n}\n"],"names":["NullObservableQueryConnection","result","defaultValue","lastPingLatency","averageLatency","connect","dataReceived","QueryResult","empty","disconnect"],"mappings":";;AAAA;AACA;AAMA;;AAEC,IAEM,MAAMA,6BAAAA,CAAAA;;;AACT;;;;;;AAMC,QACD,YAAY,YAAgC,EAAWC,MAA+B,CAAE;aAAnEC,YAAAA,GAAAA,YAAAA;aAAkCD,MAAAA,GAAAA,MAAAA;AACvD,IAAA;uBAGA,IAAIE,eAAAA,GAA0B;QAC1B,OAAO,CAAA;AACX,IAAA;uBAGA,IAAIC,cAAAA,GAAyB;QACzB,OAAO,CAAA;AACX,IAAA;uBAGAC,OAAAA,CAAQC,YAAqC,EAAE;QAC3CA,YAAAA,CAAa,IAAI,CAACL,MAAM,IAAIM,YAAYC,KAAK,CAAC,IAAI,CAACN,YAAY,CAAA,CAAA;AACnE,IAAA;AAEA,iFAEAO,UAAAA,GAAa,CACb;AACJ;;;;"}

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

@@ -1,5 +1,6 @@
 import { IObservableQueryFor, OnNextResult } from './IObservableQueryFor';
 import { ObservableQuerySubscription } from './ObservableQuerySubscription';
+import { QueryValidator } from './QueryValidator';
 import { Constructor } from '@cratis/fundamentals';
 import { QueryResult } from './QueryResult';
 import { Sorting } from './Sorting';
@@ -19,6 +20,7 @@ export declare abstract class ObservableQueryFor<TDataType, TParameters = object
     abstract readonly route: string;
     abstract readonly defaultValue: TDataType;
     readonly roles: string[];
+    readonly validation?: QueryValidator<any>;
     readonly queryName?: string;
     abstract readonly parameterDescriptors: ParameterDescriptor[];
     abstract get requiredRequestParameters(): string[];

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryFor.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAK5E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASpD,8BAAsB,kBAAkB,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC;IAuBhH,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IAtBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAwC;IAC5D,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAkB;IAEtC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAE9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IAOf,YAAqB,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO,EAOxE;IAKD,OAAO,SAEN;IAGD,eAAe,CAAC,YAAY,EAAE,MAAM,QAEnC;IAGD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAExC;IAGD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9B;IAGD,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAErD;IAGD,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAE3C;IAGD,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,2BAA2B,CAAC,SAAS,CAAC,CA6CpH;IAGK,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAuCjE;IAED,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,iBAAiB;CAW5B"}
+{"version":3,"file":"ObservableQueryFor.d.ts","sourceRoot":"","sources":["../../../queries/ObservableQueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASpD,8BAAsB,kBAAkB,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC;IAwBhH,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IAvBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAwC;IAC5D,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAkB;IAEtC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAE1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IAOf,YAAqB,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO,EAOxE;IAKD,OAAO,SAEN;IAGD,eAAe,CAAC,YAAY,EAAE,MAAM,QAEnC;IAGD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAExC;IAGD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9B;IAGD,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAErD;IAGD,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAE3C;IAGD,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,2BAA2B,CAAC,SAAS,CAAC,CAoDpH;IAGK,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CA4CjE;IAED,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,iBAAiB;CAW5B"}

package/dist/esm/queries/ObservableQueryFor.js

@@ -27,6 +27,7 @@ import { executeQueryHttpRequest } from './QueryHttpRequest.js';
     _httpHeadersCallback;
     _httpMethod;
     roles = [];
+    validation;
     /** Backend fully-qualified query name used when subscribing via the SSE hub. Overridden in generated proxies. */ queryName;
     sorting;
     paging;
@@ -68,7 +69,12 @@ import { executeQueryHttpRequest } from './QueryHttpRequest.js';
         if (this._connection) {
             this._connection.disconnect();
         }
-        if (!this.validateArguments(args)) {
+        const clientValidationErrors = this.validation?.validate(args || {}) || [];
+        if (clientValidationErrors.length > 0) {
+            // Serve the failure through the connection rather than throwing, so a subscriber sees an invalid result
+            // on its normal callback path instead of the empty result an unestablished connection would emit.
+            this._connection = new NullObservableQueryConnection(this.defaultValue, QueryResult.validationFailed(clientValidationErrors, this));
+        } else if (!this.validateArguments(args)) {
             this._connection = new NullObservableQueryConnection(this.defaultValue);
         } else {
             this._connection = createObservableQueryConnection({
@@ -114,6 +120,10 @@ import { executeQueryHttpRequest } from './QueryHttpRequest.js';
                 data: this.defaultValue
             }
         };
+        const clientValidationErrors = this.validation?.validate(args || {}) || [];
+        if (clientValidationErrors.length > 0) {
+            return QueryResult.validationFailed(clientValidationErrors, this);
+        }
         if (!this.validateArguments(args)) {
             return new Promise((resolve)=>{
                 resolve(noSuccess);

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

@@ -1 +1 @@
-{"version":3,"file":"ObservableQueryFor.js","sources":["../../../queries/ObservableQueryFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IObservableQueryFor, OnNextResult } from './IObservableQueryFor';\nimport { ObservableQuerySubscription } from './ObservableQuerySubscription';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { NullObservableQueryConnection } from './NullObservableQueryConnection';\nimport { createObservableQueryConnection } from './ObservableQueryConnectionFactory';\nimport { Constructor } from '@cratis/fundamentals';\nimport { JsonSerializer } from '@cratis/fundamentals';\nimport { QueryResult } from './QueryResult';\nimport { Sorting } from './Sorting';\nimport { Paging } from './Paging';\nimport { SortDirection } from './SortDirection';\nimport { Globals } from '../Globals';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\nimport { QueryHttpMethod } from './QueryHttpMethod';\nimport { executeQueryHttpRequest } from './QueryHttpRequest';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class ObservableQueryFor<TDataType, TParameters = object> implements IObservableQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _connection?: IObservableQueryConnection<TDataType>;\n    private _httpHeadersCallback: GetHttpHeaders;\n    private _httpMethod?: QueryHttpMethod;\n\n    abstract readonly route: string;\n    abstract readonly defaultValue: TDataType;\n    readonly roles: string[] = [];\n    /** Backend fully-qualified query name used when subscribing via the SSE hub. Overridden in generated proxies. */\n    readonly queryName?: string;\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    sorting: Sorting;\n    paging: Paging;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /**\n     * Disposes the query.\n     */\n    dispose() {\n        this._connection?.disconnect();\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    setHttpMethod(method: QueryHttpMethod): void {\n        this._httpMethod = method;\n    }\n\n    /** @inheritdoc */\n    subscribe(callback: OnNextResult<QueryResult<TDataType>>, args?: TParameters): ObservableQuerySubscription<TDataType> {\n        if (this._connection) {\n            this._connection.disconnect();\n        }\n\n        if (!this.validateArguments(args)) {\n            this._connection = new NullObservableQueryConnection(this.defaultValue);\n        } else {\n            this._connection = createObservableQueryConnection({\n                route: this.route,\n                queryName: this.queryName ?? this.constructor.name,\n                origin: this._origin,\n                apiBasePath: this._apiBasePath,\n                microservice: this._microservice,\n                args: args as object,\n            });\n        }\n\n        // Descriptor-backed instance properties provide defaults; fresh args passed to subscribe()\n        // must take precedence over any stale instance property values. Spread parameterValues\n        // first so that the caller-supplied args can override them.\n        //\n        // In direct mode the route arguments are already embedded in the URL path, so only\n        // the unused (non-route) parameters are appended as additional query arguments.\n        // In multiplexed mode ALL arguments — including route-derived ones — must be included\n        // in the subscribe payload so the server can execute the query correctly.\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const { unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        const connectionQueryArguments: any = {\n            ...parameterValues,\n            ...(Globals.queryDirectMode ? unusedParameters : (args as object) || {}),\n            ...this.buildQueryArguments()\n        };\n\n        const subscriber = new ObservableQuerySubscription(this._connection);\n        this._connection.connect(data => {\n            const result: any = data;\n            try {\n                this.deserializeResult(result);\n                callback(result);\n            } catch (ex) {\n                console.log(ex);\n            }\n        }, connectionQueryArguments);\n        return subscriber;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        if (!this.validateArguments(args)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const headers = {\n            ...(this._httpHeadersCallback?.() || {}),\n            'Accept': 'application/json',\n            'Content-Type': 'application/json'\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await executeQueryHttpRequest(this._httpMethod, {\n            route: this.route,\n            apiBasePath: this._apiBasePath,\n            origin: this._origin,\n            args: (args as object) ?? {},\n            parameterValues,\n            paging: this.paging,\n            sorting: this.sorting,\n            headers\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n\n    private validateArguments(args?: TParameters): boolean {\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const combinedArgs = { ...(args as object || {}), ...parameterValues };\n        return ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, combinedArgs as object);\n    }\n\n    private buildQueryArguments(): any {\n        const queryArguments: any = {};\n\n        if (this.paging && this.paging.pageSize > 0) {\n            queryArguments.pageSize = this.paging.pageSize;\n            queryArguments.page = this.paging.page;\n        }\n\n        if (this.sorting.hasSorting) {\n            queryArguments.sortBy = this.sorting.field;\n            queryArguments.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        return queryArguments;\n    }\n\n    private deserializeResult(result: any): void {\n        if (this.enumerable) {\n            if (Array.isArray(result.data)) {\n                result.data = JsonSerializer.deserializeArrayFromInstance(this.modelType, result.data);\n            } else {\n                result.data = [];\n            }\n        } else if (result.data) {\n            result.data = JsonSerializer.deserializeFromInstance(this.modelType, result.data);\n        }\n    }\n}\n"],"names":["ObservableQueryFor","_microservice","_apiBasePath","_origin","_connection","_httpHeadersCallback","_httpMethod","roles","queryName","sorting","paging","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","dispose","disconnect","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","setHttpMethod","method","subscribe","args","validateArguments","NullObservableQueryConnection","defaultValue","createObservableQueryConnection","route","name","parameterValues","ParametersHelper","collectParameterValues","unusedParameters","UrlHelpers","replaceRouteParameters","connectionQueryArguments","queryDirectMode","buildQueryArguments","subscriber","ObservableQuerySubscription","connect","data","result","deserializeResult","ex","console","log","perform","noSuccess","QueryResult","Promise","resolve","headers","length","microserviceHttpHeader","response","executeQueryHttpRequest","json","combinedArgs","ValidateRequestArguments","requiredRequestParameters","queryArguments","pageSize","page","hasSorting","sortBy","field","sortDirection","direction","SortDirection","descending","Array","isArray","JsonSerializer","deserializeArrayFromInstance","deserializeFromInstance"],"mappings":"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"}
+{"version":3,"file":"ObservableQueryFor.js","sources":["../../../queries/ObservableQueryFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { IObservableQueryFor, OnNextResult } from './IObservableQueryFor';\nimport { ObservableQuerySubscription } from './ObservableQuerySubscription';\nimport { ValidateRequestArguments } from './ValidateRequestArguments';\nimport { QueryValidator } from './QueryValidator';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { NullObservableQueryConnection } from './NullObservableQueryConnection';\nimport { createObservableQueryConnection } from './ObservableQueryConnectionFactory';\nimport { Constructor } from '@cratis/fundamentals';\nimport { JsonSerializer } from '@cratis/fundamentals';\nimport { QueryResult } from './QueryResult';\nimport { Sorting } from './Sorting';\nimport { Paging } from './Paging';\nimport { SortDirection } from './SortDirection';\nimport { Globals } from '../Globals';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { ParameterDescriptor } from '../reflection/ParameterDescriptor';\nimport { ParametersHelper } from '../reflection/ParametersHelper';\nimport { QueryHttpMethod } from './QueryHttpMethod';\nimport { executeQueryHttpRequest } from './QueryHttpRequest';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Represents an implementation of {@link IQueryFor}.\n * @template TDataType Type of data returned by the query.\n */\nexport abstract class ObservableQueryFor<TDataType, TParameters = object> implements IObservableQueryFor<TDataType, TParameters> {\n    private _microservice: string;\n    private _apiBasePath: string;\n    private _origin: string;\n    private _connection?: IObservableQueryConnection<TDataType>;\n    private _httpHeadersCallback: GetHttpHeaders;\n    private _httpMethod?: QueryHttpMethod;\n\n    abstract readonly route: string;\n    abstract readonly defaultValue: TDataType;\n    readonly roles: string[] = [];\n    readonly validation?: QueryValidator<any>;\n    /** Backend fully-qualified query name used when subscribing via the SSE hub. Overridden in generated proxies. */\n    readonly queryName?: string;\n    abstract readonly parameterDescriptors: ParameterDescriptor[];\n    abstract get requiredRequestParameters(): string[];\n    sorting: Sorting;\n    paging: Paging;\n\n    /**\n     * Initializes a new instance of the {@link ObservableQueryFor<,>}} class.\n     * @param modelType Type of model, if an enumerable, this is the instance type.\n     * @param enumerable Whether or not it is an enumerable.\n     */\n    constructor(readonly modelType: Constructor, readonly enumerable: boolean) {\n        this.sorting = Sorting.none;\n        this.paging = Paging.noPaging;\n        this._microservice = Globals.microservice ?? '';\n        this._apiBasePath = Globals.apiBasePath ?? '';\n        this._origin = Globals.origin ?? '';\n        this._httpHeadersCallback = () => ({});\n    }\n\n    /**\n     * Disposes the query.\n     */\n    dispose() {\n        this._connection?.disconnect();\n    }\n\n    /** @inheritdoc */\n    setMicroservice(microservice: string) {\n        this._microservice = microservice;\n    }\n\n    /** @inheritdoc */\n    setApiBasePath(apiBasePath: string): void {\n        this._apiBasePath = apiBasePath;\n    }\n\n    /** @inheritdoc */\n    setOrigin(origin: string): void {\n        this._origin = origin;\n    }\n\n    /** @inheritdoc */\n    setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        this._httpHeadersCallback = callback;\n    }\n\n    /** @inheritdoc */\n    setHttpMethod(method: QueryHttpMethod): void {\n        this._httpMethod = method;\n    }\n\n    /** @inheritdoc */\n    subscribe(callback: OnNextResult<QueryResult<TDataType>>, args?: TParameters): ObservableQuerySubscription<TDataType> {\n        if (this._connection) {\n            this._connection.disconnect();\n        }\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            // Serve the failure through the connection rather than throwing, so a subscriber sees an invalid result\n            // on its normal callback path instead of the empty result an unestablished connection would emit.\n            this._connection = new NullObservableQueryConnection(\n                this.defaultValue,\n                QueryResult.validationFailed(clientValidationErrors, this));\n        } else if (!this.validateArguments(args)) {\n            this._connection = new NullObservableQueryConnection(this.defaultValue);\n        } else {\n            this._connection = createObservableQueryConnection({\n                route: this.route,\n                queryName: this.queryName ?? this.constructor.name,\n                origin: this._origin,\n                apiBasePath: this._apiBasePath,\n                microservice: this._microservice,\n                args: args as object,\n            });\n        }\n\n        // Descriptor-backed instance properties provide defaults; fresh args passed to subscribe()\n        // must take precedence over any stale instance property values. Spread parameterValues\n        // first so that the caller-supplied args can override them.\n        //\n        // In direct mode the route arguments are already embedded in the URL path, so only\n        // the unused (non-route) parameters are appended as additional query arguments.\n        // In multiplexed mode ALL arguments — including route-derived ones — must be included\n        // in the subscribe payload so the server can execute the query correctly.\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const { unusedParameters } = UrlHelpers.replaceRouteParameters(this.route, args as object);\n        const connectionQueryArguments: any = {\n            ...parameterValues,\n            ...(Globals.queryDirectMode ? unusedParameters : (args as object) || {}),\n            ...this.buildQueryArguments()\n        };\n\n        const subscriber = new ObservableQuerySubscription(this._connection);\n        this._connection.connect(data => {\n            const result: any = data;\n            try {\n                this.deserializeResult(result);\n                callback(result);\n            } catch (ex) {\n                console.log(ex);\n            }\n        }, connectionQueryArguments);\n        return subscriber;\n    }\n\n    /** @inheritdoc */\n    async perform(args?: TParameters): Promise<QueryResult<TDataType>> {\n        const noSuccess = { ...QueryResult.noSuccess, ...{ data: this.defaultValue } } as QueryResult<TDataType>;\n\n        const clientValidationErrors = this.validation?.validate(args as object || {}) || [];\n        if (clientValidationErrors.length > 0) {\n            return QueryResult.validationFailed(clientValidationErrors, this);\n        }\n\n        if (!this.validateArguments(args)) {\n            return new Promise<QueryResult<TDataType>>((resolve) => {\n                resolve(noSuccess);\n            });\n        }\n\n        // Collect parameter values from parameterDescriptors that are set\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n\n        const headers = {\n            ...(this._httpHeadersCallback?.() || {}),\n            'Accept': 'application/json',\n            'Content-Type': 'application/json'\n        };\n\n        if (this._microservice?.length > 0) {\n            headers[Globals.microserviceHttpHeader] = this._microservice;\n        }\n\n        const response = await executeQueryHttpRequest(this._httpMethod, {\n            route: this.route,\n            apiBasePath: this._apiBasePath,\n            origin: this._origin,\n            args: (args as object) ?? {},\n            parameterValues,\n            paging: this.paging,\n            sorting: this.sorting,\n            headers\n        });\n\n        try {\n            const result = await response.json();\n            return new QueryResult(result, this.modelType, this.enumerable);\n        } catch {\n            return noSuccess;\n        }\n    }\n\n    private validateArguments(args?: TParameters): boolean {\n        const parameterValues = ParametersHelper.collectParameterValues(this);\n        const combinedArgs = { ...(args as object || {}), ...parameterValues };\n        return ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, combinedArgs as object);\n    }\n\n    private buildQueryArguments(): any {\n        const queryArguments: any = {};\n\n        if (this.paging && this.paging.pageSize > 0) {\n            queryArguments.pageSize = this.paging.pageSize;\n            queryArguments.page = this.paging.page;\n        }\n\n        if (this.sorting.hasSorting) {\n            queryArguments.sortBy = this.sorting.field;\n            queryArguments.sortDirection = (this.sorting.direction === SortDirection.descending) ? 'desc' : 'asc';\n        }\n\n        return queryArguments;\n    }\n\n    private deserializeResult(result: any): void {\n        if (this.enumerable) {\n            if (Array.isArray(result.data)) {\n                result.data = JsonSerializer.deserializeArrayFromInstance(this.modelType, result.data);\n            } else {\n                result.data = [];\n            }\n        } else if (result.data) {\n            result.data = JsonSerializer.deserializeFromInstance(this.modelType, result.data);\n        }\n    }\n}\n"],"names":["ObservableQueryFor","_microservice","_apiBasePath","_origin","_connection","_httpHeadersCallback","_httpMethod","roles","validation","queryName","sorting","paging","enumerable","modelType","Sorting","none","Paging","noPaging","Globals","microservice","apiBasePath","origin","dispose","disconnect","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","callback","setHttpMethod","method","subscribe","args","clientValidationErrors","validate","length","NullObservableQueryConnection","defaultValue","QueryResult","validationFailed","validateArguments","createObservableQueryConnection","route","name","parameterValues","ParametersHelper","collectParameterValues","unusedParameters","UrlHelpers","replaceRouteParameters","connectionQueryArguments","queryDirectMode","buildQueryArguments","subscriber","ObservableQuerySubscription","connect","data","result","deserializeResult","ex","console","log","perform","noSuccess","Promise","resolve","headers","microserviceHttpHeader","response","executeQueryHttpRequest","json","combinedArgs","ValidateRequestArguments","requiredRequestParameters","queryArguments","pageSize","page","hasSorting","sortBy","field","sortDirection","direction","SortDirection","descending","Array","isArray","JsonSerializer","deserializeArrayFromInstance","deserializeFromInstance"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"QueryFor.d.ts","sourceRoot":"","sources":["../../../queries/QueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,8BAAsB,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;IA0B5F,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IAzBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAE1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,GAAG,SAAS,CAAC;IAOpC,YAAqB,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO,EAOxE;IAGD,eAAe,CAAC,YAAY,EAAE,MAAM,QAEnC;IAGD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAExC;IAGD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9B;IAGD,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAErD;IAGD,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAE3C;IAGK,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CA2EjE;CACJ"}
+{"version":3,"file":"QueryFor.d.ts","sourceRoot":"","sources":["../../../queries/QueryFor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,8BAAsB,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,CAAE,YAAW,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;IA0B5F,QAAQ,CAAC,SAAS,EAAE,WAAW;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO;IAzBzE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAE1C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC9D,QAAQ,KAAK,yBAAyB,IAAI,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,GAAG,SAAS,CAAC;IAOpC,YAAqB,SAAS,EAAE,WAAW,EAAW,UAAU,EAAE,OAAO,EAOxE;IAGD,eAAe,CAAC,YAAY,EAAE,MAAM,QAEnC;IAGD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAExC;IAGD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9B;IAGD,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAErD;IAGD,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAE3C;IAGK,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAuDjE;CACJ"}

package/dist/esm/queries/QueryFor.js

@@ -65,27 +65,7 @@ import { executeQueryHttpRequest } from './QueryHttpRequest.js';
         args = args || this.parameters;
         const clientValidationErrors = this.validation?.validate(args || {}) || [];
         if (clientValidationErrors.length > 0) {
-            return new QueryResult({
-                data: this.defaultValue,
-                isSuccess: false,
-                isAuthorized: true,
-                isValid: false,
-                hasExceptions: false,
-                validationResults: clientValidationErrors.map((_)=>({
-                        severity: _.severity,
-                        message: _.message,
-                        members: _.members,
-                        state: _.state
-                    })),
-                exceptionMessages: [],
-                exceptionStackTrace: '',
-                paging: {
-                    totalItems: 0,
-                    totalPages: 0,
-                    page: 0,
-                    size: 0
-                }
-            }, this.modelType, this.enumerable);
+            return QueryResult.validationFailed(clientValidationErrors, this);
         }
         if (!ValidateRequestArguments(this.constructor.name, this.requiredRequestParameters, args)) {
             return new Promise((resolve)=>{