livekit-client 2.19.2 → 2.20.0

package/dist/livekit-client.esm.mjs

@@ -8776,8 +8776,7 @@ function requireEvents() {
     }
   }
   return events.exports;
-}var eventsExports = requireEvents();
-var EventEmitter = /*@__PURE__*/getDefaultExportFromCjs(eventsExports);/*
+}var eventsExports = requireEvents();/*
  *  Copyright (c) 2016 The WebRTC project authors. All Rights Reserved.
  *
  *  Use of this source code is governed by a BSD-style license
@@ -11844,7 +11843,7 @@ function getMatch(exp, ua) {
 }
 function getOSVersion(ua) {
   return ua.includes('mac os') ? getMatch(/\(.+?(\d+_\d+(:?_\d+)?)/, ua, 1).replace(/_/g, '.') : undefined;
-}var version$1 = "2.19.2";const version = version$1;
+}var version$1 = "2.20.0";const version = version$1;
 const protocolVersion = 17;
 /** Initial client protocol. */
 const CLIENT_PROTOCOL_DEFAULT = 0;
@@ -14443,16 +14442,16 @@ class CryptorError extends LivekitError {
     this.reason = reason;
     this.participantIdentity = participantIdentity;
   }
-}function shouldUsePacketTrailerScriptTransform() {
+}function shouldUseFrameMetadataScriptTransform() {
   return isScriptTransformSupportedForWorker();
 }
