@media-engine/core 0.1.0 → 1.0.0

package/dist/engine/availability.js

@@ -0,0 +1,137 @@
+import { sortObject } from "./query.js";
+const EXPIRING_AVAILABILITY_CACHE_SAFETY_MS = 1_000;
+// Selects streaming providers that can answer the normalized stream query.
+// Выбирает streaming-провайдеры, которые могут ответить на нормализованный stream query.
+export function selectStreamingProviders(providers, query) {
+    return providers.filter((provider) => {
+        if (query.providers && !query.providers.includes(provider.name)) {
+            return false;
+        }
+        if (!provider.capabilities.mediaTypes.includes(query.type)) {
+            return false;
+        }
+        if (hasEpisodeQuery(query) && !provider.capabilities.lookup.byEpisode) {
+            return false;
+        }
+        return (Boolean(query.title && provider.capabilities.lookup.byTitle) ||
+            hasSupportedExternalId(query.ids, provider.capabilities.lookup.byExternalIds));
+    });
+}
+// Merges availability results without hiding provider attribution.
+// Объединяет availability-результаты, не скрывая атрибуцию провайдеров.
+export function mergeAvailabilityResults(query, results) {
+    return {
+        query,
+        item: results.find((result) => result.item)?.item,
+        episodes: mergeEpisodeAvailability(results),
+        options: uniqueBy(results.flatMap((result) => result.options), (option) => `${option.provider}:${option.id}`),
+        sourceProviders: uniqueBy(results.flatMap((result) => result.sourceProviders), (source) => createStreamingSourceKey(source)),
+        checkedAt: new Date().toISOString(),
+    };
+}
+// Keeps cached direct links from outliving the earliest advertised expiration.
+// Не позволяет кешированным прямым ссылкам пережить ближайший заявленный срок действия.
+export function createAvailabilityCacheOptions(availability) {
+    const expiresAtValues = [
+        ...availability.options,
+        ...(availability.episodes?.flatMap((episode) => episode.options) ?? []),
+    ]
+        .map((option) => option.expiresAt)
+        .filter((value) => value !== undefined)
+        .map((value) => Date.parse(value))
+        .filter(Number.isFinite);
+    if (expiresAtValues.length === 0) {
+        return { staleTtlMs: 0 };
+    }
+    const earliestExpiration = Math.min(...expiresAtValues);
+    return {
+        ttlMs: Math.max(0, earliestExpiration - Date.now() - EXPIRING_AVAILABILITY_CACHE_SAFETY_MS),
+        staleTtlMs: 0,
+    };
+}
+// Detects player options kept after validation could not reach a reliable conclusion.
+// Находит player options, сохраненные после неопределенного результата validation.
+export function hasUnknownStreamValidation(availability) {
+    return [
+        ...availability.options,
+        ...(availability.episodes?.flatMap((episode) => episode.options) ?? []),
+    ].some((option) => option.availability === "unknown");
+}
+// Merges episode-level availability blocks by episode identity.
+// Объединяет episode-level availability блоки по идентичности эпизода.
+function mergeEpisodeAvailability(results) {
+    const episodesByKey = new Map();
+    for (const episode of results.flatMap((result) => [
+        ...(result.episodes ?? []),
+        ...createEpisodeAvailabilityFromOptions(result.options),
+    ])) {
+        const key = createEpisodeKey(episode);
+        const existing = episodesByKey.get(key);
+        if (!existing) {
+            episodesByKey.set(key, {
+                seasonNumber: episode.seasonNumber,
+                episodeNumber: episode.episodeNumber,
+                absoluteEpisodeNumber: episode.absoluteEpisodeNumber,
+                title: episode.title,
+                options: uniqueBy(episode.options, (option) => `${option.provider}:${option.id}`),
+            });
+            continue;
+        }
+        existing.options = uniqueBy([...existing.options, ...episode.options], (option) => `${option.provider}:${option.id}`);
+        existing.title ??= episode.title;
+    }
+    return episodesByKey.size > 0 ? [...episodesByKey.values()] : undefined;
+}
+// Creates episode blocks from top-level options that carry episode identity.
+// Создает episode blocks из top-level options, которые содержат идентичность эпизода.
+function createEpisodeAvailabilityFromOptions(options) {
+    return options
+        .filter((option) => option.episode)
+        .map((option) => ({
+        seasonNumber: option.episode?.seasonNumber,
+        episodeNumber: option.episode?.episodeNumber,
+        absoluteEpisodeNumber: option.episode?.absoluteEpisodeNumber,
+        options: [option],
+    }));
+}
+// Checks whether query ids overlap provider-supported external ID sources.
+// Проверяет, пересекаются ли query ids с поддерживаемыми провайдером источниками ID.
+function hasSupportedExternalId(ids, supportedSources) {
+    return Boolean(ids && supportedSources.some((source) => Boolean(ids[source])));
+}
+// Checks whether query targets a concrete episode.
+// Проверяет, нацелен ли query на конкретный эпизод.
+function hasEpisodeQuery(query) {
+    return (query.seasonNumber !== undefined ||
+        query.episodeNumber !== undefined ||
+        query.absoluteEpisodeNumber !== undefined);
+}
+// Creates a stable identity for an episode availability block.
+// Создает стабильную идентичность для блока доступности эпизода.
+function createEpisodeKey(episode) {
+    return [
+        episode.seasonNumber ?? "",
+        episode.episodeNumber ?? "",
+        episode.absoluteEpisodeNumber ?? "",
+    ].join(":");
+}
+// Creates a stable identity for provider source attribution.
+// Создает стабильную идентичность для атрибуции источника провайдера.
+function createStreamingSourceKey(source) {
+    return `${source.provider}:${source.url ?? ""}:${JSON.stringify(sortObject(source.ids ?? {}))}`;
+}
+// Keeps the first value for each derived key.
+// Оставляет первое значение для каждого вычисленного ключа.
+function uniqueBy(values, getKey) {
+    const seen = new Set();
+    const unique = [];
+    for (const value of values) {
+        const key = getKey(value);
+        if (!seen.has(key)) {
+            seen.add(key);
+            unique.push(value);
+        }
+    }
+    return unique;
+}
+//# sourceMappingURL=availability.js.map

