@blockcast/mmt-transport 0.2.0 → 0.2.2

package/dist/multicast-subscription-pool.test.js

@@ -0,0 +1,108 @@
+import { describe, expect, it, vi } from "vitest";
+import { MulticastSubscriptionPool } from "./multicast-subscription-pool.js";
+const config = {
+    group: "232.1.1.1",
+    source: "192.0.2.1",
+    port: 5000,
+    streamType: "video",
+};
+describe("MulticastSubscriptionPool", () => {
+    it("shares an endpoint and unsubscribes only after the last owner releases", async () => {
+        const listeners = new Map();
+        const unsubscribe = vi.fn();
+        const subscription = {
+            addEventListener: vi.fn((type, listener) => listeners.set(type, listener)),
+            removeEventListener: vi.fn(),
+            unsubscribe,
+        };
+        const subscribe = vi.fn().mockResolvedValue(subscription);
+        const gateway = { subscribe };
+        const pool = new MulticastSubscriptionPool();
+        const firstPacket = vi.fn();
+        const secondPacket = vi.fn();
+        const first = await pool.acquire(gateway, config, { onBytes: firstPacket });
+        const second = await pool.acquire(gateway, { ...config, group: " 232.1.1.1 " }, { onBytes: secondPacket });
+        expect(subscribe).toHaveBeenCalledOnce();
+        const payload = new Uint8Array([1, 2]).buffer;
+        listeners.get("bytes")?.({ detail: payload });
+        expect(firstPacket).toHaveBeenCalledWith(payload);
+        expect(secondPacket).toHaveBeenCalledWith(payload);
+        await first.release();
+        expect(unsubscribe).not.toHaveBeenCalled();
+        await second.release();
+        expect(unsubscribe).toHaveBeenCalledOnce();
+        expect(pool.size).toBe(0);
+    });
+    it("counts an awaiting acquire before the previous owner releases", async () => {
+        const unsubscribe = vi.fn();
+        const subscription = {
+            addEventListener: vi.fn(), removeEventListener: vi.fn(), unsubscribe,
+        };
+        const subscribe = vi.fn().mockResolvedValue(subscription);
+        const gateway = { subscribe };
+        const pool = new MulticastSubscriptionPool();
+        const first = await pool.acquire(gateway, config, { onBytes: vi.fn() });
+        const secondPending = pool.acquire(gateway, config, { onBytes: vi.fn() });
+        await first.release();
+        const second = await secondPending;
+        expect(unsubscribe).not.toHaveBeenCalled();
+        expect(pool.size).toBe(1);
+        await second.release();
+        expect(unsubscribe).toHaveBeenCalledOnce();
+    });
+    it("does not conflate transport preferences or gateway instances", async () => {
+        const makeSubscription = () => ({
+            addEventListener: vi.fn(), removeEventListener: vi.fn(), unsubscribe: vi.fn(),
+        });
+        const firstGateway = { subscribe: vi.fn().mockResolvedValue(makeSubscription()) };
+        const secondGateway = { subscribe: vi.fn().mockResolvedValue(makeSubscription()) };
+        const pool = new MulticastSubscriptionPool();
+        const native = await pool.acquire(firstGateway, { ...config, mode: "native" }, { onBytes: vi.fn() });
+        const tunnel = await pool.acquire(firstGateway, { ...config, mode: "tunnel", amtRelay: "relay.example" }, { onBytes: vi.fn() });
+        const replacement = await pool.acquire(secondGateway, { ...config, mode: "native" }, { onBytes: vi.fn() });
+        expect(firstGateway.subscribe).toHaveBeenCalledTimes(2);
+        expect(secondGateway.subscribe).toHaveBeenCalledOnce();
+        await Promise.all([native.release(), tunnel.release(), replacement.release()]);
+    });
+    it("evicts a closed entry so the next owner reconnects", async () => {
+        const stateListeners = [];
+        const subscribe = vi.fn().mockImplementation(async () => ({
+            addEventListener: vi.fn((type, listener) => {
+                if (type === "state")
+                    stateListeners.push(listener);
+            }),
+            removeEventListener: vi.fn(),
+            unsubscribe: vi.fn(),
+        }));
+        const gateway = { subscribe };
+        const pool = new MulticastSubscriptionPool();
+        const first = await pool.acquire(gateway, config, { onBytes: vi.fn() });
+        stateListeners[0]({ detail: "closed" });
+        expect(pool.size).toBe(0);
+        const second = await pool.acquire(gateway, config, { onBytes: vi.fn() });
+        expect(subscribe).toHaveBeenCalledTimes(2);
+        await first.release();
+        await second.release();
+    });
+    it("isolates consumer callback failures", async () => {
+        let bytesListener;
+        const subscribe = vi.fn().mockResolvedValue({
+            addEventListener: vi.fn((type, listener) => {
+                if (type === "bytes")
+                    bytesListener = listener;
+            }),
+            removeEventListener: vi.fn(), unsubscribe: vi.fn(),
+        });
+        const gateway = { subscribe };
+        const pool = new MulticastSubscriptionPool();
+        const secondConsumer = vi.fn();
+        const first = await pool.acquire(gateway, config, { onBytes: () => { throw new Error("boom"); } });
+        const second = await pool.acquire(gateway, config, { onBytes: secondConsumer });
+        const consoleError = vi.spyOn(console, "error").mockImplementation(() => { });
+        bytesListener?.({ detail: new ArrayBuffer(1) });
+        expect(secondConsumer).toHaveBeenCalledOnce();
+        consoleError.mockRestore();
+        await Promise.all([first.release(), second.release()]);
+    });
+});
+//# sourceMappingURL=multicast-subscription-pool.test.js.map

