livekit-client 2.23.0 → 2.24.1

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 (879) hide show
  1. package/README.md +47 -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 +1214 -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 +600 -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 +234 -0
  167. package/dist/core/room/rpc/client/RpcClientManager.mjs.map +1 -0
  168. package/dist/core/room/rpc/extension.mjs +83 -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 +150 -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 +855 -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 +90 -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 +77 -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 +90 -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 +77 -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 +163 -134
  535. package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
  536. package/dist/livekit-client.esm.mjs +31589 -30883
  537. package/dist/livekit-client.esm.mjs.map +1 -1
  538. package/dist/livekit-client.fm.worker.js +1 -1
  539. package/dist/livekit-client.fm.worker.js.map +1 -1
  540. package/dist/livekit-client.fm.worker.mjs +21 -82
  541. package/dist/livekit-client.fm.worker.mjs.map +1 -1
  542. package/dist/livekit-client.umd.js +1 -1
  543. package/dist/livekit-client.umd.js.map +1 -1
  544. package/dist/src/api/SignalClient.d.ts +1 -1
  545. package/dist/src/api/SignalClient.d.ts.map +1 -1
  546. package/dist/src/api/WebSocketStream.d.ts.map +1 -1
  547. package/dist/src/connectionHelper/checks/Checker.d.ts +7 -4
  548. package/dist/src/connectionHelper/checks/Checker.d.ts.map +1 -1
  549. package/dist/src/core.d.ts +33 -0
  550. package/dist/src/core.d.ts.map +1 -0
  551. package/dist/src/e2ee/E2eeManager.d.ts +26 -5
  552. package/dist/src/e2ee/E2eeManager.d.ts.map +1 -1
  553. package/dist/src/e2ee/KeyProvider.d.ts.map +1 -1
  554. package/dist/src/e2ee/extension.d.ts +19 -0
  555. package/dist/src/e2ee/extension.d.ts.map +1 -0
  556. package/dist/src/e2ee/types.d.ts +14 -0
  557. package/dist/src/e2ee/types.d.ts.map +1 -1
  558. package/dist/src/e2ee/utils.d.ts +6 -1
  559. package/dist/src/e2ee/utils.d.ts.map +1 -1
  560. package/dist/src/e2ee/worker/FrameCryptor.d.ts +7 -1
  561. package/dist/src/e2ee/worker/FrameCryptor.d.ts.map +1 -1
  562. package/dist/src/e2ee/worker/naluUtils.d.ts +7 -0
  563. package/dist/src/e2ee/worker/naluUtils.d.ts.map +1 -1
  564. package/dist/src/e2ee/worker/sifPayload.d.ts +1 -1
  565. package/dist/src/e2ee/worker/sifPayload.d.ts.map +1 -1
  566. package/dist/src/exports.d.ts +76 -0
  567. package/dist/src/exports.d.ts.map +1 -0
  568. package/dist/src/frameMetadata/FrameMetadataManager.d.ts +5 -2
  569. package/dist/src/frameMetadata/FrameMetadataManager.d.ts.map +1 -1
  570. package/dist/src/frameMetadata/extension.d.ts +11 -0
  571. package/dist/src/frameMetadata/extension.d.ts.map +1 -0
  572. package/dist/src/frameMetadata/utils.d.ts +5 -0
  573. package/dist/src/frameMetadata/utils.d.ts.map +1 -1
  574. package/dist/src/index.d.ts +35 -63
  575. package/dist/src/index.d.ts.map +1 -1
  576. package/dist/src/logger.d.ts +1 -3
  577. package/dist/src/logger.d.ts.map +1 -1
  578. package/dist/src/options.d.ts +20 -6
  579. package/dist/src/options.d.ts.map +1 -1
  580. package/dist/src/room/CoreRoom.d.ts +392 -0
  581. package/dist/src/room/CoreRoom.d.ts.map +1 -0
  582. package/dist/src/room/PCTransport.d.ts +5 -2
  583. package/dist/src/room/PCTransport.d.ts.map +1 -1
  584. package/dist/src/room/PCTransportManager.d.ts +8 -4
  585. package/dist/src/room/PCTransportManager.d.ts.map +1 -1
  586. package/dist/src/room/RTCEngine.d.ts +23 -6
  587. package/dist/src/room/RTCEngine.d.ts.map +1 -1
  588. package/dist/src/room/Room.d.ts +5 -403
  589. package/dist/src/room/Room.d.ts.map +1 -1
  590. package/dist/src/room/chat/extension.d.ts +22 -0
  591. package/dist/src/room/chat/extension.d.ts.map +1 -0
  592. package/dist/src/room/createRoom.d.ts +19 -0
  593. package/dist/src/room/createRoom.d.ts.map +1 -0
  594. package/dist/src/room/data-channel/DataChannelManager.d.ts +7 -1
  595. package/dist/src/room/data-channel/DataChannelManager.d.ts.map +1 -1
  596. package/dist/src/room/data-stream/constants.d.ts +9 -0
  597. package/dist/src/room/data-stream/constants.d.ts.map +1 -1
  598. package/dist/src/room/data-stream/extension.d.ts +73 -0
  599. package/dist/src/room/data-stream/extension.d.ts.map +1 -0
  600. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  601. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts.map +1 -1
  602. package/dist/src/room/data-stream/incoming/StreamReader.d.ts.map +1 -1
  603. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  604. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts.map +1 -1
  605. package/dist/src/room/data-track/LocalDataTrack.d.ts +1 -1
  606. package/dist/src/room/data-track/depacketizer.d.ts +1 -1
  607. package/dist/src/room/data-track/depacketizer.d.ts.map +1 -1
  608. package/dist/src/room/data-track/extension.d.ts +31 -0
  609. package/dist/src/room/data-track/extension.d.ts.map +1 -0
  610. package/dist/src/room/data-track/handle.d.ts +1 -1
  611. package/dist/src/room/data-track/handle.d.ts.map +1 -1
  612. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  613. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts.map +1 -1
  614. package/dist/src/room/data-track/incoming/pipeline.d.ts +1 -1
  615. package/dist/src/room/data-track/incoming/pipeline.d.ts.map +1 -1
  616. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  617. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts.map +1 -1
  618. package/dist/src/room/data-track/outgoing/pipeline.d.ts +1 -1
  619. package/dist/src/room/data-track/outgoing/pipeline.d.ts.map +1 -1
  620. package/dist/src/room/data-track/packet/extensions.d.ts +1 -1
  621. package/dist/src/room/data-track/packet/extensions.d.ts.map +1 -1
  622. package/dist/src/room/data-track/packet/index.d.ts +1 -1
  623. package/dist/src/room/data-track/packet/index.d.ts.map +1 -1
  624. package/dist/src/room/data-track/packet/serializable.d.ts +1 -1
  625. package/dist/src/room/data-track/packet/serializable.d.ts.map +1 -1
  626. package/dist/src/room/data-track/packetizer.d.ts +1 -1
  627. package/dist/src/room/data-track/packetizer.d.ts.map +1 -1
  628. package/dist/src/room/data-track/track-interfaces.d.ts +1 -1
  629. package/dist/src/room/data-track/track-interfaces.d.ts.map +1 -1
  630. package/dist/src/room/data-track/utils.d.ts +1 -1
  631. package/dist/src/room/defaults.d.ts +1 -2
  632. package/dist/src/room/defaults.d.ts.map +1 -1
  633. package/dist/src/room/extensions.d.ts +208 -0
  634. package/dist/src/room/extensions.d.ts.map +1 -0
  635. package/dist/src/room/participant/LocalParticipant.d.ts +45 -120
  636. package/dist/src/room/participant/LocalParticipant.d.ts.map +1 -1
  637. package/dist/src/room/participant/Participant.d.ts +8 -1
  638. package/dist/src/room/participant/Participant.d.ts.map +1 -1
  639. package/dist/src/room/participant/RemoteParticipant.d.ts +3 -3
  640. package/dist/src/room/participant/RemoteParticipant.d.ts.map +1 -1
  641. package/dist/src/room/participant/publishUtils.d.ts.map +1 -1
  642. package/dist/src/room/rpc/client/RpcClientManager.d.ts +5 -0
  643. package/dist/src/room/rpc/client/RpcClientManager.d.ts.map +1 -1
  644. package/dist/src/room/rpc/extension.d.ts +70 -0
  645. package/dist/src/room/rpc/extension.d.ts.map +1 -0
  646. package/dist/src/room/rpc/index.d.ts +1 -1
  647. package/dist/src/room/rpc/index.d.ts.map +1 -1
  648. package/dist/src/room/rpc/legacyExtension.d.ts +34 -0
  649. package/dist/src/room/rpc/legacyExtension.d.ts.map +1 -0
  650. package/dist/src/room/rpc/utils.d.ts +1 -0
  651. package/dist/src/room/rpc/utils.d.ts.map +1 -1
  652. package/dist/src/room/simulated-participants/extension.d.ts +25 -0
  653. package/dist/src/room/simulated-participants/extension.d.ts.map +1 -0
  654. package/dist/src/room/token-source/TokenSource.d.ts +5 -1
  655. package/dist/src/room/token-source/TokenSource.d.ts.map +1 -1
  656. package/dist/src/room/token-source/utils.d.ts.map +1 -1
  657. package/dist/src/room/track/LocalTrack.d.ts +1 -1
  658. package/dist/src/room/track/LocalTrack.d.ts.map +1 -1
  659. package/dist/src/room/track/LocalVideoTrack.d.ts.map +1 -1
  660. package/dist/src/room/track/RemoteTrackPublication.d.ts +14 -1
  661. package/dist/src/room/track/RemoteTrackPublication.d.ts.map +1 -1
  662. package/dist/src/room/track/Track.d.ts.map +1 -1
  663. package/dist/src/room/track/TrackPublication.d.ts +2 -2
  664. package/dist/src/room/track/TrackPublication.d.ts.map +1 -1
  665. package/dist/src/room/track/create.d.ts +15 -13
  666. package/dist/src/room/track/create.d.ts.map +1 -1
  667. package/dist/src/room/track/facingMode.d.ts.map +1 -1
  668. package/dist/src/room/track/options.d.ts +0 -6
  669. package/dist/src/room/track/options.d.ts.map +1 -1
  670. package/dist/src/room/track/processor/types.d.ts +2 -2
  671. package/dist/src/room/track/processor/types.d.ts.map +1 -1
  672. package/dist/src/room/track/utils.d.ts +1 -1
  673. package/dist/src/room/track/utils.d.ts.map +1 -1
  674. package/dist/src/room/utils.d.ts +2 -2
  675. package/dist/src/room/utils.d.ts.map +1 -1
  676. package/dist/src/room/video/create.d.ts +28 -0
  677. package/dist/src/room/video/create.d.ts.map +1 -0
  678. package/dist/src/room/video/extension.d.ts +48 -0
  679. package/dist/src/room/video/extension.d.ts.map +1 -0
  680. package/dist/src/room/video/publisher.d.ts +24 -0
  681. package/dist/src/room/video/publisher.d.ts.map +1 -0
  682. package/dist/src/test/MockMediaStream.d.ts +6 -0
  683. package/dist/src/test/MockMediaStream.d.ts.map +1 -0
  684. package/dist/src/utils/browserParser.d.ts +0 -3
  685. package/dist/src/utils/browserParser.d.ts.map +1 -1
  686. package/dist/src/utils/deferrable-map.d.ts +1 -1
  687. package/dist/src/utils/deferrable-map.d.ts.map +1 -1
  688. package/dist/src/utils/serializer.d.ts.map +1 -1
  689. package/dist/src/utils/throws.d.ts +10 -0
  690. package/dist/src/utils/throws.d.ts.map +1 -0
  691. package/dist/src/version.d.ts +4 -1
  692. package/dist/src/version.d.ts.map +1 -1
  693. package/dist/ts4.2/connectionHelper/checks/Checker.d.ts +7 -4
  694. package/dist/ts4.2/core.d.ts +34 -0
  695. package/dist/ts4.2/e2ee/E2eeManager.d.ts +26 -5
  696. package/dist/ts4.2/e2ee/extension.d.ts +20 -0
  697. package/dist/ts4.2/e2ee/types.d.ts +14 -0
  698. package/dist/ts4.2/e2ee/utils.d.ts +6 -1
  699. package/dist/ts4.2/e2ee/worker/FrameCryptor.d.ts +7 -1
  700. package/dist/ts4.2/e2ee/worker/naluUtils.d.ts +7 -0
  701. package/dist/ts4.2/e2ee/worker/sifPayload.d.ts +1 -1
  702. package/dist/ts4.2/exports.d.ts +83 -0
  703. package/dist/ts4.2/frameMetadata/FrameMetadataManager.d.ts +5 -2
  704. package/dist/ts4.2/frameMetadata/extension.d.ts +13 -0
  705. package/dist/ts4.2/frameMetadata/utils.d.ts +5 -0
  706. package/dist/ts4.2/index.d.ts +35 -69
  707. package/dist/ts4.2/logger.d.ts +1 -3
  708. package/dist/ts4.2/options.d.ts +20 -6
  709. package/dist/ts4.2/room/CoreRoom.d.ts +381 -0
  710. package/dist/ts4.2/room/PCTransport.d.ts +5 -2
  711. package/dist/ts4.2/room/PCTransportManager.d.ts +8 -4
  712. package/dist/ts4.2/room/RTCEngine.d.ts +23 -6
  713. package/dist/ts4.2/room/Room.d.ts +6 -392
  714. package/dist/ts4.2/room/chat/extension.d.ts +22 -0
  715. package/dist/ts4.2/room/createRoom.d.ts +20 -0
  716. package/dist/ts4.2/room/data-channel/DataChannelManager.d.ts +6 -1
  717. package/dist/ts4.2/room/data-stream/constants.d.ts +9 -0
  718. package/dist/ts4.2/room/data-stream/extension.d.ts +74 -0
  719. package/dist/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  720. package/dist/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  721. package/dist/ts4.2/room/data-track/LocalDataTrack.d.ts +1 -1
  722. package/dist/ts4.2/room/data-track/depacketizer.d.ts +1 -1
  723. package/dist/ts4.2/room/data-track/extension.d.ts +31 -0
  724. package/dist/ts4.2/room/data-track/handle.d.ts +1 -1
  725. package/dist/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  726. package/dist/ts4.2/room/data-track/incoming/pipeline.d.ts +1 -1
  727. package/dist/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  728. package/dist/ts4.2/room/data-track/outgoing/pipeline.d.ts +1 -1
  729. package/dist/ts4.2/room/data-track/packet/extensions.d.ts +1 -1
  730. package/dist/ts4.2/room/data-track/packet/index.d.ts +1 -1
  731. package/dist/ts4.2/room/data-track/packet/serializable.d.ts +1 -1
  732. package/dist/ts4.2/room/data-track/packetizer.d.ts +1 -1
  733. package/dist/ts4.2/room/data-track/track-interfaces.d.ts +1 -1
  734. package/dist/ts4.2/room/data-track/utils.d.ts +1 -1
  735. package/dist/ts4.2/room/defaults.d.ts +1 -2
  736. package/dist/ts4.2/room/extensions.d.ts +214 -0
  737. package/dist/ts4.2/room/participant/LocalParticipant.d.ts +44 -121
  738. package/dist/ts4.2/room/participant/Participant.d.ts +8 -1
  739. package/dist/ts4.2/room/participant/RemoteParticipant.d.ts +3 -3
  740. package/dist/ts4.2/room/rpc/client/RpcClientManager.d.ts +5 -0
  741. package/dist/ts4.2/room/rpc/extension.d.ts +74 -0
  742. package/dist/ts4.2/room/rpc/index.d.ts +1 -1
  743. package/dist/ts4.2/room/rpc/legacyExtension.d.ts +39 -0
  744. package/dist/ts4.2/room/rpc/utils.d.ts +1 -0
  745. package/dist/ts4.2/room/simulated-participants/extension.d.ts +25 -0
  746. package/dist/ts4.2/room/token-source/TokenSource.d.ts +5 -1
  747. package/dist/ts4.2/room/track/LocalTrack.d.ts +1 -1
  748. package/dist/ts4.2/room/track/RemoteTrackPublication.d.ts +3 -1
  749. package/dist/ts4.2/room/track/TrackPublication.d.ts +2 -2
  750. package/dist/ts4.2/room/track/create.d.ts +15 -13
  751. package/dist/ts4.2/room/track/options.d.ts +0 -6
  752. package/dist/ts4.2/room/track/processor/types.d.ts +2 -2
  753. package/dist/ts4.2/room/track/utils.d.ts +1 -1
  754. package/dist/ts4.2/room/utils.d.ts +2 -2
  755. package/dist/ts4.2/room/video/create.d.ts +28 -0
  756. package/dist/ts4.2/room/video/extension.d.ts +48 -0
  757. package/dist/ts4.2/room/video/publisher.d.ts +24 -0
  758. package/dist/ts4.2/test/MockMediaStream.d.ts +6 -0
  759. package/dist/ts4.2/utils/browserParser.d.ts +0 -3
  760. package/dist/ts4.2/utils/deferrable-map.d.ts +1 -1
  761. package/dist/ts4.2/utils/throws.d.ts +10 -0
  762. package/dist/ts4.2/version.d.ts +4 -1
  763. package/package.json +24 -9
  764. package/src/api/SignalClient.test.ts +150 -0
  765. package/src/api/SignalClient.ts +19 -4
  766. package/src/api/WebSocketStream.test.ts +67 -0
  767. package/src/api/WebSocketStream.ts +41 -3
  768. package/src/connectionHelper/checks/Checker.ts +12 -5
  769. package/src/connectionHelper/checks/publishVideo.ts +1 -1
  770. package/src/connectionHelper/checks/reconnect.ts +1 -1
  771. package/src/core.ts +35 -0
  772. package/src/e2ee/E2eeManager.test.ts +156 -3
  773. package/src/e2ee/E2eeManager.ts +64 -41
  774. package/src/e2ee/KeyProvider.ts +2 -1
  775. package/src/e2ee/extension.ts +113 -0
  776. package/src/e2ee/subscriberBlackScreen.test.ts +9 -12
  777. package/src/e2ee/types.ts +14 -0
  778. package/src/e2ee/utils.test.ts +47 -0
  779. package/src/e2ee/utils.ts +26 -14
  780. package/src/e2ee/worker/DataCryptor.test.ts +42 -1
  781. package/src/e2ee/worker/DataCryptor.ts +2 -2
  782. package/src/e2ee/worker/FrameCryptor.race.test.ts +3 -7
  783. package/src/e2ee/worker/FrameCryptor.test.ts +94 -13
  784. package/src/e2ee/worker/FrameCryptor.ts +85 -22
  785. package/src/e2ee/worker/e2ee.worker.test.ts +151 -0
  786. package/src/e2ee/worker/e2ee.worker.ts +28 -20
  787. package/src/e2ee/worker/naluUtils.test.ts +21 -1
  788. package/src/e2ee/worker/naluUtils.ts +30 -0
  789. package/src/e2ee/worker/sifPayload.ts +1 -1
  790. package/src/exports.ts +224 -0
  791. package/src/frameMetadata/FrameMetadataManager.ts +9 -3
  792. package/src/frameMetadata/extension.ts +34 -0
  793. package/src/frameMetadata/frameMetadata.ts +1 -1
  794. package/src/frameMetadata/utils.ts +23 -0
  795. package/src/index.ts +47 -189
  796. package/src/logger.ts +1 -3
  797. package/src/options.ts +25 -6
  798. package/src/room/CoreRoom.ts +3017 -0
  799. package/src/room/DeviceManager.test.ts +55 -1
  800. package/src/room/DeviceManager.ts +1 -1
  801. package/src/room/PCTransport.test.ts +43 -0
  802. package/src/room/PCTransport.ts +22 -22
  803. package/src/room/PCTransportManager.test.ts +65 -3
  804. package/src/room/PCTransportManager.ts +28 -12
  805. package/src/room/RTCEngine.test.ts +421 -21
  806. package/src/room/RTCEngine.ts +138 -34
  807. package/src/room/RegionUrlProvider.ts +1 -1
  808. package/src/room/Room.test.ts +741 -4
  809. package/src/room/Room.ts +34 -3317
  810. package/src/room/chat/extension.ts +78 -0
  811. package/src/room/createRoom.test.ts +149 -0
  812. package/src/room/createRoom.ts +26 -0
  813. package/src/room/data-channel/DataChannelManager.test.ts +37 -0
  814. package/src/room/data-channel/DataChannelManager.ts +21 -3
  815. package/src/room/data-stream/constants.ts +10 -0
  816. package/src/room/data-stream/extension.ts +162 -0
  817. package/src/room/data-stream/incoming/IncomingDataStreamManager.test.ts +269 -3
  818. package/src/room/data-stream/incoming/IncomingDataStreamManager.ts +53 -2
  819. package/src/room/data-stream/incoming/StreamReader.ts +14 -4
  820. package/src/room/data-stream/outgoing/OutgoingDataStreamManager.ts +1 -2
  821. package/src/room/data-track/depacketizer.ts +2 -2
  822. package/src/room/data-track/extension.ts +244 -0
  823. package/src/room/data-track/handle.ts +1 -1
  824. package/src/room/data-track/incoming/IncomingDataTrackManager.ts +2 -2
  825. package/src/room/data-track/incoming/pipeline.ts +2 -2
  826. package/src/room/data-track/outgoing/OutgoingDataTrackManager.test.ts +42 -3
  827. package/src/room/data-track/outgoing/OutgoingDataTrackManager.ts +5 -3
  828. package/src/room/data-track/outgoing/pipeline.ts +1 -1
  829. package/src/room/data-track/packet/extensions.ts +1 -1
  830. package/src/room/data-track/packet/index.ts +1 -1
  831. package/src/room/data-track/packet/serializable.ts +1 -1
  832. package/src/room/data-track/packetizer.ts +1 -1
  833. package/src/room/data-track/track-interfaces.ts +4 -4
  834. package/src/room/data-track/utils.ts +1 -1
  835. package/src/room/defaults.ts +3 -16
  836. package/src/room/extensions.ts +310 -0
  837. package/src/room/participant/LocalParticipant.test.ts +23 -6
  838. package/src/room/participant/LocalParticipant.ts +92 -669
  839. package/src/room/participant/Participant.test.ts +60 -0
  840. package/src/room/participant/Participant.ts +21 -1
  841. package/src/room/participant/RemoteParticipant.ts +3 -8
  842. package/src/room/participant/publishUtils.ts +3 -3
  843. package/src/room/participant/restartOnDefaultAudioDevice.test.ts +1 -1
  844. package/src/room/rpc/client/RpcClientManager.test.ts +29 -0
  845. package/src/room/rpc/client/RpcClientManager.ts +17 -0
  846. package/src/room/rpc/extension.ts +162 -0
  847. package/src/room/rpc/index.ts +1 -10
  848. package/src/room/rpc/legacyExtension.ts +36 -0
  849. package/src/room/rpc/utils.ts +2 -0
  850. package/src/room/simulated-participants/extension.ts +189 -0
  851. package/src/room/token-source/TokenSource.test.ts +29 -0
  852. package/src/room/token-source/TokenSource.ts +8 -3
  853. package/src/room/token-source/utils.test.ts +34 -0
  854. package/src/room/token-source/utils.ts +23 -1
  855. package/src/room/track/LocalTrack.ts +18 -10
  856. package/src/room/track/LocalVideoTrack.test.ts +66 -2
  857. package/src/room/track/LocalVideoTrack.ts +5 -3
  858. package/src/room/track/RemoteTrackPublication.ts +14 -1
  859. package/src/room/track/RemoteVideoTrack.test.ts +2 -0
  860. package/src/room/track/Track.test.ts +102 -0
  861. package/src/room/track/Track.ts +8 -1
  862. package/src/room/track/TrackPublication.ts +2 -2
  863. package/src/room/track/create.ts +59 -71
  864. package/src/room/track/facingMode.ts +5 -2
  865. package/src/room/track/options.ts +26 -34
  866. package/src/room/track/processor/types.ts +2 -2
  867. package/src/room/track/utils.ts +5 -1
  868. package/src/room/utils.test.ts +36 -1
  869. package/src/room/utils.ts +13 -3
  870. package/src/room/video/create.ts +95 -0
  871. package/src/room/video/extension.ts +115 -0
  872. package/src/room/video/publisher.ts +472 -0
  873. package/src/test/MockMediaStream.ts +13 -0
  874. package/src/utils/browserParser.ts +0 -3
  875. package/src/utils/deferrable-map.test.ts +60 -0
  876. package/src/utils/deferrable-map.ts +7 -4
  877. package/src/utils/serializer.ts +1 -1
  878. package/src/utils/throws.ts +15 -0
  879. package/src/version.ts +6 -1
