matterbridge 3.4.6 → 3.4.7-dev-20260103-3152357

package/dist/utils/wait.js

@@ -1,41 +1,6 @@
-/**
- * This file contains the wait, waiter and withTimeout functions.
- *
- * @file wait.ts
- * @author Luca Liguori
- * @created 2025-02-16
- * @version 1.0.2
- * @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.
- */
-// AnsiLogger module
 import { AnsiLogger } from 'node-ansi-logger';
-/**
- * Asynchronous waiter function that resolves when the provided condition is met or rejects on timeout.
- *
- * @param {string} name - The name of the waiter.
- * @param {() => boolean} check - A function that checks the condition. Should return a boolean.
- * @param {boolean} [exitWithReject] - Optional. If true, the promise will be rejected on timeout. Default is false.
- * @param {number} [resolveTimeout] - Optional. The timeout duration in milliseconds. Default is 5000ms.
- * @param {number} [resolveInterval] - Optional. The interval duration in milliseconds between condition checks. Default is 500ms.
- * @param {boolean} [debug] - Optional. If true, debug messages will be logged to the console. Default is false.
- * @returns {Promise<boolean>} A promise that resolves to true when the condition is met, or false if the timeout occurs.
- */
 export async function waiter(name, check, exitWithReject = false, resolveTimeout = 5000, resolveInterval = 500, debug = false) {
-    const log = new AnsiLogger({ logName: 'Waiter', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: "debug" /* LogLevel.DEBUG */ });
+    const log = new AnsiLogger({ logName: 'Waiter', logTimestampFormat: 4, logLevel: "debug" });
     if (check()) {
         if (debug)
             log.debug(`Waiter "${name}" already true`);
@@ -66,16 +31,8 @@ export async function waiter(name, check, exitWithReject = false, resolveTimeout
         }, resolveInterval).unref();
     });
 }
-/**
- * Asynchronously waits for a specified amount of time.
- *
- * @param {number} timeout - The duration to wait in milliseconds. Default is 1000ms.
- * @param {string} name - The name of the wait operation. Default is undefined.
- * @param {boolean} debug - Whether to enable debug logging. Default is false.
- * @returns {Promise<void>} A Promise that resolves after the specified timeout.
- */
 export async function wait(timeout = 1000, name, debug = false) {
-    const log = new AnsiLogger({ logName: 'Wait', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: "debug" /* LogLevel.DEBUG */ });
+    const log = new AnsiLogger({ logName: 'Wait', logTimestampFormat: 4, logLevel: "debug" });
     if (debug)
         log.debug(`Wait "${name}" started...`);
     return new Promise((resolve) => {
@@ -87,14 +44,6 @@ export async function wait(timeout = 1000, name, debug = false) {
         }, timeout).unref();
     });
 }
-/**
- * Wraps a promise with a timeout. If the promise does not resolve or reject within the specified time, it will be rejected.
- *
- * @param {Promise<T>} promise - The promise to wrap.
- * @param {number} [timeoutMillisecs] - The timeout duration in milliseconds. Default is 10000ms.
- * @param {boolean} [reThrow] - Optional. If true, the promise will rethrow the original promise and will reject on timeout. Default is true.
- * @returns {Promise<T>} A new promise that resolves or rejects based on the original promise and the timeout.
- */
 export function withTimeout(promise, timeoutMillisecs = 10000, reThrow = true) {
     return new Promise((resolve, reject) => {
         const timer = setTimeout(() => {
@@ -102,24 +51,23 @@ export function withTimeout(promise, timeoutMillisecs = 10000, reThrow = true) {
                 reject(new Error('Operation timed out'));
             }
             else {
-                resolve(undefined); // Resolve with undefined if reThrow is false
+                resolve(undefined);
             }
-        }, timeoutMillisecs).unref(); // Unref the timer to prevent it from keeping the event loop alive
+        }, timeoutMillisecs).unref();
         promise
             .then((result) => {
-            clearTimeout(timer); // Ensure timeout does not fire if promise resolves first
+            clearTimeout(timer);
             resolve(result);
             return result;
         })
             .catch((error) => {
-            clearTimeout(timer); // Ensure timeout does not fire if promise rejects first
+            clearTimeout(timer);
             if (reThrow) {
-                reject(error); // Reject with the original error
+                reject(error);
             }
             else {
-                resolve(undefined); // Resolve with undefined if reThrow is false
+                resolve(undefined);
             }
         });
     });
 }
