Changeset a982e7e in Klonkt

Timestamp:

08/16/2026 12:53:33 PM (3 weeks ago)

Author:

Robin <roboburr@…>

Branches:

main

Children:

daa8eb8

Parents:

abd2093

Message:

Audio: fw:track meesturen in de kleine Emissary-vorm

Spoor B stap 1 uit shaer-3f8a. Twee onafhankelijke implementaties lezen
dit veld: Funkwhale (verplicht in UploadSerializer) en Emissary 0.9.0,
gemeten op bandwagon.fm 16-8. petitminion noemde het ontbreken ervan als
eerste wat hem aan onze objecten opviel.

De vorm is die van Emissary: type, id, name, position. Klein, en dat is
het punt -- Funkwhale's eigen TrackSerializer wil er artists en
musicbrainzId bij, en dat is de grote versie die we niet nodig hebben om
gelezen te worden.

EIGEN ID MET #track. Emissary hergebruikt daar het id van het
Audio-object, maar dan zijn de Audio en de Track in JSON-LD een knoop met
twee typen, en een bestand is geen werk. Dat onderscheid moeten we straks
toch maken -- een album verzamelt nummers, geen mp3's.

GEEN album in de track. Dat is bij hen een URI naar een Album-object en
bij ons een tekstkolom; er een adres van maken belooft een ding dat niet
bestaat. Die keuze staat apart (shaer-k37k) en moet eerst vallen.

Het commentaar in ap-core dat uitlegde waarom we track NIET namen is
bijgesteld in plaats van weggehaald: die redenering klopte half. Een
track heeft bij ons wel een eigen identiteit, een album niet -- dat is
waar de grens werkelijk ligt.

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

Files:

• src/services/ap-core.js (modified) (1 diff)
• src/services/music/index.js (modified) (1 diff)
• test/ap-fw-track.test.js (added)

src/services/ap-core.js

@@ -57 +57 @@
     // zou een verhuizing kunnen laten mislukken.
     sameAs: { '@id': 'schema:sameAs', '@type': '@id' },
-    // ── De ENIGE term die we uit Funkwhale's eigen vocabulaire overnemen ──
+    // ── Wat we uit Funkwhale's vocabulaire overnemen, en waarom ──
     //
-    // Waarom deze wel en track/ArtistCredit niet (shaer-0nh): die twee vragen
-    // ENTITEITEN waar wij tekst hebben -- een artiest en een album zijn bij ons
-    // kolommen, en er een id voor verzinnen zou beloven wat we niet kunnen
-    // waarmaken. Een Library is iets anders: het is precies wat we AL hebben,
-    // een verzameling van onze eigen open tracks met een echte telling.
+    // LIBRARY. Gemeten op 13-8: open.audio had onze vier tracks binnengehaald
+    // via hun AP-id, met een artist_credit dat het zelf uit onze attributedTo
+    // afleidde -- maar uploads LEEG en is_playable false. Bij Funkwhale hangt
+    // een upload aan een library; zonder die bak blijft een track een naam
+    // zonder geluid.
     //
-    // En hij doet iets. Gemeten op 13-8: open.audio heeft onze vier tracks
-    // binnengehaald via hun AP-id, met artist_credit dat het zelf uit onze
-    // attributedTo afleidde -- maar uploads is LEEG en is_playable false. Bij
-    // Funkwhale hangt een upload aan een library; zonder library is er geen bak
-    // om het bestand in te hangen, en blijft een track een naam zonder geluid.
+    // TRACK. Hier stond dat we deze NIET namen, met als reden: hij vraagt een
+    // entiteit waar wij tekst hebben, en er een id voor verzinnen belooft wat
+    // we niet waarmaken. Die redenering klopte half, en de Emissary-meting van
+    // 16-8 (shaer-3f8a) laat zien welke helft. Een TRACK heeft bij ons wel
+    // degelijk een eigen identiteit -- het is een rij met een titel en een
+    // plaats in een uitgave. Wat wij niet hebben is een ALBUM als entiteit, en
+    // dat is een andere vraag (shaer-k37k). Emissary stuurt precies die kleine
+    // vorm: type, id, name, position. Wij ook, en album blijft eruit tot het
+    // een echt object is -- een verzonnen album-URI is nu juist wel de belofte
+    // die we niet kunnen waarmaken.
+    //
+    // Twee onafhankelijke implementaties zenden dit nu, en het is de kant waar
+    // FEP-be68 heen beweegt. ArtistCredit blijft eruit: dat is nog steeds een
+    // entiteit die wij niet hebben.
+    //
+    // De vorm van de termen is letterlijk die van hun contexts.py (regel
+    // 293-306), zodat een lezer die hun context laadt en een lezer die de onze
+    // leest op dezelfde IRI's uitkomen.
     fw: 'https://funkwhale.audio/ns#',
     Library: 'fw:Library',
     library: { '@id': 'fw:library', '@type': '@id' },
+    Track: 'fw:Track',
+    track: { '@id': 'fw:track', '@type': '@id' },
     position: 'schema:position',
     bitrate: 'schema:bitrate',

src/services/music/index.js

@@ -182 +182 @@
   // van te maken.
   if (post) a.context = noteId(base, post.id);
+  // Het NUMMER, los van dit bestand (shaer-3f8a, spoor B). Funkwhale en
+  // Emissary lezen allebei `fw:track`, en petitminion noemde het ontbreken
+  // ervan als eerste wat hem opviel aan onze objecten.
+  //
+  // EIGEN ID MET #track, en niet hetzelfde id als de Audio. Emissary hergebruikt
+  // daar het object-id, maar dan zijn in JSON-LD de Audio en de Track EEN knoop
+  // met twee typen -- en een bestand is geen werk. Dat verschil moeten we straks
+  // toch maken, want een album verzamelt nummers en geen mp3's. Een fragment is
+  // een geldige IRI en wijst naar hetzelfde document.
+  //
+  // GEEN `album`. Dat veld is bij hen een URI naar een Album-object en bij ons
+  // een tekstkolom; er hier een adres van maken zou een ding beloven dat niet
+  // bestaat. Zie shaer-k37k -- dat is de keuze die daarvoor eerst moet vallen.
+  a.track = {
+    type: 'Track',
+    id: `${a.id}#track`,
+    name: a.name,
+    ...(Number(r.position) ? { position: Number(r.position) } : {}),
+  };
   if (r.duration) a.duration = `PT${Math.round(r.duration)}S`;
   if (r.created_at) a.published = new Date(r.created_at).toISOString();