@blockcast/mmt-container 0.1.0 → 0.3.0-main.0bde85f7082f

package/dist/fec-manager.d.ts

@@ -0,0 +1,583 @@
+/**
+ * FEC Manager — codec-agnostic FEC decode service.
+ *
+ * Receives (packetId, sbn, esi, symbolData) tuples from any transport
+ * (MMTP, LOC, etc.) and manages FEC block lifecycle: source counting,
+ * WASM RaptorQ decode, block timeout, and recovery/failure notification.
+ *
+ * Extracted from MulticastManager to decouple FEC block logic from
+ * MMTP packet parsing and frame routing.
+ */
+import { type FecBlockProfile } from '@blockcast/mmt-base';
+import { type IsoRepairPlacement } from './iso-block-locator.js';
+import { MIN_INTERLEAVE_DEPTH_MS } from './fec-state.js';
+import { type BlockClass, type BlockClassifierGeometry, type ClassifierMode, type ClassifierReason, type ReclassificationEvidence, type SourceSymbolEvidence, type TrackKind } from './block-policy.js';
+import type { MmtpDeliveryProvenance } from './mfu-reassembler.js';
+import type { FecWorkerClient, FecTrackStats, FrameMeta } from '@blockcast/fec-worker';
+export { MIN_INTERLEAVE_DEPTH_MS };
+/**
+ * Algorithm-agnostic FEC decoder backend interface.
+ *
+ * Implementations:
+ *   - RaptorQ WASM (mmt_wasm.js) — RFC 6330
+ *   - Reed-Solomon WASM — future
+ *   - XOR — future
+ *
+ * Source/repair symbol IDs follow ISO 23008-1 §C.5.2/C.5.3:
+ *   source: SS_ID (flat 32-bit symbol identifier)
+ *   repair: SS_Start + SSB_length + RS_ID (block-scoped repair coords)
+ */
+export type WasmFecDecoder = {
+    add_source(ss_id: number, data: Uint8Array, ts: number): Uint8Array | null;
+    add_repair(ss_start: number, ssb_length: number, rs_id: number, data: Uint8Array, ts: number): Uint8Array | null;
+    configure(oti: Uint8Array): void;
+    cleanup(current_time: number): Uint8Array;
+    /** Retire the named blocks from the decoder (last-chance decode + stats). */
+    cleanup_blocks_detailed(sbns: Uint32Array): unknown;
+    /**
+     * iso-ssbg1-v1 only: retire the source symbols the decoder holds before a
+     * repair states their block, once no repair can place them any more, by the
+     * decoder's own horizon behind `current`, the newest SS_ID seen. Retires no
+     * block: the manager retires blocks itself, by their deadlines. Returns how
+     * many it retired. The manager calls it after every feed that grows the
+     * decoder and on block retirement. (`MmtFecDecoder.retire_unplaced`; the
+     * worker path uses `cleanup_by_ss_start`, which applies the same rule.)
+     */
+    retire_unplaced(current: number): number;
+    flush?(): void;
+    reset_stats?(): void;
+};
+/** Algorithm-agnostic FEC stats snapshot. */
+export interface FecStats {
+    sourcePackets: number;
+    repairPackets: number;
+    duplicateSymbols: number;
+    blocksClean: number;
+    blocksRecovered: number;
+    blocksFailed: number;
+    blocksComplete: number;
+    mixedPathBlocks: number;
+    recentBlockPathCounts: FecBlockPathCount[];
+    k: number;
+    /** Of blocks with loss, what percentage were recovered (0-100). */
+    recoveryRate: number;
+    /** What percentage of blocks had any loss (0-100). */
+    packetLossRate: number;
+    /** Per-MMTP-packet-ID counters for the synchronous WASM decoder path. */
+    tracks: FecPacketStats[];
+    /** Latest Worker/WASM snapshot for each packet ID. */
+    workers: Array<FecTrackStats & {
+        packetId: number;
+    }>;
+    /** Main-thread repair symbols rejected before dispatch because their size did not match T. */
+    repairSymbolSizeMismatches: number;
+    /** Bounded Worker error counts keyed by stable code, or message text for legacy errors. */
+    workerErrors: Record<string, number>;
+}
+export interface FecPacketStats {
+    packetId: number;
+    sourcePackets: number;
+    repairPackets: number;
+    duplicateSymbols: number;
+    blocksClean: number;
+    blocksRecovered: number;
+    blocksFailed: number;
+    blocksComplete: number;
+    k: number;
+    recoveryRate: number;
+    packetLossRate: number;
+}
+export type FecSymbolSource = 'multicast' | 'moq';
+/**
+ * One iso-ssbg1-v1 first-arrival source symbol MmtpRouter holds until a repair
+ * symbol states its block: the exact protected packet (no SS_ID, unpadded),
+ * the transport that delivered it and its classification evidence.
+ */
+export interface IsoHeldSource {
+    readonly symbolData: Uint8Array;
+    readonly source: FecSymbolSource;
+    readonly evidence: SourceSymbolEvidence;
+    /** Larger than one ssbg_mode1 symbol: counted, never decoded. */
+    readonly oversized: boolean;
+}
+/**
+ * How the multicast leg hands its symbols to this manager.
+ *
+ * - `'datagram'`: every symbol is an independent datagram from the receiving
+ *   socket. A pause in arrivals is the only loss signal the receiver has, so a
+ *   block that stays idle past the catalog-derived inactivity deadline fails.
+ * - `'ordered-relay'`: the provider relays one receiving socket over a
+ *   reliable, ordered stream (the BCDS bridge's WebTransport uni stream). The
+ *   delivered sequence is a subsequence of the socket's receive order, so a
+ *   pause carries no loss information at all: the relay's own scheduling
+ *   decides when bytes arrive. What does carry it is order. Once the stream
+ *   has advanced more than the decoder's interleave horizon past a block, no
+ *   symbol of that block can still be in flight, and the block's fate follows
+ *   from the symbols it holds (in-band SS_ID/SS_Start and SSB_length), not
+ *   from a wall clock tuned for raw datagrams.
+ *
+ * Only the provider can know which of the two it is delivering; an undeclared
+ * provider promises no ordering and keeps datagram semantics.
+ */
+export type MulticastSymbolDelivery = 'datagram' | 'ordered-relay';
+export interface FecBlockPathCount {
+    packetId: number;
+    sbn: number;
+    catalogTrackName?: string;
+    multicastSymbols: number;
+    moqSymbols: number;
+    complete: boolean;
+}
+export interface FECManagerConfig {
+    /**
+     * The catalog `fec.blockProfile` of the track (BLO-35597). Required for every
+     * configured track: there is no default, and nothing infers it.
+     * `k-padded-v1` keeps the legacy K-stride geometry; `iso-ssbg1-v1` is
+     * ISO/IEC 23008-1 ssbg_mode1 with K' = SSB_length blocks located by
+     * `(SS_Start, SSB_length)` range membership, `k` being only their maximum.
+     */
+    blockProfile?: FecBlockProfile;
+    k?: number;
+    /** Symbol size in bytes (T). NOT repair count. */
+    symbolSize?: number;
+    interleaveDepthMs?: number;
+    fps?: number;
+    /** Guarded block inactivity deadline derived from the full delivery geometry. */
+    timeoutMs?: number;
+    /** Media kind of the track (block class `audio` vs video classification). */
+    trackKind?: TrackKind;
+    /** Catalog codec string. */
+    codec?: string;
+    /**
+     * Block classifier geometry derived from raw catalog timing
+     * (`deriveBlockClassifierGeometry`). Absent geometry classifies every video
+     * block `unknown` (fail-closed: protected).
+     */
+    geometry?: BlockClassifierGeometry;
+}
+/** Which symbol path completed a short block. */
+export type RepairVia = 'inband' | 'quic';
+/** Lifecycle resolution of one FEC block, for in-order frame release. */
+export type FecBlockResolution = 'pending' | 'complete' | 'failed' | 'untracked';
+/** Why a stream's Worker decoder stopped being routable. */
+export type FecDecoderUnavailableReason = 'cleared' | 'disposed';
+/**
+ * What still decodes a stream after its Worker left routing: the synchronous
+ * WASM decoder registered for the same stream (the Worker path took precedence
+ * over it while both were live), or nothing.
+ */
+export type FecFallbackDecoder = 'sync' | 'none';
+export interface FecDecoderUnavailableEvent {
+    readonly packetId: number;
+    readonly catalogTrackName?: string;
+    readonly reason: FecDecoderUnavailableReason;
+    /**
+     * What decodes the stream at the moment the Worker left. A synchronous
+     * decoder discarded later (a resetTrack flush failure drops it without an
+     * event) is not reported here; a consumer that keeps a stream alive on
+     * 'sync' owns that decoder's lifecycle itself.
+     */
+    readonly fallbackDecoder: FecFallbackDecoder;
+}
+export declare class FECManager {
+    #private;
+    onBlockStarted: ((sbn: number, packetId: number, catalogTrackName?: string) => void) | null;
+    onBlockComplete: ((sbn: number, packetId: number, catalogTrackName?: string) => void) | null;
+    /** A block reached its fail bound. `blockClass` is its class at failure. */
+    onBlockFailed: ((sbn: number, packetId: number, catalogTrackName: string | undefined, blockClass: BlockClass) => void) | null;
+    /**
+     * Fired once per stream when its Worker decoder stops being routable.
+     * `reason` is 'cleared' when clearFecWorker() removed it and 'disposed' when
+     * a symbol or reset found the registered client already disposed and
+     * evicted it. `fallbackDecoder` is 'sync' when a synchronous WASM decoder
+     * registered for the same stream keeps decoding its symbols, and 'none'
+     * when nothing does. Only 'none' leaves the stream unprotected: the host
+     * must then register a decoder again or leave the stream, because counting
+     * its symbols as handled would hide the loss.
+     */
+    onDecoderUnavailable: ((event: FecDecoderUnavailableEvent) => void) | null;
+    onRepairNeeded: ((sbn: number, packetId: number, catalogTrackName: string | undefined, blockClass: BlockClass) => void) | null;
+    onRepairResolved: ((sbn: number, packetId: number, outcome: 'completed' | 'failed', catalogTrackName: string | undefined, via: RepairVia | null) => void) | null;
+    /**
+     * A block that could not complete from its first-arrival source symbols
+     * alone was completed anyway: by FEC decode (in-band or QUIC repair
+     * symbols) or, after a D-28 request, by late symbols. Fired once per block.
+     */
+    onBlockRepaired: ((sbn: number, packetId: number, catalogTrackName: string | undefined, blockClass: BlockClass, via: RepairVia) => void) | null;
+    /** A block's class changed on new evidence or when classification was disabled. */
+    onBlockReclassified: ((sbn: number, packetId: number, catalogTrackName: string | undefined, from: BlockClass, to: BlockClass, evidence: ReclassificationEvidence) => void) | null;
+    /** A video stream's classifier mode was established or changed. */
+    onClassifierMode: ((packetId: number, catalogTrackName: string | undefined, mode: ClassifierMode, reason: ClassifierReason | null) => void) | null;
+    /** A block every symbol of which vanished was created by SBN evidence. */
+    onBlockVanished: ((sbn: number, packetId: number, catalogTrackName: string | undefined) => void) | null;
+    /** A block reached a terminal state (completed, recovered, or failed). */
+    onBlockResolved: ((sbn: number, packetId: number, catalogTrackName: string | undefined) => void) | null;
+    /** A stream's SBN went backwards (or jumped implausibly): the source restarted. */
+    onSourceDiscontinuity: ((packetId: number, catalogTrackName: string | undefined) => void) | null;
+    onBlockRecovered: ((sbn: number, packetId: number, data: ArrayBuffer, meta: FrameMeta, catalogTrackName?: string) => void) | null;
+    onFecStatsUpdate: ((packetId: number, stats: FecTrackStats) => void) | null;
+    /** Internal state for diagnostics — not part of the public stats API. */
+    get diagnostics(): {
+        timeoutMs: number;
+        activeBlocks: number;
+        completedBlocks: number;
+        cleanlyCompletedBlocks: number;
+        pendingCounts: {
+            [k: string]: number;
+        };
+        fpsDetected: boolean;
+        interleaveDepthMs: number;
+        startupAlignedPackets: number[];
+        startupPartialBlocks: number;
+        startupRepairReadyPackets: number[];
+        startupRepairFailOpenPackets: number[];
+        pendingWorkerCleanups: number;
+        decoderUnavailableEvents: number;
+        repairTrackedBlocks: number;
+        multicastSymbolDelivery: MulticastSymbolDelivery;
+        orderedFrontiers: {
+            [k: string]: number;
+        };
+        orderedPendingBlocks: number;
+        lifecycleTrace: {
+            atMs: number;
+            event: "repair-requested" | "repair-arrived" | "timeout-queued" | "horizon-settled" | "cleanup-ack" | "cleanup-ack-timeout" | "recovered" | "failed" | "decoder-unavailable";
+            packetId: number;
+            sbn: number;
+            catalogTrackName?: string;
+            sourceCount: number;
+            sourceEsis: number[];
+            repairRsIds: number[];
+            decoderPath: "worker" | "sync" | "none";
+            deadlineRemainingMs?: number;
+            pendingCleanup: boolean;
+            rsId?: number;
+        }[];
+    };
+    get fecStats(): FecStats;
+    /**
+     * Observe Worker-backed per-track snapshots without taking ownership of the
+     * legacy single-callback slot. Infrastructure diagnostics and a player may
+     * therefore consume the same source event without wrapping or replacing one
+     * another's callback.
+     */
+    addFecStatsObserver(observer: (packetId: number, stats: FecTrackStats) => void): () => void;
+    /** Start a new multicast transport join without discarding track/decoder state. */
+    beginMulticastJoin(): void;
+    /** How the multicast leg currently delivers symbols. */
+    get multicastSymbolDelivery(): MulticastSymbolDelivery;
+    /**
+     * Declare how the multicast leg delivers symbols (see
+     * MulticastSymbolDelivery). The multicast provider owns this fact:
+     * MulticastManager applies what the window.multicast subscription declares
+     * on every join, and a consumer feeding packets itself declares its own leg.
+     *
+     * Switching to 'ordered-relay' requires every configured track to define
+     * its interleave horizon and throws otherwise. Switching back to 'datagram'
+     * gives every block awaiting ordered settlement the datagram inactivity
+     * deadline from now.
+     */
+    setMulticastSymbolDelivery(delivery: MulticastSymbolDelivery): void;
+    /** Begin a fresh decode epoch for one physical stream. */
+    resetTrack(packetId: number, catalogTrackName: string): void;
+    /**
+     * Retire one packet ID, drop-only: forget every stream on it (block
+     * ledgers, deadlines and their timers, repair holds, terminal records,
+     * classifiers, stream geometry), its per-packet configuration and
+     * statistics, and take its decoders out of routing.
+     *
+     * This is the end of the packet ID's streams, not a new epoch of them (that
+     * is resetTrack): afterwards isTrackConfigured() is false and nothing about
+     * it remains until it is configured again. Nothing is reported, because
+     * nothing happened to the media: no block fails, recovers or resolves, no
+     * repair resolves, and no decoder becomes "unavailable" (a retired stream
+     * has no symbols left to decode, so a decoder-unavailable event would
+     * describe lost protection that no stream suffers). The epoch still
+     * advances, so a gap decision made before the retirement never matches a
+     * stream later configured on the same packet ID.
+     *
+     * Decoder and Worker clients stay caller-owned: each is flushed or reset so
+     * it holds no block of the retired streams, then released from routing;
+     * dispose it after this returns. Cumulative totals in fecStats keep what
+     * the retired streams contributed.
+     */
+    releasePacket(packetId: number): void;
+    /** Record a transport symbol and reject later duplicates of the same packetId/SBN/ESI. */
+    feedSymbolFromSource(packetId: number, sbn: number, esi: number, _data: Uint8Array, source: FecSymbolSource, catalogTrackName?: string): boolean;
+    /** Exact catalog identity retained for async recovery, if unambiguous. */
+    catalogTrackNameForBlock(sbn: number, packetId: number, catalogTrackName?: string): string | undefined;
+    /** Per-block state snapshot for FecBlockGrid visualization.
+     *  Returns the most recent blocks (active + recently completed). */
+    getBlockStates(): Array<{
+        sbn: number;
+        packetId?: number;
+        state: 'collecting' | 'complete' | 'failed';
+        sourceCount: number;
+        k: number;
+        progress: number;
+    }>;
+    /** The raw WASM decoder for stats access (first registered decoder) */
+    get wasmDecoder(): WasmFecDecoder | null;
+    get k(): number;
+    kForPacket(packetId: number): number;
+    /** FEC symbol size in bytes. */
+    get symbolSize(): number;
+    symbolSizeForPacket(packetId: number): number;
+    /** FEC block span in milliseconds (0 = no interleaving). */
+    get interleaveDepthMs(): number;
+    interleaveDepthMsForPacket(packetId: number): number;
+    /**
+     * Record one multicast MMTP packet arrival (every packet of the leg, FEC
+     * symbol or not) for the delivery-gap measurement. `packetSequenceNumber`
+     * is the MMTP packet_sequence_number, which increments by one per packet of
+     * a packet_id: it is what separates a stall from a loss (see
+     * DeliveryGapEstimator). Datagram delivery only.
+     */
+    noteMulticastArrival(packetId: number, packetSequenceNumber: number): void;
+    /**
+     * Resolved per-track multicast late-symbol wait in milliseconds: the span
+     * plus the larger of the catalog tolerance and the measured delivery gap.
+     */
+    timeoutMsForPacket(packetId: number): number;
+    /**
+     * Largest multicast delivery gap measured over the current window (ms), and
+     * that window (undefined: held since the last reset). Diagnostics.
+     */
+    multicastDeliveryGap(): {
+        peakGapMs: number;
+        windowMs: number | undefined;
+    };
+    /**
+     * Receiver-local time of a block's first accepted symbol, or undefined for
+     * a block no symbol reached (one materialized because a later SBN arrived).
+     */
+    blockAnchorAtMs(sbn: number, packetId: number, catalogTrackName?: string): number | undefined;
+    /** Absolute fail deadline of a still-open block, or undefined. */
+    blockDeadlineAtMs(sbn: number, packetId: number, catalogTrackName?: string): number | undefined;
+    /**
+     * Keep a block open until `untilAtMs` while a repair FETCH the scheduler
+     * admitted is in flight. Never shortens the multicast wait already armed;
+     * while set, the hold is the block's whole deadline, so no later symbol
+     * extends it. Returns false when the block is no longer open (resolved, or
+     * not yet tracked).
+     */
+    holdBlockForRepair(sbn: number, packetId: number, catalogTrackName: string | undefined, untilAtMs: number): boolean;
+    /**
+     * Drop a block's repair hold: its FETCH ended without delivering. The block
+     * falls back to its multicast wait, which may already have passed.
+     */
+    releaseRepairHold(sbn: number, packetId: number, catalogTrackName?: string): void;
+    /** Resolved per-track D-28 repair request deadline in milliseconds. */
+    repairDeadlineMsForPacket(packetId: number): number;
+    /**
+     * One block lifetime: the longest a block stays open after its last symbol
+     * (inactivity fail bound plus D-28 repair grace).
+     */
+    blockLifetimeMsForPacket(packetId: number): number;
+    /**
+     * How long a terminal (clean, recovered or failed) block stays authoritative,
+     * for late symbols and for the in-order release gate. It is also the gate's
+     * hold ceiling (MmtpRouter's holdLimitMs): a retired block reads back as
+     * untracked, which the gate counts as lost, so no frame may still be waiting
+     * on a block that can retire. The window is one interleave depth for a gap's
+     * last block to finish arriving, one block lifetime to fail it, and one more
+     * for an owed Worker cleanup that can keep a failing block pending. Every
+     * term comes from the track's catalog geometry; there is no separate cap.
+     */
+    terminalRetentionMsForPacket(packetId: number): number;
+    /** Remaining fetch budget for a specific repair-requested block. */
+    repairFetchTimeoutMsForBlock(sbn: number, packetId: number, catalogTrackName?: string): number;
+    /** True once configureTrack/setFecDecoder/setFecWorker configured this packetId. */
+    /** The configured `fec.blockProfile` of a packetId (undefined until configured). */
+    blockProfileForPacket(packetId: number): FecBlockProfile | undefined;
+    /** Whether an iso-ssbg1-v1 protected packet fits one ssbg_mode1 symbol (len + 2 <= T). */
+    isoSourceFits(packetId: number, packetLength: number): boolean;
+    /**
+     * Locate an iso-ssbg1-v1 source by range membership in a block a repair
+     * already stated. Null while its block is unknown: hold it (holdIsoSource).
+     */
+    locateIsoSource(packetId: number, catalogTrackName: string | undefined, ssId: number): {
+        sbn: number;
+        esi: number;
+    } | null;
+    /**
+     * Hold a first-arrival iso-ssbg1-v1 source whose block no repair has stated
+     * yet. Returns false for a later copy of an SS_ID already held.
+     */
+    holdIsoSource(packetId: number, catalogTrackName: string | undefined, ssId: number, source: IsoHeldSource): boolean;
+    /**
+     * Apply an iso-ssbg1-v1 repair symbol's `(SS_Start, SSB_length)`: states the
+     * block, and hands back the held sources it (and any repair-less span in
+     * front of it) now places. The caller feeds them as first-arrival sources,
+     * then the repair symbol, the order they had on the wire. A repair that
+     * contradicts a known block is refused (counted) and must be dropped.
+     */
+    placeIsoRepair(packetId: number, catalogTrackName: string | undefined, ssStart: number, ssbLength: number): IsoRepairPlacement<IsoHeldSource>;
+    /**
+     * Resolution of the SS_IDs strictly between two released frames' SS_IDs on
+     * an iso-ssbg1-v1 stream, for in-order frame release: null while a block
+     * that could hold them is pending or not yet stated by a repair, else the
+     * starts of the blocks that failed or vanished.
+     *
+     * `untracked` reads exactly as in the k-padded-v1 release gate
+     * (MmtpRouter #createFecReleaseGate): a block holding either released
+     * frame's SS_ID (`fromSsId` or `toSsId`) delivered that frame, so untracked
+     * there means it resolved and retired; a block starting after the stream's frontier (`highestSbn`,
+     * an SS_Start here) may still be heard from; a block at or behind the
+     * frontier that no symbol of this manager ever reached vanished, and its
+     * media is lost.
+     */
+    isoSpanResolution(packetId: number, catalogTrackName: string | undefined, fromSsId: number, toSsId: number): readonly number[] | null;
+    /**
+     * iso-ssbg1-v1 block location: repair symbols it refused, oversize sources,
+     * the sources held now for a block no repair has stated yet, and the held
+     * sources the capacity cap evicted (cumulative), and the sources a
+     * synchronous decoder held unplaced and retired at its horizon (cumulative).
+     */
+    get isoDiagnostics(): {
+        repairRefused: number;
+        sourceOversize: number;
+        heldSources: number;
+        heldEvicted: number;
+        decoderUnplacedRetired: number;
+        decoderUnplacedRetireFailed: number;
+    };
+    isTrackConfigured(packetId: number): boolean;
+    /** Catalog/reset epoch of a packet's streams; gap decisions carry it. */
+    epochFor(packetId: number): number;
+    /** Configured media kind of a packetId, when known. */
+    trackKindFor(packetId: number): TrackKind | undefined;
+    /** Configured codec of a packetId, when known. */
+    codecFor(packetId: number): string | undefined;
+    /**
+     * Block classifier geometry of one stream: its own stream-scoped geometry,
+     * else the packet's (fail-closed when absent, or when a sibling stream of
+     * the packet has its own geometry and this one has none).
+     */
+    geometryFor(packetId: number, catalogTrackName?: string): BlockClassifierGeometry;
+    /** Current classifier mode of a stream. */
+    classifierModeFor(packetId: number, catalogTrackName?: string): {
+        mode: ClassifierMode;
+        reason: ClassifierReason | null;
+    };
+    /**
+     * Whether an MPU boundary still bounds this stream's RAPs (see
+     * `BlockClassifier.mpuBoundsRaps`). Gap decisions drop MPU evidence once
+     * it does not. A stream with no classifier yet has shown nothing against it.
+     */
+    mpuBoundsRapsFor(packetId: number, catalogTrackName?: string): boolean;
+    /** A block's class now, or frozen at its resolution. */
+    blockClassFor(sbn: number, packetId: number, catalogTrackName?: string): BlockClass;
+    /**
+     * Lifecycle resolution of one block for in-order frame release: `pending`
+     * while it can still complete, `complete`/`failed` once terminal, and
+     * `untracked` when no symbol of it was ever accepted.
+     */
+    blockResolution(sbn: number, packetId: number, catalogTrackName?: string): FecBlockResolution;
+    /** Highest SBN any symbol of this stream carried in the current epoch. */
+    highestSbn(packetId: number, catalogTrackName?: string): number | undefined;
+    /**
+     * Record a RAP frame released in order, for the classifier's RAP-spacing
+     * invariant (consecutive MPUs exactly one keyframe interval apart).
+     */
+    noteReleasedRap(packetId: number, catalogTrackName: string | undefined, mpu: number, presentationTime: bigint, mediaTimescale: number): void;
+    /** Configure FEC parameters. */
+    configure(config: FECManagerConfig): void;
+    /**
+     * Configure FEC parameters for one packetId without changing legacy
+     * defaults. With `catalogTrackName`, `config.geometry` is that stream's
+     * own classifier geometry (ABR rungs that share a packetId each get
+     * theirs); K, T, timing, kind and codec stay per packetId.
+     */
+    configureTrack(packetId: number, config: FECManagerConfig, catalogTrackName?: string): void;
+    /** Register a FEC decoder for a specific packetId (track). */
+    setFecDecoder(packetId: number, client: WasmFecDecoder, k: number, config?: FECManagerConfig, catalogTrackName?: string): void;
+    /**
+     * Register a Worker-backed FEC decoder for a specific packetId (track).
+     *
+     * Worker-backed tracks decode asynchronously — feedSourceSymbol/feedRepairSymbol
+     * return null immediately, and recovered frames arrive via the onBlockRecovered callback.
+     *
+     * Takes precedence over sync WASM decoders for the same packetId.
+     */
+    setFecWorker(packetId: number, client: FecWorkerClient, config: FECManagerConfig, catalogTrackName?: string): void;
+    /**
+     * Remove a stream's Worker decoder from routing.
+     *
+     * Returns false when no Worker is registered under that exact stream key.
+     * On success every cleanup acknowledgement still owed by the client is
+     * resolved by failing its block now (a Worker that is going away cannot
+     * post it), the client's block ownership is released, and
+     * onDecoderUnavailable fires once with reason 'cleared' and the decoder
+     * that remains for the stream ('sync' or 'none'). Call this before
+     * disposing the client; a client disposed while still registered is
+     * evicted on its next symbol or reset with reason 'disposed'.
+     */
+    clearFecWorker(packetId: number, catalogTrackName?: string): boolean;
+    /** Called by player when framerate is known (from decoder output). Refines FEC block timeout. */
+    setFramerate(fps: number): void;
+    /**
+     * Feed a source symbol to the WASM FEC decoder.
+     *
+     * Does NOT track block source counts or fire lifecycle events — call
+     * `trackBlock()` separately BEFORE this method (MmtpRouter does this).
+     *
+     * @returns Recovered block data if WASM completed the block, else null.
+     *          Caller is responsible for routing recovered data and updating
+     *          block completion state via `markBlockCompleted()`.
+     */
+    feedSourceSymbol(packetId: number, ssId: number, symbolData: Uint8Array, alta?: {
+        auth: Uint8Array;
+        payloadEnd: number;
+    }, catalogTrackName?: string): Uint8Array | null;
+    /**
+     * Feed a repair symbol to the WASM FEC decoder.
+     *
+     * @returns Recovered block data if repair completed the block, else null.
+     *          Caller is responsible for routing recovered data and updating
+     *          block completion state via `markBlockCompleted()`.
+     */
+    feedRepairSymbol(packetId: number, ssStart: number, ssbLength: number, rsId: number, repairData: Uint8Array, catalogTrackName?: string): Uint8Array | null;
+    /**
+     * Track a first-arrival network source symbol for an FEC block. Refreshes
+     * the inactivity deadline on each symbol, records the symbol's in-band
+     * classification evidence, and marks the block clean when all of its
+     * authored source symbols arrived: the SSB_length a repair symbol declared,
+     * otherwise K.
+     *
+     * Throws for a packetId that was never configured, so a classified block
+     * never reads the manager-global K or timeout.
+     */
+    trackBlock(sbn: number, packetId: number, catalogTrackName: string | undefined, esi: number, evidence: SourceSymbolEvidence): void;
+    /** Refresh deadlines after accepted block activity. */
+    noteBlockActivity(sbn: number, packetId: number, catalogTrackName?: string, sourceProgress?: boolean): void;
+    /** Check whether a block has already been completed (clean or recovered). */
+    isBlockCompleted(sbn: number, packetId?: number, catalogTrackName?: string): boolean;
+    /** Mark a block as completed externally (e.g., after routing recovered data). */
+    markBlockCompleted(sbn: number, packetId?: number, catalogTrackName?: string): void;
+    /**
+     * Increment blocksRecovered (called by MmtpRouter after routing a
+     * synchronous recovery). With the block's coordinates the recovery is also
+     * reported through onBlockRepaired, once per block.
+     */
+    countRecovery(packetId?: number, sbn?: number, catalogTrackName?: string): void;
+    /**
+     * Strict delivery provenance for one FEC block.
+     *
+     * A recovered symbol is a function of every symbol that entered its block,
+     * so it can only be attributed to multicast when NO symbol in that block
+     * arrived over MoQ. Repair symbols routinely arrive over reliable QUIC
+     * (`MmtpRouter.feedRepairPacket`), so a block that recovered with MoQ help
+     * produced bytes that never crossed a multicast socket.
+     *
+     * An untracked block returns 'unknown' rather than a guess: absence of
+     * evidence is not evidence of multicast.
+     */
+    blockDeliveryProvenance(sbn: number, packetId: number, catalogTrackName?: string): MmtpDeliveryProvenance;
+    /** Per-path symbol counts for one block (D-28 gate logging), if tracked. */
+    blockPathCount(sbn: number, packetId: number, catalogTrackName?: string): FecBlockPathCount | null;
+    /** Cancel block timeout (block completed via clean reception or FEC recovery). */
+    cancelBlockTimeout(sbn: number, packetId?: number, catalogTrackName?: string): void;
+    dispose(): void;
+}
+//# sourceMappingURL=fec-manager.d.ts.map

package/dist/fec-manager.d.ts.map

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