package/dist/multicast-subscription-pool.test.js.map

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

package/dist/multicast-tier.d.ts

@@ -0,0 +1,14 @@
+export interface MulticastTierEndpoint {
+    sourceAddress?: string;
+    groupAddress: string;
+    port: number;
+    tracks: {
+        name: string;
+        packetId?: number;
+    }[];
+    bandwidth?: number;
+    protocol?: string;
+}
+export declare function endpointKey(endpoint: MulticastTierEndpoint): string;
+export declare function selectMulticastTier(endpoints: readonly MulticastTierEndpoint[], estimate: number | undefined): MulticastTierEndpoint | undefined;
+//# sourceMappingURL=multicast-tier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multicast-tier.d.ts","sourceRoot":"","sources":["../src/multicast-tier.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAEnE;AAED,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC1B,qBAAqB,GAAG,SAAS,CAenC"}

package/dist/multicast-tier.js

@@ -0,0 +1,22 @@
+export function endpointKey(endpoint) {
+    return `${endpoint.sourceAddress ?? ""}|${endpoint.groupAddress}|${endpoint.port}`;
+}
+export function selectMulticastTier(endpoints, estimate) {
+    if (endpoints.length <= 1)
+        return endpoints[0];
+    const ranked = endpoints
+        .filter((endpoint) => typeof endpoint.bandwidth === "number" && endpoint.bandwidth > 0)
+        .sort((a, b) => a.bandwidth - b.bandwidth);
+    if (ranked.length < 2)
+        return endpoints[0];
+    if (estimate === undefined)
+        return ranked[0];
+    const budget = estimate * 0.8;
+    let selected;
+    for (const endpoint of ranked) {
+        if (endpoint.bandwidth <= budget)
+            selected = endpoint;
+    }
+    return selected ?? ranked[0];
+}
+//# sourceMappingURL=multicast-tier.js.map

package/dist/multicast-tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multicast-tier.js","sourceRoot":"","sources":["../src/multicast-tier.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,WAAW,CAAC,QAA+B;IAC1D,OAAO,GAAG,QAAQ,CAAC,aAAa,IAAI,EAAE,IAAI,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAClC,SAA2C,EAC3C,QAA4B;IAE5B,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,SAAS;SACtB,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,IAAI,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;SACtF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAU,GAAG,CAAC,CAAC,SAAU,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,QAAQ,GAAG,GAAG,CAAC;IAC9B,IAAI,QAA2C,CAAC;IAChD,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;QAC/B,IAAI,QAAQ,CAAC,SAAU,IAAI,MAAM;YAAE,QAAQ,GAAG,QAAQ,CAAC;IACxD,CAAC;IACD,OAAO,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/dist/multicast-tier.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=multicast-tier.test.d.ts.map

package/dist/multicast-tier.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multicast-tier.test.d.ts","sourceRoot":"","sources":["../src/multicast-tier.test.ts"],"names":[],"mappings":""}

