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,206 @@
|
|
|
1
|
+
import type { DataPacket, Encryption_Type, ParticipantInfo, PublishDataTrackResponse, Room as RoomModel } from '@livekit/protocol';
|
|
2
|
+
import type { BaseE2EEManager } from '../e2ee/E2eeManager';
|
|
3
|
+
import type { FrameMetadataOptions } from '../frameMetadata/FrameMetadataManager';
|
|
4
|
+
import type { StructuredLogger } from '../logger';
|
|
5
|
+
import type { CoreRoom } from './CoreRoom';
|
|
6
|
+
import type RTCEngine from './RTCEngine';
|
|
7
|
+
import type { ByteStreamWriter } from './data-stream/outgoing/StreamWriter';
|
|
8
|
+
import type { VideoPublisher } from './participant/LocalParticipant';
|
|
9
|
+
import type RemoteParticipant from './participant/RemoteParticipant';
|
|
10
|
+
import type { StreamBytesOptions } from './types';
|
|
11
|
+
/**
|
|
12
|
+
* A feature that `createRoom(options, [...])` (or the full `Room`) installs on a room. The
|
|
13
|
+
* methods returned from `install` are copied onto the room (`room`) and its local participant
|
|
14
|
+
* (`local`) under the same names the full SDK uses, so code moves between the light and full
|
|
15
|
+
* builds unchanged.
|
|
16
|
+
*
|
|
17
|
+
* `install` runs synchronously right after the room is constructed, before any user code, so
|
|
18
|
+
* handlers registered there are in place before `connect()`.
|
|
19
|
+
* @experimental
|
|
20
|
+
*/
|
|
21
|
+
export interface RoomExtension<RoomApi = {}, LocalParticipantApi = {}> {
|
|
22
|
+
readonly key: symbol;
|
|
23
|
+
/** Hard dependencies. They install first; an instance the app lists explicitly wins over them. */
|
|
24
|
+
readonly requires?: readonly RoomExtension<any, any>[];
|
|
25
|
+
install(room: CoreRoom, ctx: ExtensionContext): ExtensionResult<RoomApi, LocalParticipantApi>;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* What an extension contributes to the engine.
|
|
29
|
+
* @experimental
|
|
30
|
+
*/
|
|
31
|
+
export interface EngineHooks {
|
|
32
|
+
/**
|
|
33
|
+
* Runs once every extension of the list is installed, with the current engine, and again
|
|
34
|
+
* whenever the room replaces it (after a close). The room's own engine listeners are registered
|
|
35
|
+
* first, so a listener on the same engine event sees room state already updated.
|
|
36
|
+
*/
|
|
37
|
+
onEngineCreated?(engine: RTCEngine): void;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* What an extension contributes to the connection lifecycle.
|
|
41
|
+
* @experimental
|
|
42
|
+
*/
|
|
43
|
+
export interface ConnectionHooks {
|
|
44
|
+
/**
|
|
45
|
+
* Runs at the start of every disconnect, including one that reaches an already disconnected
|
|
46
|
+
* room, before the room emits `RoomEvent.Disconnected`.
|
|
47
|
+
*/
|
|
48
|
+
onDisconnect?(): void;
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* What an extension contributes to remote participant bookkeeping.
|
|
52
|
+
* @experimental
|
|
53
|
+
*/
|
|
54
|
+
export interface ParticipantHooks {
|
|
55
|
+
/** Runs after the room creates a remote participant from a `ParticipantInfo`. */
|
|
56
|
+
onParticipantCreated?(participant: RemoteParticipant, info: ParticipantInfo): void;
|
|
57
|
+
/** Runs after the room applied a participant update (join, update, reconnect). */
|
|
58
|
+
onParticipantUpdates?(infos: ParticipantInfo[]): void;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* An extension that owns `DataPacket` oneof cases. A second owner of a case throws at install.
|
|
62
|
+
* @experimental
|
|
63
|
+
*/
|
|
64
|
+
export interface DataPacketOwner {
|
|
65
|
+
dataPackets?: {
|
|
66
|
+
[C in DataPacketCase]?: DataPacketHandler<C>;
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* An extension that contributes to the sync state the room sends on resume.
|
|
71
|
+
* @experimental
|
|
72
|
+
*/
|
|
73
|
+
export interface SyncStateProvider {
|
|
74
|
+
/** Local data track publications. */
|
|
75
|
+
syncState?(): PublishDataTrackResponse[];
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* An extension that adds methods to the room, copied onto it under the SDK's method names.
|
|
79
|
+
* @experimental
|
|
80
|
+
*/
|
|
81
|
+
export interface RoomApiProvider<RoomApi = {}> {
|
|
82
|
+
room: RoomApi;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* An extension that adds methods to the local participant, copied onto it.
|
|
86
|
+
* @experimental
|
|
87
|
+
*/
|
|
88
|
+
export interface LocalParticipantApiProvider<LocalParticipantApi = {}> {
|
|
89
|
+
localParticipant: LocalParticipantApi;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* An extension with something to release.
|
|
93
|
+
* @experimental
|
|
94
|
+
*/
|
|
95
|
+
export interface Disposable {
|
|
96
|
+
/** Called from `Room.dispose()`, in reverse install order. Must be synchronous. */
|
|
97
|
+
dispose(): void;
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* What `install` returns: the APIs plus every contribution to core an extension can opt into,
|
|
101
|
+
* all optional. An extension declares the narrower type it uses, such as
|
|
102
|
+
* `RoomApiProvider<RpcRoomApi> & LocalParticipantApiProvider<RpcLocalParticipantApi> & DataPacketOwner`, so a missing
|
|
103
|
+
* API or an undeclared contribution is a type error. Extra members are not copied anywhere;
|
|
104
|
+
* dependent extensions read them through `ctx.get(extension)`. The room's own typing
|
|
105
|
+
* (`ExtensionApis`) comes from the `RoomExtension<RoomApi, LocalParticipantApi>` generics, which each
|
|
106
|
+
* extension pins with `satisfies`.
|
|
107
|
+
* @experimental
|
|
108
|
+
*/
|
|
109
|
+
export type ExtensionResult<RoomApi = {}, LocalParticipantApi = {}> = Partial<RoomApiProvider<RoomApi> & LocalParticipantApiProvider<LocalParticipantApi> & Disposable> & EngineHooks & ConnectionHooks & ParticipantHooks & DataPacketOwner & Partial<CoreSlots> & SyncStateProvider;
|
|
110
|
+
/** @experimental */
|
|
111
|
+
export type DataPacketHandler<C extends DataPacketCase> = (value: DataPacketValue<C>, packet: DataPacket, encryptionType: Encryption_Type, participant: RemoteParticipant | undefined) => void;
|
|
112
|
+
/**
|
|
113
|
+
* The values core reads from extensions. Core copies them off every install result into one
|
|
114
|
+
* store that it and the local participant read; `ctx.slot()` reads it too. Adding one is a
|
|
115
|
+
* member here, its key in `SLOT_KEYS`, and the read in core.
|
|
116
|
+
* @experimental
|
|
117
|
+
*/
|
|
118
|
+
export interface CoreSlots {
|
|
119
|
+
/** The E2EE manager `RTCEngine` and the publish path encrypt through (`e2ee`). */
|
|
120
|
+
e2eeManager: BaseE2EEManager;
|
|
121
|
+
/**
|
|
122
|
+
* The frame metadata options the engine's sender transform, the join capability and
|
|
123
|
+
* `publishTrack` read (`frameMetadata`).
|
|
124
|
+
*/
|
|
125
|
+
frameMetadataOptions: FrameMetadataOptions;
|
|
126
|
+
/** Opens an outgoing byte stream (`dataStreams`); the preconnect audio buffer goes through it. */
|
|
127
|
+
byteStreamOpener: (options?: StreamBytesOptions) => Promise<ByteStreamWriter>;
|
|
128
|
+
/** The video publish pipeline (`video`). Without one, publishing a video track throws. */
|
|
129
|
+
videoPublisher: VideoPublisher;
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* An extension that supplies the named slots: `SlotProvider<'byteStreamOpener'>`. A provider
|
|
133
|
+
* whose value is conditional declares `Partial<SlotProvider<...>>`.
|
|
134
|
+
* @experimental
|
|
135
|
+
*/
|
|
136
|
+
export type SlotProvider<K extends keyof CoreSlots> = Pick<CoreSlots, K>;
|
|
137
|
+
/** @experimental */
|
|
138
|
+
export type DataPacketCase = NonNullable<DataPacket['value']['case']>;
|
|
139
|
+
/** @experimental */
|
|
140
|
+
export type DataPacketValue<C extends DataPacketCase> = Extract<DataPacket['value'], {
|
|
141
|
+
case: C;
|
|
142
|
+
}>['value'];
|
|
143
|
+
/**
|
|
144
|
+
* What core exposes to an extension at install time. Everything the extension contributes goes
|
|
145
|
+
* through its install result instead. Everything else it needs (`remoteParticipants`,
|
|
146
|
+
* `localParticipant`, `emit`, `options`, `engine`) is public on the room already.
|
|
147
|
+
* @experimental
|
|
148
|
+
*/
|
|
149
|
+
export interface ExtensionContext {
|
|
150
|
+
log: StructuredLogger;
|
|
151
|
+
/** The `install` result of an already installed extension (a hard dependency). */
|
|
152
|
+
get<E extends RoomExtension<any, any>>(ext: E): ReturnType<E['install']>;
|
|
153
|
+
/** Reads a slot. Slots of the whole list are filled before any `onEngineCreated` runs. */
|
|
154
|
+
slot<K extends keyof CoreSlots>(slot: K): CoreSlots[K] | undefined;
|
|
155
|
+
/** Returns the remote participant for an identity, creating it from `info` when new. */
|
|
156
|
+
getOrCreateParticipant(identity: string, info: ParticipantInfo): RemoteParticipant;
|
|
157
|
+
/** Puts the room into the connected state without a server (`simulatedParticipants`). */
|
|
158
|
+
simulateConnected(roomInfo: RoomModel, localParticipantInfo: ParticipantInfo): void;
|
|
159
|
+
/** A silent audio track the room hands back to the shared source on disconnect. */
|
|
160
|
+
acquireEmptyAudioStreamTrack(): MediaStreamTrack;
|
|
161
|
+
}
|
|
162
|
+
type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
|
|
163
|
+
type Known<T> = unknown extends T ? {} : T;
|
|
164
|
+
type ApiOf<E> = E extends RoomExtension<infer R, any> ? Known<R> : never;
|
|
165
|
+
type LocalOf<E> = E extends RoomExtension<any, infer L> ? Known<L> : never;
|
|
166
|
+
type Deps<E> = E extends {
|
|
167
|
+
requires: readonly (infer D)[];
|
|
168
|
+
} ? D | Deps<D> : never;
|
|
169
|
+
type All<E> = E | Deps<E>;
|
|
170
|
+
/**
|
|
171
|
+
* The methods a set of extensions (and their dependencies) adds to a room and its local participant.
|
|
172
|
+
* @experimental
|
|
173
|
+
*/
|
|
174
|
+
export type ExtensionApis<E> = UnionToIntersection<ApiOf<All<E>>> & {
|
|
175
|
+
localParticipant: UnionToIntersection<LocalOf<All<E>>>;
|
|
176
|
+
};
|
|
177
|
+
/**
|
|
178
|
+
* An extension with its options bound.
|
|
179
|
+
* @experimental
|
|
180
|
+
*/
|
|
181
|
+
export type ConfiguredExtension<Result extends ExtensionResult<any, any>, Requires extends readonly RoomExtension<any, any>[]> = {
|
|
182
|
+
readonly key: symbol;
|
|
183
|
+
readonly requires: Requires;
|
|
184
|
+
install(room: CoreRoom, ctx: ExtensionContext): Result;
|
|
185
|
+
};
|
|
186
|
+
/**
|
|
187
|
+
* An extension that takes options. Listed bare (`[e2ee]`) it installs from the room options the
|
|
188
|
+
* full `Room` uses today; called (`[e2ee(options)]`) it installs with those options. A function
|
|
189
|
+
* (`e2ee(() => options)`) is evaluated inside each room's constructor, for resources such as
|
|
190
|
+
* workers that must be per room.
|
|
191
|
+
* @experimental
|
|
192
|
+
*/
|
|
193
|
+
export type ConfigurableExtension<Result extends ExtensionResult<any, any>, Options, Requires extends readonly RoomExtension<any, any>[]> = ConfiguredExtension<Result, Requires> & ((options: Options | (() => Options)) => ConfiguredExtension<Result, Requires>);
|
|
194
|
+
/**
|
|
195
|
+
* Builds a {@link ConfigurableExtension}. The option type comes from the `options` parameter.
|
|
196
|
+
* @experimental
|
|
197
|
+
*/
|
|
198
|
+
export declare function defineExtension<Result extends ExtensionResult<any, any>, Options, Requires extends readonly RoomExtension<any, any>[] = [
|
|
199
|
+
]>(name: string, requires: Requires, install: (room: CoreRoom, ctx: ExtensionContext, options: Options | undefined) => Result): ConfigurableExtension<Result, Options, Requires>;
|
|
200
|
+
/**
|
|
201
|
+
* Installs extensions on a room: dependencies first, each key once. An extension the caller
|
|
202
|
+
* lists explicitly wins over the default a dependency would pull in, whatever the order.
|
|
203
|
+
* @experimental
|
|
204
|
+
*/
|
|
205
|
+
export declare function installExtensions(room: CoreRoom, extensions: readonly RoomExtension<any, any>[]): void;
|
|
206
|
+
export {};
|
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
import { AddTrackRequest, TrackInfo } from '@livekit/protocol';
|
|
2
|
+
import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
|
|
3
|
+
import LocalTrack from '../track/LocalTrack';
|
|
4
|
+
import LocalTrackPublication from '../track/LocalTrackPublication';
|
|
5
|
+
import type LocalVideoTrack from '../track/LocalVideoTrack';
|
|
6
|
+
import { Track } from '../track/Track';
|
|
7
|
+
import type { AudioCaptureOptions, CreateLocalTracksOptions, ScreenShareCaptureOptions, TrackPublishOptions } from '../track/options';
|
|
8
|
+
import type { DataPublishOptions } from '../types';
|
|
9
|
+
import Participant from './Participant';
|
|
10
|
+
import type { ParticipantTrackPermission } from './ParticipantTrackPermission';
|
|
11
|
+
/**
|
|
12
|
+
* The video publish pipeline. The `video` extension sets it on the local participant; without it,
|
|
13
|
+
* publishing a video track throws.
|
|
14
|
+
* @experimental
|
|
15
|
+
*/
|
|
16
|
+
export interface VideoPublisher {
|
|
17
|
+
/**
|
|
18
|
+
* Chooses the codec, settles simulcast and SVC and fills `req` (dimensions, layers, codecs).
|
|
19
|
+
* Returns the encodings for the sender.
|
|
20
|
+
*/
|
|
21
|
+
prepare(track: LocalVideoTrack, opts: TrackPublishOptions, req: AddTrackRequest): Promise<RTCRtpEncodingParameters[]>;
|
|
22
|
+
/** Runs once the sender exists: degradation preference and start bitrate. */
|
|
23
|
+
senderCreated(track: LocalVideoTrack, opts: TrackPublishOptions, encodings: RTCRtpEncodingParameters[] | undefined, req: AddTrackRequest): void;
|
|
24
|
+
/** The server may answer with another primary codec. Returns recomputed encodings when it did. */
|
|
25
|
+
serverCodecChanged(track: LocalVideoTrack, opts: TrackPublishOptions, info: TrackInfo, req: AddTrackRequest): RTCRtpEncodingParameters[] | undefined;
|
|
26
|
+
createScreenTracks(options?: ScreenShareCaptureOptions): Promise<LocalTrack[]>;
|
|
27
|
+
}
|
|
28
|
+
export declare class LocalParticipant extends Participant {
|
|
29
|
+
audioTrackPublications: Map<string, LocalTrackPublication>;
|
|
30
|
+
videoTrackPublications: Map<string, LocalTrackPublication>;
|
|
31
|
+
/** map of track sid => all published tracks */
|
|
32
|
+
trackPublications: Map<string, LocalTrackPublication>;
|
|
33
|
+
private pendingPublishPromises;
|
|
34
|
+
private republishPromise;
|
|
35
|
+
private cameraError;
|
|
36
|
+
private microphoneError;
|
|
37
|
+
private participantTrackPermissions;
|
|
38
|
+
private allParticipantsAllowedToSubscribe;
|
|
39
|
+
private roomOptions;
|
|
40
|
+
private encryptionType;
|
|
41
|
+
private e2eeStateMutex;
|
|
42
|
+
private reconnectFuture?;
|
|
43
|
+
private signalConnectedFuture?;
|
|
44
|
+
private activeAgentFuture?;
|
|
45
|
+
private firstActiveAgent?;
|
|
46
|
+
private pendingSignalRequests;
|
|
47
|
+
/** The room's extension slots; the install result of an extension fills them. */
|
|
48
|
+
private readonly slots;
|
|
49
|
+
get lastCameraError(): (Error | undefined);
|
|
50
|
+
get lastMicrophoneError(): (Error | undefined);
|
|
51
|
+
get isE2EEEnabled(): boolean;
|
|
52
|
+
getTrackPublication(source: Track.Source): LocalTrackPublication | undefined;
|
|
53
|
+
getTrackPublicationByName(name: string): LocalTrackPublication | undefined;
|
|
54
|
+
private handleReconnecting;
|
|
55
|
+
private handleReconnected;
|
|
56
|
+
private handleClosing;
|
|
57
|
+
private handleSignalConnected;
|
|
58
|
+
private handleSignalRequestResponse;
|
|
59
|
+
/**
|
|
60
|
+
* Sets and updates the metadata of the local participant.
|
|
61
|
+
* Note: this requires `canUpdateOwnMetadata` permission.
|
|
62
|
+
* method will throw if the user doesn't have the required permissions
|
|
63
|
+
* @param metadata
|
|
64
|
+
*/
|
|
65
|
+
setMetadata(metadata: string): Promise<void>;
|
|
66
|
+
/**
|
|
67
|
+
* Sets and updates the name of the local participant.
|
|
68
|
+
* Note: this requires `canUpdateOwnMetadata` permission.
|
|
69
|
+
* method will throw if the user doesn't have the required permissions
|
|
70
|
+
* @param metadata
|
|
71
|
+
*/
|
|
72
|
+
setName(name: string): Promise<void>;
|
|
73
|
+
/**
|
|
74
|
+
* Set or update participant attributes. It will make updates only to keys that
|
|
75
|
+
* are present in `attributes`, and will not override others.
|
|
76
|
+
* Note: this requires `canUpdateOwnMetadata` permission.
|
|
77
|
+
* @param attributes attributes to update
|
|
78
|
+
*/
|
|
79
|
+
setAttributes(attributes: Record<string, string>): Promise<void>;
|
|
80
|
+
private requestMetadataUpdate;
|
|
81
|
+
/**
|
|
82
|
+
* Enable or disable a participant's microphone track.
|
|
83
|
+
*
|
|
84
|
+
* If a track has already published, it'll mute or unmute the track.
|
|
85
|
+
* Resolves with a `LocalTrackPublication` instance if successful and `undefined` otherwise
|
|
86
|
+
*/
|
|
87
|
+
setMicrophoneEnabled(enabled: boolean, options?: AudioCaptureOptions, publishOptions?: TrackPublishOptions): Promise<LocalTrackPublication | undefined>;
|
|
88
|
+
setTrackEnabled(source: Extract<Track.Source, Track.Source.Microphone>, enabled: boolean, options?: AudioCaptureOptions, publishOptions?: TrackPublishOptions): Promise<LocalTrackPublication | undefined>;
|
|
89
|
+
setTrackEnabled(source: Extract<Track.Source, Track.Source.ScreenShare>, enabled: boolean, options?: ScreenShareCaptureOptions, publishOptions?: TrackPublishOptions): Promise<LocalTrackPublication | undefined>;
|
|
90
|
+
/**
|
|
91
|
+
* Create local camera and/or microphone tracks
|
|
92
|
+
* @param options
|
|
93
|
+
* @returns
|
|
94
|
+
*/
|
|
95
|
+
createTracks(options?: CreateLocalTracksOptions): Promise<LocalTrack[]>;
|
|
96
|
+
private requireVideoPublisher;
|
|
97
|
+
/**
|
|
98
|
+
* Publish a new track to the room
|
|
99
|
+
* @param track
|
|
100
|
+
* @param options
|
|
101
|
+
*/
|
|
102
|
+
publishTrack(track: LocalTrack | MediaStreamTrack, options?: TrackPublishOptions): Promise<LocalTrackPublication>;
|
|
103
|
+
/**
|
|
104
|
+
* Waits for the engine's next `Restarted` event. Unlike `engine.waitForRestarted`, this does
|
|
105
|
+
* not short-circuit when `pcState === Connected` — at the point this is called (right after a
|
|
106
|
+
* `NegotiationError`) the PC transport is still connected, but `fullReconnectOnNext` has been
|
|
107
|
+
* set and `attemptReconnect` is queued via setTimeout. We need to wait for that restart to
|
|
108
|
+
* actually complete (which clears `pendingTrackResolvers` via `cleanupClient`) before retrying.
|
|
109
|
+
*/
|
|
110
|
+
private waitForNextEngineRestart;
|
|
111
|
+
private publishOrRepublishTrack;
|
|
112
|
+
private waitUntilEngineConnected;
|
|
113
|
+
private hasPermissionsToPublish;
|
|
114
|
+
private publish;
|
|
115
|
+
private canPublishFrameMetadata;
|
|
116
|
+
get isLocal(): boolean;
|
|
117
|
+
unpublishTrack(track: LocalTrack | MediaStreamTrack, stopOnUnpublish?: boolean): Promise<LocalTrackPublication | undefined>;
|
|
118
|
+
unpublishTracks(tracks: LocalTrack[] | MediaStreamTrack[]): Promise<LocalTrackPublication[]>;
|
|
119
|
+
republishAllTracks(options?: TrackPublishOptions, restartTracks?: boolean): Promise<void>;
|
|
120
|
+
/**
|
|
121
|
+
* Publish a new data payload to the room. Data will be forwarded to each
|
|
122
|
+
* participant in the room if the destination field in publishOptions is empty
|
|
123
|
+
*
|
|
124
|
+
* @param data Uint8Array of the payload. To send string data, use TextEncoder.encode
|
|
125
|
+
* @param options optionally specify a `reliable`, `topic` and `destination`
|
|
126
|
+
*/
|
|
127
|
+
publishData(data: NonSharedUint8Array, options?: DataPublishOptions): Promise<void>;
|
|
128
|
+
/**
|
|
129
|
+
* Publish SIP DTMF message to the room.
|
|
130
|
+
*
|
|
131
|
+
* @param code DTMF code
|
|
132
|
+
* @param digit DTMF digit
|
|
133
|
+
*/
|
|
134
|
+
publishDtmf(code: number, digit: string): Promise<void>;
|
|
135
|
+
/**
|
|
136
|
+
* Control who can subscribe to LocalParticipant's published tracks.
|
|
137
|
+
*
|
|
138
|
+
* By default, all participants can subscribe. This allows fine-grained control over
|
|
139
|
+
* who is able to subscribe at a participant and track level.
|
|
140
|
+
*
|
|
141
|
+
* Note: if access is given at a track-level (i.e. both [allParticipantsAllowed] and
|
|
142
|
+
* [ParticipantTrackPermission.allTracksAllowed] are false), any newer published tracks
|
|
143
|
+
* will not grant permissions to any participants and will require a subsequent
|
|
144
|
+
* permissions update to allow subscription.
|
|
145
|
+
*
|
|
146
|
+
* @param allParticipantsAllowed Allows all participants to subscribe all tracks.
|
|
147
|
+
* Takes precedence over [[participantTrackPermissions]] if set to true.
|
|
148
|
+
* By default this is set to true.
|
|
149
|
+
* @param participantTrackPermissions Full list of individual permissions per
|
|
150
|
+
* participant/track. Any omitted participants will not receive any permissions.
|
|
151
|
+
*/
|
|
152
|
+
setTrackSubscriptionPermissions(allParticipantsAllowed: boolean, participantTrackPermissions?: ParticipantTrackPermission[]): void;
|
|
153
|
+
private updateTrackSubscriptionPermissions;
|
|
154
|
+
private waitUntilActiveAgentPresent;
|
|
155
|
+
private onTrackUpstreamPaused;
|
|
156
|
+
private onTrackUpstreamResumed;
|
|
157
|
+
private onTrackFeatureUpdate;
|
|
158
|
+
private onTrackCpuConstrained;
|
|
159
|
+
private handleLocalTrackUnpublished;
|
|
160
|
+
private handleTrackEnded;
|
|
161
|
+
private getPublicationForTrack;
|
|
162
|
+
private waitForPendingPublicationOfSource;
|
|
163
|
+
}
|
|
164
|
+
export default LocalParticipant;
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
import type { SipDTMF } from '@livekit/protocol';
|
|
2
|
+
import { DataPacket_Kind, Encryption_Type, ParticipantInfo, ParticipantInfo_Kind as ParticipantKind, ParticipantPermission, SubscriptionError } from '@livekit/protocol';
|
|
3
|
+
import type TypedEmitter from 'typed-emitter';
|
|
4
|
+
import type { StructuredLogger } from '../../logger';
|
|
5
|
+
import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
|
|
6
|
+
import type LocalTrackPublication from '../track/LocalTrackPublication';
|
|
7
|
+
import type LocalVideoTrack from '../track/LocalVideoTrack';
|
|
8
|
+
import type RemoteTrack from '../track/RemoteTrack';
|
|
9
|
+
import type RemoteTrackPublication from '../track/RemoteTrackPublication';
|
|
10
|
+
import { Track } from '../track/Track';
|
|
11
|
+
import type { TrackPublication } from '../track/TrackPublication';
|
|
12
|
+
import type { ChatMessage, LoggerOptions, TranscriptionSegment } from '../types';
|
|
13
|
+
import { Future } from '../utils';
|
|
14
|
+
export declare enum ConnectionQuality {
|
|
15
|
+
Excellent = "excellent",
|
|
16
|
+
Good = "good",
|
|
17
|
+
Poor = "poor",
|
|
18
|
+
/**
|
|
19
|
+
* Indicates that a participant has temporarily (or permanently) lost connection to LiveKit.
|
|
20
|
+
* For permanent disconnection a `ParticipantDisconnected` event will be emitted after a timeout
|
|
21
|
+
*/
|
|
22
|
+
Lost = "lost",
|
|
23
|
+
Unknown = "unknown"
|
|
24
|
+
}
|
|
25
|
+
export { ParticipantKind };
|
|
26
|
+
declare const Participant_base: new () => TypedEmitter<ParticipantEventCallbacks>;
|
|
27
|
+
export default class Participant extends Participant_base {
|
|
28
|
+
protected participantInfo?: ParticipantInfo;
|
|
29
|
+
audioTrackPublications: Map<string, TrackPublication>;
|
|
30
|
+
videoTrackPublications: Map<string, TrackPublication>;
|
|
31
|
+
/** map of track sid => all published tracks */
|
|
32
|
+
trackPublications: Map<string, TrackPublication>;
|
|
33
|
+
/** audio level between 0-1.0, 1 being loudest, 0 being softest */
|
|
34
|
+
audioLevel: number;
|
|
35
|
+
/** if participant is currently speaking */
|
|
36
|
+
isSpeaking: boolean;
|
|
37
|
+
/** server assigned unique id */
|
|
38
|
+
sid: string;
|
|
39
|
+
/** client assigned identity, encoded in JWT token */
|
|
40
|
+
identity: string;
|
|
41
|
+
/** client assigned display name, encoded in JWT token */
|
|
42
|
+
name?: string;
|
|
43
|
+
/** client metadata, opaque to livekit */
|
|
44
|
+
metadata?: string;
|
|
45
|
+
private _attributes;
|
|
46
|
+
lastSpokeAt?: Date | undefined;
|
|
47
|
+
permissions?: ParticipantPermission;
|
|
48
|
+
protected _kind: ParticipantKind;
|
|
49
|
+
private _connectionQuality;
|
|
50
|
+
protected log: StructuredLogger;
|
|
51
|
+
protected loggerOptions?: LoggerOptions;
|
|
52
|
+
protected activeFuture?: Future<void, Error>;
|
|
53
|
+
protected get logContext(): {
|
|
54
|
+
[x: string]: unknown;
|
|
55
|
+
};
|
|
56
|
+
get isEncrypted(): boolean;
|
|
57
|
+
get isAgent(): boolean;
|
|
58
|
+
get isActive(): boolean;
|
|
59
|
+
get kind(): ParticipantKind;
|
|
60
|
+
get attributes(): Readonly<Record<string, string>>;
|
|
61
|
+
getTrackPublications(): TrackPublication[];
|
|
62
|
+
/**
|
|
63
|
+
* Finds the first track that matches the source filter, for example, getting
|
|
64
|
+
* the user's camera track with getTrackBySource(Track.Source.Camera).
|
|
65
|
+
*/
|
|
66
|
+
getTrackPublication(source: Track.Source): TrackPublication | undefined;
|
|
67
|
+
/**
|
|
68
|
+
* Finds the first track that matches the track's name.
|
|
69
|
+
*/
|
|
70
|
+
getTrackPublicationByName(name: string): TrackPublication | undefined;
|
|
71
|
+
/**
|
|
72
|
+
* Waits until the participant is active and ready to receive data messages
|
|
73
|
+
* @returns a promise that resolves when the participant is active
|
|
74
|
+
*/
|
|
75
|
+
waitUntilActive(): Promise<void>;
|
|
76
|
+
get connectionQuality(): ConnectionQuality;
|
|
77
|
+
get isCameraEnabled(): boolean;
|
|
78
|
+
get isMicrophoneEnabled(): boolean;
|
|
79
|
+
get isScreenShareEnabled(): boolean;
|
|
80
|
+
get isLocal(): boolean;
|
|
81
|
+
get joinedAt(): (Date | undefined);
|
|
82
|
+
/**
|
|
83
|
+
* Updates metadata from server
|
|
84
|
+
**/
|
|
85
|
+
private _setMetadata;
|
|
86
|
+
private _setName;
|
|
87
|
+
/**
|
|
88
|
+
* Updates metadata from server
|
|
89
|
+
**/
|
|
90
|
+
private _setAttributes;
|
|
91
|
+
protected addTrackPublication(publication: TrackPublication): void;
|
|
92
|
+
}
|
|
93
|
+
export type ParticipantEventCallbacks = {
|
|
94
|
+
trackPublished: (publication: RemoteTrackPublication) => void;
|
|
95
|
+
trackSubscribed: (track: RemoteTrack, publication: RemoteTrackPublication) => void;
|
|
96
|
+
trackSubscriptionFailed: (trackSid: string, reason?: SubscriptionError) => void;
|
|
97
|
+
trackUnpublished: (publication: RemoteTrackPublication) => void;
|
|
98
|
+
trackUnsubscribed: (track: RemoteTrack, publication: RemoteTrackPublication) => void;
|
|
99
|
+
trackMuted: (publication: TrackPublication) => void;
|
|
100
|
+
trackUnmuted: (publication: TrackPublication) => void;
|
|
101
|
+
localTrackPublished: (publication: LocalTrackPublication) => void;
|
|
102
|
+
localTrackUnpublished: (publication: LocalTrackPublication) => void;
|
|
103
|
+
localTrackCpuConstrained: (track: LocalVideoTrack, publication: LocalTrackPublication) => void;
|
|
104
|
+
localSenderCreated: (sender: RTCRtpSender, track: Track) => void;
|
|
105
|
+
participantMetadataChanged: (prevMetadata: string | undefined, participant?: any) => void;
|
|
106
|
+
participantNameChanged: (name: string) => void;
|
|
107
|
+
dataReceived: (payload: NonSharedUint8Array, kind: DataPacket_Kind, encryptionType?: Encryption_Type) => void;
|
|
108
|
+
sipDTMFReceived: (dtmf: SipDTMF) => void;
|
|
109
|
+
transcriptionReceived: (transcription: TranscriptionSegment[], publication?: TrackPublication) => void;
|
|
110
|
+
isSpeakingChanged: (speaking: boolean) => void;
|
|
111
|
+
connectionQualityChanged: (connectionQuality: ConnectionQuality) => void;
|
|
112
|
+
trackStreamStateChanged: (publication: RemoteTrackPublication, streamState: Track.StreamState) => void;
|
|
113
|
+
trackSubscriptionPermissionChanged: (publication: RemoteTrackPublication, status: TrackPublication.PermissionStatus) => void;
|
|
114
|
+
mediaDevicesError: (error: Error, kind?: MediaDeviceKind) => void;
|
|
115
|
+
audioStreamAcquired: () => void;
|
|
116
|
+
participantPermissionsChanged: (prevPermissions?: ParticipantPermission) => void;
|
|
117
|
+
trackSubscriptionStatusChanged: (publication: RemoteTrackPublication, status: TrackPublication.SubscriptionStatus) => void;
|
|
118
|
+
attributesChanged: (changedAttributes: Record<string, string>) => void;
|
|
119
|
+
localTrackSubscribed: (trackPublication: LocalTrackPublication) => void;
|
|
120
|
+
chatMessage: (msg: ChatMessage) => void;
|
|
121
|
+
active: () => void;
|
|
122
|
+
};
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { TrackPermission } from '@livekit/protocol';
|
|
2
|
+
export interface ParticipantTrackPermission {
|
|
3
|
+
/**
|
|
4
|
+
* The participant identity this permission applies to.
|
|
5
|
+
* You can either provide this or `participantSid`
|
|
6
|
+
*/
|
|
7
|
+
participantIdentity?: string;
|
|
8
|
+
/**
|
|
9
|
+
* The participant server id this permission applies to.
|
|
10
|
+
* You can either provide this or `participantIdentity`
|
|
11
|
+
*/
|
|
12
|
+
participantSid?: string;
|
|
13
|
+
/**
|
|
14
|
+
* Grant permission to all all tracks. Takes precedence over allowedTrackSids.
|
|
15
|
+
* false if unset.
|
|
16
|
+
*/
|
|
17
|
+
allowAll?: boolean;
|
|
18
|
+
/**
|
|
19
|
+
* The list of track ids that the target participant can subscribe to.
|
|
20
|
+
* When unset, it'll allow all tracks to be subscribed by the participant.
|
|
21
|
+
* When empty, this participant is disallowed from subscribing to any tracks.
|
|
22
|
+
*/
|
|
23
|
+
allowedTrackSids?: string[];
|
|
24
|
+
}
|
|
25
|
+
export declare function trackPermissionToProto(perms: ParticipantTrackPermission): TrackPermission;
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { DeferrableMap } from '../../utils/deferrable-map';
|
|
2
|
+
import type RemoteDataTrack from '../data-track/RemoteDataTrack';
|
|
3
|
+
import RemoteTrackPublication from '../track/RemoteTrackPublication';
|
|
4
|
+
import { Track } from '../track/Track';
|
|
5
|
+
import Participant from './Participant';
|
|
6
|
+
export default class RemoteParticipant extends Participant {
|
|
7
|
+
audioTrackPublications: Map<string, RemoteTrackPublication>;
|
|
8
|
+
videoTrackPublications: Map<string, RemoteTrackPublication>;
|
|
9
|
+
trackPublications: Map<string, RemoteTrackPublication>;
|
|
10
|
+
/** A map of data track name to the corresponding {@link RemoteDataTrack}.
|
|
11
|
+
* @example
|
|
12
|
+
* // An already existing data track:
|
|
13
|
+
* const track = remoteParticipant.dataTracks.get("data track name");
|
|
14
|
+
* // Wait for a data track which will be published soon:
|
|
15
|
+
* const track = await remoteParticipant.dataTracks.getDeferred("data track name"); */
|
|
16
|
+
dataTracks: DeferrableMap<RemoteDataTrack['info']['name'], RemoteDataTrack>;
|
|
17
|
+
private volumeMap;
|
|
18
|
+
private audioOutput?;
|
|
19
|
+
protected get logContext(): {
|
|
20
|
+
remoteParticipantID: string;
|
|
21
|
+
remoteParticipant: string;
|
|
22
|
+
};
|
|
23
|
+
protected addTrackPublication(publication: RemoteTrackPublication): void;
|
|
24
|
+
getTrackPublication(source: Track.Source): RemoteTrackPublication | undefined;
|
|
25
|
+
getTrackPublicationByName(name: string): RemoteTrackPublication | undefined;
|
|
26
|
+
/**
|
|
27
|
+
* sets the volume on the participant's audio track
|
|
28
|
+
* by default, this affects the microphone publication
|
|
29
|
+
* a different source can be passed in as a second argument
|
|
30
|
+
* if no track exists the volume will be applied when the microphone track is added
|
|
31
|
+
*/
|
|
32
|
+
setVolume(volume: number, source?: Track.Source.Microphone | Track.Source.ScreenShareAudio): void;
|
|
33
|
+
/**
|
|
34
|
+
* gets the volume on the participant's microphone track
|
|
35
|
+
*/
|
|
36
|
+
getVolume(source?: Track.Source.Microphone | Track.Source.ScreenShareAudio): number | undefined;
|
|
37
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import LocalVideoTrack from '../track/LocalVideoTrack';
|
|
2
|
+
import type { BackupVideoCodec, TrackPublishOptions } from '../track/options';
|
|
3
|
+
export declare function computeTrackBackupEncodings(track: LocalVideoTrack, videoCodec: BackupVideoCodec, opts: TrackPublishOptions): RTCRtpEncodingParameters[] | undefined;
|
|
4
|
+
/**
|
|
5
|
+
* Returns the appropriate degradation preference for a video track based on its source.
|
|
6
|
+
*
|
|
7
|
+
* - Camera: 'maintain-framerate' (smoother video for real-time communication)
|
|
8
|
+
* - Screen share: 'maintain-resolution' (clarity is critical for reading text/UI)
|
|
9
|
+
* - Other/unknown: 'balanced'
|
|
10
|
+
*/
|
|
11
|
+
export declare function getDefaultDegradationPreference(track: LocalVideoTrack): RTCDegradationPreference;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import type { RpcInvocationData } from '.';
|
|
2
|
+
import { RpcError } from '.';
|
|
3
|
+
import type TypedPromise from '../../utils/TypedPromise';
|
|
4
|
+
import type { CoreRoom } from '../CoreRoom';
|
|
5
|
+
import type { DataPacketOwner, ExtensionContext, LocalParticipantApiProvider, RoomApiProvider } from '../extensions';
|
|
6
|
+
import type { PerformRpcParams } from './utils';
|
|
7
|
+
/**
|
|
8
|
+
* Methods the `rpc` extension adds to the room.
|
|
9
|
+
* @experimental
|
|
10
|
+
*/
|
|
11
|
+
export interface RpcRoomApi {
|
|
12
|
+
/**
|
|
13
|
+
* Establishes the participant as a receiver for calls of the specified RPC method.
|
|
14
|
+
*
|
|
15
|
+
* @param method - The name of the indicated RPC method
|
|
16
|
+
* @param handler - Will be invoked when an RPC request for this method is received
|
|
17
|
+
* @returns A promise that resolves when the method is successfully registered
|
|
18
|
+
* @throws {Error} If a handler for this method is already registered (must call unregisterRpcMethod first)
|
|
19
|
+
*
|
|
20
|
+
* @example
|
|
21
|
+
* ```typescript
|
|
22
|
+
* room.localParticipant?.registerRpcMethod(
|
|
23
|
+
* 'greet',
|
|
24
|
+
* async (data: RpcInvocationData) => {
|
|
25
|
+
* console.log(`Received greeting from ${data.callerIdentity}: ${data.payload}`);
|
|
26
|
+
* return `Hello, ${data.callerIdentity}!`;
|
|
27
|
+
* }
|
|
28
|
+
* );
|
|
29
|
+
* ```
|
|
30
|
+
*
|
|
31
|
+
* The handler should return a Promise that resolves to a string.
|
|
32
|
+
* If unable to respond within `responseTimeout`, the request will result in an error on the caller's side.
|
|
33
|
+
*
|
|
34
|
+
* You may throw errors of type `RpcError` with a string `message` in the handler,
|
|
35
|
+
* and they will be received on the caller's side with the message intact.
|
|
36
|
+
* Other errors thrown in your handler will not be transmitted as-is, and will instead arrive to the caller as `1500` ("Application Error").
|
|
37
|
+
*/
|
|
38
|
+
registerRpcMethod(method: string, handler: (data: RpcInvocationData) => Promise<string>): void;
|
|
39
|
+
/**
|
|
40
|
+
* Unregisters a previously registered RPC method.
|
|
41
|
+
*
|
|
42
|
+
* @param method - The name of the RPC method to unregister
|
|
43
|
+
*/
|
|
44
|
+
unregisterRpcMethod(method: string): void;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Methods the `rpc` extension adds to the local participant.
|
|
48
|
+
* @experimental
|
|
49
|
+
*/
|
|
50
|
+
export interface RpcLocalParticipantApi {
|
|
51
|
+
/**
|
|
52
|
+
* Initiate an RPC call to a remote participant
|
|
53
|
+
* @param params - Parameters for initiating the RPC call, see {@link PerformRpcParams}
|
|
54
|
+
* @returns A promise that resolves with the response payload or rejects with an error.
|
|
55
|
+
* @throws Error on failure. Details in `message`.
|
|
56
|
+
*/
|
|
57
|
+
performRpc(params: PerformRpcParams): TypedPromise<string, RpcError>;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* RPC over the room (`performRpc`, `registerRpcMethod`). Requires {@link dataStreams}.
|
|
61
|
+
* @experimental
|
|
62
|
+
*/
|
|
63
|
+
export declare const rpc: {
|
|
64
|
+
key: symbol;
|
|
65
|
+
requires: readonly [
|
|
66
|
+
import("../extensions").ConfigurableExtension<RoomApiProvider<import("../data-stream/extension").DataStreamRoomApi> & LocalParticipantApiProvider<import("../data-stream/extension").DataStreamLocalParticipantApi> & import("../extensions").SlotProvider<"byteStreamOpener"> & DataPacketOwner & import("../extensions").EngineHooks & import("../extensions").ConnectionHooks & {
|
|
67
|
+
incoming: import("../data-stream/incoming/IncomingDataStreamManager").default;
|
|
68
|
+
outgoing: import("../data-stream/outgoing/OutgoingDataStreamManager").default;
|
|
69
|
+
}, import("../../options").RoomDataStreamOptions, readonly [
|
|
70
|
+
]>
|
|
71
|
+
];
|
|
72
|
+
install(room: CoreRoom, ctx: ExtensionContext): RoomApiProvider<RpcRoomApi> & LocalParticipantApiProvider<RpcLocalParticipantApi> & DataPacketOwner;
|
|
73
|
+
};
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export { default as RpcClientManager } from './client/RpcClientManager';
|
|
2
|
+
export type { RpcClientManagerCallbacks } from './client/events';
|
|
3
|
+
export { default as RpcServerManager } from './server/RpcServerManager';
|
|
4
|
+
export type { RpcServerManagerCallbacks } from './server/events';
|
|
5
|
+
export type { PerformRpcParams, RpcInvocationData } from './utils';
|
|
6
|
+
export { RpcError } from './utils';
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|