homebridge-tuya-without-developer-account 1.0.7 → 1.0.8

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.0.8
+
+- Added optional HomeKit Adaptive Lighting support for eligible Tuya lights.
+- Added global `options.enableAdaptiveLighting` setting in the Homebridge custom UI.
+- Added per-device `deviceOverrides[].adaptiveLighting.enabled` override support.
+- Adaptive Lighting is enabled only when a light exposes both Brightness and a real ColorTemperature DP. RGB-only lights, brightness-only dimmers, switches, and outlets are skipped automatically.
+- Added safer logging when Adaptive Lighting is disabled or skipped for unsupported lights.
+
 ## 1.0.7
 
 - Added Smart Pet Feeder support for `quick_feed`, `manual_feed`, `slow_feed`, `feed_state`, battery, and charging state.

package/README.md

@@ -247,6 +247,31 @@ Fahrenheit display examples:
 
 HomeKit stores temperature characteristic metadata in Celsius. Do not enter Fahrenheit values in the plugin config.
 
+
+## Adaptive Lighting
+
+Version 1.0.8 adds optional HomeKit Adaptive Lighting support. Enable it in the Homebridge plugin settings with **Enable Adaptive Lighting for eligible CCT/RGBCW lights**.
+
+Adaptive Lighting is applied only to Tuya light accessories that expose both:
+
+- Brightness
+- A real white color-temperature datapoint, such as `temp_value` or `temp_value_v2`
+
+The plugin automatically skips RGB-only lights, brightness-only dimmers such as DP10 dimmer plugs, outlets, switches, and devices without a real color-temperature datapoint. HomeKit automatic mode may send periodic color-temperature updates while Adaptive Lighting is active.
+
+Advanced per-device override example:
+
+```json
+{
+  "id": "YOUR_LIGHT_DEVICE_ID",
+  "adaptiveLighting": {
+    "enabled": true
+  }
+}
+```
+
+Set `enabled` to `false` to disable Adaptive Lighting for one device even when the global option is enabled.
+
 ## Troubleshooting
 
 ### Plugin starts from cache only and logs `Each device override must include an "id"`

package/SUPPORTED_DEVICES.md

@@ -229,3 +229,9 @@ Supported when Tuya exposes `master_mode`. Alarm-triggered state is detected fro
 ### Aroma Diffuser with Empty Schema
 
 If Tuya QR cloud returns an empty schema for the diffuser device, direct device control cannot be mapped. The plugin keeps diffuser Tuya scenes exposed and logs a clearer explanation.
+
+## Adaptive Lighting support
+
+Adaptive Lighting is supported for eligible Tuya light accessories that expose both brightness and real white color-temperature datapoints, for example CCT, CW, or RGBCW lights.
+
+Not eligible: simple on/off lights, outlets, switches, brightness-only dimmers, DP10 dimmer plugs, and RGB-only lights without a real white-temperature datapoint.

package/config.schema.json

@@ -36,6 +36,12 @@
               "type": "string"
             }
           },
