@signalapp/ringrtc 2.37.1 → 2.39.0

package/dist/acknowledgments.md

@@ -669,7 +669,7 @@ For more information on this, and how to apply and follow the GNU AGPL, see
 
 ```
 
-## libsignal-core 0.1.0, partial-default-derive 0.1.0, regex-aot 0.1.0, ringrtc 2.37.1
+## libsignal-core 0.1.0, partial-default-derive 0.1.0, regex-aot 0.1.0, ringrtc 2.39.0
 
 ```
 GNU AFFERO GENERAL PUBLIC LICENSE
@@ -1434,7 +1434,7 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 ```
 
-## libloading 0.6.7
+## libloading 0.8.1
 
 ```
 Copyright © 2015, Simonas Kazlauskas
@@ -1631,7 +1631,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## bitflags 2.4.1, log 0.4.20, regex 1.10.2, regex-automata 0.4.3, regex-syntax 0.8.2, semver 0.9.0
+## bitflags 2.4.1, log 0.4.20, regex 1.10.2, regex-automata 0.4.3, regex-syntax 0.8.2
 
 ```
 Copyright (c) 2014 The Rust Project Developers
@@ -1756,7 +1756,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## neon 0.10.1, neon-build 0.10.1, neon-macros 0.10.1, neon-runtime 0.10.1
+## neon-macros 1.0.0
 
 ```
 Copyright (c) 2015 David Herman
@@ -2051,37 +2051,6 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## semver-parser 0.7.0
-
-```
-Copyright (c) 2016 Steve Klabnik
-
-Permission is hereby granted, free of charge, to any
-person obtaining a copy of this software and associated
-documentation files (the "Software"), to deal in the
-Software without restriction, including without
-limitation the rights to use, copy, modify, merge,
-publish, distribute, sublicense, and/or sell copies of
-the Software, and to permit persons to whom the Software
-is furnished to do so, subject to the following
-conditions:
-
-The above copyright notice and this permission notice
-shall be included in all copies or substantial portions
-of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
-ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
-TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
-PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
-SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
-IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-DEALINGS IN THE SOFTWARE.
-
-```
-
 ## rustc_version 0.4.0
 
 ```
@@ -3109,7 +3078,7 @@ SOFTWARE.
 
 ```
 
-## curve25519-dalek-derive 0.1.0
+## curve25519-dalek-derive 0.1.0, neon 1.0.0
 
 ```
 MIT License
@@ -3149,7 +3118,7 @@ SOFTWARE.
 
 ```
 
