@media-engine/providers 0.1.1 → 1.0.0

package/README.md

@@ -16,14 +16,16 @@ npm install @media-engine/core @media-engine/providers
 import { MediaEngine } from "@media-engine/core";
 import {
   aniListProvider,
+  ddbbStreamingProvider,
   flixHqStreamingProvider,
   kinobdProvider,
   kinobdStreamingProvider,
   shikimoriProvider,
+  tvMazeProvider,
 } from "@media-engine/providers";
 
 const media = new MediaEngine({
-  providers: [kinobdProvider(), shikimoriProvider(), aniListProvider()],
+  providers: [kinobdProvider(), shikimoriProvider(), aniListProvider(), tvMazeProvider()],
 });
 
 const result = await media.search({ title: "One Piece" });
@@ -37,15 +39,34 @@ Add only the providers that make sense for your application. Media Engine will c
 - `cinemetaProvider()` — IMDb-linked movie and series data;
 - `shikimoriProvider()` — anime search and details;
 - `aniListProvider()` — international anime titles, popularity, and artwork;
-- `wikidataProvider()` — open structured enrichment;
-- `imdbDatasetProvider()` — local IMDb TSV datasets supplied by your application.
+- `tvMazeProvider()` — fallback IMDb-backed series identities and localized aliases;
+- `wikidataProvider()` — fallback structured identity and metadata enrichment;
+- `imdbDatasetProvider()` — local IMDb data supplied as small in-memory TSV fixtures or through an application-owned indexed storage adapter.
 
 None of these built-in providers needs your API key. TMDB IDs may appear in results, but this package does not call the TMDB API.
 
