Enhance API operation queue with retry logic and device LED control

This update introduces a robust retry mechanism for API operations, allowing failed operations to be retried with exponential backoff. A new `QueuedOperation` class encapsulates operation metadata and retry logic. Additionally, the `ApiOperationQueue` now supports a retry queue for managing failed operations.

Furthermore, the LED toggle functionality has been extended to support various UniFi devices, allowing for LED state management through the queue system. This includes special handling for device LED toggles and updates to the `UnifiLedToggleSwitch` class to inherit resilient patterns from the base switch class.

Key changes:
- Added `QueuedOperation` class for managing queued operations with retries.
- Enhanced `ApiOperationQueue` to include retry logic and queue management.
- Updated LED toggle handling for devices in `switch.py` and `rule.py`.

This improves the integration's reliability and flexibility across a wider range of UniFi hardware.

Author: sirkirby

custom_components/unifi_network_rules/helpers/rule.py

@@ -10,6 +10,7 @@
 from aiounifi.models.port_forward import PortForward
 from aiounifi.models.firewall_zone import FirewallZone
 from aiounifi.models.wlan import Wlan
+from aiounifi.models.device import Device
 
 # Import our custom models
 from ..models.firewall_rule import FirewallRule
@@ -35,6 +36,16 @@ def get_rule_enabled(rule: Any) -> bool:
     if isinstance(rule, (PortForward, TrafficRoute, FirewallPolicy, TrafficRule, Wlan, QoSRule, VPNConfig)):
         return getattr(rule, "enabled", False)
 
+    # Special handling for Device LED state
+    if isinstance(rule, Device):
+        # For devices, "enabled" means LED is not overridden (default state)
+        # When led_override is "default", the LED follows normal behavior (enabled)
+        # When led_override is "off", the LED is disabled
+        if hasattr(rule, 'raw') and 'led_override' in rule.raw:
+            led_state = rule.raw.get('led_override')
+            return led_state != 'off'  # True if not explicitly turned off
+        return True  # Default to enabled if no override info
+    
     # For dictionaries, try common enabled attributes
     if isinstance(rule, dict):
         return rule.get("enabled", False)
@@ -63,6 +74,7 @@ def get_rule_id(rule: Any) -> str | None:
     Examples: 
         - unr_policy_123456
         - unr_route_abcdef
+        - unr_device_abc123_led
     """
     # Access different rule types and return appropriate ID with type prefix
     if isinstance(rule, PortForward):
@@ -134,6 +146,14 @@ def get_rule_id(rule: Any) -> str | None:
             LOGGER.warning("VPNConfig without id: %s", rule)
             return None
 
+    # Handle Device objects for LED switches
+    if isinstance(rule, Device):
+        if hasattr(rule, 'mac') and rule.mac:
+            return f"unr_device_{rule.mac}_led"
+        else:
+            LOGGER.warning("Device without mac attribute: %s", rule)
+            return None
+    
     # Dictionary fallback - this should not happen with properly typed data
     if isinstance(rule, dict):
         _id = rule.get("_id") or rule.get("id")
@@ -165,7 +185,8 @@ def get_rule_prefix(rule_type: str) -> str:
         "traffic_rules": "Traffic Rule",
         "legacy_firewall_rules": "Legacy Rule",
         "qos_rules": "QoS",
-        "wlans": "WLAN"
+        "wlans": "WLAN",
+        "devices": "Device"
     }
 
     return rule_types.get(rule_type, "Rule")
@@ -312,6 +333,16 @@ def extract_descriptive_name(rule: Any, coordinator=None) -> str | None:
 
         return None
 
+    elif isinstance(rule, Device):
+        # For devices, return the device name for LED switches
+        if hasattr(rule, 'name') and rule.name:
+            return f"{rule.name}"
+        elif hasattr(rule, 'raw') and 'name' in rule.raw:
+            return f"{rule.raw['name']}"
+        elif hasattr(rule, 'mac') and rule.mac:
+            return f"Device {rule.mac}"
+        return "Device"
+        
     elif isinstance(rule, dict):
         # For dictionaries, try common name attributes
         return rule.get("name") or rule.get("description")
@@ -341,6 +372,8 @@ def get_rule_name(rule: Any, coordinator=None) -> str | None:
         rule_type = "wlans"
     elif isinstance(rule, QoSRule):
         rule_type = "qos_rules"
+    elif isinstance(rule, Device):
+        rule_type = "devices"
     elif isinstance(rule, dict) and "type" in rule:
         rule_type = rule.get("type")