homebridge-melcloud-control 4.9.2-beta.7 → 4.10.0-beta.0

package/CHANGELOG.md

@@ -24,10 +24,11 @@ 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)
+# [4.10.0] - (16.04.2026)
 
 ## Changes
 
+- added web socket for real time data refresh with MELCloud Home
 - cleanup
 
 # [4.9.1] - (15.04.2026)

package/index.js

@@ -83,7 +83,7 @@ class MelCloudPlatform {
 										melCloudClass = new MelCloud(account, true);
 										break;
 									case 'melcloudhome':
-										timmers = [{ name: 'checkDevicesList', sampling: 7000 }];
+										timmers = [{ name: 'checkDevicesList', sampling: 10000 }];
 										melCloudClass = new MelCloudHome(account, true);
 										break;
 									default:

package/package.json

@@ -1,7 +1,7 @@
 {
   "displayName": "MELCloud Control",
   "name": "homebridge-melcloud-control",
-  "version": "4.9.2-beta.7",
+  "version": "4.10.0-beta.0",
   "description": "Homebridge plugin to control Mitsubishi Air Conditioner, Heat Pump and Energy Recovery Ventilation.",
   "license": "MIT",
   "author": "grzegorz914",

package/src/constants.js

@@ -10,6 +10,7 @@ export const ApiUrls = {
         RefreshUnit: "/Device/RequestRefresh?id=deviceid",
         DeviceState: "/Device/Get?id=DID&buildingID=BID",
         TileState: "/Tile/Get2?id=DID&buildingID=BID",
+        Scenes: "/Scene/List"
     },
     Post: {
         ClientLogin: "/Login/ClientLogin",

package/src/melcloudhome.js

@@ -21,6 +21,7 @@ class MelCloudHome extends EventEmitter {
         this.logWarn = account.log?.warn;
         this.logError = account.log?.error;
         this.logDebug = account.log?.debug;
+        this.pluginStart = pluginStart;
 
         this.functions = new Functions(this.logWarn, this.logError, this.logDebug)
             .on('warn', warn => this.emit('warn', warn))
@@ -86,7 +87,7 @@ class MelCloudHome extends EventEmitter {
             if (this.logError) this.emit('error', `connectSocket: cannot get WS hash: ${err.message}`);
             this.connecting = false;
             this.scheduleReconnect();
-            return false;
+            return;
         }
 
         const url = `${ApiUrls.Home.WebSocket}${hash}`;
@@ -423,10 +424,13 @@ class MelCloudHome extends EventEmitter {
             // attachTokenInterceptors() dodaje interceptory tylko przy pierwszym wywołaniu.
             this.ensureClient();
             this.attachTokenInterceptors();
-            this.emit('client', this.client);
-            const webSocket = await this.connectSocket().catch(err => {
-                if (this.logError) this.emit('error', `Initial WebSocket connect failed: ${err.message}`);
-            });
+
+            if (this.pluginStart) {
+                this.emit('client', this.client);
+                await this.connectSocket().catch(err => {
+                    if (this.logError) this.emit('error', `Initial WebSocket connect failed: ${err.message}`);
+                });
+            }
         }
 
         connectInfo.State = exchangeRes;
@@ -435,117 +439,6 @@ class MelCloudHome extends EventEmitter {
         return connectInfo;
     }
 
-    // ── Scenes & Devices ──────────────────────────────────────────────────────
-
-    async checkScenesList() {
-        try {
-            if (this.logDebug) this.emit('debug', 'Scanning for scenes');
-
-            const resp = await this.client.get(ApiUrls.Home.Get.Scenes);
-            const scenesList = resp.data;
-
-            if (this.logDebug) this.emit('debug', `Scenes: ${JSON.stringify(scenesList, null, 2)}`);
-
-            return this.capitalizeKeysDeep(scenesList);
-        } catch (error) {
-            throw new Error(`Check scenes list error: ${error.message}`);
-        }
-    }
-
-    async checkDevicesList() {
-        try {
-            const result = { State: false, Status: null, Buildings: {}, Devices: [], Scenes: [] };
-            if (this.logDebug) this.emit('debug', 'Scanning for devices');
-
-            const resp = await this.client.get(ApiUrls.Home.Get.Context);
-            const userContext = resp.data;
-            //if (this.logDebug) this.emit('debug', `User Context: ${JSON.stringify(userContext, null, 2)}`);
-
-            const buildings = userContext.buildings ?? [];
-            const guestBuildings = userContext.guestBuildings ?? [];
-            const buildingsList = [...buildings, ...guestBuildings];
-
-            if (this.logDebug) this.emit('debug', `Buildings: ${JSON.stringify(buildingsList, null, 2)}`);
-
-            if (buildingsList.length === 0) {
-                result.Status = 'No buildings found';
-                return result;
-            }
-
-            const capitalizeKeys = obj => Object.fromEntries(
-                Object.entries(obj).map(([k, v]) => [k.charAt(0).toUpperCase() + k.slice(1), v])
-            );
-
-            const createDevice = (device, type) => {
-                const settingsObject = Object.fromEntries(
-                    (device.Settings || []).map(({ name, value }) => [
-                        name.charAt(0).toUpperCase() + name.slice(1),
-                        this.functions.convertValue(value),
-                    ])
-                );
-
-                const deviceObject = {
-                    ...capitalizeKeys(device.Capabilities || {}),
-                    ...settingsObject,
-                    DeviceType: type,
-                    FirmwareAppVersion: device.ConnectedInterfaceIdentifier,
-                    IsConnected: device.IsConnected,
-                };
-
-                if (device.FrostProtection) device.FrostProtection = capitalizeKeys(device.FrostProtection);
-                if (device.OverheatProtection) device.OverheatProtection = capitalizeKeys(device.OverheatProtection);
-                if (device.HolidayMode) device.HolidayMode = capitalizeKeys(device.HolidayMode);
-                if (Array.isArray(device.Schedule)) device.Schedule = device.Schedule.map(s => this.capitalizeKeysDeep(s));
-
-                const { Settings, Capabilities, Id, GivenDisplayName, ...rest } = device;
-
-                return {
-                    ...rest,
-                    Type: type,
-                    DeviceID: Id,
-                    DeviceName: GivenDisplayName,
-                    SerialNumber: Id,
-                    Device: deviceObject,
-                };
-            };
-
-            const devices = buildingsList.flatMap(building => [
-                ...(building.airToAirUnits || []).map(d => createDevice(capitalizeKeys(d), 0)),
-                ...(building.airToWaterUnits || []).map(d => createDevice(capitalizeKeys(d), 1)),
-                ...(building.airToVentilationUnits || []).map(d => createDevice(capitalizeKeys(d), 3)),
-            ]);
-
-            if (devices.length === 0) {
-                result.Status = 'No devices found';
-                return result;
-            }
-
-            // Sceny
-            let scenes = [];
-            try {
-                scenes = await this.checkScenesList();
-                if (this.logDebug) this.emit('debug', `Found ${scenes.length} scenes`);
-            } catch (error) {
-                if (this.logError) this.emit('error', `Get scenes error: ${error}`);
-            }
-
-            result.State = true;
-            result.Status = `Found ${devices.length} devices${scenes.length > 0 ? ` and ${scenes.length} scenes` : ''}`;
-            result.Buildings = userContext;
-            result.Devices = devices;
-            result.Scenes = scenes;
-
-            for (const deviceData of result.Devices) {
-                deviceData.Scenes = result.Scenes;
-                this.emit(deviceData.DeviceID, 'request', deviceData);
-            }
-
-            return result;
-        } catch (error) {
-            throw new Error(`Check devices list error: ${error.message}`);
-        }
-    }
-
     // ── Connect ───────────────────────────────────────────────────────────────
 
     async connect() {
@@ -775,6 +668,117 @@ class MelCloudHome extends EventEmitter {
             throw new Error(`Connect error: ${error.message}`);
         }
     }
+
+    // ── Scenes & Devices ──────────────────────────────────────────────────────
+
+    async checkScenesList() {
+        try {
+            if (this.logDebug) this.emit('debug', 'Scanning for scenes');
+
+            const resp = await this.client.get(ApiUrls.Home.Get.Scenes);
+            const scenesList = resp.data;
+
+            if (this.logDebug) this.emit('debug', `Scenes: ${JSON.stringify(scenesList, null, 2)}`);
+
+            return this.capitalizeKeysDeep(scenesList);
+        } catch (error) {
+            throw new Error(`Check scenes list error: ${error.message}`);
+        }
+    }
+
+    async checkDevicesList() {
+        try {
+            const result = { State: false, Status: null, Buildings: {}, Devices: [], Scenes: [] };
+            if (this.logDebug) this.emit('debug', 'Scanning for devices');
+
+            const resp = await this.client.get(ApiUrls.Home.Get.Context);
+            const userContext = resp.data;
+            //if (this.logDebug) this.emit('debug', `User Context: ${JSON.stringify(userContext, null, 2)}`);
+
+            const buildings = userContext.buildings ?? [];
+            const guestBuildings = userContext.guestBuildings ?? [];
+            const buildingsList = [...buildings, ...guestBuildings];
+
+            if (this.logDebug) this.emit('debug', `Buildings: ${JSON.stringify(buildingsList, null, 2)}`);
+
+            if (buildingsList.length === 0) {
+                result.Status = 'No buildings found';
+                return result;
+            }
+
+            const capitalizeKeys = obj => Object.fromEntries(
+                Object.entries(obj).map(([k, v]) => [k.charAt(0).toUpperCase() + k.slice(1), v])
+            );
+
+            const createDevice = (device, type) => {
+                const settingsObject = Object.fromEntries(
+                    (device.Settings || []).map(({ name, value }) => [
+                        name.charAt(0).toUpperCase() + name.slice(1),
+                        this.functions.convertValue(value),
+                    ])
+                );
+
+                const deviceObject = {
+                    ...capitalizeKeys(device.Capabilities || {}),
+                    ...settingsObject,
+                    DeviceType: type,
+                    FirmwareAppVersion: device.ConnectedInterfaceIdentifier,
+                    IsConnected: device.IsConnected,
+                };
+
+                if (device.FrostProtection) device.FrostProtection = capitalizeKeys(device.FrostProtection);
+                if (device.OverheatProtection) device.OverheatProtection = capitalizeKeys(device.OverheatProtection);
+                if (device.HolidayMode) device.HolidayMode = capitalizeKeys(device.HolidayMode);
+                if (Array.isArray(device.Schedule)) device.Schedule = device.Schedule.map(s => this.capitalizeKeysDeep(s));
+
+                const { Settings, Capabilities, Id, GivenDisplayName, ...rest } = device;
+
+                return {
+                    ...rest,
+                    Type: type,
+                    DeviceID: Id,
+                    DeviceName: GivenDisplayName,
+                    SerialNumber: Id,
+                    Device: deviceObject,
+                };
+            };
+
+            const devices = buildingsList.flatMap(building => [
+                ...(building.airToAirUnits || []).map(d => createDevice(capitalizeKeys(d), 0)),
+                ...(building.airToWaterUnits || []).map(d => createDevice(capitalizeKeys(d), 1)),
+                ...(building.airToVentilationUnits || []).map(d => createDevice(capitalizeKeys(d), 3)),
+            ]);
+
+            if (devices.length === 0) {
+                result.Status = 'No devices found';
+                return result;
+            }
+
+            // Sceny
+            let scenes = [];
+            try {
+                scenes = await this.checkScenesList();
+                if (this.logDebug) this.emit('debug', `Found ${scenes.length} scenes`);
+            } catch (error) {
+                if (this.logError) this.emit('error', `Get scenes error: ${error}`);
+            }
+
+            result.State = true;
+            result.Status = `Found ${devices.length} devices${scenes.length > 0 ? ` and ${scenes.length} scenes` : ''}`;
+            result.Buildings = userContext;
+            result.Devices = devices;
+            result.Scenes = scenes;
+
+            for (const deviceData of result.Devices) {
+                deviceData.Scenes = result.Scenes;
+                this.emit(deviceData.DeviceID, 'request', deviceData);
+            }
+
+            return result;
+        } catch (error) {
+            throw new Error(`Check devices list error: ${error.message}`);
+        }
+    }
 }
 
 export default MelCloudHome;