@riddix/hamh 2.1.0-alpha.842 → 2.1.0-alpha.844

package/README.md

@@ -37,7 +37,7 @@ of port forwarding etc.
 
 | Channel | Branch | Current Version | Description |
 |---------|--------|-----------------|-------------|
-| **Stable** | `main` | v2.0.50 | Production-ready, recommended for most users |
+| **Stable** | `main` | v2.0.52 | Production-ready, recommended for most users |
 | **Alpha** | `alpha` | v2.1.0-alpha.x (next) | Currently level with Stable; next pre-release lands here first |
 | **Testing** | `testing` | v4.1.0-testing.x | ⚠️ **Highly unstable!** Experimental features, may break |
 
@@ -61,9 +61,24 @@ Re-assign the affected devices to their rooms after they reconnect. See the [doc
 ## 🎉 What's New
 
 <details>
-<summary><strong>📦 Stable Features (v2.0.50)</strong> - Click to expand</summary>
+<summary><strong>📦 Stable Features (v2.0.52)</strong> - Click to expand</summary>
 
-**New in v2.0.50:**
+**New in v2.0.52 (hotfix release):**
+
+- 🔌 The plugins page no longer fails with a 500 when a server mode bridge exists ([#430](https://github.com/RiDDiX/home-assistant-matter-hub/issues/430))
+
+**Previously in v2.0.51:**
+
+- 🐕 **Opt-in wedge watchdog**: rotates a controller session that keeps acking but stops talking at the interaction layer, the automated "Play Sound" fix for stuck Apple devices ([#287](https://github.com/RiDDiX/home-assistant-matter-hub/issues/287), [#428](https://github.com/RiDDiX/home-assistant-matter-hub/issues/428))
+- 🧹 **Clean up orphaned records**: bridge menu action with a dry-run preview that removes identity and mapping leftovers of entities deleted from HA (7 day tombstone guards against false positives)
+- 🚗 **EV charger support**: new EVSE device-type override with charging switch and current limit mapping, EnableCharging/Disable from the controller; Aqara and Home Assistant render it, keep it off Alexa bridges
+- 🩺 **Subscription scope on the health card**: see whether each controller holds a whole-node wildcard or watches specific endpoints
+- 📷 **Camera live view signaling completed**: the WebRTC answer now reaches the controller over the requestor cluster, plus full media path logging, HA signaling timeouts, trickle ICE and ICE server support (still experimental until verified on real hardware)
+- 🪟 **Cover stop detection in every position space**: the v2.0.50 cover fix now also works with the Alexa percentage flag and the per-cover swap toggle, and swapped covers report the right direction ([#429](https://github.com/RiDDiX/home-assistant-matter-hub/issues/429))
+- 🤖 **Vacuum on/off crash fixed**: state updates no longer throw on vacuums with the on/off toggle ([#428](https://github.com/RiDDiX/home-assistant-matter-hub/issues/428))
+- 🌍 **Brazilian Portuguese completed**: 602 of 615 strings ([#420](https://github.com/RiDDiX/home-assistant-matter-hub/issues/420))
+
+**Previously in v2.0.50:**
 
 - 🆔 **Stable device identity (opt-in)**: endpoints keep their identity when an entity is renamed or re-registered, keyed on the HA registry unique id; enable the `stableIdentity` feature flag per bridge ([#404](https://github.com/RiDDiX/home-assistant-matter-hub/issues/404), [#407](https://github.com/RiDDiX/home-assistant-matter-hub/issues/407))
 - ⚡ **Energy suite stage 1**: consumption sensors expose an **Electrical Meter** that Google Home and SmartThings render, home batteries become a **Battery Storage** device with signed charge/discharge power and lifetime energy, and voltage/current/energy sensors group onto one endpoint via new mapping fields
@@ -255,7 +270,7 @@ Re-assign the affected devices to their rooms after they reconnect. See the [doc
 <details>
 <summary><strong>🧪 Alpha Features (v2.1.0-alpha.x)</strong> - Click to expand</summary>
 
-**Alpha is currently level with Stable (v2.0.50).** All alpha work up to the latest pre-release has been promoted into v2.0.50. New alpha work continues from the next pre-release tag onward and will appear here as development progresses.
+**Alpha is currently level with Stable (v2.0.52).** All alpha work up to the latest pre-release has been promoted into v2.0.52. New alpha work continues from the next pre-release tag onward and will appear here as development progresses.
 
 </details>
 

package/dist/backend/cli.js

@@ -133183,7 +133183,8 @@ WARNING: ${includeIdentity ? "This backup contains sensitive Matter identity dat
                     fanWindPresets: config11.fanWindPresets,
                     fanRestoreSpeedOnPowerOn: config11.fanRestoreSpeedOnPowerOn,
                     composedEntities: config11.composedEntities,
-                    disableMomentaryFlip: config11.disableMomentaryFlip
+                    disableMomentaryFlip: config11.disableMomentaryFlip,
+                    vacuumAscendingRoomOrder: config11.vacuumAscendingRoomOrder
                   });
                   mappingsRestored++;
                 }
@@ -133346,7 +133347,8 @@ WARNING: ${includeIdentity ? "This backup contains sensitive Matter identity dat
                   customFanSpeedTags: config11.customFanSpeedTags,
                   fanWindPresets: config11.fanWindPresets,
                   composedEntities: config11.composedEntities,
-                  disableMomentaryFlip: config11.disableMomentaryFlip
+                  disableMomentaryFlip: config11.disableMomentaryFlip,
+                  vacuumAscendingRoomOrder: config11.vacuumAscendingRoomOrder
                 });
                 mappingsRestored++;
               }
@@ -134195,6 +134197,7 @@ function entityMappingApi(mappingStorage, identityStorage) {
       fanRestoreSpeedOnPowerOn: body.fanRestoreSpeedOnPowerOn,
       currentRoomEntity: body.currentRoomEntity,
       cleanedAreaEntity: body.cleanedAreaEntity,
+      vacuumAscendingRoomOrder: body.vacuumAscendingRoomOrder,
       disableCustomAreaRoomModes: body.disableCustomAreaRoomModes,
       valetudoIdentifier: body.valetudoIdentifier,
       coverSwapOpenClose: body.coverSwapOpenClose,
@@ -134704,7 +134707,8 @@ function configToProfileEntry(config11) {
     climateKeepModeOnIdle: config11.climateKeepModeOnIdle,
     climateExposeFan: config11.climateExposeFan,
     climateAutoMode: config11.climateAutoMode,
-    disableMomentaryFlip: config11.disableMomentaryFlip
+    disableMomentaryFlip: config11.disableMomentaryFlip,
+    vacuumAscendingRoomOrder: config11.vacuumAscendingRoomOrder
   };
 }
 function mappingProfileApi(mappingStorage) {
@@ -134845,7 +134849,8 @@ function mappingProfileApi(mappingStorage) {
           climateKeepModeOnIdle: entry.climateKeepModeOnIdle,
           climateExposeFan: entry.climateExposeFan,
           climateAutoMode: entry.climateAutoMode,
-          disableMomentaryFlip: entry.disableMomentaryFlip
+          disableMomentaryFlip: entry.disableMomentaryFlip,
+          vacuumAscendingRoomOrder: entry.vacuumAscendingRoomOrder
         });
         applied++;
       } catch (e) {
@@ -136622,6 +136627,7 @@ function pluginApi(bridgeService, storageLocation) {
     const result = [];
     for (const bridge of bridgeService.bridges) {
       const info = bridge.pluginInfo;
+      if (!info) continue;
       const plugins = info.metadata.map((meta) => ({
         name: meta.name,
         version: meta.version,
@@ -136644,41 +136650,41 @@ function pluginApi(bridgeService, storageLocation) {
     }
     res.json(result);
   });
-  router.post("/:bridgeId/:pluginName/enable", (req, res) => {
-    const bridge = bridgeService.get(req.params.bridgeId);
+  function pluginBridge(bridgeId, res) {
+    const bridge = bridgeService.get(bridgeId);
     if (!bridge) {
       res.status(404).json({ error: "Bridge not found" });
-      return;
+      return void 0;
+    }
+    if (typeof bridge.enablePlugin !== "function") {
+      res.status(400).json({ error: "Bridge does not support plugins" });
+      return void 0;
     }
+    return bridge;
+  }
+  router.post("/:bridgeId/:pluginName/enable", (req, res) => {
+    const bridge = pluginBridge(req.params.bridgeId, res);
+    if (!bridge) return;
     const { pluginName } = req.params;
     bridge.enablePlugin(pluginName);
     res.json({ success: true, pluginName, enabled: true });
   });
   router.post("/:bridgeId/:pluginName/disable", (req, res) => {
-    const bridge = bridgeService.get(req.params.bridgeId);
-    if (!bridge) {
-      res.status(404).json({ error: "Bridge not found" });
-      return;
-    }
+    const bridge = pluginBridge(req.params.bridgeId, res);
+    if (!bridge) return;
     const { pluginName } = req.params;
     bridge.disablePlugin(pluginName);
     res.json({ success: true, pluginName, enabled: false });
   });
   router.get("/:bridgeId/:pluginName/config-schema", (req, res) => {
-    const bridge = bridgeService.get(req.params.bridgeId);
-    if (!bridge) {
-      res.status(404).json({ error: "Bridge not found" });
-      return;
-    }
+    const bridge = pluginBridge(req.params.bridgeId, res);
+    if (!bridge) return;
     const schema6 = bridge.getPluginConfigSchema(req.params.pluginName);
     res.json({ pluginName: req.params.pluginName, schema: schema6 ?? null });
   });
   router.post("/:bridgeId/:pluginName/config", async (req, res) => {
-    const bridge = bridgeService.get(req.params.bridgeId);
-    if (!bridge) {
-      res.status(404).json({ error: "Bridge not found" });
-      return;
-    }
+    const bridge = pluginBridge(req.params.bridgeId, res);
+    if (!bridge) return;
     const { config: config11 } = req.body;
     if (!config11 || typeof config11 !== "object") {
       res.status(400).json({ error: "config object is required" });
@@ -136692,11 +136698,8 @@ function pluginApi(bridgeService, storageLocation) {
     res.json({ success: true, pluginName: req.params.pluginName });
   });
   router.post("/:bridgeId/:pluginName/reset", (req, res) => {
-    const bridge = bridgeService.get(req.params.bridgeId);
-    if (!bridge) {
-      res.status(404).json({ error: "Bridge not found" });
-      return;
-    }
+    const bridge = pluginBridge(req.params.bridgeId, res);
+    if (!bridge) return;
     const { pluginName } = req.params;
     bridge.resetPlugin(pluginName);
     res.json({ success: true, pluginName, reset: true });
@@ -139566,6 +139569,7 @@ var EntityMappingStorage = class extends Service {
       fanRestoreSpeedOnPowerOn: request.fanRestoreSpeedOnPowerOn || void 0,
       currentRoomEntity: request.currentRoomEntity?.trim() || void 0,
       cleanedAreaEntity: request.cleanedAreaEntity?.trim() || void 0,
+      vacuumAscendingRoomOrder: request.vacuumAscendingRoomOrder || void 0,
       disableCustomAreaRoomModes: request.disableCustomAreaRoomModes || void 0,
       valetudoIdentifier: request.valetudoIdentifier?.trim() || void 0,
       coverSwapOpenClose: request.coverSwapOpenClose || void 0,
@@ -139583,7 +139587,7 @@ var EntityMappingStorage = class extends Service {
       composedEntities: request.composedEntities?.filter((e) => e.entityId?.trim()) ?? void 0,
       disableMomentaryFlip: request.disableMomentaryFlip || void 0
     };
-    if (!config11.matterDeviceType && !config11.customName && !config11.customProductName && !config11.customVendorName && !config11.customSerialNumber && config11.customVendorId === void 0 && config11.disabled !== true && !config11.filterLifeEntity && !config11.cleaningModeEntity && !config11.temperatureEntity && !config11.humidityEntity && !config11.batteryEntity && !config11.disableBatteryMapping && !config11.chargingStateEntity && !config11.roomEntities && !config11.disableLockPin && !config11.lockUsercodeService && config11.lockUsercodeSlot === void 0 && config11.lockPinMinLength === void 0 && config11.lockPinMaxLength === void 0 && !config11.powerEntity && !config11.energyEntity && !config11.voltageEntity && !config11.currentEntity && !config11.batteryPowerEntity && !config11.batteryEnergyEntity && !config11.chargingSwitchEntity && !config11.currentLimitEntity && !config11.pressureEntity && !config11.suctionLevelEntity && !config11.mopIntensityEntity && (!config11.customServiceAreas || config11.customServiceAreas.length === 0) && (!config11.customFanSpeedTags || Object.keys(config11.customFanSpeedTags).length === 0) && (!config11.fanWindPresets || (config11.fanWindPresets.natural?.length ?? 0) === 0 && (config11.fanWindPresets.sleep?.length ?? 0) === 0) && !config11.fanRestoreSpeedOnPowerOn && !config11.currentRoomEntity && !config11.cleanedAreaEntity && !config11.disableCustomAreaRoomModes && !config11.valetudoIdentifier && !config11.coverSwapOpenClose && !config11.coverExposeAsDimmableLight && !config11.selectExposeAsSwitch && !config11.selectSwitchOnOption && !config11.selectSwitchOffOption && !config11.coverSliderDebounceMs && !config11.updateThrottleMs && !config11.disableClimateOnOff && !config11.disableClimateFanControl && !config11.climateKeepModeOnIdle && !config11.climateExposeFan && !config11.climateAutoMode && (!config11.composedEntities || config11.composedEntities.length === 0) && !config11.disableMomentaryFlip) {
+    if (!config11.matterDeviceType && !config11.customName && !config11.customProductName && !config11.customVendorName && !config11.customSerialNumber && config11.customVendorId === void 0 && config11.disabled !== true && !config11.filterLifeEntity && !config11.cleaningModeEntity && !config11.temperatureEntity && !config11.humidityEntity && !config11.batteryEntity && !config11.disableBatteryMapping && !config11.chargingStateEntity && !config11.roomEntities && !config11.disableLockPin && !config11.lockUsercodeService && config11.lockUsercodeSlot === void 0 && config11.lockPinMinLength === void 0 && config11.lockPinMaxLength === void 0 && !config11.powerEntity && !config11.energyEntity && !config11.voltageEntity && !config11.currentEntity && !config11.batteryPowerEntity && !config11.batteryEnergyEntity && !config11.chargingSwitchEntity && !config11.currentLimitEntity && !config11.pressureEntity && !config11.suctionLevelEntity && !config11.mopIntensityEntity && (!config11.customServiceAreas || config11.customServiceAreas.length === 0) && (!config11.customFanSpeedTags || Object.keys(config11.customFanSpeedTags).length === 0) && (!config11.fanWindPresets || (config11.fanWindPresets.natural?.length ?? 0) === 0 && (config11.fanWindPresets.sleep?.length ?? 0) === 0) && !config11.fanRestoreSpeedOnPowerOn && !config11.currentRoomEntity && !config11.cleanedAreaEntity && !config11.vacuumAscendingRoomOrder && !config11.disableCustomAreaRoomModes && !config11.valetudoIdentifier && !config11.coverSwapOpenClose && !config11.coverExposeAsDimmableLight && !config11.selectExposeAsSwitch && !config11.selectSwitchOnOption && !config11.selectSwitchOffOption && !config11.coverSliderDebounceMs && !config11.updateThrottleMs && !config11.disableClimateOnOff && !config11.disableClimateFanControl && !config11.climateKeepModeOnIdle && !config11.climateExposeFan && !config11.climateAutoMode && (!config11.composedEntities || config11.composedEntities.length === 0) && !config11.disableMomentaryFlip) {
       bridgeMap.delete(request.entityId);
     } else {
       bridgeMap.set(request.entityId, config11);
@@ -165087,6 +165091,23 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
       }
     }
   }
+  /**
+   * Snapshot the controller selection in the order the vacuum will actually
+   * clean it. Roborock-class devices clean a batch of segments in ascending
+   * id order and ignore the order they were dispatched in, so tracking has
+   * to follow that instead of the tap order (#368).
+   */
+  orderSelectedAreas(selectedAreas) {
+    const areas = [...selectedAreas];
+    try {
+      const mapping = this.agent.get(HomeAssistantEntityBehavior).state.mapping;
+      if (mapping?.vacuumAscendingRoomOrder) {
+        areas.sort((a, b) => a - b);
+      }
+    } catch {
+    }
+    return areas;
+  }
   /** Read the cumulative cleaned-area sensor (m2), or null if not configured. */
   readCleanedAreaSqm() {
     try {
@@ -165276,7 +165297,10 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
       try {
         const serviceArea = this.agent.get(ServiceAreaBehavior);
         if (serviceArea.state.selectedAreas?.length > 0) {
-          s.activeAreas = [...serviceArea.state.selectedAreas];
+          s.activeAreas = this.orderSelectedAreas(
+            serviceArea.state.selectedAreas
+          );
+          serviceArea.state.selectedAreas = [...s.activeAreas];
           s.completedAreas.clear();
           s.lastCurrentArea = null;
           s.loggedShortCircuits.clear();
@@ -165315,7 +165339,10 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
         try {
           const serviceArea = this.agent.get(ServiceAreaBehavior);
           if (serviceArea.state.selectedAreas?.length > 0) {
-            s.activeAreas = [...serviceArea.state.selectedAreas];
+            s.activeAreas = this.orderSelectedAreas(
+              serviceArea.state.selectedAreas
+            );
+            serviceArea.state.selectedAreas = [...s.activeAreas];
             s.completedAreas.clear();
             s.lastCurrentArea = null;
             s.loggedShortCircuits.clear();
@@ -169994,7 +170021,16 @@ init_esm();
 
 // src/matter/behaviors/service-area-server.ts
 init_esm();
+init_home_assistant_entity_behavior();
 var logger234 = Logger.get("ServiceAreaServer");
+function orderSelection(areas, agent) {
+  try {
+    const ascending = agent?.get(HomeAssistantEntityBehavior).state.mapping?.vacuumAscendingRoomOrder === true;
+    return ascending ? [...areas].sort((a, b) => a - b) : areas;
+  } catch {
+    return areas;
+  }
+}
 var ServiceAreaWithProgress = ServiceAreaBehavior.with(
   ServiceArea3.Feature.ProgressReporting
 );
@@ -170004,7 +170040,7 @@ var ServiceAreaServerBase = class extends ServiceAreaWithProgress {
     logger234.info(
       `ServiceArea selectAreas called with: ${JSON.stringify(newAreas)}`
     );
-    const uniqueAreas = [...new Set(newAreas)];
+    const uniqueAreas = orderSelection([...new Set(newAreas)], this.agent);
     const supportedAreaIds = this.state.supportedAreas.map((a) => a.areaId);
     const invalidAreas = uniqueAreas.filter(
       (id) => !supportedAreaIds.includes(id)
@@ -170063,7 +170099,7 @@ var ServiceAreaServerWithMapsBase = class extends ServiceAreaWithMapsAndProgress
     logger234.info(
       `ServiceArea selectAreas called with: ${JSON.stringify(newAreas)}`
     );
-    const uniqueAreas = [...new Set(newAreas)];
+    const uniqueAreas = orderSelection([...new Set(newAreas)], this.agent);
     const supportedAreaIds = this.state.supportedAreas.map((a) => a.areaId);
     const invalidAreas = uniqueAreas.filter(
       (id) => !supportedAreaIds.includes(id)