@torrent-tv/proxy 2.89.17 → 2.89.18

package/test/subtitle-cursor.test.js

@@ -1,63 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-
-/**
- * The rule this pins: a subtitle cursor counts the order cues were FOUND, not
- * where they sit in the film.
- *
- * Cues are read out of whichever clusters happen to be downloaded, and a
- * torrent does not arrive in film order — a seek pulls a later stretch first,
- * and the earlier one fills in afterwards. So the set of known cues grows in
- * the MIDDLE as well as at the end.
- *
- * A cursor in film time cannot survive that: measured 2026-08-20 on a viewer at
- * 272 s, one answer carried cues out to 1176 s, and from that moment every cue
- * between the two was filtered away for the rest of the session — the stretch
- * they were about to watch. 59 of 276 clusters had been read.
- *
- * The filter below is the route's, written out so the property can be checked
- * without a torrent: `?since=<n>` selects by found-order, `?after=<seconds>` is
- * the old behaviour kept for an older browser.
- */
-const bySince = (cues, since) => cues.filter((cue) => (Number(cue.seq) || 0) > since);
-const byAfter = (cues, after) => cues.filter((cue) => cue.startSeconds > after);
-
-/** A late-arriving cluster from EARLIER in the film than what is already held. */
-const held = [
-  { startSeconds: 40, text: "found first, early in the film", seq: 1 },
-  { startSeconds: 1176, text: "found second, far ahead", seq: 2 },
-  { startSeconds: 300, text: "found third, behind the furthest held", seq: 3 }
-];
-
-test("a cue found after a further-ahead one is still delivered", () => {
-  // The browser holds seq 1 and 2 and asks for what came after.
-  const fresh = bySince(held, 2);
-  assert.deepEqual(fresh.map((cue) => cue.startSeconds), [300]);
-});
-
-test("the same case in film time loses that cue for ever", () => {
-  // This is what shipped in 2.43.1 and what the field session showed: the
-  // browser's furthest cue is 1176 s, so the 300 s cue can never reach it.
-  const fresh = byAfter(held, 1176);
-  assert.deepEqual(fresh.map((cue) => cue.startSeconds), []);
-});
-
-test("a browser asking for the first time is sent everything", () => {
-  assert.equal(bySince(held, 0).length, 3);
-});
-
-test("nothing new is answered with nothing", () => {
-  assert.deepEqual(bySince(held, 3), []);
-});
-
-test("the cursor to send back is the highest found-order held", () => {
-  const cursor = held.reduce((highest, cue) => Math.max(highest, Number(cue.seq) || 0), 0);
-  assert.equal(cursor, 3);
-});
-
-test("a cursor is unaffected by the order cues are sorted into", () => {
-  // The list is kept in film order for the WebVTT it becomes; the cursor must
-  // not depend on that.
-  const sorted = [...held].sort((left, right) => left.startSeconds - right.startSeconds);
-  assert.deepEqual(bySince(sorted, 2).map((cue) => cue.startSeconds), [300]);
-});

package/test/subtitle-defaults.test.js

