matterbridge 3.4.7-dev-20260113-0917d83 → 3.4.7

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 (438) hide show
  1. package/dist/broadcastServer.d.ts +115 -0
  2. package/dist/broadcastServer.d.ts.map +1 -0
  3. package/dist/broadcastServer.js +117 -0
  4. package/dist/broadcastServer.js.map +1 -0
  5. package/dist/broadcastServerTypes.d.ts +43 -0
  6. package/dist/broadcastServerTypes.d.ts.map +1 -0
  7. package/dist/broadcastServerTypes.js +24 -0
  8. package/dist/broadcastServerTypes.js.map +1 -0
  9. package/dist/cli.d.ts +24 -0
  10. package/dist/cli.d.ts.map +1 -0
  11. package/dist/cli.js +97 -1
  12. package/dist/cli.js.map +1 -0
  13. package/dist/cliEmitter.d.ts +36 -0
  14. package/dist/cliEmitter.d.ts.map +1 -0
  15. package/dist/cliEmitter.js +37 -0
  16. package/dist/cliEmitter.js.map +1 -0
  17. package/dist/cliHistory.d.ts +42 -0
  18. package/dist/cliHistory.d.ts.map +1 -0
  19. package/dist/cliHistory.js +38 -0
  20. package/dist/cliHistory.js.map +1 -0
  21. package/dist/clusters/export.d.ts +1 -0
  22. package/dist/clusters/export.d.ts.map +1 -0
  23. package/dist/clusters/export.js +2 -0
  24. package/dist/clusters/export.js.map +1 -0
  25. package/dist/deviceManager.d.ts +108 -0
  26. package/dist/deviceManager.d.ts.map +1 -0
  27. package/dist/deviceManager.js +113 -1
  28. package/dist/deviceManager.js.map +1 -0
  29. package/dist/devices/airConditioner.d.ts +75 -0
  30. package/dist/devices/airConditioner.d.ts.map +1 -0
  31. package/dist/devices/airConditioner.js +57 -0
  32. package/dist/devices/airConditioner.js.map +1 -0
  33. package/dist/devices/batteryStorage.d.ts +43 -0
  34. package/dist/devices/batteryStorage.d.ts.map +1 -0
  35. package/dist/devices/batteryStorage.js +48 -1
  36. package/dist/devices/batteryStorage.js.map +1 -0
  37. package/dist/devices/cooktop.d.ts +55 -0
  38. package/dist/devices/cooktop.d.ts.map +1 -0
  39. package/dist/devices/cooktop.js +56 -0
  40. package/dist/devices/cooktop.js.map +1 -0
  41. package/dist/devices/dishwasher.d.ts +55 -0
  42. package/dist/devices/dishwasher.d.ts.map +1 -0
  43. package/dist/devices/dishwasher.js +57 -0
  44. package/dist/devices/dishwasher.js.map +1 -0
  45. package/dist/devices/evse.d.ts +57 -0
  46. package/dist/devices/evse.d.ts.map +1 -0
  47. package/dist/devices/evse.js +74 -10
  48. package/dist/devices/evse.js.map +1 -0
  49. package/dist/devices/export.d.ts +1 -0
  50. package/dist/devices/export.d.ts.map +1 -0
  51. package/dist/devices/export.js +5 -0
  52. package/dist/devices/export.js.map +1 -0
  53. package/dist/devices/extractorHood.d.ts +41 -0
  54. package/dist/devices/extractorHood.d.ts.map +1 -0
  55. package/dist/devices/extractorHood.js +43 -0
  56. package/dist/devices/extractorHood.js.map +1 -0
  57. package/dist/devices/heatPump.d.ts +43 -0
  58. package/dist/devices/heatPump.d.ts.map +1 -0
  59. package/dist/devices/heatPump.js +50 -2
  60. package/dist/devices/heatPump.js.map +1 -0
  61. package/dist/devices/laundryDryer.d.ts +58 -0
  62. package/dist/devices/laundryDryer.d.ts.map +1 -0
  63. package/dist/devices/laundryDryer.js +62 -3
  64. package/dist/devices/laundryDryer.js.map +1 -0
  65. package/dist/devices/laundryWasher.d.ts +64 -0
  66. package/dist/devices/laundryWasher.d.ts.map +1 -0
  67. package/dist/devices/laundryWasher.js +70 -4
  68. package/dist/devices/laundryWasher.js.map +1 -0
  69. package/dist/devices/microwaveOven.d.ts +77 -1
  70. package/dist/devices/microwaveOven.d.ts.map +1 -0
  71. package/dist/devices/microwaveOven.js +88 -5
  72. package/dist/devices/microwaveOven.js.map +1 -0
  73. package/dist/devices/oven.d.ts +82 -0
  74. package/dist/devices/oven.d.ts.map +1 -0
  75. package/dist/devices/oven.js +85 -0
  76. package/dist/devices/oven.js.map +1 -0
  77. package/dist/devices/refrigerator.d.ts +100 -0
  78. package/dist/devices/refrigerator.d.ts.map +1 -0
  79. package/dist/devices/refrigerator.js +102 -0
  80. package/dist/devices/refrigerator.js.map +1 -0
  81. package/dist/devices/roboticVacuumCleaner.d.ts +83 -0
  82. package/dist/devices/roboticVacuumCleaner.d.ts.map +1 -0
  83. package/dist/devices/roboticVacuumCleaner.js +100 -9
  84. package/dist/devices/roboticVacuumCleaner.js.map +1 -0
  85. package/dist/devices/solarPower.d.ts +36 -0
  86. package/dist/devices/solarPower.d.ts.map +1 -0
  87. package/dist/devices/solarPower.js +38 -0
  88. package/dist/devices/solarPower.js.map +1 -0
  89. package/dist/devices/speaker.d.ts +79 -0
  90. package/dist/devices/speaker.d.ts.map +1 -0
  91. package/dist/devices/speaker.js +84 -0
  92. package/dist/devices/speaker.js.map +1 -0
  93. package/dist/devices/temperatureControl.d.ts +21 -0
  94. package/dist/devices/temperatureControl.d.ts.map +1 -0
  95. package/dist/devices/temperatureControl.js +24 -3
  96. package/dist/devices/temperatureControl.js.map +1 -0
  97. package/dist/devices/waterHeater.d.ts +74 -0
  98. package/dist/devices/waterHeater.d.ts.map +1 -0
  99. package/dist/devices/waterHeater.js +82 -2
  100. package/dist/devices/waterHeater.js.map +1 -0
  101. package/dist/dgram/coap.d.ts +171 -0
  102. package/dist/dgram/coap.d.ts.map +1 -0
  103. package/dist/dgram/coap.js +126 -13
  104. package/dist/dgram/coap.js.map +1 -0
  105. package/dist/dgram/dgram.d.ts +99 -0
  106. package/dist/dgram/dgram.d.ts.map +1 -0
  107. package/dist/dgram/dgram.js +114 -2
  108. package/dist/dgram/dgram.js.map +1 -0
  109. package/dist/dgram/mb_coap.d.ts +23 -0
  110. package/dist/dgram/mb_coap.d.ts.map +1 -0
  111. package/dist/dgram/mb_coap.js +41 -3
  112. package/dist/dgram/mb_coap.js.map +1 -0
  113. package/dist/dgram/mb_mdns.d.ts +23 -0
  114. package/dist/dgram/mb_mdns.d.ts.map +1 -0
  115. package/dist/dgram/mb_mdns.js +80 -24
  116. package/dist/dgram/mb_mdns.js.map +1 -0
  117. package/dist/dgram/mdns.d.ts +187 -4
  118. package/dist/dgram/mdns.d.ts.map +1 -0
  119. package/dist/dgram/mdns.js +371 -139
  120. package/dist/dgram/mdns.js.map +1 -0
  121. package/dist/dgram/multicast.d.ts +49 -0
  122. package/dist/dgram/multicast.d.ts.map +1 -0
  123. package/dist/dgram/multicast.js +62 -1
  124. package/dist/dgram/multicast.js.map +1 -0
  125. package/dist/dgram/unicast.d.ts +53 -0
  126. package/dist/dgram/unicast.d.ts.map +1 -0
  127. package/dist/dgram/unicast.js +60 -0
  128. package/dist/dgram/unicast.js.map +1 -0
  129. package/dist/frontend.d.ts +187 -0
  130. package/dist/frontend.d.ts.map +1 -0
  131. package/dist/frontend.js +485 -38
  132. package/dist/frontend.js.map +1 -0
  133. package/dist/frontendTypes.d.ts +57 -0
  134. package/dist/frontendTypes.d.ts.map +1 -0
  135. package/dist/frontendTypes.js +45 -0
  136. package/dist/frontendTypes.js.map +1 -0
  137. package/dist/helpers.d.ts +43 -0
  138. package/dist/helpers.d.ts.map +1 -0
  139. package/dist/helpers.js +53 -0
  140. package/dist/helpers.js.map +1 -0
  141. package/dist/index.d.ts +23 -0
  142. package/dist/index.d.ts.map +1 -0
  143. package/dist/index.js +25 -0
  144. package/dist/index.js.map +1 -0
  145. package/dist/jestutils/export.d.ts +1 -0
  146. package/dist/jestutils/export.d.ts.map +1 -0
  147. package/dist/jestutils/export.js +1 -0
  148. package/dist/jestutils/export.js.map +1 -0
  149. package/dist/jestutils/jestHelpers.d.ts +255 -0
  150. package/dist/jestutils/jestHelpers.d.ts.map +1 -0
  151. package/dist/jestutils/jestHelpers.js +371 -14
  152. package/dist/jestutils/jestHelpers.js.map +1 -0
  153. package/dist/logger/export.d.ts +1 -0
  154. package/dist/logger/export.d.ts.map +1 -0
  155. package/dist/logger/export.js +1 -0
  156. package/dist/logger/export.js.map +1 -0
  157. package/dist/matter/behaviors.d.ts +1 -0
  158. package/dist/matter/behaviors.d.ts.map +1 -0
  159. package/dist/matter/behaviors.js +2 -0
  160. package/dist/matter/behaviors.js.map +1 -0
  161. package/dist/matter/clusters.d.ts +1 -0
  162. package/dist/matter/clusters.d.ts.map +1 -0
  163. package/dist/matter/clusters.js +2 -0
  164. package/dist/matter/clusters.js.map +1 -0
  165. package/dist/matter/devices.d.ts +1 -0
  166. package/dist/matter/devices.d.ts.map +1 -0
  167. package/dist/matter/devices.js +2 -0
  168. package/dist/matter/devices.js.map +1 -0
  169. package/dist/matter/endpoints.d.ts +1 -0
  170. package/dist/matter/endpoints.d.ts.map +1 -0
  171. package/dist/matter/endpoints.js +2 -0
  172. package/dist/matter/endpoints.js.map +1 -0
  173. package/dist/matter/export.d.ts +1 -0
  174. package/dist/matter/export.d.ts.map +1 -0
  175. package/dist/matter/export.js +3 -0
  176. package/dist/matter/export.js.map +1 -0
  177. package/dist/matter/types.d.ts +1 -0
  178. package/dist/matter/types.d.ts.map +1 -0
  179. package/dist/matter/types.js +3 -0
  180. package/dist/matter/types.js.map +1 -0
  181. package/dist/matterNode.d.ts +258 -0
  182. package/dist/matterNode.d.ts.map +1 -0
  183. package/dist/matterNode.js +369 -8
  184. package/dist/matterNode.js.map +1 -0
  185. package/dist/matterbridge.d.ts +353 -0
  186. package/dist/matterbridge.d.ts.map +1 -0
  187. package/dist/matterbridge.js +824 -46
  188. package/dist/matterbridge.js.map +1 -0
  189. package/dist/matterbridgeAccessoryPlatform.d.ts +36 -0
  190. package/dist/matterbridgeAccessoryPlatform.d.ts.map +1 -0
  191. package/dist/matterbridgeAccessoryPlatform.js +38 -0
  192. package/dist/matterbridgeAccessoryPlatform.js.map +1 -0
  193. package/dist/matterbridgeBehaviors.d.ts +24 -0
  194. package/dist/matterbridgeBehaviors.d.ts.map +1 -0
  195. package/dist/matterbridgeBehaviors.js +68 -5
  196. package/dist/matterbridgeBehaviors.js.map +1 -0
  197. package/dist/matterbridgeDeviceTypes.d.ts +603 -0
  198. package/dist/matterbridgeDeviceTypes.d.ts.map +1 -0
  199. package/dist/matterbridgeDeviceTypes.js +635 -14
  200. package/dist/matterbridgeDeviceTypes.js.map +1 -0
  201. package/dist/matterbridgeDynamicPlatform.d.ts +36 -0
  202. package/dist/matterbridgeDynamicPlatform.d.ts.map +1 -0
  203. package/dist/matterbridgeDynamicPlatform.js +38 -0
  204. package/dist/matterbridgeDynamicPlatform.js.map +1 -0
  205. package/dist/matterbridgeEndpoint.d.ts +1332 -0
  206. package/dist/matterbridgeEndpoint.d.ts.map +1 -0
  207. package/dist/matterbridgeEndpoint.js +1457 -53
  208. package/dist/matterbridgeEndpoint.js.map +1 -0
  209. package/dist/matterbridgeEndpointHelpers.d.ts +425 -0
  210. package/dist/matterbridgeEndpointHelpers.d.ts.map +1 -0
  211. package/dist/matterbridgeEndpointHelpers.js +483 -20
  212. package/dist/matterbridgeEndpointHelpers.js.map +1 -0
  213. package/dist/matterbridgeEndpointTypes.d.ts +70 -0
  214. package/dist/matterbridgeEndpointTypes.d.ts.map +1 -0
  215. package/dist/matterbridgeEndpointTypes.js +25 -0
  216. package/dist/matterbridgeEndpointTypes.js.map +1 -0
  217. package/dist/matterbridgePlatform.d.ts +425 -0
  218. package/dist/matterbridgePlatform.d.ts.map +1 -0
  219. package/dist/matterbridgePlatform.js +451 -1
  220. package/dist/matterbridgePlatform.js.map +1 -0
  221. package/dist/matterbridgeTypes.d.ts +46 -0
  222. package/dist/matterbridgeTypes.d.ts.map +1 -0
  223. package/dist/matterbridgeTypes.js +26 -0
  224. package/dist/matterbridgeTypes.js.map +1 -0
  225. package/dist/pluginManager.d.ts +305 -0
  226. package/dist/pluginManager.d.ts.map +1 -0
  227. package/dist/pluginManager.js +341 -5
  228. package/dist/pluginManager.js.map +1 -0
  229. package/dist/shelly.d.ts +157 -0
  230. package/dist/shelly.d.ts.map +1 -0
  231. package/dist/shelly.js +178 -7
  232. package/dist/shelly.js.map +1 -0
  233. package/dist/storage/export.d.ts +1 -0
  234. package/dist/storage/export.d.ts.map +1 -0
  235. package/dist/storage/export.js +1 -0
  236. package/dist/storage/export.js.map +1 -0
  237. package/dist/update.d.ts +75 -0
  238. package/dist/update.d.ts.map +1 -0
  239. package/dist/update.js +93 -1
  240. package/dist/update.js.map +1 -0
  241. package/dist/utils/colorUtils.d.ts +77 -0
  242. package/dist/utils/colorUtils.d.ts.map +1 -0
  243. package/dist/utils/colorUtils.js +97 -2
  244. package/dist/utils/colorUtils.js.map +1 -0
  245. package/dist/utils/commandLine.d.ts +60 -0
  246. package/dist/utils/commandLine.d.ts.map +1 -0
  247. package/dist/utils/commandLine.js +60 -0
  248. package/dist/utils/commandLine.js.map +1 -0
  249. package/dist/utils/copyDirectory.d.ts +33 -0
  250. package/dist/utils/copyDirectory.d.ts.map +1 -0
  251. package/dist/utils/copyDirectory.js +37 -0
  252. package/dist/utils/copyDirectory.js.map +1 -0
  253. package/dist/utils/createDirectory.d.ts +32 -0
  254. package/dist/utils/createDirectory.d.ts.map +1 -0
  255. package/dist/utils/createDirectory.js +33 -0
  256. package/dist/utils/createDirectory.js.map +1 -0
  257. package/dist/utils/createZip.d.ts +38 -0
  258. package/dist/utils/createZip.d.ts.map +1 -0
  259. package/dist/utils/createZip.js +47 -2
  260. package/dist/utils/createZip.js.map +1 -0
  261. package/dist/utils/deepCopy.d.ts +31 -0
  262. package/dist/utils/deepCopy.d.ts.map +1 -0
  263. package/dist/utils/deepCopy.js +39 -0
  264. package/dist/utils/deepCopy.js.map +1 -0
  265. package/dist/utils/deepEqual.d.ts +53 -0
  266. package/dist/utils/deepEqual.d.ts.map +1 -0
  267. package/dist/utils/deepEqual.js +72 -1
  268. package/dist/utils/deepEqual.js.map +1 -0
  269. package/dist/utils/error.d.ts +42 -0
  270. package/dist/utils/error.d.ts.map +1 -0
  271. package/dist/utils/error.js +42 -0
  272. package/dist/utils/error.js.map +1 -0
  273. package/dist/utils/export.d.ts +1 -0
  274. package/dist/utils/export.d.ts.map +1 -0
  275. package/dist/utils/export.js +1 -0
  276. package/dist/utils/export.js.map +1 -0
  277. package/dist/utils/format.d.ts +49 -0
  278. package/dist/utils/format.d.ts.map +1 -0
  279. package/dist/utils/format.js +49 -0
  280. package/dist/utils/format.js.map +1 -0
  281. package/dist/utils/hex.d.ts +85 -0
  282. package/dist/utils/hex.d.ts.map +1 -0
  283. package/dist/utils/hex.js +124 -0
  284. package/dist/utils/hex.js.map +1 -0
  285. package/dist/utils/inspector.d.ts +63 -0
  286. package/dist/utils/inspector.d.ts.map +1 -0
  287. package/dist/utils/inspector.js +69 -1
  288. package/dist/utils/inspector.js.map +1 -0
  289. package/dist/utils/isValid.d.ts +93 -0
  290. package/dist/utils/isValid.d.ts.map +1 -0
  291. package/dist/utils/isValid.js +93 -0
  292. package/dist/utils/isValid.js.map +1 -0
  293. package/dist/utils/network.d.ts +116 -0
  294. package/dist/utils/network.d.ts.map +1 -0
  295. package/dist/utils/network.js +126 -5
  296. package/dist/utils/network.js.map +1 -0
  297. package/dist/utils/spawn.d.ts +32 -0
  298. package/dist/utils/spawn.d.ts.map +1 -0
  299. package/dist/utils/spawn.js +71 -1
  300. package/dist/utils/spawn.js.map +1 -0
  301. package/dist/utils/tracker.d.ts +56 -0
  302. package/dist/utils/tracker.d.ts.map +1 -0
  303. package/dist/utils/tracker.js +64 -1
  304. package/dist/utils/tracker.js.map +1 -0
  305. package/dist/utils/wait.d.ts +51 -0
  306. package/dist/utils/wait.d.ts.map +1 -0
  307. package/dist/utils/wait.js +60 -8
  308. package/dist/utils/wait.js.map +1 -0
  309. package/dist/workerGlobalPrefix.d.ts +24 -0
  310. package/dist/workerGlobalPrefix.d.ts.map +1 -0
  311. package/dist/workerGlobalPrefix.js +37 -5
  312. package/dist/workerGlobalPrefix.js.map +1 -0
  313. package/dist/workerTypes.d.ts +25 -0
  314. package/dist/workerTypes.d.ts.map +1 -0
  315. package/dist/workerTypes.js +24 -0
  316. package/dist/workerTypes.js.map +1 -0
  317. package/dist/workers.d.ts +61 -0
  318. package/dist/workers.d.ts.map +1 -0
  319. package/dist/workers.js +68 -4
  320. package/dist/workers.js.map +1 -0
  321. package/npm-shrinkwrap.json +2 -2
  322. package/package.json +2 -1
  323. package/packages/dgram/dist/coap.d.ts +171 -0
  324. package/packages/dgram/dist/coap.d.ts.map +1 -0
  325. package/packages/dgram/dist/coap.js +126 -13
  326. package/packages/dgram/dist/coap.js.map +1 -0
  327. package/packages/dgram/dist/dgram.d.ts +99 -0
  328. package/packages/dgram/dist/dgram.d.ts.map +1 -0
  329. package/packages/dgram/dist/dgram.js +115 -3
  330. package/packages/dgram/dist/dgram.js.map +1 -0
  331. package/packages/dgram/dist/export.d.ts +1 -0
  332. package/packages/dgram/dist/export.d.ts.map +1 -0
  333. package/packages/dgram/dist/export.js +1 -0
  334. package/packages/dgram/dist/export.js.map +1 -0
  335. package/packages/dgram/dist/mdns.d.ts +187 -4
  336. package/packages/dgram/dist/mdns.d.ts.map +1 -0
  337. package/packages/dgram/dist/mdns.js +371 -139
  338. package/packages/dgram/dist/mdns.js.map +1 -0
  339. package/packages/dgram/dist/multicast.d.ts +49 -0
  340. package/packages/dgram/dist/multicast.d.ts.map +1 -0
  341. package/packages/dgram/dist/multicast.js +62 -1
  342. package/packages/dgram/dist/multicast.js.map +1 -0
  343. package/packages/dgram/dist/unicast.d.ts +53 -0
  344. package/packages/dgram/dist/unicast.d.ts.map +1 -0
  345. package/packages/dgram/dist/unicast.js +60 -0
  346. package/packages/dgram/dist/unicast.js.map +1 -0
  347. package/packages/jest-utils/dist/export.d.ts +1 -0
  348. package/packages/jest-utils/dist/export.d.ts.map +1 -0
  349. package/packages/jest-utils/dist/export.js +1 -0
  350. package/packages/jest-utils/dist/export.js.map +1 -0
  351. package/packages/jest-utils/dist/jestHelpers.d.ts +56 -0
  352. package/packages/jest-utils/dist/jestHelpers.d.ts.map +1 -0
  353. package/packages/jest-utils/dist/jestHelpers.js +62 -1
  354. package/packages/jest-utils/dist/jestHelpers.js.map +1 -0
  355. package/packages/utils/dist/colorUtils.d.ts +77 -0
  356. package/packages/utils/dist/colorUtils.d.ts.map +1 -0
  357. package/packages/utils/dist/colorUtils.js +97 -2
  358. package/packages/utils/dist/colorUtils.js.map +1 -0
  359. package/packages/utils/dist/commandLine.d.ts +60 -0
  360. package/packages/utils/dist/commandLine.d.ts.map +1 -0
  361. package/packages/utils/dist/commandLine.js +60 -0
  362. package/packages/utils/dist/commandLine.js.map +1 -0
  363. package/packages/utils/dist/copyDirectory.d.ts +33 -0
  364. package/packages/utils/dist/copyDirectory.d.ts.map +1 -0
  365. package/packages/utils/dist/copyDirectory.js +37 -0
  366. package/packages/utils/dist/copyDirectory.js.map +1 -0
  367. package/packages/utils/dist/createDirectory.d.ts +32 -0
  368. package/packages/utils/dist/createDirectory.d.ts.map +1 -0
  369. package/packages/utils/dist/createDirectory.js +33 -0
  370. package/packages/utils/dist/createDirectory.js.map +1 -0
  371. package/packages/utils/dist/createZip.d.ts +38 -0
  372. package/packages/utils/dist/createZip.d.ts.map +1 -0
  373. package/packages/utils/dist/createZip.js +47 -2
  374. package/packages/utils/dist/createZip.js.map +1 -0
  375. package/packages/utils/dist/deepCopy.d.ts +31 -0
  376. package/packages/utils/dist/deepCopy.d.ts.map +1 -0
  377. package/packages/utils/dist/deepCopy.js +39 -0
  378. package/packages/utils/dist/deepCopy.js.map +1 -0
  379. package/packages/utils/dist/deepEqual.d.ts +53 -0
  380. package/packages/utils/dist/deepEqual.d.ts.map +1 -0
  381. package/packages/utils/dist/deepEqual.js +73 -1
  382. package/packages/utils/dist/deepEqual.js.map +1 -0
  383. package/packages/utils/dist/error.d.ts +42 -0
  384. package/packages/utils/dist/error.d.ts.map +1 -0
  385. package/packages/utils/dist/error.js +42 -0
  386. package/packages/utils/dist/error.js.map +1 -0
  387. package/packages/utils/dist/export.d.ts +1 -0
  388. package/packages/utils/dist/export.d.ts.map +1 -0
  389. package/packages/utils/dist/export.js +1 -0
  390. package/packages/utils/dist/export.js.map +1 -0
  391. package/packages/utils/dist/format.d.ts +49 -0
  392. package/packages/utils/dist/format.d.ts.map +1 -0
  393. package/packages/utils/dist/format.js +49 -0
  394. package/packages/utils/dist/format.js.map +1 -0
  395. package/packages/utils/dist/githubVersion.d.ts +32 -0
  396. package/packages/utils/dist/githubVersion.d.ts.map +1 -0
  397. package/packages/utils/dist/githubVersion.js +34 -1
  398. package/packages/utils/dist/githubVersion.js.map +1 -0
  399. package/packages/utils/dist/hex.d.ts +85 -0
  400. package/packages/utils/dist/hex.d.ts.map +1 -0
  401. package/packages/utils/dist/hex.js +124 -0
  402. package/packages/utils/dist/hex.js.map +1 -0
  403. package/packages/utils/dist/inspector.d.ts +63 -0
  404. package/packages/utils/dist/inspector.d.ts.map +1 -0
  405. package/packages/utils/dist/inspector.js +69 -1
  406. package/packages/utils/dist/inspector.js.map +1 -0
  407. package/packages/utils/dist/isValid.d.ts +93 -0
  408. package/packages/utils/dist/isValid.d.ts.map +1 -0
  409. package/packages/utils/dist/isValid.js +93 -0
  410. package/packages/utils/dist/isValid.js.map +1 -0
  411. package/packages/utils/dist/network.d.ts +93 -0
  412. package/packages/utils/dist/network.d.ts.map +1 -0
  413. package/packages/utils/dist/network.js +99 -3
  414. package/packages/utils/dist/network.js.map +1 -0
  415. package/packages/utils/dist/npmRoot.d.ts +28 -0
  416. package/packages/utils/dist/npmRoot.d.ts.map +1 -0
  417. package/packages/utils/dist/npmRoot.js +28 -0
  418. package/packages/utils/dist/npmRoot.js.map +1 -0
  419. package/packages/utils/dist/npmVersion.d.ts +32 -0
  420. package/packages/utils/dist/npmVersion.d.ts.map +1 -0
  421. package/packages/utils/dist/npmVersion.js +34 -1
  422. package/packages/utils/dist/npmVersion.js.map +1 -0
  423. package/packages/utils/dist/tracker.d.ts +56 -0
  424. package/packages/utils/dist/tracker.d.ts.map +1 -0
  425. package/packages/utils/dist/tracker.js +64 -1
  426. package/packages/utils/dist/tracker.js.map +1 -0
  427. package/packages/utils/dist/wait.d.ts +51 -0
  428. package/packages/utils/dist/wait.d.ts.map +1 -0
  429. package/packages/utils/dist/wait.js +60 -8
  430. package/packages/utils/dist/wait.js.map +1 -0
  431. package/packages/vitest-utils/dist/export.d.ts +1 -0
  432. package/packages/vitest-utils/dist/export.d.ts.map +1 -0
  433. package/packages/vitest-utils/dist/export.js +1 -0
  434. package/packages/vitest-utils/dist/export.js.map +1 -0
  435. package/packages/vitest-utils/dist/vitestHelpers.d.ts +37 -0
  436. package/packages/vitest-utils/dist/vitestHelpers.d.ts.map +1 -0
  437. package/packages/vitest-utils/dist/vitestHelpers.js +43 -1
  438. package/packages/vitest-utils/dist/vitestHelpers.js.map +1 -0
