matterbridge 3.4.2 → 3.4.3-dev-20251206-06686b7

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 (332) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README-SERVICE-LOCAL.md +3 -3
  3. package/README-SERVICE-OPT.md +3 -5
  4. package/README.md +8 -14
  5. package/dist/broadcastServer.js +0 -119
  6. package/dist/broadcastServerTypes.js +0 -24
  7. package/dist/cli.js +3 -97
  8. package/dist/cliEmitter.js +0 -37
  9. package/dist/cliHistory.js +0 -38
  10. package/dist/clusters/export.js +0 -2
  11. package/dist/deviceManager.js +1 -113
  12. package/dist/devices/airConditioner.js +0 -57
  13. package/dist/devices/batteryStorage.js +1 -48
  14. package/dist/devices/cooktop.js +0 -56
  15. package/dist/devices/dishwasher.js +0 -57
  16. package/dist/devices/evse.js +10 -74
  17. package/dist/devices/export.js +0 -5
  18. package/dist/devices/extractorHood.js +0 -43
  19. package/dist/devices/heatPump.js +2 -50
  20. package/dist/devices/laundryDryer.js +3 -62
  21. package/dist/devices/laundryWasher.js +4 -70
  22. package/dist/devices/microwaveOven.js +5 -88
  23. package/dist/devices/oven.js +0 -85
  24. package/dist/devices/refrigerator.js +0 -102
  25. package/dist/devices/roboticVacuumCleaner.js +9 -100
  26. package/dist/devices/solarPower.js +0 -38
  27. package/dist/devices/speaker.js +0 -84
  28. package/dist/devices/temperatureControl.js +3 -24
  29. package/dist/devices/waterHeater.js +2 -82
  30. package/dist/dgram/coap.js +13 -126
  31. package/dist/dgram/dgram.js +2 -114
  32. package/dist/dgram/mb_coap.js +3 -41
  33. package/dist/dgram/mb_mdns.js +15 -80
  34. package/dist/dgram/mdns.js +137 -299
  35. package/dist/dgram/multicast.js +1 -62
  36. package/dist/dgram/unicast.js +0 -54
  37. package/dist/frontend.js +35 -455
  38. package/dist/frontendTypes.js +0 -45
  39. package/dist/helpers.js +0 -53
  40. package/dist/index.js +0 -25
  41. package/dist/jestutils/export.js +0 -1
  42. package/dist/jestutils/jestHelpers.js +14 -371
  43. package/dist/logger/export.js +0 -1
  44. package/dist/matter/behaviors.js +0 -2
  45. package/dist/matter/clusters.js +0 -2
  46. package/dist/matter/devices.js +0 -2
  47. package/dist/matter/endpoints.js +0 -2
  48. package/dist/matter/export.js +0 -3
  49. package/dist/matter/types.js +0 -3
  50. package/dist/matterNode.js +8 -369
  51. package/dist/matterbridge.js +54 -817
  52. package/dist/matterbridgeAccessoryPlatform.js +0 -38
  53. package/dist/matterbridgeBehaviors.js +5 -68
  54. package/dist/matterbridgeDeviceTypes.js +14 -635
  55. package/dist/matterbridgeDynamicPlatform.js +0 -38
  56. package/dist/matterbridgeEndpoint.js +53 -1444
  57. package/dist/matterbridgeEndpointHelpers.js +20 -483
  58. package/dist/matterbridgeEndpointTypes.js +0 -25
  59. package/dist/matterbridgePlatform.js +1 -451
  60. package/dist/matterbridgeTypes.js +0 -26
  61. package/dist/pluginManager.js +5 -341
  62. package/dist/shelly.js +7 -178
  63. package/dist/storage/export.js +0 -1
  64. package/dist/update.js +1 -93
  65. package/dist/utils/colorUtils.js +2 -97
  66. package/dist/utils/commandLine.js +0 -60
  67. package/dist/utils/copyDirectory.js +0 -37
  68. package/dist/utils/createDirectory.js +0 -33
  69. package/dist/utils/createZip.js +2 -47
  70. package/dist/utils/deepCopy.js +0 -39
  71. package/dist/utils/deepEqual.js +1 -72
  72. package/dist/utils/error.js +0 -42
  73. package/dist/utils/export.js +0 -1
  74. package/dist/utils/format.js +0 -49
  75. package/dist/utils/hex.js +0 -124
  76. package/dist/utils/inspector.js +1 -69
  77. package/dist/utils/isvalid.js +0 -101
  78. package/dist/utils/network.js +5 -96
  79. package/dist/utils/spawn.js +1 -71
  80. package/dist/utils/tracker.js +1 -64
  81. package/dist/utils/wait.js +8 -60
  82. package/dist/workerGlobalPrefix.js +5 -37
  83. package/dist/workerTypes.js +0 -24
  84. package/dist/workers.js +4 -68
  85. package/frontend/build/assets/index.js +4 -4
  86. package/frontend/build/assets/vendor_mui.js +1 -1
  87. package/frontend/package.json +1 -1
  88. package/npm-shrinkwrap.json +8 -7
  89. package/package.json +3 -4
  90. package/scripts/marked.mjs +132 -0
  91. package/scripts/markedFooter.html +42 -0
  92. package/scripts/markedHeader.html +78 -0
  93. package/dist/broadcastServer.d.ts +0 -144
  94. package/dist/broadcastServer.d.ts.map +0 -1
  95. package/dist/broadcastServer.js.map +0 -1
  96. package/dist/broadcastServerTypes.d.ts +0 -841
  97. package/dist/broadcastServerTypes.d.ts.map +0 -1
  98. package/dist/broadcastServerTypes.js.map +0 -1
  99. package/dist/cli.d.ts +0 -30
  100. package/dist/cli.d.ts.map +0 -1
  101. package/dist/cli.js.map +0 -1
  102. package/dist/cliEmitter.d.ts +0 -50
  103. package/dist/cliEmitter.d.ts.map +0 -1
  104. package/dist/cliEmitter.js.map +0 -1
  105. package/dist/cliHistory.d.ts +0 -48
  106. package/dist/cliHistory.d.ts.map +0 -1
  107. package/dist/cliHistory.js.map +0 -1
  108. package/dist/clusters/export.d.ts +0 -2
  109. package/dist/clusters/export.d.ts.map +0 -1
  110. package/dist/clusters/export.js.map +0 -1
  111. package/dist/deviceManager.d.ts +0 -135
  112. package/dist/deviceManager.d.ts.map +0 -1
  113. package/dist/deviceManager.js.map +0 -1
  114. package/dist/devices/airConditioner.d.ts +0 -98
  115. package/dist/devices/airConditioner.d.ts.map +0 -1
  116. package/dist/devices/airConditioner.js.map +0 -1
  117. package/dist/devices/batteryStorage.d.ts +0 -48
  118. package/dist/devices/batteryStorage.d.ts.map +0 -1
  119. package/dist/devices/batteryStorage.js.map +0 -1
  120. package/dist/devices/cooktop.d.ts +0 -61
  121. package/dist/devices/cooktop.d.ts.map +0 -1
  122. package/dist/devices/cooktop.js.map +0 -1
  123. package/dist/devices/dishwasher.d.ts +0 -71
  124. package/dist/devices/dishwasher.d.ts.map +0 -1
  125. package/dist/devices/dishwasher.js.map +0 -1
  126. package/dist/devices/evse.d.ts +0 -76
  127. package/dist/devices/evse.d.ts.map +0 -1
  128. package/dist/devices/evse.js.map +0 -1
  129. package/dist/devices/export.d.ts +0 -17
  130. package/dist/devices/export.d.ts.map +0 -1
  131. package/dist/devices/export.js.map +0 -1
  132. package/dist/devices/extractorHood.d.ts +0 -46
  133. package/dist/devices/extractorHood.d.ts.map +0 -1
  134. package/dist/devices/extractorHood.js.map +0 -1
  135. package/dist/devices/heatPump.d.ts +0 -47
  136. package/dist/devices/heatPump.d.ts.map +0 -1
  137. package/dist/devices/heatPump.js.map +0 -1
  138. package/dist/devices/laundryDryer.d.ts +0 -67
  139. package/dist/devices/laundryDryer.d.ts.map +0 -1
  140. package/dist/devices/laundryDryer.js.map +0 -1
  141. package/dist/devices/laundryWasher.d.ts +0 -81
  142. package/dist/devices/laundryWasher.d.ts.map +0 -1
  143. package/dist/devices/laundryWasher.js.map +0 -1
  144. package/dist/devices/microwaveOven.d.ts +0 -168
  145. package/dist/devices/microwaveOven.d.ts.map +0 -1
  146. package/dist/devices/microwaveOven.js.map +0 -1
  147. package/dist/devices/oven.d.ts +0 -105
  148. package/dist/devices/oven.d.ts.map +0 -1
  149. package/dist/devices/oven.js.map +0 -1
  150. package/dist/devices/refrigerator.d.ts +0 -118
  151. package/dist/devices/refrigerator.d.ts.map +0 -1
  152. package/dist/devices/refrigerator.js.map +0 -1
  153. package/dist/devices/roboticVacuumCleaner.d.ts +0 -112
  154. package/dist/devices/roboticVacuumCleaner.d.ts.map +0 -1
  155. package/dist/devices/roboticVacuumCleaner.js.map +0 -1
  156. package/dist/devices/solarPower.d.ts +0 -40
  157. package/dist/devices/solarPower.d.ts.map +0 -1
  158. package/dist/devices/solarPower.js.map +0 -1
  159. package/dist/devices/speaker.d.ts +0 -87
  160. package/dist/devices/speaker.d.ts.map +0 -1
  161. package/dist/devices/speaker.js.map +0 -1
  162. package/dist/devices/temperatureControl.d.ts +0 -166
  163. package/dist/devices/temperatureControl.d.ts.map +0 -1
  164. package/dist/devices/temperatureControl.js.map +0 -1
  165. package/dist/devices/waterHeater.d.ts +0 -111
  166. package/dist/devices/waterHeater.d.ts.map +0 -1
  167. package/dist/devices/waterHeater.js.map +0 -1
  168. package/dist/dgram/coap.d.ts +0 -205
  169. package/dist/dgram/coap.d.ts.map +0 -1
  170. package/dist/dgram/coap.js.map +0 -1
  171. package/dist/dgram/dgram.d.ts +0 -141
  172. package/dist/dgram/dgram.d.ts.map +0 -1
  173. package/dist/dgram/dgram.js.map +0 -1
  174. package/dist/dgram/mb_coap.d.ts +0 -24
  175. package/dist/dgram/mb_coap.d.ts.map +0 -1
  176. package/dist/dgram/mb_coap.js.map +0 -1
  177. package/dist/dgram/mb_mdns.d.ts +0 -24
  178. package/dist/dgram/mb_mdns.d.ts.map +0 -1
  179. package/dist/dgram/mb_mdns.js.map +0 -1
  180. package/dist/dgram/mdns.d.ts +0 -290
  181. package/dist/dgram/mdns.d.ts.map +0 -1
  182. package/dist/dgram/mdns.js.map +0 -1
  183. package/dist/dgram/multicast.d.ts +0 -67
  184. package/dist/dgram/multicast.d.ts.map +0 -1
  185. package/dist/dgram/multicast.js.map +0 -1
  186. package/dist/dgram/unicast.d.ts +0 -56
  187. package/dist/dgram/unicast.d.ts.map +0 -1
  188. package/dist/dgram/unicast.js.map +0 -1
  189. package/dist/frontend.d.ts +0 -238
  190. package/dist/frontend.d.ts.map +0 -1
  191. package/dist/frontend.js.map +0 -1
  192. package/dist/frontendTypes.d.ts +0 -529
  193. package/dist/frontendTypes.d.ts.map +0 -1
  194. package/dist/frontendTypes.js.map +0 -1
  195. package/dist/helpers.d.ts +0 -48
  196. package/dist/helpers.d.ts.map +0 -1
  197. package/dist/helpers.js.map +0 -1
  198. package/dist/index.d.ts +0 -34
  199. package/dist/index.d.ts.map +0 -1
  200. package/dist/index.js.map +0 -1
  201. package/dist/jestutils/export.d.ts +0 -2
  202. package/dist/jestutils/export.d.ts.map +0 -1
  203. package/dist/jestutils/export.js.map +0 -1
  204. package/dist/jestutils/jestHelpers.d.ts +0 -345
  205. package/dist/jestutils/jestHelpers.d.ts.map +0 -1
  206. package/dist/jestutils/jestHelpers.js.map +0 -1
  207. package/dist/logger/export.d.ts +0 -2
  208. package/dist/logger/export.d.ts.map +0 -1
  209. package/dist/logger/export.js.map +0 -1
  210. package/dist/matter/behaviors.d.ts +0 -2
  211. package/dist/matter/behaviors.d.ts.map +0 -1
  212. package/dist/matter/behaviors.js.map +0 -1
  213. package/dist/matter/clusters.d.ts +0 -2
  214. package/dist/matter/clusters.d.ts.map +0 -1
  215. package/dist/matter/clusters.js.map +0 -1
  216. package/dist/matter/devices.d.ts +0 -2
  217. package/dist/matter/devices.d.ts.map +0 -1
  218. package/dist/matter/devices.js.map +0 -1
  219. package/dist/matter/endpoints.d.ts +0 -2
  220. package/dist/matter/endpoints.d.ts.map +0 -1
  221. package/dist/matter/endpoints.js.map +0 -1
  222. package/dist/matter/export.d.ts +0 -5
  223. package/dist/matter/export.d.ts.map +0 -1
  224. package/dist/matter/export.js.map +0 -1
  225. package/dist/matter/types.d.ts +0 -3
  226. package/dist/matter/types.d.ts.map +0 -1
  227. package/dist/matter/types.js.map +0 -1
  228. package/dist/matterNode.d.ts +0 -342
  229. package/dist/matterNode.d.ts.map +0 -1
  230. package/dist/matterNode.js.map +0 -1
  231. package/dist/matterbridge.d.ts +0 -492
  232. package/dist/matterbridge.d.ts.map +0 -1
  233. package/dist/matterbridge.js.map +0 -1
  234. package/dist/matterbridgeAccessoryPlatform.d.ts +0 -41
  235. package/dist/matterbridgeAccessoryPlatform.d.ts.map +0 -1
  236. package/dist/matterbridgeAccessoryPlatform.js.map +0 -1
  237. package/dist/matterbridgeBehaviors.d.ts +0 -2404
  238. package/dist/matterbridgeBehaviors.d.ts.map +0 -1
  239. package/dist/matterbridgeBehaviors.js.map +0 -1
  240. package/dist/matterbridgeDeviceTypes.d.ts +0 -698
  241. package/dist/matterbridgeDeviceTypes.d.ts.map +0 -1
  242. package/dist/matterbridgeDeviceTypes.js.map +0 -1
  243. package/dist/matterbridgeDynamicPlatform.d.ts +0 -41
  244. package/dist/matterbridgeDynamicPlatform.d.ts.map +0 -1
  245. package/dist/matterbridgeDynamicPlatform.js.map +0 -1
  246. package/dist/matterbridgeEndpoint.d.ts +0 -1507
  247. package/dist/matterbridgeEndpoint.d.ts.map +0 -1
  248. package/dist/matterbridgeEndpoint.js.map +0 -1
  249. package/dist/matterbridgeEndpointHelpers.d.ts +0 -787
  250. package/dist/matterbridgeEndpointHelpers.d.ts.map +0 -1
  251. package/dist/matterbridgeEndpointHelpers.js.map +0 -1
  252. package/dist/matterbridgeEndpointTypes.d.ts +0 -166
  253. package/dist/matterbridgeEndpointTypes.d.ts.map +0 -1
  254. package/dist/matterbridgeEndpointTypes.js.map +0 -1
  255. package/dist/matterbridgePlatform.d.ts +0 -539
  256. package/dist/matterbridgePlatform.d.ts.map +0 -1
  257. package/dist/matterbridgePlatform.js.map +0 -1
  258. package/dist/matterbridgeTypes.d.ts +0 -251
  259. package/dist/matterbridgeTypes.d.ts.map +0 -1
  260. package/dist/matterbridgeTypes.js.map +0 -1
  261. package/dist/pluginManager.d.ts +0 -372
  262. package/dist/pluginManager.d.ts.map +0 -1
  263. package/dist/pluginManager.js.map +0 -1
  264. package/dist/shelly.d.ts +0 -181
  265. package/dist/shelly.d.ts.map +0 -1
  266. package/dist/shelly.js.map +0 -1
  267. package/dist/storage/export.d.ts +0 -2
  268. package/dist/storage/export.d.ts.map +0 -1
  269. package/dist/storage/export.js.map +0 -1
  270. package/dist/update.d.ts +0 -84
  271. package/dist/update.d.ts.map +0 -1
  272. package/dist/update.js.map +0 -1
  273. package/dist/utils/colorUtils.d.ts +0 -101
  274. package/dist/utils/colorUtils.d.ts.map +0 -1
  275. package/dist/utils/colorUtils.js.map +0 -1
  276. package/dist/utils/commandLine.d.ts +0 -66
  277. package/dist/utils/commandLine.d.ts.map +0 -1
  278. package/dist/utils/commandLine.js.map +0 -1
  279. package/dist/utils/copyDirectory.d.ts +0 -35
  280. package/dist/utils/copyDirectory.d.ts.map +0 -1
  281. package/dist/utils/copyDirectory.js.map +0 -1
  282. package/dist/utils/createDirectory.d.ts +0 -34
  283. package/dist/utils/createDirectory.d.ts.map +0 -1
  284. package/dist/utils/createDirectory.js.map +0 -1
  285. package/dist/utils/createZip.d.ts +0 -39
  286. package/dist/utils/createZip.d.ts.map +0 -1
  287. package/dist/utils/createZip.js.map +0 -1
  288. package/dist/utils/deepCopy.d.ts +0 -32
  289. package/dist/utils/deepCopy.d.ts.map +0 -1
  290. package/dist/utils/deepCopy.js.map +0 -1
  291. package/dist/utils/deepEqual.d.ts +0 -54
  292. package/dist/utils/deepEqual.d.ts.map +0 -1
  293. package/dist/utils/deepEqual.js.map +0 -1
  294. package/dist/utils/error.d.ts +0 -45
  295. package/dist/utils/error.d.ts.map +0 -1
  296. package/dist/utils/error.js.map +0 -1
  297. package/dist/utils/export.d.ts +0 -13
  298. package/dist/utils/export.d.ts.map +0 -1
  299. package/dist/utils/export.js.map +0 -1
  300. package/dist/utils/format.d.ts +0 -53
  301. package/dist/utils/format.d.ts.map +0 -1
  302. package/dist/utils/format.js.map +0 -1
  303. package/dist/utils/hex.d.ts +0 -89
  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 +0 -87
  307. package/dist/utils/inspector.d.ts.map +0 -1
  308. package/dist/utils/inspector.js.map +0 -1
  309. package/dist/utils/isvalid.d.ts +0 -103
  310. package/dist/utils/isvalid.d.ts.map +0 -1
  311. package/dist/utils/isvalid.js.map +0 -1
  312. package/dist/utils/network.d.ts +0 -111
  313. package/dist/utils/network.d.ts.map +0 -1
  314. package/dist/utils/network.js.map +0 -1
  315. package/dist/utils/spawn.d.ts +0 -33
  316. package/dist/utils/spawn.d.ts.map +0 -1
  317. package/dist/utils/spawn.js.map +0 -1
  318. package/dist/utils/tracker.d.ts +0 -108
  319. package/dist/utils/tracker.d.ts.map +0 -1
  320. package/dist/utils/tracker.js.map +0 -1
  321. package/dist/utils/wait.d.ts +0 -54
  322. package/dist/utils/wait.d.ts.map +0 -1
  323. package/dist/utils/wait.js.map +0 -1
  324. package/dist/workerGlobalPrefix.d.ts +0 -25
  325. package/dist/workerGlobalPrefix.d.ts.map +0 -1
  326. package/dist/workerGlobalPrefix.js.map +0 -1
  327. package/dist/workerTypes.d.ts +0 -52
  328. package/dist/workerTypes.d.ts.map +0 -1
  329. package/dist/workerTypes.js.map +0 -1
  330. package/dist/workers.d.ts +0 -69
  331. package/dist/workers.d.ts.map +0 -1
  332. package/dist/workers.js.map +0 -1
