@signalapp/ringrtc 2.27.0 → 2.28.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { RingRTCType } from './ringrtc/Service';
-export { AnswerMessage, AudioDevice, BandwidthMode, BusyMessage, Call, CallEndedReason, CallId, CallLogLevel, CallMessageUrgency, CallSettings, CallState, CallingMessage, ConnectionState, DeviceId, GroupCall, GroupCallEndReason, GroupCallObserver, GroupMemberInfo, HangupMessage, HangupType, HttpMethod, HttpResult, IceCandidateMessage, JoinState, LocalDeviceState, OfferMessage, OfferType, OpaqueMessage, PeekInfo, RemoteDeviceState, RingCancelReason, RingRTCType, RingUpdate, UserId, VideoCapturer, VideoRenderer, VideoRequest, callIdFromEra, callIdFromRingId, } from './ringrtc/Service';
+export { AnswerMessage, AudioDevice, DataMode, BusyMessage, Call, CallEndedReason, CallId, CallLogLevel, CallMessageUrgency, CallSettings, CallState, CallingMessage, ConnectionState, DeviceId, GroupCall, GroupCallEndReason, GroupCallObserver, GroupMemberInfo, HangupMessage, HangupType, HttpMethod, HttpResult, IceCandidateMessage, JoinState, LocalDeviceState, OfferMessage, OfferType, OpaqueMessage, PeekDeviceInfo, PeekInfo, PeekStatusCodes, RemoteDeviceState, RingCancelReason, RingRTCType, RingUpdate, UserId, VideoCapturer, VideoRenderer, VideoRequest, callIdFromEra, callIdFromRingId, } from './ringrtc/Service';
 export { CanvasVideoRenderer, GumVideoCapturer, VideoFrameSource, MAX_VIDEO_CAPTURE_AREA, MAX_VIDEO_CAPTURE_BUFFER_SIZE, MAX_VIDEO_CAPTURE_HEIGHT, MAX_VIDEO_CAPTURE_WIDTH, } from './ringrtc/VideoSupport';
 export { CallLinkRootKey, CallLinkRestrictions, CallLinkState, } from './ringrtc/CallLinks';
 export declare const RingRTC: RingRTCType;

package/dist/index.js

@@ -4,11 +4,11 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 //
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RingRTC = exports.CallLinkState = exports.CallLinkRestrictions = exports.CallLinkRootKey = exports.MAX_VIDEO_CAPTURE_WIDTH = exports.MAX_VIDEO_CAPTURE_HEIGHT = exports.MAX_VIDEO_CAPTURE_BUFFER_SIZE = exports.MAX_VIDEO_CAPTURE_AREA = exports.GumVideoCapturer = exports.CanvasVideoRenderer = exports.callIdFromRingId = exports.callIdFromEra = exports.VideoRequest = exports.RingUpdate = exports.RingRTCType = exports.RingCancelReason = exports.RemoteDeviceState = exports.PeekInfo = exports.OpaqueMessage = exports.OfferType = exports.OfferMessage = exports.LocalDeviceState = exports.JoinState = exports.IceCandidateMessage = exports.HttpMethod = exports.HangupType = exports.HangupMessage = exports.GroupMemberInfo = exports.GroupCallEndReason = exports.GroupCall = exports.ConnectionState = exports.CallingMessage = exports.CallState = exports.CallMessageUrgency = exports.CallLogLevel = exports.CallEndedReason = exports.Call = exports.BusyMessage = exports.BandwidthMode = exports.AnswerMessage = void 0;
+exports.RingRTC = exports.CallLinkState = exports.CallLinkRestrictions = exports.CallLinkRootKey = exports.MAX_VIDEO_CAPTURE_WIDTH = exports.MAX_VIDEO_CAPTURE_HEIGHT = exports.MAX_VIDEO_CAPTURE_BUFFER_SIZE = exports.MAX_VIDEO_CAPTURE_AREA = exports.GumVideoCapturer = exports.CanvasVideoRenderer = exports.callIdFromRingId = exports.callIdFromEra = exports.VideoRequest = exports.RingUpdate = exports.RingRTCType = exports.RingCancelReason = exports.RemoteDeviceState = exports.PeekStatusCodes = exports.OpaqueMessage = exports.OfferType = exports.OfferMessage = exports.LocalDeviceState = exports.JoinState = exports.IceCandidateMessage = exports.HttpMethod = exports.HangupType = exports.HangupMessage = exports.GroupMemberInfo = exports.GroupCallEndReason = exports.GroupCall = exports.ConnectionState = exports.CallingMessage = exports.CallState = exports.CallMessageUrgency = exports.CallLogLevel = exports.CallEndedReason = exports.Call = exports.BusyMessage = exports.DataMode = exports.AnswerMessage = void 0;
 const Service_1 = require("./ringrtc/Service");
 var Service_2 = require("./ringrtc/Service");
 Object.defineProperty(exports, "AnswerMessage", { enumerable: true, get: function () { return Service_2.AnswerMessage; } });
