@torrent-tv/proxy 2.87.20 → 2.88.0

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 (474) hide show
  1. package/.claude/commands/opsx/apply.md +155 -155
  2. package/.claude/commands/opsx/archive.md +160 -160
  3. package/.claude/commands/opsx/explore.md +174 -174
  4. package/.claude/commands/opsx/propose.md +109 -109
  5. package/.claude/commands/opsx/sync.md +143 -143
  6. package/.claude/skills/openspec-apply-change/SKILL.md +159 -159
  7. package/.claude/skills/openspec-archive-change/SKILL.md +117 -117
  8. package/.claude/skills/openspec-explore/SKILL.md +289 -289
  9. package/.claude/skills/openspec-propose/SKILL.md +113 -113
  10. package/.claude/skills/openspec-sync-specs/SKILL.md +147 -147
  11. package/.dockerignore +5 -5
  12. package/AGENTS.md +322 -322
  13. package/CHANGELOG.md +8 -0
  14. package/Dockerfile +30 -30
  15. package/LICENSE +16 -16
  16. package/README.md +369 -369
  17. package/assets/calibration/NOTICE.md +100 -100
  18. package/assets/diagnostics/sctpstate.gdb +31 -31
  19. package/bin/cli.js +684 -684
  20. package/bin/thread-pool.js +30 -30
  21. package/biome.json +411 -411
  22. package/docs/browser-proxy-contract.md +133 -133
  23. package/docs/container-architecture.md +218 -218
  24. package/docs/download-architecture.md +261 -261
  25. package/docs/encode-architecture.md +729 -729
  26. package/docs/encode-run-state.md +96 -96
  27. package/docs/logs.md +97 -97
  28. package/docs/socks5-egress-research.md +114 -114
  29. package/docs/storage-architecture.md +267 -267
  30. package/knip.json +14 -14
  31. package/openspec/changes/adaptive-bitrate/design.md +92 -92
  32. package/openspec/changes/adaptive-bitrate/proposal.md +56 -56
  33. package/openspec/changes/adaptive-bitrate/specs/adaptive-bitrate/spec.md +51 -51
  34. package/openspec/changes/adaptive-bitrate/tasks.md +40 -40
  35. package/openspec/changes/binary-distribution/.openspec.yaml +2 -2
  36. package/openspec/changes/binary-distribution/proposal.md +53 -53
  37. package/openspec/changes/chunked-request-bodies/design.md +81 -81
  38. package/openspec/changes/chunked-request-bodies/proposal.md +53 -53
  39. package/openspec/changes/chunked-request-bodies/specs/chunked-request-bodies/spec.md +30 -30
  40. package/openspec/changes/chunked-request-bodies/tasks.md +40 -40
  41. package/openspec/changes/cold-start/design.md +98 -98
  42. package/openspec/changes/cold-start/proposal.md +62 -62
  43. package/openspec/changes/cold-start/specs/cold-start/spec.md +47 -47
  44. package/openspec/changes/cold-start/tasks.md +48 -48
  45. package/openspec/changes/disk-cap/.openspec.yaml +2 -2
  46. package/openspec/changes/disk-cap/proposal.md +37 -37
  47. package/openspec/changes/disk-cap/specs/disk-cap/spec.md +25 -25
  48. package/openspec/changes/disk-cap/tasks.md +19 -19
  49. package/openspec/changes/proxy-observability/.openspec.yaml +2 -2
  50. package/openspec/changes/proxy-observability/design.md +38 -38
  51. package/openspec/changes/proxy-observability/proposal.md +49 -49
  52. package/openspec/changes/proxy-observability/specs/observability/spec.md +33 -33
  53. package/openspec/changes/proxy-observability/tasks.md +21 -21
  54. package/openspec/changes/seek-debounce/design.md +118 -118
  55. package/openspec/changes/seek-debounce/proposal.md +59 -59
  56. package/openspec/changes/seek-debounce/specs/seek-debounce/spec.md +41 -41
  57. package/openspec/changes/seek-debounce/tasks.md +33 -33
  58. package/openspec/changes/subtitle-language/.openspec.yaml +2 -2
  59. package/openspec/changes/subtitle-language/proposal.md +50 -50
  60. package/openspec/changes/subtitle-language/specs/subtitle-language/spec.md +34 -34
  61. package/openspec/changes/subtitle-language/tasks.md +26 -26
  62. package/openspec/changes/track-selection/.openspec.yaml +2 -2
  63. package/openspec/changes/track-selection/design.md +47 -47
  64. package/openspec/changes/track-selection/proposal.md +45 -45
  65. package/openspec/changes/track-selection/specs/track-selection/spec.md +41 -41
  66. package/openspec/changes/track-selection/tasks.md +20 -20
  67. package/openspec/changes/transcode-quality/.openspec.yaml +2 -2
  68. package/openspec/changes/transcode-quality/proposal.md +51 -51
  69. package/openspec/changes/transcode-quality/specs/transcode-quality/spec.md +139 -139
  70. package/openspec/changes/transcode-quality/tasks.md +63 -63
  71. package/openspec/config.yaml +38 -38
  72. package/package.json +50 -50
  73. package/public/.well-known/appspecific/com.chrome.devtools.json +1 -1
  74. package/research/delivery-wedge-stand-ladder-2026-09-13.md +329 -329
  75. package/research/double-spawn-2026-09-10.md +171 -171
  76. package/research/handover-2026-09-13.md +209 -209
  77. package/research/handover-reader-claims-removal-2026-09-12.md +166 -166
  78. package/research/piece-withdrawn-but-still-claimed-2026-09-12.md +175 -175
  79. package/research/preset-benchmark-size-scaling-2026-08-22.md +55 -55
  80. package/research/priority-map-is-the-truth-2026-09-12.md +225 -225
  81. package/routes/api/client-logs/post.js +86 -86
  82. package/routes/api/delivery-sink/get.js +72 -72
  83. package/routes/api/link-probe/get.js +51 -51
  84. package/routes/api/playback-plan/audio-tracks/post.js +29 -29
  85. package/routes/api/playback-plan/post.js +53 -53
  86. package/routes/api/sources/files/get.js +106 -100
  87. package/routes/api/sources/post.js +36 -36
  88. package/routes/api/sources/stats/get.js +132 -132
  89. package/routes/api/sources/warm/post.js +217 -217
  90. package/routes/api/subtitles/get.js +230 -230
  91. package/routes/api/transcode-sessions/fragment-far/post.js +60 -60
  92. package/routes/api/transcode-sessions/net-report/post.js +138 -138
  93. package/routes/api/transcode-sessions/post.js +173 -173
  94. package/routes/api/transcode-sessions/progress/get.js +27 -27
  95. package/routes/api/transcode-sessions/release/post.js +41 -41
  96. package/routes/api/transcode-sessions/seek/post.js +63 -63
  97. package/routes/health/get.js +13 -13
  98. package/routes/healthz/get.js +13 -13
  99. package/routes/stream/get.js +380 -380
  100. package/routes/transcode/audio-file/get.js +64 -64
  101. package/routes/transcode/audio-warm/get.js +84 -84
  102. package/routes/transcode/session-file/get.js +52 -52
  103. package/routes/transcode/variant-file/get.js +95 -95
  104. package/routes/transcode/variant-warm/get.js +84 -84
  105. package/scripts/render-run-graph.js +173 -173
  106. package/server.js +725 -725
  107. package/services/encode/CoverageMap.js +428 -428
  108. package/services/encode/CushionReport.js +345 -345
  109. package/services/encode/EncodeAdmission.js +376 -376
  110. package/services/encode/EncodeOrchestrator.js +1217 -1217
  111. package/services/encode/EncodePlan.js +1366 -1366
  112. package/services/encode/EncodeRun.js +813 -813
  113. package/services/encode/EncodeRuns.js +1235 -1235
  114. package/services/encode/Encoder.js +142 -142
  115. package/services/encode/EncoderSelection.js +38 -38
  116. package/services/encode/LocalObservations.js +359 -359
  117. package/services/encode/NvencEncoder.js +50 -50
  118. package/services/encode/OutputOpening.js +758 -758
  119. package/services/encode/OutputTimes.js +579 -579
  120. package/services/encode/QsvEncoder.js +58 -58
  121. package/services/encode/Renditions.js +2184 -2184
  122. package/services/encode/RunProgress.js +84 -84
  123. package/services/encode/SegmentDemand.js +95 -95
  124. package/services/encode/SoftwareEncoder.js +121 -121
  125. package/services/encode/V4l2m2mEncoder.js +53 -53
  126. package/services/encode/VaapiEncoder.js +66 -66
  127. package/services/encode/args.js +416 -416
  128. package/services/encode/available-share.js +89 -89
  129. package/services/encode/calibration.js +361 -361
  130. package/services/encode/contention.js +128 -128
  131. package/services/encode/decode-cost-fit.js +363 -363
  132. package/services/encode/encode-exit.js +114 -114
  133. package/services/encode/encode-run-state.js +551 -551
  134. package/services/encode/encoder-readings.js +45 -45
  135. package/services/encode/fingerprint.js +322 -322
  136. package/services/encode/host-load.js +174 -174
  137. package/services/encode/hwaccel.js +1894 -1894
  138. package/services/encode/index.js +9 -9
  139. package/services/encode/learned-median.js +90 -90
  140. package/services/encode/output/EncodedOutput.js +57 -57
  141. package/services/encode/output/Output.js +131 -131
  142. package/services/encode/output/OutputCatalog.js +414 -414
  143. package/services/encode/output/OutputSpec.js +390 -390
  144. package/services/encode/output/Timeline.js +308 -308
  145. package/services/encode/output/cut-grid.js +107 -107
  146. package/services/encode/output/index.js +20 -20
  147. package/services/encode/output/ladder.js +32 -32
  148. package/services/encode/output/playlists.js +284 -284
  149. package/services/encode/output/rates.js +125 -125
  150. package/services/encode/output-key-format.js +21 -21
  151. package/services/encode/quality/EncodeCost.js +1141 -1141
  152. package/services/encode/quality/HostLoad.js +525 -525
  153. package/services/encode/quality/HostTimings.js +249 -249
  154. package/services/encode/quality/OutputQualityState.js +28 -28
  155. package/services/encode/quality/QualityController.js +935 -935
  156. package/services/encode/quality/QualityOffer.js +416 -416
  157. package/services/encode/quality/drain-threat.js +47 -47
  158. package/services/encode/quality/link-budget.js +254 -254
  159. package/services/encode/quality/output-format.js +315 -315
  160. package/services/encode/quality/serving-output.js +216 -216
  161. package/services/encode/quality/visible-rung.js +57 -57
  162. package/services/encode/run-budget.js +97 -97
  163. package/services/encode/run-command.js +754 -754
  164. package/services/encode/run-costs.js +155 -155
  165. package/services/encode/run-inputs.js +42 -42
  166. package/services/encode/segment-formats/fmp4.js +456 -456
  167. package/services/encode/segment-formats/index.js +85 -85
  168. package/services/encode/segment-formats/init-compat.js +324 -324
  169. package/services/encode/segment-formats/mp4-boxes.js +515 -515
  170. package/services/encode/segment-formats/mpegts.js +134 -134
  171. package/services/encode/start-stop-cost.js +178 -178
  172. package/services/encode/throughput.js +97 -97
  173. package/services/encode/torrent-cost.js +88 -88
  174. package/services/identity/installation-id.js +38 -38
  175. package/services/media/ContainerOrchestrator.js +149 -149
  176. package/services/media/KeyframeTables.js +316 -316
  177. package/services/media/SourceFile.js +298 -298
  178. package/services/media/SubtitleCues.js +520 -520
  179. package/services/media/SubtitleOrchestrator.js +167 -167
  180. package/services/media/audio-inventory.js +245 -245
  181. package/services/media/container/AviContainer.js +266 -266
  182. package/services/media/container/Container.js +603 -603
  183. package/services/media/container/ContainerFactory.js +56 -56
  184. package/services/media/container/KeyframeTable.js +272 -272
  185. package/services/media/container/MatroskaContainer.js +1494 -1494
  186. package/services/media/container/Mp4Container.js +1244 -1244
  187. package/services/media/container/SubtitleFileContainer.js +322 -322
  188. package/services/media/container/ebml-reader.js +159 -159
  189. package/services/media/ffmpeg-banner.js +260 -260
  190. package/services/media/keyframe-probe.js +157 -157
  191. package/services/media/media-info-probe.js +93 -93
  192. package/services/media/playback-planner.js +931 -931
  193. package/services/media/tracks/AudioTrack.js +131 -131
  194. package/services/media/tracks/ContainerTrack.js +75 -75
  195. package/services/media/tracks/ImageSubtitleTrack.js +19 -19
  196. package/services/media/tracks/SubtitleTrack.js +38 -38
  197. package/services/media/tracks/TextSubtitleTrack.js +287 -287
  198. package/services/media/tracks/VideoTrack.js +33 -33
  199. package/services/media/tracks/index.js +15 -15
  200. package/services/media/tracks/language-detect.js +174 -174
  201. package/services/server/OutputLifecycle.js +418 -418
  202. package/services/server/SegmentServing.js +1150 -1150
  203. package/services/server/ViewerRequests.js +760 -760
  204. package/services/server/WaitLedger.js +142 -142
  205. package/services/server/controllers/PlaybackController.js +40 -40
  206. package/services/server/controllers/SubtitleController.js +109 -109
  207. package/services/server/http-responses.js +60 -60
  208. package/services/server/playback-readiness.js +696 -696
  209. package/services/server/transcode-session-files.js +325 -325
  210. package/services/server/wire-outputs.js +992 -992
  211. package/services/storage/Diagnostics.js +202 -202
  212. package/services/storage/MachineBudget.js +235 -235
  213. package/services/storage/allowance.js +107 -107
  214. package/services/storage/core-dumps.js +106 -106
  215. package/services/storage/files/CompletedFiles.js +391 -391
  216. package/services/storage/files/piece-from-whole-file.js +118 -118
  217. package/services/storage/free.js +71 -71
  218. package/services/storage/keep.js +48 -48
  219. package/services/storage/machine-memory.js +56 -56
  220. package/services/storage/memory-report.js +575 -575
  221. package/services/storage/piece-store/piece-disk-store.js +539 -539
  222. package/services/storage/piece-store/piece-lru.js +495 -495
  223. package/services/storage/piece-store/shared-piece-store.js +1931 -1908
  224. package/services/storage/returns.js +103 -103
  225. package/services/storage/segment-store/SegmentStore.js +1240 -1240
  226. package/services/storage/wire.js +175 -175
  227. package/services/torrent/Contents.js +382 -324
  228. package/services/torrent/demand/DemandRegister.js +202 -202
  229. package/services/torrent/demand/Urgency.js +137 -137
  230. package/services/torrent/demand/Window.js +118 -118
  231. package/services/torrent/demand/index.js +8 -8
  232. package/services/torrent/demand/pieces.js +140 -140
  233. package/services/torrent/download/SwarmSelection.js +386 -386
  234. package/services/torrent/download/registry.js +102 -102
  235. package/services/torrent/download/withdraw-claim.js +80 -80
  236. package/services/torrent/episode-naming.js +182 -0
  237. package/services/torrent/files.js +455 -455
  238. package/services/torrent/naming.js +619 -619
  239. package/services/torrent/piece-store-of.js +29 -29
  240. package/services/torrent/supply-margin.js +262 -262
  241. package/services/torrent/torrent-pool.js +2675 -2675
  242. package/services/torrent/worker/background-fill.js +213 -213
  243. package/services/torrent/worker/channel.js +271 -271
  244. package/services/torrent/worker/client.js +765 -765
  245. package/services/torrent/worker/fastest-wires.js +342 -342
  246. package/services/torrent/worker/handle-state.js +23 -23
  247. package/services/torrent/worker/held-bytes.js +155 -155
  248. package/services/torrent/worker/install-webrtc-shim.js +32 -32
  249. package/services/torrent/worker/piece-reader.js +1078 -1078
  250. package/services/torrent/worker/pool-adapter.js +371 -371
  251. package/services/torrent/worker/protocol.js +184 -184
  252. package/services/torrent/worker/resume-warm.js +107 -107
  253. package/services/torrent/worker/webrtc-shim.js +219 -219
  254. package/services/torrent/worker/worker.js +1129 -1129
  255. package/services/transport/data-channel-handler.js +1369 -1369
  256. package/services/transport/delivery-probe.js +842 -842
  257. package/services/transport/health-collector.js +53 -53
  258. package/services/transport/nat-classifier.js +231 -231
  259. package/services/transport/packet-witness.js +808 -808
  260. package/services/transport/port-mapper.js +235 -235
  261. package/services/transport/registry-api.js +81 -81
  262. package/services/transport/tunnel-client.js +447 -447
  263. package/services/transport/usrsctp-state.js +175 -175
  264. package/services/transport/webrtc-manager.js +484 -484
  265. package/services/viewer/Assignments.js +340 -340
  266. package/services/viewer/PriorityMap.js +390 -390
  267. package/services/viewer/PriorityOrchestrator.js +325 -325
  268. package/services/viewer/Viewer.js +691 -691
  269. package/services/viewer/Viewers.js +368 -368
  270. package/services/viewer/active-output.js +37 -37
  271. package/services/viewer/audio-start.js +46 -46
  272. package/services/viewer/buffer-trend.js +81 -81
  273. package/services/viewer/choices.js +647 -647
  274. package/services/viewer/positions.js +126 -126
  275. package/services/viewer/report-intake.js +46 -46
  276. package/store/source-registry.js +71 -71
  277. package/test/asset-paths.test.js +28 -28
  278. package/test/audio-inventory.test.js +212 -212
  279. package/test/audio-track-bitrate.test.js +40 -40
  280. package/test/auto-quality-step.test.js +707 -707
  281. package/test/available-share.test.js +76 -76
  282. package/test/background-fill.test.js +190 -190
  283. package/test/client-log-file.test.js +110 -110
  284. package/test/completed-files.test.js +115 -115
  285. package/test/concurrent-cost.test.js +148 -148
  286. package/test/container-media-info.test.js +228 -228
  287. package/test/contention.test.js +76 -76
  288. package/test/core-dumps.test.js +57 -57
  289. package/test/coverage-follows-the-disk.test.js +228 -228
  290. package/test/coverage-map.test.js +195 -195
  291. package/test/cue-push-carries-what-the-walk-found.test.js +58 -58
  292. package/test/cut-times-timeline.test.js +65 -65
  293. package/test/cuts-follow-published-grid.test.js +109 -109
  294. package/test/data-channel-frame.test.js +63 -63
  295. package/test/data-channel-viewer-lifecycle.test.js +92 -92
  296. package/test/dead-torrent-handle.test.js +52 -52
  297. package/test/declared-rates.test.js +116 -116
  298. package/test/declared-tracks.test.js +43 -43
  299. package/test/decode-cost-fit.test.js +202 -202
  300. package/test/decode-cost.test.js +462 -462
  301. package/test/delivery-probe.test.js +393 -393
  302. package/test/demand-register.test.js +206 -206
  303. package/test/dht-bootstrap.test.js +72 -72
  304. package/test/drain-threat.test.js +65 -65
  305. package/test/duplicate-add.test.js +48 -48
  306. package/test/encode-admission.test.js +146 -146
  307. package/test/encode-cost.test.js +283 -283
  308. package/test/encode-exit.test.js +111 -111
  309. package/test/encode-orchestrator.test.js +419 -419
  310. package/test/encode-plan-viewers.test.js +718 -718
  311. package/test/encode-plan.test.js +545 -545
  312. package/test/encode-run-state.test.js +314 -314
  313. package/test/encode-run.test.js +162 -162
  314. package/test/encode-slope.test.js +46 -46
  315. package/test/encoded-output.test.js +39 -39
  316. package/test/encoder-kinds.test.js +122 -122
  317. package/test/encoder-readings.test.js +46 -46
  318. package/test/episode-naming.test.js +131 -0
  319. package/test/every-claimant-is-told-its-share.test.js +152 -152
  320. package/test/failed-encoder-still-serves-what-exists.test.js +354 -354
  321. package/test/failed-start-breaker.test.js +202 -202
  322. package/test/fastest-wires.test.js +143 -143
  323. package/test/ffmpeg-stream-counts.test.js +78 -78
  324. package/test/file-edges.test.js +191 -191
  325. package/test/fmp4-presentation-clock.test.js +147 -147
  326. package/test/fmp4-self-contained.test.js +80 -80
  327. package/test/fmp4-timestamps.test.js +140 -140
  328. package/test/fmp4-track-completeness.test.js +41 -41
  329. package/test/format-keyed-outputs.test.js +78 -78
  330. package/test/health-metrics.test.js +38 -38
  331. package/test/held-request-width.test.js +157 -157
  332. package/test/helpers/encode-run.js +136 -136
  333. package/test/helpers/held-file.js +29 -29
  334. package/test/helpers/manager.js +57 -57
  335. package/test/helpers/output-spec.js +63 -63
  336. package/test/host-load.test.js +68 -68
  337. package/test/index-accuracy-is-about-the-file.test.js +128 -128
  338. package/test/init-compat.test.js +219 -219
  339. package/test/input-lost-quiets-the-plan.test.js +261 -261
  340. package/test/input-unavailable.test.js +48 -48
  341. package/test/installation-id.test.js +39 -39
  342. package/test/keeping-period.test.js +83 -83
  343. package/test/keyframe-index-accuracy.test.js +188 -188
  344. package/test/keyframe-table-budget.test.js +102 -102
  345. package/test/keyframes-belong-to-the-file.test.js +249 -249
  346. package/test/learned-median.test.js +37 -37
  347. package/test/letting-go-asks-who-is-watching.test.js +191 -191
  348. package/test/limit-row-by-area.test.js +60 -60
  349. package/test/link-budget.test.js +111 -111
  350. package/test/link-probe.test.js +56 -56
  351. package/test/local-encoding-data.test.js +273 -273
  352. package/test/logger-repeats.test.js +134 -134
  353. package/test/look-ahead-coverage.test.js +56 -56
  354. package/test/manager-surface.test.js +292 -292
  355. package/test/matroska-cues-track.test.js +192 -192
  356. package/test/memory-budget.test.js +390 -390
  357. package/test/move-cost.test.js +216 -216
  358. package/test/mp4-subtitles.test.js +173 -173
  359. package/test/one-authority.test.js +285 -285
  360. package/test/one-budget.test.js +149 -149
  361. package/test/one-output-one-session.test.js +204 -204
  362. package/test/one-resource-divided.test.js +185 -185
  363. package/test/one-serving-output-per-height.test.js +458 -458
  364. package/test/orchestrator-wired.test.js +206 -206
  365. package/test/output-catalog.test.js +39 -39
  366. package/test/output-shape.test.js +21 -21
  367. package/test/output-spec.test.js +251 -251
  368. package/test/output-speed.test.js +88 -88
  369. package/test/outputs-being-prepared.test.js +40 -40
  370. package/test/packet-witness-ring.test.js +236 -236
  371. package/test/packet-witness.test.js +148 -148
  372. package/test/piece-disk-store.test.js +401 -401
  373. package/test/piece-from-whole-file.test.js +129 -129
  374. package/test/piece-lru.test.js +319 -319
  375. package/test/piece-reader.test.js +162 -162
  376. package/test/piece-selection-offset.test.js +85 -85
  377. package/test/piece-store-eviction.test.js +595 -595
  378. package/test/piece-store-never-refuses.test.js +153 -153
  379. package/test/piece-store-reservations.test.js +403 -365
  380. package/test/piece-store-slow-disk.test.js +159 -159
  381. package/test/piece-tail.test.js +97 -97
  382. package/test/plan-host-timings.test.js +68 -68
  383. package/test/plan-is-steady.test.js +225 -225
  384. package/test/playback-readiness.test.js +453 -453
  385. package/test/playback-start-regressions.test.js +99 -99
  386. package/test/priority-map-download.test.js +174 -174
  387. package/test/priority-map-emptied.test.js +204 -204
  388. package/test/priority-map-per-output.test.js +215 -215
  389. package/test/priority-map.test.js +163 -163
  390. package/test/probe-wedge-certainty.test.js +60 -60
  391. package/test/produced-copy-choice.test.js +213 -213
  392. package/test/published-timeline.test.js +83 -83
  393. package/test/quality-offer.test.js +162 -162
  394. package/test/quality-variants.test.js +1229 -1229
  395. package/test/rate-control-in-the-output.test.js +180 -180
  396. package/test/read-survives-withdrawal.test.js +164 -164
  397. package/test/read-window.test.js +365 -365
  398. package/test/resume-warm.test.js +39 -39
  399. package/test/run-graph-drift.test.js +37 -37
  400. package/test/run-inputs.test.js +80 -80
  401. package/test/run-intervals.test.js +100 -100
  402. package/test/run-position-follows-published-grid.test.js +89 -89
  403. package/test/run-progress.test.js +65 -65
  404. package/test/same-height-switch.test.js +664 -664
  405. package/test/seek-frees-the-viewers-requests.test.js +217 -217
  406. package/test/seek-landing.test.js +109 -109
  407. package/test/seek-target-not-superseded.test.js +195 -195
  408. package/test/segment-closed-on-both-branches.test.js +96 -96
  409. package/test/segment-cut-times.test.js +63 -63
  410. package/test/segment-demand.test.js +80 -80
  411. package/test/segment-hold-supersede.test.js +91 -91
  412. package/test/segment-judged-by-its-own-header.test.js +221 -221
  413. package/test/segment-serve-wiring.test.js +475 -475
  414. package/test/segment-store-eviction.test.js +247 -247
  415. package/test/segment-store.test.js +323 -323
  416. package/test/segment-true-start.test.js +86 -86
  417. package/test/segments-are-shared.test.js +176 -176
  418. package/test/send-chunk-bytes.test.js +86 -86
  419. package/test/serving-existing-output.test.js +102 -102
  420. package/test/serving-output.test.js +102 -102
  421. package/test/shared-piece-store.test.js +310 -310
  422. package/test/sidecar-naming.test.js +142 -142
  423. package/test/source-file.test.js +133 -133
  424. package/test/source-files-route.test.js +12 -2
  425. package/test/source-registry.test.js +18 -18
  426. package/test/split-a-stretch.test.js +139 -139
  427. package/test/stale-request-after-seek.test.js +158 -158
  428. package/test/startup-readings.test.js +124 -124
  429. package/test/stream-route.test.js +209 -209
  430. package/test/subtitle-cue-framing.test.js +200 -200
  431. package/test/subtitle-cue-source.test.js +102 -102
  432. package/test/subtitle-cue-walk.test.js +370 -370
  433. package/test/subtitle-cursor.test.js +63 -63
  434. package/test/subtitle-defaults.test.js +118 -118
  435. package/test/subtitle-language.test.js +252 -252
  436. package/test/subtitle-track-numbering.test.js +386 -386
  437. package/test/supply-margin.test.js +177 -177
  438. package/test/swarm-follows-readers.test.js +174 -174
  439. package/test/swarm-reach.test.js +130 -130
  440. package/test/swarm-selection.test.js +220 -220
  441. package/test/tail-duplication.test.js +167 -167
  442. package/test/the-channel-has-both-ends.test.js +91 -91
  443. package/test/the-torrent-thread-serves-bytes.test.js +107 -107
  444. package/test/thread-pool.test.js +53 -53
  445. package/test/timeline.test.js +84 -84
  446. package/test/torrent-contents.test.js +235 -235
  447. package/test/torrent-cost.test.js +71 -71
  448. package/test/torrent-files.test.js +221 -221
  449. package/test/torrent-naming.test.js +255 -255
  450. package/test/tracks-begin-together.test.js +209 -209
  451. package/test/tunnel-renewal.test.js +167 -167
  452. package/test/two-viewers-one-picture.test.js +407 -407
  453. package/test/upload-hurry.test.js +186 -186
  454. package/test/usrsctp-state.test.js +131 -131
  455. package/test/video-facts.test.js +102 -102
  456. package/test/viewer-assignments.test.js +143 -143
  457. package/test/viewer-outputs.test.js +285 -285
  458. package/test/viewer-presence.test.js +116 -116
  459. package/test/viewer-requests-admission.test.js +89 -89
  460. package/test/viewer-states.test.js +189 -189
  461. package/test/viewer-subtitle-subscription.test.js +96 -96
  462. package/test/viewer.test.js +139 -139
  463. package/test/viewing-generations.test.js +390 -390
  464. package/test/visible-rung.test.js +37 -37
  465. package/test/wait-ledger.test.js +100 -100
  466. package/test/webrtc-shim.test.js +149 -149
  467. package/test/wedge-certainty.test.js +131 -131
  468. package/test/withdraw-piece-claim.test.js +212 -212
  469. package/test/worker-channel.test.js +158 -158
  470. package/utils/client-log-file.js +151 -151
  471. package/utils/logger.js +312 -312
  472. package/utils/parse-range.js +25 -25
  473. package/utils/perf.js +59 -59
  474. package/utils/torrent-source-key.js +38 -38
