@droponair/sdk-js 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -6,6 +6,77 @@ This project follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.7.0], 2026-05-19
+
+### Added
+- **Conference moderation and waiting room.** Host designated to the call
+  initiator and transferable mid-call; host can appoint co-hosts. Host and
+  co-host can mute and remove participants and admit / reject users from a
+  waiting room. If the host leaves without transferring, the server
+  auto-promotes the longest-joined remaining participant.
+- New `client` methods:
+  - `transferHost(callId, groupId, newHostUserId)`
+  - `appointCoHost(callId, groupId, userId)` / `revokeCoHost(callId, groupId, userId)`
+  - `muteParticipant(callId, groupId, targetUserId)` (signaling hint; the
+    target SDK applies the mute locally)
+  - `removeParticipant(callId, groupId, targetUserId)` (server-enforced; the
+    target is dropped from the call session)
+  - `requestWaitingRoomEntry(callId, groupId)` (would-be joiner side)
+  - `admitFromWaitingRoom(callId, groupId, userId)` / `rejectFromWaitingRoom(callId, groupId, userId)`
+- New `GroupCallEventType` values: `'GROUP_CALL_HOST_TRANSFER'`,
+  `'GROUP_CALL_COHOST_APPOINT'`, `'GROUP_CALL_COHOST_REVOKE'`,
+  `'GROUP_CALL_ROLE_CHANGED'`, `'GROUP_CALL_MUTE_PARTICIPANT'`,
+  `'GROUP_CALL_REMOVE_PARTICIPANT'`, `'GROUP_CALL_PARTICIPANT_REMOVED'`,
+  `'GROUP_CALL_WAITING_ROOM_REQUEST'`, `'GROUP_CALL_WAITING_ROOM_JOINED'`,
+  `'GROUP_CALL_WAITING_ROOM_ADMIT'`, `'GROUP_CALL_WAITING_ROOM_ADMITTED'`,
+  `'GROUP_CALL_WAITING_ROOM_REJECT'`, `'GROUP_CALL_WAITING_ROOM_REJECTED'`.
+- `GET /api/info` now advertises `"moderation"` in the `features` array.
+
+### Notes
+- Wire-level additive: legacy 0.6.x clients ignore the new signal type
+  strings (string discriminators on the existing `GroupCallFrame.type`).
+  No proto schema change, no `PROTOCOL_VERSION` bump.
+- Availability depends on your plan. See the
+  [pricing page](https://www.droponair.com/pricing) and your dashboard
+  Subscription page for what's enabled on your app.
+
+---
+
+## [0.6.0], 2026-05-18
+
+### Added
+- **Screen sharing signaling.** New client APIs and event types so apps can
+  coordinate the start/stop of a screen-share track on top of the existing
+  WebRTC call. The SDK only signals - capture (`getDisplayMedia()` on web) and
+  track management remain in the app layer.
+- **1:1 calls:**
+  - `client.startScreenShare(callId, payload?)` and `client.stopScreenShare(callId, payload?)`.
+  - New `CallEventType` values: `'CALL_SCREEN_SHARE_STARTED'`, `'CALL_SCREEN_SHARE_STOPPED'`.
+- **Group calls:**
+  - `client.startGroupScreenShare(callId, groupId, payload?)` and `client.stopGroupScreenShare(callId, groupId, payload?)`.
+  - New `GroupCallEventType` values: `'GROUP_CALL_SCREEN_SHARE_STARTED'`, `'GROUP_CALL_SCREEN_SHARE_STOPPED'`.
+  - Server enforces a single concurrent sharer per group call. If another
+    participant already holds the slot when you call `startGroupScreenShare`,
+    you'll receive a `GROUP_CALL_SCREEN_SHARE_STOPPED` event with the current
+    holder's userId in `payload`, so the app can roll back its optimistic UI.
+  - When a sharer leaves the call, the server broadcasts a STOPPED event to
+    remaining participants before they see `PARTICIPANT_LEFT`.
+- `GET /api/info` now advertises `"screen_sharing"` in the `features` array.
+
+### Notes
+- Wire-level additive: legacy 0.5.x clients ignore the new signal type strings
+  (string discriminators on existing `CallFrame.type` / `GroupCallFrame.type`).
+  No proto schema change, no `PROTOCOL_VERSION` bump.
+- Screen content is opaque WebRTC media; the server never sees it. Use
+  `getDisplayMedia()` (web) / `MediaProjection` (Android) / `ReplayKit` (iOS)
+  in the app, add the track to the existing peer connection, then call
+  `startScreenShare(...)` to notify the peer.
+- Plan gate: `screen_sharing` is enabled on PRO/GROWTH/PAYG/ENTERPRISE and
+  disabled on FREE. Check `subscription.featuresEnabled.screen_sharing` (server
+  side, on the customer's backend).
+
+---
+
 ## [0.5.0], 2026-05-18
 
 ### Added

package/README.md

@@ -160,7 +160,7 @@ client.onMessage(async (msg) => {
 | `sendMessage(toUserId, text, { attachments })` | `Promise<{ messageId }>` | Send with attachments |
 
 - E2EE: a random AES-256-GCM file key encrypts the bytes; the file key is wrapped per recipient device using X25519 + HKDF (same model as message payloads). Server never sees the unwrapped file key.
-- Plan limits: `maxAttachmentSizeMb` per file + `maxAttachmentsPerMonth`. Enforced server-side before the presigned URL is issued.
+- Availability and per-file / per-month limits depend on your plan and are enforced server-side before the presigned URL is issued. See the [pricing page](https://www.droponair.com/pricing) and your dashboard Subscription page for what's enabled on your app.
 - Upload URL TTL = 15 min. Download URL TTL = 5 min. Download authorization checks that the requester is the original sender or in the captured recipient list.
 
 ### Broadcast Channels
@@ -209,6 +209,90 @@ client.onMessage(async (msg) => {
 | `sendGroupCallSignal(type, callId, groupId, targetUserId, payload)` | `void` | Send SDP/ICE to a peer |
 | `onGroupCallEvent(callback)` | `() => void` | Listen for group call events |
 
+### Screen Sharing
+
+Available since SDK `0.6.0`. The SDK only signals start/stop - capture (via the browser's `getDisplayMedia()`) and adding the resulting `MediaStreamTrack` to the existing peer connection are the app's responsibility.
+
+```typescript
+// 1:1 call
+async function shareMyScreen(callId: string, peerConnection: RTCPeerConnection) {
+  const stream = await navigator.mediaDevices.getDisplayMedia({ video: true });
+  const track  = stream.getVideoTracks()[0];
+  peerConnection.addTrack(track, stream);
+  client.startScreenShare(callId);
+  track.onended = () => client.stopScreenShare(callId);
+}
+
+// Group call
+async function shareMyScreenInGroup(callId: string, groupId: string, peerConnections: RTCPeerConnection[]) {
+  const stream = await navigator.mediaDevices.getDisplayMedia({ video: true });
+  const track  = stream.getVideoTracks()[0];
+  peerConnections.forEach(pc => pc.addTrack(track, stream));
+  client.startGroupScreenShare(callId, groupId);
+  track.onended = () => client.stopGroupScreenShare(callId, groupId);
+}
+
+client.onCallEvent((evt) => {
+  if (evt.type === 'CALL_SCREEN_SHARE_STARTED')  showShareIndicator(evt.callId);
+  if (evt.type === 'CALL_SCREEN_SHARE_STOPPED')  hideShareIndicator(evt.callId);
+});
+
+client.onGroupCallEvent((evt) => {
+  if (evt.type === 'GROUP_CALL_SCREEN_SHARE_STARTED')  showShareIndicator(evt.callId, evt.payload);  // payload = sharer userId
+  if (evt.type === 'GROUP_CALL_SCREEN_SHARE_STOPPED')  hideShareIndicator(evt.callId);
+});
+```
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `startScreenShare(callId, payload?)` | `void` | Signal start in a 1:1 call |
+| `stopScreenShare(callId, payload?)` | `void` | Signal stop in a 1:1 call |
+| `startGroupScreenShare(callId, groupId, payload?)` | `void` | Signal start in a group call |
+| `stopGroupScreenShare(callId, groupId, payload?)` | `void` | Signal stop in a group call |
+
+- The server enforces **one concurrent sharer per group call**. If another participant already holds the slot when you call `startGroupScreenShare`, the SDK delivers a `GROUP_CALL_SCREEN_SHARE_STOPPED` event with the current holder's userId in `payload`, so you can roll back the optimistic UI.
+- When a sharer leaves the call, the server broadcasts a STOPPED event to remaining participants before they see `PARTICIPANT_LEFT`.
+- Availability depends on your plan. See the [pricing page](https://www.droponair.com/pricing) and your dashboard Subscription page for what's enabled on your app.
+
+### Conference moderation and waiting room
+
+Available since SDK `0.7.0`. The call initiator is the default host; host can transfer the role mid-call or appoint co-hosts. Host and co-host can mute, remove, and gate joiners through a waiting room. If the host leaves without transferring, the server auto-promotes the longest-joined remaining participant and broadcasts `GROUP_CALL_ROLE_CHANGED`.
+
+```typescript
+// Host actions
+client.transferHost(callId, groupId, 'alice');
+client.appointCoHost(callId, groupId, 'bob');
+client.muteParticipant(callId, groupId, 'eve');           // signaling hint
+client.removeParticipant(callId, groupId, 'mallory');     // server-enforced drop
+
+// Waiting room
+client.requestWaitingRoomEntry(callId, groupId);          // would-be joiner side
+client.admitFromWaitingRoom(callId, groupId, 'newbie');   // host / co-host
+client.rejectFromWaitingRoom(callId, groupId, 'troll');
+
+client.onGroupCallEvent((evt) => {
+  if (evt.type === 'GROUP_CALL_ROLE_CHANGED')          updateHostUi(evt.payload);   // {"userId":"...","role":"HOST|CO_HOST|PARTICIPANT"}
+  if (evt.type === 'GROUP_CALL_WAITING_ROOM_JOINED')   showWaitingApprovalPrompt(evt.payload);
+  if (evt.type === 'GROUP_CALL_WAITING_ROOM_ADMITTED') joinTheCall(evt.callId, evt.groupId);
+  if (evt.type === 'GROUP_CALL_MUTE_PARTICIPANT')      muteMyMicLocally();
+  if (evt.type === 'GROUP_CALL_PARTICIPANT_REMOVED')   exitCallUi();
+});
+```
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `transferHost(callId, groupId, newHostUserId)` | `void` | Host only |
+| `appointCoHost(callId, groupId, userId)` | `void` | Host only |
+| `revokeCoHost(callId, groupId, userId)` | `void` | Host only |
+| `muteParticipant(callId, groupId, targetUserId)` | `void` | Host / co-host. Signaling hint - the target SDK mutes the local mic. |
+| `removeParticipant(callId, groupId, targetUserId)` | `void` | Host / co-host. Server drops the target from the call session. |
+| `requestWaitingRoomEntry(callId, groupId)` | `void` | Would-be joiner |
+| `admitFromWaitingRoom(callId, groupId, userId)` | `void` | Host / co-host |
+| `rejectFromWaitingRoom(callId, groupId, userId)` | `void` | Host / co-host |
+
+- Mute is intentionally a signaling hint: WebRTC media tracks can't be muted from outside the producing client. Remove is server-enforced - the target SDK receives `GROUP_CALL_PARTICIPANT_REMOVED` and the others receive `PARTICIPANT_LEFT`.
+- Availability depends on your plan. See the [pricing page](https://www.droponair.com/pricing) and your dashboard Subscription page for what's enabled on your app.
+
 ## Security
 
 - **X25519 ECDH** key agreement for shared secrets

package/dist/attachment/attachment-client.d.ts

@@ -21,8 +21,8 @@ interface AttachmentClientDeps {
     logError: (stage: string, data?: Record<string, unknown>) => void;
 }
 /**
- * SDK-side coordinator for phase1/attachments. Handles:
- *  - createUploadSession: reserves an attachmentId + presigned PUT URL via sdk-be.
+ * SDK-side coordinator for attachments. Handles:
+ *  - createUploadSession: reserves an attachmentId + presigned PUT URL.
  *  - uploadBytes: PUTs bytes directly to the customer's bucket.
  *  - finalize: confirms upload + commits sha256.
  *  - prepareAttachmentAndUpload: convenience wrapper that does upload session,

package/dist/attachment/attachment-client.js

@@ -20,8 +20,8 @@ async function sha256Hex(bytes) {
     return hex.join('');
 }
 /**
- * SDK-side coordinator for phase1/attachments. Handles:
- *  - createUploadSession: reserves an attachmentId + presigned PUT URL via sdk-be.
+ * SDK-side coordinator for attachments. Handles:
+ *  - createUploadSession: reserves an attachmentId + presigned PUT URL.
  *  - uploadBytes: PUTs bytes directly to the customer's bucket.
  *  - finalize: confirms upload + commits sha256.
  *  - prepareAttachmentAndUpload: convenience wrapper that does upload session,

package/dist/attachment/attachment-types.js

@@ -4,7 +4,7 @@
 //
 // DropOnAir never holds file bytes. The SDK uploads/downloads directly
 // against the customer's storage bucket via short-lived presigned URLs
-// minted by sdk-be. For E2EE messages a per-attachment AES-256-GCM file
+// minted by the DropOnAir platform. For E2EE messages a per-attachment AES-256-GCM file
 // key is wrapped per recipient device using the same X25519 + HKDF path
 // used for message payloads.
 // ---------------------------------------------------------------------------

package/dist/core/messaging-client.d.ts

@@ -136,7 +136,17 @@ export declare class MessagingClient implements DropOnAirClient {
     leaveGroupCall(callId: string): Promise<void>;
     endGroupCall(callId: string): Promise<void>;
     sendGroupCallSignal(type: 'GROUP_CALL_SDP_OFFER' | 'GROUP_CALL_SDP_ANSWER' | 'GROUP_CALL_ICE_CANDIDATE', callId: string, groupId: string, targetUserId: string, payload: string): void;
+    startGroupScreenShare(callId: string, groupId: string, payload?: string): void;
+    stopGroupScreenShare(callId: string, groupId: string, payload?: string): void;
     onGroupCallEvent(callback: GroupCallEventCallback): () => void;
+    transferHost(callId: string, groupId: string, newHostUserId: string): void;
+    appointCoHost(callId: string, groupId: string, userId: string): void;
+    revokeCoHost(callId: string, groupId: string, userId: string): void;
+    muteParticipant(callId: string, groupId: string, targetUserId: string): void;
+    removeParticipant(callId: string, groupId: string, targetUserId: string): void;
+    requestWaitingRoomEntry(callId: string, groupId: string): void;
+    admitFromWaitingRoom(callId: string, groupId: string, userId: string): void;
+    rejectFromWaitingRoom(callId: string, groupId: string, userId: string): void;
     private sendGroupCallFrame;
     /**
      * Initiate an outgoing call.
@@ -149,6 +159,8 @@ export declare class MessagingClient implements DropOnAirClient {
     endCall(callId: string): Promise<void>;
     toggleVideo(callId: string, enabled: boolean): void;
     sendCallSignal(type: 'CALL_SDP_OFFER' | 'CALL_SDP_ANSWER' | 'CALL_ICE_CANDIDATE', callId: string, payload: string): void;
+    startScreenShare(callId: string, payload?: string): void;
+    stopScreenShare(callId: string, payload?: string): void;
     fetchTurnCredentials(): Promise<TurnCredentials>;
     private sendCallFrame;
     private emitCallEvent;

package/dist/core/messaging-client.js

@@ -254,7 +254,7 @@ class MessagingClient {
             logError: (stage, data) => this.logError(stage, data),
         });
     }
-    // Attachment API (phase1/attachments, PROTOCOL_VERSION 4+)
+    // Attachment API (PROTOCOL_VERSION 4+)
     async prepareAttachmentAndUpload(bytes, options) {
         return this.attachmentClient.prepareAttachmentAndUpload(bytes, options);
     }
@@ -740,10 +740,103 @@ class MessagingClient {
     sendGroupCallSignal(type, callId, groupId, targetUserId, payload) {
         this.sendGroupCallFrame({ type, callId, groupId, targetUserId, payload });
     }
+    startGroupScreenShare(callId, groupId, payload) {
+        this.sendGroupCallFrame({
+            type: 'GROUP_CALL_SCREEN_SHARE_STARTED',
+            callId,
+            groupId,
+            targetUserId: '',
+            payload: payload ?? '',
+        });
+    }
+    stopGroupScreenShare(callId, groupId, payload) {
+        this.sendGroupCallFrame({
+            type: 'GROUP_CALL_SCREEN_SHARE_STOPPED',
+            callId,
+            groupId,
+            targetUserId: '',
+            payload: payload ?? '',
+        });
+    }
     onGroupCallEvent(callback) {
         this.groupCallListeners.add(callback);
         return () => this.groupCallListeners.delete(callback);
     }
+    // Group call moderation + waiting room. The server validates host/co-host
+    // authority and the `featuresEnabled.moderation` plan flag; on denial it
+    // emits a LIMIT_REACHED event with reason="MODERATION_NOT_ENABLED".
+    transferHost(callId, groupId, newHostUserId) {
+        this.sendGroupCallFrame({
+            type: 'GROUP_CALL_HOST_TRANSFER',
+            callId,
+            groupId,
+            targetUserId: '',
+            payload: JSON.stringify({ userId: newHostUserId }),
+        });
+    }
+    appointCoHost(callId, groupId, userId) {
+        this.sendGroupCallFrame({
+            type: 'GROUP_CALL_COHOST_APPOINT',
+            callId,
+            groupId,
+            targetUserId: '',
+            payload: JSON.stringify({ userId }),
+        });
+    }
+    revokeCoHost(callId, groupId, userId) {
+        this.sendGroupCallFrame({
+            type: 'GROUP_CALL_COHOST_REVOKE',
+            callId,
+            groupId,
+            targetUserId: '',
+            payload: JSON.stringify({ userId }),
+        });
+    }
+    muteParticipant(callId, groupId, targetUserId) {
+        this.sendGroupCallFrame({
+            type: 'GROUP_CALL_MUTE_PARTICIPANT',
+            callId,
+            groupId,
+            targetUserId: '',
+            payload: JSON.stringify({ targetUserId }),
+        });
+    }
+    removeParticipant(callId, groupId, targetUserId) {
+        this.sendGroupCallFrame({
+            type: 'GROUP_CALL_REMOVE_PARTICIPANT',
+            callId,
+            groupId,
+            targetUserId: '',
+            payload: JSON.stringify({ targetUserId }),
+        });
+    }
+    requestWaitingRoomEntry(callId, groupId) {
+        this.sendGroupCallFrame({
+            type: 'GROUP_CALL_WAITING_ROOM_REQUEST',
+            callId,
+            groupId,
+            targetUserId: '',
+            payload: '',
+        });
+    }
+    admitFromWaitingRoom(callId, groupId, userId) {
+        this.sendGroupCallFrame({
+            type: 'GROUP_CALL_WAITING_ROOM_ADMIT',
+            callId,
+            groupId,
+            targetUserId: '',
+            payload: JSON.stringify({ userId }),
+        });
+    }
+    rejectFromWaitingRoom(callId, groupId, userId) {
+        this.sendGroupCallFrame({
+            type: 'GROUP_CALL_WAITING_ROOM_REJECT',
+            callId,
+            groupId,
+            targetUserId: '',
+            payload: JSON.stringify({ userId }),
+        });
+    }
     sendGroupCallFrame(frame) {
         if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
             throw new Error('DropOnAir websocket is not connected');
@@ -781,6 +874,12 @@ class MessagingClient {
     sendCallSignal(type, callId, payload) {
         this.sendCallFrame({ type, callId, payload });
     }
+    startScreenShare(callId, payload) {
+        this.sendCallFrame({ type: 'CALL_SCREEN_SHARE_STARTED', callId, payload: payload ?? '' });
+    }
+    stopScreenShare(callId, payload) {
+        this.sendCallFrame({ type: 'CALL_SCREEN_SHARE_STOPPED', callId, payload: payload ?? '' });
+    }
     async fetchTurnCredentials() {
         const jwt = await this.getValidDropOnAirJwt(false);
         const url = `${this.httpUrl}/api/v1/turn/credentials`;

package/dist/core/types.d.ts

@@ -11,7 +11,7 @@ export interface DecryptedMessage {
     timestamp: number;
     plaintext: string;
     /**
-     * Attachment pointers (phase1/attachments, PROTOCOL_VERSION 4+).
+     * Attachment pointers (PROTOCOL_VERSION 4+).
      * Empty/undefined for messages with no attachments. To fetch and decrypt the
      * bytes, call {@code client.downloadAttachment(ref)}.
      */
@@ -57,7 +57,7 @@ export interface BroadcastMessage {
     sequenceNumber: number;
 }
 export type BroadcastCallback = (message: BroadcastMessage) => void;
-export type CallEventType = 'CALL_INVITE' | 'CALL_RINGING' | 'CALL_ACCEPTED' | 'CALL_REJECTED' | 'CALL_ENDED' | 'CALL_CANCELLED' | 'CALL_SDP_OFFER' | 'CALL_SDP_ANSWER' | 'CALL_ICE_CANDIDATE' | 'CALL_VIDEO_TOGGLE' | 'CALL_DENIED_LIMIT_REACHED';
+export type CallEventType = 'CALL_INVITE' | 'CALL_RINGING' | 'CALL_ACCEPTED' | 'CALL_REJECTED' | 'CALL_ENDED' | 'CALL_CANCELLED' | 'CALL_SDP_OFFER' | 'CALL_SDP_ANSWER' | 'CALL_ICE_CANDIDATE' | 'CALL_VIDEO_TOGGLE' | 'CALL_SCREEN_SHARE_STARTED' | 'CALL_SCREEN_SHARE_STOPPED' | 'CALL_DENIED_LIMIT_REACHED';
 export interface CallEvent {
     type: CallEventType | string;
     callId?: string;
@@ -92,7 +92,7 @@ export interface DecryptedGroupMessage {
     plaintext: string;
 }
 export type GroupMessageCallback = (message: DecryptedGroupMessage) => void;
-export type GroupCallEventType = 'GROUP_CALL_INVITE' | 'GROUP_CALL_RINGING' | 'GROUP_CALL_JOIN' | 'GROUP_CALL_LEAVE' | 'GROUP_CALL_END' | 'GROUP_CALL_ENDED' | 'GROUP_CALL_PARTICIPANT_JOINED' | 'GROUP_CALL_PARTICIPANT_LEFT' | 'GROUP_CALL_ALREADY_ACTIVE' | 'GROUP_CALL_SDP_OFFER' | 'GROUP_CALL_SDP_ANSWER' | 'GROUP_CALL_ICE_CANDIDATE';
+export type GroupCallEventType = 'GROUP_CALL_INVITE' | 'GROUP_CALL_RINGING' | 'GROUP_CALL_JOIN' | 'GROUP_CALL_LEAVE' | 'GROUP_CALL_END' | 'GROUP_CALL_ENDED' | 'GROUP_CALL_PARTICIPANT_JOINED' | 'GROUP_CALL_PARTICIPANT_LEFT' | 'GROUP_CALL_PARTICIPANT_REMOVED' | 'GROUP_CALL_ALREADY_ACTIVE' | 'GROUP_CALL_SDP_OFFER' | 'GROUP_CALL_SDP_ANSWER' | 'GROUP_CALL_ICE_CANDIDATE' | 'GROUP_CALL_SCREEN_SHARE_STARTED' | 'GROUP_CALL_SCREEN_SHARE_STOPPED' | 'GROUP_CALL_HOST_TRANSFER' | 'GROUP_CALL_COHOST_APPOINT' | 'GROUP_CALL_COHOST_REVOKE' | 'GROUP_CALL_ROLE_CHANGED' | 'GROUP_CALL_MUTE_PARTICIPANT' | 'GROUP_CALL_REMOVE_PARTICIPANT' | 'GROUP_CALL_WAITING_ROOM_REQUEST' | 'GROUP_CALL_WAITING_ROOM_JOINED' | 'GROUP_CALL_WAITING_ROOM_ADMIT' | 'GROUP_CALL_WAITING_ROOM_ADMITTED' | 'GROUP_CALL_WAITING_ROOM_REJECT' | 'GROUP_CALL_WAITING_ROOM_REJECTED';
 export interface GroupCallEvent {
     type: GroupCallEventType | string;
     callId: string;
@@ -212,6 +212,16 @@ export interface DropOnAirClient {
      * The payload is forwarded opaquely, the server does NOT inspect or store it.
      */
     sendCallSignal(type: 'CALL_SDP_OFFER' | 'CALL_SDP_ANSWER' | 'CALL_ICE_CANDIDATE', callId: string, payload: string): void;
+    /**
+     * Signal that this user started sharing their screen in a 1:1 call
+     * (PROTOCOL_VERSION 4+). The actual screen MediaStreamTrack
+     * is added to the existing peer connection by the application; the SDK only
+     * broadcasts the start/stop notification so the remote SDK can update its UI.
+     * Optional `payload` (JSON string) can carry track-id or app-specific metadata.
+     */
+    startScreenShare(callId: string, payload?: string): void;
+    /** Signal that this user stopped sharing their screen in a 1:1 call. */
+    stopScreenShare(callId: string, payload?: string): void;
     /** Register a listener for all incoming call events. Returns an unsubscribe function. */
     onCallEvent(callback: CallEventCallback): () => void;
     /** Fetch short-lived TURN credentials for ICE negotiation. */
@@ -244,6 +254,32 @@ export interface DropOnAirClient {
     endGroupCall(callId: string): Promise<void>;
     /** Send a signaling frame to a specific peer in a group call. */
     sendGroupCallSignal(type: 'GROUP_CALL_SDP_OFFER' | 'GROUP_CALL_SDP_ANSWER' | 'GROUP_CALL_ICE_CANDIDATE', callId: string, groupId: string, targetUserId: string, payload: string): void;
+    /**
+     * Signal that this user started sharing their screen in a group call.
+     * The server enforces one concurrent sharer per group call; if another
+     * participant already holds the slot, the SDK will receive a
+     * `GROUP_CALL_SCREEN_SHARE_STOPPED` event echoing the current holder's
+     * userId in `payload` so the app can roll back its optimistic UI.
+     */
+    startGroupScreenShare(callId: string, groupId: string, payload?: string): void;
+    /** Signal that this user stopped sharing their screen in a group call. */
+    stopGroupScreenShare(callId: string, groupId: string, payload?: string): void;
     /** Register a listener for group call events. Returns an unsubscribe function. */
     onGroupCallEvent(callback: GroupCallEventCallback): () => void;
+    /** Transfer host to another participant (current host only). */
+    transferHost(callId: string, groupId: string, newHostUserId: string): void;
+    /** Appoint a participant as co-host (host only). */
+    appointCoHost(callId: string, groupId: string, userId: string): void;
+    /** Revoke a participant's co-host status (host only). */
+    revokeCoHost(callId: string, groupId: string, userId: string): void;
+    /** Mute a participant's mic (host / co-host). Signaling hint; the target SDK applies it locally. */
+    muteParticipant(callId: string, groupId: string, targetUserId: string): void;
+    /** Remove a participant from the call (host / co-host). Server-enforced. */
+    removeParticipant(callId: string, groupId: string, targetUserId: string): void;
+    /** Request entry into a call's waiting room. Sent by would-be joiners; host receives WAITING_ROOM_JOINED. */
+    requestWaitingRoomEntry(callId: string, groupId: string): void;
+    /** Admit a user from the waiting room (host / co-host). */
+    admitFromWaitingRoom(callId: string, groupId: string, userId: string): void;
+    /** Reject a user waiting to join (host / co-host). */
+    rejectFromWaitingRoom(callId: string, groupId: string, userId: string): void;
 }

package/dist/version.d.ts

@@ -7,7 +7,7 @@
  *   MINOR, additive feature (e.g. multi-device payloads, new call event type)
  *   PATCH, bug-fix / perf improvement with no wire or API change
  */
-export declare const SDK_VERSION = "0.5.0";
+export declare const SDK_VERSION = "0.7.0";
 /**
  * Binary encrypted-payload format version.
  * Included as the first byte of every encrypted payload so receivers can

package/dist/version.js

@@ -10,7 +10,7 @@ exports.PROTOCOL_VERSION = exports.PAYLOAD_FORMAT_VERSION = exports.SDK_VERSION
  *   MINOR, additive feature (e.g. multi-device payloads, new call event type)
  *   PATCH, bug-fix / perf improvement with no wire or API change
  */
-exports.SDK_VERSION = '0.5.0';
+exports.SDK_VERSION = '0.7.0';
 /**
  * Binary encrypted-payload format version.
  * Included as the first byte of every encrypted payload so receivers can

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@droponair/sdk-js",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "DropOnAir SDK for end-to-end encrypted messaging",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",