"""Compound trigger — combines multiple trigger conditions with AND/OR logic.""" from __future__ import annotations import logging from typing import TYPE_CHECKING, Any from homeassistant.core import HomeAssistant, callback if TYPE_CHECKING: from ...coordinator import MaintenanceCoordinator from ...sensor import MaintenanceSensor from ...const import ( CONF_COMPOUND_CONDITIONS, CONF_COMPOUND_LOGIC, EVENT_TRIGGER_ACTIVATED, EVENT_TRIGGER_DEACTIVATED, ) from .base_trigger import BaseTrigger _LOGGER = logging.getLogger(__name__) class CompoundSubEntity: """Proxy entity for a single compound condition. Each condition creates its own sub-triggers that call back into this proxy. The proxy aggregates per-entity states within the condition (using the condition's ``entity_logic``), then notifies the parent ``CompoundTrigger`` of the condition-level result. """ def __init__( self, parent: CompoundTrigger, condition_idx: int, condition_config: dict[str, Any], ) -> None: """Initialize the sub-entity proxy.""" self._parent = parent self._condition_idx = condition_idx self._condition_config = condition_config # Pre-seed a MULTI-entity condition with every entity at False, so # `entity_logic == "all"` quantifies over EVERY entity, not just the ones # that have already transitioned (an entity that never toggles must keep # the AND from firing). Single-entity conditions stay empty and use the # is_triggered fallback in async_update_trigger_state. (H1) _eids = condition_config.get("entity_ids") or [] self._per_entity_states: dict[str, bool] = {eid: False for eid in _eids} if len(_eids) > 1 else {} self._per_entity_values: dict[str, float | None] = {} self._entity_logic = condition_config.get("entity_logic", "any") # Mirror attributes the real entity exposes for trigger access self.entity_id = parent.entity.entity_id self._task_id = parent.entity._task_id self.coordinator = parent.entity.coordinator @callback def async_update_trigger_state( self, is_triggered: bool, current_value: float | None = None, trigger_entity_id: str | None = None, ) -> None: """Receive trigger state from a sub-trigger.""" if trigger_entity_id is not None: self._per_entity_states[trigger_entity_id] = is_triggered if current_value is not None: self._per_entity_values[trigger_entity_id] = current_value # Aggregate within this condition if not self._per_entity_states: aggregated = is_triggered elif self._entity_logic == "all": aggregated = bool(self._per_entity_states) and all(self._per_entity_states.values()) else: # "any" aggregated = any(self._per_entity_states.values()) self._parent._on_condition_changed(self._condition_idx, aggregated) @callback def async_write_ha_state(self) -> None: """No-op — the compound trigger manages state through the real entity.""" class _CompoundCoordinatorProxy: """Proxy coordinator that routes persistence to the correct condition index. Wraps the real coordinator so that ``async_persist_trigger_runtime`` stores data under ``_trigger_state.conditions[idx][entity_id]``. """ def __init__(self, real_coordinator: MaintenanceCoordinator, condition_idx: int) -> None: """Initialize the proxy.""" self._real = real_coordinator self._condition_idx = condition_idx def __getattr__(self, name: str) -> Any: """Delegate all other attributes to the real coordinator.""" return getattr(self._real, name) async def async_persist_trigger_runtime( self, task_id: str, runtime_data: dict[str, Any], entity_id: str | None = None, *, immediate: bool = False, ) -> None: """Persist under trigger_runtime as a per-condition compound key. The real coordinator always has a Store; merge_task_data reshapes these ``_compound_[_]`` keys back into ``_trigger_state["conditions"][idx]`` on read. """ store = self._real._store compound_key = f"_compound_{self._condition_idx}" if entity_id is not None: compound_key = f"_compound_{self._condition_idx}_{entity_id}" store.set_trigger_runtime(task_id, compound_key, runtime_data) if immediate: await store.async_save() else: store.async_delay_save() class CompoundTrigger(BaseTrigger): """Compound trigger that combines multiple conditions with AND/OR logic. Two-level aggregation: 1. Within each condition: multi-entity ``entity_logic`` (any/all) 2. Across conditions: ``compound_logic`` (AND/OR) """ def __init__( self, hass: HomeAssistant, entity: MaintenanceSensor, trigger_config: dict[str, Any], ) -> None: """Initialize the compound trigger.""" # BaseTrigger expects entity_id; compound has no single monitored entity config_with_id = dict(trigger_config) config_with_id.setdefault("entity_id", "") super().__init__(hass, entity, config_with_id) # `or "AND"` (not just the .get default) so a present-but-null value in # hand-edited config doesn't crash on .upper(). self._compound_logic: str = (trigger_config.get(CONF_COMPOUND_LOGIC) or "AND").upper() self._conditions: list[dict[str, Any]] = trigger_config.get(CONF_COMPOUND_CONDITIONS) or [] self._condition_states: list[bool] = [False] * len(self._conditions) self._sub_triggers: list[list[BaseTrigger]] = [] self._sub_entities: list[CompoundSubEntity] = [] @property def condition_states(self) -> list[bool]: """Return the current state of each condition.""" return list(self._condition_states) async def async_setup(self) -> None: """Set up all sub-triggers for each condition.""" from . import create_triggers trigger_state = self.config.get("_trigger_state", {}) conditions_state = trigger_state.get("conditions", []) for idx, condition in enumerate(self._conditions): sub_entity = CompoundSubEntity(self, idx, condition) self._sub_entities.append(sub_entity) # Build per-condition config with its persisted state cond_config = dict(condition) if idx < len(conditions_state): cond_state = conditions_state[idx] if cond_state: cond_config["_trigger_state"] = cond_state # Wrap the real coordinator with a proxy for persistence proxy_coordinator = _CompoundCoordinatorProxy(self._coordinator, idx) sub_entity.coordinator = proxy_coordinator # type: ignore[assignment] sub_triggers = create_triggers(self.hass, sub_entity, cond_config) # type: ignore[arg-type] self._sub_triggers.append(sub_triggers) for trigger in sub_triggers: await trigger.async_setup() _LOGGER.debug( "Compound trigger setup: %d conditions with %s logic for %s", len(self._conditions), self._compound_logic, self.entity.entity_id, ) async def async_teardown(self) -> None: """Tear down all sub-triggers.""" for trigger_list in self._sub_triggers: for trigger in trigger_list: await trigger.async_teardown() self._sub_triggers = [] self._sub_entities = [] self._condition_states = [False] * len(self._conditions) await super().async_teardown() def evaluate(self, value: float) -> bool: """Evaluate compound condition (aggregation of condition states).""" if self._compound_logic == "AND": return bool(self._condition_states) and all(self._condition_states) return any(self._condition_states) # OR def reset(self) -> None: """Reset all sub-triggers.""" super().reset() self._condition_states = [False] * len(self._conditions) for trigger_list in self._sub_triggers: for trigger in trigger_list: trigger.reset() @callback def _on_condition_changed(self, condition_idx: int, is_triggered: bool) -> None: """Handle a condition state change and re-aggregate.""" self._condition_states[condition_idx] = is_triggered was_triggered = self._triggered if self._compound_logic == "AND": now_triggered = bool(self._condition_states) and all(self._condition_states) else: # OR now_triggered = any(self._condition_states) self._triggered = now_triggered if now_triggered and not was_triggered: self._on_trigger_activated(0.0) elif not now_triggered and was_triggered: self._on_trigger_deactivated(0.0) def _on_trigger_activated(self, value: float) -> None: """Handle compound trigger activation.""" _LOGGER.info( "Compound trigger activated: %s (conditions: %s, logic: %s)", self.entity.entity_id, self._condition_states, self._compound_logic, ) self.entity.async_update_trigger_state( is_triggered=True, current_value=None, trigger_entity_id=None, ) self.hass.async_create_task(self._coordinator.async_add_trigger_history_entry(self._task_id, trigger_value=None)) self.hass.bus.async_fire( EVENT_TRIGGER_ACTIVATED, { "entity_id": self.entity.entity_id, "trigger_type": "compound", "compound_logic": self._compound_logic, "condition_states": list(self._condition_states), }, ) def _on_trigger_deactivated(self, value: float) -> None: """Handle compound trigger deactivation.""" _LOGGER.info( "Compound trigger deactivated: %s (conditions: %s, logic: %s)", self.entity.entity_id, self._condition_states, self._compound_logic, ) self.entity.async_update_trigger_state( is_triggered=False, current_value=None, trigger_entity_id=None, ) self.hass.bus.async_fire( EVENT_TRIGGER_DEACTIVATED, { "entity_id": self.entity.entity_id, "trigger_type": "compound", "compound_logic": self._compound_logic, "condition_states": list(self._condition_states), }, )