@media-engine/core 0.1.0 → 1.0.0

package/dist/engine/search-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-discovery.js","sourceRoot":"","sources":["../../src/engine/search-discovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,8EAA8E;AAC9E,qFAAqF;AACrF,MAAM,UAAU,2BAA2B,CACzC,KAAkB,EAClB,eAAoC;IAEpC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,mBAAmB,GAAG,CAAC,MAAyB,EAAW,EAAE,CACjE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;SAC3C,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SAClD,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,eAAe,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IAErF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAAE,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7E,CAAC;AAED,8FAA8F;AAC9F,gGAAgG;AAChG,MAAM,UAAU,2BAA2B,CACzC,KAAkB,EAClB,eAAoC;IAEpC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpD,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACtC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;SAC3C,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SAClD,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,eAAe,CAAC,CAC9D,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAkB;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC"}

package/dist/engine/search-enrichment-shared.d.ts

@@ -0,0 +1,23 @@
+import type { DetailsQuery } from "../details/index.js";
+import type { ExternalIds, MediaDetails, MediaItem } from "../media/index.js";
+import type { MediaProvider } from "../providers/index.js";
+import type { MediaSearchResult } from "../search/index.js";
+import type { ProviderSearchCallOutcome } from "./provider-calls.js";
+export interface PlannedIdEnrichment {
+    provider: MediaProvider;
+    outcome: Promise<ProviderSearchCallOutcome>;
+}
+export declare function supportsSearchEnrichmentFeature(provider: MediaProvider, feature: "posters" | "ratings"): boolean;
+export declare function supportsSearchEnrichment(provider: MediaProvider): boolean;
+export declare function createSearchDetailsQuery(result: MediaSearchResult, language: string | undefined): DetailsQuery;
+export declare function searchItemAsDetails(item: MediaItem): MediaDetails;
+export declare function hasSharedExternalId(left: ExternalIds | undefined, right: ExternalIds | undefined): boolean;
+export declare class SearchEnrichmentCallBudget {
+    private readonly getProviderTimeoutMs;
+    private readonly startedAt;
+    private readonly providerCalls;
+    private calls;
+    constructor(getProviderTimeoutMs: (providerName: string) => number | undefined);
+    getRemainingWallTimeMs(): number;
+    reserve(providerName: string): number | undefined;
+}

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

@@ -0,0 +1,68 @@
+import { EXTERNAL_ID_SHORTCUTS } from "./query.js";
+const SEARCH_ENRICHMENT_MAX_ADDITIONAL_CALLS = 6;
+const SEARCH_ENRICHMENT_MAX_CALLS_PER_PROVIDER = 2;
+const SEARCH_ENRICHMENT_MAX_WALL_TIME_MS = 1_500;
+export function supportsSearchEnrichmentFeature(provider, feature) {
+    return provider.capabilities.features?.includes(feature) ?? true;
+}
+export function supportsSearchEnrichment(provider) {
+    return provider.capabilities.searchEnrichment !== false;
+}
+export function createSearchDetailsQuery(result, language) {
+    return {
+        type: result.item.type,
+        ids: result.item.ids,
+        language,
+    };
+}
+// Reuses only compact fields; every details-only field remains absent by construction.
+// Переиспользует только compact-поля; details-only поля намеренно остаются пустыми.
+export function searchItemAsDetails(item) {
+    switch (item.type) {
+        case "movie":
+            return { ...item, type: "movie" };
+        case "series":
+            return { ...item, type: "series" };
+        case "anime":
+            return { ...item, type: "anime" };
+    }
+}
+// Checks whether two normalized media identities share at least one exact external ID.
+// Проверяет, совпадает ли у двух нормализованных media identity хотя бы один внешний ID.
+export function hasSharedExternalId(left, right) {
+    if (!left || !right) {
+        return false;
+    }
+    return EXTERNAL_ID_SHORTCUTS.some((key) => Boolean(left[key] && left[key] === right[key]));
+}
+export class SearchEnrichmentCallBudget {
+    getProviderTimeoutMs;
+    startedAt = Date.now();
+    providerCalls = new Map();
+    calls = 0;
+    constructor(getProviderTimeoutMs) {
+        this.getProviderTimeoutMs = getProviderTimeoutMs;
+    }
+    getRemainingWallTimeMs() {
+        return Math.max(0, SEARCH_ENRICHMENT_MAX_WALL_TIME_MS - (Date.now() - this.startedAt));
+    }
+    reserve(providerName) {
+        const providerCalls = this.providerCalls.get(providerName) ?? 0;
+        if (this.calls >= SEARCH_ENRICHMENT_MAX_ADDITIONAL_CALLS ||
+            providerCalls >= SEARCH_ENRICHMENT_MAX_CALLS_PER_PROVIDER) {
+            return undefined;
+        }
+        const remainingWallTimeMs = this.getRemainingWallTimeMs();
+        const remainingProviderTimeMs = this.getProviderTimeoutMs(providerName);
+        const timeoutMs = remainingProviderTimeMs === undefined
+            ? remainingWallTimeMs
+            : Math.min(remainingWallTimeMs, remainingProviderTimeMs);
+        if (timeoutMs <= 0) {
+            return undefined;
+        }
+        this.calls += 1;
+        this.providerCalls.set(providerName, providerCalls + 1);
+        return timeoutMs;
+    }
+}
+//# sourceMappingURL=search-enrichment-shared.js.map

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

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