-//# sourceMappingURL=wait.js.map

package/dist/workerGlobalPrefix.js

@@ -1,26 +1,3 @@
-/**
- * This file contains the workerGlobalPrefix functions.
- *
- * @file workerGlobalPrefix.ts
- * @author Luca Liguori
- * @created 2025-11-25
- * @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 { threadId, isMainThread, parentPort, workerData } from 'node:worker_threads';
 import { AnsiLogger } from 'node-ansi-logger';
 import { getGlobalNodeModules } from './utils/network.js';
@@ -30,17 +7,13 @@ import { logWorkerInfo, parentLog, parentPost } from './workers.js';
 import { hasParameter } from './utils/commandLine.js';
 const debug = hasParameter('debug') || hasParameter('verbose');
 const verbose = hasParameter('verbose');
-// Send init message
-// istanbul ignore next cause it's available only in worker threads
 if (!isMainThread && parentPort) {
     parentPost({ type: 'init', threadId, threadName: workerData.threadName, success: true });
     if (debug)
-        parentLog('MatterbridgePrefix', "info" /* LogLevel.INFO */, `Worker ${workerData.threadName}:${threadId} initialized.`);
+        parentLog('MatterbridgePrefix', "info", `Worker ${workerData.threadName}:${threadId} initialized.`);
 }
-// Broadcast server
-const log = new AnsiLogger({ logName: 'MatterbridgePrefix', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: debug ? "debug" /* LogLevel.DEBUG */ : "info" /* LogLevel.INFO */ });
+const log = new AnsiLogger({ logName: 'MatterbridgePrefix', logTimestampFormat: 4, logLevel: debug ? "debug" : "info" });
 const server = new BroadcastServer('matterbridge', log);
-// Log worker info
 if (verbose)
     logWorkerInfo(log, verbose);
 let prefix;
@@ -51,21 +24,16 @@ try {
     server.request({ type: 'matterbridge_global_prefix', src: `matterbridge`, dst: 'matterbridge', params: { prefix } });
     success = true;
     if (!isMainThread && parentPort)
-        parentLog('MatterbridgePrefix', "debug" /* LogLevel.DEBUG */, `Global node_modules Directory: ${prefix}`);
+        parentLog('MatterbridgePrefix', "debug", `Global node_modules Directory: ${prefix}`);
 }
 catch (error) {
-    // istanbul ignore next cause it's just an error log
     const errorMessage = inspectError(log, `Failed to get global node modules`, error);
-    // istanbul ignore next cause it's just an error log
     if (!isMainThread && parentPort)
-        parentLog('MatterbridgePrefix', "error" /* LogLevel.ERROR */, errorMessage);
+        parentLog('MatterbridgePrefix', "error", errorMessage);
 }
 server.close();
-// Send exit message
-// istanbul ignore next cause it's available only in worker threads
 if (!isMainThread && parentPort) {
     parentPost({ type: 'exit', threadId, threadName: workerData.threadName, success });
     if (debug)
-        parentLog('MatterbridgePrefix', "info" /* LogLevel.INFO */, `Worker ${workerData.threadName}:${threadId} exiting with success: ${success}.`);
+        parentLog('MatterbridgePrefix', "info", `Worker ${workerData.threadName}:${threadId} exiting with success: ${success}.`);
 }
-//# sourceMappingURL=workerGlobalPrefix.js.map