@@ -1,118 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { Container } from "../services/media/container/Container.js";
-
-test("a flag the container wrote is carried through, and one it did not is not", () => {
-  const banner = [
-    { index: 0, language: "rus", title: "Forced", isDefault: true },
-    { index: 1, language: "eng", title: "SDH", isDefault: true }
-  ];
-  const declared = [
-    { language: "rus", name: "Forced", isDefault: true, declaresDefault: true },
-    { language: "eng", name: "SDH", isDefault: true, declaresDefault: false }
-  ];
-  const merged = Container.mergeSubtitleFlags(banner, declared);
-  assert.equal(merged.aligned, true);
-  assert.deepEqual(
-    merged.tracks.map((track) => [track.isDefault, track.declaresDefault]),
-    [[true, true], [true, false]]
-  );
-});
-
-test("a file that wrote nothing is reported as having written nothing, though ffmpeg marked everything", () => {
-  // This is the case the banner cannot express: `FlagDefault` defaults to 1, so
-  // ffmpeg prints `(default)` against every track of a file that chose none.
-  const banner = [
-    { index: 0, language: "rus", title: "", isDefault: true },
-    { index: 1, language: "eng", title: "", isDefault: true }
-  ];
-  const declared = [
-    { language: "rus", name: "", isDefault: true, declaresDefault: false },
-    { language: "eng", name: "", isDefault: true, declaresDefault: false }
-  ];
-  const merged = Container.mergeSubtitleFlags(banner, declared);
-  assert.equal(merged.aligned, true);
-  assert.deepEqual(merged.tracks.map((track) => track.declaresDefault), [false, false]);
-});
-
-test("the container's own answer overrides the banner's, in both directions", () => {
-  const banner = [
-    { index: 0, language: "rus", title: "a", isDefault: true },
-    { index: 1, language: "eng", title: "b", isDefault: false }
-  ];
-  const declared = [
-    { language: "rus", name: "a", isDefault: false, declaresDefault: true },
-    { language: "eng", name: "b", isDefault: true, declaresDefault: true }
-  ];
-  const merged = Container.mergeSubtitleFlags(banner, declared);
-  assert.deepEqual(merged.tracks.map((track) => track.isDefault), [false, true]);
-});
-
-test("a count that differs means the two readings are not the same list", () => {
-  // The container declares a picture track the probe did not report; position
-  // is then not the correspondence and nothing may be read across.
-  const banner = [{ index: 0, language: "rus", title: "", isDefault: true }];
-  const declared = [
-    { language: "rus", name: "", isDefault: false, declaresDefault: true },
-    { language: "eng", name: "", isDefault: true, declaresDefault: true }
-  ];
-  const merged = Container.mergeSubtitleFlags(banner, declared);
-  assert.equal(merged.aligned, false);
-  assert.match(merged.reason, /declares 2 subtitle tracks and the probe found 1/);
-  assert.deepEqual(merged.tracks.map((track) => [track.isDefault, track.declaresDefault]), [[true, false]]);
-});
-
-test("a pair agreeing on neither language nor name refuses the whole alignment", () => {
-  const banner = [
-    { index: 0, language: "rus", title: "", isDefault: true },
-    { index: 1, language: "eng", title: "", isDefault: true }
-  ];
-  const declared = [
-    { language: "eng", name: "", isDefault: true, declaresDefault: true },
-    { language: "rus", name: "", isDefault: false, declaresDefault: true }
-  ];
-  const merged = Container.mergeSubtitleFlags(banner, declared);
-  assert.equal(merged.aligned, false);
-  assert.deepEqual(merged.tracks.map((track) => track.declaresDefault), [false, false]);
-});
-
-test("a container that declares nothing leaves the banner alone", () => {
-  const banner = [{ index: 0, language: "rus", title: "", isDefault: true }];
-  const merged = Container.mergeSubtitleFlags(banner, []);
-  assert.equal(merged.aligned, false);
-  assert.equal(merged.tracks[0].isDefault, true);
-  assert.equal(merged.tracks[0].declaresDefault, false);
-});
-
-test("an implicit Matroska English default does not become the subtitle language", () => {
-  const banner = [{ index: 0, language: "eng", title: "", isDefault: true }];
-  const declared = [{ language: "", languageBcp47: "", declaresLanguage: false, name: "" }];
-
-  const merged = Container.mergeSubtitleFlags(banner, declared);
-
-  assert.equal(merged.aligned, true);
-  assert.equal(merged.tracks[0].language, "");
-  assert.equal(merged.tracks[0].declaresLanguage, false);
-});
-
-test("an explicitly declared subtitle language is retained", () => {
-  const banner = [{ index: 0, language: "rus", title: "", isDefault: true }];
-  const declared = [{ language: "rus", languageBcp47: "", declaresLanguage: true, name: "" }];
-
-  const merged = Container.mergeSubtitleFlags(banner, declared);
-
-  assert.equal(merged.tracks[0].language, "rus");
-  assert.equal(merged.tracks[0].declaresLanguage, true);
-});
-
-test("a name confirms a pairing when the languages are unstated", () => {
-  assert.equal(Container.pairingHolds({ language: "und", title: "Forced" }, { language: "", name: "Forced" }), true);
-});
-
-test("two tracks that say nothing about themselves do not break the alignment", () => {
-  assert.equal(Container.pairingHolds({ language: "und", title: "" }, { language: "", name: "" }), true);
-});
-
-test("a stated language that differs is a disagreement", () => {
-  assert.equal(Container.pairingHolds({ language: "rus", title: "" }, { language: "eng", name: "" }), false);
-});

