@ai-matrx/meet 0.8.1 → 0.10.0

package/dist/skins/meet.cjs

@@ -164,11 +164,18 @@ var MeetError = class extends Error {
   /** What to DO. Rendered to the user for the device codes. */
   remedy;
   cause;
-  constructor(code, message, remedy, cause) {
+  /**
+   * The join gate's reason code (CORE-DESIGN §2.5) when the server named one: `not_found`,
+   * `cancelled`, `ended`, `locked`, `removed`, `lobby_rejects`, `not_invited`… The phase
+   * renders `refused:<reason>` (or `ended`) from it — never from the HTTP status.
+   */
+  reason;
+  constructor(code, message, remedy, cause, reason) {
     super(message);
     this.name = "MeetError";
     this.code = code;
     this.remedy = remedy;
+    this.reason = reason ?? null;
     if (cause !== void 0) this.cause = cause;
   }
   /** True when retrying after the host re-establishes a session is the fix. */
@@ -241,7 +248,7 @@ var MEET_ROUTES = {
   /**
    * THE POST-MEETING RECORD FOR A READER WITH NO DATABASE (MRF-1). A `GET`,
    * authorized by the room token this device already holds, carried in the
-   * `x-meet-room-token` header — never a query parameter, because a bearer
+   * `x-meet-pass` header — never a query parameter, because a bearer
    * credential in a URL lands in access logs, referrers and history.
    */
   record: "/api/v1/meet/record",
@@ -249,7 +256,7 @@ var MEET_ROUTES = {
   recordAccess: "/api/v1/meet/record/access",
   /**
    * KEEP YOUR NOTES (2026-10-01): a guest who just created an account presents
-   * their kept pass in `x-meet-room-token` with their new session, and the
+   * their kept pass in `x-meet-pass` with their new session, and the
    * meeting they attended becomes theirs to read. Idempotent; never a grant.
    */
   claim: "/api/v1/meet/claim",
@@ -271,7 +278,7 @@ var MEET_ROUTES = {
    * Meet wave 2: EVERY in-meeting host power (mute, stop video, mute all, ask to
    * unmute, spotlight, lower hands, co-host, hand over, rename, remove, report).
    * Decided by the server from the meeting itself; a guest's pass rides
-   * `x-meet-room-token`.
+   * `x-meet-pass`.
    */
   moderate: "/api/v1/meet/moderate",
   /** Meet wave 2: the SAVED chat — `POST` sends to everyone, `GET ?meeting_id=` reads history. */
@@ -282,7 +289,17 @@ var MEET_ROUTES = {
    */
   collab: "/api/v1/meet/collab",
   /** Meet wave 5: translate finished caption lines into this viewer's language. */
-  captionsTranslate: "/api/v1/meet/captions/translate"
+  captionsTranslate: "/api/v1/meet/captions/translate",
+  /**
+   * S4 — THE STATE READ (CORE-DESIGN §2.6): `GET ?meeting_id=` with `x-meet-pass`. This
+   * person's admission (lazy expiry applied), whether anyone who can admit is here, the run's
+   * phase. Read every `waiting_poll_seconds` while waiting and on every `mx.state.changed`.
+   */
+  state: "/api/v1/meet/state",
+  /** S4: `withdraw` (stop waiting) or `leave` (close this tab); the pass may ride in the body. */
+  leave: "/api/v1/meet/leave",
+  /** S4: a pass holder (guests included) saw the recording notice, for this run. */
+  consent: "/api/v1/meet/consent"
 };
 
 // src/core/recording.ts
@@ -331,11 +348,15 @@ function listenOnlyNotice(media) {
 
 // src/core/types.ts
 var ROLE_RANK = {
-  host: 3,
-  cohost: 2,
+  host: 4,
+  cohost: 3,
+  presenter: 2,
   participant: 1,
-  guest: 0
+  viewer: 0
 };
+function isLinkFollower(standing) {
+  return standing === "guest" || standing === "outsider";
+}
 function isHostRole(role) {
   return role === "host" || role === "cohost";
 }
@@ -413,9 +434,18 @@ function effectiveRole(snapshot) {
   const fromToken = snapshot.grants.role;
   return ROLE_RANK[fromRoster] >= ROLE_RANK[fromToken] ? fromRoster : fromToken;
 }
+function effectiveStanding(snapshot) {
+  if (snapshot.grants.standing != null) return snapshot.grants.standing;
+  const me = snapshot.participants.find((p) => p.identity === snapshot.localIdentity);
+  return me?.standing ?? null;
+}
 var REACTION_TTL_MS = 5e3;
 
 // src/core/observation.ts
+function observedRole(role, standing) {
+  if (role === "host" || role === "cohost") return role;
+  return isLinkFollower(standing) ? "guest" : "participant";
+}
 function observedDevice(track) {
   if (track.enabled) return "on";
   const refused = track.unavailable;
@@ -443,13 +473,15 @@ function observedPhase(input) {
   const raw = snapshot.phase;
   const live = raw === "connected" || raw === "reconnecting";
   if (endedRecord(snapshot, input.meeting ?? null) && !live) return "ended";
+  const reason = raw === "failed" ? snapshot.failure?.reason ?? null : null;
+  if (reason !== null) return reason === "ended" ? "ended" : `refused:${reason}`;
   switch (raw) {
     case "idle":
     case "failed":
     case "left":
       return "prejoin";
     case "lobby":
-      return "waiting:knocking";
+      return waitingPhase(snapshot);
     case "requesting-token":
     case "connecting":
       return "joining";
@@ -458,20 +490,39 @@ function observedPhase(input) {
       return "in_call";
   }
 }
+function waitingPhase(snapshot) {
+  switch (snapshot.waiting?.admission) {
+    case "waiting_host":
+      return "waiting:host_not_started";
+    case "denied":
+      return "denied";
+    case "expired":
+      return "knock_expired";
+    case "withdrawn":
+      return "left";
+    case "ended":
+      return "ended";
+    case "removed":
+      return "refused:removed";
+    default:
+      return "waiting:knocking";
+  }
+}
 var ADMITTER_ROLES = /* @__PURE__ */ new Set(["host", "cohost"]);
 function observe(input) {
   const { snapshot } = input;
   const phase = observedPhase(input);
   const inCall = phase === "in_call";
-  const role = inCall && snapshot !== null ? effectiveRole(snapshot) : "none";
-  const canAdmit = role !== "none" && ADMITTER_ROLES.has(role);
+  const actual = inCall && snapshot !== null ? effectiveRole(snapshot) : "none";
+  const canAdmit = actual !== "none" && ADMITTER_ROLES.has(actual);
+  const role = actual === "none" || snapshot === null ? "none" : observedRole(actual, effectiveStanding(snapshot));
   const deviceInPlay = phase === "joining" || inCall;
   return {
     phase,
-    reason: null,
+    reason: phase.startsWith("refused:") ? phase.slice("refused:".length) : null,
     role,
     connection: snapshot?.phase === "reconnecting" ? "reconnecting" : "stable",
-    hostPresent: inCall && snapshot !== null ? snapshot.participants.some((p) => ADMITTER_ROLES.has(p.role)) : null,
+    hostPresent: inCall && snapshot !== null ? snapshot.participants.some((p) => ADMITTER_ROLES.has(p.role)) : snapshot?.phase === "lobby" ? snapshot.waiting?.admittersPresent ?? null : null,
     lobbyCount: canAdmit && snapshot !== null ? snapshot.lobby.filter((entry) => entry.state === "knocking").length : 0,
     recording: snapshot?.recording === "recording" || snapshot?.recording === "stopping",
     audioBlocked: null,
@@ -511,7 +562,7 @@ function participantAttributes(p) {
     "data-meet-participant": "",
     "data-meet-participant-identity": p.identity,
     "data-meet-participant-name": p.displayName,
-    "data-meet-participant-role": p.role,
+    "data-meet-participant-role": observedRole(p.role, p.standing),
     "data-meet-participant-self": String(p.isLocal)
   };
   const quality = observedQuality(p.quality);
@@ -1004,12 +1055,22 @@ function useLobby() {
       async () => requireSession(session, "admitAll").admitAll(),
       [session]
     ),
-    knock: (0, import_react4.useCallback)(
-      (roomName) => requireSession(session, "knock").knock(roomName),
+    undeny: (0, import_react4.useCallback)(
+      async (entry) => requireSession(session, "undeny").undeny(entry),
       [session]
     )
   };
 }
+function useWaiting() {
+  const host = useMeetHost();
+  const snapshot = useMeetSnapshot();
+  const session = host?.meetings ?? null;
+  return {
+    waiting: snapshot?.waiting ?? null,
+    withdraw: (0, import_react4.useCallback)(async () => requireSession(session, "withdraw").withdraw(), [session]),
+    askAgain: (0, import_react4.useCallback)(async () => requireSession(session, "askAgain").askAgain(), [session])
+  };
+}
 function useRecording() {
   const host = useMeetHost();
   const snapshot = useMeetSnapshot();
@@ -2779,10 +2840,13 @@ function ConnectionDot({ quality }) {
   if (quality === "excellent" || quality === "good" || quality === "unknown") return null;
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: `mx-meet__quality mx-meet__quality--${quality}`, title: `Connection ${quality}`, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(WifiLowIcon, { width: 14, height: 14 }) });
 }
-function RoleBadge({ role }) {
+function RoleBadge({
+  role,
+  standing
+}) {
   if (role === "host") return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "mx-meet__badge", children: "Host" });
   if (role === "cohost") return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "mx-meet__badge", children: "Co-host" });
-  if (role === "guest") return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "mx-meet__badge", children: "Guest" });
+  if (isLinkFollower(standing)) return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "mx-meet__badge", children: "Guest" });
   return null;
 }
 function ParticipantTile({
@@ -2832,7 +2896,7 @@ function ParticipantTile({
             participant.displayName,
             participant.isLocal ? " (you)" : "",
             participant.isAgent ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "mx-meet__badge", children: "AI" }) : null,
-            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(RoleBadge, { role: participant.role })
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(RoleBadge, { role: participant.role, standing: participant.standing })
           ] }),
           !participant.micEnabled ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(MicOffIcon, { width: 14, height: 14 }) : null,
           /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(QualityBars, { quality: participant.quality })
