@media-engine/core 0.1.0 → 1.0.0

package/dist/engine/search-poster-enrichment.js

@@ -0,0 +1,93 @@
+import { callTimedProviderDetails } from "./provider-calls.js";
+import { createSearchDetailsQuery, hasSharedExternalId, searchItemAsDetails, supportsSearchEnrichment, supportsSearchEnrichmentFeature, } from "./search-enrichment-shared.js";
+// Loads the best canonical poster while sharing matching ID-search work from the same plan.
+// Загружает лучший canonical poster, переиспользуя совпадающий ID-search того же plan.
+export async function loadSearchPoster(input) {
+    const query = createSearchDetailsQuery(input.result, input.language);
+    const selectedProviders = input.registry.selectDetailsProviders(query);
+    const providers = selectedProviders.filter((provider) => !input.excludedProviders.has(provider.name) &&
+        supportsSearchEnrichment(provider) &&
+        supportsSearchEnrichmentFeature(provider, "posters"));
+    if (input.reusableDetails?.poster) {
+        return {
+            ids: input.result.item.ids,
+            poster: input.reusableDetails.poster,
+            outcomes: [],
+            skipped: selectedProviders.length,
+        };
+    }
+    const searchProviders = new Set(input.result.sources.map((source) => source.provider));
+    const reusableSearchProviders = new Set(providers
+        .filter((provider) => provider.searchPosterMatchesDetails === true && searchProviders.has(provider.name))
+        .map((provider) => provider.name));
+    const reusablePosterProvider = providers.find((provider) => reusableSearchProviders.has(provider.name) &&
+        provider.name === input.result.item.poster?.source &&
+        input.result.item.poster);
+    const loads = await Promise.all(providers.map((provider) => loadPosterProviderResult(provider, query, input, reusableSearchProviders, reusablePosterProvider)));
+    const outcomes = loads.flatMap((load) => (load.outcome ? [load.outcome] : []));
+    const providerResults = loads.flatMap((load) => (load.result ? [load.result] : []));
+    return {
+        ids: input.result.item.ids,
+        poster: input.mergeStrategy.mergeDetails(providerResults, {
+            query,
+            language: input.language,
+            debug: input.debug,
+            warnings: [],
+        })?.poster,
+        outcomes,
+        skipped: selectedProviders.length - outcomes.length,
+    };
+}
+async function loadPosterProviderResult(provider, query, input, reusableSearchProviders, reusablePosterProvider) {
+    if (provider.name === reusablePosterProvider?.name) {
+        return {
+            result: {
+                provider: provider.name,
+                details: searchItemAsDetails(input.result.item),
+            },
+        };
+    }
+    if (reusableSearchProviders.has(provider.name)) {
+        return {};
+    }
+    if (provider.searchPosterMatchesDetails === true &&
+        provider.name === input.idEnrichment?.provider.name) {
+        const outcome = await input.idEnrichment.outcome;
+        const reusableResult = outcome.failure
+            ? undefined
+            : outcome.results.find((result) => result.item.poster && hasSharedExternalId(result.item.ids, query.ids));
+        if (reusableResult) {
+            return {
+                result: {
+                    provider: provider.name,
+                    details: searchItemAsDetails(reusableResult.item),
+                },
+            };
+        }
+    }
+    const timeoutMs = input.budget.reserve(provider.name);
+    if (timeoutMs === undefined) {
+        return {};
+    }
+    const outcome = await callTimedProviderDetails(provider, query, {
+        debug: input.debug,
+        language: input.language,
+        signal: input.signal,
+        circuitBreaker: input.circuitBreaker,
+        concurrencyLimiter: input.concurrencyLimiter,
+        timeoutMs,
+    });
+    return {
+        outcome,
+        result: outcome.failure || !outcome.result ? undefined : outcome.result,
+    };
+}
+// Applies canonical poster enrichments to matching search results.
+// Применяет canonical poster enrichment к совпадающим search results.
+export function applySearchPosterEnrichments(results, enrichments) {
+    return results.map((result) => {
+        const poster = enrichments.find((enrichment) => enrichment.poster && hasSharedExternalId(result.item.ids, enrichment.ids))?.poster;
+        return poster ? { ...result, item: { ...result.item, poster } } : result;
+    });
+}
+//# sourceMappingURL=search-poster-enrichment.js.map

package/dist/engine/search-poster-enrichment.js.map

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

package/dist/engine/search-result-freeze.d.ts

