@media-engine/providers 0.1.1 → 1.0.0

package/dist/shared/rate-limit.js

@@ -1,3 +1,4 @@
+import { waitForAbortableDelay } from "./abort.js";
 import { parseRetryAfterMs } from "./retry.js";
 const DEFAULT_MAX_COOLDOWN_MS = 30_000;
 const DEFAULT_RATE_LIMIT_FALLBACK_MS = 1_000;
@@ -32,7 +33,7 @@ export class ProviderRateLimitGate {
             if (remainingMs <= 0) {
                 return;
             }
-            await abortableDelay(remainingMs, signal);
+            await waitForAbortableDelay(remainingMs, signal);
         }
     }
 }
@@ -48,21 +49,4 @@ export function deferProviderRateLimitFromResponse(gate, response, fallbackDelay
         gate.defer(retryAfterMs);
     }
 }
-function abortableDelay(ms, signal) {
-    return new Promise((resolve, reject) => {
-        if (signal?.aborted) {
-            reject(signal.reason);
-            return;
-        }
-        const timeout = setTimeout(() => {
-            signal?.removeEventListener("abort", onAbort);
-            resolve();
-        }, ms);
-        const onAbort = () => {
-            clearTimeout(timeout);
-            reject(signal?.reason);
-        };
-        signal?.addEventListener("abort", onAbort, { once: true });
-    });
-}
 //# sourceMappingURL=rate-limit.js.map

package/dist/shared/rate-limit.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/shared/rate-limit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/shared/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAO7C,sFAAsF;AACtF,qFAAqF;AACrF,MAAM,OAAO,qBAAqB;IACvB,cAAc,CAAS;IACvB,IAAI,CAAe;IAC5B,aAAa,GAAG,CAAC,CAAC;IAElB,YAAY,UAAwC,EAAE;QACpD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC;QAEvE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,UAAU,CAAC,kEAAkE,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACtC,CAAC;IAED,8EAA8E;IAC9E,mFAAmF;IACnF,KAAK,CAAC,OAAe;QACnB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;YAC3E,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9D,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,cAAc,CAAC,CAAC;IAClF,CAAC;IAED,iFAAiF;IACjF,8EAA8E;IAC9E,KAAK,CAAC,IAAI,CAAC,MAAoB;QAC7B,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAErD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,MAAM,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;CACF;AAED,mFAAmF;AACnF,qFAAqF;AACrF,MAAM,UAAU,kCAAkC,CAChD,IAA2B,EAC3B,QAAkB,EAClB,eAAe,GAAG,8BAA8B;IAEhD,MAAM,YAAY,GAAG,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAE5E,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,eAAe,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QACzD,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/shared/response-body.d.ts

@@ -0,0 +1,6 @@
+export interface ReadBoundedResponseBodyOptions {
+    signal?: AbortSignal;
+    overflow?: "throw" | "truncate";
+}
+export declare function readBoundedResponseBytes(provider: string, response: Response, maxBytes: number, options?: ReadBoundedResponseBodyOptions): Promise<Uint8Array>;
+export declare function readBoundedResponseText(provider: string, response: Response, maxBytes: number, options?: ReadBoundedResponseBodyOptions): Promise<string>;

package/dist/shared/response-body.js

