@riddix/hamh 2.1.0-alpha.709 → 2.1.0-alpha.711

package/README.md

@@ -56,22 +56,22 @@ of port forwarding etc.
 
 **New in v2.0.46:**
 
-- ❄️ Opt-in **companion fan** for climate ACs — a per-entity toggle exposes the AC's fan as its own Matter fan endpoint, the setting is persisted, and fan-speed presets are now ordered low→high ([#309](https://github.com/RiDDiX/home-assistant-matter-hub/issues/309))
-- 🌦️ **Weather domain support** — `weather.*` entities are exposed as a composed Temperature + Humidity + Pressure sensor read from the entity's attributes (pressure converted to hPa, shown on Google Home)
-- 🤖 **Vacuum service-area editing** — edit area data inline in Entity Mapping and dispatch room cleaning in batches, plus a batch-room-data fix ([#291](https://github.com/RiDDiX/home-assistant-matter-hub/issues/291))
-- 🔒 **Door Lock credential hardening** — safer access-code handling and fabric-index casting on the lock cluster ([#313](https://github.com/RiDDiX/home-assistant-matter-hub/issues/313))
-- ⚡ **Skip unchanged endpoints on HA updates** — only endpoints whose entity or a mapped sub-entity actually changed are refreshed, so CPU no longer scales with entity count × event rate ([#351](https://github.com/RiDDiX/home-assistant-matter-hub/issues/351))
-- 🔌 **Registry stays resilient when HA drops** — an initial reload failure no longer puts the add-on in a restart loop on a flaky HA boot, and a mid-flight "Connection lost" retries once ([#352](https://github.com/RiDDiX/home-assistant-matter-hub/issues/352))
+- ❄️ Opt-in **companion fan** for climate ACs: a per-entity toggle exposes the AC's fan as its own Matter fan endpoint, the setting is persisted, and fan-speed presets are now ordered low→high ([#309](https://github.com/RiDDiX/home-assistant-matter-hub/issues/309))
+- 🌦️ **Weather domain support**: `weather.*` entities are exposed as a composed Temperature + Humidity + Pressure sensor read from the entity's attributes (pressure converted to hPa, shown on Google Home)
+- 🤖 **Vacuum service-area editing**: edit area data inline in Entity Mapping and dispatch room cleaning in batches, plus a batch-room-data fix ([#291](https://github.com/RiDDiX/home-assistant-matter-hub/issues/291))
+- 🔒 **Door Lock credential hardening**: safer access-code handling and fabric-index casting on the lock cluster ([#313](https://github.com/RiDDiX/home-assistant-matter-hub/issues/313))
+- ⚡ **Skip unchanged endpoints on HA updates**: only endpoints whose entity or a mapped sub-entity actually changed are refreshed, so CPU no longer scales with entity count × event rate ([#351](https://github.com/RiDDiX/home-assistant-matter-hub/issues/351))
+- 🔌 **Registry stays resilient when HA drops**: an initial reload failure no longer puts the add-on in a restart loop on a flaky HA boot, and a mid-flight "Connection lost" retries once ([#352](https://github.com/RiDDiX/home-assistant-matter-hub/issues/352))
 - 🔁 **RVC sessions refreshed safely** so vacuum reactors don't go stale ([#287](https://github.com/RiDDiX/home-assistant-matter-hub/issues/287))
 - 🪟 **Tilt-only covers** use the tilt channel for lift commands ([#350](https://github.com/RiDDiX/home-assistant-matter-hub/issues/350))
 - 🔋 **Battery auto-mapping narrowed** to avoid false matches, plus support for enum battery states ([#359](https://github.com/RiDDiX/home-assistant-matter-hub/issues/359))
-- 🔘 **`automation` entities are momentary** — turning one on triggers it and snaps back to off ([#364](https://github.com/RiDDiX/home-assistant-matter-hub/issues/364))
+- 🔘 **`automation` entities are momentary**: turning one on triggers it and snaps back to off ([#364](https://github.com/RiDDiX/home-assistant-matter-hub/issues/364))
 - 🌀 **Climate swing-mode handling fix**
-- 🚨 **Non-5540 Alexa bridge warning** — a bridge on any other port now warns, since Alexa only pairs on port 5540
-- 🧵 **matter.js 0.17.0** — upgraded from 0.16.11; the local LG-TV NOC-serial patch is dropped because upstream now tolerates 21-octet operational cert serials ([#305](https://github.com/RiDDiX/home-assistant-matter-hub/issues/305))
-- 🧰 Build/runtime fixes — `bun:sqlite` `constants` export stubbed so the esbuild bundle builds against matter.js 0.17.0, add-on heap flag preserved ([#358](https://github.com/RiDDiX/home-assistant-matter-hub/issues/358))
+- 🚨 **Non-5540 Alexa bridge warning**: a bridge on any other port now warns, since Alexa only pairs on port 5540
+- 🧵 **matter.js 0.17.0**: upgraded from 0.16.11; the local LG-TV NOC-serial patch is dropped because upstream now tolerates 21-octet operational cert serials ([#305](https://github.com/RiDDiX/home-assistant-matter-hub/issues/305))
+- 🧰 Build/runtime fixes: `bun:sqlite` `constants` export stubbed so the esbuild bundle builds against matter.js 0.17.0, add-on heap flag preserved ([#358](https://github.com/RiDDiX/home-assistant-matter-hub/issues/358))
 - ⬆️ Dependency vulnerabilities resolved
-- 📝 Docs — `hvac_action` requirement for the Auto running-state display ([#309](https://github.com/RiDDiX/home-assistant-matter-hub/issues/309)), Google Home ModeSelect label gap ([#356](https://github.com/RiDDiX/home-assistant-matter-hub/issues/356)), Alexa cover-routine limitation ([#312](https://github.com/RiDDiX/home-assistant-matter-hub/issues/312)), and the new weather domain
+- 📝 Docs: `hvac_action` requirement for the Auto running-state display ([#309](https://github.com/RiDDiX/home-assistant-matter-hub/issues/309)), Google Home ModeSelect label gap ([#356](https://github.com/RiDDiX/home-assistant-matter-hub/issues/356)), Alexa cover-routine limitation ([#312](https://github.com/RiDDiX/home-assistant-matter-hub/issues/312)), and the new weather domain
 
 **Previously in v2.0.45 (hotfix release):**
 
@@ -79,12 +79,12 @@ of port forwarding etc.
 
 **Previously in v2.0.44:**
 
-- 🪟 Cover reliability overhaul — Matter state/target/current reports split and correctly ordered, deferred target writes de-duplicated, legacy position attributes dropped from updates, cluster profile aligned with the certified Eve blind, current position held during external motion ([#328](https://github.com/RiDDiX/home-assistant-matter-hub/issues/328))
+- 🪟 Cover reliability overhaul: Matter state/target/current reports split and correctly ordered, deferred target writes de-duplicated, legacy position attributes dropped from updates, cluster profile aligned with the certified Eve blind, current position held during external motion ([#328](https://github.com/RiDDiX/home-assistant-matter-hub/issues/328))
 - 🎚️ Per-bridge and per-entity cover slider debounce, window widened to 300 ms for smoother slider control ([#331](https://github.com/RiDDiX/home-assistant-matter-hub/issues/331))
 - 🤖 Vacuum service-area handling: `customServiceAreas` preserved in dynamic `RvcRunMode` supported modes, custom areas dispatched sequentially, `currentArea` cleared on dock return and no longer inherited stale across restarts, `observedCleaning` set on every cleaning event ([#335](https://github.com/RiDDiX/home-assistant-matter-hub/issues/335))
 - 🔋 Docked vacuum stops reporting charging once the battery is full ([#334](https://github.com/RiDDiX/home-assistant-matter-hub/issues/334))
 - ❄️ Per-entity `climateKeepModeOnIdle` for off+idle ACs; mode kept through a cool→off transition, freeze applied immediately on off and cleared on `action=off` ([#340](https://github.com/RiDDiX/home-assistant-matter-hub/issues/340))
-- 🔁 Matter session rotation — opt-in per-bridge setting, aged sessions rotated, RVC clean-mode reactor goes offline correctly, `pushKeepalive` guarded on construction ([#287](https://github.com/RiDDiX/home-assistant-matter-hub/issues/287))
+- 🔁 Matter session rotation: opt-in per-bridge setting, aged sessions rotated, RVC clean-mode reactor goes offline correctly, `pushKeepalive` guarded on construction ([#287](https://github.com/RiDDiX/home-assistant-matter-hub/issues/287))
 - 🧠 Heap-headroom and force-sync pressure guard to reduce memory pressure ([#347](https://github.com/RiDDiX/home-assistant-matter-hub/issues/347))
 - 🏷️ Per-entity `customVendorId` with Home Assistant device-registry serial fallback ([#290](https://github.com/RiDDiX/home-assistant-matter-hub/issues/290))
 - 🔢 `serialNumberSuffix` now loads when editing a bridge and is preserved when the serial is trimmed to 32 characters ([#330](https://github.com/RiDDiX/home-assistant-matter-hub/issues/330))
@@ -97,7 +97,7 @@ of port forwarding etc.
 - 🧩 JSON editor de-duplicates `@codemirror/state` ([#345](https://github.com/RiDDiX/home-assistant-matter-hub/issues/345))
 - 🌍 Polish translation update, credited to [@MStankiewiczOfficial](https://github.com/MStankiewiczOfficial) ([#329](https://github.com/RiDDiX/home-assistant-matter-hub/pull/329))
 - ✅ Added regression test coverage for the session-max-age parser ([#287](https://github.com/RiDDiX/home-assistant-matter-hub/issues/287))
-- ⬆️ Dependency hygiene — transitive deps flagged by Dependabot patched, `serialize-javascript` bumped to 7.0.5 in docs-site
+- ⬆️ Dependency hygiene: transitive deps flagged by Dependabot patched, `serialize-javascript` bumped to 7.0.5 in docs-site
 
 **Previously in v2.0.43:**
 

package/dist/backend/cli.js

@@ -124137,7 +124137,7 @@ var init_bridge_config_schema = __esm({
         },
         coverSliderDebounceMs: {
           title: "Cover Slider Debounce (ms)",
-          description: "Override the cover position-update debounce window for this bridge. Some controllers (Apple Home) stream slider updates while the user is still dragging, causing covers to start moving toward an intermediate target. Set to the time the bridge should wait after the last update before sending the final value to Home Assistant. 0 keeps the built-in two-phase debounce (400 ms initial / 150 ms subsequent), which fits most controllers. Try 800\u20131500 ms for slow blinds. A per-entity override on a single cover wins over this flag.",
+          description: "Override the cover position-update debounce window for this bridge. Some controllers (Apple Home) stream slider updates while the user is still dragging, causing covers to start moving toward an intermediate target. Set to the time the bridge should wait after the last update before sending the final value to Home Assistant. 0 keeps the built-in two-phase debounce (400 ms initial / 150 ms subsequent), which fits most controllers. Try 800-1500 ms for slow blinds. A per-entity override on a single cover wins over this flag.",
           type: "number",
           minimum: 0,
           maximum: 5e3,
@@ -125176,7 +125176,8 @@ WARNING: ${includeIdentity ? "This backup contains sensitive Matter identity dat
           req.file.buffer
         );
         const existingIds = new Set(bridgeStorage.bridges.map((b) => b.id));
-        const bridgesToRestore = options.bridgeIds ? backupData.bridges.filter((b) => options.bridgeIds.includes(b.id)) : backupData.bridges;
+        const bridgeIds = options.bridgeIds;
+        const bridgesToRestore = bridgeIds ? backupData.bridges.filter((b) => bridgeIds.includes(b.id)) : backupData.bridges;
         let bridgesRestored = 0;
         let bridgesSkipped = 0;
         let mappingsRestored = 0;
@@ -125220,6 +125221,7 @@ WARNING: ${includeIdentity ? "This backup contains sensitive Matter identity dat
                     coverSliderDebounceMs: config11.coverSliderDebounceMs,
                     disableClimateOnOff: config11.disableClimateOnOff,
                     disableClimateFanControl: config11.disableClimateFanControl,
+                    climateAutoMode: config11.climateAutoMode,
                     customServiceAreas: config11.customServiceAreas,
                     customFanSpeedTags: config11.customFanSpeedTags,
                     composedEntities: config11.composedEntities
@@ -125324,7 +125326,8 @@ WARNING: ${includeIdentity ? "This backup contains sensitive Matter identity dat
       const options = req.body || {};
       const { backupData, zipDirectory } = await extractBackupData(buffer);
       const existingIds = new Set(bridgeStorage.bridges.map((b) => b.id));
-      const bridgesToRestore = options.bridgeIds ? backupData.bridges.filter((b) => options.bridgeIds.includes(b.id)) : backupData.bridges;
+      const bridgeIds = options.bridgeIds;
+      const bridgesToRestore = bridgeIds ? backupData.bridges.filter((b) => bridgeIds.includes(b.id)) : backupData.bridges;
       let bridgesRestored = 0;
       let bridgesSkipped = 0;
       let mappingsRestored = 0;
@@ -125368,6 +125371,7 @@ WARNING: ${includeIdentity ? "This backup contains sensitive Matter identity dat
                   coverSliderDebounceMs: config11.coverSliderDebounceMs,
                   disableClimateOnOff: config11.disableClimateOnOff,
                   disableClimateFanControl: config11.disableClimateFanControl,
+                  climateAutoMode: config11.climateAutoMode,
                   customServiceAreas: config11.customServiceAreas,
                   customFanSpeedTags: config11.customFanSpeedTags,
                   composedEntities: config11.composedEntities
@@ -126211,6 +126215,7 @@ function entityMappingApi(mappingStorage) {
       disableClimateFanControl: body.disableClimateFanControl,
       climateKeepModeOnIdle: body.climateKeepModeOnIdle,
       climateExposeFan: body.climateExposeFan,
+      climateAutoMode: body.climateAutoMode,
       composedEntities: body.composedEntities
     };
     const config11 = await mappingStorage.setMapping(request);
@@ -126678,7 +126683,8 @@ function configToProfileEntry(config11) {
     disableClimateOnOff: config11.disableClimateOnOff,
     disableClimateFanControl: config11.disableClimateFanControl,
     climateKeepModeOnIdle: config11.climateKeepModeOnIdle,
-    climateExposeFan: config11.climateExposeFan
+    climateExposeFan: config11.climateExposeFan,
+    climateAutoMode: config11.climateAutoMode
   };
 }
 function mappingProfileApi(mappingStorage) {
@@ -126804,7 +126810,8 @@ function mappingProfileApi(mappingStorage) {
           disableClimateOnOff: entry.disableClimateOnOff,
           disableClimateFanControl: entry.disableClimateFanControl,
           climateKeepModeOnIdle: entry.climateKeepModeOnIdle,
-          climateExposeFan: entry.climateExposeFan
+          climateExposeFan: entry.climateExposeFan,
+          climateAutoMode: entry.climateAutoMode
         });
         applied++;
       } catch (e) {
@@ -130741,9 +130748,10 @@ var EntityMappingStorage = class extends Service {
       disableClimateFanControl: request.disableClimateFanControl || void 0,
       climateKeepModeOnIdle: request.climateKeepModeOnIdle || void 0,
       climateExposeFan: request.climateExposeFan || void 0,
+      climateAutoMode: request.climateAutoMode || void 0,
       composedEntities: request.composedEntities?.filter((e) => e.entityId?.trim()) ?? 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.roomEntities && !config11.disableLockPin && !config11.powerEntity && !config11.energyEntity && !config11.pressureEntity && !config11.suctionLevelEntity && !config11.mopIntensityEntity && (!config11.customServiceAreas || config11.customServiceAreas.length === 0) && (!config11.customFanSpeedTags || Object.keys(config11.customFanSpeedTags).length === 0) && !config11.currentRoomEntity && !config11.valetudoIdentifier && !config11.coverSwapOpenClose && !config11.coverSliderDebounceMs && !config11.disableClimateOnOff && !config11.disableClimateFanControl && !config11.climateKeepModeOnIdle && !config11.climateExposeFan && (!config11.composedEntities || config11.composedEntities.length === 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.roomEntities && !config11.disableLockPin && !config11.powerEntity && !config11.energyEntity && !config11.pressureEntity && !config11.suctionLevelEntity && !config11.mopIntensityEntity && (!config11.customServiceAreas || config11.customServiceAreas.length === 0) && (!config11.customFanSpeedTags || Object.keys(config11.customFanSpeedTags).length === 0) && !config11.currentRoomEntity && !config11.valetudoIdentifier && !config11.coverSwapOpenClose && !config11.coverSliderDebounceMs && !config11.disableClimateOnOff && !config11.disableClimateFanControl && !config11.climateKeepModeOnIdle && !config11.climateExposeFan && !config11.climateAutoMode && (!config11.composedEntities || config11.composedEntities.length === 0)) {
       bridgeMap.delete(request.entityId);
     } else {
       bridgeMap.set(request.entityId, config11);
@@ -150795,6 +150803,15 @@ function getRunningModeFromHvacAction(entity) {
   }
   return hvacActionToRunningMode[action] ?? Thermostat3.ThermostatRunningMode.Off;
 }
+function pinnedAutoSystemMode(override) {
+  if (override === "cool") {
+    return Thermostat3.SystemMode.Cool;
+  }
+  if (override === "heat") {
+    return Thermostat3.SystemMode.Heat;
+  }
+  return void 0;
+}
 var hvacModeToSystemMode = {
   [ClimateHvacMode.heat]: Thermostat3.SystemMode.Heat,
   [ClimateHvacMode.cool]: Thermostat3.SystemMode.Cool,
@@ -150848,6 +150865,16 @@ function computeSystemMode(entity, agent) {
     }
     const homeAssistant = agent.get(HomeAssistantEntityBehavior);
     const entityId = homeAssistant.entityId;
+    const pinnedMode = pinnedAutoSystemMode(
+      homeAssistant.state.mapping?.climateAutoMode
+    );
+    if (pinnedMode != null) {
+      lastHvacDirection.set(
+        entityId,
+        pinnedMode === Thermostat3.SystemMode.Cool ? "cooling" : "heating"
+      );
+      return pinnedMode;
+    }
     const action = attributes5(entity).hvac_action;
     if (action === ClimateHvacAction.cooling) {
       lastHvacDirection.set(entityId, "cooling");
@@ -162955,14 +162982,22 @@ var ServerModeVacuumEndpoint = class _ServerModeVacuumEndpoint extends EntityEnd
       }
     }, 55e3);
   }
-  async delete() {
+  clearTimers() {
     if (this.keepaliveTimer) {
       clearInterval(this.keepaliveTimer);
       this.keepaliveTimer = void 0;
     }
     this.flushUpdate.clear();
+  }
+  // dispose calls close(), not delete(), so clean up in both
+  async delete() {
+    this.clearTimers();
     await super.delete();
   }
+  async close() {
+    this.clearTimers();
+    await super.close();
+  }
   /**
    * Re-push the latest operational state through setStateOf.
    * NoError stays detail-free so controllers do not display a false issue.