package/CHANGELOG.md CHANGED
@@ -28,6 +28,28 @@ Advantages:
28
28
  - individual plugin isolation in childbridge mode;
29
29
  - ability to update the plugin in childbridge mode without restarting matterbridge;
30
30
 
31
+ ## [3.4.3] - 2025-12-12
32
+
33
+ ### Added
34
+
35
+ - [frontend]: Added homepage icon and link to https://matterbridge.io/.
36
+
37
+ ### Changed
38
+
39
+ - [package]: Updated dependencies.
40
+ - [frontend]: Bumped `frontend` version to v.3.3.4.
41
+ - [package]: Changed homepage to https://matterbridge.io.
42
+ - [frontend]: Changed help link to https://matterbridge.io/README.html.
43
+ - [frontend]: Changed changelog link to https://matterbridge.io/CHANGELOG.html.
44
+ - [frontend]: Changed changelog icon to HistoryOutlinedIcon.
45
+
46
+ ### Fixed
47
+
48
+ - [matterbridge]: Plugin version is now updated even if the plugin is disabled.
49
+ - [matterbridge]: Fixed default delay and fixed_delay to 120 seconds.
50
+
51
+ <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
52
+
31
53
  ## [3.4.2] - 2025-12-05
32
54
 
33
55
  ### Race condition
