@camstack/ui-library 1.2.200 → 1.2.202

package/dist/index.cjs

@@ -7046,6 +7046,8 @@ var useDeviceManagerGetBindings = trpc.deviceManager.getBindings.useQuery;
 var useDeviceManagerGetBindingsBatch = trpc.deviceManager.getBindingsBatch.useQuery;
 /** Generated alias around `trpc.deviceManager.getAllBindings.useQuery`. */
 var useDeviceManagerGetAllBindings = trpc.deviceManager.getAllBindings.useQuery;
+/** Generated alias around `trpc.deviceManager.listDeviceIdsByCaps.useQuery`. */
+var useDeviceManagerListDeviceIdsByCaps = trpc.deviceManager.listDeviceIdsByCaps.useQuery;
 /** Generated alias around `trpc.deviceManager.setWrapperActive.useMutation`. */
 var useDeviceManagerSetWrapperActive = trpc.deviceManager.setWrapperActive.useMutation;
 /** Generated alias around `trpc.deviceManager.listWrappersForCap.useQuery`. */
@@ -29544,9 +29546,26 @@ function nextReconnectAction(attempt, random = Math.random) {
 * Used as `hints.downlinkMbps` so adaptive selection is based on a measured
 * path, not viewport size or IP class. Failures return null (caller keeps
 * the default-low / ceiling path and may stay on the lowest rung).
+*
+* D635 (2026-09-25): the probe used to time a 128 KiB blob from the REQUEST,
+* fired in parallel with `createSession` on a hub at ~80 % CPU. It read the
+* LAN as 1.2–1.46 Mbps — the elapsed time was mostly waiting for the first
+* byte, i.e. latency. It now (1) times the body from its FIRST byte, (2) reads
+* a 1 MiB blob so the transfer dominates timer jitter, and (3) runs after the
+* session's first decoded frame, never during session setup.
 */
 var ADAPTIVE_PROBE_PATH = "/adaptive-probe";
+/**
+* Whole-probe deadline, from the request. A probe cut here is still a
+* measurement of whatever body arrived (see {@link measureDownlinkMbps}).
+*/
 var ADAPTIVE_PROBE_TIMEOUT_MS = 2500;
+/** How long the probe waits for the session's first decoded frame. */
+var FIRST_FRAME_PROBE_TIMEOUT_MS = 15e3;
+/** How often the first-frame wait looks at the video element. */
+var FIRST_FRAME_POLL_MS = 250;
+/** `HTMLMediaElement.HAVE_CURRENT_DATA`: a frame is decoded and presentable. */
+var HAVE_CURRENT_DATA = 2;
 /** Map a measured downlink onto the adaptive ladder. Mid is a real rung. */
 function suggestedAdaptiveTier(mbps) {
 	if (mbps >= 8) return "high";
@@ -29620,27 +29639,153 @@ function adaptiveHintsKey(report) {
 		report.devicePixelRatio ?? "-",
 		rung,
 		report.prefersTier ?? "-",
-		report.probeOrigin ?? "unreachable"
+		report.probeOrigin ?? "unreachable",
+		report.probeStatus ?? "-"
 	].join("|");
 }
+function mbpsOf(bytes, elapsedMs) {
+	if (bytes < 65536 || !(elapsedMs > 0)) return null;
+	return bytes * 8 / elapsedMs / 1e3;
+}
+/**
+* Stream the body and time it from the FIRST chunk to the last one. The first
+* chunk's own bytes are excluded — they arrived at the instant the clock
+* started. A read that fails (the deadline abort) ends the measurement with
+* what DID arrive: a slow link cut at 2.5 s is still a measured slow link.
+*/
+async function timeStreamedBody(reader, now) {
+	let firstAt = null;
+	let lastAt = 0;
+	let bytes = 0;
+	try {
+		for (;;) {
+			const chunk = await reader.read();
+			if (chunk.done) break;
+			const size = chunk.value?.byteLength ?? 0;
+			const at = now();
+			if (firstAt === null) firstAt = at;
+			else bytes += size;
+			lastAt = at;
+		}
+	} catch {
+		reader.cancel().catch(() => void 0);
+	}
+	if (firstAt === null) return null;
+	return mbpsOf(bytes, lastAt - firstAt);
+}
 async function measureDownlinkMbps(origin, deps) {
 	const base = origin.replace(/\/+$/, "");
 	const ctrl = new AbortController();
 	const timer = setTimeout(() => ctrl.abort(), ADAPTIVE_PROBE_TIMEOUT_MS);
-	const started = deps.now();
 	try {
 		const res = await deps.fetchImpl(`${base}${ADAPTIVE_PROBE_PATH}`, { signal: ctrl.signal });
-		if (!res.ok) return null;
-		const buf = await res.arrayBuffer();
-		const elapsedMs = Math.max(1, deps.now() - started);
-		if (buf.byteLength < 1024) return null;
-		return buf.byteLength * 8 / elapsedMs / 1e3;
+		if (!res.ok) {
+			if (res.status !== void 0) deps.onRefused?.(res.status);
+			return null;
+		}
+		const reader = res.body?.getReader() ?? null;
+		if (reader !== null) return await timeStreamedBody(reader, deps.now);
+		const headersAt = deps.now();
+		return mbpsOf((await res.arrayBuffer()).byteLength, deps.now() - headersAt);
 	} catch {
 		return null;
 	} finally {
 		clearTimeout(timer);
 	}
 }
+/**
+* Resolve once the session presents its first decoded frame — the moment
+* session setup (createSession, ICE, DTLS, the first IDR) is over and a probe
+* no longer competes with it for the hub or the link.
+*/
+async function waitForFirstFrame(deps, timeoutMs = FIRST_FRAME_PROBE_TIMEOUT_MS) {
+	const deadline = deps.now() + timeoutMs;
+	for (;;) {
+		if (deps.signal.aborted) return "aborted";
+		if ((deps.readyState() ?? 0) >= HAVE_CURRENT_DATA) return "frame";
+		if (deps.now() >= deadline) return "timeout";
+		await deps.sleep(FIRST_FRAME_POLL_MS);
+	}
+}
+async function probeAfterFirstFrame(deps) {
+	if (await deps.waitFrame() !== "frame") return void 0;
+	return deps.measure();
+}
+/** App-wide probe cache + single-flight, one per origin. */
+function createDownlinkProbe(deps) {
+	const readings = /* @__PURE__ */ new Map();
+	const inFlight = /* @__PURE__ */ new Map();
+	const refusals = /* @__PURE__ */ new Set();
+	const cached = (origin) => {
+		const r = readings.get(origin);
+		return r !== void 0 && deps.now() - r.at <= deps.ttlMs ? r.mbps : void 0;
+	};
+	return {
+		cached,
+		firstRefusal: (origin, status) => {
+			const key = `${origin}|${String(status)}`;
+			if (refusals.has(key)) return false;
+			refusals.add(key);
+			return true;
+		},
+		latest: (origin) => {
+			const r = readings.get(origin);
+			return r === void 0 ? null : {
+				mbps: r.mbps,
+				ageMs: Math.max(0, deps.now() - r.at)
+			};
+		},
+		measured: (origin, measure) => {
+			const hit = cached(origin);
+			if (hit !== void 0) return Promise.resolve(hit);
+			const running = inFlight.get(origin);
+			if (running !== void 0) return running;
+			const probe = measure().then((mbps) => {
+				if (mbps === null || !Number.isFinite(mbps)) return void 0;
+				readings.set(origin, {
+					mbps,
+					at: deps.now()
+				});
+				return mbps;
+			}).catch(() => void 0).finally(() => {
+				inFlight.delete(origin);
+			});
+			inFlight.set(origin, probe);
+			return probe;
+		}
+	};
+}
+//#endregion
+//#region src/composites/client-network-sample.ts
+/** Schema bound of `estimatedBandwidthKbps` / `packetLossPercent`. */
+var MAX_LOSS_PERCENT = 100;
+function nextClientSample(prev, cur, ctx) {
+	if (ctx.renegotiating) return {
+		baseline: null,
+		sample: null
+	};
+	if (prev === null || prev.pc !== cur.pc || cur.ts <= prev.ts) return {
+		baseline: cur,
+		sample: null
+	};
+	const dLost = Math.max(0, cur.lost - prev.lost);
+	const denom = dLost + Math.max(0, cur.recv - prev.recv);
+	const packetLossPercent = denom > 0 ? Math.min(MAX_LOSS_PERCENT, dLost / denom * 100) : 0;
+	const estimatedBandwidthKbps = Math.max(0, Math.round((cur.bytes - prev.bytes) * 8 / (cur.ts - prev.ts)));
+	return {
+		baseline: cur,
+		sample: {
+			rttMs: Math.round(cur.rttS * 1e3),
+			jitterMs: Math.round(cur.jitterS * 1e3),
+			estimatedBandwidthKbps,
+			packetLossPercent,
+			...ctx.probe !== null ? {
+				downlinkMbps: ctx.probe.mbps,
+				downlinkAgeMs: ctx.probe.ageMs
+			} : {}
+		}
+	};
+}
 //#endregion
 //#region src/composites/stream-debug/webrtc-debug-stats.ts
 /** Beyond this the log is a scroll, not a signal. */
@@ -30184,11 +30329,11 @@ function StreamDebugOverlay(props) {
 				}),
 				server.lastDecision === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Row, {
 					label: "ladder",
-					value: "never moved"
+					value: server.climbHold ? "held" : "never moved"
 				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Row, {
 						label: "ladder move",
-						value: `${server.lastDecision.cause}${server.lastDecision.tier !== null ? ` → ${server.lastDecision.tier}` : ""}`,
+						value: `${server.lastDecision.causeDetail ?? server.lastDecision.cause}${server.lastDecision.tier !== null ? ` → ${server.lastDecision.tier}` : ""}`,
 						strong: true
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Row, {
@@ -30216,6 +30361,10 @@ function StreamDebugOverlay(props) {
 						value: b(server.lastDecision.forcedTranscodeDown)
 					})
 				] }),
