@media-engine/providers 0.1.0 → 0.1.1

package/dist/kinobd-streaming/candidates.d.ts

@@ -0,0 +1,31 @@
+import type { ExternalIds, MediaAvailability, ProviderContext } from "@media-engine/core";
+import type { KinoBdStreamingConfig } from "./config.js";
+export interface PlayerCandidate {
+    id?: string | number | null;
+    inid?: string | number | null;
+    kp_id?: string | number | null;
+    kinopoisk_id?: string | number | null;
+    imdb_id?: string | null;
+    title?: string | null;
+    name_russian?: string | null;
+    name_original?: string | null;
+    year?: string | number | null;
+    year_start?: string | number | null;
+    year_end?: string | number | null;
+    rating_kp?: string | number | null;
+    rating_kp_count?: string | number | null;
+    rating_imdb?: string | number | null;
+    rating_imdb_count?: string | number | null;
+    type?: string | null;
+    popular_rate?: string | number | null;
+    popularity?: {
+        popular_rate?: string | number | null;
+    } | null;
+    iframe?: string | null;
+}
+export declare function createAnimeTitleFallbackQuery(config: KinoBdStreamingConfig, query: MediaAvailability["query"], context: ProviderContext): Promise<MediaAvailability["query"]>;
+export declare function searchPlayerCandidates(config: KinoBdStreamingConfig, query: MediaAvailability["query"], context: ProviderContext): Promise<PlayerCandidate[]>;
+export declare function selectBestPlayerCandidate(candidates: PlayerCandidate[], query: MediaAvailability["query"]): PlayerCandidate | undefined;
+export declare function collectCandidateIds(candidate: PlayerCandidate | undefined): ExternalIds | undefined;
+export declare function getCandidateStartYear(candidate: PlayerCandidate): number | undefined;
+export declare function normalizeSearchText(value: string): string;

package/dist/kinobd-streaming/candidates.js

