@droponair/sdk-js 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -6,6 +6,28 @@ This project follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.14.0], 2026-05-21
+
+### Added
+
+- **Scheduled & persistent rooms.** New `createRoom` / `listRooms` / `getRoom` / `updateRoom` / `deleteRoom` REST methods and `joinRoom(roomId)` / `leaveRoom(callId)`. A room is an addressable container a live multi-party call runs inside - it is not tied to a group's member roster. Per-room `policy` knobs (`waitingRoom`, `requireHost`, `maxParticipants`, `autoCloseWhenEmpty`) and optional `scheduledStartAt` / `scheduledEndAt` metadata let you compose scheduled or persistent meetings; the platform imposes no meeting model.
+- `joinRoom` resolves with a callId that works with the existing group-call signaling methods (`sendGroupCallSignal`, screen-share, moderation, `leaveGroupCall`) - pass an empty string for `groupId`. Room-call events arrive via `onGroupCallEvent` and carry `roomId`.
+- New `Room`, `RoomPolicy`, `CreateRoomOptions`, `UpdateRoomOptions` types.
+
+### Notes
+
+- Additive only. The live room call reuses the group-call mesh; on the wire it is the existing `GroupCallFrame` with the new optional `roomId` field. No PROTOCOL_VERSION change.
+
+---
+
+## [0.13.1], 2026-05-21
+
+### Changed
+
+- **`revokeAttachment` accepts an `AttachmentRef`.** Calling `revokeAttachment(ref)` now also revokes the linked preview thumbnail (`ref.thumbnailAttachmentId`) in the same call. `revokeAttachment(attachmentId)` with a plain id string is unchanged and revokes only that one attachment. Additive — no breaking change.
+
+---
+
 ## [0.13.0], 2026-05-21
 
 ### Added

package/README.md

