Changeset d9ad6c5 in Klonkt for src/middleware

Timestamp:

07/28/2026 06:17:36 PM (6 weeks ago)

Author:

Robin Genis <roboburr@…>

Branches:

main

Children:

a7bcf66

Parents:

2708282

Message:

Een hulpvraag hoort in Berichten, niet in de Krant

Een 🛟 van een ward kwam bij de guardian op twee plekken binnen: als mention in
Berichten en de Guardian PWA, maar ook als gewone post in de Krant. Op
sound-fabrics.com stonden vijf van de zes hulpvragen in allebei.

De oorzaak zat in de inbox: de tijdlijn-insert vroeg alleen "is dit een
top-level post van iemand die ik volg" en keek niet naar wie de post geadresseerd
was. Dat is nu belongsInTimeline: een directe note is aan iemand persoonlijk
gericht, dus een bericht en geen post. Dat dekt meteen de wave en de gewone DM,
die om dezelfde reden in de Krant terechtkwamen. De self-heal ruimt de al
opgeslagen exemplaren op, beperkt tot de twee soorten die achteraf nog te
herkennen zijn; een publieke mention van iemand die je volgt is wel een post en
blijft staan.

Tweede helft: de weergave gelijkgetrokken. De Krant rendert een post met
emoji's, een quote- of linkkaart en de media; Berichten liet daar niks van zien
(zelfs de shortcodes bleven staan, want ap_mentions had geen emoji_json) en de
Guardian PWA plakte de kale content in een div. Die opmaak zat bovendien in de
<style> van de Krant zelf, dus een post buiten de Krant kwam sowieso ongestyled
binnen.

Nu is er één partial, note-body, met de opmaak in shared-styles ernaast. Alle
drie de oppervlakken gebruiken hem: de PWA bouwt zijn kaarten in de browser en
krijgt de body server-side gerenderd mee. ap_mentions en ap_interactions kregen
de kolommen die daarvoor nodig zijn, gevuld bij binnenkomst, met de quote- of
linkkaart out of band zoals de tijdlijn dat al deed.

En passant: de embed-gate stond alleen op de C2S-read, dus een ward zag in de
web-Krant nog steeds linkvoorbeelden die de guardians hadden uitgezet. Die gate
zit nu ook op /news en /messages.

Changed files:
src/services/ActivityPubService.js

• belongsInTimeline: een directe note is geen tijdlijn-post
• self-heal v21 verwijdert al opgeslagen hulpvragen en waves uit ap_timeline
• resolveCard: quote of linkvoorbeeld, één kaart, out of band opgelost
• mentions en replies slaan emoji's, media en die kaart op
• getNotifications geeft die kolommen door aan Berichten

src/config/database.js

• kolommen op ap_mentions en ap_interactions voor emoji's, media, quote, embed

src/middleware/render.js

• renderNoteBody: dezelfde partial als string, voor niet-EJS oppervlakken

src/routes/posts.js

• gateEmbeds op /news en /messages (FEP-633c gated feature)

src/routes/guardian.js

• hulpvragen krijgen body_html en name_html mee

src/assets/js/guardian.js

• kaart rendert die body in plaats van de kale content

src/assets/css/guardian.css

• opmaak voor de gedeelde post-body in de kleuren van de PWA

src/views/partials/tl-item.ejs

• body vervangen door de gedeelde partial

src/views/partials/msg-item.ejs

• idem, plus een 🛟-markering bij een hulpvraag

src/views/partials/shared-styles.ejs

• .tl-content, .tl-quote* en .tl-media* hierheen verhuisd

src/views/pages/news.ejs

• die regels weggehaald, alleen Krant-eigen opmaak blijft

src/services/i18n.js

• msg.help_request in nl, en, de

New file:
src/views/partials/note-body.ejs

• de body van een post: content, quote/linkkaart, media

test/help-request-timeline.test.js

• een 🛟 blijft uit de Krant en in Berichten

test/note-body-shared.test.js

• één renderer, en beide views gaan er doorheen

remarks: geverifieerd op een wegwerp-database in de browser: de hulpvraag
verdwijnt bij het opstarten uit de Krant en staat mét quote en capture in
Berichten en de PWA. Nog niet uitgerold.

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

File:

• src/middleware/render.js (modified) (1 diff)

src/middleware/render.js

@@ -37 +37 @@
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const VIEWS_DIR = path.join(__dirname, '..', 'views');
+
+/**
+ * Render a post body to an HTML string with the SAME partial de Krant uses.
+ *
+ * For surfaces that are not an EJS page: the Guardian PWA builds its cards in
+ * the browser, so it gets the finished HTML in its state blob instead of the
+ * raw columns. One renderer, so a post cannot drift into looking different
+ * depending on where you run into it.
+ */
+export function renderNoteBody(nb, lang) {
+  if (!nb || !nb.content) return '';
+  const _l = lang || 'nl';
+  // ejs.renderFile hands back a Promise even with async:false, and the callers
+  // here are plain synchronous route code. Compile the file ourselves instead;
+  // `filename` is what lets the partial's own relative includes resolve.
+  const file = path.join(VIEWS_DIR, 'partials', 'note-body.ejs');
+  try {
+    return ejs.render(fs.readFileSync(file, 'utf8'), {
+      nb,
+      t: (key, vars) => i18nT(_l, key, vars),
+      emojiHtml,
+      emojiName,
+      noteQuote: parseQuote,
+      thumb: (url, w) => (typeof url === 'string' && /^https?:\/\//i.test(url) ? imgProxyUrl(url, w || 480) : url),
+      avatar: (url, w) => (typeof url === 'string' && /^https?:\/\//i.test(url) ? imgProxyUrl(url, w || 128) : url),
+    }, { filename: file, async: false });
+  } catch (e) {
+    console.warn('[render] note body failed:', e.message);
+    return '';
+  }
+}
 
 // App version (from package.json) + short commit hash (from .klonkt-version, written by