matterbridge 3.4.2 → 3.4.3-dev-20251207-3ce5a0e

package/dist/utils/deepEqual.js

@@ -1,89 +1,23 @@
-/* eslint-disable @typescript-eslint/no-unused-vars */
-/**
- * This file contains the deepEqual function.
- *
- * @file deepEqual.ts
- * @author Luca Liguori
- * @created 2025-02-16
- * @version 1.0.0
- * @license Apache-2.0
- *
- * Copyright 2025, 2026, 2027 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/* eslint-disable @typescript-eslint/no-explicit-any */
-/**
- * Performs a deep comparison between two values to determine if they are equivalent.
- * This comparison includes primitive types, arrays, and objects, allowing for optional
- * exclusion of specific properties from the comparison in objects.
- *
- * @param {any} a The first value to compare.
- * @param {any} b The second value to compare.
- * @param {string[]} [excludeProperties] An array of property names to exclude from the comparison in objects.
- * @returns {boolean} True if the values are deeply equal, excluding any specified properties; otherwise, false.
- *
- * Note: This function utilizes recursion for deep comparison of nested structures and includes a debugging
- * mechanism that can be toggled on or off for detailed comparison logging. It is important to ensure that
- * objects do not contain circular references when enabling debug logging to avoid infinite loops.
- *
- * Example usage:
- * ```
- * const obj1 = { a: 1, b: { c: 2 } };
- * const obj2 = { a: 1, b: { c: 2 } };
- * console.log(deepEqual(obj1, obj2)); // true
- *
- * const arr1 = [1, 2, [3, 4]];
- * const arr2 = [1, 2, [3, 4]];
- * console.log(deepEqual(arr1, arr2)); // true
- *
- * const obj3 = { a: 1, b: { c: 2, d: 3 } };
- * const obj4 = { a: 1, b: { c: 2 } };
- * console.log(deepEqual(obj3, obj4, ['d'])); // true, excluding property 'd' from comparison
- * ```
- */
 export function deepEqual(a, b, excludeProperties = []) {
-    // Toggle debugging on or off easily
-    // const debug = false;
-    // Helper function for conditional logging
     const debugLog = (...messages) => {
-        // if (debug) {
-        // console.log(...messages);
-        // }
     };
-    // If both are the same instance, return true (handles primitives and same object references)
     if (a === b) {
         return true;
     }
-    // If types are different, return false
     if (typeof a !== typeof b) {
         debugLog(`deepEqual false for typeof a: ${typeof a} typeof b: ${typeof b}`);
         return false;
     }
-    // If one of them is null (and we know they are not equal from the first check), return false
     if (a == null || b == null) {
         debugLog('deepEqual false for == null');
         return false;
     }
-    // Handle Dates compare by timestamp
     if (a instanceof Date && b instanceof Date) {
         return a.getTime() === b.getTime();
     }
-    // Handle Regexps compare by their source & flags
     if (a instanceof RegExp && b instanceof RegExp) {
         return a.source === b.source && a.flags === b.flags;
     }
-    // Handle Arrays
     if (Array.isArray(a) && Array.isArray(b)) {
         if (a.length !== b.length) {
             debugLog(`deepEqual false for array a.length(${a.length}) !== b.length(${b.length})`);
@@ -99,31 +33,26 @@ export function deepEqual(a, b, excludeProperties = []) {
         }
         return true;
     }
-    // Handle Objects (and exclude null, functions, and arrays)
     if (typeof a === 'object' && typeof b === 'object') {
         const aProps = Object.getOwnPropertyNames(a).filter((prop) => !excludeProperties.includes(prop));
         const bProps = Object.getOwnPropertyNames(b).filter((prop) => !excludeProperties.includes(prop));
-        // If their property lengths are different, they're different objects
         if (aProps.length !== bProps.length) {
             debugLog(`deepEqual false for aProps.length(${aProps.length}) !== bProps.length(${bProps.length})`);
             debugLog(`- aProps.length(${aProps.length}):`, aProps);
             debugLog(`- bProps.length(${bProps.length}):`, bProps);
             return false;
         }
-        // Check each property in 'a' to see if it's in 'b' and if it's equal (deep check)
         for (const prop of aProps) {
             if (!Object.prototype.hasOwnProperty.call(b, prop)) {
                 debugLog(`deepEqual false for !b.hasOwnProperty(${prop})`);
                 return false;
             }
             if (!deepEqual(a[prop], b[prop], excludeProperties)) {
-                debugLog(`deepEqual false for !deepEqual(a[${prop}], b[${prop}])` /* , a[prop], b[prop]*/);
+                debugLog(`deepEqual false for !deepEqual(a[${prop}], b[${prop}])`);
                 return false;
             }
         }
         return true;
     }
-    // If none of the above, the objects are not equal
     return false;
 }
-//# sourceMappingURL=deepEqual.js.map

package/dist/utils/error.js

@@ -1,49 +1,8 @@
-/**
- * This file contains the error functions.
- *
- * @file error.ts
- * @author Luca Liguori
- * @created 2025-07-17
- * @version 1.0.0
- * @license Apache-2.0
- *
- * Copyright 2025, 2026, 2027 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
 import { inspect } from 'node:util';
 import { RESET } from 'node-ansi-logger';
-/**
- * Logs an error message using the provided AnsiLogger instance.
- *
- * @param {AnsiLogger} log - The AnsiLogger instance to use for logging.
- * @param {string} message - The error message to log.
- * @param {unknown} error - The error object or value to log. If it's an Error instance,
- *                          its message and stack trace will be included in the log.
- */
 export function logError(log, message, error) {
     log.error(`${message}: ${error instanceof Error ? error.message + ' \nStack: \n' + error.stack : error}`);
 }
-/**
- * Logs an error message using the provided AnsiLogger instance with detailed inspection.
- * Uses util.inspect to get a detailed view of the error with a stack depth of 10 levels.
- * If the error is an Error instance, it also includes the error message.
- *
- * @param {AnsiLogger} log - The AnsiLogger instance to use for logging.
- * @param {string} message - The error message to log.
- * @param {unknown} error - The error object or value to log. Will be inspected with depth 10.
- * @returns {string} - The full logged message.
- */
 export function inspectError(log, message, error) {
     const errorMessage = error instanceof Error ? `${error.message} \n` : '';
     const inspectedError = inspect(error, { depth: 10, colors: true, showHidden: false });
@@ -51,4 +10,3 @@ export function inspectError(log, message, error) {
     log.error(fullMessage);
     return fullMessage;
 }
-//# sourceMappingURL=error.js.map

package/dist/utils/export.js

@@ -10,4 +10,3 @@ export * from './createZip.js';
 export * from './wait.js';
 export * from './hex.js';
 export * from './error.js';
-//# sourceMappingURL=export.js.map

package/dist/utils/format.js

@@ -1,51 +1,9 @@
-/**
- * @description This file contains the format functions.
- * @file format.ts
- * @author Luca Liguori
- * @created 2025-10-20
- * @version 1.0.0
- * @license Apache-2.0
- *
- * Copyright 2025, 2026, 2027 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/**
- * Format a timestamp into a human-readable string.
- *
- * @param {number} timestamp - The timestamp in milliseconds since the Unix epoch.
- * @returns {string} - The formatted timestamp.
- */
 export function formatTimeStamp(timestamp) {
     return `${new Date(timestamp).toLocaleString()}`;
 }
-/**
- * Format a percentage into a human-readable string.
- *
- * @param {number} percent - The percentage value.
- * @param {number} digits - The number of decimal places.
- * @returns {string} - The formatted percentage.
- */
 export function formatPercent(percent, digits = 2) {
     return `${percent.toFixed(digits)} %`;
 }
-/**
- * Format bytes into a human-readable string.
- *
- * @param {number} bytes - The number of bytes.
- * @param {number} digits - The number of decimal places.
- * @returns {string} - The formatted byte string.
- */
 export function formatBytes(bytes, digits = 2) {
     if (bytes === 0)
         return `${bytes.toFixed(digits)} B`;
@@ -54,12 +12,6 @@ export function formatBytes(bytes, digits = 2) {
     const value = bytes / Math.pow(1024, idx);
     return `${value.toFixed(digits)} ${units[idx]}`;
 }
-/**
- * Function to format system uptime with only the most significant unit
- *
- * @param {number} seconds - The number of seconds to format
- * @returns {string} The formatted uptime string
- */
 export function formatUptime(seconds) {
     if (seconds >= 86400) {
         const days = Math.floor(seconds / 86400);
@@ -75,4 +27,3 @@ export function formatUptime(seconds) {
     }
     return `${seconds} second${seconds !== 1 ? 's' : ''}`;
 }
-//# sourceMappingURL=format.js.map

package/dist/utils/hex.js

@@ -1,114 +1,39 @@
-/**
- * This file contains the hex functions.
- *
- * @file hex.ts
- * @author Luca Liguori
- * @created 2025-05-06
- * @version 1.0.0
- * @license Apache-2.0
- *
- * Copyright 2025, 2026, 2027 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
 import { createPublicKey, createPrivateKey, X509Certificate } from 'node:crypto';
-/**
- * Converts an ArrayBuffer or Uint8Array to a hexadecimal string.
- *
- * Accepts any {ArrayBufferLike} input: a raw ArrayBuffer (binary data storage) or
- * a Uint8Array (TypedArray view over an ArrayBuffer). While an ArrayBuffer holds
- * the raw memory, a Uint8Array is a typed view into that memory, letting you access
- * its bytes directly. This function normalizes both by creating a Uint8Array view
- * before conversion.
- *
- * @param {ArrayBufferLike} buffer - The buffer or typed-array view to convert.
- * @returns {string} A lowercase hex string representation of the buffer's bytes.
- *
- * @throws {TypeError} If the input is not an ArrayBuffer or ArrayBufferView.
- */
 export function bufferToHex(buffer) {
-    // Check if the input is an ArrayBuffer or ArrayBufferView
     if (!(buffer instanceof ArrayBuffer || ArrayBuffer.isView(buffer))) {
         throw new TypeError('Expected input to be an ArrayBuffer or ArrayBufferView');
     }
-    // Create a Uint8Array view over the buffer
     const bytes = buffer instanceof Uint8Array ? buffer : new Uint8Array(buffer);
-    // Convert each byte to 2-digit hex
     return Array.from(bytes)
         .map((byte) => byte.toString(16).padStart(2, '0'))
         .join('');
 }
-/**
- * Converts a hexadecimal string to a Uint8Array.
- *
- * @param {string} hex - The hex string to convert. Can include uppercase or lowercase characters.
- * @returns {Uint8Array} A Uint8Array representing the corresponding binary data.
- *
- * @throws {TypeError} If the input is not a string.
- * @throws {Error} If the input length is odd or contains non-hex characters.
- */
 export function hexToBuffer(hex) {
-    // Ensure the input is a string
     if (typeof hex !== 'string') {
         throw new TypeError('Expected a string for hex input');
     }
-    // Trim any whitespace from the input string
     const cleaned = hex.trim();
-    // Check if the length of the hex string is even
     if (cleaned.length % 2 !== 0) {
         throw new Error('Invalid hex string length, must be even');
     }
-    // Validate that the string contains only valid hex characters
     if (!/^[0-9a-fA-F]*$/.test(cleaned)) {
         throw new Error('Invalid hex string, contains non-hex characters');
     }
-    // Calculate the length of the resulting Uint8Array
     const length = cleaned.length / 2;
-    // Create a Uint8Array to hold the binary data
     const result = new Uint8Array(length);
-    // Convert each pair of hex characters into a byte
     for (let i = 0; i < length; i++) {
         result[i] = parseInt(cleaned.substr(i * 2, 2), 16);
     }
-    // Return the resulting Uint8Array
     return result;
 }
-/**
- * Converts a PEM (Privacy-Enhanced Mail) formatted string to a Uint8Array.
- *
- * PEM format is a base64-encoded format commonly used for cryptographic keys and certificates,
- * wrapped with header and footer lines like "-----BEGIN CERTIFICATE-----" and "-----END CERTIFICATE-----".
- * This function extracts the base64 content and converts it to binary data using Node.js Buffer API.
- *
- * @param {string} pem - The PEM formatted string to convert.
- * @param {boolean} validate - Whether to validate the PEM content using Node.js crypto module. Default is false.
- * @returns {Uint8Array} A Uint8Array representing the decoded binary data.
- *
- * @throws {TypeError} If the input is not a string.
- * @throws {Error} If the PEM format is invalid, contains invalid base64 characters, or validation fails.
- */
 export function pemToBuffer(pem, validate = false) {
-    // Ensure the input is a string
     if (typeof pem !== 'string') {
         throw new TypeError('Expected a string for PEM input');
     }
-    // Trim whitespace from the input
     const cleaned = pem.trim();
-    // Check if the string appears to be in PEM format
     if (!cleaned.includes('-----BEGIN') || !cleaned.includes('-----END')) {
         throw new Error('Invalid PEM format: missing BEGIN/END markers');
     }
-    // Extract the base64 content between the header and footer
     const lines = cleaned.split('\n');
     const base64Lines = [];
     let inContent = false;
@@ -129,114 +54,65 @@ export function pemToBuffer(pem, validate = false) {
     if (base64Lines.length === 0) {
         throw new Error('Invalid PEM format: no content found between BEGIN/END markers');
     }
-    // Join all base64 lines together
     const base64String = base64Lines.join('');
-    // Validate base64 string format
     if (!/^[A-Za-z0-9+/]*={0,2}$/.test(base64String)) {
         throw new Error('Invalid PEM format: contains invalid base64 characters');
     }
     try {
-        // Use Node.js Buffer API instead of legacy atob()
         const buffer = Buffer.from(base64String, 'base64');
-        // Convert Buffer to Uint8Array
         const result = new Uint8Array(buffer);
-        // Validate PEM content using Node.js crypto module if requested
         if (validate) {
             try {
-                // Determine PEM type from the header and validate accordingly
                 const pemType = cleaned.match(/-----BEGIN\s+([^-]+)-----/)?.[1]?.trim();
                 if (pemType?.includes('CERTIFICATE')) {
-                    // Use X509Certificate for robust certificate validation
                     const cert = new X509Certificate(pem);
-                    // Check validity period
                     if (cert.validFrom && cert.validTo) {
                         const now = Date.now();
                         const from = Date.parse(cert.validFrom);
                         const to = Date.parse(cert.validTo);
-                        // istanbul ignore next if
                         if (now < from || now > to) {
                             throw new Error('Certificate is not currently valid');
                         }
                     }
-                    // Check subject/issuer fields
-                    // istanbul ignore next if
                     if (!cert.subject || !cert.issuer) {
                         throw new Error('Certificate missing subject or issuer');
                     }
-                    // Optionally check signature (not possible without CA chain)
                 }
                 else if (pemType?.includes('PRIVATE KEY')) {
-                    // For private keys, try to create a private key
                     createPrivateKey({ key: pem, format: 'pem' });
                 }
                 else if (pemType?.includes('PUBLIC KEY')) {
-                    // For public keys, try to create a public key
                     createPublicKey({ key: pem, format: 'pem' });
                 }
-                // If no specific type is detected, skip validation
             }
             catch (validationError) {
-                // istanbul ignore next
                 throw new Error(`PEM validation failed: ${validationError instanceof Error ? validationError.message : String(validationError)}`);
             }
         }
         return result;
     }
     catch (error) {
-        // istanbul ignore next
         throw new Error(`Failed to decode base64 content: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
-/**
- * Extracts the raw 32-byte private key scalar from an EC private key PEM.
- *
- * This function parses an EC private key in PEM format and extracts the raw
- * 32-byte private scalar (the "d" value) used in elliptic curve cryptography.
- * This is the actual secret key material.
- *
- * @param {string} pemPrivateKey - The EC private key in PEM format
- * @returns {Uint8Array} The raw 32-byte private key scalar
- * @throws {Error} If the input is not a valid EC private key PEM
- *
- * @example
- * ```typescript
- * const pemKey = `-----BEGIN EC PRIVATE KEY-----
- * MHcCAQEEIFBxqFkUxMoN2JkUXLFeiZnLNUpftjLi0sKMbZ6uajHXoAoGCCqGSM49
- * AwEHoUQDQgAEcJ3eH/rG3zf9WmqMjh5eBSkeXz3Cb4Fig1rTosfHmgyjx/WnLPEe
- * BF4SHvLo0G2COJEHa/VDE5EiKWO9ZR6AOQ==
- * -----END EC PRIVATE KEY-----`;
- *
- * const rawKey = extractPrivateKeyRaw(pemKey);
- * console.log(rawKey.length); // 32
- * console.log(bufferToHex(rawKey)); // hex representation of the private scalar
- * ```
- */
 export function extractPrivateKeyRaw(pemPrivateKey) {
     if (typeof pemPrivateKey !== 'string') {
         throw new TypeError('Expected a string for PEM private key input');
     }
-    // Extract the private key block
     const keyBlock = /-----BEGIN (?:EC )?PRIVATE KEY-----[^-]+-----END (?:EC )?PRIVATE KEY-----/s.exec(pemPrivateKey);
     if (!keyBlock) {
         throw new Error('No EC PRIVATE KEY block found in the supplied PEM');
     }
     try {
-        // Create a private key object
         const privateKey = createPrivateKey(keyBlock[0]);
-        // Export as PKCS#8 DER format
         const pkcs8Der = privateKey.export({ format: 'der', type: 'pkcs8' });
-        // For P-256 curves, the private scalar is the last 32 bytes of the PKCS#8 DER
-        // istanbul ignore next
         if (pkcs8Der.length < 32) {
             throw new Error('Invalid private key: DER data too short');
         }
-        // Extract the last 32 bytes which contain the raw private scalar
         const rawPrivateKey = pkcs8Der.subarray(pkcs8Der.length - 32);
         return new Uint8Array(rawPrivateKey);
     }
     catch (error) {
-        // istanbul ignore next
         throw new Error(`Failed to extract private key: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
-//# sourceMappingURL=hex.js.map

package/dist/utils/inspector.js

@@ -1,27 +1,3 @@
-/**
- * This file contains the Inspector class.
- *
- * @file inspector.ts
- * @author Luca Liguori
- * @created 2025-10-12
- * @version 1.0.0
- * @license Apache-2.0
- *
- * Copyright 2025, 2026, 2027 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/* eslint-disable no-console */
 if (process.argv.includes('--loader') || process.argv.includes('-loader'))
     console.log('\u001B[32mInspector loaded.\u001B[40;0m');
 import EventEmitter from 'node:events';
@@ -45,7 +21,7 @@ export class Inspector extends EventEmitter {
         if (process.argv.includes('--verbose') || process.argv.includes('-verbose')) {
             this.verbose = true;
         }
-        this.log = new AnsiLogger({ logName: this.name, logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: this.debug ? "debug" /* LogLevel.DEBUG */ : "info" /* LogLevel.INFO */ });
+        this.log = new AnsiLogger({ logName: this.name, logTimestampFormat: 4, logLevel: this.debug ? "debug" : "info" });
         this.log.logNameColor = YELLOW;
         this.on('start', () => {
             this.start();
@@ -60,15 +36,6 @@ export class Inspector extends EventEmitter {
             this.runGarbageCollector();
         });
     }
-    /**
-     * Starts the inspector for heap sampling.
-     *
-     * This function is called when the -inspect parameter is passed to matterbridge.
-     *
-     * The -snapshotinterval parameter can be used to set the heap snapshot interval. Default is undefined. Minimum is 30000 ms.
-     * The snapshot is saved in the heap_profiles directory that is created in the current working directory.
-     * The snapshot can be analyzed using vscode or Chrome DevTools or other tools that support heap snapshots.
-     */
     async start() {
         if (this.session) {
             this.log.warn('Inspector session already active.');
@@ -77,9 +44,7 @@ export class Inspector extends EventEmitter {
         const { Session } = await import('node:inspector');
         const { mkdirSync } = await import('node:fs');
         this.log.debug(`Starting heap sampling...`);
-        // Create the heap profiles directory if it doesn't exist
         mkdirSync('heap_profiles', { recursive: true });
-        // Create the heap snapshots directory if it doesn't exist
         mkdirSync('heap_snapshots', { recursive: true });
         try {
             this.session = new Session();
@@ -88,7 +53,6 @@ export class Inspector extends EventEmitter {
                 this.session?.post('HeapProfiler.startSampling', (err) => (err ? reject(err) : resolve()));
             });
             this.log.debug(`Started heap sampling`);
-            // Set an interval to take heap snapshots
             const { getIntParameter } = await import('./commandLine.js');
             const interval = getIntParameter('snapshotinterval');
             if (interval && interval >= 30000) {
@@ -117,10 +81,6 @@ export class Inspector extends EventEmitter {
             return;
         }
     }
-    /**
-     * Stops the heap sampling and saves the profile to a file in the heap_profiles directory.
-     * This function is called when the inspector is stopped.
-     */
     async stop() {
         if (!this.session) {
             this.log.warn('No active inspector session.');
@@ -131,9 +91,7 @@ export class Inspector extends EventEmitter {
         this.log.debug(`Stopping heap sampling...`);
         if (this.snapshotInterval) {
             this.log.debug(`Clearing heap snapshot interval...`);
-            // Clear the snapshot interval if it exists
             clearInterval(this.snapshotInterval);
-            // Take a final heap snapshot before stopping
             await this.takeHeapSnapshot();
         }
         try {
@@ -155,15 +113,6 @@ export class Inspector extends EventEmitter {
             this.log.debug(`Stopped heap sampling`);
         }
     }
-    /**
-     * Takes a heap snapshot and saves it to the file name 'heap_snapshots/<timestamp>.heapsnapshot'.
-     * If triggers a full garbage collection before and after taking the snapshot to reduce noise.
-     *
-     * This function is called periodically based on the -snapshotinterval parameter.
-     * The -snapshotinterval parameter must at least 30000 ms.
-     * The snapshot is saved in the heap_snapshots directory that is created in the current working directory.
-     * The snapshot can be analyzed using vscode or Chrome DevTools or other tools that support heap snapshots.
-     */
     async takeHeapSnapshot() {
         if (!this.session) {
             this.log.warn('No active inspector session.');
@@ -179,7 +128,6 @@ export class Inspector extends EventEmitter {
         const path = await import('node:path');
         const safeTimestamp = new Date().toISOString().replace(/[<>:"/\\|?*]/g, '-');
         const filename = path.join('heap_snapshots', `${safeTimestamp}.heapsnapshot`);
-        // Trigger a garbage collection before taking the snapshot to reduce noise
         this.runGarbageCollector('minor', 'async');
         this.runGarbageCollector('major', 'async');
         if (this.debug)
@@ -192,16 +140,13 @@ export class Inspector extends EventEmitter {
         };
         stream.once('error', onStreamError);
         const chunksListener = (notification) => {
-            // notification.params.chunk is a string; write directly to the stream
             if (!stream.write(notification.params.chunk)) {
-                // If backpressure engages, it's fine; the stream will buffer internally. We don't block the inspector.
             }
         };
         this.session.on('HeapProfiler.addHeapSnapshotChunk', chunksListener);
         try {
             await new Promise((resolve) => {
                 this.session?.post('HeapProfiler.takeHeapSnapshot', (err) => {
-                    // Detach chunk listener and close the stream, then perform post-actions
                     this.session?.off('HeapProfiler.addHeapSnapshotChunk', chunksListener);
                     const finalize = () => {
                         if (!err && !streamErrored) {
@@ -218,7 +163,6 @@ export class Inspector extends EventEmitter {
                         }
                         resolve();
                     };
-                    // End stream and wait for finish or error
                     try {
                         stream.end(() => finalize());
                     }
@@ -233,17 +177,6 @@ export class Inspector extends EventEmitter {
             this.snapshotInProgress = false;
         }
     }
-    /**
-     * Manually trigger garbage collection to free memory (if exposed with --expose-gc)
-     *
-     * @param {'major' | 'minor'} type - The type of garbage collection to perform ('major' or 'minor'). Default is 'major'.
-     * @param {'sync' | 'async'} execution - The execution mode of garbage collection ('sync' or 'async'). Default is 'async'.
-     *
-     * @remarks
-     * - major collection refers to old-generation mark-sweep/mark-compact cycles.
-     * - minor collection refers to young-generation collections (scavenges).
-     * - sync execution blocks the main thread until GC is complete, which can cause pauses.
-     */
     runGarbageCollector(type = 'major', execution = 'async') {
         if (global.gc && typeof global.gc === 'function') {
             try {
@@ -265,4 +198,3 @@ export class Inspector extends EventEmitter {
         }
     }
 }
-//# sourceMappingURL=inspector.js.map