livekit-client 2.22.4 → 2.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +48 -32
- package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs +48 -0
- package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs.map +1 -0
- package/dist/core/api/SignalClient.mjs +1212 -0
- package/dist/core/api/SignalClient.mjs.map +1 -0
- package/dist/core/api/SignalClientStateMachine.mjs +115 -0
- package/dist/core/api/SignalClientStateMachine.mjs.map +1 -0
- package/dist/core/api/WebSocketStream.mjs +146 -0
- package/dist/core/api/WebSocketStream.mjs.map +1 -0
- package/dist/core/api/utils.mjs +66 -0
- package/dist/core/api/utils.mjs.map +1 -0
- package/dist/core/connectionHelper/ConnectionCheck.mjs +89 -0
- package/dist/core/connectionHelper/ConnectionCheck.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/Checker.mjs +146 -0
- package/dist/core/connectionHelper/checks/Checker.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/cloudRegion.mjs +82 -0
- package/dist/core/connectionHelper/checks/cloudRegion.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/connectionProtocol.mjs +111 -0
- package/dist/core/connectionHelper/checks/connectionProtocol.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/publishAudio.mjs +35 -0
- package/dist/core/connectionHelper/checks/publishAudio.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/publishVideo.mjs +82 -0
- package/dist/core/connectionHelper/checks/publishVideo.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/reconnect.mjs +37 -0
- package/dist/core/connectionHelper/checks/reconnect.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/turn.mjs +56 -0
- package/dist/core/connectionHelper/checks/turn.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/webrtc.mjs +73 -0
- package/dist/core/connectionHelper/checks/webrtc.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/websocket.mjs +47 -0
- package/dist/core/connectionHelper/checks/websocket.mjs.map +1 -0
- package/dist/core/core.mjs +1 -0
- package/dist/core/core.mjs.map +1 -0
- package/dist/core/e2ee/E2eeManager.mjs +603 -0
- package/dist/core/e2ee/E2eeManager.mjs.map +1 -0
- package/dist/core/e2ee/KeyProvider.mjs +95 -0
- package/dist/core/e2ee/KeyProvider.mjs.map +1 -0
- package/dist/core/e2ee/constants.mjs +19 -0
- package/dist/core/e2ee/constants.mjs.map +1 -0
- package/dist/core/e2ee/errors.mjs +15 -0
- package/dist/core/e2ee/errors.mjs.map +1 -0
- package/dist/core/e2ee/events.mjs +24 -0
- package/dist/core/e2ee/events.mjs.map +1 -0
- package/dist/core/e2ee/extension.mjs +70 -0
- package/dist/core/e2ee/extension.mjs.map +1 -0
- package/dist/core/e2ee/utils.mjs +168 -0
- package/dist/core/e2ee/utils.mjs.map +1 -0
- package/dist/core/frameMetadata/FrameMetadataManager.mjs +205 -0
- package/dist/core/frameMetadata/FrameMetadataManager.mjs.map +1 -0
- package/dist/core/frameMetadata/extension.mjs +17 -0
- package/dist/core/frameMetadata/extension.mjs.map +1 -0
- package/dist/core/frameMetadata/utils.mjs +42 -0
- package/dist/core/frameMetadata/utils.mjs.map +1 -0
- package/dist/core/logger.mjs +111 -0
- package/dist/core/logger.mjs.map +1 -0
- package/dist/core/package.json.mjs +1 -0
- package/dist/core/package.json.mjs.map +1 -0
- package/dist/core/room/BackOffStrategy.mjs +60 -0
- package/dist/core/room/BackOffStrategy.mjs.map +1 -0
- package/dist/core/room/CoreRoom.mjs +2279 -0
- package/dist/core/room/CoreRoom.mjs.map +1 -0
- package/dist/core/room/DefaultReconnectPolicy.mjs +23 -0
- package/dist/core/room/DefaultReconnectPolicy.mjs.map +1 -0
- package/dist/core/room/DeviceManager.mjs +92 -0
- package/dist/core/room/DeviceManager.mjs.map +1 -0
- package/dist/core/room/PCTransport.mjs +1110 -0
- package/dist/core/room/PCTransport.mjs.map +1 -0
- package/dist/core/room/PCTransportManager.mjs +360 -0
- package/dist/core/room/PCTransportManager.mjs.map +1 -0
- package/dist/core/room/RTCEngine.mjs +1830 -0
- package/dist/core/room/RTCEngine.mjs.map +1 -0
- package/dist/core/room/RegionUrlProvider.mjs +194 -0
- package/dist/core/room/RegionUrlProvider.mjs.map +1 -0
- package/dist/core/room/attribute-typings.mjs +24 -0
- package/dist/core/room/attribute-typings.mjs.map +1 -0
- package/dist/core/room/createRoom.mjs +19 -0
- package/dist/core/room/createRoom.mjs.map +1 -0
- package/dist/core/room/data-channel/DataChannelManager.mjs +188 -0
- package/dist/core/room/data-channel/DataChannelManager.mjs.map +1 -0
- package/dist/core/room/data-channel/FlowControlledDataChannel.mjs +185 -0
- package/dist/core/room/data-channel/FlowControlledDataChannel.mjs.map +1 -0
- package/dist/core/room/data-channel/LossyDataChannel.mjs +99 -0
- package/dist/core/room/data-channel/LossyDataChannel.mjs.map +1 -0
- package/dist/core/room/data-channel/ReliableDataChannel.mjs +150 -0
- package/dist/core/room/data-channel/ReliableDataChannel.mjs.map +1 -0
- package/dist/core/room/data-channel/types.mjs +22 -0
- package/dist/core/room/data-channel/types.mjs.map +1 -0
- package/dist/core/room/data-stream/compression.mjs +68 -0
- package/dist/core/room/data-stream/compression.mjs.map +1 -0
- package/dist/core/room/data-stream/constants.mjs +26 -0
- package/dist/core/room/data-stream/constants.mjs.map +1 -0
- package/dist/core/room/data-stream/extension.mjs +42 -0
- package/dist/core/room/data-stream/extension.mjs.map +1 -0
- package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs +500 -0
- package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs.map +1 -0
- package/dist/core/room/data-stream/incoming/StreamReader.mjs +279 -0
- package/dist/core/room/data-stream/incoming/StreamReader.mjs.map +1 -0
- package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs +543 -0
- package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs.map +1 -0
- package/dist/core/room/data-stream/outgoing/StreamWriter.mjs +21 -0
- package/dist/core/room/data-stream/outgoing/StreamWriter.mjs.map +1 -0
- package/dist/core/room/data-stream/outgoing/header-utils.mjs +53 -0
- package/dist/core/room/data-stream/outgoing/header-utils.mjs.map +1 -0
- package/dist/core/room/data-track/LocalDataTrack.mjs +146 -0
- package/dist/core/room/data-track/LocalDataTrack.mjs.map +1 -0
- package/dist/core/room/data-track/RemoteDataTrack.mjs +51 -0
- package/dist/core/room/data-track/RemoteDataTrack.mjs.map +1 -0
- package/dist/core/room/data-track/depacketizer.mjs +193 -0
- package/dist/core/room/data-track/depacketizer.mjs.map +1 -0
- package/dist/core/room/data-track/extension.mjs +154 -0
- package/dist/core/room/data-track/extension.mjs.map +1 -0
- package/dist/core/room/data-track/frame.mjs +19 -0
- package/dist/core/room/data-track/frame.mjs.map +1 -0
- package/dist/core/room/data-track/handle.mjs +50 -0
- package/dist/core/room/data-track/handle.mjs.map +1 -0
- package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs +618 -0
- package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs.map +1 -0
- package/dist/core/room/data-track/incoming/errors.mjs +32 -0
- package/dist/core/room/data-track/incoming/errors.mjs.map +1 -0
- package/dist/core/room/data-track/incoming/pipeline.mjs +85 -0
- package/dist/core/room/data-track/incoming/pipeline.mjs.map +1 -0
- package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs +351 -0
- package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs.map +1 -0
- package/dist/core/room/data-track/outgoing/errors.mjs +114 -0
- package/dist/core/room/data-track/outgoing/errors.mjs.map +1 -0
- package/dist/core/room/data-track/outgoing/pipeline.mjs +41 -0
- package/dist/core/room/data-track/outgoing/pipeline.mjs.map +1 -0
- package/dist/core/room/data-track/packet/constants.mjs +21 -0
- package/dist/core/room/data-track/packet/constants.mjs.map +1 -0
- package/dist/core/room/data-track/packet/errors.mjs +56 -0
- package/dist/core/room/data-track/packet/errors.mjs.map +1 -0
- package/dist/core/room/data-track/packet/extensions.mjs +172 -0
- package/dist/core/room/data-track/packet/extensions.mjs.map +1 -0
- package/dist/core/room/data-track/packet/index.mjs +242 -0
- package/dist/core/room/data-track/packet/index.mjs.map +1 -0
- package/dist/core/room/data-track/packet/serializable.mjs +15 -0
- package/dist/core/room/data-track/packet/serializable.mjs.map +1 -0
- package/dist/core/room/data-track/packetizer.mjs +77 -0
- package/dist/core/room/data-track/packetizer.mjs.map +1 -0
- package/dist/core/room/data-track/track-interfaces.mjs +2 -0
- package/dist/core/room/data-track/track-interfaces.mjs.map +1 -0
- package/dist/core/room/data-track/types.mjs +18 -0
- package/dist/core/room/data-track/types.mjs.map +1 -0
- package/dist/core/room/data-track/utils.mjs +149 -0
- package/dist/core/room/data-track/utils.mjs.map +1 -0
- package/dist/core/room/debounce.mjs +97 -0
- package/dist/core/room/debounce.mjs.map +1 -0
- package/dist/core/room/defaults.mjs +34 -0
- package/dist/core/room/defaults.mjs.map +1 -0
- package/dist/core/room/errors.mjs +208 -0
- package/dist/core/room/errors.mjs.map +1 -0
- package/dist/core/room/events.mjs +643 -0
- package/dist/core/room/events.mjs.map +1 -0
- package/dist/core/room/extensions.mjs +48 -0
- package/dist/core/room/extensions.mjs.map +1 -0
- package/dist/core/room/participant/LocalParticipant.mjs +1324 -0
- package/dist/core/room/participant/LocalParticipant.mjs.map +1 -0
- package/dist/core/room/participant/Participant.mjs +300 -0
- package/dist/core/room/participant/Participant.mjs.map +1 -0
- package/dist/core/room/participant/ParticipantTrackPermission.mjs +12 -0
- package/dist/core/room/participant/ParticipantTrackPermission.mjs.map +1 -0
- package/dist/core/room/participant/RemoteParticipant.mjs +287 -0
- package/dist/core/room/participant/RemoteParticipant.mjs.map +1 -0
- package/dist/core/room/participant/publishUtils.mjs +356 -0
- package/dist/core/room/participant/publishUtils.mjs.map +1 -0
- package/dist/core/room/rpc/client/RpcClientManager.mjs +216 -0
- package/dist/core/room/rpc/client/RpcClientManager.mjs.map +1 -0
- package/dist/core/room/rpc/extension.mjs +82 -0
- package/dist/core/room/rpc/extension.mjs.map +1 -0
- package/dist/core/room/rpc/server/RpcServerManager.mjs +186 -0
- package/dist/core/room/rpc/server/RpcServerManager.mjs.map +1 -0
- package/dist/core/room/rpc/utils.mjs +148 -0
- package/dist/core/room/rpc/utils.mjs.map +1 -0
- package/dist/core/room/simulated-participants/extension.mjs +105 -0
- package/dist/core/room/simulated-participants/extension.mjs.map +1 -0
- package/dist/core/room/stats.mjs +19 -0
- package/dist/core/room/stats.mjs.map +1 -0
- package/dist/core/room/statsSummary.mjs +165 -0
- package/dist/core/room/statsSummary.mjs.map +1 -0
- package/dist/core/room/timers.mjs +20 -0
- package/dist/core/room/timers.mjs.map +1 -0
- package/dist/core/room/token-source/TokenSource.mjs +230 -0
- package/dist/core/room/token-source/TokenSource.mjs.map +1 -0
- package/dist/core/room/token-source/types.mjs +18 -0
- package/dist/core/room/token-source/types.mjs.map +1 -0
- package/dist/core/room/token-source/utils.mjs +76 -0
- package/dist/core/room/token-source/utils.mjs.map +1 -0
- package/dist/core/room/track/FrameMetadataExtractor.mjs +36 -0
- package/dist/core/room/track/FrameMetadataExtractor.mjs.map +1 -0
- package/dist/core/room/track/LocalAudioTrack.mjs +327 -0
- package/dist/core/room/track/LocalAudioTrack.mjs.map +1 -0
- package/dist/core/room/track/LocalTrack.mjs +694 -0
- package/dist/core/room/track/LocalTrack.mjs.map +1 -0
- package/dist/core/room/track/LocalTrackPublication.mjs +111 -0
- package/dist/core/room/track/LocalTrackPublication.mjs.map +1 -0
- package/dist/core/room/track/LocalVideoTrack.mjs +810 -0
- package/dist/core/room/track/LocalVideoTrack.mjs.map +1 -0
- package/dist/core/room/track/RemoteAudioTrack.mjs +245 -0
- package/dist/core/room/track/RemoteAudioTrack.mjs.map +1 -0
- package/dist/core/room/track/RemoteTrack.mjs +143 -0
- package/dist/core/room/track/RemoteTrack.mjs.map +1 -0
- package/dist/core/room/track/RemoteTrackPublication.mjs +284 -0
- package/dist/core/room/track/RemoteTrackPublication.mjs.map +1 -0
- package/dist/core/room/track/RemoteVideoTrack.mjs +384 -0
- package/dist/core/room/track/RemoteVideoTrack.mjs.map +1 -0
- package/dist/core/room/track/Track.mjs +413 -0
- package/dist/core/room/track/Track.mjs.map +1 -0
- package/dist/core/room/track/TrackPublication.mjs +97 -0
- package/dist/core/room/track/TrackPublication.mjs.map +1 -0
- package/dist/core/room/track/create.mjs +142 -0
- package/dist/core/room/track/create.mjs.map +1 -0
- package/dist/core/room/track/facingMode.mjs +81 -0
- package/dist/core/room/track/facingMode.mjs.map +1 -0
- package/dist/core/room/track/options.mjs +109 -0
- package/dist/core/room/track/options.mjs.map +1 -0
- package/dist/core/room/track/record.mjs +67 -0
- package/dist/core/room/track/record.mjs.map +1 -0
- package/dist/core/room/track/utils.mjs +429 -0
- package/dist/core/room/track/utils.mjs.map +1 -0
- package/dist/core/room/utils.mjs +852 -0
- package/dist/core/room/utils.mjs.map +1 -0
- package/dist/core/room/video/create.mjs +71 -0
- package/dist/core/room/video/create.mjs.map +1 -0
- package/dist/core/room/video/extension.mjs +27 -0
- package/dist/core/room/video/extension.mjs.map +1 -0
- package/dist/core/room/video/publisher.mjs +343 -0
- package/dist/core/room/video/publisher.mjs.map +1 -0
- package/dist/core/ts4.2/api/SignalClient.d.ts +19 -0
- package/dist/core/ts4.2/api/SignalClientStateMachine.d.ts +84 -0
- package/dist/core/ts4.2/api/WebSocketStream.d.ts +33 -0
- package/dist/core/ts4.2/api/utils.d.ts +8 -0
- package/dist/core/ts4.2/connectionHelper/ConnectionCheck.d.ts +29 -0
- package/dist/core/ts4.2/connectionHelper/checks/Checker.d.ts +64 -0
- package/dist/core/ts4.2/connectionHelper/checks/cloudRegion.d.ts +17 -0
- package/dist/core/ts4.2/connectionHelper/checks/connectionProtocol.d.ts +19 -0
- package/dist/core/ts4.2/connectionHelper/checks/publishAudio.d.ts +5 -0
- package/dist/core/ts4.2/connectionHelper/checks/publishVideo.d.ts +6 -0
- package/dist/core/ts4.2/connectionHelper/checks/reconnect.d.ts +5 -0
- package/dist/core/ts4.2/connectionHelper/checks/turn.d.ts +5 -0
- package/dist/core/ts4.2/connectionHelper/checks/webrtc.d.ts +5 -0
- package/dist/core/ts4.2/connectionHelper/checks/websocket.d.ts +5 -0
- package/dist/core/ts4.2/core.d.ts +33 -0
- package/dist/core/ts4.2/e2ee/E2eeManager.d.ts +89 -0
- package/dist/core/ts4.2/e2ee/KeyProvider.d.ts +53 -0
- package/dist/core/ts4.2/e2ee/constants.d.ts +20 -0
- package/dist/core/ts4.2/e2ee/errors.d.ts +11 -0
- package/dist/core/ts4.2/e2ee/events.d.ts +38 -0
- package/dist/core/ts4.2/e2ee/extension.d.ts +19 -0
- package/dist/core/ts4.2/e2ee/index.d.ts +5 -0
- package/dist/core/ts4.2/e2ee/types.d.ts +244 -0
- package/dist/core/ts4.2/e2ee/utils.d.ts +36 -0
- package/dist/core/ts4.2/exports.d.ts +82 -0
- package/dist/core/ts4.2/frameMetadata/FrameMetadataManager.d.ts +52 -0
- package/dist/core/ts4.2/frameMetadata/extension.d.ts +12 -0
- package/dist/core/ts4.2/frameMetadata/frameMetadata.d.ts +32 -0
- package/dist/core/ts4.2/frameMetadata/types.d.ts +61 -0
- package/dist/core/ts4.2/frameMetadata/utils.d.ts +13 -0
- package/dist/core/ts4.2/logger.d.ts +59 -0
- package/dist/core/ts4.2/options.d.ts +171 -0
- package/dist/core/ts4.2/room/BackOffStrategy.d.ts +26 -0
- package/dist/core/ts4.2/room/CoreRoom.d.ts +363 -0
- package/dist/core/ts4.2/room/DefaultReconnectPolicy.d.ts +7 -0
- package/dist/core/ts4.2/room/DeviceManager.d.ts +11 -0
- package/dist/core/ts4.2/room/PCTransport.d.ts +132 -0
- package/dist/core/ts4.2/room/PCTransportManager.d.ts +80 -0
- package/dist/core/ts4.2/room/RTCEngine.d.ts +233 -0
- package/dist/core/ts4.2/room/ReconnectPolicy.d.ts +23 -0
- package/dist/core/ts4.2/room/RegionUrlProvider.d.ts +33 -0
- package/dist/core/ts4.2/room/attribute-typings.d.ts +34 -0
- package/dist/core/ts4.2/room/chat/extension.d.ts +21 -0
- package/dist/core/ts4.2/room/createRoom.d.ts +19 -0
- package/dist/core/ts4.2/room/data-channel/DataChannelManager.d.ts +67 -0
- package/dist/core/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +106 -0
- package/dist/core/ts4.2/room/data-channel/LossyDataChannel.d.ts +40 -0
- package/dist/core/ts4.2/room/data-channel/ReliableDataChannel.d.ts +56 -0
- package/dist/core/ts4.2/room/data-channel/types.d.ts +11 -0
- package/dist/core/ts4.2/room/data-stream/compression.d.ts +29 -0
- package/dist/core/ts4.2/room/data-stream/constants.d.ts +1 -0
- package/dist/core/ts4.2/room/data-stream/extension.d.ts +63 -0
- package/dist/core/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +33 -0
- package/dist/core/ts4.2/room/data-stream/incoming/StreamReader.d.ts +77 -0
- package/dist/core/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
- package/dist/core/ts4.2/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
- package/dist/core/ts4.2/room/data-stream/outgoing/header-utils.d.ts +17 -0
- package/dist/core/ts4.2/room/data-track/LocalDataTrack.d.ts +69 -0
- package/dist/core/ts4.2/room/data-track/RemoteDataTrack.d.ts +43 -0
- package/dist/core/ts4.2/room/data-track/depacketizer.d.ts +58 -0
- package/dist/core/ts4.2/room/data-track/extension.d.ts +30 -0
- package/dist/core/ts4.2/room/data-track/frame.d.ts +21 -0
- package/dist/core/ts4.2/room/data-track/handle.d.ts +26 -0
- package/dist/core/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
- package/dist/core/ts4.2/room/data-track/incoming/errors.d.ts +23 -0
- package/dist/core/ts4.2/room/data-track/incoming/pipeline.d.ts +40 -0
- package/dist/core/ts4.2/room/data-track/incoming/types.d.ts +19 -0
- package/dist/core/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
- package/dist/core/ts4.2/room/data-track/outgoing/errors.d.ts +73 -0
- package/dist/core/ts4.2/room/data-track/outgoing/pipeline.d.ts +22 -0
- package/dist/core/ts4.2/room/data-track/outgoing/types.d.ts +47 -0
- package/dist/core/ts4.2/room/data-track/packet/constants.d.ts +19 -0
- package/dist/core/ts4.2/room/data-track/packet/errors.d.ts +39 -0
- package/dist/core/ts4.2/room/data-track/packet/extensions.d.ts +68 -0
- package/dist/core/ts4.2/room/data-track/packet/index.d.ts +97 -0
- package/dist/core/ts4.2/room/data-track/packet/serializable.d.ts +12 -0
- package/dist/core/ts4.2/room/data-track/packetizer.d.ts +40 -0
- package/dist/core/ts4.2/room/data-track/track-interfaces.d.ts +22 -0
- package/dist/core/ts4.2/room/data-track/types.d.ts +21 -0
- package/dist/core/ts4.2/room/data-track/utils.d.ts +59 -0
- package/dist/core/ts4.2/room/debounce.d.ts +10 -0
- package/dist/core/ts4.2/room/defaults.d.ts +7 -0
- package/dist/core/ts4.2/room/errors.d.ts +179 -0
- package/dist/core/ts4.2/room/events.d.ts +534 -0
- package/dist/core/ts4.2/room/extensions.d.ts +206 -0
- package/dist/core/ts4.2/room/participant/LocalParticipant.d.ts +164 -0
- package/dist/core/ts4.2/room/participant/Participant.d.ts +122 -0
- package/dist/core/ts4.2/room/participant/ParticipantTrackPermission.d.ts +25 -0
- package/dist/core/ts4.2/room/participant/RemoteParticipant.d.ts +37 -0
- package/dist/core/ts4.2/room/participant/publishUtils.d.ts +11 -0
- package/dist/core/ts4.2/room/rpc/client/RpcClientManager.d.ts +1 -0
- package/dist/core/ts4.2/room/rpc/client/events.d.ts +7 -0
- package/dist/core/ts4.2/room/rpc/extension.d.ts +73 -0
- package/dist/core/ts4.2/room/rpc/index.d.ts +6 -0
- package/dist/core/ts4.2/room/rpc/server/RpcServerManager.d.ts +1 -0
- package/dist/core/ts4.2/room/rpc/server/events.d.ts +7 -0
- package/dist/core/ts4.2/room/rpc/utils.d.ts +76 -0
- package/dist/core/ts4.2/room/simulated-participants/extension.d.ts +24 -0
- package/dist/core/ts4.2/room/stats.d.ts +70 -0
- package/dist/core/ts4.2/room/statsSummary.d.ts +12 -0
- package/dist/core/ts4.2/room/timers.d.ts +11 -0
- package/dist/core/ts4.2/room/token-source/TokenSource.d.ts +85 -0
- package/dist/core/ts4.2/room/token-source/types.d.ts +69 -0
- package/dist/core/ts4.2/room/token-source/utils.d.ts +7 -0
- package/dist/core/ts4.2/room/track/FrameMetadataExtractor.d.ts +18 -0
- package/dist/core/ts4.2/room/track/LocalAudioTrack.d.ts +50 -0
- package/dist/core/ts4.2/room/track/LocalTrack.d.ts +118 -0
- package/dist/core/ts4.2/room/track/LocalTrackPublication.d.ts +41 -0
- package/dist/core/ts4.2/room/track/LocalVideoTrack.d.ts +91 -0
- package/dist/core/ts4.2/room/track/RemoteAudioTrack.d.ts +49 -0
- package/dist/core/ts4.2/room/track/RemoteTrack.d.ts +29 -0
- package/dist/core/ts4.2/room/track/RemoteTrackPublication.d.ts +62 -0
- package/dist/core/ts4.2/room/track/RemoteVideoTrack.d.ts +53 -0
- package/dist/core/ts4.2/room/track/Track.d.ts +129 -0
- package/dist/core/ts4.2/room/track/TrackPublication.d.ts +68 -0
- package/dist/core/ts4.2/room/track/create.d.ts +12 -0
- package/dist/core/ts4.2/room/track/facingMode.d.ts +40 -0
- package/dist/core/ts4.2/room/track/options.d.ts +396 -0
- package/dist/core/ts4.2/room/track/processor/types.d.ts +41 -0
- package/dist/core/ts4.2/room/track/record.d.ts +12 -0
- package/dist/core/ts4.2/room/track/types.d.ts +27 -0
- package/dist/core/ts4.2/room/track/utils.d.ts +20 -0
- package/dist/core/ts4.2/room/types.d.ts +126 -0
- package/dist/core/ts4.2/room/utils.d.ts +246 -0
- package/dist/core/ts4.2/room/video/create.d.ts +27 -0
- package/dist/core/ts4.2/room/video/extension.d.ts +43 -0
- package/dist/core/ts4.2/room/video/publisher.d.ts +23 -0
- package/dist/core/ts4.2/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
- package/dist/core/ts4.2/utils/AsyncQueue.d.ts +22 -0
- package/dist/core/ts4.2/utils/TypedPromise.d.ts +16 -0
- package/dist/core/ts4.2/utils/abort-signal-polyfill.d.ts +12 -0
- package/dist/core/ts4.2/utils/browserParser.d.ts +9 -0
- package/dist/core/ts4.2/utils/camelToSnakeCase.d.ts +7 -0
- package/dist/core/ts4.2/utils/cloneDeep.d.ts +1 -0
- package/dist/core/ts4.2/utils/dataPacketBuffer.d.ts +33 -0
- package/dist/core/ts4.2/utils/deferrable-map.d.ts +31 -0
- package/dist/core/ts4.2/utils/machineInspector.d.ts +53 -0
- package/dist/core/ts4.2/utils/serializer.d.ts +47 -0
- package/dist/core/ts4.2/utils/throws.d.ts +9 -0
- package/dist/core/ts4.2/utils/ttlmap.d.ts +19 -0
- package/dist/core/ts4.2/version.d.ts +17 -0
- package/dist/core/types/src/api/SignalClient.d.ts +19 -0
- package/dist/core/types/src/api/SignalClientStateMachine.d.ts +84 -0
- package/dist/core/types/src/api/WebSocketStream.d.ts +33 -0
- package/dist/core/types/src/api/utils.d.ts +8 -0
- package/dist/core/types/src/connectionHelper/ConnectionCheck.d.ts +28 -0
- package/dist/core/types/src/connectionHelper/checks/Checker.d.ts +64 -0
- package/dist/core/types/src/connectionHelper/checks/cloudRegion.d.ts +16 -0
- package/dist/core/types/src/connectionHelper/checks/connectionProtocol.d.ts +18 -0
- package/dist/core/types/src/connectionHelper/checks/publishAudio.d.ts +5 -0
- package/dist/core/types/src/connectionHelper/checks/publishVideo.d.ts +6 -0
- package/dist/core/types/src/connectionHelper/checks/reconnect.d.ts +5 -0
- package/dist/core/types/src/connectionHelper/checks/turn.d.ts +5 -0
- package/dist/core/types/src/connectionHelper/checks/webrtc.d.ts +5 -0
- package/dist/core/types/src/connectionHelper/checks/websocket.d.ts +5 -0
- package/dist/core/types/src/core.d.ts +32 -0
- package/dist/core/types/src/e2ee/E2eeManager.d.ts +89 -0
- package/dist/core/types/src/e2ee/KeyProvider.d.ts +53 -0
- package/dist/core/types/src/e2ee/constants.d.ts +20 -0
- package/dist/core/types/src/e2ee/errors.d.ts +11 -0
- package/dist/core/types/src/e2ee/events.d.ts +38 -0
- package/dist/core/types/src/e2ee/extension.d.ts +18 -0
- package/dist/core/types/src/e2ee/index.d.ts +5 -0
- package/dist/core/types/src/e2ee/types.d.ts +244 -0
- package/dist/core/types/src/e2ee/utils.d.ts +35 -0
- package/dist/core/types/src/exports.d.ts +75 -0
- package/dist/core/types/src/frameMetadata/FrameMetadataManager.d.ts +52 -0
- package/dist/core/types/src/frameMetadata/extension.d.ts +10 -0
- package/dist/core/types/src/frameMetadata/frameMetadata.d.ts +32 -0
- package/dist/core/types/src/frameMetadata/types.d.ts +61 -0
- package/dist/core/types/src/frameMetadata/utils.d.ts +13 -0
- package/dist/core/types/src/logger.d.ts +59 -0
- package/dist/core/types/src/options.d.ts +171 -0
- package/dist/core/types/src/room/BackOffStrategy.d.ts +26 -0
- package/dist/core/types/src/room/CoreRoom.d.ts +374 -0
- package/dist/core/types/src/room/DefaultReconnectPolicy.d.ts +7 -0
- package/dist/core/types/src/room/DeviceManager.d.ts +11 -0
- package/dist/core/types/src/room/PCTransport.d.ts +132 -0
- package/dist/core/types/src/room/PCTransportManager.d.ts +80 -0
- package/dist/core/types/src/room/RTCEngine.d.ts +232 -0
- package/dist/core/types/src/room/ReconnectPolicy.d.ts +23 -0
- package/dist/core/types/src/room/RegionUrlProvider.d.ts +33 -0
- package/dist/core/types/src/room/attribute-typings.d.ts +34 -0
- package/dist/core/types/src/room/chat/extension.d.ts +21 -0
- package/dist/core/types/src/room/createRoom.d.ts +18 -0
- package/dist/core/types/src/room/data-channel/DataChannelManager.d.ts +68 -0
- package/dist/core/types/src/room/data-channel/FlowControlledDataChannel.d.ts +107 -0
- package/dist/core/types/src/room/data-channel/LossyDataChannel.d.ts +39 -0
- package/dist/core/types/src/room/data-channel/ReliableDataChannel.d.ts +55 -0
- package/dist/core/types/src/room/data-channel/types.d.ts +11 -0
- package/dist/core/types/src/room/data-stream/compression.d.ts +29 -0
- package/dist/core/types/src/room/data-stream/constants.d.ts +1 -0
- package/dist/core/types/src/room/data-stream/extension.d.ts +62 -0
- package/dist/core/types/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +32 -0
- package/dist/core/types/src/room/data-stream/incoming/StreamReader.d.ts +77 -0
- package/dist/core/types/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
- package/dist/core/types/src/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
- package/dist/core/types/src/room/data-stream/outgoing/header-utils.d.ts +17 -0
- package/dist/core/types/src/room/data-track/LocalDataTrack.d.ts +70 -0
- package/dist/core/types/src/room/data-track/RemoteDataTrack.d.ts +43 -0
- package/dist/core/types/src/room/data-track/depacketizer.d.ts +58 -0
- package/dist/core/types/src/room/data-track/extension.d.ts +30 -0
- package/dist/core/types/src/room/data-track/frame.d.ts +21 -0
- package/dist/core/types/src/room/data-track/handle.d.ts +26 -0
- package/dist/core/types/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
- package/dist/core/types/src/room/data-track/incoming/errors.d.ts +23 -0
- package/dist/core/types/src/room/data-track/incoming/pipeline.d.ts +40 -0
- package/dist/core/types/src/room/data-track/incoming/types.d.ts +19 -0
- package/dist/core/types/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
- package/dist/core/types/src/room/data-track/outgoing/errors.d.ts +73 -0
- package/dist/core/types/src/room/data-track/outgoing/pipeline.d.ts +22 -0
- package/dist/core/types/src/room/data-track/outgoing/types.d.ts +47 -0
- package/dist/core/types/src/room/data-track/packet/constants.d.ts +19 -0
- package/dist/core/types/src/room/data-track/packet/errors.d.ts +39 -0
- package/dist/core/types/src/room/data-track/packet/extensions.d.ts +68 -0
- package/dist/core/types/src/room/data-track/packet/index.d.ts +91 -0
- package/dist/core/types/src/room/data-track/packet/serializable.d.ts +12 -0
- package/dist/core/types/src/room/data-track/packetizer.d.ts +40 -0
- package/dist/core/types/src/room/data-track/track-interfaces.d.ts +22 -0
- package/dist/core/types/src/room/data-track/types.d.ts +21 -0
- package/dist/core/types/src/room/data-track/utils.d.ts +59 -0
- package/dist/core/types/src/room/debounce.d.ts +10 -0
- package/dist/core/types/src/room/defaults.d.ts +7 -0
- package/dist/core/types/src/room/errors.d.ts +179 -0
- package/dist/core/types/src/room/events.d.ts +534 -0
- package/dist/core/types/src/room/extensions.d.ts +205 -0
- package/dist/core/types/src/room/participant/LocalParticipant.d.ts +164 -0
- package/dist/core/types/src/room/participant/Participant.d.ts +123 -0
- package/dist/core/types/src/room/participant/ParticipantTrackPermission.d.ts +25 -0
- package/dist/core/types/src/room/participant/RemoteParticipant.d.ts +37 -0
- package/dist/core/types/src/room/participant/publishUtils.d.ts +11 -0
- package/dist/core/types/src/room/rpc/client/RpcClientManager.d.ts +1 -0
- package/dist/core/types/src/room/rpc/client/events.d.ts +7 -0
- package/dist/core/types/src/room/rpc/extension.d.ts +69 -0
- package/dist/core/types/src/room/rpc/index.d.ts +5 -0
- package/dist/core/types/src/room/rpc/server/RpcServerManager.d.ts +1 -0
- package/dist/core/types/src/room/rpc/server/events.d.ts +7 -0
- package/dist/core/types/src/room/rpc/utils.d.ts +76 -0
- package/dist/core/types/src/room/simulated-participants/extension.d.ts +24 -0
- package/dist/core/types/src/room/stats.d.ts +70 -0
- package/dist/core/types/src/room/statsSummary.d.ts +12 -0
- package/dist/core/types/src/room/timers.d.ts +11 -0
- package/dist/core/types/src/room/token-source/TokenSource.d.ts +91 -0
- package/dist/core/types/src/room/token-source/types.d.ts +69 -0
- package/dist/core/types/src/room/token-source/utils.d.ts +7 -0
- package/dist/core/types/src/room/track/FrameMetadataExtractor.d.ts +18 -0
- package/dist/core/types/src/room/track/LocalAudioTrack.d.ts +53 -0
- package/dist/core/types/src/room/track/LocalTrack.d.ts +118 -0
- package/dist/core/types/src/room/track/LocalTrackPublication.d.ts +41 -0
- package/dist/core/types/src/room/track/LocalVideoTrack.d.ts +91 -0
- package/dist/core/types/src/room/track/RemoteAudioTrack.d.ts +49 -0
- package/dist/core/types/src/room/track/RemoteTrack.d.ts +29 -0
- package/dist/core/types/src/room/track/RemoteTrackPublication.d.ts +76 -0
- package/dist/core/types/src/room/track/RemoteVideoTrack.d.ts +56 -0
- package/dist/core/types/src/room/track/Track.d.ts +134 -0
- package/dist/core/types/src/room/track/TrackPublication.d.ts +74 -0
- package/dist/core/types/src/room/track/create.d.ts +12 -0
- package/dist/core/types/src/room/track/facingMode.d.ts +40 -0
- package/dist/core/types/src/room/track/options.d.ts +384 -0
- package/dist/core/types/src/room/track/processor/types.d.ts +41 -0
- package/dist/core/types/src/room/track/record.d.ts +12 -0
- package/dist/core/types/src/room/track/types.d.ts +27 -0
- package/dist/core/types/src/room/track/utils.d.ts +20 -0
- package/dist/core/types/src/room/types.d.ts +126 -0
- package/dist/core/types/src/room/utils.d.ts +246 -0
- package/dist/core/types/src/room/video/create.d.ts +27 -0
- package/dist/core/types/src/room/video/extension.d.ts +43 -0
- package/dist/core/types/src/room/video/publisher.d.ts +23 -0
- package/dist/core/types/src/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
- package/dist/core/types/src/utils/AsyncQueue.d.ts +22 -0
- package/dist/core/types/src/utils/TypedPromise.d.ts +15 -0
- package/dist/core/types/src/utils/abort-signal-polyfill.d.ts +12 -0
- package/dist/core/types/src/utils/browserParser.d.ts +9 -0
- package/dist/core/types/src/utils/camelToSnakeCase.d.ts +7 -0
- package/dist/core/types/src/utils/cloneDeep.d.ts +1 -0
- package/dist/core/types/src/utils/dataPacketBuffer.d.ts +33 -0
- package/dist/core/types/src/utils/deferrable-map.d.ts +31 -0
- package/dist/core/types/src/utils/machineInspector.d.ts +53 -0
- package/dist/core/types/src/utils/serializer.d.ts +47 -0
- package/dist/core/types/src/utils/throws.d.ts +9 -0
- package/dist/core/types/src/utils/ttlmap.d.ts +19 -0
- package/dist/core/types/src/version.d.ts +17 -0
- package/dist/core/utils/AsyncQueue.mjs +41 -0
- package/dist/core/utils/AsyncQueue.mjs.map +1 -0
- package/dist/core/utils/TypedPromise.mjs +23 -0
- package/dist/core/utils/TypedPromise.mjs.map +1 -0
- package/dist/core/utils/abort-signal-polyfill.mjs +53 -0
- package/dist/core/utils/abort-signal-polyfill.mjs.map +1 -0
- package/dist/core/utils/browserParser.mjs +62 -0
- package/dist/core/utils/browserParser.mjs.map +1 -0
- package/dist/core/utils/cloneDeep.mjs +14 -0
- package/dist/core/utils/cloneDeep.mjs.map +1 -0
- package/dist/core/utils/dataPacketBuffer.mjs +76 -0
- package/dist/core/utils/dataPacketBuffer.mjs.map +1 -0
- package/dist/core/utils/deferrable-map.mjs +94 -0
- package/dist/core/utils/deferrable-map.mjs.map +1 -0
- package/dist/core/utils/machineInspector.mjs +19 -0
- package/dist/core/utils/machineInspector.mjs.map +1 -0
- package/dist/core/utils/serializer.mjs +47 -0
- package/dist/core/utils/serializer.mjs.map +1 -0
- package/dist/core/utils/ttlmap.mjs +97 -0
- package/dist/core/utils/ttlmap.mjs.map +1 -0
- package/dist/core/version.mjs +17 -0
- package/dist/core/version.mjs.map +1 -0
- package/dist/livekit-client.e2ee.worker.js +1 -1
- package/dist/livekit-client.e2ee.worker.js.map +1 -1
- package/dist/livekit-client.e2ee.worker.mjs +225 -137
- package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
- package/dist/livekit-client.esm.mjs +32913 -31390
- package/dist/livekit-client.esm.mjs.map +1 -1
- package/dist/livekit-client.fm.worker.js +1 -1
- package/dist/livekit-client.fm.worker.js.map +1 -1
- package/dist/livekit-client.fm.worker.mjs +21 -82
- package/dist/livekit-client.fm.worker.mjs.map +1 -1
- package/dist/livekit-client.umd.js +1 -1
- package/dist/livekit-client.umd.js.map +1 -1
- package/dist/src/api/SignalClient.d.ts +1 -1
- package/dist/src/api/SignalClient.d.ts.map +1 -1
- package/dist/src/api/WebSocketStream.d.ts +1 -0
- package/dist/src/api/WebSocketStream.d.ts.map +1 -1
- package/dist/src/api/utils.d.ts +1 -1
- package/dist/src/api/utils.d.ts.map +1 -1
- package/dist/src/connectionHelper/checks/Checker.d.ts +7 -4
- package/dist/src/connectionHelper/checks/Checker.d.ts.map +1 -1
- package/dist/src/core.d.ts +33 -0
- package/dist/src/core.d.ts.map +1 -0
- package/dist/src/e2ee/E2eeManager.d.ts +25 -5
- package/dist/src/e2ee/E2eeManager.d.ts.map +1 -1
- package/dist/src/e2ee/KeyProvider.d.ts.map +1 -1
- package/dist/src/e2ee/extension.d.ts +19 -0
- package/dist/src/e2ee/extension.d.ts.map +1 -0
- package/dist/src/e2ee/types.d.ts +14 -0
- package/dist/src/e2ee/types.d.ts.map +1 -1
- package/dist/src/e2ee/utils.d.ts +6 -1
- package/dist/src/e2ee/utils.d.ts.map +1 -1
- package/dist/src/e2ee/worker/FrameCryptor.d.ts +7 -1
- package/dist/src/e2ee/worker/FrameCryptor.d.ts.map +1 -1
- package/dist/src/e2ee/worker/naluUtils.d.ts +19 -1
- package/dist/src/e2ee/worker/naluUtils.d.ts.map +1 -1
- package/dist/src/e2ee/worker/sifPayload.d.ts +1 -1
- package/dist/src/e2ee/worker/sifPayload.d.ts.map +1 -1
- package/dist/src/exports.d.ts +76 -0
- package/dist/src/exports.d.ts.map +1 -0
- package/dist/src/frameMetadata/FrameMetadataManager.d.ts +5 -2
- package/dist/src/frameMetadata/FrameMetadataManager.d.ts.map +1 -1
- package/dist/src/frameMetadata/extension.d.ts +11 -0
- package/dist/src/frameMetadata/extension.d.ts.map +1 -0
- package/dist/src/frameMetadata/utils.d.ts +5 -0
- package/dist/src/frameMetadata/utils.d.ts.map +1 -1
- package/dist/src/index.d.ts +35 -63
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/logger.d.ts +1 -3
- package/dist/src/logger.d.ts.map +1 -1
- package/dist/src/options.d.ts +20 -6
- package/dist/src/options.d.ts.map +1 -1
- package/dist/src/room/CoreRoom.d.ts +392 -0
- package/dist/src/room/CoreRoom.d.ts.map +1 -0
- package/dist/src/room/DefaultReconnectPolicy.d.ts.map +1 -1
- package/dist/src/room/PCTransport.d.ts +31 -6
- package/dist/src/room/PCTransport.d.ts.map +1 -1
- package/dist/src/room/PCTransportManager.d.ts +8 -4
- package/dist/src/room/PCTransportManager.d.ts.map +1 -1
- package/dist/src/room/RTCEngine.d.ts +31 -6
- package/dist/src/room/RTCEngine.d.ts.map +1 -1
- package/dist/src/room/Room.d.ts +5 -350
- package/dist/src/room/Room.d.ts.map +1 -1
- package/dist/src/room/chat/extension.d.ts +22 -0
- package/dist/src/room/chat/extension.d.ts.map +1 -0
- package/dist/src/room/createRoom.d.ts +19 -0
- package/dist/src/room/createRoom.d.ts.map +1 -0
- package/dist/src/room/data-channel/DataChannelManager.d.ts +16 -9
- package/dist/src/room/data-channel/DataChannelManager.d.ts.map +1 -1
- package/dist/src/room/data-channel/FlowControlledDataChannel.d.ts +25 -12
- package/dist/src/room/data-channel/FlowControlledDataChannel.d.ts.map +1 -1
- package/dist/src/room/data-channel/LossyDataChannel.d.ts.map +1 -1
- package/dist/src/room/data-channel/ReliableDataChannel.d.ts.map +1 -1
- package/dist/src/room/data-stream/constants.d.ts +9 -0
- package/dist/src/room/data-stream/constants.d.ts.map +1 -1
- package/dist/src/room/data-stream/extension.d.ts +73 -0
- package/dist/src/room/data-stream/extension.d.ts.map +1 -0
- package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
- package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts.map +1 -1
- package/dist/src/room/data-stream/incoming/StreamReader.d.ts.map +1 -1
- package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
- package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts.map +1 -1
- package/dist/src/room/data-track/LocalDataTrack.d.ts +1 -1
- package/dist/src/room/data-track/depacketizer.d.ts +1 -1
- package/dist/src/room/data-track/depacketizer.d.ts.map +1 -1
- package/dist/src/room/data-track/extension.d.ts +31 -0
- package/dist/src/room/data-track/extension.d.ts.map +1 -0
- package/dist/src/room/data-track/handle.d.ts +1 -1
- package/dist/src/room/data-track/handle.d.ts.map +1 -1
- package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
- package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts.map +1 -1
- package/dist/src/room/data-track/incoming/pipeline.d.ts +1 -1
- package/dist/src/room/data-track/incoming/pipeline.d.ts.map +1 -1
- package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
- package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts.map +1 -1
- package/dist/src/room/data-track/outgoing/pipeline.d.ts +1 -1
- package/dist/src/room/data-track/outgoing/pipeline.d.ts.map +1 -1
- package/dist/src/room/data-track/packet/extensions.d.ts +1 -1
- package/dist/src/room/data-track/packet/extensions.d.ts.map +1 -1
- package/dist/src/room/data-track/packet/index.d.ts +1 -1
- package/dist/src/room/data-track/packet/index.d.ts.map +1 -1
- package/dist/src/room/data-track/packet/serializable.d.ts +1 -1
- package/dist/src/room/data-track/packet/serializable.d.ts.map +1 -1
- package/dist/src/room/data-track/packetizer.d.ts +1 -1
- package/dist/src/room/data-track/packetizer.d.ts.map +1 -1
- package/dist/src/room/data-track/track-interfaces.d.ts +1 -1
- package/dist/src/room/data-track/track-interfaces.d.ts.map +1 -1
- package/dist/src/room/data-track/utils.d.ts +1 -1
- package/dist/src/room/defaults.d.ts +1 -2
- package/dist/src/room/defaults.d.ts.map +1 -1
- package/dist/src/room/extensions.d.ts +208 -0
- package/dist/src/room/extensions.d.ts.map +1 -0
- package/dist/src/room/participant/LocalParticipant.d.ts +49 -120
- package/dist/src/room/participant/LocalParticipant.d.ts.map +1 -1
- package/dist/src/room/participant/Participant.d.ts +9 -2
- package/dist/src/room/participant/Participant.d.ts.map +1 -1
- package/dist/src/room/participant/RemoteParticipant.d.ts +3 -3
- package/dist/src/room/participant/RemoteParticipant.d.ts.map +1 -1
- package/dist/src/room/participant/publishUtils.d.ts.map +1 -1
- package/dist/src/room/rpc/extension.d.ts +70 -0
- package/dist/src/room/rpc/extension.d.ts.map +1 -0
- package/dist/src/room/rpc/index.d.ts +1 -1
- package/dist/src/room/rpc/index.d.ts.map +1 -1
- package/dist/src/room/rpc/legacyExtension.d.ts +34 -0
- package/dist/src/room/rpc/legacyExtension.d.ts.map +1 -0
- package/dist/src/room/rpc/utils.d.ts.map +1 -1
- package/dist/src/room/simulated-participants/extension.d.ts +25 -0
- package/dist/src/room/simulated-participants/extension.d.ts.map +1 -0
- package/dist/src/room/token-source/TokenSource.d.ts +5 -1
- package/dist/src/room/token-source/TokenSource.d.ts.map +1 -1
- package/dist/src/room/token-source/utils.d.ts.map +1 -1
- package/dist/src/room/track/LocalAudioTrack.d.ts +24 -1
- package/dist/src/room/track/LocalAudioTrack.d.ts.map +1 -1
- package/dist/src/room/track/LocalTrack.d.ts +19 -1
- package/dist/src/room/track/LocalTrack.d.ts.map +1 -1
- package/dist/src/room/track/LocalVideoTrack.d.ts +7 -0
- package/dist/src/room/track/LocalVideoTrack.d.ts.map +1 -1
- package/dist/src/room/track/RemoteAudioTrack.d.ts +6 -0
- package/dist/src/room/track/RemoteAudioTrack.d.ts.map +1 -1
- package/dist/src/room/track/RemoteTrackPublication.d.ts +14 -1
- package/dist/src/room/track/RemoteTrackPublication.d.ts.map +1 -1
- package/dist/src/room/track/Track.d.ts.map +1 -1
- package/dist/src/room/track/TrackPublication.d.ts +2 -2
- package/dist/src/room/track/TrackPublication.d.ts.map +1 -1
- package/dist/src/room/track/create.d.ts +15 -13
- package/dist/src/room/track/create.d.ts.map +1 -1
- package/dist/src/room/track/facingMode.d.ts.map +1 -1
- package/dist/src/room/track/options.d.ts +0 -6
- package/dist/src/room/track/options.d.ts.map +1 -1
- package/dist/src/room/track/processor/types.d.ts +13 -2
- package/dist/src/room/track/processor/types.d.ts.map +1 -1
- package/dist/src/room/track/utils.d.ts +1 -1
- package/dist/src/room/track/utils.d.ts.map +1 -1
- package/dist/src/room/utils.d.ts +30 -3
- package/dist/src/room/utils.d.ts.map +1 -1
- package/dist/src/room/video/create.d.ts +28 -0
- package/dist/src/room/video/create.d.ts.map +1 -0
- package/dist/src/room/video/extension.d.ts +48 -0
- package/dist/src/room/video/extension.d.ts.map +1 -0
- package/dist/src/room/video/publisher.d.ts +24 -0
- package/dist/src/room/video/publisher.d.ts.map +1 -0
- package/dist/src/test/MockMediaStream.d.ts +6 -0
- package/dist/src/test/MockMediaStream.d.ts.map +1 -0
- package/dist/src/utils/browserParser.d.ts +0 -3
- package/dist/src/utils/browserParser.d.ts.map +1 -1
- package/dist/src/utils/deferrable-map.d.ts +1 -1
- package/dist/src/utils/deferrable-map.d.ts.map +1 -1
- package/dist/src/utils/serializer.d.ts.map +1 -1
- package/dist/src/utils/throws.d.ts +10 -0
- package/dist/src/utils/throws.d.ts.map +1 -0
- package/dist/src/version.d.ts +4 -1
- package/dist/src/version.d.ts.map +1 -1
- package/dist/ts4.2/api/WebSocketStream.d.ts +1 -0
- package/dist/ts4.2/api/utils.d.ts +1 -1
- package/dist/ts4.2/connectionHelper/checks/Checker.d.ts +7 -4
- package/dist/ts4.2/core.d.ts +34 -0
- package/dist/ts4.2/e2ee/E2eeManager.d.ts +25 -5
- package/dist/ts4.2/e2ee/extension.d.ts +20 -0
- package/dist/ts4.2/e2ee/types.d.ts +14 -0
- package/dist/ts4.2/e2ee/utils.d.ts +6 -1
- package/dist/ts4.2/e2ee/worker/FrameCryptor.d.ts +7 -1
- package/dist/ts4.2/e2ee/worker/naluUtils.d.ts +19 -1
- package/dist/ts4.2/e2ee/worker/sifPayload.d.ts +1 -1
- package/dist/ts4.2/exports.d.ts +83 -0
- package/dist/ts4.2/frameMetadata/FrameMetadataManager.d.ts +5 -2
- package/dist/ts4.2/frameMetadata/extension.d.ts +13 -0
- package/dist/ts4.2/frameMetadata/utils.d.ts +5 -0
- package/dist/ts4.2/index.d.ts +35 -69
- package/dist/ts4.2/logger.d.ts +1 -3
- package/dist/ts4.2/options.d.ts +20 -6
- package/dist/ts4.2/room/CoreRoom.d.ts +381 -0
- package/dist/ts4.2/room/PCTransport.d.ts +31 -6
- package/dist/ts4.2/room/PCTransportManager.d.ts +8 -4
- package/dist/ts4.2/room/RTCEngine.d.ts +31 -6
- package/dist/ts4.2/room/Room.d.ts +6 -339
- package/dist/ts4.2/room/chat/extension.d.ts +22 -0
- package/dist/ts4.2/room/createRoom.d.ts +20 -0
- package/dist/ts4.2/room/data-channel/DataChannelManager.d.ts +15 -9
- package/dist/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +25 -12
- package/dist/ts4.2/room/data-stream/constants.d.ts +9 -0
- package/dist/ts4.2/room/data-stream/extension.d.ts +74 -0
- package/dist/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
- package/dist/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
- package/dist/ts4.2/room/data-track/LocalDataTrack.d.ts +1 -1
- package/dist/ts4.2/room/data-track/depacketizer.d.ts +1 -1
- package/dist/ts4.2/room/data-track/extension.d.ts +31 -0
- package/dist/ts4.2/room/data-track/handle.d.ts +1 -1
- package/dist/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
- package/dist/ts4.2/room/data-track/incoming/pipeline.d.ts +1 -1
- package/dist/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
- package/dist/ts4.2/room/data-track/outgoing/pipeline.d.ts +1 -1
- package/dist/ts4.2/room/data-track/packet/extensions.d.ts +1 -1
- package/dist/ts4.2/room/data-track/packet/index.d.ts +1 -1
- package/dist/ts4.2/room/data-track/packet/serializable.d.ts +1 -1
- package/dist/ts4.2/room/data-track/packetizer.d.ts +1 -1
- package/dist/ts4.2/room/data-track/track-interfaces.d.ts +1 -1
- package/dist/ts4.2/room/data-track/utils.d.ts +1 -1
- package/dist/ts4.2/room/defaults.d.ts +1 -2
- package/dist/ts4.2/room/extensions.d.ts +214 -0
- package/dist/ts4.2/room/participant/LocalParticipant.d.ts +48 -121
- package/dist/ts4.2/room/participant/Participant.d.ts +9 -2
- package/dist/ts4.2/room/participant/RemoteParticipant.d.ts +3 -3
- package/dist/ts4.2/room/rpc/extension.d.ts +74 -0
- package/dist/ts4.2/room/rpc/index.d.ts +1 -1
- package/dist/ts4.2/room/rpc/legacyExtension.d.ts +39 -0
- package/dist/ts4.2/room/simulated-participants/extension.d.ts +25 -0
- package/dist/ts4.2/room/token-source/TokenSource.d.ts +5 -1
- package/dist/ts4.2/room/track/LocalAudioTrack.d.ts +24 -1
- package/dist/ts4.2/room/track/LocalTrack.d.ts +19 -1
- package/dist/ts4.2/room/track/LocalVideoTrack.d.ts +7 -0
- package/dist/ts4.2/room/track/RemoteAudioTrack.d.ts +6 -0
- package/dist/ts4.2/room/track/RemoteTrackPublication.d.ts +3 -1
- package/dist/ts4.2/room/track/TrackPublication.d.ts +2 -2
- package/dist/ts4.2/room/track/create.d.ts +15 -13
- package/dist/ts4.2/room/track/options.d.ts +0 -6
- package/dist/ts4.2/room/track/processor/types.d.ts +13 -2
- package/dist/ts4.2/room/track/utils.d.ts +1 -1
- package/dist/ts4.2/room/utils.d.ts +30 -3
- package/dist/ts4.2/room/video/create.d.ts +28 -0
- package/dist/ts4.2/room/video/extension.d.ts +48 -0
- package/dist/ts4.2/room/video/publisher.d.ts +24 -0
- package/dist/ts4.2/test/MockMediaStream.d.ts +6 -0
- package/dist/ts4.2/utils/browserParser.d.ts +0 -3
- package/dist/ts4.2/utils/deferrable-map.d.ts +1 -1
- package/dist/ts4.2/utils/throws.d.ts +10 -0
- package/dist/ts4.2/version.d.ts +4 -1
- package/package.json +24 -9
- package/src/api/SignalClient.test.ts +341 -0
- package/src/api/SignalClient.ts +71 -26
- package/src/api/WebSocketStream.test.ts +78 -0
- package/src/api/WebSocketStream.ts +63 -4
- package/src/api/utils.ts +1 -1
- package/src/connectionHelper/checks/Checker.ts +12 -5
- package/src/connectionHelper/checks/publishVideo.ts +1 -1
- package/src/connectionHelper/checks/reconnect.ts +1 -1
- package/src/core.ts +35 -0
- package/src/e2ee/E2eeManager.test.ts +113 -1
- package/src/e2ee/E2eeManager.ts +58 -33
- package/src/e2ee/KeyProvider.ts +2 -1
- package/src/e2ee/extension.ts +113 -0
- package/src/e2ee/subscriberBlackScreen.test.ts +9 -12
- package/src/e2ee/types.ts +14 -0
- package/src/e2ee/utils.test.ts +47 -0
- package/src/e2ee/utils.ts +26 -14
- package/src/e2ee/worker/DataCryptor.test.ts +42 -1
- package/src/e2ee/worker/DataCryptor.ts +2 -2
- package/src/e2ee/worker/FrameCryptor.race.test.ts +3 -7
- package/src/e2ee/worker/FrameCryptor.test.ts +280 -103
- package/src/e2ee/worker/FrameCryptor.ts +97 -20
- package/src/e2ee/worker/e2ee.worker.test.ts +151 -0
- package/src/e2ee/worker/e2ee.worker.ts +28 -20
- package/src/e2ee/worker/naluUtils.test.ts +143 -0
- package/src/e2ee/worker/naluUtils.ts +87 -2
- package/src/e2ee/worker/sifPayload.ts +1 -1
- package/src/exports.ts +224 -0
- package/src/frameMetadata/FrameMetadataManager.ts +9 -3
- package/src/frameMetadata/extension.ts +34 -0
- package/src/frameMetadata/frameMetadata.ts +1 -1
- package/src/frameMetadata/utils.ts +23 -0
- package/src/index.ts +47 -187
- package/src/logger.ts +1 -3
- package/src/options.ts +25 -6
- package/src/room/CoreRoom.ts +3017 -0
- package/src/room/DefaultReconnectPolicy.test.ts +58 -0
- package/src/room/DefaultReconnectPolicy.ts +14 -2
- package/src/room/DeviceManager.test.ts +55 -1
- package/src/room/DeviceManager.ts +1 -1
- package/src/room/PCTransport.test.ts +187 -2
- package/src/room/PCTransport.ts +173 -31
- package/src/room/PCTransportManager.test.ts +65 -3
- package/src/room/PCTransportManager.ts +28 -12
- package/src/room/RTCEngine.test.ts +654 -22
- package/src/room/RTCEngine.ts +240 -41
- package/src/room/RegionUrlProvider.ts +1 -1
- package/src/room/Room.test.ts +833 -4
- package/src/room/Room.ts +34 -3105
- package/src/room/chat/extension.ts +78 -0
- package/src/room/createRoom.test.ts +149 -0
- package/src/room/createRoom.ts +26 -0
- package/src/room/data-channel/DataChannelManager.test.ts +61 -7
- package/src/room/data-channel/DataChannelManager.ts +61 -38
- package/src/room/data-channel/FlowControlledDataChannel.test.ts +60 -18
- package/src/room/data-channel/FlowControlledDataChannel.ts +40 -22
- package/src/room/data-channel/LossyDataChannel.test.ts +38 -0
- package/src/room/data-channel/LossyDataChannel.ts +10 -1
- package/src/room/data-channel/ReliableDataChannel.test.ts +72 -0
- package/src/room/data-channel/ReliableDataChannel.ts +16 -5
- package/src/room/data-stream/constants.ts +10 -0
- package/src/room/data-stream/extension.ts +162 -0
- package/src/room/data-stream/incoming/IncomingDataStreamManager.test.ts +300 -3
- package/src/room/data-stream/incoming/IncomingDataStreamManager.ts +64 -2
- package/src/room/data-stream/incoming/StreamReader.ts +14 -4
- package/src/room/data-stream/outgoing/OutgoingDataStreamManager.ts +1 -2
- package/src/room/data-track/depacketizer.ts +2 -2
- package/src/room/data-track/extension.ts +244 -0
- package/src/room/data-track/handle.ts +1 -1
- package/src/room/data-track/incoming/IncomingDataTrackManager.ts +2 -2
- package/src/room/data-track/incoming/pipeline.ts +2 -2
- package/src/room/data-track/outgoing/OutgoingDataTrackManager.test.ts +42 -3
- package/src/room/data-track/outgoing/OutgoingDataTrackManager.ts +5 -3
- package/src/room/data-track/outgoing/pipeline.ts +1 -1
- package/src/room/data-track/packet/extensions.ts +1 -1
- package/src/room/data-track/packet/index.ts +1 -1
- package/src/room/data-track/packet/serializable.ts +1 -1
- package/src/room/data-track/packetizer.ts +1 -1
- package/src/room/data-track/track-interfaces.ts +4 -4
- package/src/room/data-track/utils.ts +1 -1
- package/src/room/defaults.ts +3 -16
- package/src/room/extensions.ts +310 -0
- package/src/room/participant/LocalParticipant.test.ts +154 -2
- package/src/room/participant/LocalParticipant.ts +141 -669
- package/src/room/participant/Participant.test.ts +60 -0
- package/src/room/participant/Participant.ts +27 -4
- package/src/room/participant/RemoteParticipant.ts +3 -8
- package/src/room/participant/publishUtils.ts +3 -3
- package/src/room/participant/restartOnDefaultAudioDevice.test.ts +177 -0
- package/src/room/rpc/extension.ts +159 -0
- package/src/room/rpc/index.ts +1 -10
- package/src/room/rpc/legacyExtension.ts +36 -0
- package/src/room/rpc/utils.test.ts +32 -0
- package/src/room/rpc/utils.ts +7 -0
- package/src/room/simulated-participants/extension.ts +189 -0
- package/src/room/token-source/TokenSource.test.ts +29 -0
- package/src/room/token-source/TokenSource.ts +8 -3
- package/src/room/token-source/utils.test.ts +34 -0
- package/src/room/token-source/utils.ts +23 -1
- package/src/room/track/LocalAudioTrack.ts +101 -10
- package/src/room/track/LocalTrack.ts +88 -23
- package/src/room/track/LocalVideoTrack.test.ts +66 -2
- package/src/room/track/LocalVideoTrack.ts +12 -3
- package/src/room/track/RemoteAudioTrack.ts +56 -11
- package/src/room/track/RemoteTrackPublication.ts +14 -1
- package/src/room/track/RemoteVideoTrack.test.ts +2 -0
- package/src/room/track/Track.test.ts +102 -0
- package/src/room/track/Track.ts +8 -1
- package/src/room/track/TrackPublication.ts +2 -2
- package/src/room/track/create.ts +59 -71
- package/src/room/track/facingMode.ts +5 -2
- package/src/room/track/options.ts +26 -34
- package/src/room/track/processor/types.ts +13 -2
- package/src/room/track/utils.test.ts +5 -0
- package/src/room/track/utils.ts +34 -6
- package/src/room/utils.test.ts +126 -0
- package/src/room/utils.ts +86 -23
- package/src/room/video/create.ts +95 -0
- package/src/room/video/extension.ts +115 -0
- package/src/room/video/publisher.ts +472 -0
- package/src/test/MockMediaStream.ts +13 -0
- package/src/utils/browserParser.ts +0 -3
- package/src/utils/deferrable-map.test.ts +60 -0
- package/src/utils/deferrable-map.ts +7 -4
- package/src/utils/serializer.ts +1 -1
- package/src/utils/throws.ts +15 -0
- package/src/version.ts +6 -1
package/src/e2ee/E2eeManager.ts
CHANGED
|
@@ -2,11 +2,11 @@ import { Encryption_Type, TrackInfo } from '@livekit/protocol';
|
|
|
2
2
|
import { EventEmitter } from 'events';
|
|
3
3
|
import type TypedEventEmitter from 'typed-emitter';
|
|
4
4
|
import type { FrameMetadata } from '../frameMetadata/types';
|
|
5
|
-
import { hasFrameMetadataPublishOptions } from '../frameMetadata/utils';
|
|
5
|
+
import { getPublishFrameMetadata, hasFrameMetadataPublishOptions } from '../frameMetadata/utils';
|
|
6
6
|
import { LogLevel, LoggerNames, getLogger, onWorkerLogLevelChanged, workerLogger } from '../logger';
|
|
7
|
+
import type { CoreRoom } from '../room/CoreRoom';
|
|
8
|
+
import { ConnectionState } from '../room/CoreRoom';
|
|
7
9
|
import type RTCEngine from '../room/RTCEngine';
|
|
8
|
-
import type Room from '../room/Room';
|
|
9
|
-
import { ConnectionState } from '../room/Room';
|
|
10
10
|
import { DeviceUnsupportedError } from '../room/errors';
|
|
11
11
|
import { EngineEvent, ParticipantEvent, RoomEvent } from '../room/events';
|
|
12
12
|
import type RemoteTrack from '../room/track/RemoteTrack';
|
|
@@ -49,11 +49,23 @@ import type {
|
|
|
49
49
|
import { isE2EESupported } from './utils';
|
|
50
50
|
|
|
51
51
|
export interface BaseE2EEManager {
|
|
52
|
-
|
|
52
|
+
/** @internal */
|
|
53
|
+
setup(room: CoreRoom): void;
|
|
53
54
|
setupEngine(engine: RTCEngine): void;
|
|
54
55
|
isEnabled: boolean;
|
|
55
56
|
isDataChannelEncryptionEnabled: boolean;
|
|
57
|
+
/**
|
|
58
|
+
* @internal
|
|
59
|
+
* @deprecated use `setLocalParticipantCryptorEnabled`
|
|
60
|
+
*/
|
|
56
61
|
setParticipantCryptorEnabled(enabled: boolean, participantIdentity: string): void;
|
|
62
|
+
/**
|
|
63
|
+
* Sets whether the local participant encrypts. Optional so that existing managers still
|
|
64
|
+
* satisfy the interface: without it, `setParticipantCryptorEnabled` is called.
|
|
65
|
+
* @internal
|
|
66
|
+
*/
|
|
67
|
+
setLocalParticipantCryptorEnabled?(enabled: boolean): void;
|
|
68
|
+
/** @internal */
|
|
57
69
|
setSifTrailer(trailer: NonSharedUint8Array): void;
|
|
58
70
|
encryptData(data: NonSharedUint8Array): Promise<EncryptDataResponseMessage['data']>;
|
|
59
71
|
handleEncryptedData(
|
|
@@ -63,6 +75,7 @@ export interface BaseE2EEManager {
|
|
|
63
75
|
keyIndex: number,
|
|
64
76
|
): Promise<DecryptDataResponseMessage['data']>;
|
|
65
77
|
on<E extends keyof E2EEManagerCallbacks>(event: E, listener: E2EEManagerCallbacks[E]): this;
|
|
78
|
+
off<E extends keyof E2EEManagerCallbacks>(event: E, listener: E2EEManagerCallbacks[E]): this;
|
|
66
79
|
dispose?(): void;
|
|
67
80
|
}
|
|
68
81
|
|
|
@@ -75,7 +88,7 @@ export class E2EEManager
|
|
|
75
88
|
{
|
|
76
89
|
protected worker: Worker;
|
|
77
90
|
|
|
78
|
-
protected room?:
|
|
91
|
+
protected room?: CoreRoom;
|
|
79
92
|
|
|
80
93
|
private encryptionEnabled: boolean;
|
|
81
94
|
|
|
@@ -131,7 +144,7 @@ export class E2EEManager
|
|
|
131
144
|
/**
|
|
132
145
|
* @internal
|
|
133
146
|
*/
|
|
134
|
-
setup(room:
|
|
147
|
+
setup(room: CoreRoom) {
|
|
135
148
|
if (!isE2EESupported()) {
|
|
136
149
|
throw new DeviceUnsupportedError(
|
|
137
150
|
'tried to setup end-to-end encryption on an unsupported browser',
|
|
@@ -229,11 +242,21 @@ export class E2EEManager
|
|
|
229
242
|
}
|
|
230
243
|
|
|
231
244
|
/**
|
|
245
|
+
* Sets whether the local participant encrypts.
|
|
232
246
|
* @internal
|
|
233
247
|
*/
|
|
234
|
-
|
|
235
|
-
this.log.debug(`set e2ee to ${enabled} for participant
|
|
236
|
-
this.postEnable(enabled,
|
|
248
|
+
setLocalParticipantCryptorEnabled(enabled: boolean) {
|
|
249
|
+
this.log.debug(`set e2ee to ${enabled} for the local participant`);
|
|
250
|
+
this.postEnable(enabled, this.room?.localParticipant.identity ?? '', true);
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
/**
|
|
254
|
+
* @internal
|
|
255
|
+
* @deprecated use `setLocalParticipantCryptorEnabled`. The identity is ignored: this always
|
|
256
|
+
* sets the state of the local participant.
|
|
257
|
+
*/
|
|
258
|
+
setParticipantCryptorEnabled(enabled: boolean, _participantIdentity: string) {
|
|
259
|
+
this.setLocalParticipantCryptorEnabled(enabled);
|
|
237
260
|
}
|
|
238
261
|
|
|
239
262
|
/**
|
|
@@ -284,16 +307,15 @@ export class E2EEManager
|
|
|
284
307
|
this.postKey(keyInfo, false);
|
|
285
308
|
});
|
|
286
309
|
}
|
|
287
|
-
if (
|
|
288
|
-
this.encryptionEnabled !== data.enabled
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
this.
|
|
295
|
-
|
|
296
|
-
this.encryptionEnabled = data.enabled;
|
|
310
|
+
if (data.local) {
|
|
311
|
+
if (this.encryptionEnabled !== data.enabled) {
|
|
312
|
+
this.emit(
|
|
313
|
+
EncryptionEvent.ParticipantEncryptionStatusChanged,
|
|
314
|
+
data.enabled,
|
|
315
|
+
this.room!.localParticipant,
|
|
316
|
+
);
|
|
317
|
+
this.encryptionEnabled = data.enabled;
|
|
318
|
+
}
|
|
297
319
|
} else if (data.participantIdentity) {
|
|
298
320
|
const participant = this.room?.getParticipantByIdentity(data.participantIdentity);
|
|
299
321
|
if (!participant) {
|
|
@@ -374,7 +396,7 @@ export class E2EEManager
|
|
|
374
396
|
});
|
|
375
397
|
}
|
|
376
398
|
|
|
377
|
-
private setupEventListeners(room:
|
|
399
|
+
private setupEventListeners(room: CoreRoom, keyProvider: BaseKeyProvider) {
|
|
378
400
|
room.on(RoomEvent.TrackPublished, (pub, participant) =>
|
|
379
401
|
this.setParticipantCryptorEnabledForPublication(pub, participant.identity),
|
|
380
402
|
);
|
|
@@ -409,10 +431,7 @@ export class E2EEManager
|
|
|
409
431
|
keyProvider.getKeys().forEach((keyInfo) => {
|
|
410
432
|
this.postKey(keyInfo, latestKeyIndex === (keyInfo.keyIndex ?? 0));
|
|
411
433
|
});
|
|
412
|
-
this.
|
|
413
|
-
this.room.localParticipant.isE2EEEnabled,
|
|
414
|
-
this.room.localParticipant.identity,
|
|
415
|
-
);
|
|
434
|
+
this.setLocalParticipantCryptorEnabled(this.room.localParticipant.isE2EEEnabled);
|
|
416
435
|
});
|
|
417
436
|
|
|
418
437
|
room.localParticipant.on(ParticipantEvent.LocalSenderCreated, async (sender, track) => {
|
|
@@ -431,6 +450,7 @@ export class E2EEManager
|
|
|
431
450
|
codec: mimeTypeToVideoCodecString(publication.trackInfo!.codecs[0].mimeType),
|
|
432
451
|
participantIdentity: this.room!.localParticipant.identity,
|
|
433
452
|
hasPacketTrailer: false,
|
|
453
|
+
operation: 'encode',
|
|
434
454
|
},
|
|
435
455
|
};
|
|
436
456
|
|
|
@@ -528,13 +548,14 @@ export class E2EEManager
|
|
|
528
548
|
this.worker.postMessage(msg);
|
|
529
549
|
}
|
|
530
550
|
|
|
531
|
-
private postEnable(enabled: boolean, participantIdentity: string) {
|
|
551
|
+
private postEnable(enabled: boolean, participantIdentity: string, local = false) {
|
|
532
552
|
if (this.worker) {
|
|
533
553
|
const enableMsg: EnableMessage = {
|
|
534
554
|
kind: 'enable',
|
|
535
555
|
data: {
|
|
536
556
|
enabled,
|
|
537
557
|
participantIdentity,
|
|
558
|
+
local,
|
|
538
559
|
},
|
|
539
560
|
};
|
|
540
561
|
this.worker.postMessage(enableMsg);
|
|
@@ -589,10 +610,7 @@ export class E2EEManager
|
|
|
589
610
|
});
|
|
590
611
|
return;
|
|
591
612
|
}
|
|
592
|
-
this.
|
|
593
|
-
pub.trackInfo.encryption !== Encryption_Type.NONE,
|
|
594
|
-
participantIdentity,
|
|
595
|
-
);
|
|
613
|
+
this.postEnable(pub.trackInfo.encryption !== Encryption_Type.NONE, participantIdentity);
|
|
596
614
|
}
|
|
597
615
|
|
|
598
616
|
private setupE2EEReceiver(track: RemoteTrack, remoteId: string, trackInfo?: TrackInfo) {
|
|
@@ -612,6 +630,7 @@ export class E2EEManager
|
|
|
612
630
|
remoteId,
|
|
613
631
|
track.kind === 'video' ? mimeTypeToVideoCodecString(trackInfo.mimeType) : undefined,
|
|
614
632
|
hasPacketTrailer,
|
|
633
|
+
trackInfo.encryption !== Encryption_Type.NONE,
|
|
615
634
|
);
|
|
616
635
|
}
|
|
617
636
|
|
|
@@ -620,13 +639,15 @@ export class E2EEManager
|
|
|
620
639
|
if (!sender) this.log.warn('early return because sender is not ready');
|
|
621
640
|
return;
|
|
622
641
|
}
|
|
642
|
+
const isVideo = isVideoTrack(track);
|
|
643
|
+
// Safari exposes no per-frame codec info until trackInfo arrives. Seed only h264/h265:
|
|
644
|
+
// a wrong vp8 seed would skip the NALU path, a wrong NALU seed only costs a logged fallback.
|
|
645
|
+
const publishedCodec = isVideo ? track.publishOptions?.videoCodec : undefined;
|
|
623
646
|
this.handleSender(
|
|
624
647
|
sender,
|
|
625
648
|
track.mediaStreamID,
|
|
626
|
-
undefined,
|
|
627
|
-
|
|
628
|
-
? (track.publishOptions?.frameMetadata ?? track.publishOptions?.packetTrailer)
|
|
629
|
-
: undefined,
|
|
649
|
+
publishedCodec === 'h264' || publishedCodec === 'h265' ? publishedCodec : undefined,
|
|
650
|
+
isVideo ? getPublishFrameMetadata(track.publishOptions) : undefined,
|
|
630
651
|
);
|
|
631
652
|
}
|
|
632
653
|
|
|
@@ -641,6 +662,7 @@ export class E2EEManager
|
|
|
641
662
|
participantIdentity: string,
|
|
642
663
|
codec: VideoCodec | undefined,
|
|
643
664
|
hasPacketTrailer: boolean,
|
|
665
|
+
encrypted: boolean,
|
|
644
666
|
) {
|
|
645
667
|
if (!this.worker) {
|
|
646
668
|
return;
|
|
@@ -653,6 +675,7 @@ export class E2EEManager
|
|
|
653
675
|
trackId,
|
|
654
676
|
codec,
|
|
655
677
|
hasPacketTrailer,
|
|
678
|
+
encrypted,
|
|
656
679
|
};
|
|
657
680
|
receiver.transform = new RTCRtpScriptTransform(this.worker, options);
|
|
658
681
|
} else {
|
|
@@ -671,6 +694,7 @@ export class E2EEManager
|
|
|
671
694
|
codec,
|
|
672
695
|
participantIdentity,
|
|
673
696
|
hasPacketTrailer,
|
|
697
|
+
encrypted,
|
|
674
698
|
},
|
|
675
699
|
};
|
|
676
700
|
this.worker.postMessage(msg);
|
|
@@ -702,6 +726,7 @@ export class E2EEManager
|
|
|
702
726
|
codec,
|
|
703
727
|
participantIdentity: participantIdentity,
|
|
704
728
|
hasPacketTrailer,
|
|
729
|
+
encrypted,
|
|
705
730
|
},
|
|
706
731
|
};
|
|
707
732
|
this.worker.postMessage(msg, [readable, writable]);
|
package/src/e2ee/KeyProvider.ts
CHANGED
|
@@ -57,7 +57,8 @@ export class BaseKeyProvider extends (EventEmitter as new () => TypedEventEmitte
|
|
|
57
57
|
participantId?: string,
|
|
58
58
|
keyIndex?: number,
|
|
59
59
|
) => {
|
|
60
|
-
|
|
60
|
+
// ratchetResult holds key material, so it stays out of the log.
|
|
61
|
+
log.debug('key ratcheted event received', { participantId, keyIndex });
|
|
61
62
|
};
|
|
62
63
|
|
|
63
64
|
getKeys() {
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
import { Mutex } from '@livekit/mutex';
|
|
2
|
+
import type { CoreRoom } from '../room/CoreRoom';
|
|
3
|
+
import { RoomEvent } from '../room/events';
|
|
4
|
+
import {
|
|
5
|
+
type Disposable,
|
|
6
|
+
type ExtensionContext,
|
|
7
|
+
type RoomApiProvider,
|
|
8
|
+
type SlotProvider,
|
|
9
|
+
defineExtension,
|
|
10
|
+
} from '../room/extensions';
|
|
11
|
+
import type Participant from '../room/participant/Participant';
|
|
12
|
+
import { isLocalParticipant } from '../room/utils';
|
|
13
|
+
import { type BaseE2EEManager, E2EEManager } from './E2eeManager';
|
|
14
|
+
import { EncryptionEvent } from './events';
|
|
15
|
+
import type { E2EEOptions } from './types';
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* Methods the `e2ee` extension adds to the room.
|
|
19
|
+
* @experimental
|
|
20
|
+
*/
|
|
21
|
+
export interface E2eeRoomApi {
|
|
22
|
+
/**
|
|
23
|
+
* @experimental
|
|
24
|
+
*/
|
|
25
|
+
setE2EEEnabled(enabled: boolean): Promise<void>;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** @experimental */
|
|
29
|
+
export const e2ee = /* @__PURE__ */ defineExtension(
|
|
30
|
+
'e2ee',
|
|
31
|
+
[],
|
|
32
|
+
(
|
|
33
|
+
room: CoreRoom,
|
|
34
|
+
_ctx: ExtensionContext,
|
|
35
|
+
options: E2EEOptions | undefined,
|
|
36
|
+
): RoomApiProvider<E2eeRoomApi> &
|
|
37
|
+
Partial<SlotProvider<'e2eeManager'>> &
|
|
38
|
+
Disposable & { manager: BaseE2EEManager | undefined } => {
|
|
39
|
+
const dcEncryptionEnabled = !room.options.e2ee;
|
|
40
|
+
const e2eeOptions: E2EEOptions | undefined =
|
|
41
|
+
options ?? (room.options.encryption || room.options.e2ee);
|
|
42
|
+
|
|
43
|
+
let manager: BaseE2EEManager | undefined;
|
|
44
|
+
// an app-supplied manager (and its worker) can be shared between rooms; the app owns it
|
|
45
|
+
let dispose = () => {};
|
|
46
|
+
if (e2eeOptions) {
|
|
47
|
+
if ('e2eeManager' in e2eeOptions) {
|
|
48
|
+
manager = e2eeOptions.e2eeManager;
|
|
49
|
+
manager.isDataChannelEncryptionEnabled = dcEncryptionEnabled;
|
|
50
|
+
} else {
|
|
51
|
+
const owned = new E2EEManager(e2eeOptions, dcEncryptionEnabled);
|
|
52
|
+
manager = owned;
|
|
53
|
+
dispose = () => {
|
|
54
|
+
owned.dispose();
|
|
55
|
+
e2eeOptions.worker.terminate();
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
const onStatusChanged = (enabled: boolean, participant: Participant) => {
|
|
59
|
+
if (isLocalParticipant(participant)) {
|
|
60
|
+
room.isE2EEEnabled = enabled;
|
|
61
|
+
}
|
|
62
|
+
room.emit(RoomEvent.ParticipantEncryptionStatusChanged, enabled, participant);
|
|
63
|
+
};
|
|
64
|
+
const onError = (error: Error, participantIdentity?: string) => {
|
|
65
|
+
const participant = participantIdentity
|
|
66
|
+
? room.getParticipantByIdentity(participantIdentity)
|
|
67
|
+
: undefined;
|
|
68
|
+
room.emit(RoomEvent.EncryptionError, error, participant);
|
|
69
|
+
};
|
|
70
|
+
manager.on(EncryptionEvent.ParticipantEncryptionStatusChanged, onStatusChanged);
|
|
71
|
+
manager.on(EncryptionEvent.EncryptionError, onError);
|
|
72
|
+
if ('e2eeManager' in e2eeOptions) {
|
|
73
|
+
// the app's manager outlives this room: take this room's listeners off it
|
|
74
|
+
const shared = manager;
|
|
75
|
+
dispose = () => {
|
|
76
|
+
shared.off(EncryptionEvent.ParticipantEncryptionStatusChanged, onStatusChanged);
|
|
77
|
+
shared.off(EncryptionEvent.EncryptionError, onError);
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
manager.setup(room);
|
|
81
|
+
manager.setupEngine(room.engine);
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
const stateMutex = new Mutex();
|
|
85
|
+
return {
|
|
86
|
+
manager,
|
|
87
|
+
e2eeManager: manager,
|
|
88
|
+
room: {
|
|
89
|
+
setE2EEEnabled: async (enabled) => {
|
|
90
|
+
const unlock = await stateMutex.lock();
|
|
91
|
+
try {
|
|
92
|
+
if (manager) {
|
|
93
|
+
if (room.isE2EEEnabled !== enabled) {
|
|
94
|
+
await room.localParticipant.setE2EEEnabled(enabled);
|
|
95
|
+
|
|
96
|
+
if (manager.setLocalParticipantCryptorEnabled) {
|
|
97
|
+
manager.setLocalParticipantCryptorEnabled(enabled);
|
|
98
|
+
} else if (room.localParticipant.identity !== '') {
|
|
99
|
+
manager.setParticipantCryptorEnabled(enabled, room.localParticipant.identity);
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
} else {
|
|
103
|
+
throw Error('e2ee not configured, please set e2ee settings within the room options');
|
|
104
|
+
}
|
|
105
|
+
} finally {
|
|
106
|
+
unlock();
|
|
107
|
+
}
|
|
108
|
+
},
|
|
109
|
+
},
|
|
110
|
+
dispose,
|
|
111
|
+
};
|
|
112
|
+
},
|
|
113
|
+
);
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { Encryption_Type, ParticipantInfo, TrackInfo, TrackType } from '@livekit/protocol';
|
|
2
2
|
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
|
|
3
|
-
import
|
|
3
|
+
import { ConnectionState, Room } from '../room/Room';
|
|
4
4
|
import { EngineEvent, RoomEvent } from '../room/events';
|
|
5
5
|
import type RemoteParticipant from '../room/participant/RemoteParticipant';
|
|
6
6
|
import RemoteTrackPublication from '../room/track/RemoteTrackPublication';
|
|
@@ -127,13 +127,10 @@ function setupRoomWithE2EE() {
|
|
|
127
127
|
}
|
|
128
128
|
|
|
129
129
|
describe('subscriber black screen', () => {
|
|
130
|
-
beforeEach(() => {
|
|
131
|
-
encryptionEnabledMap.clear();
|
|
132
|
-
});
|
|
130
|
+
beforeEach(() => {});
|
|
133
131
|
|
|
134
132
|
afterEach(() => {
|
|
135
133
|
vi.restoreAllMocks();
|
|
136
|
-
encryptionEnabledMap.clear();
|
|
137
134
|
});
|
|
138
135
|
|
|
139
136
|
// -------------------------------------------------------------------------
|
|
@@ -243,7 +240,6 @@ describe('subscriber black screen', () => {
|
|
|
243
240
|
it('rebuilds a dead pipeline instead of leaving the track undecrypted', async () => {
|
|
244
241
|
const keys = new ParticipantKeyHandler('jake', KEY_PROVIDER_DEFAULTS);
|
|
245
242
|
await keys.setKey(await createKeyMaterialFromString('shared-password'), 0);
|
|
246
|
-
encryptionEnabledMap.set('jake', true);
|
|
247
243
|
|
|
248
244
|
const cryptor = new FrameCryptor({
|
|
249
245
|
participantIdentity: 'jake',
|
|
@@ -251,6 +247,7 @@ describe('subscriber black screen', () => {
|
|
|
251
247
|
keyProviderOptions: KEY_PROVIDER_DEFAULTS,
|
|
252
248
|
sifTrailer: new Uint8Array(),
|
|
253
249
|
});
|
|
250
|
+
cryptor.setEncrypted(true);
|
|
254
251
|
|
|
255
252
|
// a pipeline whose readable ends on its own, e.g. the swallowed
|
|
256
253
|
// 'Destination stream closed'
|
|
@@ -282,7 +279,6 @@ describe('subscriber black screen', () => {
|
|
|
282
279
|
it('must not forward ciphertext to the decoder', async () => {
|
|
283
280
|
const keys = new ParticipantKeyHandler('jake', KEY_PROVIDER_DEFAULTS);
|
|
284
281
|
await keys.setKey(await createKeyMaterialFromString('shared-password'), 0);
|
|
285
|
-
encryptionEnabledMap.set('jake', true);
|
|
286
282
|
|
|
287
283
|
const cryptor = new FrameCryptor({
|
|
288
284
|
participantIdentity: 'jake',
|
|
@@ -290,6 +286,7 @@ describe('subscriber black screen', () => {
|
|
|
290
286
|
keyProviderOptions: KEY_PROVIDER_DEFAULTS,
|
|
291
287
|
sifTrailer: new Uint8Array(),
|
|
292
288
|
});
|
|
289
|
+
cryptor.setEncrypted(true);
|
|
293
290
|
|
|
294
291
|
const frames: RTCEncodedVideoFrame[] = [];
|
|
295
292
|
let push!: (f: RTCEncodedVideoFrame) => void;
|
|
@@ -337,7 +334,6 @@ describe('subscriber black screen', () => {
|
|
|
337
334
|
it('drops silently rather than reporting an error on a normal disconnect', async () => {
|
|
338
335
|
const keys = new ParticipantKeyHandler('jake', KEY_PROVIDER_DEFAULTS);
|
|
339
336
|
await keys.setKey(await createKeyMaterialFromString('shared-password'), 0);
|
|
340
|
-
encryptionEnabledMap.set('jake', true);
|
|
341
337
|
|
|
342
338
|
const cryptor = new FrameCryptor({
|
|
343
339
|
participantIdentity: 'jake',
|
|
@@ -345,6 +341,7 @@ describe('subscriber black screen', () => {
|
|
|
345
341
|
keyProviderOptions: KEY_PROVIDER_DEFAULTS,
|
|
346
342
|
sifTrailer: new Uint8Array(),
|
|
347
343
|
});
|
|
344
|
+
cryptor.setEncrypted(true);
|
|
348
345
|
|
|
349
346
|
const errors: Error[] = [];
|
|
350
347
|
cryptor.on(CryptorEvent.Error, (e) => errors.push(e));
|
|
@@ -386,7 +383,6 @@ describe('subscriber black screen', () => {
|
|
|
386
383
|
const keys = new ParticipantKeyHandler('bob', KEY_PROVIDER_DEFAULTS);
|
|
387
384
|
await keys.setKey(await createKeyMaterialFromString('shared-password'), 0);
|
|
388
385
|
// explicitly NOT encrypted, as opposed to "we don't know yet"
|
|
389
|
-
encryptionEnabledMap.set('bob', false);
|
|
390
386
|
|
|
391
387
|
const cryptor = new FrameCryptor({
|
|
392
388
|
participantIdentity: 'bob',
|
|
@@ -394,6 +390,7 @@ describe('subscriber black screen', () => {
|
|
|
394
390
|
keyProviderOptions: KEY_PROVIDER_DEFAULTS,
|
|
395
391
|
sifTrailer: new Uint8Array(),
|
|
396
392
|
});
|
|
393
|
+
cryptor.setEncrypted(false);
|
|
397
394
|
|
|
398
395
|
const frames: RTCEncodedVideoFrame[] = [];
|
|
399
396
|
let push!: (f: RTCEncodedVideoFrame) => void;
|
|
@@ -430,7 +427,6 @@ describe('subscriber black screen', () => {
|
|
|
430
427
|
vi.useFakeTimers();
|
|
431
428
|
try {
|
|
432
429
|
const keys = new ParticipantKeyHandler('jake', KEY_PROVIDER_DEFAULTS);
|
|
433
|
-
encryptionEnabledMap.set('jake', true);
|
|
434
430
|
|
|
435
431
|
const cryptor = new FrameCryptor({
|
|
436
432
|
participantIdentity: 'jake',
|
|
@@ -438,6 +434,7 @@ describe('subscriber black screen', () => {
|
|
|
438
434
|
keyProviderOptions: KEY_PROVIDER_DEFAULTS,
|
|
439
435
|
sifTrailer: new Uint8Array(),
|
|
440
436
|
});
|
|
437
|
+
cryptor.setEncrypted(true);
|
|
441
438
|
|
|
442
439
|
const errors: Error[] = [];
|
|
443
440
|
cryptor.on(CryptorEvent.Error, (e) => errors.push(e));
|
|
@@ -468,7 +465,6 @@ describe('subscriber black screen', () => {
|
|
|
468
465
|
vi.useFakeTimers();
|
|
469
466
|
try {
|
|
470
467
|
const keys = new ParticipantKeyHandler('me', KEY_PROVIDER_DEFAULTS);
|
|
471
|
-
encryptionEnabledMap.set('me', true);
|
|
472
468
|
|
|
473
469
|
const cryptor = new FrameCryptor({
|
|
474
470
|
participantIdentity: 'me',
|
|
@@ -476,6 +472,7 @@ describe('subscriber black screen', () => {
|
|
|
476
472
|
keyProviderOptions: KEY_PROVIDER_DEFAULTS,
|
|
477
473
|
sifTrailer: new Uint8Array(),
|
|
478
474
|
});
|
|
475
|
+
cryptor.setEncrypted(true);
|
|
479
476
|
|
|
480
477
|
const errors: Error[] = [];
|
|
481
478
|
cryptor.on(CryptorEvent.Error, (e) => errors.push(e));
|
|
@@ -506,7 +503,6 @@ describe('subscriber black screen', () => {
|
|
|
506
503
|
vi.useFakeTimers();
|
|
507
504
|
try {
|
|
508
505
|
const keys = new ParticipantKeyHandler('jake', KEY_PROVIDER_DEFAULTS);
|
|
509
|
-
encryptionEnabledMap.set('jake', true);
|
|
510
506
|
|
|
511
507
|
const cryptor = new FrameCryptor({
|
|
512
508
|
participantIdentity: 'jake',
|
|
@@ -514,6 +510,7 @@ describe('subscriber black screen', () => {
|
|
|
514
510
|
keyProviderOptions: KEY_PROVIDER_DEFAULTS,
|
|
515
511
|
sifTrailer: new Uint8Array(),
|
|
516
512
|
});
|
|
513
|
+
cryptor.setEncrypted(true);
|
|
517
514
|
|
|
518
515
|
const errors: Error[] = [];
|
|
519
516
|
cryptor.on(CryptorEvent.Error, (e) => errors.push(e));
|
package/src/e2ee/types.ts
CHANGED
|
@@ -53,6 +53,8 @@ export interface EncodeMessage extends BaseMessage {
|
|
|
53
53
|
writableStream: WritableStream;
|
|
54
54
|
trackId: string;
|
|
55
55
|
codec?: VideoCodec;
|
|
56
|
+
/** whether the publication of a received track is marked encrypted, unused on encode */
|
|
57
|
+
encrypted?: boolean;
|
|
56
58
|
/**
|
|
57
59
|
* Whether the published track advertises packet trailer features.
|
|
58
60
|
* When false, the cryptor skips the per-frame trailer extraction path
|
|
@@ -89,6 +91,10 @@ export interface UpdateCodecMessage extends BaseMessage {
|
|
|
89
91
|
*/
|
|
90
92
|
previousTrackId?: string;
|
|
91
93
|
hasPacketTrailer: boolean;
|
|
94
|
+
/** whether the publication of a received track is marked encrypted, unused on encode */
|
|
95
|
+
encrypted?: boolean;
|
|
96
|
+
/** which cryptor the update is for, a receiver's ('decode') when omitted */
|
|
97
|
+
operation?: 'encode' | 'decode';
|
|
92
98
|
};
|
|
93
99
|
}
|
|
94
100
|
|
|
@@ -123,6 +129,11 @@ export interface EnableMessage extends BaseMessage {
|
|
|
123
129
|
data: {
|
|
124
130
|
participantIdentity: string;
|
|
125
131
|
enabled: boolean;
|
|
132
|
+
/**
|
|
133
|
+
* Set when the app enables or disables encryption for the local participant. Only such a
|
|
134
|
+
* message changes whether local media is encrypted.
|
|
135
|
+
*/
|
|
136
|
+
local?: boolean;
|
|
126
137
|
};
|
|
127
138
|
}
|
|
128
139
|
|
|
@@ -244,6 +255,7 @@ export type KeyInfo = {
|
|
|
244
255
|
|
|
245
256
|
export type E2EEManagerOptions = {
|
|
246
257
|
keyProvider: BaseKeyProvider;
|
|
258
|
+
/** The worker holds the encryption state of one room. Do not share it between rooms. */
|
|
247
259
|
worker: Worker;
|
|
248
260
|
};
|
|
249
261
|
|
|
@@ -266,6 +278,8 @@ export type ScriptTransformOptions = {
|
|
|
266
278
|
participantIdentity: string;
|
|
267
279
|
trackId: string;
|
|
268
280
|
codec?: VideoCodec;
|
|
281
|
+
/** whether the publication of a received track is marked encrypted, unused on encode */
|
|
282
|
+
encrypted?: boolean;
|
|
269
283
|
/**
|
|
270
284
|
* Whether the published track advertises packet trailer features.
|
|
271
285
|
* When false, the cryptor skips the per-frame trailer extraction path
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { describe, expect, it } from 'vitest';
|
|
2
|
+
import { writeRbsp } from './utils';
|
|
3
|
+
|
|
4
|
+
describe('writeRbsp', () => {
|
|
5
|
+
it('inserts an emulation prevention byte before every byte <= 3 after two zeros', () => {
|
|
6
|
+
const cases: Array<[number[], number[]]> = [
|
|
7
|
+
// No escapes.
|
|
8
|
+
[[], []],
|
|
9
|
+
[
|
|
10
|
+
[0x00, 0x04, 0x00, 0x00, 0x04, 0xff],
|
|
11
|
+
[0x00, 0x04, 0x00, 0x00, 0x04, 0xff],
|
|
12
|
+
],
|
|
13
|
+
// One escape.
|
|
14
|
+
[
|
|
15
|
+
[0x11, 0x00, 0x00, 0x01, 0x22],
|
|
16
|
+
[0x11, 0x00, 0x00, 0x03, 0x01, 0x22],
|
|
17
|
+
],
|
|
18
|
+
// Consecutive zero runs: the zero count resets after each escape.
|
|
19
|
+
[
|
|
20
|
+
[0x00, 0x00, 0x00, 0x00, 0x00, 0x02],
|
|
21
|
+
[0x00, 0x00, 0x03, 0x00, 0x00, 0x03, 0x00, 0x02],
|
|
22
|
+
],
|
|
23
|
+
[
|
|
24
|
+
[0x00, 0x00, 0x03, 0x00, 0x00, 0x00],
|
|
25
|
+
[0x00, 0x00, 0x03, 0x03, 0x00, 0x00, 0x03, 0x00],
|
|
26
|
+
],
|
|
27
|
+
// Trailing zeros are not escaped, because no byte follows them.
|
|
28
|
+
[
|
|
29
|
+
[0xaa, 0x00, 0x00],
|
|
30
|
+
[0xaa, 0x00, 0x00],
|
|
31
|
+
],
|
|
32
|
+
[
|
|
33
|
+
[0xaa, 0x00, 0x00, 0x00, 0x00],
|
|
34
|
+
[0xaa, 0x00, 0x00, 0x03, 0x00, 0x00],
|
|
35
|
+
],
|
|
36
|
+
];
|
|
37
|
+
|
|
38
|
+
for (const [input, expected] of cases) {
|
|
39
|
+
expect(writeRbsp(new Uint8Array(input))).toEqual(new Uint8Array(expected));
|
|
40
|
+
}
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
it('returns the input itself when nothing needs escaping', () => {
|
|
44
|
+
const input = new Uint8Array([0x00, 0x00, 0x04, 0xff]);
|
|
45
|
+
expect(writeRbsp(input)).toBe(input);
|
|
46
|
+
});
|
|
47
|
+
});
|
package/src/e2ee/utils.ts
CHANGED
|
@@ -161,24 +161,36 @@ export function parseRbsp(stream: NonSharedUint8Array): NonSharedUint8Array {
|
|
|
161
161
|
const kZerosInStartSequence = 2;
|
|
162
162
|
const kEmulationByte = 3;
|
|
163
163
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
164
|
+
/**
|
|
165
|
+
* Inserts an emulation prevention byte before every byte <= 3 that follows two zeros.
|
|
166
|
+
* Returns `dataIn` itself when nothing needs escaping, which is the case for almost
|
|
167
|
+
* every encrypted frame. Callers must not mutate the result in place.
|
|
168
|
+
*/
|
|
169
|
+
export function writeRbsp(dataIn: NonSharedUint8Array): NonSharedUint8Array {
|
|
170
|
+
// Indices of the bytes that need an emulation byte in front of them.
|
|
171
|
+
const escapes: number[] = [];
|
|
172
|
+
let numConsecutiveZeros = 0;
|
|
173
|
+
for (let i = 0; i < dataIn.length; ++i) {
|
|
174
|
+
const byte = dataIn[i];
|
|
169
175
|
if (byte <= kEmulationByte && numConsecutiveZeros >= kZerosInStartSequence) {
|
|
170
|
-
|
|
171
|
-
dataOut.push(kEmulationByte);
|
|
172
|
-
numConsecutiveZeros = 0;
|
|
173
|
-
}
|
|
174
|
-
dataOut.push(byte);
|
|
175
|
-
if (byte == 0) {
|
|
176
|
-
++numConsecutiveZeros;
|
|
177
|
-
} else {
|
|
176
|
+
escapes.push(i);
|
|
178
177
|
numConsecutiveZeros = 0;
|
|
179
178
|
}
|
|
179
|
+
numConsecutiveZeros = byte === 0 ? numConsecutiveZeros + 1 : 0;
|
|
180
180
|
}
|
|
181
|
-
|
|
181
|
+
if (escapes.length === 0) {
|
|
182
|
+
return dataIn;
|
|
183
|
+
}
|
|
184
|
+
const dataOut = new Uint8Array(dataIn.length + escapes.length);
|
|
185
|
+
let from = 0;
|
|
186
|
+
for (let k = 0; k < escapes.length; ++k) {
|
|
187
|
+
// Shifted by k for the emulation bytes already written.
|
|
188
|
+
dataOut.set(dataIn.subarray(from, escapes[k]), from + k);
|
|
189
|
+
dataOut[escapes[k] + k] = kEmulationByte;
|
|
190
|
+
from = escapes[k];
|
|
191
|
+
}
|
|
192
|
+
dataOut.set(dataIn.subarray(from), from + escapes.length);
|
|
193
|
+
return dataOut;
|
|
182
194
|
}
|
|
183
195
|
|
|
184
196
|
export function asEncryptablePacket(packet: DataPacket): EncryptedPacketPayload | undefined {
|
|
@@ -126,7 +126,7 @@ describe('DataCryptor', () => {
|
|
|
126
126
|
const plainData = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);
|
|
127
127
|
|
|
128
128
|
// Sender ratchets their key forward
|
|
129
|
-
await senderKeys.ratchetKey(1
|
|
129
|
+
await senderKeys.ratchetKey(1);
|
|
130
130
|
|
|
131
131
|
// Sender encrypts data with the ratcheted key
|
|
132
132
|
const encrypted = await DataCryptor.encrypt(plainData, senderKeys);
|
|
@@ -142,6 +142,47 @@ describe('DataCryptor', () => {
|
|
|
142
142
|
expect(decrypted.payload).toEqual(plainData);
|
|
143
143
|
});
|
|
144
144
|
|
|
145
|
+
it('keeps the ratcheted key after decrypting a packet from a ratcheted sender', async () => {
|
|
146
|
+
const senderKeys = prepareParticipantTestKeys('sender', {
|
|
147
|
+
ratchetWindowSize: 4,
|
|
148
|
+
});
|
|
149
|
+
const receiverKeys = prepareParticipantTestKeys('receiver', {
|
|
150
|
+
ratchetWindowSize: 4,
|
|
151
|
+
});
|
|
152
|
+
|
|
153
|
+
const initialMaterial = await createKeyMaterialFromString('test-key');
|
|
154
|
+
await senderKeys.setKey(initialMaterial, 1);
|
|
155
|
+
await receiverKeys.setKey(initialMaterial, 1);
|
|
156
|
+
const receiverInitialKeySet = receiverKeys.getKeySet(1);
|
|
157
|
+
|
|
158
|
+
// Sender ratchets once, so the receiver is one ratchet step behind
|
|
159
|
+
await senderKeys.ratchetKey(1);
|
|
160
|
+
|
|
161
|
+
const first = new Uint8Array([1, 2, 3, 4]);
|
|
162
|
+
const encryptedFirst = await DataCryptor.encrypt(first, senderKeys);
|
|
163
|
+
const decryptedFirst = await DataCryptor.decrypt(
|
|
164
|
+
encryptedFirst.payload,
|
|
165
|
+
encryptedFirst.iv,
|
|
166
|
+
receiverKeys,
|
|
167
|
+
encryptedFirst.keyIndex,
|
|
168
|
+
);
|
|
169
|
+
expect(decryptedFirst.payload).toEqual(first);
|
|
170
|
+
|
|
171
|
+
// The receiver now stores the ratcheted key, so a later packet decrypts without ratcheting
|
|
172
|
+
expect(receiverKeys.getKeySet(1)).not.toBe(receiverInitialKeySet);
|
|
173
|
+
const ratchetSpy = vitest.spyOn(receiverKeys, 'ratchetKey');
|
|
174
|
+
const second = new Uint8Array([5, 6, 7, 8]);
|
|
175
|
+
const encryptedSecond = await DataCryptor.encrypt(second, senderKeys);
|
|
176
|
+
const decryptedSecond = await DataCryptor.decrypt(
|
|
177
|
+
encryptedSecond.payload,
|
|
178
|
+
encryptedSecond.iv,
|
|
179
|
+
receiverKeys,
|
|
180
|
+
encryptedSecond.keyIndex,
|
|
181
|
+
);
|
|
182
|
+
expect(decryptedSecond.payload).toEqual(second);
|
|
183
|
+
expect(ratchetSpy).not.toHaveBeenCalled();
|
|
184
|
+
});
|
|
185
|
+
|
|
145
186
|
it('respects ratchet window size limit', async () => {
|
|
146
187
|
// Create a scenario where we have valid encrypted data that requires ratcheting but it's disabled
|
|
147
188
|
const senderKeys = prepareParticipantTestKeys('sender', {
|