package/dist/workerTypes.js

@@ -1,25 +1 @@
-/**
- * This file contains the worker types.
- *
- * @file workerTypes.ts
- * @author Luca Liguori
- * @created 2025-11-25
- * @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.
- */
 export {};
-//# sourceMappingURL=workerTypes.js.map

package/dist/workers.js

@@ -1,94 +1,31 @@
-/**
- * This file contains the worker functions.
- *
- * @file workers.ts
- * @author Luca Liguori
- * @created 2025-11-25
- * @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 { isMainThread, parentPort, threadId, Worker, workerData } from 'node:worker_threads';
 import { pathToFileURL } from 'node:url';
 import { resolve } from 'node:path';
 import { inspect } from 'node:util';
-/**
- * Sends a control message to the parent through parentPort
- *
- * @param {ControlMessage} message - The control message to send.
- */
-// istanbul ignore next cause it's available only in worker threads
 export function parentPost(message) {
     if (!parentPort)
         throw new Error(`WorkerServer ${workerData.threadName}: parentPort is not available.`);
     parentPort.postMessage(message);
 }
-/**
- * Sends a control message to the parent through parentPort to log a message.
- *
- * @param {string | undefined} logName - The name of the logger.
- * @param {LogLevel} logLevel - The log level of the message.
- * @param {string} message - The log message to send.
- */
-// istanbul ignore next cause it's available only in worker threads
 export function parentLog(logName, logLevel, message) {
     if (!parentPort)
         throw new Error(`WorkerServer ${workerData.threadName}: parentPort is not available.`);
     const logMessage = { type: 'log', threadId, threadName: workerData.threadName, logName, logLevel, message };
     parentPort.postMessage(logMessage);
 }
-/**
- * Typed helper to create an ESM Worker.
- *
- * This function uses pathToFileURL to convert the relative path to a file URL,
- * which is necessary for ESM modules. It also sets the worker type to 'module'.
- *
- * @param {string} name - name of the worker
- * @param {string} relativePath - path to the worker file code: it must be an ESM module in javascript
- * @param {Record<string, boolean | number | string | object>} [workerData] - optional data to pass to the worker
- * @param {string[]} [argv] - optional command line arguments to pass to the worker. If not provided, inherits from the main thread.
- * @param {NodeJS.ProcessEnv} [env] - optional environment variables to pass to the worker. If not provided, inherits from the main thread.
- * @param {string[]} [execArgv] - optional execArgv to pass to the worker. If not provided no execArgv are passed.
- * @returns {Worker} - the created Worker instance
- *
- * @example
- * ```typescript
- * createESMWorker('NpmCommand', './dist/npmCommand.js', { command: 'npm list --global --depth=0' });
- * ```
- */
 export function createESMWorker(name, relativePath, workerData, argv, env, execArgv) {
     const fileURL = pathToFileURL(resolve(relativePath));
     const options = {
-        workerData: { ...workerData, threadName: name }, // Pass threadName in workerData cause worker_threads don't have it natively in node 20
+        workerData: { ...workerData, threadName: name },
         type: 'module',
         name,
-        argv: argv ?? process.argv.slice(2), // Pass command line arguments to worker
-        env: env ?? process.env, // Inherit environment variables
-        execArgv, // execArgv for node like --inspect
+        argv: argv ?? process.argv.slice(2),
+        env: env ?? process.env,
+        execArgv,
     };
     return new Worker(fileURL, options);
 }
