@blockcast/mmt-container 0.1.0-main.149f78a4adae

package/dist/track-session.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/transport-pool.ts", "../src/track-session.ts"],
+  "sourcesContent": ["/**\n * TransportPool \u2014 ref-counted subscription management for per-track transport.\n *\n * Tracks which consumers (identified by trackName) hold references to which\n * subscriptions (identified by a string key). When the last consumer releases\n * a subscription, it is closed.\n */\n\n/** Transport subscription mode \u2014 matches TrackState in the state machine. */\nexport type SubscriptionMode = 'multicast' | 'amt' | 'moq'\n\n/** Direct Socket health report (IWA transport). */\nexport interface DirectSocketHealth {\n  connected: boolean\n  bytesReceived: number\n  packetsReceived: number\n  errors: number\n}\n\n/** Subscription handle returned by acquireSubscription. */\nexport interface Subscription {\n  key: string\n  mode: SubscriptionMode\n  consumers: ReadonlySet<string>\n}\n\n/** Stats for a subscription. */\nexport interface SubscriptionStats {\n  activeSubscriptions: number\n  totalAcquires: number\n  totalReleases: number\n}\n\n/** Options for acquiring a subscription. */\nexport interface AcquireOptions {\n  /** Subscription key (e.g., \"(S,G,port)\" for multicast). */\n  key: string\n  /** Transport mode. */\n  mode: SubscriptionMode\n  /** Consumer identity (trackName). */\n  consumer: string\n}\n\nexport interface TransportPoolOptions {\n  /** Maximum concurrent subscriptions. 0 = unlimited. */\n  maxSubscriptions?: number\n}\n\ntype FailedCallback = (sub: { key: string; consumers: Set<string>; error: unknown }) => void\n\nexport class TransportPool {\n  readonly #subs = new Map<string, Subscription>()\n  readonly #options: TransportPoolOptions\n  #failedCb: FailedCallback | null = null\n  #stats: SubscriptionStats = { activeSubscriptions: 0, totalAcquires: 0, totalReleases: 0 }\n\n  constructor(options?: TransportPoolOptions) {\n    this.#options = options ?? {}\n  }\n\n  /** Register callback for subscription failures. */\n  onSubscriptionFailed(cb: FailedCallback): void {\n    this.#failedCb = cb\n  }\n\n  /** Acquire a subscription for a consumer. Returns the subscription. */\n  acquireSubscription(opts: AcquireOptions): Subscription\n  acquireSubscription(key: string, consumer: string): Subscription\n  acquireSubscription(keyOrOpts: string | AcquireOptions, consumer?: string): Subscription {\n    const key = typeof keyOrOpts === 'string' ? keyOrOpts : keyOrOpts.key\n    const cons = typeof keyOrOpts === 'string' ? consumer! : keyOrOpts.consumer\n    const mode: SubscriptionMode = typeof keyOrOpts === 'object' ? keyOrOpts.mode : 'moq'\n\n    let sub = this.#subs.get(key)\n    if (!sub) {\n      sub = { key, mode, consumers: new Set() }\n      this.#subs.set(key, sub)\n      this.#stats.activeSubscriptions++\n    }\n    ;(sub.consumers as Set<string>).add(cons)\n    this.#stats.totalAcquires++\n    return sub\n  }\n\n  /** Release a subscription for a consumer. Closes if last consumer. */\n  releaseSubscription(key: string, consumer: string): void {\n    const sub = this.#subs.get(key)\n    if (!sub) return\n    ;(sub.consumers as Set<string>).delete(consumer)\n    this.#stats.totalReleases++\n    if (sub.consumers.size === 0) {\n      this.#subs.delete(key)\n      this.#stats.activeSubscriptions--\n    }\n  }\n\n  /** Release all subscriptions held by a consumer. */\n  releaseAllForConsumer(consumer: string): void {\n    for (const [key, sub] of this.#subs) {\n      ;(sub.consumers as Set<string>).delete(consumer)\n      if (sub.consumers.size === 0) {\n        this.#subs.delete(key)\n        this.#stats.activeSubscriptions--\n      }\n    }\n  }\n\n  /** Report a subscription failure. */\n  reportFailure(key: string, error: unknown): void {\n    const sub = this.#subs.get(key)\n    if (sub) this.#failedCb?.({ key, consumers: sub.consumers as Set<string>, error })\n  }\n\n  /** Get stats. */\n  get stats(): Readonly<SubscriptionStats> { return this.#stats }\n\n  /** Clean up all subscriptions. */\n  dispose(): void {\n    this.#subs.clear()\n    this.#failedCb = null\n    this.#stats.activeSubscriptions = 0\n  }\n\n  /** Number of active subscriptions. */\n  get size(): number {\n    return this.#subs.size\n  }\n}\n", "/**\n * TrackSession \u2014 per-track transport state machine.\n * SessionManager \u2014 orchestrates all sessions + TransportPool.\n *\n * Implements Patent Claim 9 (draft-ramadan-moq-fec APPLICATION-1):\n *   (a) subscribe unicast\n *   (b) simultaneously join multicast\n *   (c) render from unicast during join\n *   (d) activate multicast on RAP, suppress unicast\n *   (e) cross-transport FEC repair during transition\n *   (f) hysteresis before switching away from multicast\n *   (g) re-subscribe unicast on sustained failure\n *\n * PIM: manages transport state without inspecting packet contents.\n */\n\nimport {\n  TransportPool,\n  type Subscription,\n  type SubscriptionMode,\n  type AcquireOptions,\n  type DirectSocketHealth,\n  type TransportPoolOptions,\n} from './transport-pool.js'\nimport { deriveFecInterleaveDepth } from '@blockcast/mmt-fec'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type TrackState =\n  | 'idle'\n  | 'unicast'\n  | 'unicast-fallback'\n  | 'joining'\n  | 'multicast'\n  | 'amt'\n  | 'failing'\n\nexport interface TrackSessionConfig {\n  trackName: string\n  trackType: 'video' | 'audio'\n  packetId: number\n  /** FEC interleave depth from catalog (ms). Used for hysteresis timer. */\n  fecInterleaveMs: number\n  /** FEC K from catalog. Used for audio worklet latency calculation. */\n  fecK: number\n  /** FEC repair symbols per block (P). NOT symbol size. */\n  fecRepairCount: number\n  /** FEC symbol size in bytes (T). Required for WASM decoder OTI. */\n  fecSymbolSize: number\n  /** MoQ repair track name from catalog FEC config. */\n  repairTrackName?: string\n  /** Frame samples from initData parsing (audio-init-parser.ts). */\n  frameSamples?: number\n  /** Audio sample rate from catalog. */\n  sampleRate?: number\n  /** Ordered transport preference: best first. */\n  preferredTransports: SubscriptionMode[]\n  /** Subscription key for multicast/AMT: \"(S,G,port)\". */\n  multicastKey?: string\n  /** MoQ track name for unicast subscription. */\n  moqTrackName?: string\n  /** AMT relay address (if AMT is in preference chain). */\n  amtRelay?: string\n  /** MoQ relay URL (for WebTransport subscription). */\n  moqRelayUrl?: string\n}\n\n// ---------------------------------------------------------------------------\n// PIM callbacks (protocol-independent \u2014 transport state only)\n// ---------------------------------------------------------------------------\n\nexport interface SessionManagerCallbacks {\n  /** Fired on every transport state transition. */\n  onStateChange?(trackName: string, from: TrackState, to: TrackState): void\n  /** Fired to suppress/unsuppress unicast for this track (transport arbitration). */\n  onSuppress?(trackName: string, suppressed: boolean): void\n  /**\n   * Fired when a track sat in `joining` for SessionManager.takeoverDeadlineMs\n   * without a RAP (BLO-9413/D9). The session has already returned to `unicast`\n   * (nothing was suppressed, so nothing to restore) \u2014 the host should abandon\n   * the multicast attempt (e.g. MediaRouter.failbackToMoq()) so the router\n   * stops waiting for a keyframe that is never coming.\n   */\n  onTakeoverTimeout?(trackName: string): void\n}\n\n// ---------------------------------------------------------------------------\n// MMTP application-layer extension (FEC lifecycle, media resets)\n// ---------------------------------------------------------------------------\n\n/**\n * MMTP track events (discriminated union).\n * Each protocol layer defines its own event union \u2014 MMTP events cover\n * media resets, latency, and FEC lifecycle.\n */\nexport type MmtpTrackEvent =\n  | { type: 'reset' }\n  | { type: 'latency'; latencyMs: number }\n  | { type: 'fec-setup' }\n  | { type: 'fec-teardown' }\n\n/**\n * MMTP application-layer extension of SessionManagerCallbacks.\n * Single onTrackEvent dispatches all MMTP-specific events.\n * PIM consumers use the base SessionManagerCallbacks (no onTrackEvent).\n *\n * IWA can define its own subinterface with its own TrackEvent union\n * (e.g., IwaTrackEvent for socket health, AMT state) using the same pattern.\n */\nexport interface MmtpSessionCallbacks extends SessionManagerCallbacks {\n  onTrackEvent?(trackName: string, event: MmtpTrackEvent, config: TrackSessionConfig): void\n}\n\n/**\n * Loss-hysteresis window covering the signaled interleave window plus jitter.\n *\n * This path lacks media cadence, so it intentionally does not estimate a full\n * source-plus-repair production horizon. FECManager uses\n * computeFecDeliveryWindowMs with media cadence when configuring block\n * inactivity deadlines.\n *\n * `fecK` no longer feeds the math; it is still validated as a catalog\n * well-formedness guard and kept in the signature for positional API compat\n * (removal is a follow-up with the next cross-repo pin bump).\n */\nexport function computeFecLossWindowMs(fecInterleaveMs: number, fecK: number, jitterBufferMs?: number): number {\n  return computeFecDeliveryWindowMs({\n    interleaveDepthMs: fecInterleaveMs,\n    sourceSymbols: fecK,\n    jitterBufferMs,\n  })\n}\n\nexport interface FecDeliveryWindowConfig {\n  interleaveDepthMs: number\n  sourceSymbols: number\n  repairSymbols?: number\n  symbolSize?: number\n  mediaUnitsPerSecond?: number\n  bandwidthBps?: number\n  /**\n   * Jitter + one-way-delay + reorder budget in ms (draft-ramadan-moq-fec \u00A79),\n   * sourced from the catalog `jitterBufferMs`. Added on top of the max-of-spans\n   * core; it is NOT a multiplier. See the margin-policy note in the function.\n   */\n  jitterBufferMs?: number\n}\n\n/**\n * Catalog-derived silence window that covers interleave geometry plus the time\n * required to produce or serialize a complete source+repair block. The catalog\n * field remains D media units; this function does not feed mapper geometry.\n */\nexport function computeFecDeliveryWindowMs(\n  config: FecDeliveryWindowConfig,\n): number {\n  const fecInterleaveMs = config.interleaveDepthMs\n  const fecK = config.sourceSymbols\n  if (fecInterleaveMs <= 0) {\n    throw new Error(\n      `[TrackSession] fecInterleaveMs=${fecInterleaveMs}. ` +\n      `Derive a positive FEC interleave window from the stream catalog.`\n    )\n  }\n  if (fecK <= 0) {\n    throw new Error(\n      `[TrackSession] fecK=${fecK}. ` +\n      `Derive a positive FEC source-symbol count from the stream catalog.`\n    )\n  }\n\n  const spansMs = [fecInterleaveMs]\n  if (config.mediaUnitsPerSecond && config.mediaUnitsPerSecond > 0) {\n    const mediaUnitMs = 1000 / config.mediaUnitsPerSecond\n    // interleaveDepthMs is integer catalog signaling while media-unit duration\n    // is often fractional (for example 4/30s = 133.33ms). Recover D using the\n    // producer's nearest-ms quantization, then cover every source and repair\n    // round-robin cycle. A decoder cannot recover a partial MFU until the\n    // repair tail arrives, so a K-only deadline expires the source fragments\n    // before the final repair symbols that complete them.\n    const interleaveUnits = deriveFecInterleaveDepth(fecInterleaveMs, mediaUnitMs)\n    const deliverySymbols = fecK + Math.max(0, config.repairSymbols ?? 0)\n    spansMs.push(deliverySymbols * interleaveUnits * mediaUnitMs)\n  }\n  if (\n    config.symbolSize &&\n    config.symbolSize > 0 &&\n    config.bandwidthBps &&\n    config.bandwidthBps > 0\n  ) {\n    const repairSymbols = Math.max(0, config.repairSymbols ?? 0)\n    spansMs.push(\n      ((fecK + repairSymbols) * config.symbolSize * 8 * 1000) /\n        config.bandwidthBps,\n    )\n  }\n\n  // draft-ramadan-moq-fec \u00A79: the recovery timeout is a DERIVED budget \u2014\n  // max(interleave span, source+repair production horizon, block serialization) PLUS\n  // an ADDITIVE margin for jitter + one-way delay + reorder. It MUST NOT be a\n  // fixed multiple of the interleave span (this replaces the retired `* 3` /\n  // `* 2` safety factors). The margin is the catalog `jitterBufferMs`.\n  //\n  // MARGIN-POLICY (operator sign-off \u2014 see PR): no catalog currently emits\n  // `jitterBufferMs`. Rather than throw (which would break every existing\n  // catalog) or invent a magic constant, the default margin is the un-rounded\n  // interleave window \u2014 the spec's natural reorder-budget bound and already a\n  // catalog value. Emit `jitterBufferMs` in the catalog to set it explicitly.\n  const coreMs = Math.max(...spansMs)\n  const marginMs =\n    config.jitterBufferMs !== undefined && config.jitterBufferMs >= 0\n      ? config.jitterBufferMs\n      : fecInterleaveMs\n  return Math.ceil(coreMs) + Math.ceil(marginMs)\n}\n\n/** Convert the shared FEC delivery deadline into an integer media timescale. */\nexport function computeFecDeliveryWindowMediaUnits(\n  config: FecDeliveryWindowConfig,\n  timestampTimescale: number,\n): number {\n  if (!Number.isFinite(timestampTimescale) || timestampTimescale <= 0) {\n    throw new Error(\n      `[TrackSession] timestampTimescale=${timestampTimescale}. ` +\n      'Derive a positive media timescale from the container.',\n    )\n  }\n  const deliveryWindow = Math.ceil(\n    computeFecDeliveryWindowMs(config) * timestampTimescale / 1000,\n  )\n  if (!Number.isSafeInteger(deliveryWindow)) {\n    throw new Error('[TrackSession] FEC delivery window exceeds the media timestamp range.')\n  }\n  return deliveryWindow\n}\n\n// ---------------------------------------------------------------------------\n// TrackSession\n// ---------------------------------------------------------------------------\n\nexport class TrackSession {\n  readonly config: TrackSessionConfig\n  #state: TrackState = 'idle'\n  #subscription: Subscription | null = null\n  #hysteresisTimer: ReturnType<typeof setTimeout> | null = null\n  #joinDeadlineTimer: ReturnType<typeof setTimeout> | null = null\n  #previousPrimary: SubscriptionMode | null = null\n  #manager: SessionManager\n  // Single suppression authority flag (BLO-9413 failback coherence): every\n  // suppress this session fires is recorded here, and every path that leaves\n  // a suppressed state unwinds through #unsuppress(). Before this flag,\n  // unsubscribe() only un-suppressed from multicast/amt \u2014 a session torn down\n  // from `failing` (exactly where a starving track sits) was re-subscribed to\n  // unicast with the host's media still muted: MoQ playing into a dead sink.\n  #suppressFired = false\n\n  constructor(config: TrackSessionConfig, manager: SessionManager) {\n    this.config = config\n    this.#manager = manager\n  }\n\n  // -----------------------------------------------------------------------\n  // State\n  // -----------------------------------------------------------------------\n\n  get state(): TrackState { return this.#state }\n  get subscription(): Subscription | null { return this.#subscription }\n\n  /** True while this session's onSuppress(true) is outstanding (no matching\n   *  onSuppress(false) yet). Test/assertion surface for failback coherence. */\n  get isSuppressed(): boolean { return this.#suppressFired }\n\n  /** Current active transport mode, or null if idle. */\n  get transport(): SubscriptionMode | null {\n    switch (this.#state) {\n      case 'multicast': return 'multicast'\n      case 'amt': return 'amt'\n      case 'unicast': return 'moq'\n      case 'unicast-fallback': return 'moq' // SSM bridge absent \u2014 MoQ unicast is the only source\n      case 'joining': return 'moq' // MoQ still primary during join\n      case 'failing': return this.#previousPrimary\n      default: return null\n    }\n  }\n\n  // -----------------------------------------------------------------------\n  // Computed (no magic numbers)\n  // -----------------------------------------------------------------------\n\n  /** Audio worklet latency: max(fecInterleaveMs, frameDurationMs * fecK).\n   *  Returns undefined if frame duration unknown (no initData). */\n  get audioLatencyMs(): number | undefined {\n    const fd = this.frameDurationMs\n    if (fd === undefined) {\n      return this.config.fecInterleaveMs > 0 ? this.config.fecInterleaveMs : undefined\n    }\n    return Math.max(this.config.fecInterleaveMs, fd * this.config.fecK)\n  }\n\n  /** Frame duration in ms, derived from frameSamples + sampleRate. */\n  get frameDurationMs(): number | undefined {\n    const { frameSamples, sampleRate } = this.config\n    if (!frameSamples || !sampleRate || sampleRate <= 0) return undefined\n    return (frameSamples / sampleRate) * 1000\n  }\n\n  // -----------------------------------------------------------------------\n  // Transitions (Patent Claim 9)\n  // -----------------------------------------------------------------------\n\n  /** idle \u2192 unicast: player subscribes to this track. */\n  subscribe(): void {\n    if (this.#state !== 'idle') return\n    this.#transition('unicast')\n\n    // Emit audio latency on first subscribe\n    if (this.config.trackType === 'audio') {\n      const latency = this.audioLatencyMs\n      if (latency !== undefined) {\n        this.#manager.mmtp?.onTrackEvent?.(this.config.trackName, { type: 'latency', latencyMs: latency }, this.config)\n      }\n    }\n  }\n\n  /** unicast \u2192 joining: multicast/AMT capability detected, join in progress. */\n  joinStarted(): void {\n    if (this.#state !== 'unicast') return\n    this.#transition('joining')\n    // FEC decoders must be ready before multicast data arrives (Claim 9e: cross-transport repair)\n    this.#manager.mmtp?.onTrackEvent?.(this.config.trackName, { type: 'fec-setup' }, this.config)\n  }\n\n  /**\n   * any non-fallback state \u2192 unicast-fallback. Used when the SSM bridge is\n   * absent (vanilla Chromium / no extension) and the host falls back to a\n   * MoQ unicast subscription per track. Terminal-ish: activateMulticast,\n   * failbackAll, and transportFailed are no-ops while in this state.\n   *\n   * Fires fec-setup so the per-track repair worker spins up \u2014 repair packets\n   * still flow over the MoQ repair-track subscription, so FEC source+repair\n   * can converge as in the multicast path.\n   *\n   * Audio latency is NOT re-emitted here: subscribe() already fires latency\n   * once on the idle \u2192 unicast edge, and enterUnicastFallback is only ever\n   * reached from a non-idle state (SessionManager skips idle sessions).\n   */\n  enterUnicastFallback(): void {\n    if (this.#state === 'unicast-fallback') return\n    this.#clearHysteresis()\n    this.#transition('unicast-fallback')\n    // Suppress the redundant unicast media decoder. On the no-bridge path the\n    // host feeds MoQ-unicast source packets into MulticastManager (the render\n    // consumer); a second base-media subscribe (the @moq/watch decoder) would\n    // split the single connection's QUIC flow-control budget and stall delivery\n    // (BLO-8969). Fire suppress here, on the fallback edge, so the decoder is\n    // gated off before it subscribes rather than after the relay forward task\n    // has already wedged.\n    this.#suppress()\n    this.#manager.mmtp?.onTrackEvent?.(this.config.trackName, { type: 'fec-setup' }, this.config)\n  }\n\n  /**\n   * unicast-fallback \u2192 unicast. Called when the SSM bridge appears mid-session\n   * (extension installed after fallback engaged). Host first aborts the fallback\n   * drainers, then transitions sessions back to unicast so the regular\n   * multicast/AMT preference chain can take over via joinStarted().\n   */\n  exitUnicastFallback(): void {\n    if (this.#state !== 'unicast-fallback') return\n    this.#transition('unicast')\n    // Un-suppress the unicast decoder: the bridge appeared mid-session, so the\n    // host tears down the fallback drainers and the regular preference chain\n    // (joinStarted -> joining -> rapReceived) will re-suppress on multicast RAP.\n    this.#unsuppress()\n  }\n\n  /**\n   * joining \u2192 multicast or amt: RAP received on the joined transport (Claim 9d).\n   * Resets audio worklet, then suppresses MoQ.\n   */\n  rapReceived(mode: 'multicast' | 'amt'): void {\n    if (this.#state !== 'joining') return\n    this.#previousPrimary = mode\n    this.#transition(mode)\n    if (this.config.trackType === 'audio') {\n      this.#manager.mmtp?.onTrackEvent?.(this.config.trackName, { type: 'reset' }, this.config)\n    }\n    this.#suppress()\n  }\n\n  /** multicast/amt \u2192 failing: loss detected, start hysteresis timer (Claim 9f). */\n  lossDetected(): void {\n    if (this.#state !== 'multicast' && this.#state !== 'amt') return\n    this.#previousPrimary = this.#state as SubscriptionMode\n    this.#transition('failing')\n\n    // Hysteresis timer: sustained loss before failback (Claim 9f). The window\n    // covers a complete FEC block plus safety margin: the catalog interleave\n    // value IS the block span (interleaveDepthMs, \u00A75.1), scaled by the same\n    // safety factor FECManager uses for its block timeout.\n    const hysteresisMs = computeFecLossWindowMs(this.config.fecInterleaveMs, this.config.fecK)\n    this.#hysteresisTimer = setTimeout(() => {\n      this.hysteresisExpired()\n    }, hysteresisMs)\n  }\n\n  /** failing \u2192 previous primary: loss recovered within hysteresis window. */\n  lossRecovered(): void {\n    if (this.#state !== 'failing') return\n    this.#clearHysteresis()\n    if (this.#previousPrimary) {\n      this.#transition(this.#previousPrimary as TrackState)\n    }\n  }\n\n  /**\n   * Transport failed (AMT relay down, multicast interface gone).\n   * Try next transport in preference chain.\n   */\n  transportFailed(): void {\n    this.#clearHysteresis()\n    // Unicast-fallback is terminal \u2014 the host owns the subscription and\n    // SessionManager transport machinery does not arbitrate it.\n    if (this.#state === 'unicast-fallback') return\n    const current = this.#previousPrimary ?? this.transport\n    const prefs = this.config.preferredTransports\n    const currentIdx = current ? prefs.indexOf(current) : -1\n    const nextMode = prefs[currentIdx + 1]\n\n    if (nextMode) {\n      // Failover to next in chain\n      if (nextMode === 'moq') {\n        this.#transition('unicast')\n        this.#unsuppress()\n        if (this.config.trackType === 'audio') {\n          this.#manager.mmtp?.onTrackEvent?.(this.config.trackName, { type: 'reset' }, this.config)\n        }\n      } else {\n        // Next is multicast or AMT \u2014 start joining. `joining` means MoQ is\n        // primary again (see transport getter) \u2014 if the failed transport had\n        // suppressed unicast, restore it for the join window or the viewer\n        // watches black video until the next RAP (which may never come).\n        this.#transition('joining')\n        this.#unsuppress()\n      }\n    } else {\n      // End of chain \u2014 fall back to unicast (Claim 9g)\n      this.#transition('unicast')\n      this.#unsuppress()\n      if (this.config.trackType === 'audio') {\n        this.#manager.mmtp?.onTrackEvent?.(this.config.trackName, { type: 'reset' }, this.config)\n      }\n    }\n  }\n\n  /** Hysteresis expired \u2192 failback to next transport (Claim 9g). */\n  hysteresisExpired(): void {\n    if (this.#state !== 'failing') return\n    this.#clearHysteresis()\n    this.transportFailed()\n  }\n\n  /** \u2192 idle: player unsubscribes / tab close / cleanup. */\n  unsubscribe(): void {\n    this.#clearHysteresis()\n    if (this.#state !== 'idle') {\n      this.#transition('idle')\n      // Unwind any outstanding suppression regardless of which state we left.\n      // The old `wasActive` check (multicast/amt only) leaked suppression when\n      // tearing down from `failing` or `unicast-fallback` \u2014 failbackAll()'s\n      // unsubscribe\u2192subscribe cycle then re-entered unicast with the host's\n      // media still muted (BLO-9413 freeze: \"failing back\" logged, video dead).\n      this.#unsuppress()\n    }\n  }\n\n  /** True when SessionManager.enterUnicastFallback put this track into the\n   *  host-driven unicast subscription mode. Host can iterate sessions to\n   *  decide whether to keep its fallback drainer alive across MediaRouter\n   *  arbitration events. */\n  get isUnicastFallback(): boolean {\n    return this.#state === 'unicast-fallback'\n  }\n\n  dispose(): void {\n    this.#clearHysteresis()\n    this.#clearJoinDeadline()\n    this.#state = 'idle'\n    this.#subscription = null\n  }\n\n  // -----------------------------------------------------------------------\n  // Internal\n  // -----------------------------------------------------------------------\n\n  #transition(to: TrackState): void {\n    const from = this.#state\n    if (from === to) return\n    this.#state = to\n    // Takeover deadline (BLO-9413/D9): every entry into `joining` arms it\n    // (joinStarted AND transportFailed-failover both route through here);\n    // every exit cancels it. Without this, a transport that accepts the\n    // subscribe but never delivers a RAP parks the session in `joining`\n    // forever (observed live in the Phase-0 headless repro).\n    if (from === 'joining') this.#clearJoinDeadline()\n    if (to === 'joining') this.#armJoinDeadline()\n    // FEC teardown: leaving FEC-active states \u2192 non-FEC state\n    const fecActive = (s: TrackState) =>\n      s === 'joining' ||\n      s === 'multicast' ||\n      s === 'amt' ||\n      s === 'failing' ||\n      s === 'unicast-fallback'\n    if (fecActive(from) && !fecActive(to)) {\n      this.#manager.mmtp?.onTrackEvent?.(this.config.trackName, { type: 'fec-teardown' }, this.config)\n    }\n    this.#manager.callbacks?.onStateChange?.(this.config.trackName, from, to)\n  }\n\n  #clearHysteresis(): void {\n    if (this.#hysteresisTimer !== null) {\n      clearTimeout(this.#hysteresisTimer)\n      this.#hysteresisTimer = null\n    }\n  }\n\n  #armJoinDeadline(): void {\n    this.#clearJoinDeadline()\n    const deadlineMs = this.#manager.takeoverDeadlineMs\n    if (deadlineMs <= 0) return // disabled\n    this.#joinDeadlineTimer = setTimeout(() => {\n      this.#joinDeadlineTimer = null\n      if (this.#state !== 'joining') return\n      // No RAP within the deadline: return to unicast. MoQ was never\n      // suppressed in `joining`, so there is nothing to restore \u2014 this edge\n      // must stay silent on onSuppress (asserted in tests).\n      this.#transition('unicast')\n      this.#manager.callbacks?.onTakeoverTimeout?.(this.config.trackName)\n    }, deadlineMs)\n  }\n\n  #clearJoinDeadline(): void {\n    if (this.#joinDeadlineTimer !== null) {\n      clearTimeout(this.#joinDeadlineTimer)\n      this.#joinDeadlineTimer = null\n    }\n  }\n\n  /** Fire onSuppress(true) exactly once per suppression epoch. */\n  #suppress(): void {\n    if (this.#suppressFired) return\n    this.#suppressFired = true\n    this.#manager.callbacks?.onSuppress?.(this.config.trackName, true)\n  }\n\n  /** Unwind an outstanding suppression; no-op when none is outstanding. */\n  #unsuppress(): void {\n    if (!this.#suppressFired) return\n    this.#suppressFired = false\n    this.#manager.callbacks?.onSuppress?.(this.config.trackName, false)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// SessionManager\n// ---------------------------------------------------------------------------\n\nexport class SessionManager {\n  readonly pool: TransportPool\n  readonly sessions = new Map<string, TrackSession>()\n  callbacks: SessionManagerCallbacks | null = null\n  /**\n   * Takeover deadline (BLO-9413/D9): max time a session may sit in `joining`\n   * without a RAP before returning to `unicast` and firing onTakeoverTimeout.\n   * MoQ is never suppressed during `joining`, so expiry is a silent abandon \u2014\n   * playback never glitches. Hosts tune per stream (e.g. GOP length); 0\n   * disables.\n   */\n  takeoverDeadlineMs = 5000\n\n  /** Narrow to MMTP callbacks (onTrackEvent). Safe \u2014 optional chaining handles PIM-only consumers. */\n  get mmtp(): MmtpSessionCallbacks | null {\n    return this.callbacks as MmtpSessionCallbacks | null\n  }\n\n  constructor(poolOptions?: TransportPoolOptions) {\n    this.pool = new TransportPool(poolOptions)\n\n    // Wire pool failure \u2192 per-track failover\n    this.pool.onSubscriptionFailed(sub => {\n      for (const trackName of sub.consumers) {\n        const session = this.sessions.get(trackName)\n        if (session) session.transportFailed()\n      }\n    })\n  }\n\n  // -----------------------------------------------------------------------\n  // Track management\n  // -----------------------------------------------------------------------\n\n  /** Add a track session from catalog config. */\n  addTrack(config: TrackSessionConfig): TrackSession {\n    if (this.sessions.has(config.trackName)) {\n      throw new Error(`[SessionManager] Track \"${config.trackName}\" already exists`)\n    }\n    const session = new TrackSession(config, this)\n    this.sessions.set(config.trackName, session)\n    return session\n  }\n\n  /** Remove a track session. Releases subscription with grace period. */\n  removeTrack(trackName: string): void {\n    const session = this.sessions.get(trackName)\n    if (!session) return\n    session.unsubscribe()\n\n    // Release pool subscription\n    const subKey = session.config.multicastKey ?? session.config.moqTrackName\n    if (subKey) this.pool.releaseSubscription(subKey, trackName)\n\n    session.dispose()\n    this.sessions.delete(trackName)\n  }\n\n  // -----------------------------------------------------------------------\n  // Atomic multi-track operations\n  // -----------------------------------------------------------------------\n\n  /**\n   * All tracks with multicast RAP \u2192 multicast state (atomic).\n   * Called when MediaRouter fires onSourceSwitch('multicast').\n   * Prevents split-brain between video and audio.\n   *\n   * A takeover deadline can return a track from `joining` to `unicast` while\n   * the multicast socket keeps delivering packets. If a valid RAP arrives\n   * later, allow that late-RAP edge to suppress unicast and promote multicast.\n   */\n  activateMulticast(): void {\n    for (const [, session] of this.sessions) {\n      if (session.state === 'unicast') {\n        session.joinStarted()\n      }\n      if (session.state === 'joining') {\n        session.rapReceived('multicast')\n      }\n    }\n  }\n\n  /**\n   * All tracks with AMT RAP \u2192 amt state (atomic).\n   */\n  activateAmt(): void {\n    for (const [, session] of this.sessions) {\n      if (session.state === 'unicast') {\n        session.joinStarted()\n      }\n      if (session.state === 'joining') {\n        session.rapReceived('amt')\n      }\n    }\n  }\n\n  /**\n   * All tracks \u2192 unicast (failback, atomic).\n   * Called when MulticastManager fires onFailback().\n   * unicast-fallback sessions are skipped \u2014 the host owns those subscriptions\n   * and they must drain uninterrupted across transport-state events.\n   *\n   * Coherence invariant (BLO-9413): after this returns, every non-fallback\n   * session is `unicast` (or `idle`) AND unsuppressed \u2014 unsubscribe() unwinds\n   * any outstanding suppression regardless of the state it tears down from\n   * (`failing` included; see TrackSession.#suppressFired).\n   */\n  failbackAll(): void {\n    for (const [, session] of this.sessions) {\n      if (\n        session.state !== 'idle' &&\n        session.state !== 'unicast' &&\n        session.state !== 'unicast-fallback'\n      ) {\n        session.unsubscribe()\n        session.subscribe() // re-enter unicast\n      }\n    }\n  }\n\n  /**\n   * All tracks \u2192 unicast-fallback (atomic).\n   * Called by the host when the multicast gateway is absent and\n   * the player will subscribe to source tracks over MoQ unicast and feed\n   * packets via MulticastManager.feedUnicastSource() (or manager.router\n   * directly). Sessions in this state stay terminal until the host calls\n   * unsubscribe() / disposes the SessionManager.\n   */\n  enterUnicastFallback(): void {\n    for (const [, session] of this.sessions) {\n      if (session.state === 'idle') continue\n      session.enterUnicastFallback()\n    }\n  }\n\n  /**\n   * True if any session is currently in unicast-fallback. Hosts use this to\n   * gate `multicastTrack.close()` on failback events \u2014 closing the shared\n   * broadcast would kill the host's fallback drainers.\n   */\n  hasActiveFallback(): boolean {\n    for (const [, session] of this.sessions) {\n      if (session.isUnicastFallback) return true\n    }\n    return false\n  }\n\n  /**\n   * All fallback tracks \u2192 unicast (atomic).\n   * Called when the SSM bridge appears mid-session and the host has aborted\n   * the fallback drainers. The session re-enters the regular preference chain\n   * via joinStarted() (issued by the host immediately after).\n   */\n  exitUnicastFallback(): void {\n    for (const [, session] of this.sessions) {\n      if (session.isUnicastFallback) session.exitUnicastFallback()\n    }\n  }\n\n  // -----------------------------------------------------------------------\n  // Cleanup lifecycle\n  // -----------------------------------------------------------------------\n\n  /** Tab closed \u2014 release all subscriptions for this tab (grace period). */\n  tabClosed(tabId: string): void {\n    // All tracks owned by this tab \u2192 idle\n    for (const [trackName, session] of this.sessions) {\n      session.unsubscribe()\n      this.pool.releaseAllForConsumer(trackName)\n    }\n  }\n\n  /** Bridge WebTransport connection dropped \u2014 same as tab close. */\n  bridgeDisconnected(): void {\n    this.tabClosed('bridge')\n  }\n\n  /**\n   * Track selection changed (user or ABR).\n   * Old track released (grace period), new track subscribed.\n   */\n  trackSelectionChanged(oldTrackName: string, newConfig: TrackSessionConfig): void {\n    this.removeTrack(oldTrackName)\n    const session = this.addTrack(newConfig)\n    session.subscribe()\n  }\n\n  // -----------------------------------------------------------------------\n  // Query\n  // -----------------------------------------------------------------------\n\n  /** Get a track session by name. */\n  getTrack(trackName: string): TrackSession | undefined {\n    return this.sessions.get(trackName)\n  }\n\n  // -----------------------------------------------------------------------\n  // Cleanup\n  // -----------------------------------------------------------------------\n\n  dispose(): void {\n    for (const [, session] of this.sessions) {\n      session.dispose()\n    }\n    this.sessions.clear()\n    this.pool.dispose()\n    this.callbacks = null\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/transport-pool.d.ts

@@ -0,0 +1,69 @@
+/**
+ * TransportPool — ref-counted subscription management for per-track transport.
+ *
+ * Tracks which consumers (identified by trackName) hold references to which
+ * subscriptions (identified by a string key). When the last consumer releases
+ * a subscription, it is closed.
+ */
+/** Transport subscription mode — matches TrackState in the state machine. */
+export type SubscriptionMode = 'multicast' | 'amt' | 'moq';
+/** Direct Socket health report (IWA transport). */
+export interface DirectSocketHealth {
+    connected: boolean;
+    bytesReceived: number;
+    packetsReceived: number;
+    errors: number;
+}
+/** Subscription handle returned by acquireSubscription. */
+export interface Subscription {
+    key: string;
+    mode: SubscriptionMode;
+    consumers: ReadonlySet<string>;
+}
+/** Stats for a subscription. */
+export interface SubscriptionStats {
+    activeSubscriptions: number;
+    totalAcquires: number;
+    totalReleases: number;
+}
+/** Options for acquiring a subscription. */
+export interface AcquireOptions {
+    /** Subscription key (e.g., "(S,G,port)" for multicast). */
+    key: string;
+    /** Transport mode. */
+    mode: SubscriptionMode;
+    /** Consumer identity (trackName). */
+    consumer: string;
+}
+export interface TransportPoolOptions {
+    /** Maximum concurrent subscriptions. 0 = unlimited. */
+    maxSubscriptions?: number;
+}
+type FailedCallback = (sub: {
+    key: string;
+    consumers: Set<string>;
+    error: unknown;
+}) => void;
+export declare class TransportPool {
+    #private;
+    constructor(options?: TransportPoolOptions);
+    /** Register callback for subscription failures. */
+    onSubscriptionFailed(cb: FailedCallback): void;
+    /** Acquire a subscription for a consumer. Returns the subscription. */
+    acquireSubscription(opts: AcquireOptions): Subscription;
+    acquireSubscription(key: string, consumer: string): Subscription;
+    /** Release a subscription for a consumer. Closes if last consumer. */
+    releaseSubscription(key: string, consumer: string): void;
+    /** Release all subscriptions held by a consumer. */
+    releaseAllForConsumer(consumer: string): void;
+    /** Report a subscription failure. */
+    reportFailure(key: string, error: unknown): void;
+    /** Get stats. */
+    get stats(): Readonly<SubscriptionStats>;
+    /** Clean up all subscriptions. */
+    dispose(): void;
+    /** Number of active subscriptions. */
+    get size(): number;
+}
+export {};
+//# sourceMappingURL=transport-pool.d.ts.map

package/dist/transport-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-pool.d.ts","sourceRoot":"","sources":["../src/transport-pool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,KAAK,GAAG,KAAK,CAAA;AAE1D,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,gBAAgB,CAAA;IACtB,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC/B;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAA;IACX,sBAAsB;IACtB,IAAI,EAAE,gBAAgB,CAAA;IACtB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,KAAK,cAAc,GAAG,CAAC,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,CAAA;AAE5F,qBAAa,aAAa;;gBAMZ,OAAO,CAAC,EAAE,oBAAoB;IAI1C,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAI9C,uEAAuE;IACvE,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY;IACvD,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAiBhE,sEAAsE;IACtE,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWxD,oDAAoD;IACpD,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU7C,qCAAqC;IACrC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAKhD,iBAAiB;IACjB,IAAI,KAAK,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAAuB;IAE/D,kCAAkC;IAClC,OAAO,IAAI,IAAI;IAMf,sCAAsC;IACtC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/transport-pool.js

@@ -0,0 +1,88 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+
+// src/transport-pool.ts
+var _subs, _options, _failedCb, _stats;
+var TransportPool = class {
+  constructor(options) {
+    __privateAdd(this, _subs, /* @__PURE__ */ new Map());
+    __privateAdd(this, _options);
+    __privateAdd(this, _failedCb, null);
+    __privateAdd(this, _stats, { activeSubscriptions: 0, totalAcquires: 0, totalReleases: 0 });
+    __privateSet(this, _options, options ?? {});
+  }
+  /** Register callback for subscription failures. */
+  onSubscriptionFailed(cb) {
+    __privateSet(this, _failedCb, cb);
+  }
+  acquireSubscription(keyOrOpts, consumer) {
+    const key = typeof keyOrOpts === "string" ? keyOrOpts : keyOrOpts.key;
+    const cons = typeof keyOrOpts === "string" ? consumer : keyOrOpts.consumer;
+    const mode = typeof keyOrOpts === "object" ? keyOrOpts.mode : "moq";
+    let sub = __privateGet(this, _subs).get(key);
+    if (!sub) {
+      sub = { key, mode, consumers: /* @__PURE__ */ new Set() };
+      __privateGet(this, _subs).set(key, sub);
+      __privateGet(this, _stats).activeSubscriptions++;
+    }
+    ;
+    sub.consumers.add(cons);
+    __privateGet(this, _stats).totalAcquires++;
+    return sub;
+  }
+  /** Release a subscription for a consumer. Closes if last consumer. */
+  releaseSubscription(key, consumer) {
+    const sub = __privateGet(this, _subs).get(key);
+    if (!sub) return;
+    sub.consumers.delete(consumer);
+    __privateGet(this, _stats).totalReleases++;
+    if (sub.consumers.size === 0) {
+      __privateGet(this, _subs).delete(key);
+      __privateGet(this, _stats).activeSubscriptions--;
+    }
+  }
+  /** Release all subscriptions held by a consumer. */
+  releaseAllForConsumer(consumer) {
+    for (const [key, sub] of __privateGet(this, _subs)) {
+      ;
+      sub.consumers.delete(consumer);
+      if (sub.consumers.size === 0) {
+        __privateGet(this, _subs).delete(key);
+        __privateGet(this, _stats).activeSubscriptions--;
+      }
+    }
+  }
+  /** Report a subscription failure. */
+  reportFailure(key, error) {
+    var _a;
+    const sub = __privateGet(this, _subs).get(key);
+    if (sub) (_a = __privateGet(this, _failedCb)) == null ? void 0 : _a.call(this, { key, consumers: sub.consumers, error });
+  }
+  /** Get stats. */
+  get stats() {
+    return __privateGet(this, _stats);
+  }
+  /** Clean up all subscriptions. */
+  dispose() {
+    __privateGet(this, _subs).clear();
+    __privateSet(this, _failedCb, null);
+    __privateGet(this, _stats).activeSubscriptions = 0;
+  }
+  /** Number of active subscriptions. */
+  get size() {
+    return __privateGet(this, _subs).size;
+  }
+};
+_subs = new WeakMap();
+_options = new WeakMap();
+_failedCb = new WeakMap();
+_stats = new WeakMap();
+export {
+  TransportPool
+};
+//# sourceMappingURL=transport-pool.js.map

package/dist/transport-pool.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/transport-pool.ts"],
+  "sourcesContent": ["/**\n * TransportPool \u2014 ref-counted subscription management for per-track transport.\n *\n * Tracks which consumers (identified by trackName) hold references to which\n * subscriptions (identified by a string key). When the last consumer releases\n * a subscription, it is closed.\n */\n\n/** Transport subscription mode \u2014 matches TrackState in the state machine. */\nexport type SubscriptionMode = 'multicast' | 'amt' | 'moq'\n\n/** Direct Socket health report (IWA transport). */\nexport interface DirectSocketHealth {\n  connected: boolean\n  bytesReceived: number\n  packetsReceived: number\n  errors: number\n}\n\n/** Subscription handle returned by acquireSubscription. */\nexport interface Subscription {\n  key: string\n  mode: SubscriptionMode\n  consumers: ReadonlySet<string>\n}\n\n/** Stats for a subscription. */\nexport interface SubscriptionStats {\n  activeSubscriptions: number\n  totalAcquires: number\n  totalReleases: number\n}\n\n/** Options for acquiring a subscription. */\nexport interface AcquireOptions {\n  /** Subscription key (e.g., \"(S,G,port)\" for multicast). */\n  key: string\n  /** Transport mode. */\n  mode: SubscriptionMode\n  /** Consumer identity (trackName). */\n  consumer: string\n}\n\nexport interface TransportPoolOptions {\n  /** Maximum concurrent subscriptions. 0 = unlimited. */\n  maxSubscriptions?: number\n}\n\ntype FailedCallback = (sub: { key: string; consumers: Set<string>; error: unknown }) => void\n\nexport class TransportPool {\n  readonly #subs = new Map<string, Subscription>()\n  readonly #options: TransportPoolOptions\n  #failedCb: FailedCallback | null = null\n  #stats: SubscriptionStats = { activeSubscriptions: 0, totalAcquires: 0, totalReleases: 0 }\n\n  constructor(options?: TransportPoolOptions) {\n    this.#options = options ?? {}\n  }\n\n  /** Register callback for subscription failures. */\n  onSubscriptionFailed(cb: FailedCallback): void {\n    this.#failedCb = cb\n  }\n\n  /** Acquire a subscription for a consumer. Returns the subscription. */\n  acquireSubscription(opts: AcquireOptions): Subscription\n  acquireSubscription(key: string, consumer: string): Subscription\n  acquireSubscription(keyOrOpts: string | AcquireOptions, consumer?: string): Subscription {\n    const key = typeof keyOrOpts === 'string' ? keyOrOpts : keyOrOpts.key\n    const cons = typeof keyOrOpts === 'string' ? consumer! : keyOrOpts.consumer\n    const mode: SubscriptionMode = typeof keyOrOpts === 'object' ? keyOrOpts.mode : 'moq'\n\n    let sub = this.#subs.get(key)\n    if (!sub) {\n      sub = { key, mode, consumers: new Set() }\n      this.#subs.set(key, sub)\n      this.#stats.activeSubscriptions++\n    }\n    ;(sub.consumers as Set<string>).add(cons)\n    this.#stats.totalAcquires++\n    return sub\n  }\n\n  /** Release a subscription for a consumer. Closes if last consumer. */\n  releaseSubscription(key: string, consumer: string): void {\n    const sub = this.#subs.get(key)\n    if (!sub) return\n    ;(sub.consumers as Set<string>).delete(consumer)\n    this.#stats.totalReleases++\n    if (sub.consumers.size === 0) {\n      this.#subs.delete(key)\n      this.#stats.activeSubscriptions--\n    }\n  }\n\n  /** Release all subscriptions held by a consumer. */\n  releaseAllForConsumer(consumer: string): void {\n    for (const [key, sub] of this.#subs) {\n      ;(sub.consumers as Set<string>).delete(consumer)\n      if (sub.consumers.size === 0) {\n        this.#subs.delete(key)\n        this.#stats.activeSubscriptions--\n      }\n    }\n  }\n\n  /** Report a subscription failure. */\n  reportFailure(key: string, error: unknown): void {\n    const sub = this.#subs.get(key)\n    if (sub) this.#failedCb?.({ key, consumers: sub.consumers as Set<string>, error })\n  }\n\n  /** Get stats. */\n  get stats(): Readonly<SubscriptionStats> { return this.#stats }\n\n  /** Clean up all subscriptions. */\n  dispose(): void {\n    this.#subs.clear()\n    this.#failedCb = null\n    this.#stats.activeSubscriptions = 0\n  }\n\n  /** Number of active subscriptions. */\n  get size(): number {\n    return this.#subs.size\n  }\n}\n"],
+  "mappings": ";;;;;;;;;AAAA;AAkDO,IAAM,gBAAN,MAAoB;AAAA,EAMzB,YAAY,SAAgC;AAL5C,uBAAS,OAAQ,oBAAI,IAA0B;AAC/C,uBAAS;AACT,kCAAmC;AACnC,+BAA4B,EAAE,qBAAqB,GAAG,eAAe,GAAG,eAAe,EAAE;AAGvF,uBAAK,UAAW,WAAW,CAAC;AAAA,EAC9B;AAAA;AAAA,EAGA,qBAAqB,IAA0B;AAC7C,uBAAK,WAAY;AAAA,EACnB;AAAA,EAKA,oBAAoB,WAAoC,UAAiC;AACvF,UAAM,MAAM,OAAO,cAAc,WAAW,YAAY,UAAU;AAClE,UAAM,OAAO,OAAO,cAAc,WAAW,WAAY,UAAU;AACnE,UAAM,OAAyB,OAAO,cAAc,WAAW,UAAU,OAAO;AAEhF,QAAI,MAAM,mBAAK,OAAM,IAAI,GAAG;AAC5B,QAAI,CAAC,KAAK;AACR,YAAM,EAAE,KAAK,MAAM,WAAW,oBAAI,IAAI,EAAE;AACxC,yBAAK,OAAM,IAAI,KAAK,GAAG;AACvB,yBAAK,QAAO;AAAA,IACd;AACA;AAAC,IAAC,IAAI,UAA0B,IAAI,IAAI;AACxC,uBAAK,QAAO;AACZ,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,oBAAoB,KAAa,UAAwB;AACvD,UAAM,MAAM,mBAAK,OAAM,IAAI,GAAG;AAC9B,QAAI,CAAC,IAAK;AACT,IAAC,IAAI,UAA0B,OAAO,QAAQ;AAC/C,uBAAK,QAAO;AACZ,QAAI,IAAI,UAAU,SAAS,GAAG;AAC5B,yBAAK,OAAM,OAAO,GAAG;AACrB,yBAAK,QAAO;AAAA,IACd;AAAA,EACF;AAAA;AAAA,EAGA,sBAAsB,UAAwB;AAC5C,eAAW,CAAC,KAAK,GAAG,KAAK,mBAAK,QAAO;AACnC;AAAC,MAAC,IAAI,UAA0B,OAAO,QAAQ;AAC/C,UAAI,IAAI,UAAU,SAAS,GAAG;AAC5B,2BAAK,OAAM,OAAO,GAAG;AACrB,2BAAK,QAAO;AAAA,MACd;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,cAAc,KAAa,OAAsB;AA5GnD;AA6GI,UAAM,MAAM,mBAAK,OAAM,IAAI,GAAG;AAC9B,QAAI,IAAK,0BAAK,eAAL,8BAAiB,EAAE,KAAK,WAAW,IAAI,WAA0B,MAAM;AAAA,EAClF;AAAA;AAAA,EAGA,IAAI,QAAqC;AAAE,WAAO,mBAAK;AAAA,EAAO;AAAA;AAAA,EAG9D,UAAgB;AACd,uBAAK,OAAM,MAAM;AACjB,uBAAK,WAAY;AACjB,uBAAK,QAAO,sBAAsB;AAAA,EACpC;AAAA;AAAA,EAGA,IAAI,OAAe;AACjB,WAAO,mBAAK,OAAM;AAAA,EACpB;AACF;AA5EW;AACA;AACT;AACA;",
+  "names": []
+}

