@riddix/hamh 2.0.30 → 2.0.31

package/README.md

@@ -37,7 +37,7 @@ of port forwarding etc.
 
 | Channel | Branch | Current Version | Description |
 |---------|--------|-----------------|-------------|
-| **Stable** | `main` | v2.0.30 | Production-ready, recommended for most users |
+| **Stable** | `main` | v2.0.31 | 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,30 +52,31 @@ of port forwarding etc.
 ## 🎉 What's New
 
 <details>
-<summary><strong>📦 Stable Features (v2.0.30)</strong> - Click to expand</summary>
+<summary><strong>📦 Stable Features (v2.0.31)</strong> - Click to expand</summary>
 
-**New in v2.0.30:**
+**New in v2.0.31:**
 
 | Feature | Description |
 |---------|-------------|
-| **� 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)) |
+| **🎮 Controller Profiles & Area Setup** | New bridge wizard with controller-specific profiles (Apple Home, Google Home, Alexa) and area-based bridge setup |
+| **🌀 Fan Speed/Preset Fix** | Fix fan speed and preset control not working from Matter controllers ([#233](https://github.com/RiDDiX/home-assistant-matter-hub/issues/233)) |
+| **💡 Optimistic State Fix** | Prevent stale HA state from reverting optimistic brightness/color updates ([#230](https://github.com/RiDDiX/home-assistant-matter-hub/issues/230)) |
+| **🪟 Cover Target Fix** | Route boundary cover targets to open/close regardless of direction ([#240](https://github.com/RiDDiX/home-assistant-matter-hub/issues/240)) |
+| **�️ Humidity Auto-Mapping Default** | Make autoHumidityMapping default-enabled like autoPressureMapping |
 
-**Previously in v2.0.29:**
+**Previously in v2.0.30:**
 
 | Feature | Description |
 |---------|-------------|
-| **� 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 |
+| **🔗 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)) |
 
 </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.30).** 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.31).** All alpha features have been promoted to stable. New alpha features will appear here as development continues.
 
 </details>
 
@@ -101,6 +102,9 @@ of port forwarding etc.
 <details>
 <summary><strong>📜 Previous Stable Versions</strong> - Click to expand</summary>
 
+### v2.0.30
+Mapped Entity Propagation Fix, API Error Surfacing
+
 ### v2.0.29
 Light currentLevel Fix, Bridge Config Save Fix, Fan Device Feature Fix, Humidity Auto-Mapping Fix
 

package/dist/backend/cli.js

@@ -146085,6 +146085,13 @@ var init_clusters2 = __esm({
   }
 });
 
+// ../common/dist/controller-profiles.js
+var init_controller_profiles = __esm({
+  "../common/dist/controller-profiles.js"() {
+    "use strict";
+  }
+});
+
 // ../common/dist/diagnostic-event.js
 var init_diagnostic_event = __esm({
   "../common/dist/diagnostic-event.js"() {
@@ -146694,7 +146701,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: false
+          default: true
         },
         autoPressureMapping: {
           title: "Auto Pressure Mapping",
@@ -146999,6 +147006,7 @@ var init_dist = __esm({
     init_bridge_export();
     init_bridge_templates();
     init_clusters2();
+    init_controller_profiles();
     init_diagnostic_event();
     init_domains();
     init_endpoint_data();
@@ -149304,6 +149312,73 @@ function matterApi(bridgeService, haRegistry) {
     areas.sort((a, b) => a.name.localeCompare(b.name));
     res.status(200).json(areas);
   });
+  router.get("/areas/summary", async (_, res) => {
+    if (!haRegistry) {
+      res.status(503).json({ error: "Home Assistant registry not available" });
+      return;
+    }
+    const supportedDomains = /* @__PURE__ */ new Set([
+      "light",
+      "switch",
+      "sensor",
+      "binary_sensor",
+      "climate",
+      "cover",
+      "fan",
+      "lock",
+      "media_player",
+      "vacuum",
+      "valve",
+      "humidifier",
+      "water_heater",
+      "select",
+      "input_select",
+      "input_boolean",
+      "alarm_control_panel",
+      "event",
+      "automation",
+      "script",
+      "scene"
+    ]);
+    const entities = Object.values(haRegistry.entities);
+    const devices = haRegistry.devices;
+    const states = haRegistry.states;
+    const areaSummary = /* @__PURE__ */ new Map();
+    for (const [areaId, areaName] of haRegistry.areas) {
+      areaSummary.set(areaId, { name: areaName, entityCount: 0, domains: {} });
+    }
+    for (const entity of entities) {
+      if (entity.disabled_by != null) continue;
+      const domain = entity.entity_id.split(".")[0];
+      if (!supportedDomains.has(domain)) continue;
+      const state = states[entity.entity_id];
+      if (!state || state.state === "unavailable") continue;
+      let areaId;
+      const entityAreaId = entity.area_id;
+      if (entityAreaId && haRegistry.areas.has(entityAreaId)) {
+        areaId = entityAreaId;
+      } else {
+        const device = entity.device_id ? devices[entity.device_id] : void 0;
+        const deviceAreaId = device?.area_id;
+        if (deviceAreaId && haRegistry.areas.has(deviceAreaId)) {
+          areaId = deviceAreaId;
+        }
+      }
+      if (!areaId) continue;
+      const summary = areaSummary.get(areaId);
+      if (summary) {
+        summary.entityCount++;
+        summary.domains[domain] = (summary.domains[domain] || 0) + 1;
+      }
+    }
+    const result = [...areaSummary.entries()].map(([area_id, data]) => ({
+      area_id,
+      name: data.name,
+      entityCount: data.entityCount,
+      domains: data.domains
+    })).sort((a, b) => a.name.localeCompare(b.name));
+    res.status(200).json(result);
+  });
   router.get("/filter-values", async (_, res) => {
     if (!haRegistry) {
       res.status(503).json({ error: "Home Assistant registry not available" });
@@ -165933,12 +166008,8 @@ var FanControlServerBase = class extends FeaturedBase3 {
       return;
     }
     this.agent.asLocalActor(() => {
-      const percentSetting = Math.floor(speed / this.state.speedMax * 100);
-      this.targetPercentSettingChanged(
-        percentSetting,
-        this.state.percentSetting,
-        context
-      );
+      const percentage = Math.floor(speed / this.state.speedMax * 100);
+      this.applyPercentageAction(percentage);
     });
   }
   targetFanModeChanged(fanMode, _oldValue, context) {
@@ -165951,16 +166022,12 @@ var FanControlServerBase = class extends FeaturedBase3 {
         return;
       }
       const targetFanMode = FanMode.create(fanMode, this.state.fanModeSequence);
-      const config10 = this.state.config;
       if (targetFanMode.mode === FanControl3.FanMode.Auto) {
-        homeAssistant.callAction(config10.setAutoMode(void 0, this.agent));
-      } else {
-        const percentage = targetFanMode.speedPercent();
-        this.targetPercentSettingChanged(
-          percentage,
-          this.state.percentSetting,
-          context
+        homeAssistant.callAction(
+          this.state.config.setAutoMode(void 0, this.agent)
         );
+      } else {
+        this.applyPercentageAction(targetFanMode.speedPercent());
       }
     });
   }
@@ -165972,45 +166039,48 @@ var FanControlServerBase = class extends FeaturedBase3 {
       return;
     }
     this.agent.asLocalActor(() => {
-      const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
-      if (!homeAssistant.isAvailable) {
-        return;
-      }
-      const config10 = this.state.config;
-      const supportsPercentage = config10.supportsPercentage(
+      this.applyPercentageAction(percentage);
+    });
+  }
+  applyPercentageAction(percentage) {
+    const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
+    if (!homeAssistant.isAvailable) {
+      return;
+    }
+    const config10 = this.state.config;
+    const supportsPercentage = config10.supportsPercentage(
+      homeAssistant.entity.state,
+      this.agent
+    );
+    if (percentage === 0) {
+      homeAssistant.callAction(config10.turnOff(void 0, this.agent));
+    } else if (supportsPercentage) {
+      const stepSize = config10.getStepSize(
         homeAssistant.entity.state,
         this.agent
       );
-      if (percentage === 0) {
-        homeAssistant.callAction(config10.turnOff(void 0, this.agent));
-      } else if (supportsPercentage) {
-        const stepSize = config10.getStepSize(
-          homeAssistant.entity.state,
-          this.agent
-        );
-        const roundedPercentage = stepSize && stepSize > 0 ? Math.round(percentage / stepSize) * stepSize : percentage;
-        const clampedPercentage = Math.max(
-          stepSize ?? 1,
-          Math.min(100, roundedPercentage)
+      const roundedPercentage = stepSize && stepSize > 0 ? Math.round(percentage / stepSize) * stepSize : percentage;
+      const clampedPercentage = Math.max(
+        stepSize ?? 1,
+        Math.min(100, roundedPercentage)
+      );
+      homeAssistant.callAction(config10.turnOn(clampedPercentage, this.agent));
+    } else {
+      const presetModes = config10.getPresetModes(homeAssistant.entity.state, this.agent) ?? [];
+      const speedPresets = presetModes.filter(
+        (m) => m.toLowerCase() !== "auto"
+      );
+      if (speedPresets.length > 0) {
+        const presetIndex = Math.min(
+          Math.floor(percentage / 100 * speedPresets.length),
+          speedPresets.length - 1
         );
-        homeAssistant.callAction(config10.turnOn(clampedPercentage, this.agent));
-      } else {
-        const presetModes = config10.getPresetModes(homeAssistant.entity.state, this.agent) ?? [];
-        const speedPresets = presetModes.filter(
-          (m) => m.toLowerCase() !== "auto"
+        const targetPreset = speedPresets[presetIndex];
+        homeAssistant.callAction(
+          config10.setPresetMode(targetPreset, this.agent)
         );
-        if (speedPresets.length > 0) {
-          const presetIndex = Math.min(
-            Math.floor(percentage / 100 * speedPresets.length),
-            speedPresets.length - 1
-          );
-          const targetPreset = speedPresets[presetIndex];
-          homeAssistant.callAction(
-            config10.setPresetMode(targetPreset, this.agent)
-          );
-        }
       }
-    });
+    }
   }
   targetAirflowDirectionChanged(airflowDirection, _oldValue, context) {
     if (transactionIsOffline(context)) {
@@ -166150,6 +166220,8 @@ init_home_assistant_entity_behavior();
 init_esm();
 init_home_assistant_entity_behavior();
 var lastTurnOnTimestamps = /* @__PURE__ */ new Map();
+var optimisticLevelTimestamps = /* @__PURE__ */ new Map();
+var OPTIMISTIC_LEVEL_COOLDOWN_MS = 2e3;
 function notifyLightTurnedOn(entityId) {
   lastTurnOnTimestamps.set(entityId, Date.now());
 }
@@ -166194,6 +166266,11 @@ var LevelControlServerBase = class extends FeaturedBase4 {
     if (currentLevel != null) {
       currentLevel = Math.min(Math.max(minLevel, currentLevel), maxLevel);
     }
+    const lastOptimistic = optimisticLevelTimestamps.get(entity.entity_id);
+    const inCooldown = lastOptimistic != null && Date.now() - lastOptimistic < OPTIMISTIC_LEVEL_COOLDOWN_MS;
+    if (inCooldown && currentLevel != null) {
+      currentLevel = null;
+    }
     applyPatchState(this.state, {
       minLevel,
       maxLevel,
@@ -166261,6 +166338,7 @@ var LevelControlServerBase = class extends FeaturedBase4 {
       };
     }
     this.state.currentLevel = level;
+    optimisticLevelTimestamps.set(entityId, Date.now());
     homeAssistant.callAction(action);
   }
 };
@@ -168638,9 +168716,9 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
       `handleMovement: type=${MovementType[type]}, direction=${MovementDirection[direction]}, target=${targetPercent100ths}, currentLift=${currentLift}, currentTilt=${currentTilt}, absolutePosition=${this.features.absolutePosition}`
     );
     if (type === MovementType.Lift) {
-      if (direction === MovementDirection.Open && (targetPercent100ths == null || targetPercent100ths === 0)) {
+      if (targetPercent100ths === 0) {
         this.handleLiftOpen();
-      } else if (direction === MovementDirection.Close && (targetPercent100ths == null || targetPercent100ths === 1e4)) {
+      } else if (targetPercent100ths === 1e4) {
         this.handleLiftClose();
       } else if (targetPercent100ths != null && this.features.absolutePosition) {
         this.handleGoToLiftPosition(targetPercent100ths);
@@ -168650,9 +168728,9 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
         this.handleLiftClose();
       }
     } else if (type === MovementType.Tilt) {
-      if (direction === MovementDirection.Open && (targetPercent100ths == null || targetPercent100ths === 0)) {
+      if (targetPercent100ths === 0) {
         this.handleTiltOpen();
-      } else if (direction === MovementDirection.Close && (targetPercent100ths == null || targetPercent100ths === 1e4)) {
+      } else if (targetPercent100ths === 1e4) {
         this.handleTiltClose();
       } else if (targetPercent100ths != null && this.features.absolutePosition) {
         this.handleGoToTiltPosition(targetPercent100ths);
@@ -169349,6 +169427,8 @@ init_nodejs();
 // src/matter/behaviors/color-control-server.ts
 init_home_assistant_entity_behavior();
 var logger170 = Logger.get("ColorControlServer");
+var optimisticColorTimestamps = /* @__PURE__ */ new Map();
+var OPTIMISTIC_COLOR_COOLDOWN_MS = 2e3;
 var FeaturedBase7 = ColorControlServer.with("ColorTemperature", "HueSaturation");
 var ColorControlServerBase = class extends FeaturedBase7 {
   pendingTransitionTime;
@@ -169427,6 +169507,8 @@ var ColorControlServerBase = class extends FeaturedBase7 {
     const newColorMode = this.getColorModeFromFeatures(
       config10.getCurrentMode(entity.state, this.agent)
     );
+    const lastOptimistic = optimisticColorTimestamps.get(entity.entity_id);
+    const inCooldown = lastOptimistic != null && Date.now() - lastOptimistic < OPTIMISTIC_COLOR_COOLDOWN_MS;
     if (this.features.colorTemperature) {
       const existingMireds = this.state.colorTemperatureMireds;
       if (existingMireds != null) {
@@ -169451,12 +169533,12 @@ var ColorControlServerBase = class extends FeaturedBase7 {
       applyPatchState(this.state, {
         coupleColorTempToLevelMinMireds: minMireds,
         startUpColorTemperatureMireds: startUpMireds,
-        colorTemperatureMireds: effectiveMireds
+        ...inCooldown ? {} : { colorTemperatureMireds: effectiveMireds }
       });
     }
     applyPatchState(this.state, {
-      colorMode: newColorMode,
-      ...this.features.hueSaturation ? {
+      ...inCooldown ? {} : { colorMode: newColorMode },
+      ...this.features.hueSaturation && !inCooldown ? {
         currentHue: hue,
         currentSaturation: saturation
       } : {}
@@ -169483,6 +169565,7 @@ var ColorControlServerBase = class extends FeaturedBase7 {
       colorTemperatureMireds: targetMireds,
       colorMode: ColorControl3.ColorMode.ColorTemperatureMireds
     });
+    optimisticColorTimestamps.set(homeAssistant.entityId, Date.now());
     homeAssistant.callAction(action);
   }
   moveToHueLogic(targetHue) {
@@ -169513,6 +169596,7 @@ var ColorControlServerBase = class extends FeaturedBase7 {
       currentSaturation: targetSaturation,
       colorMode: ColorControl3.ColorMode.CurrentHueAndCurrentSaturation
     });
+    optimisticColorTimestamps.set(homeAssistant.entityId, Date.now());
     homeAssistant.callAction(action);
   }
   applyTransition(action) {
@@ -170816,6 +170900,8 @@ init_home_assistant_entity_behavior();
 init_esm();
 init_home_assistant_entity_behavior();
 var logger175 = Logger.get("SpeakerLevelControlServer");
+var optimisticLevelTimestamps2 = /* @__PURE__ */ new Map();
+var OPTIMISTIC_LEVEL_COOLDOWN_MS2 = 2e3;
 var FeaturedBase9 = LevelControlServer.with("OnOff");
 var SpeakerLevelControlServerBase = class extends FeaturedBase9 {
   async initialize() {
@@ -170851,10 +170937,15 @@ var SpeakerLevelControlServerBase = class extends FeaturedBase9 {
     logger175.debug(
       `[${entityId}] Volume update: HA=${currentLevelPercent != null ? Math.round(currentLevelPercent * 100) : "null"}% -> currentLevel=${currentLevel}`
     );
+    const lastOptimistic = optimisticLevelTimestamps2.get(entity.entity_id);
+    const inCooldown = lastOptimistic != null && Date.now() - lastOptimistic < OPTIMISTIC_LEVEL_COOLDOWN_MS2;
+    if (inCooldown && currentLevel != null) {
+      currentLevel = null;
+    }
     applyPatchState(this.state, {
       minLevel,
       maxLevel,
-      currentLevel
+      ...currentLevel != null ? { currentLevel } : {}
     });
   }
   async moveToLevel(request) {
@@ -170897,6 +170988,7 @@ var SpeakerLevelControlServerBase = class extends FeaturedBase9 {
       return;
     }
     this.state.currentLevel = level;
+    optimisticLevelTimestamps2.set(entityId, Date.now());
     homeAssistant.callAction(
       config10.moveToLevelPercent(levelPercent, this.agent)
     );
@@ -175445,15 +175537,15 @@ var BridgeRegistry = class _BridgeRegistry {
   }
   /**
    * Check if auto humidity mapping is enabled for this bridge.
-   * Default: false (disabled by default, user must explicitly enable).
+   * Default: true (enabled by default).
    * When enabled, humidity sensors on the same device as a temperature sensor
    * are combined into a single TemperatureHumiditySensor endpoint.
    * Note: Apple Home does not display humidity on TemperatureSensorDevice
-   * endpoints, so users on Apple Home should keep this disabled.
+   * endpoints, so users on Apple Home should explicitly disable this.
    * See: https://github.com/RiDDiX/home-assistant-matter-hub/issues/133
    */
   isAutoHumidityMappingEnabled() {
-    return this.dataProvider.featureFlags?.autoHumidityMapping === true || this.dataProvider.featureFlags?.autoComposedDevices === true;
+    return this.dataProvider.featureFlags?.autoHumidityMapping !== false || this.dataProvider.featureFlags?.autoComposedDevices === true;
   }
   /**
    * Find a humidity sensor entity that belongs to the same HA device.