@@ -0,0 +1,13 @@
+import type { ExternalIds } from "../media/index.js";
+import type { EngineWarning } from "../response/index.js";
+import type { MediaSearchResult, SearchQuery } from "../search/index.js";
+import type { ProviderSearchCallOutcome } from "./provider-calls.js";
+export interface SearchIdEnrichment {
+    ids: ExternalIds | undefined;
+    outcome: ProviderSearchCallOutcome;
+}
+export declare function applySearchIdEnrichments(results: MediaSearchResult[], enrichments: SearchIdEnrichment[], warnings: EngineWarning[], language: string | undefined): MediaSearchResult[];
+export declare function finalizeSearchRankingEvidence(results: MediaSearchResult[]): MediaSearchResult[];
+export declare function createFrozenDiscoveryResults(rankedResults: MediaSearchResult[], preliminaryResults: MediaSearchResult[]): MediaSearchResult[];
+export declare function createSearchEnrichmentCandidates(frozenResults: MediaSearchResult[], preliminaryResults: MediaSearchResult[]): MediaSearchResult[];
+export declare function filterFrozenSearchResults(results: MediaSearchResult[], query: SearchQuery): MediaSearchResult[];

package/dist/engine/search-result-freeze.js

@@ -0,0 +1,155 @@
+import { mergeAlternativeTitles, mergeGenres, mergeRatings, selectBestImage, selectDescription, selectReleaseDate, selectShortDescription, } from "../merge/fields.js";
+import { hasSharedStrongId } from "../merge/identity.js";
+import { EXTERNAL_ID_KEYS } from "../merge/internal.js";
+import { titleRelevanceScore } from "../merge/scoring.js";
+import { hasSharedExternalId } from "./search-enrichment-shared.js";
+// Applies optional provider data to frozen discovery candidates without changing identity/order.
+// Применяет optional provider data к frozen discovery candidates без изменения identity/order.
+export function applySearchIdEnrichments(results, enrichments, warnings, language) {
+    return results.map((result) => {
+        const candidates = enrichments.flatMap((enrichment) => {
+            if (enrichment.outcome.failure || !hasSharedExternalId(result.item.ids, enrichment.ids)) {
+                return [];
+            }
+            return enrichment.outcome.results.filter((candidate) => hasSharedExternalId(candidate.item.ids, enrichment.ids) &&
+                arePresentationTypesCompatible(result.item, candidate.item));
+        });
+        if (candidates.length === 0) {
+            return result;
+        }
+        const entries = createPresentationEntries(result, candidates);
+        const imageEntries = [...entries.slice(1), entries[0]];
+        return {
+            ...result,
+            item: {
+                ...result.item,
+                alternativeTitles: mergeAlternativeTitles(entries, result.item.title),
+                releaseDate: selectReleaseDate(entries),
+                description: selectDescription(entries, { language }),
+                shortDescription: selectShortDescription(entries),
+                poster: selectBestImage(imageEntries, "poster"),
+                backdrop: selectBestImage(imageEntries, "backdrop"),
+                genres: mergeGenres(entries),
+                ratings: mergeRatings(entries),
+                ids: mergeFrozenExternalIds(result.item.ids, candidates, warnings),
+            },
+            sources: mergeFrozenSources(result.sources, candidates),
+        };
+    });
+}
+// Refreshes final debug positions after snapshot recovery without changing candidate order.
+// Обновляет итоговые debug-позиции после snapshot recovery без изменения порядка кандидатов.
+export function finalizeSearchRankingEvidence(results) {
+    return results.map((result, index) => result.ranking
+        ? {
+            ...result,
+            ranking: {
+                ...result.ranking,
+                finalPosition: index + 1,
+            },
+        }
+        : result);
+}
+// Keeps ranked relevant identities first while retaining unresolved discovery candidates for aliases.
+// Сохраняет ranked relevant identities первыми и оставляет unresolved candidates для aliases.
+export function createFrozenDiscoveryResults(rankedResults, preliminaryResults) {
+    const frozen = [...rankedResults];
+    for (const candidate of preliminaryResults) {
+        if (!frozen.some((existing) => isSameDiscoveryCandidate(existing, candidate))) {
+            frozen.push(candidate);
+        }
+    }
+    return frozen;
+}
+// Selects bounded enrichment targets by preliminary discovery priority without changing response order.
+// Выбирает bounded enrichment targets по preliminary priority без изменения порядка ответа.
+export function createSearchEnrichmentCandidates(frozenResults, preliminaryResults) {
+    const candidates = [];
+    for (const preliminary of preliminaryResults) {
+        const frozen = frozenResults.find((result) => isSameDiscoveryCandidate(result, preliminary));
+        if (frozen && !candidates.includes(frozen)) {
+            candidates.push(frozen);
+        }
+    }
+    for (const frozen of frozenResults) {
+        if (!candidates.includes(frozen)) {
+            candidates.push(frozen);
+        }
+    }
+    return candidates;
+}
+// Removes candidates that remain unrelated after presentation enrichment without changing order.
+// Удаляет нерелевантные после presentation enrichment candidates без изменения порядка.
+export function filterFrozenSearchResults(results, query) {
+    const queryTitle = query.title?.trim();
+    if (!queryTitle) {
+        return results;
+    }
+    return results.filter((result) => {
+        const entry = {
+            result: {
+                provider: result.sources[0]?.provider ?? "search-discovery",
+                item: result.item,
+            },
+            index: 0,
+        };
+        return titleRelevanceScore([entry], queryTitle) > 0;
+    });
+}
+function createPresentationEntries(result, candidates) {
+    const base = {
+        provider: result.sources[0]?.provider ?? "search-discovery",
+        item: result.item,
+    };
+    return [base, ...candidates].map((providerResult, index) => ({
+        result: providerResult,
+        index,
+    }));
+}
+function arePresentationTypesCompatible(left, right) {
+    return (left.type === right.type ||
+        (left.type === "anime" && right.type === "series") ||
+        (left.type === "series" && right.type === "anime"));
+}
+function isSameDiscoveryCandidate(left, right) {
+    return ((left.item.type === right.item.type && left.item.id === right.item.id) ||
+        (left.item.type === right.item.type && hasSharedStrongId(left.item.ids, right.item.ids)));
+}
+function mergeFrozenExternalIds(discoveryIds, candidates, warnings) {
+    const merged = { ...discoveryIds };
+    for (const candidate of candidates) {
+        for (const key of EXTERNAL_ID_KEYS) {
+            const value = candidate.item.ids?.[key];
+            if (!value) {
+                continue;
+            }
+            const existing = merged[key];
+            if (!existing) {
+                merged[key] = value;
+            }
+            else if (existing !== value) {
+                warnings.push({
+                    code: "EXTERNAL_ID_CONFLICT",
+                    message: `Conflicting ${key} IDs during search enrichment; kept ${existing}.`,
+                    provider: candidate.provider,
+                });
+            }
+        }
+    }
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}
+function mergeFrozenSources(discoverySources, candidates) {
+    const sources = discoverySources.map((source) => structuredClone(source));
+    for (const candidate of candidates) {
+        const source = {
+            provider: candidate.source?.provider ?? candidate.provider,
+            ids: candidate.source?.ids ?? candidate.item.ids,
+            url: candidate.source?.url,
+        };
+        if (!sources.some((existing) => existing.provider === source.provider)) {
+            sources.push(source);
+        }
+    }
+    return sources;
+}
+//# sourceMappingURL=search-result-freeze.js.map