-## anyhow 1.0.75, fastrand 2.0.1, home 0.5.5, itoa 1.0.10, linux-raw-sys 0.4.12, num_enum 0.6.1, num_enum 0.7.1, num_enum_derive 0.6.1, num_enum_derive 0.7.1, once_cell 1.19.0, pin-project-lite 0.2.13, prettyplease 0.2.15, proc-macro-crate 1.3.1, proc-macro-crate 2.0.1, proc-macro2 1.0.70, quote 1.0.33, rustix 0.38.28, semver 1.0.20, serde 1.0.193, serde_derive 1.0.193, serde_json 1.0.108, syn 1.0.109, syn 2.0.41, syn-mid 0.5.4, thiserror 1.0.50, thiserror-impl 1.0.50, unicode-ident 1.0.12
+## anyhow 1.0.75, fastrand 2.0.1, home 0.5.5, itoa 1.0.10, linux-raw-sys 0.4.12, num_enum 0.6.1, num_enum 0.7.1, num_enum_derive 0.6.1, num_enum_derive 0.7.1, once_cell 1.19.0, pin-project-lite 0.2.13, prettyplease 0.2.15, proc-macro-crate 1.3.1, proc-macro-crate 2.0.1, proc-macro2 1.0.70, quote 1.0.33, rustix 0.38.28, semver 1.0.20, send_wrapper 0.6.0, serde 1.0.193, serde_derive 1.0.193, serde_json 1.0.108, syn 1.0.109, syn 2.0.41, syn-mid 0.6.0, thiserror 1.0.50, thiserror-impl 1.0.50, unicode-ident 1.0.12
 
 ```
 Permission is hereby granted, free of charge, to any

package/dist/ringrtc/Service.d.ts

@@ -55,6 +55,7 @@ export declare class ReceivedAudioLevel {
     level: RawAudioLevel;
     constructor(demuxId: number, level: RawAudioLevel);
 }
+export type EmptyObj = Record<PropertyKey, never>;
 export type HttpResult<T> = {
     success: true;
     value: T;
@@ -68,6 +69,7 @@ export declare class RingRTCType {
     private _groupCallByClientId;
     private _peekRequests;
     private _callLinkRequests;
+    private _emptyRequests;
     private _callInfoByCallId;
     private getCallInfoKey;
     handleOutgoingSignaling: ((remoteUserId: UserId, message: CallingMessage) => Promise<boolean>) | null;
@@ -184,11 +186,11 @@ export declare class RingRTCType {
      */
     updateCallLinkRestrictions(sfuUrl: string, authCredentialPresentation: Buffer, linkRootKey: CallLinkRootKey, adminPasskey: Buffer, restrictions: Exclude<CallLinkRestrictions, CallLinkRestrictions.Unknown>): Promise<HttpResult<CallLinkState>>;
     /**
-     * Asynchronous request to revoke or un-revoke a call link.
+     * Asynchronous request to delete a call link.
      *
      * Possible failure codes include:
-     * - 401: the room does not exist (and this is the wrong API to create a new room)
      * - 403: the admin passkey is incorrect
+     * - 409: conflict - there is an ongoing call for this room.
      *
      * This request is idempotent; if it fails due to a network issue, it is safe to retry.
      *
@@ -196,9 +198,8 @@ export declare class RingRTCType {
      * @param authCredentialPresentation - a serialized CallLinkAuthCredentialPresentation
      * @param linkRootKey - the root key for the call link
      * @param adminPasskey - the passkey specified when the link was created
-     * @param revoked - whether the link should now be revoked
      */
-    updateCallLinkRevocation(sfuUrl: string, authCredentialPresentation: Buffer, linkRootKey: CallLinkRootKey, adminPasskey: Buffer, revoked: boolean): Promise<HttpResult<CallLinkState>>;
+    deleteCallLink(sfuUrl: string, authCredentialPresentation: Buffer, linkRootKey: CallLinkRootKey, adminPasskey: Buffer): Promise<HttpResult<undefined>>;
     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;
@@ -223,8 +224,9 @@ export declare class RingRTCType {
         revoked: boolean;
         expiration: Date;
     } | undefined): void;
+    handleEmptyResponse(requestId: number, statusCode: number, state: EmptyObj | undefined): void;
     handleEnded(clientId: GroupCallClientId, reason: GroupCallEndReason): void;
-    groupCallRingUpdate(groupId: GroupId, ringIdString: string, sender: GroupCallUserId, state: RingUpdate): void;
+    groupCallRingUpdate(groupId: GroupId, ringId: bigint, sender: GroupCallUserId, state: RingUpdate): void;
     onLogMessage(level: number, fileName: string, line: number, message: string): void;
     logError(message: string): void;
     logWarn(message: string): void;
@@ -252,7 +254,7 @@ export declare class RingRTCType {
     setAudioOutput(index: number): void;
 }
 export interface CallSettings {
-    iceServer: IceServer;
+    iceServers: Array<IceServer>;
     hideIp: boolean;
     dataMode: DataMode;
     audioLevelsIntervalMillis?: number;
@@ -260,6 +262,7 @@ export interface CallSettings {
 interface IceServer {
     username?: string;
     password?: string;
+    /** Provide hostname when urls contain IP addresses instead of hostname */
     hostname?: string;
     urls: Array<string>;
 }
@@ -573,7 +576,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, iceServerHostname: string, iceServerUrls: Array<string>, hideIp: boolean, dataMode: DataMode, audioLevelsIntervalMillis: number): void;
+    proceed(callId: CallId, iceServers: Array<IceServer>, hideIp: boolean, dataMode: DataMode, audioLevelsIntervalMillis: number): void;
     accept(callId: CallId): void;
     ignore(callId: CallId): void;
     hangup(): void;
@@ -621,6 +624,7 @@ export interface CallManager {
     readCallLink(requestId: number, sfuUrl: string, authCredentialPresentation: Buffer, linkRootKey: Buffer): void;
     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;
+    deleteCallLink(requestId: number, sfuUrl: string, authCredentialPresentation: Buffer, linkRootKey: Buffer, adminPasskey: Buffer): 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>;

package/dist/ringrtc/Service.js

@@ -33,6 +33,7 @@ class NativeCallManager {
         const fieldTrials = Object.assign({
             'RingRTC-AnyAddressPortsKillSwitch': 'Enabled',
             'WebRTC-Audio-OpusSetSignalVoiceWithDtx': 'Enabled',
+            'RingRTC-PruneTurnPorts': 'Enabled',
         }, config.field_trials);
         /* eslint-disable prefer-template */
         const fieldTrialsString = Object.entries(fieldTrials)
@@ -127,6 +128,7 @@ NativeCallManager.prototype.setMembershipProof =
 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.deleteCallLink = Native_1.default.cm_deleteCallLink;
 NativeCallManager.prototype.peekGroupCall = Native_1.default.cm_peekGroupCall;
 NativeCallManager.prototype.peekCallLinkCall =
     Native_1.default.cm_peekCallLinkCall;
@@ -236,6 +238,7 @@ class RingRTCType {
         this._groupCallByClientId = new Map();
         this._peekRequests = new Requests();
         this._callLinkRequests = new Requests();
+        this._emptyRequests = new Requests();
         this._callInfoByCallId = new Map();
     }
     setConfig(config) {
@@ -341,7 +344,7 @@ class RingRTCType {
     }
     proceed(callId, settings) {
         sillyDeadlockProtection(() => {
-            this.callManager.proceed(callId, settings.iceServer.username || '', settings.iceServer.password || '', settings.iceServer.hostname || '', settings.iceServer.urls, settings.hideIp, settings.dataMode, settings.audioLevelsIntervalMillis || 0);
+            this.callManager.proceed(callId, settings.iceServers, settings.hideIp, settings.dataMode, settings.audioLevelsIntervalMillis || 0);
         });
     }
     // Called by Rust
@@ -623,11 +626,11 @@ class RingRTCType {
         return promise;
     }
     /**
-     * Asynchronous request to revoke or un-revoke a call link.
+     * Asynchronous request to delete a call link.
      *
      * Possible failure codes include:
-     * - 401: the room does not exist (and this is the wrong API to create a new room)
      * - 403: the admin passkey is incorrect
+     * - 409: conflict - there is an ongoing call for this room.
      *
      * This request is idempotent; if it fails due to a network issue, it is safe to retry.
      *
@@ -635,13 +638,12 @@ class RingRTCType {
      * @param authCredentialPresentation - a serialized CallLinkAuthCredentialPresentation
      * @param linkRootKey - the root key for the call link
      * @param adminPasskey - the passkey specified when the link was created
-     * @param revoked - whether the link should now be revoked
      */
-    updateCallLinkRevocation(sfuUrl, authCredentialPresentation, linkRootKey, adminPasskey, revoked) {
-        const [requestId, promise] = this._callLinkRequests.add();
+    deleteCallLink(sfuUrl, authCredentialPresentation, linkRootKey, adminPasskey) {
+        const [requestId, promise] = this._emptyRequests.add();
         // Response comes back via handleCallLinkResponse
         sillyDeadlockProtection(() => {
-            this.callManager.updateCallLink(requestId, sfuUrl, authCredentialPresentation, linkRootKey.bytes, adminPasskey, undefined, undefined, revoked);
+            this.callManager.deleteCallLink(requestId, sfuUrl, authCredentialPresentation, linkRootKey.bytes, adminPasskey);
         });
         return promise;
     }
@@ -875,6 +877,21 @@ class RingRTCType {
         });
     }
     // Called by Rust
+    handleEmptyResponse(requestId, statusCode, state) {
+        sillyDeadlockProtection(() => {
+            let result;
+            if (state !== undefined) {
+                result = { success: true, value: undefined };
+            }
+            else {
+                result = { success: false, errorStatusCode: statusCode };
+            }
+            if (!this._emptyRequests.resolve(requestId, result)) {
+                this.logWarn(`Invalid request ID for handleEmptyResponse: ${requestId}`);
+            }
+        });
+    }
+    // Called by Rust
     handleEnded(clientId, reason) {
         sillyDeadlockProtection(() => {
             const groupCall = this._groupCallByClientId.get(clientId);
@@ -887,10 +904,9 @@ class RingRTCType {
         });
     }
     // Called by Rust
-    groupCallRingUpdate(groupId, ringIdString, sender, state) {
+    groupCallRingUpdate(groupId, ringId, sender, state) {
         sillyDeadlockProtection(() => {
             if (this.handleGroupCallRingUpdate) {
-                const ringId = BigInt(ringIdString);
                 this.handleGroupCallRingUpdate(groupId, ringId, sender, state);
             }
             else {

package/package.json

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