@blockcast/mmt-transport 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,356 @@
+/**
+ * @blockcast/transport - Type Definitions
+ *
+ * Shared interfaces for unified transport (WebTransport, SSM, AMT, DRIAD) and FEC.
+ */
+/** window.Multicast API type (from IWA/Chrome Direct Sockets) */
+export interface MulticastAPI {
+    subscribeSSM?: (config: {
+        group: string;
+        source: string;
+        port: number;
+        protocol?: string;
+        fec?: boolean;
+    }) => Promise<MulticastSubscription>;
+    subscribe?: (config: {
+        group: string;
+        port: number;
+        protocol?: string;
+        fec?: boolean;
+    }) => Promise<MulticastSubscription>;
+    connectAMT?: (config: {
+        relay: string;
+        group: string;
+        source?: string;
+        port: number;
+    }) => Promise<{
+        onpacket?: (event: {
+            data: ArrayBuffer;
+        }) => void;
+        close: () => void;
+    }>;
+    fecDecode?: boolean;
+}
+export interface MulticastSubscription {
+    onpacket?: (event: {
+        data: ArrayBuffer;
+    }) => void;
+    onerror?: (error: Error) => void;
+    unsubscribe: () => void;
+}
+declare global {
+    interface Window {
+        Multicast?: MulticastAPI;
+        UDPSocket?: unknown;
+    }
+}
+/** Transport configuration for multicast subscriptions */
+export interface TransportConfig {
+    /** Multicast group address (232.x.x.x for SSM) */
+    group: string;
+    /** Source address for SSM filtering */
+    source: string;
+    /** UDP port */
+    port: number;
+    /** Stream type */
+    streamType: "video" | "audio";
+    /** Optional AMT relay host for unicast tunneling */
+    amtRelay?: string;
+    /** DRIAD discovery enabled */
+    driadEnabled?: boolean;
+    /** Initial bitrate quality level */
+    initialQuality?: QualityLevel;
+}
+/** @deprecated Use TransportConfig instead */
+export type SSMConfig = TransportConfig;
+export interface QualityLevel {
+    name: string;
+    bitrate: number;
+    width: number;
+    height: number;
+    fps: number;
+}
+export interface TransportCapabilities {
+    nativeSSM: boolean;
+    nativeIGMP: boolean;
+    directSockets: boolean;
+    amt: boolean;
+    driad: boolean;
+    fecDecode: boolean;
+}
+export type TransportMode = "ssm" | "igmp" | "amt" | "driad" | "moq" | "disconnected";
+export interface TransportState {
+    mode: TransportMode;
+    connected: boolean;
+    group?: string;
+    source?: string;
+    amtRelay?: string;
+    driadRelay?: string;
+    quality?: QualityLevel;
+    packetsReceived: number;
+    bytesReceived: number;
+    lastPacketTime: number;
+}
+/** Transport subscription handle */
+export interface TransportSubscription {
+    id: string;
+    config: TransportConfig;
+    onpacket?: (data: ArrayBuffer) => void;
+    onerror?: (error: Error) => void;
+    onqualitychange?: (quality: QualityLevel) => void;
+    close: () => void;
+}
+/** @deprecated Use TransportSubscription instead */
+export type SSMSubscription = TransportSubscription;
+/** DRIAD Relay information (RFC 8777) */
+export interface DRIADRelay {
+    host: string;
+    port: number;
+    priority: number;
+    weight: number;
+    asn: number;
+    rtt?: number;
+}
+/** AMT Relay information */
+export interface AmtRelayInfo {
+    address: string;
+    port: number;
+    discoveryMethod: "driad" | "manual";
+    discoveredAt: number;
+}
+/** Group key for multicast subscriptions */
+export interface GroupKey {
+    group: string;
+    port: number;
+    source?: string;
+}
+/** Packet metadata */
+export interface PacketMetadata {
+    sourceAddress: string;
+    sourcePort: number;
+    transport: "native" | "tunnel" | "websocket";
+    timestamp: number;
+}
+/** MFU Fragment for reassembly */
+export interface MfuFragment {
+    mpuSequenceNumber: number;
+    fragmentationIndicator: number;
+    fragmentCounter: number;
+    data: Uint8Array;
+    timestamp: bigint;
+}
+/** Reassembled MFU */
+export interface ReassembledMfu {
+    mpuSequenceNumber: number;
+    data: Uint8Array;
+    timestamp: bigint;
+    fragmentCount: number;
+    recoveredViaFec: boolean;
+}
+/** FEC + MFU processing statistics */
+export interface ProcessingStats {
+    mfuComplete: number;
+    mfuReassembled: number;
+    mfuTimedOut: number;
+    fecSourcePackets: number;
+    fecRepairPackets: number;
+    fecBlocksComplete: number;
+    fecBlocksRecovered: number;
+    fecBlocksFailed: number;
+    fecRecoveryRate: number;
+    greenFillFrames: number;
+}
+/** Options for MmtFecClient */
+export interface MmtFecClientOptions {
+    /** Interleave depth for FEC (default: 30 for ~1s at 30fps) */
+    interleaveDepth?: number;
+    /** Block timeout in milliseconds (default: 2000) */
+    blockTimeoutMs?: number;
+    /** MFU timeout in milliseconds (default: 1000) */
+    mfuTimeoutMs?: number;
+    /** Enable green-fill for failed frames (default: true) */
+    greenFillEnabled?: boolean;
+    /** Callback when MFU is ready */
+    onMfuReady?: (mfu: ReassembledMfu) => void;
+    /** Callback for green-fill frame */
+    onGreenFill?: (timestamp: bigint) => void;
+    /** Callback for stats update */
+    onStatsUpdate?: (stats: ProcessingStats) => void;
+}
+/** Time types (microseconds) */
+export type Micro = number & {
+    readonly __micro: unique symbol;
+};
+/** Sync decision for A/V synchronization */
+export type SyncDecision = "render" | "hold" | "discard";
+/** Transport mode for multicast subscription (auto-selection) */
+export type MulticastTransportMode = "auto" | "native" | "tunnel";
+/** Multicast subscription configuration */
+export interface MulticastConfig {
+    group: string;
+    port: number;
+    source?: string;
+    mode?: MulticastTransportMode;
+    onPacket: (data: ArrayBuffer, source: PacketSource) => void;
+    onStateChange?: (state: SubscriptionState) => void;
+    onError?: (error: Error) => void;
+    amtRelay?: string;
+    amtRelayPort?: number;
+    nativeFallbackTimeout?: number;
+}
+/** Packet source information */
+export interface PacketSource {
+    address: string;
+    port: number;
+    transport: "native" | "tunnel";
+    recovered?: boolean;
+}
+/** Subscription state */
+export type SubscriptionState = "initializing" | "joining" | "active" | "suspended" | "closed" | "error";
+/** Subscription statistics */
+export interface SubscriptionStats {
+    packetsReceived: number;
+    bytesReceived: number;
+    packetsLost: number;
+    packetsRecovered: number;
+    bitrate: number;
+    uptime: number;
+}
+/** Multicast subscription handle */
+export interface MulticastSubscriptionHandle {
+    readonly state: SubscriptionState;
+    readonly group: string;
+    readonly source?: string;
+    readonly port: number;
+    readonly transport: "native" | "tunnel";
+    readonly stats: SubscriptionStats;
+    close(): Promise<void>;
+}
+/** FEC Configuration for MMT streams */
+export interface FecConfig {
+    enabled?: boolean;
+    oti?: Uint8Array;
+    interleaveDepth?: number;
+    blockTimeoutMs?: number;
+    greenFillEnabled?: boolean;
+}
+/** FEC Statistics */
+export interface FecStats {
+    sourcePackets: number;
+    repairPackets: number;
+    blocksComplete: number;
+    blocksRecovered: number;
+    blocksFailed: number;
+    recoveryRate: number;
+    greenFillFrames: number;
+}
+/** Extended MulticastConfig with FEC support */
+export interface MulticastConfigWithFec extends MulticastConfig {
+    fec?: FecConfig;
+    onFecStats?: (stats: FecStats) => void;
+}
+/** Main Multicast Bridge API */
+export interface MulticastBridge {
+    subscribe(config: MulticastConfig | MulticastConfigWithFec): Promise<MulticastSubscriptionHandle>;
+    getSubscriptions(): Promise<MulticastSubscriptionHandle[]>;
+    isNativeSupported(): Promise<boolean>;
+    getFecStats?(): FecStats | null;
+}
+/**
+ * FEC_CONFIG message type per draft-ramadan-moq-fec-00
+ * Used to signal FEC configuration to subscribers
+ */
+export declare const FEC_CONFIG_MESSAGE_TYPE = 80;
+/**
+ * Repair track suffix per draft-ramadan-moq-fec-00 Section 5.1
+ * Repair tracks are named by appending this suffix to the source track path
+ */
+export declare const REPAIR_TRACK_SUFFIX = "repair";
+/**
+ * Get the repair track path for a given source track
+ *
+ * Per draft-ramadan-moq-fec-00 Section 5.1, the repair track is named
+ * by appending "repair" to the source track path.
+ *
+ * @param sourceTrack - The source track path (e.g., "live/video")
+ * @returns The repair track path (e.g., "live/video/repair")
+ *
+ * @example
+ * repairTrackPath("live/video") // returns "live/video/repair"
+ * repairTrackPath("broadcast/video/1080p") // returns "broadcast/video/1080p/repair"
+ */
+export declare function repairTrackPath(sourceTrack: string): string;
+/**
+ * Check if a track path is a repair track
+ *
+ * @param path - The track path to check
+ * @returns True if the path ends with the repair track suffix
+ *
+ * @example
+ * isRepairTrack("live/video/repair") // returns true
+ * isRepairTrack("repair") // returns true
+ * isRepairTrack("live/video") // returns false
+ */
+export declare function isRepairTrack(path: string): boolean;
+/**
+ * Get the source track path from a repair track path
+ *
+ * @param repairTrack - The repair track path
+ * @returns The source track path, or null if not a valid repair track
+ *
+ * @example
+ * sourceTrackFromRepair("live/video/repair") // returns "live/video"
+ * sourceTrackFromRepair("repair") // returns ""
+ * sourceTrackFromRepair("live/video") // returns null
+ */
+export declare function sourceTrackFromRepair(repairTrack: string): string | null;
+/**
+ * MoQ FEC Configuration per draft-ramadan-moq-fec-00
+ *
+ * This configuration is sent via FEC_CONFIG message after SUBSCRIBE_OK
+ * to inform subscribers about FEC parameters.
+ */
+export interface MoqFecConfig {
+    /** Subscribe ID this config applies to */
+    subscribeId: number;
+    /** Whether FEC is enabled */
+    enabled: boolean;
+    /** FEC algorithm (0=none, 1=XOR, 2=RaptorQ) */
+    algorithm: MoqFecAlgorithm;
+    /** Number of source symbols per FEC block (K) */
+    sourceSymbolsPerBlock: number;
+    /** Number of repair symbols per FEC block (P) */
+    repairSymbolsPerBlock: number;
+    /** Interleave depth for burst loss protection */
+    interleaveDepth: number;
+    /** Symbol size in bytes */
+    symbolSize: number;
+    /** RFC 6330 Object Transmission Information (12 bytes) - only for RaptorQ */
+    oti?: Uint8Array;
+}
+/**
+ * FEC algorithm identifier per draft-ramadan-moq-fec-00
+ */
+export declare enum MoqFecAlgorithm {
+    /** No FEC (disabled) */
+    None = 0,
+    /** Simple XOR parity */
+    Xor = 1,
+    /** RaptorQ (RFC 6330) - recommended for burst loss */
+    RaptorQ = 2
+}
+/**
+ * Repair object header per draft-ramadan-moq-fec-00 Section 6.1
+ *
+ * Each object on a repair track contains repair symbols for one source block.
+ * The object payload begins with this header, followed by concatenated repair symbols.
+ */
+export interface RepairObjectHeader {
+    /** Source block number being protected (matches group_id of source objects) */
+    sourceBlockNumber: number;
+    /** First Repair Symbol ESI (Encoding Symbol ID) - for RaptorQ, repair ESIs >= K */
+    firstRepairEsi: number;
+    /** Number of repair symbols in this object */
+    numRepairSymbols: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,85 @@
+/**
+ * @blockcast/transport - Type Definitions
+ *
+ * Shared interfaces for unified transport (WebTransport, SSM, AMT, DRIAD) and FEC.
+ */
+// ============================================================
+// FEC Constants and Utilities per draft-ramadan-moq-fec-00
+// ============================================================
+/**
+ * FEC_CONFIG message type per draft-ramadan-moq-fec-00
+ * Used to signal FEC configuration to subscribers
+ */
+export const FEC_CONFIG_MESSAGE_TYPE = 0x50;
+/**
+ * Repair track suffix per draft-ramadan-moq-fec-00 Section 5.1
+ * Repair tracks are named by appending this suffix to the source track path
+ */
+export const REPAIR_TRACK_SUFFIX = "repair";
+/**
+ * Get the repair track path for a given source track
+ *
+ * Per draft-ramadan-moq-fec-00 Section 5.1, the repair track is named
+ * by appending "repair" to the source track path.
+ *
+ * @param sourceTrack - The source track path (e.g., "live/video")
+ * @returns The repair track path (e.g., "live/video/repair")
+ *
+ * @example
+ * repairTrackPath("live/video") // returns "live/video/repair"
+ * repairTrackPath("broadcast/video/1080p") // returns "broadcast/video/1080p/repair"
+ */
+export function repairTrackPath(sourceTrack) {
+    if (!sourceTrack || sourceTrack.length === 0) {
+        return REPAIR_TRACK_SUFFIX;
+    }
+    return `${sourceTrack}/${REPAIR_TRACK_SUFFIX}`;
+}
+/**
+ * Check if a track path is a repair track
+ *
+ * @param path - The track path to check
+ * @returns True if the path ends with the repair track suffix
+ *
+ * @example
+ * isRepairTrack("live/video/repair") // returns true
+ * isRepairTrack("repair") // returns true
+ * isRepairTrack("live/video") // returns false
+ */
+export function isRepairTrack(path) {
+    return path === REPAIR_TRACK_SUFFIX || path.endsWith(`/${REPAIR_TRACK_SUFFIX}`);
+}
+/**
+ * Get the source track path from a repair track path
+ *
+ * @param repairTrack - The repair track path
+ * @returns The source track path, or null if not a valid repair track
+ *
+ * @example
+ * sourceTrackFromRepair("live/video/repair") // returns "live/video"
+ * sourceTrackFromRepair("repair") // returns ""
+ * sourceTrackFromRepair("live/video") // returns null
+ */
+export function sourceTrackFromRepair(repairTrack) {
+    if (repairTrack === REPAIR_TRACK_SUFFIX) {
+        return "";
+    }
+    const suffix = `/${REPAIR_TRACK_SUFFIX}`;
+    if (repairTrack.endsWith(suffix)) {
+        return repairTrack.slice(0, -suffix.length);
+    }
+    return null;
+}
+/**
+ * FEC algorithm identifier per draft-ramadan-moq-fec-00
+ */
+export var MoqFecAlgorithm;
+(function (MoqFecAlgorithm) {
+    /** No FEC (disabled) */
+    MoqFecAlgorithm[MoqFecAlgorithm["None"] = 0] = "None";
+    /** Simple XOR parity */
+    MoqFecAlgorithm[MoqFecAlgorithm["Xor"] = 1] = "Xor";
+    /** RaptorQ (RFC 6330) - recommended for burst loss */
+    MoqFecAlgorithm[MoqFecAlgorithm["RaptorQ"] = 2] = "RaptorQ";
+})(MoqFecAlgorithm || (MoqFecAlgorithm = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoSH,+DAA+D;AAC/D,2DAA2D;AAC3D,+DAA+D;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IAClD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,mBAAmB,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,WAAW,IAAI,mBAAmB,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,OAAO,IAAI,KAAK,mBAAmB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACxD,IAAI,WAAW,KAAK,mBAAmB,EAAE,CAAC;QACzC,OAAO,EAAE,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACzC,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AA2BD;;GAEG;AACH,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IAC1B,wBAAwB;IACxB,qDAAQ,CAAA;IACR,wBAAwB;IACxB,mDAAO,CAAA;IACP,sDAAsD;IACtD,2DAAW,CAAA;AACZ,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@blockcast/mmt-transport",
+  "version": "0.2.0",
+  "description": "Unified transport manager for MoQ with WebTransport, SSM multicast, AMT, DRIAD, and FEC support",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./fec": {
+      "import": "./dist/fec-client.js",
+      "types": "./dist/fec-client.d.ts"
+    },
+    "./clock": {
+      "import": "./dist/clock.js",
+      "types": "./dist/clock.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@blockcast/mmt-fec": "file:../fec",
+    "mmt-wasm": "file:../../mmt-wasm/pkg"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^1.6.1"
+  },
+  "keywords": [
+    "moq",
+    "webtransport",
+    "multicast",
+    "ssm",
+    "amt",
+    "driad",
+    "fec",
+    "raptorq",
+    "streaming",
+    "quic"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Blockcast/libmmt.git",
+    "directory": "packages/transport"
+  }
+}