@torrent-tv/proxy 2.85.1 → 2.87.0

package/services/viewer/positions.js

@@ -1,120 +1,126 @@
-/**
- * @file Where the viewers of one output stand.
- *
- * Asked by whatever has to give disk back: what lies behind every viewer has
- * been played and will not be wanted again unless somebody seeks back, and what
- * lies ahead of the furthest will be wanted eventually. So an answer of "nobody"
- * is the strongest statement there is — everything that output holds is worth
- * less than anything anybody is on their way to.
- *
- * Pure: it is handed the sessions, the clock and a way to turn seconds into a
- * segment number, and it holds none of them.
- */
-
-import { viewersOf } from "./Viewer.js";
-
-/**
- * @param {object} params
- * @param {Iterable<{ outputKey?: string }>} params.sessions - Every live session.
- * @param {string} params.outputKey - The output being asked about.
- * @param {(session: object, seconds: number) => number} params.segmentAt - Which
- *   segment of THAT session's timeline a moment of film falls in.
- * @param {number} params.now
- * @returns {number[]} A segment number per present viewer, unsorted.
- */
-export function viewerSegmentsOn({ sessions, outputKey, segmentAt, now }) {
-  const at = [];
-  for (const session of sessions) {
-    if (session.outputKey !== outputKey) {
-      continue;
-    }
-    for (const viewer of viewersOf(session).values()) {
-      if (!viewer.isPresent()) {
-        continue;
-      }
-      const seconds = viewer.positionSeconds(now);
-      if (!Number.isFinite(seconds)) {
-        continue;
-      }
-      const index = segmentAt(session, /** @type {number} */ (seconds));
-      if (Number.isInteger(index) && index >= 0) {
-        at.push(index);
-      }
-    }
-  }
-  return at;
-}
-
-/**
- * Where a viewer of one output is, in seconds of film, NOW.
- *
- * One reading with one owner, and a function of time rather than a stored
- * number: a viewer states where their picture is, and the clock carries it
- * forward between statements.
- *
- * Three readings ranked by priority used to answer this — a seek, the start of
- * the last segment requested, the position the output was opened at — with a
- * second function saying which had answered. They were three different
- * quantities wearing one name, two of them written at different rates, so the
- * answer alternated between them several times a second and every encoder
- * followed it.
- *
- * Without a name, the FURTHEST viewer: what lies behind them has already been
- * made, so that is what a reading about no particular person wants. With
- * nobody present at all, where the output was opened.
- *
- * @param {object} session
- * @param {string} [consumerId] - Whose position.
- * @param {number} [now]
- * @returns {number} Seconds, never negative.
- */
-export function viewerSecondsOn(session, consumerId = "", now = Date.now()) {
-  const named = consumerId ? session?.viewers?.get(consumerId) ?? null : null;
-  if (named) {
-    return Math.max(0, named.positionSeconds(now) ?? 0);
-  }
-  let furthest = null;
-  for (const viewer of viewersOf(session).values()) {
-    if (!viewer.isPresent()) {
-      continue;
-    }
-    const seconds = viewer.positionSeconds(now);
-    if (Number.isFinite(seconds)) {
-      furthest = furthest === null ? seconds : Math.max(furthest, seconds);
-    }
-  }
-  const opened = Number(session?.progress?.startPositionSeconds);
-  return Math.max(0, furthest ?? (Number.isFinite(opened) ? opened : 0));
-}
-
-/**
- * The earliest film anybody present is standing on, across several outputs.
- *
- * WHAT IT IS FOR: a soundtrack is created at a position, and a track begun
- * where the leader stands has nothing to give the viewer behind them. So the
- * earliest, and across every rung of the picture, because two viewers of one
- * film may be on different ones.
- *
- * This is a fact about PEOPLE and it decides one parameter of an output. It
- * does not place encoders: which encoder works where is the priority map's
- * answer and nothing here is consulted for it.
- *
- * @param {Iterable<object>} sessions
- * @param {number} [now]
- * @returns {number | null} Seconds, or null when nobody is present.
- */
-export function earliestViewerSecondsOn(sessions, now = Date.now()) {
-  let earliest = null;
-  for (const session of sessions ?? []) {
-    for (const viewer of viewersOf(session).values()) {
-      if (!viewer.isPresent()) {
-        continue;
-      }
-      const seconds = viewer.positionSeconds(now);
-      if (Number.isFinite(seconds)) {
-        earliest = earliest === null ? seconds : Math.min(earliest, seconds);
-      }
-    }
-  }
-  return earliest;
-}
+/**
+ * @file Where the viewers of one output stand.
+ *
+ * Asked by whatever has to give disk back: what lies behind every viewer has
+ * been played and will not be wanted again unless somebody seeks back, and what
+ * lies ahead of the furthest will be wanted eventually. So an answer of "nobody"
+ * is the strongest statement there is — everything that output holds is worth
+ * less than anything anybody is on their way to.
+ *
+ * Pure: it is handed the outputs, the clock and a way to turn seconds into a
+ * segment number, and it holds none of them.
+ */
+
+/**
+ * @param {object} params
+ * @param {Iterable<{ outputKey?: string }>} params.outputs - Every live output.
+ * @param {string} params.outputKey - The output being asked about.
+ * @param {(session: object, seconds: number) => number} params.segmentAt - Which
+ *   segment of THAT session's timeline a moment of film falls in.
+ * @param {number} params.now
+ * @param {{ forOutput: (output: object) => Map<string, object> }} params.viewers - The registry that
+ *   holds who watches what.
+ * @returns {number[]} A segment number per present viewer, unsorted.
+ */
+export function viewerSegmentsOn({ outputs, outputKey, segmentAt, now, viewers }) {
+  const at = [];
+  for (const session of outputs) {
+    if (session.outputKey !== outputKey) {
+      continue;
+    }
+    for (const viewer of viewers.forOutput(session).values()) {
+      if (!viewer.isPresent()) {
+        continue;
+      }
+      const seconds = viewer.positionSeconds(now);
+      if (!Number.isFinite(seconds)) {
+        continue;
+      }
+      const index = segmentAt(session, /** @type {number} */ (seconds));
+      if (Number.isInteger(index) && index >= 0) {
+        at.push(index);
+      }
+    }
+  }
+  return at;
+}
+
+/**
+ * Where a viewer of one output is, in seconds of film, NOW.
+ *
+ * One reading with one owner, and a function of time rather than a stored
+ * number: a viewer states where their picture is, and the clock carries it
+ * forward between statements.
+ *
+ * Three readings ranked by priority used to answer this — a seek, the start of
+ * the last segment requested, the position the output was opened at — with a
+ * second function saying which had answered. They were three different
+ * quantities wearing one name, two of them written at different rates, so the
+ * answer alternated between them several times a second and every encoder
+ * followed it.
+ *
+ * Without a name, the FURTHEST viewer: what lies behind them has already been
+ * made, so that is what a reading about no particular person wants. With
+ * nobody present at all, zero. Creation registers the requesting viewer and
+ * their initial position before any encoder is planned.
+ *
+ * @param {{ forOutput: (output: object) => Map<string, object> }} viewers - The registry.
+ * @param {object} session
+ * @param {string} [consumerId] - Whose position.
+ * @param {number} [now]
+ * @returns {number} Seconds, never negative.
+ */
+export function viewerSecondsOn(viewers, session, consumerId = "", now = Date.now()) {
+  if (!session) {
+    return 0;
+  }
+  const watching = viewers.forOutput(session);
+  const named = watching.get(consumerId) ?? null;
+  if (named) {
+    return Math.max(0, named.positionSeconds(now) ?? 0);
+  }
+  let furthest = null;
+  for (const viewer of watching.values()) {
+    if (!viewer.isPresent()) {
+      continue;
+    }
+    const seconds = viewer.positionSeconds(now);
+    if (Number.isFinite(seconds)) {
+      furthest = furthest === null ? seconds : Math.max(furthest, seconds);
+    }
+  }
+  return Math.max(0, furthest ?? 0);
+}
+
+/**
+ * The earliest film anybody present is standing on, across several outputs.
+ *
+ * WHAT IT IS FOR: a soundtrack is created at a position, and a track begun
+ * where the leader stands has nothing to give the viewer behind them. So the
+ * earliest, and across every rung of the picture, because two viewers of one
+ * film may be on different ones.
+ *
+ * This is a fact about PEOPLE and it decides one parameter of an output. It
+ * does not place encoders: which encoder works where is the priority map's
+ * answer and nothing here is consulted for it.
+ *
+ * @param {{ forOutput: (output: object) => Map<string, object> }} viewers - The registry.
+ * @param {Iterable<object>} sessions
+ * @param {number} [now]
+ * @returns {number | null} Seconds, or null when nobody is present.
+ */
+export function earliestViewerSecondsOn(viewers, sessions, now = Date.now()) {
+  let earliest = null;
+  for (const session of sessions ?? []) {
+    for (const viewer of viewers.forOutput(session).values()) {
+      if (!viewer.isPresent()) {
+        continue;
+      }
+      const seconds = viewer.positionSeconds(now);
+      if (Number.isFinite(seconds)) {
+        earliest = earliest === null ? seconds : Math.min(earliest, seconds);
+      }
+    }
+  }
+  return earliest;
+}