package/dist/engine/search-enrichment.d.ts

@@ -0,0 +1,42 @@
+import type { DetailsQuery } from "../details/index.js";
+import type { ExternalIds, MediaDetails } from "../media/index.js";
+import type { MergeStrategy } from "../merge/index.js";
+import type { ProviderRegistry } from "../providers/index.js";
+import type { MediaSearchResult } from "../search/index.js";
+import type { ProviderCircuitBreaker } from "./circuit-breaker.js";
+import type { ProviderConcurrencyLimiter } from "./concurrency-limiter.js";
+import { type SearchPosterEnrichment } from "./search-poster-enrichment.js";
+import type { SearchIdEnrichment } from "./search-result-freeze.js";
+interface SearchEnrichmentPlannerInput {
+    results: MediaSearchResult[];
+    publicLimit: number | undefined;
+    language: string | undefined;
+    excludedProviders: ReadonlySet<string>;
+    registry: ProviderRegistry;
+    mergeStrategy: MergeStrategy;
+    debug: boolean;
+    signal?: AbortSignal;
+    circuitBreaker?: ProviderCircuitBreaker | undefined;
+    concurrencyLimiter?: ProviderConcurrencyLimiter | undefined;
+    getProviderTimeoutMs(providerName: string): number | undefined;
+    loadReusableDetails(query: DetailsQuery, signal: AbortSignal | undefined, maxWaitMs: number): Promise<MediaDetails | undefined>;
+}
+interface SearchEnrichmentPlanResult {
+    idEnrichments: SearchIdEnrichment[];
+    skippedId: number;
+    detailsEnrichments: SearchDetailsEnrichment[];
+    posterEnrichments: SearchPosterEnrichment[];
+    skippedPoster: number;
+}
+interface SearchDetailsEnrichment {
+    ids: ExternalIds | undefined;
+    details: MediaDetails;
+}
+export declare function executeSearchEnrichmentPlan(input: SearchEnrichmentPlannerInput): Promise<SearchEnrichmentPlanResult>;
+export declare function needsSearchEnrichment(item: {
+    ratings?: unknown[];
+    description?: string;
+    poster?: unknown;
+}): boolean;
+export declare function applySearchDetailsEnrichments(results: MediaSearchResult[], enrichments: SearchDetailsEnrichment[]): MediaSearchResult[];
+export {};

package/dist/engine/search-enrichment.js

