livekit-client 2.23.0 → 2.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (869) hide show
  1. package/README.md +48 -32
  2. package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs +48 -0
  3. package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs.map +1 -0
  4. package/dist/core/api/SignalClient.mjs +1212 -0
  5. package/dist/core/api/SignalClient.mjs.map +1 -0
  6. package/dist/core/api/SignalClientStateMachine.mjs +115 -0
  7. package/dist/core/api/SignalClientStateMachine.mjs.map +1 -0
  8. package/dist/core/api/WebSocketStream.mjs +146 -0
  9. package/dist/core/api/WebSocketStream.mjs.map +1 -0
  10. package/dist/core/api/utils.mjs +66 -0
  11. package/dist/core/api/utils.mjs.map +1 -0
  12. package/dist/core/connectionHelper/ConnectionCheck.mjs +89 -0
  13. package/dist/core/connectionHelper/ConnectionCheck.mjs.map +1 -0
  14. package/dist/core/connectionHelper/checks/Checker.mjs +146 -0
  15. package/dist/core/connectionHelper/checks/Checker.mjs.map +1 -0
  16. package/dist/core/connectionHelper/checks/cloudRegion.mjs +82 -0
  17. package/dist/core/connectionHelper/checks/cloudRegion.mjs.map +1 -0
  18. package/dist/core/connectionHelper/checks/connectionProtocol.mjs +111 -0
  19. package/dist/core/connectionHelper/checks/connectionProtocol.mjs.map +1 -0
  20. package/dist/core/connectionHelper/checks/publishAudio.mjs +35 -0
  21. package/dist/core/connectionHelper/checks/publishAudio.mjs.map +1 -0
  22. package/dist/core/connectionHelper/checks/publishVideo.mjs +82 -0
  23. package/dist/core/connectionHelper/checks/publishVideo.mjs.map +1 -0
  24. package/dist/core/connectionHelper/checks/reconnect.mjs +37 -0
  25. package/dist/core/connectionHelper/checks/reconnect.mjs.map +1 -0
  26. package/dist/core/connectionHelper/checks/turn.mjs +56 -0
  27. package/dist/core/connectionHelper/checks/turn.mjs.map +1 -0
  28. package/dist/core/connectionHelper/checks/webrtc.mjs +73 -0
  29. package/dist/core/connectionHelper/checks/webrtc.mjs.map +1 -0
  30. package/dist/core/connectionHelper/checks/websocket.mjs +47 -0
  31. package/dist/core/connectionHelper/checks/websocket.mjs.map +1 -0
  32. package/dist/core/core.mjs +1 -0
  33. package/dist/core/core.mjs.map +1 -0
  34. package/dist/core/e2ee/E2eeManager.mjs +603 -0
  35. package/dist/core/e2ee/E2eeManager.mjs.map +1 -0
  36. package/dist/core/e2ee/KeyProvider.mjs +95 -0
  37. package/dist/core/e2ee/KeyProvider.mjs.map +1 -0
  38. package/dist/core/e2ee/constants.mjs +19 -0
  39. package/dist/core/e2ee/constants.mjs.map +1 -0
  40. package/dist/core/e2ee/errors.mjs +15 -0
  41. package/dist/core/e2ee/errors.mjs.map +1 -0
  42. package/dist/core/e2ee/events.mjs +24 -0
  43. package/dist/core/e2ee/events.mjs.map +1 -0
  44. package/dist/core/e2ee/extension.mjs +70 -0
  45. package/dist/core/e2ee/extension.mjs.map +1 -0
  46. package/dist/core/e2ee/utils.mjs +168 -0
  47. package/dist/core/e2ee/utils.mjs.map +1 -0
  48. package/dist/core/frameMetadata/FrameMetadataManager.mjs +205 -0
  49. package/dist/core/frameMetadata/FrameMetadataManager.mjs.map +1 -0
  50. package/dist/core/frameMetadata/extension.mjs +17 -0
  51. package/dist/core/frameMetadata/extension.mjs.map +1 -0
  52. package/dist/core/frameMetadata/utils.mjs +42 -0
  53. package/dist/core/frameMetadata/utils.mjs.map +1 -0
  54. package/dist/core/logger.mjs +111 -0
  55. package/dist/core/logger.mjs.map +1 -0
  56. package/dist/core/package.json.mjs +1 -0
  57. package/dist/core/package.json.mjs.map +1 -0
  58. package/dist/core/room/BackOffStrategy.mjs +60 -0
  59. package/dist/core/room/BackOffStrategy.mjs.map +1 -0
  60. package/dist/core/room/CoreRoom.mjs +2279 -0
  61. package/dist/core/room/CoreRoom.mjs.map +1 -0
  62. package/dist/core/room/DefaultReconnectPolicy.mjs +23 -0
  63. package/dist/core/room/DefaultReconnectPolicy.mjs.map +1 -0
  64. package/dist/core/room/DeviceManager.mjs +92 -0
  65. package/dist/core/room/DeviceManager.mjs.map +1 -0
  66. package/dist/core/room/PCTransport.mjs +1110 -0
  67. package/dist/core/room/PCTransport.mjs.map +1 -0
  68. package/dist/core/room/PCTransportManager.mjs +360 -0
  69. package/dist/core/room/PCTransportManager.mjs.map +1 -0
  70. package/dist/core/room/RTCEngine.mjs +1830 -0
  71. package/dist/core/room/RTCEngine.mjs.map +1 -0
  72. package/dist/core/room/RegionUrlProvider.mjs +194 -0
  73. package/dist/core/room/RegionUrlProvider.mjs.map +1 -0
  74. package/dist/core/room/attribute-typings.mjs +24 -0
  75. package/dist/core/room/attribute-typings.mjs.map +1 -0
  76. package/dist/core/room/createRoom.mjs +19 -0
  77. package/dist/core/room/createRoom.mjs.map +1 -0
  78. package/dist/core/room/data-channel/DataChannelManager.mjs +188 -0
  79. package/dist/core/room/data-channel/DataChannelManager.mjs.map +1 -0
  80. package/dist/core/room/data-channel/FlowControlledDataChannel.mjs +185 -0
  81. package/dist/core/room/data-channel/FlowControlledDataChannel.mjs.map +1 -0
  82. package/dist/core/room/data-channel/LossyDataChannel.mjs +99 -0
  83. package/dist/core/room/data-channel/LossyDataChannel.mjs.map +1 -0
  84. package/dist/core/room/data-channel/ReliableDataChannel.mjs +150 -0
  85. package/dist/core/room/data-channel/ReliableDataChannel.mjs.map +1 -0
  86. package/dist/core/room/data-channel/types.mjs +22 -0
  87. package/dist/core/room/data-channel/types.mjs.map +1 -0
  88. package/dist/core/room/data-stream/compression.mjs +68 -0
  89. package/dist/core/room/data-stream/compression.mjs.map +1 -0
  90. package/dist/core/room/data-stream/constants.mjs +26 -0
  91. package/dist/core/room/data-stream/constants.mjs.map +1 -0
  92. package/dist/core/room/data-stream/extension.mjs +42 -0
  93. package/dist/core/room/data-stream/extension.mjs.map +1 -0
  94. package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs +500 -0
  95. package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs.map +1 -0
  96. package/dist/core/room/data-stream/incoming/StreamReader.mjs +279 -0
  97. package/dist/core/room/data-stream/incoming/StreamReader.mjs.map +1 -0
  98. package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs +543 -0
  99. package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs.map +1 -0
  100. package/dist/core/room/data-stream/outgoing/StreamWriter.mjs +21 -0
  101. package/dist/core/room/data-stream/outgoing/StreamWriter.mjs.map +1 -0
  102. package/dist/core/room/data-stream/outgoing/header-utils.mjs +53 -0
  103. package/dist/core/room/data-stream/outgoing/header-utils.mjs.map +1 -0
  104. package/dist/core/room/data-track/LocalDataTrack.mjs +146 -0
  105. package/dist/core/room/data-track/LocalDataTrack.mjs.map +1 -0
  106. package/dist/core/room/data-track/RemoteDataTrack.mjs +51 -0
  107. package/dist/core/room/data-track/RemoteDataTrack.mjs.map +1 -0
  108. package/dist/core/room/data-track/depacketizer.mjs +193 -0
  109. package/dist/core/room/data-track/depacketizer.mjs.map +1 -0
  110. package/dist/core/room/data-track/extension.mjs +154 -0
  111. package/dist/core/room/data-track/extension.mjs.map +1 -0
  112. package/dist/core/room/data-track/frame.mjs +19 -0
  113. package/dist/core/room/data-track/frame.mjs.map +1 -0
  114. package/dist/core/room/data-track/handle.mjs +50 -0
  115. package/dist/core/room/data-track/handle.mjs.map +1 -0
  116. package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs +618 -0
  117. package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs.map +1 -0
  118. package/dist/core/room/data-track/incoming/errors.mjs +32 -0
  119. package/dist/core/room/data-track/incoming/errors.mjs.map +1 -0
  120. package/dist/core/room/data-track/incoming/pipeline.mjs +85 -0
  121. package/dist/core/room/data-track/incoming/pipeline.mjs.map +1 -0
  122. package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs +351 -0
  123. package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs.map +1 -0
  124. package/dist/core/room/data-track/outgoing/errors.mjs +114 -0
  125. package/dist/core/room/data-track/outgoing/errors.mjs.map +1 -0
  126. package/dist/core/room/data-track/outgoing/pipeline.mjs +41 -0
  127. package/dist/core/room/data-track/outgoing/pipeline.mjs.map +1 -0
  128. package/dist/core/room/data-track/packet/constants.mjs +21 -0
  129. package/dist/core/room/data-track/packet/constants.mjs.map +1 -0
  130. package/dist/core/room/data-track/packet/errors.mjs +56 -0
  131. package/dist/core/room/data-track/packet/errors.mjs.map +1 -0
  132. package/dist/core/room/data-track/packet/extensions.mjs +172 -0
  133. package/dist/core/room/data-track/packet/extensions.mjs.map +1 -0
  134. package/dist/core/room/data-track/packet/index.mjs +242 -0
  135. package/dist/core/room/data-track/packet/index.mjs.map +1 -0
  136. package/dist/core/room/data-track/packet/serializable.mjs +15 -0
  137. package/dist/core/room/data-track/packet/serializable.mjs.map +1 -0
  138. package/dist/core/room/data-track/packetizer.mjs +77 -0
  139. package/dist/core/room/data-track/packetizer.mjs.map +1 -0
  140. package/dist/core/room/data-track/track-interfaces.mjs +2 -0
  141. package/dist/core/room/data-track/track-interfaces.mjs.map +1 -0
  142. package/dist/core/room/data-track/types.mjs +18 -0
  143. package/dist/core/room/data-track/types.mjs.map +1 -0
  144. package/dist/core/room/data-track/utils.mjs +149 -0
  145. package/dist/core/room/data-track/utils.mjs.map +1 -0
  146. package/dist/core/room/debounce.mjs +97 -0
  147. package/dist/core/room/debounce.mjs.map +1 -0
  148. package/dist/core/room/defaults.mjs +34 -0
  149. package/dist/core/room/defaults.mjs.map +1 -0
  150. package/dist/core/room/errors.mjs +208 -0
  151. package/dist/core/room/errors.mjs.map +1 -0
  152. package/dist/core/room/events.mjs +643 -0
  153. package/dist/core/room/events.mjs.map +1 -0
  154. package/dist/core/room/extensions.mjs +48 -0
  155. package/dist/core/room/extensions.mjs.map +1 -0
  156. package/dist/core/room/participant/LocalParticipant.mjs +1324 -0
  157. package/dist/core/room/participant/LocalParticipant.mjs.map +1 -0
  158. package/dist/core/room/participant/Participant.mjs +300 -0
  159. package/dist/core/room/participant/Participant.mjs.map +1 -0
  160. package/dist/core/room/participant/ParticipantTrackPermission.mjs +12 -0
  161. package/dist/core/room/participant/ParticipantTrackPermission.mjs.map +1 -0
  162. package/dist/core/room/participant/RemoteParticipant.mjs +287 -0
  163. package/dist/core/room/participant/RemoteParticipant.mjs.map +1 -0
  164. package/dist/core/room/participant/publishUtils.mjs +356 -0
  165. package/dist/core/room/participant/publishUtils.mjs.map +1 -0
  166. package/dist/core/room/rpc/client/RpcClientManager.mjs +216 -0
  167. package/dist/core/room/rpc/client/RpcClientManager.mjs.map +1 -0
  168. package/dist/core/room/rpc/extension.mjs +82 -0
  169. package/dist/core/room/rpc/extension.mjs.map +1 -0
  170. package/dist/core/room/rpc/server/RpcServerManager.mjs +186 -0
  171. package/dist/core/room/rpc/server/RpcServerManager.mjs.map +1 -0
  172. package/dist/core/room/rpc/utils.mjs +148 -0
  173. package/dist/core/room/rpc/utils.mjs.map +1 -0
  174. package/dist/core/room/simulated-participants/extension.mjs +105 -0
  175. package/dist/core/room/simulated-participants/extension.mjs.map +1 -0
  176. package/dist/core/room/stats.mjs +19 -0
  177. package/dist/core/room/stats.mjs.map +1 -0
  178. package/dist/core/room/statsSummary.mjs +165 -0
  179. package/dist/core/room/statsSummary.mjs.map +1 -0
  180. package/dist/core/room/timers.mjs +20 -0
  181. package/dist/core/room/timers.mjs.map +1 -0
  182. package/dist/core/room/token-source/TokenSource.mjs +230 -0
  183. package/dist/core/room/token-source/TokenSource.mjs.map +1 -0
  184. package/dist/core/room/token-source/types.mjs +18 -0
  185. package/dist/core/room/token-source/types.mjs.map +1 -0
  186. package/dist/core/room/token-source/utils.mjs +76 -0
  187. package/dist/core/room/token-source/utils.mjs.map +1 -0
  188. package/dist/core/room/track/FrameMetadataExtractor.mjs +36 -0
  189. package/dist/core/room/track/FrameMetadataExtractor.mjs.map +1 -0
  190. package/dist/core/room/track/LocalAudioTrack.mjs +327 -0
  191. package/dist/core/room/track/LocalAudioTrack.mjs.map +1 -0
  192. package/dist/core/room/track/LocalTrack.mjs +694 -0
  193. package/dist/core/room/track/LocalTrack.mjs.map +1 -0
  194. package/dist/core/room/track/LocalTrackPublication.mjs +111 -0
  195. package/dist/core/room/track/LocalTrackPublication.mjs.map +1 -0
  196. package/dist/core/room/track/LocalVideoTrack.mjs +810 -0
  197. package/dist/core/room/track/LocalVideoTrack.mjs.map +1 -0
  198. package/dist/core/room/track/RemoteAudioTrack.mjs +245 -0
  199. package/dist/core/room/track/RemoteAudioTrack.mjs.map +1 -0
  200. package/dist/core/room/track/RemoteTrack.mjs +143 -0
  201. package/dist/core/room/track/RemoteTrack.mjs.map +1 -0
  202. package/dist/core/room/track/RemoteTrackPublication.mjs +284 -0
  203. package/dist/core/room/track/RemoteTrackPublication.mjs.map +1 -0
  204. package/dist/core/room/track/RemoteVideoTrack.mjs +384 -0
  205. package/dist/core/room/track/RemoteVideoTrack.mjs.map +1 -0
  206. package/dist/core/room/track/Track.mjs +413 -0
  207. package/dist/core/room/track/Track.mjs.map +1 -0
  208. package/dist/core/room/track/TrackPublication.mjs +97 -0
  209. package/dist/core/room/track/TrackPublication.mjs.map +1 -0
  210. package/dist/core/room/track/create.mjs +142 -0
  211. package/dist/core/room/track/create.mjs.map +1 -0
  212. package/dist/core/room/track/facingMode.mjs +81 -0
  213. package/dist/core/room/track/facingMode.mjs.map +1 -0
  214. package/dist/core/room/track/options.mjs +109 -0
  215. package/dist/core/room/track/options.mjs.map +1 -0
  216. package/dist/core/room/track/record.mjs +67 -0
  217. package/dist/core/room/track/record.mjs.map +1 -0
  218. package/dist/core/room/track/utils.mjs +429 -0
  219. package/dist/core/room/track/utils.mjs.map +1 -0
  220. package/dist/core/room/utils.mjs +852 -0
  221. package/dist/core/room/utils.mjs.map +1 -0
  222. package/dist/core/room/video/create.mjs +71 -0
  223. package/dist/core/room/video/create.mjs.map +1 -0
  224. package/dist/core/room/video/extension.mjs +27 -0
  225. package/dist/core/room/video/extension.mjs.map +1 -0
  226. package/dist/core/room/video/publisher.mjs +343 -0
  227. package/dist/core/room/video/publisher.mjs.map +1 -0
  228. package/dist/core/ts4.2/api/SignalClient.d.ts +19 -0
  229. package/dist/core/ts4.2/api/SignalClientStateMachine.d.ts +84 -0
  230. package/dist/core/ts4.2/api/WebSocketStream.d.ts +33 -0
  231. package/dist/core/ts4.2/api/utils.d.ts +8 -0
  232. package/dist/core/ts4.2/connectionHelper/ConnectionCheck.d.ts +29 -0
  233. package/dist/core/ts4.2/connectionHelper/checks/Checker.d.ts +64 -0
  234. package/dist/core/ts4.2/connectionHelper/checks/cloudRegion.d.ts +17 -0
  235. package/dist/core/ts4.2/connectionHelper/checks/connectionProtocol.d.ts +19 -0
  236. package/dist/core/ts4.2/connectionHelper/checks/publishAudio.d.ts +5 -0
  237. package/dist/core/ts4.2/connectionHelper/checks/publishVideo.d.ts +6 -0
  238. package/dist/core/ts4.2/connectionHelper/checks/reconnect.d.ts +5 -0
  239. package/dist/core/ts4.2/connectionHelper/checks/turn.d.ts +5 -0
  240. package/dist/core/ts4.2/connectionHelper/checks/webrtc.d.ts +5 -0
  241. package/dist/core/ts4.2/connectionHelper/checks/websocket.d.ts +5 -0
  242. package/dist/core/ts4.2/core.d.ts +33 -0
  243. package/dist/core/ts4.2/e2ee/E2eeManager.d.ts +89 -0
  244. package/dist/core/ts4.2/e2ee/KeyProvider.d.ts +53 -0
  245. package/dist/core/ts4.2/e2ee/constants.d.ts +20 -0
  246. package/dist/core/ts4.2/e2ee/errors.d.ts +11 -0
  247. package/dist/core/ts4.2/e2ee/events.d.ts +38 -0
  248. package/dist/core/ts4.2/e2ee/extension.d.ts +19 -0
  249. package/dist/core/ts4.2/e2ee/index.d.ts +5 -0
  250. package/dist/core/ts4.2/e2ee/types.d.ts +244 -0
  251. package/dist/core/ts4.2/e2ee/utils.d.ts +36 -0
  252. package/dist/core/ts4.2/exports.d.ts +82 -0
  253. package/dist/core/ts4.2/frameMetadata/FrameMetadataManager.d.ts +52 -0
  254. package/dist/core/ts4.2/frameMetadata/extension.d.ts +12 -0
  255. package/dist/core/ts4.2/frameMetadata/frameMetadata.d.ts +32 -0
  256. package/dist/core/ts4.2/frameMetadata/types.d.ts +61 -0
  257. package/dist/core/ts4.2/frameMetadata/utils.d.ts +13 -0
  258. package/dist/core/ts4.2/logger.d.ts +59 -0
  259. package/dist/core/ts4.2/options.d.ts +171 -0
  260. package/dist/core/ts4.2/room/BackOffStrategy.d.ts +26 -0
  261. package/dist/core/ts4.2/room/CoreRoom.d.ts +363 -0
  262. package/dist/core/ts4.2/room/DefaultReconnectPolicy.d.ts +7 -0
  263. package/dist/core/ts4.2/room/DeviceManager.d.ts +11 -0
  264. package/dist/core/ts4.2/room/PCTransport.d.ts +132 -0
  265. package/dist/core/ts4.2/room/PCTransportManager.d.ts +80 -0
  266. package/dist/core/ts4.2/room/RTCEngine.d.ts +233 -0
  267. package/dist/core/ts4.2/room/ReconnectPolicy.d.ts +23 -0
  268. package/dist/core/ts4.2/room/RegionUrlProvider.d.ts +33 -0
  269. package/dist/core/ts4.2/room/attribute-typings.d.ts +34 -0
  270. package/dist/core/ts4.2/room/chat/extension.d.ts +21 -0
  271. package/dist/core/ts4.2/room/createRoom.d.ts +19 -0
  272. package/dist/core/ts4.2/room/data-channel/DataChannelManager.d.ts +67 -0
  273. package/dist/core/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +106 -0
  274. package/dist/core/ts4.2/room/data-channel/LossyDataChannel.d.ts +40 -0
  275. package/dist/core/ts4.2/room/data-channel/ReliableDataChannel.d.ts +56 -0
  276. package/dist/core/ts4.2/room/data-channel/types.d.ts +11 -0
  277. package/dist/core/ts4.2/room/data-stream/compression.d.ts +29 -0
  278. package/dist/core/ts4.2/room/data-stream/constants.d.ts +1 -0
  279. package/dist/core/ts4.2/room/data-stream/extension.d.ts +63 -0
  280. package/dist/core/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +33 -0
  281. package/dist/core/ts4.2/room/data-stream/incoming/StreamReader.d.ts +77 -0
  282. package/dist/core/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
  283. package/dist/core/ts4.2/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
  284. package/dist/core/ts4.2/room/data-stream/outgoing/header-utils.d.ts +17 -0
  285. package/dist/core/ts4.2/room/data-track/LocalDataTrack.d.ts +69 -0
  286. package/dist/core/ts4.2/room/data-track/RemoteDataTrack.d.ts +43 -0
  287. package/dist/core/ts4.2/room/data-track/depacketizer.d.ts +58 -0
  288. package/dist/core/ts4.2/room/data-track/extension.d.ts +30 -0
  289. package/dist/core/ts4.2/room/data-track/frame.d.ts +21 -0
  290. package/dist/core/ts4.2/room/data-track/handle.d.ts +26 -0
  291. package/dist/core/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
  292. package/dist/core/ts4.2/room/data-track/incoming/errors.d.ts +23 -0
  293. package/dist/core/ts4.2/room/data-track/incoming/pipeline.d.ts +40 -0
  294. package/dist/core/ts4.2/room/data-track/incoming/types.d.ts +19 -0
  295. package/dist/core/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
  296. package/dist/core/ts4.2/room/data-track/outgoing/errors.d.ts +73 -0
  297. package/dist/core/ts4.2/room/data-track/outgoing/pipeline.d.ts +22 -0
  298. package/dist/core/ts4.2/room/data-track/outgoing/types.d.ts +47 -0
  299. package/dist/core/ts4.2/room/data-track/packet/constants.d.ts +19 -0
  300. package/dist/core/ts4.2/room/data-track/packet/errors.d.ts +39 -0
  301. package/dist/core/ts4.2/room/data-track/packet/extensions.d.ts +68 -0
  302. package/dist/core/ts4.2/room/data-track/packet/index.d.ts +97 -0
  303. package/dist/core/ts4.2/room/data-track/packet/serializable.d.ts +12 -0
  304. package/dist/core/ts4.2/room/data-track/packetizer.d.ts +40 -0
  305. package/dist/core/ts4.2/room/data-track/track-interfaces.d.ts +22 -0
  306. package/dist/core/ts4.2/room/data-track/types.d.ts +21 -0
  307. package/dist/core/ts4.2/room/data-track/utils.d.ts +59 -0
  308. package/dist/core/ts4.2/room/debounce.d.ts +10 -0
  309. package/dist/core/ts4.2/room/defaults.d.ts +7 -0
  310. package/dist/core/ts4.2/room/errors.d.ts +179 -0
  311. package/dist/core/ts4.2/room/events.d.ts +534 -0
  312. package/dist/core/ts4.2/room/extensions.d.ts +206 -0
  313. package/dist/core/ts4.2/room/participant/LocalParticipant.d.ts +164 -0
  314. package/dist/core/ts4.2/room/participant/Participant.d.ts +122 -0
  315. package/dist/core/ts4.2/room/participant/ParticipantTrackPermission.d.ts +25 -0
  316. package/dist/core/ts4.2/room/participant/RemoteParticipant.d.ts +37 -0
  317. package/dist/core/ts4.2/room/participant/publishUtils.d.ts +11 -0
  318. package/dist/core/ts4.2/room/rpc/client/RpcClientManager.d.ts +1 -0
  319. package/dist/core/ts4.2/room/rpc/client/events.d.ts +7 -0
  320. package/dist/core/ts4.2/room/rpc/extension.d.ts +73 -0
  321. package/dist/core/ts4.2/room/rpc/index.d.ts +6 -0
  322. package/dist/core/ts4.2/room/rpc/server/RpcServerManager.d.ts +1 -0
  323. package/dist/core/ts4.2/room/rpc/server/events.d.ts +7 -0
  324. package/dist/core/ts4.2/room/rpc/utils.d.ts +76 -0
  325. package/dist/core/ts4.2/room/simulated-participants/extension.d.ts +24 -0
  326. package/dist/core/ts4.2/room/stats.d.ts +70 -0
  327. package/dist/core/ts4.2/room/statsSummary.d.ts +12 -0
  328. package/dist/core/ts4.2/room/timers.d.ts +11 -0
  329. package/dist/core/ts4.2/room/token-source/TokenSource.d.ts +85 -0
  330. package/dist/core/ts4.2/room/token-source/types.d.ts +69 -0
  331. package/dist/core/ts4.2/room/token-source/utils.d.ts +7 -0
  332. package/dist/core/ts4.2/room/track/FrameMetadataExtractor.d.ts +18 -0
  333. package/dist/core/ts4.2/room/track/LocalAudioTrack.d.ts +50 -0
  334. package/dist/core/ts4.2/room/track/LocalTrack.d.ts +118 -0
  335. package/dist/core/ts4.2/room/track/LocalTrackPublication.d.ts +41 -0
  336. package/dist/core/ts4.2/room/track/LocalVideoTrack.d.ts +91 -0
  337. package/dist/core/ts4.2/room/track/RemoteAudioTrack.d.ts +49 -0
  338. package/dist/core/ts4.2/room/track/RemoteTrack.d.ts +29 -0
  339. package/dist/core/ts4.2/room/track/RemoteTrackPublication.d.ts +62 -0
  340. package/dist/core/ts4.2/room/track/RemoteVideoTrack.d.ts +53 -0
  341. package/dist/core/ts4.2/room/track/Track.d.ts +129 -0
  342. package/dist/core/ts4.2/room/track/TrackPublication.d.ts +68 -0
  343. package/dist/core/ts4.2/room/track/create.d.ts +12 -0
  344. package/dist/core/ts4.2/room/track/facingMode.d.ts +40 -0
  345. package/dist/core/ts4.2/room/track/options.d.ts +396 -0
  346. package/dist/core/ts4.2/room/track/processor/types.d.ts +41 -0
  347. package/dist/core/ts4.2/room/track/record.d.ts +12 -0
  348. package/dist/core/ts4.2/room/track/types.d.ts +27 -0
  349. package/dist/core/ts4.2/room/track/utils.d.ts +20 -0
  350. package/dist/core/ts4.2/room/types.d.ts +126 -0
  351. package/dist/core/ts4.2/room/utils.d.ts +246 -0
  352. package/dist/core/ts4.2/room/video/create.d.ts +27 -0
  353. package/dist/core/ts4.2/room/video/extension.d.ts +43 -0
  354. package/dist/core/ts4.2/room/video/publisher.d.ts +23 -0
  355. package/dist/core/ts4.2/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
  356. package/dist/core/ts4.2/utils/AsyncQueue.d.ts +22 -0
  357. package/dist/core/ts4.2/utils/TypedPromise.d.ts +16 -0
  358. package/dist/core/ts4.2/utils/abort-signal-polyfill.d.ts +12 -0
  359. package/dist/core/ts4.2/utils/browserParser.d.ts +9 -0
  360. package/dist/core/ts4.2/utils/camelToSnakeCase.d.ts +7 -0
  361. package/dist/core/ts4.2/utils/cloneDeep.d.ts +1 -0
  362. package/dist/core/ts4.2/utils/dataPacketBuffer.d.ts +33 -0
  363. package/dist/core/ts4.2/utils/deferrable-map.d.ts +31 -0
  364. package/dist/core/ts4.2/utils/machineInspector.d.ts +53 -0
  365. package/dist/core/ts4.2/utils/serializer.d.ts +47 -0
  366. package/dist/core/ts4.2/utils/throws.d.ts +9 -0
  367. package/dist/core/ts4.2/utils/ttlmap.d.ts +19 -0
  368. package/dist/core/ts4.2/version.d.ts +17 -0
  369. package/dist/core/types/src/api/SignalClient.d.ts +19 -0
  370. package/dist/core/types/src/api/SignalClientStateMachine.d.ts +84 -0
  371. package/dist/core/types/src/api/WebSocketStream.d.ts +33 -0
  372. package/dist/core/types/src/api/utils.d.ts +8 -0
  373. package/dist/core/types/src/connectionHelper/ConnectionCheck.d.ts +28 -0
  374. package/dist/core/types/src/connectionHelper/checks/Checker.d.ts +64 -0
  375. package/dist/core/types/src/connectionHelper/checks/cloudRegion.d.ts +16 -0
  376. package/dist/core/types/src/connectionHelper/checks/connectionProtocol.d.ts +18 -0
  377. package/dist/core/types/src/connectionHelper/checks/publishAudio.d.ts +5 -0
  378. package/dist/core/types/src/connectionHelper/checks/publishVideo.d.ts +6 -0
  379. package/dist/core/types/src/connectionHelper/checks/reconnect.d.ts +5 -0
  380. package/dist/core/types/src/connectionHelper/checks/turn.d.ts +5 -0
  381. package/dist/core/types/src/connectionHelper/checks/webrtc.d.ts +5 -0
  382. package/dist/core/types/src/connectionHelper/checks/websocket.d.ts +5 -0
  383. package/dist/core/types/src/core.d.ts +32 -0
  384. package/dist/core/types/src/e2ee/E2eeManager.d.ts +89 -0
  385. package/dist/core/types/src/e2ee/KeyProvider.d.ts +53 -0
  386. package/dist/core/types/src/e2ee/constants.d.ts +20 -0
  387. package/dist/core/types/src/e2ee/errors.d.ts +11 -0
  388. package/dist/core/types/src/e2ee/events.d.ts +38 -0
  389. package/dist/core/types/src/e2ee/extension.d.ts +18 -0
  390. package/dist/core/types/src/e2ee/index.d.ts +5 -0
  391. package/dist/core/types/src/e2ee/types.d.ts +244 -0
  392. package/dist/core/types/src/e2ee/utils.d.ts +35 -0
  393. package/dist/core/types/src/exports.d.ts +75 -0
  394. package/dist/core/types/src/frameMetadata/FrameMetadataManager.d.ts +52 -0
  395. package/dist/core/types/src/frameMetadata/extension.d.ts +10 -0
  396. package/dist/core/types/src/frameMetadata/frameMetadata.d.ts +32 -0
  397. package/dist/core/types/src/frameMetadata/types.d.ts +61 -0
  398. package/dist/core/types/src/frameMetadata/utils.d.ts +13 -0
  399. package/dist/core/types/src/logger.d.ts +59 -0
  400. package/dist/core/types/src/options.d.ts +171 -0
  401. package/dist/core/types/src/room/BackOffStrategy.d.ts +26 -0
  402. package/dist/core/types/src/room/CoreRoom.d.ts +374 -0
  403. package/dist/core/types/src/room/DefaultReconnectPolicy.d.ts +7 -0
  404. package/dist/core/types/src/room/DeviceManager.d.ts +11 -0
  405. package/dist/core/types/src/room/PCTransport.d.ts +132 -0
  406. package/dist/core/types/src/room/PCTransportManager.d.ts +80 -0
  407. package/dist/core/types/src/room/RTCEngine.d.ts +232 -0
  408. package/dist/core/types/src/room/ReconnectPolicy.d.ts +23 -0
  409. package/dist/core/types/src/room/RegionUrlProvider.d.ts +33 -0
  410. package/dist/core/types/src/room/attribute-typings.d.ts +34 -0
  411. package/dist/core/types/src/room/chat/extension.d.ts +21 -0
  412. package/dist/core/types/src/room/createRoom.d.ts +18 -0
  413. package/dist/core/types/src/room/data-channel/DataChannelManager.d.ts +68 -0
  414. package/dist/core/types/src/room/data-channel/FlowControlledDataChannel.d.ts +107 -0
  415. package/dist/core/types/src/room/data-channel/LossyDataChannel.d.ts +39 -0
  416. package/dist/core/types/src/room/data-channel/ReliableDataChannel.d.ts +55 -0
  417. package/dist/core/types/src/room/data-channel/types.d.ts +11 -0
  418. package/dist/core/types/src/room/data-stream/compression.d.ts +29 -0
  419. package/dist/core/types/src/room/data-stream/constants.d.ts +1 -0
  420. package/dist/core/types/src/room/data-stream/extension.d.ts +62 -0
  421. package/dist/core/types/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +32 -0
  422. package/dist/core/types/src/room/data-stream/incoming/StreamReader.d.ts +77 -0
  423. package/dist/core/types/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
  424. package/dist/core/types/src/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
  425. package/dist/core/types/src/room/data-stream/outgoing/header-utils.d.ts +17 -0
  426. package/dist/core/types/src/room/data-track/LocalDataTrack.d.ts +70 -0
  427. package/dist/core/types/src/room/data-track/RemoteDataTrack.d.ts +43 -0
  428. package/dist/core/types/src/room/data-track/depacketizer.d.ts +58 -0
  429. package/dist/core/types/src/room/data-track/extension.d.ts +30 -0
  430. package/dist/core/types/src/room/data-track/frame.d.ts +21 -0
  431. package/dist/core/types/src/room/data-track/handle.d.ts +26 -0
  432. package/dist/core/types/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
  433. package/dist/core/types/src/room/data-track/incoming/errors.d.ts +23 -0
  434. package/dist/core/types/src/room/data-track/incoming/pipeline.d.ts +40 -0
  435. package/dist/core/types/src/room/data-track/incoming/types.d.ts +19 -0
  436. package/dist/core/types/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
  437. package/dist/core/types/src/room/data-track/outgoing/errors.d.ts +73 -0
  438. package/dist/core/types/src/room/data-track/outgoing/pipeline.d.ts +22 -0
  439. package/dist/core/types/src/room/data-track/outgoing/types.d.ts +47 -0
  440. package/dist/core/types/src/room/data-track/packet/constants.d.ts +19 -0
  441. package/dist/core/types/src/room/data-track/packet/errors.d.ts +39 -0
  442. package/dist/core/types/src/room/data-track/packet/extensions.d.ts +68 -0
  443. package/dist/core/types/src/room/data-track/packet/index.d.ts +91 -0
  444. package/dist/core/types/src/room/data-track/packet/serializable.d.ts +12 -0
  445. package/dist/core/types/src/room/data-track/packetizer.d.ts +40 -0
  446. package/dist/core/types/src/room/data-track/track-interfaces.d.ts +22 -0
  447. package/dist/core/types/src/room/data-track/types.d.ts +21 -0
  448. package/dist/core/types/src/room/data-track/utils.d.ts +59 -0
  449. package/dist/core/types/src/room/debounce.d.ts +10 -0
  450. package/dist/core/types/src/room/defaults.d.ts +7 -0
  451. package/dist/core/types/src/room/errors.d.ts +179 -0
  452. package/dist/core/types/src/room/events.d.ts +534 -0
  453. package/dist/core/types/src/room/extensions.d.ts +205 -0
  454. package/dist/core/types/src/room/participant/LocalParticipant.d.ts +164 -0
  455. package/dist/core/types/src/room/participant/Participant.d.ts +123 -0
  456. package/dist/core/types/src/room/participant/ParticipantTrackPermission.d.ts +25 -0
  457. package/dist/core/types/src/room/participant/RemoteParticipant.d.ts +37 -0
  458. package/dist/core/types/src/room/participant/publishUtils.d.ts +11 -0
  459. package/dist/core/types/src/room/rpc/client/RpcClientManager.d.ts +1 -0
  460. package/dist/core/types/src/room/rpc/client/events.d.ts +7 -0
  461. package/dist/core/types/src/room/rpc/extension.d.ts +69 -0
  462. package/dist/core/types/src/room/rpc/index.d.ts +5 -0
  463. package/dist/core/types/src/room/rpc/server/RpcServerManager.d.ts +1 -0
  464. package/dist/core/types/src/room/rpc/server/events.d.ts +7 -0
  465. package/dist/core/types/src/room/rpc/utils.d.ts +76 -0
  466. package/dist/core/types/src/room/simulated-participants/extension.d.ts +24 -0
  467. package/dist/core/types/src/room/stats.d.ts +70 -0
  468. package/dist/core/types/src/room/statsSummary.d.ts +12 -0
  469. package/dist/core/types/src/room/timers.d.ts +11 -0
  470. package/dist/core/types/src/room/token-source/TokenSource.d.ts +91 -0
  471. package/dist/core/types/src/room/token-source/types.d.ts +69 -0
  472. package/dist/core/types/src/room/token-source/utils.d.ts +7 -0
  473. package/dist/core/types/src/room/track/FrameMetadataExtractor.d.ts +18 -0
  474. package/dist/core/types/src/room/track/LocalAudioTrack.d.ts +53 -0
  475. package/dist/core/types/src/room/track/LocalTrack.d.ts +118 -0
  476. package/dist/core/types/src/room/track/LocalTrackPublication.d.ts +41 -0
  477. package/dist/core/types/src/room/track/LocalVideoTrack.d.ts +91 -0
  478. package/dist/core/types/src/room/track/RemoteAudioTrack.d.ts +49 -0
  479. package/dist/core/types/src/room/track/RemoteTrack.d.ts +29 -0
  480. package/dist/core/types/src/room/track/RemoteTrackPublication.d.ts +76 -0
  481. package/dist/core/types/src/room/track/RemoteVideoTrack.d.ts +56 -0
  482. package/dist/core/types/src/room/track/Track.d.ts +134 -0
  483. package/dist/core/types/src/room/track/TrackPublication.d.ts +74 -0
  484. package/dist/core/types/src/room/track/create.d.ts +12 -0
  485. package/dist/core/types/src/room/track/facingMode.d.ts +40 -0
  486. package/dist/core/types/src/room/track/options.d.ts +384 -0
  487. package/dist/core/types/src/room/track/processor/types.d.ts +41 -0
  488. package/dist/core/types/src/room/track/record.d.ts +12 -0
  489. package/dist/core/types/src/room/track/types.d.ts +27 -0
  490. package/dist/core/types/src/room/track/utils.d.ts +20 -0
  491. package/dist/core/types/src/room/types.d.ts +126 -0
  492. package/dist/core/types/src/room/utils.d.ts +246 -0
  493. package/dist/core/types/src/room/video/create.d.ts +27 -0
  494. package/dist/core/types/src/room/video/extension.d.ts +43 -0
  495. package/dist/core/types/src/room/video/publisher.d.ts +23 -0
  496. package/dist/core/types/src/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
  497. package/dist/core/types/src/utils/AsyncQueue.d.ts +22 -0
  498. package/dist/core/types/src/utils/TypedPromise.d.ts +15 -0
  499. package/dist/core/types/src/utils/abort-signal-polyfill.d.ts +12 -0
  500. package/dist/core/types/src/utils/browserParser.d.ts +9 -0
  501. package/dist/core/types/src/utils/camelToSnakeCase.d.ts +7 -0
  502. package/dist/core/types/src/utils/cloneDeep.d.ts +1 -0
  503. package/dist/core/types/src/utils/dataPacketBuffer.d.ts +33 -0
  504. package/dist/core/types/src/utils/deferrable-map.d.ts +31 -0
  505. package/dist/core/types/src/utils/machineInspector.d.ts +53 -0
  506. package/dist/core/types/src/utils/serializer.d.ts +47 -0
  507. package/dist/core/types/src/utils/throws.d.ts +9 -0
  508. package/dist/core/types/src/utils/ttlmap.d.ts +19 -0
  509. package/dist/core/types/src/version.d.ts +17 -0
  510. package/dist/core/utils/AsyncQueue.mjs +41 -0
  511. package/dist/core/utils/AsyncQueue.mjs.map +1 -0
  512. package/dist/core/utils/TypedPromise.mjs +23 -0
  513. package/dist/core/utils/TypedPromise.mjs.map +1 -0
  514. package/dist/core/utils/abort-signal-polyfill.mjs +53 -0
  515. package/dist/core/utils/abort-signal-polyfill.mjs.map +1 -0
  516. package/dist/core/utils/browserParser.mjs +62 -0
  517. package/dist/core/utils/browserParser.mjs.map +1 -0
  518. package/dist/core/utils/cloneDeep.mjs +14 -0
  519. package/dist/core/utils/cloneDeep.mjs.map +1 -0
  520. package/dist/core/utils/dataPacketBuffer.mjs +76 -0
  521. package/dist/core/utils/dataPacketBuffer.mjs.map +1 -0
  522. package/dist/core/utils/deferrable-map.mjs +94 -0
  523. package/dist/core/utils/deferrable-map.mjs.map +1 -0
  524. package/dist/core/utils/machineInspector.mjs +19 -0
  525. package/dist/core/utils/machineInspector.mjs.map +1 -0
  526. package/dist/core/utils/serializer.mjs +47 -0
  527. package/dist/core/utils/serializer.mjs.map +1 -0
  528. package/dist/core/utils/ttlmap.mjs +97 -0
  529. package/dist/core/utils/ttlmap.mjs.map +1 -0
  530. package/dist/core/version.mjs +17 -0
  531. package/dist/core/version.mjs.map +1 -0
  532. package/dist/livekit-client.e2ee.worker.js +1 -1
  533. package/dist/livekit-client.e2ee.worker.js.map +1 -1
  534. package/dist/livekit-client.e2ee.worker.mjs +157 -131
  535. package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
  536. package/dist/livekit-client.esm.mjs +31497 -30818
  537. package/dist/livekit-client.esm.mjs.map +1 -1
  538. package/dist/livekit-client.fm.worker.js +1 -1
  539. package/dist/livekit-client.fm.worker.js.map +1 -1
  540. package/dist/livekit-client.fm.worker.mjs +21 -82
  541. package/dist/livekit-client.fm.worker.mjs.map +1 -1
  542. package/dist/livekit-client.umd.js +1 -1
  543. package/dist/livekit-client.umd.js.map +1 -1
  544. package/dist/src/api/SignalClient.d.ts +1 -1
  545. package/dist/src/api/SignalClient.d.ts.map +1 -1
  546. package/dist/src/api/WebSocketStream.d.ts.map +1 -1
  547. package/dist/src/connectionHelper/checks/Checker.d.ts +7 -4
  548. package/dist/src/connectionHelper/checks/Checker.d.ts.map +1 -1
  549. package/dist/src/core.d.ts +33 -0
  550. package/dist/src/core.d.ts.map +1 -0
  551. package/dist/src/e2ee/E2eeManager.d.ts +25 -5
  552. package/dist/src/e2ee/E2eeManager.d.ts.map +1 -1
  553. package/dist/src/e2ee/KeyProvider.d.ts.map +1 -1
  554. package/dist/src/e2ee/extension.d.ts +19 -0
  555. package/dist/src/e2ee/extension.d.ts.map +1 -0
  556. package/dist/src/e2ee/types.d.ts +14 -0
  557. package/dist/src/e2ee/types.d.ts.map +1 -1
  558. package/dist/src/e2ee/utils.d.ts +6 -1
  559. package/dist/src/e2ee/utils.d.ts.map +1 -1
  560. package/dist/src/e2ee/worker/FrameCryptor.d.ts +7 -1
  561. package/dist/src/e2ee/worker/FrameCryptor.d.ts.map +1 -1
  562. package/dist/src/e2ee/worker/naluUtils.d.ts +7 -0
  563. package/dist/src/e2ee/worker/naluUtils.d.ts.map +1 -1
  564. package/dist/src/e2ee/worker/sifPayload.d.ts +1 -1
  565. package/dist/src/e2ee/worker/sifPayload.d.ts.map +1 -1
  566. package/dist/src/exports.d.ts +76 -0
  567. package/dist/src/exports.d.ts.map +1 -0
  568. package/dist/src/frameMetadata/FrameMetadataManager.d.ts +5 -2
  569. package/dist/src/frameMetadata/FrameMetadataManager.d.ts.map +1 -1
  570. package/dist/src/frameMetadata/extension.d.ts +11 -0
  571. package/dist/src/frameMetadata/extension.d.ts.map +1 -0
  572. package/dist/src/frameMetadata/utils.d.ts +5 -0
  573. package/dist/src/frameMetadata/utils.d.ts.map +1 -1
  574. package/dist/src/index.d.ts +35 -63
  575. package/dist/src/index.d.ts.map +1 -1
  576. package/dist/src/logger.d.ts +1 -3
  577. package/dist/src/logger.d.ts.map +1 -1
  578. package/dist/src/options.d.ts +20 -6
  579. package/dist/src/options.d.ts.map +1 -1
  580. package/dist/src/room/CoreRoom.d.ts +392 -0
  581. package/dist/src/room/CoreRoom.d.ts.map +1 -0
  582. package/dist/src/room/PCTransport.d.ts +5 -2
  583. package/dist/src/room/PCTransport.d.ts.map +1 -1
  584. package/dist/src/room/PCTransportManager.d.ts +8 -4
  585. package/dist/src/room/PCTransportManager.d.ts.map +1 -1
  586. package/dist/src/room/RTCEngine.d.ts +23 -6
  587. package/dist/src/room/RTCEngine.d.ts.map +1 -1
  588. package/dist/src/room/Room.d.ts +5 -403
  589. package/dist/src/room/Room.d.ts.map +1 -1
  590. package/dist/src/room/chat/extension.d.ts +22 -0
  591. package/dist/src/room/chat/extension.d.ts.map +1 -0
  592. package/dist/src/room/createRoom.d.ts +19 -0
  593. package/dist/src/room/createRoom.d.ts.map +1 -0
  594. package/dist/src/room/data-channel/DataChannelManager.d.ts +7 -1
  595. package/dist/src/room/data-channel/DataChannelManager.d.ts.map +1 -1
  596. package/dist/src/room/data-stream/constants.d.ts +9 -0
  597. package/dist/src/room/data-stream/constants.d.ts.map +1 -1
  598. package/dist/src/room/data-stream/extension.d.ts +73 -0
  599. package/dist/src/room/data-stream/extension.d.ts.map +1 -0
  600. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  601. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts.map +1 -1
  602. package/dist/src/room/data-stream/incoming/StreamReader.d.ts.map +1 -1
  603. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  604. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts.map +1 -1
  605. package/dist/src/room/data-track/LocalDataTrack.d.ts +1 -1
  606. package/dist/src/room/data-track/depacketizer.d.ts +1 -1
  607. package/dist/src/room/data-track/depacketizer.d.ts.map +1 -1
  608. package/dist/src/room/data-track/extension.d.ts +31 -0
  609. package/dist/src/room/data-track/extension.d.ts.map +1 -0
  610. package/dist/src/room/data-track/handle.d.ts +1 -1
  611. package/dist/src/room/data-track/handle.d.ts.map +1 -1
  612. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  613. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts.map +1 -1
  614. package/dist/src/room/data-track/incoming/pipeline.d.ts +1 -1
  615. package/dist/src/room/data-track/incoming/pipeline.d.ts.map +1 -1
  616. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  617. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts.map +1 -1
  618. package/dist/src/room/data-track/outgoing/pipeline.d.ts +1 -1
  619. package/dist/src/room/data-track/outgoing/pipeline.d.ts.map +1 -1
  620. package/dist/src/room/data-track/packet/extensions.d.ts +1 -1
  621. package/dist/src/room/data-track/packet/extensions.d.ts.map +1 -1
  622. package/dist/src/room/data-track/packet/index.d.ts +1 -1
  623. package/dist/src/room/data-track/packet/index.d.ts.map +1 -1
  624. package/dist/src/room/data-track/packet/serializable.d.ts +1 -1
  625. package/dist/src/room/data-track/packet/serializable.d.ts.map +1 -1
  626. package/dist/src/room/data-track/packetizer.d.ts +1 -1
  627. package/dist/src/room/data-track/packetizer.d.ts.map +1 -1
  628. package/dist/src/room/data-track/track-interfaces.d.ts +1 -1
  629. package/dist/src/room/data-track/track-interfaces.d.ts.map +1 -1
  630. package/dist/src/room/data-track/utils.d.ts +1 -1
  631. package/dist/src/room/defaults.d.ts +1 -2
  632. package/dist/src/room/defaults.d.ts.map +1 -1
  633. package/dist/src/room/extensions.d.ts +208 -0
  634. package/dist/src/room/extensions.d.ts.map +1 -0
  635. package/dist/src/room/participant/LocalParticipant.d.ts +45 -120
  636. package/dist/src/room/participant/LocalParticipant.d.ts.map +1 -1
  637. package/dist/src/room/participant/Participant.d.ts +8 -1
  638. package/dist/src/room/participant/Participant.d.ts.map +1 -1
  639. package/dist/src/room/participant/RemoteParticipant.d.ts +3 -3
  640. package/dist/src/room/participant/RemoteParticipant.d.ts.map +1 -1
  641. package/dist/src/room/participant/publishUtils.d.ts.map +1 -1
  642. package/dist/src/room/rpc/extension.d.ts +70 -0
  643. package/dist/src/room/rpc/extension.d.ts.map +1 -0
  644. package/dist/src/room/rpc/index.d.ts +1 -1
  645. package/dist/src/room/rpc/index.d.ts.map +1 -1
  646. package/dist/src/room/rpc/legacyExtension.d.ts +34 -0
  647. package/dist/src/room/rpc/legacyExtension.d.ts.map +1 -0
  648. package/dist/src/room/simulated-participants/extension.d.ts +25 -0
  649. package/dist/src/room/simulated-participants/extension.d.ts.map +1 -0
  650. package/dist/src/room/token-source/TokenSource.d.ts +5 -1
  651. package/dist/src/room/token-source/TokenSource.d.ts.map +1 -1
  652. package/dist/src/room/token-source/utils.d.ts.map +1 -1
  653. package/dist/src/room/track/LocalTrack.d.ts +1 -1
  654. package/dist/src/room/track/LocalTrack.d.ts.map +1 -1
  655. package/dist/src/room/track/LocalVideoTrack.d.ts.map +1 -1
  656. package/dist/src/room/track/RemoteTrackPublication.d.ts +14 -1
  657. package/dist/src/room/track/RemoteTrackPublication.d.ts.map +1 -1
  658. package/dist/src/room/track/Track.d.ts.map +1 -1
  659. package/dist/src/room/track/TrackPublication.d.ts +2 -2
  660. package/dist/src/room/track/TrackPublication.d.ts.map +1 -1
  661. package/dist/src/room/track/create.d.ts +15 -13
  662. package/dist/src/room/track/create.d.ts.map +1 -1
  663. package/dist/src/room/track/facingMode.d.ts.map +1 -1
  664. package/dist/src/room/track/options.d.ts +0 -6
  665. package/dist/src/room/track/options.d.ts.map +1 -1
  666. package/dist/src/room/track/processor/types.d.ts +2 -2
  667. package/dist/src/room/track/processor/types.d.ts.map +1 -1
  668. package/dist/src/room/track/utils.d.ts +1 -1
  669. package/dist/src/room/track/utils.d.ts.map +1 -1
  670. package/dist/src/room/utils.d.ts +2 -2
  671. package/dist/src/room/utils.d.ts.map +1 -1
  672. package/dist/src/room/video/create.d.ts +28 -0
  673. package/dist/src/room/video/create.d.ts.map +1 -0
  674. package/dist/src/room/video/extension.d.ts +48 -0
  675. package/dist/src/room/video/extension.d.ts.map +1 -0
  676. package/dist/src/room/video/publisher.d.ts +24 -0
  677. package/dist/src/room/video/publisher.d.ts.map +1 -0
  678. package/dist/src/test/MockMediaStream.d.ts +6 -0
  679. package/dist/src/test/MockMediaStream.d.ts.map +1 -0
  680. package/dist/src/utils/browserParser.d.ts +0 -3
  681. package/dist/src/utils/browserParser.d.ts.map +1 -1
  682. package/dist/src/utils/deferrable-map.d.ts +1 -1
  683. package/dist/src/utils/deferrable-map.d.ts.map +1 -1
  684. package/dist/src/utils/serializer.d.ts.map +1 -1
  685. package/dist/src/utils/throws.d.ts +10 -0
  686. package/dist/src/utils/throws.d.ts.map +1 -0
  687. package/dist/src/version.d.ts +4 -1
  688. package/dist/src/version.d.ts.map +1 -1
  689. package/dist/ts4.2/connectionHelper/checks/Checker.d.ts +7 -4
  690. package/dist/ts4.2/core.d.ts +34 -0
  691. package/dist/ts4.2/e2ee/E2eeManager.d.ts +25 -5
  692. package/dist/ts4.2/e2ee/extension.d.ts +20 -0
  693. package/dist/ts4.2/e2ee/types.d.ts +14 -0
  694. package/dist/ts4.2/e2ee/utils.d.ts +6 -1
  695. package/dist/ts4.2/e2ee/worker/FrameCryptor.d.ts +7 -1
  696. package/dist/ts4.2/e2ee/worker/naluUtils.d.ts +7 -0
  697. package/dist/ts4.2/e2ee/worker/sifPayload.d.ts +1 -1
  698. package/dist/ts4.2/exports.d.ts +83 -0
  699. package/dist/ts4.2/frameMetadata/FrameMetadataManager.d.ts +5 -2
  700. package/dist/ts4.2/frameMetadata/extension.d.ts +13 -0
  701. package/dist/ts4.2/frameMetadata/utils.d.ts +5 -0
  702. package/dist/ts4.2/index.d.ts +35 -69
  703. package/dist/ts4.2/logger.d.ts +1 -3
  704. package/dist/ts4.2/options.d.ts +20 -6
  705. package/dist/ts4.2/room/CoreRoom.d.ts +381 -0
  706. package/dist/ts4.2/room/PCTransport.d.ts +5 -2
  707. package/dist/ts4.2/room/PCTransportManager.d.ts +8 -4
  708. package/dist/ts4.2/room/RTCEngine.d.ts +23 -6
  709. package/dist/ts4.2/room/Room.d.ts +6 -392
  710. package/dist/ts4.2/room/chat/extension.d.ts +22 -0
  711. package/dist/ts4.2/room/createRoom.d.ts +20 -0
  712. package/dist/ts4.2/room/data-channel/DataChannelManager.d.ts +6 -1
  713. package/dist/ts4.2/room/data-stream/constants.d.ts +9 -0
  714. package/dist/ts4.2/room/data-stream/extension.d.ts +74 -0
  715. package/dist/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  716. package/dist/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  717. package/dist/ts4.2/room/data-track/LocalDataTrack.d.ts +1 -1
  718. package/dist/ts4.2/room/data-track/depacketizer.d.ts +1 -1
  719. package/dist/ts4.2/room/data-track/extension.d.ts +31 -0
  720. package/dist/ts4.2/room/data-track/handle.d.ts +1 -1
  721. package/dist/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  722. package/dist/ts4.2/room/data-track/incoming/pipeline.d.ts +1 -1
  723. package/dist/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  724. package/dist/ts4.2/room/data-track/outgoing/pipeline.d.ts +1 -1
  725. package/dist/ts4.2/room/data-track/packet/extensions.d.ts +1 -1
  726. package/dist/ts4.2/room/data-track/packet/index.d.ts +1 -1
  727. package/dist/ts4.2/room/data-track/packet/serializable.d.ts +1 -1
  728. package/dist/ts4.2/room/data-track/packetizer.d.ts +1 -1
  729. package/dist/ts4.2/room/data-track/track-interfaces.d.ts +1 -1
  730. package/dist/ts4.2/room/data-track/utils.d.ts +1 -1
  731. package/dist/ts4.2/room/defaults.d.ts +1 -2
  732. package/dist/ts4.2/room/extensions.d.ts +214 -0
  733. package/dist/ts4.2/room/participant/LocalParticipant.d.ts +44 -121
  734. package/dist/ts4.2/room/participant/Participant.d.ts +8 -1
  735. package/dist/ts4.2/room/participant/RemoteParticipant.d.ts +3 -3
  736. package/dist/ts4.2/room/rpc/extension.d.ts +74 -0
  737. package/dist/ts4.2/room/rpc/index.d.ts +1 -1
  738. package/dist/ts4.2/room/rpc/legacyExtension.d.ts +39 -0
  739. package/dist/ts4.2/room/simulated-participants/extension.d.ts +25 -0
  740. package/dist/ts4.2/room/token-source/TokenSource.d.ts +5 -1
  741. package/dist/ts4.2/room/track/LocalTrack.d.ts +1 -1
  742. package/dist/ts4.2/room/track/RemoteTrackPublication.d.ts +3 -1
  743. package/dist/ts4.2/room/track/TrackPublication.d.ts +2 -2
  744. package/dist/ts4.2/room/track/create.d.ts +15 -13
  745. package/dist/ts4.2/room/track/options.d.ts +0 -6
  746. package/dist/ts4.2/room/track/processor/types.d.ts +2 -2
  747. package/dist/ts4.2/room/track/utils.d.ts +1 -1
  748. package/dist/ts4.2/room/utils.d.ts +2 -2
  749. package/dist/ts4.2/room/video/create.d.ts +28 -0
  750. package/dist/ts4.2/room/video/extension.d.ts +48 -0
  751. package/dist/ts4.2/room/video/publisher.d.ts +24 -0
  752. package/dist/ts4.2/test/MockMediaStream.d.ts +6 -0
  753. package/dist/ts4.2/utils/browserParser.d.ts +0 -3
  754. package/dist/ts4.2/utils/deferrable-map.d.ts +1 -1
  755. package/dist/ts4.2/utils/throws.d.ts +10 -0
  756. package/dist/ts4.2/version.d.ts +4 -1
  757. package/package.json +24 -9
  758. package/src/api/SignalClient.test.ts +107 -0
  759. package/src/api/SignalClient.ts +13 -3
  760. package/src/api/WebSocketStream.test.ts +67 -0
  761. package/src/api/WebSocketStream.ts +41 -3
  762. package/src/connectionHelper/checks/Checker.ts +12 -5
  763. package/src/connectionHelper/checks/publishVideo.ts +1 -1
  764. package/src/connectionHelper/checks/reconnect.ts +1 -1
  765. package/src/core.ts +35 -0
  766. package/src/e2ee/E2eeManager.test.ts +70 -1
  767. package/src/e2ee/E2eeManager.ts +53 -32
  768. package/src/e2ee/KeyProvider.ts +2 -1
  769. package/src/e2ee/extension.ts +113 -0
  770. package/src/e2ee/subscriberBlackScreen.test.ts +9 -12
  771. package/src/e2ee/types.ts +14 -0
  772. package/src/e2ee/utils.test.ts +47 -0
  773. package/src/e2ee/utils.ts +26 -14
  774. package/src/e2ee/worker/DataCryptor.test.ts +42 -1
  775. package/src/e2ee/worker/DataCryptor.ts +2 -2
  776. package/src/e2ee/worker/FrameCryptor.race.test.ts +3 -7
  777. package/src/e2ee/worker/FrameCryptor.test.ts +68 -13
  778. package/src/e2ee/worker/FrameCryptor.ts +78 -18
  779. package/src/e2ee/worker/e2ee.worker.test.ts +151 -0
  780. package/src/e2ee/worker/e2ee.worker.ts +28 -20
  781. package/src/e2ee/worker/naluUtils.test.ts +21 -1
  782. package/src/e2ee/worker/naluUtils.ts +30 -0
  783. package/src/e2ee/worker/sifPayload.ts +1 -1
  784. package/src/exports.ts +224 -0
  785. package/src/frameMetadata/FrameMetadataManager.ts +9 -3
  786. package/src/frameMetadata/extension.ts +34 -0
  787. package/src/frameMetadata/frameMetadata.ts +1 -1
  788. package/src/frameMetadata/utils.ts +23 -0
  789. package/src/index.ts +47 -189
  790. package/src/logger.ts +1 -3
  791. package/src/options.ts +25 -6
  792. package/src/room/CoreRoom.ts +3017 -0
  793. package/src/room/DeviceManager.test.ts +55 -1
  794. package/src/room/DeviceManager.ts +1 -1
  795. package/src/room/PCTransport.test.ts +43 -0
  796. package/src/room/PCTransport.ts +22 -22
  797. package/src/room/PCTransportManager.test.ts +65 -3
  798. package/src/room/PCTransportManager.ts +28 -12
  799. package/src/room/RTCEngine.test.ts +421 -21
  800. package/src/room/RTCEngine.ts +138 -34
  801. package/src/room/RegionUrlProvider.ts +1 -1
  802. package/src/room/Room.test.ts +717 -4
  803. package/src/room/Room.ts +34 -3317
  804. package/src/room/chat/extension.ts +78 -0
  805. package/src/room/createRoom.test.ts +149 -0
  806. package/src/room/createRoom.ts +26 -0
  807. package/src/room/data-channel/DataChannelManager.test.ts +37 -0
  808. package/src/room/data-channel/DataChannelManager.ts +21 -3
  809. package/src/room/data-stream/constants.ts +10 -0
  810. package/src/room/data-stream/extension.ts +162 -0
  811. package/src/room/data-stream/incoming/IncomingDataStreamManager.test.ts +269 -3
  812. package/src/room/data-stream/incoming/IncomingDataStreamManager.ts +53 -2
  813. package/src/room/data-stream/incoming/StreamReader.ts +14 -4
  814. package/src/room/data-stream/outgoing/OutgoingDataStreamManager.ts +1 -2
  815. package/src/room/data-track/depacketizer.ts +2 -2
  816. package/src/room/data-track/extension.ts +244 -0
  817. package/src/room/data-track/handle.ts +1 -1
  818. package/src/room/data-track/incoming/IncomingDataTrackManager.ts +2 -2
  819. package/src/room/data-track/incoming/pipeline.ts +2 -2
  820. package/src/room/data-track/outgoing/OutgoingDataTrackManager.test.ts +42 -3
  821. package/src/room/data-track/outgoing/OutgoingDataTrackManager.ts +5 -3
  822. package/src/room/data-track/outgoing/pipeline.ts +1 -1
  823. package/src/room/data-track/packet/extensions.ts +1 -1
  824. package/src/room/data-track/packet/index.ts +1 -1
  825. package/src/room/data-track/packet/serializable.ts +1 -1
  826. package/src/room/data-track/packetizer.ts +1 -1
  827. package/src/room/data-track/track-interfaces.ts +4 -4
  828. package/src/room/data-track/utils.ts +1 -1
  829. package/src/room/defaults.ts +3 -16
  830. package/src/room/extensions.ts +310 -0
  831. package/src/room/participant/LocalParticipant.test.ts +23 -6
  832. package/src/room/participant/LocalParticipant.ts +92 -669
  833. package/src/room/participant/Participant.test.ts +60 -0
  834. package/src/room/participant/Participant.ts +21 -1
  835. package/src/room/participant/RemoteParticipant.ts +3 -8
  836. package/src/room/participant/publishUtils.ts +3 -3
  837. package/src/room/participant/restartOnDefaultAudioDevice.test.ts +1 -1
  838. package/src/room/rpc/extension.ts +159 -0
  839. package/src/room/rpc/index.ts +1 -10
  840. package/src/room/rpc/legacyExtension.ts +36 -0
  841. package/src/room/simulated-participants/extension.ts +189 -0
  842. package/src/room/token-source/TokenSource.test.ts +29 -0
  843. package/src/room/token-source/TokenSource.ts +8 -3
  844. package/src/room/token-source/utils.test.ts +34 -0
  845. package/src/room/token-source/utils.ts +23 -1
  846. package/src/room/track/LocalTrack.ts +18 -10
  847. package/src/room/track/LocalVideoTrack.test.ts +66 -2
  848. package/src/room/track/LocalVideoTrack.ts +5 -3
  849. package/src/room/track/RemoteTrackPublication.ts +14 -1
  850. package/src/room/track/RemoteVideoTrack.test.ts +2 -0
  851. package/src/room/track/Track.test.ts +102 -0
  852. package/src/room/track/Track.ts +8 -1
  853. package/src/room/track/TrackPublication.ts +2 -2
  854. package/src/room/track/create.ts +59 -71
  855. package/src/room/track/facingMode.ts +5 -2
  856. package/src/room/track/options.ts +26 -34
  857. package/src/room/track/processor/types.ts +2 -2
  858. package/src/room/track/utils.ts +5 -1
  859. package/src/room/utils.ts +2 -2
  860. package/src/room/video/create.ts +95 -0
  861. package/src/room/video/extension.ts +115 -0
  862. package/src/room/video/publisher.ts +472 -0
  863. package/src/test/MockMediaStream.ts +13 -0
  864. package/src/utils/browserParser.ts +0 -3
  865. package/src/utils/deferrable-map.test.ts +60 -0
  866. package/src/utils/deferrable-map.ts +7 -4
  867. package/src/utils/serializer.ts +1 -1
  868. package/src/utils/throws.ts +15 -0
  869. package/src/version.ts +6 -1
