@ai-matrx/meet 0.7.83 → 0.7.84

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog — `@ai-matrx/meet`
 
+## 0.7.84
+### Unreleased
+
+- **Observation contract (Meet duplicates CORE-DESIGN step S0).** Every screen `<MeetingRoom>`
+  renders now sits inside ONE `[data-meet-root]` carrying the HARNESS-CONTRACT values derived from
+  today's store (phase, role, connection, lobby count, recording, camera/microphone). Tiles carry
+  `[data-meet-participant]`, lobby rows `[data-meet-lobby-entry]`, the listen-only notice its
+  `data-meet-notice` code. New `<MeetRoot>` / `useCoreRootProps()` / `useCoreObservation()` for a
+  consumer's own screens around the room, pure `observeMeeting()` / `rootAttributes()` in the core,
+  and `window.__matrxMeet` diagnostics. The wrapper is `display: contents` — no layout change.
+
+**Consumer action:** wrap any meeting screen you draw yourself (link resolution, a guest-name step,
+a custom in-call layout) in `<MeetRoot>`, passing `phase` when no store exists yet.
+
 ## 0.7.83
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/index.cjs

@@ -162,6 +162,7 @@ __export(src_exports, {
   meetingWhen: () => meetingWhen,
   mergeCaption: () => mergeCaption,
   mergeRecord: () => mergeRecord,
+  microphoneNoticeCode: () => microphoneNoticeCode,
   normalizeDeviceError: () => normalizeDeviceError,
   normalizeMeetError: () => normalizeMeetError,
   normalizeSpoken: () => normalizeSpoken,
@@ -170,8 +171,13 @@ __export(src_exports, {
   noteTakerParticipant: () => noteTakerParticipant,
   noteTakerStatus: () => noteTakerStatus,
   notesDocument: () => notesDocument,
+  observeMeeting: () => observe,
+  observedDevice: () => observedDevice,
+  observedPhase: () => observedPhase,
+  observedQuality: () => observedQuality,
   orderParticipants: () => orderParticipants,
   parseRoomToken: () => parseRoomToken,
+  participantAttributes: () => participantAttributes,
   participantSummary: () => participantSummary,
   playableRecordingFileId: () => playableRecordingFileId,
   projectInvitee: () => projectInvitee,
@@ -192,12 +198,14 @@ __export(src_exports, {
   recordingOffsetMs: () => recordingOffsetMs,
   roleOf: () => roleOf,
   roomTopic: () => roomTopic,
+  rootAttributes: () => rootAttributes,
   searchTranscript: () => searchTranscript,
   sendFollowUp: () => sendFollowUp,
   setGuestRecordAccess: () => setGuestRecordAccess,
   settingsPatch: () => settingsPatch,
   snapshotParticipant: () => snapshotParticipant,
   snippetRuns: () => snippetRuns,
+  staticObservation: () => staticObservation,
   summarizeMeetingRecordRestrictions: () => summarizeMeetingRecordRestrictions,
   transcriptDocument: () => transcriptDocument,
   unavailableFrom: () => unavailableFrom,
@@ -6515,4 +6523,136 @@ function createMeetingRecordCache(options = {}) {
     }
   };
 }
+
+// src/core/observation.ts
+function observedDevice(track) {
+  if (track.enabled) return "on";
+  const refused = track.unavailable;
+  if (refused === null) return "muted_by_me";
+  switch (refused.code) {
+    case "permission-denied":
+      return "unavailable:denied";
+    case "device-not-found":
+      return "unavailable:none";
+    case "device-in-use":
+      return "unavailable:busy";
+    case "insecure-context":
+      return "unavailable:blocked_site";
+    default:
+      return "unavailable:failed";
+  }
+}
+function endedRecord(snapshot, given) {
+  const record = snapshot?.meeting ?? given;
+  return record !== null && record.endedAt !== null;
+}
+function observedPhase(input) {
+  const { snapshot } = input;
+  if (snapshot === null) return "resolving";
+  const raw = snapshot.phase;
+  const live = raw === "connected" || raw === "reconnecting";
+  if (endedRecord(snapshot, input.meeting ?? null) && !live) return "ended";
+  switch (raw) {
+    case "idle":
+    case "failed":
+    case "left":
+      return "prejoin";
+    case "lobby":
+      return "waiting:knocking";
+    case "requesting-token":
+    case "connecting":
+      return "joining";
+    case "connected":
+    case "reconnecting":
+      return "in_call";
+  }
+}
+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 deviceInPlay = phase === "joining" || inCall;
+  return {
+    phase,
+    reason: null,
+    role,
+    connection: snapshot?.phase === "reconnecting" ? "reconnecting" : "stable",
+    hostPresent: inCall && snapshot !== null ? snapshot.participants.some((p) => ADMITTER_ROLES.has(p.role)) : null,
+    lobbyCount: canAdmit && snapshot !== null ? snapshot.lobby.filter((entry) => entry.state === "knocking").length : 0,
+    recording: snapshot?.recording === "recording" || snapshot?.recording === "stopping",
+    audioBlocked: null,
+    camera: deviceInPlay && snapshot !== null ? observedDevice(snapshot.media.camera) : null,
+    microphone: deviceInPlay && snapshot !== null ? observedDevice(snapshot.media.microphone) : null
+  };
+}
+function staticObservation(phase, reason = null) {
+  return {
+    phase,
+    reason,
+    role: "none",
+    connection: phase === "disconnected" ? "server_unreachable" : "stable",
+    hostPresent: null,
+    lobbyCount: 0,
+    recording: false,
+    audioBlocked: null,
+    camera: null,
+    microphone: null
+  };
+}
+function rootAttributes(o) {
+  const attrs = {
+    "data-meet-root": "",
+    "data-meet-phase": o.phase,
+    "data-meet-role": o.role,
+    "data-meet-connection": o.connection,
+    "data-meet-lobby-count": String(o.lobbyCount),
+    "data-meet-recording": String(o.recording)
+  };
+  if (o.reason !== null) attrs["data-meet-reason"] = o.reason;
+  if (o.hostPresent !== null) attrs["data-meet-host-present"] = String(o.hostPresent);
+  if (o.audioBlocked !== null) attrs["data-meet-audio-blocked"] = String(o.audioBlocked);
+  if (o.camera !== null) attrs["data-meet-camera"] = o.camera;
+  if (o.microphone !== null) attrs["data-meet-microphone"] = o.microphone;
+  attrs["data-meet-regions"] = JSON.stringify({
+    connection: o.connection,
+    camera: o.camera,
+    mic: o.microphone,
+    audio_output: o.audioBlocked === null ? null : o.audioBlocked ? "blocked" : "playing",
+    recording: o.recording
+  });
+  return attrs;
+}
+function observedQuality(quality) {
+  switch (quality) {
+    case "excellent":
+    case "good":
+      return "good";
+    case "poor":
+      return "poor";
+    case "lost":
+      return "lost";
+    default:
+      return null;
+  }
+}
+function participantAttributes(p) {
+  const attrs = {
+    "data-meet-participant": "",
+    "data-meet-participant-identity": p.identity,
+    "data-meet-participant-name": p.displayName,
+    "data-meet-participant-role": p.role,
+    "data-meet-participant-self": String(p.isLocal)
+  };
+  const quality = observedQuality(p.quality);
+  if (quality !== null) attrs["data-meet-participant-connection"] = quality;
+  return attrs;
+}
+function microphoneNoticeCode(track) {
+  const refused = track.unavailable;
+  if (refused === null) return null;
+  return refused.code === "permission-denied" || refused.code === "insecure-context" ? "mic-blocked" : "device-lost";
+}
 //# sourceMappingURL=index.cjs.map