@blockcast/mmt-transport 0.2.0

package/dist/abr-controller.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @blockcast/transport - Adaptive Bitrate Controller
+ *
+ * Progressive adaptive bitrate increase based on network conditions.
+ * Monitors received bandwidth and packet loss to adjust quality levels.
+ *
+ * Per draft-ramadan-moq-fec-00, ABR decisions should use the **effective loss rate**
+ * after FEC recovery, not the raw transport-level loss rate. This allows FEC to
+ * mask burst losses without unnecessarily downgrading quality.
+ */
+import type { QualityLevel } from "./types.js";
+/**
+ * FEC statistics for ABR decisions
+ */
+export interface FecStatsForAbr {
+    /** Raw loss rate before FEC recovery (0.0-1.0) */
+    rawLossRate: number;
+    /** Effective loss rate after FEC recovery (0.0-1.0) */
+    effectiveLossRate: number;
+    /** FEC recovery rate (percentage of lost packets recovered) */
+    recoveryRate: number;
+    /** Whether FEC is enabled */
+    fecEnabled: boolean;
+}
+/**
+ * Standard quality levels for progressive ABR
+ */
+export declare const QUALITY_LEVELS: QualityLevel[];
+/**
+ * Progressive Adaptive Bitrate Controller
+ *
+ * Features:
+ * - Monitors bandwidth via received bytes over time window
+ * - Tracks packet loss rate (raw and effective after FEC)
+ * - Uses effective loss rate for ABR decisions per draft-ramadan-moq-fec-00
+ * - Progressive quality upgrades (waits for stability)
+ * - Fast quality downgrades on congestion
+ */
+export declare class AdaptiveBitrateController {
+    private currentQualityIndex;
+    private history;
+    private readonly historyWindow;
+    private readonly upgradeThreshold;
+    private readonly downgradeThreshold;
+    private readonly stabilityPeriod;
+    private lastQualityChange;
+    private onQualityChange?;
+    private fecStats;
+    constructor(initialQuality?: QualityLevel);
+    setCallback(callback: (quality: QualityLevel) => void): void;
+    getCurrentQuality(): QualityLevel;
+    /**
+     * Record network sample for bitrate adaptation
+     *
+     * @param bytesReceived - Bytes received in this sample
+     * @param packetsLost - Packets lost (raw, before FEC recovery)
+     */
+    recordSample(bytesReceived: number, packetsLost: number): void;
+    /**
+     * Update FEC statistics for ABR decisions
+     *
+     * Per draft-ramadan-moq-fec-00, ABR should use the effective loss rate
+     * (after FEC recovery) rather than raw transport loss rate.
+     *
+     * @param stats - FEC statistics from the FEC decoder
+     */
+    setFecStats(stats: FecStatsForAbr): void;
+    /**
+     * Get current FEC statistics
+     */
+    getFecStats(): FecStatsForAbr;
+    private calculateMetrics;
+    private upgrade;
+    private downgrade;
+    /**
+     * Force quality level (for testing)
+     */
+    setQuality(name: string): void;
+    /**
+     * Get current metrics including both raw and effective loss rates
+     */
+    getMetrics(): {
+        measuredBitrate: number;
+        rawLossRate: number;
+        effectiveLossRate: number;
+        fecEnabled: boolean;
+        sampleCount: number;
+    };
+    /**
+     * Reset history and start fresh
+     */
+    reset(): void;
+}
+//# sourceMappingURL=abr-controller.d.ts.map

package/dist/abr-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abr-controller.d.ts","sourceRoot":"","sources":["../src/abr-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,UAAU,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAQxC,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,OAAO,CAA2E;IAC1F,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEzC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,eAAe,CAAC,CAAkC;IAG1D,OAAO,CAAC,QAAQ,CAKd;gBAEU,cAAc,CAAC,EAAE,YAAY;IAMzC,WAAW,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI;IAIrD,iBAAiB,IAAI,YAAY;IAIjC;;;;;OAKG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAwCvD;;;;;;;OAOG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc;IAIjC;;OAEG;IACH,WAAW,IAAI,cAAc;IAI7B,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,SAAS;IAYjB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM;IASvB;;OAEG;IACH,UAAU,IAAI;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACpB;IAWD;;OAEG;IACH,KAAK;CAIL"}