@@ -0,0 +1,1110 @@
1
+ import {__awaiter}from'tslib';import {Mutex}from'@livekit/mutex';import {EventEmitter}from'events';import {parse,write}from'sdp-transform';import livekitLogger,{getLogger,LoggerNames}from'../logger.mjs';import {debounce}from'./debounce.mjs';import {NegotiationError,UnexpectedConnectionState}from'./errors.mjs';import {isSVCCodec,isSafari,ddExtensionURI}from'./utils.mjs';/*
2
+ * Video codecs use a very low bitrate at the beginning and increase slowly by
3
+ * the bandwidth estimator until they reach the target bitrate. The process commonly
4
+ * costs more than 10 seconds causing subscribers to get blurry video at the first
5
+ * few seconds. We use x-google-start-bitrate to hint the BWE to start higher.
6
+ *
7
+ * Why 90%: Gives ~10% headroom for bandwidth estimation while starting close to target.
8
+ * Why same for all codecs: Target bitrate already accounts for codec efficiency
9
+ * (e.g., users set lower targets for VP9/AV1 knowing they're more efficient).
10
+ * Why cap at 1 Mbps: Prevents BWE from starting too aggressively on high bitrate tracks.
11
+ * The cap is lowered further for connections that were slow to set up, see
12
+ * `computeStartBitrateCap`, or that the browser reports as slow, see
13
+ * `connectionEffectiveTypeStartBitrateCap`.
14
+ */
15
+ const startBitrateMultiplier = 0.9;
16
+ /** Maximum x-google-start-bitrate in kbps. 1 Mbps prevents BWE from starting too aggressively. */
17
+ const maxStartBitrateKbps = 1000;
18
+ /**
19
+ * Minimum x-google-start-bitrate in kbps: libwebrtc's own default starting estimate. A target
20
+ * below this gets no hint, since seeding above the real capacity costs more than the ramp it
21
+ * saves, and a slow connection is seeded no higher than this.
22
+ */
23
+ const minTargetBitrateKbps = 300;
24
+ /**
25
+ * Connection setup times (ms) bounding the ramp in `computeStartBitrateCap`: at or below the
26
+ * first the hint is capped at `maxStartBitrateKbps`, at or above the second at
27
+ * `minTargetBitrateKbps`. Measured on shaped links (CLT-3380): healthy links set up in under
28
+ * 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,
29
+ * and a 300 kbps link never under 3 s. The first sits above the 1 Mbps link, which a lower seed
30
+ * only slows down, and the second above the 500 kbps link's median, so only links that cannot
31
+ * carry more land at the floor.
32
+ */
33
+ const setupTimeForMaxStartBitrateMs = 1500;
34
+ const setupTimeForMinStartBitrateMs = 3500;
35
+ /** Cap on the start bitrate hint, in kbps, when the browser reports a `3g` connection. */
36
+ const effectiveType3gStartBitrateKbps = 500;
37
+ const debounceInterval = 20;
38
+ /**
39
+ * Codec payload for `codec` in this media section, when the section carries `cid`.
40
+ *
41
+ * Returns `undefined` when the section does not belong to the track, `0` when it does but
42
+ * does not offer the requested codec, and the codec payload otherwise.
43
+ *
44
+ * @internal
45
+ */
46
+ function findTrackCodecPayload(media, cid, codec) {
47
+ var _a, _b, _c;
48
+ if (!((_a = media.msid) === null || _a === void 0 ? void 0 : _a.includes(cid))) {
49
+ return undefined;
50
+ }
51
+ return (_c = (_b = media.rtp.find(rtp => rtp.codec.toUpperCase() === codec.toUpperCase())) === null || _b === void 0 ? void 0 : _b.payload) !== null && _c !== void 0 ? _c : 0;
52
+ }
53
+ /**
54
+ * Start bitrate hinted for a single track, or `undefined` when its target is too low to
55
+ * be worth seeding.
56
+ *
57
+ * 90% of the target leaves ~10% headroom for the estimator to settle. The same multiplier
58
+ * is used for every codec because the target already reflects the codec's efficiency.
59
+ * Camera is capped at 1 Mbps so the estimator does not open too aggressively on a
60
+ * high-bitrate track; screen share is exempt, because its content needs the bitrate
61
+ * immediately to stay legible.
62
+ *
63
+ * The cap is lowered for a connection that was slow to set up (`computeStartBitrateCap`), and
64
+ * for one the browser reports as slow (`connectionEffectiveTypeStartBitrateCap`), whichever is
65
+ * lower. Screen share is exempt from both, however slow the connection.
66
+ *
67
+ * @internal
68
+ */
69
+ function computeTrackStartBitrate(trackbr, connectionSetupTimeMs) {
70
+ if (trackbr.maxbr < minTargetBitrateKbps) {
71
+ return undefined;
72
+ }
73
+ const calculated = Math.min(Math.round(trackbr.maxbr * startBitrateMultiplier), trackbr.maxbr);
74
+ if (trackbr.isScreenShare) {
75
+ return calculated;
76
+ }
77
+ const cap = Math.min(computeStartBitrateCap(connectionSetupTimeMs), connectionEffectiveTypeStartBitrateCap());
78
+ return Math.min(calculated, cap);
79
+ }
80
+ /**
81
+ * Cap on the start bitrate hint, in kbps, from the browser's effective connection type
82
+ * (`navigator.connection.effectiveType`, Chromium only): `slow-2g` and `2g` cap at
83
+ * `minTargetBitrateKbps`, `3g` at `effectiveType3gStartBitrateKbps`.
84
+ *
85
+ * It catches links that have low bandwidth but low latency, which set up quickly and so slip
86
+ * past the setup time ramp. `4g`, and browsers without the API, give no guidance and stay at the
87
+ * `maxStartBitrateKbps` ceiling, as `computeStartBitrateCap` does without a setup time. The
88
+ * connection RTT the API also reports is not used: it lags behind network changes, and the setup
89
+ * time already reflects latency.
90
+ */
91
+ function connectionEffectiveTypeStartBitrateCap() {
92
+ // A `typeof` guard, since `globalThis` is missing from some supported browsers (Chrome < 71,
93
+ // Firefox < 65, Safari < 12.1) and the build does not polyfill it.
94
+ const connection = typeof navigator !== 'undefined' ? navigator.connection : undefined;
95
+ switch (connection === null || connection === void 0 ? void 0 : connection.effectiveType) {
96
+ case 'slow-2g':
97
+ case '2g':
98
+ return minTargetBitrateKbps;
99
+ case '3g':
100
+ return effectiveType3gStartBitrateKbps;
101
+ default:
102
+ return maxStartBitrateKbps;
103
+ }
104
+ }
105
+ /**
106
+ * Cap on the start bitrate hint, in kbps, from how long the connection took to set up.
107
+ *
108
+ * Connection setup time (signaling join plus ICE/DTLS) is the network signal every platform has
109
+ * before the first video offer, since libwebrtc cannot probe the path until a video sender
110
+ * exists. It grows with round-trip time and loss, which also mark the links where a 1 Mbps
111
+ * seed overshoots, so the cap ramps linearly from `maxStartBitrateKbps` at
112
+ * `setupTimeForMaxStartBitrateMs` down to `minTargetBitrateKbps` at
113
+ * `setupTimeForMinStartBitrateMs`. A video offer built while the connection is still being set
114
+ * up (publishing during connect) passes the time elapsed so far, a lower bound on the setup time.
115
+ * Without any timing the cap stays at the 1 Mbps ceiling.
116
+ */
117
+ function computeStartBitrateCap(connectionSetupTimeMs) {
118
+ if (connectionSetupTimeMs === undefined) {
119
+ return maxStartBitrateKbps;
120
+ }
121
+ const ramp = Math.min(Math.max((connectionSetupTimeMs - setupTimeForMaxStartBitrateMs) / (setupTimeForMinStartBitrateMs - setupTimeForMaxStartBitrateMs), 0), 1);
122
+ return Math.round(maxStartBitrateKbps - ramp * (maxStartBitrateKbps - minTargetBitrateKbps));
123
+ }
124
+ /**
125
+ * The single start bitrate for this peer connection: the largest hint among the video
126
+ * m-sections of `media` that map to a published track.
127
+ *
128
+ * libwebrtc reads `x-google-start-bitrate` per m-section but applies it to the shared
129
+ * `Call` (`WebRtcVideoSendChannel::ApplyChangedParams` -> `SetSdpBitrateParameters`), where
130
+ * `RtpBitrateConfigurator` holds one config for the whole connection. Differing per-section
131
+ * values are therefore last-writer-wins, decided by m-section order, so every video section
132
+ * gets the same number instead.
133
+ *
134
+ * Only sections that can send local media are considered. `trackBitrates` is append-only and an
135
+ * unpublished section keeps its `a=msid`, so matching on msid alone would still pair a stale
136
+ * entry with its old section — letting an uncapped screen-share target seed a connection that
137
+ * now carries only a camera, or consuming the one-shot hint on a section that sends nothing.
138
+ *
139
+ * The direction is the discriminator, as an exclusion rather than a match: `recvonly` and
140
+ * `inactive` are the only directions that cannot carry local media, and they are exactly the
141
+ * two a dead section lands on — unpublish sets `inactive` (explicitly in
142
+ * `LocalParticipant.unpublishTrack`, and via `removeTrack`'s sendonly -> inactive transition for
143
+ * the simulcast senders), `removeTrack` on a `sendrecv` transceiver leaves `recvonly`, and the
144
+ * pre-populated placeholders are `recvonly`. Everything else sends: `sendonly` from the
145
+ * `addTransceiver` path, `sendrecv` from the legacy `addTrack` fallback (which reuses a
146
+ * transceiver rather than creating a sendonly one), and a section with no direction attribute,
147
+ * which SDP defaults to `sendrecv`.
148
+ *
149
+ * @internal
150
+ */
151
+ function computeConnectionStartBitrate(media, trackBitrates, connectionSetupTimeMs) {
152
+ let connectionStartBitrate;
153
+ for (const m of media) {
154
+ if (m.type !== 'video' || m.direction === 'recvonly' || m.direction === 'inactive') {
155
+ continue;
156
+ }
157
+ for (const trackbr of trackBitrates) {
158
+ if (!trackbr.cid) {
159
+ continue;
160
+ }
161
+ const codecPayload = findTrackCodecPayload(m, trackbr.cid, trackbr.codec);
162
+ if (codecPayload === undefined) {
163
+ continue;
164
+ }
165
+ const startBitrate = codecPayload > 0 ? computeTrackStartBitrate(trackbr, connectionSetupTimeMs) : undefined;
166
+ if (startBitrate !== undefined && (connectionStartBitrate === undefined || startBitrate > connectionStartBitrate)) {
167
+ connectionStartBitrate = startBitrate;
168
+ }
169
+ break;
170
+ }
171
+ }
172
+ return connectionStartBitrate;
173
+ }
174
+ /**
175
+ * Declares `x-google-start-bitrate` on `codecPayload`'s fmtp. This SDP munging is used for
176
+ * a bitrate setting that cannot be applied through `RTCRtpEncodingParameters`.
177
+ *
178
+ * Returns whether the section now carries the hint.
179
+ *
180
+ * @internal
181
+ */
182
+ function applyVideoStartBitrate(media, codecPayload, startBitrate) {
183
+ const fmtp = media.fmtp.find(entry => entry.payload === codecPayload);
184
+ if (fmtp) {
185
+ // A payload type is shared across the bundle, so a value written for one section is
186
+ // already the connection-level one; leave it rather than rewrite it.
187
+ if (!fmtp.config.includes('x-google-start-bitrate')) {
188
+ fmtp.config += ";x-google-start-bitrate=".concat(startBitrate);
189
+ }
190
+ } else {
191
+ // VP8 and some codecs may not have an existing fmtp line.
192
+ media.fmtp.push({
193
+ payload: codecPayload,
194
+ config: "x-google-start-bitrate=".concat(startBitrate)
195
+ });
196
+ }
197
+ return true;
198
+ }
199
+ const PCEvents = {
200
+ NegotiationStarted: 'negotiationStarted',
201
+ NegotiationComplete: 'negotiationComplete',
202
+ // Fired with the offerId for every successful publisher answer application,
203
+ // including answers that immediately recurse into another offer via
204
+ // `renegotiate`. Use this rather than NegotiationComplete to know that a
205
+ // specific offer has been negotiated end-to-end.
206
+ OfferAnswered: 'offerAnswered',
207
+ RTPVideoPayloadTypes: 'rtpVideoPayloadTypes'
208
+ };
209
+ class PCTransport extends EventEmitter {
210
+ get pc() {
211
+ if (!this._pc) {
212
+ this._pc = this.createPC();
213
+ }
214
+ return this._pc;
215
+ }
216
+ constructor(config) {
217
+ let loggerOptions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
218
+ var _a;
219
+ super();
220
+ this.log = livekitLogger;
221
+ this.iceLog = livekitLogger;
222
+ this.ddExtID = 0;
223
+ this.latestOfferId = 0;
224
+ this.answeredOfferId = 0;
225
+ this.latestAcknowledgedOfferId = 0;
226
+ this.pendingCandidates = [];
227
+ this.restartingIce = false;
228
+ this.renegotiate = false;
229
+ this.trackBitrates = [];
230
+ /**
231
+ * Whether an offer carrying the connection-level `x-google-start-bitrate` has been
232
+ * accepted locally. The hint is written once per peer connection: libwebrtc retains
233
+ * `start_bitrate_bps` in `RtpBitrateConfigurator` and re-applies it on network route
234
+ * changes, so a later rewrite is at best a no-op and at worst restarts a converged
235
+ * bandwidth estimator. A new peer connection (full reconnect) seeds a new estimator.
236
+ */
237
+ this.hasAppliedVideoStartBitrate = false;
238
+ this.remoteStereoMids = [];
239
+ this.remoteNackMids = [];
240
+ // debounced negotiate interface
241
+ this.negotiate = debounce(onError => __awaiter(this, void 0, void 0, function* () {
242
+ this.emit(PCEvents.NegotiationStarted);
243
+ try {
244
+ yield this.createAndSendOffer();
245
+ } catch (e) {
246
+ if (onError) {
247
+ onError(e);
248
+ } else {
249
+ throw e;
250
+ }
251
+ }
252
+ }), debounceInterval);
253
+ this.close = () => {
254
+ if (!this._pc) {
255
+ return;
256
+ }
257
+ this.log.debug('closing peer connection');
258
+ this.pendingInitialOffer = undefined;
259
+ this._pc.close();
260
+ this._pc.onconnectionstatechange = null;
261
+ this._pc.oniceconnectionstatechange = null;
262
+ this._pc.onicegatheringstatechange = null;
263
+ this._pc.ondatachannel = null;
264
+ this._pc.onnegotiationneeded = null;
265
+ this._pc.onsignalingstatechange = null;
266
+ this._pc.onicecandidate = null;
267
+ this._pc.ondatachannel = null;
268
+ this._pc.ontrack = null;
269
+ this._pc.onconnectionstatechange = null;
270
+ this._pc.oniceconnectionstatechange = null;
271
+ this._pc = null;
272
+ };
273
+ this.loggerOptions = loggerOptions;
274
+ this.log = getLogger((_a = loggerOptions.loggerName) !== null && _a !== void 0 ? _a : LoggerNames.PCTransport, () => this.logContext);
275
+ this.iceLog = getLogger(LoggerNames.ICE, () => this.logContext);
276
+ this.config = config;
277
+ this._pc = this.createPC();
278
+ this.offerLock = new Mutex();
279
+ }
280
+ createPC() {
281
+ const pc = new RTCPeerConnection(this.config);
282
+ pc.onicecandidate = ev => {
283
+ var _a;
284
+ if (!ev.candidate) return;
285
+ this.iceLog.debug('local ICE candidate gathered', {
286
+ candidate: ev.candidate.candidate
287
+ });
288
+ (_a = this.onIceCandidate) === null || _a === void 0 ? void 0 : _a.call(this, ev.candidate);
289
+ };
290
+ pc.onicecandidateerror = ev => {
291
+ var _a;
292
+ this.iceLog.debug('ICE candidate error', {
293
+ event: ev
294
+ });
295
+ (_a = this.onIceCandidateError) === null || _a === void 0 ? void 0 : _a.call(this, ev);
296
+ };
297
+ pc.oniceconnectionstatechange = () => {
298
+ var _a;
299
+ this.iceLog.debug("ICE connection state: ".concat(pc.iceConnectionState));
300
+ (_a = this.onIceConnectionStateChange) === null || _a === void 0 ? void 0 : _a.call(this, pc.iceConnectionState);
301
+ };
302
+ pc.onsignalingstatechange = () => {
303
+ var _a;
304
+ this.log.debug("signaling state: ".concat(pc.signalingState));
305
+ (_a = this.onSignalingStatechange) === null || _a === void 0 ? void 0 : _a.call(this, pc.signalingState);
306
+ };
307
+ pc.onconnectionstatechange = () => {
308
+ var _a;
309
+ this.log.debug("connection state: ".concat(pc.connectionState));
310
+ (_a = this.onConnectionStateChange) === null || _a === void 0 ? void 0 : _a.call(this, pc.connectionState);
311
+ };
312
+ pc.ondatachannel = ev => {
313
+ var _a;
314
+ this.log.debug('data channel opened by peer', {
315
+ label: ev.channel.label,
316
+ id: ev.channel.id
317
+ });
318
+ (_a = this.onDataChannel) === null || _a === void 0 ? void 0 : _a.call(this, ev);
319
+ };
320
+ pc.ontrack = ev => {
321
+ var _a;
322
+ (_a = this.onTrack) === null || _a === void 0 ? void 0 : _a.call(this, ev);
323
+ };
324
+ return pc;
325
+ }
326
+ get logContext() {
327
+ var _a, _b;
328
+ return Object.assign({}, (_b = (_a = this.loggerOptions).loggerContextCb) === null || _b === void 0 ? void 0 : _b.call(_a));
329
+ }
330
+ get isICEConnected() {
331
+ return this._pc !== null && (this.pc.iceConnectionState === 'connected' || this.pc.iceConnectionState === 'completed');
332
+ }
333
+ addIceCandidate(candidate) {
334
+ return __awaiter(this, void 0, void 0, function* () {
335
+ if (this.pc.remoteDescription && !this.restartingIce) {
336
+ return this.pc.addIceCandidate(candidate);
337
+ }
338
+ this.iceLog.debug('queuing remote ICE candidate until remote description applied', {
339
+ pendingCount: this.pendingCandidates.length + 1
340
+ });
341
+ this.pendingCandidates.push(candidate);
342
+ });
343
+ }
344
+ /** Whether an answer for `offerId` answers an offer older than the latest one sent. */
345
+ isStaleAnswer(offerId) {
346
+ return this.latestOfferId > 0 && offerId > 0 && offerId !== this.latestOfferId;
347
+ }
348
+ setRemoteDescription(sd, offerId) {
349
+ return __awaiter(this, void 0, void 0, function* () {
350
+ var _a;
351
+ if (sd.type === 'answer' && this.isStaleAnswer(offerId)) {
352
+ this.log.warn('ignoring answer for old offer', {
353
+ offerId,
354
+ latestOfferId: this.latestOfferId
355
+ });
356
+ return false;
357
+ }
358
+ if (sd.type === 'answer') {
359
+ if (isDuplicateAnswer(offerId, this.answerInFlight, this.answeredOfferId, (_a = this._pc) === null || _a === void 0 ? void 0 : _a.signalingState, this.pendingInitialOffer !== undefined)) {
360
+ // a repeat of an answer already applied or being applied (e.g.
361
+ // duplicated by a proxy): there is no local offer left to answer
362
+ this.log.warn('ignoring duplicate answer', {
363
+ offerId
364
+ });
365
+ return false;
366
+ }
367
+ // claimed before any await, so a copy arriving mid-apply is caught too;
368
+ // released however the apply ends, so a genuine retry is still possible
369
+ this.answerInFlight = offerId;
370
+ }
371
+ try {
372
+ return yield this.applyRemoteDescription(sd, offerId);
373
+ } finally {
374
+ if (sd.type === 'answer') this.answerInFlight = undefined;
375
+ }
376
+ });
377
+ }
378
+ applyRemoteDescription(sd, offerId) {
379
+ return __awaiter(this, void 0, void 0, function* () {
380
+ var _a, _b;
381
+ let mungedSDP = undefined;
382
+ if (sd.type === 'offer') {
383
+ let _extractStereoAndNack = extractStereoAndNackAudioFromOffer(sd),
384
+ stereoMids = _extractStereoAndNack.stereoMids,
385
+ nackMids = _extractStereoAndNack.nackMids;
386
+ this.remoteStereoMids = stereoMids;
387
+ this.remoteNackMids = nackMids;
388
+ } else if (sd.type === 'answer') {
389
+ if (this.pendingInitialOffer && this._pc) {
390
+ const initialOffer = this.pendingInitialOffer;
391
+ this.pendingInitialOffer = undefined;
392
+ const sdpParsed = parse((_a = initialOffer.sdp) !== null && _a !== void 0 ? _a : '');
393
+ sdpParsed.media.forEach(media => {
394
+ ensureIPAddrMatchVersion(media);
395
+ });
396
+ this.log.debug('setting pending initial offer before processing answer');
397
+ yield this.setMungedSDP(initialOffer, write(sdpParsed));
398
+ }
399
+ const sdpParsed = parse((_b = sd.sdp) !== null && _b !== void 0 ? _b : '');
400
+ sdpParsed.media.forEach(media => {
401
+ const mid = getMidString(media.mid);
402
+ if (media.type === 'audio') {
403
+ // munge sdp for opus bitrate settings
404
+ this.trackBitrates.some(trackbr => {
405
+ if (!trackbr.transceiver || mid != trackbr.transceiver.mid) {
406
+ return false;
407
+ }
408
+ let codecPayload = 0;
409
+ media.rtp.some(rtp => {
410
+ if (rtp.codec.toUpperCase() === trackbr.codec.toUpperCase()) {
411
+ codecPayload = rtp.payload;
412
+ return true;
413
+ }
414
+ return false;
415
+ });
416
+ if (codecPayload === 0) {
417
+ return true;
418
+ }
419
+ let fmtpFound = false;
420
+ for (const fmtp of media.fmtp) {
421
+ if (fmtp.payload === codecPayload) {
422
+ fmtp.config = fmtp.config.split(';').filter(attr => !attr.includes('maxaveragebitrate')).join(';');
423
+ if (trackbr.maxbr > 0) {
424
+ fmtp.config += ";maxaveragebitrate=".concat(trackbr.maxbr * 1000);
425
+ }
426
+ fmtpFound = true;
427
+ break;
428
+ }
429
+ }
430
+ if (!fmtpFound) {
431
+ if (trackbr.maxbr > 0) {
432
+ media.fmtp.push({
433
+ payload: codecPayload,
434
+ config: "maxaveragebitrate=".concat(trackbr.maxbr * 1000)
435
+ });
436
+ }
437
+ }
438
+ return true;
439
+ });
440
+ }
441
+ });
442
+ // The server's answer sets per-track codec params (e.g. opus `usedtx`) on
443
+ // the sections mapped to a published track, but leaves the pre-populated
444
+ // recvonly placeholder sections with defaults. Conform the placeholders so
445
+ // each shared payload type is consistent across the bundle, otherwise
446
+ // libwebrtc flags a "bundled payload type collision".
447
+ const placeholderMids = this.getPlaceholderMids();
448
+ if (placeholderMids.size > 0) {
449
+ conformBundledCodecFmtp(sdpParsed.media, media => placeholderMids.has(getMidString(media.mid)));
450
+ }
451
+ mungedSDP = write(sdpParsed);
452
+ }
453
+ yield this.setMungedSDP(sd, mungedSDP, true);
454
+ // only a successfully applied answer makes later copies duplicates
455
+ if (sd.type === 'answer' && offerId > 0) this.answeredOfferId = offerId;
456
+ if (this.pendingCandidates.length > 0) {
457
+ this.iceLog.debug('flushing queued ICE candidates', {
458
+ count: this.pendingCandidates.length
459
+ });
460
+ }
461
+ this.pendingCandidates.forEach(candidate => {
462
+ this.pc.addIceCandidate(candidate);
463
+ });
464
+ this.pendingCandidates = [];
465
+ this.restartingIce = false;
466
+ // Fire OfferAnswered for every successfully applied answer, including the
467
+ // ones that recurse into another offer via `renegotiate`. Callers waiting
468
+ // on a specific offerId can resolve as soon as their offer's answer is in.
469
+ if (sd.type === 'answer') {
470
+ this.latestAcknowledgedOfferId = offerId;
471
+ this.emit(PCEvents.OfferAnswered, offerId);
472
+ }
473
+ if (this.renegotiate) {
474
+ this.renegotiate = false;
475
+ yield this.createAndSendOffer();
476
+ } else if (sd.type === 'answer') {
477
+ this.emit(PCEvents.NegotiationComplete);
478
+ if (sd.sdp) {
479
+ const sdpParsed = parse(sd.sdp);
480
+ sdpParsed.media.forEach(media => {
481
+ if (media.type === 'video') {
482
+ this.emit(PCEvents.RTPVideoPayloadTypes, media.rtp);
483
+ }
484
+ });
485
+ }
486
+ }
487
+ return true;
488
+ });
489
+ }
490
+ createInitialOffer() {
491
+ return __awaiter(this, void 0, void 0, function* () {
492
+ var _a;
493
+ const unlock = yield this.offerLock.lock();
494
+ try {
495
+ if (this.pc.signalingState !== 'stable') {
496
+ this.log.warn('signaling state is not stable, cannot create initial offer');
497
+ return;
498
+ }
499
+ const offerId = this.latestOfferId + 1;
500
+ this.latestOfferId = offerId;
501
+ const offer = yield this.pc.createOffer();
502
+ this.pendingInitialOffer = {
503
+ sdp: offer.sdp,
504
+ type: offer.type
505
+ };
506
+ const sdpParsed = parse((_a = offer.sdp) !== null && _a !== void 0 ? _a : '');
507
+ sdpParsed.media.forEach(media => {
508
+ ensureIPAddrMatchVersion(media);
509
+ });
510
+ offer.sdp = write(sdpParsed);
511
+ return {
512
+ offer,
513
+ offerId
514
+ };
515
+ } finally {
516
+ unlock();
517
+ }
518
+ });
519
+ }
520
+ createAndSendOffer(options) {
521
+ return __awaiter(this, void 0, void 0, function* () {
522
+ var _a;
523
+ const unlock = yield this.offerLock.lock();
524
+ try {
525
+ if (this.onOffer === undefined) {
526
+ return;
527
+ }
528
+ if (options === null || options === void 0 ? void 0 : options.iceRestart) {
529
+ this.iceLog.debug('restarting ICE');
530
+ this.restartingIce = true;
531
+ }
532
+ if (this._pc && (this._pc.signalingState === 'have-local-offer' || this.pendingInitialOffer)) {
533
+ // we're waiting for the peer to accept our offer, so we'll just wait
534
+ // the only exception to this is when ICE restart is needed
535
+ const currentSD = this._pc.remoteDescription;
536
+ if ((options === null || options === void 0 ? void 0 : options.iceRestart) && currentSD) {
537
+ // roll the remote description back in so createOffer produces a valid
538
+ // ICE-restart offer on top of the already-negotiated state
539
+ yield this._pc.setRemoteDescription(currentSD);
540
+ } else if (options === null || options === void 0 ? void 0 : options.iceRestart) {
541
+ // ICE restart with no remote description to restart on: `renegotiate` would stall
542
+ // (the pending offer is never answered), so throw for the caller to recreate the PC.
543
+ throw new NegotiationError('ICE restart requested without a remote description, peer connection must be recreated');
544
+ } else {
545
+ this.renegotiate = true;
546
+ this.log.debug('requesting renegotiation');
547
+ return;
548
+ }
549
+ } else if (!this._pc || this._pc.signalingState === 'closed') {
550
+ this.log.warn('could not createOffer with closed peer connection');
551
+ return;
552
+ }
553
+ // actually negotiate
554
+ this.log.debug('starting to negotiate');
555
+ // increase the offer id at the start to ensure the offer is always > 0 so that we can use 0 as a default value for legacy behavior
556
+ const offerId = this.latestOfferId + 1;
557
+ this.latestOfferId = offerId;
558
+ const offer = yield this.pc.createOffer(options);
559
+ this.log.debug('original offer', {
560
+ sdp: offer.sdp
561
+ });
562
+ const sdpParsed = parse((_a = offer.sdp) !== null && _a !== void 0 ? _a : '');
563
+ // One value for every video m-section, written only on the first offer that carries
564
+ // local video: the hint is connection-level in libwebrtc, so differing per-section
565
+ // values would be last-writer-wins on m-section order. Offers before any video is
566
+ // published (data channel or audio only) find no target and leave the latch unset.
567
+ const connectionStartBitrate = this.hasAppliedVideoStartBitrate ? undefined : computeConnectionStartBitrate(sdpParsed.media, this.trackBitrates, this.connectionSetupTimeEstimateMs());
568
+ let appliedVideoStartBitrate = false;
569
+ sdpParsed.media.forEach(media => {
570
+ ensureIPAddrMatchVersion(media);
571
+ if (media.type === 'audio') {
572
+ ensureAudioNackAndStereo(media, ['all'], []);
573
+ } else if (media.type === 'video') {
574
+ this.trackBitrates.some(trackbr => {
575
+ if (!trackbr.cid) {
576
+ return false;
577
+ }
578
+ const codecPayload = findTrackCodecPayload(media, trackbr.cid, trackbr.codec);
579
+ if (codecPayload === undefined) {
580
+ return false;
581
+ }
582
+ if (codecPayload > 0) {
583
+ if (connectionStartBitrate !== undefined) {
584
+ appliedVideoStartBitrate = applyVideoStartBitrate(media, codecPayload, connectionStartBitrate) || appliedVideoStartBitrate;
585
+ }
586
+ if (isSVCCodec(trackbr.codec) && !isSafari()) {
587
+ this.ddExtID = ensureVideoDDExtension(media, sdpParsed, this.ddExtID);
588
+ }
589
+ }
590
+ return true;
591
+ });
592
+ }
593
+ });
594
+ // Conform the placeholder sections (pre-populated, or reverted after an
595
+ // unpublish) so every shared payload type carries identical fmtp across the
596
+ // bundle, otherwise libwebrtc flags a "bundled payload type collision".
597
+ // Detection is by transceiver (mids are stable across renegotiations) since
598
+ // an unpublished section keeps its `a=msid`.
599
+ const placeholderMids = this.getPlaceholderMids();
600
+ if (placeholderMids.size > 0) {
601
+ conformBundledCodecFmtp(sdpParsed.media, media => placeholderMids.has(getMidString(media.mid)));
602
+ }
603
+ if (this.latestOfferId > offerId) {
604
+ this.log.warn('latestOfferId mismatch', {
605
+ latestOfferId: this.latestOfferId,
606
+ offerId
607
+ });
608
+ return;
609
+ }
610
+ const mungedSdp = write(sdpParsed);
611
+ yield this.setMungedSDP(offer, mungedSdp);
612
+ // setMungedSDP falls back to the unmunged SDP on rejection. Only consume the
613
+ // one-shot hint once the SDP carrying it has been accepted locally.
614
+ if (appliedVideoStartBitrate && offer.sdp === mungedSdp) {
615
+ this.hasAppliedVideoStartBitrate = true;
616
+ this.log.info('applied x-google-start-bitrate', {
617
+ startBitrateKbps: connectionStartBitrate,
618
+ connectionSetupTimeMs: this.connectionSetupTimeEstimateMs()
619
+ });
620
+ }
621
+ this.onOffer(offer, this.latestOfferId);
622
+ } finally {
623
+ unlock();
624
+ }
625
+ });
626
+ }
627
+ createAndSetAnswer() {
628
+ return __awaiter(this, void 0, void 0, function* () {
629
+ var _a;
630
+ const answer = yield this.pc.createAnswer();
631
+ const sdpParsed = parse((_a = answer.sdp) !== null && _a !== void 0 ? _a : '');
632
+ sdpParsed.media.forEach(media => {
633
+ ensureIPAddrMatchVersion(media);
634
+ if (media.type === 'audio') {
635
+ ensureAudioNackAndStereo(media, this.remoteStereoMids, this.remoteNackMids);
636
+ }
637
+ });
638
+ yield this.setMungedSDP(answer, write(sdpParsed));
639
+ return answer;
640
+ });
641
+ }
642
+ /**
643
+ * Returns the mids of transceivers that carry no outgoing track on this
644
+ * (publisher) connection: the pre-populated placeholders added by
645
+ * `RTCEngine.applyInitialPublisherLayout`, plus any transceiver that was used
646
+ * for a track and reverted on unpublish. Their codec fmtp is conformed to the
647
+ * published tracks so a shared payload type stays consistent across the bundle.
648
+ */
649
+ getPlaceholderMids() {
650
+ var _a, _b;
651
+ return placeholderMidsFromTransceivers((_b = (_a = this._pc) === null || _a === void 0 ? void 0 : _a.getTransceivers()) !== null && _b !== void 0 ? _b : []);
652
+ }
653
+ createDataChannel(label, dataChannelDict) {
654
+ return this.pc.createDataChannel(label, dataChannelDict);
655
+ }
656
+ addTransceiver(mediaStreamTrack, transceiverInit) {
657
+ return this.pc.addTransceiver(mediaStreamTrack, transceiverInit);
658
+ }
659
+ addTransceiverOfKind(kind, transceiverInit) {
660
+ return this.pc.addTransceiver(kind, transceiverInit);
661
+ }
662
+ addTrack(track) {
663
+ if (!this._pc) {
664
+ throw new UnexpectedConnectionState('PC closed, cannot add track');
665
+ }
666
+ return this._pc.addTrack(track);
667
+ }
668
+ setTrackCodecBitrate(info) {
669
+ this.trackBitrates.push(info);
670
+ }
671
+ /**
672
+ * Record how long this peer connection took to set up. Called once, when the initial connect
673
+ * succeeds; resumes and ICE restarts keep the estimator they have and never call this.
674
+ */
675
+ setConnectionSetupTime(ms) {
676
+ this.connectionSetupTimeMs = ms;
677
+ }
678
+ /** Record when the connection attempt that built this peer connection began. */
679
+ setConnectionStartedAt(startedAt) {
680
+ this.connectionStartedAt = startedAt;
681
+ }
682
+ /** The measured setup time, or while still connecting, the time elapsed so far. */
683
+ connectionSetupTimeEstimateMs() {
684
+ if (this.connectionSetupTimeMs !== undefined) {
685
+ return this.connectionSetupTimeMs;
686
+ }
687
+ if (this.connectionStartedAt === undefined) {
688
+ return undefined;
689
+ }
690
+ return Math.round(performance.now() - this.connectionStartedAt);
691
+ }
692
+ setConfiguration(rtcConfig) {
693
+ var _a;
694
+ if (!this._pc) {
695
+ throw new UnexpectedConnectionState('PC closed, cannot configure');
696
+ }
697
+ return (_a = this._pc) === null || _a === void 0 ? void 0 : _a.setConfiguration(rtcConfig);
698
+ }
699
+ canRemoveTrack() {
700
+ var _a;
701
+ return !!((_a = this._pc) === null || _a === void 0 ? void 0 : _a.removeTrack);
702
+ }
703
+ removeTrack(sender) {
704
+ var _a;
705
+ return (_a = this._pc) === null || _a === void 0 ? void 0 : _a.removeTrack(sender);
706
+ }
707
+ getConnectionState() {
708
+ var _a, _b;
709
+ return (_b = (_a = this._pc) === null || _a === void 0 ? void 0 : _a.connectionState) !== null && _b !== void 0 ? _b : 'closed';
710
+ }
711
+ getICEConnectionState() {
712
+ var _a, _b;
713
+ return (_b = (_a = this._pc) === null || _a === void 0 ? void 0 : _a.iceConnectionState) !== null && _b !== void 0 ? _b : 'closed';
714
+ }
715
+ getSignallingState() {
716
+ var _a, _b;
717
+ return (_b = (_a = this._pc) === null || _a === void 0 ? void 0 : _a.signalingState) !== null && _b !== void 0 ? _b : 'closed';
718
+ }
719
+ getTransceivers() {
720
+ var _a, _b;
721
+ return (_b = (_a = this._pc) === null || _a === void 0 ? void 0 : _a.getTransceivers()) !== null && _b !== void 0 ? _b : [];
722
+ }
723
+ getSenders() {
724
+ var _a, _b;
725
+ return (_b = (_a = this._pc) === null || _a === void 0 ? void 0 : _a.getSenders()) !== null && _b !== void 0 ? _b : [];
726
+ }
727
+ getLocalDescription() {
728
+ var _a;
729
+ return (_a = this._pc) === null || _a === void 0 ? void 0 : _a.localDescription;
730
+ }
731
+ getRemoteDescription() {
732
+ var _a;
733
+ return (_a = this.pc) === null || _a === void 0 ? void 0 : _a.remoteDescription;
734
+ }
735
+ /** stats of the underlying connection, `undefined` when there is none */
736
+ getStats() {
737
+ var _a;
738
+ return (_a = this._pc) === null || _a === void 0 ? void 0 : _a.getStats();
739
+ }
740
+ getMaxMessageSize() {
741
+ var _a, _b;
742
+ return (_b = (_a = this._pc) === null || _a === void 0 ? void 0 : _a.sctp) === null || _b === void 0 ? void 0 : _b.maxMessageSize;
743
+ }
744
+ getConnectedAddress() {
745
+ return __awaiter(this, void 0, void 0, function* () {
746
+ var _a;
747
+ if (!this._pc) {
748
+ return;
749
+ }
750
+ let selectedCandidatePairId = '';
751
+ const candidatePairs = new Map();
752
+ // id -> candidate ip
753
+ const candidates = new Map();
754
+ const stats = yield this._pc.getStats();
755
+ stats.forEach(v => {
756
+ switch (v.type) {
757
+ case 'transport':
758
+ selectedCandidatePairId = v.selectedCandidatePairId;
759
+ break;
760
+ case 'candidate-pair':
761
+ if (selectedCandidatePairId === '' && v.selected) {
762
+ selectedCandidatePairId = v.id;
763
+ }
764
+ candidatePairs.set(v.id, v);
765
+ break;
766
+ case 'remote-candidate':
767
+ candidates.set(v.id, "".concat(v.address, ":").concat(v.port));
768
+ break;
769
+ }
770
+ });
771
+ if (selectedCandidatePairId === '') {
772
+ return undefined;
773
+ }
774
+ const selectedID = (_a = candidatePairs.get(selectedCandidatePairId)) === null || _a === void 0 ? void 0 : _a.remoteCandidateId;
775
+ if (selectedID === undefined) {
776
+ return undefined;
777
+ }
778
+ return candidates.get(selectedID);
779
+ });
780
+ }
781
+ setMungedSDP(sd, munged, remote) {
782
+ return __awaiter(this, void 0, void 0, function* () {
783
+ var _a, _b;
784
+ const originalSdp = sd.sdp;
785
+ if (munged) {
786
+ sd.sdp = munged;
787
+ try {
788
+ this.log.debug("setting munged ".concat(remote ? 'remote' : 'local', " description"));
789
+ if (remote) {
790
+ yield this.pc.setRemoteDescription(sd);
791
+ } else {
792
+ yield this.pc.setLocalDescription(sd);
793
+ }
794
+ return;
795
+ } catch (e) {
796
+ this.log.warn("not able to set ".concat(sd.type, ", falling back to unmodified sdp"), {
797
+ error: e,
798
+ mungedSdp: munged,
799
+ originalSdp
800
+ });
801
+ sd.sdp = originalSdp;
802
+ }
803
+ }
804
+ try {
805
+ if (remote) {
806
+ yield (_a = this._pc) === null || _a === void 0 ? void 0 : _a.setRemoteDescription(sd);
807
+ } else {
808
+ yield (_b = this._pc) === null || _b === void 0 ? void 0 : _b.setLocalDescription(sd);
809
+ }
810
+ } catch (e) {
811
+ let msg = 'unknown error';
812
+ if (e instanceof Error) {
813
+ msg = e.message;
814
+ } else if (typeof e === 'string') {
815
+ msg = e;
816
+ }
817
+ const fields = {
818
+ error: msg,
819
+ sdp: sd.sdp
820
+ };
821
+ if (munged && munged !== originalSdp) {
822
+ fields.mungedSdp = munged;
823
+ }
824
+ if (!remote && this.pc.remoteDescription) {
825
+ fields.remoteSdp = this.pc.remoteDescription;
826
+ }
827
+ this.log.error("unable to set ".concat(sd.type), {
828
+ fields
829
+ });
830
+ throw new NegotiationError(msg);
831
+ }
832
+ });
833
+ }
834
+ }
835
+ /**
836
+ * Adds the AV1 dependency descriptor extension to `media` unless it is already there, and
837
+ * returns the id it is mapped to so callers can pass it back in as `ddExtID` (0 when no id has
838
+ * been chosen yet).
839
+ *
840
+ * A bundle has to map one URI to one id, so an id already in use for the extension anywhere in
841
+ * `sdp` wins over both the cached one and a fresh one: Chrome advertises the extension itself on
842
+ * sections it can send on, and an earlier offer may have munged it into others.
843
+ * @internal
844
+ */
845
+ function ensureVideoDDExtension(media, sdp, ddExtID) {
846
+ var _a, _b;
847
+ const id = ddExtensionIDFor(sdp, ddExtID);
848
+ if (id === undefined) {
849
+ return ddExtID;
850
+ }
851
+ if (!((_a = media.ext) === null || _a === void 0 ? void 0 : _a.some(ext => ext.uri === ddExtensionURI))) {
852
+ (_b = media.ext) !== null && _b !== void 0 ? _b : media.ext = [];
853
+ media.ext.push({
854
+ value: id,
855
+ uri: ddExtensionURI
856
+ });
857
+ }
858
+ return id;
859
+ }
860
+ /**
861
+ * The id to map the dependency descriptor to throughout `sdp`, or undefined when no id would be
862
+ * consistent for the whole bundle and the extension therefore has to be left out.
863
+ */
864
+ function ddExtensionIDFor(sdp, cachedID) {
865
+ const mapped = mappedExtensionID(sdp, ddExtensionURI);
866
+ if (mapped !== undefined) {
867
+ // Adopting an id that also stands for another URI is what the browser rejects the bundle
868
+ // over, and its own half of the map is not ours to renumber, so give up on this offer.
869
+ return usedForOtherURI(sdp, mapped, ddExtensionURI) ? undefined : mapped;
870
+ }
871
+ // Reusing the id from the last offer keeps the mapping stable across renegotiations, but only
872
+ // while nothing else has taken it: the browser assigns ids to its own extensions without
873
+ // knowing about ours, so an id that was free when we picked it can since have been claimed —
874
+ // typically by the fuller extension set that arrives with the first section we send on.
875
+ if (cachedID !== 0 && !usedForOtherURI(sdp, cachedID, ddExtensionURI)) {
876
+ return cachedID;
877
+ }
878
+ return unusedExtensionID(sdp);
879
+ }
880
+ /** The id `uri` is mapped to in `sdp`, if any section maps it. */
881
+ function mappedExtensionID(sdp, uri) {
882
+ var _a;
883
+ for (const media of sdp.media) {
884
+ const ext = (_a = media.ext) === null || _a === void 0 ? void 0 : _a.find(candidate => candidate.uri === uri);
885
+ if (ext) {
886
+ return ext.value;
887
+ }
888
+ }
889
+ return undefined;
890
+ }
891
+ /** Whether `id` stands for anything in `sdp` other than `uri`. */
892
+ function usedForOtherURI(sdp, id, uri) {
893
+ return sdp.media.some(media => {
894
+ var _a;
895
+ return (_a = media.ext) === null || _a === void 0 ? void 0 : _a.some(ext => ext.value === id && ext.uri !== uri);
896
+ });
897
+ }
898
+ /**
899
+ * An id no extension in `sdp` uses. Stays above every id in use rather than filling gaps, so it
900
+ * is less likely to be an id the browser goes on to allocate to another extension, and steps
901
+ * over 15, which RFC 8285 reserves.
902
+ */
903
+ function unusedExtensionID(sdp) {
904
+ let maxID = 0;
905
+ sdp.media.forEach(media => {
906
+ var _a;
907
+ (_a = media.ext) === null || _a === void 0 ? void 0 : _a.forEach(ext => {
908
+ if (ext.value > maxID) {
909
+ maxID = ext.value;
910
+ }
911
+ });
912
+ });
913
+ return maxID + 1 === 15 ? 16 : maxID + 1;
914
+ }
915
+ /**
916
+ * Checks whether an fmtp config declares `param` as an exact, `;`-delimited
917
+ * token. A plain substring check conflates distinct opus parameters — e.g.
918
+ * `stereo=1` is a substring of `sprop-stereo=1` — so `param` must match a whole
919
+ * parameter, not appear anywhere within the config string.
920
+ * @internal
921
+ */
922
+ function fmtpConfigHasParam(config, param) {
923
+ return config.split(';').some(entry => entry.trim() === param);
924
+ }
925
+ /** @internal */
926
+ function ensureAudioNackAndStereo(media, stereoMids, nackMids) {
927
+ // sdp-transform types don't include number however the parser outputs mids as numbers in some cases
928
+ const mid = getMidString(media.mid);
929
+ // found opus codec to add nack fb
930
+ let opusPayload = 0;
931
+ media.rtp.some(rtp => {
932
+ // rtpmap encoding names are case-insensitive (RFC 4855)
933
+ if (rtp.codec.toLowerCase() === 'opus') {
934
+ opusPayload = rtp.payload;
935
+ return true;
936
+ }
937
+ return false;
938
+ });
939
+ // add nack rtcpfb if not exist
940
+ if (opusPayload > 0) {
941
+ if (!media.rtcpFb) {
942
+ media.rtcpFb = [];
943
+ }
944
+ if (nackMids.includes(mid) && !media.rtcpFb.some(fb => fb.payload === opusPayload && fb.type === 'nack')) {
945
+ media.rtcpFb.push({
946
+ payload: opusPayload,
947
+ type: 'nack'
948
+ });
949
+ }
950
+ if (stereoMids.includes(mid) || stereoMids.length === 1 && stereoMids[0] === 'all') {
951
+ media.fmtp.some(fmtp => {
952
+ if (fmtp.payload === opusPayload) {
953
+ if (!fmtpConfigHasParam(fmtp.config, 'stereo=1')) {
954
+ fmtp.config += ';stereo=1';
955
+ }
956
+ return true;
957
+ }
958
+ return false;
959
+ });
960
+ }
961
+ }
962
+ }
963
+ /**
964
+ * Returns the mids of transceivers that carry no outgoing track: the
965
+ * pre-populated placeholders added by `RTCEngine.applyInitialPublisherLayout`,
966
+ * plus any transceiver that was used for a track and reverted on unpublish. The
967
+ * `sender.track` check is the reliable signal — an unpublished section keeps its
968
+ * `a=msid` (and its stale send-derived fmtp), so it can't be told apart from a
969
+ * real send by SDP alone. Transceiver mids are stable across renegotiations, so
970
+ * this works for every offer/answer after the first.
971
+ * @internal
972
+ */
973
+ function placeholderMidsFromTransceivers(transceivers) {
974
+ const mids = new Set();
975
+ for (const transceiver of transceivers) {
976
+ if (transceiver.mid && !transceiver.sender.track) {
977
+ mids.add(transceiver.mid);
978
+ }
979
+ }
980
+ return mids;
981
+ }
982
+ /**
983
+ * Within a BUNDLE group a payload type must map to identical codec parameters
984
+ * across every m-line. When the same payload type carries different fmtp between
985
+ * sections — e.g. opus `usedtx=1` on the published microphone but not on the
986
+ * pre-populated recvonly placeholders, or H.265 with different `level-id` between
987
+ * a published video track and a placeholder — libwebrtc flags a "bundled payload
988
+ * type collision".
989
+ *
990
+ * Rewrite the placeholder sections so every shared payload type carries the
991
+ * same fmtp. Real (non-placeholder) sections always win the canonical value, so
992
+ * a published track's encoder parameters are never altered. When no real
993
+ * section declares a payload type — e.g. a placeholder that was reused for a
994
+ * track and then reverted to recvonly keeps its send-derived `level-id` while
995
+ * fresh placeholders use the default — the placeholders still converge on the
996
+ * first value seen, so two placeholders can't disagree either. Only placeholder
997
+ * sections are ever rewritten, and it is codec-agnostic (opus, H.265, ...).
998
+ * A codec without an `a=fmtp` line has empty parameters. Real sections that
999
+ * disagree on a payload type are not reconciled: the placeholders follow the
1000
+ * last real section, and the real sections still differ.
1001
+ * `isPlaceholder` identifies the sections to conform.
1002
+ * @internal
1003
+ */
1004
+ function conformBundledCodecFmtp(media, isPlaceholder) {
1005
+ var _a, _b, _c, _d, _e, _f, _g, _h;
1006
+ // Canonical fmtp per payload type. Payload types are unique within a BUNDLE
1007
+ // group, so keying by payload alone (across audio and video) is safe. A real
1008
+ // section's value always takes precedence; otherwise the first placeholder
1009
+ // value seen is used so divergent placeholders still converge.
1010
+ const canonicalByPayload = new Map();
1011
+ for (const m of media) {
1012
+ const placeholder = isPlaceholder(m);
1013
+ for (const _ref of (_a = m.rtp) !== null && _a !== void 0 ? _a : []) {
1014
+ const payload = _ref.payload;
1015
+ const config = (_d = (_c = (_b = m.fmtp) === null || _b === void 0 ? void 0 : _b.find(fmtp => fmtp.payload === payload)) === null || _c === void 0 ? void 0 : _c.config) !== null && _d !== void 0 ? _d : '';
1016
+ if (!placeholder || !canonicalByPayload.has(payload)) {
1017
+ canonicalByPayload.set(payload, config);
1018
+ }
1019
+ }
1020
+ }
1021
+ // Conform placeholder sections to the canonical fmtp for each shared payload.
1022
+ for (const m of media) {
1023
+ if (!isPlaceholder(m)) {
1024
+ continue;
1025
+ }
1026
+ for (const _ref2 of (_e = m.rtp) !== null && _e !== void 0 ? _e : []) {
1027
+ const payload = _ref2.payload;
1028
+ // The first loop added every payload type a placeholder lists.
1029
+ const config = canonicalByPayload.get(payload);
1030
+ const fmtp = (_f = m.fmtp) === null || _f === void 0 ? void 0 : _f.find(entry => entry.payload === payload);
1031
+ if (config === '') {
1032
+ m.fmtp = ((_g = m.fmtp) !== null && _g !== void 0 ? _g : []).filter(entry => entry.payload !== payload);
1033
+ } else if (fmtp) {
1034
+ fmtp.config = config;
1035
+ } else {
1036
+ m.fmtp = [...((_h = m.fmtp) !== null && _h !== void 0 ? _h : []), {
1037
+ payload,
1038
+ config
1039
+ }];
1040
+ }
1041
+ }
1042
+ }
1043
+ }
1044
+ /** @internal */
1045
+ /**
1046
+ * Whether an incoming answer repeats one already applied or being applied.
1047
+ * Any answer for the offer whose answer is in flight is a duplicate, numbered
1048
+ * or not. With an offerId (current servers) an answer is also a duplicate if
1049
+ * that offer's answer was already applied. Without one, fall back to the
1050
+ * signaling state: in `stable` no local offer is pending, unless the initial
1051
+ * offer is still deferred (it is set locally only once its answer arrives).
1052
+ */
1053
+ function isDuplicateAnswer(offerId, answerInFlight, answeredOfferId, signalingState, hasPendingInitialOffer) {
1054
+ if (answerInFlight === offerId) return true;
1055
+ if (offerId > 0) return offerId === answeredOfferId;
1056
+ return signalingState === 'stable' && !hasPendingInitialOffer;
1057
+ }
1058
+ function extractStereoAndNackAudioFromOffer(offer) {
1059
+ var _a;
1060
+ const stereoMids = [];
1061
+ const nackMids = [];
1062
+ const sdpParsed = parse((_a = offer.sdp) !== null && _a !== void 0 ? _a : '');
1063
+ let opusPayload = 0;
1064
+ sdpParsed.media.forEach(media => {
1065
+ var _a;
1066
+ const mid = getMidString(media.mid);
1067
+ if (media.type === 'audio') {
1068
+ media.rtp.some(rtp => {
1069
+ // rtpmap encoding names are case-insensitive (RFC 4855)
1070
+ if (rtp.codec.toLowerCase() === 'opus') {
1071
+ opusPayload = rtp.payload;
1072
+ return true;
1073
+ }
1074
+ return false;
1075
+ });
1076
+ if ((_a = media.rtcpFb) === null || _a === void 0 ? void 0 : _a.some(fb => fb.payload === opusPayload && fb.type === 'nack')) {
1077
+ nackMids.push(mid);
1078
+ }
1079
+ media.fmtp.some(fmtp => {
1080
+ if (fmtp.payload === opusPayload) {
1081
+ if (fmtpConfigHasParam(fmtp.config, 'sprop-stereo=1')) {
1082
+ stereoMids.push(mid);
1083
+ }
1084
+ return true;
1085
+ }
1086
+ return false;
1087
+ });
1088
+ }
1089
+ });
1090
+ return {
1091
+ stereoMids,
1092
+ nackMids
1093
+ };
1094
+ }
1095
+ function ensureIPAddrMatchVersion(media) {
1096
+ // Chrome could generate sdp with c = IN IP4 <ipv6 addr>
1097
+ // in edge case and return error when set sdp.This is not a
1098
+ // sdk error but correct it if the issue detected.
1099
+ if (media.connection) {
1100
+ const isV6 = media.connection.ip.indexOf(':') >= 0;
1101
+ if (media.connection.version === 4 && isV6 || media.connection.version === 6 && !isV6) {
1102
+ // fallback to dummy address
1103
+ media.connection.ip = '0.0.0.0';
1104
+ media.connection.version = 4;
1105
+ }
1106
+ }
1107
+ }
1108
+ function getMidString(mid) {
1109
+ return typeof mid === 'number' ? mid.toFixed(0) : mid;
1110
+ }export{PCEvents,applyVideoStartBitrate,computeConnectionStartBitrate,computeTrackStartBitrate,conformBundledCodecFmtp,PCTransport as default,ensureAudioNackAndStereo,ensureVideoDDExtension,extractStereoAndNackAudioFromOffer,findTrackCodecPayload,fmtpConfigHasParam,isDuplicateAnswer,placeholderMidsFromTransceivers};//# sourceMappingURL=PCTransport.mjs.map