@media-engine/providers 0.1.0

package/dist/cinemeta/index.js

@@ -0,0 +1,379 @@
+import { fetchJson } from "../shared/index.js";
+const PROVIDER_NAME = "cinemeta";
+const DEFAULT_BASE_URL = "https://v3-cinemeta.strem.io";
+const DEFAULT_SEARCH_LIMIT = 10;
+const DEFAULT_ENRICH_SEARCH_LIMIT = 5;
+const DEFAULT_IMAGE_LIMIT = 10;
+const DEFAULT_PERSON_LIMIT = 30;
+// Creates a no-token movie and series provider backed by the public Cinemeta addon API.
+// Создает no-token provider фильмов и сериалов на публичном Cinemeta addon API.
+export function cinemetaProvider(options = {}) {
+    const config = createCinemetaConfig(options);
+    return {
+        name: PROVIDER_NAME,
+        version: options.version,
+        kind: "metadata",
+        capabilities: {
+            mediaTypes: ["movie", "series"],
+            search: {
+                byTitle: true,
+                byExternalIds: ["imdb"],
+            },
+            details: {
+                byExternalIds: ["imdb"],
+            },
+            features: ["posters", "backdrops", "ratings", "genres", "persons"],
+        },
+        async search(query, context) {
+            return searchCinemeta(config, query, context);
+        },
+        async getDetails(query, context) {
+            return getCinemetaDetails(config, query, context);
+        },
+    };
+}
+// Builds provider config from public options.
+// Собирает конфигурацию provider из публичных options.
+function createCinemetaConfig(options) {
+    return {
+        baseUrl: trimTrailingSlash(options.baseUrl ?? DEFAULT_BASE_URL),
+        fetch: options.fetch,
+        searchLimit: options.searchLimit ?? DEFAULT_SEARCH_LIMIT,
+        enrichSearchLimit: options.enrichSearchLimit ?? DEFAULT_ENRICH_SEARCH_LIMIT,
+        imageLimit: options.imageLimit ?? DEFAULT_IMAGE_LIMIT,
+        personLimit: options.personLimit ?? DEFAULT_PERSON_LIMIT,
+    };
+}
+// Searches Cinemeta catalog by title or IMDb ID.
+// Ищет в Cinemeta catalog по названию или IMDb ID.
+async function searchCinemeta(config, query, context) {
+    if (query.type === "anime") {
+        return [];
+    }
+    if (query.ids?.imdb) {
+        const details = await getDetailsByImdbId(config, query.ids.imdb, query.type, context);
+        return details ? [detailsToSearchResult(details, context.debug)] : [];
+    }
+    if (!query.title?.trim()) {
+        return [];
+    }
+    const types = query.type ? [query.type] : ["movie", "series"];
+    const results = await Promise.all(types.map(async (type) => searchCatalogType(config, type, query, context)));
+    return results.flat().sort((left, right) => (right.confidence ?? 0) - (left.confidence ?? 0));
+}
+// Loads Cinemeta details by IMDb ID.
+// Загружает Cinemeta details по IMDb ID.
+async function getCinemetaDetails(config, query, context) {
+    if (!query.ids?.imdb) {
+        return null;
+    }
+    const details = await getDetailsByImdbId(config, query.ids.imdb, query.type, context);
+    return details
+        ? {
+            provider: PROVIDER_NAME,
+            details,
+            source: createProviderSource(details.ids),
+            raw: context.debug ? details : undefined,
+            confidence: 1,
+        }
+        : null;
+}
+// Searches one Cinemeta catalog type.
+// Ищет один тип Cinemeta catalog.
+async function searchCatalogType(config, type, query, context) {
+    const url = new URL(`${config.baseUrl}/catalog/${toCinemetaType(type)}/top/search=${encodeURIComponent(query.title ?? "")}.json`);
+    const response = await requestJson(config, url, context);
+    const items = (response.metas ?? [])
+        .map((meta) => mapMetaToItem(meta, type))
+        .filter((item) => item !== undefined)
+        .filter((item) => query.year === undefined || item.year === query.year)
+        .slice(0, query.limit ?? config.searchLimit);
+    const enrichedItems = shouldEnrichSearchItems(query)
+        ? await enrichSearchItems(config, type, items, context)
+        : items;
+    return enrichedItems.map((item) => createSearchResult(item, context.debug));
+}
+// Keeps broad title-only search responsive by avoiding extra per-item meta requests.
+// Сохраняет быстрым широкий title-only поиск, избегая дополнительных meta-запросов на каждый item.
+function shouldEnrichSearchItems(query) {
+    return query.year !== undefined || Boolean(query.ids?.imdb);
+}
+// Enriches top search candidates with meta details when catalog search is sparse.
+// Обогащает верхние search-кандидаты meta-деталями, когда catalog search возвращает мало данных.
+async function enrichSearchItems(config, type, items, context) {
+    const enriched = await Promise.all(items.map(async (item, index) => {
+        if (index >= config.enrichSearchLimit || !item.ids?.imdb || hasSearchQuality(item)) {
+            return item;
+        }
+        try {
+            const details = await getDetailsByImdbId(config, item.ids.imdb, type, context);
+            return details ? detailsToItem(details) : item;
+        }
+        catch {
+            return item;
+        }
+    }));
+    return enriched;
+}
+// Checks whether a catalog item already has enough data for ranking and display.
+// Проверяет, достаточно ли данных catalog item для ранжирования и отображения.
+function hasSearchQuality(item) {
+    return Boolean(item.ratings?.length && item.description && item.genres?.length);
+}
+// Normalizes a title enough to decide whether it is broad or specific.
+// Нормализует title достаточно для решения, широкий это запрос или конкретный.
+// Loads one Cinemeta meta document.
+// Загружает один Cinemeta meta document.
+async function getDetailsByImdbId(config, imdbId, type, context) {
+    const types = type === "movie" || type === "series"
+        ? [type]
+        : type === "anime"
+            ? ["series"]
+            : ["movie", "series"];
+    const loadType = async (currentType) => {
+        const url = new URL(`${config.baseUrl}/meta/${toCinemetaType(currentType)}/${imdbId}.json`);
+        const response = await requestJson(config, url, context);
+        return response.meta ? metaToDetails(config, response.meta, currentType) : null;
+    };
+    if (types.length === 1) {
+        return loadType(types[0]);
+    }
+    const results = await Promise.all(types.map((currentType) => loadType(currentType).catch(() => null)));
+    return results.find((details) => details !== null) ?? null;
+}
+// Maps Cinemeta summary into compact MediaItem.
+// Мапит Cinemeta summary в compact MediaItem.
+function mapMetaToItem(meta, type) {
+    const imdbId = meta.imdb_id ?? meta.id;
+    const title = meta.name;
+    if (!imdbId || !title) {
+        return undefined;
+    }
+    const ids = createIds(meta, imdbId);
+    return {
+        id: `${PROVIDER_NAME}-${type}-${imdbId}`,
+        type,
+        title,
+        year: getYear(meta.releaseInfo),
+        description: meta.description,
+        poster: createImage(meta.poster, "poster"),
+        backdrop: createImage(meta.background, "backdrop"),
+        genres: mapGenres(meta.genre ?? meta.genres),
+        ratings: mapRating(meta.imdbRating),
+        ids,
+    };
+}
+// Converts Cinemeta meta details into movie or series details.
+// Преобразует Cinemeta meta details в movie или series details.
+function metaToDetails(config, meta, type) {
+    const item = mapMetaToItem(meta, type);
+    if (!item) {
+        return null;
+    }
+    const detailsBase = {
+        ...item,
+        runtimeMinutes: parseRuntime(meta.runtime),
+        countries: parseList(meta.country),
+        images: [item.poster, item.backdrop]
+            .filter((image) => Boolean(image))
+            .slice(0, config.imageLimit),
+        persons: mapPersons(meta, config.personLimit),
+        sourceProviders: [createProviderSource(item.ids)],
+    };
+    return type === "series"
+        ? {
+            ...detailsBase,
+            type: "series",
+            status: mapStatus(meta.status),
+            episodesCount: countSeriesEpisodes(meta.videos),
+            seasonsCount: countSeriesSeasons(meta.videos),
+        }
+        : { ...detailsBase, type: "movie" };
+}
+// Creates a provider search result with source attribution.
+// Создает provider search result с source attribution.
+function createSearchResult(item, debug) {
+    return {
+        provider: PROVIDER_NAME,
+        item,
+        source: createProviderSource(item.ids),
+        raw: debug ? item : undefined,
+        confidence: item.ids?.imdb ? 0.95 : 0.8,
+    };
+}
+// Converts details back to a search result for IMDb ID search.
+// Преобразует details обратно в search result для поиска по IMDb ID.
+function detailsToSearchResult(details, debug) {
+    return createSearchResult(detailsToItem(details), debug);
+}
+// Converts details into the compact search item shape.
+// Преобразует details в компактную форму search item.
+function detailsToItem(details) {
+    return {
+        id: details.id,
+        type: details.type,
+        title: details.title,
+        year: details.year,
+        description: details.description,
+        poster: details.poster,
+        backdrop: details.backdrop,
+        genres: details.genres,
+        ratings: details.ratings,
+        ids: details.ids,
+    };
+}
+// Creates normalized external IDs from Cinemeta IDs.
+// Создает normalized external IDs из Cinemeta IDs.
+function createIds(meta, imdbId) {
+    return {
+        imdb: imdbId,
+        tmdb: meta.moviedb_id ? String(meta.moviedb_id) : undefined,
+    };
+}
+// Creates source attribution for Cinemeta results.
+// Создает source attribution для результатов Cinemeta.
+function createProviderSource(ids) {
+    return {
+        provider: PROVIDER_NAME,
+        ids,
+        url: ids?.imdb ? `https://www.imdb.com/title/${ids.imdb}/` : undefined,
+    };
+}
+// Maps genre labels into normalized genre objects.
+// Мапит genre labels в normalized genre objects.
+function mapGenres(genres) {
+    return genres?.map((genre) => ({
+        name: genre,
+        source: PROVIDER_NAME,
+    }));
+}
+// Maps IMDb rating from Cinemeta into normalized rating.
+// Мапит IMDb rating из Cinemeta в normalized rating.
+function mapRating(value) {
+    const parsed = value ? Number(value) : undefined;
+    return parsed && Number.isFinite(parsed)
+        ? [
+            {
+                source: "imdb",
+                value: parsed,
+                max: 10,
+            },
+        ]
+        : undefined;
+}
+// Maps simple people arrays into normalized persons.
+// Мапит простые people arrays в normalized persons.
+function mapPersons(meta, limit) {
+    const directors = (meta.director ?? []).map((name) => ({
+        person: { name },
+        roles: ["director"],
+    }));
+    const writers = (meta.writer ?? []).map((name) => ({
+        person: { name },
+        roles: ["writer"],
+    }));
+    const actors = (meta.cast ?? []).map((name, order) => ({
+        person: { name },
+        roles: ["actor"],
+        order,
+    }));
+    const persons = [...directors, ...writers, ...actors].slice(0, limit);
+    return persons.length ? persons : undefined;
+}
+function createImage(url, type) {
+    return url
+        ? {
+            url,
+            type,
+            source: PROVIDER_NAME,
+        }
+        : undefined;
+}
+// Requests JSON through the shared provider HTTP helper.
+// Запрашивает JSON через общий provider HTTP helper.
+function requestJson(config, url, context) {
+    return fetchJson({
+        provider: PROVIDER_NAME,
+        url,
+        context,
+        fetch: config.fetch,
+        init: {
+            headers: {
+                accept: "application/json",
+            },
+        },
+    });
+}
+// Converts normalized media type to Cinemeta route type.
+// Конвертирует normalized media type в Cinemeta route type.
+function toCinemetaType(type) {
+    return type;
+}
+// Extracts the first four-digit year from Cinemeta release info.
+// Достает первый четырехзначный год из Cinemeta release info.
+function getYear(value) {
+    const match = value?.match(/\d{4}/);
+    return match ? Number(match[0]) : undefined;
+}
+// Parses the first runtime number from Cinemeta runtime text.
+// Парсит первое число runtime из Cinemeta runtime text.
+function parseRuntime(runtime) {
+    const match = runtime?.match(/\d+/);
+    return match ? Number(match[0]) : undefined;
+}
+// Splits comma-separated Cinemeta values into normalized strings.
+// Разбивает comma-separated Cinemeta values в normalized strings.
+function parseList(value) {
+    return value
+        ?.split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+}
+// Maps Cinemeta lifecycle status into the core status vocabulary.
+// Мапит lifecycle status Cinemeta в словарь status из core.
+function mapStatus(status) {
+    switch (status?.toLowerCase()) {
+        case "ended":
+            return "ended";
+        case "returning series":
+            return "ongoing";
+        case "in production":
+            return "in_production";
+        case "planned":
+        case "pilot":
+            return "announced";
+        case "canceled":
+        case "cancelled":
+            return "canceled";
+        default:
+            return undefined;
+    }
+}
+// Counts regular series episodes while ignoring specials from season 0.
+// Считает обычные эпизоды сериала, игнорируя specials из season 0.
+function countSeriesEpisodes(videos) {
+    const count = videos?.filter((video) => isRegularEpisode(video)).length ?? 0;
+    return count > 0 ? count : undefined;
+}
+// Counts seasons that contain regular episodes.
+// Считает сезоны, в которых есть обычные эпизоды.
+function countSeriesSeasons(videos) {
+    const seasons = new Set(videos
+        ?.filter((video) => isRegularEpisode(video))
+        .map((video) => video.season)
+        .filter((season) => typeof season === "number" && season > 0));
+    return seasons.size > 0 ? seasons.size : undefined;
+}
+// Checks whether a Cinemeta video is a regular numbered episode.
+// Проверяет, является ли Cinemeta video обычным номерным эпизодом.
+function isRegularEpisode(video) {
+    return (typeof video.season === "number" &&
+        video.season > 0 &&
+        (typeof video.number === "number" || typeof video.episode === "number"));
+}
+// Removes trailing slashes so URL paths are built consistently.
+// Убирает trailing slashes, чтобы URL paths собирались одинаково.
+function trimTrailingSlash(value) {
+    return value.replace(/\/+$/, "");
+}
+//# sourceMappingURL=index.js.map

