@riddix/hamh 2.1.0-alpha.806 → 2.1.0-alpha.808

package/README.md

@@ -37,7 +37,7 @@ of port forwarding etc.
 
 | Channel | Branch | Current Version | Description |
 |---------|--------|-----------------|-------------|
-| **Stable** | `main` | v2.0.48 | Production-ready, recommended for most users |
+| **Stable** | `main` | v2.0.49 | 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.48)</strong> - Click to expand</summary>
+<summary><strong>📦 Stable Features (v2.0.49)</strong> - Click to expand</summary>
 
-**New in v2.0.48:**
+**New in v2.0.49:**
+
+- 🌀 **Fan speed restore**: speed is remembered across transactions and restarts, localized wind presets map through, Auto is gated on a real auto preset, and an opt-in restores speed on power-on ([#387](https://github.com/RiDDiX/home-assistant-matter-hub/issues/387))
+- 📡 **Session recovery hardening**: subscription jitter dropped, superseded sessions of a reconnecting peer swept, stale sessions closed only after a real quiet period, plus opt-in fast recovery ([#386](https://github.com/RiDDiX/home-assistant-matter-hub/issues/386), [#400](https://github.com/RiDDiX/home-assistant-matter-hub/issues/400), [#398](https://github.com/RiDDiX/home-assistant-matter-hub/issues/398), [#287](https://github.com/RiDDiX/home-assistant-matter-hub/issues/287))
+- 🩺 **Per-fabric controller health card** on the bridge page
+- 🔢 **Endpoint number kept on mapping change** so Alexa no longer re-adds the device ([#404](https://github.com/RiDDiX/home-assistant-matter-hub/issues/404)), plus a **unique-id suffix** to shed stale controller records ([#385](https://github.com/RiDDiX/home-assistant-matter-hub/issues/385))
+- 🔘 **`select` as an On/Off Switch** ([#356](https://github.com/RiDDiX/home-assistant-matter-hub/issues/356)), plus an **experimental mounted On/Off** control type ([#380](https://github.com/RiDDiX/home-assistant-matter-hub/issues/380))
+- 🪟 **Tilt for `set_tilt_position`-only covers** ([#405](https://github.com/RiDDiX/home-assistant-matter-hub/issues/405)), and **tilt-only cover-as-light** uses the tilt channel ([#350](https://github.com/RiDDiX/home-assistant-matter-hub/issues/350))
+- 🚨 **Warns on a non-5540 Alexa bridge** ([#401](https://github.com/RiDDiX/home-assistant-matter-hub/issues/401)) and on an **OTBR Thread mDNS interface** ([#388](https://github.com/RiDDiX/home-assistant-matter-hub/issues/388))
+- 📷 **Camera plugin config scoped per bridge** ([#373](https://github.com/RiDDiX/home-assistant-matter-hub/issues/373))
+- 🔌 **Clashing bridge port reassigned on load** ([#378](https://github.com/RiDDiX/home-assistant-matter-hub/issues/378))
+- 🧩 **Composed sub-entities compose even outside the bridge filter** ([#408](https://github.com/RiDDiX/home-assistant-matter-hub/issues/408)), and **composed sensors list all device types** ([#214](https://github.com/RiDDiX/home-assistant-matter-hub/issues/214))
+- 🔒 **Unbolt maps to `lock.unlock`** not open ([#397](https://github.com/RiDDiX/home-assistant-matter-hub/issues/397)), **level-to-brightness uses one scale** ([#402](https://github.com/RiDDiX/home-assistant-matter-hub/issues/402)), **button drops the Lighting feature** ([#182](https://github.com/RiDDiX/home-assistant-matter-hub/issues/182)), and **stale cooling/auto state is cleared** ([#384](https://github.com/RiDDiX/home-assistant-matter-hub/issues/384))
+- 🌍 **Russian translations** added ([#409](https://github.com/RiDDiX/home-assistant-matter-hub/issues/409)) and **zh-TW completed**
+
+**Previously in v2.0.48:**
 
 - 🌡️ Cooling-only thermostats no longer drop and re-pair after a switch to cool; a leftover Heat setpoint limit was crashing init ([#381](https://github.com/RiDDiX/home-assistant-matter-hub/issues/381))
 - 📝 The Settings update box now shows the full release notes instead of cutting them off
@@ -220,7 +235,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.46).** All alpha work up to the latest pre-release has been promoted into v2.0.46. 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.49).** All alpha work up to the latest pre-release has been promoted into v2.0.49. New alpha work continues from the next pre-release tag onward and will appear here as development progresses.
 
 </details>
 
@@ -498,7 +513,7 @@ Matter relies heavily on **mDNS (multicast DNS)** for device discovery and reach
 - **Keep the path simple**: Avoid placing access points or managed switches between your Matter bridge (Home Assistant) and your Home Hub (HomePod/Apple TV)
 - **Use wired connections** where possible for Home Hubs and the Home Assistant host
 - **Same subnet**: All Matter devices, controllers, and the bridge must be on the same Layer 2 network / subnet
-- **IPv6**: Matter requires IPv6, do not disable it. For VLAN setups, configure **ULA addresses** (`fd00::/8`), not just link-local (`fe80::`). See [Troubleshooting](https://home-assistant-matter-hub.riddix.dev/guides/connectivity-issues#ipv6) and [Discussion #39](https://github.com/RiDDiX/home-assistant-matter-hub/discussions/39)
+- **IPv6**: Matter requires IPv6, do not disable it. For VLAN setups, configure **ULA addresses** (`fd00::/8`), not just link-local (`fe80::`). See [Troubleshooting](https://riddix.github.io/home-assistant-matter-hub/guides/connectivity-issues#ipv6) and [Discussion #39](https://github.com/RiDDiX/home-assistant-matter-hub/discussions/39)
 
 </details>
 

package/dist/backend/cli.js

@@ -162514,6 +162514,9 @@ function createLegacyEndpointType(entity, mapping, areaName, options) {
     const overrideFactory = matterDeviceTypeFactories[mapping.matterDeviceType];
     if (overrideFactory) {
       type = overrideFactory({ entity, customName, mapping });
+      if (type && mapping.batteryEntity && !hasPowerSource(type)) {
+        type = addPowerSource(type);
+      }
     }
   }
   if (!type) {
@@ -162564,6 +162567,16 @@ function addFixedLabel(type, areaName) {
     behaviors: { ...type.behaviors, fixedLabel }
   };
 }
+function hasPowerSource(type) {
+  return "powerSource" in type.behaviors;
+}
+function addPowerSource(type) {
+  const mutable = type;
+  if (typeof mutable.with === "function") {
+    return mutable.with(DefaultPowerSourceServer);
+  }
+  return type;
+}
 var deviceCtrs = {
   light: LightDevice,
   switch: SwitchDevice,
@@ -162680,6 +162693,7 @@ var UserComposedEndpoint = class _UserComposedEndpoint extends Endpoint {
   mappedEntityIds;
   subEndpoints = /* @__PURE__ */ new Map();
   lastStates = /* @__PURE__ */ new Map();
+  lastMappedStates = /* @__PURE__ */ new Map();
   debouncedUpdates = /* @__PURE__ */ new Map();
   static async create(config11) {
     const { registry: registry2, primaryEntityId, composedEntities } = config11;
@@ -162698,14 +162712,32 @@ var UserComposedEndpoint = class _UserComposedEndpoint extends Endpoint {
         })
       );
     }
+    if (config11.mapping?.batteryEntity) {
+      parentType = parentType.with(DefaultPowerSourceServer);
+    }
     const endpointId = createEndpointId5(primaryEntityId, config11.customName);
     const parts = [];
     const subEndpointMap = /* @__PURE__ */ new Map();
     const mappedIds = [];
+    if (config11.mapping?.batteryEntity) {
+      mappedIds.push(config11.mapping.batteryEntity);
+    }
+    let primaryMapping = config11.mapping;
+    let primarySubPayload = primaryPayload;
+    if (config11.mapping?.batteryEntity) {
+      primaryMapping = { ...config11.mapping, batteryEntity: void 0 };
+      const attributes9 = { ...primaryPayload.state.attributes };
+      delete attributes9.battery;
+      delete attributes9.battery_level;
+      primarySubPayload = {
+        ...primaryPayload,
+        state: { ...primaryPayload.state, attributes: attributes9 }
+      };
+    }
     const primaryType = createLegacyEndpointType(
-      primaryPayload,
-      config11.mapping,
-      void 0,
+      primarySubPayload,
+      primaryMapping,
+      config11.areaName,
       { vacuumOnOff: registry2.isVacuumOnOffEnabled() }
     );
     if (!primaryType) {
@@ -162733,7 +162765,11 @@ var UserComposedEndpoint = class _UserComposedEndpoint extends Endpoint {
         entityId: sub.entityId,
         matterDeviceType: sub.matterDeviceType
       };
-      const subType = createLegacyEndpointType(subPayload, subMapping);
+      const subType = createLegacyEndpointType(
+        subPayload,
+        subMapping,
+        config11.areaName
+      );
       if (!subType) {
         logger229.warn(
           `Cannot create endpoint type for composed sub-entity ${sub.entityId}`
@@ -162782,12 +162818,29 @@ var UserComposedEndpoint = class _UserComposedEndpoint extends Endpoint {
     this.mappedEntityIds = mappedEntityIds;
   }
   async updateStates(states) {
-    this.scheduleUpdate(this, this.entityId, states);
+    const mappedChanged = this.hasMappedNonSubEntityChanged(states);
+    this.scheduleUpdate(this, this.entityId, states, mappedChanged);
     for (const [entityId, sub] of this.subEndpoints) {
       this.scheduleUpdate(sub, entityId, states);
     }
   }
-  scheduleUpdate(endpoint, entityId, states) {
+  // A mapped entity without its own sub-endpoint (the battery) drives the parent
+  // PowerSource, so track its state and report when it moves. Subs flush
+  // themselves, so skip them here.
+  hasMappedNonSubEntityChanged(states) {
+    let changed = false;
+    for (const mappedId of this.mappedEntityIds) {
+      if (this.subEndpoints.has(mappedId)) continue;
+      const mappedState = states[mappedId];
+      if (!mappedState) continue;
+      if (mappedState.state !== this.lastMappedStates.get(mappedId)) {
+        this.lastMappedStates.set(mappedId, mappedState.state);
+        changed = true;
+      }
+    }
+    return changed;
+  }
+  scheduleUpdate(endpoint, entityId, states, force = false) {
     const state = states[entityId];
     if (!state) return;
     const key = endpoint === this ? `_parent_:${entityId}` : entityId;
@@ -162795,8 +162848,9 @@ var UserComposedEndpoint = class _UserComposedEndpoint extends Endpoint {
       s: state.state,
       a: state.attributes
     });
-    if (this.lastStates.get(key) === stateJson) return;
+    if (!force && this.lastStates.get(key) === stateJson) return;
     this.lastStates.set(key, stateJson);
+    const effectiveState = force ? { ...state, last_updated: (/* @__PURE__ */ new Date()).toISOString() } : state;
     let debouncedFn = this.debouncedUpdates.get(key);
     if (!debouncedFn) {
       debouncedFn = debounce5(
@@ -162805,7 +162859,7 @@ var UserComposedEndpoint = class _UserComposedEndpoint extends Endpoint {
       );
       this.debouncedUpdates.set(key, debouncedFn);
     }
-    debouncedFn(endpoint, state);
+    debouncedFn(endpoint, effectiveState);
   }
   async flushUpdate(endpoint, state) {
     try {