@livo-tv/sdk 1.2.3 → 1.2.4

package/dist/studio/index.d.cts

@@ -126,6 +126,7 @@ type StudioDevices = {
 type StudioVideoKind = "camera" | "screen";
 type StudioHostMediaKind = "audio" | "video" | "screen";
 type StudioScreenSharePermission = "ALLOWED" | "NOT_ALLOWED" | "CAN_REQUEST";
+type StudioConnectionState = "joined" | "waitlisted" | "connecting" | "failed";
 type StudioBroadcast = {
     type: "host-media";
     kind: StudioHostMediaKind;
@@ -190,6 +191,8 @@ type StudioMeetingHandle = {
     participants: () => StudioParticipantTile[];
     waitlisted: () => StudioWaitlistedGuest[];
     inWaitingRoom: () => boolean;
+    connectionState: () => StudioConnectionState;
+    lastMeetingError: () => string | null;
     moderatorIds: () => string[];
     localAudioTrack: () => MediaStreamTrack | null;
     localVideoTrack: () => MediaStreamTrack | null;
@@ -219,6 +222,9 @@ declare function studioRoomLabels(t: (key: string, values?: Record<string, strin
     preview: string;
     waiting: string;
     waitingHost: string;
+    connecting: string;
+    connectFailed: string;
+    retry: string;
     admit: string;
     deny: string;
     denied: string;

package/dist/studio/index.d.ts

@@ -126,6 +126,7 @@ type StudioDevices = {
 type StudioVideoKind = "camera" | "screen";
 type StudioHostMediaKind = "audio" | "video" | "screen";
 type StudioScreenSharePermission = "ALLOWED" | "NOT_ALLOWED" | "CAN_REQUEST";
+type StudioConnectionState = "joined" | "waitlisted" | "connecting" | "failed";
 type StudioBroadcast = {
     type: "host-media";
     kind: StudioHostMediaKind;
@@ -190,6 +191,8 @@ type StudioMeetingHandle = {
     participants: () => StudioParticipantTile[];
     waitlisted: () => StudioWaitlistedGuest[];
     inWaitingRoom: () => boolean;
+    connectionState: () => StudioConnectionState;
+    lastMeetingError: () => string | null;
     moderatorIds: () => string[];
     localAudioTrack: () => MediaStreamTrack | null;
     localVideoTrack: () => MediaStreamTrack | null;
@@ -219,6 +222,9 @@ declare function studioRoomLabels(t: (key: string, values?: Record<string, strin
     preview: string;
     waiting: string;
     waitingHost: string;
+    connecting: string;
+    connectFailed: string;
+    retry: string;
     admit: string;
     deny: string;
     denied: string;

package/dist/studio/index.js

@@ -1875,6 +1875,7 @@ function StudioGuestWaiting({
   muted,
   labels,
   settingsOpen,
+  statusLabel,
   onToggleCamera,
   onToggleMute,
   onOpenSettings,
@@ -1906,7 +1907,7 @@ function StudioGuestWaiting({
         reducedMotion
       }
     ),
-    /* @__PURE__ */ jsx("p", { className: "text-muted-foreground text-center text-sm", role: "status", children: labels.waitingHost }),
+    /* @__PURE__ */ jsx("p", { className: "text-muted-foreground text-center text-sm", role: "status", children: statusLabel ?? labels.waitingHost }),
     /* @__PURE__ */ jsx(TooltipProvider, { children: /* @__PURE__ */ jsxs("div", { className: "flex justify-center gap-2", children: [
       /* @__PURE__ */ jsx(
         ControlIcon,
@@ -3490,6 +3491,7 @@ function StudioToolbar({
   ] }) });
 }
 var STAGE_GRANT_VERIFY_MS = 4e3;
+var STUDIO_CONNECT_WATCHDOG_MS = 12e3;
 function StudioRoom({
   session,
   meeting,
@@ -3525,6 +3527,7 @@ function StudioRoom({
   );
   const [egressError, setEgressError] = useState(null);
   const [shareGrant, setShareGrant] = useState("idle");
+  const [connectTimedOut, setConnectTimedOut] = useState(false);
   const [screenPermission, setScreenPermission] = useState(
     () => meeting.screenSharePermission()
   );
@@ -3771,6 +3774,14 @@ function StudioRoom({
     [participants]
   );
   const waitlisted = useMemo(() => meeting.waitlisted(), [meeting, tick]);
+  const connectionState = useMemo(
+    () => meeting.connectionState(),
+    [meeting, tick]
+  );
+  const lastMeetingError = useMemo(
+    () => meeting.lastMeetingError(),
+    [meeting, tick]
+  );
   const canManageStage = meeting.canManageStage();
   const stageEnabled = meeting.stageEnabled();
   const stageRequests = useMemo(
@@ -3868,6 +3879,16 @@ function StudioRoom({
       }
     }
   }, [labels.knock, session.role, waitlisted]);
+  useEffect(() => {
+    if (session.role !== "guest" || connectionState !== "connecting") {
+      setConnectTimedOut(false);
+      return;
+    }
+    const id = window.setTimeout(() => {
+      setConnectTimedOut(true);
+    }, STUDIO_CONNECT_WATCHDOG_MS);
+    return () => window.clearTimeout(id);
+  }, [connectionState, session.role]);
   useEffect(() => {
     if (inWaitingRoom || screenNoticePrimed.current) return;
     if (!durableScreenBlock) return;
@@ -4183,7 +4204,20 @@ function StudioRoom({
       }
     ) });
   }
-  if (inWaitingRoom && session.role === "guest") {
+  const guestConnectFailed = session.role === "guest" && (connectionState === "failed" || connectionState === "connecting" && connectTimedOut);
+  if (guestConnectFailed) {
+    const detail = [meeting.roomState(), lastMeetingError].filter((value) => Boolean(value)).join(" \u2014 ");
+    return /* @__PURE__ */ jsx("div", { className: "flex h-dvh flex-col items-center justify-center p-6", children: /* @__PURE__ */ jsx(
+      EmptyState,
+      {
+        title: labels.connectFailed,
+        description: detail || labels.connectFailed,
+        actionLabel: onRejoin ? labels.retry : void 0,
+        onAction: onRejoin
+      }
+    ) });
+  }
+  if (session.role === "guest" && (connectionState === "waitlisted" || connectionState === "connecting")) {
     return /* @__PURE__ */ jsx(
       StudioGuestWaiting,
       {
@@ -4193,6 +4227,7 @@ function StudioRoom({
         muted,
         labels,
         settingsOpen,
+        statusLabel: connectionState === "connecting" ? labels.connecting : labels.waitingHost,
         onToggleCamera,
         onToggleMute: () => void onToggleMute(),
         onOpenSettings: () => setSettingsOpen(true),
@@ -4718,8 +4753,8 @@ function StudioGuestLobby({
     }
   }
   async function onTestSpeaker() {
-    const speakerId = effective.speaker || devices.speaker[0]?.deviceId || "";
-    if (!speakerId || testingSpeaker) return;
+    if (testingSpeaker) return;
+    const speakerId = effective.speaker || devices.speaker[0]?.deviceId || void 0;
     setTestingSpeaker(true);
     try {
       await playSpeakerTest(speakerId);
@@ -4787,7 +4822,7 @@ function StudioGuestLobby({
             type: "button",
             size: "sm",
             variant: "outline",
-            disabled: !(effective.speaker || devices.speaker[0]?.deviceId) || testingSpeaker,
+            disabled: testingSpeaker,
             onClick: () => void onTestSpeaker(),
             children: deviceLabels.testSpeaker
           }
@@ -5029,6 +5064,38 @@ function isStageDisabledError(error) {
   const message = typeof row.message === "string" ? row.message : "";
   return message.includes("ERR2003") || message.toLowerCase().includes("stage is disabled");
 }
+function isStageBusyError(error) {
+  if (!error || typeof error !== "object") return false;
+  const row = error;
+  if (row.name === "UnsupportedConcurrentMethodExecution") return true;
+  if (row.code === "2006" || row.code === 2006) return true;
+  const message = typeof row.message === "string" ? row.message : "";
+  return message.includes("ERR2006") || message.includes("Unsupported concurrent calls") || message.includes("Action not permitted in current stage status");
+}
+function isRtkMeetingError(error) {
+  if (!error || typeof error !== "object") return false;
+  const row = error;
+  const name = typeof row.name === "string" ? row.name : "";
+  const message = typeof row.message === "string" ? row.message : "";
+  return name === "ClientError" || name === "TransportConnectionError" || message.includes("ERR1608") || message.includes("No speaker found") || message.includes("Socket is not connected");
+}
+function meetingErrorText(error) {
+  if (error instanceof Error && error.message.trim()) return error.message;
+  if (error && typeof error === "object") {
+    const message = error.message;
+    if (typeof message === "string" && message.trim()) return message;
+  }
+  return "Studio failed";
+}
+async function settledDeviceList(load) {
+  if (!load) return [];
+  try {
+    const [result] = await Promise.allSettled([load()]);
+    return result?.status === "fulfilled" ? result.value : [];
+  } catch {
+    return [];
+  }
+}
 function waitMs(ms) {
   return new Promise((resolve) => {
     setTimeout(resolve, ms);
@@ -5066,8 +5133,9 @@ function studioMeetingFromRtk(raw) {
   const pendingPanelists = /* @__PURE__ */ new Set();
   const chatSend = /* @__PURE__ */ new Map();
   const nameOverrides = /* @__PURE__ */ new Map();
-  let joiningStage = false;
+  let joinStageInFlight = null;
   let joinedStageLocally = false;
+  let lastMeetingError = null;
   const historyMessages = [];
   let speakerSinkId = null;
   let lastSpeakerId = typeof meeting.participants?.lastActiveSpeaker === "string" ? meeting.participants.lastActiveSpeaker : null;
@@ -5163,47 +5231,75 @@ function studioMeetingFromRtk(raw) {
     return [...byId.values()].sort((a, b) => a.time - b.time);
   }
   function currentStageStatus() {
-    return meeting.stage?.status ?? meeting.self?.stageStatus;
+    return meeting.self?.stageStatus ?? meeting.stage?.status;
+  }
+  function resolveConnectionState() {
+    const self = meeting.self;
+    const roomState = self?.roomState ?? null;
+    if (roomState === "waitlisted") return "waitlisted";
+    if (roomState === "joined" || self?.roomJoined === true) return "joined";
+    if (lastMeetingError) return "failed";
+    return "connecting";
+  }
+  function recordMeetingError(error) {
+    if (!isRtkMeetingError(error)) return;
+    lastMeetingError = meetingErrorText(error);
+    notifyParticipants();
+  }
+  function onUnhandledRejection(event) {
+    recordMeetingError(event.reason);
+  }
+  if (typeof window !== "undefined") {
+    window.addEventListener("unhandledrejection", onUnhandledRejection);
   }
   async function republishCameraIfOn() {
     if (meeting.self?.videoEnabled !== true) return;
     await meeting.self.disableVideo?.();
     await meeting.self.enableVideo?.();
   }
-  async function joinStageWithRetry() {
-    if (joiningStage) return;
-    joiningStage = true;
-    try {
-      for (let attempt = 0; attempt < STAGE_JOIN_MAX_ATTEMPTS; attempt++) {
-        if (currentStageStatus() === "ON_STAGE") {
+  async function runJoinStageAttempts() {
+    let lastError;
+    for (let attempt = 0; attempt < STAGE_JOIN_MAX_ATTEMPTS; attempt++) {
+      if (currentStageStatus() === "ON_STAGE") {
+        notifyStage();
+        return;
+      }
+      try {
+        await meeting.stage?.join?.();
+        joinedStageLocally = true;
+        await republishCameraIfOn();
+        notifyStage();
+        return;
+      } catch (error) {
+        lastError = error;
+        if (isStageDisabledError(error)) {
           notifyStage();
           return;
         }
-        try {
-          await meeting.stage?.join?.();
-          joinedStageLocally = true;
-          await republishCameraIfOn();
-          notifyStage();
-          return;
-        } catch (error) {
-          if (isStageDisabledError(error)) {
-            notifyStage();
-            return;
-          }
-          console.warn("studio: stage join failed", error);
-          if (attempt === STAGE_JOIN_MAX_ATTEMPTS - 1) {
-            notifyStage();
-            return;
-          }
+        if (isStageBusyError(error)) {
           await waitMs(STAGE_JOIN_RETRY_MS);
-          if (currentStageStatus() !== "ACCEPTED_TO_JOIN_STAGE") {
-            notifyStage();
-            return;
-          }
+          continue;
         }
+        console.warn("studio: stage join failed", error);
+        if (attempt === STAGE_JOIN_MAX_ATTEMPTS - 1) break;
+        await waitMs(STAGE_JOIN_RETRY_MS);
       }
+    }
+    notifyStage();
+    if (currentStageStatus() !== "ON_STAGE") {
+      throw lastError instanceof Error ? lastError : new Error("stage join failed");
+    }
+  }
+  async function joinStageWithRetry() {
+    if (joinStageInFlight) {
+      await joinStageInFlight;
+      return;
+    }
+    joinStageInFlight = runJoinStageAttempts();
+    try {
+      await joinStageInFlight;
     } finally {
-      joiningStage = false;
+      joinStageInFlight = null;
     }
   }
   async function autoJoinStage() {
@@ -5211,18 +5307,27 @@ function studioMeetingFromRtk(raw) {
       notifyStage();
       return;
     }
-    await joinStageWithRetry();
+    try {
+      await joinStageWithRetry();
+    } catch {
+      notifyStage();
+    }
   }
   async function ensureStageJoined() {
     if (currentStageStatus() !== "ACCEPTED_TO_JOIN_STAGE") return;
-    await joinStageWithRetry();
+    try {
+      await joinStageWithRetry();
+    } catch {
+      notifyStage();
+    }
   }
   async function joinStageIfAllowed() {
     if (meeting.self?.permissions?.stageAccess !== "ALLOWED") return;
     if (currentStageStatus() === "ON_STAGE") return;
     try {
-      await meeting.stage?.join?.();
+      await joinStageWithRetry();
     } catch {
+      notifyStage();
     }
   }
   function queuePanelist(guest, fallbackId) {
@@ -5258,6 +5363,8 @@ function studioMeetingFromRtk(raw) {
   listen(meeting.self, "audioUpdate", rebindMedia);
   listen(meeting.self, "pinned", notifyPinned);
   listen(meeting.self, "unpinned", notifyPinned);
+  listen(meeting.self, "waitlisted", notifyParticipants);
+  listen(meeting.self, "roomJoined", notifyParticipants);
   const joined = meeting.participants?.joined;
   listen(joined, "participantJoined", (payload) => {
     void grantIfPending(payload);
@@ -5325,6 +5432,9 @@ function studioMeetingFromRtk(raw) {
       await joinStageIfAllowed();
     },
     async leave() {
+      if (typeof window !== "undefined") {
+        window.removeEventListener("unhandledrejection", onUnhandledRejection);
+      }
       await meeting.leave?.();
     },
     async setAudioEnabled(enabled) {
@@ -5434,19 +5544,7 @@ function studioMeetingFromRtk(raw) {
         notifyStage();
         return;
       }
-      const userId = meeting.self?.userId;
-      if (userId) {
-        await meeting.stage?.grantAccess?.([userId]);
-      }
-      try {
-        await meeting.stage?.join?.();
-      } catch (error) {
-        notifyStage();
-        throw error;
-      }
-      joinedStageLocally = true;
-      await republishCameraIfOn();
-      notifyStage();
+      await joinStageWithRetry();
     },
     async leaveStage() {
       await meeting.stage?.leave?.();
@@ -5454,7 +5552,7 @@ function studioMeetingFromRtk(raw) {
       notifyStage();
     },
     stageStatus() {
-      return meeting.stage?.status ?? meeting.self?.stageStatus ?? "ON_STAGE";
+      return meeting.self?.stageStatus ?? meeting.stage?.status ?? "OFF_STAGE";
     },
     stageRequests() {
       if (meeting.self?.permissions?.acceptStageRequests !== true) {
@@ -5566,9 +5664,13 @@ function studioMeetingFromRtk(raw) {
       }));
     },
     inWaitingRoom() {
-      const self = meeting.self;
-      if (isStudioRejected(self?.roomState ?? null)) return false;
-      return self?.roomState === "waitlisted" || self?.roomJoined === false;
+      return meeting.self?.roomState === "waitlisted";
+    },
+    connectionState() {
+      return resolveConnectionState();
+    },
+    lastMeetingError() {
+      return lastMeetingError;
     },
     moderatorIds() {
       const ids = [];
@@ -5688,9 +5790,9 @@ function studioMeetingFromRtk(raw) {
     async listDevices() {
       const self = meeting.self;
       const [audio, video, speaker] = await Promise.all([
-        self?.getAudioDevices?.() ?? [],
-        self?.getVideoDevices?.() ?? [],
-        self?.getSpeakerDevices?.() ?? []
+        settledDeviceList(self?.getAudioDevices?.bind(self)),
+        settledDeviceList(self?.getVideoDevices?.bind(self)),
+        settledDeviceList(self?.getSpeakerDevices?.bind(self))
       ]);
       return {
         audio: asOptions(audio),
@@ -5703,6 +5805,10 @@ function studioMeetingFromRtk(raw) {
       if (kind === "speaker") {
         speakerSinkId = deviceId;
         for (const el of audioEls.values()) applySink(el, speakerSinkId);
+        const speakers = await settledDeviceList(
+          meeting.self?.getSpeakerDevices?.bind(meeting.self)
+        );
+        if (speakers.length === 0) return;
       }
       await meeting.self?.setDevice?.({
         deviceId,
@@ -6245,6 +6351,9 @@ function studioRoomLabels(t) {
     preview: t("preview"),
     waiting: t("waiting"),
     waitingHost: t("waitingHost"),
+    connecting: t("connecting"),
+    connectFailed: t("connectFailed"),
+    retry: t("retry"),
     admit: t("admit"),
     deny: t("deny"),
     denied: t("denied"),