package/dist/engine/search-result-freeze.js.map

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

package/dist/engine/stale-fallback.d.ts

@@ -0,0 +1,11 @@
+import type { ResponseMeta } from "../response/index.js";
+interface ResponseWithMeta {
+    meta: ResponseMeta;
+}
+export interface StaleFallbackInput<T extends ResponseWithMeta> {
+    stale: T | undefined;
+    pending: Promise<T>;
+    tookMs: () => number;
+}
+export declare function loadWithStaleFallback<T extends ResponseWithMeta>(input: StaleFallbackInput<T>): Promise<T>;
+export {};

package/dist/engine/stale-fallback.js

@@ -0,0 +1,60 @@
+import { MediaEngineError } from "../errors/index.js";
+// Returns stale metadata only when every current provider failure is retryable.
+// Возвращает устаревшие метаданные только при retryable-сбое всех текущих провайдеров.
+export async function loadWithStaleFallback(input) {
+    try {
+        return await input.pending;
+    }
+    catch (error) {
+        const failed = getRetryableProviderFailures(error);
+        if (!input.stale || !failed) {
+            throw error;
+        }
+        const response = structuredClone(input.stale);
+        response.meta = {
+            providers: {
+                requested: failed.map((failure) => failure.provider),
+                successful: [],
+                failed,
+            },
+            cached: true,
+            stale: true,
+            tookMs: input.tookMs(),
+            warnings: [
+                {
+                    code: "STALE_CACHE_FALLBACK",
+                    message: "Returned stale cached data because all selected providers failed retryably.",
+                },
+            ],
+            debug: response.meta.debug
+                ? {
+                    providers: failed.map((failure) => failure.provider),
+                    timings: [],
+                }
+                : undefined,
+        };
+        return response;
+    }
+}
+function getRetryableProviderFailures(error) {
+    if (!(error instanceof MediaEngineError) || error.code !== "PROVIDER_ERROR") {
+        return undefined;
+    }
+    const cause = error.cause;
+    const failed = cause?.failed;
+    if (!Array.isArray(failed) || failed.length === 0 || !failed.every(isRetryableProviderFailure)) {
+        return undefined;
+    }
+    return failed;
+}
+function isRetryableProviderFailure(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const failure = value;
+    return (typeof failure.provider === "string" &&
+        typeof failure.code === "string" &&
+        failure.retryable === true &&
+        typeof failure.message === "string");
+}
+//# sourceMappingURL=stale-fallback.js.map

