paul/linker
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: optional direct Bandcamp/Apple/YouTube links via Odesli (flag-gated) (closes task/odesli-direct-cross-platform-links)

Browse Source 
Source: task/odesli-direct-cross-platform-links (plan/improvement-backlog) — bandcamp was only a Google search; Odesli gives direct cross-platform links for Spotify-resolved names.

- service/odesli.js: makeOdesli({fetch,baseUrl}) -> getLinks(spotifyUrl); pure parseOdesli core; bounded AbortSignal.timeout; non-200/timeout/garbage -> {} (graceful).
- resolver.js: opt-in ODESLI / ODESLI_URL flag (default OFF). When ON, enrich each Spotify-resolved result with additive bandcamp/appleMusic/youtube fields (isHttpUrl-validated), cached per Spotify url. OFF -> no call, byte-identical behavior. /health + startup log surface the flag.
- extension: a tiny additive "bc" link to a direct Bandcamp page when result.bandcamp is present (reuses isSafeHttpUrl); primary artist/album/spotify/google rendering unchanged. styles.css: bandcamp-teal secondary link.
- odesli.test.js + odesli.fixture.json: parseOdesli unit-tested against a real captured Odesli response (Blood Incantation album -> direct bandcamp; absent apple/youtube omitted; junk -> {}); getLinks 200/non-200/throw/parse-error paths.
- docs: .env.example, README, AGENTS.md note the opt-in flag.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
paul
2026-06-24 02:41:30 +00:00
co-authored by Claude Opus 4.8
parent 5ceea28948
commit e06c983b16
9 changed files with 544 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
service/odesli.fixture.json
+196
View File
@@ -0,0 +1,196 @@
{
"entityUniqueId": "SPOTIFY_ALBUM::0SdKqbCAKdkEFPW5NyzK7R",
"userCountry": "US",
"pageUrl": "https://album.link/s/0SdKqbCAKdkEFPW5NyzK7R",
"entitiesByUniqueId": {
"AMAZON_ALBUM::B07Y5X5BRQ": {
"id": "B07Y5X5BRQ",
"type": "album",
"title": "Hidden History of the Human Race",
"artistName": "Blood Incantation",
"thumbnailUrl": "https://m.media-amazon.com/images/I/51mV80OoCjL.jpg",
"thumbnailWidth": 500,
"thumbnailHeight": 500,
"apiProvider": "amazon",
"platforms": [
"amazonMusic",
"amazonStore"
]
},
"ANGHAMI_ALBUM::1009122604": {
"id": "1009122604",
"type": "album",
"title": "Hidden History of the Human Race",
"artistName": "Blood Incantation",
"thumbnailUrl": "https://artwork.anghcdn.co/cover/105602469/320",
"thumbnailWidth": 1024,
"thumbnailHeight": 1024,
"apiProvider": "anghami",
"platforms": [
"anghami"
]
},
"BANDCAMP_ALBUM::744542709": {
"id": "744542709",
"type": "album",
"title": "Hidden History of the Human Race",
"artistName": "Blood Incantation",
"thumbnailUrl": "https://f4.bcbits.com/img/a0485761639_5.jpg",
"thumbnailWidth": 700,
"thumbnailHeight": 700,
"apiProvider": "bandcamp",
"platforms": [
"bandcamp"
]
},
"BOOMPLAY_ALBUM::4983454": {
"id": "4983454",
"type": "album",
"title": "Hidden History of the Human Race",
"artistName": "Blood Incantation",
"thumbnailUrl": "https://source.boomplaymusic.com/group10/M00/CE/A9/52dc8f2dce1c48bcb7274bfc4cace0c9_464_464.jpg",
"thumbnailWidth": 464,
"thumbnailHeight": 464,
"apiProvider": "boomplay",
"platforms": [
"boomplay"
]
},
"DEEZER_ALBUM::112372942": {
"id": "112372942",
"type": "album",
"title": "Hidden History of the Human Race",
"artistName": "Blood Incantation",
"thumbnailUrl": "https://cdns-images.dzcdn.net/images/cover/3306ffd2111049b9b3bd327125fa0117/500x500-000000-80-0-0.jpg",
"thumbnailWidth": 500,
"thumbnailHeight": 500,
"apiProvider": "deezer",
"platforms": [
"deezer"
]
},
"NAPSTER_ALBUM::alb.409396148": {
"id": "alb.409396148",
"type": "album",
"title": "Hidden History of the Human Race",
"artistName": "Blood Incantation",
"thumbnailUrl": "https://direct.rhapsody.com/imageserver/images/alb.409396148/385x385.jpeg",
"thumbnailWidth": 385,
"thumbnailHeight": 385,
"apiProvider": "napster",
"platforms": [
"napster"
]
},
"PANDORA_ALBUM::AL:3339906": {
"id": "AL:3339906",
"type": "album",
"title": "Hidden History of the Human Race",
"artistName": "Blood Incantation",
"thumbnailUrl": "https://content-images.p-cdn.com/images/1e/39/68/15/eec44ac2b7c49e6190b40ef9/_500W_500H.jpg",
"thumbnailWidth": 500,
"thumbnailHeight": 500,
"apiProvider": "pandora",
"platforms": [
"pandora"
]
},
"SPOTIFY_ALBUM::0SdKqbCAKdkEFPW5NyzK7R": {
"id": "0SdKqbCAKdkEFPW5NyzK7R",
"type": "album",
"title": "Hidden History of the Human Race",
"artistName": "Blood Incantation",
"thumbnailUrl": "https://i.scdn.co/image/ab67616d0000b2734e452c006f620599a5882109",
"thumbnailWidth": 640,
"thumbnailHeight": 640,
"apiProvider": "spotify",
"platforms": [
"spotify"
]
},
"TIDAL_ALBUM::118729475": {
"id": "118729475",
"type": "album",
"title": "Hidden History of the Human Race",
"artistName": "Blood Incantation",
"thumbnailUrl": "https://resources.tidal.com/images/6e71fc44/4f33/4880/b089/9f0f71a3ac98/640x640.jpg",
"thumbnailWidth": 640,
"thumbnailHeight": 640,
"apiProvider": "tidal",
"platforms": [
"tidal"
]
},
"YANDEX_ALBUM::9130616": {
"id": "9130616",
"type": "album",
"title": "Hidden History of the Human Race",
"artistName": "Blood Incantation",
"thumbnailUrl": "https://avatars.yandex.net/get-music-content/2390047/8aeeac44.a.9130616-1/600x600",
"thumbnailWidth": 600,
"thumbnailHeight": 600,
"apiProvider": "yandex",
"platforms": [
"yandex"
]
}
},
"linksByPlatform": {
"amazonMusic": {
"country": "US",
"url": "https://music.amazon.com/albums/B07Y5X5BRQ",
"entityUniqueId": "AMAZON_ALBUM::B07Y5X5BRQ"
},
"amazonStore": {
"country": "US",
"url": "https://amazon.com/dp/B07Y5X5BRQ",
"entityUniqueId": "AMAZON_ALBUM::B07Y5X5BRQ"
},
"anghami": {
"country": "US",
"url": "https://play.anghami.com/album/1009122604?refer=linktree",
"entityUniqueId": "ANGHAMI_ALBUM::1009122604"
},
"bandcamp": {
"country": "US",
"url": "https://darkdescentrecords.bandcamp.com/album/hidden-history-of-the-human-race",
"entityUniqueId": "BANDCAMP_ALBUM::744542709"
},
"boomplay": {
"country": "US",
"url": "https://www.boomplay.com/albums/4983454",
"entityUniqueId": "BOOMPLAY_ALBUM::4983454"
},
"deezer": {
"country": "US",
"url": "https://www.deezer.com/album/112372942",
"entityUniqueId": "DEEZER_ALBUM::112372942"
},
"napster": {
"country": "US",
"url": "https://play.napster.com/album/alb.409396148",
"entityUniqueId": "NAPSTER_ALBUM::alb.409396148"
},
"pandora": {
"country": "US",
"url": "https://www.pandora.com/AL:3339906",
"entityUniqueId": "PANDORA_ALBUM::AL:3339906"
},
"tidal": {
"country": "US",
"url": "https://listen.tidal.com/album/118729475",
"entityUniqueId": "TIDAL_ALBUM::118729475"
},
"yandex": {
"country": "RU",
"url": "https://music.yandex.ru/album/9130616",
"entityUniqueId": "YANDEX_ALBUM::9130616"
},
"spotify": {
"country": "US",
"url": "https://open.spotify.com/album/0SdKqbCAKdkEFPW5NyzK7R",
"nativeAppUriDesktop": "spotify:album:0SdKqbCAKdkEFPW5NyzK7R",
"entityUniqueId": "SPOTIFY_ALBUM::0SdKqbCAKdkEFPW5NyzK7R"
}
}
}