@@ -18,14 +18,14 @@
18
18
 
19
19
  ## Run matterbridge as a daemon with systemctl (Linux only) with local global node_modules
20
20
 
21
- The advantage of this setup is that the global node_modules are private for the user and sudo is not required.
22
-
23
- This configuration uses a private separate npm cache.
21
+ The advantage of this setup is that the global node_modules and npm cache are private for the user and sudo is not required.
24
22
 
25
23
  The service runs rootless like the current user.
26
24
 
27
25
  The storage position is compatible with the traditional setup (~/Matterbridge ~/.matterbridge ~/.mattercert).
28
26
 
27
+ Also various scripts don't work if you choose this configuration.
28
+
29
29
  ### First create the Matterbridge directories and set the correct permissions
30
30
 
31
31
  This will create the required directories if they don't exist
@@ -18,9 +18,7 @@
18
18
 
19
19
  ## Run matterbridge as a daemon with systemctl (Linux only) with user matterbridge and private global node_modules
20
20
 
21
- The advantage of this setup is that the global node_modules are private for matterbridge and sudo is not required.
22
-
23
- This configuration uses a private separate npm cache.
21
+ The advantage of this setup is that the global node_modules and npm cache are private for matterbridge and sudo is not required.
24
22
 
25
23
  The service runs with group and user matterbridge and the system has full protection.