package/test/subtitle-language.test.js

@@ -1,252 +0,0 @@
-/**
- * @file What the language detector is FED.
- *
- * Field 2026-09-01: a Russian subtitle file was offered to the viewer as
- * `English (Stan WarHammer & Nesitach)`. The detector was not at fault — it was
- * handed the raw `.ass` file, which is half Latin markup, while the markup-free
- * WebVTT it was about to serve sat in the variable beside it. Measured on that
- * file: 5040 Latin characters against 5983 Cyrillic, `franc(the file) = eng`,
- * `franc(the dialogue) = rus`.
- * `research/subtitle-language-ass-markup-2026-09-01.md`.
- *
- * These checks pin the input at each of the three places a language is read.
- *
- * **On the size of the fixtures.** franc's answer among the Cyrillic languages
- * is not stable on a small sample: measured 2026-09-01 by growing one Russian
- * text line by line, it answered `bul` at 129 characters, `srp` at 158, 241 and
- * `bul` again at 292, then `rus` at every length from 337 to 881. So the
- * dialogue here is ~880 Cyrillic characters — past that boundary by a factor of
- * about 2.6, and still an order of magnitude below a real episode's 5983. The
- * fixtures are NOT sized to make these checks pass; they are sized to resemble
- * the thing. That instability is a separate defect and is recorded as one.
- */
-
-import test from "node:test";
-import assert from "node:assert/strict";
-
-import { detectLanguage } from "../services/media/tracks/language-detect.js";
-import { SubtitleFileContainer } from "../services/media/container/SubtitleFileContainer.js";
-import { TextSubtitleTrack } from "../services/media/tracks/TextSubtitleTrack.js";
-import { MatroskaContainer } from "../services/media/container/MatroskaContainer.js";
-
-/** Varied Russian dialogue, the length a few minutes of an episode carries. */
-const RUSSIAN_DIALOGUE = [
-  "Ты видишь их?",
-  "Да.",
-  "Но не столько вижу, сколько чувствую.",
-  "Скорее всего, они будут здесь с минуты на минуту.",
-  "Почему господа октябристы решили напасть именно сейчас?",
-  "Им никогда не преодолеть эти стены.",
-  "Мы держали эту крепость три года и продержим ещё столько же.",
-  "Готовьте лучников на восточной стороне.",
-  "Если они подойдут ближе, мы откроем огонь без предупреждения.",
-  "Я не собираюсь умирать здесь, в этой богом забытой дыре.",
-  "Тогда возьми меч и вставай рядом со мной.",
-  "Сколько у нас осталось воды и хлеба?",
-  "На неделю, если не считать раненых.",
-  "Раненых считать придётся, они тоже люди.",
-  "Отправь гонца к южным воротам и передай приказ отступать.",
-  "Он не успеет, дорога перерезана ещё вчера вечером.",
-  "Значит пойду сам, а ты останешься за меня командовать.",
-  "Это безумие, и ты прекрасно об этом знаешь.",
-  "Безумие — это сидеть и ждать, пока нас перебьют по одному.",
-  "Хорошо. Но возьми с собой хотя бы двоих.",
-  "Двоих я возьму. Больше не могу себе позволить.",
-  "Береги себя. Мы будем держать стену до последнего.",
-  "Я знаю. Именно поэтому я и ухожу спокойно.",
-  "Смотри, дым над лесом. Они уже жгут деревни.",
-  "Тогда времени у нас меньше, чем мы думали."
-];
-
-/** `hh:mm:ss.cc` for the ASS `Start`/`End` fields. */
-function assTime(seconds) {
-  const mm = String(Math.floor(seconds / 60)).padStart(2, "0");
-  const ss = String(seconds % 60).padStart(2, "0");
-  return `0:${mm}:${ss}.00`;
-}
-
-/**
- * An ASS file in the shape a fansub release ships: an Aegisub header, a styles
- * section with English font and style names, and Russian dialogue carrying
- * override groups. Modelled on the field file.
- */
-const RUSSIAN_ASS = `[Script Info]
-Title: Default Aegisub file
-ScriptType: v4.00+
-PlayResX: 1280
-PlayResY: 720
-Original Translation: Nesitach
-Original Editing: Stan WarHammer
-WrapStyle: 0
-ScaledBorderAndShadow: no
-Video Aspect Ratio: c1.77778
-YCbCr Matrix: TV.601
-Aegisub Video Aspect Ratio: c1.777778
-
-[Aegisub Project Garbage]
-Last Style Storage: Default
-Audio File: [HorribleSubs] Drifters - 03 [720p].mkv
-Video File: [HorribleSubs] Drifters - 03 [720p].mkv
-Video AR Mode: 4
-Video AR Value: 1.777778
-Video Zoom Percent: 0.600000
-Scroll Position: 256
-Active Line: 257
-Video Position: 33159
-
-[V4+ Styles]
-Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding
-Style: Default,Trebuchet MS,54,&H00FFFFFF,&H000000FF,&H00000000,&H00000000,0,0,0,0,100,100,0,0,1,2.5,1.5,2,20,20,25,1
-Style: Signs,Times New Roman,48,&H00FFFF00,&H000000FF,&H00202020,&H00000000,-1,0,0,0,100,100,0,0,1,2,1,8,20,20,20,1
-Style: Italics,Trebuchet MS Italic,54,&H00FFFFFF,&H000000FF,&H00000000,&H00000000,0,-1,0,0,100,100,0,0,1,2.5,1.5,2,20,20,25,1
-
-[Events]
-Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
-${RUSSIAN_DIALOGUE.map((line, index) => {
-    const style = index % 7 === 6 ? "Signs" : "Default";
-    const tag = index % 5 === 4 ? "{\\pos(640,620)}" : "";
-    return `Dialogue: 0,${assTime(index * 4)},${assTime(index * 4 + 3)},${style},,0,0,0,,${tag}${line}`;
-  }).join("\n")}
-`;
-
-test("a Russian .ass is reported as Russian, and its markup does not reach the detector", () => {
-  const vtt = SubtitleFileContainer.toVtt(RUSSIAN_ASS, ".ass");
-  assert.ok(vtt.startsWith("WEBVTT"), "the conversion produced a WebVTT document");
-
-  const spoken = TextSubtitleTrack.cueTextOfVtt(vtt);
-  // Every one of these is a piece of the file the viewer never reads, and each
-  // was competing with the dialogue for the detector's answer.
-  for (const markup of [
-    "Aegisub", "Script Info", "V4+ Styles", "Format:", "Dialogue:",
-    "Trebuchet MS", "Times New Roman", "Default", "Signs", "pos(",
-    "-->", "0:00:12"
-  ]) {
-    assert.ok(!spoken.includes(markup), `cue text still carries "${markup}"`);
-  }
-  assert.ok(spoken.includes("Ты видишь их?"), "cue text keeps the dialogue");
-
-  assert.deepEqual(TextSubtitleTrack.detectLanguageFromVtt(vtt), { code: "ru", name: "Russian" });
-});
-
-test("the fixture is the hard case: the file itself is nearly half Latin", () => {
-  // Not an assertion about franc — an assertion that this fixture reproduces the
-  // field file's proportions. A fixture whose markup were negligible would pass
-  // the check above with or without the fix.
-  const cyrillic = (RUSSIAN_ASS.match(/[Ѐ-ӿ]/gu) ?? []).length;
-  const latin = (RUSSIAN_ASS.match(/[A-Za-z]/g) ?? []).length;
-  assert.ok(cyrillic > 800, `too little dialogue: ${cyrillic} Cyrillic characters`);
-  assert.ok(latin > cyrillic * 0.5, `markup too small to reproduce the fault: ${latin} vs ${cyrillic}`);
-});
-
-test("cue identifiers, NOTE, STYLE and REGION blocks are not text", () => {
-  const vtt = [
-    "WEBVTT - This file has cues.",
-    "Kind: captions",
-    "Language: en",
-    "",
-    "NOTE",
-    "Translated by an English speaking volunteer, all rights reserved.",
-    "",
-    "STYLE",
-    "::cue { background-image: linear-gradient(to bottom, dimgray, lightgray); }",
-    "",
-    "REGION",
-    "id:speaker width:40% lines:3 regionanchor:0%,100%",
-    "",
-    "opening-line",
-    "00:00:12.060 --> 00:00:13.270 align:start position:0%",
-    "<v Тоёхиса>Ты видишь их?</v>",
-    "",
-    "2",
-    "00:00:15.400 --> 00:00:16.650",
-    "<i>Но не столько вижу,</i>",
-    "сколько чувствую &amp; ощущаю.",
-    ""
-  ].join("\n");
-
-  const spoken = TextSubtitleTrack.cueTextOfVtt(vtt);
-  assert.equal(
-    spoken,
-    "Ты видишь их?\nНо не столько вижу,\nсколько чувствую   ощущаю."
-  );
-});
-
-test("a document with no cues yields no language rather than a guess", () => {
-  assert.equal(TextSubtitleTrack.cueTextOfVtt("WEBVTT\n"), "");
-  assert.equal(TextSubtitleTrack.detectLanguageFromVtt("WEBVTT\n"), null);
-  assert.equal(TextSubtitleTrack.detectLanguageFromVtt(null), null);
-});
-
-test("an embedded ASS cue is unframed by the container, then read", () => {
-  // What a Matroska block actually holds, per
-  // `matroska.org/technical/subtitles.html`: "Events are stored in the Block in
-  // this order: ReadOrder, Layer, Style, Name, MarginL, MarginR, MarginV,
-  // Effect, Text", with Start and End taken out into the block's own timing.
-  // Eight fields, and the earlier fixture here wrongly carried ten — it kept
-  // the two timestamps a FILE has, which is why it passed while the field
-  // subtitles of a real `.mkv` were shown to the viewer whole.
-  const blocks = RUSSIAN_DIALOGUE.map((line, index) => Buffer.from(
-    `${index + 1},0,Default,,0000,0000,0000,,` +
-    `${index % 5 === 4 ? "{\\pos(640,620)}" : ""}${line}`,
-    "utf8"
-  ));
-
-  const cues = blocks.map((payload, index) => ({
-    startSeconds: index * 4,
-    endSeconds: index * 4 + 3,
-    text: MatroskaContainer.cueTextOf(payload, "S_TEXT/ASS")
-  }));
-
-  const spoken = TextSubtitleTrack.finalizeCues(cues, "S_TEXT/ASS").map((cue) => cue.text).join("\n");
-  assert.ok(!spoken.includes("Default"), "the style field survived into the text");
-  assert.ok(!spoken.includes("0000"), "a margin field survived into the text");
-  assert.ok(!spoken.includes("pos("), "an override group survived into the text");
-  assert.deepEqual(detectLanguage(spoken), { code: "ru", name: "Russian" });
-});
-
-test("too little text is answered with nothing, not with a guess", () => {
-  // Measured 2026-09-02 (`research/franc-boundary-2026-09-02.md`): franc's
-  // answer for Russian walks between Bulgarian, Serbian and Russian until about
-  // 650 characters. Below that the honest answer is none — the browser then
-  // shows "Unknown", and the label moves when enough of the file has arrived.
-  const short = RUSSIAN_DIALOGUE.slice(0, 6).join("\n");
-  assert.ok(short.length < 300, `the fixture must be short: ${short.length}`);
-  assert.equal(detectLanguage(short), null);
-
-  const long = RUSSIAN_DIALOGUE.join("\n");
-  assert.ok(long.length > 650, `the fixture must be long enough: ${long.length}`);
-  assert.deepEqual(detectLanguage(long), { code: "ru", name: "Russian" });
-});
-
-test("an answer that does not survive losing half the text is not an answer", () => {
-  // A file carrying two languages — a bilingual release, or a track that turns
-  // into signs-only English partway. franc answers something for the whole; the
-  // halves disagree with it, and that disagreement is the text saying the
-  // answer rests on where it happened to be cut.
-  const english = [
-    "Do you see them out there beyond the wall?",
-    "I do, though not as clearly as I would like to.",
-    "They have been gathering since the morning came.",
-    "We should send word to the southern gate at once.",
-    "The road was cut yesterday and no rider will pass.",
-    "Then we hold what we have and wait for the dawn."
-  ].join("\n");
-  const mixed = `${RUSSIAN_DIALOGUE.slice(0, 13).join("\n")}\n${english}`;
-  assert.equal(detectLanguage(mixed), null);
-});
-
-test("a WebVTT body is decoded whole, so no character is cut in half", () => {
-  // The ffmpeg extraction path used to detect on `String(body.subarray(0, 4096))`.
-  // Two faults: a byte cut lands mid-character on any non-Latin track, and most
-  // of those bytes are timestamps rather than words. Cyrillic is two bytes per
-  // character in UTF-8, so 4096 bytes of this document is a few hundred
-  // characters of dialogue — inside the unstable region measured above.
-  const cues = RUSSIAN_DIALOGUE.map((line, index) => {
-    const start = `00:00:${String(index * 2).padStart(2, "0")}.000`;
-    const end = `00:00:${String(index * 2 + 1).padStart(2, "0")}.000`;
-    return `${start} --> ${end}\n${line}`;
-  });
-  const body = Buffer.from(`WEBVTT\n\n${cues.join("\n\n")}\n`, "utf8");
-
-  assert.deepEqual(TextSubtitleTrack.detectLanguageFromVtt(body.toString("utf8")), { code: "ru", name: "Russian" });
-});

