matterbridge 2.0.0-edge1 → 2.1.0-dev.1

package/dist/utils/utils.js

@@ -1,93 +1,28 @@
-/**
- * This file contains the deepEqual function.
- *
- * @file utils.ts
- * @author Luca Liguori
- * @date 2024-02-17
- * @version 1.2.9
- *
- * 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 'os';
 import { createWriteStream, statSync } from 'fs';
 import path from 'path';
 import * as dns from 'dns';
 import { promises as fs } from 'fs';
-// Package modules
-import archiver from 'archiver';
-import { glob } from 'glob';
-// AnsiLogger module
-import { AnsiLogger, idn, LogLevel, rs, TimestampFormat } from 'node-ansi-logger';
-const log = new AnsiLogger({ logName: 'MatterbridgeUtils', logTimestampFormat: TimestampFormat.TIME_MILLIS, logLevel: LogLevel.INFO });
-/**
- * Performs a deep comparison between two values to determine if they are equivalent.
- * This comparison includes primitive types, arrays, and objects, allowing for optional
- * exclusion of specific properties from the comparison in objects.
- *
- * @param {any} a The first value to compare.
- * @param {any} b The second value to compare.
- * @param {string[]} [excludeProperties=[]] An array of property names to exclude from the comparison in objects.
- * @returns {boolean} True if the values are deeply equal, excluding any specified properties; otherwise, false.
- *
- * Note: This function utilizes recursion for deep comparison of nested structures and includes a debugging
- * mechanism that can be toggled on or off for detailed comparison logging. It is important to ensure that
- * objects do not contain circular references when enabling debug logging to avoid infinite loops.
- *
- * Example usage:
- * ```
- * const obj1 = { a: 1, b: { c: 2 } };
- * const obj2 = { a: 1, b: { c: 2 } };
- * console.log(deepEqual(obj1, obj2)); // true
- *
- * const arr1 = [1, 2, [3, 4]];
- * const arr2 = [1, 2, [3, 4]];
- * console.log(deepEqual(arr1, arr2)); // true
- *
- * const obj3 = { a: 1, b: { c: 2, d: 3 } };
- * const obj4 = { a: 1, b: { c: 2 } };
- * console.log(deepEqual(obj3, obj4, ['d'])); // true, excluding property 'd' from comparison
- * ```
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
+import { AnsiLogger, idn, rs } from 'node-ansi-logger';
+const log = new AnsiLogger({ logName: 'MatterbridgeUtils', logTimestampFormat: 4, logLevel: "info" });
 export function deepEqual(a, b, excludeProperties = []) {
-    // Toggle debugging on or off easily
     const debug = false;
-    // Helper function for conditional logging
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const debugLog = (...messages) => {
         if (debug) {
-            // eslint-disable-next-line no-console
             console.log(...messages);
         }
     };
-    // If both are the same instance, return true (handles primitives and same object references)
     if (a === b) {
         return true;
     }
-    // If types are different, return false
     if (typeof a !== typeof b) {
         debugLog(`deepEqual false for typeof a: ${typeof a} typeof b: ${typeof b}`);
         return false;
     }
-    // If one of them is null (and we know they are not equal from the first check), return false
     if (a == null || b == null) {
         debugLog('deepEqual false for == null');
         return false;
     }
-    // Handle Arrays
     if (Array.isArray(a) && Array.isArray(b)) {
         if (a.length !== b.length) {
             debugLog(`deepEqual false for array a.length(${a.length}) !== b.length(${b.length})`);
@@ -103,75 +38,54 @@ export function deepEqual(a, b, excludeProperties = []) {
         }
         return true;
     }
-    // Handle Objects (and exclude null, functions, and arrays)
     if (typeof a === 'object' && typeof b === 'object') {
         const aProps = Object.getOwnPropertyNames(a).filter((prop) => !excludeProperties.includes(prop));
         const bProps = Object.getOwnPropertyNames(b).filter((prop) => !excludeProperties.includes(prop));
-        // If their property lengths are different, they're different objects
         if (aProps.length !== bProps.length) {
             debugLog(`deepEqual false for aProps.length(${aProps.length}) !== bProps.length(${bProps.length})`);
             debugLog(`- aProps.length(${aProps.length}):`, aProps);
             debugLog(`- bProps.length(${bProps.length}):`, bProps);
             return false;
         }
-        // Check each property in 'a' to see if it's in 'b' and if it's equal (deep check)
         for (const prop of aProps) {
             if (!Object.prototype.hasOwnProperty.call(b, prop)) {
                 debugLog(`deepEqual false for !b.hasOwnProperty(${prop})`);
                 return false;
             }
             if (!deepEqual(a[prop], b[prop], excludeProperties)) {
-                debugLog(`deepEqual false for !deepEqual(a[${prop}], b[${prop}])` /* , a[prop], b[prop]*/);
+                debugLog(`deepEqual false for !deepEqual(a[${prop}], b[${prop}])`);
                 return false;
             }
         }
         return true;
     }
