feat(route): add Kiro Changelog (#19702)

* feat(route): add Kiro Changelog * fix typo * Apply suggestions from code review * Update lib/routes/kiro/namespace.ts ---------
2025-07-31 23:37:56 +08:00 · 2025-07-31 23:37:56 +08:00 · 4717c7db41
parent 309ca7d0b2
commit 4717c7db41
1 changed files with 128 additions and 0 deletions
--- a/lib/routes/kiro/changelog.ts
+++ b/lib/routes/kiro/changelog.ts
@ -0,0 +1,128 @@
+import { type Data, type DataItem, type Route, ViewType } from '@/types';
+
+import cache from '@/utils/cache';
+import ofetch from '@/utils/ofetch';
+import { parseDate } from '@/utils/parse-date';
+
+import { type CheerioAPI, type Cheerio, load } from 'cheerio';
+import type { Element } from 'domhandler';
+import { type Context } from 'hono';
+
+export const handler = async (ctx: Context): Promise<Data> => {
+    const limit: number = Number.parseInt(ctx.req.query('limit') ?? '30', 10);
+
+    const baseUrl: string = 'https://kiro.dev';
+    const targetUrl: string = new URL('changelog/', baseUrl).href;
+
+    const response = await ofetch(targetUrl);
+    const $: CheerioAPI = load(response);
+    const language = $('html').attr('lang') ?? 'en';
+
+    let items: DataItem[] = [];
+
+    items = $('a.block')
+        .slice(0, limit)
+        .toArray()
+        .map((el): Element => {
+            const $el: Cheerio<Element> = $(el);
+
+            const title: string = `${$el.parent().find('span').text()} ${$el.find('h3').text()}`;
+            const description: string | undefined = $el.parent().parent().find('div.prose').html() ?? undefined;
+            const pubDateStr: string | undefined = $el.parent().parent().parent().find('time').text();
+            const linkUrl: string | undefined = $el.attr('href');
+            const upDatedStr: string | undefined = pubDateStr;
+
+            const processedItem: DataItem = {
+                title,
+                description,
+                pubDate: pubDateStr ? parseDate(pubDateStr) : undefined,
+                link: linkUrl ? new URL(linkUrl, baseUrl).href : undefined,
+                content: {
+                    html: description,
+                    text: description,
+                },
+                updated: upDatedStr ? parseDate(upDatedStr) : undefined,
+                language,
+            };
+
+            return processedItem;
+        });
+
+    items = await Promise.all(
+        items.map((item) => {
+            if (!item.link) {
+                return item;
+            }
+
+            return cache.tryGet(item.link, async (): Promise<DataItem> => {
+                const detailResponse = await ofetch(item.link);
+                const $$: CheerioAPI = load(detailResponse);
+
+                const title: string = `${$$('article span').first().text()} ${$$('article h3').text()}`;
+                const description: string | undefined = $$('div.prose').html() ?? undefined;
+                const pubDateStr: string | undefined = $$('time').text();
+                const image: string | undefined = $$('meta[property="og:image"]').attr('content');
+                const upDatedStr: string | undefined = pubDateStr;
+
+                const processedItem: DataItem = {
+                    title,
+                    description,
+                    pubDate: pubDateStr ? parseDate(pubDateStr) : item.pubDate,
+                    content: {
+                        html: description,
+                        text: description,
+                    },
+                    image,
+                    banner: image,
+                    updated: upDatedStr ? parseDate(upDatedStr) : item.updated,
+                    language,
+                };
+
+                return {
+                    ...item,
+                    ...processedItem,
+                };
+            });
+        })
+    );
+
+    return {
+        title: $('title').text(),
+        description: $('meta[property="og:description"]').attr('content'),
+        link: targetUrl,
+        item: items,
+        allowEmpty: true,
+        image: $('meta[property="og:image"]').attr('content'),
+        author: $('meta[property="og:site_name"]').attr('content'),
+        language,
+        id: targetUrl,
+    };
+};
+
+export const route: Route = {
+    path: '/changelog',
+    name: 'Changelog',
+    url: 'kiro.dev',
+    maintainers: ['nczitzk'],
+    handler,
+    example: '/kiro/changelog',
+    parameters: undefined,
+    description: undefined,
+    categories: ['program-update'],
+    features: {
+        requireConfig: false,
+        requirePuppeteer: false,
+        antiCrawler: false,
+        supportRadar: true,
+        supportBT: false,
+        supportPodcast: false,
+        supportScihub: false,
+    },
+    radar: [
+        {
+            source: ['kiro.dev', 'kiro.dev/changelog/'],
+            target: '/changelog',
+        },
+    ],
+    view: ViewType.Articles,
+};