@torrent-tv/proxy 2.86.0 → 2.87.1

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 (385) hide show
  1. package/CHANGELOG.md +2142 -1915
  2. package/CLAUDE.md +322 -197
  3. package/assets/calibration/NOTICE.md +2 -2
  4. package/bin/cli.js +684 -616
  5. package/biome.json +409 -233
  6. package/docs/browser-proxy-contract.md +94 -0
  7. package/docs/container-architecture.md +218 -213
  8. package/docs/download-architecture.md +7 -7
  9. package/docs/encode-architecture.md +287 -11
  10. package/docs/encode-run-state.md +2 -2
  11. package/docs/logs.md +97 -97
  12. package/docs/{disk-architecture.md → storage-architecture.md} +107 -1
  13. package/openspec/changes/adaptive-bitrate/design.md +2 -2
  14. package/openspec/changes/adaptive-bitrate/proposal.md +1 -1
  15. package/openspec/changes/adaptive-bitrate/tasks.md +1 -1
  16. package/openspec/changes/chunked-request-bodies/design.md +1 -1
  17. package/openspec/changes/chunked-request-bodies/proposal.md +1 -1
  18. package/openspec/changes/chunked-request-bodies/tasks.md +1 -1
  19. package/openspec/changes/cold-start/design.md +1 -1
  20. package/openspec/changes/disk-cap/proposal.md +1 -1
  21. package/openspec/changes/proxy-observability/proposal.md +2 -2
  22. package/openspec/changes/track-selection/proposal.md +1 -1
  23. package/openspec/changes/transcode-quality/proposal.md +1 -1
  24. package/package.json +2 -2
  25. package/research/delivery-wedge-stand-ladder-2026-09-13.md +329 -329
  26. package/research/double-spawn-2026-09-10.md +171 -171
  27. package/routes/api/playback-plan/post.js +2 -2
  28. package/routes/api/sources/files/get.js +1 -1
  29. package/routes/api/sources/stats/get.js +1 -1
  30. package/routes/api/sources/warm/post.js +10 -3
  31. package/routes/api/subtitles/get.js +230 -230
  32. package/routes/api/transcode-sessions/fragment-far/post.js +3 -3
  33. package/routes/api/transcode-sessions/net-report/post.js +129 -94
  34. package/routes/api/transcode-sessions/post.js +160 -139
  35. package/routes/api/transcode-sessions/progress/get.js +3 -3
  36. package/routes/api/transcode-sessions/release/post.js +3 -3
  37. package/routes/api/transcode-sessions/seek/post.js +12 -3
  38. package/routes/stream/get.js +2 -2
  39. package/routes/transcode/audio-file/get.js +15 -6
  40. package/routes/transcode/audio-warm/get.js +9 -6
  41. package/routes/transcode/session-file/get.js +52 -268
  42. package/routes/transcode/variant-file/get.js +46 -7
  43. package/routes/transcode/variant-warm/get.js +19 -6
  44. package/scripts/render-run-graph.js +1 -1
  45. package/server.js +720 -465
  46. package/services/encode/CoverageMap.js +428 -428
  47. package/services/encode/CushionReport.js +345 -0
  48. package/services/encode/EncodeAdmission.js +332 -0
  49. package/services/{orchestrators → encode}/EncodeOrchestrator.js +307 -29
  50. package/services/encode/EncodeRun.js +16 -9
  51. package/services/encode/EncodeRuns.js +1229 -0
  52. package/services/encode/Encoder.js +18 -2
  53. package/services/encode/EncoderSelection.js +38 -0
  54. package/services/encode/LocalObservations.js +359 -0
  55. package/services/encode/NvencEncoder.js +5 -0
  56. package/services/encode/OutputOpening.js +755 -0
  57. package/services/encode/OutputTimes.js +579 -0
  58. package/services/encode/Renditions.js +2162 -0
  59. package/services/encode/RunProgress.js +84 -0
  60. package/services/encode/SoftwareEncoder.js +12 -7
  61. package/services/encode/args.js +402 -186
  62. package/services/encode/calibration.js +361 -0
  63. package/services/encode/contention.js +128 -128
  64. package/services/encode/encode-run-state.js +16 -20
  65. package/services/encode/fingerprint.js +322 -0
  66. package/services/{hwaccel.js → encode/hwaccel.js} +82 -42
  67. package/services/{learned-median.js → encode/learned-median.js} +11 -0
  68. package/services/encode/output/EncodedOutput.js +57 -0
  69. package/services/encode/output/Output.js +131 -0
  70. package/services/{output/LiveOutputs.js → encode/output/OutputCatalog.js} +141 -40
  71. package/services/encode/output/OutputSpec.js +390 -0
  72. package/services/{output → encode/output}/Timeline.js +12 -37
  73. package/services/encode/output/index.js +20 -0
  74. package/services/encode/output/ladder.js +32 -0
  75. package/services/{output → encode/output}/playlists.js +3 -0
  76. package/services/encode/output-key-format.js +21 -0
  77. package/services/encode/quality/EncodeCost.js +1083 -0
  78. package/services/encode/quality/HostLoad.js +525 -0
  79. package/services/encode/quality/HostTimings.js +249 -0
  80. package/services/encode/quality/OutputQualityState.js +28 -0
  81. package/services/encode/quality/QualityController.js +935 -0
  82. package/services/encode/quality/QualityOffer.js +416 -0
  83. package/services/encode/quality/drain-threat.js +47 -0
  84. package/services/encode/quality/link-budget.js +254 -0
  85. package/services/encode/quality/output-format.js +266 -0
  86. package/services/encode/quality/serving-output.js +216 -0
  87. package/services/encode/quality/visible-rung.js +57 -0
  88. package/services/encode/run-command.js +23 -20
  89. package/services/encode/run-inputs.js +42 -0
  90. package/services/{segment-formats → encode/segment-formats}/fmp4.js +63 -0
  91. package/services/{segment-formats → encode/segment-formats}/index.js +3 -3
  92. package/services/encode/segment-formats/init-compat.js +324 -0
  93. package/services/{segment-formats → encode/segment-formats}/mp4-boxes.js +8 -3
  94. package/services/encode/throughput.js +97 -0
  95. package/services/{orchestrators → media}/ContainerOrchestrator.js +45 -7
  96. package/services/media/KeyframeTables.js +316 -0
  97. package/services/{source → media}/SourceFile.js +7 -55
  98. package/services/{torrent-worker/subtitle-cues.js → media/SubtitleCues.js} +103 -132
  99. package/services/media/SubtitleOrchestrator.js +167 -0
  100. package/services/{audio-inventory.js → media/audio-inventory.js} +7 -1
  101. package/services/{container → media/container}/AviContainer.js +266 -266
  102. package/services/{container → media/container}/Container.js +596 -601
  103. package/services/media/container/ContainerFactory.js +56 -0
  104. package/services/media/container/KeyframeTable.js +272 -0
  105. package/services/{container → media/container}/MatroskaContainer.js +1485 -1485
  106. package/services/{container → media/container}/Mp4Container.js +1244 -1244
  107. package/services/{container → media/container}/SubtitleFileContainer.js +322 -322
  108. package/services/media/keyframe-probe.js +157 -0
  109. package/services/media/media-info-probe.js +93 -0
  110. package/services/{playback-planner.js → media/playback-planner.js} +82 -39
  111. package/services/{tracks → media/tracks}/AudioTrack.js +131 -131
  112. package/services/{tracks → media/tracks}/language-detect.js +174 -174
  113. package/services/server/OutputLifecycle.js +418 -0
  114. package/services/server/SegmentServing.js +1146 -0
  115. package/services/server/ViewerRequests.js +522 -0
  116. package/services/server/controllers/PlaybackController.js +36 -0
  117. package/services/{controllers → server/controllers}/SubtitleController.js +17 -33
  118. package/services/server/http-responses.js +60 -0
  119. package/services/server/transcode-session-files.js +325 -0
  120. package/services/server/wire-outputs.js +983 -0
  121. package/services/storage/Diagnostics.js +202 -0
  122. package/services/storage/MachineBudget.js +235 -0
  123. package/services/{piece-store → storage}/allowance.js +107 -107
  124. package/services/{core-dumps.js → storage/core-dumps.js} +1 -1
  125. package/services/{files → storage/files}/CompletedFiles.js +116 -1
  126. package/services/{disk → storage}/free.js +33 -0
  127. package/services/storage/machine-memory.js +56 -0
  128. package/services/{memory-report.js → storage/memory-report.js} +575 -596
  129. package/services/{piece-store → storage/piece-store}/piece-disk-store.js +0 -7
  130. package/services/{piece-store → storage/piece-store}/shared-piece-store.js +28 -21
  131. package/services/{encode → storage/segment-store}/SegmentStore.js +395 -8
  132. package/services/storage/wire.js +175 -0
  133. package/services/{download → torrent/download}/SwarmSelection.js +2 -2
  134. package/services/{download → torrent/download}/registry.js +2 -2
  135. package/services/torrent/files.js +1 -1
  136. package/services/torrent/piece-store-of.js +29 -0
  137. package/services/{torrent-pool.js → torrent/torrent-pool.js} +26 -119
  138. package/services/{torrent-worker → torrent/worker}/background-fill.js +2 -2
  139. package/services/{torrent-worker → torrent/worker}/channel.js +271 -250
  140. package/services/{torrent-worker → torrent/worker}/client.js +77 -58
  141. package/services/torrent/worker/held-bytes.js +155 -0
  142. package/services/{torrent-worker → torrent/worker}/install-webrtc-shim.js +1 -1
  143. package/services/{torrent-worker → torrent/worker}/piece-reader.js +21 -30
  144. package/services/{torrent-worker → torrent/worker}/pool-adapter.js +101 -137
  145. package/services/{torrent-worker → torrent/worker}/protocol.js +26 -30
  146. package/services/torrent/worker/resume-warm.js +107 -0
  147. package/services/{torrent-worker → torrent/worker}/webrtc-shim.js +2 -2
  148. package/services/{torrent-worker → torrent/worker}/worker.js +68 -159
  149. package/services/{data-channel-handler.js → transport/data-channel-handler.js} +1356 -1356
  150. package/services/{delivery-probe.js → transport/delivery-probe.js} +842 -842
  151. package/services/{health-collector.js → transport/health-collector.js} +6 -35
  152. package/services/{packet-witness.js → transport/packet-witness.js} +808 -784
  153. package/services/{port-mapper.js → transport/port-mapper.js} +1 -1
  154. package/services/{usrsctp-state.js → transport/usrsctp-state.js} +1 -1
  155. package/services/{webrtc-manager.js → transport/webrtc-manager.js} +1 -1
  156. package/services/viewer/Assignments.js +340 -0
  157. package/services/{priority → viewer}/PriorityMap.js +390 -390
  158. package/services/{priority → viewer}/PriorityOrchestrator.js +325 -320
  159. package/services/viewer/Viewer.js +657 -483
  160. package/services/viewer/Viewers.js +368 -257
  161. package/services/viewer/active-output.js +37 -54
  162. package/services/viewer/audio-start.js +4 -3
  163. package/services/viewer/buffer-trend.js +81 -0
  164. package/services/viewer/choices.js +647 -0
  165. package/services/viewer/positions.js +126 -120
  166. package/services/viewer/report-intake.js +46 -45
  167. package/test/asset-paths.test.js +28 -0
  168. package/test/audio-inventory.test.js +3 -3
  169. package/test/audio-track-bitrate.test.js +40 -0
  170. package/test/auto-quality-step.test.js +707 -515
  171. package/test/available-share.test.js +1 -1
  172. package/test/background-fill.test.js +1 -1
  173. package/test/client-log-file.test.js +110 -110
  174. package/test/completed-files.test.js +1 -1
  175. package/test/concurrent-cost.test.js +13 -3
  176. package/test/container-media-info.test.js +3 -3
  177. package/test/core-dumps.test.js +1 -1
  178. package/test/coverage-follows-the-disk.test.js +46 -9
  179. package/test/cue-push-carries-what-the-walk-found.test.js +58 -0
  180. package/test/cut-times-timeline.test.js +2 -2
  181. package/test/cuts-follow-published-grid.test.js +9 -8
  182. package/test/data-channel-frame.test.js +1 -1
  183. package/test/dead-torrent-handle.test.js +1 -1
  184. package/test/declared-rates.test.js +2 -2
  185. package/test/declared-tracks.test.js +2 -2
  186. package/test/decode-cost-fit.test.js +1 -1
  187. package/test/decode-cost.test.js +34 -25
  188. package/test/delivery-probe.test.js +1 -1
  189. package/test/demand-register.test.js +4 -4
  190. package/test/dht-bootstrap.test.js +1 -1
  191. package/test/drain-threat.test.js +65 -0
  192. package/test/duplicate-add.test.js +1 -1
  193. package/test/encode-admission.test.js +146 -0
  194. package/test/encode-cost.test.js +199 -10
  195. package/test/encode-orchestrator.test.js +39 -1
  196. package/test/encode-plan-viewers.test.js +2 -2
  197. package/test/encode-run.test.js +2 -2
  198. package/test/encode-slope.test.js +1 -1
  199. package/test/encoded-output.test.js +39 -0
  200. package/test/encoder-readings.test.js +1 -1
  201. package/test/every-claimant-is-told-its-share.test.js +152 -0
  202. package/test/failed-encoder-still-serves-what-exists.test.js +354 -0
  203. package/test/failed-start-breaker.test.js +81 -30
  204. package/test/fastest-wires.test.js +1 -1
  205. package/test/ffmpeg-stream-counts.test.js +1 -1
  206. package/test/file-edges.test.js +3 -3
  207. package/test/fmp4-self-contained.test.js +1 -1
  208. package/test/fmp4-timestamps.test.js +1 -1
  209. package/test/fmp4-track-completeness.test.js +1 -1
  210. package/test/format-keyed-outputs.test.js +78 -0
  211. package/test/health-metrics.test.js +3 -2
  212. package/test/held-request-width.test.js +22 -23
  213. package/test/helpers/encode-run.js +136 -136
  214. package/test/helpers/held-file.js +29 -0
  215. package/test/helpers/manager.js +57 -0
  216. package/test/helpers/output-spec.js +63 -0
  217. package/test/host-load.test.js +1 -1
  218. package/test/index-accuracy-is-about-the-file.test.js +128 -0
  219. package/test/init-compat.test.js +219 -0
  220. package/test/input-lost-quiets-the-plan.test.js +1 -1
  221. package/test/input-unavailable.test.js +1 -1
  222. package/test/keeping-period.test.js +4 -4
  223. package/test/keyframe-index-accuracy.test.js +97 -45
  224. package/test/keyframe-table-budget.test.js +28 -33
  225. package/test/keyframes-belong-to-the-file.test.js +174 -57
  226. package/test/learned-median.test.js +1 -1
  227. package/test/letting-go-asks-who-is-watching.test.js +191 -0
  228. package/test/limit-row-by-area.test.js +60 -0
  229. package/test/link-budget.test.js +111 -0
  230. package/test/link-probe.test.js +56 -56
  231. package/test/local-encoding-data.test.js +273 -0
  232. package/test/look-ahead-coverage.test.js +1 -1
  233. package/test/manager-surface.test.js +294 -0
  234. package/test/matroska-blocks.test.js +0 -0
  235. package/test/matroska-cues-track.test.js +1 -1
  236. package/test/memory-budget.test.js +2 -2
  237. package/test/mp4-composition-times.test.js +0 -0
  238. package/test/mp4-subtitles.test.js +1 -1
  239. package/test/one-authority.test.js +45 -41
  240. package/test/one-budget.test.js +149 -0
  241. package/test/one-output-one-session.test.js +204 -0
  242. package/test/{disk-space.test.js → one-resource-divided.test.js} +30 -10
  243. package/test/one-serving-output-per-height.test.js +458 -0
  244. package/test/orchestrator-wired.test.js +46 -45
  245. package/test/output-catalog.test.js +39 -0
  246. package/test/output-shape.test.js +4 -51
  247. package/test/output-spec.test.js +251 -157
  248. package/test/output-speed.test.js +17 -15
  249. package/test/outputs-being-prepared.test.js +40 -0
  250. package/test/packet-witness-ring.test.js +2 -2
  251. package/test/packet-witness.test.js +1 -1
  252. package/test/piece-disk-store.test.js +2 -2
  253. package/test/piece-from-whole-file.test.js +1 -1
  254. package/test/piece-lru.test.js +1 -1
  255. package/test/piece-reader.test.js +2 -2
  256. package/test/piece-store-eviction.test.js +1 -1
  257. package/test/piece-store-never-refuses.test.js +1 -1
  258. package/test/piece-store-reservations.test.js +1 -1
  259. package/test/piece-store-slow-disk.test.js +1 -1
  260. package/test/piece-tail.test.js +1 -1
  261. package/test/plan-host-timings.test.js +1 -1
  262. package/test/plan-is-steady.test.js +225 -225
  263. package/test/priority-map-download.test.js +4 -4
  264. package/test/priority-map-emptied.test.js +204 -205
  265. package/test/priority-map-per-output.test.js +215 -209
  266. package/test/priority-map.test.js +1 -1
  267. package/test/probe-wedge-certainty.test.js +1 -1
  268. package/test/produced-copy-choice.test.js +15 -60
  269. package/test/quality-offer.test.js +162 -0
  270. package/test/quality-variants.test.js +1229 -1167
  271. package/test/rate-control-in-the-output.test.js +180 -0
  272. package/test/read-survives-withdrawal.test.js +2 -2
  273. package/test/read-window.test.js +10 -3
  274. package/test/resume-warm.test.js +1 -1
  275. package/test/run-inputs.test.js +80 -0
  276. package/test/run-position-follows-published-grid.test.js +13 -11
  277. package/test/run-progress.test.js +65 -0
  278. package/test/same-height-switch.test.js +664 -0
  279. package/test/seek-frees-the-viewers-requests.test.js +217 -0
  280. package/test/seek-landing.test.js +13 -13
  281. package/test/seek-target-not-superseded.test.js +28 -29
  282. package/test/segment-closed-on-both-branches.test.js +96 -0
  283. package/test/segment-cut-times.test.js +1 -1
  284. package/test/segment-hold-supersede.test.js +28 -35
  285. package/test/segment-judged-by-its-own-header.test.js +221 -0
  286. package/test/segment-serve-wiring.test.js +130 -39
  287. package/test/segment-store-eviction.test.js +22 -7
  288. package/test/segment-store.test.js +98 -14
  289. package/test/segment-true-start.test.js +1 -1
  290. package/test/segments-are-shared.test.js +17 -16
  291. package/test/send-chunk-bytes.test.js +1 -1
  292. package/test/serving-existing-output.test.js +102 -0
  293. package/test/serving-output.test.js +102 -0
  294. package/test/shared-piece-store.test.js +1 -1
  295. package/test/source-file.test.js +1 -1
  296. package/test/stale-request-after-seek.test.js +17 -21
  297. package/test/startup-readings.test.js +10 -5
  298. package/test/subtitle-cue-framing.test.js +5 -5
  299. package/test/subtitle-cue-source.test.js +36 -38
  300. package/test/subtitle-cue-walk.test.js +11 -10
  301. package/test/subtitle-defaults.test.js +1 -1
  302. package/test/subtitle-language.test.js +4 -4
  303. package/test/subtitle-track-numbering.test.js +5 -4
  304. package/test/supply-margin.test.js +1 -1
  305. package/test/swarm-follows-readers.test.js +3 -3
  306. package/test/swarm-reach.test.js +1 -1
  307. package/test/swarm-selection.test.js +3 -3
  308. package/test/tail-duplication.test.js +1 -1
  309. package/test/the-channel-has-both-ends.test.js +91 -0
  310. package/test/the-torrent-thread-serves-bytes.test.js +107 -0
  311. package/test/thread-pool.test.js +3 -3
  312. package/test/timeline.test.js +1 -12
  313. package/test/torrent-cost.test.js +1 -1
  314. package/test/tracks-begin-together.test.js +38 -24
  315. package/test/tunnel-renewal.test.js +1 -1
  316. package/test/two-viewers-one-picture.test.js +120 -87
  317. package/test/upload-hurry.test.js +3 -3
  318. package/test/usrsctp-state.test.js +1 -1
  319. package/test/video-facts.test.js +1 -1
  320. package/test/viewer-assignments.test.js +143 -0
  321. package/test/viewer-outputs.test.js +60 -52
  322. package/test/viewer-presence.test.js +22 -25
  323. package/test/viewer-requests-admission.test.js +89 -0
  324. package/test/viewer-states.test.js +189 -202
  325. package/test/viewer-subtitle-subscription.test.js +1 -1
  326. package/test/viewer.test.js +139 -136
  327. package/test/viewing-generations.test.js +390 -0
  328. package/test/visible-rung.test.js +37 -0
  329. package/test/wait-ledger.test.js +1 -1
  330. package/test/webrtc-shim.test.js +3 -3
  331. package/test/wedge-certainty.test.js +2 -2
  332. package/test/withdraw-piece-claim.test.js +2 -2
  333. package/test/worker-channel.test.js +1 -31
  334. package/utils/client-log-file.js +151 -151
  335. package/scripts/read-container-index.mjs +0 -108
  336. package/services/container/ContainerFactory.js +0 -122
  337. package/services/controllers/PlaybackController.js +0 -33
  338. package/services/disk/DiskSpace.js +0 -150
  339. package/services/disk/wire.js +0 -61
  340. package/services/hls-session-manager.js +0 -9608
  341. package/services/orchestrators/SubtitleOrchestrator.js +0 -160
  342. package/services/output/Output.js +0 -94
  343. package/services/output/OutputSpec.js +0 -202
  344. package/services/output/index.js +0 -1
  345. package/services/output/ladder.js +0 -26
  346. package/services/produced-index.js +0 -222
  347. package/services/quality/EncodeCost.js +0 -555
  348. package/services/torrent-worker/container-tracks.js +0 -414
  349. package/services/viewer/link-readings.js +0 -56
  350. package/test/produced-index.test.js +0 -142
  351. /package/{services → bin}/thread-pool.js +0 -0
  352. /package/services/{available-share.js → encode/available-share.js} +0 -0
  353. /package/services/{decode-cost-fit.js → encode/decode-cost-fit.js} +0 -0
  354. /package/services/{encoder-readings.js → encode/encoder-readings.js} +0 -0
  355. /package/services/{host-load.js → encode/host-load.js} +0 -0
  356. /package/services/{output → encode/output}/cut-grid.js +0 -0
  357. /package/services/{output → encode/output}/rates.js +0 -0
  358. /package/services/{segment-formats → encode/segment-formats}/mpegts.js +0 -0
  359. /package/services/{torrent-cost.js → encode/torrent-cost.js} +0 -0
  360. /package/services/{container → media/container}/ebml-reader.js +0 -0
  361. /package/services/{ffmpeg-banner.js → media/ffmpeg-banner.js} +0 -0
  362. /package/services/{tracks → media/tracks}/ContainerTrack.js +0 -0
  363. /package/services/{tracks → media/tracks}/ImageSubtitleTrack.js +0 -0
  364. /package/services/{tracks → media/tracks}/SubtitleTrack.js +0 -0
  365. /package/services/{tracks → media/tracks}/TextSubtitleTrack.js +0 -0
  366. /package/services/{tracks → media/tracks}/VideoTrack.js +0 -0
  367. /package/services/{tracks → media/tracks}/index.js +0 -0
  368. /package/services/{files → storage/files}/piece-from-whole-file.js +0 -0
  369. /package/services/{disk → storage}/keep.js +0 -0
  370. /package/services/{piece-store → storage/piece-store}/piece-lru.js +0 -0
  371. /package/services/{disk → storage}/returns.js +0 -0
  372. /package/services/{demand → torrent/demand}/DemandRegister.js +0 -0
  373. /package/services/{demand → torrent/demand}/Urgency.js +0 -0
  374. /package/services/{demand → torrent/demand}/Window.js +0 -0
  375. /package/services/{demand → torrent/demand}/index.js +0 -0
  376. /package/services/{demand → torrent/demand}/pieces.js +0 -0
  377. /package/services/{download → torrent/download}/withdraw-claim.js +0 -0
  378. /package/services/{supply-margin.js → torrent/supply-margin.js} +0 -0
  379. /package/services/{torrent-source-key.js → torrent/torrent-source-key.js} +0 -0
  380. /package/services/{torrent-worker → torrent/worker}/fastest-wires.js +0 -0
  381. /package/services/{torrent-worker → torrent/worker}/handle-state.js +0 -0
  382. /package/services/{nat-classifier.js → transport/nat-classifier.js} +0 -0
  383. /package/services/{registry-api.js → transport/registry-api.js} +0 -0
  384. /package/services/{tunnel-client.js → transport/tunnel-client.js} +0 -0
  385. /package/services/{priority → viewer}/WaitLedger.js +0 -0
