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