livekit-client 2.22.4 → 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 (904) 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 +225 -137
  535. package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
  536. package/dist/livekit-client.esm.mjs +32913 -31390
  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 +1 -0
  547. package/dist/src/api/WebSocketStream.d.ts.map +1 -1
  548. package/dist/src/api/utils.d.ts +1 -1
  549. package/dist/src/api/utils.d.ts.map +1 -1
  550. package/dist/src/connectionHelper/checks/Checker.d.ts +7 -4
  551. package/dist/src/connectionHelper/checks/Checker.d.ts.map +1 -1
  552. package/dist/src/core.d.ts +33 -0
  553. package/dist/src/core.d.ts.map +1 -0
  554. package/dist/src/e2ee/E2eeManager.d.ts +25 -5
  555. package/dist/src/e2ee/E2eeManager.d.ts.map +1 -1
  556. package/dist/src/e2ee/KeyProvider.d.ts.map +1 -1
  557. package/dist/src/e2ee/extension.d.ts +19 -0
  558. package/dist/src/e2ee/extension.d.ts.map +1 -0
  559. package/dist/src/e2ee/types.d.ts +14 -0
  560. package/dist/src/e2ee/types.d.ts.map +1 -1
  561. package/dist/src/e2ee/utils.d.ts +6 -1
  562. package/dist/src/e2ee/utils.d.ts.map +1 -1
  563. package/dist/src/e2ee/worker/FrameCryptor.d.ts +7 -1
  564. package/dist/src/e2ee/worker/FrameCryptor.d.ts.map +1 -1
  565. package/dist/src/e2ee/worker/naluUtils.d.ts +19 -1
  566. package/dist/src/e2ee/worker/naluUtils.d.ts.map +1 -1
  567. package/dist/src/e2ee/worker/sifPayload.d.ts +1 -1
  568. package/dist/src/e2ee/worker/sifPayload.d.ts.map +1 -1
  569. package/dist/src/exports.d.ts +76 -0
  570. package/dist/src/exports.d.ts.map +1 -0
  571. package/dist/src/frameMetadata/FrameMetadataManager.d.ts +5 -2
  572. package/dist/src/frameMetadata/FrameMetadataManager.d.ts.map +1 -1
  573. package/dist/src/frameMetadata/extension.d.ts +11 -0
  574. package/dist/src/frameMetadata/extension.d.ts.map +1 -0
  575. package/dist/src/frameMetadata/utils.d.ts +5 -0
  576. package/dist/src/frameMetadata/utils.d.ts.map +1 -1
  577. package/dist/src/index.d.ts +35 -63
  578. package/dist/src/index.d.ts.map +1 -1
  579. package/dist/src/logger.d.ts +1 -3
  580. package/dist/src/logger.d.ts.map +1 -1
  581. package/dist/src/options.d.ts +20 -6
  582. package/dist/src/options.d.ts.map +1 -1
  583. package/dist/src/room/CoreRoom.d.ts +392 -0
  584. package/dist/src/room/CoreRoom.d.ts.map +1 -0
  585. package/dist/src/room/DefaultReconnectPolicy.d.ts.map +1 -1
  586. package/dist/src/room/PCTransport.d.ts +31 -6
  587. package/dist/src/room/PCTransport.d.ts.map +1 -1
  588. package/dist/src/room/PCTransportManager.d.ts +8 -4
  589. package/dist/src/room/PCTransportManager.d.ts.map +1 -1
  590. package/dist/src/room/RTCEngine.d.ts +31 -6
  591. package/dist/src/room/RTCEngine.d.ts.map +1 -1
  592. package/dist/src/room/Room.d.ts +5 -350
  593. package/dist/src/room/Room.d.ts.map +1 -1
  594. package/dist/src/room/chat/extension.d.ts +22 -0
  595. package/dist/src/room/chat/extension.d.ts.map +1 -0
  596. package/dist/src/room/createRoom.d.ts +19 -0
  597. package/dist/src/room/createRoom.d.ts.map +1 -0
  598. package/dist/src/room/data-channel/DataChannelManager.d.ts +16 -9
  599. package/dist/src/room/data-channel/DataChannelManager.d.ts.map +1 -1
  600. package/dist/src/room/data-channel/FlowControlledDataChannel.d.ts +25 -12
  601. package/dist/src/room/data-channel/FlowControlledDataChannel.d.ts.map +1 -1
  602. package/dist/src/room/data-channel/LossyDataChannel.d.ts.map +1 -1
  603. package/dist/src/room/data-channel/ReliableDataChannel.d.ts.map +1 -1
  604. package/dist/src/room/data-stream/constants.d.ts +9 -0
  605. package/dist/src/room/data-stream/constants.d.ts.map +1 -1
  606. package/dist/src/room/data-stream/extension.d.ts +73 -0
  607. package/dist/src/room/data-stream/extension.d.ts.map +1 -0
  608. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  609. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts.map +1 -1
  610. package/dist/src/room/data-stream/incoming/StreamReader.d.ts.map +1 -1
  611. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  612. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts.map +1 -1
  613. package/dist/src/room/data-track/LocalDataTrack.d.ts +1 -1
  614. package/dist/src/room/data-track/depacketizer.d.ts +1 -1
  615. package/dist/src/room/data-track/depacketizer.d.ts.map +1 -1
  616. package/dist/src/room/data-track/extension.d.ts +31 -0
  617. package/dist/src/room/data-track/extension.d.ts.map +1 -0
  618. package/dist/src/room/data-track/handle.d.ts +1 -1
  619. package/dist/src/room/data-track/handle.d.ts.map +1 -1
  620. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  621. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts.map +1 -1
  622. package/dist/src/room/data-track/incoming/pipeline.d.ts +1 -1
  623. package/dist/src/room/data-track/incoming/pipeline.d.ts.map +1 -1
  624. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  625. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts.map +1 -1
  626. package/dist/src/room/data-track/outgoing/pipeline.d.ts +1 -1
  627. package/dist/src/room/data-track/outgoing/pipeline.d.ts.map +1 -1
  628. package/dist/src/room/data-track/packet/extensions.d.ts +1 -1
  629. package/dist/src/room/data-track/packet/extensions.d.ts.map +1 -1
  630. package/dist/src/room/data-track/packet/index.d.ts +1 -1
  631. package/dist/src/room/data-track/packet/index.d.ts.map +1 -1
  632. package/dist/src/room/data-track/packet/serializable.d.ts +1 -1
  633. package/dist/src/room/data-track/packet/serializable.d.ts.map +1 -1
  634. package/dist/src/room/data-track/packetizer.d.ts +1 -1
  635. package/dist/src/room/data-track/packetizer.d.ts.map +1 -1
  636. package/dist/src/room/data-track/track-interfaces.d.ts +1 -1
  637. package/dist/src/room/data-track/track-interfaces.d.ts.map +1 -1
  638. package/dist/src/room/data-track/utils.d.ts +1 -1
  639. package/dist/src/room/defaults.d.ts +1 -2
  640. package/dist/src/room/defaults.d.ts.map +1 -1
  641. package/dist/src/room/extensions.d.ts +208 -0
  642. package/dist/src/room/extensions.d.ts.map +1 -0
  643. package/dist/src/room/participant/LocalParticipant.d.ts +49 -120
  644. package/dist/src/room/participant/LocalParticipant.d.ts.map +1 -1
  645. package/dist/src/room/participant/Participant.d.ts +9 -2
  646. package/dist/src/room/participant/Participant.d.ts.map +1 -1
  647. package/dist/src/room/participant/RemoteParticipant.d.ts +3 -3
  648. package/dist/src/room/participant/RemoteParticipant.d.ts.map +1 -1
  649. package/dist/src/room/participant/publishUtils.d.ts.map +1 -1
  650. package/dist/src/room/rpc/extension.d.ts +70 -0
  651. package/dist/src/room/rpc/extension.d.ts.map +1 -0
  652. package/dist/src/room/rpc/index.d.ts +1 -1
  653. package/dist/src/room/rpc/index.d.ts.map +1 -1
  654. package/dist/src/room/rpc/legacyExtension.d.ts +34 -0
  655. package/dist/src/room/rpc/legacyExtension.d.ts.map +1 -0
  656. package/dist/src/room/rpc/utils.d.ts.map +1 -1
  657. package/dist/src/room/simulated-participants/extension.d.ts +25 -0
  658. package/dist/src/room/simulated-participants/extension.d.ts.map +1 -0
  659. package/dist/src/room/token-source/TokenSource.d.ts +5 -1
  660. package/dist/src/room/token-source/TokenSource.d.ts.map +1 -1
  661. package/dist/src/room/token-source/utils.d.ts.map +1 -1
  662. package/dist/src/room/track/LocalAudioTrack.d.ts +24 -1
  663. package/dist/src/room/track/LocalAudioTrack.d.ts.map +1 -1
  664. package/dist/src/room/track/LocalTrack.d.ts +19 -1
  665. package/dist/src/room/track/LocalTrack.d.ts.map +1 -1
  666. package/dist/src/room/track/LocalVideoTrack.d.ts +7 -0
  667. package/dist/src/room/track/LocalVideoTrack.d.ts.map +1 -1
  668. package/dist/src/room/track/RemoteAudioTrack.d.ts +6 -0
  669. package/dist/src/room/track/RemoteAudioTrack.d.ts.map +1 -1
  670. package/dist/src/room/track/RemoteTrackPublication.d.ts +14 -1
  671. package/dist/src/room/track/RemoteTrackPublication.d.ts.map +1 -1
  672. package/dist/src/room/track/Track.d.ts.map +1 -1
  673. package/dist/src/room/track/TrackPublication.d.ts +2 -2
  674. package/dist/src/room/track/TrackPublication.d.ts.map +1 -1
  675. package/dist/src/room/track/create.d.ts +15 -13
  676. package/dist/src/room/track/create.d.ts.map +1 -1
  677. package/dist/src/room/track/facingMode.d.ts.map +1 -1
  678. package/dist/src/room/track/options.d.ts +0 -6
  679. package/dist/src/room/track/options.d.ts.map +1 -1
  680. package/dist/src/room/track/processor/types.d.ts +13 -2
  681. package/dist/src/room/track/processor/types.d.ts.map +1 -1
  682. package/dist/src/room/track/utils.d.ts +1 -1
  683. package/dist/src/room/track/utils.d.ts.map +1 -1
  684. package/dist/src/room/utils.d.ts +30 -3
  685. package/dist/src/room/utils.d.ts.map +1 -1
  686. package/dist/src/room/video/create.d.ts +28 -0
  687. package/dist/src/room/video/create.d.ts.map +1 -0
  688. package/dist/src/room/video/extension.d.ts +48 -0
  689. package/dist/src/room/video/extension.d.ts.map +1 -0
  690. package/dist/src/room/video/publisher.d.ts +24 -0
  691. package/dist/src/room/video/publisher.d.ts.map +1 -0
  692. package/dist/src/test/MockMediaStream.d.ts +6 -0
  693. package/dist/src/test/MockMediaStream.d.ts.map +1 -0
  694. package/dist/src/utils/browserParser.d.ts +0 -3
  695. package/dist/src/utils/browserParser.d.ts.map +1 -1
  696. package/dist/src/utils/deferrable-map.d.ts +1 -1
  697. package/dist/src/utils/deferrable-map.d.ts.map +1 -1
  698. package/dist/src/utils/serializer.d.ts.map +1 -1
  699. package/dist/src/utils/throws.d.ts +10 -0
  700. package/dist/src/utils/throws.d.ts.map +1 -0
  701. package/dist/src/version.d.ts +4 -1
  702. package/dist/src/version.d.ts.map +1 -1
  703. package/dist/ts4.2/api/WebSocketStream.d.ts +1 -0
  704. package/dist/ts4.2/api/utils.d.ts +1 -1
  705. package/dist/ts4.2/connectionHelper/checks/Checker.d.ts +7 -4
  706. package/dist/ts4.2/core.d.ts +34 -0
  707. package/dist/ts4.2/e2ee/E2eeManager.d.ts +25 -5
  708. package/dist/ts4.2/e2ee/extension.d.ts +20 -0
  709. package/dist/ts4.2/e2ee/types.d.ts +14 -0
  710. package/dist/ts4.2/e2ee/utils.d.ts +6 -1
  711. package/dist/ts4.2/e2ee/worker/FrameCryptor.d.ts +7 -1
  712. package/dist/ts4.2/e2ee/worker/naluUtils.d.ts +19 -1
  713. package/dist/ts4.2/e2ee/worker/sifPayload.d.ts +1 -1
  714. package/dist/ts4.2/exports.d.ts +83 -0
  715. package/dist/ts4.2/frameMetadata/FrameMetadataManager.d.ts +5 -2
  716. package/dist/ts4.2/frameMetadata/extension.d.ts +13 -0
  717. package/dist/ts4.2/frameMetadata/utils.d.ts +5 -0
  718. package/dist/ts4.2/index.d.ts +35 -69
  719. package/dist/ts4.2/logger.d.ts +1 -3
  720. package/dist/ts4.2/options.d.ts +20 -6
  721. package/dist/ts4.2/room/CoreRoom.d.ts +381 -0
  722. package/dist/ts4.2/room/PCTransport.d.ts +31 -6
  723. package/dist/ts4.2/room/PCTransportManager.d.ts +8 -4
  724. package/dist/ts4.2/room/RTCEngine.d.ts +31 -6
  725. package/dist/ts4.2/room/Room.d.ts +6 -339
  726. package/dist/ts4.2/room/chat/extension.d.ts +22 -0
  727. package/dist/ts4.2/room/createRoom.d.ts +20 -0
  728. package/dist/ts4.2/room/data-channel/DataChannelManager.d.ts +15 -9
  729. package/dist/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +25 -12
  730. package/dist/ts4.2/room/data-stream/constants.d.ts +9 -0
  731. package/dist/ts4.2/room/data-stream/extension.d.ts +74 -0
  732. package/dist/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  733. package/dist/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  734. package/dist/ts4.2/room/data-track/LocalDataTrack.d.ts +1 -1
  735. package/dist/ts4.2/room/data-track/depacketizer.d.ts +1 -1
  736. package/dist/ts4.2/room/data-track/extension.d.ts +31 -0
  737. package/dist/ts4.2/room/data-track/handle.d.ts +1 -1
  738. package/dist/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  739. package/dist/ts4.2/room/data-track/incoming/pipeline.d.ts +1 -1
  740. package/dist/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  741. package/dist/ts4.2/room/data-track/outgoing/pipeline.d.ts +1 -1
  742. package/dist/ts4.2/room/data-track/packet/extensions.d.ts +1 -1
  743. package/dist/ts4.2/room/data-track/packet/index.d.ts +1 -1
  744. package/dist/ts4.2/room/data-track/packet/serializable.d.ts +1 -1
  745. package/dist/ts4.2/room/data-track/packetizer.d.ts +1 -1
  746. package/dist/ts4.2/room/data-track/track-interfaces.d.ts +1 -1
  747. package/dist/ts4.2/room/data-track/utils.d.ts +1 -1
  748. package/dist/ts4.2/room/defaults.d.ts +1 -2
  749. package/dist/ts4.2/room/extensions.d.ts +214 -0
  750. package/dist/ts4.2/room/participant/LocalParticipant.d.ts +48 -121
  751. package/dist/ts4.2/room/participant/Participant.d.ts +9 -2
  752. package/dist/ts4.2/room/participant/RemoteParticipant.d.ts +3 -3
  753. package/dist/ts4.2/room/rpc/extension.d.ts +74 -0
  754. package/dist/ts4.2/room/rpc/index.d.ts +1 -1
  755. package/dist/ts4.2/room/rpc/legacyExtension.d.ts +39 -0
  756. package/dist/ts4.2/room/simulated-participants/extension.d.ts +25 -0
  757. package/dist/ts4.2/room/token-source/TokenSource.d.ts +5 -1
  758. package/dist/ts4.2/room/track/LocalAudioTrack.d.ts +24 -1
  759. package/dist/ts4.2/room/track/LocalTrack.d.ts +19 -1
  760. package/dist/ts4.2/room/track/LocalVideoTrack.d.ts +7 -0
  761. package/dist/ts4.2/room/track/RemoteAudioTrack.d.ts +6 -0
  762. package/dist/ts4.2/room/track/RemoteTrackPublication.d.ts +3 -1
  763. package/dist/ts4.2/room/track/TrackPublication.d.ts +2 -2
  764. package/dist/ts4.2/room/track/create.d.ts +15 -13
  765. package/dist/ts4.2/room/track/options.d.ts +0 -6
  766. package/dist/ts4.2/room/track/processor/types.d.ts +13 -2
  767. package/dist/ts4.2/room/track/utils.d.ts +1 -1
  768. package/dist/ts4.2/room/utils.d.ts +30 -3
  769. package/dist/ts4.2/room/video/create.d.ts +28 -0
  770. package/dist/ts4.2/room/video/extension.d.ts +48 -0
  771. package/dist/ts4.2/room/video/publisher.d.ts +24 -0
  772. package/dist/ts4.2/test/MockMediaStream.d.ts +6 -0
  773. package/dist/ts4.2/utils/browserParser.d.ts +0 -3
  774. package/dist/ts4.2/utils/deferrable-map.d.ts +1 -1
  775. package/dist/ts4.2/utils/throws.d.ts +10 -0
  776. package/dist/ts4.2/version.d.ts +4 -1
  777. package/package.json +24 -9
  778. package/src/api/SignalClient.test.ts +341 -0
  779. package/src/api/SignalClient.ts +71 -26
  780. package/src/api/WebSocketStream.test.ts +78 -0
  781. package/src/api/WebSocketStream.ts +63 -4
  782. package/src/api/utils.ts +1 -1
  783. package/src/connectionHelper/checks/Checker.ts +12 -5
  784. package/src/connectionHelper/checks/publishVideo.ts +1 -1
  785. package/src/connectionHelper/checks/reconnect.ts +1 -1
  786. package/src/core.ts +35 -0
  787. package/src/e2ee/E2eeManager.test.ts +113 -1
  788. package/src/e2ee/E2eeManager.ts +58 -33
  789. package/src/e2ee/KeyProvider.ts +2 -1
  790. package/src/e2ee/extension.ts +113 -0
  791. package/src/e2ee/subscriberBlackScreen.test.ts +9 -12
  792. package/src/e2ee/types.ts +14 -0
  793. package/src/e2ee/utils.test.ts +47 -0
  794. package/src/e2ee/utils.ts +26 -14
  795. package/src/e2ee/worker/DataCryptor.test.ts +42 -1
  796. package/src/e2ee/worker/DataCryptor.ts +2 -2
  797. package/src/e2ee/worker/FrameCryptor.race.test.ts +3 -7
  798. package/src/e2ee/worker/FrameCryptor.test.ts +280 -103
  799. package/src/e2ee/worker/FrameCryptor.ts +97 -20
  800. package/src/e2ee/worker/e2ee.worker.test.ts +151 -0
  801. package/src/e2ee/worker/e2ee.worker.ts +28 -20
  802. package/src/e2ee/worker/naluUtils.test.ts +143 -0
  803. package/src/e2ee/worker/naluUtils.ts +87 -2
  804. package/src/e2ee/worker/sifPayload.ts +1 -1
  805. package/src/exports.ts +224 -0
  806. package/src/frameMetadata/FrameMetadataManager.ts +9 -3
  807. package/src/frameMetadata/extension.ts +34 -0
  808. package/src/frameMetadata/frameMetadata.ts +1 -1
  809. package/src/frameMetadata/utils.ts +23 -0
  810. package/src/index.ts +47 -187
  811. package/src/logger.ts +1 -3
  812. package/src/options.ts +25 -6
  813. package/src/room/CoreRoom.ts +3017 -0
  814. package/src/room/DefaultReconnectPolicy.test.ts +58 -0
  815. package/src/room/DefaultReconnectPolicy.ts +14 -2
  816. package/src/room/DeviceManager.test.ts +55 -1
  817. package/src/room/DeviceManager.ts +1 -1
  818. package/src/room/PCTransport.test.ts +187 -2
  819. package/src/room/PCTransport.ts +173 -31
  820. package/src/room/PCTransportManager.test.ts +65 -3
  821. package/src/room/PCTransportManager.ts +28 -12
  822. package/src/room/RTCEngine.test.ts +654 -22
  823. package/src/room/RTCEngine.ts +240 -41
  824. package/src/room/RegionUrlProvider.ts +1 -1
  825. package/src/room/Room.test.ts +833 -4
  826. package/src/room/Room.ts +34 -3105
  827. package/src/room/chat/extension.ts +78 -0
  828. package/src/room/createRoom.test.ts +149 -0
  829. package/src/room/createRoom.ts +26 -0
  830. package/src/room/data-channel/DataChannelManager.test.ts +61 -7
  831. package/src/room/data-channel/DataChannelManager.ts +61 -38
  832. package/src/room/data-channel/FlowControlledDataChannel.test.ts +60 -18
  833. package/src/room/data-channel/FlowControlledDataChannel.ts +40 -22
  834. package/src/room/data-channel/LossyDataChannel.test.ts +38 -0
  835. package/src/room/data-channel/LossyDataChannel.ts +10 -1
  836. package/src/room/data-channel/ReliableDataChannel.test.ts +72 -0
  837. package/src/room/data-channel/ReliableDataChannel.ts +16 -5
  838. package/src/room/data-stream/constants.ts +10 -0
  839. package/src/room/data-stream/extension.ts +162 -0
  840. package/src/room/data-stream/incoming/IncomingDataStreamManager.test.ts +300 -3
  841. package/src/room/data-stream/incoming/IncomingDataStreamManager.ts +64 -2
  842. package/src/room/data-stream/incoming/StreamReader.ts +14 -4
  843. package/src/room/data-stream/outgoing/OutgoingDataStreamManager.ts +1 -2
  844. package/src/room/data-track/depacketizer.ts +2 -2
  845. package/src/room/data-track/extension.ts +244 -0
  846. package/src/room/data-track/handle.ts +1 -1
  847. package/src/room/data-track/incoming/IncomingDataTrackManager.ts +2 -2
  848. package/src/room/data-track/incoming/pipeline.ts +2 -2
  849. package/src/room/data-track/outgoing/OutgoingDataTrackManager.test.ts +42 -3
  850. package/src/room/data-track/outgoing/OutgoingDataTrackManager.ts +5 -3
  851. package/src/room/data-track/outgoing/pipeline.ts +1 -1
  852. package/src/room/data-track/packet/extensions.ts +1 -1
  853. package/src/room/data-track/packet/index.ts +1 -1
  854. package/src/room/data-track/packet/serializable.ts +1 -1
  855. package/src/room/data-track/packetizer.ts +1 -1
  856. package/src/room/data-track/track-interfaces.ts +4 -4
  857. package/src/room/data-track/utils.ts +1 -1
  858. package/src/room/defaults.ts +3 -16
  859. package/src/room/extensions.ts +310 -0
  860. package/src/room/participant/LocalParticipant.test.ts +154 -2
  861. package/src/room/participant/LocalParticipant.ts +141 -669
  862. package/src/room/participant/Participant.test.ts +60 -0
  863. package/src/room/participant/Participant.ts +27 -4
  864. package/src/room/participant/RemoteParticipant.ts +3 -8
  865. package/src/room/participant/publishUtils.ts +3 -3
  866. package/src/room/participant/restartOnDefaultAudioDevice.test.ts +177 -0
  867. package/src/room/rpc/extension.ts +159 -0
  868. package/src/room/rpc/index.ts +1 -10
  869. package/src/room/rpc/legacyExtension.ts +36 -0
  870. package/src/room/rpc/utils.test.ts +32 -0
  871. package/src/room/rpc/utils.ts +7 -0
  872. package/src/room/simulated-participants/extension.ts +189 -0
  873. package/src/room/token-source/TokenSource.test.ts +29 -0
  874. package/src/room/token-source/TokenSource.ts +8 -3
  875. package/src/room/token-source/utils.test.ts +34 -0
  876. package/src/room/token-source/utils.ts +23 -1
  877. package/src/room/track/LocalAudioTrack.ts +101 -10
  878. package/src/room/track/LocalTrack.ts +88 -23
  879. package/src/room/track/LocalVideoTrack.test.ts +66 -2
  880. package/src/room/track/LocalVideoTrack.ts +12 -3
  881. package/src/room/track/RemoteAudioTrack.ts +56 -11
  882. package/src/room/track/RemoteTrackPublication.ts +14 -1
  883. package/src/room/track/RemoteVideoTrack.test.ts +2 -0
  884. package/src/room/track/Track.test.ts +102 -0
  885. package/src/room/track/Track.ts +8 -1
  886. package/src/room/track/TrackPublication.ts +2 -2
  887. package/src/room/track/create.ts +59 -71
  888. package/src/room/track/facingMode.ts +5 -2
  889. package/src/room/track/options.ts +26 -34
  890. package/src/room/track/processor/types.ts +13 -2
  891. package/src/room/track/utils.test.ts +5 -0
  892. package/src/room/track/utils.ts +34 -6
  893. package/src/room/utils.test.ts +126 -0
  894. package/src/room/utils.ts +86 -23
  895. package/src/room/video/create.ts +95 -0
  896. package/src/room/video/extension.ts +115 -0
  897. package/src/room/video/publisher.ts +472 -0
  898. package/src/test/MockMediaStream.ts +13 -0
  899. package/src/utils/browserParser.ts +0 -3
  900. package/src/utils/deferrable-map.test.ts +60 -0
  901. package/src/utils/deferrable-map.ts +7 -4
  902. package/src/utils/serializer.ts +1 -1
  903. package/src/utils/throws.ts +15 -0
  904. package/src/version.ts +6 -1
