feat(route): add Fars News showcase

Author: ubuntu

lib/routes/farsnews/namespace.ts

@@ -0,0 +1,7 @@
+import type { Namespace } from '@/types';
+
+export const namespace: Namespace = {
+    name: 'Fars News',
+    url: 'farsnews.ir',
+    lang: 'fa',
+};

lib/routes/farsnews/showcase.ts

@@ -0,0 +1,101 @@
+import { load } from 'cheerio';
+import type { Route } from '@/types';
+import cache from '@/utils/cache';
+import got from '@/utils/got';
+import { parseDate } from '@/utils/parse-date';
+import puppeteer from '@/utils/puppeteer';
+
+export const route: Route = {
+    path: '/showcase/:category?',
+    categories: ['traditional-media'],
+    example: '/farsnews/showcase',
+    parameters: { category: 'Category slug from farsnews.ir/showcase URL' },
+    features: {
+        requireConfig: false,
+        requirePuppeteer: true,
+        antiCrawler: true,
+        supportBT: false,
+        supportPodcast: false,
+        supportScihub: false,
+    },
+    radar: [{
+        source: ['farsnews.ir/showcase'],
+        target: '/showcase',
+    }],
+    name: 'Showcase',
+    maintainers: [],
+    handler,
+    description: 'Fars News showcase articles. Persian news agency.',
+};
+
+async function handler(ctx) {
+    const category = ctx.req.param('category') ?? '';
+    const baseUrl = 'https://farsnews.ir';
+    const currentUrl = category ? `${baseUrl}/showcase/${category}` : `${baseUrl}/showcase`;
+
+    const browser = await puppeteer();
+    const page = await browser.newPage();
+
+    try {
+        await page.setRequestInterception(true);
+        page.on('request', (req) => {
+            if (req.resourceType() === 'document') {
+                req.continue();
+            } else {
+                req.abort();
+            }
+        });
+
+        await page.goto(currentUrl, {
+            waitUntil: 'domcontentloaded',
+        });
+
+        const response = await page.content();
+        const $ = load(response);
+
+        const items = $('.rounded-2xl.border.border-gray-200')
+            .toArray()
+            .map((item) => {
+                item = $(item);
+                const a = item.find('a[href^="/"]').first();
+                const href = a.attr('href');
+
+                return {
+                    title: a.find('h2').text() || a.text(),
+                    link: href ? (href.startsWith('http') ? href : `${baseUrl}${href}`) : undefined,
+                };
+            })
+            .filter((item) => item.title && item.link);
+
+        const processedItems = await Promise.all(
+            items.map((item) =>
+                cache.tryGet(item.link, async () => {
+                    try {
+                        const detailResponse = await got({ method: 'get', url: item.link });
+                        const detail$ = load(detailResponse.data);
+
+                        const desc = detail$('meta[name="description"]').attr('content') || '';
+                        item.description = desc;
+
+                        const timeText = detail$('time').attr('datetime') || detail$('.text-gray-400').first().text();
+                        if (timeText) {
+                            item.pubDate = parseDate(timeText);
+                        }
+                    } catch {
+                        // Silently continue if detail fetch fails
+                    }
+                    return item;
+                })
+            )
+        );
+
+        return {
+            title: 'Fars News - Showcase',
+            link: currentUrl,
+            item: processedItems,
+        };
+    } finally {
+        await page.close();
+        await browser.close();
+    }
+}