livekit-client 2.19.2 → 2.20.1

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
@@ -8938,10 +8937,15 @@ function detectBrowser(window) {
       return brand.brand === 'Chromium';
     });
     if (chromium) {
-      return {
-        browser: 'chrome',
-        version: parseInt(chromium.version, 10)
-      };
+      const version = parseInt(chromium.version, 10);
+      // navigator.userAgentData was introduced in Chromium 90
+      // so any Chromium brand reporting a version below 90 is invalid
+      if (version >= 90) {
+        return {
+          browser: 'chrome',
+          version
+        };
+      }
     }
   }
   if (navigator.mozGetUserMedia) {
@@ -9050,6 +9054,9 @@ function filterStats(result, track, outbound) {
 /* eslint-env node */
 const logging = log$4;
 function shimGetUserMedia$2(window, browserDetails) {
+  if (browserDetails.version >= 64) {
+    return;
+  }
   const navigator = window && window.navigator;
   if (!navigator.mediaDevices) {
     return;
@@ -9203,6 +9210,8 @@ function shimGetUserMedia$2(window, browserDetails) {
   // Even though Chrome 45 has navigator.mediaDevices and a getUserMedia
   // function which returns a Promise, it does not accept spec-style
   // constraints.
+  // Fixed in M64 too, see
+  //   https://groups.google.com/g/discuss-webrtc/c/DMPTKcXVUQ4/m/85FaASoFBwAJ?
   if (navigator.mediaDevices.getUserMedia) {
     const origGetUserMedia = navigator.mediaDevices.getUserMedia.bind(navigator.mediaDevices);
     navigator.mediaDevices.getUserMedia = function (cs) {
@@ -9788,6 +9797,9 @@ function fixNegotiationNeeded(window, browserDetails) {
 /* eslint-env node */
 function shimGetUserMedia$1(window, browserDetails) {
   const navigator = window && window.navigator;
+  if (!navigator.mediaDevices) {
+    return;
+  }
   const MediaStreamTrack = window && window.MediaStreamTrack;
   navigator.getUserMedia = function (constraints, onSuccess, onError) {
     // Replace Firefox 44+'s deprecation warning with unprefixed version.
@@ -9841,10 +9853,10 @@ function shimGetUserMedia$1(window, browserDetails) {
 /* eslint-env node */
 
 function shimGetDisplayMedia(window, preferredMediaSource) {
-  if (window.navigator.mediaDevices && 'getDisplayMedia' in window.navigator.mediaDevices) {
+  if (!window.navigator.mediaDevices) {
     return;
   }
-  if (!window.navigator.mediaDevices) {
+  if (window.navigator.mediaDevices && 'getDisplayMedia' in window.navigator.mediaDevices) {
     return;
   }
   window.navigator.mediaDevices.getDisplayMedia = function getDisplayMedia(constraints) {
@@ -10024,13 +10036,17 @@ function shimRTCDataChannel(window) {
     window.RTCDataChannel = window.DataChannel;
   }
 }
-function shimAddTransceiver(window) {
+function shimAddTransceiver(window, browserDetails) {
   // https://github.com/webrtcHacks/adapter/issues/998#issuecomment-516921647
   // Firefox ignores the init sendEncodings options passed to addTransceiver
   // https://bugzilla.mozilla.org/show_bug.cgi?id=1396918
   if (!(typeof window === 'object' && window.RTCPeerConnection)) {
     return;
   }
+  // Fixed by https://bugzilla.mozilla.org/show_bug.cgi?id=1401592 in FF110.
+  if (browserDetails.version >= 110) {
+    return;
+  }
   const origAddTransceiver = window.RTCPeerConnection.prototype.addTransceiver;
   if (origAddTransceiver) {
     window.RTCPeerConnection.prototype.addTransceiver = function addTransceiver() {
@@ -10090,10 +10106,14 @@ function shimAddTransceiver(window) {
     };
   }
 }
-function shimGetParameters(window) {
+function shimGetParameters(window, browserDetails) {
   if (!(typeof window === 'object' && window.RTCRtpSender)) {
     return;
   }
+  // Fixed by https://bugzilla.mozilla.org/show_bug.cgi?id=1401592 in FF110.
+  if (browserDetails.version >= 110) {
+    return;
+  }
   const origGetParameters = window.RTCRtpSender.prototype.getParameters;
   if (origGetParameters) {
     window.RTCRtpSender.prototype.getParameters = function getParameters() {
@@ -10105,13 +10125,17 @@ function shimGetParameters(window) {
     };
   }
 }
-function shimCreateOffer(window) {
+function shimCreateOffer(window, browserDetails) {
   // https://github.com/webrtcHacks/adapter/issues/998#issuecomment-516921647
   // Firefox ignores the init sendEncodings options passed to addTransceiver
   // https://bugzilla.mozilla.org/show_bug.cgi?id=1396918
   if (!(typeof window === 'object' && window.RTCPeerConnection)) {
     return;
   }
+  // Fixed by https://bugzilla.mozilla.org/show_bug.cgi?id=1401592 in FF110.
+  if (browserDetails.version >= 110) {
+    return;
+  }
   const origCreateOffer = window.RTCPeerConnection.prototype.createOffer;
   window.RTCPeerConnection.prototype.createOffer = function createOffer() {
     if (this.setParametersPromises && this.setParametersPromises.length) {
@@ -10124,13 +10148,17 @@ function shimCreateOffer(window) {
     return origCreateOffer.apply(this, arguments);
   };
 }
-function shimCreateAnswer(window) {
+function shimCreateAnswer(window, browserDetails) {
   // https://github.com/webrtcHacks/adapter/issues/998#issuecomment-516921647
   // Firefox ignores the init sendEncodings options passed to addTransceiver
   // https://bugzilla.mozilla.org/show_bug.cgi?id=1396918
   if (!(typeof window === 'object' && window.RTCPeerConnection)) {
     return;
   }
+  // Fixed by https://bugzilla.mozilla.org/show_bug.cgi?id=1401592 in FF110.
+  if (browserDetails.version >= 110) {
+    return;
+  }
   const origCreateAnswer = window.RTCPeerConnection.prototype.createAnswer;
   window.RTCPeerConnection.prototype.createAnswer = function createAnswer() {
     if (this.setParametersPromises && this.setParametersPromises.length) {
@@ -11292,6 +11320,15 @@ function shimMaxMessageSize(window, browserDetails) {
   if (!window.RTCPeerConnection) {
     return;
   }
+  if (browserDetails.browser === 'chrome' && browserDetails.version > 102) {
+    // Unified plan is supported so no need to do anything.
+    return;
+  }
+  if (browserDetails.browser === 'firefox' && browserDetails.version >= 113) {
+    // Native RTCSctpTransport, see
+    // https://bugzilla.mozilla.org/show_bug.cgi?id=1278299
+    return;
+  }
   if (!('sctp' in window.RTCPeerConnection.prototype)) {
     Object.defineProperty(window.RTCPeerConnection.prototype, 'sctp', {
       get() {
@@ -11428,7 +11465,7 @@ function shimSendThrowTypeError(window, browserDetails) {
   if (!(window.RTCPeerConnection && 'createDataChannel' in window.RTCPeerConnection.prototype)) {
     return;
   }
-  if (browserDetails.browser === 'chrome' && browserDetails.version > 149) {
+  if (browserDetails.browser === 'chrome' && browserDetails.version >= 149) {
     // Fixed by https://issues.chromium.org/issues/490588131
     return;
   }
@@ -11707,10 +11744,10 @@ function adapterFactory() {
       shimSenderGetStats(window);
       shimReceiverGetStats(window);
       shimRTCDataChannel(window);
-      shimAddTransceiver(window);
-      shimGetParameters(window);
-      shimCreateOffer(window);
-      shimCreateAnswer(window);
+      shimAddTransceiver(window, browserDetails);
+      shimGetParameters(window, browserDetails);
+      shimCreateOffer(window, browserDetails);
+      shimCreateAnswer(window, browserDetails);
       shimRTCIceCandidate(window);
       shimConnectionState(window);
       shimMaxMessageSize(window, browserDetails);
@@ -11844,7 +11881,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.1";const version = version$1;
 const protocolVersion = 17;
 /** Initial client protocol. */
 const CLIENT_PROTOCOL_DEFAULT = 0;
@@ -14443,16 +14480,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 +14499,7 @@ function getPacketTrailerFeatures(options) {
   }
   return features;
 }
-function getPacketTrailerPublishOptions(features) {
+function getFrameMetadataPublishOptions(features) {
   if (!features || features.length === 0) {
     return undefined;
   }
@@ -14736,14 +14773,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 +15173,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 +15240,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 +15445,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 +15524,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 +15539,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 +15557,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 +15568,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 +15617,7 @@ class PacketTrailerExtractor {
  *
  * @experimental
  */
-class PacketTrailerManager {
+class FrameMetadataManager {
   constructor(options) {
     this.extractors = new Map();
     /**
@@ -15600,7 +15637,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 +15683,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 +15701,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 +15724,7 @@ class PacketTrailerManager {
     if (!worker) {
       return;
     }
-    if (shouldUsePacketTrailerScriptTransform()) {
+    if (shouldUseFrameMetadataScriptTransform()) {
       // @ts-ignore
       receiver.transform = new RTCRtpScriptTransform(worker, {
         kind: 'decode',
@@ -15746,7 +15783,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 +15800,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 +16453,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 => {
@@ -18212,6 +18253,15 @@ class PCTransport extends eventsExports.EventEmitter {
             });
           }
         });
+        // The server's answer sets per-track codec params (e.g. opus `usedtx`) on
+        // the sections mapped to a published track, but leaves the pre-populated
+        // recvonly placeholder sections with defaults. Conform the placeholders so
+        // each shared payload type is consistent across the bundle, otherwise
+        // libwebrtc flags a "bundled payload type collision".
+        const placeholderMids = this.getPlaceholderMids();
+        if (placeholderMids.size > 0) {
+          conformBundledCodecFmtp(sdpParsed.media, media => placeholderMids.has(getMidString(media.mid)));
+        }
         mungedSDP = libExports.write(sdpParsed);
       }
       yield this.setMungedSDP(sd, mungedSDP, true);
@@ -18356,6 +18406,15 @@ class PCTransport extends eventsExports.EventEmitter {
             });
           }
         });
+        // Conform the placeholder sections (pre-populated, or reverted after an
+        // unpublish) so every shared payload type carries identical fmtp across the
+        // bundle, otherwise libwebrtc flags a "bundled payload type collision".
+        // Detection is by transceiver (mids are stable across renegotiations) since
+        // an unpublished section keeps its `a=msid`.
+        const placeholderMids = this.getPlaceholderMids();
+        if (placeholderMids.size > 0) {
+          conformBundledCodecFmtp(sdpParsed.media, media => placeholderMids.has(getMidString(media.mid)));
+        }
         if (this.latestOfferId > offerId) {
           this.log.warn('latestOfferId mismatch', Object.assign(Object.assign({}, this.logContext), {
             latestOfferId: this.latestOfferId,
@@ -18385,6 +18444,17 @@ class PCTransport extends eventsExports.EventEmitter {
       return answer;
     });
   }
+  /**
+   * Returns the mids of transceivers that carry no outgoing track on this
+   * (publisher) connection: the pre-populated placeholders added by
+   * `RTCEngine.applyInitialPublisherLayout`, plus any transceiver that was used
+   * for a track and reverted on unpublish. Their codec fmtp is conformed to the
+   * published tracks so a shared payload type stays consistent across the bundle.
+   */
+  getPlaceholderMids() {
+    var _a, _b;
+    return placeholderMidsFromTransceivers((_b = (_a = this._pc) === null || _a === void 0 ? void 0 : _a.getTransceivers()) !== null && _b !== void 0 ? _b : []);
+  }
   createDataChannel(label, dataChannelDict) {
     return this.pc.createDataChannel(label, dataChannelDict);
   }
@@ -18449,6 +18519,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;
@@ -18603,6 +18677,79 @@ function ensureAudioNackAndStereo(media, stereoMids, nackMids) {
     }
   }
 }
+/**
+ * Returns the mids of transceivers that carry no outgoing track: the
+ * pre-populated placeholders added by `RTCEngine.applyInitialPublisherLayout`,
+ * plus any transceiver that was used for a track and reverted on unpublish. The
+ * `sender.track` check is the reliable signal — an unpublished section keeps its
+ * `a=msid` (and its stale send-derived fmtp), so it can't be told apart from a
+ * real send by SDP alone. Transceiver mids are stable across renegotiations, so
+ * this works for every offer/answer after the first.
+ * @internal
+ */
+function placeholderMidsFromTransceivers(transceivers) {
+  const mids = new Set();
+  for (const transceiver of transceivers) {
+    if (transceiver.mid && !transceiver.sender.track) {
+      mids.add(transceiver.mid);
+    }
+  }
+  return mids;
+}
+/**
+ * Within a BUNDLE group a payload type must map to identical codec parameters
+ * across every m-line. When the same payload type carries different fmtp between
+ * sections — e.g. opus `usedtx=1` on the published microphone but not on the
+ * pre-populated recvonly placeholders, or H.265 with different `level-id` between
+ * a published video track and a placeholder — libwebrtc flags a "bundled payload
+ * type collision".
+ *
+ * Rewrite the placeholder sections so every shared payload type carries the
+ * same fmtp. Real (non-placeholder) sections always win the canonical value, so
+ * a published track's encoder parameters are never altered. When no real
+ * section declares a payload type — e.g. a placeholder that was reused for a
+ * track and then reverted to recvonly keeps its send-derived `level-id` while
+ * fresh placeholders use the default — the placeholders still converge on the
+ * first value seen, so two placeholders can't disagree either. Only placeholder
+ * sections are ever rewritten, and it is codec-agnostic (opus, H.265, ...).
+ * `isPlaceholder` identifies the sections to conform.
+ * @internal
+ */
+function conformBundledCodecFmtp(media, isPlaceholder) {
+  var _a, _b;
+  // Canonical fmtp per payload type. Payload types are unique within a BUNDLE
+  // group, so keying by payload alone (across audio and video) is safe. A real
+  // section's value always takes precedence; otherwise the first placeholder
+  // value seen is used so divergent placeholders still converge.
+  const canonicalByPayload = new Map();
+  const fromRealSection = new Set();
+  for (const m of media) {
+    const placeholder = isPlaceholder(m);
+    for (const fmtp of (_a = m.fmtp) !== null && _a !== void 0 ? _a : []) {
+      if (!placeholder) {
+        canonicalByPayload.set(fmtp.payload, fmtp.config);
+        fromRealSection.add(fmtp.payload);
+      } else if (!canonicalByPayload.has(fmtp.payload)) {
+        canonicalByPayload.set(fmtp.payload, fmtp.config);
+      }
+    }
+  }
+  if (canonicalByPayload.size === 0) {
+    return;
+  }
+  // Conform placeholder sections to the canonical fmtp for each shared payload.
+  for (const m of media) {
+    if (!isPlaceholder(m)) {
+      continue;
+    }
+    for (const fmtp of (_b = m.fmtp) !== null && _b !== void 0 ? _b : []) {
+      const config = canonicalByPayload.get(fmtp.payload);
+      if (config !== undefined && fmtp.config !== config) {
+        fmtp.config = config;
+      }
+    }
+  }
+}
 function extractStereoAndNackAudioFromOffer(offer) {
   var _a;
   const stereoMids = [];
@@ -18960,6 +19107,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 +20381,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 +21213,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 +21361,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 +21383,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 +21691,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 +21715,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 +21989,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 +22036,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 +22066,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 +22098,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 +22133,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 +22149,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 +22187,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 +22481,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 +22503,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 +26189,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 +26389,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 +28351,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 +28647,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 +28710,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 +29982,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 +30673,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 +30815,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 +33003,7 @@ function areTokenSourceFetchOptionsEqual(a, b) {
       case 'participantAttributes':
       case 'agentName':
       case 'agentMetadata':
+      case 'deployment':
         if (a[key] !== b[key]) {
           return false;
         }
@@ -32808,26 +33028,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 +33113,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 +33140,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 +33355,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