@ultimat3/manifest 29.3.1 → 29.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/manifest",
-  "version": "29.3.1",
+  "version": "29.4.0",
   "description": "x.manifest.json: deterministic generated facts, contract diff, AGENTS.md budget",
   "license": "MIT",
   "type": "module",
@@ -32,11 +32,11 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/action": "29.3.1",
-    "@ultimat3/core": "29.3.1",
-    "@ultimat3/entity": "29.3.1",
-    "@ultimat3/jobs": "29.3.1",
-    "@ultimat3/query": "29.3.1",
-    "@ultimat3/realtime": "29.3.1"
+    "@ultimat3/action": "29.4.0",
+    "@ultimat3/core": "29.4.0",
+    "@ultimat3/entity": "29.4.0",
+    "@ultimat3/jobs": "29.4.0",
+    "@ultimat3/query": "29.4.0",
+    "@ultimat3/realtime": "29.4.0"
   }
 }

package/src/diff-operations.ts

@@ -137,6 +137,15 @@ export function diffQueries(
         detail: `live ${String(query.live)} -> ${String(next.live)}`,
       });
     }
+    // Rows one side, a minted URL and a file the other: every caller of the read is written
+    // against one answer, so the flip breaks them whichever way it goes.
+    if ((query.download === true) !== (next.download === true)) {
+      changes.push({
+        kind: 'breaking',
+        path: `${path}.download`,
+        detail: next.download === true ? 'rows -> download' : 'download -> rows',
+      });
+    }
     // The same fact as an action's `cacheInvalidates`, and the same class: which tag flushes a
     // read is not a caller's contract, but a reviewer has to see it move.
     if (canonicalJson(query.cacheTags) !== canonicalJson(next.cacheTags)) {

package/src/schema.ts

@@ -213,6 +213,12 @@ export interface QueryFact {
    */
   readonly subscribes?: readonly string[];
   readonly cacheTags: readonly string[];
+  /**
+   * `true` when the read is a `query({ download })` — it answers a file at a signed URL, never
+   * rows. Absent on every other read, like `ActionFact.mutator`: a `false` per read is bytes for
+   * no fact. A caller built against rows is broken by the flip, and one built against a URL too.
+   */
+  readonly download?: true;
 }
 
 /**

package/src/sources.ts

@@ -137,6 +137,8 @@ export function frameworkSources(input: FrameworkSourcesInput): ManifestSources
       // empty list is refused at `query()`, so absence carries the whole meaning.
       ...(query.subscribes === null ? {} : { subscribes: query.subscribes }),
       cacheTags: query.tags,
+      // Written only when true — the reason `mutator` is: absence already means "answers rows".
+      ...(query.download ? { download: true as const } : {}),
     })),
     // Already the fact's shape, sorted and flattened by `describeChannels` — projected field by
     // field all the same, for the reason above.