@media-engine/providers 0.1.1 → 1.1.0

package/dist/videohub-streaming/config.js

@@ -0,0 +1,73 @@
+import { MEDIA_ENGINE_DEFAULT_USER_AGENT } from "../package-version.js";
+import { ProviderRateLimitGate } from "../shared/index.js";
+import { resolveBoundedIntegerOption } from "../shared/options.js";
+import { createHardenedProviderFetch } from "../shared/safe-fetch.js";
+const DEFAULT_PROVIDER_NAME = "videohub-streaming";
+const DEFAULT_BASE_URL = "https://plapi.cdnvideohub.com";
+const DEFAULT_MAX_PLAYLIST_RESPONSE_BYTES = 2 * 1024 * 1024;
+const DEFAULT_MAX_VIDEO_RESPONSE_BYTES = 256 * 1024;
+const DEFAULT_PLAYLIST_ITEM_LIMIT = 1_000;
+const DEFAULT_VIDEO_LOOKUP_LIMIT = 8;
+const DEFAULT_VIDEO_LOOKUP_CONCURRENCY = 4;
+const DEFAULT_VIDEO_LOOKUP_TIMEOUT_MS = 8_000;
+const DEFAULT_LINK_TTL_MS = 5 * 60_000;
+const DEFAULT_ADDRESS_ATTEMPT_TIMEOUT_MS = 3_500;
+export function createVideoHubConfig(options) {
+    const name = normalizeProviderName(options.name ?? DEFAULT_PROVIDER_NAME);
+    return {
+        name,
+        baseUrl: normalizeBaseUrl(options.baseUrl ?? DEFAULT_BASE_URL),
+        fetch: options.fetch ??
+            createHardenedProviderFetch({
+                provider: name,
+                maxRedirects: 2,
+                addressAttemptTimeoutMs: DEFAULT_ADDRESS_ATTEMPT_TIMEOUT_MS,
+            }),
+        rateLimitGate: new ProviderRateLimitGate(),
+        maxPlaylistResponseBytes: resolveBoundedIntegerOption(options.maxPlaylistResponseBytes, DEFAULT_MAX_PLAYLIST_RESPONSE_BYTES, "VideoHUB streaming maxPlaylistResponseBytes", 1_024, 16 * 1024 * 1024),
+        maxVideoResponseBytes: resolveBoundedIntegerOption(options.maxVideoResponseBytes, DEFAULT_MAX_VIDEO_RESPONSE_BYTES, "VideoHUB streaming maxVideoResponseBytes", 1_024, 4 * 1024 * 1024),
+        playlistItemLimit: resolveBoundedIntegerOption(options.playlistItemLimit, DEFAULT_PLAYLIST_ITEM_LIMIT, "VideoHUB streaming playlistItemLimit", 1, 5_000),
+        videoLookupLimit: resolveBoundedIntegerOption(options.videoLookupLimit, DEFAULT_VIDEO_LOOKUP_LIMIT, "VideoHUB streaming videoLookupLimit", 1, 32),
+        videoLookupConcurrency: resolveBoundedIntegerOption(options.videoLookupConcurrency, DEFAULT_VIDEO_LOOKUP_CONCURRENCY, "VideoHUB streaming videoLookupConcurrency", 1, 8),
+        videoLookupTimeoutMs: resolveBoundedIntegerOption(options.videoLookupTimeoutMs, DEFAULT_VIDEO_LOOKUP_TIMEOUT_MS, "VideoHUB streaming videoLookupTimeoutMs", 500, 15_000),
+        linkTtlMs: resolveBoundedIntegerOption(options.linkTtlMs, DEFAULT_LINK_TTL_MS, "VideoHUB streaming linkTtlMs", 30_000, 60 * 60_000),
+        userAgent: options.userAgent?.trim() || MEDIA_ENGINE_DEFAULT_USER_AGENT,
+        now: options.now ?? Date.now,
+    };
+}
+export function createVideoHubCapabilities() {
+    return {
+        mediaTypes: ["movie", "series"],
+        lookup: {
+            byTitle: false,
+            byExternalIds: ["kinopoisk"],
+            byEpisode: true,
+        },
+        features: ["mp4", "translations", "qualities", "episode_mapping", "headers"],
+    };
+}
+function normalizeProviderName(value) {
+    const name = value.trim();
+    if (!name)
+        throw new TypeError("VideoHUB streaming provider name is required.");
+    return name;
+}
+function normalizeBaseUrl(value) {
+    let url;
+    try {
+        url = new URL(value.trim());
+    }
+    catch (error) {
+        throw new TypeError("VideoHUB streaming baseUrl must be a valid HTTPS URL.", {
+            cause: error,
+        });
+    }
+    if (url.protocol !== "https:" || url.username !== "" || url.password !== "") {
+        throw new TypeError("VideoHUB streaming baseUrl must be a credential-free HTTPS URL.");
+    }
+    url.pathname = "/";
+    url.search = "";
+    url.hash = "";
+    return url.href.replace(/\/$/u, "");
+}
+//# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { StreamingProvider } from "@media-engine/core";
+import { type VideoHubStreamingProviderOptions } from "./config.js";
+export type { VideoHubStreamingProviderOptions } from "./config.js";
+export declare function videoHubStreamingProvider(options?: VideoHubStreamingProviderOptions): StreamingProvider;