package/dist/engine/stale-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-fallback.js","sourceRoot":"","sources":["../../src/engine/stale-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAatD,gFAAgF;AAChF,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAA4B;IAE5B,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAAC,OAAO,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;QAEnD,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,QAAQ,CAAC,IAAI,GAAG;YACd,SAAS,EAAE;gBACT,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;gBACpD,UAAU,EAAE,EAAE;gBACd,MAAM;aACP;YACD,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;YACtB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,6EAA6E;iBACvF;aACF;YACD,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK;gBACxB,CAAC,CAAC;oBACE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;oBACpD,OAAO,EAAE,EAAE;iBACZ;gBACH,CAAC,CAAC,SAAS;SACd,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAc;IAClD,IAAI,CAAC,CAAC,KAAK,YAAY,gBAAgB,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC5E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAyC,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,CAAC;IAE7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC/F,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,KAAiC,CAAC;IAClD,OAAO,CACL,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QACpC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAChC,OAAO,CAAC,SAAS,KAAK,IAAI;QAC1B,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CACpC,CAAC;AACJ,CAAC"}

package/dist/engine/timeout-budget.d.ts

@@ -0,0 +1,7 @@
+export declare class ProviderTimeoutBudget {
+    private readonly resolveTimeoutMs;
+    private readonly now;
+    private readonly deadlines;
+    constructor(resolveTimeoutMs: (provider: string) => number | undefined, now?: () => number);
+    getRemainingMs(provider: string, callLimitMs?: number): number | undefined;
+}

package/dist/engine/timeout-budget.js

@@ -0,0 +1,31 @@
+// Shares one timeout deadline across all calls to a provider in one engine operation.
+// Делит один timeout deadline между всеми вызовами провайдера в одной операции движка.
+export class ProviderTimeoutBudget {
+    resolveTimeoutMs;
+    now;
+    deadlines = new Map();
+    constructor(resolveTimeoutMs, now = Date.now) {
+        this.resolveTimeoutMs = resolveTimeoutMs;
+        this.now = now;
+    }
+    getRemainingMs(provider, callLimitMs) {
+        const now = this.now();
+        const existingDeadline = this.deadlines.get(provider);
+        if (existingDeadline !== undefined) {
+            return applyCallLimit(Math.max(0, existingDeadline - now), callLimitMs);
+        }
+        const timeoutMs = this.resolveTimeoutMs(provider);
+        const initialBudget = applyCallLimit(timeoutMs, callLimitMs);
+        if (initialBudget !== undefined) {
+            this.deadlines.set(provider, now + initialBudget);
+        }
+        return initialBudget;
+    }
+}
+function applyCallLimit(timeoutMs, callLimitMs) {
+    if (timeoutMs === undefined) {
+        return callLimitMs;
+    }
+    return callLimitMs === undefined ? timeoutMs : Math.min(timeoutMs, callLimitMs);
+}
+//# sourceMappingURL=timeout-budget.js.map

