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

package/dist/multicast-transport.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Thin transport wrapper for SSM multicast — join, socket, watchdog,
+ * takeover/failback.  Delegates raw packets to a callback (MmtpRouter
+ * or any direct consumer).
+ */
+export interface MulticastTransportConfig {
+    sourceAddress: string;
+    groupAddress: string;
+    port: number;
+    mode?: 'auto' | 'native' | 'tunnel';
+    amtRelay?: string;
+    amtRelayPort?: number;
+    packetIds?: number[];
+    tracks?: {
+        name: string;
+        packetId: number;
+    }[];
+}
+export type ResolvedMulticastTransport = 'native' | 'amt';
+/**
+ * Receive counters plus the ingress-filter drop counters.
+ *
+ * `packetsReceived` / `bytesReceived` count only packets that passed the
+ * allow-list and were handed to the page — a rejected packet must never
+ * inflate them.  The `dropped*` counters are the other half of that story:
+ * without them a filtered PID is indistinguishable from a PID that was never
+ * transmitted, which is exactly the ambiguity that makes an all-zero FEC
+ * repair count unreadable (a repair leg dropped here and a repair leg the
+ * publisher never sent produce byte-identical downstream telemetry).
+ */
+export interface MulticastTransportStats {
+    packetsReceived: number;
+    bytesReceived: number;
+    /** Parsed cleanly, but the packet ID is absent from the join's allow-list. */
+    packetsDroppedUnregisteredPid: number;
+    /** MMTP header did not parse; the packet ID is unknown, so it cannot be attributed. */
+    packetsDroppedUnparseable: number;
+}
+export declare class MulticastTransport<TPacketContext = never> {
+    #private;
+    constructor(onPacket: (packet: Uint8Array, context?: TPacketContext) => void);
+    static isAvailable(): boolean;
+    join(config: MulticastTransportConfig, context?: TPacketContext): Promise<boolean>;
+    /** Feed a raw packet from an external source (e.g., AMT tunnel or ASM subscription). */
+    feedPacket(data: ArrayBuffer | Uint8Array, context?: TPacketContext): void;
+    confirmVideo(): void;
+    confirmAudio(): void;
+    onTakeover(cb: () => void): void;
+    onFailback(cb: () => void): void;
+    setFailbackWindowMs(windowMs: number): void;
+    get stats(): MulticastTransportStats;
+    /**
+     * Per-PID drop breakdown, newest-capped at MAX_TRACKED_DROPPED_PIDS distinct
+     * PIDs.  This is what names the offender: `packetsDroppedUnregisteredPid`
+     * says the ingress filter fired, this says it fired on 0x8001.
+     */
+    get droppedPacketIds(): ReadonlyMap<number, number>;
+    get resolvedTransport(): ResolvedMulticastTransport | undefined;
+    dispose(): void;
+}
+//# sourceMappingURL=multicast-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multicast-transport.d.ts","sourceRoot":"","sources":["../src/multicast-transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC9C;AAED,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,KAAK,CAAA;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,6BAA6B,EAAE,MAAM,CAAA;IACrC,uFAAuF;IACvF,yBAAyB,EAAE,MAAM,CAAA;CAClC;AAmCD,qBAAa,kBAAkB,CAAC,cAAc,GAAG,KAAK;;gBAsBxC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,IAAI;IAI5E,MAAM,CAAC,WAAW,IAAI,OAAO;IAIvB,IAAI,CAAC,MAAM,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IA0ExF,wFAAwF;IACxF,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAU1E,YAAY,IAAI,IAAI;IAKpB,YAAY,IAAI,IAAI;IAKpB,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAIhC,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAIhC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU3C,IAAI,KAAK,IAAI,uBAAuB,CAEnC;IAED;;;;OAIG;IACH,IAAI,gBAAgB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAElD;IAED,IAAI,iBAAiB,IAAI,0BAA0B,GAAG,SAAS,CAE9D;IAED,OAAO,IAAI,IAAI;CAiFhB"}