package/dist/videohub-streaming/index.js

@@ -0,0 +1,53 @@
+import { rethrowIfProviderAborted } from "../shared/abort.js";
+import { loadVideoHubPlaylist, resolveVideoHubItems, resolveVideoHubKinopoiskId, } from "./client.js";
+import { createVideoHubCapabilities, createVideoHubConfig, } from "./config.js";
+import { mapVideoHubAvailability } from "./mapping.js";
+export function videoHubStreamingProvider(options = {}) {
+    const config = createVideoHubConfig(options);
+    return {
+        name: config.name,
+        version: options.version,
+        kind: "streaming",
+        capabilities: createVideoHubCapabilities(),
+        availabilityDependsOnPlaybackUserAgent: true,
+        async getAvailability(query, context) {
+            if (query.providers && !query.providers.includes(config.name))
+                return null;
+            if (!canResolveQuery(query))
+                return null;
+            const kinopoiskId = resolveVideoHubKinopoiskId(query);
+            if (!kinopoiskId)
+                return null;
+            const playbackUserAgent = resolvePlaybackUserAgent(context, config.userAgent);
+            try {
+                const { playlist, sourceUrl } = await loadVideoHubPlaylist(config, kinopoiskId, context, playbackUserAgent);
+                if ((query.type === "series") !== playlist.isSerial)
+                    return null;
+                const items = await resolveVideoHubItems(config, playlist, query, context, playbackUserAgent);
+                return mapVideoHubAvailability(config.name, kinopoiskId, playlist.title, items, query, sourceUrl, config.now(), config.linkTtlMs, playbackUserAgent);
+            }
+            catch (error) {
+                rethrowIfProviderAborted(context, error);
+                throw error;
+            }
+        },
+    };
+}
+function resolvePlaybackUserAgent(context, fallback) {
+    const value = context.playbackUserAgent?.trim();
+    return value && value.length <= 512 && !/[\u0000-\u001f\u007f]/u.test(value) ? value : fallback;
+}
+function canResolveQuery(query) {
+    if (query.type !== "movie" && query.type !== "series")
+        return false;
+    if (query.absoluteEpisodeNumber !== undefined)
+        return false;
+    if (query.type === "movie") {
+        return query.seasonNumber === undefined && query.episodeNumber === undefined;
+    }
+    return (Number.isInteger(query.seasonNumber) &&
+        (query.seasonNumber ?? 0) > 0 &&
+        Number.isInteger(query.episodeNumber) &&
+        (query.episodeNumber ?? 0) > 0);
+}
+//# sourceMappingURL=index.js.map

package/dist/videohub-streaming/index.js.map

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

package/dist/videohub-streaming/mapping.d.ts

@@ -0,0 +1,3 @@
+import type { MediaAvailability } from "@media-engine/core";
+import type { ResolvedVideoHubItem } from "./client.js";
+export declare function mapVideoHubAvailability(provider: string, kinopoiskId: string, playlistTitle: string | undefined, items: ResolvedVideoHubItem[], query: MediaAvailability["query"], sourceUrl: string, now: number, linkTtlMs: number, playbackUserAgent: string): MediaAvailability | null;

package/dist/videohub-streaming/mapping.js