@@ -121,6 +121,16 @@ client.onReadReceipt(e => {
 });
 ```
 
+**Group read receipts.** Since SDK `0.13.0`, a group can opt into sharing read receipts with every member. Call `updateGroup(groupId, { readReceiptsVisibleToGroup: true })` (owner/admin); after that, a member's `markRead()` on a group message is broadcast to every other member, and `onReadReceipt` fires with `e.fromUserId` set to the member who read it. It is **opt-in per group** — the platform never enables it for you, and it has no effect unless read receipts are also enabled for your app.
+
+```typescript
+await client.updateGroup(groupId, { readReceiptsVisibleToGroup: true });
+
+client.onReadReceipt(e => {
+  // e.fromUserId is the group member who read e.messageId
+});
+```
+
 ### Notification clear & draft sync
 
 Available since SDK `0.12.0`, both own-device only. `clearNotification()` tells your user's other devices a conversation's notifications were dismissed — always available. `syncDraft()` pushes a draft so the user can keep typing on another device — **opt-in** (the app owner enables it in the dashboard) and the draft text crosses the relay in cleartext.
@@ -231,11 +241,11 @@ client.onMessage(async (msg) => {
 | `createUploadSession(options)` | `Promise<UploadSession>` | Low-level: presigned PUT URL only |
 | `finalizeAttachment(attachmentId, sha256)` | `Promise<void>` | Low-level: commit integrity hash |
 | `downloadAttachment(ref)` | `Promise<DownloadedAttachment>` | Get presigned URL + download + decrypt |
-| `revokeAttachment(attachmentId)` | `Promise<void>` | Revoke an attachment you sent; recipients get `ATTACHMENT_REVOKED` |
+| `revokeAttachment(attachmentId \| ref)` | `Promise<void>` | Revoke an attachment you sent; recipients get `ATTACHMENT_REVOKED` |
 | `sendMessage(toUserId, text, { attachments })` | `Promise<{ messageId }>` | Send with attachments |
 
 - **Preview thumbnails (optional).** Pass `thumbnail` (bytes) in `prepareAttachmentAndUpload` options and the SDK uploads it as a separate encrypted attachment, linked via `AttachmentRef.thumbnailAttachmentId`. Purely the developer's choice; omit it and there is no thumbnail. Download the thumbnail like any attachment.
-- **Revoke.** `revokeAttachment()` stops the platform issuing new download URLs and notifies recipients. Bytes a recipient already downloaded cannot be recalled. For GROUP attachments, download is authorized against *current* group membership, so a removed member loses access.
+- **Revoke.** `revokeAttachment()` stops the platform issuing new download URLs and notifies recipients. Bytes a recipient already downloaded cannot be recalled. For GROUP attachments, download is authorized against *current* group membership, so a removed member loses access. Pass an `AttachmentRef` instead of an id (`revokeAttachment(ref)`, since 0.13.1) to revoke the linked preview thumbnail in the same call; a thumbnail is a separate attachment, so revoking a bare id leaves its thumbnail untouched.
 
 - 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.
 - 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.
@@ -259,6 +269,7 @@ client.onMessage(async (msg) => {
 | `getGroup(groupId)` | `Promise<GroupInfo>` | Get group details |
 | `addGroupMembers(groupId, userIds)` | `Promise<GroupInfo>` | Add members (owner/admin) |
 | `removeGroupMember(groupId, userId)` | `Promise<GroupInfo>` | Remove a member (owner/admin) |
+| `updateGroup(groupId, { name?, readReceiptsVisibleToGroup? })` | `Promise<GroupInfo>` | Update group settings (owner/admin) |
 | `deleteGroup(groupId)` | `Promise<void>` | Delete a group (owner only) |
 | `sendGroupMessage(groupId, plaintext, memberUserIds, options?)` | `Promise<{ messageId }>` | Send an end-to-end encrypted group message (sender-side per-recipient fan-out). `options.attachments` for E2EE group attachments. |
 | `sendCleartextGroupMessage(groupId, plaintext)` | `Promise<{ messageId }>` | Send a plaintext (non-encrypted) group message; server fans out to every other member. |
@@ -288,6 +299,40 @@ 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 |
 
+### Scheduled & Persistent Rooms
+
+Available since SDK `0.14.0`. A **room** is an addressable container a live multi-party call runs inside - unlike a group, it is not tied to a member roster. Anyone in your app with the room id can attempt to join; the room's policy is the gate. "Scheduled" vs "persistent" is just how you compose the knobs - the platform imposes no meeting model.
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `createRoom(options?)` | `Promise<Room>` | Create a room (name, schedule, policy, hosts) |
+| `listRooms()` | `Promise<Room[]>` | Rooms you created or host |
+| `getRoom(roomId)` | `Promise<Room>` | One room, including live-call state |
+| `updateRoom(roomId, update)` | `Promise<Room>` | Update name/schedule/policy/hosts (creator only) |
+| `deleteRoom(roomId)` | `Promise<void>` | Delete a room (creator only) |
+| `joinRoom(roomId)` | `Promise<string>` | Join the room's live call, returns callId |
+| `leaveRoom(callId)` | `Promise<void>` | Leave the room's live call |
+
+Room policy (`RoomPolicy`, all optional): `waitingRoom` (non-hosts wait for host admit), `requireHost` (non-hosts cannot open the call), `maxParticipants` (per-room cap), `autoCloseWhenEmpty` (room flips to `CLOSED` when the last participant leaves).
+
+```typescript
+const room = await client.createRoom({
+  name: 'Weekly sync',
+  scheduledStartAt: Date.now() + 3_600_000,   // metadata - your app drives the countdown UX
+  policy: { waitingRoom: true, requireHost: true },
+});
+
+// Join the live call. The returned callId works with every group-call
+// signaling method - pass '' for groupId.
+const callId = await client.joinRoom(room.roomId);
+client.onGroupCallEvent((e) => {
+  // room-call events carry e.roomId; e.type GROUP_CALL_PARTICIPANT_JOINED, etc.
+});
+client.sendGroupCallSignal('GROUP_CALL_SDP_OFFER', callId, '', peerUserId, sdp);
+```
+
+`joinRoom` rejects with `HOST_REQUIRED`, `ROOM_CLOSED`, or `WAITING_ROOM_PENDING` (listen for `GROUP_CALL_WAITING_ROOM_ADMITTED`, then call `joinRoom` again).
+
 ### 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.

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

@@ -1,6 +1,6 @@
 import { CryptoService } from '../crypto/crypto-service';
 import { SessionManager } from './session-manager';
-import { BroadcastCallback, CallEventCallback, DropOnAirClient, EventCallback, GroupCallEventCallback, GroupInfo, GroupMessageCallback, InitializeOptions, MessageCallback, MessageDeleteCallback, MessageEditCallback, TurnCredentials, DeviceInfo, ReadReceiptCallback, NotificationClearCallback, DraftSyncCallback } from './types';
+import { BroadcastCallback, CallEventCallback, DropOnAirClient, EventCallback, CreateRoomOptions, GroupCallEventCallback, GroupInfo, GroupMessageCallback, Room, UpdateRoomOptions, InitializeOptions, MessageCallback, MessageDeleteCallback, MessageEditCallback, TurnCredentials, DeviceInfo, ReadReceiptCallback, NotificationClearCallback, DraftSyncCallback } from './types';
 import { AttachmentRef, CreateUploadSessionOptions, DownloadedAttachment, PrepareAttachmentOptions, UploadSession } from '../attachment/attachment-types';
 export declare class MessagingClient implements DropOnAirClient {
     private readonly options;
@@ -37,6 +37,8 @@ export declare class MessagingClient implements DropOnAirClient {
     /** Pending startGroupCall resolver. */
     private pendingGroupInviteResolve;
     private pendingGroupInviteReject;
+    /** Pending joinRoom resolver (Feature 3.1), keyed by roomId. */
+    private readonly pendingRoomJoins;
     private reconnectDelayMs;
     /**
      * Register a document visibilitychange listener so that when the iOS app
@@ -93,7 +95,7 @@ export declare class MessagingClient implements DropOnAirClient {
     createUploadSession(options: CreateUploadSessionOptions): Promise<UploadSession>;
     finalizeAttachment(attachmentId: string, sha256: string): Promise<void>;
     downloadAttachment(ref: AttachmentRef): Promise<DownloadedAttachment>;
-    revokeAttachment(attachmentId: string): Promise<void>;
+    revokeAttachment(attachment: string | AttachmentRef): Promise<void>;
     connect(): Promise<void>;
     disconnect(): void;
     sendMessage(toUserId: string, plaintextMessage: string, options?: {
@@ -226,6 +228,22 @@ export declare class MessagingClient implements DropOnAirClient {
     addGroupMembers(groupId: string, userIds: string[]): Promise<GroupInfo>;
     removeGroupMember(groupId: string, userId: string): Promise<GroupInfo>;
     deleteGroup(groupId: string): Promise<void>;
+    createRoom(options?: CreateRoomOptions): Promise<Room>;
+    listRooms(): Promise<Room[]>;
+    getRoom(roomId: string): Promise<Room>;
+    updateRoom(roomId: string, update: UpdateRoomOptions): Promise<Room>;
+    deleteRoom(roomId: string): Promise<void>;
+    /**
+     * Join the live call in a room. Resolves with the callId once joined; that
+     * callId works with the existing group-call signaling methods (pass an empty
+     * string for groupId). Rejects with an Error whose message is the reason when
+     * the room is closed (`ROOM_CLOSED`), a host is required but absent
+     * (`HOST_REQUIRED`), or the joiner was placed in the waiting room
+     * (`WAITING_ROOM_PENDING` - listen for GROUP_CALL_WAITING_ROOM_ADMITTED, then
+     * call joinRoom again).
+     */
+    joinRoom(roomId: string): Promise<string>;
+    leaveRoom(callId: string): Promise<void>;
     /**
      * Send an end-to-end encrypted group message. Mirrors the Android and iOS
      * SDKs: the SDK encrypts the plaintext per recipient device (sender-side

package/dist/core/messaging-client.js

@@ -216,6 +216,8 @@ class MessagingClient {
         /** Pending startGroupCall resolver. */
         this.pendingGroupInviteResolve = null;
         this.pendingGroupInviteReject = null;
+        /** Pending joinRoom resolver (Feature 3.1), keyed by roomId. */
+        this.pendingRoomJoins = new Map();
         this.messageListeners = new Set();
         this.eventListeners = new Set();
         this.broadcastListeners = new Set();
@@ -270,8 +272,16 @@ class MessagingClient {
     async downloadAttachment(ref) {
         return this.attachmentClient.downloadAttachment(ref);
     }
-    async revokeAttachment(attachmentId) {
-        return this.attachmentClient.revokeAttachment(attachmentId);
+    async revokeAttachment(attachment) {
+        if (typeof attachment === 'string') {
+            return this.attachmentClient.revokeAttachment(attachment);
+        }
+        // Revoke the main attachment first so the primary intent always lands,
+        // then cascade to the linked preview thumbnail if there is one.
+        await this.attachmentClient.revokeAttachment(attachment.attachmentId);
+        if (attachment.thumbnailAttachmentId) {
+            await this.attachmentClient.revokeAttachment(attachment.thumbnailAttachmentId);
+        }
     }
     async connect() {
         this.log('connect_start');
@@ -929,6 +939,112 @@ class MessagingClient {
             throw new Error(`deleteGroup failed (HTTP ${res.status})`);
     }
     // ---------------------------------------------------------------------------
+    // Rooms (Feature 3.1 - scheduled & persistent meeting rooms)
+    // ---------------------------------------------------------------------------
+    async createRoom(options) {
+        const jwt = await this.getValidDropOnAirJwt(false);
+        const body = {};
+        if (options?.name !== undefined)
+            body.name = options.name;
+        if (options?.scheduledStartAt !== undefined) {
+            body.scheduledStartAt = new Date(options.scheduledStartAt).toISOString();
+        }
+        if (options?.scheduledEndAt !== undefined) {
+            body.scheduledEndAt = new Date(options.scheduledEndAt).toISOString();
+        }
+        if (options?.policy !== undefined)
+            body.policy = options.policy;
+        if (options?.hostUserIds !== undefined)
+            body.hostUserIds = options.hostUserIds;
+        const res = await this.fetchFn(`${this.httpUrl}/api/rooms`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${jwt}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new Error(`createRoom failed (HTTP ${res.status})`);
+        return res.json();
+    }
+    async listRooms() {
+        const jwt = await this.getValidDropOnAirJwt(false);
+        const res = await this.fetchFn(`${this.httpUrl}/api/rooms`, {
+            method: 'GET',
+            headers: { Authorization: `Bearer ${jwt}` },
+        });
+        if (!res.ok)
+            throw new Error(`listRooms failed (HTTP ${res.status})`);
+        return res.json();
+    }
+    async getRoom(roomId) {
+        const jwt = await this.getValidDropOnAirJwt(false);
+        const res = await this.fetchFn(`${this.httpUrl}/api/rooms/${encodeURIComponent(roomId)}`, {
+            method: 'GET',
+            headers: { Authorization: `Bearer ${jwt}` },
+        });
+        if (!res.ok)
+            throw new Error(`getRoom failed (HTTP ${res.status})`);
+        return res.json();
+    }
+    async updateRoom(roomId, update) {
+        const jwt = await this.getValidDropOnAirJwt(false);
+        const body = {};
+        if (update.name !== undefined)
+            body.name = update.name;
+        if (update.scheduledStartAt !== undefined) {
+            body.scheduledStartAt = new Date(update.scheduledStartAt).toISOString();
+        }
+        if (update.scheduledEndAt !== undefined) {
+            body.scheduledEndAt = new Date(update.scheduledEndAt).toISOString();
+        }
+        if (update.policy !== undefined)
+            body.policy = update.policy;
+        if (update.hostUserIds !== undefined)
+            body.hostUserIds = update.hostUserIds;
+        const res = await this.fetchFn(`${this.httpUrl}/api/rooms/${encodeURIComponent(roomId)}`, {
+            method: 'PATCH',
+            headers: { Authorization: `Bearer ${jwt}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new Error(`updateRoom failed (HTTP ${res.status})`);
+        return res.json();
+    }
+    async deleteRoom(roomId) {
+        const jwt = await this.getValidDropOnAirJwt(false);
+        const res = await this.fetchFn(`${this.httpUrl}/api/rooms/${encodeURIComponent(roomId)}`, {
+            method: 'DELETE',
+            headers: { Authorization: `Bearer ${jwt}` },
+        });
+        if (!res.ok)
+            throw new Error(`deleteRoom failed (HTTP ${res.status})`);
+    }
+    /**
+     * Join the live call in a room. Resolves with the callId once joined; that
+     * callId works with the existing group-call signaling methods (pass an empty
+     * string for groupId). Rejects with an Error whose message is the reason when
+     * the room is closed (`ROOM_CLOSED`), a host is required but absent
+     * (`HOST_REQUIRED`), or the joiner was placed in the waiting room
+     * (`WAITING_ROOM_PENDING` - listen for GROUP_CALL_WAITING_ROOM_ADMITTED, then
+     * call joinRoom again).
+     */
+    joinRoom(roomId) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            return Promise.reject(new Error('DropOnAir websocket is not connected'));
+        }
+        return new Promise((resolve, reject) => {
+            this.pendingRoomJoins.set(roomId, { resolve, reject });
+            this.ws.send(this.codec.encodeGroupCallFrame({
+                type: 'GROUP_CALL_JOIN',
+                callId: '',
+                groupId: '',
+                roomId,
+            }));
+        });
+    }
+    async leaveRoom(callId) {
+        this.sendGroupCallFrame({ type: 'GROUP_CALL_LEAVE', callId, groupId: '' });
+    }
+    // ---------------------------------------------------------------------------
     // Group messaging
     // ---------------------------------------------------------------------------
     /**
@@ -1379,10 +1495,28 @@ class MessagingClient {
             this.pendingGroupInviteReject = null;
             reject(new Error(`GROUP_CALL_ALREADY_ACTIVE:${wire.payload ?? ''}`));
         }
+        // Resolve / reject a pending joinRoom() (Feature 3.1). Room-call frames
+        // carry roomId; the join outcome is one of these four types.
+        if (wire.roomId) {
+            const pending = this.pendingRoomJoins.get(wire.roomId);
+            if (pending) {
+                if (wire.type === 'GROUP_CALL_JOINED') {
+                    this.pendingRoomJoins.delete(wire.roomId);
+                    pending.resolve(wire.callId);
+                }
+                else if (wire.type === 'GROUP_CALL_HOST_REQUIRED' ||
+                    wire.type === 'GROUP_CALL_ROOM_CLOSED' ||
+                    wire.type === 'GROUP_CALL_WAITING_ROOM_PENDING') {
+                    this.pendingRoomJoins.delete(wire.roomId);
+                    pending.reject(new Error(wire.type.replace('GROUP_CALL_', '')));
+                }
+            }
+        }
         const event = {
             type: wire.type,
             callId: wire.callId,
             groupId: wire.groupId,
+            roomId: wire.roomId,
             targetUserId: wire.targetUserId,
             payload: wire.payload,
         };

package/dist/core/types.d.ts

@@ -135,15 +135,63 @@ 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_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 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' | 'GROUP_CALL_JOINED' | 'GROUP_CALL_WAITING_ROOM_PENDING' | 'GROUP_CALL_HOST_REQUIRED' | 'GROUP_CALL_ROOM_CLOSED';
 export interface GroupCallEvent {
     type: GroupCallEventType | string;
     callId: string;
     groupId: string;
+    /** Set instead of groupId when the event belongs to a room call (Feature 3.1). */
+    roomId?: string;
     targetUserId?: string;
     payload?: string;
 }
 export type GroupCallEventCallback = (event: GroupCallEvent) => void;
