@torrent-tv/proxy 2.89.17 → 2.89.18

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 (299) hide show
  1. package/README.md +14 -3
  2. package/package.json +10 -2
  3. package/server.js +0 -11
  4. package/.claude/commands/opsx/apply.md +0 -155
  5. package/.claude/commands/opsx/archive.md +0 -160
  6. package/.claude/commands/opsx/explore.md +0 -174
  7. package/.claude/commands/opsx/propose.md +0 -109
  8. package/.claude/commands/opsx/sync.md +0 -143
  9. package/.claude/skills/openspec-apply-change/SKILL.md +0 -159
  10. package/.claude/skills/openspec-archive-change/SKILL.md +0 -117
  11. package/.claude/skills/openspec-explore/SKILL.md +0 -289
  12. package/.claude/skills/openspec-propose/SKILL.md +0 -113
  13. package/.claude/skills/openspec-sync-specs/SKILL.md +0 -147
  14. package/.dockerignore +0 -5
  15. package/AGENTS.md +0 -363
  16. package/CHANGELOG.md +0 -2377
  17. package/Dockerfile +0 -30
  18. package/biome.json +0 -412
  19. package/corpus.tmp.json +0 -1
  20. package/docs/browser-proxy-contract.md +0 -155
  21. package/docs/container-architecture.md +0 -273
  22. package/docs/download-architecture.md +0 -261
  23. package/docs/encode-architecture.md +0 -765
  24. package/docs/encode-run-state.md +0 -96
  25. package/docs/logs.md +0 -151
  26. package/docs/playback-start-forecast.md +0 -113
  27. package/docs/socks5-egress-research.md +0 -114
  28. package/docs/storage-architecture.md +0 -273
  29. package/knip.json +0 -14
  30. package/main2.cpuprofile +0 -1
  31. package/openspec/changes/adaptive-bitrate/.openspec.yaml +0 -0
  32. package/openspec/changes/adaptive-bitrate/design.md +0 -92
  33. package/openspec/changes/adaptive-bitrate/proposal.md +0 -56
  34. package/openspec/changes/adaptive-bitrate/specs/adaptive-bitrate/spec.md +0 -51
  35. package/openspec/changes/adaptive-bitrate/tasks.md +0 -40
  36. package/openspec/changes/binary-distribution/.openspec.yaml +0 -2
  37. package/openspec/changes/binary-distribution/proposal.md +0 -53
  38. package/openspec/changes/chunked-request-bodies/design.md +0 -81
  39. package/openspec/changes/chunked-request-bodies/proposal.md +0 -53
  40. package/openspec/changes/chunked-request-bodies/specs/chunked-request-bodies/spec.md +0 -30
  41. package/openspec/changes/chunked-request-bodies/tasks.md +0 -40
  42. package/openspec/changes/cold-start/design.md +0 -98
  43. package/openspec/changes/cold-start/proposal.md +0 -62
  44. package/openspec/changes/cold-start/specs/cold-start/spec.md +0 -47
  45. package/openspec/changes/cold-start/tasks.md +0 -48
  46. package/openspec/changes/disk-cap/.openspec.yaml +0 -2
  47. package/openspec/changes/disk-cap/proposal.md +0 -37
  48. package/openspec/changes/disk-cap/specs/disk-cap/spec.md +0 -25
  49. package/openspec/changes/disk-cap/tasks.md +0 -19
  50. package/openspec/changes/proxy-observability/.openspec.yaml +0 -2
  51. package/openspec/changes/proxy-observability/design.md +0 -38
  52. package/openspec/changes/proxy-observability/proposal.md +0 -49
  53. package/openspec/changes/proxy-observability/specs/observability/spec.md +0 -33
  54. package/openspec/changes/proxy-observability/tasks.md +0 -21
  55. package/openspec/changes/seek-debounce/.openspec.yaml +0 -0
  56. package/openspec/changes/seek-debounce/design.md +0 -118
  57. package/openspec/changes/seek-debounce/proposal.md +0 -59
  58. package/openspec/changes/seek-debounce/specs/seek-debounce/spec.md +0 -41
  59. package/openspec/changes/seek-debounce/tasks.md +0 -33
  60. package/openspec/changes/subtitle-language/.openspec.yaml +0 -2
  61. package/openspec/changes/subtitle-language/proposal.md +0 -50
  62. package/openspec/changes/subtitle-language/specs/subtitle-language/spec.md +0 -34
  63. package/openspec/changes/subtitle-language/tasks.md +0 -26
  64. package/openspec/changes/track-selection/.openspec.yaml +0 -2
  65. package/openspec/changes/track-selection/design.md +0 -47
  66. package/openspec/changes/track-selection/proposal.md +0 -45
  67. package/openspec/changes/track-selection/specs/track-selection/spec.md +0 -41
  68. package/openspec/changes/track-selection/tasks.md +0 -20
  69. package/openspec/changes/transcode-quality/.openspec.yaml +0 -2
  70. package/openspec/changes/transcode-quality/proposal.md +0 -51
  71. package/openspec/changes/transcode-quality/specs/transcode-quality/spec.md +0 -139
  72. package/openspec/changes/transcode-quality/tasks.md +0 -63
  73. package/openspec/config.yaml +0 -38
  74. package/public/.well-known/appspecific/com.chrome.devtools.json +0 -1
  75. package/research/delivery-wedge-stand-ladder-2026-09-13.md +0 -329
  76. package/research/double-spawn-2026-09-10.md +0 -171
  77. package/research/handover-2026-09-13.md +0 -209
  78. package/research/handover-reader-claims-removal-2026-09-12.md +0 -166
  79. package/research/piece-withdrawn-but-still-claimed-2026-09-12.md +0 -175
  80. package/research/preset-benchmark-size-scaling-2026-08-22.md +0 -55
  81. package/research/priority-map-is-the-truth-2026-09-12.md +0 -225
  82. package/research/valgrind-replica-2026-08-27/logs.tar.gz +0 -0
  83. package/scripts/build-audio-samples.mjs +0 -31
  84. package/scripts/render-run-graph.js +0 -173
  85. package/test/asset-paths.test.js +0 -28
  86. package/test/audio-buffer-continuity.test.js +0 -77
  87. package/test/audio-calibration.test.js +0 -23
  88. package/test/audio-inventory.test.js +0 -212
  89. package/test/audio-track-bitrate.test.js +0 -40
  90. package/test/audio-warm-recorded.test.js +0 -63
  91. package/test/auto-quality-step.test.js +0 -762
  92. package/test/available-share.test.js +0 -76
  93. package/test/background-fill.test.js +0 -190
  94. package/test/client-log-file.test.js +0 -126
  95. package/test/client-logs-route.test.js +0 -34
  96. package/test/coalesce.test.js +0 -39
  97. package/test/completed-files.test.js +0 -115
  98. package/test/concurrent-cost.test.js +0 -148
  99. package/test/container-media-info.test.js +0 -228
  100. package/test/contention.test.js +0 -76
  101. package/test/core-dumps.test.js +0 -57
  102. package/test/coverage-follows-the-disk.test.js +0 -233
  103. package/test/coverage-map.test.js +0 -195
  104. package/test/cue-push-carries-what-the-walk-found.test.js +0 -58
  105. package/test/cut-times-timeline.test.js +0 -65
  106. package/test/cuts-follow-published-grid.test.js +0 -109
  107. package/test/data-channel-frame.test.js +0 -63
  108. package/test/data-channel-viewer-lifecycle.test.js +0 -193
  109. package/test/dead-torrent-handle.test.js +0 -52
  110. package/test/declared-rates.test.js +0 -116
  111. package/test/declared-tracks.test.js +0 -43
  112. package/test/decode-cost-fit.test.js +0 -202
  113. package/test/decode-cost.test.js +0 -475
  114. package/test/delivery-probe-field.test.js +0 -173
  115. package/test/delivery-probe.test.js +0 -382
  116. package/test/demand-register.test.js +0 -206
  117. package/test/dht-bootstrap.test.js +0 -72
  118. package/test/drain-threat.test.js +0 -65
  119. package/test/duplicate-add.test.js +0 -48
  120. package/test/encode-admission.test.js +0 -170
  121. package/test/encode-cost.test.js +0 -275
  122. package/test/encode-exit.test.js +0 -111
  123. package/test/encode-orchestrator.test.js +0 -426
  124. package/test/encode-plan-viewers.test.js +0 -725
  125. package/test/encode-plan.test.js +0 -545
  126. package/test/encode-run-state.test.js +0 -314
  127. package/test/encode-run.test.js +0 -248
  128. package/test/encode-slope.test.js +0 -46
  129. package/test/encoded-output.test.js +0 -39
  130. package/test/encoder-kinds.test.js +0 -122
  131. package/test/encoder-readings.test.js +0 -68
  132. package/test/episode-naming.test.js +0 -131
  133. package/test/every-claimant-is-told-its-share.test.js +0 -152
  134. package/test/failed-encoder-still-serves-what-exists.test.js +0 -354
  135. package/test/failed-start-breaker.test.js +0 -202
  136. package/test/fastest-wires.test.js +0 -143
  137. package/test/ffmpeg-stream-counts.test.js +0 -101
  138. package/test/file-edges.test.js +0 -191
  139. package/test/files-in-use.test.js +0 -34
  140. package/test/fixtures/audio-frame-boundary.json +0 -1
  141. package/test/fixtures/refused-audio-20261002.json +0 -10
  142. package/test/fmp4-presentation-clock.test.js +0 -148
  143. package/test/fmp4-self-contained.test.js +0 -80
  144. package/test/fmp4-timestamps.test.js +0 -140
  145. package/test/fmp4-track-completeness.test.js +0 -41
  146. package/test/format-keyed-outputs.test.js +0 -78
  147. package/test/health-metrics.test.js +0 -36
  148. package/test/held-read-ownership.test.js +0 -77
  149. package/test/held-request-width.test.js +0 -157
  150. package/test/helpers/encode-run.js +0 -248
  151. package/test/helpers/held-file.js +0 -77
  152. package/test/helpers/manager.js +0 -62
  153. package/test/helpers/matroska-file.js +0 -296
  154. package/test/helpers/output-spec.js +0 -63
  155. package/test/host-load.test.js +0 -68
  156. package/test/index-accuracy-is-about-the-file.test.js +0 -128
  157. package/test/init-compat.test.js +0 -219
  158. package/test/input-lost-quiets-the-plan.test.js +0 -261
  159. package/test/input-unavailable.test.js +0 -48
  160. package/test/installation-id.test.js +0 -39
  161. package/test/keeping-period.test.js +0 -83
  162. package/test/keyframe-index-accuracy.test.js +0 -188
  163. package/test/keyframe-table-budget.test.js +0 -123
  164. package/test/keyframes-belong-to-the-file.test.js +0 -249
  165. package/test/learned-median.test.js +0 -37
  166. package/test/letting-go-asks-who-is-watching.test.js +0 -191
  167. package/test/limit-row-by-area.test.js +0 -60
  168. package/test/link-budget.test.js +0 -111
  169. package/test/link-probe.test.js +0 -56
  170. package/test/local-encoding-data.test.js +0 -273
  171. package/test/logger-repeats.test.js +0 -134
  172. package/test/look-ahead-coverage.test.js +0 -56
  173. package/test/manager-surface.test.js +0 -291
  174. package/test/matroska-blocks.test.js +0 -0
  175. package/test/matroska-cluster-discovery.test.js +0 -323
  176. package/test/matroska-cues-track.test.js +0 -192
  177. package/test/media-time.test.js +0 -62
  178. package/test/memory-budget.test.js +0 -390
  179. package/test/move-cost.test.js +0 -216
  180. package/test/mp4-composition-times.test.js +0 -0
  181. package/test/mp4-subtitles.test.js +0 -173
  182. package/test/one-authority.test.js +0 -285
  183. package/test/one-budget.test.js +0 -149
  184. package/test/one-output-one-session.test.js +0 -273
  185. package/test/one-resource-divided.test.js +0 -185
  186. package/test/one-serving-output-per-height.test.js +0 -458
  187. package/test/orchestrator-wired.test.js +0 -207
  188. package/test/output-catalog.test.js +0 -39
  189. package/test/output-shape.test.js +0 -21
  190. package/test/output-spec.test.js +0 -251
  191. package/test/output-speed.test.js +0 -92
  192. package/test/outputs-being-prepared.test.js +0 -40
  193. package/test/packet-witness-ring.test.js +0 -236
  194. package/test/packet-witness.test.js +0 -148
  195. package/test/piece-completeness.test.js +0 -78
  196. package/test/piece-disk-store.test.js +0 -401
  197. package/test/piece-from-whole-file.test.js +0 -129
  198. package/test/piece-lru.test.js +0 -319
  199. package/test/piece-reader.test.js +0 -162
  200. package/test/piece-selection-offset.test.js +0 -85
  201. package/test/piece-store-eviction.test.js +0 -595
  202. package/test/piece-store-never-refuses.test.js +0 -153
  203. package/test/piece-store-reservations.test.js +0 -403
  204. package/test/piece-store-slow-disk.test.js +0 -159
  205. package/test/piece-tail.test.js +0 -97
  206. package/test/plan-host-timings.test.js +0 -68
  207. package/test/plan-is-steady.test.js +0 -225
  208. package/test/playback-readiness.test.js +0 -518
  209. package/test/playback-start-regressions.test.js +0 -101
  210. package/test/priority-map-download.test.js +0 -174
  211. package/test/priority-map-emptied.test.js +0 -204
  212. package/test/priority-map-per-output.test.js +0 -215
  213. package/test/priority-map.test.js +0 -163
  214. package/test/probe-wedge-certainty.test.js +0 -60
  215. package/test/produced-copy-choice.test.js +0 -213
  216. package/test/published-timeline.test.js +0 -83
  217. package/test/quality-offer.test.js +0 -160
  218. package/test/quality-variants.test.js +0 -1274
  219. package/test/rate-control-in-the-output.test.js +0 -181
  220. package/test/read-survives-withdrawal.test.js +0 -164
  221. package/test/read-window.test.js +0 -365
  222. package/test/reads-not-yet-arrived.test.js +0 -218
  223. package/test/resume-warm.test.js +0 -39
  224. package/test/run-graph-drift.test.js +0 -37
  225. package/test/run-inputs.test.js +0 -80
  226. package/test/run-intervals.test.js +0 -100
  227. package/test/run-position-follows-published-grid.test.js +0 -89
  228. package/test/run-progress.test.js +0 -64
  229. package/test/same-height-switch.test.js +0 -663
  230. package/test/seek-frees-the-viewers-requests.test.js +0 -217
  231. package/test/seek-landing.test.js +0 -109
  232. package/test/seek-target-not-superseded.test.js +0 -195
  233. package/test/segment-closed-on-both-branches.test.js +0 -114
  234. package/test/segment-cut-times.test.js +0 -63
  235. package/test/segment-demand.test.js +0 -80
  236. package/test/segment-hold-supersede.test.js +0 -91
  237. package/test/segment-judged-by-its-own-header.test.js +0 -222
  238. package/test/segment-serve-wiring.test.js +0 -481
  239. package/test/segment-store-eviction.test.js +0 -247
  240. package/test/segment-store.test.js +0 -352
  241. package/test/segment-true-start.test.js +0 -86
  242. package/test/segments-are-shared.test.js +0 -176
  243. package/test/send-chunk-bytes.test.js +0 -86
  244. package/test/serving-existing-output.test.js +0 -111
  245. package/test/serving-output.test.js +0 -102
  246. package/test/shared-piece-store.test.js +0 -310
  247. package/test/sidecar-naming.test.js +0 -142
  248. package/test/soundtrack-rate-bound.test.js +0 -289
  249. package/test/source-file.test.js +0 -133
  250. package/test/source-files-route.test.js +0 -113
  251. package/test/source-registry.test.js +0 -18
  252. package/test/split-a-stretch.test.js +0 -139
  253. package/test/stale-request-after-seek.test.js +0 -158
  254. package/test/startup-readings.test.js +0 -124
  255. package/test/stream-route.test.js +0 -237
  256. package/test/subtitle-cue-framing.test.js +0 -200
  257. package/test/subtitle-cue-source.test.js +0 -102
  258. package/test/subtitle-cue-walk.test.js +0 -385
  259. package/test/subtitle-cursor.test.js +0 -63
  260. package/test/subtitle-defaults.test.js +0 -118
  261. package/test/subtitle-language.test.js +0 -252
  262. package/test/subtitle-metadata.test.js +0 -15
  263. package/test/subtitle-plan-waits.test.js +0 -125
  264. package/test/subtitle-track-numbering.test.js +0 -391
  265. package/test/supply-margin.test.js +0 -190
  266. package/test/swarm-follows-readers.test.js +0 -174
  267. package/test/swarm-reach.test.js +0 -130
  268. package/test/swarm-selection.test.js +0 -220
  269. package/test/tail-duplication.test.js +0 -167
  270. package/test/the-channel-has-both-ends.test.js +0 -91
  271. package/test/the-torrent-thread-serves-bytes.test.js +0 -107
  272. package/test/thread-pool.test.js +0 -53
  273. package/test/timeline.test.js +0 -84
  274. package/test/torrent-contents.test.js +0 -235
  275. package/test/torrent-cost.test.js +0 -71
  276. package/test/torrent-files.test.js +0 -221
  277. package/test/torrent-naming.test.js +0 -255
  278. package/test/tracks-begin-together.test.js +0 -209
  279. package/test/tunnel-renewal.test.js +0 -167
  280. package/test/two-viewers-one-picture.test.js +0 -508
  281. package/test/upload-hurry.test.js +0 -186
  282. package/test/usrsctp-state.test.js +0 -131
  283. package/test/video-facts.test.js +0 -102
  284. package/test/viewer-assignments.test.js +0 -143
  285. package/test/viewer-outputs.test.js +0 -285
  286. package/test/viewer-presence.test.js +0 -116
  287. package/test/viewer-requests-admission.test.js +0 -92
  288. package/test/viewer-starts-on-map.test.js +0 -27
  289. package/test/viewer-states.test.js +0 -192
  290. package/test/viewer-subtitle-subscription.test.js +0 -96
  291. package/test/viewer.test.js +0 -139
  292. package/test/viewing-generations.test.js +0 -390
  293. package/test/visible-rung.test.js +0 -37
  294. package/test/wait-ledger.test.js +0 -100
  295. package/test/webrtc-shim.test.js +0 -149
  296. package/test/wedge-certainty.test.js +0 -131
  297. package/test/whole-file-held-read.test.js +0 -30
  298. package/test/withdraw-piece-claim.test.js +0 -212
  299. package/test/worker-channel.test.js +0 -158
