@media-engine/providers 0.1.1 → 1.1.0

package/dist/shared/safe-fetch.js

@@ -0,0 +1,300 @@
+import { lookup } from "node:dns/promises";
+import { request as requestHttp } from "node:http";
+import { request as requestHttps } from "node:https";
+import { isIP } from "node:net";
+import { Readable } from "node:stream";
+import { ProviderError } from "@media-engine/core";
+const DEFAULT_MAX_REDIRECTS = 3;
+const REDIRECT_STATUSES = new Set([301, 302, 303, 307, 308]);
+const finalResponseUrls = new WeakMap();
+// Creates a GET/HEAD fetch that validates every DNS answer and redirect, then pins the connection.
+// Создает GET/HEAD fetch с проверкой каждого DNS-ответа/redirect и закреплением соединения.
+export function createHardenedProviderFetch(options) {
+    const maxRedirects = options.maxRedirects ?? DEFAULT_MAX_REDIRECTS;
+    const resolver = options.resolver ?? resolveHostname;
+    const transport = options.transport ?? requestPinned;
+    if (!Number.isSafeInteger(maxRedirects) || maxRedirects < 0) {
+        throw new TypeError("Hardened provider fetch maxRedirects must be a non-negative safe integer.");
+    }
+    if (options.addressAttemptTimeoutMs !== undefined &&
+        (!Number.isSafeInteger(options.addressAttemptTimeoutMs) || options.addressAttemptTimeoutMs <= 0)) {
+        throw new TypeError("Hardened provider fetch addressAttemptTimeoutMs must be a positive safe integer.");
+    }
+    return async (input, init = {}) => {
+        assertSupportedRequest(init);
+        let url = normalizeExternalUrl(options.provider, input);
+        const visited = new Set();
+        for (let redirects = 0;; redirects += 1) {
+            if (visited.has(url.href)) {
+                throw createUnsafeTargetError(options.provider, "redirect loop");
+            }
+            visited.add(url.href);
+            const addresses = await resolveAndValidate(options.provider, url, resolver);
+            const response = await requestResolvedAddresses(url, { ...init, redirect: "manual" }, preferIpv4(addresses), transport, options.addressAttemptTimeoutMs);
+            const location = REDIRECT_STATUSES.has(response.status)
+                ? response.headers.get("location")
+                : null;
+            if (!location) {
+                finalResponseUrls.set(response, url.href);
+                return response;
+            }
+            await cancelResponse(response);
+            if (redirects >= maxRedirects) {
+                throw createUnsafeTargetError(options.provider, "redirect limit exceeded");
+            }
+            url = normalizeExternalUrl(options.provider, new URL(location, url));
+        }
+    };
+}
+// Returns the validated final URL after hardened redirects without exposing it as a response header.
+export function getHardenedProviderResponseUrl(response) {
+    return finalResponseUrls.get(response) ?? (response.url || undefined);
+}
+// Returns true only for globally routable IPv4/IPv6 unicast addresses.
+// Возвращает true только для глобально маршрутизируемых unicast IPv4/IPv6 адресов.
+export function isPublicIpAddress(address) {
+    const normalized = address.replace(/^\[|\]$/g, "").split("%")[0] ?? "";
+    const family = isIP(normalized);
+    if (family === 4) {
+        return isPublicIpv4(normalized);
+    }
+    if (family !== 6) {
+        return false;
+    }
+    const words = parseIpv6Words(normalized);
+    if (!words) {
+        return false;
+    }
+    const embeddedIpv4 = getEmbeddedIpv4(words);
+    if (embeddedIpv4) {
+        return isPublicIpv4(embeddedIpv4);
+    }
+    const [first = 0, second = 0] = words;
+    if (first < 0x2000 ||
+        first > 0x3fff ||
+        first === 0x2002 ||
+        (first === 0x2001 && second <= 0x01ff) ||
+        (first === 0x2001 && second === 0x0db8) ||
+        (first & 0xfff0) === 0x3ff0) {
+        return false;
+    }
+    return true;
+}
+async function resolveHostname(hostname) {
+    const addresses = await lookup(hostname, { all: true, verbatim: true });
+    return addresses.flatMap(({ address, family }) => family === 4 || family === 6 ? [{ address, family }] : []);
+}
+async function resolveAndValidate(provider, url, resolver) {
+    const hostname = stripIpv6Brackets(url.hostname);
+    const literalFamily = isIP(hostname);
+    const addresses = literalFamily
+        ? [{ address: hostname, family: literalFamily }]
+        : await resolver(hostname);
+    if (addresses.length === 0 ||
+        addresses.some(({ address, family }) => isIP(address) !== family || !isPublicIpAddress(address))) {
+        throw createUnsafeTargetError(provider, "non-public DNS address");
+    }
+    return addresses;
+}
+function normalizeExternalUrl(provider, input) {
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch (error) {
+        throw createUnsafeTargetError(provider, "invalid URL", error);
+    }
+    if ((url.protocol !== "http:" && url.protocol !== "https:") ||
+        url.username !== "" ||
+        url.password !== "" ||
+        url.hostname === "localhost" ||
+        url.hostname.endsWith(".localhost")) {
+        throw createUnsafeTargetError(provider, "unsupported URL target");
+    }
+    return url;
+}
+function assertSupportedRequest(init) {
+    const method = (init.method ?? "GET").toUpperCase();
+    if ((method !== "GET" && method !== "HEAD") || init.body != null) {
+        throw new TypeError("Hardened provider fetch supports only GET and HEAD requests without a body.");
+    }
+}
+function requestPinned(url, init, address) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const resolveOnce = (response) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(response);
+        };
+        const rejectOnce = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            reject(error);
+        };
+        const lookupPinned = (_hostname, lookupOptions, callback) => {
+            if (lookupOptions.all) {
+                callback(null, [address]);
+                return;
+            }
+            callback(null, address.address, address.family);
+        };
+        const request = (url.protocol === "https:" ? requestHttps : requestHttp)(url, {
+            method: init.method ?? "GET",
+            headers: Object.fromEntries(new Headers(init.headers).entries()),
+            signal: init.signal ?? undefined,
+            lookup: lookupPinned,
+            agent: false,
+        }, (incoming) => {
+            const headers = new Headers();
+            for (const [name, value] of Object.entries(incoming.headers)) {
+                for (const item of Array.isArray(value) ? value : value === undefined ? [] : [value]) {
+                    headers.append(name, item);
+                }
+            }
+            const status = incoming.statusCode ?? 500;
+            const hasBody = init.method?.toUpperCase() !== "HEAD" &&
+                status !== 204 &&
+                status !== 205 &&
+                status !== 304;
+            const body = hasBody ? Readable.toWeb(incoming) : null;
+            resolveOnce(new Response(body, {
+                status,
+                statusText: incoming.statusMessage,
+                headers,
+            }));
+        });
+        request.once("socket", (socket) => {
+            socket.once("error", rejectOnce);
+        });
+        request.once("error", rejectOnce);
+        request.end();
+    });
+}
+async function requestResolvedAddresses(url, init, addresses, transport, addressAttemptTimeoutMs) {
+    let lastError;
+    for (const address of addresses) {
+        const attempt = createAddressAttempt(init.signal, addressAttemptTimeoutMs);
+        try {
+            return await transport(url, { ...init, signal: attempt.signal }, address);
+        }
+        catch (error) {
+            if (init.signal?.aborted)
+                throw error;
+            lastError = error;
+        }
+        finally {
+            attempt.clear();
+        }
+    }
+    throw lastError ?? new Error("No validated provider address was available.");
+}
+function createAddressAttempt(signal, timeoutMs) {
+    if (timeoutMs === undefined)
+        return { signal, clear: () => undefined };
+    const controller = new AbortController();
+    const timeout = setTimeout(() => {
+        controller.abort(new DOMException("Provider address attempt timed out.", "AbortError"));
+    }, timeoutMs);
+    return {
+        signal: signal ? AbortSignal.any([signal, controller.signal]) : controller.signal,
+        clear: () => clearTimeout(timeout),
+    };
+}
+function preferIpv4(addresses) {
+    return [...addresses].sort((left, right) => left.family - right.family);
+}
+function isPublicIpv4(address) {
+    const octets = address.split(".").map(Number);
+    if (octets.length !== 4 || octets.some((octet) => octet < 0 || octet > 255)) {
+        return false;
+    }
+    const [first = 0, second = 0, third = 0] = octets;
+    return !(first === 0 ||
+        first === 10 ||
+        first === 127 ||
+        (first === 100 && second >= 64 && second <= 127) ||
+        (first === 169 && second === 254) ||
+        (first === 172 && second >= 16 && second <= 31) ||
+        (first === 192 && second === 0 && third === 0) ||
+        (first === 192 && second === 0 && third === 2) ||
+        (first === 192 && second === 88 && third === 99) ||
+        (first === 192 && second === 168) ||
+        (first === 198 && (second === 18 || second === 19)) ||
+        (first === 198 && second === 51 && third === 100) ||
+        (first === 203 && second === 0 && third === 113) ||
+        first >= 224);
+}
+function parseIpv6Words(address) {
+    const doubleColon = address.indexOf("::");
+    if (doubleColon !== -1 && doubleColon !== address.lastIndexOf("::")) {
+        return undefined;
+    }
+    const [leftValue, rightValue = ""] = doubleColon === -1
+        ? [address, ""]
+        : [address.slice(0, doubleColon), address.slice(doubleColon + 2)];
+    const left = expandIpv4Segment(leftValue ? leftValue.split(":") : []);
+    const right = expandIpv4Segment(rightValue ? rightValue.split(":") : []);
+    if (!left || !right) {
+        return undefined;
+    }
+    const missing = 8 - left.length - right.length;
+    if ((doubleColon === -1 && missing !== 0) || (doubleColon !== -1 && missing < 1)) {
+        return undefined;
+    }
+    const words = [...left, ...Array.from({ length: missing }, () => 0), ...right];
+    return words.length === 8 ? words : undefined;
+}
+function expandIpv4Segment(parts) {
+    const last = parts.at(-1);
+    if (!last?.includes(".")) {
+        return parseHexWords(parts);
+    }
+    const ipv4 = last.split(".").map(Number);
+    if (ipv4.length !== 4 ||
+        ipv4.some((octet) => !Number.isInteger(octet) || octet < 0 || octet > 255)) {
+        return undefined;
+    }
+    return parseHexWords([
+        ...parts.slice(0, -1),
+        ((ipv4[0] << 8) | ipv4[1]).toString(16),
+        ((ipv4[2] << 8) | ipv4[3]).toString(16),
+    ]);
+}
+function parseHexWords(parts) {
+    const words = parts.map((part) => /^[\da-f]{1,4}$/i.test(part) ? Number.parseInt(part, 16) : NaN);
+    return words.every(Number.isInteger) ? words : undefined;
+}
+function getEmbeddedIpv4(words) {
+    const prefixIsZero = words.slice(0, 5).every((word) => word === 0);
+    const isMapped = prefixIsZero && words[5] === 0xffff;
+    const isCompatible = words.slice(0, 6).every((word) => word === 0) && (words[6] !== 0 || words[7] > 1);
+    const isNat64 = words[0] === 0x0064 && words[1] === 0xff9b && words.slice(2, 6).every((word) => word === 0);
+    if (!isMapped && !isCompatible && !isNat64) {
+        return undefined;
+    }
+    return `${words[6] >> 8}.${words[6] & 0xff}.${words[7] >> 8}.${words[7] & 0xff}`;
+}
+function stripIpv6Brackets(hostname) {
+    return hostname.replace(/^\[|\]$/g, "");
+}
+async function cancelResponse(response) {
+    try {
+        await response.body?.cancel();
+    }
+    catch {
+        // Redirect cleanup must not hide the policy error or next request.
+    }
+}
+function createUnsafeTargetError(provider, reason, cause) {
+    return new ProviderError({
+        provider,
+        code: "PROVIDER_INVALID_RESPONSE",
+        message: `Provider "${provider}" returned an unsafe external URL (${reason}).`,
+        retryable: false,
+        cause,
+    });
+}
+//# sourceMappingURL=safe-fetch.js.map

