@torrent-tv/proxy 2.87.7 → 2.87.8
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 +4 -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/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 -29
- 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/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/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/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/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/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/resume-warm.js +107 -107
- package/services/torrent/worker/webrtc-shim.js +219 -219
- package/services/transport/data-channel-handler.js +21 -8
- 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-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/data-channel-viewer-lifecycle.test.js +92 -0
- 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/utils/torrent-source-key.js +38 -38
|
@@ -1,37 +1,37 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @file The rung the picture a viewer sees asks for: the smallest height of the
|
|
3
|
-
* ladder whose frame is not smaller than it (roadmap item 98).
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
import test from "node:test";
|
|
7
|
-
import assert from "node:assert/strict";
|
|
8
|
-
import { rungForVisiblePicture, visibleHeightCap } from "../services/encode/quality/visible-rung.js";
|
|
9
|
-
import { buildResolutionLadder } from "../services/encode/hwaccel.js";
|
|
10
|
-
|
|
11
|
-
const LADDER = buildResolutionLadder(1920, 1080);
|
|
12
|
-
|
|
13
|
-
test("the smallest rung whose frame is not smaller than the picture seen", () => {
|
|
14
|
-
assert.deepEqual(rungForVisiblePicture(LADDER, { width: 1200, height: 675 }), { width: 1280, height: 720 });
|
|
15
|
-
assert.deepEqual(rungForVisiblePicture(LADDER, { width: 1280, height: 720 }), { width: 1280, height: 720 });
|
|
16
|
-
assert.deepEqual(rungForVisiblePicture(LADDER, { width: 1281, height: 720 }), { width: 1920, height: 1080 });
|
|
17
|
-
});
|
|
18
|
-
|
|
19
|
-
test("a picture seen larger than the source is served at the source's size, never above", () => {
|
|
20
|
-
assert.deepEqual(rungForVisiblePicture(LADDER, { width: 3840, height: 2160 }), { width: 1920, height: 1080 });
|
|
21
|
-
});
|
|
22
|
-
|
|
23
|
-
test("both sides count: a wide picture asks for the rung wide enough", () => {
|
|
24
|
-
// Stretched (object-fit: fill) to 1000 wide and 300 tall.
|
|
25
|
-
assert.equal(rungForVisiblePicture(LADDER, { width: 1000, height: 300 }).height, 720);
|
|
26
|
-
});
|
|
27
|
-
|
|
28
|
-
test("nothing measured bounds nothing", () => {
|
|
29
|
-
assert.equal(rungForVisiblePicture(LADDER, null), null);
|
|
30
|
-
assert.equal(visibleHeightCap(1920, 1080, null), null);
|
|
31
|
-
assert.equal(visibleHeightCap(0, 0, { width: 640, height: 360 }), null);
|
|
32
|
-
});
|
|
33
|
-
|
|
34
|
-
test("the bound is a height of the source's own ladder", () => {
|
|
35
|
-
assert.equal(visibleHeightCap(1920, 1080, { width: 640, height: 360 }), 360);
|
|
36
|
-
assert.equal(visibleHeightCap(1920, 800, { width: 900, height: 375 }), 480);
|
|
37
|
-
});
|
|
1
|
+
/**
|
|
2
|
+
* @file The rung the picture a viewer sees asks for: the smallest height of the
|
|
3
|
+
* ladder whose frame is not smaller than it (roadmap item 98).
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import test from "node:test";
|
|
7
|
+
import assert from "node:assert/strict";
|
|
8
|
+
import { rungForVisiblePicture, visibleHeightCap } from "../services/encode/quality/visible-rung.js";
|
|
9
|
+
import { buildResolutionLadder } from "../services/encode/hwaccel.js";
|
|
10
|
+
|
|
11
|
+
const LADDER = buildResolutionLadder(1920, 1080);
|
|
12
|
+
|
|
13
|
+
test("the smallest rung whose frame is not smaller than the picture seen", () => {
|
|
14
|
+
assert.deepEqual(rungForVisiblePicture(LADDER, { width: 1200, height: 675 }), { width: 1280, height: 720 });
|
|
15
|
+
assert.deepEqual(rungForVisiblePicture(LADDER, { width: 1280, height: 720 }), { width: 1280, height: 720 });
|
|
16
|
+
assert.deepEqual(rungForVisiblePicture(LADDER, { width: 1281, height: 720 }), { width: 1920, height: 1080 });
|
|
17
|
+
});
|
|
18
|
+
|
|
19
|
+
test("a picture seen larger than the source is served at the source's size, never above", () => {
|
|
20
|
+
assert.deepEqual(rungForVisiblePicture(LADDER, { width: 3840, height: 2160 }), { width: 1920, height: 1080 });
|
|
21
|
+
});
|
|
22
|
+
|
|
23
|
+
test("both sides count: a wide picture asks for the rung wide enough", () => {
|
|
24
|
+
// Stretched (object-fit: fill) to 1000 wide and 300 tall.
|
|
25
|
+
assert.equal(rungForVisiblePicture(LADDER, { width: 1000, height: 300 }).height, 720);
|
|
26
|
+
});
|
|
27
|
+
|
|
28
|
+
test("nothing measured bounds nothing", () => {
|
|
29
|
+
assert.equal(rungForVisiblePicture(LADDER, null), null);
|
|
30
|
+
assert.equal(visibleHeightCap(1920, 1080, null), null);
|
|
31
|
+
assert.equal(visibleHeightCap(0, 0, { width: 640, height: 360 }), null);
|
|
32
|
+
});
|
|
33
|
+
|
|
34
|
+
test("the bound is a height of the source's own ladder", () => {
|
|
35
|
+
assert.equal(visibleHeightCap(1920, 1080, { width: 640, height: 360 }), 360);
|
|
36
|
+
assert.equal(visibleHeightCap(1920, 800, { width: 900, height: 375 }), 480);
|
|
37
|
+
});
|
package/test/wait-ledger.test.js
CHANGED
|
@@ -1,100 +1,100 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @file Whether the priority map is being served in its own order.
|
|
3
|
-
*
|
|
4
|
-
* The map says what matters most. Until 2026-09-08 nothing said whether what
|
|
5
|
-
* mattered most was delivered first, for either of the two things that read it
|
|
6
|
-
* — so a map read backwards would have looked identical in every log line the
|
|
7
|
-
* proxy writes.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
import test from "node:test";
|
|
11
|
-
import assert from "node:assert/strict";
|
|
12
|
-
import { bandOf, WaitLedger } from "../services/server/WaitLedger.js";
|
|
13
|
-
import { SegmentDemand } from "../services/encode/SegmentDemand.js";
|
|
14
|
-
|
|
15
|
-
test("the top rank is its own band, and the rest fall behind it", () => {
|
|
16
|
-
// The map's ranks are as many as the film needs, and a table with a hundred
|
|
17
|
-
// rows says nothing a reader can hold. What is being asked is coarse.
|
|
18
|
-
assert.equal(bandOf(100, 100), "now", "where the viewer is standing");
|
|
19
|
-
assert.equal(bandOf(95, 100), "soon", "what they reach while watching what they hold");
|
|
20
|
-
assert.equal(bandOf(50, 100), "later", "the rest of the film");
|
|
21
|
-
assert.equal(bandOf(0, 100), "later", "in nobody's zone at all");
|
|
22
|
-
});
|
|
23
|
-
|
|
24
|
-
test("a short map has a top band too", () => {
|
|
25
|
-
// A film with three bands must not report every wait as `later` because its
|
|
26
|
-
// numbers are small: a rank is a position in THIS map, not an absolute.
|
|
27
|
-
assert.equal(bandOf(3, 3), "now");
|
|
28
|
-
assert.equal(bandOf(1, 3), "later");
|
|
29
|
-
});
|
|
30
|
-
|
|
31
|
-
test("a band that never waited is said out loud, not reported as zero", () => {
|
|
32
|
-
const ledger = new WaitLedger();
|
|
33
|
-
ledger.note("out:1080", 40, 100, 100);
|
|
34
|
-
|
|
35
|
-
const said = ledger.describe("out:1080");
|
|
36
|
-
assert.match(said, /now 1 wait\(s\) median 40ms worst 40ms/);
|
|
37
|
-
assert.match(said, /soon none/, "silence is not a zero");
|
|
38
|
-
assert.match(said, /later none/);
|
|
39
|
-
});
|
|
40
|
-
|
|
41
|
-
test("nothing waited at all reads as nothing, so it cannot be mistaken for good", () => {
|
|
42
|
-
assert.equal(new WaitLedger().describe("out:1080"), null);
|
|
43
|
-
});
|
|
44
|
-
|
|
45
|
-
test("the count is the whole run and the median is the recent sample", () => {
|
|
46
|
-
// Two different questions: how often, and how badly.
|
|
47
|
-
const ledger = new WaitLedger();
|
|
48
|
-
for (let n = 0; n < 300; n += 1) {
|
|
49
|
-
ledger.note("out:1080", n, 100, 100);
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
const said = ledger.describe("out:1080");
|
|
53
|
-
assert.match(said, /now 300 wait\(s\)/, "every wait is counted");
|
|
54
|
-
assert.match(said, /worst 299ms/, "and the worst of what is still held");
|
|
55
|
-
});
|
|
56
|
-
|
|
57
|
-
test("waits of two outputs do not mix", () => {
|
|
58
|
-
const ledger = new WaitLedger();
|
|
59
|
-
ledger.note("out:1080", 5000, 100, 100);
|
|
60
|
-
ledger.note("out:480", 10, 100, 100);
|
|
61
|
-
|
|
62
|
-
assert.match(ledger.describe("out:1080"), /now 1 wait\(s\) median 5000ms/);
|
|
63
|
-
assert.match(ledger.describe("out:480"), /now 1 wait\(s\) median 10ms/);
|
|
64
|
-
});
|
|
65
|
-
|
|
66
|
-
test("the map answers what it says about one segment, and about itself", () => {
|
|
67
|
-
// The rank alone cannot be read: a wait means one thing at the top of a map
|
|
68
|
-
// and another at the bottom, so the highest rank stated comes with it.
|
|
69
|
-
const demand = new SegmentDemand();
|
|
70
|
-
demand.state("out:1080", [
|
|
71
|
-
{ from: 10, to: 12, priority: 100, withinSeconds: 0 },
|
|
72
|
-
{ from: 13, to: 20, priority: 97, withinSeconds: 4 },
|
|
73
|
-
{ from: 21, to: 90, priority: 90, withinSeconds: 40 }
|
|
74
|
-
]);
|
|
75
|
-
|
|
76
|
-
assert.deepEqual(demand.rankOf("out:1080", 11), { rank: 100, topRank: 100 });
|
|
77
|
-
assert.deepEqual(demand.rankOf("out:1080", 15), { rank: 97, topRank: 100 });
|
|
78
|
-
assert.deepEqual(
|
|
79
|
-
demand.rankOf("out:1080", 500),
|
|
80
|
-
{ rank: 0, topRank: 100 },
|
|
81
|
-
"in nobody's zone is a statement: nothing is coming for it"
|
|
82
|
-
);
|
|
83
|
-
assert.deepEqual(
|
|
84
|
-
demand.rankOf("out:none", 11),
|
|
85
|
-
{ rank: 0, topRank: 0 },
|
|
86
|
-
"and a map that has not been built says nothing at all, which is different"
|
|
87
|
-
);
|
|
88
|
-
});
|
|
89
|
-
|
|
90
|
-
test("overlapping zones give a segment the highest rank that covers it", () => {
|
|
91
|
-
// Two viewers a few seconds apart state stretches that overlap; the segment
|
|
92
|
-
// is as urgent as the most urgent claim on it.
|
|
93
|
-
const demand = new SegmentDemand();
|
|
94
|
-
demand.state("out:1080", [
|
|
95
|
-
{ from: 0, to: 100, priority: 90, withinSeconds: 40 },
|
|
96
|
-
{ from: 10, to: 12, priority: 100, withinSeconds: 0 }
|
|
97
|
-
]);
|
|
98
|
-
|
|
99
|
-
assert.equal(demand.rankOf("out:1080", 11).rank, 100);
|
|
100
|
-
});
|
|
1
|
+
/**
|
|
2
|
+
* @file Whether the priority map is being served in its own order.
|
|
3
|
+
*
|
|
4
|
+
* The map says what matters most. Until 2026-09-08 nothing said whether what
|
|
5
|
+
* mattered most was delivered first, for either of the two things that read it
|
|
6
|
+
* — so a map read backwards would have looked identical in every log line the
|
|
7
|
+
* proxy writes.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import test from "node:test";
|
|
11
|
+
import assert from "node:assert/strict";
|
|
12
|
+
import { bandOf, WaitLedger } from "../services/server/WaitLedger.js";
|
|
13
|
+
import { SegmentDemand } from "../services/encode/SegmentDemand.js";
|
|
14
|
+
|
|
15
|
+
test("the top rank is its own band, and the rest fall behind it", () => {
|
|
16
|
+
// The map's ranks are as many as the film needs, and a table with a hundred
|
|
17
|
+
// rows says nothing a reader can hold. What is being asked is coarse.
|
|
18
|
+
assert.equal(bandOf(100, 100), "now", "where the viewer is standing");
|
|
19
|
+
assert.equal(bandOf(95, 100), "soon", "what they reach while watching what they hold");
|
|
20
|
+
assert.equal(bandOf(50, 100), "later", "the rest of the film");
|
|
21
|
+
assert.equal(bandOf(0, 100), "later", "in nobody's zone at all");
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
test("a short map has a top band too", () => {
|
|
25
|
+
// A film with three bands must not report every wait as `later` because its
|
|
26
|
+
// numbers are small: a rank is a position in THIS map, not an absolute.
|
|
27
|
+
assert.equal(bandOf(3, 3), "now");
|
|
28
|
+
assert.equal(bandOf(1, 3), "later");
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
test("a band that never waited is said out loud, not reported as zero", () => {
|
|
32
|
+
const ledger = new WaitLedger();
|
|
33
|
+
ledger.note("out:1080", 40, 100, 100);
|
|
34
|
+
|
|
35
|
+
const said = ledger.describe("out:1080");
|
|
36
|
+
assert.match(said, /now 1 wait\(s\) median 40ms worst 40ms/);
|
|
37
|
+
assert.match(said, /soon none/, "silence is not a zero");
|
|
38
|
+
assert.match(said, /later none/);
|
|
39
|
+
});
|
|
40
|
+
|
|
41
|
+
test("nothing waited at all reads as nothing, so it cannot be mistaken for good", () => {
|
|
42
|
+
assert.equal(new WaitLedger().describe("out:1080"), null);
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
test("the count is the whole run and the median is the recent sample", () => {
|
|
46
|
+
// Two different questions: how often, and how badly.
|
|
47
|
+
const ledger = new WaitLedger();
|
|
48
|
+
for (let n = 0; n < 300; n += 1) {
|
|
49
|
+
ledger.note("out:1080", n, 100, 100);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
const said = ledger.describe("out:1080");
|
|
53
|
+
assert.match(said, /now 300 wait\(s\)/, "every wait is counted");
|
|
54
|
+
assert.match(said, /worst 299ms/, "and the worst of what is still held");
|
|
55
|
+
});
|
|
56
|
+
|
|
57
|
+
test("waits of two outputs do not mix", () => {
|
|
58
|
+
const ledger = new WaitLedger();
|
|
59
|
+
ledger.note("out:1080", 5000, 100, 100);
|
|
60
|
+
ledger.note("out:480", 10, 100, 100);
|
|
61
|
+
|
|
62
|
+
assert.match(ledger.describe("out:1080"), /now 1 wait\(s\) median 5000ms/);
|
|
63
|
+
assert.match(ledger.describe("out:480"), /now 1 wait\(s\) median 10ms/);
|
|
64
|
+
});
|
|
65
|
+
|
|
66
|
+
test("the map answers what it says about one segment, and about itself", () => {
|
|
67
|
+
// The rank alone cannot be read: a wait means one thing at the top of a map
|
|
68
|
+
// and another at the bottom, so the highest rank stated comes with it.
|
|
69
|
+
const demand = new SegmentDemand();
|
|
70
|
+
demand.state("out:1080", [
|
|
71
|
+
{ from: 10, to: 12, priority: 100, withinSeconds: 0 },
|
|
72
|
+
{ from: 13, to: 20, priority: 97, withinSeconds: 4 },
|
|
73
|
+
{ from: 21, to: 90, priority: 90, withinSeconds: 40 }
|
|
74
|
+
]);
|
|
75
|
+
|
|
76
|
+
assert.deepEqual(demand.rankOf("out:1080", 11), { rank: 100, topRank: 100 });
|
|
77
|
+
assert.deepEqual(demand.rankOf("out:1080", 15), { rank: 97, topRank: 100 });
|
|
78
|
+
assert.deepEqual(
|
|
79
|
+
demand.rankOf("out:1080", 500),
|
|
80
|
+
{ rank: 0, topRank: 100 },
|
|
81
|
+
"in nobody's zone is a statement: nothing is coming for it"
|
|
82
|
+
);
|
|
83
|
+
assert.deepEqual(
|
|
84
|
+
demand.rankOf("out:none", 11),
|
|
85
|
+
{ rank: 0, topRank: 0 },
|
|
86
|
+
"and a map that has not been built says nothing at all, which is different"
|
|
87
|
+
);
|
|
88
|
+
});
|
|
89
|
+
|
|
90
|
+
test("overlapping zones give a segment the highest rank that covers it", () => {
|
|
91
|
+
// Two viewers a few seconds apart state stretches that overlap; the segment
|
|
92
|
+
// is as urgent as the most urgent claim on it.
|
|
93
|
+
const demand = new SegmentDemand();
|
|
94
|
+
demand.state("out:1080", [
|
|
95
|
+
{ from: 0, to: 100, priority: 90, withinSeconds: 40 },
|
|
96
|
+
{ from: 10, to: 12, priority: 100, withinSeconds: 0 }
|
|
97
|
+
]);
|
|
98
|
+
|
|
99
|
+
assert.equal(demand.rankOf("out:1080", 11).rank, 100);
|
|
100
|
+
});
|
package/test/webrtc-shim.test.js
CHANGED
|
@@ -1,149 +1,149 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @file The JavaScript WebRTC stack the torrent thread uses instead of the native one.
|
|
3
|
-
*
|
|
4
|
-
* Covers the regression that took the whole proxy down from 2.9.71: a torrent
|
|
5
|
-
* carrying a `wss://` tracker made the worker create a peer connection, and a
|
|
6
|
-
* second isolate touching node-datachannel aborts the process outright.
|
|
7
|
-
*
|
|
8
|
-
* Also covers the two places werift's data channel differs from the browser's,
|
|
9
|
-
* because `simple-peer` depends on both: binary payloads must arrive as
|
|
10
|
-
* `ArrayBuffer` (anything else it pushes through a text decoder, corrupting
|
|
11
|
-
* torrent data), and the buffered-amount-low event must exist (its backpressure
|
|
12
|
-
* never resumes without it).
|
|
13
|
-
*/
|
|
14
|
-
|
|
15
|
-
import test from "node:test";
|
|
16
|
-
import assert from "node:assert/strict";
|
|
17
|
-
import { Worker } from "node:worker_threads";
|
|
18
|
-
import {
|
|
19
|
-
RTCPeerConnection,
|
|
20
|
-
RTCSessionDescription
|
|
21
|
-
} from "../services/torrent/worker/webrtc-shim.js";
|
|
22
|
-
|
|
23
|
-
/**
|
|
24
|
-
* Run a snippet on a worker thread and return what it reports.
|
|
25
|
-
*
|
|
26
|
-
* @param {string} source
|
|
27
|
-
* @returns {Promise<unknown>}
|
|
28
|
-
*/
|
|
29
|
-
function onWorker(source) {
|
|
30
|
-
return new Promise((resolve, reject) => {
|
|
31
|
-
const worker = new Worker(source, { eval: true });
|
|
32
|
-
const done = (settle) => (value) => {
|
|
33
|
-
void worker.terminate();
|
|
34
|
-
settle(value);
|
|
35
|
-
};
|
|
36
|
-
worker.once("message", done(resolve));
|
|
37
|
-
worker.once("error", done(reject));
|
|
38
|
-
});
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
test("the worker resolves webrtc-polyfill to the JavaScript stack", async () => {
|
|
42
|
-
const installUrl = new URL("../services/torrent/worker/install-webrtc-shim.js", import.meta.url).href;
|
|
43
|
-
const reported = await onWorker(`
|
|
44
|
-
import { parentPort } from "node:worker_threads";
|
|
45
|
-
await import(${JSON.stringify(installUrl)});
|
|
46
|
-
const polyfill = await import("webrtc-polyfill");
|
|
47
|
-
const pc = new polyfill.RTCPeerConnection({});
|
|
48
|
-
const channel = pc.createDataChannel("probe");
|
|
49
|
-
parentPort.postMessage({
|
|
50
|
-
connection: pc.constructor.name,
|
|
51
|
-
channel: channel.constructor.name,
|
|
52
|
-
hasBinaryType: "binaryType" in channel,
|
|
53
|
-
hasBufferedAmountLow: "onbufferedamountlow" in channel
|
|
54
|
-
});
|
|
55
|
-
pc.close();
|
|
56
|
-
`);
|
|
57
|
-
|
|
58
|
-
assert.equal(reported.connection, "ShimPeerConnection");
|
|
59
|
-
assert.equal(reported.channel, "ShimDataChannel");
|
|
60
|
-
assert.ok(reported.hasBinaryType, "simple-peer sets binaryType and would get a silent no-op");
|
|
61
|
-
assert.ok(reported.hasBufferedAmountLow, "simple-peer's backpressure needs this event");
|
|
62
|
-
});
|
|
63
|
-
|
|
64
|
-
test("a native connection on this thread does not stop the worker's stack", async () => {
|
|
65
|
-
// The exact pairing that aborted the process before: native here, JavaScript
|
|
66
|
-
// there, both live at once.
|
|
67
|
-
const nodeDataChannel = (await import("node-datachannel")).default;
|
|
68
|
-
const native = new nodeDataChannel.PeerConnection("main-side", { iceServers: [] });
|
|
69
|
-
native.createDataChannel("keepalive");
|
|
70
|
-
|
|
71
|
-
try {
|
|
72
|
-
const installUrl = new URL("../services/torrent/worker/install-webrtc-shim.js", import.meta.url).href;
|
|
73
|
-
const reported = await onWorker(`
|
|
74
|
-
import { parentPort } from "node:worker_threads";
|
|
75
|
-
await import(${JSON.stringify(installUrl)});
|
|
76
|
-
const polyfill = await import("webrtc-polyfill");
|
|
77
|
-
const pc = new polyfill.RTCPeerConnection({});
|
|
78
|
-
pc.createDataChannel("probe");
|
|
79
|
-
const offer = await pc.createOffer();
|
|
80
|
-
await pc.setLocalDescription(offer);
|
|
81
|
-
parentPort.postMessage({ ok: String(pc.localDescription.sdp).startsWith("v=0") });
|
|
82
|
-
pc.close();
|
|
83
|
-
`);
|
|
84
|
-
assert.equal(reported.ok, true);
|
|
85
|
-
} finally {
|
|
86
|
-
native.close();
|
|
87
|
-
}
|
|
88
|
-
});
|
|
89
|
-
|
|
90
|
-
test("a session description is built from one object, as callers write it", async () => {
|
|
91
|
-
// simple-peer does `new RTCSessionDescription(data)` with `{ type, sdp }`.
|
|
92
|
-
// werift's own class takes `(sdp, type)` positionally, so the type would land
|
|
93
|
-
// in the sdp slot and every peer connection would be rejected with
|
|
94
|
-
// "invalid sessionDescription" — which is exactly what the field showed.
|
|
95
|
-
const description = new RTCSessionDescription({ type: "offer", sdp: "v=0\r\n" });
|
|
96
|
-
assert.equal(description.type, "offer");
|
|
97
|
-
assert.equal(description.sdp, "v=0\r\n");
|
|
98
|
-
|
|
99
|
-
const answerer = new RTCPeerConnection({});
|
|
100
|
-
const offerer = new RTCPeerConnection({});
|
|
101
|
-
try {
|
|
102
|
-
offerer.createDataChannel("probe");
|
|
103
|
-
const offer = await offerer.createOffer();
|
|
104
|
-
await offerer.setLocalDescription(offer);
|
|
105
|
-
|
|
106
|
-
// The round trip a tracker peer actually performs.
|
|
107
|
-
await answerer.setRemoteDescription(
|
|
108
|
-
new RTCSessionDescription({ type: offerer.localDescription.type, sdp: offerer.localDescription.sdp })
|
|
109
|
-
);
|
|
110
|
-
assert.equal(answerer.remoteDescription.type, "offer");
|
|
111
|
-
} finally {
|
|
112
|
-
answerer.close();
|
|
113
|
-
offerer.close();
|
|
114
|
-
}
|
|
115
|
-
});
|
|
116
|
-
|
|
117
|
-
test("binary payloads reach the reader as ArrayBuffer, byte for byte", async () => {
|
|
118
|
-
const sender = new RTCPeerConnection({});
|
|
119
|
-
const receiver = new RTCPeerConnection({});
|
|
120
|
-
const payload = Buffer.from([0xde, 0xad, 0xbe, 0xef, 0x00, 0xff, 0x7f, 0x80]);
|
|
121
|
-
|
|
122
|
-
try {
|
|
123
|
-
const received = new Promise((resolve, reject) => {
|
|
124
|
-
receiver.ondatachannel = ({ channel }) => {
|
|
125
|
-
channel.binaryType = "arraybuffer";
|
|
126
|
-
channel.onmessage = (event) => resolve(event.data);
|
|
127
|
-
};
|
|
128
|
-
setTimeout(() => reject(new Error("nothing arrived within 30s")), 30_000);
|
|
129
|
-
});
|
|
130
|
-
|
|
131
|
-
sender.onicecandidate = ({ candidate }) => candidate && receiver.addIceCandidate(candidate);
|
|
132
|
-
receiver.onicecandidate = ({ candidate }) => candidate && sender.addIceCandidate(candidate);
|
|
133
|
-
|
|
134
|
-
const channel = sender.createDataChannel("payload");
|
|
135
|
-
await sender.setLocalDescription(await sender.createOffer());
|
|
136
|
-
await receiver.setRemoteDescription(sender.localDescription);
|
|
137
|
-
await receiver.setLocalDescription(await receiver.createAnswer());
|
|
138
|
-
await sender.setRemoteDescription(receiver.localDescription);
|
|
139
|
-
|
|
140
|
-
channel.onopen = () => channel.send(payload);
|
|
141
|
-
|
|
142
|
-
const data = await received;
|
|
143
|
-
assert.ok(data instanceof ArrayBuffer, `simple-peer would run this through a text decoder: ${Object.prototype.toString.call(data)}`);
|
|
144
|
-
assert.deepEqual(Buffer.from(data), payload, "payload was altered in transit");
|
|
145
|
-
} finally {
|
|
146
|
-
sender.close();
|
|
147
|
-
receiver.close();
|
|
148
|
-
}
|
|
149
|
-
});
|
|
1
|
+
/**
|
|
2
|
+
* @file The JavaScript WebRTC stack the torrent thread uses instead of the native one.
|
|
3
|
+
*
|
|
4
|
+
* Covers the regression that took the whole proxy down from 2.9.71: a torrent
|
|
5
|
+
* carrying a `wss://` tracker made the worker create a peer connection, and a
|
|
6
|
+
* second isolate touching node-datachannel aborts the process outright.
|
|
7
|
+
*
|
|
8
|
+
* Also covers the two places werift's data channel differs from the browser's,
|
|
9
|
+
* because `simple-peer` depends on both: binary payloads must arrive as
|
|
10
|
+
* `ArrayBuffer` (anything else it pushes through a text decoder, corrupting
|
|
11
|
+
* torrent data), and the buffered-amount-low event must exist (its backpressure
|
|
12
|
+
* never resumes without it).
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import test from "node:test";
|
|
16
|
+
import assert from "node:assert/strict";
|
|
17
|
+
import { Worker } from "node:worker_threads";
|
|
18
|
+
import {
|
|
19
|
+
RTCPeerConnection,
|
|
20
|
+
RTCSessionDescription
|
|
21
|
+
} from "../services/torrent/worker/webrtc-shim.js";
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Run a snippet on a worker thread and return what it reports.
|
|
25
|
+
*
|
|
26
|
+
* @param {string} source
|
|
27
|
+
* @returns {Promise<unknown>}
|
|
28
|
+
*/
|
|
29
|
+
function onWorker(source) {
|
|
30
|
+
return new Promise((resolve, reject) => {
|
|
31
|
+
const worker = new Worker(source, { eval: true });
|
|
32
|
+
const done = (settle) => (value) => {
|
|
33
|
+
void worker.terminate();
|
|
34
|
+
settle(value);
|
|
35
|
+
};
|
|
36
|
+
worker.once("message", done(resolve));
|
|
37
|
+
worker.once("error", done(reject));
|
|
38
|
+
});
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
test("the worker resolves webrtc-polyfill to the JavaScript stack", async () => {
|
|
42
|
+
const installUrl = new URL("../services/torrent/worker/install-webrtc-shim.js", import.meta.url).href;
|
|
43
|
+
const reported = await onWorker(`
|
|
44
|
+
import { parentPort } from "node:worker_threads";
|
|
45
|
+
await import(${JSON.stringify(installUrl)});
|
|
46
|
+
const polyfill = await import("webrtc-polyfill");
|
|
47
|
+
const pc = new polyfill.RTCPeerConnection({});
|
|
48
|
+
const channel = pc.createDataChannel("probe");
|
|
49
|
+
parentPort.postMessage({
|
|
50
|
+
connection: pc.constructor.name,
|
|
51
|
+
channel: channel.constructor.name,
|
|
52
|
+
hasBinaryType: "binaryType" in channel,
|
|
53
|
+
hasBufferedAmountLow: "onbufferedamountlow" in channel
|
|
54
|
+
});
|
|
55
|
+
pc.close();
|
|
56
|
+
`);
|
|
57
|
+
|
|
58
|
+
assert.equal(reported.connection, "ShimPeerConnection");
|
|
59
|
+
assert.equal(reported.channel, "ShimDataChannel");
|
|
60
|
+
assert.ok(reported.hasBinaryType, "simple-peer sets binaryType and would get a silent no-op");
|
|
61
|
+
assert.ok(reported.hasBufferedAmountLow, "simple-peer's backpressure needs this event");
|
|
62
|
+
});
|
|
63
|
+
|
|
64
|
+
test("a native connection on this thread does not stop the worker's stack", async () => {
|
|
65
|
+
// The exact pairing that aborted the process before: native here, JavaScript
|
|
66
|
+
// there, both live at once.
|
|
67
|
+
const nodeDataChannel = (await import("node-datachannel")).default;
|
|
68
|
+
const native = new nodeDataChannel.PeerConnection("main-side", { iceServers: [] });
|
|
69
|
+
native.createDataChannel("keepalive");
|
|
70
|
+
|
|
71
|
+
try {
|
|
72
|
+
const installUrl = new URL("../services/torrent/worker/install-webrtc-shim.js", import.meta.url).href;
|
|
73
|
+
const reported = await onWorker(`
|
|
74
|
+
import { parentPort } from "node:worker_threads";
|
|
75
|
+
await import(${JSON.stringify(installUrl)});
|
|
76
|
+
const polyfill = await import("webrtc-polyfill");
|
|
77
|
+
const pc = new polyfill.RTCPeerConnection({});
|
|
78
|
+
pc.createDataChannel("probe");
|
|
79
|
+
const offer = await pc.createOffer();
|
|
80
|
+
await pc.setLocalDescription(offer);
|
|
81
|
+
parentPort.postMessage({ ok: String(pc.localDescription.sdp).startsWith("v=0") });
|
|
82
|
+
pc.close();
|
|
83
|
+
`);
|
|
84
|
+
assert.equal(reported.ok, true);
|
|
85
|
+
} finally {
|
|
86
|
+
native.close();
|
|
87
|
+
}
|
|
88
|
+
});
|
|
89
|
+
|
|
90
|
+
test("a session description is built from one object, as callers write it", async () => {
|
|
91
|
+
// simple-peer does `new RTCSessionDescription(data)` with `{ type, sdp }`.
|
|
92
|
+
// werift's own class takes `(sdp, type)` positionally, so the type would land
|
|
93
|
+
// in the sdp slot and every peer connection would be rejected with
|
|
94
|
+
// "invalid sessionDescription" — which is exactly what the field showed.
|
|
95
|
+
const description = new RTCSessionDescription({ type: "offer", sdp: "v=0\r\n" });
|
|
96
|
+
assert.equal(description.type, "offer");
|
|
97
|
+
assert.equal(description.sdp, "v=0\r\n");
|
|
98
|
+
|
|
99
|
+
const answerer = new RTCPeerConnection({});
|
|
100
|
+
const offerer = new RTCPeerConnection({});
|
|
101
|
+
try {
|
|
102
|
+
offerer.createDataChannel("probe");
|
|
103
|
+
const offer = await offerer.createOffer();
|
|
104
|
+
await offerer.setLocalDescription(offer);
|
|
105
|
+
|
|
106
|
+
// The round trip a tracker peer actually performs.
|
|
107
|
+
await answerer.setRemoteDescription(
|
|
108
|
+
new RTCSessionDescription({ type: offerer.localDescription.type, sdp: offerer.localDescription.sdp })
|
|
109
|
+
);
|
|
110
|
+
assert.equal(answerer.remoteDescription.type, "offer");
|
|
111
|
+
} finally {
|
|
112
|
+
answerer.close();
|
|
113
|
+
offerer.close();
|
|
114
|
+
}
|
|
115
|
+
});
|
|
116
|
+
|
|
117
|
+
test("binary payloads reach the reader as ArrayBuffer, byte for byte", async () => {
|
|
118
|
+
const sender = new RTCPeerConnection({});
|
|
119
|
+
const receiver = new RTCPeerConnection({});
|
|
120
|
+
const payload = Buffer.from([0xde, 0xad, 0xbe, 0xef, 0x00, 0xff, 0x7f, 0x80]);
|
|
121
|
+
|
|
122
|
+
try {
|
|
123
|
+
const received = new Promise((resolve, reject) => {
|
|
124
|
+
receiver.ondatachannel = ({ channel }) => {
|
|
125
|
+
channel.binaryType = "arraybuffer";
|
|
126
|
+
channel.onmessage = (event) => resolve(event.data);
|
|
127
|
+
};
|
|
128
|
+
setTimeout(() => reject(new Error("nothing arrived within 30s")), 30_000);
|
|
129
|
+
});
|
|
130
|
+
|
|
131
|
+
sender.onicecandidate = ({ candidate }) => candidate && receiver.addIceCandidate(candidate);
|
|
132
|
+
receiver.onicecandidate = ({ candidate }) => candidate && sender.addIceCandidate(candidate);
|
|
133
|
+
|
|
134
|
+
const channel = sender.createDataChannel("payload");
|
|
135
|
+
await sender.setLocalDescription(await sender.createOffer());
|
|
136
|
+
await receiver.setRemoteDescription(sender.localDescription);
|
|
137
|
+
await receiver.setLocalDescription(await receiver.createAnswer());
|
|
138
|
+
await sender.setRemoteDescription(receiver.localDescription);
|
|
139
|
+
|
|
140
|
+
channel.onopen = () => channel.send(payload);
|
|
141
|
+
|
|
142
|
+
const data = await received;
|
|
143
|
+
assert.ok(data instanceof ArrayBuffer, `simple-peer would run this through a text decoder: ${Object.prototype.toString.call(data)}`);
|
|
144
|
+
assert.deepEqual(Buffer.from(data), payload, "payload was altered in transit");
|
|
145
|
+
} finally {
|
|
146
|
+
sender.close();
|
|
147
|
+
receiver.close();
|
|
148
|
+
}
|
|
149
|
+
});
|