@torrent-tv/proxy 2.89.17 → 2.89.18
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/README.md +14 -3
- package/package.json +10 -2
- package/server.js +0 -11
- package/.claude/commands/opsx/apply.md +0 -155
- package/.claude/commands/opsx/archive.md +0 -160
- package/.claude/commands/opsx/explore.md +0 -174
- package/.claude/commands/opsx/propose.md +0 -109
- package/.claude/commands/opsx/sync.md +0 -143
- package/.claude/skills/openspec-apply-change/SKILL.md +0 -159
- package/.claude/skills/openspec-archive-change/SKILL.md +0 -117
- package/.claude/skills/openspec-explore/SKILL.md +0 -289
- package/.claude/skills/openspec-propose/SKILL.md +0 -113
- package/.claude/skills/openspec-sync-specs/SKILL.md +0 -147
- package/.dockerignore +0 -5
- package/AGENTS.md +0 -363
- package/CHANGELOG.md +0 -2377
- package/Dockerfile +0 -30
- package/biome.json +0 -412
- package/corpus.tmp.json +0 -1
- package/docs/browser-proxy-contract.md +0 -155
- package/docs/container-architecture.md +0 -273
- package/docs/download-architecture.md +0 -261
- package/docs/encode-architecture.md +0 -765
- package/docs/encode-run-state.md +0 -96
- package/docs/logs.md +0 -151
- package/docs/playback-start-forecast.md +0 -113
- package/docs/socks5-egress-research.md +0 -114
- package/docs/storage-architecture.md +0 -273
- package/knip.json +0 -14
- package/main2.cpuprofile +0 -1
- package/openspec/changes/adaptive-bitrate/.openspec.yaml +0 -0
- package/openspec/changes/adaptive-bitrate/design.md +0 -92
- package/openspec/changes/adaptive-bitrate/proposal.md +0 -56
- package/openspec/changes/adaptive-bitrate/specs/adaptive-bitrate/spec.md +0 -51
- package/openspec/changes/adaptive-bitrate/tasks.md +0 -40
- package/openspec/changes/binary-distribution/.openspec.yaml +0 -2
- package/openspec/changes/binary-distribution/proposal.md +0 -53
- package/openspec/changes/chunked-request-bodies/design.md +0 -81
- package/openspec/changes/chunked-request-bodies/proposal.md +0 -53
- package/openspec/changes/chunked-request-bodies/specs/chunked-request-bodies/spec.md +0 -30
- package/openspec/changes/chunked-request-bodies/tasks.md +0 -40
- package/openspec/changes/cold-start/design.md +0 -98
- package/openspec/changes/cold-start/proposal.md +0 -62
- package/openspec/changes/cold-start/specs/cold-start/spec.md +0 -47
- package/openspec/changes/cold-start/tasks.md +0 -48
- package/openspec/changes/disk-cap/.openspec.yaml +0 -2
- package/openspec/changes/disk-cap/proposal.md +0 -37
- package/openspec/changes/disk-cap/specs/disk-cap/spec.md +0 -25
- package/openspec/changes/disk-cap/tasks.md +0 -19
- package/openspec/changes/proxy-observability/.openspec.yaml +0 -2
- package/openspec/changes/proxy-observability/design.md +0 -38
- package/openspec/changes/proxy-observability/proposal.md +0 -49
- package/openspec/changes/proxy-observability/specs/observability/spec.md +0 -33
- package/openspec/changes/proxy-observability/tasks.md +0 -21
- package/openspec/changes/seek-debounce/.openspec.yaml +0 -0
- package/openspec/changes/seek-debounce/design.md +0 -118
- package/openspec/changes/seek-debounce/proposal.md +0 -59
- package/openspec/changes/seek-debounce/specs/seek-debounce/spec.md +0 -41
- package/openspec/changes/seek-debounce/tasks.md +0 -33
- package/openspec/changes/subtitle-language/.openspec.yaml +0 -2
- package/openspec/changes/subtitle-language/proposal.md +0 -50
- package/openspec/changes/subtitle-language/specs/subtitle-language/spec.md +0 -34
- package/openspec/changes/subtitle-language/tasks.md +0 -26
- package/openspec/changes/track-selection/.openspec.yaml +0 -2
- package/openspec/changes/track-selection/design.md +0 -47
- package/openspec/changes/track-selection/proposal.md +0 -45
- package/openspec/changes/track-selection/specs/track-selection/spec.md +0 -41
- package/openspec/changes/track-selection/tasks.md +0 -20
- package/openspec/changes/transcode-quality/.openspec.yaml +0 -2
- package/openspec/changes/transcode-quality/proposal.md +0 -51
- package/openspec/changes/transcode-quality/specs/transcode-quality/spec.md +0 -139
- package/openspec/changes/transcode-quality/tasks.md +0 -63
- package/openspec/config.yaml +0 -38
- package/public/.well-known/appspecific/com.chrome.devtools.json +0 -1
- package/research/delivery-wedge-stand-ladder-2026-09-13.md +0 -329
- package/research/double-spawn-2026-09-10.md +0 -171
- package/research/handover-2026-09-13.md +0 -209
- package/research/handover-reader-claims-removal-2026-09-12.md +0 -166
- package/research/piece-withdrawn-but-still-claimed-2026-09-12.md +0 -175
- package/research/preset-benchmark-size-scaling-2026-08-22.md +0 -55
- package/research/priority-map-is-the-truth-2026-09-12.md +0 -225
- package/research/valgrind-replica-2026-08-27/logs.tar.gz +0 -0
- package/scripts/build-audio-samples.mjs +0 -31
- package/scripts/render-run-graph.js +0 -173
- package/test/asset-paths.test.js +0 -28
- package/test/audio-buffer-continuity.test.js +0 -77
- package/test/audio-calibration.test.js +0 -23
- package/test/audio-inventory.test.js +0 -212
- package/test/audio-track-bitrate.test.js +0 -40
- package/test/audio-warm-recorded.test.js +0 -63
- package/test/auto-quality-step.test.js +0 -762
- package/test/available-share.test.js +0 -76
- package/test/background-fill.test.js +0 -190
- package/test/client-log-file.test.js +0 -126
- package/test/client-logs-route.test.js +0 -34
- package/test/coalesce.test.js +0 -39
- package/test/completed-files.test.js +0 -115
- package/test/concurrent-cost.test.js +0 -148
- package/test/container-media-info.test.js +0 -228
- package/test/contention.test.js +0 -76
- package/test/core-dumps.test.js +0 -57
- package/test/coverage-follows-the-disk.test.js +0 -233
- package/test/coverage-map.test.js +0 -195
- package/test/cue-push-carries-what-the-walk-found.test.js +0 -58
- package/test/cut-times-timeline.test.js +0 -65
- package/test/cuts-follow-published-grid.test.js +0 -109
- package/test/data-channel-frame.test.js +0 -63
- package/test/data-channel-viewer-lifecycle.test.js +0 -193
- package/test/dead-torrent-handle.test.js +0 -52
- package/test/declared-rates.test.js +0 -116
- package/test/declared-tracks.test.js +0 -43
- package/test/decode-cost-fit.test.js +0 -202
- package/test/decode-cost.test.js +0 -475
- package/test/delivery-probe-field.test.js +0 -173
- package/test/delivery-probe.test.js +0 -382
- package/test/demand-register.test.js +0 -206
- package/test/dht-bootstrap.test.js +0 -72
- package/test/drain-threat.test.js +0 -65
- package/test/duplicate-add.test.js +0 -48
- package/test/encode-admission.test.js +0 -170
- package/test/encode-cost.test.js +0 -275
- package/test/encode-exit.test.js +0 -111
- package/test/encode-orchestrator.test.js +0 -426
- package/test/encode-plan-viewers.test.js +0 -725
- package/test/encode-plan.test.js +0 -545
- package/test/encode-run-state.test.js +0 -314
- package/test/encode-run.test.js +0 -248
- package/test/encode-slope.test.js +0 -46
- package/test/encoded-output.test.js +0 -39
- package/test/encoder-kinds.test.js +0 -122
- package/test/encoder-readings.test.js +0 -68
- package/test/episode-naming.test.js +0 -131
- package/test/every-claimant-is-told-its-share.test.js +0 -152
- package/test/failed-encoder-still-serves-what-exists.test.js +0 -354
- package/test/failed-start-breaker.test.js +0 -202
- package/test/fastest-wires.test.js +0 -143
- package/test/ffmpeg-stream-counts.test.js +0 -101
- package/test/file-edges.test.js +0 -191
- package/test/files-in-use.test.js +0 -34
- package/test/fixtures/audio-frame-boundary.json +0 -1
- package/test/fixtures/refused-audio-20261002.json +0 -10
- package/test/fmp4-presentation-clock.test.js +0 -148
- package/test/fmp4-self-contained.test.js +0 -80
- package/test/fmp4-timestamps.test.js +0 -140
- package/test/fmp4-track-completeness.test.js +0 -41
- package/test/format-keyed-outputs.test.js +0 -78
- package/test/health-metrics.test.js +0 -36
- package/test/held-read-ownership.test.js +0 -77
- package/test/held-request-width.test.js +0 -157
- package/test/helpers/encode-run.js +0 -248
- package/test/helpers/held-file.js +0 -77
- package/test/helpers/manager.js +0 -62
- package/test/helpers/matroska-file.js +0 -296
- package/test/helpers/output-spec.js +0 -63
- package/test/host-load.test.js +0 -68
- package/test/index-accuracy-is-about-the-file.test.js +0 -128
- package/test/init-compat.test.js +0 -219
- package/test/input-lost-quiets-the-plan.test.js +0 -261
- package/test/input-unavailable.test.js +0 -48
- package/test/installation-id.test.js +0 -39
- package/test/keeping-period.test.js +0 -83
- package/test/keyframe-index-accuracy.test.js +0 -188
- package/test/keyframe-table-budget.test.js +0 -123
- package/test/keyframes-belong-to-the-file.test.js +0 -249
- package/test/learned-median.test.js +0 -37
- package/test/letting-go-asks-who-is-watching.test.js +0 -191
- package/test/limit-row-by-area.test.js +0 -60
- package/test/link-budget.test.js +0 -111
- package/test/link-probe.test.js +0 -56
- package/test/local-encoding-data.test.js +0 -273
- package/test/logger-repeats.test.js +0 -134
- package/test/look-ahead-coverage.test.js +0 -56
- package/test/manager-surface.test.js +0 -291
- package/test/matroska-blocks.test.js +0 -0
- package/test/matroska-cluster-discovery.test.js +0 -323
- package/test/matroska-cues-track.test.js +0 -192
- package/test/media-time.test.js +0 -62
- package/test/memory-budget.test.js +0 -390
- package/test/move-cost.test.js +0 -216
- package/test/mp4-composition-times.test.js +0 -0
- package/test/mp4-subtitles.test.js +0 -173
- package/test/one-authority.test.js +0 -285
- package/test/one-budget.test.js +0 -149
- package/test/one-output-one-session.test.js +0 -273
- package/test/one-resource-divided.test.js +0 -185
- package/test/one-serving-output-per-height.test.js +0 -458
- package/test/orchestrator-wired.test.js +0 -207
- package/test/output-catalog.test.js +0 -39
- package/test/output-shape.test.js +0 -21
- package/test/output-spec.test.js +0 -251
- package/test/output-speed.test.js +0 -92
- package/test/outputs-being-prepared.test.js +0 -40
- package/test/packet-witness-ring.test.js +0 -236
- package/test/packet-witness.test.js +0 -148
- package/test/piece-completeness.test.js +0 -78
- package/test/piece-disk-store.test.js +0 -401
- package/test/piece-from-whole-file.test.js +0 -129
- package/test/piece-lru.test.js +0 -319
- package/test/piece-reader.test.js +0 -162
- package/test/piece-selection-offset.test.js +0 -85
- package/test/piece-store-eviction.test.js +0 -595
- package/test/piece-store-never-refuses.test.js +0 -153
- package/test/piece-store-reservations.test.js +0 -403
- package/test/piece-store-slow-disk.test.js +0 -159
- package/test/piece-tail.test.js +0 -97
- package/test/plan-host-timings.test.js +0 -68
- package/test/plan-is-steady.test.js +0 -225
- package/test/playback-readiness.test.js +0 -518
- package/test/playback-start-regressions.test.js +0 -101
- package/test/priority-map-download.test.js +0 -174
- package/test/priority-map-emptied.test.js +0 -204
- package/test/priority-map-per-output.test.js +0 -215
- package/test/priority-map.test.js +0 -163
- package/test/probe-wedge-certainty.test.js +0 -60
- package/test/produced-copy-choice.test.js +0 -213
- package/test/published-timeline.test.js +0 -83
- package/test/quality-offer.test.js +0 -160
- package/test/quality-variants.test.js +0 -1274
- package/test/rate-control-in-the-output.test.js +0 -181
- package/test/read-survives-withdrawal.test.js +0 -164
- package/test/read-window.test.js +0 -365
- package/test/reads-not-yet-arrived.test.js +0 -218
- package/test/resume-warm.test.js +0 -39
- package/test/run-graph-drift.test.js +0 -37
- package/test/run-inputs.test.js +0 -80
- package/test/run-intervals.test.js +0 -100
- package/test/run-position-follows-published-grid.test.js +0 -89
- package/test/run-progress.test.js +0 -64
- package/test/same-height-switch.test.js +0 -663
- package/test/seek-frees-the-viewers-requests.test.js +0 -217
- package/test/seek-landing.test.js +0 -109
- package/test/seek-target-not-superseded.test.js +0 -195
- package/test/segment-closed-on-both-branches.test.js +0 -114
- package/test/segment-cut-times.test.js +0 -63
- package/test/segment-demand.test.js +0 -80
- package/test/segment-hold-supersede.test.js +0 -91
- package/test/segment-judged-by-its-own-header.test.js +0 -222
- package/test/segment-serve-wiring.test.js +0 -481
- package/test/segment-store-eviction.test.js +0 -247
- package/test/segment-store.test.js +0 -352
- package/test/segment-true-start.test.js +0 -86
- package/test/segments-are-shared.test.js +0 -176
- package/test/send-chunk-bytes.test.js +0 -86
- package/test/serving-existing-output.test.js +0 -111
- package/test/serving-output.test.js +0 -102
- package/test/shared-piece-store.test.js +0 -310
- package/test/sidecar-naming.test.js +0 -142
- package/test/soundtrack-rate-bound.test.js +0 -289
- package/test/source-file.test.js +0 -133
- package/test/source-files-route.test.js +0 -113
- package/test/source-registry.test.js +0 -18
- package/test/split-a-stretch.test.js +0 -139
- package/test/stale-request-after-seek.test.js +0 -158
- package/test/startup-readings.test.js +0 -124
- package/test/stream-route.test.js +0 -237
- package/test/subtitle-cue-framing.test.js +0 -200
- package/test/subtitle-cue-source.test.js +0 -102
- package/test/subtitle-cue-walk.test.js +0 -385
- package/test/subtitle-cursor.test.js +0 -63
- package/test/subtitle-defaults.test.js +0 -118
- package/test/subtitle-language.test.js +0 -252
- package/test/subtitle-metadata.test.js +0 -15
- package/test/subtitle-plan-waits.test.js +0 -125
- package/test/subtitle-track-numbering.test.js +0 -391
- package/test/supply-margin.test.js +0 -190
- package/test/swarm-follows-readers.test.js +0 -174
- package/test/swarm-reach.test.js +0 -130
- package/test/swarm-selection.test.js +0 -220
- package/test/tail-duplication.test.js +0 -167
- package/test/the-channel-has-both-ends.test.js +0 -91
- package/test/the-torrent-thread-serves-bytes.test.js +0 -107
- package/test/thread-pool.test.js +0 -53
- package/test/timeline.test.js +0 -84
- package/test/torrent-contents.test.js +0 -235
- package/test/torrent-cost.test.js +0 -71
- package/test/torrent-files.test.js +0 -221
- package/test/torrent-naming.test.js +0 -255
- package/test/tracks-begin-together.test.js +0 -209
- package/test/tunnel-renewal.test.js +0 -167
- package/test/two-viewers-one-picture.test.js +0 -508
- package/test/upload-hurry.test.js +0 -186
- package/test/usrsctp-state.test.js +0 -131
- package/test/video-facts.test.js +0 -102
- package/test/viewer-assignments.test.js +0 -143
- package/test/viewer-outputs.test.js +0 -285
- package/test/viewer-presence.test.js +0 -116
- package/test/viewer-requests-admission.test.js +0 -92
- package/test/viewer-starts-on-map.test.js +0 -27
- package/test/viewer-states.test.js +0 -192
- package/test/viewer-subtitle-subscription.test.js +0 -96
- package/test/viewer.test.js +0 -139
- package/test/viewing-generations.test.js +0 -390
- package/test/visible-rung.test.js +0 -37
- package/test/wait-ledger.test.js +0 -100
- package/test/webrtc-shim.test.js +0 -149
- package/test/wedge-certainty.test.js +0 -131
- package/test/whole-file-held-read.test.js +0 -30
- package/test/withdraw-piece-claim.test.js +0 -212
- package/test/worker-channel.test.js +0 -158
|
@@ -1,217 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @file A seek must free the requests it made pointless, on every output that
|
|
3
|
-
* viewer watches, and only theirs.
|
|
4
|
-
*
|
|
5
|
-
* hls.js keeps ONE fragment load outstanding per track, so a request held for a
|
|
6
|
-
* segment the viewer has just left blocks the request for where they now are.
|
|
7
|
-
* Measured 2026-08-04: 57 s of a 58 s backward seek was that wait, and the
|
|
8
|
-
* segment they wanted was served in 15 ms once it was asked for.
|
|
9
|
-
*
|
|
10
|
-
* The guard against it was built — the route compares a seek epoch and asks
|
|
11
|
-
* whether each held request is still wanted — and nothing moved that epoch: no
|
|
12
|
-
* caller of `invalidateWaits` was a seek.
|
|
13
|
-
*
|
|
14
|
-
* TWO THINGS THIS CHECK HAS TO DO, and the first version of it did neither.
|
|
15
|
-
* It must wait until the store really HOLDS the waits, because a seek that
|
|
16
|
-
* happens before they are registered frees nothing and passes all the same; and
|
|
17
|
-
* it must cover the three outputs one viewer watches — the picture the browser
|
|
18
|
-
* addresses, the step on their screen, their soundtrack — because waking only
|
|
19
|
-
* the one the browser named leaves two thirds of their requests standing.
|
|
20
|
-
*
|
|
21
|
-
* And waking is not cancelling: one viewer's seek must leave another viewer's
|
|
22
|
-
* request for the same segment of the same output exactly where it was.
|
|
23
|
-
*/
|
|
24
|
-
|
|
25
|
-
import test from "node:test";
|
|
26
|
-
import assert from "node:assert/strict";
|
|
27
|
-
import { rm, writeFile } from "node:fs/promises";
|
|
28
|
-
import path from "node:path";
|
|
29
|
-
import { setTimeout as delay } from "node:timers/promises";
|
|
30
|
-
import { wireOutputs } from "../services/server/wire-outputs.js";
|
|
31
|
-
import { waitForSessionFile } from "../services/server/transcode-session-files.js";
|
|
32
|
-
import { SourceFile } from "../services/media/SourceFile.js";
|
|
33
|
-
import { Timeline } from "../services/encode/output/Timeline.js";
|
|
34
|
-
import { Output } from "../services/encode/output/Output.js";
|
|
35
|
-
import { KeyframeTable } from "../services/media/container/KeyframeTable.js";
|
|
36
|
-
import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
|
|
37
|
-
import { outputSpec } from "./helpers/output-spec.js";
|
|
38
|
-
|
|
39
|
-
const SESSION_ID = "2222222233334444";
|
|
40
|
-
const OUTPUT_KEY = "seek-frees:fmt=fmp4:grid=uniform:video-only:v=0/copy";
|
|
41
|
-
const STEP_ID = "3333333344445555";
|
|
42
|
-
const STEP_KEY = "seek-frees:fmt=fmp4:grid=uniform:video-only:v=0/libx264/960x540";
|
|
43
|
-
const SOUND_ID = "4444444455556666";
|
|
44
|
-
const SOUND_KEY = "seek-frees:fmt=fmp4:grid=uniform:audio-only:a=0/0/aac";
|
|
45
|
-
/** Long enough that running out of it is a failure and never the measurement. */
|
|
46
|
-
const HOLD_MS = 30_000;
|
|
47
|
-
|
|
48
|
-
/**
|
|
49
|
-
* One output of the film, with nothing produced for it yet.
|
|
50
|
-
*
|
|
51
|
-
* @param {object} manager
|
|
52
|
-
* @param {{ id: string, key: string, audioOnly?: boolean, height?: number }} what
|
|
53
|
-
* @returns {object}
|
|
54
|
-
*/
|
|
55
|
-
function outputOn(manager, { id, key, audioOnly = false, height = 0 }) {
|
|
56
|
-
manager.segmentStore.useFormat(key, fmp4Format);
|
|
57
|
-
const dirPath = manager.segmentStore.directoryFor(key);
|
|
58
|
-
const session = {
|
|
59
|
-
id,
|
|
60
|
-
spec: outputSpec({ transcodeVideo: height > 0, height, audioOnly, cutGrid: "uniform" }),
|
|
61
|
-
outputKey: key,
|
|
62
|
-
dirPath,
|
|
63
|
-
timeline: new Timeline({ boundaries: [0, 12.5, 25, 37.5, 50, 62.5], cutGrid: "uniform" }),
|
|
64
|
-
state: "ready",
|
|
65
|
-
file: new SourceFile({ sourceKey: "source-1", fileIndex: 0, name: "video.mkv" }).learn({ durationSeconds: 62.5 }),
|
|
66
|
-
get inputFile() { return this.file; },
|
|
67
|
-
get audioFile() { return this.file; },
|
|
68
|
-
lastAloneSpeed: 2,
|
|
69
|
-
startedAt: Date.now(),
|
|
70
|
-
lastAccessedAt: Date.now(),
|
|
71
|
-
runs: new Set(),
|
|
72
|
-
lastError: "",
|
|
73
|
-
consumers: new Set(),
|
|
74
|
-
viewers: new Map(),
|
|
75
|
-
segmentCount: 5,
|
|
76
|
-
segmentFormat: fmp4Format,
|
|
77
|
-
useSyntheticPlaylist: true,
|
|
78
|
-
playlistText: "#EXTM3U\n",
|
|
79
|
-
output: new Output({ encodeWidth: 0, encodeHeight: height, outputFps: 25, softwarePreset: null, applyTonemap: false }),
|
|
80
|
-
keyframes: new KeyframeTable().learn({ times: [0, 12.5, 25, 37.5, 50], format: "matroska" }),
|
|
81
|
-
audioOnly,
|
|
82
|
-
waitEpoch: 0
|
|
83
|
-
};
|
|
84
|
-
manager.outputs.set(id, session);
|
|
85
|
-
return session;
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
/**
|
|
89
|
-
* Wait until the store really holds this many waits on an output.
|
|
90
|
-
*
|
|
91
|
-
* The deadline is a backstop and never the measurement: what is waited for is
|
|
92
|
-
* the registration itself, which is the store's own state.
|
|
93
|
-
*
|
|
94
|
-
* @param {object} manager
|
|
95
|
-
* @param {string} key
|
|
96
|
-
* @param {number} howMany
|
|
97
|
-
* @returns {Promise<void>}
|
|
98
|
-
*/
|
|
99
|
-
async function untilWaitsAreRegistered(manager, key, howMany) {
|
|
100
|
-
const giveUpAt = Date.now() + 5_000;
|
|
101
|
-
while (manager.segmentStore.waitingFor(key) < howMany) {
|
|
102
|
-
if (Date.now() > giveUpAt) {
|
|
103
|
-
throw new Error(`only ${manager.segmentStore.waitingFor(key)} wait(s) on ${key} after 5s`);
|
|
104
|
-
}
|
|
105
|
-
await new Promise((resolve) => setImmediate(resolve));
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
/**
|
|
110
|
-
* The picture, one quality step and one soundtrack of a film, with two viewers
|
|
111
|
-
* on the picture and one of them also on the step and the soundtrack.
|
|
112
|
-
*
|
|
113
|
-
* @returns {{ manager: object, session: object, step: object, sound: object }}
|
|
114
|
-
*/
|
|
115
|
-
function filmWithThreeOutputs() {
|
|
116
|
-
const manager = wireOutputs({
|
|
117
|
-
enabled: true,
|
|
118
|
-
ffmpegBin: "ffmpeg",
|
|
119
|
-
localBindHost: "127.0.0.1",
|
|
120
|
-
localPort: 9090
|
|
121
|
-
});
|
|
122
|
-
// No plan runs here: this is about the path that answers a request, and
|
|
123
|
-
// letting the plan run would spawn real encoders.
|
|
124
|
-
manager.encodeRuns.planEncodersNow = () => {};
|
|
125
|
-
manager.encodeRuns.planEncodersSoon = () => {};
|
|
126
|
-
const session = outputOn(manager, { id: SESSION_ID, key: OUTPUT_KEY });
|
|
127
|
-
const step = outputOn(manager, { id: STEP_ID, key: STEP_KEY, height: 540 });
|
|
128
|
-
const sound = outputOn(manager, { id: SOUND_ID, key: SOUND_KEY, audioOnly: true });
|
|
129
|
-
for (const consumerId of ["viewer-a", "viewer-b"]) {
|
|
130
|
-
manager.viewers.of(session, consumerId).moveTo(0);
|
|
131
|
-
}
|
|
132
|
-
for (const output of [step, sound]) {
|
|
133
|
-
manager.viewers.of(step === output ? step : sound, "viewer-a").moveTo(0);
|
|
134
|
-
}
|
|
135
|
-
return { manager, session, step, sound };
|
|
136
|
-
}
|
|
137
|
-
|
|
138
|
-
/**
|
|
139
|
-
* @param {object} manager
|
|
140
|
-
* @param {string} consumerId
|
|
141
|
-
* @param {string} sessionId
|
|
142
|
-
* @returns {Promise<{ kind: string }>}
|
|
143
|
-
*/
|
|
144
|
-
function holdFor(manager, consumerId, sessionId = SESSION_ID) {
|
|
145
|
-
return waitForSessionFile(manager.serving, sessionId, "segment-00000.mp4", {
|
|
146
|
-
holdMs: HOLD_MS,
|
|
147
|
-
consumerId
|
|
148
|
-
});
|
|
149
|
-
}
|
|
150
|
-
|
|
151
|
-
test("a seek frees the seeker's requests on every output they watch", async (t) => {
|
|
152
|
-
const { manager, session, step, sound } = filmWithThreeOutputs();
|
|
153
|
-
t.after(async () => {
|
|
154
|
-
await manager.lifecycle.disposeAll();
|
|
155
|
-
for (const output of [session, step, sound]) {
|
|
156
|
-
await rm(output.dirPath, { recursive: true, force: true });
|
|
157
|
-
}
|
|
158
|
-
});
|
|
159
|
-
|
|
160
|
-
const onPicture = holdFor(manager, "viewer-a");
|
|
161
|
-
const onStep = holdFor(manager, "viewer-a", STEP_ID);
|
|
162
|
-
const onSound = holdFor(manager, "viewer-a", SOUND_ID);
|
|
163
|
-
let stayed = "still held";
|
|
164
|
-
const stayer = holdFor(manager, "viewer-b").then((result) => {
|
|
165
|
-
stayed = result.kind;
|
|
166
|
-
return result;
|
|
167
|
-
});
|
|
168
|
-
// Every one of them must EXIST before the seek, or the check proves nothing.
|
|
169
|
-
await untilWaitsAreRegistered(manager, OUTPUT_KEY, 2);
|
|
170
|
-
await untilWaitsAreRegistered(manager, STEP_KEY, 1);
|
|
171
|
-
await untilWaitsAreRegistered(manager, SOUND_KEY, 1);
|
|
172
|
-
|
|
173
|
-
const startedAt = Date.now();
|
|
174
|
-
assert.equal(manager.viewerRequests.requestSeek(SESSION_ID, 50, "viewer-a"), true);
|
|
175
|
-
|
|
176
|
-
const released = await Promise.all([onPicture, onStep, onSound]);
|
|
177
|
-
const heldMs = Date.now() - startedAt;
|
|
178
|
-
|
|
179
|
-
for (const [index, answer] of released.entries()) {
|
|
180
|
-
assert.equal(
|
|
181
|
-
answer.kind,
|
|
182
|
-
"superseded",
|
|
183
|
-
`the request on output ${index} was made for a position its viewer has left`
|
|
184
|
-
);
|
|
185
|
-
}
|
|
186
|
-
assert.ok(heldMs < HOLD_MS / 2, `they were freed after ${heldMs}ms, which is the hold running out`);
|
|
187
|
-
|
|
188
|
-
// A grace before asserting that something did NOT happen: it can only ever
|
|
189
|
-
// pass too easily, never fail by luck.
|
|
190
|
-
await delay(300);
|
|
191
|
-
assert.equal(stayed, "still held", "the other viewer is where they were and still wants this segment");
|
|
192
|
-
void stayer;
|
|
193
|
-
});
|
|
194
|
-
|
|
195
|
-
test("the request that was kept is served when its segment appears", async (t) => {
|
|
196
|
-
const { manager, session, step, sound } = filmWithThreeOutputs();
|
|
197
|
-
t.after(async () => {
|
|
198
|
-
await manager.lifecycle.disposeAll();
|
|
199
|
-
for (const output of [session, step, sound]) {
|
|
200
|
-
await rm(output.dirPath, { recursive: true, force: true });
|
|
201
|
-
}
|
|
202
|
-
});
|
|
203
|
-
|
|
204
|
-
const seeker = holdFor(manager, "viewer-a");
|
|
205
|
-
const stayer = holdFor(manager, "viewer-b");
|
|
206
|
-
await untilWaitsAreRegistered(manager, OUTPUT_KEY, 2);
|
|
207
|
-
manager.viewerRequests.requestSeek(SESSION_ID, 50, "viewer-a");
|
|
208
|
-
assert.equal((await seeker).kind, "superseded");
|
|
209
|
-
|
|
210
|
-
// The piece the viewer who stayed was waiting for, written as a run writes
|
|
211
|
-
// it: under its served name, which is the whole of what says it is closed.
|
|
212
|
-
await writeFile(path.join(session.dirPath, fmp4Format.segmentFileName(0)), Buffer.alloc(256, 0x5a));
|
|
213
|
-
|
|
214
|
-
const answer = await stayer;
|
|
215
|
-
|
|
216
|
-
assert.equal(answer.kind, "file", `a wake is a re-check, not a cancellation — got ${answer.kind}`);
|
|
217
|
-
});
|
|
@@ -1,109 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @file Ask ffmpeg late enough that it lands where we meant.
|
|
3
|
-
*
|
|
4
|
-
* `fftools/ffmpeg_demux.c` moves an input seek back by `3*AV_TIME_BASE / 23` —
|
|
5
|
-
* 130.435 ms — whenever the container does not declare `AVFMT_SEEK_TO_PTS` and
|
|
6
|
-
* a stream carries B-frames. So asking for a keyframe lands on the one before
|
|
7
|
-
* it, and since `-segment_times` is measured from where the run really began,
|
|
8
|
-
* every cut of that run inherits the shift.
|
|
9
|
-
*
|
|
10
|
-
* Measured 2026-08-21 on Matroska with keyframes every 2 s: `-ss 10` produced a
|
|
11
|
-
* first segment starting at 8.000, `-ss 10.130435` one starting at 10.000. On
|
|
12
|
-
* MP4, where the heuristic does not fire, 10, 10.130435 and 10.2 all produced
|
|
13
|
-
* 10.000 — right in one case, harmless in the other.
|
|
14
|
-
*/
|
|
15
|
-
|
|
16
|
-
import assert from "node:assert/strict";
|
|
17
|
-
import { KeyframeTable } from "../services/media/container/KeyframeTable.js";
|
|
18
|
-
import test from "node:test";
|
|
19
|
-
|
|
20
|
-
import { seekLandingOffsetFor } from "../services/encode/run-command.js";
|
|
21
|
-
|
|
22
|
-
const OFFSET = 3 / 23;
|
|
23
|
-
|
|
24
|
-
test("a copied picture is asked for one heuristic later than the keyframe", () => {
|
|
25
|
-
const session = { transcodeVideo: false, keyframes: new KeyframeTable().learn({ times: [0, 2.002, 4.004, 6.006] }) };
|
|
26
|
-
assert.equal(seekLandingOffsetFor(session, 2.002), OFFSET);
|
|
27
|
-
});
|
|
28
|
-
|
|
29
|
-
test("a re-encode is asked for exactly what it should produce", () => {
|
|
30
|
-
// It decodes from the keyframe and discards frames up to the requested time,
|
|
31
|
-
// so pushing the request later would start its output late.
|
|
32
|
-
const session = { transcodeVideo: true, keyframes: new KeyframeTable().learn({ times: [0, 2.002, 4.004] }) };
|
|
33
|
-
assert.equal(seekLandingOffsetFor(session, 2.002), 0);
|
|
34
|
-
});
|
|
35
|
-
|
|
36
|
-
test("the offset never reaches the next keyframe", () => {
|
|
37
|
-
// Keyframes 0.1 s apart: half of that is the most that can be added without
|
|
38
|
-
// risking a landing on the NEXT one where the heuristic does not fire.
|
|
39
|
-
const session = { transcodeVideo: false, keyframes: new KeyframeTable().learn({ times: [0, 0.1, 0.2, 0.3] }) };
|
|
40
|
-
assert.equal(seekLandingOffsetFor(session, 0.1), 0.05);
|
|
41
|
-
});
|
|
42
|
-
|
|
43
|
-
test("the last keyframe has nothing after it to collide with", () => {
|
|
44
|
-
const session = { transcodeVideo: false, keyframes: new KeyframeTable().learn({ times: [0, 2.002, 4.004] }) };
|
|
45
|
-
assert.equal(seekLandingOffsetFor(session, 4.004), OFFSET);
|
|
46
|
-
});
|
|
47
|
-
|
|
48
|
-
test("no keyframe list is still answered", () => {
|
|
49
|
-
assert.equal(seekLandingOffsetFor({ transcodeVideo: false }, 5), OFFSET);
|
|
50
|
-
assert.equal(seekLandingOffsetFor(null, 5), OFFSET);
|
|
51
|
-
});
|
|
52
|
-
|
|
53
|
-
test("a grid whose times are approximate is asked for that much later again", () => {
|
|
54
|
-
// AVI names a keyframe by its frame NUMBER and the time is that number times
|
|
55
|
-
// the frame duration, so a name can sit just BELOW the keyframe it refers to
|
|
56
|
-
// — measured 2026-08-21, 10-44 ms out on two files, always under one frame.
|
|
57
|
-
// Asking at the name alone would seek to before the real keyframe and land on
|
|
58
|
-
// the one before that, which is the fault this offset exists for.
|
|
59
|
-
const session = {
|
|
60
|
-
transcodeVideo: false,
|
|
61
|
-
keyframes: new KeyframeTable().learn({ times: [0, 4.004, 8.008, 12.012], tolerance: 0.04 })
|
|
62
|
-
};
|
|
63
|
-
assert.equal(seekLandingOffsetFor(session, 4.004), OFFSET + 0.04);
|
|
64
|
-
});
|
|
65
|
-
|
|
66
|
-
test("an exact grid claims no tolerance", () => {
|
|
67
|
-
// Matroska and MP4 state instants outright — measured the same day, nine
|
|
68
|
-
// files and 11 665 keyframes with not one disagreement.
|
|
69
|
-
const session = { transcodeVideo: false, keyframes: new KeyframeTable().learn({ times: [0, 4.004, 8.008], tolerance: 0 }) };
|
|
70
|
-
assert.equal(seekLandingOffsetFor(session, 4.004), OFFSET);
|
|
71
|
-
});
|
|
72
|
-
|
|
73
|
-
test("the bound still holds once a tolerance is added", () => {
|
|
74
|
-
const session = { transcodeVideo: false, keyframes: new KeyframeTable().learn({ times: [0, 0.1, 0.2], tolerance: 1 }) };
|
|
75
|
-
assert.equal(seekLandingOffsetFor(session, 0.1), 0.05);
|
|
76
|
-
});
|
|
77
|
-
|
|
78
|
-
test("an output carrying only sound is not pushed past what it asked for", () => {
|
|
79
|
-
// The field failure of 2026-09-06: the sound played 130 ms ahead of the
|
|
80
|
-
// picture from every restart onward, and the viewer saw lips out of step with
|
|
81
|
-
// the voice from two minutes in.
|
|
82
|
-
//
|
|
83
|
-
// The offset exists because ffmpeg's demuxer moves a seek target back for a
|
|
84
|
-
// container it reads in decode order, after which a COPY lands on the previous
|
|
85
|
-
// keyframe. A re-encode trims to the requested time itself and is excluded —
|
|
86
|
-
// and an output with no picture is exactly that, since its one track is
|
|
87
|
-
// `-c:a aac`. It was not excluded, because the test asked whether the PICTURE
|
|
88
|
-
// is re-encoded and an output with no picture answers no.
|
|
89
|
-
const soundtrack = {
|
|
90
|
-
audioOnly: true,
|
|
91
|
-
transcodeVideo: false,
|
|
92
|
-
keyframes: new KeyframeTable()
|
|
93
|
-
.learn({ times: [0, 4.004, 8.008, 12.012], tolerance: 0 })
|
|
94
|
-
};
|
|
95
|
-
assert.equal(seekLandingOffsetFor(soundtrack, 4.004), 0);
|
|
96
|
-
});
|
|
97
|
-
|
|
98
|
-
test("the picture of the same film still gets the offset", () => {
|
|
99
|
-
// The pair to the check above: the two outputs are repositioned to one
|
|
100
|
-
// boundary and must be given DIFFERENT requests, because one is copied and one
|
|
101
|
-
// is re-encoded. Given the same request they land 130 ms apart.
|
|
102
|
-
const picture = {
|
|
103
|
-
audioOnly: false,
|
|
104
|
-
transcodeVideo: false,
|
|
105
|
-
keyframes: new KeyframeTable()
|
|
106
|
-
.learn({ times: [0, 4.004, 8.008, 12.012], tolerance: 0 })
|
|
107
|
-
};
|
|
108
|
-
assert.equal(seekLandingOffsetFor(picture, 4.004), OFFSET);
|
|
109
|
-
});
|
|
@@ -1,195 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @file The segment the viewer just seeked TO must not be refused as stale.
|
|
3
|
-
*
|
|
4
|
-
* A seek bumps the wait epoch so that requests made for the position being left
|
|
5
|
-
* stop being held. The request for the position being ARRIVED at races that
|
|
6
|
-
* bump: hls.js asks for the new segment within milliseconds, and if the epoch
|
|
7
|
-
* moves underneath it, the epoch check alone cannot tell the two apart.
|
|
8
|
-
*
|
|
9
|
-
* Measured 2026-08-18: the viewer seeked to 1061.0 s, `segment-00101` — the
|
|
10
|
-
* segment at that very position — was answered 503 twice within 80 ms, the
|
|
11
|
-
* player never asked for it again, and instead looped `a/0/segment-00103` and
|
|
12
|
-
* `a/0/segment-00104` 737 and 736 times over 149 seconds while the picture
|
|
13
|
-
* stood at `t=1061.0s readyState=1`. The session ended without another frame.
|
|
14
|
-
*/
|
|
15
|
-
|
|
16
|
-
import test from "node:test";
|
|
17
|
-
import assert from "node:assert/strict";
|
|
18
|
-
import { SourceFile } from "../services/media/SourceFile.js";
|
|
19
|
-
import { Timeline } from "../services/encode/output/Timeline.js";
|
|
20
|
-
import { mkdtemp, rm } from "node:fs/promises";
|
|
21
|
-
import os from "node:os";
|
|
22
|
-
import path from "node:path";
|
|
23
|
-
import { wireOutputs } from "../services/server/wire-outputs.js";
|
|
24
|
-
import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
|
|
25
|
-
|
|
26
|
-
const SESSION_ID = "aaaaaaaa11112222";
|
|
27
|
-
const SEGMENT_SECONDS = 10.4;
|
|
28
|
-
const SEEK_TO_SECONDS = 1061;
|
|
29
|
-
const SEGMENT_AT_SEEK = Math.floor(SEEK_TO_SECONDS / SEGMENT_SECONDS);
|
|
30
|
-
|
|
31
|
-
/**
|
|
32
|
-
* A session whose viewer has just landed at {@link SEEK_TO_SECONDS}.
|
|
33
|
-
*
|
|
34
|
-
* @returns {Promise<{ manager: object, dirPath: string }>}
|
|
35
|
-
*/
|
|
36
|
-
async function managerAfterSeek() {
|
|
37
|
-
const dirPath = await mkdtemp(path.join(os.tmpdir(), "seek-target-"));
|
|
38
|
-
const manager = wireOutputs({
|
|
39
|
-
enabled: true,
|
|
40
|
-
ffmpegBin: "ffmpeg",
|
|
41
|
-
localBindHost: "127.0.0.1",
|
|
42
|
-
localPort: 9090
|
|
43
|
-
});
|
|
44
|
-
const session = {
|
|
45
|
-
id: SESSION_ID,
|
|
46
|
-
dirPath,
|
|
47
|
-
// Where this file is cut, held by the file. A fixture that stated it
|
|
48
|
-
// on the session was describing what production no longer does.
|
|
49
|
-
timeline: new Timeline({
|
|
50
|
-
boundaries: Array.from({ length: 400 }, (_, index) => index * SEGMENT_SECONDS),
|
|
51
|
-
cutGrid: "uniform"
|
|
52
|
-
}),
|
|
53
|
-
state: "ready",
|
|
54
|
-
file: new SourceFile({ sourceKey: "source-1", fileIndex: 0, name: "film.mkv" }),
|
|
55
|
-
// An ordinary session reads its own file, and its sound is inside it. The
|
|
56
|
-
// three differ only for a soundtrack shipped as a file of its own.
|
|
57
|
-
get inputFile() { return this.file; },
|
|
58
|
-
get audioFile() { return this.file; },
|
|
59
|
-
startedAt: Date.now(),
|
|
60
|
-
lastAccessedAt: Date.now(),
|
|
61
|
-
consumers: new Set(),
|
|
62
|
-
segmentFormat: fmp4Format,
|
|
63
|
-
transcodeVideo: false,
|
|
64
|
-
useSyntheticPlaylist: true,
|
|
65
|
-
segmentCount: 399,
|
|
66
|
-
encodeStartIndex: SEGMENT_AT_SEEK,
|
|
67
|
-
waitEpoch: 1,
|
|
68
|
-
runState: "PRODUCING"
|
|
69
|
-
};
|
|
70
|
-
manager.outputs.set(SESSION_ID, session);
|
|
71
|
-
manager.viewers.of(session, "viewer").moveTo(SEEK_TO_SECONDS);
|
|
72
|
-
manager.viewers.of(session, "viewer").playing = false;
|
|
73
|
-
return { manager, dirPath };
|
|
74
|
-
}
|
|
75
|
-
|
|
76
|
-
test("the segment at the seek target is still wanted", async () => {
|
|
77
|
-
const { manager, dirPath } = await managerAfterSeek();
|
|
78
|
-
|
|
79
|
-
assert.equal(
|
|
80
|
-
manager.serving.requestStillWanted(SESSION_ID, `segment-${String(SEGMENT_AT_SEEK).padStart(5, "0")}.mp4`),
|
|
81
|
-
true,
|
|
82
|
-
"this is the segment the viewer is waiting for; refusing it is what froze the field session"
|
|
83
|
-
);
|
|
84
|
-
|
|
85
|
-
await rm(dirPath, { recursive: true, force: true });
|
|
86
|
-
});
|
|
87
|
-
|
|
88
|
-
test("a segment behind the viewer is not wanted any more", async () => {
|
|
89
|
-
const { manager, dirPath } = await managerAfterSeek();
|
|
90
|
-
|
|
91
|
-
assert.equal(
|
|
92
|
-
manager.serving.requestStillWanted(SESSION_ID, `segment-${String(SEGMENT_AT_SEEK - 3).padStart(5, "0")}.mp4`),
|
|
93
|
-
false,
|
|
94
|
-
"a request for the position the viewer left is exactly what the epoch exists to release"
|
|
95
|
-
);
|
|
96
|
-
|
|
97
|
-
await rm(dirPath, { recursive: true, force: true });
|
|
98
|
-
});
|
|
99
|
-
|
|
100
|
-
test("a segment far beyond what the run will reach is not wanted", async () => {
|
|
101
|
-
const { manager, dirPath } = await managerAfterSeek();
|
|
102
|
-
|
|
103
|
-
assert.equal(
|
|
104
|
-
manager.serving.requestStillWanted(SESSION_ID, `segment-${String(SEGMENT_AT_SEEK + 200).padStart(5, "0")}.mp4`),
|
|
105
|
-
false,
|
|
106
|
-
"nothing will produce it before the viewer moves again"
|
|
107
|
-
);
|
|
108
|
-
|
|
109
|
-
await rm(dirPath, { recursive: true, force: true });
|
|
110
|
-
});
|
|
111
|
-
|
|
112
|
-
test("a playlist belongs to no position and is never stale", async () => {
|
|
113
|
-
const { manager, dirPath } = await managerAfterSeek();
|
|
114
|
-
|
|
115
|
-
assert.equal(manager.serving.requestStillWanted(SESSION_ID, "index.m3u8"), true);
|
|
116
|
-
assert.equal(manager.serving.requestStillWanted(SESSION_ID, "init.mp4"), true);
|
|
117
|
-
|
|
118
|
-
await rm(dirPath, { recursive: true, force: true });
|
|
119
|
-
});
|
|
120
|
-
|
|
121
|
-
test("a request as deep as the cushion the browser is told to hold is still wanted", async () => {
|
|
122
|
-
const { manager, dirPath } = await managerAfterSeek();
|
|
123
|
-
|
|
124
|
-
// The browser sizes its forward buffer from the proxy's own look-ahead, so
|
|
125
|
-
// the deepest request it can make is one for the segment at the far edge of
|
|
126
|
-
// that cushion. Refusing it would be refusing the very depth this proxy
|
|
127
|
-
// asked for: at the old width — eight segments ahead of the viewer — three
|
|
128
|
-
// quarters of a full cushion's requests were stale by definition.
|
|
129
|
-
const edge = Math.floor((SEEK_TO_SECONDS + manager.lookaheadSeconds) / SEGMENT_SECONDS);
|
|
130
|
-
|
|
131
|
-
assert.ok(edge - SEGMENT_AT_SEEK > 8, "the case only exists past the old eight-segment width");
|
|
132
|
-
assert.equal(
|
|
133
|
-
manager.serving.requestStillWanted(SESSION_ID, `segment-${String(edge).padStart(5, "0")}.mp4`),
|
|
134
|
-
true,
|
|
135
|
-
"the far edge of the cushion the proxy itself keeps produced"
|
|
136
|
-
);
|
|
137
|
-
|
|
138
|
-
await rm(dirPath, { recursive: true, force: true });
|
|
139
|
-
});
|
|
140
|
-
|
|
141
|
-
test("the viewer who made the request is the one it is judged against", async () => {
|
|
142
|
-
const { manager, dirPath } = await managerAfterSeek();
|
|
143
|
-
const session = manager.outputs.get(SESSION_ID);
|
|
144
|
-
session.viewers = new Map();
|
|
145
|
-
// Two people watching one copied picture: one at the seek target, one a
|
|
146
|
-
// hundred segments back and waiting for a segment there. Asked about nobody
|
|
147
|
-
// in particular the answer is the FURTHEST of them, because what lies behind
|
|
148
|
-
// that one has already been made.
|
|
149
|
-
const behind = SEGMENT_AT_SEEK - 100;
|
|
150
|
-
manager.viewers.of(session, "behind").moveTo(behind * SEGMENT_SECONDS);
|
|
151
|
-
manager.viewers.of(session, "behind").playing = false;
|
|
152
|
-
manager.viewers.of(session, "ahead").moveTo(SEEK_TO_SECONDS);
|
|
153
|
-
manager.viewers.of(session, "ahead").playing = false;
|
|
154
|
-
|
|
155
|
-
assert.equal(
|
|
156
|
-
manager.serving.requestStillWanted(SESSION_ID, `segment-${String(behind).padStart(5, "0")}.mp4`, "behind"),
|
|
157
|
-
true,
|
|
158
|
-
"held for the viewer who is there, whatever the viewer in front is doing"
|
|
159
|
-
);
|
|
160
|
-
assert.equal(
|
|
161
|
-
manager.serving.requestStillWanted(SESSION_ID, `segment-${String(behind).padStart(5, "0")}.mp4`),
|
|
162
|
-
false,
|
|
163
|
-
"unnamed, it is judged against the furthest viewer, which is the leader"
|
|
164
|
-
);
|
|
165
|
-
|
|
166
|
-
await rm(dirPath, { recursive: true, force: true });
|
|
167
|
-
});
|
|
168
|
-
|
|
169
|
-
test("a seek moves the seeking viewer's own head, and nobody else's", async () => {
|
|
170
|
-
const { manager, dirPath } = await managerAfterSeek();
|
|
171
|
-
const session = manager.outputs.get(SESSION_ID);
|
|
172
|
-
session.viewers = new Map();
|
|
173
|
-
const staying = SEGMENT_AT_SEEK - 40;
|
|
174
|
-
manager.viewers.of(session, "staying").position = {
|
|
175
|
-
segment: staying,
|
|
176
|
-
seconds: staying * SEGMENT_SECONDS,
|
|
177
|
-
at: Date.now()
|
|
178
|
-
};
|
|
179
|
-
|
|
180
|
-
const jumpTo = 120;
|
|
181
|
-
manager.viewerRequests.requestSeek(SESSION_ID, jumpTo, "jumping");
|
|
182
|
-
|
|
183
|
-
assert.equal(
|
|
184
|
-
manager.serving.requestStillWanted(SESSION_ID, `segment-${String(Math.floor(jumpTo / SEGMENT_SECONDS)).padStart(5, "0")}.mp4`, "jumping"),
|
|
185
|
-
true,
|
|
186
|
-
"the segment at the seek target — the request that raced the epoch in 2026-08-18"
|
|
187
|
-
);
|
|
188
|
-
assert.equal(
|
|
189
|
-
manager.serving.requestStillWanted(SESSION_ID, `segment-${String(staying).padStart(5, "0")}.mp4`, "staying"),
|
|
190
|
-
true,
|
|
191
|
-
"somebody else's seek does not move where this viewer is"
|
|
192
|
-
);
|
|
193
|
-
|
|
194
|
-
await rm(dirPath, { recursive: true, force: true });
|
|
195
|
-
});
|
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @file A piece is closed by one of two writers, and both must say so.
|
|
3
|
-
*
|
|
4
|
-
* The `segment` muxer writes under a working name and reports the closure on a
|
|
5
|
-
* channel of its own, which reaches `SegmentStore.publish`. The `hls` muxer
|
|
6
|
-
* writes through a temporary name of its own (`+temp_file`) and reports
|
|
7
|
-
* nothing: the file simply appears under the name it is served as. That branch
|
|
8
|
-
* is taken by every re-encoded output cut on the even grid — an ordinary
|
|
9
|
-
* quality step — and for it a wait could only end on its deadline, so a segment
|
|
10
|
-
* lying finished on disk was answered 503 after the whole hold.
|
|
11
|
-
*/
|
|
12
|
-
|
|
13
|
-
import test from "node:test";
|
|
14
|
-
import assert from "node:assert/strict";
|
|
15
|
-
import { mkdtempSync, renameSync, rmSync, writeFileSync } from "node:fs";
|
|
16
|
-
import os from "node:os";
|
|
17
|
-
import path from "node:path";
|
|
18
|
-
import { SegmentStore } from "../services/storage/segment-store/SegmentStore.js";
|
|
19
|
-
import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
|
|
20
|
-
|
|
21
|
-
const KEY = "torrent:abc:fmt=fmp4:grid=uniform@0:video-only:v=libx264/854x480";
|
|
22
|
-
|
|
23
|
-
/** A deadline is the backstop of these waits, never what they measure. */
|
|
24
|
-
const BACKSTOP_MS = 10_000;
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* @returns {{ store: SegmentStore, root: string }}
|
|
28
|
-
*/
|
|
29
|
-
function storeInATempRoot() {
|
|
30
|
-
const root = mkdtempSync(path.join(os.tmpdir(), "segment-closed-"));
|
|
31
|
-
const store = new SegmentStore({ root, logger: { info: () => {}, warn: () => {} } });
|
|
32
|
-
store.useFormat(KEY, fmp4Format);
|
|
33
|
-
return { store, root };
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
test("a piece that simply appears ends the wait that began before it", async (t) => {
|
|
37
|
-
const { store, root } = storeInATempRoot();
|
|
38
|
-
t.after(() => {
|
|
39
|
-
store.dropAll("the test is over");
|
|
40
|
-
rmSync(root, { recursive: true, force: true });
|
|
41
|
-
});
|
|
42
|
-
|
|
43
|
-
const dir = store.directoryFor(KEY);
|
|
44
|
-
// The wait begins on a segment nobody has written yet — the cold case, and
|
|
45
|
-
// the only one the deadline used to decide.
|
|
46
|
-
const waited = store.waitFor(KEY, 7, BACKSTOP_MS);
|
|
47
|
-
|
|
48
|
-
// What the `hls` muxer does: a temporary name of its own, renamed into place
|
|
49
|
-
// when the piece is whole. Nothing is told; the directory simply moves.
|
|
50
|
-
const temp = path.join(dir, "segment-00007.mp4.tmp");
|
|
51
|
-
writeFileSync(temp, Buffer.alloc(64));
|
|
52
|
-
renameSync(temp, path.join(dir, fmp4Format.segmentFileName(7)));
|
|
53
|
-
|
|
54
|
-
assert.equal(await waited, true, "the piece was on disk and the wait did not end");
|
|
55
|
-
assert.ok(store.pathOf(KEY, 7), "and the store must be able to hand it over");
|
|
56
|
-
});
|
|
57
|
-
|
|
58
|
-
test("clearing up after a run is not its pieces arriving", async (t) => {
|
|
59
|
-
const { store, root } = storeInATempRoot();
|
|
60
|
-
t.after(() => {
|
|
61
|
-
store.dropAll("the test is over");
|
|
62
|
-
rmSync(root, { recursive: true, force: true });
|
|
63
|
-
});
|
|
64
|
-
|
|
65
|
-
const dir = store.directoryFor(KEY);
|
|
66
|
-
const unfinished = path.join(dir, fmp4Format.makingFileNameTemplate("3").replace("%05d", "00009"));
|
|
67
|
-
writeFileSync(unfinished, Buffer.alloc(64));
|
|
68
|
-
|
|
69
|
-
let ended = false;
|
|
70
|
-
// 200 ms is a grace before asserting that something did NOT happen, which can
|
|
71
|
-
// only ever pass too easily — never a measurement.
|
|
72
|
-
const waited = store.waitFor(KEY, 9, 200).then((value) => {
|
|
73
|
-
ended = value;
|
|
74
|
-
return value;
|
|
75
|
-
});
|
|
76
|
-
rmSync(unfinished, { force: true });
|
|
77
|
-
|
|
78
|
-
assert.equal(await waited, false, "a directory that moved because a file went holds nothing new");
|
|
79
|
-
assert.equal(ended, false);
|
|
80
|
-
});
|
|
81
|
-
|
|
82
|
-
test("the writer that does report a closure is unaffected", async (t) => {
|
|
83
|
-
const { store, root } = storeInATempRoot();
|
|
84
|
-
t.after(() => {
|
|
85
|
-
store.dropAll("the test is over");
|
|
86
|
-
rmSync(root, { recursive: true, force: true });
|
|
87
|
-
});
|
|
88
|
-
|
|
89
|
-
const dir = store.directoryFor(KEY);
|
|
90
|
-
const making = fmp4Format.makingFileNameTemplate("4").replace("%05d", "00004");
|
|
91
|
-
writeFileSync(path.join(dir, making), Buffer.alloc(64));
|
|
92
|
-
|
|
93
|
-
const waited = store.waitFor(KEY, 4, BACKSTOP_MS);
|
|
94
|
-
assert.equal(store.publish(KEY, making, fmp4Format), fmp4Format.segmentFileName(4));
|
|
95
|
-
assert.equal(await waited, true);
|
|
96
|
-
});
|
|
97
|
-
|
|
98
|
-
test("a directory removed from outside and made again is watched again", async (t) => {
|
|
99
|
-
const { store, root } = storeInATempRoot();
|
|
100
|
-
t.after(() => {
|
|
101
|
-
store.dropAll("the test is over");
|
|
102
|
-
rmSync(root, { recursive: true, force: true });
|
|
103
|
-
});
|
|
104
|
-
|
|
105
|
-
// Removed by something other than the store, so its watch was not stopped
|
|
106
|
-
// first. The watch held on that path watches a directory that is gone.
|
|
107
|
-
rmSync(store.directoryFor(KEY), { recursive: true, force: true });
|
|
108
|
-
const dir = store.directoryFor(KEY);
|
|
109
|
-
const waited = store.waitFor(KEY, 3, BACKSTOP_MS);
|
|
110
|
-
|
|
111
|
-
writeFileSync(path.join(dir, fmp4Format.segmentFileName(3)), Buffer.alloc(64));
|
|
112
|
-
|
|
113
|
-
assert.equal(await waited, true, "the piece arrived in the new directory and the wait did not end");
|
|
114
|
-
});
|