@blockcast/mmt-container 2.1.0 → 2.2.0-main.050b52fb9b00

package/dist/cmcd-producer.js

@@ -1,62 +1,64 @@
 // src/cmcd-producer.ts
 var PLAY_MODES = ["full", "base-only", "single-track"];
-function sanitize(value) {
-  return value.replace(/[,\r\n]/g, "");
-}
-function buildFecParams(stats) {
-  const params = {};
-  const cfg = stats.config;
-  params["x-bc-fec-algo"] = cfg.algorithm;
-  params["x-bc-fec-k"] = cfg.k;
-  params["x-bc-fec-p"] = cfg.repairCount;
-  params["x-bc-fec-recovery"] = parseFloat((stats.recoveryRate / 100).toFixed(4));
-  return params;
-}
-function buildTransportParams(snap) {
-  if (!snap) return {};
-  const params = {};
-  params["x-bc-transport"] = snap.transport;
-  if (snap.multicastGroup != null) {
-    params["x-bc-multicast-group"] = snap.multicastGroup;
-  }
-  if (snap.multicastSource != null) {
-    params["x-bc-multicast-source"] = snap.multicastSource;
-  }
-  if (snap.amtRelay != null) {
-    params["x-bc-amt-relay"] = snap.amtRelay;
-  }
-  return params;
+var DEFAULT_INTERVAL_MS = 3e4;
+var CUSTOM_PREFIX = "com.blockcast-";
+var MAX_CUSTOM_VALUE = 64;
+var TRANSPORT_TOKEN = {
+  native: "ssm",
+  amt: "amt",
+  moq: "moq"
+};
+function sfString(value) {
+  return `"${value.replace(/[^\x20-\x7e]/g, "").replace(/[\\"]/g, "\\$&")}"`;
 }
-function formatQueryString(params) {
-  return Object.keys(params).sort().map((key) => {
-    const v = params[key];
-    if (typeof v === "string") return `${key}=${sanitize(v)}`;
-    return `${key}=${v}`;
+function encodeCmcdRecord(record) {
+  return Object.keys(record).sort().map((key) => {
+    const value = record[key];
+    if (typeof value === "number") return `${key}=${value}`;
+    if (typeof value === "string") return `${key}=${sfString(value)}`;
+    if (Array.isArray(value)) return `${key}=(${value.map(sfString).join(" ")})`;
+    return `${key}=${value.token}`;
   }).join(",");
 }
+var token = (value) => ({ token: value });
+function putCustom(record, name, value) {
+  if (value === void 0) return;
+  if (typeof value === "number") value = String(value);
+  if (typeof value === "string" && value.length > MAX_CUSTOM_VALUE) return;
+  record[CUSTOM_PREFIX + name] = value;
+}
 var CmcdProducer = class {
-  #onCmcdParams;
   #onCmcdPost;
+  #intervalMs;
+  #sessionId;
+  #now;
+  #sn = 0;
+  #lastHeartbeat = null;
   #transport;
   #lastStats;
-  // Phase 14 state — Plan 03 Task 2 (D-12, D-15).
   #playMode = null;
   #deltaFailRate = null;
   #switchMiscount = 0;
   #manifestStats = null;
   #fecFailClosed = null;
+  /** Video-block resolutions from the repair lifecycle; null until the player feeds one. */
+  #lifecycle = null;
   constructor(options) {
-    this.#onCmcdParams = options.onCmcdParams;
     this.#onCmcdPost = options.onCmcdPost;
+    this.#intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+    if (!Number.isFinite(this.#intervalMs) || this.#intervalMs <= 0) {
+      throw new Error(`[CmcdProducer] invalid intervalMs "${String(options.intervalMs)}"; expected a positive number`);
+    }
+    this.#sessionId = options.sessionId ?? globalThis.crypto.randomUUID();
+    this.#now = options.now ?? Date.now;
   }
   /** Update the stored transport state. Called by player wiring layer. */
   updateTransport(snapshot) {
     this.#transport = snapshot;
   }
   /**
-   * Set the current play-mode. Emitted as `x-bc-play-mode` on subsequent
-   * snapshots. Throws on any value outside {'full','base-only','single-track'}
-   * (CLAUDE.md: error on bad init).
+   * Set the current play-mode, reported as `com.blockcast-pm`. Throws on any
+   * value outside {'full','base-only','single-track'} (CLAUDE.md: error on bad init).
    */
   updatePlayMode(mode) {
     if (typeof mode !== "string" || !PLAY_MODES.includes(mode)) {
@@ -67,9 +69,8 @@ var CmcdProducer = class {
     this.#playMode = mode;
   }
   /**
-   * Set the delta-track FEC block-failure rate (0..1 inclusive). Emitted as
-   * `x-bc-delta-fail-rate` on snapshots when play-mode is 'full' or 'base-only'.
-   * Omitted on single-track streams.
+   * Set the delta-track FEC block-failure rate (0..1 inclusive), reported as
+   * `com.blockcast-dfr` when play-mode is 'full' or 'base-only'.
    */
   updateDeltaFailRate(rate) {
     if (typeof rate !== "number" || !Number.isFinite(rate) || rate < 0 || rate > 1) {
@@ -79,115 +80,143 @@ var CmcdProducer = class {
     }
     this.#deltaFailRate = rate;
   }
-  /**
-   * Bump the cumulative switching-set misalignment counter. Emitted as
-   * `x-bc-switch-miscount` on snapshots when the counter is > 0.
-   */
+  /** Bump the cumulative switching-set misalignment counter (`com.blockcast-sm`). */
   incrementSwitchMiscount() {
     this.#switchMiscount += 1;
   }
   /**
-   * Record that FEC failed closed at runtime (fec-01 6.3.9). Every later
-   * snapshot carries `x-bc-fec-fail-closed` (the reason code) and
-   * `x-bc-fec-fail-layer` (the held layer i whose total B_i was undercut), so a
-   * stream playing without FEC is told apart from one with no loss.
+   * Record that FEC failed closed at runtime (fec-01 6.3.9). Reported at once
+   * as `e=e` with the reason code in `ec`, and on every later counter report
+   * as `com.blockcast-ffc` / `com.blockcast-ffl` (the held layer whose total
+   * B_i was undercut), so a stream playing without FEC is told apart from one
+   * with no loss.
    */
   updateFecFailClosed(reason) {
+    const changed = this.#fecFailClosed?.code !== reason.code || this.#fecFailClosed?.layer !== reason.layer;
     this.#fecFailClosed = reason;
+    if (changed) this.#post([{ ...this.#base("e"), ec: [reason.code] }]);
   }
   updateManifestVerification(stats) {
     this.#manifestStats = stats;
   }
   /**
-   * One-shot emit of `x-bc-switch-drift-us` for a single misalignment event.
-   * Does NOT mutate snapshot state — subsequent onSnapshot() calls will not
-   * include the drift key until the next emitSwitchDrift(). Mirrors the
-   * existing onTransition() pattern.
+   * Count a video block's resolution from the repair lifecycle: recovered in
+   * band (`com.blockcast-fbr`), recovered by repair FETCH (`-fbq`), or failed
+   * as a keyframe-class block (`-fbfk`). Audio blocks are not counted, matching
+   * the video-track `-fbf`. Until the player feeds this, the three are absent.
    */
+  onRepairLifecycle(event) {
+    this.#lifecycle ??= { inband: 0, fetch: 0, failedKeyframe: 0 };
+    if (event.type === "recovered" && event.blockClass !== "audio") {
+      if (event.via === "inband") this.#lifecycle.inband++;
+      else this.#lifecycle.fetch++;
+    } else if (event.type === "failed" && event.blockClass === "keyframe") {
+      this.#lifecycle.failedKeyframe++;
+    }
+  }
+  /** One-shot custom event `com.blockcast-switch-drift` for a single misalignment. */
   emitSwitchDrift(driftUs) {
     if (typeof driftUs !== "number" || !Number.isFinite(driftUs) || driftUs < 0) {
       throw new Error(
         `[CmcdProducer] invalid drift-us "${String(driftUs)}"; expected a non-negative finite number`
       );
     }
-    const params = {};
-    if (this.#lastStats) Object.assign(params, buildFecParams(this.#lastStats));
-    Object.assign(params, buildTransportParams(this.#transport));
-    if (this.#switchMiscount > 0) params["x-bc-switch-miscount"] = this.#switchMiscount;
-    params["x-bc-switch-drift-us"] = driftUs;
-    this.#emit(params);
+    const record = { ...this.#base("ce"), cen: CUSTOM_PREFIX + "switch-drift" };
+    putCustom(record, "sdu", Math.round(driftUs));
+    this.#post([record]);
   }
-  /**
-   * Process a FecTrackStats snapshot. Finds the video track, builds
-   * x-bc-* vendor keys, and fires both delivery callbacks.
-   */
+  /** Take a FecTrackStats snapshot (first video track) and send the heartbeat when due. */
   onSnapshot(data) {
     const videoTrack = data.tracks.find((t) => t.config.trackType === "video");
     if (!videoTrack) return;
     this.#lastStats = videoTrack;
-    const params = {
-      ...buildFecParams(videoTrack),
-      ...buildTransportParams(this.#transport)
-    };
-    if (this.#playMode !== null) {
-      params["x-bc-play-mode"] = this.#playMode;
-    }
-    if (this.#fecFailClosed) {
-      params["x-bc-fec-fail-closed"] = this.#fecFailClosed.code;
-      params["x-bc-fec-fail-layer"] = this.#fecFailClosed.layer;
-    }
-    if (this.#playMode !== null && this.#playMode !== "single-track" && this.#deltaFailRate !== null) {
-      params["x-bc-delta-fail-rate"] = parseFloat(this.#deltaFailRate.toFixed(4));
-    }
-    if (this.#switchMiscount > 0) {
-      params["x-bc-switch-miscount"] = this.#switchMiscount;
-    }
-    if (this.#manifestStats) {
-      params["x-bc-manifest-verified"] = this.#manifestStats.verified > 0;
-      params["x-bc-manifest-failures"] = Object.values(this.#manifestStats.failures).reduce((total, count) => total + count, 0);
-    }
-    this.#emit(params);
+    this.#heartbeat();
   }
   /**
-   * Emit transport state without inventing FEC metrics. Cadence is owned by
-   * the caller because only the transport integration knows when state changed.
+   * Take transport state for receivers that do not own FEC stats, and send the
+   * heartbeat when due.
    */
   onTransportSnapshot(data) {
     if (!Number.isFinite(data.timestampMs) || data.timestampMs < 0) {
       throw new Error("[CmcdProducer] transport snapshot timestamp must be a non-negative finite number");
     }
     if (data.playMode !== void 0) this.updatePlayMode(data.playMode);
-    if (data.switchMiscount !== void 0 && (!Number.isSafeInteger(data.switchMiscount) || data.switchMiscount < 0)) {
-      throw new Error("[CmcdProducer] transport snapshot switch-miscount must be a non-negative safe integer");
+    if (data.switchMiscount !== void 0) {
+      if (!Number.isSafeInteger(data.switchMiscount) || data.switchMiscount < 0) {
+        throw new Error("[CmcdProducer] transport snapshot switch-miscount must be a non-negative safe integer");
+      }
+      this.#switchMiscount = data.switchMiscount;
     }
     this.#transport = data.transport;
-    const params = buildTransportParams(data.transport);
-    if (this.#playMode !== null) params["x-bc-play-mode"] = this.#playMode;
-    const switchMiscount = data.switchMiscount ?? this.#switchMiscount;
-    if (switchMiscount > 0) params["x-bc-switch-miscount"] = switchMiscount;
-    this.#emit(params);
+    this.#heartbeat();
   }
-  /**
-   * Signal a transport transition event. Fires an immediate out-of-band
-   * emit with x-bc-ct set. The subsequent onSnapshot() will NOT include
-   * x-bc-ct (one-shot).
-   */
+  /** Report a transport transition at once, as custom event `com.blockcast-ct`. */
   onTransition(event) {
-    const params = {};
-    if (this.#lastStats) {
-      Object.assign(params, buildFecParams(this.#lastStats));
+    const record = { ...this.#base("ce"), cen: CUSTOM_PREFIX + "ct" };
+    putCustom(record, "ct", token(event));
+    this.#putTransport(record);
+    this.#post([record]);
+  }
+  #base(event) {
+    return { e: token(event), sid: this.#sessionId, sn: this.#sn++, ts: Math.floor(this.#now()), v: 2 };
+  }
+  #heartbeat() {
+    const now = this.#now();
+    if (this.#lastHeartbeat !== null && now - this.#lastHeartbeat < this.#intervalMs) return;
+    this.#lastHeartbeat = now;
+    this.#post([this.#base("t"), this.#counters()]);
+  }
+  #putTransport(record) {
+    const snap = this.#transport;
+    if (!snap) return;
+    putCustom(record, "tr", token(TRANSPORT_TOKEN[snap.transport]));
+    if (snap.multicastGroup != null && snap.multicastSource != null) {
+      putCustom(record, "sg", `${snap.multicastGroup}@${snap.multicastSource}`);
+    }
+    putCustom(record, "ar", snap.amtRelay);
+  }
+  /** The `e=ce` counter report. */
+  #counters() {
+    const record = { ...this.#base("ce"), cen: CUSTOM_PREFIX + "fec" };
+    const stats = this.#lastStats;
+    if (stats) {
+      putCustom(record, "fa", stats.config.algorithm);
+      putCustom(record, "fk", stats.config.k);
+      putCustom(record, "fp", stats.config.repairCount);
+      putCustom(record, "pr", stats.sourceSymbols);
+      putCustom(record, "pl", stats.sourcePacketsMissing);
+      putCustom(record, "pu", stats.sourcePacketsUnrecovered);
+      putCustom(record, "fbf", stats.blocksFailed);
+    }
+    if (this.#lifecycle) {
+      putCustom(record, "fbr", this.#lifecycle.inband);
+      putCustom(record, "fbq", this.#lifecycle.fetch);
+      putCustom(record, "fbfk", this.#lifecycle.failedKeyframe);
+    }
+    this.#putTransport(record);
+    if (this.#playMode !== null) {
+      putCustom(record, "pm", token(this.#playMode));
+      if (this.#playMode !== "single-track" && this.#deltaFailRate !== null) {
+        putCustom(record, "dfr", this.#deltaFailRate.toFixed(3));
+      }
+    }
+    if (this.#fecFailClosed) {
+      putCustom(record, "ffc", token(this.#fecFailClosed.code));
+      putCustom(record, "ffl", this.#fecFailClosed.layer);
+    }
+    if (this.#switchMiscount > 0) putCustom(record, "sm", this.#switchMiscount);
+    if (this.#manifestStats) {
+      putCustom(record, "mv", this.#manifestStats.verified);
+      putCustom(record, "mf", Object.values(this.#manifestStats.failures).reduce((a, b) => a + b, 0));
     }
-    Object.assign(params, buildTransportParams(this.#transport));
-    params["x-bc-ct"] = event;
-    this.#emit(params);
+    return record;
   }
-  /** Fire both delivery callbacks with the given params. */
-  #emit(params) {
-    this.#onCmcdParams?.(params);
-    this.#onCmcdPost?.(formatQueryString(params));
+  #post(records) {
+    this.#onCmcdPost?.(records.map(encodeCmcdRecord).join("\n"));
   }
 };
 export {
-  CmcdProducer
+  CmcdProducer,
+  encodeCmcdRecord
 };
 //# sourceMappingURL=cmcd-producer.js.map

package/dist/cmcd-producer.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/cmcd-producer.ts"],
-  "sourcesContent": ["/**\n * CmcdProducer \u2014 transport-agnostic CMCD telemetry producer.\n *\n * Maps FecTrackStats snapshots and TransportSnapshot state to x-bc-*\n * CMCD vendor keys (proto tags 70-99). Fires callbacks for two delivery\n * channels: MoQ SUBSCRIBE params and multicast HTTP POST.\n *\n * Does NOT call fetch() or write to QUIC directly \u2014 the player wiring\n * layer is responsible for attaching params to SUBSCRIBE or POSTing\n * the payload to the CDN CMCD endpoint.\n *\n * @see docs/superpowers/specs/2026-04-15-iwa-multicast-stack-design.md \u00A73.3\n * @see CDN+ Track D BLO-1044\n */\n\nimport type { FecTrackStats } from '@blockcast/fec-worker'\nimport type { FecFailClosedReason } from './fec-manager.js'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Source-auth counters for CMCD: records verified, and drops per reason. */\nexport interface ManifestVerificationStats {\n  verified: number\n  failures: Record<string, number>\n}\n\n/** Transport state snapshot, built by the player wiring layer from SocketPool. */\nexport interface TransportSnapshot {\n  transport: 'native' | 'amt' | 'moq'\n  /** IPv4/IPv6 multicast group address */\n  multicastGroup?: string\n  /** SSM source address */\n  multicastSource?: string\n  /** AMT relay address (omit when undefined) */\n  amtRelay?: string\n}\n\n/** Transport transition event identifiers for x-bc-ct. */\nexport type TransportTransitionEvent = 'mc-start' | 'mc-to-uc' | 'amt-start'\n\n/**\n * Phase 14 play-mode state (D-12, x-bc-play-mode):\n * - `full`         \u2014 base + delta both active\n * - `base-only`    \u2014 delta fell back; base carries playback\n * - `single-track` \u2014 stream is not a multi-track switching set (legacy)\n */\nexport type PlayMode = 'full' | 'base-only' | 'single-track'\n\nconst PLAY_MODES: readonly PlayMode[] = ['full', 'base-only', 'single-track']\n\n/** CMCD vendor key map. Values are string, number, or boolean. */\nexport type CmcdParams = Record<string, string | number | boolean>\n\n/** Options for CmcdProducer construction. */\nexport interface CmcdProducerOptions {\n  /** Fired on each snapshot and on transport transitions. Params for MoQ SUBSCRIBE. */\n  onCmcdParams?: (params: CmcdParams) => void\n  /** Fired on each snapshot and on transport transitions. RFC 9559 query-string for HTTP POST body. */\n  onCmcdPost?: (payload: string) => void\n}\n\n/** Snapshot data passed to onSnapshot(). */\nexport interface SnapshotData {\n  tracks: FecTrackStats[]\n  timestampMs: number\n}\n\n/** Transport-only telemetry for receivers that do not own FEC track stats. */\nexport interface TransportOnlySnapshotData {\n  transport: TransportSnapshot\n  timestampMs: number\n  playMode?: PlayMode\n  switchMiscount?: number\n}\n\n// ---------------------------------------------------------------------------\n// Value sanitization (T-06-01: header injection mitigation)\n// ---------------------------------------------------------------------------\n\n/** Strip commas, newlines, and carriage returns from string values. */\nfunction sanitize(value: string): string {\n  return value.replace(/[,\\r\\n]/g, '')\n}\n\n// ---------------------------------------------------------------------------\n// Key building (pure functions, no side effects)\n// ---------------------------------------------------------------------------\n\n/** Build FEC vendor keys from a FecTrackStats snapshot. */\nfunction buildFecParams(stats: FecTrackStats): CmcdParams {\n  const params: CmcdParams = {}\n  const cfg = stats.config\n\n  params['x-bc-fec-algo'] = cfg.algorithm\n  params['x-bc-fec-k'] = cfg.k\n  // P as this receiver JOINED it: the worker is configured from\n  // TrackSessionConfig.joinedRepairCount, the sum of repairSymbols over the\n  // joined base layers. Not the catalog total, which a receiver on a clean path\n  // does not receive, and never including a keyframe overlay (separate FEC\n  // instance with its own RSB_length).\n  params['x-bc-fec-p'] = cfg.repairCount\n  params['x-bc-fec-recovery'] = parseFloat((stats.recoveryRate / 100).toFixed(4))\n\n  return params\n}\n\n/** Build transport vendor keys from a TransportSnapshot. */\nfunction buildTransportParams(snap: TransportSnapshot | undefined): CmcdParams {\n  if (!snap) return {}\n\n  const params: CmcdParams = {}\n  params['x-bc-transport'] = snap.transport\n\n  if (snap.multicastGroup != null) {\n    params['x-bc-multicast-group'] = snap.multicastGroup\n  }\n  if (snap.multicastSource != null) {\n    params['x-bc-multicast-source'] = snap.multicastSource\n  }\n  if (snap.amtRelay != null) {\n    params['x-bc-amt-relay'] = snap.amtRelay\n  }\n\n  return params\n}\n\n// ---------------------------------------------------------------------------\n// Query-string serialization (RFC 9559 \u00A72)\n// ---------------------------------------------------------------------------\n\n/**\n * Serialize CmcdParams to RFC 9559 query-string format.\n * Keys sorted for deterministic output. String values sanitized.\n */\nfunction formatQueryString(params: CmcdParams): string {\n  return Object.keys(params)\n    .sort()\n    .map(key => {\n      const v = params[key]\n      if (typeof v === 'string') return `${key}=${sanitize(v)}`\n      return `${key}=${v}`\n    })\n    .join(',')\n}\n\n// ---------------------------------------------------------------------------\n// CmcdProducer\n// ---------------------------------------------------------------------------\n\nexport class CmcdProducer {\n  #onCmcdParams: ((params: CmcdParams) => void) | undefined\n  #onCmcdPost: ((payload: string) => void) | undefined\n  #transport: TransportSnapshot | undefined\n  #lastStats: FecTrackStats | undefined\n  // Phase 14 state \u2014 Plan 03 Task 2 (D-12, D-15).\n  #playMode: PlayMode | null = null\n  #deltaFailRate: number | null = null\n  #switchMiscount = 0\n  #manifestStats: ManifestVerificationStats | null = null\n  #fecFailClosed: FecFailClosedReason | null = null\n\n  constructor(options: CmcdProducerOptions) {\n    this.#onCmcdParams = options.onCmcdParams\n    this.#onCmcdPost = options.onCmcdPost\n  }\n\n  /** Update the stored transport state. Called by player wiring layer. */\n  updateTransport(snapshot: TransportSnapshot): void {\n    this.#transport = snapshot\n  }\n\n  /**\n   * Set the current play-mode. Emitted as `x-bc-play-mode` on subsequent\n   * snapshots. Throws on any value outside {'full','base-only','single-track'}\n   * (CLAUDE.md: error on bad init).\n   */\n  updatePlayMode(mode: PlayMode): void {\n    if (typeof mode !== 'string' || !PLAY_MODES.includes(mode as PlayMode)) {\n      throw new Error(\n        `[CmcdProducer] invalid play-mode \"${String(mode)}\"; expected one of: ${PLAY_MODES.join(', ')}`,\n      )\n    }\n    this.#playMode = mode\n  }\n\n  /**\n   * Set the delta-track FEC block-failure rate (0..1 inclusive). Emitted as\n   * `x-bc-delta-fail-rate` on snapshots when play-mode is 'full' or 'base-only'.\n   * Omitted on single-track streams.\n   */\n  updateDeltaFailRate(rate: number): void {\n    if (typeof rate !== 'number' || !Number.isFinite(rate) || rate < 0 || rate > 1) {\n      throw new Error(\n        `[CmcdProducer] invalid delta-fail-rate \"${String(rate)}\"; expected a finite number in [0, 1]`,\n      )\n    }\n    this.#deltaFailRate = rate\n  }\n\n  /**\n   * Bump the cumulative switching-set misalignment counter. Emitted as\n   * `x-bc-switch-miscount` on snapshots when the counter is > 0.\n   */\n  incrementSwitchMiscount(): void {\n    this.#switchMiscount += 1\n  }\n\n  /**\n   * Record that FEC failed closed at runtime (fec-01 6.3.9). Every later\n   * snapshot carries `x-bc-fec-fail-closed` (the reason code) and\n   * `x-bc-fec-fail-layer` (the held layer i whose total B_i was undercut), so a\n   * stream playing without FEC is told apart from one with no loss.\n   */\n  updateFecFailClosed(reason: FecFailClosedReason): void {\n    this.#fecFailClosed = reason\n  }\n\n  updateManifestVerification(stats: ManifestVerificationStats): void {\n    this.#manifestStats = stats\n  }\n\n  /**\n   * One-shot emit of `x-bc-switch-drift-us` for a single misalignment event.\n   * Does NOT mutate snapshot state \u2014 subsequent onSnapshot() calls will not\n   * include the drift key until the next emitSwitchDrift(). Mirrors the\n   * existing onTransition() pattern.\n   */\n  emitSwitchDrift(driftUs: number): void {\n    if (\n      typeof driftUs !== 'number' ||\n      !Number.isFinite(driftUs) ||\n      driftUs < 0\n    ) {\n      throw new Error(\n        `[CmcdProducer] invalid drift-us \"${String(driftUs)}\"; expected a non-negative finite number`,\n      )\n    }\n    const params: CmcdParams = {}\n    if (this.#lastStats) Object.assign(params, buildFecParams(this.#lastStats))\n    Object.assign(params, buildTransportParams(this.#transport))\n    if (this.#switchMiscount > 0) params['x-bc-switch-miscount'] = this.#switchMiscount\n    params['x-bc-switch-drift-us'] = driftUs\n    this.#emit(params)\n  }\n\n  /**\n   * Process a FecTrackStats snapshot. Finds the video track, builds\n   * x-bc-* vendor keys, and fires both delivery callbacks.\n   */\n  onSnapshot(data: SnapshotData): void {\n    // Find first video track; skip if none\n    const videoTrack = data.tracks.find(t => t.config.trackType === 'video')\n    if (!videoTrack) return\n\n    this.#lastStats = videoTrack\n\n    const params: CmcdParams = {\n      ...buildFecParams(videoTrack),\n      ...buildTransportParams(this.#transport),\n    }\n\n    if (this.#playMode !== null) {\n      params['x-bc-play-mode'] = this.#playMode\n    }\n\n    if (this.#fecFailClosed) {\n      params['x-bc-fec-fail-closed'] = this.#fecFailClosed.code\n      params['x-bc-fec-fail-layer'] = this.#fecFailClosed.layer\n    }\n\n    // Delta-fail-rate is only meaningful when a delta track exists.\n    if (\n      this.#playMode !== null &&\n      this.#playMode !== 'single-track' &&\n      this.#deltaFailRate !== null\n    ) {\n      params['x-bc-delta-fail-rate'] = parseFloat(this.#deltaFailRate.toFixed(4))\n    }\n\n    if (this.#switchMiscount > 0) {\n      params['x-bc-switch-miscount'] = this.#switchMiscount\n    }\n    if (this.#manifestStats) {\n      params['x-bc-manifest-verified'] = this.#manifestStats.verified > 0\n      params['x-bc-manifest-failures'] = Object.values(this.#manifestStats.failures)\n        .reduce((total, count) => total + count, 0)\n    }\n\n    this.#emit(params)\n  }\n\n  /**\n   * Emit transport state without inventing FEC metrics. Cadence is owned by\n   * the caller because only the transport integration knows when state changed.\n   */\n  onTransportSnapshot(data: TransportOnlySnapshotData): void {\n    if (!Number.isFinite(data.timestampMs) || data.timestampMs < 0) {\n      throw new Error('[CmcdProducer] transport snapshot timestamp must be a non-negative finite number')\n    }\n    if (data.playMode !== undefined) this.updatePlayMode(data.playMode)\n    if (\n      data.switchMiscount !== undefined &&\n      (!Number.isSafeInteger(data.switchMiscount) || data.switchMiscount < 0)\n    ) {\n      throw new Error('[CmcdProducer] transport snapshot switch-miscount must be a non-negative safe integer')\n    }\n\n    this.#transport = data.transport\n    const params = buildTransportParams(data.transport)\n    if (this.#playMode !== null) params['x-bc-play-mode'] = this.#playMode\n    const switchMiscount = data.switchMiscount ?? this.#switchMiscount\n    if (switchMiscount > 0) params['x-bc-switch-miscount'] = switchMiscount\n    this.#emit(params)\n  }\n\n  /**\n   * Signal a transport transition event. Fires an immediate out-of-band\n   * emit with x-bc-ct set. The subsequent onSnapshot() will NOT include\n   * x-bc-ct (one-shot).\n   */\n  onTransition(event: TransportTransitionEvent): void {\n    const params: CmcdParams = {}\n\n    // Include last known FEC stats if available\n    if (this.#lastStats) {\n      Object.assign(params, buildFecParams(this.#lastStats))\n    }\n\n    // Include transport state if available\n    Object.assign(params, buildTransportParams(this.#transport))\n\n    // Add the transition event key (one-shot)\n    params['x-bc-ct'] = event\n\n    this.#emit(params)\n  }\n\n  /** Fire both delivery callbacks with the given params. */\n  #emit(params: CmcdParams): void {\n    this.#onCmcdParams?.(params)\n    this.#onCmcdPost?.(formatQueryString(params))\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * CmcdProducer \u2014 CMCD v2 Event-mode reports (CTA-5004-B \u00A72.2) from a player.\n *\n * Maps FecTrackStats snapshots, repair lifecycle events and transport state to\n * newline-separated `application/cmcd` records (CTA-5004-B \u00A73.3), each an\n * RFC 8941 dictionary carrying `v=2`, `ts`, `e`, `sn` and `sid`:\n *\n * - `e=t`  \u2014 time-interval heartbeat, Table 1 keys only;\n * - `e=ce` \u2014 custom event `cen=\"com.blockcast-fec\"` carrying the\n *   `com.blockcast-*` counters at the heartbeat cadence. Custom keys ride\n *   only on `e=ce`: \u00A72.2 admits on Event reports only Table 1 keys, and the\n *   Table 1 `cen` row admits a custom key-value pair with a custom event;\n * - `e=e`  \u2014 FEC failed closed, with `ec`.\n *\n * Custom values are STRING or TOKEN of at most 64 characters (\u00A74.1): numbers\n * go out as strings. A value that is unknown is omitted, never sent as zero\n * (\u00A73). Counters are absolute since session start, so a lost report loses\n * nothing.\n *\n * Does NOT call fetch(): the player POSTs the body handed to `onCmcdPost` with\n * `Content-Type: application/cmcd`. The heartbeat is driven by the snapshots\n * the player already feeds; there is no timer here.\n */\n\nimport type { FecTrackStats } from '@blockcast/fec-worker'\nimport type { FecFailClosedReason } from './fec-manager.js'\nimport type { RepairLifecycleEvent } from './multicast-manager.js'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Source-auth counters: records verified, and drops per reason. */\nexport interface ManifestVerificationStats {\n  verified: number\n  failures: Record<string, number>\n}\n\n/** Transport state snapshot, built by the player wiring layer from SocketPool. */\nexport interface TransportSnapshot {\n  /**\n   * CMCD has no user-agent value: report a `'user-agent'` join\n   * (`ResolvedMulticastTransport`, the browser's own MulticastReceiver) as\n   * `'native'`, since the browser does not say which leg it chose.\n   */\n  transport: 'native' | 'amt' | 'moq'\n  /** IPv4/IPv6 multicast group address */\n  multicastGroup?: string\n  /** SSM source address */\n  multicastSource?: string\n  /** AMT relay address (omit when undefined) */\n  amtRelay?: string\n}\n\n/** Transport transition event identifiers for `com.blockcast-ct`. */\nexport type TransportTransitionEvent = 'mc-start' | 'mc-to-uc' | 'amt-start'\n\n/**\n * Play-mode state (`com.blockcast-pm`):\n * - `full`         \u2014 base + delta both active\n * - `base-only`    \u2014 delta fell back; base carries playback\n * - `single-track` \u2014 stream is not a multi-track switching set (legacy)\n */\nexport type PlayMode = 'full' | 'base-only' | 'single-track'\n\nconst PLAY_MODES: readonly PlayMode[] = ['full', 'base-only', 'single-track']\n\n/** An RFC 8941 token (bare, unquoted). */\nexport interface CmcdToken {\n  readonly token: string\n}\n\n/** A record value: integer, string, token, or inner list of strings. */\nexport type CmcdValue = number | string | CmcdToken | readonly string[]\n\n/** One CMCD record, before encoding. */\nexport type CmcdRecord = Record<string, CmcdValue>\n\n/** Options for CmcdProducer construction. */\nexport interface CmcdProducerOptions {\n  /** Fired with an `application/cmcd` body: one record per line. */\n  onCmcdPost?: (body: string) => void\n  /** Heartbeat period for the `e=t` and counter reports. Default 30 s (CTA-5004-B \u00A75). */\n  intervalMs?: number\n  /** CTA-5004-B `sid`. Default: a random UUID per producer. */\n  sessionId?: string\n  /** Wall clock in ms since the epoch, for `ts` and the heartbeat. Default `Date.now`. */\n  now?: () => number\n}\n\n/** Snapshot data passed to onSnapshot(). */\nexport interface SnapshotData {\n  tracks: FecTrackStats[]\n  timestampMs: number\n}\n\n/** Transport-only telemetry for receivers that do not own FEC track stats. */\nexport interface TransportOnlySnapshotData {\n  transport: TransportSnapshot\n  timestampMs: number\n  playMode?: PlayMode\n  switchMiscount?: number\n}\n\nconst DEFAULT_INTERVAL_MS = 30_000\nconst CUSTOM_PREFIX = 'com.blockcast-'\n/** CTA-5004-B \u00A74.1: a custom value is at most 64 characters. */\nconst MAX_CUSTOM_VALUE = 64\n\nconst TRANSPORT_TOKEN: Record<TransportSnapshot['transport'], string> = {\n  native: 'ssm',\n  amt: 'amt',\n  moq: 'moq',\n}\n\n// ---------------------------------------------------------------------------\n// Encoding (RFC 8941 dictionary, keys sorted \u2014 CTA-5004-B \u00A73)\n// ---------------------------------------------------------------------------\n\n/** RFC 8941 \u00A73.3.3 string: printable ASCII, `\\` and `\"` escaped. */\nfunction sfString(value: string): string {\n  return `\"${value.replace(/[^\\x20-\\x7e]/g, '').replace(/[\\\\\"]/g, '\\\\$&')}\"`\n}\n\n/** Encode one record as an RFC 8941 dictionary with keys in alphabetical order. */\nexport function encodeCmcdRecord(record: CmcdRecord): string {\n  return Object.keys(record)\n    .sort()\n    .map(key => {\n      const value = record[key]\n      if (typeof value === 'number') return `${key}=${value}`\n      if (typeof value === 'string') return `${key}=${sfString(value)}`\n      if (Array.isArray(value)) return `${key}=(${value.map(sfString).join(' ')})`\n      return `${key}=${(value as CmcdToken).token}`\n    })\n    .join(',')\n}\n\nconst token = (value: string): CmcdToken => ({ token: value })\n\n/** Set a custom key, numbers as strings; drop anything absent or over 64 characters. */\nfunction putCustom(record: CmcdRecord, name: string, value: string | number | CmcdToken | undefined): void {\n  if (value === undefined) return\n  if (typeof value === 'number') value = String(value)\n  if (typeof value === 'string' && value.length > MAX_CUSTOM_VALUE) return\n  record[CUSTOM_PREFIX + name] = value\n}\n\n// ---------------------------------------------------------------------------\n// CmcdProducer\n// ---------------------------------------------------------------------------\n\nexport class CmcdProducer {\n  #onCmcdPost: ((body: string) => void) | undefined\n  #intervalMs: number\n  #sessionId: string\n  #now: () => number\n  #sn = 0\n  #lastHeartbeat: number | null = null\n\n  #transport: TransportSnapshot | undefined\n  #lastStats: FecTrackStats | undefined\n  #playMode: PlayMode | null = null\n  #deltaFailRate: number | null = null\n  #switchMiscount = 0\n  #manifestStats: ManifestVerificationStats | null = null\n  #fecFailClosed: FecFailClosedReason | null = null\n  /** Video-block resolutions from the repair lifecycle; null until the player feeds one. */\n  #lifecycle: { inband: number; fetch: number; failedKeyframe: number } | null = null\n\n  constructor(options: CmcdProducerOptions) {\n    this.#onCmcdPost = options.onCmcdPost\n    this.#intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS\n    if (!Number.isFinite(this.#intervalMs) || this.#intervalMs <= 0) {\n      throw new Error(`[CmcdProducer] invalid intervalMs \"${String(options.intervalMs)}\"; expected a positive number`)\n    }\n    this.#sessionId = options.sessionId ?? globalThis.crypto.randomUUID()\n    this.#now = options.now ?? Date.now\n  }\n\n  /** Update the stored transport state. Called by player wiring layer. */\n  updateTransport(snapshot: TransportSnapshot): void {\n    this.#transport = snapshot\n  }\n\n  /**\n   * Set the current play-mode, reported as `com.blockcast-pm`. Throws on any\n   * value outside {'full','base-only','single-track'} (CLAUDE.md: error on bad init).\n   */\n  updatePlayMode(mode: PlayMode): void {\n    if (typeof mode !== 'string' || !PLAY_MODES.includes(mode as PlayMode)) {\n      throw new Error(\n        `[CmcdProducer] invalid play-mode \"${String(mode)}\"; expected one of: ${PLAY_MODES.join(', ')}`,\n      )\n    }\n    this.#playMode = mode\n  }\n\n  /**\n   * Set the delta-track FEC block-failure rate (0..1 inclusive), reported as\n   * `com.blockcast-dfr` when play-mode is 'full' or 'base-only'.\n   */\n  updateDeltaFailRate(rate: number): void {\n    if (typeof rate !== 'number' || !Number.isFinite(rate) || rate < 0 || rate > 1) {\n      throw new Error(\n        `[CmcdProducer] invalid delta-fail-rate \"${String(rate)}\"; expected a finite number in [0, 1]`,\n      )\n    }\n    this.#deltaFailRate = rate\n  }\n\n  /** Bump the cumulative switching-set misalignment counter (`com.blockcast-sm`). */\n  incrementSwitchMiscount(): void {\n    this.#switchMiscount += 1\n  }\n\n  /**\n   * Record that FEC failed closed at runtime (fec-01 6.3.9). Reported at once\n   * as `e=e` with the reason code in `ec`, and on every later counter report\n   * as `com.blockcast-ffc` / `com.blockcast-ffl` (the held layer whose total\n   * B_i was undercut), so a stream playing without FEC is told apart from one\n   * with no loss.\n   */\n  updateFecFailClosed(reason: FecFailClosedReason): void {\n    const changed = this.#fecFailClosed?.code !== reason.code || this.#fecFailClosed?.layer !== reason.layer\n    this.#fecFailClosed = reason\n    if (changed) this.#post([{ ...this.#base('e'), ec: [reason.code] }])\n  }\n\n  updateManifestVerification(stats: ManifestVerificationStats): void {\n    this.#manifestStats = stats\n  }\n\n  /**\n   * Count a video block's resolution from the repair lifecycle: recovered in\n   * band (`com.blockcast-fbr`), recovered by repair FETCH (`-fbq`), or failed\n   * as a keyframe-class block (`-fbfk`). Audio blocks are not counted, matching\n   * the video-track `-fbf`. Until the player feeds this, the three are absent.\n   */\n  onRepairLifecycle(event: RepairLifecycleEvent): void {\n    this.#lifecycle ??= { inband: 0, fetch: 0, failedKeyframe: 0 }\n    if (event.type === 'recovered' && event.blockClass !== 'audio') {\n      if (event.via === 'inband') this.#lifecycle.inband++\n      else this.#lifecycle.fetch++\n    } else if (event.type === 'failed' && event.blockClass === 'keyframe') {\n      this.#lifecycle.failedKeyframe++\n    }\n  }\n\n  /** One-shot custom event `com.blockcast-switch-drift` for a single misalignment. */\n  emitSwitchDrift(driftUs: number): void {\n    if (typeof driftUs !== 'number' || !Number.isFinite(driftUs) || driftUs < 0) {\n      throw new Error(\n        `[CmcdProducer] invalid drift-us \"${String(driftUs)}\"; expected a non-negative finite number`,\n      )\n    }\n    const record: CmcdRecord = { ...this.#base('ce'), cen: CUSTOM_PREFIX + 'switch-drift' }\n    putCustom(record, 'sdu', Math.round(driftUs))\n    this.#post([record])\n  }\n\n  /** Take a FecTrackStats snapshot (first video track) and send the heartbeat when due. */\n  onSnapshot(data: SnapshotData): void {\n    const videoTrack = data.tracks.find(t => t.config.trackType === 'video')\n    if (!videoTrack) return\n    this.#lastStats = videoTrack\n    this.#heartbeat()\n  }\n\n  /**\n   * Take transport state for receivers that do not own FEC stats, and send the\n   * heartbeat when due.\n   */\n  onTransportSnapshot(data: TransportOnlySnapshotData): void {\n    if (!Number.isFinite(data.timestampMs) || data.timestampMs < 0) {\n      throw new Error('[CmcdProducer] transport snapshot timestamp must be a non-negative finite number')\n    }\n    if (data.playMode !== undefined) this.updatePlayMode(data.playMode)\n    if (data.switchMiscount !== undefined) {\n      if (!Number.isSafeInteger(data.switchMiscount) || data.switchMiscount < 0) {\n        throw new Error('[CmcdProducer] transport snapshot switch-miscount must be a non-negative safe integer')\n      }\n      this.#switchMiscount = data.switchMiscount\n    }\n    this.#transport = data.transport\n    this.#heartbeat()\n  }\n\n  /** Report a transport transition at once, as custom event `com.blockcast-ct`. */\n  onTransition(event: TransportTransitionEvent): void {\n    const record: CmcdRecord = { ...this.#base('ce'), cen: CUSTOM_PREFIX + 'ct' }\n    putCustom(record, 'ct', token(event))\n    this.#putTransport(record)\n    this.#post([record])\n  }\n\n  #base(event: string): CmcdRecord {\n    return { e: token(event), sid: this.#sessionId, sn: this.#sn++, ts: Math.floor(this.#now()), v: 2 }\n  }\n\n  #heartbeat(): void {\n    const now = this.#now()\n    if (this.#lastHeartbeat !== null && now - this.#lastHeartbeat < this.#intervalMs) return\n    this.#lastHeartbeat = now\n    this.#post([this.#base('t'), this.#counters()])\n  }\n\n  #putTransport(record: CmcdRecord): void {\n    const snap = this.#transport\n    if (!snap) return\n    putCustom(record, 'tr', token(TRANSPORT_TOKEN[snap.transport]))\n    if (snap.multicastGroup != null && snap.multicastSource != null) {\n      putCustom(record, 'sg', `${snap.multicastGroup}@${snap.multicastSource}`)\n    }\n    putCustom(record, 'ar', snap.amtRelay)\n  }\n\n  /** The `e=ce` counter report. */\n  #counters(): CmcdRecord {\n    const record: CmcdRecord = { ...this.#base('ce'), cen: CUSTOM_PREFIX + 'fec' }\n    const stats = this.#lastStats\n    if (stats) {\n      putCustom(record, 'fa', stats.config.algorithm)\n      putCustom(record, 'fk', stats.config.k)\n      // P as this receiver JOINED it: the sum of repairSymbols over the joined\n      // base layers, never including a keyframe overlay.\n      putCustom(record, 'fp', stats.config.repairCount)\n      putCustom(record, 'pr', stats.sourceSymbols)\n      putCustom(record, 'pl', stats.sourcePacketsMissing)\n      putCustom(record, 'pu', stats.sourcePacketsUnrecovered)\n      putCustom(record, 'fbf', stats.blocksFailed)\n    }\n    if (this.#lifecycle) {\n      putCustom(record, 'fbr', this.#lifecycle.inband)\n      putCustom(record, 'fbq', this.#lifecycle.fetch)\n      putCustom(record, 'fbfk', this.#lifecycle.failedKeyframe)\n    }\n    this.#putTransport(record)\n    if (this.#playMode !== null) {\n      putCustom(record, 'pm', token(this.#playMode))\n      if (this.#playMode !== 'single-track' && this.#deltaFailRate !== null) {\n        putCustom(record, 'dfr', this.#deltaFailRate.toFixed(3))\n      }\n    }\n    if (this.#fecFailClosed) {\n      putCustom(record, 'ffc', token(this.#fecFailClosed.code))\n      putCustom(record, 'ffl', this.#fecFailClosed.layer)\n    }\n    if (this.#switchMiscount > 0) putCustom(record, 'sm', this.#switchMiscount)\n    if (this.#manifestStats) {\n      putCustom(record, 'mv', this.#manifestStats.verified)\n      putCustom(record, 'mf', Object.values(this.#manifestStats.failures).reduce((a, b) => a + b, 0))\n    }\n    return record\n  }\n\n  #post(records: CmcdRecord[]): void {\n    this.#onCmcdPost?.(records.map(encodeCmcdRecord).join('\\n'))\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/delivery-catalog.js

@@ -1268,14 +1268,15 @@ var MOQT_PUBLISHER_PRIORITY = Object.freeze({
 });
 
 // node_modules/@blockcast/mmt-transport/dist/amt-gateway.js
+var MAX_PENDING_PACKETS = 256;
 var AMTGatewayManager = class {
   subscriptions = /* @__PURE__ */ new Map();
   messageHandler;
+  messageListenerRegistered = false;
   pendingPackets = /* @__PURE__ */ new Map();
   constructor() {
     this.messageHandler = (event) => {
       const data = event.data;
-      console.log(`[AMT] SW message received:`, data.type);
       if (data.type === "UDP_PACKET") {
         this.handlePacket(data);
       } else if (data.type === "SOCKET_ERROR") {
@@ -1284,12 +1285,22 @@ var AMTGatewayManager = class {
         console.log(`[AMT SW Debug] ${data.message}`);
       }
     };
-    if (typeof navigator !== "undefined" && navigator.serviceWorker) {
-      navigator.serviceWorker.addEventListener("message", this.messageHandler);
-      console.log("[AMT] Registered service worker message handler");
-    } else {
-      console.warn("[AMT] Service worker not available");
+  }
+  ensureMessageListener() {
+    if (this.messageListenerRegistered || typeof navigator === "undefined" || !navigator.serviceWorker || !this.messageHandler) {
+      return;
+    }
+    navigator.serviceWorker.addEventListener("message", this.messageHandler);
+    this.messageListenerRegistered = true;
+    console.log("[AMT] Registered service worker message handler");
+  }
+  removeMessageListener() {
+    if (!this.messageListenerRegistered)
+      return;
+    if (this.messageHandler && typeof navigator !== "undefined" && navigator.serviceWorker) {
+      navigator.serviceWorker.removeEventListener("message", this.messageHandler);
     }
+    this.messageListenerRegistered = false;
   }
   /**
    * Subscribe via AMT tunnel
@@ -1299,6 +1310,7 @@ var AMTGatewayManager = class {
     if (config.protected) {
       throw new Error("AMTGatewayManager refuses a protected join: it reports no per-datagram sender (multicast-02 7.2.7)");
     }
+    this.ensureMessageListener();
     const keyStr = this.getKeyString(key);
     if (this.subscriptions.has(keyStr)) {
       console.log(`[AMT] Reusing existing subscription to ${keyStr}`);
@@ -1334,6 +1346,8 @@ var AMTGatewayManager = class {
         this.subscriptions.delete(keyStr);
         this.pendingPackets.delete(subscription.subscriptionId);
       }
+      if (this.subscriptions.size === 0)
+        this.removeMessageListener();
       throw new Error(`Failed to subscribe via AMT: ${error instanceof Error ? error.message : String(error)}`);
     }
   }
@@ -1355,6 +1369,8 @@ var AMTGatewayManager = class {
     } finally {
       this.subscriptions.delete(handle);
       this.pendingPackets.delete(subscription.subscriptionId);
+      if (this.subscriptions.size === 0)
+        this.removeMessageListener();
     }
   }
   /**
@@ -1371,14 +1387,12 @@ var AMTGatewayManager = class {
     if (!subscriptionId)
       return;
     const subscription = this.subscriptions.get(subscriptionId);
-    if (!subscription) {
-      console.warn(`[AMT] Received packet for unknown subscription: ${subscriptionId}`);
+    if (!subscription)
       return;
-    }
     if (!subscription.handshakeComplete) {
       const queue = this.pendingPackets.get(subscriptionId);
       const packetData2 = data;
-      if (queue) {
+      if (queue && queue.length < MAX_PENDING_PACKETS) {
         queue.push({
           data: packetData2.data,
           remoteAddress: packetData2.remoteAddress,
@@ -1404,19 +1418,15 @@ var AMTGatewayManager = class {
     if (!subscriptionId)
       return;
     const subscription = this.subscriptions.get(subscriptionId);
-    if (!subscription) {
-      console.warn(`[AMT] Received error for unknown subscription: ${subscriptionId}`);
+    if (!subscription)
       return;
-    }
     subscription.config.onError(new Error(error || "Unknown error"));
   }
   /**
    * Cleanup on destroy
    */
   destroy() {
-    if (this.messageHandler && typeof navigator !== "undefined" && navigator.serviceWorker) {
-      navigator.serviceWorker.removeEventListener("message", this.messageHandler);
-    }
+    this.removeMessageListener();
     const handles = Array.from(this.subscriptions.keys());
     for (const handle of handles) {
       this.unsubscribe(handle).catch((err) => {