package/dist/multicast-tier.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it } from "vitest";
+import { MulticastOrchestrator } from "./multicast-orchestrator.js";
+import { endpointKey, selectMulticastTier } from "./multicast-tier.js";
+const low = {
+    groupAddress: "232.1.1.1", port: 5000, tracks: [{ name: "video/720p" }], bandwidth: 2_000_000,
+};
+const high = {
+    groupAddress: "232.1.1.2", port: 5000, tracks: [{ name: "video/4k" }], bandwidth: 15_000_000,
+};
+describe("multicast tier selection", () => {
+    it("starts conservatively and applies headroom", () => {
+        expect(selectMulticastTier([high, low], undefined)).toBe(low);
+        expect(selectMulticastTier([low, high], 16_000_000)).toBe(low);
+        expect(selectMulticastTier([low, high], 20_000_000)).toBe(high);
+    });
+    it("switches make-before-break only on a valid target RAP", () => {
+        let now = 0;
+        const orchestrator = new MulticastOrchestrator({
+            endpoints: [low, high], now: () => now, dwellMs: 1000, joinDeadlineMs: 5000,
+        });
+        expect(orchestrator.start()).toBe(low);
+        expect(orchestrator.onGoodput({ bitrate: 20_000_000 })).toBeUndefined();
+        now = 1000;
+        expect(orchestrator.onGoodput({ bitrate: 20_000_000 })?.kind).toBe("join-target");
+        expect(orchestrator.onTierPacket({
+            endpointKey: endpointKey(high), keyframe: false, timestamp: 10, hasValidCodecConfig: true,
+        })).toBeUndefined();
+        expect(orchestrator.onTierPacket({
+            endpointKey: endpointKey(high), keyframe: true, timestamp: 11, hasValidCodecConfig: true,
+        })?.kind).toBe("commit-swap");
+    });
+    it("preserves a pinned initial tier", () => {
+        let now = 0;
+        const orchestrator = new MulticastOrchestrator({
+            endpoints: [low, high], initialEndpoint: high, adaptive: false,
+            now: () => now, dwellMs: 1000, joinDeadlineMs: 5000,
+        });
+        expect(orchestrator.start()).toBe(high);
+        expect(orchestrator.onGoodput({ bitrate: 1_000_000 })).toBeUndefined();
+        now = 10_000;
+        expect(orchestrator.onGoodput({ bitrate: 1_000_000 })).toBeUndefined();
+        expect(orchestrator.current).toBe(high);
+    });
+    it("abandons a silent target when polled after the join deadline", () => {
+        let now = 0;
+        const orchestrator = new MulticastOrchestrator({
+            endpoints: [low, high], now: () => now, dwellMs: 1000, joinDeadlineMs: 5000,
+        });
+        orchestrator.start();
+        orchestrator.onGoodput({ bitrate: 20_000_000 });
+        now = 1000;
+        orchestrator.onGoodput({ bitrate: 20_000_000 });
+        now = 6000;
+        expect(orchestrator.poll()?.kind).toBe("abandon-join");
+        expect(orchestrator.state).toBe("stable");
+    });
+    it("rejects a target RAP older than the active tier high-water mark", () => {
+        let now = 0;
+        const orchestrator = new MulticastOrchestrator({
+            endpoints: [low, high], now: () => now, dwellMs: 1000, joinDeadlineMs: 5000,
+        });
+        orchestrator.start();
+        orchestrator.onTierPacket({
+            endpointKey: endpointKey(low), keyframe: false, timestamp: 10_000, hasValidCodecConfig: true,
+        });
+        orchestrator.onGoodput({ bitrate: 20_000_000 });
+        now = 1000;
+        orchestrator.onGoodput({ bitrate: 20_000_000 });
+        expect(orchestrator.onTierPacket({
+            endpointKey: endpointKey(high), keyframe: true, timestamp: 9_000, hasValidCodecConfig: true,
+        })).toBeUndefined();
+        expect(orchestrator.state).toBe("joining");
+    });
+});
+//# sourceMappingURL=multicast-tier.test.js.map

package/dist/multicast-tier.test.js.map

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

package/dist/no-modules.d.ts

