matterbridge 3.4.7 → 3.5.0-dev-20260113-96c82db

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 +1 -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,49 +1,8 @@
1
- /**
2
- * This file contains the error functions.
3
- *
4
- * @file error.ts
5
- * @author Luca Liguori
6
- * @created 2025-07-17
7
- * @version 1.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
  import { inspect } from 'node:util';
25
2
  import { RESET } from 'node-ansi-logger';
26
- /**
27
- * Logs an error message using the provided AnsiLogger instance.
28
- *
29
- * @param {AnsiLogger} log - The AnsiLogger instance to use for logging.
30
- * @param {string} message - The error message to log.
31
- * @param {unknown} error - The error object or value to log. If it's an Error instance,
32
- * its message and stack trace will be included in the log.
33
- */
34
3
  export function logError(log, message, error) {
35
4
  log.error(`${message}: ${error instanceof Error ? error.message + ' \nStack: \n' + error.stack : error}`);
36
5
  }
37
- /**
38
- * Logs an error message using the provided AnsiLogger instance with detailed inspection.
39
- * Uses util.inspect to get a detailed view of the error with a stack depth of 10 levels.
40
- * If the error is an Error instance, it also includes the error message.
41
- *
42
- * @param {AnsiLogger} log - The AnsiLogger instance to use for logging.
43
- * @param {string} message - The error message to log.
44
- * @param {unknown} error - The error object or value to log. Will be inspected with depth 10.
45
- * @returns {string} - The full logged message.
46
- */
47
6
  export function inspectError(log, message, error) {
48
7
  const errorMessage = error instanceof Error ? `${error.message} \n` : '';
49
8
  const inspectedError = inspect(error, { depth: 10, colors: true, showHidden: false });
@@ -51,4 +10,3 @@ export function inspectError(log, message, error) {
51
10
  log.error(fullMessage);
52
11
  return fullMessage;
53
12
  }
54
- //# sourceMappingURL=error.js.map
@@ -10,4 +10,3 @@ export * from './createZip.js';
10
10
  export * from './wait.js';
11
11
  export * from './hex.js';
12
12
  export * from './error.js';
13
- //# sourceMappingURL=export.d.ts.map
@@ -10,4 +10,3 @@ export * from './createZip.js';
10
10
  export * from './wait.js';
11
11
  export * from './hex.js';
12
12
  export * from './error.js';
13
- //# sourceMappingURL=export.js.map
@@ -1,53 +1,4 @@
1
- /**
2
- * @description This file contains the format functions.
3
- * @file format.ts
4
- * @author Luca Liguori
5
- * @created 2025-10-20
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
- /**
24
- * Format a timestamp into a human-readable string.
25
- *
26
- * @param {number} timestamp - The timestamp in milliseconds since the Unix epoch.
27
- * @returns {string} - The formatted timestamp.
28
- */
29
1
  export declare function formatTimeStamp(timestamp: number): string;
30
- /**
31
- * Format a percentage into a human-readable string.
32
- *
33
- * @param {number} percent - The percentage value.
34
- * @param {number} digits - The number of decimal places.
35
- * @returns {string} - The formatted percentage.
36
- */
37
2
  export declare function formatPercent(percent: number, digits?: number): string;
38
- /**
39
- * Format bytes into a human-readable string.
40
- *
41
- * @param {number} bytes - The number of bytes.
42
- * @param {number} digits - The number of decimal places.
43
- * @returns {string} - The formatted byte string.
44
- */
45
3
  export declare function formatBytes(bytes: number, digits?: number): string;
46
- /**
47
- * Function to format system uptime with only the most significant unit
48
- *
49
- * @param {number} seconds - The number of seconds to format
50
- * @returns {string} The formatted uptime string
51
- */
52
4
  export declare function formatUptime(seconds: number): string;
53
- //# sourceMappingURL=format.d.ts.map
@@ -1,51 +1,9 @@
1
- /**
2
- * @description This file contains the format functions.
3
- * @file format.ts
4
- * @author Luca Liguori
5
- * @created 2025-10-20
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
- /**
24
- * Format a timestamp into a human-readable string.
25
- *
26
- * @param {number} timestamp - The timestamp in milliseconds since the Unix epoch.
27
- * @returns {string} - The formatted timestamp.
28
- */
29
1
  export function formatTimeStamp(timestamp) {
30
2
  return `${new Date(timestamp).toLocaleString()}`;
31
3
  }
32
- /**
33
- * Format a percentage into a human-readable string.
34
- *
35
- * @param {number} percent - The percentage value.
36
- * @param {number} digits - The number of decimal places.
37
- * @returns {string} - The formatted percentage.
38
- */
39
4
  export function formatPercent(percent, digits = 2) {
40
5
  return `${percent.toFixed(digits)} %`;
41
6
  }
42
- /**
43
- * Format bytes into a human-readable string.
44
- *
45
- * @param {number} bytes - The number of bytes.
46
- * @param {number} digits - The number of decimal places.
47
- * @returns {string} - The formatted byte string.
48
- */
49
7
  export function formatBytes(bytes, digits = 2) {
50
8
  if (bytes === 0)
51
9
  return `${bytes.toFixed(digits)} B`;
@@ -54,12 +12,6 @@ export function formatBytes(bytes, digits = 2) {
54
12
  const value = bytes / Math.pow(1024, idx);
55
13
  return `${value.toFixed(digits)} ${units[idx]}`;
56
14
  }
57
- /**
58
- * Function to format system uptime with only the most significant unit
59
- *
60
- * @param {number} seconds - The number of seconds to format
61
- * @returns {string} The formatted uptime string
62
- */
63
15
  export function formatUptime(seconds) {
64
16
  if (seconds >= 86400) {
65
17
  const days = Math.floor(seconds / 86400);
@@ -75,4 +27,3 @@ export function formatUptime(seconds) {
75
27
  }
76
28
  return `${seconds} second${seconds !== 1 ? 's' : ''}`;
77
29
  }
78
- //# sourceMappingURL=format.js.map
@@ -1,89 +1,4 @@
1
- /**
2
- * This file contains the hex functions.
3
- *
4
- * @file hex.ts
5
- * @author Luca Liguori
6
- * @created 2025-05-06
7
- * @version 1.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
- /**
25
- * Converts an ArrayBuffer or Uint8Array to a hexadecimal string.
26
- *
27
- * Accepts any {ArrayBufferLike} input: a raw ArrayBuffer (binary data storage) or
28
- * a Uint8Array (TypedArray view over an ArrayBuffer). While an ArrayBuffer holds
29
- * the raw memory, a Uint8Array is a typed view into that memory, letting you access
30
- * its bytes directly. This function normalizes both by creating a Uint8Array view
31
- * before conversion.
32
- *
33
- * @param {ArrayBufferLike} buffer - The buffer or typed-array view to convert.
34
- * @returns {string} A lowercase hex string representation of the buffer's bytes.
35
- *
36
- * @throws {TypeError} If the input is not an ArrayBuffer or ArrayBufferView.
37
- */
38
1
  export declare function bufferToHex(buffer: ArrayBufferLike): string;
39
- /**
40
- * Converts a hexadecimal string to a Uint8Array.
41
- *
42
- * @param {string} hex - The hex string to convert. Can include uppercase or lowercase characters.
43
- * @returns {Uint8Array} A Uint8Array representing the corresponding binary data.
44
- *
45
- * @throws {TypeError} If the input is not a string.
46
- * @throws {Error} If the input length is odd or contains non-hex characters.
47
- */
48
2
  export declare function hexToBuffer(hex: string): Uint8Array;
49
- /**
50
- * Converts a PEM (Privacy-Enhanced Mail) formatted string to a Uint8Array.
51
- *
52
- * PEM format is a base64-encoded format commonly used for cryptographic keys and certificates,
53
- * wrapped with header and footer lines like "-----BEGIN CERTIFICATE-----" and "-----END CERTIFICATE-----".
54
- * This function extracts the base64 content and converts it to binary data using Node.js Buffer API.
55
- *
56
- * @param {string} pem - The PEM formatted string to convert.
57
- * @param {boolean} validate - Whether to validate the PEM content using Node.js crypto module. Default is false.
58
- * @returns {Uint8Array} A Uint8Array representing the decoded binary data.
59
- *
60
- * @throws {TypeError} If the input is not a string.
61
- * @throws {Error} If the PEM format is invalid, contains invalid base64 characters, or validation fails.
62
- */
63
3
  export declare function pemToBuffer(pem: string, validate?: boolean): Uint8Array;
64
- /**
65
- * Extracts the raw 32-byte private key scalar from an EC private key PEM.
66
- *
67
- * This function parses an EC private key in PEM format and extracts the raw
68
- * 32-byte private scalar (the "d" value) used in elliptic curve cryptography.
69
- * This is the actual secret key material.
70
- *
71
- * @param {string} pemPrivateKey - The EC private key in PEM format
72
- * @returns {Uint8Array} The raw 32-byte private key scalar
73
- * @throws {Error} If the input is not a valid EC private key PEM
74
- *
75
- * @example
76
- * ```typescript
77
- * const pemKey = `-----BEGIN EC PRIVATE KEY-----
78
- * MHcCAQEEIFBxqFkUxMoN2JkUXLFeiZnLNUpftjLi0sKMbZ6uajHXoAoGCCqGSM49
79
- * AwEHoUQDQgAEcJ3eH/rG3zf9WmqMjh5eBSkeXz3Cb4Fig1rTosfHmgyjx/WnLPEe
80
- * BF4SHvLo0G2COJEHa/VDE5EiKWO9ZR6AOQ==
81
- * -----END EC PRIVATE KEY-----`;
82
- *
83
- * const rawKey = extractPrivateKeyRaw(pemKey);
84
- * console.log(rawKey.length); // 32
85
- * console.log(bufferToHex(rawKey)); // hex representation of the private scalar
86
- * ```
87
- */
88
4
  export declare function extractPrivateKeyRaw(pemPrivateKey: string): Uint8Array;
89
- //# sourceMappingURL=hex.d.ts.map
package/dist/utils/hex.js CHANGED
@@ -1,114 +1,39 @@
1
- /**
2
- * This file contains the hex functions.
3
- *
4
- * @file hex.ts
5
- * @author Luca Liguori
6
- * @created 2025-05-06
7
- * @version 1.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
  import { createPublicKey, createPrivateKey, X509Certificate } from 'node:crypto';
25
- /**
26
- * Converts an ArrayBuffer or Uint8Array to a hexadecimal string.
27
- *
28
- * Accepts any {ArrayBufferLike} input: a raw ArrayBuffer (binary data storage) or
29
- * a Uint8Array (TypedArray view over an ArrayBuffer). While an ArrayBuffer holds
30
- * the raw memory, a Uint8Array is a typed view into that memory, letting you access
31
- * its bytes directly. This function normalizes both by creating a Uint8Array view
32
- * before conversion.
33
- *
34
- * @param {ArrayBufferLike} buffer - The buffer or typed-array view to convert.
35
- * @returns {string} A lowercase hex string representation of the buffer's bytes.
36
- *
37
- * @throws {TypeError} If the input is not an ArrayBuffer or ArrayBufferView.
38
- */
39
2
  export function bufferToHex(buffer) {
40
- // Check if the input is an ArrayBuffer or ArrayBufferView
41
3
  if (!(buffer instanceof ArrayBuffer || ArrayBuffer.isView(buffer))) {
42
4
  throw new TypeError('Expected input to be an ArrayBuffer or ArrayBufferView');
43
5
  }
44
- // Create a Uint8Array view over the buffer
45
6
  const bytes = buffer instanceof Uint8Array ? buffer : new Uint8Array(buffer);
46
- // Convert each byte to 2-digit hex
47
7
  return Array.from(bytes)
48
8
  .map((byte) => byte.toString(16).padStart(2, '0'))
49
9
  .join('');
50
10
  }
51
- /**
52
- * Converts a hexadecimal string to a Uint8Array.
53
- *
54
- * @param {string} hex - The hex string to convert. Can include uppercase or lowercase characters.
55
- * @returns {Uint8Array} A Uint8Array representing the corresponding binary data.
56
- *
57
- * @throws {TypeError} If the input is not a string.
58
- * @throws {Error} If the input length is odd or contains non-hex characters.
59
- */
60
11
  export function hexToBuffer(hex) {
61
- // Ensure the input is a string
62
12
  if (typeof hex !== 'string') {
63
13
  throw new TypeError('Expected a string for hex input');
64
14
  }
65
- // Trim any whitespace from the input string
66
15
  const cleaned = hex.trim();
67
- // Check if the length of the hex string is even
68
16
  if (cleaned.length % 2 !== 0) {
69
17
  throw new Error('Invalid hex string length, must be even');
70
18
  }
71
- // Validate that the string contains only valid hex characters
72
19
  if (!/^[0-9a-fA-F]*$/.test(cleaned)) {
73
20
  throw new Error('Invalid hex string, contains non-hex characters');
74
21
  }
75
- // Calculate the length of the resulting Uint8Array
76
22
  const length = cleaned.length / 2;
77
- // Create a Uint8Array to hold the binary data
78
23
  const result = new Uint8Array(length);
79
- // Convert each pair of hex characters into a byte
80
24
  for (let i = 0; i < length; i++) {
81
25
  result[i] = parseInt(cleaned.substr(i * 2, 2), 16);
82
26
  }
83
- // Return the resulting Uint8Array
84
27
  return result;
85
28
  }
86
- /**
87
- * Converts a PEM (Privacy-Enhanced Mail) formatted string to a Uint8Array.
88
- *
89
- * PEM format is a base64-encoded format commonly used for cryptographic keys and certificates,
90
- * wrapped with header and footer lines like "-----BEGIN CERTIFICATE-----" and "-----END CERTIFICATE-----".
91
- * This function extracts the base64 content and converts it to binary data using Node.js Buffer API.
92
- *
93
- * @param {string} pem - The PEM formatted string to convert.
94
- * @param {boolean} validate - Whether to validate the PEM content using Node.js crypto module. Default is false.
95
- * @returns {Uint8Array} A Uint8Array representing the decoded binary data.
96
- *
97
- * @throws {TypeError} If the input is not a string.
98
- * @throws {Error} If the PEM format is invalid, contains invalid base64 characters, or validation fails.
99
- */
100
29
  export function pemToBuffer(pem, validate = false) {
101
- // Ensure the input is a string
102
30
  if (typeof pem !== 'string') {
103
31
  throw new TypeError('Expected a string for PEM input');
104
32
  }
105
- // Trim whitespace from the input
106
33
  const cleaned = pem.trim();
107
- // Check if the string appears to be in PEM format
108
34
  if (!cleaned.includes('-----BEGIN') || !cleaned.includes('-----END')) {
109
35
  throw new Error('Invalid PEM format: missing BEGIN/END markers');
110
36
  }
111
- // Extract the base64 content between the header and footer
112
37
  const lines = cleaned.split('\n');
113
38
  const base64Lines = [];
114
39
  let inContent = false;
@@ -129,114 +54,65 @@ export function pemToBuffer(pem, validate = false) {
129
54
  if (base64Lines.length === 0) {
130
55
  throw new Error('Invalid PEM format: no content found between BEGIN/END markers');
131
56
  }
132
- // Join all base64 lines together
133
57
  const base64String = base64Lines.join('');
134
- // Validate base64 string format
135
58
  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(base64String)) {
136
59
  throw new Error('Invalid PEM format: contains invalid base64 characters');
137
60
  }
138
61
  try {
139
- // Use Node.js Buffer API instead of legacy atob()
140
62
  const buffer = Buffer.from(base64String, 'base64');
141
- // Convert Buffer to Uint8Array
142
63
  const result = new Uint8Array(buffer);
143
- // Validate PEM content using Node.js crypto module if requested
144
64
  if (validate) {
145
65
  try {
146
- // Determine PEM type from the header and validate accordingly
147
66
  const pemType = cleaned.match(/-----BEGIN\s+([^-]+)-----/)?.[1]?.trim();
148
67
  if (pemType?.includes('CERTIFICATE')) {
149
- // Use X509Certificate for robust certificate validation
150
68
  const cert = new X509Certificate(pem);
151
- // Check validity period
152
69
  if (cert.validFrom && cert.validTo) {
153
70
  const now = Date.now();
154
71
  const from = Date.parse(cert.validFrom);
155
72
  const to = Date.parse(cert.validTo);
156
- // istanbul ignore next if
157
73
  if (now < from || now > to) {
158
74
  throw new Error('Certificate is not currently valid');
159
75
  }
160
76
  }
161
- // Check subject/issuer fields
162
- // istanbul ignore next if
163
77
  if (!cert.subject || !cert.issuer) {
164
78
  throw new Error('Certificate missing subject or issuer');
165
79
  }
166
- // Optionally check signature (not possible without CA chain)
167
80
  }
168
81
  else if (pemType?.includes('PRIVATE KEY')) {
169
- // For private keys, try to create a private key
170
82
  createPrivateKey({ key: pem, format: 'pem' });
171
83
  }
172
84
  else if (pemType?.includes('PUBLIC KEY')) {
173
- // For public keys, try to create a public key
174
85
  createPublicKey({ key: pem, format: 'pem' });
175
86
  }
176
- // If no specific type is detected, skip validation
177
87
  }
178
88
  catch (validationError) {
179
- // istanbul ignore next
180
89
  throw new Error(`PEM validation failed: ${validationError instanceof Error ? validationError.message : String(validationError)}`);
181
90
  }
182
91
  }
183
92
  return result;
184
93
  }
185
94
  catch (error) {
186
- // istanbul ignore next
187
95
  throw new Error(`Failed to decode base64 content: ${error instanceof Error ? error.message : String(error)}`);
188
96
  }
189
97
  }
190
- /**
191
- * Extracts the raw 32-byte private key scalar from an EC private key PEM.
192
- *
193
- * This function parses an EC private key in PEM format and extracts the raw
194
- * 32-byte private scalar (the "d" value) used in elliptic curve cryptography.
195
- * This is the actual secret key material.
196
- *
197
- * @param {string} pemPrivateKey - The EC private key in PEM format
198
- * @returns {Uint8Array} The raw 32-byte private key scalar
199
- * @throws {Error} If the input is not a valid EC private key PEM
200
- *
201
- * @example
202
- * ```typescript
203
- * const pemKey = `-----BEGIN EC PRIVATE KEY-----
204
- * MHcCAQEEIFBxqFkUxMoN2JkUXLFeiZnLNUpftjLi0sKMbZ6uajHXoAoGCCqGSM49
205
- * AwEHoUQDQgAEcJ3eH/rG3zf9WmqMjh5eBSkeXz3Cb4Fig1rTosfHmgyjx/WnLPEe
206
- * BF4SHvLo0G2COJEHa/VDE5EiKWO9ZR6AOQ==
207
- * -----END EC PRIVATE KEY-----`;
208
- *
209
- * const rawKey = extractPrivateKeyRaw(pemKey);
210
- * console.log(rawKey.length); // 32
211
- * console.log(bufferToHex(rawKey)); // hex representation of the private scalar
212
- * ```
213
- */
214
98
  export function extractPrivateKeyRaw(pemPrivateKey) {
215
99
  if (typeof pemPrivateKey !== 'string') {
216
100
  throw new TypeError('Expected a string for PEM private key input');
217
101
  }
218
- // Extract the private key block
219
102
  const keyBlock = /-----BEGIN (?:EC )?PRIVATE KEY-----[^-]+-----END (?:EC )?PRIVATE KEY-----/s.exec(pemPrivateKey);
220
103
  if (!keyBlock) {
221
104
  throw new Error('No EC PRIVATE KEY block found in the supplied PEM');
222
105
  }
223
106
  try {
224
- // Create a private key object
225
107
  const privateKey = createPrivateKey(keyBlock[0]);
226
- // Export as PKCS#8 DER format
227
108
  const pkcs8Der = privateKey.export({ format: 'der', type: 'pkcs8' });
228
- // For P-256 curves, the private scalar is the last 32 bytes of the PKCS#8 DER
229
- // istanbul ignore next
230
109
  if (pkcs8Der.length < 32) {
231
110
  throw new Error('Invalid private key: DER data too short');
232
111
  }
233
- // Extract the last 32 bytes which contain the raw private scalar
234
112
  const rawPrivateKey = pkcs8Der.subarray(pkcs8Der.length - 32);
235
113
  return new Uint8Array(rawPrivateKey);
236
114
  }
237
115
  catch (error) {
238
- // istanbul ignore next
239
116
  throw new Error(`Failed to extract private key: ${error instanceof Error ? error.message : String(error)}`);
240
117
  }
241
118
  }
242
- //# sourceMappingURL=hex.js.map
@@ -1,39 +1,10 @@
1
- /**
2
- * This file contains the Inspector class.
3
- *
4
- * @file inspector.ts
5
- * @author Luca Liguori
6
- * @created 2025-10-12
7
- * @version 1.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
  import EventEmitter from 'node:events';
25
2
  interface InspectorEvents {
26
- /** Start the inspector */
27
3
  start: [];
28
- /** Stop the inspector */
29
4
  stop: [];
30
- /** Take a heap snapshot */
31
5
  snapshot: [];
32
- /** Heap snapshot done */
33
6
  snapshot_done: [];
34
- /** Run garbage collector */
35
7
  gc: [type?: 'major' | 'minor', execution?: 'sync' | 'async'];
36
- /** Garbage collection done */
37
8
  gc_done: [type: 'major' | 'minor', execution: 'sync' | 'async'];
38
9
  }
39
10
  export declare class Inspector extends EventEmitter<InspectorEvents> {
@@ -45,43 +16,9 @@ export declare class Inspector extends EventEmitter<InspectorEvents> {
45
16
  private snapshotInProgress;
46
17
  private log;
47
18
  constructor(name?: string, debug?: boolean, verbose?: boolean);
48
- /**
49
- * Starts the inspector for heap sampling.
50
- *
51
- * This function is called when the -inspect parameter is passed to matterbridge.
52
- *
53
- * The -snapshotinterval parameter can be used to set the heap snapshot interval. Default is undefined. Minimum is 30000 ms.
54
- * The snapshot is saved in the heap_profiles directory that is created in the current working directory.
55
- * The snapshot can be analyzed using vscode or Chrome DevTools or other tools that support heap snapshots.
56
- */
57
19
  start(): Promise<void>;
58
- /**
59
- * Stops the heap sampling and saves the profile to a file in the heap_profiles directory.
60
- * This function is called when the inspector is stopped.
61
- */
62
20
  stop(): Promise<void>;
63
- /**
64
- * Takes a heap snapshot and saves it to the file name 'heap_snapshots/<timestamp>.heapsnapshot'.
65
- * If triggers a full garbage collection before and after taking the snapshot to reduce noise.
66
- *
67
- * This function is called periodically based on the -snapshotinterval parameter.
68
- * The -snapshotinterval parameter must at least 30000 ms.
69
- * The snapshot is saved in the heap_snapshots directory that is created in the current working directory.
70
- * The snapshot can be analyzed using vscode or Chrome DevTools or other tools that support heap snapshots.
71
- */
72
21
  takeHeapSnapshot(): Promise<void>;
73
- /**
74
- * Manually trigger garbage collection to free memory (if exposed with --expose-gc)
75
- *
76
- * @param {'major' | 'minor'} type - The type of garbage collection to perform ('major' or 'minor'). Default is 'major'.
77
- * @param {'sync' | 'async'} execution - The execution mode of garbage collection ('sync' or 'async'). Default is 'async'.
78
- *
79
- * @remarks
80
- * - major collection refers to old-generation mark-sweep/mark-compact cycles.
81
- * - minor collection refers to young-generation collections (scavenges).
82
- * - sync execution blocks the main thread until GC is complete, which can cause pauses.
83
- */
84
22
  runGarbageCollector(type?: 'major' | 'minor', execution?: 'sync' | 'async'): void;
85
23
  }
86
24
  export {};
87
- //# sourceMappingURL=inspector.d.ts.map