26
24
 
@@ -28,7 +26,7 @@ The service runs with group and user matterbridge and the system has full protec
28
26
 
29
27
  The storage position is **not compatible** with the traditional setup (~/Matterbridge ~/.matterbridge ~/.mattercert).
30
28
 
31
- Also various script don't work if you choose this configuration.
29
+ Also various scripts don't work if you choose this configuration.
32
30
 
33
31
  ### 1 - Create the matterbridge user and group
34
32
 
@@ -62,7 +60,7 @@ sudo chmod -R 755 /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbr
62
60
  # make sure the “bin” dir exists for global executables
63
61
  sudo -u matterbridge mkdir -p /opt/matterbridge/.npm-global/bin
64
62
  # ✅ Install matterbridge in the private global node_modules using the private npm cache
65
- sudo -u matterbridge NPM_CONFIG_PREFIX=/opt/matterbridge/.npm-global NPM_CONFIG_CACHE=/opt/matterbridge/.npm-cache npm install matterbridge --omit=dev --verbose --global
63
+ sudo -u matterbridge npm install matterbridge --omit=dev --verbose --global --prefix=/opt/matterbridge/.npm-global --cache=/opt/matterbridge/.npm-cache
66
64
  # ✅ Create a link to matterbridge bins
67
65
  sudo ln -sf /opt/matterbridge/.npm-global/bin/matterbridge /usr/bin/matterbridge
