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.
Files changed (869) hide show
  1. package/README.md +48 -32
  2. package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs +48 -0
  3. package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs.map +1 -0
  4. package/dist/core/api/SignalClient.mjs +1212 -0
  5. package/dist/core/api/SignalClient.mjs.map +1 -0
  6. package/dist/core/api/SignalClientStateMachine.mjs +115 -0
  7. package/dist/core/api/SignalClientStateMachine.mjs.map +1 -0
  8. package/dist/core/api/WebSocketStream.mjs +146 -0
  9. package/dist/core/api/WebSocketStream.mjs.map +1 -0
  10. package/dist/core/api/utils.mjs +66 -0
  11. package/dist/core/api/utils.mjs.map +1 -0
  12. package/dist/core/connectionHelper/ConnectionCheck.mjs +89 -0
  13. package/dist/core/connectionHelper/ConnectionCheck.mjs.map +1 -0
  14. package/dist/core/connectionHelper/checks/Checker.mjs +146 -0
  15. package/dist/core/connectionHelper/checks/Checker.mjs.map +1 -0
  16. package/dist/core/connectionHelper/checks/cloudRegion.mjs +82 -0
  17. package/dist/core/connectionHelper/checks/cloudRegion.mjs.map +1 -0
  18. package/dist/core/connectionHelper/checks/connectionProtocol.mjs +111 -0
  19. package/dist/core/connectionHelper/checks/connectionProtocol.mjs.map +1 -0
  20. package/dist/core/connectionHelper/checks/publishAudio.mjs +35 -0
  21. package/dist/core/connectionHelper/checks/publishAudio.mjs.map +1 -0
  22. package/dist/core/connectionHelper/checks/publishVideo.mjs +82 -0
  23. package/dist/core/connectionHelper/checks/publishVideo.mjs.map +1 -0
  24. package/dist/core/connectionHelper/checks/reconnect.mjs +37 -0
  25. package/dist/core/connectionHelper/checks/reconnect.mjs.map +1 -0
  26. package/dist/core/connectionHelper/checks/turn.mjs +56 -0
  27. package/dist/core/connectionHelper/checks/turn.mjs.map +1 -0
  28. package/dist/core/connectionHelper/checks/webrtc.mjs +73 -0
  29. package/dist/core/connectionHelper/checks/webrtc.mjs.map +1 -0
  30. package/dist/core/connectionHelper/checks/websocket.mjs +47 -0
  31. package/dist/core/connectionHelper/checks/websocket.mjs.map +1 -0
  32. package/dist/core/core.mjs +1 -0
  33. package/dist/core/core.mjs.map +1 -0
  34. package/dist/core/e2ee/E2eeManager.mjs +603 -0
  35. package/dist/core/e2ee/E2eeManager.mjs.map +1 -0
  36. package/dist/core/e2ee/KeyProvider.mjs +95 -0
  37. package/dist/core/e2ee/KeyProvider.mjs.map +1 -0
  38. package/dist/core/e2ee/constants.mjs +19 -0
  39. package/dist/core/e2ee/constants.mjs.map +1 -0
  40. package/dist/core/e2ee/errors.mjs +15 -0
  41. package/dist/core/e2ee/errors.mjs.map +1 -0
  42. package/dist/core/e2ee/events.mjs +24 -0
  43. package/dist/core/e2ee/events.mjs.map +1 -0
  44. package/dist/core/e2ee/extension.mjs +70 -0
  45. package/dist/core/e2ee/extension.mjs.map +1 -0
  46. package/dist/core/e2ee/utils.mjs +168 -0
  47. package/dist/core/e2ee/utils.mjs.map +1 -0
  48. package/dist/core/frameMetadata/FrameMetadataManager.mjs +205 -0
  49. package/dist/core/frameMetadata/FrameMetadataManager.mjs.map +1 -0
  50. package/dist/core/frameMetadata/extension.mjs +17 -0
  51. package/dist/core/frameMetadata/extension.mjs.map +1 -0
  52. package/dist/core/frameMetadata/utils.mjs +42 -0
  53. package/dist/core/frameMetadata/utils.mjs.map +1 -0
  54. package/dist/core/logger.mjs +111 -0
  55. package/dist/core/logger.mjs.map +1 -0
  56. package/dist/core/package.json.mjs +1 -0
  57. package/dist/core/package.json.mjs.map +1 -0
  58. package/dist/core/room/BackOffStrategy.mjs +60 -0
  59. package/dist/core/room/BackOffStrategy.mjs.map +1 -0
  60. package/dist/core/room/CoreRoom.mjs +2279 -0
  61. package/dist/core/room/CoreRoom.mjs.map +1 -0
  62. package/dist/core/room/DefaultReconnectPolicy.mjs +23 -0
  63. package/dist/core/room/DefaultReconnectPolicy.mjs.map +1 -0
  64. package/dist/core/room/DeviceManager.mjs +92 -0
  65. package/dist/core/room/DeviceManager.mjs.map +1 -0
  66. package/dist/core/room/PCTransport.mjs +1110 -0
  67. package/dist/core/room/PCTransport.mjs.map +1 -0
  68. package/dist/core/room/PCTransportManager.mjs +360 -0
  69. package/dist/core/room/PCTransportManager.mjs.map +1 -0
  70. package/dist/core/room/RTCEngine.mjs +1830 -0
  71. package/dist/core/room/RTCEngine.mjs.map +1 -0
  72. package/dist/core/room/RegionUrlProvider.mjs +194 -0
  73. package/dist/core/room/RegionUrlProvider.mjs.map +1 -0
  74. package/dist/core/room/attribute-typings.mjs +24 -0
  75. package/dist/core/room/attribute-typings.mjs.map +1 -0
  76. package/dist/core/room/createRoom.mjs +19 -0
  77. package/dist/core/room/createRoom.mjs.map +1 -0
  78. package/dist/core/room/data-channel/DataChannelManager.mjs +188 -0
  79. package/dist/core/room/data-channel/DataChannelManager.mjs.map +1 -0
  80. package/dist/core/room/data-channel/FlowControlledDataChannel.mjs +185 -0
  81. package/dist/core/room/data-channel/FlowControlledDataChannel.mjs.map +1 -0
  82. package/dist/core/room/data-channel/LossyDataChannel.mjs +99 -0
  83. package/dist/core/room/data-channel/LossyDataChannel.mjs.map +1 -0
  84. package/dist/core/room/data-channel/ReliableDataChannel.mjs +150 -0
  85. package/dist/core/room/data-channel/ReliableDataChannel.mjs.map +1 -0
  86. package/dist/core/room/data-channel/types.mjs +22 -0
  87. package/dist/core/room/data-channel/types.mjs.map +1 -0
  88. package/dist/core/room/data-stream/compression.mjs +68 -0
  89. package/dist/core/room/data-stream/compression.mjs.map +1 -0
  90. package/dist/core/room/data-stream/constants.mjs +26 -0
  91. package/dist/core/room/data-stream/constants.mjs.map +1 -0
  92. package/dist/core/room/data-stream/extension.mjs +42 -0
  93. package/dist/core/room/data-stream/extension.mjs.map +1 -0
  94. package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs +500 -0
  95. package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs.map +1 -0
  96. package/dist/core/room/data-stream/incoming/StreamReader.mjs +279 -0
  97. package/dist/core/room/data-stream/incoming/StreamReader.mjs.map +1 -0
  98. package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs +543 -0
  99. package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs.map +1 -0
  100. package/dist/core/room/data-stream/outgoing/StreamWriter.mjs +21 -0
  101. package/dist/core/room/data-stream/outgoing/StreamWriter.mjs.map +1 -0
  102. package/dist/core/room/data-stream/outgoing/header-utils.mjs +53 -0
  103. package/dist/core/room/data-stream/outgoing/header-utils.mjs.map +1 -0
  104. package/dist/core/room/data-track/LocalDataTrack.mjs +146 -0
  105. package/dist/core/room/data-track/LocalDataTrack.mjs.map +1 -0
  106. package/dist/core/room/data-track/RemoteDataTrack.mjs +51 -0
  107. package/dist/core/room/data-track/RemoteDataTrack.mjs.map +1 -0
  108. package/dist/core/room/data-track/depacketizer.mjs +193 -0
  109. package/dist/core/room/data-track/depacketizer.mjs.map +1 -0
  110. package/dist/core/room/data-track/extension.mjs +154 -0
  111. package/dist/core/room/data-track/extension.mjs.map +1 -0
  112. package/dist/core/room/data-track/frame.mjs +19 -0
  113. package/dist/core/room/data-track/frame.mjs.map +1 -0
  114. package/dist/core/room/data-track/handle.mjs +50 -0
  115. package/dist/core/room/data-track/handle.mjs.map +1 -0
  116. package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs +618 -0
  117. package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs.map +1 -0
  118. package/dist/core/room/data-track/incoming/errors.mjs +32 -0
  119. package/dist/core/room/data-track/incoming/errors.mjs.map +1 -0
  120. package/dist/core/room/data-track/incoming/pipeline.mjs +85 -0
  121. package/dist/core/room/data-track/incoming/pipeline.mjs.map +1 -0
  122. package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs +351 -0
  123. package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs.map +1 -0
  124. package/dist/core/room/data-track/outgoing/errors.mjs +114 -0
  125. package/dist/core/room/data-track/outgoing/errors.mjs.map +1 -0
  126. package/dist/core/room/data-track/outgoing/pipeline.mjs +41 -0
  127. package/dist/core/room/data-track/outgoing/pipeline.mjs.map +1 -0
  128. package/dist/core/room/data-track/packet/constants.mjs +21 -0
  129. package/dist/core/room/data-track/packet/constants.mjs.map +1 -0
  130. package/dist/core/room/data-track/packet/errors.mjs +56 -0
  131. package/dist/core/room/data-track/packet/errors.mjs.map +1 -0
  132. package/dist/core/room/data-track/packet/extensions.mjs +172 -0
  133. package/dist/core/room/data-track/packet/extensions.mjs.map +1 -0
  134. package/dist/core/room/data-track/packet/index.mjs +242 -0
  135. package/dist/core/room/data-track/packet/index.mjs.map +1 -0
  136. package/dist/core/room/data-track/packet/serializable.mjs +15 -0
  137. package/dist/core/room/data-track/packet/serializable.mjs.map +1 -0
  138. package/dist/core/room/data-track/packetizer.mjs +77 -0
  139. package/dist/core/room/data-track/packetizer.mjs.map +1 -0
  140. package/dist/core/room/data-track/track-interfaces.mjs +2 -0
  141. package/dist/core/room/data-track/track-interfaces.mjs.map +1 -0
  142. package/dist/core/room/data-track/types.mjs +18 -0
  143. package/dist/core/room/data-track/types.mjs.map +1 -0
  144. package/dist/core/room/data-track/utils.mjs +149 -0
  145. package/dist/core/room/data-track/utils.mjs.map +1 -0
  146. package/dist/core/room/debounce.mjs +97 -0
  147. package/dist/core/room/debounce.mjs.map +1 -0
  148. package/dist/core/room/defaults.mjs +34 -0
  149. package/dist/core/room/defaults.mjs.map +1 -0
  150. package/dist/core/room/errors.mjs +208 -0
  151. package/dist/core/room/errors.mjs.map +1 -0
  152. package/dist/core/room/events.mjs +643 -0
  153. package/dist/core/room/events.mjs.map +1 -0
  154. package/dist/core/room/extensions.mjs +48 -0
  155. package/dist/core/room/extensions.mjs.map +1 -0
  156. package/dist/core/room/participant/LocalParticipant.mjs +1324 -0
  157. package/dist/core/room/participant/LocalParticipant.mjs.map +1 -0
  158. package/dist/core/room/participant/Participant.mjs +300 -0
  159. package/dist/core/room/participant/Participant.mjs.map +1 -0
  160. package/dist/core/room/participant/ParticipantTrackPermission.mjs +12 -0
  161. package/dist/core/room/participant/ParticipantTrackPermission.mjs.map +1 -0
  162. package/dist/core/room/participant/RemoteParticipant.mjs +287 -0
  163. package/dist/core/room/participant/RemoteParticipant.mjs.map +1 -0
  164. package/dist/core/room/participant/publishUtils.mjs +356 -0
  165. package/dist/core/room/participant/publishUtils.mjs.map +1 -0
  166. package/dist/core/room/rpc/client/RpcClientManager.mjs +216 -0
  167. package/dist/core/room/rpc/client/RpcClientManager.mjs.map +1 -0
  168. package/dist/core/room/rpc/extension.mjs +82 -0
  169. package/dist/core/room/rpc/extension.mjs.map +1 -0
  170. package/dist/core/room/rpc/server/RpcServerManager.mjs +186 -0
  171. package/dist/core/room/rpc/server/RpcServerManager.mjs.map +1 -0
  172. package/dist/core/room/rpc/utils.mjs +148 -0
  173. package/dist/core/room/rpc/utils.mjs.map +1 -0
  174. package/dist/core/room/simulated-participants/extension.mjs +105 -0
  175. package/dist/core/room/simulated-participants/extension.mjs.map +1 -0
  176. package/dist/core/room/stats.mjs +19 -0
  177. package/dist/core/room/stats.mjs.map +1 -0
  178. package/dist/core/room/statsSummary.mjs +165 -0
  179. package/dist/core/room/statsSummary.mjs.map +1 -0
  180. package/dist/core/room/timers.mjs +20 -0
  181. package/dist/core/room/timers.mjs.map +1 -0
  182. package/dist/core/room/token-source/TokenSource.mjs +230 -0
  183. package/dist/core/room/token-source/TokenSource.mjs.map +1 -0
  184. package/dist/core/room/token-source/types.mjs +18 -0
  185. package/dist/core/room/token-source/types.mjs.map +1 -0
  186. package/dist/core/room/token-source/utils.mjs +76 -0
  187. package/dist/core/room/token-source/utils.mjs.map +1 -0
  188. package/dist/core/room/track/FrameMetadataExtractor.mjs +36 -0
  189. package/dist/core/room/track/FrameMetadataExtractor.mjs.map +1 -0
  190. package/dist/core/room/track/LocalAudioTrack.mjs +327 -0
  191. package/dist/core/room/track/LocalAudioTrack.mjs.map +1 -0
  192. package/dist/core/room/track/LocalTrack.mjs +694 -0
  193. package/dist/core/room/track/LocalTrack.mjs.map +1 -0
  194. package/dist/core/room/track/LocalTrackPublication.mjs +111 -0
  195. package/dist/core/room/track/LocalTrackPublication.mjs.map +1 -0
  196. package/dist/core/room/track/LocalVideoTrack.mjs +810 -0
  197. package/dist/core/room/track/LocalVideoTrack.mjs.map +1 -0
  198. package/dist/core/room/track/RemoteAudioTrack.mjs +245 -0
  199. package/dist/core/room/track/RemoteAudioTrack.mjs.map +1 -0
  200. package/dist/core/room/track/RemoteTrack.mjs +143 -0
  201. package/dist/core/room/track/RemoteTrack.mjs.map +1 -0
  202. package/dist/core/room/track/RemoteTrackPublication.mjs +284 -0
  203. package/dist/core/room/track/RemoteTrackPublication.mjs.map +1 -0
  204. package/dist/core/room/track/RemoteVideoTrack.mjs +384 -0
  205. package/dist/core/room/track/RemoteVideoTrack.mjs.map +1 -0
  206. package/dist/core/room/track/Track.mjs +413 -0
  207. package/dist/core/room/track/Track.mjs.map +1 -0
  208. package/dist/core/room/track/TrackPublication.mjs +97 -0
  209. package/dist/core/room/track/TrackPublication.mjs.map +1 -0
  210. package/dist/core/room/track/create.mjs +142 -0
  211. package/dist/core/room/track/create.mjs.map +1 -0
  212. package/dist/core/room/track/facingMode.mjs +81 -0
  213. package/dist/core/room/track/facingMode.mjs.map +1 -0
  214. package/dist/core/room/track/options.mjs +109 -0
  215. package/dist/core/room/track/options.mjs.map +1 -0
  216. package/dist/core/room/track/record.mjs +67 -0
  217. package/dist/core/room/track/record.mjs.map +1 -0
  218. package/dist/core/room/track/utils.mjs +429 -0
  219. package/dist/core/room/track/utils.mjs.map +1 -0
  220. package/dist/core/room/utils.mjs +852 -0
  221. package/dist/core/room/utils.mjs.map +1 -0
  222. package/dist/core/room/video/create.mjs +71 -0
  223. package/dist/core/room/video/create.mjs.map +1 -0
  224. package/dist/core/room/video/extension.mjs +27 -0
  225. package/dist/core/room/video/extension.mjs.map +1 -0
  226. package/dist/core/room/video/publisher.mjs +343 -0
  227. package/dist/core/room/video/publisher.mjs.map +1 -0
  228. package/dist/core/ts4.2/api/SignalClient.d.ts +19 -0
  229. package/dist/core/ts4.2/api/SignalClientStateMachine.d.ts +84 -0
  230. package/dist/core/ts4.2/api/WebSocketStream.d.ts +33 -0
  231. package/dist/core/ts4.2/api/utils.d.ts +8 -0
  232. package/dist/core/ts4.2/connectionHelper/ConnectionCheck.d.ts +29 -0
  233. package/dist/core/ts4.2/connectionHelper/checks/Checker.d.ts +64 -0
  234. package/dist/core/ts4.2/connectionHelper/checks/cloudRegion.d.ts +17 -0
  235. package/dist/core/ts4.2/connectionHelper/checks/connectionProtocol.d.ts +19 -0
  236. package/dist/core/ts4.2/connectionHelper/checks/publishAudio.d.ts +5 -0
  237. package/dist/core/ts4.2/connectionHelper/checks/publishVideo.d.ts +6 -0
  238. package/dist/core/ts4.2/connectionHelper/checks/reconnect.d.ts +5 -0
  239. package/dist/core/ts4.2/connectionHelper/checks/turn.d.ts +5 -0
  240. package/dist/core/ts4.2/connectionHelper/checks/webrtc.d.ts +5 -0
  241. package/dist/core/ts4.2/connectionHelper/checks/websocket.d.ts +5 -0
  242. package/dist/core/ts4.2/core.d.ts +33 -0
  243. package/dist/core/ts4.2/e2ee/E2eeManager.d.ts +89 -0
  244. package/dist/core/ts4.2/e2ee/KeyProvider.d.ts +53 -0
  245. package/dist/core/ts4.2/e2ee/constants.d.ts +20 -0
  246. package/dist/core/ts4.2/e2ee/errors.d.ts +11 -0
  247. package/dist/core/ts4.2/e2ee/events.d.ts +38 -0
  248. package/dist/core/ts4.2/e2ee/extension.d.ts +19 -0
  249. package/dist/core/ts4.2/e2ee/index.d.ts +5 -0
  250. package/dist/core/ts4.2/e2ee/types.d.ts +244 -0
  251. package/dist/core/ts4.2/e2ee/utils.d.ts +36 -0
  252. package/dist/core/ts4.2/exports.d.ts +82 -0
  253. package/dist/core/ts4.2/frameMetadata/FrameMetadataManager.d.ts +52 -0
  254. package/dist/core/ts4.2/frameMetadata/extension.d.ts +12 -0
  255. package/dist/core/ts4.2/frameMetadata/frameMetadata.d.ts +32 -0
  256. package/dist/core/ts4.2/frameMetadata/types.d.ts +61 -0
  257. package/dist/core/ts4.2/frameMetadata/utils.d.ts +13 -0
  258. package/dist/core/ts4.2/logger.d.ts +59 -0
  259. package/dist/core/ts4.2/options.d.ts +171 -0
  260. package/dist/core/ts4.2/room/BackOffStrategy.d.ts +26 -0
  261. package/dist/core/ts4.2/room/CoreRoom.d.ts +363 -0
  262. package/dist/core/ts4.2/room/DefaultReconnectPolicy.d.ts +7 -0
  263. package/dist/core/ts4.2/room/DeviceManager.d.ts +11 -0
  264. package/dist/core/ts4.2/room/PCTransport.d.ts +132 -0
  265. package/dist/core/ts4.2/room/PCTransportManager.d.ts +80 -0
  266. package/dist/core/ts4.2/room/RTCEngine.d.ts +233 -0
  267. package/dist/core/ts4.2/room/ReconnectPolicy.d.ts +23 -0
  268. package/dist/core/ts4.2/room/RegionUrlProvider.d.ts +33 -0
  269. package/dist/core/ts4.2/room/attribute-typings.d.ts +34 -0
  270. package/dist/core/ts4.2/room/chat/extension.d.ts +21 -0
  271. package/dist/core/ts4.2/room/createRoom.d.ts +19 -0
  272. package/dist/core/ts4.2/room/data-channel/DataChannelManager.d.ts +67 -0
  273. package/dist/core/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +106 -0
  274. package/dist/core/ts4.2/room/data-channel/LossyDataChannel.d.ts +40 -0
  275. package/dist/core/ts4.2/room/data-channel/ReliableDataChannel.d.ts +56 -0
  276. package/dist/core/ts4.2/room/data-channel/types.d.ts +11 -0
  277. package/dist/core/ts4.2/room/data-stream/compression.d.ts +29 -0
  278. package/dist/core/ts4.2/room/data-stream/constants.d.ts +1 -0
  279. package/dist/core/ts4.2/room/data-stream/extension.d.ts +63 -0
  280. package/dist/core/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +33 -0
  281. package/dist/core/ts4.2/room/data-stream/incoming/StreamReader.d.ts +77 -0
  282. package/dist/core/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
  283. package/dist/core/ts4.2/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
  284. package/dist/core/ts4.2/room/data-stream/outgoing/header-utils.d.ts +17 -0
  285. package/dist/core/ts4.2/room/data-track/LocalDataTrack.d.ts +69 -0
  286. package/dist/core/ts4.2/room/data-track/RemoteDataTrack.d.ts +43 -0
  287. package/dist/core/ts4.2/room/data-track/depacketizer.d.ts +58 -0
  288. package/dist/core/ts4.2/room/data-track/extension.d.ts +30 -0
  289. package/dist/core/ts4.2/room/data-track/frame.d.ts +21 -0
  290. package/dist/core/ts4.2/room/data-track/handle.d.ts +26 -0
  291. package/dist/core/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
  292. package/dist/core/ts4.2/room/data-track/incoming/errors.d.ts +23 -0
  293. package/dist/core/ts4.2/room/data-track/incoming/pipeline.d.ts +40 -0
  294. package/dist/core/ts4.2/room/data-track/incoming/types.d.ts +19 -0
  295. package/dist/core/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
  296. package/dist/core/ts4.2/room/data-track/outgoing/errors.d.ts +73 -0
  297. package/dist/core/ts4.2/room/data-track/outgoing/pipeline.d.ts +22 -0
  298. package/dist/core/ts4.2/room/data-track/outgoing/types.d.ts +47 -0
  299. package/dist/core/ts4.2/room/data-track/packet/constants.d.ts +19 -0
  300. package/dist/core/ts4.2/room/data-track/packet/errors.d.ts +39 -0
  301. package/dist/core/ts4.2/room/data-track/packet/extensions.d.ts +68 -0
  302. package/dist/core/ts4.2/room/data-track/packet/index.d.ts +97 -0
  303. package/dist/core/ts4.2/room/data-track/packet/serializable.d.ts +12 -0
  304. package/dist/core/ts4.2/room/data-track/packetizer.d.ts +40 -0
  305. package/dist/core/ts4.2/room/data-track/track-interfaces.d.ts +22 -0
  306. package/dist/core/ts4.2/room/data-track/types.d.ts +21 -0
  307. package/dist/core/ts4.2/room/data-track/utils.d.ts +59 -0
  308. package/dist/core/ts4.2/room/debounce.d.ts +10 -0
  309. package/dist/core/ts4.2/room/defaults.d.ts +7 -0
  310. package/dist/core/ts4.2/room/errors.d.ts +179 -0
  311. package/dist/core/ts4.2/room/events.d.ts +534 -0
  312. package/dist/core/ts4.2/room/extensions.d.ts +206 -0
  313. package/dist/core/ts4.2/room/participant/LocalParticipant.d.ts +164 -0
  314. package/dist/core/ts4.2/room/participant/Participant.d.ts +122 -0
  315. package/dist/core/ts4.2/room/participant/ParticipantTrackPermission.d.ts +25 -0
  316. package/dist/core/ts4.2/room/participant/RemoteParticipant.d.ts +37 -0
  317. package/dist/core/ts4.2/room/participant/publishUtils.d.ts +11 -0
  318. package/dist/core/ts4.2/room/rpc/client/RpcClientManager.d.ts +1 -0
  319. package/dist/core/ts4.2/room/rpc/client/events.d.ts +7 -0
  320. package/dist/core/ts4.2/room/rpc/extension.d.ts +73 -0
  321. package/dist/core/ts4.2/room/rpc/index.d.ts +6 -0
  322. package/dist/core/ts4.2/room/rpc/server/RpcServerManager.d.ts +1 -0
  323. package/dist/core/ts4.2/room/rpc/server/events.d.ts +7 -0
  324. package/dist/core/ts4.2/room/rpc/utils.d.ts +76 -0
  325. package/dist/core/ts4.2/room/simulated-participants/extension.d.ts +24 -0
  326. package/dist/core/ts4.2/room/stats.d.ts +70 -0
  327. package/dist/core/ts4.2/room/statsSummary.d.ts +12 -0
  328. package/dist/core/ts4.2/room/timers.d.ts +11 -0
  329. package/dist/core/ts4.2/room/token-source/TokenSource.d.ts +85 -0
  330. package/dist/core/ts4.2/room/token-source/types.d.ts +69 -0
  331. package/dist/core/ts4.2/room/token-source/utils.d.ts +7 -0
  332. package/dist/core/ts4.2/room/track/FrameMetadataExtractor.d.ts +18 -0
  333. package/dist/core/ts4.2/room/track/LocalAudioTrack.d.ts +50 -0
  334. package/dist/core/ts4.2/room/track/LocalTrack.d.ts +118 -0
  335. package/dist/core/ts4.2/room/track/LocalTrackPublication.d.ts +41 -0
  336. package/dist/core/ts4.2/room/track/LocalVideoTrack.d.ts +91 -0
  337. package/dist/core/ts4.2/room/track/RemoteAudioTrack.d.ts +49 -0
  338. package/dist/core/ts4.2/room/track/RemoteTrack.d.ts +29 -0
  339. package/dist/core/ts4.2/room/track/RemoteTrackPublication.d.ts +62 -0
  340. package/dist/core/ts4.2/room/track/RemoteVideoTrack.d.ts +53 -0
  341. package/dist/core/ts4.2/room/track/Track.d.ts +129 -0
  342. package/dist/core/ts4.2/room/track/TrackPublication.d.ts +68 -0
  343. package/dist/core/ts4.2/room/track/create.d.ts +12 -0
  344. package/dist/core/ts4.2/room/track/facingMode.d.ts +40 -0
  345. package/dist/core/ts4.2/room/track/options.d.ts +396 -0
  346. package/dist/core/ts4.2/room/track/processor/types.d.ts +41 -0
  347. package/dist/core/ts4.2/room/track/record.d.ts +12 -0
  348. package/dist/core/ts4.2/room/track/types.d.ts +27 -0
  349. package/dist/core/ts4.2/room/track/utils.d.ts +20 -0
  350. package/dist/core/ts4.2/room/types.d.ts +126 -0
  351. package/dist/core/ts4.2/room/utils.d.ts +246 -0
  352. package/dist/core/ts4.2/room/video/create.d.ts +27 -0
  353. package/dist/core/ts4.2/room/video/extension.d.ts +43 -0
  354. package/dist/core/ts4.2/room/video/publisher.d.ts +23 -0
  355. package/dist/core/ts4.2/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
  356. package/dist/core/ts4.2/utils/AsyncQueue.d.ts +22 -0
  357. package/dist/core/ts4.2/utils/TypedPromise.d.ts +16 -0
  358. package/dist/core/ts4.2/utils/abort-signal-polyfill.d.ts +12 -0
  359. package/dist/core/ts4.2/utils/browserParser.d.ts +9 -0
  360. package/dist/core/ts4.2/utils/camelToSnakeCase.d.ts +7 -0
  361. package/dist/core/ts4.2/utils/cloneDeep.d.ts +1 -0
  362. package/dist/core/ts4.2/utils/dataPacketBuffer.d.ts +33 -0
  363. package/dist/core/ts4.2/utils/deferrable-map.d.ts +31 -0
  364. package/dist/core/ts4.2/utils/machineInspector.d.ts +53 -0
  365. package/dist/core/ts4.2/utils/serializer.d.ts +47 -0
  366. package/dist/core/ts4.2/utils/throws.d.ts +9 -0
  367. package/dist/core/ts4.2/utils/ttlmap.d.ts +19 -0
  368. package/dist/core/ts4.2/version.d.ts +17 -0
  369. package/dist/core/types/src/api/SignalClient.d.ts +19 -0
  370. package/dist/core/types/src/api/SignalClientStateMachine.d.ts +84 -0
  371. package/dist/core/types/src/api/WebSocketStream.d.ts +33 -0
  372. package/dist/core/types/src/api/utils.d.ts +8 -0
  373. package/dist/core/types/src/connectionHelper/ConnectionCheck.d.ts +28 -0
  374. package/dist/core/types/src/connectionHelper/checks/Checker.d.ts +64 -0
  375. package/dist/core/types/src/connectionHelper/checks/cloudRegion.d.ts +16 -0
  376. package/dist/core/types/src/connectionHelper/checks/connectionProtocol.d.ts +18 -0
  377. package/dist/core/types/src/connectionHelper/checks/publishAudio.d.ts +5 -0
  378. package/dist/core/types/src/connectionHelper/checks/publishVideo.d.ts +6 -0
  379. package/dist/core/types/src/connectionHelper/checks/reconnect.d.ts +5 -0
  380. package/dist/core/types/src/connectionHelper/checks/turn.d.ts +5 -0
  381. package/dist/core/types/src/connectionHelper/checks/webrtc.d.ts +5 -0
  382. package/dist/core/types/src/connectionHelper/checks/websocket.d.ts +5 -0
  383. package/dist/core/types/src/core.d.ts +32 -0
  384. package/dist/core/types/src/e2ee/E2eeManager.d.ts +89 -0
  385. package/dist/core/types/src/e2ee/KeyProvider.d.ts +53 -0
  386. package/dist/core/types/src/e2ee/constants.d.ts +20 -0
  387. package/dist/core/types/src/e2ee/errors.d.ts +11 -0
  388. package/dist/core/types/src/e2ee/events.d.ts +38 -0
  389. package/dist/core/types/src/e2ee/extension.d.ts +18 -0
  390. package/dist/core/types/src/e2ee/index.d.ts +5 -0
  391. package/dist/core/types/src/e2ee/types.d.ts +244 -0
  392. package/dist/core/types/src/e2ee/utils.d.ts +35 -0
  393. package/dist/core/types/src/exports.d.ts +75 -0
  394. package/dist/core/types/src/frameMetadata/FrameMetadataManager.d.ts +52 -0
  395. package/dist/core/types/src/frameMetadata/extension.d.ts +10 -0
  396. package/dist/core/types/src/frameMetadata/frameMetadata.d.ts +32 -0
  397. package/dist/core/types/src/frameMetadata/types.d.ts +61 -0
  398. package/dist/core/types/src/frameMetadata/utils.d.ts +13 -0
  399. package/dist/core/types/src/logger.d.ts +59 -0
  400. package/dist/core/types/src/options.d.ts +171 -0
  401. package/dist/core/types/src/room/BackOffStrategy.d.ts +26 -0
  402. package/dist/core/types/src/room/CoreRoom.d.ts +374 -0
  403. package/dist/core/types/src/room/DefaultReconnectPolicy.d.ts +7 -0
  404. package/dist/core/types/src/room/DeviceManager.d.ts +11 -0
  405. package/dist/core/types/src/room/PCTransport.d.ts +132 -0
  406. package/dist/core/types/src/room/PCTransportManager.d.ts +80 -0
  407. package/dist/core/types/src/room/RTCEngine.d.ts +232 -0
  408. package/dist/core/types/src/room/ReconnectPolicy.d.ts +23 -0
  409. package/dist/core/types/src/room/RegionUrlProvider.d.ts +33 -0
  410. package/dist/core/types/src/room/attribute-typings.d.ts +34 -0
  411. package/dist/core/types/src/room/chat/extension.d.ts +21 -0
  412. package/dist/core/types/src/room/createRoom.d.ts +18 -0
  413. package/dist/core/types/src/room/data-channel/DataChannelManager.d.ts +68 -0
  414. package/dist/core/types/src/room/data-channel/FlowControlledDataChannel.d.ts +107 -0
  415. package/dist/core/types/src/room/data-channel/LossyDataChannel.d.ts +39 -0
  416. package/dist/core/types/src/room/data-channel/ReliableDataChannel.d.ts +55 -0
  417. package/dist/core/types/src/room/data-channel/types.d.ts +11 -0
  418. package/dist/core/types/src/room/data-stream/compression.d.ts +29 -0
  419. package/dist/core/types/src/room/data-stream/constants.d.ts +1 -0
  420. package/dist/core/types/src/room/data-stream/extension.d.ts +62 -0
  421. package/dist/core/types/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +32 -0
  422. package/dist/core/types/src/room/data-stream/incoming/StreamReader.d.ts +77 -0
  423. package/dist/core/types/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
  424. package/dist/core/types/src/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
  425. package/dist/core/types/src/room/data-stream/outgoing/header-utils.d.ts +17 -0
  426. package/dist/core/types/src/room/data-track/LocalDataTrack.d.ts +70 -0
  427. package/dist/core/types/src/room/data-track/RemoteDataTrack.d.ts +43 -0
  428. package/dist/core/types/src/room/data-track/depacketizer.d.ts +58 -0
  429. package/dist/core/types/src/room/data-track/extension.d.ts +30 -0
  430. package/dist/core/types/src/room/data-track/frame.d.ts +21 -0
  431. package/dist/core/types/src/room/data-track/handle.d.ts +26 -0
  432. package/dist/core/types/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
  433. package/dist/core/types/src/room/data-track/incoming/errors.d.ts +23 -0
  434. package/dist/core/types/src/room/data-track/incoming/pipeline.d.ts +40 -0
  435. package/dist/core/types/src/room/data-track/incoming/types.d.ts +19 -0
  436. package/dist/core/types/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
  437. package/dist/core/types/src/room/data-track/outgoing/errors.d.ts +73 -0
  438. package/dist/core/types/src/room/data-track/outgoing/pipeline.d.ts +22 -0
  439. package/dist/core/types/src/room/data-track/outgoing/types.d.ts +47 -0
  440. package/dist/core/types/src/room/data-track/packet/constants.d.ts +19 -0
  441. package/dist/core/types/src/room/data-track/packet/errors.d.ts +39 -0
  442. package/dist/core/types/src/room/data-track/packet/extensions.d.ts +68 -0
  443. package/dist/core/types/src/room/data-track/packet/index.d.ts +91 -0
  444. package/dist/core/types/src/room/data-track/packet/serializable.d.ts +12 -0
  445. package/dist/core/types/src/room/data-track/packetizer.d.ts +40 -0
  446. package/dist/core/types/src/room/data-track/track-interfaces.d.ts +22 -0
  447. package/dist/core/types/src/room/data-track/types.d.ts +21 -0
  448. package/dist/core/types/src/room/data-track/utils.d.ts +59 -0
  449. package/dist/core/types/src/room/debounce.d.ts +10 -0
  450. package/dist/core/types/src/room/defaults.d.ts +7 -0
  451. package/dist/core/types/src/room/errors.d.ts +179 -0
  452. package/dist/core/types/src/room/events.d.ts +534 -0
  453. package/dist/core/types/src/room/extensions.d.ts +205 -0
  454. package/dist/core/types/src/room/participant/LocalParticipant.d.ts +164 -0
  455. package/dist/core/types/src/room/participant/Participant.d.ts +123 -0
  456. package/dist/core/types/src/room/participant/ParticipantTrackPermission.d.ts +25 -0
  457. package/dist/core/types/src/room/participant/RemoteParticipant.d.ts +37 -0
  458. package/dist/core/types/src/room/participant/publishUtils.d.ts +11 -0
  459. package/dist/core/types/src/room/rpc/client/RpcClientManager.d.ts +1 -0
  460. package/dist/core/types/src/room/rpc/client/events.d.ts +7 -0
  461. package/dist/core/types/src/room/rpc/extension.d.ts +69 -0
  462. package/dist/core/types/src/room/rpc/index.d.ts +5 -0
  463. package/dist/core/types/src/room/rpc/server/RpcServerManager.d.ts +1 -0
  464. package/dist/core/types/src/room/rpc/server/events.d.ts +7 -0
  465. package/dist/core/types/src/room/rpc/utils.d.ts +76 -0
  466. package/dist/core/types/src/room/simulated-participants/extension.d.ts +24 -0
  467. package/dist/core/types/src/room/stats.d.ts +70 -0
  468. package/dist/core/types/src/room/statsSummary.d.ts +12 -0
  469. package/dist/core/types/src/room/timers.d.ts +11 -0
  470. package/dist/core/types/src/room/token-source/TokenSource.d.ts +91 -0
  471. package/dist/core/types/src/room/token-source/types.d.ts +69 -0
  472. package/dist/core/types/src/room/token-source/utils.d.ts +7 -0
  473. package/dist/core/types/src/room/track/FrameMetadataExtractor.d.ts +18 -0
  474. package/dist/core/types/src/room/track/LocalAudioTrack.d.ts +53 -0
  475. package/dist/core/types/src/room/track/LocalTrack.d.ts +118 -0
  476. package/dist/core/types/src/room/track/LocalTrackPublication.d.ts +41 -0
  477. package/dist/core/types/src/room/track/LocalVideoTrack.d.ts +91 -0
  478. package/dist/core/types/src/room/track/RemoteAudioTrack.d.ts +49 -0
  479. package/dist/core/types/src/room/track/RemoteTrack.d.ts +29 -0
  480. package/dist/core/types/src/room/track/RemoteTrackPublication.d.ts +76 -0
  481. package/dist/core/types/src/room/track/RemoteVideoTrack.d.ts +56 -0
  482. package/dist/core/types/src/room/track/Track.d.ts +134 -0
  483. package/dist/core/types/src/room/track/TrackPublication.d.ts +74 -0
  484. package/dist/core/types/src/room/track/create.d.ts +12 -0
  485. package/dist/core/types/src/room/track/facingMode.d.ts +40 -0
  486. package/dist/core/types/src/room/track/options.d.ts +384 -0
  487. package/dist/core/types/src/room/track/processor/types.d.ts +41 -0
  488. package/dist/core/types/src/room/track/record.d.ts +12 -0
  489. package/dist/core/types/src/room/track/types.d.ts +27 -0
  490. package/dist/core/types/src/room/track/utils.d.ts +20 -0
  491. package/dist/core/types/src/room/types.d.ts +126 -0
  492. package/dist/core/types/src/room/utils.d.ts +246 -0
  493. package/dist/core/types/src/room/video/create.d.ts +27 -0
  494. package/dist/core/types/src/room/video/extension.d.ts +43 -0
  495. package/dist/core/types/src/room/video/publisher.d.ts +23 -0
  496. package/dist/core/types/src/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
  497. package/dist/core/types/src/utils/AsyncQueue.d.ts +22 -0
  498. package/dist/core/types/src/utils/TypedPromise.d.ts +15 -0
  499. package/dist/core/types/src/utils/abort-signal-polyfill.d.ts +12 -0
  500. package/dist/core/types/src/utils/browserParser.d.ts +9 -0
  501. package/dist/core/types/src/utils/camelToSnakeCase.d.ts +7 -0
  502. package/dist/core/types/src/utils/cloneDeep.d.ts +1 -0
  503. package/dist/core/types/src/utils/dataPacketBuffer.d.ts +33 -0
  504. package/dist/core/types/src/utils/deferrable-map.d.ts +31 -0
  505. package/dist/core/types/src/utils/machineInspector.d.ts +53 -0
  506. package/dist/core/types/src/utils/serializer.d.ts +47 -0
  507. package/dist/core/types/src/utils/throws.d.ts +9 -0
  508. package/dist/core/types/src/utils/ttlmap.d.ts +19 -0
  509. package/dist/core/types/src/version.d.ts +17 -0
  510. package/dist/core/utils/AsyncQueue.mjs +41 -0
  511. package/dist/core/utils/AsyncQueue.mjs.map +1 -0
  512. package/dist/core/utils/TypedPromise.mjs +23 -0
  513. package/dist/core/utils/TypedPromise.mjs.map +1 -0
  514. package/dist/core/utils/abort-signal-polyfill.mjs +53 -0
  515. package/dist/core/utils/abort-signal-polyfill.mjs.map +1 -0
  516. package/dist/core/utils/browserParser.mjs +62 -0
  517. package/dist/core/utils/browserParser.mjs.map +1 -0
  518. package/dist/core/utils/cloneDeep.mjs +14 -0
  519. package/dist/core/utils/cloneDeep.mjs.map +1 -0
  520. package/dist/core/utils/dataPacketBuffer.mjs +76 -0
  521. package/dist/core/utils/dataPacketBuffer.mjs.map +1 -0
  522. package/dist/core/utils/deferrable-map.mjs +94 -0
  523. package/dist/core/utils/deferrable-map.mjs.map +1 -0
  524. package/dist/core/utils/machineInspector.mjs +19 -0
  525. package/dist/core/utils/machineInspector.mjs.map +1 -0
  526. package/dist/core/utils/serializer.mjs +47 -0
  527. package/dist/core/utils/serializer.mjs.map +1 -0
  528. package/dist/core/utils/ttlmap.mjs +97 -0
  529. package/dist/core/utils/ttlmap.mjs.map +1 -0
  530. package/dist/core/version.mjs +17 -0
  531. package/dist/core/version.mjs.map +1 -0
  532. package/dist/livekit-client.e2ee.worker.js +1 -1
  533. package/dist/livekit-client.e2ee.worker.js.map +1 -1
  534. package/dist/livekit-client.e2ee.worker.mjs +157 -131
  535. package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
  536. package/dist/livekit-client.esm.mjs +31497 -30818
  537. package/dist/livekit-client.esm.mjs.map +1 -1
  538. package/dist/livekit-client.fm.worker.js +1 -1
  539. package/dist/livekit-client.fm.worker.js.map +1 -1
  540. package/dist/livekit-client.fm.worker.mjs +21 -82
  541. package/dist/livekit-client.fm.worker.mjs.map +1 -1
  542. package/dist/livekit-client.umd.js +1 -1
  543. package/dist/livekit-client.umd.js.map +1 -1
  544. package/dist/src/api/SignalClient.d.ts +1 -1
  545. package/dist/src/api/SignalClient.d.ts.map +1 -1
  546. package/dist/src/api/WebSocketStream.d.ts.map +1 -1
  547. package/dist/src/connectionHelper/checks/Checker.d.ts +7 -4
  548. package/dist/src/connectionHelper/checks/Checker.d.ts.map +1 -1
  549. package/dist/src/core.d.ts +33 -0
  550. package/dist/src/core.d.ts.map +1 -0
  551. package/dist/src/e2ee/E2eeManager.d.ts +25 -5
  552. package/dist/src/e2ee/E2eeManager.d.ts.map +1 -1
  553. package/dist/src/e2ee/KeyProvider.d.ts.map +1 -1
  554. package/dist/src/e2ee/extension.d.ts +19 -0
  555. package/dist/src/e2ee/extension.d.ts.map +1 -0
  556. package/dist/src/e2ee/types.d.ts +14 -0
  557. package/dist/src/e2ee/types.d.ts.map +1 -1
  558. package/dist/src/e2ee/utils.d.ts +6 -1
  559. package/dist/src/e2ee/utils.d.ts.map +1 -1
  560. package/dist/src/e2ee/worker/FrameCryptor.d.ts +7 -1
  561. package/dist/src/e2ee/worker/FrameCryptor.d.ts.map +1 -1
  562. package/dist/src/e2ee/worker/naluUtils.d.ts +7 -0
  563. package/dist/src/e2ee/worker/naluUtils.d.ts.map +1 -1
  564. package/dist/src/e2ee/worker/sifPayload.d.ts +1 -1
  565. package/dist/src/e2ee/worker/sifPayload.d.ts.map +1 -1
  566. package/dist/src/exports.d.ts +76 -0
  567. package/dist/src/exports.d.ts.map +1 -0
  568. package/dist/src/frameMetadata/FrameMetadataManager.d.ts +5 -2
  569. package/dist/src/frameMetadata/FrameMetadataManager.d.ts.map +1 -1
  570. package/dist/src/frameMetadata/extension.d.ts +11 -0
  571. package/dist/src/frameMetadata/extension.d.ts.map +1 -0
  572. package/dist/src/frameMetadata/utils.d.ts +5 -0
  573. package/dist/src/frameMetadata/utils.d.ts.map +1 -1
  574. package/dist/src/index.d.ts +35 -63
  575. package/dist/src/index.d.ts.map +1 -1
  576. package/dist/src/logger.d.ts +1 -3
  577. package/dist/src/logger.d.ts.map +1 -1
  578. package/dist/src/options.d.ts +20 -6
  579. package/dist/src/options.d.ts.map +1 -1
  580. package/dist/src/room/CoreRoom.d.ts +392 -0
  581. package/dist/src/room/CoreRoom.d.ts.map +1 -0
  582. package/dist/src/room/PCTransport.d.ts +5 -2
  583. package/dist/src/room/PCTransport.d.ts.map +1 -1
  584. package/dist/src/room/PCTransportManager.d.ts +8 -4
  585. package/dist/src/room/PCTransportManager.d.ts.map +1 -1
  586. package/dist/src/room/RTCEngine.d.ts +23 -6
  587. package/dist/src/room/RTCEngine.d.ts.map +1 -1
  588. package/dist/src/room/Room.d.ts +5 -403
  589. package/dist/src/room/Room.d.ts.map +1 -1
  590. package/dist/src/room/chat/extension.d.ts +22 -0
  591. package/dist/src/room/chat/extension.d.ts.map +1 -0
  592. package/dist/src/room/createRoom.d.ts +19 -0
  593. package/dist/src/room/createRoom.d.ts.map +1 -0
  594. package/dist/src/room/data-channel/DataChannelManager.d.ts +7 -1
  595. package/dist/src/room/data-channel/DataChannelManager.d.ts.map +1 -1
  596. package/dist/src/room/data-stream/constants.d.ts +9 -0
  597. package/dist/src/room/data-stream/constants.d.ts.map +1 -1
  598. package/dist/src/room/data-stream/extension.d.ts +73 -0
  599. package/dist/src/room/data-stream/extension.d.ts.map +1 -0
  600. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  601. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts.map +1 -1
  602. package/dist/src/room/data-stream/incoming/StreamReader.d.ts.map +1 -1
  603. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  604. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts.map +1 -1
  605. package/dist/src/room/data-track/LocalDataTrack.d.ts +1 -1
  606. package/dist/src/room/data-track/depacketizer.d.ts +1 -1
  607. package/dist/src/room/data-track/depacketizer.d.ts.map +1 -1
  608. package/dist/src/room/data-track/extension.d.ts +31 -0
  609. package/dist/src/room/data-track/extension.d.ts.map +1 -0
  610. package/dist/src/room/data-track/handle.d.ts +1 -1
  611. package/dist/src/room/data-track/handle.d.ts.map +1 -1
  612. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  613. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts.map +1 -1
  614. package/dist/src/room/data-track/incoming/pipeline.d.ts +1 -1
  615. package/dist/src/room/data-track/incoming/pipeline.d.ts.map +1 -1
  616. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  617. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts.map +1 -1
  618. package/dist/src/room/data-track/outgoing/pipeline.d.ts +1 -1
  619. package/dist/src/room/data-track/outgoing/pipeline.d.ts.map +1 -1
  620. package/dist/src/room/data-track/packet/extensions.d.ts +1 -1
  621. package/dist/src/room/data-track/packet/extensions.d.ts.map +1 -1
  622. package/dist/src/room/data-track/packet/index.d.ts +1 -1
  623. package/dist/src/room/data-track/packet/index.d.ts.map +1 -1
  624. package/dist/src/room/data-track/packet/serializable.d.ts +1 -1
  625. package/dist/src/room/data-track/packet/serializable.d.ts.map +1 -1
  626. package/dist/src/room/data-track/packetizer.d.ts +1 -1
  627. package/dist/src/room/data-track/packetizer.d.ts.map +1 -1
  628. package/dist/src/room/data-track/track-interfaces.d.ts +1 -1
  629. package/dist/src/room/data-track/track-interfaces.d.ts.map +1 -1
  630. package/dist/src/room/data-track/utils.d.ts +1 -1
  631. package/dist/src/room/defaults.d.ts +1 -2
  632. package/dist/src/room/defaults.d.ts.map +1 -1
  633. package/dist/src/room/extensions.d.ts +208 -0
  634. package/dist/src/room/extensions.d.ts.map +1 -0
  635. package/dist/src/room/participant/LocalParticipant.d.ts +45 -120
  636. package/dist/src/room/participant/LocalParticipant.d.ts.map +1 -1
  637. package/dist/src/room/participant/Participant.d.ts +8 -1
  638. package/dist/src/room/participant/Participant.d.ts.map +1 -1
  639. package/dist/src/room/participant/RemoteParticipant.d.ts +3 -3
  640. package/dist/src/room/participant/RemoteParticipant.d.ts.map +1 -1
  641. package/dist/src/room/participant/publishUtils.d.ts.map +1 -1
  642. package/dist/src/room/rpc/extension.d.ts +70 -0
  643. package/dist/src/room/rpc/extension.d.ts.map +1 -0
  644. package/dist/src/room/rpc/index.d.ts +1 -1
  645. package/dist/src/room/rpc/index.d.ts.map +1 -1
  646. package/dist/src/room/rpc/legacyExtension.d.ts +34 -0
  647. package/dist/src/room/rpc/legacyExtension.d.ts.map +1 -0
  648. package/dist/src/room/simulated-participants/extension.d.ts +25 -0
  649. package/dist/src/room/simulated-participants/extension.d.ts.map +1 -0
  650. package/dist/src/room/token-source/TokenSource.d.ts +5 -1
  651. package/dist/src/room/token-source/TokenSource.d.ts.map +1 -1
  652. package/dist/src/room/token-source/utils.d.ts.map +1 -1
  653. package/dist/src/room/track/LocalTrack.d.ts +1 -1
  654. package/dist/src/room/track/LocalTrack.d.ts.map +1 -1
  655. package/dist/src/room/track/LocalVideoTrack.d.ts.map +1 -1
  656. package/dist/src/room/track/RemoteTrackPublication.d.ts +14 -1
  657. package/dist/src/room/track/RemoteTrackPublication.d.ts.map +1 -1
  658. package/dist/src/room/track/Track.d.ts.map +1 -1
  659. package/dist/src/room/track/TrackPublication.d.ts +2 -2
  660. package/dist/src/room/track/TrackPublication.d.ts.map +1 -1
  661. package/dist/src/room/track/create.d.ts +15 -13
  662. package/dist/src/room/track/create.d.ts.map +1 -1
  663. package/dist/src/room/track/facingMode.d.ts.map +1 -1
  664. package/dist/src/room/track/options.d.ts +0 -6
  665. package/dist/src/room/track/options.d.ts.map +1 -1
  666. package/dist/src/room/track/processor/types.d.ts +2 -2
  667. package/dist/src/room/track/processor/types.d.ts.map +1 -1
  668. package/dist/src/room/track/utils.d.ts +1 -1
  669. package/dist/src/room/track/utils.d.ts.map +1 -1
  670. package/dist/src/room/utils.d.ts +2 -2
  671. package/dist/src/room/utils.d.ts.map +1 -1
  672. package/dist/src/room/video/create.d.ts +28 -0
  673. package/dist/src/room/video/create.d.ts.map +1 -0
  674. package/dist/src/room/video/extension.d.ts +48 -0
  675. package/dist/src/room/video/extension.d.ts.map +1 -0
  676. package/dist/src/room/video/publisher.d.ts +24 -0
  677. package/dist/src/room/video/publisher.d.ts.map +1 -0
  678. package/dist/src/test/MockMediaStream.d.ts +6 -0
  679. package/dist/src/test/MockMediaStream.d.ts.map +1 -0
  680. package/dist/src/utils/browserParser.d.ts +0 -3
  681. package/dist/src/utils/browserParser.d.ts.map +1 -1
  682. package/dist/src/utils/deferrable-map.d.ts +1 -1
  683. package/dist/src/utils/deferrable-map.d.ts.map +1 -1
  684. package/dist/src/utils/serializer.d.ts.map +1 -1
  685. package/dist/src/utils/throws.d.ts +10 -0
  686. package/dist/src/utils/throws.d.ts.map +1 -0
  687. package/dist/src/version.d.ts +4 -1
  688. package/dist/src/version.d.ts.map +1 -1
  689. package/dist/ts4.2/connectionHelper/checks/Checker.d.ts +7 -4
  690. package/dist/ts4.2/core.d.ts +34 -0
  691. package/dist/ts4.2/e2ee/E2eeManager.d.ts +25 -5
  692. package/dist/ts4.2/e2ee/extension.d.ts +20 -0
  693. package/dist/ts4.2/e2ee/types.d.ts +14 -0
  694. package/dist/ts4.2/e2ee/utils.d.ts +6 -1
  695. package/dist/ts4.2/e2ee/worker/FrameCryptor.d.ts +7 -1
  696. package/dist/ts4.2/e2ee/worker/naluUtils.d.ts +7 -0
  697. package/dist/ts4.2/e2ee/worker/sifPayload.d.ts +1 -1
  698. package/dist/ts4.2/exports.d.ts +83 -0
  699. package/dist/ts4.2/frameMetadata/FrameMetadataManager.d.ts +5 -2
  700. package/dist/ts4.2/frameMetadata/extension.d.ts +13 -0
  701. package/dist/ts4.2/frameMetadata/utils.d.ts +5 -0
  702. package/dist/ts4.2/index.d.ts +35 -69
  703. package/dist/ts4.2/logger.d.ts +1 -3
  704. package/dist/ts4.2/options.d.ts +20 -6
  705. package/dist/ts4.2/room/CoreRoom.d.ts +381 -0
  706. package/dist/ts4.2/room/PCTransport.d.ts +5 -2
  707. package/dist/ts4.2/room/PCTransportManager.d.ts +8 -4
  708. package/dist/ts4.2/room/RTCEngine.d.ts +23 -6
  709. package/dist/ts4.2/room/Room.d.ts +6 -392
  710. package/dist/ts4.2/room/chat/extension.d.ts +22 -0
  711. package/dist/ts4.2/room/createRoom.d.ts +20 -0
  712. package/dist/ts4.2/room/data-channel/DataChannelManager.d.ts +6 -1
  713. package/dist/ts4.2/room/data-stream/constants.d.ts +9 -0
  714. package/dist/ts4.2/room/data-stream/extension.d.ts +74 -0
  715. package/dist/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  716. package/dist/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  717. package/dist/ts4.2/room/data-track/LocalDataTrack.d.ts +1 -1
  718. package/dist/ts4.2/room/data-track/depacketizer.d.ts +1 -1
  719. package/dist/ts4.2/room/data-track/extension.d.ts +31 -0
  720. package/dist/ts4.2/room/data-track/handle.d.ts +1 -1
  721. package/dist/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  722. package/dist/ts4.2/room/data-track/incoming/pipeline.d.ts +1 -1
  723. package/dist/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  724. package/dist/ts4.2/room/data-track/outgoing/pipeline.d.ts +1 -1
  725. package/dist/ts4.2/room/data-track/packet/extensions.d.ts +1 -1
  726. package/dist/ts4.2/room/data-track/packet/index.d.ts +1 -1
  727. package/dist/ts4.2/room/data-track/packet/serializable.d.ts +1 -1
  728. package/dist/ts4.2/room/data-track/packetizer.d.ts +1 -1
  729. package/dist/ts4.2/room/data-track/track-interfaces.d.ts +1 -1
  730. package/dist/ts4.2/room/data-track/utils.d.ts +1 -1
  731. package/dist/ts4.2/room/defaults.d.ts +1 -2
  732. package/dist/ts4.2/room/extensions.d.ts +214 -0
  733. package/dist/ts4.2/room/participant/LocalParticipant.d.ts +44 -121
  734. package/dist/ts4.2/room/participant/Participant.d.ts +8 -1
  735. package/dist/ts4.2/room/participant/RemoteParticipant.d.ts +3 -3
  736. package/dist/ts4.2/room/rpc/extension.d.ts +74 -0
  737. package/dist/ts4.2/room/rpc/index.d.ts +1 -1
  738. package/dist/ts4.2/room/rpc/legacyExtension.d.ts +39 -0
  739. package/dist/ts4.2/room/simulated-participants/extension.d.ts +25 -0
  740. package/dist/ts4.2/room/token-source/TokenSource.d.ts +5 -1
  741. package/dist/ts4.2/room/track/LocalTrack.d.ts +1 -1
  742. package/dist/ts4.2/room/track/RemoteTrackPublication.d.ts +3 -1
  743. package/dist/ts4.2/room/track/TrackPublication.d.ts +2 -2
  744. package/dist/ts4.2/room/track/create.d.ts +15 -13
  745. package/dist/ts4.2/room/track/options.d.ts +0 -6
  746. package/dist/ts4.2/room/track/processor/types.d.ts +2 -2
  747. package/dist/ts4.2/room/track/utils.d.ts +1 -1
  748. package/dist/ts4.2/room/utils.d.ts +2 -2
  749. package/dist/ts4.2/room/video/create.d.ts +28 -0
  750. package/dist/ts4.2/room/video/extension.d.ts +48 -0
  751. package/dist/ts4.2/room/video/publisher.d.ts +24 -0
  752. package/dist/ts4.2/test/MockMediaStream.d.ts +6 -0
  753. package/dist/ts4.2/utils/browserParser.d.ts +0 -3
  754. package/dist/ts4.2/utils/deferrable-map.d.ts +1 -1
  755. package/dist/ts4.2/utils/throws.d.ts +10 -0
  756. package/dist/ts4.2/version.d.ts +4 -1
  757. package/package.json +24 -9
  758. package/src/api/SignalClient.test.ts +107 -0
  759. package/src/api/SignalClient.ts +13 -3
  760. package/src/api/WebSocketStream.test.ts +67 -0
  761. package/src/api/WebSocketStream.ts +41 -3
  762. package/src/connectionHelper/checks/Checker.ts +12 -5
  763. package/src/connectionHelper/checks/publishVideo.ts +1 -1
  764. package/src/connectionHelper/checks/reconnect.ts +1 -1
  765. package/src/core.ts +35 -0
  766. package/src/e2ee/E2eeManager.test.ts +70 -1
  767. package/src/e2ee/E2eeManager.ts +53 -32
  768. package/src/e2ee/KeyProvider.ts +2 -1
  769. package/src/e2ee/extension.ts +113 -0
  770. package/src/e2ee/subscriberBlackScreen.test.ts +9 -12
  771. package/src/e2ee/types.ts +14 -0
  772. package/src/e2ee/utils.test.ts +47 -0
  773. package/src/e2ee/utils.ts +26 -14
  774. package/src/e2ee/worker/DataCryptor.test.ts +42 -1
  775. package/src/e2ee/worker/DataCryptor.ts +2 -2
  776. package/src/e2ee/worker/FrameCryptor.race.test.ts +3 -7
  777. package/src/e2ee/worker/FrameCryptor.test.ts +68 -13
  778. package/src/e2ee/worker/FrameCryptor.ts +78 -18
  779. package/src/e2ee/worker/e2ee.worker.test.ts +151 -0
  780. package/src/e2ee/worker/e2ee.worker.ts +28 -20
  781. package/src/e2ee/worker/naluUtils.test.ts +21 -1
  782. package/src/e2ee/worker/naluUtils.ts +30 -0
  783. package/src/e2ee/worker/sifPayload.ts +1 -1
  784. package/src/exports.ts +224 -0
  785. package/src/frameMetadata/FrameMetadataManager.ts +9 -3
  786. package/src/frameMetadata/extension.ts +34 -0
  787. package/src/frameMetadata/frameMetadata.ts +1 -1
  788. package/src/frameMetadata/utils.ts +23 -0
  789. package/src/index.ts +47 -189
  790. package/src/logger.ts +1 -3
  791. package/src/options.ts +25 -6
  792. package/src/room/CoreRoom.ts +3017 -0
  793. package/src/room/DeviceManager.test.ts +55 -1
  794. package/src/room/DeviceManager.ts +1 -1
  795. package/src/room/PCTransport.test.ts +43 -0
  796. package/src/room/PCTransport.ts +22 -22
  797. package/src/room/PCTransportManager.test.ts +65 -3
  798. package/src/room/PCTransportManager.ts +28 -12
  799. package/src/room/RTCEngine.test.ts +421 -21
  800. package/src/room/RTCEngine.ts +138 -34
  801. package/src/room/RegionUrlProvider.ts +1 -1
  802. package/src/room/Room.test.ts +717 -4
  803. package/src/room/Room.ts +34 -3317
  804. package/src/room/chat/extension.ts +78 -0
  805. package/src/room/createRoom.test.ts +149 -0
  806. package/src/room/createRoom.ts +26 -0
  807. package/src/room/data-channel/DataChannelManager.test.ts +37 -0
  808. package/src/room/data-channel/DataChannelManager.ts +21 -3
  809. package/src/room/data-stream/constants.ts +10 -0
  810. package/src/room/data-stream/extension.ts +162 -0
  811. package/src/room/data-stream/incoming/IncomingDataStreamManager.test.ts +269 -3
  812. package/src/room/data-stream/incoming/IncomingDataStreamManager.ts +53 -2
  813. package/src/room/data-stream/incoming/StreamReader.ts +14 -4
  814. package/src/room/data-stream/outgoing/OutgoingDataStreamManager.ts +1 -2
  815. package/src/room/data-track/depacketizer.ts +2 -2
  816. package/src/room/data-track/extension.ts +244 -0
  817. package/src/room/data-track/handle.ts +1 -1
  818. package/src/room/data-track/incoming/IncomingDataTrackManager.ts +2 -2
  819. package/src/room/data-track/incoming/pipeline.ts +2 -2
  820. package/src/room/data-track/outgoing/OutgoingDataTrackManager.test.ts +42 -3
  821. package/src/room/data-track/outgoing/OutgoingDataTrackManager.ts +5 -3
  822. package/src/room/data-track/outgoing/pipeline.ts +1 -1
  823. package/src/room/data-track/packet/extensions.ts +1 -1
  824. package/src/room/data-track/packet/index.ts +1 -1
  825. package/src/room/data-track/packet/serializable.ts +1 -1
  826. package/src/room/data-track/packetizer.ts +1 -1
  827. package/src/room/data-track/track-interfaces.ts +4 -4
  828. package/src/room/data-track/utils.ts +1 -1
  829. package/src/room/defaults.ts +3 -16
  830. package/src/room/extensions.ts +310 -0
  831. package/src/room/participant/LocalParticipant.test.ts +23 -6
  832. package/src/room/participant/LocalParticipant.ts +92 -669
  833. package/src/room/participant/Participant.test.ts +60 -0
  834. package/src/room/participant/Participant.ts +21 -1
  835. package/src/room/participant/RemoteParticipant.ts +3 -8
  836. package/src/room/participant/publishUtils.ts +3 -3
  837. package/src/room/participant/restartOnDefaultAudioDevice.test.ts +1 -1
  838. package/src/room/rpc/extension.ts +159 -0
  839. package/src/room/rpc/index.ts +1 -10
  840. package/src/room/rpc/legacyExtension.ts +36 -0
  841. package/src/room/simulated-participants/extension.ts +189 -0
  842. package/src/room/token-source/TokenSource.test.ts +29 -0
  843. package/src/room/token-source/TokenSource.ts +8 -3
  844. package/src/room/token-source/utils.test.ts +34 -0
  845. package/src/room/token-source/utils.ts +23 -1
  846. package/src/room/track/LocalTrack.ts +18 -10
  847. package/src/room/track/LocalVideoTrack.test.ts +66 -2
  848. package/src/room/track/LocalVideoTrack.ts +5 -3
  849. package/src/room/track/RemoteTrackPublication.ts +14 -1
  850. package/src/room/track/RemoteVideoTrack.test.ts +2 -0
  851. package/src/room/track/Track.test.ts +102 -0
  852. package/src/room/track/Track.ts +8 -1
  853. package/src/room/track/TrackPublication.ts +2 -2
  854. package/src/room/track/create.ts +59 -71
  855. package/src/room/track/facingMode.ts +5 -2
  856. package/src/room/track/options.ts +26 -34
  857. package/src/room/track/processor/types.ts +2 -2
  858. package/src/room/track/utils.ts +5 -1
  859. package/src/room/utils.ts +2 -2
  860. package/src/room/video/create.ts +95 -0
  861. package/src/room/video/extension.ts +115 -0
  862. package/src/room/video/publisher.ts +472 -0
  863. package/src/test/MockMediaStream.ts +13 -0
  864. package/src/utils/browserParser.ts +0 -3
  865. package/src/utils/deferrable-map.test.ts +60 -0
  866. package/src/utils/deferrable-map.ts +7 -4
  867. package/src/utils/serializer.ts +1 -1
  868. package/src/utils/throws.ts +15 -0
  869. package/src/version.ts +6 -1