@@ -0,0 +1,29 @@
+import { AdaptiveBitrateController } from "./abr-controller.js";
+import { isMulticastExplicitlyDisabled, isUsableMulticastEndpoint, isValidMulticastGroupAddress, multicastEndpointKey, normalizeMulticastEndpoint, readUrlMulticastConfig } from "./endpoint-config.js";
+import { MulticastOrchestrator } from "./multicast-orchestrator.js";
+import { MulticastSubscriptionPool } from "./multicast-subscription-pool.js";
+import { endpointKey, selectMulticastTier } from "./multicast-tier.js";
+import { TransportStallDetector } from "./stall-detector.js";
+import { makeSourceSwitchHandler, wireStarvationDetector } from "./takeover.js";
+import { TransportManager } from "./transport-manager.js";
+import { runUnicastFallback } from "./unicast-fallback.js";
+declare const api: {
+    AdaptiveBitrateController: typeof AdaptiveBitrateController;
+    MulticastOrchestrator: typeof MulticastOrchestrator;
+    MulticastSubscriptionPool: typeof MulticastSubscriptionPool;
+    TransportManager: typeof TransportManager;
+    TransportStallDetector: typeof TransportStallDetector;
+    endpointKey: typeof endpointKey;
+    isMulticastExplicitlyDisabled: typeof isMulticastExplicitlyDisabled;
+    isUsableMulticastEndpoint: typeof isUsableMulticastEndpoint;
+    isValidMulticastGroupAddress: typeof isValidMulticastGroupAddress;
+    makeSourceSwitchHandler: typeof makeSourceSwitchHandler;
+    multicastEndpointKey: typeof multicastEndpointKey;
+    normalizeMulticastEndpoint: typeof normalizeMulticastEndpoint;
+    readUrlMulticastConfig: typeof readUrlMulticastConfig;
+    runUnicastFallback: typeof runUnicastFallback;
+    selectMulticastTier: typeof selectMulticastTier;
+    wireStarvationDetector: typeof wireStarvationDetector;
+};
+export default api;
+//# sourceMappingURL=no-modules.d.ts.map

package/dist/no-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-modules.d.ts","sourceRoot":"","sources":["../src/no-modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACN,6BAA6B,EAC7B,yBAAyB,EACzB,4BAA4B,EAC5B,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,QAAA,MAAM,GAAG;;;;;;;;;;;;;;;;;CAiBR,CAAC;AASF,eAAe,GAAG,CAAC"}

package/dist/no-modules.js

@@ -0,0 +1,35 @@
+import { AdaptiveBitrateController } from "./abr-controller.js";
+import { isMulticastExplicitlyDisabled, isUsableMulticastEndpoint, isValidMulticastGroupAddress, multicastEndpointKey, normalizeMulticastEndpoint, readUrlMulticastConfig, } from "./endpoint-config.js";
+import { MulticastOrchestrator } from "./multicast-orchestrator.js";
+import { MulticastSubscriptionPool } from "./multicast-subscription-pool.js";
+import { endpointKey, selectMulticastTier } from "./multicast-tier.js";
+import { TransportStallDetector } from "./stall-detector.js";
+import { makeSourceSwitchHandler, wireStarvationDetector } from "./takeover.js";
+import { TransportManager } from "./transport-manager.js";
+import { runUnicastFallback } from "./unicast-fallback.js";
+const api = {
+    AdaptiveBitrateController,
+    MulticastOrchestrator,
+    MulticastSubscriptionPool,
+    TransportManager,
+    TransportStallDetector,
+    endpointKey,
+    isMulticastExplicitlyDisabled,
+    isUsableMulticastEndpoint,
+    isValidMulticastGroupAddress,
+    makeSourceSwitchHandler,
+    multicastEndpointKey,
+    normalizeMulticastEndpoint,
+    readUrlMulticastConfig,
+    runUnicastFallback,
+    selectMulticastTier,
+    wireStarvationDetector,
+};
+Object.defineProperty(globalThis, "__MmtTransport", {
+    configurable: true,
+    enumerable: false,
+    writable: false,
+    value: Object.freeze(api),
+});
+export default api;
+//# sourceMappingURL=no-modules.js.map

