@torrent-tv/proxy 2.85.1 → 2.87.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 (381) hide show
  1. package/CHANGELOG.md +2138 -1909
  2. package/CLAUDE.md +318 -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/container-architecture.md +218 -213
  7. package/docs/download-architecture.md +7 -7
  8. package/docs/encode-architecture.md +287 -11
  9. package/docs/encode-run-state.md +2 -2
  10. package/docs/logs.md +97 -97
  11. package/docs/{disk-architecture.md → storage-architecture.md} +107 -1
  12. package/openspec/changes/adaptive-bitrate/design.md +2 -2
  13. package/openspec/changes/adaptive-bitrate/proposal.md +1 -1
  14. package/openspec/changes/adaptive-bitrate/tasks.md +1 -1
  15. package/openspec/changes/chunked-request-bodies/design.md +1 -1
  16. package/openspec/changes/chunked-request-bodies/proposal.md +1 -1
  17. package/openspec/changes/chunked-request-bodies/tasks.md +1 -1
  18. package/openspec/changes/cold-start/design.md +1 -1
  19. package/openspec/changes/disk-cap/proposal.md +1 -1
  20. package/openspec/changes/proxy-observability/proposal.md +2 -2
  21. package/openspec/changes/track-selection/proposal.md +1 -1
  22. package/openspec/changes/transcode-quality/proposal.md +1 -1
  23. package/package.json +2 -2
  24. package/research/delivery-wedge-stand-ladder-2026-09-13.md +329 -329
  25. package/research/double-spawn-2026-09-10.md +171 -171
  26. package/routes/api/playback-plan/post.js +2 -2
  27. package/routes/api/sources/files/get.js +1 -1
  28. package/routes/api/sources/stats/get.js +1 -1
  29. package/routes/api/sources/warm/post.js +10 -3
  30. package/routes/api/subtitles/get.js +230 -230
  31. package/routes/api/transcode-sessions/fragment-far/post.js +3 -3
  32. package/routes/api/transcode-sessions/net-report/post.js +129 -94
  33. package/routes/api/transcode-sessions/post.js +160 -139
  34. package/routes/api/transcode-sessions/progress/get.js +3 -3
  35. package/routes/api/transcode-sessions/release/post.js +3 -3
  36. package/routes/api/transcode-sessions/seek/post.js +12 -3
  37. package/routes/stream/get.js +2 -2
  38. package/routes/transcode/audio-file/get.js +15 -6
  39. package/routes/transcode/audio-warm/get.js +8 -5
  40. package/routes/transcode/session-file/get.js +429 -268
  41. package/routes/transcode/variant-file/get.js +47 -7
  42. package/routes/transcode/variant-warm/get.js +18 -6
  43. package/scripts/render-run-graph.js +1 -1
  44. package/server.js +720 -465
  45. package/services/encode/CoverageMap.js +428 -428
  46. package/services/encode/CushionReport.js +345 -0
  47. package/services/encode/EncodeAdmission.js +332 -0
  48. package/services/{orchestrators → encode}/EncodeOrchestrator.js +285 -17
  49. package/services/encode/EncodeRun.js +16 -9
  50. package/services/encode/EncodeRuns.js +1219 -0
  51. package/services/encode/Encoder.js +18 -2
  52. package/services/encode/EncoderSelection.js +38 -0
  53. package/services/encode/LocalObservations.js +359 -0
  54. package/services/encode/NvencEncoder.js +5 -0
  55. package/services/encode/OutputOpening.js +745 -0
  56. package/services/encode/OutputTimes.js +579 -0
  57. package/services/encode/Renditions.js +2162 -0
  58. package/services/encode/RunProgress.js +84 -0
  59. package/services/encode/SoftwareEncoder.js +12 -7
  60. package/services/encode/args.js +402 -186
  61. package/services/encode/calibration.js +361 -0
  62. package/services/encode/contention.js +128 -128
  63. package/services/encode/encode-run-state.js +16 -20
  64. package/services/encode/fingerprint.js +322 -0
  65. package/services/{hwaccel.js → encode/hwaccel.js} +82 -42
  66. package/services/{learned-median.js → encode/learned-median.js} +11 -0
  67. package/services/encode/output/EncodedOutput.js +57 -0
  68. package/services/encode/output/Output.js +131 -0
  69. package/services/{output/LiveOutputs.js → encode/output/OutputCatalog.js} +141 -40
  70. package/services/encode/output/OutputSpec.js +390 -0
  71. package/services/{output → encode/output}/Timeline.js +12 -37
  72. package/services/encode/output/index.js +20 -0
  73. package/services/encode/output/ladder.js +32 -0
  74. package/services/{output → encode/output}/playlists.js +3 -0
  75. package/services/encode/output-key-format.js +21 -0
  76. package/services/encode/quality/EncodeCost.js +1083 -0
  77. package/services/encode/quality/HostLoad.js +525 -0
  78. package/services/encode/quality/HostTimings.js +249 -0
  79. package/services/encode/quality/OutputQualityState.js +28 -0
  80. package/services/encode/quality/QualityController.js +931 -0
  81. package/services/encode/quality/QualityOffer.js +416 -0
  82. package/services/encode/quality/drain-threat.js +47 -0
  83. package/services/encode/quality/link-budget.js +254 -0
  84. package/services/encode/quality/output-format.js +266 -0
  85. package/services/encode/quality/serving-output.js +216 -0
  86. package/services/encode/quality/visible-rung.js +57 -0
  87. package/services/encode/run-command.js +23 -20
  88. package/services/encode/run-inputs.js +42 -0
  89. package/services/{segment-formats → encode/segment-formats}/fmp4.js +63 -0
  90. package/services/{segment-formats → encode/segment-formats}/index.js +3 -3
  91. package/services/encode/segment-formats/init-compat.js +324 -0
  92. package/services/{segment-formats → encode/segment-formats}/mp4-boxes.js +8 -3
  93. package/services/encode/throughput.js +97 -0
  94. package/services/{orchestrators → media}/ContainerOrchestrator.js +45 -7
  95. package/services/media/KeyframeTables.js +316 -0
  96. package/services/{source → media}/SourceFile.js +7 -55
  97. package/services/{torrent-worker/subtitle-cues.js → media/SubtitleCues.js} +103 -132
  98. package/services/media/SubtitleOrchestrator.js +167 -0
  99. package/services/{audio-inventory.js → media/audio-inventory.js} +7 -1
  100. package/services/{container → media/container}/AviContainer.js +266 -266
  101. package/services/{container → media/container}/Container.js +596 -601
  102. package/services/media/container/ContainerFactory.js +56 -0
  103. package/services/media/container/KeyframeTable.js +272 -0
  104. package/services/{container → media/container}/MatroskaContainer.js +1485 -1485
  105. package/services/{container → media/container}/Mp4Container.js +1244 -1244
  106. package/services/{container → media/container}/SubtitleFileContainer.js +322 -322
  107. package/services/media/keyframe-probe.js +157 -0
  108. package/services/media/media-info-probe.js +93 -0
  109. package/services/{playback-planner.js → media/playback-planner.js} +82 -39
  110. package/services/{tracks → media/tracks}/AudioTrack.js +131 -131
  111. package/services/{tracks → media/tracks}/language-detect.js +174 -174
  112. package/services/server/OutputLifecycle.js +418 -0
  113. package/services/server/SegmentServing.js +1146 -0
  114. package/services/server/ViewerRequests.js +522 -0
  115. package/services/server/controllers/PlaybackController.js +36 -0
  116. package/services/{controllers → server/controllers}/SubtitleController.js +17 -33
  117. package/services/server/wire-outputs.js +958 -0
  118. package/services/storage/Diagnostics.js +202 -0
  119. package/services/storage/MachineBudget.js +235 -0
  120. package/services/{piece-store → storage}/allowance.js +107 -107
  121. package/services/{core-dumps.js → storage/core-dumps.js} +1 -1
  122. package/services/{files → storage/files}/CompletedFiles.js +116 -1
  123. package/services/{disk → storage}/free.js +33 -0
  124. package/services/storage/machine-memory.js +56 -0
  125. package/services/{memory-report.js → storage/memory-report.js} +575 -596
  126. package/services/{piece-store → storage/piece-store}/piece-disk-store.js +0 -7
  127. package/services/{piece-store → storage/piece-store}/shared-piece-store.js +28 -21
  128. package/services/{encode → storage/segment-store}/SegmentStore.js +395 -8
  129. package/services/storage/wire.js +175 -0
  130. package/services/{download → torrent/download}/SwarmSelection.js +2 -2
  131. package/services/{download → torrent/download}/registry.js +2 -2
  132. package/services/torrent/files.js +1 -1
  133. package/services/torrent/piece-store-of.js +29 -0
  134. package/services/{torrent-pool.js → torrent/torrent-pool.js} +26 -119
  135. package/services/{torrent-worker → torrent/worker}/background-fill.js +2 -2
  136. package/services/{torrent-worker → torrent/worker}/channel.js +271 -250
  137. package/services/{torrent-worker → torrent/worker}/client.js +77 -58
  138. package/services/torrent/worker/held-bytes.js +155 -0
  139. package/services/{torrent-worker → torrent/worker}/install-webrtc-shim.js +1 -1
  140. package/services/{torrent-worker → torrent/worker}/piece-reader.js +21 -30
  141. package/services/{torrent-worker → torrent/worker}/pool-adapter.js +101 -137
  142. package/services/{torrent-worker → torrent/worker}/protocol.js +26 -30
  143. package/services/torrent/worker/resume-warm.js +107 -0
  144. package/services/{torrent-worker → torrent/worker}/webrtc-shim.js +2 -2
  145. package/services/{torrent-worker → torrent/worker}/worker.js +68 -159
  146. package/services/{data-channel-handler.js → transport/data-channel-handler.js} +1356 -1356
  147. package/services/{delivery-probe.js → transport/delivery-probe.js} +842 -842
  148. package/services/{health-collector.js → transport/health-collector.js} +6 -35
  149. package/services/{packet-witness.js → transport/packet-witness.js} +808 -784
  150. package/services/{port-mapper.js → transport/port-mapper.js} +1 -1
  151. package/services/{usrsctp-state.js → transport/usrsctp-state.js} +1 -1
  152. package/services/{webrtc-manager.js → transport/webrtc-manager.js} +1 -1
  153. package/services/viewer/Assignments.js +340 -0
  154. package/services/{priority → viewer}/PriorityMap.js +390 -390
  155. package/services/{priority → viewer}/PriorityOrchestrator.js +325 -320
  156. package/services/viewer/Viewer.js +657 -489
  157. package/services/viewer/Viewers.js +368 -257
  158. package/services/viewer/active-output.js +37 -54
  159. package/services/viewer/audio-start.js +46 -0
  160. package/services/viewer/buffer-trend.js +81 -0
  161. package/services/viewer/choices.js +647 -0
  162. package/services/viewer/positions.js +126 -120
  163. package/services/viewer/report-intake.js +46 -44
  164. package/test/asset-paths.test.js +28 -0
  165. package/test/audio-inventory.test.js +3 -3
  166. package/test/audio-track-bitrate.test.js +40 -0
  167. package/test/auto-quality-step.test.js +707 -518
  168. package/test/available-share.test.js +1 -1
  169. package/test/background-fill.test.js +1 -1
  170. package/test/client-log-file.test.js +110 -110
  171. package/test/completed-files.test.js +1 -1
  172. package/test/concurrent-cost.test.js +13 -3
  173. package/test/container-media-info.test.js +3 -3
  174. package/test/core-dumps.test.js +1 -1
  175. package/test/coverage-follows-the-disk.test.js +40 -8
  176. package/test/cue-push-carries-what-the-walk-found.test.js +58 -0
  177. package/test/cut-times-timeline.test.js +2 -2
  178. package/test/cuts-follow-published-grid.test.js +9 -8
  179. package/test/data-channel-frame.test.js +1 -1
  180. package/test/dead-torrent-handle.test.js +1 -1
  181. package/test/declared-rates.test.js +2 -2
  182. package/test/declared-tracks.test.js +2 -2
  183. package/test/decode-cost-fit.test.js +1 -1
  184. package/test/decode-cost.test.js +34 -25
  185. package/test/delivery-probe.test.js +1 -1
  186. package/test/demand-register.test.js +4 -4
  187. package/test/dht-bootstrap.test.js +1 -1
  188. package/test/drain-threat.test.js +65 -0
  189. package/test/duplicate-add.test.js +1 -1
  190. package/test/encode-admission.test.js +146 -0
  191. package/test/encode-cost.test.js +199 -10
  192. package/test/encode-orchestrator.test.js +39 -1
  193. package/test/encode-plan-viewers.test.js +2 -2
  194. package/test/encode-run.test.js +2 -2
  195. package/test/encode-slope.test.js +1 -1
  196. package/test/encoded-output.test.js +39 -0
  197. package/test/encoder-readings.test.js +1 -1
  198. package/test/every-claimant-is-told-its-share.test.js +152 -0
  199. package/test/failed-encoder-still-serves-what-exists.test.js +354 -0
  200. package/test/failed-start-breaker.test.js +81 -30
  201. package/test/fastest-wires.test.js +1 -1
  202. package/test/ffmpeg-stream-counts.test.js +1 -1
  203. package/test/file-edges.test.js +3 -3
  204. package/test/fmp4-self-contained.test.js +1 -1
  205. package/test/fmp4-timestamps.test.js +1 -1
  206. package/test/fmp4-track-completeness.test.js +1 -1
  207. package/test/format-keyed-outputs.test.js +78 -0
  208. package/test/health-metrics.test.js +3 -2
  209. package/test/held-request-width.test.js +22 -23
  210. package/test/helpers/encode-run.js +136 -136
  211. package/test/helpers/held-file.js +29 -0
  212. package/test/helpers/manager.js +57 -0
  213. package/test/helpers/output-spec.js +63 -0
  214. package/test/host-load.test.js +1 -1
  215. package/test/index-accuracy-is-about-the-file.test.js +128 -0
  216. package/test/init-compat.test.js +219 -0
  217. package/test/input-lost-quiets-the-plan.test.js +1 -1
  218. package/test/input-unavailable.test.js +1 -1
  219. package/test/keeping-period.test.js +4 -4
  220. package/test/keyframe-index-accuracy.test.js +97 -45
  221. package/test/keyframe-table-budget.test.js +28 -33
  222. package/test/keyframes-belong-to-the-file.test.js +174 -57
  223. package/test/learned-median.test.js +1 -1
  224. package/test/letting-go-asks-who-is-watching.test.js +191 -0
  225. package/test/limit-row-by-area.test.js +60 -0
  226. package/test/link-budget.test.js +111 -0
  227. package/test/link-probe.test.js +56 -56
  228. package/test/local-encoding-data.test.js +273 -0
  229. package/test/look-ahead-coverage.test.js +1 -1
  230. package/test/manager-surface.test.js +294 -0
  231. package/test/matroska-blocks.test.js +0 -0
  232. package/test/matroska-cues-track.test.js +1 -1
  233. package/test/memory-budget.test.js +2 -2
  234. package/test/mp4-composition-times.test.js +0 -0
  235. package/test/mp4-subtitles.test.js +1 -1
  236. package/test/one-authority.test.js +45 -41
  237. package/test/one-budget.test.js +149 -0
  238. package/test/one-output-one-session.test.js +204 -0
  239. package/test/{disk-space.test.js → one-resource-divided.test.js} +30 -10
  240. package/test/one-serving-output-per-height.test.js +458 -0
  241. package/test/orchestrator-wired.test.js +46 -45
  242. package/test/output-catalog.test.js +39 -0
  243. package/test/output-shape.test.js +4 -51
  244. package/test/output-spec.test.js +251 -157
  245. package/test/output-speed.test.js +17 -15
  246. package/test/outputs-being-prepared.test.js +40 -0
  247. package/test/packet-witness-ring.test.js +2 -2
  248. package/test/packet-witness.test.js +1 -1
  249. package/test/piece-disk-store.test.js +2 -2
  250. package/test/piece-from-whole-file.test.js +1 -1
  251. package/test/piece-lru.test.js +1 -1
  252. package/test/piece-reader.test.js +2 -2
  253. package/test/piece-store-eviction.test.js +1 -1
  254. package/test/piece-store-never-refuses.test.js +1 -1
  255. package/test/piece-store-reservations.test.js +1 -1
  256. package/test/piece-store-slow-disk.test.js +1 -1
  257. package/test/piece-tail.test.js +1 -1
  258. package/test/plan-host-timings.test.js +1 -1
  259. package/test/plan-is-steady.test.js +225 -225
  260. package/test/priority-map-download.test.js +4 -4
  261. package/test/priority-map-emptied.test.js +204 -205
  262. package/test/priority-map-per-output.test.js +215 -209
  263. package/test/priority-map.test.js +1 -1
  264. package/test/probe-wedge-certainty.test.js +1 -1
  265. package/test/produced-copy-choice.test.js +15 -60
  266. package/test/quality-offer.test.js +162 -0
  267. package/test/quality-variants.test.js +1229 -1167
  268. package/test/rate-control-in-the-output.test.js +180 -0
  269. package/test/read-survives-withdrawal.test.js +2 -2
  270. package/test/read-window.test.js +10 -3
  271. package/test/resume-warm.test.js +1 -1
  272. package/test/run-inputs.test.js +80 -0
  273. package/test/run-position-follows-published-grid.test.js +13 -11
  274. package/test/run-progress.test.js +65 -0
  275. package/test/same-height-switch.test.js +664 -0
  276. package/test/seek-frees-the-viewers-requests.test.js +217 -0
  277. package/test/seek-landing.test.js +13 -13
  278. package/test/seek-target-not-superseded.test.js +28 -29
  279. package/test/segment-closed-on-both-branches.test.js +96 -0
  280. package/test/segment-cut-times.test.js +1 -1
  281. package/test/segment-hold-supersede.test.js +28 -35
  282. package/test/segment-judged-by-its-own-header.test.js +221 -0
  283. package/test/segment-serve-wiring.test.js +130 -39
  284. package/test/segment-store-eviction.test.js +22 -7
  285. package/test/segment-store.test.js +98 -14
  286. package/test/segment-true-start.test.js +1 -1
  287. package/test/segments-are-shared.test.js +17 -16
  288. package/test/send-chunk-bytes.test.js +1 -1
  289. package/test/serving-existing-output.test.js +102 -0
  290. package/test/serving-output.test.js +102 -0
  291. package/test/shared-piece-store.test.js +1 -1
  292. package/test/source-file.test.js +1 -1
  293. package/test/stale-request-after-seek.test.js +17 -21
  294. package/test/startup-readings.test.js +10 -5
  295. package/test/subtitle-cue-framing.test.js +5 -5
  296. package/test/subtitle-cue-source.test.js +36 -38
  297. package/test/subtitle-cue-walk.test.js +11 -10
  298. package/test/subtitle-defaults.test.js +1 -1
  299. package/test/subtitle-language.test.js +4 -4
  300. package/test/subtitle-track-numbering.test.js +5 -4
  301. package/test/supply-margin.test.js +1 -1
  302. package/test/swarm-follows-readers.test.js +3 -3
  303. package/test/swarm-reach.test.js +1 -1
  304. package/test/swarm-selection.test.js +3 -3
  305. package/test/tail-duplication.test.js +1 -1
  306. package/test/the-channel-has-both-ends.test.js +91 -0
  307. package/test/the-torrent-thread-serves-bytes.test.js +107 -0
  308. package/test/thread-pool.test.js +3 -3
  309. package/test/timeline.test.js +1 -12
  310. package/test/torrent-cost.test.js +1 -1
  311. package/test/tracks-begin-together.test.js +38 -24
  312. package/test/tunnel-renewal.test.js +1 -1
  313. package/test/two-viewers-one-picture.test.js +120 -87
  314. package/test/upload-hurry.test.js +3 -3
  315. package/test/usrsctp-state.test.js +1 -1
  316. package/test/video-facts.test.js +1 -1
  317. package/test/viewer-assignments.test.js +143 -0
  318. package/test/viewer-outputs.test.js +60 -52
  319. package/test/viewer-presence.test.js +22 -25
  320. package/test/viewer-requests-admission.test.js +89 -0
  321. package/test/viewer-states.test.js +189 -172
  322. package/test/viewer-subtitle-subscription.test.js +1 -1
  323. package/test/viewer.test.js +139 -136
  324. package/test/viewing-generations.test.js +390 -0
  325. package/test/visible-rung.test.js +37 -0
  326. package/test/wait-ledger.test.js +1 -1
  327. package/test/webrtc-shim.test.js +3 -3
  328. package/test/wedge-certainty.test.js +2 -2
  329. package/test/withdraw-piece-claim.test.js +2 -2
  330. package/test/worker-channel.test.js +1 -31
  331. package/utils/client-log-file.js +151 -151
  332. package/scripts/read-container-index.mjs +0 -108
  333. package/services/container/ContainerFactory.js +0 -122
  334. package/services/controllers/PlaybackController.js +0 -33
  335. package/services/disk/DiskSpace.js +0 -150
  336. package/services/disk/wire.js +0 -61
  337. package/services/hls-session-manager.js +0 -9689
  338. package/services/orchestrators/SubtitleOrchestrator.js +0 -160
  339. package/services/output/Output.js +0 -94
  340. package/services/output/OutputSpec.js +0 -202
  341. package/services/output/index.js +0 -1
  342. package/services/output/ladder.js +0 -26
  343. package/services/produced-index.js +0 -222
  344. package/services/quality/EncodeCost.js +0 -555
  345. package/services/torrent-worker/container-tracks.js +0 -414
  346. package/test/produced-index.test.js +0 -142
  347. /package/{services → bin}/thread-pool.js +0 -0
  348. /package/services/{available-share.js → encode/available-share.js} +0 -0
  349. /package/services/{decode-cost-fit.js → encode/decode-cost-fit.js} +0 -0
  350. /package/services/{encoder-readings.js → encode/encoder-readings.js} +0 -0
  351. /package/services/{host-load.js → encode/host-load.js} +0 -0
  352. /package/services/{output → encode/output}/cut-grid.js +0 -0
  353. /package/services/{output → encode/output}/rates.js +0 -0
  354. /package/services/{segment-formats → encode/segment-formats}/mpegts.js +0 -0
  355. /package/services/{torrent-cost.js → encode/torrent-cost.js} +0 -0
  356. /package/services/{container → media/container}/ebml-reader.js +0 -0
  357. /package/services/{ffmpeg-banner.js → media/ffmpeg-banner.js} +0 -0
  358. /package/services/{tracks → media/tracks}/ContainerTrack.js +0 -0
  359. /package/services/{tracks → media/tracks}/ImageSubtitleTrack.js +0 -0
  360. /package/services/{tracks → media/tracks}/SubtitleTrack.js +0 -0
  361. /package/services/{tracks → media/tracks}/TextSubtitleTrack.js +0 -0
  362. /package/services/{tracks → media/tracks}/VideoTrack.js +0 -0
  363. /package/services/{tracks → media/tracks}/index.js +0 -0
  364. /package/services/{files → storage/files}/piece-from-whole-file.js +0 -0
  365. /package/services/{disk → storage}/keep.js +0 -0
  366. /package/services/{piece-store → storage/piece-store}/piece-lru.js +0 -0
  367. /package/services/{disk → storage}/returns.js +0 -0
  368. /package/services/{demand → torrent/demand}/DemandRegister.js +0 -0
  369. /package/services/{demand → torrent/demand}/Urgency.js +0 -0
  370. /package/services/{demand → torrent/demand}/Window.js +0 -0
  371. /package/services/{demand → torrent/demand}/index.js +0 -0
  372. /package/services/{demand → torrent/demand}/pieces.js +0 -0
  373. /package/services/{download → torrent/download}/withdraw-claim.js +0 -0
  374. /package/services/{supply-margin.js → torrent/supply-margin.js} +0 -0
  375. /package/services/{torrent-source-key.js → torrent/torrent-source-key.js} +0 -0
  376. /package/services/{torrent-worker → torrent/worker}/fastest-wires.js +0 -0
  377. /package/services/{torrent-worker → torrent/worker}/handle-state.js +0 -0
  378. /package/services/{nat-classifier.js → transport/nat-classifier.js} +0 -0
  379. /package/services/{registry-api.js → transport/registry-api.js} +0 -0
  380. /package/services/{tunnel-client.js → transport/tunnel-client.js} +0 -0
  381. /package/services/{priority → viewer}/WaitLedger.js +0 -0