@@ -0,0 +1,1830 @@
1
+ import {slicedToArray as _slicedToArray}from'../_virtual/_rollupPluginBabelHelpers.mjs';import {__awaiter}from'tslib';import {Mutex}from'@livekit/mutex';import {DataPacket,EncryptedPacketPayload,Encryption_Type,ReconnectReason,LeaveRequest_Action,DisconnectReason,ClientConfigSetting,ConnectionQuality,RpcAck,DataPacket_Kind,EncryptedPacket,SyncState,UpdateSubscription,DataChannelReceiveState,SignalTarget,DataChannelInfo}from'@livekit/protocol';import {EventEmitter}from'events';import {SignalConnectionState,SignalClient,toProtoSessionDescription}from'../api/SignalClient.mjs';import {isInsertableStreamSupported,asEncryptablePacket}from'../e2ee/utils.mjs';import {shouldUseFrameMetadataScriptTransform,getPublishFrameMetadata,hasFrameMetadataPublishOptions,isFrameMetadataSupported}from'../frameMetadata/utils.mjs';import livekitLogger,{getLogger,LoggerNames}from'../logger.mjs';import TypedPromise from'../utils/TypedPromise.mjs';import {TTLMap}from'../utils/ttlmap.mjs';import {PROTOCOL_NEGOTIATED_DATA_CHANNELS}from'../version.mjs';import {PCEvents}from'./PCTransport.mjs';import {PCTransportState,PCTransportManager}from'./PCTransportManager.mjs';import {DataChannelManager}from'./data-channel/DataChannelManager.mjs';import {DataChannelKind}from'./data-channel/types.mjs';import {roomConnectOptionDefaults}from'./defaults.mjs';import {ConnectionError,ConnectionErrorReason,TrackInvalidError,UnexpectedConnectionState,SignalReconnectError,PublishDataError,NegotiationError}from'./errors.mjs';import {EngineEvent}from'./events.mjs';import CriticalTimers from'./timers.mjs';import {getTrackPublicationInfo}from'./track/utils.mjs';import {isVideoCodec,toHttpUrl,sleep,isPublisherOfferWithJoinSupported,isReactNative,negotiateDependencyDescriptor,supportsTransceiver,supportsAddTrack,isVideoTrack,isWeb}from'./utils.mjs';const minReconnectWait = 2 * 1000;
2
+ const leaveReconnect = 'leave-reconnect';
3
+ /**
4
+ * How long local connection quality must stay `LOST` while connected and publishing before we
5
+ * force a full reconnect — `LOST` is the server's verdict that it isn't receiving our media.
6
+ */
7
+ const connectionQualityLostTimeout = 10 * 1000;
8
+ const reliabeReceiveStateTTL = 30000;
9
+ const initialMediaSectionsAudio = 3;
10
+ const initialMediaSectionsVideo = 3;
11
+ var PCState;
12
+ (function (PCState) {
13
+ PCState[PCState["New"] = 0] = "New";
14
+ PCState[PCState["Connected"] = 1] = "Connected";
15
+ PCState[PCState["Disconnected"] = 2] = "Disconnected";
16
+ PCState[PCState["Reconnecting"] = 3] = "Reconnecting";
17
+ PCState[PCState["Closed"] = 4] = "Closed";
18
+ })(PCState || (PCState = {}));
19
+ // Default data-channel max message size (bytes), used when the remote SDP
20
+ // answer does not advertise an `a=max-message-size` attribute (RFC 8841).
21
+ // `0` means "no limit".
22
+ const DEFAULT_MAX_MESSAGE_SIZE = 64000;
23
+ class RTCEngine extends EventEmitter {
24
+ get isClosed() {
25
+ return this._isClosed;
26
+ }
27
+ get isNewlyCreated() {
28
+ return this._isNewlyCreated;
29
+ }
30
+ get pendingReconnect() {
31
+ return !!this.reconnectTimeout;
32
+ }
33
+ get serverVersion() {
34
+ var _a, _b, _c;
35
+ return ((_b = (_a = this.latestJoinResponse) === null || _a === void 0 ? void 0 : _a.serverInfo) === null || _b === void 0 ? void 0 : _b.version) || ((_c = this.latestJoinResponse) === null || _c === void 0 ? void 0 : _c.serverVersion) || undefined;
36
+ }
37
+ get reliableChannel() {
38
+ return this.dataChannels.reliable;
39
+ }
40
+ get lossyChannel() {
41
+ return this.dataChannels.lossy;
42
+ }
43
+ get dataTrackChannel() {
44
+ return this.dataChannels.dataTrack;
45
+ }
46
+ constructor(options) {
47
+ var _a;
48
+ super();
49
+ this.options = options;
50
+ this.rtcConfig = {};
51
+ this.peerConnectionTimeout = roomConnectOptionDefaults.peerConnectionTimeout;
52
+ this.fullReconnectOnNext = false;
53
+ /**
54
+ * @internal
55
+ */
56
+ this.latestRemoteOfferId = 0;
57
+ this.subscriberPrimary = false;
58
+ this.pcState = PCState.New;
59
+ this._isClosed = true;
60
+ this._isNewlyCreated = true;
61
+ this.pendingTrackResolvers = {};
62
+ this.reconnectAttempts = 0;
63
+ this.reconnectStart = 0;
64
+ this.attemptingReconnect = false;
65
+ /** keeps track of how often an initial join connection has been tried */
66
+ this.joinAttempts = 0;
67
+ /** specifies how often an initial join connection is allowed to retry */
68
+ this.maxJoinAttempts = 1;
69
+ this.shouldFailNext = false;
70
+ this.shouldFailOnV1Path = false;
71
+ this.log = livekitLogger;
72
+ this.reliableReceivedState = new TTLMap(reliabeReceiveStateTTL);
73
+ this.midToTrackId = {};
74
+ /** used to indicate whether the browser is currently waiting to reconnect */
75
+ this.isWaitingForNetworkReconnect = false;
76
+ /**
77
+ * Abort handlers for the in-flight `negotiate()` calls, which a single central
78
+ * Closing/Restarting listener pair fans out to. Registering a listener pair per call instead
79
+ * accumulates them on the engine emitter and trips its max-listener warning under
80
+ * renegotiation bursts.
81
+ */
82
+ this.pendingNegotiationAborts = new Set();
83
+ this.handleDataChannel = _a => __awaiter(this, [_a], void 0, function (_ref) {
84
+ var _this = this;
85
+ let channel = _ref.channel;
86
+ return function* () {
87
+ if (!channel) {
88
+ return;
89
+ }
90
+ if (_this.dataChannels.adoptSubscriberChannel(channel)) {
91
+ _this.log.debug("on data channel ".concat(channel.id, ", ").concat(channel.label));
92
+ }
93
+ }();
94
+ });
95
+ this.handleDataMessage = message => __awaiter(this, void 0, void 0, function* () {
96
+ var _a, _b, _c, _d;
97
+ // make sure to respect incoming data message order by processing message events one after the other
98
+ const unlock = yield this.dataProcessLock.lock();
99
+ try {
100
+ const bytes = yield this.decodeDataMessage(message);
101
+ if (!bytes) {
102
+ return;
103
+ }
104
+ const dp = DataPacket.fromBinary(bytes);
105
+ if (dp.sequence > 0 && dp.participantSid !== '') {
106
+ const lastSeq = this.reliableReceivedState.get(dp.participantSid);
107
+ if (lastSeq && dp.sequence <= lastSeq) {
108
+ // ignore duplicate or out-of-order packets in reliable channel
109
+ return;
110
+ }
111
+ this.reliableReceivedState.set(dp.participantSid, dp.sequence);
112
+ }
113
+ if (((_a = dp.value) === null || _a === void 0 ? void 0 : _a.case) === 'speaker') {
114
+ // dispatch speaker updates
115
+ this.emit(EngineEvent.ActiveSpeakersUpdate, dp.value.value.speakers);
116
+ } else if (((_b = dp.value) === null || _b === void 0 ? void 0 : _b.case) === 'encryptedPacket') {
117
+ if (!this.e2eeManager) {
118
+ this.log.error('Received encrypted packet but E2EE not set up');
119
+ return;
120
+ }
121
+ let decryptedData;
122
+ try {
123
+ decryptedData = yield this.e2eeManager.handleEncryptedData(dp.value.value.encryptedValue, dp.value.value.iv, dp.participantIdentity, dp.value.value.keyIndex);
124
+ } catch (err) {
125
+ this.log.debug('failed to decrypt data packet', {
126
+ error: err,
127
+ participantIdentity: dp.participantIdentity
128
+ });
129
+ return;
130
+ }
131
+ const decryptedPacket = EncryptedPacketPayload.fromBinary(decryptedData.payload);
132
+ const newDp = new DataPacket({
133
+ value: decryptedPacket.value,
134
+ participantIdentity: dp.participantIdentity,
135
+ participantSid: dp.participantSid
136
+ });
137
+ if (((_c = newDp.value) === null || _c === void 0 ? void 0 : _c.case) === 'user') {
138
+ // compatibility
139
+ applyUserDataCompat(newDp, newDp.value.value);
140
+ }
141
+ this.emit(EngineEvent.DataPacketReceived, newDp, dp.value.value.encryptionType);
142
+ } else {
143
+ if (((_d = dp.value) === null || _d === void 0 ? void 0 : _d.case) === 'user') {
144
+ // compatibility
145
+ applyUserDataCompat(dp, dp.value.value);
146
+ }
147
+ this.emit(EngineEvent.DataPacketReceived, dp, Encryption_Type.NONE);
148
+ }
149
+ } finally {
150
+ unlock();
151
+ }
152
+ });
153
+ this.handleDataTrackMessage = message => __awaiter(this, void 0, void 0, function* () {
154
+ const bytes = yield this.decodeDataMessage(message);
155
+ if (!bytes) {
156
+ return;
157
+ }
158
+ this.emit('dataTrackPacketReceived', bytes);
159
+ });
160
+ this.handleDataError = event => {
161
+ // Errors fired while we're tearing the connection down (e.g. the SCTP transport aborting as
162
+ // the peer connection closes) carry no actionable information — the channel is going away
163
+ // regardless. Suppress them so a graceful disconnect doesn't surface spurious errors.
164
+ // See livekit/client-sdk-js#1953.
165
+ if (this._isClosed) {
166
+ return;
167
+ }
168
+ const channel = event.currentTarget;
169
+ const channelKind = channel.maxRetransmits === 0 ? 'lossy' : 'reliable';
170
+ if (typeof RTCErrorEvent !== 'undefined' && event instanceof RTCErrorEvent && event.error) {
171
+ const error = event.error;
172
+ this.log.error("DataChannel error on ".concat(channelKind, ": ").concat(error.message), {
173
+ error,
174
+ errorDetail: error.errorDetail,
175
+ sctpCauseCode: error.sctpCauseCode
176
+ });
177
+ } else {
178
+ this.log.error("Unknown DataChannel error on ".concat(channelKind), {
179
+ event
180
+ });
181
+ }
182
+ };
183
+ this.handleDataChannelClose = kind => () => {
184
+ var _a;
185
+ // A publisher DC closing while the session is up and the publisher PC is still
186
+ // connected is the signature of an oversized message having aborted the channel
187
+ // (see livekit/rust-sdks#1137). Surface it; do not attempt renegotiation.
188
+ if (!this._isClosed && ((_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.publisher.getConnectionState()) === 'connected') {
189
+ this.log.error("publisher data channel '".concat(DataChannelKind[kind], "' closed unexpectedly"), this.logContext);
190
+ }
191
+ };
192
+ // websocket reconnect behavior. if websocket is interrupted, and the PeerConnection
193
+ // continues to work, we can reconnect to websocket to continue the session
194
+ // after a number of retries, we'll close and give up permanently
195
+ this.handleDisconnect = (connection, disconnectReason) => {
196
+ if (this._isClosed) {
197
+ return;
198
+ }
199
+ this.log.warn("".concat(connection, " disconnected"));
200
+ if (this.reconnectAttempts === 0) {
201
+ // only reset start time on the first try
202
+ this.reconnectStart = Date.now();
203
+ }
204
+ const disconnect = duration => {
205
+ this.log.warn("could not recover connection after ".concat(this.reconnectAttempts, " attempts, ").concat(duration, "ms. giving up"));
206
+ this.emit(EngineEvent.Disconnected);
207
+ this.close("gave up reconnecting after ".concat(this.reconnectAttempts, " attempts, ").concat(duration, "ms"));
208
+ };
209
+ const duration = Date.now() - this.reconnectStart;
210
+ let delay = this.getNextRetryDelay({
211
+ elapsedMs: duration,
212
+ retryCount: this.reconnectAttempts
213
+ });
214
+ if (delay === null) {
215
+ disconnect(duration);
216
+ return;
217
+ }
218
+ if (connection === leaveReconnect) {
219
+ // The server asked for a reconnect, so skip any remaining backoff. Use the policy's first
220
+ // retry delay instead of 0 so that clients told to reconnect together don't all reconnect
221
+ // at the same instant.
222
+ delay = this.getNextRetryDelay({
223
+ elapsedMs: duration,
224
+ retryCount: 0
225
+ });
226
+ if (delay === null) {
227
+ disconnect(duration);
228
+ return;
229
+ }
230
+ }
231
+ this.log.debug("reconnecting in ".concat(delay, "ms"));
232
+ this.clearReconnectTimeout();
233
+ if (this.token) {
234
+ // token may have been refreshed, we do not want to recreate the regionUrlProvider
235
+ // since the current engine may have inherited a regional url
236
+ this.emit(EngineEvent.TokenRefreshed, this.token);
237
+ }
238
+ const reconnectTimeout = CriticalTimers.setTimeout(() => this.attemptReconnect(disconnectReason).finally(() => {
239
+ // a failed attempt schedules its retry before this runs; don't clear the retry's handle
240
+ if (this.reconnectTimeout === reconnectTimeout) {
241
+ this.reconnectTimeout = undefined;
242
+ }
243
+ }), delay);
244
+ this.reconnectTimeout = reconnectTimeout;
245
+ };
246
+ /**
247
+ * resolves to whether the attempt `SignalRestarted` handed out restarted the connection. Call it
248
+ * while handling that event, before `Restarted` can fire
249
+ */
250
+ this.waitForRestarted = restartAttempt => {
251
+ return new Promise(resolve => {
252
+ if (restartAttempt.aborted) {
253
+ resolve(false);
254
+ return;
255
+ }
256
+ const onRestarted = () => {
257
+ restartAttempt.removeEventListener('abort', onAborted);
258
+ resolve(true);
259
+ };
260
+ const onAborted = () => {
261
+ restartAttempt.removeEventListener('abort', onAborted);
262
+ this.off(EngineEvent.Restarted, onRestarted);
263
+ resolve(false);
264
+ };
265
+ this.once(EngineEvent.Restarted, onRestarted);
266
+ restartAttempt.addEventListener('abort', onAborted);
267
+ });
268
+ };
269
+ this.onRtpMapAvailable = rtpTypes => {
270
+ const rtpMap = new Map();
271
+ rtpTypes.forEach(rtp => {
272
+ const codec = rtp.codec.toLowerCase();
273
+ if (isVideoCodec(codec)) {
274
+ rtpMap.set(rtp.payload, codec);
275
+ }
276
+ });
277
+ this.emit(EngineEvent.RTPVideoMapUpdate, rtpMap);
278
+ };
279
+ this.handleBrowserOnLine = () => __awaiter(this, void 0, void 0, function* () {
280
+ if (!this.url) {
281
+ return;
282
+ }
283
+ const hasNetworkConnection = yield fetch(toHttpUrl(this.url), {
284
+ method: 'HEAD'
285
+ }).then(resp => resp.ok).catch(() => false);
286
+ if (!hasNetworkConnection) {
287
+ return;
288
+ }
289
+ this.log.info('detected network reconnected');
290
+ if (
291
+ // in case the engine is currently reconnecting, attempt a reconnect immediately after the browser state has changed to 'onLine'
292
+ this.client.currentState === SignalConnectionState.RECONNECTING ||
293
+ // also if the browser went offline before and the engine still thinks it's in a connected state, treat it as a network interruption that we haven't noticed yet
294
+ this.isWaitingForNetworkReconnect && this.client.currentState === SignalConnectionState.CONNECTED) {
295
+ this.clearReconnectTimeout();
296
+ this.attemptReconnect(ReconnectReason.RR_SIGNAL_DISCONNECTED);
297
+ this.isWaitingForNetworkReconnect = false;
298
+ }
299
+ });
300
+ this.handleBrowserOffline = () => __awaiter(this, void 0, void 0, function* () {
301
+ if (!this.url) {
302
+ return;
303
+ }
304
+ try {
305
+ yield Promise.race([fetch(toHttpUrl(this.url), {
306
+ method: 'HEAD'
307
+ }),
308
+ // if there's no internet connection the fetch rejects immediately, so we only use a short timeout here
309
+ sleep(4000).then(() => Promise.reject())]);
310
+ } catch (e) {
311
+ // only set if the browser still thinks it's offline after the request failed
312
+ if (window.navigator.onLine === false) {
313
+ this.log.info('detected network interruption');
314
+ this.isWaitingForNetworkReconnect = true;
315
+ }
316
+ }
317
+ });
318
+ this.log = getLogger((_a = options.loggerName) !== null && _a !== void 0 ? _a : LoggerNames.Engine, () => this.logContext);
319
+ this.loggerOptions = {
320
+ loggerName: options.loggerName,
321
+ loggerContextCb: () => this.logContext
322
+ };
323
+ this.client = new SignalClient(undefined, this.loggerOptions);
324
+ this.client.signalLatency = this.options.expSignalLatency;
325
+ this.reconnectPolicy = this.options.reconnectPolicy;
326
+ this.closingLock = new Mutex();
327
+ this.dataProcessLock = new Mutex();
328
+ this.dataChannels = new DataChannelManager({
329
+ isEngineClosed: () => this.isClosed,
330
+ isReconnecting: () => this.attemptingReconnect,
331
+ onDataMessage: message => this.handleDataMessage(message),
332
+ onDataTrackMessage: message => this.handleDataTrackMessage(message),
333
+ onDataError: event => this.handleDataError(event),
334
+ onChannelClose: kind => this.handleDataChannelClose(kind)(),
335
+ onBufferStatusChanged: (kind, isLow) => this.emit(EngineEvent.DCBufferStatusChanged, isLow, kind)
336
+ });
337
+ this.client.onParticipantUpdate = updates => this.emit(EngineEvent.ParticipantUpdate, updates);
338
+ this.client.onConnectionQuality = update => {
339
+ this.handleLocalConnectionQuality(update);
340
+ this.emit(EngineEvent.ConnectionQualityUpdate, update);
341
+ };
342
+ this.client.onRoomUpdate = update => this.emit(EngineEvent.RoomUpdate, update);
343
+ this.client.onSubscriptionError = resp => this.emit(EngineEvent.SubscriptionError, resp);
344
+ this.client.onSubscriptionPermissionUpdate = update => this.emit(EngineEvent.SubscriptionPermissionUpdate, update);
345
+ this.client.onSpeakersChanged = update => this.emit(EngineEvent.SpeakersChanged, update);
346
+ this.client.onStreamStateUpdate = update => this.emit(EngineEvent.StreamStateChanged, update);
347
+ this.client.onRequestResponse = response => this.emit(EngineEvent.SignalRequestResponse, response);
348
+ this.client.onParticipantUpdate = updates => this.emit(EngineEvent.ParticipantUpdate, updates);
349
+ this.client.onJoined = joinResponse => this.emit(EngineEvent.Joined, joinResponse);
350
+ const abortPendingNegotiations = () => {
351
+ // Iterate a copy: each handler removes itself from the set as its negotiation settles.
352
+ for (const abort of Array.from(this.pendingNegotiationAborts)) {
353
+ abort();
354
+ }
355
+ };
356
+ this.on(EngineEvent.Closing, abortPendingNegotiations);
357
+ this.on(EngineEvent.Restarting, abortPendingNegotiations);
358
+ }
359
+ /** @internal */
360
+ get logContext() {
361
+ var _a, _b, _c, _d, _e, _f;
362
+ return {
363
+ room: (_b = (_a = this.latestJoinResponse) === null || _a === void 0 ? void 0 : _a.room) === null || _b === void 0 ? void 0 : _b.name,
364
+ roomID: (_d = (_c = this.latestJoinResponse) === null || _c === void 0 ? void 0 : _c.room) === null || _d === void 0 ? void 0 : _d.sid,
365
+ participant: (_f = (_e = this.latestJoinResponse) === null || _e === void 0 ? void 0 : _e.participant) === null || _f === void 0 ? void 0 : _f.identity,
366
+ participantID: this.participantSid
367
+ };
368
+ }
369
+ join(url_1, token_1, opts_1, abortSignal_1) {
370
+ return __awaiter(this, arguments, void 0, function (url, token, opts, abortSignal) {
371
+ var _this2 = this;
372
+ let useV0Path = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : false;
373
+ return function* () {
374
+ var _a, _b, _c, _d;
375
+ _this2._isNewlyCreated = false;
376
+ _this2.url = url;
377
+ _this2.token = token;
378
+ _this2.signalOpts = opts;
379
+ _this2.maxJoinAttempts = opts.maxRetries;
380
+ try {
381
+ _this2.joinAttempts += 1;
382
+ _this2.joinStartedAt = performance.now();
383
+ _this2.setupSignalClientCallbacks();
384
+ // Whether the initial publisher offer is bundled with the join request. Computed once and
385
+ // reused after the join below. Only the (non-Firefox) offer-with-join path does this.
386
+ const sendOfferWithJoin = !useV0Path && isPublisherOfferWithJoinSupported();
387
+ let offerProto;
388
+ if (sendOfferWithJoin) {
389
+ if (!_this2.pcManager) {
390
+ // Firefox is excluded from offer-with-join (see isPublisherOfferWithJoinSupported):
391
+ // customers reported ICE connectivity problems for FF on this path (#1919) that we were
392
+ // never able to reproduce, so out of caution FF stays on the deferred path below. The
393
+ // exact cause is unknown — note that ICE gathering does not actually start here, since
394
+ // createInitialOffer() defers setLocalDescription (via pendingInitialOffer) until the
395
+ // answer is applied, after updateConfiguration() has set the server's TURN servers.
396
+ yield _this2.configure();
397
+ // The server protocol is unknown until the join response, so assume negotiated data
398
+ // channels and fall back to in-band ones below if the server is too old.
399
+ _this2.applyInitialPublisherLayout(true);
400
+ }
401
+ const offer = yield (_a = _this2.pcManager) === null || _a === void 0 ? void 0 : _a.publisher.createInitialOffer();
402
+ if (offer) {
403
+ offerProto = toProtoSessionDescription(offer.offer, offer.offerId);
404
+ }
405
+ }
406
+ if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
407
+ throw ConnectionError.cancelled('Connection aborted');
408
+ }
409
+ if (!useV0Path && _this2.shouldFailOnV1Path) {
410
+ _this2.shouldFailOnV1Path = false;
411
+ throw ConnectionError.serviceNotFound('Simulated v1 path failure', 'v0-rtc');
412
+ }
413
+ const joinResponse = yield _this2.client.join(url, token, opts, abortSignal, useV0Path, offerProto);
414
+ if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
415
+ _this2.log.info('join cancelled after the signal join response');
416
+ throw ConnectionError.cancelled('Connection aborted');
417
+ }
418
+ _this2._isClosed = false;
419
+ _this2.latestJoinResponse = joinResponse;
420
+ _this2.participantSid = (_b = joinResponse.participant) === null || _b === void 0 ? void 0 : _b.sid;
421
+ _this2.subscriberPrimary = joinResponse.subscriberPrimary;
422
+ if (sendOfferWithJoin) {
423
+ (_c = _this2.pcManager) === null || _c === void 0 ? void 0 : _c.updateConfiguration(_this2.makeRTCConfiguration(joinResponse));
424
+ if (_this2.dataChannels.publisherChannelsNegotiated && !_this2.useNegotiatedDataChannels()) {
425
+ // The SCTP section is already in the offer, so in-band channels can be opened on it
426
+ // without renegotiation.
427
+ _this2.log.debug('server does not support negotiated data channels, using in-band ones');
428
+ _this2.createDataChannels(false);
429
+ }
430
+ } else {
431
+ if (!_this2.pcManager) {
432
+ // Deferred path (Firefox, and V0): configure with the join response so the PC picks up
433
+ // the server's ICE servers and topology, then negotiate separately rather than bundling
434
+ // the offer with the join.
435
+ yield _this2.configure(joinResponse, !useV0Path);
436
+ if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
437
+ _this2.log.info('join cancelled after configuring peer connections');
438
+ throw ConnectionError.cancelled('Connection aborted');
439
+ }
440
+ if (!useV0Path) {
441
+ // The V1 first offer must carry the media layout so Firefox binds receive decoders for
442
+ // subscribed tracks — without it, subscribed audio/video arrive as RTP but
443
+ // never decode. V0 (legacy dual-PC) keeps its original lazy behavior.
444
+ _this2.applyInitialPublisherLayout();
445
+ }
446
+ }
447
+ // create offer
448
+ if (!_this2.subscriberPrimary || joinResponse.fastPublish) {
449
+ _this2.negotiate().catch(err => {
450
+ _this2.log.error(err);
451
+ });
452
+ }
453
+ }
454
+ if (_this2.joinStartedAt !== undefined) {
455
+ // Lets a video published before the transports connect be seeded from the time elapsed
456
+ // so far, rather than delaying its offer until the setup time is measured.
457
+ (_d = _this2.pcManager) === null || _d === void 0 ? void 0 : _d.publisher.setConnectionStartedAt(_this2.joinStartedAt);
458
+ }
459
+ _this2.registerOnLineListener();
460
+ _this2.clientConfiguration = joinResponse.clientConfiguration;
461
+ _this2.emit(EngineEvent.SignalConnected, joinResponse);
462
+ let serverInfo = joinResponse.serverInfo;
463
+ if (!serverInfo) {
464
+ serverInfo = {
465
+ version: joinResponse.serverVersion,
466
+ region: joinResponse.serverRegion
467
+ };
468
+ }
469
+ _this2.log.info("connected to Livekit Server ".concat(Object.entries(serverInfo).map(_ref2 => {
470
+ let _ref3 = _slicedToArray(_ref2, 2),
471
+ key = _ref3[0],
472
+ value = _ref3[1];
473
+ return "".concat(key, ": ").concat(value);
474
+ }).join(', ')));
475
+ return {
476
+ joinResponse,
477
+ serverInfo
478
+ };
479
+ } catch (e) {
480
+ if (e instanceof ConnectionError) {
481
+ if (e.reason === ConnectionErrorReason.ServerUnreachable) {
482
+ _this2.log.warn("Couldn't connect to server, attempt ".concat(_this2.joinAttempts, " of ").concat(_this2.maxJoinAttempts));
483
+ if (_this2.joinAttempts < _this2.maxJoinAttempts) {
484
+ return _this2.join(url, token, opts, abortSignal, useV0Path);
485
+ }
486
+ } else if (e.reason === ConnectionErrorReason.ServiceNotFound) {
487
+ _this2.log.warn("Initial connection failed: ".concat(e.message, " \u2013 Retrying"));
488
+ if (_this2.pcManager) {
489
+ _this2.pcManager.onStateChange = undefined;
490
+ yield _this2.cleanupPeerConnections();
491
+ }
492
+ return _this2.join(url, token, opts, abortSignal, true);
493
+ }
494
+ }
495
+ throw e;
496
+ }
497
+ }();
498
+ });
499
+ }
500
+ /**
501
+ * @param reason why the session is ending, recorded by the signal lifecycle. Worth passing
502
+ * wherever the caller knows more than "someone called close" — the server's leave reason, or
503
+ * having given up on reconnecting.
504
+ */
505
+ close(reason) {
506
+ return __awaiter(this, void 0, void 0, function* () {
507
+ var _a, _b;
508
+ (_a = this.reconnectAbortController) === null || _a === void 0 ? void 0 : _a.abort();
509
+ this.reconnectAbortController = undefined;
510
+ (_b = this.restartAttemptController) === null || _b === void 0 ? void 0 : _b.abort();
511
+ this.restartAttemptController = undefined;
512
+ const unlock = yield this.closingLock.lock();
513
+ if (this.isClosed) {
514
+ unlock();
515
+ return;
516
+ }
517
+ try {
518
+ this._isClosed = true;
519
+ this.joinAttempts = 0;
520
+ this.joinStartedAt = undefined;
521
+ this.emit(EngineEvent.Closing);
522
+ this.removeAllListeners();
523
+ this.deregisterOnLineListener();
524
+ this.clearPendingReconnect();
525
+ this.clearLostQualityTimeout();
526
+ this.cleanupLossyDataStats();
527
+ yield this.cleanupPeerConnections();
528
+ yield this.cleanupClient(reason);
529
+ } finally {
530
+ unlock();
531
+ }
532
+ });
533
+ }
534
+ cleanupPeerConnections() {
535
+ return __awaiter(this, void 0, void 0, function* () {
536
+ var _a;
537
+ this.dataChannels.teardown();
538
+ yield (_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.close();
539
+ this.pcManager = undefined;
540
+ // the connecting timestamp belongs to the transports we just tore down
541
+ this.transportConnectingSince = undefined;
542
+ this.reliableReceivedState.clear();
543
+ });
544
+ }
545
+ cleanupLossyDataStats() {
546
+ this.lossyChannel.stopThresholdTuning();
547
+ }
548
+ cleanupClient(reason) {
549
+ return __awaiter(this, void 0, void 0, function* () {
550
+ yield this.client.close(true, reason);
551
+ this.client.resetCallbacks();
552
+ // Any in-flight addTrack requests are orphaned by the signal reconnect — the new session
553
+ // won't deliver `trackPublishedResponse` for them, so reject the pending resolvers and
554
+ // clear the map. Otherwise a subsequent `addTrack` call with the same client id (e.g. a
555
+ // publish retry after a `NegotiationError`) throws `TrackInvalidError`.
556
+ for (const cid of Object.keys(this.pendingTrackResolvers)) {
557
+ this.pendingTrackResolvers[cid].reject();
558
+ }
559
+ this.pendingTrackResolvers = {};
560
+ });
561
+ }
562
+ addTrack(req) {
563
+ if (this.pendingTrackResolvers[req.cid]) {
564
+ throw new TrackInvalidError('a track with the same ID has already been published');
565
+ }
566
+ return new Promise((resolve, reject) => {
567
+ const publicationTimeout = CriticalTimers.setTimeout(() => {
568
+ delete this.pendingTrackResolvers[req.cid];
569
+ reject(ConnectionError.timeout('publication of local track timed out, no response from server'));
570
+ }, 10000);
571
+ this.pendingTrackResolvers[req.cid] = {
572
+ resolve: info => {
573
+ CriticalTimers.clearTimeout(publicationTimeout);
574
+ resolve(info);
575
+ },
576
+ reject: () => {
577
+ CriticalTimers.clearTimeout(publicationTimeout);
578
+ reject(new Error('Cancelled publication by calling unpublish'));
579
+ }
580
+ };
581
+ this.client.sendAddTrack(req);
582
+ });
583
+ }
584
+ /**
585
+ * Removes sender from PeerConnection, returning true if it was removed successfully
586
+ * and a negotiation is necessary
587
+ * @param sender
588
+ * @returns
589
+ */
590
+ removeTrack(sender) {
591
+ if (sender.track && this.pendingTrackResolvers[sender.track.id]) {
592
+ const reject = this.pendingTrackResolvers[sender.track.id].reject;
593
+ if (reject) {
594
+ reject();
595
+ }
596
+ delete this.pendingTrackResolvers[sender.track.id];
597
+ }
598
+ try {
599
+ this.pcManager.removeTrack(sender);
600
+ return true;
601
+ } catch (e) {
602
+ this.log.warn('failed to remove track', {
603
+ error: e
604
+ });
605
+ }
606
+ return false;
607
+ }
608
+ updateMuteStatus(trackSid, muted) {
609
+ this.client.sendMuteTrack(trackSid, muted);
610
+ }
611
+ get dataSubscriberReadyState() {
612
+ var _a;
613
+ return (_a = this.dataChannelForKind(DataChannelKind.RELIABLE, true)) === null || _a === void 0 ? void 0 : _a.readyState;
614
+ }
615
+ getConnectedServerAddress() {
616
+ return __awaiter(this, void 0, void 0, function* () {
617
+ var _a;
618
+ return (_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.getConnectedAddress();
619
+ });
620
+ }
621
+ /* @internal */
622
+ setRegionStrategy(strategy) {
623
+ this.regionStrategy = strategy;
624
+ }
625
+ configure(joinResponse, useSinglePeerConnection) {
626
+ return __awaiter(this, void 0, void 0, function* () {
627
+ var _a;
628
+ // already configured
629
+ if (this.pcManager && this.pcManager.currentState !== PCTransportState.NEW) {
630
+ return;
631
+ }
632
+ if (!joinResponse) {
633
+ const rtcConfig = this.makeRTCConfiguration();
634
+ this.pcManager = new PCTransportManager('publisher-only', this.loggerOptions, {
635
+ rtcConfig,
636
+ peerConnectionTimeout: this.peerConnectionTimeout
637
+ });
638
+ } else {
639
+ this.participantSid = (_a = joinResponse.participant) === null || _a === void 0 ? void 0 : _a.sid;
640
+ const rtcConfig = this.makeRTCConfiguration(joinResponse);
641
+ this.pcManager = new PCTransportManager(useSinglePeerConnection ? 'publisher-only' : joinResponse.subscriberPrimary ? 'subscriber-primary' : 'publisher-primary', this.loggerOptions, {
642
+ rtcConfig,
643
+ peerConnectionTimeout: this.peerConnectionTimeout
644
+ });
645
+ }
646
+ this.emit(EngineEvent.TransportsCreated, this.pcManager.publisher, this.pcManager.subscriber);
647
+ this.pcManager.onIceCandidate = (candidate, target) => {
648
+ this.client.sendIceCandidate(candidate, target);
649
+ };
650
+ this.pcManager.onPublisherOffer = (offer, offerId) => {
651
+ this.client.sendOffer(offer, offerId);
652
+ };
653
+ this.pcManager.onDataChannel = this.handleDataChannel;
654
+ this.pcManager.onStateChange = (connectionState, publisherState, subscriberState) => __awaiter(this, void 0, void 0, function* () {
655
+ var _a;
656
+ this.log.debug("primary PC state changed ".concat(connectionState));
657
+ // Record when the primary transport actually entered CONNECTING so
658
+ // verifyTransport() can bound how long we tolerate it. Deriving it from the
659
+ // real transition (this handler only fires on state changes) rather than from
660
+ // observation time keeps it from going stale across peer-connection rebuilds.
661
+ if (connectionState === PCTransportState.CONNECTING) {
662
+ this.transportConnectingSince = Date.now();
663
+ } else {
664
+ this.transportConnectingSince = undefined;
665
+ }
666
+ if (['closed', 'disconnected', 'failed'].includes(publisherState)) {
667
+ // reset publisher connection promise
668
+ this.publisherConnectionPromise = undefined;
669
+ }
670
+ if (connectionState === PCTransportState.CONNECTED) {
671
+ if (this.joinStartedAt !== undefined) {
672
+ // Connection setup time is the only network signal there is before the first video
673
+ // offer. Set synchronously, so it is in place before `room.connect()` resolves and the
674
+ // app can publish. A full restart joins again and builds new transports, so it is
675
+ // measured again; a resume keeps its estimator and never restarts the timer.
676
+ const setupTimeMs = Math.round(performance.now() - this.joinStartedAt);
677
+ this.joinStartedAt = undefined;
678
+ this.log.info("connection setup took ".concat(setupTimeMs, " ms"));
679
+ (_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.publisher.setConnectionSetupTime(setupTimeMs);
680
+ }
681
+ const shouldEmit = this.pcState === PCState.New;
682
+ this.pcState = PCState.Connected;
683
+ if (shouldEmit) {
684
+ this.emit(EngineEvent.Connected, this.latestJoinResponse);
685
+ }
686
+ } else if (connectionState === PCTransportState.FAILED) {
687
+ // on Safari, PeerConnection will switch to 'disconnected' during renegotiation
688
+ if (this.pcState === PCState.Connected || this.pcState === PCState.Reconnecting) {
689
+ this.pcState = PCState.Disconnected;
690
+ this.handleDisconnect('peerconnection failed', subscriberState === 'failed' ? ReconnectReason.RR_SUBSCRIBER_FAILED : ReconnectReason.RR_PUBLISHER_FAILED);
691
+ }
692
+ }
693
+ // detect cases where both signal client and peer connection are severed and assume that user has lost network connection
694
+ const isSignalSevered = this.client.isDisconnected || this.client.currentState === SignalConnectionState.RECONNECTING;
695
+ const isPCSevered = [PCTransportState.FAILED, PCTransportState.CLOSING, PCTransportState.CLOSED].includes(connectionState);
696
+ if (isSignalSevered && isPCSevered && !this._isClosed) {
697
+ this.emit(EngineEvent.Offline);
698
+ }
699
+ });
700
+ this.pcManager.onTrack = ev => {
701
+ // this fires after the underlying transceiver is stopped and potentially
702
+ // peer connection closed, so do not bubble up if there are no streams
703
+ if (ev.streams.length === 0) return;
704
+ this.emit(EngineEvent.MediaTrackAdded, ev.track, ev.streams[0], ev.receiver);
705
+ };
706
+ });
707
+ }
708
+ setupSignalClientCallbacks() {
709
+ // configure signaling client
710
+ this.client.onAnswer = (sd, offerId, midToTrackId) => __awaiter(this, void 0, void 0, function* () {
711
+ if (!this.pcManager) {
712
+ return;
713
+ }
714
+ // an answer to an older offer is never applied by the publisher transport, so
715
+ // neither its mapping nor anything else in it may replace the current answer's state
716
+ if (this.pcManager.publisher.isStaleAnswer(offerId)) {
717
+ this.log.warn('ignoring answer for old offer', {
718
+ offerId,
719
+ latestOfferId: this.pcManager.publisher.latestOfferId
720
+ });
721
+ return;
722
+ }
723
+ this.log.debug('received server answer', {
724
+ RTCSdpType: sd.type,
725
+ sdp: sd.sdp,
726
+ midToTrackId
727
+ });
728
+ // in dual PC mode the publisher answer carries no mapping (the server's publisher
729
+ // transport has no sending tracks) and must not clobber the subscriber offer mapping.
730
+ // an empty mapping is decoded as `{}` and would wipe the current one as well, so it is
731
+ // ignored the same way the Rust SDK does
732
+ if (this.pcManager.mode === 'publisher-only' && Object.keys(midToTrackId).length > 0) {
733
+ this.midToTrackId = midToTrackId;
734
+ }
735
+ yield this.pcManager.setPublisherAnswer(sd, offerId);
736
+ this.emit(EngineEvent.RequestSubscribedCodecRefresh);
737
+ });
738
+ // add candidate on trickle
739
+ this.client.onTrickle = (candidate, target) => {
740
+ if (!this.pcManager) {
741
+ return;
742
+ }
743
+ this.log.debug('got ICE candidate from peer', {
744
+ candidate,
745
+ target
746
+ });
747
+ this.pcManager.addIceCandidate(candidate, target);
748
+ };
749
+ // when server creates an offer for the client
750
+ this.client.onOffer = (sd, offerId, midToTrackId) => __awaiter(this, void 0, void 0, function* () {
751
+ this.latestRemoteOfferId = offerId;
752
+ if (!this.pcManager) {
753
+ return;
754
+ }
755
+ this.midToTrackId = midToTrackId;
756
+ const answer = yield this.pcManager.createSubscriberAnswerFromOffer(sd, offerId);
757
+ if (answer) {
758
+ this.client.sendAnswer(answer, offerId);
759
+ }
760
+ });
761
+ this.client.onLocalTrackPublished = res => {
762
+ var _a;
763
+ this.log.debug('received trackPublishedResponse', {
764
+ cid: res.cid,
765
+ track: (_a = res.track) === null || _a === void 0 ? void 0 : _a.sid
766
+ });
767
+ if (!this.pendingTrackResolvers[res.cid]) {
768
+ this.log.error("missing track resolver for ".concat(res.cid), {
769
+ cid: res.cid
770
+ });
771
+ return;
772
+ }
773
+ const resolve = this.pendingTrackResolvers[res.cid].resolve;
774
+ delete this.pendingTrackResolvers[res.cid];
775
+ resolve(res.track);
776
+ };
777
+ this.client.onLocalTrackUnpublished = response => {
778
+ this.emit(EngineEvent.LocalTrackUnpublished, response);
779
+ };
780
+ this.client.onLocalTrackSubscribed = trackSid => {
781
+ this.emit(EngineEvent.LocalTrackSubscribed, trackSid);
782
+ };
783
+ this.client.onTokenRefresh = token => {
784
+ this.token = token;
785
+ this.emit(EngineEvent.TokenRefreshed, token);
786
+ };
787
+ this.client.onRemoteMuteChanged = (trackSid, muted) => {
788
+ this.emit(EngineEvent.RemoteMute, trackSid, muted);
789
+ };
790
+ this.client.onSubscribedQualityUpdate = update => {
791
+ this.emit(EngineEvent.SubscribedQualityUpdate, update);
792
+ };
793
+ this.client.onRoomMoved = res => {
794
+ var _a;
795
+ this.participantSid = (_a = res.participant) === null || _a === void 0 ? void 0 : _a.sid;
796
+ if (this.latestJoinResponse) {
797
+ this.latestJoinResponse.room = res.room;
798
+ }
799
+ this.emit(EngineEvent.RoomMoved, res);
800
+ };
801
+ this.client.onMediaSectionsRequirement = requirement => {
802
+ this.addMediaSections(requirement.numAudios, requirement.numVideos);
803
+ this.negotiate().catch(err => {
804
+ this.log.error(err);
805
+ });
806
+ };
807
+ this.client.onPublishDataTrackResponse = event => {
808
+ this.emit(EngineEvent.PublishDataTrackResponse, event);
809
+ };
810
+ this.client.onUnPublishDataTrackResponse = event => {
811
+ this.emit(EngineEvent.UnPublishDataTrackResponse, event);
812
+ };
813
+ this.client.onDataTrackSubscriberHandles = event => {
814
+ this.emit(EngineEvent.DataTrackSubscriberHandles, event);
815
+ };
816
+ this.client.onClose = () => {
817
+ this.handleDisconnect('signal', ReconnectReason.RR_SIGNAL_DISCONNECTED);
818
+ };
819
+ this.client.onLeave = leave => {
820
+ var _a;
821
+ this.log.info("client leave request received (action=".concat(leave === null || leave === void 0 ? void 0 : leave.action, ")"), {
822
+ reason: leave === null || leave === void 0 ? void 0 : leave.reason
823
+ });
824
+ if (leave.regions) {
825
+ this.log.debug('updating regions');
826
+ this.emit(EngineEvent.ServerRegionsReported, leave.regions);
827
+ }
828
+ switch (leave.action) {
829
+ case LeaveRequest_Action.DISCONNECT:
830
+ this.emit(EngineEvent.Disconnected, leave === null || leave === void 0 ? void 0 : leave.reason);
831
+ this.close("server leave: ".concat((_a = DisconnectReason[leave.reason]) !== null && _a !== void 0 ? _a : leave.reason));
832
+ break;
833
+ case LeaveRequest_Action.RECONNECT:
834
+ this.fullReconnectOnNext = true;
835
+ // reconnect immediately instead of waiting for next attempt
836
+ this.handleDisconnect(leaveReconnect);
837
+ break;
838
+ case LeaveRequest_Action.RESUME:
839
+ // reconnect immediately instead of waiting for next attempt
840
+ this.handleDisconnect(leaveReconnect);
841
+ }
842
+ };
843
+ }
844
+ makeRTCConfiguration(serverResponse) {
845
+ var _a;
846
+ const rtcConfig = Object.assign({}, this.rtcConfig);
847
+ // E2EE and packet trailer extraction both rely on encoded frame transforms.
848
+ // Only opt into the createEncodedStreams flavor when that path will be
849
+ // used; RTCRtpScriptTransform does not need the PeerConnection flag.
850
+ const needsInsertableStreams = ((_a = this.signalOpts) === null || _a === void 0 ? void 0 : _a.e2eeEnabled) || this.frameMetadataWorker && !shouldUseFrameMetadataScriptTransform();
851
+ if (needsInsertableStreams && isInsertableStreamSupported()) {
852
+ this.log.debug('E2EE - setting up transports with insertable streams');
853
+ // this makes sure that no data is sent before the transforms are ready
854
+ // @ts-ignore
855
+ rtcConfig.encodedInsertableStreams = true;
856
+ }
857
+ // @ts-ignore
858
+ rtcConfig.sdpSemantics = 'unified-plan';
859
+ // @ts-ignore
860
+ rtcConfig.continualGatheringPolicy = 'gather_continually';
861
+ if (!serverResponse) {
862
+ return rtcConfig;
863
+ }
864
+ // update ICE servers before creating PeerConnection
865
+ if (serverResponse.iceServers && !rtcConfig.iceServers) {
866
+ const rtcIceServers = [];
867
+ serverResponse.iceServers.forEach(iceServer => {
868
+ const rtcIceServer = {
869
+ urls: iceServer.urls
870
+ };
871
+ if (iceServer.username) rtcIceServer.username = iceServer.username;
872
+ if (iceServer.credential) {
873
+ rtcIceServer.credential = iceServer.credential;
874
+ }
875
+ rtcIceServers.push(rtcIceServer);
876
+ });
877
+ rtcConfig.iceServers = rtcIceServers;
878
+ }
879
+ if (serverResponse.clientConfiguration && serverResponse.clientConfiguration.forceRelay === ClientConfigSetting.ENABLED) {
880
+ rtcConfig.iceTransportPolicy = 'relay';
881
+ }
882
+ return rtcConfig;
883
+ }
884
+ /**
885
+ * Populate the publisher PC so its first offer carries the data channels + recvonly media
886
+ * sections. Required for every V1 connection: Firefox only binds receive decoders for media
887
+ * present in that first offer, and the offer-with-join path needs the sections to
888
+ * build a meaningful initial offer. Must be called on a configured pcManager.
889
+ */
890
+ applyInitialPublisherLayout(negotiatedDataChannels) {
891
+ this.createDataChannels(negotiatedDataChannels);
892
+ /**
893
+ * Native libwebrtc does not support pre-populating the media sections,
894
+ * so we skip it for React Native.
895
+ *
896
+ * Related: https://github.com/livekit/rust-sdks/pull/1151
897
+ */
898
+ if (!isReactNative()) {
899
+ this.addMediaSections(initialMediaSectionsAudio, initialMediaSectionsVideo);
900
+ }
901
+ }
902
+ addMediaSections(numAudios, numVideos) {
903
+ var _a, _b, _c;
904
+ const transceiverInit = {
905
+ direction: 'recvonly'
906
+ };
907
+ for (let i = 0; i < numAudios; i++) {
908
+ (_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.addPublisherTransceiverOfKind('audio', transceiverInit);
909
+ }
910
+ // media only arrives on these sections when there is no subscriber connection to arrive on
911
+ const receivesMedia = ((_b = this.pcManager) === null || _b === void 0 ? void 0 : _b.mode) === 'publisher-only';
912
+ for (let i = 0; i < numVideos; i++) {
913
+ const transceiver = (_c = this.pcManager) === null || _c === void 0 ? void 0 : _c.addPublisherTransceiverOfKind('video', transceiverInit);
914
+ if (receivesMedia && transceiver) {
915
+ const negotiated = negotiateDependencyDescriptor(transceiver);
916
+ this.log.debug('dependency descriptor negotiated for received video', {
917
+ negotiated
918
+ });
919
+ }
920
+ }
921
+ }
922
+ /**
923
+ * Whether to create the publisher data channels as negotiated (fixed SCTP stream IDs), which
924
+ * lets the server send on them without waiting for our DCEP OPEN. Only in single peer
925
+ * connection mode: with dual peer connections the server opens its own channels anyway.
926
+ */
927
+ useNegotiatedDataChannels() {
928
+ var _a, _b, _c, _d;
929
+ return ((_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.mode) === 'publisher-only' && ((_d = (_c = (_b = this.latestJoinResponse) === null || _b === void 0 ? void 0 : _b.serverInfo) === null || _c === void 0 ? void 0 : _c.protocol) !== null && _d !== void 0 ? _d : 0) >= PROTOCOL_NEGOTIATED_DATA_CHANNELS;
930
+ }
931
+ createDataChannels() {
932
+ let negotiated = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.useNegotiatedDataChannels();
933
+ if (!this.pcManager) {
934
+ return;
935
+ }
936
+ if (this.dataChannels.hasPublisherChannels) {
937
+ // Replacing live channels (the Safari null-id path in resumeConnection): the new ones start
938
+ // out connecting, so drop the memoized readiness check and make the next sender wait for
939
+ // them to open.
940
+ this.publisherConnectionPromise = undefined;
941
+ }
942
+ this.dataChannels.createPublisherChannels(this.pcManager, negotiated);
943
+ }
944
+ /** Normalizes an incoming data-channel message into bytes, or logs and returns undefined. */
945
+ decodeDataMessage(message) {
946
+ return __awaiter(this, void 0, void 0, function* () {
947
+ if (message.data instanceof ArrayBuffer) {
948
+ return new Uint8Array(message.data);
949
+ }
950
+ if (message.data instanceof Blob) {
951
+ return new Uint8Array(yield message.data.arrayBuffer());
952
+ }
953
+ this.log.error('unsupported data type', {
954
+ data: message.data
955
+ });
956
+ return undefined;
957
+ });
958
+ }
959
+ createSender(track, opts, encodings) {
960
+ return __awaiter(this, void 0, void 0, function* () {
961
+ let sender;
962
+ if (supportsTransceiver()) {
963
+ sender = yield this.createTransceiverRTCRtpSender(track, opts, encodings);
964
+ } else if (supportsAddTrack()) {
965
+ this.log.warn('using add-track fallback');
966
+ sender = yield this.createRTCRtpSender(track.mediaStreamTrack);
967
+ } else {
968
+ throw new UnexpectedConnectionState('Required webRTC APIs not supported on this device');
969
+ }
970
+ this.setupFrameMetadataSender(sender, opts);
971
+ return sender;
972
+ });
973
+ }
974
+ createSimulcastSender(track, simulcastTrack, opts, encodings) {
975
+ return __awaiter(this, void 0, void 0, function* () {
976
+ let sender;
977
+ if (supportsTransceiver()) {
978
+ sender = yield this.createSimulcastTransceiverSender(track, simulcastTrack, opts, encodings);
979
+ } else if (supportsAddTrack()) {
980
+ this.log.debug('using add-track fallback');
981
+ sender = yield this.createRTCRtpSender(track.mediaStreamTrack);
982
+ } else {
983
+ throw new UnexpectedConnectionState('Cannot stream on this device');
984
+ }
985
+ if (sender) {
986
+ this.setupFrameMetadataSender(sender, opts);
987
+ }
988
+ return sender;
989
+ });
990
+ }
991
+ get frameMetadataWorker() {
992
+ var _a;
993
+ return (_a = this.frameMetadataOptions) === null || _a === void 0 ? void 0 : _a.worker;
994
+ }
995
+ setupFrameMetadataSender(sender) {
996
+ let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
997
+ var _a;
998
+ const worker = this.frameMetadataWorker;
999
+ if (!worker || ((_a = this.signalOpts) === null || _a === void 0 ? void 0 : _a.e2eeEnabled)) {
1000
+ return;
1001
+ }
1002
+ const frameMetadata = getPublishFrameMetadata(opts);
1003
+ const hasMetadata = hasFrameMetadataPublishOptions(frameMetadata);
1004
+ if (shouldUseFrameMetadataScriptTransform()) {
1005
+ if (hasMetadata) {
1006
+ // @ts-ignore
1007
+ sender.transform = new RTCRtpScriptTransform(worker, {
1008
+ kind: 'encode',
1009
+ packetTrailer: frameMetadata
1010
+ });
1011
+ }
1012
+ return;
1013
+ }
1014
+ if (!isFrameMetadataSupported(this.frameMetadataOptions) || !('createEncodedStreams' in sender)) {
1015
+ if (hasMetadata) {
1016
+ this.log.warn('frame metadata transform not supported; skipping write', this.logContext);
1017
+ }
1018
+ return;
1019
+ }
1020
+ // @ts-ignore
1021
+ const _sender$createEncoded = sender.createEncodedStreams(),
1022
+ readable = _sender$createEncoded.readable,
1023
+ writable = _sender$createEncoded.writable;
1024
+ if (hasMetadata) {
1025
+ worker.postMessage({
1026
+ kind: 'encode',
1027
+ data: {
1028
+ readableStream: readable,
1029
+ writableStream: writable,
1030
+ packetTrailer: frameMetadata
1031
+ }
1032
+ }, [readable, writable]);
1033
+ } else {
1034
+ readable.pipeTo(writable);
1035
+ }
1036
+ }
1037
+ createTransceiverRTCRtpSender(track, opts, encodings) {
1038
+ return __awaiter(this, void 0, void 0, function* () {
1039
+ if (!this.pcManager) {
1040
+ throw new UnexpectedConnectionState('publisher is closed');
1041
+ }
1042
+ const streams = [];
1043
+ if (track.mediaStream) {
1044
+ streams.push(track.mediaStream);
1045
+ }
1046
+ if (isVideoTrack(track)) {
1047
+ track.codec = opts.videoCodec;
1048
+ }
1049
+ const transceiverInit = {
1050
+ direction: 'sendonly',
1051
+ streams
1052
+ };
1053
+ if (encodings) {
1054
+ transceiverInit.sendEncodings = encodings;
1055
+ }
1056
+ // addTransceiver for react-native is async. web is synchronous, but await won't effect it.
1057
+ const transceiver = yield this.pcManager.addPublisherTransceiver(track.mediaStreamTrack, transceiverInit);
1058
+ return transceiver.sender;
1059
+ });
1060
+ }
1061
+ createSimulcastTransceiverSender(track, simulcastTrack, opts, encodings) {
1062
+ return __awaiter(this, void 0, void 0, function* () {
1063
+ if (!this.pcManager) {
1064
+ throw new UnexpectedConnectionState('publisher is closed');
1065
+ }
1066
+ const transceiverInit = {
1067
+ direction: 'sendonly'
1068
+ };
1069
+ if (encodings) {
1070
+ transceiverInit.sendEncodings = encodings;
1071
+ }
1072
+ // addTransceiver for react-native is async. web is synchronous, but await won't effect it.
1073
+ const transceiver = yield this.pcManager.addPublisherTransceiver(simulcastTrack.mediaStreamTrack, transceiverInit);
1074
+ if (!opts.videoCodec) {
1075
+ return;
1076
+ }
1077
+ yield track.setSimulcastTrackSender(opts.videoCodec, transceiver.sender);
1078
+ return transceiver.sender;
1079
+ });
1080
+ }
1081
+ createRTCRtpSender(track) {
1082
+ return __awaiter(this, void 0, void 0, function* () {
1083
+ if (!this.pcManager) {
1084
+ throw new UnexpectedConnectionState('publisher is closed');
1085
+ }
1086
+ return this.pcManager.addPublisherTrack(track);
1087
+ });
1088
+ }
1089
+ /**
1090
+ * A sustained local `LOST` while connected and publishing means the server isn't receiving
1091
+ * our media, so force a full reconnect; any non-`LOST` value cancels a pending trigger.
1092
+ */
1093
+ handleLocalConnectionQuality(update) {
1094
+ if (!this.participantSid) {
1095
+ return;
1096
+ }
1097
+ const localUpdate = update.updates.find(u => u.participantSid === this.participantSid);
1098
+ if (!localUpdate) {
1099
+ return;
1100
+ }
1101
+ if (localUpdate.quality === ConnectionQuality.LOST) {
1102
+ this.scheduleLostQualityReconnect();
1103
+ } else {
1104
+ this.clearLostQualityTimeout();
1105
+ }
1106
+ }
1107
+ scheduleLostQualityReconnect() {
1108
+ if (this.lostQualityTimeout) {
1109
+ // already counting down towards a reconnect
1110
+ return;
1111
+ }
1112
+ this.lostQualityTimeout = CriticalTimers.setTimeout(() => {
1113
+ this.lostQualityTimeout = undefined;
1114
+ if (this._isClosed || this.pcState !== PCState.Connected || this.attemptingReconnect) {
1115
+ return;
1116
+ }
1117
+ if (!this.hasActivePublisherSenders()) {
1118
+ return;
1119
+ }
1120
+ this.log.warn('local connection quality lost while publishing, triggering full reconnect', this.logContext);
1121
+ this.fullReconnectOnNext = true;
1122
+ this.handleDisconnect('connection quality lost', ReconnectReason.RR_PUBLISHER_FAILED);
1123
+ }, connectionQualityLostTimeout);
1124
+ }
1125
+ clearLostQualityTimeout() {
1126
+ if (this.lostQualityTimeout) {
1127
+ CriticalTimers.clearTimeout(this.lostQualityTimeout);
1128
+ this.lostQualityTimeout = undefined;
1129
+ }
1130
+ }
1131
+ /** Whether the publisher currently has any sender with a live track. */
1132
+ hasActivePublisherSenders() {
1133
+ var _a, _b;
1134
+ return (_b = (_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.publisher.getSenders().some(sender => !!sender.track && sender.track.readyState === 'live')) !== null && _b !== void 0 ? _b : false;
1135
+ }
1136
+ /**
1137
+ * Forces a full reconnect while keeping the engine (and its saved credentials) alive. Used by
1138
+ * Room's connection-reconcile safety net when the transport silently died but we looked connected.
1139
+ * @internal
1140
+ */
1141
+ reconnect() {
1142
+ let reason = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ReconnectReason.RR_UNKNOWN;
1143
+ this.fullReconnectOnNext = true;
1144
+ this.handleDisconnect('reconcile', reason);
1145
+ }
1146
+ attemptReconnect(reason) {
1147
+ return __awaiter(this, void 0, void 0, function* () {
1148
+ var _a, _b, _c;
1149
+ if (this._isClosed) {
1150
+ return;
1151
+ }
1152
+ // guard for attempting reconnection multiple times while one attempt is still not finished
1153
+ if (this.attemptingReconnect) {
1154
+ this.log.warn('already attempting reconnect, returning early');
1155
+ return;
1156
+ }
1157
+ // A pending Lost-quality countdown belongs to the session we're now leaving; cancel it so
1158
+ // it can't fire against the reconnected session before the server has evaluated it. (A resume
1159
+ // keeps the peer connections, so cleanupPeerConnections wouldn't cover this path.)
1160
+ this.clearLostQualityTimeout();
1161
+ if (((_a = this.clientConfiguration) === null || _a === void 0 ? void 0 : _a.resumeConnection) === ClientConfigSetting.DISABLED ||
1162
+ // signaling state could change to closed due to hardware sleep
1163
+ // those connections cannot be resumed
1164
+ ((_c = (_b = this.pcManager) === null || _b === void 0 ? void 0 : _b.currentState) !== null && _c !== void 0 ? _c : PCTransportState.NEW) === PCTransportState.NEW) {
1165
+ this.fullReconnectOnNext = true;
1166
+ }
1167
+ // Consume the flag up front: capture whether this attempt is a full reconnect, then reset
1168
+ // it. From here on a `true` value unambiguously represents a *new* full-reconnect request
1169
+ // that arrived while this attempt was running (e.g. a server RECONNECT leave), which the
1170
+ // finally block dispatches — for both the resume and full-reconnect paths.
1171
+ const fullReconnect = this.fullReconnectOnNext;
1172
+ this.fullReconnectOnNext = false;
1173
+ let succeeded = false;
1174
+ const abortController = new AbortController();
1175
+ this.reconnectAbortController = abortController;
1176
+ try {
1177
+ this.attemptingReconnect = true;
1178
+ if (fullReconnect) {
1179
+ yield this.restartConnection(abortController.signal);
1180
+ } else {
1181
+ yield this.resumeConnection(reason);
1182
+ }
1183
+ if (abortController.signal.aborted) {
1184
+ this.log.info('reconnect attempt cancelled, not marking it as succeeded');
1185
+ return;
1186
+ }
1187
+ this.clearPendingReconnect();
1188
+ succeeded = true;
1189
+ } catch (e) {
1190
+ if (abortController.signal.aborted) {
1191
+ this.log.info('reconnect attempt cancelled, not retrying', {
1192
+ error: e
1193
+ });
1194
+ return;
1195
+ }
1196
+ this.reconnectAttempts += 1;
1197
+ let recoverable = true;
1198
+ if (e instanceof UnexpectedConnectionState) {
1199
+ this.log.debug('received unrecoverable error', {
1200
+ error: e
1201
+ });
1202
+ // unrecoverable
1203
+ recoverable = false;
1204
+ } else if (fullReconnect || !(e instanceof SignalReconnectError)) {
1205
+ // a failed full reconnect stays a full reconnect; a failed resume can only be
1206
+ // resumed again for a signal-level error, otherwise it escalates
1207
+ this.fullReconnectOnNext = true;
1208
+ }
1209
+ if (recoverable) {
1210
+ this.handleDisconnect('reconnect', ReconnectReason.RR_UNKNOWN);
1211
+ } else {
1212
+ this.log.info("could not recover connection after ".concat(this.reconnectAttempts, " attempts, ").concat(Date.now() - this.reconnectStart, "ms. giving up"));
1213
+ this.emit(EngineEvent.Disconnected);
1214
+ yield this.close("gave up reconnecting after ".concat(this.reconnectAttempts, " attempts, ").concat(Date.now() - this.reconnectStart, "ms"));
1215
+ }
1216
+ } finally {
1217
+ // close() may already have cleared this (or a later attempt replaced it); only release our own
1218
+ if (this.reconnectAbortController === abortController) {
1219
+ this.reconnectAbortController = undefined;
1220
+ }
1221
+ this.attemptingReconnect = false;
1222
+ // A full reconnect requested while this attempt was running (e.g. a `RECONNECT` leave
1223
+ // during a resume or a restart) that a successful attempt didn't act on; dispatch it now
1224
+ // (the failure path already retries).
1225
+ if (succeeded && this.fullReconnectOnNext && !this._isClosed) {
1226
+ this.log.debug('full reconnect requested during in-progress attempt, dispatching');
1227
+ this.handleDisconnect('reconnect');
1228
+ }
1229
+ }
1230
+ });
1231
+ }
1232
+ getNextRetryDelay(context) {
1233
+ try {
1234
+ return this.reconnectPolicy.nextRetryDelayInMs(context);
1235
+ } catch (e) {
1236
+ this.log.warn('encountered error in reconnect policy', {
1237
+ error: e
1238
+ });
1239
+ }
1240
+ // error in user code with provided reconnect policy, stop reconnecting
1241
+ return null;
1242
+ }
1243
+ restartConnection(abortSignal, regionUrl) {
1244
+ return __awaiter(this, void 0, void 0, function* () {
1245
+ var _a, _b, _c, _d;
1246
+ try {
1247
+ if (abortSignal.aborted) {
1248
+ this.log.info('full reconnect cancelled before starting', {
1249
+ regionUrl
1250
+ });
1251
+ return;
1252
+ }
1253
+ if (!this.url || !this.token) {
1254
+ // permanent failure, don't attempt reconnection
1255
+ throw new UnexpectedConnectionState('could not reconnect, url or token not saved');
1256
+ }
1257
+ this.log.info("reconnecting, attempt: ".concat(this.reconnectAttempts));
1258
+ (_a = this.restartAttemptController) === null || _a === void 0 ? void 0 : _a.abort();
1259
+ const restartAttempt = new AbortController();
1260
+ this.restartAttemptController = restartAttempt;
1261
+ this.emit(EngineEvent.Restarting);
1262
+ if (!this.client.isDisconnected) {
1263
+ yield this.client.sendLeave();
1264
+ }
1265
+ yield this.cleanupPeerConnections();
1266
+ yield this.cleanupClient();
1267
+ if (abortSignal.aborted) {
1268
+ this.log.info('full reconnect cancelled after cleaning up the previous session', {
1269
+ regionUrl
1270
+ });
1271
+ return;
1272
+ }
1273
+ let joinResponse;
1274
+ try {
1275
+ if (!this.signalOpts) {
1276
+ this.log.warn('attempted connection restart, without signal options present');
1277
+ throw new SignalReconnectError();
1278
+ }
1279
+ // in case a regionUrl is passed, the region URL takes precedence
1280
+ joinResponse = (yield this.join(regionUrl !== null && regionUrl !== void 0 ? regionUrl : this.url, this.token, this.signalOpts, abortSignal, !this.options.singlePeerConnection)).joinResponse;
1281
+ } catch (e) {
1282
+ if (e instanceof ConnectionError && e.reason === ConnectionErrorReason.NotAllowed) {
1283
+ throw new UnexpectedConnectionState('could not reconnect, token might be expired');
1284
+ }
1285
+ throw new SignalReconnectError();
1286
+ }
1287
+ if (abortSignal.aborted) {
1288
+ this.log.info('full reconnect cancelled after the signal join response', {
1289
+ regionUrl
1290
+ });
1291
+ return;
1292
+ }
1293
+ if (this.shouldFailNext) {
1294
+ this.shouldFailNext = false;
1295
+ throw new Error('simulated failure');
1296
+ }
1297
+ this.client.setReconnected();
1298
+ this.emit(EngineEvent.SignalRestarted, joinResponse, restartAttempt.signal);
1299
+ yield this.waitForPCReconnected();
1300
+ if (abortSignal.aborted) {
1301
+ this.log.info('full reconnect cancelled after peer connections reconnected', {
1302
+ regionUrl
1303
+ });
1304
+ return;
1305
+ }
1306
+ // re-check signal connection state before setting engine as resumed
1307
+ if (this.client.currentState !== SignalConnectionState.CONNECTED) {
1308
+ throw new SignalReconnectError('Signal connection got severed during reconnect');
1309
+ }
1310
+ (_b = this.regionStrategy) === null || _b === void 0 ? void 0 : _b.resetAttempts();
1311
+ // reconnect success
1312
+ this.emit(EngineEvent.Restarted);
1313
+ } catch (error) {
1314
+ if (abortSignal.aborted) {
1315
+ this.log.info('full reconnect cancelled after a failed attempt', {
1316
+ regionUrl
1317
+ });
1318
+ return;
1319
+ }
1320
+ const nextRegionUrl = yield (_c = this.regionStrategy) === null || _c === void 0 ? void 0 : _c.getNextUrl(abortSignal);
1321
+ if (abortSignal.aborted) {
1322
+ this.log.info('full reconnect cancelled during region selection', {
1323
+ regionUrl
1324
+ });
1325
+ return;
1326
+ }
1327
+ if (nextRegionUrl) {
1328
+ yield this.restartConnection(abortSignal, nextRegionUrl);
1329
+ return;
1330
+ } else {
1331
+ // no more regions to try (or we're not on cloud)
1332
+ (_d = this.regionStrategy) === null || _d === void 0 ? void 0 : _d.resetAttempts();
1333
+ throw error;
1334
+ }
1335
+ }
1336
+ });
1337
+ }
1338
+ resumeConnection(reason) {
1339
+ return __awaiter(this, void 0, void 0, function* () {
1340
+ if (!this.url || !this.token) {
1341
+ // permanent failure, don't attempt reconnection
1342
+ throw new UnexpectedConnectionState('could not reconnect, url or token not saved');
1343
+ }
1344
+ // trigger publisher reconnect
1345
+ if (!this.pcManager) {
1346
+ throw new UnexpectedConnectionState('publisher and subscriber connections unset');
1347
+ }
1348
+ this.log.info("resuming signal connection, attempt ".concat(this.reconnectAttempts));
1349
+ this.emit(EngineEvent.Resuming);
1350
+ let res;
1351
+ try {
1352
+ this.setupSignalClientCallbacks();
1353
+ res = yield this.client.reconnect(this.url, this.token, this.participantSid, reason);
1354
+ } catch (error) {
1355
+ let message = '';
1356
+ if (error instanceof Error) {
1357
+ message = error.message;
1358
+ this.log.error(error.message, {
1359
+ error
1360
+ });
1361
+ }
1362
+ if (error instanceof ConnectionError && error.reason === ConnectionErrorReason.NotAllowed) {
1363
+ throw new UnexpectedConnectionState('could not reconnect, token might be expired');
1364
+ }
1365
+ if (error instanceof ConnectionError && error.reason === ConnectionErrorReason.LeaveRequest) {
1366
+ throw error;
1367
+ }
1368
+ throw new SignalReconnectError(message);
1369
+ }
1370
+ this.emit(EngineEvent.SignalResumed);
1371
+ if (res) {
1372
+ const rtcConfig = this.makeRTCConfiguration(res);
1373
+ this.pcManager.updateConfiguration(rtcConfig);
1374
+ if (this.latestJoinResponse) {
1375
+ this.latestJoinResponse.serverInfo = res.serverInfo;
1376
+ }
1377
+ } else {
1378
+ this.log.warn('Did not receive reconnect response');
1379
+ }
1380
+ if (this.shouldFailNext) {
1381
+ this.shouldFailNext = false;
1382
+ throw new Error('simulated failure');
1383
+ }
1384
+ yield this.pcManager.triggerIceRestart();
1385
+ yield this.waitForPCReconnected();
1386
+ // re-check signal connection state before setting engine as resumed
1387
+ if (this.client.currentState !== SignalConnectionState.CONNECTED) {
1388
+ throw new SignalReconnectError('Signal connection got severed during reconnect');
1389
+ }
1390
+ this.client.setReconnected();
1391
+ // recreate publish datachannel if it's id is null
1392
+ // (for safari https://bugs.webkit.org/show_bug.cgi?id=184688)
1393
+ const reliableDC = this.dataChannelForKind(DataChannelKind.RELIABLE);
1394
+ if ((reliableDC === null || reliableDC === void 0 ? void 0 : reliableDC.readyState) === 'open' && reliableDC.id === null) {
1395
+ this.createDataChannels();
1396
+ }
1397
+ if (res === null || res === void 0 ? void 0 : res.lastMessageSeq) {
1398
+ this.resendReliableMessagesForResume(res.lastMessageSeq).catch(error => {
1399
+ this.log.warn('failed to resend reliable messages after resume', Object.assign(Object.assign({}, this.logContext), {
1400
+ error
1401
+ }));
1402
+ });
1403
+ }
1404
+ // resume success
1405
+ this.emit(EngineEvent.Resumed);
1406
+ });
1407
+ }
1408
+ waitForPCInitialConnection(timeout, abortController) {
1409
+ return __awaiter(this, void 0, void 0, function* () {
1410
+ if (!this.pcManager) {
1411
+ throw new UnexpectedConnectionState('PC manager is closed');
1412
+ }
1413
+ // A full reconnect during the initial connection replaces the transports polled below, so its
1414
+ // `Restarted` completes the initial connection too. The engine closing (e.g. giving up) fails it.
1415
+ let restarting = false;
1416
+ const onRestarting = () => {
1417
+ restarting = true;
1418
+ };
1419
+ let onRestarted;
1420
+ let onClosing;
1421
+ let onAbort;
1422
+ let deadline;
1423
+ const engineOutcome = new Promise((resolve, reject) => {
1424
+ onRestarted = resolve;
1425
+ onClosing = () => reject(ConnectionError.internal('could not establish pc connection'));
1426
+ onAbort = () => reject(ConnectionError.cancelled('room connection has been cancelled'));
1427
+ this.once(EngineEvent.Restarted, onRestarted);
1428
+ this.once(EngineEvent.Closing, onClosing);
1429
+ // The transport wait below enforces these too, but not once it has resolved.
1430
+ abortController === null || abortController === void 0 ? void 0 : abortController.signal.addEventListener('abort', onAbort);
1431
+ deadline = CriticalTimers.setTimeout(onClosing, timeout !== null && timeout !== void 0 ? timeout : this.peerConnectionTimeout);
1432
+ });
1433
+ this.once(EngineEvent.Restarting, onRestarting);
1434
+ try {
1435
+ yield Promise.race([this.pcManager.ensurePCTransportConnection(abortController, timeout), engineOutcome]);
1436
+ if (restarting) {
1437
+ // Transports that connected once a restart had begun are about to be closed; follow it.
1438
+ yield engineOutcome;
1439
+ }
1440
+ } finally {
1441
+ CriticalTimers.clearTimeout(deadline);
1442
+ abortController === null || abortController === void 0 ? void 0 : abortController.signal.removeEventListener('abort', onAbort);
1443
+ this.off(EngineEvent.Restarting, onRestarting);
1444
+ this.off(EngineEvent.Restarted, onRestarted);
1445
+ this.off(EngineEvent.Closing, onClosing);
1446
+ }
1447
+ });
1448
+ }
1449
+ waitForPCReconnected() {
1450
+ return __awaiter(this, void 0, void 0, function* () {
1451
+ this.pcState = PCState.Reconnecting;
1452
+ this.log.debug('waiting for peer connection to reconnect');
1453
+ try {
1454
+ yield sleep(minReconnectWait); // FIXME setTimeout again not ideal for a connection critical path
1455
+ if (!this.pcManager) {
1456
+ throw new UnexpectedConnectionState('PC manager is closed');
1457
+ }
1458
+ yield this.pcManager.ensurePCTransportConnection(undefined, this.peerConnectionTimeout);
1459
+ this.pcState = PCState.Connected;
1460
+ } catch (e) {
1461
+ // TODO do we need a `failed` state here for the PC?
1462
+ this.pcState = PCState.Disconnected;
1463
+ throw ConnectionError.internal("could not establish PC connection, ".concat(e.message));
1464
+ }
1465
+ });
1466
+ }
1467
+ /** @internal */
1468
+ publishRpcAck(destinationIdentity, requestId) {
1469
+ return __awaiter(this, void 0, void 0, function* () {
1470
+ const packet = new DataPacket({
1471
+ destinationIdentities: [destinationIdentity],
1472
+ kind: DataPacket_Kind.RELIABLE,
1473
+ value: {
1474
+ case: 'rpcAck',
1475
+ value: new RpcAck({
1476
+ requestId
1477
+ })
1478
+ }
1479
+ });
1480
+ yield this.sendDataPacket(packet, DataChannelKind.RELIABLE);
1481
+ });
1482
+ }
1483
+ /* @internal */
1484
+ sendDataPacket(packet, /** Data-track frames don't come through here — they're sent pre-serialized via {@link sendDataTrackFrame }. */
1485
+ kind) {
1486
+ return __awaiter(this, void 0, void 0, function* () {
1487
+ var _a, _b;
1488
+ // make sure we do have a data connection
1489
+ yield this.ensurePublisherConnected(kind);
1490
+ if (this.e2eeManager && this.e2eeManager.isDataChannelEncryptionEnabled) {
1491
+ const encryptablePacket = asEncryptablePacket(packet);
1492
+ if (encryptablePacket) {
1493
+ const encryptedData = yield this.e2eeManager.encryptData(encryptablePacket.toBinary());
1494
+ packet.value = {
1495
+ case: 'encryptedPacket',
1496
+ value: new EncryptedPacket({
1497
+ encryptedValue: encryptedData.payload,
1498
+ iv: encryptedData.iv,
1499
+ keyIndex: encryptedData.keyIndex
1500
+ })
1501
+ };
1502
+ }
1503
+ }
1504
+ if (kind === DataChannelKind.RELIABLE) {
1505
+ packet.sequence = this.reliableChannel.nextSequence();
1506
+ }
1507
+ const msg = packet.toBinary();
1508
+ // Clamp to the SDK default - libwebrtc advertises larger (~256 KiB)
1509
+ // than LiveKit/pion can deliver end-to-end (~64 KiB), so we trust
1510
+ // the answer up untilthe built in ceiling.
1511
+ const maxPublisherMessageSizeBytes = Math.min((_b = (_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.getMaxPublisherMessageSize()) !== null && _b !== void 0 ? _b : DEFAULT_MAX_MESSAGE_SIZE, DEFAULT_MAX_MESSAGE_SIZE);
1512
+ if (typeof maxPublisherMessageSizeBytes !== 'undefined' && maxPublisherMessageSizeBytes !== 0 /* 0 means "no limit" */ && msg.byteLength > maxPublisherMessageSizeBytes) {
1513
+ throw new PublishDataError("cannot publish data packet larger than ".concat(maxPublisherMessageSizeBytes, " bytes (got ").concat(msg.byteLength, ")"));
1514
+ }
1515
+ // The full-buffer policy (drop for lossy, wait/replay for reliable) is the channel's own, as
1516
+ // is emitting the buffer-status change once the send settles.
1517
+ if (kind === DataChannelKind.RELIABLE) {
1518
+ yield this.reliableChannel.send(msg, packet.sequence);
1519
+ } else {
1520
+ yield this.lossyChannel.send(msg);
1521
+ }
1522
+ });
1523
+ }
1524
+ /**
1525
+ * Sends pre-serialized bytes on the data-track channel. This is the one send path that doesn't
1526
+ * go through {@link sendDataPacket} — Room's `packetAvailable` handler calls it directly with
1527
+ * bytes the data-track pipeline already serialized.
1528
+ *
1529
+ * @internal
1530
+ */
1531
+ sendDataTrackFrame(bytes) {
1532
+ return __awaiter(this, void 0, void 0, function* () {
1533
+ // Make sure we do have a data connection: on lazily negotiated publisher connections this is
1534
+ // what kicks negotiation off, and it waits for the channel to open. Memoized, so the
1535
+ // steady-state cost is one await on an already-resolved promise.
1536
+ yield this.ensurePublisherConnected(DataChannelKind.DATA_TRACK_LOSSY);
1537
+ yield this.dataTrackChannel.send(bytes);
1538
+ });
1539
+ }
1540
+ resendReliableMessagesForResume(lastMessageSeq) {
1541
+ return __awaiter(this, void 0, void 0, function* () {
1542
+ yield this.ensurePublisherConnected(DataChannelKind.RELIABLE);
1543
+ yield this.reliableChannel.replay(lastMessageSeq);
1544
+ });
1545
+ }
1546
+ /** The flow-control gate for `kind` — see {@link FlowControlledDataChannel}. */
1547
+ flowControlFor(kind) {
1548
+ return this.dataChannels.channelFor(kind);
1549
+ }
1550
+ /**
1551
+ * Resolves once the caller may send on the `kind` channel — see
1552
+ * {@link FlowControlledDataChannel.waitForHeadroomWithLock}.
1553
+ */
1554
+ waitForBufferHeadroom(kind) {
1555
+ return __awaiter(this, void 0, void 0, function* () {
1556
+ const dc = this.dataChannelForKind(kind);
1557
+ if (!dc) {
1558
+ throw new UnexpectedConnectionState("DataChannel not found, kind: ".concat(kind));
1559
+ }
1560
+ return this.flowControlFor(kind).waitForHeadroomWithLock(dc);
1561
+ });
1562
+ }
1563
+ /**
1564
+ * @internal
1565
+ */
1566
+ ensureDataTransportConnected(kind_1) {
1567
+ return __awaiter(this, arguments, void 0, function (kind) {
1568
+ var _this3 = this;
1569
+ let subscriber = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.subscriberPrimary;
1570
+ return function* () {
1571
+ var _a;
1572
+ if (!_this3.pcManager) {
1573
+ throw new UnexpectedConnectionState('PC manager is closed');
1574
+ }
1575
+ const transport = subscriber ? _this3.pcManager.subscriber : _this3.pcManager.publisher;
1576
+ const transportName = subscriber ? 'Subscriber' : 'Publisher';
1577
+ if (!transport) {
1578
+ throw ConnectionError.internal("".concat(transportName, " connection not set"));
1579
+ }
1580
+ let needNegotiation = false;
1581
+ if (!subscriber && !_this3.dataChannelForKind(kind, subscriber)) {
1582
+ _this3.createDataChannels();
1583
+ needNegotiation = true;
1584
+ }
1585
+ if (!needNegotiation && !subscriber && !_this3.pcManager.publisher.isICEConnected && _this3.pcManager.publisher.getICEConnectionState() !== 'checking') {
1586
+ needNegotiation = true;
1587
+ }
1588
+ if (needNegotiation) {
1589
+ // start negotiation
1590
+ _this3.negotiate().catch(err => {
1591
+ _this3.log.error(err);
1592
+ });
1593
+ }
1594
+ const targetChannel = _this3.dataChannelForKind(kind, subscriber);
1595
+ if ((targetChannel === null || targetChannel === void 0 ? void 0 : targetChannel.readyState) === 'open') {
1596
+ return;
1597
+ }
1598
+ // wait until ICE connected
1599
+ const endTime = new Date().getTime() + _this3.peerConnectionTimeout;
1600
+ while (new Date().getTime() < endTime) {
1601
+ if (transport.isICEConnected && ((_a = _this3.dataChannelForKind(kind, subscriber)) === null || _a === void 0 ? void 0 : _a.readyState) === 'open') {
1602
+ return;
1603
+ }
1604
+ yield sleep(50);
1605
+ }
1606
+ throw ConnectionError.internal("could not establish ".concat(transportName, " connection, state: ").concat(transport.getICEConnectionState()));
1607
+ }();
1608
+ });
1609
+ }
1610
+ ensurePublisherConnected(kind) {
1611
+ return __awaiter(this, void 0, void 0, function* () {
1612
+ if (!this.publisherConnectionPromise) {
1613
+ this.publisherConnectionPromise = this.ensureDataTransportConnected(kind, false);
1614
+ }
1615
+ yield this.publisherConnectionPromise;
1616
+ });
1617
+ }
1618
+ /* @internal */
1619
+ verifyTransport() {
1620
+ if (!this.pcManager) {
1621
+ return false;
1622
+ }
1623
+ const state = this.pcManager.currentState;
1624
+ const allowedConnectionStates = [PCTransportState.CONNECTING, PCTransportState.CONNECTED];
1625
+ if (!allowedConnectionStates.includes(state)) {
1626
+ return false;
1627
+ }
1628
+ // ensure signal is connected
1629
+ if (!this.client.ws || this.client.ws.readyState === WebSocket.CLOSED) {
1630
+ return false;
1631
+ }
1632
+ // A transport stuck in CONNECTING never reaches CONNECTED nor reports FAILED, so it would
1633
+ // otherwise look healthy forever; bound how long we tolerate it. The entry time is recorded
1634
+ // in the pcManager state-change handler (see configure()), so this is a pure read — an
1635
+ // unrecorded CONNECTING fails open rather than measuring against a stale timestamp.
1636
+ if (state === PCTransportState.CONNECTING && this.transportConnectingSince !== undefined && Date.now() - this.transportConnectingSince > this.peerConnectionTimeout) {
1637
+ this.log.warn('transport stuck in connecting state', this.logContext);
1638
+ return false;
1639
+ }
1640
+ return true;
1641
+ }
1642
+ /** @internal */
1643
+ negotiate() {
1644
+ return __awaiter(this, void 0, void 0, function* () {
1645
+ // observe signal state
1646
+ return new TypedPromise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
1647
+ if (!this.pcManager) {
1648
+ reject(new NegotiationError('PC manager is closed'));
1649
+ return;
1650
+ }
1651
+ this.pcManager.requirePublisher();
1652
+ // don't negotiate without any transceivers or data channel, it will generate sdp without ice frag then negotiate failed
1653
+ if (this.pcManager.publisher.getTransceivers().length == 0 && !this.dataChannels.hasPublisherChannels) {
1654
+ this.createDataChannels();
1655
+ }
1656
+ const abortController = new AbortController();
1657
+ const handleClosed = () => {
1658
+ abortController.abort();
1659
+ this.log.debug('engine disconnected while negotiation was ongoing');
1660
+ resolve();
1661
+ return;
1662
+ };
1663
+ if (this.isClosed) {
1664
+ reject(new NegotiationError('cannot negotiate on closed engine'));
1665
+ }
1666
+ this.pendingNegotiationAborts.add(handleClosed);
1667
+ this.pcManager.publisher.off(PCEvents.RTPVideoPayloadTypes, this.onRtpMapAvailable);
1668
+ this.pcManager.publisher.once(PCEvents.RTPVideoPayloadTypes, this.onRtpMapAvailable);
1669
+ try {
1670
+ yield this.pcManager.negotiate(abortController);
1671
+ resolve();
1672
+ } catch (e) {
1673
+ if (abortController.signal.aborted) {
1674
+ // negotiation was aborted due to engine close or restart, resolve
1675
+ // cleanly to avoid triggering a cascading reconnect loop
1676
+ resolve();
1677
+ return;
1678
+ }
1679
+ if (e instanceof NegotiationError) {
1680
+ this.fullReconnectOnNext = true;
1681
+ }
1682
+ this.handleDisconnect('negotiation', ReconnectReason.RR_UNKNOWN);
1683
+ if (e instanceof Error) {
1684
+ reject(e);
1685
+ } else {
1686
+ reject(new Error(String(e)));
1687
+ }
1688
+ } finally {
1689
+ this.pendingNegotiationAborts.delete(handleClosed);
1690
+ }
1691
+ }));
1692
+ });
1693
+ }
1694
+ dataChannelForKind(kind, sub) {
1695
+ return this.dataChannels.getHandle(kind, sub);
1696
+ }
1697
+ /** @internal */
1698
+ sendSyncState(remoteTracks, localTracks, publishDataTracks) {
1699
+ var _a, _b, _c, _d;
1700
+ if (!this.pcManager) {
1701
+ this.log.warn('sync state cannot be sent without peer connection setup');
1702
+ return;
1703
+ }
1704
+ const previousPublisherOffer = this.pcManager.publisher.getLocalDescription();
1705
+ const previousPublisherAnswer = this.pcManager.publisher.getRemoteDescription();
1706
+ const previousSubscriberOffer = (_a = this.pcManager.subscriber) === null || _a === void 0 ? void 0 : _a.getRemoteDescription();
1707
+ const previousSubscriberAnswer = (_b = this.pcManager.subscriber) === null || _b === void 0 ? void 0 : _b.getLocalDescription();
1708
+ /* 1. autosubscribe on, so subscribed tracks = all tracks - unsub tracks,
1709
+ in this case, we send unsub tracks, so server add all tracks to this
1710
+ subscribe pc and unsub special tracks from it.
1711
+ 2. autosubscribe off, we send subscribed tracks.
1712
+ */
1713
+ const autoSubscribe = (_d = (_c = this.signalOpts) === null || _c === void 0 ? void 0 : _c.autoSubscribe) !== null && _d !== void 0 ? _d : true;
1714
+ const trackSids = new Array();
1715
+ const trackSidsDisabled = new Array();
1716
+ remoteTracks.forEach(track => {
1717
+ if (track.isDesired !== autoSubscribe) {
1718
+ trackSids.push(track.trackSid);
1719
+ }
1720
+ if (!track.isEnabled) {
1721
+ trackSidsDisabled.push(track.trackSid);
1722
+ }
1723
+ });
1724
+ this.client.sendSyncState(new SyncState({
1725
+ answer: this.pcManager.mode === 'publisher-only' ? previousPublisherAnswer ? toProtoSessionDescription({
1726
+ sdp: previousPublisherAnswer.sdp,
1727
+ type: previousPublisherAnswer.type
1728
+ }) : undefined : previousSubscriberAnswer ? toProtoSessionDescription({
1729
+ sdp: previousSubscriberAnswer.sdp,
1730
+ type: previousSubscriberAnswer.type
1731
+ }) : undefined,
1732
+ offer: this.pcManager.mode === 'publisher-only' ? previousPublisherOffer ? toProtoSessionDescription({
1733
+ sdp: previousPublisherOffer.sdp,
1734
+ type: previousPublisherOffer.type
1735
+ }) : undefined : previousSubscriberOffer ? toProtoSessionDescription({
1736
+ sdp: previousSubscriberOffer.sdp,
1737
+ type: previousSubscriberOffer.type
1738
+ }) : undefined,
1739
+ subscription: new UpdateSubscription({
1740
+ trackSids,
1741
+ subscribe: !autoSubscribe,
1742
+ participantTracks: []
1743
+ }),
1744
+ publishTracks: getTrackPublicationInfo(localTracks),
1745
+ dataChannels: this.dataChannelsInfo(),
1746
+ trackSidsDisabled,
1747
+ datachannelReceiveStates: this.reliableReceivedState.map((seq, sid) => {
1748
+ return new DataChannelReceiveState({
1749
+ publisherSid: sid,
1750
+ lastSeq: seq
1751
+ });
1752
+ }),
1753
+ publishDataTracks
1754
+ }));
1755
+ }
1756
+ /* @internal */
1757
+ failNext() {
1758
+ // debugging method to fail the next reconnect/resume attempt
1759
+ this.shouldFailNext = true;
1760
+ }
1761
+ /* @internal */
1762
+ failNextV1Path() {
1763
+ // debugging method to fail the next connection attempt for /rtc/v1 to trigger the fallback version
1764
+ this.shouldFailOnV1Path = true;
1765
+ }
1766
+ dataChannelsInfo() {
1767
+ const infos = [];
1768
+ const getInfo = (dc, target) => {
1769
+ if ((dc === null || dc === void 0 ? void 0 : dc.id) !== undefined && dc.id !== null) {
1770
+ infos.push(new DataChannelInfo({
1771
+ label: dc.label,
1772
+ id: dc.id,
1773
+ target
1774
+ }));
1775
+ }
1776
+ };
1777
+ getInfo(this.dataChannelForKind(DataChannelKind.LOSSY), SignalTarget.PUBLISHER);
1778
+ getInfo(this.dataChannelForKind(DataChannelKind.RELIABLE), SignalTarget.PUBLISHER);
1779
+ getInfo(this.dataChannelForKind(DataChannelKind.LOSSY, true), SignalTarget.SUBSCRIBER);
1780
+ getInfo(this.dataChannelForKind(DataChannelKind.RELIABLE, true), SignalTarget.SUBSCRIBER);
1781
+ getInfo(this.dataChannelForKind(DataChannelKind.DATA_TRACK_LOSSY), SignalTarget.PUBLISHER);
1782
+ getInfo(this.dataChannelForKind(DataChannelKind.DATA_TRACK_LOSSY, true), SignalTarget.SUBSCRIBER);
1783
+ return infos;
1784
+ }
1785
+ clearReconnectTimeout() {
1786
+ if (this.reconnectTimeout) {
1787
+ CriticalTimers.clearTimeout(this.reconnectTimeout);
1788
+ // `pendingReconnect` is derived from this handle, so it must not outlive the timer
1789
+ this.reconnectTimeout = undefined;
1790
+ }
1791
+ }
1792
+ clearPendingReconnect() {
1793
+ this.clearReconnectTimeout();
1794
+ this.reconnectAttempts = 0;
1795
+ }
1796
+ registerOnLineListener() {
1797
+ if (isWeb()) {
1798
+ window.addEventListener('online', this.handleBrowserOnLine);
1799
+ window.addEventListener('offline', this.handleBrowserOffline);
1800
+ }
1801
+ }
1802
+ deregisterOnLineListener() {
1803
+ if (isWeb()) {
1804
+ window.removeEventListener('online', this.handleBrowserOnLine);
1805
+ window.removeEventListener('offline', this.handleBrowserOffline);
1806
+ }
1807
+ }
1808
+ getTrackIdForReceiver(receiver) {
1809
+ var _a, _b;
1810
+ const mid = (_b = (_a = this.pcManager) === null || _a === void 0 ? void 0 : _a.getTransceiverForReceiver(receiver)) === null || _b === void 0 ? void 0 : _b.mid;
1811
+ if (mid) {
1812
+ const match = Object.entries(this.midToTrackId).find(_ref4 => {
1813
+ let _ref5 = _slicedToArray(_ref4, 1),
1814
+ key = _ref5[0];
1815
+ return key === mid;
1816
+ });
1817
+ if (match) {
1818
+ return match[1];
1819
+ }
1820
+ }
1821
+ }
1822
+ }
1823
+ function applyUserDataCompat(newObj, oldObj) {
1824
+ const participantIdentity = newObj.participantIdentity ? newObj.participantIdentity : oldObj.participantIdentity;
1825
+ newObj.participantIdentity = participantIdentity;
1826
+ oldObj.participantIdentity = participantIdentity;
1827
+ const destinationIdentities = newObj.destinationIdentities.length !== 0 ? newObj.destinationIdentities : oldObj.destinationIdentities;
1828
+ newObj.destinationIdentities = destinationIdentities;
1829
+ oldObj.destinationIdentities = destinationIdentities;
1830
+ }export{DataChannelKind,RTCEngine as default};//# sourceMappingURL=RTCEngine.mjs.map