package/dist/no-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-modules.js","sourceRoot":"","sources":["../src/no-modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACN,6BAA6B,EAC7B,yBAAyB,EACzB,4BAA4B,EAC5B,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,GAAG,GAAG;IACX,yBAAyB;IACzB,qBAAqB;IACrB,yBAAyB;IACzB,gBAAgB;IAChB,sBAAsB;IACtB,WAAW;IACX,6BAA6B;IAC7B,yBAAyB;IACzB,4BAA4B;IAC5B,uBAAuB;IACvB,oBAAoB;IACpB,0BAA0B;IAC1B,sBAAsB;IACtB,kBAAkB;IAClB,mBAAmB;IACnB,sBAAsB;CACtB,CAAC;AAEF,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,gBAAgB,EAAE;IACnD,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,KAAK;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;CACzB,CAAC,CAAC;AAEH,eAAe,GAAG,CAAC"}

package/dist/stall-detector.d.ts

@@ -0,0 +1,22 @@
+export interface FecProgressSnapshot {
+    sourceSymbols: number;
+    repairSymbols: number;
+    blocksComplete: number;
+    blocksRecovered: number;
+    mediaFrames?: number;
+}
+export interface StallDetectorConfig {
+    windowMs: number;
+    onStarvation(): void;
+    onRecovery(): void;
+    now?: () => number;
+}
+export declare class TransportStallDetector {
+    #private;
+    private readonly config;
+    constructor(config: StallDetectorConfig);
+    get isStarved(): boolean;
+    update(snapshot: FecProgressSnapshot): void;
+    reset(): void;
+}
+//# sourceMappingURL=stall-detector.d.ts.map

package/dist/stall-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-detector.d.ts","sourceRoot":"","sources":["../src/stall-detector.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,IAAI,IAAI,CAAC;IACrB,UAAU,IAAI,IAAI,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,qBAAa,sBAAsB;;IAOtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,mBAAmB;IAKxD,IAAI,SAAS,IAAI,OAAO,CAA0B;IAElD,MAAM,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IA4B3C,KAAK,IAAI,IAAI;CAKb"}

package/dist/stall-detector.js