-Object.defineProperty(exports, "BandwidthMode", { enumerable: true, get: function () { return Service_2.BandwidthMode; } });
+Object.defineProperty(exports, "DataMode", { enumerable: true, get: function () { return Service_2.DataMode; } });
 Object.defineProperty(exports, "BusyMessage", { enumerable: true, get: function () { return Service_2.BusyMessage; } });
 Object.defineProperty(exports, "Call", { enumerable: true, get: function () { return Service_2.Call; } });
 Object.defineProperty(exports, "CallEndedReason", { enumerable: true, get: function () { return Service_2.CallEndedReason; } });
@@ -29,7 +29,7 @@ Object.defineProperty(exports, "LocalDeviceState", { enumerable: true, get: func
 Object.defineProperty(exports, "OfferMessage", { enumerable: true, get: function () { return Service_2.OfferMessage; } });
 Object.defineProperty(exports, "OfferType", { enumerable: true, get: function () { return Service_2.OfferType; } });
 Object.defineProperty(exports, "OpaqueMessage", { enumerable: true, get: function () { return Service_2.OpaqueMessage; } });
-Object.defineProperty(exports, "PeekInfo", { enumerable: true, get: function () { return Service_2.PeekInfo; } });
+Object.defineProperty(exports, "PeekStatusCodes", { enumerable: true, get: function () { return Service_2.PeekStatusCodes; } });
 Object.defineProperty(exports, "RemoteDeviceState", { enumerable: true, get: function () { return Service_2.RemoteDeviceState; } });
 Object.defineProperty(exports, "RingCancelReason", { enumerable: true, get: function () { return Service_2.RingCancelReason; } });
 Object.defineProperty(exports, "RingRTCType", { enumerable: true, get: function () { return Service_2.RingRTCType; } });

package/dist/ringrtc/Service.d.ts

@@ -9,18 +9,20 @@ declare class Config {
 }
 type GroupId = Buffer;
 type GroupCallUserId = Buffer;
-export declare class PeekDeviceInfo {
+export interface PeekDeviceInfo {
     demuxId: number;
     userId?: GroupCallUserId;
-    constructor(demuxId: number, userId: GroupCallUserId | undefined);
 }
-export declare class PeekInfo {
+export interface PeekInfo {
     devices: Array<PeekDeviceInfo>;
     creator?: GroupCallUserId;
     eraId?: string;
     maxDevices?: number;
     deviceCount: number;
-    constructor();
+}
+export declare enum PeekStatusCodes {
+    EXPIRED_CALL_LINK = 703,
+    INVALID_CALL_LINK = 704
 }
 declare enum NetworkAdapterType {
     Unknown = 0,
@@ -191,7 +193,9 @@ export declare class RingRTCType {
     receivedHttpResponse(requestId: number, status: number, body: Buffer): void;
     httpRequestFailed(requestId: number, debugInfo: string | undefined): void;
     getGroupCall(groupId: Buffer, sfuUrl: string, hkdfExtraInfo: Buffer, audioLevelsIntervalMillis: number | undefined, observer: GroupCallObserver): GroupCall | undefined;
+    getCallLinkCall(sfuUrl: string, authCredentialPresentation: Buffer, rootKey: CallLinkRootKey, adminPasskey: Buffer | undefined, hkdfExtraInfo: Buffer, audioLevelsIntervalMillis: number | undefined, observer: GroupCallObserver): GroupCall | undefined;
     peekGroupCall(sfuUrl: string, membershipProof: Buffer, groupMembers: Array<GroupMemberInfo>): Promise<PeekInfo>;
+    peekCallLinkCall(sfuUrl: string, authCredentialPresentation: Buffer, rootKey: CallLinkRootKey): Promise<HttpResult<PeekInfo>>;
     requestMembershipProof(clientId: GroupCallClientId): void;
     requestGroupMembers(clientId: GroupCallClientId): void;
     handleConnectionStateChanged(clientId: GroupCallClientId, connectionState: ConnectionState): void;
@@ -200,7 +204,7 @@ export declare class RingRTCType {
     handleAudioLevels(clientId: GroupCallClientId, capturedLevel: RawAudioLevel, receivedLevels: Array<ReceivedAudioLevel>): void;
     handleRemoteDevicesChanged(clientId: GroupCallClientId, remoteDeviceStates: Array<RemoteDeviceState>): void;
     handlePeekChanged(clientId: GroupCallClientId, info: PeekInfo): void;
-    handlePeekResponse(requestId: number, info: PeekInfo): void;
+    handlePeekResponse(requestId: number, statusCode: number, info: PeekInfo | undefined): void;
     handleCallLinkResponse(requestId: number, statusCode: number, state: {
         name: string;
         rawRestrictions: number;
@@ -238,7 +242,7 @@ export declare class RingRTCType {
 export interface CallSettings {
     iceServer: IceServer;
     hideIp: boolean;
-    bandwidthMode: BandwidthMode;
+    dataMode: DataMode;
     audioLevelsIntervalMillis?: number;
 }
 interface IceServer {
@@ -309,7 +313,7 @@ export declare class Call {
     receiveVideoFrame(buffer: Buffer, maxWidth: number, maxHeight: number): [number, number] | undefined;
     private enableOrDisableCapturer;
     private setOutgoingVideoEnabled;
-    updateBandwidthMode(bandwidthMode: BandwidthMode): void;
+    updateDataMode(dataMode: DataMode): void;
     private enableOrDisableRenderer;
 }
 export type GroupCallClientId = number;
@@ -416,7 +420,7 @@ export declare class GroupCall {
     private _localDeviceState;
     private _remoteDeviceStates;
     private _peekInfo;
-    constructor(callManager: CallManager, groupId: Buffer, sfuUrl: string, hkdfExtraInfo: Buffer, audioLevelsIntervalMillis: number | undefined, observer: GroupCallObserver);
+    constructor(callManager: CallManager, observer: GroupCallObserver, clientId: GroupCallClientId);
     connect(): void;
     join(): void;
     leave(): void;
@@ -430,7 +434,7 @@ export declare class GroupCall {
     setOutgoingVideoIsScreenShare(isScreenShare: boolean): void;
     ringAll(): void;
     resendMediaKeys(): void;
-    setBandwidthMode(bandwidthMode: BandwidthMode): void;
+    setDataMode(dataMode: DataMode): void;
     requestVideo(resolutions: Array<VideoRequest>, activeSpeakerHeight: number): void;
     setGroupMembers(members: Array<GroupMemberInfo>): void;
     setMembershipProof(proof: Buffer): void;
@@ -515,7 +519,7 @@ export declare enum HangupType {
     Busy = 3,
     NeedPermission = 4
 }
-export declare enum BandwidthMode {
+export declare enum DataMode {
     Low = 0,
     Normal = 1
 }
@@ -527,7 +531,7 @@ export interface CallManager {
     setConfig(config: Config): void;
     setSelfUuid(uuid: Buffer): void;
     createOutgoingCall(remoteUserId: UserId, isVideoCall: boolean, localDeviceId: DeviceId): CallId;
-    proceed(callId: CallId, iceServerUsername: string, iceServerPassword: string, iceServerUrls: Array<string>, hideIp: boolean, bandwidthMode: BandwidthMode, audioLevelsIntervalMillis: number): void;
+    proceed(callId: CallId, iceServerUsername: string, iceServerPassword: string, iceServerUrls: Array<string>, hideIp: boolean, dataMode: DataMode, audioLevelsIntervalMillis: number): void;
     accept(callId: CallId): void;
     ignore(callId: CallId): void;
     hangup(): void;
@@ -537,7 +541,7 @@ export interface CallManager {
     setOutgoingAudioEnabled(enabled: boolean): void;
     setOutgoingVideoEnabled(enabled: boolean): void;
     setOutgoingVideoIsScreenShare(enabled: boolean): void;
-    updateBandwidthMode(bandwidthMode: BandwidthMode): void;
+    updateDataMode(dataMode: DataMode): void;
     sendVideoFrame(width: number, height: number, format: VideoPixelFormatEnum, buffer: Buffer): void;
     receiveVideoFrame(buffer: Buffer, maxWidth: number, maxHeight: number): [number, number] | undefined;
     receivedOffer(remoteUserId: UserId, remoteDeviceId: DeviceId, localDeviceId: DeviceId, messageAgeSec: number, callId: CallId, offerType: OfferType, opaque: Buffer, senderIdentityKey: Buffer, receiverIdentityKey: Buffer): void;
@@ -549,6 +553,7 @@ export interface CallManager {
     receivedHttpResponse(requestId: number, status: number, body: Buffer): void;
     httpRequestFailed(requestId: number, debugInfo: string | undefined): void;
     createGroupCallClient(groupId: Buffer, sfuUrl: string, hkdfExtraInfo: Buffer, audioLevelsIntervalMillis: number): GroupCallClientId;
+    createCallLinkCallClient(sfuUrl: string, authCredentialPresentation: Buffer, linkRootKey: Buffer, adminPasskey: Buffer | undefined, hkdfExtraInfo: Buffer, audioLevelsIntervalMillis: number): GroupCallClientId;
     deleteGroupCallClient(clientId: GroupCallClientId): void;
     connect(clientId: GroupCallClientId): void;
     join(clientId: GroupCallClientId): void;
@@ -560,7 +565,7 @@ export interface CallManager {
     setOutgoingGroupCallVideoIsScreenShare(clientId: GroupCallClientId, isScreenShare: boolean): void;
     groupRing(clientId: GroupCallClientId, recipient: Buffer | undefined): void;
     resendMediaKeys(clientId: GroupCallClientId): void;
-    setBandwidthMode(clientId: GroupCallClientId, bandwidthMode: BandwidthMode): void;
+    setDataMode(clientId: GroupCallClientId, dataMode: DataMode): void;
     requestVideo(clientId: GroupCallClientId, resolutions: Array<VideoRequest>, activeSpeakerHeight: number): void;
     setGroupMembers(clientId: GroupCallClientId, members: Array<GroupMemberInfo>): void;
     setMembershipProof(clientId: GroupCallClientId, proof: Buffer): void;
@@ -569,6 +574,7 @@ export interface CallManager {
     createCallLink(requestId: number, sfuUrl: string, createCredentialPresentation: Buffer, linkRootKey: Buffer, adminPasskey: Buffer, callLinkPublicParams: Buffer): void;
     updateCallLink(requestId: number, sfuUrl: string, authCredentialPresentation: Buffer, linkRootKey: Buffer, adminPasskey: Buffer, newName: string | undefined, newRestrictions: number | undefined, newRevoked: boolean | undefined): void;
     peekGroupCall(requestId: number, sfu_url: string, membership_proof: Buffer, group_members: Array<GroupMemberInfo>): void;
+    peekCallLinkCall(requestId: number, sfuUrl: string, authCredentialPresentation: Buffer, linkRootKey: Buffer): void;
     getAudioInputs(): Array<AudioDevice>;
     setAudioInput(index: number): void;
     getAudioOutputs(): Array<AudioDevice>;
@@ -597,7 +603,7 @@ export interface CallManagerCallbacks {
     handleJoinStateChanged(clientId: GroupCallClientId, joinState: JoinState, demuxId: number | undefined): void;
     handleRemoteDevicesChanged(clientId: GroupCallClientId, remoteDeviceStates: Array<RemoteDeviceState>): void;
     handlePeekChanged(clientId: GroupCallClientId, info: PeekInfo): void;
-    handlePeekResponse(requestId: number, info: PeekInfo): void;
+    handlePeekResponse(requestId: number, statusCode: number, info: PeekInfo | undefined): void;
     handleEnded(clientId: GroupCallClientId, reason: GroupCallEndReason): void;
     onLogMessage(level: number, fileName: string, line: number, message: string): void;
 }

package/dist/ringrtc/Service.js

@@ -39,7 +39,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CallLogLevel = exports.CallEndedReason = exports.CallState = exports.RingCancelReason = exports.BandwidthMode = exports.HangupType = exports.OpaqueMessage = exports.HangupMessage = exports.BusyMessage = exports.IceCandidateMessage = exports.AnswerMessage = exports.OfferType = exports.OfferMessage = exports.CallingMessage = exports.GroupCall = exports.VideoRequest = exports.GroupMemberInfo = exports.RemoteDeviceState = exports.LocalDeviceState = exports.HttpMethod = exports.RingUpdate = exports.CallMessageUrgency = exports.GroupCallEndReason = exports.JoinState = exports.ConnectionState = exports.Call = exports.RingRTCType = exports.ReceivedAudioLevel = exports.NetworkRoute = exports.PeekInfo = exports.PeekDeviceInfo = exports.callIdFromRingId = exports.callIdFromEra = void 0;
+exports.CallLogLevel = exports.CallEndedReason = exports.CallState = exports.RingCancelReason = exports.DataMode = exports.HangupType = exports.OpaqueMessage = exports.HangupMessage = exports.BusyMessage = exports.IceCandidateMessage = exports.AnswerMessage = exports.OfferType = exports.OfferMessage = exports.CallingMessage = exports.GroupCall = exports.VideoRequest = exports.GroupMemberInfo = exports.RemoteDeviceState = exports.LocalDeviceState = exports.HttpMethod = exports.RingUpdate = exports.CallMessageUrgency = exports.GroupCallEndReason = exports.JoinState = exports.ConnectionState = exports.Call = exports.RingRTCType = exports.ReceivedAudioLevel = exports.NetworkRoute = exports.PeekStatusCodes = exports.callIdFromRingId = exports.callIdFromEra = void 0;
 /* eslint-disable max-classes-per-file */
 const process = __importStar(require("process"));
 const CallLinks_1 = require("./CallLinks");
@@ -110,8 +110,7 @@ NativeCallManager.prototype.signalingMessageSent =
     Native_1.default.cm_signalingMessageSent;
 NativeCallManager.prototype.signalingMessageSendFailed =
     Native_1.default.cm_signalingMessageSendFailed;
-NativeCallManager.prototype.updateBandwidthMode =
-    Native_1.default.cm_updateBandwidthMode;
+NativeCallManager.prototype.updateDataMode = Native_1.default.cm_updateDataMode;
 NativeCallManager.prototype.receivedOffer = Native_1.default.cm_receivedOffer;
 NativeCallManager.prototype.receivedAnswer = Native_1.default.cm_receivedAnswer;
 NativeCallManager.prototype.receivedIceCandidates =
@@ -137,6 +136,8 @@ NativeCallManager.prototype.receiveGroupCallVideoFrame =
     Native_1.default.cm_receiveGroupCallVideoFrame;
 NativeCallManager.prototype.createGroupCallClient =
     Native_1.default.cm_createGroupCallClient;
+NativeCallManager.prototype.createCallLinkCallClient =
+    Native_1.default.cm_createCallLinkCallClient;
 NativeCallManager.prototype.deleteGroupCallClient =
     Native_1.default.cm_deleteGroupCallClient;
 NativeCallManager.prototype.connect = Native_1.default.cm_connect;
@@ -153,8 +154,7 @@ NativeCallManager.prototype.setOutgoingGroupCallVideoIsScreenShare =
 NativeCallManager.prototype.setPresenting = Native_1.default.cm_setPresenting;
 NativeCallManager.prototype.resendMediaKeys =
     Native_1.default.cm_resendMediaKeys;
-NativeCallManager.prototype.setBandwidthMode =
-    Native_1.default.cm_setBandwidthMode;
+NativeCallManager.prototype.setDataMode = Native_1.default.cm_setDataMode;
 NativeCallManager.prototype.requestVideo = Native_1.default.cm_requestVideo;
 NativeCallManager.prototype.setGroupMembers =
     Native_1.default.cm_setGroupMembers;
@@ -164,26 +164,19 @@ NativeCallManager.prototype.readCallLink = Native_1.default.cm_readCallLink;
 NativeCallManager.prototype.createCallLink = Native_1.default.cm_createCallLink;
 NativeCallManager.prototype.updateCallLink = Native_1.default.cm_updateCallLink;
 NativeCallManager.prototype.peekGroupCall = Native_1.default.cm_peekGroupCall;
+NativeCallManager.prototype.peekCallLinkCall =
+    Native_1.default.cm_peekCallLinkCall;
 NativeCallManager.prototype.getAudioInputs = Native_1.default.cm_getAudioInputs;
 NativeCallManager.prototype.setAudioInput = Native_1.default.cm_setAudioInput;
 NativeCallManager.prototype.getAudioOutputs =
     Native_1.default.cm_getAudioOutputs;
 NativeCallManager.prototype.setAudioOutput = Native_1.default.cm_setAudioOutput;
 NativeCallManager.prototype.processEvents = Native_1.default.cm_processEvents;
-class PeekDeviceInfo {
-    constructor(demuxId, userId) {
-        this.demuxId = demuxId;
-        this.userId = userId;
-    }
-}
-exports.PeekDeviceInfo = PeekDeviceInfo;
-class PeekInfo {
-    constructor() {
-        this.devices = [];
-        this.deviceCount = 0;
-    }
-}
-exports.PeekInfo = PeekInfo;
+var PeekStatusCodes;
+(function (PeekStatusCodes) {
+    PeekStatusCodes[PeekStatusCodes["EXPIRED_CALL_LINK"] = 703] = "EXPIRED_CALL_LINK";
+    PeekStatusCodes[PeekStatusCodes["INVALID_CALL_LINK"] = 704] = "INVALID_CALL_LINK";
+})(PeekStatusCodes = exports.PeekStatusCodes || (exports.PeekStatusCodes = {}));
 // In sync with WebRTC's PeerConnection.AdapterType.
 // Despite how it looks, this is not an option set.
 // A network adapter type can only be one of the listed values.
@@ -384,7 +377,7 @@ class RingRTCType {
     }
     proceed(callId, settings) {
         sillyDeadlockProtection(() => {
-            this.callManager.proceed(callId, settings.iceServer.username || '', settings.iceServer.password || '', settings.iceServer.urls, settings.hideIp, settings.bandwidthMode, settings.audioLevelsIntervalMillis || 0);
+            this.callManager.proceed(callId, settings.iceServer.username || '', settings.iceServer.password || '', settings.iceServer.urls, settings.hideIp, settings.dataMode, settings.audioLevelsIntervalMillis || 0);
         });
     }
     // Called by Rust
@@ -708,7 +701,15 @@ class RingRTCType {
     // Group Calls
     // Called by UX
     getGroupCall(groupId, sfuUrl, hkdfExtraInfo, audioLevelsIntervalMillis, observer) {
-        const groupCall = new GroupCall(this.callManager, groupId, sfuUrl, hkdfExtraInfo, audioLevelsIntervalMillis, observer);
+        const clientId = this.callManager.createGroupCallClient(groupId, sfuUrl, hkdfExtraInfo, audioLevelsIntervalMillis || 0);
+        const groupCall = new GroupCall(this.callManager, observer, clientId);
+        this._groupCallByClientId.set(groupCall.clientId, groupCall);
+        return groupCall;
+    }
+    // Called by UX
+    getCallLinkCall(sfuUrl, authCredentialPresentation, rootKey, adminPasskey, hkdfExtraInfo, audioLevelsIntervalMillis, observer) {
+        const clientId = this.callManager.createCallLinkCallClient(sfuUrl, authCredentialPresentation, rootKey.bytes, adminPasskey, hkdfExtraInfo, audioLevelsIntervalMillis || 0);
+        const groupCall = new GroupCall(this.callManager, observer, clientId);
         this._groupCallByClientId.set(groupCall.clientId, groupCall);
         return groupCall;
     }
@@ -720,6 +721,22 @@ class RingRTCType {
         sillyDeadlockProtection(() => {
             this.callManager.peekGroupCall(requestId, sfuUrl, membershipProof, groupMembers);
         });
+        return promise.then(result => {
+            if (result.success) {
+                return result.value;
+            }
+            else {
+                return { devices: [], deviceCount: 0 };
+            }
+        });
+    }
+    // Called by UX
+    peekCallLinkCall(sfuUrl, authCredentialPresentation, rootKey) {
+        const [requestId, promise] = this._peekRequests.add();
+        // Response comes back via handlePeekResponse
+        sillyDeadlockProtection(() => {
+            this.callManager.peekCallLinkCall(requestId, sfuUrl, authCredentialPresentation, rootKey.bytes);
+        });
         return promise;
     }
     // Called by Rust
@@ -809,9 +826,16 @@ class RingRTCType {
         });
     }
     // Called by Rust
-    handlePeekResponse(requestId, info) {
+    handlePeekResponse(requestId, statusCode, info) {
         sillyDeadlockProtection(() => {
-            if (!this._peekRequests.resolve(requestId, info)) {
+            let result;
+            if (info) {
+                result = { success: true, value: info };
+            }
+            else {
+                result = { success: false, errorStatusCode: statusCode };
+            }
+            if (!this._peekRequests.resolve(requestId, result)) {
                 this.logWarn(`Invalid request ID for handlePeekResponse: ${requestId}`);
             }
         });
@@ -1259,10 +1283,10 @@ class Call {
             }
         });
     }
-    updateBandwidthMode(bandwidthMode) {
+    updateDataMode(dataMode) {
         sillyDeadlockProtection(() => {
             try {
-                this._callManager.updateBandwidthMode(bandwidthMode);
+                this._callManager.updateDataMode(dataMode);
             }
             catch (_a) {
                 // We may not have an active connection any more.
@@ -1410,11 +1434,11 @@ class GroupCall {
         return this._clientId;
     }
     // Called by UI via RingRTC object
-    constructor(callManager, groupId, sfuUrl, hkdfExtraInfo, audioLevelsIntervalMillis, observer) {
+    constructor(callManager, observer, clientId) {
         this._callManager = callManager;
         this._observer = observer;
+        this._clientId = clientId;
         this._localDeviceState = new LocalDeviceState();
-        this._clientId = this._callManager.createGroupCallClient(groupId, sfuUrl, hkdfExtraInfo, audioLevelsIntervalMillis || 0);
     }
     // Called by UI
     connect() {
@@ -1477,8 +1501,8 @@ class GroupCall {
         this._callManager.resendMediaKeys(this._clientId);
     }
     // Called by UI
-    setBandwidthMode(bandwidthMode) {
-        this._callManager.setBandwidthMode(this._clientId, bandwidthMode);
+    setDataMode(dataMode) {
+        this._callManager.setDataMode(this._clientId, dataMode);
     }
     // Called by UI
     requestVideo(resolutions, activeSpeakerHeight) {
@@ -1656,11 +1680,11 @@ var HangupType;
     HangupType[HangupType["Busy"] = 3] = "Busy";
     HangupType[HangupType["NeedPermission"] = 4] = "NeedPermission";
 })(HangupType = exports.HangupType || (exports.HangupType = {}));
-var BandwidthMode;
-(function (BandwidthMode) {
-    BandwidthMode[BandwidthMode["Low"] = 0] = "Low";
-    BandwidthMode[BandwidthMode["Normal"] = 1] = "Normal";
-})(BandwidthMode = exports.BandwidthMode || (exports.BandwidthMode = {}));
+var DataMode;
+(function (DataMode) {
+    DataMode[DataMode["Low"] = 0] = "Low";
+    DataMode[DataMode["Normal"] = 1] = "Normal";
+})(DataMode = exports.DataMode || (exports.DataMode = {}));
 /// Describes why a ring was cancelled.
 var RingCancelReason;
 (function (RingCancelReason) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalapp/ringrtc",
-  "version": "2.27.0",
+  "version": "2.28.0",
   "description": "Signal Messenger voice and video calling library.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,7 +23,7 @@
   },
   "config": {
     "prebuildUrl": "https://build-artifacts.signal.org/libraries/ringrtc-desktop-build-v${npm_package_version}.tar.gz",
-    "prebuildChecksum": "864c376c4998ae9a0a832c5753089e881d5466e2bbae5d11dae7486226129d5a"
+    "prebuildChecksum": "5d4bd3c13ee3373d0e67dacce7e64a422fdc4e0eb8f9c551495fa5b90ec1f322"
   },
   "author": "",
   "license": "AGPL-3.0-only",