@@ -0,0 +1,84 @@
+export function mapVideoHubAvailability(provider, kinopoiskId, playlistTitle, items, query, sourceUrl, now, linkTtlMs, playbackUserAgent) {
+    const expiresAt = new Date(now + linkTtlMs).toISOString();
+    const options = uniqueOptions(items.flatMap((item) => item.sources.map((source) => createOption(provider, kinopoiskId, item, source, query, expiresAt, playbackUserAgent))));
+    if (options.length === 0)
+        return null;
+    const episodes = query.type === "series"
+        ? [
+            {
+                seasonNumber: query.seasonNumber,
+                episodeNumber: query.episodeNumber,
+                options,
+            },
+        ]
+        : undefined;
+    const ids = { ...query.ids, kinopoisk: kinopoiskId };
+    return {
+        query,
+        item: {
+            type: query.type,
+            title: playlistTitle ?? query.title,
+            year: query.year,
+            ids,
+        },
+        ...(episodes ? { episodes } : {}),
+        options,
+        sourceProviders: [{ provider, url: sourceUrl, ids }],
+        checkedAt: new Date(now).toISOString(),
+    };
+}
+function createOption(provider, kinopoiskId, item, source, query, expiresAt, playbackUserAgent) {
+    const episode = query.type === "series"
+        ? { seasonNumber: item.seasonNumber, episodeNumber: item.episodeNumber }
+        : undefined;
+    const translation = createTranslation(item.voiceStudio, item.voiceType);
+    const episodeKey = episode ? `:${episode.seasonNumber}:${episode.episodeNumber}` : "";
+    return {
+        id: `${provider}:${kinopoiskId}${episodeKey}:${item.vkId}:${source.label}`,
+        provider,
+        player: {
+            kind: "mp4",
+            label: "VideoHUB",
+            providerPlayerId: `${item.vkId}${episodeKey}`,
+        },
+        translation,
+        quality: {
+            label: source.label,
+            ...(source.height !== undefined ? { height: source.height } : {}),
+        },
+        ...(episode ? { episode } : {}),
+        access: { url: source.url, headers: { "User-Agent": playbackUserAgent } },
+        availability: "available",
+        expiresAt,
+        sourceUrl: item.sourceUrl,
+    };
+}
+function createTranslation(voiceStudio, voiceType) {
+    const title = voiceStudio || voiceType || "VideoHUB";
+    const normalizedType = (voiceType ?? title).toLocaleLowerCase();
+    const type = normalizedType.includes("субтит")
+        ? "subtitles"
+        : normalizedType.includes("дубляж")
+            ? "dub"
+            : normalizedType.includes("голос")
+                ? "voiceover"
+                : normalizedType.includes("оригинал")
+                    ? "original"
+                    : "unknown";
+    return {
+        title,
+        type,
+        ...(voiceStudio ? { team: voiceStudio } : {}),
+    };
+}
+function uniqueOptions(options) {
+    const seen = new Set();
+    return options.filter((option) => {
+        const key = `${option.translation?.title ?? ""}\u0000${option.quality?.label ?? ""}\u0000${option.access.url}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=mapping.js.map

package/dist/videohub-streaming/mapping.js.map

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

package/dist/wikidata/cache.d.ts

@@ -0,0 +1,11 @@
+export declare class WikidataCache<TEntity> {
+    #private;
+    constructor(options: {
+        maxEntries: number;
+        ttlMs: number;
+    });
+    getEntity(languageKey: string, entityId: string): TEntity | null | undefined;
+    setEntity(languageKey: string, entityId: string, entity: TEntity | null): void;
+    getImdbEntityId(imdbId: string): string | null | undefined;
+    setImdbEntityId(imdbId: string, entityId: string | null): void;
+}

package/dist/wikidata/cache.js

@@ -0,0 +1,30 @@
+import { MemoryCache } from "@media-engine/core";
+const ENTITY_KEY_PREFIX = "entity";
+const IMDB_KEY_PREFIX = "imdb";
+// Internal bounded cache for expensive Wikidata entity payloads and exact IMDb mappings.
+// Внутренний bounded cache для тяжелых Wikidata entities и точных IMDb mappings.
+export class WikidataCache {
+    #cache;
+    #ttlMs;
+    constructor(options) {
+        this.#cache = new MemoryCache({ maxEntries: options.maxEntries });
+        this.#ttlMs = options.ttlMs;
+    }
+    getEntity(languageKey, entityId) {
+        return this.#cache.get(`${ENTITY_KEY_PREFIX}:${languageKey}:${entityId.toUpperCase()}`);
+    }
+    setEntity(languageKey, entityId, entity) {
+        this.#cache.set(`${ENTITY_KEY_PREFIX}:${languageKey}:${entityId.toUpperCase()}`, entity, {
+            ttlMs: this.#ttlMs,
+        });
+    }
+    getImdbEntityId(imdbId) {
+        return this.#cache.get(`${IMDB_KEY_PREFIX}:${imdbId.toLowerCase()}`);
+    }
+    setImdbEntityId(imdbId, entityId) {
+        this.#cache.set(`${IMDB_KEY_PREFIX}:${imdbId.toLowerCase()}`, entityId, {
+            ttlMs: this.#ttlMs,
+        });
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/wikidata/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/wikidata/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AACnC,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,yFAAyF;AACzF,iFAAiF;AACjF,MAAM,OAAO,aAAa;IACf,MAAM,CAAc;IACpB,MAAM,CAAS;IAExB,YAAY,OAA8C;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAC9B,CAAC;IAED,SAAS,CAAC,WAAmB,EAAE,QAAgB;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CACpB,GAAG,iBAAiB,IAAI,WAAW,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAChE,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,WAAmB,EAAE,QAAgB,EAAE,MAAsB;QACrE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,iBAAiB,IAAI,WAAW,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE;YACvF,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAgB,GAAG,eAAe,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,eAAe,CAAC,MAAc,EAAE,QAAuB;QACrD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE;YACtE,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/wikidata/candidates.d.ts

@@ -0,0 +1,12 @@
+import type { ProviderSearchQuery } from "@media-engine/core";
+export interface WikidataSearchEntry {
+    id?: string;
+    label?: string;
+    description?: string;
+    match?: {
+        text?: string;
+    };
+}
+export declare function selectWikidataEntityIds(entries: WikidataSearchEntry[], query: ProviderSearchQuery, entityLimit: number): string[];
+export declare function isRelevantWikidataTitleMatch(title: string, queryTitle: string): boolean;
+export declare function normalizeWikidataEntityId(value: string | undefined): string | undefined;

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":"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"}

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