@matterbridge/utils 3.9.3-dev-20260629-7c47082 → 3.9.3-dev-20260630-9b4b673

package/dist/diagnostic.d.ts

@@ -0,0 +1 @@
+export declare function writeDiagnostic(context: string, message: string): void;

package/dist/diagnostic.js

@@ -0,0 +1,5 @@
+import { logModuleLoaded } from './loader.js';
+logModuleLoaded('Diagnostic');
+export function writeDiagnostic(context, message) {
+    process.stderr.write(`\u001B[37;44m[diagnostic]\u001B[0m ${context}: ${message}\n`);
+}

package/dist/export.d.ts

@@ -1,10 +1,10 @@
-export * from './bunPrefix.js';
 export * from './colorUtils.js';
 export * from './commandLine.js';
 export * from './copyDirectory.js';
 export * from './createDirectory.js';
 export * from './deepCopy.js';
 export * from './deepEqual.js';
+export * from './diagnostic.js';
 export * from './enumDescription.js';
 export * from './error.js';
 export * from './format.js';
@@ -15,6 +15,7 @@ export * from './loader.js';
 export * from './network.js';
 export * from './npmPrefix.js';
 export * from './npmVersion.js';
+export * from './runtimeBun.js';
 export * from './tracker.js';
 export * from './validate.js';
 export * from './wait.js';

package/dist/export.js

@@ -1,10 +1,10 @@
-export * from './bunPrefix.js';
 export * from './colorUtils.js';
 export * from './commandLine.js';
 export * from './copyDirectory.js';
 export * from './createDirectory.js';
 export * from './deepCopy.js';
 export * from './deepEqual.js';
+export * from './diagnostic.js';
 export * from './enumDescription.js';
 export * from './error.js';
 export * from './format.js';
@@ -15,6 +15,7 @@ export * from './loader.js';
 export * from './network.js';
 export * from './npmPrefix.js';
 export * from './npmVersion.js';
+export * from './runtimeBun.js';
 export * from './tracker.js';
 export * from './validate.js';
 export * from './wait.js';

package/dist/npmPrefix.js

@@ -1,5 +1,5 @@
-import { getGlobalBunModules, isBun } from './bunPrefix.js';
 import { logModuleLoaded } from './loader.js';