+				server.climbHold ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Row, {
+					label: "climb",
+					value: server.climbHold.summary
+				}) : null,
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Row, {
 					label: "promotions",
 					value: n(server.upgradeCount)
@@ -30294,8 +30443,15 @@ function computeClientHints(container) {
 	}
 	return hints;
 }
-var downlinkCache = null;
-var DOWNLINK_TTL_MS = 3e4;
+/**
+* ONE probe store for the whole app: every player of every camera shares the
+* cache and the probe in flight (review I6 — a grid decoding together fired
+* N concurrent 1 MiB probes, each reading the link ÷ N).
+*/
+var downlinkProbe = createDownlinkProbe({
+	now: () => Date.now(),
+	ttlMs: 3e4
+});
 /**
 * Measure the downlink against the HUB, not the page. `serverUrl` is the hub
 * this player is already signalling to; the page origin is only a fallback,
@@ -30306,21 +30462,44 @@ var DOWNLINK_TTL_MS = 3e4;
 function probeOriginFor(serverUrl) {
 	return resolveProbeOrigin(serverUrl, typeof window !== "undefined" ? hubOrigin() : void 0);
 }
-async function measuredDownlinkMbps(serverUrl) {
+function measuredDownlinkMbps(serverUrl, authToken, onRefused) {
 	const origin = probeOriginFor(serverUrl);
-	if (origin === null) return void 0;
-	if (downlinkCache && downlinkCache.origin === origin && Date.now() - downlinkCache.at < DOWNLINK_TTL_MS) return downlinkCache.mbps;
-	const mbps = await measureDownlinkMbps(origin, {
-		fetchImpl: (url, init) => fetch(url, init),
+	if (origin === null) return Promise.resolve(void 0);
+	return downlinkProbe.measured(origin, () => measureDownlinkMbps(origin, {
+		onRefused: (status) => {
+			if (downlinkProbe.firstRefusal(origin, status)) onRefused(origin, status);
+		},
+		fetchImpl: (url, init) => fetch(url, {
+			...init,
+			...authToken !== null ? { headers: { authorization: `Bearer ${authToken}` } } : {}
+		}),
 		now: () => Date.now()
+	}));
+}
+/** The cached probe only — never measures (review I5: a renegotiation must not
+*  push 1 MiB into the link that just stalled, nor wait 2.5 s for it). */
+function cachedDownlinkMbps(serverUrl) {
+	const origin = probeOriginFor(serverUrl);
+	return origin === null ? void 0 : downlinkProbe.cached(origin);
+}
+/** The newest probe whatever it read — carried in the telemetry (review I4). */
+function latestProbeReading(serverUrl) {
+	const origin = probeOriginFor(serverUrl);
+	return origin === null ? null : downlinkProbe.latest(origin);
+}
+function probeAfterThisStreamsFirstFrame(args) {
+	return probeAfterFirstFrame({
+		waitFrame: () => waitForFirstFrame({
+			readyState: () => {
+				const v = args.video();
+				return v !== null && v.srcObject === args.stream ? v.readyState : null;
+			},
+			signal: args.signal,
+			sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+			now: () => Date.now()
+		}),
+		measure: () => measuredDownlinkMbps(args.serverUrl, args.authToken, args.onRefused)
 	});
-	if (mbps === null || !Number.isFinite(mbps)) return void 0;
-	downlinkCache = {
-		origin,
-		mbps,
-		at: Date.now()
-	};
-	return mbps;
 }
 function mergePlayerHints(autoHints, override, downlinkMbps, coldStart) {
 	const merged = {
@@ -30331,7 +30510,7 @@ function mergePlayerHints(autoHints, override, downlinkMbps, coldStart) {
 	return coldStart ? stripDownlinkForColdStart(merged) : merged;
 }
 var FIRST_FRAME_TIMEOUT_MS = 8e3;
-function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, muted: initialMuted = true, showControls = true, showStats = false, onDebugStats, onPlaybackStats, onClientNetworkSample, onConnectTiming, className = "", onStateChange, onError, onReconnectAttempt, overlay, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, getSessionDebug, reoffer, posterUrl, hintsOverride, onAdaptiveHints, reconnectSignal, onControlChannel, onVideoElement }) {
+function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, muted: initialMuted = true, showControls = true, showStats = false, onDebugStats, onPlaybackStats, onClientNetworkSample, probeAuthToken, onConnectTiming, className = "", onStateChange, onError, onReconnectAttempt, overlay, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, getSessionDebug, reoffer, posterUrl, hintsOverride, onAdaptiveHints, reconnectSignal, onControlChannel, onVideoElement }) {
 	const videoRef = (0, react$1.useRef)(null);
 	const containerRef = (0, react$1.useRef)(null);
 	const pcRef = (0, react$1.useRef)(null);
@@ -30379,6 +30558,19 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 		lastAdaptiveKeyRef.current = key;
 		cb(report);
 	}, []);