@@ -9,7 +9,7 @@ import {
9
9
  adoptOrphanRingFiles,
10
10
  createPacketWitness,
11
11
  WITNESS_RING_BASENAME
12
- } from "../services/packet-witness.js";
12
+ } from "../services/transport/packet-witness.js";
13
13
 
14
14
  /**
15
15
  * A stand-in for a spawned tcpdump: it records how it was called and stays
@@ -175,7 +175,7 @@ test("a wedge keeps the ring's history, and the ring keeps recording afterwards"
175
175
  await writeFile(path.join(dir, `${WITNESS_RING_BASENAME}1`), "also-before");
176
176
 
177
177
  const started = witness.maybeCapture({
178
- sessionId: "68296f7d-0000-0000-0000-000000000000",
178
+ sessionId: "68296f7d00000000",
179
179
  tag: "68296f7d",
180
180
  label: "proxy",
181
181
  remote: { address: "2001:db8::1", port: 61649 },
@@ -21,7 +21,7 @@ import {
21
21
  WITNESS_RING_FILES,
22
22
  WITNESS_RTO_CEILING_SECONDS,
23
23
  WITNESS_TAIL_SECONDS
24
- } from "../services/packet-witness.js";
24
+ } from "../services/transport/packet-witness.js";
25
25
 
26
26
  test("an IPv4 literal survives unchanged", () => {
27
27
  assert.equal(normalizeRemoteAddress("192.168.178.57"), "192.168.178.57");
@@ -14,7 +14,7 @@ import assert from "node:assert/strict";
14
14
  import fs from "node:fs/promises";
15
15
  import os from "node:os";
16
16
  import path from "node:path";
17
- import { PieceDiskStore } from "../services/piece-store/piece-disk-store.js";
17
+ import { PieceDiskStore } from "../services/storage/piece-store/piece-disk-store.js";
18
18
 
19
19
  const PIECE = 4096;
20
20
 
@@ -239,7 +239,7 @@ test("destroying it takes the directory with it", async () => {
239
239
  });
240
240
 
241
241
  test("the spill ceiling is what the disk's owner said, divided between the stores", async () => {
242
- const { reviseSpillBudgets, SharedPieceStore } = await import("../services/piece-store/shared-piece-store.js");
242
+ const { reviseSpillBudgets, SharedPieceStore } = await import("../services/storage/piece-store/shared-piece-store.js");
243
243
  const directory = await fs.mkdtemp(path.join(os.tmpdir(), "spill-share-"));
244
244
  const stores = [
245
245
  new SharedPieceStore(PIECE, { length: PIECE * 8, memoryBytes: PIECE, path: directory, name: "one" }),
@@ -13,7 +13,7 @@ import assert from "node:assert/strict";
13
13
  import fs from "node:fs/promises";
14
14
  import os from "node:os";
15
15
  import path from "node:path";
16
- import { pieceFromWholeFiles, pieceIsInWholeFiles } from "../services/files/piece-from-whole-file.js";
16
+ import { pieceFromWholeFiles, pieceIsInWholeFiles } from "../services/storage/files/piece-from-whole-file.js";
17
17
 
18
18
  const PIECE = 16;
19
19
 
@@ -9,7 +9,7 @@
9
9
 
10
10
  import test from "node:test";
11
11
  import assert from "node:assert/strict";
12
- import { PieceLru } from "../services/piece-store/piece-lru.js";
12
+ import { PieceLru } from "../services/storage/piece-store/piece-lru.js";
13
13
 
14
14
  test("evicts the least recently used piece", () => {
15
15
  const lru = new PieceLru(3);
@@ -10,8 +10,8 @@
10
10
  import test from "node:test";
11
11
  import assert from "node:assert/strict";
12
12
  import { EventEmitter } from "node:events";
13
- import { readFragments } from "../services/torrent-worker/piece-reader.js";
14
- import { SharedPieceStore } from "../services/piece-store/shared-piece-store.js";
13
+ import { readFragments } from "../services/torrent/worker/piece-reader.js";
14
+ import { SharedPieceStore } from "../services/storage/piece-store/shared-piece-store.js";
15
15
  import os from "node:os";
16
16
  import path from "node:path";
17
17
  import fs from "node:fs/promises";
@@ -14,7 +14,7 @@ import assert from "node:assert/strict";
14
14
  import fs from "node:fs/promises";
15
15
  import os from "node:os";
16
16
  import path from "node:path";
17
- import { SharedPieceStore } from "../services/piece-store/shared-piece-store.js";
17
+ import { SharedPieceStore } from "../services/storage/piece-store/shared-piece-store.js";
18
18
 
19
19
  const PIECE = 1024;
20
20
 
@@ -24,7 +24,7 @@ import assert from "node:assert/strict";
24
24
  import fs from "node:fs/promises";
25
25
  import os from "node:os";
26
26
  import path from "node:path";
27
- import { SharedPieceStore } from "../services/piece-store/shared-piece-store.js";
27
+ import { SharedPieceStore } from "../services/storage/piece-store/shared-piece-store.js";
28
28
 
29
29
  const PIECE = 1024;
30
30
 
@@ -10,7 +10,7 @@
10
10
 
11
11
  import test from "node:test";
12
12
  import assert from "node:assert/strict";
13
- import { SharedPieceStore } from "../services/piece-store/shared-piece-store.js";
13
+ import { SharedPieceStore } from "../services/storage/piece-store/shared-piece-store.js";
14
14
 
15
15
  const CHUNK = 1024;
16
16
 
@@ -19,7 +19,7 @@ import assert from "node:assert/strict";
19
19
  import fs from "node:fs/promises";
20
20
  import os from "node:os";
21
21
  import path from "node:path";
22
- import { SharedPieceStore } from "../services/piece-store/shared-piece-store.js";
22
+ import { SharedPieceStore } from "../services/storage/piece-store/shared-piece-store.js";
23
23
 
24
24
  const PIECE = 1024;
25
25
 
@@ -11,7 +11,7 @@
11
11
 
12
12
  import test from "node:test";
13
13
  import assert from "node:assert/strict";
14
- import { describePieceTail } from "../services/torrent-worker/fastest-wires.js";
14
+ import { describePieceTail } from "../services/torrent/worker/fastest-wires.js";
15
15
 
16
16
  /** A torrent whose piece has some blocks in hand and some in flight. */