package/services/viewer/report-intake.js

@@ -1,44 +1,46 @@
-/**
- * @file A viewer's statement about itself, taken in.
- *
- * The VIEWER layer's own entry point, and the whole of what happens when a page
- * says where it is: the output the reporter has on screen is resolved, the
- * statement reaches the person it is about, and readings that have gone stale
- * stop deciding for the people still here.
- *
- * It lived in the session manager, which is a description of an OUTPUT, and the
- * two questions were tangled there: whether this is a measurement of a LINK,
- * and whether this is a statement by a VIEWER. Required to be both, a page that
- * had measured nothing could say nothing — see `Viewer.report`.
- *
- * Given the sessions and the registry as plain values, so nothing here knows
- * how a session is found, what a variant is, or that there is an encoder.
- */
-
-import { activeOutputFor } from "./active-output.js";
-
-/**
- * Take one report from one viewer.
- *
- * @param {object} params
- * @param {{ get: (id: string) => object | undefined }} params.sessions - Every live session, by id.
- * @param {{ of: (session: object, consumerId: string) => import("./Viewer.js").Viewer }} params.viewers
- * @param {string} params.sessionId - The session the page addresses, which is
- *   always the picture's: the browser is not told which rung it is on.
- * @param {object} params.report - What they said about themselves.
- * @param {number} [params.now]
- * @returns {boolean} False when no such session is live, which is the page
- *   reporting into one that has been disposed.
- */
-export function recordViewerReport({ sessions, viewers, sessionId, report, now = Date.now() }) {
-  const named = sessions.get(sessionId);
-  if (!named || named.state === "disposed") {
-    return false;
-  }
-  const consumerId = typeof report?.consumerId === "string" ? report.consumerId : "";
-  // The stream on screen is the reporter's own: with two viewers on two rungs,
-  // one report says nothing about the other's encoder.
-  const session = activeOutputFor({ base: named, consumerId, sessions, viewers });
-  viewers.of(session, consumerId).report(report, now);
-  return true;
-}
+/**
+ * @file A viewer's statement about itself, taken in.
+ *
+ * The VIEWER layer's own entry point, and the whole of what happens when a page
+ * says where it is: the output the reporter has on screen is resolved, and the
+ * statement reaches the person it is about. Nothing expires here — a link
+ * reading is the last thing known about that link, and whether it is still
+ * somebody's is presence's answer (`Viewer.linkReading`).
+ *
+ * It lived in the session manager, which is a description of an OUTPUT, and the
+ * two questions were tangled there: whether this is a measurement of a LINK,
+ * and whether this is a statement by a VIEWER. Required to be both, a page that
+ * had measured nothing could say nothing — see `Viewer.report`.
+ *
+ * Given the outputs and the viewer registry as plain values, so nothing here
+ * knows how an output is found, what a variant is, or that there is an encoder.
+ */
+
+import { activeOutputFor } from "./active-output.js";
+
+/**
+ * Take one report from one viewer.
+ *
+ * @param {object} params
+ * @param {{ get: (id: string) => object | undefined }} params.outputs - Every live output, by id.
+ * @param {{ of: (session: object, consumerId: string) => import("./Viewer.js").Viewer }} params.viewers
+ * @param {string} params.sessionId - The session the page addresses, which is
+ *   always the picture's: the browser is not told which rung it is on.
+ * @param {object} params.report - What they said about themselves.
+ * @param {number} [params.now]
+ * @returns {boolean} False when no such session is live, which is the page
+ *   reporting into one that has been disposed.
+ */
+export function recordViewerReport({ outputs, viewers, sessionId, report, now = Date.now() }) {
+  const named = outputs.get(sessionId);
+  const consumerId = typeof report?.consumerId === "string" ? report.consumerId : "";
+  // A report that names nobody is a reading of nobody's link.
+  if (!named || !consumerId) {
+    return false;
+  }
+  // The stream on screen is the reporter's own: with two viewers on two rungs,
+  // one report says nothing about the other's encoder.
+  const session = activeOutputFor({ base: named, consumerId, outputs, viewers });
+  viewers.of(session, consumerId).report(report, now);
+  return true;
+}