-/**
- * Log worker information.
- *
- * @param {AnsiLogger} log - The logger instance to use for logging.
- * @param {boolean} [logEnv] - Whether to log environment variables. Defaults to false.
- */
 export function logWorkerInfo(log, logEnv = false) {
-    // Log worker info
     log.debug(`${isMainThread ? 'Main thread' : 'Worker thread'}: ${workerData?.threadName}:${threadId} Pid: ${process.pid}`);
     log.debug(`ParentPort: ${parentPort ? 'active' : 'not active'}`);
     log.debug(`WorkerData: ${workerData ? inspect(workerData, true, 10, true) : 'none'}`);
@@ -96,4 +33,3 @@ export function logWorkerInfo(log, logEnv = false) {
     log.debug(`Argv: ${argv.length ? argv.join(' ') : 'none'}`);
     log.debug(`Env: ${logEnv ? inspect(process.env, true, 10, true) : 'not logged'}`);
 }
-//# sourceMappingURL=workers.js.map

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge",
-  "version": "3.4.6",
+  "version": "3.4.7-dev-20260103-3152357",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.4.6",
+      "version": "3.4.7-dev-20260103-3152357",
       "license": "Apache-2.0",
       "workspaces": [
         "packages/*"
@@ -2479,9 +2479,9 @@
       "license": "MIT"
     },
     "node_modules/@sinclair/typebox": {
-      "version": "0.34.45",
-      "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.34.45.tgz",
-      "integrity": "sha512-qJcFVfCa5jxBFSuv7S5WYbA8XdeCPmhnaVVfX/2Y6L8WYg8sk3XY2+6W0zH+3mq1Cz+YC7Ki66HfqX6IHAwnkg==",
+      "version": "0.34.46",
+      "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.34.46.tgz",
+      "integrity": "sha512-kiW7CtS/NkdvTUjkjUJo7d5JsFfbJ14YjdhDk9KoEgK6nFjKNXZPrX0jfLA8ZlET4cFLHxOZ/0vFKOP+bOxIOQ==",
       "dev": true,
       "license": "MIT"
     },
@@ -3244,14 +3244,14 @@
       }
     },
     "node_modules/@vitest/eslint-plugin": {
-      "version": "1.6.4",
-      "resolved": "https://registry.npmjs.org/@vitest/eslint-plugin/-/eslint-plugin-1.6.4.tgz",
-      "integrity": "sha512-+qw32ux8HMVNrJnQOYgdjrMYmCn9vsiKnJUv5MoOg40e18WOvhWurzHdbRB3vXLfUrP7+jYyQbd6TuRhL23AkQ==",
+      "version": "1.6.5",
+      "resolved": "https://registry.npmjs.org/@vitest/eslint-plugin/-/eslint-plugin-1.6.5.tgz",
+      "integrity": "sha512-+wKYGmvXQJjq58qBx/AwiZr5bFfMiWBdgHViSQoFW/+wl5MQhJeOGP/3HM7GO7W1+AoiW9Gcyy2Hdwcao4LnfQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/scope-manager": "^8.46.1",
-        "@typescript-eslint/utils": "^8.46.1"
+        "@typescript-eslint/scope-manager": "^8.51.0",
+        "@typescript-eslint/utils": "^8.51.0"
       },
       "engines": {
         "node": ">=18"
@@ -4245,9 +4245,9 @@
       }
     },
     "node_modules/cjs-module-lexer": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-2.1.1.tgz",
-      "integrity": "sha512-+CmxIZ/L2vNcEfvNtLdU0ZQ6mbq3FZnwAP2PPTiKP+1QOoKwlKlPgb8UKV0Dds7QVaMnHm+FwSft2VB0s/SLjQ==",
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-2.2.0.tgz",
+      "integrity": "sha512-4bHTS2YuzUvtoLjdy+98ykbNB5jS0+07EvFNXerqZQJ89F7DI6ET7OQo/HJuW6K0aVsKA9hj9/RVb2kQVOrPDQ==",
       "dev": true,
       "license": "MIT"
     },