package/dist/engine/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../../src/engine/availability.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,qCAAqC,GAAG,KAAK,CAAC;AAEpD,2EAA2E;AAC3E,yFAAyF;AACzF,MAAM,UAAU,wBAAwB,CACtC,SAA8B,EAC9B,KAAkB;IAElB,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnC,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAChE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,CACL,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;YAC5D,sBAAsB,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,CAC9E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,wEAAwE;AACxE,MAAM,UAAU,wBAAwB,CACtC,KAAkB,EAClB,OAA4B;IAE5B,OAAO;QACL,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI;QACjD,QAAQ,EAAE,wBAAwB,CAAC,OAAO,CAAC;QAC3C,OAAO,EAAE,QAAQ,CACf,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAC3C,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,EAAE,EAAE,CAC9C;QACD,eAAe,EAAE,QAAQ,CACvB,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,EACnD,CAAC,MAAM,EAAE,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAC7C;QACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,wFAAwF;AACxF,MAAM,UAAU,8BAA8B,CAC5C,YAA+B;IAE/B,MAAM,eAAe,GAAG;QACtB,GAAG,YAAY,CAAC,OAAO;QACvB,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;KACxE;SACE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;SACjC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SACvD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE3B,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC;IAExD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,qCAAqC,CAAC;QAC3F,UAAU,EAAE,CAAC;KACd,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CAAC,YAA+B;IACxE,OAAO;QACL,GAAG,YAAY,CAAC,OAAO;QACvB,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;KACxE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC;AACxD,CAAC;AAED,gEAAgE;AAChE,uEAAuE;AACvE,SAAS,wBAAwB,CAC/B,OAA4B;IAE5B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAqC,CAAC;IAEnE,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAChD,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC1B,GAAG,oCAAoC,CAAC,MAAM,CAAC,OAAO,CAAC;KACxD,CAAC,EAAE,CAAC;QACH,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAExC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE;gBACrB,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;gBACpD,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;aAClF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,OAAO,GAAG,QAAQ,CACzB,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,EACzC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,EAAE,EAAE,CAC9C,CAAC;QACF,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC;AAED,6EAA6E;AAC7E,sFAAsF;AACtF,SAAS,oCAAoC,CAC3C,OAAuB;IAEvB,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;SAClC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY;QAC1C,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa;QAC5C,qBAAqB,EAAE,MAAM,CAAC,OAAO,EAAE,qBAAqB;QAC5D,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB,CAAC,CAAC,CAAC;AACR,CAAC;AAED,2EAA2E;AAC3E,qFAAqF;AACrF,SAAS,sBAAsB,CAC7B,GAA4B,EAC5B,gBAAmC;IAEnC,OAAO,OAAO,CACZ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAA2B,CAAC,CAAC,CAAC,CACpF,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,oDAAoD;AACpD,SAAS,eAAe,CAAC,KAAkB;IACzC,OAAO,CACL,KAAK,CAAC,YAAY,KAAK,SAAS;QAChC,KAAK,CAAC,aAAa,KAAK,SAAS;QACjC,KAAK,CAAC,qBAAqB,KAAK,SAAS,CAC1C,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,iEAAiE;AACjE,SAAS,gBAAgB,CAAC,OAAkC;IAC1D,OAAO;QACL,OAAO,CAAC,YAAY,IAAI,EAAE;QAC1B,OAAO,CAAC,aAAa,IAAI,EAAE;QAC3B,OAAO,CAAC,qBAAqB,IAAI,EAAE;KACpC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,6DAA6D;AAC7D,sEAAsE;AACtE,SAAS,wBAAwB,CAAC,MAA+B;IAC/D,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AAClG,CAAC;AAED,8CAA8C;AAC9C,4DAA4D;AAC5D,SAAS,QAAQ,CAAI,MAAW,EAAE,MAA4B;IAC5D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/engine/circuit-breaker.d.ts

