@riddix/hamh 2.1.0-alpha.599 → 2.1.0-alpha.601

package/README.md

@@ -37,7 +37,7 @@ of port forwarding etc.
 
 | Channel | Branch | Current Version | Description |
 |---------|--------|-----------------|-------------|
-| **Stable** | `main` | v2.0.36 | Production-ready, recommended for most users |
+| **Stable** | `main` | v2.0.38 | 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,9 +52,30 @@ of port forwarding etc.
 ## 🎉 What's New
 
 <details>
-<summary><strong>📦 Stable Features (v2.0.36)</strong> - Click to expand</summary>
+<summary><strong>📦 Stable Features (v2.0.38)</strong> - Click to expand</summary>
 
-**New in v2.0.36:**
+**New in v2.0.38:**
+
+| Feature | Description |
+|---------|-------------|
+| **🏷️ Per-Entity Identity Overrides** | `customProductName`, `customVendorName`, `customSerialNumber` per entity mapping ([#277](https://github.com/RiDDiX/home-assistant-matter-hub/issues/277), [#290](https://github.com/RiDDiX/home-assistant-matter-hub/issues/290)) |
+| **🪟 Garage & Gate Open/Close** | Discrete Open/Close mode for garage and gate covers ([#55](https://github.com/RiDDiX/home-assistant-matter-hub/issues/55)) |
+| **🚿 Dishwasher Device Type** | Dishwasher override for switch entities |
+| **🚨 Siren Support** | Siren domain as OnOff Plug-in Unit |
+| **🏷️ productNameFromNodeLabel Flag** | Report node label as Matter productName for Aqara controllers |
+| **🤖 Vacuum Room Progress** | Dynamic room progress tracking via `currentRoomEntity` sensor |
+| **⚡ Startup Force Sync** | Immediate force sync on startup to beat stale Alexa queues ([#282](https://github.com/RiDDiX/home-assistant-matter-hub/pull/282)) |
+| **🌐 Network Diagnostic API** | mDNS/network diagnostic endpoint with dashboard card |
+| **🔌 Energy on Composed Devices** | Energy/power measurement clusters on composed endpoints |
+| **🩺 Multi-Admin Fabric Diagnostics** | Per-fabric session info in health API |
+| **🩺 Docker HEALTHCHECK** | Native healthcheck in standalone and addon images |
+| **🔒 Admin Password Hashing** | Admin password stored hashed, `timingSafeEqual` for lock PIN verification |
+| **🧵 Matter.js 0.16.11** | Updated Matter stack |
+| **🌍 Polish + Traditional Chinese** | New `pl` and `zh-tw` locales |
+
+**Fix highlights:** vacuum keepalive for Apple Home "Updating…" ([#287](https://github.com/RiDDiX/home-assistant-matter-hub/issues/287)), multi-phase clean progress ([#281](https://github.com/RiDDiX/home-assistant-matter-hub/issues/281)), GenericSwitch single/multi split for Apple Home buttons ([#289](https://github.com/RiDDiX/home-assistant-matter-hub/issues/289)), HA restart attribute guards ([#286](https://github.com/RiDDiX/home-assistant-matter-hub/issues/286)), fan speed restore on turn-on ([#275](https://github.com/RiDDiX/home-assistant-matter-hub/issues/275)), moisture sensor auto-map to HumiditySensor ([#273](https://github.com/RiDDiX/home-assistant-matter-hub/issues/273)), TV speaker override ([#293](https://github.com/RiDDiX/home-assistant-matter-hub/issues/293)), rain + radon sensor auto-mapping, composed sub-endpoint cleanup.
+
+**Previously in v2.0.36:**
 
 | Feature | Description |
 |---------|-------------|
@@ -70,21 +91,12 @@ of port forwarding etc.
 | **🔥 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 |
-|---------|-------------|
-| **🏠 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.36).** All alpha features have been promoted to stable. New alpha features will appear here as development continues.
+**Alpha is currently level with Stable (v2.0.38).** All alpha features from the v2.1.0-alpha.600 line have been promoted into v2.0.38. New alpha work continues from `v2.1.0-alpha.601` onward and will appear here as development progresses.
 
 </details>
 
@@ -110,6 +122,9 @@ of port forwarding etc.
 <details>
 <summary><strong>📜 Previous Stable Versions</strong> - Click to expand</summary>
 
+### v2.0.37
+Aqara productNameFromNodeLabel flag, Matter.js 0.16.11, Swedish locale update
+
 ### 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
 
@@ -412,6 +427,7 @@ This project thrives thanks to the amazing community! Special thanks to everyone
 | [@markgaze](https://github.com/markgaze) | 🤖 **Code Contributor** - Ecovacs Deebot room support ([#118](https://github.com/RiDDiX/home-assistant-matter-hub/pull/118)) |
 | [@omerfaruk-aran](https://github.com/omerfaruk-aran) | 🔧 **Network Debugging Expert** - Systematic mDNS/multicast root cause analysis for "No Response" issues ([#129](https://github.com/RiDDiX/home-assistant-matter-hub/issues/129)) |
 | [@gustavakerstrom](https://github.com/gustavakerstrom) | 🤖 **Code Contributor** - Template description display fix ([#215](https://github.com/RiDDiX/home-assistant-matter-hub/pull/215)) |
+| [@aetasoul](https://github.com/aetasoul) | 🤖 **Code Contributor** - Immediate force sync on startup to beat stale Alexa queues ([#282](https://github.com/RiDDiX/home-assistant-matter-hub/pull/282)) |
 
 <details>
 <summary><strong>📋 Issue Tracker - All Contributors</strong> (click to expand)</summary>
@@ -486,6 +502,8 @@ Thank you to everyone who helps improve this project by reporting issues!
 
 If you find this project useful, consider supporting its development:
 
+[![GitHub Sponsors](https://img.shields.io/badge/GitHub%20Sponsors-Donate-ea4aaa?logo=githubsponsors&style=for-the-badge)](https://github.com/sponsors/RiDDiX)
+[![Ko-fi](https://img.shields.io/badge/Ko--fi-Donate-ff5e5b?logo=kofi&logoColor=white&style=for-the-badge)](https://ko-fi.com/riddix)
 [![PayPal](https://img.shields.io/badge/PayPal-Donate-blue?logo=paypal&style=for-the-badge)](https://www.paypal.me/RiDDiX93)
 
 Your support helps cover hosting costs and motivates continued development. Thank you! ❤️

package/dist/backend/cli.js

@@ -146788,6 +146788,12 @@ var init_bridge_config_schema = __esm({
           type: "boolean",
           default: false
         },
+        productNameFromNodeLabel: {
+          title: "Product Name from Node Label",
+          description: "Report the entity's node label (custom name / friendly name / entity id) as the Matter productName. Useful for controllers like Aqara that display productName as the device name instead of nodeLabel. A per-entity customProductName still takes precedence.",
+          type: "boolean",
+          default: false
+        },
         vacuumOnOff: {
           title: "Vacuum: Include OnOff Cluster (Alexa)",
           description: "Add an OnOff cluster to robot vacuum endpoints. Alexa REQUIRES this (PowerController) to show robotic vacuums in the app. Without it, Alexa commissions the device but never displays it. In Server Mode this is enabled automatically \u2014 only check this for bridge mode. WARNING: OnOff is NOT part of the Matter RVC device type specification. Enabling this may break Apple Home (shows 'Updating') and Google Home.",
@@ -165135,6 +165141,7 @@ function trimToLength(value, maxLength, suffix) {
 // src/matter/endpoints/server-mode-server-node.ts
 var ServerModeServerNode = class extends ServerNode {
   deviceEndpoint;
+  featureFlags;
   constructor(env, bridgeData) {
     super({
       id: bridgeData.id,
@@ -165163,6 +165170,7 @@ var ServerModeServerNode = class extends ServerNode {
         persistenceEnabled: false
       }
     });
+    this.featureFlags = bridgeData.featureFlags;
   }
   /**
    * Add the device endpoint to this server node.
@@ -165190,11 +165198,13 @@ var ServerModeServerNode = class extends ServerNode {
    * Without this, server-mode devices show bridge defaults (e.g. "riddix" / "MatterHub").
    */
   updateDeviceIdentity(entityId, device, mapping, friendlyName) {
+    const nodeLabel = trimToLength(mapping?.customName, 32, "...") ?? trimToLength(friendlyName, 32, "...") ?? trimToLength(entityId, 32, "...");
+    const productNameFromNodeLabel = this.featureFlags?.productNameFromNodeLabel === true ? nodeLabel : void 0;
     applyPatchState(this.state.basicInformation, {
       vendorName: trimToLength(mapping?.customVendorName, 32, "...") ?? trimToLength(device?.manufacturer, 32, "..."),
-      productName: trimToLength(mapping?.customProductName, 32, "...") ?? trimToLength(device?.model_id, 32, "...") ?? trimToLength(device?.model, 32, "..."),
+      productName: trimToLength(mapping?.customProductName, 32, "...") ?? productNameFromNodeLabel ?? trimToLength(device?.model_id, 32, "...") ?? trimToLength(device?.model, 32, "..."),
       productLabel: trimToLength(device?.model, 64, "..."),
-      nodeLabel: trimToLength(mapping?.customName, 32, "...") ?? trimToLength(friendlyName, 32, "...") ?? trimToLength(entityId, 32, "..."),
+      nodeLabel,
       serialNumber: trimToLength(mapping?.customSerialNumber, 32, "..."),
       hardwareVersionString: trimToLength(device?.hw_version, 64, "..."),
       softwareVersionString: trimToLength(device?.sw_version, 64, "...")
@@ -168067,20 +168077,22 @@ var BasicInformationServer2 = class extends BridgedDeviceBasicInformationServer
     if (!entity.state || !entity.state.attributes) {
       return;
     }
-    const { basicInformation } = this.env.get(BridgeDataProvider);
+    const { basicInformation, featureFlags } = this.env.get(BridgeDataProvider);
     const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
     const device = entity.deviceRegistry;
     const mapping = homeAssistant.state.mapping;
+    const nodeLabel = ellipse(32, homeAssistant.state.customName) ?? ellipse(32, entity.state?.attributes?.friendly_name) ?? ellipse(32, entity.entity_id);
+    const productNameFromNodeLabel = featureFlags?.productNameFromNodeLabel === true ? nodeLabel : void 0;
     applyPatchState(this.state, {
       vendorId: VendorId(basicInformation.vendorId),
       vendorName: ellipse(32, mapping?.customVendorName) ?? ellipse(32, device?.manufacturer) ?? hash(32, basicInformation.vendorName),
-      productName: ellipse(32, mapping?.customProductName) ?? ellipse(32, device?.model_id) ?? ellipse(32, device?.model) ?? hash(32, basicInformation.productName),
+      productName: ellipse(32, mapping?.customProductName) ?? productNameFromNodeLabel ?? ellipse(32, device?.model_id) ?? ellipse(32, device?.model) ?? hash(32, basicInformation.productName),
       productLabel: ellipse(64, device?.model) ?? hash(64, basicInformation.productLabel),
       hardwareVersion: basicInformation.hardwareVersion,
       softwareVersion: basicInformation.softwareVersion,
       hardwareVersionString: ellipse(64, device?.hw_version),
       softwareVersionString: ellipse(64, device?.sw_version),
-      nodeLabel: ellipse(32, homeAssistant.state.customName) ?? ellipse(32, entity.state?.attributes?.friendly_name) ?? ellipse(32, entity.entity_id),
+      nodeLabel,
       reachable: entity.state?.state != null && entity.state.state !== "unavailable",
       serialNumber: ellipse(32, mapping?.customSerialNumber) ?? hash(32, entity.entity_id),
       // UniqueId helps controllers (especially Alexa) identify devices across