package/dist/wasm-mfu-reassembler.d.ts

@@ -0,0 +1,81 @@
+import type { MFUFragment, MfuReassemblerBackend, PendingMfuDebug, ReassembledMFU, ReassemblerStats } from './mfu-reassembler.js';
+export interface MmtWasmFragment {
+    with_sample_identity(movieFragmentSequence: number, sampleNumber: number, offset: number): void;
+    set_item_id(itemId: number): void;
+    set_packet_delivery?(packetSequenceNumber: number, recovered: boolean): void;
+    set_priority(priority: number): void;
+    set_attribution(attribution: number): void;
+    set_stream_identity(streamIdentity: number): void;
+}
+export interface MmtWasmReassembledMfu {
+    readonly mpu_sequence_number: number;
+    readonly timestamp: number;
+    readonly fragment_count: number;
+    readonly rap_flag: boolean;
+    readonly priority?: number;
+    readonly sample_number?: number;
+    readonly movie_fragment_sequence_number?: number;
+    readonly packet_sequence_numbers?: Uint32Array | number[];
+    readonly repaired_packet_sequence_numbers?: Uint32Array | number[];
+    readonly attribution?: number;
+    readonly stream_identity?: number;
+    readonly data: Uint8Array;
+    free(): void;
+}
+export interface MmtWasmStats {
+    readonly total_fragments: bigint | number;
+    readonly reassembled_mfus: bigint | number;
+    readonly timed_out_mfus: bigint | number;
+    readonly evicted_memory_limit: bigint | number;
+    readonly out_of_order_fragments: bigint | number;
+    readonly duplicate_fragments: bigint | number;
+    free?: () => void;
+}
+export interface MmtWasmReassembler {
+    add_fragment(now: number, fragment: MmtWasmFragment): MmtWasmReassembledMfu | undefined;
+    cleanup_timeouts(now: number): void;
+    set_timeout(timeoutMs: number): void;
+    set_clock_free(): void;
+    next_timeout_at(): number | undefined;
+    flush(): void;
+    reset_stream(streamIdentity: number): void;
+    reset(): void;
+    stats(): MmtWasmStats;
+    readonly buffered_count: number;
+    readonly pending_fragment_count: number;
+}
+export interface MmtWasmBindings {
+    MfuFragmentJs: new (mpuSequenceNumber: number, fragmentationIndicator: number, fragmentCounter: number, data: Uint8Array, timestamp: number, rapFlag: boolean) => MmtWasmFragment;
+    MmtReassembler: {
+        new (timeoutMs: number, maxBuffered: number): MmtWasmReassembler;
+        clock_free(maxBuffered: number): MmtWasmReassembler;
+    };
+}
+export interface WasmMfuReassemblerOptions {
+    bindings: MmtWasmBindings;
+    timeoutMs: number | null;
+    maxBuffered?: number;
+    now?: () => number;
+}
+/** Thin host adapter over mmt-core's Rust/WASM IFC reassembler. */
+export declare class WasmMfuReassembler implements MfuReassemblerBackend {
+    #private;
+    readonly stats: ReassemblerStats;
+    onDeferredAssembly?: (result: ReassembledMFU) => void;
+    constructor(options: WasmMfuReassemblerOptions);
+    get timeoutMs(): number | null;
+    set timeoutMs(timeoutMs: number | null);
+    addFragment(fragment: MFUFragment): ReassembledMFU | null;
+    flush(): void;
+    resetStream(catalogTrackName: string): void;
+    reset(): void;
+    get pendingCount(): number;
+    getStatus(): {
+        bufferedMFUs: number;
+        pendingFragments: number;
+        pendingSamples: PendingMfuDebug[];
+        stats: ReassemblerStats;
+    };
+}
+export declare function resolveGlobalMmtWasmBindings(): MmtWasmBindings;
+//# sourceMappingURL=wasm-mfu-reassembler.d.ts.map

package/dist/wasm-mfu-reassembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-mfu-reassembler.d.ts","sourceRoot":"","sources":["../src/wasm-mfu-reassembler.ts"],"names":[],"mappings":"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"}