package/dist/engine/timeout-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-budget.js","sourceRoot":"","sources":["../../src/engine/timeout-budget.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,uFAAuF;AACvF,MAAM,OAAO,qBAAqB;IAIb;IACA;IAJF,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvD,YACmB,gBAA0D,EAC1D,MAAoB,IAAI,CAAC,GAAG;QAD5B,qBAAgB,GAAhB,gBAAgB,CAA0C;QAC1D,QAAG,GAAH,GAAG,CAAyB;IAC5C,CAAC;IAEJ,cAAc,CAAC,QAAgB,EAAE,WAAoB;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEtD,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAE7D,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,GAAG,aAAa,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;CACF;AAED,SAAS,cAAc,CACrB,SAA6B,EAC7B,WAA+B;IAE/B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAClF,CAAC"}

package/dist/engine/torrents.d.ts

@@ -0,0 +1,22 @@
+import type { Cache, CacheSetOptions } from "../cache/index.js";
+import type { TorrentDiscoveryQuery, TorrentDiscoveryResponse, TorrentProvider } from "../torrent/index.js";
+import type { MediaEngineOperationOptions } from "./types.js";
+import type { ProviderCircuitBreaker } from "./circuit-breaker.js";
+import type { ProviderConcurrencyLimiter } from "./concurrency-limiter.js";
+import type { InFlightRequestCoalescer } from "./in-flight.js";
+export interface TorrentDiscoveryOperationContext {
+    query: TorrentDiscoveryQuery;
+    options: MediaEngineOperationOptions;
+    startedAt: number;
+    providers: TorrentProvider[];
+    cache?: Cache;
+    debug: boolean;
+    circuitBreaker?: ProviderCircuitBreaker;
+    concurrencyLimiter?: ProviderConcurrencyLimiter;
+    inFlightRequests: InFlightRequestCoalescer;
+    getProviderTimeoutMs(providerName: string): number | undefined;
+}
+export declare function executeTorrentDiscovery(context: TorrentDiscoveryOperationContext): Promise<TorrentDiscoveryResponse>;
+export declare function selectTorrentProviders(providers: TorrentProvider[], query: TorrentDiscoveryQuery): TorrentProvider[];
+export declare function mergeTorrentDiscoveryResults(query: TorrentDiscoveryQuery, results: TorrentDiscoveryResponse[]): TorrentDiscoveryResponse;
+export declare function createTorrentCacheOptions(response: TorrentDiscoveryResponse): CacheSetOptions | undefined;

package/dist/engine/torrents.js