@@ -5207,9 +5207,9 @@
       }
     },
     "node_modules/eslint-plugin-jest": {
-      "version": "29.12.0",
-      "resolved": "https://registry.npmjs.org/eslint-plugin-jest/-/eslint-plugin-jest-29.12.0.tgz",
-      "integrity": "sha512-dOMLGkl5vCDZo/KcsmzJkkYJUH+SDLls4PLBj8Aw86x5BHdXkygMGdfnqikJ8RUgEx3MHni09B5cebZF5+4rrQ==",
+      "version": "29.12.1",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-jest/-/eslint-plugin-jest-29.12.1.tgz",
+      "integrity": "sha512-Rxo7r4jSANMBkXLICJKS0gjacgyopfNAsoS0e3R9AHnjoKuQOaaPfmsDJPi8UWwygI099OV/K/JhpYRVkxD4AA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -8322,9 +8322,9 @@
       }
     },
     "node_modules/npm-check-updates": {
-      "version": "19.2.0",
-      "resolved": "https://registry.npmjs.org/npm-check-updates/-/npm-check-updates-19.2.0.tgz",
-      "integrity": "sha512-XSIuL0FNgzXPDZa4lje7+OwHjiyEt84qQm6QMsQRbixNY5EHEM9nhgOjxjlK9jIbN+ysvSqOV8DKNS0zydwbdg==",
+      "version": "19.2.1",
+      "resolved": "https://registry.npmjs.org/npm-check-updates/-/npm-check-updates-19.2.1.tgz",
+      "integrity": "sha512-jWIMuE6K+DSDXfjXpM3SlJ+Gg07ZV57dlFKPr2EZTpimFk9y+gt138+kmP3Uocdqk1PZlOKpTpFvAx7Z1QCeog==",
       "dev": true,
       "license": "Apache-2.0",
       "bin": {
@@ -10404,9 +10404,9 @@
       }
     },
     "node_modules/ts-api-utils": {
-      "version": "2.3.0",
-      "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.3.0.tgz",
-      "integrity": "sha512-6eg3Y9SF7SsAvGzRHQvvc1skDAhwI4YQ32ui1scxD1Ccr0G5qIIbUBT3pFTKX8kmWIQClHobtUdNuaBgwdfdWg==",
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.4.0.tgz",
+      "integrity": "sha512-3TaVTaAv2gTiMB35i3FiGJaRfwb3Pyn/j3m/bfAvGe8FB7CF6u+LMYqYlDh7reQf7UNvoTvdfAqHGmPGOSsPmA==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -11417,18 +11417,18 @@
         "@types/jest": "30.0.0",
         "@types/node": "25.0.3",
         "@vitest/coverage-v8": "4.0.16",
-        "@vitest/eslint-plugin": "1.6.4",
+        "@vitest/eslint-plugin": "1.6.5",
         "cross-env": "10.1.0",
         "eslint": "9.39.2",
         "eslint-config-prettier": "10.1.8",
         "eslint-plugin-import": "2.32.0",
-        "eslint-plugin-jest": "29.12.0",
+        "eslint-plugin-jest": "29.12.1",
         "eslint-plugin-jsdoc": "61.5.0",
         "eslint-plugin-n": "17.23.1",
         "eslint-plugin-prettier": "5.5.4",
         "eslint-plugin-promise": "7.2.1",
         "jest": "30.2.0",
-        "npm-check-updates": "19.2.0",
+        "npm-check-updates": "19.2.1",
         "prettier": "3.7.4",
         "shx": "0.4.0",
         "ts-jest": "29.4.6",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.4.6",
+  "version": "3.4.7-dev-20260103-3152357",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
@@ -40,7 +40,6 @@
   ],
   "type": "module",
   "main": "dist/index.js",
