matterbridge 3.5.0 → 3.5.1-dev-20260121-22e98b4

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 (328) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/bin/mb_coap.js +1 -1
  3. package/bin/mb_mdns.js +1 -1
  4. package/dist/broadcastServer.d.ts +0 -115
  5. package/dist/broadcastServer.js +1 -119
  6. package/dist/broadcastServerTypes.d.ts +0 -43
  7. package/dist/broadcastServerTypes.js +0 -24
  8. package/dist/cli.d.ts +1 -26
  9. package/dist/cli.js +2 -102
  10. package/dist/cliEmitter.d.ts +0 -36
  11. package/dist/cliEmitter.js +0 -37
  12. package/dist/cliHistory.d.ts +0 -42
  13. package/dist/cliHistory.js +1 -39
  14. package/dist/clusters/export.d.ts +0 -1
  15. package/dist/clusters/export.js +0 -2
  16. package/dist/deviceManager.d.ts +0 -108
  17. package/dist/deviceManager.js +2 -114
  18. package/dist/devices/airConditioner.d.ts +0 -75
  19. package/dist/devices/airConditioner.js +0 -57
  20. package/dist/devices/batteryStorage.d.ts +0 -43
  21. package/dist/devices/batteryStorage.js +1 -48
  22. package/dist/devices/cooktop.d.ts +0 -55
  23. package/dist/devices/cooktop.js +0 -56
  24. package/dist/devices/dishwasher.d.ts +0 -55
  25. package/dist/devices/dishwasher.js +0 -57
  26. package/dist/devices/evse.d.ts +0 -57
  27. package/dist/devices/evse.js +10 -74
  28. package/dist/devices/export.d.ts +0 -1
  29. package/dist/devices/export.js +0 -5
  30. package/dist/devices/extractorHood.d.ts +0 -41
  31. package/dist/devices/extractorHood.js +0 -43
  32. package/dist/devices/heatPump.d.ts +0 -43
  33. package/dist/devices/heatPump.js +2 -50
  34. package/dist/devices/laundryDryer.d.ts +0 -58
  35. package/dist/devices/laundryDryer.js +3 -62
  36. package/dist/devices/laundryWasher.d.ts +0 -64
  37. package/dist/devices/laundryWasher.js +4 -70
  38. package/dist/devices/microwaveOven.d.ts +1 -77
  39. package/dist/devices/microwaveOven.js +5 -88
  40. package/dist/devices/oven.d.ts +0 -82
  41. package/dist/devices/oven.js +0 -85
  42. package/dist/devices/refrigerator.d.ts +0 -100
  43. package/dist/devices/refrigerator.js +0 -102
  44. package/dist/devices/roboticVacuumCleaner.d.ts +0 -83
  45. package/dist/devices/roboticVacuumCleaner.js +9 -100
  46. package/dist/devices/solarPower.d.ts +0 -36
  47. package/dist/devices/solarPower.js +0 -38
  48. package/dist/devices/speaker.d.ts +0 -79
  49. package/dist/devices/speaker.js +0 -84
  50. package/dist/devices/temperatureControl.d.ts +0 -21
  51. package/dist/devices/temperatureControl.js +3 -24
  52. package/dist/devices/waterHeater.d.ts +0 -74
  53. package/dist/devices/waterHeater.js +2 -82
  54. package/dist/frontend.d.ts +0 -187
  55. package/dist/frontend.js +39 -505
  56. package/dist/frontendTypes.d.ts +0 -57
  57. package/dist/frontendTypes.js +0 -45
  58. package/dist/helpers.d.ts +0 -43
  59. package/dist/helpers.js +1 -54
  60. package/dist/index.d.ts +0 -23
  61. package/dist/index.js +0 -25
  62. package/dist/jestutils/export.d.ts +0 -1
  63. package/dist/jestutils/export.js +0 -1
  64. package/dist/jestutils/jestHelpers.d.ts +0 -255
  65. package/dist/jestutils/jestHelpers.js +14 -372
  66. package/dist/logger/export.d.ts +0 -1
  67. package/dist/logger/export.js +0 -1
  68. package/dist/matter/behaviors.d.ts +0 -1
  69. package/dist/matter/behaviors.js +0 -2
  70. package/dist/matter/clusters.d.ts +0 -1
  71. package/dist/matter/clusters.js +0 -2
  72. package/dist/matter/devices.d.ts +0 -1
  73. package/dist/matter/devices.js +0 -2
  74. package/dist/matter/endpoints.d.ts +0 -1
  75. package/dist/matter/endpoints.js +0 -2
  76. package/dist/matter/export.d.ts +0 -1
  77. package/dist/matter/export.js +0 -2
  78. package/dist/matter/types.d.ts +0 -1
  79. package/dist/matter/types.js +0 -2
  80. package/dist/matterNode.d.ts +0 -258
  81. package/dist/matterNode.js +9 -364
  82. package/dist/matterbridge.d.ts +0 -362
  83. package/dist/matterbridge.js +60 -860
  84. package/dist/matterbridgeAccessoryPlatform.d.ts +0 -36
  85. package/dist/matterbridgeAccessoryPlatform.js +0 -38
  86. package/dist/matterbridgeBehaviors.d.ts +0 -24
  87. package/dist/matterbridgeBehaviors.js +5 -68
  88. package/dist/matterbridgeDeviceTypes.d.ts +0 -649
  89. package/dist/matterbridgeDeviceTypes.js +6 -673
  90. package/dist/matterbridgeDynamicPlatform.d.ts +0 -36
  91. package/dist/matterbridgeDynamicPlatform.js +0 -38
  92. package/dist/matterbridgeEndpoint.d.ts +2 -1332
  93. package/dist/matterbridgeEndpoint.js +94 -1459
  94. package/dist/matterbridgeEndpointHelpers.d.ts +0 -425
  95. package/dist/matterbridgeEndpointHelpers.js +21 -486
  96. package/dist/matterbridgeEndpointTypes.d.ts +0 -70
  97. package/dist/matterbridgeEndpointTypes.js +0 -25
  98. package/dist/matterbridgePlatform.d.ts +0 -425
  99. package/dist/matterbridgePlatform.js +2 -453
  100. package/dist/matterbridgeTypes.d.ts +0 -46
  101. package/dist/matterbridgeTypes.js +0 -26
  102. package/dist/mb_coap.d.ts +1 -0
  103. package/dist/{dgram/mb_coap.js → mb_coap.js} +3 -41
  104. package/dist/mb_mdns.d.ts +1 -0
  105. package/dist/{dgram/mb_mdns.js → mb_mdns.js} +37 -81
  106. package/dist/pluginManager.d.ts +0 -305
  107. package/dist/pluginManager.js +8 -345
  108. package/dist/shelly.d.ts +0 -157
  109. package/dist/shelly.js +7 -178
  110. package/dist/spawn.d.ts +1 -0
  111. package/dist/{utils/spawn.js → spawn.js} +3 -73
  112. package/dist/storage/export.d.ts +0 -1
  113. package/dist/storage/export.js +0 -1
  114. package/dist/update.d.ts +0 -75
  115. package/dist/update.js +7 -100
  116. package/dist/utils/export.d.ts +1 -13
  117. package/dist/utils/export.js +1 -13
  118. package/dist/workerGlobalPrefix.d.ts +0 -24
  119. package/dist/workerGlobalPrefix.js +6 -40
  120. package/dist/workerTypes.d.ts +0 -25
  121. package/dist/workerTypes.js +0 -24
  122. package/dist/workers.d.ts +0 -61
  123. package/dist/workers.js +4 -68
  124. package/npm-shrinkwrap.json +35 -5
  125. package/package.json +5 -5
  126. package/dist/broadcastServer.d.ts.map +0 -1
  127. package/dist/broadcastServer.js.map +0 -1
  128. package/dist/broadcastServerTypes.d.ts.map +0 -1
  129. package/dist/broadcastServerTypes.js.map +0 -1
  130. package/dist/cli.d.ts.map +0 -1
  131. package/dist/cli.js.map +0 -1
  132. package/dist/cliEmitter.d.ts.map +0 -1
  133. package/dist/cliEmitter.js.map +0 -1
  134. package/dist/cliHistory.d.ts.map +0 -1
  135. package/dist/cliHistory.js.map +0 -1
  136. package/dist/clusters/export.d.ts.map +0 -1
  137. package/dist/clusters/export.js.map +0 -1
  138. package/dist/deviceManager.d.ts.map +0 -1
  139. package/dist/deviceManager.js.map +0 -1
  140. package/dist/devices/airConditioner.d.ts.map +0 -1
  141. package/dist/devices/airConditioner.js.map +0 -1
  142. package/dist/devices/batteryStorage.d.ts.map +0 -1
  143. package/dist/devices/batteryStorage.js.map +0 -1
  144. package/dist/devices/cooktop.d.ts.map +0 -1
  145. package/dist/devices/cooktop.js.map +0 -1
  146. package/dist/devices/dishwasher.d.ts.map +0 -1
  147. package/dist/devices/dishwasher.js.map +0 -1
  148. package/dist/devices/evse.d.ts.map +0 -1
  149. package/dist/devices/evse.js.map +0 -1
  150. package/dist/devices/export.d.ts.map +0 -1
  151. package/dist/devices/export.js.map +0 -1
  152. package/dist/devices/extractorHood.d.ts.map +0 -1
  153. package/dist/devices/extractorHood.js.map +0 -1
  154. package/dist/devices/heatPump.d.ts.map +0 -1
  155. package/dist/devices/heatPump.js.map +0 -1
  156. package/dist/devices/laundryDryer.d.ts.map +0 -1
  157. package/dist/devices/laundryDryer.js.map +0 -1
  158. package/dist/devices/laundryWasher.d.ts.map +0 -1
  159. package/dist/devices/laundryWasher.js.map +0 -1
  160. package/dist/devices/microwaveOven.d.ts.map +0 -1
  161. package/dist/devices/microwaveOven.js.map +0 -1
  162. package/dist/devices/oven.d.ts.map +0 -1
  163. package/dist/devices/oven.js.map +0 -1
  164. package/dist/devices/refrigerator.d.ts.map +0 -1
  165. package/dist/devices/refrigerator.js.map +0 -1
  166. package/dist/devices/roboticVacuumCleaner.d.ts.map +0 -1
  167. package/dist/devices/roboticVacuumCleaner.js.map +0 -1
  168. package/dist/devices/solarPower.d.ts.map +0 -1
  169. package/dist/devices/solarPower.js.map +0 -1
  170. package/dist/devices/speaker.d.ts.map +0 -1
  171. package/dist/devices/speaker.js.map +0 -1
  172. package/dist/devices/temperatureControl.d.ts.map +0 -1
  173. package/dist/devices/temperatureControl.js.map +0 -1
  174. package/dist/devices/waterHeater.d.ts.map +0 -1
  175. package/dist/devices/waterHeater.js.map +0 -1
  176. package/dist/dgram/coap.d.ts +0 -205
  177. package/dist/dgram/coap.d.ts.map +0 -1
  178. package/dist/dgram/coap.js +0 -365
  179. package/dist/dgram/coap.js.map +0 -1
  180. package/dist/dgram/dgram.d.ts +0 -144
  181. package/dist/dgram/dgram.d.ts.map +0 -1
  182. package/dist/dgram/dgram.js +0 -363
  183. package/dist/dgram/dgram.js.map +0 -1
  184. package/dist/dgram/mb_coap.d.ts +0 -24
  185. package/dist/dgram/mb_coap.d.ts.map +0 -1
  186. package/dist/dgram/mb_coap.js.map +0 -1
  187. package/dist/dgram/mb_mdns.d.ts +0 -24
  188. package/dist/dgram/mb_mdns.d.ts.map +0 -1
  189. package/dist/dgram/mb_mdns.js.map +0 -1
  190. package/dist/dgram/mdns.d.ts +0 -371
  191. package/dist/dgram/mdns.d.ts.map +0 -1
  192. package/dist/dgram/mdns.js +0 -934
  193. package/dist/dgram/mdns.js.map +0 -1
  194. package/dist/dgram/multicast.d.ts +0 -67
  195. package/dist/dgram/multicast.d.ts.map +0 -1
  196. package/dist/dgram/multicast.js +0 -179
  197. package/dist/dgram/multicast.js.map +0 -1
  198. package/dist/dgram/unicast.d.ts +0 -64
  199. package/dist/dgram/unicast.d.ts.map +0 -1
  200. package/dist/dgram/unicast.js +0 -100
  201. package/dist/dgram/unicast.js.map +0 -1
  202. package/dist/frontend.d.ts.map +0 -1
  203. package/dist/frontend.js.map +0 -1
  204. package/dist/frontendTypes.d.ts.map +0 -1
  205. package/dist/frontendTypes.js.map +0 -1
  206. package/dist/helpers.d.ts.map +0 -1
  207. package/dist/helpers.js.map +0 -1
  208. package/dist/index.d.ts.map +0 -1
  209. package/dist/index.js.map +0 -1
  210. package/dist/jestutils/export.d.ts.map +0 -1
  211. package/dist/jestutils/export.js.map +0 -1
  212. package/dist/jestutils/jestHelpers.d.ts.map +0 -1
  213. package/dist/jestutils/jestHelpers.js.map +0 -1
  214. package/dist/logger/export.d.ts.map +0 -1
  215. package/dist/logger/export.js.map +0 -1
  216. package/dist/matter/behaviors.d.ts.map +0 -1
  217. package/dist/matter/behaviors.js.map +0 -1
  218. package/dist/matter/clusters.d.ts.map +0 -1
  219. package/dist/matter/clusters.js.map +0 -1
  220. package/dist/matter/devices.d.ts.map +0 -1
  221. package/dist/matter/devices.js.map +0 -1
  222. package/dist/matter/endpoints.d.ts.map +0 -1
  223. package/dist/matter/endpoints.js.map +0 -1
  224. package/dist/matter/export.d.ts.map +0 -1
  225. package/dist/matter/export.js.map +0 -1
  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.map +0 -1
  229. package/dist/matterNode.js.map +0 -1
  230. package/dist/matterbridge.d.ts.map +0 -1
  231. package/dist/matterbridge.js.map +0 -1
  232. package/dist/matterbridgeAccessoryPlatform.d.ts.map +0 -1
  233. package/dist/matterbridgeAccessoryPlatform.js.map +0 -1
  234. package/dist/matterbridgeBehaviors.d.ts.map +0 -1
  235. package/dist/matterbridgeBehaviors.js.map +0 -1
  236. package/dist/matterbridgeDeviceTypes.d.ts.map +0 -1
  237. package/dist/matterbridgeDeviceTypes.js.map +0 -1
  238. package/dist/matterbridgeDynamicPlatform.d.ts.map +0 -1
  239. package/dist/matterbridgeDynamicPlatform.js.map +0 -1
  240. package/dist/matterbridgeEndpoint.d.ts.map +0 -1
  241. package/dist/matterbridgeEndpoint.js.map +0 -1
  242. package/dist/matterbridgeEndpointHelpers.d.ts.map +0 -1
  243. package/dist/matterbridgeEndpointHelpers.js.map +0 -1
  244. package/dist/matterbridgeEndpointTypes.d.ts.map +0 -1
  245. package/dist/matterbridgeEndpointTypes.js.map +0 -1
  246. package/dist/matterbridgePlatform.d.ts.map +0 -1
  247. package/dist/matterbridgePlatform.js.map +0 -1
  248. package/dist/matterbridgeTypes.d.ts.map +0 -1
  249. package/dist/matterbridgeTypes.js.map +0 -1
  250. package/dist/pluginManager.d.ts.map +0 -1
  251. package/dist/pluginManager.js.map +0 -1
  252. package/dist/shelly.d.ts.map +0 -1
  253. package/dist/shelly.js.map +0 -1
  254. package/dist/storage/export.d.ts.map +0 -1
  255. package/dist/storage/export.js.map +0 -1
  256. package/dist/update.d.ts.map +0 -1
  257. package/dist/update.js.map +0 -1
  258. package/dist/utils/colorUtils.d.ts +0 -101
  259. package/dist/utils/colorUtils.d.ts.map +0 -1
  260. package/dist/utils/colorUtils.js +0 -282
  261. package/dist/utils/colorUtils.js.map +0 -1
  262. package/dist/utils/commandLine.d.ts +0 -66
  263. package/dist/utils/commandLine.d.ts.map +0 -1
  264. package/dist/utils/commandLine.js +0 -123
  265. package/dist/utils/commandLine.js.map +0 -1
  266. package/dist/utils/copyDirectory.d.ts +0 -35
  267. package/dist/utils/copyDirectory.d.ts.map +0 -1
  268. package/dist/utils/copyDirectory.js +0 -76
  269. package/dist/utils/copyDirectory.js.map +0 -1
  270. package/dist/utils/createDirectory.d.ts +0 -34
  271. package/dist/utils/createDirectory.d.ts.map +0 -1
  272. package/dist/utils/createDirectory.js +0 -54
  273. package/dist/utils/createDirectory.js.map +0 -1
  274. package/dist/utils/createZip.d.ts +0 -39
  275. package/dist/utils/createZip.d.ts.map +0 -1
  276. package/dist/utils/createZip.js +0 -114
  277. package/dist/utils/createZip.js.map +0 -1
  278. package/dist/utils/deepCopy.d.ts +0 -32
  279. package/dist/utils/deepCopy.d.ts.map +0 -1
  280. package/dist/utils/deepCopy.js +0 -79
  281. package/dist/utils/deepCopy.js.map +0 -1
  282. package/dist/utils/deepEqual.d.ts +0 -54
  283. package/dist/utils/deepEqual.d.ts.map +0 -1
  284. package/dist/utils/deepEqual.js +0 -129
  285. package/dist/utils/deepEqual.js.map +0 -1
  286. package/dist/utils/error.d.ts +0 -45
  287. package/dist/utils/error.d.ts.map +0 -1
  288. package/dist/utils/error.js +0 -54
  289. package/dist/utils/error.js.map +0 -1
  290. package/dist/utils/export.d.ts.map +0 -1
  291. package/dist/utils/export.js.map +0 -1
  292. package/dist/utils/format.d.ts +0 -53
  293. package/dist/utils/format.d.ts.map +0 -1
  294. package/dist/utils/format.js +0 -78
  295. package/dist/utils/format.js.map +0 -1
  296. package/dist/utils/hex.d.ts +0 -89
  297. package/dist/utils/hex.d.ts.map +0 -1
  298. package/dist/utils/hex.js +0 -242
  299. package/dist/utils/hex.js.map +0 -1
  300. package/dist/utils/inspector.d.ts +0 -87
  301. package/dist/utils/inspector.d.ts.map +0 -1
  302. package/dist/utils/inspector.js +0 -268
  303. package/dist/utils/inspector.js.map +0 -1
  304. package/dist/utils/isValid.d.ts +0 -103
  305. package/dist/utils/isValid.d.ts.map +0 -1
  306. package/dist/utils/isValid.js +0 -162
  307. package/dist/utils/isValid.js.map +0 -1
  308. package/dist/utils/network.d.ts +0 -141
  309. package/dist/utils/network.d.ts.map +0 -1
  310. package/dist/utils/network.js +0 -314
  311. package/dist/utils/network.js.map +0 -1
  312. package/dist/utils/spawn.d.ts +0 -33
  313. package/dist/utils/spawn.d.ts.map +0 -1
  314. package/dist/utils/spawn.js.map +0 -1
  315. package/dist/utils/tracker.d.ts +0 -108
  316. package/dist/utils/tracker.d.ts.map +0 -1
  317. package/dist/utils/tracker.js +0 -264
  318. package/dist/utils/tracker.js.map +0 -1
  319. package/dist/utils/wait.d.ts +0 -54
  320. package/dist/utils/wait.d.ts.map +0 -1
  321. package/dist/utils/wait.js +0 -125
  322. package/dist/utils/wait.js.map +0 -1
  323. package/dist/workerGlobalPrefix.d.ts.map +0 -1
  324. package/dist/workerGlobalPrefix.js.map +0 -1
  325. package/dist/workerTypes.d.ts.map +0 -1
  326. package/dist/workerTypes.js.map +0 -1
  327. package/dist/workers.d.ts.map +0 -1
  328. package/dist/workers.js.map +0 -1
