@torrent-tv/proxy 2.70.0 → 2.71.0

package/services/demand/Window.js

@@ -0,0 +1,118 @@
+/**
+ * @file One stated need: bytes of one file, by one claimant, at one urgency.
+ *
+ * **Bytes, not pieces.** A piece is how the protocol verifies data and how
+ * memory is allocated; it is not the unit anything else should count in.
+ * Counting in pieces means dividing and rounding down at every boundary, and
+ * that rounding is where a real failure lives: with 16 MiB pieces a 64 MB
+ * allowance is four places, while two readers asking for 96 MB each want six —
+ * every resident piece then ends up pinned, the read returns zero bytes, and
+ * ffmpeg takes that for the end of the file. In bytes the shortage is plain;
+ * in pieces it is hidden behind a floor. The single conversion lives in
+ * `pieces.js`.
+ */
+
+/**
+ * A range of one file that somebody says they will need.
+ */
+export class Window {
+  /**
+   * @param {object} params
+   * @param {string} params.claimant - Who states it. A release names this, so a
+   *   stray release matches nothing rather than cancelling somebody else's
+   *   need.
+   * @param {number} params.fileIndex - Which file of the torrent.
+   * @param {number} params.byteStart - First byte, inclusive.
+   * @param {number} params.byteEnd - Last byte, inclusive.
+   * @param {number} params.urgency - A value of {@link import("./Urgency.js").Urgency}.
+   */
+  constructor({ claimant, fileIndex, byteStart, byteEnd, urgency }) {
+    if (typeof claimant !== "string" || claimant.length === 0) {
+      throw new Error("A window needs a claimant to release it by.");
+    }
+    if (!Number.isInteger(fileIndex) || fileIndex < 0) {
+      throw new Error(`File index must be a non-negative integer, got ${fileIndex}.`);
+    }
+    if (!Number.isInteger(byteStart) || byteStart < 0) {
+      throw new Error(`Byte start must be a non-negative integer, got ${byteStart}.`);
+    }
+    if (!Number.isInteger(byteEnd) || byteEnd < byteStart) {
+      throw new Error(`Byte end must be an integer at or after ${byteStart}, got ${byteEnd}.`);
+    }
+    if (!Number.isInteger(urgency) || urgency < 0) {
+      throw new Error(`Urgency must be a non-negative integer, got ${urgency}.`);
+    }
+    this.claimant = claimant;
+    this.fileIndex = fileIndex;
+    this.byteStart = byteStart;
+    this.byteEnd = byteEnd;
+    this.urgency = urgency;
+    Object.freeze(this);
+  }
+
+  /** How many bytes this window covers. */
+  get byteLength() {
+    return this.byteEnd - this.byteStart + 1;
+  }
+
+  /**
+   * Whether two windows cover any of the same bytes of the same file.
+   *
+   * @param {Window} other
+   * @returns {boolean}
+   */
+  overlaps(other) {
+    return this.fileIndex === other.fileIndex
+      && this.byteStart <= other.byteEnd
+      && other.byteStart <= this.byteEnd;
+  }
+
+  /**
+   * Whether two windows are the same statement — same file, same bytes, same
+   * urgency, same claimant.
+   *
+   * @param {Window} other
+   * @returns {boolean}
+   */
+  equals(other) {
+    return other instanceof Window
+      && this.claimant === other.claimant
+      && this.fileIndex === other.fileIndex
+      && this.byteStart === other.byteStart
+      && this.byteEnd === other.byteEnd
+      && this.urgency === other.urgency;
+  }
+
+  /** @returns {string} */
+  toString() {
+    return `${this.claimant} wants ${this.fileIndex}:${this.byteStart}-${this.byteEnd}`;
+  }
+}
+
+/**
+ * The union of a set of ranges of ONE file, in order, with touching and
+ * overlapping ones merged.
+ *
+ * The union and not the sum: a viewer's picture and sound are read by two
+ * readers of the same file whose windows overlap by construction, and adding
+ * them would report a demand that is not there.
+ *
+ * @param {Array<{ byteStart: number, byteEnd: number }>} ranges
+ * @returns {Array<{ byteStart: number, byteEnd: number }>}
+ */
+export function unionOf(ranges) {
+  const sorted = [...ranges].sort((left, right) => left.byteStart - right.byteStart);
+  /** @type {Array<{ byteStart: number, byteEnd: number }>} */
+  const merged = [];
+  for (const range of sorted) {
+    const last = merged[merged.length - 1];
+    // `+ 1` because ranges are inclusive: 0-99 and 100-199 are one run of 200
+    // bytes, not two runs with nothing between them.
+    if (last && range.byteStart <= last.byteEnd + 1) {
+      last.byteEnd = Math.max(last.byteEnd, range.byteEnd);
+      continue;
+    }
+    merged.push({ byteStart: range.byteStart, byteEnd: range.byteEnd });
+  }
+  return merged;
+}

