@ai-matrx/meet 0.11.34 → 0.11.36

package/dist/core.d.cts

@@ -2020,6 +2020,12 @@ interface MeetRoomDriver {
      * (the gesture is what the browser checks). Optional: a driver without it never blocks.
      */
     startAudio?(): Promise<void>;
+    /**
+     * S7 — a "join here too" companion plays no remote audio (the person's other device does; two
+     * speakers in one room echo). `false` removes every attached remote audio element and keeps new
+     * ones from attaching. Optional: a driver without it always plays.
+     */
+    setRemoteAudioPlayback?(enabled: boolean): void;
 }
 type RoomDriverFactory = (handlers: RoomDriverHandlers) => MeetRoomDriver | Promise<MeetRoomDriver>;
 /** Topics for the in-room control plane. One place, so senders cannot drift. */
@@ -2522,6 +2528,13 @@ interface RoomEngine {
     leave(): Promise<void>;
     /** The person's own "back to the device check" press from `left` / `disconnected`. */
     backToPrejoin(): void;
+    /**
+     * S7: BEFORE Join — is this person already live in `roomName` on another tab of THIS browser
+     * (`TabClaim.presentElsewhere`)? When yes the pre-join offers Switch here / Join here too up
+     * front (the same choice the server would otherwise ask after the press). Returns whether it did.
+     * A guest has no stable person key before the pass, so the server's own answer covers them.
+     */
+    checkElsewhere(roomName: RoomName): Promise<boolean>;
     /** Clear a refused-share notice (the `share` region) the person dismissed. */
     dismissShareNotice(): void;
     setMicrophoneEnabled(enabled: boolean): Promise<void>;

package/dist/core.d.ts

@@ -2020,6 +2020,12 @@ interface MeetRoomDriver {
      * (the gesture is what the browser checks). Optional: a driver without it never blocks.
      */
     startAudio?(): Promise<void>;
+    /**
+     * S7 — a "join here too" companion plays no remote audio (the person's other device does; two
+     * speakers in one room echo). `false` removes every attached remote audio element and keeps new
+     * ones from attaching. Optional: a driver without it always plays.
+     */
+    setRemoteAudioPlayback?(enabled: boolean): void;
 }
 type RoomDriverFactory = (handlers: RoomDriverHandlers) => MeetRoomDriver | Promise<MeetRoomDriver>;
 /** Topics for the in-room control plane. One place, so senders cannot drift. */
@@ -2522,6 +2528,13 @@ interface RoomEngine {
     leave(): Promise<void>;
     /** The person's own "back to the device check" press from `left` / `disconnected`. */
     backToPrejoin(): void;
+    /**
+     * S7: BEFORE Join — is this person already live in `roomName` on another tab of THIS browser
+     * (`TabClaim.presentElsewhere`)? When yes the pre-join offers Switch here / Join here too up
+     * front (the same choice the server would otherwise ask after the press). Returns whether it did.
+     * A guest has no stable person key before the pass, so the server's own answer covers them.
+     */
+    checkElsewhere(roomName: RoomName): Promise<boolean>;
     /** Clear a refused-share notice (the `share` region) the person dismissed. */
     dismissShareNotice(): void;
     setMicrophoneEnabled(enabled: boolean): Promise<void>;

package/dist/core.js

@@ -4482,6 +4482,7 @@ function createLiveKitDriver(handlers, options = {}) {
     projectRoster = roster;
     created.on(RoomEvent.TrackSubscribed, (track) => {
       if (track.kind !== Track.Kind.Audio || typeof document === "undefined") return;
+      if (!remoteAudioPlayback) return;
       const element = track.attach();
       element.setAttribute("data-mx-meet-audio", "");
       audioSink().appendChild(element);
@@ -4566,6 +4567,7 @@ function createLiveKitDriver(handlers, options = {}) {
   let sources = null;
   let trackEvents = null;
   let audioContainer = null;
+  let remoteAudioPlayback = true;
   function audioSink() {
     if (audioContainer !== null && audioContainer.isConnected) return audioContainer;
     const container = document.createElement("div");
@@ -4724,6 +4726,14 @@ function createLiveKitDriver(handlers, options = {}) {
         throw normalizeDeviceError(error, "meet.switchDevice");
       }
     },
+    setRemoteAudioPlayback(enabled) {
+      remoteAudioPlayback = enabled;
+      if (enabled || audioContainer === null) return;
+      for (const element of Array.from(audioContainer.querySelectorAll("[data-mx-meet-audio]"))) {
+        if (element instanceof HTMLMediaElement) element.srcObject = null;
+        element.remove();
+      }
+    },
     async startAudio() {
       const target = room;
       if (target === null) return;
@@ -6628,6 +6638,7 @@ function createRoomEngine(options) {
       return;
     }
     driver = created;
+    if (token.connectionKind === "companion") created.setRemoteAudioPlayback?.(false);
     await created.connect(token.serverUrl, token.token);
     store.patch({ failure: null, connection: "stable" });
     store.dispatch({ type: "connected" });
@@ -6889,6 +6900,19 @@ function createRoomEngine(options) {
       }
     },
     leave: leaveRoom,
+    async checkElsewhere(roomName) {
+      const claim = options.tabClaim;
+      const userId = identity.userId;
+      if (claim === void 0 || userId === null) return false;
+      const before = store.snapshot();
+      if (before.phase !== "prejoin" || before.secondDevice !== null) return false;
+      if (!await claim.presentElsewhere(String(roomName), `user:${String(userId)}`)) return false;
+      const now2 = store.snapshot();
+      if (now2.phase !== "prejoin" || now2.secondDevice !== null) return false;
+      store.patch({ secondDevice: { rule: "ask_switch_or_join" } });
+      report("info", "meet: this browser already has you in this meeting \u2014 offering the choice before Join");
+      return true;
+    },
     backToPrejoin() {
       store.dispatch({ type: "back_to_prejoin", click: true });
     },