@unavatar/core 3.42.0 → 3.43.0

package/README.md

@@ -22,9 +22,9 @@
   - [Behance](#behance)
   - [Bluesky](#bluesky)
   - [Buy Me a Coffee](#buy-me-a-coffee)
-  - [Cash App](#cash-app)
   - [CodePen](#codepen)
   - [Cults3D](#cults3d)
+  - [Cursor](#cursor)
   - [DeviantArt](#deviantart)
   - [Discord](#discord)
   - [Docker Hub](#docker-hub)
@@ -39,6 +39,7 @@
   - [Google](#google)
   - [Google Play](#google-play)
   - [Gravatar](#gravatar)
+  - [Hevy](#hevy)
   - [Hugging Face](#hugging-face)
   - [Instagram](#instagram)
   - [Ko-fi](#ko-fi)
@@ -50,29 +51,29 @@
   - [OnlyFans](#onlyfans)
   - [OpenStreetMap](#openstreetmap)
   - [Patreon](#patreon)
-  - [PayPal](#paypal)
   - [Pinterest](#pinterest)
+  - [Primal](#primal)
   - [Printables](#printables)
   - [Product Hunt](#product-hunt)
   - [PSN Profiles](#psn-profiles)
+  - [Raycast](#raycast)
   - [Reddit](#reddit)
-  - [Revolut](#revolut)
   - [Snapchat](#snapchat)
   - [SoundCloud](#soundcloud)
   - [Spotify](#spotify)
   - [Stack Overflow](#stack-overflow)
   - [Steam](#steam)
+  - [Strava](#strava)
   - [Substack](#substack)
   - [Telegram](#telegram)
   - [Thingiverse](#thingiverse)
   - [Threads](#threads)
+  - [TIDAL](#tidal)
   - [TikTok](#tiktok)
   - [Tumblr](#tumblr)
   - [Twitch](#twitch)
-  - [Venmo](#venmo)
   - [Vimeo](#vimeo)
   - [WhatsApp](#whatsapp)
-  - [Wise](#wise)
   - [X/Twitter](#xtwitter)
   - [Xbox Gamertag](#xbox-gamertag)
   - [YouTube](#youtube)
@@ -577,12 +578,6 @@ Get any Buy Me a Coffee creator's profile picture by their username.
 
 e.g., [unavatar.io/buymeacoffee/mikebarnesdrums](https://unavatar.io/buymeacoffee/mikebarnesdrums)
 
-### Cash App
-
-Get any Cash App user's profile picture by their $cashtag.
-
-e.g., [unavatar.io/cashapp/ninja](https://unavatar.io/cashapp/ninja)
-
 ### CodePen
 
 Get any CodePen user's profile picture by their username.
@@ -595,6 +590,12 @@ Get any Cults3D creator's profile picture by username.
 
 e.g., [unavatar.io/cults3d/RaBros](https://unavatar.io/cults3d/RaBros)
 
+### Cursor
+
+Get any Cursor user's profile picture by their username.
+
+e.g., [unavatar.io/cursor/leerob](https://unavatar.io/cursor/leerob)
+
 ### DeviantArt
 
 Get any DeviantArt user's profile picture by their username.
@@ -730,6 +731,12 @@ When you pass an email address directly in the URL, it is visible in plain text
 
 To avoid this, pass a pre-computed `MD5` or `SHA256` hash of the email instead. Unavatar detects the hash automatically and routes it to Gravatar, which natively supports both hash formats.
 
+### Hevy
+
+Get any Hevy user's profile picture by their username.
+
+e.g., [unavatar.io/hevy/om_giigo](https://unavatar.io/hevy/om_giigo)
+
 ### Hugging Face
 
 Get profile pictures for Hugging Face users or organizations by their handle.
@@ -807,18 +814,18 @@ Get any Patreon creator's profile picture by their username.
 
 e.g., [unavatar.io/patreon/gametestro](https://unavatar.io/patreon/gametestro)
 
-### PayPal
-
-Get any PayPal user's profile picture by their PayPal.Me username.
-
-e.g., [unavatar.io/paypal/kikobeats](https://unavatar.io/paypal/kikobeats)
-
 ### Pinterest
 
 Get any Pinterest user's profile picture by their username.
 
 e.g., [unavatar.io/pinterest/ohjoy](https://unavatar.io/pinterest/ohjoy)
 
+### Primal
+
+Get any Primal user's profile picture by their username.
+
+e.g., [unavatar.io/primal/jack](https://unavatar.io/primal/jack)
+
 ### Printables
 
 Get any Printables user's profile picture by their username.
@@ -844,6 +851,12 @@ Get any PlayStation Network user's profile picture by their PSN username.
 
 e.g., [unavatar.io/psnprofiles/Duff85](https://unavatar.io/psnprofiles/Duff85)
 
+### Raycast
+
+Get any Raycast user's profile picture by their username.
+
+e.g., [unavatar.io/raycast/peduarte](https://unavatar.io/raycast/peduarte)
+
 ### Reddit
 
 Get any Reddit user's avatar by their username.
@@ -853,12 +866,6 @@ Available inputs:
 - Username, e.g., [unavatar.io/reddit/thisisbillgates](https://unavatar.io/reddit/thisisbillgates)
 - Organization, e.g., [unavatar.io/reddit/nasa](https://unavatar.io/reddit/nasa)
 
-### Revolut
-
-Get any Revolut user's profile picture by their Revolut.Me username.
-
-e.g., [unavatar.io/revolut/midudev](https://unavatar.io/revolut/midudev)
-
 ### Snapchat
 
 Get any Snapchat user's profile picture by their username.
@@ -909,6 +916,12 @@ Available inputs:
 - `profile`: [unavatar.io/steam/profile:76561198044605749](https://unavatar.io/steam/profile:76561198044605749)
 - `group`: [unavatar.io/steam/group:murcia-gaming](https://unavatar.io/steam/group:murcia-gaming)
 
+### Strava
+
+Get any Strava athlete's profile picture by their username or athlete ID.
+
+e.g., [unavatar.io/strava/kikobeats](https://unavatar.io/strava/kikobeats)
+
 ### Substack
 
 Get any Substack author's profile picture by their publication username.
@@ -933,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.
@@ -951,12 +980,6 @@ Get any Twitch streamer's profile picture by their username.
 
 e.g., [unavatar.io/twitch/midudev](https://unavatar.io/twitch/midudev)
 
-### Venmo
-
-Get any Venmo user's profile picture by their username.
-
-e.g., [unavatar.io/venmo/Jessica-Lee-77](https://unavatar.io/venmo/Jessica-Lee-77)
-
 ### Vimeo
 
 Get any Vimeo user's profile picture by their username.
@@ -977,12 +1000,6 @@ Available inputs:
 - `channel`: [unavatar.io/whatsapp/channel:0029VaARuQ7KwqSXh9fiMc0m](https://unavatar.io/whatsapp/channel:0029VaARuQ7KwqSXh9fiMc0m)
 - `chat`: [unavatar.io/whatsapp/chat:D2FFycjQXrEIKG8qQjbwZz](https://unavatar.io/whatsapp/chat:D2FFycjQXrEIKG8qQjbwZz)
 
-### Wise
-
-Get any Wise user's profile picture by their Wisetag.
-
-e.g., [unavatar.io/wise/josev2264](https://unavatar.io/wise/josev2264)
-
 ### X/Twitter
 
 Get any X (formerly Twitter) 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.42.0",
+  "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