@homebridge-plugins/homebridge-tuya 3.0.0-beta.1 → 3.0.0-beta.10

package/ADVANCED_OPTIONS.md

@@ -20,6 +20,7 @@ Before configuring, you may need to:
 - `category` - **optional**: Device category code. See [SUPPORTED_DEVICES.md](./SUPPORTED_DEVICES.md). Also you can use `hidden` to hide the device, product, or scene. **⚠️Overriding this property may lead to unexpected behaviors and exceptions, so please remove the accessory cache after making changes.**
 - `unbridged` - **optional**: Unbridge accessories. Defaults to `false`.
 - `adaptiveLighting` - **optional**: Adaptive Lighting. Defaults to `false`. Not all light device support this feature, please use it on demand.
+- `garageDoorUseContactSensorForState` - **optional**: For garage door controllers. When `true`, `CurrentDoorState` and `TargetDoorState` reads use `doorcontact_state` only, while set commands still use `switch_1`. Defaults to `false`.
 - `schema` - **optional**: An array of schema overriding config objects, used for describing datapoint (DP). When your device has non-standard DP, you need to transform them manually with configuration. Each element in the schema array is described as follows:
   - `code` - **required**: DP code.
   - `newCode` - **optional**: New DP code.
@@ -94,6 +95,22 @@ An example of hide camera's floodlight (`floodlight_switch`):
 }
 ```
 
+### Use garage door contact sensor for state
+
+Some `ckmkzq` garage door controllers keep `switch_1` as `true`, which can make HomeKit show the door as stuck Opening or Closing. Enable this per-device option to read the door state from `doorcontact_state`, while commands are still sent to `switch_1`.
+
+```js
+{
+  "options": {
+    // ...
+    "deviceOverrides": [{
+      "id": "{device_id}",
+      "garageDoorUseContactSensorForState": true
+    }]
+  }
+}
+```
+
 
 ### Offline as off
 

package/README.md

@@ -3,7 +3,7 @@
 [![verified-by-homebridge](https://img.shields.io/badge/homebridge-verified-blueviolet?color=%23491F59&style=for-the-badge&logoColor=%23FFFFFF&logo=homebridge)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
 
 ![node](https://badgen.net/npm/node/@homebridge-plugins/homebridge-tuya)
-![homebridge](https://img.shields.io/github/package-json/dependency-version/homebridge-plugins/homebridge-tuya/dev/homebridge)
+![homebridge](https://img.shields.io/github/package-json/dependency-version/homebridge-plugins/homebridge-tuya/peer/homebridge)
 
 [![Sponsor](https://img.shields.io/badge/Sponsor-❤-ff69b4)](https://github.com/sponsors/tassy-h)
 [![version](https://badgen.net/npm/v/@homebridge-plugins/homebridge-tuya)](https://npmjs.com/package/@homebridge-plugins/homebridge-tuya)
@@ -174,12 +174,18 @@ Communicates directly with your Tuya devices over LAN — no internet or Tuya Cl
 ### Both Mode (`mode: "both"`)
 
 Uses cloud + local simultaneously. Provide both `options` (cloud) and `local` blocks.
-
+- Local LAN commands are attempted first when the device is available locally.
+- The cloud connection remains active as a fallback.
+- This fallback is only used when a local command does not receive confirmation within 10 seconds; normal local commands remain local.
+- If a local command does not receive confirmation within 10 seconds, the plugin automatically retries it via cloud.
+- Cloud status updates can also satisfy pending local commands so the device does not get double-sent commands.
 ---
 
 ### Advanced Options
 See [ADVANCED_OPTIONS.md](./ADVANCED_OPTIONS.md)
 
+Garage door controllers that keep `switch_1=true` can opt in to contact-sensor-only state reads with `garageDoorUseContactSensorForState` in `options.deviceOverrides`. This keeps commands on `switch_1`, but reads HomeKit state from `doorcontact_state`.
+
 
 ## Limitations
 - Using the same app account for multiple Homebridge/HomeAssistant instances is not recommended. Use separate app accounts per instance.