@riddix/hamh 2.1.0-alpha.629 → 2.1.0-alpha.631

package/README.md

@@ -37,7 +37,7 @@ of port forwarding etc.
 
 | Channel | Branch | Current Version | Description |
 |---------|--------|-----------------|-------------|
-| **Stable** | `main` | v2.0.38 | Production-ready, recommended for most users |
+| **Stable** | `main` | v2.0.41 | 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,15 +52,40 @@ of port forwarding etc.
 ## 🎉 What's New
 
 <details>
-<summary><strong>📦 Stable Features (v2.0.38)</strong> - Click to expand</summary>
+<summary><strong>📦 Stable Features (v2.0.41)</strong> - Click to expand</summary>
 
-**HOTFIX (post v2.0.38):**
+**New in v2.0.41:**
+
+| Feature | Description |
+|---------|-------------|
+| 🌡️ Google Home AC offline fix | `DeadFrontBehavior` on climate OnOff cluster so RoomAirConditioner stops showing offline on Google Home ([#302](https://github.com/RiDDiX/home-assistant-matter-hub/issues/302)) |
+| 🪟 Cover device_class mapping | Map HA `garage`/`gate`/`window`/`awning`/etc. to the matching Matter WindowCovering type so voice commands hit the right device type ([#304](https://github.com/RiDDiX/home-assistant-matter-hub/issues/304)) |
+| 📺 LG TV commissioning patch | Local patch on matter.js 0.16.11 to accept long NOC operational cert serials ([#305](https://github.com/RiDDiX/home-assistant-matter-hub/issues/305)) |
+| 💡 Alexa brightness-reset behind flag | Old Alexa brightness-reset heuristic moved behind `alexaPreserveBrightnessOnTurnOn`, default off — Apple Home "set room to 100%" works again ([#306](https://github.com/RiDDiX/home-assistant-matter-hub/issues/306)) |
+| 🌀 Google Home fan speed | Uses `fan.set_percentage` so already-on fans pick up speed changes from Google Home ([#308](https://github.com/RiDDiX/home-assistant-matter-hub/issues/308)) |
+| ❄️ Climate auto mode | Expose Matter Auto mode when HA reports `auto` in `hvac_modes` ([#309](https://github.com/RiDDiX/home-assistant-matter-hub/issues/309)) |
+| 🆔 Server-mode root identity | Root identity now applies as a single transaction, so controllers don't drop devices mid-swap ([#311](https://github.com/RiDDiX/home-assistant-matter-hub/issues/311)) |
+| 🪟 Lift-only blinds | No more `TiltBlindTiltOnly` on covers without tilt — fixes Alexa routines for roller blinds ([#312](https://github.com/RiDDiX/home-assistant-matter-hub/issues/312)) |
+| 🏷️ Per-entity `disableClimateOnOff` | Turn off the OnOff cluster on climate endpoints per entity for controllers that prefer mode-only control |
+| 🔢 `serialNumberSuffix` per bridge | Append a suffix to every entity serial — useful if controllers like Aqara cache stale device data |
+| 📝 `protocolLogLevel` option | Quiet matter.js logs independently from the app log level |
+| 🖥️ Bridge HW/SW version strings | HA device-registry `hw_version`/`sw_version` now show up in Matter BasicInformation on server-mode endpoints |
+| 🎨 Extended color light: XY + enhancedColorMode | XY feature added as mandatory, `enhancedColorMode` mirrors `colorMode` |
+| 🎭 Groups + Scenes | Scenes and Groups clusters added on light, plug, and fan endpoints |
+| 💧 Boolean state configuration | Cluster added on leak, freeze, rain, and contact sensors |
+| 🌍 Spanish translation | New `es` locale ([#314](https://github.com/RiDDiX/home-assistant-matter-hub/pull/314), thanks [@Yllelder](https://github.com/Yllelder)) |
+| 🧵 Matter.js 0.16.11 (pinned) | Kept pinned, local NOC serial patch applied |
+| ⬆️ Dep bumps | Vite 8, jsdom 29, MUI x-tree-view 9, i18next 26, react-i18next 17, TypeScript 6.0.3, biome pinned 2.4.3, pnpm overrides for transitive CVEs |
+
+**Reliability & resilience:** parallel bridge stop in `stopAll`/`restartAll`, parallel HA registry fetches, serialized bridge start/stop lifecycle, serialized `updateStates` with plugin listener detach, HA reconnect retry on transient network errors, 30s timeout on `sendMessagePromise`, port-conflict reject on web-api start, graceful shutdown on `/api/backup/restart`, `AppEnvironment` disposal on SIGINT, stale optimistic state sweep, pending debouncer clear, healthcheck 401 fix under basic auth, deep-equal entity attribute comparison, overlap guard for auto-refresh, safer mireds conversion, aligned `colorMode` publishing, surfaced bridge import errors, corrected thermostat running state for unknown modes + drying, unified Node version across Dockerfiles, sourcemaps excluded from npm tarball, unused deps dropped (rxjs, strip-color, lodash), unused `config-validator` utility removed.
+
+**Previously in v2.0.39 & v2.0.40 (hotfix releases):**
 - Fixed crash loop on startup caused by Node 22 native WebSocket dropping connections ([#297](https://github.com/RiDDiX/home-assistant-matter-hub/issues/297), [#299](https://github.com/RiDDiX/home-assistant-matter-hub/issues/299)) — affects both aarch64 (RPi) and amd64
 - Fixed service initialization errors being silently swallowed, causing the process to hang instead of exiting
 - Registry fetch now waits for WebSocket reconnect between retries and has increased retry tolerance
 - Fixed `select`, `input_select`, `siren` domains showing as unsupported in filter preview ([#298](https://github.com/RiDDiX/home-assistant-matter-hub/issues/298))
 
-**New in v2.0.38:**
+**Previously in v2.0.38:**
 
 | Feature | Description |
 |---------|-------------|
@@ -102,7 +127,7 @@ of port forwarding etc.
 <details>
 <summary><strong>🧪 Alpha Features (v2.1.0-alpha.x)</strong> - Click to expand</summary>
 
-**Alpha is currently level with Stable (v2.0.38).** All alpha features from the v2.1.0-alpha.600 line have been promoted into v2.0.38. New alpha work continues from `v2.1.0-alpha.601` onward and will appear here as development progresses.
+**Alpha is currently level with Stable (v2.0.41).** All alpha work from the v2.1.0-alpha.601 line through v2.1.0-alpha.626 has been promoted into v2.0.41. New alpha work continues from `v2.1.0-alpha.627` onward and will appear here as development progresses.
 
 </details>
 
@@ -128,6 +153,12 @@ of port forwarding etc.
 <details>
 <summary><strong>📜 Previous Stable Versions</strong> - Click to expand</summary>
 
+### v2.0.40
+Filter preview domain fix — `select`, `input_select`, `siren` now show as supported ([#298](https://github.com/RiDDiX/home-assistant-matter-hub/issues/298))
+
+### v2.0.39
+Node 22 WebSocket crash loop fix ([#297](https://github.com/RiDDiX/home-assistant-matter-hub/issues/297), [#299](https://github.com/RiDDiX/home-assistant-matter-hub/issues/299)), service init error surfacing, registry retry hardening, support link added
+
 ### v2.0.37
 Aqara productNameFromNodeLabel flag, Matter.js 0.16.11, Swedish locale update
 

package/dist/backend/cli.js

@@ -147874,6 +147874,7 @@ WARNING: ${includeIdentity ? "This backup contains sensitive Matter identity dat
                     valetudoIdentifier: config10.valetudoIdentifier,
                     coverSwapOpenClose: config10.coverSwapOpenClose,
                     disableClimateOnOff: config10.disableClimateOnOff,
+                    disableClimateFanControl: config10.disableClimateFanControl,
                     customServiceAreas: config10.customServiceAreas,
                     customFanSpeedTags: config10.customFanSpeedTags,
                     composedEntities: config10.composedEntities
@@ -148020,6 +148021,7 @@ WARNING: ${includeIdentity ? "This backup contains sensitive Matter identity dat
                   valetudoIdentifier: config10.valetudoIdentifier,
                   coverSwapOpenClose: config10.coverSwapOpenClose,
                   disableClimateOnOff: config10.disableClimateOnOff,
+                  disableClimateFanControl: config10.disableClimateFanControl,
                   customServiceAreas: config10.customServiceAreas,
                   customFanSpeedTags: config10.customFanSpeedTags,
                   composedEntities: config10.composedEntities
@@ -148840,6 +148842,7 @@ function entityMappingApi(mappingStorage) {
       valetudoIdentifier: body.valetudoIdentifier,
       coverSwapOpenClose: body.coverSwapOpenClose,
       disableClimateOnOff: body.disableClimateOnOff,
+      disableClimateFanControl: body.disableClimateFanControl,
       composedEntities: body.composedEntities
     };
     const config10 = await mappingStorage.setMapping(request);
@@ -149303,7 +149306,8 @@ function configToProfileEntry(config10) {
     customFanSpeedTags: config10.customFanSpeedTags,
     valetudoIdentifier: config10.valetudoIdentifier,
     coverSwapOpenClose: config10.coverSwapOpenClose,
-    disableClimateOnOff: config10.disableClimateOnOff
+    disableClimateOnOff: config10.disableClimateOnOff,
+    disableClimateFanControl: config10.disableClimateFanControl
   };
 }
 function mappingProfileApi(mappingStorage) {
@@ -149425,7 +149429,8 @@ function mappingProfileApi(mappingStorage) {
           customFanSpeedTags: entry.customFanSpeedTags,
           valetudoIdentifier: entry.valetudoIdentifier,
           coverSwapOpenClose: entry.coverSwapOpenClose,
-          disableClimateOnOff: entry.disableClimateOnOff
+          disableClimateOnOff: entry.disableClimateOnOff,
+          disableClimateFanControl: entry.disableClimateFanControl
         });
         applied++;
       } catch (e) {
@@ -153295,9 +153300,10 @@ var EntityMappingStorage = class extends Service {
       valetudoIdentifier: request.valetudoIdentifier?.trim() || void 0,
       coverSwapOpenClose: request.coverSwapOpenClose || void 0,
       disableClimateOnOff: request.disableClimateOnOff || void 0,
+      disableClimateFanControl: request.disableClimateFanControl || void 0,
       composedEntities: request.composedEntities?.filter((e) => e.entityId?.trim()) ?? void 0
     };
-    if (!config10.matterDeviceType && !config10.customName && !config10.customProductName && !config10.customVendorName && !config10.customSerialNumber && config10.disabled !== true && !config10.filterLifeEntity && !config10.cleaningModeEntity && !config10.temperatureEntity && !config10.humidityEntity && !config10.batteryEntity && !config10.roomEntities && !config10.disableLockPin && !config10.powerEntity && !config10.energyEntity && !config10.pressureEntity && !config10.suctionLevelEntity && !config10.mopIntensityEntity && (!config10.customServiceAreas || config10.customServiceAreas.length === 0) && (!config10.customFanSpeedTags || Object.keys(config10.customFanSpeedTags).length === 0) && !config10.currentRoomEntity && !config10.valetudoIdentifier && !config10.coverSwapOpenClose && !config10.disableClimateOnOff && (!config10.composedEntities || config10.composedEntities.length === 0)) {
+    if (!config10.matterDeviceType && !config10.customName && !config10.customProductName && !config10.customVendorName && !config10.customSerialNumber && config10.disabled !== true && !config10.filterLifeEntity && !config10.cleaningModeEntity && !config10.temperatureEntity && !config10.humidityEntity && !config10.batteryEntity && !config10.roomEntities && !config10.disableLockPin && !config10.powerEntity && !config10.energyEntity && !config10.pressureEntity && !config10.suctionLevelEntity && !config10.mopIntensityEntity && (!config10.customServiceAreas || config10.customServiceAreas.length === 0) && (!config10.customFanSpeedTags || Object.keys(config10.customFanSpeedTags).length === 0) && !config10.currentRoomEntity && !config10.valetudoIdentifier && !config10.coverSwapOpenClose && !config10.disableClimateOnOff && !config10.disableClimateFanControl && (!config10.composedEntities || config10.composedEntities.length === 0)) {
       bridgeMap.delete(request.entityId);
     } else {
       bridgeMap.set(request.entityId, config10);
@@ -171917,10 +171923,7 @@ function ClimateDevice(homeAssistantEntity) {
   }
   const supportsHumidity = attributes7.current_humidity != null || testBit(supportedFeatures, ClimateDeviceFeature.TARGET_HUMIDITY);
   const supportsOnOff = testBit(supportedFeatures, ClimateDeviceFeature.TURN_ON) && testBit(supportedFeatures, ClimateDeviceFeature.TURN_OFF) && homeAssistantEntity.mapping?.disableClimateOnOff !== true;
-  const supportsFanMode = testBit(
-    supportedFeatures,
-    ClimateDeviceFeature.FAN_MODE
-  );
+  const supportsFanMode = testBit(supportedFeatures, ClimateDeviceFeature.FAN_MODE) && homeAssistantEntity.mapping?.disableClimateFanControl !== true;
   const initialState = {
     // Pass actual current_temperature for initial state.
     // If unavailable (null/undefined), update() will fall back to the
@@ -177608,9 +177611,8 @@ function buildSupportedModes2(attributes7, includeUnnamedRooms = false, customAr
   }
   return modes;
 }
-function handleCustomServiceAreas(selectedAreas, customAreas, homeAssistant, serviceArea) {
+function handleCustomServiceAreas(selectedAreas, customAreas, homeAssistant) {
   const matched = selectedAreas.map((areaId) => customAreas[areaId - 1]).filter(Boolean);
-  serviceArea.state.selectedAreas = [];
   if (matched.length === 0) {
     logger194.warn(
       `Custom service areas: no match for selected IDs ${selectedAreas.join(", ")}`
@@ -177680,14 +177682,12 @@ var vacuumRvcRunModeConfig = {
           return handleCustomServiceAreas(
             selectedAreas,
             customAreas,
-            homeAssistant,
-            serviceArea
+            homeAssistant
           );
         }
         const cleanAreaRooms = homeAssistant.state.mapping?.cleanAreaRooms;
         if (cleanAreaRooms && cleanAreaRooms.length > 0) {
           const haAreaIds = resolveCleanAreaIds(selectedAreas, cleanAreaRooms);
-          serviceArea.state.selectedAreas = [];
           if (haAreaIds.length > 0) {
             logger194.info(
               `CLEAN_AREA: cleaning HA areas: ${haAreaIds.join(", ")}`
@@ -177713,7 +177713,6 @@ var vacuumRvcRunModeConfig = {
             logger194.info(
               `Roborock: Pressing button entities for selected rooms: ${buttonEntityIds.join(", ")}`
             );
-            serviceArea.state.selectedAreas = [];
             for (let i = 1; i < buttonEntityIds.length; i++) {
               homeAssistant.callAction({
                 action: "button.press",
@@ -177728,7 +177727,6 @@ var vacuumRvcRunModeConfig = {
         }
         const vacuumEntityId = homeAssistant.entityId;
         if (vacuumEntityId.startsWith("vacuum.valetudo_")) {
-          serviceArea.state.selectedAreas = [];
           return buildValetudoSegmentAction(
             vacuumEntityId,
             selectedAreas,
@@ -177751,7 +177749,6 @@ var vacuumRvcRunModeConfig = {
           logger194.info(
             `Starting cleaning with selected areas: ${roomIds.join(", ")}`
           );
-          serviceArea.state.selectedAreas = [];
           if (isDreameVacuum(attributes7)) {
             if (targetMapName) {
               const vacName = vacuumEntityId.replace("vacuum.", "");