@cratis/arc 22.139.0 → 22.140.0

package/dist/esm/validation/ValidationResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ValidationResult.d.ts","sourceRoot":"","sources":["../../../validation/ValidationResult.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAOzE,qBAAa,gBAAgB;IAarB,QAAQ,CAAC,QAAQ,EAAE,wBAAwB;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE;IAC1B,QAAQ,CAAC,KAAK,EAAE,GAAG;IACnB,QAAQ,CAAC,MAAM,EAAE,sBAAsB;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;IANlC,YACa,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,GAAG,EACV,MAAM,GAAE,sBAAoD,EAC5D,YAAY,CAAC,EAAE,MAAM,YAAA,EACjC;CACJ"}
+{"version":3,"file":"ValidationResult.d.ts","sourceRoot":"","sources":["../../../validation/ValidationResult.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AASzE,qBAAa,gBAAgB;IAcrB,QAAQ,CAAC,QAAQ,EAAE,wBAAwB;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE;IAC1B,QAAQ,CAAC,KAAK,EAAE,GAAG;IACnB,QAAQ,CAAC,MAAM,EAAE,sBAAsB;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;IANlC,YACa,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,GAAG,EACV,MAAM,GAAE,sBAAoD,EAC5D,YAAY,CAAC,EAAE,MAAM,YAAA,EACjC;CACJ"}

package/dist/esm/validation/ValidationResult.js

@@ -4,6 +4,8 @@ import { ValidationResultReason } from './ValidationResultReason.js';
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 /* eslint-disable @typescript-eslint/no-explicit-any */ /**
  * Represents a validation error with a message for one or more members.
+ * Client-generated missing required properties use `rule` with `ValidationResultReasonDetail.Required`.
+ * Their messages are framework diagnostics, not application-authored user-facing copy.
  */ class ValidationResult {
     severity;
     message;
@@ -14,7 +16,8 @@ import { ValidationResultReason } from './ValidationResultReason.js';
     /**
      * Initializes a new instance of the {@link ValidationResult} class.
      * @param severity The severity of the result.
-     * @param message The message. A developer diagnostic when {@link reason} is anything but `rule`.
+     * @param message The message. A developer diagnostic when {@link reason} is anything but `rule`,
+     * or when the client supplies the `Required` reasonDetail.
      * @param members The members the result is attributed to.
      * @param state State associated with the result - the rule author's, carried straight through.
      * @param reason What composed the result. Defaults to `rule`, meaning an authored rule rejected the input.

package/dist/esm/validation/ValidationResult.js.map

@@ -1 +1 @@
-{"version":3,"file":"ValidationResult.js","sources":["../../../validation/ValidationResult.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 { ValidationResultReason } from './ValidationResultReason.js';\nimport { ValidationResultSeverity } from './ValidationResultSeverity.js';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Represents a validation error with a message for one or more members.\n */\nexport class ValidationResult {\n    /**\n     * Initializes a new instance of the {@link ValidationResult} class.\n     * @param severity The severity of the result.\n     * @param message The message. A developer diagnostic when {@link reason} is anything but `rule`.\n     * @param members The members the result is attributed to.\n     * @param state State associated with the result - the rule author's, carried straight through.\n     * @param reason What composed the result. Defaults to `rule`, meaning an authored rule rejected the input.\n     * @param reasonDetail Which specific thing within {@link reason} produced the result - the name of the violated\n     * constraint for `constraintViolation`, for instance. Undefined when the reason carries no finer identity.\n     * Branch on this rather than matching {@link message}, which is prose and free to change.\n     */\n    constructor(\n        readonly severity: ValidationResultSeverity,\n        readonly message: string,\n        readonly members: string[],\n        readonly state: any,\n        readonly reason: ValidationResultReason = ValidationResultReason.Rule,\n        readonly reasonDetail?: string) {\n    }\n}\n"],"names":["ValidationResult","reason","ValidationResultReason","Rule","reasonDetail","severity","message","members","state"],"mappings":";;AAAA;AACA;AAKA;;AAIC,IACM,MAAMA,gBAAAA,CAAAA;;;;;;;AACT;;;;;;;;;;QAWA,WAAA,CACI,QAA2C,EAC3C,OAAwB,EACxB,OAA0B,EAC1B,KAAmB,EACnB,MAASC,GAAiCC,sBAAAA,CAAuBC,IAAI,EAC5DC,YAAqB,CAAE;aALvBC,QAAAA,GAAAA,QAAAA;aACAC,OAAAA,GAAAA,OAAAA;aACAC,OAAAA,GAAAA,OAAAA;aACAC,KAAAA,GAAAA,KAAAA;aACAP,MAAAA,GAAAA,MAAAA;aACAG,YAAAA,GAAAA,YAAAA;AACb,IAAA;AACJ;;"}
+{"version":3,"file":"ValidationResult.js","sources":["../../../validation/ValidationResult.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 { ValidationResultReason } from './ValidationResultReason.js';\nimport { ValidationResultSeverity } from './ValidationResultSeverity.js';\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Represents a validation error with a message for one or more members.\n * Client-generated missing required properties use `rule` with `ValidationResultReasonDetail.Required`.\n * Their messages are framework diagnostics, not application-authored user-facing copy.\n */\nexport class ValidationResult {\n    /**\n     * Initializes a new instance of the {@link ValidationResult} class.\n     * @param severity The severity of the result.\n     * @param message The message. A developer diagnostic when {@link reason} is anything but `rule`,\n     * or when the client supplies the `Required` reasonDetail.\n     * @param members The members the result is attributed to.\n     * @param state State associated with the result - the rule author's, carried straight through.\n     * @param reason What composed the result. Defaults to `rule`, meaning an authored rule rejected the input.\n     * @param reasonDetail Which specific thing within {@link reason} produced the result - the name of the violated\n     * constraint for `constraintViolation`, for instance. Undefined when the reason carries no finer identity.\n     * Branch on this rather than matching {@link message}, which is prose and free to change.\n     */\n    constructor(\n        readonly severity: ValidationResultSeverity,\n        readonly message: string,\n        readonly members: string[],\n        readonly state: any,\n        readonly reason: ValidationResultReason = ValidationResultReason.Rule,\n        readonly reasonDetail?: string) {\n    }\n}\n"],"names":["ValidationResult","reason","ValidationResultReason","Rule","reasonDetail","severity","message","members","state"],"mappings":";;AAAA;AACA;AAKA;;;;AAMC,IACM,MAAMA,gBAAAA,CAAAA;;;;;;;AACT;;;;;;;;;;;QAYA,WAAA,CACI,QAA2C,EAC3C,OAAwB,EACxB,OAA0B,EAC1B,KAAmB,EACnB,MAASC,GAAiCC,sBAAAA,CAAuBC,IAAI,EAC5DC,YAAqB,CAAE;aALvBC,QAAAA,GAAAA,QAAAA;aACAC,OAAAA,GAAAA,OAAAA;aACAC,OAAAA,GAAAA,OAAAA;aACAC,KAAAA,GAAAA,KAAAA;aACAP,MAAAA,GAAAA,MAAAA;aACAG,YAAAA,GAAAA,YAAAA;AACb,IAAA;AACJ;;"}

package/dist/esm/validation/ValidationResultReasonDetail.d.ts

@@ -0,0 +1,4 @@
+export declare const ValidationResultReasonDetail: {
+    readonly Required: 'Required';
+};
+//# sourceMappingURL=ValidationResultReasonDetail.d.ts.map

package/dist/esm/validation/ValidationResultReasonDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationResultReasonDetail.d.ts","sourceRoot":"","sources":["../../../validation/ValidationResultReasonDetail.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,4BAA4B;aAKrC,QAAQ,EAAE,UAAU;CACd,CAAC"}

package/dist/esm/validation/ValidationResultReasonDetail.js

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Holds well-known finer identities within a validation result's reason.
+ */ const ValidationResultReasonDetail = {
+    /**
+     * The client found a missing required command property. Used with `rule`.
+     * The message is framework-authored; map it to your own user-facing copy.
+     */ Required: 'Required'
+};
+
+export { ValidationResultReasonDetail };
+//# sourceMappingURL=ValidationResultReasonDetail.js.map

package/dist/esm/validation/ValidationResultReasonDetail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationResultReasonDetail.js","sources":["../../../validation/ValidationResultReasonDetail.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/**\n * Holds well-known finer identities within a validation result's reason.\n */\nexport const ValidationResultReasonDetail = {\n    /**\n     * The client found a missing required command property. Used with `rule`.\n     * The message is framework-authored; map it to your own user-facing copy.\n     */\n    Required: 'Required'\n} as const;\n"],"names":["ValidationResultReasonDetail","Required"],"mappings":"AAAA;AACA;AAEA;;UAGaA,4BAAAA,GAA+B;AACxC;;;AAGC,QACDC,QAAAA,EAAU;AACd;;"}

package/dist/esm/validation/index.d.ts

@@ -1,6 +1,7 @@
 export * from './Validator.js';
 export * from './ValidationResult.js';
 export * from './ValidationResultReason.js';
+export * from './ValidationResultReasonDetail.js';
 export * from './ValidationResultSeverity.js';
 export * from './IValidationRule.js';
 export * from './PropertyValidator.js';

package/dist/esm/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../validation/index.ts"],"names":[],"mappings":"AAGA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../validation/index.ts"],"names":[],"mappings":"AAGA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC"}

package/dist/esm/validation/index.js

@@ -1,6 +1,7 @@
 export { Validator } from './Validator.js';
 export { ValidationResult } from './ValidationResult.js';
 export { ValidationResultReason } from './ValidationResultReason.js';
+export { ValidationResultReasonDetail } from './ValidationResultReasonDetail.js';
 export { ValidationResultSeverity } from './ValidationResultSeverity.js';
 export { PropertyValidator } from './PropertyValidator.js';
 export { PropertyRule } from './PropertyRule.js';

package/dist/esm/validation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../validation/index.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\nexport * from './Validator.js';\nexport * from './ValidationResult.js';\nexport * from './ValidationResultReason.js';\nexport * from './ValidationResultSeverity.js';\nexport * from './IValidationRule.js';\nexport * from './PropertyValidator.js';\nexport * from './PropertyRule.js';\nexport * from './RuleBuilder.js';\nexport * from './RuleBuilderExtensions.js';\nexport * from './rules/NotEmptyRule.js';\nexport * from './rules/LengthRules.js';\nexport * from './rules/EmailRule.js';\nexport * from './rules/RegexRule.js';\nexport * from './rules/ComparisonRules.js';\n"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA;AACA"}
+{"version":3,"file":"index.js","sources":["../../../validation/index.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\nexport * from './Validator.js';\nexport * from './ValidationResult.js';\nexport * from './ValidationResultReason.js';\nexport * from './ValidationResultReasonDetail.js';\nexport * from './ValidationResultSeverity.js';\nexport * from './IValidationRule.js';\nexport * from './PropertyValidator.js';\nexport * from './PropertyRule.js';\nexport * from './RuleBuilder.js';\nexport * from './RuleBuilderExtensions.js';\nexport * from './rules/NotEmptyRule.js';\nexport * from './rules/LengthRules.js';\nexport * from './rules/EmailRule.js';\nexport * from './rules/RegexRule.js';\nexport * from './rules/ComparisonRules.js';\n"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA;AACA"}

package/for_UrlHelpers/when_building_query_params/with_object_values.ts

@@ -0,0 +1,30 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, it } from 'vitest';
+import { UrlHelpers } from '../../UrlHelpers.js';
+
+const parts = { quoted: '"abc"', number: '42', comma: 'a,b' };
+
+describe('when building query params with dictionary values', () => {
+    it('should encode one JSON object value', () => {
+        const result = UrlHelpers.buildQueryParams({ parts });
+        result.getAll('parts').should.deep.equal([JSON.stringify(parts)]);
+    });
+
+    it('should serialize an empty dictionary', () => {
+        UrlHelpers.buildQueryParams({ parts: {} }).get('parts')!.should.equal('{}');
+    });
+
+    it('should preserve existing route parameter serialization', () => {
+        const result = UrlHelpers.replaceRouteParameters('/parts/{parts}', { parts });
+        result.route.should.equal('/parts/%5Bobject%20Object%5D');
+    });
+
+    it('should preserve existing scalar and array serialization', () => {
+        const result = UrlHelpers.buildQueryParams({ count: 42, enabled: true, names: ['a', 'b'] });
+        result.get('count')!.should.equal('42');
+        result.get('enabled')!.should.equal('true');
+        result.getAll('names').should.deep.equal(['a', 'b']);
+    });
+});

package/package.json

@@ -1,7 +1,7 @@
 {
     "type": "module",
     "name": "@cratis/arc",
-    "version": "22.139.0",
+    "version": "22.140.0",
     "description": "TypeScript command, query, validation, identity, and messaging runtime for Cratis Arc — the CQRS application framework for ASP.NET Core — used by generated proxies.",
     "keywords": [
         "cratis",

package/queries/ObservableQueryMultiplexer.ts

@@ -7,6 +7,7 @@ import { DataReceived } from './ObservableQueryConnection.js';
 import { SubscriptionRequest } from './WebSocketHubConnection.js';
 import { Globals } from '../Globals.js';
 import { MultiplexerConnectionState } from './ObservableQueryDiagnosticsSnapshot.js';
+import { formatObjectQueryValue } from '../UrlHelpers.js';
 
 /* eslint-disable @typescript-eslint/no-explicit-any */
 
@@ -128,7 +129,7 @@ export class ObservableQueryMultiplexer {
         for (const [key, value] of Object.entries(a)) {
             if (pagingAndSortingKeys.has(key)) continue;
             if (value === undefined || value === null) continue;
-            remaining[key] = String(value);
+            remaining[key] = formatObjectQueryValue(value);
             hasRemaining = true;
         }
 

package/queries/for_ObservableQueryMultiplexer/when_building_a_subscription_request/with_dictionary_values.ts

@@ -0,0 +1,27 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, it } from 'vitest';
+import { ObservableQueryMultiplexer } from '../../ObservableQueryMultiplexer.js';
+import { SubscriptionRequest } from '../../WebSocketHubConnection.js';
+
+const parts = { quoted: '"abc"', number: '42', comma: 'a,b' };
+
+describe('when building a subscription request with dictionary values', () => {
+    it('should send the dictionary as one JSON string argument', () => {
+        let received: SubscriptionRequest | undefined;
+        const multiplexer = new ObservableQueryMultiplexer(1, () => ({
+            queryCount: 0, lastPingLatency: 0, averageLatency: 0, isConnected: false,
+            subscribe: (_id, request) => { received = request; },
+            unsubscribe: () => {}, dispose: () => {}
+        }));
+        const date = new Date('2026-10-24T10:00:00Z');
+        const unsubscribe = multiplexer.subscribe('Parts.Get', { parts, count: 42, names: ['a', 'b'], date }, () => {});
+        received!.arguments!.parts!.should.equal(JSON.stringify(parts));
+        received!.arguments!.count!.should.equal('42');
+        received!.arguments!.names!.should.equal('a,b');
+        received!.arguments!.date!.should.equal(String(date));
+        unsubscribe();
+        multiplexer.dispose();
+    });
+});

package/validation/ValidationResult.ts

@@ -8,12 +8,15 @@ import { ValidationResultSeverity } from './ValidationResultSeverity.js';
 
 /**
  * Represents a validation error with a message for one or more members.
+ * Client-generated missing required properties use `rule` with `ValidationResultReasonDetail.Required`.
+ * Their messages are framework diagnostics, not application-authored user-facing copy.
  */
 export class ValidationResult {
     /**
      * Initializes a new instance of the {@link ValidationResult} class.
      * @param severity The severity of the result.
-     * @param message The message. A developer diagnostic when {@link reason} is anything but `rule`.
+     * @param message The message. A developer diagnostic when {@link reason} is anything but `rule`,
+     * or when the client supplies the `Required` reasonDetail.
      * @param members The members the result is attributed to.
      * @param state State associated with the result - the rule author's, carried straight through.
      * @param reason What composed the result. Defaults to `rule`, meaning an authored rule rejected the input.

package/validation/ValidationResultReasonDetail.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * Holds well-known finer identities within a validation result's reason.
+ */
+export const ValidationResultReasonDetail = {
+    /**
+     * The client found a missing required command property. Used with `rule`.
+     * The message is framework-authored; map it to your own user-facing copy.
+     */
+    Required: 'Required'
+} as const;

package/validation/index.ts

@@ -4,6 +4,7 @@
 export * from './Validator.js';
 export * from './ValidationResult.js';
 export * from './ValidationResultReason.js';
+export * from './ValidationResultReasonDetail.js';
 export * from './ValidationResultSeverity.js';
 export * from './IValidationRule.js';
 export * from './PropertyValidator.js';