Reject in-memory sorting on complex fields

ContractTests/Client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cratis/arc.core-client-contract",
-  "version": "0.57.0",
+  "version": "0.57.1",
   "private": true,
   "type": "module",
   "dependencies": {

ContractTests/ProxyComparison/Snapshots/TypeScript/ProxyComparison/All.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: ProxyComparison.Listing.All. Time: 2026-10-02T15:23:26.2840000Z. Hash: DDEC51C0B1FCDD19940A0B638DF8AC2402F8EA3BC633F8A17F60F25321244CEF
+// @generated by Cratis. Source: ProxyComparison.Listing.All. Time: 2026-10-02T18:11:17.1450000Z. Hash: 60B4AB9724378EB1EBFF52DBF33EFA71B421A6633AB7316132F18F9B79CACFB1
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/
@@ -13,7 +13,9 @@ import { Listing } from './Listing';
 
 class AllSortBy {
     readonly name: SortingActionsForQuery<Listing[]>;
+    /** @deprecated In-memory sorting on this field is rejected; database providers sort it by their own order. This helper will be removed in the next major release (https://github.com/Cratis/Arc.TypeScript/issues/177). Sort on a scalar field instead. */
     readonly detail: SortingActionsForQuery<Listing[]>;
+    /** @deprecated In-memory sorting on this field is rejected; database providers sort it by their own order. This helper will be removed in the next major release (https://github.com/Cratis/Arc.TypeScript/issues/177). Sort on a scalar field instead. */
     readonly notice: SortingActionsForQuery<Listing[]>;
     readonly status: SortingActionsForQuery<Listing[]>;
     constructor(readonly query: All) {
@@ -25,7 +27,9 @@ class AllSortBy {
 }
 class AllSortByWithoutQuery {
     readonly name = new SortingActions('name');
+    /** @deprecated In-memory sorting on this field is rejected; database providers sort it by their own order. This helper will be removed in the next major release (https://github.com/Cratis/Arc.TypeScript/issues/177). Sort on a scalar field instead. */
     readonly detail = new SortingActions('detail');
+    /** @deprecated In-memory sorting on this field is rejected; database providers sort it by their own order. This helper will be removed in the next major release (https://github.com/Cratis/Arc.TypeScript/issues/177). Sort on a scalar field instead. */
     readonly notice = new SortingActions('notice');
     readonly status = new SortingActions('status');
 }

ContractTests/ProxyComparison/Snapshots/TypeScript/ProxyComparison/Observe.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: ProxyComparison.Listing.Observe. Time: 2026-10-02T15:23:26.2860000Z. Hash: 4B563871A5AF1853D3C85AB5D3A3AF5882D395039B02DCAC180B733C4E641B96
+// @generated by Cratis. Source: ProxyComparison.Listing.Observe. Time: 2026-10-02T18:11:17.1480000Z. Hash: 24D10616E40D92A9E4CF9E4758F280A66CD87BA96AE162492F39CDFF4C267099
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/
@@ -13,7 +13,9 @@ import { Listing } from './Listing';
 
 class ObserveSortBy {
     readonly name: SortingActionsForObservableQuery<Listing[]>;
+    /** @deprecated In-memory sorting on this field is rejected; database providers sort it by their own order. This helper will be removed in the next major release (https://github.com/Cratis/Arc.TypeScript/issues/177). Sort on a scalar field instead. */
     readonly detail: SortingActionsForObservableQuery<Listing[]>;
+    /** @deprecated In-memory sorting on this field is rejected; database providers sort it by their own order. This helper will be removed in the next major release (https://github.com/Cratis/Arc.TypeScript/issues/177). Sort on a scalar field instead. */
     readonly notice: SortingActionsForObservableQuery<Listing[]>;
     readonly status: SortingActionsForObservableQuery<Listing[]>;
     constructor(readonly query: Observe) {
@@ -25,7 +27,9 @@ class ObserveSortBy {
 }
 class ObserveSortByWithoutQuery {
     readonly name = new SortingActions('name');
+    /** @deprecated In-memory sorting on this field is rejected; database providers sort it by their own order. This helper will be removed in the next major release (https://github.com/Cratis/Arc.TypeScript/issues/177). Sort on a scalar field instead. */
     readonly detail = new SortingActions('detail');
+    /** @deprecated In-memory sorting on this field is rejected; database providers sort it by their own order. This helper will be removed in the next major release (https://github.com/Cratis/Arc.TypeScript/issues/177). Sort on a scalar field instead. */
     readonly notice = new SortingActions('notice');
     readonly status = new SortingActions('status');
 }

ContractTests/ProxyComparison/differences.json

@@ -24,7 +24,7 @@
     "complex-sorting": {
       "category": "knownLimitation",
       "issue": "https://github.com/Cratis/Arc.TypeScript/issues/174",
-      "description": "Both generators emit helpers for complex result fields when generating result-oriented helpers (TypeScript here; .NET controller-based queries). Fields such as detail and notice are not sortable scalars: these fixture objects sort as no-ops on the TypeScript server and throw on .NET IQueryable. The model-bound .NET snapshot's query-parameter defect masks this separate limitation."
+      "description": "The .NET controller-based generator still emits helpers for complex result fields, which throw on .NET IQueryable; its model-bound snapshot's query-parameter defect masks that limitation. TypeScript retains detail/notice helpers for compatibility but deprecates them for removal in the next major release (https://github.com/Cratis/Arc.TypeScript/issues/177), and rejects in-memory sorting on these complex fields with the existing malformedRequest validation result. Database providers retain their own ordering; scalar helpers are unchanged."
     },
     "enum-names": {
       "category": "intentional",
@@ -38,8 +38,8 @@
   "limitations": ["complex-sorting"],
   "files": {
     "ProxyComparison/All.ts": {
-      "pairSha256": "7f6c29c8163e0a4f1f4cb891d3cbcc27cab70dd8b7a244c9c6851d1282854687",
-      "reasons": ["layout", "imports", "query-source", "sorting"]
+      "pairSha256": "d8e61bfa0dd8347d4b70abe98d60161de95cf1307046d02626e8bf2bd5c10592",
+      "reasons": ["layout", "imports", "query-source", "sorting", "complex-sorting"]
     },
     "ProxyComparison/Detail.ts": {
       "pairSha256": "80d080af34fba46f349ebfc4821d5d6f3a82eeb57f48787bf7a1fc228ee29dfd",
@@ -50,8 +50,8 @@
       "reasons": ["layout"]
     },
     "ProxyComparison/Observe.ts": {
-      "pairSha256": "a2a3cf002cb13ab725443374c48b0b66d93bf380345af43869c136b54ab5c65e",
-      "reasons": ["layout", "imports", "query-source", "sorting"]
+      "pairSha256": "3cf3ce2d59571f12b9164791985f40f0a7bacbddf4f503955cd7f4547ccbdd76",
+      "reasons": ["layout", "imports", "query-source", "sorting", "complex-sorting"]
     },
     "ProxyComparison/Register.ts": {
       "pairSha256": "a624987ea1833732cbc7169c96c1ca68f7159bd74bb44e3014a1f010e11d07dc",