@media-engine/providers 0.1.0 → 1.0.0

package/dist/wikidata/candidates.js

@@ -0,0 +1,67 @@
+import { normalizeProviderSearchText as normalizeSearchText } from "../shared/mapping.js";
+// Keeps only title-relevant search summaries and drops obvious non-media hits before the
+// selected-property entity request. Unknown summaries remain eligible to avoid locale-specific
+// false negatives.
+// Оставляет релевантные title summaries и отсекает явный не-media шум до entity-запроса.
+export function selectWikidataEntityIds(entries, query, entityLimit) {
+    const title = query.title?.trim();
+    const classified = entries
+        .filter((entry) => {
+        if (!normalizeWikidataEntityId(entry.id)) {
+            return false;
+        }
+        return title
+            ? [entry.match?.text, entry.label].some((candidate) => candidate && isRelevantWikidataTitleMatch(candidate, title))
+            : true;
+    })
+        .map((entry) => ({ entry, relevance: classifySummary(entry.description, query.type) }))
+        .filter(({ relevance }) => relevance !== "irrelevant");
+    return [
+        ...classified.filter(({ relevance }) => relevance === "preferred"),
+        ...classified.filter(({ relevance }) => relevance === "unknown"),
+    ]
+        .slice(0, entityLimit)
+        .map(({ entry }) => normalizeWikidataEntityId(entry.id))
+        .filter((id) => id !== undefined);
+}
+const CHILD_OR_COLLECTION_SUMMARY_PATTERN = /\b(?:episode|season|film series|media franchise)\b|эпизод|сезон|медиафраншиз|кинофраншиз/iu;
+const NON_MEDIA_SUMMARY_PATTERN = /\b(?:video|computer|board) game\b|\b(?:studio |live |soundtrack )?album\b|\b(?:song|single|novel|book|surname|family name|given name|city|town|village|municipality|landform|fictional character|company|organization|university|school|asteroid|taxon|band|mud|virtual world)\b|видеоигр|компьютерн\S* игр|настольн\S* игр|альбом|песн|роман|книг|фамили|город|насел[её]нн|франшиз|персонаж|саундтрек|компани|организац|университет|школ/iu;
+const MOVIE_SUMMARY_PATTERN = /\b(?:film|movie|motion picture|telefilm)\b|фильм|кинофильм|мультфильм/iu;
+const SERIES_SUMMARY_PATTERN = /\b(?:television|tv|web|anime) series\b|\bminiseries\b|телесериал|мини-сериал|аниме-сериал/iu;
+function classifySummary(description, type) {
+    if (!description) {
+        return "unknown";
+    }
+    if (CHILD_OR_COLLECTION_SUMMARY_PATTERN.test(description)) {
+        return "irrelevant";
+    }
+    const describesMovie = MOVIE_SUMMARY_PATTERN.test(description);
+    const describesSeries = SERIES_SUMMARY_PATTERN.test(description);
+    if (type === "movie" && describesMovie) {
+        return "preferred";
+    }
+    if (type === "series" && describesSeries) {
+        return "preferred";
+    }
+    if (!type && (describesMovie || describesSeries)) {
+        return "preferred";
+    }
+    if (type === "movie" && describesSeries) {
+        return "irrelevant";
+    }
+    return (type === "series" && describesMovie) || NON_MEDIA_SUMMARY_PATTERN.test(description)
+        ? "irrelevant"
+        : "unknown";
+}
+export function isRelevantWikidataTitleMatch(title, queryTitle) {
+    const normalizedTitle = normalizeSearchText(title);
+    const normalizedQuery = normalizeSearchText(queryTitle);
+    return normalizedTitle.includes(normalizedQuery) || normalizedQuery.includes(normalizedTitle);
+}
+// Accepts only canonical Wikidata item IDs before using upstream values in queries/cache keys.
+// Принимает только canonical Wikidata item IDs до использования upstream values в запросах.
+export function normalizeWikidataEntityId(value) {
+    const normalized = value?.trim().toUpperCase();
+    return normalized && /^Q[1-9]\d*$/.test(normalized) ? normalized : undefined;
+}
+//# sourceMappingURL=candidates.js.map

