livekit-client 2.12.0 → 2.13.0

package/dist/livekit-client.esm.mjs

@@ -10763,6 +10763,12 @@ var RoomEvent;
    * args: (changedAttributes: [[Record<string, string]], participant: [[Participant]])
    */
   RoomEvent["ParticipantAttributesChanged"] = "participantAttributesChanged";
+  /**
+   * Emitted when the participant's state changes to ACTIVE and is ready to send/receive data messages
+   *
+   * args: (participant: [[Participant]])
+   */
+  RoomEvent["ParticipantActive"] = "participantActive";
   /**
    * Room metadata is a simple way for app-specific state to be pushed to
    * all users.
@@ -11057,6 +11063,10 @@ var ParticipantEvent;
   ParticipantEvent["LocalTrackSubscribed"] = "localTrackSubscribed";
   /** only emitted on local participant */
   ParticipantEvent["ChatMessage"] = "chatMessage";
+  /**
+   * Emitted when the participant's state changes to ACTIVE and is ready to send/receive data messages
+   */
+  ParticipantEvent["Active"] = "active";
 })(ParticipantEvent || (ParticipantEvent = {}));
 /** @internal */
 var EngineEvent;
@@ -11249,7 +11259,7 @@ function getOSVersion(ua) {
   return ua.includes('mac os') ? getMatch(/\(.+?(\d+_\d+(:?_\d+)?)/, ua, 1).replace(/_/g, '.') : undefined;
 }
 
-var version$1 = "2.12.0";
+var version$1 = "2.13.0";
 
 const version = version$1;
 const protocolVersion = 16;
@@ -17794,8 +17804,7 @@ class RTCEngine extends eventsExports.EventEmitter {
     }
     // create data channels
     this.lossyDC = this.pcManager.createPublisherDataChannel(lossyDataChannel, {
-      // will drop older packets that arrive
-      ordered: true,
+      ordered: false,
       maxRetransmits: 0
     });
     this.reliableDC = this.pcManager.createPublisherDataChannel(reliableDataChannel, {
@@ -19576,16 +19585,17 @@ function createLocalTracks(options, loggerOptions) {
         }
       });
     }
-    // TODO if internal options don't have device Id specified, set it to 'default'
     if (internalOptions.audio === true || typeof internalOptions.audio === 'object' && !internalOptions.audio.deviceId) {
       internalOptions.audio = {
         deviceId: 'default'
       };
     }
-    if (internalOptions.video === true || typeof internalOptions.video === 'object' && !internalOptions.video.deviceId) {
+    if (internalOptions.video === true) {
       internalOptions.video = {
         deviceId: 'default'
       };
+    } else if (typeof internalOptions.video === 'object' && !internalOptions.video.deviceId) {
+      internalOptions.video.deviceId = 'default';
     }
     const opts = mergeDefaultOptions(internalOptions, audioDefaults, videoDefaults);
     const constraints = constraintsForOptions(opts);
@@ -19742,6 +19752,10 @@ class Participant extends eventsExports.EventEmitter {
     var _a;
     return ((_a = this.permissions) === null || _a === void 0 ? void 0 : _a.agent) || this.kind === ParticipantInfo_Kind.AGENT;
   }
+  get isActive() {
+    var _a;
+    return ((_a = this.participantInfo) === null || _a === void 0 ? void 0 : _a.state) === ParticipantInfo_State.ACTIVE;
+  }
   get kind() {
     return this._kind;
   }
@@ -19797,6 +19811,25 @@ class Participant extends eventsExports.EventEmitter {
       }
     }
   }
+  /**
+   * Waits until the participant is active and ready to receive data messages
+   * @returns a promise that resolves when the participant is active
+   */
+  waitUntilActive() {
+    if (this.isActive) {
+      return Promise.resolve();
+    }
+    if (this.activeFuture) {
+      return this.activeFuture.promise;
+    }
+    this.activeFuture = new Future();
+    this.once(ParticipantEvent.Active, () => {
+      var _a, _b;
+      (_b = (_a = this.activeFuture) === null || _a === void 0 ? void 0 : _a.resolve) === null || _b === void 0 ? void 0 : _b.call(_a);
+      this.activeFuture = undefined;
+    });
+    return this.activeFuture.promise;
+  }
   get connectionQuality() {
     return this._connectionQuality;
   }
@@ -19826,6 +19859,7 @@ class Participant extends eventsExports.EventEmitter {
   }
   /** @internal */
   updateInfo(info) {
+    var _a;
     // it's possible the update could be applied out of order due to await
     // during reconnect sequences. when that happens, it's possible for server
     // to have sent more recent version of participant info while JS is waiting
@@ -19840,14 +19874,14 @@ class Participant extends eventsExports.EventEmitter {
     this._setName(info.name);
     this._setMetadata(info.metadata);
     this._setAttributes(info.attributes);
+    if (info.state === ParticipantInfo_State.ACTIVE && ((_a = this.participantInfo) === null || _a === void 0 ? void 0 : _a.state) !== ParticipantInfo_State.ACTIVE) {
+      this.emit(ParticipantEvent.Active);
+    }
     if (info.permission) {
       this.setPermissions(info.permission);
     }
     // set this last so setMetadata can detect changes
     this.participantInfo = info;
-    this.log.trace('update participant info', Object.assign(Object.assign({}, this.logContext), {
-      info
-    }));
     return true;
   }
   /**
@@ -19911,6 +19945,16 @@ class Participant extends eventsExports.EventEmitter {
       this.emit(ParticipantEvent.ConnectionQualityChanged, this._connectionQuality);
     }
   }
+  /**
+   * @internal
+   */
+  setDisconnected() {
+    var _a, _b;
+    if (this.activeFuture) {
+      (_b = (_a = this.activeFuture).reject) === null || _b === void 0 ? void 0 : _b.call(_a, new Error('Participant disconnected'));
+      this.activeFuture = undefined;
+    }
+  }
   /**
    * @internal
    */
@@ -21437,6 +21481,7 @@ class LocalParticipant extends Participant {
         streamId,
         topic: info.topic,
         timestamp: numberToBigInt(Date.now()),
+        attributes: info.attributes,
         contentHeader: {
           case: 'byteHeader',
           value: new DataStream_ByteHeader({
@@ -23741,6 +23786,7 @@ class Room extends eventsExports.EventEmitter {
       participant.unpublishTrack(publication.trackSid, true);
     });
     this.emit(RoomEvent.ParticipantDisconnected, participant);
+    participant.setDisconnected();
     (_a = this.localParticipant) === null || _a === void 0 ? void 0 : _a.handleParticipantDisconnected(participant.identity);
   }
   handleStreamHeader(streamHeader, participantIdentity) {
@@ -23947,6 +23993,8 @@ class Room extends eventsExports.EventEmitter {
       this.emit(RoomEvent.TrackSubscriptionFailed, trackSid, participant, error);
     }).on(ParticipantEvent.TrackSubscriptionPermissionChanged, (pub, status) => {
       this.emitWhenConnected(RoomEvent.TrackSubscriptionPermissionChanged, pub, status, participant);
+    }).on(ParticipantEvent.Active, () => {
+      this.emitWhenConnected(RoomEvent.ParticipantActive, participant);
     });
     // update info at the end after callbacks have been set up
     if (info) {