@@ -1,3 +1,54 @@
1
+ /**
2
+ * This file contains the wait, waiter and withTimeout functions.
3
+ *
4
+ * @file wait.ts
5
+ * @author Luca Liguori
6
+ * @created 2025-02-16
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
+ /**
25
+ * Asynchronous waiter function that resolves when the provided condition is met or rejects on timeout.
26
+ *
27
+ * @param {string} name - The name of the waiter.
28
+ * @param {() => boolean} check - A function that checks the condition. Should return a boolean.
29
+ * @param {boolean} [exitWithReject] - Optional. If true, the promise will be rejected on timeout. Default is false.
30
+ * @param {number} [resolveTimeout] - Optional. The timeout duration in milliseconds. Default is 5000ms.
31
+ * @param {number} [resolveInterval] - Optional. The interval duration in milliseconds between condition checks. Default is 500ms.
32
+ * @param {boolean} [debug] - Optional. If true, debug messages will be logged to the console. Default is false.
33
+ * @returns {Promise<boolean>} A promise that resolves to true when the condition is met, or false if the timeout occurs.
34
+ */
1
35
  export declare function waiter(name: string, check: () => boolean, exitWithReject?: boolean, resolveTimeout?: number, resolveInterval?: number, debug?: boolean): Promise<boolean>;
