matterbridge 3.4.7 → 3.5.0-dev-20260113-29ad318

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 (449) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/dist/broadcastServer.d.ts +0 -115
  3. package/dist/broadcastServer.js +0 -117
  4. package/dist/broadcastServerTypes.d.ts +0 -43
  5. package/dist/broadcastServerTypes.js +0 -24
  6. package/dist/cli.d.ts +0 -24
  7. package/dist/cli.js +1 -97
  8. package/dist/cliEmitter.d.ts +0 -36
  9. package/dist/cliEmitter.js +0 -37
  10. package/dist/cliHistory.d.ts +0 -42
  11. package/dist/cliHistory.js +0 -38
  12. package/dist/clusters/export.d.ts +0 -1
  13. package/dist/clusters/export.js +0 -2
  14. package/dist/deviceManager.d.ts +0 -108
  15. package/dist/deviceManager.js +1 -113
  16. package/dist/devices/airConditioner.d.ts +0 -75
  17. package/dist/devices/airConditioner.js +0 -57
  18. package/dist/devices/batteryStorage.d.ts +0 -43
  19. package/dist/devices/batteryStorage.js +1 -48
  20. package/dist/devices/cooktop.d.ts +0 -55
  21. package/dist/devices/cooktop.js +0 -56
  22. package/dist/devices/dishwasher.d.ts +0 -55
  23. package/dist/devices/dishwasher.js +0 -57
  24. package/dist/devices/evse.d.ts +0 -57
  25. package/dist/devices/evse.js +10 -74
  26. package/dist/devices/export.d.ts +0 -1
  27. package/dist/devices/export.js +0 -5
  28. package/dist/devices/extractorHood.d.ts +0 -41
  29. package/dist/devices/extractorHood.js +0 -43
  30. package/dist/devices/heatPump.d.ts +0 -43
  31. package/dist/devices/heatPump.js +2 -50
  32. package/dist/devices/laundryDryer.d.ts +0 -58
  33. package/dist/devices/laundryDryer.js +3 -62
  34. package/dist/devices/laundryWasher.d.ts +0 -64
  35. package/dist/devices/laundryWasher.js +4 -70
  36. package/dist/devices/microwaveOven.d.ts +1 -77
  37. package/dist/devices/microwaveOven.js +5 -88
  38. package/dist/devices/oven.d.ts +0 -82
  39. package/dist/devices/oven.js +0 -85
  40. package/dist/devices/refrigerator.d.ts +0 -100
  41. package/dist/devices/refrigerator.js +0 -102
  42. package/dist/devices/roboticVacuumCleaner.d.ts +0 -83
  43. package/dist/devices/roboticVacuumCleaner.js +9 -100
  44. package/dist/devices/solarPower.d.ts +0 -36
  45. package/dist/devices/solarPower.js +0 -38
  46. package/dist/devices/speaker.d.ts +0 -79
  47. package/dist/devices/speaker.js +0 -84
  48. package/dist/devices/temperatureControl.d.ts +0 -21
  49. package/dist/devices/temperatureControl.js +3 -24
  50. package/dist/devices/waterHeater.d.ts +0 -74
  51. package/dist/devices/waterHeater.js +2 -82
  52. package/dist/dgram/coap.d.ts +0 -171
  53. package/dist/dgram/coap.js +13 -126
  54. package/dist/dgram/dgram.d.ts +0 -99
  55. package/dist/dgram/dgram.js +2 -114
  56. package/dist/dgram/mb_coap.d.ts +0 -23
  57. package/dist/dgram/mb_coap.js +3 -41
  58. package/dist/dgram/mb_mdns.d.ts +0 -23
  59. package/dist/dgram/mb_mdns.js +24 -80
  60. package/dist/dgram/mdns.d.ts +4 -187
  61. package/dist/dgram/mdns.js +139 -371
  62. package/dist/dgram/multicast.d.ts +0 -49
  63. package/dist/dgram/multicast.js +1 -62
  64. package/dist/dgram/unicast.d.ts +0 -53
  65. package/dist/dgram/unicast.js +0 -60
  66. package/dist/frontend.d.ts +0 -187
  67. package/dist/frontend.js +38 -485
  68. package/dist/frontendTypes.d.ts +0 -57
  69. package/dist/frontendTypes.js +0 -45
  70. package/dist/helpers.d.ts +0 -43
  71. package/dist/helpers.js +0 -53
  72. package/dist/index.d.ts +0 -23
  73. package/dist/index.js +0 -25
  74. package/dist/jestutils/export.d.ts +0 -1
  75. package/dist/jestutils/export.js +0 -1
  76. package/dist/jestutils/jestHelpers.d.ts +0 -255
  77. package/dist/jestutils/jestHelpers.js +14 -371
  78. package/dist/logger/export.d.ts +0 -1
  79. package/dist/logger/export.js +0 -1
  80. package/dist/matter/behaviors.d.ts +0 -1
  81. package/dist/matter/behaviors.js +0 -2
  82. package/dist/matter/clusters.d.ts +0 -1
  83. package/dist/matter/clusters.js +0 -2
  84. package/dist/matter/devices.d.ts +0 -1
  85. package/dist/matter/devices.js +0 -2
  86. package/dist/matter/endpoints.d.ts +0 -1
  87. package/dist/matter/endpoints.js +0 -2
  88. package/dist/matter/export.d.ts +0 -1
  89. package/dist/matter/export.js +0 -3
  90. package/dist/matter/types.d.ts +0 -1
  91. package/dist/matter/types.js +0 -3
  92. package/dist/matterNode.d.ts +0 -258
  93. package/dist/matterNode.js +8 -369
  94. package/dist/matterbridge.d.ts +0 -353
  95. package/dist/matterbridge.js +46 -824
  96. package/dist/matterbridgeAccessoryPlatform.d.ts +0 -36
  97. package/dist/matterbridgeAccessoryPlatform.js +0 -38
  98. package/dist/matterbridgeBehaviors.d.ts +0 -24
  99. package/dist/matterbridgeBehaviors.js +5 -68
  100. package/dist/matterbridgeDeviceTypes.d.ts +0 -603
  101. package/dist/matterbridgeDeviceTypes.js +14 -635
  102. package/dist/matterbridgeDynamicPlatform.d.ts +0 -36
  103. package/dist/matterbridgeDynamicPlatform.js +0 -38
  104. package/dist/matterbridgeEndpoint.d.ts +0 -1332
  105. package/dist/matterbridgeEndpoint.js +53 -1457
  106. package/dist/matterbridgeEndpointHelpers.d.ts +0 -425
  107. package/dist/matterbridgeEndpointHelpers.js +20 -483
  108. package/dist/matterbridgeEndpointTypes.d.ts +0 -70
  109. package/dist/matterbridgeEndpointTypes.js +0 -25
  110. package/dist/matterbridgePlatform.d.ts +0 -425
  111. package/dist/matterbridgePlatform.js +1 -451
  112. package/dist/matterbridgeTypes.d.ts +0 -46
  113. package/dist/matterbridgeTypes.js +0 -26
  114. package/dist/pluginManager.d.ts +0 -305
  115. package/dist/pluginManager.js +5 -341
  116. package/dist/shelly.d.ts +0 -157
  117. package/dist/shelly.js +7 -178
  118. package/dist/storage/export.d.ts +0 -1
  119. package/dist/storage/export.js +0 -1
  120. package/dist/update.d.ts +0 -75
  121. package/dist/update.js +1 -93
  122. package/dist/utils/colorUtils.d.ts +0 -77
  123. package/dist/utils/colorUtils.js +2 -97
  124. package/dist/utils/commandLine.d.ts +0 -60
  125. package/dist/utils/commandLine.js +0 -60
  126. package/dist/utils/copyDirectory.d.ts +0 -33
  127. package/dist/utils/copyDirectory.js +0 -37
  128. package/dist/utils/createDirectory.d.ts +0 -32
  129. package/dist/utils/createDirectory.js +0 -33
  130. package/dist/utils/createZip.d.ts +0 -38
  131. package/dist/utils/createZip.js +2 -47
  132. package/dist/utils/deepCopy.d.ts +0 -31
  133. package/dist/utils/deepCopy.js +0 -39
  134. package/dist/utils/deepEqual.d.ts +0 -53
  135. package/dist/utils/deepEqual.js +1 -72
  136. package/dist/utils/error.d.ts +0 -42
  137. package/dist/utils/error.js +0 -42
  138. package/dist/utils/export.d.ts +0 -1
  139. package/dist/utils/export.js +0 -1
  140. package/dist/utils/format.d.ts +0 -49
  141. package/dist/utils/format.js +0 -49
  142. package/dist/utils/hex.d.ts +0 -85
  143. package/dist/utils/hex.js +0 -124
  144. package/dist/utils/inspector.d.ts +0 -63
  145. package/dist/utils/inspector.js +1 -69
  146. package/dist/utils/isValid.d.ts +0 -93
  147. package/dist/utils/isValid.js +0 -93
  148. package/dist/utils/network.d.ts +0 -116
  149. package/dist/utils/network.js +5 -126
  150. package/dist/utils/spawn.d.ts +0 -32
  151. package/dist/utils/spawn.js +1 -71
  152. package/dist/utils/tracker.d.ts +0 -56
  153. package/dist/utils/tracker.js +1 -64
  154. package/dist/utils/wait.d.ts +0 -51
  155. package/dist/utils/wait.js +8 -60
  156. package/dist/workerGlobalPrefix.d.ts +0 -24
  157. package/dist/workerGlobalPrefix.js +5 -37
  158. package/dist/workerTypes.d.ts +0 -25
  159. package/dist/workerTypes.js +0 -24
  160. package/dist/workers.d.ts +0 -61
  161. package/dist/workers.js +4 -68
  162. package/npm-shrinkwrap.json +1500 -11420
  163. package/package.json +10 -7
  164. package/dist/broadcastServer.d.ts.map +0 -1
  165. package/dist/broadcastServer.js.map +0 -1
  166. package/dist/broadcastServerTypes.d.ts.map +0 -1
  167. package/dist/broadcastServerTypes.js.map +0 -1
  168. package/dist/cli.d.ts.map +0 -1
  169. package/dist/cli.js.map +0 -1
  170. package/dist/cliEmitter.d.ts.map +0 -1
  171. package/dist/cliEmitter.js.map +0 -1
  172. package/dist/cliHistory.d.ts.map +0 -1
  173. package/dist/cliHistory.js.map +0 -1
  174. package/dist/clusters/export.d.ts.map +0 -1
  175. package/dist/clusters/export.js.map +0 -1
  176. package/dist/deviceManager.d.ts.map +0 -1
  177. package/dist/deviceManager.js.map +0 -1
  178. package/dist/devices/airConditioner.d.ts.map +0 -1
  179. package/dist/devices/airConditioner.js.map +0 -1
  180. package/dist/devices/batteryStorage.d.ts.map +0 -1
  181. package/dist/devices/batteryStorage.js.map +0 -1
  182. package/dist/devices/cooktop.d.ts.map +0 -1
  183. package/dist/devices/cooktop.js.map +0 -1
  184. package/dist/devices/dishwasher.d.ts.map +0 -1
  185. package/dist/devices/dishwasher.js.map +0 -1
  186. package/dist/devices/evse.d.ts.map +0 -1
  187. package/dist/devices/evse.js.map +0 -1
  188. package/dist/devices/export.d.ts.map +0 -1
  189. package/dist/devices/export.js.map +0 -1
  190. package/dist/devices/extractorHood.d.ts.map +0 -1
  191. package/dist/devices/extractorHood.js.map +0 -1
  192. package/dist/devices/heatPump.d.ts.map +0 -1
  193. package/dist/devices/heatPump.js.map +0 -1
  194. package/dist/devices/laundryDryer.d.ts.map +0 -1
  195. package/dist/devices/laundryDryer.js.map +0 -1
  196. package/dist/devices/laundryWasher.d.ts.map +0 -1
  197. package/dist/devices/laundryWasher.js.map +0 -1
  198. package/dist/devices/microwaveOven.d.ts.map +0 -1
  199. package/dist/devices/microwaveOven.js.map +0 -1
  200. package/dist/devices/oven.d.ts.map +0 -1
  201. package/dist/devices/oven.js.map +0 -1
  202. package/dist/devices/refrigerator.d.ts.map +0 -1
  203. package/dist/devices/refrigerator.js.map +0 -1
  204. package/dist/devices/roboticVacuumCleaner.d.ts.map +0 -1
  205. package/dist/devices/roboticVacuumCleaner.js.map +0 -1
  206. package/dist/devices/solarPower.d.ts.map +0 -1
  207. package/dist/devices/solarPower.js.map +0 -1
  208. package/dist/devices/speaker.d.ts.map +0 -1
  209. package/dist/devices/speaker.js.map +0 -1
  210. package/dist/devices/temperatureControl.d.ts.map +0 -1
  211. package/dist/devices/temperatureControl.js.map +0 -1
  212. package/dist/devices/waterHeater.d.ts.map +0 -1
  213. package/dist/devices/waterHeater.js.map +0 -1
  214. package/dist/dgram/coap.d.ts.map +0 -1
  215. package/dist/dgram/coap.js.map +0 -1
  216. package/dist/dgram/dgram.d.ts.map +0 -1
  217. package/dist/dgram/dgram.js.map +0 -1
  218. package/dist/dgram/mb_coap.d.ts.map +0 -1
  219. package/dist/dgram/mb_coap.js.map +0 -1
  220. package/dist/dgram/mb_mdns.d.ts.map +0 -1
  221. package/dist/dgram/mb_mdns.js.map +0 -1
  222. package/dist/dgram/mdns.d.ts.map +0 -1
  223. package/dist/dgram/mdns.js.map +0 -1
  224. package/dist/dgram/multicast.d.ts.map +0 -1
  225. package/dist/dgram/multicast.js.map +0 -1
  226. package/dist/dgram/unicast.d.ts.map +0 -1
  227. package/dist/dgram/unicast.js.map +0 -1
  228. package/dist/frontend.d.ts.map +0 -1
  229. package/dist/frontend.js.map +0 -1
  230. package/dist/frontendTypes.d.ts.map +0 -1
  231. package/dist/frontendTypes.js.map +0 -1
  232. package/dist/helpers.d.ts.map +0 -1
  233. package/dist/helpers.js.map +0 -1
  234. package/dist/index.d.ts.map +0 -1
  235. package/dist/index.js.map +0 -1
  236. package/dist/jestutils/export.d.ts.map +0 -1
  237. package/dist/jestutils/export.js.map +0 -1
  238. package/dist/jestutils/jestHelpers.d.ts.map +0 -1
  239. package/dist/jestutils/jestHelpers.js.map +0 -1
  240. package/dist/logger/export.d.ts.map +0 -1
  241. package/dist/logger/export.js.map +0 -1
  242. package/dist/matter/behaviors.d.ts.map +0 -1
  243. package/dist/matter/behaviors.js.map +0 -1
  244. package/dist/matter/clusters.d.ts.map +0 -1
  245. package/dist/matter/clusters.js.map +0 -1
  246. package/dist/matter/devices.d.ts.map +0 -1
  247. package/dist/matter/devices.js.map +0 -1
  248. package/dist/matter/endpoints.d.ts.map +0 -1
  249. package/dist/matter/endpoints.js.map +0 -1
  250. package/dist/matter/export.d.ts.map +0 -1
  251. package/dist/matter/export.js.map +0 -1
  252. package/dist/matter/types.d.ts.map +0 -1
  253. package/dist/matter/types.js.map +0 -1
  254. package/dist/matterNode.d.ts.map +0 -1
  255. package/dist/matterNode.js.map +0 -1
  256. package/dist/matterbridge.d.ts.map +0 -1
  257. package/dist/matterbridge.js.map +0 -1
  258. package/dist/matterbridgeAccessoryPlatform.d.ts.map +0 -1
  259. package/dist/matterbridgeAccessoryPlatform.js.map +0 -1
  260. package/dist/matterbridgeBehaviors.d.ts.map +0 -1
  261. package/dist/matterbridgeBehaviors.js.map +0 -1
  262. package/dist/matterbridgeDeviceTypes.d.ts.map +0 -1
  263. package/dist/matterbridgeDeviceTypes.js.map +0 -1
  264. package/dist/matterbridgeDynamicPlatform.d.ts.map +0 -1
  265. package/dist/matterbridgeDynamicPlatform.js.map +0 -1
  266. package/dist/matterbridgeEndpoint.d.ts.map +0 -1
  267. package/dist/matterbridgeEndpoint.js.map +0 -1
  268. package/dist/matterbridgeEndpointHelpers.d.ts.map +0 -1
  269. package/dist/matterbridgeEndpointHelpers.js.map +0 -1
  270. package/dist/matterbridgeEndpointTypes.d.ts.map +0 -1
  271. package/dist/matterbridgeEndpointTypes.js.map +0 -1
  272. package/dist/matterbridgePlatform.d.ts.map +0 -1
  273. package/dist/matterbridgePlatform.js.map +0 -1
  274. package/dist/matterbridgeTypes.d.ts.map +0 -1
  275. package/dist/matterbridgeTypes.js.map +0 -1
  276. package/dist/pluginManager.d.ts.map +0 -1
  277. package/dist/pluginManager.js.map +0 -1
  278. package/dist/shelly.d.ts.map +0 -1
  279. package/dist/shelly.js.map +0 -1
  280. package/dist/storage/export.d.ts.map +0 -1
  281. package/dist/storage/export.js.map +0 -1
  282. package/dist/update.d.ts.map +0 -1
  283. package/dist/update.js.map +0 -1
  284. package/dist/utils/colorUtils.d.ts.map +0 -1
  285. package/dist/utils/colorUtils.js.map +0 -1
  286. package/dist/utils/commandLine.d.ts.map +0 -1
  287. package/dist/utils/commandLine.js.map +0 -1
  288. package/dist/utils/copyDirectory.d.ts.map +0 -1
  289. package/dist/utils/copyDirectory.js.map +0 -1
  290. package/dist/utils/createDirectory.d.ts.map +0 -1
  291. package/dist/utils/createDirectory.js.map +0 -1
  292. package/dist/utils/createZip.d.ts.map +0 -1
  293. package/dist/utils/createZip.js.map +0 -1
  294. package/dist/utils/deepCopy.d.ts.map +0 -1
  295. package/dist/utils/deepCopy.js.map +0 -1
  296. package/dist/utils/deepEqual.d.ts.map +0 -1
  297. package/dist/utils/deepEqual.js.map +0 -1
  298. package/dist/utils/error.d.ts.map +0 -1
  299. package/dist/utils/error.js.map +0 -1
  300. package/dist/utils/export.d.ts.map +0 -1
  301. package/dist/utils/export.js.map +0 -1
  302. package/dist/utils/format.d.ts.map +0 -1
  303. package/dist/utils/format.js.map +0 -1
  304. package/dist/utils/hex.d.ts.map +0 -1
  305. package/dist/utils/hex.js.map +0 -1
  306. package/dist/utils/inspector.d.ts.map +0 -1
  307. package/dist/utils/inspector.js.map +0 -1
  308. package/dist/utils/isValid.d.ts.map +0 -1
  309. package/dist/utils/isValid.js.map +0 -1
  310. package/dist/utils/network.d.ts.map +0 -1
  311. package/dist/utils/network.js.map +0 -1
  312. package/dist/utils/spawn.d.ts.map +0 -1
  313. package/dist/utils/spawn.js.map +0 -1
  314. package/dist/utils/tracker.d.ts.map +0 -1
  315. package/dist/utils/tracker.js.map +0 -1
  316. package/dist/utils/wait.d.ts.map +0 -1
  317. package/dist/utils/wait.js.map +0 -1
  318. package/dist/workerGlobalPrefix.d.ts.map +0 -1
  319. package/dist/workerGlobalPrefix.js.map +0 -1
  320. package/dist/workerTypes.d.ts.map +0 -1
  321. package/dist/workerTypes.js.map +0 -1
  322. package/dist/workers.d.ts.map +0 -1
  323. package/dist/workers.js.map +0 -1
  324. package/frontend/index.html +0 -15
  325. package/frontend/package-lock.json +0 -7553
  326. package/packages/dgram/LICENSE +0 -202
  327. package/packages/dgram/dist/coap.d.ts +0 -205
  328. package/packages/dgram/dist/coap.d.ts.map +0 -1
  329. package/packages/dgram/dist/coap.js +0 -365
  330. package/packages/dgram/dist/coap.js.map +0 -1
  331. package/packages/dgram/dist/dgram.d.ts +0 -144
  332. package/packages/dgram/dist/dgram.d.ts.map +0 -1
  333. package/packages/dgram/dist/dgram.js +0 -367
  334. package/packages/dgram/dist/dgram.js.map +0 -1
  335. package/packages/dgram/dist/export.d.ts +0 -6
  336. package/packages/dgram/dist/export.d.ts.map +0 -1
  337. package/packages/dgram/dist/export.js +0 -6
  338. package/packages/dgram/dist/export.js.map +0 -1
  339. package/packages/dgram/dist/mdns.d.ts +0 -371
  340. package/packages/dgram/dist/mdns.d.ts.map +0 -1
  341. package/packages/dgram/dist/mdns.js +0 -934
  342. package/packages/dgram/dist/mdns.js.map +0 -1
  343. package/packages/dgram/dist/multicast.d.ts +0 -67
  344. package/packages/dgram/dist/multicast.d.ts.map +0 -1
  345. package/packages/dgram/dist/multicast.js +0 -180
  346. package/packages/dgram/dist/multicast.js.map +0 -1
  347. package/packages/dgram/dist/unicast.d.ts +0 -64
  348. package/packages/dgram/dist/unicast.d.ts.map +0 -1
  349. package/packages/dgram/dist/unicast.js +0 -100
  350. package/packages/dgram/dist/unicast.js.map +0 -1
  351. package/packages/dgram/package.json +0 -110
  352. package/packages/jest-utils/LICENSE +0 -202
  353. package/packages/jest-utils/dist/export.d.ts +0 -2
  354. package/packages/jest-utils/dist/export.d.ts.map +0 -1
  355. package/packages/jest-utils/dist/export.js +0 -2
  356. package/packages/jest-utils/dist/export.js.map +0 -1
  357. package/packages/jest-utils/dist/jestHelpers.d.ts +0 -77
  358. package/packages/jest-utils/dist/jestHelpers.d.ts.map +0 -1
  359. package/packages/jest-utils/dist/jestHelpers.js +0 -138
  360. package/packages/jest-utils/dist/jestHelpers.js.map +0 -1
  361. package/packages/jest-utils/package.json +0 -109
  362. package/packages/utils/LICENSE +0 -202
  363. package/packages/utils/dist/colorUtils.d.ts +0 -101
  364. package/packages/utils/dist/colorUtils.d.ts.map +0 -1
  365. package/packages/utils/dist/colorUtils.js +0 -282
  366. package/packages/utils/dist/colorUtils.js.map +0 -1
  367. package/packages/utils/dist/commandLine.d.ts +0 -66
  368. package/packages/utils/dist/commandLine.d.ts.map +0 -1
  369. package/packages/utils/dist/commandLine.js +0 -123
  370. package/packages/utils/dist/commandLine.js.map +0 -1
  371. package/packages/utils/dist/copyDirectory.d.ts +0 -35
  372. package/packages/utils/dist/copyDirectory.d.ts.map +0 -1
  373. package/packages/utils/dist/copyDirectory.js +0 -76
  374. package/packages/utils/dist/copyDirectory.js.map +0 -1
  375. package/packages/utils/dist/createDirectory.d.ts +0 -34
  376. package/packages/utils/dist/createDirectory.d.ts.map +0 -1
  377. package/packages/utils/dist/createDirectory.js +0 -54
  378. package/packages/utils/dist/createDirectory.js.map +0 -1
  379. package/packages/utils/dist/createZip.d.ts +0 -39
  380. package/packages/utils/dist/createZip.d.ts.map +0 -1
  381. package/packages/utils/dist/createZip.js +0 -114
  382. package/packages/utils/dist/createZip.js.map +0 -1
  383. package/packages/utils/dist/deepCopy.d.ts +0 -32
  384. package/packages/utils/dist/deepCopy.d.ts.map +0 -1
  385. package/packages/utils/dist/deepCopy.js +0 -79
  386. package/packages/utils/dist/deepCopy.js.map +0 -1
  387. package/packages/utils/dist/deepEqual.d.ts +0 -54
  388. package/packages/utils/dist/deepEqual.d.ts.map +0 -1
  389. package/packages/utils/dist/deepEqual.js +0 -130
  390. package/packages/utils/dist/deepEqual.js.map +0 -1
  391. package/packages/utils/dist/error.d.ts +0 -45
  392. package/packages/utils/dist/error.d.ts.map +0 -1
  393. package/packages/utils/dist/error.js +0 -54
  394. package/packages/utils/dist/error.js.map +0 -1
  395. package/packages/utils/dist/export.d.ts +0 -16
  396. package/packages/utils/dist/export.d.ts.map +0 -1
  397. package/packages/utils/dist/export.js +0 -16
  398. package/packages/utils/dist/export.js.map +0 -1
  399. package/packages/utils/dist/format.d.ts +0 -53
  400. package/packages/utils/dist/format.d.ts.map +0 -1
  401. package/packages/utils/dist/format.js +0 -78
  402. package/packages/utils/dist/format.js.map +0 -1
  403. package/packages/utils/dist/githubVersion.d.ts +0 -43
  404. package/packages/utils/dist/githubVersion.d.ts.map +0 -1
  405. package/packages/utils/dist/githubVersion.js +0 -70
  406. package/packages/utils/dist/githubVersion.js.map +0 -1
  407. package/packages/utils/dist/hex.d.ts +0 -89
  408. package/packages/utils/dist/hex.d.ts.map +0 -1
  409. package/packages/utils/dist/hex.js +0 -242
  410. package/packages/utils/dist/hex.js.map +0 -1
  411. package/packages/utils/dist/inspector.d.ts +0 -87
  412. package/packages/utils/dist/inspector.d.ts.map +0 -1
  413. package/packages/utils/dist/inspector.js +0 -268
  414. package/packages/utils/dist/inspector.js.map +0 -1
  415. package/packages/utils/dist/isValid.d.ts +0 -103
  416. package/packages/utils/dist/isValid.d.ts.map +0 -1
  417. package/packages/utils/dist/isValid.js +0 -162
  418. package/packages/utils/dist/isValid.js.map +0 -1
  419. package/packages/utils/dist/network.d.ts +0 -105
  420. package/packages/utils/dist/network.d.ts.map +0 -1
  421. package/packages/utils/dist/network.js +0 -201
  422. package/packages/utils/dist/network.js.map +0 -1
  423. package/packages/utils/dist/npmRoot.d.ts +0 -29
  424. package/packages/utils/dist/npmRoot.d.ts.map +0 -1
  425. package/packages/utils/dist/npmRoot.js +0 -41
  426. package/packages/utils/dist/npmRoot.js.map +0 -1
  427. package/packages/utils/dist/npmVersion.d.ts +0 -33
  428. package/packages/utils/dist/npmVersion.d.ts.map +0 -1
  429. package/packages/utils/dist/npmVersion.js +0 -76
  430. package/packages/utils/dist/npmVersion.js.map +0 -1
  431. package/packages/utils/dist/tracker.d.ts +0 -108
  432. package/packages/utils/dist/tracker.d.ts.map +0 -1
  433. package/packages/utils/dist/tracker.js +0 -264
  434. package/packages/utils/dist/tracker.js.map +0 -1
  435. package/packages/utils/dist/wait.d.ts +0 -54
  436. package/packages/utils/dist/wait.d.ts.map +0 -1
  437. package/packages/utils/dist/wait.js +0 -125
  438. package/packages/utils/dist/wait.js.map +0 -1
  439. package/packages/utils/package.json +0 -110
  440. package/packages/vitest-utils/LICENSE +0 -202
  441. package/packages/vitest-utils/dist/export.d.ts +0 -2
  442. package/packages/vitest-utils/dist/export.d.ts.map +0 -1
  443. package/packages/vitest-utils/dist/export.js +0 -2
  444. package/packages/vitest-utils/dist/export.js.map +0 -1
  445. package/packages/vitest-utils/dist/vitestHelpers.d.ts +0 -58
  446. package/packages/vitest-utils/dist/vitestHelpers.d.ts.map +0 -1
  447. package/packages/vitest-utils/dist/vitestHelpers.js +0 -119
  448. package/packages/vitest-utils/dist/vitestHelpers.js.map +0 -1
  449. package/packages/vitest-utils/package.json +0 -109