@@ -1,292 +1,292 @@
1
- /**
2
- * @file What the HTTP layer asks of the components, checked from the HTTP layer.
3
- *
4
- * Written as the net under the dismantling of `hls-session-manager.js`, which
5
- * was 9608 lines and 142 methods and is now gone: its members are methods of
6
- * the components that own them, wired by `services/server/wire-outputs.js`.
7
- * Most tests that build those components name something INSIDE them — a field,
8
- * a fake output shaped the way one happens to be shaped — so they move when the
9
- * code moves, and a test that moves with the code cannot say the code still
10
- * works.
11
- *
12
- * This one is derived from the other side: from what the HTTP layer asks of
13
- * the components. That contract does not move. A route calling a member that no longer exists
14
- * is the exact failure a nine-step move risks, and it is silent — Fastify
15
- * answers 500 at runtime, months later, on a path no unit test walks.
16
- *
17
- * So the first check READS `routes/` and `server.js` rather than listing what
18
- * the manager has. It cannot go stale: adding a call to a route adds it to the
19
- * requirement, and removing the member it names breaks this test the same
20
- * minute.
21
- *
22
- * The second is a characteristic record rather than a judgement: what the
23
- * progress report carries today. Eighteen figures reach the page from it and
24
- * nothing on this side of the wire knows which of them the page needs, so the
25
- * honest statement is "these are the ones there were" — the point being that a
26
- * move must not change them, not that they are the right ones.
27
- *
28
- * Every manager here has a store root of its own, for the reason
29
- * `helpers/manager.js` records.
30
- */
31
-
32
- import test from "node:test";
33
- import assert from "node:assert/strict";
34
- import { readFileSync, readdirSync } from "node:fs";
35
- import path from "node:path";
36
- import { fileURLToPath } from "node:url";
37
- import { SourceFile } from "../services/media/SourceFile.js";
38
- import { Timeline } from "../services/encode/output/Timeline.js";
39
- import { managerWithOwnStore } from "./helpers/manager.js";
40
- import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
41
- import { Output } from "../services/encode/output/Output.js";
42
- import { outputSpec } from "./helpers/output-spec.js";
43
-
44
- const HERE = path.dirname(fileURLToPath(import.meta.url));
45
- const PROXY = path.join(HERE, "..");
46
- const SESSION_ID = "aaaaaaaabbbbcccc";
47
- /** The components the HTTP layer is handed. */
48
- const COMPONENTS = ["serving", "viewerRequests", "renditions", "lifecycle", "quality", "outputs", "hostTimings", "viewers", "encodeRuns"];
49
-
50
- /**
51
- * Every `.js` file under a directory, at any depth.
52
- *
53
- * @param {string} dir
54
- * @returns {string[]}
55
- */
56
- function jsFilesUnder(dir) {
57
- /** @type {string[]} */
58
- const found = [];
59
- for (const entry of readdirSync(dir, { withFileTypes: true })) {
60
- const full = path.join(dir, entry.name);
61
- if (entry.isDirectory()) {
62
- found.push(...jsFilesUnder(full));
63
- continue;
64
- }
65
- if (entry.name.endsWith(".js")) {
66
- found.push(full);
67
- }
68
- }
69
- return found;
70
- }
71
-
72
- /**
73
- * What the HTTP layer asks of each component, read from the HTTP layer.
74
- *
75
- * Deliberately not a list kept here: a list is a second statement of the same
76
- * fact, and the two drift. The callers are the statement. A route names the
77
- * component it was handed (`serving.getFileStream`); `server.js` names it
78
- * through what the wiring returned (`outputParts.serving.getFileStream`).
79
- *
80
- * @returns {Map<string, string[]>} `component.member` to the files that ask for it.
81
- */
82
- function membersTheHttpLayerCalls() {
83
- /** @type {Map<string, string[]>} */
84
- const asked = new Map();
85
- const sources = [path.join(PROXY, "server.js"), ...jsFilesUnder(path.join(PROXY, "routes"))];
86
- const pattern = new RegExp(String.raw`\b(${COMPONENTS.join("|")})\.([A-Za-z][A-Za-z0-9]*)\(`, "g");
87
- for (const file of sources) {
88
- const text = readFileSync(file, "utf8");
89
- for (const match of text.matchAll(pattern)) {
90
- const asking = `${match[1]}.${match[2]}`;
91
- const where = asked.get(asking) ?? [];
92
- where.push(path.relative(PROXY, file));
93
- asked.set(asking, where);
94
- }
95
- }
96
- return asked;
97
- }
98
-
99
- /**
100
- * A manager with nothing running behind it, over a store of its own.
101
- *
102
- * Its two timers are unref'd, so nothing here keeps the process alive.
103
- *
104
- * @returns {object}
105
- */
106
- function bareManager() {
107
- return managerWithOwnStore().manager;
108
- }
109
-
110
- /**
111
- * A session shaped like a live one, with no encoder behind it.
112
- *
113
- * @param {{ id?: string }} [params]
114
- * @returns {object}
115
- */
116
- function fakeSession({ id = SESSION_ID } = {}) {
117
- return {
118
- id,
119
- spec: outputSpec({ cutGrid: "keyframe", audioSeparate: true }),
120
- outputKey: "surface:fmt=fmp4:grid=kf@0:video-only:v=0/copy",
121
- dirPath: path.join(PROXY, "test", "does-not-exist"),
122
- file: new SourceFile({ sourceKey: "torrent:abc", fileIndex: 0, name: "video.mkv" })
123
- .learn({ width: 1920, height: 1080 }),
124
- get inputFile() { return this.file; },
125
- get audioFile() { return this.file; },
126
- timeline: new Timeline({
127
- boundaries: Array.from({ length: 11 }, (_, index) => index * 4),
128
- cutGrid: "keyframe"
129
- }),
130
- segmentFormat: fmp4Format,
131
- output: new Output({
132
- encodeWidth: 0,
133
- encodeHeight: 0,
134
- outputFps: 24,
135
- softwarePreset: null,
136
- applyTonemap: false
137
- }),
138
- transcodeVideo: false,
139
- transcodeAudio: true,
140
- audioTrackIndex: 0,
141
- audioSourceTrackIndex: 0,
142
- useSyntheticPlaylist: true,
143
- playlistText: "#EXTM3U\n",
144
- segmentCount: 10,
145
- progress: { state: "running", processedSeconds: 0, startPositionSeconds: 0, speed: "1.0x" }
146
- };
147
- }
148
-
149
- test("every call the HTTP layer makes is answered", () => {
150
- const parts = bareManager();
151
- const asked = membersTheHttpLayerCalls();
152
- // If this ever reads zero the extraction has broken, and the test would then
153
- // pass by asking nothing at all.
154
- assert.ok(asked.size >= 15, `expected the HTTP layer to ask for members, found ${asked.size}`);
155
-
156
- const missing = [];
157
- for (const [asking, callers] of asked) {
158
- const [component, member] = asking.split(".");
159
- if (!(parts[component] && member in parts[component])) {
160
- missing.push(`${asking} (asked by ${[...new Set(callers)].join(", ")})`);
161
- }
162
- }
163
- assert.deepEqual(missing, [], `the HTTP layer calls members no component has:\n${missing.join("\n")}`);
164
- });
165
-
166
- test("the progress report keeps every figure it carries today", async () => {
167
- const manager = bareManager();
168
- manager.outputs.set(SESSION_ID, fakeSession());
169
- const progress = await manager.viewerRequests.getSessionProgress(SESSION_ID, "viewer-one");
170
- assert.ok(progress, "a live session has a progress report");
171
-
172
- // A characteristic record: what the page is given now. The claim is "a move
173
- // did not change this", never "this is the right set".
174
- const carried = [
175
- "sessionId",
176
- "state",
177
- "minimumBufferSeconds",
178
- "processedSeconds",
179
- "inputBytes",
180
- "startPositionSeconds",
181
- "totalSeconds",
182
- "percent",
183
- "remainingSeconds",
184
- "segmentDurationSec",
185
- "speed",
186
- "currentHeight",
187
- "offeredHeights",
188
- "requestedHeight",
189
- "expectedSessionCreateMs",
190
- "expectedFirstSegmentMs",
191
- "updatedAt",
192
- "error"
193
- ];
194
- const absent = carried.filter((key) => !(key in progress));
195
- assert.deepEqual(absent, [], `the progress report lost ${absent.join(", ")}`);
196
- assert.equal(progress.sessionId, SESSION_ID);
197
- });
198
-
199
- test("a session that is not there is answered, not invented", async () => {
200
- const manager = bareManager();
201
- const absent = "ffffffffffffffff";
202
-
203
- assert.equal(await manager.viewerRequests.getSessionProgress(absent), null);
204
- assert.equal((await manager.serving.getFileStream(absent, "segment-00000.mp4")).kind, "not-found");
205
- // A name no session could have must be refused before anything touches the
206
- // disk with it.
207
- assert.equal((await manager.serving.getFileStream("../../etc", "segment-00000.mp4")).kind, "not-found");
208
- });
209
-
210
- test("what a viewer states about themselves is kept and answered", () => {
211
- const manager = bareManager();
212
- manager.outputs.set(SESSION_ID, fakeSession());
213
-
214
- // Nine public members had no test of any kind before the dismantling began,
215
- // and six of them are the viewer's own facts — the ones that move into
216
- // `viewer/`. They are cheap to state and were simply never stated.
217
-
218
- // A SEEK DOES ONE THING: it puts the viewer where they now are. Recorded
219
- // here because it used to do eleven, and because the one remaining effect is
220
- // what every reading of a viewer's position now rests on.
221
- assert.equal(manager.viewerRequests.requestSeek(SESSION_ID, 120, "viewer-one"), true);
222
- assert.equal(manager.viewerRequests.viewerPositionOf(SESSION_ID, "viewer-one"), 120);
223
- assert.equal(manager.viewerRequests.requestSeek("no-such-session", 120, "viewer-one"), false);
224
-
225
- // A seek wakes requests held on each output this viewer watches so each one
226
- // can check whether it is still the segment this viewer needs.
227
- assert.equal(manager.serving.seekEpoch(SESSION_ID), 1, "a seek invalidates waits on the watched output");
228
- assert.equal(manager.serving.seekEpoch("no-such-session"), 0);
229
-
230
- manager.encodeRuns.noteInputBytes(SESSION_ID, 4096);
231
- manager.encodeRuns.noteInputBytes(SESSION_ID, 1024);
232
- assert.equal(
233
- manager.encodeRuns.inputBytesOf(manager.outputs.get(SESSION_ID)),
234
- 5120,
235
- "input bytes accumulate at their owner"
236
- );
237
-
238
- // A far fragment is a reading and must never throw, whatever the player says.
239
- manager.serving.recordFragmentFar(SESSION_ID, {
240
- sn: 40, track: "video", fragStartSec: 200, bufferEndSec: 130, currentTimeSec: 128
241
- });
242
- manager.serving.recordFragmentFar("no-such-session", { sn: 1, track: "video" });
243
- });
244
-
245
- test("a session nobody has touched is disposed, one that is being watched is not", async () => {
246
- const manager = bareManager();
247
- const stale = fakeSession({ id: "1111111111111111" });
248
- const fresh = fakeSession({ id: "2222222222222222" });
249
- // Older than any TTL this manager could carry, without naming one here: the
250
- // period is the manager's business and this test is about the rule.
251
- manager.outputs.set(stale.id, stale);
252
- manager.outputs.set(fresh.id, fresh);
253
- manager.outputs.touch(stale, Date.now() - (2 * 60 * 60 * 1000));
254
-
255
- await manager.lifecycle.cleanupExpired();
256
-
257
- assert.equal(manager.outputs.has(stale.id), false, "an untouched session goes");
258
- assert.equal("state" in stale, false, "removal from the registry is the only lifetime fact");
259
- assert.equal(manager.outputs.has(fresh.id), true, "a session just read stays");
260
- });
261
-
262
- test("what a file declares and what this host could offer are answered without a session", () => {
263
- const manager = bareManager();
264
- const session = fakeSession();
265
- manager.outputs.set(SESSION_ID, session);
266
-
267
- // `declaredTracks` reads the session's own record and must answer even when
268
- // nothing has probed the file yet.
269
- assert.doesNotThrow(() => manager.renditions.declaredTracks(session));
270
-
271
- // The offer is predicted before any session exists — that is its whole point,
272
- // the menu being complete from the moment a file is opened.
273
- assert.equal(manager.quality.predictOfferedHeights({ height: 0, width: 0 }), null, "an unknown picture offers nothing");
274
- const offered = manager.quality.predictOfferedHeights({
275
- height: 1080, width: 1920, fps: 24, sourceKey: "torrent:abc", fileIndex: 0
276
- });
277
- // TWO ANSWERS, not one: what this host can hold when the picture is copied,
278
- // and what it can hold when it is re-encoded. The browser decides which of
279
- // the two applies, because whether it can play the source is its own fact.
280
- assert.ok(Array.isArray(offered?.copy), "the copied branch gets a list");
281
- assert.ok(Array.isArray(offered?.transcode), "the re-encoded branch gets a list");
282
- });
283
-
284
- test("a segment name that is not one is refused", async () => {
285
- const manager = bareManager();
286
- manager.outputs.set(SESSION_ID, fakeSession());
287
-
288
- for (const name of ["../key.txt", "segment-00000.mp4/../../x", "making-0-00000.mp4"]) {
289
- const answer = await manager.serving.getFileStream(SESSION_ID, name);
290
- assert.equal(answer.kind, "not-found", `${name} must not be servable`);
291
- }
292
- });
1
+ /**
2
+ * @file What the HTTP layer asks of the components, checked from the HTTP layer.
3
+ *
4
+ * Written as the net under the dismantling of `hls-session-manager.js`, which
5
+ * was 9608 lines and 142 methods and is now gone: its members are methods of
6
+ * the components that own them, wired by `services/server/wire-outputs.js`.
7
+ * Most tests that build those components name something INSIDE them — a field,
8
+ * a fake output shaped the way one happens to be shaped — so they move when the
9
+ * code moves, and a test that moves with the code cannot say the code still
10
+ * works.
11
+ *
12
+ * This one is derived from the other side: from what the HTTP layer asks of
13
+ * the components. That contract does not move. A route calling a member that no longer exists
14
+ * is the exact failure a nine-step move risks, and it is silent — Fastify
15
+ * answers 500 at runtime, months later, on a path no unit test walks.
16
+ *
17
+ * So the first check READS `routes/` and `server.js` rather than listing what
18
+ * the manager has. It cannot go stale: adding a call to a route adds it to the
19
+ * requirement, and removing the member it names breaks this test the same
20
+ * minute.
21
+ *
22
+ * The second is a characteristic record rather than a judgement: what the
23
+ * progress report carries today. Eighteen figures reach the page from it and
24
+ * nothing on this side of the wire knows which of them the page needs, so the
25
+ * honest statement is "these are the ones there were" — the point being that a
26
+ * move must not change them, not that they are the right ones.
27
+ *
28
+ * Every manager here has a store root of its own, for the reason
29
+ * `helpers/manager.js` records.
30
+ */
31
+
32
+ import test from "node:test";
33
+ import assert from "node:assert/strict";
34
+ import { readFileSync, readdirSync } from "node:fs";
35
+ import path from "node:path";
36
+ import { fileURLToPath } from "node:url";
37
+ import { SourceFile } from "../services/media/SourceFile.js";
38
+ import { Timeline } from "../services/encode/output/Timeline.js";
39
+ import { managerWithOwnStore } from "./helpers/manager.js";
40
+ import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
41
+ import { Output } from "../services/encode/output/Output.js";
42
+ import { outputSpec } from "./helpers/output-spec.js";
43
+
44
+ const HERE = path.dirname(fileURLToPath(import.meta.url));
45
+ const PROXY = path.join(HERE, "..");
46
+ const SESSION_ID = "aaaaaaaabbbbcccc";
47
+ /** The components the HTTP layer is handed. */
48
+ const COMPONENTS = ["serving", "viewerRequests", "renditions", "lifecycle", "quality", "outputs", "hostTimings", "viewers", "encodeRuns"];
49
+
50
+ /**
51
+ * Every `.js` file under a directory, at any depth.
52
+ *
53
+ * @param {string} dir
54
+ * @returns {string[]}
55
+ */
56
+ function jsFilesUnder(dir) {
57
+ /** @type {string[]} */
58
+ const found = [];
59
+ for (const entry of readdirSync(dir, { withFileTypes: true })) {
60
+ const full = path.join(dir, entry.name);
61
+ if (entry.isDirectory()) {
62
+ found.push(...jsFilesUnder(full));
63
+ continue;
64
+ }
65
+ if (entry.name.endsWith(".js")) {
66
+ found.push(full);
67
+ }
68
+ }
69
+ return found;
70
+ }
71
+
72
+ /**
73
+ * What the HTTP layer asks of each component, read from the HTTP layer.
74
+ *
75
+ * Deliberately not a list kept here: a list is a second statement of the same
76
+ * fact, and the two drift. The callers are the statement. A route names the
77
+ * component it was handed (`serving.getFileStream`); `server.js` names it
78
+ * through what the wiring returned (`outputParts.serving.getFileStream`).
79
+ *
80
+ * @returns {Map<string, string[]>} `component.member` to the files that ask for it.
81
+ */
82
+ function membersTheHttpLayerCalls() {
83
+ /** @type {Map<string, string[]>} */
84
+ const asked = new Map();
85
+ const sources = [path.join(PROXY, "server.js"), ...jsFilesUnder(path.join(PROXY, "routes"))];
86
+ const pattern = new RegExp(String.raw`\b(${COMPONENTS.join("|")})\.([A-Za-z][A-Za-z0-9]*)\(`, "g");
87
+ for (const file of sources) {
88
+ const text = readFileSync(file, "utf8");
89
+ for (const match of text.matchAll(pattern)) {
90
+ const asking = `${match[1]}.${match[2]}`;
91
+ const where = asked.get(asking) ?? [];
92
+ where.push(path.relative(PROXY, file));
93
+ asked.set(asking, where);
94
+ }
95
+ }
96
+ return asked;
97
+ }
98
+
99
+ /**
100
+ * A manager with nothing running behind it, over a store of its own.
101
+ *
102
+ * Its two timers are unref'd, so nothing here keeps the process alive.
103
+ *
104
+ * @returns {object}
105
+ */
106
+ function bareManager() {
107
+ return managerWithOwnStore().manager;
108
+ }
109
+
110
+ /**
111
+ * A session shaped like a live one, with no encoder behind it.
112
+ *
113
+ * @param {{ id?: string }} [params]
114
+ * @returns {object}
115
+ */
116
+ function fakeSession({ id = SESSION_ID } = {}) {
117
+ return {
118
+ id,
119
+ spec: outputSpec({ cutGrid: "keyframe", audioSeparate: true }),
120
+ outputKey: "surface:fmt=fmp4:grid=kf@0:video-only:v=0/copy",
121
+ dirPath: path.join(PROXY, "test", "does-not-exist"),
122
+ file: new SourceFile({ sourceKey: "torrent:abc", fileIndex: 0, name: "video.mkv" })
123
+ .learn({ width: 1920, height: 1080 }),
124
+ get inputFile() { return this.file; },
125
+ get audioFile() { return this.file; },
126
+ timeline: new Timeline({
127
+ boundaries: Array.from({ length: 11 }, (_, index) => index * 4),
128
+ cutGrid: "keyframe"
129
+ }),
130
+ segmentFormat: fmp4Format,
131
+ output: new Output({
132
+ encodeWidth: 0,
133
+ encodeHeight: 0,
134
+ outputFps: 24,
135
+ softwarePreset: null,
136
+ applyTonemap: false
137
+ }),
138
+ transcodeVideo: false,
139
+ transcodeAudio: true,
140
+ audioTrackIndex: 0,
141
+ audioSourceTrackIndex: 0,
142
+ useSyntheticPlaylist: true,
143
+ playlistText: "#EXTM3U\n",
144
+ segmentCount: 10,
145
+ progress: { state: "running", processedSeconds: 0, startPositionSeconds: 0, speed: "1.0x" }
146
+ };
147
+ }
148
+
149
+ test("every call the HTTP layer makes is answered", () => {
150
+ const parts = bareManager();
151
+ const asked = membersTheHttpLayerCalls();
152
+ // If this ever reads zero the extraction has broken, and the test would then
153
+ // pass by asking nothing at all.
154
+ assert.ok(asked.size >= 15, `expected the HTTP layer to ask for members, found ${asked.size}`);
155
+
156
+ const missing = [];
157
+ for (const [asking, callers] of asked) {
158
+ const [component, member] = asking.split(".");
159
+ if (!(parts[component] && member in parts[component])) {
160
+ missing.push(`${asking} (asked by ${[...new Set(callers)].join(", ")})`);
161
+ }
162
+ }
163
+ assert.deepEqual(missing, [], `the HTTP layer calls members no component has:\n${missing.join("\n")}`);
164
+ });
165
+
166
+ test("the progress report keeps every figure it carries today", async () => {
167
+ const manager = bareManager();
168
+ manager.outputs.set(SESSION_ID, fakeSession());
169
+ const progress = await manager.viewerRequests.getSessionProgress(SESSION_ID, "viewer-one");
170
+ assert.ok(progress, "a live session has a progress report");
171
+
172
+ // A characteristic record: what the page is given now. The claim is "a move
173
+ // did not change this", never "this is the right set".
174
+ const carried = [
175
+ "sessionId",
176
+ "state",
177
+ "minimumBufferSeconds",
178
+ "processedSeconds",
179
+ "inputBytes",
180
+ "startPositionSeconds",
181
+ "totalSeconds",
182
+ "percent",
183
+ "remainingSeconds",
184
+ "segmentDurationSec",
185
+ "speed",
186
+ "currentHeight",
187
+ "offeredHeights",
188
+ "requestedHeight",
189
+ "expectedSessionCreateMs",
190
+ "expectedFirstSegmentMs",
191
+ "updatedAt",
192
+ "error"
193
+ ];
194
+ const absent = carried.filter((key) => !(key in progress));
195
+ assert.deepEqual(absent, [], `the progress report lost ${absent.join(", ")}`);
196
+ assert.equal(progress.sessionId, SESSION_ID);
197
+ });
198
+
199
+ test("a session that is not there is answered, not invented", async () => {
200
+ const manager = bareManager();
201
+ const absent = "ffffffffffffffff";
202
+
203
+ assert.equal(await manager.viewerRequests.getSessionProgress(absent), null);
204
+ assert.equal((await manager.serving.getFileStream(absent, "segment-00000.mp4")).kind, "not-found");
205
+ // A name no session could have must be refused before anything touches the
206
+ // disk with it.
207
+ assert.equal((await manager.serving.getFileStream("../../etc", "segment-00000.mp4")).kind, "not-found");
208
+ });
209
+
210
+ test("what a viewer states about themselves is kept and answered", () => {
211
+ const manager = bareManager();
212
+ manager.outputs.set(SESSION_ID, fakeSession());
213
+
214
+ // Nine public members had no test of any kind before the dismantling began,
215
+ // and six of them are the viewer's own facts — the ones that move into
216
+ // `viewer/`. They are cheap to state and were simply never stated.
217
+
218
+ // A SEEK DOES ONE THING: it puts the viewer where they now are. Recorded
219
+ // here because it used to do eleven, and because the one remaining effect is
220
+ // what every reading of a viewer's position now rests on.
221
+ assert.equal(manager.viewerRequests.requestSeek(SESSION_ID, 120, "viewer-one"), true);
222
+ assert.equal(manager.viewerRequests.viewerPositionOf(SESSION_ID, "viewer-one"), 120);
223
+ assert.equal(manager.viewerRequests.requestSeek("no-such-session", 120, "viewer-one"), false);
224
+
225
+ // A seek wakes requests held on each output this viewer watches so each one
226
+ // can check whether it is still the segment this viewer needs.
227
+ assert.equal(manager.serving.seekEpoch(SESSION_ID), 1, "a seek invalidates waits on the watched output");
228
+ assert.equal(manager.serving.seekEpoch("no-such-session"), 0);
229
+
230
+ manager.encodeRuns.noteInputBytes(SESSION_ID, 4096);
231
+ manager.encodeRuns.noteInputBytes(SESSION_ID, 1024);
232
+ assert.equal(
233
+ manager.encodeRuns.inputBytesOf(manager.outputs.get(SESSION_ID)),
234
+ 5120,
235
+ "input bytes accumulate at their owner"
236
+ );
237
+
238
+ // A far fragment is a reading and must never throw, whatever the player says.
239
+ manager.serving.recordFragmentFar(SESSION_ID, {
240
+ sn: 40, track: "video", fragStartSec: 200, bufferEndSec: 130, currentTimeSec: 128
241
+ });
242
+ manager.serving.recordFragmentFar("no-such-session", { sn: 1, track: "video" });
243
+ });
244
+
245
+ test("a session nobody has touched is disposed, one that is being watched is not", async () => {
246
+ const manager = bareManager();
247
+ const stale = fakeSession({ id: "1111111111111111" });
248
+ const fresh = fakeSession({ id: "2222222222222222" });
249
+ // Older than any TTL this manager could carry, without naming one here: the
250
+ // period is the manager's business and this test is about the rule.
251
+ manager.outputs.set(stale.id, stale);
252
+ manager.outputs.set(fresh.id, fresh);
253
+ manager.outputs.touch(stale, Date.now() - (2 * 60 * 60 * 1000));
254
+
255
+ await manager.lifecycle.cleanupExpired();
256
+
257
+ assert.equal(manager.outputs.has(stale.id), false, "an untouched session goes");
258
+ assert.equal("state" in stale, false, "removal from the registry is the only lifetime fact");
259
+ assert.equal(manager.outputs.has(fresh.id), true, "a session just read stays");
260
+ });
261
+
262
+ test("what a file declares and what this host could offer are answered without a session", () => {
263
+ const manager = bareManager();
264
+ const session = fakeSession();
265
+ manager.outputs.set(SESSION_ID, session);
266
+
267
+ // `declaredTracks` reads the session's own record and must answer even when
268
+ // nothing has probed the file yet.
269
+ assert.doesNotThrow(() => manager.renditions.declaredTracks(session));
270
+
271
+ // The offer is predicted before any session exists — that is its whole point,
272
+ // the menu being complete from the moment a file is opened.
273
+ assert.equal(manager.quality.predictOfferedHeights({ height: 0, width: 0 }), null, "an unknown picture offers nothing");
274
+ const offered = manager.quality.predictOfferedHeights({
275
+ height: 1080, width: 1920, fps: 24, sourceKey: "torrent:abc", fileIndex: 0
276
+ });
277
+ // TWO ANSWERS, not one: what this host can hold when the picture is copied,
278
+ // and what it can hold when it is re-encoded. The browser decides which of
279
+ // the two applies, because whether it can play the source is its own fact.
280
+ assert.ok(Array.isArray(offered?.copy), "the copied branch gets a list");
281
+ assert.ok(Array.isArray(offered?.transcode), "the re-encoded branch gets a list");
282
+ });
283
+
284
+ test("a segment name that is not one is refused", async () => {
285
+ const manager = bareManager();
286
+ manager.outputs.set(SESSION_ID, fakeSession());
287
+
288
+ for (const name of ["../key.txt", "segment-00000.mp4/../../x", "making-0-00000.mp4"]) {
289
+ const answer = await manager.serving.getFileStream(SESSION_ID, name);
290
+ assert.equal(answer.kind, "not-found", `${name} must not be servable`);
291
+ }
292
+ });