@@ -0,0 +1,2279 @@
1
+ import {slicedToArray as _slicedToArray}from'../_virtual/_rollupPluginBabelHelpers.mjs';import {__awaiter}from'tslib';import {Mutex}from'@livekit/mutex';import {DisconnectReason,ParticipantInfo_State,SimulateScenario,ParticipantInfo_Kind,ClientInfo_Capability,LeaveRequest,LeaveRequest_Action}from'@livekit/protocol';import {EventEmitter}from'events';import {ensureTrailingSlash}from'../api/utils.mjs';import {isFrameMetadataSupported}from'../frameMetadata/utils.mjs';import livekitLogger,{getLogger,LoggerNames}from'../logger.mjs';import TypedPromise from'../utils/TypedPromise.mjs';import {getBrowser}from'../utils/browserParser.mjs';import {BackOffStrategy}from'./BackOffStrategy.mjs';import DeviceManager from'./DeviceManager.mjs';import RTCEngine from'./RTCEngine.mjs';import {RegionUrlProvider,DEFAULT_MAX_AGE_MS}from'./RegionUrlProvider.mjs';import {roomConnectOptionDefaults,roomOptionDefaults,audioDefaults,publishDefaults}from'./defaults.mjs';import {UnexpectedConnectionState,UnsupportedServer,ConnectionError,canFailOverToAnotherRegion,ConnectionErrorReason}from'./errors.mjs';import {RoomEvent,ParticipantEvent,TrackEvent,EngineEvent}from'./events.mjs';import {SLOT_KEYS}from'./extensions.mjs';import {LocalParticipant}from'./participant/LocalParticipant.mjs';import'./participant/Participant.mjs';import RemoteParticipant from'./participant/RemoteParticipant.mjs';import {summarizeStatsReport}from'./statsSummary.mjs';import CriticalTimers from'./timers.mjs';import {isBrowserSupported,isReactNative,isCloud,Future,isWeb,extractTranscriptionSegments,isLocalAudioTrack,unwrapConstraint,isLocalVideoTrack,toHttpUrl,numberToBigInt,releaseEmptyAudioStreamTrack,getEmptyAudioStreamTrack,supportsSetSinkId,extractTrackSid,unpackStreamId,isSafariBased,sleep,isRemotePub,isDeflateRawCompressionSupported,getDisconnectReasonFromConnectionError}from'./utils.mjs';import {Track}from'./track/Track.mjs';import {sourceToKind,kindToSource,getNewAudioContext}from'./track/utils.mjs';import'./track/TrackPublication.mjs';var ConnectionState;
2
+ (function (ConnectionState) {
3
+ ConnectionState["Disconnected"] = "disconnected";
4
+ ConnectionState["Connecting"] = "connecting";
5
+ ConnectionState["Connected"] = "connected";
6
+ ConnectionState["Reconnecting"] = "reconnecting";
7
+ ConnectionState["SignalReconnecting"] = "signalReconnecting";
8
+ })(ConnectionState || (ConnectionState = {}));
9
+ const CONNECTION_RECONCILE_FREQUENCY_MS = 4 * 1000;
10
+ const STATS_LOG_FREQUENCY_MS = 30 * 1000;
11
+ const DUMMY_AUDIO_ELEMENT_ID = 'livekit-dummy-audio-el';
12
+ /**
13
+ * One silent audio element serves every room on the page, so it is reference counted: a room
14
+ * disconnecting must not pull it out from under the rooms still playing through it. The element
15
+ * and its track go away once the last room hands its reference back.
16
+ */
17
+ let sharedDummyAudioElement;
18
+ function createSharedDummyAudioElement() {
19
+ const element = document.createElement('audio');
20
+ element.id = DUMMY_AUDIO_ELEMENT_ID;
21
+ element.autoplay = true;
22
+ element.hidden = true;
23
+ const track = getEmptyAudioStreamTrack();
24
+ track.enabled = true;
25
+ const stream = new MediaStream([track]);
26
+ element.srcObject = stream;
27
+ document.body.append(element);
28
+ return {
29
+ element,
30
+ stream,
31
+ track,
32
+ refCount: 0
33
+ };
34
+ }
35
+ /**
36
+ * The room without optional features. Use `CoreRoom.with(...extensions)` to build a room class
37
+ * with the features an application needs, or use `Room` from the main entry for all of them.
38
+ *
39
+ * In LiveKit, a room is the logical grouping for a list of participants.
40
+ * Participants in a room can publish tracks, and subscribe to others' tracks.
41
+ *
42
+ * a Room fires [[RoomEvent | RoomEvents]].
43
+ *
44
+ * @noInheritDoc
45
+ * @experimental
46
+ */
47
+ class CoreRoom extends EventEmitter {
48
+ get hasE2EESetup() {
49
+ return this.slots.e2eeManager !== undefined;
50
+ }
51
+ /**
52
+ * Creates a new Room, the primary construct for a LiveKit session.
53
+ * @param options
54
+ */
55
+ constructor(options) {
56
+ var _this;
57
+ var _a, _b, _c, _d;
58
+ super();
59
+ _this = this;
60
+ this.state = ConnectionState.Disconnected;
61
+ /**
62
+ * list of participants that are actively speaking. when this changes
63
+ * a [[RoomEvent.ActiveSpeakersChanged]] event is fired
64
+ */
65
+ this.activeSpeakers = [];
66
+ /** reflects the sender encryption status of the local participant */
67
+ this.isE2EEEnabled = false;
68
+ this.audioEnabled = true;
69
+ /**
70
+ * whether `audioContext` was created by the SDK and therefore has to be closed by it.
71
+ * A context handed in through `webAudioMix` is owned by the application instead.
72
+ */
73
+ this.ownsAudioContext = false;
74
+ /**
75
+ * set once the audio context has been released as part of a disconnect. Guards against
76
+ * creating a new context outside of a connection lifecycle, where nothing would close it again.
77
+ */
78
+ this.audioContextReleased = false;
79
+ /**
80
+ * serialises `acquireAudioContext` against `releaseAudioContext`. Both await per-track graph
81
+ * rebuilds, so without it a reconnect landing inside a disconnect's teardown leaves the two
82
+ * racing to set the participants' context, and the loser's value is the one that sticks.
83
+ */
84
+ this.audioContextMutex = new Mutex();
85
+ /** silent audio tracks this room acquired, handed back to the shared source on disconnect */
86
+ this.acquiredEmptyAudioTracks = new Set();
87
+ this.isVideoPlaybackBlocked = false;
88
+ this.log = livekitLogger;
89
+ this.statsLog = livekitLogger;
90
+ this.bufferedEvents = [];
91
+ this.isResuming = false;
92
+ this.pendingTrackAddedCallbacks = new Map();
93
+ this.installedExtensions = new Map();
94
+ /** Values extensions hand to core (the `*Provider` members of an install result); shared with the local participant. */
95
+ this.slots = {};
96
+ this.extensionDisposers = [];
97
+ this.dataPacketHandlers = new Map();
98
+ this.disposed = false;
99
+ this.connect = (url, token, opts) => __awaiter(this, void 0, void 0, function* () {
100
+ var _a;
101
+ if (this.disposed) {
102
+ throw new UnexpectedConnectionState('room has been disposed');
103
+ }
104
+ if (!isBrowserSupported()) {
105
+ if (isReactNative()) {
106
+ throw Error("WebRTC isn't detected, have you called registerGlobals?");
107
+ } else {
108
+ throw Error("LiveKit doesn't seem to be supported on this browser. Try to update your browser and make sure no browser extensions are disabling webRTC.");
109
+ }
110
+ }
111
+ // In case a disconnect called happened right before the connect call, make sure the disconnect is completed first by awaiting its lock
112
+ const unlockDisconnect = yield this.disconnectLock.lock();
113
+ if (this.disposed) {
114
+ // dispose() ran while this call waited for a disconnect to finish
115
+ unlockDisconnect();
116
+ throw new UnexpectedConnectionState('room has been disposed');
117
+ }
118
+ if (this.state === ConnectionState.Connected) {
119
+ // when the state is reconnecting or connected, this function returns immediately
120
+ this.log.info("already connected to room ".concat(this.name));
121
+ unlockDisconnect();
122
+ return Promise.resolve();
123
+ }
124
+ if (this.connectFuture) {
125
+ unlockDisconnect();
126
+ return this.connectFuture.promise;
127
+ }
128
+ this.setAndEmitConnectionState(ConnectionState.Connecting);
129
+ if (((_a = this.regionUrlProvider) === null || _a === void 0 ? void 0 : _a.getServerUrl().toString()) !== ensureTrailingSlash(url)) {
130
+ this.regionUrl = undefined;
131
+ this.regionUrlProvider = undefined;
132
+ }
133
+ if (isCloud(new URL(url))) {
134
+ if (this.regionUrlProvider === undefined) {
135
+ this.regionUrlProvider = new RegionUrlProvider(url, token);
136
+ } else {
137
+ this.regionUrlProvider.updateToken(token);
138
+ }
139
+ // trigger the first fetch without waiting for a response
140
+ // if initial connection fails, this will speed up picking regional url
141
+ // on subsequent runs
142
+ this.regionUrlProvider.fetchRegionSettings().then(settings => {
143
+ var _a;
144
+ (_a = this.regionUrlProvider) === null || _a === void 0 ? void 0 : _a.setServerReportedRegions(settings);
145
+ }).catch(e => {
146
+ this.log.warn('could not fetch region settings', {
147
+ error: e
148
+ });
149
+ });
150
+ }
151
+ const connectFn = (resolve, reject, regionUrl) => __awaiter(this, void 0, void 0, function* () {
152
+ if (this.abortController) {
153
+ this.abortController.abort();
154
+ }
155
+ // explicit creation as local var needed to satisfy TS compiler when passing it to `attemptConnection` further down
156
+ const abortController = new AbortController();
157
+ this.abortController = abortController;
158
+ // at this point the intention to connect has been signalled so we can allow cancelling of the connection via disconnect() again
159
+ unlockDisconnect === null || unlockDisconnect === void 0 ? void 0 : unlockDisconnect();
160
+ const failAttempt = (error, reason) => {
161
+ // once a newer connect() replaced this attempt's controller, the room's state belongs to it
162
+ if (this.abortController === abortController) {
163
+ this.handleDisconnect(this.options.stopLocalTrackOnUnpublish, reason);
164
+ }
165
+ reject(error);
166
+ };
167
+ try {
168
+ yield BackOffStrategy.getInstance().getBackOffPromise(url);
169
+ if (abortController.signal.aborted) {
170
+ throw ConnectionError.cancelled('Connection attempt aborted');
171
+ }
172
+ yield this.attemptConnection(regionUrl !== null && regionUrl !== void 0 ? regionUrl : url, token, opts, abortController);
173
+ this.abortController = undefined;
174
+ resolve();
175
+ } catch (error) {
176
+ if (this.regionUrlProvider && error instanceof ConnectionError && canFailOverToAnotherRegion(error)) {
177
+ let nextUrl = null;
178
+ try {
179
+ this.log.debug('Fetching next region');
180
+ nextUrl = yield this.regionUrlProvider.getNextBestRegionUrl(abortController.signal);
181
+ } catch (regionFetchError) {
182
+ if (regionFetchError instanceof ConnectionError && (regionFetchError.status === 401 || regionFetchError.reason === ConnectionErrorReason.Cancelled)) {
183
+ failAttempt(regionFetchError);
184
+ return;
185
+ }
186
+ }
187
+ if (
188
+ // making sure we only register failed attempts on things we actually care about
189
+ [ConnectionErrorReason.InternalError, ConnectionErrorReason.ServerUnreachable, ConnectionErrorReason.Timeout].includes(error.reason)) {
190
+ this.log.debug('Adding failed connection attempt to back off');
191
+ BackOffStrategy.getInstance().addFailedConnectionAttempt(url);
192
+ }
193
+ if (nextUrl && !abortController.signal.aborted) {
194
+ this.log.info("Initial connection failed with ConnectionError: ".concat(error.message, ". Retrying with another region: ").concat(nextUrl));
195
+ this.recreateEngine(true);
196
+ yield connectFn(resolve, reject, nextUrl);
197
+ } else {
198
+ failAttempt(error, getDisconnectReasonFromConnectionError(error));
199
+ }
200
+ } else {
201
+ let disconnectReason = DisconnectReason.UNKNOWN_REASON;
202
+ if (error instanceof ConnectionError) {
203
+ disconnectReason = getDisconnectReasonFromConnectionError(error);
204
+ }
205
+ failAttempt(error, disconnectReason);
206
+ }
207
+ }
208
+ });
209
+ const regionUrl = this.regionUrl;
210
+ this.regionUrl = undefined;
211
+ this.connectFuture = new Future((resolve, reject) => {
212
+ connectFn(resolve, reject, regionUrl);
213
+ }, () => {
214
+ this.clearConnectionFutures();
215
+ });
216
+ return this.connectFuture.promise;
217
+ });
218
+ this.connectSignal = (url, token, engine, connectOptions, roomOptions, abortController) => __awaiter(this, void 0, void 0, function* () {
219
+ const _yield$engine$join = yield engine.join(url, token, {
220
+ autoSubscribe: connectOptions.autoSubscribe,
221
+ adaptiveStream: typeof roomOptions.adaptiveStream === 'object' ? true : roomOptions.adaptiveStream,
222
+ disableIceLite: connectOptions.disableIceLite,
223
+ subscriberAllowPause: connectOptions.subscriberAllowPause,
224
+ clientInfoCapabilities: this.getClientInfoCapabilities(),
225
+ maxRetries: connectOptions.maxRetries,
226
+ e2eeEnabled: !!this.slots.e2eeManager,
227
+ websocketTimeout: connectOptions.websocketTimeout
228
+ }, abortController.signal, !roomOptions.singlePeerConnection),
229
+ joinResponse = _yield$engine$join.joinResponse,
230
+ serverInfo = _yield$engine$join.serverInfo;
231
+ this.serverInfo = serverInfo;
232
+ if (!serverInfo.version) {
233
+ throw new UnsupportedServer('unknown server version');
234
+ }
235
+ if (serverInfo.version === '0.15.1' && this.options.dynacast) {
236
+ this.log.debug('disabling dynacast due to server version');
237
+ // dynacast has a bug in 0.15.1, so we cannot use it then
238
+ roomOptions.dynacast = false;
239
+ }
240
+ return joinResponse;
241
+ });
242
+ this.applyJoinResponse = joinResponse => {
243
+ const pi = joinResponse.participant;
244
+ this.localParticipant.sid = pi.sid;
245
+ this.localParticipant.identity = pi.identity;
246
+ this.localParticipant.setEnabledPublishCodecs(joinResponse.enabledPublishCodecs);
247
+ if (this.slots.e2eeManager) {
248
+ try {
249
+ this.slots.e2eeManager.setSifTrailer(joinResponse.sifTrailer);
250
+ } catch (e) {
251
+ this.log.error(e instanceof Error ? e.message : 'Could not set SifTrailer', {
252
+ error: e
253
+ });
254
+ }
255
+ }
256
+ // populate remote participants, these should not trigger new events
257
+ this.handleParticipantUpdates([pi, ...joinResponse.otherParticipants]);
258
+ if (joinResponse.room) {
259
+ this.handleRoomUpdate(joinResponse.room);
260
+ }
261
+ };
262
+ this.attemptConnection = (url, token, opts, abortController) => __awaiter(this, void 0, void 0, function* () {
263
+ var _a, _b;
264
+ if (this.state === ConnectionState.Reconnecting || this.isResuming || ((_a = this.engine) === null || _a === void 0 ? void 0 : _a.pendingReconnect)) {
265
+ this.log.info('Reconnection attempt replaced by new connection attempt');
266
+ // make sure we close and recreate the existing engine in order to get rid of any potentially ongoing reconnection attempts
267
+ this.recreateEngine(true);
268
+ } else {
269
+ // create engine if previously disconnected
270
+ this.maybeCreateEngine();
271
+ }
272
+ // a concurrent disconnect() or connect() can replace or clear `this.engine` while we await below
273
+ const engine = this.engine;
274
+ if ((_b = this.regionUrlProvider) === null || _b === void 0 ? void 0 : _b.isCloud()) {
275
+ engine.setRegionStrategy(this.createRegionStrategy());
276
+ }
277
+ this.acquireAudioContext(true).catch(error => this.log.warn('Could not acquire audio context', Object.assign(Object.assign({}, this.logContext), {
278
+ error
279
+ })));
280
+ this.connOptions = Object.assign(Object.assign({}, roomConnectOptionDefaults), opts);
281
+ if (this.connOptions.rtcConfig) {
282
+ engine.rtcConfig = this.connOptions.rtcConfig;
283
+ }
284
+ if (this.connOptions.peerConnectionTimeout) {
285
+ engine.peerConnectionTimeout = this.connOptions.peerConnectionTimeout;
286
+ }
287
+ try {
288
+ const joinResponse = yield this.connectSignal(url, token, engine, this.connOptions, this.options, abortController);
289
+ this.applyJoinResponse(joinResponse);
290
+ // forward metadata changed for the local participant
291
+ this.setupLocalParticipantEvents();
292
+ this.emit(RoomEvent.SignalConnected);
293
+ } catch (err) {
294
+ yield engine.close();
295
+ this.recreateEngine(false, engine);
296
+ const resultingError = abortController.signal.aborted ? ConnectionError.cancelled('Signal connection aborted') : ConnectionError.serverUnreachable('could not establish signal connection');
297
+ if (err instanceof Error) {
298
+ resultingError.message = "".concat(resultingError.message, ": ").concat(err.message);
299
+ }
300
+ if (err instanceof ConnectionError) {
301
+ resultingError.reason = err.reason;
302
+ resultingError.status = err.status;
303
+ }
304
+ this.log.debug("error trying to establish signal connection", {
305
+ error: err
306
+ });
307
+ throw resultingError;
308
+ }
309
+ if (abortController.signal.aborted) {
310
+ yield engine.close();
311
+ this.recreateEngine(false, engine);
312
+ throw ConnectionError.cancelled("Connection attempt aborted");
313
+ }
314
+ try {
315
+ yield engine.waitForPCInitialConnection(this.connOptions.peerConnectionTimeout, abortController);
316
+ } catch (e) {
317
+ yield engine.close();
318
+ this.recreateEngine(false, engine);
319
+ throw e;
320
+ }
321
+ // also hook unload event
322
+ if (isWeb() && this.options.disconnectOnPageLeave) {
323
+ // capturing both 'pagehide' and 'beforeunload' to capture broadest set of browser behaviors
324
+ window.addEventListener('pagehide', this.onPageLeave);
325
+ window.addEventListener('beforeunload', this.onPageLeave);
326
+ }
327
+ if (isWeb()) {
328
+ window.addEventListener('freeze', this.onPageLeave);
329
+ }
330
+ this.setAndEmitConnectionState(ConnectionState.Connected);
331
+ this.emit(RoomEvent.Connected);
332
+ BackOffStrategy.getInstance().resetFailedConnectionAttempts(url);
333
+ this.registerConnectionReconcile();
334
+ // Notify region provider about successful connection
335
+ if (this.regionUrlProvider) {
336
+ this.regionUrlProvider.notifyConnected();
337
+ }
338
+ });
339
+ /**
340
+ * disconnects the room, emits [[RoomEvent.Disconnected]]
341
+ */
342
+ this.disconnect = function () {
343
+ for (var _len = arguments.length, args_1 = new Array(_len), _key = 0; _key < _len; _key++) {
344
+ args_1[_key] = arguments[_key];
345
+ }
346
+ return __awaiter(_this, [...args_1], void 0, function () {
347
+ var _this2 = this;
348
+ let stopTracks = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
349
+ return function* () {
350
+ var _a, _b, _c;
351
+ const unlock = yield _this2.disconnectLock.lock();
352
+ try {
353
+ if (_this2.state === ConnectionState.Disconnected) {
354
+ _this2.log.debug('already disconnected');
355
+ return;
356
+ }
357
+ _this2.log.info('disconnect from room');
358
+ if (_this2.state === ConnectionState.Connecting || _this2.state === ConnectionState.Reconnecting || _this2.isResuming) {
359
+ // try aborting pending connection attempt
360
+ const msg = 'Abort connection attempt due to user initiated disconnect';
361
+ _this2.log.warn(msg);
362
+ (_a = _this2.abortController) === null || _a === void 0 ? void 0 : _a.abort(msg);
363
+ // in case the abort controller didn't manage to cancel the connection attempt, reject the connect promise explicitly
364
+ (_c = (_b = _this2.connectFuture) === null || _b === void 0 ? void 0 : _b.reject) === null || _c === void 0 ? void 0 : _c.call(_b, ConnectionError.cancelled('Client initiated disconnect'));
365
+ _this2.connectFuture = undefined;
366
+ }
367
+ // close engine (also closes client)
368
+ if (_this2.engine) {
369
+ // send leave
370
+ if (!_this2.engine.client.isDisconnected) {
371
+ yield _this2.engine.client.sendLeave();
372
+ }
373
+ yield _this2.engine.close();
374
+ }
375
+ _this2.handleDisconnect(stopTracks, DisconnectReason.CLIENT_INITIATED);
376
+ /* @ts-ignore */
377
+ _this2.engine = undefined;
378
+ } finally {
379
+ unlock();
380
+ }
381
+ }();
382
+ });
383
+ };
384
+ this.onPageLeave = () => __awaiter(this, void 0, void 0, function* () {
385
+ this.log.info('Page leave detected, disconnecting');
386
+ yield this.disconnect();
387
+ });
388
+ /**
389
+ * Browsers have different policies regarding audio playback. Most requiring
390
+ * some form of user interaction (click/tap/etc).
391
+ * In those cases, audio will be silent until a click/tap triggering one of the following
392
+ * - `startAudio`
393
+ * - `getUserMedia`
394
+ */
395
+ this.startAudio = () => __awaiter(this, void 0, void 0, function* () {
396
+ const elements = [];
397
+ const browser = getBrowser();
398
+ if (browser && browser.os === 'iOS' && !this.audioContextReleased) {
399
+ elements.push(this.acquireDummyAudioElement());
400
+ }
401
+ this.remoteParticipants.forEach(p => {
402
+ p.audioTrackPublications.forEach(t => {
403
+ if (t.track) {
404
+ t.track.attachedElements.forEach(e => {
405
+ elements.push(e);
406
+ });
407
+ }
408
+ });
409
+ });
410
+ try {
411
+ yield Promise.all([
412
+ // once the audio context has been released as part of a disconnect there is nothing left
413
+ // to unlock, and creating a new context here would leak it as no disconnect will follow
414
+ ...(this.audioContextReleased ? [] : [this.acquireAudioContext()]), ...elements.map(e => {
415
+ // when webAudioMix is enabled, attached elements are deliberately kept muted by
416
+ // RemoteAudioTrack.attach() and audio is routed through the web audio graph instead.
417
+ // unmuting them here would cause double playback on platforms where element.volume
418
+ // has no effect (e.g. iOS Safari)
419
+ if (!this.options.webAudioMix) {
420
+ e.muted = false;
421
+ }
422
+ return e.play();
423
+ })]);
424
+ this.handleAudioPlaybackStarted();
425
+ } catch (err) {
426
+ this.handleAudioPlaybackFailed(err);
427
+ throw err;
428
+ }
429
+ });
430
+ this.startVideo = () => __awaiter(this, void 0, void 0, function* () {
431
+ const elements = [];
432
+ for (const p of this.remoteParticipants.values()) {
433
+ p.videoTrackPublications.forEach(tr => {
434
+ var _a;
435
+ (_a = tr.track) === null || _a === void 0 ? void 0 : _a.attachedElements.forEach(el => {
436
+ if (!elements.includes(el)) {
437
+ elements.push(el);
438
+ }
439
+ });
440
+ });
441
+ }
442
+ yield Promise.all(elements.map(el => el.play())).then(() => {
443
+ this.handleVideoPlaybackStarted();
444
+ }).catch(e => {
445
+ if (e.name === 'NotAllowedError') {
446
+ this.handleVideoPlaybackFailed();
447
+ } else {
448
+ this.log.warn('Resuming video playback failed, make sure you call `startVideo` directly in a user gesture handler');
449
+ }
450
+ });
451
+ });
452
+ this.handleRestarting = () => {
453
+ var _a;
454
+ this.clearConnectionReconcile();
455
+ // in case we went from resuming to full-reconnect, make sure to reflect it on the isResuming flag
456
+ this.isResuming = false;
457
+ // a region that failed after its join leaves its room state and held back events behind
458
+ (_a = this.roomInfoBeforeRestart) !== null && _a !== void 0 ? _a : this.roomInfoBeforeRestart = this.roomInfo;
459
+ this.roomInfo = this.roomInfoBeforeRestart;
460
+ this.bufferedEvents = [];
461
+ // also unwind existing participants & existing subscriptions
462
+ for (const p of this.remoteParticipants.values()) {
463
+ this.handleParticipantDisconnected(p.identity, p);
464
+ }
465
+ // During connect(), the room stays `Connecting` and connect() reports the outcome.
466
+ if (!this.connectFuture && this.setAndEmitConnectionState(ConnectionState.Reconnecting)) {
467
+ this.emit(RoomEvent.Reconnecting);
468
+ }
469
+ };
470
+ this.handleSignalRestarted = (joinResponse, restartAttempt) => __awaiter(this, void 0, void 0, function* () {
471
+ this.log.debug("signal reconnected to server, region ".concat(joinResponse.serverRegion), {
472
+ region: joinResponse.serverRegion
473
+ });
474
+ this.bufferedEvents = [];
475
+ const initialConnection = this.connectFuture !== undefined;
476
+ const restarted = this.engine.waitForRestarted(restartAttempt);
477
+ this.applyJoinResponse(joinResponse);
478
+ try {
479
+ // unpublish & republish tracks
480
+ yield this.localParticipant.republishAllTracks(undefined, true);
481
+ } catch (error) {
482
+ this.log.error('error trying to re-publish tracks after reconnection', {
483
+ error
484
+ });
485
+ }
486
+ // the attempt is aborted when a newer attempt began, on the next region or in a later
487
+ // restart, or when the engine closed; whatever replaced it reports the outcome
488
+ if (!(yield restarted) || restartAttempt.aborted) {
489
+ return;
490
+ }
491
+ this.log.debug("fully reconnected to server", {
492
+ region: joinResponse.serverRegion
493
+ });
494
+ this.roomInfoBeforeRestart = undefined;
495
+ if (initialConnection) {
496
+ // connect() emits `Connected`; as on any initial join, events from before it are dropped.
497
+ this.bufferedEvents = [];
498
+ return;
499
+ }
500
+ this.setAndEmitConnectionState(ConnectionState.Connected);
501
+ this.emit(RoomEvent.Reconnected);
502
+ this.registerConnectionReconcile();
503
+ this.emitBufferedEvents();
504
+ });
505
+ this.handleParticipantUpdates = participantInfos => {
506
+ var _a;
507
+ // handle changes to participant state, and send events
508
+ const appliedInfos = [];
509
+ for (const info of participantInfos) {
510
+ if (info.identity === this.localParticipant.identity) {
511
+ this.localParticipant.updateInfo(info);
512
+ appliedInfos.push(info);
513
+ continue;
514
+ }
515
+ // LiveKit server doesn't send identity info prior to version 1.5.2 in disconnect updates
516
+ // so we try to map an empty identity to an already known sID manually
517
+ if (info.identity === '') {
518
+ info.identity = (_a = this.sidToIdentity.get(info.sid)) !== null && _a !== void 0 ? _a : '';
519
+ }
520
+ let remoteParticipant = this.remoteParticipants.get(info.identity);
521
+ // a late update for an older session of this identity must not change the current session
522
+ if (remoteParticipant === null || remoteParticipant === void 0 ? void 0 : remoteParticipant.isOlderSession(info)) {
523
+ this.log.debug('ignoring update from an older participant session', {
524
+ remoteIdentity: info.identity,
525
+ staleSid: info.sid,
526
+ currentSid: remoteParticipant.sid
527
+ });
528
+ continue;
529
+ }
530
+ // when it's disconnected, send updates
531
+ if (info.state === ParticipantInfo_State.DISCONNECTED) {
532
+ this.handleParticipantDisconnected(info.identity, remoteParticipant, info.disconnectReason === DisconnectReason.UNKNOWN_REASON ? undefined : info.disconnectReason);
533
+ } else {
534
+ // create participant if doesn't exist
535
+ this.getOrCreateParticipant(info.identity, info);
536
+ }
537
+ appliedInfos.push(info);
538
+ }
539
+ this.extensionResults.forEach(result => {
540
+ var _a;
541
+ return (_a = result.onParticipantUpdates) === null || _a === void 0 ? void 0 : _a.call(result, appliedInfos);
542
+ });
543
+ };
544
+ // updates are sent only when there's a change to speaker ordering
545
+ this.handleActiveSpeakersUpdate = speakers => {
546
+ const activeSpeakers = [];
547
+ const seenSids = {};
548
+ speakers.forEach(speaker => {
549
+ seenSids[speaker.sid] = true;
550
+ if (speaker.sid === this.localParticipant.sid) {
551
+ this.localParticipant.audioLevel = speaker.level;
552
+ this.localParticipant.setIsSpeaking(true);
553
+ activeSpeakers.push(this.localParticipant);
554
+ } else {
555
+ const p = this.getRemoteParticipantBySid(speaker.sid);
556
+ if (p) {
557
+ p.audioLevel = speaker.level;
558
+ p.setIsSpeaking(true);
559
+ activeSpeakers.push(p);
560
+ }
561
+ }
562
+ });
563
+ if (!seenSids[this.localParticipant.sid]) {
564
+ this.localParticipant.audioLevel = 0;
565
+ this.localParticipant.setIsSpeaking(false);
566
+ }
567
+ this.remoteParticipants.forEach(p => {
568
+ if (!seenSids[p.sid]) {
569
+ p.audioLevel = 0;
570
+ p.setIsSpeaking(false);
571
+ }
572
+ });
573
+ this.activeSpeakers = activeSpeakers;
574
+ this.emitWhenConnected(RoomEvent.ActiveSpeakersChanged, activeSpeakers);
575
+ };
576
+ // process list of changed speakers
577
+ this.handleSpeakersChanged = speakerUpdates => {
578
+ const lastSpeakers = new Map();
579
+ this.activeSpeakers.forEach(p => {
580
+ const remoteParticipant = this.remoteParticipants.get(p.identity);
581
+ if (remoteParticipant && remoteParticipant.sid !== p.sid) {
582
+ return;
583
+ }
584
+ lastSpeakers.set(p.sid, p);
585
+ });
586
+ speakerUpdates.forEach(speaker => {
587
+ let p = this.getRemoteParticipantBySid(speaker.sid);
588
+ if (speaker.sid === this.localParticipant.sid) {
589
+ p = this.localParticipant;
590
+ }
591
+ if (!p) {
592
+ return;
593
+ }
594
+ p.audioLevel = speaker.level;
595
+ p.setIsSpeaking(speaker.active);
596
+ if (speaker.active) {
597
+ lastSpeakers.set(speaker.sid, p);
598
+ } else {
599
+ lastSpeakers.delete(speaker.sid);
600
+ }
601
+ });
602
+ const activeSpeakers = Array.from(lastSpeakers.values());
603
+ activeSpeakers.sort((a, b) => b.audioLevel - a.audioLevel);
604
+ this.activeSpeakers = activeSpeakers;
605
+ this.emitWhenConnected(RoomEvent.ActiveSpeakersChanged, activeSpeakers);
606
+ };
607
+ this.handleStreamStateUpdate = streamStateUpdate => {
608
+ streamStateUpdate.streamStates.forEach(streamState => {
609
+ const participant = this.getRemoteParticipantBySid(streamState.participantSid);
610
+ if (!participant) {
611
+ return;
612
+ }
613
+ const pub = participant.getTrackPublicationBySid(streamState.trackSid);
614
+ if (!pub || !pub.track) {
615
+ return;
616
+ }
617
+ const newStreamState = Track.streamStateFromProto(streamState.state);
618
+ const prevStreamState = pub.track.streamState;
619
+ pub.track.setStreamState(newStreamState);
620
+ if (newStreamState !== prevStreamState) {
621
+ participant.emit(ParticipantEvent.TrackStreamStateChanged, pub, pub.track.streamState);
622
+ this.emitWhenConnected(RoomEvent.TrackStreamStateChanged, pub, pub.track.streamState, participant);
623
+ }
624
+ });
625
+ };
626
+ this.handleSubscriptionPermissionUpdate = update => {
627
+ const participant = this.getRemoteParticipantBySid(update.participantSid);
628
+ if (!participant) {
629
+ return;
630
+ }
631
+ const pub = participant.getTrackPublicationBySid(update.trackSid);
632
+ if (!pub) {
633
+ return;
634
+ }
635
+ pub.setAllowed(update.allowed);
636
+ };
637
+ this.handleSubscriptionError = update => {
638
+ this.cancelPendingTrackAdded(update.trackSid);
639
+ const participant = Array.from(this.remoteParticipants.values()).find(p => p.trackPublications.has(update.trackSid));
640
+ if (!participant) {
641
+ return;
642
+ }
643
+ const pub = participant.getTrackPublicationBySid(update.trackSid);
644
+ if (!pub) {
645
+ return;
646
+ }
647
+ pub.setSubscriptionError(update.err);
648
+ };
649
+ this.handleDataPacket = (packet, encryptionType) => {
650
+ var _a;
651
+ // find the participant
652
+ const participant = this.remoteParticipants.get(packet.participantIdentity);
653
+ if (packet.value.case === 'user') {
654
+ this.handleUserPacket(participant, packet.value.value, packet.kind, encryptionType, packet.participantIdentity);
655
+ } else if (packet.value.case === 'transcription') {
656
+ this.handleTranscription(participant, packet.value.value);
657
+ } else if (packet.value.case === 'sipDtmf') {
658
+ this.handleSipDtmf(participant, packet.value.value);
659
+ } else if (packet.value.case === 'metrics') {
660
+ this.handleMetrics(packet.value.value, participant);
661
+ } else if (packet.value.case) {
662
+ // every other case belongs to an extension (data streams, rpc, ...)
663
+ (_a = this.dataPacketHandlers.get(packet.value.case)) === null || _a === void 0 ? void 0 : _a(packet, encryptionType, participant);
664
+ }
665
+ };
666
+ this.handleUserPacket = (participant, userPacket, kind, encryptionType, participantIdentity) => {
667
+ this.emit(RoomEvent.DataReceived, userPacket.payload, participant, kind, userPacket.topic, encryptionType, participantIdentity);
668
+ // also emit on the participant
669
+ participant === null || participant === void 0 ? void 0 : participant.emit(ParticipantEvent.DataReceived, userPacket.payload, kind, encryptionType);
670
+ };
671
+ this.handleSipDtmf = (participant, dtmf) => {
672
+ this.emit(RoomEvent.SipDTMFReceived, dtmf, participant);
673
+ // also emit on the participant
674
+ participant === null || participant === void 0 ? void 0 : participant.emit(ParticipantEvent.SipDTMFReceived, dtmf);
675
+ };
676
+ this.handleTranscription = (_remoteParticipant, transcription) => {
677
+ // find the participant
678
+ const participant = transcription.transcribedParticipantIdentity === this.localParticipant.identity ? this.localParticipant : this.getParticipantByIdentity(transcription.transcribedParticipantIdentity);
679
+ const publication = participant === null || participant === void 0 ? void 0 : participant.trackPublications.get(transcription.trackId);
680
+ const segments = extractTranscriptionSegments(transcription, this.transcriptionReceivedTimes);
681
+ publication === null || publication === void 0 ? void 0 : publication.emit(TrackEvent.TranscriptionReceived, segments);
682
+ participant === null || participant === void 0 ? void 0 : participant.emit(ParticipantEvent.TranscriptionReceived, segments, publication);
683
+ this.emit(RoomEvent.TranscriptionReceived, segments, participant, publication);
684
+ };
685
+ this.handleMetrics = (metrics, participant) => {
686
+ this.emit(RoomEvent.MetricsReceived, metrics, participant);
687
+ };
688
+ this.bufferedSegments = new Map();
689
+ this.handleAudioPlaybackStarted = () => {
690
+ if (this.canPlaybackAudio) {
691
+ return;
692
+ }
693
+ this.audioEnabled = true;
694
+ this.emit(RoomEvent.AudioPlaybackStatusChanged, true);
695
+ };
696
+ this.handleAudioPlaybackFailed = e => {
697
+ this.log.warn('could not playback audio', {
698
+ error: e
699
+ });
700
+ if (!this.canPlaybackAudio) {
701
+ return;
702
+ }
703
+ this.audioEnabled = false;
704
+ this.emit(RoomEvent.AudioPlaybackStatusChanged, false);
705
+ };
706
+ this.handleVideoPlaybackStarted = () => {
707
+ if (this.isVideoPlaybackBlocked) {
708
+ this.isVideoPlaybackBlocked = false;
709
+ this.emit(RoomEvent.VideoPlaybackStatusChanged, true);
710
+ }
711
+ };
712
+ this.handleVideoPlaybackFailed = () => {
713
+ if (!this.isVideoPlaybackBlocked) {
714
+ this.isVideoPlaybackBlocked = true;
715
+ this.emit(RoomEvent.VideoPlaybackStatusChanged, false);
716
+ }
717
+ };
718
+ this.handleDeviceChange = () => __awaiter(this, void 0, void 0, function* () {
719
+ var _a;
720
+ if (((_a = getBrowser()) === null || _a === void 0 ? void 0 : _a.os) !== 'iOS') {
721
+ // default devices are non deterministic on iOS, so we don't attempt to select them here
722
+ yield this.selectDefaultDevices();
723
+ }
724
+ this.emit(RoomEvent.MediaDevicesChanged);
725
+ });
726
+ this.handleRoomUpdate = room => {
727
+ const oldRoom = this.roomInfo;
728
+ this.roomInfo = room;
729
+ if (oldRoom && oldRoom.metadata !== room.metadata) {
730
+ this.emitWhenConnected(RoomEvent.RoomMetadataChanged, room.metadata);
731
+ }
732
+ if ((oldRoom === null || oldRoom === void 0 ? void 0 : oldRoom.activeRecording) !== room.activeRecording) {
733
+ this.emitWhenConnected(RoomEvent.RecordingStatusChanged, room.activeRecording);
734
+ }
735
+ };
736
+ this.handleConnectionQualityUpdate = update => {
737
+ update.updates.forEach(info => {
738
+ if (info.participantSid === this.localParticipant.sid) {
739
+ this.localParticipant.setConnectionQuality(info.quality);
740
+ return;
741
+ }
742
+ const participant = this.getRemoteParticipantBySid(info.participantSid);
743
+ if (participant) {
744
+ participant.setConnectionQuality(info.quality);
745
+ }
746
+ });
747
+ };
748
+ /**
749
+ * Dumps stats of both peer connections.
750
+ */
751
+ this.logWebRTCStats = () => __awaiter(this, void 0, void 0, function* () {
752
+ var _a, _b, _c, _d;
753
+ const pcManager = (_a = this.engine) === null || _a === void 0 ? void 0 : _a.pcManager;
754
+ if (!pcManager) {
755
+ return;
756
+ }
757
+ try {
758
+ const _yield$Promise$all = yield Promise.all([pcManager.publisher.getStats(), (_b = pcManager.subscriber) === null || _b === void 0 ? void 0 : _b.getStats()]),
759
+ _yield$Promise$all2 = _slicedToArray(_yield$Promise$all, 2),
760
+ publisher = _yield$Promise$all2[0],
761
+ subscriber = _yield$Promise$all2[1];
762
+ const publisherStats = publisher && summarizeStatsReport(publisher);
763
+ const subscriberStats = subscriber && summarizeStatsReport(subscriber);
764
+ this.statsLog.info("webrtc stats", {
765
+ publisher: publisherStats === null || publisherStats === void 0 ? void 0 : publisherStats.connection,
766
+ subscriber: subscriberStats === null || subscriberStats === void 0 ? void 0 : subscriberStats.connection,
767
+ inbound: [...((_c = publisherStats === null || publisherStats === void 0 ? void 0 : publisherStats.inbound) !== null && _c !== void 0 ? _c : []), ...((_d = subscriberStats === null || subscriberStats === void 0 ? void 0 : subscriberStats.inbound) !== null && _d !== void 0 ? _d : [])],
768
+ outbound: publisherStats === null || publisherStats === void 0 ? void 0 : publisherStats.outbound
769
+ });
770
+ } catch (error) {
771
+ this.statsLog.debug('could not collect webrtc stats', {
772
+ error
773
+ });
774
+ }
775
+ });
776
+ this.onLocalParticipantMetadataChanged = metadata => {
777
+ this.emit(RoomEvent.ParticipantMetadataChanged, metadata, this.localParticipant);
778
+ };
779
+ this.onLocalParticipantNameChanged = name => {
780
+ this.emit(RoomEvent.ParticipantNameChanged, name, this.localParticipant);
781
+ };
782
+ this.onLocalAttributesChanged = changedAttributes => {
783
+ this.emit(RoomEvent.ParticipantAttributesChanged, changedAttributes, this.localParticipant);
784
+ };
785
+ this.onLocalTrackMuted = pub => {
786
+ this.emit(RoomEvent.TrackMuted, pub, this.localParticipant);
787
+ };
788
+ this.onLocalTrackUnmuted = pub => {
789
+ this.emit(RoomEvent.TrackUnmuted, pub, this.localParticipant);
790
+ };
791
+ this.onTrackProcessorUpdate = processor => {
792
+ var _a;
793
+ (_a = processor === null || processor === void 0 ? void 0 : processor.onPublish) === null || _a === void 0 ? void 0 : _a.call(processor, this);
794
+ };
795
+ this.onLocalTrackPublished = pub => __awaiter(this, void 0, void 0, function* () {
796
+ var _a, _b, _c, _d, _e, _f;
797
+ (_a = pub.track) === null || _a === void 0 ? void 0 : _a.on(TrackEvent.TrackProcessorUpdate, this.onTrackProcessorUpdate);
798
+ (_b = pub.track) === null || _b === void 0 ? void 0 : _b.on(TrackEvent.Restarted, this.onLocalTrackRestarted);
799
+ (_e = (_d = (_c = pub.track) === null || _c === void 0 ? void 0 : _c.getProcessor()) === null || _d === void 0 ? void 0 : _d.onPublish) === null || _e === void 0 ? void 0 : _e.call(_d, this);
800
+ this.emit(RoomEvent.LocalTrackPublished, pub, this.localParticipant);
801
+ if (isLocalAudioTrack(pub.track)) {
802
+ const trackIsSilent = yield pub.track.checkForSilence();
803
+ if (trackIsSilent) {
804
+ this.emit(RoomEvent.LocalAudioSilenceDetected, pub);
805
+ }
806
+ }
807
+ const deviceId = yield (_f = pub.track) === null || _f === void 0 ? void 0 : _f.getDeviceId(false);
808
+ const deviceKind = sourceToKind(pub.source);
809
+ if (deviceKind && deviceId && deviceId !== this.localParticipant.activeDeviceMap.get(deviceKind)) {
810
+ this.localParticipant.activeDeviceMap.set(deviceKind, deviceId);
811
+ this.emit(RoomEvent.ActiveDeviceChanged, deviceKind, deviceId);
812
+ }
813
+ });
814
+ this.onLocalTrackUnpublished = pub => {
815
+ var _a, _b;
816
+ (_a = pub.track) === null || _a === void 0 ? void 0 : _a.off(TrackEvent.TrackProcessorUpdate, this.onTrackProcessorUpdate);
817
+ (_b = pub.track) === null || _b === void 0 ? void 0 : _b.off(TrackEvent.Restarted, this.onLocalTrackRestarted);
818
+ this.emit(RoomEvent.LocalTrackUnpublished, pub, this.localParticipant);
819
+ };
820
+ this.onLocalTrackRestarted = track => __awaiter(this, void 0, void 0, function* () {
821
+ const deviceId = yield track.getDeviceId(false);
822
+ const deviceKind = sourceToKind(track.source);
823
+ if (deviceKind && deviceId && deviceId !== this.localParticipant.activeDeviceMap.get(deviceKind)) {
824
+ this.log.debug("local track restarted, setting ".concat(deviceKind, " ").concat(deviceId, " active"));
825
+ this.localParticipant.activeDeviceMap.set(deviceKind, deviceId);
826
+ this.emit(RoomEvent.ActiveDeviceChanged, deviceKind, deviceId);
827
+ }
828
+ });
829
+ this.onLocalConnectionQualityChanged = quality => {
830
+ this.emit(RoomEvent.ConnectionQualityChanged, quality, this.localParticipant);
831
+ };
832
+ this.onMediaDevicesError = (e, kind) => {
833
+ this.emit(RoomEvent.MediaDevicesError, e, kind);
834
+ };
835
+ this.onLocalParticipantPermissionsChanged = prevPermissions => {
836
+ this.emit(RoomEvent.ParticipantPermissionsChanged, prevPermissions, this.localParticipant);
837
+ };
838
+ this.setMaxListeners(100);
839
+ this.remoteParticipants = new Map();
840
+ this.sidToIdentity = new Map();
841
+ this.options = Object.assign(Object.assign({}, roomOptionDefaults), options);
842
+ this.log = getLogger((_a = this.options.loggerName) !== null && _a !== void 0 ? _a : LoggerNames.Room, () => this.logContext);
843
+ // its own logger name, so the stats dumps can be silenced or routed
844
+ // separately from the rest of the room's logs
845
+ this.statsLog = getLogger(LoggerNames.Stats, () => this.logContext);
846
+ this.transcriptionReceivedTimes = new Map();
847
+ this.options.audioCaptureDefaults = Object.assign(Object.assign({}, audioDefaults), options === null || options === void 0 ? void 0 : options.audioCaptureDefaults);
848
+ this.options.videoCaptureDefaults = Object.assign({}, options === null || options === void 0 ? void 0 : options.videoCaptureDefaults);
849
+ this.options.publishDefaults = Object.assign(Object.assign({}, publishDefaults), options === null || options === void 0 ? void 0 : options.publishDefaults);
850
+ this.maybeCreateEngine();
851
+ this.disconnectLock = new Mutex();
852
+ this.localParticipant = new LocalParticipant('', '', this.engine, this.options, this.slots);
853
+ if (this.options.videoCaptureDefaults.deviceId) {
854
+ this.localParticipant.activeDeviceMap.set('videoinput', unwrapConstraint(this.options.videoCaptureDefaults.deviceId));
855
+ }
856
+ if (this.options.audioCaptureDefaults.deviceId) {
857
+ this.localParticipant.activeDeviceMap.set('audioinput', unwrapConstraint(this.options.audioCaptureDefaults.deviceId));
858
+ }
859
+ if ((_b = this.options.audioOutput) === null || _b === void 0 ? void 0 : _b.deviceId) {
860
+ this.switchActiveDevice('audiooutput', unwrapConstraint(this.options.audioOutput.deviceId)).catch(e => this.log.warn("Could not set audio output: ".concat(e.message)));
861
+ }
862
+ if (isWeb()) {
863
+ const cleanupController = new AbortController();
864
+ this.cleanupController = cleanupController;
865
+ let onDeviceChange;
866
+ const cleanupRegistry = this.constructor.cleanupRegistry;
867
+ if (cleanupRegistry) {
868
+ // Wrap the listener in a WeakRef closure so navigator.mediaDevices does not
869
+ // strongly retain the Room. When the user drops their Room ref, the
870
+ // FinalizationRegistry callback aborts the controller and removes the listener.
871
+ onDeviceChange = CoreRoom.createWeakDeviceChangeListener(new WeakRef(this));
872
+ cleanupRegistry.register(this, cleanupController);
873
+ } else {
874
+ // Legacy browsers without WeakRef/FinalizationRegistry: fall back to a
875
+ // direct listener (matches pre-#1944 behavior).
876
+ onDeviceChange = this.handleDeviceChange;
877
+ }
878
+ // in order to catch device changes prior to room connection we need to register the event in the constructor
879
+ (_d = (_c = navigator.mediaDevices) === null || _c === void 0 ? void 0 : _c.addEventListener) === null || _d === void 0 ? void 0 : _d.call(_c, 'devicechange', onDeviceChange, {
880
+ signal: cleanupController.signal
881
+ });
882
+ }
883
+ }
884
+ /**
885
+ * Installs resolved extensions on this room. `installExtensions()` in `extensions.ts` resolves
886
+ * dependencies and calls this; `createRoom()` and the full `Room` go through it.
887
+ * @internal
888
+ */
889
+ installExtensions(extensions) {
890
+ var _a;
891
+ const ctx = {
892
+ log: this.log,
893
+ get: ext => {
894
+ const result = this.installedExtensions.get(ext.key);
895
+ if (!result) {
896
+ // @throws-transformer ignore - programmer error
897
+ throw new Error("extension '".concat(String(ext.key), "' is not installed"));
898
+ }
899
+ return result;
900
+ },
901
+ slot: slot => this.slots[slot],
902
+ getOrCreateParticipant: (identity, info) => this.getOrCreateParticipant(identity, info),
903
+ simulateConnected: (roomInfo, localParticipantInfo) => this.simulateConnected(roomInfo, localParticipantInfo),
904
+ acquireEmptyAudioStreamTrack: () => this.acquireEmptyAudioStreamTrack()
905
+ };
906
+ const results = [];
907
+ for (const ext of extensions) {
908
+ if (this.installedExtensions.has(ext.key)) {
909
+ // @throws-transformer ignore - programmer error
910
+ throw new Error("extension '".concat(String(ext.key), "' is already installed"));
911
+ }
912
+ const result = ext.install(this, ctx);
913
+ this.installedExtensions.set(ext.key, result);
914
+ results.push(result);
915
+ for (const _ref of Object.entries((_a = result.dataPackets) !== null && _a !== void 0 ? _a : {})) {
916
+ var _ref2 = _slicedToArray(_ref, 2);
917
+ const kind = _ref2[0];
918
+ const handler = _ref2[1];
919
+ if (this.dataPacketHandlers.has(kind)) {
920
+ // @throws-transformer ignore - programmer error
921
+ throw new Error("data packet case '".concat(kind, "' is already handled by another extension"));
922
+ }
923
+ this.dataPacketHandlers.set(kind, (packet, encryptionType, participant) => handler(packet.value.value, packet, encryptionType, participant));
924
+ }
925
+ for (const key of SLOT_KEYS) {
926
+ if (result[key] !== undefined) {
927
+ this.slots[key] = result[key];
928
+ }
929
+ }
930
+ defineExtensionApi(this, CoreRoom.prototype, result.room, ext);
931
+ defineExtensionApi(this.localParticipant, LocalParticipant.prototype, result.localParticipant, ext);
932
+ if (result.dispose) {
933
+ this.extensionDisposers.push(result.dispose);
934
+ }
935
+ }
936
+ this.applySlotsToEngine();
937
+ // every slot of the list is filled before the first hook runs
938
+ results.forEach(result => {
939
+ var _a;
940
+ return (_a = result.onEngineCreated) === null || _a === void 0 ? void 0 : _a.call(result, this.engine);
941
+ });
942
+ }
943
+ /** The engine keeps its own copy of the slots it reads on the hot path. */
944
+ applySlotsToEngine() {
945
+ this.engine.e2eeManager = this.slots.e2eeManager;
946
+ this.engine.frameMetadataOptions = this.slots.frameMetadataOptions;
947
+ }
948
+ get extensionResults() {
949
+ return Array.from(this.installedExtensions.values());
950
+ }
951
+ /**
952
+ * Releases everything the room holds: disconnects if connected, disposes the extensions and
953
+ * removes global listeners. The room cannot connect again afterwards.
954
+ */
955
+ dispose() {
956
+ return __awaiter(this, void 0, void 0, function* () {
957
+ var _a;
958
+ if (this.disposed) {
959
+ return;
960
+ }
961
+ this.disposed = true;
962
+ if (this.state !== ConnectionState.Disconnected) {
963
+ yield this.disconnect();
964
+ }
965
+ for (const dispose of this.extensionDisposers.reverse()) {
966
+ dispose();
967
+ }
968
+ (_a = this.cleanupController) === null || _a === void 0 ? void 0 : _a.abort();
969
+ });
970
+ }
971
+ get logContext() {
972
+ var _a, _b, _c;
973
+ return {
974
+ room: this.name,
975
+ roomID: (_a = this.roomInfo) === null || _a === void 0 ? void 0 : _a.sid,
976
+ participant: (_b = this.localParticipant) === null || _b === void 0 ? void 0 : _b.identity,
977
+ participantID: (_c = this.localParticipant) === null || _c === void 0 ? void 0 : _c.sid
978
+ };
979
+ }
980
+ /**
981
+ * if the current room has a participant with `recorder: true` in its JWT grant
982
+ **/
983
+ get isRecording() {
984
+ var _a, _b;
985
+ return (_b = (_a = this.roomInfo) === null || _a === void 0 ? void 0 : _a.activeRecording) !== null && _b !== void 0 ? _b : false;
986
+ }
987
+ /**
988
+ * server assigned unique room id.
989
+ * returns once a sid has been issued by the server.
990
+ */
991
+ getSid() {
992
+ if (this.state === ConnectionState.Disconnected) {
993
+ return TypedPromise.resolve('');
994
+ }
995
+ if (this.roomInfo && this.roomInfo.sid !== '') {
996
+ return TypedPromise.resolve(this.roomInfo.sid);
997
+ }
998
+ return new TypedPromise((resolve, reject) => {
999
+ const handleRoomUpdate = roomInfo => {
1000
+ if (roomInfo.sid !== '') {
1001
+ this.engine.off(EngineEvent.RoomUpdate, handleRoomUpdate);
1002
+ resolve(roomInfo.sid);
1003
+ }
1004
+ };
1005
+ this.engine.on(EngineEvent.RoomUpdate, handleRoomUpdate);
1006
+ this.once(RoomEvent.Disconnected, () => {
1007
+ this.engine.off(EngineEvent.RoomUpdate, handleRoomUpdate);
1008
+ reject(new UnexpectedConnectionState('Room disconnected before room server id was available'));
1009
+ });
1010
+ });
1011
+ }
1012
+ /** user assigned name, derived from JWT token */
1013
+ get name() {
1014
+ var _a, _b;
1015
+ return (_b = (_a = this.roomInfo) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : '';
1016
+ }
1017
+ /** room metadata */
1018
+ get metadata() {
1019
+ var _a;
1020
+ return (_a = this.roomInfo) === null || _a === void 0 ? void 0 : _a.metadata;
1021
+ }
1022
+ get numParticipants() {
1023
+ var _a, _b;
1024
+ return (_b = (_a = this.roomInfo) === null || _a === void 0 ? void 0 : _a.numParticipants) !== null && _b !== void 0 ? _b : 0;
1025
+ }
1026
+ get numPublishers() {
1027
+ var _a, _b;
1028
+ return (_b = (_a = this.roomInfo) === null || _a === void 0 ? void 0 : _a.numPublishers) !== null && _b !== void 0 ? _b : 0;
1029
+ }
1030
+ maybeCreateEngine() {
1031
+ if (this.engine && (this.engine.isNewlyCreated || !this.engine.isClosed)) {
1032
+ return;
1033
+ }
1034
+ this.engine = new RTCEngine(this.options);
1035
+ this.applySlotsToEngine();
1036
+ this.engine.on(EngineEvent.ParticipantUpdate, this.handleParticipantUpdates).on(EngineEvent.RoomUpdate, this.handleRoomUpdate).on(EngineEvent.SpeakersChanged, this.handleSpeakersChanged).on(EngineEvent.StreamStateChanged, this.handleStreamStateUpdate).on(EngineEvent.ConnectionQualityUpdate, this.handleConnectionQualityUpdate).on(EngineEvent.SubscriptionError, this.handleSubscriptionError).on(EngineEvent.SubscriptionPermissionUpdate, this.handleSubscriptionPermissionUpdate).on(EngineEvent.MediaTrackAdded, (mediaTrack, stream, receiver) => {
1037
+ this.onTrackAdded(mediaTrack, stream, receiver);
1038
+ }).on(EngineEvent.Disconnected, reason => {
1039
+ var _a;
1040
+ // the server can end the session while connect() still waits for the transports (e.g. a
1041
+ // DUPLICATE_IDENTITY leave). Cancel that attempt: left running, it times out, fails over to
1042
+ // another region and rejoins with the same token after the room reported Disconnected,
1043
+ // and disconnect() can't stop it since the room already looks disconnected
1044
+ (_a = this.abortController) === null || _a === void 0 ? void 0 : _a.abort('room disconnected by the server during connection attempt');
1045
+ this.handleDisconnect(this.options.stopLocalTrackOnUnpublish, reason);
1046
+ }).on(EngineEvent.ActiveSpeakersUpdate, this.handleActiveSpeakersUpdate).on(EngineEvent.DataPacketReceived, this.handleDataPacket).on(EngineEvent.Resuming, () => {
1047
+ this.clearConnectionReconcile();
1048
+ this.isResuming = true;
1049
+ this.log.debug('Resuming signal connection');
1050
+ // During connect(), the room stays `Connecting` and connect() reports the outcome.
1051
+ if (!this.connectFuture && this.setAndEmitConnectionState(ConnectionState.SignalReconnecting)) {
1052
+ this.emit(RoomEvent.SignalReconnecting);
1053
+ }
1054
+ }).on(EngineEvent.Resumed, () => {
1055
+ this.registerConnectionReconcile();
1056
+ this.isResuming = false;
1057
+ this.log.debug('Resumed signal connection');
1058
+ this.updateSubscriptions();
1059
+ if (this.connectFuture) {
1060
+ // connect() emits `Connected`; as on any initial join, events from before it are dropped.
1061
+ this.bufferedEvents = [];
1062
+ return;
1063
+ }
1064
+ if (this.setAndEmitConnectionState(ConnectionState.Connected)) {
1065
+ this.emit(RoomEvent.Reconnected);
1066
+ }
1067
+ this.emitBufferedEvents();
1068
+ }).on(EngineEvent.SignalResumed, () => {
1069
+ if (this.state === ConnectionState.Reconnecting || this.isResuming) {
1070
+ this.sendSyncState();
1071
+ }
1072
+ this.emitBufferedEvents();
1073
+ }).on(EngineEvent.Restarting, this.handleRestarting).on(EngineEvent.SignalRestarted, this.handleSignalRestarted).on(EngineEvent.Restarted, () => {
1074
+ // normally handleSignalRestarted flushes after the restart, but if the room already
1075
+ // reports connected, anything buffered since then would otherwise wait for the next reconnect
1076
+ if (this.state === ConnectionState.Connected) {
1077
+ this.emitBufferedEvents();
1078
+ }
1079
+ }).on(EngineEvent.Offline, () => {
1080
+ // During connect(), the room stays `Connecting` and connect() reports the outcome.
1081
+ if (!this.connectFuture && this.setAndEmitConnectionState(ConnectionState.Reconnecting)) {
1082
+ this.emit(RoomEvent.Reconnecting);
1083
+ }
1084
+ }).on(EngineEvent.DCBufferStatusChanged, (status, kind) => {
1085
+ this.emit(RoomEvent.DCBufferStatusChanged, status, kind);
1086
+ }).on(EngineEvent.LocalTrackSubscribed, subscribedSid => {
1087
+ this.handleLocalTrackSubscribed(subscribedSid);
1088
+ }).on(EngineEvent.RoomMoved, roomMoved => {
1089
+ this.log.debug('room moved', roomMoved);
1090
+ if (roomMoved.room) {
1091
+ this.handleRoomUpdate(roomMoved.room);
1092
+ }
1093
+ this.remoteParticipants.forEach((participant, identity) => {
1094
+ this.handleParticipantDisconnected(identity, participant);
1095
+ });
1096
+ this.emit(RoomEvent.Moved, roomMoved.room.name);
1097
+ if (roomMoved.participant) {
1098
+ this.handleParticipantUpdates([roomMoved.participant, ...roomMoved.otherParticipants]);
1099
+ } else {
1100
+ this.handleParticipantUpdates(roomMoved.otherParticipants);
1101
+ }
1102
+ }).on(EngineEvent.TokenRefreshed, token => {
1103
+ var _a;
1104
+ (_a = this.regionUrlProvider) === null || _a === void 0 ? void 0 : _a.updateToken(token);
1105
+ }).on(EngineEvent.ServerRegionsReported, regions => {
1106
+ var _a;
1107
+ (_a = this.regionUrlProvider) === null || _a === void 0 ? void 0 : _a.setServerReportedRegions({
1108
+ regionSettings: regions,
1109
+ updatedAtInMs: Date.now(),
1110
+ maxAgeInMs: DEFAULT_MAX_AGE_MS
1111
+ });
1112
+ }).on(EngineEvent.RequestSubscribedCodecRefresh, () => {
1113
+ for (const videoPub of this.localParticipant.videoTrackPublications.values()) {
1114
+ if (isLocalVideoTrack(videoPub.track)) {
1115
+ videoPub.track.refreshSubscribedCodecs();
1116
+ }
1117
+ }
1118
+ });
1119
+ if (this.localParticipant) {
1120
+ this.localParticipant.setupEngine(this.engine);
1121
+ }
1122
+ if (this.slots.e2eeManager) {
1123
+ this.slots.e2eeManager.setupEngine(this.engine);
1124
+ }
1125
+ this.extensionResults.forEach(result => {
1126
+ var _a;
1127
+ return (_a = result.onEngineCreated) === null || _a === void 0 ? void 0 : _a.call(result, this.engine);
1128
+ });
1129
+ }
1130
+ createRegionStrategy() {
1131
+ return {
1132
+ getNextUrl: signal => __awaiter(this, void 0, void 0, function* () {
1133
+ return this.regionUrlProvider ? this.regionUrlProvider.getNextBestRegionUrl(signal) : null;
1134
+ }),
1135
+ resetAttempts: () => {
1136
+ var _a;
1137
+ return (_a = this.regionUrlProvider) === null || _a === void 0 ? void 0 : _a.resetAttempts();
1138
+ }
1139
+ };
1140
+ }
1141
+ /**
1142
+ * getLocalDevices abstracts navigator.mediaDevices.enumerateDevices.
1143
+ * In particular, it requests device permissions by default if needed
1144
+ * and makes sure the returned device does not consist of dummy devices
1145
+ * @param kind
1146
+ * @returns a list of available local devices
1147
+ */
1148
+ static getLocalDevices(kind) {
1149
+ let requestPermissions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
1150
+ return DeviceManager.getInstance().getDevices(kind, requestPermissions);
1151
+ }
1152
+ /**
1153
+ * Builds the constructor's `devicechange` listener. It lives outside the constructor so that
1154
+ * its closure only captures `roomRef`, not the constructor's context (which holds the Room).
1155
+ */
1156
+ static createWeakDeviceChangeListener(roomRef) {
1157
+ return () => {
1158
+ var _a;
1159
+ (_a = roomRef.deref()) === null || _a === void 0 ? void 0 : _a.handleDeviceChange();
1160
+ };
1161
+ }
1162
+ /**
1163
+ * prepareConnection should be called as soon as the page is loaded, in order
1164
+ * to speed up the connection attempt. This function will
1165
+ * - perform DNS resolution and pre-warm the DNS cache
1166
+ * - establish TLS connection and cache TLS keys
1167
+ *
1168
+ * With LiveKit Cloud, it will also determine the best edge data center for
1169
+ * the current client to connect to if a token is provided.
1170
+ */
1171
+ prepareConnection(url, token) {
1172
+ return __awaiter(this, void 0, void 0, function* () {
1173
+ if (this.state !== ConnectionState.Disconnected) {
1174
+ return;
1175
+ }
1176
+ this.log.debug("prepareConnection to ".concat(url));
1177
+ try {
1178
+ if (isCloud(new URL(url)) && token) {
1179
+ this.regionUrlProvider = new RegionUrlProvider(url, token);
1180
+ const regionUrl = yield this.regionUrlProvider.getNextBestRegionUrl();
1181
+ // we will not replace the regionUrl if an attempt had already started
1182
+ // to avoid overriding regionUrl after a new connection attempt had started
1183
+ if (regionUrl && this.state === ConnectionState.Disconnected) {
1184
+ this.regionUrl = regionUrl;
1185
+ yield fetch(toHttpUrl(regionUrl), {
1186
+ method: 'HEAD'
1187
+ });
1188
+ this.log.debug("prepared connection to ".concat(regionUrl));
1189
+ }
1190
+ } else {
1191
+ yield fetch(toHttpUrl(url), {
1192
+ method: 'HEAD'
1193
+ });
1194
+ }
1195
+ } catch (e) {
1196
+ this.log.warn('could not prepare connection', {
1197
+ error: e
1198
+ });
1199
+ }
1200
+ });
1201
+ }
1202
+ /**
1203
+ * retrieves a participant by identity
1204
+ * @param identity
1205
+ * @returns
1206
+ */
1207
+ getParticipantByIdentity(identity) {
1208
+ if (this.localParticipant.identity === identity) {
1209
+ return this.localParticipant;
1210
+ }
1211
+ return this.remoteParticipants.get(identity);
1212
+ }
1213
+ clearConnectionFutures() {
1214
+ this.connectFuture = undefined;
1215
+ }
1216
+ /**
1217
+ * @internal for testing
1218
+ */
1219
+ simulateScenario(scenario, arg) {
1220
+ return __awaiter(this, void 0, void 0, function* () {
1221
+ let postAction = () => __awaiter(this, void 0, void 0, function* () {});
1222
+ let req;
1223
+ switch (scenario) {
1224
+ case 'signal-reconnect':
1225
+ const reconnectDelay = typeof arg === 'number' ? arg : 0;
1226
+ // @ts-expect-error function is private
1227
+ yield this.engine.client.handleOnClose('simulate disconnect', undefined, reconnectDelay);
1228
+ break;
1229
+ case 'fail-on-v1-path':
1230
+ this.engine.failNextV1Path();
1231
+ break;
1232
+ case 'speaker':
1233
+ req = new SimulateScenario({
1234
+ scenario: {
1235
+ case: 'speakerUpdate',
1236
+ value: 3
1237
+ }
1238
+ });
1239
+ break;
1240
+ case 'node-failure':
1241
+ req = new SimulateScenario({
1242
+ scenario: {
1243
+ case: 'nodeFailure',
1244
+ value: true
1245
+ }
1246
+ });
1247
+ break;
1248
+ case 'server-leave':
1249
+ req = new SimulateScenario({
1250
+ scenario: {
1251
+ case: 'serverLeave',
1252
+ value: true
1253
+ }
1254
+ });
1255
+ break;
1256
+ case 'migration':
1257
+ req = new SimulateScenario({
1258
+ scenario: {
1259
+ case: 'migration',
1260
+ value: true
1261
+ }
1262
+ });
1263
+ break;
1264
+ case 'resume-reconnect':
1265
+ this.engine.failNext();
1266
+ // @ts-expect-error function is private
1267
+ yield this.engine.client.handleOnClose('simulate resume-disconnect');
1268
+ break;
1269
+ case 'disconnect-signal-on-resume':
1270
+ postAction = () => __awaiter(this, void 0, void 0, function* () {
1271
+ // @ts-expect-error function is private
1272
+ yield this.engine.client.handleOnClose('simulate resume-disconnect');
1273
+ });
1274
+ req = new SimulateScenario({
1275
+ scenario: {
1276
+ case: 'disconnectSignalOnResume',
1277
+ value: true
1278
+ }
1279
+ });
1280
+ break;
1281
+ case 'disconnect-signal-on-resume-no-messages':
1282
+ postAction = () => __awaiter(this, void 0, void 0, function* () {
1283
+ // @ts-expect-error function is private
1284
+ yield this.engine.client.handleOnClose('simulate resume-disconnect');
1285
+ });
1286
+ req = new SimulateScenario({
1287
+ scenario: {
1288
+ case: 'disconnectSignalOnResumeNoMessages',
1289
+ value: true
1290
+ }
1291
+ });
1292
+ break;
1293
+ case 'full-reconnect':
1294
+ this.engine.fullReconnectOnNext = true;
1295
+ // @ts-expect-error function is private
1296
+ yield this.engine.client.handleOnClose('simulate full-reconnect');
1297
+ break;
1298
+ case 'force-tcp':
1299
+ case 'force-tls':
1300
+ req = new SimulateScenario({
1301
+ scenario: {
1302
+ case: 'switchCandidateProtocol',
1303
+ value: scenario === 'force-tls' ? 2 : 1
1304
+ }
1305
+ });
1306
+ postAction = () => __awaiter(this, void 0, void 0, function* () {
1307
+ const onLeave = this.engine.client.onLeave;
1308
+ if (onLeave) {
1309
+ onLeave(new LeaveRequest({
1310
+ reason: DisconnectReason.CLIENT_INITIATED,
1311
+ action: LeaveRequest_Action.RECONNECT
1312
+ }));
1313
+ }
1314
+ });
1315
+ break;
1316
+ case 'subscriber-bandwidth':
1317
+ if (arg === undefined || typeof arg !== 'number') {
1318
+ throw new Error('subscriber-bandwidth requires a number as argument');
1319
+ }
1320
+ req = new SimulateScenario({
1321
+ scenario: {
1322
+ case: 'subscriberBandwidth',
1323
+ value: numberToBigInt(arg)
1324
+ }
1325
+ });
1326
+ break;
1327
+ case 'leave-full-reconnect':
1328
+ req = new SimulateScenario({
1329
+ scenario: {
1330
+ case: 'leaveRequestFullReconnect',
1331
+ value: true
1332
+ }
1333
+ });
1334
+ }
1335
+ if (req) {
1336
+ yield this.engine.client.sendSimulateScenario(req);
1337
+ yield postAction();
1338
+ }
1339
+ });
1340
+ }
1341
+ /**
1342
+ * iOS blocks audio element playback if
1343
+ * - user is not publishing audio themselves and
1344
+ * - no other audio source is playing
1345
+ *
1346
+ * as a workaround, we create an audio element with an empty track, so that
1347
+ * silent audio is always playing
1348
+ *
1349
+ * The element is shared with any other room on the page and handed back on disconnect, so it
1350
+ * outlives whichever room happened to create it.
1351
+ */
1352
+ acquireDummyAudioElement() {
1353
+ if (!sharedDummyAudioElement) {
1354
+ sharedDummyAudioElement = createSharedDummyAudioElement();
1355
+ }
1356
+ const shared = sharedDummyAudioElement;
1357
+ if (this.releaseDummyAudioElement) {
1358
+ // this room already holds a reference, a second one would never be handed back
1359
+ return shared.element;
1360
+ }
1361
+ shared.refCount += 1;
1362
+ // the listener is per room rather than shared, so that the room it resumes playback for is
1363
+ // still connected, and so that it goes away with the room that installed it
1364
+ const handleVisibilityChange = () => {
1365
+ // set the srcObject to null on page hide in order to prevent lock screen controls to show up for it
1366
+ shared.element.srcObject = document.hidden ? null : shared.stream;
1367
+ if (!document.hidden) {
1368
+ this.log.debug('page visible again, triggering startAudio to resume playback and update playback status');
1369
+ this.startAudio().catch(error => this.log.warn('Could not restart audio on page becoming visible', Object.assign(Object.assign({}, this.logContext), {
1370
+ error
1371
+ })));
1372
+ }
1373
+ };
1374
+ document.addEventListener('visibilitychange', handleVisibilityChange);
1375
+ this.releaseDummyAudioElement = () => {
1376
+ this.releaseDummyAudioElement = undefined;
1377
+ document.removeEventListener('visibilitychange', handleVisibilityChange);
1378
+ shared.refCount -= 1;
1379
+ if (shared.refCount > 0) {
1380
+ return;
1381
+ }
1382
+ shared.element.srcObject = null;
1383
+ shared.element.remove();
1384
+ sharedDummyAudioElement = undefined;
1385
+ releaseEmptyAudioStreamTrack(shared.track).catch(error => this.log.warn('Could not release the dummy audio element track', Object.assign(Object.assign({}, this.logContext), {
1386
+ error
1387
+ })));
1388
+ };
1389
+ return shared.element;
1390
+ }
1391
+ /**
1392
+ * Obtains a silent audio track from the shared source and keeps track of it, so that it can be
1393
+ * handed back on disconnect and the shared `AudioContext` behind it can be closed again.
1394
+ */
1395
+ acquireEmptyAudioStreamTrack() {
1396
+ const track = getEmptyAudioStreamTrack();
1397
+ this.acquiredEmptyAudioTracks.add(track);
1398
+ return track;
1399
+ }
1400
+ releaseAcquiredEmptyAudioTrack(track) {
1401
+ if (!this.acquiredEmptyAudioTracks.delete(track)) {
1402
+ return;
1403
+ }
1404
+ releaseEmptyAudioStreamTrack(track).catch(error => this.log.warn('Could not release empty audio stream track', Object.assign(Object.assign({}, this.logContext), {
1405
+ error
1406
+ })));
1407
+ }
1408
+ releaseAcquiredEmptyAudioTracks() {
1409
+ for (const track of this.acquiredEmptyAudioTracks) {
1410
+ this.releaseAcquiredEmptyAudioTrack(track);
1411
+ }
1412
+ }
1413
+ /**
1414
+ * Returns true if audio playback is enabled
1415
+ */
1416
+ get canPlaybackAudio() {
1417
+ return this.audioEnabled;
1418
+ }
1419
+ /**
1420
+ * Returns true if video playback is enabled
1421
+ */
1422
+ get canPlaybackVideo() {
1423
+ return !this.isVideoPlaybackBlocked;
1424
+ }
1425
+ getActiveDevice(kind) {
1426
+ return this.localParticipant.activeDeviceMap.get(kind);
1427
+ }
1428
+ /**
1429
+ * Switches all active devices used in this room to the given device.
1430
+ *
1431
+ * Note: setting AudioOutput is not supported on some browsers. See [setSinkId](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/setSinkId#browser_compatibility)
1432
+ *
1433
+ * @param kind use `videoinput` for camera track,
1434
+ * `audioinput` for microphone track,
1435
+ * `audiooutput` to set speaker for all incoming audio tracks
1436
+ * @param deviceId
1437
+ */
1438
+ switchActiveDevice(kind_1, deviceId_1) {
1439
+ return __awaiter(this, arguments, void 0, function (kind, deviceId) {
1440
+ var _this3 = this;
1441
+ let exact = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
1442
+ return function* () {
1443
+ var _a, _b, _c, _d, _e, _f;
1444
+ var _g;
1445
+ let success = true;
1446
+ let shouldTriggerImmediateDeviceChange = false;
1447
+ const deviceConstraint = exact ? {
1448
+ exact: deviceId
1449
+ } : deviceId;
1450
+ if (kind === 'audioinput') {
1451
+ shouldTriggerImmediateDeviceChange = _this3.localParticipant.audioTrackPublications.size === 0;
1452
+ const prevDeviceId = (_a = _this3.getActiveDevice(kind)) !== null && _a !== void 0 ? _a : _this3.options.audioCaptureDefaults.deviceId;
1453
+ _this3.options.audioCaptureDefaults.deviceId = deviceConstraint;
1454
+ const tracks = Array.from(_this3.localParticipant.audioTrackPublications.values()).filter(track => track.source === Track.Source.Microphone);
1455
+ try {
1456
+ success = (yield Promise.all(tracks.map(t => {
1457
+ var _a;
1458
+ return (_a = t.audioTrack) === null || _a === void 0 ? void 0 : _a.setDeviceId(deviceConstraint);
1459
+ }))).every(val => val === true);
1460
+ } catch (e) {
1461
+ _this3.options.audioCaptureDefaults.deviceId = prevDeviceId;
1462
+ throw e;
1463
+ }
1464
+ const isMuted = tracks.some(t => {
1465
+ var _a, _b;
1466
+ return (_b = (_a = t.track) === null || _a === void 0 ? void 0 : _a.isMuted) !== null && _b !== void 0 ? _b : false;
1467
+ });
1468
+ if (success && isMuted) shouldTriggerImmediateDeviceChange = true;
1469
+ } else if (kind === 'videoinput') {
1470
+ shouldTriggerImmediateDeviceChange = _this3.localParticipant.videoTrackPublications.size === 0;
1471
+ const prevDeviceId = (_b = _this3.getActiveDevice(kind)) !== null && _b !== void 0 ? _b : _this3.options.videoCaptureDefaults.deviceId;
1472
+ _this3.options.videoCaptureDefaults.deviceId = deviceConstraint;
1473
+ const tracks = Array.from(_this3.localParticipant.videoTrackPublications.values()).filter(track => track.source === Track.Source.Camera);
1474
+ try {
1475
+ success = (yield Promise.all(tracks.map(t => {
1476
+ var _a;
1477
+ return (_a = t.videoTrack) === null || _a === void 0 ? void 0 : _a.setDeviceId(deviceConstraint);
1478
+ }))).every(val => val === true);
1479
+ } catch (e) {
1480
+ _this3.options.videoCaptureDefaults.deviceId = prevDeviceId;
1481
+ throw e;
1482
+ }
1483
+ const isMuted = tracks.some(t => {
1484
+ var _a, _b;
1485
+ return (_b = (_a = t.track) === null || _a === void 0 ? void 0 : _a.isMuted) !== null && _b !== void 0 ? _b : false;
1486
+ });
1487
+ if (success && isMuted) shouldTriggerImmediateDeviceChange = true;
1488
+ } else if (kind === 'audiooutput') {
1489
+ shouldTriggerImmediateDeviceChange = true;
1490
+ if (!supportsSetSinkId() && !_this3.options.webAudioMix || _this3.options.webAudioMix && _this3.audioContext && !('setSinkId' in _this3.audioContext)) {
1491
+ throw new Error('cannot switch audio output, the current browser does not support it');
1492
+ }
1493
+ if (_this3.options.webAudioMix) {
1494
+ // setting `default` for web audio output doesn't work, so we need to normalize the id before
1495
+ deviceId = (_c = yield DeviceManager.getInstance().normalizeDeviceId('audiooutput', deviceId)) !== null && _c !== void 0 ? _c : '';
1496
+ }
1497
+ (_d = (_g = _this3.options).audioOutput) !== null && _d !== void 0 ? _d : _g.audioOutput = {};
1498
+ const prevDeviceId = (_e = _this3.getActiveDevice(kind)) !== null && _e !== void 0 ? _e : _this3.options.audioOutput.deviceId;
1499
+ _this3.options.audioOutput.deviceId = deviceId;
1500
+ try {
1501
+ if (_this3.options.webAudioMix) {
1502
+ // @ts-expect-error setSinkId is not yet in the typescript type of AudioContext
1503
+ (_f = _this3.audioContext) === null || _f === void 0 ? void 0 : _f.setSinkId(deviceId);
1504
+ }
1505
+ // also set audio output on all audio elements, even if webAudioMix is enabled in order to workaround echo cancellation not working on chrome with non-default output devices
1506
+ // see https://issues.chromium.org/issues/40252911#comment7
1507
+ yield Promise.all(Array.from(_this3.remoteParticipants.values()).map(p => p.setAudioOutput({
1508
+ deviceId
1509
+ })));
1510
+ } catch (e) {
1511
+ _this3.options.audioOutput.deviceId = prevDeviceId;
1512
+ throw e;
1513
+ }
1514
+ }
1515
+ if (shouldTriggerImmediateDeviceChange) {
1516
+ _this3.localParticipant.activeDeviceMap.set(kind, deviceId);
1517
+ _this3.emit(RoomEvent.ActiveDeviceChanged, kind, deviceId);
1518
+ }
1519
+ return success;
1520
+ }();
1521
+ });
1522
+ }
1523
+ setupLocalParticipantEvents() {
1524
+ this.localParticipant.on(ParticipantEvent.ParticipantMetadataChanged, this.onLocalParticipantMetadataChanged).on(ParticipantEvent.ParticipantNameChanged, this.onLocalParticipantNameChanged).on(ParticipantEvent.AttributesChanged, this.onLocalAttributesChanged).on(ParticipantEvent.TrackMuted, this.onLocalTrackMuted).on(ParticipantEvent.TrackUnmuted, this.onLocalTrackUnmuted).on(ParticipantEvent.LocalTrackPublished, this.onLocalTrackPublished).on(ParticipantEvent.LocalTrackUnpublished, this.onLocalTrackUnpublished).on(ParticipantEvent.ConnectionQualityChanged, this.onLocalConnectionQualityChanged).on(ParticipantEvent.MediaDevicesError, this.onMediaDevicesError).on(ParticipantEvent.AudioStreamAcquired, this.startAudio).on(ParticipantEvent.ParticipantPermissionsChanged, this.onLocalParticipantPermissionsChanged);
1525
+ }
1526
+ recreateEngine(sendLeave) {
1527
+ let oldEngine = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.engine;
1528
+ if (sendLeave && oldEngine && !oldEngine.client.isDisconnected) {
1529
+ oldEngine.client.sendLeave().finally(() => oldEngine.close());
1530
+ } else {
1531
+ oldEngine === null || oldEngine === void 0 ? void 0 : oldEngine.close();
1532
+ }
1533
+ // the room already moved on to a newer engine (or none); leave that one alone
1534
+ if (oldEngine !== this.engine) {
1535
+ return;
1536
+ }
1537
+ /* @ts-ignore */
1538
+ this.engine = undefined;
1539
+ this.isResuming = false;
1540
+ // clear out existing remote participants, since they may have attached
1541
+ // the old engine
1542
+ this.remoteParticipants.clear();
1543
+ this.sidToIdentity.clear();
1544
+ this.bufferedEvents = [];
1545
+ this.maybeCreateEngine();
1546
+ }
1547
+ onTrackAdded(mediaTrack, stream, receiver) {
1548
+ var _a, _b;
1549
+ // don't fire onSubscribed when connecting
1550
+ // WebRTC fires onTrack as soon as setRemoteDescription is called on the offer
1551
+ // at that time, ICE connectivity has not been established so the track is not
1552
+ // technically subscribed.
1553
+ // We'll defer these events until when the room is connected or eventually disconnected.
1554
+ if ([ConnectionState.Connecting, ConnectionState.Reconnecting].includes(this.state)) {
1555
+ const pendingTrackSid = extractTrackSid(mediaTrack, stream);
1556
+ this.log.debug('deferring on track for later', {
1557
+ mediaTrackId: mediaTrack.id,
1558
+ mediaStreamId: stream.id,
1559
+ tracksInStream: stream.getTracks().map(track => track.id)
1560
+ });
1561
+ const reconnectedHandler = () => {
1562
+ cleanup();
1563
+ // the server can stop sending the track before the room connects, e.g. when the
1564
+ // subscription failed. The subscription error cannot always cancel the deferral: it can
1565
+ // arrive before the `track` event, and in single peer connection mode the deferral is
1566
+ // not keyed by the track sid, as only the answer's mid mapping carries it.
1567
+ // When the server stops sending, the browser removes the track from its stream,
1568
+ // the same signal that ends a track once it is subscribed
1569
+ if (!stream.getTracks().includes(mediaTrack)) {
1570
+ this.log.debug('skipping deferred track, the server no longer sends it', {
1571
+ mediaTrackId: mediaTrack.id,
1572
+ mediaStreamId: stream.id
1573
+ });
1574
+ return;
1575
+ }
1576
+ this.onTrackAdded(mediaTrack, stream, receiver);
1577
+ };
1578
+ const cleanup = () => {
1579
+ this.off(RoomEvent.Reconnected, reconnectedHandler);
1580
+ this.off(RoomEvent.Connected, reconnectedHandler);
1581
+ this.off(RoomEvent.Disconnected, cleanup);
1582
+ if (pendingTrackSid) {
1583
+ const pendingCallbacks = this.pendingTrackAddedCallbacks.get(pendingTrackSid);
1584
+ pendingCallbacks === null || pendingCallbacks === void 0 ? void 0 : pendingCallbacks.delete(cleanup);
1585
+ if ((pendingCallbacks === null || pendingCallbacks === void 0 ? void 0 : pendingCallbacks.size) === 0) {
1586
+ this.pendingTrackAddedCallbacks.delete(pendingTrackSid);
1587
+ }
1588
+ }
1589
+ };
1590
+ this.once(RoomEvent.Reconnected, reconnectedHandler);
1591
+ this.once(RoomEvent.Connected, reconnectedHandler);
1592
+ this.once(RoomEvent.Disconnected, cleanup);
1593
+ if (pendingTrackSid) {
1594
+ const pendingCallbacks = (_a = this.pendingTrackAddedCallbacks.get(pendingTrackSid)) !== null && _a !== void 0 ? _a : new Set();
1595
+ pendingCallbacks.add(cleanup);
1596
+ this.pendingTrackAddedCallbacks.set(pendingTrackSid, pendingCallbacks);
1597
+ }
1598
+ return;
1599
+ }
1600
+ if (this.state === ConnectionState.Disconnected) {
1601
+ this.log.warn('skipping incoming track after Room disconnected');
1602
+ return;
1603
+ }
1604
+ if (mediaTrack.readyState === 'ended') {
1605
+ this.log.debug('skipping incoming track as it already ended');
1606
+ return;
1607
+ }
1608
+ const parts = unpackStreamId(stream.id);
1609
+ const participantSid = parts[0];
1610
+ const streamId = parts[1];
1611
+ // firefox will get streamId (pID|trackId) instead of (pID|streamId) as it doesn't support sync tracks by stream
1612
+ // and generates its own track id instead of infer from sdp track id.
1613
+ let trackId = (_b = extractTrackSid(mediaTrack, stream)) !== null && _b !== void 0 ? _b : mediaTrack.id;
1614
+ if (participantSid === this.localParticipant.sid) {
1615
+ this.log.warn('tried to create RemoteParticipant for local participant');
1616
+ return;
1617
+ }
1618
+ const participant = Array.from(this.remoteParticipants.values()).find(p => p.sid === participantSid);
1619
+ if (!participant) {
1620
+ // server could require extra media sections to accelerate subscription.
1621
+ if (participantSid.startsWith('PA')) {
1622
+ this.log.error("Tried to add a track for a participant, that's not present. Sid: ".concat(participantSid));
1623
+ }
1624
+ return;
1625
+ }
1626
+ // in single peer connection case, the trackID is locally generated,
1627
+ // not the TR_ prefixed one generated by the server,
1628
+ // use `mid` to find the appropriate track.
1629
+ if (!trackId.startsWith('TR')) {
1630
+ const id = this.engine.getTrackIdForReceiver(receiver);
1631
+ if (!id) {
1632
+ this.log.error("Tried to add a track whose 'sid' could not be found for a participant, that's not present. Sid: ".concat(participantSid));
1633
+ return;
1634
+ }
1635
+ trackId = id;
1636
+ }
1637
+ if (!trackId.startsWith('TR')) {
1638
+ this.log.warn("Tried to add a track whose 'sid' could not be determined for a participant, that's not present. Sid: ".concat(participantSid, ", streamId: ").concat(streamId, ", trackId: ").concat(trackId), {
1639
+ remoteParticipantID: participantSid,
1640
+ streamId,
1641
+ trackId
1642
+ });
1643
+ }
1644
+ let adaptiveStreamSettings;
1645
+ if (this.options.adaptiveStream) {
1646
+ if (typeof this.options.adaptiveStream === 'object') {
1647
+ adaptiveStreamSettings = this.options.adaptiveStream;
1648
+ } else {
1649
+ adaptiveStreamSettings = {};
1650
+ }
1651
+ }
1652
+ const publication = participant.addSubscribedMediaTrack(mediaTrack, trackId, stream, receiver, adaptiveStreamSettings);
1653
+ if ((publication === null || publication === void 0 ? void 0 : publication.isEncrypted) && !this.slots.e2eeManager) {
1654
+ this.emit(RoomEvent.EncryptionError, new Error("Encrypted ".concat(publication.source, " track received from participant ").concat(participant.sid, ", but room does not have encryption enabled!")));
1655
+ }
1656
+ }
1657
+ cancelPendingTrackAdded(trackSid) {
1658
+ var _a;
1659
+ (_a = this.pendingTrackAddedCallbacks.get(trackSid)) === null || _a === void 0 ? void 0 : _a.forEach(cleanup => cleanup());
1660
+ }
1661
+ handleLocalTrackSubscribed(subscribedSid) {
1662
+ const findPublication = () => this.localParticipant.getTrackPublications().find(_ref3 => {
1663
+ let trackSid = _ref3.trackSid;
1664
+ return trackSid === subscribedSid;
1665
+ });
1666
+ const trackPublication = findPublication();
1667
+ if (trackPublication) {
1668
+ this.emitLocalTrackSubscribed(trackPublication);
1669
+ return;
1670
+ }
1671
+ // the track publication may not be registered yet if the server signals
1672
+ // the subscription before publishTrack has finished adding the publication.
1673
+ // defer with a timeout until LocalTrackPublished fires for the matching trackSid
1674
+ this.log.debug('deferring LocalTrackSubscribed, publication not yet available', {
1675
+ subscribedSid
1676
+ });
1677
+ const TIMEOUT_MS = 10000;
1678
+ let timer;
1679
+ const onPublished = pub => {
1680
+ if (pub.trackSid === subscribedSid) {
1681
+ cleanup();
1682
+ this.emitLocalTrackSubscribed(pub);
1683
+ }
1684
+ };
1685
+ const cleanup = () => {
1686
+ clearTimeout(timer);
1687
+ this.localParticipant.off(ParticipantEvent.LocalTrackPublished, onPublished);
1688
+ this.off(RoomEvent.Disconnected, cleanup);
1689
+ };
1690
+ this.localParticipant.on(ParticipantEvent.LocalTrackPublished, onPublished);
1691
+ this.once(RoomEvent.Disconnected, cleanup);
1692
+ timer = setTimeout(() => {
1693
+ cleanup();
1694
+ // final attempt in case the publication was added without emitting the event
1695
+ const pub = findPublication();
1696
+ if (pub) {
1697
+ this.emitLocalTrackSubscribed(pub);
1698
+ } else {
1699
+ this.log.warn('could not find local track publication for LocalTrackSubscribed event after timeout', {
1700
+ subscribedSid
1701
+ });
1702
+ }
1703
+ }, TIMEOUT_MS);
1704
+ }
1705
+ emitLocalTrackSubscribed(trackPublication) {
1706
+ this.localParticipant.emit(ParticipantEvent.LocalTrackSubscribed, trackPublication);
1707
+ this.emitWhenConnected(RoomEvent.LocalTrackSubscribed, trackPublication, this.localParticipant);
1708
+ }
1709
+ handleDisconnect() {
1710
+ let shouldStopTracks = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
1711
+ let reason = arguments.length > 1 ? arguments[1] : undefined;
1712
+ var _a, _b, _c;
1713
+ this.clearConnectionReconcile();
1714
+ this.isResuming = false;
1715
+ this.bufferedEvents = [];
1716
+ this.roomInfoBeforeRestart = undefined;
1717
+ this.transcriptionReceivedTimes.clear();
1718
+ this.extensionResults.forEach(result => {
1719
+ var _a;
1720
+ return (_a = result.onDisconnect) === null || _a === void 0 ? void 0 : _a.call(result);
1721
+ });
1722
+ if (this.state === ConnectionState.Disconnected) {
1723
+ return;
1724
+ }
1725
+ this.regionUrl = undefined;
1726
+ // Notify region provider about disconnect to potentially stop auto-refetch
1727
+ if (this.regionUrlProvider) {
1728
+ this.regionUrlProvider.notifyDisconnected();
1729
+ }
1730
+ try {
1731
+ // audio tracks that outlive this room are about to become unreachable through the local
1732
+ // participant, collect them while we can so they can be detached from the context below
1733
+ const retainedAudioTracks = shouldStopTracks ? [] : Array.from(this.localParticipant.audioTrackPublications.values()).map(pub => pub.track).filter(isLocalAudioTrack);
1734
+ this.remoteParticipants.forEach(p => {
1735
+ p.trackPublications.forEach(pub => {
1736
+ p.unpublishTrack(pub.trackSid);
1737
+ });
1738
+ });
1739
+ this.localParticipant.trackPublications.forEach(pub => {
1740
+ var _a, _b, _c;
1741
+ if (pub.track) {
1742
+ this.localParticipant.unpublishTrack(pub.track, shouldStopTracks);
1743
+ }
1744
+ if (shouldStopTracks) {
1745
+ (_a = pub.track) === null || _a === void 0 ? void 0 : _a.detach();
1746
+ (_b = pub.track) === null || _b === void 0 ? void 0 : _b.stop();
1747
+ } else {
1748
+ (_c = pub.track) === null || _c === void 0 ? void 0 : _c.stopMonitor();
1749
+ }
1750
+ });
1751
+ this.localParticipant.off(ParticipantEvent.ParticipantMetadataChanged, this.onLocalParticipantMetadataChanged).off(ParticipantEvent.ParticipantNameChanged, this.onLocalParticipantNameChanged).off(ParticipantEvent.AttributesChanged, this.onLocalAttributesChanged).off(ParticipantEvent.TrackMuted, this.onLocalTrackMuted).off(ParticipantEvent.TrackUnmuted, this.onLocalTrackUnmuted).off(ParticipantEvent.LocalTrackPublished, this.onLocalTrackPublished).off(ParticipantEvent.LocalTrackUnpublished, this.onLocalTrackUnpublished).off(ParticipantEvent.ConnectionQualityChanged, this.onLocalConnectionQualityChanged).off(ParticipantEvent.MediaDevicesError, this.onMediaDevicesError).off(ParticipantEvent.AudioStreamAcquired, this.startAudio).off(ParticipantEvent.ParticipantPermissionsChanged, this.onLocalParticipantPermissionsChanged);
1752
+ this.localParticipant.trackPublications.clear();
1753
+ this.localParticipant.videoTrackPublications.clear();
1754
+ this.localParticipant.audioTrackPublications.clear();
1755
+ this.remoteParticipants.clear();
1756
+ this.sidToIdentity.clear();
1757
+ this.activeSpeakers = [];
1758
+ (_a = this.releaseDummyAudioElement) === null || _a === void 0 ? void 0 : _a.call(this);
1759
+ this.releaseAcquiredEmptyAudioTracks();
1760
+ // teardown is asynchronous (processors need to release their web audio nodes), but
1761
+ // `handleDisconnect` is not, so let it finish in the background
1762
+ this.releaseAudioContext(retainedAudioTracks).catch(error => this.log.warn('Could not release audio context', Object.assign(Object.assign({}, this.logContext), {
1763
+ error
1764
+ })));
1765
+ if (isWeb()) {
1766
+ window.removeEventListener('beforeunload', this.onPageLeave);
1767
+ window.removeEventListener('pagehide', this.onPageLeave);
1768
+ window.removeEventListener('freeze', this.onPageLeave);
1769
+ (_c = (_b = navigator.mediaDevices) === null || _b === void 0 ? void 0 : _b.removeEventListener) === null || _c === void 0 ? void 0 : _c.call(_b, 'devicechange', this.handleDeviceChange);
1770
+ }
1771
+ } finally {
1772
+ this.setAndEmitConnectionState(ConnectionState.Disconnected);
1773
+ this.emit(RoomEvent.Disconnected, reason);
1774
+ }
1775
+ }
1776
+ handleParticipantDisconnected(identity, participant, disconnectReason) {
1777
+ // remove and send event
1778
+ this.remoteParticipants.delete(identity);
1779
+ if (!participant) {
1780
+ return;
1781
+ }
1782
+ participant.trackPublications.forEach(publication => {
1783
+ participant.unpublishTrack(publication.trackSid, true);
1784
+ });
1785
+ this.emit(RoomEvent.ParticipantDisconnected, participant, disconnectReason);
1786
+ participant.setDisconnected();
1787
+ }
1788
+ /**
1789
+ * attempt to select the default devices if the previously selected devices are no longer available after a device change event
1790
+ */
1791
+ selectDefaultDevices() {
1792
+ return __awaiter(this, void 0, void 0, function* () {
1793
+ var _a, _b, _c;
1794
+ const previousDevices = DeviceManager.getInstance().previousDevices;
1795
+ // check for available devices, but don't request permissions in order to avoid prompts for kinds that haven't been used before
1796
+ const availableDevices = yield DeviceManager.getInstance().getDevices(undefined, false);
1797
+ const browser = getBrowser();
1798
+ if ((browser === null || browser === void 0 ? void 0 : browser.name) === 'Chrome' && browser.os !== 'iOS') {
1799
+ for (let availableDevice of availableDevices) {
1800
+ const previousDevice = previousDevices.find(info => info.deviceId === availableDevice.deviceId);
1801
+ if (previousDevice && previousDevice.label !== '' && previousDevice.kind === availableDevice.kind && previousDevice.label !== availableDevice.label) {
1802
+ // label has changed on device the same deviceId, indicating that the default device has changed on the OS level
1803
+ if (this.getActiveDevice(availableDevice.kind) === 'default') {
1804
+ // emit an active device change event only if the selected output device is actually on `default`
1805
+ this.emit(RoomEvent.ActiveDeviceChanged, availableDevice.kind, availableDevice.deviceId);
1806
+ }
1807
+ }
1808
+ }
1809
+ }
1810
+ const kinds = ['audiooutput', 'audioinput', 'videoinput'];
1811
+ for (let kind of kinds) {
1812
+ const targetSource = kindToSource(kind);
1813
+ const targetPublication = this.localParticipant.getTrackPublication(targetSource);
1814
+ if (targetPublication && ((_a = targetPublication.track) === null || _a === void 0 ? void 0 : _a.isUserProvided)) {
1815
+ // if the track is user provided, we don't want to switch devices on behalf of the user
1816
+ continue;
1817
+ }
1818
+ const devicesOfKind = availableDevices.filter(d => d.kind === kind);
1819
+ const activeDevice = this.getActiveDevice(kind);
1820
+ if (activeDevice === ((_b = previousDevices.filter(info => info.kind === kind)[0]) === null || _b === void 0 ? void 0 : _b.deviceId)) {
1821
+ // in Safari the first device is always the default, so we assume a user on the default device would like to switch to the default once it changes
1822
+ // FF doesn't emit an event when the default device changes, so we perform the same best effort and switch to the new device once connected and if it's the first in the array
1823
+ if (devicesOfKind.length > 0 && ((_c = devicesOfKind[0]) === null || _c === void 0 ? void 0 : _c.deviceId) !== activeDevice) {
1824
+ yield this.switchActiveDevice(kind, devicesOfKind[0].deviceId);
1825
+ continue;
1826
+ }
1827
+ }
1828
+ if (kind === 'audioinput' && !isSafariBased() || kind === 'videoinput') {
1829
+ // airpods on Safari need special handling for audioinput as the track doesn't end as soon as you take them out
1830
+ continue;
1831
+ }
1832
+ // switch to first available device if previously active device is not available any more
1833
+ if (devicesOfKind.length > 0 && !devicesOfKind.find(deviceInfo => deviceInfo.deviceId === this.getActiveDevice(kind)) && (
1834
+ // avoid switching audio output on safari without explicit user action as it leads to slowed down audio playback
1835
+ kind !== 'audiooutput' || !isSafariBased())) {
1836
+ yield this.switchActiveDevice(kind, devicesOfKind[0].deviceId);
1837
+ }
1838
+ }
1839
+ });
1840
+ }
1841
+ /**
1842
+ * @param forConnect whether this acquisition belongs to a connect, which is the only caller
1843
+ * allowed to put a released room back on an audio context.
1844
+ */
1845
+ acquireAudioContext() {
1846
+ return __awaiter(this, arguments, void 0, function () {
1847
+ var _this4 = this;
1848
+ let forConnect = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
1849
+ return function* () {
1850
+ var _a, _b;
1851
+ const unlock = yield _this4.audioContextMutex.lock();
1852
+ try {
1853
+ if (_this4.audioContextReleased && !forConnect) {
1854
+ // a disconnect set the flag and took the lock while this call was queued behind it.
1855
+ // Creating a context now would leave one open on a room nothing tears down again
1856
+ return;
1857
+ }
1858
+ _this4.audioContextReleased = false;
1859
+ const providedAudioContext = typeof _this4.options.webAudioMix !== 'boolean' ? _this4.options.webAudioMix.audioContext : undefined;
1860
+ if (providedAudioContext) {
1861
+ // override audio context with custom audio context if supplied by user
1862
+ yield _this4.setRoomAudioContext(providedAudioContext, false);
1863
+ } else if (!_this4.audioContext || _this4.audioContext.state === 'closed') {
1864
+ // by using an AudioContext, it reduces lag on audio elements
1865
+ // https://stackoverflow.com/questions/9811429/html5-audio-tag-on-safari-has-a-delay/54119854#54119854
1866
+ yield _this4.setRoomAudioContext((_a = getNewAudioContext()) !== null && _a !== void 0 ? _a : undefined, true);
1867
+ }
1868
+ if (_this4.audioContext && _this4.audioContext.state === 'suspended') {
1869
+ // for iOS a newly created AudioContext is always in `suspended` state.
1870
+ // we try our best to resume the context here, if that doesn't work, we just continue with regular processing
1871
+ try {
1872
+ yield Promise.race([_this4.audioContext.resume(), sleep(200)]);
1873
+ } catch (e) {
1874
+ _this4.log.warn('Could not resume audio context', {
1875
+ error: e
1876
+ });
1877
+ }
1878
+ }
1879
+ const newContextIsRunning = ((_b = _this4.audioContext) === null || _b === void 0 ? void 0 : _b.state) === 'running';
1880
+ if (newContextIsRunning !== _this4.canPlaybackAudio) {
1881
+ _this4.audioEnabled = newContextIsRunning;
1882
+ _this4.emit(RoomEvent.AudioPlaybackStatusChanged, newContextIsRunning);
1883
+ }
1884
+ } finally {
1885
+ unlock();
1886
+ }
1887
+ }();
1888
+ });
1889
+ }
1890
+ /**
1891
+ * Points the room and its participants at `audioContext`, rebuilding the web audio graph of
1892
+ * every audio track in it. Closes the previous context if the SDK `owned` it.
1893
+ */
1894
+ setRoomAudioContext(audioContext, owned) {
1895
+ return __awaiter(this, void 0, void 0, function* () {
1896
+ const ownsAudioContext = !!audioContext && owned;
1897
+ if (this.audioContext === audioContext) {
1898
+ this.ownsAudioContext = ownsAudioContext;
1899
+ return;
1900
+ }
1901
+ const contextToClose = this.ownsAudioContext ? this.audioContext : undefined;
1902
+ this.audioContext = audioContext;
1903
+ this.ownsAudioContext = ownsAudioContext;
1904
+ try {
1905
+ // every audio track rebuilds its nodes in the new context, which has to happen before the
1906
+ // previous one is closed so that processors can move off it while it is still alive
1907
+ if (this.options.webAudioMix) {
1908
+ yield Promise.all(Array.from(this.remoteParticipants.values()).map(participant => participant.setAudioContext(audioContext)));
1909
+ }
1910
+ yield this.localParticipant.setAudioContext(audioContext);
1911
+ } catch (error) {
1912
+ // the context is being abandoned either way, so a track that failed to move off it must
1913
+ // not stop us closing it — that would leak the context this whole path exists to release
1914
+ this.log.warn('Could not move audio tracks to the new audio context', Object.assign(Object.assign({}, this.logContext), {
1915
+ error
1916
+ }));
1917
+ } finally {
1918
+ if (contextToClose && contextToClose.state !== 'closed') {
1919
+ try {
1920
+ yield contextToClose.close();
1921
+ } catch (error) {
1922
+ this.log.warn('Could not close audio context', Object.assign(Object.assign({}, this.logContext), {
1923
+ error
1924
+ }));
1925
+ }
1926
+ }
1927
+ }
1928
+ });
1929
+ }
1930
+ /**
1931
+ * Detaches the web audio graph the SDK built from the current audio context and closes that
1932
+ * context if the SDK created it. A context provided through `webAudioMix` is left untouched.
1933
+ */
1934
+ releaseAudioContext() {
1935
+ return __awaiter(this, arguments, void 0, function () {
1936
+ var _this5 = this;
1937
+ let retainedAudioTracks = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
1938
+ return function* () {
1939
+ // both reads happen before the first await, so they describe the room as it was when the
1940
+ // disconnect started rather than after a reconnect has had a chance to run
1941
+ _this5.audioContextReleased = true;
1942
+ const contextToRelease = _this5.audioContext;
1943
+ const unlock = yield _this5.audioContextMutex.lock();
1944
+ try {
1945
+ if (!_this5.audioContextReleased || _this5.audioContext !== contextToRelease) {
1946
+ // a reconnect acquired a new context while we were waiting, closing it would leave the
1947
+ // reconnected room without one
1948
+ return;
1949
+ }
1950
+ if (!_this5.ownsAudioContext) {
1951
+ // a provided context stays open, so tracks that outlive the room stay functional on it.
1952
+ // The tracks this room detached have released their nodes during track teardown already.
1953
+ // read under the lock: an acquire queued behind an in-flight release flips this flag
1954
+ return;
1955
+ }
1956
+ try {
1957
+ // tracks that outlive the room aren't reachable through the local participant anymore,
1958
+ // but still hold web audio nodes in the context we're about to close
1959
+ yield Promise.all(retainedAudioTracks.map(track => track.setAudioContext(undefined)));
1960
+ } catch (error) {
1961
+ _this5.log.warn('Could not detach retained audio tracks from the audio context', Object.assign(Object.assign({}, _this5.logContext), {
1962
+ error
1963
+ }));
1964
+ }
1965
+ // the participant maps have already been cleared by `handleDisconnect`, so this reaches no
1966
+ // tracks of its own — `retainedAudioTracks` above is what detaches them
1967
+ yield _this5.setRoomAudioContext(undefined, false);
1968
+ } finally {
1969
+ unlock();
1970
+ }
1971
+ }();
1972
+ });
1973
+ }
1974
+ createParticipant(identity, info) {
1975
+ var _a;
1976
+ let participant;
1977
+ if (info) {
1978
+ participant = RemoteParticipant.fromParticipantInfo(this.engine.client, info, {
1979
+ loggerContextCb: () => this.logContext,
1980
+ loggerName: this.options.loggerName
1981
+ });
1982
+ this.extensionResults.forEach(result => {
1983
+ var _a;
1984
+ return (_a = result.onParticipantCreated) === null || _a === void 0 ? void 0 : _a.call(result, participant, info);
1985
+ });
1986
+ } else {
1987
+ participant = new RemoteParticipant(this.engine.client, '', identity, undefined, undefined, undefined, {
1988
+ loggerContextCb: () => this.logContext,
1989
+ loggerName: this.options.loggerName
1990
+ });
1991
+ }
1992
+ if (this.options.webAudioMix) {
1993
+ participant.setAudioContext(this.audioContext).catch(error => this.log.warn('Could not set audio context', Object.assign(Object.assign({}, this.logContext), {
1994
+ error
1995
+ })));
1996
+ }
1997
+ if ((_a = this.options.audioOutput) === null || _a === void 0 ? void 0 : _a.deviceId) {
1998
+ participant.setAudioOutput(this.options.audioOutput).catch(e => this.log.warn("Could not set audio output: ".concat(e.message)));
1999
+ }
2000
+ return participant;
2001
+ }
2002
+ getOrCreateParticipant(identity, info) {
2003
+ if (this.remoteParticipants.has(identity)) {
2004
+ const existingParticipant = this.remoteParticipants.get(identity);
2005
+ if (info) {
2006
+ const wasUpdated = existingParticipant.updateInfo(info);
2007
+ if (wasUpdated) {
2008
+ this.sidToIdentity.set(info.sid, info.identity);
2009
+ }
2010
+ }
2011
+ return existingParticipant;
2012
+ }
2013
+ const participant = this.createParticipant(identity, info);
2014
+ this.remoteParticipants.set(identity, participant);
2015
+ this.sidToIdentity.set(info.sid, info.identity);
2016
+ // if we have valid info and the participant wasn't in the map before, we can assume the participant is new
2017
+ // firing here to make sure that `ParticipantConnected` fires before the initial track events
2018
+ this.emitWhenConnected(RoomEvent.ParticipantConnected, participant);
2019
+ // also forward events
2020
+ // trackPublished is only fired for tracks added after both local participant
2021
+ // and remote participant joined the room
2022
+ participant.on(ParticipantEvent.TrackPublished, trackPublication => {
2023
+ this.emitWhenConnected(RoomEvent.TrackPublished, trackPublication, participant);
2024
+ }).on(ParticipantEvent.TrackSubscribed, (track, publication) => {
2025
+ // monitor playback status
2026
+ if (track.kind === Track.Kind.Audio) {
2027
+ track.on(TrackEvent.AudioPlaybackStarted, this.handleAudioPlaybackStarted);
2028
+ track.on(TrackEvent.AudioPlaybackFailed, this.handleAudioPlaybackFailed);
2029
+ } else if (track.kind === Track.Kind.Video) {
2030
+ track.on(TrackEvent.VideoPlaybackFailed, this.handleVideoPlaybackFailed);
2031
+ track.on(TrackEvent.VideoPlaybackStarted, this.handleVideoPlaybackStarted);
2032
+ }
2033
+ this.emitWhenConnected(RoomEvent.TrackSubscribed, track, publication, participant);
2034
+ }).on(ParticipantEvent.TrackUnpublished, publication => {
2035
+ this.cancelPendingTrackAdded(publication.trackSid);
2036
+ this.emit(RoomEvent.TrackUnpublished, publication, participant);
2037
+ }).on(ParticipantEvent.TrackUnsubscribed, (track, publication) => {
2038
+ this.emit(RoomEvent.TrackUnsubscribed, track, publication, participant);
2039
+ }).on(ParticipantEvent.TrackMuted, pub => {
2040
+ this.emitWhenConnected(RoomEvent.TrackMuted, pub, participant);
2041
+ }).on(ParticipantEvent.TrackUnmuted, pub => {
2042
+ this.emitWhenConnected(RoomEvent.TrackUnmuted, pub, participant);
2043
+ }).on(ParticipantEvent.ParticipantMetadataChanged, metadata => {
2044
+ this.emitWhenConnected(RoomEvent.ParticipantMetadataChanged, metadata, participant);
2045
+ }).on(ParticipantEvent.ParticipantNameChanged, name => {
2046
+ this.emitWhenConnected(RoomEvent.ParticipantNameChanged, name, participant);
2047
+ }).on(ParticipantEvent.AttributesChanged, changedAttributes => {
2048
+ this.emitWhenConnected(RoomEvent.ParticipantAttributesChanged, changedAttributes, participant);
2049
+ }).on(ParticipantEvent.ConnectionQualityChanged, quality => {
2050
+ this.emitWhenConnected(RoomEvent.ConnectionQualityChanged, quality, participant);
2051
+ }).on(ParticipantEvent.ParticipantPermissionsChanged, prevPermissions => {
2052
+ this.emitWhenConnected(RoomEvent.ParticipantPermissionsChanged, prevPermissions, participant);
2053
+ }).on(ParticipantEvent.TrackSubscriptionStatusChanged, (pub, status) => {
2054
+ this.emitWhenConnected(RoomEvent.TrackSubscriptionStatusChanged, pub, status, participant);
2055
+ }).on(ParticipantEvent.TrackSubscriptionFailed, (trackSid, error) => {
2056
+ this.emit(RoomEvent.TrackSubscriptionFailed, trackSid, participant, error);
2057
+ }).on(ParticipantEvent.TrackSubscriptionPermissionChanged, (pub, status) => {
2058
+ this.emitWhenConnected(RoomEvent.TrackSubscriptionPermissionChanged, pub, status, participant);
2059
+ }).on(ParticipantEvent.Active, () => {
2060
+ this.emitWhenConnected(RoomEvent.ParticipantActive, participant);
2061
+ if (participant.kind === ParticipantInfo_Kind.AGENT) {
2062
+ this.localParticipant.setActiveAgent(participant);
2063
+ }
2064
+ });
2065
+ // update info at the end after callbacks have been set up
2066
+ if (info) {
2067
+ participant.updateInfo(info);
2068
+ }
2069
+ return participant;
2070
+ }
2071
+ sendSyncState() {
2072
+ const remoteTracks = Array.from(this.remoteParticipants.values()).reduce((acc, participant) => {
2073
+ acc.push(...participant.getTrackPublications()); // FIXME would be nice to have this return RemoteTrackPublications directly instead of the type cast
2074
+ return acc;
2075
+ }, []);
2076
+ const localTracks = this.localParticipant.getTrackPublications(); // FIXME would be nice to have this return LocalTrackPublications directly instead of the type cast
2077
+ const publishDataTracks = [].concat(...this.extensionResults.map(result => {
2078
+ var _a, _b;
2079
+ return (_b = (_a = result.syncState) === null || _a === void 0 ? void 0 : _a.call(result)) !== null && _b !== void 0 ? _b : [];
2080
+ }));
2081
+ this.engine.sendSyncState(remoteTracks, localTracks, publishDataTracks);
2082
+ }
2083
+ /**
2084
+ * After resuming, we'll need to notify the server of the current
2085
+ * subscription settings.
2086
+ */
2087
+ updateSubscriptions() {
2088
+ for (const p of this.remoteParticipants.values()) {
2089
+ for (const pub of p.videoTrackPublications.values()) {
2090
+ if (pub.isSubscribed && isRemotePub(pub)) {
2091
+ pub.emitTrackUpdate();
2092
+ }
2093
+ }
2094
+ }
2095
+ }
2096
+ getRemoteParticipantBySid(sid) {
2097
+ const identity = this.sidToIdentity.get(sid);
2098
+ if (identity) {
2099
+ const participant = this.remoteParticipants.get(identity);
2100
+ // an older session's sid must not resolve to the current session of the same identity
2101
+ if ((participant === null || participant === void 0 ? void 0 : participant.sid) === sid) {
2102
+ return participant;
2103
+ }
2104
+ }
2105
+ }
2106
+ /** The client capabilities this SDK advertises to other participants in its `ClientInfo`. */
2107
+ getClientInfoCapabilities() {
2108
+ const capabilities = [];
2109
+ if (isFrameMetadataSupported(this.slots.frameMetadataOptions) || !!this.slots.e2eeManager) {
2110
+ capabilities.push(ClientInfo_Capability.CAP_PACKET_TRAILER);
2111
+ }
2112
+ // Advertise deflate-raw decompression support so peers know they can send us compressed data
2113
+ // streams (gated separately from clientProtocol — see the data streams v2 spec).
2114
+ if (isDeflateRawCompressionSupported()) {
2115
+ capabilities.push(ClientInfo_Capability.CAP_COMPRESSION_DEFLATE_RAW);
2116
+ }
2117
+ return capabilities;
2118
+ }
2119
+ setStatsLogging(enabled) {
2120
+ if (enabled) {
2121
+ if (!this.statsLogInterval) {
2122
+ this.statsLogInterval = CriticalTimers.setInterval(() => {
2123
+ // logWebRTCStats handles its own errors, nothing to await here
2124
+ this.logWebRTCStats();
2125
+ }, STATS_LOG_FREQUENCY_MS);
2126
+ }
2127
+ } else if (this.statsLogInterval) {
2128
+ CriticalTimers.clearInterval(this.statsLogInterval);
2129
+ this.statsLogInterval = undefined;
2130
+ }
2131
+ }
2132
+ registerConnectionReconcile() {
2133
+ this.clearConnectionReconcile();
2134
+ let consecutiveFailures = 0;
2135
+ this.connectionReconcileInterval = CriticalTimers.setInterval(() => {
2136
+ if (
2137
+ // ensure we didn't tear it down
2138
+ !this.engine ||
2139
+ // engine detected close, but Room missed it
2140
+ this.engine.isClosed ||
2141
+ // transports failed without notifying engine
2142
+ !this.engine.verifyTransport()) {
2143
+ consecutiveFailures++;
2144
+ this.log.warn('detected connection state mismatch', {
2145
+ numFailures: consecutiveFailures,
2146
+ engine: this.engine ? {
2147
+ closed: this.engine.isClosed,
2148
+ transportsConnectedOrConnecting: this.engine.verifyTransport()
2149
+ } : undefined
2150
+ });
2151
+ if (consecutiveFailures >= 3) {
2152
+ this.clearConnectionReconcile();
2153
+ if (this.engine && !this.engine.isClosed) {
2154
+ // The transport silently died while we still looked connected. Try a full reconnect
2155
+ // (keeps the room alive; the engine falls back to Disconnected if it ultimately fails).
2156
+ this.log.warn('detected connection state mismatch, attempting full reconnect');
2157
+ this.engine.reconnect();
2158
+ } else {
2159
+ // No usable engine to reconnect with; tear down.
2160
+ this.recreateEngine();
2161
+ this.handleDisconnect(this.options.stopLocalTrackOnUnpublish, DisconnectReason.STATE_MISMATCH);
2162
+ }
2163
+ }
2164
+ } else {
2165
+ consecutiveFailures = 0;
2166
+ }
2167
+ }, CONNECTION_RECONCILE_FREQUENCY_MS);
2168
+ }
2169
+ clearConnectionReconcile() {
2170
+ if (this.connectionReconcileInterval) {
2171
+ CriticalTimers.clearInterval(this.connectionReconcileInterval);
2172
+ }
2173
+ }
2174
+ setAndEmitConnectionState(state) {
2175
+ if (state === this.state) {
2176
+ // unchanged
2177
+ return false;
2178
+ }
2179
+ this.log.info("connection state changed: ".concat(this.state, " -> ").concat(state));
2180
+ this.state = state;
2181
+ this.setStatsLogging(state === ConnectionState.Connected);
2182
+ this.emit(RoomEvent.ConnectionStateChanged, this.state);
2183
+ return true;
2184
+ }
2185
+ emitBufferedEvents() {
2186
+ this.bufferedEvents.forEach(_ref4 => {
2187
+ let _ref5 = _slicedToArray(_ref4, 2),
2188
+ ev = _ref5[0],
2189
+ args = _ref5[1];
2190
+ this.emit(ev, ...args);
2191
+ });
2192
+ this.bufferedEvents = [];
2193
+ }
2194
+ emitWhenConnected(event) {
2195
+ for (var _len2 = arguments.length, args = new Array(_len2 > 1 ? _len2 - 1 : 0), _key2 = 1; _key2 < _len2; _key2++) {
2196
+ args[_key2 - 1] = arguments[_key2];
2197
+ }
2198
+ if (this.state === ConnectionState.Reconnecting || this.isResuming || !this.engine || this.engine.pendingReconnect) {
2199
+ // in case the room is reconnecting, buffer the events by firing them later after emitting RoomEvent.Reconnected
2200
+ this.bufferedEvents.push([event, args]);
2201
+ } else if (this.state === ConnectionState.Connected) {
2202
+ return this.emit(event, ...args);
2203
+ }
2204
+ return false;
2205
+ }
2206
+ /** Puts the room into the connected state without a server (`ExtensionContext.simulateConnected`). */
2207
+ simulateConnected(roomInfo, localParticipantInfo) {
2208
+ this.handleDisconnect();
2209
+ this.roomInfo = roomInfo;
2210
+ this.localParticipant.updateInfo(localParticipantInfo);
2211
+ this.setupLocalParticipantEvents();
2212
+ this.emit(RoomEvent.SignalConnected);
2213
+ this.emit(RoomEvent.Connected);
2214
+ this.setAndEmitConnectionState(ConnectionState.Connected);
2215
+ }
2216
+ // /** @internal */
2217
+ emit(event) {
2218
+ for (var _len3 = arguments.length, args = new Array(_len3 > 1 ? _len3 - 1 : 0), _key3 = 1; _key3 < _len3; _key3++) {
2219
+ args[_key3 - 1] = arguments[_key3];
2220
+ }
2221
+ // active speaker updates are too spammy
2222
+ if (event !== RoomEvent.ActiveSpeakersChanged && event !== RoomEvent.TranscriptionReceived) {
2223
+ // only extract logContext from arguments in order to avoid logging the whole object tree
2224
+ const minimizedArgs = mapArgs(args).filter(arg => arg !== undefined);
2225
+ if (event === RoomEvent.TrackSubscribed || event === RoomEvent.TrackUnsubscribed) {
2226
+ this.log.trace("subscribe trace: ".concat(event), {
2227
+ event,
2228
+ args: minimizedArgs
2229
+ });
2230
+ }
2231
+ this.log.debug("room event ".concat(event), {
2232
+ event,
2233
+ args: minimizedArgs
2234
+ });
2235
+ }
2236
+ return super.emit(event, ...args);
2237
+ }
2238
+ }
2239
+ CoreRoom.cleanupRegistry = typeof FinalizationRegistry !== 'undefined' && typeof WeakRef !== 'undefined' && new FinalizationRegistry(cleanupController => {
2240
+ cleanupController.abort();
2241
+ });
2242
+ function mapArgs(args) {
2243
+ return args.map(arg => {
2244
+ if (!arg) {
2245
+ return;
2246
+ }
2247
+ if (Array.isArray(arg)) {
2248
+ return mapArgs(arg);
2249
+ }
2250
+ if (typeof arg === 'object') {
2251
+ return 'logContext' in arg ? arg.logContext : undefined;
2252
+ }
2253
+ return arg;
2254
+ });
2255
+ }
2256
+ /** Copies an extension's API onto `target`. Refuses to redefine an existing member. */
2257
+ /**
2258
+ * Copies an extension's API onto `target`. A name that core (`base`) or an earlier extension
2259
+ * already defines is a collision. A name a subclass of `base` defines is an override: the
2260
+ * subclass method stays and the extension's is not installed, so `Room` subclasses that
2261
+ * override a moved method keep working (there is no `super` to call, the override replaces it).
2262
+ */
2263
+ function defineExtensionApi(target, base, api, ext) {
2264
+ if (!api) {
2265
+ return;
2266
+ }
2267
+ const descriptors = Object.getOwnPropertyDescriptors(api);
2268
+ for (const name of Object.keys(descriptors)) {
2269
+ if (Object.getOwnPropertyDescriptor(target, name) || name in base) {
2270
+ // @throws-transformer ignore - programmer error
2271
+ throw new Error("extension '".concat(String(ext.key), "' redefines '").concat(name, "'"));
2272
+ }
2273
+ if (name in target) {
2274
+ delete descriptors[name];
2275
+ }
2276
+ }
2277
+ // defineProperties (not Object.assign) keeps getters intact
2278
+ Object.defineProperties(target, descriptors);
2279
+ }export{ConnectionState,CoreRoom};//# sourceMappingURL=CoreRoom.mjs.map