@@ -1,25 +1,3 @@
1
- /**
2
- * @description This file contains the class Multicast.
3
- * @file multicast.ts
4
- * @author Luca Liguori
5
- * @created 2025-03-22
6
- * @version 1.0.0
7
- * @license Apache-2.0
8
- *
9
- * Copyright 2025, 2026, 2027 Luca Liguori.
10
- *
11
- * Licensed under the Apache License, Version 2.0 (the "License");
12
- * you may not use this file except in compliance with the License.
13
- * You may obtain a copy of the License at
14
- *
15
- * http://www.apache.org/licenses/LICENSE-2.0
16
- *
17
- * Unless required by applicable law or agreed to in writing, software
18
- * distributed under the License is distributed on an "AS IS" BASIS,
19
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20
- * See the License for the specific language governing permissions and
21
- * limitations under the License.
22
- */
23
1
  import { AddressInfo } from 'node:net';
24
2
  import { Dgram } from './dgram.js';
25
3
  export declare const MDNS_MULTICAST_IPV4_ADDRESS = "224.0.0.251";
@@ -28,40 +6,13 @@ export declare const MDNS_MULTICAST_PORT = 5353;
28
6
  export declare const COAP_MULTICAST_IPV4_ADDRESS = "224.0.1.187";
29
7
  export declare const COAP_MULTICAST_IPV6_ADDRESS = "ff02::fd";
