matterbridge 3.4.7-dev-20260113-0917d83 → 3.4.7

package/dist/workerGlobalPrefix.d.ts

@@ -1 +1,25 @@
+/**
+ * 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.
+ */
 export {};
+//# sourceMappingURL=workerGlobalPrefix.d.ts.map

package/dist/workerGlobalPrefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerGlobalPrefix.d.ts","sourceRoot":"","sources":["../src/workerGlobalPrefix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/dist/workerGlobalPrefix.js

@@ -1,3 +1,26 @@
+/**
+ * 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';
@@ -7,13 +30,17 @@ 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", `Worker ${workerData.threadName}:${threadId} initialized.`);
+        parentLog('MatterbridgePrefix', "info" /* LogLevel.INFO */, `Worker ${workerData.threadName}:${threadId} initialized.`);
 }
-const log = new AnsiLogger({ logName: 'MatterbridgePrefix', logTimestampFormat: 4, logLevel: debug ? "debug" : "info" });
+// Broadcast server
+const log = new AnsiLogger({ logName: 'MatterbridgePrefix', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: debug ? "debug" /* LogLevel.DEBUG */ : "info" /* LogLevel.INFO */ });
 const server = new BroadcastServer('matterbridge', log);
+// Log worker info
 if (verbose)
     logWorkerInfo(log, verbose);
 let prefix;
@@ -24,16 +51,21 @@ try {
     server.request({ type: 'matterbridge_global_prefix', src: `matterbridge`, dst: 'matterbridge', params: { prefix } });
     success = true;
     if (!isMainThread && parentPort)
-        parentLog('MatterbridgePrefix', "debug", `Global node_modules Directory: ${prefix}`);
+        parentLog('MatterbridgePrefix', "debug" /* LogLevel.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", errorMessage);
+        parentLog('MatterbridgePrefix', "error" /* LogLevel.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", `Worker ${workerData.threadName}:${threadId} exiting with success: ${success}.`);
+        parentLog('MatterbridgePrefix', "info" /* LogLevel.INFO */, `Worker ${workerData.threadName}:${threadId} exiting with success: ${success}.`);
 }
+//# sourceMappingURL=workerGlobalPrefix.js.map

package/dist/workerGlobalPrefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerGlobalPrefix.js","sourceRoot":"","sources":["../src/workerGlobalPrefix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,UAAU,EAA6B,MAAM,kBAAkB,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;AAC/D,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AAExC,oBAAoB;AACpB,mEAAmE;AACnE,IAAI,CAAC,YAAY,IAAI,UAAU,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACzF,IAAI,KAAK;QAAE,SAAS,CAAC,oBAAoB,8BAAiB,UAAU,UAAU,CAAC,UAAU,IAAI,QAAQ,eAAe,CAAC,CAAC;AACxH,CAAC;AAED,mBAAmB;AACnB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,qCAA6B,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,8BAAgB,CAAC,2BAAc,EAAE,CAAC,CAAC;AACjK,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;AAExD,kBAAkB;AAClB,IAAI,OAAO;IAAE,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAEzC,IAAI,MAAc,CAAC;AACnB,IAAI,OAAO,GAAG,KAAK,CAAC;AACpB,IAAI,CAAC;IACH,MAAM,GAAG,MAAM,oBAAoB,EAAE,CAAC;IACtC,GAAG,CAAC,KAAK,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC;IACtD,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACrH,OAAO,GAAG,IAAI,CAAC;IACf,IAAI,CAAC,YAAY,IAAI,UAAU;QAAE,SAAS,CAAC,oBAAoB,gCAAkB,kCAAkC,MAAM,EAAE,CAAC,CAAC;AAC/H,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,oDAAoD;IACpD,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,EAAE,mCAAmC,EAAE,KAAK,CAAC,CAAC;IACnF,oDAAoD;IACpD,IAAI,CAAC,YAAY,IAAI,UAAU;QAAE,SAAS,CAAC,oBAAoB,gCAAkB,YAAY,CAAC,CAAC;AACjG,CAAC;AACD,MAAM,CAAC,KAAK,EAAE,CAAC;AAEf,oBAAoB;AACpB,mEAAmE;AACnE,IAAI,CAAC,YAAY,IAAI,UAAU,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IACnF,IAAI,KAAK;QAAE,SAAS,CAAC,oBAAoB,8BAAiB,UAAU,UAAU,CAAC,UAAU,IAAI,QAAQ,0BAA0B,OAAO,GAAG,CAAC,CAAC;AAC7I,CAAC"}