36
+ /**
37
+ * Asynchronously waits for a specified amount of time.
38
+ *
39
+ * @param {number} timeout - The duration to wait in milliseconds. Default is 1000ms.
40
+ * @param {string} name - The name of the wait operation. Default is undefined.
41
+ * @param {boolean} debug - Whether to enable debug logging. Default is false.
42
+ * @returns {Promise<void>} A Promise that resolves after the specified timeout.
43
+ */
2
44
  export declare function wait(timeout?: number, name?: string, debug?: boolean): Promise<void>;
45
+ /**
46
+ * Wraps a promise with a timeout. If the promise does not resolve or reject within the specified time, it will be rejected.
47
+ *
48
+ * @param {Promise<T>} promise - The promise to wrap.
49
+ * @param {number} [timeoutMillisecs] - The timeout duration in milliseconds. Default is 10000ms.
50
+ * @param {boolean} [reThrow] - Optional. If true, the promise will rethrow the original promise and will reject on timeout. Default is true.
51
+ * @returns {Promise<T>} A new promise that resolves or rejects based on the original promise and the timeout.
52
+ */
3
53
  export declare function withTimeout<T>(promise: Promise<T>, timeoutMillisecs?: number, reThrow?: boolean): Promise<T>;
54
+ //# sourceMappingURL=wait.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../src/wait.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,OAAO,EACpB,cAAc,GAAE,OAAe,EAC/B,cAAc,GAAE,MAAa,EAC7B,eAAe,GAAE,MAAY,EAC7B,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED;;;;;;;GAOG;AACH,wBAAsB,IAAI,CAAC,OAAO,GAAE,MAAa,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvG;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,gBAAgB,GAAE,MAAc,EAAE,OAAO,GAAE,OAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBzH"}
@@ -1,6 +1,41 @@
1
+ /**
2
+ * This file contains the wait, waiter and withTimeout functions.
3
+ *
4
+ * @file wait.ts
5
+ * @author Luca Liguori
6
+ * @created 2025-02-16
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
+ // AnsiLogger module
1
25
  import { AnsiLogger } from 'node-ansi-logger';
26
+ /**
27
+ * Asynchronous waiter function that resolves when the provided condition is met or rejects on timeout.
28
+ *
29
+ * @param {string} name - The name of the waiter.
30
+ * @param {() => boolean} check - A function that checks the condition. Should return a boolean.
31
+ * @param {boolean} [exitWithReject] - Optional. If true, the promise will be rejected on timeout. Default is false.
32
+ * @param {number} [resolveTimeout] - Optional. The timeout duration in milliseconds. Default is 5000ms.
33
+ * @param {number} [resolveInterval] - Optional. The interval duration in milliseconds between condition checks. Default is 500ms.
34
+ * @param {boolean} [debug] - Optional. If true, debug messages will be logged to the console. Default is false.
35
+ * @returns {Promise<boolean>} A promise that resolves to true when the condition is met, or false if the timeout occurs.
36
+ */
2
37
  export async function waiter(name, check, exitWithReject = false, resolveTimeout = 5000, resolveInterval = 500, debug = false) {
3
- const log = new AnsiLogger({ logName: 'Waiter', logTimestampFormat: 4, logLevel: "debug" });
38
+ const log = new AnsiLogger({ logName: 'Waiter', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: "debug" /* LogLevel.DEBUG */ });
4
39
  if (check()) {
5
40
  if (debug)
6
41
  log.debug(`Waiter "${name}" already true`);
@@ -31,8 +66,16 @@ export async function waiter(name, check, exitWithReject = false, resolveTimeout
31
66
  }, resolveInterval).unref();
32
67
  });
