homebridge-tuya-community 3.3.1 → 3.3.2

package/Changelog.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project will be documented in this file. This project uses [semantic versioning](https://semver.org/).
 
+## 3.3.2 (2026-01-10)
+
+### Added
+- **Custom Serial Number** - New `serialNumber` config option to set a custom serial number for devices in HomeKit
+- **Firmware Version** - New `firmwareVersion` config option to display a custom firmware version in HomeKit
+
+These options are available for all device types and will appear in the Home app's accessory details.
+
+
+## 3.3.1 (2026-01-09)
+
+### 🐛 Bug Fixes
+- **Fixed undefined variable `rl`** in cli-decode.js that would crash on invalid input.
+- **Fixed undefined variable `service`** in AirPurifierAccessory.js when `noChildLock` is enabled.
+- **Fixed undefined variable `characteristicRotationSpeed`** in DehumidifierAccessory.js (was referencing wrong variable name).
+- Removed unreachable code after return statements in SimpleFanAccessory.js and SimpleFanLightAccessory.js.
+
+### 🧹 Code Quality
+- Added ESLint compliance across entire codebase (52 issues resolved).
+- Improved code quality with explicit handling of intentionally empty catch blocks.
+
+
 ## 3.3.0 (2026-01-09)
 
 ### Added

package/config.schema.json

@@ -181,6 +181,20 @@
                   "functionBody": "return model.devices && model.devices[arrayIndices].type !== 'null';"
                 }
               },
+              "serialNumber": {
+                "type": "string",
+                "description": "Custom serial number for this device. If not set, uses last 14 characters of the Tuya ID.",
+                "condition": {
+                  "functionBody": "return model.devices && model.devices[arrayIndices].type !== 'null';"
+                }
+              },
+              "firmwareVersion": {
+                "type": "string",
+                "description": "Firmware version to display in HomeKit for this device.",
+                "condition": {
+                  "functionBody": "return model.devices && model.devices[arrayIndices].type !== 'null';"
+                }
+              },
               "voltsId": {
                 "type": "integer",
                 "placeholder": "9",

package/index.js

@@ -236,7 +236,8 @@ class TuyaLan {
             accessory.getService(Service.AccessoryInformation)
                 .setCharacteristic(Characteristic.Manufacturer, deviceConfig.manufacturer || 'Unknown')
                 .setCharacteristic(Characteristic.Model, deviceConfig.model || 'Unknown')
-                .setCharacteristic(Characteristic.SerialNumber, deviceConfig.id.slice(8));
+                .setCharacteristic(Characteristic.SerialNumber, deviceConfig.serialNumber || deviceConfig.id.slice(8))
+                .setCharacteristic(Characteristic.FirmwareRevision, deviceConfig.firmwareVersion || '1.0');
 
             isCached = false;
         }

package/lib/CustomMultiLightAccessory.js

@@ -48,7 +48,8 @@ class CustomMultiLightAccessory {
                 gangAccessory.getService(Service.AccessoryInformation)
                     .setCharacteristic(Characteristic.Manufacturer, device.context.manufacturer || "Unknown")
                     .setCharacteristic(Characteristic.Model, device.context.model || "Unknown")
-                    .setCharacteristic(Characteristic.SerialNumber, device.context.id.slice(8) + '-' + light.dp);
+                    .setCharacteristic(Characteristic.SerialNumber, (device.context.serialNumber || device.context.id.slice(8)) + '-' + light.dp)
+                    .setCharacteristic(Characteristic.FirmwareRevision, device.context.firmwareVersion || '1.0');
             }
 
             if (gangAccessory.displayName !== gangName) {

package/lib/DehumidifierAccessory.js

@@ -54,6 +54,8 @@ class DehumidifierAccessory extends BaseAccessory {
         const infoService = this.accessory.getService(Service.AccessoryInformation);
         infoService.getCharacteristic(Characteristic.Manufacturer).updateValue(this.device.context.manufacturer);
         infoService.getCharacteristic(Characteristic.Model).updateValue(this.device.context.model);
+        infoService.getCharacteristic(Characteristic.SerialNumber).updateValue(this.device.context.serialNumber || this.device.context.id.slice(8));
+        infoService.getCharacteristic(Characteristic.FirmwareRevision).updateValue(this.device.context.firmwareVersion || '1.0');
 
         const _characteristicTemperature = this.accessory.getService(Service.TemperatureSensor)
             .getCharacteristic(Characteristic.CurrentTemperature)

package/lib/MultiLightAccessory.js

@@ -42,7 +42,8 @@ class MultiLightAccessory {
                 gangAccessory.getService(Service.AccessoryInformation)
                     .setCharacteristic(Characteristic.Manufacturer, device.context.manufacturer || "Unknown")
                     .setCharacteristic(Characteristic.Model, device.context.model || "Unknown")
-                    .setCharacteristic(Characteristic.SerialNumber, device.context.id.slice(8) + '-' + i);
+                    .setCharacteristic(Characteristic.SerialNumber, (device.context.serialNumber || device.context.id.slice(8)) + '-' + i)
+                    .setCharacteristic(Characteristic.FirmwareRevision, device.context.firmwareVersion || '1.0');
             }
 
             if (gangAccessory.displayName !== gangName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-tuya-community",
-  "version": "3.3.1",
+  "version": "3.3.2",
   "description": "A Homebridge plugin to control Tuya devices locally. Community maintained version of homebridge-tuya that supports new device types.",
   "main": "index.js",
   "scripts": {