-  "types": "dist/index.d.ts",
   "bin": {
     "matterbridge": "bin/matterbridge.js",
     "mb_mdns": "bin/mb_mdns.js",

package/packages/mb-lib-test/dist/jestutils/jestHelpers.js

@@ -0,0 +1,77 @@
+import { rmSync } from 'node:fs';
+import path from 'node:path';
+import { AnsiLogger } from 'node-ansi-logger';
+export const originalProcessArgv = Object.freeze([...process.argv]);
+export const originalProcessEnv = Object.freeze({ ...process.env });
+export let loggerLogSpy;
+export let loggerDebugSpy;
+export let loggerInfoSpy;
+export let loggerNoticeSpy;
+export let loggerWarnSpy;
+export let loggerErrorSpy;
+export let loggerFatalSpy;
+export let consoleLogSpy;
+export let consoleDebugSpy;
+export let consoleInfoSpy;
+export let consoleWarnSpy;
+export let consoleErrorSpy;
+export let NAME;
+export let HOMEDIR;
+export let log;
+export async function setupTest(name, debug = false) {
+    expect(name).toBeDefined();
+    expect(typeof name).toBe('string');
+    expect(name.length).toBeGreaterThanOrEqual(4);
+    NAME = name;
+    HOMEDIR = path.join('temp', name);
+    log = new AnsiLogger({ logName: 'Jest', logTimestampFormat: 4, logLevel: "info" });
+    rmSync(HOMEDIR, { recursive: true, force: true });
+    const { jest } = await import('@jest/globals');
+    loggerDebugSpy = jest.spyOn(AnsiLogger.prototype, 'debug');
+    loggerInfoSpy = jest.spyOn(AnsiLogger.prototype, 'info');
+    loggerNoticeSpy = jest.spyOn(AnsiLogger.prototype, 'notice');
+    loggerWarnSpy = jest.spyOn(AnsiLogger.prototype, 'warn');
+    loggerErrorSpy = jest.spyOn(AnsiLogger.prototype, 'error');
+    loggerFatalSpy = jest.spyOn(AnsiLogger.prototype, 'fatal');
+    if (debug) {
+        loggerLogSpy = jest.spyOn(AnsiLogger.prototype, 'log');
+        consoleLogSpy = jest.spyOn(console, 'log');
+        consoleDebugSpy = jest.spyOn(console, 'debug');
+        consoleInfoSpy = jest.spyOn(console, 'info');
+        consoleWarnSpy = jest.spyOn(console, 'warn');
+        consoleErrorSpy = jest.spyOn(console, 'error');
+    }
+    else {
+        loggerLogSpy = jest.spyOn(AnsiLogger.prototype, 'log').mockImplementation(() => { });
+        consoleLogSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        consoleDebugSpy = jest.spyOn(console, 'debug').mockImplementation(() => { });
+        consoleInfoSpy = jest.spyOn(console, 'info').mockImplementation(() => { });
+        consoleWarnSpy = jest.spyOn(console, 'warn').mockImplementation(() => { });
+        consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
+    }
+}
+export async function setDebug(debug) {
+    const { jest } = await import('@jest/globals');
+    if (debug) {
+        loggerLogSpy.mockRestore();
+        consoleLogSpy.mockRestore();
+        consoleDebugSpy.mockRestore();
+        consoleInfoSpy.mockRestore();
+        consoleWarnSpy.mockRestore();
+        consoleErrorSpy.mockRestore();
+        loggerLogSpy = jest.spyOn(AnsiLogger.prototype, 'log');
+        consoleLogSpy = jest.spyOn(console, 'log');
+        consoleDebugSpy = jest.spyOn(console, 'debug');
+        consoleInfoSpy = jest.spyOn(console, 'info');
+        consoleWarnSpy = jest.spyOn(console, 'warn');
+        consoleErrorSpy = jest.spyOn(console, 'error');
+    }
+    else {
+        loggerLogSpy = jest.spyOn(AnsiLogger.prototype, 'log').mockImplementation(() => { });
+        consoleLogSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        consoleDebugSpy = jest.spyOn(console, 'debug').mockImplementation(() => { });
+        consoleInfoSpy = jest.spyOn(console, 'info').mockImplementation(() => { });
+        consoleWarnSpy = jest.spyOn(console, 'warn').mockImplementation(() => { });
+        consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
+    }
+}

package/packages/mb-lib-test/dist/module.js

@@ -0,0 +1,2 @@
+export * as jestHelpers from './jestutils/jestHelpers.js';
+export * as vitestHelpers from './vitestutils/vitestHelpers.js';

package/packages/mb-lib-test/dist/vitestutils/vitestHelpers.js

@@ -0,0 +1,77 @@
+import { rmSync } from 'node:fs';
+import path from 'node:path';
+import { AnsiLogger } from 'node-ansi-logger';
+export const originalProcessArgv = Object.freeze([...process.argv]);
+export const originalProcessEnv = Object.freeze({ ...process.env });
+export let loggerLogSpy;
+export let loggerDebugSpy;
+export let loggerInfoSpy;
+export let loggerNoticeSpy;
+export let loggerWarnSpy;
+export let loggerErrorSpy;
+export let loggerFatalSpy;
+export let consoleLogSpy;
+export let consoleDebugSpy;
+export let consoleInfoSpy;
+export let consoleWarnSpy;
+export let consoleErrorSpy;
+export let NAME;
+export let HOMEDIR;
+export let log;
+export async function setupTest(name, debug = false) {
+    expect(name).toBeDefined();
+    expect(typeof name).toBe('string');
+    expect(name.length).toBeGreaterThanOrEqual(4);
+    NAME = name;
+    HOMEDIR = path.join('temp', name);
+    log = new AnsiLogger({ logName: 'Vitest', logTimestampFormat: 4, logLevel: "info" });
+    rmSync(HOMEDIR, { recursive: true, force: true });
+    const { vi } = await import('vitest');
+    loggerDebugSpy = vi.spyOn(AnsiLogger.prototype, 'debug');
+    loggerInfoSpy = vi.spyOn(AnsiLogger.prototype, 'info');
+    loggerNoticeSpy = vi.spyOn(AnsiLogger.prototype, 'notice');
+    loggerWarnSpy = vi.spyOn(AnsiLogger.prototype, 'warn');
+    loggerErrorSpy = vi.spyOn(AnsiLogger.prototype, 'error');
+    loggerFatalSpy = vi.spyOn(AnsiLogger.prototype, 'fatal');
+    if (debug) {
+        loggerLogSpy = vi.spyOn(AnsiLogger.prototype, 'log');
+        consoleLogSpy = vi.spyOn(console, 'log');
+        consoleDebugSpy = vi.spyOn(console, 'debug');
+        consoleInfoSpy = vi.spyOn(console, 'info');
+        consoleWarnSpy = vi.spyOn(console, 'warn');
+        consoleErrorSpy = vi.spyOn(console, 'error');
+    }
+    else {
+        loggerLogSpy = vi.spyOn(AnsiLogger.prototype, 'log').mockImplementation(() => { });
+        consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        consoleDebugSpy = vi.spyOn(console, 'debug').mockImplementation(() => { });
+        consoleInfoSpy = vi.spyOn(console, 'info').mockImplementation(() => { });
+        consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+    }
+}
+export async function setDebug(debug) {
+    const { vi } = await import('vitest');
+    if (debug) {
+        loggerLogSpy.mockRestore();
+        consoleLogSpy.mockRestore();
+        consoleDebugSpy.mockRestore();
+        consoleInfoSpy.mockRestore();
+        consoleWarnSpy.mockRestore();
+        consoleErrorSpy.mockRestore();
+        loggerLogSpy = vi.spyOn(AnsiLogger.prototype, 'log');
+        consoleLogSpy = vi.spyOn(console, 'log');
+        consoleDebugSpy = vi.spyOn(console, 'debug');
+        consoleInfoSpy = vi.spyOn(console, 'info');
+        consoleWarnSpy = vi.spyOn(console, 'warn');
+        consoleErrorSpy = vi.spyOn(console, 'error');
+    }
+    else {
+        loggerLogSpy = vi.spyOn(AnsiLogger.prototype, 'log').mockImplementation(() => { });
+        consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        consoleDebugSpy = vi.spyOn(console, 'debug').mockImplementation(() => { });
+        consoleInfoSpy = vi.spyOn(console, 'info').mockImplementation(() => { });
+        consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+    }
+}

package/packages/mb-lib-test/package.json

@@ -30,19 +30,20 @@
     "start": "node dist/module.js",
     "build": "tsc --project tsconfig.json",
     "buildProduction": "tsc --project tsconfig.production.json",
-    "cleanBuild": "npx shx rm -rf tsconfig.tsbuildinfo dist && npm run build",
-    "cleanBuildProduction": "npx shx rm -rf tsconfig.tsbuildinfo dist && npm run buildProduction",
+    "clean": "npx shx rm -rf tsconfig.tsbuildinfo dist",
+    "cleanBuild": "npm run clean && npm run build",
+    "cleanBuildProduction": "npm run clean && npm run buildProduction",
     "watch": "tsc --watch",
     "test": "cross-env NODE_OPTIONS=\"--experimental-vm-modules --no-warnings\" jest --maxWorkers=100%",
-    "test:verbose": "cross-env NODE_OPTIONS=\"--experimental-vm-modules --no-warnings\" jest --maxWorkers=100% --verbose",
     "test:watch": "cross-env NODE_OPTIONS=\"--experimental-vm-modules --no-warnings\" jest --maxWorkers=100% --watch",
-    "test:coverage": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --maxWorkers=100% --coverage",
+    "test:verbose": "cross-env NODE_OPTIONS=\"--experimental-vm-modules --no-warnings\" jest --maxWorkers=100% --verbose",
+    "test:coverage": "cross-env NODE_OPTIONS=\"--experimental-vm-modules --no-warnings\" jest --maxWorkers=100% --coverage",
     "test:vitest": "vitest run",
     "test:vitest:watch": "vitest --reporter verbose",
     "test:vitest:verbose": "vitest run --reporter verbose",
     "test:vitest:coverage": "vitest run --reporter verbose --coverage",
-    "clean": "npx shx rm -rf tsconfig.tsbuildinfo dist coverage jest temp package-lock.json npm-shrinkwrap.json node_modules/* node_modules/.[!.]* node_modules/..?*",
-    "reset": "npm run clean && npm install && npm run build && npx jest --clearCache",
+    "deepClean": "npx shx rm -rf tsconfig.tsbuildinfo dist coverage jest temp package-lock.json npm-shrinkwrap.json node_modules/* node_modules/.[!.]* node_modules/..?*",
+    "reset": "npm run deepClean && npm install && npm run build && npx jest --clearCache",
     "lint": "eslint --max-warnings=0 .",
     "lint:fix": "eslint --fix --max-warnings=0 .",
     "format": "prettier --write .",
@@ -83,18 +84,18 @@
     "@types/jest": "30.0.0",
     "@types/node": "25.0.3",
     "@vitest/coverage-v8": "4.0.16",
-    "@vitest/eslint-plugin": "1.6.4",
+    "@vitest/eslint-plugin": "1.6.5",
     "cross-env": "10.1.0",
     "eslint": "9.39.2",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-import": "2.32.0",
-    "eslint-plugin-jest": "29.12.0",
+    "eslint-plugin-jest": "29.12.1",
     "eslint-plugin-jsdoc": "61.5.0",
     "eslint-plugin-n": "17.23.1",
     "eslint-plugin-prettier": "5.5.4",
     "eslint-plugin-promise": "7.2.1",
     "jest": "30.2.0",
-    "npm-check-updates": "19.2.0",
+    "npm-check-updates": "19.2.1",
     "prettier": "3.7.4",
     "shx": "0.4.0",
     "ts-jest": "29.4.6",