@signalapp/ringrtc 2.31.2 → 2.32.0

package/dist/ringrtc/CallLinks.js

@@ -51,5 +51,5 @@ var CallLinkRestrictions;
     CallLinkRestrictions[CallLinkRestrictions["None"] = 0] = "None";
     CallLinkRestrictions[CallLinkRestrictions["AdminApproval"] = 1] = "AdminApproval";
     CallLinkRestrictions[CallLinkRestrictions["Unknown"] = 2] = "Unknown";
-})(CallLinkRestrictions = exports.CallLinkRestrictions || (exports.CallLinkRestrictions = {}));
+})(CallLinkRestrictions || (exports.CallLinkRestrictions = CallLinkRestrictions = {}));
 //# sourceMappingURL=CallLinks.js.map

package/dist/ringrtc/Service.d.ts

@@ -92,6 +92,7 @@ export declare class RingRTCType {
     onRemoteSharingScreen(remoteUserId: UserId, enabled: boolean): void;
     onNetworkRouteChanged(remoteUserId: UserId, localNetworkAdapterType: NetworkAdapterType): void;
     onAudioLevels(remoteUserId: UserId, capturedLevel: RawAudioLevel, receivedLevel: RawAudioLevel): void;
+    onLowBandwidthForVideo(remoteUserId: UserId, recovered: boolean): void;
     renderVideoFrame(width: number, height: number, buffer: Buffer): void;
     onSendOffer(remoteUserId: UserId, remoteDeviceId: DeviceId, callId: CallId, broadcast: boolean, offerType: OfferType, opaque: Buffer): void;
     onSendAnswer(remoteUserId: UserId, remoteDeviceId: DeviceId, callId: CallId, broadcast: boolean, opaque: Buffer): void;
@@ -207,6 +208,7 @@ export declare class RingRTCType {
     handleJoinStateChanged(clientId: GroupCallClientId, joinState: JoinState, demuxId: number | undefined): void;
     handleNetworkRouteChanged(clientId: GroupCallClientId, localNetworkAdapterType: NetworkAdapterType): void;
     handleAudioLevels(clientId: GroupCallClientId, capturedLevel: RawAudioLevel, receivedLevels: Array<ReceivedAudioLevel>): void;
+    handleLowBandwidthForVideo(clientId: GroupCallClientId, recovered: boolean): void;
     handleRemoteDevicesChanged(clientId: GroupCallClientId, remoteDeviceStates: Array<RemoteDeviceState>): void;
     handlePeekChanged(clientId: GroupCallClientId, info: PeekInfo): void;
     handlePeekResponse(requestId: number, statusCode: number, info: PeekInfo | undefined): void;
@@ -293,6 +295,16 @@ export declare class Call {
     handleRemoteSharingScreen?: () => void;
     handleNetworkRouteChanged?: () => void;
     handleAudioLevels?: () => void;
+    /**
+     * Notification of low upload bandwidth for sending video.
+     *
+     * When this is first called, recovered will be false. The second call (if
+     * any) will have recovered set to true and will be called when the upload
+     * bandwidth is high enough to send video.
+     *
+     * @param recovered - whether there is enough bandwidth to send video reliably
+     */
+    handleLowBandwidthForVideo?: (recovered: boolean) => void;
     renderVideoFrame?: (width: number, height: number, buffer: Buffer) => void;
     constructor(callManager: CallManager, remoteUserId: UserId, callId: CallId, isIncoming: boolean, isVideoCall: boolean, state: CallState);
     get remoteUserId(): UserId;
@@ -421,6 +433,7 @@ export interface GroupCallObserver {
     onLocalDeviceStateChanged(groupCall: GroupCall): void;
     onRemoteDeviceStatesChanged(groupCall: GroupCall): void;
     onAudioLevels(groupCall: GroupCall): void;
+    onLowBandwidthForVideo(groupCall: GroupCall, recovered: boolean): void;
     onPeekChanged(groupCall: GroupCall): void;
     onEnded(groupCall: GroupCall, reason: GroupCallEndReason): void;
 }
@@ -462,6 +475,7 @@ export declare class GroupCall {
     handleJoinStateChanged(joinState: JoinState, demuxId: number | undefined): void;
     handleNetworkRouteChanged(localNetworkAdapterType: NetworkAdapterType): void;
     handleAudioLevels(capturedLevel: RawAudioLevel, receivedLevels: Array<ReceivedAudioLevel>): void;
+    handleLowBandwidthForVideo(recovered: boolean): void;
     handleRemoteDevicesChanged(remoteDeviceStates: Array<RemoteDeviceState>): void;
     handlePeekChanged(info: PeekInfo): void;
     handleEnded(reason: GroupCallEndReason): void;

package/dist/ringrtc/Service.js

@@ -180,7 +180,7 @@ 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 = {}));
+})(PeekStatusCodes || (exports.PeekStatusCodes = 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.
@@ -482,6 +482,15 @@ class RingRTCType {
             call.handleAudioLevels();
         }
     }
+    onLowBandwidthForVideo(remoteUserId, recovered) {
+        const call = this._call;
+        if (!call || call.remoteUserId !== remoteUserId) {
+            return;
+        }
+        if (call.handleLowBandwidthForVideo) {
+            call.handleLowBandwidthForVideo(recovered);
+        }
+    }
     renderVideoFrame(width, height, buffer) {
         var _a, _b;
         const call = this._call;
@@ -815,6 +824,15 @@ class RingRTCType {
         });
     }
     // Called by Rust
