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
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
import type { AddTrackRequest, ConnectionQualityUpdate, JoinResponse, RegionSettings, StreamStateUpdate, SubscriptionPermissionUpdate, SubscriptionResponse } from '@livekit/protocol';
|
|
2
|
+
import { DataPacket, DataTrackSubscriberHandles, DisconnectReason, Encryption_Type, ParticipantInfo, PublishDataTrackResponse, RequestResponse, Room as RoomModel, RoomMovedResponse, ServerInfo, SpeakerInfo, SubscribedQualityUpdate, TrackInfo, TrackUnpublishedResponse, Transcription, UnpublishDataTrackResponse } from '@livekit/protocol';
|
|
3
|
+
import type TypedEventEmitter from 'typed-emitter';
|
|
4
|
+
import type { SignalOptions } from '../api/SignalClient';
|
|
5
|
+
import type { InternalRoomOptions } from '../options';
|
|
6
|
+
import PCTransport from './PCTransport';
|
|
7
|
+
import { PCTransportManager } from './PCTransportManager';
|
|
8
|
+
import { DataChannelKind } from './data-channel/types';
|
|
9
|
+
import type LocalTrack from './track/LocalTrack';
|
|
10
|
+
import type LocalVideoTrack from './track/LocalVideoTrack';
|
|
11
|
+
import type { SimulcastTrackInfo } from './track/LocalVideoTrack';
|
|
12
|
+
import type { TrackPublishOptions, VideoCodec } from './track/options';
|
|
13
|
+
export { DataChannelKind };
|
|
14
|
+
declare const RTCEngine_base: new () => TypedEventEmitter<EngineEventCallbacks>;
|
|
15
|
+
export default class RTCEngine extends RTCEngine_base {
|
|
16
|
+
private options;
|
|
17
|
+
rtcConfig: RTCConfiguration;
|
|
18
|
+
peerConnectionTimeout: number;
|
|
19
|
+
fullReconnectOnNext: boolean;
|
|
20
|
+
pcManager?: PCTransportManager;
|
|
21
|
+
get isClosed(): boolean;
|
|
22
|
+
get isNewlyCreated(): boolean;
|
|
23
|
+
get pendingReconnect(): boolean;
|
|
24
|
+
get serverVersion(): (string | undefined);
|
|
25
|
+
/**
|
|
26
|
+
* Owns the data channels: the three flow-controlled publisher wrappers (engine-lifetime; the
|
|
27
|
+
* RTCDataChannel handles underneath are attached/detached as peer connections come and go, with
|
|
28
|
+
* waiter invalidation built into the turnover) plus the subscriber-side receive handles.
|
|
29
|
+
*/
|
|
30
|
+
private dataChannels;
|
|
31
|
+
private get reliableChannel();
|
|
32
|
+
private get lossyChannel();
|
|
33
|
+
private get dataTrackChannel();
|
|
34
|
+
private subscriberPrimary;
|
|
35
|
+
private pcState;
|
|
36
|
+
private _isClosed;
|
|
37
|
+
private _isNewlyCreated;
|
|
38
|
+
private pendingTrackResolvers;
|
|
39
|
+
private url?;
|
|
40
|
+
private token?;
|
|
41
|
+
private signalOpts?;
|
|
42
|
+
private reconnectAttempts;
|
|
43
|
+
private reconnectStart;
|
|
44
|
+
private clientConfiguration?;
|
|
45
|
+
private attemptingReconnect;
|
|
46
|
+
private reconnectAbortController?;
|
|
47
|
+
/**
|
|
48
|
+
* the attempt of a full reconnect on one region, handed out with `SignalRestarted`. Aborted when
|
|
49
|
+
* the next attempt begins, on the next region or in a later restart, and on close
|
|
50
|
+
*/
|
|
51
|
+
private restartAttemptController?;
|
|
52
|
+
private reconnectPolicy;
|
|
53
|
+
private reconnectTimeout?;
|
|
54
|
+
private participantSid?;
|
|
55
|
+
/** keeps track of how often an initial join connection has been tried */
|
|
56
|
+
private joinAttempts;
|
|
57
|
+
/**
|
|
58
|
+
* When the current join attempt began (`performance.now()`), taken at the top of `join` before
|
|
59
|
+
* the signal connection or the peer connections exist. Every attempt (a join retry, or the join
|
|
60
|
+
* inside a full restart) times itself from scratch. Consumed when the primary transport first
|
|
61
|
+
* connects, to hand the publisher its connection setup time; resumes never set it.
|
|
62
|
+
*/
|
|
63
|
+
private joinStartedAt?;
|
|
64
|
+
/** specifies how often an initial join connection is allowed to retry */
|
|
65
|
+
private maxJoinAttempts;
|
|
66
|
+
private closingLock;
|
|
67
|
+
private dataProcessLock;
|
|
68
|
+
private shouldFailNext;
|
|
69
|
+
private shouldFailOnV1Path;
|
|
70
|
+
private regionStrategy?;
|
|
71
|
+
private log;
|
|
72
|
+
private loggerOptions;
|
|
73
|
+
private publisherConnectionPromise;
|
|
74
|
+
private reliableReceivedState;
|
|
75
|
+
private midToTrackId;
|
|
76
|
+
/** used to indicate whether the browser is currently waiting to reconnect */
|
|
77
|
+
private isWaitingForNetworkReconnect;
|
|
78
|
+
/** set while the local participant's connection quality is `LOST`; forces a full reconnect on timeout */
|
|
79
|
+
private lostQualityTimeout?;
|
|
80
|
+
/** timestamp (ms) the primary transport entered `CONNECTING`, used to bound how long we tolerate it */
|
|
81
|
+
private transportConnectingSince?;
|
|
82
|
+
/**
|
|
83
|
+
* Abort handlers for the in-flight `negotiate()` calls, which a single central
|
|
84
|
+
* Closing/Restarting listener pair fans out to. Registering a listener pair per call instead
|
|
85
|
+
* accumulates them on the engine emitter and trips its max-listener warning under
|
|
86
|
+
* renegotiation bursts.
|
|
87
|
+
*/
|
|
88
|
+
private pendingNegotiationAborts;
|
|
89
|
+
constructor(options: InternalRoomOptions);
|
|
90
|
+
join(url: string, token: string, opts: SignalOptions, abortSignal?: AbortSignal,
|
|
91
|
+
/** setting this to true results in dual peer connection mode being used */
|
|
92
|
+
useV0Path?: boolean): Promise<{
|
|
93
|
+
joinResponse: JoinResponse;
|
|
94
|
+
serverInfo: Partial<ServerInfo>;
|
|
95
|
+
}>;
|
|
96
|
+
/**
|
|
97
|
+
* @param reason why the session is ending, recorded by the signal lifecycle. Worth passing
|
|
98
|
+
* wherever the caller knows more than "someone called close" — the server's leave reason, or
|
|
99
|
+
* having given up on reconnecting.
|
|
100
|
+
*/
|
|
101
|
+
close(reason?: string): Promise<void>;
|
|
102
|
+
cleanupPeerConnections(): Promise<void>;
|
|
103
|
+
cleanupLossyDataStats(): void;
|
|
104
|
+
cleanupClient(reason?: string): Promise<void>;
|
|
105
|
+
addTrack(req: AddTrackRequest): Promise<TrackInfo>;
|
|
106
|
+
/**
|
|
107
|
+
* Removes sender from PeerConnection, returning true if it was removed successfully
|
|
108
|
+
* and a negotiation is necessary
|
|
109
|
+
* @param sender
|
|
110
|
+
* @returns
|
|
111
|
+
*/
|
|
112
|
+
removeTrack(sender: RTCRtpSender): boolean;
|
|
113
|
+
updateMuteStatus(trackSid: string, muted: boolean): void;
|
|
114
|
+
get dataSubscriberReadyState(): (string | undefined);
|
|
115
|
+
getConnectedServerAddress(): Promise<string | undefined>;
|
|
116
|
+
private configure;
|
|
117
|
+
private setupSignalClientCallbacks;
|
|
118
|
+
private makeRTCConfiguration;
|
|
119
|
+
/**
|
|
120
|
+
* Populate the publisher PC so its first offer carries the data channels + recvonly media
|
|
121
|
+
* sections. Required for every V1 connection: Firefox only binds receive decoders for media
|
|
122
|
+
* present in that first offer, and the offer-with-join path needs the sections to
|
|
123
|
+
* build a meaningful initial offer. Must be called on a configured pcManager.
|
|
124
|
+
*/
|
|
125
|
+
private applyInitialPublisherLayout;
|
|
126
|
+
private addMediaSections;
|
|
127
|
+
/**
|
|
128
|
+
* Whether to create the publisher data channels as negotiated (fixed SCTP stream IDs), which
|
|
129
|
+
* lets the server send on them without waiting for our DCEP OPEN. Only in single peer
|
|
130
|
+
* connection mode: with dual peer connections the server opens its own channels anyway.
|
|
131
|
+
*/
|
|
132
|
+
private useNegotiatedDataChannels;
|
|
133
|
+
private createDataChannels;
|
|
134
|
+
private handleDataChannel;
|
|
135
|
+
/** Normalizes an incoming data-channel message into bytes, or logs and returns undefined. */
|
|
136
|
+
private decodeDataMessage;
|
|
137
|
+
private handleDataMessage;
|
|
138
|
+
private handleDataTrackMessage;
|
|
139
|
+
private handleDataError;
|
|
140
|
+
private handleDataChannelClose;
|
|
141
|
+
createSender(track: LocalTrack, opts: TrackPublishOptions, encodings?: RTCRtpEncodingParameters[]): Promise<RTCRtpSender>;
|
|
142
|
+
createSimulcastSender(track: LocalVideoTrack, simulcastTrack: SimulcastTrackInfo, opts: TrackPublishOptions, encodings?: RTCRtpEncodingParameters[]): Promise<RTCRtpSender | undefined>;
|
|
143
|
+
private get frameMetadataWorker();
|
|
144
|
+
private setupFrameMetadataSender;
|
|
145
|
+
private createTransceiverRTCRtpSender;
|
|
146
|
+
private createSimulcastTransceiverSender;
|
|
147
|
+
private createRTCRtpSender;
|
|
148
|
+
private handleDisconnect;
|
|
149
|
+
/**
|
|
150
|
+
* A sustained local `LOST` while connected and publishing means the server isn't receiving
|
|
151
|
+
* our media, so force a full reconnect; any non-`LOST` value cancels a pending trigger.
|
|
152
|
+
*/
|
|
153
|
+
private handleLocalConnectionQuality;
|
|
154
|
+
private scheduleLostQualityReconnect;
|
|
155
|
+
private clearLostQualityTimeout;
|
|
156
|
+
/** Whether the publisher currently has any sender with a live track. */
|
|
157
|
+
private hasActivePublisherSenders;
|
|
158
|
+
private attemptReconnect;
|
|
159
|
+
private getNextRetryDelay;
|
|
160
|
+
private restartConnection;
|
|
161
|
+
private resumeConnection;
|
|
162
|
+
waitForPCInitialConnection(timeout?: number, abortController?: AbortController): Promise<void>;
|
|
163
|
+
private waitForPCReconnected;
|
|
164
|
+
/**
|
|
165
|
+
* resolves to whether the attempt `SignalRestarted` handed out restarted the connection. Call it
|
|
166
|
+
* while handling that event, before `Restarted` can fire
|
|
167
|
+
*/
|
|
168
|
+
waitForRestarted: (restartAttempt: AbortSignal) => Promise<boolean>;
|
|
169
|
+
private resendReliableMessagesForResume;
|
|
170
|
+
/** The flow-control gate for `kind` — see {@link FlowControlledDataChannel}. */
|
|
171
|
+
private flowControlFor;
|
|
172
|
+
/**
|
|
173
|
+
* Resolves once the caller may send on the `kind` channel — see
|
|
174
|
+
* {@link FlowControlledDataChannel.waitForHeadroomWithLock}.
|
|
175
|
+
*/
|
|
176
|
+
waitForBufferHeadroom(kind: DataChannelKind): Promise<void>;
|
|
177
|
+
private ensurePublisherConnected;
|
|
178
|
+
dataChannelForKind(kind: DataChannelKind, sub?: boolean): RTCDataChannel | undefined;
|
|
179
|
+
private onRtpMapAvailable;
|
|
180
|
+
private dataChannelsInfo;
|
|
181
|
+
private clearReconnectTimeout;
|
|
182
|
+
private clearPendingReconnect;
|
|
183
|
+
private handleBrowserOnLine;
|
|
184
|
+
private handleBrowserOffline;
|
|
185
|
+
private registerOnLineListener;
|
|
186
|
+
private deregisterOnLineListener;
|
|
187
|
+
getTrackIdForReceiver(receiver: RTCRtpReceiver): string | undefined;
|
|
188
|
+
}
|
|
189
|
+
export type EngineEventCallbacks = {
|
|
190
|
+
connected: (joinResp: JoinResponse) => void;
|
|
191
|
+
disconnected: (reason?: DisconnectReason) => void;
|
|
192
|
+
resuming: () => void;
|
|
193
|
+
resumed: () => void;
|
|
194
|
+
restarting: () => void;
|
|
195
|
+
restarted: () => void;
|
|
196
|
+
signalResumed: () => void;
|
|
197
|
+
signalRestarted: (joinResp: JoinResponse, restartAttempt: AbortSignal) => void;
|
|
198
|
+
closing: () => void;
|
|
199
|
+
mediaTrackAdded: (track: MediaStreamTrack, streams: MediaStream, receiver: RTCRtpReceiver) => void;
|
|
200
|
+
activeSpeakersUpdate: (speakers: Array<SpeakerInfo>) => void;
|
|
201
|
+
dataPacketReceived: (packet: DataPacket, encryptionType: Encryption_Type) => void;
|
|
202
|
+
transcriptionReceived: (transcription: Transcription) => void;
|
|
203
|
+
transportsCreated: (publisher: PCTransport, subscriber?: PCTransport) => void;
|
|
204
|
+
rtpVideoMapUpdate: (rtpMap: Map<number, VideoCodec>) => void;
|
|
205
|
+
dcBufferStatusChanged: (isLow: boolean, kind: DataChannelKind) => void;
|
|
206
|
+
participantUpdate: (infos: ParticipantInfo[]) => void;
|
|
207
|
+
roomUpdate: (room: RoomModel) => void;
|
|
208
|
+
roomMoved: (room: RoomMovedResponse) => void;
|
|
209
|
+
connectionQualityUpdate: (update: ConnectionQualityUpdate) => void;
|
|
210
|
+
speakersChanged: (speakerUpdates: SpeakerInfo[]) => void;
|
|
211
|
+
streamStateChanged: (update: StreamStateUpdate) => void;
|
|
212
|
+
subscriptionError: (resp: SubscriptionResponse) => void;
|
|
213
|
+
subscriptionPermissionUpdate: (update: SubscriptionPermissionUpdate) => void;
|
|
214
|
+
subscribedQualityUpdate: (update: SubscribedQualityUpdate) => void;
|
|
215
|
+
localTrackUnpublished: (unpublishedResponse: TrackUnpublishedResponse) => void;
|
|
216
|
+
localTrackSubscribed: (trackSid: string) => void;
|
|
217
|
+
remoteMute: (trackSid: string, muted: boolean) => void;
|
|
218
|
+
offline: () => void;
|
|
219
|
+
signalRequestResponse: (response: RequestResponse) => void;
|
|
220
|
+
signalConnected: (joinResp: JoinResponse) => void;
|
|
221
|
+
publishDataTrackResponse: (event: PublishDataTrackResponse) => void;
|
|
222
|
+
unPublishDataTrackResponse: (event: UnpublishDataTrackResponse) => void;
|
|
223
|
+
dataTrackSubscriberHandles: (event: DataTrackSubscriberHandles) => void;
|
|
224
|
+
dataTrackPacketReceived: (packet: Uint8Array) => void;
|
|
225
|
+
joined: (joinResponse: JoinResponse) => void;
|
|
226
|
+
tokenRefreshed: (token: string) => void;
|
|
227
|
+
serverRegionsReported: (regions: RegionSettings) => void;
|
|
228
|
+
requestSubscribedCodecRefresh: () => void;
|
|
229
|
+
};
|
|
230
|
+
export interface RegionStrategy {
|
|
231
|
+
getNextUrl(abortSignal?: AbortSignal): Promise<string | null>;
|
|
232
|
+
resetAttempts(): void;
|
|
233
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/** Controls reconnecting of the client */
|
|
2
|
+
export interface ReconnectPolicy {
|
|
3
|
+
/** Called after disconnect was detected
|
|
4
|
+
*
|
|
5
|
+
* @returns {number | null} Amount of time in milliseconds to delay the next reconnect attempt, `null` signals to stop retrying.
|
|
6
|
+
*/
|
|
7
|
+
nextRetryDelayInMs(context: ReconnectContext): number | null;
|
|
8
|
+
}
|
|
9
|
+
export interface ReconnectContext {
|
|
10
|
+
/**
|
|
11
|
+
* Number of failed reconnect attempts
|
|
12
|
+
*/
|
|
13
|
+
readonly retryCount: number;
|
|
14
|
+
/**
|
|
15
|
+
* Elapsed amount of time in milliseconds since the disconnect.
|
|
16
|
+
*/
|
|
17
|
+
readonly elapsedMs: number;
|
|
18
|
+
/**
|
|
19
|
+
* Reason for retrying
|
|
20
|
+
*/
|
|
21
|
+
readonly retryReason?: Error;
|
|
22
|
+
readonly serverUrl?: string;
|
|
23
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { RegionSettings } from '@livekit/protocol';
|
|
2
|
+
export declare const DEFAULT_MAX_AGE_MS = 5000;
|
|
3
|
+
export declare const STOP_REFETCH_DELAY_MS = 30000;
|
|
4
|
+
type CachedRegionSettings = {
|
|
5
|
+
regionSettings: RegionSettings;
|
|
6
|
+
updatedAtInMs: number;
|
|
7
|
+
maxAgeInMs: number;
|
|
8
|
+
};
|
|
9
|
+
export declare class RegionUrlProvider {
|
|
10
|
+
private static readonly cache;
|
|
11
|
+
private static settingsTimeouts;
|
|
12
|
+
private static connectionTrackers;
|
|
13
|
+
private static fetchLock;
|
|
14
|
+
private static fetchRegionSettings;
|
|
15
|
+
private static scheduleRefetch;
|
|
16
|
+
private static updateCachedRegionSettings;
|
|
17
|
+
private static stopRefetch;
|
|
18
|
+
private static scheduleCleanup;
|
|
19
|
+
private static cancelCleanup;
|
|
20
|
+
notifyConnected(): void;
|
|
21
|
+
notifyDisconnected(): void;
|
|
22
|
+
private serverUrl;
|
|
23
|
+
private token;
|
|
24
|
+
private attemptedRegions;
|
|
25
|
+
constructor(url: string, token: string);
|
|
26
|
+
updateToken(token: string): void;
|
|
27
|
+
isCloud(): boolean;
|
|
28
|
+
getServerUrl(): URL;
|
|
29
|
+
getNextBestRegionUrl(abortSignal?: AbortSignal): Promise<string | null>;
|
|
30
|
+
resetAttempts(): void;
|
|
31
|
+
setServerReportedRegions(settings: CachedRegionSettings): void;
|
|
32
|
+
}
|
|
33
|
+
export {};
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
export interface AgentAttributes {
|
|
2
|
+
'lk.agent.inputs'?: AgentInput[];
|
|
3
|
+
'lk.agent.outputs'?: AgentOutput[];
|
|
4
|
+
'lk.agent.state'?: AgentState;
|
|
5
|
+
'lk.publish_on_behalf'?: string;
|
|
6
|
+
[property: string]: any;
|
|
7
|
+
}
|
|
8
|
+
export type AgentInput = 'audio' | 'video' | 'text';
|
|
9
|
+
export type AgentOutput = 'transcription' | 'audio';
|
|
10
|
+
export type AgentState = 'idle' | 'initializing' | 'listening' | 'thinking' | 'speaking';
|
|
11
|
+
/**
|
|
12
|
+
* Schema for transcription-related attributes
|
|
13
|
+
*/
|
|
14
|
+
export interface TranscriptionAttributes {
|
|
15
|
+
/**
|
|
16
|
+
* The segment id of the transcription
|
|
17
|
+
*/
|
|
18
|
+
'lk.segment_id'?: string;
|
|
19
|
+
/**
|
|
20
|
+
* The associated track id of the transcription
|
|
21
|
+
*/
|
|
22
|
+
'lk.transcribed_track_id'?: string;
|
|
23
|
+
/**
|
|
24
|
+
* Whether the transcription is final
|
|
25
|
+
*/
|
|
26
|
+
'lk.transcription_final'?: boolean;
|
|
27
|
+
[property: string]: any;
|
|
28
|
+
}
|
|
29
|
+
export declare class Convert {
|
|
30
|
+
static toAgentAttributes(json: string): AgentAttributes;
|
|
31
|
+
static agentAttributesToJson(value: AgentAttributes): string;
|
|
32
|
+
static toTranscriptionAttributes(json: string): TranscriptionAttributes;
|
|
33
|
+
static transcriptionAttributesToJson(value: TranscriptionAttributes): string;
|
|
34
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { CoreRoom } from '../CoreRoom';
|
|
2
|
+
import type { DataPacketOwner, ExtensionContext, LocalParticipantApiProvider } from '../extensions';
|
|
3
|
+
import type { ChatMessage, SendTextOptions } from '../types';
|
|
4
|
+
/**
|
|
5
|
+
* Methods the legacy `chat` extension adds to the local participant.
|
|
6
|
+
* @experimental
|
|
7
|
+
*/
|
|
8
|
+
export interface ChatLocalParticipantApi {
|
|
9
|
+
/** @deprecated Consider migrating to {@link sendText} */
|
|
10
|
+
sendChatMessage(text: string, options?: SendTextOptions): Promise<ChatMessage>;
|
|
11
|
+
/** @deprecated Consider migrating to {@link sendText} */
|
|
12
|
+
editChatMessage(editText: string, originalMessage: ChatMessage): Promise<ChatMessage>;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* The legacy chat message packets (`sendChatMessage`, `RoomEvent.ChatMessage`). Superseded by
|
|
16
|
+
* text streams; the full `Room` keeps it, the core entry does not offer it.
|
|
17
|
+
*/
|
|
18
|
+
export declare const chat: {
|
|
19
|
+
key: symbol;
|
|
20
|
+
install(room: CoreRoom, _ctx: ExtensionContext): LocalParticipantApiProvider<ChatLocalParticipantApi> & DataPacketOwner;
|
|
21
|
+
};
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { CoreRoomOptions } from '../options';
|
|
2
|
+
import { CoreRoom } from './CoreRoom';
|
|
3
|
+
import type { ExtensionApis, RoomExtension } from './extensions';
|
|
4
|
+
/**
|
|
5
|
+
* Creates a light room with exactly the given extensions. Dependencies install on their own
|
|
6
|
+
* (`rpc` brings `dataStreams`); an extension you list, configured or not, wins over the default a
|
|
7
|
+
* dependency would pull in. The result carries the extension methods under the names the full
|
|
8
|
+
* `Room` uses, so code moves between the two builds unchanged.
|
|
9
|
+
*
|
|
10
|
+
* @example
|
|
11
|
+
* ```typescript
|
|
12
|
+
* const room = createRoom({ adaptiveStream: true }, [rpc, e2ee({ keyProvider, worker })]);
|
|
13
|
+
* room.registerRpcMethod('greet', handler);
|
|
14
|
+
* await room.connect(url, token);
|
|
15
|
+
* ```
|
|
16
|
+
* @experimental
|
|
17
|
+
*/
|
|
18
|
+
export declare function createRoom<E extends readonly RoomExtension<any, any>[] = [
|
|
19
|
+
]>(options?: CoreRoomOptions, extensions?: E): CoreRoom & ExtensionApis<E[number]>;
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import type { PCTransportManager } from '../PCTransportManager';
|
|
2
|
+
import { FlowControlledDataChannel } from './FlowControlledDataChannel';
|
|
3
|
+
import { LossyDataChannel } from './LossyDataChannel';
|
|
4
|
+
import { ReliableDataChannel } from './ReliableDataChannel';
|
|
5
|
+
import { DataChannelKind } from './types';
|
|
6
|
+
export interface DataChannelManagerOptions {
|
|
7
|
+
/** Whether the owning engine has been closed — a closed engine rejects headroom waiters. */
|
|
8
|
+
isEngineClosed: () => boolean;
|
|
9
|
+
/**
|
|
10
|
+
* Whether a reconnect attempt is underway: reliable sends defer to the resume replay and lossy
|
|
11
|
+
* sends are skipped while this is true.
|
|
12
|
+
*/
|
|
13
|
+
isReconnecting: () => boolean;
|
|
14
|
+
onDataMessage: (message: MessageEvent) => void;
|
|
15
|
+
onDataTrackMessage: (message: MessageEvent) => void;
|
|
16
|
+
onDataError: (event: Event) => void;
|
|
17
|
+
onChannelClose: (kind: DataChannelKind) => void;
|
|
18
|
+
/** A channel's buffer crossed its low-water mark (debounced). Drives DCBufferStatusChanged. */
|
|
19
|
+
onBufferStatusChanged: (kind: DataChannelKind, isLow: boolean) => void;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Owns the engine's data channels: the three flow-controlled publisher channel wrappers (which
|
|
23
|
+
* live for the engine's lifetime and have RTCDataChannel handles attached/detached as peer
|
|
24
|
+
* connections come and go) plus the subscriber-side receive handles adopted by label.
|
|
25
|
+
*
|
|
26
|
+
* Handle turnover goes through {@link FlowControlledDataChannel.attach}/`detach`, which close the
|
|
27
|
+
* released handle and reject parked headroom waiters as a built-in — there is no separate
|
|
28
|
+
* invalidation step to forget.
|
|
29
|
+
*/
|
|
30
|
+
export declare class DataChannelManager {
|
|
31
|
+
readonly reliable: ReliableDataChannel;
|
|
32
|
+
readonly lossy: LossyDataChannel;
|
|
33
|
+
readonly dataTrack: LossyDataChannel;
|
|
34
|
+
private reliableSub?;
|
|
35
|
+
private lossySub?;
|
|
36
|
+
private dataTrackSub?;
|
|
37
|
+
private opts;
|
|
38
|
+
private negotiated;
|
|
39
|
+
constructor(opts: DataChannelManagerOptions);
|
|
40
|
+
/** The flow-control wrapper for `kind`. */
|
|
41
|
+
channelFor(kind: DataChannelKind): FlowControlledDataChannel;
|
|
42
|
+
/** The raw RTCDataChannel handle for `kind`, publisher side by default. */
|
|
43
|
+
getHandle(kind: DataChannelKind, subscriber?: boolean): RTCDataChannel | undefined;
|
|
44
|
+
get hasPublisherChannels(): boolean;
|
|
45
|
+
get publisherChannelsNegotiated(): boolean;
|
|
46
|
+
/**
|
|
47
|
+
* Creates the three publisher data channels on the given transport, wires their handlers, and
|
|
48
|
+
* attaches them to the wrappers — attaching closes any replaced channel objects and rejects the
|
|
49
|
+
* waiters still parked on them.
|
|
50
|
+
*
|
|
51
|
+
* With `negotiated`, the channels use fixed SCTP stream IDs agreed with the server instead of
|
|
52
|
+
* the in-band DCEP open handshake, so the server can send on them right away.
|
|
53
|
+
*/
|
|
54
|
+
createPublisherChannels(pcManager: PCTransportManager, negotiated?: boolean): void;
|
|
55
|
+
/**
|
|
56
|
+
* Adopts a subscriber-side data channel by label, wiring the matching receive handler.
|
|
57
|
+
* Returns false for labels this manager doesn't own.
|
|
58
|
+
*/
|
|
59
|
+
adoptSubscriberChannel(channel: RTCDataChannel): boolean;
|
|
60
|
+
/**
|
|
61
|
+
* Tears down all channels for a peer-connection cleanup: strips handlers, closes the handles,
|
|
62
|
+
* and resets the reliable session state. Detaching the publisher handles closes them and
|
|
63
|
+
* rejects parked waiters (the spec allows `pc.close()` to transition channels to 'closed'
|
|
64
|
+
* without firing events, so waiting for browser close events is not an option).
|
|
65
|
+
*/
|
|
66
|
+
teardown(): void;
|
|
67
|
+
}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
import type { DataChannelKind } from './types';
|
|
2
|
+
export interface FlowControlledDataChannelOptions {
|
|
3
|
+
kind: DataChannelKind;
|
|
4
|
+
/** Buffer level (bytes) at which blocked senders resume; armed as `bufferedAmountLowThreshold`. */
|
|
5
|
+
lowWaterMark: number;
|
|
6
|
+
/** Buffer level (bytes) above which senders block until the buffer drains to the low mark. */
|
|
7
|
+
highWaterMark: number;
|
|
8
|
+
/** Whether the owning engine has been closed — a closed engine rejects waiters immediately. */
|
|
9
|
+
isEngineClosed: () => boolean;
|
|
10
|
+
/**
|
|
11
|
+
* Notified when the buffer crosses the low-water mark in either direction (debounced: fires only
|
|
12
|
+
* on an actual change). Drives the engine's public DCBufferStatusChanged event.
|
|
13
|
+
*/
|
|
14
|
+
onBufferStatusChanged?: (isLow: boolean) => void;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Two-watermark flow control for one data channel kind.
|
|
18
|
+
*
|
|
19
|
+
* Owns the per-kind headroom gate: senders proceed freely while the buffer is at or below the
|
|
20
|
+
* high-water mark and otherwise block — serialized FIFO through a mutex — until the browser's
|
|
21
|
+
* `bufferedamountlow` event (armed at the low-water mark) signals the buffer has drained. The
|
|
22
|
+
* serialization prevents woken senders from all refilling at once and overflowing the SCTP send
|
|
23
|
+
* buffer (see livekit/client-sdk-js#1995).
|
|
24
|
+
*
|
|
25
|
+
* Waiters are parked on the channel object captured at wait entry. If that object stops being
|
|
26
|
+
* current — replaced or torn down — its events may never fire again, so the owner must call
|
|
27
|
+
* {@link invalidateWaiters}, which aborts parked waiters (releasing the gate); the next waiter
|
|
28
|
+
* gets a fresh controller. {@link attach} and {@link detach} do this, and close the released
|
|
29
|
+
* handle, as part of handle turnover.
|
|
30
|
+
*/
|
|
31
|
+
export declare class FlowControlledDataChannel {
|
|
32
|
+
readonly kind: DataChannelKind;
|
|
33
|
+
readonly lowWaterMark: number;
|
|
34
|
+
readonly highWaterMark: number;
|
|
35
|
+
protected isEngineClosed: () => boolean;
|
|
36
|
+
private onBufferStatusChanged?;
|
|
37
|
+
/** Last emitted low-water status; starts true (an empty buffer is below the mark). */
|
|
38
|
+
private bufferStatusLow;
|
|
39
|
+
private handle?;
|
|
40
|
+
private headroomLock;
|
|
41
|
+
/** Cancels parked headroom waiters when the handle is replaced or torn down. */
|
|
42
|
+
private waiterAbortController;
|
|
43
|
+
constructor(opts: FlowControlledDataChannelOptions);
|
|
44
|
+
get channelHandle(): (RTCDataChannel | undefined);
|
|
45
|
+
/**
|
|
46
|
+
* Attaches the channel handle this wrapper controls. Replacing an existing handle closes it and
|
|
47
|
+
* rejects parked waiters — their events would never fire again on the abandoned object — and
|
|
48
|
+
* installs a fresh controller. Wrappers outlive their handles: this is the one place handle
|
|
49
|
+
* turnover happens, so a handle the wrapper lets go of is never left open, and stranding a
|
|
50
|
+
* waiter is structurally impossible.
|
|
51
|
+
*/
|
|
52
|
+
attach(dc: RTCDataChannel): void;
|
|
53
|
+
/** Detaches and closes the handle on teardown, rejecting parked waiters. */
|
|
54
|
+
detach(reason?: string): void;
|
|
55
|
+
/**
|
|
56
|
+
* Closes a handle the wrapper no longer controls. `close()` moves it to `closing` synchronously,
|
|
57
|
+
* so senders still holding it (queued on the headroom lock) fail the open check once they get
|
|
58
|
+
* the lock. Parked waiters are aborted directly instead of relying on the `close` event, which
|
|
59
|
+
* fires asynchronously, if at all (the spec lets `pc.close()` skip it). Strip any handlers that
|
|
60
|
+
* must not observe the close before calling this.
|
|
61
|
+
*/
|
|
62
|
+
private release;
|
|
63
|
+
protected getChannel(): RTCDataChannel | undefined;
|
|
64
|
+
/**
|
|
65
|
+
* Whether the send buffer has room to accept more data (the send gate). Senders proceed while
|
|
66
|
+
* this is true and block once it goes false. Callers resolve the handle (and decide what an
|
|
67
|
+
* absent one means) before asking.
|
|
68
|
+
*/
|
|
69
|
+
isBelowHighWaterMark(dc: RTCDataChannel): boolean;
|
|
70
|
+
/**
|
|
71
|
+
* Whether the send buffer has drained to its low-water mark. Drives the engine's public
|
|
72
|
+
* DCBufferStatusChanged event.
|
|
73
|
+
*/
|
|
74
|
+
isBelowLowWaterMark(dc: RTCDataChannel): boolean;
|
|
75
|
+
/**
|
|
76
|
+
* Acquires the headroom lock, resolving with the unlock function. Batch senders (the resume
|
|
77
|
+
* replay) hold it across all of their sends so no other sender can interleave, calling
|
|
78
|
+
* {@link waitForHeadroomWithoutLock} per message to respect flow control within the batch.
|
|
79
|
+
*/
|
|
80
|
+
lockHeadroom(): Promise<() => void>;
|
|
81
|
+
/**
|
|
82
|
+
* Resolves once the caller may send on `dc`: immediately while its send buffer is at or below
|
|
83
|
+
* the high-water mark, otherwise once the buffer has drained to the low-water mark (the
|
|
84
|
+
* `bufferedamountlow` event). Callers are serialized through the headroom lock so that, when
|
|
85
|
+
* the buffer drains, they refill it one at a time (up to the high-water mark) rather than all
|
|
86
|
+
* sending at once and overflowing the SCTP send buffer (see livekit/client-sdk-js#1995). The
|
|
87
|
+
* checks run inside the lock so queued callers proceed in FIFO order.
|
|
88
|
+
*
|
|
89
|
+
* The caller passes the handle it resolved before queueing, and the wait is against that one
|
|
90
|
+
* handle throughout: if it was replaced meanwhile, it has been closed, so the wait rejects
|
|
91
|
+
* rather than letting the caller send on the replacement out of turn.
|
|
92
|
+
*/
|
|
93
|
+
waitForHeadroomWithLock(dc: RTCDataChannel): Promise<void>;
|
|
94
|
+
/** Core wait of {@link waitForHeadroomWithLock}. The caller must hold the headroom lock. */
|
|
95
|
+
waitForHeadroomWithoutLock(dc: RTCDataChannel): Promise<void>;
|
|
96
|
+
/** Rejects all parked headroom waiters; the next waiter gets a fresh controller. */
|
|
97
|
+
invalidateWaiters(reason: string): void;
|
|
98
|
+
/**
|
|
99
|
+
* Recomputes whether the buffer has drained to the low-water mark and, if that changed since the
|
|
100
|
+
* last check, notifies the status listener. Two independent triggers land here: a send (which
|
|
101
|
+
* raises the buffer) and the `bufferedamountlow` drain event (which lowers it) — the latter has
|
|
102
|
+
* no send to hang the work off, which is why this is a shared entry point rather than a tail of
|
|
103
|
+
* `send`.
|
|
104
|
+
*/
|
|
105
|
+
refreshBufferStatus(): void;
|
|
106
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
|
|
2
|
+
import type { FlowControlledDataChannelOptions } from './FlowControlledDataChannel';
|
|
3
|
+
import { FlowControlledDataChannel } from './FlowControlledDataChannel';
|
|
4
|
+
export interface LossyDataChannelOptions extends FlowControlledDataChannelOptions {
|
|
5
|
+
/**
|
|
6
|
+
* What to do with a send while the buffer is full: `drop` discards it to keep latency bounded
|
|
7
|
+
* (the classic lossy channel), `wait` backpressures the producer until there is headroom (the
|
|
8
|
+
* data-track channel, whose producer decides what to skip at frame granularity).
|
|
9
|
+
*/
|
|
10
|
+
bufferFullBehavior: 'drop' | 'wait';
|
|
11
|
+
/** Sends are silently discarded while this is true (a reconnect attempt is underway). */
|
|
12
|
+
shouldSkipSends: () => boolean;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* A lossy channel: flow control plus a per-instance full-buffer policy.
|
|
16
|
+
*
|
|
17
|
+
* Each instance owns its own byterate stat, drop counter, and (when tuning is started) the
|
|
18
|
+
* dynamic `bufferedAmountLowThreshold` adjustment that keeps the drop gate at roughly 100ms of
|
|
19
|
+
* buffered latency. Keeping these per instance is what prevents one channel's traffic from
|
|
20
|
+
* steering another channel's policy.
|
|
21
|
+
*/
|
|
22
|
+
export declare class LossyDataChannel extends FlowControlledDataChannel {
|
|
23
|
+
private bufferFullBehavior;
|
|
24
|
+
private shouldSkipSends;
|
|
25
|
+
private statCurrentBytes;
|
|
26
|
+
private statByterate;
|
|
27
|
+
private statInterval;
|
|
28
|
+
private dropCount;
|
|
29
|
+
constructor(opts: LossyDataChannelOptions);
|
|
30
|
+
/** Sends prepared bytes with this channel's full-buffer policy (drop or wait). */
|
|
31
|
+
send(msg: NonSharedUint8Array): Promise<void>;
|
|
32
|
+
/**
|
|
33
|
+
* Starts the once-per-second adjustment of the channel's `bufferedAmountLowThreshold` to the
|
|
34
|
+
* observed byterate, keeping the drop gate at roughly 100ms of buffered latency (clamped to
|
|
35
|
+
* the watermarks). Restarts cleanly if already running.
|
|
36
|
+
*/
|
|
37
|
+
startThresholdTuning(): void;
|
|
38
|
+
/** Stops the threshold tuning and resets the stats and drop counter. */
|
|
39
|
+
stopThresholdTuning(): void;
|
|
40
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
|
|
2
|
+
import type { FlowControlledDataChannelOptions } from './FlowControlledDataChannel';
|
|
3
|
+
import { FlowControlledDataChannel } from './FlowControlledDataChannel';
|
|
4
|
+
export interface ReliableDataChannelOptions extends FlowControlledDataChannelOptions {
|
|
5
|
+
/**
|
|
6
|
+
* Whether sends should currently be deferred to the resume replay instead of hitting the wire
|
|
7
|
+
* (i.e. a reconnect attempt is underway). Read at send time so the reliable channel matches the
|
|
8
|
+
* engine's reconnect state without owning it.
|
|
9
|
+
*/
|
|
10
|
+
isDeferringSends: () => boolean;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* The reliable channel: flow control plus delivery-across-resume semantics.
|
|
14
|
+
*
|
|
15
|
+
* Every packet gets a monotonic sequence (stamped into the protobuf by the caller before
|
|
16
|
+
* serialization, via {@link nextSequence}) and is retained in a replay buffer until the channel's
|
|
17
|
+
* `bufferedAmount` confirms it has been handed to the transport. Sends that land in a reconnect
|
|
18
|
+
* window — or whose headroom wait is torn down transiently — are queued unsent and resolve;
|
|
19
|
+
* {@link replay} delivers them (plus any unacked packets) after a resume. Only an engine close
|
|
20
|
+
* rejects, because no replay is coming after that.
|
|
21
|
+
*/
|
|
22
|
+
export declare class ReliableDataChannel extends FlowControlledDataChannel {
|
|
23
|
+
private messageBuffer;
|
|
24
|
+
private sequence;
|
|
25
|
+
private isDeferringSends;
|
|
26
|
+
constructor(opts: ReliableDataChannelOptions);
|
|
27
|
+
/**
|
|
28
|
+
* Claims the next packet sequence. The caller stamps it into the packet before serialization,
|
|
29
|
+
* then passes it back to {@link send} so the replay buffer stays keyed by wire sequence.
|
|
30
|
+
*/
|
|
31
|
+
nextSequence(): number;
|
|
32
|
+
/**
|
|
33
|
+
* Sends prepared bytes with reliable semantics. Resolves once the packet has either been handed
|
|
34
|
+
* to the channel or queued for the resume replay; throws only when the engine is closed.
|
|
35
|
+
*/
|
|
36
|
+
send(msg: NonSharedUint8Array, sequence: number): Promise<void>;
|
|
37
|
+
/**
|
|
38
|
+
* Replays the buffered backlog after a resume: drops everything the server acked
|
|
39
|
+
* (`lastMessageSeq`), then re-sends the rest in order. The headroom lock is held across the
|
|
40
|
+
* whole replay — releasing it between messages would let a concurrent send (whose newer
|
|
41
|
+
* sequence was already assigned before it queued on the lock) hit the wire mid-replay, and
|
|
42
|
+
* receivers would then discard the remaining lower-sequence resent messages as duplicates.
|
|
43
|
+
*/
|
|
44
|
+
replay(lastMessageSeq: number): Promise<void>;
|
|
45
|
+
/**
|
|
46
|
+
* Before recomputing status, trim packets the transport has now delivered — a send or a drain
|
|
47
|
+
* may have acked buffered packets, and the replay buffer is keyed off the channel's buffered
|
|
48
|
+
* bytes.
|
|
49
|
+
*/
|
|
50
|
+
refreshBufferStatus(): void;
|
|
51
|
+
/**
|
|
52
|
+
* Drops all replay state and restarts sequencing. Only valid on a full reconnect, where the
|
|
53
|
+
* session (and the receivers' sequence tracking) starts over.
|
|
54
|
+
*/
|
|
55
|
+
reset(): void;
|
|
56
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export declare enum DataChannelKind {
|
|
2
|
+
RELIABLE = 0,
|
|
3
|
+
LOSSY = 1,
|
|
4
|
+
DATA_TRACK_LOSSY = 2
|
|
5
|
+
}
|
|
6
|
+
export declare const reliableDataChannelWaterMarkLow: number;
|
|
7
|
+
export declare const reliableDataChannelWaterMarkHigh: number;
|
|
8
|
+
export declare const lossyDataChannelWaterMarkLow: number;
|
|
9
|
+
export declare const lossyDataChannelWaterMarkHigh: number;
|
|
10
|
+
export declare function dataChannelLowWaterMark(kind: DataChannelKind): number;
|
|
11
|
+
export declare function dataChannelHighWaterMark(kind: DataChannelKind): number;
|