@riddix/hamh 2.1.0-alpha.841 → 2.1.0-alpha.843

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.51 | 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,20 @@ 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.51)</strong> - Click to expand</summary>
 
-**New in v2.0.50:**
+**New 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 +266,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.51).** All alpha work up to the latest pre-release has been promoted into v2.0.51. New alpha work continues from the next pre-release tag onward and will appear here as development progresses.
 
 </details>
 

package/dist/backend/cli.js

@@ -136622,6 +136622,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 +136645,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 +136693,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 });
@@ -163276,6 +163274,15 @@ function clearPendingTilt(st) {
   st.pendingTilt = null;
 }
 var coverOptimistic = /* @__PURE__ */ new WeakMap();
+function haRestEnd(action) {
+  if (action.action.includes("open_cover")) {
+    return "open";
+  }
+  if (action.action.includes("close_cover")) {
+    return "close";
+  }
+  return null;
+}
 function getCoverOptimistic(endpoint) {
   let st = coverOptimistic.get(endpoint);
   if (!st) {
@@ -163390,7 +163397,10 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
       if (!entry) {
         return MovementStatus.Stopped;
       }
-      const reachedTarget = positionAware && current100ths != null && existingTarget != null && Math.abs(current100ths - existingTarget) < 100;
+      const getExpected = config11.getExpectedRestPosition;
+      const expectedPercent = entry.expectedRestEnd != null && getExpected != null ? getExpected(entry.expectedRestEnd, this.agent) : null;
+      const goal = expectedPercent != null ? expectedPercent * 100 : existingTarget;
+      const reachedTarget = positionAware && current100ths != null && goal != null && Math.abs(current100ths - goal) < 100;
       const expired = Date.now() - entry.startedAt >= optimisticMovementTimeoutMs;
       if (reachedTarget || expired) {
         clearOptimisticAxis(optimistic, axis);
@@ -163495,7 +163505,7 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
   }
   // Record the optimistic direction and emit it now so a controller gets the
   // moving->stopped edge even when HA never reports a transitional state (#429).
-  startOptimisticMovement(axis, status3) {
+  startOptimisticMovement(axis, status3, expectedRestEnd) {
     const optimistic = getCoverOptimistic(this.endpoint);
     clearOptimisticAxis(optimistic, axis);
     const endpoint = this.endpoint;
@@ -163540,7 +163550,7 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
       })();
     }, optimisticMovementTimeoutMs);
     timer.unref?.();
-    optimistic[axis] = { status: status3, startedAt, timer };
+    optimistic[axis] = { status: status3, startedAt, timer, expectedRestEnd };
     this.writeOperationalStatus({ [axis]: status3 });
   }
   async handleMovement(type, _, direction, targetPercent100ths) {
@@ -163599,17 +163609,25 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
   }
   handleLiftOpen() {
     clearPendingLift(getCoverDebounce(this.endpoint));
-    this.startOptimisticMovement("lift", MovementStatus.Opening);
     const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
     const action = this.state.config.openCoverLift(void 0, this.agent);
+    this.startOptimisticMovement(
+      "lift",
+      MovementStatus.Opening,
+      haRestEnd(action)
+    );
     logger218.info(`handleLiftOpen: calling action=${action.action}`);
     homeAssistant.callAction(action);
   }
   handleLiftClose() {
     clearPendingLift(getCoverDebounce(this.endpoint));
-    this.startOptimisticMovement("lift", MovementStatus.Closing);
     const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
     const action = this.state.config.closeCoverLift(void 0, this.agent);
+    this.startOptimisticMovement(
+      "lift",
+      MovementStatus.Closing,
+      haRestEnd(action)
+    );
     logger218.info(`handleLiftClose: calling action=${action.action}`);
     homeAssistant.callAction(action);
   }
@@ -163620,14 +163638,15 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
       return;
     }
     this.state.targetPositionLiftPercent100ths = targetPercent100ths;
-    this.startOptimisticMovement(
-      "lift",
-      currentPositionMatter != null && targetPercent100ths < currentPositionMatter ? MovementStatus.Opening : MovementStatus.Closing
-    );
     const targetPosition = targetPercent100ths / 100;
     const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
     const action = config11.setLiftPosition(targetPosition, this.agent);
     const entityId = homeAssistant.entityId;
