@torrent-tv/proxy 2.89.6 → 2.89.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/AGENTS.md +32 -12
  2. package/CHANGELOG.md +2340 -2330
  3. package/assets/calibration/audio/NOTICE.md +19 -19
  4. package/assets/calibration/audio/manifest.json +98 -98
  5. package/biome.json +412 -412
  6. package/docs/browser-proxy-contract.md +155 -155
  7. package/docs/container-architecture.md +273 -273
  8. package/docs/encode-run-state.md +1 -1
  9. package/docs/playback-start-forecast.md +113 -98
  10. package/package.json +51 -50
  11. package/routes/api/sources/files/get.js +106 -106
  12. package/scripts/build-audio-samples.mjs +31 -31
  13. package/services/encode/EncodeRun.js +67 -15
  14. package/services/encode/EncodeRuns.js +19 -7
  15. package/services/encode/OutputOpening.js +784 -784
  16. package/services/encode/audio-calibration.js +67 -67
  17. package/services/encode/audio-work-rate.js +15 -15
  18. package/services/encode/encode-exit.js +2 -0
  19. package/services/encode/hwaccel.js +1894 -1894
  20. package/services/encode/output/index.js +24 -24
  21. package/services/encode/piece-completeness.js +60 -2
  22. package/services/encode/run-command.js +757 -755
  23. package/services/encode/segment-formats/index.js +1 -0
  24. package/services/encode/segment-formats/mp4-boxes.js +8 -1
  25. package/services/media/ContainerOrchestrator.js +202 -202
  26. package/services/media/KeyframeTables.js +356 -356
  27. package/services/media/SubtitleCues.js +592 -592
  28. package/services/media/audio-inventory.js +299 -299
  29. package/services/media/container/AviContainer.js +268 -268
  30. package/services/media/container/Container.js +632 -632
  31. package/services/media/container/ContainerFactory.js +38 -38
  32. package/services/media/container/MatroskaContainer.js +1031 -1031
  33. package/services/media/container/Mp4Container.js +1354 -1354
  34. package/services/media/container/SubtitleFileContainer.js +339 -339
  35. package/services/media/container/ebml-stream.js +174 -174
  36. package/services/media/container/matroska-clusters.js +1165 -1165
  37. package/services/media/container/unavailable.js +77 -77
  38. package/services/media/tracks/ContainerTrack.js +84 -84
  39. package/services/media/tracks/TextSubtitleTrack.js +295 -295
  40. package/services/storage/piece-store/shared-piece-store.js +1937 -1937
  41. package/services/storage/segment-store/SegmentStore.js +1294 -1294
  42. package/services/torrent/Contents.js +382 -382
  43. package/services/torrent/episode-naming.js +182 -182
  44. package/services/torrent/torrent-pool.js +2688 -2688
  45. package/services/torrent/worker/client.js +836 -836
  46. package/services/torrent/worker/held-bytes.js +231 -231
  47. package/services/torrent/worker/worker.js +1137 -1137
  48. package/services/transport/data-channel-handler.js +1373 -1373
  49. package/services/viewer/PriorityMap.js +421 -421
  50. package/test/audio-calibration.test.js +23 -23
  51. package/test/auto-quality-step.test.js +762 -762
  52. package/test/coalesce.test.js +39 -39
  53. package/test/coverage-follows-the-disk.test.js +5 -0
  54. package/test/decode-cost.test.js +475 -475
  55. package/test/encode-run.test.js +58 -0
  56. package/test/episode-naming.test.js +131 -131
  57. package/test/failed-encoder-still-serves-what-exists.test.js +1 -1
  58. package/test/fixtures/audio-frame-boundary.json +1 -1
  59. package/test/fixtures/refused-audio-20261002.json +10 -0
  60. package/test/fmp4-presentation-clock.test.js +4 -2
  61. package/test/format-keyed-outputs.test.js +78 -78
  62. package/test/health-metrics.test.js +11 -13
  63. package/test/held-read-ownership.test.js +77 -77
  64. package/test/helpers/encode-run.js +14 -6
  65. package/test/helpers/held-file.js +77 -77
  66. package/test/helpers/manager.js +62 -62
  67. package/test/helpers/matroska-file.js +296 -296
  68. package/test/keyframe-table-budget.test.js +123 -123
  69. package/test/matroska-cluster-discovery.test.js +323 -323
  70. package/test/one-output-one-session.test.js +273 -273
  71. package/test/output-speed.test.js +6 -1
  72. package/test/piece-completeness.test.js +37 -1
  73. package/test/quality-variants.test.js +1274 -1270
  74. package/test/rate-control-in-the-output.test.js +4 -3
  75. package/test/reads-not-yet-arrived.test.js +218 -218
  76. package/test/seek-frees-the-viewers-requests.test.js +1 -1
  77. package/test/segment-closed-on-both-branches.test.js +114 -114
  78. package/test/segment-judged-by-its-own-header.test.js +222 -222
  79. package/test/segment-serve-wiring.test.js +481 -481
  80. package/test/serving-existing-output.test.js +111 -111
  81. package/test/source-files-route.test.js +113 -113
  82. package/test/subtitle-cue-walk.test.js +385 -385
  83. package/test/subtitle-metadata.test.js +15 -15
  84. package/test/subtitle-plan-waits.test.js +125 -125
  85. package/test/subtitle-track-numbering.test.js +391 -391
  86. package/test/two-viewers-one-picture.test.js +508 -508
  87. package/test/viewer-requests-admission.test.js +92 -92
  88. package/test/viewer-starts-on-map.test.js +27 -27
  89. package/test/viewer-states.test.js +5 -2
  90. package/test/viewing-generations.test.js +390 -390
  91. package/test/whole-file-held-read.test.js +30 -30
  92. package/utils/coalesce.js +41 -41