package/dist/shared/safe-fetch.js.map

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

package/dist/shared/torrent-release-matching.d.ts

@@ -0,0 +1,7 @@
+import type { TorrentDiscoveryQuery } from "@media-engine/core";
+export interface NamedTorrentRelease {
+    title: string;
+}
+export declare function canResolveStrictTorrentQuery(query: TorrentDiscoveryQuery): boolean;
+export declare function createTorrentReleaseSearchTerm(query: TorrentDiscoveryQuery): string;
+export declare function selectStrictTorrentReleases<T extends NamedTorrentRelease>(releases: T[], query: TorrentDiscoveryQuery): T[];

package/dist/shared/torrent-release-matching.js

@@ -0,0 +1,143 @@
+import { normalizeProviderSearchText } from "./mapping.js";
+const LEADING_GROUPS = /^(?:\s*[[(][^\])]{1,80}[\])]\s*)+/u;
+const SEASON_TOKEN = /(?:^|[\s._([{])(?:s(?:eason)?[ ._-]*\d{1,3}|\d{1,3}[ ._-]*x[ ._-]*\d{1,4})(?=$|[\s._)\]}-])/iu;
+const ABSOLUTE_EPISODE_TOKEN = /(?:^|[\s._([{])(?:ep(?:isode)?[ ._-]*\d{1,4}|e[ ._-]*\d{1,4}|-[ ]*\d{1,4})(?=$|[\s._)\]}-])/iu;
+export function canResolveStrictTorrentQuery(query) {
+    const title = query.title?.trim();
+    const numericFields = [query.seasonNumber, query.episodeNumber, query.absoluteEpisodeNumber];
+    if (!title ||
+        title.length < 2 ||
+        !Number.isInteger(query.year) ||
+        query.year < 1_800 ||
+        query.year > 3_000 ||
+        numericFields.some((value) => value !== undefined && (!Number.isInteger(value) || value < 0 || value > 9_999))) {
+        return false;
+    }
+    if (query.type === "movie") {
+        return numericFields.every((value) => value === undefined);
+    }
+    if (query.absoluteEpisodeNumber !== undefined) {
+        return query.seasonNumber === undefined && query.episodeNumber === undefined;
+    }
+    return query.episodeNumber === undefined || query.seasonNumber !== undefined;
+}
+export function createTorrentReleaseSearchTerm(query) {
+    const parts = [query.title.trim(), String(query.year)];
+    if (query.absoluteEpisodeNumber !== undefined) {
+        parts.push(`E${formatEpisodeNumber(query.absoluteEpisodeNumber)}`);
+    }
+    else if (query.seasonNumber !== undefined && query.episodeNumber !== undefined) {
+        parts.push(`S${formatEpisodeNumber(query.seasonNumber)}E${formatEpisodeNumber(query.episodeNumber)}`);
+    }
+    else if (query.seasonNumber !== undefined) {
+        parts.push(`S${formatEpisodeNumber(query.seasonNumber)}`);
+    }
+    return parts.join(" ");
+}
+export function selectStrictTorrentReleases(releases, query) {
+    return releases.filter((release) => hasExactYear(release.title, query.year) &&
+        hasExactTitle(release.title, query.title, query) &&
+        matchesEpisodeQuery(release.title, query));
+}
+function hasExactYear(title, year) {
+    return new RegExp(`(?<!\\d)${year}(?!\\d)`, "u").test(title);
+}
+function hasExactTitle(releaseTitle, queryTitle, query) {
+    const title = releaseTitle.replace(LEADING_GROUPS, "");
+    const markerIndexes = [findYearIndex(title, query.year)];
+    if (query.type !== "movie") {
+        markerIndexes.push(findMatchIndex(title, SEASON_TOKEN));
+        markerIndexes.push(findMatchIndex(title, ABSOLUTE_EPISODE_TOKEN));
+    }
+    const markerIndex = markerIndexes
+        .filter((index) => index !== undefined)
+        .reduce((earliest, index) => {
+        return earliest === undefined || index < earliest ? index : earliest;
+    }, undefined);
+    if (markerIndex === undefined)
+        return false;
+    const expected = normalizeProviderSearchText(queryTitle);
+    const candidates = title
+        .slice(0, markerIndex)
+        .split(/\s+(?:\/|\||aka)\s+/iu)
+        .map((candidate) => normalizeProviderSearchText(candidate))
+        .filter(Boolean);
+    return candidates.includes(expected);
+}
+function matchesEpisodeQuery(title, query) {
+    if (query.seasonNumber === undefined &&
+        query.episodeNumber === undefined &&
+        query.absoluteEpisodeNumber === undefined) {
+        return true;
+    }
+    const scope = parseEpisodeScope(title);
+    if (query.absoluteEpisodeNumber !== undefined) {
+        return includesNumber(query.absoluteEpisodeNumber, scope.absoluteStart, scope.absoluteEnd);
+    }
+    if (query.seasonNumber === undefined ||
+        !includesNumber(query.seasonNumber, scope.seasonStart, scope.seasonEnd)) {
+        return false;
+    }
+    return query.episodeNumber === undefined
+        ? true
+        : includesNumber(query.episodeNumber, scope.episodeStart, scope.episodeEnd);
+}
+function parseEpisodeScope(title) {
+    const compact = title.replace(/[._]/gu, " ");
+    const seasonEpisode = /\bs\s*(\d{1,3})(?:\s*-\s*s?\s*(\d{1,3}))?(?:\s*e\s*(\d{1,4})(?:\s*-\s*e?\s*(\d{1,4}))?)?\b/iu.exec(compact);
+    if (seasonEpisode?.[1]) {
+        return {
+            seasonStart: Number(seasonEpisode[1]),
+            seasonEnd: Number(seasonEpisode[2] ?? seasonEpisode[1]),
+            ...(seasonEpisode[3]
+                ? {
+                    episodeStart: Number(seasonEpisode[3]),
+                    episodeEnd: Number(seasonEpisode[4] ?? seasonEpisode[3]),
+                }
+                : {}),
+        };
+    }
+    const namedSeason = /\bseason\s*(\d{1,3})(?:\s*-\s*(\d{1,3}))?(?:\s*episode\s*(\d{1,4})(?:\s*-\s*(\d{1,4}))?)?\b/iu.exec(compact);
+    if (namedSeason?.[1]) {
+        return {
+            seasonStart: Number(namedSeason[1]),
+            seasonEnd: Number(namedSeason[2] ?? namedSeason[1]),
+            ...(namedSeason[3]
+                ? {
+                    episodeStart: Number(namedSeason[3]),
+                    episodeEnd: Number(namedSeason[4] ?? namedSeason[3]),
+                }
+                : {}),
+        };
+    }
+    const xEpisode = /\b(\d{1,3})\s*x\s*(\d{1,4})(?:\s*-\s*(\d{1,4}))?\b/iu.exec(compact);
+    if (xEpisode?.[1] && xEpisode[2]) {
+        return {
+            seasonStart: Number(xEpisode[1]),
+            seasonEnd: Number(xEpisode[1]),
+            episodeStart: Number(xEpisode[2]),
+            episodeEnd: Number(xEpisode[3] ?? xEpisode[2]),
+        };
+    }
+    const absoluteEpisode = /\b(?:ep(?:isode)?|e)\s*(\d{1,4})(?:\s*-\s*(?:ep(?:isode)?|e)?\s*(\d{1,4}))?\b/iu.exec(compact) ?? /(?:^|\s)-\s*(\d{1,4})(?:\s*-\s*(\d{1,4}))?(?=$|\s|\[)/u.exec(compact);
+    return absoluteEpisode?.[1]
+        ? {
+            absoluteStart: Number(absoluteEpisode[1]),
+            absoluteEnd: Number(absoluteEpisode[2] ?? absoluteEpisode[1]),
+        }
+        : {};
+}
+function formatEpisodeNumber(value) {
+    return String(value).padStart(2, "0");
+}
+function includesNumber(value, start, end) {
+    return start !== undefined && value >= start && value <= (end ?? start);
+}
+function findYearIndex(title, year) {
+    return findMatchIndex(title, new RegExp(`(?<!\\d)${year}(?!\\d)`, "u"));
+}
+function findMatchIndex(title, pattern) {
+    const index = pattern.exec(title)?.index;
+    return index === undefined ? undefined : index;
+}
+//# sourceMappingURL=torrent-release-matching.js.map

package/dist/shared/torrent-release-matching.js.map

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

package/dist/shared/torrent-release-metadata.d.ts

@@ -0,0 +1,4 @@
+import type { TorrentDiscoveryQuery, TorrentEpisodeRef, TorrentReleaseInfo } from "@media-engine/core";
+export declare function mapTorrentReleaseTitle(title: string): TorrentReleaseInfo;
+export declare function createTorrentEpisodeRef(query: TorrentDiscoveryQuery): TorrentEpisodeRef | undefined;
+export declare function createCanonicalMagnetUri(hash: string, title: string): string;

package/dist/shared/torrent-release-metadata.js

@@ -0,0 +1,95 @@
+export function mapTorrentReleaseTitle(title) {
+    const resolution = parseResolution(title);
+    const videoCodec = parseVideoCodec(title);
+    const audioCodec = parseAudioCodec(title);
+    const container = parseContainer(title);
+    const hdr = parseHdr(title);
+    return {
+        source: mapSourceType(title),
+        ...(resolution ? { resolution: resolution.label, height: resolution.height } : {}),
+        ...(videoCodec ? { videoCodec } : {}),
+        ...(audioCodec ? { audioCodec } : {}),
+        ...(container ? { container } : {}),
+        ...(hdr.length > 0 ? { hdr } : {}),
+    };
+}
+export function createTorrentEpisodeRef(query) {
+    if (query.absoluteEpisodeNumber !== undefined) {
+        return { absoluteEpisodeNumber: query.absoluteEpisodeNumber };
+    }
+    if (query.seasonNumber === undefined)
+        return undefined;
+    return {
+        seasonNumber: query.seasonNumber,
+        ...(query.episodeNumber !== undefined ? { episodeNumber: query.episodeNumber } : {}),
+    };
+}
+export function createCanonicalMagnetUri(hash, title) {
+    return `magnet:?xt=urn:btih:${hash}&dn=${encodeURIComponent(title)}`;
+}
+function parseResolution(title) {
+    const height = /(?:^|\D)(2160|1080|720|576|480)p(?:\D|$)/iu.exec(title)?.[1];
+    if (height)
+        return { label: `${height}p`, height: Number(height) };
+    return /(?:^|[^\p{L}\p{N}])(?:4k|uhd)(?:[^\p{L}\p{N}]|$)/iu.test(title)
+        ? { label: "2160p", height: 2160 }
+        : undefined;
+}
+function mapSourceType(title) {
+    if (/\b(?:blu[ -]?ray|bdremux|bdrip)\b/iu.test(title))
+        return "bluray";
+    if (/\b(?:web[ ._-]?dl|web[ ._-]?rip)\b/iu.test(title))
+        return "web";
+    if (/\bhdtv\b/iu.test(title))
+        return "hdtv";
+    if (/\bdvd(?:rip)?\b/iu.test(title))
+        return "dvd";
+    if (/\b(?:camrip|cam|telesync|telecine|ts)\b/iu.test(title))
+        return "cam";
+    return "unknown";
+}
+function parseVideoCodec(title) {
+    if (/\bav1\b/iu.test(title))
+        return "AV1";
+    if (/\b(?:h[ .]?265|hevc|x265)\b/iu.test(title))
+        return "H.265";
+    if (/\b(?:h[ .]?264|avc|x264)\b/iu.test(title))
+        return "H.264";
+    if (/\bxvid\b/iu.test(title))
+        return "Xvid";
+    if (/\bmpeg[ -]?2\b/iu.test(title))
+        return "MPEG-2";
+    return undefined;
+}
+function parseAudioCodec(title) {
+    if (/\btruehd\b/iu.test(title))
+        return "TrueHD";
+    if (/\b(?:e-?ac-?3|ddp)\b/iu.test(title))
+        return "E-AC-3";
+    if (/\b(?:ac-?3|dd)\b/iu.test(title))
+        return "AC-3";
+    if (/\bdts(?:-?hd)?\b/iu.test(title))
+        return "DTS";
+    if (/\bflac\b/iu.test(title))
+        return "FLAC";
+    if (/\baac\b/iu.test(title))
+        return "AAC";
+    return undefined;
+}
+function parseContainer(title) {
+    const match = /(?:^|[^\p{L}\p{N}])(mkv|mp4|avi)(?:[^\p{L}\p{N}]|$)/iu.exec(title);
+    return match?.[1]?.toLowerCase();
+}
+function parseHdr(title) {
+    const values = [];
+    if (/dolby[ ._-]?vision|\bdv\b/iu.test(title))
+        values.push("Dolby Vision");
+    if (/\bhdr10\+(?![\p{L}\p{N}])/iu.test(title))
+        values.push("HDR10+");
+    else if (/\bhdr10\b/iu.test(title))
+        values.push("HDR10");
+    else if (/\bhdr\b/iu.test(title))
+        values.push("HDR");
+    return values;
+}
+//# sourceMappingURL=torrent-release-metadata.js.map

package/dist/shared/torrent-release-metadata.js.map

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

package/dist/shikimori/index.js

@@ -1,5 +1,6 @@
 import { rethrowIfProviderAborted } from "../shared/abort.js";
-import { fetchJson, ProviderRateLimitGate } from "../shared/index.js";
+import { fetchJson, normalizeProviderOutputUrl, ProviderRateLimitGate, } from "../shared/index.js";
+import { createProviderImage } from "../shared/mapping.js";
 import { resolveBoundedIntegerOption } from "../shared/options.js";
 const PROVIDER_NAME = "shikimori";
 const DEFAULT_BASE_URL = "https://shikimori.one";
@@ -226,7 +227,7 @@ function createProviderSource(config, ids) {
     return {
         provider: PROVIDER_NAME,
         ids,
-        url: ids?.shikimori ? `${config.baseUrl}/animes/${ids.shikimori}` : undefined,
+        url: normalizeProviderOutputUrl(ids?.shikimori ? `${config.baseUrl}/animes/${ids.shikimori}` : undefined),
     };
 }
 // Creates an image from Shikimori relative image paths.
@@ -236,11 +237,7 @@ function createImage(config, image, type) {
     if (!path) {
         return undefined;
     }
-    return {
-        url: createAbsoluteUrl(config, path),
-        type,
-        source: PROVIDER_NAME,
-    };
+    return createProviderImage(createAbsoluteUrl(config, path), type, PROVIDER_NAME);
 }
 // Maps all Shikimori detail images into normalized image metadata.
 // Преобразует все detail images Shikimori в нормализованные metadata изображений.