@unavatar/core 3.42.1 → 3.43.0

package/README.md

@@ -68,6 +68,7 @@
   - [Telegram](#telegram)
   - [Thingiverse](#thingiverse)
   - [Threads](#threads)
+  - [TIDAL](#tidal)
   - [TikTok](#tiktok)
   - [Tumblr](#tumblr)
   - [Twitch](#twitch)
@@ -945,6 +946,22 @@ Get any Threads user's profile picture by their username.
 
 e.g., [unavatar.io/threads/zuck](https://unavatar.io/threads/zuck)
 
+### TIDAL
+
+Get artwork for any TIDAL entity — artists, albums, playlists, tracks, or videos. Look up by TIDAL ID.
+
+By default the input is treated as an artist:
+
+e.g., [unavatar.io/tidal/1566](https://unavatar.io/tidal/1566)
+
+The input also supports a URI format `type:id`:
+
+- `artist` (default): [unavatar.io/tidal/artist:1566](https://unavatar.io/tidal/artist:1566)
+- `album`: [unavatar.io/tidal/album:1765857](https://unavatar.io/tidal/album:1765857)
+- `playlist`: [unavatar.io/tidal/playlist:c3c18106-c4f5-4021-bb18-108255c1f450](https://unavatar.io/tidal/playlist:c3c18106-c4f5-4021-bb18-108255c1f450)
+- `track`: [unavatar.io/tidal/track:113655761](https://unavatar.io/tidal/track:113655761)
+- `video`: [unavatar.io/tidal/video:45323542](https://unavatar.io/tidal/video:45323542)
+
 ### TikTok
 
 Get any TikTok user's profile picture by their username. No authentication or API tokens needed — just pass the username.

package/package.json

@@ -2,7 +2,7 @@
   "name": "@unavatar/core",
   "description": "Get unified user avatar from social networks, including Instagram, SoundCloud, Telegram, Twitter, YouTube & more.",
   "homepage": "https://unavatar.io",
-  "version": "3.42.1",
+  "version": "3.43.0",
   "main": "src/index.js",
   "exports": {
     ".": "./src/index.js",

package/src/providers/index.js

@@ -51,6 +51,7 @@ const providersBy = {
     'telegram',
     'thingiverse',
     'threads',
+    'tidal',
     'tiktok',
     'tumblr',
     'twitch',
@@ -118,6 +119,7 @@ module.exports = ctx => {
     telegram: require('./telegram')(ctx),
     thingiverse: require('./thingiverse')(ctx),
     threads: require('./threads')(ctx),
+    tidal: require('./tidal')(ctx),
     tiktok: require('./tiktok')(ctx),
     tumblr: require('./tumblr')(ctx),
     twitch: require('./twitch')(ctx),

package/src/providers/tidal.js

@@ -0,0 +1,35 @@
+'use strict'
+
+// Real artwork is served from resources.tidal.com. When an entity has no
+// artwork the page keeps a generic share image (tidal.com/img/FB_…), so
+// anything off the resources host is treated as a miss.
+const isArtwork = url => /^https:\/\/resources\.tidal\.com\//.test(url)
+
+const getAvatarUrl = input => {
+  const [first, second] = input.split(':')
+  const type = second ? first : 'artist'
+  const id = second ?? first
+  return `https://tidal.com/${type}/${id}`
+}
+
+// The static markup only ships the generic share image; the entity artwork is
+// injected into og:image once the SPA hydrates, so the page must be prerendered.
+const getAvatar = ({ $, getOgImage, NOT_FOUND }) => {
+  const image = getOgImage($)
+  return image && isArtwork(image) ? image : NOT_FOUND
+}
+
+const factory = ({ createHtmlProvider, getOgImage, NOT_FOUND }) =>
+  createHtmlProvider({
+    name: 'tidal',
+    url: getAvatarUrl,
+    getter: $ => getAvatar({ $, getOgImage, NOT_FOUND }),
+    htmlOpts: () => ({
+      prerender: true
+    })
+  })
+
+factory.getAvatarUrl = getAvatarUrl
+factory.getAvatar = getAvatar
+
+module.exports = factory