@riddix/hamh 2.0.28 → 2.0.30

package/README.md

@@ -37,7 +37,7 @@ of port forwarding etc.
 
 | Channel | Branch | Current Version | Description |
 |---------|--------|-----------------|-------------|
-| **Stable** | `main` | v2.0.28 | Production-ready, recommended for most users |
+| **Stable** | `main` | v2.0.30 | Production-ready, recommended for most users |
 | **Alpha** | `alpha` | v2.1.0-alpha.x | Pre-release with new features, for early adopters |
 | **Testing** | `testing` | v4.1.0-testing.x | ⚠️ **Highly unstable!** Experimental features, may break |
 
@@ -52,44 +52,30 @@ of port forwarding etc.
 ## 🎉 What's New
 
 <details>
-<summary><strong>📦 Stable Features (v2.0.28)</strong> - Click to expand</summary>
+<summary><strong>📦 Stable Features (v2.0.30)</strong> - Click to expand</summary>
 
-**New in v2.0.28:**
+**New in v2.0.30:**
 
 | Feature | Description |
 |---------|-------------|
-| **🖼️ Device Image Support** | Device cards show images from Zigbee2MQTT or custom uploads ([#221](https://github.com/RiDDiX/home-assistant-matter-hub/issues/221)) |
-| **🌀 Custom Fan Speed Mapping** | Define custom fan speed levels with named presets ([#226](https://github.com/RiDDiX/home-assistant-matter-hub/pull/226)) |
-| **📺 TV Source Selection** | MediaInput cluster added to VideoPlayerDevice for input switching ([#231](https://github.com/RiDDiX/home-assistant-matter-hub/issues/231)) |
-| **🔀 Reverse Proxy Base Path** | `--http-base-path` option for subfolder reverse proxy support ([#228](https://github.com/RiDDiX/home-assistant-matter-hub/issues/228)) |
-| **🌀 On/Off-Only Fans** | Fans without speed control correctly use OnOffPlugInUnit ([#229](https://github.com/RiDDiX/home-assistant-matter-hub/issues/229)) |
-| **💡 Light Brightness Fix** | Prevent brightness reset on turn-on by setting onLevel to null ([#225](https://github.com/RiDDiX/home-assistant-matter-hub/issues/225)) |
-| **🌀 Fan Speed Fixes** | speedMax cap raised from 10 to 100 (Matter spec max), retain speed when off ([#225](https://github.com/RiDDiX/home-assistant-matter-hub/issues/225)) |
-| **🌡️ Composed Air Purifier Fix** | Flatten to single endpoint for correct Apple Home primary tile ([#218](https://github.com/RiDDiX/home-assistant-matter-hub/issues/218)) |
-| **🤖 Dreame Multi-Floor Fix** | Switch floor map before vacuum_clean_segment for multi-floor rooms |
-| **🤖 Custom Service Areas Fix** | Register as RvcRunMode room modes for Apple Home zone dispatch |
-| **⚡ Optimistic State Updates** | Level and color control commands respond immediately |
-| **�️ Frontend Improvements** | Error boundary, 404 page, WCAG contrast, theme-aware UI, HA ingress compatibility |
-
-**Previously in v2.0.27:**
+| **� Mapped Entity Propagation Fix** | Propagate mapped entity changes (battery, humidity, etc.) to Matter endpoints — fixes stale sensor readings |
+| **🖥️ API Error Surfacing** | Surface API errors instead of silently swallowing them ([#232](https://github.com/RiDDiX/home-assistant-matter-hub/issues/232)) |
+
+**Previously in v2.0.29:**
 
 | Feature | Description |
 |---------|-------------|
-| **🤖 Native Valetudo Support** | Auto-detect Valetudo select entities, map segments, use `segment_cleanup` via MQTT for room cleaning ([#205](https://github.com/RiDDiX/home-assistant-matter-hub/issues/205)) |
-| **🤖 Custom Service Areas** | Define custom room/zone names for generic zone-based robots without native room support ([#177](https://github.com/RiDDiX/home-assistant-matter-hub/issues/177)) |
-| **🚨 Alarm Control Panel** | `alarm_control_panel` entities exposed as Matter ModeSelect — arm/disarm modes available in controllers ([#209](https://github.com/RiDDiX/home-assistant-matter-hub/issues/209)) |
-| **🌡️ Composed Air Purifier** | Air purifiers with thermostat/humidity sensors create real Matter Composed Devices (spec 9.4.4) |
-| **🏢 Vendor Brand Icons** | 20+ new manufacturer icons (Razer, Roborock, iRobot, Signify, and more) |
-| **� linux/arm/v7 Docker** | Added ARM v7 platform for standalone Docker image |
-| **🌡️ Thermostat Fixes** | heat_cool-only zones, SmartIR AC conformance fix ([#207](https://github.com/RiDDiX/home-assistant-matter-hub/issues/207), [#28](https://github.com/RiDDiX/home-assistant-matter-hub/issues/28)) |
-| **🔧 Air Purifier Fix** | Added Rocking (oscillation) and Wind feature support, removed incorrect Lighting feature |
+| **� Light currentLevel Fix** | Retain light currentLevel when off to prevent Apple Home 100% brightness on turn-on ([#225](https://github.com/RiDDiX/home-assistant-matter-hub/issues/225)) |
+| **�️ Bridge Config Save Fix** | Decouple save button from RJSF schema validation errors ([#232](https://github.com/RiDDiX/home-assistant-matter-hub/issues/232)) |
+| **🌀 Fan Device Feature Fix** | Correct FanDeviceFeature TURN_ON/TURN_OFF enum values to match Home Assistant |
+| **🌡️ Humidity Auto-Mapping Fix** | Correct autoHumidityMapping schema default to match runtime behavior |
 
 </details>
 
 <details>
 <summary><strong>🧪 Alpha Features (v2.1.0-alpha.x)</strong> - Click to expand</summary>
 
-**Alpha is currently in sync with Stable (v2.0.28).** All alpha features have been promoted to stable. New alpha features will appear here as development continues.
+**Alpha is currently in sync with Stable (v2.0.30).** All alpha features have been promoted to stable. New alpha features will appear here as development continues.
 
 </details>
 
@@ -115,6 +101,12 @@ of port forwarding etc.
 <details>
 <summary><strong>📜 Previous Stable Versions</strong> - Click to expand</summary>
 
+### v2.0.29
+Light currentLevel Fix, Bridge Config Save Fix, Fan Device Feature Fix, Humidity Auto-Mapping Fix
+
+### v2.0.28
+Device Image Support, Custom Fan Speed Mapping, TV Source Selection, Reverse Proxy Base Path, On/Off-Only Fans, Light Brightness Fix, Fan Speed Fixes, Composed Air Purifier Fix, Dreame Multi-Floor Fix, Optimistic State Updates, Frontend Improvements
+
 ### v2.0.27
 Valetudo support, Custom Service Areas, ServiceArea Maps, Vacuum Identify/Locate/Charging, Alarm Control Panel, Composed Air Purifier, Dashboard Controls, Vendor Brand Icons, Thermostat fixes, Air Purifier oscillation/wind
 
@@ -450,6 +442,7 @@ Thank you to everyone who helps improve this project by reporting issues!
 | [@JRCondat](https://github.com/JRCondat) | 💎 Thank you for your generous support! |
 | Bonjon | 💎 Thank you for your generous support! |
 | TobiR | 💎 Thank you for your generous support! |
+| [@d3rby91](https://github.com/d3rby91) | 💎 Thank you for your generous support! |
 | *Anonymous supporters* | 🙏 Thank you to those who prefer not to be named - your support is equally appreciated! |
 
 ### 🌟 Original Author

package/dist/backend/cli.js

@@ -146220,8 +146220,8 @@ var init_fan = __esm({
       FanDeviceFeature2[FanDeviceFeature2["OSCILLATE"] = 2] = "OSCILLATE";
       FanDeviceFeature2[FanDeviceFeature2["DIRECTION"] = 4] = "DIRECTION";
       FanDeviceFeature2[FanDeviceFeature2["PRESET_MODE"] = 8] = "PRESET_MODE";
-      FanDeviceFeature2[FanDeviceFeature2["TURN_OFF"] = 16] = "TURN_OFF";
-      FanDeviceFeature2[FanDeviceFeature2["TURN_ON"] = 32] = "TURN_ON";
+      FanDeviceFeature2[FanDeviceFeature2["TURN_ON"] = 16] = "TURN_ON";
+      FanDeviceFeature2[FanDeviceFeature2["TURN_OFF"] = 32] = "TURN_OFF";
     })(FanDeviceFeature || (FanDeviceFeature = {}));
   }
 });
@@ -146694,7 +146694,7 @@ var init_bridge_config_schema = __esm({
           title: "Auto Humidity Mapping",
           description: "Automatically combine humidity sensors with temperature sensors from the same Home Assistant device. When enabled, humidity sensors will be merged into temperature sensors to create combined TemperatureHumiditySensor devices.",
           type: "boolean",
-          default: true
+          default: false
         },
         autoPressureMapping: {
           title: "Auto Pressure Mapping",
@@ -149030,7 +149030,8 @@ function matterApi(bridgeService, haRegistry) {
     const body = req.body;
     const isValid = ajv.validate(createBridgeRequestSchema, body);
     if (!isValid) {
-      res.status(400).json(ajv.errors);
+      const details = ajv.errors?.map((e) => `${e.instancePath || "/"}: ${e.message}`).join("; ") ?? "Unknown";
+      res.status(400).json({ error: `Validation failed: ${details}` });
     } else {
       try {
         const bridge = await bridgeService.create(body);
@@ -149071,7 +149072,8 @@ function matterApi(bridgeService, haRegistry) {
     const body = req.body;
     const isValid = ajv.validate(updateBridgeRequestSchema, body);
     if (!isValid) {
-      res.status(400).json(ajv.errors);
+      const details = ajv.errors?.map((e) => `${e.instancePath || "/"}: ${e.message}`).join("; ") ?? "Unknown";
+      res.status(400).json({ error: `Validation failed: ${details}` });
     } else if (bridgeId !== body.id) {
       res.status(400).send("Path variable `bridgeId` does not match `body.id`");
     } else {
@@ -164463,15 +164465,45 @@ import debounce4 from "debounce";
 // src/matter/endpoints/entity-endpoint.ts
 init_esm7();
 var EntityEndpoint = class extends Endpoint {
-  constructor(type, entityId, customName) {
+  constructor(type, entityId, customName, mappedEntityIds) {
     super(type, { id: createEndpointId(entityId, customName) });
     this.entityId = entityId;
+    this.mappedEntityIds = mappedEntityIds ?? [];
+  }
+  mappedEntityIds;
+  lastMappedStates = {};
+  hasMappedEntityChanged(states) {
+    let changed = false;
+    for (const mappedId of this.mappedEntityIds) {
+      const mappedState = states[mappedId];
+      if (!mappedState) continue;
+      const fp = mappedState.state;
+      if (fp !== this.lastMappedStates[mappedId]) {
+        this.lastMappedStates[mappedId] = fp;
+        changed = true;
+      }
+    }
+    return changed;
   }
 };
 function createEndpointId(entityId, customName) {
   const baseName = customName || entityId;
   return baseName.replace(/\./g, "_").replace(/\s+/g, "_");
 }
+function getMappedEntityIds(mapping) {
+  if (!mapping) return [];
+  const ids = [];
+  if (mapping.batteryEntity) ids.push(mapping.batteryEntity);
+  if (mapping.humidityEntity) ids.push(mapping.humidityEntity);
+  if (mapping.pressureEntity) ids.push(mapping.pressureEntity);
+  if (mapping.cleaningModeEntity) ids.push(mapping.cleaningModeEntity);
+  if (mapping.suctionLevelEntity) ids.push(mapping.suctionLevelEntity);
+  if (mapping.mopIntensityEntity) ids.push(mapping.mopIntensityEntity);
+  if (mapping.filterLifeEntity) ids.push(mapping.filterLifeEntity);
+  if (mapping.powerEntity) ids.push(mapping.powerEntity);
+  if (mapping.energyEntity) ids.push(mapping.energyEntity);
+  return ids;
+}
 
 // src/matter/endpoints/composed/composed-air-purifier-endpoint.ts
 init_dist();
@@ -169567,7 +169599,7 @@ var config8 = {
     if (brightness != null) {
       return brightness / 255;
     }
-    return 0;
+    return null;
   },
   moveToLevelPercent: (brightnessPercent) => ({
     action: "light.turn_on",
@@ -174790,10 +174822,11 @@ var LegacyEndpoint = class _LegacyEndpoint extends EntityEndpoint {
       return;
     }
     const customName = effectiveMapping?.customName;
-    return new _LegacyEndpoint(type, entityId, customName);
+    const mappedIds = getMappedEntityIds(effectiveMapping);
+    return new _LegacyEndpoint(type, entityId, customName, mappedIds);
   }
-  constructor(type, entityId, customName) {
-    super(type, entityId, customName);
+  constructor(type, entityId, customName, mappedEntityIds) {
+    super(type, entityId, customName, mappedEntityIds);
     this.flushUpdate = debounce4(this.flushPendingUpdate.bind(this), 50);
   }
   lastState;
@@ -174804,9 +174837,15 @@ var LegacyEndpoint = class _LegacyEndpoint extends EntityEndpoint {
   }
   async updateStates(states) {
     const state = states[this.entityId] ?? {};
-    if (state.state === this.lastState?.state && JSON.stringify(state.attributes) === JSON.stringify(this.lastState?.attributes)) {
+    const mappedChanged = this.hasMappedEntityChanged(states);
+    if (!mappedChanged && state.state === this.lastState?.state && JSON.stringify(state.attributes) === JSON.stringify(this.lastState?.attributes)) {
       return;
     }
+    if (mappedChanged) {
+      logger189.debug(
+        `Mapped entity change detected for ${this.entityId}, forcing update`
+      );
+    }
     logger189.debug(
       `State update received for ${this.entityId}: state=${state.state}`
     );
@@ -175105,12 +175144,26 @@ var BridgeEndpointManager = class extends Service {
     if (!this.entityIds.length) {
       return;
     }
+    const subscriptionIds = this.collectSubscriptionEntityIds();
     this.unsubscribe = subscribeEntities(
       this.client.connection,
       (e) => this.updateStates(e),
-      this.entityIds
+      subscriptionIds
     );
   }
+  collectSubscriptionEntityIds() {
+    const ids = new Set(this.entityIds);
+    const endpoints = this.root.parts.map((p) => p);
+    for (const endpoint of endpoints) {
+      const mappedIds = endpoint.mappedEntityIds;
+      if (mappedIds) {
+        for (const mappedId of mappedIds) {
+          ids.add(mappedId);
+        }
+      }
+    }
+    return [...ids];
+  }
   stopObserving() {
     this.unsubscribe?.();
     this.unsubscribe = void 0;
@@ -175235,6 +175288,7 @@ var BridgeEndpointManager = class extends Service {
     }
   }
   async updateStates(states) {
+    this.registry.mergeExternalStates(states);
     const endpoints = this.root.parts.map((p) => p);
     const results = await Promise.allSettled(
       endpoints.map((endpoint) => endpoint.updateStates(states))
@@ -175705,6 +175759,12 @@ var BridgeRegistry = class _BridgeRegistry {
   isEnergyEntityUsed(entityId) {
     return this._usedEnergyEntities.has(entityId);
   }
+  mergeExternalStates(states) {
+    const registryStates = this.registry.states;
+    for (const entityId of Object.keys(states)) {
+      registryStates[entityId] = states[entityId];
+    }
+  }
   /**
    * Get the area name for an entity, resolving from HA area registry.
    * Priority: entity area_id > device area_id > undefined
@@ -176401,12 +176461,18 @@ var ServerModeVacuumEndpoint = class _ServerModeVacuumEndpoint extends EntityEnd
     if (!endpointType) {
       return void 0;
     }
-    return new _ServerModeVacuumEndpoint(endpointType, entityId, customName);
+    const mappedIds = getMappedEntityIds(effectiveMapping);
+    return new _ServerModeVacuumEndpoint(
+      endpointType,
+      entityId,
+      customName,
+      mappedIds
+    );
   }
   lastState;
   flushUpdate;
-  constructor(type, entityId, customName) {
-    super(type, entityId, customName);
+  constructor(type, entityId, customName, mappedEntityIds) {
+    super(type, entityId, customName, mappedEntityIds);
     this.flushUpdate = debounce5(this.flushPendingUpdate.bind(this), 50);
   }
   async delete() {
@@ -176415,9 +176481,15 @@ var ServerModeVacuumEndpoint = class _ServerModeVacuumEndpoint extends EntityEnd
   }
   async updateStates(states) {
     const state = states[this.entityId] ?? {};
-    if (state.state === this.lastState?.state && JSON.stringify(state.attributes) === JSON.stringify(this.lastState?.attributes)) {
+    const mappedChanged = this.hasMappedEntityChanged(states);
+    if (!mappedChanged && state.state === this.lastState?.state && JSON.stringify(state.attributes) === JSON.stringify(this.lastState?.attributes)) {
       return;
     }
+    if (mappedChanged) {
+      logger192.debug(
+        `Mapped entity change detected for ${this.entityId}, forcing update`
+      );
+    }
     logger192.debug(
       `State update received for ${this.entityId}: state=${state.state}`
     );
@@ -176498,12 +176570,25 @@ var ServerModeEndpointManager = class extends Service {
     if (!this.entityIds.length) {
       return;
     }
+    const subscriptionIds = this.collectSubscriptionEntityIds();
     this.unsubscribe = subscribeEntities(
       this.client.connection,
       (e) => this.updateStates(e),
-      this.entityIds
+      subscriptionIds
     );
   }
+  collectSubscriptionEntityIds() {
+    const ids = new Set(this.entityIds);
+    if (this.deviceEndpoint) {
+      const mappedIds = this.deviceEndpoint.mappedEntityIds;
+      if (mappedIds) {
+        for (const mappedId of mappedIds) {
+          ids.add(mappedId);
+        }
+      }
+    }
+    return [...ids];
+  }
   stopObserving() {
     this.unsubscribe?.();
     this.unsubscribe = void 0;
@@ -176616,6 +176701,7 @@ var ServerModeEndpointManager = class extends Service {
     }
   }
   async updateStates(states) {
+    this.registry.mergeExternalStates(states);
     if (this.deviceEndpoint) {
       try {
         await this.deviceEndpoint.updateStates(states);