livekit-client 2.19.2 → 2.20.1

package/dist/livekit-client.e2ee.worker.mjs

@@ -5939,13 +5939,14 @@ function isWeb() {
   return typeof document !== 'undefined';
 }
 
-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));
 }
 
 const PACKET_TRAILER_MAGIC = Uint8Array.from(['L'.charCodeAt(0), 'K'.charCodeAt(0), 'T'.charCodeAt(0), 'S'.charCodeAt(0)]);
 const PACKET_TRAILER_TIMESTAMP_TAG = 0x01;
 const PACKET_TRAILER_FRAME_ID_TAG = 0x02;
+const PACKET_TRAILER_USER_DATA_TAG = 0x03;
 const PACKET_TRAILER_ENVELOPE_SIZE = 5;
 const TIMESTAMP_TLV_SIZE = 10;
 const FRAME_ID_TLV_SIZE = 6;
@@ -5977,7 +5978,7 @@ function appendPacketTrailer(data, userTimestamp, frameId) {
   return result;
 }
 function appendPacketTrailerToEncodedFrame(frame, options, frameId) {
-  if (!hasPacketTrailerPublishOptions(options) || frame.data.byteLength === 0) {
+  if (!hasFrameMetadataPublishOptions(options) || frame.data.byteLength === 0) {
     return false;
   }
   const userTimestamp = (options === null || options === void 0 ? void 0 : options.timestamp) ? BigInt(Date.now()) * BigInt(1000) : BigInt(0);
@@ -6030,6 +6031,13 @@ function extractPacketTrailer(data) {
     } else if (tag === PACKET_TRAILER_FRAME_ID_TAG && length === 4) {
       metadata.frameId = readUint32Xor(bytes, offset, length);
       foundAny = true;
+    } else if (tag === PACKET_TRAILER_USER_DATA_TAG) {
+      const userData = new Uint8Array(length);
+      for (let index = 0; index < length; index += 1) {
+        userData[index] = bytes[offset + index] ^ 0xff;
+      }
+      metadata.userData = userData;
+      foundAny = true;
     }
     offset += length;
   }
@@ -6138,10 +6146,6 @@ function processPacketTrailer(frame, trackId) {
   };
 }
 
-/**
- * NALU (Network Abstraction Layer Unit) utilities for H.264 and H.265 video processing
- * Contains functions for parsing and working with NALUs in video frames
- */
 /**
  * Mask for extracting NALU type from H.264 header byte
  */