@@ -0,0 +1,150 @@
+import { callTimedProviderSearch } from "./provider-calls.js";
+import { hasExternalIds } from "./query.js";
+import { createSearchDetailsQuery, hasSharedExternalId, SearchEnrichmentCallBudget, supportsSearchEnrichment, supportsSearchEnrichmentFeature, } from "./search-enrichment-shared.js";
+import { loadSearchPoster } from "./search-poster-enrichment.js";
+const SEARCH_ENRICHMENT_MAX_CANDIDATES = 6;
+const SEARCH_POSTER_MAX_CANDIDATES = 3;
+// Runs one bounded plan for ID and canonical-poster enrichment of the visible top results.
+// Выполняет единый bounded plan для ID и canonical-poster enrichment видимых top results.
+export async function executeSearchEnrichmentPlan(input) {
+    const candidateLimit = Math.min(SEARCH_ENRICHMENT_MAX_CANDIDATES, input.publicLimit ?? SEARCH_ENRICHMENT_MAX_CANDIDATES);
+    const candidates = input.results.slice(0, candidateLimit);
+    const posterCandidateLimit = Math.min(SEARCH_POSTER_MAX_CANDIDATES, candidateLimit);
+    const budget = new SearchEnrichmentCallBudget(input.getProviderTimeoutMs);
+    const idEnrichments = [];
+    const detailsEnrichments = [];
+    const posterEnrichments = [];
+    let skippedId = 0;
+    for (const [index, result] of candidates.entries()) {
+        const hasIds = hasExternalIds(result.item.ids);
+        const query = hasIds ? createSearchDetailsQuery(result, input.language) : undefined;
+        const reusableDetails = query
+            ? await input.loadReusableDetails(query, input.signal, budget.getRemainingWallTimeMs())
+            : undefined;
+        const planningResult = reusableDetails
+            ? applyReusableDetailsToResult(result, reusableDetails)
+            : result;
+        const idEnrichment = planIdEnrichment(input, planningResult, budget);
+        if (reusableDetails) {
+            detailsEnrichments.push({ ids: result.item.ids, details: reusableDetails });
+        }
+        if (needsSearchEnrichment(result.item) && hasIds) {
+            if (idEnrichment) {
+                idEnrichments.push({ ids: result.item.ids, outcome: idEnrichment.outcome });
+            }
+            else {
+                skippedId += 1;
+            }
+        }
+        if (index >= posterCandidateLimit || !query) {
+            continue;
+        }
+        posterEnrichments.push(loadSearchPoster({
+            result,
+            language: input.language,
+            excludedProviders: input.excludedProviders,
+            registry: input.registry,
+            mergeStrategy: input.mergeStrategy,
+            debug: input.debug,
+            signal: input.signal,
+            circuitBreaker: input.circuitBreaker,
+            concurrencyLimiter: input.concurrencyLimiter,
+            budget,
+            reusableDetails,
+            idEnrichment,
+        }));
+    }
+    const [resolvedIdEnrichments, resolvedPosterEnrichments] = await Promise.all([
+        Promise.all(idEnrichments.map(async (enrichment) => ({
+            ids: enrichment.ids,
+            outcome: await enrichment.outcome,
+        }))),
+        Promise.all(posterEnrichments),
+    ]);
+    return {
+        idEnrichments: resolvedIdEnrichments,
+        skippedId,
+        detailsEnrichments,
+        posterEnrichments: resolvedPosterEnrichments,
+        skippedPoster: resolvedPosterEnrichments.reduce((total, enrichment) => total + enrichment.skipped, 0),
+    };
+}
+// Enriches compact catalog hits only when a provider advertises a useful missing field.
+// Обогащает compact catalog hits, только если provider заявляет полезное отсутствующее поле.
+export function needsSearchEnrichment(item) {
+    return !item.ratings?.length || !item.description?.trim() || !item.poster;
+}
+function planIdEnrichment(input, result, budget) {
+    if (!needsSearchEnrichment(result.item) || !hasExternalIds(result.item.ids)) {
+        return undefined;
+    }
+    const existingProviders = new Set(result.sources.map((source) => source.provider));
+    const enrichmentType = result.item.type === "anime" ? undefined : result.item.type;
+    const providers = input.registry
+        .selectSearchProviders({ ids: result.item.ids, type: enrichmentType })
+        .filter((candidate) => supportsSearchEnrichment(candidate) && !existingProviders.has(candidate.name))
+        .map((candidate, index) => ({
+        candidate,
+        index,
+        score: getMissingFieldImprovementScore(candidate, result.item),
+    }))
+        .filter(({ score }) => score > 0)
+        .sort((left, right) => right.score - left.score || left.index - right.index)
+        .map(({ candidate }) => candidate);
+    for (const provider of providers) {
+        const timeoutMs = budget.reserve(provider.name);
+        if (timeoutMs === undefined) {
+            continue;
+        }
+        return {
+            provider,
+            outcome: callTimedProviderSearch(provider, {
+                ids: result.item.ids,
+                type: enrichmentType,
+                limit: 1,
+                language: input.language,
+            }, {
+                debug: input.debug,
+                language: input.language,
+                signal: input.signal,
+                timeoutMs,
+                circuitBreaker: input.circuitBreaker,
+                concurrencyLimiter: input.concurrencyLimiter,
+            }),
+        };
+    }
+    return undefined;
+}
+function getMissingFieldImprovementScore(provider, item) {
+    let score = 0;
+    if (!item.description?.trim()) {
+        score += 1;
+    }
+    if (!item.poster && supportsSearchEnrichmentFeature(provider, "posters")) {
+        score += 1;
+    }
+    if (!item.ratings?.length && supportsSearchEnrichmentFeature(provider, "ratings")) {
+        score += 1;
+    }
+    return score;
+}
+// Reuses compact fields from a matching cached/in-flight details operation.
+// Переиспользует compact-поля совпадающей cached/in-flight details operation.
+export function applySearchDetailsEnrichments(results, enrichments) {
+    return results.map((result) => {
+        const details = enrichments.find((enrichment) => hasSharedExternalId(result.item.ids, enrichment.ids))?.details;
+        return details ? applyReusableDetailsToResult(result, details) : result;
+    });
+}
+function applyReusableDetailsToResult(result, details) {
+    return {
+        ...result,
+        item: {
+            ...result.item,
+            description: result.item.description?.trim() ? result.item.description : details.description,
+            poster: details.poster ?? result.item.poster,
+            ratings: result.item.ratings?.length ? result.item.ratings : details.ratings,
+        },
+    };
+}
+//# sourceMappingURL=search-enrichment.js.map

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

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