17
17
  function torrentWith({ buffer, wires }) {
@@ -14,7 +14,7 @@
14
14
 
15
15
  import test from "node:test";
16
16
  import assert from "node:assert/strict";
17
- import { createPlaybackPlanner } from "../services/playback-planner.js";
17
+ import { createPlaybackPlanner } from "../services/media/playback-planner.js";
18
18
 
19
19
  /**
20
20
  * A planner whose host timings can be changed between calls, over a source that
@@ -1,225 +1,225 @@
1
- /**
2
- * @file The placement must not move while the facts do not.
3
- *
4
- * This is the check the field failure of 2026-09-13 had no equivalent of. Two
5
- * browsers on one torrent: 77 encoder starts and 141 stops in six minutes
6
- * against ONE normal end, both viewers frozen — one at 170.8 s with
7
- * `bufferedAhead=0.1s`, the other at 1673.6 s with an empty buffer — while the
8
- * swarm delivered 3 MB/s from 129 peers. Nothing was produced because no run
9
- * lived long enough to close a piece.
10
- *
11
- * The plan itself was not at fault and was measured not to be: given a settled
12
- * map it returns the same arrangement however often it is asked. What moved was
13
- * its INPUT. A viewer's position had two writers — a seek wrote one field, a
14
- * segment request wrote another, and the reading preferred whichever was set —
15
- * so the priority map jumped backwards and forwards by one or two segments
16
- * several times a second:
17
- *
18
- * 19:58:00.283 p100:#9..#10 p100:#160..#162
19
- * 19:58:00.496 p100:#18..#20 p100:#161..#163
20
- * 19:58:00.574 p100:#16..#18 p100:#161..#163
21
- * 19:58:00.696 p100:#16..#18 p100:#160..#162
22
- * 19:58:01.231 p100:#18..#20 p100:#160..#162
23
- *
24
- * So the property to hold is about the whole chain and not about one function:
25
- * what a viewer states must produce a map that only moves the way film moves,
26
- * and a plan asked repeatedly against unchanged facts must answer identically.
27
- */
28
-
29
- import test from "node:test";
30
- import assert from "node:assert/strict";
31
- import { CoverageMap } from "../services/encode/CoverageMap.js";
32
- import { planEncoders } from "../services/encode/EncodePlan.js";
33
- import { contentionPenalty, penaltiesFrom } from "../services/encode/contention.js";
34
- import { mapForViewer, mergeMaps, runsOf } from "../services/priority/PriorityMap.js";
35
- import { Viewer } from "../services/viewer/Viewer.js";
36
-
37
- // Measured on the addon host 2026-09-03: 7.12x alone, 4.18x with a second.
38
- const PENALTIES = penaltiesFrom(7.12, [{ others: 1, speed: 4.18 }]);
39
- const penaltyFor = (others) => contentionPenalty(others, PENALTIES).penalty;
40
-
41
- const HOST = {
42
- contentionPenaltyFor: penaltyFor,
43
- speedX: 2,
44
- segmentSeconds: 8,
45
- killCostSec: 0.5,
46
- firstByteWaitSec: 1,
47
- refetchSecPerFilmSecond: 0.25
48
- };
49
-
50
- const DURATION = 2896;
51
- const ALLOWANCE = 30;
52
-
53
- /**
54
- * The map two viewers produce, exactly as `PriorityOrchestrator` builds it.
55
- *
56
- * @param {Viewer[]} viewers
57
- * @param {number} now
58
- * @returns {{ from: number, to: number, priority: number }[]}
59
- */
60
- function zonesFor(viewers, now) {
61
- const merged = mergeMaps(
62
- viewers.map((viewer) =>
63
- mapForViewer({
64
- atSeconds: viewer.positionSeconds(now) ?? 0,
65
- durationSeconds: DURATION,
66
- allowanceSeconds: ALLOWANCE,
67
- playing: viewer.wantsFilmNow()
68
- })
69
- )
70
- );
71
- return runsOf(merged).map((zone) => ({
72
- from: Math.floor(zone.from / HOST.segmentSeconds),
73
- to: Math.floor((zone.to - 1) / HOST.segmentSeconds),
74
- priority: zone.priority
75
- }));
76
- }
77
-
78
- test("a viewer's position only ever moves the way film moves", () => {
79
- const viewer = new Viewer("one", 1_000_000);
80
- // Stated the way a page states it: where they are, what they hold, and that
81
- // the picture is advancing. The cushion is what bounds the extrapolation, so
82
- // a viewer who has stated none cannot move at all.
83
- viewer.report(
84
- { bufferedAheadSec: 120, positionSeconds: 170.8, playing: true, waiting: false },
85
- 1_000_000
86
- );
87
-
88
- let previous = viewer.positionSeconds(1_000_000);
89
- for (let tick = 1; tick <= 200; tick += 1) {
90
- const now = 1_000_000 + tick * 50;
91
- const seconds = viewer.positionSeconds(now);
92
- assert.ok(seconds >= previous, `position went backwards at tick ${tick}: ${seconds} < ${previous}`);
93
- previous = seconds;
94
- }
95
- // Fifty ticks of 50 ms is ten seconds of wall clock, and a playing viewer
96
- // covers ten seconds of film in it.
97
- assert.ok(Math.abs(previous - (170.8 + 10)) < 0.001, `expected 180.8s, got ${previous}`);
98
- });
99
-
100
- test("a segment request does not move a viewer, and a stopped picture does not either", () => {
101
- const viewer = new Viewer("one", 1_000_000);
102
- viewer.report(
103
- { bufferedAheadSec: 120, positionSeconds: 170.8, playing: false, waiting: false },
104
- 1_000_000
105
- );
106
-
107
- // Whatever else happens, only a statement from the viewer moves them. There
108
- // is no method here a request could call: `seen` is presence and nothing more.
109
- viewer.seen(1_000_500);
110
- viewer.seen(1_001_000);
111
- assert.equal(viewer.positionSeconds(1_010_000), 170.8);
112
- });
113
-
114
- test("the priority map of two viewers is the same whenever it is asked", () => {
115
- const at = 1_000_000;
116
- const one = new Viewer("one", at);
117
- one.report({ bufferedAheadSec: 120, positionSeconds: 170.8, playing: false, waiting: false }, at);
118
- const two = new Viewer("two", at);
119
- two.report({ bufferedAheadSec: 120, positionSeconds: 1673.6, playing: false, waiting: false }, at);
120
-
121
- const first = JSON.stringify(zonesFor([one, two], at));
122
- for (let tick = 1; tick <= 40; tick += 1) {
123
- // Nothing changes: both pictures are stopped, so no time passes for them.
124
- assert.equal(JSON.stringify(zonesFor([one, two], at + tick * 100)), first, `map moved at tick ${tick}`);
125
- }
126
- });
127
-
128
- test("two viewers far apart settle on one arrangement and stay on it", () => {
129
- const at = 1_000_000;
130
- const one = new Viewer("one", at);
131
- one.report({ bufferedAheadSec: 120, positionSeconds: 170.8, playing: false, waiting: false }, at);
132
- const two = new Viewer("two", at);
133
- two.report({ bufferedAheadSec: 120, positionSeconds: 1673.6, playing: false, waiting: false }, at);
134
-
135
- const coverage = new CoverageMap({ segmentCount: 362 });
136
- /** @type {{ from: number, to: number, head: number, speedX: number, startedAt: number }[]} */
137
- let live = [];
138
- let started = 0;
139
- let stopped = 0;
140
-
141
- for (let tick = 0; tick < 60; tick += 1) {
142
- const now = at + tick * 100;
143
- const actions = planEncoders({
144
- coverage,
145
- windows: zonesFor([one, two], now),
146
- runs: live,
147
- maxRuns: 2,
148
- now,
149
- ...HOST
150
- });
151
- for (const action of actions) {
152
- if (action.type === "start") {
153
- live.push({ from: action.from, to: action.to, head: action.from, speedX: 2, startedAt: now });
154
- started += 1;
155
- } else if (action.type === "stop") {
156
- live = live.filter((run) => run !== action.run);
157
- stopped += 1;
158
- } else if (action.type === "move") {
159
- live = live.filter((run) => run !== action.run);
160
- live.push({ from: action.from, to: action.to, head: action.from, speedX: 2, startedAt: now });
161
- started += 1;
162
- stopped += 1;
163
- }
164
- }
165
- }
166
-
167
- // One encoder per viewer, placed once. Anything above this is the plan
168
- // arguing with itself: in the field the same six minutes cost 77 and 141.
169
- assert.equal(started, 2, `expected two starts, got ${started}`);
170
- assert.equal(stopped, 0, `expected no stops, got ${stopped}`);
171
- assert.equal(live.length, 2);
172
- });
173
-
174
- test("an encoder keeping ahead of a playing viewer is left alone", () => {
175
- const at = 1_000_000;
176
- const one = new Viewer("one", at);
177
- one.report({ bufferedAheadSec: 120, positionSeconds: 0, playing: true, waiting: false }, at);
178
-
179
- const coverage = new CoverageMap({ segmentCount: 362 });
180
- const ready = new Set();
181
- /** @type {{ from: number, to: number, head: number, speedX: number, startedAt: number, made: number }[]} */
182
- let live = [];
183
- let moves = 0;
184
- let starts = 0;
185
-
186
- for (let tick = 0; tick < 120; tick += 1) {
187
- const now = at + tick * 1000;
188
- const actions = planEncoders({
189
- coverage,
190
- windows: zonesFor([one], now),
191
- runs: live,
192
- maxRuns: 1,
193
- now,
194
- ...HOST
195
- });
196
- for (const action of actions) {
197
- if (action.type === "start") {
198
- live.push({ from: action.from, to: action.to, head: action.from, speedX: 2, startedAt: now, made: 0 });
199
- starts += 1;
200
- } else if (action.type === "move") {
201
- live = live.filter((run) => run !== action.run);
202
- live.push({ from: action.from, to: action.to, head: action.from, speedX: 2, startedAt: now, made: 0 });
203
- moves += 1;
204
- } else if (action.type === "stop") {
205
- live = live.filter((run) => run !== action.run);
206
- }
207
- }
208
- // The encoder works: at 2x, one 8-second piece every four seconds of clock.
209
- for (const run of live) {
210
- run.made += 1000 * 2;
211
- while (run.made >= HOST.segmentSeconds * 1000 && run.head <= run.to) {
212
- run.made -= HOST.segmentSeconds * 1000;
213
- ready.add(run.head);
214
- run.head += 1;
215
- }
216
- }
217
- coverage.setReady(ready);
218
- }
219
-
220
- // One encoder, placed once, running twice as fast as the viewer plays: it
221
- // stays in front of them for the whole two minutes, so there is nothing to
222
- // decide again.
223
- assert.equal(starts, 1, `expected one start, got ${starts}`);
224
- assert.equal(moves, 0, `expected no moves, got ${moves}`);
225
- });
1
+ /**
2
+ * @file The placement must not move while the facts do not.
3
+ *
4
+ * This is the check the field failure of 2026-09-13 had no equivalent of. Two
5
+ * browsers on one torrent: 77 encoder starts and 141 stops in six minutes
6
+ * against ONE normal end, both viewers frozen — one at 170.8 s with
7
+ * `bufferedAhead=0.1s`, the other at 1673.6 s with an empty buffer — while the
8
+ * swarm delivered 3 MB/s from 129 peers. Nothing was produced because no run
9
+ * lived long enough to close a piece.
10
+ *
11
+ * The plan itself was not at fault and was measured not to be: given a settled
12
+ * map it returns the same arrangement however often it is asked. What moved was
13
+ * its INPUT. A viewer's position had two writers — a seek wrote one field, a
14
+ * segment request wrote another, and the reading preferred whichever was set —
15
+ * so the priority map jumped backwards and forwards by one or two segments
16
+ * several times a second:
17
+ *
18
+ * 19:58:00.283 p100:#9..#10 p100:#160..#162
19
+ * 19:58:00.496 p100:#18..#20 p100:#161..#163
20
+ * 19:58:00.574 p100:#16..#18 p100:#161..#163
21
+ * 19:58:00.696 p100:#16..#18 p100:#160..#162
22
+ * 19:58:01.231 p100:#18..#20 p100:#160..#162
23
+ *
24
+ * So the property to hold is about the whole chain and not about one function:
25
+ * what a viewer states must produce a map that only moves the way film moves,
26
+ * and a plan asked repeatedly against unchanged facts must answer identically.
27
+ */
28
+
29
+ import test from "node:test";
30
+ import assert from "node:assert/strict";
31
+ import { CoverageMap } from "../services/encode/CoverageMap.js";
32
+ import { planEncoders } from "../services/encode/EncodePlan.js";
33
+ import { contentionPenalty, penaltiesFrom } from "../services/encode/contention.js";
34
+ import { mapForViewer, mergeMaps, runsOf } from "../services/viewer/PriorityMap.js";
35
+ import { Viewer } from "../services/viewer/Viewer.js";
36
+
37
+ // Measured on the addon host 2026-09-03: 7.12x alone, 4.18x with a second.
38
+ const PENALTIES = penaltiesFrom(7.12, [{ others: 1, speed: 4.18 }]);
39
+ const penaltyFor = (others) => contentionPenalty(others, PENALTIES).penalty;
40
+
41
+ const HOST = {
42
+ contentionPenaltyFor: penaltyFor,
43
+ speedX: 2,
44
+ segmentSeconds: 8,
45
+ killCostSec: 0.5,
46
+ firstByteWaitSec: 1,
47
+ refetchSecPerFilmSecond: 0.25
48
+ };
49
+
50
+ const DURATION = 2896;
51
+ const ALLOWANCE = 30;
52
+
53
+ /**
54
+ * The map two viewers produce, exactly as `PriorityOrchestrator` builds it.
55
+ *
56
+ * @param {Viewer[]} viewers
57
+ * @param {number} now
58
+ * @returns {{ from: number, to: number, priority: number }[]}
59
+ */
60
+ function zonesFor(viewers, now) {
61
+ const merged = mergeMaps(
62
+ viewers.map((viewer) =>
63
+ mapForViewer({
64
+ atSeconds: viewer.positionSeconds(now) ?? 0,
65
+ durationSeconds: DURATION,
66
+ allowanceSeconds: ALLOWANCE,
67
+ playing: viewer.wantsFilmNow()
68
+ })
69
+ )
70
+ );
71
+ return runsOf(merged).map((zone) => ({
72
+ from: Math.floor(zone.from / HOST.segmentSeconds),
73
+ to: Math.floor((zone.to - 1) / HOST.segmentSeconds),
74
+ priority: zone.priority
75
+ }));
76
+ }
77
+
78
+ test("a viewer's position only ever moves the way film moves", () => {
79
+ const viewer = new Viewer("one", 1_000_000);
80
+ // Stated the way a page states it: where they are, what they hold, and that
81
+ // the picture is advancing. The cushion is what bounds the extrapolation, so
82
+ // a viewer who has stated none cannot move at all.
83
+ viewer.report(
84
+ { bufferedAheadSec: 120, positionSeconds: 170.8, playing: true, waiting: false },
85
+ 1_000_000
86
+ );
87
+
88
+ let previous = viewer.positionSeconds(1_000_000);
89
+ for (let tick = 1; tick <= 200; tick += 1) {
90
+ const now = 1_000_000 + tick * 50;
91
+ const seconds = viewer.positionSeconds(now);
92
+ assert.ok(seconds >= previous, `position went backwards at tick ${tick}: ${seconds} < ${previous}`);
93
+ previous = seconds;
94
+ }
95
+ // Fifty ticks of 50 ms is ten seconds of wall clock, and a playing viewer
96
+ // covers ten seconds of film in it.
97
+ assert.ok(Math.abs(previous - (170.8 + 10)) < 0.001, `expected 180.8s, got ${previous}`);
98
+ });
99
+
100
+ test("a segment request does not move a viewer, and a stopped picture does not either", () => {
101
+ const viewer = new Viewer("one", 1_000_000);
102
+ viewer.report(
103
+ { bufferedAheadSec: 120, positionSeconds: 170.8, playing: false, waiting: false },
104
+ 1_000_000
105
+ );
106
+
107
+ // Whatever else happens, only a statement from the viewer moves them. There
108
+ // is no method here a request could call: `seen` is presence and nothing more.
109
+ viewer.seen(1_000_500);
110
+ viewer.seen(1_001_000);
111
+ assert.equal(viewer.positionSeconds(1_010_000), 170.8);
112
+ });
113
+
114
+ test("the priority map of two viewers is the same whenever it is asked", () => {
115
+ const at = 1_000_000;
116
+ const one = new Viewer("one", at);
117
+ one.report({ bufferedAheadSec: 120, positionSeconds: 170.8, playing: false, waiting: false }, at);
118
+ const two = new Viewer("two", at);
119
+ two.report({ bufferedAheadSec: 120, positionSeconds: 1673.6, playing: false, waiting: false }, at);
120
+
121
+ const first = JSON.stringify(zonesFor([one, two], at));
122
+ for (let tick = 1; tick <= 40; tick += 1) {
123
+ // Nothing changes: both pictures are stopped, so no time passes for them.
124
+ assert.equal(JSON.stringify(zonesFor([one, two], at + tick * 100)), first, `map moved at tick ${tick}`);
125
+ }
126
+ });
127
+
128
+ test("two viewers far apart settle on one arrangement and stay on it", () => {
129
+ const at = 1_000_000;
130
+ const one = new Viewer("one", at);
131
+ one.report({ bufferedAheadSec: 120, positionSeconds: 170.8, playing: false, waiting: false }, at);
132
+ const two = new Viewer("two", at);
133
+ two.report({ bufferedAheadSec: 120, positionSeconds: 1673.6, playing: false, waiting: false }, at);
134
+
135
+ const coverage = new CoverageMap({ segmentCount: 362 });
136
+ /** @type {{ from: number, to: number, head: number, speedX: number, startedAt: number }[]} */
137
+ let live = [];
138
+ let started = 0;
139
+ let stopped = 0;
140
+
141
+ for (let tick = 0; tick < 60; tick += 1) {
142
+ const now = at + tick * 100;
143
+ const actions = planEncoders({
144
+ coverage,
145
+ windows: zonesFor([one, two], now),
146
+ runs: live,
147
+ maxRuns: 2,
148
+ now,
149
+ ...HOST
150
+ });
151
+ for (const action of actions) {
152
+ if (action.type === "start") {
153
+ live.push({ from: action.from, to: action.to, head: action.from, speedX: 2, startedAt: now });
154
+ started += 1;
155
+ } else if (action.type === "stop") {
156
+ live = live.filter((run) => run !== action.run);
157
+ stopped += 1;
158
+ } else if (action.type === "move") {
159
+ live = live.filter((run) => run !== action.run);
160
+ live.push({ from: action.from, to: action.to, head: action.from, speedX: 2, startedAt: now });
161
+ started += 1;
162
+ stopped += 1;
163
+ }
164
+ }
165
+ }
166
+
167
+ // One encoder per viewer, placed once. Anything above this is the plan
168
+ // arguing with itself: in the field the same six minutes cost 77 and 141.
169
+ assert.equal(started, 2, `expected two starts, got ${started}`);
170
+ assert.equal(stopped, 0, `expected no stops, got ${stopped}`);
171
+ assert.equal(live.length, 2);
172
+ });
173
+
174
+ test("an encoder keeping ahead of a playing viewer is left alone", () => {
175
+ const at = 1_000_000;
176
+ const one = new Viewer("one", at);
177
+ one.report({ bufferedAheadSec: 120, positionSeconds: 0, playing: true, waiting: false }, at);
178
+
179
+ const coverage = new CoverageMap({ segmentCount: 362 });
180
+ const ready = new Set();
181
+ /** @type {{ from: number, to: number, head: number, speedX: number, startedAt: number, made: number }[]} */
182
+ let live = [];
183
+ let moves = 0;
184
+ let starts = 0;
185
+
186
+ for (let tick = 0; tick < 120; tick += 1) {
187
+ const now = at + tick * 1000;
188
+ const actions = planEncoders({
189
+ coverage,
190
+ windows: zonesFor([one], now),
191
+ runs: live,
192
+ maxRuns: 1,
193
+ now,
194
+ ...HOST
195
+ });
196
+ for (const action of actions) {
197
+ if (action.type === "start") {
198
+ live.push({ from: action.from, to: action.to, head: action.from, speedX: 2, startedAt: now, made: 0 });
199
+ starts += 1;
200
+ } else if (action.type === "move") {
201
+ live = live.filter((run) => run !== action.run);
202
+ live.push({ from: action.from, to: action.to, head: action.from, speedX: 2, startedAt: now, made: 0 });
203
+ moves += 1;
204
+ } else if (action.type === "stop") {
205
+ live = live.filter((run) => run !== action.run);
206
+ }
207
+ }
208
+ // The encoder works: at 2x, one 8-second piece every four seconds of clock.
209
+ for (const run of live) {
210
+ run.made += 1000 * 2;
211
+ while (run.made >= HOST.segmentSeconds * 1000 && run.head <= run.to) {
212
+ run.made -= HOST.segmentSeconds * 1000;
213
+ ready.add(run.head);
214
+ run.head += 1;
215
+ }
216
+ }
217
+ coverage.setReady(ready);
218
+ }
219
+
220
+ // One encoder, placed once, running twice as fast as the viewer plays: it
221
+ // stays in front of them for the whole two minutes, so there is nothing to
222
+ // decide again.
223
+ assert.equal(starts, 1, `expected one start, got ${starts}`);
224
+ assert.equal(moves, 0, `expected no moves, got ${moves}`);
225
+ });
@@ -12,10 +12,10 @@
12
12
 
13
13
  import test from "node:test";
14
14
  import assert from "node:assert/strict";
15
- import { TorrentPool } from "../services/torrent-pool.js";
16
- import { demandFor, forgetTorrent } from "../services/download/registry.js";
17
- import { Urgency } from "../services/demand/index.js";
18
- import { mapForViewer, runsOf } from "../services/priority/PriorityMap.js";
15
+ import { TorrentPool } from "../services/torrent/torrent-pool.js";
16
+ import { demandFor, forgetTorrent } from "../services/torrent/download/registry.js";
17
+ import { Urgency } from "../services/torrent/demand/index.js";
18
+ import { mapForViewer, runsOf } from "../services/viewer/PriorityMap.js";
19
19
 
20
20
  /** A torrent that is nothing but one file of a known length. */
21
21
  function torrentOf({ length = 1_000_000, offset = 0 } = {}) {