@homebridge-plugins/homebridge-meross 10.14.0 → 10.15.2

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to `@homebridge-plugins/homebridge-meross` will be documented in this file.
 
+## v10.15.2 (2026-06-03)
+
+### Changes
+
+- fix(platform): do not serialize hidden accessories to the cache
+- chore: dependency updates
+
+## v10.15.1 (2026-05-05)
+
+### Changed
+
+- chore: dependency updates
+
+## v10.15.0 (2026-05-04)
+
+### Changed
+
+- remove node 20 from build workflow
+- feat: show/hide devices in custom ui device list (#732) (@burtherman)
+- fix: fix js syntax errors in config schema file
+- chore: dependency updates
+
 ## v10.14.0 (2026-04-09)
 
 ### Added

package/config.schema.json

@@ -173,7 +173,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.singleDevices && model.singleDevices[arrayIndices] && model.singleDevices[arrayIndices].serialNumber && model.singleDevices[arrayIndices].serialNumber.length === 32 && model.singleDevices[arrayIndices].connection !== 'local' && !model.singleDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.singleDevices && model.singleDevices[arrayIndices] && model.singleDevices[arrayIndices].serialNumber && model.singleDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {
@@ -463,7 +463,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.multiDevices && model.multiDevices[arrayIndices] && model.multiDevices[arrayIndices].serialNumber && model.multiDevices[arrayIndices].serialNumber.length === 32 && model.multiDevices[arrayIndices].connection !== 'local' && !model.multiDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.multiDevices && model.multiDevices[arrayIndices] && model.multiDevices[arrayIndices].serialNumber && model.multiDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {
@@ -687,7 +687,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.lightDevices && model.lightDevices[arrayIndices] && model.lightDevices[arrayIndices].serialNumber && model.lightDevices[arrayIndices].serialNumber.length === 32 && model.lightDevices[arrayIndices].connection !== 'local' && !model.lightDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.lightDevices && model.lightDevices[arrayIndices] && model.lightDevices[arrayIndices].serialNumber && model.lightDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {
@@ -930,7 +930,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.fanDevices && model.fanDevices[arrayIndices] && model.fanDevices[arrayIndices].serialNumber && model.fanDevices[arrayIndices].serialNumber.length === 32 && model.fanDevices[arrayIndices].connection !== 'local' && !model.fanDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.fanDevices && model.fanDevices[arrayIndices] && model.fanDevices[arrayIndices].serialNumber && model.fanDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {
@@ -1025,7 +1025,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.diffuserDevices && model.diffuserDevices[arrayIndices] && model.diffuserDevices[arrayIndices].serialNumber && model.diffuserDevices[arrayIndices].serialNumber.length === 32 && model.diffuserDevices[arrayIndices].connection !== 'local' && !model.diffuserDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.diffuserDevices && model.diffuserDevices[arrayIndices] && model.diffuserDevices[arrayIndices].serialNumber && model.diffuserDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {
@@ -1134,7 +1134,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.purifierDevices && model.purifierDevices[arrayIndices] && model.purifierDevices[arrayIndices].serialNumber && model.purifierDevices[arrayIndices].serialNumber.length === 32 && model.purifierDevices[arrayIndices].connection !== 'local' && !model.purifierDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.purifierDevices && model.purifierDevices[arrayIndices] && model.purifierDevices[arrayIndices].serialNumber && model.purifierDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {
@@ -1221,7 +1221,7 @@
             "type": "string",
             "format": "ipv4",
             "condition": {
-              "functionBody": "return (model.humidifierDevices && model.humidifierDevices[arrayIndices] && model.humidifierDevices[arrayIndices].serialNumber && model.humidifierDevices[arrayIndices].serialNumber.length === 32 && ((!model.username && !model.password && model.userkey) || (model.username && model.password && ((model.connection === 'local' && [undefined, 'local'].includes(model.humidifierDevices[arrayIndices].connection)) || || (model.connection !== 'local' && model.humidifierDevices[arrayIndices].connection === 'local')))));"
+              "functionBody": "return (model.humidifierDevices && model.humidifierDevices[arrayIndices] && model.humidifierDevices[arrayIndices].serialNumber && model.humidifierDevices[arrayIndices].serialNumber.length === 32 && ((!model.username && !model.password && model.userkey) || (model.username && model.password && ((model.connection === 'local' && [undefined, 'local'].includes(model.humidifierDevices[arrayIndices].connection)) || (model.connection !== 'local' && model.humidifierDevices[arrayIndices].connection === 'local')))));"
             }
           },
           "ignoreDevice": {
@@ -1229,7 +1229,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.humidifierDevices && model.humidifierDevices[arrayIndices] && model.humidifierDevices[arrayIndices].serialNumber && model.humidifierDevices[arrayIndices].serialNumber.length === 32 && model.humidifierDevices[arrayIndices].connection !== 'local' && !model.humidifierDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.humidifierDevices && model.humidifierDevices[arrayIndices] && model.humidifierDevices[arrayIndices].serialNumber && model.humidifierDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {
@@ -1316,7 +1316,7 @@
             "type": "string",
             "format": "ipv4",
             "condition": {
-              "functionBody": "return (model.thermostatDevices && model.thermostatDevices[arrayIndices] && model.thermostatDevices[arrayIndices].serialNumber && model.thermostatDevices[arrayIndices].serialNumber.length === 32 && ((!model.username && !model.password && model.userkey) || (model.username && model.password && ((model.connection === 'local' && [undefined, 'local'].includes(model.thermostatDevices[arrayIndices].connection)) || || (model.connection !== 'local' && model.thermostatDevices[arrayIndices].connection === 'local')))));"
+              "functionBody": "return (model.thermostatDevices && model.thermostatDevices[arrayIndices] && model.thermostatDevices[arrayIndices].serialNumber && model.thermostatDevices[arrayIndices].serialNumber.length === 32 && ((!model.username && !model.password && model.userkey) || (model.username && model.password && ((model.connection === 'local' && [undefined, 'local'].includes(model.thermostatDevices[arrayIndices].connection)) || (model.connection !== 'local' && model.thermostatDevices[arrayIndices].connection === 'local')))));"
             }
           },
           "ignoreDevice": {
@@ -1324,7 +1324,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.thermostatDevices && model.thermostatDevices[arrayIndices] && model.thermostatDevices[arrayIndices].serialNumber && model.thermostatDevices[arrayIndices].serialNumber.length === 32 && model.thermostatDevices[arrayIndices].connection !== 'local' && !model.thermostatDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.thermostatDevices && model.thermostatDevices[arrayIndices] && model.thermostatDevices[arrayIndices].serialNumber && model.thermostatDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {
@@ -1447,7 +1447,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.garageDevices && model.garageDevices[arrayIndices] && model.garageDevices[arrayIndices].serialNumber && model.garageDevices[arrayIndices].serialNumber.length === 32 && model.garageDevices[arrayIndices].connection !== 'local' && !model.garageDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.garageDevices && model.garageDevices[arrayIndices] && model.garageDevices[arrayIndices].serialNumber && model.garageDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {
@@ -1568,7 +1568,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.rollerDevices && model.rollerDevices[arrayIndices] && model.rollerDevices[arrayIndices].serialNumber && model.rollerDevices[arrayIndices].serialNumber.length === 32 && model.rollerDevices[arrayIndices].connection !== 'local' && !model.rollerDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.rollerDevices && model.rollerDevices[arrayIndices] && model.rollerDevices[arrayIndices].serialNumber && model.rollerDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {
@@ -1697,7 +1697,7 @@
             "title": "Hide From HomeKit",
             "description": "If true, this accessory will be removed and ignored from HomeKit.",
             "condition": {
-              "functionBody": "return (model.babyDevices && model.babyDevices[arrayIndices] && model.babyDevices[arrayIndices].serialNumber && model.babyDevices[arrayIndices].serialNumber.length === 32 && model.babyDevices[arrayIndices].connection !== 'local' && !model.babyDevices[arrayIndices].deviceUrl);"
+              "functionBody": "return (model.babyDevices && model.babyDevices[arrayIndices] && model.babyDevices[arrayIndices].serialNumber && model.babyDevices[arrayIndices].serialNumber.length === 32);"
             }
           },
           "model": {

package/lib/homebridge-ui/public/index.html

@@ -114,6 +114,17 @@
           <th scope="row">Firmware Version</th>
           <td id="firmware"></td>
         </tr>
+        <tr>
+          <th scope="row">Hide from HomeKit</th>
+          <td>
+            <div class="custom-control custom-checkbox">
+              <input type="checkbox" class="custom-control-input" id="hideDevice">
+              <label class="custom-control-label" for="hideDevice">
+                Hide this device from HomeKit
+              </label>
+            </div>
+          </td>
+        </tr>
       </tbody>
     </table>
   </div>
@@ -294,6 +305,80 @@
           document.getElementById('mac_address').innerHTML = context.macAddress || 'N/A'
           document.getElementById('hardware').innerHTML = context.hardware || 'N/A'
           document.getElementById('firmware').innerHTML = context.firmware || 'N/A'
+
+          // Handle hide device checkbox
+          const hideCheckbox = document.getElementById('hideDevice')
+          const deviceUUID = context.serialNumber.toLowerCase().replace(/[^a-z0-9]/g, '')
+          const deviceArrays = [
+            'singleDevices', 'multiDevices', 'lightDevices', 'fanDevices',
+            'diffuserDevices', 'purifierDevices', 'humidifierDevices',
+            'thermostatDevices', 'garageDevices', 'rollerDevices',
+            'babyDevices', 'sensorDevices',
+          ]
+          const findEntry = (cfg) => {
+            for (const key of deviceArrays) {
+              const arr = cfg[0]?.[key]
+              if (!Array.isArray(arr)) continue
+              const idx = arr.findIndex(e => e.serialNumber?.toLowerCase().replace(/[^a-z0-9]/g, '') === deviceUUID)
+              if (idx !== -1) return { key, idx, entry: arr[idx] }
+            }
+            return null
+          }
+
+          // Check if device is currently hidden
+          const config = await homebridge.getPluginConfig()
+          const existing = findEntry(config)
+          hideCheckbox.checked = !!existing?.entry?.ignoreDevice
+
+          // Remove previous event listeners by cloning the element
+          const newCheckbox = hideCheckbox.cloneNode(true)
+          hideCheckbox.parentNode.replaceChild(newCheckbox, hideCheckbox)
+
+          // Add event listener for checkbox changes
+          newCheckbox.addEventListener('change', async (e) => {
+            try {
+              homebridge.showSpinner()
+              const cfg = await homebridge.getPluginConfig()
+              const found = findEntry(cfg)
+
+              if (e.target.checked) {
+                if (found) {
+                  cfg[0][found.key][found.idx].ignoreDevice = true
+                } else {
+                  const arrayKey = await homebridge.request('/getDeviceConfigKey', { model: context.model })
+                  if (!arrayKey) {
+                    homebridge.toast.error(`Unsupported device model: ${context.model}`, 'Cannot hide device')
+                    e.target.checked = false
+                    homebridge.hideSpinner()
+                    return
+                  }
+                  if (!Array.isArray(cfg[0][arrayKey])) {
+                    cfg[0][arrayKey] = []
+                  }
+                  cfg[0][arrayKey].push({
+                    name: thisAcc.displayName,
+                    serialNumber: deviceUUID,
+                    ignoreDevice: true,
+                  })
+                }
+                homebridge.toast.success(`${thisAcc.displayName} will be hidden from HomeKit after restart`, 'Device Hidden')
+              } else if (found) {
+                cfg[0][found.key][found.idx].ignoreDevice = false
+                homebridge.toast.success(`${thisAcc.displayName} will be shown in HomeKit after restart`, 'Device Unhidden')
+              }
+
+              await homebridge.updatePluginConfig(cfg)
+
+              // Switch to Settings tab to sync the form with updated config
+              showSettings()
+              homebridge.toast.info('Please click Save to persist your changes', 'Settings Updated')
+              homebridge.hideSpinner()
+            } catch (err) {
+              homebridge.toast.error(err.message, 'Error')
+              homebridge.hideSpinner()
+            }
+          })
+
           document.getElementById('deviceTable').style.display = 'inline-table'
           homebridge.hideSpinner()
         }

package/lib/homebridge-ui/server.js

@@ -1,8 +1,55 @@
 import { HomebridgePluginUiServer } from '@homebridge/plugin-ui-utils'
 
+import platformConsts from '../utils/constants.js'
+
+function getDeviceConfigKey(model) {
+  if (!model) {
+    return null
+  }
+  const m = platformConsts.models
+  if (m.switchSingle.includes(model)) {
+    return 'singleDevices'
+  }
+  if (Object.hasOwn(m.switchMulti, model)) {
+    return 'multiDevices'
+  }
+  if (m.lightDimmer.includes(model) || m.lightRGB.includes(model) || m.lightCCT.includes(model)) {
+    return 'lightDevices'
+  }
+  if (m.fan.includes(model)) {
+    return 'fanDevices'
+  }
+  if (m.diffuser.includes(model)) {
+    return 'diffuserDevices'
+  }
+  if (m.purifier.includes(model)) {
+    return 'purifierDevices'
+  }
+  if (m.humidifier.includes(model)) {
+    return 'humidifierDevices'
+  }
+  if (m.thermostat.includes(model)) {
+    return 'thermostatDevices'
+  }
+  if (m.garage.includes(model)) {
+    return 'garageDevices'
+  }
+  if (m.roller.includes(model)) {
+    return 'rollerDevices'
+  }
+  if (m.baby.includes(model)) {
+    return 'babyDevices'
+  }
+  if (m.sensorPresence.includes(model)) {
+    return 'sensorDevices'
+  }
+  return null
+}
+
 class PluginUiServer extends HomebridgePluginUiServer {
   constructor() {
     super()
+    this.onRequest('/getDeviceConfigKey', ({ model }) => getDeviceConfigKey(model))
     this.ready()
   }
 }

package/lib/platform.js

@@ -116,15 +116,16 @@ export default class {
         case 'thermostatDevices':
           if (Array.isArray(val) && val.length > 0) {
             val.forEach((x) => {
+              if (!(x.serialNumber && x.name)) {
+                logIgnoreItem(key)
+                return
+              }
               if (
-                !(
-                  x.serialNumber
-                  && x.name
-                  && (
-                    (config.connection !== 'local' && x.connection !== 'local')
-                    || (config.connection !== 'local' && x.connection === 'local' && x.deviceUrl)
-                    || (config.connection === 'local' && x.model && x.deviceUrl)
-                  )
+                !x.ignoreDevice
+                && !(
+                  (config.connection !== 'local' && x.connection !== 'local')
+                  || (config.connection !== 'local' && x.connection === 'local' && x.deviceUrl)
+                  || (config.connection === 'local' && x.model && x.deviceUrl)
                 )
               ) {
                 logIgnoreItem(key)
@@ -644,8 +645,7 @@ export default class {
               accessory = subAcc
             } else {
               // Update any changes to the accessory to the platform
-              this.api.updatePlatformAccessories([subAcc])
-              this.devicesInHB.set(subAcc.UUID, subAcc)
+              this.saveAccessoryUpdate(subAcc)
             }
           })
         }
@@ -741,8 +741,7 @@ export default class {
             subAcc.control = new deviceTypes.deviceGarageSub(this, subAcc, accessory)
 
             // Update any changes to the accessory to the platform
-            this.api.updatePlatformAccessories([subAcc])
-            this.devicesInHB.set(subAcc.UUID, subAcc)
+            this.saveAccessoryUpdate(subAcc)
           })
         } else {
           accessory = this.devicesInHB.get(hbUUID) || this.addAccessory(device)
@@ -829,8 +828,7 @@ export default class {
         this.applyAccessoryLogging(accessoryLight)
 
         // Update any changes to the accessory to the platform
-        this.api.updatePlatformAccessories([accessoryLight])
-        this.devicesInHB.set(accessoryLight.UUID, accessoryLight)
+        this.saveAccessoryUpdate(accessoryLight)
 
         // Set up the main accessory for the baby monitor
         accessory.control = new deviceTypes.deviceBaby(this, accessory, accessoryLight)
@@ -963,8 +961,7 @@ export default class {
             }
 
             // Update any changes to the accessory to the platform
-            this.api.updatePlatformAccessories([subAcc])
-            this.devicesInHB.set(subAcc.UUID, subAcc)
+            this.saveAccessoryUpdate(subAcc)
 
             // Log the subdevice id so a user can use it to ignore device if wanted
             this.log(
@@ -1019,8 +1016,7 @@ export default class {
       accessory.logDebug(`${platformLang.jsonInfo}: ${JSON.stringify(device)}`)
 
       // Update any changes to the accessory to the platform
-      this.api.updatePlatformAccessories([accessory])
-      this.devicesInHB.set(accessory.UUID, accessory)
+      this.saveAccessoryUpdate(accessory)
     } catch (err) {
       // Catch any errors during device initialisation
       const eText = parseError(err, [
@@ -1125,7 +1121,9 @@ export default class {
   }
 
   updateAccessory(accessory) {
-    this.api.updatePlatformAccessories([accessory])
+    if (!accessory.context.hidden) {
+      this.api.updatePlatformAccessories([accessory])
+    }
     if (accessory.context.isOnline) {
       this.log('[%s] %s.', accessory.displayName, platformLang.repOnline)
     } else {
@@ -1133,6 +1131,13 @@ export default class {
     }
   }
 
+  saveAccessoryUpdate(accessory) {
+    if (!accessory.context.hidden) {
+      this.api.updatePlatformAccessories([accessory])
+    }
+    this.devicesInHB.set(accessory.UUID, accessory)
+  }
+
   removeAccessory(accessory) {
     try {
       // Remove an accessory from Homebridge

package/package.json

@@ -2,7 +2,7 @@
   "name": "@homebridge-plugins/homebridge-meross",
   "alias": "Meross",
   "type": "module",
-  "version": "10.14.0",
+  "version": "10.15.2",
   "description": "Homebridge plugin to integrate Meross devices into HomeKit.",
   "author": {
     "name": "bwp91",
@@ -48,22 +48,22 @@
   ],
   "main": "lib/index.js",
   "engines": {
-    "homebridge": "^1.6.0 || ^2.0.0-beta.0",
-    "node": "^22 || ^24"
+    "homebridge": "^1.6.0 || ^2.0.0",
+    "node": "^22.12.0 || ^24.0.0"
   },
   "scripts": {
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "npm run lint -- --fix"
   },
   "dependencies": {
-    "@homebridge/plugin-ui-utils": "^2.2.3",
-    "axios": "^1.15.0",
+    "@homebridge/plugin-ui-utils": "^2.2.4",
+    "axios": "^1.17.0",
     "mqtt": "^5.15.1",
     "node-persist": "^4.0.4",
-    "p-queue": "^9.1.2",
+    "p-queue": "^9.3.0",
     "p-timeout": "^7.0.1"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^8.1.1"
+    "@antfu/eslint-config": "^9.0.0"
   }
 }