package/dist/utils/hex.js DELETED
@@ -1,242 +0,0 @@
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
- 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
- export function bufferToHex(buffer) {
40
- // Check if the input is an ArrayBuffer or ArrayBufferView
41
- if (!(buffer instanceof ArrayBuffer || ArrayBuffer.isView(buffer))) {
42
- throw new TypeError('Expected input to be an ArrayBuffer or ArrayBufferView');
43
- }
44
- // Create a Uint8Array view over the buffer
45
- const bytes = buffer instanceof Uint8Array ? buffer : new Uint8Array(buffer);
46
- // Convert each byte to 2-digit hex
47
- return Array.from(bytes)
48
- .map((byte) => byte.toString(16).padStart(2, '0'))
49
- .join('');
50
- }
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
- export function hexToBuffer(hex) {
61
- // Ensure the input is a string
62
- if (typeof hex !== 'string') {
63
- throw new TypeError('Expected a string for hex input');
64
- }
65
- // Trim any whitespace from the input string
66
- const cleaned = hex.trim();
67
- // Check if the length of the hex string is even
68
- if (cleaned.length % 2 !== 0) {
69
- throw new Error('Invalid hex string length, must be even');
70
- }
71
- // Validate that the string contains only valid hex characters
72
- if (!/^[0-9a-fA-F]*$/.test(cleaned)) {
73
- throw new Error('Invalid hex string, contains non-hex characters');
74
- }
75
- // Calculate the length of the resulting Uint8Array
76
- const length = cleaned.length / 2;
77
- // Create a Uint8Array to hold the binary data
78
- const result = new Uint8Array(length);
79
- // Convert each pair of hex characters into a byte
80
- for (let i = 0; i < length; i++) {
81
- result[i] = parseInt(cleaned.substr(i * 2, 2), 16);
82
- }
83
- // Return the resulting Uint8Array
84
- return result;
85
- }
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
- export function pemToBuffer(pem, validate = false) {
101
- // Ensure the input is a string
102
- if (typeof pem !== 'string') {
103
- throw new TypeError('Expected a string for PEM input');
104
- }
105
- // Trim whitespace from the input
106
- const cleaned = pem.trim();
107
- // Check if the string appears to be in PEM format
108
- if (!cleaned.includes('-----BEGIN') || !cleaned.includes('-----END')) {
109
- throw new Error('Invalid PEM format: missing BEGIN/END markers');
110
- }
111
- // Extract the base64 content between the header and footer
112
- const lines = cleaned.split('\n');
113
- const base64Lines = [];
114
- let inContent = false;
115
- for (const line of lines) {
116
- const trimmedLine = line.trim();
117
- if (trimmedLine.startsWith('-----BEGIN')) {
118
- inContent = true;
119
- continue;
120
- }
121
- if (trimmedLine.startsWith('-----END')) {
122
- inContent = false;
123
- break;
124
- }
125
- if (inContent && trimmedLine.length > 0) {
126
- base64Lines.push(trimmedLine);
127
- }
128
- }
129
- if (base64Lines.length === 0) {
130
- throw new Error('Invalid PEM format: no content found between BEGIN/END markers');
131
- }
132
- // Join all base64 lines together
133
- const base64String = base64Lines.join('');
134
- // Validate base64 string format
135
- if (!/^[A-Za-z0-9+/]*={0,2}$/.test(base64String)) {
136
- throw new Error('Invalid PEM format: contains invalid base64 characters');
137
- }
138
- try {
139
- // Use Node.js Buffer API instead of legacy atob()
140
- const buffer = Buffer.from(base64String, 'base64');
141
- // Convert Buffer to Uint8Array
142
- const result = new Uint8Array(buffer);
143
- // Validate PEM content using Node.js crypto module if requested
144
- if (validate) {
145
- try {
146
- // Determine PEM type from the header and validate accordingly
147
- const pemType = cleaned.match(/-----BEGIN\s+([^-]+)-----/)?.[1]?.trim();
148
- if (pemType?.includes('CERTIFICATE')) {
149
- // Use X509Certificate for robust certificate validation
150
- const cert = new X509Certificate(pem);
151
- // Check validity period
152
- if (cert.validFrom && cert.validTo) {
153
- const now = Date.now();
154
- const from = Date.parse(cert.validFrom);
155
- const to = Date.parse(cert.validTo);
156
- // istanbul ignore next if
157
- if (now < from || now > to) {
158
- throw new Error('Certificate is not currently valid');
159
- }
160
- }
161
- // Check subject/issuer fields
162
- // istanbul ignore next if
163
- if (!cert.subject || !cert.issuer) {
164
- throw new Error('Certificate missing subject or issuer');
165
- }
166
- // Optionally check signature (not possible without CA chain)
167
- }
168
- else if (pemType?.includes('PRIVATE KEY')) {
169
- // For private keys, try to create a private key
170
- createPrivateKey({ key: pem, format: 'pem' });
171
- }
172
- else if (pemType?.includes('PUBLIC KEY')) {
173
- // For public keys, try to create a public key
174
- createPublicKey({ key: pem, format: 'pem' });
175
- }
176
- // If no specific type is detected, skip validation
177
- }
178
- catch (validationError) {
179
- // istanbul ignore next
180
- throw new Error(`PEM validation failed: ${validationError instanceof Error ? validationError.message : String(validationError)}`);
181
- }
182
- }
183
- return result;
184
- }
185
- catch (error) {
186
- // istanbul ignore next
187
- throw new Error(`Failed to decode base64 content: ${error instanceof Error ? error.message : String(error)}`);
188
- }
189
- }
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
- export function extractPrivateKeyRaw(pemPrivateKey) {
215
- if (typeof pemPrivateKey !== 'string') {
216
- throw new TypeError('Expected a string for PEM private key input');
217
- }
218
- // Extract the private key block
219
- const keyBlock = /-----BEGIN (?:EC )?PRIVATE KEY-----[^-]+-----END (?:EC )?PRIVATE KEY-----/s.exec(pemPrivateKey);
220
- if (!keyBlock) {
221
- throw new Error('No EC PRIVATE KEY block found in the supplied PEM');
222
- }
223
- try {
224
- // Create a private key object
225
- const privateKey = createPrivateKey(keyBlock[0]);
226
- // Export as PKCS#8 DER format
227
- 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
- if (pkcs8Der.length < 32) {
231
- throw new Error('Invalid private key: DER data too short');
232
- }
233
- // Extract the last 32 bytes which contain the raw private scalar
234
- const rawPrivateKey = pkcs8Der.subarray(pkcs8Der.length - 32);
235
- return new Uint8Array(rawPrivateKey);
236
- }
237
- catch (error) {
238
- // istanbul ignore next
239
- throw new Error(`Failed to extract private key: ${error instanceof Error ? error.message : String(error)}`);
240
- }
241
- }
242
- //# sourceMappingURL=hex.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"hex.js","sourceRoot":"","sources":["../../src/utils/hex.ts"],"names":[],"mappings":"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"}
@@ -1,87 +0,0 @@
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
- import EventEmitter from 'node:events';
25
- interface InspectorEvents {
26
- /** Start the inspector */
27
- start: [];
28
- /** Stop the inspector */
29
- stop: [];
30
- /** Take a heap snapshot */
31
- snapshot: [];
32
- /** Heap snapshot done */
33
- snapshot_done: [];
34
- /** Run garbage collector */
35
- gc: [type?: 'major' | 'minor', execution?: 'sync' | 'async'];
36
- /** Garbage collection done */
37
- gc_done: [type: 'major' | 'minor', execution: 'sync' | 'async'];
38
- }
39
- export declare class Inspector extends EventEmitter<InspectorEvents> {
40
- private readonly name;
41
- private readonly debug;
42
- private readonly verbose;
43
- private session;
44
- private snapshotInterval?;
45
- private snapshotInProgress;
46
- private log;
47
- 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
- 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
- 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
- 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
- runGarbageCollector(type?: 'major' | 'minor', execution?: 'sync' | 'async'): void;
85
- }
86
- export {};
87
- //# sourceMappingURL=inspector.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../src/utils/inspector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,YAAY,MAAM,aAAa,CAAC;AAMvC,UAAU,eAAe;IACvB,0BAA0B;IAC1B,KAAK,EAAE,EAAE,CAAC;IACV,yBAAyB;IACzB,IAAI,EAAE,EAAE,CAAC;IACT,2BAA2B;IAC3B,QAAQ,EAAE,EAAE,CAAC;IACb,yBAAyB;IACzB,aAAa,EAAE,EAAE,CAAC;IAClB,4BAA4B;IAC5B,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAC7D,8BAA8B;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;CACjE;AAED,qBAAa,SAAU,SAAQ,YAAY,CAAC,eAAe,CAAC;IAQxD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,gBAAgB,CAAC,CAAiB;IAE1C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,GAAG,CAAa;gBAGL,IAAI,GAAE,MAAoB,EAC1B,KAAK,GAAE,OAAe,EACtB,OAAO,GAAE,OAAe;IA6B3C;;;;;;;;OAQG;IACG,KAAK;IAmDX;;;OAGG;IACG,IAAI;IAuCV;;;;;;;;OAQG;IACG,gBAAgB;IAsEtB;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,IAAI,GAAE,OAAO,GAAG,OAAiB,EAAE,SAAS,GAAE,MAAM,GAAG,OAAiB;CAe7F"}
@@ -1,268 +0,0 @@
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
- /* eslint-disable no-console */
25
- if (process.argv.includes('--loader') || process.argv.includes('-loader'))
26
- console.log('\u001B[32mInspector loaded.\u001B[40;0m');
27
- import EventEmitter from 'node:events';
28
- import { AnsiLogger, BRIGHT, CYAN, RESET, YELLOW, db } from 'node-ansi-logger';
29
- export class Inspector extends EventEmitter {
30
- name;
31
- debug;
32
- verbose;
33
- session;
34
- snapshotInterval;
35
- snapshotInProgress = false;
36
- log;
37
- constructor(name = 'Inspector', debug = false, verbose = false) {
38
- super();
39
- this.name = name;
40
- this.debug = debug;
41
- this.verbose = verbose;
42
- if (process.argv.includes('--debug') || process.argv.includes('-debug')) {
43
- this.debug = true;
44
- }
45
- if (process.argv.includes('--verbose') || process.argv.includes('-verbose')) {
46
- this.verbose = true;
47
- }
48
- this.log = new AnsiLogger({ logName: this.name, logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: this.debug ? "debug" /* LogLevel.DEBUG */ : "info" /* LogLevel.INFO */ });
49
- this.log.logNameColor = YELLOW;
50
- this.on('start', () => {
51
- this.start();
52
- });
53
- this.on('stop', () => {
54
- this.stop();
55
- });
56
- this.on('snapshot', () => {
57
- this.takeHeapSnapshot();
58
- });
59
- this.on('gc', () => {
60
- this.runGarbageCollector();
61
- });
62
- }
63
- /**
64
- * Starts the inspector for heap sampling.
65
- *
66
- * This function is called when the -inspect parameter is passed to matterbridge.
67
- *
68
- * The -snapshotinterval parameter can be used to set the heap snapshot interval. Default is undefined. Minimum is 30000 ms.
69
- * The snapshot is saved in the heap_profiles 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
- async start() {
73
- if (this.session) {
74
- this.log.warn('Inspector session already active.');
75
- return;
76
- }
77
- const { Session } = await import('node:inspector');
78
- const { mkdirSync } = await import('node:fs');
79
- this.log.debug(`Starting heap sampling...`);
80
- // Create the heap profiles directory if it doesn't exist
81
- mkdirSync('heap_profiles', { recursive: true });
82
- // Create the heap snapshots directory if it doesn't exist
83
- mkdirSync('heap_snapshots', { recursive: true });
84
- try {
85
- this.session = new Session();
86
- this.session.connect();
87
- await new Promise((resolve, reject) => {
88
- this.session?.post('HeapProfiler.startSampling', (err) => (err ? reject(err) : resolve()));
89
- });
90
- this.log.debug(`Started heap sampling`);
91
- // Set an interval to take heap snapshots
92
- const { getIntParameter } = await import('./commandLine.js');
93
- const interval = getIntParameter('snapshotinterval');
94
- if (interval && interval >= 30000) {
95
- this.log.debug(`Started heap snapshot interval of ${CYAN}${interval}${db} ms`);
96
- clearInterval(this.snapshotInterval);
97
- this.snapshotInterval = setInterval(async () => {
98
- try {
99
- if (this.snapshotInProgress) {
100
- if (this.debug)
101
- this.log.debug(`Skip heap snapshot: previous snapshot still in progress`);
102
- return;
103
- }
104
- this.log.debug(`Run heap snapshot interval`);
105
- await this.takeHeapSnapshot();
106
- }
107
- catch (err) {
108
- this.log.error(`Error during scheduled heap snapshot: ${err instanceof Error ? err.message : err}`);
109
- }
110
- }, interval).unref();
111
- }
112
- }
113
- catch (err) {
114
- this.log.error(`Failed to start heap sampling: ${err instanceof Error ? err.message : err}`);
115
- this.session?.disconnect();
116
- this.session = undefined;
117
- return;
118
- }
119
- }
120
- /**
121
- * Stops the heap sampling and saves the profile to a file in the heap_profiles directory.
122
- * This function is called when the inspector is stopped.
123
- */
124
- async stop() {
125
- if (!this.session) {
126
- this.log.warn('No active inspector session.');
127
- return;
128
- }
129
- const { writeFileSync } = await import('node:fs');
130
- const path = await import('node:path');
131
- this.log.debug(`Stopping heap sampling...`);
132
- if (this.snapshotInterval) {
133
- this.log.debug(`Clearing heap snapshot interval...`);
134
- // Clear the snapshot interval if it exists
135
- clearInterval(this.snapshotInterval);
136
- // Take a final heap snapshot before stopping
137
- await this.takeHeapSnapshot();
138
- }
139
- try {
140
- const result = await new Promise((resolve, reject) => {
141
- this.session?.post('HeapProfiler.stopSampling', (err, result) => (err ? reject(err) : resolve(result)));
142
- });
143
- const profile = JSON.stringify(result.profile);
144
- const safeTimestamp = new Date().toISOString().replace(/[<>:"/\\|?*]/g, '-');
145
- const filename = path.join('heap_profiles', `${safeTimestamp}.heapprofile`);
146
- writeFileSync(filename, profile);
147
- this.log.debug(`Heap sampling profile saved to ${CYAN}${filename}${db}`);
148
- }
149
- catch (err) {
150
- this.log.error(`Failed to stop heap sampling: ${err instanceof Error ? err.message : err}`);
151
- }
152
- finally {
153
- this.session.disconnect();
154
- this.session = undefined;
155
- this.log.debug(`Stopped heap sampling`);
156
- }
157
- }
158
- /**
159
- * Takes a heap snapshot and saves it to the file name 'heap_snapshots/<timestamp>.heapsnapshot'.
160
- * If triggers a full garbage collection before and after taking the snapshot to reduce noise.
161
- *
162
- * This function is called periodically based on the -snapshotinterval parameter.
163
- * The -snapshotinterval parameter must at least 30000 ms.
164
- * The snapshot is saved in the heap_snapshots directory that is created in the current working directory.
165
- * The snapshot can be analyzed using vscode or Chrome DevTools or other tools that support heap snapshots.
166
- */
167
- async takeHeapSnapshot() {
168
- if (!this.session) {
169
- this.log.warn('No active inspector session.');
170
- return;
171
- }
172
- if (this.snapshotInProgress) {
173
- if (this.debug)
174
- this.log.debug('Heap snapshot already in progress, skipping.');
175
- return;
176
- }
177
- this.snapshotInProgress = true;
178
- const { createWriteStream } = await import('node:fs');
179
- const path = await import('node:path');
180
- const safeTimestamp = new Date().toISOString().replace(/[<>:"/\\|?*]/g, '-');
181
- const filename = path.join('heap_snapshots', `${safeTimestamp}.heapsnapshot`);
182
- // Trigger a garbage collection before taking the snapshot to reduce noise
183
- this.runGarbageCollector('minor', 'async');
184
- this.runGarbageCollector('major', 'async');
185
- if (this.debug)
186
- this.log.debug(`Taking heap snapshot to ${CYAN}${filename}${db}...`);
187
- const stream = createWriteStream(filename, { flags: 'w' });
188
- let streamErrored = false;
189
- const onStreamError = (err) => {
190
- streamErrored = true;
191
- this.log.error(`Heap snapshot stream error: ${err instanceof Error ? err.message : err}`);
192
- };
193
- stream.once('error', onStreamError);
194
- const chunksListener = (notification) => {
195
- // notification.params.chunk is a string; write directly to the stream
196
- if (!stream.write(notification.params.chunk)) {
197
- // If backpressure engages, it's fine; the stream will buffer internally. We don't block the inspector.
198
- }
199
- };
200
- this.session.on('HeapProfiler.addHeapSnapshotChunk', chunksListener);
201
- try {
202
- await new Promise((resolve) => {
203
- this.session?.post('HeapProfiler.takeHeapSnapshot', (err) => {
204
- // Detach chunk listener and close the stream, then perform post-actions
205
- this.session?.off('HeapProfiler.addHeapSnapshotChunk', chunksListener);
206
- const finalize = () => {
207
- if (!err && !streamErrored) {
208
- if (this.debug)
209
- this.log.debug(`Heap sampling snapshot saved to ${CYAN}${filename}${db}`);
210
- this.runGarbageCollector('minor', 'async');
211
- this.runGarbageCollector('major', 'async');
212
- this.emit('snapshot_done');
213
- }
214
- else if (err) {
215
- this.log.error(`Failed to take heap snapshot: ${err instanceof Error ? err.message : err}`);
216
- this.runGarbageCollector('minor', 'async');
217
- this.runGarbageCollector('major', 'async');
218
- }
219
- resolve();
220
- };
221
- // End stream and wait for finish or error
222
- try {
223
- stream.end(() => finalize());
224
- }
225
- catch (e) {
226
- this.log.error(`Error finalizing heap snapshot stream: ${e instanceof Error ? e.message : e}`);
227
- finalize();
228
- }
229
- });
230
- });
231
- }
232
- finally {
233
- this.snapshotInProgress = false;
234
- }
235
- }
236
- /**
237
- * Manually trigger garbage collection to free memory (if exposed with --expose-gc)
238
- *
239
- * @param {'major' | 'minor'} type - The type of garbage collection to perform ('major' or 'minor'). Default is 'major'.
240
- * @param {'sync' | 'async'} execution - The execution mode of garbage collection ('sync' or 'async'). Default is 'async'.
241
- *
242
- * @remarks
243
- * - major collection refers to old-generation mark-sweep/mark-compact cycles.
244
- * - minor collection refers to young-generation collections (scavenges).
245
- * - sync execution blocks the main thread until GC is complete, which can cause pauses.
246
- */
247
- runGarbageCollector(type = 'major', execution = 'async') {
248
- if (global.gc && typeof global.gc === 'function') {
249
- try {
250
- global.gc({ type, execution });
251
- if (this.debug)
252
- this.log.debug(`${CYAN}${BRIGHT}Garbage collection (${type}-${execution}) triggered at ${new Date(Date.now()).toLocaleString()}.${RESET}${db}`);
253
- this.emit('gc_done', type, execution);
254
- }
255
- catch {
256
- global.gc();
257
- if (this.debug)
258
- this.log.debug(`${CYAN}${BRIGHT}Garbage collection (minor-async) triggered at ${new Date(Date.now()).toLocaleString()}.${RESET}${db}`);
259
- this.emit('gc_done', 'minor', 'async');
260
- }
261
- }
262
- else {
263
- if (this.debug)
264
- this.log.debug(`${CYAN}${BRIGHT}Garbage collection not exposed. Start Node.js with --expose-gc to enable manual garbage collection.${RESET}${db}`);
265
- }
266
- }
267
- }
268
- //# sourceMappingURL=inspector.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"inspector.js","sourceRoot":"","sources":["../../src/utils/inspector.ts"],"names":[],"mappings":"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"}