Changeset 328d837 in Klonkt

Timestamp:

06/29/2026 11:24:30 PM (2 months ago)

Author:

roboburr <roboburr@…>

Branches:

main

Children:

09a2061

Parents:

93b147d

Message:

feat(music): schema.org MusicRecording/MusicAlbum structured data on audio posts (music federation Fase 1)

An audio post now emits standard schema.org MusicRecording (single track) or MusicAlbum
(album/playlist) JSON-LD alongside the existing Article data — a real web standard read by
search engines and generic JSON-LD consumers, NOT a Klonkt-invented field. The url points
to the gated player page, so the anti-steal posture is unchanged. The track-resolution helper
is the reusable base for the (future) Funkwhale Audio/Library federation (Fase 2).

• src/services/MusicMeta.js (new) — resolves a post's track/album/playlist shortcodes to hosted tracks and builds a schema.org MusicRecording/MusicAlbum (name, byArtist=MusicGroup, inAlbum, ISO-8601 duration, license, creditText, image, url)
• src/routes/posts.js — passes a musicLd local on the post page
• src/views/shell.ejs — renders a second ld+json script for music posts (Article kept intact)

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

Location:

src

Files:

• routes/posts.js (modified) (2 diffs)
• services/MusicMeta.js (added)
• views/shell.ejs (modified) (1 diff)

src/routes/posts.js

@@ -19 +19 @@
 import { toWebp } from '../services/ImageWebpService.js';
 import ActivityPubService from '../services/ActivityPubService.js';
+import MusicMeta from '../services/MusicMeta.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -1014 +1015 @@
     siteAvatar,
     postHasPlayableAudio: ActivityPubService.hasPlayableAudio(post.content || '', site.id),
+    musicLd: MusicMeta.build((process.env.PUBLIC_BASE_URL || `${req.protocol}://${req.get('host')}`).replace(/\/+$/, ''), site, post),
     pageTitle: post.title + ' - ' + site.title,
     socialDescr: post.excerpt || '',

src/views/shell.ejs

@@ -199 +199 @@
 <script type="application/ld+json"><%- JSON.stringify(_jsonLd) %></script>
 <% } %>
+<% if (typeof musicLd !== 'undefined' && musicLd) { %>
+<%# Music posts also carry standard schema.org MusicRecording/MusicAlbum data (Phase 1 of
+    music federation): real web standard, read by search engines + generic consumers. %>
+<script type="application/ld+json"><%- JSON.stringify(musicLd) %></script>
+<% } %>
 
 <!-- Self-hosted fonts (privacy-first) -->