feat!: retirer readUnion de la surface publiee, et lire un document par requete ancree

readUnion etait N requetes ancrees plus une politique de lot : une lecture
qui echoue avalee en reponse vide, un document dont on ne detient pas la cle
ecarte au lieu d'etre refuse, un regroupement en sacs de proprietes, et le
filtrage du prefixe reserve. Rien en amont ne repond a cette composition, et
son annotation citait sparql_query -- une citation exacte attachee a une
affirmation fausse. Une composition ne s'aligne pas sur une fonction.

Ce qui reste est ce qu'il y avait dessous : docs.sparqlQuery ancre sur un
document, qui va deja chercher la cle servie par le magasin public -- donc
une reference nue suffit toujours pour lire un document public, sans rien
changer a useShapeQuery. Lire plusieurs documents, c'est cet appel une fois
par document, et la tolerance a une lecture qui echoue revient a l'appelant,
la ou l'amont la laisse : une requete ancree sur un depot que le verifier ne
detient pas rejette.

Cote src, l'unique lecture interne restante devient read-document.ts : un
document, une requete ancree, precedee de l'ouverture du depot -- barriere
que index-deposit consulte pour distinguer une absence d'un depot non
synchronise. Le harnais e2e et l'exemple composent la leur, avec leur catch
visible au point d'appel.

Version majeure : 1.0.0-dev.8.

packages/polyfill/test/listing-surfaces-failure.test.ts

@@ -29,7 +29,7 @@
  */
 
 import { test, expect, describe, mock, beforeEach } from "bun:test";
-import { configure, storeRegistry, readUnion } from "../src/index";
+import { configure, storeRegistry, docs } from "../src/index";
 import { configureStoreRegistry } from "../src/shared-wallet/bootstrap";
 import { sparqlUpdate } from "../src/surface/docs";
 import type { NgLike, Nuri, StoreType, UseShapeLike } from "../src/model/types";
@@ -44,6 +44,25 @@ const KEY_READ = `<${SHIM}:readCap>`;
 
 const TITLE = "urn:test:title";
 
+/**
+ * The titles `doc` carries, read the way an APPLICATION reads one document since
+ * `1.0.0-dev.8`: the published anchored `docs.sparqlQuery`, naming the document. It
+ * replaces `readUnion([doc])`, which was the same anchored query with a batch around it.
+ */
+async function titlesIn(doc: Nuri): Promise<string[]> {
+  const res = await docs.sparqlQuery(
+    SESSION.sessionId,
+    "SELECT ?s ?p ?o WHERE { ?s ?p ?o }",
+    undefined,
+    doc,
+    "readDoc",
+  );
+  const rows = (res as { results?: { bindings?: Array<Record<string, { value: string }>> } })
+    .results?.bindings ?? [];
+  return rows.filter((r) => r["p"]?.value === TITLE).map((r) => r["o"]!.value);
+}
+
+
 /**
  * Wire the library onto `quads` over a broker that STOPS ANSWERING from the first query
  * `lostAt` accepts — that one included, and every one after it, for the rest of the page.
@@ -121,8 +140,9 @@ describe("listMyEntityDocs answers a verified listing or surfaces", () => {
       await signIn("alice");
 
       expect(await listMyEntityDocs("alice", scope)).toContain(note);
-      const subjects = await readUnion([note]);
-      expect(subjects.map((s) => s.props[TITLE]?.[0])).toEqual(["the note"]);
+      // Read the way an application reads one document now that `readUnion` is gone: the
+      // published anchored query, naming the document it was just handed.
+      expect(await titlesIn(note)).toEqual(["the note"]);
     });
   }