@@ -0,0 +1,37 @@
+import type { CircuitBreakerOptions } from "./types.js";
+interface ProviderFailureCounts {
+    timeout: number;
+    rateLimited: number;
+    unavailable: number;
+    other: number;
+}
+export interface CircuitBreakerSnapshot {
+    state: "closed" | "open" | "half-open";
+    consecutiveFailures: number;
+    totalRequests: number;
+    totalSuccesses: number;
+    totalFailures: number;
+    lastSuccessAt?: number;
+    lastFailureAt?: number;
+    lastFailureCode?: string;
+    failureCounts: ProviderFailureCounts;
+    retryAfterMs?: number;
+}
+export declare class ProviderCircuitBreaker {
+    private readonly failureThreshold;
+    private readonly recoveryTimeoutMs;
+    private readonly now;
+    private readonly states;
+    private readonly observations;
+    constructor(options?: CircuitBreakerOptions, now?: () => number);
+    run<T>(key: string, provider: string, operation: () => Promise<T>): Promise<T>;
+    private releaseCancelledProbe;
+    getSnapshot(key: string): CircuitBreakerSnapshot;
+    private acquire;
+    private recordFailure;
+    private recordRequest;
+    private recordSuccess;
+    private recordObservedFailure;
+    private getObservation;
+}
+export {};

package/dist/engine/circuit-breaker.js

