@livekit/react-native 2.4.2 → 2.5.0

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["registerGlobals","webrtcRegisterGlobals","setupURLPolyfill","AudioSession","AndroidAudioTypePresets","getDefaultAppleAudioConfigurationForMode","PixelRatio","Platform","iosCategoryEnforce","livekitRegisterGlobals","fixWebrtcAdapter","shimPromiseAllSettled","shimArrayAt","shimAsyncIterator","shimIterator","OS","getUserMediaFunc","global","navigator","mediaDevices","getUserMedia","constraints","audio","setAppleAudioConfiguration","audioCategory","lkGlobal","platform","devicePixelRatio","get","LiveKitReactNativeGlobal","_window","window","undefined","userAgent","product","allSettled","require","shim","Array","prototype","at"],"sources":["index.tsx"],"sourcesContent":["import { registerGlobals as webrtcRegisterGlobals } from '@livekit/react-native-webrtc';\nimport { setupURLPolyfill } from 'react-native-url-polyfill';\nimport './polyfills/EncoderDecoderTogether.min.js';\nimport AudioSession, {\n  AndroidAudioTypePresets,\n  type AndroidAudioTypeOptions,\n  type AppleAudioCategory,\n  type AppleAudioCategoryOption,\n  type AppleAudioConfiguration,\n  type AppleAudioMode,\n  type AudioTrackState,\n  getDefaultAppleAudioConfigurationForMode,\n} from './audio/AudioSession';\nimport type { AudioConfiguration } from './audio/AudioSession';\nimport { PixelRatio, Platform } from 'react-native';\nimport { type LiveKitReactNativeInfo } from 'livekit-client';\nimport type { LogLevel, SetLogLevelOptions } from './logger';\n\n/**\n * Registers the required globals needed for LiveKit to work.\n *\n * Must be called before using LiveKit.\n */\nexport function registerGlobals() {\n  webrtcRegisterGlobals();\n  iosCategoryEnforce();\n  livekitRegisterGlobals();\n  setupURLPolyfill();\n  fixWebrtcAdapter();\n  shimPromiseAllSettled();\n  shimArrayAt();\n  shimAsyncIterator();\n  shimIterator();\n}\n\n/**\n * Enforces changing to playAndRecord category prior to obtaining microphone.\n */\nfunction iosCategoryEnforce() {\n  if (Platform.OS === 'ios') {\n    // @ts-ignore\n    let getUserMediaFunc = global.navigator.mediaDevices.getUserMedia;\n    // @ts-ignore\n    global.navigator.mediaDevices.getUserMedia = async (constraints: any) => {\n      if (constraints.audio) {\n        await AudioSession.setAppleAudioConfiguration({\n          audioCategory: 'playAndRecord',\n        });\n      }\n\n      return await getUserMediaFunc(constraints);\n    };\n  }\n}\n\nfunction livekitRegisterGlobals() {\n  let lkGlobal: LiveKitReactNativeInfo = {\n    platform: Platform.OS,\n    devicePixelRatio: PixelRatio.get(),\n  };\n\n  // @ts-ignore\n  global.LiveKitReactNativeGlobal = lkGlobal;\n}\n\nfunction fixWebrtcAdapter() {\n  // @ts-ignore\n  if (window?.navigator !== undefined) {\n    // @ts-ignore\n    const { navigator } = window;\n    if (navigator.userAgent === undefined) {\n      navigator.userAgent = navigator.product ?? 'Unknown';\n    }\n  }\n}\n\nfunction shimPromiseAllSettled() {\n  var allSettled = require('promise.allsettled');\n  allSettled.shim();\n}\n\nfunction shimArrayAt() {\n  // Some versions of RN don't have Array.prototype.at, which is used by sdp-transform\n  if (!Array.prototype.at) {\n    var at = require('array.prototype.at');\n    at.shim();\n  }\n}\n\nfunction shimAsyncIterator() {\n  var shim = require('well-known-symbols/Symbol.asyncIterator/shim');\n  shim();\n}\n\nfunction shimIterator() {\n  var shim = require('well-known-symbols/Symbol.iterator/shim');\n  shim();\n}\nexport * from './hooks';\nexport * from './components/LiveKitRoom';\nexport * from './components/VideoTrack';\nexport * from './components/VideoView'; // deprecated\nexport * from './useParticipant'; // deprecated\nexport * from './useRoom'; // deprecated\nexport * from './logger';\nexport * from './audio/AudioManager';\n\nexport {\n  AudioSession,\n  AndroidAudioTypePresets,\n  getDefaultAppleAudioConfigurationForMode,\n};\nexport type {\n  AudioConfiguration,\n  AndroidAudioTypeOptions,\n  AppleAudioCategory,\n  AppleAudioCategoryOption,\n  AppleAudioConfiguration,\n  AppleAudioMode,\n  AudioTrackState,\n  LogLevel,\n  SetLogLevelOptions,\n};\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["registerGlobals","webrtcRegisterGlobals","setupURLPolyfill","AudioSession","AndroidAudioTypePresets","getDefaultAppleAudioConfigurationForMode","PixelRatio","Platform","RNE2EEManager","RNKeyProvider","iosCategoryEnforce","livekitRegisterGlobals","fixWebrtcAdapter","shimPromiseAllSettled","shimArrayAt","shimAsyncIterator","shimIterator","OS","getUserMediaFunc","global","navigator","mediaDevices","getUserMedia","constraints","audio","setAppleAudioConfiguration","audioCategory","lkGlobal","platform","devicePixelRatio","get","LiveKitReactNativeGlobal","_window","window","undefined","userAgent","product","allSettled","require","shim","Array","prototype","at"],"sources":["index.tsx"],"sourcesContent":["import { registerGlobals as webrtcRegisterGlobals } from '@livekit/react-native-webrtc';\nimport { setupURLPolyfill } from 'react-native-url-polyfill';\nimport './polyfills/EncoderDecoderTogether.min.js';\nimport AudioSession, {\n  AndroidAudioTypePresets,\n  type AndroidAudioTypeOptions,\n  type AppleAudioCategory,\n  type AppleAudioCategoryOption,\n  type AppleAudioConfiguration,\n  type AppleAudioMode,\n  type AudioTrackState,\n  getDefaultAppleAudioConfigurationForMode,\n} from './audio/AudioSession';\nimport type { AudioConfiguration } from './audio/AudioSession';\nimport { PixelRatio, Platform } from 'react-native';\nimport { type LiveKitReactNativeInfo } from 'livekit-client';\nimport type { LogLevel, SetLogLevelOptions } from './logger';\nimport RNE2EEManager from './e2ee/RNE2EEManager';\nimport RNKeyProvider, { type RNKeyProviderOptions } from './e2ee/RNKeyProvider';\n\n/**\n * Registers the required globals needed for LiveKit to work.\n *\n * Must be called before using LiveKit.\n */\nexport function registerGlobals() {\n  webrtcRegisterGlobals();\n  iosCategoryEnforce();\n  livekitRegisterGlobals();\n  setupURLPolyfill();\n  fixWebrtcAdapter();\n  shimPromiseAllSettled();\n  shimArrayAt();\n  shimAsyncIterator();\n  shimIterator();\n}\n\n/**\n * Enforces changing to playAndRecord category prior to obtaining microphone.\n */\nfunction iosCategoryEnforce() {\n  if (Platform.OS === 'ios') {\n    // @ts-ignore\n    let getUserMediaFunc = global.navigator.mediaDevices.getUserMedia;\n    // @ts-ignore\n    global.navigator.mediaDevices.getUserMedia = async (constraints: any) => {\n      if (constraints.audio) {\n        await AudioSession.setAppleAudioConfiguration({\n          audioCategory: 'playAndRecord',\n        });\n      }\n\n      return await getUserMediaFunc(constraints);\n    };\n  }\n}\n\nfunction livekitRegisterGlobals() {\n  let lkGlobal: LiveKitReactNativeInfo = {\n    platform: Platform.OS,\n    devicePixelRatio: PixelRatio.get(),\n  };\n\n  // @ts-ignore\n  global.LiveKitReactNativeGlobal = lkGlobal;\n}\n\nfunction fixWebrtcAdapter() {\n  // @ts-ignore\n  if (window?.navigator !== undefined) {\n    // @ts-ignore\n    const { navigator } = window;\n    if (navigator.userAgent === undefined) {\n      navigator.userAgent = navigator.product ?? 'Unknown';\n    }\n  }\n}\n\nfunction shimPromiseAllSettled() {\n  var allSettled = require('promise.allsettled');\n  allSettled.shim();\n}\n\nfunction shimArrayAt() {\n  // Some versions of RN don't have Array.prototype.at, which is used by sdp-transform\n  if (!Array.prototype.at) {\n    var at = require('array.prototype.at');\n    at.shim();\n  }\n}\n\nfunction shimAsyncIterator() {\n  var shim = require('well-known-symbols/Symbol.asyncIterator/shim');\n  shim();\n}\n\nfunction shimIterator() {\n  var shim = require('well-known-symbols/Symbol.iterator/shim');\n  shim();\n}\nexport * from './hooks';\nexport * from './components/LiveKitRoom';\nexport * from './components/VideoTrack';\nexport * from './components/VideoView'; // deprecated\nexport * from './useParticipant'; // deprecated\nexport * from './useRoom'; // deprecated\nexport * from './logger';\nexport * from './audio/AudioManager';\n\nexport {\n  AudioSession,\n  RNE2EEManager,\n  RNKeyProvider,\n  AndroidAudioTypePresets,\n  getDefaultAppleAudioConfigurationForMode,\n};\nexport type {\n  AudioConfiguration,\n  AndroidAudioTypeOptions,\n  AppleAudioCategory,\n  AppleAudioCategoryOption,\n  AppleAudioConfiguration,\n  AppleAudioMode,\n  AudioTrackState,\n  LogLevel,\n  SetLogLevelOptions,\n  RNKeyProviderOptions,\n};\n"],"mappings":"AAAA,SAASA,eAAe,IAAIC,qBAAqB,QAAQ,8BAA8B;AACvF,SAASC,gBAAgB,QAAQ,2BAA2B;AAC5D,OAAO,2CAA2C;AAClD,OAAOC,YAAY,IACjBC,uBAAuB,EAOvBC,wCAAwC,QACnC,sBAAsB;AAE7B,SAASC,UAAU,EAAEC,QAAQ,QAAQ,cAAc;AAGnD,OAAOC,aAAa,MAAM,sBAAsB;AAChD,OAAOC,aAAa,MAAqC,sBAAsB;;AAE/E;AACA;AACA;AACA;AACA;AACA,OAAO,SAAST,eAAeA,CAAA,EAAG;EAChCC,qBAAqB,CAAC,CAAC;EACvBS,kBAAkB,CAAC,CAAC;EACpBC,sBAAsB,CAAC,CAAC;EACxBT,gBAAgB,CAAC,CAAC;EAClBU,gBAAgB,CAAC,CAAC;EAClBC,qBAAqB,CAAC,CAAC;EACvBC,WAAW,CAAC,CAAC;EACbC,iBAAiB,CAAC,CAAC;EACnBC,YAAY,CAAC,CAAC;AAChB;;AAEA;AACA;AACA;AACA,SAASN,kBAAkBA,CAAA,EAAG;EAC5B,IAAIH,QAAQ,CAACU,EAAE,KAAK,KAAK,EAAE;IACzB;IACA,IAAIC,gBAAgB,GAAGC,MAAM,CAACC,SAAS,CAACC,YAAY,CAACC,YAAY;IACjE;IACAH,MAAM,CAACC,SAAS,CAACC,YAAY,CAACC,YAAY,GAAG,MAAOC,WAAgB,IAAK;MACvE,IAAIA,WAAW,CAACC,KAAK,EAAE;QACrB,MAAMrB,YAAY,CAACsB,0BAA0B,CAAC;UAC5CC,aAAa,EAAE;QACjB,CAAC,CAAC;MACJ;MAEA,OAAO,MAAMR,gBAAgB,CAACK,WAAW,CAAC;IAC5C,CAAC;EACH;AACF;AAEA,SAASZ,sBAAsBA,CAAA,EAAG;EAChC,IAAIgB,QAAgC,GAAG;IACrCC,QAAQ,EAAErB,QAAQ,CAACU,EAAE;IACrBY,gBAAgB,EAAEvB,UAAU,CAACwB,GAAG,CAAC;EACnC,CAAC;;EAED;EACAX,MAAM,CAACY,wBAAwB,GAAGJ,QAAQ;AAC5C;AAEA,SAASf,gBAAgBA,CAAA,EAAG;EAAA,IAAAoB,OAAA;EAC1B;EACA,IAAI,EAAAA,OAAA,GAAAC,MAAM,cAAAD,OAAA,uBAANA,OAAA,CAAQZ,SAAS,MAAKc,SAAS,EAAE;IACnC;IACA,MAAM;MAAEd;IAAU,CAAC,GAAGa,MAAM;IAC5B,IAAIb,SAAS,CAACe,SAAS,KAAKD,SAAS,EAAE;MACrCd,SAAS,CAACe,SAAS,GAAGf,SAAS,CAACgB,OAAO,IAAI,SAAS;IACtD;EACF;AACF;AAEA,SAASvB,qBAAqBA,CAAA,EAAG;EAC/B,IAAIwB,UAAU,GAAGC,OAAO,CAAC,oBAAoB,CAAC;EAC9CD,UAAU,CAACE,IAAI,CAAC,CAAC;AACnB;AAEA,SAASzB,WAAWA,CAAA,EAAG;EACrB;EACA,IAAI,CAAC0B,KAAK,CAACC,SAAS,CAACC,EAAE,EAAE;IACvB,IAAIA,EAAE,GAAGJ,OAAO,CAAC,oBAAoB,CAAC;IACtCI,EAAE,CAACH,IAAI,CAAC,CAAC;EACX;AACF;AAEA,SAASxB,iBAAiBA,CAAA,EAAG;EAC3B,IAAIwB,IAAI,GAAGD,OAAO,CAAC,8CAA8C,CAAC;EAClEC,IAAI,CAAC,CAAC;AACR;AAEA,SAASvB,YAAYA,CAAA,EAAG;EACtB,IAAIuB,IAAI,GAAGD,OAAO,CAAC,yCAAyC,CAAC;EAC7DC,IAAI,CAAC,CAAC;AACR;AACA,cAAc,SAAS;AACvB,cAAc,0BAA0B;AACxC,cAAc,yBAAyB;AACvC,cAAc,wBAAwB,CAAC,CAAC;AACxC,cAAc,kBAAkB,CAAC,CAAC;AAClC,cAAc,WAAW,CAAC,CAAC;AAC3B,cAAc,UAAU;AACxB,cAAc,sBAAsB;AAEpC,SACEpC,YAAY,EACZK,aAAa,EACbC,aAAa,EACbL,uBAAuB,EACvBC,wCAAwC","ignoreList":[]}

package/lib/typescript/lib/commonjs/components/VideoTrack.d.ts

@@ -1,4 +1,16 @@
 export const __esModule: boolean;
+/**
+ * Props for the VideoTrack component.
+ * @public
+ */
+/**
+ * VideoTrack component for displaying video tracks in a React Native application.
+ * It supports both local and remote video tracks from LiveKit, and handles adaptive streaming for remote tracks.
+ *
+ * @param props - See VideoTrackProps for details.
+ * @returns A React component that renders the given video track.
+ * @public
+ */
 export function VideoTrack({ style, trackRef, objectFit, zOrder, mirror }: {
     style?: {} | undefined;
     trackRef: any;

package/lib/typescript/lib/commonjs/e2ee/RNE2EEManager.d.ts

@@ -0,0 +1,23 @@
+export const __esModule: boolean;
+export default RNE2EEManager;
+declare const RNE2EEManager_base: any;
+/**
+ * @experimental
+ */
+declare class RNE2EEManager extends RNE2EEManager_base {
+    [x: string]: any;
+    constructor(keyProvider: any);
+    keyProvider: any;
+    encryptionEnabled: boolean;
+    setup(room: any): void;
+    room: any;
+    setupEventListeners(room: any): void;
+    setupE2EESender(publication: any, participant: any): Promise<void>;
+    setupE2EEReceiver(publication: any, participant: any): Promise<void>;
+    setSifTrailer(trailer: any): void;
+    findTrackCryptor(trackId: any): any;
+    createFrameCryptorForSender(sender: any, participantId: any): any;
+    createFrameCryptorForReceiver(receiver: any, participantId: any): any;
+    setupEngine(_engine: any): void;
+    setParticipantCryptorEnabled(enabled: any, participantIdentity: any): void;
+}

package/lib/typescript/lib/commonjs/e2ee/RNKeyProvider.d.ts

@@ -0,0 +1,33 @@
+export const __esModule: boolean;
+export default RNKeyProvider;
+declare const RNKeyProvider_base: any;
+/**
+ * Options for construction an RNKeyProvider
+ */
+/**
+ * @experimental
+ */
+declare class RNKeyProvider extends RNKeyProvider_base {
+    [x: string]: any;
+    constructor(options: any);
+    nativeKeyProvider: any;
+    getLatestKeyIndex(participantId: any): any;
+    /**
+     * Accepts a passphrase that's used to create the crypto keys.
+     * @param key
+     */
+    setSharedKey(key: any, keyIndex: any): Promise<any>;
+    ratchetSharedKey(keyIndex: any): Promise<void>;
+    /**
+     * Accepts a passphrase that's used to create the crypto keys for a participant's stream.
+     * @param key
+     */
+    setKey(participantId: any, key: any, keyIndex: any): Promise<any>;
+    ratchetKey(participantIdentity: any, keyIndex: any): Promise<void>;
+    setSifTrailer(trailer: any): Promise<any>;
+    /**
+     * @internal
+     */
+    get rtcKeyProvider(): any;
+    dispose(): void;
+}

package/lib/typescript/lib/commonjs/hooks/useE2EEManager.d.ts

@@ -0,0 +1,8 @@
+export const __esModule: boolean;
+/**
+ * @experimental
+ */
+export function useRNE2EEManager(options: any): {
+    keyProvider: any;
+    e2eeManager: any;
+};

package/lib/typescript/lib/commonjs/index.d.ts

@@ -1,6 +1,8 @@
 export const __esModule: boolean;
 export const AndroidAudioTypePresets: any;
 export const AudioSession: any;
+export const RNE2EEManager: any;
+export const RNKeyProvider: any;
 export const getDefaultAppleAudioConfigurationForMode: any;
 /**
  * Registers the required globals needed for LiveKit to work.

package/lib/typescript/lib/module/e2ee/RNE2EEManager.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="node" />
+/**
+ * @experimental
+ */
+export default class RNE2EEManager extends EventEmitter<[never]> {
+    constructor(keyProvider: any);
+    keyProvider: any;
+    encryptionEnabled: boolean;
+    setup(room: any): void;
+    room: any;
+    setupEventListeners(room: any): void;
+    setupE2EESender(publication: any, participant: any): Promise<void>;
+    setupE2EEReceiver(publication: any, participant: any): Promise<void>;
+    setSifTrailer(trailer: any): void;
+    findTrackCryptor(trackId: any): any;
+    createFrameCryptorForSender(sender: any, participantId: any): import("@livekit/react-native-webrtc").RTCFrameCryptor;
+    createFrameCryptorForReceiver(receiver: any, participantId: any): import("@livekit/react-native-webrtc").RTCFrameCryptor;
+    setupEngine(_engine: any): void;
+    setParticipantCryptorEnabled(enabled: any, participantIdentity: any): void;
+}
+import EventEmitter from 'events';

package/lib/typescript/lib/module/e2ee/RNKeyProvider.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Options for construction an RNKeyProvider
+ */
+/**
+ * @experimental
+ */
+export default class RNKeyProvider extends BaseKeyProvider {
+    constructor(options: any);
+    nativeKeyProvider: import("@livekit/react-native-webrtc").RTCKeyProvider;
+    getLatestKeyIndex(participantId: any): any;
+    /**
+     * Accepts a passphrase that's used to create the crypto keys.
+     * @param key
+     */
+    setSharedKey(key: any, keyIndex: any): Promise<any>;
+    ratchetSharedKey(keyIndex: any): Promise<void>;
+    /**
+     * Accepts a passphrase that's used to create the crypto keys for a participant's stream.
+     * @param key
+     */
+    setKey(participantId: any, key: any, keyIndex: any): Promise<any>;
+    ratchetKey(participantIdentity: any, keyIndex: any): Promise<void>;
+    setSifTrailer(trailer: any): Promise<any>;
+    /**
+     * @internal
+     */
+    get rtcKeyProvider(): import("@livekit/react-native-webrtc").RTCKeyProvider;
+    dispose(): void;
+}
+import { BaseKeyProvider } from 'livekit-client';

package/lib/typescript/lib/module/hooks/useE2EEManager.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @experimental
+ */
+export function useRNE2EEManager(options: any): {
+    keyProvider: RNKeyProvider;
+    e2eeManager: RNE2EEManager;
+};
+import { RNKeyProvider } from '..';
+import RNE2EEManager from '../e2ee/RNE2EEManager';

package/lib/typescript/lib/module/hooks.d.ts

@@ -1 +1,2 @@
+export * from "./hooks/useE2EEManager";
 export { useConnectionState, useDataChannel, useIsSpeaking, useLocalParticipant, useLocalParticipantPermissions, useParticipantInfo, useParticipants, useRemoteParticipants, useRemoteParticipant, useSpeakingParticipants, useSortedParticipants, useChat, useIsEncrypted, useRoomInfo, useIsMuted, useParticipantTracks, useLiveKitRoom, RoomContext, useRoomContext, ParticipantContext, useParticipantContext, TrackRefContext, useTrackRefContext, useTracks, isTrackReference, useEnsureTrackRef, useTrackMutedIndicator, useVisualStableUpdate } from "@livekit/components-react";

package/lib/typescript/lib/module/index.d.ts

@@ -13,6 +13,8 @@ export * from "./useRoom";
 export * from "./logger";
 export * from "./audio/AudioManager";
 import AudioSession from './audio/AudioSession';
+import RNE2EEManager from './e2ee/RNE2EEManager';
+import RNKeyProvider from './e2ee/RNKeyProvider';
 import { AndroidAudioTypePresets } from './audio/AudioSession';
 import { getDefaultAppleAudioConfigurationForMode } from './audio/AudioSession';
-export { AudioSession, AndroidAudioTypePresets, getDefaultAppleAudioConfigurationForMode };
+export { AudioSession, RNE2EEManager, RNKeyProvider, AndroidAudioTypePresets, getDefaultAppleAudioConfigurationForMode };

package/lib/typescript/src/components/VideoTrack.d.ts

@@ -1,11 +1,57 @@
 import * as React from 'react';
 import { type ViewStyle } from 'react-native';
 import type { TrackReference } from '@livekit/components-react';
+/**
+ * Props for the VideoTrack component.
+ * @public
+ */
 export type VideoTrackProps = {
+    /**
+     * The track reference to display. This should be a TrackReference object
+     * or undefined if no track is available.
+     */
     trackRef: TrackReference | undefined;
+    /**
+     * Custom React Native styles for the video container.
+     */
     style?: ViewStyle;
+    /**
+     * Specifies how the video content should be resized to fit its container.
+     * 'cover' (default): The video will fill the entire container, potentially cropping the video.
+     * 'contain': The entire video will be visible within the container, potentially leaving empty space.
+     */
     objectFit?: 'cover' | 'contain' | undefined;
+    /**
+     * Indicates whether the video should be mirrored during rendering.
+     * This is commonly used for front-facing cameras.
+     */
     mirror?: boolean;
+    /**
+     * Specifies the depth-stacking order of this video view in the stacking space of all video views.
+     * A larger zOrder value generally causes the view to cover those with lower values.
+     *
+     * The support for zOrder is platform-dependent and/or
+     * implementation-specific. Thus, specifying a value for zOrder is to be
+     * thought of as giving a hint rather than as imposing a requirement. For
+     * example, video renderers such as RTCView are commonly implemented using
+     * OpenGL and OpenGL views may have different numbers of layers in their
+     * stacking space. Android has three: a layer bellow the window (aka
+     * default), a layer bellow the window again but above the previous layer
+     * (aka media overlay), and above the window. Consequently, it is advisable
+     * to limit the number of utilized layers in the stacking space to the
+     * minimum sufficient for the desired display. For example, a video call
+     * application usually needs a maximum of two zOrder values: 0 for the
+     * remote video(s) which appear in the background, and 1 for the local
+     * video(s) which appear above the remote video(s).
+     */
     zOrder?: number;
 };
+/**
+ * VideoTrack component for displaying video tracks in a React Native application.
+ * It supports both local and remote video tracks from LiveKit, and handles adaptive streaming for remote tracks.
+ *
+ * @param props - See VideoTrackProps for details.
+ * @returns A React component that renders the given video track.
+ * @public
+ */
 export declare const VideoTrack: ({ style, trackRef, objectFit, zOrder, mirror, }: VideoTrackProps) => React.JSX.Element;

package/lib/typescript/src/e2ee/RNE2EEManager.d.ts

@@ -0,0 +1,27 @@
+import { type Room, type BaseE2EEManager, type E2EEManagerCallbacks } from 'livekit-client';
+import type RNKeyProvider from './RNKeyProvider';
+import type RTCEngine from 'livekit-client/dist/src/room/RTCEngine';
+import type TypedEventEmitter from 'typed-emitter';
+declare const RNE2EEManager_base: new () => TypedEventEmitter<E2EEManagerCallbacks>;
+/**
+ * @experimental
+ */
+export default class RNE2EEManager extends RNE2EEManager_base implements BaseE2EEManager {
+    private room?;
+    private frameCryptors;
+    private keyProvider;
+    private algorithm;
+    private encryptionEnabled;
+    constructor(keyProvider: RNKeyProvider);
+    setup(room: Room): void;
+    private setupEventListeners;
+    private setupE2EESender;
+    private setupE2EEReceiver;
+    setSifTrailer(trailer: Uint8Array): void;
+    private findTrackCryptor;
+    private createFrameCryptorForSender;
+    private createFrameCryptorForReceiver;
+    setupEngine(_engine: RTCEngine): void;
+    setParticipantCryptorEnabled(enabled: boolean, participantIdentity: string): void;
+}
+export {};

package/lib/typescript/src/e2ee/RNKeyProvider.d.ts

@@ -0,0 +1,35 @@
+import { BaseKeyProvider, type KeyProviderOptions } from 'livekit-client';
+import { RTCKeyProvider } from '@livekit/react-native-webrtc';
+/**
+ * Options for construction an RNKeyProvider
+ */
+export type RNKeyProviderOptions = KeyProviderOptions & {
+    uncryptedMagicBytes?: string | Uint8Array;
+};
+/**
+ * @experimental
+ */
+export default class RNKeyProvider extends BaseKeyProvider {
+    private latestSetIndex;
+    private nativeKeyProvider;
+    constructor(options: Partial<RNKeyProviderOptions>);
+    getLatestKeyIndex(participantId: string): number;
+    /**
+     * Accepts a passphrase that's used to create the crypto keys.
+     * @param key
+     */
+    setSharedKey(key: string | Uint8Array, keyIndex?: number): Promise<any>;
+    ratchetSharedKey(keyIndex?: number): Promise<void>;
+    /**
+     * Accepts a passphrase that's used to create the crypto keys for a participant's stream.
+     * @param key
+     */
+    setKey(participantId: string, key: string | Uint8Array, keyIndex?: number): Promise<any>;
+    ratchetKey(participantIdentity?: string, keyIndex?: number): Promise<void>;
+    setSifTrailer(trailer: Uint8Array): Promise<any>;
+    /**
+     * @internal
+     */
+    get rtcKeyProvider(): RTCKeyProvider;
+    dispose(): void;
+}

package/lib/typescript/src/hooks/useE2EEManager.d.ts

@@ -0,0 +1,15 @@
+import RNE2EEManager from '../e2ee/RNE2EEManager';
+import { RNKeyProvider } from '..';
+import type { RNKeyProviderOptions } from '../e2ee/RNKeyProvider';
+export type UseRNE2EEManagerOptions = {
+    keyProviderOptions?: RNKeyProviderOptions;
+    sharedKey: string | Uint8Array;
+};
+export interface RNE2EEManagerState {
+    keyProvider: RNKeyProvider;
+    e2eeManager: RNE2EEManager;
+}
+/**
+ * @experimental
+ */
+export declare function useRNE2EEManager(options: UseRNE2EEManagerOptions): RNE2EEManagerState;

package/lib/typescript/src/hooks.d.ts

@@ -1,3 +1,5 @@
 export { useConnectionState, useDataChannel, useIsSpeaking, useLocalParticipant, useLocalParticipantPermissions, useParticipantInfo, useParticipants, useRemoteParticipants, useRemoteParticipant, useSpeakingParticipants, useSortedParticipants, useChat, useIsEncrypted, useRoomInfo, useIsMuted, useParticipantTracks, useLiveKitRoom, RoomContext, useRoomContext, ParticipantContext, useParticipantContext, TrackRefContext, useTrackRefContext, useTracks, isTrackReference, useEnsureTrackRef, useTrackMutedIndicator, useVisualStableUpdate, } from '@livekit/components-react';
 export type { UseLocalParticipantOptions, UseParticipantInfoOptions, UseParticipantsOptions, UseRemoteParticipantOptions, UseRemoteParticipantsOptions, UseTracksOptions, TrackReference, TrackReferenceOrPlaceholder, UseVisualStableUpdateOptions, } from '@livekit/components-react';
 export type { ReceivedDataMessage } from '@livekit/components-core';
+export * from './hooks/useE2EEManager';
+export type { UseRNE2EEManagerOptions } from './hooks/useE2EEManager';

package/lib/typescript/src/index.d.ts

@@ -2,6 +2,8 @@ import './polyfills/EncoderDecoderTogether.min.js';
 import AudioSession, { AndroidAudioTypePresets, type AndroidAudioTypeOptions, type AppleAudioCategory, type AppleAudioCategoryOption, type AppleAudioConfiguration, type AppleAudioMode, type AudioTrackState, getDefaultAppleAudioConfigurationForMode } from './audio/AudioSession';
 import type { AudioConfiguration } from './audio/AudioSession';
 import type { LogLevel, SetLogLevelOptions } from './logger';
+import RNE2EEManager from './e2ee/RNE2EEManager';
+import RNKeyProvider, { type RNKeyProviderOptions } from './e2ee/RNKeyProvider';
 /**
  * Registers the required globals needed for LiveKit to work.
  *
@@ -16,5 +18,5 @@ export * from './useParticipant';
 export * from './useRoom';
 export * from './logger';
 export * from './audio/AudioManager';
-export { AudioSession, AndroidAudioTypePresets, getDefaultAppleAudioConfigurationForMode, };
-export type { AudioConfiguration, AndroidAudioTypeOptions, AppleAudioCategory, AppleAudioCategoryOption, AppleAudioConfiguration, AppleAudioMode, AudioTrackState, LogLevel, SetLogLevelOptions, };
+export { AudioSession, RNE2EEManager, RNKeyProvider, AndroidAudioTypePresets, getDefaultAppleAudioConfigurationForMode, };
+export type { AudioConfiguration, AndroidAudioTypeOptions, AppleAudioCategory, AppleAudioCategoryOption, AppleAudioConfiguration, AppleAudioMode, AudioTrackState, LogLevel, SetLogLevelOptions, RNKeyProviderOptions, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livekit/react-native",
-  "version": "2.4.2",
+  "version": "2.5.0",
   "description": "LiveKit for React Native",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -44,7 +44,8 @@
   "dependencies": {
     "@livekit/components-react": "^2.0.6",
     "array.prototype.at": "^1.1.1",
-    "livekit-client": "^2.4.2",
+    "event-target-shim": "6.0.2",
+    "livekit-client": "^2.7.5",
     "loglevel": "^1.8.0",
     "promise.allsettled": "^1.0.5",
     "react-native-url-polyfill": "^1.3.0",
@@ -55,7 +56,7 @@
     "@babel/preset-env": "^7.20.0",
     "@babel/runtime": "^7.20.0",
     "@commitlint/config-conventional": "^16.2.1",
-    "@livekit/react-native-webrtc": "^125.0.4",
+    "@livekit/react-native-webrtc": "^125.0.6",
     "@react-native/babel-preset": "0.74.84",
     "@react-native/eslint-config": "0.74.84",
     "@react-native/metro-config": "0.74.84",
@@ -81,7 +82,7 @@
     "typescript": "5.0.4"
   },
   "peerDependencies": {
-    "@livekit/react-native-webrtc": "^125.0.4",
+    "@livekit/react-native-webrtc": "^125.0.6",
     "react": "*",
     "react-native": "*"
   },

package/src/audio/AudioManager.ts

@@ -1,6 +1,11 @@
 import { useState, useEffect, useMemo } from 'react';
 import { Platform } from 'react-native';
-import { RoomEvent, Room } from 'livekit-client';
+import {
+  RoomEvent,
+  Room,
+  type LocalTrackPublication,
+  type RemoteTrackPublication,
+} from 'livekit-client';
 import AudioSession, {
   getDefaultAppleAudioConfigurationForMode,
   type AppleAudioConfiguration,
@@ -50,27 +55,35 @@ export function useIOSAudioManagement(
       return () => {};
     }
 
-    let onLocalPublished = () => {
-      setLocalTrackCount(localTrackCount + 1);
+    let onLocalPublished = (publication: LocalTrackPublication) => {
+      if (publication.kind === 'audio') {
+        setLocalTrackCount(localTrackCount + 1);
+      }
     };
-    let onLocalUnpublished = () => {
-      if (localTrackCount - 1 < 0) {
-        log.warn(
-          'mismatched local audio track count! attempted to reduce track count below zero.'
-        );
+    let onLocalUnpublished = (publication: LocalTrackPublication) => {
+      if (publication.kind === 'audio') {
+        if (localTrackCount - 1 < 0) {
+          log.warn(
+            'mismatched local audio track count! attempted to reduce track count below zero.'
+          );
+        }
+        setLocalTrackCount(Math.max(localTrackCount - 1, 0));
       }
-      setLocalTrackCount(Math.max(localTrackCount - 1, 0));
     };
-    let onRemotePublished = () => {
-      setRemoteTrackCount(remoteTrackCount + 1);
+    let onRemotePublished = (publication: RemoteTrackPublication) => {
+      if (publication.kind === 'audio') {
+        setRemoteTrackCount(remoteTrackCount + 1);
+      }
     };
-    let onRemoteUnpublished = () => {
-      if (remoteTrackCount - 1 < 0) {
-        log.warn(
-          'mismatched remote audio track count! attempted to reduce track count below zero.'
-        );
+    let onRemoteUnpublished = (publication: RemoteTrackPublication) => {
+      if (publication.kind === 'audio') {
+        if (remoteTrackCount - 1 < 0) {
+          log.warn(
+            'mismatched remote audio track count! attempted to reduce track count below zero.'
+          );
+        }
+        setRemoteTrackCount(Math.max(remoteTrackCount - 1, 0));
       }
-      setRemoteTrackCount(Math.max(remoteTrackCount - 1, 0));
     };
 
     room
@@ -124,6 +137,5 @@ function getRemoteAudioTrackCount(room: Room): number {
   room.remoteParticipants.forEach((participant) => {
     audioTracks += participant.audioTrackPublications.size;
   });
-
   return audioTracks;
 }

package/src/components/VideoTrack.tsx

@@ -18,14 +18,60 @@ import { RemoteVideoTrack } from 'livekit-client';
 import ViewPortDetector from './ViewPortDetector';
 import type { TrackReference } from '@livekit/components-react';
 
+/**
+ * Props for the VideoTrack component.
+ * @public
+ */
 export type VideoTrackProps = {
+  /**
+   * The track reference to display. This should be a TrackReference object
+   * or undefined if no track is available.
+   */
   trackRef: TrackReference | undefined;
+  /**
+   * Custom React Native styles for the video container.
+   */
   style?: ViewStyle;
+  /**
+   * Specifies how the video content should be resized to fit its container.
+   * 'cover' (default): The video will fill the entire container, potentially cropping the video.
+   * 'contain': The entire video will be visible within the container, potentially leaving empty space.
+   */
   objectFit?: 'cover' | 'contain' | undefined;
+  /**
+   * Indicates whether the video should be mirrored during rendering.
+   * This is commonly used for front-facing cameras.
+   */
   mirror?: boolean;
+  /**
+   * Specifies the depth-stacking order of this video view in the stacking space of all video views.
+   * A larger zOrder value generally causes the view to cover those with lower values.
+   *
+   * The support for zOrder is platform-dependent and/or
+   * implementation-specific. Thus, specifying a value for zOrder is to be
+   * thought of as giving a hint rather than as imposing a requirement. For
+   * example, video renderers such as RTCView are commonly implemented using
+   * OpenGL and OpenGL views may have different numbers of layers in their
+   * stacking space. Android has three: a layer bellow the window (aka
+   * default), a layer bellow the window again but above the previous layer
+   * (aka media overlay), and above the window. Consequently, it is advisable
+   * to limit the number of utilized layers in the stacking space to the
+   * minimum sufficient for the desired display. For example, a video call
+   * application usually needs a maximum of two zOrder values: 0 for the
+   * remote video(s) which appear in the background, and 1 for the local
+   * video(s) which appear above the remote video(s).
+   */
   zOrder?: number;
 };
 
+/**
+ * VideoTrack component for displaying video tracks in a React Native application.
+ * It supports both local and remote video tracks from LiveKit, and handles adaptive streaming for remote tracks.
+ *
+ * @param props - See VideoTrackProps for details.
+ * @returns A React component that renders the given video track.
+ * @public
+ */
 export const VideoTrack = ({
   style = {},
   trackRef,
@@ -130,6 +176,7 @@ class VideoTrackElementInfo implements ElementInfo {
   observe(): void {
     this._observing = true;
   }
+
   stopObserving(): void {
     this._observing = false;
   }
@@ -143,6 +190,7 @@ class VideoTrackElementInfo implements ElementInfo {
       this.handleResize?.();
     }
   }
+
   onVisibility(isVisible: boolean) {
     if (this.visible !== isVisible) {
       this.visible = isVisible;