+	/**
+	* A refused probe (401 without a session, 429) goes out on the SAME channel
+	* as the adaptive decisions — hosts already forward it over their log bridge
+	* — once per origin app-wide (`firstRefusal`), so a missing `probeAuthToken`
+	* is visible instead of reading like a failed probe (review N3).
+	*/
+	const reportProbeRefused = (0, react$1.useCallback)((origin, status) => {
+		onAdaptiveHintsRef.current?.({
+			phase: "probe-refused",
+			probeOrigin: origin,
+			probeStatus: status
+		});
+	}, []);
 	/** The live session being polled for `pendingRenegotiation` (client-offer). */
 	const activeSessionIdRef = (0, react$1.useRef)(null);
 	/** Timer for the session-state (renegotiation) poll loop. */
@@ -30501,7 +30693,7 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 			tick();
 		}, SESSION_STATE_POLL_MS);
 	}, [getSessionState, reoffer]);
-	const connectServerOffer = (0, react$1.useCallback)(async (seamless = false, withDownlink = seamless) => {
+	const connectServerOffer = (0, react$1.useCallback)(async (seamless = false, withDownlink = seamless, knownDownlinkMbps) => {
 		if (!mountedRef.current || !createSession || !sendAnswer) return;
 		const oldPc = seamless ? pcRef.current : null;
 		const oldSessions = seamless ? new Set(sessionIdsRef.current) : null;
@@ -30511,18 +30703,10 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 		const abort = new AbortController();
 		connectAbortRef.current = abort;
 		try {
-			const probePromise = !withDownlink ? measuredDownlinkMbps(serverUrl) : void 0;
-			const mergedHints = mergePlayerHints(computeClientHints(containerRef.current), hintsOverride, withDownlink ? await measuredDownlinkMbps(serverUrl) : void 0, !withDownlink);
+			const mergedHints = mergePlayerHints(computeClientHints(containerRef.current), hintsOverride, withDownlink ? knownDownlinkMbps ?? await measuredDownlinkMbps(serverUrl, probeAuthToken ?? null, reportProbeRefused) : void 0, !withDownlink);
 			reportAdaptiveHints(withDownlink ? "probe-climb" : "cold-start", mergedHints, probeOriginFor(serverUrl));
 			const { sessionId, sdpOffer, iceServers } = await createSession(mergedHints);
 			sessionIdsRef.current.add(sessionId);
-			if (probePromise !== void 0) probePromise.then((mbps) => {
-				if (mbps === void 0 || !shouldUpgradeAfterProbe(mbps)) return;
-				if (!mountedRef.current || abort.signal.aborted) return;
-				if (probeUpgradeRef.current) return;
-				probeUpgradeRef.current = true;
-				connectServerOffer(true, true);
-			});
 			if (!mountedRef.current || abort.signal.aborted) {
 				closeSession?.(sessionId).catch(() => {});
 				sessionIdsRef.current.delete(sessionId);
@@ -30531,6 +30715,20 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 			const pc = new RTCPeerConnection({ iceServers: [...iceServers ?? [], { urls: "stun:stun.l.google.com:19302" }] });
 			if (!seamless) pcRef.current = pc;
 			const combinedStream = new MediaStream();
+			if (!withDownlink) probeAfterThisStreamsFirstFrame({
+				video: () => videoRef.current,
+				stream: combinedStream,
+				signal: abort.signal,
+				serverUrl,
+				authToken: probeAuthToken ?? null,
+				onRefused: reportProbeRefused
+			}).then((mbps) => {
+				if (mbps === void 0 || !shouldUpgradeAfterProbe(mbps)) return;
+				if (!mountedRef.current || abort.signal.aborted) return;
+				if (probeUpgradeRef.current) return;
+				probeUpgradeRef.current = true;
+				connectServerOffer(true, true, mbps);
+			});
 			let swappedIn = false;
 			const swapInOnce = () => {
 				if (swappedIn || !mountedRef.current) return;
@@ -30630,7 +30828,9 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 		updateState,
 		onError,
 		hintsOverride,
-		reportAdaptiveHints
+		reportAdaptiveHints,
+		probeAuthToken,
+		reportProbeRefused
 	]);
 	const connectWhep = (0, react$1.useCallback)(async () => {
 		if (!mountedRef.current) return;
@@ -30693,7 +30893,7 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 		updateState,
 		onError
 	]);
-	const connectClientOffer = (0, react$1.useCallback)(async (seamless = false, withDownlink = seamless) => {
+	const connectClientOffer = (0, react$1.useCallback)(async (seamless = false, withDownlink = seamless, knownDownlinkMbps) => {
 		if (!mountedRef.current || !handleOffer) return;
 		const oldPc = seamless ? pcRef.current : null;
 		const oldSessions = seamless ? new Set(sessionIdsRef.current) : null;
@@ -30706,13 +30906,26 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 		const ms = () => Math.round(performance.now() - t0);
 		const timing = {};
 		try {
-			const probePromise = !withDownlink ? measuredDownlinkMbps(serverUrl) : void 0;
 			const iceServers = await getIceServers?.();
 			timing.iceServersMs = ms();
 			if (!mountedRef.current || abort.signal.aborted) return;
 			const pc = new RTCPeerConnection({ iceServers: [...iceServers ?? [], { urls: "stun:stun.l.google.com:19302" }] });
 			if (!seamless) pcRef.current = pc;
 			const combinedStream = new MediaStream();
+			if (!withDownlink) probeAfterThisStreamsFirstFrame({
+				video: () => videoRef.current,
+				stream: combinedStream,
+				signal: abort.signal,
+				serverUrl,
+				authToken: probeAuthToken ?? null,
+				onRefused: reportProbeRefused
+			}).then((mbps) => {
+				if (mbps === void 0 || !shouldUpgradeAfterProbe(mbps)) return;
+				if (!mountedRef.current || abort.signal.aborted) return;
+				if (probeUpgradeRef.current) return;
+				probeUpgradeRef.current = true;
+				connectClientOffer(true, true, mbps);
+			});
 			let swappedIn = false;
 			const swapInOnce = () => {
 				if (swappedIn || !mountedRef.current) return;
@@ -30814,7 +31027,7 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 			await pc.setLocalDescription(offer);
 			timing.localSetMs = ms();
 			if (!mountedRef.current || abort.signal.aborted) return;
-			const downlinkMbps = withDownlink ? await measuredDownlinkMbps(serverUrl) : void 0;
+			const downlinkMbps = withDownlink ? knownDownlinkMbps ?? await measuredDownlinkMbps(serverUrl, probeAuthToken ?? null, reportProbeRefused) : void 0;
 			const clientOfferHints = mergePlayerHints(computeClientHints(containerRef.current), hintsOverride, downlinkMbps, !withDownlink);
 			reportAdaptiveHints(withDownlink ? "probe-climb" : "cold-start", clientOfferHints, probeOriginFor(serverUrl));
 			const signalingStart = ms();
@@ -30822,13 +31035,6 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 			timing.signalingRttMs = ms() - signalingStart;
 			sessionId = sid;
 			sessionIdsRef.current.add(sid);
-			if (probePromise !== void 0) probePromise.then((mbps) => {
-				if (mbps === void 0 || !shouldUpgradeAfterProbe(mbps)) return;
-				if (!mountedRef.current || abort.signal.aborted) return;
-				if (probeUpgradeRef.current) return;
-				probeUpgradeRef.current = true;
-				connectClientOffer(true, true);
-			});
 			activeSessionIdRef.current = sid;
 			if (!mountedRef.current || abort.signal.aborted) {
 				closeSession?.(sid).catch(() => {});
@@ -30889,7 +31095,9 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 		onError,
 		startSessionStatePoll,
 		hintsOverride,
-		reportAdaptiveHints
+		reportAdaptiveHints,
+		probeAuthToken,
+		reportProbeRefused
 	]);
 	renegotiateRef.current = (0, react$1.useCallback)(async (sessionId, target) => {
 		const reofferFn = reoffer;
@@ -30996,7 +31204,7 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 				pc.close();
 				return;
 			}
-			const downlinkMbps = await measuredDownlinkMbps(serverUrl);
+			const downlinkMbps = cachedDownlinkMbps(serverUrl);
 			const reofferHints = {
 				...computeClientHints(containerRef.current),
 				...downlinkMbps !== void 0 ? { downlinkMbps } : {},
@@ -31355,31 +31563,27 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 						jitterS = s.jitter ?? 0;
 					} else if (s.type === "candidate-pair" && s.nominated && typeof s.currentRoundTripTime === "number") rttS = s.currentRoundTripTime;
 				});
-				const prev = netPrev.current;
-				netPrev.current = {
+				const step = nextClientSample(netPrev.current, {
+					pc,
 					lost,
 					recv,
 					bytes,
-					ts
-				};
-				if (!prev || ts <= prev.ts) return;
-				const dLost = Math.max(0, lost - prev.lost);
-				const denom = dLost + Math.max(0, recv - prev.recv);
-				const packetLossPercent = denom > 0 ? Math.min(100, dLost / denom * 100) : 0;
-				const estimatedBandwidthKbps = Math.max(0, Math.round((bytes - prev.bytes) * 8 / (ts - prev.ts)));
-				onClientNetworkSample({
-					rttMs: Math.round(rttS * 1e3),
-					jitterMs: Math.round(jitterS * 1e3),
-					estimatedBandwidthKbps,
-					packetLossPercent
+					ts,
+					rttS,
+					jitterS
+				}, {
+					renegotiating: renegotiatingRef.current,
+					probe: latestProbeReading(serverUrl)
 				});
+				netPrev.current = step.baseline;
+				if (step.sample !== null) onClientNetworkSample(step.sample);
 			} catch {}
 		};
 		const id = setInterval(() => {
 			tick();
 		}, 2e3);
 		return () => clearInterval(id);
-	}, [onClientNetworkSample]);
+	}, [onClientNetworkSample, serverUrl]);
 	const pbPrev = (0, react$1.useRef)(null);
 	(0, react$1.useEffect)(() => {
 		if (!onPlaybackStats) {
@@ -45811,9 +46015,11 @@ function resolveControlAlign(type, placement) {
 * Relative "last seen" formatter for the offline affordance.
 *
 * Renders a short relative-time label from a millisecond epoch:
-* "just now", "5m ago", "3h ago", "2d ago". Returns `null` for
-* missing/non-positive inputs so callers can render nothing rather
-* than a misleading "—" or "NaN ago".
+* "just now", "5m ago", "3h ago", "2d ago". Returns `null` for missing
+* inputs, or inputs below {@link MIN_PLAUSIBLE_TIMESTAMP_MS} (a
+* placeholder or a seeded "known value, unknown change time" stamp), so
+* callers can render nothing rather than a misleading "—", "NaN ago", or
+* (for a seeded `1`) "20000 days ago".
 *
 * Future timestamps (clock skew between the device and the browser)
 * collapse to "just now" instead of a negative duration.
@@ -45823,8 +46029,15 @@ var MINUTE_MS = 60 * SECOND_MS;
 var HOUR_MS = 60 * MINUTE_MS;
 var DAY_MS = 24 * HOUR_MS;
 var JUST_NOW_MS = 30 * SECOND_MS;
+/**
+* The earliest timestamp a real "last seen" could plausibly carry. Below
+* this, a value is a placeholder or a seeded "known value, unknown change
+* time" stamp (e.g. Homematic's `HM_SEEDED_CHANGED_AT = 1`) — never a real
+* instant. Year 2000 predates every device this renders.
+*/
+var MIN_PLAUSIBLE_TIMESTAMP_MS = Date.UTC(2e3, 0, 1);
 function formatLastSeen(timestampMs) {
-	if (timestampMs === null || timestampMs === void 0 || timestampMs <= 0) return null;
+	if (timestampMs === null || timestampMs === void 0 || timestampMs < MIN_PLAUSIBLE_TIMESTAMP_MS) return null;
 	const delta = Date.now() - timestampMs;
 	if (delta < JUST_NOW_MS) return "just now";
 	if (delta < HOUR_MS) return `${String(Math.floor(delta / MINUTE_MS))}m ago`;
@@ -56450,6 +56663,7 @@ exports.useDeviceManagerGetStreamSources = useDeviceManagerGetStreamSources;
 exports.useDeviceManagerGetWireableFields = useDeviceManagerGetWireableFields;
 exports.useDeviceManagerListAll = useDeviceManagerListAll;
 exports.useDeviceManagerListBindableCapsForDeviceType = useDeviceManagerListBindableCapsForDeviceType;
+exports.useDeviceManagerListDeviceIdsByCaps = useDeviceManagerListDeviceIdsByCaps;
 exports.useDeviceManagerListLocationDescriptions = useDeviceManagerListLocationDescriptions;
 exports.useDeviceManagerListLocationIcons = useDeviceManagerListLocationIcons;
 exports.useDeviceManagerListLocations = useDeviceManagerListLocations;