livekit-client 2.22.4 → 2.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (904) hide show
  1. package/README.md +48 -32
  2. package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs +48 -0
  3. package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs.map +1 -0
  4. package/dist/core/api/SignalClient.mjs +1212 -0
  5. package/dist/core/api/SignalClient.mjs.map +1 -0
  6. package/dist/core/api/SignalClientStateMachine.mjs +115 -0
  7. package/dist/core/api/SignalClientStateMachine.mjs.map +1 -0
  8. package/dist/core/api/WebSocketStream.mjs +146 -0
  9. package/dist/core/api/WebSocketStream.mjs.map +1 -0
  10. package/dist/core/api/utils.mjs +66 -0
  11. package/dist/core/api/utils.mjs.map +1 -0
  12. package/dist/core/connectionHelper/ConnectionCheck.mjs +89 -0
  13. package/dist/core/connectionHelper/ConnectionCheck.mjs.map +1 -0
  14. package/dist/core/connectionHelper/checks/Checker.mjs +146 -0
  15. package/dist/core/connectionHelper/checks/Checker.mjs.map +1 -0
  16. package/dist/core/connectionHelper/checks/cloudRegion.mjs +82 -0
  17. package/dist/core/connectionHelper/checks/cloudRegion.mjs.map +1 -0
  18. package/dist/core/connectionHelper/checks/connectionProtocol.mjs +111 -0
  19. package/dist/core/connectionHelper/checks/connectionProtocol.mjs.map +1 -0
  20. package/dist/core/connectionHelper/checks/publishAudio.mjs +35 -0
  21. package/dist/core/connectionHelper/checks/publishAudio.mjs.map +1 -0
  22. package/dist/core/connectionHelper/checks/publishVideo.mjs +82 -0
  23. package/dist/core/connectionHelper/checks/publishVideo.mjs.map +1 -0
  24. package/dist/core/connectionHelper/checks/reconnect.mjs +37 -0
  25. package/dist/core/connectionHelper/checks/reconnect.mjs.map +1 -0
  26. package/dist/core/connectionHelper/checks/turn.mjs +56 -0
  27. package/dist/core/connectionHelper/checks/turn.mjs.map +1 -0
  28. package/dist/core/connectionHelper/checks/webrtc.mjs +73 -0
  29. package/dist/core/connectionHelper/checks/webrtc.mjs.map +1 -0
  30. package/dist/core/connectionHelper/checks/websocket.mjs +47 -0
  31. package/dist/core/connectionHelper/checks/websocket.mjs.map +1 -0
  32. package/dist/core/core.mjs +1 -0
  33. package/dist/core/core.mjs.map +1 -0
  34. package/dist/core/e2ee/E2eeManager.mjs +603 -0
  35. package/dist/core/e2ee/E2eeManager.mjs.map +1 -0
  36. package/dist/core/e2ee/KeyProvider.mjs +95 -0
  37. package/dist/core/e2ee/KeyProvider.mjs.map +1 -0
  38. package/dist/core/e2ee/constants.mjs +19 -0
  39. package/dist/core/e2ee/constants.mjs.map +1 -0
  40. package/dist/core/e2ee/errors.mjs +15 -0
  41. package/dist/core/e2ee/errors.mjs.map +1 -0
  42. package/dist/core/e2ee/events.mjs +24 -0
  43. package/dist/core/e2ee/events.mjs.map +1 -0
  44. package/dist/core/e2ee/extension.mjs +70 -0
  45. package/dist/core/e2ee/extension.mjs.map +1 -0
  46. package/dist/core/e2ee/utils.mjs +168 -0
  47. package/dist/core/e2ee/utils.mjs.map +1 -0
  48. package/dist/core/frameMetadata/FrameMetadataManager.mjs +205 -0
  49. package/dist/core/frameMetadata/FrameMetadataManager.mjs.map +1 -0
  50. package/dist/core/frameMetadata/extension.mjs +17 -0
  51. package/dist/core/frameMetadata/extension.mjs.map +1 -0
  52. package/dist/core/frameMetadata/utils.mjs +42 -0
  53. package/dist/core/frameMetadata/utils.mjs.map +1 -0
  54. package/dist/core/logger.mjs +111 -0
  55. package/dist/core/logger.mjs.map +1 -0
  56. package/dist/core/package.json.mjs +1 -0
  57. package/dist/core/package.json.mjs.map +1 -0
  58. package/dist/core/room/BackOffStrategy.mjs +60 -0
  59. package/dist/core/room/BackOffStrategy.mjs.map +1 -0
  60. package/dist/core/room/CoreRoom.mjs +2279 -0
  61. package/dist/core/room/CoreRoom.mjs.map +1 -0
  62. package/dist/core/room/DefaultReconnectPolicy.mjs +23 -0
  63. package/dist/core/room/DefaultReconnectPolicy.mjs.map +1 -0
  64. package/dist/core/room/DeviceManager.mjs +92 -0
  65. package/dist/core/room/DeviceManager.mjs.map +1 -0
  66. package/dist/core/room/PCTransport.mjs +1110 -0
  67. package/dist/core/room/PCTransport.mjs.map +1 -0
  68. package/dist/core/room/PCTransportManager.mjs +360 -0
  69. package/dist/core/room/PCTransportManager.mjs.map +1 -0
  70. package/dist/core/room/RTCEngine.mjs +1830 -0
  71. package/dist/core/room/RTCEngine.mjs.map +1 -0
  72. package/dist/core/room/RegionUrlProvider.mjs +194 -0
  73. package/dist/core/room/RegionUrlProvider.mjs.map +1 -0
  74. package/dist/core/room/attribute-typings.mjs +24 -0
  75. package/dist/core/room/attribute-typings.mjs.map +1 -0
  76. package/dist/core/room/createRoom.mjs +19 -0
  77. package/dist/core/room/createRoom.mjs.map +1 -0
  78. package/dist/core/room/data-channel/DataChannelManager.mjs +188 -0
  79. package/dist/core/room/data-channel/DataChannelManager.mjs.map +1 -0
  80. package/dist/core/room/data-channel/FlowControlledDataChannel.mjs +185 -0
  81. package/dist/core/room/data-channel/FlowControlledDataChannel.mjs.map +1 -0
  82. package/dist/core/room/data-channel/LossyDataChannel.mjs +99 -0
  83. package/dist/core/room/data-channel/LossyDataChannel.mjs.map +1 -0
  84. package/dist/core/room/data-channel/ReliableDataChannel.mjs +150 -0
  85. package/dist/core/room/data-channel/ReliableDataChannel.mjs.map +1 -0
  86. package/dist/core/room/data-channel/types.mjs +22 -0
  87. package/dist/core/room/data-channel/types.mjs.map +1 -0
  88. package/dist/core/room/data-stream/compression.mjs +68 -0
  89. package/dist/core/room/data-stream/compression.mjs.map +1 -0
  90. package/dist/core/room/data-stream/constants.mjs +26 -0
  91. package/dist/core/room/data-stream/constants.mjs.map +1 -0
  92. package/dist/core/room/data-stream/extension.mjs +42 -0
  93. package/dist/core/room/data-stream/extension.mjs.map +1 -0
  94. package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs +500 -0
  95. package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs.map +1 -0
  96. package/dist/core/room/data-stream/incoming/StreamReader.mjs +279 -0
  97. package/dist/core/room/data-stream/incoming/StreamReader.mjs.map +1 -0
  98. package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs +543 -0
  99. package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs.map +1 -0
  100. package/dist/core/room/data-stream/outgoing/StreamWriter.mjs +21 -0
  101. package/dist/core/room/data-stream/outgoing/StreamWriter.mjs.map +1 -0
  102. package/dist/core/room/data-stream/outgoing/header-utils.mjs +53 -0
  103. package/dist/core/room/data-stream/outgoing/header-utils.mjs.map +1 -0
  104. package/dist/core/room/data-track/LocalDataTrack.mjs +146 -0
  105. package/dist/core/room/data-track/LocalDataTrack.mjs.map +1 -0
  106. package/dist/core/room/data-track/RemoteDataTrack.mjs +51 -0
  107. package/dist/core/room/data-track/RemoteDataTrack.mjs.map +1 -0
  108. package/dist/core/room/data-track/depacketizer.mjs +193 -0
  109. package/dist/core/room/data-track/depacketizer.mjs.map +1 -0
  110. package/dist/core/room/data-track/extension.mjs +154 -0
  111. package/dist/core/room/data-track/extension.mjs.map +1 -0
  112. package/dist/core/room/data-track/frame.mjs +19 -0
  113. package/dist/core/room/data-track/frame.mjs.map +1 -0
  114. package/dist/core/room/data-track/handle.mjs +50 -0
  115. package/dist/core/room/data-track/handle.mjs.map +1 -0
  116. package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs +618 -0
  117. package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs.map +1 -0
  118. package/dist/core/room/data-track/incoming/errors.mjs +32 -0
  119. package/dist/core/room/data-track/incoming/errors.mjs.map +1 -0
  120. package/dist/core/room/data-track/incoming/pipeline.mjs +85 -0
  121. package/dist/core/room/data-track/incoming/pipeline.mjs.map +1 -0
  122. package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs +351 -0
  123. package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs.map +1 -0
  124. package/dist/core/room/data-track/outgoing/errors.mjs +114 -0
  125. package/dist/core/room/data-track/outgoing/errors.mjs.map +1 -0
  126. package/dist/core/room/data-track/outgoing/pipeline.mjs +41 -0
  127. package/dist/core/room/data-track/outgoing/pipeline.mjs.map +1 -0
  128. package/dist/core/room/data-track/packet/constants.mjs +21 -0
  129. package/dist/core/room/data-track/packet/constants.mjs.map +1 -0
  130. package/dist/core/room/data-track/packet/errors.mjs +56 -0
  131. package/dist/core/room/data-track/packet/errors.mjs.map +1 -0
  132. package/dist/core/room/data-track/packet/extensions.mjs +172 -0
  133. package/dist/core/room/data-track/packet/extensions.mjs.map +1 -0
  134. package/dist/core/room/data-track/packet/index.mjs +242 -0
  135. package/dist/core/room/data-track/packet/index.mjs.map +1 -0
  136. package/dist/core/room/data-track/packet/serializable.mjs +15 -0
  137. package/dist/core/room/data-track/packet/serializable.mjs.map +1 -0
  138. package/dist/core/room/data-track/packetizer.mjs +77 -0
  139. package/dist/core/room/data-track/packetizer.mjs.map +1 -0
  140. package/dist/core/room/data-track/track-interfaces.mjs +2 -0
  141. package/dist/core/room/data-track/track-interfaces.mjs.map +1 -0
  142. package/dist/core/room/data-track/types.mjs +18 -0
  143. package/dist/core/room/data-track/types.mjs.map +1 -0
  144. package/dist/core/room/data-track/utils.mjs +149 -0
  145. package/dist/core/room/data-track/utils.mjs.map +1 -0
  146. package/dist/core/room/debounce.mjs +97 -0
  147. package/dist/core/room/debounce.mjs.map +1 -0
  148. package/dist/core/room/defaults.mjs +34 -0
  149. package/dist/core/room/defaults.mjs.map +1 -0
  150. package/dist/core/room/errors.mjs +208 -0
  151. package/dist/core/room/errors.mjs.map +1 -0
  152. package/dist/core/room/events.mjs +643 -0
  153. package/dist/core/room/events.mjs.map +1 -0
  154. package/dist/core/room/extensions.mjs +48 -0
  155. package/dist/core/room/extensions.mjs.map +1 -0
  156. package/dist/core/room/participant/LocalParticipant.mjs +1324 -0
  157. package/dist/core/room/participant/LocalParticipant.mjs.map +1 -0
  158. package/dist/core/room/participant/Participant.mjs +300 -0
  159. package/dist/core/room/participant/Participant.mjs.map +1 -0
  160. package/dist/core/room/participant/ParticipantTrackPermission.mjs +12 -0
  161. package/dist/core/room/participant/ParticipantTrackPermission.mjs.map +1 -0
  162. package/dist/core/room/participant/RemoteParticipant.mjs +287 -0
  163. package/dist/core/room/participant/RemoteParticipant.mjs.map +1 -0
  164. package/dist/core/room/participant/publishUtils.mjs +356 -0
  165. package/dist/core/room/participant/publishUtils.mjs.map +1 -0
  166. package/dist/core/room/rpc/client/RpcClientManager.mjs +216 -0
  167. package/dist/core/room/rpc/client/RpcClientManager.mjs.map +1 -0
  168. package/dist/core/room/rpc/extension.mjs +82 -0
  169. package/dist/core/room/rpc/extension.mjs.map +1 -0
  170. package/dist/core/room/rpc/server/RpcServerManager.mjs +186 -0
  171. package/dist/core/room/rpc/server/RpcServerManager.mjs.map +1 -0
  172. package/dist/core/room/rpc/utils.mjs +148 -0
  173. package/dist/core/room/rpc/utils.mjs.map +1 -0
  174. package/dist/core/room/simulated-participants/extension.mjs +105 -0
  175. package/dist/core/room/simulated-participants/extension.mjs.map +1 -0
  176. package/dist/core/room/stats.mjs +19 -0
  177. package/dist/core/room/stats.mjs.map +1 -0
  178. package/dist/core/room/statsSummary.mjs +165 -0
  179. package/dist/core/room/statsSummary.mjs.map +1 -0
  180. package/dist/core/room/timers.mjs +20 -0
  181. package/dist/core/room/timers.mjs.map +1 -0
  182. package/dist/core/room/token-source/TokenSource.mjs +230 -0
  183. package/dist/core/room/token-source/TokenSource.mjs.map +1 -0
  184. package/dist/core/room/token-source/types.mjs +18 -0
  185. package/dist/core/room/token-source/types.mjs.map +1 -0
  186. package/dist/core/room/token-source/utils.mjs +76 -0
  187. package/dist/core/room/token-source/utils.mjs.map +1 -0
  188. package/dist/core/room/track/FrameMetadataExtractor.mjs +36 -0
  189. package/dist/core/room/track/FrameMetadataExtractor.mjs.map +1 -0
  190. package/dist/core/room/track/LocalAudioTrack.mjs +327 -0
  191. package/dist/core/room/track/LocalAudioTrack.mjs.map +1 -0
  192. package/dist/core/room/track/LocalTrack.mjs +694 -0
  193. package/dist/core/room/track/LocalTrack.mjs.map +1 -0
  194. package/dist/core/room/track/LocalTrackPublication.mjs +111 -0
  195. package/dist/core/room/track/LocalTrackPublication.mjs.map +1 -0
  196. package/dist/core/room/track/LocalVideoTrack.mjs +810 -0
  197. package/dist/core/room/track/LocalVideoTrack.mjs.map +1 -0
  198. package/dist/core/room/track/RemoteAudioTrack.mjs +245 -0
  199. package/dist/core/room/track/RemoteAudioTrack.mjs.map +1 -0
  200. package/dist/core/room/track/RemoteTrack.mjs +143 -0
  201. package/dist/core/room/track/RemoteTrack.mjs.map +1 -0
  202. package/dist/core/room/track/RemoteTrackPublication.mjs +284 -0
  203. package/dist/core/room/track/RemoteTrackPublication.mjs.map +1 -0
  204. package/dist/core/room/track/RemoteVideoTrack.mjs +384 -0
  205. package/dist/core/room/track/RemoteVideoTrack.mjs.map +1 -0
  206. package/dist/core/room/track/Track.mjs +413 -0
  207. package/dist/core/room/track/Track.mjs.map +1 -0
  208. package/dist/core/room/track/TrackPublication.mjs +97 -0
  209. package/dist/core/room/track/TrackPublication.mjs.map +1 -0
  210. package/dist/core/room/track/create.mjs +142 -0
  211. package/dist/core/room/track/create.mjs.map +1 -0
  212. package/dist/core/room/track/facingMode.mjs +81 -0
  213. package/dist/core/room/track/facingMode.mjs.map +1 -0
  214. package/dist/core/room/track/options.mjs +109 -0
  215. package/dist/core/room/track/options.mjs.map +1 -0
  216. package/dist/core/room/track/record.mjs +67 -0
  217. package/dist/core/room/track/record.mjs.map +1 -0
  218. package/dist/core/room/track/utils.mjs +429 -0
  219. package/dist/core/room/track/utils.mjs.map +1 -0
  220. package/dist/core/room/utils.mjs +852 -0
  221. package/dist/core/room/utils.mjs.map +1 -0
  222. package/dist/core/room/video/create.mjs +71 -0
  223. package/dist/core/room/video/create.mjs.map +1 -0
  224. package/dist/core/room/video/extension.mjs +27 -0
  225. package/dist/core/room/video/extension.mjs.map +1 -0
  226. package/dist/core/room/video/publisher.mjs +343 -0
  227. package/dist/core/room/video/publisher.mjs.map +1 -0
  228. package/dist/core/ts4.2/api/SignalClient.d.ts +19 -0
  229. package/dist/core/ts4.2/api/SignalClientStateMachine.d.ts +84 -0
  230. package/dist/core/ts4.2/api/WebSocketStream.d.ts +33 -0
  231. package/dist/core/ts4.2/api/utils.d.ts +8 -0
  232. package/dist/core/ts4.2/connectionHelper/ConnectionCheck.d.ts +29 -0
  233. package/dist/core/ts4.2/connectionHelper/checks/Checker.d.ts +64 -0
  234. package/dist/core/ts4.2/connectionHelper/checks/cloudRegion.d.ts +17 -0
  235. package/dist/core/ts4.2/connectionHelper/checks/connectionProtocol.d.ts +19 -0
  236. package/dist/core/ts4.2/connectionHelper/checks/publishAudio.d.ts +5 -0
  237. package/dist/core/ts4.2/connectionHelper/checks/publishVideo.d.ts +6 -0
  238. package/dist/core/ts4.2/connectionHelper/checks/reconnect.d.ts +5 -0
  239. package/dist/core/ts4.2/connectionHelper/checks/turn.d.ts +5 -0
  240. package/dist/core/ts4.2/connectionHelper/checks/webrtc.d.ts +5 -0
  241. package/dist/core/ts4.2/connectionHelper/checks/websocket.d.ts +5 -0
  242. package/dist/core/ts4.2/core.d.ts +33 -0
  243. package/dist/core/ts4.2/e2ee/E2eeManager.d.ts +89 -0
  244. package/dist/core/ts4.2/e2ee/KeyProvider.d.ts +53 -0
  245. package/dist/core/ts4.2/e2ee/constants.d.ts +20 -0
  246. package/dist/core/ts4.2/e2ee/errors.d.ts +11 -0
  247. package/dist/core/ts4.2/e2ee/events.d.ts +38 -0
  248. package/dist/core/ts4.2/e2ee/extension.d.ts +19 -0
  249. package/dist/core/ts4.2/e2ee/index.d.ts +5 -0
  250. package/dist/core/ts4.2/e2ee/types.d.ts +244 -0
  251. package/dist/core/ts4.2/e2ee/utils.d.ts +36 -0
  252. package/dist/core/ts4.2/exports.d.ts +82 -0
  253. package/dist/core/ts4.2/frameMetadata/FrameMetadataManager.d.ts +52 -0
  254. package/dist/core/ts4.2/frameMetadata/extension.d.ts +12 -0
  255. package/dist/core/ts4.2/frameMetadata/frameMetadata.d.ts +32 -0
  256. package/dist/core/ts4.2/frameMetadata/types.d.ts +61 -0
  257. package/dist/core/ts4.2/frameMetadata/utils.d.ts +13 -0
  258. package/dist/core/ts4.2/logger.d.ts +59 -0
  259. package/dist/core/ts4.2/options.d.ts +171 -0
  260. package/dist/core/ts4.2/room/BackOffStrategy.d.ts +26 -0
  261. package/dist/core/ts4.2/room/CoreRoom.d.ts +363 -0
  262. package/dist/core/ts4.2/room/DefaultReconnectPolicy.d.ts +7 -0
  263. package/dist/core/ts4.2/room/DeviceManager.d.ts +11 -0
  264. package/dist/core/ts4.2/room/PCTransport.d.ts +132 -0
  265. package/dist/core/ts4.2/room/PCTransportManager.d.ts +80 -0
  266. package/dist/core/ts4.2/room/RTCEngine.d.ts +233 -0
  267. package/dist/core/ts4.2/room/ReconnectPolicy.d.ts +23 -0
  268. package/dist/core/ts4.2/room/RegionUrlProvider.d.ts +33 -0
  269. package/dist/core/ts4.2/room/attribute-typings.d.ts +34 -0
  270. package/dist/core/ts4.2/room/chat/extension.d.ts +21 -0
  271. package/dist/core/ts4.2/room/createRoom.d.ts +19 -0
  272. package/dist/core/ts4.2/room/data-channel/DataChannelManager.d.ts +67 -0
  273. package/dist/core/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +106 -0
  274. package/dist/core/ts4.2/room/data-channel/LossyDataChannel.d.ts +40 -0
  275. package/dist/core/ts4.2/room/data-channel/ReliableDataChannel.d.ts +56 -0
  276. package/dist/core/ts4.2/room/data-channel/types.d.ts +11 -0
  277. package/dist/core/ts4.2/room/data-stream/compression.d.ts +29 -0
  278. package/dist/core/ts4.2/room/data-stream/constants.d.ts +1 -0
  279. package/dist/core/ts4.2/room/data-stream/extension.d.ts +63 -0
  280. package/dist/core/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +33 -0
  281. package/dist/core/ts4.2/room/data-stream/incoming/StreamReader.d.ts +77 -0
  282. package/dist/core/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
  283. package/dist/core/ts4.2/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
  284. package/dist/core/ts4.2/room/data-stream/outgoing/header-utils.d.ts +17 -0
  285. package/dist/core/ts4.2/room/data-track/LocalDataTrack.d.ts +69 -0
  286. package/dist/core/ts4.2/room/data-track/RemoteDataTrack.d.ts +43 -0
  287. package/dist/core/ts4.2/room/data-track/depacketizer.d.ts +58 -0
  288. package/dist/core/ts4.2/room/data-track/extension.d.ts +30 -0
  289. package/dist/core/ts4.2/room/data-track/frame.d.ts +21 -0
  290. package/dist/core/ts4.2/room/data-track/handle.d.ts +26 -0
  291. package/dist/core/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
  292. package/dist/core/ts4.2/room/data-track/incoming/errors.d.ts +23 -0
  293. package/dist/core/ts4.2/room/data-track/incoming/pipeline.d.ts +40 -0
  294. package/dist/core/ts4.2/room/data-track/incoming/types.d.ts +19 -0
  295. package/dist/core/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
  296. package/dist/core/ts4.2/room/data-track/outgoing/errors.d.ts +73 -0
  297. package/dist/core/ts4.2/room/data-track/outgoing/pipeline.d.ts +22 -0
  298. package/dist/core/ts4.2/room/data-track/outgoing/types.d.ts +47 -0
  299. package/dist/core/ts4.2/room/data-track/packet/constants.d.ts +19 -0
  300. package/dist/core/ts4.2/room/data-track/packet/errors.d.ts +39 -0
  301. package/dist/core/ts4.2/room/data-track/packet/extensions.d.ts +68 -0
  302. package/dist/core/ts4.2/room/data-track/packet/index.d.ts +97 -0
  303. package/dist/core/ts4.2/room/data-track/packet/serializable.d.ts +12 -0
  304. package/dist/core/ts4.2/room/data-track/packetizer.d.ts +40 -0
  305. package/dist/core/ts4.2/room/data-track/track-interfaces.d.ts +22 -0
  306. package/dist/core/ts4.2/room/data-track/types.d.ts +21 -0
  307. package/dist/core/ts4.2/room/data-track/utils.d.ts +59 -0
  308. package/dist/core/ts4.2/room/debounce.d.ts +10 -0
  309. package/dist/core/ts4.2/room/defaults.d.ts +7 -0
  310. package/dist/core/ts4.2/room/errors.d.ts +179 -0
  311. package/dist/core/ts4.2/room/events.d.ts +534 -0
  312. package/dist/core/ts4.2/room/extensions.d.ts +206 -0
  313. package/dist/core/ts4.2/room/participant/LocalParticipant.d.ts +164 -0
  314. package/dist/core/ts4.2/room/participant/Participant.d.ts +122 -0
  315. package/dist/core/ts4.2/room/participant/ParticipantTrackPermission.d.ts +25 -0
  316. package/dist/core/ts4.2/room/participant/RemoteParticipant.d.ts +37 -0
  317. package/dist/core/ts4.2/room/participant/publishUtils.d.ts +11 -0
  318. package/dist/core/ts4.2/room/rpc/client/RpcClientManager.d.ts +1 -0
  319. package/dist/core/ts4.2/room/rpc/client/events.d.ts +7 -0
  320. package/dist/core/ts4.2/room/rpc/extension.d.ts +73 -0
  321. package/dist/core/ts4.2/room/rpc/index.d.ts +6 -0
  322. package/dist/core/ts4.2/room/rpc/server/RpcServerManager.d.ts +1 -0
  323. package/dist/core/ts4.2/room/rpc/server/events.d.ts +7 -0
  324. package/dist/core/ts4.2/room/rpc/utils.d.ts +76 -0
  325. package/dist/core/ts4.2/room/simulated-participants/extension.d.ts +24 -0
  326. package/dist/core/ts4.2/room/stats.d.ts +70 -0
  327. package/dist/core/ts4.2/room/statsSummary.d.ts +12 -0
  328. package/dist/core/ts4.2/room/timers.d.ts +11 -0
  329. package/dist/core/ts4.2/room/token-source/TokenSource.d.ts +85 -0
  330. package/dist/core/ts4.2/room/token-source/types.d.ts +69 -0
  331. package/dist/core/ts4.2/room/token-source/utils.d.ts +7 -0
  332. package/dist/core/ts4.2/room/track/FrameMetadataExtractor.d.ts +18 -0
  333. package/dist/core/ts4.2/room/track/LocalAudioTrack.d.ts +50 -0
  334. package/dist/core/ts4.2/room/track/LocalTrack.d.ts +118 -0
  335. package/dist/core/ts4.2/room/track/LocalTrackPublication.d.ts +41 -0
  336. package/dist/core/ts4.2/room/track/LocalVideoTrack.d.ts +91 -0
  337. package/dist/core/ts4.2/room/track/RemoteAudioTrack.d.ts +49 -0
  338. package/dist/core/ts4.2/room/track/RemoteTrack.d.ts +29 -0
  339. package/dist/core/ts4.2/room/track/RemoteTrackPublication.d.ts +62 -0
  340. package/dist/core/ts4.2/room/track/RemoteVideoTrack.d.ts +53 -0
  341. package/dist/core/ts4.2/room/track/Track.d.ts +129 -0
  342. package/dist/core/ts4.2/room/track/TrackPublication.d.ts +68 -0
  343. package/dist/core/ts4.2/room/track/create.d.ts +12 -0
  344. package/dist/core/ts4.2/room/track/facingMode.d.ts +40 -0
  345. package/dist/core/ts4.2/room/track/options.d.ts +396 -0
  346. package/dist/core/ts4.2/room/track/processor/types.d.ts +41 -0
  347. package/dist/core/ts4.2/room/track/record.d.ts +12 -0
  348. package/dist/core/ts4.2/room/track/types.d.ts +27 -0
  349. package/dist/core/ts4.2/room/track/utils.d.ts +20 -0
  350. package/dist/core/ts4.2/room/types.d.ts +126 -0
  351. package/dist/core/ts4.2/room/utils.d.ts +246 -0
  352. package/dist/core/ts4.2/room/video/create.d.ts +27 -0
  353. package/dist/core/ts4.2/room/video/extension.d.ts +43 -0
  354. package/dist/core/ts4.2/room/video/publisher.d.ts +23 -0
  355. package/dist/core/ts4.2/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
  356. package/dist/core/ts4.2/utils/AsyncQueue.d.ts +22 -0
  357. package/dist/core/ts4.2/utils/TypedPromise.d.ts +16 -0
  358. package/dist/core/ts4.2/utils/abort-signal-polyfill.d.ts +12 -0
  359. package/dist/core/ts4.2/utils/browserParser.d.ts +9 -0
  360. package/dist/core/ts4.2/utils/camelToSnakeCase.d.ts +7 -0
  361. package/dist/core/ts4.2/utils/cloneDeep.d.ts +1 -0
  362. package/dist/core/ts4.2/utils/dataPacketBuffer.d.ts +33 -0
  363. package/dist/core/ts4.2/utils/deferrable-map.d.ts +31 -0
  364. package/dist/core/ts4.2/utils/machineInspector.d.ts +53 -0
  365. package/dist/core/ts4.2/utils/serializer.d.ts +47 -0
  366. package/dist/core/ts4.2/utils/throws.d.ts +9 -0
  367. package/dist/core/ts4.2/utils/ttlmap.d.ts +19 -0
  368. package/dist/core/ts4.2/version.d.ts +17 -0
  369. package/dist/core/types/src/api/SignalClient.d.ts +19 -0
  370. package/dist/core/types/src/api/SignalClientStateMachine.d.ts +84 -0
  371. package/dist/core/types/src/api/WebSocketStream.d.ts +33 -0
  372. package/dist/core/types/src/api/utils.d.ts +8 -0
  373. package/dist/core/types/src/connectionHelper/ConnectionCheck.d.ts +28 -0
  374. package/dist/core/types/src/connectionHelper/checks/Checker.d.ts +64 -0
  375. package/dist/core/types/src/connectionHelper/checks/cloudRegion.d.ts +16 -0
  376. package/dist/core/types/src/connectionHelper/checks/connectionProtocol.d.ts +18 -0
  377. package/dist/core/types/src/connectionHelper/checks/publishAudio.d.ts +5 -0
  378. package/dist/core/types/src/connectionHelper/checks/publishVideo.d.ts +6 -0
  379. package/dist/core/types/src/connectionHelper/checks/reconnect.d.ts +5 -0
  380. package/dist/core/types/src/connectionHelper/checks/turn.d.ts +5 -0
  381. package/dist/core/types/src/connectionHelper/checks/webrtc.d.ts +5 -0
  382. package/dist/core/types/src/connectionHelper/checks/websocket.d.ts +5 -0
  383. package/dist/core/types/src/core.d.ts +32 -0
  384. package/dist/core/types/src/e2ee/E2eeManager.d.ts +89 -0
  385. package/dist/core/types/src/e2ee/KeyProvider.d.ts +53 -0
  386. package/dist/core/types/src/e2ee/constants.d.ts +20 -0
  387. package/dist/core/types/src/e2ee/errors.d.ts +11 -0
  388. package/dist/core/types/src/e2ee/events.d.ts +38 -0
  389. package/dist/core/types/src/e2ee/extension.d.ts +18 -0
  390. package/dist/core/types/src/e2ee/index.d.ts +5 -0
  391. package/dist/core/types/src/e2ee/types.d.ts +244 -0
  392. package/dist/core/types/src/e2ee/utils.d.ts +35 -0
  393. package/dist/core/types/src/exports.d.ts +75 -0
  394. package/dist/core/types/src/frameMetadata/FrameMetadataManager.d.ts +52 -0
  395. package/dist/core/types/src/frameMetadata/extension.d.ts +10 -0
  396. package/dist/core/types/src/frameMetadata/frameMetadata.d.ts +32 -0
  397. package/dist/core/types/src/frameMetadata/types.d.ts +61 -0
  398. package/dist/core/types/src/frameMetadata/utils.d.ts +13 -0
  399. package/dist/core/types/src/logger.d.ts +59 -0
  400. package/dist/core/types/src/options.d.ts +171 -0
  401. package/dist/core/types/src/room/BackOffStrategy.d.ts +26 -0
  402. package/dist/core/types/src/room/CoreRoom.d.ts +374 -0
  403. package/dist/core/types/src/room/DefaultReconnectPolicy.d.ts +7 -0
  404. package/dist/core/types/src/room/DeviceManager.d.ts +11 -0
  405. package/dist/core/types/src/room/PCTransport.d.ts +132 -0
  406. package/dist/core/types/src/room/PCTransportManager.d.ts +80 -0
  407. package/dist/core/types/src/room/RTCEngine.d.ts +232 -0
  408. package/dist/core/types/src/room/ReconnectPolicy.d.ts +23 -0
  409. package/dist/core/types/src/room/RegionUrlProvider.d.ts +33 -0
  410. package/dist/core/types/src/room/attribute-typings.d.ts +34 -0
  411. package/dist/core/types/src/room/chat/extension.d.ts +21 -0
  412. package/dist/core/types/src/room/createRoom.d.ts +18 -0
  413. package/dist/core/types/src/room/data-channel/DataChannelManager.d.ts +68 -0
  414. package/dist/core/types/src/room/data-channel/FlowControlledDataChannel.d.ts +107 -0
  415. package/dist/core/types/src/room/data-channel/LossyDataChannel.d.ts +39 -0
  416. package/dist/core/types/src/room/data-channel/ReliableDataChannel.d.ts +55 -0
  417. package/dist/core/types/src/room/data-channel/types.d.ts +11 -0
  418. package/dist/core/types/src/room/data-stream/compression.d.ts +29 -0
  419. package/dist/core/types/src/room/data-stream/constants.d.ts +1 -0
  420. package/dist/core/types/src/room/data-stream/extension.d.ts +62 -0
  421. package/dist/core/types/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +32 -0
  422. package/dist/core/types/src/room/data-stream/incoming/StreamReader.d.ts +77 -0
  423. package/dist/core/types/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
  424. package/dist/core/types/src/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
  425. package/dist/core/types/src/room/data-stream/outgoing/header-utils.d.ts +17 -0
  426. package/dist/core/types/src/room/data-track/LocalDataTrack.d.ts +70 -0
  427. package/dist/core/types/src/room/data-track/RemoteDataTrack.d.ts +43 -0
  428. package/dist/core/types/src/room/data-track/depacketizer.d.ts +58 -0
  429. package/dist/core/types/src/room/data-track/extension.d.ts +30 -0
  430. package/dist/core/types/src/room/data-track/frame.d.ts +21 -0
  431. package/dist/core/types/src/room/data-track/handle.d.ts +26 -0
  432. package/dist/core/types/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
  433. package/dist/core/types/src/room/data-track/incoming/errors.d.ts +23 -0
  434. package/dist/core/types/src/room/data-track/incoming/pipeline.d.ts +40 -0
  435. package/dist/core/types/src/room/data-track/incoming/types.d.ts +19 -0
  436. package/dist/core/types/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
  437. package/dist/core/types/src/room/data-track/outgoing/errors.d.ts +73 -0
  438. package/dist/core/types/src/room/data-track/outgoing/pipeline.d.ts +22 -0
  439. package/dist/core/types/src/room/data-track/outgoing/types.d.ts +47 -0
  440. package/dist/core/types/src/room/data-track/packet/constants.d.ts +19 -0
  441. package/dist/core/types/src/room/data-track/packet/errors.d.ts +39 -0
  442. package/dist/core/types/src/room/data-track/packet/extensions.d.ts +68 -0
  443. package/dist/core/types/src/room/data-track/packet/index.d.ts +91 -0
  444. package/dist/core/types/src/room/data-track/packet/serializable.d.ts +12 -0
  445. package/dist/core/types/src/room/data-track/packetizer.d.ts +40 -0
  446. package/dist/core/types/src/room/data-track/track-interfaces.d.ts +22 -0
  447. package/dist/core/types/src/room/data-track/types.d.ts +21 -0
  448. package/dist/core/types/src/room/data-track/utils.d.ts +59 -0
  449. package/dist/core/types/src/room/debounce.d.ts +10 -0
  450. package/dist/core/types/src/room/defaults.d.ts +7 -0
  451. package/dist/core/types/src/room/errors.d.ts +179 -0
  452. package/dist/core/types/src/room/events.d.ts +534 -0
  453. package/dist/core/types/src/room/extensions.d.ts +205 -0
  454. package/dist/core/types/src/room/participant/LocalParticipant.d.ts +164 -0
  455. package/dist/core/types/src/room/participant/Participant.d.ts +123 -0
  456. package/dist/core/types/src/room/participant/ParticipantTrackPermission.d.ts +25 -0
  457. package/dist/core/types/src/room/participant/RemoteParticipant.d.ts +37 -0
  458. package/dist/core/types/src/room/participant/publishUtils.d.ts +11 -0
  459. package/dist/core/types/src/room/rpc/client/RpcClientManager.d.ts +1 -0
  460. package/dist/core/types/src/room/rpc/client/events.d.ts +7 -0
  461. package/dist/core/types/src/room/rpc/extension.d.ts +69 -0
  462. package/dist/core/types/src/room/rpc/index.d.ts +5 -0
  463. package/dist/core/types/src/room/rpc/server/RpcServerManager.d.ts +1 -0
  464. package/dist/core/types/src/room/rpc/server/events.d.ts +7 -0
  465. package/dist/core/types/src/room/rpc/utils.d.ts +76 -0
  466. package/dist/core/types/src/room/simulated-participants/extension.d.ts +24 -0
  467. package/dist/core/types/src/room/stats.d.ts +70 -0
  468. package/dist/core/types/src/room/statsSummary.d.ts +12 -0
  469. package/dist/core/types/src/room/timers.d.ts +11 -0
  470. package/dist/core/types/src/room/token-source/TokenSource.d.ts +91 -0
  471. package/dist/core/types/src/room/token-source/types.d.ts +69 -0
  472. package/dist/core/types/src/room/token-source/utils.d.ts +7 -0
  473. package/dist/core/types/src/room/track/FrameMetadataExtractor.d.ts +18 -0
  474. package/dist/core/types/src/room/track/LocalAudioTrack.d.ts +53 -0
  475. package/dist/core/types/src/room/track/LocalTrack.d.ts +118 -0
  476. package/dist/core/types/src/room/track/LocalTrackPublication.d.ts +41 -0
  477. package/dist/core/types/src/room/track/LocalVideoTrack.d.ts +91 -0
  478. package/dist/core/types/src/room/track/RemoteAudioTrack.d.ts +49 -0
  479. package/dist/core/types/src/room/track/RemoteTrack.d.ts +29 -0
  480. package/dist/core/types/src/room/track/RemoteTrackPublication.d.ts +76 -0
  481. package/dist/core/types/src/room/track/RemoteVideoTrack.d.ts +56 -0
  482. package/dist/core/types/src/room/track/Track.d.ts +134 -0
  483. package/dist/core/types/src/room/track/TrackPublication.d.ts +74 -0
  484. package/dist/core/types/src/room/track/create.d.ts +12 -0
  485. package/dist/core/types/src/room/track/facingMode.d.ts +40 -0
  486. package/dist/core/types/src/room/track/options.d.ts +384 -0
  487. package/dist/core/types/src/room/track/processor/types.d.ts +41 -0
  488. package/dist/core/types/src/room/track/record.d.ts +12 -0
  489. package/dist/core/types/src/room/track/types.d.ts +27 -0
  490. package/dist/core/types/src/room/track/utils.d.ts +20 -0
  491. package/dist/core/types/src/room/types.d.ts +126 -0
  492. package/dist/core/types/src/room/utils.d.ts +246 -0
  493. package/dist/core/types/src/room/video/create.d.ts +27 -0
  494. package/dist/core/types/src/room/video/extension.d.ts +43 -0
  495. package/dist/core/types/src/room/video/publisher.d.ts +23 -0
  496. package/dist/core/types/src/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
  497. package/dist/core/types/src/utils/AsyncQueue.d.ts +22 -0
  498. package/dist/core/types/src/utils/TypedPromise.d.ts +15 -0
  499. package/dist/core/types/src/utils/abort-signal-polyfill.d.ts +12 -0
  500. package/dist/core/types/src/utils/browserParser.d.ts +9 -0
  501. package/dist/core/types/src/utils/camelToSnakeCase.d.ts +7 -0
  502. package/dist/core/types/src/utils/cloneDeep.d.ts +1 -0
  503. package/dist/core/types/src/utils/dataPacketBuffer.d.ts +33 -0
  504. package/dist/core/types/src/utils/deferrable-map.d.ts +31 -0
  505. package/dist/core/types/src/utils/machineInspector.d.ts +53 -0
  506. package/dist/core/types/src/utils/serializer.d.ts +47 -0
  507. package/dist/core/types/src/utils/throws.d.ts +9 -0
  508. package/dist/core/types/src/utils/ttlmap.d.ts +19 -0
  509. package/dist/core/types/src/version.d.ts +17 -0
  510. package/dist/core/utils/AsyncQueue.mjs +41 -0
  511. package/dist/core/utils/AsyncQueue.mjs.map +1 -0
  512. package/dist/core/utils/TypedPromise.mjs +23 -0
  513. package/dist/core/utils/TypedPromise.mjs.map +1 -0
  514. package/dist/core/utils/abort-signal-polyfill.mjs +53 -0
  515. package/dist/core/utils/abort-signal-polyfill.mjs.map +1 -0
  516. package/dist/core/utils/browserParser.mjs +62 -0
  517. package/dist/core/utils/browserParser.mjs.map +1 -0
  518. package/dist/core/utils/cloneDeep.mjs +14 -0
  519. package/dist/core/utils/cloneDeep.mjs.map +1 -0
  520. package/dist/core/utils/dataPacketBuffer.mjs +76 -0
  521. package/dist/core/utils/dataPacketBuffer.mjs.map +1 -0
  522. package/dist/core/utils/deferrable-map.mjs +94 -0
  523. package/dist/core/utils/deferrable-map.mjs.map +1 -0
  524. package/dist/core/utils/machineInspector.mjs +19 -0
  525. package/dist/core/utils/machineInspector.mjs.map +1 -0
  526. package/dist/core/utils/serializer.mjs +47 -0
  527. package/dist/core/utils/serializer.mjs.map +1 -0
  528. package/dist/core/utils/ttlmap.mjs +97 -0
  529. package/dist/core/utils/ttlmap.mjs.map +1 -0
  530. package/dist/core/version.mjs +17 -0
  531. package/dist/core/version.mjs.map +1 -0
  532. package/dist/livekit-client.e2ee.worker.js +1 -1
  533. package/dist/livekit-client.e2ee.worker.js.map +1 -1
  534. package/dist/livekit-client.e2ee.worker.mjs +225 -137
  535. package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
  536. package/dist/livekit-client.esm.mjs +32913 -31390
  537. package/dist/livekit-client.esm.mjs.map +1 -1
  538. package/dist/livekit-client.fm.worker.js +1 -1
  539. package/dist/livekit-client.fm.worker.js.map +1 -1
  540. package/dist/livekit-client.fm.worker.mjs +21 -82
  541. package/dist/livekit-client.fm.worker.mjs.map +1 -1
  542. package/dist/livekit-client.umd.js +1 -1
  543. package/dist/livekit-client.umd.js.map +1 -1
  544. package/dist/src/api/SignalClient.d.ts +1 -1
  545. package/dist/src/api/SignalClient.d.ts.map +1 -1
  546. package/dist/src/api/WebSocketStream.d.ts +1 -0
  547. package/dist/src/api/WebSocketStream.d.ts.map +1 -1
  548. package/dist/src/api/utils.d.ts +1 -1
  549. package/dist/src/api/utils.d.ts.map +1 -1
  550. package/dist/src/connectionHelper/checks/Checker.d.ts +7 -4
  551. package/dist/src/connectionHelper/checks/Checker.d.ts.map +1 -1
  552. package/dist/src/core.d.ts +33 -0
  553. package/dist/src/core.d.ts.map +1 -0
  554. package/dist/src/e2ee/E2eeManager.d.ts +25 -5
  555. package/dist/src/e2ee/E2eeManager.d.ts.map +1 -1
  556. package/dist/src/e2ee/KeyProvider.d.ts.map +1 -1
  557. package/dist/src/e2ee/extension.d.ts +19 -0
  558. package/dist/src/e2ee/extension.d.ts.map +1 -0
  559. package/dist/src/e2ee/types.d.ts +14 -0
  560. package/dist/src/e2ee/types.d.ts.map +1 -1
  561. package/dist/src/e2ee/utils.d.ts +6 -1
  562. package/dist/src/e2ee/utils.d.ts.map +1 -1
  563. package/dist/src/e2ee/worker/FrameCryptor.d.ts +7 -1
  564. package/dist/src/e2ee/worker/FrameCryptor.d.ts.map +1 -1
  565. package/dist/src/e2ee/worker/naluUtils.d.ts +19 -1
  566. package/dist/src/e2ee/worker/naluUtils.d.ts.map +1 -1
  567. package/dist/src/e2ee/worker/sifPayload.d.ts +1 -1
  568. package/dist/src/e2ee/worker/sifPayload.d.ts.map +1 -1
  569. package/dist/src/exports.d.ts +76 -0
  570. package/dist/src/exports.d.ts.map +1 -0
  571. package/dist/src/frameMetadata/FrameMetadataManager.d.ts +5 -2
  572. package/dist/src/frameMetadata/FrameMetadataManager.d.ts.map +1 -1
  573. package/dist/src/frameMetadata/extension.d.ts +11 -0
  574. package/dist/src/frameMetadata/extension.d.ts.map +1 -0
  575. package/dist/src/frameMetadata/utils.d.ts +5 -0
  576. package/dist/src/frameMetadata/utils.d.ts.map +1 -1
  577. package/dist/src/index.d.ts +35 -63
  578. package/dist/src/index.d.ts.map +1 -1
  579. package/dist/src/logger.d.ts +1 -3
  580. package/dist/src/logger.d.ts.map +1 -1
  581. package/dist/src/options.d.ts +20 -6
  582. package/dist/src/options.d.ts.map +1 -1
  583. package/dist/src/room/CoreRoom.d.ts +392 -0
  584. package/dist/src/room/CoreRoom.d.ts.map +1 -0
  585. package/dist/src/room/DefaultReconnectPolicy.d.ts.map +1 -1
  586. package/dist/src/room/PCTransport.d.ts +31 -6
  587. package/dist/src/room/PCTransport.d.ts.map +1 -1
  588. package/dist/src/room/PCTransportManager.d.ts +8 -4
  589. package/dist/src/room/PCTransportManager.d.ts.map +1 -1
  590. package/dist/src/room/RTCEngine.d.ts +31 -6
  591. package/dist/src/room/RTCEngine.d.ts.map +1 -1
  592. package/dist/src/room/Room.d.ts +5 -350
  593. package/dist/src/room/Room.d.ts.map +1 -1
  594. package/dist/src/room/chat/extension.d.ts +22 -0
  595. package/dist/src/room/chat/extension.d.ts.map +1 -0
  596. package/dist/src/room/createRoom.d.ts +19 -0
  597. package/dist/src/room/createRoom.d.ts.map +1 -0
  598. package/dist/src/room/data-channel/DataChannelManager.d.ts +16 -9
  599. package/dist/src/room/data-channel/DataChannelManager.d.ts.map +1 -1
  600. package/dist/src/room/data-channel/FlowControlledDataChannel.d.ts +25 -12
  601. package/dist/src/room/data-channel/FlowControlledDataChannel.d.ts.map +1 -1
  602. package/dist/src/room/data-channel/LossyDataChannel.d.ts.map +1 -1
  603. package/dist/src/room/data-channel/ReliableDataChannel.d.ts.map +1 -1
  604. package/dist/src/room/data-stream/constants.d.ts +9 -0
  605. package/dist/src/room/data-stream/constants.d.ts.map +1 -1
  606. package/dist/src/room/data-stream/extension.d.ts +73 -0
  607. package/dist/src/room/data-stream/extension.d.ts.map +1 -0
  608. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  609. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts.map +1 -1
  610. package/dist/src/room/data-stream/incoming/StreamReader.d.ts.map +1 -1
  611. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  612. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts.map +1 -1
  613. package/dist/src/room/data-track/LocalDataTrack.d.ts +1 -1
  614. package/dist/src/room/data-track/depacketizer.d.ts +1 -1
  615. package/dist/src/room/data-track/depacketizer.d.ts.map +1 -1
  616. package/dist/src/room/data-track/extension.d.ts +31 -0
  617. package/dist/src/room/data-track/extension.d.ts.map +1 -0
  618. package/dist/src/room/data-track/handle.d.ts +1 -1
  619. package/dist/src/room/data-track/handle.d.ts.map +1 -1
  620. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  621. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts.map +1 -1
  622. package/dist/src/room/data-track/incoming/pipeline.d.ts +1 -1
  623. package/dist/src/room/data-track/incoming/pipeline.d.ts.map +1 -1
  624. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  625. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts.map +1 -1
  626. package/dist/src/room/data-track/outgoing/pipeline.d.ts +1 -1
  627. package/dist/src/room/data-track/outgoing/pipeline.d.ts.map +1 -1
  628. package/dist/src/room/data-track/packet/extensions.d.ts +1 -1
  629. package/dist/src/room/data-track/packet/extensions.d.ts.map +1 -1
  630. package/dist/src/room/data-track/packet/index.d.ts +1 -1
  631. package/dist/src/room/data-track/packet/index.d.ts.map +1 -1
  632. package/dist/src/room/data-track/packet/serializable.d.ts +1 -1
  633. package/dist/src/room/data-track/packet/serializable.d.ts.map +1 -1
  634. package/dist/src/room/data-track/packetizer.d.ts +1 -1
  635. package/dist/src/room/data-track/packetizer.d.ts.map +1 -1
  636. package/dist/src/room/data-track/track-interfaces.d.ts +1 -1
  637. package/dist/src/room/data-track/track-interfaces.d.ts.map +1 -1
  638. package/dist/src/room/data-track/utils.d.ts +1 -1
  639. package/dist/src/room/defaults.d.ts +1 -2
  640. package/dist/src/room/defaults.d.ts.map +1 -1
  641. package/dist/src/room/extensions.d.ts +208 -0
  642. package/dist/src/room/extensions.d.ts.map +1 -0
  643. package/dist/src/room/participant/LocalParticipant.d.ts +49 -120
  644. package/dist/src/room/participant/LocalParticipant.d.ts.map +1 -1
  645. package/dist/src/room/participant/Participant.d.ts +9 -2
  646. package/dist/src/room/participant/Participant.d.ts.map +1 -1
  647. package/dist/src/room/participant/RemoteParticipant.d.ts +3 -3
  648. package/dist/src/room/participant/RemoteParticipant.d.ts.map +1 -1
  649. package/dist/src/room/participant/publishUtils.d.ts.map +1 -1
  650. package/dist/src/room/rpc/extension.d.ts +70 -0
  651. package/dist/src/room/rpc/extension.d.ts.map +1 -0
  652. package/dist/src/room/rpc/index.d.ts +1 -1
  653. package/dist/src/room/rpc/index.d.ts.map +1 -1
  654. package/dist/src/room/rpc/legacyExtension.d.ts +34 -0
  655. package/dist/src/room/rpc/legacyExtension.d.ts.map +1 -0
  656. package/dist/src/room/rpc/utils.d.ts.map +1 -1
  657. package/dist/src/room/simulated-participants/extension.d.ts +25 -0
  658. package/dist/src/room/simulated-participants/extension.d.ts.map +1 -0
  659. package/dist/src/room/token-source/TokenSource.d.ts +5 -1
  660. package/dist/src/room/token-source/TokenSource.d.ts.map +1 -1
  661. package/dist/src/room/token-source/utils.d.ts.map +1 -1
  662. package/dist/src/room/track/LocalAudioTrack.d.ts +24 -1
  663. package/dist/src/room/track/LocalAudioTrack.d.ts.map +1 -1
  664. package/dist/src/room/track/LocalTrack.d.ts +19 -1
  665. package/dist/src/room/track/LocalTrack.d.ts.map +1 -1
  666. package/dist/src/room/track/LocalVideoTrack.d.ts +7 -0
  667. package/dist/src/room/track/LocalVideoTrack.d.ts.map +1 -1
  668. package/dist/src/room/track/RemoteAudioTrack.d.ts +6 -0
  669. package/dist/src/room/track/RemoteAudioTrack.d.ts.map +1 -1
  670. package/dist/src/room/track/RemoteTrackPublication.d.ts +14 -1
  671. package/dist/src/room/track/RemoteTrackPublication.d.ts.map +1 -1
  672. package/dist/src/room/track/Track.d.ts.map +1 -1
  673. package/dist/src/room/track/TrackPublication.d.ts +2 -2
  674. package/dist/src/room/track/TrackPublication.d.ts.map +1 -1
  675. package/dist/src/room/track/create.d.ts +15 -13
  676. package/dist/src/room/track/create.d.ts.map +1 -1
  677. package/dist/src/room/track/facingMode.d.ts.map +1 -1
  678. package/dist/src/room/track/options.d.ts +0 -6
  679. package/dist/src/room/track/options.d.ts.map +1 -1
  680. package/dist/src/room/track/processor/types.d.ts +13 -2
  681. package/dist/src/room/track/processor/types.d.ts.map +1 -1
  682. package/dist/src/room/track/utils.d.ts +1 -1
  683. package/dist/src/room/track/utils.d.ts.map +1 -1
  684. package/dist/src/room/utils.d.ts +30 -3
  685. package/dist/src/room/utils.d.ts.map +1 -1
  686. package/dist/src/room/video/create.d.ts +28 -0
  687. package/dist/src/room/video/create.d.ts.map +1 -0
  688. package/dist/src/room/video/extension.d.ts +48 -0
  689. package/dist/src/room/video/extension.d.ts.map +1 -0
  690. package/dist/src/room/video/publisher.d.ts +24 -0
  691. package/dist/src/room/video/publisher.d.ts.map +1 -0
  692. package/dist/src/test/MockMediaStream.d.ts +6 -0
  693. package/dist/src/test/MockMediaStream.d.ts.map +1 -0
  694. package/dist/src/utils/browserParser.d.ts +0 -3
  695. package/dist/src/utils/browserParser.d.ts.map +1 -1
  696. package/dist/src/utils/deferrable-map.d.ts +1 -1
  697. package/dist/src/utils/deferrable-map.d.ts.map +1 -1
  698. package/dist/src/utils/serializer.d.ts.map +1 -1
  699. package/dist/src/utils/throws.d.ts +10 -0
  700. package/dist/src/utils/throws.d.ts.map +1 -0
  701. package/dist/src/version.d.ts +4 -1
  702. package/dist/src/version.d.ts.map +1 -1
  703. package/dist/ts4.2/api/WebSocketStream.d.ts +1 -0
  704. package/dist/ts4.2/api/utils.d.ts +1 -1
  705. package/dist/ts4.2/connectionHelper/checks/Checker.d.ts +7 -4
  706. package/dist/ts4.2/core.d.ts +34 -0
  707. package/dist/ts4.2/e2ee/E2eeManager.d.ts +25 -5
  708. package/dist/ts4.2/e2ee/extension.d.ts +20 -0
  709. package/dist/ts4.2/e2ee/types.d.ts +14 -0
  710. package/dist/ts4.2/e2ee/utils.d.ts +6 -1
  711. package/dist/ts4.2/e2ee/worker/FrameCryptor.d.ts +7 -1
  712. package/dist/ts4.2/e2ee/worker/naluUtils.d.ts +19 -1
  713. package/dist/ts4.2/e2ee/worker/sifPayload.d.ts +1 -1
  714. package/dist/ts4.2/exports.d.ts +83 -0
  715. package/dist/ts4.2/frameMetadata/FrameMetadataManager.d.ts +5 -2
  716. package/dist/ts4.2/frameMetadata/extension.d.ts +13 -0
  717. package/dist/ts4.2/frameMetadata/utils.d.ts +5 -0
  718. package/dist/ts4.2/index.d.ts +35 -69
  719. package/dist/ts4.2/logger.d.ts +1 -3
  720. package/dist/ts4.2/options.d.ts +20 -6
  721. package/dist/ts4.2/room/CoreRoom.d.ts +381 -0
  722. package/dist/ts4.2/room/PCTransport.d.ts +31 -6
  723. package/dist/ts4.2/room/PCTransportManager.d.ts +8 -4
  724. package/dist/ts4.2/room/RTCEngine.d.ts +31 -6
  725. package/dist/ts4.2/room/Room.d.ts +6 -339
  726. package/dist/ts4.2/room/chat/extension.d.ts +22 -0
  727. package/dist/ts4.2/room/createRoom.d.ts +20 -0
  728. package/dist/ts4.2/room/data-channel/DataChannelManager.d.ts +15 -9
  729. package/dist/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +25 -12
  730. package/dist/ts4.2/room/data-stream/constants.d.ts +9 -0
  731. package/dist/ts4.2/room/data-stream/extension.d.ts +74 -0
  732. package/dist/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  733. package/dist/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  734. package/dist/ts4.2/room/data-track/LocalDataTrack.d.ts +1 -1
  735. package/dist/ts4.2/room/data-track/depacketizer.d.ts +1 -1
  736. package/dist/ts4.2/room/data-track/extension.d.ts +31 -0
  737. package/dist/ts4.2/room/data-track/handle.d.ts +1 -1
  738. package/dist/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  739. package/dist/ts4.2/room/data-track/incoming/pipeline.d.ts +1 -1
  740. package/dist/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  741. package/dist/ts4.2/room/data-track/outgoing/pipeline.d.ts +1 -1
  742. package/dist/ts4.2/room/data-track/packet/extensions.d.ts +1 -1
  743. package/dist/ts4.2/room/data-track/packet/index.d.ts +1 -1
  744. package/dist/ts4.2/room/data-track/packet/serializable.d.ts +1 -1
  745. package/dist/ts4.2/room/data-track/packetizer.d.ts +1 -1
  746. package/dist/ts4.2/room/data-track/track-interfaces.d.ts +1 -1
  747. package/dist/ts4.2/room/data-track/utils.d.ts +1 -1
  748. package/dist/ts4.2/room/defaults.d.ts +1 -2
  749. package/dist/ts4.2/room/extensions.d.ts +214 -0
  750. package/dist/ts4.2/room/participant/LocalParticipant.d.ts +48 -121
  751. package/dist/ts4.2/room/participant/Participant.d.ts +9 -2
  752. package/dist/ts4.2/room/participant/RemoteParticipant.d.ts +3 -3
  753. package/dist/ts4.2/room/rpc/extension.d.ts +74 -0
  754. package/dist/ts4.2/room/rpc/index.d.ts +1 -1
  755. package/dist/ts4.2/room/rpc/legacyExtension.d.ts +39 -0
  756. package/dist/ts4.2/room/simulated-participants/extension.d.ts +25 -0
  757. package/dist/ts4.2/room/token-source/TokenSource.d.ts +5 -1
  758. package/dist/ts4.2/room/track/LocalAudioTrack.d.ts +24 -1
  759. package/dist/ts4.2/room/track/LocalTrack.d.ts +19 -1
  760. package/dist/ts4.2/room/track/LocalVideoTrack.d.ts +7 -0
  761. package/dist/ts4.2/room/track/RemoteAudioTrack.d.ts +6 -0
  762. package/dist/ts4.2/room/track/RemoteTrackPublication.d.ts +3 -1
  763. package/dist/ts4.2/room/track/TrackPublication.d.ts +2 -2
  764. package/dist/ts4.2/room/track/create.d.ts +15 -13
  765. package/dist/ts4.2/room/track/options.d.ts +0 -6
  766. package/dist/ts4.2/room/track/processor/types.d.ts +13 -2
  767. package/dist/ts4.2/room/track/utils.d.ts +1 -1
  768. package/dist/ts4.2/room/utils.d.ts +30 -3
  769. package/dist/ts4.2/room/video/create.d.ts +28 -0
  770. package/dist/ts4.2/room/video/extension.d.ts +48 -0
  771. package/dist/ts4.2/room/video/publisher.d.ts +24 -0
  772. package/dist/ts4.2/test/MockMediaStream.d.ts +6 -0
  773. package/dist/ts4.2/utils/browserParser.d.ts +0 -3
  774. package/dist/ts4.2/utils/deferrable-map.d.ts +1 -1
  775. package/dist/ts4.2/utils/throws.d.ts +10 -0
  776. package/dist/ts4.2/version.d.ts +4 -1
  777. package/package.json +24 -9
  778. package/src/api/SignalClient.test.ts +341 -0
  779. package/src/api/SignalClient.ts +71 -26
  780. package/src/api/WebSocketStream.test.ts +78 -0
  781. package/src/api/WebSocketStream.ts +63 -4
  782. package/src/api/utils.ts +1 -1
  783. package/src/connectionHelper/checks/Checker.ts +12 -5
  784. package/src/connectionHelper/checks/publishVideo.ts +1 -1
  785. package/src/connectionHelper/checks/reconnect.ts +1 -1
  786. package/src/core.ts +35 -0
  787. package/src/e2ee/E2eeManager.test.ts +113 -1
  788. package/src/e2ee/E2eeManager.ts +58 -33
  789. package/src/e2ee/KeyProvider.ts +2 -1
  790. package/src/e2ee/extension.ts +113 -0
  791. package/src/e2ee/subscriberBlackScreen.test.ts +9 -12
  792. package/src/e2ee/types.ts +14 -0
  793. package/src/e2ee/utils.test.ts +47 -0
  794. package/src/e2ee/utils.ts +26 -14
  795. package/src/e2ee/worker/DataCryptor.test.ts +42 -1
  796. package/src/e2ee/worker/DataCryptor.ts +2 -2
  797. package/src/e2ee/worker/FrameCryptor.race.test.ts +3 -7
  798. package/src/e2ee/worker/FrameCryptor.test.ts +280 -103
  799. package/src/e2ee/worker/FrameCryptor.ts +97 -20
  800. package/src/e2ee/worker/e2ee.worker.test.ts +151 -0
  801. package/src/e2ee/worker/e2ee.worker.ts +28 -20
  802. package/src/e2ee/worker/naluUtils.test.ts +143 -0
  803. package/src/e2ee/worker/naluUtils.ts +87 -2
  804. package/src/e2ee/worker/sifPayload.ts +1 -1
  805. package/src/exports.ts +224 -0
  806. package/src/frameMetadata/FrameMetadataManager.ts +9 -3
  807. package/src/frameMetadata/extension.ts +34 -0
  808. package/src/frameMetadata/frameMetadata.ts +1 -1
  809. package/src/frameMetadata/utils.ts +23 -0
  810. package/src/index.ts +47 -187
  811. package/src/logger.ts +1 -3
  812. package/src/options.ts +25 -6
  813. package/src/room/CoreRoom.ts +3017 -0
  814. package/src/room/DefaultReconnectPolicy.test.ts +58 -0
  815. package/src/room/DefaultReconnectPolicy.ts +14 -2
  816. package/src/room/DeviceManager.test.ts +55 -1
  817. package/src/room/DeviceManager.ts +1 -1
  818. package/src/room/PCTransport.test.ts +187 -2
  819. package/src/room/PCTransport.ts +173 -31
  820. package/src/room/PCTransportManager.test.ts +65 -3
  821. package/src/room/PCTransportManager.ts +28 -12
  822. package/src/room/RTCEngine.test.ts +654 -22
  823. package/src/room/RTCEngine.ts +240 -41
  824. package/src/room/RegionUrlProvider.ts +1 -1
  825. package/src/room/Room.test.ts +833 -4
  826. package/src/room/Room.ts +34 -3105
  827. package/src/room/chat/extension.ts +78 -0
  828. package/src/room/createRoom.test.ts +149 -0
  829. package/src/room/createRoom.ts +26 -0
  830. package/src/room/data-channel/DataChannelManager.test.ts +61 -7
  831. package/src/room/data-channel/DataChannelManager.ts +61 -38
  832. package/src/room/data-channel/FlowControlledDataChannel.test.ts +60 -18
  833. package/src/room/data-channel/FlowControlledDataChannel.ts +40 -22
  834. package/src/room/data-channel/LossyDataChannel.test.ts +38 -0
  835. package/src/room/data-channel/LossyDataChannel.ts +10 -1
  836. package/src/room/data-channel/ReliableDataChannel.test.ts +72 -0
  837. package/src/room/data-channel/ReliableDataChannel.ts +16 -5
  838. package/src/room/data-stream/constants.ts +10 -0
  839. package/src/room/data-stream/extension.ts +162 -0
  840. package/src/room/data-stream/incoming/IncomingDataStreamManager.test.ts +300 -3
  841. package/src/room/data-stream/incoming/IncomingDataStreamManager.ts +64 -2
  842. package/src/room/data-stream/incoming/StreamReader.ts +14 -4
  843. package/src/room/data-stream/outgoing/OutgoingDataStreamManager.ts +1 -2
  844. package/src/room/data-track/depacketizer.ts +2 -2
  845. package/src/room/data-track/extension.ts +244 -0
  846. package/src/room/data-track/handle.ts +1 -1
  847. package/src/room/data-track/incoming/IncomingDataTrackManager.ts +2 -2
  848. package/src/room/data-track/incoming/pipeline.ts +2 -2
  849. package/src/room/data-track/outgoing/OutgoingDataTrackManager.test.ts +42 -3
  850. package/src/room/data-track/outgoing/OutgoingDataTrackManager.ts +5 -3
  851. package/src/room/data-track/outgoing/pipeline.ts +1 -1
  852. package/src/room/data-track/packet/extensions.ts +1 -1
  853. package/src/room/data-track/packet/index.ts +1 -1
  854. package/src/room/data-track/packet/serializable.ts +1 -1
  855. package/src/room/data-track/packetizer.ts +1 -1
  856. package/src/room/data-track/track-interfaces.ts +4 -4
  857. package/src/room/data-track/utils.ts +1 -1
  858. package/src/room/defaults.ts +3 -16
  859. package/src/room/extensions.ts +310 -0
  860. package/src/room/participant/LocalParticipant.test.ts +154 -2
  861. package/src/room/participant/LocalParticipant.ts +141 -669
  862. package/src/room/participant/Participant.test.ts +60 -0
  863. package/src/room/participant/Participant.ts +27 -4
  864. package/src/room/participant/RemoteParticipant.ts +3 -8
  865. package/src/room/participant/publishUtils.ts +3 -3
  866. package/src/room/participant/restartOnDefaultAudioDevice.test.ts +177 -0
  867. package/src/room/rpc/extension.ts +159 -0
  868. package/src/room/rpc/index.ts +1 -10
  869. package/src/room/rpc/legacyExtension.ts +36 -0
  870. package/src/room/rpc/utils.test.ts +32 -0
  871. package/src/room/rpc/utils.ts +7 -0
  872. package/src/room/simulated-participants/extension.ts +189 -0
  873. package/src/room/token-source/TokenSource.test.ts +29 -0
  874. package/src/room/token-source/TokenSource.ts +8 -3
  875. package/src/room/token-source/utils.test.ts +34 -0
  876. package/src/room/token-source/utils.ts +23 -1
  877. package/src/room/track/LocalAudioTrack.ts +101 -10
  878. package/src/room/track/LocalTrack.ts +88 -23
  879. package/src/room/track/LocalVideoTrack.test.ts +66 -2
  880. package/src/room/track/LocalVideoTrack.ts +12 -3
  881. package/src/room/track/RemoteAudioTrack.ts +56 -11
  882. package/src/room/track/RemoteTrackPublication.ts +14 -1
  883. package/src/room/track/RemoteVideoTrack.test.ts +2 -0
  884. package/src/room/track/Track.test.ts +102 -0
  885. package/src/room/track/Track.ts +8 -1
  886. package/src/room/track/TrackPublication.ts +2 -2
  887. package/src/room/track/create.ts +59 -71
  888. package/src/room/track/facingMode.ts +5 -2
  889. package/src/room/track/options.ts +26 -34
  890. package/src/room/track/processor/types.ts +13 -2
  891. package/src/room/track/utils.test.ts +5 -0
  892. package/src/room/track/utils.ts +34 -6
  893. package/src/room/utils.test.ts +126 -0
  894. package/src/room/utils.ts +86 -23
  895. package/src/room/video/create.ts +95 -0
  896. package/src/room/video/extension.ts +115 -0
  897. package/src/room/video/publisher.ts +472 -0
  898. package/src/test/MockMediaStream.ts +13 -0
  899. package/src/utils/browserParser.ts +0 -3
  900. package/src/utils/deferrable-map.test.ts +60 -0
  901. package/src/utils/deferrable-map.ts +7 -4
  902. package/src/utils/serializer.ts +1 -1
  903. package/src/utils/throws.ts +15 -0
  904. package/src/version.ts +6 -1
