@unavatar/core 3.42.1 → 3.44.0

package/README.md

@@ -25,6 +25,7 @@
   - [CodePen](#codepen)
   - [Cults3D](#cults3d)
   - [Cursor](#cursor)
+  - [Deezer](#deezer)
   - [DeviantArt](#deviantart)
   - [Discord](#discord)
   - [Docker Hub](#docker-hub)
@@ -68,6 +69,7 @@
   - [Telegram](#telegram)
   - [Thingiverse](#thingiverse)
   - [Threads](#threads)
+  - [TIDAL](#tidal)
   - [TikTok](#tiktok)
   - [Tumblr](#tumblr)
   - [Twitch](#twitch)
@@ -595,6 +597,21 @@ Get any Cursor user's profile picture by their username.
 
 e.g., [unavatar.io/cursor/leerob](https://unavatar.io/cursor/leerob)
 
+### Deezer
+
+Get artwork for any Deezer entity — artists, albums, playlists, or tracks. Look up by Deezer ID.
+
+By default the input is treated as an artist:
+
+e.g., [unavatar.io/deezer/27](https://unavatar.io/deezer/27)
+
+The input also supports a URI format `type:id`:
+
+- `artist` (default): [unavatar.io/deezer/artist:27](https://unavatar.io/deezer/artist:27)
+- `album`: [unavatar.io/deezer/album:302127](https://unavatar.io/deezer/album:302127)
+- `playlist`: [unavatar.io/deezer/playlist:908622995](https://unavatar.io/deezer/playlist:908622995)
+- `track`: [unavatar.io/deezer/track:3135556](https://unavatar.io/deezer/track:3135556)
+
 ### DeviantArt
 
 Get any DeviantArt user's profile picture by their username.
@@ -945,6 +962,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.44.0",
   "main": "src/index.js",
   "exports": {
     ".": "./src/index.js",

package/src/providers/deezer.js

@@ -0,0 +1,32 @@
+'use strict'
+
+// Entities without artwork keep an empty image hash
+// (cdn-images.dzcdn.net/images/artist//500x500.jpg), which resolves to a
+// generic placeholder, so any empty hash segment is treated as a miss.
+const isArtwork = url => !/\/images\/[^/]+\/\/\d/.test(url)
+
+const getAvatarUrl = input => {
+  const [first, second] = input.split(':')
+  const type = second ? first : 'artist'
+  const id = second ?? first
+  return `https://www.deezer.com/en/${type}/${id}`
+}
+
+// Deezer server-renders og:image for missing entities as well, so the empty
+// placeholder is filtered out and everything else is returned as-is.
+const getAvatar = ({ $, getOgImage, NOT_FOUND }) => {
+  const image = getOgImage($)
+  return image && isArtwork(image) ? image : NOT_FOUND
+}
+
+const factory = ({ createHtmlProvider, getOgImage, NOT_FOUND }) =>
+  createHtmlProvider({
+    name: 'deezer',
+    url: getAvatarUrl,
+    getter: $ => getAvatar({ $, getOgImage, NOT_FOUND })
+  })
+
+factory.getAvatarUrl = getAvatarUrl
+factory.getAvatar = getAvatar
+
+module.exports = factory

package/src/providers/index.js

@@ -12,6 +12,7 @@ const providersBy = {
     'codepen',
     'cults3d',
     'cursor',
+    'deezer',
     'deviantart',
     'discord',
     'dockerhub',
@@ -51,6 +52,7 @@ const providersBy = {
     'telegram',
     'thingiverse',
     'threads',
+    'tidal',
     'tiktok',
     'tumblr',
     'twitch',
@@ -75,6 +77,7 @@ module.exports = ctx => {
     codepen: require('./codepen')(ctx),
     cults3d: require('./cults3d')(ctx),
     cursor: require('./cursor')(ctx),
+    deezer: require('./deezer')(ctx),
     deviantart: require('./deviantart')(ctx),
     discord: require('./discord')(ctx),
     dockerhub: require('./dockerhub')(ctx),
@@ -118,6 +121,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