Add konkon (#2329)

2026-07-21 08:38:39 +08:00
parent 2874379f28
commit c0e9b45357
2 changed files with 315 additions and 0 deletions
@@ -0,0 +1,315 @@
+import { fetchApi } from '@libs/fetch';
+import { Filters } from '@libs/filterInputs';
+import { NovelStatus } from '@libs/novelStatus';
+import { defaultCover } from '@libs/defaultCover';
+import { storage } from '@libs/storage';
+import { Plugin } from '@/types/plugin';
+import { load as parseHTML } from 'cheerio';
+
+type ImageKeys = {
+  featured_image?: string | null;
+  featured_image_key?: string | null;
+  featured_image_thumb_small_key?: string | null;
+  featured_image_thumb_medium_key?: string | null;
+};
+
+type NovelSummary = ImageKeys & {
+  id: number;
+  title: string;
+  slug: string;
+  novel_status?: string | null;
+};
+
+type Chapter = {
+  id: number;
+  title: string;
+  slug: string;
+  status: string;
+  sort_order?: number;
+  is_locked?: boolean;
+  user_has_access?: boolean;
+  scheduled_for?: string | null;
+  created_at?: string | null;
+};
+
+type Volume = {
+  order?: number;
+  chapters?: Chapter[];
+};
+
+type NovelDetails = NovelSummary & {
+  author_name?: string | null;
+  description?: string | null;
+  genres?: { name: string }[];
+  tags?: { name: string }[];
+  volumes?: Volume[];
+  chapters_pagination?: {
+    last_page?: number;
+  };
+};
+
+type ChapterDetails = {
+  id: number;
+  title: string;
+  content?: string | null;
+  locked?: boolean;
+  is_locked?: boolean;
+  user_has_access?: boolean;
+};
+
+type DataResponse<T> = {
+  data: T;
+};
+
+type SearchResponse<T> = {
+  results: T[];
+};
+
+class KonkonPlugin implements Plugin.PluginBase {
+  id = 'konkon';
+  name = 'Konkon';
+  icon = 'src/en/konkon/icon.png';
+  site = 'https://konkon.ink';
+  version = '1.0.0';
+  filters: Filters | undefined = undefined;
+  pluginSettings = {
+    hideLocked: {
+      value: '',
+      label: 'Hide locked chapters',
+      type: 'Switch',
+    },
+  };
+  hideLocked = storage.get('hideLocked');
+
+  private api = 'https://api-k.konkon.ink';
+  private pageSize = 20;
+
+  private async getJson<T>(path: string): Promise<T> {
+    const response = await fetchApi(this.api + path, {
+      headers: {
+        Accept: 'application/json',
+        Referer: this.site + '/',
+      },
+    });
+
+    if (!response.ok) {
+      throw new Error(
+        `Could not reach Konkon (${response.status}). Try opening the site in webview.`,
+      );
+    }
+
+    const contentType = response.headers.get('content-type') || '';
+    if (!contentType.includes('application/json')) {
+      throw new Error(
+        'Konkon returned an unexpected response. Try opening the site in webview.',
+      );
+    }
+
+    return (await response.json()) as T;
+  }
+
+  private encodeBase64(input: string): string {
+    const chars =
+      'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
+    let output = '';
+
+    for (
+      let block = 0, charCode, index = 0, map = chars;
+      input.charAt(index | 0) || ((map = '='), index % 1);
+      output += map.charAt(63 & (block >> (8 - (index % 1) * 8)))
+    ) {
+      charCode = input.charCodeAt((index += 3 / 4));
+      if (charCode > 0xff) {
+        throw new Error('Could not encode Konkon media path.');
+      }
+      block = (block << 8) | charCode;
+    }
+
+    return output;
+  }
+
+  private coverUrl(novel: ImageKeys): string {
+    const key =
+      novel.featured_image_thumb_medium_key ||
+      novel.featured_image_key ||
+      novel.featured_image_thumb_small_key ||
+      novel.featured_image;
+
+    if (!key) return defaultCover;
+    return `${this.api}/api/media/k/${this.encodeBase64(key)}`;
+  }
+
+  private toNovelItem(novel: NovelSummary): Plugin.NovelItem {
+    return {
+      name: novel.title || 'Untitled',
+      path: `/read/${novel.slug}`,
+      cover: this.coverUrl(novel),
+    };
+  }
+
+  async popularNovels(
+    pageNo: number,
+    { showLatestNovels }: Plugin.PopularNovelsOptions<typeof this.filters>,
+  ): Promise<Plugin.NovelItem[]> {
+    if (showLatestNovels) {
+      const response = await this.getJson<DataResponse<NovelSummary[]>>(
+        `/api/public/latest-updates?per_page=${this.pageSize}&page=${pageNo}`,
+      );
+      return response.data.map(novel => this.toNovelItem(novel));
+    }
+
+    const limit = pageNo * this.pageSize;
+    const response = await this.getJson<DataResponse<NovelSummary[]>>(
+      `/api/public/novels_trending?limit=${limit}`,
+    );
+    return response.data
+      .slice((pageNo - 1) * this.pageSize, limit)
+      .map(novel => this.toNovelItem(novel));
+  }
+
+  private status(status?: string | null): string {
+    switch (status?.toLowerCase()) {
+      case 'ongoing':
+        return NovelStatus.Ongoing;
+      case 'completed':
+      case 'complete':
+        return NovelStatus.Completed;
+      case 'cancelled':
+      case 'canceled':
+        return NovelStatus.Cancelled;
+      case 'hiatus':
+      case 'on hiatus':
+        return NovelStatus.OnHiatus;
+      default:
+        return NovelStatus.Unknown;
+    }
+  }
+
+  private readerHtml(html: string): string {
+    const content = parseHTML(html, undefined, false);
+    content('script, style').remove();
+    content('[style]').each((_, element) => {
+      const style = content(element).attr('style') || '';
+      const readerSafeStyle = style
+        .replace(/(^|;)\s*color\s*:[^;]*/gi, '$1')
+        .replace(/;{2,}/g, ';')
+        .replace(/^\s*;|;\s*$/g, '')
+        .trim();
+
+      if (readerSafeStyle) content(element).attr('style', readerSafeStyle);
+      else content(element).removeAttr('style');
+    });
+    return content.root().html() || html;
+  }
+
+  private summaryText(html: string): string {
+    const content = parseHTML(html, undefined, false);
+    const paragraphs = content('p')
+      .map((_, element) => content(element).text().trim())
+      .get()
+      .filter(Boolean);
+    return (
+      paragraphs.length ? paragraphs.join('\n\n') : content.text()
+    ).trim();
+  }
+
+  private async getNovelPage(
+    slug: string,
+    pageNo: number,
+  ): Promise<NovelDetails> {
+    const response = await this.getJson<DataResponse<NovelDetails>>(
+      `/api/public/novels/${encodeURIComponent(slug)}?page=${pageNo}&per_page=100`,
+    );
+    return response.data;
+  }
+
+  async parseNovel(novelPath: string): Promise<Plugin.SourceNovel> {
+    const slug = novelPath.replace(/^\/?read\//, '').split(/[?#]/)[0];
+    const firstPage = await this.getNovelPage(slug, 1);
+    const lastPage = Math.max(
+      1,
+      Number(firstPage.chapters_pagination?.last_page) || 1,
+    );
+    const pages = [firstPage];
+
+    for (let pageNo = 2; pageNo <= lastPage; pageNo += 1) {
+      pages.push(await this.getNovelPage(slug, pageNo));
+    }
+
+    const chapters = pages
+      .flatMap(page => page.volumes || [])
+      .sort((a, b) => (a.order || 0) - (b.order || 0))
+      .flatMap(volume =>
+        [...(volume.chapters || [])].sort(
+          (a, b) => (a.sort_order || 0) - (b.sort_order || 0),
+        ),
+      )
+      .filter(chapter => chapter.status === 'published')
+      .filter(
+        chapter =>
+          !this.hideLocked || !chapter.is_locked || chapter.user_has_access,
+      )
+      .map((chapter, index): Plugin.ChapterItem => {
+        const locked = Boolean(chapter.is_locked && !chapter.user_has_access);
+        return {
+          name: `${locked ? '🔒 ' : ''}${chapter.title}`,
+          path: `/read/chapter/${chapter.id}/${chapter.slug}`,
+          chapterNumber: index + 1,
+          releaseTime: chapter.scheduled_for || chapter.created_at || null,
+        };
+      });
+
+    const genres = [...(firstPage.genres || []), ...(firstPage.tags || [])]
+      .map(item => item.name)
+      .filter((name, index, all) => name && all.indexOf(name) === index)
+      .join(', ');
+
+    return {
+      name: firstPage.title || 'Untitled',
+      path: `/read/${firstPage.slug}`,
+      cover: this.coverUrl(firstPage),
+      author: firstPage.author_name || undefined,
+      genres,
+      summary: firstPage.description
+        ? this.summaryText(firstPage.description)
+        : undefined,
+      status: this.status(firstPage.novel_status),
+      chapters,
+    };
+  }
+
+  async parseChapter(chapterPath: string): Promise<string> {
+    const chapterId = chapterPath.match(/\/read\/chapter\/(\d+)/)?.[1];
+    if (!chapterId) throw new Error('Invalid chapter path.');
+
+    const response = await this.getJson<DataResponse<ChapterDetails>>(
+      `/api/public/chapters/${chapterId}`,
+    );
+    const chapter = response.data;
+
+    if ((chapter.locked || chapter.is_locked) && !chapter.user_has_access) {
+      throw new Error('This chapter is locked.');
+    }
+    if (!chapter.content) {
+      throw new Error('Konkon returned no chapter content.');
+    }
+
+    return this.readerHtml(chapter.content);
+  }
+
+  async searchNovels(
+    searchTerm: string,
+    pageNo: number,
+  ): Promise<Plugin.NovelItem[]> {
+    if (pageNo > 1) return [];
+    const response = await this.getJson<SearchResponse<NovelSummary>>(
+      `/api/public/search?q=${encodeURIComponent(searchTerm.trim())}`,
+    );
+
+    return response.results.map(novel => this.toNovelItem(novel));
+  }
+
+  resolveUrl = (path: string) => this.site + path;
+}
+
+export default new KonkonPlugin();