package/dist/engine/search-identity-snapshot.d.ts

@@ -0,0 +1,15 @@
+import type { CacheSetOptions } from "../cache/index.js";
+import type { SearchIdentitySnapshotDebugMeta } from "../response/index.js";
+import type { MediaSearchResult } from "../search/index.js";
+export interface SearchIdentitySnapshot {
+    version: 2;
+    results: MediaSearchResult[];
+}
+export interface SearchIdentitySnapshotRecovery {
+    results: MediaSearchResult[];
+    debug?: SearchIdentitySnapshotDebugMeta;
+}
+export declare const SEARCH_IDENTITY_SNAPSHOT_CACHE_OPTIONS: CacheSetOptions;
+export declare function createSearchIdentitySnapshot(results: MediaSearchResult[]): SearchIdentitySnapshot | undefined;
+export declare function recoverSearchIdentitySnapshot(currentResults: MediaSearchResult[], snapshot: SearchIdentitySnapshot | undefined): SearchIdentitySnapshotRecovery;
+export declare function isUsableSearchIdentitySnapshot(value: unknown): value is SearchIdentitySnapshot;

package/dist/engine/search-identity-snapshot.js

@@ -0,0 +1,101 @@
+import { hasSharedStrongId, hasStrongIdConflict } from "../merge/identity.js";
+import { STRONG_ID_KEYS } from "../merge/internal.js";
+import { normalizeTitle, titleCandidates } from "../merge/title.js";
+const SEARCH_IDENTITY_SNAPSHOT_TTL_MS = 30 * 60_000;
+const SEARCH_IDENTITY_SNAPSHOT_MAX_RESULTS = 20;
+export const SEARCH_IDENTITY_SNAPSHOT_CACHE_OPTIONS = {
+    ttlMs: SEARCH_IDENTITY_SNAPSHOT_TTL_MS,
+    staleTtlMs: 0,
+};
+// Keeps only a bounded prior known-good candidate list, not response metadata or cache state.
+// Хранит только ограниченный список ранее подтвержденных кандидатов без response metadata.
+export function createSearchIdentitySnapshot(results) {
+    const topResult = results[0];
+    if (!topResult || !STRONG_ID_KEYS.some((key) => Boolean(topResult.item.ids?.[key]))) {
+        return undefined;
+    }
+    return {
+        version: 2,
+        results: structuredClone(results.slice(0, SEARCH_IDENTITY_SNAPSHOT_MAX_RESULTS)),
+    };
+}
+// Restores known identities and order without treating conflicting strong IDs as one candidate.
+// Восстанавливает identity и порядок, не объединяя кандидатов с конфликтующими strong ID.
+export function recoverSearchIdentitySnapshot(currentResults, snapshot) {
+    if (!isUsableSearchIdentitySnapshot(snapshot)) {
+        return { results: currentResults };
+    }
+    const recovered = [];
+    const usedCurrentIndexes = new Set();
+    let restored = 0;
+    let reordered = 0;
+    for (const snapshotResult of snapshot.results) {
+        const currentIndex = currentResults.findIndex((current, index) => !usedCurrentIndexes.has(index) && isSameSearchIdentity(current.item, snapshotResult.item));
+        if (currentIndex !== -1) {
+            usedCurrentIndexes.add(currentIndex);
+            recovered.push(currentResults[currentIndex]);
+            if (currentIndex !== recovered.length - 1) {
+                reordered += 1;
+            }
+            continue;
+        }
+        if (currentResults.some((current) => hasConflictingSearchIdentity(current.item, snapshotResult.item))) {
+            continue;
+        }
+        recovered.push(structuredClone(snapshotResult));
+        restored += 1;
+    }
+    currentResults.forEach((result, index) => {
+        if (!usedCurrentIndexes.has(index)) {
+            recovered.push(result);
+        }
+    });
+    if (restored === 0 && reordered === 0) {
+        return { results: currentResults };
+    }
+    return {
+        results: recovered,
+        debug: {
+            applied: true,
+            restored,
+            reordered,
+        },
+    };
+}
+export function isUsableSearchIdentitySnapshot(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const snapshot = value;
+    return snapshot.version === 2 && Array.isArray(snapshot.results) && snapshot.results.length > 0;
+}
+function isSameSearchIdentity(left, right) {
+    if (left.type !== right.type || hasStrongIdConflict(left.ids, right.ids)) {
+        return false;
+    }
+    if (hasSharedStrongId(left.ids, right.ids)) {
+        return true;
+    }
+    if (left.id === right.id &&
+        hasSharedNormalizedTitle(left, right) &&
+        (left.year === undefined || right.year === undefined || left.year === right.year)) {
+        return true;
+    }
+    return hasSameTitleYearIdentity(left, right);
+}
+function hasConflictingSearchIdentity(left, right) {
+    return (left.type === right.type &&
+        hasStrongIdConflict(left.ids, right.ids) &&
+        hasSameTitleYearIdentity(left, right));
+}
+function hasSameTitleYearIdentity(left, right) {
+    if (left.year === undefined || left.year !== right.year) {
+        return false;
+    }
+    return hasSharedNormalizedTitle(left, right);
+}
+function hasSharedNormalizedTitle(left, right) {
+    const leftTitles = new Set(titleCandidates(left).map(normalizeTitle).filter(Boolean));
+    return titleCandidates(right).some((title) => leftTitles.has(normalizeTitle(title)));
+}
+//# sourceMappingURL=search-identity-snapshot.js.map