@@ -0,0 +1,109 @@
+import { ProviderError } from "@media-engine/core";
+// Reads at most the configured response bytes and cancels the stream as soon as it overflows.
+// Читает не больше заданного объема ответа и отменяет stream сразу при переполнении.
+export async function readBoundedResponseBytes(provider, response, maxBytes, options = {}) {
+    assertPositiveByteLimit(maxBytes);
+    const overflow = options.overflow ?? "throw";
+    const declaredLength = parseContentLength(response.headers.get("content-length"));
+    if (overflow === "throw" && declaredLength !== undefined && declaredLength > maxBytes) {
+        await cancelBody(response.body);
+        throw createOversizedResponseError(provider, maxBytes);
+    }
+    if (options.signal?.aborted) {
+        await cancelBody(response.body, options.signal.reason);
+        throw options.signal.reason ?? new DOMException("Aborted", "AbortError");
+    }
+    if (!response.body) {
+        return new Uint8Array();
+    }
+    const reader = response.body.getReader();
+    const chunks = [];
+    let totalBytes = 0;
+    const onAbort = () => {
+        void reader.cancel(options.signal?.reason).catch(() => undefined);
+    };
+    options.signal?.addEventListener("abort", onAbort, { once: true });
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (options.signal?.aborted) {
+                throw options.signal.reason ?? new DOMException("Aborted", "AbortError");
+            }
+            if (done) {
+                break;
+            }
+            if (totalBytes + value.byteLength > maxBytes) {
+                await cancelReader(reader);
+                if (overflow === "truncate") {
+                    break;
+                }
+                throw createOversizedResponseError(provider, maxBytes);
+            }
+            chunks.push(value);
+            totalBytes += value.byteLength;
+        }
+    }
+    catch (error) {
+        if (options.signal?.aborted) {
+            throw options.signal.reason ?? error;
+        }
+        throw error;
+    }
+    finally {
+        options.signal?.removeEventListener("abort", onAbort);
+        reader.releaseLock();
+    }
+    const body = new Uint8Array(totalBytes);
+    let offset = 0;
+    for (const chunk of chunks) {
+        body.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return body;
+}
+// Reads a bounded UTF-8 response body.
+// Читает ограниченное UTF-8 тело ответа.
+export async function readBoundedResponseText(provider, response, maxBytes, options = {}) {
+    const body = await readBoundedResponseBytes(provider, response, maxBytes, options);
+    return new TextDecoder().decode(body);
+}
+function createOversizedResponseError(provider, maxBytes) {
+    return new ProviderError({
+        provider,
+        code: "PROVIDER_RESPONSE_TOO_LARGE",
+        message: `Provider "${provider}" response exceeded the ${maxBytes}-byte limit.`,
+        retryable: false,
+    });
+}
+function parseContentLength(value) {
+    if (value === null || !/^\d+$/.test(value.trim())) {
+        return undefined;
+    }
+    const length = Number(value);
+    return Number.isSafeInteger(length) ? length : undefined;
+}
+function assertPositiveByteLimit(maxBytes) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) {
+        throw new TypeError("Response body maxBytes must be a positive safe integer.");
+    }
+}
+async function cancelBody(body, reason) {
+    if (!body) {
+        return;
+    }
+    try {
+        await body.cancel(reason);
+    }
+    catch {
+        // Cancellation cleanup must not hide the original response error.
+    }
+}
+async function cancelReader(reader, reason) {
+    try {
+        await reader.cancel(reason);
+    }
+    catch {
+        // Cancellation cleanup must not hide the original response error.
+    }
+}
+//# sourceMappingURL=response-body.js.map

package/dist/shared/response-body.js.map

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

package/dist/shared/safe-fetch.d.ts

@@ -0,0 +1,14 @@
+export interface ResolvedAddress {
+    address: string;
+    family: 4 | 6;
+}
+export type HostnameResolver = (hostname: string) => Promise<ReadonlyArray<ResolvedAddress>>;
+export type PinnedHttpTransport = (url: URL, init: RequestInit, address: ResolvedAddress) => Promise<Response>;
+export interface HardenedProviderFetchOptions {
+    provider: string;
+    maxRedirects?: number;
+    resolver?: HostnameResolver;
+    transport?: PinnedHttpTransport;
+}
+export declare function createHardenedProviderFetch(options: HardenedProviderFetchOptions): (input: string | URL, init?: RequestInit) => Promise<Response>;
+export declare function isPublicIpAddress(address: string): boolean;

package/dist/shared/safe-fetch.js

@@ -0,0 +1,274 @@
+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]);
+// 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.");
+    }
+    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);
+            const location = REDIRECT_STATUSES.has(response.status)
+                ? response.headers.get("location")
+                : null;
+            if (!location) {
+                return response;
+            }
+            await cancelResponse(response);
+            if (redirects >= maxRedirects) {
+                throw createUnsafeTargetError(options.provider, "redirect limit exceeded");
+            }
+            url = normalizeExternalUrl(options.provider, new URL(location, url));
+        }
+    };
+}
+// 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) {
+    let lastError;
+    for (const address of addresses) {
+        try {
+            return await transport(url, init, address);
+        }
+        catch (error) {
+            if (init.signal?.aborted)
+                throw error;
+            lastError = error;
+        }
+    }
+    throw lastError ?? new Error("No validated provider address was available.");
+}
+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;