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/room/Room.test.ts
CHANGED
|
@@ -1,6 +1,11 @@
|
|
|
1
1
|
import {
|
|
2
2
|
ClientInfo_Capability,
|
|
3
|
+
DisconnectReason,
|
|
3
4
|
JoinResponse,
|
|
5
|
+
LeaveRequest,
|
|
6
|
+
LeaveRequest_Action,
|
|
7
|
+
ParticipantInfo,
|
|
8
|
+
ParticipantInfo_State,
|
|
4
9
|
StreamState as ProtoStreamState,
|
|
5
10
|
StreamStateUpdate,
|
|
6
11
|
SubscriptionError,
|
|
@@ -8,16 +13,26 @@ import {
|
|
|
8
13
|
TrackInfo,
|
|
9
14
|
TrackType,
|
|
10
15
|
} from '@livekit/protocol';
|
|
16
|
+
import v8 from 'node:v8';
|
|
17
|
+
import { runInNewContext } from 'node:vm';
|
|
11
18
|
import { afterEach, describe, expect, it, vi } from 'vitest';
|
|
19
|
+
import { SignalConnectionState, type SignalOptions } from '../api/SignalClient';
|
|
20
|
+
import MockMediaStream from '../test/MockMediaStream';
|
|
12
21
|
import MockMediaStreamTrack from '../test/MockMediaStreamTrack';
|
|
13
22
|
import { stubMissingDeflateRawSupport } from '../test/compressionStreamStubs';
|
|
14
|
-
import
|
|
23
|
+
import { subscribeToEvents } from '../utils/subscribeToEvents';
|
|
24
|
+
import { BackOffStrategy } from './BackOffStrategy';
|
|
25
|
+
import RTCEngine from './RTCEngine';
|
|
26
|
+
import { RegionUrlProvider } from './RegionUrlProvider';
|
|
27
|
+
import { ConnectionState, Room, type RoomEventCallbacks } from './Room';
|
|
15
28
|
import { roomConnectOptionDefaults, roomOptionDefaults } from './defaults';
|
|
29
|
+
import { ConnectionError, ConnectionErrorReason } from './errors';
|
|
16
30
|
import { EngineEvent, ParticipantEvent, RoomEvent } from './events';
|
|
17
31
|
import RemoteParticipant from './participant/RemoteParticipant';
|
|
18
32
|
import RemoteTrackPublication from './track/RemoteTrackPublication';
|
|
19
33
|
import RemoteVideoTrack from './track/RemoteVideoTrack';
|
|
20
34
|
import { Track } from './track/Track';
|
|
35
|
+
import { Future } from './utils';
|
|
21
36
|
|
|
22
37
|
describe('Active device switch', () => {
|
|
23
38
|
it('updates devices correctly', async () => {
|
|
@@ -60,7 +75,7 @@ describe('Room signaling options', () => {
|
|
|
60
75
|
|
|
61
76
|
(
|
|
62
77
|
room as unknown as {
|
|
63
|
-
e2eeManager: unknown;
|
|
78
|
+
slots: { e2eeManager: unknown };
|
|
64
79
|
connectSignal: (
|
|
65
80
|
url: string,
|
|
66
81
|
token: string,
|
|
@@ -70,7 +85,7 @@ describe('Room signaling options', () => {
|
|
|
70
85
|
abortController: AbortController,
|
|
71
86
|
) => Promise<JoinResponse>;
|
|
72
87
|
}
|
|
73
|
-
).e2eeManager = {};
|
|
88
|
+
).slots.e2eeManager = {};
|
|
74
89
|
|
|
75
90
|
await (
|
|
76
91
|
room as unknown as {
|
|
@@ -181,7 +196,7 @@ describe('Room lifecycle', () => {
|
|
|
181
196
|
// FinalizationRegistry must be registered with the Room as the target so the
|
|
182
197
|
// cleanup callback fires when the user drops their Room reference.
|
|
183
198
|
if (Room.cleanupRegistry) {
|
|
184
|
-
expect(cleanupRegistrySpy).toHaveBeenCalledWith(room, expect.any(
|
|
199
|
+
expect(cleanupRegistrySpy).toHaveBeenCalledWith(room, expect.any(AbortController));
|
|
185
200
|
}
|
|
186
201
|
|
|
187
202
|
// While the WeakRef still derefs to the Room, the listener forwards to handleDeviceChange.
|
|
@@ -229,6 +244,26 @@ describe('Room lifecycle', () => {
|
|
|
229
244
|
});
|
|
230
245
|
}
|
|
231
246
|
});
|
|
247
|
+
|
|
248
|
+
it('lets a dropped Room be garbage collected (#2008)', async () => {
|
|
249
|
+
Object.defineProperty(navigator, 'mediaDevices', {
|
|
250
|
+
configurable: true,
|
|
251
|
+
value: new EventTarget(),
|
|
252
|
+
});
|
|
253
|
+
// A Room is retained if either the devicechange listener or the registry's held value closes
|
|
254
|
+
// over the constructor's context, so check reachability with a real GC.
|
|
255
|
+
v8.setFlagsFromString('--expose-gc');
|
|
256
|
+
const gc = runInNewContext('gc') as () => void;
|
|
257
|
+
|
|
258
|
+
const roomRef = new WeakRef(new Room());
|
|
259
|
+
|
|
260
|
+
// WeakRef targets stay alive until the current job ends, so yield before each collection
|
|
261
|
+
for (let i = 0; i < 10 && roomRef.deref(); i += 1) {
|
|
262
|
+
await new Promise((resolve) => setTimeout(resolve, 10));
|
|
263
|
+
gc();
|
|
264
|
+
}
|
|
265
|
+
expect(roomRef.deref()).toBeUndefined();
|
|
266
|
+
});
|
|
232
267
|
});
|
|
233
268
|
|
|
234
269
|
describe('remote track subscription', () => {
|
|
@@ -270,6 +305,59 @@ describe('remote track subscription', () => {
|
|
|
270
305
|
|
|
271
306
|
expect(replay).not.toHaveBeenCalled();
|
|
272
307
|
});
|
|
308
|
+
|
|
309
|
+
it('does not subscribe a deferred track the server stopped sending before the room connected', () => {
|
|
310
|
+
const room = new Room();
|
|
311
|
+
room.state = ConnectionState.Connecting;
|
|
312
|
+
room.engine.emit(EngineEvent.ParticipantUpdate, [
|
|
313
|
+
new ParticipantInfo({
|
|
314
|
+
sid: 'PA_remote',
|
|
315
|
+
identity: 'remote',
|
|
316
|
+
state: ParticipantInfo_State.ACTIVE,
|
|
317
|
+
tracks: [new TrackInfo({ sid: 'TR_video', type: TrackType.VIDEO })],
|
|
318
|
+
}),
|
|
319
|
+
]);
|
|
320
|
+
const trackSubscribed = vi.fn();
|
|
321
|
+
room.on(RoomEvent.TrackSubscribed, trackSubscribed);
|
|
322
|
+
|
|
323
|
+
// the track arrives while the room connects, so the room defers it
|
|
324
|
+
const mediaTrack = new MockMediaStreamTrack();
|
|
325
|
+
const stream = new MockMediaStream('PA_remote|TR_video', [mediaTrack]);
|
|
326
|
+
room.engine.emit(EngineEvent.MediaTrackAdded, mediaTrack, stream, {} as RTCRtpReceiver);
|
|
327
|
+
|
|
328
|
+
// the subscription fails and the next answer stops the track, so the browser removes it
|
|
329
|
+
stream.removeTrack(mediaTrack);
|
|
330
|
+
|
|
331
|
+
room.state = ConnectionState.Connected;
|
|
332
|
+
room.emit(RoomEvent.Connected);
|
|
333
|
+
|
|
334
|
+
expect(trackSubscribed).not.toHaveBeenCalled();
|
|
335
|
+
});
|
|
336
|
+
|
|
337
|
+
it('subscribes a deferred track once the room connects', () => {
|
|
338
|
+
const room = new Room();
|
|
339
|
+
room.state = ConnectionState.Connecting;
|
|
340
|
+
room.engine.emit(EngineEvent.ParticipantUpdate, [
|
|
341
|
+
new ParticipantInfo({
|
|
342
|
+
sid: 'PA_remote',
|
|
343
|
+
identity: 'remote',
|
|
344
|
+
state: ParticipantInfo_State.ACTIVE,
|
|
345
|
+
tracks: [new TrackInfo({ sid: 'TR_video', type: TrackType.VIDEO })],
|
|
346
|
+
}),
|
|
347
|
+
]);
|
|
348
|
+
const trackSubscribed = vi.fn();
|
|
349
|
+
room.on(RoomEvent.TrackSubscribed, trackSubscribed);
|
|
350
|
+
|
|
351
|
+
// the track arrives while the room connects, so the room defers it
|
|
352
|
+
const mediaTrack = new MockMediaStreamTrack();
|
|
353
|
+
const stream = new MockMediaStream('PA_remote|TR_video', [mediaTrack]);
|
|
354
|
+
room.engine.emit(EngineEvent.MediaTrackAdded, mediaTrack, stream, {} as RTCRtpReceiver);
|
|
355
|
+
|
|
356
|
+
room.state = ConnectionState.Connected;
|
|
357
|
+
room.emit(RoomEvent.Connected);
|
|
358
|
+
|
|
359
|
+
expect(trackSubscribed).toHaveBeenCalledOnce();
|
|
360
|
+
});
|
|
273
361
|
});
|
|
274
362
|
|
|
275
363
|
describe('stream state updates', () => {
|
|
@@ -348,6 +436,91 @@ describe('stream state updates', () => {
|
|
|
348
436
|
});
|
|
349
437
|
});
|
|
350
438
|
|
|
439
|
+
describe('full reconnect', () => {
|
|
440
|
+
function roomIn(state: ConnectionState) {
|
|
441
|
+
const room = new Room();
|
|
442
|
+
room.state = state;
|
|
443
|
+
if (state === ConnectionState.Connecting) {
|
|
444
|
+
// connect() is pending
|
|
445
|
+
(room as unknown as { connectFuture: Future<void, Error> }).connectFuture = new Future();
|
|
446
|
+
}
|
|
447
|
+
const events: string[] = [];
|
|
448
|
+
room
|
|
449
|
+
.on(RoomEvent.SignalReconnecting, () => events.push(RoomEvent.SignalReconnecting))
|
|
450
|
+
.on(RoomEvent.Reconnecting, () => events.push(RoomEvent.Reconnecting))
|
|
451
|
+
.on(RoomEvent.Reconnected, () => events.push(RoomEvent.Reconnected))
|
|
452
|
+
.on(RoomEvent.ConnectionStateChanged, (s) => events.push(`state:${s}`));
|
|
453
|
+
return { room, events };
|
|
454
|
+
}
|
|
455
|
+
|
|
456
|
+
function restartFrom(state: ConnectionState, { resumeFirst = false } = {}) {
|
|
457
|
+
const { room, events } = roomIn(state);
|
|
458
|
+
vi.spyOn(room.engine, 'waitForRestarted').mockResolvedValue(true);
|
|
459
|
+
|
|
460
|
+
if (resumeFirst) {
|
|
461
|
+
// a rejected resume escalates to a full reconnect, as in a server CONNECTION_TIMEOUT leave
|
|
462
|
+
room.engine.emit(EngineEvent.Resuming);
|
|
463
|
+
}
|
|
464
|
+
room.engine.emit(EngineEvent.Restarting);
|
|
465
|
+
room.engine.emit(
|
|
466
|
+
EngineEvent.SignalRestarted,
|
|
467
|
+
new JoinResponse({ participant: { sid: 'PA_local', identity: 'local' } }),
|
|
468
|
+
new AbortController().signal,
|
|
469
|
+
);
|
|
470
|
+
return { room, events };
|
|
471
|
+
}
|
|
472
|
+
|
|
473
|
+
const flush = () => new Promise((resolve) => setTimeout(resolve, 0));
|
|
474
|
+
|
|
475
|
+
it('leaves an initial connection to connect() instead of reporting a reconnect', async () => {
|
|
476
|
+
const { room, events } = restartFrom(ConnectionState.Connecting);
|
|
477
|
+
await flush();
|
|
478
|
+
|
|
479
|
+
expect(events).toEqual([]);
|
|
480
|
+
expect(room.state).toBe(ConnectionState.Connecting);
|
|
481
|
+
});
|
|
482
|
+
|
|
483
|
+
it('leaves an initial connection to connect() when a resume preceded the restart', async () => {
|
|
484
|
+
const { room, events } = restartFrom(ConnectionState.Connecting, { resumeFirst: true });
|
|
485
|
+
await flush();
|
|
486
|
+
|
|
487
|
+
expect(events).toEqual([]);
|
|
488
|
+
expect(room.state).toBe(ConnectionState.Connecting);
|
|
489
|
+
});
|
|
490
|
+
|
|
491
|
+
it('leaves an initial connection to connect() when a resume succeeds', () => {
|
|
492
|
+
const { room, events } = roomIn(ConnectionState.Connecting);
|
|
493
|
+
|
|
494
|
+
room.engine.emit(EngineEvent.Resuming);
|
|
495
|
+
room.engine.emit(EngineEvent.Resumed);
|
|
496
|
+
|
|
497
|
+
expect(events).toEqual([]);
|
|
498
|
+
expect(room.state).toBe(ConnectionState.Connecting);
|
|
499
|
+
});
|
|
500
|
+
|
|
501
|
+
it('stays Connecting when the browser goes offline inside connect()', () => {
|
|
502
|
+
const { room, events } = roomIn(ConnectionState.Connecting);
|
|
503
|
+
|
|
504
|
+
room.engine.emit(EngineEvent.Offline);
|
|
505
|
+
|
|
506
|
+
expect(events).toEqual([]);
|
|
507
|
+
expect(room.state).toBe(ConnectionState.Connecting);
|
|
508
|
+
});
|
|
509
|
+
|
|
510
|
+
it('reports a reconnect of an established session', async () => {
|
|
511
|
+
const { room, events } = restartFrom(ConnectionState.Connected);
|
|
512
|
+
await flush();
|
|
513
|
+
|
|
514
|
+
expect(events).toEqual([
|
|
515
|
+
`state:${ConnectionState.Reconnecting}`,
|
|
516
|
+
RoomEvent.Reconnecting,
|
|
517
|
+
`state:${ConnectionState.Connected}`,
|
|
518
|
+
RoomEvent.Reconnected,
|
|
519
|
+
]);
|
|
520
|
+
expect(room.state).toBe(ConnectionState.Connected);
|
|
521
|
+
});
|
|
522
|
+
});
|
|
523
|
+
|
|
351
524
|
describe('audio context ownership', () => {
|
|
352
525
|
class StubAudioContext {
|
|
353
526
|
state: AudioContextState = 'running';
|
|
@@ -463,3 +636,567 @@ describe('audio context ownership', () => {
|
|
|
463
636
|
expect(created[0].closed).toBe(true);
|
|
464
637
|
});
|
|
465
638
|
});
|
|
639
|
+
|
|
640
|
+
describe('connection attempt racing disconnect (#2150)', () => {
|
|
641
|
+
afterEach(() => {
|
|
642
|
+
vi.restoreAllMocks();
|
|
643
|
+
vi.unstubAllGlobals();
|
|
644
|
+
});
|
|
645
|
+
|
|
646
|
+
type AttemptConnection = (
|
|
647
|
+
url: string,
|
|
648
|
+
token: string,
|
|
649
|
+
opts: undefined,
|
|
650
|
+
abortController: AbortController,
|
|
651
|
+
) => Promise<void>;
|
|
652
|
+
|
|
653
|
+
/** Starts a connection attempt whose signal join stays pending until `failJoin` is called. */
|
|
654
|
+
async function startAttempt(room: Room) {
|
|
655
|
+
let failJoin!: () => void;
|
|
656
|
+
vi.spyOn(RTCEngine.prototype, 'join').mockImplementationOnce(
|
|
657
|
+
() =>
|
|
658
|
+
new Promise((_, reject) => {
|
|
659
|
+
failJoin = () => reject(ConnectionError.cancelled('Connection aborted'));
|
|
660
|
+
}),
|
|
661
|
+
);
|
|
662
|
+
const engine = room.engine;
|
|
663
|
+
const abortController = new AbortController();
|
|
664
|
+
(room as unknown as { abortController: AbortController }).abortController = abortController;
|
|
665
|
+
room.state = ConnectionState.Connecting;
|
|
666
|
+
const attempt = (room as unknown as { attemptConnection: AttemptConnection }).attemptConnection(
|
|
667
|
+
'ws://localhost:7880',
|
|
668
|
+
'token',
|
|
669
|
+
undefined,
|
|
670
|
+
abortController,
|
|
671
|
+
);
|
|
672
|
+
await vi.waitFor(() => expect(failJoin).toBeDefined());
|
|
673
|
+
return { attempt, engine, failJoin };
|
|
674
|
+
}
|
|
675
|
+
|
|
676
|
+
it('rejects as cancelled when disconnect() clears the engine mid-join', async () => {
|
|
677
|
+
const room = new Room();
|
|
678
|
+
const { attempt, engine, failJoin } = await startAttempt(room);
|
|
679
|
+
const close = vi.spyOn(engine, 'close');
|
|
680
|
+
|
|
681
|
+
await room.disconnect();
|
|
682
|
+
expect(room.engine).toBeUndefined();
|
|
683
|
+
failJoin();
|
|
684
|
+
|
|
685
|
+
await expect(attempt).rejects.toMatchObject({ reason: ConnectionErrorReason.Cancelled });
|
|
686
|
+
expect(close).toHaveBeenCalled();
|
|
687
|
+
});
|
|
688
|
+
|
|
689
|
+
it('leaves a newer connect() alone when a stale join fails', async () => {
|
|
690
|
+
// connect() bails out unless the runtime looks like it supports WebRTC
|
|
691
|
+
vi.stubGlobal(
|
|
692
|
+
'RTCPeerConnection',
|
|
693
|
+
class {
|
|
694
|
+
addTrack() {}
|
|
695
|
+
},
|
|
696
|
+
);
|
|
697
|
+
let failStaleJoin!: () => void;
|
|
698
|
+
vi.spyOn(RTCEngine.prototype, 'join')
|
|
699
|
+
.mockImplementationOnce(
|
|
700
|
+
() =>
|
|
701
|
+
new Promise((_, reject) => {
|
|
702
|
+
failStaleJoin = () => reject(ConnectionError.cancelled('Connection aborted'));
|
|
703
|
+
}),
|
|
704
|
+
)
|
|
705
|
+
.mockImplementationOnce(() => new Promise(() => {}));
|
|
706
|
+
const room = new Room();
|
|
707
|
+
|
|
708
|
+
const stale = room.connect('ws://localhost:7880', 'token');
|
|
709
|
+
await vi.waitFor(() => expect(failStaleJoin).toBeDefined());
|
|
710
|
+
await room.disconnect();
|
|
711
|
+
await expect(stale).rejects.toMatchObject({ reason: ConnectionErrorReason.Cancelled });
|
|
712
|
+
|
|
713
|
+
room.connect('ws://localhost:7880', 'token').catch(() => {});
|
|
714
|
+
await vi.waitFor(() => expect(RTCEngine.prototype.join).toHaveBeenCalledTimes(2));
|
|
715
|
+
const newerEngine = room.engine;
|
|
716
|
+
const close = vi.spyOn(newerEngine, 'close');
|
|
717
|
+
const disconnected = vi.fn();
|
|
718
|
+
room.on(RoomEvent.Disconnected, disconnected);
|
|
719
|
+
|
|
720
|
+
failStaleJoin();
|
|
721
|
+
await new Promise((resolve) => setTimeout(resolve, 0));
|
|
722
|
+
|
|
723
|
+
expect(room.state).toBe(ConnectionState.Connecting);
|
|
724
|
+
expect(room.engine).toBe(newerEngine);
|
|
725
|
+
expect(close).not.toHaveBeenCalled();
|
|
726
|
+
expect(disconnected).not.toHaveBeenCalled();
|
|
727
|
+
});
|
|
728
|
+
});
|
|
729
|
+
|
|
730
|
+
describe('full reconnect failing over to a second region', () => {
|
|
731
|
+
const join = (metadata: string) =>
|
|
732
|
+
new JoinResponse({
|
|
733
|
+
room: { sid: 'RM_test', name: 'test', metadata },
|
|
734
|
+
participant: { sid: 'PA_local', identity: 'local' },
|
|
735
|
+
});
|
|
736
|
+
const flush = () => new Promise((resolve) => setTimeout(resolve, 0));
|
|
737
|
+
|
|
738
|
+
/** Drives the room as the engine does: each region attempt has a signal the next one aborts. */
|
|
739
|
+
function restarts(room: Room) {
|
|
740
|
+
let attempt: AbortController | undefined;
|
|
741
|
+
return {
|
|
742
|
+
restarting() {
|
|
743
|
+
attempt?.abort();
|
|
744
|
+
attempt = new AbortController();
|
|
745
|
+
room.engine.emit(EngineEvent.Restarting);
|
|
746
|
+
},
|
|
747
|
+
signalRestarted(metadata: string) {
|
|
748
|
+
room.engine.emit(EngineEvent.SignalRestarted, join(metadata), attempt!.signal);
|
|
749
|
+
},
|
|
750
|
+
};
|
|
751
|
+
}
|
|
752
|
+
|
|
753
|
+
function setup() {
|
|
754
|
+
const room = new Room();
|
|
755
|
+
room.state = ConnectionState.Connected;
|
|
756
|
+
room.engine.emit(EngineEvent.RoomUpdate, join('old').room!);
|
|
757
|
+
const republish = vi
|
|
758
|
+
.spyOn(room.localParticipant, 'republishAllTracks')
|
|
759
|
+
.mockImplementation(async () => {});
|
|
760
|
+
const roomEvents = subscribeToEvents<RoomEventCallbacks>(room, [
|
|
761
|
+
RoomEvent.Reconnected,
|
|
762
|
+
RoomEvent.RoomMetadataChanged,
|
|
763
|
+
]);
|
|
764
|
+
return { room, engine: restarts(room), republish, roomEvents };
|
|
765
|
+
}
|
|
766
|
+
|
|
767
|
+
/** Holds the next republish open until the returned function is called. */
|
|
768
|
+
function holdNextRepublish(republish: ReturnType<typeof setup>['republish']) {
|
|
769
|
+
let finish!: () => void;
|
|
770
|
+
republish.mockImplementationOnce(() => new Promise<void>((resolve) => (finish = resolve)));
|
|
771
|
+
return () => finish();
|
|
772
|
+
}
|
|
773
|
+
|
|
774
|
+
it('reports the recovery once, with the changes the connected region reports', async () => {
|
|
775
|
+
const { room, engine, roomEvents } = setup();
|
|
776
|
+
|
|
777
|
+
// the first region joins, then its peer connection fails
|
|
778
|
+
engine.restarting();
|
|
779
|
+
engine.signalRestarted('new');
|
|
780
|
+
await flush();
|
|
781
|
+
// the second region joins and connects
|
|
782
|
+
engine.restarting();
|
|
783
|
+
engine.signalRestarted('new');
|
|
784
|
+
await flush();
|
|
785
|
+
room.engine.emit(EngineEvent.Restarted);
|
|
786
|
+
await flush();
|
|
787
|
+
|
|
788
|
+
expect(room.state).toBe(ConnectionState.Connected);
|
|
789
|
+
await roomEvents.waitFor(RoomEvent.Reconnected);
|
|
790
|
+
expect(roomEvents.areThereBufferedEvents(RoomEvent.Reconnected)).toBe(false);
|
|
791
|
+
expect(await roomEvents.waitFor(RoomEvent.RoomMetadataChanged)).toBe('new');
|
|
792
|
+
expect(roomEvents.areThereBufferedEvents(RoomEvent.RoomMetadataChanged)).toBe(false);
|
|
793
|
+
await room.disconnect();
|
|
794
|
+
});
|
|
795
|
+
|
|
796
|
+
it('reports the recovery once when the failed region republishes past its failure', async () => {
|
|
797
|
+
const { room, engine, republish, roomEvents } = setup();
|
|
798
|
+
const finishFirstRepublish = holdNextRepublish(republish);
|
|
799
|
+
|
|
800
|
+
engine.restarting();
|
|
801
|
+
engine.signalRestarted('new');
|
|
802
|
+
await flush();
|
|
803
|
+
engine.restarting();
|
|
804
|
+
finishFirstRepublish();
|
|
805
|
+
await flush();
|
|
806
|
+
engine.signalRestarted('new');
|
|
807
|
+
await flush();
|
|
808
|
+
expect(roomEvents.areThereBufferedEvents(RoomEvent.Reconnected)).toBe(false);
|
|
809
|
+
|
|
810
|
+
room.engine.emit(EngineEvent.Restarted);
|
|
811
|
+
await flush();
|
|
812
|
+
|
|
813
|
+
await roomEvents.waitFor(RoomEvent.Reconnected);
|
|
814
|
+
expect(roomEvents.areThereBufferedEvents(RoomEvent.Reconnected)).toBe(false);
|
|
815
|
+
await room.disconnect();
|
|
816
|
+
});
|
|
817
|
+
|
|
818
|
+
it('leaves a restart alone that began while an earlier one was still republishing', async () => {
|
|
819
|
+
const { room, engine, republish, roomEvents } = setup();
|
|
820
|
+
const finishFirstRepublish = holdNextRepublish(republish);
|
|
821
|
+
// the engine reports a pending reconnect for as long as an attempt runs
|
|
822
|
+
let attemptRunning = true;
|
|
823
|
+
vi.spyOn(room.engine, 'pendingReconnect', 'get').mockImplementation(() => attemptRunning);
|
|
824
|
+
|
|
825
|
+
// the first restart connects while its republish is still running
|
|
826
|
+
engine.restarting();
|
|
827
|
+
engine.signalRestarted('a');
|
|
828
|
+
await flush();
|
|
829
|
+
room.engine.emit(EngineEvent.Restarted);
|
|
830
|
+
attemptRunning = false;
|
|
831
|
+
await flush();
|
|
832
|
+
// a second restart begins before that republish ends
|
|
833
|
+
attemptRunning = true;
|
|
834
|
+
engine.restarting();
|
|
835
|
+
finishFirstRepublish();
|
|
836
|
+
await flush();
|
|
837
|
+
expect(room.state).toBe(ConnectionState.Reconnecting);
|
|
838
|
+
expect(roomEvents.areThereBufferedEvents(RoomEvent.Reconnected)).toBe(false);
|
|
839
|
+
|
|
840
|
+
// the second restart fails over from region c to region d
|
|
841
|
+
engine.signalRestarted('c');
|
|
842
|
+
await flush();
|
|
843
|
+
engine.restarting();
|
|
844
|
+
engine.signalRestarted('c');
|
|
845
|
+
await flush();
|
|
846
|
+
room.engine.emit(EngineEvent.Restarted);
|
|
847
|
+
attemptRunning = false;
|
|
848
|
+
await flush();
|
|
849
|
+
|
|
850
|
+
expect(room.state).toBe(ConnectionState.Connected);
|
|
851
|
+
await roomEvents.waitFor(RoomEvent.Reconnected);
|
|
852
|
+
expect(roomEvents.areThereBufferedEvents(RoomEvent.Reconnected)).toBe(false);
|
|
853
|
+
expect(await roomEvents.waitFor(RoomEvent.RoomMetadataChanged)).toBe('c');
|
|
854
|
+
expect(roomEvents.areThereBufferedEvents(RoomEvent.RoomMetadataChanged)).toBe(false);
|
|
855
|
+
await room.disconnect();
|
|
856
|
+
});
|
|
857
|
+
});
|
|
858
|
+
|
|
859
|
+
describe('server leave during connect()', () => {
|
|
860
|
+
afterEach(() => {
|
|
861
|
+
vi.restoreAllMocks();
|
|
862
|
+
vi.unstubAllGlobals();
|
|
863
|
+
BackOffStrategy.getInstance().resetAll();
|
|
864
|
+
});
|
|
865
|
+
|
|
866
|
+
/**
|
|
867
|
+
* Starts `connect()` against a LiveKit Cloud URL whose signal join succeeds but whose transports
|
|
868
|
+
* never connect: the attempt only ends through its abort signal, or once the test lets the peer
|
|
869
|
+
* connection timeout elapse (after which every transport wait times out right away).
|
|
870
|
+
*/
|
|
871
|
+
async function connectUntilTransportWait() {
|
|
872
|
+
// connect() bails out unless the runtime looks like it supports WebRTC
|
|
873
|
+
vi.stubGlobal(
|
|
874
|
+
'RTCPeerConnection',
|
|
875
|
+
class {
|
|
876
|
+
addTrack() {}
|
|
877
|
+
},
|
|
878
|
+
);
|
|
879
|
+
vi.spyOn(RegionUrlProvider.prototype, 'fetchRegionSettings').mockReturnValue(
|
|
880
|
+
new Promise(() => {}),
|
|
881
|
+
);
|
|
882
|
+
const getNextBestRegionUrl = vi
|
|
883
|
+
.spyOn(RegionUrlProvider.prototype, 'getNextBestRegionUrl')
|
|
884
|
+
.mockResolvedValueOnce('wss://test-project-other-region.livekit.cloud')
|
|
885
|
+
.mockResolvedValue(null);
|
|
886
|
+
const join = vi.spyOn(RTCEngine.prototype, 'join').mockImplementation(async function (
|
|
887
|
+
this: RTCEngine,
|
|
888
|
+
) {
|
|
889
|
+
// the real join wires the signal callbacks, among them the server leave handler
|
|
890
|
+
(this as unknown as { setupSignalClientCallbacks: () => void }).setupSignalClientCallbacks();
|
|
891
|
+
return {
|
|
892
|
+
joinResponse: new JoinResponse({
|
|
893
|
+
room: { name: 'test-room', sid: 'room-sid' },
|
|
894
|
+
participant: { sid: 'participant-sid', identity: 'test-user' },
|
|
895
|
+
}),
|
|
896
|
+
serverInfo: { version: '1.0.0' },
|
|
897
|
+
};
|
|
898
|
+
});
|
|
899
|
+
let timedOut = false;
|
|
900
|
+
const pendingWaits: Array<() => void> = [];
|
|
901
|
+
vi.spyOn(RTCEngine.prototype, 'waitForPCInitialConnection').mockImplementation(
|
|
902
|
+
(_timeout, abortController) =>
|
|
903
|
+
new Promise<void>((_, reject) => {
|
|
904
|
+
const timeOut = () =>
|
|
905
|
+
reject(ConnectionError.internal('could not establish pc connection'));
|
|
906
|
+
if (timedOut) {
|
|
907
|
+
timeOut();
|
|
908
|
+
return;
|
|
909
|
+
}
|
|
910
|
+
abortController?.signal.addEventListener('abort', () =>
|
|
911
|
+
reject(ConnectionError.cancelled('room connection has been cancelled')),
|
|
912
|
+
);
|
|
913
|
+
pendingWaits.push(timeOut);
|
|
914
|
+
}),
|
|
915
|
+
);
|
|
916
|
+
|
|
917
|
+
const room = new Room();
|
|
918
|
+
const outcome = room.connect('wss://test-project.livekit.cloud', 'token').then(
|
|
919
|
+
() => 'connected',
|
|
920
|
+
(error: unknown) => error,
|
|
921
|
+
);
|
|
922
|
+
await vi.waitFor(() => expect(pendingWaits).toHaveLength(1));
|
|
923
|
+
|
|
924
|
+
const elapsePeerConnectionTimeout = () => {
|
|
925
|
+
timedOut = true;
|
|
926
|
+
pendingWaits.forEach((timeOut) => timeOut());
|
|
927
|
+
};
|
|
928
|
+
return { room, outcome, join, getNextBestRegionUrl, elapsePeerConnectionTimeout };
|
|
929
|
+
}
|
|
930
|
+
|
|
931
|
+
/** What the signal client does with a server `leave` (another session took this identity). */
|
|
932
|
+
function receiveDuplicateIdentityLeave(room: Room) {
|
|
933
|
+
room.engine.client.onLeave?.(
|
|
934
|
+
new LeaveRequest({
|
|
935
|
+
action: LeaveRequest_Action.DISCONNECT,
|
|
936
|
+
reason: DisconnectReason.DUPLICATE_IDENTITY,
|
|
937
|
+
}),
|
|
938
|
+
);
|
|
939
|
+
}
|
|
940
|
+
|
|
941
|
+
it('cancels the attempt instead of rejoining another region with the same token', async () => {
|
|
942
|
+
const { room, outcome, join, getNextBestRegionUrl, elapsePeerConnectionTimeout } =
|
|
943
|
+
await connectUntilTransportWait();
|
|
944
|
+
const connected = vi.fn();
|
|
945
|
+
room.on(RoomEvent.Connected, connected);
|
|
946
|
+
|
|
947
|
+
receiveDuplicateIdentityLeave(room);
|
|
948
|
+
expect(room.state).toBe(ConnectionState.Disconnected);
|
|
949
|
+
elapsePeerConnectionTimeout();
|
|
950
|
+
|
|
951
|
+
const error = await outcome;
|
|
952
|
+
expect(join).toHaveBeenCalledTimes(1);
|
|
953
|
+
expect(getNextBestRegionUrl).not.toHaveBeenCalled();
|
|
954
|
+
expect(error).toMatchObject({ reason: ConnectionErrorReason.Cancelled });
|
|
955
|
+
expect(room.state).toBe(ConnectionState.Disconnected);
|
|
956
|
+
expect(connected).not.toHaveBeenCalled();
|
|
957
|
+
});
|
|
958
|
+
|
|
959
|
+
it('leaves no attempt running when disconnect() follows the leave', async () => {
|
|
960
|
+
const { room, outcome, join, elapsePeerConnectionTimeout } = await connectUntilTransportWait();
|
|
961
|
+
|
|
962
|
+
receiveDuplicateIdentityLeave(room);
|
|
963
|
+
// the room already reports Disconnected, so this returns early
|
|
964
|
+
await room.disconnect();
|
|
965
|
+
elapsePeerConnectionTimeout();
|
|
966
|
+
|
|
967
|
+
const error = await outcome;
|
|
968
|
+
expect(join).toHaveBeenCalledTimes(1);
|
|
969
|
+
expect(error).toMatchObject({ reason: ConnectionErrorReason.Cancelled });
|
|
970
|
+
});
|
|
971
|
+
});
|
|
972
|
+
|
|
973
|
+
describe('events during a full reconnect (#2183)', () => {
|
|
974
|
+
afterEach(() => {
|
|
975
|
+
vi.restoreAllMocks();
|
|
976
|
+
});
|
|
977
|
+
|
|
978
|
+
interface EngineInternals {
|
|
979
|
+
_isClosed: boolean;
|
|
980
|
+
url: string;
|
|
981
|
+
token: string;
|
|
982
|
+
signalOpts: SignalOptions;
|
|
983
|
+
pcState: number;
|
|
984
|
+
configure: () => Promise<void>;
|
|
985
|
+
waitForPCReconnected: () => Promise<void>;
|
|
986
|
+
}
|
|
987
|
+
|
|
988
|
+
/**
|
|
989
|
+
* Starts a full reconnect on a connected room whose engine still reports its (old) peer
|
|
990
|
+
* connection as connected, as after a signal-only drop. The restart parks in
|
|
991
|
+
* `waitForPCReconnected` until `finishPCReconnect` is called.
|
|
992
|
+
*/
|
|
993
|
+
async function startFullReconnect() {
|
|
994
|
+
const room = new Room({ reconnectPolicy: { nextRetryDelayInMs: () => 0 } });
|
|
995
|
+
room.state = ConnectionState.Connected;
|
|
996
|
+
const engine = room.engine;
|
|
997
|
+
const internals = engine as unknown as EngineInternals;
|
|
998
|
+
internals._isClosed = false;
|
|
999
|
+
internals.url = 'wss://test.livekit.io';
|
|
1000
|
+
internals.token = 'test-token';
|
|
1001
|
+
internals.signalOpts = { autoSubscribe: true, maxRetries: 1, websocketTimeout: 15_000 };
|
|
1002
|
+
// PCState.Connected, left over from the session being replaced
|
|
1003
|
+
internals.pcState = 1;
|
|
1004
|
+
vi.spyOn(internals, 'configure').mockResolvedValue();
|
|
1005
|
+
vi.spyOn(engine.client, 'sendLeave').mockResolvedValue();
|
|
1006
|
+
vi.spyOn(engine.client, 'currentState', 'get').mockReturnValue(SignalConnectionState.CONNECTED);
|
|
1007
|
+
vi.spyOn(engine.client, 'join').mockResolvedValue(
|
|
1008
|
+
new JoinResponse({
|
|
1009
|
+
participant: new ParticipantInfo({ sid: 'PA_local', identity: 'local' }),
|
|
1010
|
+
subscriberPrimary: true,
|
|
1011
|
+
}),
|
|
1012
|
+
);
|
|
1013
|
+
const pcReconnecting = new Future<void, Error>();
|
|
1014
|
+
const pcReconnected = new Future<void, Error>();
|
|
1015
|
+
vi.spyOn(internals, 'waitForPCReconnected').mockImplementation(async () => {
|
|
1016
|
+
pcReconnecting.resolve?.();
|
|
1017
|
+
await pcReconnected.promise;
|
|
1018
|
+
});
|
|
1019
|
+
const restarted = new Future<void, Error>();
|
|
1020
|
+
engine.once(EngineEvent.Restarted, () => restarted.resolve?.());
|
|
1021
|
+
|
|
1022
|
+
const events: string[] = [];
|
|
1023
|
+
room.on(RoomEvent.Reconnected, () => events.push('reconnected'));
|
|
1024
|
+
room.on(RoomEvent.ParticipantConnected, (p) =>
|
|
1025
|
+
events.push(`participantConnected:${p.identity}`),
|
|
1026
|
+
);
|
|
1027
|
+
|
|
1028
|
+
engine.reconnect();
|
|
1029
|
+
await pcReconnecting.promise;
|
|
1030
|
+
// let the room's SignalRestarted handler run as far as it will
|
|
1031
|
+
await new Promise((resolve) => setTimeout(resolve, 0));
|
|
1032
|
+
|
|
1033
|
+
const finishPCReconnect = async () => {
|
|
1034
|
+
pcReconnected.resolve?.();
|
|
1035
|
+
await restarted.promise;
|
|
1036
|
+
await vi.waitFor(() => expect(engine.pendingReconnect).toBe(false));
|
|
1037
|
+
};
|
|
1038
|
+
return { room, engine, events, finishPCReconnect };
|
|
1039
|
+
}
|
|
1040
|
+
|
|
1041
|
+
it('does not report the room reconnected before the engine restart completes', async () => {
|
|
1042
|
+
const { room, events, finishPCReconnect } = await startFullReconnect();
|
|
1043
|
+
|
|
1044
|
+
expect(room.state).toBe(ConnectionState.Reconnecting);
|
|
1045
|
+
expect(events).toEqual([]);
|
|
1046
|
+
|
|
1047
|
+
await finishPCReconnect();
|
|
1048
|
+
|
|
1049
|
+
expect(room.state).toBe(ConnectionState.Connected);
|
|
1050
|
+
expect(events).toEqual(['reconnected']);
|
|
1051
|
+
});
|
|
1052
|
+
|
|
1053
|
+
it('delivers participant events that arrive while the restart is settling', async () => {
|
|
1054
|
+
const { room, engine, events, finishPCReconnect } = await startFullReconnect();
|
|
1055
|
+
|
|
1056
|
+
// a remote participant (re)joins while the engine is still waiting on the transports
|
|
1057
|
+
engine.emit(EngineEvent.ParticipantUpdate, [
|
|
1058
|
+
new ParticipantInfo({
|
|
1059
|
+
sid: 'PA_remote',
|
|
1060
|
+
identity: 'remote',
|
|
1061
|
+
state: ParticipantInfo_State.ACTIVE,
|
|
1062
|
+
}),
|
|
1063
|
+
]);
|
|
1064
|
+
expect(events).toEqual([]);
|
|
1065
|
+
|
|
1066
|
+
await finishPCReconnect();
|
|
1067
|
+
|
|
1068
|
+
expect(events).toEqual(['reconnected', 'participantConnected:remote']);
|
|
1069
|
+
expect((room as unknown as { bufferedEvents: unknown[] }).bufferedEvents).toEqual([]);
|
|
1070
|
+
});
|
|
1071
|
+
});
|
|
1072
|
+
|
|
1073
|
+
describe('participant updates for an earlier session (#2228)', () => {
|
|
1074
|
+
// PA_new joined after PA_old, so the server orders it as the newer session
|
|
1075
|
+
const joinTimes = {
|
|
1076
|
+
PA_old: { joinedAt: 1_700_000_000n, joinedAtMs: 1_700_000_000_100n },
|
|
1077
|
+
PA_new: { joinedAt: 1_700_000_009n, joinedAtMs: 1_700_000_009_200n },
|
|
1078
|
+
};
|
|
1079
|
+
|
|
1080
|
+
function setup() {
|
|
1081
|
+
const room = new Room();
|
|
1082
|
+
const update = (
|
|
1083
|
+
sid: keyof typeof joinTimes,
|
|
1084
|
+
state: ParticipantInfo_State,
|
|
1085
|
+
reason?: DisconnectReason,
|
|
1086
|
+
) =>
|
|
1087
|
+
(
|
|
1088
|
+
room as unknown as { handleParticipantUpdates: (infos: ParticipantInfo[]) => void }
|
|
1089
|
+
).handleParticipantUpdates([
|
|
1090
|
+
new ParticipantInfo({
|
|
1091
|
+
sid,
|
|
1092
|
+
identity: 'tutor',
|
|
1093
|
+
state,
|
|
1094
|
+
disconnectReason: reason,
|
|
1095
|
+
...joinTimes[sid],
|
|
1096
|
+
}),
|
|
1097
|
+
]);
|
|
1098
|
+
const disconnected: string[] = [];
|
|
1099
|
+
room.on(RoomEvent.ParticipantDisconnected, (p) => disconnected.push(p.sid));
|
|
1100
|
+
// the data track extension unpublishes the tracks of each identity it gets without them
|
|
1101
|
+
const dataTracks = (
|
|
1102
|
+
room as unknown as {
|
|
1103
|
+
extensionResults: Array<{ onParticipantUpdates?: (infos: ParticipantInfo[]) => void }>;
|
|
1104
|
+
}
|
|
1105
|
+
).extensionResults.find((result) => result.onParticipantUpdates)!;
|
|
1106
|
+
const extensionUpdates = vi.spyOn(dataTracks, 'onParticipantUpdates');
|
|
1107
|
+
const forwardedSids = () =>
|
|
1108
|
+
extensionUpdates.mock.calls.flatMap(([infos]) => infos.map((info) => info.sid));
|
|
1109
|
+
return { room, update, disconnected, forwardedSids };
|
|
1110
|
+
}
|
|
1111
|
+
|
|
1112
|
+
it('keeps the new session when a late DISCONNECTED arrives for the old session', () => {
|
|
1113
|
+
const { room, update, disconnected, forwardedSids } = setup();
|
|
1114
|
+
|
|
1115
|
+
update('PA_old', ParticipantInfo_State.ACTIVE);
|
|
1116
|
+
update('PA_old', ParticipantInfo_State.DISCONNECTED, DisconnectReason.SIGNAL_CLOSE);
|
|
1117
|
+
update('PA_new', ParticipantInfo_State.ACTIVE);
|
|
1118
|
+
update('PA_old', ParticipantInfo_State.DISCONNECTED, DisconnectReason.DUPLICATE_IDENTITY);
|
|
1119
|
+
|
|
1120
|
+
expect(room.remoteParticipants.get('tutor')?.sid).toBe('PA_new');
|
|
1121
|
+
expect(disconnected).toEqual(['PA_old']);
|
|
1122
|
+
expect(forwardedSids()).toEqual(['PA_old', 'PA_old', 'PA_new']);
|
|
1123
|
+
});
|
|
1124
|
+
|
|
1125
|
+
it('keeps the new session when the old session leaves after the new one joined', () => {
|
|
1126
|
+
const { room, update, disconnected, forwardedSids } = setup();
|
|
1127
|
+
|
|
1128
|
+
update('PA_old', ParticipantInfo_State.ACTIVE);
|
|
1129
|
+
update('PA_new', ParticipantInfo_State.ACTIVE);
|
|
1130
|
+
update('PA_old', ParticipantInfo_State.DISCONNECTED, DisconnectReason.DUPLICATE_IDENTITY);
|
|
1131
|
+
|
|
1132
|
+
expect(room.remoteParticipants.get('tutor')?.sid).toBe('PA_new');
|
|
1133
|
+
expect(disconnected).toEqual([]);
|
|
1134
|
+
expect(forwardedSids()).toEqual(['PA_old', 'PA_new']);
|
|
1135
|
+
|
|
1136
|
+
update('PA_new', ParticipantInfo_State.DISCONNECTED, DisconnectReason.CLIENT_INITIATED);
|
|
1137
|
+
|
|
1138
|
+
expect(room.remoteParticipants.has('tutor')).toBe(false);
|
|
1139
|
+
expect(disconnected).toEqual(['PA_new']);
|
|
1140
|
+
});
|
|
1141
|
+
|
|
1142
|
+
it('keeps the new session when a late ACTIVE arrives for the old session', () => {
|
|
1143
|
+
const { room, update, disconnected, forwardedSids } = setup();
|
|
1144
|
+
|
|
1145
|
+
update('PA_old', ParticipantInfo_State.ACTIVE);
|
|
1146
|
+
update('PA_new', ParticipantInfo_State.ACTIVE);
|
|
1147
|
+
update('PA_old', ParticipantInfo_State.ACTIVE);
|
|
1148
|
+
|
|
1149
|
+
expect(room.remoteParticipants.get('tutor')?.sid).toBe('PA_new');
|
|
1150
|
+
expect(disconnected).toEqual([]);
|
|
1151
|
+
expect(forwardedSids()).toEqual(['PA_old', 'PA_new']);
|
|
1152
|
+
});
|
|
1153
|
+
|
|
1154
|
+
it('does not resolve the old sid to the new session', () => {
|
|
1155
|
+
const { room, update } = setup();
|
|
1156
|
+
const getBySid = (sid: string) =>
|
|
1157
|
+
(
|
|
1158
|
+
room as unknown as { getRemoteParticipantBySid: (sid: string) => unknown }
|
|
1159
|
+
).getRemoteParticipantBySid(sid);
|
|
1160
|
+
|
|
1161
|
+
update('PA_old', ParticipantInfo_State.ACTIVE);
|
|
1162
|
+
update('PA_new', ParticipantInfo_State.ACTIVE);
|
|
1163
|
+
|
|
1164
|
+
expect(getBySid('PA_new')).toBe(room.remoteParticipants.get('tutor'));
|
|
1165
|
+
expect(getBySid('PA_old')).toBeUndefined();
|
|
1166
|
+
});
|
|
1167
|
+
|
|
1168
|
+
it('removes the old session when the first update for the new session is DISCONNECTED', () => {
|
|
1169
|
+
const { room, update, disconnected, forwardedSids } = setup();
|
|
1170
|
+
|
|
1171
|
+
update('PA_old', ParticipantInfo_State.ACTIVE);
|
|
1172
|
+
update('PA_new', ParticipantInfo_State.DISCONNECTED, DisconnectReason.CLIENT_INITIATED);
|
|
1173
|
+
|
|
1174
|
+
expect(room.remoteParticipants.has('tutor')).toBe(false);
|
|
1175
|
+
expect(disconnected).toEqual(['PA_old']);
|
|
1176
|
+
expect(forwardedSids()).toEqual(['PA_old', 'PA_new']);
|
|
1177
|
+
});
|
|
1178
|
+
});
|
|
1179
|
+
|
|
1180
|
+
describe('rpc', () => {
|
|
1181
|
+
it('rejects a pending performRpc when the room disconnects', async () => {
|
|
1182
|
+
const room = new Room();
|
|
1183
|
+
room.state = ConnectionState.Connected;
|
|
1184
|
+
vi.spyOn(room.engine, 'sendDataPacket').mockResolvedValue(undefined);
|
|
1185
|
+
|
|
1186
|
+
const response = room.localParticipant.performRpc({
|
|
1187
|
+
destinationIdentity: 'remote',
|
|
1188
|
+
method: 'm',
|
|
1189
|
+
payload: 'p',
|
|
1190
|
+
responseTimeout: 300_000,
|
|
1191
|
+
});
|
|
1192
|
+
const settled = response.then(
|
|
1193
|
+
() => 'resolved',
|
|
1194
|
+
(e: Error) => e.message,
|
|
1195
|
+
);
|
|
1196
|
+
await vi.waitFor(() => expect(room.engine.sendDataPacket).toHaveBeenCalled());
|
|
1197
|
+
|
|
1198
|
+
await room.disconnect();
|
|
1199
|
+
|
|
1200
|
+
expect(await settled).toBe('Connection closed');
|
|
1201
|
+
});
|
|
1202
|
+
});
|