@cratis/arc 22.24.0 → 22.26.1

package/commands/for_Command/when_property_has_changed_and_we_revert.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { SomeCommand } from './SomeCommand';
+import { SomeCommand } from './SomeCommand.js';
 
 describe('when property has changed and we revert', () => {
     const command = new SomeCommand();

package/commands/for_Command/when_setting_initial_values_after_property_changed.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { SomeCommand } from './SomeCommand';
+import { SomeCommand } from './SomeCommand.js';
 
 describe('when setting initial values after property changed', () => {
     const command = new SomeCommand();

package/commands/for_Command/when_validating/and_fetch_throws_exception.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { a_command } from '../given/a_command';
-import { given } from '../../../given';
-import { CommandResult } from '../../CommandResult';
+import { a_command } from '../given/a_command.js';
+import { given } from '../../../given.js';
+import { CommandResult } from '../../CommandResult.js';
 
 describe("when validating and fetch throws exception", given(a_command, context => {
     let result: CommandResult<object>;

package/commands/for_Command/when_validating/and_validation_endpoint_not_found.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { a_command } from '../given/a_command';
-import { given } from '../../../given';
-import { CommandResult } from '../../CommandResult';
+import { a_command } from '../given/a_command.js';
+import { given } from '../../../given.js';
+import { CommandResult } from '../../CommandResult.js';
 
 describe("when validating and validation endpoint not found", given(a_command, context => {
     let result: CommandResult<object>;

package/commands/for_Command/when_validating/does_not_update_initial_values.ts

@@ -1,8 +1,8 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { a_command } from '../given/a_command';
-import { given } from '../../../given';
+import { a_command } from '../given/a_command.js';
+import { given } from '../../../given.js';
 
 describe("when validating does not update initial values", given(a_command, context => {
     const responseData = {

package/commands/for_Command/when_validating/with_client_validation_failure.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { a_command_with_validator } from '../given/a_command_with_validator';
-import { given } from '../../../given';
-import { CommandResult } from '../../CommandResult';
+import { a_command_with_validator } from '../given/a_command_with_validator.js';
+import { given } from '../../../given.js';
+import { CommandResult } from '../../CommandResult.js';
 
 describe("when validating with client validation failure", given(a_command_with_validator, context => {
     let result: CommandResult<object>;

package/commands/for_Command/when_validating/with_client_validation_passing.ts

@@ -1,13 +1,13 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { Command } from '../../Command';
-import { CommandValidator } from '../../CommandValidator';
-import { PropertyDescriptor } from '../../../reflection/PropertyDescriptor';
-import '../../../validation/RuleBuilderExtensions';
+import { Command } from '../../Command.js';
+import { CommandValidator } from '../../CommandValidator.js';
+import { PropertyDescriptor } from '../../../reflection/PropertyDescriptor.js';
+import '../../../validation/RuleBuilderExtensions.js';
 import sinon from 'sinon';
-import { CommandResult } from '../../CommandResult';
-import { createFetchHelper } from '../../../helpers/fetchHelper';
+import { CommandResult } from '../../CommandResult.js';
+import { createFetchHelper } from '../../../helpers/fetchHelper.js';
 
 interface ITestCommand {
     email: string;

package/commands/for_Command/when_validating/with_empty_required_string_property.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { given } from '../../../given';
-import { CommandResult } from '../../CommandResult';
-import { a_command } from '../given/a_command';
+import { given } from '../../../given.js';
+import { CommandResult } from '../../CommandResult.js';
+import { a_command } from '../given/a_command.js';
 
 describe("when validating with empty required string property", given(class extends a_command {
     constructor() {

package/commands/for_Command/when_validating/with_null_required_property.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { given } from '../../../given';
-import { CommandResult } from '../../CommandResult';
-import { a_command } from '../given/a_command';
+import { given } from '../../../given.js';
+import { CommandResult } from '../../CommandResult.js';
+import { a_command } from '../given/a_command.js';
 
 describe("when validating with null required property", given(class extends a_command {
     constructor() {

package/commands/for_Command/when_validating/with_required_property_missing.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { given } from '../../../given';
-import { CommandResult } from '../../CommandResult';
-import { a_command } from '../given/a_command';
+import { given } from '../../../given.js';
+import { CommandResult } from '../../CommandResult.js';
+import { a_command } from '../given/a_command.js';
 
 describe("when validating with required property missing", given(class extends a_command {
     constructor() {

package/commands/for_Command/when_validating/with_route_parameters.ts

@@ -2,9 +2,9 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import sinon from 'sinon';
-import { createFetchHelper } from '../../../helpers/fetchHelper';
-import { CommandWithRouteParams } from '../CommandWithRouteParams';
-import { given } from '../../../given';
+import { createFetchHelper } from '../../../helpers/fetchHelper.js';
+import { CommandWithRouteParams } from '../CommandWithRouteParams.js';
+import { given } from '../../../given.js';
 
 describe("when validating with route parameters", given(class {
     command: CommandWithRouteParams;

package/commands/for_Command/when_validating/with_successful_response.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { a_command } from '../given/a_command';
-import { given } from '../../../given';
-import { CommandResult } from '../../CommandResult';
+import { a_command } from '../given/a_command.js';
+import { given } from '../../../given.js';
+import { CommandResult } from '../../CommandResult.js';
 
 describe("when validating with successful response", given(a_command, context => {
     let result: CommandResult<object>;

package/commands/for_Command/when_validating/with_validation_errors.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { a_command } from '../given/a_command';
-import { given } from '../../../given';
-import { CommandResult } from '../../CommandResult';
+import { a_command } from '../given/a_command.js';
+import { given } from '../../../given.js';
+import { CommandResult } from '../../CommandResult.js';
 
 describe("when validating with validation errors", given(a_command, context => {
     let result: CommandResult<object>;

package/commands/for_Command/when_validating_client_side/with_client_validation_failure.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { a_command_with_validator } from '../given/a_command_with_validator';
-import { given } from '../../../given';
-import { CommandResult } from '../../CommandResult';
+import { a_command_with_validator } from '../given/a_command_with_validator.js';
+import { given } from '../../../given.js';
+import { CommandResult } from '../../CommandResult.js';
 
 describe("when validating client side with client validation failure", given(a_command_with_validator, context => {
     let result: CommandResult<object>;

package/commands/for_Command/when_validating_client_side/with_client_validation_passing.ts

@@ -1,13 +1,13 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { Command } from '../../Command';
-import { CommandValidator } from '../../CommandValidator';
-import { PropertyDescriptor } from '../../../reflection/PropertyDescriptor';
-import '../../../validation/RuleBuilderExtensions';
+import { Command } from '../../Command.js';
+import { CommandValidator } from '../../CommandValidator.js';
+import { PropertyDescriptor } from '../../../reflection/PropertyDescriptor.js';
+import '../../../validation/RuleBuilderExtensions.js';
 import sinon from 'sinon';
-import { CommandResult } from '../../CommandResult';
-import { createFetchHelper } from '../../../helpers/fetchHelper';
+import { CommandResult } from '../../CommandResult.js';
+import { createFetchHelper } from '../../../helpers/fetchHelper.js';
 
 interface ITestCommand {
     email: string;

package/commands/for_Command/when_validating_client_side/with_required_property_missing.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { given } from '../../../given';
-import { CommandResult } from '../../CommandResult';
-import { a_command } from '../given/a_command';
+import { given } from '../../../given.js';
+import { CommandResult } from '../../CommandResult.js';
+import { a_command } from '../given/a_command.js';
 
 describe("when validating client side with required property missing", given(class extends a_command {
     constructor() {

package/commands/for_CommandResult/when_chaining_callbacks/and_result_has_exceptions.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { CommandResult } from '../../CommandResult';
+import { CommandResult } from '../../CommandResult.js';
 
 describe('when chaining callbacks and result has exceptions', () => {
     const result = new CommandResult({

package/commands/for_CommandResult/when_chaining_callbacks/and_result_is_invalid.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { ValidationResult } from '../../../validation/ValidationResult';
-import { ValidationResultSeverity } from '../../../validation/ValidationResultSeverity';
-import { CommandResult } from '../../CommandResult';
+import { ValidationResult } from '../../../validation/ValidationResult.js';
+import { ValidationResultSeverity } from '../../../validation/ValidationResultSeverity.js';
+import { CommandResult } from '../../CommandResult.js';
 
 describe('when chaining callbacks and result is invalid', () => {
     const result = new CommandResult({

package/commands/for_CommandResult/when_chaining_callbacks/and_result_is_successful.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { CommandResult } from '../../CommandResult';
+import { CommandResult } from '../../CommandResult.js';
 
 describe('when chaining callbacks and result is successful', () => {
     const result = new CommandResult<string>({

package/commands/for_CommandResult/when_chaining_callbacks/and_result_is_unauthorized.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { CommandResult } from '../../CommandResult';
+import { CommandResult } from '../../CommandResult.js';
 
 describe('when chaining callbacks and result is unauthorized', () => {
     const result = new CommandResult({

package/commands/for_CommandResult/when_constructing_from_a_server_result_with_a_constraint_violation.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { ValidationResultReason } from '../../validation/ValidationResultReason';
-import { ValidationResultSeverity } from '../../validation/ValidationResultSeverity';
-import { CommandResult } from '../CommandResult';
+import { ValidationResultReason } from '../../validation/ValidationResultReason.js';
+import { ValidationResultSeverity } from '../../validation/ValidationResultSeverity.js';
+import { CommandResult } from '../CommandResult.js';
 
 describe('when constructing from a server result with a constraint violation', () => {
     const result = new CommandResult({

package/commands/for_CommandResult/when_constructing_from_a_server_result_with_reasons.ts

@@ -1,9 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { ValidationResultReason } from '../../validation/ValidationResultReason';
-import { ValidationResultSeverity } from '../../validation/ValidationResultSeverity';
-import { CommandResult } from '../CommandResult';
+import { ValidationResultReason } from '../../validation/ValidationResultReason.js';
+import { ValidationResultSeverity } from '../../validation/ValidationResultSeverity.js';
+import { CommandResult } from '../CommandResult.js';
 
 describe('when constructing from a server result with reasons', () => {
     const result = new CommandResult({

package/commands/for_CommandResult/when_constructing_with_primitive_response.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { CommandResult } from '../CommandResult';
+import { CommandResult } from '../CommandResult.js';
 
 describe('when constructing with primitive response', () => {
     const stringResult = new CommandResult<string>({

package/commands/for_CommandResult/when_creating_a_validation_failed_result.ts

@@ -1,10 +1,10 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { ValidationResult } from '../../validation/ValidationResult';
-import { ValidationResultReason } from '../../validation/ValidationResultReason';
-import { ValidationResultSeverity } from '../../validation/ValidationResultSeverity';
-import { CommandResult } from '../CommandResult';
+import { ValidationResult } from '../../validation/ValidationResult.js';
+import { ValidationResultReason } from '../../validation/ValidationResultReason.js';
+import { ValidationResultSeverity } from '../../validation/ValidationResultSeverity.js';
+import { CommandResult } from '../CommandResult.js';
 
 describe('when creating a validation failed result', () => {
     const result = CommandResult.validationFailed([

package/commands/index.ts

@@ -1,10 +1,10 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-export * from './ICommand';
-export * from './Command';
-export * from './ICommandResult';
-export * from './CommandResult';
-export * from './CommandResults';
-export * from './CommandValidator';
-import '../validation';
+export * from './ICommand.js';
+export * from './Command.js';
+export * from './ICommandResult.js';
+export * from './CommandResult.js';
+export * from './CommandResults.js';
+export * from './CommandValidator.js';
+import '../validation/index.js';

package/dist/cjs/EventSourceFactory.d.ts

@@ -0,0 +1,2 @@
+export type EventSourceFactory = (url: string) => EventSource;
+//# sourceMappingURL=EventSourceFactory.d.ts.map

package/dist/cjs/EventSourceFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventSourceFactory.d.ts","sourceRoot":"","sources":["../../EventSourceFactory.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,CAAC"}

package/dist/cjs/GetHttpHeaders.d.ts

@@ -0,0 +1,2 @@
+export type GetHttpHeaders = () => HeadersInit;
+//# sourceMappingURL=GetHttpHeaders.d.ts.map

package/dist/cjs/GetHttpHeaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetHttpHeaders.d.ts","sourceRoot":"","sources":["../../GetHttpHeaders.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC"}

package/dist/cjs/Globals.d.ts

@@ -0,0 +1,27 @@
+import { GetHttpHeaders } from './GetHttpHeaders.js';
+import { EventSourceFactory } from './EventSourceFactory.js';
+import { QueryTransportMethod } from './queries/QueryTransportMethod.js';
+import { QueryHttpMethod } from './queries/QueryHttpMethod.js';
+import { QueryHttpMethodResolver } from './queries/QueryHttpMethodResolver.js';
+export declare enum ObservableQueryTransferMode {
+    Delta = "delta",
+    Full = "full"
+}
+export interface IGlobals {
+    microservice: string;
+    apiBasePath: string;
+    origin: string;
+    microserviceHttpHeader: string;
+    microserviceWSQueryArgument: string;
+    queryTransportMethod: QueryTransportMethod;
+    queryHttpMethod: QueryHttpMethod;
+    queryHttpMethodResolver?: QueryHttpMethodResolver;
+    queryConnectionCount: number;
+    queryDirectMode: boolean;
+    observableQueryTransferMode: ObservableQueryTransferMode;
+    httpHeadersCallback: GetHttpHeaders;
+    eventSourceFactory?: EventSourceFactory;
+    queryCacheRetentionMs: number;
+}
+export declare const Globals: IGlobals;
+//# sourceMappingURL=Globals.d.ts.map

package/dist/cjs/Globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Globals.d.ts","sourceRoot":"","sources":["../../Globals.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAa/E,oBAAY,2BAA2B;IAEnC,KAAK,UAAU;IAEf,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,QAAQ;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2BAA2B,EAAE,MAAM,CAAC;IACpC,oBAAoB,EAAE,oBAAoB,CAAC;IAM3C,eAAe,EAAE,eAAe,CAAC;IAMjC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAOlD,oBAAoB,EAAE,MAAM,CAAC;IAM7B,eAAe,EAAE,OAAO,CAAC;IAMzB,2BAA2B,EAAE,2BAA2B,CAAC;IAKzD,mBAAmB,EAAE,cAAc,CAAC;IAOpC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAYxC,qBAAqB,EAAE,MAAM,CAAC;CACjC;AAED,eAAO,MAAM,OAAO,EAAE,QAarB,CAAC"}

package/dist/cjs/Globals.js.map

@@ -1 +1 @@
-{"version":3,"file":"Globals.js","sources":["../../Globals.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 { GetHttpHeaders } from './GetHttpHeaders';\nimport { EventSourceFactory } from './EventSourceFactory';\nimport { QueryTransportMethod } from './queries/QueryTransportMethod';\nimport { QueryHttpMethod } from './queries/QueryHttpMethod';\nimport { QueryHttpMethodResolver } from './queries/QueryHttpMethodResolver';\n\n/**\n * Defines the transfer mode used for observable query subscriptions.\n *\n * - {@link ObservableQueryTransferMode.Delta} (default): Only the items that changed since\n *   the previous update (added, replaced, removed) are exposed via {@code useChangeStream}.\n *   The full collection state is still maintained internally by {@code useObservableQuery}.\n *\n * - {@link ObservableQueryTransferMode.Full}: Every update delivers the complete current\n *   collection. The change set returned by {@code useChangeStream} treats the entire new\n *   collection as {@code added} and the previous collection as {@code removed}.\n */\nexport enum ObservableQueryTransferMode {\n    /** Compute and expose only the items that changed since the previous update (default). */\n    Delta = 'delta',\n    /** Expose the full collection on every update. */\n    Full = 'full',\n}\n\nexport interface IGlobals {\n    microservice: string;\n    apiBasePath: string;\n    origin: string;\n    microserviceHttpHeader: string;\n    microserviceWSQueryArgument: string;\n    queryTransportMethod: QueryTransportMethod;\n    /**\n     * The HTTP method used to perform non-streaming queries. Defaults to {@link QueryHttpMethod.Get}.\n     * Set to {@link QueryHttpMethod.Query} to carry arguments in a JSON request body (RFC 10008)\n     * instead of the URL query string. Individual queries can override this via {@code setHttpMethod}.\n     */\n    queryHttpMethod: QueryHttpMethod;\n    /**\n     * Optional per-query policy for choosing the query HTTP method from the request (e.g. by URL length).\n     * Consulted only when a query has no explicit method set via {@code setHttpMethod}; it takes\n     * precedence over {@link queryHttpMethod}. See {@link lengthBasedQueryHttpMethod} for a built-in.\n     */\n    queryHttpMethodResolver?: QueryHttpMethodResolver;\n    /**\n     * Number of hub connections maintained for observable queries.\n     * When greater than one, queries are distributed across the pool round-robin.\n     * Only applies when {@link queryTransportMethod} is a centralized hub transport.\n     * Defaults to 1.\n     */\n    queryConnectionCount: number;\n    /**\n     * When true, observable queries connect directly to the per-query WebSocket URL\n     * instead of routing through the centralized hub endpoint.\n     * Defaults to false (use the centralized hub).\n     */\n    queryDirectMode: boolean;\n    /**\n     * Controls how observable query updates are transferred and exposed.\n     * {@link ObservableQueryTransferMode.Delta} (default) computes per-update deltas;\n     * {@link ObservableQueryTransferMode.Full} delivers the whole collection on every update.\n     */\n    observableQueryTransferMode: ObservableQueryTransferMode;\n    /**\n     * Callback that returns custom HTTP headers to include in hub transport requests\n     * (e.g. SSE subscribe/unsubscribe POST calls).\n     */\n    httpHeadersCallback: GetHttpHeaders;\n    /**\n     * Optional factory used to create the {@link EventSource} instances that back SSE\n     * observable query connections. Falls back to the global {@link EventSource}\n     * constructor when not set — override it to supply a custom SSE client (e.g. a\n     * native implementation on React Native, where the global constructor is unavailable).\n     */\n    eventSourceFactory?: EventSourceFactory;\n    /**\n     * How long in milliseconds to retain a query cache entry after the last subscriber\n     * releases it before evicting the subscription and the cached data.\n     *\n     * A non-zero value allows a user navigating away and back quickly to see cached\n     * data immediately instead of waiting for a fresh server round-trip.  The entry is\n     * still evicted once the window expires, so memory is eventually reclaimed.\n     *\n     * Defaults to 30 000 ms (30 seconds).  Set to 0 to restore the previous\n     * immediate-eviction behaviour.\n     */\n    queryCacheRetentionMs: number;\n}\n\nexport const Globals: IGlobals = {\n    microservice: '',\n    apiBasePath: '',\n    origin: '',\n    microserviceHttpHeader: 'x-cratis-microservice',\n    microserviceWSQueryArgument: 'x-cratis-microservice',\n    queryTransportMethod: QueryTransportMethod.WebSocket,\n    queryHttpMethod: QueryHttpMethod.Get,\n    queryConnectionCount: 1,\n    queryDirectMode: false,\n    observableQueryTransferMode: ObservableQueryTransferMode.Delta,\n    httpHeadersCallback: () => ({}),\n    queryCacheRetentionMs: 30_000,\n};"],"names":["ObservableQueryTransferMode","Globals","microservice","apiBasePath","origin","microserviceHttpHeader","microserviceWSQueryArgument","queryTransportMethod","QueryTransportMethod","WebSocket","queryHttpMethod","QueryHttpMethod","Get","queryConnectionCount","queryDirectMode","observableQueryTransferMode","httpHeadersCallback","queryCacheRetentionMs"],"mappings":";;;;;AAAA;AACA;AAQA;;;;;;;;;;IAWO,IAAKA,2BAAAA,iBAAAA,SAAAA,2BAAAA,EAAAA;+FACgF,2BAAA,CAAA,OAAA,CAAA,GAAA,OAAA;uDAExC,2BAAA,CAAA,MAAA,CAAA,GAAA,MAAA;AAHxCA,IAAAA,OAAAA,2BAAAA;AAKX,CAAA,CAAA,EAAA;MAkEYC,OAAAA,GAAoB;IAC7BC,YAAAA,EAAc,EAAA;IACdC,WAAAA,EAAa,EAAA;IACbC,MAAAA,EAAQ,EAAA;IACRC,sBAAAA,EAAwB,uBAAA;IACxBC,2BAAAA,EAA6B,uBAAA;AAC7BC,IAAAA,oBAAAA,EAAsBC,0CAAqBC,SAAS;AACpDC,IAAAA,eAAAA,EAAiBC,gCAAgBC,GAAG;IACpCC,oBAAAA,EAAsB,CAAA;IACtBC,eAAAA,EAAiB,KAAA;IACjBC,2BAA2B,EAAA,OAAA;IAC3BC,mBAAAA,EAAqB,KAAO,EAAC,CAAA;IAC7BC,qBAAAA,EAAuB;AAC3B;;;"}
+{"version":3,"file":"Globals.js","sources":["../../Globals.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 { GetHttpHeaders } from './GetHttpHeaders.js';\nimport { EventSourceFactory } from './EventSourceFactory.js';\nimport { QueryTransportMethod } from './queries/QueryTransportMethod.js';\nimport { QueryHttpMethod } from './queries/QueryHttpMethod.js';\nimport { QueryHttpMethodResolver } from './queries/QueryHttpMethodResolver.js';\n\n/**\n * Defines the transfer mode used for observable query subscriptions.\n *\n * - {@link ObservableQueryTransferMode.Delta} (default): Only the items that changed since\n *   the previous update (added, replaced, removed) are exposed via {@code useChangeStream}.\n *   The full collection state is still maintained internally by {@code useObservableQuery}.\n *\n * - {@link ObservableQueryTransferMode.Full}: Every update delivers the complete current\n *   collection. The change set returned by {@code useChangeStream} treats the entire new\n *   collection as {@code added} and the previous collection as {@code removed}.\n */\nexport enum ObservableQueryTransferMode {\n    /** Compute and expose only the items that changed since the previous update (default). */\n    Delta = 'delta',\n    /** Expose the full collection on every update. */\n    Full = 'full',\n}\n\nexport interface IGlobals {\n    microservice: string;\n    apiBasePath: string;\n    origin: string;\n    microserviceHttpHeader: string;\n    microserviceWSQueryArgument: string;\n    queryTransportMethod: QueryTransportMethod;\n    /**\n     * The HTTP method used to perform non-streaming queries. Defaults to {@link QueryHttpMethod.Get}.\n     * Set to {@link QueryHttpMethod.Query} to carry arguments in a JSON request body (RFC 10008)\n     * instead of the URL query string. Individual queries can override this via {@code setHttpMethod}.\n     */\n    queryHttpMethod: QueryHttpMethod;\n    /**\n     * Optional per-query policy for choosing the query HTTP method from the request (e.g. by URL length).\n     * Consulted only when a query has no explicit method set via {@code setHttpMethod}; it takes\n     * precedence over {@link queryHttpMethod}. See {@link lengthBasedQueryHttpMethod} for a built-in.\n     */\n    queryHttpMethodResolver?: QueryHttpMethodResolver;\n    /**\n     * Number of hub connections maintained for observable queries.\n     * When greater than one, queries are distributed across the pool round-robin.\n     * Only applies when {@link queryTransportMethod} is a centralized hub transport.\n     * Defaults to 1.\n     */\n    queryConnectionCount: number;\n    /**\n     * When true, observable queries connect directly to the per-query WebSocket URL\n     * instead of routing through the centralized hub endpoint.\n     * Defaults to false (use the centralized hub).\n     */\n    queryDirectMode: boolean;\n    /**\n     * Controls how observable query updates are transferred and exposed.\n     * {@link ObservableQueryTransferMode.Delta} (default) computes per-update deltas;\n     * {@link ObservableQueryTransferMode.Full} delivers the whole collection on every update.\n     */\n    observableQueryTransferMode: ObservableQueryTransferMode;\n    /**\n     * Callback that returns custom HTTP headers to include in hub transport requests\n     * (e.g. SSE subscribe/unsubscribe POST calls).\n     */\n    httpHeadersCallback: GetHttpHeaders;\n    /**\n     * Optional factory used to create the {@link EventSource} instances that back SSE\n     * observable query connections. Falls back to the global {@link EventSource}\n     * constructor when not set — override it to supply a custom SSE client (e.g. a\n     * native implementation on React Native, where the global constructor is unavailable).\n     */\n    eventSourceFactory?: EventSourceFactory;\n    /**\n     * How long in milliseconds to retain a query cache entry after the last subscriber\n     * releases it before evicting the subscription and the cached data.\n     *\n     * A non-zero value allows a user navigating away and back quickly to see cached\n     * data immediately instead of waiting for a fresh server round-trip.  The entry is\n     * still evicted once the window expires, so memory is eventually reclaimed.\n     *\n     * Defaults to 30 000 ms (30 seconds).  Set to 0 to restore the previous\n     * immediate-eviction behaviour.\n     */\n    queryCacheRetentionMs: number;\n}\n\nexport const Globals: IGlobals = {\n    microservice: '',\n    apiBasePath: '',\n    origin: '',\n    microserviceHttpHeader: 'x-cratis-microservice',\n    microserviceWSQueryArgument: 'x-cratis-microservice',\n    queryTransportMethod: QueryTransportMethod.WebSocket,\n    queryHttpMethod: QueryHttpMethod.Get,\n    queryConnectionCount: 1,\n    queryDirectMode: false,\n    observableQueryTransferMode: ObservableQueryTransferMode.Delta,\n    httpHeadersCallback: () => ({}),\n    queryCacheRetentionMs: 30_000,\n};"],"names":["ObservableQueryTransferMode","Globals","microservice","apiBasePath","origin","microserviceHttpHeader","microserviceWSQueryArgument","queryTransportMethod","QueryTransportMethod","WebSocket","queryHttpMethod","QueryHttpMethod","Get","queryConnectionCount","queryDirectMode","observableQueryTransferMode","httpHeadersCallback","queryCacheRetentionMs"],"mappings":";;;;;AAAA;AACA;AAQA;;;;;;;;;;IAWO,IAAKA,2BAAAA,iBAAAA,SAAAA,2BAAAA,EAAAA;+FACgF,2BAAA,CAAA,OAAA,CAAA,GAAA,OAAA;uDAExC,2BAAA,CAAA,MAAA,CAAA,GAAA,MAAA;AAHxCA,IAAAA,OAAAA,2BAAAA;AAKX,CAAA,CAAA,EAAA;MAkEYC,OAAAA,GAAoB;IAC7BC,YAAAA,EAAc,EAAA;IACdC,WAAAA,EAAa,EAAA;IACbC,MAAAA,EAAQ,EAAA;IACRC,sBAAAA,EAAwB,uBAAA;IACxBC,2BAAAA,EAA6B,uBAAA;AAC7BC,IAAAA,oBAAAA,EAAsBC,0CAAqBC,SAAS;AACpDC,IAAAA,eAAAA,EAAiBC,gCAAgBC,GAAG;IACpCC,oBAAAA,EAAsB,CAAA;IACtBC,eAAAA,EAAiB,KAAA;IACjBC,2BAA2B,EAAA,OAAA;IAC3BC,mBAAAA,EAAqB,KAAO,EAAC,CAAA;IAC7BC,qBAAAA,EAAuB;AAC3B;;;"}

package/dist/cjs/ICanBeConfigured.d.ts

@@ -0,0 +1,8 @@
+import { GetHttpHeaders } from './GetHttpHeaders.js';
+export interface ICanBeConfigured {
+    setMicroservice(microservice: string): any;
+    setApiBasePath(apiBasePath: string): void;
+    setOrigin(origin: string): void;
+    setHttpHeadersCallback(callback: GetHttpHeaders): void;
+}
+//# sourceMappingURL=ICanBeConfigured.d.ts.map

package/dist/cjs/ICanBeConfigured.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICanBeConfigured.d.ts","sourceRoot":"","sources":["../../ICanBeConfigured.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,MAAM,WAAW,gBAAgB;IAK7B,eAAe,CAAC,YAAY,EAAE,MAAM,OAAE;IAMtC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAM1C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAMhC,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;CAC1D"}

package/dist/cjs/UrlHelpers.d.ts

@@ -0,0 +1,9 @@
+export declare class UrlHelpers {
+    static createUrlFrom(origin: string, apiBasePath: string, route: string): URL;
+    static replaceRouteParameters<T extends object>(route: string, parameters?: T): {
+        route: string;
+        unusedParameters: Partial<T>;
+    };
+    static buildQueryParams(unusedParameters: object, additionalParams?: Record<string, string | number>): URLSearchParams;
+}
+//# sourceMappingURL=UrlHelpers.d.ts.map

package/dist/cjs/UrlHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlHelpers.d.ts","sourceRoot":"","sources":["../../UrlHelpers.ts"],"names":[],"mappings":"AAeA,qBAAa,UAAU;IAQnB,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAM5E;IASD,MAAM,CAAC,sBAAsB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,CAyB9H;IASD,MAAM,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,eAAe,CAsBrH;CACJ"}

package/dist/cjs/commands/Command.d.ts

@@ -0,0 +1,46 @@
+import { ICommand, PropertyChanged } from './ICommand.js';
+import { CommandResult } from "./CommandResult.js";
+import { CommandValidator } from './CommandValidator.js';
+import { Constructor } from '@cratis/fundamentals';
+import { GetHttpHeaders } from '../GetHttpHeaders.js';
+import { PropertyDescriptor } from '../reflection/PropertyDescriptor.js';
+import { ValidationResultSeverity } from '../validation/ValidationResultSeverity.js';
+export declare abstract class Command<TCommandContent = object, TCommandResponse = object> implements ICommand<TCommandContent, TCommandResponse> {
+    readonly _responseType: Constructor;
+    readonly _isResponseTypeEnumerable: boolean;
+    private _microservice;
+    private _apiBasePath;
+    private _origin;
+    private _httpHeadersCallback;
+    abstract readonly route: string;
+    readonly validation?: CommandValidator<any>;
+    readonly roles: string[];
+    readonly blockOnValidationSeverity?: ValidationResultSeverity;
+    abstract readonly propertyDescriptors: PropertyDescriptor[];
+    abstract get requestParameters(): string[];
+    private _initialValues;
+    private _hasChanges;
+    private _callbacks;
+    constructor(_responseType: Constructor | undefined, _isResponseTypeEnumerable: boolean);
+    setMicroservice(microservice: string): void;
+    setApiBasePath(apiBasePath: string): void;
+    setOrigin(origin: string): void;
+    setHttpHeadersCallback(callback: GetHttpHeaders): void;
+    execute(allowedSeverity?: ValidationResultSeverity, ignoreWarnings?: boolean): Promise<CommandResult<TCommandResponse>>;
+    validate(): Promise<CommandResult<TCommandResponse>>;
+    validateClientSide(): CommandResult<TCommandResponse>;
+    private buildPayload;
+    private validateRequiredProperties;
+    private filterValidationResultsBySeverity;
+    private buildHeaders;
+    private performRequest;
+    clear(): void;
+    setInitialValues(values: TCommandContent): void;
+    setInitialValuesFromCurrentValues(): void;
+    revertChanges(): void;
+    get hasChanges(): boolean;
+    propertyChanged(property: string): void;
+    onPropertyChanged(callback: PropertyChanged, thisArg: object): void;
+    private updateHasChanges;
+}
+//# sourceMappingURL=Command.d.ts.map

package/dist/cjs/commands/Command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../../commands/Command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAkB,MAAM,sBAAsB,CAAC;AAInE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAUrF,8BAAsB,OAAO,CAAC,eAAe,GAAG,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAE,YAAW,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAwBzH,QAAQ,CAAC,aAAa,EAAE,WAAW;IAAW,QAAQ,CAAC,yBAAyB,EAAE,OAAO;IAvBrG,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAE5C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAE9B,QAAQ,CAAC,yBAAyB,CAAC,EAAE,wBAAwB,CAAC;IAC9D,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC5D,QAAQ,KAAK,iBAAiB,IAAI,MAAM,EAAE,CAAC;IAE3C,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAkB;IAOpC,YAAqB,aAAa,EAAE,WAAW,YAAS,EAAW,yBAAyB,EAAE,OAAO,EAKpG;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;IAGK,OAAO,CAAC,eAAe,CAAC,EAAE,wBAAwB,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAwB5H;IAGK,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CA2BzD;IAGD,kBAAkB,IAAI,aAAa,CAAC,gBAAgB,CAAC,CAkBpD;IAED,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,iCAAiC;IAczC,OAAO,CAAC,YAAY;YAuBN,cAAc;IA+B5B,KAAK,IAAI,IAAI,CAOZ;IAGD,gBAAgB,CAAC,MAAM,EAAE,eAAe,QASvC;IAGD,iCAAiC,SAQhC;IAGD,aAAa,IAAI,IAAI,CAKpB;IAGD,IAAI,UAAU,YAEb;IAGD,eAAe,CAAC,QAAQ,EAAE,MAAM,QAY/B;IAGD,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,QAK3D;IAED,OAAO,CAAC,gBAAgB;CAM3B"}

package/dist/cjs/commands/Command.js

@@ -21,6 +21,7 @@ var ValidationResultSeverity = require('../validation/ValidationResultSeverity.j
     _httpHeadersCallback;
     /* eslint-disable @typescript-eslint/no-explicit-any */ validation;
     /* eslint-enable @typescript-eslint/no-explicit-any */ roles = [];
+    /** Inclusive minimum blocking severity declared by a model-bound command proxy. */ blockOnValidationSeverity;
     _initialValues = {};
     _hasChanges = false;
     _callbacks = [];
@@ -71,12 +72,14 @@ var ValidationResultSeverity = require('../validation/ValidationResultSeverity.j
     }
     /** @inheritdoc */ async validate() {
         const clientValidationErrors = this.validation?.validate(this) || [];
-        if (clientValidationErrors.length > 0) {
-            return CommandResult.CommandResult.validationFailed(clientValidationErrors);
+        const filteredClientErrors = this.blockOnValidationSeverity === undefined ? clientValidationErrors : this.filterValidationResultsBySeverity(clientValidationErrors);
+        if (filteredClientErrors.length > 0) {
+            return CommandResult.CommandResult.validationFailed(filteredClientErrors);
         }
         const validationErrors = this.validateRequiredProperties();
-        if (validationErrors.length > 0) {
-            return CommandResult.CommandResult.validationFailed(validationErrors);
+        const filteredRequiredErrors = this.blockOnValidationSeverity === undefined ? validationErrors : this.filterValidationResultsBySeverity(validationErrors);
+        if (filteredRequiredErrors.length > 0) {
+            return CommandResult.CommandResult.validationFailed(filteredRequiredErrors);
         }
         let actualRoute = this.route;
         if (this.requestParameters && this.requestParameters.length > 0) {
@@ -89,12 +92,14 @@ var ValidationResultSeverity = require('../validation/ValidationResultSeverity.j
     }
     /** @inheritdoc */ validateClientSide() {
         const clientValidationErrors = this.validation?.validate(this) || [];
-        if (clientValidationErrors.length > 0) {
-            return CommandResult.CommandResult.validationFailed(clientValidationErrors);
+        const filteredClientErrors = this.blockOnValidationSeverity === undefined ? clientValidationErrors : this.filterValidationResultsBySeverity(clientValidationErrors);
+        if (filteredClientErrors.length > 0) {
+            return CommandResult.CommandResult.validationFailed(filteredClientErrors);
         }
         const validationErrors = this.validateRequiredProperties();
-        if (validationErrors.length > 0) {
-            return CommandResult.CommandResult.validationFailed(validationErrors);
+        const filteredRequiredErrors = this.blockOnValidationSeverity === undefined ? validationErrors : this.filterValidationResultsBySeverity(validationErrors);
+        if (filteredRequiredErrors.length > 0) {
+            return CommandResult.CommandResult.validationFailed(filteredRequiredErrors);
         }
         return CommandResult.CommandResult.empty;
     }
@@ -121,6 +126,10 @@ var ValidationResultSeverity = require('../validation/ValidationResultSeverity.j
         return validationErrors;
     }
     filterValidationResultsBySeverity(validationResults, allowedSeverity, ignoreWarnings) {
+        if (this.blockOnValidationSeverity !== undefined) {
+            const effectiveAllowed = Math.min(allowedSeverity ?? ValidationResultSeverity.ValidationResultSeverity.Error, this.blockOnValidationSeverity - 1);
+            return validationResults.filter((result)=>result.severity === ValidationResultSeverity.ValidationResultSeverity.Unknown || result.severity > effectiveAllowed);
+        }
         if (ignoreWarnings === true) {
             return validationResults.filter((result)=>result.severity === ValidationResultSeverity.ValidationResultSeverity.Error);
         }