+import { getGlobalBunModules, isBun } from './runtimeBun.js';
 logModuleLoaded('NpmPrefix');
 export async function getGlobalNodeModules() {
     if (isBun())

package/dist/runtimeBun.d.ts

@@ -0,0 +1,22 @@
+export declare function isBun(): boolean;
+export declare function getBunVersion(): string | undefined;
+export declare function getBunRevision(): string | undefined;
+export declare function getNodeCompatVersion(): string | undefined;
+export declare function getBun(): typeof Bun | undefined;
+export declare function getGlobalBunModules(): string;
+export declare function nanoseconds(): number;
+export declare function sleep(ms: number): Promise<void>;
+export declare function which(command: string): string | null;
+export declare function gc(force?: boolean): void;
+export declare function setGcLevel(level?: 0 | 1 | 2): 0 | 1 | 2 | undefined;
+export interface BunRuntimeInfo {
+    isBun: boolean;
+    version?: string;
+    revision?: string;
+    nodeCompat?: string;
+    execPath: string;
+    main?: string;
+    arch: string;
+    platform: string;
+}
+export declare function getBunRuntimeInfo(): BunRuntimeInfo;

package/dist/runtimeBun.js

@@ -0,0 +1,63 @@
+import os from 'node:os';
+import path from 'node:path';
+import { logModuleLoaded } from './loader.js';
+logModuleLoaded('RuntimeBun');
+const HAS_BUN_GLOBAL = typeof Bun !== 'undefined';
+export function isBun() {
+    return HAS_BUN_GLOBAL || typeof process?.versions?.bun === 'string';
+}
+export function getBunVersion() {
+    if (HAS_BUN_GLOBAL)
+        return Bun.version;
+    return process?.versions?.bun;
+}
+export function getBunRevision() {
+    return HAS_BUN_GLOBAL ? Bun.revision : undefined;
+}
+export function getNodeCompatVersion() {
+    return process?.versions?.node;
+}
+export function getBun() {
+    return HAS_BUN_GLOBAL ? Bun : undefined;
+}
+export function getGlobalBunModules() {
+    if (!isBun()) {
+        throw new Error('getGlobalBunModules can only be called in a Bun environment.');
+    }
+    const bunInstall = process.env.BUN_INSTALL ?? path.join(os.homedir(), '.bun');
+    return path.join(bunInstall, 'install', 'global', 'node_modules');
+}
+export function nanoseconds() {
+    if (HAS_BUN_GLOBAL)
+        return Bun.nanoseconds();
+    return Number(process.hrtime.bigint());
+}
+export async function sleep(ms) {
+    if (HAS_BUN_GLOBAL)
+        return Bun.sleep(ms);
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function which(command) {
+    return HAS_BUN_GLOBAL ? Bun.which(command) : null;
+}
+export function gc(force = true) {
+    if (HAS_BUN_GLOBAL) {
+        Bun.gc(force);
+    }
+}
+export function setGcLevel(level) {
+    return HAS_BUN_GLOBAL ? Bun.unsafe.gcAggressionLevel(level) : undefined;
+}
+export function getBunRuntimeInfo() {
+    const bun = getBun();
+    return {
+        isBun: isBun(),
+        version: getBunVersion(),
+        revision: getBunRevision(),
+        nodeCompat: getNodeCompatVersion(),
+        execPath: process.execPath,
+        main: bun?.main ?? process.argv[1],
+        arch: process.arch,
+        platform: process.platform,
+    };
+}

package/dist/tracker.d.ts

@@ -37,6 +37,7 @@ export declare class Tracker extends EventEmitter<TrackerEvents> {
     private readonly debug;
     private readonly verbose;
     private readonly tracker;
+    private readonly forceGc;
     private trackerInterval?;
     static historyIndex: number;
     static readonly historySize = 2880;
@@ -44,7 +45,7 @@ export declare class Tracker extends EventEmitter<TrackerEvents> {
     private prevCpus;
     private prevCpuUsage;
     private log;
-    constructor(name?: string, debug?: boolean, verbose?: boolean, tracker?: boolean);
+    constructor(name?: string, debug?: boolean, verbose?: boolean, tracker?: boolean, forceGc?: boolean);
     start(sampleIntervalMs?: number): void;
     resetPeaks(): void;
     runGarbageCollector(type?: 'major' | 'minor', execution?: 'sync' | 'async'): void;

package/dist/tracker.js

@@ -1,15 +1,16 @@
 import EventEmitter from 'node:events';
 import os from 'node:os';
 import { AnsiLogger, BRIGHT, CYAN, db, RED, RESET, YELLOW } from 'node-ansi-logger';
-import { hasParameter } from './commandLine.js';
 import { formatBytes, formatPercent, formatTimeStamp } from './format.js';
 import { logModuleLoaded } from './loader.js';
+import { isBun, gc, setGcLevel } from './runtimeBun.js';
 logModuleLoaded('Tracker');
 export class Tracker extends EventEmitter {
     name;
     debug;
     verbose;
     tracker;
+    forceGc;
     trackerInterval;
     static historyIndex = 0;
     static historySize = 2880;
@@ -37,12 +38,13 @@ export class Tracker extends EventEmitter {
     prevCpus = os.cpus();
     prevCpuUsage = process.cpuUsage();
     log;
-    constructor(name = 'Tracker', debug = false, verbose = false, tracker = false) {
+    constructor(name = 'Tracker', debug = false, verbose = false, tracker = false, forceGc = false) {
         super();
         this.name = name;
         this.debug = debug;
         this.verbose = verbose;
         this.tracker = tracker;
+        this.forceGc = forceGc;
         if (process.argv.includes('--debug') || process.argv.includes('--verbose') || process.argv.includes('--tracker')) {
             this.debug = true;
         }
@@ -52,6 +54,9 @@ export class Tracker extends EventEmitter {
         if (process.argv.includes('--tracker')) {
             this.tracker = true;
         }
+        if (process.argv.includes('--force-gc')) {
+            this.forceGc = true;
+        }
         this.log = new AnsiLogger({ logName: name, logTimestampFormat: 4, logLevel: this.debug || this.tracker ? "debug" : "info" });
         this.log.logNameColor = YELLOW;
         if (this.verbose) {
@@ -81,7 +86,7 @@ export class Tracker extends EventEmitter {
         this.prevCpuUsage = process.cpuUsage();
         this.trackerInterval = setInterval(() => {
             tryGcCount += sampleIntervalMs / 1000;
-            if (tryGcCount > 60 * 60 || hasParameter('force-gc')) {
+            if (tryGcCount > 60 * 60 || this.forceGc) {
                 this.runGarbageCollector();
                 tryGcCount = 0;
             }
@@ -131,7 +136,7 @@ export class Tracker extends EventEmitter {
             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);
             this.emit('snapshot', entry);
-            if (this.debug || this.tracker) {
+            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}) ` +
                     `process ${CYAN}${BRIGHT}${formatPercent(entry.processCpu)}${RESET}${db} (${entry.peakProcessCpu > prevEntry.peakProcessCpu ? RED : ''}${formatPercent(entry.peakProcessCpu)}${db}) ` +
@@ -159,7 +164,8 @@ export class Tracker extends EventEmitter {
         this.emit('reset_peaks_done');
     }
     runGarbageCollector(type = 'major', execution = 'async') {
-        if (global.gc && typeof global.gc === 'function') {
+        const bun = isBun();
+        if (!bun && global.gc && typeof global.gc === 'function') {
             try {
                 global.gc({ type, execution });
                 if (this.debug)
@@ -173,6 +179,19 @@ export class Tracker extends EventEmitter {
                 this.emit('gc_done', 'minor', 'async');
             }
         }
+        else if (bun && typeof gc === 'function' && typeof setGcLevel === 'function') {
+            try {
+                setGcLevel(2);
+                gc(execution === 'sync');
+                if (this.debug)
+                    this.log.debug(`${CYAN}${BRIGHT}Bun garbage collection triggered at ${new Date(Date.now()).toLocaleString()}.${RESET}${db}`);
+                this.emit('gc_done', type, execution);
+            }
+            catch {
+                if (this.debug)
+                    this.log.debug(`${CYAN}${BRIGHT}Bun garbage collection failed triggered at ${new Date(Date.now()).toLocaleString()}.${RESET}${db}`);
+            }
+        }
         else {
             if (this.debug)
                 this.log.debug(`${CYAN}${BRIGHT}Garbage collection not exposed. Start Node.js with --expose-gc to enable manual garbage collection.${RESET}${db}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/utils",
-  "version": "3.9.3-dev-20260629-7c47082",
+  "version": "3.9.3-dev-20260630-9b4b673",
   "description": "Matterbridge utils library",
   "author": "https://github.com/Luligu",
   "homepage": "https://matterbridge.io/",
@@ -51,8 +51,8 @@
       "import": "./dist/export.js"
     },
     "./bun": {
-      "types": "./dist/bunPrefix.d.ts",
-      "import": "./dist/bunPrefix.js"
+      "types": "./dist/runtimeBun.d.ts",
+      "import": "./dist/runtimeBun.js"
     },
     "./cli": {
       "types": "./dist/commandLine.d.ts",
@@ -70,6 +70,10 @@
       "types": "./dist/error.d.ts",
       "import": "./dist/error.js"
     },
+    "./diagnostic": {
+      "types": "./dist/diagnostic.d.ts",
+      "import": "./dist/diagnostic.js"
+    },
     "./inspector": {
       "types": "./dist/inspector.d.ts",
       "import": "./dist/inspector.js"

package/dist/bunPrefix.d.ts

@@ -1,2 +0,0 @@
-export declare function isBun(): boolean;
-export declare function getGlobalBunModules(): string;

package/dist/bunPrefix.js

@@ -1,14 +0,0 @@
-import os from 'node:os';
-import path from 'node:path';
-import { logModuleLoaded } from './loader.js';
-logModuleLoaded('BunPrefix');
-export function isBun() {
-    return typeof process !== 'undefined' && process.versions?.bun !== undefined;
-}
-export function getGlobalBunModules() {
-    if (!isBun()) {
-        throw new Error('getGlobalBunModules can only be called in a Bun environment.');
-    }
-    const bunInstall = process.env.BUN_INSTALL ?? path.join(os.homedir(), '.bun');
-    return path.join(bunInstall, 'install', 'global', 'node_modules');
-}