@media-engine/providers 1.8.1 → 1.10.0

package/README.ru.md

@@ -1,170 +1,178 @@
-# @media-engine/providers
-
-[English](https://github.com/Yaneart/media-engine/blob/main/packages/providers/README.md) | **Русский**
-
-Это готовые источники данных для Media Engine. Установите пакет, если хотите искать в реальных
-публичных каталогах и не писать адаптеры самостоятельно.
-
-## Установка
-
-```bash
-npm install @media-engine/core @media-engine/providers
-```
-
-Для встроенных провайдеров ваши API-ключи не нужны.
-
-## Поиск метаданных
-
-```ts
-import { MediaEngine } from "@media-engine/core";
-import {
-  aniListProvider,
-  cinemetaProvider,
-  kinobdProvider,
-  shikimoriProvider,
-} from "@media-engine/providers";
-
-const media = new MediaEngine({
-  providers: [
-    kinobdProvider(),
-    cinemetaProvider(),
-    shikimoriProvider(),
-    aniListProvider(),
-  ],
-});
-
-const result = await media.search({ title: "Ван-Пис" });
-```
-
-Подключайте только те источники, которые нужны вашему приложению. Движок сам вызовет подходящие
-провайдеры и объединит совпадающие результаты.
-
-Shikimori и AniList также поддерживают явные связи между аниме:
-
-В деталях Shikimori первый доступный полноразмерный кадр нормализуется как горизонтальный
-`backdrop`, а остальные кадры сохраняются как `still`. Более широкий баннер AniList остаётся
-резервным вариантом.
-Для объединённых постеров аниме Core предпочитает более качественный `coverImage.extraLarge` из
-AniList, если провайдеры не передали размеры изображений.
-
-```ts
-const relations = await media.getRelatedMedia({
-  shikimori: "52991",
-  type: "anime",
-});
-```
-
-Ответ сохраняет официальные типы связей — приквел, сиквел, побочную историю и другие — без
-группировки по эвристикам названия франшизы.
-
-Готовые провайдеры метаданных:
-
-- `kinobdProvider()` и `cinemetaProvider()` для фильмов и сериалов;
-- `shikimoriProvider()` и `aniListProvider()` для аниме;
-- `tvMazeProvider()` и `wikidataProvider()` как дополнительные источники идентичности;
-- `imdbDatasetProvider()` для IMDb-датасета, которым управляет ваше приложение.
-
-Данные TVmaze требуют указания источника. Сохраняйте и показывайте ссылку TVmaze, которая приходит
-в результате. Подробности есть в [лицензии API TVmaze](https://www.tvmaze.com/api#licensing).
-
-Опциональные инструменты для SQLite-индекса IMDb требуют Node.js 22.13 или новее. Для остального
-пакета достаточно Node.js 20.
-
-## Поиск вариантов просмотра
-
-```ts
-import {
-  flixHqStreamingProvider,
-  kinobdStreamingProvider,
-} from "@media-engine/providers";
-
-const media = new MediaEngine({
-  streamingProviders: [kinobdStreamingProvider(), flixHqStreamingProvider()],
-});
-
-const result = await media.getAvailability({
-  type: "series",
-  title: "Игра престолов",
-  seasonNumber: 1,
-  episodeNumber: 1,
-});
-
-for await (const snapshot of media.getAvailabilityProgressively({
-  type: "series",
-  ids: { kinopoisk: "435" },
-  seasonNumber: 1,
-  episodeNumber: 1,
-})) {
-  updatePlayerSources(snapshot.availability?.options ?? []);
-}
-```
-
-Пакет также экспортирует `ddbbStreamingProvider()`, `aniLibertyStreamingProvider()`,
-`filmixStreamingProvider()`, `veoVeoStreamingProvider()`, `videoHubStreamingProvider()`,
-`rutubeStreamingProvider()` и
-`experimentalStreamingProvider()`.
-Подключайте их явно, если они
-подходят вашему приложению. Гостевой режим Filmix ограничен 480p и отбрасывает известные заглушки о
-блокировке и служебные видео. Собственный device token повышает предел до 720p. Для авторизации
-обязателен HTTPS `baseUrl`, если приложение явно не включило `allowInsecureHttpToken` для локальной
-проверки совместимости. Этот режим отправляет токен без TLS и не должен использоваться в публичном
-развёртывании. Ссылки на видео CDN используют HTTPS. VeoVeo использует DDBB только для получения публичного
-content ID, отбрасывает iframe-токен и возвращает прямой подписанный HTTPS HLS.
-VideoHUB ищет по ID Кинопоиска и одним запросом playlist возвращает каталог сезонов и серий аниме.
-Для воспроизведения сериала или аниме нужна точная серия: аниме можно запросить по абсолютному номеру
-либо по паре сезон/серия; ответ сохраняет обе идентичности. Он возвращает
-короткоживущие прямые MP4 в нескольких качествах. Ссылки привязаны к User-Agent проигрывающего
-клиента и могут быть привязаны к внешнему IP. Передавайте точный User-Agent клиента через
-`MediaEngineOperationOptions.playbackUserAgent`; для небраузерных клиентов нужное значение также
-сохраняется в `access.headers` каждого варианта.
-VideoHUB поддерживает прогрессивную доступность: каждый готовый перевод можно показать, не ожидая
-более медленных lookup. Ограниченный warm-cache раздельно хранит плейлисты и ещё действующие
-подписанные video resolutions, никогда не выдаёт подписанные ссылки stale и сохраняет их исходный
-срок действия.
-Rutube выполняет ограниченный точный поиск фильма по названию и году и возвращает только
-официальный публичный embed-плеер Rutube. Прямые media-URL не извлекаются и не проксируются;
-сериалы намеренно не поддерживаются.
-
-Эти провайдеры возвращают сторонние ссылки или потоки. Media Engine не хранит видео, а внешний
-плеер может быть недоступен в конкретной стране, сети или браузере.
-
-## Поиск torrent-раздач
-
-Torrent-провайдеры всегда подключаются явно:
-
-```ts
-import {
-  bitsearchTorrentProvider,
-  jacRedTorrentProvider,
-  magnetzTorrentProvider,
-  ytsTorrentProvider,
-} from "@media-engine/providers";
-
-const media = new MediaEngine({
-  torrentProviders: [
-    ytsTorrentProvider(),
-    jacRedTorrentProvider(),
-    bitsearchTorrentProvider(),
-    magnetzTorrentProvider(),
-  ],
-});
-
-const result = await media.discoverTorrents({
-  type: "movie",
-  title: "Начало",
-  year: 2010,
-  ids: { imdb: "tt1375666" },
-});
-```
-
-Поиск только возвращает список кандидатов и данные для дальнейшей передачи. Он не загружает
-torrent metadata, не обращается к trackers, не подключается к раздаче и не воспроизводит файл.
-
-Публичные источники могут меняться, ограничивать запросы или временно не работать. Оставляйте кэш
-движка включённым и будьте готовы к частичным результатам. Настройки и границы безопасности каждого
-источника описаны в
-[документации провайдеров](https://github.com/Yaneart/media-engine/blob/main/docs/providers.md).
-
-## Лицензия
-
-MIT
+# @media-engine/providers
+
+[English](https://github.com/Yaneart/media-engine/blob/main/packages/providers/README.md) | **Русский**
+
+Это готовые источники данных для Media Engine. Установите пакет, если хотите искать в реальных
+публичных каталогах и не писать адаптеры самостоятельно.
+
+## Установка
+
+```bash
+npm install @media-engine/core @media-engine/providers
+```
+
+Для встроенных провайдеров ваши API-ключи не нужны.
+
+## Поиск метаданных
+
+```ts
+import { MediaEngine } from "@media-engine/core";
+import {
+  aniListProvider,
+  cinemetaProvider,
+  kinobdProvider,
+  tmdbProvider,
+  shikimoriProvider,
+} from "@media-engine/providers";
+
+const media = new MediaEngine({
+  providers: [
+    kinobdProvider(),
+    tmdbProvider(),
+    cinemetaProvider(),
+    shikimoriProvider(),
+    aniListProvider(),
+  ],
+});
+
+const result = await media.search({ title: "Ван-Пис" });
+```
+
+Подключайте только те источники, которые нужны вашему приложению. Движок сам вызовет подходящие
+провайдеры и объединит совпадающие результаты.
+
+Shikimori и AniList также поддерживают явные связи между аниме:
+
+В деталях Shikimori первый доступный полноразмерный кадр нормализуется как горизонтальный
+`backdrop`, а остальные кадры сохраняются как `still`. Более широкий баннер AniList остаётся
+резервным вариантом.
+Для объединённых постеров аниме Core предпочитает более качественный `coverImage.extraLarge` из
+AniList, если провайдеры не передали размеры изображений.
+
+```ts
+const relations = await media.getRelatedMedia({
+  shikimori: "52991",
+  type: "anime",
+});
+```
+
+Ответ сохраняет официальные типы связей — приквел, сиквел, побочную историю и другие — без
+группировки по эвристикам названия франшизы.
+
+Готовые провайдеры метаданных:
+
+- `tmdbProvider()` для локализованных данных фильмов и сериалов через публичный Stremio addon;
+- `kinobdProvider()` и `cinemetaProvider()` как независимые источники фильмов и сериалов;
+- `shikimoriProvider()` и `aniListProvider()` для аниме;
+- `tvMazeProvider()` и `wikidataProvider()` как дополнительные источники идентичности;
+- `imdbDatasetProvider()` для IMDb-датасета, которым управляет ваше приложение.
+
+Данные TVmaze требуют указания источника. Сохраняйте и показывайте ссылку TVmaze, которая приходит
+в результате. Подробности есть в [лицензии API TVmaze](https://www.tvmaze.com/api#licensing).
+
+`tmdbProvider()` использует публичный [TMDB Stremio addon](https://github.com/mrcanelas/tmdb-addon)
+и не требует пользовательского токена. Адрес сервиса можно заменить через `baseUrl`; при его сбое
+Cinemeta продолжает работать. Приложению, показывающему данные TMDB, нужно соблюдать
+[требования к указанию источника](https://developer.themoviedb.org/docs/faq).
+
+Опциональные инструменты для SQLite-индекса IMDb требуют Node.js 22.13 или новее. Для остального
+пакета достаточно Node.js 20.
+
+## Поиск вариантов просмотра
+
+```ts
+import {
+  flixHqStreamingProvider,
+  kinobdStreamingProvider,
+} from "@media-engine/providers";
+
+const media = new MediaEngine({
+  streamingProviders: [kinobdStreamingProvider(), flixHqStreamingProvider()],
+});
+
+const result = await media.getAvailability({
+  type: "series",
+  title: "Игра престолов",
+  seasonNumber: 1,
+  episodeNumber: 1,
+});
+
+for await (const snapshot of media.getAvailabilityProgressively({
+  type: "series",
+  ids: { kinopoisk: "435" },
+  seasonNumber: 1,
+  episodeNumber: 1,
+})) {
+  updatePlayerSources(snapshot.availability?.options ?? []);
+}
+```
+
+Пакет также экспортирует `ddbbStreamingProvider()`, `aniLibertyStreamingProvider()`,
+`filmixStreamingProvider()`, `veoVeoStreamingProvider()`, `videoHubStreamingProvider()`,
+`rutubeStreamingProvider()` и
+`experimentalStreamingProvider()`.
+Подключайте их явно, если они
+подходят вашему приложению. Гостевой режим Filmix ограничен 480p и отбрасывает известные заглушки о
+блокировке и служебные видео. Собственный device token повышает предел до 720p. Для авторизации
+обязателен HTTPS `baseUrl`, если приложение явно не включило `allowInsecureHttpToken` для локальной
+проверки совместимости. Этот режим отправляет токен без TLS и не должен использоваться в публичном
+развёртывании. Ссылки на видео CDN используют HTTPS. VeoVeo использует DDBB только для получения публичного
+content ID, отбрасывает iframe-токен и возвращает прямой подписанный HTTPS HLS.
+VideoHUB ищет по ID Кинопоиска и возвращает короткоживущие прямые MP4 для фильмов или одной точной
+серии сериала. VeoVeo и VideoHUB принимают аниме только с подтверждённым `animeKind: "movie"`;
+эпизодное аниме остаётся на совместимых с аниме провайдерах. Ответ для аниме-фильма сохраняет
+`type: "anime"`. Ссылки VideoHUB привязаны к User-Agent проигрывающего
+клиента и могут быть привязаны к внешнему IP. Передавайте точный User-Agent клиента через
+`MediaEngineOperationOptions.playbackUserAgent`; для небраузерных клиентов нужное значение также
+сохраняется в `access.headers` каждого варианта.
+VideoHUB поддерживает прогрессивную доступность: каждый готовый перевод можно показать, не ожидая
+более медленных lookup. Ограниченный warm-cache раздельно хранит плейлисты и ещё действующие
+подписанные video resolutions, никогда не выдаёт подписанные ссылки stale и сохраняет их исходный
+срок действия.
+Rutube выполняет ограниченный точный поиск фильма по названию и году и возвращает только
+официальный публичный embed-плеер Rutube. Прямые media-URL не извлекаются и не проксируются;
+сериалы намеренно не поддерживаются.
+
+Эти провайдеры возвращают сторонние ссылки или потоки. Media Engine не хранит видео, а внешний
+плеер может быть недоступен в конкретной стране, сети или браузере.
+
+## Поиск torrent-раздач
+
+Torrent-провайдеры всегда подключаются явно:
+
+```ts
+import {
+  bitsearchTorrentProvider,
+  jacRedTorrentProvider,
+  magnetzTorrentProvider,
+  ytsTorrentProvider,
+} from "@media-engine/providers";
+
+const media = new MediaEngine({
+  torrentProviders: [
+    ytsTorrentProvider(),
+    jacRedTorrentProvider(),
+    bitsearchTorrentProvider(),
+    magnetzTorrentProvider(),
+  ],
+});
+
+const result = await media.discoverTorrents({
+  type: "movie",
+  title: "Начало",
+  year: 2010,
+  ids: { imdb: "tt1375666" },
+});
+```
+
+Поиск только возвращает список кандидатов и данные для дальнейшей передачи. Он не загружает
+torrent metadata, не обращается к trackers, не подключается к раздаче и не воспроизводит файл.
+
+Публичные источники могут меняться, ограничивать запросы или временно не работать. Оставляйте кэш
+движка включённым и будьте готовы к частичным результатам. Настройки и границы безопасности каждого
+источника описаны в
+[документации провайдеров](https://github.com/Yaneart/media-engine/blob/main/docs/providers.md).
+
+## Лицензия
+
+MIT

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

@@ -0,0 +1,8 @@
+import { type StreamingProvider } from "@media-engine/core";
+import { type ProviderFetch } from "../shared/index.js";
+export interface AderomStreamingProviderOptions {
+    apiBaseUrl?: string;
+    embedBaseUrl?: string;
+    fetch?: ProviderFetch;
+}
+export declare function aderomStreamingProvider(options?: AderomStreamingProviderOptions): StreamingProvider;

package/dist/aderom-streaming/index.js

@@ -0,0 +1,168 @@
+import { ProviderError } from "@media-engine/core";
+import { fetchJson, normalizeProviderOutputUrl } from "../shared/index.js";
+import { createHardenedProviderFetch } from "../shared/safe-fetch.js";
+import { MEDIA_ENGINE_DEFAULT_USER_AGENT } from "../package-version.js";
+const KINOPOISK_ID = /^[1-9]\d{0,11}$/u;
+const IMDB_ID = /^tt\d{7,9}$/u;
+const WIKIDATA_API_URL = "https://www.wikidata.org/w/api.php";
+// Aderom indexes dubbed series and anime. Its published iframe keeps voice and episode selection inside the player.
+export function aderomStreamingProvider(options = {}) {
+    const name = "aderom-streaming";
+    const apiBaseUrl = readBaseUrl(options.apiBaseUrl ?? "https://aderom.net");
+    const embedBaseUrl = readBaseUrl(options.embedBaseUrl ?? "https://gencit.info");
+    const fetchImpl = options.fetch ?? createHardenedProviderFetch({ provider: name, maxRedirects: 3 });
+    return {
+        name,
+        kind: "streaming",
+        capabilities: {
+            mediaTypes: ["series", "anime"],
+            lookup: { byTitle: false, byExternalIds: ["kinopoisk", "imdb"], byEpisode: false },
+            features: ["embed", "translations"],
+        },
+        async getAvailability(query, context) {
+            if (query.providers && !query.providers.includes(name))
+                return null;
+            if (query.type !== "series" && query.type !== "anime")
+                return null;
+            if (query.seasonNumber !== undefined ||
+                query.episodeNumber !== undefined ||
+                query.absoluteEpisodeNumber !== undefined)
+                return null;
+            const kinopoiskId = query.ids?.kinopoisk ??
+                query.kinopoisk ??
+                (await resolveKinopoiskId(query.ids?.imdb ?? query.imdb, context, fetchImpl));
+            if (!kinopoiskId || !KINOPOISK_ID.test(kinopoiskId))
+                return null;
+            const sourceUrl = new URL(`/api/${kinopoiskId}`, apiBaseUrl).href;
+            const payload = await fetchJson({
+                provider: name,
+                url: sourceUrl,
+                context,
+                fetch: fetchImpl,
+                maxRetries: 0,
+                maxResponseBytes: 256 * 1024,
+            });
+            if (isRecord(payload) && payload.error === "not found")
+                return null;
+            if (!isRecord(payload) ||
+                String(payload.kinopoisk_id) !== kinopoiskId ||
+                typeof payload.title !== "string" ||
+                !payload.title.trim() ||
+                typeof payload.category !== "string" ||
+                !Array.isArray(payload.translation)) {
+                throw invalidResponse(name);
+            }
+            const category = payload.category.toLowerCase();
+            if (query.type === "anime" ? !category.includes("аниме") : !category.includes("сериал"))
+                return null;
+            if (!payload.translation.some((entry) => isRecord(entry) && typeof entry.name === "string" && entry.name.trim()))
+                return null;
+            const embedUrl = normalizeProviderOutputUrl(new URL(`/tvb/${kinopoiskId}`, embedBaseUrl).href);
+            if (!embedUrl)
+                throw invalidResponse(name);
+            const response = await fetchImpl(embedUrl, { signal: context.signal });
+            await response.body?.cancel();
+            if (response.status === 404)
+                return null;
+            if (!response.ok) {
+                throw new ProviderError({
+                    provider: name,
+                    code: "PROVIDER_UNAVAILABLE",
+                    retryable: response.status >= 500,
+                    message: `Aderom embed returned HTTP ${response.status}.`,
+                });
+            }
+            const ids = { ...query.ids, kinopoisk: kinopoiskId };
+            return {
+                query,
+                item: { type: query.type, title: payload.title.trim(), year: readYear(payload.year), ids },
+                options: [
+                    {
+                        id: `${name}:${kinopoiskId}`,
+                        provider: name,
+                        player: { kind: "embed", label: "Aderom", providerPlayerId: kinopoiskId },
+                        access: { url: embedUrl },
+                        availability: "available",
+                        sourceUrl,
+                    },
+                ],
+                sourceProviders: [{ provider: name, url: sourceUrl, ids }],
+                checkedAt: new Date().toISOString(),
+            };
+        },
+    };
+}
+async function resolveKinopoiskId(imdbId, context, fetchImpl) {
+    if (!imdbId || !IMDB_ID.test(imdbId))
+        return undefined;
+    const searchUrl = new URL(WIKIDATA_API_URL);
+    searchUrl.searchParams.set("action", "query");
+    searchUrl.searchParams.set("list", "search");
+    searchUrl.searchParams.set("srsearch", `haswbstatement:P345=${imdbId}`);
+    searchUrl.searchParams.set("srnamespace", "0");
+    searchUrl.searchParams.set("srlimit", "2");
+    searchUrl.searchParams.set("srprop", "");
+    searchUrl.searchParams.set("format", "json");
+    const search = await requestWikidata(searchUrl, context, fetchImpl);
+    if (!isRecord(search) || !isRecord(search.query) || !Array.isArray(search.query.search))
+        throw invalidResponse("aderom-streaming");
+    if (search.query.search.length !== 1)
+        return undefined;
+    const entity = search.query.search[0];
+    if (!isRecord(entity) || typeof entity.title !== "string" || !/^Q[1-9]\d*$/u.test(entity.title))
+        throw invalidResponse("aderom-streaming");
+    const claimsUrl = new URL(WIKIDATA_API_URL);
+    claimsUrl.searchParams.set("action", "wbgetclaims");
+    claimsUrl.searchParams.set("entity", entity.title);
+    claimsUrl.searchParams.set("property", "P2603");
+    claimsUrl.searchParams.set("format", "json");
+    const payload = await requestWikidata(claimsUrl, context, fetchImpl);
+    if (!isRecord(payload) || !isRecord(payload.claims))
+        throw invalidResponse("aderom-streaming");
+    if (payload.claims.P2603 === undefined)
+        return undefined;
+    if (!Array.isArray(payload.claims.P2603))
+        throw invalidResponse("aderom-streaming");
+    const ids = new Set(payload.claims.P2603.map((claim) => {
+        if (!isRecord(claim) || !isRecord(claim.mainsnak) || !isRecord(claim.mainsnak.datavalue))
+            return undefined;
+        return claim.mainsnak.datavalue.value;
+    }));
+    const id = [...ids][0];
+    return ids.size === 1 && typeof id === "string" && KINOPOISK_ID.test(id) ? id : undefined;
+}
+function requestWikidata(url, context, fetchImpl) {
+    return fetchJson({
+        provider: "aderom-streaming",
+        url: url.href,
+        init: {
+            headers: { accept: "application/json", "user-agent": MEDIA_ENGINE_DEFAULT_USER_AGENT },
+        },
+        context,
+        fetch: fetchImpl,
+        maxRetries: 0,
+        maxResponseBytes: 64 * 1024,
+    });
+}
+function readBaseUrl(value) {
+    const url = new URL(value);
+    if (url.protocol !== "https:" || url.username || url.password)
+        throw new TypeError("Aderom base URLs must be credential-free HTTPS URLs.");
+    return url.origin;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readYear(value) {
+    const year = typeof value === "number" ? value : Number(value);
+    return Number.isInteger(year) && year >= 1888 && year <= 2200 ? year : undefined;
+}
+function invalidResponse(provider) {
+    return new ProviderError({
+        provider,
+        code: "PROVIDER_INVALID_RESPONSE",
+        retryable: false,
+        message: "Aderom returned an invalid or mismatched media record.",
+    });
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/cinemeta/index.js

@@ -215,7 +215,13 @@ async function loadDetailsType(config, imdbId, type, context) {
     const url = new URL(`${config.baseUrl}/meta/${toCinemetaType(type)}/${imdbId}.json`);
     try {
         const response = await requestJson(config, url, context);
-        const details = response.meta ? metaToDetails(config, response.meta, type) : null;
+        const meta = response.meta;
+        const details = meta &&
+            (!meta.type || meta.type === type) &&
+            (!meta.id || meta.id === imdbId) &&
+            (!meta.imdb_id || meta.imdb_id === imdbId)
+            ? metaToDetails(config, meta, type)
+            : null;
         return details ? { status: "found", details } : { status: "not_found" };
     }
     catch (error) {
@@ -225,12 +231,15 @@ async function loadDetailsType(config, imdbId, type, context) {
             : { status: "failed", error };
     }
 }
-// Returns any available details and propagates degradation only when nothing was found.
-// Возвращает найденные details и пробрасывает деградацию, только если результата нет.
+// Rejects ambiguous untyped identities instead of choosing the first endpoint result.
+// Отклоняет неоднозначную идентичность вместо выбора первого ответа endpoint.
 function resolveDetailsOutcomes(outcomes) {
-    const found = outcomes.find((outcome) => outcome.status === "found");
-    if (found) {
-        return found.details;
+    const found = outcomes.filter((outcome) => outcome.status === "found");
+    if (found.length > 1) {
+        return null;
+    }
+    if (found[0]) {
+        return found[0].details;
     }
     const failures = outcomes.filter((outcome) => outcome.status === "failed");
     const retryable = failures.find((outcome) => outcome.error instanceof ProviderError && outcome.error.retryable);