package/dist/engine/search-identity-snapshot.js.map

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

package/dist/engine/search-outcomes.d.ts

@@ -0,0 +1,32 @@
+import type { ProviderSearchResult } from "../providers/index.js";
+import type { EngineWarning, ProviderFailure, ProviderTimingMeta, SearchEnrichmentDebugMeta } from "../response/index.js";
+import type { ProviderDetailsCallOutcome, ProviderSearchCallOutcome } from "./provider-calls.js";
+type MandatorySearchPhase = "primary" | "retry" | "fallback" | "provider_fallback";
+export declare class SearchOutcomeAccumulator {
+    readonly successful: string[];
+    readonly failed: ProviderFailure[];
+    readonly results: ProviderSearchResult[];
+    readonly timings: ProviderTimingMeta[];
+    readonly warnings: EngineWarning[];
+    private readonly retryableMandatoryFailures;
+    private readonly enrichment;
+    constructor(input: {
+        successful: string[];
+        failed: ProviderFailure[];
+        results: ProviderSearchResult[];
+        timings: ProviderTimingMeta[];
+        warnings: EngineWarning[];
+    });
+    appendMandatory(outcomes: ProviderSearchCallOutcome[], phase: MandatorySearchPhase, options?: {
+        deduplicateResults?: boolean;
+    }): void;
+    appendIdEnrichment(outcomes: ProviderSearchCallOutcome[], skipped: number): void;
+    observePosterEnrichment(outcomes: ProviderDetailsCallOutcome[], skipped: number): void;
+    appendEnrichmentWarnings(): void;
+    hasRetryableMandatoryFailure(): boolean;
+    getEnrichmentDebugMeta(): SearchEnrichmentDebugMeta;
+    private observeEnrichment;
+    private upsertFailure;
+    private removeFailure;
+}
+export {};

