@camstack/ui-library 1.2.183 → 1.2.185

package/dist/composites/stream-panel.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { CamProfile, StationaryOverlayBox } from '@camstack/types';
+import { CamProfile, WebrtcSessionDebug, StationaryOverlayBox } from '@camstack/types';
 import { SignalingResult, ClientOfferResult, ClientStreamHints, SessionSignalingState } from './camera-stream-player';
 import { DeviceDetections } from '../hooks/use-device-detections';
 /**
@@ -69,6 +69,12 @@ export interface StreamPanelProps {
      * adaptive re-offer (steady-state behaviour is unchanged).
      */
     readonly getSessionState?: (sessionId: string) => Promise<SessionSignalingState>;
+    /**
+     * The server half of the stream-debug overlay. Optional, and when it is
+     * absent the overlay SAYS so rather than showing an empty section — a panel
+     * that silently omits half its answer is worse than one that admits it.
+     */
+    readonly getSessionDebug?: (sessionId: string) => Promise<WebrtcSessionDebug>;
     /**
      * When set, the panel switches to VOD mode: it renders an `HlsVideo`
      * over this master `.m3u8` URL INSTEAD of the live WebRTC player, and
@@ -196,4 +202,4 @@ export interface StreamPanelProps {
     readonly chromeless?: boolean;
     readonly className?: string;
 }
-export declare function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, playbackUrl, playbackAuthToken, onExitPlayback, posterUrl, streams, activeStreamId: controlledStreamId, onStreamChange, deviceName, phase, pipelineMetrics, detections, stationaryObjects, defaultShowDetections, defaultShowMotion, streamStats, autoPlay, showPlayStop, snapshotSrc, snapshotLoading, onRefreshSnapshot, showStreamStats, children, extraOverlay, ptzAvailable, ptzShown, ptzOverlay, onPtzToggle, intercomAvailable, intercomShown, onIntercomToggle, chromeless, className, }: StreamPanelProps): import("react").JSX.Element;
+export declare function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, getSessionDebug, playbackUrl, playbackAuthToken, onExitPlayback, posterUrl, streams, activeStreamId: controlledStreamId, onStreamChange, deviceName, phase, pipelineMetrics, detections, stationaryObjects, defaultShowDetections, defaultShowMotion, streamStats, autoPlay, showPlayStop, snapshotSrc, snapshotLoading, onRefreshSnapshot, showStreamStats, children, extraOverlay, ptzAvailable, ptzShown, ptzOverlay, onPtzToggle, intercomAvailable, intercomShown, onIntercomToggle, chromeless, className, }: StreamPanelProps): import("react").JSX.Element;

package/dist/index.cjs

@@ -27444,9 +27444,16 @@ function StreamDebugOverlay(props) {
 				measuredAt: server?.observedAt ?? null,
 				now
 			}),
-			!serverWired ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "text-white/50 leading-tight py-0.5",
-				children: "not wired on this host"
+			!serverWired ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "text-amber-300/90 leading-tight py-0.5",
+				children: [
+					"not wired on this surface — this player was mounted without",
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "text-white/80",
+						children: " getSessionDebug"
+					}),
+					", so the server half cannot be asked"
+				]
 			}) : serverError !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "text-rose-300 leading-tight py-0.5 break-words",
 				children: serverError
@@ -28608,7 +28615,10 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 		let cancelled = false;
 		const tick = async () => {
 			const sid = activeSessionIdRef.current;
-			if (sid === null) return;
+			if (sid === null) {
+				setServerDebugError("no session id on this player yet — nothing to ask the server about");
+				return;
+			}
 			try {
 				const answer = await getSessionDebug(sid);
 				if (cancelled) return;
@@ -51072,7 +51082,7 @@ function ImageOffIcon({ className }) {
 		]
 	});
 }
-function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, playbackUrl, playbackAuthToken, onExitPlayback, posterUrl, streams, activeStreamId: controlledStreamId, onStreamChange, deviceName, phase, pipelineMetrics, detections, stationaryObjects, defaultShowDetections = true, defaultShowMotion = false, streamStats, autoPlay = false, showPlayStop = false, snapshotSrc, snapshotLoading = false, onRefreshSnapshot, showStreamStats = false, children, extraOverlay, ptzAvailable = false, ptzShown = false, ptzOverlay, onPtzToggle, intercomAvailable = false, intercomShown = false, onIntercomToggle, chromeless = false, className }) {
+function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, getSessionDebug, playbackUrl, playbackAuthToken, onExitPlayback, posterUrl, streams, activeStreamId: controlledStreamId, onStreamChange, deviceName, phase, pipelineMetrics, detections, stationaryObjects, defaultShowDetections = true, defaultShowMotion = false, streamStats, autoPlay = false, showPlayStop = false, snapshotSrc, snapshotLoading = false, onRefreshSnapshot, showStreamStats = false, children, extraOverlay, ptzAvailable = false, ptzShown = false, ptzOverlay, onPtzToggle, intercomAvailable = false, intercomShown = false, onIntercomToggle, chromeless = false, className }) {
 	const registeredButtons = usePlayerToolbarButtons();
 	const recordedPlayback = useRecordedPlayback();
 	const [isPlaying, setIsPlaying] = (0, react$1.useState)(autoPlay);
@@ -51390,6 +51400,7 @@ function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIce
 					handleOffer: playerHandleOffer,
 					reoffer: playerReoffer,
 					getSessionState,
+					...getSessionDebug ? { getSessionDebug } : {},
 					getIceServers,
 					addIceCandidate,
 					getIceCandidates,

package/dist/index.js

@@ -27420,9 +27420,16 @@ function StreamDebugOverlay(props) {
 				measuredAt: server?.observedAt ?? null,
 				now
 			}),
-			!serverWired ? /* @__PURE__ */ jsx("div", {
-				className: "text-white/50 leading-tight py-0.5",
-				children: "not wired on this host"
+			!serverWired ? /* @__PURE__ */ jsxs("div", {
+				className: "text-amber-300/90 leading-tight py-0.5",
+				children: [
+					"not wired on this surface — this player was mounted without",
+					/* @__PURE__ */ jsx("span", {
+						className: "text-white/80",
+						children: " getSessionDebug"
+					}),
+					", so the server half cannot be asked"
+				]
 			}) : serverError !== null ? /* @__PURE__ */ jsx("div", {
 				className: "text-rose-300 leading-tight py-0.5 break-words",
 				children: serverError
@@ -28584,7 +28591,10 @@ function CameraStreamPlayer({ serverUrl, streamKey, label, autoPlay = true, mute
 		let cancelled = false;
 		const tick = async () => {
 			const sid = activeSessionIdRef.current;
-			if (sid === null) return;
+			if (sid === null) {
+				setServerDebugError("no session id on this player yet — nothing to ask the server about");
+				return;
+			}
 			try {
 				const answer = await getSessionDebug(sid);
 				if (cancelled) return;
@@ -51048,7 +51058,7 @@ function ImageOffIcon({ className }) {
 		]
 	});
 }
-function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, playbackUrl, playbackAuthToken, onExitPlayback, posterUrl, streams, activeStreamId: controlledStreamId, onStreamChange, deviceName, phase, pipelineMetrics, detections, stationaryObjects, defaultShowDetections = true, defaultShowMotion = false, streamStats, autoPlay = false, showPlayStop = false, snapshotSrc, snapshotLoading = false, onRefreshSnapshot, showStreamStats = false, children, extraOverlay, ptzAvailable = false, ptzShown = false, ptzOverlay, onPtzToggle, intercomAvailable = false, intercomShown = false, onIntercomToggle, chromeless = false, className }) {
+function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, getSessionDebug, playbackUrl, playbackAuthToken, onExitPlayback, posterUrl, streams, activeStreamId: controlledStreamId, onStreamChange, deviceName, phase, pipelineMetrics, detections, stationaryObjects, defaultShowDetections = true, defaultShowMotion = false, streamStats, autoPlay = false, showPlayStop = false, snapshotSrc, snapshotLoading = false, onRefreshSnapshot, showStreamStats = false, children, extraOverlay, ptzAvailable = false, ptzShown = false, ptzOverlay, onPtzToggle, intercomAvailable = false, intercomShown = false, onIntercomToggle, chromeless = false, className }) {
 	const registeredButtons = usePlayerToolbarButtons();
 	const recordedPlayback = useRecordedPlayback();
 	const [isPlaying, setIsPlaying] = useState(autoPlay);
@@ -51366,6 +51376,7 @@ function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIce
 					handleOffer: playerHandleOffer,
 					reoffer: playerReoffer,
 					getSessionState,
+					...getSessionDebug ? { getSessionDebug } : {},
 					getIceServers,
 					addIceCandidate,
 					getIceCandidates,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/ui-library",
-  "version": "1.2.183",
+  "version": "1.2.185",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",