@riddix/hamh 2.1.0-alpha.574 → 2.1.0-alpha.576

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.36 | 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,39 @@ 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.36)</strong> - Click to expand</summary>
 
-**New in v2.0.30:**
+**New in v2.0.36:**
 
 | 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)) |
-
-**Previously in v2.0.29:**
+| **🏗️ User-Defined Composed Devices** | Create custom composed devices via composedEntities mapping ([#220](https://github.com/RiDDiX/home-assistant-matter-hub/issues/220)) |
+| **🔌 Plugin Domain Mappings** | Domain mapping support in plugin API with cloud-mock example |
+| **🔋 Valve & Pump Battery** | Battery support for valve and pump endpoints |
+| **🌐 German + Russian Translations** | Complete German translation and new Russian language |
+| **📡 Session Recovery** | Graceful session close, dead session cleanup, mDNS re-announcement ([#266](https://github.com/RiDDiX/home-assistant-matter-hub/issues/266)) |
+| **🔗 Quick Link to Failed Devices** | Dashboard quick link to failed devices ([#270](https://github.com/RiDDiX/home-assistant-matter-hub/issues/270)) |
+| **🌡️ Thermostat Fix** | Skip climate.turn_on when already on ([#269](https://github.com/RiDDiX/home-assistant-matter-hub/issues/269)) |
+| **🪟 Cover Fix** | Correct stale targetPosition during external movement ([#268](https://github.com/RiDDiX/home-assistant-matter-hub/issues/268)) |
+| **🌬️ Air Purifier Fix** | Sub-endpoints for composed air purifier, manual temp/humidity mapping ([#265](https://github.com/RiDDiX/home-assistant-matter-hub/issues/265)) |
+| **🔥 Cooling-Only Thermostat Fix** | Prevent HeatingOnly on cooling-only thermostat ([#264](https://github.com/RiDDiX/home-assistant-matter-hub/issues/264)) |
+| **↔️ Per-Entity Cover Swap** | Individual coverSwapOpenClose per cover ([#263](https://github.com/RiDDiX/home-assistant-matter-hub/issues/263)) |
+
+**Previously in v2.0.35:**
 
 | 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 |
+| **🏠 HA 2026.3 Clean Area Support** | Native support for the new `vacuum.clean_area` action |
+| **🤖 Valetudo Identifier Mapping** | Custom `valetudoIdentifier` for MQTT topic case mismatches |
+| **🔌 Plugin System Hardening** | Validation, API version check, tgz upload/local install |
+| **📖 Docusaurus Docs** | New documentation site with improved search and navigation |
 
 </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.36).** All alpha features have been promoted to stable. New alpha features will appear here as development continues.
 
 </details>
 
@@ -101,6 +110,24 @@ of port forwarding etc.
 <details>
 <summary><strong>📜 Previous Stable Versions</strong> - Click to expand</summary>
 
+### v2.0.35
+HA 2026.3 Clean Area Support, Valetudo Identifier Mapping, Plugin System Hardening, Registry Fingerprint Fix, Roomba Battery Fix, Contact Sensor Fix, Script Momentary Fix, Docusaurus Docs
+
+### v2.0.34
+Automatic Backup, Vacuum Battery Auto-Map, Deprecated Feature Flags Fix
+
+### v2.0.33
+Endpoint Number Preservation, Binary Sensor Battery Auto-Map
+
+### v2.0.32
+Multi-Language Support, Plugin System, New Device Types (PIR, Rain, Electrical, AQ Sensors), Cluster Diagnostics, Dashboard Enhancements, Mapping Profile Export/Import, Fan & Air Purifier Fixes, Stale Session Cleanup, KNX Cover Fix
+
+### v2.0.31
+Controller Profiles & Area Setup, Fan Speed/Preset Fix, Optimistic State Fix, Cover Target Fix, Humidity Auto-Mapping Default
+
+### 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
 
@@ -441,7 +468,7 @@ Thank you to everyone who helps improve this project by reporting issues!
 | 💎 StefanS | 💎 Manny B. | 💎 Bonjon |
 | 💎 TobiR | 💎 Franz Huber | 💎 Michele Larese de Prata |
 | 💎 [@CNCB](https://github.com/CNCB) | 💎 [@pelican1997](https://github.com/pelican1997) | 💎 [@PeJanNL](https://github.com/PeJanNL) |
-| 💎 [@bra1nbuster](https://github.com/bra1nbuster) | | |
+| 💎 [@bra1nbuster](https://github.com/bra1nbuster) | 💎 [@knuti1960](https://github.com/knuti1960) | |
 
 🙏 *...and anonymous supporters who prefer not to be named.*
 

package/dist/backend/cli.js

@@ -175948,21 +175948,21 @@ var ROOM_MODE_BASE = 100;
 function isRoomMode(mode) {
   return mode >= ROOM_MODE_BASE;
 }
+var cleaningSessions = /* @__PURE__ */ new WeakMap();
+function getSession(agent) {
+  let session = cleaningSessions.get(agent);
+  if (!session) {
+    session = {
+      completedAreas: /* @__PURE__ */ new Set(),
+      lastCurrentArea: null,
+      activeAreas: [],
+      loggedShortCircuits: /* @__PURE__ */ new Set()
+    };
+    cleaningSessions.set(agent, session);
+  }
+  return session;
+}
 var RvcRunModeServerBase = class extends RvcRunModeServer {
-  /** Areas that the vacuum has already finished cleaning in this session */
-  completedAreas = /* @__PURE__ */ new Set();
-  /** Last known currentArea — used to detect room transitions */
-  lastCurrentArea = null;
-  /** Snapshot of selectedAreas taken when cleaning starts.
-   *  The start handler clears serviceArea.state.selectedAreas after
-   *  dispatching the HA action to prevent re-dispatch, but progress
-   *  tracking needs the original list for the entire cleaning session. */
-  activeAreas = [];
-  /** Diagnostic short-circuit reasons already logged this session.
-   *  updateCurrentRoomFromSensor() is called on every HA state event;
-   *  without this guard a failing path would flood the log. Cleared
-   *  when the vacuum returns to Idle. */
-  loggedShortCircuits = /* @__PURE__ */ new Set();
   async initialize() {
     await super.initialize();
     const homeAssistant = await this.agent.load(HomeAssistantEntityBehavior);
@@ -175973,6 +175973,7 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
     if (!entity.state || !entity.state.attributes) {
       return;
     }
+    const s = getSession(this.agent);
     const previousMode = this.state.currentMode;
     const newMode = this.state.config.getCurrentMode(entity.state, this.agent);
     applyPatchState(
@@ -175989,12 +175990,12 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
     if (previousMode !== newMode) {
       if (newMode === 0 /* Idle */) {
         this.trySetCurrentArea(null);
-        this.completedAreas.clear();
-        this.lastCurrentArea = null;
-        this.loggedShortCircuits.clear();
+        s.completedAreas.clear();
+        s.lastCurrentArea = null;
+        s.loggedShortCircuits.clear();
       } else if (newMode === 1 /* Cleaning */) {
-        if (this.activeAreas.length > 0 && this.lastCurrentArea === null) {
-          this.trySetCurrentArea(this.activeAreas[0]);
+        if (s.activeAreas.length > 0 && s.lastCurrentArea === null) {
+          this.trySetCurrentArea(s.activeAreas[0]);
         }
       }
     }
@@ -176008,8 +176009,9 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
    * surfacing the silent paths that would otherwise be invisible.
    */
   logShortCircuitOnce(reason, message) {
-    if (this.loggedShortCircuits.has(reason)) return;
-    this.loggedShortCircuits.add(reason);
+    const s = getSession(this.agent);
+    if (s.loggedShortCircuits.has(reason)) return;
+    s.loggedShortCircuits.add(reason);
     logger189.info(message);
   }
   /**
@@ -176018,6 +176020,7 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
    */
   updateCurrentRoomFromSensor() {
     try {
+      const s = getSession(this.agent);
       const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
       const currentRoomEntityId = homeAssistant.state.mapping?.currentRoomEntity;
       if (!currentRoomEntityId) {
@@ -176036,7 +176039,7 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
         );
         return;
       }
-      if (this.activeAreas.length === 0) {
+      if (s.activeAreas.length === 0) {
         this.logShortCircuitOnce(
           "no-active-areas",
           `currentRoom sensor: activeAreas empty while cleaning \u2014 sensor=${currentRoomEntityId} state="${roomState.state}"`
@@ -176049,13 +176052,13 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
       const roomName = roomState.state;
       let matchedAreaId = null;
       if (segmentId != null) {
-        if (this.activeAreas.includes(segmentId)) {
+        if (s.activeAreas.includes(segmentId)) {
           matchedAreaId = segmentId;
         }
       }
       if (matchedAreaId === null && segmentId != null) {
         for (const area of serviceArea.state.supportedAreas) {
-          if (this.activeAreas.includes(area.areaId) && area.areaId % 1e4 === segmentId) {
+          if (s.activeAreas.includes(area.areaId) && area.areaId % 1e4 === segmentId) {
             matchedAreaId = area.areaId;
             break;
           }
@@ -176065,23 +176068,23 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
         const area = serviceArea.state.supportedAreas.find(
           (a) => a.areaInfo.locationInfo?.locationName?.toLowerCase() === roomName.toLowerCase()
         );
-        if (area && this.activeAreas.includes(area.areaId)) {
+        if (area && s.activeAreas.includes(area.areaId)) {
           matchedAreaId = area.areaId;
         }
       }
       if (matchedAreaId === null) {
         logger189.info(
-          `currentRoom sensor: no match for "${roomName}" (segmentId=${segmentId}), activeAreas=[${this.activeAreas.join(", ")}], supportedAreas=[${serviceArea.state.supportedAreas.map((a) => `${a.areaId}:${a.areaInfo.locationInfo?.locationName}`).join(", ")}]`
+          `currentRoom sensor: no match for "${roomName}" (segmentId=${segmentId}), activeAreas=[${s.activeAreas.join(", ")}], supportedAreas=[${serviceArea.state.supportedAreas.map((a) => `${a.areaId}:${a.areaInfo.locationInfo?.locationName}`).join(", ")}]`
         );
         return;
       }
-      if (matchedAreaId === this.lastCurrentArea) return;
-      if (this.lastCurrentArea !== null) {
-        this.completedAreas.add(this.lastCurrentArea);
+      if (matchedAreaId === s.lastCurrentArea) return;
+      if (s.lastCurrentArea !== null) {
+        s.completedAreas.add(s.lastCurrentArea);
       }
-      this.lastCurrentArea = matchedAreaId;
+      s.lastCurrentArea = matchedAreaId;
       logger189.info(
-        `currentRoom sensor: transition to area ${matchedAreaId} ("${roomName}"), completed: [${[...this.completedAreas].join(", ")}]`
+        `currentRoom sensor: transition to area ${matchedAreaId} ("${roomName}"), completed: [${[...s.completedAreas].join(", ")}]`
       );
       this.trySetCurrentArea(matchedAreaId);
     } catch (e) {
@@ -176118,17 +176121,18 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
    * matter.js property getters during transaction pre-commit.
    */
   updateProgress(serviceArea, areaId) {
-    if (this.activeAreas.length === 0) return;
+    const s = getSession(this.agent);
+    if (s.activeAreas.length === 0) return;
     const state = serviceArea.state;
     if (areaId === null) {
-      state.progress = this.activeAreas.map((id) => ({
+      state.progress = s.activeAreas.map((id) => ({
         areaId: id,
         status: ServiceArea3.OperationalStatus.Completed
       }));
     } else {
-      state.progress = this.activeAreas.map((id) => ({
+      state.progress = s.activeAreas.map((id) => ({
         areaId: id,
-        status: id === areaId ? ServiceArea3.OperationalStatus.Operating : this.completedAreas.has(id) ? ServiceArea3.OperationalStatus.Completed : ServiceArea3.OperationalStatus.Pending
+        status: id === areaId ? ServiceArea3.OperationalStatus.Operating : s.completedAreas.has(id) ? ServiceArea3.OperationalStatus.Completed : ServiceArea3.OperationalStatus.Pending
       }));
     }
   }
@@ -176150,6 +176154,7 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
     }
   }
   changeToMode(request) {
+    const s = getSession(this.agent);
     const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
     const { newMode } = request;
     if (newMode !== this.state.currentMode && !this.state.supportedModes.some((m) => m.mode === newMode)) {
@@ -176162,8 +176167,8 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
       try {
         const serviceArea = this.agent.get(ServiceAreaBehavior);
         if (serviceArea.state.selectedAreas?.length > 0) {
-          this.activeAreas = [...serviceArea.state.selectedAreas];
-          this.trySetCurrentArea(this.activeAreas[0]);
+          s.activeAreas = [...serviceArea.state.selectedAreas];
+          this.trySetCurrentArea(s.activeAreas[0]);
           homeAssistant.callAction(this.state.config.start(void 0, this.agent));
           this.state.currentMode = newMode;
           return {
@@ -176175,7 +176180,7 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
       }
       if (this.state.config.cleanRoom) {
         const areaId = this.findAreaIdForMode(newMode);
-        this.activeAreas = areaId !== null ? [areaId] : [];
+        s.activeAreas = areaId !== null ? [areaId] : [];
         this.trySetCurrentArea(areaId);
         homeAssistant.callAction(
           this.state.config.cleanRoom(newMode, this.agent)
@@ -176192,8 +176197,8 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
         try {
           const serviceArea = this.agent.get(ServiceAreaBehavior);
           if (serviceArea.state.selectedAreas?.length > 0) {
-            this.activeAreas = [...serviceArea.state.selectedAreas];
-            this.trySetCurrentArea(this.activeAreas[0]);
+            s.activeAreas = [...serviceArea.state.selectedAreas];
+            this.trySetCurrentArea(s.activeAreas[0]);
           }
         } catch {
         }
@@ -176202,9 +176207,9 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
       }
       case 0 /* Idle */:
         this.trySetCurrentArea(null);
-        this.completedAreas.clear();
-        this.lastCurrentArea = null;
-        this.activeAreas = [];
+        s.completedAreas.clear();
+        s.lastCurrentArea = null;
+        s.activeAreas = [];
         homeAssistant.callAction(
           this.state.config.returnToBase(void 0, this.agent)
         );