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
@@ -2,11 +2,11 @@ import { Encryption_Type, TrackInfo } from '@livekit/protocol';
2
2
  import { EventEmitter } from 'events';
3
3
  import type TypedEventEmitter from 'typed-emitter';
4
4
  import type { FrameMetadata } from '../frameMetadata/types';
5
- import { hasFrameMetadataPublishOptions } from '../frameMetadata/utils';
5
+ import { getPublishFrameMetadata, hasFrameMetadataPublishOptions } from '../frameMetadata/utils';
6
6
  import { LogLevel, LoggerNames, getLogger, onWorkerLogLevelChanged, workerLogger } from '../logger';
7
+ import type { CoreRoom } from '../room/CoreRoom';
8
+ import { ConnectionState } from '../room/CoreRoom';
7
9
  import type RTCEngine from '../room/RTCEngine';
8
- import type Room from '../room/Room';
9
- import { ConnectionState } from '../room/Room';
10
10
  import { DeviceUnsupportedError } from '../room/errors';
11
11
  import { EngineEvent, ParticipantEvent, RoomEvent } from '../room/events';
12
12
  import type RemoteTrack from '../room/track/RemoteTrack';
@@ -49,11 +49,23 @@ import type {
49
49
  import { isE2EESupported } from './utils';
50
50
 
51
51
  export interface BaseE2EEManager {
52
- setup(room: Room): void;
52
+ /** @internal */
53
+ setup(room: CoreRoom): void;
53
54
  setupEngine(engine: RTCEngine): void;
54
55
  isEnabled: boolean;
55
56
  isDataChannelEncryptionEnabled: boolean;
57
+ /**
58
+ * @internal
59
+ * @deprecated use `setLocalParticipantCryptorEnabled`
60
+ */
56
61
  setParticipantCryptorEnabled(enabled: boolean, participantIdentity: string): void;
62
+ /**
63
+ * Sets whether the local participant encrypts. Optional so that existing managers still
64
+ * satisfy the interface: without it, `setParticipantCryptorEnabled` is called.
65
+ * @internal
66
+ */
67
+ setLocalParticipantCryptorEnabled?(enabled: boolean): void;
68
+ /** @internal */
57
69
  setSifTrailer(trailer: NonSharedUint8Array): void;
58
70
  encryptData(data: NonSharedUint8Array): Promise<EncryptDataResponseMessage['data']>;
59
71
  handleEncryptedData(
@@ -63,6 +75,7 @@ export interface BaseE2EEManager {
63
75
  keyIndex: number,
64
76
  ): Promise<DecryptDataResponseMessage['data']>;
65
77
  on<E extends keyof E2EEManagerCallbacks>(event: E, listener: E2EEManagerCallbacks[E]): this;
78
+ off<E extends keyof E2EEManagerCallbacks>(event: E, listener: E2EEManagerCallbacks[E]): this;
66
79
  dispose?(): void;
67
80
  }
68
81
 
@@ -75,7 +88,7 @@ export class E2EEManager
75
88
  {
76
89
  protected worker: Worker;
77
90
 
78
- protected room?: Room;
91
+ protected room?: CoreRoom;
79
92
 
80
93
  private encryptionEnabled: boolean;
81
94
 
@@ -131,7 +144,7 @@ export class E2EEManager
131
144
  /**
132
145
  * @internal
133
146
  */
134
- setup(room: Room) {
147
+ setup(room: CoreRoom) {
135
148
  if (!isE2EESupported()) {
136
149
  throw new DeviceUnsupportedError(
137
150
  'tried to setup end-to-end encryption on an unsupported browser',
@@ -229,11 +242,21 @@ export class E2EEManager
229
242
  }
230
243
 
231
244
  /**
245
+ * Sets whether the local participant encrypts.
232
246
  * @internal
233
247
  */
234
- setParticipantCryptorEnabled(enabled: boolean, participantIdentity: string) {
235
- this.log.debug(`set e2ee to ${enabled} for participant ${participantIdentity}`);
236
- this.postEnable(enabled, participantIdentity);
248
+ setLocalParticipantCryptorEnabled(enabled: boolean) {
249
+ this.log.debug(`set e2ee to ${enabled} for the local participant`);
250
+ this.postEnable(enabled, this.room?.localParticipant.identity ?? '', true);
251
+ }
252
+
253
+ /**
254
+ * @internal
255
+ * @deprecated use `setLocalParticipantCryptorEnabled`. The identity is ignored: this always
256
+ * sets the state of the local participant.
257
+ */
258
+ setParticipantCryptorEnabled(enabled: boolean, _participantIdentity: string) {
259
+ this.setLocalParticipantCryptorEnabled(enabled);
237
260
  }
238
261
 
239
262
  /**
@@ -284,16 +307,15 @@ export class E2EEManager
284
307
  this.postKey(keyInfo, false);
285
308
  });
286
309
  }
287
- if (
288
- this.encryptionEnabled !== data.enabled &&
289
- data.participantIdentity === this.room?.localParticipant.identity
290
- ) {
291
- this.emit(
292
- EncryptionEvent.ParticipantEncryptionStatusChanged,
293
- data.enabled,
294
- this.room!.localParticipant,
295
- );
296
- this.encryptionEnabled = data.enabled;
310
+ if (data.local) {
311
+ if (this.encryptionEnabled !== data.enabled) {
312
+ this.emit(
313
+ EncryptionEvent.ParticipantEncryptionStatusChanged,
314
+ data.enabled,
315
+ this.room!.localParticipant,
316
+ );
317
+ this.encryptionEnabled = data.enabled;
318
+ }
297
319
  } else if (data.participantIdentity) {
298
320
  const participant = this.room?.getParticipantByIdentity(data.participantIdentity);
299
321
  if (!participant) {
@@ -374,7 +396,7 @@ export class E2EEManager
374
396
  });
375
397
  }
376
398
 
377
- private setupEventListeners(room: Room, keyProvider: BaseKeyProvider) {
399
+ private setupEventListeners(room: CoreRoom, keyProvider: BaseKeyProvider) {
378
400
  room.on(RoomEvent.TrackPublished, (pub, participant) =>
379
401
  this.setParticipantCryptorEnabledForPublication(pub, participant.identity),
380
402
  );
@@ -409,10 +431,7 @@ export class E2EEManager
409
431
  keyProvider.getKeys().forEach((keyInfo) => {
410
432
  this.postKey(keyInfo, latestKeyIndex === (keyInfo.keyIndex ?? 0));
411
433
  });
412
- this.setParticipantCryptorEnabled(
413
- this.room.localParticipant.isE2EEEnabled,
414
- this.room.localParticipant.identity,
415
- );
434
+ this.setLocalParticipantCryptorEnabled(this.room.localParticipant.isE2EEEnabled);
416
435
  });
417
436
 
418
437
  room.localParticipant.on(ParticipantEvent.LocalSenderCreated, async (sender, track) => {
@@ -431,6 +450,7 @@ export class E2EEManager
431
450
  codec: mimeTypeToVideoCodecString(publication.trackInfo!.codecs[0].mimeType),
432
451
  participantIdentity: this.room!.localParticipant.identity,
433
452
  hasPacketTrailer: false,
453
+ operation: 'encode',
434
454
  },
435
455
  };
436
456
 
@@ -528,13 +548,14 @@ export class E2EEManager
528
548
  this.worker.postMessage(msg);
529
549
  }
530
550
 
531
- private postEnable(enabled: boolean, participantIdentity: string) {
551
+ private postEnable(enabled: boolean, participantIdentity: string, local = false) {
532
552
  if (this.worker) {
533
553
  const enableMsg: EnableMessage = {
534
554
  kind: 'enable',
535
555
  data: {
536
556
  enabled,
537
557
  participantIdentity,
558
+ local,
538
559
  },
539
560
  };
540
561
  this.worker.postMessage(enableMsg);
@@ -589,10 +610,7 @@ export class E2EEManager
589
610
  });
590
611
  return;
591
612
  }
592
- this.setParticipantCryptorEnabled(
593
- pub.trackInfo.encryption !== Encryption_Type.NONE,
594
- participantIdentity,
595
- );
613
+ this.postEnable(pub.trackInfo.encryption !== Encryption_Type.NONE, participantIdentity);
596
614
  }
597
615
 
598
616
  private setupE2EEReceiver(track: RemoteTrack, remoteId: string, trackInfo?: TrackInfo) {
@@ -612,6 +630,7 @@ export class E2EEManager
612
630
  remoteId,
613
631
  track.kind === 'video' ? mimeTypeToVideoCodecString(trackInfo.mimeType) : undefined,
614
632
  hasPacketTrailer,
633
+ trackInfo.encryption !== Encryption_Type.NONE,
615
634
  );
616
635
  }
617
636
 
@@ -628,9 +647,7 @@ export class E2EEManager
628
647
  sender,
629
648
  track.mediaStreamID,
630
649
  publishedCodec === 'h264' || publishedCodec === 'h265' ? publishedCodec : undefined,
631
- isVideo
632
- ? (track.publishOptions?.frameMetadata ?? track.publishOptions?.packetTrailer)
633
- : undefined,
650
+ isVideo ? getPublishFrameMetadata(track.publishOptions) : undefined,
634
651
  );
635
652
  }
636
653
 
@@ -645,6 +662,7 @@ export class E2EEManager
645
662
  participantIdentity: string,
646
663
  codec: VideoCodec | undefined,
647
664
  hasPacketTrailer: boolean,
665
+ encrypted: boolean,
648
666
  ) {
649
667
  if (!this.worker) {
650
668
  return;
@@ -657,6 +675,7 @@ export class E2EEManager
657
675
  trackId,
658
676
  codec,
659
677
  hasPacketTrailer,
678
+ encrypted,
660
679
  };
661
680
  receiver.transform = new RTCRtpScriptTransform(this.worker, options);
662
681
  } else {
@@ -675,6 +694,7 @@ export class E2EEManager
675
694
  codec,
676
695
  participantIdentity,
677
696
  hasPacketTrailer,
697
+ encrypted,
678
698
  },
679
699
  };
680
700
  this.worker.postMessage(msg);
@@ -706,6 +726,7 @@ export class E2EEManager
706
726
  codec,
707
727
  participantIdentity: participantIdentity,
708
728
  hasPacketTrailer,
729
+ encrypted,
709
730
  },
710
731
  };
711
732
  this.worker.postMessage(msg, [readable, writable]);
@@ -57,7 +57,8 @@ export class BaseKeyProvider extends (EventEmitter as new () => TypedEventEmitte
57
57
  participantId?: string,
58
58
  keyIndex?: number,
59
59
  ) => {
60
- log.debug('key ratcheted event received', { ratchetResult, participantId, keyIndex });
60
+ // ratchetResult holds key material, so it stays out of the log.
61
+ log.debug('key ratcheted event received', { participantId, keyIndex });
61
62
  };
62
63
 
63
64
  getKeys() {
@@ -0,0 +1,113 @@
1
+ import { Mutex } from '@livekit/mutex';
2
+ import type { CoreRoom } from '../room/CoreRoom';
3
+ import { RoomEvent } from '../room/events';
4
+ import {
5
+ type Disposable,
6
+ type ExtensionContext,
7
+ type RoomApiProvider,
8
+ type SlotProvider,
9
+ defineExtension,
10
+ } from '../room/extensions';
11
+ import type Participant from '../room/participant/Participant';
12
+ import { isLocalParticipant } from '../room/utils';
13
+ import { type BaseE2EEManager, E2EEManager } from './E2eeManager';
14
+ import { EncryptionEvent } from './events';
15
+ import type { E2EEOptions } from './types';
16
+
17
+ /**
18
+ * Methods the `e2ee` extension adds to the room.
19
+ * @experimental
20
+ */
21
+ export interface E2eeRoomApi {
22
+ /**
23
+ * @experimental
24
+ */
25
+ setE2EEEnabled(enabled: boolean): Promise<void>;
26
+ }
27
+
28
+ /** @experimental */
29
+ export const e2ee = /* @__PURE__ */ defineExtension(
30
+ 'e2ee',
31
+ [],
32
+ (
33
+ room: CoreRoom,
34
+ _ctx: ExtensionContext,
35
+ options: E2EEOptions | undefined,
36
+ ): RoomApiProvider<E2eeRoomApi> &
37
+ Partial<SlotProvider<'e2eeManager'>> &
38
+ Disposable & { manager: BaseE2EEManager | undefined } => {
39
+ const dcEncryptionEnabled = !room.options.e2ee;
40
+ const e2eeOptions: E2EEOptions | undefined =
41
+ options ?? (room.options.encryption || room.options.e2ee);
42
+
43
+ let manager: BaseE2EEManager | undefined;
44
+ // an app-supplied manager (and its worker) can be shared between rooms; the app owns it
45
+ let dispose = () => {};
46
+ if (e2eeOptions) {
47
+ if ('e2eeManager' in e2eeOptions) {
48
+ manager = e2eeOptions.e2eeManager;
49
+ manager.isDataChannelEncryptionEnabled = dcEncryptionEnabled;
50
+ } else {
51
+ const owned = new E2EEManager(e2eeOptions, dcEncryptionEnabled);
52
+ manager = owned;
53
+ dispose = () => {
54
+ owned.dispose();
55
+ e2eeOptions.worker.terminate();
56
+ };
57
+ }
58
+ const onStatusChanged = (enabled: boolean, participant: Participant) => {
59
+ if (isLocalParticipant(participant)) {
60
+ room.isE2EEEnabled = enabled;
61
+ }
62
+ room.emit(RoomEvent.ParticipantEncryptionStatusChanged, enabled, participant);
63
+ };
64
+ const onError = (error: Error, participantIdentity?: string) => {
65
+ const participant = participantIdentity
66
+ ? room.getParticipantByIdentity(participantIdentity)
67
+ : undefined;
68
+ room.emit(RoomEvent.EncryptionError, error, participant);
69
+ };
70
+ manager.on(EncryptionEvent.ParticipantEncryptionStatusChanged, onStatusChanged);
71
+ manager.on(EncryptionEvent.EncryptionError, onError);
72
+ if ('e2eeManager' in e2eeOptions) {
73
+ // the app's manager outlives this room: take this room's listeners off it
74
+ const shared = manager;
75
+ dispose = () => {
76
+ shared.off(EncryptionEvent.ParticipantEncryptionStatusChanged, onStatusChanged);
77
+ shared.off(EncryptionEvent.EncryptionError, onError);
78
+ };
79
+ }
80
+ manager.setup(room);
81
+ manager.setupEngine(room.engine);
82
+ }
83
+
84
+ const stateMutex = new Mutex();
85
+ return {
86
+ manager,
87
+ e2eeManager: manager,
88
+ room: {
89
+ setE2EEEnabled: async (enabled) => {
90
+ const unlock = await stateMutex.lock();
91
+ try {
92
+ if (manager) {
93
+ if (room.isE2EEEnabled !== enabled) {
94
+ await room.localParticipant.setE2EEEnabled(enabled);
95
+
96
+ if (manager.setLocalParticipantCryptorEnabled) {
97
+ manager.setLocalParticipantCryptorEnabled(enabled);
98
+ } else if (room.localParticipant.identity !== '') {
99
+ manager.setParticipantCryptorEnabled(enabled, room.localParticipant.identity);
100
+ }
101
+ }
102
+ } else {
103
+ throw Error('e2ee not configured, please set e2ee settings within the room options');
104
+ }
105
+ } finally {
106
+ unlock();
107
+ }
108
+ },
109
+ },
110
+ dispose,
111
+ };
112
+ },
113
+ );
@@ -1,6 +1,6 @@
1
1
  import { Encryption_Type, ParticipantInfo, TrackInfo, TrackType } from '@livekit/protocol';
2
2
  import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
3
- import Room, { ConnectionState } from '../room/Room';
3
+ import { ConnectionState, Room } from '../room/Room';
4
4
  import { EngineEvent, RoomEvent } from '../room/events';
5
5
  import type RemoteParticipant from '../room/participant/RemoteParticipant';
6
6
  import RemoteTrackPublication from '../room/track/RemoteTrackPublication';
@@ -127,13 +127,10 @@ function setupRoomWithE2EE() {
127
127
  }
128
128
 
129
129
  describe('subscriber black screen', () => {
130
- beforeEach(() => {
131
- encryptionEnabledMap.clear();
132
- });
130
+ beforeEach(() => {});
133
131
 
134
132
  afterEach(() => {
135
133
  vi.restoreAllMocks();
136
- encryptionEnabledMap.clear();
137
134
  });
138
135
 
139
136
  // -------------------------------------------------------------------------
@@ -243,7 +240,6 @@ describe('subscriber black screen', () => {
243
240
  it('rebuilds a dead pipeline instead of leaving the track undecrypted', async () => {
244
241
  const keys = new ParticipantKeyHandler('jake', KEY_PROVIDER_DEFAULTS);
245
242
  await keys.setKey(await createKeyMaterialFromString('shared-password'), 0);
246
- encryptionEnabledMap.set('jake', true);
247
243
 
248
244
  const cryptor = new FrameCryptor({
249
245
  participantIdentity: 'jake',
@@ -251,6 +247,7 @@ describe('subscriber black screen', () => {
251
247
  keyProviderOptions: KEY_PROVIDER_DEFAULTS,
252
248
  sifTrailer: new Uint8Array(),
253
249
  });
250
+ cryptor.setEncrypted(true);
254
251
 
255
252
  // a pipeline whose readable ends on its own, e.g. the swallowed
256
253
  // 'Destination stream closed'
@@ -282,7 +279,6 @@ describe('subscriber black screen', () => {
282
279
  it('must not forward ciphertext to the decoder', async () => {
283
280
  const keys = new ParticipantKeyHandler('jake', KEY_PROVIDER_DEFAULTS);
284
281
  await keys.setKey(await createKeyMaterialFromString('shared-password'), 0);
285
- encryptionEnabledMap.set('jake', true);
286
282
 
287
283
  const cryptor = new FrameCryptor({
288
284
  participantIdentity: 'jake',
@@ -290,6 +286,7 @@ describe('subscriber black screen', () => {
290
286
  keyProviderOptions: KEY_PROVIDER_DEFAULTS,
291
287
  sifTrailer: new Uint8Array(),
292
288
  });
289
+ cryptor.setEncrypted(true);
293
290
 
294
291
  const frames: RTCEncodedVideoFrame[] = [];
295
292
  let push!: (f: RTCEncodedVideoFrame) => void;
@@ -337,7 +334,6 @@ describe('subscriber black screen', () => {
337
334
  it('drops silently rather than reporting an error on a normal disconnect', async () => {
338
335
  const keys = new ParticipantKeyHandler('jake', KEY_PROVIDER_DEFAULTS);
339
336
  await keys.setKey(await createKeyMaterialFromString('shared-password'), 0);
340
- encryptionEnabledMap.set('jake', true);
341
337
 
342
338
  const cryptor = new FrameCryptor({
343
339
  participantIdentity: 'jake',
@@ -345,6 +341,7 @@ describe('subscriber black screen', () => {
345
341
  keyProviderOptions: KEY_PROVIDER_DEFAULTS,
346
342
  sifTrailer: new Uint8Array(),
347
343
  });
344
+ cryptor.setEncrypted(true);
348
345
 
349
346
  const errors: Error[] = [];
350
347
  cryptor.on(CryptorEvent.Error, (e) => errors.push(e));
@@ -386,7 +383,6 @@ describe('subscriber black screen', () => {
386
383
  const keys = new ParticipantKeyHandler('bob', KEY_PROVIDER_DEFAULTS);
387
384
  await keys.setKey(await createKeyMaterialFromString('shared-password'), 0);
388
385
  // explicitly NOT encrypted, as opposed to "we don't know yet"
389
- encryptionEnabledMap.set('bob', false);
390
386
 
391
387
  const cryptor = new FrameCryptor({
392
388
  participantIdentity: 'bob',
@@ -394,6 +390,7 @@ describe('subscriber black screen', () => {
394
390
  keyProviderOptions: KEY_PROVIDER_DEFAULTS,
395
391
  sifTrailer: new Uint8Array(),
396
392
  });
393
+ cryptor.setEncrypted(false);
397
394
 
398
395
  const frames: RTCEncodedVideoFrame[] = [];
399
396
  let push!: (f: RTCEncodedVideoFrame) => void;
@@ -430,7 +427,6 @@ describe('subscriber black screen', () => {
430
427
  vi.useFakeTimers();
431
428
  try {
432
429
  const keys = new ParticipantKeyHandler('jake', KEY_PROVIDER_DEFAULTS);
433
- encryptionEnabledMap.set('jake', true);
434
430
 
435
431
  const cryptor = new FrameCryptor({
436
432
  participantIdentity: 'jake',
@@ -438,6 +434,7 @@ describe('subscriber black screen', () => {
438
434
  keyProviderOptions: KEY_PROVIDER_DEFAULTS,
439
435
  sifTrailer: new Uint8Array(),
440
436
  });
437
+ cryptor.setEncrypted(true);
441
438
 
442
439
  const errors: Error[] = [];
443
440
  cryptor.on(CryptorEvent.Error, (e) => errors.push(e));
@@ -468,7 +465,6 @@ describe('subscriber black screen', () => {
468
465
  vi.useFakeTimers();
469
466
  try {
470
467
  const keys = new ParticipantKeyHandler('me', KEY_PROVIDER_DEFAULTS);
471
- encryptionEnabledMap.set('me', true);
472
468
 
473
469
  const cryptor = new FrameCryptor({
474
470
  participantIdentity: 'me',
@@ -476,6 +472,7 @@ describe('subscriber black screen', () => {
476
472
  keyProviderOptions: KEY_PROVIDER_DEFAULTS,
477
473
  sifTrailer: new Uint8Array(),
478
474
  });
475
+ cryptor.setEncrypted(true);
479
476
 
480
477
  const errors: Error[] = [];
481
478
  cryptor.on(CryptorEvent.Error, (e) => errors.push(e));
@@ -506,7 +503,6 @@ describe('subscriber black screen', () => {
506
503
  vi.useFakeTimers();
507
504
  try {
508
505
  const keys = new ParticipantKeyHandler('jake', KEY_PROVIDER_DEFAULTS);
509
- encryptionEnabledMap.set('jake', true);
510
506
 
511
507
  const cryptor = new FrameCryptor({
512
508
  participantIdentity: 'jake',
@@ -514,6 +510,7 @@ describe('subscriber black screen', () => {
514
510
  keyProviderOptions: KEY_PROVIDER_DEFAULTS,
515
511
  sifTrailer: new Uint8Array(),
516
512
  });
513
+ cryptor.setEncrypted(true);
517
514
 
518
515
  const errors: Error[] = [];
519
516
  cryptor.on(CryptorEvent.Error, (e) => errors.push(e));
package/src/e2ee/types.ts CHANGED
@@ -53,6 +53,8 @@ export interface EncodeMessage extends BaseMessage {
53
53
  writableStream: WritableStream;
54
54
  trackId: string;
55
55
  codec?: VideoCodec;
56
+ /** whether the publication of a received track is marked encrypted, unused on encode */
57
+ encrypted?: boolean;
56
58
  /**
57
59
  * Whether the published track advertises packet trailer features.
58
60
  * When false, the cryptor skips the per-frame trailer extraction path
@@ -89,6 +91,10 @@ export interface UpdateCodecMessage extends BaseMessage {
89
91
  */
90
92
  previousTrackId?: string;
91
93
  hasPacketTrailer: boolean;
94
+ /** whether the publication of a received track is marked encrypted, unused on encode */
95
+ encrypted?: boolean;
96
+ /** which cryptor the update is for, a receiver's ('decode') when omitted */
97
+ operation?: 'encode' | 'decode';
92
98
  };
93
99
  }
94
100
 
@@ -123,6 +129,11 @@ export interface EnableMessage extends BaseMessage {
123
129
  data: {
124
130
  participantIdentity: string;
125
131
  enabled: boolean;
132
+ /**
133
+ * Set when the app enables or disables encryption for the local participant. Only such a
134
+ * message changes whether local media is encrypted.
135
+ */
136
+ local?: boolean;
126
137
  };
127
138
  }
128
139
 
@@ -244,6 +255,7 @@ export type KeyInfo = {
244
255
 
245
256
  export type E2EEManagerOptions = {
246
257
  keyProvider: BaseKeyProvider;
258
+ /** The worker holds the encryption state of one room. Do not share it between rooms. */
247
259
  worker: Worker;
248
260
  };
249
261
 
@@ -266,6 +278,8 @@ export type ScriptTransformOptions = {
266
278
  participantIdentity: string;
267
279
  trackId: string;
268
280
  codec?: VideoCodec;
281
+ /** whether the publication of a received track is marked encrypted, unused on encode */
282
+ encrypted?: boolean;
269
283
  /**
270
284
  * Whether the published track advertises packet trailer features.
271
285
  * When false, the cryptor skips the per-frame trailer extraction path
@@ -0,0 +1,47 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { writeRbsp } from './utils';
3
+
4
+ describe('writeRbsp', () => {
5
+ it('inserts an emulation prevention byte before every byte <= 3 after two zeros', () => {
6
+ const cases: Array<[number[], number[]]> = [
7
+ // No escapes.
8
+ [[], []],
9
+ [
10
+ [0x00, 0x04, 0x00, 0x00, 0x04, 0xff],
11
+ [0x00, 0x04, 0x00, 0x00, 0x04, 0xff],
12
+ ],
13
+ // One escape.
14
+ [
15
+ [0x11, 0x00, 0x00, 0x01, 0x22],
16
+ [0x11, 0x00, 0x00, 0x03, 0x01, 0x22],
17
+ ],
18
+ // Consecutive zero runs: the zero count resets after each escape.
19
+ [
20
+ [0x00, 0x00, 0x00, 0x00, 0x00, 0x02],
21
+ [0x00, 0x00, 0x03, 0x00, 0x00, 0x03, 0x00, 0x02],
22
+ ],
23
+ [
24
+ [0x00, 0x00, 0x03, 0x00, 0x00, 0x00],
25
+ [0x00, 0x00, 0x03, 0x03, 0x00, 0x00, 0x03, 0x00],
26
+ ],
27
+ // Trailing zeros are not escaped, because no byte follows them.
28
+ [
29
+ [0xaa, 0x00, 0x00],
30
+ [0xaa, 0x00, 0x00],
31
+ ],
32
+ [
33
+ [0xaa, 0x00, 0x00, 0x00, 0x00],
34
+ [0xaa, 0x00, 0x00, 0x03, 0x00, 0x00],
35
+ ],
36
+ ];
37
+
38
+ for (const [input, expected] of cases) {
39
+ expect(writeRbsp(new Uint8Array(input))).toEqual(new Uint8Array(expected));
40
+ }
41
+ });
42
+
43
+ it('returns the input itself when nothing needs escaping', () => {
44
+ const input = new Uint8Array([0x00, 0x00, 0x04, 0xff]);
45
+ expect(writeRbsp(input)).toBe(input);
46
+ });
47
+ });
package/src/e2ee/utils.ts CHANGED
@@ -161,24 +161,36 @@ export function parseRbsp(stream: NonSharedUint8Array): NonSharedUint8Array {
161
161
  const kZerosInStartSequence = 2;
162
162
  const kEmulationByte = 3;
163
163
 
164
- export function writeRbsp(data_in: NonSharedUint8Array): NonSharedUint8Array {
165
- const dataOut: number[] = [];
166
- var numConsecutiveZeros = 0;
167
- for (var i = 0; i < data_in.length; ++i) {
168
- var byte = data_in[i];
164
+ /**
165
+ * Inserts an emulation prevention byte before every byte <= 3 that follows two zeros.
166
+ * Returns `dataIn` itself when nothing needs escaping, which is the case for almost
167
+ * every encrypted frame. Callers must not mutate the result in place.
168
+ */
169
+ export function writeRbsp(dataIn: NonSharedUint8Array): NonSharedUint8Array {
170
+ // Indices of the bytes that need an emulation byte in front of them.
171
+ const escapes: number[] = [];
172
+ let numConsecutiveZeros = 0;
173
+ for (let i = 0; i < dataIn.length; ++i) {
174
+ const byte = dataIn[i];
169
175
  if (byte <= kEmulationByte && numConsecutiveZeros >= kZerosInStartSequence) {
170
- // Need to escape.
171
- dataOut.push(kEmulationByte);
172
- numConsecutiveZeros = 0;
173
- }
174
- dataOut.push(byte);
175
- if (byte == 0) {
176
- ++numConsecutiveZeros;
177
- } else {
176
+ escapes.push(i);
178
177
  numConsecutiveZeros = 0;
179
178
  }
179
+ numConsecutiveZeros = byte === 0 ? numConsecutiveZeros + 1 : 0;
180
180
  }
181
- return new Uint8Array(dataOut);
181
+ if (escapes.length === 0) {
182
+ return dataIn;
183
+ }
184
+ const dataOut = new Uint8Array(dataIn.length + escapes.length);
185
+ let from = 0;
186
+ for (let k = 0; k < escapes.length; ++k) {
187
+ // Shifted by k for the emulation bytes already written.
188
+ dataOut.set(dataIn.subarray(from, escapes[k]), from + k);
189
+ dataOut[escapes[k] + k] = kEmulationByte;
190
+ from = escapes[k];
191
+ }
192
+ dataOut.set(dataIn.subarray(from), from + escapes.length);
193
+ return dataOut;
182
194
  }
183
195
 
184
196
  export function asEncryptablePacket(packet: DataPacket): EncryptedPacketPayload | undefined {
@@ -126,7 +126,7 @@ describe('DataCryptor', () => {
126
126
  const plainData = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);
127
127
 
128
128
  // Sender ratchets their key forward
129
- await senderKeys.ratchetKey(1, false);
129
+ await senderKeys.ratchetKey(1);
130
130
 
131
131
  // Sender encrypts data with the ratcheted key
132
132
  const encrypted = await DataCryptor.encrypt(plainData, senderKeys);
@@ -142,6 +142,47 @@ describe('DataCryptor', () => {
142
142
  expect(decrypted.payload).toEqual(plainData);
143
143
  });
144
144
 
145
+ it('keeps the ratcheted key after decrypting a packet from a ratcheted sender', async () => {
146
+ const senderKeys = prepareParticipantTestKeys('sender', {
147
+ ratchetWindowSize: 4,
148
+ });
149
+ const receiverKeys = prepareParticipantTestKeys('receiver', {
150
+ ratchetWindowSize: 4,
151
+ });
152
+
153
+ const initialMaterial = await createKeyMaterialFromString('test-key');
154
+ await senderKeys.setKey(initialMaterial, 1);
155
+ await receiverKeys.setKey(initialMaterial, 1);
156
+ const receiverInitialKeySet = receiverKeys.getKeySet(1);
157
+
158
+ // Sender ratchets once, so the receiver is one ratchet step behind
159
+ await senderKeys.ratchetKey(1);
160
+
161
+ const first = new Uint8Array([1, 2, 3, 4]);
162
+ const encryptedFirst = await DataCryptor.encrypt(first, senderKeys);
163
+ const decryptedFirst = await DataCryptor.decrypt(
164
+ encryptedFirst.payload,
165
+ encryptedFirst.iv,
166
+ receiverKeys,
167
+ encryptedFirst.keyIndex,
168
+ );
169
+ expect(decryptedFirst.payload).toEqual(first);
170
+
171
+ // The receiver now stores the ratcheted key, so a later packet decrypts without ratcheting
172
+ expect(receiverKeys.getKeySet(1)).not.toBe(receiverInitialKeySet);
173
+ const ratchetSpy = vitest.spyOn(receiverKeys, 'ratchetKey');
174
+ const second = new Uint8Array([5, 6, 7, 8]);
175
+ const encryptedSecond = await DataCryptor.encrypt(second, senderKeys);
176
+ const decryptedSecond = await DataCryptor.decrypt(
177
+ encryptedSecond.payload,
178
+ encryptedSecond.iv,
179
+ receiverKeys,
180
+ encryptedSecond.keyIndex,
181
+ );
182
+ expect(decryptedSecond.payload).toEqual(second);
183
+ expect(ratchetSpy).not.toHaveBeenCalled();
184
+ });
185
+
145
186
  it('respects ratchet window size limit', async () => {
146
187
  // Create a scenario where we have valid encrypted data that requires ratcheting but it's disabled
147
188
  const senderKeys = prepareParticipantTestKeys('sender', {