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.
- package/CHANGELOG.md +14 -0
- package/bin/mb_coap.js +1 -1
- package/bin/mb_mdns.js +1 -1
- package/dist/broadcastServer.d.ts +0 -115
- package/dist/broadcastServer.js +1 -119
- package/dist/broadcastServerTypes.d.ts +0 -43
- package/dist/broadcastServerTypes.js +0 -24
- package/dist/cli.d.ts +1 -26
- package/dist/cli.js +2 -102
- package/dist/cliEmitter.d.ts +0 -36
- package/dist/cliEmitter.js +0 -37
- package/dist/cliHistory.d.ts +0 -42
- package/dist/cliHistory.js +1 -39
- package/dist/clusters/export.d.ts +0 -1
- package/dist/clusters/export.js +0 -2
- package/dist/deviceManager.d.ts +0 -108
- package/dist/deviceManager.js +2 -114
- package/dist/devices/airConditioner.d.ts +0 -75
- package/dist/devices/airConditioner.js +0 -57
- package/dist/devices/batteryStorage.d.ts +0 -43
- package/dist/devices/batteryStorage.js +1 -48
- package/dist/devices/cooktop.d.ts +0 -55
- package/dist/devices/cooktop.js +0 -56
- package/dist/devices/dishwasher.d.ts +0 -55
- package/dist/devices/dishwasher.js +0 -57
- package/dist/devices/evse.d.ts +0 -57
- package/dist/devices/evse.js +10 -74
- package/dist/devices/export.d.ts +0 -1
- package/dist/devices/export.js +0 -5
- package/dist/devices/extractorHood.d.ts +0 -41
- package/dist/devices/extractorHood.js +0 -43
- package/dist/devices/heatPump.d.ts +0 -43
- package/dist/devices/heatPump.js +2 -50
- package/dist/devices/laundryDryer.d.ts +0 -58
- package/dist/devices/laundryDryer.js +3 -62
- package/dist/devices/laundryWasher.d.ts +0 -64
- package/dist/devices/laundryWasher.js +4 -70
- package/dist/devices/microwaveOven.d.ts +1 -77
- package/dist/devices/microwaveOven.js +5 -88
- package/dist/devices/oven.d.ts +0 -82
- package/dist/devices/oven.js +0 -85
- package/dist/devices/refrigerator.d.ts +0 -100
- package/dist/devices/refrigerator.js +0 -102
- package/dist/devices/roboticVacuumCleaner.d.ts +0 -83
- package/dist/devices/roboticVacuumCleaner.js +9 -100
- package/dist/devices/solarPower.d.ts +0 -36
- package/dist/devices/solarPower.js +0 -38
- package/dist/devices/speaker.d.ts +0 -79
- package/dist/devices/speaker.js +0 -84
- package/dist/devices/temperatureControl.d.ts +0 -21
- package/dist/devices/temperatureControl.js +3 -24
- package/dist/devices/waterHeater.d.ts +0 -74
- package/dist/devices/waterHeater.js +2 -82
- package/dist/frontend.d.ts +0 -187
- package/dist/frontend.js +39 -505
- package/dist/frontendTypes.d.ts +0 -57
- package/dist/frontendTypes.js +0 -45
- package/dist/helpers.d.ts +0 -43
- package/dist/helpers.js +1 -54
- package/dist/index.d.ts +0 -23
- package/dist/index.js +0 -25
- package/dist/jestutils/export.d.ts +0 -1
- package/dist/jestutils/export.js +0 -1
- package/dist/jestutils/jestHelpers.d.ts +0 -255
- package/dist/jestutils/jestHelpers.js +14 -372
- package/dist/logger/export.d.ts +0 -1
- package/dist/logger/export.js +0 -1
- package/dist/matter/behaviors.d.ts +0 -1
- package/dist/matter/behaviors.js +0 -2
- package/dist/matter/clusters.d.ts +0 -1
- package/dist/matter/clusters.js +0 -2
- package/dist/matter/devices.d.ts +0 -1
- package/dist/matter/devices.js +0 -2
- package/dist/matter/endpoints.d.ts +0 -1
- package/dist/matter/endpoints.js +0 -2
- package/dist/matter/export.d.ts +0 -1
- package/dist/matter/export.js +0 -2
- package/dist/matter/types.d.ts +0 -1
- package/dist/matter/types.js +0 -2
- package/dist/matterNode.d.ts +0 -258
- package/dist/matterNode.js +9 -364
- package/dist/matterbridge.d.ts +0 -362
- package/dist/matterbridge.js +60 -860
- package/dist/matterbridgeAccessoryPlatform.d.ts +0 -36
- package/dist/matterbridgeAccessoryPlatform.js +0 -38
- package/dist/matterbridgeBehaviors.d.ts +0 -24
- package/dist/matterbridgeBehaviors.js +5 -68
- package/dist/matterbridgeDeviceTypes.d.ts +0 -649
- package/dist/matterbridgeDeviceTypes.js +6 -673
- package/dist/matterbridgeDynamicPlatform.d.ts +0 -36
- package/dist/matterbridgeDynamicPlatform.js +0 -38
- package/dist/matterbridgeEndpoint.d.ts +2 -1332
- package/dist/matterbridgeEndpoint.js +94 -1459
- package/dist/matterbridgeEndpointHelpers.d.ts +0 -425
- package/dist/matterbridgeEndpointHelpers.js +21 -486
- package/dist/matterbridgeEndpointTypes.d.ts +0 -70
- package/dist/matterbridgeEndpointTypes.js +0 -25
- package/dist/matterbridgePlatform.d.ts +0 -425
- package/dist/matterbridgePlatform.js +2 -453
- package/dist/matterbridgeTypes.d.ts +0 -46
- package/dist/matterbridgeTypes.js +0 -26
- package/dist/mb_coap.d.ts +1 -0
- package/dist/{dgram/mb_coap.js → mb_coap.js} +3 -41
- package/dist/mb_mdns.d.ts +1 -0
- package/dist/{dgram/mb_mdns.js → mb_mdns.js} +37 -81
- package/dist/pluginManager.d.ts +0 -305
- package/dist/pluginManager.js +8 -345
- package/dist/shelly.d.ts +0 -157
- package/dist/shelly.js +7 -178
- package/dist/spawn.d.ts +1 -0
- package/dist/{utils/spawn.js → spawn.js} +3 -73
- package/dist/storage/export.d.ts +0 -1
- package/dist/storage/export.js +0 -1
- package/dist/update.d.ts +0 -75
- package/dist/update.js +7 -100
- package/dist/utils/export.d.ts +1 -13
- package/dist/utils/export.js +1 -13
- package/dist/workerGlobalPrefix.d.ts +0 -24
- package/dist/workerGlobalPrefix.js +6 -40
- package/dist/workerTypes.d.ts +0 -25
- package/dist/workerTypes.js +0 -24
- package/dist/workers.d.ts +0 -61
- package/dist/workers.js +4 -68
- package/npm-shrinkwrap.json +35 -5
- package/package.json +5 -5
- package/dist/broadcastServer.d.ts.map +0 -1
- package/dist/broadcastServer.js.map +0 -1
- package/dist/broadcastServerTypes.d.ts.map +0 -1
- package/dist/broadcastServerTypes.js.map +0 -1
- package/dist/cli.d.ts.map +0 -1
- package/dist/cli.js.map +0 -1
- package/dist/cliEmitter.d.ts.map +0 -1
- package/dist/cliEmitter.js.map +0 -1
- package/dist/cliHistory.d.ts.map +0 -1
- package/dist/cliHistory.js.map +0 -1
- package/dist/clusters/export.d.ts.map +0 -1
- package/dist/clusters/export.js.map +0 -1
- package/dist/deviceManager.d.ts.map +0 -1
- package/dist/deviceManager.js.map +0 -1
- package/dist/devices/airConditioner.d.ts.map +0 -1
- package/dist/devices/airConditioner.js.map +0 -1
- package/dist/devices/batteryStorage.d.ts.map +0 -1
- package/dist/devices/batteryStorage.js.map +0 -1
- package/dist/devices/cooktop.d.ts.map +0 -1
- package/dist/devices/cooktop.js.map +0 -1
- package/dist/devices/dishwasher.d.ts.map +0 -1
- package/dist/devices/dishwasher.js.map +0 -1
- package/dist/devices/evse.d.ts.map +0 -1
- package/dist/devices/evse.js.map +0 -1
- package/dist/devices/export.d.ts.map +0 -1
- package/dist/devices/export.js.map +0 -1
- package/dist/devices/extractorHood.d.ts.map +0 -1
- package/dist/devices/extractorHood.js.map +0 -1
- package/dist/devices/heatPump.d.ts.map +0 -1
- package/dist/devices/heatPump.js.map +0 -1
- package/dist/devices/laundryDryer.d.ts.map +0 -1
- package/dist/devices/laundryDryer.js.map +0 -1
- package/dist/devices/laundryWasher.d.ts.map +0 -1
- package/dist/devices/laundryWasher.js.map +0 -1
- package/dist/devices/microwaveOven.d.ts.map +0 -1
- package/dist/devices/microwaveOven.js.map +0 -1
- package/dist/devices/oven.d.ts.map +0 -1
- package/dist/devices/oven.js.map +0 -1
- package/dist/devices/refrigerator.d.ts.map +0 -1
- package/dist/devices/refrigerator.js.map +0 -1
- package/dist/devices/roboticVacuumCleaner.d.ts.map +0 -1
- package/dist/devices/roboticVacuumCleaner.js.map +0 -1
- package/dist/devices/solarPower.d.ts.map +0 -1
- package/dist/devices/solarPower.js.map +0 -1
- package/dist/devices/speaker.d.ts.map +0 -1
- package/dist/devices/speaker.js.map +0 -1
- package/dist/devices/temperatureControl.d.ts.map +0 -1
- package/dist/devices/temperatureControl.js.map +0 -1
- package/dist/devices/waterHeater.d.ts.map +0 -1
- package/dist/devices/waterHeater.js.map +0 -1
- package/dist/dgram/coap.d.ts +0 -205
- package/dist/dgram/coap.d.ts.map +0 -1
- package/dist/dgram/coap.js +0 -365
- package/dist/dgram/coap.js.map +0 -1
- package/dist/dgram/dgram.d.ts +0 -144
- package/dist/dgram/dgram.d.ts.map +0 -1
- package/dist/dgram/dgram.js +0 -363
- package/dist/dgram/dgram.js.map +0 -1
- package/dist/dgram/mb_coap.d.ts +0 -24
- package/dist/dgram/mb_coap.d.ts.map +0 -1
- package/dist/dgram/mb_coap.js.map +0 -1
- package/dist/dgram/mb_mdns.d.ts +0 -24
- package/dist/dgram/mb_mdns.d.ts.map +0 -1
- package/dist/dgram/mb_mdns.js.map +0 -1
- package/dist/dgram/mdns.d.ts +0 -371
- package/dist/dgram/mdns.d.ts.map +0 -1
- package/dist/dgram/mdns.js +0 -934
- package/dist/dgram/mdns.js.map +0 -1
- package/dist/dgram/multicast.d.ts +0 -67
- package/dist/dgram/multicast.d.ts.map +0 -1
- package/dist/dgram/multicast.js +0 -179
- package/dist/dgram/multicast.js.map +0 -1
- package/dist/dgram/unicast.d.ts +0 -64
- package/dist/dgram/unicast.d.ts.map +0 -1
- package/dist/dgram/unicast.js +0 -100
- package/dist/dgram/unicast.js.map +0 -1
- package/dist/frontend.d.ts.map +0 -1
- package/dist/frontend.js.map +0 -1
- package/dist/frontendTypes.d.ts.map +0 -1
- package/dist/frontendTypes.js.map +0 -1
- package/dist/helpers.d.ts.map +0 -1
- package/dist/helpers.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/jestutils/export.d.ts.map +0 -1
- package/dist/jestutils/export.js.map +0 -1
- package/dist/jestutils/jestHelpers.d.ts.map +0 -1
- package/dist/jestutils/jestHelpers.js.map +0 -1
- package/dist/logger/export.d.ts.map +0 -1
- package/dist/logger/export.js.map +0 -1
- package/dist/matter/behaviors.d.ts.map +0 -1
- package/dist/matter/behaviors.js.map +0 -1
- package/dist/matter/clusters.d.ts.map +0 -1
- package/dist/matter/clusters.js.map +0 -1
- package/dist/matter/devices.d.ts.map +0 -1
- package/dist/matter/devices.js.map +0 -1
- package/dist/matter/endpoints.d.ts.map +0 -1
- package/dist/matter/endpoints.js.map +0 -1
- package/dist/matter/export.d.ts.map +0 -1
- package/dist/matter/export.js.map +0 -1
- package/dist/matter/types.d.ts.map +0 -1
- package/dist/matter/types.js.map +0 -1
- package/dist/matterNode.d.ts.map +0 -1
- package/dist/matterNode.js.map +0 -1
- package/dist/matterbridge.d.ts.map +0 -1
- package/dist/matterbridge.js.map +0 -1
- package/dist/matterbridgeAccessoryPlatform.d.ts.map +0 -1
- package/dist/matterbridgeAccessoryPlatform.js.map +0 -1
- package/dist/matterbridgeBehaviors.d.ts.map +0 -1
- package/dist/matterbridgeBehaviors.js.map +0 -1
- package/dist/matterbridgeDeviceTypes.d.ts.map +0 -1
- package/dist/matterbridgeDeviceTypes.js.map +0 -1
- package/dist/matterbridgeDynamicPlatform.d.ts.map +0 -1
- package/dist/matterbridgeDynamicPlatform.js.map +0 -1
- package/dist/matterbridgeEndpoint.d.ts.map +0 -1
- package/dist/matterbridgeEndpoint.js.map +0 -1
- package/dist/matterbridgeEndpointHelpers.d.ts.map +0 -1
- package/dist/matterbridgeEndpointHelpers.js.map +0 -1
- package/dist/matterbridgeEndpointTypes.d.ts.map +0 -1
- package/dist/matterbridgeEndpointTypes.js.map +0 -1
- package/dist/matterbridgePlatform.d.ts.map +0 -1
- package/dist/matterbridgePlatform.js.map +0 -1
- package/dist/matterbridgeTypes.d.ts.map +0 -1
- package/dist/matterbridgeTypes.js.map +0 -1
- package/dist/pluginManager.d.ts.map +0 -1
- package/dist/pluginManager.js.map +0 -1
- package/dist/shelly.d.ts.map +0 -1
- package/dist/shelly.js.map +0 -1
- package/dist/storage/export.d.ts.map +0 -1
- package/dist/storage/export.js.map +0 -1
- package/dist/update.d.ts.map +0 -1
- package/dist/update.js.map +0 -1
- package/dist/utils/colorUtils.d.ts +0 -101
- package/dist/utils/colorUtils.d.ts.map +0 -1
- package/dist/utils/colorUtils.js +0 -282
- package/dist/utils/colorUtils.js.map +0 -1
- package/dist/utils/commandLine.d.ts +0 -66
- package/dist/utils/commandLine.d.ts.map +0 -1
- package/dist/utils/commandLine.js +0 -123
- package/dist/utils/commandLine.js.map +0 -1
- package/dist/utils/copyDirectory.d.ts +0 -35
- package/dist/utils/copyDirectory.d.ts.map +0 -1
- package/dist/utils/copyDirectory.js +0 -76
- package/dist/utils/copyDirectory.js.map +0 -1
- package/dist/utils/createDirectory.d.ts +0 -34
- package/dist/utils/createDirectory.d.ts.map +0 -1
- package/dist/utils/createDirectory.js +0 -54
- package/dist/utils/createDirectory.js.map +0 -1
- package/dist/utils/createZip.d.ts +0 -39
- package/dist/utils/createZip.d.ts.map +0 -1
- package/dist/utils/createZip.js +0 -114
- package/dist/utils/createZip.js.map +0 -1
- package/dist/utils/deepCopy.d.ts +0 -32
- package/dist/utils/deepCopy.d.ts.map +0 -1
- package/dist/utils/deepCopy.js +0 -79
- package/dist/utils/deepCopy.js.map +0 -1
- package/dist/utils/deepEqual.d.ts +0 -54
- package/dist/utils/deepEqual.d.ts.map +0 -1
- package/dist/utils/deepEqual.js +0 -129
- package/dist/utils/deepEqual.js.map +0 -1
- package/dist/utils/error.d.ts +0 -45
- package/dist/utils/error.d.ts.map +0 -1
- package/dist/utils/error.js +0 -54
- package/dist/utils/error.js.map +0 -1
- package/dist/utils/export.d.ts.map +0 -1
- package/dist/utils/export.js.map +0 -1
- package/dist/utils/format.d.ts +0 -53
- package/dist/utils/format.d.ts.map +0 -1
- package/dist/utils/format.js +0 -78
- package/dist/utils/format.js.map +0 -1
- package/dist/utils/hex.d.ts +0 -89
- package/dist/utils/hex.d.ts.map +0 -1
- package/dist/utils/hex.js +0 -242
- package/dist/utils/hex.js.map +0 -1
- package/dist/utils/inspector.d.ts +0 -87
- package/dist/utils/inspector.d.ts.map +0 -1
- package/dist/utils/inspector.js +0 -268
- package/dist/utils/inspector.js.map +0 -1
- package/dist/utils/isValid.d.ts +0 -103
- package/dist/utils/isValid.d.ts.map +0 -1
- package/dist/utils/isValid.js +0 -162
- package/dist/utils/isValid.js.map +0 -1
- package/dist/utils/network.d.ts +0 -141
- package/dist/utils/network.d.ts.map +0 -1
- package/dist/utils/network.js +0 -314
- package/dist/utils/network.js.map +0 -1
- package/dist/utils/spawn.d.ts +0 -33
- package/dist/utils/spawn.d.ts.map +0 -1
- package/dist/utils/spawn.js.map +0 -1
- package/dist/utils/tracker.d.ts +0 -108
- package/dist/utils/tracker.d.ts.map +0 -1
- package/dist/utils/tracker.js +0 -264
- package/dist/utils/tracker.js.map +0 -1
- package/dist/utils/wait.d.ts +0 -54
- package/dist/utils/wait.d.ts.map +0 -1
- package/dist/utils/wait.js +0 -125
- package/dist/utils/wait.js.map +0 -1
- package/dist/workerGlobalPrefix.d.ts.map +0 -1
- package/dist/workerGlobalPrefix.js.map +0 -1
- package/dist/workerTypes.d.ts.map +0 -1
- package/dist/workerTypes.js.map +0 -1
- package/dist/workers.d.ts.map +0 -1
- 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
|
package/dist/utils/hex.js.map
DELETED
|
@@ -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"}
|
package/dist/utils/inspector.js
DELETED
|
@@ -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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"}
|