@@ -6463,8 +6467,8 @@ class FrameCryptor extends BaseFrameCryptor {
      * When false, we skip the per-frame trailer extraction path entirely
      * on decode to avoid unnecessary work on tracks that don't use it.
      */
-    this.hasPacketTrailer = false;
-    this.packetTrailerFrameId = 0;
+    this.hasFrameMetadata = false;
+    this.frameMetadataFrameId = 0;
     /**
      * Throttling mechanism for decryption errors to prevent memory leaks
      */
@@ -6556,14 +6560,14 @@ class FrameCryptor extends BaseFrameCryptor {
    * trailer data. When false, {@link decodeFunction} skips the per-frame
    * trailer extraction branch entirely.
    */
-  setHasPacketTrailer(hasPacketTrailer) {
-    this.hasPacketTrailer = hasPacketTrailer;
+  setHasFrameMetadata(hasFrameMetadata) {
+    this.hasFrameMetadata = hasFrameMetadata;
   }
-  setPacketTrailer(packetTrailer) {
-    this.packetTrailer = packetTrailer;
-    this.packetTrailerFrameId = 0;
+  setFrameMetadataOpts(frameMetadata) {
+    this.frameMetadataOpts = frameMetadata;
+    this.frameMetadataFrameId = 0;
   }
-  setupTransform(operation, readable, writable, trackId, isReuse, codec, packetTrailer) {
+  setupTransform(operation, readable, writable, trackId, isReuse, codec, frameMetadata) {
     if (codec) {
       workerLogger.info('setting codec on cryptor to', {
         codec
@@ -6571,7 +6575,7 @@ class FrameCryptor extends BaseFrameCryptor {
       this.videoCodec = codec;
     }
     if (operation === 'encode') {
-      this.setPacketTrailer(packetTrailer);
+      this.setFrameMetadataOpts(frameMetadata);
     }
     workerLogger.debug('Setting up frame cryptor transform', Object.assign({
       operation,
@@ -6712,7 +6716,7 @@ class FrameCryptor extends BaseFrameCryptor {
         return controller.enqueue(encodedFrame);
       }
       if (!this.isEnabled()) {
-        this.appendPacketTrailer(encodedFrame);
+        this.appendFrameMetadata(encodedFrame);
         return controller.enqueue(encodedFrame);
       }
       const keySet = this.keys.getKeySet();
@@ -6755,7 +6759,7 @@ class FrameCryptor extends BaseFrameCryptor {
           newData.set(frameHeader);
           newData.set(newDataWithoutHeader, frameHeader.byteLength);
           encodedFrame.data = newData.buffer;
-          this.appendPacketTrailer(encodedFrame);
+          this.appendFrameMetadata(encodedFrame);
           return controller.enqueue(encodedFrame);
         } catch (e) {
           // TODO: surface this to the app.
@@ -6767,15 +6771,15 @@ class FrameCryptor extends BaseFrameCryptor {
       }
     });
   }
-  appendPacketTrailer(encodedFrame) {
+  appendFrameMetadata(encodedFrame) {
     var _a;
-    if (!hasPacketTrailerPublishOptions(this.packetTrailer) || !isVideoFrame(encodedFrame)) {
+    if (!hasFrameMetadataPublishOptions(this.frameMetadataOpts) || !isVideoFrame(encodedFrame)) {
       return;
     }
-    if ((_a = this.packetTrailer) === null || _a === void 0 ? void 0 : _a.frameId) {
-      this.packetTrailerFrameId = this.packetTrailerFrameId === 0xffffffff ? 1 : this.packetTrailerFrameId + 1;
+    if ((_a = this.frameMetadataOpts) === null || _a === void 0 ? void 0 : _a.frameId) {
+      this.frameMetadataFrameId = this.frameMetadataFrameId === 0xffffffff ? 1 : this.frameMetadataFrameId + 1;
     }
-    appendPacketTrailerToEncodedFrame(encodedFrame, this.packetTrailer, this.packetTrailerFrameId);
+    appendPacketTrailerToEncodedFrame(encodedFrame, this.frameMetadataOpts, this.frameMetadataFrameId);
   }
   /**
    * Function that will be injected in a stream and will decrypt the given encoded frames.
@@ -6785,7 +6789,7 @@ class FrameCryptor extends BaseFrameCryptor {
    */
   decodeFunction(encodedFrame, controller) {
     return __awaiter(this, void 0, void 0, function* () {
-      if (this.hasPacketTrailer && isVideoFrame(encodedFrame)) {
+      if (this.hasFrameMetadata && isVideoFrame(encodedFrame)) {
         try {
           const ptResult = processPacketTrailer(encodedFrame, this.trackId);
           if (ptResult.data) {
@@ -7305,12 +7309,12 @@ onmessage = ev => {
         break;
       case 'decode':
         let cryptor = getTrackCryptor(data.participantIdentity, data.trackId);
-        cryptor.setHasPacketTrailer(data.hasPacketTrailer);
+        cryptor.setHasFrameMetadata(data.hasPacketTrailer);
         cryptor.setupTransform(kind, data.readableStream, data.writableStream, data.trackId, data.isReuse, data.codec);
         break;
       case 'encode':
         let pubCryptor = getTrackCryptor(data.participantIdentity, data.trackId);
-        pubCryptor.setHasPacketTrailer(data.hasPacketTrailer);
+        pubCryptor.setHasFrameMetadata(data.hasPacketTrailer);
         pubCryptor.setupTransform(kind, data.readableStream, data.writableStream, data.trackId, data.isReuse, data.codec, data.packetTrailer);
         break;
       case 'encryptDataRequest':
@@ -7376,7 +7380,7 @@ onmessage = ev => {
       case 'updateCodec':
         const trackCryptor = getTrackCryptor(data.participantIdentity, data.trackId);
         trackCryptor.setVideoCodec(data.codec);
-        trackCryptor.setHasPacketTrailer(data.hasPacketTrailer);
+        trackCryptor.setHasFrameMetadata(data.hasPacketTrailer);
         workerLogger.info('updated codec', {
           participantIdentity: data.participantIdentity,
           trackId: data.trackId,
@@ -7548,7 +7552,7 @@ if (self.RTCTransformEvent) {
       hasPacketTrailer = options.hasPacketTrailer;
     messageQueue.run(() => __awaiter(void 0, void 0, void 0, function* () {
       const cryptor = getTrackCryptor(participantIdentity, trackId);
-      cryptor.setHasPacketTrailer(hasPacketTrailer);
+      cryptor.setHasFrameMetadata(hasPacketTrailer);
       workerLogger.debug('onrtctransform setup', {
         participantIdentity,
         trackId,