matterbridge 2.1.6-dev.5 → 2.1.6-dev.7

package/CHANGELOG.md

@@ -1,4 +1,4 @@
-# <img src="https://github.com/Luligu/matterbridge/blob/main/frontend/public/matterbridge%2064x64.png" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge changelog
+# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge changelog
 
 All notable changes to this project will be documented in this file.
 
@@ -33,16 +33,19 @@ matterbridge-zigbee2mqtt v. 2.4.4
 matterbridge-somfy-tahoma v. 1.2.3
 matterbridge-hass v. 0.0.8
 
-## [2.1.6] - 2025-02-15
+## [2.1.6] - 2025-02-20
 
 ### Added
 
-- [docker]: Added health check directly in the docker image. No need to change configuration.
+- [docker]: Added health check directly in the docker image. No need to change configuration of docker compose.
 - [platform]: Saving in the storage the selects for faster loading of plugins.
 - [icon]: Added matterbridge svg icon (thanks: https://github.com/robvanoostenrijk https://github.com/stuntguy3000).
-- [frontend]: Added processUptime.
+- [pluginManager]: Refactor PluginManager to optimize memory and load time.
 - [frontend]: Frontend v.2.4.2.
-- [PluginManager]: Refactor PluginManager to optimize memory and load time.
+- [frontend]: Added processUptime.
+- [frontend]: Added Share fabrics and Stop sharing to the menu. This allows to pair other controllers without the need to share from the first controller.
+- [frontend]: Added subscriptions to QRDiv.
+- [utils]: Optimized memory and loading time.
 
 ### Changed
 
@@ -51,6 +54,10 @@ matterbridge-hass v. 0.0.8
 - [package]: Update matter.js to 0.12.4-alpha.0-20250215-5af08a8d6
 - [package]: Update matter.js to 0.12.4-alpha.0-20250217-b0bba5179
 
+### Fixed
+
+- [matterbridge]: Check endpoint state in /api/devices.
+
 <a href="https://www.buymeacoffee.com/luligugithub">
   <img src="./yellow-button.png" alt="Buy me a coffee" width="120">
 </a>
@@ -260,7 +267,7 @@ matterbridge-hass v. 0.0.8
 
 ### Added
 
-- [edge]: Added guide https://github.com/Luligu/matterbridge/blob/dev/README-EDGE.md.
+- [edge]: Added guide [README-EDGE.md](README-EDGE.md).
 - [storage]: Added conversion from old matter storage to the new api format with fabrics, resumptionRecords, network, commissioning, operationalCredentials, acl and parts number. The conversion is triggered every time you shutdown or restart matterbridge till the new storage has been used with matterbridge edge.
 - [storage]: Added conversion for child endpoint numbers.
 - [storage]: Added conversion for childbridge mode.
@@ -397,7 +404,7 @@ It is possible that some controllers see them as new devices or need time to rea
 ### Added
 
 - [matter.js]: Almost completed the phase 2 of migration to edge (matter.js new API).
-- [nginx]: Added the route /matterbridge/ to be used with nginx proxy server https://github.com/Luligu/matterbridge/blob/dev/README-NGINX.md.
+- [nginx]: Added the route /matterbridge/ to be used with nginx proxy server [README-NGINX.md](README-NGINX.md).
 - [config]: Config and schema are loaded before loading the plugin to allow to configure the plugin even when it throws error on load.
 - [config]: Added version to the config.
 - [frontend]: Added badge "edge" when running in edge mode.
@@ -601,7 +608,7 @@ It is possible that some controllers see them as new devices or need time to rea
 
 ### Breaking Changes for developers
 
-- please read this [Development guide lines](https://github.com/Luligu/matterbridge/blob/main/README-DEV.md)
+- please read this [Development guide lines](README-DEV.md)
 
 ### Added
 

package/README-DEV.md

@@ -1,4 +1,4 @@
-# <img src="https://github.com/Luligu/matterbridge/blob/main/frontend/public/matterbridge%2064x64.png" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
+# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)

package/README-DOCKER.md

@@ -1,4 +1,4 @@
-# <img src="https://github.com/Luligu/matterbridge/blob/main/frontend/public/matterbridge%2064x64.png" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
+# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)

package/README-EDGE.md

@@ -1,4 +1,4 @@
-# <img src="https://github.com/Luligu/matterbridge/blob/main/frontend/public/matterbridge%2064x64.png" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge edge
+# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge edge
 
 Matterbridge Edge is the version of Matterbridge running with the new Matter.js API.
 

package/README-NGINX.md

@@ -1,4 +1,4 @@
-# <img src="https://github.com/Luligu/matterbridge/blob/main/frontend/public/matterbridge%2064x64.png" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
+# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)

package/README-PODMAN.md

@@ -1,4 +1,4 @@
-# <img src="https://github.com/Luligu/matterbridge/blob/main/frontend/public/matterbridge%2064x64.png" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
+# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)

package/README-SERVICE.md

@@ -1,4 +1,4 @@
-# <img src="https://github.com/Luligu/matterbridge/blob/main/frontend/public/matterbridge%2064x64.png" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
+# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)

package/README.md

@@ -1,4 +1,4 @@
-# <img src="https://github.com/Luligu/matterbridge/blob/main/frontend/public/matterbridge%2064x64.png" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
+# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge
 
 [![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
 [![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
@@ -48,6 +48,7 @@ To run Matterbridge, you need either a [Node.js](https://nodejs.org/en) environm
 
 If you don't have Node.js already install, please use this method to install it on a debian device: https://github.com/nodesource/distributions.
 The supported versions of node are 18, 20 and 22. Please install node 22 LTS.
+Node 23 is not supported.
 Nvm is not a good choice and should not be used for production.
 
 If you don't have Docker already install, please use this method to install it on a debian device: https://docs.docker.com/desktop/setup/install/linux/debian/.
@@ -121,34 +122,34 @@ To use the frontend with ssl place the certificates in the .matterbridge/certs d
 From the frontend you can do all operations in an easy way.
 
 Home page:
-![See the screenshot here](https://github.com/Luligu/matterbridge/blob/main/screenshot/Screenshot%20home.jpg)
+![See the screenshot here](screenshot/Screenshot%20home.jpg)
 
 Devices page:
-[See the screenshot here](https://github.com/Luligu/matterbridge/blob/main/screenshot/Screenshot%20devices.jpg)
+[See the screenshot here](screenshot/Screenshot%20devices.jpg)
 
 Logs page:
-[See the screenshot here](https://github.com/Luligu/matterbridge/blob/main/screenshot/Screenshot%20logs.jpg)
+[See the screenshot here](screenshot/Screenshot%20logs.jpg)
 
 Config editor:
-[See the screenshot here](https://github.com/Luligu/matterbridge/blob/main/screenshot/Screenshot%20config%20editor.jpg)
+[See the screenshot here](screenshot/Screenshot%20config%20editor.jpg)
 
 ## Advanced configurations
 
 ### Run matterbridge as a daemon with systemctl (Linux only)
 
-[Service configurations](https://github.com/Luligu/matterbridge/blob/main/README-SERVICE.md)
+[Service configurations](README-SERVICE.md)
 
 ### Run matterbridge with docker and docker compose
 
-[Docker configurations](https://github.com/Luligu/matterbridge/blob/main/README-DOCKER.md)
+[Docker configurations](README-DOCKER.md)
 
 ### Run matterbridge with podman
 
-[Podman configurations](https://github.com/Luligu/matterbridge/blob/main/README-PODMAN.md)
+[Podman configurations](README-PODMAN.md)
 
 ### Run matterbridge with nginx
 
-[Nginx configurations](https://github.com/Luligu/matterbridge/blob/main/README-NGINX.md)
+[Nginx configurations](README-NGINX.md)
 
 ### Run matterbridge as an home assistant add-on with the official add-on
 
@@ -160,14 +161,14 @@ The other Home Assistant Community Add-ons and plugins are not verified to work
 
 ## Development
 
-[Development](https://github.com/Luligu/matterbridge/blob/main/README-DEV.md)
+[Development](README-DEV.md)
 
 ## Plugins
 
 ### Shelly
 
 <a href="https://github.com/Luligu/matterbridge-shelly">
-  <img src="https://github.com/Luligu/matterbridge/blob/dev/screenshot/Shelly.png" alt="Shelly plugin logo" width="100" />
+  <img src="screenshot/Shelly.svg" alt="Shelly plugin logo" width="100" />
 </a>
 
 Matterbridge shelly plugin allows you to expose all Shelly Gen 1, Gen 2, Gen 3 and BLU devices to Matter.
@@ -196,7 +197,7 @@ Features:
 ### Zigbee2MQTT
 
 <a href="https://github.com/Luligu/matterbridge-zigbee2mqtt">
-  <img src="https://github.com/Luligu/matterbridge/blob/dev/screenshot/Zigbee2MQTT.png" alt="Zigbee2MQTT plugin logo" width="100" />
+  <img src="screenshot/Zigbee2MQTT.svg" alt="Zigbee2MQTT plugin logo" width="100" />
 </a>
 
 Matterbridge zigbee2mqtt is a matterbridge production-level plugin that expose all zigbee2mqtt devices and groups to Matter.
@@ -206,7 +207,7 @@ No hub or dedicated hardware needed.
 ### Somfy tahoma
 
 <a href="https://github.com/Luligu/matterbridge-somfy-tahoma">
-  <img src="https://github.com/Luligu/matterbridge/blob/dev/screenshot/Somfy.png" alt="Somfy plugin logo" width="100" />
+  <img src="screenshot/Somfy.svg" alt="Somfy plugin logo" width="100" />
 </a>
 
 Matterbridge Somfy Tahoma is a matterbridge production-level plugin that expose the Somfy Tahoma screen devices to Matter.
@@ -351,7 +352,7 @@ Place your own certificates in the `.matterbridge/cert` directory:
 - `key.pem`
 - `ca.pem` (optional)
 
-![image](https://github.com/user-attachments/assets/846785ca-6f5c-458b-b786-a6417a4da319)
+![image](screenshot/Screenshot%20Certificates.png)
 
 ### Change the command line
 
@@ -365,7 +366,7 @@ matterbridge -ssl -frontend 443
 
 If the certificate are correctly configured, you will be able to connect with https to the frontend.
 
-![image](https://github.com/user-attachments/assets/9c38776d-064f-4d91-9359-a2cd3319b1ff)
+![image](screenshot/Screenshot%20Browser%20Secured.png)
 
 ## How to send the debug log files
 
@@ -373,9 +374,9 @@ If the certificate are correctly configured, you will be able to connect with ht
 
 In the frontend, go to settings and enable debug mode as shown below:
 
-![Debug Matterbridge Settings](https://github.com/user-attachments/assets/83181dc2-969a-4b71-aff4-f1498fa1d665)
+![Debug Matterbridge Settings](screenshot/Screenshot%20Matterbridge%20Logger%20Debug.png)
 
-![Debug Matter Settings](https://github.com/user-attachments/assets/617961a9-7cb0-46cf-9878-981f61738f8c)
+![Debug Matter Settings](screenshot/Screenshot%20Matter%20Logger%20Debug.png)
 
 ### Restart
 
@@ -383,7 +384,7 @@ Wait a few minutes to allow the logs to to accumulate.
 
 Then, from the dots menu in the frontend, download the `matterbridge.log` and `matter.log` files.
 
-![image](https://github.com/user-attachments/assets/04ba65f6-594a-4ff8-9732-3df049f5a33e)
+![image](screenshot/Screenshot%20Debug%20Download%20Logs.png)
 
 # Known general issues
 

package/dist/cli.js

@@ -177,7 +177,7 @@ async function main() {
     log.debug(`***Matterbridge.loadInstance(true) called`);
     instance = await Matterbridge.loadInstance(true);
     log.debug(`***Matterbridge.loadInstance(true) exited`);
-    if (instance.shutdown) {
+    if (!instance || instance.shutdown) {
         shutdown();
     }
     else {

package/dist/frontend.js

@@ -269,7 +269,7 @@ export class Frontend {
             this.log.debug('The frontend sent /api/devices');
             const devices = [];
             this.matterbridge.devices.forEach(async (device) => {
-                if (!device.plugin || !device.name || !device.deviceName || !device.serialNumber || !device.uniqueId)
+                if (!device.plugin || !device.name || !device.deviceName || !device.serialNumber || !device.uniqueId || !device.lifecycle.isReady)
                     return;
                 const cluster = this.getClusterTextFromDevice(device);
                 devices.push({
@@ -1087,9 +1087,22 @@ export class Frontend {
             }
             else if (data.method === '/api/advertise') {
                 const pairingCodes = await this.matterbridge.advertiseServerNode(this.matterbridge.serverNode);
+                this.matterbridge.matterbridgeInformation.matterbridgeAdvertise = true;
+                this.matterbridge.matterbridgeQrPairingCode = pairingCodes?.qrPairingCode;
+                this.matterbridge.matterbridgeManualPairingCode = pairingCodes?.manualPairingCode;
+                this.wssSendRefreshRequired();
+                this.wssSendSnackbarMessage(`Started fabrics share`, 0);
                 client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, response: pairingCodes }));
                 return;
             }
+            else if (data.method === '/api/stopadvertise') {
+                await this.matterbridge.stopAdvertiseServerNode(this.matterbridge.serverNode);
+                this.matterbridge.matterbridgeInformation.matterbridgeAdvertise = false;
+                this.wssSendRefreshRequired();
+                this.wssSendSnackbarMessage(`Stopped fabrics share`, 0);
+                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src }));
+                return;
+            }
             else if (data.method === '/api/settings') {
                 client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, response: await this.getApiSettings() }));
                 return;
@@ -1104,7 +1117,7 @@ export class Frontend {
                 this.matterbridge.devices.forEach(async (device) => {
                     if (data.params.pluginName && data.params.pluginName !== device.plugin)
                         return;
-                    if (!device.plugin || !device.name || !device.deviceName || !device.serialNumber || !device.uniqueId)
+                    if (!device.plugin || !device.name || !device.deviceName || !device.serialNumber || !device.uniqueId || !device.lifecycle.isReady)
                         return;
                     const cluster = this.getClusterTextFromDevice(device);
                     devices.push({

package/dist/matterbridge.js

@@ -4,8 +4,8 @@ import { promises as fs } from 'node:fs';
 import EventEmitter from 'node:events';
 import { AnsiLogger, UNDERLINE, UNDERLINEOFF, YELLOW, db, debugStringify, BRIGHT, RESET, er, nf, rs, wr, RED, GREEN, zb, CYAN, nt } from './logger/export.js';
 import { NodeStorageManager } from './storage/export.js';
-import { getParameter, getIntParameter, hasParameter } from './utils/export.js';
-import { logInterfaces, copyDirectory, getNpmPackageVersion, getGlobalNodeModules } from './utils/utils.js';
+import { getParameter, getIntParameter, hasParameter, copyDirectory, withTimeout } from './utils/export.js';
+import { logInterfaces, getNpmPackageVersion, getGlobalNodeModules } from './utils/network.js';
 import { PluginManager } from './pluginManager.js';
 import { DeviceManager } from './deviceManager.js';
 import { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
@@ -52,6 +52,7 @@ export class Matterbridge extends EventEmitter {
         matterbridgeFabricInformations: [],
         matterbridgeSessionInformations: [],
         matterbridgePaired: false,
+        matterbridgeAdvertise: false,
         bridgeMode: '',
         restartMode: '',
         readOnly: hasParameter('readonly'),
@@ -251,7 +252,7 @@ export class Matterbridge extends EventEmitter {
         this.port = getIntParameter('port') ?? (await this.nodeContext.get('matterport', 5540)) ?? 5540;
         this.passcode = getIntParameter('passcode') ?? (await this.nodeContext.get('matterpasscode')) ?? PaseClient.generateRandomPasscode();
         this.discriminator = getIntParameter('discriminator') ?? (await this.nodeContext.get('matterdiscriminator')) ?? PaseClient.generateRandomDiscriminator();
-        this.log.debug(`Initializing commissioning server for Matterbridge... on port ${this.port} with passcode ${this.passcode} and discriminator ${this.discriminator}`);
+        this.log.debug(`Initializing server node for Matterbridge... on port ${this.port} with passcode ${this.passcode} and discriminator ${this.discriminator}`);
         if (hasParameter('logger')) {
             const level = getParameter('logger');
             if (level === 'debug') {
@@ -289,6 +290,8 @@ export class Matterbridge extends EventEmitter {
         }
         this.log.notice('Matterbridge is starting...');
         this.log.debug(`Matterbridge logLevel: ${this.log.logLevel} fileLoger: ${this.matterbridgeInformation.fileLogger}.`);
+        if (this.profile !== undefined)
+            this.log.debug(`Matterbridge profile: ${this.profile}.`);
         if (hasParameter('matterlogger')) {
             const level = getParameter('matterlogger');
             if (level === 'debug') {
@@ -517,6 +520,7 @@ export class Matterbridge extends EventEmitter {
             return;
         }
         if (hasParameter('factoryreset')) {
+            this.initialized = true;
             await this.shutdownProcessAndFactoryReset();
             this.shutdown = true;
             return;
@@ -529,6 +533,7 @@ export class Matterbridge extends EventEmitter {
             throw new Error(`Fatal error creating matter storage: ${error instanceof Error ? error.message : error}`);
         }
         if (hasParameter('reset') && getParameter('reset') === undefined) {
+            this.initialized = true;
             await this.shutdownProcessAndReset();
             this.shutdown = true;
             return;
@@ -1526,20 +1531,6 @@ export class Matterbridge extends EventEmitter {
         if (!matterServerNode)
             return;
         this.log.notice(`Closing ${matterServerNode.id} server node`);
-        const withTimeout = (promise, ms) => {
-            return new Promise((resolve, reject) => {
-                const timer = setTimeout(() => reject(new Error('Operation timed out')), ms);
-                promise
-                    .then((result) => {
-                    clearTimeout(timer);
-                    resolve(result);
-                })
-                    .catch((error) => {
-                    clearTimeout(timer);
-                    reject(error);
-                });
-            });
-        };
         try {
             await withTimeout(matterServerNode.close(), 30000);
             this.log.info(`Closed ${matterServerNode.id} server node`);
@@ -1552,7 +1543,7 @@ export class Matterbridge extends EventEmitter {
         if (matterServerNode) {
             await matterServerNode.env.get(DeviceCommissioner)?.allowBasicCommissioning();
             const { qrPairingCode, manualPairingCode } = matterServerNode.state.commissioning.pairingCodes;
-            this.log.notice(`Advertising for ${matterServerNode.id} is now started with the following pairing codes: qrPairingCode ${qrPairingCode}, manualPairingCode ${manualPairingCode}`);
+            this.log.notice(`Started advertising for ${matterServerNode.id} with the following pairing codes: qrPairingCode ${qrPairingCode}, manualPairingCode ${manualPairingCode}`);
             return { qrPairingCode, manualPairingCode };
         }
     }

package/dist/matterbridgePlatform.js

@@ -25,7 +25,7 @@ export class MatterbridgePlatform {
         this.log = log;
         this.config = config;
         if (!isValidString(this.config.name) || this.config.name === '')
-            return;
+            throw new Error('Platform: the plugin name is missing or invalid.');
         this.log.debug(`Creating storage for plugin ${this.config.name} in ${path.join(this.matterbridge.matterbridgeDirectory, this.config.name)}`);
         this.storage = new NodeStorageManager({
             dir: path.join(this.matterbridge.matterbridgeDirectory, this.config.name),
@@ -37,8 +37,8 @@ export class MatterbridgePlatform {
         this.log.debug(`Creating context for plugin ${this.config.name}`);
         this.contextReady = this.storage.createStorage('context').then((context) => {
             this.context = context;
+            this.context.remove('endpointMap');
             this.log.debug(`Created context for plugin ${this.config.name}`);
-            return context;
         });
         this.log.debug(`Loading selectDevice for plugin ${this.config.name}`);
         this.selectDeviceContextReady = this.storage.createStorage('selectDevice').then(async (context) => {
@@ -83,13 +83,9 @@ export class MatterbridgePlatform {
         this.selectEntity.clear();
         this.registeredEndpoints.clear();
         this.registeredEndpointsByName.clear();
-        this.contextReady = undefined;
-        this.selectDeviceContextReady = undefined;
-        this.selectEntityContextReady = undefined;
         await this.context?.close();
         this.context = undefined;
         await this.storage?.close();
-        this.storage = undefined;
     }
     async onChangeLoggerLevel(logLevel) {
         this.log.debug(`The plugin doesn't override onChangeLoggerLevel. Logger level set to: ${logLevel}`);

package/dist/pluginManager.js

@@ -454,8 +454,6 @@ export class PluginManager {
                 plugin.loaded = true;
                 plugin.registeredDevices = 0;
                 plugin.addedDevices = 0;
-                plugin.configJson = config;
-                plugin.schemaJson = await this.loadSchema(plugin);
                 await this.saveToStorage();
                 this.log.notice(`Loaded plugin ${plg}${plugin.name}${nt} type ${typ}${platform.type}${nt} (entrypoint ${UNDERLINE}${pluginEntry}${UNDERLINEOFF})`);
                 if (start)

package/dist/utils/copyDirectory.js

@@ -0,0 +1,26 @@
+import { AnsiLogger } from '../logger/export.js';
+export async function copyDirectory(srcDir, destDir) {
+    const log = new AnsiLogger({ logName: 'Archive', logTimestampFormat: 4, logLevel: "info" });
+    const fs = await import('node:fs').then((mod) => mod.promises);
+    const path = await import('node:path');
+    log.debug(`copyDirectory: copying directory from ${srcDir} to ${destDir}`);
+    try {
+        await fs.mkdir(destDir, { recursive: true });
+        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()) {
+                await copyDirectory(srcPath, destPath);
+            }
+            else if (entry.isFile()) {
+                await fs.copyFile(srcPath, destPath);
+            }
+        }
+        return true;
+    }
+    catch (error) {
+        log.error(`copyDirectory error copying from ${srcDir} to ${destDir}: ${error instanceof Error ? error.message : error}`);
+        return false;
+    }
+}

package/dist/utils/createZip.js

@@ -0,0 +1,69 @@
+import { AnsiLogger } from '../logger/export.js';
+export async function createZip(outputPath, ...sourcePaths) {
+    const log = new AnsiLogger({ logName: 'Archive', logTimestampFormat: 4, logLevel: "info" });
+    const { default: archiver } = await import('archiver');
+    const { glob } = await import('glob');
+    const { createWriteStream, statSync } = await import('node:fs');
+    const path = await import('node:path');
+    log.debug(`creating archive ${outputPath} from ${sourcePaths.join(', ')} ...`);
+    return new Promise((resolve, reject) => {
+        const output = createWriteStream(outputPath);
+        const archive = archiver('zip', {
+            zlib: { level: 9 },
+        });
+        output.on('close', () => {
+            log.debug(`archive ${outputPath} closed with ${archive.pointer()} total bytes`);
+            resolve(archive.pointer());
+        });
+        output.on('end', () => {
+            log.debug(`archive ${outputPath} data has been drained ${archive.pointer()} total bytes`);
+        });
+        archive.on('error', (error) => {
+            log.error(`archive error: ${error.message}`);
+            reject(error);
+        });
+        archive.on('warning', (error) => {
+            if (error.code === 'ENOENT') {
+                log.warn(`archive warning: ${error.message}`);
+            }
+            else {
+                log.error(`archive warning: ${error.message}`);
+                reject(error);
+            }
+        });
+        archive.on('entry', (entry) => {
+            log.debug(`- archive entry: ${entry.name}`);
+        });
+        archive.pipe(output);
+        for (const sourcePath of sourcePaths) {
+            let stats;
+            try {
+                stats = statSync(sourcePath);
+            }
+            catch (error) {
+                if (sourcePath.includes('*')) {
+                    const files = glob.sync(sourcePath.replace(/\\/g, '/'));
+                    log.debug(`adding files matching glob pattern: ${sourcePath}`);
+                    for (const file of files) {
+                        log.debug(`- glob file: ${file}`);
+                        archive.file(file, { name: file });
+                    }
+                }
+                else {
+                    log.error(`no files or directory found for pattern ${sourcePath}: ${error}`);
+                }
+                continue;
+            }
+            if (stats.isFile()) {
+                log.debug(`adding file: ${sourcePath}`);
+                archive.file(sourcePath, { name: path.basename(sourcePath) });
+            }
+            else if (stats.isDirectory()) {
+                log.debug(`adding directory: ${sourcePath}`);
+                archive.directory(sourcePath, path.basename(sourcePath));
+            }
+        }
+        log.debug(`finalizing archive ${outputPath}...`);
+        archive.finalize().catch(reject);
+    });
+}

package/dist/utils/deepCopy.js

@@ -0,0 +1,35 @@
+export function deepCopy(value) {
+    if (typeof value !== 'object' || value === null) {
+        return value;
+    }
+    else if (Array.isArray(value)) {
+        return value.map((item) => deepCopy(item));
+    }
+    else if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    else if (value instanceof Map) {
+        const mapCopy = new Map();
+        value.forEach((val, key) => {
+            mapCopy.set(key, deepCopy(val));
+        });
+        return mapCopy;
+    }
+    else if (value instanceof Set) {
+        const setCopy = new Set();
+        value.forEach((item) => {
+            setCopy.add(deepCopy(item));
+        });
+        return setCopy;
+    }
+    else {
+        const proto = Object.getPrototypeOf(value);
+        const copy = Object.create(proto);
+        for (const key in value) {
+            if (Object.prototype.hasOwnProperty.call(value, key)) {
+                copy[key] = deepCopy(value[key]);
+            }
+        }
+        return copy;
+    }
+}

package/dist/utils/deepEqual.js

@@ -0,0 +1,56 @@
+export function deepEqual(a, b, excludeProperties = []) {
+    const debug = false;
+    const debugLog = (...messages) => {
+        if (debug) {
+            console.log(...messages);
+        }
+    };
+    if (a === b) {
+        return true;
+    }
+    if (typeof a !== typeof b) {
+        debugLog(`deepEqual false for typeof a: ${typeof a} typeof b: ${typeof b}`);
+        return false;
+    }
+    if (a == null || b == null) {
+        debugLog('deepEqual false for == null');
+        return false;
+    }
+    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})`);
+            return false;
+        }
+        for (let i = 0; i < a.length; i++) {
+            if (!deepEqual(a[i], b[i], excludeProperties)) {
+                debugLog('deepEqual false for array !deepEqual(a[i], b[i])');
+                debugLog(`- aProps.length(${a[i]}):`, a[i]);
+                debugLog(`- bProps.length(${b[i]}):`, b[i]);
+                return false;
+            }
+        }
+        return true;
+    }
+    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 (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;
+        }
+        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}])`);
+                return false;
+            }
+        }
+        return true;
+    }
+    return false;
+}

package/dist/utils/export.js

@@ -1,4 +1,9 @@
-export * from './utils.js';
+export * from './network.js';
 export * from './parameter.js';
 export * from './isvalid.js';
 export * from './colorUtils.js';
+export * from './deepCopy.js';
+export * from './deepEqual.js';
+export * from './copyDirectory.js';
+export * from './createZip.js';
+export * from './wait.js';