@unavatar/core 3.43.0 → 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)
@@ -596,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.

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.43.0",
+  "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',
@@ -76,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),