-function isPacketTrailerSupported(options) {
-  return !!(options === null || options === void 0 ? void 0 : options.worker) && (isInsertableStreamSupported() || shouldUsePacketTrailerScriptTransform());
+function isFrameMetadataSupported(options) {
+  return !!(options === null || options === void 0 ? void 0 : options.worker) && (isInsertableStreamSupported() || shouldUseFrameMetadataScriptTransform());
 }
-function hasPacketTrailerPublishOptions(options) {
+function hasFrameMetadataPublishOptions(options) {
   return !!((options === null || options === void 0 ? void 0 : options.timestamp) || (options === null || options === void 0 ? void 0 : options.frameId));
 }
-function getPacketTrailerFeatures(options) {
+function getFrameMetadataFeatures(options) {
   const features = [];
   if (options === null || options === void 0 ? void 0 : options.timestamp) {
     features.push(PacketTrailerFeature.PTF_USER_TIMESTAMP);
@@ -14462,7 +14461,7 @@ function getPacketTrailerFeatures(options) {
   }
   return features;
 }
-function getPacketTrailerPublishOptions(features) {
+function getFrameMetadataPublishOptions(features) {
   if (!features || features.length === 0) {
     return undefined;
   }
@@ -14736,14 +14735,14 @@ class RemoteVideoTrack extends RemoteTrack {
    * Use with the `TrackEvent.TimeSyncUpdate` event to correlate displayed frames
    * with their capture-time metadata.
    *
-   * Requires the room to be configured with the `packetTrailer` worker option
-   * and the publishing track to have packet trailer features enabled.
+   * Requires the room to be configured with the `frameMetadata` worker option
+   * and the publishing track to have frame metadata features enabled.
    *
    */
   lookupFrameMetadata(_ref) {
     let rtpTimestamp = _ref.rtpTimestamp;
     var _a;
-    return (_a = this.packetTrailerExtractor) === null || _a === void 0 ? void 0 : _a.lookupMetadata(rtpTimestamp);
+    return (_a = this.frameMetadataExtractor) === null || _a === void 0 ? void 0 : _a.lookupMetadata(rtpTimestamp);
   }
   setStreamState(value) {
     super.setStreamState(value);
@@ -15136,7 +15135,7 @@ class E2EEManager extends eventsExports.EventEmitter {
           }
           break;
         case 'packetTrailerMetadata':
-          this.handlePacketTrailerMetadata(data.trackId, data.rtpTimestamp, data.ssrc, data.metadata);
+          this.handleFrameMetadata(data.trackId, data.rtpTimestamp, data.ssrc, data.metadata);
           break;
       }
     };
@@ -15203,14 +15202,14 @@ class E2EEManager extends eventsExports.EventEmitter {
       this.postSifTrailer(trailer);
     }
   }
-  handlePacketTrailerMetadata(trackId, rtpTimestamp, ssrc, metadata) {
+  handleFrameMetadata(trackId, rtpTimestamp, ssrc, metadata) {
     if (!this.room) {
       return;
     }
     for (const participant of [this.room.localParticipant, ...this.room.remoteParticipants.values()]) {
       for (const pub of participant.trackPublications.values()) {
-        if (pub.track && pub.track.mediaStreamID === trackId && pub.track instanceof RemoteVideoTrack && pub.track.packetTrailerExtractor) {
-          pub.track.packetTrailerExtractor.storeMetadata(rtpTimestamp, ssrc, metadata);
+        if (pub.track && pub.track.mediaStreamID === trackId && pub.track instanceof RemoteVideoTrack && pub.track.frameMetadataExtractor) {
+          pub.track.frameMetadataExtractor.storeMetadata(rtpTimestamp, ssrc, metadata);
           return;
         }
       }
@@ -15408,12 +15407,12 @@ class E2EEManager extends eventsExports.EventEmitter {
     this.handleReceiver(track.receiver, track.mediaStreamID, remoteId, track.kind === 'video' ? mimeTypeToVideoCodecString(trackInfo.mimeType) : undefined, hasPacketTrailer);
   }
   setupE2EESender(track, sender) {
-    var _a;
+    var _a, _b, _c;
     if (!isLocalTrack(track) || !sender) {
       if (!sender) livekitLogger.warn('early return because sender is not ready');
       return;
     }
-    this.handleSender(sender, track.mediaStreamID, undefined, isVideoTrack(track) ? (_a = track.publishOptions) === null || _a === void 0 ? void 0 : _a.packetTrailer : undefined);
+    this.handleSender(sender, track.mediaStreamID, undefined, isVideoTrack(track) ? (_b = (_a = track.publishOptions) === null || _a === void 0 ? void 0 : _a.frameMetadata) !== null && _b !== void 0 ? _b : (_c = track.publishOptions) === null || _c === void 0 ? void 0 : _c.packetTrailer : undefined);
   }
   /**
    * Handles the given {@code RTCRtpReceiver} by creating a {@code TransformStream} which will inject
@@ -15487,7 +15486,7 @@ class E2EEManager extends eventsExports.EventEmitter {
    * a frame encoder.
    *
    */
-  handleSender(sender, trackId, codec, packetTrailer) {
+  handleSender(sender, trackId, codec, frameMetadata) {
     var _a;
     if (E2EE_FLAG in sender || !this.worker) {
       return;
@@ -15502,8 +15501,8 @@ class E2EEManager extends eventsExports.EventEmitter {
         participantIdentity: this.room.localParticipant.identity,
         trackId,
         codec,
-        hasPacketTrailer: hasPacketTrailerPublishOptions(packetTrailer),
-        packetTrailer
+        hasPacketTrailer: hasFrameMetadataPublishOptions(frameMetadata),
+        packetTrailer: frameMetadata
       };
       // @ts-ignore
       sender.transform = new RTCRtpScriptTransform(this.worker, options);
@@ -15520,8 +15519,8 @@ class E2EEManager extends eventsExports.EventEmitter {
           trackId,
           participantIdentity: this.room.localParticipant.identity,
           isReuse: false,
-          hasPacketTrailer: hasPacketTrailerPublishOptions(packetTrailer),
-          packetTrailer
+          hasPacketTrailer: hasFrameMetadataPublishOptions(frameMetadata),
+          packetTrailer: frameMetadata
         }
       };
       this.worker.postMessage(msg, [senderStreams.readable, senderStreams.writable]);
@@ -15531,16 +15530,16 @@ class E2EEManager extends eventsExports.EventEmitter {
   }
 }const MAX_ENTRIES = 300;
 /**
- * Caches packet trailer metadata extracted from received video frames,
+ * Caches frame metadata extracted from received video frames,
  * keyed by RTP timestamp so it can be looked up when the frame is displayed.
  *
- * Metadata is populated either by the packet trailer worker managed by
- * `PacketTrailerManager` (non-E2EE) or by the E2EE FrameCryptor worker
+ * Metadata is populated either by the frame metadata worker managed by
+ * `FrameMetadataManager` (non-E2EE) or by the E2EE FrameCryptor worker
  * after decryption (E2EE).
  *
  * @experimental
  */
-class PacketTrailerExtractor {
+class FrameMetadataExtractor {
   constructor() {
     this.metadataMap = new Map();
     this.activeSsrc = 0;
@@ -15580,7 +15579,7 @@ class PacketTrailerExtractor {
  *
  * @experimental
  */
-class PacketTrailerManager {
+class FrameMetadataManager {
   constructor(options) {
     this.extractors = new Map();
     /**
@@ -15600,7 +15599,7 @@ class PacketTrailerManager {
       }
     };
     this.onWorkerError = ev => {
-      livekitLogger.error('packet trailer worker encountered an error:', {
+      livekitLogger.error('frame metadata worker encountered an error:', {
         error: ev.error
       });
     };
@@ -15646,16 +15645,16 @@ class PacketTrailerManager {
       }
       return;
     }
-    if (!isPacketTrailerSupported(this.worker ? {
+    if (!isFrameMetadataSupported(this.worker ? {
       worker: this.worker
     } : undefined) && !((_b = this.room) === null || _b === void 0 ? void 0 : _b.hasE2EESetup)) {
-      livekitLogger.warn('packet trailer transform not supported; skipping extraction');
+      livekitLogger.warn('frame metadata transform not supported; skipping extraction');
       return;
     }
-    const extractor = new PacketTrailerExtractor();
+    const extractor = new FrameMetadataExtractor();
     const trackId = track.mediaStreamID;
     this.extractors.set(trackId, extractor);
-    track.packetTrailerExtractor = extractor;
+    track.frameMetadataExtractor = extractor;
     if ((_c = this.room) === null || _c === void 0 ? void 0 : _c.hasE2EESetup) {
       // E2EE worker strips the trailer and injects metadata directly into
       // the extractor via E2eeManager; no pipeline is needed here.
@@ -15664,14 +15663,14 @@ class PacketTrailerManager {
     this.setupWorkerReceiver(receiver, trackId, true);
   }
   setupPassthroughReceiver(receiver, trackId) {
-    if (shouldUsePacketTrailerScriptTransform()) {
+    if (shouldUseFrameMetadataScriptTransform()) {
       if ('transform' in receiver) {
         // @ts-ignore
         receiver.transform = null;
       }
       return;
     }
-    if (this.worker && isPacketTrailerSupported({
+    if (this.worker && isFrameMetadataSupported({
       worker: this.worker
     }) && !this.workerPipelines.has(receiver)) {
       this.setupWorkerReceiver(receiver, trackId, false);
@@ -15687,7 +15686,7 @@ class PacketTrailerManager {
     if (!worker) {
       return;
     }
-    if (shouldUsePacketTrailerScriptTransform()) {
+    if (shouldUseFrameMetadataScriptTransform()) {
       // @ts-ignore
       receiver.transform = new RTCRtpScriptTransform(worker, {
         kind: 'decode',
@@ -15746,7 +15745,7 @@ class PacketTrailerManager {
       this.extractors.delete(trackId);
     }
     if (track instanceof RemoteVideoTrack) {
-      track.packetTrailerExtractor = undefined;
+      track.frameMetadataExtractor = undefined;
     }
     // The receiver pipeline is intentionally left running. If the receiver is
     // reused for a new track, `setupReceiver` will remap it. If the room
@@ -15763,7 +15762,9 @@ class PacketTrailerManager {
     this.workerPipelines.clear();
     (_a = this.worker) === null || _a === void 0 ? void 0 : _a.terminate();
   }
-}const CONNECTION_BACKOFF_MIN_MS = 500;
+}
+/** @deprecated Use {@link FrameMetadataManager} instead. */
+const PacketTrailerManager = FrameMetadataManager;const CONNECTION_BACKOFF_MIN_MS = 500;
 const CONNECTION_BACKOFF_MAX_MS = 15000;
 /**
  * BackOffStrategy implements exponential backoff for connection failures.
@@ -16414,13 +16415,15 @@ class SignalClient {
             if (redactedUrl.searchParams.has('access_token')) {
               redactedUrl.searchParams.set('access_token', '<redacted>');
             }
+            if (this.ws) {
+              const startClose = performance.now();
+              yield this.close(false);
+              this.log.debug("closed previous ws connection in ".concat(performance.now() - startClose, "ms"));
+            }
             this.log.info("signal connecting to ".concat(redactedUrl), {
               reconnect: opts.reconnect,
               reconnectReason: opts.reconnectReason
             });
-            if (this.ws) {
-              yield this.close(false);
-            }
             this.ws = new WebSocketStream(rtcUrl);
             try {
               this.ws.closed.then(closeInfo => {
@@ -18449,6 +18452,10 @@ class PCTransport extends eventsExports.EventEmitter {
   getStats() {
     return this.pc.getStats();
   }
+  getMaxMessageSize() {
+    var _a, _b;
+    return (_b = (_a = this._pc) === null || _a === void 0 ? void 0 : _a.sctp) === null || _b === void 0 ? void 0 : _b.maxMessageSize;
+  }
   getConnectedAddress() {
     return __awaiter(this, void 0, void 0, function* () {
       var _a;
@@ -18960,6 +18967,9 @@ class PCTransportManager {
     const matchingTransceiver = transceivers.find(transceiver => transceiver.receiver === receiver);
     return matchingTransceiver === null || matchingTransceiver === void 0 ? void 0 : matchingTransceiver.mid;
   }
+  getMaxPublisherMessageSize() {
+    return this.publisher.getMaxMessageSize();
+  }
   addPublisherTrack(track) {
     return this.publisher.addTrack(track);
   }
@@ -20231,7 +20241,10 @@ function encodingsFromPresets(width, height, presets, sourceFramerate) {
 /** @internal */
 function sortPresets(presets) {
   if (!presets) return;
-  return presets.sort((a, b) => {
+  // Sort a copy so we don't mutate the caller's array in place. Mutating the
+  // passed-in simulcast layers can cause consumers that compare options by value
+  // (e.g. components-react's useLiveKitRoom) to detect a spurious change.
+  return presets.slice().sort((a, b) => {
     const aEnc = a.encoding;
     const bEnc = b.encoding;
     if (aEnc.maxBitrate > bEnc.maxBitrate) {
@@ -21060,6 +21073,10 @@ var DataChannelKind;
   DataChannelKind[DataChannelKind["LOSSY"] = 1] = "LOSSY";
   DataChannelKind[DataChannelKind["DATA_TRACK_LOSSY"] = 2] = "DATA_TRACK_LOSSY";
 })(DataChannelKind || (DataChannelKind = {}));
+// Default data-channel max message size (bytes), used when the remote SDP
+// answer does not advertise an `a=max-message-size` attribute (RFC 8841).
+// `0` means "no limit".
+const DEFAULT_MAX_MESSAGE_SIZE = 64000;
 /** @internal */
 class RTCEngine extends eventsExports.EventEmitter {
   get isClosed() {
@@ -21204,12 +21221,21 @@ class RTCEngine extends eventsExports.EventEmitter {
       this.emit('dataTrackPacketReceived', new Uint8Array(buffer));
     });
     this.handleDataError = event => {
+      // Errors fired while we're tearing the connection down (e.g. the SCTP transport aborting as
+      // the peer connection closes) carry no actionable information — the channel is going away
+      // regardless. Suppress them so a graceful disconnect doesn't surface spurious errors.
+      // See livekit/client-sdk-js#1953.
+      if (this._isClosed) {
+        return;
+      }
       const channel = event.currentTarget;
       const channelKind = channel.maxRetransmits === 0 ? 'lossy' : 'reliable';
-      if (event instanceof ErrorEvent && event.error) {
-        const error = event.error.error;
-        this.log.error("DataChannel error on ".concat(channelKind, ": ").concat(event.message), {
-          error
+      if (typeof RTCErrorEvent !== 'undefined' && event instanceof RTCErrorEvent && event.error) {
+        const error = event.error;
+        this.log.error("DataChannel error on ".concat(channelKind, ": ").concat(error.message), {
+          error,
+          errorDetail: error.errorDetail,
+          sctpCauseCode: error.sctpCauseCode
         });
       } else {
         this.log.error("Unknown DataChannel error on ".concat(channelKind), {
@@ -21217,6 +21243,15 @@ class RTCEngine extends eventsExports.EventEmitter {
         });
       }
     };
+    this.handleDataChannelClose = kind => () => {
+      var _a;
+      // A publisher DC closing while the session is up and the publisher PC is still
+      // connected is the signature of an oversized message having aborted the channel
+      // (see livekit/rust-sdks#1137). Surface it; do not attempt renegotiation.
+      if (!this._isClosed && ((_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.publisher.getConnectionState()) === 'connected') {
+        this.log.error("publisher data channel '".concat(DataChannelKind[kind], "' closed unexpectedly"), this.logContext);
+      }
+    };
     this.handleBufferedAmountLow = channelKind => {
       this.updateAndEmitDCBufferStatus(channelKind);
     };
@@ -21516,17 +21551,23 @@ class RTCEngine extends eventsExports.EventEmitter {
   cleanupPeerConnections() {
     return __awaiter(this, void 0, void 0, function* () {
       var _a;
-      yield (_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.close();
-      this.pcManager = undefined;
       const dcCleanup = dc => {
-        if (!dc) return;
-        dc.close();
+        if (!dc) {
+          return;
+        }
+        // Detach the data channel handlers before closing anything. Closing a peer connection tears
+        // down the SCTP transport, which can dispatch `error`/`close` events on the still-open data
+        // channels; if our handlers are still attached at that point, handleDataError logs a spurious
+        // "Unknown DataChannel error" during an otherwise graceful disconnect. Removing the handlers
+        // before dc.close()/pcManager.close() makes this deterministic regardless of how/when the
+        // browser dispatches those teardown events. See livekit/client-sdk-js#1953.
         dc.onbufferedamountlow = null;
         dc.onclose = null;
         dc.onclosing = null;
         dc.onerror = null;
         dc.onmessage = null;
         dc.onopen = null;
+        dc.close();
       };
       dcCleanup(this.lossyDC);
       dcCleanup(this.lossyDCSub);
@@ -21534,6 +21575,8 @@ class RTCEngine extends eventsExports.EventEmitter {
       dcCleanup(this.reliableDCSub);
       dcCleanup(this.dataTrackDC);
       dcCleanup(this.dataTrackDCSub);
+      yield (_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.close();
+      this.pcManager = undefined;
       this.lossyDC = undefined;
       this.lossyDCSub = undefined;
       this.reliableDC = undefined;
@@ -21806,12 +21849,12 @@ class RTCEngine extends eventsExports.EventEmitter {
     };
   }
   makeRTCConfiguration(serverResponse) {
-    var _a, _b;
+    var _a;
     const rtcConfig = Object.assign({}, this.rtcConfig);
     // E2EE and packet trailer extraction both rely on encoded frame transforms.
     // Only opt into the createEncodedStreams flavor when that path will be
     // used; RTCRtpScriptTransform does not need the PeerConnection flag.
-    const needsInsertableStreams = ((_a = this.signalOpts) === null || _a === void 0 ? void 0 : _a.e2eeEnabled) || ((_b = this.options.packetTrailer) === null || _b === void 0 ? void 0 : _b.worker) && !shouldUsePacketTrailerScriptTransform();
+    const needsInsertableStreams = ((_a = this.signalOpts) === null || _a === void 0 ? void 0 : _a.e2eeEnabled) || this.frameMetadataWorker && !shouldUseFrameMetadataScriptTransform();
     if (needsInsertableStreams && isInsertableStreamSupported()) {
       this.log.debug('E2EE - setting up transports with insertable streams');
       //  this makes sure that no data is sent before the transforms are ready
@@ -21853,7 +21896,15 @@ class RTCEngine extends eventsExports.EventEmitter {
    */
   applyInitialPublisherLayout() {
     this.createDataChannels();
-    this.addMediaSections(initialMediaSectionsAudio, initialMediaSectionsVideo);
+    /**
+     * Native libwebrtc does not support pre-populating the media sections,
+     * so we skip it for React Native.
+     *
+     * Related: https://github.com/livekit/rust-sdks/pull/1151
+     */
+    if (!isReactNative()) {
+      this.addMediaSections(initialMediaSectionsAudio, initialMediaSectionsVideo);
+    }
   }
   addMediaSections(numAudios, numVideos) {
     var _a, _b;
@@ -21875,14 +21926,17 @@ class RTCEngine extends eventsExports.EventEmitter {
     if (this.lossyDC) {
       this.lossyDC.onmessage = null;
       this.lossyDC.onerror = null;
+      this.lossyDC.onclose = null;
     }
     if (this.reliableDC) {
       this.reliableDC.onmessage = null;
       this.reliableDC.onerror = null;
+      this.reliableDC.onclose = null;
     }
     if (this.dataTrackDC) {
       this.dataTrackDC.onmessage = null;
       this.dataTrackDC.onerror = null;
+      this.dataTrackDC.onclose = null;
     }
     // create data channels
     this.lossyDC = this.pcManager.createPublisherDataChannel(lossyDataChannel, {
@@ -21904,6 +21958,10 @@ class RTCEngine extends eventsExports.EventEmitter {
     this.lossyDC.onerror = this.handleDataError;
     this.reliableDC.onerror = this.handleDataError;
     this.dataTrackDC.onerror = this.handleDataError;
+    // detect unexpected publisher data channel closes
+    this.lossyDC.onclose = this.handleDataChannelClose(DataChannelKind.LOSSY);
+    this.reliableDC.onclose = this.handleDataChannelClose(DataChannelKind.RELIABLE);
+    this.dataTrackDC.onclose = this.handleDataChannelClose(DataChannelKind.DATA_TRACK_LOSSY);
     // set up dc buffer threshold, set to 64kB (otherwise 0 by default)
     this.lossyDC.bufferedAmountLowThreshold = 65535;
     this.reliableDC.bufferedAmountLowThreshold = 65535;
@@ -21935,7 +21993,7 @@ class RTCEngine extends eventsExports.EventEmitter {
       } else {
         throw new UnexpectedConnectionState('Required webRTC APIs not supported on this device');
       }
-      this.setupPacketTrailerSender(sender, opts);
+      this.setupFrameMetadataSender(sender, opts);
       return sender;
     });
   }
@@ -21951,32 +22009,37 @@ class RTCEngine extends eventsExports.EventEmitter {
         throw new UnexpectedConnectionState('Cannot stream on this device');
       }
       if (sender) {
-        this.setupPacketTrailerSender(sender, opts);
+        this.setupFrameMetadataSender(sender, opts);
       }
       return sender;
     });
   }
-  setupPacketTrailerSender(sender) {
-    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  get frameMetadataWorker() {
     var _a, _b;
-    if (!((_a = this.options.packetTrailer) === null || _a === void 0 ? void 0 : _a.worker) || ((_b = this.signalOpts) === null || _b === void 0 ? void 0 : _b.e2eeEnabled)) {
+    return (_b = (_a = this.options.frameMetadata) !== null && _a !== void 0 ? _a : this.options.packetTrailer) === null || _b === void 0 ? void 0 : _b.worker;
+  }
+  setupFrameMetadataSender(sender) {
+    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    var _a, _b, _c;
+    const worker = this.frameMetadataWorker;
+    if (!worker || ((_a = this.signalOpts) === null || _a === void 0 ? void 0 : _a.e2eeEnabled)) {
       return;
     }
-    const packetTrailer = opts.packetTrailer;
-    const hasPacketTrailer = hasPacketTrailerPublishOptions(packetTrailer);
-    if (shouldUsePacketTrailerScriptTransform()) {
-      if (hasPacketTrailer) {
+    const frameMetadata = (_b = opts.frameMetadata) !== null && _b !== void 0 ? _b : opts.packetTrailer;
+    const hasMetadata = hasFrameMetadataPublishOptions(frameMetadata);
+    if (shouldUseFrameMetadataScriptTransform()) {
+      if (hasMetadata) {
         // @ts-ignore
-        sender.transform = new RTCRtpScriptTransform(this.options.packetTrailer.worker, {
+        sender.transform = new RTCRtpScriptTransform(worker, {
           kind: 'encode',
-          packetTrailer
+          packetTrailer: frameMetadata
         });
       }
       return;
     }
-    if (!isPacketTrailerSupported(this.options.packetTrailer) || !('createEncodedStreams' in sender)) {
-      if (hasPacketTrailer) {
-        this.log.warn('packet trailer transform not supported; skipping write', this.logContext);
+    if (!isFrameMetadataSupported((_c = this.options.frameMetadata) !== null && _c !== void 0 ? _c : this.options.packetTrailer) || !('createEncodedStreams' in sender)) {
+      if (hasMetadata) {
+        this.log.warn('frame metadata transform not supported; skipping write', this.logContext);
       }
       return;
     }
@@ -21984,13 +22047,13 @@ class RTCEngine extends eventsExports.EventEmitter {
     const _sender$createEncoded = sender.createEncodedStreams(),
       readable = _sender$createEncoded.readable,
       writable = _sender$createEncoded.writable;
-    if (hasPacketTrailer) {
-      this.options.packetTrailer.worker.postMessage({
+    if (hasMetadata) {
+      worker.postMessage({
         kind: 'encode',
         data: {
           readableStream: readable,
           writableStream: writable,
-          packetTrailer
+          packetTrailer: frameMetadata
         }
       }, [readable, writable]);
     } else {
@@ -22278,6 +22341,7 @@ class RTCEngine extends eventsExports.EventEmitter {
   /* @internal */
   sendDataPacket(packet, kind) {
     return __awaiter(this, void 0, void 0, function* () {
+      var _a, _b;
       // make sure we do have a data connection
       yield this.ensurePublisherConnected(kind);
       if (this.e2eeManager && this.e2eeManager.isDataChannelEncryptionEnabled) {
@@ -22299,6 +22363,13 @@ class RTCEngine extends eventsExports.EventEmitter {
         this.reliableDataSequence += 1;
       }
       const msg = packet.toBinary();
+      // Clamp to the SDK default - libwebrtc advertises larger (~256 KiB)
+      // than LiveKit/pion can deliver end-to-end (~64 KiB), so we trust
+      // the answer up untilthe built in ceiling.
+      const maxPublisherMessageSizeBytes = Math.min((_b = (_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.getMaxPublisherMessageSize()) !== null && _b !== void 0 ? _b : DEFAULT_MAX_MESSAGE_SIZE, DEFAULT_MAX_MESSAGE_SIZE);
+      if (typeof maxPublisherMessageSizeBytes !== 'undefined' && maxPublisherMessageSizeBytes !== 0 /* 0 means "no limit" */ && msg.byteLength > maxPublisherMessageSizeBytes) {
+        throw new PublishDataError("cannot publish data packet larger than ".concat(maxPublisherMessageSizeBytes, " bytes (got ").concat(msg.byteLength, ")"));
+      }
       switch (kind) {
         case DataChannelKind.LOSSY:
         case DataChannelKind.DATA_TRACK_LOSSY:
@@ -25978,7 +26049,7 @@ function truncateBytes(str, maxBytes) {
  * ack/response state, and handling incoming ack/response packets.
  * @internal
  */
-class RpcClientManager extends EventEmitter {
+class RpcClientManager extends eventsExports.EventEmitter {
   constructor(log, outgoingDataStreamManager, getRemoteParticipantClientProtocol, getServerVersion) {
     super();
     this.pendingAcks = new Map();
@@ -26178,7 +26249,7 @@ class RpcClientManager extends EventEmitter {
  * managing registered method handlers, and sending responses.
  * @internal
  */
-class RpcServerManager extends EventEmitter {
+class RpcServerManager extends eventsExports.EventEmitter {
   constructor(log, outgoingDataStreamManager, getRemoteParticipantClientProtocol) {
     super();
     this.rpcHandlers = new Map();
@@ -28140,7 +28211,7 @@ class Participant extends eventsExports.EventEmitter {
       if (isLocalAudioTrack(track) && track.hasPreConnectBuffer) {
         audioFeatures.push(AudioTrackFeature.TF_PRECONNECT_BUFFER);
       }
-      const packetTrailerFeatures = this.normalizeRequestedPacketTrailerOptions(track, opts);
+      const packetTrailerFeatures = this.normalizeRequestedFrameMetadataOptions(track, opts);
       // create track publication from track
       const req = new AddTrackRequest({
         // get local track id for use during publishing
@@ -28436,21 +28507,28 @@ class Participant extends eventsExports.EventEmitter {
       return publication;
     });
   }
-  canPublishPacketTrailer() {
-    return !!(this.roomOptions.e2ee || this.roomOptions.encryption || isPacketTrailerSupported(this.roomOptions.packetTrailer));
+  canPublishFrameMetadata() {
+    var _a;
+    return !!(this.roomOptions.e2ee || this.roomOptions.encryption || isFrameMetadataSupported((_a = this.roomOptions.frameMetadata) !== null && _a !== void 0 ? _a : this.roomOptions.packetTrailer));
   }
-  normalizeRequestedPacketTrailerOptions(track, opts) {
-    if (track.kind !== Track.Kind.Video || !hasPacketTrailerPublishOptions(opts.packetTrailer)) {
+  normalizeRequestedFrameMetadataOptions(track, opts) {
+    var _a;
+    const fmOpts = (_a = opts.frameMetadata) !== null && _a !== void 0 ? _a : opts.packetTrailer;
+    if (track.kind !== Track.Kind.Video || !hasFrameMetadataPublishOptions(fmOpts)) {
+      opts.frameMetadata = undefined;
       opts.packetTrailer = undefined;
       return [];
     }
-    if (!this.canPublishPacketTrailer()) {
-      this.log.warn('packet trailer transform not supported; not advertising features', Object.assign(Object.assign({}, this.logContext), getLogContextFromTrack(track)));
+    if (!this.canPublishFrameMetadata()) {
+      this.log.warn('frame metadata transform not supported; not advertising features', Object.assign(Object.assign({}, this.logContext), getLogContextFromTrack(track)));
+      opts.frameMetadata = undefined;
       opts.packetTrailer = undefined;
       return [];
     }
-    const features = getPacketTrailerFeatures(opts.packetTrailer);
-    opts.packetTrailer = getPacketTrailerPublishOptions(features);
+    const features = getFrameMetadataFeatures(fmOpts);
+    const normalized = getFrameMetadataPublishOptions(features);
+    opts.frameMetadata = normalized;
+    opts.packetTrailer = normalized;
     return features;
   }
   get isLocal() {
@@ -28492,7 +28570,7 @@ class Participant extends eventsExports.EventEmitter {
       if (!simulcastTrack) {
         return;
       }
-      const packetTrailerFeatures = this.normalizeRequestedPacketTrailerOptions(track, opts);
+      const packetTrailerFeatures = this.normalizeRequestedFrameMetadataOptions(track, opts);
       const req = new AddTrackRequest({
         cid: simulcastTrack.mediaStreamTrack.id,
         type: Track.kindToProto(track.kind),
@@ -29764,10 +29842,11 @@ class Room extends eventsExports.EventEmitter {
       return this.connectFuture.promise;
     });
     this.connectSignal = (url, token, engine, connectOptions, roomOptions, abortController) => __awaiter(this, void 0, void 0, function* () {
+      var _a;
       const _yield$engine$join = yield engine.join(url, token, {
           autoSubscribe: connectOptions.autoSubscribe,
           adaptiveStream: typeof roomOptions.adaptiveStream === 'object' ? true : roomOptions.adaptiveStream,
-          clientInfoCapabilities: isPacketTrailerSupported(roomOptions.packetTrailer) || !!this.e2eeManager ? [ClientInfo_Capability.CAP_PACKET_TRAILER] : undefined,
+          clientInfoCapabilities: isFrameMetadataSupported((_a = roomOptions.frameMetadata) !== null && _a !== void 0 ? _a : roomOptions.packetTrailer) || !!this.e2eeManager ? [ClientInfo_Capability.CAP_PACKET_TRAILER] : undefined,
           maxRetries: connectOptions.maxRetries,
           e2eeEnabled: !!this.e2eeManager,
           websocketTimeout: connectOptions.websocketTimeout
@@ -30454,7 +30533,7 @@ class Room extends eventsExports.EventEmitter {
     });
     this.disconnectLock = new _();
     this.localParticipant = new LocalParticipant('', '', this.engine, this.options, this.outgoingDataStreamManager, this.outgoingDataTrackManager, this.rpcClientManager, this.rpcServerManager);
-    this.setupPacketTrailer();
+    this.setupFrameMetadata();
     if (this.options.e2ee || this.options.encryption) {
       this.setupE2EE();
     }
@@ -30596,11 +30675,11 @@ class Room extends eventsExports.EventEmitter {
       (_b = this.e2eeManager) === null || _b === void 0 ? void 0 : _b.setupEngine(this.engine);
     }
   }
-  setupPacketTrailer() {
-    // The manager is always created so tracks that advertise packet trailer
-    // features can be wired up when the app passes a packet trailer worker.
-    this.packetTrailerManager = new PacketTrailerManager(this.options.packetTrailer);
-    this.packetTrailerManager.setup(this);
+  setupFrameMetadata() {
+    var _a;
+    const opts = (_a = this.options.frameMetadata) !== null && _a !== void 0 ? _a : this.options.packetTrailer;
+    this.frameMetadataManager = new FrameMetadataManager(opts);
+    this.frameMetadataManager.setup(this);
   }
   get logContext() {
     var _a, _b, _c;
@@ -32784,6 +32863,7 @@ function areTokenSourceFetchOptionsEqual(a, b) {
       case 'participantAttributes':
       case 'agentName':
       case 'agentMetadata':
+      case 'deployment':
         if (a[key] !== b[key]) {
           return false;
         }
@@ -32808,26 +32888,7 @@ class TokenSourceCached extends TokenSourceConfigurable {
     if (!this.cachedFetchOptions) {
       return false;
     }
-    for (const key of Object.keys(this.cachedFetchOptions)) {
-      switch (key) {
-        case 'roomName':
-        case 'participantName':
-        case 'participantIdentity':
-        case 'participantMetadata':
-        case 'participantAttributes':
-        case 'agentName':
-        case 'agentMetadata':
-          if (this.cachedFetchOptions[key] !== options[key]) {
-            return false;
-          }
-          break;
-        default:
-          // ref: https://stackoverflow.com/a/58009992
-          const exhaustiveCheckedKey = key;
-          throw new Error("Options key ".concat(exhaustiveCheckedKey, " not being checked for equality!"));
-      }
-    }
-    return true;
+    return areTokenSourceFetchOptionsEqual(options, this.cachedFetchOptions);
   }
   shouldReturnCachedValueFromFetch(fetchOptions) {
     if (!this.cachedResponse) {
@@ -32912,7 +32973,7 @@ class TokenSourceEndpoint extends TokenSourceCached {
     this.endpointOptions = options;
   }
   createRequestFromOptions(options) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d;
     const request = new TokenSourceRequest();
     for (const key of Object.keys(options)) {
       switch (key) {
@@ -32939,6 +33000,13 @@ class TokenSourceEndpoint extends TokenSourceCached {
           }
           request.roomConfig.agents[0].metadata = options.agentMetadata;
           break;
+        case 'deployment':
+          request.roomConfig = (_d = request.roomConfig) !== null && _d !== void 0 ? _d : new RoomConfiguration();
+          if (request.roomConfig.agents.length === 0) {
+            request.roomConfig.agents.push(new RoomAgentDispatch());
+          }
+          request.roomConfig.agents[0].deployment = options.deployment;
+          break;
         default:
           // ref: https://stackoverflow.com/a/58009992
           const exhaustiveCheckedKey = key;
@@ -33147,4 +33215,4 @@ const serializers = {
   json,
   raw,
   custom
-};export{AudioPresets,BackupCodecPolicy,BaseKeyProvider,CLIENT_PROTOCOL_DATA_STREAM_RPC,CLIENT_PROTOCOL_DEFAULT,CheckStatus,Checker,ConnectionCheck,ConnectionError,ConnectionErrorReason,ConnectionQuality,ConnectionState,CriticalTimers,CryptorError,CryptorErrorReason,CryptorEvent,DataPacket_Kind,DataStreamError,DataStreamErrorReason,DataTrackPacket,DefaultReconnectPolicy,DeviceUnsupportedError,DisconnectReason,EncryptionEvent,Encryption_Type,EngineEvent,ExternalE2EEKeyProvider,KeyHandlerEvent,KeyProviderEvent,LivekitError,LivekitReasonedError,LocalAudioTrack,LocalDataTrack,LocalParticipant,LocalTrack,LocalTrackPublication,LocalTrackRecorder,LocalVideoTrack,LogLevel,LoggerNames,MediaDeviceFailure,_ as Mutex,NegotiationError,PacketTrailerManager,Participant,ParticipantEvent,ParticipantInfo_Kind as ParticipantKind,PublishDataError,PublishTrackError,RemoteAudioTrack,RemoteDataTrack,RemoteParticipant,RemoteTrack,RemoteTrackPublication,RemoteVideoTrack,Room,RoomEvent,RpcError,ScreenSharePresets,SignalReconnectError,SignalRequestError,SimulatedError,SubscriptionError,TokenSource,TokenSourceConfigurable,TokenSourceFixed,Track,TrackEvent,TrackInvalidError,TrackPublication,TrackType,UnexpectedConnectionState,UnsupportedServer,VideoPreset,VideoPresets,VideoPresets43,VideoQuality,areTokenSourceFetchOptionsEqual,asEncryptablePacket,attachToElement,attributeTypings as attributes,audioCodecs,clientProtocol,compareVersions,createAudioAnalyser,createE2EEKey,createKeyMaterialFromBuffer,createKeyMaterialFromString,createLocalAudioTrack,createLocalScreenTracks,createLocalTracks,createLocalVideoTrack,decodeTokenPayload,deriveKeys,detachTrack,facingModeFromDeviceLabel,facingModeFromLocalTrack,getBrowser,getEmptyAudioStreamTrack,getEmptyVideoStreamTrack,getLogger,importKey,isAudioCodec,isAudioTrack,isBackupCodec,isBackupVideoCodec,isBrowserSupported,isE2EESupported,isInsertableStreamSupported,isLocalParticipant,isLocalTrack,isRemoteParticipant,isRemoteTrack,isScriptTransformSupported,isSerializer,isVideoCodec,isVideoFrame,isVideoTrack,needsRbspUnescaping,parseRbsp,protocolVersion,ratchet,serializers,setLogExtension,setLogLevel,supportsAV1,supportsAdaptiveStream,supportsAudioOutputSelection,supportsDynacast,supportsVP9,version,videoCodecs,writeRbsp};//# sourceMappingURL=livekit-client.esm.mjs.map
+};export{AudioPresets,BackupCodecPolicy,BaseKeyProvider,CLIENT_PROTOCOL_DATA_STREAM_RPC,CLIENT_PROTOCOL_DEFAULT,CheckStatus,Checker,ConnectionCheck,ConnectionError,ConnectionErrorReason,ConnectionQuality,ConnectionState,CriticalTimers,CryptorError,CryptorErrorReason,CryptorEvent,DataPacket_Kind,DataStreamError,DataStreamErrorReason,DataTrackPacket,DefaultReconnectPolicy,DeviceUnsupportedError,DisconnectReason,EncryptionEvent,Encryption_Type,EngineEvent,ExternalE2EEKeyProvider,FrameMetadataManager,KeyHandlerEvent,KeyProviderEvent,LivekitError,LivekitReasonedError,LocalAudioTrack,LocalDataTrack,LocalParticipant,LocalTrack,LocalTrackPublication,LocalTrackRecorder,LocalVideoTrack,LogLevel,LoggerNames,MediaDeviceFailure,_ as Mutex,NegotiationError,PacketTrailerManager,Participant,ParticipantEvent,ParticipantInfo_Kind as ParticipantKind,PublishDataError,PublishTrackError,RemoteAudioTrack,RemoteDataTrack,RemoteParticipant,RemoteTrack,RemoteTrackPublication,RemoteVideoTrack,Room,RoomEvent,RpcError,ScreenSharePresets,SignalReconnectError,SignalRequestError,SimulatedError,SubscriptionError,TokenSource,TokenSourceConfigurable,TokenSourceFixed,Track,TrackEvent,TrackInvalidError,TrackPublication,TrackType,UnexpectedConnectionState,UnsupportedServer,VideoPreset,VideoPresets,VideoPresets43,VideoQuality,areTokenSourceFetchOptionsEqual,asEncryptablePacket,attachToElement,attributeTypings as attributes,audioCodecs,clientProtocol,compareVersions,createAudioAnalyser,createE2EEKey,createKeyMaterialFromBuffer,createKeyMaterialFromString,createLocalAudioTrack,createLocalScreenTracks,createLocalTracks,createLocalVideoTrack,decodeTokenPayload,deriveKeys,detachTrack,facingModeFromDeviceLabel,facingModeFromLocalTrack,getBrowser,getEmptyAudioStreamTrack,getEmptyVideoStreamTrack,getLogger,importKey,isAudioCodec,isAudioTrack,isBackupCodec,isBackupVideoCodec,isBrowserSupported,isE2EESupported,isInsertableStreamSupported,isLocalParticipant,isLocalTrack,isRemoteParticipant,isRemoteTrack,isScriptTransformSupported,isSerializer,isVideoCodec,isVideoFrame,isVideoTrack,needsRbspUnescaping,parseRbsp,protocolVersion,ratchet,serializers,setLogExtension,setLogLevel,supportsAV1,supportsAdaptiveStream,supportsAudioOutputSelection,supportsDynacast,supportsVP9,version,videoCodecs,writeRbsp};//# sourceMappingURL=livekit-client.esm.mjs.map