@signalapp/ringrtc 2.28.0 → 2.29.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { RingRTCType } 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 { AnswerMessage, AudioDevice, DataMode, BusyMessage, Call, CallEndedReason, CallId, CallLogLevel, CallMessageUrgency, CallSettings, CallState, CallingMessage, ConnectionState, DeviceId, GroupCall, GroupCallEndReason, GroupCallKind, 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,7 +4,7 @@
 // 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.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;
+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.GroupCallKind = 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; } });
@@ -19,6 +19,7 @@ Object.defineProperty(exports, "CallingMessage", { enumerable: true, get: functi
 Object.defineProperty(exports, "ConnectionState", { enumerable: true, get: function () { return Service_2.ConnectionState; } });
 Object.defineProperty(exports, "GroupCall", { enumerable: true, get: function () { return Service_2.GroupCall; } });
 Object.defineProperty(exports, "GroupCallEndReason", { enumerable: true, get: function () { return Service_2.GroupCallEndReason; } });
+Object.defineProperty(exports, "GroupCallKind", { enumerable: true, get: function () { return Service_2.GroupCallKind; } });
 Object.defineProperty(exports, "GroupMemberInfo", { enumerable: true, get: function () { return Service_2.GroupMemberInfo; } });
 Object.defineProperty(exports, "HangupMessage", { enumerable: true, get: function () { return Service_2.HangupMessage; } });
 Object.defineProperty(exports, "HangupType", { enumerable: true, get: function () { return Service_2.HangupType; } });

package/dist/ringrtc/Service.d.ts

@@ -19,6 +19,7 @@ export interface PeekInfo {
     eraId?: string;
     maxDevices?: number;
     deviceCount: number;
+    pendingUsers: Array<GroupCallUserId>;
 }
 export declare enum PeekStatusCodes {
     EXPIRED_CALL_LINK = 703,
@@ -331,18 +332,20 @@ export declare enum JoinState {
 export declare enum GroupCallEndReason {
     DeviceExplicitlyDisconnected = 0,
     ServerExplicitlyDisconnected = 1,
-    CallManagerIsBusy = 2,
-    SfuClientFailedToJoin = 3,
-    FailedToCreatePeerConnectionFactory = 4,
-    FailedToNegotiateSrtpKeys = 5,
-    FailedToCreatePeerConnection = 6,
-    FailedToStartPeerConnection = 7,
-    FailedToUpdatePeerConnection = 8,
-    FailedToSetMaxSendBitrate = 9,
-    IceFailedWhileConnecting = 10,
-    IceFailedAfterConnected = 11,
-    ServerChangedDemuxId = 12,
-    HasMaxDevices = 13
+    DeniedRequestToJoinCall = 2,
+    RemovedFromCall = 3,
+    CallManagerIsBusy = 4,
+    SfuClientFailedToJoin = 5,
+    FailedToCreatePeerConnectionFactory = 6,
+    FailedToNegotiateSrtpKeys = 7,
+    FailedToCreatePeerConnection = 8,
+    FailedToStartPeerConnection = 9,
+    FailedToUpdatePeerConnection = 10,
+    FailedToSetMaxSendBitrate = 11,
+    IceFailedWhileConnecting = 12,
+    IceFailedAfterConnected = 13,
+    ServerChangedDemuxId = 14,
+    HasMaxDevices = 15
 }
 export declare enum CallMessageUrgency {
     Droppable = 0,
@@ -403,6 +406,10 @@ export declare class VideoRequest {
     framerate: number | undefined;
     constructor(demuxId: number, width: number, height: number, framerate: number | undefined);
 }
+export declare enum GroupCallKind {
+    SignalGroup = 0,
+    CallLink = 1
+}
 export interface GroupCallObserver {
     requestMembershipProof(groupCall: GroupCall): void;
     requestGroupMembers(groupCall: GroupCall): void;
@@ -413,6 +420,7 @@ export interface GroupCallObserver {
     onEnded(groupCall: GroupCall, reason: GroupCallEndReason): void;
 }
 export declare class GroupCall {
+    private readonly _kind;
     private readonly _callManager;
     private readonly _observer;
     private readonly _clientId;
@@ -420,7 +428,8 @@ export declare class GroupCall {
     private _localDeviceState;
     private _remoteDeviceStates;
     private _peekInfo;
-    constructor(callManager: CallManager, observer: GroupCallObserver, clientId: GroupCallClientId);
+    constructor(kind: GroupCallKind, callManager: CallManager, observer: GroupCallObserver, clientId: GroupCallClientId);
+    getKind(): GroupCallKind;
     connect(): void;
     join(): void;
     leave(): void;
@@ -436,6 +445,10 @@ export declare class GroupCall {
     resendMediaKeys(): void;
     setDataMode(dataMode: DataMode): void;
     requestVideo(resolutions: Array<VideoRequest>, activeSpeakerHeight: number): void;
+    approveUser(otherUserId: Buffer): void;
+    denyUser(otherUserId: Buffer): void;
+    removeClient(otherClientDemuxId: number): void;
+    blockClient(otherClientDemuxId: number): void;
     setGroupMembers(members: Array<GroupMemberInfo>): void;
     setMembershipProof(proof: Buffer): void;
     requestMembershipProof(): void;
@@ -567,6 +580,10 @@ export interface CallManager {
     resendMediaKeys(clientId: GroupCallClientId): void;
     setDataMode(clientId: GroupCallClientId, dataMode: DataMode): void;
     requestVideo(clientId: GroupCallClientId, resolutions: Array<VideoRequest>, activeSpeakerHeight: number): void;
+    approveUser(clientId: GroupCallClientId, otherUserId: Buffer): void;
+    denyUser(clientId: GroupCallClientId, otherUserId: Buffer): void;
+    removeClient(clientId: GroupCallClientId, otherClientDemuxId: number): void;
+    blockClient(clientId: GroupCallClientId, otherClientDemuxId: number): void;
     setGroupMembers(clientId: GroupCallClientId, members: Array<GroupMemberInfo>): void;
     setMembershipProof(clientId: GroupCallClientId, proof: Buffer): void;
     receiveGroupCallVideoFrame(clientId: GroupCallClientId, remoteDemuxId: number, buffer: Buffer, maxWidth: number, maxHeight: number): [number, number] | undefined;

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.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;
+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.GroupCallKind = 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");
@@ -156,6 +156,10 @@ NativeCallManager.prototype.resendMediaKeys =
     Native_1.default.cm_resendMediaKeys;
 NativeCallManager.prototype.setDataMode = Native_1.default.cm_setDataMode;
 NativeCallManager.prototype.requestVideo = Native_1.default.cm_requestVideo;
+NativeCallManager.prototype.approveUser = Native_1.default.cm_approveUser;
+NativeCallManager.prototype.denyUser = Native_1.default.cm_denyUser;
+NativeCallManager.prototype.removeClient = Native_1.default.cm_removeClient;
+NativeCallManager.prototype.blockClient = Native_1.default.cm_blockClient;
 NativeCallManager.prototype.setGroupMembers =
     Native_1.default.cm_setGroupMembers;
 NativeCallManager.prototype.setMembershipProof =
@@ -702,14 +706,14 @@ class RingRTCType {
     // Called by UX
     getGroupCall(groupId, sfuUrl, hkdfExtraInfo, audioLevelsIntervalMillis, observer) {
         const clientId = this.callManager.createGroupCallClient(groupId, sfuUrl, hkdfExtraInfo, audioLevelsIntervalMillis || 0);
-        const groupCall = new GroupCall(this.callManager, observer, clientId);
+        const groupCall = new GroupCall(GroupCallKind.SignalGroup, 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);
+        const groupCall = new GroupCall(GroupCallKind.CallLink, this.callManager, observer, clientId);
         this._groupCallByClientId.set(groupCall.clientId, groupCall);
         return groupCall;
     }
@@ -726,7 +730,7 @@ class RingRTCType {
                 return result.value;
             }
             else {
-                return { devices: [], deviceCount: 0 };
+                return { devices: [], deviceCount: 0, pendingUsers: [] };
             }
         });
     }
@@ -1340,19 +1344,21 @@ var GroupCallEndReason;
     // Normal events
     GroupCallEndReason[GroupCallEndReason["DeviceExplicitlyDisconnected"] = 0] = "DeviceExplicitlyDisconnected";
     GroupCallEndReason[GroupCallEndReason["ServerExplicitlyDisconnected"] = 1] = "ServerExplicitlyDisconnected";
+    GroupCallEndReason[GroupCallEndReason["DeniedRequestToJoinCall"] = 2] = "DeniedRequestToJoinCall";
+    GroupCallEndReason[GroupCallEndReason["RemovedFromCall"] = 3] = "RemovedFromCall";
     // Things that can go wrong
-    GroupCallEndReason[GroupCallEndReason["CallManagerIsBusy"] = 2] = "CallManagerIsBusy";
-    GroupCallEndReason[GroupCallEndReason["SfuClientFailedToJoin"] = 3] = "SfuClientFailedToJoin";
-    GroupCallEndReason[GroupCallEndReason["FailedToCreatePeerConnectionFactory"] = 4] = "FailedToCreatePeerConnectionFactory";
-    GroupCallEndReason[GroupCallEndReason["FailedToNegotiateSrtpKeys"] = 5] = "FailedToNegotiateSrtpKeys";
-    GroupCallEndReason[GroupCallEndReason["FailedToCreatePeerConnection"] = 6] = "FailedToCreatePeerConnection";
-    GroupCallEndReason[GroupCallEndReason["FailedToStartPeerConnection"] = 7] = "FailedToStartPeerConnection";
-    GroupCallEndReason[GroupCallEndReason["FailedToUpdatePeerConnection"] = 8] = "FailedToUpdatePeerConnection";
-    GroupCallEndReason[GroupCallEndReason["FailedToSetMaxSendBitrate"] = 9] = "FailedToSetMaxSendBitrate";
-    GroupCallEndReason[GroupCallEndReason["IceFailedWhileConnecting"] = 10] = "IceFailedWhileConnecting";
-    GroupCallEndReason[GroupCallEndReason["IceFailedAfterConnected"] = 11] = "IceFailedAfterConnected";
-    GroupCallEndReason[GroupCallEndReason["ServerChangedDemuxId"] = 12] = "ServerChangedDemuxId";
-    GroupCallEndReason[GroupCallEndReason["HasMaxDevices"] = 13] = "HasMaxDevices";
+    GroupCallEndReason[GroupCallEndReason["CallManagerIsBusy"] = 4] = "CallManagerIsBusy";
+    GroupCallEndReason[GroupCallEndReason["SfuClientFailedToJoin"] = 5] = "SfuClientFailedToJoin";
+    GroupCallEndReason[GroupCallEndReason["FailedToCreatePeerConnectionFactory"] = 6] = "FailedToCreatePeerConnectionFactory";
+    GroupCallEndReason[GroupCallEndReason["FailedToNegotiateSrtpKeys"] = 7] = "FailedToNegotiateSrtpKeys";
+    GroupCallEndReason[GroupCallEndReason["FailedToCreatePeerConnection"] = 8] = "FailedToCreatePeerConnection";
+    GroupCallEndReason[GroupCallEndReason["FailedToStartPeerConnection"] = 9] = "FailedToStartPeerConnection";
+    GroupCallEndReason[GroupCallEndReason["FailedToUpdatePeerConnection"] = 10] = "FailedToUpdatePeerConnection";
+    GroupCallEndReason[GroupCallEndReason["FailedToSetMaxSendBitrate"] = 11] = "FailedToSetMaxSendBitrate";
+    GroupCallEndReason[GroupCallEndReason["IceFailedWhileConnecting"] = 12] = "IceFailedWhileConnecting";
+    GroupCallEndReason[GroupCallEndReason["IceFailedAfterConnected"] = 13] = "IceFailedAfterConnected";
+    GroupCallEndReason[GroupCallEndReason["ServerChangedDemuxId"] = 14] = "ServerChangedDemuxId";
+    GroupCallEndReason[GroupCallEndReason["HasMaxDevices"] = 15] = "HasMaxDevices";
 })(GroupCallEndReason = exports.GroupCallEndReason || (exports.GroupCallEndReason = {}));
 var CallMessageUrgency;
 (function (CallMessageUrgency) {
@@ -1429,17 +1435,26 @@ class VideoRequest {
     }
 }
 exports.VideoRequest = VideoRequest;
+var GroupCallKind;
+(function (GroupCallKind) {
+    GroupCallKind[GroupCallKind["SignalGroup"] = 0] = "SignalGroup";
+    GroupCallKind[GroupCallKind["CallLink"] = 1] = "CallLink";
+})(GroupCallKind = exports.GroupCallKind || (exports.GroupCallKind = {}));
 class GroupCall {
     get clientId() {
         return this._clientId;
     }
     // Called by UI via RingRTC object
-    constructor(callManager, observer, clientId) {
+    constructor(kind, callManager, observer, clientId) {
+        this._kind = kind;
         this._callManager = callManager;
         this._observer = observer;
         this._clientId = clientId;
         this._localDeviceState = new LocalDeviceState();
     }
+    getKind() {
+        return this._kind;
+    }
     // Called by UI
     connect() {
         this._callManager.connect(this._clientId);
@@ -1509,6 +1524,22 @@ class GroupCall {
         this._callManager.requestVideo(this._clientId, resolutions, activeSpeakerHeight);
     }
     // Called by UI
+    approveUser(otherUserId) {
+        this._callManager.approveUser(this._clientId, otherUserId);
+    }
+    // Called by UI
+    denyUser(otherUserId) {
+        this._callManager.denyUser(this._clientId, otherUserId);
+    }
+    // Called by UI
+    removeClient(otherClientDemuxId) {
+        this._callManager.removeClient(this._clientId, otherClientDemuxId);
+    }
+    // Called by UI
+    blockClient(otherClientDemuxId) {
+        this._callManager.blockClient(this._clientId, otherClientDemuxId);
+    }
+    // Called by UI
     setGroupMembers(members) {
         this._callManager.setGroupMembers(this._clientId, members);
     }

package/dist/ringrtc/VideoSupport.js

@@ -130,12 +130,15 @@ class GumVideoCapturer {
                 deviceId: (_a = options.preferredDeviceId) !== null && _a !== void 0 ? _a : this.preferredDeviceId,
                 width: {
                     max: options.maxWidth,
+                    ideal: options.maxWidth,
                 },
                 height: {
                     max: options.maxHeight,
+                    ideal: options.maxHeight,
                 },
                 frameRate: {
                     max: options.maxFramerate,
+                    ideal: options.maxFramerate,
                 },
             },
         };
@@ -271,11 +274,15 @@ class GumVideoCapturer {
                             index_1.RingRTC.logWarn(`Unsupported video frame format: ${frame.format}`);
                             break;
                         }
+                        const visibleRect = frame.visibleRect;
+                        if (!visibleRect) {
+                            continue;
+                        }
                         yield frame.copyTo(buffer);
                         if (sender !== this.sender) {
                             break;
                         }
-                        sender.sendVideoFrame(frame.codedWidth, frame.codedHeight, format, buffer);
+                        sender.sendVideoFrame(visibleRect.width, visibleRect.height, format, buffer);
                     }
                     catch (e) {
                         index_1.RingRTC.logError(`sendVideoFrame(): ${e}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalapp/ringrtc",
-  "version": "2.28.0",
+  "version": "2.29.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": "5d4bd3c13ee3373d0e67dacce7e64a422fdc4e0eb8f9c551495fa5b90ec1f322"
+    "prebuildChecksum": "dae749c2e95b583012db0c0b05ca32385bab287a671eb33afcfb7e18ee9f982b"
   },
   "author": "",
   "license": "AGPL-3.0-only",