33
68
  }
69
+ /**
70
+ * Asynchronously waits for a specified amount of time.
71
+ *
72
+ * @param {number} timeout - The duration to wait in milliseconds. Default is 1000ms.
73
+ * @param {string} name - The name of the wait operation. Default is undefined.
74
+ * @param {boolean} debug - Whether to enable debug logging. Default is false.
75
+ * @returns {Promise<void>} A Promise that resolves after the specified timeout.
76
+ */
34
77
  export async function wait(timeout = 1000, name, debug = false) {
35
- const log = new AnsiLogger({ logName: 'Wait', logTimestampFormat: 4, logLevel: "debug" });
78
+ const log = new AnsiLogger({ logName: 'Wait', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: "debug" /* LogLevel.DEBUG */ });
36
79
  if (debug)
37
80
  log.debug(`Wait "${name}" started...`);
38
81
  return new Promise((resolve) => {
@@ -44,6 +87,14 @@ export async function wait(timeout = 1000, name, debug = false) {
44
87
  }, timeout).unref();
45
88
  });
46
89
  }
90
+ /**
91
+ * Wraps a promise with a timeout. If the promise does not resolve or reject within the specified time, it will be rejected.
92
+ *
93
+ * @param {Promise<T>} promise - The promise to wrap.
94
+ * @param {number} [timeoutMillisecs] - The timeout duration in milliseconds. Default is 10000ms.
95
+ * @param {boolean} [reThrow] - Optional. If true, the promise will rethrow the original promise and will reject on timeout. Default is true.
96
+ * @returns {Promise<T>} A new promise that resolves or rejects based on the original promise and the timeout.
97
+ */
47
98
  export function withTimeout(promise, timeoutMillisecs = 10000, reThrow = true) {
48
99
  return new Promise((resolve, reject) => {
49
100
  const timer = setTimeout(() => {
@@ -51,23 +102,24 @@ export function withTimeout(promise, timeoutMillisecs = 10000, reThrow = true) {
51
102
  reject(new Error('Operation timed out'));
52
103
  }
53
104
  else {
54
- resolve(undefined);
105
+ resolve(undefined); // Resolve with undefined if reThrow is false
55
106
  }
56
- }, timeoutMillisecs).unref();
107
+ }, timeoutMillisecs).unref(); // Unref the timer to prevent it from keeping the event loop alive
57
108
  promise
58
109
  .then((result) => {
59
- clearTimeout(timer);
110
+ clearTimeout(timer); // Ensure timeout does not fire if promise resolves first
60
111
  resolve(result);
61
112
  return result;
62
113
  })
63
114
  .catch((error) => {
64
- clearTimeout(timer);
115
+ clearTimeout(timer); // Ensure timeout does not fire if promise rejects first
65
116
  if (reThrow) {
66
- reject(error);
117
+ reject(error); // Reject with the original error
67
118
  }
68
119
  else {
69
- resolve(undefined);
120
+ resolve(undefined); // Resolve with undefined if reThrow is false
70
121
  }
71
122
  });
72
123
  });
