@blockcast/mmt-transport 0.2.2 → 0.3.0

package/src/takeover.ts

@@ -28,7 +28,12 @@ export function makeSourceSwitchHandler(options: {
 	};
 }
 
-export interface LossArcSession { lossDetected(): void; lossRecovered(): void; }
+export interface LossArcSession {
+	/** TrackSession state. Optional so non-TrackSession hosts keep the generic API. */
+	readonly state?: string;
+	lossDetected(): void;
+	lossRecovered(): void;
+}
 export interface FecStarvationSnapshot {
 	sourceSymbols: number;
 	repairSymbols: number;
@@ -57,15 +62,48 @@ export async function wireStarvationDetector(args: {
 	trackName: string;
 	fecInterleaveMs: number;
 	fecK: number;
+	deliveryWindowMs?: number;
 	makeDetector(config: { windowMs: number; onStarvation(): void; onRecovery(): void }): StarvationDetectorLike;
 	warn?(message: string): void;
 }): Promise<StarvationDetectorLike | null> {
 	if (!args.session || args.fecInterleaveMs <= 0 || args.fecK <= 0) return null;
+	const windowMs = args.deliveryWindowMs ?? Math.ceil(args.fecInterleaveMs * 3);
+	if (!Number.isFinite(windowMs) || windowMs <= 0) {
+		args.warn?.(`Unable to create starvation detector for ${args.trackName}: invalid delivery window ${windowMs}`);
+		return null;
+	}
 	const detector = wireStallDetector({
 		session: args.session,
-		windowMs: Math.ceil(args.fecInterleaveMs * 3),
+		windowMs,
 		makeDetector: args.makeDetector,
 	});
 	if (!detector) args.warn?.(`Unable to create starvation detector for ${args.trackName}`);
-	return detector;
+	if (!detector || typeof args.session.state !== "string") return detector;
+
+	// Stats flow while TrackSession is still `joining`. Feeding them directly can
+	// age a starvation episode past its window before the first multicast RAP,
+	// causing the first post-cutover sample to flip a healthy session to
+	// `failing`. Start with a fresh baseline only once multicast/AMT is primary;
+	// retain the detector through `failing` so it can observe recovery.
+	let active = false;
+	return {
+		update(snapshot) {
+			const state = args.session!.state;
+			const shouldObserve = state === "multicast" || state === "amt" || state === "failing";
+			if (!shouldObserve) {
+				if (active) detector.reset();
+				active = false;
+				return;
+			}
+			if (!active) {
+				detector.reset();
+				active = true;
+			}
+			detector.update(snapshot);
+		},
+		reset() {
+			active = false;
+			detector.reset();
+		},
+	};
 }

package/src/transport-manager.ts

@@ -22,6 +22,7 @@
 
 import type {
 	TransportConfig,
+	TransportConnectConfig,
 	TransportSubscription,
 	TransportCapabilities,
 	TransportState,
@@ -47,9 +48,6 @@ import { normalizeMulticastEndpoint } from "./endpoint-config.js";
  *
  * Manages transport connections with automatic mode selection:
  * WebTransport -> window.multicast -> AMT proxy -> WebSocket
- *
- * Renamed from SSMTransportManager - the old name is preserved
- * as a deprecated alias for backwards compatibility.
  */
 export class TransportManager {
 	private state: TransportState = {
@@ -63,7 +61,8 @@ export class TransportManager {
 	private capabilities: TransportCapabilities | null = null;
 	private subscription: TransportSubscription | null = null;
 	private driad = new DRIADDiscovery();
-	private abr: AdaptiveBitrateController;
+	/** Built by `connect()` from the caller's ladder; there is no built-in one. */
+	private abr: AdaptiveBitrateController | null = null;
 	private multicastOrchestrator: MulticastOrchestrator | null = null;
 	private onOrchestratorCommand?: (command: OrchestratorCommand) => void;
 	private connectionGeneration = 0;
@@ -72,10 +71,6 @@ export class TransportManager {
 	private onError?: (error: Error) => void;
 	private onStateChange?: (state: TransportState) => void;
 
-	constructor() {
-		this.abr = new AdaptiveBitrateController();
-	}
-
 	private getWindow(): Window | undefined {
 		return typeof window === "undefined" ? undefined : window;
 	}
@@ -138,11 +133,38 @@ export class TransportManager {
 	 * 1. window.multicast gateway bytes
 	 * 2. AMT proxy (specified or discovered via DRIAD)
 	 * 3. MOQ WebTransport (final fallback)
+	 *
+	 * The ABR ladder (`abrLadder`) and initial rendition (`initialQuality`)
+	 * are checked first, before anything is torn down. A config that fails is
+	 * refused with the same shape as an invalid endpoint, the error to the
+	 * error callback and `false` resolved; unlike one, it is caught before the
+	 * live subscription closes, so a refused reconnect leaves that subscription,
+	 * its state and any connect already in flight untouched.
 	 */
-	async connect(config: TransportConfig): Promise<boolean> {
+	async connect(config: TransportConnectConfig): Promise<boolean> {
+		let abr: AdaptiveBitrateController;
+		try {
+			abr = new AdaptiveBitrateController({
+				ladder: config.abrLadder,
+				initialQuality: config.initialQuality?.name,
+			});
+		} catch (error) {
+			// A refused config is a caller bug. Without an error callback, say so
+			// on the console, since `false` alone also means "no multicast path";
+			// with one, the callback is the report.
+			const refused = error instanceof Error ? error : new Error(String(error));
+			if (this.onError) this.onError(refused);
+			else console.error("[Transport] ABR config refused, not connecting:", refused);
+			return false;
+		}
 		const generation = ++this.connectionGeneration;
 		this.subscription?.close();
 		this.subscription = null;
+		// The previous connection's ladder ends with it, as in disconnect(): a
+		// reconnect that bails below (invalid endpoint, or superseded while
+		// detecting capabilities) leaves no ladder, and only the success path
+		// installs `abr`.
+		this.abr = null;
 		this.state = {
 			mode: "disconnected",
 			connected: false,
@@ -175,12 +197,11 @@ export class TransportManager {
 		const caps = await this.detectCapabilities();
 		if (generation !== this.connectionGeneration) return false;
 
-		// Initialize ABR with requested quality
-		if (config.initialQuality) {
-			this.abr = new AdaptiveBitrateController(config.initialQuality);
-		}
+		// ABR adapts over the caller's ladder (the catalog's renditions),
+		// validated above before anything was torn down.
+		this.abr = abr;
 
-		this.abr.setCallback((quality) => {
+		abr.setCallback((quality) => {
 			this.state.quality = quality;
 			this.subscription?.onqualitychange?.(quality);
 			this.onStateChange?.(this.state);
@@ -255,7 +276,7 @@ export class TransportManager {
 				connected: true,
 				group: config.group,
 				source: config.source,
-				quality: this.abr.getCurrentQuality(),
+				quality: this.requireAbr().getCurrentQuality(),
 				packetsReceived: 0,
 				bytesReceived: 0,
 				lastPacketTime: 0,
@@ -311,8 +332,8 @@ export class TransportManager {
 	private async connectAmtProxy(config: TransportConfig, amtRelay: string, generation: number): Promise<boolean> {
 		try {
 			const relayHost = amtRelay.includes(":") && !amtRelay.startsWith("[") ? `[${amtRelay}]` : amtRelay;
-			const relayAuthority = config.amtRelayPort ? `${relayHost}:${config.amtRelayPort}` : relayHost;
-			const wsUrl = new URL(`wss://${relayAuthority}/amt-proxy`);
+			// amtRelayPort is the relay's RFC 7450 UDP port, not the proxy's HTTPS port.
+			const wsUrl = new URL(`wss://${relayHost}/amt-proxy`);
 			wsUrl.searchParams.set("group", config.group);
 			wsUrl.searchParams.set("source", config.source || "");
 			wsUrl.searchParams.set("port", String(config.port));
@@ -347,7 +368,7 @@ export class TransportManager {
 						group: config.group,
 						source: config.source,
 						amtRelay,
-						quality: this.abr.getCurrentQuality(),
+						quality: this.requireAbr().getCurrentQuality(),
 						packetsReceived: 0,
 						bytesReceived: 0,
 						lastPacketTime: 0,
@@ -399,7 +420,8 @@ export class TransportManager {
 		this.state.lastPacketTime = Date.now();
 
 		// Update ABR with sample
-		this.abr.recordSample(data.byteLength, 0);
+		// Packets reach here only through a connect()ed join, which built the ABR.
+		this.abr?.recordSample(data.byteLength, 0);
 
 		// Forward to callback
 		this.onPacket?.(data);
@@ -413,17 +435,28 @@ export class TransportManager {
 	}
 
 	/**
-	 * Get current quality level
+	 * The rung of the live connection's `abrLadder` ABR is on; `null` when
+	 * there is no ladder (before `connect(config)` succeeds, after
+	 * `disconnect()`, or after a reconnect that was torn down and bailed).
 	 */
-	getQuality(): QualityLevel {
-		return this.abr.getCurrentQuality();
+	getQuality(): QualityLevel | null {
+		return this.abr?.getCurrentQuality() ?? null;
 	}
 
 	/**
-	 * Force quality level
+	 * Force the rung named `name` of the live connection's `abrLadder`.
+	 * Throws `Error` when there is no ladder (see `getQuality()`), and
+	 * `RangeError` when the ladder has no rung of that name; it never falls
+	 * back to another rung.
 	 */
 	setQuality(name: string) {
-		this.abr.setQuality(name);
+		this.requireAbr().setQuality(name);
+	}
+
+	/** The controller `connect()` built; before it there is no ladder to adapt over. */
+	private requireAbr(): AdaptiveBitrateController {
+		if (!this.abr) throw new Error("[Transport] ABR has no ladder before connect(config)");
+		return this.abr;
 	}
 
 	/** Configures multicast-only ABR while leaving the caller's MoQ ABR untouched. */
@@ -441,6 +474,10 @@ export class TransportManager {
 		return this.dispatchOrchestratorCommand(this.multicastOrchestrator?.onGoodput({ bitrate }));
 	}
 
+	recordMulticastHeadroom(healthy: boolean): OrchestratorCommand | undefined {
+		return this.dispatchOrchestratorCommand(this.multicastOrchestrator?.onHeadroom({ healthy }));
+	}
+
 	recordMulticastTierPacket(packet: MulticastTierPacket): OrchestratorCommand | undefined {
 		return this.dispatchOrchestratorCommand(this.multicastOrchestrator?.onTierPacket(packet));
 	}
@@ -477,6 +514,9 @@ export class TransportManager {
 		this.connectionGeneration++;
 		this.subscription?.close();
 		this.subscription = null;
+		// No ladder after a disconnect, as before the first connect():
+		// getQuality() is null and setQuality() throws until connect(config).
+		this.abr = null;
 		this.dispatchOrchestratorCommand(this.multicastOrchestrator?.cancel());
 		this.multicastOrchestrator = null;
 		this.onOrchestratorCommand = undefined;
@@ -498,13 +538,3 @@ export class TransportManager {
 
 // Export singleton instance
 export const transportManager = new TransportManager();
-
-/**
- * @deprecated Use `TransportManager` instead. This alias is preserved for backwards compatibility.
- */
-export const SSMTransportManager = TransportManager;
-
-/**
- * @deprecated Use `transportManager` instead. This alias is preserved for backwards compatibility.
- */
-export const ssmTransport = transportManager;

package/src/types.ts

@@ -4,29 +4,85 @@
  * Shared interfaces for unified transport (WebTransport, SSM, AMT, DRIAD) and FEC.
  */
 
-/** window.multicast gateway config for byte subscriptions. */
-export interface WindowMulticastSubscribeConfig {
+/** Native IP-multicast request for the window.multicast gateway. */
+export interface WindowMulticastSubscribeConfigBytes {
 	group: string;
 	port: number;
 	source?: string;
 	consume: "bytes";
-	mode?: "auto" | "native" | "tunnel";
-	amtRelay?: string;
-	amtRelayPort?: number;
+	origin?: "ip-multicast";
+	/** MMTP packet IDs to forward before data enters the page transport queue. */
+	packetIds?: readonly number[];
+	/** Catalog track identities corresponding to the selected packet IDs. */
+	tracks?: ReadonlyArray<{ name: string; packetId: number }>;
+}
+
+/** AMT relay request for the window.multicast gateway. */
+export interface WindowMulticastSubscribeConfigAmt {
+	group: string;
+	port: number;
+	source?: string;
+	consume: "bytes";
+	origin: "amt";
+	relay: string;
+	relayPort: number;
+	/** MMTP packet IDs to forward before data enters the page transport queue. */
+	packetIds?: readonly number[];
 }
 
+/** Canonical window.multicast config for byte subscriptions. */
+export type WindowMulticastSubscribeConfig =
+	| WindowMulticastSubscribeConfigBytes
+	| WindowMulticastSubscribeConfigAmt;
+
 export type WindowMulticastSubscriptionState = "connecting" | "connected" | "reconnecting" | "closed";
 
 export interface WindowMulticastSubscriptionEventMap {
 	bytes: CustomEvent<ArrayBuffer>;
+	/**
+	 * Provider extension, not part of the frozen v1 contract (BLO-36599): every
+	 * packet the provider decoded in one dispatch batch, in arrival order. Each
+	 * element is exactly what one `bytes` event would have carried. Emitted
+	 * only by a subscription whose `eventTypes` lists `"packets"`; see
+	 * {@link subscriptionDeliversPacketBatches}. A consumer listens to exactly
+	 * one of `bytes` and `packets`, because both carry the same packets.
+	 */
+	packets: CustomEvent<readonly ArrayBuffer[]>;
 	state: CustomEvent<WindowMulticastSubscriptionState>;
 	error: CustomEvent<unknown>;
 }
 
+/**
+ * How a window.multicast subscription hands packets to the page.
+ *
+ * - `"datagram"`: packets are independent datagrams; a pause in arrivals may
+ *   mean loss.
+ * - `"ordered-relay"`: the provider relays one receiving socket over a
+ *   reliable, ordered stream (for example a BCDS bridge WebTransport uni
+ *   stream). The relay may drop packets (a bounded queue discarding its
+ *   oldest on overflow) but never reorders them: what arrives is a
+ *   subsequence of the socket's receive order, so a pause in arrivals
+ *   carries no loss information.
+ *
+ * A provider declares `"ordered-relay"` only when every packet of the
+ * subscription travels that one ordered stream for the life of the
+ * subscription. Absent means no ordering promise, which consumers treat as
+ * `"datagram"`.
+ */
+export type WindowMulticastDelivery = "datagram" | "ordered-relay";
+
 /** window.multicast subscription returned by the IWA gateway surface. */
 export interface WindowMulticastSubscription {
 	readonly id?: string;
 	readonly state?: WindowMulticastSubscriptionState;
+	/** How this subscription delivers packets; see WindowMulticastDelivery. */
+	readonly delivery?: WindowMulticastDelivery;
+	/**
+	 * Events this subscription emits, when the provider advertises them. A
+	 * provider without the field emits the v1 events only (`bytes`, `state`,
+	 * `error`).
+	 */
+	readonly eventTypes?: readonly string[];
 	addEventListener<K extends keyof WindowMulticastSubscriptionEventMap>(
 		type: K,
 		listener: (ev: WindowMulticastSubscriptionEventMap[K]) => void,
@@ -75,19 +131,39 @@ export interface TransportConfig {
 	mode?: "auto" | "native" | "tunnel";
 	/** DRIAD discovery enabled */
 	driadEnabled?: boolean;
-	/** Initial bitrate quality level */
-	initialQuality?: QualityLevel;
 }
 
-/** @deprecated Use TransportConfig instead */
-export type SSMConfig = TransportConfig;
+/** What `TransportManager.connect()` needs beyond the subscription itself. */
+export interface TransportConnectConfig extends TransportConfig {
+	/**
+	 * The stream's renditions the ABR controller adapts over, e.g. its catalog
+	 * video tracks. Required: there is no built-in ladder. `connect()` checks
+	 * it (`validateQualityLadder`) and `initialQuality` before tearing anything
+	 * down; a config that fails is refused through the error callback and
+	 * `connect()` resolves `false`, leaving a live subscription untouched.
+	 * `catalogQualityLadder(catalog)` builds it from a catalog.
+	 */
+	abrLadder: readonly QualityLevel[];
+	/**
+	 * Ladder rendition to start on, matched by `name` against `abrLadder`; the
+	 * lowest-bitrate rung when omitted. A name `abrLadder` does not carry is
+	 * not a fallback to that rung: `TransportManager.connect()` refuses the
+	 * config (error callback, resolves `false`) before tearing anything down.
+	 */
+	initialQuality?: QualityLevel;
+}
 
 export interface QualityLevel {
 	name: string;
+	/** Bits per second: what the ABR controller ranks and costs a rendition by. */
 	bitrate: number;
-	width: number;
-	height: number;
-	fps: number;
+	/**
+	 * Dimensions and frame rate as the stream's catalog states them; absent
+	 * when it does not. ABR never reads them, so none is defaulted.
+	 */
+	width?: number;
+	height?: number;
+	fps?: number;
 }
 
 export interface TransportCapabilities {
@@ -123,9 +199,6 @@ export interface TransportSubscription {
 	close: () => void;
 }
 
-/** @deprecated Use TransportSubscription instead */
-export type SSMSubscription = TransportSubscription;
-
 /** DRIAD Relay information (RFC 8777) */
 export interface DRIADRelay {
 	host: string;
@@ -159,67 +232,6 @@ export interface PacketMetadata {
 	timestamp: number;
 }
 
-/** MFU Fragment for reassembly */
-export interface MfuFragment {
-	mpuSequenceNumber: number;
-	fragmentationIndicator: number; // 0=complete, 1=first, 2=middle, 3=last
-	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 {
-	// MFU stats
-	mfuComplete: number;
-	mfuReassembled: number;
-	mfuTimedOut: number;
-
-	// FEC stats
-	fecSourcePackets: number;
-	fecRepairPackets: number;
-	fecBlocksComplete: number;
-	fecBlocksRecovered: number;
-	fecBlocksFailed: number;
-	fecRecoveryRate: number;
-
-	// Green-fill stats
-	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 };
 
@@ -279,38 +291,11 @@ export interface MulticastSubscriptionHandle {
 	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>;
+	subscribe(config: MulticastConfig): Promise<MulticastSubscriptionHandle>;
 	getSubscriptions(): Promise<MulticastSubscriptionHandle[]>;
 	isNativeSupported(): Promise<boolean>;
-	getFecStats?(): FecStats | null;
 }
 
 // ============================================================
@@ -318,22 +303,17 @@ export interface MulticastBridge {
 // ============================================================
 
 /**
- * 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
+ * Build a conventional repair track path by appending "repair" to a source
+ * track path.
  *
- * Per draft-ramadan-moq-fec-00 Section 5.1, the repair track is named
- * by appending "repair" to the source track path.
+ * Track names carry no protocol meaning. A repair track's layer, its source
+ * and its symbol budget are resolved from the catalog via `resolveRepairLayers`
+ * in `@blockcast/mmt-container`, never from a name or a name suffix. This
+ * helper is a naming convenience for producers only.
+ *
+ * @deprecated Naming convenience only. Never classify a track or resolve a
+ * repair layer from its path; use `resolveRepairLayers` from
+ * `@blockcast/mmt-container`.
  *
  * @param sourceTrack - The source track path (e.g., "live/video")
  * @returns The repair track path (e.g., "live/video/repair")
@@ -344,53 +324,16 @@ export const REPAIR_TRACK_SUFFIX = "repair";
  */
 export function repairTrackPath(sourceTrack: string): string {
 	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: string): boolean {
-	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: string): string | null {
-	if (repairTrack === REPAIR_TRACK_SUFFIX) {
-		return "";
-	}
-	const suffix = `/${REPAIR_TRACK_SUFFIX}`;
-	if (repairTrack.endsWith(suffix)) {
-		return repairTrack.slice(0, -suffix.length);
+		return "repair";
 	}
-	return null;
+	return `${sourceTrack}/repair`;
 }
 
 /**
  * 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.
+ * These parameters are signalled in each track's catalog `fec` block;
+ * no FEC_CONFIG control message is sent or parsed.
  */
 export interface MoqFecConfig {
 	/** Subscribe ID this config applies to */

package/dist/endpoint-config.test.d.ts

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

package/dist/endpoint-config.test.d.ts.map

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

package/dist/endpoint-config.test.js

@@ -1,39 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { isMulticastExplicitlyDisabled, multicastEndpointKey, normalizeMulticastEndpoint, readUrlMulticastConfig, } from "./endpoint-config.js";
-describe("multicast endpoint config", () => {
-    it("normalizes endpoint identity", () => {
-        const endpoint = normalizeMulticastEndpoint({
-            groupAddress: " 232.99.0.10 ",
-            sourceAddress: " 69.25.95.101 ",
-            port: 5050,
-        });
-        expect(endpoint).toEqual({
-            groupAddress: "232.99.0.10",
-            sourceAddress: "69.25.95.101",
-            port: 5050,
-        });
-        expect(multicastEndpointKey(endpoint)).toBe('["69.25.95.101","232.99.0.10",5050,"auto","",""]');
-    });
-    it("does not alias endpoint fields containing key delimiters", () => {
-        const base = { groupAddress: "232.99.0.10", port: 5050, mode: "tunnel" };
-        expect(multicastEndpointKey({ ...base, amtRelay: "relay|2268" })).not.toBe(multicastEndpointKey({ ...base, amtRelay: "relay", amtRelayPort: 2268 }));
-    });
-    it("rejects invalid groups and ports", () => {
-        expect(normalizeMulticastEndpoint({ groupAddress: "127.0.0.1", port: 5050 })).toBeUndefined();
-        expect(normalizeMulticastEndpoint({ groupAddress: "232.1.1.1", port: 0 })).toBeUndefined();
-    });
-    it("preserves explicit AMT URL configuration", () => {
-        expect(readUrlMulticastConfig("?mc_group=232.99.0.10&mc_source=69.25.95.101&mc_port=5050&mc_amt_relay=relay.example&mc_amt_relay_port=2268")).toEqual({
-            groupAddress: "232.99.0.10",
-            sourceAddress: "69.25.95.101",
-            port: 5050,
-            mode: "tunnel",
-            amtRelay: "relay.example",
-            amtRelayPort: 2268,
-        });
-    });
-    it("recognizes explicit MoQ-only selection", () => {
-        expect(isMulticastExplicitlyDisabled("?transport=moq-only")).toBe(true);
-    });
-});
-//# sourceMappingURL=endpoint-config.test.js.map

package/dist/endpoint-config.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"endpoint-config.test.js","sourceRoot":"","sources":["../src/endpoint-config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACN,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACvC,MAAM,QAAQ,GAAG,0BAA0B,CAAC;YAC3C,YAAY,EAAE,eAAe;YAC7B,aAAa,EAAE,gBAAgB;YAC/B,IAAI,EAAE,IAAI;SACV,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACxB,YAAY,EAAE,aAAa;YAC3B,aAAa,EAAE,cAAc;YAC7B,IAAI,EAAE,IAAI;SACV,CAAC,CAAC;QACH,MAAM,CAAC,oBAAoB,CAAC,QAAS,CAAC,CAAC,CAAC,IAAI,CAC3C,kDAAkD,CAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QACnE,MAAM,IAAI,GAAG,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAiB,EAAE,CAAC;QAClF,MAAM,CAAC,oBAAoB,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CACzE,oBAAoB,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CACxE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,0BAA0B,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAC9F,MAAM,CAAC,0BAA0B,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,sBAAsB,CAC5B,6GAA6G,CAC7G,CAAC,CAAC,OAAO,CAAC;YACV,YAAY,EAAE,aAAa;YAC3B,aAAa,EAAE,cAAc;YAC7B,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,eAAe;YACzB,YAAY,EAAE,IAAI;SAClB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,6BAA6B,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}