package/dist/engine/search-outcomes.js

@@ -0,0 +1,118 @@
+import { appendUniqueSearchResults } from "./query.js";
+const ID_ENRICHMENT_WARNING = "SEARCH_ID_ENRICHMENT_FAILED";
+const POSTER_ENRICHMENT_WARNING = "SEARCH_POSTER_ENRICHMENT_FAILED";
+// Owns phase-aware search execution state and keeps public provider summaries deduplicated.
+// Хранит phase-aware состояние search и не допускает дублей в публичной сводке провайдеров.
+export class SearchOutcomeAccumulator {
+    successful;
+    failed;
+    results;
+    timings;
+    warnings;
+    retryableMandatoryFailures = new Set();
+    enrichment = {
+        id: createCounters(),
+        poster: createCounters(),
+    };
+    constructor(input) {
+        this.successful = input.successful;
+        this.failed = input.failed;
+        this.results = input.results;
+        this.timings = input.timings;
+        this.warnings = input.warnings;
+    }
+    // Adds mandatory provider work and applies retry recovery to the public failure summary.
+    // Добавляет обязательную provider-работу и учитывает успешное retry-восстановление.
+    appendMandatory(outcomes, phase, options = {}) {
+        for (const outcome of outcomes) {
+            this.timings.push(withPhase(outcome.timing, phase));
+            if (outcome.failure) {
+                this.upsertFailure(outcome.failure, phase);
+                if (outcome.failure.retryable) {
+                    this.retryableMandatoryFailures.add(outcome.provider);
+                }
+                continue;
+            }
+            if (phase === "retry") {
+                this.removeFailure(outcome.provider);
+                this.retryableMandatoryFailures.delete(outcome.provider);
+            }
+            if (!this.successful.includes(outcome.provider)) {
+                this.successful.push(outcome.provider);
+            }
+            if (options.deduplicateResults) {
+                appendUniqueSearchResults(this.results, outcome.results);
+            }
+            else {
+                this.results.push(...outcome.results);
+            }
+        }
+    }
+    // Records optional ID enrichment without adding its candidates to mandatory discovery state.
+    // Учитывает optional ID enrichment без добавления кандидатов в mandatory discovery state.
+    appendIdEnrichment(outcomes, skipped) {
+        this.observeEnrichment(outcomes, "id_enrichment", this.enrichment.id, skipped);
+    }
+    // Records optional poster-enrichment calls without promoting them to provider failures.
+    // Учитывает optional poster enrichment без добавления его ошибок в provider failures.
+    observePosterEnrichment(outcomes, skipped) {
+        this.observeEnrichment(outcomes, "poster_enrichment", this.enrichment.poster, skipped);
+    }
+    // Adds at most one aggregate warning per optional enrichment phase.
+    // Добавляет не более одного агрегированного warning на каждую optional enrichment-фазу.
+    appendEnrichmentWarnings() {
+        appendEnrichmentWarning(this.warnings, ID_ENRICHMENT_WARNING, "ID", this.enrichment.id.failed);
+        appendEnrichmentWarning(this.warnings, POSTER_ENRICHMENT_WARNING, "poster", this.enrichment.poster.failed);
+    }
+    hasRetryableMandatoryFailure() {
+        return this.retryableMandatoryFailures.size > 0;
+    }
+    getEnrichmentDebugMeta() {
+        return structuredClone(this.enrichment);
+    }
+    observeEnrichment(outcomes, phase, counters, skipped) {
+        counters.skipped += skipped;
+        for (const outcome of outcomes) {
+            counters.attempted += 1;
+            this.timings.push(withPhase(outcome.timing, phase));
+            if (outcome.failure) {
+                counters.failed += 1;
+            }
+            else {
+                counters.succeeded += 1;
+            }
+        }
+    }
+    upsertFailure(failure, phase) {
+        const phaseFailure = { ...failure, phase };
+        const index = this.failed.findIndex((existing) => existing.provider === failure.provider);
+        if (index === -1) {
+            this.failed.push(phaseFailure);
+        }
+        else {
+            this.failed[index] = phaseFailure;
+        }
+    }
+    removeFailure(provider) {
+        const index = this.failed.findIndex((failure) => failure.provider === provider);
+        if (index !== -1) {
+            this.failed.splice(index, 1);
+        }
+    }
+}
+function createCounters() {
+    return { attempted: 0, skipped: 0, succeeded: 0, failed: 0 };
+}
+function withPhase(timing, phase) {
+    return { ...timing, phase };
+}
+function appendEnrichmentWarning(warnings, code, label, failures) {
+    if (failures === 0) {
+        return;
+    }
+    warnings.push({
+        code,
+        message: `Optional search ${label} enrichment failed for ${failures} provider ${failures === 1 ? "call" : "calls"}.`,
+    });
+}
+//# sourceMappingURL=search-outcomes.js.map