@@ -3571,7 +3635,13 @@ function PeoplePanel({
         /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("span", { className: "mx-meet__person-name", children: [
           participant.displayName,
           participant.identity === local ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "mx-meet__you", children: " (you)" }) : null,
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(RoleBadge, { role: participant.identity === local ? myRole : participant.role }),
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+            RoleBadge,
+            {
+              role: participant.identity === local ? myRole : participant.role,
+              standing: participant.standing
+            }
+          ),
           isNoteTaker(participant) ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "mx-meet__badge", children: "Meeting assistant" }) : null,
           snapshot?.spotlight === participant.identity ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "mx-meet__badge", children: "Spotlight" }) : null
         ] }),
@@ -4487,7 +4557,7 @@ function MeetSkinRoom({
     ) });
   }
   if (phase === "lobby") {
-    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { className: "mx-meet mx-meet--lobby", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(WaitingRoom, { roomName, host }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { className: "mx-meet mx-meet--lobby", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(WaitingRoom, { host, ...onLeave !== void 0 ? { onLeave } : {} }) });
   }
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "mx-meet", children: [
     /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(ConsentNotice, {}),
@@ -4512,21 +4582,58 @@ function MeetSkinRoom({
     /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(ControlBar, { ...onLeave !== void 0 ? { onLeave } : {} })
   ] });
 }