73
124
  }
125
+ //# sourceMappingURL=wait.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wait.js","sourceRoot":"","sources":["../src/wait.ts"],"names":[],"mappings":"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"}
@@ -1 +1,2 @@
1
1
  export * from './vitestHelpers.js';
2
+ //# sourceMappingURL=export.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}
@@ -1 +1,2 @@
1
1
  export * from './vitestHelpers.js';
2
+ //# sourceMappingURL=export.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export.js","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}
@@ -1,3 +1,25 @@
1
+ /**
2
+ * @description This file contains the Vitest base helpers.
3
+ * @file src/helpers.test.ts
4
+ * @author Luca Liguori
5
+ * @created 2025-12-31
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
+ */
1
23
  import type { MockInstance } from 'vitest';
2
24
  import { AnsiLogger } from 'node-ansi-logger';
3
25
  export declare const originalProcessArgv: readonly string[];
@@ -17,5 +39,20 @@ export declare let consoleErrorSpy: MockInstance<typeof console.error>;
17
39
  export declare let NAME: string;
18
40
  export declare let HOMEDIR: string;
19
41
  export declare let log: AnsiLogger;
42
+ /**
43
+ * Setup the Vitest environment:
44
+ * - it will remove any existing home directory
45
+ * - setup the spies for logging
46
+ *
47
+ * @param {string} name The name of the test suite.
48
+ * @param {boolean} debug If true, the logging is not mocked.
49
+ */
20
50
  export declare function setupTest(name: string, debug?: boolean): Promise<void>;
