matterbridge 3.4.7 → 3.5.0-dev-20260113-96c82db

package/dist/utils/network.js

@@ -1,34 +1,5 @@
-/**
- * @description This file contains the network functions.
- * @file network.ts
- * @author Luca Liguori
- * @created 2024-02-17
- * @version 1.0.2
- * @license Apache-2.0
- *
- * Copyright 2024, 2025, 2026 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.
- */
-// Node.js modules
 import os from 'node:os';
-// AnsiLogger module
 import { AnsiLogger, BLUE, CYAN, nf } from 'node-ansi-logger';
-/**
- * Retrieves the first non-internal network interface details.
- *
- * @returns {os.NetworkInterfaceInfo | undefined} The details of the selected network interface, or undefined if not found.
- */
 export function getInterfaceDetails() {
     const result = { interfaceName: '', ipv4Address: undefined, ipv6Address: undefined, macAddress: undefined };
     for (const [interfaceName, interfaceDetails] of Object.entries(os.networkInterfaces())) {
@@ -50,11 +21,6 @@ export function getInterfaceDetails() {
     if (result.interfaceName)
         return result;
 }
-/**
- * Retrieves the first non-internal network interface name.
- *
- * @returns {string | undefined} The name of the selected network interface, or undefined if not found.
- */
 export function getInterfaceName() {
     for (const [interfaceName, interfaceDetails] of Object.entries(os.networkInterfaces())) {
         if (!interfaceName || !interfaceDetails || interfaceDetails.length === 0)
@@ -65,18 +31,6 @@ export function getInterfaceName() {
         }
     }
 }
-/**
- * Retrieves the IPv4 address of the first non-internal network interface.
- *
- * @returns {string | undefined} The IPv4 address of the selected network interface, or undefined if not found.
- *
- * @remarks
- * Type of ipv4 addresses:
- * - 192.168.x.x, 10.x.x.x, 172.16–31.x.x: RFC 1918 = Private networks
- * - 172.16.0.0 → 172.31.255.255: RFC 1918 = Private IP address used inside local networks, VMs, WSL2 and containers
- * - 169.254.0.0 → 169.254.255.255: APIPA = Automatic Private IP Addressing used when a device fails to obtain an IP address via DHCP
- * - 100.64.0.0 → 100.127.255.255: CGNAT = Carrier-Grade NAT RFC 6598 = Shared Address Space
- */
 export function getIpv4InterfaceAddress() {
     for (const [interfaceName, interfaceDetails] of Object.entries(os.networkInterfaces())) {
         if (!interfaceName || !interfaceDetails || interfaceDetails.length === 0)
@@ -87,34 +41,6 @@ export function getIpv4InterfaceAddress() {
         }
     }
 }
-/**
- * Retrieves the IPv6 address of the first non-internal network interface.
- *
- * If `scope` is true, appends a zone id (scope) for link-local addresses when
- * available:
- * - On Windows: uses `%<scopeid>` (e.g. `...%11`)
- * - On other platforms: uses `%<interfaceName>` (e.g. `...%eth0`)
- *
- * @param {boolean} [scope] - Whether to append a zone id when available.
- * @returns {string | undefined} The IPv6 address of the selected network interface, or undefined if not found.
- *
- * @remarks
- * Type of IPv6 addresses (preferred order for Matter)
- *
- * fd00::/8
- *   - IPv6 ULA (Unique Local Address)
- *   - Private IPv6 networks (RFC 4193)
- *   - ✔ PREFERRED
- *
- * 2000::/3
- *   - Global Unicast IPv6
- *   - Publicly routable IPv6
- *   - ⚠ OPTIONAL (advanced setups only)
- *
- * fe80::/10
- *   - IPv6 Link-Local
- *   - Interface-scoped only, non-routable
- */
 export function getIpv6InterfaceAddress(scope = false) {
     for (const [interfaceName, interfaceDetails] of Object.entries(os.networkInterfaces())) {
         if (!interfaceName || !interfaceDetails || interfaceDetails.length === 0)
@@ -124,7 +50,6 @@ export function getIpv6InterfaceAddress(scope = false) {
                 const address = detail.address;
                 if (!scope)
                     return address;
-                // Defensive check: if already has a zone id, keep it. Should never happen from os.networkInterfaces().
                 if (address.includes('%'))
                     return address;
                 const isWindows = os.platform() === 'win32';
@@ -137,11 +62,6 @@ export function getIpv6InterfaceAddress(scope = false) {
         }
     }
 }
-/**
- * Retrieves the mac address of the first non-internal network interface.
- *
- * @returns {string | undefined} The mac address, or undefined if not found.
- */
 export function getMacAddress() {
     for (const [interfaceName, interfaceDetails] of Object.entries(os.networkInterfaces())) {
         if (!interfaceName || !interfaceDetails || interfaceDetails.length === 0)
@@ -152,14 +72,9 @@ export function getMacAddress() {
         }
     }
 }
-/**
- * Logs the available network interfaces and their details.
- *
- * @returns {void}
- */
 export function logInterfaces() {
-    const log = new AnsiLogger({ logName: 'MatterbridgeUtils', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: "info" /* LogLevel.INFO */ });
-    log.logLevel = "info" /* LogLevel.INFO */;
+    const log = new AnsiLogger({ logName: 'MatterbridgeUtils', logTimestampFormat: 4, logLevel: "info" });
+    log.logLevel = "info";
     log.logName = 'LogInterfaces';
     log.info('Available Network Interfaces:');
     const availableAddresses = Object.entries(os.networkInterfaces());
@@ -173,35 +88,16 @@ export function logInterfaces() {
         }
     }
 }
-/**
- * Resolves the given hostname to an IP address.
- *
- * @param {string} hostname - The hostname to resolve.
- * @param {0 | 4 | 6} [family] - The address family to use (0 for any, 4 for IPv4, 6 for IPv6). Default is 4.
- * @returns {Promise<string | null>} - A promise that resolves to the IP address or null if not found.
- *
- * @remarks
- * This function uses DNS lookup to resolve the hostname, which can take some time to complete.
- */
 export async function resolveHostname(hostname, family = 4) {
     const dns = await import('node:dns');
     try {
-        const addresses = await dns.promises.lookup(hostname.toLowerCase() /* + '.local'*/, { family });
+        const addresses = await dns.promises.lookup(hostname.toLowerCase(), { family });
         return addresses.address;
     }
     catch (_error) {
         return null;
     }
 }
-/**
- * Retrieves the version of an npm package from the npm registry.
- *
- * @param {string} packageName - The name of the npm package.
- * @param {string} [tag] - The tag of the package version to retrieve (default is 'latest').
- * @param {number} [timeout] - The timeout duration in milliseconds (default is 10000ms).
- * @returns {Promise<string>} A promise that resolves to the version string of the package.
- * @throws {Error} If the request fails or the tag is not found.
- */
 export async function getNpmPackageVersion(packageName, tag = 'latest', timeout = 10000) {
     const https = await import('node:https');
     return new Promise((resolve, reject) => {
@@ -215,7 +111,7 @@ export async function getNpmPackageVersion(packageName, tag = 'latest', timeout
             let data = '';
             if (res.statusCode !== 200) {
                 clearTimeout(timeoutId);
-                res.resume(); // Discard response data to close the socket properly
+                res.resume();
                 reject(new Error(`Failed to fetch data. Status code: ${res.statusCode}`));
                 return;
             }
@@ -226,7 +122,6 @@ export async function getNpmPackageVersion(packageName, tag = 'latest', timeout
                 clearTimeout(timeoutId);
                 try {
                     const jsonData = JSON.parse(data);
-                    // console.log(`Package ${packageName} tag ${tag}`, jsonData);
                     const version = jsonData['dist-tags']?.[tag];
                     if (version) {
                         resolve(version);
@@ -246,15 +141,6 @@ export async function getNpmPackageVersion(packageName, tag = 'latest', timeout
         });
     });
 }
-/**
- * Retrieves a file from the public directory of the Matterbridge GitHub repository.
- *
- * @param {string} branch - The branch from which to fetch the file.
- * @param {string} file - The file path to fetch.
- * @param {number} [timeout] - The timeout duration in milliseconds (default is 10000ms).
- * @returns {Promise<Record<string, boolean | string | number>>} A promise that resolves to the parsed JSON object from the file.
- * @throws {Error} If the request fails or the JSON parsing fails.
- */
 export async function getGitHubUpdate(branch, file, timeout = 10000) {
     const https = await import('node:https');
     return new Promise((resolve, reject) => {
@@ -268,7 +154,7 @@ export async function getGitHubUpdate(branch, file, timeout = 10000) {
             let data = '';
             if (res.statusCode !== 200) {
                 clearTimeout(timeoutId);
-                res.resume(); // Discard response data to close the socket properly
+                res.resume();
                 reject(new Error(`Failed to fetch data. Status code: ${res.statusCode}`));
                 return;
             }
@@ -286,18 +172,12 @@ export async function getGitHubUpdate(branch, file, timeout = 10000) {
                 }
             });
         });
-        // istanbul ignore next cause it's just a precaution for network errors
         req.on('error', (error) => {
             clearTimeout(timeoutId);
             reject(new Error(`Request failed: ${error instanceof Error ? error.message : error}`));
         });
     });
 }
-/**
- * Retrieves the path to the global Node.js modules directory.
- *
- * @returns {Promise<string>} A promise that resolves to the path of the global Node.js modules directory.
- */
 export async function getGlobalNodeModules() {
     const { exec } = await import('node:child_process');
     return new Promise((resolve, reject) => {
@@ -311,4 +191,3 @@ export async function getGlobalNodeModules() {
         });
     });
 }
-//# sourceMappingURL=network.js.map

package/dist/utils/spawn.d.ts

@@ -1,33 +1 @@
-/**
- * @description This file contains the spawn functions.
- * @file spawn.ts
- * @author Luca Liguori
- * @created 2025-02-16
- * @version 1.2.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.
- */
-/**
- * Spawns a child process with the given command and arguments.
- *
- * @param {string} command - The command to execute.
- * @param {string[]} args - The arguments to pass to the command (default: []).
- * @param {'install' | 'uninstall'} packageCommand - The optional package command being executed (e.g., 'install', 'uninstall').
- * @param {string} [packageName] - The optional name of the package being installed.
- * @returns {Promise<boolean>} A promise that resolves to true if the command executed successfully, false otherwise.
- */
 export declare function spawnCommand(command: string, args: string[], packageCommand?: 'install' | 'uninstall', packageName?: string): Promise<boolean>;
-//# sourceMappingURL=spawn.d.ts.map

package/dist/utils/spawn.js

@@ -1,69 +1,28 @@
-/**
- * @description This file contains the spawn functions.
- * @file spawn.ts
- * @author Luca Liguori
- * @created 2025-02-16
- * @version 1.2.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 { AnsiLogger } from 'node-ansi-logger';
 import { BroadcastServer } from '../broadcastServer.js';
 import { hasParameter } from './commandLine.js';
-/**
- * Spawns a child process with the given command and arguments.
- *
- * @param {string} command - The command to execute.
- * @param {string[]} args - The arguments to pass to the command (default: []).
- * @param {'install' | 'uninstall'} packageCommand - The optional package command being executed (e.g., 'install', 'uninstall').
- * @param {string} [packageName] - The optional name of the package being installed.
- * @returns {Promise<boolean>} A promise that resolves to true if the command executed successfully, false otherwise.
- */
 export async function spawnCommand(command, args, packageCommand, packageName) {
     const { spawn } = await import('node:child_process');
-    /** Broadcast server */
     const debug = hasParameter('debug') || hasParameter('verbose');
     const verbose = hasParameter('verbose');
-    const log = new AnsiLogger({ logName: 'Spawn', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: debug ? "debug" /* LogLevel.DEBUG */ : "info" /* LogLevel.INFO */ });
+    const log = new AnsiLogger({ logName: 'Spawn', logTimestampFormat: 4, logLevel: debug ? "debug" : "info" });
     const server = new BroadcastServer('spawn', log);
     const sendLog = (name, message) => {
         try {
             server.request({ type: 'frontend_logmessage', src: 'spawn', dst: 'frontend', params: { level: 'spawn', time: log.now(), name, message } });
         }
         catch (err) {
-            // istanbul ignore next cause it's a precaution
             log.debug(`Failed to send log message to frontend: ${err instanceof Error ? err.message : String(err)}`);
         }
     };
     if (verbose)
         log.debug(`Spawning command: ${command} with ${args.join(' ')} ${packageCommand} ${packageName}`);
-    /*
-     *  npm > npm.cmd on windows
-     *  cmd.exe ['dir'] on windows
-     */
     const cmdLine = command + ' ' + args.join(' ');
     if (process.platform === 'win32' && command === 'npm') {
-        // Must be spawn('cmd.exe', ['/c', 'npm -g install <package>']);
         const argstring = 'npm ' + args.join(' ');
         args.splice(0, args.length, '/c', argstring);
         command = 'cmd.exe';
     }
-    // Decide when using sudo on linux and macOS
-    // When you need sudo: Spawn stderr: npm error Error: EACCES: permission denied
-    // When you don't need sudo: Failed to start child process "npm install -g matterbridge-eve-door": spawn sudo ENOENT
     if (hasParameter('sudo') || (process.platform !== 'win32' && command === 'npm' && !hasParameter('docker') && !hasParameter('nosudo'))) {
         args.unshift(command);
         command = 'sudo';
@@ -119,20 +78,6 @@ export async function spawnCommand(command, args, packageCommand, packageName) {
                     sendLog('Matterbridge:spawn', line);
                 }
             });
-            /*
-            childProcess.stdout.on('close', () => {
-              log.debug(`Spawn output (stdout): closed`);
-              resolve(true);
-            });
-            childProcess.stdout.on('end', () => {
-              log.debug(`Spawn output (stdout): ended`);
-              resolve(true);
-            });
-            childProcess.stdout.on('error', () => {
-              log.debug(`Spawn output (stdout): error`);
-              resolve(true);
-            });
-            */
         }
         if (childProcess.stderr) {
             childProcess.stderr.on('data', (data) => {
@@ -143,23 +88,8 @@ export async function spawnCommand(command, args, packageCommand, packageName) {
                     sendLog('Matterbridge:spawn', line);
                 }
             });
-            /*
-            childProcess.stderr.on('close', () => {
-              log.debug(`Spawn verbose (stderr): closed`);
-              resolve(true);
-            });
-            childProcess.stderr.on('end', () => {
-              log.debug(`Spawn verbose (stderr): ended`);
-              resolve(true);
-            });
-            childProcess.stderr.on('error', () => {
-              log.debug(`Spawn verbose (stderr): error`);
-              resolve(true);
-            });
-            */
         }
     });
     server.close();
     return success;
 }
