@torrent-tv/proxy 2.86.0 → 2.87.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (385) hide show
  1. package/CHANGELOG.md +2142 -1915
  2. package/CLAUDE.md +322 -197
  3. package/assets/calibration/NOTICE.md +2 -2
  4. package/bin/cli.js +684 -616
  5. package/biome.json +409 -233
  6. package/docs/browser-proxy-contract.md +94 -0
  7. package/docs/container-architecture.md +218 -213
  8. package/docs/download-architecture.md +7 -7
  9. package/docs/encode-architecture.md +287 -11
  10. package/docs/encode-run-state.md +2 -2
  11. package/docs/logs.md +97 -97
  12. package/docs/{disk-architecture.md → storage-architecture.md} +107 -1
  13. package/openspec/changes/adaptive-bitrate/design.md +2 -2
  14. package/openspec/changes/adaptive-bitrate/proposal.md +1 -1
  15. package/openspec/changes/adaptive-bitrate/tasks.md +1 -1
  16. package/openspec/changes/chunked-request-bodies/design.md +1 -1
  17. package/openspec/changes/chunked-request-bodies/proposal.md +1 -1
  18. package/openspec/changes/chunked-request-bodies/tasks.md +1 -1
  19. package/openspec/changes/cold-start/design.md +1 -1
  20. package/openspec/changes/disk-cap/proposal.md +1 -1
  21. package/openspec/changes/proxy-observability/proposal.md +2 -2
  22. package/openspec/changes/track-selection/proposal.md +1 -1
  23. package/openspec/changes/transcode-quality/proposal.md +1 -1
  24. package/package.json +2 -2
  25. package/research/delivery-wedge-stand-ladder-2026-09-13.md +329 -329
  26. package/research/double-spawn-2026-09-10.md +171 -171
  27. package/routes/api/playback-plan/post.js +2 -2
  28. package/routes/api/sources/files/get.js +1 -1
  29. package/routes/api/sources/stats/get.js +1 -1
  30. package/routes/api/sources/warm/post.js +10 -3
  31. package/routes/api/subtitles/get.js +230 -230
  32. package/routes/api/transcode-sessions/fragment-far/post.js +3 -3
  33. package/routes/api/transcode-sessions/net-report/post.js +129 -94
  34. package/routes/api/transcode-sessions/post.js +160 -139
  35. package/routes/api/transcode-sessions/progress/get.js +3 -3
  36. package/routes/api/transcode-sessions/release/post.js +3 -3
  37. package/routes/api/transcode-sessions/seek/post.js +12 -3
  38. package/routes/stream/get.js +2 -2
  39. package/routes/transcode/audio-file/get.js +15 -6
  40. package/routes/transcode/audio-warm/get.js +9 -6
  41. package/routes/transcode/session-file/get.js +52 -268
  42. package/routes/transcode/variant-file/get.js +46 -7
  43. package/routes/transcode/variant-warm/get.js +19 -6
  44. package/scripts/render-run-graph.js +1 -1
  45. package/server.js +720 -465
  46. package/services/encode/CoverageMap.js +428 -428
  47. package/services/encode/CushionReport.js +345 -0
  48. package/services/encode/EncodeAdmission.js +332 -0
  49. package/services/{orchestrators → encode}/EncodeOrchestrator.js +307 -29
  50. package/services/encode/EncodeRun.js +16 -9
  51. package/services/encode/EncodeRuns.js +1229 -0
  52. package/services/encode/Encoder.js +18 -2
  53. package/services/encode/EncoderSelection.js +38 -0
  54. package/services/encode/LocalObservations.js +359 -0
  55. package/services/encode/NvencEncoder.js +5 -0
  56. package/services/encode/OutputOpening.js +755 -0
  57. package/services/encode/OutputTimes.js +579 -0
  58. package/services/encode/Renditions.js +2162 -0
  59. package/services/encode/RunProgress.js +84 -0
  60. package/services/encode/SoftwareEncoder.js +12 -7
  61. package/services/encode/args.js +402 -186
  62. package/services/encode/calibration.js +361 -0
  63. package/services/encode/contention.js +128 -128
  64. package/services/encode/encode-run-state.js +16 -20
  65. package/services/encode/fingerprint.js +322 -0
  66. package/services/{hwaccel.js → encode/hwaccel.js} +82 -42
  67. package/services/{learned-median.js → encode/learned-median.js} +11 -0
  68. package/services/encode/output/EncodedOutput.js +57 -0
  69. package/services/encode/output/Output.js +131 -0
  70. package/services/{output/LiveOutputs.js → encode/output/OutputCatalog.js} +141 -40
  71. package/services/encode/output/OutputSpec.js +390 -0
  72. package/services/{output → encode/output}/Timeline.js +12 -37
  73. package/services/encode/output/index.js +20 -0
  74. package/services/encode/output/ladder.js +32 -0
  75. package/services/{output → encode/output}/playlists.js +3 -0
  76. package/services/encode/output-key-format.js +21 -0
  77. package/services/encode/quality/EncodeCost.js +1083 -0
  78. package/services/encode/quality/HostLoad.js +525 -0
  79. package/services/encode/quality/HostTimings.js +249 -0
  80. package/services/encode/quality/OutputQualityState.js +28 -0
  81. package/services/encode/quality/QualityController.js +935 -0
  82. package/services/encode/quality/QualityOffer.js +416 -0
  83. package/services/encode/quality/drain-threat.js +47 -0
  84. package/services/encode/quality/link-budget.js +254 -0
  85. package/services/encode/quality/output-format.js +266 -0
  86. package/services/encode/quality/serving-output.js +216 -0
  87. package/services/encode/quality/visible-rung.js +57 -0
  88. package/services/encode/run-command.js +23 -20
  89. package/services/encode/run-inputs.js +42 -0
  90. package/services/{segment-formats → encode/segment-formats}/fmp4.js +63 -0
  91. package/services/{segment-formats → encode/segment-formats}/index.js +3 -3
  92. package/services/encode/segment-formats/init-compat.js +324 -0
  93. package/services/{segment-formats → encode/segment-formats}/mp4-boxes.js +8 -3
  94. package/services/encode/throughput.js +97 -0
  95. package/services/{orchestrators → media}/ContainerOrchestrator.js +45 -7
  96. package/services/media/KeyframeTables.js +316 -0
  97. package/services/{source → media}/SourceFile.js +7 -55
  98. package/services/{torrent-worker/subtitle-cues.js → media/SubtitleCues.js} +103 -132
  99. package/services/media/SubtitleOrchestrator.js +167 -0
  100. package/services/{audio-inventory.js → media/audio-inventory.js} +7 -1
  101. package/services/{container → media/container}/AviContainer.js +266 -266
  102. package/services/{container → media/container}/Container.js +596 -601
  103. package/services/media/container/ContainerFactory.js +56 -0
  104. package/services/media/container/KeyframeTable.js +272 -0
  105. package/services/{container → media/container}/MatroskaContainer.js +1485 -1485
  106. package/services/{container → media/container}/Mp4Container.js +1244 -1244
  107. package/services/{container → media/container}/SubtitleFileContainer.js +322 -322
  108. package/services/media/keyframe-probe.js +157 -0
  109. package/services/media/media-info-probe.js +93 -0
  110. package/services/{playback-planner.js → media/playback-planner.js} +82 -39
  111. package/services/{tracks → media/tracks}/AudioTrack.js +131 -131
  112. package/services/{tracks → media/tracks}/language-detect.js +174 -174
  113. package/services/server/OutputLifecycle.js +418 -0
  114. package/services/server/SegmentServing.js +1146 -0
  115. package/services/server/ViewerRequests.js +522 -0
  116. package/services/server/controllers/PlaybackController.js +36 -0
  117. package/services/{controllers → server/controllers}/SubtitleController.js +17 -33
  118. package/services/server/http-responses.js +60 -0
  119. package/services/server/transcode-session-files.js +325 -0
  120. package/services/server/wire-outputs.js +983 -0
  121. package/services/storage/Diagnostics.js +202 -0
  122. package/services/storage/MachineBudget.js +235 -0
  123. package/services/{piece-store → storage}/allowance.js +107 -107
  124. package/services/{core-dumps.js → storage/core-dumps.js} +1 -1
  125. package/services/{files → storage/files}/CompletedFiles.js +116 -1
  126. package/services/{disk → storage}/free.js +33 -0
  127. package/services/storage/machine-memory.js +56 -0
  128. package/services/{memory-report.js → storage/memory-report.js} +575 -596
  129. package/services/{piece-store → storage/piece-store}/piece-disk-store.js +0 -7
  130. package/services/{piece-store → storage/piece-store}/shared-piece-store.js +28 -21
  131. package/services/{encode → storage/segment-store}/SegmentStore.js +395 -8
  132. package/services/storage/wire.js +175 -0
  133. package/services/{download → torrent/download}/SwarmSelection.js +2 -2
  134. package/services/{download → torrent/download}/registry.js +2 -2
  135. package/services/torrent/files.js +1 -1
  136. package/services/torrent/piece-store-of.js +29 -0
  137. package/services/{torrent-pool.js → torrent/torrent-pool.js} +26 -119
  138. package/services/{torrent-worker → torrent/worker}/background-fill.js +2 -2
  139. package/services/{torrent-worker → torrent/worker}/channel.js +271 -250
  140. package/services/{torrent-worker → torrent/worker}/client.js +77 -58
  141. package/services/torrent/worker/held-bytes.js +155 -0
  142. package/services/{torrent-worker → torrent/worker}/install-webrtc-shim.js +1 -1
  143. package/services/{torrent-worker → torrent/worker}/piece-reader.js +21 -30
  144. package/services/{torrent-worker → torrent/worker}/pool-adapter.js +101 -137
  145. package/services/{torrent-worker → torrent/worker}/protocol.js +26 -30
  146. package/services/torrent/worker/resume-warm.js +107 -0
  147. package/services/{torrent-worker → torrent/worker}/webrtc-shim.js +2 -2
  148. package/services/{torrent-worker → torrent/worker}/worker.js +68 -159
  149. package/services/{data-channel-handler.js → transport/data-channel-handler.js} +1356 -1356
  150. package/services/{delivery-probe.js → transport/delivery-probe.js} +842 -842
  151. package/services/{health-collector.js → transport/health-collector.js} +6 -35
  152. package/services/{packet-witness.js → transport/packet-witness.js} +808 -784
  153. package/services/{port-mapper.js → transport/port-mapper.js} +1 -1
  154. package/services/{usrsctp-state.js → transport/usrsctp-state.js} +1 -1
  155. package/services/{webrtc-manager.js → transport/webrtc-manager.js} +1 -1
  156. package/services/viewer/Assignments.js +340 -0
  157. package/services/{priority → viewer}/PriorityMap.js +390 -390
  158. package/services/{priority → viewer}/PriorityOrchestrator.js +325 -320
  159. package/services/viewer/Viewer.js +657 -483
  160. package/services/viewer/Viewers.js +368 -257
  161. package/services/viewer/active-output.js +37 -54
  162. package/services/viewer/audio-start.js +4 -3
  163. package/services/viewer/buffer-trend.js +81 -0
  164. package/services/viewer/choices.js +647 -0
  165. package/services/viewer/positions.js +126 -120
  166. package/services/viewer/report-intake.js +46 -45
  167. package/test/asset-paths.test.js +28 -0
  168. package/test/audio-inventory.test.js +3 -3
  169. package/test/audio-track-bitrate.test.js +40 -0
  170. package/test/auto-quality-step.test.js +707 -515
  171. package/test/available-share.test.js +1 -1
  172. package/test/background-fill.test.js +1 -1
  173. package/test/client-log-file.test.js +110 -110
  174. package/test/completed-files.test.js +1 -1
  175. package/test/concurrent-cost.test.js +13 -3
  176. package/test/container-media-info.test.js +3 -3
  177. package/test/core-dumps.test.js +1 -1
  178. package/test/coverage-follows-the-disk.test.js +46 -9
  179. package/test/cue-push-carries-what-the-walk-found.test.js +58 -0
  180. package/test/cut-times-timeline.test.js +2 -2
  181. package/test/cuts-follow-published-grid.test.js +9 -8
  182. package/test/data-channel-frame.test.js +1 -1
  183. package/test/dead-torrent-handle.test.js +1 -1
  184. package/test/declared-rates.test.js +2 -2
  185. package/test/declared-tracks.test.js +2 -2
  186. package/test/decode-cost-fit.test.js +1 -1
  187. package/test/decode-cost.test.js +34 -25
  188. package/test/delivery-probe.test.js +1 -1
  189. package/test/demand-register.test.js +4 -4
  190. package/test/dht-bootstrap.test.js +1 -1
  191. package/test/drain-threat.test.js +65 -0
  192. package/test/duplicate-add.test.js +1 -1
  193. package/test/encode-admission.test.js +146 -0
  194. package/test/encode-cost.test.js +199 -10
  195. package/test/encode-orchestrator.test.js +39 -1
  196. package/test/encode-plan-viewers.test.js +2 -2
  197. package/test/encode-run.test.js +2 -2
  198. package/test/encode-slope.test.js +1 -1
  199. package/test/encoded-output.test.js +39 -0
  200. package/test/encoder-readings.test.js +1 -1
  201. package/test/every-claimant-is-told-its-share.test.js +152 -0
  202. package/test/failed-encoder-still-serves-what-exists.test.js +354 -0
  203. package/test/failed-start-breaker.test.js +81 -30
  204. package/test/fastest-wires.test.js +1 -1
  205. package/test/ffmpeg-stream-counts.test.js +1 -1
  206. package/test/file-edges.test.js +3 -3
  207. package/test/fmp4-self-contained.test.js +1 -1
  208. package/test/fmp4-timestamps.test.js +1 -1
  209. package/test/fmp4-track-completeness.test.js +1 -1
  210. package/test/format-keyed-outputs.test.js +78 -0
  211. package/test/health-metrics.test.js +3 -2
  212. package/test/held-request-width.test.js +22 -23
  213. package/test/helpers/encode-run.js +136 -136
  214. package/test/helpers/held-file.js +29 -0
  215. package/test/helpers/manager.js +57 -0
  216. package/test/helpers/output-spec.js +63 -0
  217. package/test/host-load.test.js +1 -1
  218. package/test/index-accuracy-is-about-the-file.test.js +128 -0
  219. package/test/init-compat.test.js +219 -0
  220. package/test/input-lost-quiets-the-plan.test.js +1 -1
  221. package/test/input-unavailable.test.js +1 -1
  222. package/test/keeping-period.test.js +4 -4
  223. package/test/keyframe-index-accuracy.test.js +97 -45
  224. package/test/keyframe-table-budget.test.js +28 -33
  225. package/test/keyframes-belong-to-the-file.test.js +174 -57
  226. package/test/learned-median.test.js +1 -1
  227. package/test/letting-go-asks-who-is-watching.test.js +191 -0
  228. package/test/limit-row-by-area.test.js +60 -0
  229. package/test/link-budget.test.js +111 -0
  230. package/test/link-probe.test.js +56 -56
  231. package/test/local-encoding-data.test.js +273 -0
  232. package/test/look-ahead-coverage.test.js +1 -1
  233. package/test/manager-surface.test.js +294 -0
  234. package/test/matroska-blocks.test.js +0 -0
  235. package/test/matroska-cues-track.test.js +1 -1
  236. package/test/memory-budget.test.js +2 -2
  237. package/test/mp4-composition-times.test.js +0 -0
  238. package/test/mp4-subtitles.test.js +1 -1
  239. package/test/one-authority.test.js +45 -41
  240. package/test/one-budget.test.js +149 -0
  241. package/test/one-output-one-session.test.js +204 -0
  242. package/test/{disk-space.test.js → one-resource-divided.test.js} +30 -10
  243. package/test/one-serving-output-per-height.test.js +458 -0
  244. package/test/orchestrator-wired.test.js +46 -45
  245. package/test/output-catalog.test.js +39 -0
  246. package/test/output-shape.test.js +4 -51
  247. package/test/output-spec.test.js +251 -157
  248. package/test/output-speed.test.js +17 -15
  249. package/test/outputs-being-prepared.test.js +40 -0
  250. package/test/packet-witness-ring.test.js +2 -2
  251. package/test/packet-witness.test.js +1 -1
  252. package/test/piece-disk-store.test.js +2 -2
  253. package/test/piece-from-whole-file.test.js +1 -1
  254. package/test/piece-lru.test.js +1 -1
  255. package/test/piece-reader.test.js +2 -2
  256. package/test/piece-store-eviction.test.js +1 -1
  257. package/test/piece-store-never-refuses.test.js +1 -1
  258. package/test/piece-store-reservations.test.js +1 -1
  259. package/test/piece-store-slow-disk.test.js +1 -1
  260. package/test/piece-tail.test.js +1 -1
  261. package/test/plan-host-timings.test.js +1 -1
  262. package/test/plan-is-steady.test.js +225 -225
  263. package/test/priority-map-download.test.js +4 -4
  264. package/test/priority-map-emptied.test.js +204 -205
  265. package/test/priority-map-per-output.test.js +215 -209
  266. package/test/priority-map.test.js +1 -1
  267. package/test/probe-wedge-certainty.test.js +1 -1
  268. package/test/produced-copy-choice.test.js +15 -60
  269. package/test/quality-offer.test.js +162 -0
  270. package/test/quality-variants.test.js +1229 -1167
  271. package/test/rate-control-in-the-output.test.js +180 -0
  272. package/test/read-survives-withdrawal.test.js +2 -2
  273. package/test/read-window.test.js +10 -3
  274. package/test/resume-warm.test.js +1 -1
  275. package/test/run-inputs.test.js +80 -0
  276. package/test/run-position-follows-published-grid.test.js +13 -11
  277. package/test/run-progress.test.js +65 -0
  278. package/test/same-height-switch.test.js +664 -0
  279. package/test/seek-frees-the-viewers-requests.test.js +217 -0
  280. package/test/seek-landing.test.js +13 -13
  281. package/test/seek-target-not-superseded.test.js +28 -29
  282. package/test/segment-closed-on-both-branches.test.js +96 -0
  283. package/test/segment-cut-times.test.js +1 -1
  284. package/test/segment-hold-supersede.test.js +28 -35
  285. package/test/segment-judged-by-its-own-header.test.js +221 -0
  286. package/test/segment-serve-wiring.test.js +130 -39
  287. package/test/segment-store-eviction.test.js +22 -7
  288. package/test/segment-store.test.js +98 -14
  289. package/test/segment-true-start.test.js +1 -1
  290. package/test/segments-are-shared.test.js +17 -16
  291. package/test/send-chunk-bytes.test.js +1 -1
  292. package/test/serving-existing-output.test.js +102 -0
  293. package/test/serving-output.test.js +102 -0
  294. package/test/shared-piece-store.test.js +1 -1
  295. package/test/source-file.test.js +1 -1
  296. package/test/stale-request-after-seek.test.js +17 -21
  297. package/test/startup-readings.test.js +10 -5
  298. package/test/subtitle-cue-framing.test.js +5 -5
  299. package/test/subtitle-cue-source.test.js +36 -38
  300. package/test/subtitle-cue-walk.test.js +11 -10
  301. package/test/subtitle-defaults.test.js +1 -1
  302. package/test/subtitle-language.test.js +4 -4
  303. package/test/subtitle-track-numbering.test.js +5 -4
  304. package/test/supply-margin.test.js +1 -1
  305. package/test/swarm-follows-readers.test.js +3 -3
  306. package/test/swarm-reach.test.js +1 -1
  307. package/test/swarm-selection.test.js +3 -3
  308. package/test/tail-duplication.test.js +1 -1
  309. package/test/the-channel-has-both-ends.test.js +91 -0
  310. package/test/the-torrent-thread-serves-bytes.test.js +107 -0
  311. package/test/thread-pool.test.js +3 -3
  312. package/test/timeline.test.js +1 -12
  313. package/test/torrent-cost.test.js +1 -1
  314. package/test/tracks-begin-together.test.js +38 -24
  315. package/test/tunnel-renewal.test.js +1 -1
  316. package/test/two-viewers-one-picture.test.js +120 -87
  317. package/test/upload-hurry.test.js +3 -3
  318. package/test/usrsctp-state.test.js +1 -1
  319. package/test/video-facts.test.js +1 -1
  320. package/test/viewer-assignments.test.js +143 -0
  321. package/test/viewer-outputs.test.js +60 -52
  322. package/test/viewer-presence.test.js +22 -25
  323. package/test/viewer-requests-admission.test.js +89 -0
  324. package/test/viewer-states.test.js +189 -202
  325. package/test/viewer-subtitle-subscription.test.js +1 -1
  326. package/test/viewer.test.js +139 -136
  327. package/test/viewing-generations.test.js +390 -0
  328. package/test/visible-rung.test.js +37 -0
  329. package/test/wait-ledger.test.js +1 -1
  330. package/test/webrtc-shim.test.js +3 -3
  331. package/test/wedge-certainty.test.js +2 -2
  332. package/test/withdraw-piece-claim.test.js +2 -2
  333. package/test/worker-channel.test.js +1 -31
  334. package/utils/client-log-file.js +151 -151
  335. package/scripts/read-container-index.mjs +0 -108
  336. package/services/container/ContainerFactory.js +0 -122
  337. package/services/controllers/PlaybackController.js +0 -33
  338. package/services/disk/DiskSpace.js +0 -150
  339. package/services/disk/wire.js +0 -61
  340. package/services/hls-session-manager.js +0 -9608
  341. package/services/orchestrators/SubtitleOrchestrator.js +0 -160
  342. package/services/output/Output.js +0 -94
  343. package/services/output/OutputSpec.js +0 -202
  344. package/services/output/index.js +0 -1
  345. package/services/output/ladder.js +0 -26
  346. package/services/produced-index.js +0 -222
  347. package/services/quality/EncodeCost.js +0 -555
  348. package/services/torrent-worker/container-tracks.js +0 -414
  349. package/services/viewer/link-readings.js +0 -56
  350. package/test/produced-index.test.js +0 -142
  351. /package/{services → bin}/thread-pool.js +0 -0
  352. /package/services/{available-share.js → encode/available-share.js} +0 -0
  353. /package/services/{decode-cost-fit.js → encode/decode-cost-fit.js} +0 -0
  354. /package/services/{encoder-readings.js → encode/encoder-readings.js} +0 -0
  355. /package/services/{host-load.js → encode/host-load.js} +0 -0
  356. /package/services/{output → encode/output}/cut-grid.js +0 -0
  357. /package/services/{output → encode/output}/rates.js +0 -0
  358. /package/services/{segment-formats → encode/segment-formats}/mpegts.js +0 -0
  359. /package/services/{torrent-cost.js → encode/torrent-cost.js} +0 -0
  360. /package/services/{container → media/container}/ebml-reader.js +0 -0
  361. /package/services/{ffmpeg-banner.js → media/ffmpeg-banner.js} +0 -0
  362. /package/services/{tracks → media/tracks}/ContainerTrack.js +0 -0
  363. /package/services/{tracks → media/tracks}/ImageSubtitleTrack.js +0 -0
  364. /package/services/{tracks → media/tracks}/SubtitleTrack.js +0 -0
  365. /package/services/{tracks → media/tracks}/TextSubtitleTrack.js +0 -0
  366. /package/services/{tracks → media/tracks}/VideoTrack.js +0 -0
  367. /package/services/{tracks → media/tracks}/index.js +0 -0
  368. /package/services/{files → storage/files}/piece-from-whole-file.js +0 -0
  369. /package/services/{disk → storage}/keep.js +0 -0
  370. /package/services/{piece-store → storage/piece-store}/piece-lru.js +0 -0
  371. /package/services/{disk → storage}/returns.js +0 -0
  372. /package/services/{demand → torrent/demand}/DemandRegister.js +0 -0
  373. /package/services/{demand → torrent/demand}/Urgency.js +0 -0
  374. /package/services/{demand → torrent/demand}/Window.js +0 -0
  375. /package/services/{demand → torrent/demand}/index.js +0 -0
  376. /package/services/{demand → torrent/demand}/pieces.js +0 -0
  377. /package/services/{download → torrent/download}/withdraw-claim.js +0 -0
  378. /package/services/{supply-margin.js → torrent/supply-margin.js} +0 -0
  379. /package/services/{torrent-source-key.js → torrent/torrent-source-key.js} +0 -0
  380. /package/services/{torrent-worker → torrent/worker}/fastest-wires.js +0 -0
  381. /package/services/{torrent-worker → torrent/worker}/handle-state.js +0 -0
  382. /package/services/{nat-classifier.js → transport/nat-classifier.js} +0 -0
  383. /package/services/{registry-api.js → transport/registry-api.js} +0 -0
  384. /package/services/{tunnel-client.js → transport/tunnel-client.js} +0 -0
  385. /package/services/{priority → viewer}/WaitLedger.js +0 -0
@@ -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 } = {}) {