51
+ /**
52
+ * Set or unset the debug mode.
53
+ *
54
+ * @param {boolean} debug If true, the logging is not mocked.
55
+ * @returns {Promise<void>} A promise that resolves when the debug mode is set.
56
+ */
21
57
  export declare function setDebug(debug: boolean): Promise<void>;
58
+ //# sourceMappingURL=vitestHelpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vitestHelpers.d.ts","sourceRoot":"","sources":["../src/vitestHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,OAAO,EAAE,UAAU,EAA6B,MAAM,kBAAkB,CAAC;AAEzE,eAAO,MAAM,mBAAmB,mBAAmC,CAAC;AACpE,eAAO,MAAM,kBAAkB,8CAA0E,CAAC;AAG1G,eAAO,IAAI,YAAY,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AACvE,eAAO,IAAI,cAAc,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC3E,eAAO,IAAI,aAAa,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACzE,eAAO,IAAI,eAAe,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC7E,eAAO,IAAI,aAAa,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACzE,eAAO,IAAI,cAAc,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC3E,eAAO,IAAI,cAAc,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAG3E,eAAO,IAAI,aAAa,EAAE,YAAY,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AAC3D,eAAO,IAAI,eAAe,EAAE,YAAY,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AAC/D,eAAO,IAAI,cAAc,EAAE,YAAY,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AAC7D,eAAO,IAAI,cAAc,EAAE,YAAY,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AAC7D,eAAO,IAAI,eAAe,EAAE,YAAY,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AAE/D,eAAO,IAAI,IAAI,EAAE,MAAM,CAAC;AACxB,eAAO,IAAI,OAAO,EAAE,MAAM,CAAC;AAC3B,eAAO,IAAI,GAAG,EAAE,UAAU,CAAC;AAE3B;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCnF;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB5D"}
@@ -1,8 +1,32 @@
1
+ /**
2
+ * @description This file contains the Vitest base helpers.
3
+ * @file src/helpers.test.ts
4
+ * @author Luca Liguori
5
+ * @created 2025-12-31
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
+ */
1
23
  import { rmSync } from 'node:fs';