@@ -0,0 +1,46 @@
+export class TransportStallDetector {
+    config;
+    #last = null;
+    #lastSampleAt = 0;
+    #starvedSince = null;
+    #latched = false;
+    #now;
+    constructor(config) {
+        this.config = config;
+        if (config.windowMs <= 0)
+            throw new Error("Stall window must be positive and catalog-derived");
+        this.#now = config.now ?? Date.now;
+    }
+    get isStarved() { return this.#latched; }
+    update(snapshot) {
+        const previous = this.#last;
+        const previousAt = this.#lastSampleAt;
+        const now = this.#now();
+        this.#last = { ...snapshot };
+        this.#lastSampleAt = now;
+        if (!previous)
+            return;
+        const blockDelta = snapshot.blocksComplete - previous.blocksComplete +
+            snapshot.blocksRecovered - previous.blocksRecovered;
+        const mediaDelta = (snapshot.mediaFrames ?? 0) - (previous.mediaFrames ?? 0);
+        if (blockDelta <= 0 && mediaDelta <= 0) {
+            this.#starvedSince ??= previousAt;
+            if (!this.#latched && now - this.#starvedSince >= this.config.windowMs) {
+                this.#latched = true;
+                this.config.onStarvation();
+            }
+            return;
+        }
+        this.#starvedSince = null;
+        if (this.#latched) {
+            this.#latched = false;
+            this.config.onRecovery();
+        }
+    }
+    reset() {
+        this.#last = null;
+        this.#starvedSince = null;
+        this.#latched = false;
+    }
+}
+//# sourceMappingURL=stall-detector.js.map

package/dist/stall-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-detector.js","sourceRoot":"","sources":["../src/stall-detector.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,sBAAsB;IAOL;IAN7B,KAAK,GAA+B,IAAI,CAAC;IACzC,aAAa,GAAG,CAAC,CAAC;IAClB,aAAa,GAAkB,IAAI,CAAC;IACpC,QAAQ,GAAG,KAAK,CAAC;IACR,IAAI,CAAe;IAE5B,YAA6B,MAA2B;QAA3B,WAAM,GAAN,MAAM,CAAqB;QACvD,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAC/F,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,CAAC;IAED,IAAI,SAAS,KAAc,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAElD,MAAM,CAAC,QAA6B;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;QACzB,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,UAAU,GAAG,QAAQ,CAAC,cAAc,GAAG,QAAQ,CAAC,cAAc;YACnE,QAAQ,CAAC,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC;QACrD,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;QAE7E,IAAI,UAAU,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,aAAa,KAAK,UAAU,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,GAAG,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACxE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACrB,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC5B,CAAC;YACD,OAAO;QACR,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;IACF,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACvB,CAAC;CACD"}

package/dist/stall-detector.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stall-detector.test.d.ts.map

package/dist/stall-detector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-detector.test.d.ts","sourceRoot":"","sources":["../src/stall-detector.test.ts"],"names":[],"mappings":""}

package/dist/stall-detector.test.js

@@ -0,0 +1,33 @@
+import { describe, expect, it, vi } from "vitest";
+import { TransportStallDetector } from "./stall-detector.js";
+describe("TransportStallDetector", () => {
+    it("detects repair-only starvation and recovery", () => {
+        let now = 0;
+        const onStarvation = vi.fn();
+        const onRecovery = vi.fn();
+        const detector = new TransportStallDetector({ windowMs: 1000, now: () => now, onStarvation, onRecovery });
+        detector.update({ sourceSymbols: 0, repairSymbols: 0, blocksComplete: 0, blocksRecovered: 0 });
+        now = 1000;
+        detector.update({ sourceSymbols: 0, repairSymbols: 10, blocksComplete: 0, blocksRecovered: 0 });
+        expect(onStarvation).toHaveBeenCalledOnce();
+        now = 1100;
+        detector.update({ sourceSymbols: 1, repairSymbols: 10, blocksComplete: 1, blocksRecovered: 0 });
+        expect(onRecovery).toHaveBeenCalledOnce();
+    });
+    it("detects starvation when all packet counters stop", () => {
+        let now = 0;
+        const onStarvation = vi.fn();
+        const detector = new TransportStallDetector({
+            windowMs: 1000,
+            now: () => now,
+            onStarvation,
+            onRecovery: vi.fn(),
+        });
+        const snapshot = { sourceSymbols: 10, repairSymbols: 2, blocksComplete: 1, blocksRecovered: 0 };
+        detector.update(snapshot);
+        now = 1000;
+        detector.update(snapshot);
+        expect(onStarvation).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=stall-detector.test.js.map

package/dist/stall-detector.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-detector.test.js","sourceRoot":"","sources":["../src/stall-detector.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACtD,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;QAC1G,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/F,GAAG,GAAG,IAAI,CAAC;QACX,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC;QAChG,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC5C,GAAG,GAAG,IAAI,CAAC;QACX,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC;QAChG,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC3D,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CAAC;YAC3C,QAAQ,EAAE,IAAI;YACd,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG;YACd,YAAY;YACZ,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;SACnB,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;QAChG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,GAAG,GAAG,IAAI,CAAC;QACX,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/takeover.d.ts

@@ -0,0 +1,49 @@
+export interface ActivatableSessions {
+    activateMulticast(): void;
+}
+export declare function makeSourceSwitchHandler(options: {
+    multicastBridgeAvailable: boolean;
+    sessionsReady: Promise<ActivatableSessions | null>;
+    onMulticastConfirmed?(): void;
+    onAbortTakeover?(): void;
+    log?(message: string): void;
+    warn?(message: string): void;
+}): (source: string) => Promise<void>;
+export interface LossArcSession {
+    lossDetected(): void;
+    lossRecovered(): void;
+}
+export interface FecStarvationSnapshot {
+    sourceSymbols: number;
+    repairSymbols: number;
+    blocksComplete: number;
+    blocksRecovered: number;
+    mediaFrames?: number;
+}
+export interface StarvationDetectorLike {
+    update(snapshot: FecStarvationSnapshot): void;
+    reset(): void;
+}
+export type StallDetectorLike = StarvationDetectorLike;
+export declare function wireStallDetector(args: {
+    session: LossArcSession | undefined;
+    windowMs: number;
+    makeDetector(config: {
+        windowMs: number;
+        onStarvation(): void;
+        onRecovery(): void;
+    }): StallDetectorLike;
+}): StallDetectorLike | null;
+export declare function wireStarvationDetector(args: {
+    session: LossArcSession | undefined;
+    trackName: string;
+    fecInterleaveMs: number;
+    fecK: number;
+    makeDetector(config: {
+        windowMs: number;
+        onStarvation(): void;
+        onRecovery(): void;
+    }): StarvationDetectorLike;
+    warn?(message: string): void;
+}): Promise<StarvationDetectorLike | null>;
+//# sourceMappingURL=takeover.d.ts.map

package/dist/takeover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"takeover.d.ts","sourceRoot":"","sources":["../src/takeover.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAAG,iBAAiB,IAAI,IAAI,CAAC;CAAE;AAEnE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAChD,wBAAwB,EAAE,OAAO,CAAC;IAClC,aAAa,EAAE,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACnD,oBAAoB,CAAC,IAAI,IAAI,CAAC;IAC9B,eAAe,CAAC,IAAI,IAAI,CAAC;IACzB,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAmBpC;AAED,MAAM,WAAW,cAAc;IAAG,YAAY,IAAI,IAAI,CAAC;IAAC,aAAa,IAAI,IAAI,CAAC;CAAE;AAChF,MAAM,WAAW,qBAAqB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,sBAAsB;IAAG,MAAM,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAAC,KAAK,IAAI,IAAI,CAAC;CAAE;AACzG,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAEvD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,IAAI,IAAI,CAAC;QAAC,UAAU,IAAI,IAAI,CAAA;KAAE,GAAG,iBAAiB,CAAC;CACxG,GAAG,iBAAiB,GAAG,IAAI,CAO3B;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,IAAI,IAAI,CAAC;QAAC,UAAU,IAAI,IAAI,CAAA;KAAE,GAAG,sBAAsB,CAAC;IAC7G,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CASzC"}

package/dist/takeover.js

@@ -0,0 +1,43 @@
+export function makeSourceSwitchHandler(options) {
+    const log = options.log ?? console.log;
+    const warn = options.warn ?? console.warn;
+    return async (source) => {
+        if (source !== "multicast")
+            return;
+        if (!options.multicastBridgeAvailable) {
+            warn("[MoqWatch] MediaRouter requested multicast without bridge; keeping MoQ active");
+            return;
+        }
+        const sessions = await options.sessionsReady;
+        if (!sessions) {
+            warn("[MoqWatch] SessionManager unavailable; aborting multicast takeover, staying on MoQ");
+            options.onAbortTakeover?.();
+            return;
+        }
+        log("[MoqWatch] MediaRouter -> multicast; activating via SessionManager");
+        sessions.activateMulticast();
+        options.onMulticastConfirmed?.();
+    };
+}
+export function wireStallDetector(args) {
+    if (!args.session || args.windowMs <= 0)
+        return null;
+    return args.makeDetector({
+        windowMs: args.windowMs,
+        onStarvation: () => args.session.lossDetected(),
+        onRecovery: () => args.session.lossRecovered(),
+    });
+}
+export async function wireStarvationDetector(args) {
+    if (!args.session || args.fecInterleaveMs <= 0 || args.fecK <= 0)
+        return null;
+    const detector = wireStallDetector({
+        session: args.session,
+        windowMs: Math.ceil(args.fecInterleaveMs * 3),
+        makeDetector: args.makeDetector,
+    });
+    if (!detector)
+        args.warn?.(`Unable to create starvation detector for ${args.trackName}`);
+    return detector;
+}
+//# sourceMappingURL=takeover.js.map

package/dist/takeover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"takeover.js","sourceRoot":"","sources":["../src/takeover.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CAAC,OAOvC;IACA,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACvB,IAAI,MAAM,KAAK,WAAW;YAAE,OAAO;QACnC,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC;YACvC,IAAI,CAAC,+EAA+E,CAAC,CAAC;YACtF,OAAO;QACR,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,IAAI,CAAC,oFAAoF,CAAC,CAAC;YAC3F,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;YAC5B,OAAO;QACR,CAAC;QACD,GAAG,CAAC,oEAAoE,CAAC,CAAC;QAC1E,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAC7B,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;IAClC,CAAC,CAAC;AACH,CAAC;AAaD,MAAM,UAAU,iBAAiB,CAAC,IAIjC;IACA,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,IAAI,CAAC,YAAY,CAAC;QACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAQ,CAAC,YAAY,EAAE;QAChD,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAQ,CAAC,aAAa,EAAE;KAC/C,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAO5C;IACA,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,MAAM,QAAQ,GAAG,iBAAiB,CAAC;QAClC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QAC7C,YAAY,EAAE,IAAI,CAAC,YAAY;KAC/B,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,EAAE,CAAC,4CAA4C,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACzF,OAAO,QAAQ,CAAC;AACjB,CAAC"}