livekit-client 2.23.0 → 2.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +48 -32
- package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs +48 -0
- package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs.map +1 -0
- package/dist/core/api/SignalClient.mjs +1212 -0
- package/dist/core/api/SignalClient.mjs.map +1 -0
- package/dist/core/api/SignalClientStateMachine.mjs +115 -0
- package/dist/core/api/SignalClientStateMachine.mjs.map +1 -0
- package/dist/core/api/WebSocketStream.mjs +146 -0
- package/dist/core/api/WebSocketStream.mjs.map +1 -0
- package/dist/core/api/utils.mjs +66 -0
- package/dist/core/api/utils.mjs.map +1 -0
- package/dist/core/connectionHelper/ConnectionCheck.mjs +89 -0
- package/dist/core/connectionHelper/ConnectionCheck.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/Checker.mjs +146 -0
- package/dist/core/connectionHelper/checks/Checker.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/cloudRegion.mjs +82 -0
- package/dist/core/connectionHelper/checks/cloudRegion.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/connectionProtocol.mjs +111 -0
- package/dist/core/connectionHelper/checks/connectionProtocol.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/publishAudio.mjs +35 -0
- package/dist/core/connectionHelper/checks/publishAudio.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/publishVideo.mjs +82 -0
- package/dist/core/connectionHelper/checks/publishVideo.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/reconnect.mjs +37 -0
- package/dist/core/connectionHelper/checks/reconnect.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/turn.mjs +56 -0
- package/dist/core/connectionHelper/checks/turn.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/webrtc.mjs +73 -0
- package/dist/core/connectionHelper/checks/webrtc.mjs.map +1 -0
- package/dist/core/connectionHelper/checks/websocket.mjs +47 -0
- package/dist/core/connectionHelper/checks/websocket.mjs.map +1 -0
- package/dist/core/core.mjs +1 -0
- package/dist/core/core.mjs.map +1 -0
- package/dist/core/e2ee/E2eeManager.mjs +603 -0
- package/dist/core/e2ee/E2eeManager.mjs.map +1 -0
- package/dist/core/e2ee/KeyProvider.mjs +95 -0
- package/dist/core/e2ee/KeyProvider.mjs.map +1 -0
- package/dist/core/e2ee/constants.mjs +19 -0
- package/dist/core/e2ee/constants.mjs.map +1 -0
- package/dist/core/e2ee/errors.mjs +15 -0
- package/dist/core/e2ee/errors.mjs.map +1 -0
- package/dist/core/e2ee/events.mjs +24 -0
- package/dist/core/e2ee/events.mjs.map +1 -0
- package/dist/core/e2ee/extension.mjs +70 -0
- package/dist/core/e2ee/extension.mjs.map +1 -0
- package/dist/core/e2ee/utils.mjs +168 -0
- package/dist/core/e2ee/utils.mjs.map +1 -0
- package/dist/core/frameMetadata/FrameMetadataManager.mjs +205 -0
- package/dist/core/frameMetadata/FrameMetadataManager.mjs.map +1 -0
- package/dist/core/frameMetadata/extension.mjs +17 -0
- package/dist/core/frameMetadata/extension.mjs.map +1 -0
- package/dist/core/frameMetadata/utils.mjs +42 -0
- package/dist/core/frameMetadata/utils.mjs.map +1 -0
- package/dist/core/logger.mjs +111 -0
- package/dist/core/logger.mjs.map +1 -0
- package/dist/core/package.json.mjs +1 -0
- package/dist/core/package.json.mjs.map +1 -0
- package/dist/core/room/BackOffStrategy.mjs +60 -0
- package/dist/core/room/BackOffStrategy.mjs.map +1 -0
- package/dist/core/room/CoreRoom.mjs +2279 -0
- package/dist/core/room/CoreRoom.mjs.map +1 -0
- package/dist/core/room/DefaultReconnectPolicy.mjs +23 -0
- package/dist/core/room/DefaultReconnectPolicy.mjs.map +1 -0
- package/dist/core/room/DeviceManager.mjs +92 -0
- package/dist/core/room/DeviceManager.mjs.map +1 -0
- package/dist/core/room/PCTransport.mjs +1110 -0
- package/dist/core/room/PCTransport.mjs.map +1 -0
- package/dist/core/room/PCTransportManager.mjs +360 -0
- package/dist/core/room/PCTransportManager.mjs.map +1 -0
- package/dist/core/room/RTCEngine.mjs +1830 -0
- package/dist/core/room/RTCEngine.mjs.map +1 -0
- package/dist/core/room/RegionUrlProvider.mjs +194 -0
- package/dist/core/room/RegionUrlProvider.mjs.map +1 -0
- package/dist/core/room/attribute-typings.mjs +24 -0
- package/dist/core/room/attribute-typings.mjs.map +1 -0
- package/dist/core/room/createRoom.mjs +19 -0
- package/dist/core/room/createRoom.mjs.map +1 -0
- package/dist/core/room/data-channel/DataChannelManager.mjs +188 -0
- package/dist/core/room/data-channel/DataChannelManager.mjs.map +1 -0
- package/dist/core/room/data-channel/FlowControlledDataChannel.mjs +185 -0
- package/dist/core/room/data-channel/FlowControlledDataChannel.mjs.map +1 -0
- package/dist/core/room/data-channel/LossyDataChannel.mjs +99 -0
- package/dist/core/room/data-channel/LossyDataChannel.mjs.map +1 -0
- package/dist/core/room/data-channel/ReliableDataChannel.mjs +150 -0
- package/dist/core/room/data-channel/ReliableDataChannel.mjs.map +1 -0
- package/dist/core/room/data-channel/types.mjs +22 -0
- package/dist/core/room/data-channel/types.mjs.map +1 -0
- package/dist/core/room/data-stream/compression.mjs +68 -0
- package/dist/core/room/data-stream/compression.mjs.map +1 -0
- package/dist/core/room/data-stream/constants.mjs +26 -0
- package/dist/core/room/data-stream/constants.mjs.map +1 -0
- package/dist/core/room/data-stream/extension.mjs +42 -0
- package/dist/core/room/data-stream/extension.mjs.map +1 -0
- package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs +500 -0
- package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs.map +1 -0
- package/dist/core/room/data-stream/incoming/StreamReader.mjs +279 -0
- package/dist/core/room/data-stream/incoming/StreamReader.mjs.map +1 -0
- package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs +543 -0
- package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs.map +1 -0
- package/dist/core/room/data-stream/outgoing/StreamWriter.mjs +21 -0
- package/dist/core/room/data-stream/outgoing/StreamWriter.mjs.map +1 -0
- package/dist/core/room/data-stream/outgoing/header-utils.mjs +53 -0
- package/dist/core/room/data-stream/outgoing/header-utils.mjs.map +1 -0
- package/dist/core/room/data-track/LocalDataTrack.mjs +146 -0
- package/dist/core/room/data-track/LocalDataTrack.mjs.map +1 -0
- package/dist/core/room/data-track/RemoteDataTrack.mjs +51 -0
- package/dist/core/room/data-track/RemoteDataTrack.mjs.map +1 -0
- package/dist/core/room/data-track/depacketizer.mjs +193 -0
- package/dist/core/room/data-track/depacketizer.mjs.map +1 -0
- package/dist/core/room/data-track/extension.mjs +154 -0
- package/dist/core/room/data-track/extension.mjs.map +1 -0
- package/dist/core/room/data-track/frame.mjs +19 -0
- package/dist/core/room/data-track/frame.mjs.map +1 -0
- package/dist/core/room/data-track/handle.mjs +50 -0
- package/dist/core/room/data-track/handle.mjs.map +1 -0
- package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs +618 -0
- package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs.map +1 -0
- package/dist/core/room/data-track/incoming/errors.mjs +32 -0
- package/dist/core/room/data-track/incoming/errors.mjs.map +1 -0
- package/dist/core/room/data-track/incoming/pipeline.mjs +85 -0
- package/dist/core/room/data-track/incoming/pipeline.mjs.map +1 -0
- package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs +351 -0
- package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs.map +1 -0
- package/dist/core/room/data-track/outgoing/errors.mjs +114 -0
- package/dist/core/room/data-track/outgoing/errors.mjs.map +1 -0
- package/dist/core/room/data-track/outgoing/pipeline.mjs +41 -0
- package/dist/core/room/data-track/outgoing/pipeline.mjs.map +1 -0
- package/dist/core/room/data-track/packet/constants.mjs +21 -0
- package/dist/core/room/data-track/packet/constants.mjs.map +1 -0
- package/dist/core/room/data-track/packet/errors.mjs +56 -0
- package/dist/core/room/data-track/packet/errors.mjs.map +1 -0
- package/dist/core/room/data-track/packet/extensions.mjs +172 -0
- package/dist/core/room/data-track/packet/extensions.mjs.map +1 -0
- package/dist/core/room/data-track/packet/index.mjs +242 -0
- package/dist/core/room/data-track/packet/index.mjs.map +1 -0
- package/dist/core/room/data-track/packet/serializable.mjs +15 -0
- package/dist/core/room/data-track/packet/serializable.mjs.map +1 -0
- package/dist/core/room/data-track/packetizer.mjs +77 -0
- package/dist/core/room/data-track/packetizer.mjs.map +1 -0
- package/dist/core/room/data-track/track-interfaces.mjs +2 -0
- package/dist/core/room/data-track/track-interfaces.mjs.map +1 -0
- package/dist/core/room/data-track/types.mjs +18 -0
- package/dist/core/room/data-track/types.mjs.map +1 -0
- package/dist/core/room/data-track/utils.mjs +149 -0
- package/dist/core/room/data-track/utils.mjs.map +1 -0
- package/dist/core/room/debounce.mjs +97 -0
- package/dist/core/room/debounce.mjs.map +1 -0
- package/dist/core/room/defaults.mjs +34 -0
- package/dist/core/room/defaults.mjs.map +1 -0
- package/dist/core/room/errors.mjs +208 -0
- package/dist/core/room/errors.mjs.map +1 -0
- package/dist/core/room/events.mjs +643 -0
- package/dist/core/room/events.mjs.map +1 -0
- package/dist/core/room/extensions.mjs +48 -0
- package/dist/core/room/extensions.mjs.map +1 -0
- package/dist/core/room/participant/LocalParticipant.mjs +1324 -0
- package/dist/core/room/participant/LocalParticipant.mjs.map +1 -0
- package/dist/core/room/participant/Participant.mjs +300 -0
- package/dist/core/room/participant/Participant.mjs.map +1 -0
- package/dist/core/room/participant/ParticipantTrackPermission.mjs +12 -0
- package/dist/core/room/participant/ParticipantTrackPermission.mjs.map +1 -0
- package/dist/core/room/participant/RemoteParticipant.mjs +287 -0
- package/dist/core/room/participant/RemoteParticipant.mjs.map +1 -0
- package/dist/core/room/participant/publishUtils.mjs +356 -0
- package/dist/core/room/participant/publishUtils.mjs.map +1 -0
- package/dist/core/room/rpc/client/RpcClientManager.mjs +216 -0
- package/dist/core/room/rpc/client/RpcClientManager.mjs.map +1 -0
- package/dist/core/room/rpc/extension.mjs +82 -0
- package/dist/core/room/rpc/extension.mjs.map +1 -0
- package/dist/core/room/rpc/server/RpcServerManager.mjs +186 -0
- package/dist/core/room/rpc/server/RpcServerManager.mjs.map +1 -0
- package/dist/core/room/rpc/utils.mjs +148 -0
- package/dist/core/room/rpc/utils.mjs.map +1 -0
- package/dist/core/room/simulated-participants/extension.mjs +105 -0
- package/dist/core/room/simulated-participants/extension.mjs.map +1 -0
- package/dist/core/room/stats.mjs +19 -0
- package/dist/core/room/stats.mjs.map +1 -0
- package/dist/core/room/statsSummary.mjs +165 -0
- package/dist/core/room/statsSummary.mjs.map +1 -0
- package/dist/core/room/timers.mjs +20 -0
- package/dist/core/room/timers.mjs.map +1 -0
- package/dist/core/room/token-source/TokenSource.mjs +230 -0
- package/dist/core/room/token-source/TokenSource.mjs.map +1 -0
- package/dist/core/room/token-source/types.mjs +18 -0
- package/dist/core/room/token-source/types.mjs.map +1 -0
- package/dist/core/room/token-source/utils.mjs +76 -0
- package/dist/core/room/token-source/utils.mjs.map +1 -0
- package/dist/core/room/track/FrameMetadataExtractor.mjs +36 -0
- package/dist/core/room/track/FrameMetadataExtractor.mjs.map +1 -0
- package/dist/core/room/track/LocalAudioTrack.mjs +327 -0
- package/dist/core/room/track/LocalAudioTrack.mjs.map +1 -0
- package/dist/core/room/track/LocalTrack.mjs +694 -0
- package/dist/core/room/track/LocalTrack.mjs.map +1 -0
- package/dist/core/room/track/LocalTrackPublication.mjs +111 -0
- package/dist/core/room/track/LocalTrackPublication.mjs.map +1 -0
- package/dist/core/room/track/LocalVideoTrack.mjs +810 -0
- package/dist/core/room/track/LocalVideoTrack.mjs.map +1 -0
- package/dist/core/room/track/RemoteAudioTrack.mjs +245 -0
- package/dist/core/room/track/RemoteAudioTrack.mjs.map +1 -0
- package/dist/core/room/track/RemoteTrack.mjs +143 -0
- package/dist/core/room/track/RemoteTrack.mjs.map +1 -0
- package/dist/core/room/track/RemoteTrackPublication.mjs +284 -0
- package/dist/core/room/track/RemoteTrackPublication.mjs.map +1 -0
- package/dist/core/room/track/RemoteVideoTrack.mjs +384 -0
- package/dist/core/room/track/RemoteVideoTrack.mjs.map +1 -0
- package/dist/core/room/track/Track.mjs +413 -0
- package/dist/core/room/track/Track.mjs.map +1 -0
- package/dist/core/room/track/TrackPublication.mjs +97 -0
- package/dist/core/room/track/TrackPublication.mjs.map +1 -0
- package/dist/core/room/track/create.mjs +142 -0
- package/dist/core/room/track/create.mjs.map +1 -0
- package/dist/core/room/track/facingMode.mjs +81 -0
- package/dist/core/room/track/facingMode.mjs.map +1 -0
- package/dist/core/room/track/options.mjs +109 -0
- package/dist/core/room/track/options.mjs.map +1 -0
- package/dist/core/room/track/record.mjs +67 -0
- package/dist/core/room/track/record.mjs.map +1 -0
- package/dist/core/room/track/utils.mjs +429 -0
- package/dist/core/room/track/utils.mjs.map +1 -0
- package/dist/core/room/utils.mjs +852 -0
- package/dist/core/room/utils.mjs.map +1 -0
- package/dist/core/room/video/create.mjs +71 -0
- package/dist/core/room/video/create.mjs.map +1 -0
- package/dist/core/room/video/extension.mjs +27 -0
- package/dist/core/room/video/extension.mjs.map +1 -0
- package/dist/core/room/video/publisher.mjs +343 -0
- package/dist/core/room/video/publisher.mjs.map +1 -0
- package/dist/core/ts4.2/api/SignalClient.d.ts +19 -0
- package/dist/core/ts4.2/api/SignalClientStateMachine.d.ts +84 -0
- package/dist/core/ts4.2/api/WebSocketStream.d.ts +33 -0
- package/dist/core/ts4.2/api/utils.d.ts +8 -0
- package/dist/core/ts4.2/connectionHelper/ConnectionCheck.d.ts +29 -0
- package/dist/core/ts4.2/connectionHelper/checks/Checker.d.ts +64 -0
- package/dist/core/ts4.2/connectionHelper/checks/cloudRegion.d.ts +17 -0
- package/dist/core/ts4.2/connectionHelper/checks/connectionProtocol.d.ts +19 -0
- package/dist/core/ts4.2/connectionHelper/checks/publishAudio.d.ts +5 -0
- package/dist/core/ts4.2/connectionHelper/checks/publishVideo.d.ts +6 -0
- package/dist/core/ts4.2/connectionHelper/checks/reconnect.d.ts +5 -0
- package/dist/core/ts4.2/connectionHelper/checks/turn.d.ts +5 -0
- package/dist/core/ts4.2/connectionHelper/checks/webrtc.d.ts +5 -0
- package/dist/core/ts4.2/connectionHelper/checks/websocket.d.ts +5 -0
- package/dist/core/ts4.2/core.d.ts +33 -0
- package/dist/core/ts4.2/e2ee/E2eeManager.d.ts +89 -0
- package/dist/core/ts4.2/e2ee/KeyProvider.d.ts +53 -0
- package/dist/core/ts4.2/e2ee/constants.d.ts +20 -0
- package/dist/core/ts4.2/e2ee/errors.d.ts +11 -0
- package/dist/core/ts4.2/e2ee/events.d.ts +38 -0
- package/dist/core/ts4.2/e2ee/extension.d.ts +19 -0
- package/dist/core/ts4.2/e2ee/index.d.ts +5 -0
- package/dist/core/ts4.2/e2ee/types.d.ts +244 -0
- package/dist/core/ts4.2/e2ee/utils.d.ts +36 -0
- package/dist/core/ts4.2/exports.d.ts +82 -0
- package/dist/core/ts4.2/frameMetadata/FrameMetadataManager.d.ts +52 -0
- package/dist/core/ts4.2/frameMetadata/extension.d.ts +12 -0
- package/dist/core/ts4.2/frameMetadata/frameMetadata.d.ts +32 -0
- package/dist/core/ts4.2/frameMetadata/types.d.ts +61 -0
- package/dist/core/ts4.2/frameMetadata/utils.d.ts +13 -0
- package/dist/core/ts4.2/logger.d.ts +59 -0
- package/dist/core/ts4.2/options.d.ts +171 -0
- package/dist/core/ts4.2/room/BackOffStrategy.d.ts +26 -0
- package/dist/core/ts4.2/room/CoreRoom.d.ts +363 -0
- package/dist/core/ts4.2/room/DefaultReconnectPolicy.d.ts +7 -0
- package/dist/core/ts4.2/room/DeviceManager.d.ts +11 -0
- package/dist/core/ts4.2/room/PCTransport.d.ts +132 -0
- package/dist/core/ts4.2/room/PCTransportManager.d.ts +80 -0
- package/dist/core/ts4.2/room/RTCEngine.d.ts +233 -0
- package/dist/core/ts4.2/room/ReconnectPolicy.d.ts +23 -0
- package/dist/core/ts4.2/room/RegionUrlProvider.d.ts +33 -0
- package/dist/core/ts4.2/room/attribute-typings.d.ts +34 -0
- package/dist/core/ts4.2/room/chat/extension.d.ts +21 -0
- package/dist/core/ts4.2/room/createRoom.d.ts +19 -0
- package/dist/core/ts4.2/room/data-channel/DataChannelManager.d.ts +67 -0
- package/dist/core/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +106 -0
- package/dist/core/ts4.2/room/data-channel/LossyDataChannel.d.ts +40 -0
- package/dist/core/ts4.2/room/data-channel/ReliableDataChannel.d.ts +56 -0
- package/dist/core/ts4.2/room/data-channel/types.d.ts +11 -0
- package/dist/core/ts4.2/room/data-stream/compression.d.ts +29 -0
- package/dist/core/ts4.2/room/data-stream/constants.d.ts +1 -0
- package/dist/core/ts4.2/room/data-stream/extension.d.ts +63 -0
- package/dist/core/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +33 -0
- package/dist/core/ts4.2/room/data-stream/incoming/StreamReader.d.ts +77 -0
- package/dist/core/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
- package/dist/core/ts4.2/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
- package/dist/core/ts4.2/room/data-stream/outgoing/header-utils.d.ts +17 -0
- package/dist/core/ts4.2/room/data-track/LocalDataTrack.d.ts +69 -0
- package/dist/core/ts4.2/room/data-track/RemoteDataTrack.d.ts +43 -0
- package/dist/core/ts4.2/room/data-track/depacketizer.d.ts +58 -0
- package/dist/core/ts4.2/room/data-track/extension.d.ts +30 -0
- package/dist/core/ts4.2/room/data-track/frame.d.ts +21 -0
- package/dist/core/ts4.2/room/data-track/handle.d.ts +26 -0
- package/dist/core/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
- package/dist/core/ts4.2/room/data-track/incoming/errors.d.ts +23 -0
- package/dist/core/ts4.2/room/data-track/incoming/pipeline.d.ts +40 -0
- package/dist/core/ts4.2/room/data-track/incoming/types.d.ts +19 -0
- package/dist/core/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
- package/dist/core/ts4.2/room/data-track/outgoing/errors.d.ts +73 -0
- package/dist/core/ts4.2/room/data-track/outgoing/pipeline.d.ts +22 -0
- package/dist/core/ts4.2/room/data-track/outgoing/types.d.ts +47 -0
- package/dist/core/ts4.2/room/data-track/packet/constants.d.ts +19 -0
- package/dist/core/ts4.2/room/data-track/packet/errors.d.ts +39 -0
- package/dist/core/ts4.2/room/data-track/packet/extensions.d.ts +68 -0
- package/dist/core/ts4.2/room/data-track/packet/index.d.ts +97 -0
- package/dist/core/ts4.2/room/data-track/packet/serializable.d.ts +12 -0
- package/dist/core/ts4.2/room/data-track/packetizer.d.ts +40 -0
- package/dist/core/ts4.2/room/data-track/track-interfaces.d.ts +22 -0
- package/dist/core/ts4.2/room/data-track/types.d.ts +21 -0
- package/dist/core/ts4.2/room/data-track/utils.d.ts +59 -0
- package/dist/core/ts4.2/room/debounce.d.ts +10 -0
- package/dist/core/ts4.2/room/defaults.d.ts +7 -0
- package/dist/core/ts4.2/room/errors.d.ts +179 -0
- package/dist/core/ts4.2/room/events.d.ts +534 -0
- package/dist/core/ts4.2/room/extensions.d.ts +206 -0
- package/dist/core/ts4.2/room/participant/LocalParticipant.d.ts +164 -0
- package/dist/core/ts4.2/room/participant/Participant.d.ts +122 -0
- package/dist/core/ts4.2/room/participant/ParticipantTrackPermission.d.ts +25 -0
- package/dist/core/ts4.2/room/participant/RemoteParticipant.d.ts +37 -0
- package/dist/core/ts4.2/room/participant/publishUtils.d.ts +11 -0
- package/dist/core/ts4.2/room/rpc/client/RpcClientManager.d.ts +1 -0
- package/dist/core/ts4.2/room/rpc/client/events.d.ts +7 -0
- package/dist/core/ts4.2/room/rpc/extension.d.ts +73 -0
- package/dist/core/ts4.2/room/rpc/index.d.ts +6 -0
- package/dist/core/ts4.2/room/rpc/server/RpcServerManager.d.ts +1 -0
- package/dist/core/ts4.2/room/rpc/server/events.d.ts +7 -0
- package/dist/core/ts4.2/room/rpc/utils.d.ts +76 -0
- package/dist/core/ts4.2/room/simulated-participants/extension.d.ts +24 -0
- package/dist/core/ts4.2/room/stats.d.ts +70 -0
- package/dist/core/ts4.2/room/statsSummary.d.ts +12 -0
- package/dist/core/ts4.2/room/timers.d.ts +11 -0
- package/dist/core/ts4.2/room/token-source/TokenSource.d.ts +85 -0
- package/dist/core/ts4.2/room/token-source/types.d.ts +69 -0
- package/dist/core/ts4.2/room/token-source/utils.d.ts +7 -0
- package/dist/core/ts4.2/room/track/FrameMetadataExtractor.d.ts +18 -0
- package/dist/core/ts4.2/room/track/LocalAudioTrack.d.ts +50 -0
- package/dist/core/ts4.2/room/track/LocalTrack.d.ts +118 -0
- package/dist/core/ts4.2/room/track/LocalTrackPublication.d.ts +41 -0
- package/dist/core/ts4.2/room/track/LocalVideoTrack.d.ts +91 -0
- package/dist/core/ts4.2/room/track/RemoteAudioTrack.d.ts +49 -0
- package/dist/core/ts4.2/room/track/RemoteTrack.d.ts +29 -0
- package/dist/core/ts4.2/room/track/RemoteTrackPublication.d.ts +62 -0
- package/dist/core/ts4.2/room/track/RemoteVideoTrack.d.ts +53 -0
- package/dist/core/ts4.2/room/track/Track.d.ts +129 -0
- package/dist/core/ts4.2/room/track/TrackPublication.d.ts +68 -0
- package/dist/core/ts4.2/room/track/create.d.ts +12 -0
- package/dist/core/ts4.2/room/track/facingMode.d.ts +40 -0
- package/dist/core/ts4.2/room/track/options.d.ts +396 -0
- package/dist/core/ts4.2/room/track/processor/types.d.ts +41 -0
- package/dist/core/ts4.2/room/track/record.d.ts +12 -0
- package/dist/core/ts4.2/room/track/types.d.ts +27 -0
- package/dist/core/ts4.2/room/track/utils.d.ts +20 -0
- package/dist/core/ts4.2/room/types.d.ts +126 -0
- package/dist/core/ts4.2/room/utils.d.ts +246 -0
- package/dist/core/ts4.2/room/video/create.d.ts +27 -0
- package/dist/core/ts4.2/room/video/extension.d.ts +43 -0
- package/dist/core/ts4.2/room/video/publisher.d.ts +23 -0
- package/dist/core/ts4.2/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
- package/dist/core/ts4.2/utils/AsyncQueue.d.ts +22 -0
- package/dist/core/ts4.2/utils/TypedPromise.d.ts +16 -0
- package/dist/core/ts4.2/utils/abort-signal-polyfill.d.ts +12 -0
- package/dist/core/ts4.2/utils/browserParser.d.ts +9 -0
- package/dist/core/ts4.2/utils/camelToSnakeCase.d.ts +7 -0
- package/dist/core/ts4.2/utils/cloneDeep.d.ts +1 -0
- package/dist/core/ts4.2/utils/dataPacketBuffer.d.ts +33 -0
- package/dist/core/ts4.2/utils/deferrable-map.d.ts +31 -0
- package/dist/core/ts4.2/utils/machineInspector.d.ts +53 -0
- package/dist/core/ts4.2/utils/serializer.d.ts +47 -0
- package/dist/core/ts4.2/utils/throws.d.ts +9 -0
- package/dist/core/ts4.2/utils/ttlmap.d.ts +19 -0
- package/dist/core/ts4.2/version.d.ts +17 -0
- package/dist/core/types/src/api/SignalClient.d.ts +19 -0
- package/dist/core/types/src/api/SignalClientStateMachine.d.ts +84 -0
- package/dist/core/types/src/api/WebSocketStream.d.ts +33 -0
- package/dist/core/types/src/api/utils.d.ts +8 -0
- package/dist/core/types/src/connectionHelper/ConnectionCheck.d.ts +28 -0
- package/dist/core/types/src/connectionHelper/checks/Checker.d.ts +64 -0
- package/dist/core/types/src/connectionHelper/checks/cloudRegion.d.ts +16 -0
- package/dist/core/types/src/connectionHelper/checks/connectionProtocol.d.ts +18 -0
- package/dist/core/types/src/connectionHelper/checks/publishAudio.d.ts +5 -0
- package/dist/core/types/src/connectionHelper/checks/publishVideo.d.ts +6 -0
- package/dist/core/types/src/connectionHelper/checks/reconnect.d.ts +5 -0
- package/dist/core/types/src/connectionHelper/checks/turn.d.ts +5 -0
- package/dist/core/types/src/connectionHelper/checks/webrtc.d.ts +5 -0
- package/dist/core/types/src/connectionHelper/checks/websocket.d.ts +5 -0
- package/dist/core/types/src/core.d.ts +32 -0
- package/dist/core/types/src/e2ee/E2eeManager.d.ts +89 -0
- package/dist/core/types/src/e2ee/KeyProvider.d.ts +53 -0
- package/dist/core/types/src/e2ee/constants.d.ts +20 -0
- package/dist/core/types/src/e2ee/errors.d.ts +11 -0
- package/dist/core/types/src/e2ee/events.d.ts +38 -0
- package/dist/core/types/src/e2ee/extension.d.ts +18 -0
- package/dist/core/types/src/e2ee/index.d.ts +5 -0
- package/dist/core/types/src/e2ee/types.d.ts +244 -0
- package/dist/core/types/src/e2ee/utils.d.ts +35 -0
- package/dist/core/types/src/exports.d.ts +75 -0
- package/dist/core/types/src/frameMetadata/FrameMetadataManager.d.ts +52 -0
- package/dist/core/types/src/frameMetadata/extension.d.ts +10 -0
- package/dist/core/types/src/frameMetadata/frameMetadata.d.ts +32 -0
- package/dist/core/types/src/frameMetadata/types.d.ts +61 -0
- package/dist/core/types/src/frameMetadata/utils.d.ts +13 -0
- package/dist/core/types/src/logger.d.ts +59 -0
- package/dist/core/types/src/options.d.ts +171 -0
- package/dist/core/types/src/room/BackOffStrategy.d.ts +26 -0
- package/dist/core/types/src/room/CoreRoom.d.ts +374 -0
- package/dist/core/types/src/room/DefaultReconnectPolicy.d.ts +7 -0
- package/dist/core/types/src/room/DeviceManager.d.ts +11 -0
- package/dist/core/types/src/room/PCTransport.d.ts +132 -0
- package/dist/core/types/src/room/PCTransportManager.d.ts +80 -0
- package/dist/core/types/src/room/RTCEngine.d.ts +232 -0
- package/dist/core/types/src/room/ReconnectPolicy.d.ts +23 -0
- package/dist/core/types/src/room/RegionUrlProvider.d.ts +33 -0
- package/dist/core/types/src/room/attribute-typings.d.ts +34 -0
- package/dist/core/types/src/room/chat/extension.d.ts +21 -0
- package/dist/core/types/src/room/createRoom.d.ts +18 -0
- package/dist/core/types/src/room/data-channel/DataChannelManager.d.ts +68 -0
- package/dist/core/types/src/room/data-channel/FlowControlledDataChannel.d.ts +107 -0
- package/dist/core/types/src/room/data-channel/LossyDataChannel.d.ts +39 -0
- package/dist/core/types/src/room/data-channel/ReliableDataChannel.d.ts +55 -0
- package/dist/core/types/src/room/data-channel/types.d.ts +11 -0
- package/dist/core/types/src/room/data-stream/compression.d.ts +29 -0
- package/dist/core/types/src/room/data-stream/constants.d.ts +1 -0
- package/dist/core/types/src/room/data-stream/extension.d.ts +62 -0
- package/dist/core/types/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +32 -0
- package/dist/core/types/src/room/data-stream/incoming/StreamReader.d.ts +77 -0
- package/dist/core/types/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
- package/dist/core/types/src/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
- package/dist/core/types/src/room/data-stream/outgoing/header-utils.d.ts +17 -0
- package/dist/core/types/src/room/data-track/LocalDataTrack.d.ts +70 -0
- package/dist/core/types/src/room/data-track/RemoteDataTrack.d.ts +43 -0
- package/dist/core/types/src/room/data-track/depacketizer.d.ts +58 -0
- package/dist/core/types/src/room/data-track/extension.d.ts +30 -0
- package/dist/core/types/src/room/data-track/frame.d.ts +21 -0
- package/dist/core/types/src/room/data-track/handle.d.ts +26 -0
- package/dist/core/types/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
- package/dist/core/types/src/room/data-track/incoming/errors.d.ts +23 -0
- package/dist/core/types/src/room/data-track/incoming/pipeline.d.ts +40 -0
- package/dist/core/types/src/room/data-track/incoming/types.d.ts +19 -0
- package/dist/core/types/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
- package/dist/core/types/src/room/data-track/outgoing/errors.d.ts +73 -0
- package/dist/core/types/src/room/data-track/outgoing/pipeline.d.ts +22 -0
- package/dist/core/types/src/room/data-track/outgoing/types.d.ts +47 -0
- package/dist/core/types/src/room/data-track/packet/constants.d.ts +19 -0
- package/dist/core/types/src/room/data-track/packet/errors.d.ts +39 -0
- package/dist/core/types/src/room/data-track/packet/extensions.d.ts +68 -0
- package/dist/core/types/src/room/data-track/packet/index.d.ts +91 -0
- package/dist/core/types/src/room/data-track/packet/serializable.d.ts +12 -0
- package/dist/core/types/src/room/data-track/packetizer.d.ts +40 -0
- package/dist/core/types/src/room/data-track/track-interfaces.d.ts +22 -0
- package/dist/core/types/src/room/data-track/types.d.ts +21 -0
- package/dist/core/types/src/room/data-track/utils.d.ts +59 -0
- package/dist/core/types/src/room/debounce.d.ts +10 -0
- package/dist/core/types/src/room/defaults.d.ts +7 -0
- package/dist/core/types/src/room/errors.d.ts +179 -0
- package/dist/core/types/src/room/events.d.ts +534 -0
- package/dist/core/types/src/room/extensions.d.ts +205 -0
- package/dist/core/types/src/room/participant/LocalParticipant.d.ts +164 -0
- package/dist/core/types/src/room/participant/Participant.d.ts +123 -0
- package/dist/core/types/src/room/participant/ParticipantTrackPermission.d.ts +25 -0
- package/dist/core/types/src/room/participant/RemoteParticipant.d.ts +37 -0
- package/dist/core/types/src/room/participant/publishUtils.d.ts +11 -0
- package/dist/core/types/src/room/rpc/client/RpcClientManager.d.ts +1 -0
- package/dist/core/types/src/room/rpc/client/events.d.ts +7 -0
- package/dist/core/types/src/room/rpc/extension.d.ts +69 -0
- package/dist/core/types/src/room/rpc/index.d.ts +5 -0
- package/dist/core/types/src/room/rpc/server/RpcServerManager.d.ts +1 -0
- package/dist/core/types/src/room/rpc/server/events.d.ts +7 -0
- package/dist/core/types/src/room/rpc/utils.d.ts +76 -0
- package/dist/core/types/src/room/simulated-participants/extension.d.ts +24 -0
- package/dist/core/types/src/room/stats.d.ts +70 -0
- package/dist/core/types/src/room/statsSummary.d.ts +12 -0
- package/dist/core/types/src/room/timers.d.ts +11 -0
- package/dist/core/types/src/room/token-source/TokenSource.d.ts +91 -0
- package/dist/core/types/src/room/token-source/types.d.ts +69 -0
- package/dist/core/types/src/room/token-source/utils.d.ts +7 -0
- package/dist/core/types/src/room/track/FrameMetadataExtractor.d.ts +18 -0
- package/dist/core/types/src/room/track/LocalAudioTrack.d.ts +53 -0
- package/dist/core/types/src/room/track/LocalTrack.d.ts +118 -0
- package/dist/core/types/src/room/track/LocalTrackPublication.d.ts +41 -0
- package/dist/core/types/src/room/track/LocalVideoTrack.d.ts +91 -0
- package/dist/core/types/src/room/track/RemoteAudioTrack.d.ts +49 -0
- package/dist/core/types/src/room/track/RemoteTrack.d.ts +29 -0
- package/dist/core/types/src/room/track/RemoteTrackPublication.d.ts +76 -0
- package/dist/core/types/src/room/track/RemoteVideoTrack.d.ts +56 -0
- package/dist/core/types/src/room/track/Track.d.ts +134 -0
- package/dist/core/types/src/room/track/TrackPublication.d.ts +74 -0
- package/dist/core/types/src/room/track/create.d.ts +12 -0
- package/dist/core/types/src/room/track/facingMode.d.ts +40 -0
- package/dist/core/types/src/room/track/options.d.ts +384 -0
- package/dist/core/types/src/room/track/processor/types.d.ts +41 -0
- package/dist/core/types/src/room/track/record.d.ts +12 -0
- package/dist/core/types/src/room/track/types.d.ts +27 -0
- package/dist/core/types/src/room/track/utils.d.ts +20 -0
- package/dist/core/types/src/room/types.d.ts +126 -0
- package/dist/core/types/src/room/utils.d.ts +246 -0
- package/dist/core/types/src/room/video/create.d.ts +27 -0
- package/dist/core/types/src/room/video/extension.d.ts +43 -0
- package/dist/core/types/src/room/video/publisher.d.ts +23 -0
- package/dist/core/types/src/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
- package/dist/core/types/src/utils/AsyncQueue.d.ts +22 -0
- package/dist/core/types/src/utils/TypedPromise.d.ts +15 -0
- package/dist/core/types/src/utils/abort-signal-polyfill.d.ts +12 -0
- package/dist/core/types/src/utils/browserParser.d.ts +9 -0
- package/dist/core/types/src/utils/camelToSnakeCase.d.ts +7 -0
- package/dist/core/types/src/utils/cloneDeep.d.ts +1 -0
- package/dist/core/types/src/utils/dataPacketBuffer.d.ts +33 -0
- package/dist/core/types/src/utils/deferrable-map.d.ts +31 -0
- package/dist/core/types/src/utils/machineInspector.d.ts +53 -0
- package/dist/core/types/src/utils/serializer.d.ts +47 -0
- package/dist/core/types/src/utils/throws.d.ts +9 -0
- package/dist/core/types/src/utils/ttlmap.d.ts +19 -0
- package/dist/core/types/src/version.d.ts +17 -0
- package/dist/core/utils/AsyncQueue.mjs +41 -0
- package/dist/core/utils/AsyncQueue.mjs.map +1 -0
- package/dist/core/utils/TypedPromise.mjs +23 -0
- package/dist/core/utils/TypedPromise.mjs.map +1 -0
- package/dist/core/utils/abort-signal-polyfill.mjs +53 -0
- package/dist/core/utils/abort-signal-polyfill.mjs.map +1 -0
- package/dist/core/utils/browserParser.mjs +62 -0
- package/dist/core/utils/browserParser.mjs.map +1 -0
- package/dist/core/utils/cloneDeep.mjs +14 -0
- package/dist/core/utils/cloneDeep.mjs.map +1 -0
- package/dist/core/utils/dataPacketBuffer.mjs +76 -0
- package/dist/core/utils/dataPacketBuffer.mjs.map +1 -0
- package/dist/core/utils/deferrable-map.mjs +94 -0
- package/dist/core/utils/deferrable-map.mjs.map +1 -0
- package/dist/core/utils/machineInspector.mjs +19 -0
- package/dist/core/utils/machineInspector.mjs.map +1 -0
- package/dist/core/utils/serializer.mjs +47 -0
- package/dist/core/utils/serializer.mjs.map +1 -0
- package/dist/core/utils/ttlmap.mjs +97 -0
- package/dist/core/utils/ttlmap.mjs.map +1 -0
- package/dist/core/version.mjs +17 -0
- package/dist/core/version.mjs.map +1 -0
- package/dist/livekit-client.e2ee.worker.js +1 -1
- package/dist/livekit-client.e2ee.worker.js.map +1 -1
- package/dist/livekit-client.e2ee.worker.mjs +157 -131
- package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
- package/dist/livekit-client.esm.mjs +31497 -30818
- 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 +25 -5
- package/dist/src/e2ee/E2eeManager.d.ts.map +1 -1
- package/dist/src/e2ee/KeyProvider.d.ts.map +1 -1
- package/dist/src/e2ee/extension.d.ts +19 -0
- package/dist/src/e2ee/extension.d.ts.map +1 -0
- package/dist/src/e2ee/types.d.ts +14 -0
- package/dist/src/e2ee/types.d.ts.map +1 -1
- package/dist/src/e2ee/utils.d.ts +6 -1
- package/dist/src/e2ee/utils.d.ts.map +1 -1
- package/dist/src/e2ee/worker/FrameCryptor.d.ts +7 -1
- package/dist/src/e2ee/worker/FrameCryptor.d.ts.map +1 -1
- package/dist/src/e2ee/worker/naluUtils.d.ts +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/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/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 +25 -5
- package/dist/ts4.2/e2ee/extension.d.ts +20 -0
- package/dist/ts4.2/e2ee/types.d.ts +14 -0
- package/dist/ts4.2/e2ee/utils.d.ts +6 -1
- package/dist/ts4.2/e2ee/worker/FrameCryptor.d.ts +7 -1
- package/dist/ts4.2/e2ee/worker/naluUtils.d.ts +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/extension.d.ts +74 -0
- package/dist/ts4.2/room/rpc/index.d.ts +1 -1
- package/dist/ts4.2/room/rpc/legacyExtension.d.ts +39 -0
- package/dist/ts4.2/room/simulated-participants/extension.d.ts +25 -0
- package/dist/ts4.2/room/token-source/TokenSource.d.ts +5 -1
- package/dist/ts4.2/room/track/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 +107 -0
- package/src/api/SignalClient.ts +13 -3
- 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 +70 -1
- package/src/e2ee/E2eeManager.ts +53 -32
- 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 +68 -13
- package/src/e2ee/worker/FrameCryptor.ts +78 -18
- 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 +717 -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/extension.ts +159 -0
- package/src/room/rpc/index.ts +1 -10
- package/src/room/rpc/legacyExtension.ts +36 -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.ts +2 -2
- 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,107 @@
|
|
|
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
|
+
/** The currently attached RTCDataChannel handle, if any. */
|
|
45
|
+
get channelHandle(): RTCDataChannel | undefined;
|
|
46
|
+
/**
|
|
47
|
+
* Attaches the channel handle this wrapper controls. Replacing an existing handle closes it and
|
|
48
|
+
* rejects parked waiters — their events would never fire again on the abandoned object — and
|
|
49
|
+
* installs a fresh controller. Wrappers outlive their handles: this is the one place handle
|
|
50
|
+
* turnover happens, so a handle the wrapper lets go of is never left open, and stranding a
|
|
51
|
+
* waiter is structurally impossible.
|
|
52
|
+
*/
|
|
53
|
+
attach(dc: RTCDataChannel): void;
|
|
54
|
+
/** Detaches and closes the handle on teardown, rejecting parked waiters. */
|
|
55
|
+
detach(reason?: string): void;
|
|
56
|
+
/**
|
|
57
|
+
* Closes a handle the wrapper no longer controls. `close()` moves it to `closing` synchronously,
|
|
58
|
+
* so senders still holding it (queued on the headroom lock) fail the open check once they get
|
|
59
|
+
* the lock. Parked waiters are aborted directly instead of relying on the `close` event, which
|
|
60
|
+
* fires asynchronously, if at all (the spec lets `pc.close()` skip it). Strip any handlers that
|
|
61
|
+
* must not observe the close before calling this.
|
|
62
|
+
*/
|
|
63
|
+
private release;
|
|
64
|
+
protected getChannel(): RTCDataChannel | undefined;
|
|
65
|
+
/**
|
|
66
|
+
* Whether the send buffer has room to accept more data (the send gate). Senders proceed while
|
|
67
|
+
* this is true and block once it goes false. Callers resolve the handle (and decide what an
|
|
68
|
+
* absent one means) before asking.
|
|
69
|
+
*/
|
|
70
|
+
isBelowHighWaterMark(dc: RTCDataChannel): boolean;
|
|
71
|
+
/**
|
|
72
|
+
* Whether the send buffer has drained to its low-water mark. Drives the engine's public
|
|
73
|
+
* DCBufferStatusChanged event.
|
|
74
|
+
*/
|
|
75
|
+
isBelowLowWaterMark(dc: RTCDataChannel): boolean;
|
|
76
|
+
/**
|
|
77
|
+
* Acquires the headroom lock, resolving with the unlock function. Batch senders (the resume
|
|
78
|
+
* replay) hold it across all of their sends so no other sender can interleave, calling
|
|
79
|
+
* {@link waitForHeadroomWithoutLock} per message to respect flow control within the batch.
|
|
80
|
+
*/
|
|
81
|
+
lockHeadroom(): Promise<() => void>;
|
|
82
|
+
/**
|
|
83
|
+
* Resolves once the caller may send on `dc`: immediately while its send buffer is at or below
|
|
84
|
+
* the high-water mark, otherwise once the buffer has drained to the low-water mark (the
|
|
85
|
+
* `bufferedamountlow` event). Callers are serialized through the headroom lock so that, when
|
|
86
|
+
* the buffer drains, they refill it one at a time (up to the high-water mark) rather than all
|
|
87
|
+
* sending at once and overflowing the SCTP send buffer (see livekit/client-sdk-js#1995). The
|
|
88
|
+
* checks run inside the lock so queued callers proceed in FIFO order.
|
|
89
|
+
*
|
|
90
|
+
* The caller passes the handle it resolved before queueing, and the wait is against that one
|
|
91
|
+
* handle throughout: if it was replaced meanwhile, it has been closed, so the wait rejects
|
|
92
|
+
* rather than letting the caller send on the replacement out of turn.
|
|
93
|
+
*/
|
|
94
|
+
waitForHeadroomWithLock(dc: RTCDataChannel): Promise<void>;
|
|
95
|
+
/** Core wait of {@link waitForHeadroomWithLock}. The caller must hold the headroom lock. */
|
|
96
|
+
waitForHeadroomWithoutLock(dc: RTCDataChannel): Promise<void>;
|
|
97
|
+
/** Rejects all parked headroom waiters; the next waiter gets a fresh controller. */
|
|
98
|
+
invalidateWaiters(reason: string): void;
|
|
99
|
+
/**
|
|
100
|
+
* Recomputes whether the buffer has drained to the low-water mark and, if that changed since the
|
|
101
|
+
* last check, notifies the status listener. Two independent triggers land here: a send (which
|
|
102
|
+
* raises the buffer) and the `bufferedamountlow` drain event (which lowers it) — the latter has
|
|
103
|
+
* no send to hang the work off, which is why this is a shared entry point rather than a tail of
|
|
104
|
+
* `send`.
|
|
105
|
+
*/
|
|
106
|
+
refreshBufferStatus(): void;
|
|
107
|
+
}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
|
|
2
|
+
import { FlowControlledDataChannel, type FlowControlledDataChannelOptions } from './FlowControlledDataChannel';
|
|
3
|
+
export interface LossyDataChannelOptions extends FlowControlledDataChannelOptions {
|
|
4
|
+
/**
|
|
5
|
+
* What to do with a send while the buffer is full: `drop` discards it to keep latency bounded
|
|
6
|
+
* (the classic lossy channel), `wait` backpressures the producer until there is headroom (the
|
|
7
|
+
* data-track channel, whose producer decides what to skip at frame granularity).
|
|
8
|
+
*/
|
|
9
|
+
bufferFullBehavior: 'drop' | 'wait';
|
|
10
|
+
/** Sends are silently discarded while this is true (a reconnect attempt is underway). */
|
|
11
|
+
shouldSkipSends: () => boolean;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* A lossy channel: flow control plus a per-instance full-buffer policy.
|
|
15
|
+
*
|
|
16
|
+
* Each instance owns its own byterate stat, drop counter, and (when tuning is started) the
|
|
17
|
+
* dynamic `bufferedAmountLowThreshold` adjustment that keeps the drop gate at roughly 100ms of
|
|
18
|
+
* buffered latency. Keeping these per instance is what prevents one channel's traffic from
|
|
19
|
+
* steering another channel's policy.
|
|
20
|
+
*/
|
|
21
|
+
export declare class LossyDataChannel extends FlowControlledDataChannel {
|
|
22
|
+
private bufferFullBehavior;
|
|
23
|
+
private shouldSkipSends;
|
|
24
|
+
private statCurrentBytes;
|
|
25
|
+
private statByterate;
|
|
26
|
+
private statInterval;
|
|
27
|
+
private dropCount;
|
|
28
|
+
constructor(opts: LossyDataChannelOptions);
|
|
29
|
+
/** Sends prepared bytes with this channel's full-buffer policy (drop or wait). */
|
|
30
|
+
send(msg: NonSharedUint8Array): Promise<void>;
|
|
31
|
+
/**
|
|
32
|
+
* Starts the once-per-second adjustment of the channel's `bufferedAmountLowThreshold` to the
|
|
33
|
+
* observed byterate, keeping the drop gate at roughly 100ms of buffered latency (clamped to
|
|
34
|
+
* the watermarks). Restarts cleanly if already running.
|
|
35
|
+
*/
|
|
36
|
+
startThresholdTuning(): void;
|
|
37
|
+
/** Stops the threshold tuning and resets the stats and drop counter. */
|
|
38
|
+
stopThresholdTuning(): void;
|
|
39
|
+
}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
|
|
2
|
+
import { FlowControlledDataChannel, type FlowControlledDataChannelOptions } from './FlowControlledDataChannel';
|
|
3
|
+
export interface ReliableDataChannelOptions extends FlowControlledDataChannelOptions {
|
|
4
|
+
/**
|
|
5
|
+
* Whether sends should currently be deferred to the resume replay instead of hitting the wire
|
|
6
|
+
* (i.e. a reconnect attempt is underway). Read at send time so the reliable channel matches the
|
|
7
|
+
* engine's reconnect state without owning it.
|
|
8
|
+
*/
|
|
9
|
+
isDeferringSends: () => boolean;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* The reliable channel: flow control plus delivery-across-resume semantics.
|
|
13
|
+
*
|
|
14
|
+
* Every packet gets a monotonic sequence (stamped into the protobuf by the caller before
|
|
15
|
+
* serialization, via {@link nextSequence}) and is retained in a replay buffer until the channel's
|
|
16
|
+
* `bufferedAmount` confirms it has been handed to the transport. Sends that land in a reconnect
|
|
17
|
+
* window — or whose headroom wait is torn down transiently — are queued unsent and resolve;
|
|
18
|
+
* {@link replay} delivers them (plus any unacked packets) after a resume. Only an engine close
|
|
19
|
+
* rejects, because no replay is coming after that.
|
|
20
|
+
*/
|
|
21
|
+
export declare class ReliableDataChannel extends FlowControlledDataChannel {
|
|
22
|
+
private messageBuffer;
|
|
23
|
+
private sequence;
|
|
24
|
+
private isDeferringSends;
|
|
25
|
+
constructor(opts: ReliableDataChannelOptions);
|
|
26
|
+
/**
|
|
27
|
+
* Claims the next packet sequence. The caller stamps it into the packet before serialization,
|
|
28
|
+
* then passes it back to {@link send} so the replay buffer stays keyed by wire sequence.
|
|
29
|
+
*/
|
|
30
|
+
nextSequence(): number;
|
|
31
|
+
/**
|
|
32
|
+
* Sends prepared bytes with reliable semantics. Resolves once the packet has either been handed
|
|
33
|
+
* to the channel or queued for the resume replay; throws only when the engine is closed.
|
|
34
|
+
*/
|
|
35
|
+
send(msg: NonSharedUint8Array, sequence: number): Promise<void>;
|
|
36
|
+
/**
|
|
37
|
+
* Replays the buffered backlog after a resume: drops everything the server acked
|
|
38
|
+
* (`lastMessageSeq`), then re-sends the rest in order. The headroom lock is held across the
|
|
39
|
+
* whole replay — releasing it between messages would let a concurrent send (whose newer
|
|
40
|
+
* sequence was already assigned before it queued on the lock) hit the wire mid-replay, and
|
|
41
|
+
* receivers would then discard the remaining lower-sequence resent messages as duplicates.
|
|
42
|
+
*/
|
|
43
|
+
replay(lastMessageSeq: number): Promise<void>;
|
|
44
|
+
/**
|
|
45
|
+
* Before recomputing status, trim packets the transport has now delivered — a send or a drain
|
|
46
|
+
* may have acked buffered packets, and the replay buffer is keyed off the channel's buffered
|
|
47
|
+
* bytes.
|
|
48
|
+
*/
|
|
49
|
+
refreshBufferStatus(): void;
|
|
50
|
+
/**
|
|
51
|
+
* Drops all replay state and restarts sequencing. Only valid on a full reconnect, where the
|
|
52
|
+
* session (and the receivers' sequence tracking) starts over.
|
|
53
|
+
*/
|
|
54
|
+
reset(): void;
|
|
55
|
+
}
|
|
@@ -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;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A `deflate-raw` compression transform (inverse of {@link inflateRawTransform}): pipe a byte stream
|
|
3
|
+
* through it to get the compressed bytes without buffering the whole payload. Used for the chunked
|
|
4
|
+
* `sendText`/`sendBytes`/`sendFile` paths, where the full payload is known up front but is streamed
|
|
5
|
+
* (e.g. from `file.stream()`) rather than held in memory.
|
|
6
|
+
*/
|
|
7
|
+
export declare function deflateRawTransform(): ReadableWritablePair<NonSharedUint8Array, NonSharedUint8Array>;
|
|
8
|
+
/**
|
|
9
|
+
* A `deflate-raw` decompression transform (inverse of {@link deflateRawTransform}): pipe a
|
|
10
|
+
* stream of compressed bytes through it to get the decompressed bytes. Inflate emits output greedily,
|
|
11
|
+
* so as long as the sender flushed at write boundaries each write's content is produced as soon as
|
|
12
|
+
* its compressed bytes arrive.
|
|
13
|
+
*/
|
|
14
|
+
export declare function inflateRawTransform(): ReadableWritablePair<NonSharedUint8Array, NonSharedUint8Array>;
|
|
15
|
+
/** deflate-raw compresses a byte array in full. Use for inline payloads; prefer the streaming
|
|
16
|
+
* path for the chunked case. */
|
|
17
|
+
export declare function deflateRawCompress(data: NonSharedUint8Array): Promise<NonSharedUint8Array>;
|
|
18
|
+
/**
|
|
19
|
+
* Decompresses a raw-deflate byte array in full (inverse of {@link deflateRawCompress}).
|
|
20
|
+
* `maxByteLength` bounds the decompressed output (decompression-bomb guard); exceeding it rejects
|
|
21
|
+
* with a `PayloadTooLarge` error.
|
|
22
|
+
*/
|
|
23
|
+
export declare function deflateRawDecompress(data: NonSharedUint8Array, maxByteLength?: number): Promise<NonSharedUint8Array>;
|
|
24
|
+
/**
|
|
25
|
+
* Drains a byte stream, concatenating all of its chunks into a single array. When
|
|
26
|
+
* `maxByteLength` is given, drops the stream and throws `PayloadTooLarge` as soon as the
|
|
27
|
+
* accumulated output exceeds it.
|
|
28
|
+
*/
|
|
29
|
+
export declare function collect(stream: ReadableStream<NonSharedUint8Array>, maxByteLength?: number): Promise<NonSharedUint8Array>;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import type { RoomDataStreamOptions } from '../../options';
|
|
2
|
+
import { type ConnectionHooks, type DataPacketOwner, type EngineHooks, type LocalParticipantApiProvider, type RoomApiProvider, type SlotProvider } from '../extensions';
|
|
3
|
+
import type { ByteStreamInfo, SendBytesOptions, SendFileOptions, SendTextOptions, StreamBytesOptions, TextStreamInfo } from '../types';
|
|
4
|
+
import IncomingDataStreamManager from './incoming/IncomingDataStreamManager';
|
|
5
|
+
import type { ByteStreamHandler, TextStreamHandler } from './incoming/StreamReader';
|
|
6
|
+
import OutgoingDataStreamManager from './outgoing/OutgoingDataStreamManager';
|
|
7
|
+
import type { ByteStreamWriter } from './outgoing/StreamWriter';
|
|
8
|
+
/**
|
|
9
|
+
* Methods the `dataStreams` extension adds to the room.
|
|
10
|
+
* @experimental
|
|
11
|
+
*/
|
|
12
|
+
export interface DataStreamRoomApi {
|
|
13
|
+
registerTextStreamHandler(topic: string, callback: TextStreamHandler): void;
|
|
14
|
+
unregisterTextStreamHandler(topic: string): void;
|
|
15
|
+
registerByteStreamHandler(topic: string, callback: ByteStreamHandler): void;
|
|
16
|
+
unregisterByteStreamHandler(topic: string): void;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Methods the `dataStreams` extension adds to the local participant.
|
|
20
|
+
* @experimental
|
|
21
|
+
*/
|
|
22
|
+
export interface DataStreamLocalParticipantApi {
|
|
23
|
+
/**
|
|
24
|
+
* Sends the given string to participants in the room via the data channel.
|
|
25
|
+
* For longer messages, consider using {@link streamText} instead.
|
|
26
|
+
*
|
|
27
|
+
* @param text The text payload
|
|
28
|
+
* @param options.topic Topic identifier used to route the stream to appropriate handlers.
|
|
29
|
+
*/
|
|
30
|
+
sendText(text: string, options?: SendTextOptions): Promise<TextStreamInfo>;
|
|
31
|
+
/** Send a File to all participants in the room via the data channel.
|
|
32
|
+
* @param file The File object payload
|
|
33
|
+
* @param options.topic Topic identifier used to route the stream to appropriate handlers.
|
|
34
|
+
* @param options.onProgress A callback function used to monitor the upload progress percentage.
|
|
35
|
+
*/
|
|
36
|
+
sendFile(file: File, options?: SendFileOptions): Promise<{
|
|
37
|
+
id: string;
|
|
38
|
+
}>;
|
|
39
|
+
/**
|
|
40
|
+
* Sends the given bytes to participants in the room via the data channel.
|
|
41
|
+
* For files, consider using {@link sendFile}; for longer/incremental payloads, {@link streamBytes}.
|
|
42
|
+
*
|
|
43
|
+
* @param bytes The byte payload
|
|
44
|
+
* @param options.topic Topic identifier used to route the stream to appropriate handlers.
|
|
45
|
+
*/
|
|
46
|
+
sendBytes(bytes: Uint8Array, options?: SendBytesOptions): Promise<ByteStreamInfo>;
|
|
47
|
+
/**
|
|
48
|
+
* Stream bytes incrementally to participants in the room via the data channel.
|
|
49
|
+
* For sending files, consider using {@link sendFile} instead.
|
|
50
|
+
*
|
|
51
|
+
* @param options.topic Topic identifier used to route the stream to appropriate handlers.
|
|
52
|
+
*/
|
|
53
|
+
streamBytes(options?: StreamBytesOptions): Promise<ByteStreamWriter>;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Text and byte streams (`sendText`, `sendFile`, `registerTextStreamHandler`, ...).
|
|
57
|
+
* @experimental
|
|
58
|
+
*/
|
|
59
|
+
export declare const dataStreams: import("../extensions").ConfigurableExtension<RoomApiProvider<DataStreamRoomApi> & LocalParticipantApiProvider<DataStreamLocalParticipantApi> & SlotProvider<"byteStreamOpener"> & DataPacketOwner & EngineHooks & ConnectionHooks & {
|
|
60
|
+
incoming: IncomingDataStreamManager;
|
|
61
|
+
outgoing: OutgoingDataStreamManager;
|
|
62
|
+
}, RoomDataStreamOptions, readonly []>;
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { type DataPacket, Encryption_Type } from '@livekit/protocol';
|
|
2
|
+
import { type RoomDataStreamOptions } from '../../../options';
|
|
3
|
+
import { type ByteStreamHandler, type TextStreamHandler } from './StreamReader';
|
|
4
|
+
export default class IncomingDataStreamManager {
|
|
5
|
+
private log;
|
|
6
|
+
/** Max number of decompressed bytes an incoming compressed stream may produce before it is
|
|
7
|
+
* errored (decompression-bomb guard). */
|
|
8
|
+
private maxPayloadByteLength;
|
|
9
|
+
/** Max number of incoming streams a single remote participant may have open at once. */
|
|
10
|
+
private maxOpenStreamsPerParticipant;
|
|
11
|
+
constructor({ maxPayloadByteLength, maxOpenStreamsPerParticipant, }?: RoomDataStreamOptions);
|
|
12
|
+
private byteStreamControllers;
|
|
13
|
+
private textStreamControllers;
|
|
14
|
+
private byteStreamHandlers;
|
|
15
|
+
private textStreamHandlers;
|
|
16
|
+
private isConnected;
|
|
17
|
+
private bufferedPackets;
|
|
18
|
+
setConnected(connected: boolean): void;
|
|
19
|
+
private flushBufferedPackets;
|
|
20
|
+
registerTextStreamHandler(topic: string, callback: TextStreamHandler): void;
|
|
21
|
+
unregisterTextStreamHandler(topic: string): void;
|
|
22
|
+
registerByteStreamHandler(topic: string, callback: ByteStreamHandler): void;
|
|
23
|
+
unregisterByteStreamHandler(topic: string): void;
|
|
24
|
+
clearControllers(): void;
|
|
25
|
+
validateParticipantHasNoActiveDataStreams(participantIdentity: string): void;
|
|
26
|
+
handleDataStreamPacket(packet: DataPacket, encryptionType: Encryption_Type): void;
|
|
27
|
+
/** Returns true if the given participant already has the maximum number of streams open. */
|
|
28
|
+
private hasTooManyOpenStreams;
|
|
29
|
+
private handleStreamHeader;
|
|
30
|
+
private handleStreamChunk;
|
|
31
|
+
private handleStreamTrailer;
|
|
32
|
+
}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import type { DataStream_Chunk } from '@livekit/protocol';
|
|
2
|
+
import type { BaseStreamInfo, ByteStreamInfo, TextStreamInfo } from '../../types';
|
|
3
|
+
export type BaseStreamReaderReadAllOpts = {
|
|
4
|
+
/** An AbortSignal can be used to terminate reads early. */
|
|
5
|
+
signal?: AbortSignal;
|
|
6
|
+
};
|
|
7
|
+
declare abstract class BaseStreamReader<T extends BaseStreamInfo> {
|
|
8
|
+
protected reader: ReadableStream<DataStream_Chunk>;
|
|
9
|
+
protected totalByteSize?: number;
|
|
10
|
+
protected _info: T;
|
|
11
|
+
protected bytesReceived: number;
|
|
12
|
+
get info(): T;
|
|
13
|
+
constructor(info: T, stream: ReadableStream<DataStream_Chunk>, totalByteSize?: number);
|
|
14
|
+
/**
|
|
15
|
+
* Counts a chunk's bytes against `totalByteSize` and reports progress. Chunk ordering and
|
|
16
|
+
* de-duplication happen upstream in the manager's `ensureOrderedChunks`, so every chunk reaching
|
|
17
|
+
* here is new and in order.
|
|
18
|
+
*/
|
|
19
|
+
protected handleChunkReceived(chunk: DataStream_Chunk): void;
|
|
20
|
+
/**
|
|
21
|
+
* @param progress - progress of the stream between 0 and 1. Undefined for streams of unknown size
|
|
22
|
+
*/
|
|
23
|
+
onProgress?: (progress: number | undefined) => void;
|
|
24
|
+
abstract readAll(opts?: BaseStreamReaderReadAllOpts): Promise<string | Array<Uint8Array>>;
|
|
25
|
+
}
|
|
26
|
+
export declare class ByteStreamReader extends BaseStreamReader<ByteStreamInfo> {
|
|
27
|
+
signal?: AbortSignal;
|
|
28
|
+
[Symbol.asyncIterator](): {
|
|
29
|
+
next: () => Promise<IteratorResult<Uint8Array>>;
|
|
30
|
+
return(): Promise<IteratorResult<Uint8Array>>;
|
|
31
|
+
};
|
|
32
|
+
/**
|
|
33
|
+
* Injects an AbortSignal, which if aborted, will terminate the currently active
|
|
34
|
+
* stream iteration operation.
|
|
35
|
+
*
|
|
36
|
+
* Note that when using AbortSignal.timeout(...), the timeout applies across
|
|
37
|
+
* the whole iteration operation, not just one individual chunk read.
|
|
38
|
+
*/
|
|
39
|
+
withAbortSignal(signal: AbortSignal): this;
|
|
40
|
+
readAll(opts?: BaseStreamReaderReadAllOpts): Promise<Array<Uint8Array>>;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* A class to read chunks from a ReadableStream and decode them as UTF-8 text.
|
|
44
|
+
*
|
|
45
|
+
* NOTE: chunk-level `version` (resending a chunk at an already-received `chunkIndex` to supersede
|
|
46
|
+
* it) is not supported. The reader used to rebuild the whole string from a per-index chunk map and
|
|
47
|
+
* yield it as `TextStreamChunk.collected`, which made superseding work; 5d4a6346 (#1410, text auto
|
|
48
|
+
* chunking) changed the iterator to yield each chunk's text as it arrives, and a streaming reader
|
|
49
|
+
* cannot retract text it has already handed to the consumer. No sender emits a versioned chunk.
|
|
50
|
+
*/
|
|
51
|
+
export declare class TextStreamReader extends BaseStreamReader<TextStreamInfo> {
|
|
52
|
+
signal?: AbortSignal;
|
|
53
|
+
/**
|
|
54
|
+
* Async iterator implementation to allow usage of `for await...of` syntax.
|
|
55
|
+
* Yields each chunk's decoded text as it arrives - a delta, not the string accumulated so far.
|
|
56
|
+
*/
|
|
57
|
+
[Symbol.asyncIterator](): {
|
|
58
|
+
next: () => Promise<IteratorResult<string>>;
|
|
59
|
+
return(): Promise<IteratorResult<string>>;
|
|
60
|
+
};
|
|
61
|
+
/**
|
|
62
|
+
* Injects an AbortSignal, which if aborted, will terminate the currently active
|
|
63
|
+
* stream iteration operation.
|
|
64
|
+
*
|
|
65
|
+
* Note that when using AbortSignal.timeout(...), the timeout applies across
|
|
66
|
+
* the whole iteration operation, not just one individual chunk read.
|
|
67
|
+
*/
|
|
68
|
+
withAbortSignal(signal: AbortSignal): this;
|
|
69
|
+
readAll(opts?: BaseStreamReaderReadAllOpts): Promise<string>;
|
|
70
|
+
}
|
|
71
|
+
export type ByteStreamHandler = (reader: ByteStreamReader, participantInfo: {
|
|
72
|
+
identity: string;
|
|
73
|
+
}) => void;
|
|
74
|
+
export type TextStreamHandler = (reader: TextStreamReader, participantInfo: {
|
|
75
|
+
identity: string;
|
|
76
|
+
}) => void;
|
|
77
|
+
export {};
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import { ClientInfo_Capability } from '@livekit/protocol';
|
|
2
|
+
import { type StructuredLogger } from '../../../logger';
|
|
3
|
+
import type RTCEngine from '../../RTCEngine';
|
|
4
|
+
import type { ByteStreamInfo, SendBytesOptions, SendFileOptions, SendTextOptions, StreamBytesOptions, TextStreamInfo } from '../../types';
|
|
5
|
+
import { ByteStreamWriter } from './StreamWriter';
|
|
6
|
+
/**
|
|
7
|
+
* Manages sending custom user data via data channels.
|
|
8
|
+
*/
|
|
9
|
+
export default class OutgoingDataStreamManager {
|
|
10
|
+
protected engine: RTCEngine;
|
|
11
|
+
protected log: StructuredLogger;
|
|
12
|
+
/** Returns the advertised client protocol of a remote participant, used to decide whether a
|
|
13
|
+
* recipient can receive single-packet (inline) data streams. */
|
|
14
|
+
protected getRemoteParticipantClientProtocol: (identity: string) => number;
|
|
15
|
+
/** Returns the client capabilities a remote participant advertises, used to decide whether a
|
|
16
|
+
* recipient can decompress a deflate-raw compressed stream. */
|
|
17
|
+
protected getRemoteParticipantCapabilities: (identity: string) => Array<ClientInfo_Capability>;
|
|
18
|
+
/** Returns the identities of every remote participant currently in the room, used to decide
|
|
19
|
+
* whether a broadcast (no explicit destinations) can be sent inline. */
|
|
20
|
+
protected getAllRemoteParticipantIdentities: () => Array<string>;
|
|
21
|
+
constructor(engine: RTCEngine, log: StructuredLogger, getRemoteParticipantClientProtocol: (identity: string) => number, getRemoteParticipantCapabilities: (identity: string) => Array<ClientInfo_Capability>, getAllRemoteParticipantIdentities: () => Array<string>);
|
|
22
|
+
setupEngine(engine: RTCEngine): void;
|
|
23
|
+
/** {@inheritDoc LocalParticipant.sendText} */
|
|
24
|
+
sendText(text: string, options?: SendTextOptions): Promise<TextStreamInfo>;
|
|
25
|
+
/**
|
|
26
|
+
* Sends a complete in-memory byte payload. Mirrors {@link sendText}'s semantics: when every
|
|
27
|
+
* recipient supports data streams v2 the payload rides inline in a single header packet
|
|
28
|
+
* (optionally deflate-raw compressed), otherwise it is sent as a (optionally compressed)
|
|
29
|
+
* chunked byte stream. Unlike {@link sendFile}, the whole payload is already in memory, so the
|
|
30
|
+
* inline single-packet fast path applies.
|
|
31
|
+
*/
|
|
32
|
+
sendBytes(bytes: Uint8Array, options?: SendBytesOptions): Promise<ByteStreamInfo>;
|
|
33
|
+
/**
|
|
34
|
+
* Returns true only if every recipient is known to support data streams v2 (single-packet inline
|
|
35
|
+
* streams and compression). For a targeted send this checks the named destination identities; for
|
|
36
|
+
* a broadcast (no explicit destinations) it checks every remote participant currently in the room.
|
|
37
|
+
* An empty room (nobody to receive) is considered eligible.
|
|
38
|
+
*/
|
|
39
|
+
private allRecipientsSupportV2;
|
|
40
|
+
/**
|
|
41
|
+
* Returns true only if every recipient advertises the deflate-raw compression capability (so it
|
|
42
|
+
* can decompress a compressed stream). Resolved the same way as {@link allRecipientsSupportV2}:
|
|
43
|
+
* named destinations, or every remote participant for a broadcast; an empty room is eligible.
|
|
44
|
+
*/
|
|
45
|
+
private allRecipientsSupportCompression;
|
|
46
|
+
/**
|
|
47
|
+
* Shared chunked-stream send for `sendText`/`sendFile`: sends the prebuilt header packet, then
|
|
48
|
+
* forwards `source` (optionally deflate-raw compressed) as `streamChunk` packets re-chunked to
|
|
49
|
+
* the MTU budget with contiguous indices, then sends the trailer. The source is consumed
|
|
50
|
+
* incrementally, so a `file.stream()` is never buffered in full. The platform compressor can't
|
|
51
|
+
* flush mid-stream, so compression is only used when the whole payload is available as a stream
|
|
52
|
+
* up front (not for incremental writers like `streamText`/`streamBytes`).
|
|
53
|
+
*/
|
|
54
|
+
private sendChunkedByteStream;
|
|
55
|
+
sendFile(file: File, options?: SendFileOptions): Promise<{
|
|
56
|
+
id: string;
|
|
57
|
+
}>;
|
|
58
|
+
/**
|
|
59
|
+
* Streams a file as a chunked byte stream, compressed (deflate-raw) when the runtime supports it
|
|
60
|
+
* and every recipient is on data streams v2. The file is piped `file.stream()` →
|
|
61
|
+
* (`CompressionStream`) → chunk packets via {@link sendChunkedByteStream}, so it is never fully
|
|
62
|
+
* buffered in memory — unlike {@link sendBytes}, there is no inline single-packet fast path for
|
|
63
|
+
* files (the compressed size can't be known up front without buffering the whole file).
|
|
64
|
+
*/
|
|
65
|
+
private _sendFile;
|
|
66
|
+
streamBytes(options?: StreamBytesOptions): Promise<ByteStreamWriter>;
|
|
67
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { BaseStreamInfo, ByteStreamInfo, TextStreamInfo } from '../../types';
|
|
2
|
+
declare class BaseStreamWriter<T, InfoType extends BaseStreamInfo> {
|
|
3
|
+
protected writableStream: WritableStream<T>;
|
|
4
|
+
protected defaultWriter: WritableStreamDefaultWriter<T>;
|
|
5
|
+
protected onClose?: () => void;
|
|
6
|
+
readonly info: InfoType;
|
|
7
|
+
constructor(writableStream: WritableStream<T>, info: InfoType, onClose?: () => void);
|
|
8
|
+
write(chunk: T): Promise<void>;
|
|
9
|
+
close(): Promise<void>;
|
|
10
|
+
}
|
|
11
|
+
export declare class TextStreamWriter extends BaseStreamWriter<string, TextStreamInfo> {
|
|
12
|
+
}
|
|
13
|
+
export declare class ByteStreamWriter extends BaseStreamWriter<Uint8Array, ByteStreamInfo> {
|
|
14
|
+
}
|
|
15
|
+
export {};
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { DataPacket, DataStream_CompressionType, DataStream_Header } from '@livekit/protocol';
|
|
2
|
+
import type { ByteStreamInfo, StreamTextOptions, TextStreamInfo } from '../../types';
|
|
3
|
+
/** The data-streams-v2 wire signals carried directly on the header: the compression flag and the
|
|
4
|
+
* inline single-packet payload. Both used to live in reserved header attributes; they are now
|
|
5
|
+
* first-class protobuf fields on `DataStream.Header`. */
|
|
6
|
+
export interface StreamHeaderV2Fields {
|
|
7
|
+
/** Compression applied to the inline/chunked payload. Defaults to `NONE` when omitted. */
|
|
8
|
+
compression?: DataStream_CompressionType;
|
|
9
|
+
/** The full payload smuggled into the header for single-packet (inline) sends. */
|
|
10
|
+
inlineContent?: Uint8Array;
|
|
11
|
+
}
|
|
12
|
+
/** Builds the `DataStream_Header` for a text stream from its info and stream options. */
|
|
13
|
+
export declare function buildTextStreamHeader(info: TextStreamInfo, options?: Pick<StreamTextOptions, 'version' | 'replyToStreamId' | 'type'>, v2?: StreamHeaderV2Fields): DataStream_Header;
|
|
14
|
+
/** Builds the `DataStream_Header` for a byte stream from its info. */
|
|
15
|
+
export declare function buildByteStreamHeader(info: ByteStreamInfo, v2?: StreamHeaderV2Fields): DataStream_Header;
|
|
16
|
+
/** Wraps a `DataStream_Header` in a `DataPacket` ready to be sent over a data channel. */
|
|
17
|
+
export declare function createStreamHeaderPacket(header: DataStream_Header, destinationIdentities?: Array<string>): DataPacket;
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { type StructuredLogger } from '../../logger';
|
|
2
|
+
import { Future } from '../utils';
|
|
3
|
+
import { type DataTrackFrame } from './frame';
|
|
4
|
+
import type { DataTrackHandle } from './handle';
|
|
5
|
+
import type OutgoingDataTrackManager from './outgoing/OutgoingDataTrackManager';
|
|
6
|
+
import { DataTrackPushFrameError } from './outgoing/errors';
|
|
7
|
+
import type { DataTrackOptions } from './outgoing/types';
|
|
8
|
+
import { type IDataTrack, type ILocalTrack } from './track-interfaces';
|
|
9
|
+
import type { DataTrackInfo } from './types';
|
|
10
|
+
export default class LocalDataTrack implements ILocalTrack, IDataTrack {
|
|
11
|
+
readonly trackSymbol: symbol;
|
|
12
|
+
readonly isLocal = true;
|
|
13
|
+
readonly typeSymbol: symbol;
|
|
14
|
+
protected options: DataTrackOptions;
|
|
15
|
+
/** Represents the currently active {@link DataTrackHandle} for the publication. */
|
|
16
|
+
protected handle: DataTrackHandle | null;
|
|
17
|
+
protected manager: OutgoingDataTrackManager;
|
|
18
|
+
protected log: StructuredLogger;
|
|
19
|
+
/** Resolves once the data track has sent all pending packets the rtc data channel buffer. */
|
|
20
|
+
protected flushedFuture: Future<void, never>;
|
|
21
|
+
protected isFlushed: boolean;
|
|
22
|
+
private handleManagerReset;
|
|
23
|
+
private handleManagerPacketsFlushedChange;
|
|
24
|
+
/** Metrics about the data track publication. */
|
|
25
|
+
get info(): DataTrackInfo | undefined;
|
|
26
|
+
/** The raw descriptor from the manager containing the internal state for this local track. */
|
|
27
|
+
protected get descriptor(): import("./outgoing/OutgoingDataTrackManager").Descriptor | null;
|
|
28
|
+
isPublished(): this is {
|
|
29
|
+
info: DataTrackInfo;
|
|
30
|
+
};
|
|
31
|
+
/** Try pushing a frame to subscribers of the track.
|
|
32
|
+
*
|
|
33
|
+
* Pushing a frame can fail for several reasons:
|
|
34
|
+
*
|
|
35
|
+
* - The track has been unpublished by the local participant or SFU
|
|
36
|
+
* - The room is no longer connected
|
|
37
|
+
*/
|
|
38
|
+
tryPush(frame: DataTrackFrame): Promise<import("../../utils/throws").Throws<void, DataTrackPushFrameError<import("./outgoing/errors").DataTrackPushFrameErrorReason.TrackUnpublished> | DataTrackPushFrameError<import("./outgoing/errors").DataTrackPushFrameErrorReason.Dropped>>>;
|
|
39
|
+
/**
|
|
40
|
+
* When called, waits for all in flight packets to be sent before resolving.
|
|
41
|
+
*
|
|
42
|
+
* Use this to:
|
|
43
|
+
*
|
|
44
|
+
* 1. Send frames exactly in order:
|
|
45
|
+
* ```ts
|
|
46
|
+
* await track.tryPush(/* ... *\/);
|
|
47
|
+
* await track.flush();
|
|
48
|
+
* await track.tryPush(/* ... *\/);
|
|
49
|
+
* await track.flush();
|
|
50
|
+
* // ... etc ...
|
|
51
|
+
* ```
|
|
52
|
+
*
|
|
53
|
+
* 2. Wait for frames to all be delivered before unpublishing a local data track:
|
|
54
|
+
*
|
|
55
|
+
* ```ts
|
|
56
|
+
* await track.tryPush(/* ... *\/);
|
|
57
|
+
* await track.tryPush(/* ... *\/);
|
|
58
|
+
* await track.tryPush(/* ... *\/);
|
|
59
|
+
* // ... etc ...
|
|
60
|
+
* await track.flush();
|
|
61
|
+
* await track.unpublish();
|
|
62
|
+
* ```
|
|
63
|
+
**/
|
|
64
|
+
flush(): Promise<void>;
|
|
65
|
+
/**
|
|
66
|
+
* Unpublish the track from the SFU. Once this is called, any further calls to {@link tryPush}
|
|
67
|
+
* will fail.
|
|
68
|
+
* */
|
|
69
|
+
unpublish(): Promise<void>;
|
|
70
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import type Participant from '../participant/Participant';
|
|
2
|
+
import { type DataTrackFrame } from './frame';
|
|
3
|
+
import type IncomingDataTrackManager from './incoming/IncomingDataTrackManager';
|
|
4
|
+
import { type IDataTrack, type IRemoteTrack } from './track-interfaces';
|
|
5
|
+
import { type DataTrackInfo, type RemoteDataTrackPipelineOptions } from './types';
|
|
6
|
+
export type DataTrackSubscribeOptions = {
|
|
7
|
+
signal?: AbortSignal;
|
|
8
|
+
/** The number of {@link DataTrackFrame}s to hold in the ReadableStream before disgarding extra
|
|
9
|
+
* frames. Defaults to 16, but this may not be good enough for especially high frequency data. */
|
|
10
|
+
bufferSize?: number;
|
|
11
|
+
};
|
|
12
|
+
export default class RemoteDataTrack implements IRemoteTrack, IDataTrack {
|
|
13
|
+
readonly trackSymbol: symbol;
|
|
14
|
+
readonly isLocal = false;
|
|
15
|
+
readonly typeSymbol: symbol;
|
|
16
|
+
info: DataTrackInfo;
|
|
17
|
+
publisherIdentity: Participant['identity'];
|
|
18
|
+
protected manager: IncomingDataTrackManager;
|
|
19
|
+
/** Subscribes to the data track to receive frames.
|
|
20
|
+
*
|
|
21
|
+
* # Returns
|
|
22
|
+
*
|
|
23
|
+
* A stream that yields {@link DataTrackFrame}s as they arrive.
|
|
24
|
+
*
|
|
25
|
+
* # Multiple Subscriptions
|
|
26
|
+
*
|
|
27
|
+
* An application may call `subscribe` more than once to process frames in
|
|
28
|
+
* multiple places. For example, one async task might plot values on a graph
|
|
29
|
+
* while another writes them to a file.
|
|
30
|
+
*
|
|
31
|
+
* Internally, only the first call to `subscribe` communicates with the SFU and
|
|
32
|
+
* allocates the resources required to receive frames. Additional subscriptions
|
|
33
|
+
* reuse the same underlying pipeline and do not trigger additional signaling.
|
|
34
|
+
*
|
|
35
|
+
* Note that newly created subscriptions only receive frames published after
|
|
36
|
+
* the initial subscription is established.
|
|
37
|
+
*/
|
|
38
|
+
subscribe(options?: DataTrackSubscribeOptions): ReadableStream<DataTrackFrame>;
|
|
39
|
+
/** Configure how incoming frames for this track are processed before they are handed out to
|
|
40
|
+
* subscribers (the "pipeline"). These options apply to all current and future subscriptions
|
|
41
|
+
* of this track, and may be set at any time. */
|
|
42
|
+
setPipelineOptions(options: RemoteDataTrackPipelineOptions): void;
|
|
43
|
+
}
|