-    // If none of the above, the objects are not equal
     return false;
 }
-/**
- * Creates a deep copy of the given value.
- *
- * @template T - The type of the value being copied.
- * @param {T} value - The value to be copied.
- * @returns {T} - The deep copy of the value.
- */
 export function deepCopy(value) {
     if (typeof value !== 'object' || value === null) {
-        // Primitive value (string, number, boolean, bigint, undefined, symbol) or null
         return value;
     }
     else if (Array.isArray(value)) {
-        // Array: Recursively copy each element
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return value.map((item) => deepCopy(item));
     }
     else if (value instanceof Date) {
-        // Date objects
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return new Date(value.getTime());
     }
     else if (value instanceof Map) {
-        // Maps
         const mapCopy = new Map();
         value.forEach((val, key) => {
             mapCopy.set(key, deepCopy(val));
         });
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return mapCopy;
     }
     else if (value instanceof Set) {
-        // Sets
         const setCopy = new Set();
         value.forEach((item) => {
             setCopy.add(deepCopy(item));
         });
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return setCopy;
     }
     else {
-        // Objects: Create a copy with the same prototype as the original
         const proto = Object.getPrototypeOf(value);
         const copy = Object.create(proto);
         for (const key in value) {
@@ -182,14 +96,9 @@ export function deepCopy(value) {
         return copy;
     }
 }
-/**
- * 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.
- */
 export function getIpv4InterfaceAddress() {
     let ipv4Address;
     const networkInterfaces = os.networkInterfaces();
-    // console.log('Available Network Interfaces:', networkInterfaces);
     for (const interfaceDetails of Object.values(networkInterfaces)) {
         if (!interfaceDetails) {
             break;
@@ -203,17 +112,11 @@ export function getIpv4InterfaceAddress() {
             break;
         }
     }
-    // console.log('Selected Network Interfaces:', ipv4Address);
     return ipv4Address;
 }
-/**
- * Retrieves the IPv6 address of the first non-internal network interface.
- * @returns {string | undefined} The IPv4 address of the selected network interface, or undefined if not found.
- */
 export function getIpv6InterfaceAddress() {
     let ipv6Address;
     const networkInterfaces = os.networkInterfaces();
-    // console.log('Available Network Interfaces:', networkInterfaces);
     for (const interfaceDetails of Object.values(networkInterfaces)) {
         if (!interfaceDetails) {
             break;
@@ -227,17 +130,11 @@ export function getIpv6InterfaceAddress() {
             break;
         }
     }
-    // console.log('Selected Network Interfaces:', ipv6Address);
     return ipv6Address;
 }
-/**
- * Retrieves the mac address of the first non-internal network interface.
- * @returns {string | undefined} The IPv4 address of the selected network interface, or undefined if not found.
- */
 export function getMacAddress() {
     let macAddress;
     const networkInterfaces = os.networkInterfaces();
-    // console.log('Available Network Interfaces:', networkInterfaces);
     for (const interfaceDetails of Object.values(networkInterfaces)) {
         if (!interfaceDetails) {
             break;
@@ -253,25 +150,10 @@ export function getMacAddress() {
     }
     return macAddress;
 }
-/**
- * Checks if a given string is a valid IPv4 address.
- *
- * @param {string} ipv4Address - The string to be checked.
- * @returns {boolean} - Returns true if the string is a valid IPv4 address, otherwise returns false.
- */
 export function isValidIpv4Address(ipv4Address) {
     const ipv4Regex = /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
     return ipv4Regex.test(ipv4Address);
 }
-/**
- * Checks if a value is a valid number within the specified range.
- *
- * @param {any} value - The value to be checked.
- * @param {number} min - The minimum value allowed (optional).
- * @param {number} max - The maximum value allowed (optional).
- * @returns {boolean} Returns true if the value is a valid number within the specified range, otherwise false.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function isValidNumber(value, min, max) {
     if (value === undefined || value === null || typeof value !== 'number' || Number.isNaN(value))
         return false;
@@ -281,25 +163,9 @@ export function isValidNumber(value, min, max) {
         return false;
     return true;
 }
-/**
- * Checks if a value is a valid boolean.
- *
- * @param {any} value - The value to be checked.
- * @returns {boolean} `true` if the value is a valid boolean, `false` otherwise.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function isValidBoolean(value) {
     return value !== undefined && value !== null && typeof value === 'boolean';
 }
-/**
- * Checks if a value is a valid string.
- *
- * @param {any} value - The value to be checked.
- * @param {number} minLength - The min string length (optional).
- * @param {number} maxLength - The max string length (optional).
- * @returns {boolean} A boolean indicating whether the value is a valid string.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function isValidString(value, minLength, maxLength) {
     if (value === undefined || value === null || typeof value !== 'string')
         return false;
@@ -309,15 +175,6 @@ export function isValidString(value, minLength, maxLength) {
         return false;
     return true;
 }
-/**
- * Checks if a value is a valid object.
- *
- * @param {any} value - The value to be checked.
- * @param {number} minLength - The min number of keys (optional).
- * @param {number} maxLength - The max number of keys (optional).
- * @returns {boolean} A boolean indicating whether the value is a valid object.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function isValidObject(value, minLength, maxLength) {
     if (value === undefined || value === null || typeof value !== 'object' || Array.isArray(value))
         return false;
@@ -328,15 +185,6 @@ export function isValidObject(value, minLength, maxLength) {
         return false;
     return true;
 }
-/**
- * Checks if a value is a valid array.
- *
- * @param {any} value - The value to be checked.
- * @param {number} minLength - The min number of elements (optional).
- * @param {number} maxLength - The max number of elements (optional).
- * @returns {boolean} A boolean indicating whether the value is a valid array.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function isValidArray(value, minLength, maxLength) {
     if (value === undefined || value === null || !Array.isArray(value))
         return false;
@@ -346,33 +194,14 @@ export function isValidArray(value, minLength, maxLength) {
         return false;
     return true;
 }
-/**
- * Checks if the given value is null.
- *
- * @param {any} value - The value to check.
- * @returns {boolean} `true` if the value is null, `false` otherwise.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function isValidNull(value) {
     return value === null;
 }
-/**
- * Checks if a value is undefined.
- *
- * @param {any} value - The value to check.
- * @returns {boolean} `true` if the value is undefined, `false` otherwise.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function isValidUndefined(value) {
     return value === undefined;
 }
-/**
- * Logs the available network interfaces and their details.
- * @param {boolean} log - Whether to enable logging of network interface details.
- * @returns {string | undefined} The IPv6 address of the network interface, if available.
- */
 export function logInterfaces(debug = true) {
-    log.logLevel = LogLevel.INFO;
+    log.logLevel = "info";
     log.logName = 'LogInterfaces';
     let ipv6Address;
     const networkInterfaces = os.networkInterfaces();
@@ -390,18 +219,8 @@ export function logInterfaces(debug = true) {
     }
     return ipv6Address;
 }
-/**
- * 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=false] - Optional. If true, the promise will be rejected on timeout. Default is false.
- * @param {number} [resolveTimeout=5000] - Optional. The timeout duration in milliseconds. Default is 5000ms.
- * @param {number} [resolveInterval=500] - Optional. The interval duration in milliseconds between condition checks. Default is 500ms.
- * @param {boolean} [debug=false] - 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) {
-    log.logLevel = LogLevel.DEBUG;
+    log.logLevel = "debug";
     log.logName = 'Waiter';
     if (debug)
         log.debug(`Waiter "${name}" started...`);
@@ -427,19 +246,11 @@ export async function waiter(name, check, exitWithReject = false, resolveTimeout
         }, resolveInterval);
     });
 }
-/**
- * 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) {
-    log.logLevel = LogLevel.DEBUG;
+    log.logLevel = "debug";
     log.logName = 'Wait';
     if (debug)
         log.debug(`Wait "${name}" started...`);
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     return new Promise((resolve, reject) => {
         const timeoutId = setTimeout(() => {
             if (debug)
@@ -449,28 +260,16 @@ export async function wait(timeout = 1000, name, debug = false) {
         }, timeout);
     });
 }
-/**
- * Creates a ZIP archive from the specified source pattern or directory and writes it to the specified output path.
- *
- * @param {string} outputPath - The path where the output ZIP file will be written.
- * @param {string[]} sourcePaths - The source pattern or directory to be zipped (use path.join for sourcePath).
- * @returns {Promise<number>} - A promise that resolves to the total number of bytes written to the ZIP file.
- *
- * @remarks
- * This function uses the `archiver` library to create a ZIP archive. It sets the compression level to 9 (maximum compression).
- * The function ensures that the output file is properly closed after the archiving process is complete.
- * It logs the progress and the total number of bytes written to the console.
- *
- * This function uses the `glob` library to match files based on the source pattern (internally converted in posix).
- */
 export async function createZip(outputPath, ...sourcePaths) {
-    log.logLevel = LogLevel.INFO;
+    const { default: archiver } = await import('archiver');
+    const { glob } = await import('glob');
+    log.logLevel = "info";
     log.logName = 'Archive';
     log.debug(`creating archive ${outputPath} from ${sourcePaths.join(', ')} ...`);
     return new Promise((resolve, reject) => {
         const output = createWriteStream(outputPath);
         const archive = archiver('zip', {
-            zlib: { level: 9 }, // Set compression level
+            zlib: { level: 9 },
         });
         output.on('close', () => {
             log.debug(`archive ${outputPath} closed with ${archive.pointer()} total bytes`);
@@ -497,7 +296,6 @@ export async function createZip(outputPath, ...sourcePaths) {
         });
         archive.pipe(output);
         for (const sourcePath of sourcePaths) {
-            // Check if the sourcePath is a file or directory
             let stats;
             try {
                 stats = statSync(sourcePath);
@@ -525,35 +323,22 @@ export async function createZip(outputPath, ...sourcePaths) {
                 archive.directory(sourcePath, path.basename(sourcePath));
             }
         }
-        // Finalize the archive (i.e., we are done appending files but streams have to finish yet)
         log.debug(`finalizing archive ${outputPath}...`);
         archive.finalize().catch(reject);
     });
 }
-/**
- * Copies a directory and all its subdirectories and files to a new location.
- *
- * @param {string} srcDir - The path to the source directory.
- * @param {string} destDir - The path to the destination directory.
- * @returns {Promise<boolean>} - A promise that resolves when the copy operation is complete or fails for error.
- * @throws {Error} - Throws an error if the copy operation fails.
- */
 export async function copyDirectory(srcDir, destDir) {
     log.debug(`copyDirectory: copying directory from ${srcDir} to ${destDir}`);
     try {
-        // Create destination directory if it doesn't exist
         await fs.mkdir(destDir, { recursive: true });
-        // Read contents of the source directory
         const entries = await fs.readdir(srcDir, { withFileTypes: true });
         for (const entry of entries) {
             const srcPath = path.join(srcDir, entry.name);
             const destPath = path.join(destDir, entry.name);
             if (entry.isDirectory()) {
-                // Recursive call if entry is a directory
                 await copyDirectory(srcPath, destPath);
             }
             else if (entry.isFile()) {
-                // Copy file if entry is a file
                 await fs.copyFile(srcPath, destPath);
             }
         }
@@ -564,32 +349,15 @@ export async function copyDirectory(srcDir, destDir) {
         return false;
     }
 }
-/**
- * Resolves the given hostname to an IP address.
- *
- * @param {string} hostname - The hostname to resolve.
- * @param {0 | 4 | 6} [family=4] - 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) {
     try {
         const addresses = await dns.promises.lookup(hostname.toLowerCase() + '.local', { family });
         return addresses.address;
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
     }
     catch (error) {
         return null;
     }
 }
-/**
- * Retrieves the value of a command-line parameter.
- *
- * @param {string} name - The name of the parameter to retrieve.
- * @returns {string | undefined} The value of the parameter, or undefined if not found.
- */
 export function getParameter(name) {
     const commandArguments = process.argv.slice(2);
     let markerIndex = commandArguments.indexOf(`-${name}`);
@@ -599,12 +367,6 @@ export function getParameter(name) {
         return undefined;
     return commandArguments[markerIndex + 1];
 }
-/**
- * Checks if a command-line parameter is present.
- *
- * @param {string} name - The name of the parameter to check.
- * @returns {boolean} True if the parameter is present, otherwise false.
- */
 export function hasParameter(name) {
     const commandArguments = process.argv.slice(2);
     let markerIncluded = commandArguments.includes(`-${name}`);
@@ -612,12 +374,6 @@ export function hasParameter(name) {
         markerIncluded = commandArguments.includes(`--${name}`);
     return markerIncluded;
 }
-/**
- * Retrieves the value of a command-line parameter as an integer.
- *
- * @param {string} name - The name of the parameter to retrieve.
- * @returns {number | undefined} The integer value of the parameter, or undefined if not found or invalid.
- */
 export function getIntParameter(name) {
     const value = getParameter(name);
     if (value === undefined)
@@ -627,4 +383,3 @@ export function getIntParameter(name) {
         return undefined;
     return intValue;
 }
-//# sourceMappingURL=utils.js.map

package/frontend/build/asset-manifest.json

@@ -1,7 +1,7 @@
 {
   "files": {
     "main.css": "./static/css/main.cf25d33e.css",
-    "main.js": "./static/js/main.ea28015b.js",
+    "main.js": "./static/js/main.26dbf9b9.js",
     "static/js/453.abd36b29.chunk.js": "./static/js/453.abd36b29.chunk.js",
     "static/media/roboto-latin-700-normal.woff2": "./static/media/roboto-latin-700-normal.4535474e1cf8598695ad.woff2",
     "static/media/roboto-latin-500-normal.woff2": "./static/media/roboto-latin-500-normal.7077203b1982951ecf76.woff2",
@@ -61,11 +61,11 @@
     "static/media/roboto-greek-ext-400-normal.woff": "./static/media/roboto-greek-ext-400-normal.16eb83b4a3b1ea994243.woff",
     "index.html": "./index.html",
     "main.cf25d33e.css.map": "./static/css/main.cf25d33e.css.map",
-    "main.ea28015b.js.map": "./static/js/main.ea28015b.js.map",
+    "main.26dbf9b9.js.map": "./static/js/main.26dbf9b9.js.map",
     "453.abd36b29.chunk.js.map": "./static/js/453.abd36b29.chunk.js.map"
   },
   "entrypoints": [
     "static/css/main.cf25d33e.css",
-    "static/js/main.ea28015b.js"
+    "static/js/main.26dbf9b9.js"
   ]
 }

package/frontend/build/index.html

@@ -1 +1 @@
-<!doctype html><html lang="en"><head><meta charset="utf-8"/><base href="./"><link rel="icon" href="./matterbridge 32x32.png"/><meta name="viewport" content="width=device-width,initial-scale=1"/><meta name="theme-color" content="#000000"/><title>Matterbridge</title><link rel="manifest" href="./manifest.json"/><script defer="defer" src="./static/js/main.ea28015b.js"></script><link href="./static/css/main.cf25d33e.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>
+<!doctype html><html lang="en"><head><meta charset="utf-8"/><base href="./"><link rel="icon" href="./matterbridge 32x32.png"/><meta name="viewport" content="width=device-width,initial-scale=1"/><meta name="theme-color" content="#000000"/><title>Matterbridge</title><link rel="manifest" href="./manifest.json"/><script defer="defer" src="./static/js/main.26dbf9b9.js"></script><link href="./static/css/main.cf25d33e.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>