+/**
+ * Per-room policy. Each flag is a capability you compose per room; the platform
+ * imposes no meeting model of its own.
+ */
+export interface RoomPolicy {
+    /** Non-host joiners are held in the waiting room until a host admits them. */
+    waitingRoom?: boolean;
+    /** Non-host joiners cannot open the call; they wait until a host is present. */
+    requireHost?: boolean;
+    /** Per-room participant cap. Omit to use the plan default. */
+    maxParticipants?: number;
+    /** When true, the room flips to CLOSED once the last participant leaves the call. */
+    autoCloseWhenEmpty?: boolean;
+}
+export interface Room {
+    roomId: string;
+    name: string;
+    createdBy: string;
+    hostUserIds: string[];
+    /** Schedule metadata, Unix epoch millis. The platform does not enforce a join window. */
+    scheduledStartAt?: number | null;
+    scheduledEndAt?: number | null;
+    policy: RoomPolicy;
+    status: 'ACTIVE' | 'CLOSED';
+    /** True when a live call is currently running in the room. */
+    isLive: boolean;
+    participantCount: number;
+    createdAt: number;
+}
+/** Options for creating a room. All fields optional except none are required. */
+export interface CreateRoomOptions {
+    name?: string;
+    scheduledStartAt?: number;
+    scheduledEndAt?: number;
+    policy?: RoomPolicy;
+    /** Additional designated hosts. The creator is always a host. */
+    hostUserIds?: string[];
+}
+/** Patch for updateRoom. Any omitted field is left unchanged. */
+export interface UpdateRoomOptions {
+    name?: string;
+    scheduledStartAt?: number;
+    scheduledEndAt?: number;
+    policy?: RoomPolicy;
+    hostUserIds?: string[];
+}
 export interface KeyStorageAdapter {
     get(key: string): Promise<string | null>;
     set(key: string, value: string): Promise<void>;
@@ -286,11 +334,15 @@ export interface DropOnAirClient {
     /** Download (and for E2EE decrypt) an attachment referenced inside a received message. */
     downloadAttachment(ref: import('../attachment/attachment-types').AttachmentRef): Promise<import('../attachment/attachment-types').DownloadedAttachment>;
     /**
-     * Revoke an attachment you sent (Phase 2f). The platform stops issuing
-     * download URLs for it and notifies recipients. Bytes already downloaded
-     * cannot be recalled.
+     * Revoke an attachment you sent. The platform stops issuing download URLs
+     * for it and notifies recipients; bytes already downloaded cannot be
+     * recalled.
+     *
+     * Pass an attachment id to revoke that single attachment. Pass an
+     * `AttachmentRef` to also revoke its linked preview thumbnail
+     * (`thumbnailAttachmentId`) in the same call, if it has one.
      */
-    revokeAttachment(attachmentId: string): Promise<void>;
+    revokeAttachment(attachment: string | import('../attachment/attachment-types').AttachmentRef): Promise<void>;
     /** Send a cleartext message to a user (no encryption). */
     sendCleartextMessage(toUserId: string, plaintext: string): Promise<{
         messageId: string;
@@ -414,4 +466,24 @@ export interface DropOnAirClient {
     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;
+    /** Create a scheduled or persistent room. */
+    createRoom(options?: CreateRoomOptions): Promise<Room>;
+    /** List rooms you created or are a designated host of. */
+    listRooms(): Promise<Room[]>;
+    /** Fetch a single room, including its live-call state. */
+    getRoom(roomId: string): Promise<Room>;
+    /** Update a room's name, schedule, policy, or hosts (creator only). */
+    updateRoom(roomId: string, update: UpdateRoomOptions): Promise<Room>;
+    /** Delete a room (creator only); any live call is ended. */
+    deleteRoom(roomId: string): Promise<void>;
+    /**
+     * Join the live call in a room. Resolves with the callId once joined; that
+     * callId is then used with the group-call signaling methods (sendGroupCallSignal,
+     * screen-share, moderation, leaveGroupCall) - pass an empty string for groupId.
+     * Rejects when the room is closed, a host is required but absent, or the
+     * joiner was placed in the waiting room (error message carries the reason).
+     */
+    joinRoom(roomId: string): Promise<string>;
+    /** Leave the live call in a room. */
+    leaveRoom(callId: string): Promise<void>;
 }

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { InitializeOptions, DropOnAirClient } from './core/types';
 export { SDK_VERSION, PROTOCOL_VERSION, PAYLOAD_FORMAT_VERSION } from './version';
 export declare function initialize(options: InitializeOptions): Promise<DropOnAirClient>;
-export type { InitializeOptions, DropOnAirClient, DropOnAirEvent, MessageCallback, EventCallback, DecryptedMessage, KeyStorageAdapter, CallEvent, CallEventType, CallEventCallback, TurnCredentials, BroadcastMessage, BroadcastCallback, GroupInfo, GroupMemberInfo, DecryptedGroupMessage, GroupMessageCallback, GroupCallEvent, GroupCallEventType, GroupCallEventCallback, MessageEditEvent, MessageEditCallback, MessageDeleteEvent, MessageDeleteCallback, DeviceInfo, ReadReceiptEvent, ReadReceiptCallback, NotificationClearEvent, NotificationClearCallback, DraftSyncEvent, DraftSyncCallback, } from './core/types';
+export type { InitializeOptions, DropOnAirClient, DropOnAirEvent, MessageCallback, EventCallback, DecryptedMessage, KeyStorageAdapter, CallEvent, CallEventType, CallEventCallback, TurnCredentials, BroadcastMessage, BroadcastCallback, GroupInfo, GroupMemberInfo, DecryptedGroupMessage, GroupMessageCallback, GroupCallEvent, GroupCallEventType, GroupCallEventCallback, Room, RoomPolicy, CreateRoomOptions, UpdateRoomOptions, MessageEditEvent, MessageEditCallback, MessageDeleteEvent, MessageDeleteCallback, DeviceInfo, ReadReceiptEvent, ReadReceiptCallback, NotificationClearEvent, NotificationClearCallback, DraftSyncEvent, DraftSyncCallback, } from './core/types';
 export type { AttachmentEncryptionType, AttachmentConversationType, AttachmentRef, DeviceWrappedKey, CreateUploadSessionOptions, UploadSession, PrepareAttachmentOptions, DownloadedAttachment, } from './attachment/attachment-types';
 declare const _default: {
     initialize: typeof initialize;

package/dist/transport/protobuf-codec.d.ts

@@ -116,6 +116,8 @@ export interface WireGroupCallFrame {
     groupId: string;
     targetUserId?: string;
     payload?: string;
+    /** Set instead of groupId when the multi-party call belongs to a Room (Feature 3.1). */
+    roomId?: string;
 }
 /**
  * Edit frame, sender re-encrypts new content for all recipient devices.

package/dist/transport/protobuf-codec.js

@@ -167,7 +167,8 @@ const GroupCallFrameType = new protobuf.Type('GroupCallFrame')
     .add(new protobuf.Field('callId', 2, 'string'))
     .add(new protobuf.Field('groupId', 3, 'string'))
     .add(new protobuf.Field('targetUserId', 4, 'string'))
-    .add(new protobuf.Field('payload', 5, 'string'));
+    .add(new protobuf.Field('payload', 5, 'string'))
+    .add(new protobuf.Field('roomId', 7, 'string'));
 // ---------------------------------------------------------------------------
 // Message Edit and Delete (PROTOCOL_VERSION 3+)
 // ---------------------------------------------------------------------------

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.13.0";
+export declare const SDK_VERSION = "0.14.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.13.0';
+exports.SDK_VERSION = '0.14.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.13.0",
+  "version": "0.14.0",
   "description": "DropOnAir SDK for end-to-end encrypted messaging",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",