+TVmaze data is licensed under CC BY-SA. The provider keeps a TVmaze show URL in source attribution; applications using TVmaze data should preserve and render that link. See the [TVmaze API licensing terms](https://www.tvmaze.com/api#licensing).
+
+Wikidata fallback discovery loads at most three title-relevant entities through a selected-property query and caches entity/IMDb mappings for six hours in a 256-entry process-local LRU by default. `entityLimit` is bounded to 1–10, `cacheTtlMs` to 0–7 days, and `cacheMaxEntries` to 2–2048; a zero TTL disables this provider-local cache.
+
+The backward-compatible IMDb TSV adapter parses the complete input into memory and is intended for small datasets and fixtures. Full-dataset integrations can inject the exported synchronous/asynchronous `ImdbDatasetStorage` contract, including a direct ID lookup and bounded normalized title search, without adding a database dependency for other package users.
+
+An included persisted adapter can stream plain or gzip IMDb TSV files into a versioned, atomically replaced SQLite/FTS index. `buildImdbDatasetSqliteIndex()` creates it and `openImdbDatasetSqliteStorage()` opens it read-only for `imdbDatasetProvider({ storage })`. This optional path lazily uses built-in `node:sqlite` and requires Node.js 22.13 or newer; importing the package or using the small in-memory adapter keeps the Node.js 20 baseline.
+
+Expected upstream failures are reported as typed `ProviderError` values, and shared HTTP errors expose their originating status through `getProviderHttpStatus`. An untyped Cinemeta IMDb lookup returns `null` only after both movie and series candidates confirm absence; a temporary branch outage remains retryable unless the other branch returned usable details. AniList similarly distinguishes GraphQL rate limits and server outages from validation errors or malformed payloads, allowing Media Engine to avoid caching incomplete metadata as a healthy response.
+
+Shared `fetchJson` calls stream at most 4 MiB by default before parsing and accept a positive `maxResponseBytes` override for provider-specific limits. A declared or chunked oversized body is cancelled and reported as the non-retryable `PROVIDER_RESPONSE_TOO_LARGE`; malformed JSON within the limit remains `PROVIDER_INVALID_RESPONSE`.
+
+Low-level adapters may supply a `ProviderHttpScheduler` through `FetchJsonOptions.scheduler` when
+they need deterministic control of retry and total-timeout timers, especially in tests. Normal
+provider calls omit it and use the platform timers.
+
 ## Player sources
 
 - `kinobdStreamingProvider()` — movie, series, and anime player options;
 - `flixHqStreamingProvider()` — international movie and selected series-episode options;
+- `ddbbStreamingProvider()` — opt-in Kinopoisk/IMDb lookup through an independent DDBB player route;
+- `aniLibertyStreamingProvider()` — opt-in exact title/year anime lookup with direct HLS episodes;
 - `experimentalStreamingProvider()` — data configured by your own application, useful in tests and UI work.
 
 ```ts
@@ -66,6 +87,114 @@ const result = await media.getAvailability({
 
 These are third-party player targets, not videos hosted by Media Engine. Availability depends on the upstream source and the user's environment.
 
+The repository API enables `ddbbStreamingProvider()` after its repeated reliability/diversity
+checkpoint; direct package consumers still choose their own provider list explicitly. It accepts
+only Kinopoisk or IMDb IDs, returns generic movie/series/anime embeds, and does not claim exact
+season/episode mapping. Its diversity-first mapping keeps one main option per returned player before
+adding unique translation URLs. Missing nullable players produce no result; confirmed 404/410 or
+stable deletion markers are removed, while transient validation failures remain `unknown`.
+
+```ts
+const media = new MediaEngine({
+  streamingProviders: [
+    kinobdStreamingProvider(),
+    flixHqStreamingProvider(),
+    ddbbStreamingProvider(), // explicit opt-in
+    aniLibertyStreamingProvider(), // explicit opt-in
+  ],
+});
+```
+
+The repository API also enables `aniLibertyStreamingProvider()` after that checkpoint. Because
+AniLiberty does not publish MAL, AniList, or Shikimori IDs for releases, the adapter requires both
+title and year, accepts only one exact normalized match, and revalidates the loaded release before
+returning streams. It supports generic episode maps and exact `absoluteEpisodeNumber` queries, but
+does not guess season/episode mappings. Each safe first-party 480p/720p/1080p URL is returned as
+direct HLS; release geo and copyright blocks are preserved as normalized availability states.
+
+Live player validation removes an option only after HTTP 404/410 or a stable deletion marker. Rate limits, server errors, network failures, and validation timeouts keep the discovered option with `availability: "unknown"`, allowing the engine to expose the degradation and retry it instead of caching a transiently reduced result.
+
+KinoBD bounds one availability lookup to 24 child HTTP attempts by default and validates at most eight discovered players through three workers. Public tuning remains bounded (`childRequestLimit` up to 64, `playerValidationLimit` up to 16, and `playerValidationConcurrency` up to 4). Nested iframe validation starts only when the fixed provider deadline can still grant a full validation window. `onPlayerAudit` receives additive `metrics` for discovered and validated players, limit/budget skips, transient unknown results, confirmed removals, and consumed child requests.
+
+FlixHQ site navigation cannot leave its configured origin, including through redirects. External player and subtitle checks resolve every A/AAAA answer, reject private, local, reserved, multicast, or mixed public/private destinations, validate every bounded redirect hop, and pin the connection to the approved address. A custom provider `fetch` is an explicit trusted transport injection intended for controlled tests or self-hosted environments; it is responsible for equivalent network policy.
+
+DDBB caps its JSON response, output option count, live validation count, validation concurrency,
+validation body size, and per-player timeout. Its default transport applies the same hardened DNS,
+redirect, and connection-pinning policy to the DDBB endpoint and returned players. A custom `fetch`
+is the same explicit trusted test/self-hosted boundary used by the other streaming providers. Options
+beyond the bounded validation count remain visible with `availability: "unknown"`; they are never
+presented as successfully checked. Alloha is represented by one main option because voiceovers can
+be switched inside that player; if no main iframe exists, at most one safe translation URL becomes
+the entry point. Other player families keep their distinct translation options.
+
+AniLiberty bounds search candidates, release episodes, JSON bytes, retries, and total provider time
+through the shared engine/provider controls. Its default transport uses the hardened DNS, redirect,
+and connection-pinning policy for API calls. Direct HLS targets still pass the shared browser-facing
+output URL policy; playback network policy remains the consuming application's responsibility.
+
+Before built-in providers expose artwork, player, or subtitle URLs, one output policy accepts only HTTP(S) targets without credentials, raw control characters, or literal local/private/reserved addresses. Valid paths and CDN query parameters, including expiring signatures, are preserved. This browser-facing check does not replace DNS validation or an application-owned media proxy.
+
+## Torrent discovery sources
+
+`ytsTorrentProvider()` is an opt-in no-key movie source. It resolves an exact IMDb identity or one
+exact title/year match and returns normalized 720p/1080p/2160p-style magnet candidates with size,
+release metadata, and best-effort peer counts.
+
+`jacRedTorrentProvider()` is an opt-in no-key Russian/multilingual source for exact title/year
+movie, series, and anime lookup. It can filter a requested season, but intentionally returns no
+result for exact ordinary or absolute episode queries. Returned title, year, category, season,
+info hash, source URL, release metadata, and peer fields are bounded and revalidated. Each result
+also retains the bounded JacRed tracker ID as `catalogSource`; known values receive labels such as
+BitRu, RuTracker, RuTor, Kinozal, NNM-Club, and Knaben without implying a guaranteed audio
+language. Its
+`baseUrl` and `searchPath` are configurable because the live first-party route and published route
+currently differ.
+
+`bitsearchTorrentProvider()` is an opt-in no-key broad international source. It requires title and
+year, pins movie/TV/anime categories, and revalidates the exact release title, explicit year, media
+type, requested season, and requested ordinary or absolute episode before returning a candidate.
+It consumes only the documented bounded search response, remembers an exhausted anonymous quota
+from `X-RateLimit-*`, and emits one canonical magnet per validated info hash. The public anonymous
+tier is currently limited to 200 requests/day per IP, so applications should keep engine caching
+enabled and avoid speculative calls.
+
+`magnetzTorrentProvider()` is an opt-in no-key international meta-search source. It performs one
+bounded first-page search request, then revalidates exact title, year, season, and ordinary or
+absolute episode markers locally. It never fans out into per-result detail calls. The adapter emits
+one canonical magnet per validated info hash, preserves reported peer state and source attribution,
+and spaces request starts by one second because the live service has returned short burst 429s even
+while its rate-limit header still reported capacity.
+
+```ts
+const media = new MediaEngine({
+  torrentProviders: [
+    ytsTorrentProvider(),
+    jacRedTorrentProvider(),
+    bitsearchTorrentProvider(),
+    magnetzTorrentProvider(),
+  ],
+  providerTimeouts: {
+    "yts-torrent": 15_000,
+    "jacred-torrent": 20_000,
+    "bitsearch-torrent": 15_000,
+    "magnetz-torrent": 15_000,
+  },
+});
+
+const torrents = await media.discoverTorrents({
+  type: "movie",
+  title: "Inception",
+  year: 2010,
+  ids: { imdb: "tt1375666" },
+});
+```
+
+The provider does not download torrent metadata, contact trackers, join a swarm, or play video.
+The completed multi-source checkpoint kept repository API defaults empty: Bitsearch has a small
+anonymous daily quota, Magnetz exposes burst-sensitive limits, and JacRed still has an occasional
+long timeout tail. Applications can opt into any subset explicitly and monitor it with
+`pnpm smoke:torrents`; package consumers remain in control of their own request budget.
+
 Provider options, limitations, and safety rules are summarized in the [provider guide](https://github.com/Yaneart/media-engine/blob/main/docs/providers.md).
 
 ## License

package/README.ru.md

@@ -16,14 +16,16 @@ npm install @media-engine/core @media-engine/providers
 import { MediaEngine } from "@media-engine/core";
 import {
   aniListProvider,
+  ddbbStreamingProvider,
   flixHqStreamingProvider,
   kinobdProvider,
   kinobdStreamingProvider,
   shikimoriProvider,
+  tvMazeProvider,
 } from "@media-engine/providers";
 
 const media = new MediaEngine({
-  providers: [kinobdProvider(), shikimoriProvider(), aniListProvider()],
+  providers: [kinobdProvider(), shikimoriProvider(), aniListProvider(), tvMazeProvider()],
 });
 
 const result = await media.search({ title: "Ван-Пис" });
@@ -37,15 +39,35 @@ const result = await media.search({ title: "Ван-Пис" });
 - `cinemetaProvider()` — данные фильмов и сериалов, связанные с IMDb;
 - `shikimoriProvider()` — поиск и детали аниме;
 - `aniListProvider()` — международные названия аниме, популярность и изображения;
-- `wikidataProvider()` — обогащение открытыми структурированными данными;
-- `imdbDatasetProvider()` — локальные TSV-датасеты IMDb, переданные приложением.
+- `tvMazeProvider()` — резервные IMDb identity сериалов и локализованные aliases;
+- `wikidataProvider()` — резервная проверка identity и обогащение открытыми структурированными данными;
+- `imdbDatasetProvider()` — локальные данные IMDb в виде небольших in-memory TSV fixtures или через индексированный storage adapter приложения.
 
 Для встроенных провайдеров не нужен ваш API-ключ. TMDB ID может встретиться в результате, но сам пакет не обращается к TMDB API.
 
+Данные TVmaze распространяются по лицензии CC BY-SA. Провайдер сохраняет ссылку на страницу сериала TVmaze в source attribution; приложению следует сохранять и показывать эту ссылку. См. [условия API TVmaze](https://www.tvmaze.com/api#licensing).
+
+Резервный поиск Wikidata загружает не больше трёх релевантных title entities через selected-property запрос и по умолчанию кеширует entity/IMDb mappings на шесть часов в process-local LRU на 256 записей. `entityLimit` ограничен диапазоном 1–10, `cacheTtlMs` — 0–7 дней, `cacheMaxEntries` — 2–2048; нулевой TTL отключает локальный cache провайдера.
+
+Backward-compatible IMDb TSV adapter полностью разбирает входные строки в память и предназначен для небольших наборов и fixtures. Для полного датасета приложение может передать экспортируемый синхронный/асинхронный контракт `ImdbDatasetStorage` с прямым ID lookup и ограниченным поиском по нормализованному title; другим пользователям пакета database dependency не добавляется.
+
+Встроенный persisted adapter может потоково собрать plain или gzip IMDb TSV в версионированный SQLite/FTS index с атомарной заменой. `buildImdbDatasetSqliteIndex()` создаёт индекс, а `openImdbDatasetSqliteStorage()` открывает его read-only для `imdbDatasetProvider({ storage })`. Этот опциональный путь лениво использует встроенный `node:sqlite` и требует Node.js 22.13 или новее; импорт пакета и небольшой in-memory adapter сохраняют базовую совместимость с Node.js 20.
+
+Ожидаемые сбои внешних источников возвращаются как типизированные `ProviderError`, а исходный HTTP status доступен через `getProviderHttpStatus`. Cinemeta при IMDb-запросе без типа возвращает `null`, только когда отсутствие подтверждено и для фильма, и для сериала; временный сбой одной ветки остаётся retryable, если другая ветка не вернула пригодные детали. AniList также отличает GraphQL rate limit и сбой сервера от ошибок валидации или некорректного ответа, поэтому Media Engine не кеширует неполные метаданные как здоровый результат.
+
+Общий `fetchJson` по умолчанию читает потоково не больше 4 МиБ перед разбором JSON и принимает положительный `maxResponseBytes` для индивидуального лимита провайдера. Объявленное или фактическое превышение отменяет body и возвращает non-retryable `PROVIDER_RESPONSE_TOO_LARGE`; некорректный JSON в пределах лимита остаётся `PROVIDER_INVALID_RESPONSE`.
+
+Низкоуровневые адаптеры могут передать `ProviderHttpScheduler` через
+`FetchJsonOptions.scheduler`, когда нужен детерминированный контроль retry- и total-timeout
+таймеров, прежде всего в тестах. Обычные provider-вызовы не задают его и используют системные
+таймеры.
+
 ## Провайдеры плееров
 
 - `kinobdStreamingProvider()` — варианты плееров для фильмов, сериалов и аниме;
 - `flixHqStreamingProvider()` — международные варианты для фильмов и выбранных эпизодов сериалов;
+- `ddbbStreamingProvider()` — opt-in поиск по Kinopoisk/IMDb через независимый маршрут DDBB;
+- `aniLibertyStreamingProvider()` — opt-in точный поиск аниме по названию/году с прямыми HLS-сериями;
 - `experimentalStreamingProvider()` — данные, настроенные вашим приложением для тестов и разработки интерфейса.
 
 ```ts
@@ -66,6 +88,115 @@ const result = await media.getAvailability({
 
 Это ссылки на сторонние плееры, а не видео, размещённые Media Engine. Доступность зависит от внешнего источника и окружения пользователя.
 
+API репозитория включает `ddbbStreamingProvider()` после повторного reliability/diversity
+checkpoint; прямые пользователи пакета по-прежнему явно выбирают собственный список провайдеров. Он
+принимает только ID Kinopoisk или IMDb, возвращает общие embed-плееры для фильмов/сериалов/anime и не
+заявляет точное сопоставление сезона/эпизода. Diversity-first mapping сначала сохраняет по одному
+основному варианту каждого возвращённого плеера, а затем добавляет уникальные translation URL.
+Nullable отсутствующие плееры дают пустой результат; подтверждённые 404/410 и устойчивые deletion
+markers удаляются, а transient ошибки проверки сохраняются как `unknown`.
+
+```ts
+const media = new MediaEngine({
+  streamingProviders: [
+    kinobdStreamingProvider(),
+    flixHqStreamingProvider(),
+    ddbbStreamingProvider(), // явное opt-in подключение
+    aniLibertyStreamingProvider(), // явное opt-in подключение
+  ],
+});
+```
+
+После того же checkpoint API репозитория включает и `aniLibertyStreamingProvider()`. AniLiberty не
+публикует для релизов MAL, AniList или Shikimori ID, поэтому адаптер требует одновременно название и
+год, принимает только одно точное нормализованное совпадение и повторно проверяет загруженный релиз
+перед возвратом потоков. Он поддерживает общую карту серий и точный `absoluteEpisodeNumber`, но не
+угадывает season/episode. Каждый безопасный first-party URL 480p/720p/1080p возвращается как прямой
+HLS, а географическая и copyright-блокировка релиза сохраняются в availability status.
+
+Live-проверка удаляет вариант плеера только после HTTP 404/410 или устойчивого маркера удаления. Rate limit, ошибка сервера, сетевой сбой или timeout проверки сохраняют найденный вариант с `availability: "unknown"`, чтобы engine показал деградацию и повторил проверку вместо кеширования временно урезанного результата.
+
+KinoBD по умолчанию ограничивает один availability lookup 24 дочерними HTTP-попытками и проверяет не больше восьми найденных плееров тремя workers. Публичная настройка также ограничена сверху (`childRequestLimit` до 64, `playerValidationLimit` до 16 и `playerValidationConcurrency` до 4). Вложенная iframe-проверка начинается, только если фиксированный deadline провайдера ещё позволяет выделить полное окно validation. Callback `onPlayerAudit` получает дополнительные `metrics`: найденные и проверенные плееры, пропуски по limit/budget, transient unknown, подтверждённые удаления и использованные дочерние запросы.
+
+Навигация по FlixHQ не может покинуть настроенный origin, в том числе через redirects. Для внешних player/subtitle проверяются все A/AAAA-адреса, отклоняются private, local, reserved, multicast и смешанные public/private назначения, каждый ограниченный redirect hop валидируется, а соединение закрепляется за проверенным адресом. Пользовательский provider `fetch` считается явно доверенной transport-инъекцией для контролируемых тестов или self-hosted окружений и должен обеспечивать эквивалентную сетевую политику.
+
+DDBB ограничивает размер JSON-ответа, количество output options и live validations, concurrency,
+размер validation body и timeout каждого плеера. Его default transport применяет ту же hardened
+политику DNS, redirects и connection pinning к endpoint DDBB и возвращённым плеерам. Пользовательский
+`fetch` остаётся явной доверенной границей для тестов/self-hosted окружений. Варианты за пределом
+ограниченного числа проверок остаются видимыми со статусом `availability: "unknown"` и никогда не
+показываются как успешно проверенные. Alloha представлен одним main option, потому что озвучку
+можно переключить внутри самого плеера; при отсутствии main iframe точкой входа становится не
+больше одного безопасного translation URL. Остальные семейства плееров сохраняют отдельные
+варианты переводов.
+
+AniLiberty ограничивает число search-кандидатов и эпизодов релиза, размер JSON, retry и общее время
+провайдера через общие engine/provider-механизмы. Default transport применяет hardened DNS,
+redirect и connection-pinning политику к API-вызовам. Прямые HLS-цели проходят общую browser-facing
+проверку URL; playback network policy остаётся ответственностью потребляющего приложения.
+
+Перед публикацией artwork, player или subtitle URL встроенные провайдеры применяют одну output-политику: разрешены только HTTP(S)-цели без credentials, исходных управляющих символов и literal local/private/reserved адресов. Валидные пути и CDN query-параметры, включая временные подписи, сохраняются. Эта browser-facing проверка не заменяет DNS-валидацию или media proxy приложения.
+
+## Источники torrent discovery
+
+`ytsTorrentProvider()` — явно подключаемый no-key источник фильмов. Он принимает точный IMDb ID или
+одно точное совпадение названия и года и возвращает нормализованные magnet-кандидаты вроде
+720p/1080p/2160p с размером, сведениями о релизе и best-effort счётчиками пиров.
+
+`jacRedTorrentProvider()` — явно подключаемый no-key русскоязычный/мультиязычный источник для
+точного поиска фильмов, сериалов и аниме по названию и году. Он умеет фильтровать указанный сезон,
+но намеренно не отвечает на запрос конкретной обычной или абсолютной серии. Название, год,
+категория, сезон, info hash, source URL, сведения о релизе и счётчики пиров ограничиваются и
+перепроверяются. Каждый результат также сохраняет ограниченный tracker ID JacRed в
+`catalogSource`; известные значения получают подписи BitRu, RuTracker, RuTor, Kinozal, NNM-Club и
+Knaben без ложной гарантии языка аудиодорожки. `baseUrl` и `searchPath` настраиваются, потому что фактический first-party маршрут
+сейчас отличается от опубликованного.
+
+`bitsearchTorrentProvider()` — явно подключаемый no-key источник с широким международным каталогом.
+Он требует название и год, закрепляет категории movie/TV/anime и перед возвратом кандидата заново
+проверяет точное название релиза, явно указанный год, тип медиа, запрошенный сезон и обычный или
+абсолютный номер эпизода. Провайдер читает только ограниченный search-ответ, запоминает исчерпание
+анонимной квоты из `X-RateLimit-*` и создаёт один канонический magnet на проверенный info hash.
+Публичная анонимная квота сейчас составляет 200 запросов в сутки на IP, поэтому приложению следует
+оставлять engine cache включённым и не выполнять speculative-вызовы.
+
+`magnetzTorrentProvider()` — явно подключаемый no-key международный meta-search источник. Он делает
+один ограниченный запрос первой страницы, затем локально перепроверяет точное название, год, сезон
+и маркеры обычного или абсолютного эпизода. Провайдер не запускает отдельные detail-запросы для
+каждого результата, создаёт один канонический magnet на проверенный info hash, сохраняет фактические
+peer-счётчики и attribution и выдерживает секунду между началами запросов: live-сервис возвращал
+короткие burst-429 даже при ненулевом остатке в rate-limit header.
+
+```ts
+const media = new MediaEngine({
+  torrentProviders: [
+    ytsTorrentProvider(),
+    jacRedTorrentProvider(),
+    bitsearchTorrentProvider(),
+    magnetzTorrentProvider(),
+  ],
+  providerTimeouts: {
+    "yts-torrent": 15_000,
+    "jacred-torrent": 20_000,
+    "bitsearch-torrent": 15_000,
+    "magnetz-torrent": 15_000,
+  },
+});
+
+const torrents = await media.discoverTorrents({
+  type: "movie",
+  title: "Inception",
+  year: 2010,
+  ids: { imdb: "tt1375666" },
+});
+```
+
+Провайдер не загружает torrent metadata, не обращается к trackers, не подключается к swarm и не
+воспроизводит видео. После общего multi-source checkpoint torrent-провайдеры остались выключенными
+в API defaults: у Bitsearch небольшая суточная анонимная квота, Magnetz чувствителен к burst-нагрузке,
+а у JacRed сохраняется редкий длинный timeout tail. Приложение явно выбирает нужное подмножество и
+может контролировать его командой `pnpm smoke:torrents`, сохраняя собственный request budget.
+
 Настройки, ограничения и правила безопасности кратко описаны в [документации провайдеров](https://github.com/Yaneart/media-engine/blob/main/docs/providers.md).
 
 ## Лицензия

package/dist/aniliberty-streaming/client.d.ts

@@ -0,0 +1,33 @@
+import { type ProviderContext } from "@media-engine/core";
+import type { AniLibertyStreamingConfig } from "./config.js";
+export interface AniLibertyReleaseName {
+    main?: string;
+    english?: string;
+    alternative?: string;
+}
+export interface AniLibertyReleaseSummary {
+    id: number;
+    year: number;
+    name: AniLibertyReleaseName;
+    alias?: string;
+    blockedByGeo: boolean;
+    blockedByCopyrights: boolean;
+}
+export interface AniLibertyEpisode {
+    id: string;
+    name?: string;
+    ordinal: number;
+    hls480?: string;
+    hls720?: string;
+    hls1080?: string;
+}
+export interface AniLibertyRelease extends AniLibertyReleaseSummary {
+    episodes: AniLibertyEpisode[];
+}
+export declare function searchAniLibertyReleases(config: AniLibertyStreamingConfig, title: string, context: ProviderContext): Promise<AniLibertyReleaseSummary[]>;
+export declare function loadAniLibertyRelease(config: AniLibertyStreamingConfig, releaseId: number, context: ProviderContext): Promise<{
+    release: AniLibertyRelease;
+    sourceUrl: string;
+} | null>;
+export declare function parseAniLibertySearchResponse(provider: string, value: unknown, limit: number): AniLibertyReleaseSummary[];
+export declare function parseAniLibertyRelease(provider: string, value: unknown, episodeLimit: number): AniLibertyRelease;

package/dist/aniliberty-streaming/client.js

@@ -0,0 +1,188 @@
+import { ProviderError } from "@media-engine/core";
+import { fetchJson, getProviderHttpStatus } from "../shared/index.js";
+const SEARCH_INCLUDE = [
+    "id",
+    "year",
+    "name",
+    "alias",
+    "is_blocked_by_geo",
+    "is_blocked_by_copyrights",
+].join(",");
+const RELEASE_INCLUDE = [
+    SEARCH_INCLUDE,
+    "episodes.id",
+    "episodes.name",
+    "episodes.ordinal",
+    "episodes.hls_480",
+    "episodes.hls_720",
+    "episodes.hls_1080",
+].join(",");
+export async function searchAniLibertyReleases(config, title, context) {
+    const url = new URL("/api/v1/app/search/releases", `${config.baseUrl}/`);
+    url.searchParams.set("query", title);
+    url.searchParams.set("include", SEARCH_INCLUDE);
+    const payload = await fetchJson({
+        provider: config.name,
+        url,
+        context,
+        fetch: config.fetch,
+        rateLimitGate: config.rateLimitGate,
+        maxResponseBytes: config.maxResponseBytes,
+        init: { headers: createHeaders(config) },
+    });
+    return parseAniLibertySearchResponse(config.name, payload, config.searchResultLimit);
+}
+export async function loadAniLibertyRelease(config, releaseId, context) {
+    const sourceUrl = new URL(`/api/v1/anime/releases/${releaseId}`, `${config.baseUrl}/`);
+    const requestUrl = new URL(sourceUrl);
+    requestUrl.searchParams.set("include", RELEASE_INCLUDE);
+    try {
+        const payload = await fetchJson({
+            provider: config.name,
+            url: requestUrl,
+            context,
+            fetch: config.fetch,
+            rateLimitGate: config.rateLimitGate,
+            maxResponseBytes: config.maxResponseBytes,
+            init: { headers: createHeaders(config) },
+        });
+        return {
+            release: parseAniLibertyRelease(config.name, payload, config.episodeLimit),
+            sourceUrl: sourceUrl.href,
+        };
+    }
+    catch (error) {
+        if (getProviderHttpStatus(error) === 404)
+            return null;
+        throw error;
+    }
+}
+export function parseAniLibertySearchResponse(provider, value, limit) {
+    if (!Array.isArray(value)) {
+        throw invalidResponse(provider);
+    }
+    const releases = value.slice(0, limit).flatMap((entry) => {
+        const release = parseReleaseSummary(entry);
+        return release ? [release] : [];
+    });
+    if (value.length > 0 && releases.length === 0) {
+        throw invalidResponse(provider);
+    }
+    return releases;
+}
+export function parseAniLibertyRelease(provider, value, episodeLimit) {
+    const summary = parseReleaseSummary(value);
+    if (!summary || !isRecord(value) || !Array.isArray(value.episodes)) {
+        throw invalidResponse(provider);
+    }
+    const episodes = value.episodes.slice(0, episodeLimit).flatMap((entry) => {
+        const episode = parseEpisode(entry);
+        return episode ? [episode] : [];
+    });
+    if (value.episodes.length > 0 && episodes.length === 0) {
+        throw invalidResponse(provider);
+    }
+    return { ...summary, episodes };
+}
+function parseReleaseSummary(value) {
+    if (!isRecord(value) || !isRecord(value.name))
+        return undefined;
+    const id = readInteger(value.id, 1, Number.MAX_SAFE_INTEGER);
+    const year = readInteger(value.year, 1_800, 3_000);
+    const main = readNullableString(value.name.main, 500);
+    const english = readNullableString(value.name.english, 500);
+    const alternative = readNullableString(value.name.alternative, 2_000);
+    const alias = readNullableString(value.alias, 500);
+    const blockedByGeo = readOptionalBoolean(value.is_blocked_by_geo);
+    const blockedByCopyrights = readOptionalBoolean(value.is_blocked_by_copyrights);
+    if (id === undefined ||
+        year === undefined ||
+        main === false ||
+        english === false ||
+        alternative === false ||
+        alias === false ||
+        blockedByGeo === undefined ||
+        blockedByCopyrights === undefined ||
+        (!main && !english)) {
+        return undefined;
+    }
+    return {
+        id,
+        year,
+        name: {
+            ...(main ? { main } : {}),
+            ...(english ? { english } : {}),
+            ...(alternative ? { alternative } : {}),
+        },
+        ...(alias ? { alias } : {}),
+        blockedByGeo,
+        blockedByCopyrights,
+    };
+}
+function parseEpisode(value) {
+    if (!isRecord(value))
+        return undefined;
+    const id = readRequiredString(value.id, 200);
+    const ordinal = readFiniteNumber(value.ordinal, 0, 100_000);
+    const name = readNullableString(value.name, 500);
+    const hls480 = readNullableString(value.hls_480, 8_192);
+    const hls720 = readNullableString(value.hls_720, 8_192);
+    const hls1080 = readNullableString(value.hls_1080, 8_192);
+    if (!id ||
+        ordinal === undefined ||
+        name === false ||
+        hls480 === false ||
+        hls720 === false ||
+        hls1080 === false) {
+        return undefined;
+    }
+    return {
+        id,
+        ordinal,
+        ...(name ? { name } : {}),
+        ...(hls480 ? { hls480 } : {}),
+        ...(hls720 ? { hls720 } : {}),
+        ...(hls1080 ? { hls1080 } : {}),
+    };
+}
+function createHeaders(config) {
+    return {
+        Accept: "application/json",
+        "User-Agent": config.userAgent,
+    };
+}
+function readInteger(value, min, max) {
+    return Number.isSafeInteger(value) && Number(value) >= min && Number(value) <= max
+        ? Number(value)
+        : undefined;
+}
+function readFiniteNumber(value, min, max) {
+    return typeof value === "number" && Number.isFinite(value) && value >= min && value <= max
+        ? value
+        : undefined;
+}
+function readRequiredString(value, maxLength) {
+    return typeof value === "string" ? value.trim().slice(0, maxLength) || undefined : undefined;
+}
+function readNullableString(value, maxLength) {
+    if (value === null || value === undefined)
+        return undefined;
+    return typeof value === "string" ? value.trim().slice(0, maxLength) || undefined : false;
+}
+function readOptionalBoolean(value) {
+    if (value === null || value === undefined)
+        return false;
+    return typeof value === "boolean" ? value : undefined;
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function invalidResponse(provider) {
+    return new ProviderError({
+        provider,
+        code: "PROVIDER_INVALID_RESPONSE",
+        message: `Provider "${provider}" returned an invalid AniLiberty response.`,
+        retryable: false,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/aniliberty-streaming/client.js.map

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

package/dist/aniliberty-streaming/config.d.ts

@@ -0,0 +1,24 @@
+import type { StreamingProviderCapabilities } from "@media-engine/core";
+import { ProviderRateLimitGate, type ProviderFetch } from "../shared/index.js";
+export interface AniLibertyStreamingProviderOptions {
+    name?: string;
+    version?: string;
+    baseUrl?: string;
+    fetch?: ProviderFetch;
+    maxResponseBytes?: number;
+    searchResultLimit?: number;
+    episodeLimit?: number;
+    userAgent?: string;
+}
+export interface AniLibertyStreamingConfig {
+    name: string;
+    baseUrl: string;
+    fetch: ProviderFetch;
+    rateLimitGate: ProviderRateLimitGate;
+    maxResponseBytes: number;
+    searchResultLimit: number;
+    episodeLimit: number;
+    userAgent: string;
+}
+export declare function createAniLibertyConfig(options: AniLibertyStreamingProviderOptions): AniLibertyStreamingConfig;
+export declare function createAniLibertyCapabilities(): StreamingProviderCapabilities;