package/test/asset-paths.test.js

@@ -0,0 +1,28 @@
+/**
+ * @file Paths a module builds from its own location still name what they meant.
+ *
+ * A file that joins `..` onto its own directory is right only at the depth it
+ * was written at. Moving files into their components (2.87.0) left the gdb
+ * script of the usrsctp reader pointing one directory short, and no check
+ * noticed: the path is read only when a wedge is diagnosed.
+ */
+
+import test from "node:test";
+import assert from "node:assert/strict";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { CALIBRATION_DIR } from "../services/encode/hwaccel.js";
+import { PROXY_ROOT } from "../services/encode/quality/HostTimings.js";
+import { SCTPSTATE_SCRIPT_PATH } from "../services/transport/usrsctp-state.js";
+
+test("the calibration clips are where the benchmark looks", () => {
+  assert.ok(existsSync(CALIBRATION_DIR), CALIBRATION_DIR);
+});
+
+test("the usrsctp state script is where the reader looks", () => {
+  assert.ok(existsSync(SCTPSTATE_SCRIPT_PATH), SCTPSTATE_SCRIPT_PATH);
+});
+
+test("the default place for host timings is the proxy's own directory", () => {
+  assert.ok(existsSync(path.join(PROXY_ROOT, "package.json")), PROXY_ROOT);
+});

