homebridge-enphase-envoy 10.3.6 → 10.3.8

package/CHANGELOG.md

@@ -9,6 +9,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - after update to v10.0.0 and above the accessory and bridge need to be removed from the homebridge / Home.app and added again
 
+## [10.3.8] - (17.12.2025)
+
+## Changes
+
+- fix [#222](https://github.com/grzegorz914/homebridge-enphase-envoy/issues/222)
+- bump dependencies
+
+## [10.3.7] - (09.12.2025)
+
+## Changes
+
+- moved MQTT to v5
+- cleanup
+
 ## [10.3.5] - (13.11.2025)
 
 ## Changes

package/package.json

@@ -2,7 +2,7 @@
     "private": false,
     "displayName": "Enphase Envoy",
     "name": "homebridge-enphase-envoy",
-    "version": "10.3.6",
+    "version": "10.3.8",
     "description": "Homebridge p7ugin for Photovoltaic Energy System manufactured by Enphase.",
     "license": "MIT",
     "author": "grzegorz914",
@@ -35,10 +35,10 @@
         "node": "^20 || ^22  || ^24 || ^25"
     },
     "dependencies": {
-        "async-mqtt": "^2.6.3",
+        "mqtt": "^5.14.1",
         "axios": "^1.13.2",
         "express": "^5.2.1",
-        "fast-xml-parser": "^5.3.2",
+        "fast-xml-parser": "^5.3.3",
         "fakegato-history": "^0.6.7"
     },
     "keywords": [

package/src/envoydevice.js

@@ -4023,7 +4023,6 @@ class EnvoyDevice extends EventEmitter {
                                 // Update system services
                                 for (const { type, value, valueKey } of characteristics1) {
                                     if (!this.functions.isValidValue(value)) continue;
-                                    this.emit('debug', `Power And Energy, ${measurementType}, power ${valueKey}: ${value}`);
                                     control[valueKey] = value;
                                     this.systemService?.updateCharacteristic(type, value);
                                 };

package/src/mqtt.js

@@ -1,55 +1,103 @@
-import asyncMqtt from 'async-mqtt';
-const { connectAsync } = asyncMqtt;
+import { connect } from 'mqtt';
 import EventEmitter from 'events';
 
 class Mqtt extends EventEmitter {
     constructor(config) {
         super();
+
+        const url = `mqtt://${config.host}:${config.port}`;
+        const subscribeTopic = `${config.prefix}/Set`;
+
         const options = {
             clientId: config.clientId,
             username: config.user,
-            password: config.passwd
+            password: config.passwd,
+            protocolVersion: 5,
+            clean: false,
+            properties: {
+                sessionExpiryInterval: 60 * 60, // 1 hour
+                userProperties: {
+                    source: 'node-client'
+                }
+            }
         };
-        const url = `mqtt://${config.host}:${config.port}`;
-        const subscribeTopic = `${config.prefix}/Set`;
 
-        this.on('connect', async () => {
-            try {
-                //connect
-                this.mqttClient = await connectAsync(url, options);
-                this.emit('connected', 'MQTT Connected');
+        this.mqttClient = connect(url, options);
 
-                //subscribe
-                await this.mqttClient.subscribe(subscribeTopic);
-                this.emit('subscribed', `MQTT Subscribe topic: ${subscribeTopic}`);
+        // === CONNECTED ===
+        this.mqttClient.on('connect', async (packet) => {
+            this.emit('connected', 'MQTT v5 connected.');
 
-                //subscribed message
-                this.mqttClient.on('message', (topic, message) => {
-                    try {
-                        const obj = JSON.parse(message.toString());
-                        if (config.logDebug) this.emit('debug', `MQTT Received topic: ${topic}, message: ${JSON.stringify(obj, null, 2)}`);
-                        const key = Object.keys(obj)[0];
-                        const value = Object.values(obj)[0];
-                        this.emit('set', key, value);
-                    } catch (error) {
-                        if (config.logWarn) this.emit('warn', `MQTT Parse object error: ${error}`);
+            try {
+                const result = await this.mqttClient.subscribeAsync(subscribeTopic, {
+                    qos: 1,
+                    properties: {
+                        userProperties: {
+                            type: 'subscription'
+                        }
                     }
                 });
+
+                // MQTT v5 subscription results contain reason codes
+                if (config.logDebug) this.emit('debug', `Subscribed to ${subscribeTopic}, reason codes: ${JSON.stringify(result)}`);
+                this.emit('subscribed', `MQTT Subscribe topic: ${subscribeTopic}`);
+
+            } catch (error) {
+                if (config.logWarn) this.emit('warn', `MQTT Subscribe error: ${error}`);
+            }
+        });
+
+        // === MESSAGE ===
+        this.mqttClient.on('message', (topic, payload, packet) => {
+            try {
+                const obj = JSON.parse(payload.toString());
+                if (config.logDebug) this.emit('debug', `MQTT Received:\nTopic: ${topic}\nPayload: ${JSON.stringify(obj, null, 2)}\nProperties: ${JSON.stringify(packet.properties, null, 2)}`);
+
+                const key = Object.keys(obj)[0];
+                const value = Object.values(obj)[0];
+                this.emit('set', key, value);
+
             } catch (error) {
-                if (config.logWarn) this.emit('warn', `MQTT Connect error: ${error}`);
+                if (config.logWarn) this.emit('warn', `MQTT Parse error: ${error}`);
             }
-        }).on('publish', async (topic, message) => {
+        });
+
+        // === PUBLISH EVENT ===
+        this.on('publish', async (topic, message) => {
             try {
                 const fullTopic = `${config.prefix}/${topic}`;
-                const publishMessage = JSON.stringify(message, null, 2);
-                await this.mqttClient.publish(fullTopic, publishMessage);
-                if (config.logDebug) this.emit('debug', `MQTT Publish topic: ${fullTopic}, message: ${publishMessage}`);
+                const publishMessage = JSON.stringify(message);
+
+                await this.mqttClient.publishAsync(fullTopic, publishMessage, {
+                    qos: 1,
+                    properties: {
+                        contentType: 'application/json',
+                        userProperties: {
+                            source: 'node',
+                            action: 'set'
+                        }
+                    }
+                });
+
+                if (config.logDebug) this.emit('debug', `MQTT Publish:\nTopic: ${fullTopic}\nPayload: ${publishMessage}`);
             } catch (error) {
                 if (config.logWarn) this.emit('warn', `MQTT Publish error: ${error}`);
             }
         });
 
-        this.emit('connect');
+        // === ERRORS / STATE ===
+        this.mqttClient.on('error', (err) => {
+            this.emit('warn', `MQTT Error: ${err.message}`);
+        });
+
+        this.mqttClient.on('reconnect', () => {
+            if (config.logDebug) this.emit('debug', 'MQTT Reconnecting...');
+        });
+
+        this.mqttClient.on('close', () => {
+            if (config.logDebug) this.emit('debug', 'MQTT Connection closed.');
+        });
     }
 }
+
 export default Mqtt;