30
8
  export declare const COAP_MULTICAST_PORT = 5683;
31
- /**
32
- * This class implements a multicast dgram socket.
33
- */
34
9
  export declare class Multicast extends Dgram {
35
10
  multicastAddress: string;
36
11
  multicastPort: number;
37
12
  outgoingInterfaceAddress: string | undefined;
38
13
  joinedInterfaces: string[];
39
- /**
40
- * Creates an instance of Multicast.
41
- *
42
- * @param {string} name - The name of the socket.
43
- * @param {string} multicastAddress - The multicast address to join.
44
- * @param {number} multicastPort - The port number to bind to.
45
- * @param {'udp4' | 'udp6'} socketType - The type of the socket (IPv4 or IPv6).
46
- * @param {boolean | undefined} reuseAddr - Whether to allow address reuse. Defaults to true.
47
- * @param {string} [interfaceName] - The name of the network interface to bind to. If provided, the interfaceAddress will be determined based on this name if not explicitly provided.
48
- * @param {string} [interfaceAddress] - The address of the network interface to bind to. If not provided, it will be determined based on the interfaceName.
49
- * @param {string} [outgoingInterfaceAddress] - The address of the outgoing network interface. If not provided, it will use the interfaceAddress.
50
- */
51
14
  constructor(name: string, multicastAddress: string, multicastPort: number, socketType: 'udp4' | 'udp6', reuseAddr?: boolean | undefined, interfaceName?: string, interfaceAddress?: string, outgoingInterfaceAddress?: string);
52
- /**
53
- * Starts the dgram multicast socket.
54
- */
55
15
  start(): void;
56
- /**
57
- * Event handler for the 'listening' event. This event is emitted when the socket starts listening for datagram messages.
58
- *
59
- * @param {AddressInfo} [address] - The address info.
60
- */
61
16
  onListening(address: AddressInfo): void;
62
- /**
63
- * Stops the dgram multicast socket.
64
- */
65
17
  stop(): void;
66
18
  }
