livekit-client 2.19.2 → 2.20.1

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

@@ -1,4 +1,4 @@
-import type { PacketTrailerPublishOptions } from '../../packetTrailer/types';
+import type { FrameMetadataPublishOptions } from '../../frameMetadata/types';
 import type { Track } from './Track';
 import type { AudioProcessorOptions, TrackProcessor, VideoProcessorOptions } from './processor/types';
 export interface TrackPublishDefaults {
@@ -113,14 +113,18 @@ export interface TrackPublishDefaults {
      */
     preConnectBuffer?: boolean;
     /**
-     * Packet trailer metadata to append to published video frames.
+     * Frame metadata to append to published video frames.
      *
-     * Requires either room-level packet trailer worker configuration or E2EE,
-     * because encoded frame transforms are used to write the trailer.
+     * Requires either room-level frame metadata worker configuration or E2EE,
+     * because encoded frame transforms are used to write the metadata.
      *
      * @experimental
      */
-    packetTrailer?: PacketTrailerPublishOptions;
+    frameMetadata?: FrameMetadataPublishOptions;
+    /**
+     * @deprecated Use {@link TrackPublishDefaults.frameMetadata} instead.
+     */
+    packetTrailer?: FrameMetadataPublishOptions;
 }
 /**
  * Options when publishing tracks
@@ -248,6 +252,14 @@ export interface AudioCaptureOptions {
      * @see https://w3c.github.io/mediacapture-extensions/#voiceisolation-constraint
      */
     voiceIsolation?: ConstrainBoolean;
+    /**
+     * @experimental
+     * when capturing system/screen-share audio, excludes the local participant's own audio
+     * from the captured stream to prevent echo. Browser support is not widespread yet
+     * (as of mid 2026, Chromium-based browsers only).
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/MediaTrackConstraints/restrictOwnAudio
+     */
+    restrictOwnAudio?: ConstrainBoolean;
     /**
      * the sample rate or range of sample rates which are acceptable and/or required.
      */

package/dist/ts4.2/room/utils.d.ts

@@ -1,5 +1,6 @@
 import { ChatMessage as ChatMessageModel, ClientInfo, ClientInfo_Capability, DisconnectReason, Transcription as TranscriptionModel } from '@livekit/protocol';
 import type { Throws } from '@livekit/throws-transformer/throws';
+import type { NonSharedUint8Array } from '../type-polyfills/non-shared-typed-arrays';
 import TypedPromise from '../utils/TypedPromise';
 import type { BrowserDetails } from '../utils/browserParser';
 import type { ConnectionError } from './errors';

package/dist/ts4.2/type-polyfills/non-shared-typed-arrays.d.ts

@@ -0,0 +1,2 @@
+export type NonSharedUint8Array = ReturnType<typeof Uint8Array.from>;
+//# sourceMappingURL=non-shared-typed-arrays.d.ts.map

package/dist/ts4.2/utils/dataPacketBuffer.d.ts

@@ -1,3 +1,4 @@
+import type { NonSharedUint8Array } from '../type-polyfills/non-shared-typed-arrays';
 export interface DataPacketItem {
     data: NonSharedUint8Array;
     sequence: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "livekit-client",
-  "version": "2.19.2",
+  "version": "2.20.1",
   "description": "JavaScript/TypeScript client SDK for LiveKit",
   "main": "./dist/livekit-client.umd.js",
   "unpkg": "./dist/livekit-client.umd.js",
@@ -17,9 +17,14 @@
       "require": "./dist/livekit-client.e2ee.worker.js"
     },
     "./packet-trailer-worker": {
-      "types": "./dist/src/packetTrailer/worker/packetTrailer.worker.d.ts",
-      "import": "./dist/livekit-client.pt.worker.mjs",
-      "require": "./dist/livekit-client.pt.worker.js"
+      "types": "./dist/src/frameMetadata/worker/frameMetadata.worker.d.ts",
+      "import": "./dist/livekit-client.fm.worker.mjs",
+      "require": "./dist/livekit-client.fm.worker.js"
+    },
+    "./frame-metadata-worker": {
+      "types": "./dist/src/frameMetadata/worker/frameMetadata.worker.d.ts",
+      "import": "./dist/livekit-client.fm.worker.mjs",
+      "require": "./dist/livekit-client.fm.worker.js"
     }
   },
   "files": [
@@ -35,8 +40,8 @@
       "./dist/src/e2ee/worker/e2ee.worker.d.ts": [
         "./dist/ts4.2/e2ee/worker/e2ee.worker.d.ts"
       ],
-      "./dist/src/packetTrailer/worker/packetTrailer.worker.d.ts": [
-        "./dist/ts4.2/packetTrailer/worker/packetTrailer.worker.d.ts"
+      "./dist/src/frameMetadata/worker/frameMetadata.worker.d.ts": [
+        "./dist/ts4.2/frameMetadata/worker/frameMetadata.worker.d.ts"
       ]
     }
   },