package/dist/cinemeta/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cinemeta/index.ts"],"names":[],"mappings":"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"}

package/dist/experimental-streaming/index.d.ts

@@ -0,0 +1,24 @@
+import type { ExternalIds, MediaType, StreamEpisodeRef, StreamOption, StreamingProvider } from "@media-engine/core";
+export interface ExperimentalStreamingProviderOptions {
+    name?: string;
+    version?: string;
+    entries: ExperimentalStreamingEntry[];
+}
+export interface ExperimentalStreamingEntry {
+    type: MediaType;
+    title?: string;
+    originalTitle?: string;
+    year?: number;
+    ids?: ExternalIds;
+    sourceUrl?: string;
+    options?: ExperimentalStreamOptionInput[];
+    episodes?: ExperimentalStreamingEpisode[];
+}
+export interface ExperimentalStreamingEpisode extends StreamEpisodeRef {
+    title?: string;
+    options: ExperimentalStreamOptionInput[];
+}
+export type ExperimentalStreamOptionInput = Omit<StreamOption, "provider"> & {
+    provider?: string;
+};
+export declare function experimentalStreamingProvider(options: ExperimentalStreamingProviderOptions): StreamingProvider;

package/dist/experimental-streaming/index.js

@@ -0,0 +1,199 @@
+const DEFAULT_PROVIDER_NAME = "experimental-streaming";
+const EXTERNAL_ID_SOURCES = [
+    "imdb",
+    "tmdb",
+    "kinopoisk",
+    "shikimori",
+    "myAnimeList",
+    "aniList",
+    "worldArt",
+];
+// Creates a configured streaming provider for architecture validation.
+// Создает настроенный streaming-провайдер для проверки архитектуры.
+export function experimentalStreamingProvider(options) {
+    const name = normalizeProviderName(options.name ?? DEFAULT_PROVIDER_NAME);
+    const entries = options.entries.map(normalizeEntry);
+    const capabilities = createCapabilities(entries);
+    return {
+        name,
+        version: options.version,
+        kind: "streaming",
+        capabilities,
+        async getAvailability(query, context) {
+            return getExperimentalAvailability(name, entries, query, context);
+        },
+    };
+}
+// Validates and normalizes provider name.
+// Проверяет и нормализует имя провайдера.
+function normalizeProviderName(name) {
+    const normalized = name.trim();
+    if (!normalized) {
+        throw new TypeError("Experimental streaming provider name is required.");
+    }
+    return normalized;
+}
+// Adds lookup helpers without changing the public entry shape.
+// Добавляет lookup helpers без изменения публичной формы записи.
+function normalizeEntry(entry) {
+    return {
+        ...entry,
+        titleKey: entry.title ? normalizeTitle(entry.title) : undefined,
+    };
+}
+// Builds safe capabilities from configured entries.
+// Собирает безопасные capabilities из настроенных записей.
+function createCapabilities(entries) {
+    return {
+        mediaTypes: unique(entries.map((entry) => entry.type)),
+        lookup: {
+            byTitle: entries.some((entry) => Boolean(entry.title)),
+            byExternalIds: collectExternalIdSources(entries),
+            byEpisode: entries.some((entry) => Boolean(entry.episodes?.length) ||
+                Boolean(entry.options?.some((option) => hasEpisodeRef(option.episode)))),
+        },
+        features: ["embed", "external", "translations", "subtitles", "qualities", "episode_mapping"],
+    };
+}
+// Resolves availability for a single stream query.
+// Получает доступность для одного stream-запроса.
+async function getExperimentalAvailability(providerName, entries, query, context) {
+    if (query.providers && !query.providers.includes(providerName)) {
+        return null;
+    }
+    const entry = entries.find((candidate) => matchesEntry(candidate, query));
+    if (!entry) {
+        return null;
+    }
+    if (context.signal?.aborted) {
+        throw context.signal.reason;
+    }
+    const episodes = filterEpisodes(providerName, entry, query);
+    const topLevelOptions = filterTopLevelOptions(providerName, entry, query);
+    const episodeOptions = episodes.flatMap((episode) => episode.options);
+    const options = [...topLevelOptions, ...episodeOptions];
+    return {
+        query,
+        item: {
+            type: entry.type,
+            title: entry.title,
+            originalTitle: entry.originalTitle,
+            year: entry.year,
+            ids: entry.ids,
+        },
+        episodes: episodes.length > 0 ? episodes : undefined,
+        options,
+        sourceProviders: [
+            {
+                provider: providerName,
+                ids: entry.ids,
+                url: entry.sourceUrl,
+            },
+        ],
+        checkedAt: new Date().toISOString(),
+    };
+}
+// Checks whether a configured entry can answer the query.
+// Проверяет, может ли настроенная запись ответить на запрос.
+function matchesEntry(entry, query) {
+    if (entry.type !== query.type) {
+        return false;
+    }
+    if (matchesAnyExternalId(entry.ids, query.ids)) {
+        return true;
+    }
+    if (!entry.titleKey || !query.title) {
+        return false;
+    }
+    return entry.titleKey === normalizeTitle(query.title) && matchesYear(entry.year, query.year);
+}
+// Filters episode blocks for an episode-aware query.
+// Фильтрует блоки эпизодов для episode-aware запроса.
+function filterEpisodes(providerName, entry, query) {
+    return (entry.episodes ?? [])
+        .filter((episode) => matchesEpisode(episode, query))
+        .map((episode) => ({
+        seasonNumber: episode.seasonNumber,
+        episodeNumber: episode.episodeNumber,
+        absoluteEpisodeNumber: episode.absoluteEpisodeNumber,
+        title: episode.title,
+        options: episode.options.map((option) => normalizeOption(providerName, option, episode)),
+    }));
+}
+// Filters top-level options and keeps only requested episode options when needed.
+// Фильтрует верхнеуровневые варианты и оставляет варианты нужного эпизода при запросе.
+function filterTopLevelOptions(providerName, entry, query) {
+    return (entry.options ?? [])
+        .filter((option) => matchesEpisode(option.episode, query))
+        .map((option) => normalizeOption(providerName, option, option.episode));
+}
+// Fills provider and episode fields on a stream option.
+// Заполняет provider и episode поля в stream-варианте.
+function normalizeOption(providerName, option, episode) {
+    return {
+        ...option,
+        provider: option.provider ?? providerName,
+        episode: option.episode ?? episode,
+    };
+}
+// Checks exact external ID overlap between entry and query.
+// Проверяет точное пересечение внешних ID между записью и запросом.
+function matchesAnyExternalId(entryIds, queryIds) {
+    if (!entryIds || !queryIds) {
+        return false;
+    }
+    return EXTERNAL_ID_SOURCES.some((source) => entryIds[source] !== undefined && entryIds[source] === queryIds[source]);
+}
+// Checks whether years are compatible when both sides provide them.
+// Проверяет совместимость годов, если обе стороны их передали.
+function matchesYear(entryYear, queryYear) {
+    return entryYear === undefined || queryYear === undefined || entryYear === queryYear;
+}
+// Checks whether an episode reference matches the episode fields from query.
+// Проверяет, совпадает ли ссылка на эпизод с episode-полями запроса.
+function matchesEpisode(episode, query) {
+    if (!hasEpisodeQuery(query)) {
+        return true;
+    }
+    if (!episode) {
+        return false;
+    }
+    return (matchesOptionalNumber(episode.seasonNumber, query.seasonNumber) &&
+        matchesOptionalNumber(episode.episodeNumber, query.episodeNumber) &&
+        matchesOptionalNumber(episode.absoluteEpisodeNumber, query.absoluteEpisodeNumber));
+}
+// Checks whether query contains episode targeting fields.
+// Проверяет, содержит ли query поля выбора эпизода.
+function hasEpisodeQuery(query) {
+    return (query.seasonNumber !== undefined ||
+        query.episodeNumber !== undefined ||
+        query.absoluteEpisodeNumber !== undefined);
+}
+// Checks whether an option or configured episode has any episode reference.
+// Проверяет, есть ли у варианта или настроенного эпизода ссылка на эпизод.
+function hasEpisodeRef(episode) {
+    return (episode?.seasonNumber !== undefined ||
+        episode?.episodeNumber !== undefined ||
+        episode?.absoluteEpisodeNumber !== undefined);
+}
+// Matches optional numeric fields strictly when query value exists.
+// Строго сравнивает опциональные числовые поля, если query значение есть.
+function matchesOptionalNumber(value, queryValue) {
+    return queryValue === undefined || value === queryValue;
+}
+// Collects external ID sources present in configured entries.
+// Собирает источники внешних ID из настроенных записей.
+function collectExternalIdSources(entries) {
+    return EXTERNAL_ID_SOURCES.filter((source) => entries.some((entry) => entry.ids?.[source] !== undefined));
+}
+// Normalizes titles for exact configured-title lookup.
+// Нормализует названия для точного поиска по настроенному title.
+function normalizeTitle(title) {
+    return title.trim().toLocaleLowerCase().replace(/\s+/g, " ");
+}
+// Keeps array values unique while preserving order.
+// Оставляет уникальные значения массива с сохранением порядка.
+function unique(values) {
+    return [...new Set(values)];
+}
+//# sourceMappingURL=index.js.map