package/dist/wikidata/candidates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.js","sourceRoot":"","sources":["../../src/wikidata/candidates.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAW1F,yFAAyF;AACzF,+FAA+F;AAC/F,mBAAmB;AACnB,yFAAyF;AACzF,MAAM,UAAU,uBAAuB,CACrC,OAA8B,EAC9B,KAA0B,EAC1B,WAAmB;IAEnB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,OAAO;SACvB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAChB,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,KAAK;YACV,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CACnC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,IAAI,4BAA4B,CAAC,SAAS,EAAE,KAAK,CAAC,CAC3E;YACH,CAAC,CAAC,IAAI,CAAC;IACX,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SACtF,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC;IAEzD,OAAO;QACL,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,WAAW,CAAC;QAClE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC;KACjE;SACE,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;SACrB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,yBAAyB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SACvD,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,mCAAmC,GACvC,4FAA4F,CAAC;AAC/F,MAAM,yBAAyB,GAC7B,6aAA6a,CAAC;AAChb,MAAM,qBAAqB,GACzB,yEAAyE,CAAC;AAC5E,MAAM,sBAAsB,GAC1B,6FAA6F,CAAC;AAIhG,SAAS,eAAe,CACtB,WAA+B,EAC/B,IAA2B;IAE3B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,mCAAmC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1D,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/D,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEjE,IAAI,IAAI,KAAK,OAAO,IAAI,cAAc,EAAE,CAAC;QACvC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,IAAI,eAAe,EAAE,CAAC;QACzC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,CAAC,IAAI,IAAI,CAAC,cAAc,IAAI,eAAe,CAAC,EAAE,CAAC;QACjD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,IAAI,KAAK,OAAO,IAAI,eAAe,EAAE,CAAC;QACxC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,WAAW,CAAC;QACzF,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAa,EAAE,UAAkB;IAC5E,MAAM,eAAe,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,eAAe,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAExD,OAAO,eAAe,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAChG,CAAC;AAED,+FAA+F;AAC/F,4FAA4F;AAC5F,MAAM,UAAU,yBAAyB,CAAC,KAAyB;IACjE,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE/C,OAAO,UAAU,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC"}

package/dist/wikidata/client.d.ts

@@ -0,0 +1,40 @@
+import { type ProviderContext, type ProviderSearchQuery } from "@media-engine/core";
+import { ProviderRateLimitGate, type ProviderFetch } from "../shared/index.js";
+import { WikidataCache } from "./cache.js";
+export interface WikidataClientConfig {
+    baseUrl: string;
+    sparqlUrl: string;
+    language: string;
+    userAgent: string;
+    fetch?: ProviderFetch;
+    rateLimitGate: ProviderRateLimitGate;
+    searchLimit: number;
+    entityLimit: number;
+    cache: WikidataCache<WikidataEntity>;
+}
+export interface WikidataEntity {
+    id: string;
+    labels?: Record<string, WikidataTextValue>;
+    descriptions?: Record<string, WikidataTextValue>;
+    claims?: Record<string, WikidataClaim[]>;
+}
+interface WikidataTextValue {
+    value?: string;
+}
+interface WikidataClaim {
+    mainsnak?: {
+        datavalue?: {
+            value?: WikidataClaimValue;
+        };
+    };
+}
+export type WikidataClaimValue = string | {
+    id?: string;
+    time?: string;
+    amount?: string;
+    text?: string;
+};
+export declare function searchWikidataEntities(config: WikidataClientConfig, query: ProviderSearchQuery, context: ProviderContext): Promise<WikidataEntity[]>;
+export declare function getWikidataEntityByImdbId(config: WikidataClientConfig, imdbId: string, context: ProviderContext): Promise<WikidataEntity | undefined>;
+export declare function normalizeWikidataLanguage(language: string): string;
+export {};

