@unavatar/core 3.44.0 → 3.45.1

package/README.md

@@ -25,7 +25,6 @@
   - [CodePen](#codepen)
   - [Cults3D](#cults3d)
   - [Cursor](#cursor)
-  - [Deezer](#deezer)
   - [DeviantArt](#deviantart)
   - [Discord](#discord)
   - [Docker Hub](#docker-hub)
@@ -69,7 +68,6 @@
   - [Telegram](#telegram)
   - [Thingiverse](#thingiverse)
   - [Threads](#threads)
-  - [TIDAL](#tidal)
   - [TikTok](#tiktok)
   - [Tumblr](#tumblr)
   - [Twitch](#twitch)
@@ -597,21 +595,6 @@ 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.
@@ -962,22 +945,6 @@ 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.44.0",
+  "version": "3.45.1",
   "main": "src/index.js",
   "exports": {
     ".": "./src/index.js",

package/src/providers/bilibili.js

@@ -0,0 +1,27 @@
+'use strict'
+
+const API_URL = 'https://api.bilibili.com/x/web-interface/card'
+
+const getAvatarUrl = input => `${API_URL}?mid=${encodeURIComponent(input)}`
+
+// Users without a custom avatar get the generic `noface.jpg` placeholder.
+const getAvatar = body => {
+  if (body?.code !== 0) return
+  const face = body.data?.card?.face
+  return face && !face.endsWith('/noface.jpg') ? face : undefined
+}
+
+module.exports = ({ got }) =>
+  async function bilibili (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/douban.js

@@ -0,0 +1,15 @@
+'use strict'
+
+const getAvatarUrl = input => `https://www.douban.com/people/${input}/`
+
+const getAvatar = $ => $('img.userface').attr('src')
+
+module.exports = ({ createHtmlProvider }) =>
+  createHtmlProvider({
+    name: 'douban',
+    url: getAvatarUrl,
+    getter: getAvatar
+  })
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/gitee.js

@@ -0,0 +1,22 @@
+'use strict'
+
+const API_URL = 'https://gitee.com/api/v5/users'
+
+const getAvatarUrl = input => `${API_URL}/${encodeURIComponent(input)}`
+
+const getAvatar = body => body?.avatar_url || undefined
+
+module.exports = ({ got }) =>
+  async function gitee (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/index.js

@@ -6,6 +6,7 @@ const providersBy = {
     'apple-music',
     'apple-store',
     'behance',
+    'bilibili',
     'bluesky',
     'buymeacoffee',
     'cashapp',
@@ -16,19 +17,23 @@ const providersBy = {
     'deviantart',
     'discord',
     'dockerhub',
+    'douban',
     'dribbble',
     'facebook',
     'flickr',
+    'gitee',
     'github',
     'gitlab',
     'google-play',
     'huggingface',
     'hevy',
     'instagram',
+    'juejin',
     'ko-fi',
     'linkedin',
     'mastodon',
     'medium',
+    'netease-music',
     'npm',
     'onlyfans',
     'openstreetmap',
@@ -53,15 +58,18 @@ const providersBy = {
     'thingiverse',
     'threads',
     'tidal',
+    'tieba',
     'tiktok',
     'tumblr',
     'twitch',
     'venmo',
     'vimeo',
+    'weibo',
     'wise',
     'x',
     'xboxgamertag',
-    'youtube'
+    'youtube',
+    'zhihu'
   ],
   domain: ['microlink']
 }
@@ -71,6 +79,7 @@ module.exports = ctx => {
     'apple-music': require('./apple-music')(ctx),
     'apple-store': require('./apple-store')(ctx),
     behance: require('./behance')(ctx),
+    bilibili: require('./bilibili')(ctx),
     bluesky: require('./bluesky')(ctx),
     buymeacoffee: require('./buymeacoffee')(ctx),
     cashapp: require('./cashapp')(ctx),
@@ -81,10 +90,12 @@ module.exports = ctx => {
     deviantart: require('./deviantart')(ctx),
     discord: require('./discord')(ctx),
     dockerhub: require('./dockerhub')(ctx),
+    douban: require('./douban')(ctx),
     dribbble: require('./dribbble')(ctx),
     duckduckgo: require('./duckduckgo')(ctx),
     facebook: require('./facebook')(ctx),
     flickr: require('./flickr')(ctx),
+    gitee: require('./gitee')(ctx),
     github: require('./github')(ctx),
     gitlab: require('./gitlab')(ctx),
     google: require('./google')(ctx),
@@ -93,11 +104,13 @@ module.exports = ctx => {
     huggingface: require('./huggingface')(ctx),
     hevy: require('./hevy')(ctx),
     instagram: require('./instagram')(ctx),
+    juejin: require('./juejin')(ctx),
     'ko-fi': require('./ko-fi')(ctx),
     linkedin: require('./linkedin')(ctx),
     mastodon: require('./mastodon')(ctx),
     medium: require('./medium')(ctx),
     microlink: require('./microlink')(ctx),
+    'netease-music': require('./netease-music')(ctx),
     npm: require('./npm')(ctx),
     onlyfans: require('./onlyfans')(ctx),
     openstreetmap: require('./openstreetmap')(ctx),
@@ -108,6 +121,7 @@ module.exports = ctx => {
     primal: require('./primal')(ctx),
     producthunt: require('./producthunt')(ctx),
     psnprofiles: require('./psnprofiles')(ctx),
+    qq: require('./qq')(ctx),
     raycast: require('./raycast')(ctx),
     reddit: require('./reddit')(ctx),
     revolut: require('./revolut')(ctx),
@@ -122,16 +136,19 @@ module.exports = ctx => {
     thingiverse: require('./thingiverse')(ctx),
     threads: require('./threads')(ctx),
     tidal: require('./tidal')(ctx),
+    tieba: require('./tieba')(ctx),
     tiktok: require('./tiktok')(ctx),
     tumblr: require('./tumblr')(ctx),
     twitch: require('./twitch')(ctx),
     venmo: require('./venmo')(ctx),
     vimeo: require('./vimeo')(ctx),
+    weibo: require('./weibo')(ctx),
     whatsapp: require('./whatsapp')(ctx),
     wise: require('./wise')(ctx),
     x: require('./x')(ctx),
     xboxgamertag: require('./xboxgamertag')(ctx),
-    youtube: require('./youtube')(ctx)
+    youtube: require('./youtube')(ctx),
+    zhihu: require('./zhihu')(ctx)
   }
 
   return { providers, providersBy }

package/src/providers/juejin.js

@@ -0,0 +1,26 @@
+'use strict'
+
+const API_URL = 'https://api.juejin.cn/user_api/v1/user/get'
+
+const getAvatarUrl = input => `${API_URL}?user_id=${encodeURIComponent(input)}`
+
+// Unknown ids still respond `err_no: 0`, but with an empty profile.
+const getAvatar = body => {
+  if (body?.err_no !== 0) return
+  return body.data?.avatar_large || undefined
+}
+
+module.exports = ({ got }) =>
+  async function juejin (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/netease-music.js

@@ -0,0 +1,26 @@
+'use strict'
+
+const API_URL = 'https://music.163.com/api/v1/user/detail'
+
+const getAvatarUrl = input => `${API_URL}/${encodeURIComponent(input)}`
+
+// The API returns avatar URLs over plain HTTP; the CDN supports HTTPS.
+const getAvatar = body => {
+  const avatarUrl = body?.profile?.avatarUrl
+  return avatarUrl ? avatarUrl.replace(/^http:/, 'https:') : undefined
+}
+
+module.exports = ({ got }) =>
+  async function neteaseMusic (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/qq.js

@@ -0,0 +1,13 @@
+'use strict'
+
+// qlogo.cn serves a default placeholder for unknown numbers (gravatar-like),
+// so the URL always resolves and misses can't be detected upfront.
+const getAvatarUrl = input =>
+  `https://q1.qlogo.cn/g?b=qq&nk=${encodeURIComponent(input)}&s=640`
+
+module.exports = () =>
+  function qq (input) {
+    return getAvatarUrl(input)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl

package/src/providers/tieba.js

@@ -0,0 +1,36 @@
+'use strict'
+
+const PORTRAIT_URL = 'https://himg.bdimg.com/sys/portrait/item'
+
+const getAvatarUrl = input =>
+  `https://tieba.baidu.com/i/sys/user_json?un=${encodeURIComponent(
+    input
+  )}&ie=utf-8`
+
+const getAvatar = body => {
+  const portrait = body?.creator?.portrait
+  return portrait ? `${PORTRAIT_URL}/${portrait}` : undefined
+}
+
+module.exports = ({ got }) =>
+  async function tieba (input) {
+    // Unknown users respond with an empty body, which is not valid JSON.
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'text',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400 || !body) return
+
+    let json
+    try {
+      json = JSON.parse(body)
+    } catch {
+      return undefined
+    }
+
+    return getAvatar(json)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/weibo.js

@@ -0,0 +1,36 @@
+'use strict'
+
+const getAvatarUrl = input =>
+  /^\d+$/.test(input)
+    ? `https://m.weibo.cn/u/${input}`
+    : `https://m.weibo.cn/n/${encodeURIComponent(input)}`
+
+// The profile avatar is served as a signed, expiring crop
+// (`/crop.0.0.W.H.180/file?ssig=…`); rewriting it to `/large/file` yields a
+// stable, unsigned, full-resolution URL. Default avatars live under
+// `/default/`, which is treated as a miss.
+const getAvatar = ({ $, NOT_FOUND }) => {
+  const src = $('.m-avatar-box img').attr('src')
+  if (!src) return
+
+  const url = new URL(src, 'https://m.weibo.cn')
+  if (url.pathname.includes('/default/')) return NOT_FOUND
+
+  const filename = url.pathname.slice(url.pathname.lastIndexOf('/'))
+  return `${url.origin}/large${filename}`
+}
+
+// The page sits behind Weibo's visitor gate (a JS cookie-setting redirect)
+// and the avatar is injected after hydration, so it must be prerendered.
+module.exports = ({ createHtmlProvider, NOT_FOUND }) =>
+  createHtmlProvider({
+    name: 'weibo',
+    url: getAvatarUrl,
+    getter: $ => getAvatar({ $, NOT_FOUND }),
+    htmlOpts: () => ({
+      prerender: true
+    })
+  })
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar

package/src/providers/zhihu.js

@@ -0,0 +1,28 @@
+'use strict'
+
+const API_URL = 'https://www.zhihu.com/api/v4/members'
+
+const getAvatarUrl = input =>
+  `${API_URL}/${encodeURIComponent(input)}?include=avatar_url`
+
+// Misses (and bot challenges) come back as an `error` payload rather than
+// a plain 404, and default avatars are flagged via `use_default_avatar`.
+const getAvatar = body => {
+  if (!body || body.error || body.use_default_avatar) return
+  return body.avatar_url || undefined
+}
+
+module.exports = ({ got }) =>
+  async function zhihu (input) {
+    const { body, statusCode } = await got(getAvatarUrl(input), {
+      responseType: 'json',
+      throwHttpErrors: false
+    })
+
+    if (statusCode >= 400) return
+
+    return getAvatar(body)
+  }
+
+module.exports.getAvatarUrl = getAvatarUrl
+module.exports.getAvatar = getAvatar