-//# sourceMappingURL=spawn.js.map

package/dist/utils/tracker.d.ts

@@ -1,26 +1,3 @@
-/**
- * This file contains the Tracker class.
- *
- * @file tracker.ts
- * @author Luca Liguori
- * @created 2025-10-10
- * @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 EventEmitter from 'node:events';
 export type TrackerSnapshot = {
     timestamp: number;
@@ -44,25 +21,15 @@ export type TrackerSnapshot = {
     peakArrayBuffers: number;
 };
 interface TrackerEvents {
-    /** Start tracking */
     start: [];
-    /** Stop tracking */
     stop: [];
-    /** Uptime event */
     uptime: [os: number, process: number];
-    /** CPU event */
     cpu: [os: number, process: number];
-    /** Memory event */
     memory: [free: number, total: number, rss: number, heapUsed: number, heapTotal: number, external: number, arrayBuffers: number];
-    /** Snapshot event */
     snapshot: [snapshot: TrackerSnapshot];
-    /** Reset peaks */
     reset_peaks: [];
-    /** Reset peaks done event */
     reset_peaks_done: [];
-    /** Run garbage collection */
     gc: [];
-    /** Garbage collection done event */
     gc_done: [type: 'major' | 'minor', execution: 'sync' | 'async'];
 }
 export declare class Tracker extends EventEmitter<TrackerEvents> {
@@ -77,32 +44,9 @@ export declare class Tracker extends EventEmitter<TrackerEvents> {
     private prevCpuUsage;
     private log;
     constructor(name?: string, debug?: boolean, verbose?: boolean);
-    /**
-     * Start tracking cpu and memory usage with a given interval in ms
-     *
-     * @param {number} sampleIntervalMs Sample interval in milliseconds. Default is 10000 (10 seconds).
-     */
     start(sampleIntervalMs?: number): void;
-    /**
-     * Reset peak values to the currently stored values
-     */
     resetPeaks(): void;
-    /**
-     * 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' | 'minor', execution?: 'sync' | 'async'): void;
-    /**
-     * Stop tracking, clear interval, log history
-     */
     stop(): void;
 }
 export {};
-//# sourceMappingURL=tracker.d.ts.map

package/dist/utils/tracker.js

@@ -1,27 +1,3 @@
-/**
- * This file contains the Tracker class.
- *
- * @file tracker.ts
- * @author Luca Liguori
- * @created 2025-10-10
- * @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[32mTracker loaded.\u001B[40;0m');
 import os from 'node:os';
@@ -34,7 +10,6 @@ export class Tracker extends EventEmitter {
     verbose;
     trackerInterval;
     static historyIndex = 0;
-    // History for 8h at 1 sample each 10 seconds = 2880 entries
     static historySize = 2880;
     static history = Array.from({ length: this.historySize }, () => ({
         timestamp: 0,
@@ -71,7 +46,7 @@ export class Tracker extends EventEmitter {
         if (process.argv.includes('--verbose') || process.argv.includes('-verbose')) {
             this.verbose = true;
         }
-        this.log = new AnsiLogger({ logName: name, logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: this.debug ? "debug" /* LogLevel.DEBUG */ : "info" /* LogLevel.INFO */ });
+        this.log = new AnsiLogger({ logName: name, logTimestampFormat: 4, logLevel: this.debug ? "debug" : "info" });
         this.log.logNameColor = YELLOW;
         if (this.verbose) {
             this.log.debug(`os.cpus():\n${RESET}`, os.cpus());
@@ -91,11 +66,6 @@ export class Tracker extends EventEmitter {
             this.runGarbageCollector();
         });
     }