package/test/subtitle-metadata.test.js

@@ -1,15 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { SubtitleFileContainer } from "../services/media/container/SubtitleFileContainer.js";
-
-const ass = `[Script Info]\nTitle: Princess Mononoke\nYear: 1997\nMovie Title: Princess Mononoke\nScript Updated By: 2026\n\n[Events]\nFormat: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text\nDialogue: 0,0:00:01.00,0:00:02.00,Default,,0,0,0,,Hello`;
-test("ASS header evidence survives conversion without changing cues", () => {
-  const vtt = SubtitleFileContainer.toVtt(ass, ".ass");
-  const json = vtt.match(/NOTE TORRENT-TV-METADATA\n([^\n]+)/u)[1];
-  assert.deepEqual(JSON.parse(json), { titles: ["Princess Mononoke"], genericTitles: ["Princess Mononoke"], years: [1997] });
-  assert.match(vtt, /00:00:01.000 --> 00:00:02.000\nHello/u);
-});
-test("metadata is bounded and dialogue is not scanned", () => {
-  const vtt = SubtitleFileContainer.toVtt(ass.replace("[Script Info]", "[Other]").replace("Hello", "Movie Title: Another film"), ".ass");
-  assert.equal(vtt.includes("NOTE TORRENT-TV-METADATA"), false);
-});

