Feat(add puffinfolio) (#2443)

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

plugins/english/puffinFolio.ts

@@ -0,0 +1,143 @@
+import { fetchApi } from '@libs/fetch';
+import { Plugin } from '@/types/plugin';
+import { Filters } from '@libs/filterInputs';
+import { load as loadCheerio } from 'cheerio';
+import { defaultCover } from '@libs/defaultCover';
+import { NovelStatus } from '@libs/novelStatus';
+
+class PuffinFolioPlugin implements Plugin.PluginBase {
+  id = 'puffinfolio';
+  name = 'Puffin Folio';
+  icon = 'src/en/puffinfolio/icon.png';
+  site = 'https://www.puffinfolio.com/';
+  version = '1.0.0';
+  filters: Filters | undefined = undefined;
+  imageRequestInit?: Plugin.ImageRequestInit | undefined = undefined;
+
+  private async loadPage(path: string) {
+    const response = await fetchApi(this.site + path.replace(/^\//, ''));
+    return loadCheerio(await response.text());
+  }
+
+  // Covers are served through next/image, so the real file sits in a url= param.
+  private resolveCover(raw?: string): string {
+    if (!raw) return defaultCover;
+    const candidate = raw.trim().split(/\s+/)[0];
+    const embedded = candidate.match(/url=([^&]+)/);
+    const file = embedded ? decodeURIComponent(embedded[1]) : candidate;
+    if (/^https?:\/\//.test(file)) return file;
+    return (
+      this.site.replace(/\/$/, '') + (file.startsWith('/') ? file : '/' + file)
+    );
+  }
+
+  private async novelList(): Promise<Plugin.NovelItem[]> {
+    const $ = await this.loadPage('browse');
+    const novels: Plugin.NovelItem[] = [];
+
+    $('a[href^="/novel/"]').each((_, element) => {
+      const link = $(element);
+      const href = link.attr('href');
+      if (!href || href.includes('/chapter/')) return;
+
+      const image = link.find('img').first();
+      const name =
+        link.find('h3').first().text().trim() || image.attr('alt')?.trim();
+      if (!name) return;
+
+      const path = href.replace(/^\//, '');
+      if (novels.some(novel => novel.path === path)) return;
+
+      novels.push({
+        name,
+        path,
+        cover: this.resolveCover(image.attr('src') || image.attr('srcset')),
+      });
+    });
+
+    return novels;
+  }
+
+  async popularNovels(pageNo: number): Promise<Plugin.NovelItem[]> {
+    // The catalogue is small enough to sit on a single browse page.
+    if (pageNo > 1) return [];
+    return this.novelList();
+  }
+
+  async parseNovel(novelPath: string): Promise<Plugin.SourceNovel> {
+    const $ = await this.loadPage(novelPath);
+
+    const novel: Plugin.SourceNovel = {
+      path: novelPath,
+      name: $('h1').first().text().trim() || 'Untitled',
+    };
+
+    const cover = $('img[src*="covers"], img[srcset*="covers"]').first();
+    novel.cover = this.resolveCover(cover.attr('src') || cover.attr('srcset'));
+
+    novel.summary = $('meta[name="description"]').attr('content')?.trim();
+
+    novel.genres = $('a[href^="/browse?tag="]')
+      .map((_, element) => $(element).text().trim())
+      .get()
+      .filter(Boolean)
+      .join(',');
+
+    const statusText = $('span')
+      .map((_, element) => $(element).text().trim())
+      .get()
+      .find(text => text === 'Ongoing' || text === 'Completed');
+    novel.status =
+      statusText === 'Completed'
+        ? NovelStatus.Completed
+        : statusText === 'Ongoing'
+          ? NovelStatus.Ongoing
+          : NovelStatus.Unknown;
+
+    const chapters: Plugin.ChapterItem[] = [];
+    $('li a[href*="/chapter/"]').each((_, element) => {
+      const link = $(element);
+      const href = link.attr('href');
+      if (!href) return;
+
+      const path = href.replace(/^\//, '');
+      if (chapters.some(chapter => chapter.path === path)) return;
+
+      const time = link.find('time');
+      // Strip the leading chapter-number badge so the name reads "Chapter 7".
+      const label = link.find('span').first().clone();
+      label.find('span').remove();
+
+      chapters.push({
+        name: label.text().trim() || href.split('/').pop() || '',
+        path,
+        releaseTime: time.attr('datetime') || time.attr('title') || null,
+        chapterNumber: Number(href.match(/\/chapter\/(\d+)/)?.[1]) || undefined,
+      });
+    });
+
+    novel.chapters = chapters.sort(
+      (a, b) => (a.chapterNumber ?? 0) - (b.chapterNumber ?? 0),
+    );
+    return novel;
+  }
+
+  async parseChapter(chapterPath: string): Promise<string> {
+    const $ = await this.loadPage(chapterPath);
+    return $('.reader-prose').html() || '';
+  }
+
+  async searchNovels(
+    searchTerm: string,
+    pageNo: number,
+  ): Promise<Plugin.NovelItem[]> {
+    if (pageNo > 1) return [];
+    const term = searchTerm.toLowerCase();
+    const novels = await this.novelList();
+    return novels.filter(novel => novel.name.toLowerCase().includes(term));
+  }
+
+  resolveUrl = (path: string) => this.site + path.replace(/^\//, '');
+}
+
+export default new PuffinFolioPlugin();