@torrent-tv/proxy 2.89.17 → 2.89.19

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 (300) hide show
  1. package/README.md +14 -3
  2. package/package.json +10 -2
  3. package/server.js +0 -11
  4. package/utils/client-log-file.js +147 -42
  5. package/.claude/commands/opsx/apply.md +0 -155
  6. package/.claude/commands/opsx/archive.md +0 -160
  7. package/.claude/commands/opsx/explore.md +0 -174
  8. package/.claude/commands/opsx/propose.md +0 -109
  9. package/.claude/commands/opsx/sync.md +0 -143
  10. package/.claude/skills/openspec-apply-change/SKILL.md +0 -159
  11. package/.claude/skills/openspec-archive-change/SKILL.md +0 -117
  12. package/.claude/skills/openspec-explore/SKILL.md +0 -289
  13. package/.claude/skills/openspec-propose/SKILL.md +0 -113
  14. package/.claude/skills/openspec-sync-specs/SKILL.md +0 -147
  15. package/.dockerignore +0 -5
  16. package/AGENTS.md +0 -363
  17. package/CHANGELOG.md +0 -2377
  18. package/Dockerfile +0 -30
  19. package/biome.json +0 -412
  20. package/corpus.tmp.json +0 -1
  21. package/docs/browser-proxy-contract.md +0 -155
  22. package/docs/container-architecture.md +0 -273
  23. package/docs/download-architecture.md +0 -261
  24. package/docs/encode-architecture.md +0 -765
  25. package/docs/encode-run-state.md +0 -96
  26. package/docs/logs.md +0 -151
  27. package/docs/playback-start-forecast.md +0 -113
  28. package/docs/socks5-egress-research.md +0 -114
  29. package/docs/storage-architecture.md +0 -273
  30. package/knip.json +0 -14
  31. package/main2.cpuprofile +0 -1
  32. package/openspec/changes/adaptive-bitrate/.openspec.yaml +0 -0
  33. package/openspec/changes/adaptive-bitrate/design.md +0 -92
  34. package/openspec/changes/adaptive-bitrate/proposal.md +0 -56
  35. package/openspec/changes/adaptive-bitrate/specs/adaptive-bitrate/spec.md +0 -51
  36. package/openspec/changes/adaptive-bitrate/tasks.md +0 -40
  37. package/openspec/changes/binary-distribution/.openspec.yaml +0 -2
  38. package/openspec/changes/binary-distribution/proposal.md +0 -53
  39. package/openspec/changes/chunked-request-bodies/design.md +0 -81
  40. package/openspec/changes/chunked-request-bodies/proposal.md +0 -53
  41. package/openspec/changes/chunked-request-bodies/specs/chunked-request-bodies/spec.md +0 -30
  42. package/openspec/changes/chunked-request-bodies/tasks.md +0 -40
  43. package/openspec/changes/cold-start/design.md +0 -98
  44. package/openspec/changes/cold-start/proposal.md +0 -62
  45. package/openspec/changes/cold-start/specs/cold-start/spec.md +0 -47
  46. package/openspec/changes/cold-start/tasks.md +0 -48
  47. package/openspec/changes/disk-cap/.openspec.yaml +0 -2
  48. package/openspec/changes/disk-cap/proposal.md +0 -37
  49. package/openspec/changes/disk-cap/specs/disk-cap/spec.md +0 -25
  50. package/openspec/changes/disk-cap/tasks.md +0 -19
  51. package/openspec/changes/proxy-observability/.openspec.yaml +0 -2
  52. package/openspec/changes/proxy-observability/design.md +0 -38
  53. package/openspec/changes/proxy-observability/proposal.md +0 -49
  54. package/openspec/changes/proxy-observability/specs/observability/spec.md +0 -33
  55. package/openspec/changes/proxy-observability/tasks.md +0 -21
  56. package/openspec/changes/seek-debounce/.openspec.yaml +0 -0
  57. package/openspec/changes/seek-debounce/design.md +0 -118
  58. package/openspec/changes/seek-debounce/proposal.md +0 -59
  59. package/openspec/changes/seek-debounce/specs/seek-debounce/spec.md +0 -41
  60. package/openspec/changes/seek-debounce/tasks.md +0 -33
  61. package/openspec/changes/subtitle-language/.openspec.yaml +0 -2
  62. package/openspec/changes/subtitle-language/proposal.md +0 -50
  63. package/openspec/changes/subtitle-language/specs/subtitle-language/spec.md +0 -34
  64. package/openspec/changes/subtitle-language/tasks.md +0 -26
  65. package/openspec/changes/track-selection/.openspec.yaml +0 -2
  66. package/openspec/changes/track-selection/design.md +0 -47
  67. package/openspec/changes/track-selection/proposal.md +0 -45
  68. package/openspec/changes/track-selection/specs/track-selection/spec.md +0 -41
  69. package/openspec/changes/track-selection/tasks.md +0 -20
  70. package/openspec/changes/transcode-quality/.openspec.yaml +0 -2
  71. package/openspec/changes/transcode-quality/proposal.md +0 -51
  72. package/openspec/changes/transcode-quality/specs/transcode-quality/spec.md +0 -139
  73. package/openspec/changes/transcode-quality/tasks.md +0 -63
  74. package/openspec/config.yaml +0 -38
  75. package/public/.well-known/appspecific/com.chrome.devtools.json +0 -1
  76. package/research/delivery-wedge-stand-ladder-2026-09-13.md +0 -329
  77. package/research/double-spawn-2026-09-10.md +0 -171
  78. package/research/handover-2026-09-13.md +0 -209
  79. package/research/handover-reader-claims-removal-2026-09-12.md +0 -166
  80. package/research/piece-withdrawn-but-still-claimed-2026-09-12.md +0 -175
  81. package/research/preset-benchmark-size-scaling-2026-08-22.md +0 -55
  82. package/research/priority-map-is-the-truth-2026-09-12.md +0 -225
  83. package/research/valgrind-replica-2026-08-27/logs.tar.gz +0 -0
  84. package/scripts/build-audio-samples.mjs +0 -31
  85. package/scripts/render-run-graph.js +0 -173
  86. package/test/asset-paths.test.js +0 -28
  87. package/test/audio-buffer-continuity.test.js +0 -77
  88. package/test/audio-calibration.test.js +0 -23
  89. package/test/audio-inventory.test.js +0 -212
  90. package/test/audio-track-bitrate.test.js +0 -40
  91. package/test/audio-warm-recorded.test.js +0 -63
  92. package/test/auto-quality-step.test.js +0 -762
  93. package/test/available-share.test.js +0 -76
  94. package/test/background-fill.test.js +0 -190
  95. package/test/client-log-file.test.js +0 -126
  96. package/test/client-logs-route.test.js +0 -34
  97. package/test/coalesce.test.js +0 -39
  98. package/test/completed-files.test.js +0 -115
  99. package/test/concurrent-cost.test.js +0 -148
  100. package/test/container-media-info.test.js +0 -228
  101. package/test/contention.test.js +0 -76
  102. package/test/core-dumps.test.js +0 -57
  103. package/test/coverage-follows-the-disk.test.js +0 -233
  104. package/test/coverage-map.test.js +0 -195
  105. package/test/cue-push-carries-what-the-walk-found.test.js +0 -58
  106. package/test/cut-times-timeline.test.js +0 -65
  107. package/test/cuts-follow-published-grid.test.js +0 -109
  108. package/test/data-channel-frame.test.js +0 -63
  109. package/test/data-channel-viewer-lifecycle.test.js +0 -193
  110. package/test/dead-torrent-handle.test.js +0 -52
  111. package/test/declared-rates.test.js +0 -116
  112. package/test/declared-tracks.test.js +0 -43
  113. package/test/decode-cost-fit.test.js +0 -202
  114. package/test/decode-cost.test.js +0 -475
  115. package/test/delivery-probe-field.test.js +0 -173
  116. package/test/delivery-probe.test.js +0 -382
  117. package/test/demand-register.test.js +0 -206
  118. package/test/dht-bootstrap.test.js +0 -72
  119. package/test/drain-threat.test.js +0 -65
  120. package/test/duplicate-add.test.js +0 -48
  121. package/test/encode-admission.test.js +0 -170
  122. package/test/encode-cost.test.js +0 -275
  123. package/test/encode-exit.test.js +0 -111
  124. package/test/encode-orchestrator.test.js +0 -426
  125. package/test/encode-plan-viewers.test.js +0 -725
  126. package/test/encode-plan.test.js +0 -545
  127. package/test/encode-run-state.test.js +0 -314
  128. package/test/encode-run.test.js +0 -248
  129. package/test/encode-slope.test.js +0 -46
  130. package/test/encoded-output.test.js +0 -39
  131. package/test/encoder-kinds.test.js +0 -122
  132. package/test/encoder-readings.test.js +0 -68
  133. package/test/episode-naming.test.js +0 -131
  134. package/test/every-claimant-is-told-its-share.test.js +0 -152
  135. package/test/failed-encoder-still-serves-what-exists.test.js +0 -354
  136. package/test/failed-start-breaker.test.js +0 -202
  137. package/test/fastest-wires.test.js +0 -143
  138. package/test/ffmpeg-stream-counts.test.js +0 -101
  139. package/test/file-edges.test.js +0 -191
  140. package/test/files-in-use.test.js +0 -34
  141. package/test/fixtures/audio-frame-boundary.json +0 -1
  142. package/test/fixtures/refused-audio-20261002.json +0 -10
  143. package/test/fmp4-presentation-clock.test.js +0 -148
  144. package/test/fmp4-self-contained.test.js +0 -80
  145. package/test/fmp4-timestamps.test.js +0 -140
  146. package/test/fmp4-track-completeness.test.js +0 -41
  147. package/test/format-keyed-outputs.test.js +0 -78
  148. package/test/health-metrics.test.js +0 -36
  149. package/test/held-read-ownership.test.js +0 -77
  150. package/test/held-request-width.test.js +0 -157
  151. package/test/helpers/encode-run.js +0 -248
  152. package/test/helpers/held-file.js +0 -77
  153. package/test/helpers/manager.js +0 -62
  154. package/test/helpers/matroska-file.js +0 -296
  155. package/test/helpers/output-spec.js +0 -63
  156. package/test/host-load.test.js +0 -68
  157. package/test/index-accuracy-is-about-the-file.test.js +0 -128
  158. package/test/init-compat.test.js +0 -219
  159. package/test/input-lost-quiets-the-plan.test.js +0 -261
  160. package/test/input-unavailable.test.js +0 -48
  161. package/test/installation-id.test.js +0 -39
  162. package/test/keeping-period.test.js +0 -83
  163. package/test/keyframe-index-accuracy.test.js +0 -188
  164. package/test/keyframe-table-budget.test.js +0 -123
  165. package/test/keyframes-belong-to-the-file.test.js +0 -249
  166. package/test/learned-median.test.js +0 -37
  167. package/test/letting-go-asks-who-is-watching.test.js +0 -191
  168. package/test/limit-row-by-area.test.js +0 -60
  169. package/test/link-budget.test.js +0 -111
  170. package/test/link-probe.test.js +0 -56
  171. package/test/local-encoding-data.test.js +0 -273
  172. package/test/logger-repeats.test.js +0 -134
  173. package/test/look-ahead-coverage.test.js +0 -56
  174. package/test/manager-surface.test.js +0 -291
  175. package/test/matroska-blocks.test.js +0 -0
  176. package/test/matroska-cluster-discovery.test.js +0 -323
  177. package/test/matroska-cues-track.test.js +0 -192
  178. package/test/media-time.test.js +0 -62
  179. package/test/memory-budget.test.js +0 -390
  180. package/test/move-cost.test.js +0 -216
  181. package/test/mp4-composition-times.test.js +0 -0
  182. package/test/mp4-subtitles.test.js +0 -173
  183. package/test/one-authority.test.js +0 -285
  184. package/test/one-budget.test.js +0 -149
  185. package/test/one-output-one-session.test.js +0 -273
  186. package/test/one-resource-divided.test.js +0 -185
  187. package/test/one-serving-output-per-height.test.js +0 -458
  188. package/test/orchestrator-wired.test.js +0 -207
  189. package/test/output-catalog.test.js +0 -39
  190. package/test/output-shape.test.js +0 -21
  191. package/test/output-spec.test.js +0 -251
  192. package/test/output-speed.test.js +0 -92
  193. package/test/outputs-being-prepared.test.js +0 -40
  194. package/test/packet-witness-ring.test.js +0 -236
  195. package/test/packet-witness.test.js +0 -148
  196. package/test/piece-completeness.test.js +0 -78
  197. package/test/piece-disk-store.test.js +0 -401
  198. package/test/piece-from-whole-file.test.js +0 -129
  199. package/test/piece-lru.test.js +0 -319
  200. package/test/piece-reader.test.js +0 -162
  201. package/test/piece-selection-offset.test.js +0 -85
  202. package/test/piece-store-eviction.test.js +0 -595
  203. package/test/piece-store-never-refuses.test.js +0 -153
  204. package/test/piece-store-reservations.test.js +0 -403
  205. package/test/piece-store-slow-disk.test.js +0 -159
  206. package/test/piece-tail.test.js +0 -97
  207. package/test/plan-host-timings.test.js +0 -68
  208. package/test/plan-is-steady.test.js +0 -225
  209. package/test/playback-readiness.test.js +0 -518
  210. package/test/playback-start-regressions.test.js +0 -101
  211. package/test/priority-map-download.test.js +0 -174
  212. package/test/priority-map-emptied.test.js +0 -204
  213. package/test/priority-map-per-output.test.js +0 -215
  214. package/test/priority-map.test.js +0 -163
  215. package/test/probe-wedge-certainty.test.js +0 -60
  216. package/test/produced-copy-choice.test.js +0 -213
  217. package/test/published-timeline.test.js +0 -83
  218. package/test/quality-offer.test.js +0 -160
  219. package/test/quality-variants.test.js +0 -1274
  220. package/test/rate-control-in-the-output.test.js +0 -181
  221. package/test/read-survives-withdrawal.test.js +0 -164
  222. package/test/read-window.test.js +0 -365
  223. package/test/reads-not-yet-arrived.test.js +0 -218
  224. package/test/resume-warm.test.js +0 -39
  225. package/test/run-graph-drift.test.js +0 -37
  226. package/test/run-inputs.test.js +0 -80
  227. package/test/run-intervals.test.js +0 -100
  228. package/test/run-position-follows-published-grid.test.js +0 -89
  229. package/test/run-progress.test.js +0 -64
  230. package/test/same-height-switch.test.js +0 -663
  231. package/test/seek-frees-the-viewers-requests.test.js +0 -217
  232. package/test/seek-landing.test.js +0 -109
  233. package/test/seek-target-not-superseded.test.js +0 -195
  234. package/test/segment-closed-on-both-branches.test.js +0 -114
  235. package/test/segment-cut-times.test.js +0 -63
  236. package/test/segment-demand.test.js +0 -80
  237. package/test/segment-hold-supersede.test.js +0 -91
  238. package/test/segment-judged-by-its-own-header.test.js +0 -222
  239. package/test/segment-serve-wiring.test.js +0 -481
  240. package/test/segment-store-eviction.test.js +0 -247
  241. package/test/segment-store.test.js +0 -352
  242. package/test/segment-true-start.test.js +0 -86
  243. package/test/segments-are-shared.test.js +0 -176
  244. package/test/send-chunk-bytes.test.js +0 -86
  245. package/test/serving-existing-output.test.js +0 -111
  246. package/test/serving-output.test.js +0 -102
  247. package/test/shared-piece-store.test.js +0 -310
  248. package/test/sidecar-naming.test.js +0 -142
  249. package/test/soundtrack-rate-bound.test.js +0 -289
  250. package/test/source-file.test.js +0 -133
  251. package/test/source-files-route.test.js +0 -113
  252. package/test/source-registry.test.js +0 -18
  253. package/test/split-a-stretch.test.js +0 -139
  254. package/test/stale-request-after-seek.test.js +0 -158
  255. package/test/startup-readings.test.js +0 -124
  256. package/test/stream-route.test.js +0 -237
  257. package/test/subtitle-cue-framing.test.js +0 -200
  258. package/test/subtitle-cue-source.test.js +0 -102
  259. package/test/subtitle-cue-walk.test.js +0 -385
  260. package/test/subtitle-cursor.test.js +0 -63
  261. package/test/subtitle-defaults.test.js +0 -118
  262. package/test/subtitle-language.test.js +0 -252
  263. package/test/subtitle-metadata.test.js +0 -15
  264. package/test/subtitle-plan-waits.test.js +0 -125
  265. package/test/subtitle-track-numbering.test.js +0 -391
  266. package/test/supply-margin.test.js +0 -190
  267. package/test/swarm-follows-readers.test.js +0 -174
  268. package/test/swarm-reach.test.js +0 -130
  269. package/test/swarm-selection.test.js +0 -220
  270. package/test/tail-duplication.test.js +0 -167
  271. package/test/the-channel-has-both-ends.test.js +0 -91
  272. package/test/the-torrent-thread-serves-bytes.test.js +0 -107
  273. package/test/thread-pool.test.js +0 -53
  274. package/test/timeline.test.js +0 -84
  275. package/test/torrent-contents.test.js +0 -235
  276. package/test/torrent-cost.test.js +0 -71
  277. package/test/torrent-files.test.js +0 -221
  278. package/test/torrent-naming.test.js +0 -255
  279. package/test/tracks-begin-together.test.js +0 -209
  280. package/test/tunnel-renewal.test.js +0 -167
  281. package/test/two-viewers-one-picture.test.js +0 -508
  282. package/test/upload-hurry.test.js +0 -186
  283. package/test/usrsctp-state.test.js +0 -131
  284. package/test/video-facts.test.js +0 -102
  285. package/test/viewer-assignments.test.js +0 -143
  286. package/test/viewer-outputs.test.js +0 -285
  287. package/test/viewer-presence.test.js +0 -116
  288. package/test/viewer-requests-admission.test.js +0 -92
  289. package/test/viewer-starts-on-map.test.js +0 -27
  290. package/test/viewer-states.test.js +0 -192
  291. package/test/viewer-subtitle-subscription.test.js +0 -96
  292. package/test/viewer.test.js +0 -139
  293. package/test/viewing-generations.test.js +0 -390
  294. package/test/visible-rung.test.js +0 -37
  295. package/test/wait-ledger.test.js +0 -100
  296. package/test/webrtc-shim.test.js +0 -149
  297. package/test/wedge-certainty.test.js +0 -131
  298. package/test/whole-file-held-read.test.js +0 -30
  299. package/test/withdraw-piece-claim.test.js +0 -212
  300. 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
- });