+    handleLowBandwidthForVideo(clientId, recovered) {
+        sillyDeadlockProtection(() => {
+            const groupCall = this._groupCallByClientId.get(clientId);
+            if (groupCall) {
+                groupCall.handleLowBandwidthForVideo(recovered);
+            }
+        });
+    }
+    // Called by Rust
     handleRemoteDevicesChanged(clientId, remoteDeviceStates) {
         sillyDeadlockProtection(() => {
             const groupCall = this._groupCallByClientId.get(clientId);
@@ -1337,7 +1355,7 @@ var ConnectionState;
     ConnectionState[ConnectionState["Connecting"] = 1] = "Connecting";
     ConnectionState[ConnectionState["Connected"] = 2] = "Connected";
     ConnectionState[ConnectionState["Reconnecting"] = 3] = "Reconnecting";
-})(ConnectionState = exports.ConnectionState || (exports.ConnectionState = {}));
+})(ConnectionState || (exports.ConnectionState = ConnectionState = {}));
 // Represents whether or not a user is joined to a group call and can exchange media.
 var JoinState;
 (function (JoinState) {
@@ -1345,7 +1363,7 @@ var JoinState;
     JoinState[JoinState["Joining"] = 1] = "Joining";
     JoinState[JoinState["Pending"] = 2] = "Pending";
     JoinState[JoinState["Joined"] = 3] = "Joined";
-})(JoinState = exports.JoinState || (exports.JoinState = {}));
+})(JoinState || (exports.JoinState = JoinState = {}));
 // If not ended purposely by the user, gives the reason why a group call ended.
 var GroupCallEndReason;
 (function (GroupCallEndReason) {
@@ -1367,12 +1385,12 @@ var GroupCallEndReason;
     GroupCallEndReason[GroupCallEndReason["IceFailedAfterConnected"] = 13] = "IceFailedAfterConnected";
     GroupCallEndReason[GroupCallEndReason["ServerChangedDemuxId"] = 14] = "ServerChangedDemuxId";
     GroupCallEndReason[GroupCallEndReason["HasMaxDevices"] = 15] = "HasMaxDevices";
-})(GroupCallEndReason = exports.GroupCallEndReason || (exports.GroupCallEndReason = {}));
+})(GroupCallEndReason || (exports.GroupCallEndReason = GroupCallEndReason = {}));
 var CallMessageUrgency;
 (function (CallMessageUrgency) {
     CallMessageUrgency[CallMessageUrgency["Droppable"] = 0] = "Droppable";
     CallMessageUrgency[CallMessageUrgency["HandleImmediately"] = 1] = "HandleImmediately";
-})(CallMessageUrgency = exports.CallMessageUrgency || (exports.CallMessageUrgency = {}));
+})(CallMessageUrgency || (exports.CallMessageUrgency = CallMessageUrgency = {}));
 var RingUpdate;
 (function (RingUpdate) {
     /// The sender is trying to ring this user.
@@ -1389,7 +1407,7 @@ var RingUpdate;
     RingUpdate[RingUpdate["BusyOnAnotherDevice"] = 5] = "BusyOnAnotherDevice";
     /// The sender cancelled the ring request.
     RingUpdate[RingUpdate["CancelledByRinger"] = 6] = "CancelledByRinger";
-})(RingUpdate = exports.RingUpdate || (exports.RingUpdate = {}));
+})(RingUpdate || (exports.RingUpdate = RingUpdate = {}));
 // HTTP request methods.
 var HttpMethod;
 (function (HttpMethod) {
@@ -1397,7 +1415,7 @@ var HttpMethod;
     HttpMethod[HttpMethod["Put"] = 1] = "Put";
     HttpMethod[HttpMethod["Post"] = 2] = "Post";
     HttpMethod[HttpMethod["Delete"] = 3] = "Delete";
-})(HttpMethod = exports.HttpMethod || (exports.HttpMethod = {}));
+})(HttpMethod || (exports.HttpMethod = HttpMethod = {}));
 // The local device state for a group call.
 class LocalDeviceState {
     constructor() {
@@ -1447,7 +1465,7 @@ var GroupCallKind;
 (function (GroupCallKind) {
     GroupCallKind[GroupCallKind["SignalGroup"] = 0] = "SignalGroup";
     GroupCallKind[GroupCallKind["CallLink"] = 1] = "CallLink";
-})(GroupCallKind = exports.GroupCallKind || (exports.GroupCallKind = {}));
+})(GroupCallKind || (exports.GroupCallKind = GroupCallKind = {}));
 class GroupCall {
     get clientId() {
         return this._clientId;
@@ -1596,6 +1614,9 @@ class GroupCall {
         }
         this._observer.onAudioLevels(this);
     }
+    handleLowBandwidthForVideo(recovered) {
+        this._observer.onLowBandwidthForVideo(this, recovered);
+    }
     // Called by Rust via RingRTC object
     handleRemoteDevicesChanged(remoteDeviceStates) {
         var _a;
@@ -1679,7 +1700,7 @@ var OfferType;
 (function (OfferType) {
     OfferType[OfferType["AudioCall"] = 0] = "AudioCall";
     OfferType[OfferType["VideoCall"] = 1] = "VideoCall";
-})(OfferType = exports.OfferType || (exports.OfferType = {}));
+})(OfferType || (exports.OfferType = OfferType = {}));
 class AnswerMessage {
     constructor(callId, opaque) {
         this.callId = callId;
@@ -1718,12 +1739,12 @@ var HangupType;
     HangupType[HangupType["Declined"] = 2] = "Declined";
     HangupType[HangupType["Busy"] = 3] = "Busy";
     HangupType[HangupType["NeedPermission"] = 4] = "NeedPermission";
-})(HangupType = exports.HangupType || (exports.HangupType = {}));
+})(HangupType || (exports.HangupType = HangupType = {}));
 var DataMode;
 (function (DataMode) {
     DataMode[DataMode["Low"] = 0] = "Low";
     DataMode[DataMode["Normal"] = 1] = "Normal";
-})(DataMode = exports.DataMode || (exports.DataMode = {}));
+})(DataMode || (exports.DataMode = DataMode = {}));
 /// Describes why a ring was cancelled.
 var RingCancelReason;
 (function (RingCancelReason) {
@@ -1731,7 +1752,7 @@ var RingCancelReason;
     RingCancelReason[RingCancelReason["DeclinedByUser"] = 0] = "DeclinedByUser";
     /// The device is busy with another call.
     RingCancelReason[RingCancelReason["Busy"] = 1] = "Busy";
-})(RingCancelReason = exports.RingCancelReason || (exports.RingCancelReason = {}));
+})(RingCancelReason || (exports.RingCancelReason = RingCancelReason = {}));
 var CallState;
 (function (CallState) {
     CallState["Prering"] = "idle";
@@ -1739,7 +1760,7 @@ var CallState;
     CallState["Accepted"] = "connected";
     CallState["Reconnecting"] = "connecting";
     CallState["Ended"] = "ended";
-})(CallState = exports.CallState || (exports.CallState = {}));
+})(CallState || (exports.CallState = CallState = {}));
 var CallEndedReason;
 (function (CallEndedReason) {
     CallEndedReason["LocalHangup"] = "LocalHangup";
@@ -1760,7 +1781,7 @@ var CallEndedReason;
     CallEndedReason["AcceptedOnAnotherDevice"] = "AcceptedOnAnotherDevice";
     CallEndedReason["DeclinedOnAnotherDevice"] = "DeclinedOnAnotherDevice";
     CallEndedReason["BusyOnAnotherDevice"] = "BusyOnAnotherDevice";
-})(CallEndedReason = exports.CallEndedReason || (exports.CallEndedReason = {}));
+})(CallEndedReason || (exports.CallEndedReason = CallEndedReason = {}));
 var CallLogLevel;
 (function (CallLogLevel) {
     CallLogLevel[CallLogLevel["Off"] = 0] = "Off";
@@ -1769,7 +1790,7 @@ var CallLogLevel;
     CallLogLevel[CallLogLevel["Info"] = 3] = "Info";
     CallLogLevel[CallLogLevel["Debug"] = 4] = "Debug";
     CallLogLevel[CallLogLevel["Trace"] = 5] = "Trace";
-})(CallLogLevel = exports.CallLogLevel || (exports.CallLogLevel = {}));
+})(CallLogLevel || (exports.CallLogLevel = CallLogLevel = {}));
 function sillyDeadlockProtection(f) {
     void (() => __awaiter(this, void 0, void 0, function* () {
         // This is a silly way of preventing a deadlock.

package/dist/ringrtc/VideoSupport.js

@@ -21,7 +21,7 @@ var VideoPixelFormatEnum;
     VideoPixelFormatEnum[VideoPixelFormatEnum["I420"] = 0] = "I420";
     VideoPixelFormatEnum[VideoPixelFormatEnum["Nv12"] = 1] = "Nv12";
     VideoPixelFormatEnum[VideoPixelFormatEnum["Rgba"] = 2] = "Rgba";
-})(VideoPixelFormatEnum = exports.VideoPixelFormatEnum || (exports.VideoPixelFormatEnum = {}));
+})(VideoPixelFormatEnum || (exports.VideoPixelFormatEnum = VideoPixelFormatEnum = {}));
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 function videoPixelFormatFromEnum(format) {
     switch (format) {
@@ -335,8 +335,8 @@ class GumVideoCapturer {
 exports.GumVideoCapturer = GumVideoCapturer;
 // We add 10% in each dimension to allow for things that are slightly wider or taller than 1080p.
 const MAX_VIDEO_CAPTURE_MULTIPLIER = 1.0;
-exports.MAX_VIDEO_CAPTURE_WIDTH = 1920 * MAX_VIDEO_CAPTURE_MULTIPLIER;
-exports.MAX_VIDEO_CAPTURE_HEIGHT = 1080 * MAX_VIDEO_CAPTURE_MULTIPLIER;
+exports.MAX_VIDEO_CAPTURE_WIDTH = 2880 * MAX_VIDEO_CAPTURE_MULTIPLIER;
+exports.MAX_VIDEO_CAPTURE_HEIGHT = 1800 * MAX_VIDEO_CAPTURE_MULTIPLIER;
 exports.MAX_VIDEO_CAPTURE_AREA = exports.MAX_VIDEO_CAPTURE_WIDTH * exports.MAX_VIDEO_CAPTURE_HEIGHT;
 exports.MAX_VIDEO_CAPTURE_BUFFER_SIZE = exports.MAX_VIDEO_CAPTURE_AREA * 4;
 class CanvasVideoRenderer {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalapp/ringrtc",
-  "version": "2.31.2",
+  "version": "2.32.0",
   "description": "Signal Messenger voice and video calling library.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,13 +9,14 @@
     "dist/*.d.ts",
     "dist/ringrtc/*.js",
     "dist/ringrtc/*.d.ts",
+    "dist/acknowledgments.md",
     "scripts/fetch-prebuild.js"
   ],
   "scripts": {
     "build": "tsc",
     "clean": "rimraf dist",
     "test": "electron-mocha --renderer --recursive dist/test --timeout 10000 --require source-map-support/register",
-    "eslint": "eslint --cache .",
+    "eslint": "eslint .",
     "lint": "yarn format --list-different && yarn eslint",
     "format": "prettier --write .",
     "install": "node scripts/fetch-prebuild.js",
@@ -23,40 +24,39 @@
   },
   "config": {
     "prebuildUrl": "https://build-artifacts.signal.org/libraries/ringrtc-desktop-build-v${npm_package_version}.tar.gz",
-    "prebuildChecksum": "7af45efbec336ddd9a83a7b1820f8b4b9784ff427fb0791650292ad88d08c5b1"
+    "prebuildChecksum": "7800857e52b476b5ac886e79372a62148976f44e1f1f80fcf7f758da05b156fb"
   },
   "author": "",
   "license": "AGPL-3.0-only",
   "dependencies": {
-    "tar": "^6.1.0"
+    "tar": "^6.2.0"
   },
   "devDependencies": {
-    "@types/chai": "4.3.4",
+    "@types/chai": "4.3.6",
     "@types/chai-as-promised": "^7.1.5",
-    "@types/dom-mediacapture-transform": "0.1.4",
-    "@types/long": "5.0.0",
+    "@types/dom-mediacapture-transform": "0.1.6",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.14.0",
-    "@types/offscreencanvas": "^2019.7.0",
+    "@types/node": "^18.15.0",
+    "@types/offscreencanvas": "^2019.7.1",
     "@types/sinon-chai": "^3.2.9",
     "chai": "4.3.7",
     "chai-as-promised": "^7.1.1",
-    "electron": "22.2.0",
-    "electron-mocha": "11.0.2",
-    "eslint": "8.34.0",
+    "electron": "25.8.1",
+    "electron-mocha": "12.0.1",
+    "eslint": "8.49.0",
     "eslint-config-airbnb-typescript-prettier": "5.0.0",
-    "eslint-config-prettier": "8.6.0",
-    "eslint-plugin-import": "2.27.5",
+    "eslint-config-prettier": "8.8.0",
+    "eslint-plugin-import": "2.28.1",
     "eslint-plugin-mocha": "10.1.0",
     "eslint-plugin-more": "1.0.5",
-    "long": "5.2.1",
+    "long": "5.2.3",
     "mocha": "10.2.0",
-    "prettier": "^2.8.4",
-    "rimraf": "4.1.2",
-    "sinon": "^15.0.1",
+    "prettier": "^2.8.8",
+    "rimraf": "4.3.1",
+    "sinon": "^16.0.0",
     "sinon-chai": "^3.7.0",
-    "source-map-support": "^0.5.19",
-    "typescript": "4.9.3",
-    "yarn-audit-fix": "^9.3.9"
+    "source-map-support": "^0.5.21",
+    "typescript": "5.2.2",
+    "yarn-audit-fix": "^10.0.1"
   }
 }