homebridge-melcloud-control 4.9.1 → 4.9.2-beta.1

package/CHANGELOG.md

@@ -24,6 +24,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - For plugin < v4.6.0 use Homebridge UI <= v5.5.0
 - For plugin >= v4.6.0 use Homebridge UI >= v5.13.0
 
+# [4.9.2] - (xx.04.2026)
+
+## Changes
+
+- cleanup
+
 # [4.9.1] - (15.04.2026)
 
 ## Changes

package/package.json

@@ -1,7 +1,7 @@
 {
   "displayName": "MELCloud Control",
   "name": "homebridge-melcloud-control",
-  "version": "4.9.1",
+  "version": "4.9.2-beta.1",
   "description": "Homebridge plugin to control Mitsubishi Air Conditioner, Heat Pump and Energy Recovery Ventilation.",
   "license": "MIT",
   "author": "grzegorz914",
@@ -40,7 +40,8 @@
     "axios": "^1.15.0",
     "axios-cookiejar-support": "^6.0.5",
     "tough-cookie": "^6.0.1",
-    "express": "^5.2.1"
+    "express": "^5.2.1",
+    "ws": "^8.20.0"
   },
   "keywords": [
     "homebridge",

package/src/constants.js

@@ -22,10 +22,8 @@ export const ApiUrls = {
     },
     Home: {
         UserAgent: "MonitorAndControl.App.Mobile/52 CFNetwork/3860.400.51 Darwin/25.3.0",
-        Base: "https://melcloudhome.com",
-        BaseMobile: "https://mobile.bff.melcloudhome.com",
+        Base: "https://mobile.bff.melcloudhome.com",
         AuthBase: "https://auth.melcloudhome.com",
-        MockBase: "http://localhost:8080",
         OauthClientId: "homemobile",
         OauthRedirectUri: "melcloudhome://",
         OauthScopes: "openid profile email offline_access IdentityServerApi",
@@ -33,13 +31,14 @@ export const ApiUrls = {
         CognitoDomainSuffix: ".amazoncognito.com",
         WebSocket: "wss://ws.melcloudhome.com/?hash=",
         Get: {
-            Configuration: "/api/configuration",
-            Context: "/context",
-            Scenes: "/monitor/user/scenes",
+            Config: "/config", //{"feature_management":{"feature_flags":[{"id":"energyProduced","enabled":"true"},{"id":"enableManual4thGenClaiming","enabled":"false"}]},"sentryLogging":{"enableSentryLogging":"/mch/monitorAndControlMobile/enableSentryLogging"}}
+            Context: "/context", //{}
+            Scenes: "/monitor/user/scenes", //[{}]
+            SystemInvites: "/monitor/user/systeminvites", //[]
+            NotificationSettings: "/monitor.user/notificationsettings", //{"054dd950-f6e0-4195-bea7-59d8ea0668c2": true
             TelemetryEnergy: "/telemetry/telemetry/energy/deviceid",
             TelemetryActual: "/telemetry/telemetry/actual/deviceid",
-            ReportTrendSummary: "/report/v1/trendsummary",
-            SystemInvites: "/systeminvites"
+            ReportTrendSummary: "/report/v1/trendsummary"
         },
         Post: {
             ProtectionFrost: "/monitor/protection/frost", //{"enabled":true,"min":13,"max":16,"units":{"ATA":["deviceid"]}}
@@ -49,18 +48,15 @@ export const ApiUrls = {
             Scene: "/monitor/scene", //{"id": "sceneid", "userId": "userid","name": "Poza domem","enabled": false,"icon": "AwayIcon","ataSceneSettings": [{"unitId": "deviceid","ataSettings": { "power": false, "operationMode": "heat","setFanSpeed": "auto","vaneHorizontalDirection": "auto", "vaneVerticalDirection": "auto", "setTemperature": 21,"temperatureIncrementOverride": null,"inStandbyMode": null},"previousSettings": null}],"atwSceneSettings": []}
         },
         Put: {
-            Ata: "/api/ataunit/deviceid", //{ power: true,setTemperature: 22, setFanSpeed: "auto", operationMode: "heat", vaneHorizontalDirection: "auto",vaneVerticalDirection: "auto", temperatureIncrementOverride: null, inStandbyMode: null}
-            AtaMobile: "/monitor/ataunit/deviceid",
-            Atw: "/api/atwunit/deviceid",
-            AtwMobile: "/monitor/atwunit/deviceid",
-            Erv: "/api/ervunit/deviceid",
-            ErvMobile: "/monitor/ervunit/deviceid",
-            ScheduleEnableDisable: "/monitor/cloudschedule/deviceid/enabled", // {"enabled": true}
-            SceneEnableDisable: "/monitor/scene/sceneid",
+            Ata: "/monitor/ataunit/deviceid", //{ power: true,setTemperature: 22, setFanSpeed: "auto", operationMode: "heat", vaneHorizontalDirection: "auto",vaneVerticalDirection: "auto", temperatureIncrementOverride: null, inStandbyMode: null}
+            Atw: "/monitor/atwunit/deviceid",
+            Erv: "/monitor/ervunit/deviceid",
+            ScheduleEnabled: "/monitor/cloudschedule/deviceid/enabled", // {"enabled": true}
+            SceneEnableDisable: "/monitor/scene/sceneid", //https://mobile.bff.melcloudhome.com/monitor/scene/sceneid/enable or disable
         },
         Delete: {
-            Schedule: "/api/cloudschedule/deviceid/scheduleid",
-            Scene: "/api/scene/sceneid"
+            Schedule: "/monitor/cloudschedule/deviceid/scheduleid",
+            Scene: "/monitor/scene/sceneid"
         },
         Referers: {
             GetPutScenes: "https://melcloudhome.com/scenes",
@@ -68,7 +64,7 @@ export const ApiUrls = {
             PostProtectionFrost: "https://melcloudhome.com/ata/deviceid/frostprotection",
             PostProtectionOverheat: "https://melcloudhome.com/ata/deviceid/overheatprotection",
             PutDeviceSettings: "https://melcloudhome.com/dashboard",
-            PutScheduleEnabled: "https://melcloudhome.com/ata/deviceid/schedule",
+            PutScheduleEnabled: "https://melcloudhome.com/ata/deviceid/schedule"
         }
     }
 };

package/src/melcloudata.js

@@ -279,7 +279,7 @@ class MelCloudAta extends EventEmitter {
                             break;
                         case 'schedule':
                             method = 'PUT';
-                            path = ApiUrls.Home.Put.ScheduleEnableDisable.replace('deviceid', deviceData.DeviceID);
+                            path = ApiUrls.Home.Put.ScheduleEnabled.replace('deviceid', deviceData.DeviceID);
                             deviceData.ScheduleEnabled = payload.enabled;
                             break;
                         case 'scene':
@@ -315,7 +315,7 @@ class MelCloudAta extends EventEmitter {
                             });
 
                             method = 'PUT';
-                            path = ApiUrls.Home.Put.AtaMobile.replace('deviceid', deviceData.DeviceID);
+                            path = ApiUrls.Home.Put.Ata.replace('deviceid', deviceData.DeviceID);
                             break;
                     }
 

package/src/melcloudatw.js

@@ -265,7 +265,7 @@ class MelCloudAtw extends EventEmitter {
                             });
 
                             method = 'PUT';
-                            path = ApiUrls.Home.Put.AtwMobile.replace('deviceid', deviceData.DeviceID);
+                            path = ApiUrls.Home.Put.Atw.replace('deviceid', deviceData.DeviceID);
                             break
                     }
 

