Changeset 39a9d21 in Klonkt for test

Timestamp:

08/08/2026 04:50:48 AM (5 weeks ago)

Author:

Robin <roboburr@…>

Branches:

main

Children:

fb22f78

Parents:

bdcb3a3

git-author:

Robin <roboburr@…> (08/08/2026 04:47:48 AM)

git-committer:

Robin <roboburr@…> (08/08/2026 04:50:48 AM)

Message:

Onze tracks zijn eersterangs Audio-objecten (shaer-0nh, stap 3)

De spiegel van wat sinds bdcb3a3 inkomend werkt. Onze muziek zat alleen als
naamloze bijlage in een Note: iets dat bestaat zolang je het omhullende object
vasthoudt. Nu is een track een DING met een eigen id, los op te halen, en in
twee playlists hetzelfde ding.

DE ACTOR-COLLECTIE IS DE KANONIEKE PLEK, niet de playlist (Robins vraag). Een
playlist is een keuze uit wat de artiest heeft uitgebracht; de collectie is dat
geheel. Een track die in geen enkele playlist stond was tot nu toe onzichtbaar
voor de federatie -- die staat er nu wel in.

GET /ap/users/:slug/tracks alles wat opengezet is
GET /ap/users/:slug/tracks/:id een track, met eigen @context
streams tracks eerst, dan playlists

url wordt een Link-array: de mediaType hoort bij de link, niet bij het
object. Zo doet Funkwhale het, en zo leest onze eigen inbox het sinds bdcb3a3 --
een andere Klonkt kan onze tracks dus als track opnemen in plaats van als
bijlage.

GEEN text/html-link erin. Klonkt heeft geen trackpagina: een track wordt getoond
binnen een post, en een post over vijf nummers is niet de pagina van dit ene
nummer. Liever geen link dan een link die iets anders belooft.

De poortregel loopt door: een gesloten track geeft 404, dezelfde "afwezig, niet
leeg" als in de collectie, zodat het bestaan van een gated nummer niet uit een
ander antwoord valt af te leiden.

ONDERWEG OPGERUIMD. De mediaType-afleiding stond twee keer functie-lokaal, met
een commentaar dat ze "dezelfde afleiding" waren. Dat was niet zo: de ene kende
video, de andere alleen beeld. Nu een kaart, op moduleniveau, met de volledige
map -- gedragsgelijk voor buildNote en een superset voor de playlist.

7 tests.

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

Location:

test

Files:

• ap-playlist-discovery.test.js (modified) (1 diff)
• ap-playlist.test.js (modified) (1 diff)
• ap-tracks.test.js (added)

test/ap-playlist-discovery.test.js

@@ -55 +55 @@
 test('de actor wijst via streams naar de playlist-lijst', async () => {
   const { body } = await getJson('/ap/users/band');
-  assert.deepEqual(body.streams, ['https://test.example/ap/users/band/playlists']);
+  // Sinds stap 3 staat de TRACK-collectie er ook in, en vooraan: die is de
+  // kanonieke plek voor onze muziek, de playlists zijn een keuze daaruit.
+  assert.deepEqual(body.streams, [
+    'https://test.example/ap/users/band/tracks',
+    'https://test.example/ap/users/band/playlists',
+  ]);
 });
 

test/ap-playlist.test.js

@@ -79 +79 @@
   for (const a of body.orderedItems) {
     assert.equal(a.type, 'Audio');
-    assert.match(a.url, /^https:\/\/test\.example\/audio\/stream\//);
-    assert.equal(a.mediaType, 'audio/mpeg');
+    // Sinds stap 3: een eigen id, en url als Link-array -- de mediaType hoort
+    // bij de link, niet bij het object.
+    assert.match(a.id, /^https:\/\/test\.example\/ap\/users\/band\/tracks\//);
+    assert.ok(Array.isArray(a.url), 'url is een Link-array');
+    assert.match(a.url[0].href, /^https:\/\/test\.example\/audio\/stream\//);
+    assert.equal(a.url[0].mediaType, 'audio/mpeg');
   }
   assert.equal(body.orderedItems[0].duration, 'PT215S');