@torrent-tv/proxy 2.89.17 → 2.89.18

package/test/torrent-files.test.js

@@ -1,221 +0,0 @@
-/**
- * @file Which files of a torrent are one video file's sound and subtitles.
- *
- * The case these were written against is a real torrent, and every name below
- * is copied from it: `Drifters`, twelve episodes as `.mkv` in the root, twelve
- * Russian soundtracks as `.mka` under `Rus Sound/`, twelve subtitle files under
- * `Sub/[Stan WarHammer & Nesitach]/`, all sharing one base name per episode.
- *
- * The rule that matters most is the one about a torrent with SEVERAL videos: a
- * sidecar is taken only when its name pairs with this episode's, because a
- * wrong pairing would put the sound of episode 2 over the picture of episode 7
- * and nothing downstream could notice.
- */
-
-import test from "node:test";
-import assert from "node:assert/strict";
-import {
-  baseNameOf,
-  bracketTokensOf,
-  countVideoFiles,
-  extensionOf,
-  matchSidecarFiles,
-  namesPair,
-  splitTorrentPath
-} from "../services/torrent/files.js";
-
-/**
- * The Drifters torrent, as WebTorrent reports it: every path prefixed with the
- * torrent's own name.
- *
- * @param {number} episodes
- * @returns {Array<{ path: string, name: string, length: number }>}
- */
-function driftersFiles(episodes = 3) {
-  const files = [];
-  const push = (relative, length) => {
-    const name = relative.slice(relative.lastIndexOf("/") + 1);
-    files.push({ path: `Drifters/${relative}`, name, length });
-  };
-  for (let episode = 1; episode <= episodes; episode += 1) {
-    const stem = `[HorribleSubs] Drifters - ${String(episode).padStart(2, "0")} [1080p]`;
-    push(`Sub/[Stan WarHammer & Nesitach]/${stem}.ass`, 29_000);
-    push(`Rus Sound/${stem}.mka`, 30_000_000);
-    push(`${stem}.mkv`, 566_000_000);
-  }
-  return files;
-}
-
-test("a path is split into folders and a name, with the torrent's own name removed", () => {
-  const split = splitTorrentPath("Drifters/Rus Sound/[HorribleSubs] Drifters - 02 [1080p].mka", "Drifters");
-  assert.deepEqual(split.folders, ["Rus Sound"]);
-  assert.equal(split.name, "[HorribleSubs] Drifters - 02 [1080p].mka");
-});
-
-test("a path that does not begin with the torrent name is left alone", () => {
-  const split = splitTorrentPath("Sub/x.ass", "Drifters");
-  assert.deepEqual(split.folders, ["Sub"]);
-  assert.equal(split.name, "x.ass");
-});
-
-test("extension and base name", () => {
-  assert.equal(extensionOf("[HorribleSubs] Drifters - 02 [1080p].mka"), ".mka");
-  assert.equal(extensionOf("no-extension"), "");
-  assert.equal(extensionOf(".hidden"), "");
-  assert.equal(baseNameOf("a.b.mkv"), "a.b");
-});
-
-test("bracketed groups are read in order", () => {
-  assert.deepEqual(
-    bracketTokensOf("[HorribleSubs] Drifters - 02 [1080p]"),
-    ["HorribleSubs", "1080p"]
-  );
-  assert.deepEqual(bracketTokensOf("nothing here"), []);
-});
-
-test("equal base names pair, whatever folder each sits in", () => {
-  assert.equal(
-    namesPair("[HorribleSubs] Drifters - 02 [1080p].mka", "[HorribleSubs] Drifters - 02 [1080p].mkv"),
-    true
-  );
-  assert.equal(
-    namesPair("[HorribleSubs] Drifters - 03 [1080p].mka", "[HorribleSubs] Drifters - 02 [1080p].mkv"),
-    false
-  );
-});
-
-test("a shared release hash pairs two differently named files", () => {
-  assert.equal(namesPair("Ep01_rus [A1B2C3D4].mka", "[Group] Ep 01 [A1B2C3D4].mkv"), true);
-  assert.equal(namesPair("Ep01_rus [11112222].mka", "[Group] Ep 01 [A1B2C3D4].mkv"), false);
-});
-
-test("the sound and the subtitles of THIS episode are found, and no other's", () => {
-  const files = driftersFiles(3);
-  // Episode 2's picture: index 5 in the list built above.
-  const videoIndex = files.findIndex((file) => file.name === "[HorribleSubs] Drifters - 02 [1080p].mkv");
-  const matched = matchSidecarFiles({
-    files,
-    videoIndex,
-    torrentName: "Drifters",
-    videoCount: countVideoFiles(files)
-  });
-
-  assert.equal(matched.audio.length, 1);
-  assert.equal(matched.audio[0].name, "[HorribleSubs] Drifters - 02 [1080p].mka");
-  assert.deepEqual(matched.audio[0].folders, ["Rus Sound"]);
-  assert.equal(matched.audio[0].extension, ".mka");
-  // A `.mka` is Matroska, so its own track table can be read — which is the
-  // whole reason no new container class was needed for a separate soundtrack.
-  assert.equal(matched.audio[0].declaresTracks, true);
-
-  assert.equal(matched.subtitles.length, 1);
-  assert.equal(matched.subtitles[0].name, "[HorribleSubs] Drifters - 02 [1080p].ass");
-  assert.deepEqual(matched.subtitles[0].folders, ["Sub", "[Stan WarHammer & Nesitach]"]);
-});
-
-test("the picture itself is never its own sidecar", () => {
-  const files = driftersFiles(1);
-  const videoIndex = files.findIndex((file) => file.name.endsWith(".mkv"));
-  const matched = matchSidecarFiles({ files, videoIndex, torrentName: "Drifters", videoCount: 1 });
-  assert.equal(matched.audio.some((entry) => entry.fileIndex === videoIndex), false);
-});
-
-test("a torrent with one picture takes every sidecar, however it is named", () => {
-  const files = [
-    { path: "Film/Film.2019.1080p.mkv", name: "Film.2019.1080p.mkv", length: 5_000_000_000 },
-    { path: "Film/Rus.mka", name: "Rus.mka", length: 300_000_000 },
-    { path: "Film/subs/forced.srt", name: "forced.srt", length: 4_000 }
-  ];
-  const matched = matchSidecarFiles({
-    files,
-    videoIndex: 0,
-    torrentName: "Film",
-    videoCount: countVideoFiles(files)
-  });
-  assert.deepEqual(matched.audio.map((entry) => entry.name), ["Rus.mka"]);
-  assert.deepEqual(matched.subtitles.map((entry) => entry.name), ["forced.srt"]);
-});
-
-test("a torrent with several pictures does NOT take a sidecar that names none of them", () => {
-  const files = [
-    { path: "Pack/Ep01.mkv", name: "Ep01.mkv", length: 100 },
-    { path: "Pack/Ep02.mkv", name: "Ep02.mkv", length: 100 },
-    { path: "Pack/Sound/Something Else.mka", name: "Something Else.mka", length: 100 }
-  ];
-  const matched = matchSidecarFiles({
-    files,
-    videoIndex: 0,
-    torrentName: "Pack",
-    videoCount: countVideoFiles(files)
-  });
-  assert.deepEqual(matched.audio, []);
-});
-
-test("files of no interest are ignored", () => {
-  const files = [
-    { path: "X/film.mkv", name: "film.mkv", length: 100 },
-    { path: "X/film.nfo", name: "film.nfo", length: 10 },
-    { path: "X/cover.jpg", name: "cover.jpg", length: 10 }
-  ];
-  const matched = matchSidecarFiles({ files, videoIndex: 0, torrentName: "X", videoCount: 1 });
-  assert.deepEqual(matched.audio, []);
-  assert.deepEqual(matched.subtitles, []);
-  assert.deepEqual(
-    matched.images,
-    [],
-    "a stray cover is not THIS film's cover: the one-video relaxation does not reach images, " +
-      "because showing the wrong poster is a visible mistake where showing none is nothing"
-  );
-});
-
-test("a contact sheet named by the video's whole name is paired with it", () => {
-  // The shape a pack of a hundred videos actually ships: one sheet per video,
-  // named `<video file name>.jpg`. Its BASE name is `c0930.com_chijyo0073.wmv`,
-  // which no base-name rule would match against the video's `c0930…`.
-  const files = [
-    { path: "P/c0930.com_chijyo0073.wmv", name: "c0930.com_chijyo0073.wmv", length: 900 },
-    {
-      path: "P/Скринлисты/c0930.com_chijyo0073.wmv.jpg",
-      name: "c0930.com_chijyo0073.wmv.jpg",
-      length: 90
-    },
-    { path: "P/other.wmv", name: "other.wmv", length: 900 },
-    { path: "P/Скринлисты/other.wmv.jpg", name: "other.wmv.jpg", length: 90 }
-  ];
-
-  const matched = matchSidecarFiles({ files, videoIndex: 0, torrentName: "P", videoCount: 2 });
-
-  assert.equal(matched.images.length, 1, "its own sheet, and not the other video's");
-  assert.equal(matched.images[0].fileIndex, 1);
-  assert.deepEqual(matched.images[0].folders, ["Скринлисты"]);
-});
-
-test("a cover named like the film is paired with it, whatever its extension", () => {
-  const files = [
-    { path: "X/Film.2019.mkv", name: "Film.2019.mkv", length: 100 },
-    { path: "X/Film.2019.png", name: "Film.2019.png", length: 10 },
-    { path: "X/Film.2019.webp", name: "Film.2019.webp", length: 10 }
-  ];
-
-  const matched = matchSidecarFiles({ files, videoIndex: 0, torrentName: "X", videoCount: 1 });
-
-  assert.deepEqual(
-    matched.images.map((image) => image.name).sort(),
-    ["Film.2019.png", "Film.2019.webp"]
-  );
-});
-
-test("a raw elementary stream is recognised but declares no tracks of its own", () => {
-  const files = [
-    { path: "X/film.mkv", name: "film.mkv", length: 100 },
-    { path: "X/film.ac3", name: "film.ac3", length: 100 }
-  ];
-  const matched = matchSidecarFiles({ files, videoIndex: 0, torrentName: "X", videoCount: 1 });
-  assert.equal(matched.audio.length, 1);
-  assert.equal(matched.audio[0].declaresTracks, false);
-});
-
-test("pictures are counted, and nothing else is", () => {
-  assert.equal(countVideoFiles(driftersFiles(12)), 12);
-  assert.equal(countVideoFiles([{ name: "a.mka" }, { name: "b.srt" }]), 0);
-});

