livekit-client 2.23.0 → 2.24.1
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 +47 -32
- package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs +48 -0
- package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs.map +1 -0
- package/dist/core/api/SignalClient.mjs +1214 -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 +600 -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 +234 -0
- package/dist/core/room/rpc/client/RpcClientManager.mjs.map +1 -0
- package/dist/core/room/rpc/extension.mjs +83 -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 +150 -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 +855 -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 +90 -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 +77 -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 +90 -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 +77 -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 +163 -134
- package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
- package/dist/livekit-client.esm.mjs +31589 -30883
- 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.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 +26 -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 +7 -0
- 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/PCTransport.d.ts +5 -2
- 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 +23 -6
- package/dist/src/room/RTCEngine.d.ts.map +1 -1
- package/dist/src/room/Room.d.ts +5 -403
- 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 +7 -1
- package/dist/src/room/data-channel/DataChannelManager.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 +45 -120
- package/dist/src/room/participant/LocalParticipant.d.ts.map +1 -1
- package/dist/src/room/participant/Participant.d.ts +8 -1
- 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/client/RpcClientManager.d.ts +5 -0
- package/dist/src/room/rpc/client/RpcClientManager.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 +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/LocalTrack.d.ts +1 -1
- package/dist/src/room/track/LocalTrack.d.ts.map +1 -1
- package/dist/src/room/track/LocalVideoTrack.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 +2 -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 +2 -2
- 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/connectionHelper/checks/Checker.d.ts +7 -4
- package/dist/ts4.2/core.d.ts +34 -0
- package/dist/ts4.2/e2ee/E2eeManager.d.ts +26 -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 +7 -0
- 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 +5 -2
- package/dist/ts4.2/room/PCTransportManager.d.ts +8 -4
- package/dist/ts4.2/room/RTCEngine.d.ts +23 -6
- package/dist/ts4.2/room/Room.d.ts +6 -392
- 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 +6 -1
- 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 +44 -121
- package/dist/ts4.2/room/participant/Participant.d.ts +8 -1
- package/dist/ts4.2/room/participant/RemoteParticipant.d.ts +3 -3
- package/dist/ts4.2/room/rpc/client/RpcClientManager.d.ts +5 -0
- 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/rpc/utils.d.ts +1 -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/LocalTrack.d.ts +1 -1
- 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 +2 -2
- package/dist/ts4.2/room/track/utils.d.ts +1 -1
- package/dist/ts4.2/room/utils.d.ts +2 -2
- 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 +150 -0
- package/src/api/SignalClient.ts +19 -4
- package/src/api/WebSocketStream.test.ts +67 -0
- package/src/api/WebSocketStream.ts +41 -3
- 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 +156 -3
- package/src/e2ee/E2eeManager.ts +64 -41
- 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 +94 -13
- package/src/e2ee/worker/FrameCryptor.ts +85 -22
- 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 +21 -1
- package/src/e2ee/worker/naluUtils.ts +30 -0
- 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 -189
- package/src/logger.ts +1 -3
- package/src/options.ts +25 -6
- package/src/room/CoreRoom.ts +3017 -0
- package/src/room/DeviceManager.test.ts +55 -1
- package/src/room/DeviceManager.ts +1 -1
- package/src/room/PCTransport.test.ts +43 -0
- package/src/room/PCTransport.ts +22 -22
- package/src/room/PCTransportManager.test.ts +65 -3
- package/src/room/PCTransportManager.ts +28 -12
- package/src/room/RTCEngine.test.ts +421 -21
- package/src/room/RTCEngine.ts +138 -34
- package/src/room/RegionUrlProvider.ts +1 -1
- package/src/room/Room.test.ts +741 -4
- package/src/room/Room.ts +34 -3317
- 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 +37 -0
- package/src/room/data-channel/DataChannelManager.ts +21 -3
- 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 +269 -3
- package/src/room/data-stream/incoming/IncomingDataStreamManager.ts +53 -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 +23 -6
- package/src/room/participant/LocalParticipant.ts +92 -669
- package/src/room/participant/Participant.test.ts +60 -0
- package/src/room/participant/Participant.ts +21 -1
- package/src/room/participant/RemoteParticipant.ts +3 -8
- package/src/room/participant/publishUtils.ts +3 -3
- package/src/room/participant/restartOnDefaultAudioDevice.test.ts +1 -1
- package/src/room/rpc/client/RpcClientManager.test.ts +29 -0
- package/src/room/rpc/client/RpcClientManager.ts +17 -0
- package/src/room/rpc/extension.ts +162 -0
- package/src/room/rpc/index.ts +1 -10
- package/src/room/rpc/legacyExtension.ts +36 -0
- package/src/room/rpc/utils.ts +2 -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/LocalTrack.ts +18 -10
- package/src/room/track/LocalVideoTrack.test.ts +66 -2
- package/src/room/track/LocalVideoTrack.ts +5 -3
- 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 +2 -2
- package/src/room/track/utils.ts +5 -1
- package/src/room/utils.test.ts +36 -1
- package/src/room/utils.ts +13 -3
- 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/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', {
|
|
@@ -73,7 +73,7 @@ export class DataCryptor {
|
|
|
73
73
|
name: ENCRYPTION_ALGORITHM,
|
|
74
74
|
iv,
|
|
75
75
|
},
|
|
76
|
-
keySet.encryptionKey,
|
|
76
|
+
ratchetOpts.encryptionKey ?? keySet.encryptionKey,
|
|
77
77
|
new Uint8Array(data),
|
|
78
78
|
);
|
|
79
79
|
return {
|
|
@@ -103,7 +103,7 @@ export class DataCryptor {
|
|
|
103
103
|
iv,
|
|
104
104
|
keys,
|
|
105
105
|
keyIndex,
|
|
106
|
-
initialMaterial,
|
|
106
|
+
initialMaterial ?? keySet,
|
|
107
107
|
{
|
|
108
108
|
ratchetCount: ratchetOpts.ratchetCount + 1,
|
|
109
109
|
encryptionKey: ratchetedKeySet?.encryptionKey,
|
|
@@ -2,7 +2,7 @@ import { afterEach, beforeEach, describe, expect, it, vitest } from 'vitest';
|
|
|
2
2
|
import { KEY_PROVIDER_DEFAULTS } from '../constants';
|
|
3
3
|
import type { KeyProviderOptions } from '../types';
|
|
4
4
|
import { createKeyMaterialFromString } from '../utils';
|
|
5
|
-
import { FrameCryptor,
|
|
5
|
+
import { FrameCryptor, setLocalEncryptionEnabled } from './FrameCryptor';
|
|
6
6
|
import { ParticipantKeyHandler } from './ParticipantKeyHandler';
|
|
7
7
|
|
|
8
8
|
function mockRTCEncodedVideoFrame(data: Uint8Array): RTCEncodedVideoFrame {
|
|
@@ -46,7 +46,7 @@ function createCryptor(
|
|
|
46
46
|
) {
|
|
47
47
|
const keyProviderOptions = { ...KEY_PROVIDER_DEFAULTS, ...partialKeyProviderOptions };
|
|
48
48
|
const keys = new ParticipantKeyHandler(participantIdentity, keyProviderOptions);
|
|
49
|
-
|
|
49
|
+
setLocalEncryptionEnabled(true);
|
|
50
50
|
|
|
51
51
|
const cryptor = new FrameCryptor({
|
|
52
52
|
participantIdentity,
|
|
@@ -54,6 +54,7 @@ function createCryptor(
|
|
|
54
54
|
keyProviderOptions,
|
|
55
55
|
sifTrailer: new Uint8Array(),
|
|
56
56
|
});
|
|
57
|
+
cryptor.setEncrypted(true);
|
|
57
58
|
|
|
58
59
|
return { cryptor, keys };
|
|
59
60
|
}
|
|
@@ -64,7 +65,6 @@ describe('FrameCryptor Race Conditions', () => {
|
|
|
64
65
|
});
|
|
65
66
|
|
|
66
67
|
afterEach(() => {
|
|
67
|
-
encryptionEnabledMap.clear();
|
|
68
68
|
vitest.useRealTimers();
|
|
69
69
|
});
|
|
70
70
|
|
|
@@ -130,7 +130,6 @@ describe('FrameCryptor Race Conditions', () => {
|
|
|
130
130
|
// Now switch to participant2 (transceiver reuse scenario)
|
|
131
131
|
const keys2 = new ParticipantKeyHandler('participant2', KEY_PROVIDER_DEFAULTS);
|
|
132
132
|
await keys2.setKey(await createKeyMaterialFromString('key2'), 0);
|
|
133
|
-
encryptionEnabledMap.set('participant2', true);
|
|
134
133
|
|
|
135
134
|
cryptor.setParticipant('participant2', keys2);
|
|
136
135
|
|
|
@@ -167,7 +166,6 @@ describe('FrameCryptor Race Conditions', () => {
|
|
|
167
166
|
const consoleWarnSpy = vitest.spyOn(console, 'warn').mockImplementation(() => {});
|
|
168
167
|
|
|
169
168
|
const keys2 = new ParticipantKeyHandler('participant2', KEY_PROVIDER_DEFAULTS);
|
|
170
|
-
encryptionEnabledMap.set('participant2', true);
|
|
171
169
|
|
|
172
170
|
// FIXED: setParticipant now automatically cleans up previous participant
|
|
173
171
|
cryptor.setParticipant('participant2', keys2);
|
|
@@ -393,7 +391,6 @@ describe('FrameCryptor Race Conditions', () => {
|
|
|
393
391
|
// Immediately switch participant (simulating transceiver reuse)
|
|
394
392
|
const keys2 = new ParticipantKeyHandler('participant2', KEY_PROVIDER_DEFAULTS);
|
|
395
393
|
await keys2.setKey(await createKeyMaterialFromString('key2'), 0);
|
|
396
|
-
encryptionEnabledMap.set('participant2', true);
|
|
397
394
|
|
|
398
395
|
cryptor.setParticipant('participant2', keys2);
|
|
399
396
|
|
|
@@ -506,7 +503,6 @@ describe('FrameCryptor Race Conditions', () => {
|
|
|
506
503
|
// Immediately subscribe to participant2 (transceiver reuse)
|
|
507
504
|
const keys2 = new ParticipantKeyHandler('participant2', KEY_PROVIDER_DEFAULTS);
|
|
508
505
|
await keys2.setKey(await createKeyMaterialFromString('key2'), 0);
|
|
509
|
-
encryptionEnabledMap.set('participant2', true);
|
|
510
506
|
|
|
511
507
|
cryptor.setParticipant('participant2', keys2);
|
|
512
508
|
|
|
@@ -4,12 +4,15 @@ import type { FrameMetadataPublishOptions } from '../../frameMetadata/types';
|
|
|
4
4
|
import { workerLogger } from '../../logger';
|
|
5
5
|
import type { VideoCodec } from '../../room/track/options';
|
|
6
6
|
import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
|
|
7
|
+
import { subscribeToEvents } from '../../utils/subscribeToEvents';
|
|
7
8
|
import { IV_LENGTH, KEY_PROVIDER_DEFAULTS } from '../constants';
|
|
8
|
-
import {
|
|
9
|
+
import { CryptorErrorReason } from '../errors';
|
|
10
|
+
import { type CryptorCallbacks, CryptorEvent } from '../events';
|
|
9
11
|
import type { KeyProviderOptions } from '../types';
|
|
10
12
|
import { createKeyMaterialFromString } from '../utils';
|
|
11
|
-
import { FrameCryptor,
|
|
13
|
+
import { FrameCryptor, isFrameServerInjected, setLocalEncryptionEnabled } from './FrameCryptor';
|
|
12
14
|
import { ParticipantKeyHandler } from './ParticipantKeyHandler';
|
|
15
|
+
import { parseH264IdrPpsId } from './naluUtils';
|
|
13
16
|
|
|
14
17
|
function mockEncryptedRTCEncodedVideoFrame(keyIndex: number): RTCEncodedVideoFrame {
|
|
15
18
|
const trailer = mockFrameTrailer(keyIndex);
|
|
@@ -99,7 +102,7 @@ function prepareParticipantTest(
|
|
|
99
102
|
const keyProviderOptions = { ...KEY_PROVIDER_DEFAULTS, ...partialKeyProviderOptions };
|
|
100
103
|
const keys = new ParticipantKeyHandler(participantIdentity, keyProviderOptions);
|
|
101
104
|
|
|
102
|
-
|
|
105
|
+
setLocalEncryptionEnabled(true);
|
|
103
106
|
|
|
104
107
|
const cryptor = new FrameCryptor({
|
|
105
108
|
participantIdentity,
|
|
@@ -107,6 +110,7 @@ function prepareParticipantTest(
|
|
|
107
110
|
keyProviderOptions,
|
|
108
111
|
sifTrailer: new Uint8Array(),
|
|
109
112
|
});
|
|
113
|
+
cryptor.setEncrypted(true);
|
|
110
114
|
|
|
111
115
|
const input = new TestUnderlyingSource<RTCEncodedVideoFrame>();
|
|
112
116
|
const output = new TestUnderlyingSink<RTCEncodedVideoFrame>();
|
|
@@ -143,7 +147,45 @@ describe('FrameCryptor', () => {
|
|
|
143
147
|
|
|
144
148
|
describe('encode', () => {
|
|
145
149
|
afterEach(() => {
|
|
146
|
-
|
|
150
|
+
setLocalEncryptionEnabled(undefined);
|
|
151
|
+
});
|
|
152
|
+
|
|
153
|
+
it('drops the frame and emits an error while the local state is unknown', async () => {
|
|
154
|
+
// Create an encoder for the local participant
|
|
155
|
+
const { cryptor, input, output } = prepareParticipantTestEncoder(participantIdentity, {});
|
|
156
|
+
const cryptorEvents = subscribeToEvents<CryptorCallbacks>(cryptor, [CryptorEvent.Error]);
|
|
157
|
+
|
|
158
|
+
// The app did not say yet whether the local participant encrypts
|
|
159
|
+
setLocalEncryptionEnabled(undefined);
|
|
160
|
+
|
|
161
|
+
// Send a frame
|
|
162
|
+
input.write(mockRTCEncodedVideoFrame(new Uint8Array(16)));
|
|
163
|
+
|
|
164
|
+
// The cryptor reports an error
|
|
165
|
+
const error = await cryptorEvents.waitFor(CryptorEvent.Error);
|
|
166
|
+
expect(error.reason).toStrictEqual(CryptorErrorReason.InternalError);
|
|
167
|
+
|
|
168
|
+
// The frame was not sent
|
|
169
|
+
expect(output.chunks).toStrictEqual([]);
|
|
170
|
+
});
|
|
171
|
+
|
|
172
|
+
it('encrypts after the participant was unset', async () => {
|
|
173
|
+
// Create an encoder for the local participant, with a key
|
|
174
|
+
const { cryptor, keys, input, output } = prepareParticipantTestEncoder(
|
|
175
|
+
participantIdentity,
|
|
176
|
+
{},
|
|
177
|
+
);
|
|
178
|
+
await keys.setKey(await createKeyMaterialFromString('key1'), 1);
|
|
179
|
+
|
|
180
|
+
// Unset the participant of the cryptor
|
|
181
|
+
cryptor.unsetParticipant();
|
|
182
|
+
|
|
183
|
+
// Send a frame of 16 bytes
|
|
184
|
+
input.write(mockRTCEncodedVideoFrame(new Uint8Array(16)));
|
|
185
|
+
await vitest.waitFor(() => expect(output.chunks).toHaveLength(1));
|
|
186
|
+
|
|
187
|
+
// The sent frame is longer, because encryption appends the IV and the trailer
|
|
188
|
+
expect(output.chunks[0].data.byteLength).toBeGreaterThan(16);
|
|
147
189
|
});
|
|
148
190
|
|
|
149
191
|
it('passthrough if participant encryption disabled', async () => {
|
|
@@ -151,8 +193,8 @@ describe('FrameCryptor', () => {
|
|
|
151
193
|
try {
|
|
152
194
|
const { input, output } = prepareParticipantTestEncoder(participantIdentity, {});
|
|
153
195
|
|
|
154
|
-
// disable encryption for participant
|
|
155
|
-
|
|
196
|
+
// disable encryption for the local participant
|
|
197
|
+
setLocalEncryptionEnabled(false);
|
|
156
198
|
|
|
157
199
|
const frame = mockRTCEncodedVideoFrame(new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]));
|
|
158
200
|
|
|
@@ -311,6 +353,21 @@ describe('FrameCryptor', () => {
|
|
|
311
353
|
);
|
|
312
354
|
expect(Array.from(decryptedData)).toEqual(plainTextData);
|
|
313
355
|
});
|
|
356
|
+
it('keeps the PPS id readable when it lies past the unencrypted bytes (#2180)', async () => {
|
|
357
|
+
// Intel Quick Sync IDR slice: the PPS id is the first encrypted bit, so a single
|
|
358
|
+
// encryption leaves it at 0 only half the time.
|
|
359
|
+
const qsvIdr = [0x65, 0x88, 0x80, 0x40, 0x87, 0x0a, 0x55, 0x66];
|
|
360
|
+
const plainTextData = [0, 0, 0, 1, ...sps, 0, 0, 0, 1, ...pps, 0, 0, 0, 1, ...qsvIdr];
|
|
361
|
+
const sliceStart = plainTextData.length - qsvIdr.length;
|
|
362
|
+
for (let i = 0; i < 16; i++) {
|
|
363
|
+
const { encryptedData, decryptedData } = await encryptAndDecrypt(
|
|
364
|
+
new Uint8Array(plainTextData),
|
|
365
|
+
);
|
|
366
|
+
expect(parseH264IdrPpsId(encryptedData.subarray(sliceStart))).toBe(0);
|
|
367
|
+
expect(Array.from(decryptedData)).toEqual(plainTextData);
|
|
368
|
+
}
|
|
369
|
+
});
|
|
370
|
+
|
|
314
371
|
it('logs the frame bytes once when NALU processing fails', async () => {
|
|
315
372
|
vitest.useFakeTimers();
|
|
316
373
|
const warn = vitest.spyOn(workerLogger, 'warn');
|
|
@@ -478,17 +535,15 @@ describe('FrameCryptor', () => {
|
|
|
478
535
|
});
|
|
479
536
|
|
|
480
537
|
describe('decode', () => {
|
|
481
|
-
afterEach(() => {
|
|
482
|
-
encryptionEnabledMap.clear();
|
|
483
|
-
});
|
|
538
|
+
afterEach(() => {});
|
|
484
539
|
|
|
485
540
|
it('passthrough if participant encryption disabled', async () => {
|
|
486
541
|
vitest.useFakeTimers();
|
|
487
542
|
try {
|
|
488
|
-
const { input, output } = prepareParticipantTestDecoder(participantIdentity, {});
|
|
543
|
+
const { cryptor, input, output } = prepareParticipantTestDecoder(participantIdentity, {});
|
|
489
544
|
|
|
490
|
-
//
|
|
491
|
-
|
|
545
|
+
// the track is published unencrypted
|
|
546
|
+
cryptor.setEncrypted(false);
|
|
492
547
|
|
|
493
548
|
const frame = mockEncryptedRTCEncodedVideoFrame(1);
|
|
494
549
|
|
|
@@ -564,6 +619,32 @@ describe('FrameCryptor', () => {
|
|
|
564
619
|
}
|
|
565
620
|
});
|
|
566
621
|
|
|
622
|
+
it('logs a missing key at most once per throttle interval', async () => {
|
|
623
|
+
vitest.useFakeTimers();
|
|
624
|
+
const warn = vitest.spyOn(workerLogger, 'warn');
|
|
625
|
+
try {
|
|
626
|
+
const { input } = prepareParticipantTestDecoder(participantIdentity, {
|
|
627
|
+
failureTolerance: -1,
|
|
628
|
+
});
|
|
629
|
+
const missingKeyWarnings = () =>
|
|
630
|
+
warn.mock.calls.filter(([message]) => String(message).startsWith('skipping decryption'));
|
|
631
|
+
|
|
632
|
+
for (let frame = 0; frame < 3; frame++) {
|
|
633
|
+
input.write(mockEncryptedRTCEncodedVideoFrame(1));
|
|
634
|
+
await vitest.advanceTimersToNextTimerAsync();
|
|
635
|
+
}
|
|
636
|
+
expect(missingKeyWarnings()).toHaveLength(1);
|
|
637
|
+
|
|
638
|
+
vitest.advanceTimersByTime(1001);
|
|
639
|
+
input.write(mockEncryptedRTCEncodedVideoFrame(1));
|
|
640
|
+
await vitest.advanceTimersToNextTimerAsync();
|
|
641
|
+
expect(missingKeyWarnings()).toHaveLength(2);
|
|
642
|
+
} finally {
|
|
643
|
+
warn.mockRestore();
|
|
644
|
+
vitest.useRealTimers();
|
|
645
|
+
}
|
|
646
|
+
});
|
|
647
|
+
|
|
567
648
|
it('immediately drops frame if no key', async () => {
|
|
568
649
|
vitest.useFakeTimers();
|
|
569
650
|
try {
|
|
@@ -657,8 +738,8 @@ describe('FrameCryptor', () => {
|
|
|
657
738
|
const { cryptor, input, output } = prepareParticipantTestDecoder(participantIdentity, {});
|
|
658
739
|
const postMessage = vitest.fn();
|
|
659
740
|
vitest.stubGlobal('postMessage', postMessage);
|
|
660
|
-
encryptionEnabledMap.set(participantIdentity, false);
|
|
661
741
|
cryptor.setHasFrameMetadata(true);
|
|
742
|
+
cryptor.setEncrypted(false);
|
|
662
743
|
|
|
663
744
|
const payload = Uint8Array.from([1, 2, 3, 4]);
|
|
664
745
|
const trailer = appendPacketTrailer(payload, 1_744_249_600_123_456n, 0);
|
|
@@ -25,10 +25,25 @@ import type {
|
|
|
25
25
|
import { deriveKeys, isVideoFrame, needsRbspUnescaping, parseRbsp, writeRbsp } from '../utils';
|
|
26
26
|
import { ErrorRateLimiter } from './ErrorRateLimiter';
|
|
27
27
|
import type { ParticipantKeyHandler } from './ParticipantKeyHandler';
|
|
28
|
-
import {
|
|
28
|
+
import {
|
|
29
|
+
normalizeAnnexBStartCodes,
|
|
30
|
+
parseH264IdrPpsId,
|
|
31
|
+
processNALUsForEncryption,
|
|
32
|
+
} from './naluUtils';
|
|
29
33
|
import { identifySifPayload } from './sifPayload';
|
|
30
34
|
|
|
31
|
-
|
|
35
|
+
/**
|
|
36
|
+
* With one bit of the PPS id encrypted, each attempt matches with probability 1/2, so 16 attempts
|
|
37
|
+
* all miss with probability 2^-16. After the last attempt the frame goes out as it is.
|
|
38
|
+
*/
|
|
39
|
+
const MAX_PPS_ID_ENCRYPT_ATTEMPTS = 16;
|
|
40
|
+
|
|
41
|
+
let localEncryptionEnabled: boolean | undefined;
|
|
42
|
+
|
|
43
|
+
/** Sets whether local media is encrypted. */
|
|
44
|
+
export function setLocalEncryptionEnabled(enabled: boolean | undefined) {
|
|
45
|
+
localEncryptionEnabled = enabled;
|
|
46
|
+
}
|
|
32
47
|
|
|
33
48
|
export interface FrameCryptorConstructor {
|
|
34
49
|
new (opts?: unknown): BaseFrameCryptor;
|
|
@@ -69,6 +84,8 @@ export class FrameCryptor extends BaseFrameCryptor {
|
|
|
69
84
|
|
|
70
85
|
private trackId: string | undefined;
|
|
71
86
|
|
|
87
|
+
private encrypted: boolean | undefined;
|
|
88
|
+
|
|
72
89
|
private keys: ParticipantKeyHandler;
|
|
73
90
|
|
|
74
91
|
private videoCodec?: VideoCodec;
|
|
@@ -187,15 +204,19 @@ export class FrameCryptor extends BaseFrameCryptor {
|
|
|
187
204
|
clearTimeout(this.undecryptedTrackTimeout);
|
|
188
205
|
this.undecryptedTrackTimeout = undefined;
|
|
189
206
|
this.participantIdentity = undefined;
|
|
207
|
+
this.encrypted = undefined;
|
|
190
208
|
this.errorLimiter.reset();
|
|
191
209
|
}
|
|
192
210
|
|
|
211
|
+
/**
|
|
212
|
+
* Sets whether the received track is encrypted, from the track's own publication.
|
|
213
|
+
*/
|
|
214
|
+
setEncrypted(encrypted: boolean | undefined) {
|
|
215
|
+
this.encrypted = encrypted;
|
|
216
|
+
}
|
|
217
|
+
|
|
193
218
|
isEnabled() {
|
|
194
|
-
|
|
195
|
-
return encryptionEnabledMap.get(this.participantIdentity);
|
|
196
|
-
} else {
|
|
197
|
-
return undefined;
|
|
198
|
-
}
|
|
219
|
+
return this.participantIdentity ? this.encrypted : undefined;
|
|
199
220
|
}
|
|
200
221
|
|
|
201
222
|
getParticipantIdentity() {
|
|
@@ -411,7 +432,7 @@ export class FrameCryptor extends BaseFrameCryptor {
|
|
|
411
432
|
this.sifTrailer = trailer;
|
|
412
433
|
}
|
|
413
434
|
|
|
414
|
-
private emitThrottledError(error: CryptorError) {
|
|
435
|
+
private emitThrottledError(error: CryptorError): boolean {
|
|
415
436
|
const errorKey = `${this.participantIdentity}-${error.reason}-decrypt`;
|
|
416
437
|
const emit = this.errorLimiter.shouldEmit(errorKey, () => {
|
|
417
438
|
workerLogger.warn(`Suppressing further decryption errors for ${this.participantIdentity}`, {
|
|
@@ -419,7 +440,7 @@ export class FrameCryptor extends BaseFrameCryptor {
|
|
|
419
440
|
errorKey,
|
|
420
441
|
});
|
|
421
442
|
});
|
|
422
|
-
if (!emit) return;
|
|
443
|
+
if (!emit) return false;
|
|
423
444
|
|
|
424
445
|
const count = this.errorLimiter.countFor(errorKey);
|
|
425
446
|
if (count > 1) {
|
|
@@ -429,6 +450,7 @@ export class FrameCryptor extends BaseFrameCryptor {
|
|
|
429
450
|
});
|
|
430
451
|
}
|
|
431
452
|
this.emit(CryptorEvent.Error, error);
|
|
453
|
+
return true;
|
|
432
454
|
}
|
|
433
455
|
|
|
434
456
|
/**
|
|
@@ -462,7 +484,17 @@ export class FrameCryptor extends BaseFrameCryptor {
|
|
|
462
484
|
return controller.enqueue(encodedFrame);
|
|
463
485
|
}
|
|
464
486
|
|
|
465
|
-
if (
|
|
487
|
+
if (localEncryptionEnabled === undefined) {
|
|
488
|
+
this.emitThrottledError(
|
|
489
|
+
new CryptorError(
|
|
490
|
+
`encryption state unknown for track ${this.trackId}, dropping frame`,
|
|
491
|
+
CryptorErrorReason.InternalError,
|
|
492
|
+
this.participantIdentity,
|
|
493
|
+
),
|
|
494
|
+
);
|
|
495
|
+
return;
|
|
496
|
+
}
|
|
497
|
+
if (!localEncryptionEnabled) {
|
|
466
498
|
this.appendFrameMetadata(encodedFrame);
|
|
467
499
|
return controller.enqueue(encodedFrame);
|
|
468
500
|
}
|
|
@@ -483,7 +515,7 @@ export class FrameCryptor extends BaseFrameCryptor {
|
|
|
483
515
|
const keyIndex = this.keys.getCurrentKeyIndex();
|
|
484
516
|
|
|
485
517
|
if (encryptionKey) {
|
|
486
|
-
|
|
518
|
+
let iv = this.makeIV(
|
|
487
519
|
encodedFrame.getMetadata().synchronizationSource ?? -1,
|
|
488
520
|
encodedFrame.timestamp,
|
|
489
521
|
);
|
|
@@ -515,15 +547,44 @@ export class FrameCryptor extends BaseFrameCryptor {
|
|
|
515
547
|
// payload |IV...(length = IV_LENGTH)|R|IV_LENGTH|KID |
|
|
516
548
|
// ---------+-------------------------+-+---------+----
|
|
517
549
|
try {
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
550
|
+
// Chrome reads pic_parameter_set_id from an H.264 IDR slice before the decrypt transform,
|
|
551
|
+
// and drops the keyframe if the id names an unknown PPS. Some encoders put the id past the
|
|
552
|
+
// unencrypted bytes (#2180), so encrypt again with a fresh IV until the sent bits still
|
|
553
|
+
// read as the true id. The receiver takes the IV from the trailer, so it needs no change.
|
|
554
|
+
const sliceStart = frameInfo.unencryptedBytes - 2;
|
|
555
|
+
const ppsId = frameInfo.requiresNALUProcessing
|
|
556
|
+
? parseH264IdrPpsId(new Uint8Array(encodedFrame.data, sliceStart))
|
|
557
|
+
: null;
|
|
558
|
+
let cipherText: ArrayBuffer;
|
|
559
|
+
for (let attempt = 1; ; attempt++) {
|
|
560
|
+
cipherText = await crypto.subtle.encrypt(
|
|
561
|
+
{
|
|
562
|
+
name: ENCRYPTION_ALGORITHM,
|
|
563
|
+
iv,
|
|
564
|
+
additionalData: frameHeader,
|
|
565
|
+
},
|
|
566
|
+
encryptionKey,
|
|
567
|
+
new Uint8Array(encodedFrame.data, frameInfo.unencryptedBytes),
|
|
568
|
+
);
|
|
569
|
+
|
|
570
|
+
if (ppsId === null || attempt === MAX_PPS_ID_ENCRYPT_ATTEMPTS) {
|
|
571
|
+
break;
|
|
572
|
+
}
|
|
573
|
+
// The slice as the receiver sees it: its 2 unencrypted bytes, then the escaped
|
|
574
|
+
// ciphertext. writeRbsp works byte by byte, so escaping the first 16 bytes gives the
|
|
575
|
+
// start of the escaped frame, and a retry costs only the encryption.
|
|
576
|
+
const escapedStart = writeRbsp(new Uint8Array(cipherText, 0, 16));
|
|
577
|
+
const sentSlice = new Uint8Array(2 + escapedStart.byteLength);
|
|
578
|
+
sentSlice.set(new Uint8Array(encodedFrame.data, sliceStart, 2));
|
|
579
|
+
sentSlice.set(escapedStart, 2);
|
|
580
|
+
if (parseH264IdrPpsId(sentSlice) === ppsId) {
|
|
581
|
+
break;
|
|
582
|
+
}
|
|
583
|
+
iv = this.makeIV(
|
|
584
|
+
encodedFrame.getMetadata().synchronizationSource ?? -1,
|
|
585
|
+
encodedFrame.timestamp,
|
|
586
|
+
);
|
|
587
|
+
}
|
|
527
588
|
|
|
528
589
|
let newDataWithoutHeader: NonSharedUint8Array = new Uint8Array(
|
|
529
590
|
cipherText.byteLength + iv.byteLength + frameTrailer.byteLength,
|
|
@@ -680,14 +741,16 @@ export class FrameCryptor extends BaseFrameCryptor {
|
|
|
680
741
|
}
|
|
681
742
|
} else {
|
|
682
743
|
// emit an error if the key index is out of bounds but the key handler thinks we still have a valid key
|
|
683
|
-
|
|
684
|
-
this.emitThrottledError(
|
|
744
|
+
const emitted = this.emitThrottledError(
|
|
685
745
|
new CryptorError(
|
|
686
746
|
`missing key at index ${keyIndex} for participant ${this.participantIdentity}`,
|
|
687
747
|
CryptorErrorReason.MissingKey,
|
|
688
748
|
this.participantIdentity,
|
|
689
749
|
),
|
|
690
750
|
);
|
|
751
|
+
if (emitted) {
|
|
752
|
+
workerLogger.warn(`skipping decryption due to missing key at index ${keyIndex}`);
|
|
753
|
+
}
|
|
691
754
|
this.keys.decryptionFailure(keyIndex);
|
|
692
755
|
}
|
|
693
756
|
}
|