67
- //# sourceMappingURL=multicast.d.ts.map
@@ -1,29 +1,5 @@
1
- /**
2
- * @description This file contains the class Multicast.
3
- * @file multicast.ts
4
- * @author Luca Liguori
5
- * @created 2025-03-22
6
- * @version 1.0.0
7
- * @license Apache-2.0
8
- *
9
- * Copyright 2025, 2026, 2027 Luca Liguori.
10
- *
11
- * Licensed under the Apache License, Version 2.0 (the "License");
12
- * you may not use this file except in compliance with the License.
13
- * You may obtain a copy of the License at
14
- *
15
- * http://www.apache.org/licenses/LICENSE-2.0
16
- *
17
- * Unless required by applicable law or agreed to in writing, software
18
- * distributed under the License is distributed on an "AS IS" BASIS,
19
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20
- * See the License for the specific language governing permissions and
21
- * limitations under the License.
22
- */
23
1
  import os from 'node:os';
24
- // AnsiLogger imports
25
2
  import { BLUE, CYAN, db, RED, YELLOW } from 'node-ansi-logger';
26
- // Dgram imports
27
3
  import { Dgram } from './dgram.js';
28
4
  export const MDNS_MULTICAST_IPV4_ADDRESS = '224.0.0.251';
29
5
  export const MDNS_MULTICAST_IPV6_ADDRESS = 'ff02::fb';