package/dist/workerTypes.d.ts

@@ -1,4 +1,28 @@
+/**
+ * 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.
+ */
 import { LogLevel } from 'node-ansi-logger';
+/** Control messages sent through parentPort manager <-> workers */
 export type ParentPortMessage = {
     type: 'init';
     threadName: string | null;
@@ -25,3 +49,4 @@ export type ParentPortMessage = {
     threadId: number;
     success: boolean;
 };
+//# sourceMappingURL=workerTypes.d.ts.map

package/dist/workerTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerTypes.d.ts","sourceRoot":"","sources":["../src/workerTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,mEAAmE;AACnE,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9H;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/workerTypes.js

@@ -1 +1,25 @@
+/**
+ * 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/workerTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerTypes.js","sourceRoot":"","sources":["../src/workerTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/dist/workers.d.ts

@@ -1,8 +1,69 @@
+/**
+ * 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 { Worker } from 'node:worker_threads';
 import { AnsiLogger, LogLevel } from 'node-ansi-logger';
 import type { ParentPortMessage } from './workerTypes.js';
+/**
+ * Sends a control message to the parent through parentPort
+ *
+ * @param {ControlMessage} message - The control message to send.
+ */
 export declare function parentPost(message: ParentPortMessage): void;
+/**
+ * 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.
+ */
 export declare function parentLog(logName: string | undefined, logLevel: LogLevel, message: string): void;
+/**
+ * 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 declare function createESMWorker(name: string, relativePath: string, workerData?: Record<string, boolean | number | string | object>, argv?: string[], env?: NodeJS.ProcessEnv, execArgv?: string[]): Worker;
+/**
+ * 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 declare function logWorkerInfo(log: AnsiLogger, logEnv?: boolean): void;
 export { ParentPortMessage };
+//# sourceMappingURL=workers.d.ts.map

package/dist/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../src/workers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAsC,MAAM,EAA6B,MAAM,qBAAqB,CAAC;AAK5G,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;GAIG;AAEH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAG3D;AAED;;;;;;GAMG;AAEH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIhG;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAW1M;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,GAAE,OAAe,GAAG,IAAI,CAQ5E;AACD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/workers.js

@@ -1,31 +1,94 @@
+/**
+ * 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 },
+        workerData: { ...workerData, threadName: name }, // Pass threadName in workerData cause worker_threads don't have it natively in node 20
         type: 'module',
         name,
-        argv: argv ?? process.argv.slice(2),
-        env: env ?? process.env,
-        execArgv,
+        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
     };
     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'}`);
@@ -33,3 +96,4 @@ 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/dist/workers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.js","sourceRoot":"","sources":["../src/workers.ts"],"names":[],"mappings":"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"}

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge",
-  "version": "3.4.7-dev-20260113-0917d83",
+  "version": "3.4.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.4.7-dev-20260113-0917d83",
+      "version": "3.4.7",
       "license": "Apache-2.0",
       "workspaces": [
         "packages/jest-utils",

package/package.json

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

package/packages/dgram/dist/coap.d.ts

@@ -1,13 +1,141 @@
+/**
+ * @description This file contains the class Coap.
+ * @file src/dgram/coap.ts
+ * @author Luca Liguori
+ * @created 2025-03-22
+ * @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 dgram from 'node:dgram';
 import { Multicast } from './multicast.js';
+/**
+ * Represents a CoAP message.
+ *
+ * A CoAP message is structured with a fixed header, an optional token, a series of options,
+ * and an optional payload. The header consists of version, type, token length, code, and message ID.
+ * The token is used to match responses with requests, options provide additional metadata, and
+ * the payload carries the message content.
+ */
 export interface CoapMessage {
+    /**
+     * The CoAP protocol version.
+     * Typically, this is 1.
+     * (Stored in the top 2 bits of the first header byte.)
+     */
     version: number;
+    /**
+     * The message type.
+     * It indicates whether the message is Confirmable, Non-confirmable, Acknowledgement, or Reset.
+     * (Stored in bits 5-4 of the first header byte.)
+     * 0: Confirmable (CON)
+     * 1: Non-confirmable (NON)
+     * 2: Acknowledgement (ACK)
+     * 3: Reset (RST)
+     */
     type: number;
+    /**
+     * The token length.
+     * This value (0-8) specifies the length of the token field.
+     * (Stored in the lower 4 bits of the first header byte.)
+     */
     tokenLength: number;
+    /**
+     * The message code.
+     * It indicates the method or response code, e.g., GET, POST, or a success/error response.
+     * (Stored in the second header byte.)
+     * CoAP uses an 8‑bit Code field divided into a 3‑bit class and a 5‑bit detail. The code can be represented as X.XX (e.g. 0.01) and is defined in RFC 7252. Here are the standard CoAP codes:
+     * Request Codes (Class 0)
+     * 0.01 – 1-GET
+     * Retrieve a resource.
+     * 0.02 – 2-POST
+     * Create a resource or trigger an action.
+     * 0.03 – 3-PUT
+     * Update or create a resource.
+     * 0.04 – 4-DELETE
+     * Remove a resource.
+     * Success Response Codes (Class 2)
+     * 2.00 – Empty / Success
+     * Indicates an empty message or a successful request with no payload.
+     * 2.01 – Created
+     * The request resulted in a new resource being created.
+     * 2.02 – Deleted
+     * The resource was successfully deleted.
+     * 2.03 – Valid
+     * The response indicates that the resource is still valid (used with caching).
+     * 2.04 – Changed
+     * The resource was successfully modified.
+     * 2.05 – Content
+     * The response contains the requested content.
+     * Client Error Response Codes (Class 4)
+     * 4.00 – Bad Request
+     * The request was malformed.
+     * 4.01 – Unauthorized
+     * The request requires authentication.
+     * 4.02 – Bad Option
+     * An option in the request was not understood or is unacceptable.
+     * 4.03 – Forbidden
+     * The server refuses to fulfill the request.
+     * 4.04 – Not Found
+     * The requested resource was not found.
+     * 4.05 – Method Not Allowed
+     * The request method is not supported for the target resource.
+     * 4.06 – Not Acceptable
+     * The server cannot generate a response matching the list of acceptable values.
+     * 4.12 – Precondition Failed
+     * A precondition given in the request evaluated to false.
+     * 4.13 – Request Entity Too Large
+     * The request payload is too large.
+     * 4.15 – Unsupported Content-Format
+     * The server does not support the content format of the request payload.
+     * Server Error Response Codes (Class 5)
+     * 5.00 – Internal Server Error
+     * The server encountered an unexpected condition.
+     * 5.01 – Not Implemented
+     * The server does not support the requested method.
+     * 5.02 – Bad Gateway
+     * The server, while acting as a gateway or proxy, received an invalid response.
+     * 5.03 – Service Unavailable
+     * The server is currently unable to handle the request.
+     * 5.04 – Gateway Timeout
+     * The server did not receive a timely response from an upstream server.
+     * 5.05 – Proxying Not Supported
+     * The server does not support proxying for the requested resource.
+     */
     code: number;
+    /**
+     * The message identifier.
+     * This 16-bit field is used to match messages of type Acknowledgement/Reset with their corresponding requests.
+     * (Stored in bytes 2-3 of the header.)
+     */
     messageId: number;
+    /**
+     * The token.
+     * A variable-length sequence (0-8 bytes) that helps match a request with its response.
+     */
     token: Buffer;
+    /**
+     * An array of options.
+     * Options carry additional information such as URI path, content format, etc., and are encoded using a delta mechanism.
+     */
     options: CoapOption[];
+    /**
+     * The payload.
+     * The actual content of the message, if present. It follows a payload marker (0xFF) if non-empty.
+     */
     payload?: Buffer;
 }
 interface CoapOption {
@@ -24,11 +152,54 @@ export declare class Coap extends Multicast {
     constructor(name: string, multicastAddress: string, multicastPort: number, socketType: 'udp4' | 'udp6', reuseAddr?: boolean | undefined, interfaceName?: string, interfaceAddress?: string);
     onCoapMessage(message: CoapMessage, rinfo: dgram.RemoteInfo): void;
     onMessage(msg: Buffer, rinfo: dgram.RemoteInfo): void;
+    /**
+     * Decodes a CoAP message from a Buffer.
+     *
+     * @param {Buffer} msg - The Buffer containing the raw CoAP message.
+     * @returns {CoapMessage} A parsed CoAP message object.
+     * @throws {Error} if the message is malformed.
+     */
     decodeCoapMessage(msg: Buffer): CoapMessage;
+    /**
+     * Encodes a CoAP message into a Buffer.
+     *
+     * @param {CoapMessage} msg - The CoAP message to encode.
+     * @returns {Buffer} A Buffer representing the encoded CoAP message.
+     * @throws {Error} if the message is malformed.
+     */
     encodeCoapMessage(msg: CoapMessage): Buffer;
+    /**
+     * Converts a CoAP message type numeric value to its string representation.
+     *
+     * CoAP message types are:
+     *  - 0: Confirmable (CON)
+     *  - 1: Non-confirmable (NON)
+     *  - 2: Acknowledgement (ACK)
+     *  - 3: Reset (RST)
+     *
+     * @param {number} type - The numeric CoAP message type.
+     * @returns {string} The string representation of the message type.
+     */
     coapTypeToString(type: number): string;
+    /**
+     * Converts a CoAP code numeric value to its string representation.
+     *
+     * The CoAP code is split into a 3-bit class and a 5-bit detail.
+     * For example:
+     *   - 0.01: GET
+     *   - 0.02: POST
+     *   - 0.03: PUT
+     *   - 0.04: DELETE
+     *   - 2.05: Content (success response)
+     *   - 4.04: Not Found (client error)
+     *   - 5.00: Internal Server Error (server error)
+     *
+     * @param {number} code - The numeric CoAP code.
+     * @returns {string} The string representation of the code.
+     */
     coapCodeToString(code: number): string;
     sendRequest(messageId: number, options: CoapOption[], payload: Record<string, any> | undefined, token: string | undefined, address: string | undefined, port: number | undefined): void;
     logCoapMessage(msg: CoapMessage): void;
 }
 export {};
+//# sourceMappingURL=coap.d.ts.map

package/packages/dgram/dist/coap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coap.d.ts","sourceRoot":"","sources":["../src/coap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,MAAM,YAAY,CAAC;AAM/B,OAAO,EAAoD,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE7F;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6DG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAElD,qBAAa,IAAK,SAAQ,SAAS;gBAE/B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,SAAS,GAAE,OAAO,GAAG,SAAgB,EACrC,aAAa,CAAC,EAAE,MAAM,EACtB,gBAAgB,CAAC,EAAE,MAAM;IAK3B,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,GAAG,IAAI;IAIzD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,GAAG,IAAI;IAW9D;;;;;;OAMG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAwG3C;;;;;;OAMG;IACH,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM;IA6F3C;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAetC;;;;;;;;;;;;;;;OAeG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQtC,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,EAAE,EAErB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,IAAI;IAeP,cAAc,CAAC,GAAG,EAAE,WAAW;CAyDhC"}