package/test/audio-inventory.test.js

@@ -15,14 +15,14 @@
  */
 
 import test from "node:test";
-import { Container } from "../services/container/Container.js";
-import { AudioTrack } from "../services/tracks/AudioTrack.js";
+import { Container } from "../services/media/container/Container.js";
+import { AudioTrack } from "../services/media/tracks/AudioTrack.js";
 import assert from "node:assert/strict";
 import {
   audioRenditionName,
   buildAudioInventory,
   resolveAudioIndex
-} from "../services/audio-inventory.js";
+} from "../services/media/audio-inventory.js";
 
 test("a pair agreeing on language is accepted", () => {
   assert.equal(Container.pairingHolds({ language: "jpn" }, { language: "jpn" }), true);

package/test/audio-track-bitrate.test.js

@@ -0,0 +1,40 @@
+/**
+ * @file The rate a copied soundtrack puts on a viewer's link is the rate the
+ * file states for THAT track — roadmap item 97, step 11.
+ *
+ * Not the first rate the banner prints and not the file's total: two tracks of
+ * one film can differ fivefold (a stereo AAC and a 5.1 AC3), and the viewer
+ * receives only the one they chose. Parsed text, no process.
+ */
+
+import test from "node:test";
+import assert from "node:assert/strict";
+import { parseStreamCodecs } from "../services/media/playback-planner.js";
+import { buildAudioInventory } from "../services/media/audio-inventory.js";
+
+const BANNER = [
+  "Input #0, matroska,webm, from 'http://127.0.0.1/stream':",
+  "  Duration: 01:30:00.00, start: 0.000000, bitrate: 9000 kb/s",
+  "  Stream #0:0: Video: h264 (High), yuv420p, 1920x1080, 24 fps (default)",
+  "  Stream #0:1(eng): Audio: aac (LC), 48000 Hz, stereo, fltp, 128 kb/s (default)",
+  "  Stream #0:2(rus): Audio: ac3, 48000 Hz, 5.1(side), fltp",
+  "    Metadata:",
+  "      title           : Dub",
+  "      BPS             : 640000",
+  "  Stream #0:3(fre): Audio: ac3, 48000 Hz, 5.1(side), fltp",
+  "At least one output file must be specified"
+].join("\n");
+
+test("each soundtrack carries its own stated rate, from its own line or its own statistics tag", () => {
+  const { audioTracks } = parseStreamCodecs(BANNER);
+
+  assert.deepEqual(audioTracks.map((track) => track.bitrateKbps), [128, 640, null]);
+  assert.notEqual(audioTracks[1].bitrateKbps, 9000, "never the file's total");
+});
+
+test("the inventory keeps each track's rate, so the chosen one can be priced", () => {
+  const { audioTracks } = parseStreamCodecs(BANNER);
+  const inventory = buildAudioInventory({ embedded: audioTracks, videoFileIndex: 0, sidecars: [] });
+
+  assert.deepEqual(inventory.map((entry) => entry.bitrateKbps), [128, 640, null]);
+});