-function WaitingRoom({ roomName, host }) {
-  const knocked = (0, import_react9.useRef)(false);
-  (0, import_react9.useEffect)(() => {
-    if (knocked.current) return;
-    knocked.current = true;
-    host.meetings.knock(roomName);
-  }, [host, roomName]);
+function WaitingRoom({ host, onLeave }) {
+  const { waiting, withdraw, askAgain } = useWaiting();
+  const [busy, setBusy] = (0, import_react9.useState)(false);
+  const admission = waiting?.admission ?? "knocking";
+  const run = (action) => () => {
+    setBusy(true);
+    void action().catch(() => void 0).finally(() => setBusy(false));
+  };
+  const home = /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_design_system.Button, { type: "button", variant: "outline", onClick: () => onLeave !== void 0 ? onLeave() : window.location.assign("/"), children: "Back to home" });
+  let title;
+  let line = null;
+  let actions;
+  switch (admission) {
+    case "waiting_host":
+      title = "Waiting for the host to start";
+      actions = /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_design_system.Button, { type: "button", variant: "outline", disabled: busy, onClick: run(withdraw), children: "Leave" });
+      break;
+    case "denied":
+      title = "The host declined your request";
+      actions = /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
+        waiting?.reknockAllowed === true ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_design_system.Button, { type: "button", disabled: busy, onClick: run(askAgain), children: "Ask to join again" }) : null,
+        home
+      ] });
+      break;
+    case "expired":
+      title = "No one responded";
+      actions = /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_design_system.Button, { type: "button", disabled: busy, onClick: run(askAgain), children: "Ask again" }),
+        home
+      ] });
+      break;
+    case "withdrawn":
+      title = "You left the waiting room";
+      actions = /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_design_system.Button, { type: "button", disabled: busy, onClick: run(askAgain), children: "Rejoin" }),
+        home
+      ] });
+      break;
+    case "ended":
+      title = "The meeting has ended";
+      actions = home;
+      break;
+    default:
+      title = "Waiting for the host to let you in";
+      line = waiting?.admittersPresent === false ? "The host isn't here yet" : null;
+      actions = /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_design_system.Button, { type: "button", variant: "outline", disabled: busy, onClick: run(withdraw), children: "Cancel request" });
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "mx-meet__waiting", children: [
     /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Avatar, { name: host.identity.displayName, url: host.identity.avatarUrl, size: 72 }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("h1", { className: "mx-meet__prejoin-title", children: "Waiting for the host to let you in" }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("p", { className: "mx-meet__empty-body", children: [
-      "You are in the waiting room as ",
-      host.identity.displayName,
-      ". You will join automatically once you are admitted."
-    ] })
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("h1", { className: "mx-meet__prejoin-title", children: title }),
+    line !== null ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { className: "mx-meet__empty-body", role: "status", "data-meet-notice": "host-absent", children: line }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { className: "mx-meet__waiting-actions", children: actions })
   ] });
 }
 function HostMenu() {