68
66
  sudo ln -sf /opt/matterbridge/.npm-global/bin/mb_mdns /usr/bin/mb_mdns
package/README.md CHANGED
@@ -178,37 +178,31 @@ Home page
178
178
 
179
179
  ### Run matterbridge as a daemon with systemctl (Linux only)
180
180
 
181
- Traditional configuration
181
+ Traditional configuration: [configuration](README-SERVICE.md)
182
182
 
183
- [Service configurations](README-SERVICE.md)
183
+ or with local global node_modules and npm cache (no sudo required): [configuration](README-SERVICE-LOCAL.md)
184
184
 
185
- or with local global node_modules (no sudo required)
186
-
187
- [Service configurations with local global node_modules](README-SERVICE-LOCAL.md)
188
-
189
- or with user matterbridge and with private global node_modules (no sudo required)
190
-
191
- [Service configurations with user matterbridge and private global node_modules](README-SERVICE-OPT.md)
185
+ or with user matterbridge and with private global node_modules and npm cache (no sudo required): [configuration](README-SERVICE-OPT.md)
192
186
 
193
187
  ### Run matterbridge as a system service with launchctl (macOS only)
194
188
 
195
- [Launchctl configurations](README-MACOS-PLIST.md)
189
+ [Launchctl configuration](README-MACOS-PLIST.md)
196
190
 
197
191
  ### Run matterbridge with docker and docker compose
198
192
 
199
- [Docker configurations](README-DOCKER.md)
193
+ [Docker configuration](README-DOCKER.md)
200
194
 
201
195
  ### Run matterbridge with podman
202
196
 
203
- [Podman configurations](README-PODMAN.md)
197
+ [Podman configuration](README-PODMAN.md)
204
198
 
205
199
  ### Run matterbridge with nginx
206
200
 
207
- [Nginx configurations](README-NGINX.md)
201
+ [Nginx configuration](README-NGINX.md)
208
202
 
209
203
  ### Run matterbridge as an home assistant add-on with the official add-on
210
204
 