-    /**
-     * Start tracking cpu and memory usage with a given interval in ms
-     *
-     * @param {number} sampleIntervalMs Sample interval in milliseconds. Default is 10000 (10 seconds).
-     */
     start(sampleIntervalMs = 10000) {
         if (this.trackerInterval)
             return;
@@ -104,21 +74,15 @@ export class Tracker extends EventEmitter {
         this.prevCpus = os.cpus();
         this.prevCpuUsage = process.cpuUsage();
         this.trackerInterval = setInterval(() => {
-            // Increment tryGcCount and check if we can run garbage collector each hour cause memory might grow over time because of our even small allocations
             tryGcCount += sampleIntervalMs / 1000;
             if (tryGcCount > 60 * 60) {
                 this.runGarbageCollector();
                 tryGcCount = 0;
             }
-            // Get current history entry in circular buffer
             const entry = Tracker.history[Tracker.historyIndex];
-            // Get previous history entry in circular buffer
             const prevEntry = Tracker.history[(Tracker.historyIndex + Tracker.historySize - 1) % Tracker.historySize];
-            // Set the timestamp
             entry.timestamp = Date.now();
-            // Emit uptime event
             this.emit('uptime', os.uptime(), process.uptime());
-            // Track CPU usage
             const currentCpus = os.cpus();
             const loads = currentCpus.map((cpu, idx) => {
                 const prev = this.prevCpus[idx]?.times;
@@ -130,7 +94,6 @@ export class Tracker extends EventEmitter {
                 const totalDelta = busyDelta + idleDelta;
                 if (totalDelta <= 0)
                     return 0;
-                // istanbul ignore next cause is practically impossible to hit this branch
                 return busyDelta / totalDelta;
             });
             this.prevCpus = currentCpus;
@@ -138,16 +101,13 @@ export class Tracker extends EventEmitter {
             const osCpu = Number((avgLoad * 100).toFixed(2));
             entry.osCpu = osCpu;
             entry.peakOsCpu = Math.max(prevEntry.peakOsCpu, osCpu);
-            // Track process CPU usage
             const diff = process.cpuUsage(this.prevCpuUsage);
             this.prevCpuUsage = process.cpuUsage();
             const totalMs = (diff.user + diff.system) / 1000;
             const processCpu = Number((((totalMs / sampleIntervalMs) * 100) / currentCpus.length).toFixed(2));
             entry.processCpu = processCpu;
             entry.peakProcessCpu = Math.max(prevEntry.peakProcessCpu, processCpu);
-            // Emit cpu event
             this.emit('cpu', entry.osCpu, entry.processCpu);
-            // Track memory usage
             entry.freeMemory = os.freemem();
             entry.peakFreeMemory = Math.max(prevEntry.peakFreeMemory, entry.freeMemory);
             entry.totalMemory = os.totalmem();
@@ -164,9 +124,7 @@ export class Tracker extends EventEmitter {
             entry.arrayBuffers = mem.arrayBuffers;
             entry.peakArrayBuffers = Math.max(prevEntry.peakArrayBuffers, mem.arrayBuffers);
             this.emit('memory', entry.freeMemory, entry.totalMemory, entry.rss, entry.heapUsed, entry.heapTotal, entry.external, entry.arrayBuffers);
-            // Emit tracker event with current snapshot
             this.emit('snapshot', entry);
-            // Debug output
             if (this.debug) {
                 this.log.debug(`Time: ${formatTimeStamp(entry.timestamp)} ` +
                     `os ${CYAN}${BRIGHT}${formatPercent(entry.osCpu)}${RESET}${db} (${entry.peakOsCpu > prevEntry.peakOsCpu ? RED : ''}${formatPercent(entry.peakOsCpu)}${db}) ` +
@@ -177,14 +135,10 @@ export class Tracker extends EventEmitter {
                     `external: ${CYAN}${BRIGHT}${formatBytes(entry.external)}${RESET}${db} (${entry.peakExternal > prevEntry.peakExternal ? RED : ''}${formatBytes(entry.peakExternal)}${db}) ` +
                     `arrayBuffers: ${CYAN}${BRIGHT}${formatBytes(entry.arrayBuffers)}${RESET}${db} (${entry.peakArrayBuffers > prevEntry.peakArrayBuffers ? RED : ''}${formatBytes(entry.peakArrayBuffers)}${db})`);
             }
-            // Move to next history index of circular buffer
             Tracker.historyIndex = (Tracker.historyIndex + 1) % Tracker.historySize;
         }, sampleIntervalMs);
         this.log.debug(`Tracker started`);
     }
-    /**
-     * Reset peak values to the currently stored values
-     */
     resetPeaks() {
         const prevHistoryIndex = (Tracker.historyIndex + Tracker.historySize - 1) % Tracker.historySize;
         Tracker.history[prevHistoryIndex].peakOsCpu = 0;
@@ -198,17 +152,6 @@ export class Tracker extends EventEmitter {
             this.log.debug(`${CYAN}${BRIGHT}Peaks reset at ${new Date(Date.now()).toLocaleString()}.${RESET}${db}`);
         this.emit('reset_peaks_done');
     }
-    /**
-     * 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 {
@@ -229,20 +172,15 @@ export class Tracker extends EventEmitter {
                 this.log.debug(`${CYAN}${BRIGHT}Garbage collection not exposed. Start Node.js with --expose-gc to enable manual garbage collection.${RESET}${db}`);
         }
     }
-    /**
-     * Stop tracking, clear interval, log history
-     */
     stop() {
         this.log.debug(`Tracker stopping...`);
         if (this.trackerInterval) {
             clearInterval(this.trackerInterval);
             this.trackerInterval = undefined;
         }
-        // Log all history entries
         if (this.debug) {
             this.log.debug(`Tracker history for ${YELLOW}${BRIGHT}${this.name}:${RESET}`);
             this.log.debug('Timestamp            Host cpu            Process cpu         Rss                   Heap Used             Heap Total            External              ArrayBuffers');
-            //              10/10/2025, 20:52:12   4.76 % (  4.76 %)   0.16 % (  0.16 %)  38.45 MB ( 38.45 MB)   3.75 MB (  3.75 MB)   5.29 MB (  5.29 MB)   1.66 MB (  1.66 MB)  10.25 KB ( 10.25 KB)
             for (let i = 0; i < Tracker.historySize; i++) {
                 const index = (Tracker.historyIndex + i) % Tracker.historySize;
                 const entry = Tracker.history[index];
@@ -261,4 +199,3 @@ export class Tracker extends EventEmitter {
         this.log.debug(`Tracker stopped`);
     }
 }
-//# sourceMappingURL=tracker.js.map