package/test/torrent-naming.test.js

@@ -1,255 +0,0 @@
-/**
- * @file The name grammar, checked against the forms its sources document.
- *
- * Every case here is an example one of the five surveyed players either prints
- * in its own documentation or handles in its own source. The survey and the
- * quotes are `research/sidecar-naming-conventions-2026-09-01.md`; the roadmap
- * item is 67.
- *
- * The rule these checks exist to hold: what the person who made the file wrote
- * is read, and nothing is guessed at. A token becomes a language only by being
- * in the table.
- */
-
-import test from "node:test";
-import assert from "node:assert/strict";
-
-import {
-  isNeutralWord,
-  languageFromFolderNames,
-  lookupLanguage,
-  nameFollows,
-  parseLanguageTag,
-  readSidecarName,
-  sidecarNaming,
-  tokenizeName
-} from "../services/torrent/naming.js";
-
-/**
- * Read a whole path against a known picture, the way the pairing does.
- *
- * `code` is `"und"` where nothing was read, which is the shape the browser is
- * given: a track that states no language is not a track with no language.
- *
- * @param {string} name - The sidecar's file name.
- * @param {string} [video] - The picture's file name.
- * @param {string} [relativePath] - The path, for the folders above the file.
- * @returns {{ code: string, group: string | null, isForced: boolean, isHearingImpaired: boolean, isDefault: boolean }}
- */
-function readPath(name, video = "Film.mkv", relativePath = name) {
-  const folders = String(relativePath).split("/").slice(0, -1);
-  const naming = sidecarNaming({ folders, fileName: name, videoName: video });
-  return { ...naming, code: naming.code ?? "und", group: naming.releaser };
-}
-
-/** Read a name against a known picture, the way the loader does. */
-function read(name, video = "Film.mkv") {
-  return readPath(name, video);
-}
-
-test("the dot-separated suffix, which is what every library writes", () => {
-  // Plex: "Movie_Name (Release Date).[Language_Code].ext", the code being
-  // "ISO-639-1 (2-letter) or ISO-639-2/B (3-letter)".
-  assert.equal(read("Film.en.srt").code, "en");
-  assert.equal(read("Film.eng.srt").code, "en");
-  assert.equal(read("Film.ru.srt").code, "ru");
-  assert.equal(read("Film.rus.srt").code, "ru");
-  // Kodi's own example: "The Matrix.English.srt".
-  assert.equal(read("Film.English.srt").code, "en");
-  assert.equal(read("Film.Russian.srt").code, "ru");
-});
-
-test("both ISO 639-2 sets, because the two disagree for about twenty languages", () => {
-  // Plex names the bibliographic set; ffmpeg and Matroska write either.
-  for (const [bibliographic, terminological, code] of [
-    ["ger", "deu", "de"], ["fre", "fra", "fr"], ["cze", "ces", "cs"],
-    ["chi", "zho", "zh"], ["dut", "nld", "nl"], ["gre", "ell", "el"],
-    ["per", "fas", "fa"], ["ice", "isl", "is"], ["may", "msa", "ms"],
-    ["rum", "ron", "ro"], ["slo", "slk", "sk"], ["alb", "sqi", "sq"],
-    ["arm", "hye", "hy"], ["baq", "eus", "eu"], ["bur", "mya", "my"],
-    ["geo", "kat", "ka"], ["mac", "mkd", "mk"], ["mao", "mri", "mi"],
-    ["tib", "bod", "bo"], ["wel", "cym", "cy"]
-  ]) {
-    assert.equal(lookupLanguage(bibliographic)?.code, code, bibliographic);
-    assert.equal(lookupLanguage(terminological)?.code, code, terminological);
-  }
-});
-
-test("a BCP-47 tag keeps its region, and Kodi's underscore form is accepted", () => {
-  // Kodi: "a BCP 47 tag (with - characters replaced with _)"; its own example
-  // is "The Matrix.zh_yue.srt".
-  assert.deepEqual(parseLanguageTag("pt-BR"), { code: "pt-BR", name: "Portuguese" });
-  assert.deepEqual(parseLanguageTag("pt_BR"), { code: "pt-BR", name: "Portuguese" });
-  assert.deepEqual(parseLanguageTag("zh_yue"), { code: "zh-yue", name: "Chinese" });
-  assert.deepEqual(parseLanguageTag("en-US"), { code: "en-US", name: "English" });
-  assert.equal(read("Film.pt-BR.srt").code, "pt-BR");
-  // A region is kept, so pt-BR and pt-PT stay apart on screen.
-  assert.notEqual(read("Film.pt-BR.srt").code, read("Film.pt-PT.srt").code);
-});
-
-test("a tag whose primary subtag is not a language is not a language", () => {
-  assert.equal(parseLanguageTag("web-dl"), null);
-  assert.equal(parseLanguageTag("x-264"), null);
-  assert.equal(parseLanguageTag("Upscale"), null);
-});
-
-test("the flags, with the spellings Jellyfin and mpv accept", () => {
-  assert.equal(read("Film.en.forced.srt").isForced, true);
-  assert.equal(read("Film.en.foreign.srt").isForced, true);
-  assert.equal(read("Film.en.sdh.srt").isHearingImpaired, true);
-  assert.equal(read("Film.en.cc.srt").isHearingImpaired, true);
-  assert.equal(read("Film.default.srt").isDefault, true);
-  // Jellyfin's own extended example: several flags on one file.
-  const both = read("Film.default.en.forced.ass");
-  assert.equal(both.code, "en");
-  assert.equal(both.isDefault, true);
-  assert.equal(both.isForced, true);
-});
-
-test("Kodi separates the forced flag with a dot, a space or a dash", () => {
-  // "The forced flag can be either upper, lower or mixed case in the filename
-  // and can use a '.' (dot), ' ' (space) or '-' (dash) to separate them".
-  assert.equal(read("Film.English.Forced.srt").isForced, true);
-  assert.equal(read("Film.English Forced.srt").isForced, true);
-  assert.equal(read("Film.English-Forced.srt").isForced, true);
-  assert.equal(read("Film.English Forced.srt").code, "en");
-});
-
-test("hi is Hindi alone and hearing-impaired beside another language", () => {
-  // Jellyfin: "`hi` by itself will resolve as a Hindi language track, while
-  // `hi` in conjunction with another language identifier … will use the other
-  // language and tag it as hearing impaired."
-  const hindi = read("Film.hi.srt");
-  assert.equal(hindi.code, "hi");
-  assert.equal(hindi.isHearingImpaired, false);
-
-  const impaired = read("Film.en.hi.srt");
-  assert.equal(impaired.code, "en");
-  assert.equal(impaired.isHearingImpaired, true);
-});
-
-test("the last language in the name wins", () => {
-  // Jellyfin: "If multiple languages are defined within the filename the last
-  // one will be used and the others ignored."
-  assert.equal(read("Film.en.ru.srt").code, "ru");
-  assert.equal(read("Film.ru.en.srt").code, "en");
-});
-
-test("a bracketed tail is read, and only through the table", () => {
-  // mpv takes `(` as the delimiter when the name ends `)`, `[` when it ends `]`.
-  assert.equal(read("Film (Russian).srt").code, "ru");
-  assert.equal(read("Film [rus].srt").code, "ru");
-  // And the case from the test torrents that a shape-based rule would ruin.
-  assert.equal(read("Gibo no Toiki - 01 (Upscale).ass").code, "und");
-  assert.equal(read("[HorribleSubs] Drifters - 03 [1080p].ass").code, "und");
-  // A bracketed tail does not stop the rest of the name being read.
-  assert.equal(read("Film.rus [1080p].srt").code, "ru");
-  assert.equal(read("Film.en.forced [x264].srt").code, "en");
-  assert.equal(read("Film.en.forced [x264].srt").isForced, true);
-});
-
-test("leftover text is the track's title", () => {
-  // Jellyfin: "Any arbitrary text not parsable to a language or flag will be
-  // combined and used as the title of the stream."
-  const info = read("Film.English Commentary.en.srt");
-  assert.equal(info.code, "en");
-  assert.equal(info.group, "English Commentary");
-  // The underscore form this project already read, unchanged.
-  assert.equal(read("Film_rus_AT_Team.srt").code, "ru");
-  assert.equal(read("Film_rus_AT_Team.srt").group, "AT Team");
-});
-
-test("a leftover that only describes the encode is not a title", () => {
-  // Jellyfin keeps every leftover word, and on a tidy library that is right.
-  // A torrent is not tidy: this would read as "Russian (1080p)".
-  assert.equal(read("Film.1080p.rus.srt").code, "ru");
-  assert.equal(read("Film.1080p.rus.srt").group, null);
-  assert.equal(read("Film.WEB-DL.x264.eng.srt").group, null);
-});
-
-test("the film's own name is never mined for a language", () => {
-  // Jellyfin parses only what follows the video's name, and this is why: `It`
-  // is Italian, and `Follows` is not a flag, so a reader that walked the whole
-  // name would call this Italian.
-  assert.equal(readPath("It.Follows.2014.srt", "It.Follows.2014.mkv").code, "und");
-  // With no picture to measure against, reading stops at the first token that
-  // is neither a flag nor a language — mpv's rule.
-  assert.equal(readPath("It.Follows.2014.srt", "").code, "und");
-  assert.equal(readPath("It.Follows.2014.rus.srt", "").code, "ru");
-});
-
-test("a folder states a language, or a kind of track, or a team", () => {
-  assert.equal(languageFromFolderNames(["RUS"])?.code, "ru");
-  assert.equal(languageFromFolderNames(["Rus Sub"])?.code, "ru");
-  assert.equal(languageFromFolderNames(["subs", "eng"])?.code, "en");
-  // VLC's own default search path — a place, not a language.
-  for (const folder of ["Subs", "subs", "Subtitles", "subtitles"]) {
-    assert.equal(languageFromFolderNames([folder]), null, folder);
-    assert.equal(isNeutralWord(folder), true, folder);
-  }
-  // A team's bracket is not a language either.
-  assert.equal(languageFromFolderNames(["Sub", "[Stan WarHammer & Nesitach]"]), null);
-});
-
-test("a Russian release names its folders in Russian", () => {
-  assert.equal(languageFromFolderNames(["Субтитры"]), null);
-  assert.equal(languageFromFolderNames(["Рус"])?.code, "ru");
-  assert.equal(languageFromFolderNames(["Русские субтитры"])?.code, "ru");
-  assert.equal(languageFromFolderNames(["Английские субтитры"])?.code, "en");
-  assert.equal(languageFromFolderNames(["Рус Звук"])?.code, "ru");
-  assert.equal(languageFromFolderNames(["Японские"])?.code, "ja");
-});
-
-test("the shapes the real test torrents carry still read as they did", () => {
-  // Measured 2026-09-01 over the 112 torrents in Dropbox/trn.
-  assert.equal(readPath("Enjo Kouhai_01.rus.ass", "Enjo Kouhai_01.mp4", "Enjo Kouhai/rus/Enjo Kouhai_01.rus.ass").code, "ru");
-  assert.equal(readPath("Enjo Kouhai_01.chi.ass", "Enjo Kouhai_01.mp4", "Enjo Kouhai/chi/Enjo Kouhai_01.chi.ass").code, "zh");
-  const drifters = readPath(
-    "[HorribleSubs] Drifters - 03 [1080p].ass",
-    "[HorribleSubs] Drifters - 03 [1080p].mkv",
-    "Sub/[Stan WarHammer & Nesitach]/[HorribleSubs] Drifters - 03 [1080p].ass"
-  );
-  assert.equal(drifters.code, "und");
-  assert.equal(drifters.group, "Stan WarHammer & Nesitach");
-});
-
-test("a soundtrack is read by the same grammar", () => {
-  // Jellyfin's own example set: Film.en.ac3 beside Film.german.ac3.
-  assert.equal(sidecarNaming({ folders: [], fileName: "Film.en.ac3", videoName: "Film.mkv" }).code, "en");
-  assert.equal(sidecarNaming({ folders: [], fileName: "Film.german.ac3", videoName: "Film.mkv" }).code, "de");
-  // The field case: the folder says Russian and the file carries only the
-  // picture's own brackets.
-  const dub = sidecarNaming({
-    folders: ["Rus Sound"],
-    fileName: "[HorribleSubs] Drifters - 02 [1080p].mka",
-    videoName: "[HorribleSubs] Drifters - 02 [1080p].mkv"
-  });
-  assert.equal(dub.code, "ru");
-  assert.equal(dub.releaser, null);
-});
-
-test("tokenizing is stable on names with nothing to say", () => {
-  assert.deepEqual(tokenizeName(""), []);
-  assert.deepEqual(readSidecarName("").language, null);
-  assert.deepEqual(readSidecarName("Film", "Film").language, null);
-});
-
-test("a name continues the video's only at a token boundary", () => {
-  // The rule that makes "begins with the video's name" safe. Without it
-  // `Film.20.rus.srt` reads as belonging to `Film.2.mkv` — measured 2026-09-04
-  // against the browser's own rule, which had no boundary — and the grammar
-  // then reports the leftover `0` as the track's title, which is the tell that
-  // the remainder is a fragment of another film's name.
-  assert.equal(nameFollows("Film.2", "Film.2"), true, "the same name continues itself");
-  assert.equal(nameFollows("Film.2.rus", "Film.2"), true);
-  assert.equal(nameFollows("Film.20.rus", "Film.2"), false, "another film, one digit longer");
-  assert.equal(nameFollows("Film_rus", "Film"), true);
-  assert.equal(nameFollows("Film-rus", "Film"), true);
-  assert.equal(nameFollows("Film rus", "Film"), true);
-  // mpv's bracket forms.
-  assert.equal(nameFollows("Film (Russian)", "Film"), true);
-  assert.equal(nameFollows("Film [rus]", "Film"), true);
-  // Nothing to measure against, and nothing to continue.
-  assert.equal(nameFollows("Film.rus", ""), false);
-  assert.equal(nameFollows("Fil", "Film"), false);
-});