@riddix/hamh 2.1.0-alpha.652 → 2.1.0-alpha.654

package/dist/backend/cli.js

@@ -146819,6 +146819,14 @@ var init_bridge_config_schema = __esm({
           description: "Fall back to the Home Assistant device registry serial_number when no per-entity customSerialNumber is configured. Default off because changing serialNumber after commissioning can confuse controllers. A per-entity customSerialNumber still takes precedence.",
           type: "boolean",
           default: false
+        },
+        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.",
+          type: "number",
+          minimum: 0,
+          maximum: 5e3,
+          default: 0
         }
       }
     };
@@ -147879,6 +147887,7 @@ WARNING: ${includeIdentity ? "This backup contains sensitive Matter identity dat
                     mopIntensityEntity: config10.mopIntensityEntity,
                     valetudoIdentifier: config10.valetudoIdentifier,
                     coverSwapOpenClose: config10.coverSwapOpenClose,
+                    coverSliderDebounceMs: config10.coverSliderDebounceMs,
                     disableClimateOnOff: config10.disableClimateOnOff,
                     disableClimateFanControl: config10.disableClimateFanControl,
                     customServiceAreas: config10.customServiceAreas,
@@ -148026,6 +148035,7 @@ WARNING: ${includeIdentity ? "This backup contains sensitive Matter identity dat
                   temperatureEntity: config10.temperatureEntity,
                   valetudoIdentifier: config10.valetudoIdentifier,
                   coverSwapOpenClose: config10.coverSwapOpenClose,
+                  coverSliderDebounceMs: config10.coverSliderDebounceMs,
                   disableClimateOnOff: config10.disableClimateOnOff,
                   disableClimateFanControl: config10.disableClimateFanControl,
                   customServiceAreas: config10.customServiceAreas,
@@ -148867,6 +148877,7 @@ function entityMappingApi(mappingStorage) {
       currentRoomEntity: body.currentRoomEntity,
       valetudoIdentifier: body.valetudoIdentifier,
       coverSwapOpenClose: body.coverSwapOpenClose,
+      coverSliderDebounceMs: body.coverSliderDebounceMs,
       disableClimateOnOff: body.disableClimateOnOff,
       disableClimateFanControl: body.disableClimateFanControl,
       composedEntities: body.composedEntities
@@ -149332,6 +149343,7 @@ function configToProfileEntry(config10) {
     customFanSpeedTags: config10.customFanSpeedTags,
     valetudoIdentifier: config10.valetudoIdentifier,
     coverSwapOpenClose: config10.coverSwapOpenClose,
+    coverSliderDebounceMs: config10.coverSliderDebounceMs,
     disableClimateOnOff: config10.disableClimateOnOff,
     disableClimateFanControl: config10.disableClimateFanControl
   };
@@ -149455,6 +149467,7 @@ function mappingProfileApi(mappingStorage) {
           customFanSpeedTags: entry.customFanSpeedTags,
           valetudoIdentifier: entry.valetudoIdentifier,
           coverSwapOpenClose: entry.coverSwapOpenClose,
+          coverSliderDebounceMs: entry.coverSliderDebounceMs,
           disableClimateOnOff: entry.disableClimateOnOff,
           disableClimateFanControl: entry.disableClimateFanControl
         });
@@ -153357,11 +153370,12 @@ var EntityMappingStorage = class extends Service {
       currentRoomEntity: request.currentRoomEntity?.trim() || void 0,
       valetudoIdentifier: request.valetudoIdentifier?.trim() || void 0,
       coverSwapOpenClose: request.coverSwapOpenClose || void 0,
+      coverSliderDebounceMs: sanitizeDebounceMs(request.coverSliderDebounceMs),
       disableClimateOnOff: request.disableClimateOnOff || void 0,
       disableClimateFanControl: request.disableClimateFanControl || void 0,
       composedEntities: request.composedEntities?.filter((e) => e.entityId?.trim()) ?? void 0
     };
-    if (!config10.matterDeviceType && !config10.customName && !config10.customProductName && !config10.customVendorName && !config10.customSerialNumber && config10.customVendorId === void 0 && config10.disabled !== true && !config10.filterLifeEntity && !config10.cleaningModeEntity && !config10.temperatureEntity && !config10.humidityEntity && !config10.batteryEntity && !config10.roomEntities && !config10.disableLockPin && !config10.powerEntity && !config10.energyEntity && !config10.pressureEntity && !config10.suctionLevelEntity && !config10.mopIntensityEntity && (!config10.customServiceAreas || config10.customServiceAreas.length === 0) && (!config10.customFanSpeedTags || Object.keys(config10.customFanSpeedTags).length === 0) && !config10.currentRoomEntity && !config10.valetudoIdentifier && !config10.coverSwapOpenClose && !config10.disableClimateOnOff && !config10.disableClimateFanControl && (!config10.composedEntities || config10.composedEntities.length === 0)) {
+    if (!config10.matterDeviceType && !config10.customName && !config10.customProductName && !config10.customVendorName && !config10.customSerialNumber && config10.customVendorId === void 0 && config10.disabled !== true && !config10.filterLifeEntity && !config10.cleaningModeEntity && !config10.temperatureEntity && !config10.humidityEntity && !config10.batteryEntity && !config10.roomEntities && !config10.disableLockPin && !config10.powerEntity && !config10.energyEntity && !config10.pressureEntity && !config10.suctionLevelEntity && !config10.mopIntensityEntity && (!config10.customServiceAreas || config10.customServiceAreas.length === 0) && (!config10.customFanSpeedTags || Object.keys(config10.customFanSpeedTags).length === 0) && !config10.currentRoomEntity && !config10.valetudoIdentifier && !config10.coverSwapOpenClose && !config10.coverSliderDebounceMs && !config10.disableClimateOnOff && !config10.disableClimateFanControl && (!config10.composedEntities || config10.composedEntities.length === 0)) {
       bridgeMap.delete(request.entityId);
     } else {
       bridgeMap.set(request.entityId, config10);
@@ -153391,6 +153405,16 @@ function sanitizeVendorId(value) {
   }
   return n;
 }
+function sanitizeDebounceMs(value) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  const n = typeof value === "string" ? Number(value) : value;
+  if (typeof n !== "number" || !Number.isFinite(n) || n <= 0) {
+    return void 0;
+  }
+  return Math.min(5e3, Math.round(n));
+}
 
 // src/services/storage/lock-credential-storage.ts
 init_service();
@@ -172163,6 +172187,18 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
   static DEBOUNCE_INITIAL_MS = 400;
   static DEBOUNCE_SUBSEQUENT_MS = 150;
   static COMMAND_SEQUENCE_THRESHOLD_MS = 600;
+  // Per-entity override wins over per-bridge flag; both must be > 0 to count.
+  resolveDebounceOverride(homeAssistant) {
+    const fromEntity = homeAssistant.state.mapping?.coverSliderDebounceMs;
+    if (typeof fromEntity === "number" && fromEntity > 0) {
+      return fromEntity;
+    }
+    const fromBridge = this.env.get(BridgeDataProvider).featureFlags?.coverSliderDebounceMs;
+    if (typeof fromBridge === "number" && fromBridge > 0) {
+      return fromBridge;
+    }
+    return null;
+  }
   async [Symbol.asyncDispose]() {
     if (this.liftDebounceTimer) {
       clearTimeout(this.liftDebounceTimer);
@@ -172384,9 +172420,10 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
     const timeSinceLastCommand = now - this.lastLiftCommandTime;
     this.lastLiftCommandTime = now;
     const isFirstInSequence = timeSinceLastCommand > _WindowCoveringServerBase.COMMAND_SEQUENCE_THRESHOLD_MS;
-    const debounceMs = isFirstInSequence ? _WindowCoveringServerBase.DEBOUNCE_INITIAL_MS : _WindowCoveringServerBase.DEBOUNCE_SUBSEQUENT_MS;
+    const overrideMs = this.resolveDebounceOverride(homeAssistant);
+    const debounceMs = overrideMs != null ? overrideMs : isFirstInSequence ? _WindowCoveringServerBase.DEBOUNCE_INITIAL_MS : _WindowCoveringServerBase.DEBOUNCE_SUBSEQUENT_MS;
     logger179.debug(
-      `Lift command: target=${targetPosition}%, debounce=${debounceMs}ms (${isFirstInSequence ? "initial" : "subsequent"})`
+      `Lift command: target=${targetPosition}%, debounce=${debounceMs}ms (${overrideMs != null ? "override" : isFirstInSequence ? "initial" : "subsequent"})`
     );
     if (this.liftDebounceTimer) {
       clearTimeout(this.liftDebounceTimer);
@@ -172433,9 +172470,10 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
     const timeSinceLastCommand = now - this.lastTiltCommandTime;
     this.lastTiltCommandTime = now;
     const isFirstInSequence = timeSinceLastCommand > _WindowCoveringServerBase.COMMAND_SEQUENCE_THRESHOLD_MS;
-    const debounceMs = isFirstInSequence ? _WindowCoveringServerBase.DEBOUNCE_INITIAL_MS : _WindowCoveringServerBase.DEBOUNCE_SUBSEQUENT_MS;
+    const overrideMs = this.resolveDebounceOverride(homeAssistant);
+    const debounceMs = overrideMs != null ? overrideMs : isFirstInSequence ? _WindowCoveringServerBase.DEBOUNCE_INITIAL_MS : _WindowCoveringServerBase.DEBOUNCE_SUBSEQUENT_MS;
     logger179.debug(
-      `Tilt command: target=${targetPosition}%, debounce=${debounceMs}ms (${isFirstInSequence ? "initial" : "subsequent"})`
+      `Tilt command: target=${targetPosition}%, debounce=${debounceMs}ms (${overrideMs != null ? "override" : isFirstInSequence ? "initial" : "subsequent"})`
     );
     if (this.tiltDebounceTimer) {
       clearTimeout(this.tiltDebounceTimer);