2
24
  import path from 'node:path';
25
+ // Imports from node-ansi-logger
3
26
  import { AnsiLogger } from 'node-ansi-logger';
4
27
  export const originalProcessArgv = Object.freeze([...process.argv]);
5
28
  export const originalProcessEnv = Object.freeze({ ...process.env });
29
+ // Spy on logger methods
6
30
  export let loggerLogSpy;
7
31
  export let loggerDebugSpy;
8
32
  export let loggerInfoSpy;
@@ -10,6 +34,7 @@ export let loggerNoticeSpy;
10
34
  export let loggerWarnSpy;
11
35
  export let loggerErrorSpy;
12
36
  export let loggerFatalSpy;
37
+ // Spy on console methods
13
38
  export let consoleLogSpy;
14
39
  export let consoleDebugSpy;
15
40
  export let consoleInfoSpy;
@@ -18,13 +43,23 @@ export let consoleErrorSpy;
18
43
  export let NAME;
19
44
  export let HOMEDIR;
20
45
  export let log;
46
+ /**
47
+ * Setup the Vitest environment:
48
+ * - it will remove any existing home directory
49
+ * - setup the spies for logging
50
+ *
51
+ * @param {string} name The name of the test suite.
52
+ * @param {boolean} debug If true, the logging is not mocked.
53
+ */
21
54
  export async function setupTest(name, debug = false) {
22
55
  expect(name).toBeDefined();
23
56
  expect(typeof name).toBe('string');
24
57
  expect(name.length).toBeGreaterThanOrEqual(4);
25
58
  NAME = name;
26
59
  HOMEDIR = path.join('temp', name);
27
- log = new AnsiLogger({ logName: 'Vitest', logTimestampFormat: 4, logLevel: "info" });
60
+ // Create the AnsiLogger instance
61
+ log = new AnsiLogger({ logName: 'Vitest', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: "info" /* LogLevel.INFO */ });
62
+ // Cleanup any existing home directory
28
63
  rmSync(HOMEDIR, { recursive: true, force: true });
29
64
  const { vi } = await import('vitest');
30
65
  loggerDebugSpy = vi.spyOn(AnsiLogger.prototype, 'debug');
@@ -50,6 +85,12 @@ export async function setupTest(name, debug = false) {
50
85
  consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
51
86
  }
52
87
  }
88
+ /**
89
+ * Set or unset the debug mode.
90
+ *
91
+ * @param {boolean} debug If true, the logging is not mocked.
92
+ * @returns {Promise<void>} A promise that resolves when the debug mode is set.
93
+ */
53
94
  export async function setDebug(debug) {
54
95
  const { vi } = await import('vitest');
55
96
  if (debug) {
@@ -75,3 +116,4 @@ export async function setDebug(debug) {
75
116
  consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
76
117
  }
77
118
  }
119
+ //# sourceMappingURL=vitestHelpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vitestHelpers.js","sourceRoot":"","sources":["../src/vitestHelpers.ts"],"names":[],"mappings":"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"}