package/dist/abr-controller.js

@@ -0,0 +1,174 @@
+/**
+ * @blockcast/transport - Adaptive Bitrate Controller
+ *
+ * Progressive adaptive bitrate increase based on network conditions.
+ * Monitors received bandwidth and packet loss to adjust quality levels.
+ *
+ * Per draft-ramadan-moq-fec-00, ABR decisions should use the **effective loss rate**
+ * after FEC recovery, not the raw transport-level loss rate. This allows FEC to
+ * mask burst losses without unnecessarily downgrading quality.
+ */
+/**
+ * Standard quality levels for progressive ABR
+ */
+export const QUALITY_LEVELS = [
+    { name: "240p", bitrate: 300_000, width: 426, height: 240, fps: 15 },
+    { name: "360p", bitrate: 500_000, width: 640, height: 360, fps: 24 },
+    { name: "480p", bitrate: 1_000_000, width: 854, height: 480, fps: 30 },
+    { name: "720p", bitrate: 2_500_000, width: 1280, height: 720, fps: 30 },
+    { name: "1080p", bitrate: 5_000_000, width: 1920, height: 1080, fps: 30 },
+    { name: "1440p", bitrate: 8_000_000, width: 2560, height: 1440, fps: 30 },
+    { name: "4K", bitrate: 15_000_000, width: 3840, height: 2160, fps: 30 },
+];
+/**
+ * Progressive Adaptive Bitrate Controller
+ *
+ * Features:
+ * - Monitors bandwidth via received bytes over time window
+ * - Tracks packet loss rate (raw and effective after FEC)
+ * - Uses effective loss rate for ABR decisions per draft-ramadan-moq-fec-00
+ * - Progressive quality upgrades (waits for stability)
+ * - Fast quality downgrades on congestion
+ */
+export class AdaptiveBitrateController {
+    currentQualityIndex;
+    history = [];
+    historyWindow = 10_000; // 10 second window
+    upgradeThreshold = 0.8; // 80% of target bitrate sustained
+    downgradeThreshold = 0.5; // 50% of target bitrate triggers downgrade
+    stabilityPeriod = 5_000; // Wait 5s before upgrading
+    lastQualityChange = 0;
+    onQualityChange;
+    // FEC stats for effective loss rate calculation
+    fecStats = {
+        rawLossRate: 0,
+        effectiveLossRate: 0,
+        recoveryRate: 1,
+        fecEnabled: false,
+    };
+    constructor(initialQuality) {
+        this.currentQualityIndex = initialQuality ? QUALITY_LEVELS.findIndex((q) => q.name === initialQuality.name) : 0;
+        if (this.currentQualityIndex < 0)
+            this.currentQualityIndex = 0;
+    }
+    setCallback(callback) {
+        this.onQualityChange = callback;
+    }
+    getCurrentQuality() {
+        return QUALITY_LEVELS[this.currentQualityIndex];
+    }
+    /**
+     * Record network sample for bitrate adaptation
+     *
+     * @param bytesReceived - Bytes received in this sample
+     * @param packetsLost - Packets lost (raw, before FEC recovery)
+     */
+    recordSample(bytesReceived, packetsLost) {
+        const now = Date.now();
+        this.history.push({ timestamp: now, bytesReceived, packetsLost });
+        // Prune old samples
+        this.history = this.history.filter((s) => now - s.timestamp < this.historyWindow);
+        // Calculate metrics
+        const { measuredBitrate, lossRate: rawLossRate } = this.calculateMetrics();
+        const currentQuality = this.getCurrentQuality();
+        // Per draft-ramadan-moq-fec-00: Use effective loss rate after FEC for ABR decisions
+        // This allows FEC to mask burst losses without triggering unnecessary downgrades
+        const effectiveLossRate = this.fecStats.fecEnabled
+            ? this.fecStats.effectiveLossRate
+            : rawLossRate;
+        // Decision logic
+        if (now - this.lastQualityChange < this.stabilityPeriod) {
+            return; // Wait for stability
+        }
+        // Check for downgrade - use effective loss rate (post-FEC)
+        // Only downgrade if FEC cannot recover the losses
+        if (effectiveLossRate > 0.05 || measuredBitrate < currentQuality.bitrate * this.downgradeThreshold) {
+            this.downgrade();
+            return;
+        }
+        // Check for upgrade (progressive increase) - use effective loss rate
+        if (measuredBitrate > currentQuality.bitrate * this.upgradeThreshold &&
+            effectiveLossRate < 0.01 &&
+            this.currentQualityIndex < QUALITY_LEVELS.length - 1) {
+            this.upgrade();
+        }
+    }
+    /**
+     * Update FEC statistics for ABR decisions
+     *
+     * Per draft-ramadan-moq-fec-00, ABR should use the effective loss rate
+     * (after FEC recovery) rather than raw transport loss rate.
+     *
+     * @param stats - FEC statistics from the FEC decoder
+     */
+    setFecStats(stats) {
+        this.fecStats = stats;
+    }
+    /**
+     * Get current FEC statistics
+     */
+    getFecStats() {
+        return { ...this.fecStats };
+    }
+    calculateMetrics() {
+        if (this.history.length < 2) {
+            return { measuredBitrate: 0, lossRate: 0 };
+        }
+        const totalBytes = this.history.reduce((sum, s) => sum + s.bytesReceived, 0);
+        const totalLost = this.history.reduce((sum, s) => sum + s.packetsLost, 0);
+        const duration = (this.history[this.history.length - 1].timestamp - this.history[0].timestamp) / 1000;
+        const measuredBitrate = duration > 0 ? (totalBytes * 8) / duration : 0;
+        const lossRate = totalLost / (this.history.length + totalLost);
+        return { measuredBitrate, lossRate };
+    }
+    upgrade() {
+        if (this.currentQualityIndex >= QUALITY_LEVELS.length - 1)
+            return;
+        this.currentQualityIndex++;
+        this.lastQualityChange = Date.now();
+        const newQuality = this.getCurrentQuality();
+        console.log(`[ABR] Upgrading to ${newQuality.name} (${newQuality.bitrate / 1_000_000}Mbps)`);
+        this.onQualityChange?.(newQuality);
+    }
+    downgrade() {
+        if (this.currentQualityIndex <= 0)
+            return;
+        this.currentQualityIndex--;
+        this.lastQualityChange = Date.now();
+        const newQuality = this.getCurrentQuality();
+        console.log(`[ABR] Downgrading to ${newQuality.name} (${newQuality.bitrate / 1_000_000}Mbps)`);
+        this.onQualityChange?.(newQuality);
+    }
+    /**
+     * Force quality level (for testing)
+     */
+    setQuality(name) {
+        const index = QUALITY_LEVELS.findIndex((q) => q.name === name);
+        if (index >= 0) {
+            this.currentQualityIndex = index;
+            this.lastQualityChange = Date.now();
+            this.onQualityChange?.(this.getCurrentQuality());
+        }
+    }
+    /**
+     * Get current metrics including both raw and effective loss rates
+     */
+    getMetrics() {
+        const { measuredBitrate, lossRate: rawLossRate } = this.calculateMetrics();
+        return {
+            measuredBitrate,
+            rawLossRate,
+            effectiveLossRate: this.fecStats.fecEnabled ? this.fecStats.effectiveLossRate : rawLossRate,
+            fecEnabled: this.fecStats.fecEnabled,
+            sampleCount: this.history.length,
+        };
+    }
+    /**
+     * Reset history and start fresh
+     */
+    reset() {
+        this.history = [];
+        this.lastQualityChange = 0;
+    }
+}
+//# sourceMappingURL=abr-controller.js.map

