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,60 @@
|
|
|
1
|
+
import { ParticipantInfo } from '@livekit/protocol';
|
|
2
|
+
import { describe, expect, it } from 'vitest';
|
|
3
|
+
import Participant from './Participant';
|
|
4
|
+
|
|
5
|
+
describe('isOlderSession', () => {
|
|
6
|
+
function participantWith(info: Partial<ParticipantInfo>) {
|
|
7
|
+
const participant = new Participant(info.sid ?? '', 'tutor');
|
|
8
|
+
participant.updateInfo(new ParticipantInfo({ identity: 'tutor', ...info }));
|
|
9
|
+
return participant;
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
it('is false for the same session', () => {
|
|
13
|
+
const participant = participantWith({ sid: 'PA_b', joinedAt: 10n });
|
|
14
|
+
|
|
15
|
+
expect(participant.isOlderSession(new ParticipantInfo({ sid: 'PA_b', joinedAt: 5n }))).toBe(
|
|
16
|
+
false,
|
|
17
|
+
);
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
it('orders sessions by joinedAt first', () => {
|
|
21
|
+
const participant = participantWith({ sid: 'PA_b', joinedAt: 10n, joinedAtMs: 10_000n });
|
|
22
|
+
|
|
23
|
+
expect(
|
|
24
|
+
participant.isOlderSession(
|
|
25
|
+
new ParticipantInfo({ sid: 'PA_c', joinedAt: 9n, joinedAtMs: 11_000n }),
|
|
26
|
+
),
|
|
27
|
+
).toBe(true);
|
|
28
|
+
expect(
|
|
29
|
+
participant.isOlderSession(
|
|
30
|
+
new ParticipantInfo({ sid: 'PA_a', joinedAt: 11n, joinedAtMs: 9_000n }),
|
|
31
|
+
),
|
|
32
|
+
).toBe(false);
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
it('uses joinedAtMs when joinedAt is equal and both have joinedAtMs', () => {
|
|
36
|
+
const participant = participantWith({ sid: 'PA_b', joinedAt: 10n, joinedAtMs: 10_500n });
|
|
37
|
+
|
|
38
|
+
expect(
|
|
39
|
+
participant.isOlderSession(
|
|
40
|
+
new ParticipantInfo({ sid: 'PA_c', joinedAt: 10n, joinedAtMs: 10_100n }),
|
|
41
|
+
),
|
|
42
|
+
).toBe(true);
|
|
43
|
+
expect(
|
|
44
|
+
participant.isOlderSession(
|
|
45
|
+
new ParticipantInfo({ sid: 'PA_a', joinedAt: 10n, joinedAtMs: 10_900n }),
|
|
46
|
+
),
|
|
47
|
+
).toBe(false);
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
it('falls back to the higher sid when joinedAtMs is missing on either side', () => {
|
|
51
|
+
const participant = participantWith({ sid: 'PA_b', joinedAt: 10n, joinedAtMs: 10_500n });
|
|
52
|
+
|
|
53
|
+
expect(participant.isOlderSession(new ParticipantInfo({ sid: 'PA_a', joinedAt: 10n }))).toBe(
|
|
54
|
+
true,
|
|
55
|
+
);
|
|
56
|
+
expect(participant.isOlderSession(new ParticipantInfo({ sid: 'PA_c', joinedAt: 10n }))).toBe(
|
|
57
|
+
false,
|
|
58
|
+
);
|
|
59
|
+
});
|
|
60
|
+
});
|
|
@@ -91,7 +91,8 @@ export default class Participant extends (EventEmitter as new () => TypedEmitter
|
|
|
91
91
|
|
|
92
92
|
private _connectionQuality: ConnectionQuality = ConnectionQuality.Unknown;
|
|
93
93
|
|
|
94
|
-
|
|
94
|
+
/** @internal */
|
|
95
|
+
audioContext?: AudioContext;
|
|
95
96
|
|
|
96
97
|
protected log: StructuredLogger = log;
|
|
97
98
|
|
|
@@ -239,6 +240,25 @@ export default class Participant extends (EventEmitter as new () => TypedEmitter
|
|
|
239
240
|
return new Date();
|
|
240
241
|
}
|
|
241
242
|
|
|
243
|
+
/**
|
|
244
|
+
* @internal
|
|
245
|
+
* Whether `info` belongs to an older session of this identity than the stored one.
|
|
246
|
+
* Uses the same order as the server: `joinedAt`, then `joinedAtMs` when both are set, then sid.
|
|
247
|
+
*/
|
|
248
|
+
isOlderSession(info: ParticipantInfo): boolean {
|
|
249
|
+
const current = this.participantInfo;
|
|
250
|
+
if (!current || current.sid === info.sid) {
|
|
251
|
+
return false;
|
|
252
|
+
}
|
|
253
|
+
if (info.joinedAt !== current.joinedAt) {
|
|
254
|
+
return info.joinedAt < current.joinedAt;
|
|
255
|
+
}
|
|
256
|
+
if (info.joinedAtMs && current.joinedAtMs && info.joinedAtMs !== current.joinedAtMs) {
|
|
257
|
+
return info.joinedAtMs < current.joinedAtMs;
|
|
258
|
+
}
|
|
259
|
+
return info.sid < current.sid;
|
|
260
|
+
}
|
|
261
|
+
|
|
242
262
|
/** @internal */
|
|
243
263
|
updateInfo(info: ParticipantInfo): boolean {
|
|
244
264
|
// it's possible the update could be applied out of order due to await
|
|
@@ -8,9 +8,7 @@ import {
|
|
|
8
8
|
import type { SignalClient } from '../../api/SignalClient';
|
|
9
9
|
import { DeferrableMap } from '../../utils/deferrable-map';
|
|
10
10
|
import { CLIENT_PROTOCOL_DEFAULT } from '../../version';
|
|
11
|
-
import RemoteDataTrack from '../data-track/RemoteDataTrack';
|
|
12
|
-
import type IncomingDataTrackManager from '../data-track/incoming/IncomingDataTrackManager';
|
|
13
|
-
import { DataTrackInfo } from '../data-track/types';
|
|
11
|
+
import type RemoteDataTrack from '../data-track/RemoteDataTrack';
|
|
14
12
|
import { ParticipantEvent, TrackEvent } from '../events';
|
|
15
13
|
import RemoteAudioTrack from '../track/RemoteAudioTrack';
|
|
16
14
|
import type RemoteTrack from '../track/RemoteTrack';
|
|
@@ -41,6 +39,7 @@ export default class RemoteParticipant extends Participant {
|
|
|
41
39
|
* const track = await remoteParticipant.dataTracks.getDeferred("data track name"); */
|
|
42
40
|
dataTracks: DeferrableMap<RemoteDataTrack['info']['name'], RemoteDataTrack>;
|
|
43
41
|
|
|
42
|
+
/** @internal */
|
|
44
43
|
signalClient: SignalClient;
|
|
45
44
|
|
|
46
45
|
/** A version number indicating the set of features that the report participant's client supports.
|
|
@@ -67,7 +66,6 @@ export default class RemoteParticipant extends Participant {
|
|
|
67
66
|
signalClient: SignalClient,
|
|
68
67
|
pi: ParticipantInfo,
|
|
69
68
|
loggerOptions: LoggerOptions,
|
|
70
|
-
manager: IncomingDataTrackManager,
|
|
71
69
|
): RemoteParticipant {
|
|
72
70
|
return new RemoteParticipant(
|
|
73
71
|
signalClient,
|
|
@@ -78,10 +76,7 @@ export default class RemoteParticipant extends Participant {
|
|
|
78
76
|
pi.attributes,
|
|
79
77
|
loggerOptions,
|
|
80
78
|
pi.kind,
|
|
81
|
-
|
|
82
|
-
const info = DataTrackInfo.from(dti);
|
|
83
|
-
return new RemoteDataTrack(info, manager, { publisherIdentity: pi.identity });
|
|
84
|
-
}),
|
|
79
|
+
[],
|
|
85
80
|
pi.clientProtocol,
|
|
86
81
|
pi.capabilities,
|
|
87
82
|
);
|
|
@@ -38,13 +38,13 @@ export function mediaTrackToLocalTrack(
|
|
|
38
38
|
}
|
|
39
39
|
|
|
40
40
|
/* @internal */
|
|
41
|
-
export const presets169 = Object.values(VideoPresets);
|
|
41
|
+
export const presets169 = /* @__PURE__ */ Object.values(VideoPresets);
|
|
42
42
|
|
|
43
43
|
/* @internal */
|
|
44
|
-
export const presets43 = Object.values(VideoPresets43);
|
|
44
|
+
export const presets43 = /* @__PURE__ */ Object.values(VideoPresets43);
|
|
45
45
|
|
|
46
46
|
/* @internal */
|
|
47
|
-
export const presetsScreenShare = Object.values(ScreenSharePresets);
|
|
47
|
+
export const presetsScreenShare = /* @__PURE__ */ Object.values(ScreenSharePresets);
|
|
48
48
|
|
|
49
49
|
/* @internal */
|
|
50
50
|
export const defaultSimulcastPresets169 = [VideoPresets.h180, VideoPresets.h360];
|
|
@@ -3,7 +3,7 @@ import DeviceManager from '../DeviceManager';
|
|
|
3
3
|
import type LocalAudioTrack from '../track/LocalAudioTrack';
|
|
4
4
|
import { Track } from '../track/Track';
|
|
5
5
|
import { isChromiumBased, markDeviceAcquisitionFailure } from '../utils';
|
|
6
|
-
import LocalParticipant from './LocalParticipant';
|
|
6
|
+
import { LocalParticipant } from './LocalParticipant';
|
|
7
7
|
|
|
8
8
|
vi.mock('../utils', async () => {
|
|
9
9
|
const actual = await vi.importActual('../utils');
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
import { RpcClientManager, RpcError, type RpcInvocationData, RpcServerManager } from '.';
|
|
2
|
+
import type TypedPromise from '../../utils/TypedPromise';
|
|
3
|
+
import { CLIENT_PROTOCOL_DEFAULT } from '../../version';
|
|
4
|
+
import type { CoreRoom } from '../CoreRoom';
|
|
5
|
+
import { DataChannelKind } from '../data-channel/types';
|
|
6
|
+
import { dataStreams } from '../data-stream/extension';
|
|
7
|
+
import { RoomEvent } from '../events';
|
|
8
|
+
import type {
|
|
9
|
+
DataPacketOwner,
|
|
10
|
+
ExtensionContext,
|
|
11
|
+
LocalParticipantApiProvider,
|
|
12
|
+
RoomApiProvider,
|
|
13
|
+
RoomExtension,
|
|
14
|
+
} from '../extensions';
|
|
15
|
+
import {
|
|
16
|
+
type PerformRpcParams,
|
|
17
|
+
RPC_REQUEST_DATA_STREAM_TOPIC,
|
|
18
|
+
RPC_RESPONSE_DATA_STREAM_TOPIC,
|
|
19
|
+
} from './utils';
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* Methods the `rpc` extension adds to the room.
|
|
23
|
+
* @experimental
|
|
24
|
+
*/
|
|
25
|
+
export interface RpcRoomApi {
|
|
26
|
+
/**
|
|
27
|
+
* Establishes the participant as a receiver for calls of the specified RPC method.
|
|
28
|
+
*
|
|
29
|
+
* @param method - The name of the indicated RPC method
|
|
30
|
+
* @param handler - Will be invoked when an RPC request for this method is received
|
|
31
|
+
* @returns A promise that resolves when the method is successfully registered
|
|
32
|
+
* @throws {Error} If a handler for this method is already registered (must call unregisterRpcMethod first)
|
|
33
|
+
*
|
|
34
|
+
* @example
|
|
35
|
+
* ```typescript
|
|
36
|
+
* room.localParticipant?.registerRpcMethod(
|
|
37
|
+
* 'greet',
|
|
38
|
+
* async (data: RpcInvocationData) => {
|
|
39
|
+
* console.log(`Received greeting from ${data.callerIdentity}: ${data.payload}`);
|
|
40
|
+
* return `Hello, ${data.callerIdentity}!`;
|
|
41
|
+
* }
|
|
42
|
+
* );
|
|
43
|
+
* ```
|
|
44
|
+
*
|
|
45
|
+
* The handler should return a Promise that resolves to a string.
|
|
46
|
+
* If unable to respond within `responseTimeout`, the request will result in an error on the caller's side.
|
|
47
|
+
*
|
|
48
|
+
* You may throw errors of type `RpcError` with a string `message` in the handler,
|
|
49
|
+
* and they will be received on the caller's side with the message intact.
|
|
50
|
+
* Other errors thrown in your handler will not be transmitted as-is, and will instead arrive to the caller as `1500` ("Application Error").
|
|
51
|
+
*/
|
|
52
|
+
registerRpcMethod(method: string, handler: (data: RpcInvocationData) => Promise<string>): void;
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Unregisters a previously registered RPC method.
|
|
56
|
+
*
|
|
57
|
+
* @param method - The name of the RPC method to unregister
|
|
58
|
+
*/
|
|
59
|
+
unregisterRpcMethod(method: string): void;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* Methods the `rpc` extension adds to the local participant.
|
|
64
|
+
* @experimental
|
|
65
|
+
*/
|
|
66
|
+
export interface RpcLocalParticipantApi {
|
|
67
|
+
/**
|
|
68
|
+
* Initiate an RPC call to a remote participant
|
|
69
|
+
* @param params - Parameters for initiating the RPC call, see {@link PerformRpcParams}
|
|
70
|
+
* @returns A promise that resolves with the response payload or rejects with an error.
|
|
71
|
+
* @throws Error on failure. Details in `message`.
|
|
72
|
+
*/
|
|
73
|
+
performRpc(params: PerformRpcParams): TypedPromise<string, RpcError>;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* RPC over the room (`performRpc`, `registerRpcMethod`). Requires {@link dataStreams}.
|
|
78
|
+
* @experimental
|
|
79
|
+
*/
|
|
80
|
+
export const rpc = {
|
|
81
|
+
key: /* @__PURE__ */ Symbol('lk.extension.rpc'),
|
|
82
|
+
requires: [dataStreams] as const,
|
|
83
|
+
install(
|
|
84
|
+
room: CoreRoom,
|
|
85
|
+
ctx: ExtensionContext,
|
|
86
|
+
): RoomApiProvider<RpcRoomApi> &
|
|
87
|
+
LocalParticipantApiProvider<RpcLocalParticipantApi> &
|
|
88
|
+
DataPacketOwner {
|
|
89
|
+
const { incoming, outgoing } = ctx.get(dataStreams);
|
|
90
|
+
const clientProtocol = (identity: string) =>
|
|
91
|
+
room.remoteParticipants.get(identity)?.clientProtocol ?? CLIENT_PROTOCOL_DEFAULT;
|
|
92
|
+
|
|
93
|
+
const client = new RpcClientManager(
|
|
94
|
+
ctx.log,
|
|
95
|
+
outgoing,
|
|
96
|
+
clientProtocol,
|
|
97
|
+
() => room.engine?.serverVersion,
|
|
98
|
+
);
|
|
99
|
+
client.on('sendDataPacket', ({ packet }) => {
|
|
100
|
+
room.engine?.sendDataPacket(packet, DataChannelKind.RELIABLE);
|
|
101
|
+
});
|
|
102
|
+
const server = new RpcServerManager(ctx.log, outgoing, clientProtocol);
|
|
103
|
+
server.on('sendDataPacket', ({ packet }) => {
|
|
104
|
+
room.engine?.sendDataPacket(packet, DataChannelKind.RELIABLE);
|
|
105
|
+
});
|
|
106
|
+
|
|
107
|
+
incoming.registerTextStreamHandler(
|
|
108
|
+
RPC_REQUEST_DATA_STREAM_TOPIC,
|
|
109
|
+
async (reader, { identity }) => {
|
|
110
|
+
await server.handleIncomingDataStream(reader, identity, reader.info.attributes ?? {});
|
|
111
|
+
},
|
|
112
|
+
);
|
|
113
|
+
incoming.registerTextStreamHandler(
|
|
114
|
+
RPC_RESPONSE_DATA_STREAM_TOPIC,
|
|
115
|
+
async (reader, { identity }) => {
|
|
116
|
+
await client.handleIncomingDataStream(reader, identity, reader.info.attributes ?? {});
|
|
117
|
+
},
|
|
118
|
+
);
|
|
119
|
+
|
|
120
|
+
room.on(RoomEvent.ParticipantDisconnected, (participant) =>
|
|
121
|
+
client.handleParticipantDisconnected(participant.identity),
|
|
122
|
+
);
|
|
123
|
+
|
|
124
|
+
const registerRpcMethod: RpcRoomApi['registerRpcMethod'] = (method, handler) =>
|
|
125
|
+
server.registerRpcMethod(method, handler);
|
|
126
|
+
const unregisterRpcMethod: RpcRoomApi['unregisterRpcMethod'] = (method) =>
|
|
127
|
+
server.unregisterRpcMethod(method);
|
|
128
|
+
|
|
129
|
+
return {
|
|
130
|
+
dataPackets: {
|
|
131
|
+
rpcRequest: (request, packet) => {
|
|
132
|
+
server.handleIncomingRpcRequest(packet.participantIdentity, request);
|
|
133
|
+
},
|
|
134
|
+
rpcResponse: (response) => {
|
|
135
|
+
switch (response.value.case) {
|
|
136
|
+
case 'payload':
|
|
137
|
+
client.handleIncomingRpcResponseSuccess(response.requestId, response.value.value);
|
|
138
|
+
break;
|
|
139
|
+
case 'error':
|
|
140
|
+
client.handleIncomingRpcResponseFailure(
|
|
141
|
+
response.requestId,
|
|
142
|
+
RpcError.fromProto(response.value.value),
|
|
143
|
+
);
|
|
144
|
+
break;
|
|
145
|
+
default:
|
|
146
|
+
ctx.log.warn(`Unknown rpcResponse.value.case: ${response.value.case}`);
|
|
147
|
+
break;
|
|
148
|
+
}
|
|
149
|
+
},
|
|
150
|
+
rpcAck: (ack) => client.handleIncomingRpcAck(ack.requestId),
|
|
151
|
+
},
|
|
152
|
+
room: { registerRpcMethod, unregisterRpcMethod },
|
|
153
|
+
localParticipant: {
|
|
154
|
+
performRpc: (params) =>
|
|
155
|
+
client.performRpc(params).then(([_id, completionPromise]) => completionPromise),
|
|
156
|
+
},
|
|
157
|
+
};
|
|
158
|
+
},
|
|
159
|
+
} satisfies RoomExtension<RpcRoomApi, RpcLocalParticipantApi>;
|
package/src/room/rpc/index.ts
CHANGED
|
@@ -2,13 +2,4 @@ export { default as RpcClientManager } from './client/RpcClientManager';
|
|
|
2
2
|
export type { RpcClientManagerCallbacks } from './client/events';
|
|
3
3
|
export { default as RpcServerManager } from './server/RpcServerManager';
|
|
4
4
|
export type { RpcServerManagerCallbacks } from './server/events';
|
|
5
|
-
export {
|
|
6
|
-
type PerformRpcParams,
|
|
7
|
-
RPC_REQUEST_DATA_STREAM_TOPIC,
|
|
8
|
-
RPC_RESPONSE_DATA_STREAM_TOPIC,
|
|
9
|
-
RpcRequestAttrs,
|
|
10
|
-
RpcError,
|
|
11
|
-
type RpcInvocationData,
|
|
12
|
-
byteLength,
|
|
13
|
-
truncateBytes,
|
|
14
|
-
} from './utils';
|
|
5
|
+
export { type PerformRpcParams, RpcError, type RpcInvocationData } from './utils';
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import type { CoreRoom } from '../CoreRoom';
|
|
2
|
+
import type { ExtensionContext, LocalParticipantApiProvider, RoomExtension } from '../extensions';
|
|
3
|
+
import type { RpcRoomApi } from './extension';
|
|
4
|
+
import { rpc } from './extension';
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* The deprecated rpc methods on the local participant.
|
|
8
|
+
* @experimental
|
|
9
|
+
*/
|
|
10
|
+
export interface RpcLegacyLocalParticipantApi {
|
|
11
|
+
/**
|
|
12
|
+
* @deprecated use `room.registerRpcMethod` instead
|
|
13
|
+
*/
|
|
14
|
+
registerRpcMethod: RpcRoomApi['registerRpcMethod'];
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* @deprecated use `room.unregisterRpcMethod` instead
|
|
18
|
+
*/
|
|
19
|
+
unregisterRpcMethod: RpcRoomApi['unregisterRpcMethod'];
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* `localParticipant.registerRpcMethod` and `unregisterRpcMethod`, which forward to the room.
|
|
24
|
+
* Superseded by the room methods; the full `Room` keeps them, the core entry does not offer them.
|
|
25
|
+
*/
|
|
26
|
+
export const rpcLegacy = {
|
|
27
|
+
key: /* @__PURE__ */ Symbol('lk.extension.rpcLegacy'),
|
|
28
|
+
requires: [rpc] as const,
|
|
29
|
+
install(
|
|
30
|
+
_room: CoreRoom,
|
|
31
|
+
ctx: ExtensionContext,
|
|
32
|
+
): LocalParticipantApiProvider<RpcLegacyLocalParticipantApi> {
|
|
33
|
+
const { registerRpcMethod, unregisterRpcMethod } = ctx.get(rpc).room;
|
|
34
|
+
return { localParticipant: { registerRpcMethod, unregisterRpcMethod } };
|
|
35
|
+
},
|
|
36
|
+
} satisfies RoomExtension<{}, RpcLegacyLocalParticipantApi>;
|
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
import {
|
|
2
|
+
ParticipantInfo,
|
|
3
|
+
ParticipantInfo_State,
|
|
4
|
+
Room as RoomModel,
|
|
5
|
+
TrackInfo,
|
|
6
|
+
TrackSource,
|
|
7
|
+
TrackType,
|
|
8
|
+
protoInt64,
|
|
9
|
+
} from '@livekit/protocol';
|
|
10
|
+
import type { CoreRoom } from '../CoreRoom';
|
|
11
|
+
import { ParticipantEvent } from '../events';
|
|
12
|
+
import type { ExtensionContext, RoomApiProvider, RoomExtension } from '../extensions';
|
|
13
|
+
import LocalAudioTrack from '../track/LocalAudioTrack';
|
|
14
|
+
import LocalTrackPublication from '../track/LocalTrackPublication';
|
|
15
|
+
import { Track } from '../track/Track';
|
|
16
|
+
import { getVideoCapture } from '../track/create';
|
|
17
|
+
import type { SimulationOptions } from '../types';
|
|
18
|
+
import { createDummyVideoStreamTrack } from '../utils';
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Methods the `simulatedParticipants` extension adds to the room.
|
|
22
|
+
* @experimental
|
|
23
|
+
*/
|
|
24
|
+
export interface SimulatedParticipantsRoomApi {
|
|
25
|
+
/**
|
|
26
|
+
* Allows to populate a room with simulated participants.
|
|
27
|
+
* No actual connection to a server will be established, all state is
|
|
28
|
+
* @experimental
|
|
29
|
+
*/
|
|
30
|
+
simulateParticipants(options: SimulationOptions): Promise<void>;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Fills a room with fake participants and dummy media without a server. A development tool;
|
|
35
|
+
* the `video` extension must be installed when simulated participants publish video.
|
|
36
|
+
* @experimental
|
|
37
|
+
*/
|
|
38
|
+
export const simulatedParticipants = {
|
|
39
|
+
key: /* @__PURE__ */ Symbol('lk.extension.simulatedParticipants'),
|
|
40
|
+
install(room: CoreRoom, ctx: ExtensionContext): RoomApiProvider<SimulatedParticipantsRoomApi> {
|
|
41
|
+
return {
|
|
42
|
+
room: {
|
|
43
|
+
simulateParticipants: (options) => simulateParticipants(room, ctx, options),
|
|
44
|
+
},
|
|
45
|
+
};
|
|
46
|
+
},
|
|
47
|
+
} satisfies RoomExtension<SimulatedParticipantsRoomApi>;
|
|
48
|
+
|
|
49
|
+
async function simulateParticipants(
|
|
50
|
+
room: CoreRoom,
|
|
51
|
+
ctx: ExtensionContext,
|
|
52
|
+
options: SimulationOptions,
|
|
53
|
+
) {
|
|
54
|
+
const publishOptions = {
|
|
55
|
+
audio: true,
|
|
56
|
+
video: true,
|
|
57
|
+
useRealTracks: false,
|
|
58
|
+
...options.publish,
|
|
59
|
+
};
|
|
60
|
+
const participantOptions = {
|
|
61
|
+
count: 9,
|
|
62
|
+
audio: false,
|
|
63
|
+
video: true,
|
|
64
|
+
aspectRatios: [1.66, 1.7, 1.3],
|
|
65
|
+
...options.participants,
|
|
66
|
+
};
|
|
67
|
+
const participant = room.localParticipant;
|
|
68
|
+
const loggerOptions = participant.trackLoggerOptions;
|
|
69
|
+
|
|
70
|
+
ctx.simulateConnected(
|
|
71
|
+
new RoomModel({
|
|
72
|
+
sid: 'RM_SIMULATED',
|
|
73
|
+
name: 'simulated-room',
|
|
74
|
+
emptyTimeout: 0,
|
|
75
|
+
maxParticipants: 0,
|
|
76
|
+
creationTime: protoInt64.parse(new Date().getTime()),
|
|
77
|
+
metadata: '',
|
|
78
|
+
numParticipants: 1,
|
|
79
|
+
numPublishers: 1,
|
|
80
|
+
turnPassword: '',
|
|
81
|
+
enabledCodecs: [],
|
|
82
|
+
activeRecording: false,
|
|
83
|
+
}),
|
|
84
|
+
new ParticipantInfo({
|
|
85
|
+
identity: 'simulated-local',
|
|
86
|
+
name: 'local-name',
|
|
87
|
+
}),
|
|
88
|
+
);
|
|
89
|
+
|
|
90
|
+
if (publishOptions.video) {
|
|
91
|
+
const camPub = new LocalTrackPublication(
|
|
92
|
+
Track.Kind.Video,
|
|
93
|
+
new TrackInfo({
|
|
94
|
+
source: TrackSource.CAMERA,
|
|
95
|
+
sid: Math.floor(Math.random() * 10_000).toString(),
|
|
96
|
+
type: TrackType.AUDIO,
|
|
97
|
+
name: 'video-dummy',
|
|
98
|
+
}),
|
|
99
|
+
getVideoCapture().createTrack(
|
|
100
|
+
publishOptions.useRealTracks && window.navigator.mediaDevices?.getUserMedia
|
|
101
|
+
? (await window.navigator.mediaDevices.getUserMedia({ video: true })).getVideoTracks()[0]
|
|
102
|
+
: createDummyVideoStreamTrack(
|
|
103
|
+
160 * (participantOptions.aspectRatios[0] ?? 1),
|
|
104
|
+
160,
|
|
105
|
+
true,
|
|
106
|
+
true,
|
|
107
|
+
),
|
|
108
|
+
undefined,
|
|
109
|
+
false,
|
|
110
|
+
loggerOptions,
|
|
111
|
+
),
|
|
112
|
+
loggerOptions,
|
|
113
|
+
);
|
|
114
|
+
// @ts-ignore
|
|
115
|
+
participant.addTrackPublication(camPub);
|
|
116
|
+
participant.emit(ParticipantEvent.LocalTrackPublished, camPub);
|
|
117
|
+
}
|
|
118
|
+
if (publishOptions.audio) {
|
|
119
|
+
const audioPub = new LocalTrackPublication(
|
|
120
|
+
Track.Kind.Audio,
|
|
121
|
+
new TrackInfo({
|
|
122
|
+
source: TrackSource.MICROPHONE,
|
|
123
|
+
sid: Math.floor(Math.random() * 10_000).toString(),
|
|
124
|
+
type: TrackType.AUDIO,
|
|
125
|
+
}),
|
|
126
|
+
new LocalAudioTrack(
|
|
127
|
+
publishOptions.useRealTracks && navigator.mediaDevices?.getUserMedia
|
|
128
|
+
? (await navigator.mediaDevices.getUserMedia({ audio: true })).getAudioTracks()[0]
|
|
129
|
+
: ctx.acquireEmptyAudioStreamTrack(),
|
|
130
|
+
undefined,
|
|
131
|
+
false,
|
|
132
|
+
participant.audioContext,
|
|
133
|
+
loggerOptions,
|
|
134
|
+
),
|
|
135
|
+
loggerOptions,
|
|
136
|
+
);
|
|
137
|
+
// @ts-ignore
|
|
138
|
+
participant.addTrackPublication(audioPub);
|
|
139
|
+
participant.emit(ParticipantEvent.LocalTrackPublished, audioPub);
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
for (let i = 0; i < participantOptions.count - 1; i += 1) {
|
|
143
|
+
let info: ParticipantInfo = new ParticipantInfo({
|
|
144
|
+
sid: Math.floor(Math.random() * 10_000).toString(),
|
|
145
|
+
identity: `simulated-${i}`,
|
|
146
|
+
state: ParticipantInfo_State.ACTIVE,
|
|
147
|
+
tracks: [],
|
|
148
|
+
joinedAt: protoInt64.parse(Date.now()),
|
|
149
|
+
});
|
|
150
|
+
const p = ctx.getOrCreateParticipant(info.identity, info);
|
|
151
|
+
if (participantOptions.video) {
|
|
152
|
+
const dummyVideo = createDummyVideoStreamTrack(
|
|
153
|
+
160 * (participantOptions.aspectRatios[i % participantOptions.aspectRatios.length] ?? 1),
|
|
154
|
+
160,
|
|
155
|
+
false,
|
|
156
|
+
true,
|
|
157
|
+
);
|
|
158
|
+
const videoTrack = new TrackInfo({
|
|
159
|
+
source: TrackSource.CAMERA,
|
|
160
|
+
sid: Math.floor(Math.random() * 10_000).toString(),
|
|
161
|
+
type: TrackType.AUDIO,
|
|
162
|
+
});
|
|
163
|
+
p.addSubscribedMediaTrack(
|
|
164
|
+
dummyVideo,
|
|
165
|
+
videoTrack.sid,
|
|
166
|
+
new MediaStream([dummyVideo]),
|
|
167
|
+
new RTCRtpReceiver(),
|
|
168
|
+
);
|
|
169
|
+
info.tracks = [...info.tracks, videoTrack];
|
|
170
|
+
}
|
|
171
|
+
if (participantOptions.audio) {
|
|
172
|
+
const dummyTrack = ctx.acquireEmptyAudioStreamTrack();
|
|
173
|
+
const audioTrack = new TrackInfo({
|
|
174
|
+
source: TrackSource.MICROPHONE,
|
|
175
|
+
sid: Math.floor(Math.random() * 10_000).toString(),
|
|
176
|
+
type: TrackType.AUDIO,
|
|
177
|
+
});
|
|
178
|
+
p.addSubscribedMediaTrack(
|
|
179
|
+
dummyTrack,
|
|
180
|
+
audioTrack.sid,
|
|
181
|
+
new MediaStream([dummyTrack]),
|
|
182
|
+
new RTCRtpReceiver(),
|
|
183
|
+
);
|
|
184
|
+
info.tracks = [...info.tracks, audioTrack];
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
p.updateInfo(info);
|
|
188
|
+
}
|
|
189
|
+
}
|
|
@@ -291,6 +291,35 @@ describe('TokenSourceConfigurable caching behavior (via TokenSource.custom)', ()
|
|
|
291
291
|
expect(customFn).toHaveBeenCalledTimes(2);
|
|
292
292
|
});
|
|
293
293
|
|
|
294
|
+
it('does not refetch when participantAttributes is an equal new object', async () => {
|
|
295
|
+
const customFn = vi.fn().mockResolvedValue(makeResponseObject());
|
|
296
|
+
const tokenSource = TokenSource.custom(customFn);
|
|
297
|
+
|
|
298
|
+
await tokenSource.fetch({ roomName: 'room', participantAttributes: { key: 'value' } });
|
|
299
|
+
await tokenSource.fetch({ roomName: 'room', participantAttributes: { key: 'value' } });
|
|
300
|
+
|
|
301
|
+
expect(customFn).toHaveBeenCalledTimes(1);
|
|
302
|
+
});
|
|
303
|
+
|
|
304
|
+
it('does not return the previous response for options whose fetch failed', async () => {
|
|
305
|
+
const roomA = makeResponseObject();
|
|
306
|
+
const customFn = vi
|
|
307
|
+
.fn()
|
|
308
|
+
.mockResolvedValueOnce(roomA)
|
|
309
|
+
.mockRejectedValueOnce(new Error('token server unavailable'))
|
|
310
|
+
.mockResolvedValueOnce(makeResponseObject(TOKENS.VALID_NO_NBF));
|
|
311
|
+
const tokenSource = TokenSource.custom(customFn);
|
|
312
|
+
|
|
313
|
+
await tokenSource.fetch({ roomName: 'room-a' });
|
|
314
|
+
await expect(tokenSource.fetch({ roomName: 'room-b' })).rejects.toThrow(
|
|
315
|
+
'token server unavailable',
|
|
316
|
+
);
|
|
317
|
+
const roomB = await tokenSource.fetch({ roomName: 'room-b' });
|
|
318
|
+
|
|
319
|
+
expect(customFn).toHaveBeenCalledTimes(3);
|
|
320
|
+
expect(roomB.participantToken).toStrictEqual(TOKENS.VALID_NO_NBF);
|
|
321
|
+
});
|
|
322
|
+
|
|
294
323
|
it('getCachedResponseJwtPayload returns null before first fetch', () => {
|
|
295
324
|
const tokenSource = TokenSource.custom(async () => makeResponseObject());
|
|
296
325
|
expect(tokenSource.getCachedResponseJwtPayload()).toBeNull();
|
|
@@ -14,7 +14,11 @@ import {
|
|
|
14
14
|
import { areTokenSourceFetchOptionsEqual, decodeTokenPayload, isResponseTokenValid } from './utils';
|
|
15
15
|
|
|
16
16
|
/** A TokenSourceCached is a TokenSource which caches the last {@link TokenSourceResponseObject} value and returns it
|
|
17
|
-
* until a) it expires or b) the {@link TokenSourceFetchOptions} provided to .fetch(...) change.
|
|
17
|
+
* until a) it expires or b) the {@link TokenSourceFetchOptions} provided to .fetch(...) change.
|
|
18
|
+
*
|
|
19
|
+
* Options are compared by value (including the entries of `participantAttributes`), but the cache keeps a
|
|
20
|
+
* reference to the options object passed to the last successful fetch. Treat that object as immutable: to fetch
|
|
21
|
+
* with different options, pass a new object rather than changing the previous one in place. */
|
|
18
22
|
abstract class TokenSourceCached extends TokenSourceConfigurable {
|
|
19
23
|
private cachedFetchOptions: TokenSourceFetchOptions | null = null;
|
|
20
24
|
|
|
@@ -62,9 +66,10 @@ abstract class TokenSourceCached extends TokenSourceConfigurable {
|
|
|
62
66
|
if (this.shouldReturnCachedValueFromFetch(options)) {
|
|
63
67
|
return this.cachedResponse!.toJson() as TokenSourceResponseObject;
|
|
64
68
|
}
|
|
65
|
-
this.cachedFetchOptions = options;
|
|
66
|
-
|
|
67
69
|
const tokenResponse = await this.update(options);
|
|
70
|
+
// recorded only once the update succeeds, so a failed fetch cannot pair its options
|
|
71
|
+
// with the response cached for the previous ones
|
|
72
|
+
this.cachedFetchOptions = options;
|
|
68
73
|
this.cachedResponse = tokenResponse;
|
|
69
74
|
return tokenResponse.toJson() as TokenSourceResponseObject;
|
|
70
75
|
} finally {
|
|
@@ -113,4 +113,38 @@ describe('areTokenSourceFetchOptionsEqual', () => {
|
|
|
113
113
|
),
|
|
114
114
|
).to.equal(false);
|
|
115
115
|
});
|
|
116
|
+
it('should compare participant attributes by content', () => {
|
|
117
|
+
expect(
|
|
118
|
+
areTokenSourceFetchOptionsEqual(
|
|
119
|
+
{ participantAttributes: { a: '1', b: '2' } },
|
|
120
|
+
{ participantAttributes: { b: '2', a: '1' } },
|
|
121
|
+
),
|
|
122
|
+
).to.equal(true);
|
|
123
|
+
expect(
|
|
124
|
+
areTokenSourceFetchOptionsEqual(
|
|
125
|
+
{ participantAttributes: { a: '1' } },
|
|
126
|
+
{ participantAttributes: { a: '2' } },
|
|
127
|
+
),
|
|
128
|
+
).to.equal(false);
|
|
129
|
+
expect(
|
|
130
|
+
areTokenSourceFetchOptionsEqual(
|
|
131
|
+
{ participantAttributes: { a: '1' } },
|
|
132
|
+
{ participantAttributes: { a: '1', b: '2' } },
|
|
133
|
+
),
|
|
134
|
+
).to.equal(false);
|
|
135
|
+
expect(
|
|
136
|
+
areTokenSourceFetchOptionsEqual(
|
|
137
|
+
{ participantAttributes: { role: 'viewer' } },
|
|
138
|
+
{
|
|
139
|
+
participantAttributes: Object.assign(Object.create({ role: 'viewer' }), { team: 'blue' }),
|
|
140
|
+
},
|
|
141
|
+
),
|
|
142
|
+
).to.equal(false);
|
|
143
|
+
expect(
|
|
144
|
+
areTokenSourceFetchOptionsEqual(
|
|
145
|
+
{ participantAttributes: {} },
|
|
146
|
+
{ participantAttributes: undefined },
|
|
147
|
+
),
|
|
148
|
+
).to.equal(false);
|
|
149
|
+
});
|
|
116
150
|
});
|