@@ -1,217 +0,0 @@
1
- /**
2
- * @file A seek must free the requests it made pointless, on every output that
3
- * viewer watches, and only theirs.
4
- *
5
- * hls.js keeps ONE fragment load outstanding per track, so a request held for a
6
- * segment the viewer has just left blocks the request for where they now are.
7
- * Measured 2026-08-04: 57 s of a 58 s backward seek was that wait, and the
8
- * segment they wanted was served in 15 ms once it was asked for.
9
- *
10
- * The guard against it was built — the route compares a seek epoch and asks
11
- * whether each held request is still wanted — and nothing moved that epoch: no
12
- * caller of `invalidateWaits` was a seek.
13
- *
14
- * TWO THINGS THIS CHECK HAS TO DO, and the first version of it did neither.
15
- * It must wait until the store really HOLDS the waits, because a seek that
16
- * happens before they are registered frees nothing and passes all the same; and
17
- * it must cover the three outputs one viewer watches — the picture the browser
18
- * addresses, the step on their screen, their soundtrack — because waking only
19
- * the one the browser named leaves two thirds of their requests standing.
20
- *
21
- * And waking is not cancelling: one viewer's seek must leave another viewer's
22
- * request for the same segment of the same output exactly where it was.
23
- */
24
-
25
- import test from "node:test";
26
- import assert from "node:assert/strict";
27
- import { rm, writeFile } from "node:fs/promises";
28
- import path from "node:path";
29
- import { setTimeout as delay } from "node:timers/promises";
30
- import { wireOutputs } from "../services/server/wire-outputs.js";
31
- import { waitForSessionFile } from "../services/server/transcode-session-files.js";
32
- import { SourceFile } from "../services/media/SourceFile.js";
33
- import { Timeline } from "../services/encode/output/Timeline.js";
34
- import { Output } from "../services/encode/output/Output.js";
35
- import { KeyframeTable } from "../services/media/container/KeyframeTable.js";
36
- import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
37
- import { outputSpec } from "./helpers/output-spec.js";
38
-
39
- const SESSION_ID = "2222222233334444";
40
- const OUTPUT_KEY = "seek-frees:fmt=fmp4:grid=uniform:video-only:v=0/copy";
41
- const STEP_ID = "3333333344445555";
42
- const STEP_KEY = "seek-frees:fmt=fmp4:grid=uniform:video-only:v=0/libx264/960x540";
43
- const SOUND_ID = "4444444455556666";
44
- const SOUND_KEY = "seek-frees:fmt=fmp4:grid=uniform:audio-only:a=0/0/aac";
45
- /** Long enough that running out of it is a failure and never the measurement. */
46
- const HOLD_MS = 30_000;
47
-
48
- /**
49
- * One output of the film, with nothing produced for it yet.
50
- *
51
- * @param {object} manager
52
- * @param {{ id: string, key: string, audioOnly?: boolean, height?: number }} what
53
- * @returns {object}
54
- */
55
- function outputOn(manager, { id, key, audioOnly = false, height = 0 }) {
56
- manager.segmentStore.useFormat(key, fmp4Format);
57
- const dirPath = manager.segmentStore.directoryFor(key);
58
- const session = {
59
- id,
60
- spec: outputSpec({ transcodeVideo: height > 0, height, audioOnly, cutGrid: "uniform" }),
61
- outputKey: key,
62
- dirPath,
63
- timeline: new Timeline({ boundaries: [0, 12.5, 25, 37.5, 50, 62.5], cutGrid: "uniform" }),
64
- state: "ready",
65
- file: new SourceFile({ sourceKey: "source-1", fileIndex: 0, name: "video.mkv" }).learn({ durationSeconds: 62.5 }),
66
- get inputFile() { return this.file; },
67
- get audioFile() { return this.file; },
68
- lastAloneSpeed: 2,
69
- startedAt: Date.now(),
70
- lastAccessedAt: Date.now(),
71
- runs: new Set(),
72
- lastError: "",
73
- consumers: new Set(),
74
- viewers: new Map(),
75
- segmentCount: 5,
76
- segmentFormat: fmp4Format,
77
- useSyntheticPlaylist: true,
78
- playlistText: "#EXTM3U\n",
79
- output: new Output({ encodeWidth: 0, encodeHeight: height, outputFps: 25, softwarePreset: null, applyTonemap: false }),
80
- keyframes: new KeyframeTable().learn({ times: [0, 12.5, 25, 37.5, 50], format: "matroska" }),
81
- audioOnly,
82
- waitEpoch: 0
83
- };
84
- manager.outputs.set(id, session);
85
- return session;
86
- }
87
-
88
- /**
89
- * Wait until the store really holds this many waits on an output.
90
- *
91
- * The deadline is a backstop and never the measurement: what is waited for is
92
- * the registration itself, which is the store's own state.
93
- *
94
- * @param {object} manager
95
- * @param {string} key
96
- * @param {number} howMany
97
- * @returns {Promise<void>}
98
- */
99
- async function untilWaitsAreRegistered(manager, key, howMany) {
100
- const giveUpAt = Date.now() + 5_000;
101
- while (manager.segmentStore.waitingFor(key) < howMany) {
102
- if (Date.now() > giveUpAt) {
103
- throw new Error(`only ${manager.segmentStore.waitingFor(key)} wait(s) on ${key} after 5s`);
104
- }
105
- await new Promise((resolve) => setImmediate(resolve));
106
- }
107
- }
108
-
109
- /**
110
- * The picture, one quality step and one soundtrack of a film, with two viewers
111
- * on the picture and one of them also on the step and the soundtrack.
112
- *
113
- * @returns {{ manager: object, session: object, step: object, sound: object }}
114
- */
115
- function filmWithThreeOutputs() {
116
- const manager = wireOutputs({
117
- enabled: true,
118
- ffmpegBin: "ffmpeg",
119
- localBindHost: "127.0.0.1",
120
- localPort: 9090
121
- });
122
- // No plan runs here: this is about the path that answers a request, and
123
- // letting the plan run would spawn real encoders.
124
- manager.encodeRuns.planEncodersNow = () => {};
125
- manager.encodeRuns.planEncodersSoon = () => {};
126
- const session = outputOn(manager, { id: SESSION_ID, key: OUTPUT_KEY });
127
- const step = outputOn(manager, { id: STEP_ID, key: STEP_KEY, height: 540 });
128
- const sound = outputOn(manager, { id: SOUND_ID, key: SOUND_KEY, audioOnly: true });
129
- for (const consumerId of ["viewer-a", "viewer-b"]) {
130
- manager.viewers.of(session, consumerId).moveTo(0);
131
- }
132
- for (const output of [step, sound]) {
133
- manager.viewers.of(step === output ? step : sound, "viewer-a").moveTo(0);
134
- }
135
- return { manager, session, step, sound };
136
- }
137
-
138
- /**
139
- * @param {object} manager
140
- * @param {string} consumerId
141
- * @param {string} sessionId
142
- * @returns {Promise<{ kind: string }>}
143
- */
144
- function holdFor(manager, consumerId, sessionId = SESSION_ID) {
145
- return waitForSessionFile(manager.serving, sessionId, "segment-00000.mp4", {
146
- holdMs: HOLD_MS,
147
- consumerId
148
- });
149
- }
150
-
151
- test("a seek frees the seeker's requests on every output they watch", async (t) => {
152
- const { manager, session, step, sound } = filmWithThreeOutputs();
153
- t.after(async () => {
154
- await manager.lifecycle.disposeAll();
155
- for (const output of [session, step, sound]) {
156
- await rm(output.dirPath, { recursive: true, force: true });
157
- }
158
- });
159
-
160
- const onPicture = holdFor(manager, "viewer-a");
161
- const onStep = holdFor(manager, "viewer-a", STEP_ID);
162
- const onSound = holdFor(manager, "viewer-a", SOUND_ID);
163
- let stayed = "still held";
164
- const stayer = holdFor(manager, "viewer-b").then((result) => {
165
- stayed = result.kind;
166
- return result;
167
- });
168
- // Every one of them must EXIST before the seek, or the check proves nothing.
169
- await untilWaitsAreRegistered(manager, OUTPUT_KEY, 2);
170
- await untilWaitsAreRegistered(manager, STEP_KEY, 1);
171
- await untilWaitsAreRegistered(manager, SOUND_KEY, 1);
172
-
173
- const startedAt = Date.now();
174
- assert.equal(manager.viewerRequests.requestSeek(SESSION_ID, 50, "viewer-a"), true);
175
-
176
- const released = await Promise.all([onPicture, onStep, onSound]);
177
- const heldMs = Date.now() - startedAt;
178
-
179
- for (const [index, answer] of released.entries()) {
180
- assert.equal(
181
- answer.kind,
182
- "superseded",
183
- `the request on output ${index} was made for a position its viewer has left`
184
- );
185
- }
186
- assert.ok(heldMs < HOLD_MS / 2, `they were freed after ${heldMs}ms, which is the hold running out`);
187
-
188
- // A grace before asserting that something did NOT happen: it can only ever
189
- // pass too easily, never fail by luck.
190
- await delay(300);
191
- assert.equal(stayed, "still held", "the other viewer is where they were and still wants this segment");
192
- void stayer;
193
- });
194
-
195
- test("the request that was kept is served when its segment appears", async (t) => {
196
- const { manager, session, step, sound } = filmWithThreeOutputs();
197
- t.after(async () => {
198
- await manager.lifecycle.disposeAll();
199
- for (const output of [session, step, sound]) {
200
- await rm(output.dirPath, { recursive: true, force: true });
201
- }
202
- });
203
-
204
- const seeker = holdFor(manager, "viewer-a");
205
- const stayer = holdFor(manager, "viewer-b");
206
- await untilWaitsAreRegistered(manager, OUTPUT_KEY, 2);
207
- manager.viewerRequests.requestSeek(SESSION_ID, 50, "viewer-a");
208
- assert.equal((await seeker).kind, "superseded");
209
-
210
- // The piece the viewer who stayed was waiting for, written as a run writes
211
- // it: under its served name, which is the whole of what says it is closed.
212
- await writeFile(path.join(session.dirPath, fmp4Format.segmentFileName(0)), Buffer.alloc(256, 0x5a));
213
-
214
- const answer = await stayer;
215
-
216
- assert.equal(answer.kind, "file", `a wake is a re-check, not a cancellation — got ${answer.kind}`);
217
- });
@@ -1,109 +0,0 @@
1
- /**
2
- * @file Ask ffmpeg late enough that it lands where we meant.
3
- *
4
- * `fftools/ffmpeg_demux.c` moves an input seek back by `3*AV_TIME_BASE / 23` —
5
- * 130.435 ms — whenever the container does not declare `AVFMT_SEEK_TO_PTS` and
6
- * a stream carries B-frames. So asking for a keyframe lands on the one before
7
- * it, and since `-segment_times` is measured from where the run really began,
8
- * every cut of that run inherits the shift.
9
- *
10
- * Measured 2026-08-21 on Matroska with keyframes every 2 s: `-ss 10` produced a
11
- * first segment starting at 8.000, `-ss 10.130435` one starting at 10.000. On
12
- * MP4, where the heuristic does not fire, 10, 10.130435 and 10.2 all produced
13
- * 10.000 — right in one case, harmless in the other.
14
- */
15
-
16
- import assert from "node:assert/strict";
17
- import { KeyframeTable } from "../services/media/container/KeyframeTable.js";
18
- import test from "node:test";
19
-
20
- import { seekLandingOffsetFor } from "../services/encode/run-command.js";
21
-
22
- const OFFSET = 3 / 23;
23
-
24
- test("a copied picture is asked for one heuristic later than the keyframe", () => {
25
- const session = { transcodeVideo: false, keyframes: new KeyframeTable().learn({ times: [0, 2.002, 4.004, 6.006] }) };
26
- assert.equal(seekLandingOffsetFor(session, 2.002), OFFSET);
27
- });
28
-
29
- test("a re-encode is asked for exactly what it should produce", () => {
30
- // It decodes from the keyframe and discards frames up to the requested time,
31
- // so pushing the request later would start its output late.
32
- const session = { transcodeVideo: true, keyframes: new KeyframeTable().learn({ times: [0, 2.002, 4.004] }) };
33
- assert.equal(seekLandingOffsetFor(session, 2.002), 0);
34
- });
35
-
36
- test("the offset never reaches the next keyframe", () => {
37
- // Keyframes 0.1 s apart: half of that is the most that can be added without
38
- // risking a landing on the NEXT one where the heuristic does not fire.
39
- const session = { transcodeVideo: false, keyframes: new KeyframeTable().learn({ times: [0, 0.1, 0.2, 0.3] }) };
40
- assert.equal(seekLandingOffsetFor(session, 0.1), 0.05);
41
- });
42
-
43
- test("the last keyframe has nothing after it to collide with", () => {
44
- const session = { transcodeVideo: false, keyframes: new KeyframeTable().learn({ times: [0, 2.002, 4.004] }) };
45
- assert.equal(seekLandingOffsetFor(session, 4.004), OFFSET);
46
- });
47
-
48
- test("no keyframe list is still answered", () => {
49
- assert.equal(seekLandingOffsetFor({ transcodeVideo: false }, 5), OFFSET);
50
- assert.equal(seekLandingOffsetFor(null, 5), OFFSET);
51
- });
52
-
53
- test("a grid whose times are approximate is asked for that much later again", () => {
54
- // AVI names a keyframe by its frame NUMBER and the time is that number times
55
- // the frame duration, so a name can sit just BELOW the keyframe it refers to
56
- // — measured 2026-08-21, 10-44 ms out on two files, always under one frame.
57
- // Asking at the name alone would seek to before the real keyframe and land on
58
- // the one before that, which is the fault this offset exists for.
59
- const session = {
60
- transcodeVideo: false,
61
- keyframes: new KeyframeTable().learn({ times: [0, 4.004, 8.008, 12.012], tolerance: 0.04 })
62
- };
63
- assert.equal(seekLandingOffsetFor(session, 4.004), OFFSET + 0.04);
64
- });
65
-
66
- test("an exact grid claims no tolerance", () => {
67
- // Matroska and MP4 state instants outright — measured the same day, nine
68
- // files and 11 665 keyframes with not one disagreement.
69
- const session = { transcodeVideo: false, keyframes: new KeyframeTable().learn({ times: [0, 4.004, 8.008], tolerance: 0 }) };
70
- assert.equal(seekLandingOffsetFor(session, 4.004), OFFSET);
71
- });
72
-
73
- test("the bound still holds once a tolerance is added", () => {
74
- const session = { transcodeVideo: false, keyframes: new KeyframeTable().learn({ times: [0, 0.1, 0.2], tolerance: 1 }) };
75
- assert.equal(seekLandingOffsetFor(session, 0.1), 0.05);
76
- });
77
-
78
- test("an output carrying only sound is not pushed past what it asked for", () => {
79
- // The field failure of 2026-09-06: the sound played 130 ms ahead of the
80
- // picture from every restart onward, and the viewer saw lips out of step with
81
- // the voice from two minutes in.
82
- //
83
- // The offset exists because ffmpeg's demuxer moves a seek target back for a
84
- // container it reads in decode order, after which a COPY lands on the previous
85
- // keyframe. A re-encode trims to the requested time itself and is excluded —
86
- // and an output with no picture is exactly that, since its one track is
87
- // `-c:a aac`. It was not excluded, because the test asked whether the PICTURE
88
- // is re-encoded and an output with no picture answers no.
89
- const soundtrack = {
90
- audioOnly: true,
91
- transcodeVideo: false,
92
- keyframes: new KeyframeTable()
93
- .learn({ times: [0, 4.004, 8.008, 12.012], tolerance: 0 })
94
- };
95
- assert.equal(seekLandingOffsetFor(soundtrack, 4.004), 0);
96
- });
97
-
98
- test("the picture of the same film still gets the offset", () => {
99
- // The pair to the check above: the two outputs are repositioned to one
100
- // boundary and must be given DIFFERENT requests, because one is copied and one
101
- // is re-encoded. Given the same request they land 130 ms apart.
102
- const picture = {
103
- audioOnly: false,
104
- transcodeVideo: false,
105
- keyframes: new KeyframeTable()
106
- .learn({ times: [0, 4.004, 8.008, 12.012], tolerance: 0 })
107
- };
108
- assert.equal(seekLandingOffsetFor(picture, 4.004), OFFSET);
109
- });
@@ -1,195 +0,0 @@
1
- /**
2
- * @file The segment the viewer just seeked TO must not be refused as stale.
3
- *
4
- * A seek bumps the wait epoch so that requests made for the position being left
5
- * stop being held. The request for the position being ARRIVED at races that
6
- * bump: hls.js asks for the new segment within milliseconds, and if the epoch
7
- * moves underneath it, the epoch check alone cannot tell the two apart.
8
- *
9
- * Measured 2026-08-18: the viewer seeked to 1061.0 s, `segment-00101` — the
10
- * segment at that very position — was answered 503 twice within 80 ms, the
11
- * player never asked for it again, and instead looped `a/0/segment-00103` and
12
- * `a/0/segment-00104` 737 and 736 times over 149 seconds while the picture
13
- * stood at `t=1061.0s readyState=1`. The session ended without another frame.
14
- */
15
-
16
- import test from "node:test";
17
- import assert from "node:assert/strict";
18
- import { SourceFile } from "../services/media/SourceFile.js";
19
- import { Timeline } from "../services/encode/output/Timeline.js";
20
- import { mkdtemp, rm } from "node:fs/promises";
21
- import os from "node:os";
22
- import path from "node:path";
23
- import { wireOutputs } from "../services/server/wire-outputs.js";
24
- import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
25
-
26
- const SESSION_ID = "aaaaaaaa11112222";
27
- const SEGMENT_SECONDS = 10.4;
28
- const SEEK_TO_SECONDS = 1061;
29
- const SEGMENT_AT_SEEK = Math.floor(SEEK_TO_SECONDS / SEGMENT_SECONDS);
30
-
31
- /**
32
- * A session whose viewer has just landed at {@link SEEK_TO_SECONDS}.
33
- *
34
- * @returns {Promise<{ manager: object, dirPath: string }>}
35
- */
36
- async function managerAfterSeek() {
37
- const dirPath = await mkdtemp(path.join(os.tmpdir(), "seek-target-"));
38
- const manager = wireOutputs({
39
- enabled: true,
40
- ffmpegBin: "ffmpeg",
41
- localBindHost: "127.0.0.1",
42
- localPort: 9090
43
- });
44
- const session = {
45
- id: SESSION_ID,
46
- dirPath,
47
- // Where this file is cut, held by the file. A fixture that stated it
48
- // on the session was describing what production no longer does.
49
- timeline: new Timeline({
50
- boundaries: Array.from({ length: 400 }, (_, index) => index * SEGMENT_SECONDS),
51
- cutGrid: "uniform"
52
- }),
53
- state: "ready",
54
- file: new SourceFile({ sourceKey: "source-1", fileIndex: 0, name: "film.mkv" }),
55
- // An ordinary session reads its own file, and its sound is inside it. The
56
- // three differ only for a soundtrack shipped as a file of its own.
57
- get inputFile() { return this.file; },
58
- get audioFile() { return this.file; },
59
- startedAt: Date.now(),
60
- lastAccessedAt: Date.now(),
61
- consumers: new Set(),
62
- segmentFormat: fmp4Format,
63
- transcodeVideo: false,
64
- useSyntheticPlaylist: true,
65
- segmentCount: 399,
66
- encodeStartIndex: SEGMENT_AT_SEEK,
67
- waitEpoch: 1,
68
- runState: "PRODUCING"
69
- };
70
- manager.outputs.set(SESSION_ID, session);
71
- manager.viewers.of(session, "viewer").moveTo(SEEK_TO_SECONDS);
72
- manager.viewers.of(session, "viewer").playing = false;
73
- return { manager, dirPath };
74
- }
75
-
76
- test("the segment at the seek target is still wanted", async () => {
77
- const { manager, dirPath } = await managerAfterSeek();
78
-
79
- assert.equal(
80
- manager.serving.requestStillWanted(SESSION_ID, `segment-${String(SEGMENT_AT_SEEK).padStart(5, "0")}.mp4`),
81
- true,
82
- "this is the segment the viewer is waiting for; refusing it is what froze the field session"
83
- );
84
-
85
- await rm(dirPath, { recursive: true, force: true });
86
- });
87
-
88
- test("a segment behind the viewer is not wanted any more", async () => {
89
- const { manager, dirPath } = await managerAfterSeek();
90
-
91
- assert.equal(
92
- manager.serving.requestStillWanted(SESSION_ID, `segment-${String(SEGMENT_AT_SEEK - 3).padStart(5, "0")}.mp4`),
93
- false,
94
- "a request for the position the viewer left is exactly what the epoch exists to release"
95
- );
96
-
97
- await rm(dirPath, { recursive: true, force: true });
98
- });
99
-
100
- test("a segment far beyond what the run will reach is not wanted", async () => {
101
- const { manager, dirPath } = await managerAfterSeek();
102
-
103
- assert.equal(
104
- manager.serving.requestStillWanted(SESSION_ID, `segment-${String(SEGMENT_AT_SEEK + 200).padStart(5, "0")}.mp4`),
105
- false,
106
- "nothing will produce it before the viewer moves again"
107
- );
108
-
109
- await rm(dirPath, { recursive: true, force: true });
110
- });
111
-
112
- test("a playlist belongs to no position and is never stale", async () => {
113
- const { manager, dirPath } = await managerAfterSeek();
114
-
115
- assert.equal(manager.serving.requestStillWanted(SESSION_ID, "index.m3u8"), true);
116
- assert.equal(manager.serving.requestStillWanted(SESSION_ID, "init.mp4"), true);
117
-
118
- await rm(dirPath, { recursive: true, force: true });
119
- });
120
-
121
- test("a request as deep as the cushion the browser is told to hold is still wanted", async () => {
122
- const { manager, dirPath } = await managerAfterSeek();
123
-
124
- // The browser sizes its forward buffer from the proxy's own look-ahead, so
125
- // the deepest request it can make is one for the segment at the far edge of
126
- // that cushion. Refusing it would be refusing the very depth this proxy
127
- // asked for: at the old width — eight segments ahead of the viewer — three
128
- // quarters of a full cushion's requests were stale by definition.
129
- const edge = Math.floor((SEEK_TO_SECONDS + manager.lookaheadSeconds) / SEGMENT_SECONDS);
130
-
131
- assert.ok(edge - SEGMENT_AT_SEEK > 8, "the case only exists past the old eight-segment width");
132
- assert.equal(
133
- manager.serving.requestStillWanted(SESSION_ID, `segment-${String(edge).padStart(5, "0")}.mp4`),
134
- true,
135
- "the far edge of the cushion the proxy itself keeps produced"
136
- );
137
-
138
- await rm(dirPath, { recursive: true, force: true });
139
- });
140
-
141
- test("the viewer who made the request is the one it is judged against", async () => {
142
- const { manager, dirPath } = await managerAfterSeek();
143
- const session = manager.outputs.get(SESSION_ID);
144
- session.viewers = new Map();
145
- // Two people watching one copied picture: one at the seek target, one a
146
- // hundred segments back and waiting for a segment there. Asked about nobody
147
- // in particular the answer is the FURTHEST of them, because what lies behind
148
- // that one has already been made.
149
- const behind = SEGMENT_AT_SEEK - 100;
150
- manager.viewers.of(session, "behind").moveTo(behind * SEGMENT_SECONDS);
151
- manager.viewers.of(session, "behind").playing = false;
152
- manager.viewers.of(session, "ahead").moveTo(SEEK_TO_SECONDS);
153
- manager.viewers.of(session, "ahead").playing = false;
154
-
155
- assert.equal(
156
- manager.serving.requestStillWanted(SESSION_ID, `segment-${String(behind).padStart(5, "0")}.mp4`, "behind"),
157
- true,
158
- "held for the viewer who is there, whatever the viewer in front is doing"
159
- );
160
- assert.equal(
161
- manager.serving.requestStillWanted(SESSION_ID, `segment-${String(behind).padStart(5, "0")}.mp4`),
162
- false,
163
- "unnamed, it is judged against the furthest viewer, which is the leader"
164
- );
165
-
166
- await rm(dirPath, { recursive: true, force: true });
167
- });
168
-
169
- test("a seek moves the seeking viewer's own head, and nobody else's", async () => {
170
- const { manager, dirPath } = await managerAfterSeek();
171
- const session = manager.outputs.get(SESSION_ID);
172
- session.viewers = new Map();
173
- const staying = SEGMENT_AT_SEEK - 40;
174
- manager.viewers.of(session, "staying").position = {
175
- segment: staying,
176
- seconds: staying * SEGMENT_SECONDS,
177
- at: Date.now()
178
- };
179
-
180
- const jumpTo = 120;
181
- manager.viewerRequests.requestSeek(SESSION_ID, jumpTo, "jumping");
182
-
183
- assert.equal(
184
- manager.serving.requestStillWanted(SESSION_ID, `segment-${String(Math.floor(jumpTo / SEGMENT_SECONDS)).padStart(5, "0")}.mp4`, "jumping"),
185
- true,
186
- "the segment at the seek target — the request that raced the epoch in 2026-08-18"
187
- );
188
- assert.equal(
189
- manager.serving.requestStillWanted(SESSION_ID, `segment-${String(staying).padStart(5, "0")}.mp4`, "staying"),
190
- true,
191
- "somebody else's seek does not move where this viewer is"
192
- );
193
-
194
- await rm(dirPath, { recursive: true, force: true });
195
- });
@@ -1,114 +0,0 @@
1
- /**
2
- * @file A piece is closed by one of two writers, and both must say so.
3
- *
4
- * The `segment` muxer writes under a working name and reports the closure on a
5
- * channel of its own, which reaches `SegmentStore.publish`. The `hls` muxer
6
- * writes through a temporary name of its own (`+temp_file`) and reports
7
- * nothing: the file simply appears under the name it is served as. That branch
8
- * is taken by every re-encoded output cut on the even grid — an ordinary
9
- * quality step — and for it a wait could only end on its deadline, so a segment
10
- * lying finished on disk was answered 503 after the whole hold.
11
- */
12
-
13
- import test from "node:test";
14
- import assert from "node:assert/strict";
15
- import { mkdtempSync, renameSync, rmSync, writeFileSync } from "node:fs";
16
- import os from "node:os";
17
- import path from "node:path";
18
- import { SegmentStore } from "../services/storage/segment-store/SegmentStore.js";
19
- import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
20
-
21
- const KEY = "torrent:abc:fmt=fmp4:grid=uniform@0:video-only:v=libx264/854x480";
22
-
23
- /** A deadline is the backstop of these waits, never what they measure. */
24
- const BACKSTOP_MS = 10_000;
25
-
26
- /**
27
- * @returns {{ store: SegmentStore, root: string }}
28
- */
29
- function storeInATempRoot() {
30
- const root = mkdtempSync(path.join(os.tmpdir(), "segment-closed-"));
31
- const store = new SegmentStore({ root, logger: { info: () => {}, warn: () => {} } });
32
- store.useFormat(KEY, fmp4Format);
33
- return { store, root };
34
- }
35
-
36
- test("a piece that simply appears ends the wait that began before it", async (t) => {
37
- const { store, root } = storeInATempRoot();
38
- t.after(() => {
39
- store.dropAll("the test is over");
40
- rmSync(root, { recursive: true, force: true });
41
- });
42
-
43
- const dir = store.directoryFor(KEY);
44
- // The wait begins on a segment nobody has written yet — the cold case, and
45
- // the only one the deadline used to decide.
46
- const waited = store.waitFor(KEY, 7, BACKSTOP_MS);
47
-
48
- // What the `hls` muxer does: a temporary name of its own, renamed into place
49
- // when the piece is whole. Nothing is told; the directory simply moves.
50
- const temp = path.join(dir, "segment-00007.mp4.tmp");
51
- writeFileSync(temp, Buffer.alloc(64));
52
- renameSync(temp, path.join(dir, fmp4Format.segmentFileName(7)));
53
-
54
- assert.equal(await waited, true, "the piece was on disk and the wait did not end");
55
- assert.ok(store.pathOf(KEY, 7), "and the store must be able to hand it over");
56
- });
57
-
58
- test("clearing up after a run is not its pieces arriving", async (t) => {
59
- const { store, root } = storeInATempRoot();
60
- t.after(() => {
61
- store.dropAll("the test is over");
62
- rmSync(root, { recursive: true, force: true });
63
- });
64
-
65
- const dir = store.directoryFor(KEY);
66
- const unfinished = path.join(dir, fmp4Format.makingFileNameTemplate("3").replace("%05d", "00009"));
67
- writeFileSync(unfinished, Buffer.alloc(64));
68
-
69
- let ended = false;
70
- // 200 ms is a grace before asserting that something did NOT happen, which can
71
- // only ever pass too easily — never a measurement.
72
- const waited = store.waitFor(KEY, 9, 200).then((value) => {
73
- ended = value;
74
- return value;
75
- });
76
- rmSync(unfinished, { force: true });
77
-
78
- assert.equal(await waited, false, "a directory that moved because a file went holds nothing new");
79
- assert.equal(ended, false);
80
- });
81
-
82
- test("the writer that does report a closure is unaffected", async (t) => {
83
- const { store, root } = storeInATempRoot();
84
- t.after(() => {
85
- store.dropAll("the test is over");
86
- rmSync(root, { recursive: true, force: true });
87
- });
88
-
89
- const dir = store.directoryFor(KEY);
90
- const making = fmp4Format.makingFileNameTemplate("4").replace("%05d", "00004");
91
- writeFileSync(path.join(dir, making), Buffer.alloc(64));
92
-
93
- const waited = store.waitFor(KEY, 4, BACKSTOP_MS);
94
- assert.equal(store.publish(KEY, making, fmp4Format), fmp4Format.segmentFileName(4));
95
- assert.equal(await waited, true);
96
- });
97
-
98
- test("a directory removed from outside and made again is watched again", async (t) => {
99
- const { store, root } = storeInATempRoot();
100
- t.after(() => {
101
- store.dropAll("the test is over");
102
- rmSync(root, { recursive: true, force: true });
103
- });
104
-
105
- // Removed by something other than the store, so its watch was not stopped
106
- // first. The watch held on that path watches a directory that is gone.
107
- rmSync(store.directoryFor(KEY), { recursive: true, force: true });
108
- const dir = store.directoryFor(KEY);
109
- const waited = store.waitFor(KEY, 3, BACKSTOP_MS);
110
-
111
- writeFileSync(path.join(dir, fmp4Format.segmentFileName(3)), Buffer.alloc(64));
112
-
113
- assert.equal(await waited, true, "the piece arrived in the new directory and the wait did not end");
114
- });