rsshub/lib/routes/tumblr/posts.ts

Make RSS Great Again!

import { Data, Route } from '@/types';
import got from '@/utils/got';
import utils from './utils';
import type { Context } from 'hono';
import { config } from '@/config';
import ConfigNotFoundError from '@/errors/types/config-not-found';
import { fallback, queryToInteger } from '@/utils/readable-social';

export const route: Route = {
    path: '/posts/:blog',
    categories: ['blog'],
    example: '/tumblr/posts/biketouring-nearby',
    parameters: {
        blog: 'Blog identifier (see `https://www.tumblr.com/docs/en/api/v2#blog-identifiers`)',
    },
    radar: [],
    features: {
        requireConfig: [
            {
                name: 'TUMBLR_CLIENT_ID',
                description: 'Please see above for details.',
            },
            {
                name: 'TUMBLR_CLIENT_SECRET',
                description: 'Please see above for details.',
            },
            {
                name: 'TUMBLR_REFRESH_TOKEN',
                description: 'Please see above for details.',
            },
        ],
        requirePuppeteer: false,
        antiCrawler: false,
        supportBT: false,
        supportPodcast: false,
        supportScihub: false,
    },
    name: 'Posts',
    maintainers: ['Rakambda'],
    description: `::: tip
Tumblr provides official RSS feeds for non "dashboard only" blogs, for instance [https://biketouring-nearby.tumblr.com](https://biketouring-nearby.tumblr.com/rss).
:::`,
    handler,
};

async function handler(ctx: Context): Promise<Data> {
    if (!config.tumblr || !config.tumblr.clientId) {
        throw new ConfigNotFoundError('Tumblr RSS is disabled due to the lack of <a href="https://docs.rsshub.app/deploy/config#route-specific-configurations">relevant config</a>');
    }

    const blogIdentifier = ctx.req.param('blog');
    const limit = fallback(undefined, queryToInteger(ctx.req.query('limit')), 20);

    const response = await got.get(`https://api.tumblr.com/v2/blog/${blogIdentifier}/posts`, {
        searchParams: {
            ...utils.generateAuthParams(),
            limit,
        },
        headers: await utils.generateAuthHeaders(),
    });

    const blog = response.data.response.blog;
    const posts = response.data.response.posts.map((post: any) => utils.processPost(post));

    return {
        title: `Tumblr - ${blogIdentifier} - Posts`,
        author: blog?.name,
        link: blog?.url ?? `https://${blogIdentifier}/`,
        item: posts,
        allowEmpty: true,
        image: blog?.avatar?.slice(-1)?.url,
        description: blog?.description,
    };
}