211
- [Home assistant add-on configurations](https://github.com/Luligu/matterbridge-home-assistant-addon)
205
+ [Home assistant add-on configuration](https://github.com/Luligu/matterbridge-home-assistant-addon)
212
206
 
213
207
  ### Other Home Assistant Community Add-ons
214
208
 
@@ -1,27 +1,3 @@
1
- /**
2
- * This file contains the BroadcastServer class.
3
- *
4
- * @file broadcastServer.ts
5
- * @author Luca Liguori
6
- * @created 2025-10-05
7
- * @version 2.0.1
8
- * @license Apache-2.0
9
- *
10
- * Copyright 2024, 2025, 2026 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
- // eslint-disable-next-line no-console
25
1
  if (process.argv.includes('--loader') || process.argv.includes('-loader'))
26
2
  console.log('\u001B[32mBroadcastServer loaded.\u001B[40;0m');
27
3
  import { EventEmitter } from 'node:events';
@@ -29,9 +5,6 @@ import { BroadcastChannel } from 'node:worker_threads';
29
5
  import { CYAN, db, debugStringify, er } from 'node-ansi-logger';
30
6
  import { hasParameter } from './utils/commandLine.js';
31
7
  import { logError } from './utils/error.js';
32
- /**
33
- * BroadcastServer class to handle broadcast messages between workers with BroadcastChannel.
34
- */
35
8
  export class BroadcastServer extends EventEmitter {
36
9
  name;
37
10
  log;
@@ -40,42 +13,21 @@ export class BroadcastServer extends EventEmitter {
40
13
  closed = false;
41
14
  debug = hasParameter('debug') || hasParameter('verbose');
42
15
  verbose = hasParameter('verbose');
43
- /**
44
- * Creates an instance of BroadcastServer.
45
- *
46
- * @param {string} name - The name of the broadcast server.
47
- * @param {AnsiLogger} log - The logger instance to use for logging.
48
- * @param {string} channel - The channel name for the broadcast. Default is 'broadcast-channel'.
49
- */
50
16
  constructor(name, log, channel = 'broadcast-channel') {
51
17
  super();
52
18
  this.name = name;
53
19
  this.log = log;
54
20
  this.channel = channel;
55
21
  this.broadcastChannel = new BroadcastChannel(this.channel);
56
- // this.broadcastChannel.unref();
57
22
  this.broadcastChannel.onmessage = this.broadcastMessageHandler.bind(this);
58
23
  this.broadcastChannel.onmessageerror = this.broadcastMessageErrorHandler.bind(this);
59
24
  }
60
- /**
61
- * Closes the broadcast channel.
62
- *
63
- * @returns {void}
64
- */
65
25
  close() {
66
- // @ts-expect-error: wrong type definition in node.d.ts
67
26
  this.broadcastChannel.onmessage = null;
68
- // @ts-expect-error: wrong type definition in node.d.ts
69
27
  this.broadcastChannel.onmessageerror = null;
70
28
  this.broadcastChannel.close();
71
29
  this.closed = true;
72
30
  }
73
- /**
74
- * Handles incoming broadcast messages.
75
- *
76
- * @param {MessageEvent} event - The message event containing the broadcast message.
77
- * @returns {void}
78
- */
79
31
  broadcastMessageHandler(event) {
80
32
  const msg = event.data;
81
33
  if (msg.dst === this.name || msg.dst === 'all') {
@@ -88,30 +40,13 @@ export class BroadcastServer extends EventEmitter {
88
40
  this.log.debug(`Server ${CYAN}${this.name}${db} received unrelated broadcast message: ${debugStringify(msg)}`);
89
41
  }
90
42
  }
91
- /**
92
- * Handles incoming broadcast error messages.
93
- *
94
- * @param {MessageEvent} event - The message event containing the broadcast message.
95
- * @returns {void}
96
- */
97
43
  broadcastMessageErrorHandler(event) {
98
44
  const msg = event.data;
99
45
  this.log.error(`Server ${CYAN}${this.name}${db} received message error: ${debugStringify(msg)}`);
100
46
  }
101
- /**
102
- * Generate a pseudo-random identifier between 100,000,000 and 999,999,999.
103
- *
104
- * @returns {number} A nine-digit identifier.
105
- */
106
47
  getUniqueId() {
107
48
  return Math.floor(Math.random() * 900000000) + 100000000;
108
49
  }
109
- /**
110
- * Type guard to verify a value matches the WorkerMessageRequest structure.
111
- *
112
- * @param {unknown} value Value to test.
113
- * @returns {value is WorkerMessageRequest} True when the value looks like a request message.
114
- */
115
50
  isWorkerRequest(value) {
116
51
  if (typeof value !== 'object' || value === null) {
117
52
  return false;
@@ -122,22 +57,9 @@ export class BroadcastServer extends EventEmitter {
122
57
  }
123
58
  return message.result === undefined && message.error === undefined;
124
59
  }
125
- /**
126
- * Type guard to verify a value matches a specific WorkerMessageRequest structure.
127
- *
128
- * @param {unknown} value Value to test.
129
- * @param {K} type Worker message type to match.
130
- * @returns {value is WorkerMessageRequest<K>} True when the value looks like a request message of the requested type.
131
- */
132
60
  isWorkerRequestOfType(value, type) {
133
61
  return this.isWorkerRequest(value) && value.type === type;
134
62
  }
135
- /**
136
- * Type guard to verify a value matches the WorkerMessageResponse structure.
137
- *
138
- * @param {unknown} value Value to test.
139
- * @returns {value is WorkerMessageResponse} True when the value looks like a response message.
140
- */
141
63
  isWorkerResponse(value) {
142
64
  if (typeof value !== 'object' || value === null) {
143
65
  return false;
@@ -150,24 +72,9 @@ export class BroadcastServer extends EventEmitter {
150
72
  const hasResult = message.result !== undefined;
151
73
  return hasError !== hasResult;
152
74
  }
153
- /**
154
- * Type guard to verify a value matches a specific WorkerMessageResponse structure.
155
- *
156
- * @param {unknown} value Value to test.
157
- * @param {K} type Worker message type to match.
158
- * @returns {value is WorkerMessageResponse<K>} True when the value looks like a response message of the requested type.
159
- */
160
75
  isWorkerResponseOfType(value, type) {
161
76
  return this.isWorkerResponse(value) && value.type === type;
162
77
  }
163
- /**
164
- * Broadcast a message to all workers.
165
- *
166
- * @param {WorkerMessage} message - The message to broadcast.
167
- * @returns {void}
168
- *
169
- * @remarks No checks are performed on the message structure.
170
- */
171
78
  broadcast(message) {
172
79
  if (this.closed) {
173
80
  this.log.error('Broadcast channel is closed');
@@ -189,13 +96,6 @@ export class BroadcastServer extends EventEmitter {
189
96
  logError(this.log, `Failed to broadcast message ${debugStringify(message)}${er}`, error);
190
97
  }
191
98
  }
192
- /**
193
- * Send a request message from the worker implementation.
194
- *
195
- * @template K
196
- * @param {WorkerMessageRequest<K>} message The request message to send.
197
- * @returns {void}
198
- */
199
99
  request(message) {
200
100
  if (this.closed) {
201
101
  this.log.error('Broadcast channel is closed');
@@ -221,14 +121,6 @@ export class BroadcastServer extends EventEmitter {
221
121
  logError(this.log, `Failed to broadcast request message ${debugStringify(message)}${er}`, error);
222
122
  }
223
123
  }
224
- /**
225
- * Send a response message from the worker implementation.
226
- * It also calculates the elapsed time since the request was sent and swaps the source and destination fields.
227
- *
228
- * @template K
229
- * @param {WorkerMessageResponse<K>} message The response message to send.
230
- * @returns {void}
231
- */
232
124
  respond(message) {
233
125
  if (this.closed) {
234
126
  this.log.error('Broadcast channel is closed');
@@ -257,16 +149,6 @@ export class BroadcastServer extends EventEmitter {
257
149
  logError(this.log, `Failed to broadcast response message ${debugStringify(message)}${er}`, error);
258
150
  }
259
151
  }
260
- /**
261
- * Fetch data from a worker.
262
- * It broadcasts a request message and waits for a valid response with the same id.
263
- *
264
- * @template K
265
- * @param {WorkerMessageRequest<K>} message - The typed request message to fetch.
266
- * @param {number} timeout - The timeout in milliseconds to wait for a response. Default is 250ms.
267
- * @returns {Promise<WorkerMessageResponseSuccess<K>>} A promise that resolves with the successful response from the worker or rejects on timeout.
268
- * @throws {Error} If the fetch operation times out after 250ms or if an error response is received or if the response is malformed.
269
- */
270
152
  async fetch(message, timeout = 250) {
271
153
  if (this.closed) {
272
154
  return Promise.reject(new Error('Broadcast channel is closed'));
@@ -307,4 +189,3 @@ export class BroadcastServer extends EventEmitter {
307
189
  });
308
190
  }
309
191
  }
310
- //# sourceMappingURL=broadcastServer.js.map
@@ -1,25 +1 @@
1
- /**
2
- * This file contains the BroadcastServer types.
3
- *
4
- * @file broadcastServerTypes.ts
5
- * @author Luca Liguori
6
- * @created 2025-10-05
7
- * @version 2.0.0
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
  export {};
25
- //# sourceMappingURL=broadcastServerTypes.js.map
package/dist/cli.js CHANGED
@@ -1,33 +1,6 @@
1
- /**
2
- * This file contains the CLI entry point of Matterbridge.
3
- *
4
- * @file cli.ts
5
- * @author Luca Liguori
6
- * @created 2023-12-29
7
- * @version 3.0.0
8
- * @license Apache-2.0
9
- *
10
- * Copyright 2023, 2024, 2025 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
- /* eslint-disable no-console */
25
- /* eslint-disable n/no-process-exit */
26
1
  if (process.argv.includes('--loader') || process.argv.includes('-loader'))
27
2
  console.log('\u001B[32mCli loaded.\u001B[40;0m');
28
- // AnsiLogger module
29
3
  import { AnsiLogger } from 'node-ansi-logger';
30
- // Cli
31
4
  import { cliEmitter } from './cliEmitter.js';
32
5
  import { hasParameter, hasAnyParameter } from './utils/commandLine.js';
33
6
  import { inspectError } from './utils/error.js';
@@ -37,10 +10,7 @@ import { formatBytes, formatUptime } from './utils/format.js';
37
10
  export let instance;
38
11
  export const tracker = new Tracker('Cli', false, false);
39
12
  export const inspector = new Inspector('Cli', false, false);
40
- const log = new AnsiLogger({ logName: 'Cli', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: hasParameter('debug') ? "debug" /* LogLevel.DEBUG */ : "info" /* LogLevel.INFO */ });
41
- /**
42
- * Starts the CPU and memory tracker.
43
- */
13
+ const log = new AnsiLogger({ logName: 'Cli', logTimestampFormat: 4, logLevel: hasParameter('debug') ? "debug" : "info" });
44
14
  function startCpuMemoryCheck() {
45
15
  log.debug(`Cpu memory check starting...`);
46
16
  tracker.start();
@@ -53,50 +23,26 @@ function startCpuMemoryCheck() {
53
23
  });
54
24
  log.debug(`Cpu memory check started`);
55
25
  }
56
- /**
57
- * Stops the CPU and memory tracker.
58
- */
59
26
  function stopCpuMemoryCheck() {
60
27
  log.debug(`Cpu memory check stopping...`);
61
28
  tracker.stop();
62
29
  tracker.removeAllListeners();
63
30
  log.debug(`Cpu memory check stopped`);
64
31
  }
65
- /**
66
- * Starts the inspector for heap sampling.
67
- * This function is called when the -inspect parameter is passed.
68
- */
69
32
  async function startInspector() {
70
33
  await inspector.start();
71
34
  }
72
- /**
73
- * Stops the heap sampling and saves the profile.
74
- * This function is called when the -inspect parameter is passed.
75
- */
76
35
  async function stopInspector() {
77
36
  await inspector.stop();
78
37
  }
79
- /**
80
- * Takes a heap snapshot
81
- */
82
38
  async function takeHeapSnapshot() {
83
39
  await inspector.takeHeapSnapshot();
84
40
  }
85
- /**
86
- * Triggers a manual garbage collection.
87
- * This function is working only if the node process is started with --expose_gc.
88
- *
89
- * @remarks To check the effect of the garbage collection, add also --trace_gc or --trace_gc_verbose.
90
- */
91
41
  function triggerGarbageCollection() {
92
42
  inspector.runGarbageCollector();
93
43
  }
94
- /**
95
- * Registers event handlers for the Matterbridge instance.
96
- */
97
44
  function registerHandlers() {
98
45
  log.debug('Registering event handlers...');
99
- // istanbul ignore next cause registerHandlers is called only if instance is defined
100
46
  if (!instance)
101
47
  return;
102
48
  instance.on('shutdown', () => shutdown());
@@ -110,9 +56,6 @@ function registerHandlers() {
110
56
  instance.on('triggergarbagecollection', () => triggerGarbageCollection());
111
57
  log.debug('Registered event handlers');
112
58
  }
113
- /**
114
- * Shuts down the Matterbridge instance and exits the process.
115
- */
116
59
  async function shutdown() {
117
60
  log.debug('Received shutdown event, exiting...');
118
61
  if (hasParameter('inspect'))
@@ -121,56 +64,26 @@ async function shutdown() {
121
64
  cliEmitter.emit('shutdown');
122
65
  process.exit(0);
123
66
  }
124
- /**
125
- * Restarts the Matterbridge instance.
126
- */
127
67
  async function restart() {
128
68
  log.debug('Received restart event, loading...');
129
69
  const { Matterbridge } = await import('./matterbridge.js');
130
70
  instance = await Matterbridge.loadInstance(true);
131
71
  registerHandlers();
132
72
  }
133
- /**
134
- * Updates the Matterbridge instance.
135
- */
136
73
  async function update() {
137
74
  log.debug('Received update event, updating...');
138
- // TODO: Implement update logic outside of matterbridge
139
75
  const { Matterbridge } = await import('./matterbridge.js');
140
76
  instance = await Matterbridge.loadInstance(true);
141
77
  registerHandlers();
142
78
  }
143
- /**
144
- * Starts the CPU and memory check when the -startmemorycheck parameter is passed.
145
- */
146
79
  function start() {
147
80
  log.debug('Received start memory check event');
148
81
  startCpuMemoryCheck();
149
82
  }
150
- /**
151
- * Stops the CPU and memory check when the -stopmemorycheck parameter is passed.
152
- */
153
83
  function stop() {
154
84
  log.debug('Received stop memory check event');
155
85
  stopCpuMemoryCheck();
156
86
  }
157
- /**
158
- * Main function that initializes the Matterbridge instance and starts the CLI.
159
- *
160
- * @remarks
161
- *
162
- * Debug parameters:
163
- *
164
- * --debug enables debug logging.
165
- *
166
- * --verbose enables verbose logging.
167
- *
168
- * --loader enables loader logging.
169
- *
170
- * --inspect enables the inspector for heap sampling.
171
- *
172
- * --snapshotinterval <milliseconds> can be used to set the heap snapshot interval. Default is undefined. Minimum is 30000 ms.
173
- */
174
87
  async function main() {
175
88
  log.debug(`Cli main() started`);
176
89
  startCpuMemoryCheck();
@@ -180,7 +93,6 @@ async function main() {
180
93
  const { Matterbridge } = await import('./matterbridge.js');
181
94
  instance = await Matterbridge.loadInstance(true);
182
95
  log.debug(`***Matterbridge.loadInstance(true) exited`);
183
- // Check if the instance needs to shut down from parseCommandLine()
184
96
  if (!instance || instance.shutdown) {
185
97
  shutdown();
186
98
  }
@@ -198,18 +110,11 @@ main().catch((error) => {
198
110
  inspectError(log, 'Matterbridge.loadInstance() failed with error', error);
199
111
  shutdown();
200
112
  });
201
- /**
202
- * Displays the version.
203
- */
204
113
  async function version() {
205
- // Dynamic JSON import (Node >= 20) with import attributes
206
114
  const { default: pkg } = await import('../package.json', { with: { type: 'json' } });
207
115
  console.log(`Matterbridge version ${pkg.version}`);
208
116
  process.exit(0);
209
117
  }
210
- /**
211
- * Displays the help.
212
- */
213
118
  function help() {
214
119
  console.log(`
215
120
  Usage: matterbridge [options] [command]
@@ -260,7 +165,8 @@ function help() {
260
165
  --service: enable the service mode (used in the linux systemctl configuration file and macOS launchctl plist)
261
166
  --docker: enable the docker mode (used in the docker image)
262
167
  --homedir: override the home directory (default the os homedir)
168
+ --delay [seconds]: set a delay in seconds before starting Matterbridge in the first 5 minutes from a reboot (default 120)
169
+ --fixed_delay [seconds]: set a fixed delay in seconds before starting Matterbridge (default 120)
263
170
  `);
264
171
  process.exit(0);
265
172
  }
266
- //# sourceMappingURL=cli.js.map
@@ -1,49 +1,12 @@
1
- /**
2
- * This file contains the CLI emitter.
3
- *
4
- * @file cliEmitter.ts
5
- * @author Luca Liguori
6
- * @created 2025-07-04
7
- * @version 1.0.2
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
- // eslint-disable-next-line no-console
25
1
  if (process.argv.includes('--loader') || process.argv.includes('-loader'))
26
2
  console.log('\u001B[32mCli emitter loaded.\u001B[40;0m');
27
3
  import { EventEmitter } from 'node:events';
28
4
  export const cliEmitter = new EventEmitter();
29
5
  export let lastOsCpuUsage = 0;
30
6
  export let lastProcessCpuUsage = 0;
31
- /**
32
- * Sets the last os CPU usage.
33
- *
34
- * @param {number} val - The os CPU usage percentage to set.
35
- * @returns {void}
36
- */
37
7
  export function setLastOsCpuUsage(val) {
38
8
  lastOsCpuUsage = val;
39
9
  }
40
- /**
41
- * Sets the last process CPU usage.
42
- *
43
- * @param {number} val - The process CPU usage percentage to set.
44
- * @returns {void}
45
- */
46
10
  export function setLastProcessCpuUsage(val) {
47
11
  lastProcessCpuUsage = val;
48
12
  }
49
- //# sourceMappingURL=cliEmitter.js.map
@@ -1,40 +1,9 @@
1
- /**
2
- * This file contains the CLI history page generator.
3
- *
4
- * @file cliHistory.ts
5
- * @author Luca Liguori
6
- * @created 2025-10-09
7
- * @version 1.0.1
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
- // eslint-disable-next-line no-console
25
1
  if (process.argv.includes('--loader') || process.argv.includes('-loader'))
26
2
  console.log('\u001B[32mCli history loaded.\u001B[40;0m');
27
3
  import { writeFileSync } from 'node:fs';
28
4
  import path from 'node:path';
29
5
  import os from 'node:os';
30
6
  import { Tracker } from './utils/tracker.js';
31
- /**
32
- * Generates a static HTML dashboard displaying CPU and memory history.
33
- *
34
- * @param {GenerateHistoryPageOptions} [options] - Optional configuration for output path, page title, and refresh interval.
35
- *
36
- * @returns {string | undefined} The absolute path to the generated HTML file, or undefined if no samples exist.
37
- */
38
7
  export function generateHistoryPage(options = {}) {
39
8
  const pageTitle = options.pageTitle ?? 'Matterbridge CPU & Memory History';
40
9
  const hostname = options.hostname ?? os.hostname();
@@ -814,13 +783,6 @@ export function generateHistoryPage(options = {}) {
814
783
  writeFileSync(outputPath, html, { encoding: 'utf-8' });
815
784
  return outputPath;
816
785
  }
817
- /**
818
- * Escapes HTML special characters to prevent breaking embedded markup.
819
- *
820
- * @param {string} input - The string to escape.
821
- * @returns {string} The escaped string safe for HTML contexts.
822
- */
823
786
  function escapeHtml(input) {
824
787
  return input.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
825
788
  }
826
- //# sourceMappingURL=cliHistory.js.map
@@ -1,3 +1 @@
1
1
  export {};
2
- // Nothing to export right now, but this file is here to make it easier to add exports in the future
3
- //# sourceMappingURL=export.js.map