@@ -45,21 +50,21 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@livekit/mutex": "1.1.1",
-    "@livekit/protocol": "1.45.8",
+    "@livekit/protocol": "1.46.6",
     "events": "^3.3.0",
     "jose": "^6.1.0",
     "loglevel": "^1.9.2",
     "sdp-transform": "^2.15.0",
     "tslib": "2.8.1",
     "typed-emitter": "^2.1.0",
-    "webrtc-adapter": "9.0.5"
+    "webrtc-adapter": "9.0.6"
   },
   "peerDependencies": {
     "@types/dom-mediacapture-record": "^1"
   },
   "devDependencies": {
-    "@babel/core": "7.29.0",
-    "@babel/preset-env": "7.29.5",
+    "@babel/core": "7.29.7",
+    "@babel/preset-env": "7.29.7",
     "@bufbuild/protoc-gen-es": "^1.10.0",
     "@changesets/cli": "2.31.0",
     "@eslint/js": "10.0.1",
@@ -69,16 +74,16 @@
     "@rollup/plugin-commonjs": "29.0.2",
     "@rollup/plugin-json": "6.1.0",
     "@rollup/plugin-node-resolve": "16.0.3",
-    "@rollup/plugin-terser": "^0.4.4",
-    "@size-limit/file": "^11.2.0",
-    "@size-limit/webpack": "^11.2.0",
+    "@rollup/plugin-terser": "^1.0.0",
+    "@size-limit/file": "^12.1.0",
+    "@size-limit/webpack": "^12.1.0",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "@trivago/prettier-plugin-sort-imports": "^5.0.0",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
     "@types/events": "^3.0.3",
     "@types/sdp-transform": "2.15.0",
     "@types/ua-parser-js": "0.7.39",
-    "@typescript-eslint/eslint-plugin": "8.59.3",
-    "@typescript-eslint/parser": "8.59.3",
+    "@typescript-eslint/eslint-plugin": "8.59.4",
+    "@typescript-eslint/parser": "8.59.4",
     "downlevel-dts": "^0.11.0",
     "eslint": "10.4.0",
     "eslint-config-airbnb-extended": "^2.3.2",
@@ -101,11 +106,11 @@
     "typedoc-plugin-no-inherit": "1.6.1",
     "typescript": "5.9.3",
     "typescript-eslint": "^8.47.0",
-    "vite": "7.3.3",
-    "vitest": "^3.0.0"
+    "vite": "7.3.5",
+    "vitest": "^4.0.0"
   },
   "scripts": {
-    "build": "rollup --config --bundleConfigAsCjs && rollup --config rollup.config.worker.js --bundleConfigAsCjs && rollup --config rollup.config.pt-worker.js --bundleConfigAsCjs && pnpm downlevel-dts",
+    "build": "rollup --config --bundleConfigAsCjs && rollup --config rollup.config.worker.js --bundleConfigAsCjs && rollup --config rollup.config.fm-worker.js --bundleConfigAsCjs && pnpm downlevel-dts",
     "build:clean": "rm -rf ./dist && pnpm build",
     "build:watch": "rollup --watch --config --bundleConfigAsCjs",
     "build:worker:watch": "rollup --watch --config rollup.config.worker.js --bundleConfigAsCjs",

package/src/api/SignalClient.test.ts

@@ -77,7 +77,7 @@ function mockWebSocketStream(options: MockWebSocketStreamOptions = {}) {
     onUrl,
   } = options;
 
-  return vi.mocked(WebSocketStream).mockImplementationOnce((url) => {
+  return vi.mocked(WebSocketStream).mockImplementationOnce(function (url) {
     onUrl?.(url);
     return {
       url: 'wss://test.livekit.io',
@@ -283,7 +283,7 @@ describe('SignalClient.connect', () => {
     it('should reject when AbortSignal is triggered', async () => {
       const abortController = new AbortController();
 
-      vi.mocked(WebSocketStream).mockImplementation(() => {
+      vi.mocked(WebSocketStream).mockImplementation(function () {
         // Simulate abort
         setTimeout(() => abortController.abort(new Error('User aborted connection')), 50);
 
@@ -344,7 +344,7 @@ describe('SignalClient.connect', () => {
         extensions: '',
       };
 
-      vi.mocked(WebSocketStream).mockImplementation(() => {
+      vi.mocked(WebSocketStream).mockImplementation(function () {
         return {
           url: 'wss://test.livekit.io',
           opened: Promise.resolve(mockConnection),
@@ -526,7 +526,7 @@ describe('SignalClient.connect', () => {
         closedResolve = resolve;
       });
 
-      vi.mocked(WebSocketStream).mockImplementation(() => {
+      vi.mocked(WebSocketStream).mockImplementation(function () {
         // Simulate close during connection
         queueMicrotask(() => {
           closedResolve({ closeCode: 1006, reason: 'Connection lost' });

package/src/api/SignalClient.ts

@@ -61,6 +61,7 @@ import { ConnectionError } from '../room/errors';
 import CriticalTimers from '../room/timers';
 import type { LoggerOptions } from '../room/types';
 import { getClientInfo, isCompressionStreamSupported, isReactNative, sleep } from '../room/utils';
+import type { NonSharedUint8Array } from '../type-polyfills/non-shared-typed-arrays';
 import { AsyncQueue } from '../utils/AsyncQueue';
 import { type WebSocketConnection, WebSocketStream } from './WebSocketStream';
 import {
@@ -376,13 +377,17 @@ export class SignalClient {
         if (redactedUrl.searchParams.has('access_token')) {
           redactedUrl.searchParams.set('access_token', '<redacted>');
         }
+
+        if (this.ws) {
+          const startClose = performance.now();
+          await this.close(false);
+          this.log.debug(`closed previous ws connection in ${performance.now() - startClose}ms`);
+        }
+
         this.log.info(`signal connecting to ${redactedUrl}`, {
           reconnect: opts.reconnect,
           reconnectReason: opts.reconnectReason,
         });
-        if (this.ws) {
-          await this.close(false);
-        }
         this.ws = new WebSocketStream<ArrayBuffer>(rtcUrl);
 
         try {

package/src/api/WebSocketStream.test.ts

@@ -129,24 +129,24 @@ describe('WebSocketStream', () => {
     vi.clearAllMocks();
 
     // Store original WebSocket
-    originalWebSocket = global.WebSocket;
+    originalWebSocket = globalThis.WebSocket;
 
     // Mock WebSocket globally
-    global.WebSocket = vi.fn((url: string, protocols?: string | string[]) => {
+    globalThis.WebSocket = vi.fn(function (url: string, protocols?: string | string[]) {
       mockWebSocket = new MockWebSocket(url, protocols);
       return mockWebSocket as any;
     }) as any;
 
     // Add constants to the mocked WebSocket
-    (global.WebSocket as any).CONNECTING = MockWebSocket.CONNECTING;
-    (global.WebSocket as any).OPEN = MockWebSocket.OPEN;
-    (global.WebSocket as any).CLOSING = MockWebSocket.CLOSING;
-    (global.WebSocket as any).CLOSED = MockWebSocket.CLOSED;
+    (globalThis.WebSocket as any).CONNECTING = MockWebSocket.CONNECTING;
+    (globalThis.WebSocket as any).OPEN = MockWebSocket.OPEN;
+    (globalThis.WebSocket as any).CLOSING = MockWebSocket.CLOSING;
+    (globalThis.WebSocket as any).CLOSED = MockWebSocket.CLOSED;
   });
 
   afterEach(() => {
     // Restore original WebSocket
-    global.WebSocket = originalWebSocket;
+    globalThis.WebSocket = originalWebSocket;
   });
 
   describe('Constructor and Initialization', () => {

package/src/e2ee/E2eeManager.ts

@@ -1,8 +1,9 @@
 import { Encryption_Type, TrackInfo } from '@livekit/protocol';
 import { EventEmitter } from 'events';
 import type TypedEventEmitter from 'typed-emitter';
+import type { FrameMetadata } from '../frameMetadata/types';
+import { hasFrameMetadataPublishOptions } from '../frameMetadata/utils';
 import log, { LogLevel, workerLogger } from '../logger';
-import { hasPacketTrailerPublishOptions } from '../packetTrailer/utils';
 import type RTCEngine from '../room/RTCEngine';
 import type Room from '../room/Room';
 import { ConnectionState } from '../room/Room';
@@ -20,6 +21,7 @@ import {
   isScriptTransformSupportedForWorker,
   isVideoTrack,
 } from '../room/utils';
+import type { NonSharedUint8Array } from '../type-polyfills/non-shared-typed-arrays';
 import type { BaseKeyProvider } from './KeyProvider';
 import { E2EE_FLAG } from './constants';
 import { type E2EEManagerCallbacks, EncryptionEvent, KeyProviderEvent } from './events';
@@ -230,7 +232,7 @@ export class E2EEManager
         }
         break;
       case 'packetTrailerMetadata':
-        this.handlePacketTrailerMetadata(data.trackId, data.rtpTimestamp, data.ssrc, data.metadata);
+        this.handleFrameMetadata(data.trackId, data.rtpTimestamp, data.ssrc, data.metadata);
         break;
       default:
         break;
@@ -242,11 +244,11 @@ export class E2EEManager
     this.emit(EncryptionEvent.EncryptionError, ev.error, undefined);
   };
 
-  private handlePacketTrailerMetadata(
+  private handleFrameMetadata(
     trackId: string,
     rtpTimestamp: number,
     ssrc: number,
-    metadata: { userTimestamp: bigint; frameId: number },
+    metadata: FrameMetadata,
   ) {
     if (!this.room) {
       return;
@@ -260,9 +262,9 @@ export class E2EEManager
           pub.track &&
           pub.track.mediaStreamID === trackId &&
           pub.track instanceof RemoteVideoTrack &&
-          pub.track.packetTrailerExtractor
+          pub.track.frameMetadataExtractor
         ) {
-          pub.track.packetTrailerExtractor.storeMetadata(rtpTimestamp, ssrc, metadata);
+          pub.track.frameMetadataExtractor.storeMetadata(rtpTimestamp, ssrc, metadata);
           return;
         }
       }
@@ -509,7 +511,9 @@ export class E2EEManager
       sender,
       track.mediaStreamID,
       undefined,
-      isVideoTrack(track) ? track.publishOptions?.packetTrailer : undefined,
+      isVideoTrack(track)
+        ? (track.publishOptions?.frameMetadata ?? track.publishOptions?.packetTrailer)
+        : undefined,
     );
   }
 
@@ -598,7 +602,7 @@ export class E2EEManager
     sender: RTCRtpSender,
     trackId: string,
     codec?: VideoCodec,
-    packetTrailer?: TrackPublishOptions['packetTrailer'],
+    frameMetadata?: TrackPublishOptions['frameMetadata'],
   ) {
     if (E2EE_FLAG in sender || !this.worker) {
       return;
@@ -615,8 +619,8 @@ export class E2EEManager
         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);
@@ -633,8 +637,8 @@ export class E2EEManager
           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]);

package/src/e2ee/types.ts

@@ -1,7 +1,8 @@
+import type { FrameMetadataPayload } from '../frameMetadata/frameMetadata';
+import type { FrameMetadataPublishOptions } from '../frameMetadata/types';
 import type { LogLevel } from '../logger';
-import type { PacketTrailerFramePayload } from '../packetTrailer/packetTrailer';
-import type { PacketTrailerPublishOptions } from '../packetTrailer/types';
 import type { VideoCodec } from '../room/track/options';
+import type { NonSharedUint8Array } from '../type-polyfills/non-shared-typed-arrays';
 import type { BaseE2EEManager } from './E2eeManager';
 import type { BaseKeyProvider } from './KeyProvider';
 
@@ -62,7 +63,7 @@ export interface EncodeMessage extends BaseMessage {
     /**
      * Packet trailer metadata to append on published video frames.
      */
-    packetTrailer?: PacketTrailerPublishOptions;
+    packetTrailer?: FrameMetadataPublishOptions;
   };
 }
 
@@ -165,7 +166,7 @@ export interface EncryptDataResponseMessage extends BaseMessage {
 
 export interface PTMetadataFromE2EEMessage extends BaseMessage {
   kind: 'packetTrailerMetadata';
-  data: PacketTrailerFramePayload;
+  data: FrameMetadataPayload;
 }
 
 export type E2EEWorkerMessage =
@@ -249,5 +250,5 @@ export type ScriptTransformOptions = {
   /**
    * Packet trailer metadata to append on published video frames.
    */
-  packetTrailer?: PacketTrailerPublishOptions;
+  packetTrailer?: FrameMetadataPublishOptions;
 };

package/src/e2ee/utils.ts

@@ -1,4 +1,5 @@
 import { type DataPacket, EncryptedPacketPayload } from '@livekit/protocol';
+import type { NonSharedUint8Array } from '../type-polyfills/non-shared-typed-arrays';
 import { ENCRYPTION_ALGORITHM } from './constants';
 import type { KeyProviderOptions } from './types';
 

package/src/e2ee/worker/DataCryptor.ts

@@ -1,4 +1,5 @@
 import { workerLogger } from '../../logger';
+import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
 import { ENCRYPTION_ALGORITHM } from '../constants';
 import { CryptorError, CryptorErrorReason } from '../errors';
 import type { DecodeRatchetOptions, KeySet, RatchetResult } from '../types';

package/src/e2ee/worker/FrameCryptor.test.ts

@@ -1,6 +1,7 @@
 import { afterEach, describe, expect, it, vitest } from 'vitest';
-import { appendPacketTrailer, extractPacketTrailer } from '../../packetTrailer/packetTrailer';
-import type { PacketTrailerPublishOptions } from '../../packetTrailer/types';
+import { appendPacketTrailer, extractPacketTrailer } from '../../frameMetadata/frameMetadata';
+import type { FrameMetadataPublishOptions } from '../../frameMetadata/types';
+import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
 import { IV_LENGTH, KEY_PROVIDER_DEFAULTS } from '../constants';
 import { CryptorEvent } from '../events';
 import type { KeyProviderOptions } from '../types';
@@ -69,7 +70,7 @@ function prepareParticipantTestDecoder(
 function prepareParticipantTestEncoder(
   participantIdentity: string,
   partialKeyProviderOptions: Partial<KeyProviderOptions>,
-  packetTrailer?: PacketTrailerPublishOptions,
+  packetTrailer?: FrameMetadataPublishOptions,
 ) {
   return prepareParticipantTest(
     'encode',
@@ -83,7 +84,7 @@ function prepareParticipantTest(
   mode: 'encode' | 'decode',
   participantIdentity: string,
   partialKeyProviderOptions: Partial<KeyProviderOptions>,
-  packetTrailer?: PacketTrailerPublishOptions,
+  packetTrailer?: FrameMetadataPublishOptions,
 ): {
   keys: ParticipantKeyHandler;
   cryptor: FrameCryptor;
@@ -536,7 +537,7 @@ describe('FrameCryptor', () => {
         const postMessage = vitest.fn();
         vitest.stubGlobal('postMessage', postMessage);
         encryptionEnabledMap.set(participantIdentity, false);
-        cryptor.setHasPacketTrailer(true);
+        cryptor.setHasFrameMetadata(true);
 
         const payload = Uint8Array.from([1, 2, 3, 4]);
         const trailer = appendPacketTrailer(payload, 1_744_249_600_123_456n, 0);

package/src/e2ee/worker/FrameCryptor.ts

@@ -1,15 +1,16 @@
 // TODO code inspired by https://github.com/webrtc/samples/blob/gh-pages/src/content/insertable-streams/endtoend-encryption/js/worker.js
 import { EventEmitter } from 'events';
 import type TypedEventEmitter from 'typed-emitter';
-import { workerLogger } from '../../logger';
 import {
   appendPacketTrailerToEncodedFrame,
   processPacketTrailer,
-} from '../../packetTrailer/packetTrailer';
-import type { PacketTrailerPublishOptions } from '../../packetTrailer/types';
-import { hasPacketTrailerPublishOptions } from '../../packetTrailer/utils';
+} from '../../frameMetadata/frameMetadata';
+import type { FrameMetadataPublishOptions } from '../../frameMetadata/types';
+import { hasFrameMetadataPublishOptions } from '../../frameMetadata/utils';
+import { workerLogger } from '../../logger';
 import { type VideoCodec, videoCodecs } from '../../room/track/options';
 import { mimeTypeToVideoCodecString } from '../../room/track/utils';
+import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
 import { ENCRYPTION_ALGORITHM, IV_LENGTH, UNENCRYPTED_BYTES } from '../constants';
 import { CryptorError, CryptorErrorReason } from '../errors';
 import { type CryptorCallbacks, CryptorEvent } from '../events';
@@ -88,11 +89,11 @@ export 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.
    */
-  private hasPacketTrailer: boolean = false;
+  private hasFrameMetadata: boolean = false;
 
-  private packetTrailer?: PacketTrailerPublishOptions;
+  private frameMetadataOpts?: FrameMetadataPublishOptions;
 
-  private packetTrailerFrameId = 0;
+  private frameMetadataFrameId = 0;
 
   /**
    * Throttling mechanism for decryption errors to prevent memory leaks
@@ -212,13 +213,13 @@ export class FrameCryptor extends BaseFrameCryptor {
    * trailer data. When false, {@link decodeFunction} skips the per-frame
    * trailer extraction branch entirely.
    */
-  setHasPacketTrailer(hasPacketTrailer: boolean) {
-    this.hasPacketTrailer = hasPacketTrailer;
+  setHasFrameMetadata(hasFrameMetadata: boolean) {
+    this.hasFrameMetadata = hasFrameMetadata;
   }
 
-  setPacketTrailer(packetTrailer?: PacketTrailerPublishOptions) {
-    this.packetTrailer = packetTrailer;
-    this.packetTrailerFrameId = 0;
+  setFrameMetadataOpts(frameMetadata?: FrameMetadataPublishOptions) {
+    this.frameMetadataOpts = frameMetadata;
+    this.frameMetadataFrameId = 0;
   }
 
   setupTransform(
@@ -228,14 +229,14 @@ export class FrameCryptor extends BaseFrameCryptor {
     trackId: string,
     isReuse: boolean,
     codec?: VideoCodec,
-    packetTrailer?: PacketTrailerPublishOptions,
+    frameMetadata?: FrameMetadataPublishOptions,
   ) {
     if (codec) {
       workerLogger.info('setting codec on cryptor to', { codec });
       this.videoCodec = codec;
     }
     if (operation === 'encode') {
-      this.setPacketTrailer(packetTrailer);
+      this.setFrameMetadataOpts(frameMetadata);
     }
 
     workerLogger.debug('Setting up frame cryptor transform', {
@@ -406,7 +407,7 @@ export class FrameCryptor extends BaseFrameCryptor {
     }
 
     if (!this.isEnabled()) {
-      this.appendPacketTrailer(encodedFrame);
+      this.appendFrameMetadata(encodedFrame);
       return controller.enqueue(encodedFrame);
     }
     const keySet = this.keys.getKeySet();
@@ -475,7 +476,7 @@ export class FrameCryptor extends BaseFrameCryptor {
         newData.set(newDataWithoutHeader, frameHeader.byteLength);
 
         encodedFrame.data = newData.buffer;
-        this.appendPacketTrailer(encodedFrame);
+        this.appendFrameMetadata(encodedFrame);
 
         return controller.enqueue(encodedFrame);
       } catch (e: any) {
@@ -494,16 +495,20 @@ export class FrameCryptor extends BaseFrameCryptor {
     }
   }
 
-  private appendPacketTrailer(encodedFrame: RTCEncodedVideoFrame | RTCEncodedAudioFrame) {
-    if (!hasPacketTrailerPublishOptions(this.packetTrailer) || !isVideoFrame(encodedFrame)) {
+  private appendFrameMetadata(encodedFrame: RTCEncodedVideoFrame | RTCEncodedAudioFrame) {
+    if (!hasFrameMetadataPublishOptions(this.frameMetadataOpts) || !isVideoFrame(encodedFrame)) {
       return;
     }
 
-    if (this.packetTrailer?.frameId) {
-      this.packetTrailerFrameId =
-        this.packetTrailerFrameId === 0xffffffff ? 1 : this.packetTrailerFrameId + 1;
+    if (this.frameMetadataOpts?.frameId) {
+      this.frameMetadataFrameId =
+        this.frameMetadataFrameId === 0xffffffff ? 1 : this.frameMetadataFrameId + 1;
     }
-    appendPacketTrailerToEncodedFrame(encodedFrame, this.packetTrailer, this.packetTrailerFrameId);
+    appendPacketTrailerToEncodedFrame(
+      encodedFrame,
+      this.frameMetadataOpts,
+      this.frameMetadataFrameId,
+    );
   }
 
   /**
@@ -516,7 +521,7 @@ export class FrameCryptor extends BaseFrameCryptor {
     encodedFrame: RTCEncodedVideoFrame | RTCEncodedAudioFrame,
     controller: TransformStreamDefaultController,
   ) {
-    if (this.hasPacketTrailer && isVideoFrame(encodedFrame)) {
+    if (this.hasFrameMetadata && isVideoFrame(encodedFrame)) {
       try {
         const ptResult = processPacketTrailer(encodedFrame, this.trackId);
         if (ptResult.data) {

package/src/e2ee/worker/ParticipantKeyHandler.test.ts

@@ -1,4 +1,5 @@
 import { describe, expect, it, test, vitest } from 'vitest';
+import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
 import { ENCRYPTION_ALGORITHM, KEY_PROVIDER_DEFAULTS } from '../constants';
 import { KeyHandlerEvent } from '../events';
 import { createKeyMaterialFromString, importKey } from '../utils';

package/src/e2ee/worker/e2ee.worker.ts

@@ -1,5 +1,6 @@
 import { workerLogger } from '../../logger';
 import type { VideoCodec } from '../../room/track/options';
+import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
 import { AsyncQueue } from '../../utils/AsyncQueue';
 import { KEY_PROVIDER_DEFAULTS } from '../constants';
 import { CryptorErrorReason } from '../errors';
@@ -64,7 +65,7 @@ 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,
@@ -76,7 +77,7 @@ onmessage = (ev) => {
         break;
       case 'encode':
         let pubCryptor = getTrackCryptor(data.participantIdentity, data.trackId);
-        pubCryptor.setHasPacketTrailer(data.hasPacketTrailer);
+        pubCryptor.setHasFrameMetadata(data.hasPacketTrailer);
         pubCryptor.setupTransform(
           kind,
           data.readableStream,
@@ -84,7 +85,7 @@ onmessage = (ev) => {
           data.trackId,
           data.isReuse,
           data.codec,
-          data.packetTrailer,
+          data.packetTrailer, // wire format still uses 'packetTrailer' field name
         );
         break;
 
@@ -164,7 +165,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,
@@ -343,7 +344,7 @@ if (self.RTCTransformEvent) {
     const { kind, participantIdentity, trackId, codec, hasPacketTrailer } = options;
     messageQueue.run(async () => {
       const cryptor = getTrackCryptor(participantIdentity, trackId);
-      cryptor.setHasPacketTrailer(hasPacketTrailer);
+      cryptor.setHasFrameMetadata(hasPacketTrailer);
       workerLogger.debug('onrtctransform setup', { participantIdentity, trackId, codec });
       cryptor.setupTransform(
         kind,

package/src/e2ee/worker/naluUtils.ts

@@ -2,6 +2,7 @@
  * 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
  */
+import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
 
 /**
  * Mask for extracting NALU type from H.264 header byte

package/src/e2ee/worker/sifPayload.ts

@@ -1,4 +1,5 @@
 import type { VideoCodec } from '../..';
+import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
 
 //  Payload definitions taken from https://github.com/livekit/livekit/blob/master/pkg/sfu/downtrack.go#L104
 

package/src/e2ee/worker/tsconfig.json

@@ -8,7 +8,10 @@
       "ES2018.Promise",
       "WebWorker",
       "ES2021.WeakRef",
-      "DOM.AsyncIterable"
+      "DOM.AsyncIterable",
+      "ES2020.BigInt",
+      "ES2018.AsyncIterable",
+      "ES2018.AsyncGenerator"
     ]
   }
 }