@@ -31,37 +7,18 @@ export const MDNS_MULTICAST_PORT = 5353;
31
7
  export const COAP_MULTICAST_IPV4_ADDRESS = '224.0.1.187';
32
8
  export const COAP_MULTICAST_IPV6_ADDRESS = 'ff02::fd';
33
9
  export const COAP_MULTICAST_PORT = 5683;
34
- /**
35
- * This class implements a multicast dgram socket.
36
- */
37
10
  export class Multicast extends Dgram {
38
11
  multicastAddress;
39
12
  multicastPort;
40
13
  outgoingInterfaceAddress;
41
14
  joinedInterfaces = [];
42
- /**
43
- * Creates an instance of Multicast.
44
- *
45
- * @param {string} name - The name of the socket.
46
- * @param {string} multicastAddress - The multicast address to join.
47
- * @param {number} multicastPort - The port number to bind to.
48
- * @param {'udp4' | 'udp6'} socketType - The type of the socket (IPv4 or IPv6).
49
- * @param {boolean | undefined} reuseAddr - Whether to allow address reuse. Defaults to true.
50
- * @param {string} [interfaceName] - The name of the network interface to bind to. If provided, the interfaceAddress will be determined based on this name if not explicitly provided.
51
- * @param {string} [interfaceAddress] - The address of the network interface to bind to. If not provided, it will be determined based on the interfaceName.
52
- * @param {string} [outgoingInterfaceAddress] - The address of the outgoing network interface. If not provided, it will use the interfaceAddress.
53
- */
54
15
  constructor(name, multicastAddress, multicastPort, socketType, reuseAddr = true, interfaceName, interfaceAddress, outgoingInterfaceAddress) {
55
16
  super(name, socketType, reuseAddr, interfaceName, interfaceAddress);
56
17
  this.multicastAddress = multicastAddress;
57
18
  this.multicastPort = multicastPort;
58
19
  this.outgoingInterfaceAddress = outgoingInterfaceAddress;
59
20
  }
60
- /**
61
- * Starts the dgram multicast socket.
62
- */
63
21
  start() {
64
- // Get the local ipv4 or ipv6 address to bind to.
65
22
  if (this.socketType === 'udp4') {
66
23
  this.log.debug(`Starting ipv4 dgram multicast socket...`);
67
24
  this.interfaceAddress = this.interfaceAddress ?? this.getIpv4InterfaceAddress(this.interfaceName);
@@ -77,11 +34,6 @@ export class Multicast extends Dgram {
77
34
  this.emit('bound', address);
78
35
  });
79
36
  }
80
- /**
81
- * Event handler for the 'listening' event. This event is emitted when the socket starts listening for datagram messages.
82
- *
83
- * @param {AddressInfo} [address] - The address info.
84
- */
85
37
  onListening(address) {
86
38
  this.log.debug(`Dgram multicast socket listening on ${BLUE}${address.family}${db} ${BLUE}${address.address}${db}:${BLUE}${address.port}${db}`);
87
39
  this.socket.setBroadcast(true);
@@ -92,46 +44,39 @@ export class Multicast extends Dgram {
92
44
  this.log.debug(`Dgram multicast socket multicast TTL set to 255`);
93
45
  this.socket.setMulticastLoopback(true);
94
46
  this.log.debug(`Dgram multicast socket multicast loopback enabled`);
95
- // Find the correct network interfaces and join the multicast group on each interface. For IPv6, we will use the scope ID if available. If not available, we will use the Unique Local Address.
96
47
  Object.entries(os.networkInterfaces()).forEach(([name, interfaces]) => {
97
48
  this.log.debug(`Dgram multicast socket processing interface ${CYAN}${name}${db}`);
98
49
  if (!interfaces)
99
50
  return;
100
51
  if (this.interfaceName && name !== this.interfaceName)
101
- return; // Only process the specified interface
52
+ return;
102
53
  let iface;
103
54
  let membershipInterface;
104
- // Find the first ipv4 interface
105
55
  const ifaceIpv4 = interfaces.find((iface) => iface.family === 'IPv4' && this.socketType === 'udp4');
106
56
  if (ifaceIpv4) {
107
57
  iface = ifaceIpv4;
108
58
  membershipInterface = ifaceIpv4.address;
109
59
  }
110
- // Find the first IPv6 Address
111
60
  const ifaceIpv6 = interfaces.find((iface) => iface.family === 'IPv6' && this.socketType === 'udp6');
112
61
  if (ifaceIpv6) {
113
62
  iface = ifaceIpv6;
114
63
  membershipInterface = ifaceIpv6.address + (ifaceIpv6.scopeid !== undefined ? (process.platform === 'win32' ? '%' + String(ifaceIpv6.scopeid) : '%' + name) : '');
115
64
  }
116
- // Find the first Unique Local Address (ULA) IPv6
117
65
  const ifaceUla = interfaces.find((iface) => iface.family === 'IPv6' && this.socketType === 'udp6' && iface.address.startsWith('fd'));
118
66
  if (ifaceUla) {
119
67
  iface = ifaceUla;
120
68
  membershipInterface = ifaceUla.address + (ifaceUla.scopeid !== undefined ? (process.platform === 'win32' ? '%' + String(ifaceUla.scopeid) : '%' + name) : '');
121
69
  }
122
- // Find the first Unique Local Address (ULA) IPv6 with prefix length /64 (netmask ffff:ffff:ffff:ffff::)
123
70
  const ifaceUla64 = interfaces.find((iface) => iface.family === 'IPv6' && this.socketType === 'udp6' && iface.address.startsWith('fd') && iface.netmask === 'ffff:ffff:ffff:ffff::');
124
71
  if (ifaceUla64) {
125
72
  iface = ifaceUla64;
126
73
  membershipInterface = ifaceUla64.address + (ifaceUla64.scopeid !== undefined ? (process.platform === 'win32' ? '%' + String(ifaceUla64.scopeid) : '%' + name) : '');
127
74
  }
128
- // Find the first Link-local IPv6 Address
129
75
  const ifaceLinkLocal = interfaces.find((iface) => iface.family === 'IPv6' && this.socketType === 'udp6' && iface.address.startsWith('fe80'));
130
76
  if (ifaceLinkLocal) {
131
77
  iface = ifaceLinkLocal;
132
78
  membershipInterface = ifaceLinkLocal.address + (ifaceLinkLocal.scopeid !== undefined ? (process.platform === 'win32' ? '%' + String(ifaceLinkLocal.scopeid) : '%' + name) : '');
133
79
  }
134
- // Add the interface address to the multicast group
135
80
  if (iface && membershipInterface) {
136
81
  try {
137
82
  this.socket.addMembership(this.multicastAddress, membershipInterface);
@@ -144,11 +89,9 @@ export class Multicast extends Dgram {
144
89
  }
145
90
  });
146
91
  let interfaceAddress = this.outgoingInterfaceAddress || this.interfaceAddress;
147
- // If the interfaceAddress is 0.0.0.0, we need to set the default outgoing multicast interface to the first found IPv4 address.
148
92
  if (!this.outgoingInterfaceAddress && this.socketType === 'udp4' && this.interfaceAddress === '0.0.0.0') {
149
93
  interfaceAddress = this.getIpv4InterfaceAddress(this.interfaceName);
150
94
  }
151
- // If the interfaceAddress is '::', we need to set the default outgoing multicast interface to '::' + the scope ID.
152
95
  if (!this.outgoingInterfaceAddress && this.socketType === 'udp6' && this.interfaceAddress === '::') {
153
96
  interfaceAddress = '::' + this.getIpv6ScopeId(this.interfaceName);
154
97
  }
@@ -157,9 +100,6 @@ export class Multicast extends Dgram {
157
100
  this.log.debug(`Dgram multicast socket multicastInterface set to ${BLUE}${interfaceAddress}${db}`);
158
101
  this.emit('ready', address);
159
102
  }
160
- /**
161
- * Stops the dgram multicast socket.
162
- */
163
103
  stop() {
164
104
  this.log.debug('Stopping dgram multicast socket...');
165
105
  this.joinedInterfaces.forEach((membershipInterface) => {
@@ -176,4 +116,3 @@ export class Multicast extends Dgram {
176
116
  this.log.debug('Stopped dgram multicast socket.');
177
117
  }
178
118
  }
179
- //# sourceMappingURL=multicast.js.map
@@ -1,64 +1,11 @@
1
- /**
2
- * @description This file contains the class Unicast.
3
- * @file unicast.ts
4
- * @author Luca Liguori
5
- * @created 2025-03-22
6
- * @version 1.0.0
7
- * @license Apache-2.0
8
- *
9
- * Copyright 2025, 2026, 2027 Luca Liguori.
10
- *
11
- * Licensed under the Apache License, Version 2.0 (the "License");
12
- * you may not use this file except in compliance with the License.
13
- * You may obtain a copy of the License at
14
- *
15
- * http://www.apache.org/licenses/LICENSE-2.0
16
- *
17
- * Unless required by applicable law or agreed to in writing, software
18
- * distributed under the License is distributed on an "AS IS" BASIS,
19
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20
- * See the License for the specific language governing permissions and
21
- * limitations under the License.
22
- */
23
1
  import { AddressInfo } from 'node:net';
24
2
  import { RemoteInfo } from 'node:dgram';
25
3
  import { Dgram } from './dgram.js';
26
- /**
27
- * This class implements a unicast dgram socket.
28
- */
29
4
  export declare class Unicast extends Dgram {
30
5
  port: number | undefined;
31
- /**
32
- * Creates an instance of Unicast.
33
- *
34
- * @param {string} name - The name of the socket.
35
- * @param {'udp4' | 'udp6'} socketType - The type of the socket (IPv4 or IPv6).
36
- * @param {boolean | undefined} reuseAddr - Whether to allow address reuse. Defaults to true.
37
- * @param {string} [interfaceName] - The name of the network interface to bind to. If provided, the interfaceAddress will be determined based on this name if not explicitly provided.
38
- * @param {string} [interfaceAddress] - The address of the network interface to bind to. If not provided, it will be determined based on the interfaceName.
39
- * @param {number} [port] - The port number to bind to. If not provided, it will bind to any available port.
40
- */
41
6
  constructor(name: string, socketType: 'udp4' | 'udp6', reuseAddr?: boolean | undefined, interfaceName?: string, interfaceAddress?: string, port?: number);
42
- /**
43
- * Starts the dgram unicast socket.
44
- */
45
7
  start(): void;
46
- /**
47
- * Event handler for the 'listening' event. This event is emitted when the socket starts listening for datagram messages.
48
- *
49
- * @param {AddressInfo} [address] - The address info.
50
- */
51
8
  onListening(address: AddressInfo): void;
52
- /**
53
- * Event handler for the 'message' event. This event is emitted when a datagram message is received.
54
- *
55
- * @param {Buffer} msg - The message buffer.
56
- * @param {RemoteInfo} rinfo - The remote info.
57
- */
58
9
  onMessage(msg: Buffer, rinfo: RemoteInfo): void;
59
- /**
60
- * Stops the dgram unicast socket.
61
- */
62
10
  stop(): void;
63
11
  }
64
- //# sourceMappingURL=unicast.d.ts.map
@@ -1,54 +1,12 @@
1
- /**
2
- * @description This file contains the class Unicast.
3
- * @file unicast.ts
4
- * @author Luca Liguori
5
- * @created 2025-03-22
6
- * @version 1.0.0
7
- * @license Apache-2.0
8
- *
9
- * Copyright 2025, 2026, 2027 Luca Liguori.
10
- *
11
- * Licensed under the Apache License, Version 2.0 (the "License");
12
- * you may not use this file except in compliance with the License.
13
- * You may obtain a copy of the License at
14
- *
15
- * http://www.apache.org/licenses/LICENSE-2.0
16
- *
17
- * Unless required by applicable law or agreed to in writing, software
18
- * distributed under the License is distributed on an "AS IS" BASIS,
19
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20
- * See the License for the specific language governing permissions and
21
- * limitations under the License.
22
- */
23
- // AnsiLogger imports
24
1
  import { BLUE, db } from 'node-ansi-logger';
25
- // Net imports
26
2
  import { Dgram } from './dgram.js';
27
- /**
28
- * This class implements a unicast dgram socket.
29
- */
30
3
  export class Unicast extends Dgram {
31
4
  port;
32
- /**
33
- * Creates an instance of Unicast.
34
- *
35
- * @param {string} name - The name of the socket.
36
- * @param {'udp4' | 'udp6'} socketType - The type of the socket (IPv4 or IPv6).
37
- * @param {boolean | undefined} reuseAddr - Whether to allow address reuse. Defaults to true.
38
- * @param {string} [interfaceName] - The name of the network interface to bind to. If provided, the interfaceAddress will be determined based on this name if not explicitly provided.
39
- * @param {string} [interfaceAddress] - The address of the network interface to bind to. If not provided, it will be determined based on the interfaceName.
40
- * @param {number} [port] - The port number to bind to. If not provided, it will bind to any available port.
41
- */
42
5
  constructor(name, socketType, reuseAddr = true, interfaceName, interfaceAddress, port) {
43
6
  super(name, socketType, reuseAddr, interfaceName, interfaceAddress);
44
7
  this.port = port;
45
8
  }
46
- /**
47
- * Starts the dgram unicast socket.
48
- */
49
9
  start() {
50
- // Get the local ipv4 or ipv6 interfaceAddress to bind to. If not provided and interfaceName has been provided, use the first one found.
51
- // If neither interfaceAddress nor interfaceName is provided, use undefined to bind to any available address. In this case broadcast will not work.
52
10
  if (this.socketType === 'udp4') {
53
11
  this.log.debug(`Starting ipv4 dgram unicast socket...`);
54
12
  this.interfaceAddress = this.interfaceAddress ?? (this.interfaceName ? this.getIpv4InterfaceAddress(this.interfaceName) : undefined);
@@ -58,9 +16,6 @@ export class Unicast extends Dgram {
58
16
  this.interfaceAddress = this.interfaceAddress ?? (this.interfaceName ? this.getIpv6InterfaceAddress(this.interfaceName) : undefined);
59
17
  }
60
18
  this.interfaceNetmask = this.interfaceAddress ? this.getNetmask(this.interfaceAddress) : undefined;
61
- // Bind to the local address and port:
62
- // port 0 or undefined means "assign any available port"
63
- // address 0.0.0.0 or :: means "bind to all available addresses"
64
19
  this.log.debug(`Binding dgram unicast socket to ${BLUE}${this.interfaceAddress || 'all available addresses'}${db} on port ${BLUE}${this.port || 'any available port'}${db}...`);
65
20
  this.socket.bind(this.port, this.interfaceAddress, () => {
66
21
  const address = this.socket.address();
@@ -68,33 +23,18 @@ export class Unicast extends Dgram {
68
23
  this.emit('bound', address);
69
24
  });
70
25
  }
71
- /**
72
- * Event handler for the 'listening' event. This event is emitted when the socket starts listening for datagram messages.
73
- *
74
- * @param {AddressInfo} [address] - The address info.
75
- */
76
26
  onListening(address) {
77
27
  this.log.debug(`Dgram unicast socket listening on ${BLUE}${address.family}${db} ${BLUE}${address.address}${db}:${BLUE}${address.port}${db}`);
78
28
  this.socket.setBroadcast(true);
79
29
  this.log.debug(`Dgram unicast socket broadcast enabled`);
80
30
  this.emit('ready', address);
81
31
  }
82
- /**
83
- * Event handler for the 'message' event. This event is emitted when a datagram message is received.
84
- *
85
- * @param {Buffer} msg - The message buffer.
86
- * @param {RemoteInfo} rinfo - The remote info.
87
- */
88
32
  onMessage(msg, rinfo) {
89
33
  this.log.debug(`Socket received a message from ${BLUE}${rinfo.family}${db} ${BLUE}${rinfo.address}${db}:${BLUE}${rinfo.port}${db}`);
90
34
  }
91
- /**
92
- * Stops the dgram unicast socket.
93
- */
94
35
  stop() {
95
36
  this.log.debug('Stopping dgram unicast socket...');
96
37
  this.socket.close();
97
38
  this.log.debug('Stopped dgram unicast socket.');
98
39
  }
99
40
  }
100
- //# sourceMappingURL=unicast.js.map
@@ -1,35 +1,9 @@
1
- /**
2
- * This file contains the class Frontend.
3
- *
4
- * @file frontend.ts
5
- * @author Luca Liguori
6
- * @created 2025-01-13
7
- * @version 1.3.3
8
- * @license Apache-2.0
9
- *
10
- * Copyright 2025, 2026, 2027 Luca Liguori.
11
- *
12
- * Licensed under the Apache License, Version 2.0 (the "License");
13
- * you may not use this file except in compliance with the License.
14
- * You may obtain a copy of the License at
15
- *
16
- * http://www.apache.org/licenses/LICENSE-2.0
17
- *
18
- * Unless required by applicable law or agreed to in writing, software
19
- * distributed under the License is distributed on an "AS IS" BASIS,
20
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21
- * See the License for the specific language governing permissions and
22
- * limitations under the License.
23
- */
24
1
  import EventEmitter from 'node:events';
25
2
  import { LogLevel } from 'node-ansi-logger';
26
3
  import { EndpointNumber } from '@matter/types/datatype';
27
4
  import type { ApiMatter } from './matterbridgeTypes.js';
28
5
  import type { Matterbridge } from './matterbridge.js';
29
6
  import type { RefreshRequiredChanged, WsMessageBroadcast } from './frontendTypes.js';
30
- /**
31
- * Represents the Frontend events.
32
- */
33
7
  interface FrontendEvents {
34
8
  server_listening: [protocol: string, port: number, address?: string];
35
9
  server_error: [error: Error];
@@ -56,190 +30,29 @@ export declare class Frontend extends EventEmitter<FrontendEvents> {
56
30
  set logLevel(logLevel: LogLevel);
57
31
  start(port?: number): Promise<void>;
58
32
  stop(): Promise<void>;
59
- /**
60
- * Retrieves the api settings data.
61
- *
62
- * @returns {Promise<{ matterbridgeInformation: MatterbridgeInformation, systemInformation: SystemInformation }>} A promise that resolve in the api settings object.
63
- */
64
33
  private getApiSettings;
65
- /**
66
- * Retrieves the reachable attribute.
67
- *
68
- * @param {MatterbridgeEndpoint} device - The MatterbridgeEndpoint object.
69
- * @returns {boolean} The reachable attribute.
70
- */
71
34
  private getReachability;
72
- /**
73
- * Retrieves the power source attribute.
74
- *
75
- * @param {MatterbridgeEndpoint} endpoint - The MatterbridgeDevice to retrieve the power source from.
76
- * @returns {'ac' | 'dc' | 'ok' | 'warning' | 'critical' | undefined} The power source attribute.
77
- */
78
35
  private getPowerSource;
79
- /**
80
- * Retrieves the battery level attribute.
81
- *
82
- * @param {MatterbridgeEndpoint} endpoint - The MatterbridgeDevice to retrieve the power source from.
83
- * @returns {number | undefined} The battery level attribute.
84
- */
85
36
  private getBatteryLevel;
86
- /**
87
- * Retrieves the cluster text description from a given device.
88
- * The output is a string with the attributes description of the cluster servers in the device to show in the frontend.
89
- *
90
- * @param {MatterbridgeEndpoint} device - The MatterbridgeEndpoint to retrieve the cluster text from.
91
- * @returns {string} The attributes description of the cluster servers in the device.
92
- */
93
37
  private getClusterTextFromDevice;
94
- /**
95
- * Retrieves the registered plugins sanitized for res.json().
96
- *
97
- * @returns {ApiPlugin[]} An array of BaseRegisteredPlugin.
98
- */
99
38
  private getPlugins;
100
- /**
101
- * Retrieves the devices from Matterbridge.
102
- *
103
- * @param {string} [pluginName] - The name of the plugin to filter devices by.
104
- * @returns {ApiDevice[]} An array of ApiDevices for the frontend.
105
- */
106
39
  private getDevices;
107
- /**
108
- * Retrieves the clusters from a given plugin and endpoint number.
109
- *
110
- * Response for /api/clusters
111
- *
112
- * @param {string} pluginName - The name of the plugin.
113
- * @param {number} endpointNumber - The endpoint number.
114
- * @returns {ApiClusters | undefined} A promise that resolves to the clusters or undefined if not found.
115
- */
116
40
  private getClusters;
117
41
  private generateDiagnostic;
118
- /**
119
- * Handles incoming websocket api request messages from the Matterbridge frontend.
120
- *
121
- * @param {WebSocket} client - The websocket client that sent the message.
122
- * @param {WebSocket.RawData} message - The raw data of the message received from the client.
123
- * @returns {Promise<void>} A promise that resolves when the message has been handled.
124
- */
125
42
  private wsMessageHandler;
126
- /**
127
- * Sends a WebSocket log message to all connected clients. The function is called by AnsiLogger.setGlobalCallback.
128
- *
129
- * @param {string} level - The logger level of the message: debug info notice warn error fatal...
130
- * @param {string} time - The time string of the message
131
- * @param {string} name - The logger name of the message
132
- * @param {string} message - The content of the message.
133
- *
134
- * @remarks
135
- * The function removes ANSI escape codes, leading asterisks, non-printable characters, and replaces all occurrences of \t and \n.
136
- * It also replaces all occurrences of \" with " and angle-brackets with &lt; and &gt;.
137
- * The function sends the message to all connected clients.
138
- */
139
43
  wssSendLogMessage(level: string, time: string, name: string, message: string): void;
140
- /**
141
- * Sends a need to refresh WebSocket message to all connected clients.
142
- *
143
- * @param {string} changed - The changed value.
144
- * @param {Record<string, unknown>} params - Additional parameters to send with the message.
145
- * possible values for changed:
146
- * - 'settings' (when the bridge has started in bridge mode or childbridge mode and when update finds a new version)
147
- * - 'plugins'
148
- * - 'devices'
149
- * - 'matter' with param 'matter' (QRDiv component)
150
- * @param {ApiMatter} params.matter - The matter device that has changed. Required if changed is 'matter'.
151
- */
152
44
  wssSendRefreshRequired(changed: RefreshRequiredChanged, params?: {
153
45
  matter: ApiMatter;
154
46
  }): void;
155
- /**
156
- * Sends a need to restart WebSocket message to all connected clients.
157
- *
158
- * @param {boolean} snackbar - If true, a snackbar message will be sent to all connected clients. Default is true.
159
- * @param {boolean} fixed - If true, the restart is fixed and will not be reset by plugin restarts. Default is false.
160
- */
161
47
  wssSendRestartRequired(snackbar?: boolean, fixed?: boolean): void;
162
- /**
163
- * Sends a no need to restart WebSocket message to all connected clients.
164
- *
165
- * @param {boolean} snackbar - If true, the snackbar message will be cleared from all connected clients. Default is true.
166
- */
167
48
  wssSendRestartNotRequired(snackbar?: boolean): void;
168
- /**
169
- * Sends a need to update WebSocket message to all connected clients.
170
- *
171
- * @param {boolean} devVersion - If true, the update is for a development version. Default is false.
172
- */
173
49
  wssSendUpdateRequired(devVersion?: boolean): void;
174
- /**
175
- * Sends a cpu update message to all connected clients.
176
- *
177
- * @param {number} cpuUsage - The CPU usage percentage to send.
178
- * @param {number} processCpuUsage - The CPU usage percentage of the process to send.
179
- */
180
50
  wssSendCpuUpdate(cpuUsage: number, processCpuUsage: number): void;
181
- /**
182
- * Sends a memory update message to all connected clients.
183
- *
184
- * @param {string} totalMemory - The total memory in bytes.
185
- * @param {string} freeMemory - The free memory in bytes.
186
- * @param {string} rss - The resident set size in bytes.
187
- * @param {string} heapTotal - The total heap memory in bytes.
188
- * @param {string} heapUsed - The used heap memory in bytes.
189
- * @param {string} external - The external memory in bytes.
190
- * @param {string} arrayBuffers - The array buffers memory in bytes.
191
- */
192
51
  wssSendMemoryUpdate(totalMemory: string, freeMemory: string, rss: string, heapTotal: string, heapUsed: string, external: string, arrayBuffers: string): void;
193
- /**
194
- * Sends an uptime update message to all connected clients.
195
- *
196
- * @param {string} systemUptime - The system uptime in a human-readable format.
197
- * @param {string} processUptime - The process uptime in a human-readable format.
198
- */
199
52
  wssSendUptimeUpdate(systemUptime: string, processUptime: string): void;
200
- /**
201
- * Sends an open snackbar message to all connected clients.
202
- *
203
- * @param {string} message - The message to send.
204
- * @param {number} timeout - The timeout in seconds for the snackbar message. Default is 5 seconds.
205
- * @param {'info' | 'warning' | 'error' | 'success'} severity - The severity of the message.
206
- * possible values are: 'info', 'warning', 'error', 'success'. Default is 'info'.
207
- *
208
- * @remarks
209
- * If timeout is 0, the snackbar message will be displayed until closed by the user.
210
- */
211
53
  wssSendSnackbarMessage(message: string, timeout?: number, severity?: 'info' | 'warning' | 'error' | 'success'): void;
212
- /**
213
- * Sends a close snackbar message to all connected clients.
214
- * It will close the snackbar message with the same message and timeout = 0.
215
- *
216
- * @param {string} message - The message to send.
217
- */
218
54
  wssSendCloseSnackbarMessage(message: string): void;
219
- /**
220
- * Sends an attribute update message to all connected WebSocket clients.
221
- *
222
- * @param {string | undefined} plugin - The name of the plugin.
223
- * @param {string | undefined} serialNumber - The serial number of the device.
224
- * @param {string | undefined} uniqueId - The unique identifier of the device.
225
- * @param {EndpointNumber} number - The endpoint number where the attribute belongs.
226
- * @param {string} id - The endpoint id where the attribute belongs.
227
- * @param {string} cluster - The cluster name where the attribute belongs.
228
- * @param {string} attribute - The name of the attribute that changed.
229
- * @param {number | string | boolean} value - The new value of the attribute.
230
- *
231
- * @remarks
232
- * This method logs a debug message and sends a JSON-formatted message to all connected WebSocket clients
233
- * with the updated attribute information.
234
- */
235
55
  wssSendAttributeChangedMessage(plugin: string, serialNumber: string, uniqueId: string, number: EndpointNumber, id: string, cluster: string, attribute: string, value: number | string | boolean | null): void;
236
- /**
237
- * Sends a message to all connected clients.
238
- * This is an helper function to send a broadcast message to all connected clients.
239
- *
240
- * @param {WsMessageBroadcast} msg - The message to send.
241
- */
242
56
  wssBroadcastMessage(msg: WsMessageBroadcast): void;
243
57
  }
244
58
  export {};
245
- //# sourceMappingURL=frontend.d.ts.map