package/dist/experimental-streaming/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/experimental-streaming/index.ts"],"names":[],"mappings":"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"}

package/dist/flixhq-streaming/index.d.ts

@@ -0,0 +1,30 @@
+import type { StreamEpisodeRef, StreamingProvider, SubtitleTrack } from "@media-engine/core";
+import { type ProviderFetch } from "../shared/index.js";
+export interface FlixHqStreamingProviderOptions {
+    baseUrl?: string;
+    name?: string;
+    version?: string;
+    fetch?: ProviderFetch;
+    maxHtmlBytes?: number;
+    playerLimit?: number;
+    playerValidationConcurrency?: number;
+    playerValidationTimeoutMs?: number;
+    playerValidationMaxBytes?: number;
+    subtitleInfoMaxBytes?: number;
+    userAgent?: string;
+}
+interface SearchCandidate {
+    mediaUrl: string;
+    title: string;
+    year?: number;
+    type: "movie" | "series";
+}
+interface EpisodeCandidate extends StreamEpisodeRef {
+    url: string;
+    title?: string;
+}
+export declare function flixHqStreamingProvider(options?: FlixHqStreamingProviderOptions): StreamingProvider;
+export declare function parseSubtitleInfo(value: string): SubtitleTrack[];
+export declare function parseSearchCandidates(html: string): SearchCandidate[];
+export declare function parseEpisodes(html: string): EpisodeCandidate[];
+export {};