package/dist/wikidata/client.js

@@ -0,0 +1,224 @@
+import { ProviderError } from "@media-engine/core";
+import { fetchJson } from "../shared/index.js";
+import { normalizeWikidataEntityId, selectWikidataEntityIds, } from "./candidates.js";
+const PROVIDER_NAME = "wikidata";
+const DEFAULT_LANGUAGE = "en";
+const MAX_RESPONSE_BYTES = 256 * 1_024;
+export async function searchWikidataEntities(config, query, context) {
+    const entityIds = await searchEntityIds(config, query, context);
+    return getEntities(config, entityIds, context);
+}
+export async function getWikidataEntityByImdbId(config, imdbId, context) {
+    const cachedEntityId = config.cache.getImdbEntityId(imdbId);
+    if (cachedEntityId === null) {
+        return undefined;
+    }
+    if (cachedEntityId !== undefined) {
+        return (await getEntities(config, [cachedEntityId], context))[0];
+    }
+    const languages = getRequestedLanguages(context.language ?? config.language);
+    const response = await requestSparql(config, createSelectedPropertyQuery(`?item wdt:P345 "${escapeSparqlString(imdbId)}".`, languages, "LIMIT 1"), context);
+    const entity = parseSparqlEntities(response, languages)[0];
+    config.cache.setImdbEntityId(imdbId, entity?.id ?? null);
+    if (entity) {
+        config.cache.setEntity(createLanguageKey(languages), entity.id, entity);
+    }
+    return entity;
+}
+async function searchEntityIds(config, query, context) {
+    const url = new URL(`${config.baseUrl}/w/api.php`);
+    const language = normalizeWikidataLanguage(query.language ?? context.language ?? config.language);
+    url.searchParams.set("action", "wbsearchentities");
+    url.searchParams.set("format", "json");
+    url.searchParams.set("type", "item");
+    url.searchParams.set("language", language);
+    url.searchParams.set("uselang", language);
+    url.searchParams.set("search", query.title ?? "");
+    url.searchParams.set("limit", String(config.searchLimit));
+    const response = await requestJson(config, url, context);
+    if (!Array.isArray(response.search)) {
+        throw createInvalidResponseError("search entries");
+    }
+    return selectWikidataEntityIds(response.search, query, config.entityLimit);
+}
+async function getEntities(config, entityIds, context) {
+    if (!entityIds.length) {
+        return [];
+    }
+    const languages = getRequestedLanguages(context.language ?? config.language);
+    const languageKey = createLanguageKey(languages);
+    const entitiesById = new Map();
+    const missingIds = [];
+    for (const entityId of entityIds) {
+        const cached = config.cache.getEntity(languageKey, entityId);
+        if (cached === undefined) {
+            missingIds.push(entityId);
+        }
+        else if (cached !== null) {
+            entitiesById.set(entityId, cached);
+        }
+    }
+    if (missingIds.length) {
+        const values = missingIds.map((entityId) => `wd:${entityId}`).join(" ");
+        const response = await requestSparql(config, createSelectedPropertyQuery(`VALUES ?item { ${values} }`, languages), context);
+        const fetchedEntities = parseSparqlEntities(response, languages);
+        const expectedIds = new Set(missingIds);
+        if (fetchedEntities.some((entity) => !expectedIds.has(entity.id))) {
+            throw createInvalidResponseError("requested entity IDs");
+        }
+        const fetchedById = new Map(fetchedEntities.map((entity) => [entity.id, entity]));
+        for (const entityId of missingIds) {
+            const entity = fetchedById.get(entityId) ?? null;
+            config.cache.setEntity(languageKey, entityId, entity);
+            if (entity) {
+                const imdbId = getEntityImdbId(entity);
+                entitiesById.set(entityId, entity);
+                if (imdbId) {
+                    config.cache.setImdbEntityId(imdbId, entityId);
+                }
+            }
+        }
+    }
+    return entityIds.flatMap((entityId) => {
+        const entity = entitiesById.get(entityId);
+        return entity ? [entity] : [];
+    });
+}
+function createSelectedPropertyQuery(selector, languages, suffix = "") {
+    const requestedLanguage = languages[0] ?? DEFAULT_LANGUAGE;
+    return `SELECT ?item
+    (GROUP_CONCAT(DISTINCT STR(?instanceValue); separator="|") AS ?instances)
+    (SAMPLE(?imdbValue) AS ?imdb)
+    (MIN(?releaseValue) AS ?releaseDate)
+    (SAMPLE(?imageValue) AS ?image)
+    (SAMPLE(?originalValue) AS ?originalTitle)
+    (SAMPLE(?requestedLabelValue) AS ?requestedLabel)
+    (SAMPLE(?englishLabelValue) AS ?englishLabel)
+    (SAMPLE(?requestedDescriptionValue) AS ?requestedDescription)
+    (SAMPLE(?englishDescriptionValue) AS ?englishDescription)
+  WHERE {
+    ${selector}
+    OPTIONAL { ?item wdt:P31 ?instanceValue. }
+    OPTIONAL { ?item wdt:P345 ?imdbValue. }
+    OPTIONAL { ?item wdt:P577 ?releaseValue. }
+    OPTIONAL { ?item wdt:P18 ?imageValue. }
+    OPTIONAL { ?item wdt:P1476 ?originalValue. }
+    OPTIONAL {
+      ?item rdfs:label ?requestedLabelValue.
+      FILTER(LANG(?requestedLabelValue) = "${requestedLanguage}")
+    }
+    OPTIONAL {
+      ?item rdfs:label ?englishLabelValue.
+      FILTER(LANG(?englishLabelValue) = "en")
+    }
+    OPTIONAL {
+      ?item schema:description ?requestedDescriptionValue.
+      FILTER(LANG(?requestedDescriptionValue) = "${requestedLanguage}")
+    }
+    OPTIONAL {
+      ?item schema:description ?englishDescriptionValue.
+      FILTER(LANG(?englishDescriptionValue) = "en")
+    }
+  }
+  GROUP BY ?item
+  ${suffix}`;
+}
+function mapSparqlBinding(binding, languages) {
+    const entityId = normalizeWikidataEntityId(binding?.item?.value?.split("/").at(-1));
+    if (!binding || !entityId) {
+        return undefined;
+    }
+    const requestedLanguage = languages[0] ?? DEFAULT_LANGUAGE;
+    const labels = createLocalizedValues(requestedLanguage, binding.requestedLabel?.value, binding.englishLabel?.value);
+    const descriptions = createLocalizedValues(requestedLanguage, binding.requestedDescription?.value, binding.englishDescription?.value);
+    const claims = {};
+    setClaims(claims, "P31", (binding.instances?.value ?? "")
+        .split("|")
+        .map((value) => normalizeWikidataEntityId(value.split("/").at(-1)))
+        .filter((value) => value !== undefined)
+        .map((id) => ({ id })));
+    setClaims(claims, "P345", compactValues(binding.imdb?.value));
+    setClaims(claims, "P577", compactValues(binding.releaseDate?.value).map((time) => ({ time })));
+    setClaims(claims, "P18", compactValues(binding.image?.value));
+    setClaims(claims, "P1476", compactValues(binding.originalTitle?.value).map((text) => ({ text })));
+    return { id: entityId, labels, descriptions, claims };
+}
+function parseSparqlEntities(response, languages) {
+    const bindings = response.results?.bindings;
+    if (!Array.isArray(bindings)) {
+        throw createInvalidResponseError("SPARQL bindings");
+    }
+    const entities = bindings.map((binding) => mapSparqlBinding(binding, languages));
+    if (entities.some((entity) => entity === undefined)) {
+        throw createInvalidResponseError("canonical entity IDs");
+    }
+    return entities;
+}
+function createLocalizedValues(requestedLanguage, requestedValue, englishValue) {
+    const values = {};
+    if (requestedValue) {
+        values[requestedLanguage] = { value: requestedValue };
+    }
+    if (englishValue) {
+        values.en = { value: englishValue };
+    }
+    return Object.keys(values).length ? values : undefined;
+}
+function setClaims(claims, property, values) {
+    if (values.length) {
+        claims[property] = values.map((value) => ({
+            mainsnak: { datavalue: { value } },
+        }));
+    }
+}
+function compactValues(value) {
+    return value ? [value] : [];
+}
+function getEntityImdbId(entity) {
+    const value = entity.claims?.P345?.[0]?.mainsnak?.datavalue?.value;
+    return typeof value === "string" ? value : undefined;
+}
+function requestSparql(config, query, context) {
+    const url = new URL(config.sparqlUrl);
+    url.searchParams.set("format", "json");
+    url.searchParams.set("query", query);
+    return requestJson(config, url, context);
+}
+function requestJson(config, url, context) {
+    return fetchJson({
+        provider: PROVIDER_NAME,
+        url,
+        context,
+        fetch: config.fetch,
+        maxResponseBytes: MAX_RESPONSE_BYTES,
+        rateLimitGate: config.rateLimitGate,
+        init: {
+            headers: {
+                accept: "application/json",
+                "user-agent": config.userAgent,
+            },
+        },
+    });
+}
+export function normalizeWikidataLanguage(language) {
+    const primary = language.split("-")[0]?.trim().toLocaleLowerCase();
+    return primary && /^[a-z]{2,12}$/.test(primary) ? primary : DEFAULT_LANGUAGE;
+}
+function getRequestedLanguages(language) {
+    return [...new Set([normalizeWikidataLanguage(language), DEFAULT_LANGUAGE])];
+}
+function createLanguageKey(languages) {
+    return languages.join("|");
+}
+function escapeSparqlString(value) {
+    return value.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
+}
+function createInvalidResponseError(field) {
+    return new ProviderError({
+        provider: PROVIDER_NAME,
+        code: "PROVIDER_INVALID_RESPONSE",
+        message: `Provider "${PROVIDER_NAME}" returned invalid ${field}.`,
+        retryable: false,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/wikidata/client.js.map

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

package/dist/wikidata/index.d.ts

@@ -8,5 +8,8 @@ export interface WikidataProviderOptions {
     fetch?: ProviderFetch;
     version?: string;
     searchLimit?: number;
+    entityLimit?: number;
+    cacheTtlMs?: number;
+    cacheMaxEntries?: number;
 }
 export declare function wikidataProvider(options?: WikidataProviderOptions): MediaProvider;

package/dist/wikidata/index.js

@@ -1,10 +1,18 @@
-import { fetchJson } from "../shared/index.js";
+import { normalizeProviderOutputUrl, ProviderRateLimitGate, } from "../shared/index.js";
+import { createProviderImage } from "../shared/mapping.js";
+import { resolveBoundedIntegerOption } from "../shared/options.js";
+import { MEDIA_ENGINE_DEFAULT_USER_AGENT } from "../package-version.js";
+import { WikidataCache } from "./cache.js";
+import { isRelevantWikidataTitleMatch } from "./candidates.js";
+import { getWikidataEntityByImdbId, normalizeWikidataLanguage, searchWikidataEntities, } from "./client.js";
 const PROVIDER_NAME = "wikidata";
 const DEFAULT_BASE_URL = "https://www.wikidata.org";
 const DEFAULT_SPARQL_URL = "https://query.wikidata.org/sparql";
 const DEFAULT_LANGUAGE = "en";
 const DEFAULT_SEARCH_LIMIT = 8;
-const DEFAULT_USER_AGENT = "MediaEngine/0.0.0 (https://github.com/Yaneart/media-engine)";
+const DEFAULT_ENTITY_LIMIT = 3;
+const DEFAULT_CACHE_TTL_MS = 6 * 60 * 60 * 1_000;
+const DEFAULT_CACHE_MAX_ENTRIES = 256;
 const MOVIE_INSTANCE_IDS = new Set(["Q11424", "Q506240"]);
 const SERIES_INSTANCE_IDS = new Set(["Q5398426", "Q1259759", "Q15416"]);
 // Creates a Wikidata metadata provider for basic movie and series lookup.
@@ -15,11 +23,14 @@ export function wikidataProvider(options = {}) {
         name: PROVIDER_NAME,
         version: options.version,
         kind: "metadata",
+        searchPosterMatchesDetails: true,
         capabilities: {
             mediaTypes: ["movie", "series"],
+            searchEnrichment: false,
             search: {
                 byTitle: true,
                 byExternalIds: ["imdb"],
+                titleDiscovery: "fallback",
             },
             details: {
                 byExternalIds: ["imdb"],
@@ -37,13 +48,18 @@ export function wikidataProvider(options = {}) {
 // Builds provider config with conservative defaults for public Wikimedia APIs.
 // Собирает конфигурацию с консервативными defaults для публичных Wikimedia API.
 function createWikidataConfig(options) {
+    const cacheTtlMs = resolveBoundedIntegerOption(options.cacheTtlMs, DEFAULT_CACHE_TTL_MS, "Wikidata cacheTtlMs", 0, 7 * 24 * 60 * 60 * 1_000);
+    const cacheMaxEntries = resolveBoundedIntegerOption(options.cacheMaxEntries, DEFAULT_CACHE_MAX_ENTRIES, "Wikidata cacheMaxEntries", 2, 2_048);
     return {
         baseUrl: trimTrailingSlash(options.baseUrl ?? DEFAULT_BASE_URL),
         sparqlUrl: options.sparqlUrl ?? DEFAULT_SPARQL_URL,
-        language: normalizeLanguage(options.language ?? DEFAULT_LANGUAGE),
-        userAgent: options.userAgent ?? DEFAULT_USER_AGENT,
+        language: normalizeWikidataLanguage(options.language ?? DEFAULT_LANGUAGE),
+        userAgent: options.userAgent ?? MEDIA_ENGINE_DEFAULT_USER_AGENT,
         fetch: options.fetch,
-        searchLimit: options.searchLimit ?? DEFAULT_SEARCH_LIMIT,
+        rateLimitGate: new ProviderRateLimitGate(),
+        searchLimit: resolveBoundedIntegerOption(options.searchLimit, DEFAULT_SEARCH_LIMIT, "Wikidata searchLimit", 1, 50),
+        entityLimit: resolveBoundedIntegerOption(options.entityLimit, DEFAULT_ENTITY_LIMIT, "Wikidata entityLimit", 1, 10),
+        cache: new WikidataCache({ maxEntries: cacheMaxEntries, ttlMs: cacheTtlMs }),
     };
 }
 // Runs title or IMDb ID search through Wikidata without requiring credentials.
@@ -59,8 +75,7 @@ async function searchWikidata(config, query, context) {
     if (!query.title?.trim()) {
         return [];
     }
-    const entityIds = await searchEntityIds(config, query, context);
-    const entities = await getEntities(config, entityIds, context);
+    const entities = await searchWikidataEntities(config, query, context);
     return entities
         .map((entity) => mapEntityToItem(config, entity, query, context))
         .filter((item) => item !== undefined)
@@ -86,58 +101,12 @@ async function getWikidataDetails(config, query, context) {
 // Resolves one Wikidata entity through an exact IMDb ID SPARQL lookup.
 // Находит одну Wikidata entity через точный SPARQL lookup по IMDb ID.
 async function getDetailsByImdbId(config, imdbId, type, context) {
-    const entityId = await findEntityIdByImdbId(config, imdbId, context);
-    if (!entityId) {
-        return null;
-    }
-    const [entity] = await getEntities(config, [entityId], context);
+    const entity = await getWikidataEntityByImdbId(config, imdbId, context);
     const item = entity
         ? mapEntityToItem(config, entity, { ids: { imdb: imdbId }, type }, context)
         : undefined;
     return item ? itemToDetails(item) : null;
 }
-// Searches Wikidata item IDs using the public Action API search endpoint.
-// Ищет Wikidata item IDs через публичный search endpoint Action API.
-async function searchEntityIds(config, query, context) {
-    const url = new URL(`${config.baseUrl}/w/api.php`);
-    const language = normalizeLanguage(query.language ?? context.language ?? config.language);
-    url.searchParams.set("action", "wbsearchentities");
-    url.searchParams.set("format", "json");
-    url.searchParams.set("type", "item");
-    url.searchParams.set("language", language);
-    url.searchParams.set("uselang", language);
-    url.searchParams.set("search", query.title ?? "");
-    url.searchParams.set("limit", String(config.searchLimit));
-    const response = await requestJson(config, url, context);
-    return (response.search ?? [])
-        .map((result) => result.id)
-        .filter((id) => Boolean(id));
-}
-// Loads full Wikidata entity JSON for candidate IDs.
-// Загружает полный JSON Wikidata entity для candidate IDs.
-async function getEntities(config, entityIds, context) {
-    if (!entityIds.length) {
-        return [];
-    }
-    const url = new URL(`${config.baseUrl}/w/api.php`);
-    url.searchParams.set("action", "wbgetentities");
-    url.searchParams.set("format", "json");
-    url.searchParams.set("ids", entityIds.join("|"));
-    url.searchParams.set("props", "labels|descriptions|claims");
-    const response = await requestJson(config, url, context);
-    return Object.values(response.entities ?? {}).filter(isKnownEntity);
-}
-// Finds one Wikidata item ID by exact IMDb title ID.
-// Находит один Wikidata item ID по точному IMDb title ID.
-async function findEntityIdByImdbId(config, imdbId, context) {
-    const url = new URL(config.sparqlUrl);
-    const query = `SELECT ?item WHERE { ?item wdt:P345 "${escapeSparqlString(imdbId)}". } LIMIT 1`;
-    url.searchParams.set("format", "json");
-    url.searchParams.set("query", query);
-    const response = await requestJson(config, url, context);
-    const itemUrl = response.results?.bindings?.[0]?.item?.value;
-    return itemUrl?.split("/").at(-1);
-}
 // Maps a Wikidata entity into the normalized compact media model.
 // Преобразует Wikidata entity в нормализованную compact media model.
 function mapEntityToItem(config, entity, query, context) {
@@ -146,7 +115,7 @@ function mapEntityToItem(config, entity, query, context) {
         return undefined;
     }
     const title = getLabel(entity, context.language ?? config.language);
-    if (!title || (query.title && !isRelevantTitleMatch(title, query.title))) {
+    if (!title || (query.title && !isRelevantWikidataTitleMatch(title, query.title))) {
         return undefined;
     }
     const releaseDate = getTimeClaim(entity, "P577");
@@ -219,7 +188,7 @@ function createProviderSource(ids) {
     return {
         provider: PROVIDER_NAME,
         ids,
-        url: imdbId ? `https://www.imdb.com/title/${imdbId}/` : undefined,
+        url: normalizeProviderOutputUrl(imdbId ? `https://www.imdb.com/title/${imdbId}/` : undefined),
     };
 }
 // Creates normalized external IDs from Wikidata claims.
@@ -245,12 +214,13 @@ function getMediaType(entity) {
 // Reads localized entity label with English fallback.
 // Читает локализованный label entity с fallback на English.
 function getLabel(entity, language) {
-    return entity.labels?.[normalizeLanguage(language)]?.value ?? entity.labels?.en?.value;
+    return entity.labels?.[normalizeWikidataLanguage(language)]?.value ?? entity.labels?.en?.value;
 }
 // Reads localized entity description with English fallback.
 // Читает локализованное description entity с fallback на English.
 function getDescription(entity, language) {
-    return (entity.descriptions?.[normalizeLanguage(language)]?.value ?? entity.descriptions?.en?.value);
+    return (entity.descriptions?.[normalizeWikidataLanguage(language)]?.value ??
+        entity.descriptions?.en?.value);
 }
 // Reads one string-valued claim.
 // Читает один claim со строковым значением.
@@ -290,49 +260,12 @@ function getClaimValues(entity, property) {
 // Создает Wikimedia image URL из Commons filename claim.
 function getImage(entity) {
     const filename = getStringClaim(entity, "P18");
-    return filename
-        ? {
-            url: `https://commons.wikimedia.org/wiki/Special:FilePath/${encodeURIComponent(filename.replaceAll(" ", "_"))}`,
-            type: "poster",
-            source: PROVIDER_NAME,
-        }
-        : undefined;
-}
-// Sends provider JSON requests with Wikimedia-friendly headers.
-// Отправляет JSON-запросы провайдера с Wikimedia-friendly headers.
-function requestJson(config, url, context) {
-    return fetchJson({
-        provider: PROVIDER_NAME,
-        url,
-        context,
-        fetch: config.fetch,
-        init: {
-            headers: {
-                accept: "application/json",
-                "user-agent": config.userAgent,
-            },
-        },
-    });
-}
-// Checks that entity data has a stable ID.
-// Проверяет, что entity data содержит стабильный ID.
-function isKnownEntity(entity) {
-    return Boolean(entity.id);
-}
-// Keeps title matching conservative so generic search noise is dropped.
-// Держит matching названия консервативным, чтобы отсечь шум generic search.
-function isRelevantTitleMatch(title, queryTitle) {
-    const normalizedTitle = normalizeSearchText(title);
-    const normalizedQuery = normalizeSearchText(queryTitle);
-    return normalizedTitle.includes(normalizedQuery) || normalizedQuery.includes(normalizedTitle);
-}
-// Normalizes text for loose local comparisons.
-// Нормализует текст для мягких локальных сравнений.
-function normalizeSearchText(value) {
-    return value
-        .toLocaleLowerCase()
-        .replaceAll(/[^\p{L}\p{N}]+/gu, " ")
-        .trim();
+    const url = filename?.startsWith("http://") || filename?.startsWith("https://")
+        ? filename
+        : filename
+            ? `https://commons.wikimedia.org/wiki/Special:FilePath/${encodeURIComponent(filename.replaceAll(" ", "_"))}`
+            : undefined;
+    return createProviderImage(url, "poster", PROVIDER_NAME);
 }
 // Extracts a four-digit year from an ISO-like date.
 // Достает четырехзначный год из ISO-like date.
@@ -340,16 +273,6 @@ function getYear(date) {
     const year = date?.slice(0, 4);
     return year && /^\d{4}$/.test(year) ? Number(year) : undefined;
 }
-// Normalizes BCP-style language tags to Wikidata language codes.
-// Нормализует BCP-style language tags в language codes Wikidata.
-function normalizeLanguage(language) {
-    return language.split("-")[0]?.trim().toLocaleLowerCase() || DEFAULT_LANGUAGE;
-}
-// Escapes a literal string for the narrow SPARQL query used here.
-// Экранирует literal string для узкого SPARQL-запроса здесь.
-function escapeSparqlString(value) {
-    return value.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
-}
 function trimTrailingSlash(value) {
     return value.replace(/\/+$/, "");
 }