@ultimat3/query 27.3.0 → 27.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/query",
-  "version": "27.3.0",
+  "version": "27.5.0",
   "description": "The query primitive: a policy-checked read, optionally live, with cursor pagination and an incremental matcher",
   "license": "MIT",
   "type": "module",
@@ -37,11 +37,11 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/cache": "27.3.0",
-    "@ultimat3/core": "27.3.0",
-    "@ultimat3/entity": "27.3.0",
-    "@ultimat3/http": "27.3.0",
-    "@ultimat3/policy": "27.3.0",
-    "@ultimat3/schema": "27.3.0"
+    "@ultimat3/cache": "27.5.0",
+    "@ultimat3/core": "27.5.0",
+    "@ultimat3/entity": "27.5.0",
+    "@ultimat3/http": "27.5.0",
+    "@ultimat3/policy": "27.5.0",
+    "@ultimat3/schema": "27.5.0"
   }
 }

package/src/client.ts

@@ -6,8 +6,9 @@
  *
  * Every read goes through `@ultimat3/core`'s `clientTransport`, the one browser HTTP function —
  * there is no `fetch` call here, only the injected `fetch` option handed on as `fetchImpl`. Rows
- * are handed back as parsed: an instant reaches a caller as the ISO string `JSON.stringify` wrote,
- * and a surface that formats one converts at its own edge. A record envelope is unwrapped by the
+ * are handed back as parsed, with every value the server answered as a `Date` revived as one — the
+ * route names them in `x-ultimate-dates` (`@ultimat3/core`'s `wire-dates.ts`), so a row typed
+ * `Date` is a `Date` here, and never an ISO string to convert. A record envelope is unwrapped by the
  * transport, its rows adopted into the page's store, so the return type is the rows either way.
  *
  * `ClientFlight` is a TYPE here and never a value: dedup, retry, the deadline and the fence are

package/src/record-answer.ts

@@ -8,7 +8,7 @@
  */
 
 import type { RecordRows, Row } from '@ultimat3/core';
-import { encodeRecordEnvelope, RECORDS_HEADER } from '@ultimat3/core';
+import { DATES_HEADER, encodeRecordEnvelope, RECORDS_HEADER, wireDatePaths } from '@ultimat3/core';
 import { hasEntityRows, rowsOf } from '@ultimat3/entity';
 import { jsonResponse } from '@ultimat3/http';
 import type { StandardSchemaV1 } from '@ultimat3/schema';
@@ -23,25 +23,35 @@ export type RecordAnswer = (answer: readonly object[] | Page<object>) => Respons
  * `Page` — is the route's, not the declaration's.
  */
 export function recordAnswerFor(rows: StandardSchemaV1 | undefined): RecordAnswer {
-  if (!answersRecords(rows)) return (answer) => jsonResponse(answer);
+  if (!answersRecords(rows)) return (answer) => jsonResponse(answer, datesOf(answer));
   return (answer) => {
     const records = collect(rows, isPage(answer) ? answer.rows : answer);
     return jsonResponse(encodeRecordEnvelope(answer, records), {
-      headers: { [RECORDS_HEADER]: '1' },
+      headers: { [RECORDS_HEADER]: '1', ...datesOf(answer).headers },
     });
   };
 }
 
+/**
+ * The instants of a read's DATA — the rows, the `Page` or the one row — by path
+ * (`@ultimat3/core`'s `wire-dates.ts`), so the typed client hands back the `Date` the row type
+ * promises. A header, never the body: the body and the OpenAPI document stay what they were.
+ */
+function datesOf(data: unknown): { readonly headers: Record<string, string> } {
+  const dates = wireDatePaths(data);
+  return { headers: dates === undefined ? {} : { [DATES_HEADER]: dates } };
+}
+
 /**
  * The same decision for a `single: true` read, whose answer is ONE row: the row itself, or the
  * envelope with that row as `data` and its records beside it — the shape an action's record wire
  * answers for a single output, so the transport unwraps both the same way.
  */
 export function recordRowAnswerFor(rows: StandardSchemaV1 | undefined): (row: object) => Response {
-  if (!answersRecords(rows)) return (row) => jsonResponse(row);
+  if (!answersRecords(rows)) return (row) => jsonResponse(row, datesOf(row));
   return (row) =>
     jsonResponse(encodeRecordEnvelope(row, collect(rows, [row])), {
-      headers: { [RECORDS_HEADER]: '1' },
+      headers: { [RECORDS_HEADER]: '1', ...datesOf(row).headers },
     });
 }