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 @@
1
+ {"version":3,"file":"RegionUrlProvider.mjs","sources":["../../../src/room/RegionUrlProvider.ts"],"sourcesContent":["import { Mutex } from '@livekit/mutex';\nimport type { RegionInfo, RegionSettings } from '@livekit/protocol';\nimport { LoggerNames, getLogger } from '../logger';\nimport { ConnectionError, ConnectionErrorReason } from './errors';\nimport { extractMaxAgeFromRequestHeaders, isCloud } from './utils';\n\nconst log = /* @__PURE__ */ getLogger(LoggerNames.Region);\n\nexport const DEFAULT_MAX_AGE_MS = 5_000;\nexport const STOP_REFETCH_DELAY_MS = 30_000;\n\ntype CachedRegionSettings = {\n regionSettings: RegionSettings;\n updatedAtInMs: number;\n maxAgeInMs: number;\n};\n\ntype ConnectionTracker = {\n connectionCount: number;\n cleanupTimeout?: ReturnType<typeof setTimeout>;\n};\n\nexport class RegionUrlProvider {\n private static readonly cache: Map<string, CachedRegionSettings> = new Map();\n\n private static settingsTimeouts: Map<string, ReturnType<typeof setTimeout>> = new Map();\n\n private static connectionTrackers: Map<string, ConnectionTracker> = new Map();\n\n private static fetchLock = new Mutex();\n\n private static async fetchRegionSettings(\n serverUrl: URL,\n token: string,\n signal?: AbortSignal,\n ): Promise<CachedRegionSettings> {\n const unlock = await RegionUrlProvider.fetchLock.lock();\n try {\n const regionSettingsResponse = await fetch(`${getCloudConfigUrl(serverUrl)}/regions`, {\n headers: { authorization: `Bearer ${token}` },\n signal,\n });\n if (regionSettingsResponse.ok) {\n const maxAge = extractMaxAgeFromRequestHeaders(regionSettingsResponse.headers);\n const maxAgeInMs = maxAge ? maxAge * 1000 : DEFAULT_MAX_AGE_MS;\n\n const regionSettings = (await regionSettingsResponse.json()) as RegionSettings;\n return { regionSettings, updatedAtInMs: Date.now(), maxAgeInMs };\n } else {\n if (regionSettingsResponse.status === 401) {\n throw ConnectionError.notAllowed(\n `Could not fetch region settings: ${regionSettingsResponse.statusText}`,\n regionSettingsResponse.status,\n );\n } else {\n throw ConnectionError.internal(\n `Could not fetch region settings: ${regionSettingsResponse.statusText}`,\n );\n }\n }\n } catch (e: unknown) {\n if (e instanceof ConnectionError) {\n // rethrow connection errors\n throw e;\n } else if (signal?.aborted) {\n throw ConnectionError.cancelled(`Region fetching was aborted`);\n } else {\n // wrap other errors as connection errors\n throw ConnectionError.serverUnreachable(\n `Could not fetch region settings, ${e instanceof Error ? `${e.name}: ${e.message}` : e}`,\n );\n }\n } finally {\n unlock();\n }\n }\n\n private static async scheduleRefetch(url: URL, token: string, maxAgeInMs: number) {\n const timeout = RegionUrlProvider.settingsTimeouts.get(url.hostname);\n clearTimeout(timeout);\n RegionUrlProvider.settingsTimeouts.set(\n url.hostname,\n setTimeout(async () => {\n try {\n const newSettings = await RegionUrlProvider.fetchRegionSettings(url, token);\n RegionUrlProvider.updateCachedRegionSettings(url, token, newSettings);\n } catch (error: unknown) {\n if (\n error instanceof ConnectionError &&\n error.reason === ConnectionErrorReason.NotAllowed\n ) {\n log.debug('token is not valid, cancelling auto region refresh');\n return;\n }\n log.debug('auto refetching of region settings failed', { error });\n // continue retrying with the same max age\n RegionUrlProvider.scheduleRefetch(url, token, maxAgeInMs);\n }\n }, maxAgeInMs),\n );\n }\n\n private static updateCachedRegionSettings(\n url: URL,\n token: string,\n settings: CachedRegionSettings,\n ) {\n RegionUrlProvider.cache.set(url.hostname, settings);\n RegionUrlProvider.scheduleRefetch(url, token, settings.maxAgeInMs);\n }\n\n private static stopRefetch(hostname: string) {\n const timeout = RegionUrlProvider.settingsTimeouts.get(hostname);\n if (timeout) {\n clearTimeout(timeout);\n RegionUrlProvider.settingsTimeouts.delete(hostname);\n }\n }\n\n private static scheduleCleanup(hostname: string) {\n let tracker = RegionUrlProvider.connectionTrackers.get(hostname);\n if (!tracker) {\n return;\n }\n\n // Cancel any existing cleanup timeout\n if (tracker.cleanupTimeout) {\n clearTimeout(tracker.cleanupTimeout);\n }\n\n // Schedule cleanup to stop refetch after delay\n tracker.cleanupTimeout = setTimeout(() => {\n const currentTracker = RegionUrlProvider.connectionTrackers.get(hostname);\n if (currentTracker && currentTracker.connectionCount === 0) {\n log.debug('stopping region refetch after disconnect delay', { hostname });\n RegionUrlProvider.stopRefetch(hostname);\n }\n if (currentTracker) {\n currentTracker.cleanupTimeout = undefined;\n }\n }, STOP_REFETCH_DELAY_MS);\n }\n\n private static cancelCleanup(hostname: string) {\n const tracker = RegionUrlProvider.connectionTrackers.get(hostname);\n if (tracker?.cleanupTimeout) {\n clearTimeout(tracker.cleanupTimeout);\n tracker.cleanupTimeout = undefined;\n }\n }\n\n notifyConnected() {\n const hostname = this.serverUrl.hostname;\n let tracker = RegionUrlProvider.connectionTrackers.get(hostname);\n if (!tracker) {\n tracker = { connectionCount: 0 };\n RegionUrlProvider.connectionTrackers.set(hostname, tracker);\n }\n\n tracker.connectionCount++;\n\n // Cancel any scheduled cleanup since we have an active connection\n RegionUrlProvider.cancelCleanup(hostname);\n }\n\n notifyDisconnected() {\n const hostname = this.serverUrl.hostname;\n const tracker = RegionUrlProvider.connectionTrackers.get(hostname);\n if (!tracker) {\n return;\n }\n\n tracker.connectionCount = Math.max(0, tracker.connectionCount - 1);\n\n // If no more connections, schedule cleanup\n if (tracker.connectionCount === 0) {\n RegionUrlProvider.scheduleCleanup(hostname);\n }\n }\n\n private serverUrl: URL;\n\n private token: string;\n\n private attemptedRegions: RegionInfo[] = [];\n\n constructor(url: string, token: string) {\n this.serverUrl = new URL(url);\n this.token = token;\n }\n\n updateToken(token: string) {\n this.token = token;\n const url = this.getServerUrl();\n const settings = RegionUrlProvider.cache.get(url.hostname);\n RegionUrlProvider.scheduleRefetch(\n this.serverUrl,\n this.token,\n settings?.maxAgeInMs ?? DEFAULT_MAX_AGE_MS,\n );\n }\n\n isCloud() {\n return isCloud(this.serverUrl);\n }\n\n getServerUrl() {\n return this.serverUrl;\n }\n\n /** @internal */\n async fetchRegionSettings(abortSignal?: AbortSignal): Promise<CachedRegionSettings> {\n return RegionUrlProvider.fetchRegionSettings(this.serverUrl, this.token, abortSignal);\n }\n\n async getNextBestRegionUrl(abortSignal?: AbortSignal) {\n if (!this.isCloud()) {\n throw Error('region availability is only supported for LiveKit Cloud domains');\n }\n\n let cachedSettings = RegionUrlProvider.cache.get(this.serverUrl.hostname);\n\n if (!cachedSettings || Date.now() - cachedSettings.updatedAtInMs > cachedSettings.maxAgeInMs) {\n cachedSettings = await this.fetchRegionSettings(abortSignal);\n RegionUrlProvider.updateCachedRegionSettings(this.serverUrl, this.token, cachedSettings);\n }\n\n const regionsLeft = cachedSettings.regionSettings.regions.filter(\n (region) => !this.attemptedRegions.find((attempted) => attempted.url === region.url),\n );\n if (regionsLeft.length > 0) {\n const nextRegion = regionsLeft[0];\n this.attemptedRegions.push(nextRegion);\n log.info(`switching to region: ${nextRegion.region}`, { region: nextRegion.region });\n return nextRegion.url;\n } else {\n return null;\n }\n }\n\n resetAttempts() {\n this.attemptedRegions = [];\n }\n\n setServerReportedRegions(settings: CachedRegionSettings) {\n RegionUrlProvider.updateCachedRegionSettings(this.serverUrl, this.token, settings);\n }\n}\n\nfunction getCloudConfigUrl(serverUrl: URL) {\n return `${serverUrl.protocol.replace('ws', 'http')}//${serverUrl.host}/settings`;\n}\n"],"names":["log","getLogger","LoggerNames","Region","DEFAULT_MAX_AGE_MS","STOP_REFETCH_DELAY_MS","RegionUrlProvider","fetchRegionSettings","serverUrl","token","signal","unlock","fetchLock","lock","regionSettingsResponse","fetch","concat","getCloudConfigUrl","headers","authorization","ok","maxAge","extractMaxAgeFromRequestHeaders","maxAgeInMs","regionSettings","json","updatedAtInMs","Date","now","status","ConnectionError","notAllowed","statusText","internal","e","aborted","cancelled","serverUnreachable","Error","name","message","scheduleRefetch","url","timeout","settingsTimeouts","get","hostname","clearTimeout","set","setTimeout","__awaiter","newSettings","updateCachedRegionSettings","error","reason","ConnectionErrorReason","NotAllowed","debug","settings","cache","stopRefetch","delete","scheduleCleanup","tracker","connectionTrackers","cleanupTimeout","currentTracker","connectionCount","undefined","cancelCleanup","notifyConnected","notifyDisconnected","Math","max","constructor","attemptedRegions","URL","updateToken","getServerUrl","_a","isCloud","abortSignal","getNextBestRegionUrl","cachedSettings","regionsLeft","regions","filter","region","find","attempted","length","nextRegion","push","info","resetAttempts","setServerReportedRegions","Map","Mutex","protocol","replace","host"],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ // This file was generated from JSON Schema using quicktype, do not modify it directly.
2
+ // The code generation lives at https://github.com/livekit/attribute-definitions
3
+ //
4
+ // To parse this data:
5
+ //
6
+ // import { Convert, AgentAttributes, TranscriptionAttributes } from "./file";
7
+ //
8
+ // const agentAttributes = Convert.toAgentAttributes(json);
9
+ // const transcriptionAttributes = Convert.toTranscriptionAttributes(json);
10
+ // Converts JSON strings to/from your types
11
+ class Convert {
12
+ static toAgentAttributes(json) {
13
+ return JSON.parse(json);
14
+ }
15
+ static agentAttributesToJson(value) {
16
+ return JSON.stringify(value);
17
+ }
18
+ static toTranscriptionAttributes(json) {
19
+ return JSON.parse(json);
20
+ }
21
+ static transcriptionAttributesToJson(value) {
22
+ return JSON.stringify(value);
23
+ }
24
+ }export{Convert};//# sourceMappingURL=attribute-typings.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attribute-typings.mjs","sources":["../../../src/room/attribute-typings.ts"],"sourcesContent":["// This file was generated from JSON Schema using quicktype, do not modify it directly.\n// The code generation lives at https://github.com/livekit/attribute-definitions\n//\n// To parse this data:\n//\n// import { Convert, AgentAttributes, TranscriptionAttributes } from \"./file\";\n//\n// const agentAttributes = Convert.toAgentAttributes(json);\n// const transcriptionAttributes = Convert.toTranscriptionAttributes(json);\n\nexport interface AgentAttributes {\n 'lk.agent.inputs'?: AgentInput[];\n 'lk.agent.outputs'?: AgentOutput[];\n 'lk.agent.state'?: AgentState;\n 'lk.publish_on_behalf'?: string;\n [property: string]: any;\n}\n\nexport type AgentInput = 'audio' | 'video' | 'text';\n\nexport type AgentOutput = 'transcription' | 'audio';\n\nexport type AgentState = 'idle' | 'initializing' | 'listening' | 'thinking' | 'speaking';\n\n/**\n * Schema for transcription-related attributes\n */\nexport interface TranscriptionAttributes {\n /**\n * The segment id of the transcription\n */\n 'lk.segment_id'?: string;\n /**\n * The associated track id of the transcription\n */\n 'lk.transcribed_track_id'?: string;\n /**\n * Whether the transcription is final\n */\n 'lk.transcription_final'?: boolean;\n [property: string]: any;\n}\n\n// Converts JSON strings to/from your types\nexport class Convert {\n public static toAgentAttributes(json: string): AgentAttributes {\n return JSON.parse(json);\n }\n\n public static agentAttributesToJson(value: AgentAttributes): string {\n return JSON.stringify(value);\n }\n\n public static toTranscriptionAttributes(json: string): TranscriptionAttributes {\n return JSON.parse(json);\n }\n\n public static transcriptionAttributesToJson(value: TranscriptionAttributes): string {\n return JSON.stringify(value);\n }\n}\n"],"names":["Convert","toAgentAttributes","json","JSON","parse","agentAttributesToJson","value","stringify","toTranscriptionAttributes","transcriptionAttributesToJson"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAmCA;MACaA,OAAO,CAAA;EACX,OAAOC,iBAAiBA,CAACC,IAAY,EAAA;AAC1C,IAAA,OAAOC,IAAI,CAACC,KAAK,CAACF,IAAI,CAAC;AACzB,EAAA;EAEO,OAAOG,qBAAqBA,CAACC,KAAsB,EAAA;AACxD,IAAA,OAAOH,IAAI,CAACI,SAAS,CAACD,KAAK,CAAC;AAC9B,EAAA;EAEO,OAAOE,yBAAyBA,CAACN,IAAY,EAAA;AAClD,IAAA,OAAOC,IAAI,CAACC,KAAK,CAACF,IAAI,CAAC;AACzB,EAAA;EAEO,OAAOO,6BAA6BA,CAACH,KAA8B,EAAA;AACxE,IAAA,OAAOH,IAAI,CAACI,SAAS,CAACD,KAAK,CAAC;AAC9B,EAAA;AACD"}
@@ -0,0 +1,19 @@
1
+ import {CoreRoom}from'./CoreRoom.mjs';import {installExtensions}from'./extensions.mjs';/**
2
+ * Creates a light room with exactly the given extensions. Dependencies install on their own
3
+ * (`rpc` brings `dataStreams`); an extension you list, configured or not, wins over the default a
4
+ * dependency would pull in. The result carries the extension methods under the names the full
5
+ * `Room` uses, so code moves between the two builds unchanged.
6
+ *
7
+ * @example
8
+ * ```typescript
9
+ * const room = createRoom({ adaptiveStream: true }, [rpc, e2ee({ keyProvider, worker })]);
10
+ * room.registerRpcMethod('greet', handler);
11
+ * await room.connect(url, token);
12
+ * ```
13
+ * @experimental
14
+ */
15
+ function createRoom(options, extensions) {
16
+ const room = new CoreRoom(options);
17
+ installExtensions(room, extensions !== null && extensions !== void 0 ? extensions : []);
18
+ return room;
19
+ }export{createRoom};//# sourceMappingURL=createRoom.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"createRoom.mjs","sources":["../../../src/room/createRoom.ts"],"sourcesContent":["import type { CoreRoomOptions } from '../options';\nimport { CoreRoom } from './CoreRoom';\nimport { type ExtensionApis, type RoomExtension, installExtensions } from './extensions';\n\n/**\n * Creates a light room with exactly the given extensions. Dependencies install on their own\n * (`rpc` brings `dataStreams`); an extension you list, configured or not, wins over the default a\n * dependency would pull in. The result carries the extension methods under the names the full\n * `Room` uses, so code moves between the two builds unchanged.\n *\n * @example\n * ```typescript\n * const room = createRoom({ adaptiveStream: true }, [rpc, e2ee({ keyProvider, worker })]);\n * room.registerRpcMethod('greet', handler);\n * await room.connect(url, token);\n * ```\n * @experimental\n */\nexport function createRoom<const E extends readonly RoomExtension<any, any>[] = []>(\n options?: CoreRoomOptions,\n extensions?: E,\n): CoreRoom & ExtensionApis<E[number]> {\n const room = new CoreRoom(options);\n installExtensions(room, extensions ?? []);\n return room as CoreRoom & ExtensionApis<E[number]>;\n}\n"],"names":["createRoom","options","extensions","room","CoreRoom","installExtensions"],"mappings":"uFAIA;;;;;;;;;;;;;AAaG;AACG,SAAUA,UAAUA,CACxBC,OAAyB,EACzBC,UAAc,EAAA;AAEd,EAAA,MAAMC,IAAI,GAAG,IAAIC,QAAQ,CAACH,OAAO,CAAC;AAClCI,EAAAA,iBAAiB,CAACF,IAAI,EAAED,UAAU,KAAA,IAAA,IAAVA,UAAU,KAAA,MAAA,GAAVA,UAAU,GAAI,EAAE,CAAC;AACzC,EAAA,OAAOC,IAA2C;AACpD"}
@@ -0,0 +1,188 @@
1
+ import {NegotiatedDataChannelID}from'@livekit/protocol';import'tslib';import'@livekit/mutex';import'../../utils/TypedPromise.mjs';import'../errors.mjs';import {LossyDataChannel}from'./LossyDataChannel.mjs';import {ReliableDataChannel}from'./ReliableDataChannel.mjs';import {DataChannelKind,dataChannelHighWaterMark,dataChannelLowWaterMark}from'./types.mjs';const lossyDataChannelLabel = '_lossy';
2
+ const reliableDataChannelLabel = '_reliable';
3
+ const dataTrackDataChannelLabel = '_data_track';
4
+ /** Unhooks every handler the manager may have wired onto `dc`, ahead of closing it. */
5
+ function clearHandlers(dc) {
6
+ dc.onbufferedamountlow = null;
7
+ dc.onclose = null;
8
+ dc.onclosing = null;
9
+ dc.onerror = null;
10
+ dc.onmessage = null;
11
+ dc.onopen = null;
12
+ }
13
+ /**
14
+ * Owns the engine's data channels: the three flow-controlled publisher channel wrappers (which
15
+ * live for the engine's lifetime and have RTCDataChannel handles attached/detached as peer
16
+ * connections come and go) plus the subscriber-side receive handles adopted by label.
17
+ *
18
+ * Handle turnover goes through {@link FlowControlledDataChannel.attach}/`detach`, which close the
19
+ * released handle and reject parked headroom waiters as a built-in — there is no separate
20
+ * invalidation step to forget.
21
+ */
22
+ class DataChannelManager {
23
+ constructor(opts) {
24
+ this.negotiated = false;
25
+ this.opts = opts;
26
+ const flowControlOptions = kind => ({
27
+ kind,
28
+ lowWaterMark: dataChannelLowWaterMark(kind),
29
+ highWaterMark: dataChannelHighWaterMark(kind),
30
+ isEngineClosed: opts.isEngineClosed,
31
+ onBufferStatusChanged: isLow => opts.onBufferStatusChanged(kind, isLow)
32
+ });
33
+ this.reliable = new ReliableDataChannel(Object.assign(Object.assign({}, flowControlOptions(DataChannelKind.RELIABLE)), {
34
+ isDeferringSends: opts.isReconnecting
35
+ }));
36
+ this.lossy = new LossyDataChannel(Object.assign(Object.assign({}, flowControlOptions(DataChannelKind.LOSSY)), {
37
+ // Classic lossy user data: a stale packet is worthless, so drop instead of queueing.
38
+ bufferFullBehavior: 'drop',
39
+ shouldSkipSends: opts.isReconnecting
40
+ }));
41
+ this.dataTrack = new LossyDataChannel(Object.assign(Object.assign({}, flowControlOptions(DataChannelKind.DATA_TRACK_LOSSY)), {
42
+ // Data tracks backpressure the producer instead — it decides what to skip at frame
43
+ // granularity rather than the engine dropping arbitrary chunks out of frames.
44
+ bufferFullBehavior: 'wait',
45
+ shouldSkipSends: opts.isReconnecting
46
+ }));
47
+ }
48
+ /** The flow-control wrapper for `kind`. */
49
+ channelFor(kind) {
50
+ switch (kind) {
51
+ case DataChannelKind.RELIABLE:
52
+ return this.reliable;
53
+ case DataChannelKind.LOSSY:
54
+ return this.lossy;
55
+ case DataChannelKind.DATA_TRACK_LOSSY:
56
+ return this.dataTrack;
57
+ }
58
+ }
59
+ /** The raw RTCDataChannel handle for `kind`, publisher side by default. */
60
+ getHandle(kind) {
61
+ let subscriber = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
62
+ if (!subscriber) {
63
+ return this.channelFor(kind).channelHandle;
64
+ }
65
+ switch (kind) {
66
+ case DataChannelKind.RELIABLE:
67
+ return this.reliableSub;
68
+ case DataChannelKind.LOSSY:
69
+ return this.lossySub;
70
+ case DataChannelKind.DATA_TRACK_LOSSY:
71
+ return this.dataTrackSub;
72
+ }
73
+ }
74
+ get hasPublisherChannels() {
75
+ return Boolean(this.reliable.channelHandle || this.lossy.channelHandle || this.dataTrack.channelHandle);
76
+ }
77
+ /** Whether the current publisher channels were created as negotiated (fixed IDs). */
78
+ get publisherChannelsNegotiated() {
79
+ return this.hasPublisherChannels && this.negotiated;
80
+ }
81
+ /**
82
+ * Creates the three publisher data channels on the given transport, wires their handlers, and
83
+ * attaches them to the wrappers — attaching closes any replaced channel objects and rejects the
84
+ * waiters still parked on them.
85
+ *
86
+ * With `negotiated`, the channels use fixed SCTP stream IDs agreed with the server instead of
87
+ * the in-band DCEP open handshake, so the server can send on them right away.
88
+ */
89
+ createPublisherChannels(pcManager) {
90
+ let negotiated = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
91
+ // Recreating (the Safari null-id path, or the in-band fallback after join): attaching the new
92
+ // handles below closes the old ones, so unhook them first — the old channel's close must not
93
+ // report an unexpected close.
94
+ for (const channel of [this.lossy, this.reliable, this.dataTrack]) {
95
+ const old = channel.channelHandle;
96
+ if (old) {
97
+ clearHandlers(old);
98
+ }
99
+ }
100
+ const wire = (channel, dc, onMessage) => {
101
+ // also handle messages over the pub channel, for backwards compatibility
102
+ dc.onmessage = onMessage;
103
+ // handle datachannel errors
104
+ dc.onerror = this.opts.onDataError;
105
+ // detect unexpected publisher data channel closes
106
+ dc.onclose = () => this.opts.onChannelClose(channel.kind);
107
+ // set up dc buffer threshold - if this is not set, it will default to 0
108
+ dc.bufferedAmountLowThreshold = channel.lowWaterMark;
109
+ // handle buffer amount low events
110
+ dc.onbufferedamountlow = () => channel.refreshBufferStatus();
111
+ channel.attach(dc);
112
+ };
113
+ const idFor = id => negotiated ? {
114
+ negotiated,
115
+ id
116
+ } : {};
117
+ wire(this.lossy, pcManager.createPublisherDataChannel(lossyDataChannelLabel, Object.assign({
118
+ ordered: false,
119
+ maxRetransmits: 0
120
+ }, idFor(NegotiatedDataChannelID.NDCI_LOSSY))), this.opts.onDataMessage);
121
+ wire(this.reliable, pcManager.createPublisherDataChannel(reliableDataChannelLabel, Object.assign({
122
+ ordered: true
123
+ }, idFor(NegotiatedDataChannelID.NDCI_RELIABLE))), this.opts.onDataMessage);
124
+ wire(this.dataTrack, pcManager.createPublisherDataChannel(dataTrackDataChannelLabel, Object.assign({
125
+ ordered: false,
126
+ maxRetransmits: 0
127
+ }, idFor(NegotiatedDataChannelID.NDCI_DATA_TRACK))), this.opts.onDataTrackMessage);
128
+ this.negotiated = negotiated;
129
+ this.lossy.startThresholdTuning();
130
+ }
131
+ /**
132
+ * Adopts a subscriber-side data channel by label, wiring the matching receive handler.
133
+ * Returns false for labels this manager doesn't own.
134
+ */
135
+ adoptSubscriberChannel(channel) {
136
+ let handler;
137
+ if (channel.label === reliableDataChannelLabel) {
138
+ this.reliableSub = channel;
139
+ handler = this.opts.onDataMessage;
140
+ } else if (channel.label === lossyDataChannelLabel) {
141
+ this.lossySub = channel;
142
+ handler = this.opts.onDataMessage;
143
+ } else if (channel.label === dataTrackDataChannelLabel) {
144
+ this.dataTrackSub = channel;
145
+ handler = this.opts.onDataTrackMessage;
146
+ } else {
147
+ return false;
148
+ }
149
+ channel.onmessage = handler;
150
+ return true;
151
+ }
152
+ /**
153
+ * Tears down all channels for a peer-connection cleanup: strips handlers, closes the handles,
154
+ * and resets the reliable session state. Detaching the publisher handles closes them and
155
+ * rejects parked waiters (the spec allows `pc.close()` to transition channels to 'closed'
156
+ * without firing events, so waiting for browser close events is not an option).
157
+ */
158
+ teardown() {
159
+ // Detach the data channel handlers before closing anything. Closing a peer connection tears
160
+ // down the SCTP transport, which can dispatch `error`/`close` events on the still-open data
161
+ // channels; if our handlers are still attached at that point, handleDataError logs a spurious
162
+ // "Unknown DataChannel error" during an otherwise graceful disconnect. Removing the handlers
163
+ // before dc.close()/pcManager.close() makes this deterministic regardless of how/when the
164
+ // browser dispatches those teardown events. See livekit/client-sdk-js#1953.
165
+ const publisherDataChannels = [this.lossy, this.reliable, this.dataTrack];
166
+ const subscriberDataChannels = [this.lossySub, this.reliableSub, this.dataTrackSub];
167
+ // Publisher handles are closed by detach, which also rejects parked waiters.
168
+ for (const channel of publisherDataChannels) {
169
+ const dc = channel.channelHandle;
170
+ if (dc) {
171
+ clearHandlers(dc);
172
+ }
173
+ channel.detach('peer connections cleaned up');
174
+ }
175
+ // Subscriber handles have no wrapper, so close them directly.
176
+ for (const dc of subscriberDataChannels) {
177
+ if (dc) {
178
+ clearHandlers(dc);
179
+ dc.close();
180
+ }
181
+ }
182
+ this.lossySub = undefined;
183
+ this.reliableSub = undefined;
184
+ this.dataTrackSub = undefined;
185
+ // Full teardown starts the session over: drop replay state and restart sequencing.
186
+ this.reliable.reset();
187
+ }
188
+ }export{DataChannelManager};//# sourceMappingURL=DataChannelManager.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"DataChannelManager.mjs","sources":["../../../../src/room/data-channel/DataChannelManager.ts"],"sourcesContent":["import { NegotiatedDataChannelID } from '@livekit/protocol';\nimport type { PCTransportManager } from '../PCTransportManager';\nimport { FlowControlledDataChannel } from './FlowControlledDataChannel';\nimport { LossyDataChannel } from './LossyDataChannel';\nimport { ReliableDataChannel } from './ReliableDataChannel';\nimport { DataChannelKind, dataChannelHighWaterMark, dataChannelLowWaterMark } from './types';\n\nconst lossyDataChannelLabel = '_lossy';\nconst reliableDataChannelLabel = '_reliable';\nconst dataTrackDataChannelLabel = '_data_track';\n\nexport interface DataChannelManagerOptions {\n /** Whether the owning engine has been closed — a closed engine rejects headroom waiters. */\n isEngineClosed: () => boolean;\n /**\n * Whether a reconnect attempt is underway: reliable sends defer to the resume replay and lossy\n * sends are skipped while this is true.\n */\n isReconnecting: () => boolean;\n onDataMessage: (message: MessageEvent) => void;\n onDataTrackMessage: (message: MessageEvent) => void;\n onDataError: (event: Event) => void;\n onChannelClose: (kind: DataChannelKind) => void;\n /** A channel's buffer crossed its low-water mark (debounced). Drives DCBufferStatusChanged. */\n onBufferStatusChanged: (kind: DataChannelKind, isLow: boolean) => void;\n}\n\n/** Unhooks every handler the manager may have wired onto `dc`, ahead of closing it. */\nfunction clearHandlers(dc: RTCDataChannel) {\n dc.onbufferedamountlow = null;\n dc.onclose = null;\n dc.onclosing = null;\n dc.onerror = null;\n dc.onmessage = null;\n dc.onopen = null;\n}\n\n/**\n * Owns the engine's data channels: the three flow-controlled publisher channel wrappers (which\n * live for the engine's lifetime and have RTCDataChannel handles attached/detached as peer\n * connections come and go) plus the subscriber-side receive handles adopted by label.\n *\n * Handle turnover goes through {@link FlowControlledDataChannel.attach}/`detach`, which close the\n * released handle and reject parked headroom waiters as a built-in — there is no separate\n * invalidation step to forget.\n */\nexport class DataChannelManager {\n readonly reliable: ReliableDataChannel;\n\n readonly lossy: LossyDataChannel;\n\n readonly dataTrack: LossyDataChannel;\n\n private reliableSub?: RTCDataChannel;\n\n private lossySub?: RTCDataChannel;\n\n private dataTrackSub?: RTCDataChannel;\n\n private opts: DataChannelManagerOptions;\n\n private negotiated = false;\n\n constructor(opts: DataChannelManagerOptions) {\n this.opts = opts;\n const flowControlOptions = (kind: DataChannelKind) => ({\n kind,\n lowWaterMark: dataChannelLowWaterMark(kind),\n highWaterMark: dataChannelHighWaterMark(kind),\n isEngineClosed: opts.isEngineClosed,\n onBufferStatusChanged: (isLow: boolean) => opts.onBufferStatusChanged(kind, isLow),\n });\n this.reliable = new ReliableDataChannel({\n ...flowControlOptions(DataChannelKind.RELIABLE),\n isDeferringSends: opts.isReconnecting,\n });\n this.lossy = new LossyDataChannel({\n ...flowControlOptions(DataChannelKind.LOSSY),\n // Classic lossy user data: a stale packet is worthless, so drop instead of queueing.\n bufferFullBehavior: 'drop',\n shouldSkipSends: opts.isReconnecting,\n });\n this.dataTrack = new LossyDataChannel({\n ...flowControlOptions(DataChannelKind.DATA_TRACK_LOSSY),\n // Data tracks backpressure the producer instead — it decides what to skip at frame\n // granularity rather than the engine dropping arbitrary chunks out of frames.\n bufferFullBehavior: 'wait',\n shouldSkipSends: opts.isReconnecting,\n });\n }\n\n /** The flow-control wrapper for `kind`. */\n channelFor(kind: DataChannelKind): FlowControlledDataChannel {\n switch (kind) {\n case DataChannelKind.RELIABLE:\n return this.reliable;\n case DataChannelKind.LOSSY:\n return this.lossy;\n case DataChannelKind.DATA_TRACK_LOSSY:\n return this.dataTrack;\n }\n }\n\n /** The raw RTCDataChannel handle for `kind`, publisher side by default. */\n getHandle(kind: DataChannelKind, subscriber: boolean = false): RTCDataChannel | undefined {\n if (!subscriber) {\n return this.channelFor(kind).channelHandle;\n }\n switch (kind) {\n case DataChannelKind.RELIABLE:\n return this.reliableSub;\n case DataChannelKind.LOSSY:\n return this.lossySub;\n case DataChannelKind.DATA_TRACK_LOSSY:\n return this.dataTrackSub;\n }\n }\n\n get hasPublisherChannels(): boolean {\n return Boolean(\n this.reliable.channelHandle || this.lossy.channelHandle || this.dataTrack.channelHandle,\n );\n }\n\n /** Whether the current publisher channels were created as negotiated (fixed IDs). */\n get publisherChannelsNegotiated(): boolean {\n return this.hasPublisherChannels && this.negotiated;\n }\n\n /**\n * Creates the three publisher data channels on the given transport, wires their handlers, and\n * attaches them to the wrappers — attaching closes any replaced channel objects and rejects the\n * waiters still parked on them.\n *\n * With `negotiated`, the channels use fixed SCTP stream IDs agreed with the server instead of\n * the in-band DCEP open handshake, so the server can send on them right away.\n */\n createPublisherChannels(pcManager: PCTransportManager, negotiated: boolean = false) {\n // Recreating (the Safari null-id path, or the in-band fallback after join): attaching the new\n // handles below closes the old ones, so unhook them first — the old channel's close must not\n // report an unexpected close.\n for (const channel of [this.lossy, this.reliable, this.dataTrack]) {\n const old = channel.channelHandle;\n if (old) {\n clearHandlers(old);\n }\n }\n\n const wire = (\n channel: FlowControlledDataChannel,\n dc: RTCDataChannel,\n onMessage: (message: MessageEvent) => void,\n ) => {\n // also handle messages over the pub channel, for backwards compatibility\n dc.onmessage = onMessage;\n // handle datachannel errors\n dc.onerror = this.opts.onDataError;\n // detect unexpected publisher data channel closes\n dc.onclose = () => this.opts.onChannelClose(channel.kind);\n // set up dc buffer threshold - if this is not set, it will default to 0\n dc.bufferedAmountLowThreshold = channel.lowWaterMark;\n // handle buffer amount low events\n dc.onbufferedamountlow = () => channel.refreshBufferStatus();\n channel.attach(dc);\n };\n\n const idFor = (id: number) => (negotiated ? { negotiated, id } : {});\n\n wire(\n this.lossy,\n pcManager.createPublisherDataChannel(lossyDataChannelLabel, {\n ordered: false,\n maxRetransmits: 0,\n ...idFor(NegotiatedDataChannelID.NDCI_LOSSY),\n }),\n this.opts.onDataMessage,\n );\n wire(\n this.reliable,\n pcManager.createPublisherDataChannel(reliableDataChannelLabel, {\n ordered: true,\n ...idFor(NegotiatedDataChannelID.NDCI_RELIABLE),\n }),\n this.opts.onDataMessage,\n );\n wire(\n this.dataTrack,\n pcManager.createPublisherDataChannel(dataTrackDataChannelLabel, {\n ordered: false,\n maxRetransmits: 0,\n ...idFor(NegotiatedDataChannelID.NDCI_DATA_TRACK),\n }),\n this.opts.onDataTrackMessage,\n );\n this.negotiated = negotiated;\n\n this.lossy.startThresholdTuning();\n }\n\n /**\n * Adopts a subscriber-side data channel by label, wiring the matching receive handler.\n * Returns false for labels this manager doesn't own.\n */\n adoptSubscriberChannel(channel: RTCDataChannel): boolean {\n let handler: (message: MessageEvent) => void;\n if (channel.label === reliableDataChannelLabel) {\n this.reliableSub = channel;\n handler = this.opts.onDataMessage;\n } else if (channel.label === lossyDataChannelLabel) {\n this.lossySub = channel;\n handler = this.opts.onDataMessage;\n } else if (channel.label === dataTrackDataChannelLabel) {\n this.dataTrackSub = channel;\n handler = this.opts.onDataTrackMessage;\n } else {\n return false;\n }\n channel.onmessage = handler;\n return true;\n }\n\n /**\n * Tears down all channels for a peer-connection cleanup: strips handlers, closes the handles,\n * and resets the reliable session state. Detaching the publisher handles closes them and\n * rejects parked waiters (the spec allows `pc.close()` to transition channels to 'closed'\n * without firing events, so waiting for browser close events is not an option).\n */\n teardown() {\n // Detach the data channel handlers before closing anything. Closing a peer connection tears\n // down the SCTP transport, which can dispatch `error`/`close` events on the still-open data\n // channels; if our handlers are still attached at that point, handleDataError logs a spurious\n // \"Unknown DataChannel error\" during an otherwise graceful disconnect. Removing the handlers\n // before dc.close()/pcManager.close() makes this deterministic regardless of how/when the\n // browser dispatches those teardown events. See livekit/client-sdk-js#1953.\n const publisherDataChannels = [this.lossy, this.reliable, this.dataTrack];\n const subscriberDataChannels = [this.lossySub, this.reliableSub, this.dataTrackSub];\n\n // Publisher handles are closed by detach, which also rejects parked waiters.\n for (const channel of publisherDataChannels) {\n const dc = channel.channelHandle;\n if (dc) {\n clearHandlers(dc);\n }\n channel.detach('peer connections cleaned up');\n }\n // Subscriber handles have no wrapper, so close them directly.\n for (const dc of subscriberDataChannels) {\n if (dc) {\n clearHandlers(dc);\n dc.close();\n }\n }\n this.lossySub = undefined;\n this.reliableSub = undefined;\n this.dataTrackSub = undefined;\n\n // Full teardown starts the session over: drop replay state and restart sequencing.\n this.reliable.reset();\n }\n}\n"],"names":["lossyDataChannelLabel","reliableDataChannelLabel","dataTrackDataChannelLabel","clearHandlers","dc","onbufferedamountlow","onclose","onclosing","onerror","onmessage","onopen","DataChannelManager","constructor","opts","negotiated","flowControlOptions","kind","lowWaterMark","dataChannelLowWaterMark","highWaterMark","dataChannelHighWaterMark","isEngineClosed","onBufferStatusChanged","isLow","reliable","ReliableDataChannel","Object","assign","DataChannelKind","RELIABLE","isDeferringSends","isReconnecting","lossy","LossyDataChannel","LOSSY","bufferFullBehavior","shouldSkipSends","dataTrack","DATA_TRACK_LOSSY","channelFor","getHandle","subscriber","arguments","length","undefined","channelHandle","reliableSub","lossySub","dataTrackSub","hasPublisherChannels","Boolean","publisherChannelsNegotiated","createPublisherChannels","pcManager","channel","old","wire","onMessage","onDataError","onChannelClose","bufferedAmountLowThreshold","refreshBufferStatus","attach","idFor","id","createPublisherDataChannel","ordered","maxRetransmits","NegotiatedDataChannelID","NDCI_LOSSY","onDataMessage","NDCI_RELIABLE","NDCI_DATA_TRACK","onDataTrackMessage","startThresholdTuning","adoptSubscriberChannel","handler","label","teardown","publisherDataChannels","subscriberDataChannels","detach","close","reset"],"mappings":"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"}
@@ -0,0 +1,185 @@
1
+ import {__awaiter}from'tslib';import {Mutex}from'@livekit/mutex';import TypedPromise from'../../utils/TypedPromise.mjs';import {UnexpectedConnectionState}from'../errors.mjs';/**
2
+ * Two-watermark flow control for one data channel kind.
3
+ *
4
+ * Owns the per-kind headroom gate: senders proceed freely while the buffer is at or below the
5
+ * high-water mark and otherwise block — serialized FIFO through a mutex — until the browser's
6
+ * `bufferedamountlow` event (armed at the low-water mark) signals the buffer has drained. The
7
+ * serialization prevents woken senders from all refilling at once and overflowing the SCTP send
8
+ * buffer (see livekit/client-sdk-js#1995).
9
+ *
10
+ * Waiters are parked on the channel object captured at wait entry. If that object stops being
11
+ * current — replaced or torn down — its events may never fire again, so the owner must call
12
+ * {@link invalidateWaiters}, which aborts parked waiters (releasing the gate); the next waiter
13
+ * gets a fresh controller. {@link attach} and {@link detach} do this, and close the released
14
+ * handle, as part of handle turnover.
15
+ */
16
+ class FlowControlledDataChannel {
17
+ constructor(opts) {
18
+ /** Last emitted low-water status; starts true (an empty buffer is below the mark). */
19
+ this.bufferStatusLow = true;
20
+ this.headroomLock = new Mutex();
21
+ /** Cancels parked headroom waiters when the handle is replaced or torn down. */
22
+ this.waiterAbortController = new AbortController();
23
+ this.kind = opts.kind;
24
+ this.lowWaterMark = opts.lowWaterMark;
25
+ this.highWaterMark = opts.highWaterMark;
26
+ this.isEngineClosed = opts.isEngineClosed;
27
+ this.onBufferStatusChanged = opts.onBufferStatusChanged;
28
+ }
29
+ /** The currently attached RTCDataChannel handle, if any. */
30
+ get channelHandle() {
31
+ return this.handle;
32
+ }
33
+ /**
34
+ * Attaches the channel handle this wrapper controls. Replacing an existing handle closes it and
35
+ * rejects parked waiters — their events would never fire again on the abandoned object — and
36
+ * installs a fresh controller. Wrappers outlive their handles: this is the one place handle
37
+ * turnover happens, so a handle the wrapper lets go of is never left open, and stranding a
38
+ * waiter is structurally impossible.
39
+ */
40
+ attach(dc) {
41
+ const old = this.handle;
42
+ this.handle = dc;
43
+ if (old && old !== dc) {
44
+ this.release(old, 'data channel replaced');
45
+ }
46
+ }
47
+ /** Detaches and closes the handle on teardown, rejecting parked waiters. */
48
+ detach() {
49
+ let reason = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'data channel torn down';
50
+ const old = this.handle;
51
+ this.handle = undefined;
52
+ if (old) {
53
+ this.release(old, reason);
54
+ }
55
+ }
56
+ /**
57
+ * Closes a handle the wrapper no longer controls. `close()` moves it to `closing` synchronously,
58
+ * so senders still holding it (queued on the headroom lock) fail the open check once they get
59
+ * the lock. Parked waiters are aborted directly instead of relying on the `close` event, which
60
+ * fires asynchronously, if at all (the spec lets `pc.close()` skip it). Strip any handlers that
61
+ * must not observe the close before calling this.
62
+ */
63
+ release(dc, reason) {
64
+ this.invalidateWaiters(reason);
65
+ dc.close();
66
+ }
67
+ getChannel() {
68
+ return this.handle;
69
+ }
70
+ /**
71
+ * Whether the send buffer has room to accept more data (the send gate). Senders proceed while
72
+ * this is true and block once it goes false. Callers resolve the handle (and decide what an
73
+ * absent one means) before asking.
74
+ */
75
+ isBelowHighWaterMark(dc) {
76
+ // RTCDataChannel has no built-in high-water mark, so we compare against our static mark.
77
+ return dc.bufferedAmount <= this.highWaterMark;
78
+ }
79
+ /**
80
+ * Whether the send buffer has drained to its low-water mark. Drives the engine's public
81
+ * DCBufferStatusChanged event.
82
+ */
83
+ isBelowLowWaterMark(dc) {
84
+ // Read the channel's own threshold: it is tuned dynamically for the lossy channel.
85
+ return dc.bufferedAmount <= dc.bufferedAmountLowThreshold;
86
+ }
87
+ /**
88
+ * Acquires the headroom lock, resolving with the unlock function. Batch senders (the resume
89
+ * replay) hold it across all of their sends so no other sender can interleave, calling
90
+ * {@link waitForHeadroomWithoutLock} per message to respect flow control within the batch.
91
+ */
92
+ lockHeadroom() {
93
+ return this.headroomLock.lock();
94
+ }
95
+ /**
96
+ * Resolves once the caller may send on `dc`: immediately while its send buffer is at or below
97
+ * the high-water mark, otherwise once the buffer has drained to the low-water mark (the
98
+ * `bufferedamountlow` event). Callers are serialized through the headroom lock so that, when
99
+ * the buffer drains, they refill it one at a time (up to the high-water mark) rather than all
100
+ * sending at once and overflowing the SCTP send buffer (see livekit/client-sdk-js#1995). The
101
+ * checks run inside the lock so queued callers proceed in FIFO order.
102
+ *
103
+ * The caller passes the handle it resolved before queueing, and the wait is against that one
104
+ * handle throughout: if it was replaced meanwhile, it has been closed, so the wait rejects
105
+ * rather than letting the caller send on the replacement out of turn.
106
+ */
107
+ waitForHeadroomWithLock(dc) {
108
+ return __awaiter(this, void 0, void 0, function* () {
109
+ const unlock = yield this.lockHeadroom();
110
+ try {
111
+ yield this.waitForHeadroomWithoutLock(dc);
112
+ } finally {
113
+ unlock();
114
+ }
115
+ });
116
+ }
117
+ /** Core wait of {@link waitForHeadroomWithLock}. The caller must hold the headroom lock. */
118
+ waitForHeadroomWithoutLock(dc) {
119
+ return __awaiter(this, void 0, void 0, function* () {
120
+ if (this.isEngineClosed()) {
121
+ throw new UnexpectedConnectionState('engine closed');
122
+ }
123
+ if (dc.readyState !== 'open') {
124
+ throw new UnexpectedConnectionState("DataChannel ".concat(this.kind, " is ").concat(dc.readyState));
125
+ }
126
+ if (this.isBelowHighWaterMark(dc)) {
127
+ return;
128
+ }
129
+ const abortSignal = this.waiterAbortController.signal;
130
+ yield new TypedPromise((resolve, reject) => {
131
+ const onBufferedAmountLow = () => {
132
+ cleanup();
133
+ resolve();
134
+ };
135
+ const onDCClose = () => {
136
+ cleanup();
137
+ reject(new UnexpectedConnectionState("DataChannel ".concat(this.kind, " closed while draining the buffer")));
138
+ };
139
+ const onAbort = () => {
140
+ cleanup();
141
+ reject(new UnexpectedConnectionState("DataChannel ".concat(this.kind, " was replaced or torn down while waiting for headroom")));
142
+ };
143
+ const cleanup = () => {
144
+ dc.removeEventListener('bufferedamountlow', onBufferedAmountLow);
145
+ dc.removeEventListener('close', onDCClose);
146
+ abortSignal.removeEventListener('abort', onAbort);
147
+ };
148
+ if (abortSignal.aborted) {
149
+ onAbort();
150
+ return;
151
+ }
152
+ dc.addEventListener('bufferedamountlow', onBufferedAmountLow);
153
+ // Proxy along any error caused by the data channel closing while we wait.
154
+ dc.addEventListener('close', onDCClose);
155
+ // The channel object we're parked on can be abandoned without ever firing another event
156
+ // (e.g. the engine recreating channels); the abort is our way out.
157
+ abortSignal.addEventListener('abort', onAbort);
158
+ });
159
+ });
160
+ }
161
+ /** Rejects all parked headroom waiters; the next waiter gets a fresh controller. */
162
+ invalidateWaiters(reason) {
163
+ this.waiterAbortController.abort(reason);
164
+ this.waiterAbortController = new AbortController();
165
+ }
166
+ /**
167
+ * Recomputes whether the buffer has drained to the low-water mark and, if that changed since the
168
+ * last check, notifies the status listener. Two independent triggers land here: a send (which
169
+ * raises the buffer) and the `bufferedamountlow` drain event (which lowers it) — the latter has
170
+ * no send to hang the work off, which is why this is a shared entry point rather than a tail of
171
+ * `send`.
172
+ */
173
+ refreshBufferStatus() {
174
+ var _a;
175
+ const dc = this.getChannel();
176
+ if (!dc) {
177
+ return;
178
+ }
179
+ const isLow = this.isBelowLowWaterMark(dc);
180
+ if (isLow !== this.bufferStatusLow) {
181
+ this.bufferStatusLow = isLow;
182
+ (_a = this.onBufferStatusChanged) === null || _a === void 0 ? void 0 : _a.call(this, isLow);
183
+ }
184
+ }
185
+ }export{FlowControlledDataChannel};//# sourceMappingURL=FlowControlledDataChannel.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FlowControlledDataChannel.mjs","sources":["../../../../src/room/data-channel/FlowControlledDataChannel.ts"],"sourcesContent":["import { Mutex } from '@livekit/mutex';\nimport TypedPromise from '../../utils/TypedPromise';\nimport { UnexpectedConnectionState } from '../errors';\nimport type { DataChannelKind } from './types';\n\nexport interface FlowControlledDataChannelOptions {\n kind: DataChannelKind;\n /** Buffer level (bytes) at which blocked senders resume; armed as `bufferedAmountLowThreshold`. */\n lowWaterMark: number;\n /** Buffer level (bytes) above which senders block until the buffer drains to the low mark. */\n highWaterMark: number;\n /** Whether the owning engine has been closed — a closed engine rejects waiters immediately. */\n isEngineClosed: () => boolean;\n /**\n * Notified when the buffer crosses the low-water mark in either direction (debounced: fires only\n * on an actual change). Drives the engine's public DCBufferStatusChanged event.\n */\n onBufferStatusChanged?: (isLow: boolean) => void;\n}\n\n/**\n * Two-watermark flow control for one data channel kind.\n *\n * Owns the per-kind headroom gate: senders proceed freely while the buffer is at or below the\n * high-water mark and otherwise block — serialized FIFO through a mutex — until the browser's\n * `bufferedamountlow` event (armed at the low-water mark) signals the buffer has drained. The\n * serialization prevents woken senders from all refilling at once and overflowing the SCTP send\n * buffer (see livekit/client-sdk-js#1995).\n *\n * Waiters are parked on the channel object captured at wait entry. If that object stops being\n * current — replaced or torn down — its events may never fire again, so the owner must call\n * {@link invalidateWaiters}, which aborts parked waiters (releasing the gate); the next waiter\n * gets a fresh controller. {@link attach} and {@link detach} do this, and close the released\n * handle, as part of handle turnover.\n */\nexport class FlowControlledDataChannel {\n readonly kind: DataChannelKind;\n\n readonly lowWaterMark: number;\n\n readonly highWaterMark: number;\n\n protected isEngineClosed: () => boolean;\n\n private onBufferStatusChanged?: (isLow: boolean) => void;\n\n /** Last emitted low-water status; starts true (an empty buffer is below the mark). */\n private bufferStatusLow = true;\n\n private handle?: RTCDataChannel;\n\n private headroomLock = new Mutex();\n\n /** Cancels parked headroom waiters when the handle is replaced or torn down. */\n private waiterAbortController = new AbortController();\n\n constructor(opts: FlowControlledDataChannelOptions) {\n this.kind = opts.kind;\n this.lowWaterMark = opts.lowWaterMark;\n this.highWaterMark = opts.highWaterMark;\n this.isEngineClosed = opts.isEngineClosed;\n this.onBufferStatusChanged = opts.onBufferStatusChanged;\n }\n\n /** The currently attached RTCDataChannel handle, if any. */\n get channelHandle(): RTCDataChannel | undefined {\n return this.handle;\n }\n\n /**\n * Attaches the channel handle this wrapper controls. Replacing an existing handle closes it and\n * rejects parked waiters — their events would never fire again on the abandoned object — and\n * installs a fresh controller. Wrappers outlive their handles: this is the one place handle\n * turnover happens, so a handle the wrapper lets go of is never left open, and stranding a\n * waiter is structurally impossible.\n */\n attach(dc: RTCDataChannel) {\n const old = this.handle;\n this.handle = dc;\n if (old && old !== dc) {\n this.release(old, 'data channel replaced');\n }\n }\n\n /** Detaches and closes the handle on teardown, rejecting parked waiters. */\n detach(reason: string = 'data channel torn down') {\n const old = this.handle;\n this.handle = undefined;\n if (old) {\n this.release(old, reason);\n }\n }\n\n /**\n * Closes a handle the wrapper no longer controls. `close()` moves it to `closing` synchronously,\n * so senders still holding it (queued on the headroom lock) fail the open check once they get\n * the lock. Parked waiters are aborted directly instead of relying on the `close` event, which\n * fires asynchronously, if at all (the spec lets `pc.close()` skip it). Strip any handlers that\n * must not observe the close before calling this.\n */\n private release(dc: RTCDataChannel, reason: string) {\n this.invalidateWaiters(reason);\n dc.close();\n }\n\n protected getChannel(): RTCDataChannel | undefined {\n return this.handle;\n }\n\n /**\n * Whether the send buffer has room to accept more data (the send gate). Senders proceed while\n * this is true and block once it goes false. Callers resolve the handle (and decide what an\n * absent one means) before asking.\n */\n isBelowHighWaterMark(dc: RTCDataChannel): boolean {\n // RTCDataChannel has no built-in high-water mark, so we compare against our static mark.\n return dc.bufferedAmount <= this.highWaterMark;\n }\n\n /**\n * Whether the send buffer has drained to its low-water mark. Drives the engine's public\n * DCBufferStatusChanged event.\n */\n isBelowLowWaterMark(dc: RTCDataChannel): boolean {\n // Read the channel's own threshold: it is tuned dynamically for the lossy channel.\n return dc.bufferedAmount <= dc.bufferedAmountLowThreshold;\n }\n\n /**\n * Acquires the headroom lock, resolving with the unlock function. Batch senders (the resume\n * replay) hold it across all of their sends so no other sender can interleave, calling\n * {@link waitForHeadroomWithoutLock} per message to respect flow control within the batch.\n */\n lockHeadroom(): Promise<() => void> {\n return this.headroomLock.lock();\n }\n\n /**\n * Resolves once the caller may send on `dc`: immediately while its send buffer is at or below\n * the high-water mark, otherwise once the buffer has drained to the low-water mark (the\n * `bufferedamountlow` event). Callers are serialized through the headroom lock so that, when\n * the buffer drains, they refill it one at a time (up to the high-water mark) rather than all\n * sending at once and overflowing the SCTP send buffer (see livekit/client-sdk-js#1995). The\n * checks run inside the lock so queued callers proceed in FIFO order.\n *\n * The caller passes the handle it resolved before queueing, and the wait is against that one\n * handle throughout: if it was replaced meanwhile, it has been closed, so the wait rejects\n * rather than letting the caller send on the replacement out of turn.\n */\n async waitForHeadroomWithLock(dc: RTCDataChannel) {\n const unlock = await this.lockHeadroom();\n try {\n await this.waitForHeadroomWithoutLock(dc);\n } finally {\n unlock();\n }\n }\n\n /** Core wait of {@link waitForHeadroomWithLock}. The caller must hold the headroom lock. */\n async waitForHeadroomWithoutLock(dc: RTCDataChannel) {\n if (this.isEngineClosed()) {\n throw new UnexpectedConnectionState('engine closed');\n }\n if (dc.readyState !== 'open') {\n throw new UnexpectedConnectionState(`DataChannel ${this.kind} is ${dc.readyState}`);\n }\n if (this.isBelowHighWaterMark(dc)) {\n return;\n }\n const abortSignal = this.waiterAbortController.signal;\n await new TypedPromise<void, UnexpectedConnectionState>((resolve, reject) => {\n const onBufferedAmountLow = () => {\n cleanup();\n resolve();\n };\n const onDCClose = () => {\n cleanup();\n reject(\n new UnexpectedConnectionState(\n `DataChannel ${this.kind} closed while draining the buffer`,\n ),\n );\n };\n const onAbort = () => {\n cleanup();\n reject(\n new UnexpectedConnectionState(\n `DataChannel ${this.kind} was replaced or torn down while waiting for headroom`,\n ),\n );\n };\n const cleanup = () => {\n dc.removeEventListener('bufferedamountlow', onBufferedAmountLow);\n dc.removeEventListener('close', onDCClose);\n abortSignal.removeEventListener('abort', onAbort);\n };\n if (abortSignal.aborted) {\n onAbort();\n return;\n }\n dc.addEventListener('bufferedamountlow', onBufferedAmountLow);\n // Proxy along any error caused by the data channel closing while we wait.\n dc.addEventListener('close', onDCClose);\n // The channel object we're parked on can be abandoned without ever firing another event\n // (e.g. the engine recreating channels); the abort is our way out.\n abortSignal.addEventListener('abort', onAbort);\n });\n }\n\n /** Rejects all parked headroom waiters; the next waiter gets a fresh controller. */\n invalidateWaiters(reason: string) {\n this.waiterAbortController.abort(reason);\n this.waiterAbortController = new AbortController();\n }\n\n /**\n * Recomputes whether the buffer has drained to the low-water mark and, if that changed since the\n * last check, notifies the status listener. Two independent triggers land here: a send (which\n * raises the buffer) and the `bufferedamountlow` drain event (which lowers it) — the latter has\n * no send to hang the work off, which is why this is a shared entry point rather than a tail of\n * `send`.\n */\n refreshBufferStatus() {\n const dc = this.getChannel();\n if (!dc) {\n return;\n }\n const isLow = this.isBelowLowWaterMark(dc);\n if (isLow !== this.bufferStatusLow) {\n this.bufferStatusLow = isLow;\n this.onBufferStatusChanged?.(isLow);\n }\n }\n}\n"],"names":["FlowControlledDataChannel","constructor","opts","bufferStatusLow","headroomLock","Mutex","waiterAbortController","AbortController","kind","lowWaterMark","highWaterMark","isEngineClosed","onBufferStatusChanged","channelHandle","handle","attach","dc","old","release","detach","reason","undefined","invalidateWaiters","close","getChannel","isBelowHighWaterMark","bufferedAmount","isBelowLowWaterMark","bufferedAmountLowThreshold","lockHeadroom","lock","waitForHeadroomWithLock","unlock","waitForHeadroomWithoutLock","UnexpectedConnectionState","readyState","concat","abortSignal","signal","TypedPromise","resolve","reject","onBufferedAmountLow","cleanup","onDCClose","onAbort","removeEventListener","aborted","addEventListener","abort","refreshBufferStatus","isLow","_a","call"],"mappings":"8KAoBA;;;;;;;;;;;;;;AAcG;MACUA,yBAAyB,CAAA;EAqBpCC,WAAAA,CAAYC,IAAsC,EAAA;AAVlD;IACQ,IAAA,CAAAC,eAAe,GAAG,IAAI;AAItB,IAAA,IAAA,CAAAC,YAAY,GAAG,IAAIC,KAAK,EAAE;AAElC;AACQ,IAAA,IAAA,CAAAC,qBAAqB,GAAG,IAAIC,eAAe,EAAE;AAGnD,IAAA,IAAI,CAACC,IAAI,GAAGN,IAAI,CAACM,IAAI;AACrB,IAAA,IAAI,CAACC,YAAY,GAAGP,IAAI,CAACO,YAAY;AACrC,IAAA,IAAI,CAACC,aAAa,GAAGR,IAAI,CAACQ,aAAa;AACvC,IAAA,IAAI,CAACC,cAAc,GAAGT,IAAI,CAACS,cAAc;AACzC,IAAA,IAAI,CAACC,qBAAqB,GAAGV,IAAI,CAACU,qBAAqB;AACzD,EAAA;AAEA;EACA,IAAIC,aAAaA,GAAA;IACf,OAAO,IAAI,CAACC,MAAM;AACpB,EAAA;AAEA;;;;;;AAMG;EACHC,MAAMA,CAACC,EAAkB,EAAA;AACvB,IAAA,MAAMC,GAAG,GAAG,IAAI,CAACH,MAAM;IACvB,IAAI,CAACA,MAAM,GAAGE,EAAE;AAChB,IAAA,IAAIC,GAAG,IAAIA,GAAG,KAAKD,EAAE,EAAE;AACrB,MAAA,IAAI,CAACE,OAAO,CAACD,GAAG,EAAE,uBAAuB,CAAC;AAC5C,IAAA;AACF,EAAA;AAEA;AACAE,EAAAA,MAAMA,GAA0C;AAAA,IAAA,IAAzCC,6EAAiB,wBAAwB;AAC9C,IAAA,MAAMH,GAAG,GAAG,IAAI,CAACH,MAAM;IACvB,IAAI,CAACA,MAAM,GAAGO,SAAS;AACvB,IAAA,IAAIJ,GAAG,EAAE;AACP,MAAA,IAAI,CAACC,OAAO,CAACD,GAAG,EAAEG,MAAM,CAAC;AAC3B,IAAA;AACF,EAAA;AAEA;;;;;;AAMG;AACKF,EAAAA,OAAOA,CAACF,EAAkB,EAAEI,MAAc,EAAA;AAChD,IAAA,IAAI,CAACE,iBAAiB,CAACF,MAAM,CAAC;IAC9BJ,EAAE,CAACO,KAAK,EAAE;AACZ,EAAA;AAEUC,EAAAA,UAAUA,GAAA;IAClB,OAAO,IAAI,CAACV,MAAM;AACpB,EAAA;AAEA;;;;AAIG;EACHW,oBAAoBA,CAACT,EAAkB,EAAA;AACrC;AACA,IAAA,OAAOA,EAAE,CAACU,cAAc,IAAI,IAAI,CAAChB,aAAa;AAChD,EAAA;AAEA;;;AAGG;EACHiB,mBAAmBA,CAACX,EAAkB,EAAA;AACpC;AACA,IAAA,OAAOA,EAAE,CAACU,cAAc,IAAIV,EAAE,CAACY,0BAA0B;AAC3D,EAAA;AAEA;;;;AAIG;AACHC,EAAAA,YAAYA,GAAA;AACV,IAAA,OAAO,IAAI,CAACzB,YAAY,CAAC0B,IAAI,EAAE;AACjC,EAAA;AAEA;;;;;;;;;;;AAWG;EACGC,uBAAuBA,CAACf,EAAkB,EAAA;;AAC9C,MAAA,MAAMgB,MAAM,GAAG,MAAM,IAAI,CAACH,YAAY,EAAE;MACxC,IAAI;AACF,QAAA,MAAM,IAAI,CAACI,0BAA0B,CAACjB,EAAE,CAAC;AAC3C,MAAA,CAAC,SAAS;AACRgB,QAAAA,MAAM,EAAE;AACV,MAAA;AACF,IAAA,CAAC,CAAA;AAAA,EAAA;AAED;EACMC,0BAA0BA,CAACjB,EAAkB,EAAA;;AACjD,MAAA,IAAI,IAAI,CAACL,cAAc,EAAE,EAAE;AACzB,QAAA,MAAM,IAAIuB,yBAAyB,CAAC,eAAe,CAAC;AACtD,MAAA;AACA,MAAA,IAAIlB,EAAE,CAACmB,UAAU,KAAK,MAAM,EAAE;AAC5B,QAAA,MAAM,IAAID,yBAAyB,CAAA,cAAA,CAAAE,MAAA,CAAgB,IAAI,CAAC5B,IAAI,EAAA,MAAA,CAAA,CAAA4B,MAAA,CAAOpB,EAAE,CAACmB,UAAU,CAAE,CAAC;AACrF,MAAA;AACA,MAAA,IAAI,IAAI,CAACV,oBAAoB,CAACT,EAAE,CAAC,EAAE;AACjC,QAAA;AACF,MAAA;AACA,MAAA,MAAMqB,WAAW,GAAG,IAAI,CAAC/B,qBAAqB,CAACgC,MAAM;AACrD,MAAA,MAAM,IAAIC,YAAY,CAAkC,CAACC,OAAO,EAAEC,MAAM,KAAI;QAC1E,MAAMC,mBAAmB,GAAGA,MAAK;AAC/BC,UAAAA,OAAO,EAAE;AACTH,UAAAA,OAAO,EAAE;QACX,CAAC;QACD,MAAMI,SAAS,GAAGA,MAAK;AACrBD,UAAAA,OAAO,EAAE;UACTF,MAAM,CACJ,IAAIP,yBAAyB,CAAA,cAAA,CAAAE,MAAA,CACZ,IAAI,CAAC5B,IAAI,EAAA,mCAAA,CAAmC,CAC5D,CACF;QACH,CAAC;QACD,MAAMqC,OAAO,GAAGA,MAAK;AACnBF,UAAAA,OAAO,EAAE;UACTF,MAAM,CACJ,IAAIP,yBAAyB,CAAA,cAAA,CAAAE,MAAA,CACZ,IAAI,CAAC5B,IAAI,EAAA,uDAAA,CAAuD,CAChF,CACF;QACH,CAAC;QACD,MAAMmC,OAAO,GAAGA,MAAK;AACnB3B,UAAAA,EAAE,CAAC8B,mBAAmB,CAAC,mBAAmB,EAAEJ,mBAAmB,CAAC;AAChE1B,UAAAA,EAAE,CAAC8B,mBAAmB,CAAC,OAAO,EAAEF,SAAS,CAAC;AAC1CP,UAAAA,WAAW,CAACS,mBAAmB,CAAC,OAAO,EAAED,OAAO,CAAC;QACnD,CAAC;QACD,IAAIR,WAAW,CAACU,OAAO,EAAE;AACvBF,UAAAA,OAAO,EAAE;AACT,UAAA;AACF,QAAA;AACA7B,QAAAA,EAAE,CAACgC,gBAAgB,CAAC,mBAAmB,EAAEN,mBAAmB,CAAC;AAC7D;AACA1B,QAAAA,EAAE,CAACgC,gBAAgB,CAAC,OAAO,EAAEJ,SAAS,CAAC;AACvC;AACA;AACAP,QAAAA,WAAW,CAACW,gBAAgB,CAAC,OAAO,EAAEH,OAAO,CAAC;AAChD,MAAA,CAAC,CAAC;AACJ,IAAA,CAAC,CAAA;AAAA,EAAA;AAED;EACAvB,iBAAiBA,CAACF,MAAc,EAAA;AAC9B,IAAA,IAAI,CAACd,qBAAqB,CAAC2C,KAAK,CAAC7B,MAAM,CAAC;AACxC,IAAA,IAAI,CAACd,qBAAqB,GAAG,IAAIC,eAAe,EAAE;AACpD,EAAA;AAEA;;;;;;AAMG;AACH2C,EAAAA,mBAAmBA,GAAA;;AACjB,IAAA,MAAMlC,EAAE,GAAG,IAAI,CAACQ,UAAU,EAAE;IAC5B,IAAI,CAACR,EAAE,EAAE;AACP,MAAA;AACF,IAAA;AACA,IAAA,MAAMmC,KAAK,GAAG,IAAI,CAACxB,mBAAmB,CAACX,EAAE,CAAC;AAC1C,IAAA,IAAImC,KAAK,KAAK,IAAI,CAAChD,eAAe,EAAE;MAClC,IAAI,CAACA,eAAe,GAAGgD,KAAK;MAC5B,CAAAC,EAAA,GAAA,IAAI,CAACxC,qBAAqB,MAAA,IAAA,IAAAwC,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAAC,IAAA,CAAA,IAAA,EAAGF,KAAK,CAAC;AACrC,IAAA;AACF,EAAA;AACD"}