livekit-client 2.1.5 → 2.3.0

package/dist/ts4.2/src/room/participant/Participant.d.ts

@@ -1,4 +1,5 @@
-import { DataPacket_Kind, ParticipantInfo, ParticipantPermission, ConnectionQuality as ProtoQuality, SubscriptionError } from '@livekit/protocol';
+import type { SipDTMF } from '@livekit/protocol';
+import { DataPacket_Kind, ParticipantInfo, ParticipantInfo_Kind as ParticipantKind, ParticipantPermission, ConnectionQuality as ProtoQuality, SubscriptionError } from '@livekit/protocol';
 import type TypedEmitter from 'typed-emitter';
 import { StructuredLogger } from '../../logger';
 import type LocalTrackPublication from '../track/LocalTrackPublication';
@@ -18,6 +19,7 @@ export declare enum ConnectionQuality {
     Lost = "lost",
     Unknown = "unknown"
 }
+export { ParticipantKind };
 declare const Participant_base: new () => TypedEmitter<ParticipantEventCallbacks>;
 export default class Participant extends Participant_base {
     protected participantInfo?: ParticipantInfo;
@@ -39,6 +41,7 @@ export default class Participant extends Participant_base {
     metadata?: string;
     lastSpokeAt?: Date | undefined;
     permissions?: ParticipantPermission;
+    protected _kind: ParticipantKind;
     private _connectionQuality;
     protected audioContext?: AudioContext;
     protected log: StructuredLogger;
@@ -48,8 +51,9 @@ export default class Participant extends Participant_base {
     };
     get isEncrypted(): boolean;
     get isAgent(): boolean;
+    get kind(): ParticipantKind;
     /** @internal */
-    constructor(sid: string, identity: string, name?: string, metadata?: string, loggerOptions?: LoggerOptions);
+    constructor(sid: string, identity: string, name?: string, metadata?: string, loggerOptions?: LoggerOptions, kind?: ParticipantKind);
     getTrackPublications(): TrackPublication[];
     /**
      * Finds the first track that matches the source filter, for example, getting
@@ -99,6 +103,7 @@ export type ParticipantEventCallbacks = {
     participantMetadataChanged: (prevMetadata: string | undefined, participant?: any) => void;
     participantNameChanged: (name: string) => void;
     dataReceived: (payload: Uint8Array, kind: DataPacket_Kind) => void;
+    sipDTMFReceived: (dtmf: SipDTMF) => void;
     transcriptionReceived: (transcription: TranscriptionSegment[], publication?: TrackPublication) => void;
     isSpeakingChanged: (speaking: boolean) => void;
     connectionQualityChanged: (connectionQuality: ConnectionQuality) => void;
@@ -109,5 +114,4 @@ export type ParticipantEventCallbacks = {
     participantPermissionsChanged: (prevPermissions?: ParticipantPermission) => void;
     trackSubscriptionStatusChanged: (publication: RemoteTrackPublication, status: TrackPublication.SubscriptionStatus) => void;
 };
-export {};
 //# sourceMappingURL=Participant.d.ts.map

package/dist/ts4.2/src/room/participant/RemoteParticipant.d.ts

@@ -5,7 +5,7 @@ import { Track } from '../track/Track';
 import type { AudioOutputOptions } from '../track/options';
 import type { AdaptiveStreamSettings } from '../track/types';
 import type { LoggerOptions } from '../types';
-import Participant from './Participant';
+import Participant, { ParticipantKind } from './Participant';
 import type { ParticipantEventCallbacks } from './Participant';
 export default class RemoteParticipant extends Participant {
     audioTrackPublications: Map<string, RemoteTrackPublication>;
@@ -15,13 +15,13 @@ export default class RemoteParticipant extends Participant {
     private volumeMap;
     private audioOutput?;
     /** @internal */
-    static fromParticipantInfo(signalClient: SignalClient, pi: ParticipantInfo): RemoteParticipant;
+    static fromParticipantInfo(signalClient: SignalClient, pi: ParticipantInfo, loggerOptions: LoggerOptions): RemoteParticipant;
     protected get logContext(): {
         rpID: string;
         remoteParticipant: string;
     };
     /** @internal */
-    constructor(signalClient: SignalClient, sid: string, identity?: string, name?: string, metadata?: string, loggerOptions?: LoggerOptions);
+    constructor(signalClient: SignalClient, sid: string, identity?: string, name?: string, metadata?: string, loggerOptions?: LoggerOptions, kind?: ParticipantKind);
     protected addTrackPublication(publication: RemoteTrackPublication): void;
     getTrackPublication(source: Track.Source): RemoteTrackPublication | undefined;
     getTrackPublicationByName(name: string): RemoteTrackPublication | undefined;

package/dist/ts4.2/src/room/track/LocalTrack.d.ts

@@ -91,7 +91,7 @@ export default abstract class LocalTrack<TrackKind extends Track.Kind = Track.Ki
      * @experimental
      * @returns
      */
-    stopProcessor(): Promise<void>;
+    stopProcessor(keepElement?: boolean): Promise<void>;
     protected abstract monitorSender(): void;
 }
 //# sourceMappingURL=LocalTrack.d.ts.map

package/dist/ts4.2/src/room/track/LocalVideoTrack.d.ts

@@ -42,7 +42,7 @@ export default class LocalVideoTrack extends LocalTrack<Track.Kind.Video> {
     setPublishingQuality(maxQuality: VideoQuality): void;
     setDeviceId(deviceId: ConstrainDOMString): Promise<boolean>;
     restartTrack(options?: VideoCaptureOptions): Promise<void>;
-    setProcessor(processor: TrackProcessor<Track.Kind>, showProcessedStreamLocally?: boolean): Promise<void>;
+    setProcessor(processor: TrackProcessor<Track.Kind.Video>, showProcessedStreamLocally?: boolean): Promise<void>;
     setDegradationPreference(preference: RTCDegradationPreference): Promise<void>;
     addSimulcastTrack(codec: VideoCodec, encodings?: RTCRtpEncodingParameters[]): SimulcastTrackInfo | undefined;
     setSimulcastTrackSender(codec: VideoCodec, sender: RTCRtpSender): void;

package/dist/ts4.2/src/room/track/options.d.ts

@@ -1,4 +1,5 @@
 import type { Track } from './Track';
+import type { AudioProcessorOptions, TrackProcessor, VideoProcessorOptions } from './processor/types';
 export interface TrackPublishDefaults {
     /**
      * encoding parameters for camera track
@@ -133,6 +134,10 @@ export interface VideoCaptureOptions {
      */
     facingMode?: 'user' | 'environment' | 'left' | 'right';
     resolution?: VideoResolution;
+    /**
+     * initialize the track with a given processor
+     */
+    processor?: TrackProcessor<Track.Kind.Video, VideoProcessorOptions>;
 }
 export interface ScreenShareCaptureOptions {
     /**
@@ -210,6 +215,10 @@ export interface AudioCaptureOptions {
      * sample size or range of sample sizes which are acceptable and/or required.
      */
     sampleSize?: ConstrainULong;
+    /**
+     * initialize the track with a given processor
+     */
+    processor?: TrackProcessor<Track.Kind.Audio, AudioProcessorOptions>;
 }
 export interface AudioOutputOptions {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "livekit-client",
-  "version": "2.1.5",
+  "version": "2.3.0",
   "description": "JavaScript/TypeScript client SDK for LiveKit",
   "main": "./dist/livekit-client.umd.js",
   "unpkg": "./dist/livekit-client.umd.js",
@@ -46,13 +46,13 @@
     "webrtc-adapter": "^8.1.1"
   },
   "devDependencies": {
-    "@babel/core": "7.24.5",
-    "@babel/preset-env": "7.24.5",
+    "@babel/core": "7.24.6",
+    "@babel/preset-env": "7.24.6",
     "@bufbuild/protoc-gen-es": "^1.3.0",
-    "@changesets/cli": "2.27.1",
+    "@changesets/cli": "2.27.5",
     "@livekit/changesets-changelog-github": "^0.0.4",
     "@rollup/plugin-babel": "6.0.4",
-    "@rollup/plugin-commonjs": "25.0.7",
+    "@rollup/plugin-commonjs": "25.0.8",
     "@rollup/plugin-json": "6.1.0",
     "@rollup/plugin-node-resolve": "15.2.3",
     "@rollup/plugin-terser": "^0.4.0",
@@ -62,8 +62,8 @@
     "@types/events": "^3.0.0",
     "@types/sdp-transform": "2.4.9",
     "@types/ua-parser-js": "0.7.39",
-    "@typescript-eslint/eslint-plugin": "5.62.0",
-    "@typescript-eslint/parser": "5.62.0",
+    "@typescript-eslint/eslint-plugin": "7.12.0",
+    "@typescript-eslint/parser": "7.12.0",
     "downlevel-dts": "^0.11.0",
     "eslint": "8.57.0",
     "eslint-config-airbnb-typescript": "18.0.0",
@@ -73,7 +73,7 @@
     "gh-pages": "6.1.1",
     "jsdom": "^24.0.0",
     "prettier": "^3.0.0",
-    "rollup": "4.17.2",
+    "rollup": "4.18.0",
     "rollup-plugin-delete": "^2.0.0",
     "rollup-plugin-re": "1.0.7",
     "rollup-plugin-typescript2": "0.36.0",
@@ -81,7 +81,7 @@
     "typedoc": "0.25.13",
     "typedoc-plugin-no-inherit": "1.4.0",
     "typescript": "5.4.5",
-    "vite": "5.2.10",
+    "vite": "5.2.12",
     "vitest": "^1.0.0"
   },
   "scripts": {

package/src/index.ts

@@ -3,7 +3,7 @@ import { LogLevel, LoggerNames, getLogger, setLogExtension, setLogLevel } from '
 import DefaultReconnectPolicy from './room/DefaultReconnectPolicy';
 import Room, { ConnectionState } from './room/Room';
 import LocalParticipant from './room/participant/LocalParticipant';
-import Participant, { ConnectionQuality } from './room/participant/Participant';
+import Participant, { ConnectionQuality, ParticipantKind } from './room/participant/Participant';
 import type { ParticipantTrackPermission } from './room/participant/ParticipantTrackPermission';
 import RemoteParticipant from './room/participant/RemoteParticipant';
 import CriticalTimers from './room/timers';
@@ -63,6 +63,7 @@ export {
   Participant,
   RemoteAudioTrack,
   RemoteParticipant,
+  ParticipantKind,
   RemoteTrack,
   RemoteTrackPublication,
   RemoteVideoTrack,

package/src/room/DeviceManager.test.ts

@@ -0,0 +1,105 @@
+import { describe, expect, it } from 'vitest';
+import DeviceManager from './DeviceManager';
+
+class MockDeviceManager extends DeviceManager {
+  dummyDevices?: MediaDeviceInfo[];
+
+  async getDevices(
+    kind?: MediaDeviceKind | undefined,
+    requestPermissions?: boolean,
+  ): Promise<MediaDeviceInfo[]> {
+    if (this.dummyDevices) {
+      return this.dummyDevices;
+    } else {
+      return super.getDevices(kind, requestPermissions);
+    }
+  }
+}
+
+describe('Active device switch', () => {
+  const deviceManager = new MockDeviceManager();
+  it('normalizes default ID correctly', async () => {
+    deviceManager.dummyDevices = [
+      {
+        deviceId: 'default',
+        kind: 'audiooutput',
+        label: 'Default - Speakers (Intel® Smart Sound Technology for I2S Audio)',
+        groupId: 'c94fea7109a30d468722f3b7778302c716d683a619f41b264b0cf8b2ec202d9g',
+        toJSON: () => 'dummy',
+      },
+      {
+        deviceId: 'communications',
+        kind: 'audiooutput',
+        label: 'Communications - Speakers (2- USB Advanced Audio Device) (0d8c:016c)',
+        groupId: '5146b7ad442c53c9366b141edceca8be30c0a4b31c181968cc732a100176e765',
+        toJSON: () => 'dummy',
+      },
+      {
+        deviceId: 'bfbbf4fbdba0ce0b12159f2f615ba856bdf17743d8b791265db22952d98c28cf',
+        kind: 'audiooutput',
+        label: 'Speakers (2- USB Advanced Audio Device) (0d8c:016c)',
+        groupId: '5146b7ad442c53c9366b141edceca8be30c0a4b31c181968cc732a100176e765',
+        toJSON: () => 'dummy',
+      },
+      {
+        deviceId: '6ca3eb8140dc3d2919d6747f73d8277e6ecaf0f179426695154e98615bafd2b9',
+        kind: 'audiooutput',
+        label: 'Speakers (Intel® Smart Sound Technology for I2S Audio)',
+        groupId: 'c94fea7109a30d468722f3b7778302c716d683a619f41b264b0cf8b2ec202d9g',
+        toJSON: () => 'dummy',
+      },
+    ];
+
+    const normalizedID = await deviceManager.normalizeDeviceId('audiooutput', 'default');
+    expect(normalizedID).toBe('6ca3eb8140dc3d2919d6747f73d8277e6ecaf0f179426695154e98615bafd2b9');
+  });
+  it('returns undefined when default cannot be determined', async () => {
+    deviceManager.dummyDevices = [
+      {
+        deviceId: 'default',
+        kind: 'audiooutput',
+        label: 'Default',
+        groupId: 'default',
+        toJSON: () => 'dummy',
+      },
+      {
+        deviceId: 'd5a1ad8b1314736ad1936aae1d74fa524f954c3281b4af3b65b2492330c3a830',
+        kind: 'audiooutput',
+        label: 'Alder Lake PCH-P High Definition Audio Controller HDMI / DisplayPort 3 Output',
+        groupId: 'af6745746c55f7697eadbb5e31a8f28ef836b4d8aefdc3655189a9e7d81eb8d',
+        toJSON: () => 'dummy',
+      },
+      {
+        deviceId: '093f4e51743557382b19da4c0250869b9c6d176423b241f0d52ed665f636e9d2',
+        kind: 'audiooutput',
+        label: 'Alder Lake PCH-P High Definition Audio Controller HDMI / DisplayPort 2 Output',
+        groupId: 'e53791b0ce4bad2b3a515cb1e154acf4758bb563b11942949130190d5c2e0d4',
+        toJSON: () => 'dummy',
+      },
+      {
+        deviceId: 'a6ffa042ac4a88e9ff552ce50b016d0bbf60a9e3c2173a444b064ef1aa022fb5',
+        kind: 'audiooutput',
+        label: 'Alder Lake PCH-P High Definition Audio Controller HDMI / DisplayPort 1 Output',
+        groupId: '69bb8042d093e8b33e9c33710cdfb8c0bba08889904b012e1a186704d74b39a',
+        toJSON: () => 'dummy',
+      },
+      {
+        deviceId: 'd746e22bcfa3f8f76dfce7ee887612982c226eb1f2ed77502ed621b9d7cdae00',
+        kind: 'audiooutput',
+        label: 'Alder Lake PCH-P High Definition Audio Controller Speaker + Headphones',
+        groupId: 'd08b9d0b8d1460c8c120333bdcbc42fbb92fa8e902926fb8b1f35d43ad7f10f',
+        toJSON: () => 'dummy',
+      },
+      {
+        deviceId: 'c43858eb7092870122d5bc3af7b7b7e2f9baf9b3aa829adb34cc84c9f65538a3',
+        kind: 'audiooutput',
+        label: 'T11',
+        groupId: '1ecff3666059160ac3ae559e97286de0ee2487bce8808e9040cba26805d3e15',
+        toJSON: () => 'dummy',
+      },
+    ];
+
+    const normalizedID = await deviceManager.normalizeDeviceId('audiooutput', 'default');
+    expect(normalizedID).toBe(undefined);
+  });
+});

package/src/room/DeviceManager.ts

@@ -80,17 +80,22 @@ export default class DeviceManager {
     // device has been chosen
     const devices = await this.getDevices(kind);
 
-    // `default` devices will have the same groupId as the entry with the actual device id so we store the counts for each group id
-    const groupIdCounts = new Map(devices.map((d) => [d.groupId, 0]));
+    const defaultDevice = devices.find((d) => d.deviceId === defaultId);
 
-    devices.forEach((d) => groupIdCounts.set(d.groupId, (groupIdCounts.get(d.groupId) ?? 0) + 1));
+    if (!defaultDevice) {
+      log.warn('could not reliably determine default device');
+      return undefined;
+    }
 
     const device = devices.find(
-      (d) =>
-        (groupId === d.groupId || (groupIdCounts.get(d.groupId) ?? 0) > 1) &&
-        d.deviceId !== defaultId,
+      (d) => d.deviceId !== defaultId && d.groupId === (groupId ?? defaultDevice.groupId),
     );
 
+    if (!device) {
+      log.warn('could not reliably determine default device');
+      return undefined;
+    }
+
     return device?.deviceId;
   }
 

package/src/room/RTCEngine.ts

@@ -26,7 +26,7 @@ import {
   TrackUnpublishedResponse,
   Transcription,
   UpdateSubscription,
-  UserPacket,
+  type UserPacket,
 } from '@livekit/protocol';
 import { EventEmitter } from 'events';
 import type { MediaAttributes } from 'sdp-transform';
@@ -648,10 +648,12 @@ export default class RTCEngine extends (EventEmitter as new () => TypedEventEmit
       if (dp.value?.case === 'speaker') {
         // dispatch speaker updates
         this.emit(EngineEvent.ActiveSpeakersUpdate, dp.value.value.speakers);
-      } else if (dp.value?.case === 'user') {
-        this.emit(EngineEvent.DataPacketReceived, dp.value.value, dp.kind);
-      } else if (dp.value?.case === 'transcription') {
-        this.emit(EngineEvent.TranscriptionReceived, dp.value.value);
+      } else {
+        if (dp.value?.case === 'user') {
+          // compatibility
+          applyUserDataCompat(dp, dp.value.value);
+        }
+        this.emit(EngineEvent.DataPacketReceived, dp);
       }
     } finally {
       unlock();
@@ -1392,7 +1394,7 @@ export type EngineEventCallbacks = {
     receiver?: RTCRtpReceiver,
   ) => void;
   activeSpeakersUpdate: (speakers: Array<SpeakerInfo>) => void;
-  dataPacketReceived: (userPacket: UserPacket, kind: DataPacket_Kind) => void;
+  dataPacketReceived: (packet: DataPacket) => void;
   transcriptionReceived: (transcription: Transcription) => void;
   transportsCreated: (publisher: PCTransport, subscriber: PCTransport) => void;
   /** @internal */
@@ -1415,3 +1417,18 @@ export type EngineEventCallbacks = {
 function supportOptionalDatachannel(protocol: number | undefined): boolean {
   return protocol !== undefined && protocol > 13;
 }
+
+function applyUserDataCompat(newObj: DataPacket, oldObj: UserPacket) {
+  const participantIdentity = newObj.participantIdentity
+    ? newObj.participantIdentity
+    : oldObj.participantIdentity;
+  newObj.participantIdentity = participantIdentity;
+  oldObj.participantIdentity = participantIdentity;
+
+  const destinationIdentities =
+    newObj.destinationIdentities.length !== 0
+      ? newObj.destinationIdentities
+      : oldObj.destinationIdentities;
+  newObj.destinationIdentities = destinationIdentities;
+  oldObj.destinationIdentities = destinationIdentities;
+}

package/src/room/Room.ts

@@ -1,5 +1,6 @@
 import {
   ConnectionQualityUpdate,
+  type DataPacket,
   DataPacket_Kind,
   DisconnectReason,
   JoinResponse,
@@ -11,6 +12,7 @@ import {
   Room as RoomModel,
   ServerInfo,
   SimulateScenario,
+  SipDTMF,
   SpeakerInfo,
   StreamStateUpdate,
   SubscriptionError,
@@ -86,9 +88,10 @@ export enum ConnectionState {
   Connecting = 'connecting',
   Connected = 'connected',
   Reconnecting = 'reconnecting',
+  SignalReconnecting = 'signalReconnecting',
 }
 
-const connectionReconcileFrequency = 2 * 1000;
+const connectionReconcileFrequency = 4 * 1000;
 
 /**
  * In LiveKit, a room is the logical grouping for a list of participants.
@@ -334,11 +337,13 @@ class Room extends (EventEmitter as new () => TypedEmitter<RoomEventCallbacks>)
       })
       .on(EngineEvent.ActiveSpeakersUpdate, this.handleActiveSpeakersUpdate)
       .on(EngineEvent.DataPacketReceived, this.handleDataPacket)
-      .on(EngineEvent.TranscriptionReceived, this.handleTranscription)
       .on(EngineEvent.Resuming, () => {
         this.clearConnectionReconcile();
         this.isResuming = true;
         this.log.info('Resuming signal connection', this.logContext);
+        if (this.setAndEmitConnectionState(ConnectionState.SignalReconnecting)) {
+          this.emit(RoomEvent.SignalReconnecting);
+        }
       })
       .on(EngineEvent.Resumed, () => {
         this.registerConnectionReconcile();
@@ -346,6 +351,9 @@ class Room extends (EventEmitter as new () => TypedEmitter<RoomEventCallbacks>)
         this.log.info('Resumed signal connection', this.logContext);
         this.updateSubscriptions();
         this.emitBufferedEvents();
+        if (this.setAndEmitConnectionState(ConnectionState.Connected)) {
+          this.emit(RoomEvent.Reconnected);
+        }
       })
       .on(EngineEvent.SignalResumed, () => {
         this.bufferedEvents = [];
@@ -1085,11 +1093,12 @@ class Room extends (EventEmitter as new () => TypedEmitter<RoomEventCallbacks>)
         if (this.options.webAudioMix) {
           // @ts-expect-error setSinkId is not yet in the typescript type of AudioContext
           this.audioContext?.setSinkId(deviceId);
-        } else {
-          await Promise.all(
-            Array.from(this.remoteParticipants.values()).map((p) => p.setAudioOutput({ deviceId })),
-          );
         }
+        // also set audio output on all audio elements, even if webAudioMix is enabled in order to workaround echo cancellation not working on chrome with non-default output devices
+        // see https://issues.chromium.org/issues/40252911#comment7
+        await Promise.all(
+          Array.from(this.remoteParticipants.values()).map((p) => p.setAudioOutput({ deviceId })),
+        );
       } catch (e) {
         this.options.audioOutput.deviceId = prevDeviceId;
         throw e;
@@ -1472,24 +1481,47 @@ class Room extends (EventEmitter as new () => TypedEmitter<RoomEventCallbacks>)
     pub.setSubscriptionError(update.err);
   };
 
-  private handleDataPacket = (userPacket: UserPacket, kind: DataPacket_Kind) => {
+  private handleDataPacket = (packet: DataPacket) => {
     // find the participant
-    const participant = this.remoteParticipants.get(userPacket.participantIdentity);
+    const participant = this.remoteParticipants.get(packet.participantIdentity);
+    if (packet.value.case === 'user') {
+      this.handleUserPacket(participant, packet.value.value, packet.kind);
+    } else if (packet.value.case === 'transcription') {
+      this.handleTranscription(participant, packet.value.value);
+    } else if (packet.value.case === 'sipDtmf') {
+      this.handleSipDtmf(participant, packet.value.value);
+    }
+  };
 
+  private handleUserPacket = (
+    participant: RemoteParticipant | undefined,
+    userPacket: UserPacket,
+    kind: DataPacket_Kind,
+  ) => {
     this.emit(RoomEvent.DataReceived, userPacket.payload, participant, kind, userPacket.topic);
 
     // also emit on the participant
     participant?.emit(ParticipantEvent.DataReceived, userPacket.payload, kind);
   };
 
+  private handleSipDtmf = (participant: RemoteParticipant | undefined, dtmf: SipDTMF) => {
+    this.emit(RoomEvent.SipDTMFReceived, dtmf, participant);
+
+    // also emit on the participant
+    participant?.emit(ParticipantEvent.SipDTMFReceived, dtmf);
+  };
+
   bufferedSegments: Map<string, TranscriptionSegmentModel> = new Map();
 
-  private handleTranscription = (transcription: TranscriptionModel) => {
+  private handleTranscription = (
+    remoteParticipant: RemoteParticipant | undefined,
+    transcription: TranscriptionModel,
+  ) => {
     // find the participant
     const participant =
       transcription.participantIdentity === this.localParticipant.identity
         ? this.localParticipant
-        : this.remoteParticipants.get(transcription.participantIdentity);
+        : remoteParticipant;
     const publication = participant?.trackPublications.get(transcription.trackId);
 
     const segments = extractTranscriptionSegments(transcription);
@@ -1596,7 +1628,10 @@ class Room extends (EventEmitter as new () => TypedEmitter<RoomEventCallbacks>)
   private createParticipant(identity: string, info?: ParticipantInfo): RemoteParticipant {
     let participant: RemoteParticipant;
     if (info) {
-      participant = RemoteParticipant.fromParticipantInfo(this.engine.client, info);
+      participant = RemoteParticipant.fromParticipantInfo(this.engine.client, info, {
+        loggerContextCb: () => this.logContext,
+        loggerName: this.options.loggerName,
+      });
     } else {
       participant = new RemoteParticipant(this.engine.client, '', identity, undefined, undefined, {
         loggerContextCb: () => this.logContext,
@@ -2051,6 +2086,7 @@ export default Room;
 export type RoomEventCallbacks = {
   connected: () => void;
   reconnecting: () => void;
+  signalReconnecting: () => void;
   reconnected: () => void;
   disconnected: (reason?: DisconnectReason) => void;
   connectionStateChanged: (state: ConnectionState) => void;
@@ -2099,6 +2135,7 @@ export type RoomEventCallbacks = {
     kind?: DataPacket_Kind,
     topic?: string,
   ) => void;
+  sipDTMFReceived: (dtmf: SipDTMF, participant?: RemoteParticipant) => void;
   transcriptionReceived: (
     transcription: TranscriptionSegment[],
     participant?: Participant,

package/src/room/defaults.ts

@@ -37,7 +37,7 @@ export const roomOptionDefaults: InternalRoomOptions = {
   stopLocalTrackOnUnpublish: true,
   reconnectPolicy: new DefaultReconnectPolicy(),
   disconnectOnPageLeave: true,
-  webAudioMix: true,
+  webAudioMix: false,
 } as const;
 
 export const roomConnectOptionDefaults: InternalRoomConnectOptions = {

package/src/room/events.ts

@@ -20,6 +20,13 @@ export enum RoomEvent {
    */
   Reconnecting = 'reconnecting',
 
+  /**
+   * When the signal connection to the server has been interrupted. This isn't noticeable to users most of the time.
+   * It will resolve with a `RoomEvent.Reconnected` once the signal connection has been re-established.
+   * If media fails additionally it an additional `RoomEvent.Reconnecting` will be emitted.
+   */
+  SignalReconnecting = 'signalReconnecting',
+
   /**
    * Fires when a reconnection has been successful.
    */
@@ -197,6 +204,13 @@ export enum RoomEvent {
    */
   DataReceived = 'dataReceived',
 
+  /**
+   * SIP DTMF tones received from another participant.
+   *
+   * args: (participant: [[Participant]], dtmf: [[DataPacket_Kind]])
+   */
+  SipDTMFReceived = 'sipDTMFReceived',
+
   /**
    * Transcription received from a participant's track.
    * @beta
@@ -408,6 +422,13 @@ export enum ParticipantEvent {
    */
   DataReceived = 'dataReceived',
 
+  /**
+   * SIP DTMF tones received from this participant as sender.
+   *
+   * args: (dtmf: [[DataPacket_Kind]])
+   */
+  SipDTMFReceived = 'sipDTMFReceived',
+
   /**
    * Transcription received from this participant as data source.
    * @beta
@@ -491,7 +512,6 @@ export enum EngineEvent {
   MediaTrackAdded = 'mediaTrackAdded',
   ActiveSpeakersUpdate = 'activeSpeakersUpdate',
   DataPacketReceived = 'dataPacketReceived',
-  TranscriptionReceived = 'transcriptionReceived',
   RTPVideoMapUpdate = 'rtpVideoMapUpdate',
   DCBufferStatusChanged = 'dcBufferStatusChanged',
   ParticipantUpdate = 'participantUpdate',