Changeset 59d963f in Klonkt

Timestamp:

08/10/2026 09:38:43 AM (4 weeks ago)

Author:

Robin <roboburr@…>

Branches:

main

Children:

c34ef26

Parents:

86ec01b

Message:

De hele site als muziekkanaal: /tracks.xml (Robins vraag, 10-8)

Hij vroeg om een "hele site, open tracks"-library, in de hoop dat Funkwhale er
iets mee zou kunnen. Als AS2-object doet zo'n ding daar niets: een
Funkwhale-KANAAL (federation/actors/tnd, opgehaald en nagelopen) noemt nergens
een library, en hun library is een eigen actor met inbox en sleutel -- de optie
die op 7 augustus bewust is afgewezen.

Maar de vorm waarin Funkwhale een kanaal WEL uitgeeft is RSS 2.0 met de
iTunes-namespace en een enclosure per item. Naast onze feed gelegd:

Funkwhale 1 item, 1 enclosure audio/mpeg itunes + atom
Klonkt 8 items, 4 enclosures audio/mpeg itunes + atom

Dezelfde vorm dus, en die had Klonkt al. Het enige verschil was dat onze feed
ook gewone posts draagt, en een muziekkanaal met blogberichten ertussen is er
geen. Vandaar een tweede ingang op dezelfde bouwer in plaats van een nieuw
object: /tracks.xml, alleen de open tracks.

Twee dingen die geen detail zijn. De self-link wijst naar ZICHZELF -- anders
stuurt een lezer die opnieuw ophaalt zichzelf naar de gemengde variant en staan
de posts er alsnog in. En de titel krijgt " -- muziek" erachter, want twee
feeds met dezelfde naam zijn in een podcast-app niet te scheiden.

Wat NIET verandert: de actor blijft /feed.xml adverteren. Die is door Apple
Podcasts gevalideerd en werkt; een tweede rss-link erbij zou een podcast-app
laten kiezen tussen twee kanaalfeeds. /tracks.xml is een URL om te plakken.

En dicht blijft dicht: dezelfde poortregel als overal, siteOpenTracks beslist.

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

Files:

• src/routes/feed.js (modified) (4 diffs)
• test/feed-tracks-only.test.js (added)

src/routes/feed.js

@@ -44 +44 @@
 
 // ==================== RSS 2.0 ====================
-router.get('/feed.xml', (req, res) => {
+/**
+ * Twee feeds, een bouwer.
+ *
+ *   /feed.xml    de site: posts EN open tracks door elkaar, chronologisch
+ *   /tracks.xml  alleen de open tracks -- de hele site als muziekkanaal
+ *
+ * WAAROM DIE TWEEDE (Robins vraag, 10-8). Hij vroeg naar een "hele site, open
+ * tracks"-library voor Funkwhale. Als AS2-object helpt zo'n ding daar niet: een
+ * Funkwhale-KANAAL wijst nergens naar een library, en hun library is een eigen
+ * actor met inbox en sleutel -- de optie die op 7 augustus is afgewezen. Maar de
+ * vorm waarin Funkwhale een kanaal WEL uitgeeft is RSS met iTunes en een
+ * enclosure per item, en dat is precies wat Klonkt hier al doet. Naast een echte
+ * kanaalfeed gelegd (audio.pepemoss.com/api/v1/channels/tnd/rss): dezelfde
+ * namespaces, dezelfde enclosure.
+ *
+ * Het enige verschil was dat onze feed ook gewone posts draagt. Een muziekkanaal
+ * met blogberichten ertussen is er geen, dus die feed staat er nu apart -- een
+ * URL om te plakken, zonder dat er iets naar buiten geduwd wordt.
+ */
+function stuurFeed(req, res, { alleenTracks }) {
   const site = res.locals.site;
   if (!site) return res.status(404).send('No site');
@@ -50 +69 @@
   const origin = siteOrigin(req);
   const base = origin + (res.locals.siteUrlBase || '');
-  const posts = postsForFeed(site.id);
+  const posts = alleenTracks ? [] : postsForFeed(site.id);
 
   // De tracks die deze site aan de federatie heeft opengezet, elk als eigen
@@ -65 +84 @@
   // poortregel en die hoort op een plek te staan.
   const tracks = siteOpenTracks(site.id);
-  const lastBuild = posts[0]?.published_at || new Date().toISOString();
+  const lastBuild = posts[0]?.published_at || tracks[0]?.created_at || new Date().toISOString();
 
   // De itunes-velden waar een podcast-app een kanaal aan herkent. Funkwhale
@@ -117 +136 @@
 <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd">
   <channel>
-    <title>${escapeXml(site.title)}</title>
+    <title>${escapeXml(alleenTracks ? `${site.title} \u2014 muziek` : site.title)}</title>
     <link>${escapeXml(base + '/')}</link>
     <description>${escapeXml(site.description || site.tagline || '')}</description>
     <language>${escapeXml(site.language || 'nl')}</language>
     <lastBuildDate>${new Date(lastBuild).toUTCString()}</lastBuildDate>
-    <atom:link href="${escapeXml(base + '/feed.xml')}" rel="self" type="application/rss+xml" />
+    <atom:link href="${escapeXml(base + (alleenTracks ? '/tracks.xml' : '/feed.xml'))}" rel="self" type="application/rss+xml" />
 ${kanaalTags}
 ${items}
   </channel>
 </rss>`);
-});
+}
+
+router.get('/feed.xml', (req, res) => stuurFeed(req, res, { alleenTracks: false }));
+// De hele site als muziekkanaal: alleen wat op de federatie openstaat.
+router.get('/tracks.xml', (req, res) => stuurFeed(req, res, { alleenTracks: true }));
 
 // ==================== Atom 1.0 ====================