package/dist/abr-controller.js.map

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

package/dist/amt-gateway.d.ts

@@ -0,0 +1,160 @@
+/**
+ * @blockcast/transport - AMT Gateway
+ *
+ * Consolidated AMT (Automatic Multicast Tunneling) implementation
+ * supporting both Service Worker and Direct Sockets approaches.
+ *
+ * RFC 7450: Automatic Multicast Tunneling
+ */
+import type { GroupKey, PacketMetadata } from "./types.js";
+/** AMT gateway states */
+declare const GATEWAY_STATES: {
+    readonly IDLE: "idle";
+    readonly DISCOVERING: "discovering";
+    readonly REQUESTING: "requesting";
+    readonly QUERYING: "querying";
+    readonly ACTIVE: "active";
+    readonly LEAVING: "leaving";
+    readonly CLOSED: "closed";
+};
+type GatewayState = (typeof GATEWAY_STATES)[keyof typeof GATEWAY_STATES];
+/** AMT subscription configuration */
+export interface AMTSubscriptionConfig {
+    key: GroupKey;
+    relayAddress?: string;
+    relayPort?: number;
+    onPacket: (data: ArrayBuffer, metadata: PacketMetadata) => void;
+    onError: (error: Error) => void;
+}
+/** AMT packet info */
+export interface AMTPacketInfo {
+    data: Uint8Array;
+    srcAddress: string;
+    dstAddress: string;
+    srcPort: number;
+    dstPort: number;
+    groupKey: string;
+    timestamp: number;
+}
+/** AMT Gateway options */
+export interface AMTGatewayOptions {
+    relayAddress: string;
+    relayPort?: number;
+    onPacket?: (packet: AMTPacketInfo) => void;
+    onStateChange?: (newState: GatewayState, oldState: GatewayState) => void;
+    onError?: (error: Error) => void;
+    onLog?: (message: string) => void;
+}
+/**
+ * AMT Gateway Manager (Service Worker based)
+ *
+ * Manages AMT tunnel subscriptions using Service Worker for UDP communication.
+ * Handles DRIAD discovery, AMT handshake, and packet decapsulation.
+ */
+export declare class AMTGatewayManager {
+    private subscriptions;
+    private messageHandler?;
+    private pendingPackets;
+    private driad;
+    constructor();
+    /**
+     * Subscribe via AMT tunnel
+     */
+    subscribe(config: AMTSubscriptionConfig): Promise<string>;
+    /**
+     * Unsubscribe from AMT tunnel
+     */
+    unsubscribe(handle: string): Promise<void>;
+    /**
+     * Get list of active subscriptions
+     */
+    getSubscriptions(): string[];
+    /**
+     * Handle packet from service worker
+     */
+    private handlePacket;
+    /**
+     * Handle socket error from service worker
+     */
+    private handleSocketError;
+    /**
+     * Cleanup on destroy
+     */
+    destroy(): void;
+    /**
+     * Get key string for HashMap
+     */
+    private getKeyString;
+}
+/**
+ * AMT Gateway Client (Direct Sockets based)
+ *
+ * Connects to an AMT relay to receive multicast data via unicast tunnel.
+ * Implements the gateway side of RFC 7450.
+ * Supports multiple (S,G) groups over a single AMT tunnel.
+ */
+export declare class AMTGateway {
+    private relayAddress;
+    private relayPort;
+    private groups;
+    private onPacket;
+    private onStateChange;
+    private onError;
+    private onLog;
+    private state;
+    private nonce;
+    private responseMAC;
+    private relayConfirmedAddress;
+    private lastDataTime;
+    private stats;
+    constructor(options: AMTGatewayOptions);
+    /**
+     * Generate random nonce
+     */
+    private generateNonce;
+    /**
+     * Set gateway state
+     */
+    private setState;
+    /**
+     * Join a multicast group
+     */
+    joinGroup(groupAddress: string, groupPort: number, sourceAddress?: string | null, onPacket?: ((packet: AMTPacketInfo) => void) | null): Promise<string>;
+    /**
+     * Leave a multicast group
+     */
+    leaveGroup(groupAddress: string, sourceAddress?: string | null): Promise<boolean>;
+    /**
+     * Get list of active groups
+     */
+    getGroups(): Array<{
+        groupKey: string;
+        groupAddress: string;
+        sourceAddress: string | null;
+        groupPort: number;
+        joinedAt: number;
+    }>;
+    /**
+     * Open connection to AMT relay
+     */
+    open(): Promise<void>;
+    /**
+     * Close connection
+     */
+    close(): Promise<void>;
+    /**
+     * Get current statistics
+     */
+    getStats(): typeof this.stats;
+    /**
+     * Get current state
+     */
+    getState(): GatewayState;
+    /**
+     * Check if gateway is active and receiving data
+     */
+    isActive(): boolean;
+}
+export declare const amtGatewayManager: AMTGatewayManager;
+export {};
+//# sourceMappingURL=amt-gateway.d.ts.map

package/dist/amt-gateway.d.ts.map

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