@@ -1,67 +1,67 @@
1
- /** Short startup measurements of packaged audio samples. */
2
- import { spawn } from "node:child_process";
3
- import { readFile } from "node:fs/promises";
4
- import { fileURLToPath } from "node:url";
5
- import path from "node:path";
6
- import { AUDIO_TRANSCODE_KBPS } from "./args.js";
7
- import { ENCODE_BENCHMARK_TIMEOUT_MS } from "./hwaccel.js";
8
-
9
- const SAMPLE_DIRECTORY = fileURLToPath(new URL("../../assets/calibration/audio/", import.meta.url));
10
-
11
- function measure(ffmpegBin, file, operation, signal) {
12
- return new Promise((resolve) => {
13
- const startedAt = performance.now();
14
- let mediaSeconds = 0;
15
- let text = "";
16
- let diagnostics = "";
17
- const child = spawn(ffmpegBin, ["-hide_banner", "-loglevel", "info", "-nostats", "-benchmark",
18
- "-i", file, "-map", "0:a:0", "-vn", "-c:a", operation,
19
- ...(operation === "aac" ? ["-b:a", `${AUDIO_TRANSCODE_KBPS}k`, "-ac", "2"] : []),
20
- "-f", "null", "-", "-progress", "pipe:1"],
21
- { stdio: ["ignore", "pipe", "pipe"], windowsHide: true,
22
- signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(ENCODE_BENCHMARK_TIMEOUT_MS)]) :
23
- AbortSignal.timeout(ENCODE_BENCHMARK_TIMEOUT_MS) });
24
- child.stdout.on("data", (data) => {
25
- text += String(data);
26
- const rows = text.split("\n");
27
- text = rows.pop();
28
- for (const row of rows) {
29
- if (row.startsWith("out_time_us=")) {
30
- const value = Number(row.slice("out_time_us=".length)) / 1e6;
31
- if (Number.isFinite(value) && value > 0) mediaSeconds = value;
32
- }
33
- }
34
- });
35
- child.stderr.on("data", (data) => { diagnostics += String(data); });
36
- child.on("error", () => resolve(null));
37
- child.on("close", (code) => {
38
- const elapsed = (performance.now() - startedAt) / 1000;
39
- const runtime = diagnostics.match(/bench:.*rtime=(\d+\.(\d+))s/);
40
- // The reported decimal precision bounds timing uncertainty, including a
41
- // runtime printed as zero. This is a clock-resolution bound, not a weight.
42
- const processingSeconds = runtime ? Number(runtime[1]) + 10 ** -runtime[2].length : null;
43
- resolve(code === 0 && mediaSeconds > 0 && processingSeconds > 0 ?
44
- { speed: mediaSeconds / processingSeconds, work: mediaSeconds, elapsed, processingSeconds,
45
- startupSeconds: Math.max(0, elapsed - processingSeconds) } : null);
46
- });
47
- });
48
- }
49
-
50
- export async function benchmarkAudio({ ffmpegBin, logger, signal, sampleDirectory = SAMPLE_DIRECTORY }) {
51
- const samples = JSON.parse(await readFile(path.join(sampleDirectory, "manifest.json"), "utf8"));
52
- const readings = [];
53
- const startedAt = performance.now();
54
- for (const sample of samples) {
55
- for (const operation of ["copy", "aac"]) {
56
- if (signal?.aborted) return readings;
57
- const reading = await measure(ffmpegBin, path.join(sampleDirectory, sample.file), operation, signal);
58
- if (reading) readings.push({ ...sample, operation, ...reading });
59
- else logger?.warn(`audio calibration ${sample.codec}->${operation} could not be measured`);
60
- }
61
- }
62
- logger?.info(`audio calibration: ${readings.length} short packaged-sample measurements in ` +
63
- `${((performance.now() - startedAt) / 1000).toFixed(2)}s`);
64
- return readings;
65
- }
66
-
67
- export { audioReadingFor } from "./audio-work-rate.js";
1
+ /** Short startup measurements of packaged audio samples. */
2
+ import { spawn } from "node:child_process";
3
+ import { readFile } from "node:fs/promises";
4
+ import { fileURLToPath } from "node:url";
5
+ import path from "node:path";
6
+ import { AUDIO_TRANSCODE_KBPS } from "./args.js";
7
+ import { ENCODE_BENCHMARK_TIMEOUT_MS } from "./hwaccel.js";
8
+
9
+ const SAMPLE_DIRECTORY = fileURLToPath(new URL("../../assets/calibration/audio/", import.meta.url));
10
+
11
+ function measure(ffmpegBin, file, operation, signal) {
12
+ return new Promise((resolve) => {
13
+ const startedAt = performance.now();
14
+ let mediaSeconds = 0;
15
+ let text = "";
16
+ let diagnostics = "";
17
+ const child = spawn(ffmpegBin, ["-hide_banner", "-loglevel", "info", "-nostats", "-benchmark",
18
+ "-i", file, "-map", "0:a:0", "-vn", "-c:a", operation,
19
+ ...(operation === "aac" ? ["-b:a", `${AUDIO_TRANSCODE_KBPS}k`, "-ac", "2"] : []),
20
+ "-f", "null", "-", "-progress", "pipe:1"],
21
+ { stdio: ["ignore", "pipe", "pipe"], windowsHide: true,
22
+ signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(ENCODE_BENCHMARK_TIMEOUT_MS)]) :
23
+ AbortSignal.timeout(ENCODE_BENCHMARK_TIMEOUT_MS) });
24
+ child.stdout.on("data", (data) => {
25
+ text += String(data);
26
+ const rows = text.split("\n");
27
+ text = rows.pop();
28
+ for (const row of rows) {
29
+ if (row.startsWith("out_time_us=")) {
30
+ const value = Number(row.slice("out_time_us=".length)) / 1e6;
31
+ if (Number.isFinite(value) && value > 0) mediaSeconds = value;
32
+ }
33
+ }
34
+ });
35
+ child.stderr.on("data", (data) => { diagnostics += String(data); });
36
+ child.on("error", () => resolve(null));
37
+ child.on("close", (code) => {
38
+ const elapsed = (performance.now() - startedAt) / 1000;
39
+ const runtime = diagnostics.match(/bench:.*rtime=(\d+\.(\d+))s/);
40
+ // The reported decimal precision bounds timing uncertainty, including a
41
+ // runtime printed as zero. This is a clock-resolution bound, not a weight.
42
+ const processingSeconds = runtime ? Number(runtime[1]) + 10 ** -runtime[2].length : null;
43
+ resolve(code === 0 && mediaSeconds > 0 && processingSeconds > 0 ?
44
+ { speed: mediaSeconds / processingSeconds, work: mediaSeconds, elapsed, processingSeconds,
45
+ startupSeconds: Math.max(0, elapsed - processingSeconds) } : null);
46
+ });
47
+ });
48
+ }
49
+
50
+ export async function benchmarkAudio({ ffmpegBin, logger, signal, sampleDirectory = SAMPLE_DIRECTORY }) {
51
+ const samples = JSON.parse(await readFile(path.join(sampleDirectory, "manifest.json"), "utf8"));
52
+ const readings = [];
53
+ const startedAt = performance.now();
54
+ for (const sample of samples) {
55
+ for (const operation of ["copy", "aac"]) {
56
+ if (signal?.aborted) return readings;
57
+ const reading = await measure(ffmpegBin, path.join(sampleDirectory, sample.file), operation, signal);
58
+ if (reading) readings.push({ ...sample, operation, ...reading });
59
+ else logger?.warn(`audio calibration ${sample.codec}->${operation} could not be measured`);
60
+ }
61
+ }
62
+ logger?.info(`audio calibration: ${readings.length} short packaged-sample measurements in ` +
63
+ `${((performance.now() - startedAt) / 1000).toFixed(2)}s`);
64
+ return readings;
65
+ }
66
+
67
+ export { audioReadingFor } from "./audio-work-rate.js";
@@ -1,15 +1,15 @@
1
- /** Initial per-codec work model, replaced by the track's actual speed. */
2
- export function audioReadingFor(readings, { codec, transcode, channels, samplingFrequency, bitrateKbps }) {
3
- const operation = transcode ? "aac" : "copy";
4
- const normalized = String(codec ?? "").replace(/^pcm_.*/, "pcm");
5
- const reference = readings?.find((reading) => reading.codec === normalized && reading.operation === operation);
6
- if (!reference) return null;
7
- const referenceBytesPerSecond = reference.bytes / reference.durationSeconds;
8
- // Copy work is encoded bytes; processing work is audio samples. Unstated
9
- // dimensions retain the reference measurement, rather than invented values.
10
- const workRatio = !transcode && bitrateKbps > 0 ? (bitrateKbps * 1000 / 8) / referenceBytesPerSecond :
11
- transcode && channels > 0 && samplingFrequency > 0 ?
12
- (channels * samplingFrequency) / (reference.channels * reference.samplingFrequency) : 1;
13
- return { ...reference, speed: reference.speed / workRatio,
14
- basis: workRatio === 1 ? "measured-reference" : transcode ? "audio-samples" : "encoded-bytes" };
15
- }
1
+ /** Initial per-codec work model, replaced by the track's actual speed. */
2
+ export function audioReadingFor(readings, { codec, transcode, channels, samplingFrequency, bitrateKbps }) {
3
+ const operation = transcode ? "aac" : "copy";
4
+ const normalized = String(codec ?? "").replace(/^pcm_.*/, "pcm");
5
+ const reference = readings?.find((reading) => reading.codec === normalized && reading.operation === operation);
6
+ if (!reference) return null;
7
+ const referenceBytesPerSecond = reference.bytes / reference.durationSeconds;
8
+ // Copy work is encoded bytes; processing work is audio samples. Unstated
9
+ // dimensions retain the reference measurement, rather than invented values.
10
+ const workRatio = !transcode && bitrateKbps > 0 ? (bitrateKbps * 1000 / 8) / referenceBytesPerSecond :
11
+ transcode && channels > 0 && samplingFrequency > 0 ?
12
+ (channels * samplingFrequency) / (reference.channels * reference.samplingFrequency) : 1;
13
+ return { ...reference, speed: reference.speed / workRatio,
14
+ basis: workRatio === 1 ? "measured-reference" : transcode ? "audio-samples" : "encoded-bytes" };
15
+ }
@@ -52,6 +52,8 @@ export const ENCODE_EXIT = Object.freeze({
52
52
  SHORT: "short",
53
53
  /** The input was not there. Recoverable: the data can come back. */
54
54
  INPUT_LOST: "input-lost",
55
+ /** Closed bytes could not be published; this says nothing about hardware. */
56
+ PUBLICATION_FAILED: "publication-failed",
55
57
  /** Anything else. Terminal for this target until something restarts it. */
56
58
  FAILED: "failed"
57
59
  });