matterbridge 3.4.2 → 3.4.3-dev-20251207-3ce5a0e

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