All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
4.4.2 - 2026-02-11
- Fix options flow handler crash caused by
config_entryproperty conflict — theUnifiNetworkRulesOptionsFlowHandlerconstructor attempted to assign to a read-only property, raisingAttributeErrorduring integration configuration (#144) — Fix component input validation and edge‑case handling in state updates
⚠️ Gotcha: The options flow handler definedconfig_entryas a@propertybut the__init__method tried to assign to it directly. This caused a 500 error when users opened the integration's options in the UI. The fix simplifies the handler by removing the constructor entirely and relying on the base class's built-inconfig_entryaccess.
4.4.1 - 2026-01-28
- Improve switch toggle reliability with per-entity debouncing to prevent race conditions from rapid toggles (#142)
- Add 0.5s debounce delay per switch entity — only the final desired state is submitted to the UDM API
- Resolve race conditions where concurrent toggle operations could leave switches in an inconsistent state
- Refactor toggle operation to use
asyncio.TimerHandlefor debounce scheduling instead of immediate API calls - Improve logging for debounced toggle operations to aid debugging
4.4.0 - 2025-12-29
- Resolve optimistic state timing issue where UI state could flash back to the previous value before the API confirmed the change (#139)
- Add HA-initiated operation timeout to prevent state management race conditions between optimistic updates and coordinator refreshes
- Code formatting and linting improvements across coordination modules
- Add CI/CD workflows for linting and testing via Makefile
4.3.0 - 2025-11-18
- Object Oriented Networking (OON) policy support — manage UniFi OON policies as switch entities (#132)
- New
switches/oon_policy.pymodule with dedicated switch implementation - New
udm/oon.pyAPI module for OON policy CRUD operations - New
models/oon_policy.pydata model - Test coverage for OON policy entities
4.2.0 - 2025-09-30
- NAT rules support — manage UniFi NAT/port translation rules as switch entities (#125)
- New
udm/nat.pyAPI module for NAT rule operations - New
models/nat_rule.pydata model - Test coverage for NAT rule entities
- Major refactor of coordinator into modular architecture — split monolithic coordinator into
coordination/subpackage with dedicated modules for auth management, data fetching, entity management, and state management - Major refactor of switch entities into
switches/subpackage with per-rule-type modules and a shared base class - Improve change detection to support NAT rules and additional entity properties
4.1.0 - 2025-09-23
- Static routes support — manage UniFi static routes as switch entities
- New
udm/routes.pyAPI module for static route operations - New
models/static_route.pydata model - Test coverage for static route entities
- Enhance trigger migration and template update functionality for v4.0.0 compatibility
- Simplify automation file download instructions
- Update migration utility and documentation for v4.0.0
4.0.0 - 2025-09-18
- Smart Polling system for efficient UDM API communication
- Unified Trigger system replacing per-rule-type triggers
- Port profile switch entities (#100)
- Expanded service capabilities for rule management
- Multi-language translations (DE, ES, FR, IT, NL, PT-BR, RU)
- Complete integration architecture overhaul
- Minimum Home Assistant version raised to 2025.8.0