@@ -0,0 +1,174 @@
+import { ProviderError } from "../errors/index.js";
+import { isOperationCancelledError } from "./operation.js";
+const DEFAULT_FAILURE_THRESHOLD = 3;
+const DEFAULT_RECOVERY_TIMEOUT_MS = 30_000;
+// Tracks transient provider failures and allows one recovery probe after cooldown.
+// Отслеживает временные сбои провайдера и разрешает одну пробу после cooldown.
+export class ProviderCircuitBreaker {
+    failureThreshold;
+    recoveryTimeoutMs;
+    now;
+    states = new Map();
+    observations = new Map();
+    constructor(options = {}, now = Date.now) {
+        this.failureThreshold = validatePositiveInteger(options.failureThreshold, DEFAULT_FAILURE_THRESHOLD, "failureThreshold");
+        this.recoveryTimeoutMs = validateNonNegativeInteger(options.recoveryTimeoutMs, DEFAULT_RECOVERY_TIMEOUT_MS, "recoveryTimeoutMs");
+        this.now = now;
+    }
+    async run(key, provider, operation) {
+        this.acquire(key, provider);
+        this.recordRequest(key);
+        try {
+            const result = await operation();
+            this.states.delete(key);
+            this.recordSuccess(key);
+            return result;
+        }
+        catch (error) {
+            if (isOperationCancelledError(error)) {
+                this.releaseCancelledProbe(key);
+                throw error;
+            }
+            this.recordFailure(key, error);
+            this.recordObservedFailure(key, error);
+            throw error;
+        }
+    }
+    releaseCancelledProbe(key) {
+        const state = this.states.get(key);
+        if (state?.probeInFlight) {
+            state.probeInFlight = false;
+        }
+    }
+    getSnapshot(key) {
+        const now = this.now();
+        const state = this.states.get(key);
+        const observation = this.observations.get(key);
+        const circuitState = state?.probeInFlight
+            ? "half-open"
+            : state?.openedAt !== undefined
+                ? "open"
+                : "closed";
+        const retryAfterMs = state?.openedAt === undefined
+            ? undefined
+            : Math.max(0, this.recoveryTimeoutMs - (now - state.openedAt));
+        return {
+            state: circuitState,
+            consecutiveFailures: state?.failures ?? 0,
+            totalRequests: observation?.totalRequests ?? 0,
+            totalSuccesses: observation?.totalSuccesses ?? 0,
+            totalFailures: observation?.totalFailures ?? 0,
+            lastSuccessAt: observation?.lastSuccessAt,
+            lastFailureAt: observation?.lastFailureAt,
+            lastFailureCode: observation?.lastFailureCode,
+            failureCounts: observation?.failureCounts ?? createEmptyFailureCounts(),
+            retryAfterMs,
+        };
+    }
+    acquire(key, provider) {
+        const state = this.states.get(key);
+        if (state?.openedAt === undefined) {
+            return;
+        }
+        if (this.now() - state.openedAt < this.recoveryTimeoutMs || state.probeInFlight) {
+            throw createOpenCircuitError(provider);
+        }
+        state.probeInFlight = true;
+    }
+    recordFailure(key, error) {
+        const state = this.states.get(key);
+        if (!(error instanceof ProviderError) || !error.retryable) {
+            this.states.delete(key);
+            return;
+        }
+        if (state?.probeInFlight) {
+            this.states.set(key, {
+                failures: this.failureThreshold,
+                openedAt: this.now(),
+                probeInFlight: false,
+            });
+            return;
+        }
+        const failures = (state?.failures ?? 0) + 1;
+        this.states.set(key, {
+            failures,
+            openedAt: failures >= this.failureThreshold ? this.now() : undefined,
+            probeInFlight: false,
+        });
+    }
+    recordRequest(key) {
+        const observation = this.getObservation(key);
+        observation.totalRequests += 1;
+    }
+    recordSuccess(key) {
+        const observation = this.getObservation(key);
+        observation.totalSuccesses += 1;
+        observation.lastSuccessAt = this.now();
+    }
+    recordObservedFailure(key, error) {
+        const observation = this.getObservation(key);
+        observation.totalFailures += 1;
+        observation.lastFailureAt = this.now();
+        observation.lastFailureCode = error instanceof ProviderError ? error.code : "PROVIDER_ERROR";
+        if (!(error instanceof ProviderError)) {
+            observation.failureCounts.other += 1;
+        }
+        else if (error.code === "PROVIDER_TIMEOUT") {
+            observation.failureCounts.timeout += 1;
+        }
+        else if (error.code === "PROVIDER_RATE_LIMITED") {
+            observation.failureCounts.rateLimited += 1;
+        }
+        else if (error.code === "PROVIDER_UNAVAILABLE") {
+            observation.failureCounts.unavailable += 1;
+        }
+        else {
+            observation.failureCounts.other += 1;
+        }
+    }
+    getObservation(key) {
+        const existing = this.observations.get(key);
+        if (existing) {
+            return existing;
+        }
+        const observation = {
+            totalRequests: 0,
+            totalSuccesses: 0,
+            totalFailures: 0,
+            failureCounts: createEmptyFailureCounts(),
+        };
+        this.observations.set(key, observation);
+        return observation;
+    }
+}
+function createEmptyFailureCounts() {
+    return {
+        timeout: 0,
+        rateLimited: 0,
+        unavailable: 0,
+        other: 0,
+    };
+}
+function createOpenCircuitError(provider) {
+    return new ProviderError({
+        provider,
+        code: "PROVIDER_UNAVAILABLE",
+        message: `Provider "${provider}" circuit is open after repeated failures.`,
+        retryable: true,
+    });
+}
+function validatePositiveInteger(value, fallback, name) {
+    const normalized = value ?? fallback;
+    if (!Number.isSafeInteger(normalized) || normalized <= 0) {
+        throw new TypeError(`Circuit breaker ${name} must be a positive integer.`);
+    }
+    return normalized;
+}
+function validateNonNegativeInteger(value, fallback, name) {
+    const normalized = value ?? fallback;
+    if (!Number.isSafeInteger(normalized) || normalized < 0) {
+        throw new TypeError(`Circuit breaker ${name} must be a non-negative integer.`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/engine/circuit-breaker.js.map

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

package/dist/engine/concurrency-limiter.d.ts

@@ -0,0 +1,13 @@
+import type { ProviderConcurrencyOptions } from "./types.js";
+export declare class ProviderConcurrencyLimiter {
+    private readonly defaultMaxConcurrent;
+    private readonly maxQueueSize;
+    private readonly providerLimits;
+    private readonly queues;
+    constructor(options?: ProviderConcurrencyOptions);
+    run<T>(key: string, provider: string, signal: AbortSignal | undefined, operation: () => Promise<T>): Promise<T>;
+    private getQueue;
+    private execute;
+    private drain;
+    private deleteIdleQueue;
+}

package/dist/engine/concurrency-limiter.js

@@ -0,0 +1,109 @@
+import { ProviderError } from "../errors/index.js";
+const DEFAULT_MAX_CONCURRENT = 2;
+const DEFAULT_MAX_QUEUE_SIZE = 100;
+const MAX_CONCURRENT_BOUND = 100;
+const MAX_QUEUE_SIZE_BOUND = 10_000;
+// Bounds concurrent work independently for every metadata, streaming, or torrent provider.
+// Ограничивает параллельную работу отдельно для metadata, streaming и torrent-провайдеров.
+export class ProviderConcurrencyLimiter {
+    defaultMaxConcurrent;
+    maxQueueSize;
+    providerLimits;
+    queues = new Map();
+    constructor(options = {}) {
+        this.defaultMaxConcurrent = validateBoundedInteger(options.defaultMaxConcurrent, DEFAULT_MAX_CONCURRENT, 1, MAX_CONCURRENT_BOUND, "defaultMaxConcurrent");
+        this.maxQueueSize = validateBoundedInteger(options.maxQueueSize, DEFAULT_MAX_QUEUE_SIZE, 0, MAX_QUEUE_SIZE_BOUND, "maxQueueSize");
+        this.providerLimits = new Map(Object.entries(options.providerLimits ?? {}).map(([provider, limit]) => [
+            validateProviderName(provider),
+            validateBoundedInteger(limit, this.defaultMaxConcurrent, 1, MAX_CONCURRENT_BOUND, `providerLimits.${provider}`),
+        ]));
+    }
+    run(key, provider, signal, operation) {
+        if (signal?.aborted) {
+            return Promise.reject(signal.reason);
+        }
+        const queue = this.getQueue(key);
+        const limit = this.providerLimits.get(provider) ?? this.defaultMaxConcurrent;
+        if (queue.active < limit) {
+            return this.execute(key, queue, provider, operation);
+        }
+        if (queue.waiting.length >= this.maxQueueSize) {
+            return Promise.reject(createSaturatedError(provider));
+        }
+        return new Promise((resolve, reject) => {
+            const entry = { provider, operation, resolve, reject, signal };
+            if (signal) {
+                entry.onAbort = () => {
+                    const index = queue.waiting.indexOf(entry);
+                    if (index !== -1) {
+                        queue.waiting.splice(index, 1);
+                        reject(signal.reason);
+                        this.deleteIdleQueue(key, queue);
+                    }
+                };
+                signal.addEventListener("abort", entry.onAbort, { once: true });
+            }
+            queue.waiting.push(entry);
+        });
+    }
+    getQueue(key) {
+        const existing = this.queues.get(key);
+        if (existing) {
+            return existing;
+        }
+        const queue = { active: 0, waiting: [] };
+        this.queues.set(key, queue);
+        return queue;
+    }
+    async execute(key, queue, provider, operation) {
+        queue.active += 1;
+        try {
+            return await operation();
+        }
+        finally {
+            queue.active -= 1;
+            this.drain(key, queue, provider);
+        }
+    }
+    drain(key, queue, provider) {
+        const limit = this.providerLimits.get(provider) ?? this.defaultMaxConcurrent;
+        while (queue.active < limit) {
+            const next = queue.waiting.shift();
+            if (!next) {
+                break;
+            }
+            if (next.onAbort && next.signal) {
+                next.signal.removeEventListener("abort", next.onAbort);
+            }
+            void this.execute(key, queue, next.provider, next.operation).then(next.resolve, next.reject);
+        }
+        this.deleteIdleQueue(key, queue);
+    }
+    deleteIdleQueue(key, queue) {
+        if (queue.active === 0 && queue.waiting.length === 0) {
+            this.queues.delete(key);
+        }
+    }
+}
+function createSaturatedError(provider) {
+    return new ProviderError({
+        provider,
+        code: "PROVIDER_UNAVAILABLE",
+        message: `Provider "${provider}" concurrency queue is full.`,
+        retryable: true,
+    });
+}
+function validateProviderName(provider) {
+    if (!provider || provider.trim() !== provider) {
+        throw new TypeError("Provider concurrency override names must be non-empty and unpadded.");
+    }
+    return provider;
+}
+function validateBoundedInteger(value, fallback, minimum, maximum, name) {
+    const normalized = value ?? fallback;
+    if (!Number.isSafeInteger(normalized) || normalized < minimum || normalized > maximum) {
+        throw new TypeError(`Provider concurrency ${name} must be an integer between ${minimum} and ${maximum}.`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=concurrency-limiter.js.map

package/dist/engine/concurrency-limiter.js.map

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

package/dist/engine/engine.d.ts

@@ -4,26 +4,36 @@ import { type MergeStrategy } from "../merge/index.js";
 import { ProviderRegistry, type ProviderInfo } from "../providers/index.js";
 import type { SearchQuery, SearchResponse } from "../search/index.js";
 import type { MediaAvailability, StreamQuery, StreamingProviderInfo } from "../streaming/index.js";
-import type { MediaEngineOptions } from "./types.js";
+import type { TorrentDiscoveryQuery, TorrentDiscoveryResponse, TorrentProviderInfo } from "../torrent/index.js";
+import type { MediaEngineOperationOptions, MediaEngineOptions, ProviderHealthStatus } from "./types.js";
 export declare class MediaEngine {
     private readonly registry;
     private readonly streamingProviders;
+    private readonly torrentProviders;
     private readonly cache?;
     private readonly mergeStrategy;
     private readonly timeoutMs?;
     private readonly providerTimeouts;
     private readonly debug;
+    private readonly circuitBreaker?;
+    private readonly concurrencyLimiter?;
+    private readonly inFlightRequests;
     constructor(options?: MediaEngineOptions);
     getProviders(): ProviderInfo[];
     getStreamingProviders(): StreamingProviderInfo[];
-    search(query: SearchQuery): Promise<SearchResponse>;
-    getDetails(query: DetailsQuery): Promise<DetailsResponse>;
-    getAvailability(query: StreamQuery): Promise<MediaAvailability>;
+    getTorrentProviders(): TorrentProviderInfo[];
+    getProviderHealth(): ProviderHealthStatus[];
+    search(query: SearchQuery, options?: MediaEngineOperationOptions): Promise<SearchResponse>;
+    getDetails(query: DetailsQuery, options?: MediaEngineOperationOptions): Promise<DetailsResponse>;
+    getAvailability(query: StreamQuery, options?: MediaEngineOperationOptions): Promise<MediaAvailability>;
+    discoverTorrents(query: TorrentDiscoveryQuery, options?: MediaEngineOperationOptions): Promise<TorrentDiscoveryResponse>;
     protected get providerRegistry(): ProviderRegistry;
     protected get engineCache(): Cache | undefined;
     protected get engineMergeStrategy(): MergeStrategy;
     protected get engineTimeoutMs(): number | undefined;
     private getProviderTimeoutMs;
-    private loadSearchPoster;
+    private createProviderTimeoutBudget;
+    private loadReusableDetails;
+    private createProviderHealthStatus;
     protected get engineDebug(): boolean;
 }