@homebridge-plugins/homebridge-govee 11.26.0 → 11.26.1-beta.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to `@homebridge-plugins/homebridge-govee` will be documented in this file.
 
+## v11.26.1 (Pending Release)
+
+### Changes
+
+- fix: report leak events relayed by a wifi gateway over AWS (#1276)
+
 ## v11.26.0 (2026-07-12)
 
 ### Changes

package/lib/device/sensor-leak.js

@@ -67,7 +67,7 @@ export default class {
     }
 
     // Check to see if the provided leak status is different from the cached state
-    if (params.leakDetected !== this.cacheLeak) {
+    if (hasProperty(params, 'leakDetected') && params.leakDetected !== this.cacheLeak) {
       // Leak status is different so update Homebridge with new values
       this.cacheLeak = params.leakDetected
       this.service.updateCharacteristic(this.hapChar.LeakDetected, this.cacheLeak ? 1 : 0)

package/lib/platform.js

@@ -19,6 +19,7 @@ import platformChars from './utils/custom-chars.js'
 import { getDeviceCapabilities } from './utils/device-capabilities.js'
 import eveChars from './utils/eve-chars.js'
 import {
+  base64ToHex,
   hasProperty,
   parseDeviceId,
   parseError,
@@ -1372,6 +1373,14 @@ export default class {
               }
             }
 
+            // Gateway subdevices (e.g. leak sensors paired to an H5044) include
+            // their gateway id and slot number, which we need to match real-time
+            // leak events relayed by the gateway over AWS (#1276)
+            if (hasProperty(parsed, 'sno') && parsed.gatewayInfo?.device) {
+              accessory.context.gatewaySno = parsed.sno
+              accessory.context.gatewayDevice = parsed.gatewayInfo.device
+            }
+
             // Get a min and max temperature/humidity range to show in the homebridge-ui
             if (hasProperty(parsed, 'temCali')) {
               accessory.context.minTemp = parsed.temMin / 100
@@ -1522,6 +1531,13 @@ export default class {
           if (platformConsts.models.sensorLeak.includes(device1.sku)) {
             accessory.logDebug(`raw data: ${JSON.stringify({ ...parsedData, ...parsedSettings })}`)
 
+            // Keep the gateway details up to date for matching real-time leak
+            // events relayed by the gateway over AWS (#1276)
+            if (hasProperty(parsedSettings, 'sno') && parsedSettings.gatewayInfo?.device) {
+              accessory.context.gatewaySno = parsedSettings.sno
+              accessory.context.gatewayDevice = parsedSettings.gatewayInfo.device
+            }
+
             // Leak Sensors - check to see of any warnings if the lastTime is above 0
             let hasUnreadLeak = false
             if (parsedData.lastTime > 0) {
@@ -1805,9 +1821,46 @@ export default class {
   receiveUpdateAWS(payload) {
     const accessoryUUID = this.api.hap.uuid.generate(payload.device)
     const accessory = devicesInHB.get(accessoryUUID)
-    this.receiveDeviceUpdate(accessory, {
-      source: 'AWS',
-      ...payload,
+    if (accessory) {
+      this.receiveDeviceUpdate(accessory, {
+        source: 'AWS',
+        ...payload,
+      })
+      return
+    }
+
+    // No matching accessory - the message may be from a wifi gateway (e.g. H5044)
+    // relaying an update for one of its subdevices, such as a leak sensor (#1276)
+    this.receiveUpdateAWSGateway(payload)
+  }
+
+  receiveUpdateAWSGateway(payload) {
+    (payload?.op?.command || []).forEach((command) => {
+      let hexString
+      try {
+        hexString = base64ToHex(command)
+      } catch {
+        return
+      }
+
+      // 0xEE34 is a gateway subdevice status, laid out as:
+      // ee 34 [subdevice number] 02 00 64 1e 14 [seq] [unix time x4] [leak flags x4] 80 00 [checksum]
+      if (!hexString.startsWith('ee34') || hexString.length < 36) {
+        return
+      }
+      const subdeviceNo = Number.parseInt(hexString.substring(4, 6), 16)
+      const leakDetected = hexString.substring(26, 34) !== '00000000'
+
+      // Match the update to the leak sensor with this gateway and slot number
+      devicesInHB.forEach((accessory) => {
+        if (
+          accessory.context.gatewayDevice === payload.device
+          && accessory.context.gatewaySno === subdeviceNo
+          && platformConsts.models.sensorLeak.includes(accessory.context.gvModel)
+        ) {
+          this.receiveDeviceUpdate(accessory, { source: 'AWS', leakDetected })
+        }
+      })
     })
   }
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@homebridge-plugins/homebridge-govee",
   "alias": "Govee",
   "type": "module",
-  "version": "11.26.0",
+  "version": "11.26.1-beta.0",
   "description": "Homebridge plugin to integrate Govee devices into HomeKit.",
   "author": {
     "name": "bwp91",