@@ -0,0 +1,188 @@
+import { MediaEngineError } from "../errors/index.js";
+import { createTorrentDiscoveryCacheKey, sortObject } from "./query.js";
+import { throwIfAborted, waitForCaller } from "./operation.js";
+import { callTimedTorrentProvider } from "./provider-calls.js";
+import { createResponseMeta, elapsedSince } from "./response-meta.js";
+import { ProviderTimeoutBudget } from "./timeout-budget.js";
+const EXPIRING_TORRENT_CACHE_SAFETY_MS = 1_000;
+// Executes the complete cache/coalescing/provider lifecycle for torrent discovery.
+// Выполняет полный cache/coalescing/provider lifecycle для torrent discovery.
+export async function executeTorrentDiscovery(context) {
+    const { query, options, startedAt } = context;
+    if (query.limit === 0) {
+        const response = mergeTorrentDiscoveryResults(query, []);
+        response.meta = createResponseMeta({
+            requested: [],
+            successful: [],
+            failed: [],
+            warnings: [],
+            cached: false,
+            tookMs: elapsedSince(startedAt),
+            debug: context.debug,
+            timings: [],
+        });
+        return response;
+    }
+    const cacheKey = createTorrentDiscoveryCacheKey(query);
+    const cached = await waitForCaller(context.cache?.get(cacheKey), options.signal);
+    if (cached) {
+        const response = structuredClone(cached);
+        return {
+            ...response,
+            query,
+            meta: response.meta
+                ? {
+                    ...response.meta,
+                    cached: true,
+                    tookMs: elapsedSince(startedAt),
+                }
+                : undefined,
+        };
+    }
+    const inFlight = context.inFlightRequests.forCaller(options);
+    return inFlight.run(`torrents:${cacheKey}`, async (operationSignal) => {
+        const timeoutBudget = new ProviderTimeoutBudget(context.getProviderTimeoutMs);
+        const providers = selectTorrentProviders(context.providers, query);
+        const requested = providers.map((provider) => provider.name);
+        const successful = [];
+        const failed = [];
+        const providerResults = [];
+        const providerTimings = [];
+        const outcomes = await Promise.all(providers.map((provider) => callTimedTorrentProvider(provider, query, {
+            debug: context.debug,
+            language: query.language,
+            signal: operationSignal,
+            timeoutMs: timeoutBudget.getRemainingMs(provider.name),
+            circuitBreaker: context.circuitBreaker,
+            concurrencyLimiter: context.concurrencyLimiter,
+        })));
+        for (const outcome of outcomes) {
+            providerTimings.push(outcome.timing);
+            if (outcome.failure) {
+                failed.push(outcome.failure);
+            }
+            else {
+                successful.push(outcome.provider);
+                if (outcome.result) {
+                    providerResults.push(outcome.result);
+                }
+            }
+        }
+        if (providers.length > 0 && failed.length === providers.length) {
+            throw new MediaEngineError({
+                code: "PROVIDER_ERROR",
+                message: "All torrent providers failed.",
+                cause: { failed },
+            });
+        }
+        const response = mergeTorrentDiscoveryResults(query, providerResults);
+        response.meta = createResponseMeta({
+            requested,
+            successful,
+            failed,
+            warnings: [],
+            cached: false,
+            tookMs: elapsedSince(startedAt),
+            debug: context.debug,
+            timings: providerTimings,
+        });
+        throwIfAborted(operationSignal);
+        if (!failed.some((failure) => failure.retryable)) {
+            await context.cache?.set(cacheKey, structuredClone(response), createTorrentCacheOptions(response));
+        }
+        return response;
+    });
+}
+// Selects torrent providers that can answer the normalized discovery query.
+// Выбирает torrent-провайдеры, способные ответить на нормализованный discovery-запрос.
+export function selectTorrentProviders(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 torrent discovery results without hiding provider attribution.
+// Объединяет torrent discovery результаты, не скрывая атрибуцию провайдеров.
+export function mergeTorrentDiscoveryResults(query, results) {
+    const candidates = interleaveUniqueCandidates(results);
+    return {
+        query,
+        item: results.find((result) => result.item)?.item,
+        candidates: query.limit === undefined ? candidates : candidates.slice(0, query.limit),
+        sourceProviders: uniqueBy(results.flatMap((result) => result.sourceProviders), (source) => createTorrentSourceKey(source)),
+        checkedAt: new Date().toISOString(),
+    };
+}
+// Interleaves configured provider results so a global limit preserves source diversity.
+// Чередует результаты провайдеров, чтобы глобальный limit сохранял разнообразие источников.
+function interleaveUniqueCandidates(results) {
+    const candidates = [];
+    const seen = new Set();
+    const maximumLength = Math.max(0, ...results.map((result) => result.candidates.length));
+    for (let index = 0; index < maximumLength; index += 1) {
+        for (const result of results) {
+            const candidate = result.candidates[index];
+            if (!candidate) {
+                continue;
+            }
+            const key = createTorrentCandidateKey(candidate);
+            if (!seen.has(key)) {
+                seen.add(key);
+                candidates.push(candidate);
+            }
+        }
+    }
+    return candidates;
+}
+// Keeps cached handoff data from outliving its earliest advertised expiration.
+// Не позволяет кешированным handoff-данным пережить ближайший заявленный срок действия.
+export function createTorrentCacheOptions(response) {
+    const expirations = response.candidates
+        .map((candidate) => candidate.expiresAt)
+        .filter((value) => value !== undefined)
+        .map((value) => Date.parse(value))
+        .filter(Number.isFinite);
+    if (expirations.length === 0) {
+        return { staleTtlMs: 0 };
+    }
+    return {
+        ttlMs: Math.max(0, Math.min(...expirations) - Date.now() - EXPIRING_TORRENT_CACHE_SAFETY_MS),
+        staleTtlMs: 0,
+    };
+}
+function hasSupportedExternalId(ids, supportedSources) {
+    return Boolean(ids && supportedSources.some((source) => Boolean(ids[source])));
+}
+function hasEpisodeQuery(query) {
+    return (query.seasonNumber !== undefined ||
+        query.episodeNumber !== undefined ||
+        query.absoluteEpisodeNumber !== undefined);
+}
+function createTorrentCandidateKey(candidate) {
+    return `${candidate.provider}:${candidate.id}`;
+}
+function createTorrentSourceKey(source) {
+    return `${source.provider}:${source.url ?? ""}:${JSON.stringify(sortObject(source.ids ?? {}))}`;
+}
+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=torrents.js.map

package/dist/engine/torrents.js.map

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