Improve backoff retry configuration (#1993)

## Summary
- Add `__all__` and re-exports to package `__init__.py` for cleaner
public API
- Add `max_time` and `jitter` to all backoff retry decorators for more
resilient retry behavior

## Test plan
- [ ] Existing tests pass
- [ ] Public API exports are importable from `pyoverkiz`
- [ ] Retry behavior works with new max_time/jitter settings

Author: iMicknl

pyoverkiz/client.py

@@ -76,11 +76,13 @@ async def refresh_listener(invocation: Details) -> None:
     await _get_client_from_invocation(invocation).register_event_listener()
 
 
-# Reusable backoff decorators to reduce code duplication
+# Reusable backoff decorators with max_tries and max_time to cap total retry duration.
 retry_on_auth_error = backoff.on_exception(
     backoff.expo,
     (NotAuthenticatedError, ServerDisconnectedError),
     max_tries=2,
+    max_time=60,  # safety net for hung requests
+    jitter=backoff.full_jitter,
     on_backoff=relogin,
     logger=_LOGGER,
 )
@@ -89,27 +91,35 @@ async def refresh_listener(invocation: Details) -> None:
     backoff.expo,
     (TimeoutError, ClientConnectorError),
     max_tries=5,
+    max_time=120,
+    jitter=backoff.full_jitter,
     logger=_LOGGER,
 )
 
 retry_on_concurrent_requests = backoff.on_exception(
     backoff.expo,
     TooManyConcurrentRequestsError,
     max_tries=5,
+    max_time=120,
+    jitter=backoff.full_jitter,
     logger=_LOGGER,
 )
 
 retry_on_too_many_executions = backoff.on_exception(
     backoff.expo,
     TooManyExecutionsError,
-    max_tries=10,
+    max_tries=5,
+    max_time=300,
+    jitter=backoff.full_jitter,
     logger=_LOGGER,
 )
 
 retry_on_listener_error = backoff.on_exception(
     backoff.expo,
     (InvalidEventListenerIdError, NoRegisteredEventListenerError),
     max_tries=2,
+    max_time=30,
+    jitter=backoff.full_jitter,
     on_backoff=refresh_listener,
     logger=_LOGGER,
 )
@@ -118,6 +128,8 @@ async def refresh_listener(invocation: Details) -> None:
     backoff.expo,
     ExecutionQueueFullError,
     max_tries=5,
+    max_time=120,
+    jitter=backoff.full_jitter,
     logger=_LOGGER,
 )