+    this.startOptimisticMovement(
+      "lift",
+      currentPositionMatter != null && targetPercent100ths < currentPositionMatter ? MovementStatus.Opening : MovementStatus.Closing,
+      haRestEnd(action)
+    );
     const actions = this.env.get(HomeAssistantActions);
     const st = getCoverDebounce(this.endpoint);
     st.pendingLift = { action, entityId, actions };
@@ -163660,21 +163679,27 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
     const st = getCoverDebounce(this.endpoint);
     clearPendingTilt(st);
     if (st.pendingLift?.action.action.includes("tilt")) clearPendingLift(st);
-    this.startOptimisticMovement("tilt", MovementStatus.Opening);
-    const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
-    homeAssistant.callAction(
-      this.state.config.openCoverTilt(void 0, this.agent)
+    const action = this.state.config.openCoverTilt(void 0, this.agent);
+    this.startOptimisticMovement(
+      "tilt",
+      MovementStatus.Opening,
+      haRestEnd(action)
     );
+    const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
+    homeAssistant.callAction(action);
   }
   handleTiltClose() {
     const st = getCoverDebounce(this.endpoint);
     clearPendingTilt(st);
     if (st.pendingLift?.action.action.includes("tilt")) clearPendingLift(st);
-    this.startOptimisticMovement("tilt", MovementStatus.Closing);
-    const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
-    homeAssistant.callAction(
-      this.state.config.closeCoverTilt(void 0, this.agent)
+    const action = this.state.config.closeCoverTilt(void 0, this.agent);
+    this.startOptimisticMovement(
+      "tilt",
+      MovementStatus.Closing,
+      haRestEnd(action)
     );
+    const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
+    homeAssistant.callAction(action);
   }
   handleGoToTiltPosition(targetPercent100ths) {
     const config11 = this.state.config;
@@ -163683,14 +163708,15 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
       return;
     }
     this.state.targetPositionTiltPercent100ths = targetPercent100ths;
-    this.startOptimisticMovement(
-      "tilt",
-      currentPositionMatter != null && targetPercent100ths < currentPositionMatter ? MovementStatus.Opening : MovementStatus.Closing
-    );
     const targetPosition = targetPercent100ths / 100;
     const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
     const action = config11.setTiltPosition(targetPosition, this.agent);
     const entityId = homeAssistant.entityId;
+    this.startOptimisticMovement(
+      "tilt",
+      currentPositionMatter != null && targetPercent100ths < currentPositionMatter ? MovementStatus.Opening : MovementStatus.Closing,
+      haRestEnd(action)
+    );
     const actions = this.env.get(HomeAssistantActions);
     const st = getCoverDebounce(this.endpoint);
     st.pendingTilt = { action, entityId, actions };
@@ -163832,6 +163858,7 @@ var adjustPositionForWriting2 = (position, agent) => {
   const matterSem = usesMatterSemantics(agent);
   return adjustPositionForWriting(position, featureFlags, matterSem);
 };
+var expectedRestPosition = (end, agent) => adjustPositionForReading2(end === "open" ? 100 : 0, agent);
 var shouldSwapOpenClose = (agent) => {
   const homeAssistant = agent.get(HomeAssistantEntityBehavior);
   const entitySwap = homeAssistant.state.mapping?.coverSwapOpenClose;
@@ -163919,11 +163946,11 @@ var config6 = {
     }
     return position == null ? null : adjustPositionForReading2(position, agent);
   },
+  getExpectedRestPosition: expectedRestPosition,
   getCoverType: (entity) => deviceClassMapping(entity)?.type,
   getEndProductType: (entity) => deviceClassMapping(entity)?.endProductType,
   getMovementStatus: (entity, agent) => {
-    const { featureFlags } = agent.env.get(BridgeDataProvider);
-    const swapped = featureFlags?.coverSwapOpenClose === true;
+    const swapped = shouldSwapOpenClose(agent);
     const coverState = entity.state;
     if (coverState === CoverDeviceState.opening) {
       return swapped ? WindowCovering3.MovementStatus.Closing : WindowCovering3.MovementStatus.Opening;