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

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 1.0.9
+
+- Fixed the custom Homebridge settings UI so toggling Adaptive Lighting marks the config as changed and enables **Save Configuration**.
+- Save now performs a final existing-auth check before blocking, so normal configuration-only changes are not prevented when a QR auth token is already saved.
+- Name and AC override UI changes also mark the custom config as dirty more reliably.
+
+## 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,36 @@ Fahrenheit display examples:
 
 HomeKit stores temperature characteristic metadata in Celsius. Do not enter Fahrenheit values in the plugin config.
 
+
+## Adaptive Lighting
+
+
+### v1.0.9 UI save-state fix
+
+Version 1.0.9 fixes the custom settings UI so changing the Adaptive Lighting checkbox immediately enables **Save Configuration**. If QR authentication is already saved, the UI performs a final auth check during save and no longer blocks normal configuration-only changes.
+
+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">
@@ -178,6 +191,7 @@
   let currentConfig = null;
   let pollTimer = null;
   let isAuthenticated = false;
+  let isDirty = false;
   let detectedDevices = [];
 
   const $ = (id) => document.getElementById(id);
@@ -213,6 +227,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 = [];
     }
@@ -255,6 +270,11 @@
     if (homebridge.enableSaveButton) homebridge.enableSaveButton();
   }
 
+  function markDirty() {
+    isDirty = true;
+    enableSaving();
+  }
+
   function getDeviceName(id) {
     const device = detectedDevices.find((item) => item.id === id);
     return device ? device.name : '';
@@ -403,9 +423,7 @@
       const name = getDeviceName(id) || id;
       setAcStatus(`AC override saved in plugin config for ${name}: ${minTemperature}–${maxTemperature} °C, step ${temperatureStep} °C. Click Save Configuration when ready.`, 'success');
       homebridge.toast.success('AC temperature override added to config.', 'Tuya');
-      if (isAuthenticated) {
-        enableSaving();
-      }
+      markDirty();
     } catch (e) {
       setAcStatus(e.message || 'Failed to add AC override.', 'danger');
     }
@@ -439,9 +457,7 @@
       setAcStatus('Selected AC override was removed from the plugin config. Click Save Configuration when ready.', 'success');
       homebridge.toast.success('AC temperature override removed from config.', 'Tuya');
     }
-    if (isAuthenticated) {
-      enableSaving();
-    }
+    markDirty();
   }
 
   async function checkAuth(showSuccessToast = false) {
@@ -586,18 +602,24 @@
   }
 
   async function saveConfig() {
-    if (!isAuthenticated) {
-      setStatus('Scan and approve the QR code before saving.', 'warning');
-      return;
-    }
-
     const userCode = getUserCode();
     if (!userCode) {
       setStatus('User Code is required before saving.', 'warning');
+      homebridge.toast.error('User Code is required before saving.', 'Tuya');
       return;
     }
 
     try {
+      if (!isAuthenticated) {
+        // Do a last auth check here. This prevents normal configuration-only changes
+        // such as Adaptive Lighting from being blocked when the token already exists
+        // but this UI session has not marked itself authenticated yet.
+        const auth = await homebridge.request('/auth/status', { userCode });
+        isAuthenticated = !!auth.authenticated;
+        if (!isAuthenticated) {
+          throw new Error('Scan and approve the QR code, or click Check Existing Auth, before saving.');
+        }
+      }
       homebridge.showSpinner();
       $('tuyaNodevSave').disabled = true;
 
@@ -635,11 +657,13 @@
 
       if (saveTimedOut && verified) {
         const message = 'Configuration appears to be saved, but Homebridge UI did not return a save confirmation. Close this settings window and restart Homebridge.';
+        isDirty = false;
         homebridge.toast.success(message, 'Tuya');
         setStatus(message, 'success');
         return;
       }
 
+      isDirty = false;
       homebridge.toast.success('Configuration saved. Restart Homebridge to load devices.', 'Tuya');
       setStatus('Configuration saved. Restart Homebridge to load devices.', 'success');
     } catch (e) {
@@ -647,7 +671,7 @@
       homebridge.toast.error(e.message || 'Failed to save configuration.', 'Tuya');
     } finally {
       homebridge.hideSpinner();
-      if (isAuthenticated) {
+      if (isAuthenticated || isDirty) {
         $('tuyaNodevSave').disabled = false;
       }
     }
@@ -665,6 +689,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 +700,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();
         }
       });
@@ -683,7 +709,15 @@
       $('tuyaNodevCheck').addEventListener('click', () => checkAuth(true));
       $('tuyaNodevClear').addEventListener('click', clearAuth);
       $('tuyaNodevSave').addEventListener('click', saveConfig);
-      $('tuyaNodevName').addEventListener('input', syncConfigToUi);
+      $('tuyaNodevName').addEventListener('input', async () => {
+        await syncConfigToUi();
+        markDirty();
+      });
+      $('tuyaNodevAdaptiveLighting').addEventListener('change', async () => {
+        await syncConfigToUi();
+        markDirty();
+        setStatus('Adaptive Lighting setting changed. Click Save Configuration when ready.', 'info');
+      });
       $('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.9",
   "description": "Homebridge plugin for Tuya and Smart Life devices using QR cloud authentication without a Tuya IoT developer account.",
   "license": "MIT",
   "author": "Kosztyk",