package/services/demand/index.js

@@ -0,0 +1,11 @@
+export { DemandRegister } from "./DemandRegister.js";
+export { unionOf, Window } from "./Window.js";
+export {
+  isConditional,
+  mayDisplaceSlowPeer,
+  selectionPriority,
+  Urgency,
+  URGENCY_ORDER,
+  urgencyName
+} from "./Urgency.js";
+export { bytesOf, nearestFirst, piecesNeededFor, piecesOf, piecesWithin } from "./pieces.js";

package/services/demand/pieces.js

@@ -0,0 +1,140 @@
+/**
+ * @file The one place bytes become piece numbers.
+ *
+ * Everything else counts in bytes. A piece is what the protocol hashes and what
+ * memory is allocated in, and nothing outside these functions should have to
+ * know its length. Before 2026-09-02 the division was done in three places —
+ * the memory allowance, the reader's window, the eviction ceiling — each
+ * rounding down on its own, and the rounding was where a real failure lived:
+ * with 16 MiB pieces a 64 MB allowance is four places while two readers asking
+ * for 96 MB each want six, and the shortage was invisible because both figures
+ * had already been floored.
+ *
+ * Pure arithmetic on numbers: no torrent, no file object, nothing to stub.
+ */
+
+/**
+ * The pieces that hold a byte range of a file.
+ *
+ * Inclusive at both ends, because a byte range that ends inside a piece still
+ * needs that whole piece: the protocol delivers and verifies nothing smaller.
+ *
+ * @param {object} params
+ * @param {number} params.fileOffset - Where the file starts within the torrent.
+ * @param {number} params.byteStart - First byte wanted, relative to the file.
+ * @param {number} params.byteEnd - Last byte wanted, relative to the file.
+ * @param {number} params.pieceLength
+ * @returns {{ from: number, to: number } | null} Null when the range is not a
+ *   range, or the piece length is not usable.
+ */
+export function piecesOf({ fileOffset, byteStart, byteEnd, pieceLength }) {
+  if (!Number.isFinite(pieceLength) || pieceLength <= 0) {
+    return null;
+  }
+  if (!Number.isFinite(fileOffset) || fileOffset < 0) {
+    return null;
+  }
+  if (!Number.isFinite(byteStart) || !Number.isFinite(byteEnd) || byteEnd < byteStart) {
+    return null;
+  }
+  return {
+    from: Math.floor((fileOffset + Math.max(0, byteStart)) / pieceLength),
+    to: Math.floor((fileOffset + byteEnd) / pieceLength)
+  };
+}
+
+/**
+ * The bytes of a file that a piece range covers, clamped to the file.
+ *
+ * The inverse of {@link piecesOf}, and here for the same reason: a caller that
+ * still thinks in pieces — the reader, which walks a file piece by piece
+ * because that is what arrives — states its need in bytes like everyone else,
+ * and the conversion stays in this one file rather than being written out
+ * again at the boundary.
+ *
+ * @param {object} params
+ * @param {number} params.fileOffset - Where the file starts within the torrent.
+ * @param {number} params.fileLength
+ * @param {number} params.from - First piece, inclusive.
+ * @param {number} params.to - Last piece, inclusive.
+ * @param {number} params.pieceLength
+ * @returns {{ byteStart: number, byteEnd: number } | null}
+ */
+export function bytesOf({ fileOffset, fileLength, from, to, pieceLength }) {
+  if (!Number.isFinite(pieceLength) || pieceLength <= 0) {
+    return null;
+  }
+  if (!Number.isFinite(fileOffset) || !Number.isFinite(fileLength) || fileLength <= 0) {
+    return null;
+  }
+  if (!Number.isInteger(from) || !Number.isInteger(to) || to < from) {
+    return null;
+  }
+  const byteStart = Math.max(0, from * pieceLength - fileOffset);
+  const byteEnd = Math.min(fileLength - 1, (to + 1) * pieceLength - 1 - fileOffset);
+  return byteEnd < byteStart ? null : { byteStart, byteEnd };
+}
+
+/**
+ * How many pieces a number of bytes needs, at worst.
+ *
+ * At worst, because a range of one byte can still straddle two pieces. Used
+ * where a budget in bytes has to be turned into places, and rounding the other
+ * way would promise room that is not there.
+ *
+ * @param {number} bytes
+ * @param {number} pieceLength
+ * @returns {number}
+ */
+export function piecesNeededFor(bytes, pieceLength) {
+  if (!Number.isFinite(pieceLength) || pieceLength <= 0 || !Number.isFinite(bytes) || bytes <= 0) {
+    return 0;
+  }
+  return Math.ceil(bytes / pieceLength) + 1;
+}
+
+/**
+ * How many whole pieces fit in a number of bytes.
+ *
+ * The other direction, and it rounds DOWN: a budget buys only the places it can
+ * pay for in full.
+ *
+ * @param {number} bytes
+ * @param {number} pieceLength
+ * @returns {number}
+ */
+export function piecesWithin(bytes, pieceLength) {
+  if (!Number.isFinite(pieceLength) || pieceLength <= 0 || !Number.isFinite(bytes) || bytes <= 0) {
+    return 0;
+  }
+  return Math.floor(bytes / pieceLength);
+}
+
+/**
+ * Split a byte range into a few ranges, nearest to a point first.
+ *
+ * For the gap behind the playhead. WebTorrent walks a selection from its start
+ * upwards — `for (piece = next.from + next.offset; piece <= next.to; piece++)` —
+ * so one claim over everything behind the viewer would be fetched from the
+ * beginning of the file, which is the end furthest from where a backward seek
+ * would land. Split, and the part nearest the playhead is stated first.
+ *
+ * @param {object} params
+ * @param {number} params.byteStart - First byte of the gap.
+ * @param {number} params.byteEnd - Last byte of the gap, nearest the playhead.
+ * @param {number} params.parts - How many ranges to split into.
+ * @returns {Array<{ byteStart: number, byteEnd: number }>} Nearest first.
+ */
+export function nearestFirst({ byteStart, byteEnd, parts }) {
+  if (!Number.isFinite(byteStart) || !Number.isFinite(byteEnd) || byteEnd < byteStart) {
+    return [];
+  }
+  const count = Number.isInteger(parts) && parts > 0 ? parts : 1;
+  const total = byteEnd - byteStart + 1;
+  const each = Math.ceil(total / count);
+  const ranges = [];
+  for (let end = byteEnd; end >= byteStart; end -= each) {
+    ranges.push({ byteStart: Math.max(byteStart, end - each + 1), byteEnd: end });
+  }
+  return ranges;
+}

