source: Klonkt/scripts/funkwhale-gat.mjs@ d8f7d9c

/**
 * Hoe ver zijn we van Funkwhale's bibliotheek-ingest?
 *
 *   node scripts/funkwhale-gat.mjs https://dev.klonkt.com/ap/users/dev/library
 *
 * Loopt de eisen na die in api/funkwhale_api/federation/serializers.py staan
 * (develop, gelezen 16-8) en zegt per veld of het er is. Geen oordeel, geen
 * schatting: de lijst komt uit hun bron en de waarden uit onze eigen uitvoer.
 *
 * WAAROM DIT ER IS. "Zijn we er al?" is drie keer beantwoord met een gevoel en
 * drie keer bijgesteld. Deze vraag hoort een commando te zijn.
 *
 * LET OP wat dit NIET meet: de kanaal-weg. open.audio heeft onze tracks al
 * langs de outbox binnengehaald, met naam en artiest. Wat daar ontbreekt is
 * `uploads` -- en dat is precies wat deze ingest zou vullen.
 */
const BRON = process.argv[2] || 'https://dev.klonkt.com/ap/users/dev/library';

const haal = async (u) => {
  const r = await fetch(u, { headers: { Accept: 'application/activity+json' } });
  if (!r.ok) throw new Error(`${u} gaf ${r.status}`);
  return r.json();
};

// serializers.py regel 1741 -- UploadSerializer, per item in een bibliotheekpagina
const UPLOAD = [
  ['type', (a) => a.type === 'Audio'],
  ['id', (a) => !!a.id],
  ['library', (a) => !!a.library],
  ['url.href', (a) => !!(Array.isArray(a.url) ? a.url[0] : a.url)?.href],
  ['url.mediaType', (a) => !!(Array.isArray(a.url) ? a.url[0] : a.url)?.mediaType],
  ['published', (a) => !!a.published],
  ['duration', (a) => typeof a.duration === 'string'],
  // fw:bitrate en fw:size, en TOP-LEVEL. Wij zetten ze op de Link (waar hun
  // eigen outbox ze ook zet) en binden ze aan schema: -- zie shaer-f1y4.
  ['bitrate (top-level)', (a) => a.bitrate !== undefined],
  ['size (top-level)', (a) => a.size !== undefined],
  ['track', (a) => !!a.track],
];

// regel 1569 -- TrackSerializer, plus MusicEntitySerializer (1278) eronder
const TRACK = [
  ['track.id', (t) => !!t?.id],
  ['track.name', (t) => !!t?.name],
  ['track.published', (t) => !!t?.published],
  ['track.artist_credit[>=1]', (t) => Array.isArray(t?.artist_credit) && t.artist_credit.length >= 1],
  ['track.album', (t) => !!t?.album],
];

const lib = await haal(BRON);
const pagina = lib.first ? await haal(lib.first) : lib;
const items = pagina.items || pagina.orderedItems || [];
if (!items.length) { console.log('geen items in de bibliotheek'); process.exit(1); }
const a = items[0];

console.log(`bron: ${BRON}\nitem: ${a.name}\n`);
let gaten = 0;
const toon = (lijst, waarde) => {
  for (const [naam, test] of lijst) {
    let ok = false;
    try { ok = !!test(waarde); } catch { ok = false; }
    if (!ok) gaten++;
    console.log(`  ${ok ? 'OK ' : 'GAT'}  ${naam}`);
  }
};
console.log('UploadSerializer (regel 1741):');
toon(UPLOAD, a);
console.log('\nTrackSerializer (regel 1569 + MusicEntity 1278):');
toon(TRACK, a.track);

console.log(`\n${gaten === 0 ? 'niets meer nodig voor hun ingest' : gaten + ' veld(en) te gaan'}`);