@@ -9,7 +9,6 @@ import { NegotiationError, UnexpectedConnectionState } from './errors';
9
9
  import type { LoggerOptions } from './types';
10
10
  import { ddExtensionURI, isSVCCodec, isSafari } from './utils';
11
11
 
12
- /** @internal */
13
12
  interface TrackBitrateInfo {
14
13
  cid?: string;
15
14
  transceiver?: RTCRtpTransceiver;
@@ -28,6 +27,9 @@ interface TrackBitrateInfo {
28
27
  * Why same for all codecs: Target bitrate already accounts for codec efficiency
29
28
  * (e.g., users set lower targets for VP9/AV1 knowing they're more efficient).
30
29
  * Why cap at 1 Mbps: Prevents BWE from starting too aggressively on high bitrate tracks.
30
+ * The cap is lowered further for connections that were slow to set up, see
31
+ * `computeStartBitrateCap`, or that the browser reports as slow, see
32
+ * `connectionEffectiveTypeStartBitrateCap`.
31
33
  */
32
34
  const startBitrateMultiplier = 0.9;
33
35
 
@@ -35,11 +37,35 @@ const startBitrateMultiplier = 0.9;
35
37
  const maxStartBitrateKbps = 1000;
36
38
 
37
39
  /**
38
- * Minimum target bitrate in kbps for the start bitrate hint. Below this, seeding above the
39
- * real capacity costs more than the ramp it saves, so libwebrtc's default is left in place.
40
+ * Minimum x-google-start-bitrate in kbps: libwebrtc's own default starting estimate. A target
41
+ * below this gets no hint, since seeding above the real capacity costs more than the ramp it
42
+ * saves, and a slow connection is seeded no higher than this.
40
43
  */
41
44
  const minTargetBitrateKbps = 300;
42
45
 
46
+ /**
47
+ * Connection setup times (ms) bounding the ramp in `computeStartBitrateCap`: at or below the
48
+ * first the hint is capped at `maxStartBitrateKbps`, at or above the second at
49
+ * `minTargetBitrateKbps`. Measured on shaped links (CLT-3380): healthy links set up in under
50
+ * 860 ms, a 1 Mbps link with 150 ms RTT took 1.1–1.7 s, a 500 kbps link ~2.3 s at the median,
51
+ * and a 300 kbps link never under 3 s. The first sits above the 1 Mbps link, which a lower seed
52
+ * only slows down, and the second above the 500 kbps link's median, so only links that cannot
53
+ * carry more land at the floor.
54
+ */
55
+ const setupTimeForMaxStartBitrateMs = 1500;
56
+ const setupTimeForMinStartBitrateMs = 3500;
57
+
58
+ /** Cap on the start bitrate hint, in kbps, when the browser reports a `3g` connection. */
59
+ const effectiveType3gStartBitrateKbps = 500;
60
+
61
+ /**
62
+ * The part of the Network Information API (`navigator.connection`) read here. It is Chromium
63
+ * only, so TypeScript's DOM typings do not declare it.
64
+ */
65
+ interface NetworkInformation {
66
+ readonly effectiveType?: 'slow-2g' | '2g' | '3g' | '4g';
67
+ }
68
+
43
69
  const debounceInterval = 20;
44
70
 
45
71
  /**
@@ -71,17 +97,84 @@ export function findTrackCodecPayload(
71
97
  * high-bitrate track; screen share is exempt, because its content needs the bitrate
72
98
  * immediately to stay legible.
73
99
  *
74
- * TODO: adjust dynamically from network conditions (e.g. a previous BWE estimate) rather
75
- * than a fixed cap.
100
+ * The cap is lowered for a connection that was slow to set up (`computeStartBitrateCap`), and
101
+ * for one the browser reports as slow (`connectionEffectiveTypeStartBitrateCap`), whichever is
102
+ * lower. Screen share is exempt from both, however slow the connection.
76
103
  *
77
104
  * @internal
78
105
  */
79
- export function computeTrackStartBitrate(trackbr: TrackBitrateInfo): number | undefined {
106
+ export function computeTrackStartBitrate(
107
+ trackbr: TrackBitrateInfo,
108
+ connectionSetupTimeMs?: number,
109
+ ): number | undefined {
80
110
  if (trackbr.maxbr < minTargetBitrateKbps) {
81
111
  return undefined;
82
112
  }
83
- const calculated = Math.round(trackbr.maxbr * startBitrateMultiplier);
84
- return trackbr.isScreenShare ? calculated : Math.min(calculated, maxStartBitrateKbps);
113
+ const calculated = Math.min(Math.round(trackbr.maxbr * startBitrateMultiplier), trackbr.maxbr);
114
+ if (trackbr.isScreenShare) {
115
+ return calculated;
116
+ }
117
+ const cap = Math.min(
118
+ computeStartBitrateCap(connectionSetupTimeMs),
119
+ connectionEffectiveTypeStartBitrateCap(),
120
+ );
121
+ return Math.min(calculated, cap);
122
+ }
123
+
124
+ /**
125
+ * Cap on the start bitrate hint, in kbps, from the browser's effective connection type
126
+ * (`navigator.connection.effectiveType`, Chromium only): `slow-2g` and `2g` cap at
127
+ * `minTargetBitrateKbps`, `3g` at `effectiveType3gStartBitrateKbps`.
128
+ *
129
+ * It catches links that have low bandwidth but low latency, which set up quickly and so slip
130
+ * past the setup time ramp. `4g`, and browsers without the API, give no guidance and stay at the
131
+ * `maxStartBitrateKbps` ceiling, as `computeStartBitrateCap` does without a setup time. The
132
+ * connection RTT the API also reports is not used: it lags behind network changes, and the setup
133
+ * time already reflects latency.
134
+ */
135
+ function connectionEffectiveTypeStartBitrateCap(): number {
136
+ // A `typeof` guard, since `globalThis` is missing from some supported browsers (Chrome < 71,
137
+ // Firefox < 65, Safari < 12.1) and the build does not polyfill it.
138
+ const connection =
139
+ typeof navigator !== 'undefined'
140
+ ? (navigator as Navigator & { connection?: NetworkInformation }).connection
141
+ : undefined;
142
+ switch (connection?.effectiveType) {
143
+ case 'slow-2g':
144
+ case '2g':
145
+ return minTargetBitrateKbps;
146
+ case '3g':
147
+ return effectiveType3gStartBitrateKbps;
148
+ default:
149
+ return maxStartBitrateKbps;
150
+ }
151
+ }
152
+
153
+ /**
154
+ * Cap on the start bitrate hint, in kbps, from how long the connection took to set up.
155
+ *
156
+ * Connection setup time (signaling join plus ICE/DTLS) is the network signal every platform has
157
+ * before the first video offer, since libwebrtc cannot probe the path until a video sender
158
+ * exists. It grows with round-trip time and loss, which also mark the links where a 1 Mbps
159
+ * seed overshoots, so the cap ramps linearly from `maxStartBitrateKbps` at
160
+ * `setupTimeForMaxStartBitrateMs` down to `minTargetBitrateKbps` at
161
+ * `setupTimeForMinStartBitrateMs`. A video offer built while the connection is still being set
162
+ * up (publishing during connect) passes the time elapsed so far, a lower bound on the setup time.
163
+ * Without any timing the cap stays at the 1 Mbps ceiling.
164
+ */
165
+ function computeStartBitrateCap(connectionSetupTimeMs?: number): number {
166
+ if (connectionSetupTimeMs === undefined) {
167
+ return maxStartBitrateKbps;
168
+ }
169
+ const ramp = Math.min(
170
+ Math.max(
171
+ (connectionSetupTimeMs - setupTimeForMaxStartBitrateMs) /
172
+ (setupTimeForMinStartBitrateMs - setupTimeForMaxStartBitrateMs),
173
+ 0,
174
+ ),
175
+ 1,
176
+ );
177
+ return Math.round(maxStartBitrateKbps - ramp * (maxStartBitrateKbps - minTargetBitrateKbps));
85
178
  }
86
179
 
87
180
  /**
@@ -114,6 +207,7 @@ export function computeTrackStartBitrate(trackbr: TrackBitrateInfo): number | un
114
207
  export function computeConnectionStartBitrate(
115
208
  media: MediaDescription[],
116
209
  trackBitrates: TrackBitrateInfo[],
210
+ connectionSetupTimeMs?: number,
117
211
  ): number | undefined {
118
212
  let connectionStartBitrate: number | undefined;
119
213
  for (const m of media) {
@@ -128,7 +222,8 @@ export function computeConnectionStartBitrate(
128
222
  if (codecPayload === undefined) {
129
223
  continue;
130
224
  }
131
- const startBitrate = codecPayload > 0 ? computeTrackStartBitrate(trackbr) : undefined;
225
+ const startBitrate =
226
+ codecPayload > 0 ? computeTrackStartBitrate(trackbr, connectionSetupTimeMs) : undefined;
132
227
  if (
133
228
  startBitrate !== undefined &&
134
229
  (connectionStartBitrate === undefined || startBitrate > connectionStartBitrate)
@@ -183,7 +278,6 @@ export const PCEvents = {
183
278
  RTPVideoPayloadTypes: 'rtpVideoPayloadTypes',
184
279
  } as const;
185
280
 
186
- /** @internal */
187
281
  export default class PCTransport extends (EventEmitter as new () => TypedEmitter<PCTransportEventCallbacks>) {
188
282
  private _pc: RTCPeerConnection | null;
189
283
 
@@ -234,6 +328,20 @@ export default class PCTransport extends (EventEmitter as new () => TypedEmitter
234
328
  */
235
329
  private hasAppliedVideoStartBitrate = false;
236
330
 
331
+ /**
332
+ * How long this peer connection took to set up, in ms, recorded once the initial connect
333
+ * succeeds. Lowers the start bitrate hint for a slow connection; see `computeStartBitrateCap`.
334
+ */
335
+ private connectionSetupTimeMs?: number;
336
+
337
+ /**
338
+ * When the connection attempt that built this peer connection began (`performance.now()`).
339
+ * Until `connectionSetupTimeMs` is known, the time elapsed since then is used as a lower bound
340
+ * on the setup time, so a video published during connect is still seeded from it rather than
341
+ * waiting for the connection, which would delay the offer.
342
+ */
343
+ private connectionStartedAt?: number;
344
+
237
345
  remoteStereoMids: string[] = [];
238
346
 
239
347
  remoteNackMids: string[] = [];
@@ -330,13 +438,13 @@ export default class PCTransport extends (EventEmitter as new () => TypedEmitter
330
438
  this.pendingCandidates.push(candidate);
331
439
  }
332
440
 
441
+ /** Whether an answer for `offerId` answers an offer older than the latest one sent. */
442
+ isStaleAnswer(offerId: number): boolean {
443
+ return this.latestOfferId > 0 && offerId > 0 && offerId !== this.latestOfferId;
444
+ }
445
+
333
446
  async setRemoteDescription(sd: RTCSessionDescriptionInit, offerId: number): Promise<boolean> {
334
- if (
335
- sd.type === 'answer' &&
336
- this.latestOfferId > 0 &&
337
- offerId > 0 &&
338
- offerId !== this.latestOfferId
339
- ) {
447
+ if (sd.type === 'answer' && this.isStaleAnswer(offerId)) {
340
448
  this.log.warn('ignoring answer for old offer', {
341
449
  offerId,
342
450
  latestOfferId: this.latestOfferId,
@@ -584,7 +692,11 @@ export default class PCTransport extends (EventEmitter as new () => TypedEmitter
584
692
  // published (data channel or audio only) find no target and leave the latch unset.
585
693
  const connectionStartBitrate = this.hasAppliedVideoStartBitrate
586
694
  ? undefined
587
- : computeConnectionStartBitrate(sdpParsed.media, this.trackBitrates);
695
+ : computeConnectionStartBitrate(
696
+ sdpParsed.media,
697
+ this.trackBitrates,
698
+ this.connectionSetupTimeEstimateMs(),
699
+ );
588
700
  let appliedVideoStartBitrate = false;
589
701
  sdpParsed.media.forEach((media) => {
590
702
  ensureIPAddrMatchVersion(media);
@@ -641,6 +753,10 @@ export default class PCTransport extends (EventEmitter as new () => TypedEmitter
641
753
  // one-shot hint once the SDP carrying it has been accepted locally.
642
754
  if (appliedVideoStartBitrate && offer.sdp === mungedSdp) {
643
755
  this.hasAppliedVideoStartBitrate = true;
756
+ this.log.info('applied x-google-start-bitrate', {
757
+ startBitrateKbps: connectionStartBitrate,
758
+ connectionSetupTimeMs: this.connectionSetupTimeEstimateMs(),
759
+ });
644
760
  }
645
761
  this.onOffer(offer, this.latestOfferId);
646
762
  } finally {
@@ -695,6 +811,30 @@ export default class PCTransport extends (EventEmitter as new () => TypedEmitter
695
811
  this.trackBitrates.push(info);
696
812
  }
697
813
 
814
+ /**
815
+ * Record how long this peer connection took to set up. Called once, when the initial connect
816
+ * succeeds; resumes and ICE restarts keep the estimator they have and never call this.
817
+ */
818
+ setConnectionSetupTime(ms: number) {
819
+ this.connectionSetupTimeMs = ms;
820
+ }
821
+
822
+ /** Record when the connection attempt that built this peer connection began. */
823
+ setConnectionStartedAt(startedAt: number) {
824
+ this.connectionStartedAt = startedAt;
825
+ }
826
+
827
+ /** The measured setup time, or while still connecting, the time elapsed so far. */
828
+ private connectionSetupTimeEstimateMs(): number | undefined {
829
+ if (this.connectionSetupTimeMs !== undefined) {
830
+ return this.connectionSetupTimeMs;
831
+ }
832
+ if (this.connectionStartedAt === undefined) {
833
+ return undefined;
834
+ }
835
+ return Math.round(performance.now() - this.connectionStartedAt);
836
+ }
837
+
698
838
  setConfiguration(rtcConfig: RTCConfiguration) {
699
839
  if (!this._pc) {
700
840
  throw new UnexpectedConnectionState('PC closed, cannot configure');
@@ -1050,6 +1190,9 @@ export function placeholderMidsFromTransceivers(
1050
1190
  * fresh placeholders use the default — the placeholders still converge on the
1051
1191
  * first value seen, so two placeholders can't disagree either. Only placeholder
1052
1192
  * sections are ever rewritten, and it is codec-agnostic (opus, H.265, ...).
1193
+ * A codec without an `a=fmtp` line has empty parameters. Real sections that
1194
+ * disagree on a payload type are not reconciled: the placeholders follow the
1195
+ * last real section, and the real sections still differ.
1053
1196
  * `isPlaceholder` identifies the sections to conform.
1054
1197
  * @internal
1055
1198
  */
@@ -1062,31 +1205,30 @@ export function conformBundledCodecFmtp(
1062
1205
  // section's value always takes precedence; otherwise the first placeholder
1063
1206
  // value seen is used so divergent placeholders still converge.
1064
1207
  const canonicalByPayload = new Map<number, string>();
1065
- const fromRealSection = new Set<number>();
1066
1208
  for (const m of media) {
1067
1209
  const placeholder = isPlaceholder(m);
1068
- for (const fmtp of m.fmtp ?? []) {
1069
- if (!placeholder) {
1070
- canonicalByPayload.set(fmtp.payload, fmtp.config);
1071
- fromRealSection.add(fmtp.payload);
1072
- } else if (!canonicalByPayload.has(fmtp.payload)) {
1073
- canonicalByPayload.set(fmtp.payload, fmtp.config);
1210
+ for (const { payload } of m.rtp ?? []) {
1211
+ const config = m.fmtp?.find((fmtp) => fmtp.payload === payload)?.config ?? '';
1212
+ if (!placeholder || !canonicalByPayload.has(payload)) {
1213
+ canonicalByPayload.set(payload, config);
1074
1214
  }
1075
1215
  }
1076
1216
  }
1077
- if (canonicalByPayload.size === 0) {
1078
- return;
1079
- }
1080
-
1081
1217
  // Conform placeholder sections to the canonical fmtp for each shared payload.
1082
1218
  for (const m of media) {
1083
1219
  if (!isPlaceholder(m)) {
1084
1220
  continue;
1085
1221
  }
1086
- for (const fmtp of m.fmtp ?? []) {
1087
- const config = canonicalByPayload.get(fmtp.payload);
1088
- if (config !== undefined && fmtp.config !== config) {
1222
+ for (const { payload } of m.rtp ?? []) {
1223
+ // The first loop added every payload type a placeholder lists.
1224
+ const config = canonicalByPayload.get(payload)!;
1225
+ const fmtp = m.fmtp?.find((entry) => entry.payload === payload);
1226
+ if (config === '') {
1227
+ m.fmtp = (m.fmtp ?? []).filter((entry) => entry.payload !== payload);
1228
+ } else if (fmtp) {
1089
1229
  fmtp.config = config;
1230
+ } else {
1231
+ m.fmtp = [...(m.fmtp ?? []), { payload, config }];
1090
1232
  }
1091
1233
  }
1092
1234
  }
@@ -1,7 +1,8 @@
1
1
  import { EventEmitter } from 'events';
2
2
  import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
3
3
  import { PCEvents } from './PCTransport';
4
- import { PCTransportManager } from './PCTransportManager';
4
+ import { PCTransportManager, PCTransportState } from './PCTransportManager';
5
+ import { ConnectionErrorReason } from './errors';
5
6
 
6
7
  /**
7
8
  * Yield to the microtask queue so any then/catch handlers chained to a promise
@@ -79,10 +80,9 @@ describe('PCTransportManager.negotiate', () => {
79
80
  });
80
81
 
81
82
  function makeManager() {
82
- const manager = new PCTransportManager('publisher-only', {});
83
+ const manager = new PCTransportManager('publisher-only', {}, { peerConnectionTimeout: 200 });
83
84
  const fake = new FakePublisher();
84
85
  (manager as unknown as { publisher: FakePublisher }).publisher = fake;
85
- manager.peerConnectionTimeout = 200;
86
86
  return { manager, pub: fake };
87
87
  }
88
88
 
@@ -314,3 +314,65 @@ describe('PCTransportManager.triggerIceRestart', () => {
314
314
  expect(manager.subscriber?.restartingIce).toBe(false);
315
315
  });
316
316
  });
317
+
318
+ describe('PCTransportManager.ensurePCTransportConnection', () => {
319
+ let originalRTCPeerConnection: unknown;
320
+
321
+ beforeEach(() => {
322
+ originalRTCPeerConnection = (globalThis as unknown as { RTCPeerConnection?: unknown })
323
+ .RTCPeerConnection;
324
+ (globalThis as unknown as { RTCPeerConnection: unknown }).RTCPeerConnection = StubPC;
325
+ vi.useFakeTimers();
326
+ });
327
+
328
+ afterEach(() => {
329
+ vi.useRealTimers();
330
+ (globalThis as unknown as { RTCPeerConnection: unknown }).RTCPeerConnection =
331
+ originalRTCPeerConnection;
332
+ });
333
+
334
+ /** A manager whose publisher never connects; counts the poll loop's reads of its state. */
335
+ function makeConnectingManager() {
336
+ const manager = new PCTransportManager('publisher-only', {});
337
+ (manager as unknown as { publisher: unknown }).publisher = {
338
+ getConnectionState: () => 'connecting',
339
+ };
340
+ let stateReads = 0;
341
+ Object.defineProperty(manager, 'state', {
342
+ get: () => {
343
+ stateReads += 1;
344
+ return PCTransportState.CONNECTING;
345
+ },
346
+ });
347
+ return { manager, stateReads: () => stateReads };
348
+ }
349
+
350
+ it('stops polling once the connection timeout fires', async () => {
351
+ const { manager, stateReads } = makeConnectingManager();
352
+ const wait = manager.ensurePCTransportConnection(undefined, 1_000);
353
+ const timedOut = expect(wait).rejects.toMatchObject({
354
+ reason: ConnectionErrorReason.InternalError,
355
+ });
356
+
357
+ await vi.advanceTimersByTimeAsync(1_000);
358
+ await timedOut;
359
+ const readsAtTimeout = stateReads();
360
+ await vi.advanceTimersByTimeAsync(1_000);
361
+
362
+ expect(stateReads()).toBe(readsAtTimeout);
363
+ });
364
+
365
+ it('rejects as cancelled when the abort signal fired before the call', async () => {
366
+ const { manager } = makeConnectingManager();
367
+ const abortController = new AbortController();
368
+ abortController.abort();
369
+
370
+ const wait = manager.ensurePCTransportConnection(abortController, 1_000);
371
+ const cancelled = expect(wait).rejects.toMatchObject({
372
+ reason: ConnectionErrorReason.Cancelled,
373
+ });
374
+ await vi.advanceTimersByTimeAsync(50);
375
+
376
+ await cancelled;
377
+ });
378
+ });
@@ -1,8 +1,8 @@
1
1
  import { Mutex } from '@livekit/mutex';
2
2
  import { SignalTarget } from '@livekit/protocol';
3
- import type { Throws } from '@livekit/throws-transformer/throws';
4
3
  import log, { LoggerNames, getLogger } from '../logger';
5
4
  import TypedPromise from '../utils/TypedPromise';
5
+ import type { Throws } from '../utils/throws';
6
6
  import PCTransport, { PCEvents } from './PCTransport';
7
7
  import { roomConnectOptionDefaults } from './defaults';
8
8
  import { ConnectionError, NegotiationError } from './errors';
@@ -20,12 +20,18 @@ export enum PCTransportState {
20
20
  }
21
21
 
22
22
  type PCMode = 'subscriber-primary' | 'publisher-primary' | 'publisher-only';
23
+
24
+ export type PCTransportManagerOptions = {
25
+ rtcConfig?: RTCConfiguration;
26
+ peerConnectionTimeout?: number;
27
+ };
28
+
23
29
  export class PCTransportManager {
24
30
  public publisher: PCTransport;
25
31
 
26
32
  public subscriber?: PCTransport;
27
33
 
28
- public peerConnectionTimeout: number = roomConnectOptionDefaults.peerConnectionTimeout;
34
+ public readonly peerConnectionTimeout: number;
29
35
 
30
36
  public get needsPublisher() {
31
37
  return this.isPublisherConnectionRequired;
@@ -75,8 +81,16 @@ export class PCTransportManager {
75
81
  return this._mode;
76
82
  }
77
83
 
78
- constructor(mode: PCMode, loggerOptions: LoggerOptions, rtcConfig?: RTCConfiguration) {
84
+ constructor(
85
+ mode: PCMode,
86
+ loggerOptions: LoggerOptions,
87
+ {
88
+ rtcConfig,
89
+ peerConnectionTimeout = roomConnectOptionDefaults.peerConnectionTimeout,
90
+ }: PCTransportManagerOptions = {},
91
+ ) {
79
92
  this.loggerOptions = loggerOptions;
93
+ this.peerConnectionTimeout = peerConnectionTimeout;
80
94
  this.log = getLogger(loggerOptions.loggerName ?? LoggerNames.PCManager, () => this.logContext);
81
95
  this.iceLog = getLogger(LoggerNames.ICE, () => this.logContext);
82
96
 
@@ -315,14 +329,11 @@ export class PCTransportManager {
315
329
  return this.publisher.addTransceiverOfKind(kind, transceiverInit);
316
330
  }
317
331
 
318
- getMidForReceiver(receiver: RTCRtpReceiver): string | null | undefined {
332
+ getTransceiverForReceiver(receiver: RTCRtpReceiver): RTCRtpTransceiver | undefined {
319
333
  const transceivers = this.subscriber
320
334
  ? this.subscriber.getTransceivers()
321
335
  : this.publisher.getTransceivers();
322
- const matchingTransceiver = transceivers.find(
323
- (transceiver) => transceiver.receiver === receiver,
324
- );
325
- return matchingTransceiver?.mid;
336
+ return transceivers.find((transceiver) => transceiver.receiver === receiver);
326
337
  }
327
338
 
328
339
  getMaxPublisherMessageSize() {
@@ -409,18 +420,23 @@ export class PCTransportManager {
409
420
 
410
421
  reject(ConnectionError.cancelled('room connection has been cancelled'));
411
422
  };
412
- if (abortController?.signal.aborted) {
413
- abortHandler();
414
- }
415
- abortController?.signal.addEventListener('abort', abortHandler);
416
423
 
424
+ let timedOut = false;
417
425
  const connectTimeout = CriticalTimers.setTimeout(() => {
426
+ timedOut = true;
418
427
  abortController?.signal.removeEventListener('abort', abortHandler);
419
428
  reject(ConnectionError.internal('could not establish pc connection'));
420
429
  }, timeout);
430
+ if (abortController?.signal.aborted) {
431
+ abortHandler();
432
+ }
433
+ abortController?.signal.addEventListener('abort', abortHandler);
421
434
 
422
435
  while (this.state !== PCTransportState.CONNECTED) {
423
436
  await sleep(50); // FIXME we shouldn't rely on `sleep` in the connection paths, as it invokes `setTimeout` which can be drastically throttled by browser implementations
437
+ if (timedOut) {
438
+ return;
439
+ }
424
440
  if (abortController?.signal.aborted) {
425
441
  reject(ConnectionError.cancelled('room connection has been cancelled'));
426
442
  return;