@blockcast/mmt-container 0.1.0-main.0399efef1f07

package/dist/fec-worker-setup.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Shared fec-setup helper.
+ *
+ * Wires a FecWorkerClient into a MulticastManager for a specific track.
+ * Both moq-lib (`hang-mmt-fec/js/watch/src/element.ts`) and moqtail
+ * (`moqtail-private/apps/client-js/src/lib/player.ts`) call this from their
+ * SessionManager `fec-setup` handler so the Worker+ALTA setup lives in one
+ * place instead of being duplicated across ~80 lines per player.
+ *
+ * Callers are responsible for holding the returned `dispose()` and calling it
+ * from their `fec-teardown` path (and/or effect cleanup). It unregisters the
+ * Worker from MulticastManager before terminating it, so no symbol is routed
+ * to a dead Worker; do not dispose the client directly.
+ */
+import type { FecWorkerClient } from '@blockcast/fec-worker';
+import type { MulticastManager } from './multicast-manager.js';
+/** Asset URLs the helper needs. Callers pass the already-resolved set. */
+export interface FecWorkerAssetUrls {
+    /** URL to the fec-worker entry bundle (new Worker() target). */
+    fecWorker: string;
+    /** URL to the RaptorQ WASM module (compiled via compileStreaming). */
+    rqWasm: string;
+    /** URL to the ALTA WASM module. Fetched only when an ALTA key is provided. */
+    altaWasm: string;
+}
+export interface FecWorkerSetupOptions {
+    /** MulticastManager that should receive the configured Worker. */
+    multicastManager: MulticastManager;
+    /** MMTP packetId this track occupies (from catalog). */
+    packetId: number;
+    /** Human-readable track name (catalog key). */
+    trackName: string;
+    /** Track type from catalog. Never inferred from name. */
+    trackType: 'video' | 'audio';
+    /** FEC K from catalog (source symbols per block). */
+    fecK: number;
+    /** Symbol size in bytes (T) — the ALTA-adjusted value if ALTA is signed. */
+    fecSymbolSize: number;
+    /** Repair symbols per block (P). */
+    fecRepairCount: number;
+    /**
+     * Repair symbols per block this receiver actually joined: the sum of
+     * `repairSymbols` over the joined BASE layers (draft-ramadan-moq-fec 6.3).
+     * Reported as P by the worker snapshot and CMCD `x-bc-fec-p`, because the
+     * catalog total is not what this receiver joined. Falls back to
+     * `fecRepairCount`, which is the same value on a single-layer track.
+     */
+    joinedRepairCount?: number;
+    /** Interleave depth in ms. */
+    fecInterleaveMs: number;
+    /** Explicit catalog jitter/reorder allowance in ms. */
+    fecReorderToleranceMs?: number;
+    /** Duration of one FEC media unit in ms (video frame or audio access unit). */
+    mediaUnitDurationMs: number;
+    /** Optional repair track name (MoQ). Forwarded to FecTrackConfig. */
+    repairTrackName?: string;
+    /** Audio sample rate (optional — audio tracks only). */
+    sampleRate?: number;
+    /** Codec string (optional; "unknown" is acceptable for first setup). */
+    codec?: string;
+    /** Video framerate (optional metadata forwarded to the worker). */
+    framerate?: number;
+    /** Base64 SPKI public key (optional). Accepts padded/unpadded, std or url-safe alphabet. */
+    altaPublicKeySpki?: string;
+    /** Absolute or origin-relative asset URLs. */
+    assetUrls: FecWorkerAssetUrls;
+    /** Optional FecWorkerClient factory — main use is test injection. */
+    clientFactory?: (workerUrl: URL) => FecWorkerClient;
+}
+export interface FecWorkerSetupResult {
+    /** The configured client (already registered with MulticastManager). */
+    client: FecWorkerClient;
+    /** True when the ALTA public key decoded and the ALTA WASM compiled. */
+    altaEnabled: boolean;
+    /** Removes the Worker from MulticastManager routing, then releases it. */
+    dispose: () => void;
+}
+/**
+ * Configure a FecWorkerClient and attach it to `multicastManager` via
+ * `setFecWorker(packetId, client, trackType, config, trackName)`. Worker-path takes precedence
+ * over any sync WASM decoder already registered for the same packetId —
+ * sync decoders remain as a fallback.
+ *
+ * Any loader failure is re-thrown so the caller can log and leave the sync
+ * WASM decoder active as fallback (same pattern both players used before).
+ */
+export declare function setupFecWorkerForTrack(opts: FecWorkerSetupOptions): Promise<FecWorkerSetupResult>;
+//# sourceMappingURL=fec-worker-setup.d.ts.map

package/dist/fec-worker-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fec-worker-setup.d.ts","sourceRoot":"","sources":["../src/fec-worker-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,uBAAuB,CAAA;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAG9D,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,SAAS,EAAE,OAAO,GAAG,OAAO,CAAA;IAC5B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAA;IACrB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,8BAA8B;IAC9B,eAAe,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,+EAA+E;IAC/E,mBAAmB,EAAE,MAAM,CAAA;IAC3B,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,8CAA8C;IAC9C,SAAS,EAAE,kBAAkB,CAAA;IAC7B,qEAAqE;IACrE,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,KAAK,eAAe,CAAA;CACpD;AAED,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,MAAM,EAAE,eAAe,CAAA;IACvB,wEAAwE;IACxE,WAAW,EAAE,OAAO,CAAA;IACpB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CAqH/B"}