package/services/download/SwarmSelection.js

@@ -0,0 +1,313 @@
+/**
+ * @file The only thing in this proxy that tells WebTorrent what to fetch.
+ *
+ * One per torrent. It reads the demand register — the single statement of what
+ * anybody wants — and turns it into the library's `select`, `deselect` and
+ * `critical`. Nothing else calls those, so two parts of this program can no
+ * longer ask for different things and overwrite each other.
+ *
+ * That used to happen and it is written into the code this replaces. The reader
+ * held a moving window; the pool held a whole-file selection; a third place set
+ * a window around the read head. A whole-file read undid a seek that had just
+ * happened, and the swarm walked forward from the first hole: measured on a
+ * 4.7 GB film, a seek to 89.1 % fetched 2.47 GB over 93 s before the segment
+ * could be served.
+ *
+ * **Why urgency is not a number given to the library.** Measured against the
+ * vendored 2.8.5: selections are sorted by priority only when one is inserted,
+ * and `shufflePriority` then moves the selection just served to the back of the
+ * whole non-zero group. Distinct numbers therefore order the list once and
+ * round-robin it afterwards. So the ordering is kept HERE, by choosing what to
+ * state at all, and the library is given only the distinction it honours:
+ * non-zero for what is wanted now, zero for the speculative tail.
+ */
+
+import {
+  isConditional,
+  piecesOf,
+  selectionPriority,
+  Urgency,
+  urgencyName
+} from "../demand/index.js";
+
+export class SwarmSelection {
+  #torrent;
+  #register;
+  /** What was last stated to the library, so a restatement can be a no-op. */
+  #stated = new Map();
+  /** Pieces this instance marked for displacement, so it clears only its own. */
+  #displacing = null;
+
+  /**
+   * @param {object} params
+   * @param {import("webtorrent").Torrent} params.torrent
+   * @param {import("../demand/index.js").DemandRegister} params.register
+   */
+  constructor({ torrent, register }) {
+    this.#torrent = torrent;
+    this.#register = register;
+  }
+
+  /**
+   * Bring the library's download set into line with what is stated.
+   *
+   * Called after any change to the register and on a timer. On a timer because
+   * WebTorrent DELETES a selection once every piece in it has arrived, so a
+   * window that is satisfied and then reopened — the reader moved on, or a
+   * piece was evicted and lost — is gone from the library while it is still
+   * stated here.
+   *
+   * @param {object} [options]
+   * @param {boolean} [options.speculativeAllowed] - Whether anything on ANY
+   *   torrent is still waiting for something urgent. The registry works it out
+   *   once and hands the same answer to every selection, because the link is
+   *   shared and the question is not a per-torrent one.
+   * @returns {{ stated: number, withdrawn: number }}
+   */
+  reconcile({ speculativeAllowed = true } = {}) {
+    const levels = this.#register.levelsToState(
+      (window) => this.#isSatisfied(window),
+      speculativeAllowed
+    );
+    /** @type {Map<string, { from: number, to: number, priority: number }>} */
+    const wanted = new Map();
+    for (const urgency of levels) {
+      for (const window of this.#register.at(urgency)) {
+        const range = this.#piecesFor(window);
+        if (!range) {
+          continue;
+        }
+        // Merged by range and priority, not by claimant: two readers wanting
+        // the same pieces are one instruction to the swarm.
+        const key = `${range.from}-${range.to}-${selectionPriority(urgency)}`;
+        wanted.set(key, { from: range.from, to: range.to, priority: selectionPriority(urgency) });
+      }
+    }
+
+    let withdrawn = 0;
+    for (const [key, range] of [...this.#stated]) {
+      if (wanted.has(key)) {
+        continue;
+      }
+      this.#deselect(range);
+      this.#stated.delete(key);
+      withdrawn += 1;
+    }
+
+    let stated = 0;
+    for (const [key, range] of wanted) {
+      // Re-stated when the library has dropped it, even though this instance
+      // believes it is stated: that is the whole reason this runs on a timer.
+      if (this.#stated.has(key) && this.#libraryHolds(range)) {
+        continue;
+      }
+      this.#select(range);
+      this.#stated.set(key, range);
+      stated += 1;
+    }
+
+    this.#markDisplacement();
+    return { stated, withdrawn };
+  }
+
+  /** Take everything back. The torrent is going, or nobody wants anything. */
+  releaseAll() {
+    for (const range of this.#stated.values()) {
+      this.#deselect(range);
+    }
+    this.#stated.clear();
+    this.#clearDisplacement();
+  }
+
+  /**
+   * What is stated right now.
+   *
+   * @returns {Array<{ from: number, to: number, priority: number }>}
+   */
+  statedRanges() {
+    return [...this.#stated.values()];
+  }
+
+  /**
+   * Whether anything urgent on THIS torrent has not arrived.
+   *
+   * Read by the registry, which asks every torrent and gives the same answer
+   * back to all of them.
+   *
+   * @returns {boolean}
+   */
+  hasUrgentMissing() {
+    for (const urgency of [Urgency.BLOCKED, Urgency.NEAR, Urgency.AHEAD]) {
+      for (const window of this.#register.at(urgency)) {
+        if (!this.#isSatisfied(window)) {
+          return true;
+        }
+      }
+    }
+    return false;
+  }
+
+  /**
+   * Permission to take a block from a slow peer, for the level being waited on
+   * and nothing else.
+   *
+   * Cleared before it is set again, because WebTorrent never clears the flag
+   * itself: a reader walking a film would otherwise leave every piece of it
+   * marked, and the mark would mean nothing anywhere.
+   *
+   * @returns {void}
+   */
+  #markDisplacement() {
+    const blocked = this.#register
+      .at(Urgency.BLOCKED)
+      .map((window) => this.#piecesFor(window))
+      .filter((range) => range !== null);
+    if (blocked.length === 0) {
+      this.#clearDisplacement();
+      return;
+    }
+    const from = Math.min(...blocked.map((range) => range.from));
+    const to = Math.max(...blocked.map((range) => range.to));
+    if (this.#displacing && this.#displacing.from === from && this.#displacing.to === to) {
+      return;
+    }
+    this.#clearDisplacement();
+    try {
+      this.#torrent.critical?.(from, to);
+      this.#displacing = { from, to };
+    } catch {
+      // silent-ok: displacement is an optimisation, and a torrent being torn
+      // down is not worth failing a read over.
+      this.#displacing = null;
+    }
+  }
+
+  /** @returns {void} */
+  #clearDisplacement() {
+    if (!this.#displacing || !Array.isArray(this.#torrent._critical)) {
+      this.#displacing = null;
+      return;
+    }
+    for (let index = this.#displacing.from; index <= this.#displacing.to; index += 1) {
+      this.#torrent._critical[index] = false;
+    }
+    this.#displacing = null;
+  }
+
+  /**
+   * The pieces a window covers, or null when the file or the torrent cannot
+   * answer yet.
+   *
+   * @param {import("../demand/index.js").Window} window
+   * @returns {{ from: number, to: number } | null}
+   */
+  #piecesFor(window) {
+    const file = this.#torrent?.files?.[window.fileIndex];
+    if (!file) {
+      return null;
+    }
+    return piecesOf({
+      fileOffset: Number(file.offset),
+      byteStart: window.byteStart,
+      byteEnd: Math.min(window.byteEnd, Number(file.length) - 1),
+      pieceLength: Number(this.#torrent.pieceLength)
+    });
+  }
+
+  /**
+   * Whether everything a window asked for has arrived.
+   *
+   * @param {import("../demand/index.js").Window} window
+   * @returns {boolean}
+   */
+  #isSatisfied(window) {
+    const range = this.#piecesFor(window);
+    if (!range) {
+      return true;
+    }
+    for (let index = range.from; index <= range.to; index += 1) {
+      if (!this.#torrent.bitfield?.get(index)) {
+        return false;
+      }
+    }
+    return true;
+  }
+
+  /**
+   * Whether the library still holds this instruction.
+   *
+   * Read from its own list, because it removes a selection once satisfied and
+   * says nothing about having done so.
+   *
+   * @param {{ from: number, to: number }} range
+   * @returns {boolean}
+   */
+  #libraryHolds({ from, to }) {
+    const items = Array.isArray(this.#torrent?._selections?._items)
+      ? this.#torrent._selections._items
+      : [];
+    return items.some((item) => item?.from === from && item?.to === to);
+  }
+
+  /**
+   * @param {{ from: number, to: number, priority: number }} range
+   * @returns {void}
+   */
+  #select({ from, to, priority }) {
+    try {
+      // The private form takes the stream flag, which makes a selection several
+      // claimants can hold at the same bounds; the public one merges and
+      // subtracts intervals and cannot express "one of several wants this". The
+      // public call is the fallback if a future version drops the private one.
+      if (typeof this.#torrent._select === "function") {
+        this.#torrent._select(from, to, priority, null, true);
+      } else if (typeof this.#torrent.select === "function") {
+        this.#torrent.select(from, to, priority);
+      }
+    } catch {
+      // silent-ok: never fail a read because the download set refused.
+    }
+  }
+
+  /**
+   * @param {{ from: number, to: number }} range
+   * @returns {void}
+   */
+  #deselect({ from, to }) {
+    try {
+      if (typeof this.#torrent._deselect === "function") {
+        this.#torrent._deselect(from, to, true);
+      } else if (typeof this.#torrent.deselect === "function") {
+        this.#torrent.deselect(from, to);
+      }
+    } catch {
+      // silent-ok.
+    }
+  }
+
+  /**
+   * One line saying what the swarm has been told and why.
+   *
+   * @returns {string}
+   */
+  describe(speculativeAllowed = true) {
+    const stating = this.#register.levelsToState(
+      (window) => this.#isSatisfied(window),
+      speculativeAllowed
+    );
+    const speculative = stating.filter((urgency) => isConditional(urgency)).map(urgencyName);
+    const needs = this.#register
+      .windows()
+      .map((window) => `${urgencyName(window.urgency)}:${window.claimant}`);
+    return (
+      `download: ${this.#stated.size} instruction(s) to the swarm from ` +
+      `${this.#register.size} stated need(s) [${needs.join(" ")}]` +
+      (speculative.length > 0
+        ? `; ${speculative.join(" and ")} also stated — nothing urgent is missing`
+        : "; nothing speculative is stated — something urgent is still missing") +
+      (this.#displacing
+        ? `; pieces ${this.#displacing.from}-${this.#displacing.to} may be taken from slow peers`
+        : "")
+    );
+  }
+}

