Add support for Mastodon

[CIAvash]

Add support for showing latest toots from Mastodon.

[lowlighter]

I don't know mastodon enough to implement this, but you can submit a pull request to integrate this if you want 🙂

You just need to handle the api calls to return title, desc, cover image, etc. there:

metrics/source/plugins/posts/index.mjs

Lines 16 to 35 in 38e85ee

	switch (source) {
	//Dev.to
	case "dev.to": {
	console.debug(`metrics/compute/${login}/plugins > posts > querying api`)
	posts = (await imports.axios.get(`https://dev.to/api/articles?username=${user}&state=fresh`)).data.map(({title, description, published_at:date, cover_image:image, url:link}) => ({title, description, date, image, link}))
	link = `https://dev.to/${user}`
	break
	}
	//Hashnode
	case "hashnode": {
	posts = (await imports.axios.post("https://api.hashnode.com", {query:queries.posts.hashnode({user})}, {headers:{"Content-type":"application/json"}})).data.data.user.publication.posts.map((
	{title, brief:description, dateAdded:date, coverImage:image, slug},
	) => ({title, description, date, image, link:`https://hashnode.com/post/${slug}`}))
	link = `https://hashnode.com/@${user}`
	break
	}
	//Unsupported
	default:
	throw {error:{message:`Unsupported source "${source}"`}}
	}

And add mastodon as a valid source in the metadata.yml:

metrics/source/plugins/posts/metadata.yml

Lines 21 to 23 in 38e85ee

	values:
	- dev.to # Dev.to
	- hashnode

Along with a mocked test in tests.yml

[Andre601]

From what I gather would you be able to use https://<domaind>.<tld>/api/v1/accounts/<account_id>/statuses to receive a list of Status objects in JSON form.

The issue I see here is, that there isn't just one Mastodon page similar to what dev.to and hashnode is.
It would require at the very least these additional options:

• Domain used for the instance to fetch data from
• User ID to fetch data from
• Auth token (Maybe? I assume since we access public data that authorization is not required (Unless to avoid maybe API rate limits?), but perhaps only partial data will then be returned out of privacy...)

So, not entirely sure if a system similar to the post plugin's way would work here unless we can add additional options for it to check...
But personally would I think it's better to consider having a separate plugin than adding options only used for one specific site/service.

[Andre601]

Okay... I tried (keyword) to get a rough idea of a mastodon plugin...

Andre601@0af780f

I have absolutely no idea if that would be the right aproach here to do, as I do not know JavaScript and honestly just used the posts plugin as a template.

The reason for it being a separate plugin instead of being included within mastodon was stated in my above comment, namely that there isn't a single instance, therefore requiring the user to provide a domain, which as a separate posts option feels kinda like bloat to have here.

Also, I want to point out one smaller issue with the current setup, which is that it requires a User ID, not name, for the API to return data. And user IDs aren't as easy to get for a normal user.
So perhaps it can be considered to add an extra step that manages the username -> user id lookup. This is as simple as calling the /api/v1/accounts/lookup API path of a Mastodon instance and provide a acct query parameter with the username. This should return a JSON containing the user ID.

I would implement that... But as mentioned no JavaScript knowledge so can't really work it out.

If anything is this meant as a sort of "proof of concept" to maybe even give ideas to work with...

And on a kinda related note: Not sure if anything else (i.e. backend) would need an update too to work with this stuff...
The biggest concern for me is the fact that instances can have custom emojis which users can have in their posts and usernames, so this is also something to keep in mind...

[Andre601]

Small update: Made a ejs file for the plugin... Again using the posts plugin as inspiration.

Only thing I kinda fear is, that the SVG I used (The very first) is not properly resized... It's viewbox is 24x24 since it's from Simple Icons).

Andre601@b1a6dc0