@@ -0,0 +1,230 @@
+import { rethrowIfProviderAborted } from "../shared/abort.js";
+import { fetchJson } from "../shared/index.js";
+import { mapKinoBdMediaType as mapCandidateMediaType } from "../shared/mapping.js";
+// Builds an anime fallback query that KinoBD player search can understand.
+// Собирает anime fallback query, который понимает KinoBD player search.
+export async function createAnimeTitleFallbackQuery(config, query, context) {
+    if (query.title) {
+        return query;
+    }
+    if (!query.ids?.shikimori) {
+        return query;
+    }
+    const lookup = await tryLookupShikimoriAnime(config, query.ids.shikimori, context);
+    const title = lookup?.russian?.trim() ||
+        lookup?.name?.trim() ||
+        lookup?.english?.find((value) => value.trim())?.trim();
+    return {
+        ...query,
+        title,
+        year: query.year ?? parseYear(lookup?.aired_on),
+    };
+}
+// Searches KinoBD player candidates by Kinopoisk ID or title.
+// Ищет KinoBD player candidates по Kinopoisk ID или title.
+export async function searchPlayerCandidates(config, query, context) {
+    const search = createCandidateSearch(query);
+    if (!search) {
+        return [];
+    }
+    const url = new URL("/api/player/search", `${config.baseUrl}/`);
+    url.searchParams.set("q", search.value);
+    url.searchParams.set("type", search.type);
+    url.searchParams.set("page", "1");
+    const response = await fetchJson({
+        provider: config.name,
+        url,
+        context,
+        fetch: config.fetch,
+        rateLimitGate: config.rateLimitGate,
+        init: {
+            headers: {
+                accept: "application/json",
+            },
+        },
+    });
+    return (response.data ?? []).slice(0, config.searchLimit);
+}
+// Chooses the most likely KinoBD record instead of trusting upstream result order.
+// Выбирает наиболее вероятную KinoBD-запись вместо доверия порядку upstream results.
+export function selectBestPlayerCandidate(candidates, query) {
+    if (candidates.length === 0) {
+        return undefined;
+    }
+    if (query.ids?.kinopoisk || query.ids?.imdb) {
+        const exact = candidates.find((candidate) => hasExactCandidateId(candidate, query.ids));
+        if (exact) {
+            return exact;
+        }
+    }
+    const normalizedTitle = normalizeSearchText(query.title ?? "");
+    return candidates
+        .map((candidate, index) => ({
+        candidate,
+        index,
+        score: scorePlayerCandidate(candidate, query, normalizedTitle),
+    }))
+        .filter((entry) => entry.score > Number.NEGATIVE_INFINITY)
+        .sort((left, right) => right.score - left.score || left.index - right.index)[0]?.candidate;
+}
+// Collects known external IDs from a player candidate.
+// Собирает известные external IDs из player candidate.
+export function collectCandidateIds(candidate) {
+    if (!candidate) {
+        return undefined;
+    }
+    const ids = {};
+    const kinopoiskId = candidate.kinopoisk_id ?? candidate.kp_id;
+    if (kinopoiskId !== undefined && kinopoiskId !== null) {
+        ids.kinopoisk = String(kinopoiskId);
+    }
+    if (candidate.imdb_id) {
+        ids.imdb = candidate.imdb_id;
+    }
+    return Object.keys(ids).length > 0 ? ids : undefined;
+}
+export function getCandidateStartYear(candidate) {
+    return parseOptionalInteger(candidate.year ?? candidate.year_start);
+}
+function scorePlayerCandidate(candidate, query, normalizedTitle) {
+    const candidateType = mapCandidateMediaType(candidate.type);
+    const queryType = query.type === "movie" || query.type === "series" ? query.type : undefined;
+    if (queryType && candidateType && candidateType !== queryType) {
+        return Number.NEGATIVE_INFINITY;
+    }
+    const startYear = getCandidateStartYear(candidate);
+    const endYear = parseOptionalInteger(candidate.year_end);
+    if (query.year !== undefined) {
+        if (startYear === undefined) {
+            return Number.NEGATIVE_INFINITY;
+        }
+        if (queryType === "series") {
+            const lastYear = endYear ?? startYear;
+            if (query.year < startYear || query.year > lastYear) {
+                return Number.NEGATIVE_INFINITY;
+            }
+        }
+        else if (startYear !== query.year) {
+            return Number.NEGATIVE_INFINITY;
+        }
+    }
+    const original = normalizeSearchText(candidate.name_original ?? "");
+    const russian = normalizeSearchText(candidate.name_russian ?? candidate.title ?? "");
+    const popularity = parseOptionalInteger(candidate.popular_rate ?? candidate.popularity?.popular_rate) ?? 0;
+    const votes = parseOptionalInteger(candidate.rating_kp_count) ??
+        parseOptionalInteger(candidate.rating_imdb_count) ??
+        0;
+    const rating = parseOptionalInteger(candidate.rating_kp) ?? parseOptionalInteger(candidate.rating_imdb) ?? 0;
+    let score = 10;
+    if (queryType && candidateType === queryType) {
+        score += 40;
+    }
+    if (normalizedTitle && (original === normalizedTitle || russian === normalizedTitle)) {
+        score += 80;
+    }
+    else if (normalizedTitle &&
+        (original.includes(normalizedTitle) || russian.includes(normalizedTitle))) {
+        score += 25;
+    }
+    if (query.year !== undefined && startYear !== undefined) {
+        score += startYear === query.year ? 35 : 15;
+    }
+    if (candidate.imdb_id) {
+        score += 5;
+    }
+    if (candidate.kinopoisk_id ?? candidate.kp_id) {
+        score += 5;
+    }
+    score += Math.min(8, rating);
+    score += Math.min(10, Math.log10(votes + 1) * 2);
+    score += Math.min(12, Math.log10(popularity + 1) * 2);
+    return score;
+}
+function hasExactCandidateId(candidate, ids) {
+    const candidateIds = collectCandidateIds(candidate);
+    return Boolean((ids?.kinopoisk && candidateIds?.kinopoisk === ids.kinopoisk) ||
+        (ids?.imdb && candidateIds?.imdb === ids.imdb));
+}
+// Creates the best supported player search input from a stream query.
+// Создает лучший поддерживаемый input поиска player из stream query.
+function createCandidateSearch(query) {
+    if (query.ids?.kinopoisk) {
+        return {
+            type: "kp_id",
+            value: query.ids.kinopoisk,
+        };
+    }
+    if (query.title) {
+        return {
+            type: "title",
+            value: query.title,
+        };
+    }
+    return undefined;
+}
+// Resolves Shikimori ID into title metadata without requiring user secrets.
+// Резолвит Shikimori ID в title metadata без пользовательских секретов.
+async function tryLookupShikimoriAnime(config, shikimoriId, context) {
+    const url = new URL(`/api/animes/${encodeURIComponent(shikimoriId)}`, `${config.shikimoriBaseUrl}/`);
+    const headers = {
+        accept: "application/json",
+    };
+    if (config.userAgent) {
+        headers["user-agent"] = config.userAgent;
+    }
+    try {
+        return await fetchJson({
+            provider: config.name,
+            url,
+            context: {
+                ...context,
+                timeoutMs: getBoundedTimeoutMs(context.timeoutMs, config.shikimoriLookupTimeoutMs),
+            },
+            fetch: config.fetch,
+            rateLimitGate: config.rateLimitGate,
+            maxRetries: 0,
+            init: {
+                headers,
+            },
+        });
+    }
+    catch (error) {
+        rethrowIfProviderAborted(context, error);
+        return undefined;
+    }
+}
+// Keeps helper lookups inside the remaining provider budget when one exists.
+// Удерживает вспомогательные lookup-запросы внутри общего бюджета провайдера, если он задан.
+function getBoundedTimeoutMs(contextTimeoutMs, fallbackTimeoutMs) {
+    return contextTimeoutMs === undefined
+        ? fallbackTimeoutMs
+        : Math.min(contextTimeoutMs, fallbackTimeoutMs);
+}
+// Parses optional integer-like values.
+// Парсит опциональные integer-like значения.
+function parseOptionalInteger(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    const parsed = typeof value === "number" ? value : Number.parseInt(value, 10);
+    return Number.isInteger(parsed) ? parsed : undefined;
+}
+// Parses a year from date-like values such as 2002-10-03.
+// Парсит год из date-like значений вроде 2002-10-03.
+function parseYear(value) {
+    if (!value) {
+        return undefined;
+    }
+    const year = Number.parseInt(value.slice(0, 4), 10);
+    return Number.isInteger(year) ? year : undefined;
+}
+export function normalizeSearchText(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/ё/g, "е")
+        .replace(/[^\p{L}\p{N}]+/gu, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=candidates.js.map

package/dist/kinobd-streaming/candidates.js.map

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

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

@@ -0,0 +1,49 @@
+import type { MediaAvailability, StreamingProviderCapabilities } from "@media-engine/core";
+import { ProviderRateLimitGate, type ProviderFetch } from "../shared/index.js";
+export interface KinoBdStreamingProviderOptions {
+    name?: string;
+    version?: string;
+    baseUrl?: string;
+    animeCacheBaseUrl?: string;
+    shikimoriBaseUrl?: string;
+    fetch?: ProviderFetch;
+    searchLimit?: number;
+    shikimoriLookupTimeoutMs?: number;
+    playerValidationLimit?: number;
+    playerValidationTimeoutMs?: number;
+    playerProviders?: string;
+    fast?: number;
+    userAgent?: string;
+    onPlayerAudit?: (audit: KinoBdPlayerAudit) => void;
+}
+export type KinoBdPlayerFilterReason = "provider_not_allowed" | "missing_iframe" | "known_broken_url" | "player_validation_failed";
+export interface KinoBdFilteredPlayerAuditEntry {
+    player: string;
+    reason: KinoBdPlayerFilterReason;
+    url?: string;
+}
+export interface KinoBdPlayerAudit {
+    query: MediaAvailability["query"];
+    discovered: string[];
+    shown: string[];
+    filtered: KinoBdFilteredPlayerAuditEntry[];
+}
+export interface KinoBdStreamingConfig {
+    name: string;
+    baseUrl: string;
+    animeCacheBaseUrl?: string;
+    shikimoriBaseUrl: string;
+    fetch?: ProviderFetch;
+    rateLimitGate: ProviderRateLimitGate;
+    searchLimit: number;
+    shikimoriLookupTimeoutMs: number;
+    playerValidationLimit: number;
+    playerValidationTimeoutMs: number;
+    playerProviders: string;
+    allowedPlayerProviders: ReadonlySet<string>;
+    fast: number;
+    userAgent?: string;
+    onPlayerAudit?: (audit: KinoBdPlayerAudit) => void;
+}
+export declare function createConfig(options: KinoBdStreamingProviderOptions): KinoBdStreamingConfig;
+export declare function createCapabilities(): StreamingProviderCapabilities;

package/dist/kinobd-streaming/config.js

@@ -0,0 +1,125 @@
+import { ProviderRateLimitGate } from "../shared/index.js";
+const PROVIDER_NAME = "kinobd-streaming";
+const DEFAULT_BASE_URL = "https://kinobd.net";
+const DEFAULT_SHIKIMORI_BASE_URL = "https://shikimori.io";
+const DEFAULT_SEARCH_LIMIT = 10;
+const DEFAULT_PLAYER_VALIDATION_LIMIT = 8;
+const DEFAULT_SHIKIMORI_LOOKUP_TIMEOUT_MS = 2_500;
+const PLAYER_VALIDATION_TIMEOUT_MS = 2_500;
+const DEFAULT_PLAYER_PROVIDERS = [
+    "collaps",
+    "vibix",
+    "alloha",
+    "kodik",
+    "kinotochka",
+    "flixcdn",
+    "ashdi",
+    "turbo",
+    "videocdn",
+    "bazon",
+    "ustore",
+    "pleer",
+    "videospider",
+    "iframe",
+    "moonwalk",
+    "hdvb",
+    "cdnmovies",
+    "lookbase",
+    "kholobok",
+    "videoapi",
+    "voidboost",
+    "videoseed",
+    "vk",
+].join(",");
+const BLOCKED_PLAYER_PROVIDERS = new Set([
+    "ext",
+    "ia",
+    "netflix",
+    "nf",
+    "torrent",
+    "trailer",
+    "trailer_local",
+    "youtube",
+]);
+// Builds provider config with ReYohoho-compatible defaults.
+// Собирает provider config с ReYohoho-compatible defaults.
+export function createConfig(options) {
+    const searchLimit = options.searchLimit ?? DEFAULT_SEARCH_LIMIT;
+    const shikimoriLookupTimeoutMs = options.shikimoriLookupTimeoutMs ?? DEFAULT_SHIKIMORI_LOOKUP_TIMEOUT_MS;
+    const playerValidationLimit = options.playerValidationLimit ?? DEFAULT_PLAYER_VALIDATION_LIMIT;
+    const playerValidationTimeoutMs = options.playerValidationTimeoutMs ?? PLAYER_VALIDATION_TIMEOUT_MS;
+    const fast = options.fast ?? 1;
+    const allowedPlayerProviders = parsePlayerProviderKeys(options.playerProviders ?? DEFAULT_PLAYER_PROVIDERS);
+    if (!Number.isInteger(searchLimit) || searchLimit <= 0) {
+        throw new TypeError("KinoBD streaming searchLimit must be a positive integer.");
+    }
+    if (!Number.isInteger(shikimoriLookupTimeoutMs) || shikimoriLookupTimeoutMs <= 0) {
+        throw new TypeError("KinoBD streaming shikimoriLookupTimeoutMs must be a positive integer.");
+    }
+    if (!Number.isInteger(playerValidationLimit) || playerValidationLimit < 0) {
+        throw new TypeError("KinoBD streaming playerValidationLimit must be a non-negative integer.");
+    }
+    if (!Number.isInteger(playerValidationTimeoutMs) || playerValidationTimeoutMs <= 0) {
+        throw new TypeError("KinoBD streaming playerValidationTimeoutMs must be a positive integer.");
+    }
+    if (!Number.isInteger(fast) || fast < 0) {
+        throw new TypeError("KinoBD streaming fast must be a non-negative integer.");
+    }
+    return {
+        name: normalizeProviderName(options.name ?? PROVIDER_NAME),
+        baseUrl: trimTrailingSlash(options.baseUrl ?? DEFAULT_BASE_URL),
+        animeCacheBaseUrl: options.animeCacheBaseUrl === undefined
+            ? undefined
+            : trimTrailingSlash(options.animeCacheBaseUrl),
+        shikimoriBaseUrl: trimTrailingSlash(options.shikimoriBaseUrl ?? DEFAULT_SHIKIMORI_BASE_URL),
+        fetch: options.fetch,
+        rateLimitGate: new ProviderRateLimitGate(),
+        searchLimit,
+        shikimoriLookupTimeoutMs,
+        playerValidationLimit,
+        playerValidationTimeoutMs,
+        playerProviders: [...allowedPlayerProviders].join(","),
+        allowedPlayerProviders,
+        fast,
+        userAgent: options.userAgent,
+        onPlayerAudit: options.onPlayerAudit,
+    };
+}
+// Builds safe capabilities for the public engine/API.
+// Собирает безопасные capabilities для публичного engine/API.
+export function createCapabilities() {
+    return {
+        mediaTypes: ["movie", "series", "anime"],
+        lookup: {
+            byTitle: true,
+            byExternalIds: ["kinopoisk", "shikimori"],
+            byEpisode: true,
+        },
+        features: ["embed", "translations", "qualities", "episode_mapping"],
+    };
+}
+function parsePlayerProviderKeys(playerProviders) {
+    return new Set(playerProviders
+        .split(",")
+        .map((provider) => provider.trim().toLowerCase())
+        .filter((provider) => provider && !BLOCKED_PLAYER_PROVIDERS.has(provider)));
+}
+// Validates and normalizes provider name.
+// Проверяет и нормализует имя provider.
+function normalizeProviderName(name) {
+    const normalized = name.trim();
+    if (!normalized) {
+        throw new TypeError("KinoBD streaming provider name is required.");
+    }
+    return normalized;
+}
+// Removes trailing slashes from base URLs.
+// Убирает trailing slashes из base URLs.
+function trimTrailingSlash(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new TypeError("KinoBD streaming baseUrl is required.");
+    }
+    return trimmed.replace(/\/+$/, "");
+}
+//# sourceMappingURL=config.js.map

