@unavatar/core 3.7.61 → 3.7.63

package/README.md

@@ -17,6 +17,8 @@
   - [Google](#google)
   - [Gravatar](#gravatar)
   - [Instagram](#instagram)
+  - [LinkedIn](#linkedin)
+  - [Mastodon](#mastodon)
   - [Microlink](#microlink)
   - [OnlyFans](#onlyfans)
   - [OpenStreetMap](#openstreetmap)
@@ -223,6 +225,20 @@ It resolves user avatar against **instagram.com**.
 
 e.g., [unavatar.io/instagram/willsmith](https://unavatar.io/instagram/willsmith)
 
+### LinkedIn
+
+It resolves user avatar against **linkedin.com**.
+
+e.g., [unavatar.io/linkedin/kikobeats](https://unavatar.io/linkedin/kikobeats)
+
+### Mastodon
+
+It resolves user avatar from any **Mastodon** instance using the public account lookup API.
+
+Because Mastodon is federated, the input must include both the username and the server. The following formats are supported:
+
+- `user@server`: [unavatar.io/mastodon/kpwags@hachyderm.io](https://unavatar.io/mastodon/kpwags@hachyderm.io)
+
 ### Microlink
 
 It resolves user avatar using **microlink.io**.

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.7.61",
+  "version": "3.7.63",
   "main": "src/index.js",
   "exports": {
     ".": "./src/index.js",
@@ -34,6 +34,10 @@
       "name": "Alexander Schlindwein",
       "email": "alexander.schlindwein@hotmail.de"
     },
+    {
+      "name": "Wes Bos",
+      "email": "wesbos@gmail.com"
+    },
     {
       "name": "Zadkiel",
       "email": "hello@zadkiel.fr"
@@ -134,7 +138,7 @@
     "p-any": "~3.0.0",
     "p-cancelable": "2.1.1",
     "p-timeout": "~4.1.0",
-    "puppeteer": "~24.39.0",
+    "puppeteer": "~24.40.0",
     "re2": "~1.23.3",
     "srcset": "~4.0.0",
     "stable-regex": "~1.0.0",

package/src/index.js

@@ -15,6 +15,7 @@ module.exports = ({ constants: userConstants, redis, onFetchHTML } = {}) => {
   const { createMultiCache, createRedisCache } = require('./util/keyv')({ ...constants, redis })
   const cache = require('./util/cache')({ createMultiCache, createRedisCache })
   const cacheableLookup = require('./util/cacheable-lookup')({ ...constants, cache: cache.dnsCache })
+  const isReservedIp = require('./util/is-reserved-ip')({ cacheableLookup })
   const got = require('./util/got')({ cacheableLookup })
   const reachableUrl = require('./util/reachable-url')({ got, pingCache: cache.pingCache })
   const createBrowser = require('./util/browserless')(constants)
@@ -25,7 +26,14 @@ module.exports = ({ constants: userConstants, redis, onFetchHTML } = {}) => {
     onFetchHTML
   })
 
-  const providerCtx = { constants, createHtmlProvider, getOgImage, got, itunesSearchCache: cache.itunesSearchCache }
+  const providerCtx = {
+    constants,
+    createHtmlProvider,
+    getOgImage,
+    got,
+    isReservedIp,
+    itunesSearchCache: cache.itunesSearchCache
+  }
   const { providers, providersBy } = require('./providers')(providerCtx)
 
   const { auto, getInputType, getAvatar } = require('./avatar/auto')({

package/src/providers/index.js

@@ -10,6 +10,8 @@ const providersBy = {
     'github',
     'gitlab',
     'instagram',
+    'linkedin',
+    'mastodon',
     'onlyfans',
     'openstreetmap',
     'patreon',
@@ -39,6 +41,8 @@ module.exports = ctx => {
     google: require('./google')(ctx),
     gravatar: require('./gravatar')(ctx),
     instagram: require('./instagram')(ctx),
+    linkedin: require('./linkedin')(ctx),
+    mastodon: require('./mastodon')(ctx),
     microlink: require('./microlink')(ctx),
     onlyfans: require('./onlyfans')(ctx),
     openstreetmap: require('./openstreetmap')(ctx),

package/src/providers/linkedin.js

@@ -0,0 +1,8 @@
+'use strict'
+
+module.exports = ({ createHtmlProvider, getOgImage }) =>
+  createHtmlProvider({
+    name: 'linkedin',
+    url: input => `https://www.linkedin.com/in/${input}`,
+    getter: getOgImage
+  })

package/src/providers/mastodon.js

@@ -0,0 +1,58 @@
+'use strict'
+
+const isValidServer = server => {
+  try {
+    const url = new URL(`https://${server}`)
+    return (
+      Boolean(url.hostname) &&
+      url.username === '' &&
+      url.password === '' &&
+      url.pathname === '/' &&
+      url.search === '' &&
+      url.hash === '' &&
+      url.host.toLowerCase() === server.toLowerCase()
+    )
+  } catch {
+    return false
+  }
+}
+
+const parseMastodonInput = input => {
+  if (typeof input !== 'string') return null
+
+  const cleaned = input.startsWith('@') ? input.slice(1) : input
+  const parts = cleaned.split('@')
+  if (parts.length !== 2) return null
+
+  const [username, server] = parts
+  if (!username || !server) return null
+  if (!isValidServer(server)) return null
+
+  return {
+    username,
+    server
+  }
+}
+
+module.exports = ({ got, isReservedIp }) => {
+  const mastodon = async function ({ input }) {
+    const parsed = parseMastodonInput(input)
+    if (!parsed) return undefined
+
+    const { username, server } = parsed
+
+    if (await isReservedIp(server)) return undefined
+
+    const { body } = await got(
+      `https://${server}/api/v1/accounts/lookup?acct=${encodeURIComponent(
+        username
+      )}`,
+      { responseType: 'json' }
+    )
+
+    return body?.avatar
+  }
+
+  mastodon.parseMastodonInput = parseMastodonInput
+  return mastodon
+}

package/src/util/is-reserved-ip.js

@@ -0,0 +1,23 @@
+'use strict'
+
+const ip = require('ipaddr.js')
+
+module.exports = ({ cacheableLookup }) => {
+  const getIpAddress = async hostname => {
+    if (ip.IPv4.isIPv4(hostname)) return hostname
+    if (
+      hostname.startsWith('[') &&
+      hostname.endsWith(']') &&
+      ip.IPv6.isIPv6(hostname.slice(1, -1))
+    ) {
+      return hostname.slice(1, -1)
+    }
+    const { address } = await cacheableLookup.lookupAsync(hostname)
+    return address
+  }
+
+  return async hostname => {
+    const ipAddress = await getIpAddress(hostname)
+    return ip.process(ipAddress).range() !== 'unicast'
+  }
+}