sabha-meetings-react 0.1.7 → 0.1.9

package/dist/index.d.mts

@@ -146,10 +146,13 @@ type UpdateMeetingInput = {
     [key: string]: unknown;
 };
 type MeetingConnectionState = "disconnected" | "connecting" | "connected" | "joined" | "error";
+/** Host publishes A/V; participants join to view the host only. */
+type MeetingRole = "host" | "participant";
 type MeetingParticipant = {
     id: string;
     displayName?: string;
     username?: string;
+    role?: MeetingRole;
     audioEnabled?: boolean;
     videoEnabled?: boolean;
     screenSharing?: boolean;
@@ -188,6 +191,8 @@ type MeetingRoomEventMap = {
         reason?: string;
     };
     mediaState: LocalMediaState;
+    /** Host media received by a participant (one-way). */
+    remoteStream: MediaStream | null;
     captureAttempt: {
         type: "screenshot" | "recording" | "visibility";
         at: string;
@@ -269,6 +274,10 @@ type MeetingConnectionOptions = {
     socketPath?: string;
     events?: Partial<SabhaSocketEvents>;
     mediaPolicy?: Partial<MediaPolicy>;
+    /** Host publishes A/V; participant receives host stream only. Default host. */
+    role?: MeetingRole;
+    /** Stable id for WebRTC signaling (usually Sabha userId). */
+    selfId?: string;
 };
 declare class MeetingConnection {
     private readonly options;
@@ -276,15 +285,21 @@ declare class MeetingConnection {
     private state;
     private readonly events;
     private readonly mediaPolicy;
+    private readonly role;
+    private readonly selfId;
     readonly media: MediaController;
     readonly protection: ContentProtection;
     private readonly listeners;
     private mediaUnsub;
     private captureUnsub;
+    private readonly peers;
+    private remoteStream;
     constructor(options: MeetingConnectionOptions);
     get meetingId(): string;
+    get meetingRole(): MeetingRole;
     get connectionState(): MeetingConnectionState;
     getMediaState(): LocalMediaState;
+    getRemoteStream(): MediaStream | null;
     on<K extends keyof MeetingRoomEventMap>(event: K, listener: Listener<MeetingRoomEventMap[K]>): () => void;
     connect(): Promise<void>;
     setAudioEnabled(enabled: boolean): Promise<LocalMediaState>;
@@ -298,6 +313,13 @@ declare class MeetingConnection {
     private teardownMedia;
     private join;
     private bindServerEvents;
+    private sendSignal;
+    private handleSignal;
+    private createHostOffer;
+    private getOrCreatePeer;
+    private attachLocalTracks;
+    private refreshHostTracks;
+    private closePeer;
     private setState;
     private emit;
 }
@@ -344,7 +366,9 @@ declare class SabhaClient {
         meeting: Meeting;
         connection: MeetingConnection;
     }>;
-    connect(meetingId: string): Promise<MeetingConnection>;
+    connect(meetingId: string, options?: {
+        role?: MeetingRole;
+    }): Promise<MeetingConnection>;
     getConnection(): MeetingConnection | null;
     leaveMeeting(): Promise<void>;
     private applySession;
@@ -407,7 +431,9 @@ declare function useSabhaMeetings(): {
         meeting: Meeting;
         connection: MeetingConnection;
     }>;
-    connect: (meetingId: string) => Promise<MeetingConnection>;
+    connect: (meetingId: string, options?: {
+        role?: MeetingRole;
+    }) => Promise<MeetingConnection>;
     leaveMeeting: () => Promise<void>;
     connection: MeetingConnection | null;
     connectionState: MeetingConnectionState;
@@ -447,4 +473,4 @@ declare function readStoredSessionCookie(): string | null;
 declare function writeStoredSessionCookie(value: string | null): void;
 
 export { ContentProtection, DEFAULT_BASE_URL, DEFAULT_MEDIA_POLICY, MediaController, MeetingConnection, SABHA_SESSION_HEADER, SABHA_SESSION_STORAGE_KEY, SABHA_TOKENS_STORAGE_KEY, SabhaClient, SabhaError, SabhaProvider, createSabhaClient, normalizeMeeting, readStoredSessionCookie, readStoredTokens, toSabhaError, useSabha, useSabhaMeetings, writeStoredSessionCookie, writeStoredTokens };
-export type { AuthSession, AuthUser, CaptureAttemptType, CreateMeetingInput, LocalMediaState, LoginInput, MediaPolicy, MediaTrackKind, Meeting, MeetingConnectionOptions, MeetingConnectionState, MeetingInvitee, MeetingOrganizer, MeetingParticipant, MeetingRoomEventMap, RegisterInput, SabhaClientStatus, SabhaConfig, SabhaContextValue, SabhaOrg, SabhaProviderProps, SabhaSocketEvents, SabhaTokens, UpdateMeetingInput, VerifyEmailInput };
+export type { AuthSession, AuthUser, CaptureAttemptType, CreateMeetingInput, LocalMediaState, LoginInput, MediaPolicy, MediaTrackKind, Meeting, MeetingConnectionOptions, MeetingConnectionState, MeetingInvitee, MeetingOrganizer, MeetingParticipant, MeetingRole, MeetingRoomEventMap, RegisterInput, SabhaClientStatus, SabhaConfig, SabhaContextValue, SabhaOrg, SabhaProviderProps, SabhaSocketEvents, SabhaTokens, UpdateMeetingInput, VerifyEmailInput };

package/dist/index.d.ts

@@ -146,10 +146,13 @@ type UpdateMeetingInput = {
     [key: string]: unknown;
 };
 type MeetingConnectionState = "disconnected" | "connecting" | "connected" | "joined" | "error";
+/** Host publishes A/V; participants join to view the host only. */
+type MeetingRole = "host" | "participant";
 type MeetingParticipant = {
     id: string;
     displayName?: string;
     username?: string;
+    role?: MeetingRole;
     audioEnabled?: boolean;
     videoEnabled?: boolean;
     screenSharing?: boolean;
@@ -188,6 +191,8 @@ type MeetingRoomEventMap = {
         reason?: string;
     };
     mediaState: LocalMediaState;
+    /** Host media received by a participant (one-way). */
+    remoteStream: MediaStream | null;
     captureAttempt: {
         type: "screenshot" | "recording" | "visibility";
         at: string;
@@ -269,6 +274,10 @@ type MeetingConnectionOptions = {
     socketPath?: string;
     events?: Partial<SabhaSocketEvents>;
     mediaPolicy?: Partial<MediaPolicy>;
+    /** Host publishes A/V; participant receives host stream only. Default host. */
+    role?: MeetingRole;
+    /** Stable id for WebRTC signaling (usually Sabha userId). */
+    selfId?: string;
 };
 declare class MeetingConnection {
     private readonly options;
@@ -276,15 +285,21 @@ declare class MeetingConnection {
     private state;
     private readonly events;
     private readonly mediaPolicy;
+    private readonly role;
+    private readonly selfId;
     readonly media: MediaController;
     readonly protection: ContentProtection;
     private readonly listeners;
     private mediaUnsub;
     private captureUnsub;
+    private readonly peers;
+    private remoteStream;
     constructor(options: MeetingConnectionOptions);
     get meetingId(): string;
+    get meetingRole(): MeetingRole;
     get connectionState(): MeetingConnectionState;
     getMediaState(): LocalMediaState;
+    getRemoteStream(): MediaStream | null;
     on<K extends keyof MeetingRoomEventMap>(event: K, listener: Listener<MeetingRoomEventMap[K]>): () => void;
     connect(): Promise<void>;
     setAudioEnabled(enabled: boolean): Promise<LocalMediaState>;
@@ -298,6 +313,13 @@ declare class MeetingConnection {
     private teardownMedia;
     private join;
     private bindServerEvents;
+    private sendSignal;
+    private handleSignal;
+    private createHostOffer;
+    private getOrCreatePeer;
+    private attachLocalTracks;
+    private refreshHostTracks;
+    private closePeer;
     private setState;
     private emit;
 }
@@ -344,7 +366,9 @@ declare class SabhaClient {
         meeting: Meeting;
         connection: MeetingConnection;
     }>;
-    connect(meetingId: string): Promise<MeetingConnection>;
+    connect(meetingId: string, options?: {
+        role?: MeetingRole;
+    }): Promise<MeetingConnection>;
     getConnection(): MeetingConnection | null;
     leaveMeeting(): Promise<void>;
     private applySession;
@@ -407,7 +431,9 @@ declare function useSabhaMeetings(): {
         meeting: Meeting;
         connection: MeetingConnection;
     }>;
-    connect: (meetingId: string) => Promise<MeetingConnection>;
+    connect: (meetingId: string, options?: {
+        role?: MeetingRole;
+    }) => Promise<MeetingConnection>;
     leaveMeeting: () => Promise<void>;
     connection: MeetingConnection | null;
     connectionState: MeetingConnectionState;
@@ -447,4 +473,4 @@ declare function readStoredSessionCookie(): string | null;
 declare function writeStoredSessionCookie(value: string | null): void;
 
 export { ContentProtection, DEFAULT_BASE_URL, DEFAULT_MEDIA_POLICY, MediaController, MeetingConnection, SABHA_SESSION_HEADER, SABHA_SESSION_STORAGE_KEY, SABHA_TOKENS_STORAGE_KEY, SabhaClient, SabhaError, SabhaProvider, createSabhaClient, normalizeMeeting, readStoredSessionCookie, readStoredTokens, toSabhaError, useSabha, useSabhaMeetings, writeStoredSessionCookie, writeStoredTokens };
-export type { AuthSession, AuthUser, CaptureAttemptType, CreateMeetingInput, LocalMediaState, LoginInput, MediaPolicy, MediaTrackKind, Meeting, MeetingConnectionOptions, MeetingConnectionState, MeetingInvitee, MeetingOrganizer, MeetingParticipant, MeetingRoomEventMap, RegisterInput, SabhaClientStatus, SabhaConfig, SabhaContextValue, SabhaOrg, SabhaProviderProps, SabhaSocketEvents, SabhaTokens, UpdateMeetingInput, VerifyEmailInput };
+export type { AuthSession, AuthUser, CaptureAttemptType, CreateMeetingInput, LocalMediaState, LoginInput, MediaPolicy, MediaTrackKind, Meeting, MeetingConnectionOptions, MeetingConnectionState, MeetingInvitee, MeetingOrganizer, MeetingParticipant, MeetingRole, MeetingRoomEventMap, RegisterInput, SabhaClientStatus, SabhaConfig, SabhaContextValue, SabhaOrg, SabhaProviderProps, SabhaSocketEvents, SabhaTokens, UpdateMeetingInput, VerifyEmailInput };

package/dist/index.js

@@ -681,6 +681,11 @@ var DEFAULT_EVENTS = {
   error: "meeting:error",
   mediaState: "meeting:media-state"
 };
+var SIGNAL_EVENT = "meeting:signal";
+var ICE_SERVERS = [
+  { urls: "stun:stun.l.google.com:19302" },
+  { urls: "stun:stun1.l.google.com:19302" }
+];
 var MeetingConnection = class {
   constructor(options) {
     this.options = options;
@@ -689,20 +694,37 @@ var MeetingConnection = class {
     this.listeners = /* @__PURE__ */ new Map();
     this.mediaUnsub = null;
     this.captureUnsub = null;
+    this.peers = /* @__PURE__ */ new Map();
+    this.remoteStream = null;
     this.events = { ...DEFAULT_EVENTS, ...options.events };
-    this.mediaPolicy = { ...DEFAULT_MEDIA_POLICY, ...options.mediaPolicy };
+    this.role = options.role ?? "host";
+    this.selfId = options.selfId || `anon-${Math.random().toString(36).slice(2, 10)}`;
+    this.mediaPolicy = this.role === "participant" ? {
+      ...DEFAULT_MEDIA_POLICY,
+      ...options.mediaPolicy,
+      audio: false,
+      video: false,
+      allowScreenShare: false,
+      screenOff: true
+    } : { ...DEFAULT_MEDIA_POLICY, ...options.mediaPolicy };
     this.media = new MediaController(this.mediaPolicy);
     this.protection = new ContentProtection(this.mediaPolicy);
   }
   get meetingId() {
     return this.options.meetingId;
   }
+  get meetingRole() {
+    return this.role;
+  }
   get connectionState() {
     return this.state;
   }
   getMediaState() {
     return this.media.getMediaState();
   }
+  getRemoteStream() {
+    return this.remoteStream;
+  }
   on(event, listener) {
     const set = this.listeners.get(event) ?? /* @__PURE__ */ new Set();
     set.add(listener);
@@ -734,7 +756,9 @@ var MeetingConnection = class {
         withCredentials: this.options.withCredentials !== false,
         auth,
         extraHeaders,
-        autoConnect: true
+        autoConnect: true,
+        // Leave must stay left — do not let socket.io reconnect the room.
+        reconnection: false
       });
       this.socket = socket;
       const onConnect = () => {
@@ -749,11 +773,22 @@ var MeetingConnection = class {
               meetingId: this.options.meetingId,
               ...mediaState
             });
+            if (this.role === "host") {
+              void this.refreshHostTracks();
+            }
           });
           this.captureUnsub = this.protection.onCaptureAttempt((event) => {
             this.emit("captureAttempt", event);
           });
-          await this.media.start(this.mediaPolicy);
+          if (this.role === "host") {
+            await this.media.start(this.mediaPolicy);
+          } else {
+            this.sendSignal({
+              type: "request-offer",
+              from: this.selfId,
+              role: "participant"
+            });
+          }
           resolve();
         }).catch(reject);
       };
@@ -777,24 +812,56 @@ var MeetingConnection = class {
     });
   }
   async setAudioEnabled(enabled) {
+    if (this.role !== "host") {
+      throw new SabhaError("Only the host can control the microphone", {
+        code: "HOST_ONLY"
+      });
+    }
     return this.media.setAudioEnabled(enabled);
   }
   async setVideoEnabled(enabled) {
+    if (this.role !== "host") {
+      throw new SabhaError("Only the host can control the camera", {
+        code: "HOST_ONLY"
+      });
+    }
     return this.media.setVideoEnabled(enabled);
   }
   async setScreenOff(off) {
+    if (this.role !== "host") {
+      throw new SabhaError("Only the host can change screen settings", {
+        code: "HOST_ONLY"
+      });
+    }
     return this.media.setScreenOff(off);
   }
   async startScreenShare() {
+    if (this.role !== "host") {
+      throw new SabhaError("Only the host can share screen", {
+        code: "HOST_ONLY"
+      });
+    }
     return this.media.startScreenShare();
   }
   async stopScreenShare() {
+    if (this.role !== "host") {
+      throw new SabhaError("Only the host can stop screen share", {
+        code: "HOST_ONLY"
+      });
+    }
     return this.media.stopScreenShare();
   }
   async leave() {
     const socket = this.socket;
     this.teardownMedia();
-    if (!socket) return;
+    if (!socket) {
+      this.setState("disconnected");
+      return;
+    }
+    try {
+      socket.io.reconnection(false);
+    } catch {
+    }
     await new Promise((resolve) => {
       socket.timeout(5e3).emit(
         this.events.leave,
@@ -803,13 +870,22 @@ var MeetingConnection = class {
       );
       setTimeout(() => resolve(), 500);
     });
+    socket.removeAllListeners();
     socket.disconnect();
     this.socket = null;
     this.setState("disconnected");
   }
   disconnect() {
     this.teardownMedia();
-    this.socket?.disconnect();
+    const socket = this.socket;
+    if (socket) {
+      try {
+        socket.io.reconnection(false);
+      } catch {
+      }
+      socket.removeAllListeners();
+      socket.disconnect();
+    }
     this.socket = null;
     this.setState("disconnected");
   }
@@ -826,6 +902,10 @@ var MeetingConnection = class {
     this.captureUnsub?.();
     this.mediaUnsub = null;
     this.captureUnsub = null;
+    for (const peer of this.peers.values()) peer.close();
+    this.peers.clear();
+    this.remoteStream = null;
+    this.emit("remoteStream", null);
     this.media.stopAll();
     this.protection.disable();
   }
@@ -846,7 +926,11 @@ var MeetingConnection = class {
       };
       socket.timeout(5e3).emit(
         this.events.join,
-        { meetingId: this.options.meetingId },
+        {
+          meetingId: this.options.meetingId,
+          role: this.role,
+          peerId: this.selfId
+        },
         () => done()
       );
       setTimeout(done, 600);
@@ -856,10 +940,19 @@ var MeetingConnection = class {
     socket.on(this.events.participantJoined, (payload) => {
       this.emit("participantJoined", payload);
       this.emit("raw", { event: this.events.participantJoined, payload });
+      if (this.role === "host") {
+        const peerId = payload.id;
+        if (peerId && peerId !== this.selfId) {
+          void this.createHostOffer(peerId).catch((error) => {
+            this.emit("error", toError(error, "Failed to create host offer"));
+          });
+        }
+      }
     });
     socket.on(this.events.participantLeft, (payload) => {
       this.emit("participantLeft", payload);
       this.emit("raw", { event: this.events.participantLeft, payload });
+      this.closePeer(payload.id);
     });
     socket.on(
       this.events.meetingEnded,
@@ -881,10 +974,135 @@ var MeetingConnection = class {
       this.emit("error", error);
       this.emit("raw", { event: this.events.error, payload });
     });
+    socket.on(SIGNAL_EVENT, (payload) => {
+      void this.handleSignal(payload).catch((error) => {
+        this.emit("error", toError(error, "WebRTC signal failed"));
+      });
+    });
     socket.on("disconnect", () => {
       this.setState("disconnected");
     });
   }
+  sendSignal(partial) {
+    if (!this.socket?.connected) return;
+    this.socket.emit(SIGNAL_EVENT, {
+      meetingId: this.options.meetingId,
+      ...partial
+    });
+  }
+  async handleSignal(payload) {
+    if (!payload || payload.meetingId !== this.options.meetingId) return;
+    if (payload.from === this.selfId) return;
+    if (payload.to && payload.to !== this.selfId) return;
+    if (payload.type === "request-offer" && this.role === "host") {
+      await this.createHostOffer(payload.from);
+      return;
+    }
+    if (payload.type === "offer" && this.role === "participant") {
+      const peer = this.getOrCreatePeer(payload.from, false);
+      await peer.setRemoteDescription(payload.sdp);
+      const answer = await peer.createAnswer();
+      await peer.setLocalDescription(answer);
+      this.sendSignal({
+        type: "answer",
+        from: this.selfId,
+        to: payload.from,
+        sdp: answer,
+        role: "participant"
+      });
+      return;
+    }
+    if (payload.type === "answer" && this.role === "host") {
+      const peer = this.peers.get(payload.from);
+      if (!peer) return;
+      await peer.setRemoteDescription(payload.sdp);
+      return;
+    }
+    if (payload.type === "ice") {
+      const peer = this.peers.get(payload.from);
+      if (!peer || !payload.candidate) return;
+      await peer.addIceCandidate(payload.candidate);
+    }
+  }
+  async createHostOffer(peerId) {
+    const peer = this.getOrCreatePeer(peerId, true);
+    await this.attachLocalTracks(peer);
+    const offer = await peer.createOffer({
+      offerToReceiveAudio: false,
+      offerToReceiveVideo: false
+    });
+    await peer.setLocalDescription(offer);
+    this.sendSignal({
+      type: "offer",
+      from: this.selfId,
+      to: peerId,
+      sdp: offer,
+      role: "host"
+    });
+  }
+  getOrCreatePeer(peerId, isHost) {
+    const existing = this.peers.get(peerId);
+    if (existing) return existing;
+    const peer = new RTCPeerConnection({ iceServers: ICE_SERVERS });
+    this.peers.set(peerId, peer);
+    peer.onicecandidate = (event) => {
+      this.sendSignal({
+        type: "ice",
+        from: this.selfId,
+        to: peerId,
+        candidate: event.candidate ? event.candidate.toJSON() : null,
+        role: this.role
+      });
+    };
+    peer.onconnectionstatechange = () => {
+      if (peer.connectionState === "failed" || peer.connectionState === "closed" || peer.connectionState === "disconnected") ;
+    };
+    if (!isHost) {
+      peer.ontrack = (event) => {
+        const stream = event.streams[0] ?? new MediaStream([event.track]);
+        this.remoteStream = stream;
+        this.emit("remoteStream", stream);
+      };
+    }
+    return peer;
+  }
+  async attachLocalTracks(peer) {
+    const local = new MediaStream();
+    const cam = this.media.getCameraStream();
+    const mic = this.media.getMicrophoneStream();
+    const screen = this.media.getScreenStream();
+    mic?.getAudioTracks().forEach((track) => local.addTrack(track));
+    const videoSource = screen ?? cam;
+    videoSource?.getVideoTracks().forEach((track) => local.addTrack(track));
+    const senders = peer.getSenders();
+    for (const track of local.getTracks()) {
+      const already = senders.some((s) => s.track?.id === track.id);
+      if (!already) peer.addTrack(track, local);
+    }
+  }
+  async refreshHostTracks() {
+    for (const [peerId, peer] of this.peers) {
+      try {
+        await this.attachLocalTracks(peer);
+        const offer = await peer.createOffer();
+        await peer.setLocalDescription(offer);
+        this.sendSignal({
+          type: "offer",
+          from: this.selfId,
+          to: peerId,
+          sdp: offer,
+          role: "host"
+        });
+      } catch {
+      }
+    }
+  }
+  closePeer(peerId) {
+    const peer = this.peers.get(peerId);
+    if (!peer) return;
+    peer.close();
+    this.peers.delete(peerId);
+  }
   setState(state) {
     this.state = state;
     this.emit("state", state);
@@ -895,6 +1113,10 @@ var MeetingConnection = class {
     for (const listener of set) listener(payload);
   }
 };
+function toError(error, fallback) {
+  if (error instanceof Error) return error;
+  return new Error(fallback);
+}
 
 // src/SabhaClient.ts
 var SabhaClient = class {
@@ -1110,15 +1332,16 @@ var SabhaClient = class {
         groupId: input?.groupId
       });
     }
-    const connection = await this.connect(meeting.id);
+    const connection = await this.connect(meeting.id, { role: "host" });
     return { meeting, connection };
   }
-  async connect(meetingId) {
+  async connect(meetingId, options) {
     this.ensureConfigured();
     if (this.activeConnection) {
       this.activeConnection.disconnect();
       this.activeConnection = null;
     }
+    const role = options?.role ?? "host";
     const connection = new MeetingConnection({
       baseUrl: this.config.baseUrl ?? DEFAULT_BASE_URL,
       meetingId,
@@ -1127,7 +1350,10 @@ var SabhaClient = class {
       withCredentials: this.config.withCredentials !== false,
       socketPath: this.config.socketPath,
       events: this.config.socketEvents,
-      mediaPolicy: this.mediaPolicy
+      mediaPolicy: this.mediaPolicy,
+      role,
+      // Per-browser id so same Sabha account can host on one device and view on another.
+      selfId: getDevicePeerId(this.user?.userId)
     });
     try {
       await connection.connect();
@@ -1222,6 +1448,18 @@ function createSabhaClient(config) {
   client.configure(config ?? { baseUrl: DEFAULT_BASE_URL });
   return client;
 }
+function getDevicePeerId(userId) {
+  const key = "sabha_device_peer_id";
+  try {
+    const existing = typeof sessionStorage !== "undefined" ? sessionStorage.getItem(key) : null;
+    if (existing) return existing;
+    const next = `${userId || "user"}-${Math.random().toString(36).slice(2, 10)}`;
+    if (typeof sessionStorage !== "undefined") sessionStorage.setItem(key, next);
+    return next;
+  } catch {
+    return `${userId || "user"}-${Math.random().toString(36).slice(2, 10)}`;
+  }
+}
 var SabhaContext = react.createContext(null);
 var idleMedia = {
   audioEnabled: false,
@@ -1284,7 +1522,13 @@ function SabhaProvider({
     }
     setConnectionState(connection.connectionState);
     setMediaState(connection.getMediaState());
-    const offState = connection.on("state", setConnectionState);
+    const offState = connection.on("state", (state) => {
+      setConnectionState(state);
+      if (state === "disconnected" || state === "error") {
+        setConnection(null);
+        setMediaState(idleMedia);
+      }
+    });
     const offMedia = connection.on("mediaState", setMediaState);
     return () => {
       offState();
@@ -1378,10 +1622,10 @@ function SabhaProvider({
     [client, connection]
   );
   const connect = react.useCallback(
-    async (meetingId) => {
+    async (meetingId, options) => {
       setError(null);
       try {
-        const next = await client.connect(meetingId);
+        const next = await client.connect(meetingId, options);
         setConnection(next);
         return next;
       } catch (err) {