@@ -0,0 +1,1214 @@
1
+ import {__awaiter}from'tslib';import {Mutex}from'@livekit/mutex';import {TrickleRequest,MuteTrackRequest,UpdateParticipantMetadata,UpdateVideoLayers,SubscriptionPermission,protoInt64,Ping,UpdateLocalAudioTrack,LeaveRequest,LeaveRequest_Action,DisconnectReason,PublishDataTrackRequest,Encryption_Type,UnpublishDataTrackRequest,UpdateDataSubscription,UpdateDataSubscription_Update,SignalRequest,SessionDescription,JoinRequest,ConnectionSettings,WrappedJoinRequest_Compression,WrappedJoinRequest}from'@livekit/protocol';import livekitLogger,{getLogger,LoggerNames}from'../logger.mjs';import {ConnectionError,ConnectionErrorReason}from'../room/errors.mjs';import CriticalTimers from'../room/timers.mjs';import {getClientInfo,sleep,isReactNative,isCompressionStreamSupported}from'../room/utils.mjs';import {AsyncQueue}from'../utils/AsyncQueue.mjs';import {abortSignalTimeout}from'../utils/abort-signal-polyfill.mjs';import {announceMachine}from'../utils/machineInspector.mjs';import {createSignalMachine}from'./SignalClientStateMachine.mjs';import {WebSocketStream}from'./WebSocketStream.mjs';import {createRtcUrl,createValidateUrl,getAbortReasonAsString,parseSignalResponse}from'./utils.mjs';const passThroughQueueSignals = ['syncState', 'trickle', 'offer', 'answer', 'simulate', 'leave'];
2
+ /**
3
+ * Whether a failed resume may be followed by another one. Mirrors how `RTCEngine` classifies these
4
+ * errors: a server leave ends the session, and an expired token cannot be recovered by retrying.
5
+ */
6
+ function isRecoverableReconnectError(error) {
7
+ if (error instanceof ConnectionError) {
8
+ return error.reason !== ConnectionErrorReason.LeaveRequest && error.reason !== ConnectionErrorReason.NotAllowed;
9
+ }
10
+ return true;
11
+ }
12
+ function canPassThroughQueue(req) {
13
+ const canPass = passThroughQueueSignals.indexOf(req.case) >= 0;
14
+ livekitLogger.trace('request allowed to bypass queue:', {
15
+ canPass,
16
+ req
17
+ });
18
+ return canPass;
19
+ }
20
+ var SignalConnectionState;
21
+ (function (SignalConnectionState) {
22
+ SignalConnectionState[SignalConnectionState["CONNECTING"] = 0] = "CONNECTING";
23
+ SignalConnectionState[SignalConnectionState["CONNECTED"] = 1] = "CONNECTED";
24
+ SignalConnectionState[SignalConnectionState["RECONNECTING"] = 2] = "RECONNECTING";
25
+ SignalConnectionState[SignalConnectionState["DISCONNECTING"] = 3] = "DISCONNECTING";
26
+ SignalConnectionState[SignalConnectionState["DISCONNECTED"] = 4] = "DISCONNECTED";
27
+ })(SignalConnectionState || (SignalConnectionState = {}));
28
+ /**
29
+ * Public projection of the lifecycle machine's states. `new`, `offline` and `closed` are all
30
+ * reported as `DISCONNECTED`: they differ in what may happen next
31
+ */
32
+ function lifecycleToConnectionState(lifecycle) {
33
+ switch (lifecycle) {
34
+ case 'connected':
35
+ return SignalConnectionState.CONNECTED;
36
+ case 'connecting':
37
+ return SignalConnectionState.CONNECTING;
38
+ case 'reconnecting':
39
+ return SignalConnectionState.RECONNECTING;
40
+ case 'disconnecting':
41
+ return SignalConnectionState.DISCONNECTING;
42
+ default:
43
+ return SignalConnectionState.DISCONNECTED;
44
+ }
45
+ }
46
+ /** specifies how much time (in ms) we allow for the ws to close its connection gracefully before continuing */
47
+ const MAX_WS_CLOSE_TIME = 250;
48
+ /**
49
+ * How long (in ms) to wait for the first message after the WebSocket upgrade.
50
+ */
51
+ const JOIN_RESPONSE_TIMEOUT = 5000;
52
+ /** @internal */
53
+ class SignalClient {
54
+ get currentState() {
55
+ return lifecycleToConnectionState(this.lifecycleState);
56
+ }
57
+ get isDisconnected() {
58
+ const state = this.currentState;
59
+ return state === SignalConnectionState.DISCONNECTING || state === SignalConnectionState.DISCONNECTED;
60
+ }
61
+ /** Runtime lifecycle state, finer grained than the public {@link currentState} projection. */
62
+ get lifecycleState() {
63
+ return this.machine.currentState();
64
+ }
65
+ /** Id of the current connection attempt and of the transport it owns. */
66
+ get attemptId() {
67
+ return this.machine.context.attemptId;
68
+ }
69
+ /**
70
+ * Applies a lifecycle input and reports whether it moved the machine
71
+ */
72
+ sendLifecycleInput(input) {
73
+ const before = this.lifecycleState;
74
+ this.machine.handle(input.type, input);
75
+ return this.lifecycleState !== before;
76
+ }
77
+ /**
78
+ * Waits out a close that is already in flight. Establishing a session while one is tearing down
79
+ * would race it for the transport — the teardown can close the socket the new attempt just
80
+ * opened.
81
+ */
82
+ settleInFlightClose() {
83
+ return __awaiter(this, void 0, void 0, function* () {
84
+ this.log.debug('waiting for an in-flight close to settle before establishing a session');
85
+ (yield this.closingLock.lock())();
86
+ });
87
+ }
88
+ get isEstablishingConnection() {
89
+ return this.lifecycleState === 'connecting' || this.lifecycleState === 'reconnecting';
90
+ }
91
+ getNextRequestId() {
92
+ this._requestId += 1;
93
+ return this._requestId;
94
+ }
95
+ constructor() {
96
+ let useJSON = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
97
+ let loggerOptions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
98
+ var _a;
99
+ /** signal rtt in milliseconds */
100
+ this.rtt = 0;
101
+ this.log = livekitLogger;
102
+ this._requestId = 0;
103
+ this.useV0SignalPath = false;
104
+ /** @internal */
105
+ this.resetCallbacks = () => {
106
+ this.onAnswer = undefined;
107
+ this.onLeave = undefined;
108
+ this.onLocalTrackPublished = undefined;
109
+ this.onLocalTrackUnpublished = undefined;
110
+ this.onNegotiateRequested = undefined;
111
+ this.onOffer = undefined;
112
+ this.onRemoteMuteChanged = undefined;
113
+ this.onSubscribedQualityUpdate = undefined;
114
+ this.onTokenRefresh = undefined;
115
+ this.onTrickle = undefined;
116
+ this.onClose = undefined;
117
+ this.onMediaSectionsRequirement = undefined;
118
+ };
119
+ this.loggerContextCb = loggerOptions.loggerContextCb;
120
+ this.log = getLogger((_a = loggerOptions.loggerName) !== null && _a !== void 0 ? _a : LoggerNames.Signal, () => this.logContext);
121
+ this.useJSON = useJSON;
122
+ this.requestQueue = new AsyncQueue();
123
+ this.queuedRequests = [];
124
+ this.closingLock = new Mutex();
125
+ this.connectionLock = new Mutex();
126
+ this.machine = createSignalMachine();
127
+ this.machine.on('transitioned', _ref => {
128
+ let fromState = _ref.fromState,
129
+ toState = _ref.toState;
130
+ this.log.debug("signal lifecycle: ".concat(fromState, " -> ").concat(toState));
131
+ });
132
+ this.machine.on('nohandler', _ref2 => {
133
+ let inputName = _ref2.inputName;
134
+ this.log.debug("ignoring signal lifecycle input ".concat(inputName, " in state ").concat(this.lifecycleState));
135
+ });
136
+ // no-op unless a development tool asked for it; see utils/machineInspector
137
+ announceMachine('signal', this.machine);
138
+ }
139
+ get logContext() {
140
+ var _a, _b;
141
+ return (_b = (_a = this.loggerContextCb) === null || _a === void 0 ? void 0 : _a.call(this)) !== null && _b !== void 0 ? _b : {};
142
+ }
143
+ join(url_1, token_1, opts_1, abortSignal_1) {
144
+ return __awaiter(this, arguments, void 0, function (url, token, opts, abortSignal) {
145
+ var _this = this;
146
+ let useV0Path = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : false;
147
+ let publisherOffer = arguments.length > 5 ? arguments[5] : undefined;
148
+ return function* () {
149
+ if (_this.lifecycleState === 'disconnecting') {
150
+ yield _this.settleInFlightClose();
151
+ }
152
+ if (!_this.sendLifecycleInput({
153
+ type: 'connect'
154
+ })) {
155
+ // Proceeding would open a transport the lifecycle does not own: its completion would be
156
+ // discarded and the session left claiming a transport that had been torn down. Every caller
157
+ // that restarts a session closes the previous one first (see RTCEngine.restartConnection).
158
+ throw ConnectionError.internal("cannot establish a signal session from '".concat(_this.lifecycleState, "', close the current one first"));
159
+ }
160
+ _this.options = opts;
161
+ try {
162
+ const res = yield _this.connect(url, token, opts, abortSignal, useV0Path, publisherOffer);
163
+ return res;
164
+ } catch (e) {
165
+ // reported here rather than at each rejection site inside connect(), so that no failure
166
+ // path can leave the machine stuck in `connecting`
167
+ _this.sendLifecycleInput({
168
+ type: 'connectFailed',
169
+ error: e
170
+ });
171
+ throw e;
172
+ }
173
+ }();
174
+ });
175
+ }
176
+ reconnect(url, token, sid, reason) {
177
+ return __awaiter(this, void 0, void 0, function* () {
178
+ if (!this.options) {
179
+ this.log.warn('attempted to reconnect without signal options being set, ignoring');
180
+ return;
181
+ }
182
+ if (this.lifecycleState === 'disconnecting') {
183
+ yield this.settleInFlightClose();
184
+ }
185
+ if (!this.sendLifecycleInput({
186
+ type: 'reconnect'
187
+ })) {
188
+ throw ConnectionError.internal("cannot resume the signal session from '".concat(this.lifecycleState, "'"));
189
+ }
190
+ // clear ping interval and restart it once reconnected
191
+ this.clearPingInterval();
192
+ try {
193
+ const res = yield this.connect(url, token, Object.assign(Object.assign({}, this.options), {
194
+ reconnect: true,
195
+ sid,
196
+ reconnectReason: reason
197
+ }), undefined, this.useV0SignalPath);
198
+ return res;
199
+ } catch (e) {
200
+ this.sendLifecycleInput({
201
+ type: 'reconnectFailed',
202
+ error: e,
203
+ recoverable: isRecoverableReconnectError(e)
204
+ });
205
+ throw e;
206
+ }
207
+ });
208
+ }
209
+ connect(url_1, token_1, opts_1, abortSignal_1) {
210
+ return __awaiter(this, arguments, void 0, function (url, token, opts, abortSignal) {
211
+ var _this2 = this;
212
+ let useV0Path = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : false;
213
+ let publisherOffer = arguments.length > 5 ? arguments[5] : undefined;
214
+ return function* () {
215
+ const unlock = yield _this2.connectionLock.lock();
216
+ let rtcUrl;
217
+ let validateUrl;
218
+ try {
219
+ _this2.connectOptions = opts;
220
+ _this2.useV0SignalPath = useV0Path;
221
+ const clientInfo = getClientInfo(opts.clientInfoCapabilities);
222
+ const params = useV0Path ? createConnectionParams(token, clientInfo, opts) : yield createJoinRequestConnectionParams(token, clientInfo, opts, publisherOffer);
223
+ rtcUrl = createRtcUrl(url, params, useV0Path).toString();
224
+ validateUrl = createValidateUrl(rtcUrl).toString();
225
+ } catch (e) {
226
+ // the executor below owns the lock from here on
227
+ unlock();
228
+ throw e;
229
+ }
230
+ if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
231
+ unlock();
232
+ _this2.log.debug('signal connect abandoned before opening a transport');
233
+ throw ConnectionError.cancelled('Connection aborted');
234
+ }
235
+ return new Promise((resolve, reject) => __awaiter(_this2, void 0, void 0, function* () {
236
+ var _a, _b, _c, _d, _e;
237
+ try {
238
+ let alreadyAborted = false;
239
+ const abortHandler = eventOrError => __awaiter(this, void 0, void 0, function* () {
240
+ if (alreadyAborted) {
241
+ return;
242
+ }
243
+ alreadyAborted = true;
244
+ // React Native has no global Event; `instanceof Event` throws ReferenceError there and
245
+ // leaves the timeout/abort path unable to close the socket or reject the connect.
246
+ const target = typeof Event !== 'undefined' && eventOrError instanceof Event ? eventOrError.currentTarget : eventOrError;
247
+ const reason = getAbortReasonAsString(target, 'Abort handler called');
248
+ // send leave if we have an active stream writer (connection is open)
249
+ if (this.streamWriter && !this.isDisconnected) {
250
+ this.sendLeave().then(() => this.close(true, reason)).catch(e => {
251
+ this.log.error(e);
252
+ this.close(true, reason);
253
+ });
254
+ } else {
255
+ this.close(true, reason);
256
+ }
257
+ cleanupAbortHandlers();
258
+ // The caller may already have classified this failure: the connect timeout hands us a
259
+ // Timeout error. Only a genuine abort is a cancellation, and reporting a stalled connect as
260
+ // one makes the engine read it as user intent — skipping region failover and never
261
+ // recording the attempt against the backoff strategy (see Room.connect).
262
+ reject(eventOrError instanceof ConnectionError ? eventOrError : ConnectionError.cancelled(reason));
263
+ });
264
+ abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.addEventListener('abort', abortHandler);
265
+ const cleanupAbortHandlers = () => {
266
+ clearTimeout(wsTimeout);
267
+ abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.removeEventListener('abort', abortHandler);
268
+ };
269
+ const wsTimeout = setTimeout(() => {
270
+ abortHandler(ConnectionError.timeout('room connection has timed out (signal)'));
271
+ }, opts.websocketTimeout);
272
+ const redactedUrl = new URL(rtcUrl);
273
+ if (redactedUrl.searchParams.has('access_token')) {
274
+ redactedUrl.searchParams.set('access_token', '<redacted>');
275
+ }
276
+ if (this.ws) {
277
+ const startClose = performance.now();
278
+ yield this.teardownTransport('replaced by a new connection attempt');
279
+ this.log.debug("closed previous ws connection in ".concat(performance.now() - startClose, "ms"));
280
+ }
281
+ if (alreadyAborted) {
282
+ this.log.debug('signal connect abandoned after tearing down the previous transport');
283
+ return;
284
+ }
285
+ // the transport created below belongs to this attempt; events arriving from it after a
286
+ // newer attempt has started are dropped by the machine
287
+ const attemptId = this.attemptId;
288
+ this.log.info("signal connecting to ".concat(redactedUrl), {
289
+ reconnect: opts.reconnect,
290
+ reconnectReason: opts.reconnectReason
291
+ });
292
+ this.ws = new WebSocketStream(rtcUrl);
293
+ // A failed upgrade closes the socket, so `opened` and `closed` settle for the same cause — but
294
+ // only the `opened` path can classify it (a 401 is known after asking the validate endpoint).
295
+ // Noting the failure *before* the close handler is registered means it runs first, so a close
296
+ // that merely reflects a failed upgrade stands down and lets the classified error reach the
297
+ // caller. Any other close still fails the attempt straight away: after a successful upgrade
298
+ // nothing else would, short of the first-message timeout.
299
+ let upgradeFailed = false;
300
+ this.ws.opened.catch(() => {
301
+ upgradeFailed = true;
302
+ });
303
+ try {
304
+ this.ws.closed.then(closeInfo => {
305
+ if (this.isEstablishingConnection && !upgradeFailed) {
306
+ reject(ConnectionError.internal("Websocket got closed during a (re)connection attempt: ".concat(closeInfo.reason)));
307
+ }
308
+ this.log.debug('websocket closed', {
309
+ reason: closeInfo.reason,
310
+ code: closeInfo.closeCode,
311
+ attemptId,
312
+ state: this.lifecycleState
313
+ });
314
+ // Every close of the live transport is reported, including a clean 1000 one: a server
315
+ // that drops signalling closes cleanly — a migration that never sends its
316
+ // `Leave{action=RESUME}` does exactly that — and treating that as "nothing happened"
317
+ // leaves the client believing it is still connected until something else notices.
318
+ // Closes we caused ourselves, and closes from a transport that has since been
319
+ // replaced, are dropped by the machine's state and attempt guards below rather than by
320
+ // a close-code test.
321
+ this.handleOnClose(closeInfo.reason || (closeInfo.closeCode === 1000 ? 'server closed the signal connection' : 'Unexpected WS error'), attemptId);
322
+ return;
323
+ }).catch(reason => {
324
+ if (this.isEstablishingConnection && !upgradeFailed) {
325
+ reject(ConnectionError.internal("Websocket error during a (re)connection attempt: ".concat(reason)));
326
+ }
327
+ });
328
+ const connection = yield this.ws.opened.catch(reason => __awaiter(this, void 0, void 0, function* () {
329
+ if (alreadyAborted) {
330
+ // the abort handler has already rejected this attempt; don't probe the validate
331
+ // endpoint for a failure nobody is waiting on
332
+ this.log.debug('signal connect abandoned while the websocket was opening');
333
+ return;
334
+ }
335
+ if (this.lifecycleState !== 'connected') {
336
+ // claimed synchronously, before the await below: the socket's close event is already
337
+ // on its way and would otherwise reject first with a less useful error
338
+ clearTimeout(wsTimeout);
339
+ const error = yield this.handleConnectionError(reason, validateUrl);
340
+ reject(error);
341
+ return;
342
+ }
343
+ // other errors, handle
344
+ this.handleWSError(reason);
345
+ reject(reason);
346
+ return;
347
+ }));
348
+ clearTimeout(wsTimeout);
349
+ if (!connection) {
350
+ return;
351
+ }
352
+ const signalReader = connection.readable.getReader();
353
+ this.streamWriter = connection.writable.getWriter();
354
+ // wsTimeout only guarded the upgrade; guard the first-message read with
355
+ // its own deadline so a silent server can't hang join() forever.
356
+ // During reconnect, drop any stray messages that arrive before the
357
+ // ReconnectResponse so we do not declare the channel reconnected on the
358
+ // wrong signal.
359
+ let firstSignalResponse;
360
+ try {
361
+ const deadline = Date.now() + JOIN_RESPONSE_TIMEOUT;
362
+ // eslint-disable-next-line no-constant-condition
363
+ while (true) {
364
+ const remaining = deadline - Date.now();
365
+ if (remaining <= 0) {
366
+ throw ConnectionError.timeout('signal connection timed out while waiting for the first message');
367
+ }
368
+ let readTimeout;
369
+ const readResult = yield Promise.race([signalReader.read(), new Promise((_, rejectRead) => {
370
+ readTimeout = setTimeout(() => {
371
+ rejectRead(ConnectionError.timeout('signal connection timed out while waiting for the first message'));
372
+ }, remaining);
373
+ })]);
374
+ clearTimeout(readTimeout);
375
+ if (!readResult.value) {
376
+ throw ConnectionError.internal('no message received as first message');
377
+ }
378
+ const parsed = parseSignalResponse(readResult.value);
379
+ if (this.lifecycleState === 'reconnecting' && ((_a = parsed.message) === null || _a === void 0 ? void 0 : _a.case) !== 'reconnect' && ((_b = parsed.message) === null || _b === void 0 ? void 0 : _b.case) !== 'leave') {
380
+ this.log.warn('dropping signal message while awaiting reconnect response', {
381
+ messageCase: (_c = parsed.message) === null || _c === void 0 ? void 0 : _c.case
382
+ });
383
+ continue;
384
+ }
385
+ firstSignalResponse = parsed;
386
+ break;
387
+ }
388
+ } catch (e) {
389
+ // No usable first message in time: release the reader and tear down the ws
390
+ // so we surface the timeout instead of leaking an open connection.
391
+ signalReader.releaseLock();
392
+ reject(e);
393
+ this.close();
394
+ return;
395
+ }
396
+ signalReader.releaseLock();
397
+ if (alreadyAborted) {
398
+ // The abort handler has already rejected this attempt and is closing the transport.
399
+ // Don't act on a join that raced it: `onJoined` would publish an abandoned session's
400
+ // state to the room.
401
+ this.log.debug('signal connect abandoned while waiting for the first message');
402
+ return;
403
+ }
404
+ // Validate the first message
405
+ const validation = this.validateFirstMessage(firstSignalResponse, (_d = opts.reconnect) !== null && _d !== void 0 ? _d : false);
406
+ if (!validation.isValid) {
407
+ reject(validation.error);
408
+ return;
409
+ }
410
+ // Handle join response
411
+ if (((_e = firstSignalResponse.message) === null || _e === void 0 ? void 0 : _e.case) === 'join') {
412
+ // Set up ping configuration
413
+ this.pingTimeoutDuration = firstSignalResponse.message.value.pingTimeout;
414
+ this.pingIntervalDuration = firstSignalResponse.message.value.pingInterval;
415
+ if (this.pingTimeoutDuration && this.pingTimeoutDuration > 0) {
416
+ this.log.debug('ping config', {
417
+ timeout: this.pingTimeoutDuration,
418
+ interval: this.pingIntervalDuration
419
+ });
420
+ }
421
+ if (this.onJoined) {
422
+ this.onJoined(firstSignalResponse.message.value);
423
+ }
424
+ }
425
+ this.handleSignalConnected(connection, wsTimeout, attemptId);
426
+ resolve(validation.response);
427
+ } catch (e) {
428
+ reject(e);
429
+ } finally {
430
+ cleanupAbortHandlers();
431
+ }
432
+ } finally {
433
+ unlock();
434
+ }
435
+ }));
436
+ }();
437
+ });
438
+ }
439
+ startReadingLoop(signalReader) {
440
+ return __awaiter(this, void 0, void 0, function* () {
441
+ const attemptId = this.attemptId;
442
+ while (true) {
443
+ if (this.signalLatency) {
444
+ yield sleep(this.signalLatency);
445
+ }
446
+ try {
447
+ const _yield$signalReader$r = yield signalReader.read(),
448
+ done = _yield$signalReader$r.done,
449
+ value = _yield$signalReader$r.value;
450
+ if (done) {
451
+ break;
452
+ }
453
+ const resp = parseSignalResponse(value);
454
+ this.handleSignalResponse(resp);
455
+ } catch (e) {
456
+ // only an unexpected loss is an error: a read that fails because we closed the socket
457
+ // ourselves (or it was replaced) is logged at debug level by handleOnClose
458
+ yield this.handleOnClose('error in reading loop', attemptId, undefined, e);
459
+ break;
460
+ }
461
+ }
462
+ });
463
+ }
464
+ close() {
465
+ return __awaiter(this, arguments, void 0, function () {
466
+ var _this3 = this;
467
+ let updateState = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
468
+ let reason = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'Close method called on signal client';
469
+ return function* () {
470
+ // when the lifecycle is already shutting down (or another close owns it), only the transport
471
+ // teardown below still applies — it is idempotent, so callers can always await a close
472
+ const drivesLifecycle = updateState && _this3.sendLifecycleInput({
473
+ type: 'close',
474
+ reason
475
+ });
476
+ const unlock = yield _this3.closingLock.lock();
477
+ try {
478
+ yield _this3.teardownTransport(reason);
479
+ } finally {
480
+ if (drivesLifecycle) {
481
+ _this3.sendLifecycleInput({
482
+ type: 'closeComplete'
483
+ });
484
+ }
485
+ unlock();
486
+ }
487
+ }();
488
+ });
489
+ }
490
+ /**
491
+ * Releases the transport and everything tied to it, without touching the lifecycle state. Used
492
+ * both by {@link close} and by paths that replace the transport under a live lifecycle (a new
493
+ * attempt, or an unexpected close that leaves the client in `offline`).
494
+ */
495
+ teardownTransport(reason) {
496
+ return __awaiter(this, void 0, void 0, function* () {
497
+ try {
498
+ this.clearPingInterval();
499
+ const ws = this.ws;
500
+ if (ws) {
501
+ // released before closing, so a close that throws cannot leave the transport attached
502
+ this.ws = undefined;
503
+ this.streamWriter = undefined;
504
+ ws.close({
505
+ closeCode: 1000,
506
+ reason
507
+ });
508
+ // calling `ws.close()` only starts the closing handshake (CLOSING state), prefer to wait until state is actually CLOSED
509
+ yield Promise.race([ws.closed, sleep(MAX_WS_CLOSE_TIME)]);
510
+ }
511
+ } catch (e) {
512
+ this.log.debug('websocket error while closing', {
513
+ error: e
514
+ });
515
+ }
516
+ });
517
+ }
518
+ // initial offer after joining
519
+ sendOffer(offer, offerId) {
520
+ this.log.debug('sending offer', {
521
+ offerSdp: offer.sdp
522
+ });
523
+ this.sendRequest({
524
+ case: 'offer',
525
+ value: toProtoSessionDescription(offer, offerId)
526
+ });
527
+ }
528
+ // answer a server-initiated offer
529
+ sendAnswer(answer, offerId) {
530
+ this.log.debug('sending answer', {
531
+ answerSdp: answer.sdp
532
+ });
533
+ return this.sendRequest({
534
+ case: 'answer',
535
+ value: toProtoSessionDescription(answer, offerId)
536
+ });
537
+ }
538
+ sendIceCandidate(candidate, target) {
539
+ this.log.debug('sending ice candidate', {
540
+ candidate
541
+ });
542
+ return this.sendRequest({
543
+ case: 'trickle',
544
+ value: new TrickleRequest({
545
+ candidateInit: JSON.stringify(candidate),
546
+ target
547
+ })
548
+ });
549
+ }
550
+ sendMuteTrack(trackSid, muted) {
551
+ return this.sendRequest({
552
+ case: 'mute',
553
+ value: new MuteTrackRequest({
554
+ sid: trackSid,
555
+ muted
556
+ })
557
+ });
558
+ }
559
+ sendAddTrack(req) {
560
+ return this.sendRequest({
561
+ case: 'addTrack',
562
+ value: req
563
+ });
564
+ }
565
+ sendUpdateLocalMetadata(metadata_1, name_1) {
566
+ return __awaiter(this, arguments, void 0, function (metadata, name) {
567
+ var _this4 = this;
568
+ let attributes = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
569
+ return function* () {
570
+ const requestId = _this4.getNextRequestId();
571
+ yield _this4.sendRequest({
572
+ case: 'updateMetadata',
573
+ value: new UpdateParticipantMetadata({
574
+ requestId,
575
+ metadata,
576
+ name,
577
+ attributes
578
+ })
579
+ });
580
+ return requestId;
581
+ }();
582
+ });
583
+ }
584
+ sendUpdateTrackSettings(settings) {
585
+ this.sendRequest({
586
+ case: 'trackSetting',
587
+ value: settings
588
+ });
589
+ }
590
+ sendUpdateSubscription(sub) {
591
+ return this.sendRequest({
592
+ case: 'subscription',
593
+ value: sub
594
+ });
595
+ }
596
+ sendSyncState(sync) {
597
+ return this.sendRequest({
598
+ case: 'syncState',
599
+ value: sync
600
+ });
601
+ }
602
+ sendUpdateVideoLayers(trackSid, layers) {
603
+ return this.sendRequest({
604
+ case: 'updateLayers',
605
+ value: new UpdateVideoLayers({
606
+ trackSid,
607
+ layers
608
+ })
609
+ });
610
+ }
611
+ sendUpdateSubscriptionPermissions(allParticipants, trackPermissions) {
612
+ return this.sendRequest({
613
+ case: 'subscriptionPermission',
614
+ value: new SubscriptionPermission({
615
+ allParticipants,
616
+ trackPermissions
617
+ })
618
+ });
619
+ }
620
+ sendSimulateScenario(scenario) {
621
+ return this.sendRequest({
622
+ case: 'simulate',
623
+ value: scenario
624
+ });
625
+ }
626
+ sendPing() {
627
+ /** send both of ping and pingReq for compatibility to old and new server */
628
+ return Promise.all([this.sendRequest({
629
+ case: 'ping',
630
+ value: protoInt64.parse(Date.now())
631
+ }), this.sendRequest({
632
+ case: 'pingReq',
633
+ value: new Ping({
634
+ timestamp: protoInt64.parse(Date.now()),
635
+ rtt: protoInt64.parse(this.rtt)
636
+ })
637
+ })]);
638
+ }
639
+ sendUpdateLocalAudioTrack(trackSid, features) {
640
+ return this.sendRequest({
641
+ case: 'updateAudioTrack',
642
+ value: new UpdateLocalAudioTrack({
643
+ trackSid,
644
+ features
645
+ })
646
+ });
647
+ }
648
+ sendLeave() {
649
+ return this.sendRequest({
650
+ case: 'leave',
651
+ value: new LeaveRequest({
652
+ reason: DisconnectReason.CLIENT_INITIATED,
653
+ // server doesn't process this field, keeping it here to indicate the intent of a full disconnect
654
+ action: LeaveRequest_Action.DISCONNECT
655
+ })
656
+ });
657
+ }
658
+ sendPublishDataTrackRequest(handle, name, usesE2ee) {
659
+ return this.sendRequest({
660
+ case: 'publishDataTrackRequest',
661
+ value: new PublishDataTrackRequest({
662
+ pubHandle: handle,
663
+ name: name,
664
+ encryption: usesE2ee ? Encryption_Type.GCM : Encryption_Type.NONE
665
+ })
666
+ });
667
+ }
668
+ sendUnPublishDataTrackRequest(handle) {
669
+ return this.sendRequest({
670
+ case: 'unpublishDataTrackRequest',
671
+ value: new UnpublishDataTrackRequest({
672
+ pubHandle: handle
673
+ })
674
+ });
675
+ }
676
+ sendUpdateDataSubscription(sid, subscribe) {
677
+ return this.sendRequest({
678
+ case: 'updateDataSubscription',
679
+ value: new UpdateDataSubscription({
680
+ // FIXME: consider refactoring to allow caller to pass an array of events through
681
+ updates: [new UpdateDataSubscription_Update({
682
+ trackSid: sid,
683
+ subscribe
684
+ })]
685
+ })
686
+ });
687
+ }
688
+ sendRequest(message_1) {
689
+ return __awaiter(this, arguments, void 0, function (message) {
690
+ var _this5 = this;
691
+ let fromQueue = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
692
+ return function* () {
693
+ // capture all requests while reconnecting and put them in a queue
694
+ // unless the request originates from the queue, then don't enqueue again
695
+ const canQueue = !fromQueue && !canPassThroughQueue(message);
696
+ const isHoldingRequests = _this5.lifecycleState === 'reconnecting' || _this5.queuedRequests.length > 0;
697
+ if (canQueue && isHoldingRequests) {
698
+ _this5.queuedRequests.push(() => __awaiter(_this5, void 0, void 0, function* () {
699
+ yield this.sendRequest(message, true);
700
+ }));
701
+ return;
702
+ }
703
+ // make sure previously queued requests are being sent first
704
+ if (!fromQueue) {
705
+ yield _this5.requestQueue.flush();
706
+ }
707
+ if (_this5.signalLatency) {
708
+ yield sleep(_this5.signalLatency);
709
+ }
710
+ // `leave` is the one request whose purpose is to be sent on the way out (an aborted connect
711
+ // attempt tells the server before tearing down), so it is allowed through for as long as the
712
+ // transport is still there
713
+ const isLeaveOnShutdown = message.case === 'leave' && !!_this5.streamWriter;
714
+ if (_this5.isDisconnected && !isLeaveOnShutdown) {
715
+ // Skip requests if the signal layer is disconnected
716
+ // This can happen if an event is sent in the mist of room.connect() initializing
717
+ _this5.log.debug("skipping signal request (type: ".concat(message.case, ") - SignalClient disconnected"));
718
+ return;
719
+ }
720
+ if (!_this5.streamWriter) {
721
+ _this5.log.error("cannot send signal request before connected, type: ".concat(message === null || message === void 0 ? void 0 : message.case));
722
+ return;
723
+ }
724
+ const req = new SignalRequest({
725
+ message
726
+ });
727
+ try {
728
+ if (_this5.useJSON) {
729
+ yield _this5.streamWriter.write(req.toJsonString());
730
+ } else {
731
+ yield _this5.streamWriter.write(req.toBinary().buffer);
732
+ }
733
+ } catch (e) {
734
+ _this5.log.error('error sending signal message', {
735
+ error: e
736
+ });
737
+ }
738
+ }();
739
+ });
740
+ }
741
+ handleSignalResponse(res) {
742
+ var _a, _b;
743
+ const msg = res.message;
744
+ if (msg == undefined) {
745
+ this.log.debug('received unsupported message');
746
+ return;
747
+ }
748
+ let pingHandled = false;
749
+ if (msg.case === 'answer') {
750
+ const sd = fromProtoSessionDescription(msg.value);
751
+ if (this.onAnswer) {
752
+ this.onAnswer(sd, msg.value.id, msg.value.midToTrackId);
753
+ }
754
+ } else if (msg.case === 'offer') {
755
+ const sd = fromProtoSessionDescription(msg.value);
756
+ if (this.onOffer) {
757
+ this.onOffer(sd, msg.value.id, msg.value.midToTrackId);
758
+ }
759
+ } else if (msg.case === 'trickle') {
760
+ const candidate = JSON.parse(msg.value.candidateInit);
761
+ if (this.onTrickle) {
762
+ this.onTrickle(candidate, msg.value.target);
763
+ }
764
+ } else if (msg.case === 'update') {
765
+ if (this.onParticipantUpdate) {
766
+ this.onParticipantUpdate((_a = msg.value.participants) !== null && _a !== void 0 ? _a : []);
767
+ }
768
+ } else if (msg.case === 'trackPublished') {
769
+ if (this.onLocalTrackPublished) {
770
+ this.onLocalTrackPublished(msg.value);
771
+ }
772
+ } else if (msg.case === 'speakersChanged') {
773
+ if (this.onSpeakersChanged) {
774
+ this.onSpeakersChanged((_b = msg.value.speakers) !== null && _b !== void 0 ? _b : []);
775
+ }
776
+ } else if (msg.case === 'leave') {
777
+ if (this.onLeave) {
778
+ this.onLeave(msg.value);
779
+ }
780
+ } else if (msg.case === 'mute') {
781
+ if (this.onRemoteMuteChanged) {
782
+ this.onRemoteMuteChanged(msg.value.sid, msg.value.muted);
783
+ }
784
+ } else if (msg.case === 'roomUpdate') {
785
+ if (this.onRoomUpdate && msg.value.room) {
786
+ this.onRoomUpdate(msg.value.room);
787
+ }
788
+ } else if (msg.case === 'connectionQuality') {
789
+ if (this.onConnectionQuality) {
790
+ this.onConnectionQuality(msg.value);
791
+ }
792
+ } else if (msg.case === 'streamStateUpdate') {
793
+ if (this.onStreamStateUpdate) {
794
+ this.onStreamStateUpdate(msg.value);
795
+ }
796
+ } else if (msg.case === 'subscribedQualityUpdate') {
797
+ if (this.onSubscribedQualityUpdate) {
798
+ this.onSubscribedQualityUpdate(msg.value);
799
+ }
800
+ } else if (msg.case === 'subscriptionPermissionUpdate') {
801
+ if (this.onSubscriptionPermissionUpdate) {
802
+ this.onSubscriptionPermissionUpdate(msg.value);
803
+ }
804
+ } else if (msg.case === 'refreshToken') {
805
+ if (this.onTokenRefresh) {
806
+ this.onTokenRefresh(msg.value);
807
+ }
808
+ } else if (msg.case === 'trackUnpublished') {
809
+ if (this.onLocalTrackUnpublished) {
810
+ this.onLocalTrackUnpublished(msg.value);
811
+ }
812
+ } else if (msg.case === 'subscriptionResponse') {
813
+ if (this.onSubscriptionError) {
814
+ this.onSubscriptionError(msg.value);
815
+ }
816
+ } else if (msg.case === 'pong') ; else if (msg.case === 'pongResp') {
817
+ this.rtt = Date.now() - Number.parseInt(msg.value.lastPingTimestamp.toString());
818
+ this.resetPingTimeout();
819
+ pingHandled = true;
820
+ } else if (msg.case === 'requestResponse') {
821
+ if (this.onRequestResponse) {
822
+ this.onRequestResponse(msg.value);
823
+ }
824
+ } else if (msg.case === 'trackSubscribed') {
825
+ if (this.onLocalTrackSubscribed) {
826
+ this.onLocalTrackSubscribed(msg.value.trackSid);
827
+ }
828
+ } else if (msg.case === 'roomMoved') {
829
+ if (this.onTokenRefresh) {
830
+ this.onTokenRefresh(msg.value.token);
831
+ }
832
+ if (this.onRoomMoved) {
833
+ this.onRoomMoved(msg.value);
834
+ }
835
+ } else if (msg.case === 'mediaSectionsRequirement') {
836
+ if (this.onMediaSectionsRequirement) {
837
+ this.onMediaSectionsRequirement(msg.value);
838
+ }
839
+ } else if (msg.case === 'publishDataTrackResponse') {
840
+ if (this.onPublishDataTrackResponse) {
841
+ this.onPublishDataTrackResponse(msg.value);
842
+ }
843
+ } else if (msg.case === 'unpublishDataTrackResponse') {
844
+ if (this.onUnPublishDataTrackResponse) {
845
+ this.onUnPublishDataTrackResponse(msg.value);
846
+ }
847
+ } else if (msg.case === 'dataTrackSubscriberHandles') {
848
+ if (this.onDataTrackSubscriberHandles) {
849
+ this.onDataTrackSubscriberHandles(msg.value);
850
+ }
851
+ } else {
852
+ this.log.debug('unsupported message', {
853
+ msgCase: msg.case
854
+ });
855
+ }
856
+ if (!pingHandled) {
857
+ this.resetPingTimeout();
858
+ }
859
+ }
860
+ setReconnected() {
861
+ while (this.queuedRequests.length > 0) {
862
+ const req = this.queuedRequests.shift();
863
+ if (req) {
864
+ this.requestQueue.run(req);
865
+ }
866
+ }
867
+ }
868
+ /**
869
+ * Handles a transport we lost without asking to. The client goes to `offline` rather than
870
+ * `closed`: whether this session gets resumed, restarted or given up on is the engine's call.
871
+ */
872
+ handleOnClose(reason_1) {
873
+ return __awaiter(this, arguments, void 0, function (reason) {
874
+ var _this6 = this;
875
+ let attemptId = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.attemptId;
876
+ let simulateReconnectDelay = arguments.length > 2 ? arguments[2] : undefined;
877
+ let readError = arguments.length > 3 ? arguments[3] : undefined;
878
+ return function* () {
879
+ const onCloseCallback = _this6.onClose;
880
+ if (!_this6.sendLifecycleInput({
881
+ type: 'transportFailed',
882
+ attemptId,
883
+ reason
884
+ })) {
885
+ // a close we caused ourselves, or one from a transport that has since been replaced: logged
886
+ // rather than dropped silently, because a close that goes unnoticed leaves the client writing
887
+ // to a dead socket
888
+ _this6.log.debug("ignoring transport close in state ".concat(_this6.lifecycleState), Object.assign({
889
+ reason,
890
+ attemptId,
891
+ currentAttemptId: _this6.attemptId
892
+ }, readError !== undefined ? {
893
+ error: readError
894
+ } : {}));
895
+ return;
896
+ }
897
+ if (readError !== undefined) {
898
+ _this6.log.error("error reading from signal stream", {
899
+ error: readError
900
+ });
901
+ }
902
+ yield _this6.teardownTransport(reason);
903
+ _this6.log.info("websocket connection closed: ".concat(reason), {
904
+ reason
905
+ });
906
+ if (simulateReconnectDelay) {
907
+ _this6.log.info("waiting for ".concat(simulateReconnectDelay, "ms until reconnecting signal"));
908
+ yield sleep(simulateReconnectDelay);
909
+ }
910
+ if (onCloseCallback) {
911
+ onCloseCallback(reason);
912
+ }
913
+ }();
914
+ });
915
+ }
916
+ handleWSError(error) {
917
+ this.log.error('websocket error', {
918
+ error
919
+ });
920
+ }
921
+ /**
922
+ * Resets the ping timeout and starts a new timeout.
923
+ * Call this after receiving a pong message
924
+ */
925
+ resetPingTimeout() {
926
+ this.clearPingTimeout();
927
+ if (this.isDisconnected) {
928
+ // the read loop can still deliver messages while close() waits for the socket to close
929
+ return;
930
+ }
931
+ if (!this.pingTimeoutDuration) {
932
+ this.log.warn('ping timeout duration not set');
933
+ return;
934
+ }
935
+ this.pingTimeout = CriticalTimers.setTimeout(() => {
936
+ this.log.warn("ping timeout triggered. last pong received at: ".concat(new Date(Date.now() - this.pingTimeoutDuration * 1000).toUTCString()));
937
+ this.handleOnClose('ping timeout');
938
+ }, this.pingTimeoutDuration * 1000);
939
+ }
940
+ /**
941
+ * Clears ping timeout (does not start a new timeout)
942
+ */
943
+ clearPingTimeout() {
944
+ if (this.pingTimeout) {
945
+ CriticalTimers.clearTimeout(this.pingTimeout);
946
+ }
947
+ }
948
+ startPingInterval() {
949
+ this.clearPingInterval();
950
+ this.resetPingTimeout();
951
+ if (!this.pingIntervalDuration) {
952
+ this.log.warn('ping interval duration not set');
953
+ return;
954
+ }
955
+ this.log.debug('start ping interval');
956
+ this.pingInterval = CriticalTimers.setInterval(() => {
957
+ this.sendPing();
958
+ }, this.pingIntervalDuration * 1000);
959
+ }
960
+ clearPingInterval() {
961
+ this.log.debug('clearing ping interval');
962
+ this.clearPingTimeout();
963
+ if (this.pingInterval) {
964
+ CriticalTimers.clearInterval(this.pingInterval);
965
+ }
966
+ }
967
+ /**
968
+ * Handles the successful connection to the signal server
969
+ * @param connection The WebSocket connection
970
+ * @param timeoutHandle The timeout handle to clear
971
+ * @param firstMessage Optional first message to process
972
+ * @internal
973
+ */
974
+ handleSignalConnected(connection, timeoutHandle, attemptId) {
975
+ clearTimeout(timeoutHandle);
976
+ const established = this.sendLifecycleInput(this.lifecycleState === 'reconnecting' ? {
977
+ type: 'reconnectComplete',
978
+ attemptId
979
+ } : {
980
+ type: 'connectComplete',
981
+ attemptId
982
+ });
983
+ if (!established) {
984
+ // The attempt was abandoned while we waited for the server's first message: it was closed, or
985
+ // a newer attempt superseded it. Arming the ping interval and the read loop here would outlive
986
+ // the session that owns them, so leave the transport to whoever holds the lifecycle now.
987
+ this.log.debug('discarding a connection whose attempt no longer owns the session', {
988
+ attemptId,
989
+ currentAttemptId: this.attemptId,
990
+ state: this.lifecycleState
991
+ });
992
+ return;
993
+ }
994
+ this.log.info('signal connected');
995
+ this.startPingInterval();
996
+ this.startReadingLoop(connection.readable.getReader());
997
+ }
998
+ /**
999
+ * Validates the first message received from the signal server
1000
+ * @param firstSignalResponse The first signal response received
1001
+ * @param isReconnect Whether this is a reconnection attempt
1002
+ * @returns Validation result with response or error
1003
+ * @internal
1004
+ */
1005
+ validateFirstMessage(firstSignalResponse, isReconnect) {
1006
+ var _a, _b, _c, _d;
1007
+ if (((_a = firstSignalResponse.message) === null || _a === void 0 ? void 0 : _a.case) === 'join') {
1008
+ return {
1009
+ isValid: true,
1010
+ response: firstSignalResponse.message.value
1011
+ };
1012
+ } else if (this.lifecycleState === 'reconnecting' && ((_b = firstSignalResponse.message) === null || _b === void 0 ? void 0 : _b.case) === 'reconnect') {
1013
+ return {
1014
+ isValid: true,
1015
+ response: firstSignalResponse.message.value
1016
+ };
1017
+ } else if (this.isEstablishingConnection && ((_c = firstSignalResponse.message) === null || _c === void 0 ? void 0 : _c.case) === 'leave') {
1018
+ return {
1019
+ isValid: false,
1020
+ error: ConnectionError.leaveRequest('Received leave request while trying to (re)connect', firstSignalResponse.message.value.reason)
1021
+ };
1022
+ } else if (!isReconnect) {
1023
+ // non-reconnect case, should receive join response first
1024
+ return {
1025
+ isValid: false,
1026
+ error: ConnectionError.internal("did not receive join response, got ".concat((_d = firstSignalResponse.message) === null || _d === void 0 ? void 0 : _d.case, " instead"))
1027
+ };
1028
+ }
1029
+ return {
1030
+ isValid: false,
1031
+ error: ConnectionError.internal('Unexpected first message')
1032
+ };
1033
+ }
1034
+ /**
1035
+ * Handles WebSocket connection errors by validating with the server
1036
+ * @param reason The error that occurred
1037
+ * @param validateUrl The URL to validate the connection with
1038
+ * @returns A ConnectionError with appropriate reason and status
1039
+ * @internal
1040
+ */
1041
+ handleConnectionError(reason, validateUrl) {
1042
+ return __awaiter(this, void 0, void 0, function* () {
1043
+ try {
1044
+ const resp = yield fetch(validateUrl, {
1045
+ signal: abortSignalTimeout(3000)
1046
+ });
1047
+ switch (resp.status) {
1048
+ case 404:
1049
+ const errorMsg = yield resp.text();
1050
+ if (errorMsg.includes('requested room does not exist')) {
1051
+ return ConnectionError.notAllowed(errorMsg, resp.status);
1052
+ }
1053
+ return ConnectionError.serviceNotFound('v1 RTC path not found. Consider upgrading your LiveKit server version', 'v0-rtc');
1054
+ case 401:
1055
+ case 403:
1056
+ const msg = yield resp.text();
1057
+ return ConnectionError.notAllowed(msg, resp.status);
1058
+ default:
1059
+ break;
1060
+ }
1061
+ if (reason instanceof ConnectionError) {
1062
+ return reason;
1063
+ } else {
1064
+ return ConnectionError.internal("Encountered unknown websocket error during connection: ".concat(reason), {
1065
+ status: resp.status,
1066
+ statusText: resp.statusText
1067
+ });
1068
+ }
1069
+ } catch (e) {
1070
+ if (e instanceof ConnectionError) {
1071
+ return e;
1072
+ } else {
1073
+ return ConnectionError.serverUnreachable(e instanceof Error ? e.message : 'server was not reachable');
1074
+ }
1075
+ }
1076
+ });
1077
+ }
1078
+ }
1079
+ function fromProtoSessionDescription(sd) {
1080
+ const rsd = {
1081
+ type: 'offer',
1082
+ sdp: sd.sdp
1083
+ };
1084
+ switch (sd.type) {
1085
+ case 'answer':
1086
+ case 'offer':
1087
+ case 'pranswer':
1088
+ case 'rollback':
1089
+ rsd.type = sd.type;
1090
+ break;
1091
+ }
1092
+ return rsd;
1093
+ }
1094
+ function toProtoSessionDescription(rsd, id) {
1095
+ const sd = new SessionDescription({
1096
+ sdp: rsd.sdp,
1097
+ type: rsd.type,
1098
+ id
1099
+ });
1100
+ return sd;
1101
+ }
1102
+ function createConnectionParams(token, info, opts) {
1103
+ var _a;
1104
+ const params = new URLSearchParams();
1105
+ params.set('access_token', token);
1106
+ // opts
1107
+ if (opts.reconnect) {
1108
+ params.set('reconnect', '1');
1109
+ if (opts.sid) {
1110
+ params.set('sid', opts.sid);
1111
+ }
1112
+ }
1113
+ params.set('auto_subscribe', opts.autoSubscribe ? '1' : '0');
1114
+ // ClientInfo
1115
+ params.set('sdk', isReactNative() ? 'reactnative' : 'js');
1116
+ params.set('version', info.version);
1117
+ params.set('protocol', info.protocol.toString());
1118
+ params.set('client_protocol', info.clientProtocol.toString());
1119
+ if (info.deviceModel) {
1120
+ params.set('device_model', info.deviceModel);
1121
+ }
1122
+ if (info.os) {
1123
+ params.set('os', info.os);
1124
+ }
1125
+ if (info.osVersion) {
1126
+ params.set('os_version', info.osVersion);
1127
+ }
1128
+ if (info.browser) {
1129
+ params.set('browser', info.browser);
1130
+ }
1131
+ if (info.browserVersion) {
1132
+ params.set('browser_version', info.browserVersion);
1133
+ }
1134
+ if (opts.adaptiveStream) {
1135
+ params.set('adaptive_stream', '1');
1136
+ }
1137
+ if (opts.disableIceLite) {
1138
+ params.set('disable_ice_lite', '1');
1139
+ }
1140
+ if (typeof opts.subscriberAllowPause !== 'undefined') {
1141
+ params.set('subscriber_allow_pause', opts.subscriberAllowPause ? '1' : '0');
1142
+ }
1143
+ if (opts.reconnectReason) {
1144
+ params.set('reconnect_reason', opts.reconnectReason.toString());
1145
+ }
1146
+ // @ts-ignore
1147
+ if ((_a = navigator.connection) === null || _a === void 0 ? void 0 : _a.type) {
1148
+ // @ts-ignore
1149
+ params.set('network', navigator.connection.type);
1150
+ }
1151
+ return params;
1152
+ }
1153
+ function createJoinRequestConnectionParams(token, info, opts, publisherOffer) {
1154
+ return __awaiter(this, void 0, void 0, function* () {
1155
+ const params = new URLSearchParams();
1156
+ params.set('access_token', token);
1157
+ const joinRequest = new JoinRequest({
1158
+ clientInfo: info,
1159
+ connectionSettings: new ConnectionSettings({
1160
+ autoSubscribe: !!opts.autoSubscribe,
1161
+ adaptiveStream: !!opts.adaptiveStream,
1162
+ disableIceLite: !!opts.disableIceLite,
1163
+ subscriberAllowPause: opts.subscriberAllowPause
1164
+ }),
1165
+ reconnect: !!opts.reconnect,
1166
+ participantSid: opts.sid ? opts.sid : undefined,
1167
+ publisherOffer: publisherOffer
1168
+ });
1169
+ if (opts.reconnectReason) {
1170
+ joinRequest.reconnectReason = opts.reconnectReason;
1171
+ }
1172
+ const joinRequestBytes = joinRequest.toBinary();
1173
+ let requestBytes;
1174
+ let compression;
1175
+ if (isCompressionStreamSupported()) {
1176
+ const stream = new CompressionStream('gzip');
1177
+ const writer = stream.writable.getWriter();
1178
+ writer.write(new Uint8Array(joinRequestBytes));
1179
+ writer.close();
1180
+ const chunks = [];
1181
+ const reader = stream.readable.getReader();
1182
+ while (true) {
1183
+ const _yield$reader$read = yield reader.read(),
1184
+ done = _yield$reader$read.done,
1185
+ value = _yield$reader$read.value;
1186
+ if (done) break;
1187
+ chunks.push(value);
1188
+ }
1189
+ const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
1190
+ const result = new Uint8Array(totalLength);
1191
+ let offset = 0;
1192
+ for (const chunk of chunks) {
1193
+ result.set(chunk, offset);
1194
+ offset += chunk.length;
1195
+ }
1196
+ requestBytes = result;
1197
+ compression = WrappedJoinRequest_Compression.GZIP;
1198
+ } else {
1199
+ requestBytes = joinRequestBytes;
1200
+ compression = WrappedJoinRequest_Compression.NONE;
1201
+ }
1202
+ const wrappedJoinRequest = new WrappedJoinRequest({
1203
+ joinRequest: requestBytes,
1204
+ compression
1205
+ });
1206
+ const wrappedBytes = wrappedJoinRequest.toBinary();
1207
+ const bytesToBase64 = bytes => {
1208
+ const binString = Array.from(bytes, byte => String.fromCodePoint(byte)).join('');
1209
+ return btoa(binString);
1210
+ };
1211
+ params.set('join_request', bytesToBase64(wrappedBytes).replace(/\+/g, '-').replace(/\//g, '_'));
1212
+ return params;
1213
+ });
1214
+ }export{SignalClient,SignalConnectionState,toProtoSessionDescription};//# sourceMappingURL=SignalClient.mjs.map