package/dist/kinobd-streaming/config.js.map

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

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

@@ -1,31 +1,4 @@
-import type { MediaAvailability, StreamingProvider } from "@media-engine/core";
-import { type ProviderFetch } from "../shared/index.js";
-export interface KinoBdStreamingProviderOptions {
-    name?: string;
-    version?: string;
-    baseUrl?: string;
-    animeCacheBaseUrl?: string;
-    shikimoriBaseUrl?: string;
-    fetch?: ProviderFetch;
-    searchLimit?: number;
-    shikimoriLookupTimeoutMs?: number;
-    playerValidationLimit?: number;
-    playerValidationTimeoutMs?: number;
-    playerProviders?: string;
-    fast?: number;
-    userAgent?: string;
-    onPlayerAudit?: (audit: KinoBdPlayerAudit) => void;
-}
-export type KinoBdPlayerFilterReason = "provider_not_allowed" | "missing_iframe" | "known_broken_url" | "player_validation_failed";
-export interface KinoBdFilteredPlayerAuditEntry {
-    player: string;
-    reason: KinoBdPlayerFilterReason;
-    url?: string;
-}
-export interface KinoBdPlayerAudit {
-    query: MediaAvailability["query"];
-    discovered: string[];
-    shown: string[];
-    filtered: KinoBdFilteredPlayerAuditEntry[];
-}
+import type { StreamingProvider } from "@media-engine/core";
+import { type KinoBdStreamingProviderOptions } from "./config.js";
+export type { KinoBdFilteredPlayerAuditEntry, KinoBdPlayerAudit, KinoBdPlayerFilterReason, KinoBdStreamingProviderOptions, } from "./config.js";
 export declare function kinobdStreamingProvider(options?: KinoBdStreamingProviderOptions): StreamingProvider;