sabha-meetings-react 0.1.5 → 0.1.9

package/dist/index.d.mts

@@ -2,10 +2,11 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 
 type SabhaTokens = {
-    /** Optional bearer token (Postman-style). Live API primarily uses `vm_session` cookie. */
+    /** Bearer access token from login `token` (Postman `accessToken`). */
     accessToken?: string;
+    /** Refresh token from login `refreshToken` (Postman). */
     refreshToken?: string;
-    /** Session cookie value when running outside the browser (Node / RN). */
+    /** Optional legacy `vm_session` cookie / x-sabha-session bridge. */
     sessionCookie?: string;
 };
 type SabhaConfig = {
@@ -19,11 +20,11 @@ type SabhaConfig = {
     /** Optional bearer access token */
     accessToken?: string;
     refreshToken?: string;
-    /** Persist/reuse `vm_session` (also sent as x-sabha-session for proxies). */
+    /** Optional legacy `vm_session` (also sent as x-sabha-session for proxies). */
     sessionCookie?: string;
     /**
-     * Persist `vm_session` in localStorage after login and restore on configure.
-     * Default true in browsers.
+     * Persist access/refresh tokens (and optional vm_session) after login and restore on configure.
+     * Matches Postman collection variables. Default true.
      */
     persistSession?: boolean;
     /** Send cookies (`credentials: "include"`). Default true. */
@@ -145,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;
@@ -187,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;
@@ -268,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;
@@ -275,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>;
@@ -297,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;
 }
@@ -343,10 +366,13 @@ 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;
+    private persistTokens;
     private persistSessionCookie;
     private tryRefresh;
     private getOrigin;
@@ -405,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;
@@ -435,9 +463,14 @@ declare function normalizeMeeting(raw: unknown): Meeting;
 
 /** Readable session bridge header (browsers cannot set the Cookie request header). */
 declare const SABHA_SESSION_HEADER = "x-sabha-session";
+/** @deprecated Prefer SABHA_TOKENS_STORAGE_KEY — kept for one-time migration. */
 declare const SABHA_SESSION_STORAGE_KEY = "sabha_vm_session";
+/** Persists Postman-style `accessToken` / `refreshToken` (+ optional vm_session). */
+declare const SABHA_TOKENS_STORAGE_KEY = "sabha_auth_tokens";
+declare function readStoredTokens(): SabhaTokens | null;
+declare function writeStoredTokens(tokens: SabhaTokens | null): void;
 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, SabhaClient, SabhaError, SabhaProvider, createSabhaClient, normalizeMeeting, readStoredSessionCookie, toSabhaError, useSabha, useSabhaMeetings, writeStoredSessionCookie };
-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 { 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, MeetingRole, MeetingRoomEventMap, RegisterInput, SabhaClientStatus, SabhaConfig, SabhaContextValue, SabhaOrg, SabhaProviderProps, SabhaSocketEvents, SabhaTokens, UpdateMeetingInput, VerifyEmailInput };

package/dist/index.d.ts

@@ -2,10 +2,11 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 
 type SabhaTokens = {
-    /** Optional bearer token (Postman-style). Live API primarily uses `vm_session` cookie. */
+    /** Bearer access token from login `token` (Postman `accessToken`). */
     accessToken?: string;
+    /** Refresh token from login `refreshToken` (Postman). */
     refreshToken?: string;
-    /** Session cookie value when running outside the browser (Node / RN). */
+    /** Optional legacy `vm_session` cookie / x-sabha-session bridge. */
     sessionCookie?: string;
 };
 type SabhaConfig = {
@@ -19,11 +20,11 @@ type SabhaConfig = {
     /** Optional bearer access token */
     accessToken?: string;
     refreshToken?: string;
-    /** Persist/reuse `vm_session` (also sent as x-sabha-session for proxies). */
+    /** Optional legacy `vm_session` (also sent as x-sabha-session for proxies). */
     sessionCookie?: string;
     /**
-     * Persist `vm_session` in localStorage after login and restore on configure.
-     * Default true in browsers.
+     * Persist access/refresh tokens (and optional vm_session) after login and restore on configure.
+     * Matches Postman collection variables. Default true.
      */
     persistSession?: boolean;
     /** Send cookies (`credentials: "include"`). Default true. */
@@ -145,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;
@@ -187,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;
@@ -268,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;
@@ -275,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>;
@@ -297,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;
 }
@@ -343,10 +366,13 @@ 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;
+    private persistTokens;
     private persistSessionCookie;
     private tryRefresh;
     private getOrigin;
@@ -405,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;
@@ -435,9 +463,14 @@ declare function normalizeMeeting(raw: unknown): Meeting;
 
 /** Readable session bridge header (browsers cannot set the Cookie request header). */
 declare const SABHA_SESSION_HEADER = "x-sabha-session";
+/** @deprecated Prefer SABHA_TOKENS_STORAGE_KEY — kept for one-time migration. */
 declare const SABHA_SESSION_STORAGE_KEY = "sabha_vm_session";
+/** Persists Postman-style `accessToken` / `refreshToken` (+ optional vm_session). */
+declare const SABHA_TOKENS_STORAGE_KEY = "sabha_auth_tokens";
+declare function readStoredTokens(): SabhaTokens | null;
+declare function writeStoredTokens(tokens: SabhaTokens | null): void;
 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, SabhaClient, SabhaError, SabhaProvider, createSabhaClient, normalizeMeeting, readStoredSessionCookie, toSabhaError, useSabha, useSabhaMeetings, writeStoredSessionCookie };
-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 { 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, MeetingRole, MeetingRoomEventMap, RegisterInput, SabhaClientStatus, SabhaConfig, SabhaContextValue, SabhaOrg, SabhaProviderProps, SabhaSocketEvents, SabhaTokens, UpdateMeetingInput, VerifyEmailInput };