package/test/subtitle-plan-waits.test.js

@@ -1,125 +0,0 @@
-/**
- * @file The subtitle plan is kept only once it has been read; a plan whose
- * read finishes later serves the same pass; and cues the container takes back
- * leave by the numbers they were sent under.
- *
- * Fakes only: a stand-in container and a held file of plain functions.
- */
-
-import test from "node:test";
-import assert from "node:assert/strict";
-
-import { cuesHeldFor, forgetSubtitles, subtitleTracksOf, warmSubtitleCues } from "../services/media/SubtitleCues.js";
-import { BytesUnavailable } from "../services/media/container/unavailable.js";
-
-const PLAN = {
-  tracks: [{ trackNumber: 2, declaredIndex: 0, codecId: "S_TEXT/UTF8", language: "eng", languageSource: "default", clusterPositions: [] }],
-  declared: [],
-  secondsPerTick: 0.001,
-  segmentDataOffset: 0
-};
-
-function heldFile(sourceKey, container) {
-  return {
-    sourceKey,
-    fileIndex: 0,
-    name: "film.mkv",
-    length: 1000,
-    container: async () => container(),
-    heldRanges: async () => [[0, 999]],
-    readHeld: async () => Buffer.alloc(0)
-  };
-}
-
-test("a plan whose bytes have not arrived is not kept; the next ask reads it", async () => {
-  const sourceKey = "p".repeat(40);
-  forgetSubtitles(sourceKey);
-  let here = false;
-  const container = () => {
-    if (!here) {
-      throw new BytesUnavailable(900, 999, 0);
-    }
-    return { readSubtitlePlan: async () => PLAN, readHeldCues: async () => ({ found: new Map(), covered: 0, indexed: 0, withdrawn: [] }) };
-  };
-  try {
-    assert.deepEqual(await subtitleTracksOf(heldFile(sourceKey, container)), []);
-    here = true;
-    const tracks = await subtitleTracksOf(heldFile(sourceKey, container));
-    assert.deepEqual(tracks.map((track) => [track.trackNumber, track.language, track.languageSource]), [[2, "eng", "default"]]);
-  } finally {
-    forgetSubtitles(sourceKey);
-  }
-});
-
-test("a plan read that finishes later serves the pass that asked, with no further arrival", async () => {
-  const sourceKey = "q".repeat(40);
-  forgetSubtitles(sourceKey);
-  let release;
-  let walks = 0;
-  const arrived = new Promise((resolve) => {
-    release = resolve;
-  });
-  const container = {
-    readSubtitlePlan: async () => {
-      await arrived;
-      return PLAN;
-    },
-    // A cluster is read once: the first pass finds the line, later ones nothing.
-    readHeldCues: async () => {
-      walks += 1;
-      return {
-        found: walks === 1 ? new Map([[2, [{ startSeconds: 1, endSeconds: 2, text: "line", source: 77 }]]]) : new Map(),
-        covered: 1,
-        indexed: 1,
-        withdrawn: []
-      };
-    }
-  };
-  try {
-    // The file is one somebody asked about: a browser's seed is under way.
-    const seed = cuesHeldFor(heldFile(sourceKey, () => container), 2);
-    const warm = warmSubtitleCues(heldFile(sourceKey, () => container));
-    release();
-    await seed;
-    const entries = await warm;
-    assert.equal(entries.length, 1, "the one pass pushed what the plan led to");
-    assert.deepEqual(entries[0].cues.map((cue) => [cue.text, cue.seq]), [["line", 1]]);
-  } finally {
-    forgetSubtitles(sourceKey);
-  }
-});
-
-test("cues read from a position the container withdraws are taken back by their numbers", async () => {
-  const sourceKey = "r".repeat(40);
-  forgetSubtitles(sourceKey);
-  let passNumber = 0;
-  const container = {
-    readSubtitlePlan: async () => PLAN,
-    readHeldCues: async () => {
-      passNumber += 1;
-      return passNumber === 1
-        ? {
-            found: new Map([[2, [
-              { startSeconds: 1, endSeconds: 2, text: "real", source: 10 },
-              { startSeconds: 3, endSeconds: 4, text: "false", source: 50 }
-            ]]]),
-            covered: 2,
-            indexed: 2,
-            withdrawn: []
-          }
-        : { found: new Map(), covered: 1, indexed: 1, withdrawn: [50] };
-    }
-  };
-  try {
-    await subtitleTracksOf(heldFile(sourceKey, () => container));
-    const first = await warmSubtitleCues(heldFile(sourceKey, () => container));
-    assert.deepEqual(first[0].cues.map((cue) => [cue.text, cue.seq]), [["real", 1], ["false", 2]]);
-    const second = await warmSubtitleCues(heldFile(sourceKey, () => container));
-    assert.deepEqual(second[0].withdrawn, [2], "the false cue is named by the number it was sent under");
-    assert.deepEqual(second[0].cues, []);
-    const held = await cuesHeldFor(heldFile(sourceKey, () => container), 2);
-    assert.deepEqual(held.cues.map((cue) => cue.text), ["real"], "and it is gone from what is held");
-  } finally {
-    forgetSubtitles(sourceKey);
-  }
-});