Changeset e5fc801 in Klonkt for src/services/ActivityPubService.js

Timestamp:

08/07/2026 09:23:16 AM (5 weeks ago)

Author:

roboburr <roboburr@…>

Branches:

main

Children:

44c9f3f

Parents:

f2a7181

git-author:

Robin <roboburr@…> (08/07/2026 09:23:07 AM)

git-committer:

roboburr <roboburr@…> (08/07/2026 09:23:16 AM)

Message:

Gate-besluiten geven nu een melding in de Guardian PWA (shaer-fax fase 1)

De guardianship-module zendt VEERTIEN soorten gebeurtenissen uit. De push-brug
kende er vijf en deed if (!texts) return; alles daarbuiten viel stil weg. Daar
zaten juist de twee bij die er voor een guardian het meest toe doen:

gated_review een mede-guardian stelde iets voor en JOUW antwoord is nodig
gated_outcome er is besloten

Dat eerste is niet cosmetisch. FEP-633c 5.6 telt over de beschikbare guardians en
faalt gesloten: zonder melding hoort een guardian niet dat er op hem gewacht
wordt, loopt het venster leeg en verloopt het voorstel. Een drempel die niemand
ziet is geen drempel.

De melding zegt over wie het gaat, WELKE instelling, en of het aan of uit gezet
wordt -- er is meer dan een gate en ze betekenen heel verschillende dingen voor
een kind. De labels komen uit dezelfde i18n-sleutels als het Guardian-paneel,
zodat een melding en het scherm waar hij heen wijst hetzelfde woord gebruiken.
Een onbekende feature valt terug op het algemene woord in plaats van de melding
te laten vervallen: een guardian die niets hoort denkt dat er niets speelt.

De keuze WELKE gebeurtenis een mens wakker maakt is nu een aparte pure functie
(guardianEventPush) in plaats van verstopt in de bezorging. Dat is een beslissing
en hoort toetsbaar te zijn zonder web-push erbij te halen.

Teksten in nl, en en de. 7 tests, waaronder een die de vijf bestaande soorten
bewaakt -- deze brug is verbouwd. Gecontroleerd dat ze bijten: haal gated_review
uit de tabel en vier vallen om. Suite 551/551.

Dit is fase 1 van shaer-fax: de gratis variant via de Guardian PWA, zonder
abonnement en zonder derde partij. Geen native app nodig om dit te gebruiken.

File:

• src/services/ActivityPubService.js (modified) (1 diff)

src/services/ActivityPubService.js

@@ -5278 +5278 @@
   // Guardian PWA / Berichten push. The kid answers an incoming offer in its
   // own Berichten; an existing guardian and a commit land in the PWA.
+  //
+  // De labels hangen aan dezelfde sleutels als het Guardian-paneel, zodat een
+  // melding en het scherm waar hij heen wijst hetzelfde woord gebruiken.
   onEvent: (slug, ev) => {
-    const L = pushLang(slug);
-    const texts = {
-      offer_received: ['push.n_guard_offer_t', 'push.n_guard_offer_b'],   // I am the ward
-      offer_for_ward: ['push.n_guard_cog_t', 'push.n_guard_cog_b'],       // I co-guard this ward
-      committed: ['push.n_guard_ward_t', 'push.n_guard_ward_b'],
-      // §3.2: a guardian ended the relation. The ward hears that someone who
-      // was looking after them has gone; a co-guardian hears they are one fewer.
-      guardian_left: ['push.n_guard_left_t', 'push.n_guard_left_b'],
-      coguardian_left: ['push.n_guard_cogleft_t', 'push.n_guard_cogleft_b'],
-    }[ev.kind];
-    if (!texts) return;
-    const who = deriveHandle(ev.candidate || ev.guardian || ev.ward || '') || '?';
-    const url = (ev.kind === 'offer_received' || ev.kind === 'guardian_left') ? `${pushPrefix(slug)}/messages` : '/guardian';
-    pushEvent(slug, { type: 'guardian', title: i18nT(L, texts[0]), body: i18nT(L, texts[1], { who }), url });
+    const p = guardianEventPush(slug, ev);
+    if (p) pushEvent(slug, p);
   },
 });
+
+/**
+ * Welke melding hoort bij een guardianship-gebeurtenis, of geen.
+ *
+ * Apart en puur, omdat dit een BESLISSING is en geen bezorging: de
+ * guardianship-module zendt veertien soorten uit en deze tabel bepaalt welke
+ * daarvan een mens wakker maken. Dat hoort toetsbaar te zijn zonder web-push
+ * erbij te halen.
+ */
+export function guardianEventPush(slug, ev) {
+  const L = pushLang(slug);
+  const texts = {
+    offer_received: ['push.n_guard_offer_t', 'push.n_guard_offer_b'],   // I am the ward
+    offer_for_ward: ['push.n_guard_cog_t', 'push.n_guard_cog_b'],       // I co-guard this ward
+    committed: ['push.n_guard_ward_t', 'push.n_guard_ward_b'],
+    // §3.2: a guardian ended the relation. The ward hears that someone who
+    // was looking after them has gone; a co-guardian hears they are one fewer.
+    guardian_left: ['push.n_guard_left_t', 'push.n_guard_left_b'],
+    coguardian_left: ['push.n_guard_cogleft_t', 'push.n_guard_cogleft_b'],
+    // 5.6 gated settings. Zonder deze twee is de hele tally stil: een guardian
+    // hoort niet dat er een antwoord van hem gewenst is, en dus loopt het
+    // venster leeg en verloopt het voorstel. Een drempel die niemand ziet is
+    // geen drempel.
+    gated_review: ['push.n_gate_ask_t', 'push.n_gate_ask_b'],      // jij moet antwoorden
+    gated_outcome: ['push.n_gate_done_t', 'push.n_gate_done_b'],   // er is besloten
+  }[ev.kind];
+  if (!texts) return null;
+  const who = deriveHandle(ev.candidate || ev.guardian || ev.ward || '') || '?';
+  // Een gate-melding zonder te zeggen WELKE instelling is nutteloos: er zijn er
+  // meer dan een, en ze betekenen heel verschillende dingen voor een kind.
+  const wat = i18nT(L, GATE_LABEL[ev.feature] || 'guardian.prop_embeds');
+  const stand = i18nT(L, ev.value ? 'guardian.prop_on' : 'guardian.prop_off');
+  const uitkomst = i18nT(L, GATE_OUTCOME[ev.outcome] || 'guardian.prop_st_open');
+  const url = (ev.kind === 'offer_received' || ev.kind === 'guardian_left') ? `${pushPrefix(slug)}/messages` : '/guardian';
+  return { type: 'guardian', title: i18nT(L, texts[0]), body: i18nT(L, texts[1], { who, wat, stand, uitkomst }), url };
+}
+
+// Van een gated feature naar het woord dat het Guardian-paneel er al voor
+// gebruikt. Een onbekende feature valt terug op het algemene woord in plaats van
+// de melding te laten vervallen: liever een iets vager bericht dan geen bericht.
+const GATE_LABEL = {
+  'shaer:externalEmbeds': 'guardian.prop_embeds',
+  'shaer:externalPlayback': 'guardian.prop_play',
+};
+const GATE_OUTCOME = {
+  accepted: 'guardian.prop_st_accepted',
+  rejected: 'guardian.prop_st_rejected',
+  expired: 'guardian.prop_st_expired',
+};
 
 // The notification duty of FEP-633c 3.6.2, wired once for every place a