package/dist/engine/search-outcomes.js.map

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

package/dist/engine/search-poster-enrichment.d.ts

@@ -0,0 +1,31 @@
+import type { ExternalIds, Image, MediaDetails } from "../media/index.js";
+import type { MergeStrategy } from "../merge/index.js";
+import type { ProviderRegistry } from "../providers/index.js";
+import type { MediaSearchResult } from "../search/index.js";
+import type { ProviderCircuitBreaker } from "./circuit-breaker.js";
+import type { ProviderConcurrencyLimiter } from "./concurrency-limiter.js";
+import { type ProviderDetailsCallOutcome } from "./provider-calls.js";
+import { type PlannedIdEnrichment, type SearchEnrichmentCallBudget } from "./search-enrichment-shared.js";
+export interface SearchPosterEnrichment {
+    ids: ExternalIds | undefined;
+    poster: Image | undefined;
+    outcomes: ProviderDetailsCallOutcome[];
+    skipped: number;
+}
+interface SearchPosterLookupInput {
+    result: MediaSearchResult;
+    language: string | undefined;
+    excludedProviders: ReadonlySet<string>;
+    registry: ProviderRegistry;
+    mergeStrategy: MergeStrategy;
+    debug: boolean;
+    signal?: AbortSignal;
+    circuitBreaker?: ProviderCircuitBreaker | undefined;
+    concurrencyLimiter?: ProviderConcurrencyLimiter | undefined;
+    budget: SearchEnrichmentCallBudget;
+    reusableDetails?: MediaDetails;
+    idEnrichment?: PlannedIdEnrichment;
+}
+export declare function loadSearchPoster(input: SearchPosterLookupInput): Promise<SearchPosterEnrichment>;
+export declare function applySearchPosterEnrichments(results: MediaSearchResult[], enrichments: SearchPosterEnrichment[]): MediaSearchResult[];
+export {};