package/src/melclouderv.js

@@ -280,7 +280,7 @@ class MelCloudErv extends EventEmitter {
                             });
 
                             method = 'PUT';
-                            path = ApiUrls.Home.Put.ErvMobile.replace('deviceid', deviceData.DeviceID);
+                            path = ApiUrls.Home.Put.Erv.replace('deviceid', deviceData.DeviceID);
                             break
                     }
 

package/src/melcloudhome.js

@@ -1,4 +1,5 @@
 import axios from 'axios';
+import WebSocket from 'ws';
 import crypto from 'crypto';
 import EventEmitter from 'events';
 import ImpulseGenerator from './impulsegenerator.js';
@@ -37,7 +38,7 @@ class MelCloudHome extends EventEmitter {
         this.tokenExpiry = 0; // Unix timestamp (sekundy)
 
         // Flaga zapobiegająca wielokrotnemu dodaniu interceptorów
-        this._interceptorsAttached = false;
+        this.interceptorsAttached = false;
 
         if (pluginStart) {
             this.impulseGenerator = new ImpulseGenerator()
@@ -50,6 +51,154 @@ class MelCloudHome extends EventEmitter {
         }
     }
 
+    // ── WebSocket ─────────────────────────────────────────────────────────────
+
+    // Pobiera hash do URL WebSocket.
+    // Sprawdza kolejno: /api/configuration → /api/user/context → access token jako fallback.
+    // Gdy znajdziesz właściwe źródło, uproszcz tę metodę.
+    async fetchWsHash() {
+        // Próba 1: /api/configuration
+        try {
+            const resp = await this.client.get(ApiUrls.Home.Get.Config);
+            const hash = resp.data?.wsHash ?? resp.data?.webSocketHash ?? resp.data?.hash ?? null;
+            if (hash) {
+                if (!this.logDebug) this.emit('debug', `WS hash from configuration: ${hash}`);
+                return hash;
+            }
+            if (!this.logDebug) this.emit('debug', `Configuration response (no hash found): ${JSON.stringify(resp.data)}`);
+        } catch (err) {
+            if (!this.logDebug) this.emit('debug', `fetchWsHash: configuration failed: ${err.message}`);
+        }
+
+        // Próba 2: /api/user/context (buildingsList może zawierać hash)
+        try {
+            const resp = await this.client.get(ApiUrls.Home.Get.Context);
+            const hash = resp.data?.wsHash ?? resp.data?.webSocketHash ?? resp.data?.hash ?? null;
+            if (hash) {
+                if (!this.logDebug) this.emit('debug', `WS hash from context: ${hash}`);
+                return hash;
+            }
+        } catch (err) {
+            if (!this.logDebug) this.emit('debug', `fetchWsHash: context failed: ${err.message}`);
+        }
+
+        // Fallback: access token (JWT) — niektóre implementacje używają go bezpośrednio
+        if (this.accessToken) {
+            if (!this.logDebug) this.emit('debug', 'fetchWsHash: falling back to access token as hash');
+            return this.accessToken;
+        }
+
+        throw new Error('Unable to obtain WebSocket hash — update fetchWsHash() when source is known');
+    }
+
+    cleanupSocket() {
+        if (this.heartbeat) {
+            clearInterval(this.heartbeat);
+            this.heartbeat = null;
+        }
+        this.socketConnected = false;
+        this.connecting = false;
+        this.socket = null;
+    }
+
+    // Łączy się z WebSocket. Wywoływane po udanym connect() lub po reconnect.
+    async connectSocket() {
+        if (this.connecting || this.socketConnected) return;
+        this.connecting = true;
+
+        let hash;
+        try {
+            hash = await this.fetchWsHash();
+        } catch (err) {
+            if (!this.logError) this.emit('error', `connectSocket: cannot get WS hash: ${err.message}`);
+            this.connecting = false;
+            this._scheduleReconnect();
+            return;
+        }
+
+        const url = `${ApiUrls.Home.WebSocket}${hash}`;
+        const headers = {
+            Origin: ApiUrls.Home.Base,
+            Pragma: 'no-cache',
+            'Cache-Control': 'no-cache',
+        };
+
+        if (!this.logDebug) this.emit('debug', `Connecting WebSocket: ${url.slice(0, 60)}...`);
+
+        try {
+            const ws = new WebSocket(url, { headers });
+            this.socket = ws;
+
+            ws.on('error', (error) => {
+                if (this.logError) this.emit('error', `Web socket error: ${error.message}`);
+                try { ws.close(); } catch { /* ignoruj */ }
+            });
+
+            ws.on('close', () => {
+                if (this.logDebug) this.emit('debug', 'Web socket closed');
+                this.cleanupSocket();
+                this._scheduleReconnect();
+            });
+
+            ws.on('open', () => {
+                this.socketConnected = true;
+                this.connecting = false;
+                this._reconnectDelay = 5_000; // reset backoff po udanym połączeniu
+                if (this._reconnectTimer) {
+                    clearTimeout(this._reconnectTimer);
+                    this._reconnectTimer = null;
+                }
+                if (this.logDebug) this.emit('debug', 'Web Socket Connected');
+
+                // Heartbeat co 30s
+                this.heartbeat = setInterval(() => {
+                    if (ws.readyState === WebSocket.OPEN) {
+                        if (this.logDebug) this.emit('debug', 'Web socket send heartbeat');
+                        ws.ping();
+                    }
+                }, 30_000);
+            });
+
+            ws.on('pong', () => {
+                if (this.logDebug) this.emit('debug', 'Web socket received heartbeat');
+            });
+
+            ws.on('message', (message) => {
+                try {
+                    const parsedMessage = JSON.parse(message);
+                    if (this.logDebug) this.emit('debug', `Web socket incoming message: ${JSON.stringify(parsedMessage, null, 2)}`);
+
+                    // Format: array, pierwszy element ma Data.id
+                    const messageData = parsedMessage?.[0]?.Data;
+                    if (!messageData || parsedMessage.message === 'Forbidden') return;
+
+                    this.emit(messageData.id, 'ws', parsedMessage[0]);
+                } catch (err) {
+                    if (this.logError) this.emit('error', `Web socket message parse error: ${err.message}`);
+                }
+            });
+
+        } catch (error) {
+            if (this.logError) this.emit('error', `Web socket connection failed: ${error.message}`);
+            this.cleanupSocket();
+            this._scheduleReconnect();
+        }
+    }
+
+    // Wykładniczy backoff: 5s → 10s → 20s → ... → max 5 minut
+    _scheduleReconnect() {
+        if (this._reconnectTimer) return; // już zaplanowany
+
+        if (this.logDebug) this.emit('debug', `Web socket reconnecting in ${this._reconnectDelay / 1000}s...`);
+
+        this._reconnectTimer = setTimeout(async () => {
+            this._reconnectTimer = null;
+            await this.connectSocket();
+        }, this._reconnectDelay);
+
+        this._reconnectDelay = Math.min(this._reconnectDelay * 2, this._reconnectDelayMax);
+    }
+
     // ── Utils ─────────────────────────────────────────────────────────────────
 
     capitalizeKeysDeep(obj) {
@@ -99,7 +248,7 @@ class MelCloudHome extends EventEmitter {
         if (this.client) return this.client;
 
         this.client = axios.create({
-            baseURL: ApiUrls.Home.BaseMobile,
+            baseURL: ApiUrls.Home.Base,
             timeout: 30_000,
             headers: {
                 Accept: 'application/json',
@@ -256,8 +405,8 @@ class MelCloudHome extends EventEmitter {
     // ── Interceptory do automatycznego odświeżania tokena ─────────────────────
 
     attachTokenInterceptors() {
-        if (this._interceptorsAttached) return;
-        this._interceptorsAttached = true;
+        if (this.interceptorsAttached) return;
+        this.interceptorsAttached = true;
 
         const apiClient = this.ensureClient();
 
@@ -311,6 +460,9 @@ class MelCloudHome extends EventEmitter {
 
         connectInfo.State = exchangeRes;
         connectInfo.Status = exchangeRes ? 'Connect Success' : 'Connect Failed at token exchange';
+        this.connectSocket().catch(err => {
+            if (this.logError) this.emit('error', `Initial WebSocket connect failed: ${err.message}`);
+        });
 
         return connectInfo;
     }