lnreader-plugins/types/plugin.ts

import { Filter } from "@libs/filterInputs";
import { languages } from "@libs/languages";
export namespace Plugin {
    export interface ChapterItem {
        name: string;
        url: string;
        releaseTime?: string | null;
    }
    export interface NovelItem {
        name: string;
        url: string;
        cover?: string;
    }
    export interface SourceNovel {
        url: string;
        name?: string;
        cover?: string;
        genres?: string;
        summary?: string;
        author?: string;
        artist?: string;
        status?: string;
        chapters?: ChapterItem[];
    }
    export interface PopularNovelsOptions {
        showLatestNovels?: boolean;
        filters?: Record<string, string | string[]>;
    }
    export interface PluginItem {
        id: string;
        name: string;
        lang: (typeof languages)[keyof typeof languages];
        version: string;
        requirePath: string;
        icon: string;
    }

    export interface PluginBase {
        id: string,
        name: string,
        /** 
         * Relative path without icon. E.g: 
         * ```js
         * "src/vi/hakolightnovel/icon.png"
         * ```
         */
        icon: string;
        site: string;
        filters?: Filter[];
        version: string;
        userAgent: string;
        cookieString: string;
        popularNovels(pageNo: number, options: PopularNovelsOptions): Promise<NovelItem[]>;
        parseNovelAndChapters(novelUrl: string): Promise<SourceNovel>;
        parseChapter(chapterUrl: string): Promise<string>;
        searchNovels(searchTerm: string, pageNo?: number): Promise<NovelItem[]>;
        /**
         * 
         * @param url Image url
         * @returns {string} Base64 of image
         * @example
         * ```ts
         *  const headers = {
         *      Referer: "https://ln.hako.vn",
         *   };
         *  return await fetchFile(url, { headers: headers });
         * ```
         */
        fetchImage(url: string): Promise<string | undefined>;
    }
}

export const isPlugin = (p: any): p is Plugin.PluginBase => {
    const pl = p as Plugin.PluginBase;

    const errorOut = (key: string) => {
        console.error(`Plugin ${pl.name} doesn't have ${key}!`);
        return false;
    };

    const required_funcs: (keyof Plugin.PluginBase)[] = [
        "popularNovels",
        "parseNovelAndChapters",
        "parseChapter",
        "searchNovels",
        "fetchImage",
    ];
    for (let i = 0; i < required_funcs.length; i++) {
        const key = required_funcs[i];
        if (!pl[key] || typeof pl[key] !== "function") return errorOut(key);
    }
    const requireds_fields: (keyof Plugin.PluginBase)[] = [
        "id",
        "name",
        "version",
        "icon",
        "site",
        "userAgent",
        "cookieString",
    ];
    for (let i = 0; i < requireds_fields.length; i++) {
        const key = requireds_fields[i];
        if (pl[key] === undefined) return errorOut(key);
    }

    return true;
};