+          "enableAdaptiveLighting": {
+            "type": "boolean",
+            "title": "Enable Adaptive Lighting for eligible lights",
+            "description": "Optional. Enables HomeKit Adaptive Lighting only for Tuya lights that expose both brightness and real white color-temperature controls. RGB-only lights and dimmer plugs are skipped.",
+            "default": false
+          },
           "deviceOverrides": {
             "type": "array",
             "title": "Device Overrides",
@@ -57,8 +63,23 @@
                   "default": false
                 },
                 "adaptiveLighting": {
-                  "type": "boolean",
-                  "title": "Enable Adaptive Lighting",
+                  "title": "Adaptive Lighting Override",
+                  "description": "Optional per-device override. Use enabled=true to force-enable for this device, or enabled=false to disable it even when global Adaptive Lighting is enabled.",
+                  "oneOf": [
+                    {
+                      "type": "boolean",
+                      "title": "Enabled"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "enabled": {
+                          "type": "boolean",
+                          "title": "Enabled"
+                        }
+                      }
+                    }
+                  ],
                   "default": false
                 },
                 "schema": {
@@ -194,6 +215,7 @@
       "expanded": false,
       "items": [
         "options.homeWhitelist",
+        "options.enableAdaptiveLighting",
         "options.deviceOverrides",
         "options.debug",
         "options.debugLevel"

package/dist/platform.js

@@ -47,6 +47,7 @@ class TuyaPlatform {
     // Old Tuya IoT OpenAPI credentials, local LAN mode, username/password login, and hybrid mode are not accepted.
     this.config.mode = "cloud";
     this.options.projectType = "3";
+    this.options.enableAdaptiveLighting = this.options.enableAdaptiveLighting === true;
 
     if (!this.options.userCode || String(this.options.userCode).trim().length === 0) {
       this.log.error("[Tuya QR] Missing Tuya User Code. Open Homebridge UI → Plugins → Tuya without developer account for Homebridge → Settings, generate/scan the QR code, then save.");
@@ -150,6 +151,16 @@ class TuyaPlatform {
           delete item.alarm;
         }
       }
+      if (item.adaptiveLighting !== undefined) {
+        if (typeof item.adaptiveLighting === 'boolean') {
+          item.adaptiveLighting = { enabled: item.adaptiveLighting };
+        } else if (item.adaptiveLighting && typeof item.adaptiveLighting === 'object' && typeof item.adaptiveLighting.enabled === 'boolean') {
+          item.adaptiveLighting = { enabled: item.adaptiveLighting.enabled };
+        } else {
+          this.log.warn('[Tuya QR] Ignoring invalid adaptiveLighting override for id "%s". Use true/false or { enabled: true/false }.', id);
+          delete item.adaptiveLighting;
+        }
+      }
       seenIds.add(id);
       validOverrides.push(item);
     }
@@ -279,7 +290,8 @@ class TuyaPlatform {
         airConditioner: deviceConfig?.airConditioner ? JSON.stringify(deviceConfig.airConditioner) : undefined,
         petFeeder: deviceConfig?.petFeeder ? JSON.stringify(deviceConfig.petFeeder) : undefined,
         alarm: deviceConfig?.alarm ? JSON.stringify(deviceConfig.alarm) : undefined,
-        adaptiveLighting: deviceConfig?.adaptiveLighting ?? false,
+        globalAdaptiveLighting: !!this.options.enableAdaptiveLighting,
+        adaptiveLighting: deviceConfig?.adaptiveLighting ? JSON.stringify(deviceConfig.adaptiveLighting) : undefined,
       };
       const { changed: configChanged } = this.configHash.hasConfigChanged(device.id, configToHash);
       device.configChanged = configChanged;

package/dist/shared/accessories/characteristic/Light.js

@@ -249,20 +249,53 @@ function configureLight(accessory, service, onSchema, brightSchema, tempSchema,
     }
     configureAdaptiveLighting(accessory, service, brightSchema, tempSchema);
 }
-function configureAdaptiveLighting(accessory, service, brightSchema, tempSchema) {
+function getAdaptiveLightingOverride(config) {
+    if (!config || config.adaptiveLighting === undefined) {
+        return undefined;
+    }
+    if (typeof config.adaptiveLighting === 'boolean') {
+        return config.adaptiveLighting;
+    }
+    if (config.adaptiveLighting && typeof config.adaptiveLighting === 'object' && typeof config.adaptiveLighting.enabled === 'boolean') {
+        return config.adaptiveLighting.enabled;
+    }
+    return undefined;
+}
+function shouldEnableAdaptiveLighting(accessory) {
     const config = accessory.platform.getDeviceConfig(accessory.device);
-    if (!config || config.adaptiveLighting !== true) {
+    const override = getAdaptiveLightingOverride(config);
+    if (override !== undefined) {
+        return override;
+    }
+    return accessory.platform.options.enableAdaptiveLighting === true;
+}
+function configureAdaptiveLighting(accessory, service, brightSchema, tempSchema) {
+    if (!shouldEnableAdaptiveLighting(accessory)) {
         accessory.log.info('Adaptive Lighting disabled.');
         return;
     }
-    accessory.log.info('Adaptive Lighting enabled.');
     if (!brightSchema || !tempSchema) {
-        accessory.log.warn('Adaptive Lighting not supported. Missing brightness or color temperature schema.');
+        accessory.log.info('Adaptive Lighting skipped: this light does not expose both brightness and a real color-temperature DP.');
+        return;
+    }
+    if (!service.testCharacteristic(accessory.Characteristic.Brightness) || !service.testCharacteristic(accessory.Characteristic.ColorTemperature)) {
+        accessory.log.info('Adaptive Lighting skipped: HomeKit Lightbulb service is missing Brightness or ColorTemperature.');
         return;
     }
     const { AdaptiveLightingController } = accessory.platform.api.hap;
-    const controller = new AdaptiveLightingController(service);
-    accessory.accessory.configureController(controller);
-    accessory.adaptiveLightingController = controller;
+    if (!AdaptiveLightingController) {
+        accessory.log.warn('Adaptive Lighting skipped: this Homebridge/HAP-NodeJS version does not expose AdaptiveLightingController.');
+        return;
+    }
+    try {
+        const controller = new AdaptiveLightingController(service);
+        accessory.accessory.configureController(controller);
+        accessory.adaptiveLightingController = controller;
+        accessory.log.info('Adaptive Lighting enabled for eligible CCT/RGBCW light.');
+    }
+    catch (error) {
+        accessory.log.warn(`Adaptive Lighting setup failed: ${error instanceof Error ? error.message : error}`);
+    }
 }
+
 //# sourceMappingURL=Light.js.map

package/homebridge-ui/public/index.html

@@ -114,6 +114,19 @@
   </div>
 </div>
 
+
+<div class="tuya-nodev-card">
+  <div class="tuya-nodev-title">Adaptive Lighting</div>
+  <p class="tuya-nodev-small mb-3">
+    Enable HomeKit Adaptive Lighting only for eligible Tuya lights that expose both brightness and real white color-temperature controls. RGB-only lights, dimmer plugs, switches, and outlets are skipped automatically.
+  </p>
+  <div class="form-check">
+    <input id="tuyaNodevAdaptiveLighting" class="form-check-input" type="checkbox">
+    <label class="form-check-label" for="tuyaNodevAdaptiveLighting">Enable Adaptive Lighting for eligible CCT/RGBCW lights</label>
+  </div>
+  <small class="form-text text-muted">HomeKit automatic mode may send color-temperature updates roughly once per minute while Adaptive Lighting is active.</small>
+</div>
+
 <div class="tuya-nodev-card">
   <div class="tuya-nodev-title">Air Conditioner Temperature Overrides</div>
   <p class="tuya-nodev-small mb-3">
@@ -213,6 +226,7 @@
     cfg.options = cfg.options && typeof cfg.options === 'object' ? cfg.options : {};
     cfg.options.userCode = getUserCode();
     cfg.options.projectType = '3';
+    cfg.options.enableAdaptiveLighting = $('tuyaNodevAdaptiveLighting')?.checked === true;
     if (!Array.isArray(cfg.options.deviceOverrides)) {
       cfg.options.deviceOverrides = [];
     }
@@ -665,6 +679,7 @@
       ensureConfig();
       $('tuyaNodevName').value = currentConfig.name || 'Tuya without developer account';
       $('tuyaNodevUserCode').value = currentConfig.options?.userCode || '';
+      $('tuyaNodevAdaptiveLighting').checked = currentConfig.options?.enableAdaptiveLighting === true;
 
       if (homebridge.showSchemaForm) homebridge.showSchemaForm();
       window.homebridge.addEventListener('configChanged', (event) => {
@@ -675,6 +690,7 @@
           ensureConfig();
           if (block.name) $('tuyaNodevName').value = block.name;
           if (block.options?.userCode) $('tuyaNodevUserCode').value = block.options.userCode;
+          $('tuyaNodevAdaptiveLighting').checked = block.options?.enableAdaptiveLighting === true;
           renderAcOverrides();
         }
       });
@@ -684,6 +700,10 @@
       $('tuyaNodevClear').addEventListener('click', clearAuth);
       $('tuyaNodevSave').addEventListener('click', saveConfig);
       $('tuyaNodevName').addEventListener('input', syncConfigToUi);
+      $('tuyaNodevAdaptiveLighting').addEventListener('change', async () => {
+        await syncConfigToUi();
+        if (isAuthenticated) enableSaving();
+      });
       $('tuyaNodevUserCode').addEventListener('input', () => {
         isAuthenticated = false;
         disableSaving();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-tuya-without-developer-account",
   "displayName": "Tuya without developer account for Homebridge",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Homebridge plugin for Tuya and Smart Life devices using QR cloud authentication without a Tuya IoT developer account.",
   "license": "MIT",
   "author": "Kosztyk",