package/services/download/index.js

@@ -0,0 +1,8 @@
+export { SwarmSelection } from "./SwarmSelection.js";
+export {
+  anythingUrgentIsMissing,
+  demandFor,
+  forgetTorrent,
+  liveDemand,
+  reconcileAll
+} from "./registry.js";

package/services/download/registry.js

@@ -0,0 +1,96 @@
+/**
+ * @file One demand register and one swarm selection per torrent, found from the
+ * torrent itself.
+ *
+ * The same shape the piece store already uses — `findSharedStore(torrent)`
+ * reaches the store without it being threaded through every call — and for the
+ * same reason: the reader, the pool and the background fill all need the same
+ * instance, and passing it through six layers of arguments would make the
+ * plumbing bigger than the thing.
+ *
+ * Kept in a live set as well as a weak map, because one question cannot be
+ * answered per torrent: whether ANYTHING anywhere is still missing something
+ * urgent. The link and the machine are shared between torrents, so a viewer
+ * starving on one film must stop the speculative fetching on the other. Asked
+ * per torrent, that question has the wrong answer.
+ */
+
+import { DemandRegister } from "../demand/DemandRegister.js";
+import { SwarmSelection } from "./SwarmSelection.js";
+
+/** @type {WeakMap<object, { register: DemandRegister, selection: SwarmSelection }>} */
+const byTorrent = new WeakMap();
+/** @type {Set<{ register: DemandRegister, selection: SwarmSelection }>} */
+const live = new Set();
+
+/**
+ * The register and selection for a torrent, made on first use.
+ *
+ * @param {object} torrent
+ * @returns {{ register: DemandRegister, selection: SwarmSelection }}
+ */
+export function demandFor(torrent) {
+  const held = byTorrent.get(torrent);
+  if (held) {
+    return held;
+  }
+  const register = new DemandRegister();
+  const entry = { register, selection: new SwarmSelection({ torrent, register }) };
+  byTorrent.set(torrent, entry);
+  live.add(entry);
+  return entry;
+}
+
+/**
+ * Give up everything stated for a torrent that is going.
+ *
+ * @param {object} torrent
+ * @returns {void}
+ */
+export function forgetTorrent(torrent) {
+  const held = byTorrent.get(torrent);
+  if (!held) {
+    return;
+  }
+  held.selection.releaseAll();
+  held.register.clear();
+  byTorrent.delete(torrent);
+  live.delete(held);
+}
+
+/**
+ * Bring every torrent's download set into line with what is stated.
+ *
+ * The cross-torrent rule lives here and not in a selection, because it is not a
+ * per-torrent question: two films on one proxy share the link, so filling the
+ * tail of one while a viewer of the other has a still picture spends the same
+ * bandwidth twice over. The answer is worked out once and given to all.
+ *
+ * @returns {{ torrents: number, speculativeAllowed: boolean, stated: number, withdrawn: number }}
+ */
+export function reconcileAll() {
+  const entries = [...live];
+  const speculativeAllowed = !entries.some((entry) => entry.selection.hasUrgentMissing());
+  let stated = 0;
+  let withdrawn = 0;
+  for (const entry of entries) {
+    const result = entry.selection.reconcile({ speculativeAllowed });
+    stated += result.stated;
+    withdrawn += result.withdrawn;
+  }
+  return { torrents: entries.length, speculativeAllowed, stated, withdrawn };
+}
+
+/**
+ * Whether anybody, on any torrent, is still waiting for something urgent.
+ *
+ * @returns {boolean}
+ */
+export function anythingUrgentIsMissing() {
+  return [...live].some((entry) => entry.selection.hasUrgentMissing());
+}
+
+/** Every live register and selection, for the periodic reconcile. */
+export function liveDemand() {
+  return [...live];
+}