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

package/dist/mmtp-decode-pipeline.d.ts

@@ -0,0 +1,96 @@
+/**
+ * MmtpDecodePipeline — unified MMTP decode pipeline for MoQ and multicast paths.
+ *
+ * Wraps MmtpContainerParser with optional FEC client integration and a keyframe gate.
+ * Designed for the MoQ decode path (hang-mmt-fec audio/video decoders).
+ *
+ * Two entry points:
+ * - feedMoqObject(): raw MMTP packets from MoQ QUIC streams
+ * - feedAssembledFrame(): pre-assembled codec frames from multicast (post-reassembly)
+ */
+import { type FrameMeta, type MmtpReorderStats } from './mmtp-container-parser.js';
+import type { MfuReassemblerBackend, MmtpDeliveryProvenance } from './mfu-reassembler.js';
+import type { MfuReassemblyPolicy } from './mfu-reassembly-policy.js';
+/** Minimal FEC client interface for source symbol feeding. */
+export interface PipelineFecClient {
+    addSourceSymbol?(ssId: number, data: Uint8Array): Uint8Array | null;
+}
+export interface PipelineConfig {
+    codec: string;
+    /** Catalog video cadence exposed to downstream media stages. */
+    framerate?: number;
+    /** Catalog MMTP group duration exposed to downstream media stages. */
+    groupDurationMs?: number;
+    /** MMTP packet_id for this track — from catalog. When omitted, parser accepts all packetIds. */
+    packetId?: number;
+    description?: Uint8Array;
+    reorderWindow?: number;
+    /**
+     * MFU reassembly timeout (ms). Caller derives from catalog `fec.interleaveDepthMs`,
+     * already in milliseconds (FFmpeg `moqenc_mmt.c` converts depth-in-frames →
+     * `depth_ms = fec_depth * (1000/fps)` before set_fec_config). Defaults to
+     * 1000ms when omitted. Pass null for reliable, clock-free MoQ streams;
+     * incomplete MFUs then remain bounded by the reassembler's memory limit.
+     */
+    mfuTimeoutMs?: number | null;
+    /** Explicit transport policy; preferred over mfuTimeoutMs. */
+    reassemblyPolicy?: MfuReassemblyPolicy;
+    /** Shared Rust/WASM backend for browser playback. */
+    reassembler?: MfuReassemblerBackend;
+    maxBufferedMfus?: number;
+}
+type FrameCallback = (data: Uint8Array, meta: FrameMeta) => void;
+type InitCallback = (data: Uint8Array, packetId: number) => void;
+export declare class MmtpDecodePipeline {
+    #private;
+    /** Configure the inner parser. Call before feedMoqObject(). */
+    configure(config: PipelineConfig): void;
+    /** Inject a FEC client for source symbol feeding on the MoQ path. */
+    setFecClient(client: PipelineFecClient): void;
+    /** Register frame output callback. */
+    onFrame(cb: FrameCallback): void;
+    /** Register init segment callback. */
+    onInit(cb: InitCallback): void;
+    /** Current shared-parser ordering/drop telemetry. */
+    get reorderStats(): Readonly<MmtpReorderStats> | null;
+    /**
+     * Feed a raw MoQ object payload (one MMTP packet per MoQ object).
+     * Optionally feeds source symbols to FEC client before parsing.
+     */
+    feedMoqObject(packet: Uint8Array): void;
+    /**
+     * Feed a pre-assembled codec frame (from multicast, post-reassembly).
+     * Bypasses MMTP parsing — emits directly through the keyframe gate.
+     *
+     * Callers MUST supply:
+     *   - packetSequenceNumber: unique per-AU identifier (typically the MMTP
+     *     packet_sequence_number of the first fragment). Required for
+     *     deterministic dedup against duplicates arriving via other paths.
+     *   - packetId: MMTP packet_id of the track (1=video, 2=audio by convention).
+     */
+    feedAssembledFrame(data: Uint8Array, meta: {
+        timestamp: number;
+        keyframe: boolean;
+        packetSequenceNumber: number;
+        packetId: number;
+        sourceDiscontinuity?: boolean;
+        recovered?: boolean;
+        /**
+         * Whole-frame delivery provenance, when the caller knows it. Absent means
+         * the caller never told us — which is NOT the same as 'unknown', a
+         * verdict the caller reached and is asserting. Keep them distinguishable.
+         */
+        deliveryProvenance?: MmtpDeliveryProvenance;
+    }): void;
+    /** Request keyframe — gates output until a keyframe arrives. */
+    requestKeyframe(): void;
+    /** Emit buffered ordered frames. Finite consumers call this before dispose(). */
+    flush(): void;
+    /** Clean up the pipeline. Finite inputs pass flush=true at EOS; live
+     * cancellation keeps the default drop-only teardown behavior. */
+    dispose(options?: {
+        flush?: boolean;
+    }): void;
+}
+export {};
+//# sourceMappingURL=mmtp-decode-pipeline.d.ts.map

package/dist/mmtp-decode-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmtp-decode-pipeline.d.ts","sourceRoot":"","sources":["../src/mmtp-decode-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,gBAAgB,EAEtB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAErE,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAAA;CACpE;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,mBAAmB,CAAA;IACtC,qDAAqD;IACrD,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,KAAK,aAAa,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;AAChE,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;AAEhE,qBAAa,kBAAkB;;IAwB7B,+DAA+D;IAC/D,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAoDvC,qEAAqE;IACrE,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAI7C,sCAAsC;IACtC,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAIhC,sCAAsC;IACtC,MAAM,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAI9B,qDAAqD;IACrD,IAAI,YAAY,IAAI,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAEpD;IAED;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAiDvC;;;;;;;;;OASG;IACH,kBAAkB,CAChB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAA;QACjB,QAAQ,EAAE,OAAO,CAAA;QACjB,oBAAoB,EAAE,MAAM,CAAA;QAC5B,QAAQ,EAAE,MAAM,CAAA;QAChB,mBAAmB,CAAC,EAAE,OAAO,CAAA;QAC7B,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB;;;;WAIG;QACH,kBAAkB,CAAC,EAAE,sBAAsB,CAAA;KAC5C,GACA,IAAI;IAiBP,gEAAgE;IAChE,eAAe,IAAI,IAAI;IAIvB,iFAAiF;IACjF,KAAK,IAAI,IAAI;IAIb;qEACiE;IACjE,OAAO,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;CA8CjD"}