@@ -1,136 +1,139 @@
1
- /**
2
- * @file One object per person watching, and one deletion to forget them.
3
- *
4
- * It was six maps hung on the session, each keyed by consumer id, and the
5
- * forgetting was already wrong: releasing a consumer emptied none of them, so a
6
- * viewer who had left went on counting as wanting their soundtrack until their
7
- * head expired, and their entries stayed for the life of the session.
8
- */
9
-
10
- import test from "node:test";
11
- import assert from "node:assert/strict";
12
- import { SourceFile } from "../services/source/SourceFile.js";
13
- import { mkdtemp, rm } from "node:fs/promises";
14
- import os from "node:os";
15
- import path from "node:path";
16
- import { HlsSessionManager } from "../services/hls-session-manager.js";
17
- import { Viewer, viewerOf, viewersOf } from "../services/viewer/Viewer.js";
18
-
19
- const SESSION_ID = "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee";
20
-
21
- test("presence and position are two facts, and presence does not wait for a request", () => {
22
- const now = 1_000_000;
23
- const viewer = new Viewer("someone", now);
24
-
25
- // The whole of the 2026-09-05 failure in one assertion: a viewer who has
26
- // arrived and asked for nothing yet IS watching. Answered from the position
27
- // alone — which is written only when a segment is requested — this read
28
- // false, every encoder on their output was stopped for having nobody, and
29
- // the `init.mp4` they needed in order to request their first segment was
30
- // therefore never made.
31
- assert.equal(viewer.position, null, "nothing has placed them yet");
32
- assert.equal(viewer.isPresent(), true, "and they are still here");
33
-
34
- // SILENCE IS NOT ABSENCE, however long it lasts. A paused viewer, a hidden
35
- // tab whose timers the browser has throttled, and one holding two minutes of
36
- // cushion all say nothing and are all still watching — so there is no
37
- // interval that separates them from someone who has left, and the threshold
38
- // that used to try is gone.
39
- viewer.seen(now - 600_000);
40
- assert.equal(viewer.isPresent(), true, "ten minutes of silence is not leaving");
41
-
42
- // Something SAID they are gone: the browser released the session, or their
43
- // connection closed. That is the only way out.
44
- viewer.gone = true;
45
- assert.equal(viewer.isPresent(), false, "a statement is what ends it");
46
- });
47
-
48
- test("position is one fact with one writer, and a function of time", () => {
49
- const viewer = new Viewer("someone");
50
- assert.equal(viewer.positionSeconds(), null);
51
-
52
- viewer.report({ bufferedAheadSec: 60, positionSeconds: 40, playing: false }, 1_000_000);
53
- assert.equal(viewer.positionSeconds(1_000_000), 40);
54
- assert.equal(viewer.positionSeconds(1_060_000), 40, "a stopped picture covers no film");
55
-
56
- viewer.report({ bufferedAheadSec: 60, positionSeconds: 40, playing: true }, 1_000_000);
57
- assert.equal(viewer.positionSeconds(1_010_000), 50, "a playing one covers a second a second");
58
- assert.equal(
59
- viewer.positionSeconds(1_600_000),
60
- 100,
61
- "and no further than the film they said they held"
62
- );
63
-
64
- // A seek is the same statement, and there is no second field for it to win
65
- // against: two writers taking turns on one reading is what made the priority
66
- // map jump backwards several times a second in the field on 2026-09-13.
67
- viewer.moveTo(900, 1_010_000);
68
- assert.equal(viewer.positionSeconds(1_010_000), 900);
69
- assert.equal(
70
- viewer.positionSeconds(1_070_000),
71
- 900,
72
- "and a seek carries no cushion from where it left, so nothing is extrapolated"
73
- );
74
- });
75
-
76
- test("a viewer who has stated nothing has a position and does not drift from it", () => {
77
- const viewer = new Viewer("someone");
78
- viewer.moveTo(0, 1_000_000);
79
-
80
- // The whole of the fault of 2026-09-14: `playing` used to start true, and a
81
- // page that had measured nothing was never allowed to say otherwise, so a
82
- // hidden tab's viewer was carried 146 seconds into a film they had not begun.
83
- assert.equal(viewer.playing, false);
84
- assert.equal(viewer.waiting, true, "a viewer who has just arrived is waiting on us");
85
- assert.equal(viewer.positionSeconds(1_146_000), 0);
86
- });
87
-
88
- test("asking for a viewer twice is the same viewer", () => {
89
- const session = {};
90
- const first = viewerOf(session, "one");
91
- first.audio = { trackIndex: 3, transcode: false };
92
-
93
- assert.equal(viewerOf(session, "one"), first);
94
- assert.equal(viewerOf(session, "one").audio.trackIndex, 3);
95
- assert.notEqual(viewerOf(session, "two"), first);
96
- assert.equal(viewersOf(session).size, 2);
97
- });
98
-
99
- test("releasing a consumer forgets everything that was true of them alone", async (t) => {
100
- const dirPath = await mkdtemp(path.join(os.tmpdir(), "viewer-"));
101
- t.after(async () => {
102
- await rm(dirPath, { recursive: true, force: true });
103
- });
104
- const manager = new HlsSessionManager({
105
- enabled: true,
106
- ffmpegBin: "ffmpeg",
107
- localBindHost: "127.0.0.1",
108
- localPort: 9090
109
- });
110
- const session = {
111
- id: SESSION_ID,
112
- dirPath,
113
- state: "live",
114
- file: new SourceFile({ sourceKey: "source-1", fileIndex: 0, name: "video.mkv" }),
115
- // An ordinary session reads its own file, and its sound is inside it. The
116
- // three differ only for a soundtrack shipped as a file of its own.
117
- get inputFile() { return this.file; },
118
- get audioFile() { return this.file; },
119
- consumers: new Set(["staying", "leaving"]),
120
- viewers: new Map(),
121
- lastAccessedAt: Date.now()
122
- };
123
- manager.sessionsById.set(SESSION_ID, session);
124
-
125
- const leaving = viewerOf(session, "leaving");
126
- leaving.audio = { trackIndex: 2, transcode: true };
127
- leaving.activeVariantId = "some-variant";
128
- leaving.position = { segment: 40, seconds: 160, at: Date.now() };
129
- viewerOf(session, "staying").audio = { trackIndex: 0, transcode: false };
130
-
131
- await manager.releaseSessionConsumer(SESSION_ID, "leaving", "the tab was closed");
132
-
133
- assert.equal(session.viewers.has("leaving"), false, "one deletion, not six");
134
- assert.equal(session.viewers.has("staying"), true, "and it takes nobody else with it");
135
- assert.equal(session.consumers.size, 1);
136
- });
1
+ /**
2
+ * @file One object per person watching, and one deletion to forget them.
3
+ *
4
+ * It was six maps hung on the session, each keyed by consumer id, and the
5
+ * forgetting was already wrong: releasing a consumer emptied none of them, so a
6
+ * viewer who had left went on counting as wanting their soundtrack until their
7
+ * head expired, and their entries stayed for the life of the session.
8
+ */
9
+
10
+ import test from "node:test";
11
+ import assert from "node:assert/strict";
12
+ import { SourceFile } from "../services/media/SourceFile.js";
13
+ import { mkdtemp, rm } from "node:fs/promises";
14
+ import os from "node:os";
15
+ import path from "node:path";
16
+ import { wireOutputs } from "../services/server/wire-outputs.js";
17
+ import { Viewer } from "../services/viewer/Viewer.js";
18
+ import { Viewers } from "../services/viewer/Viewers.js";
19
+ import { outputSpec } from "./helpers/output-spec.js";
20
+
21
+ const SESSION_ID = "aaaaaaaabbbbcccc";
22
+
23
+ test("presence and position are two facts, and presence does not wait for a request", () => {
24
+ const now = 1_000_000;
25
+ const viewer = new Viewer("someone", now);
26
+
27
+ // The whole of the 2026-09-05 failure in one assertion: a viewer who has
28
+ // arrived and asked for nothing yet IS watching. Answered from the position
29
+ // alone — which is written only when a segment is requested — this read
30
+ // false, every encoder on their output was stopped for having nobody, and
31
+ // the `init.mp4` they needed in order to request their first segment was
32
+ // therefore never made.
33
+ assert.equal(viewer.position, null, "nothing has placed them yet");
34
+ assert.equal(viewer.isPresent(), true, "and they are still here");
35
+
36
+ // SILENCE IS NOT ABSENCE, however long it lasts. A paused viewer, a hidden
37
+ // tab whose timers the browser has throttled, and one holding two minutes of
38
+ // cushion all say nothing and are all still watching — so there is no
39
+ // interval that separates them from someone who has left, and the threshold
40
+ // that used to try is gone.
41
+ viewer.seen(now - 600_000);
42
+ assert.equal(viewer.isPresent(), true, "ten minutes of silence is not leaving");
43
+
44
+ // Something SAID they are gone: the browser released the session, or their
45
+ // connection closed. That is the only way out.
46
+ viewer.gone = true;
47
+ assert.equal(viewer.isPresent(), false, "a statement is what ends it");
48
+ });
49
+
50
+ test("position is one fact with one writer, and a function of time", () => {
51
+ const viewer = new Viewer("someone");
52
+ assert.equal(viewer.positionSeconds(), null);
53
+
54
+ viewer.report({ bufferedAheadSec: 60, positionSeconds: 40, playing: false }, 1_000_000);
55
+ assert.equal(viewer.positionSeconds(1_000_000), 40);
56
+ assert.equal(viewer.positionSeconds(1_060_000), 40, "a stopped picture covers no film");
57
+
58
+ viewer.report({ bufferedAheadSec: 60, positionSeconds: 40, playing: true }, 1_000_000);
59
+ assert.equal(viewer.positionSeconds(1_010_000), 50, "a playing one covers a second a second");
60
+ assert.equal(
61
+ viewer.positionSeconds(1_600_000),
62
+ 100,
63
+ "and no further than the film they said they held"
64
+ );
65
+
66
+ // A seek is the same statement, and there is no second field for it to win
67
+ // against: two writers taking turns on one reading is what made the priority
68
+ // map jump backwards several times a second in the field on 2026-09-13.
69
+ viewer.moveTo(900, 1_010_000);
70
+ assert.equal(viewer.positionSeconds(1_010_000), 900);
71
+ assert.equal(
72
+ viewer.positionSeconds(1_070_000),
73
+ 900,
74
+ "and a seek carries no cushion from where it left, so nothing is extrapolated"
75
+ );
76
+ });
77
+
78
+ test("a viewer who has stated nothing has a position and does not drift from it", () => {
79
+ const viewer = new Viewer("someone");
80
+ viewer.moveTo(0, 1_000_000);
81
+
82
+ // The whole of the fault of 2026-09-14: `playing` used to start true, and a
83
+ // page that had measured nothing was never allowed to say otherwise, so a
84
+ // hidden tab's viewer was carried 146 seconds into a film they had not begun.
85
+ assert.equal(viewer.playing, false);
86
+ assert.equal(viewer.waiting, true, "a viewer who has just arrived is waiting on us");
87
+ assert.equal(viewer.positionSeconds(1_146_000), 0);
88
+ });
89
+
90
+ test("asking for a viewer twice is the same viewer", () => {
91
+ const session = { id: "session" };
92
+ const viewers = new Viewers();
93
+ const first = viewers.of(session, "one");
94
+ first.audio = { trackIndex: 3, transcode: false };
95
+
96
+ assert.equal(viewers.of(session, "one"), first);
97
+ assert.equal(viewers.of(session, "one").audio.trackIndex, 3);
98
+ assert.notEqual(viewers.of(session, "two"), first);
99
+ assert.equal(viewers.forOutput(session).size, 2);
100
+ });
101
+
102
+ test("releasing a consumer forgets everything that was true of them alone", async (t) => {
103
+ const dirPath = await mkdtemp(path.join(os.tmpdir(), "viewer-"));
104
+ t.after(async () => {
105
+ await rm(dirPath, { recursive: true, force: true });
106
+ });
107
+ const manager = wireOutputs({
108
+ enabled: true,
109
+ ffmpegBin: "ffmpeg",
110
+ localBindHost: "127.0.0.1",
111
+ localPort: 9090
112
+ });
113
+ const session = {
114
+ id: SESSION_ID,
115
+ spec: outputSpec(),
116
+ dirPath,
117
+ state: "live",
118
+ file: new SourceFile({ sourceKey: "source-1", fileIndex: 0, name: "video.mkv" }),
119
+ // An ordinary session reads its own file, and its sound is inside it. The
120
+ // three differ only for a soundtrack shipped as a file of its own.
121
+ get inputFile() { return this.file; },
122
+ get audioFile() { return this.file; },
123
+ claims: new Set(),
124
+ lastAccessedAt: Date.now()
125
+ };
126
+ manager.outputs.set(SESSION_ID, session);
127
+
128
+ const leaving = manager.viewers.of(session, "leaving");
129
+ leaving.audio = { trackIndex: 2, transcode: true };
130
+ leaving.activeVariantId = "some-variant";
131
+ leaving.position = { segment: 40, seconds: 160, at: Date.now() };
132
+ manager.viewers.of(session, "staying").audio = { trackIndex: 0, transcode: false };
133
+
134
+ await manager.lifecycle.releaseSessionConsumer(SESSION_ID, "leaving", "the tab was closed");
135
+
136
+ assert.equal(manager.viewers.forOutput(session).has("leaving"), false, "one deletion, not six");
137
+ assert.equal(manager.viewers.forOutput(session).has("staying"), true, "and it takes nobody else with it");
138
+ assert.equal(manager.viewers.size, 1);
139
+ });