Changeset aed0092 in Klonkt for src/services/ap-core.js

Timestamp:

08/11/2026 06:35:19 PM (4 weeks ago)

Author:

Robin <roboburr@…>

Branches:

main

Children:

960f015

Parents:

cb3001e

Message:

Elke collectie pagineert nu, via een helper in plaats van tien keer dezelfde regels

Vervolg op cb3001e, waar alleen de outbox eraan geloofde omdat Funkwhale daar
over viel. Robins opdracht: de rest ook, om compleetheid te garanderen. Dat is
de goede volgorde -- een foutmelding repareren waar hij valt laat de volgende
lezer op de volgende collectie stuklopen.

pagedCollection in ap-core, en daar hangen ze nu allemaal aan:

outbox followers following featured
tracks playlists playlist post-tracks
replies + de zeven guardianship-wachtrijen

De items blijven overal INLINE op de wortel; first en last wijzen naar dezelfde
pagina, want onze collecties zijn gekapt en er is er precies een. Wie ze vandaag
zonder pagineren leest -- Shaer doet dat -- merkt er niets van.

DRIE PLEKKEN DIE BEWUST AFWIJKEN, want een sleepnet is geen zorgvuldigheid:

• de guardianship-wachtrijen krijgen hun @context van de route (queueRoute), dus daar staan de velden er met de hand bij. pagedCollection zou de context een tweede keer toevoegen.
• de thread-collectie draagt al een ?object= in zijn id. Daar ?page= achteraan plakken pagineert niets, het herhaalt de vraag. Owner-only en door Shaer gelezen, dus geen federatiebelang.
• followers en following geven publiek alleen een AANTAL. Die krijgen de velden juist wel: anders is "ik mag de lijst niet zien" niet te onderscheiden van een kapot antwoord -- dezelfde stille dubbelzinnigheid die we vandaag bij een ander aantroffen.

Vier tests erbij, waaronder een die bewaakt dat de helper attributedTo niet
opeet en een die bewaakt dat de wachtrijen GEEN eigen @context krijgen.

Co-Authored-By: Claude Opus 5 <noreply@…>

File:

• src/services/ap-core.js (modified) (1 diff)

src/services/ap-core.js

@@ -187 +187 @@
   return out;
 }
+
+/**
+ * Een AS2-collectie MET de paginavelden erbij (shaer-0nh, 11-8).
+ *
+ * WAAROM DIT EEN HELPER IS EN GEEN REGELS. Funkwhale weigerde onze outbox met
+ * "first: This field is required" en "last: This field is required" -- de eerste
+ * concrete reden die we hoorden waarom er niets van ons binnenkwam. AS2 EIST die
+ * velden niet, maar bijna iedereen pagineert, en een lezer die de paginaweg
+ * volgt liep dood. Toen dat voor de outbox gerepareerd was misten alle andere
+ * collecties ze nog steeds. Een helper zorgt dat de volgende collectie ze niet
+ * opnieuw vergeet.
+ *
+ * DE ITEMS BLIJVEN INLINE op de wortel. Shaer bouwt zijn feed daaruit, en wie
+ * hem vandaag leest hoort er morgen niet voor te hoeven pagineren. Onze
+ * collecties zijn gekapt, dus er is precies EEN pagina en wijzen first en last
+ * naar dezelfde.
+ *
+ * @param {string} id        de collectie-uri, zonder query
+ * @param {Array}  items     wat erin zit (mag leeg)
+ * @param {object} opts
+ *   totalItems  als de telling niet items.length is (followers geeft publiek
+ *               alleen een AANTAL en houdt de lijst dicht)
+ *   page        true -> een OrderedCollectionPage met partOf in plaats van de wortel
+ *   extra       velden die op de wortel horen (attributedTo, shaer:*)
+ */
+export function pagedCollection(id, items, { totalItems, page = false, extra = {} } = {}) {
+  const lijst = items || [];
+  const telling = totalItems === undefined ? lijst.length : totalItems;
+  const eerste = `${id}?page=1`;
+  if (page) {
+    return {
+      '@context': AP_CONTEXT,
+      id: eerste,
+      type: 'OrderedCollectionPage',
+      partOf: id,
+      totalItems: telling,
+      orderedItems: lijst,
+    };
+  }
+  return {
+    '@context': AP_CONTEXT,
+    id,
+    type: 'OrderedCollection',
+    ...extra,
+    totalItems: telling,
+    first: eerste,
+    last: eerste,
+    orderedItems: lijst,
+  };
+}