feat: Add API endpoint error handling

- Enhance error handling and add region endpoint in config flow.
- Add new error messages for DTEK and Yasno API connection issues.
- Proper no_accounts_found error usage

Author: ALERTua

custom_components/svitlo_yeah/config_flow.py

@@ -18,7 +18,7 @@
 
 from .api.dtek.json import DtekAPIJson
 from .api.e_svitlo import ESvitloClient
-from .api.yasno import YasnoApi
+from .api.yasno import YASNO_REGIONS_ENDPOINT, YasnoApi
 from .const import (
     CONF_ACCOUNT_ID,
     CONF_ADDRESS_STR,
@@ -41,6 +41,8 @@
 )
 
 if TYPE_CHECKING:
+    from collections.abc import Mapping
+
     from .models import YasnoRegion
 
 
@@ -157,6 +159,8 @@ async def async_step_group(
         provider_type = self.data[CONF_PROVIDER_TYPE]
 
         groups = []
+        errors: dict[str, str] | None = None
+        description_placeholders: Mapping[str, str] | None = None
         if provider_type == PROVIDER_TYPE_YASNO:
             if region_id and provider_id:
                 temp_api = YasnoApi(
@@ -165,12 +169,29 @@ async def async_step_group(
                 )
                 await temp_api.fetch_planned_outage_data()
                 groups = temp_api.get_yasno_groups()
+                if not groups:
+                    description_placeholders = {"url": YASNO_REGIONS_ENDPOINT}
+                    # noinspection PyTypeChecker
+                    return self.async_abort(
+                        reason="yasno_connection_error",
+                        description_placeholders=description_placeholders,
+                    )
+
         elif provider_type == PROVIDER_TYPE_DTEK_JSON and provider_id:
             urls = DTEK_PROVIDER_URLS.get(provider_id, [])
             if urls:
                 temp_api = DtekAPIJson(urls=urls, group=None)
                 await temp_api.fetch_data()
                 groups = temp_api.get_dtek_region_groups()
+                if not groups:
+                    description_placeholders = {
+                        "urls": urls[0] if len(urls) == 1 else urls
+                    }  # ty:ignore[invalid-assignment]
+                    # noinspection PyTypeChecker
+                    return self.async_abort(
+                        reason="dtek_json_empty_data",
+                        description_placeholders=description_placeholders,
+                    )
 
         data_schema = vol.Schema(
             {
@@ -186,7 +207,12 @@ async def async_step_group(
             },
         )
         # noinspection PyTypeChecker
-        return self.async_show_form(step_id="group", data_schema=data_schema)
+        return self.async_show_form(
+            step_id="group",
+            data_schema=data_schema,
+            errors=errors,
+            description_placeholders=description_placeholders,
+        )
 
     async def async_step_esvitlo_auth(
         self, user_input: dict | None = None

custom_components/svitlo_yeah/translations/en.json

@@ -2,7 +2,10 @@
   "title": "Svitlo Yeah!",
   "config": {
     "abort": {
-      "dtek_scraping_fail": "Error accessing the DTEK website\nIf you are sure the site is working, the reason is the site's protection against data collection (anti-bot system Incapsula Imperva).\nCollecting data on DTEK outages is a complex process because the site uses an anti-bot system.\nI can try to bypass the anti-bot system only through third-party specialized services.\nSuch a service costs about 2.5 EUR for 1000 requests (for example https://hypersolutions.co/pricing).\nIf the page on my cache server updates every 30 minutes, the maximum cost will be about ~2.5 EUR for ~20 days.\nOne obtained cookie can possibly be used multiple times, so the real cost may be lower (or significantly lower).\nIf someone is interested in this, I could implement everything myself, I just need the API key of the appropriate service.\nTelegram @ALERTua"
+      "no_accounts_found": "No accounts found",
+      "dtek_scraping_fail": "Error accessing the DTEK website\nIf you are sure the site is working, the reason is the site's protection against data collection (anti-bot system Incapsula Imperva).\nCollecting data on DTEK outages is a complex process because the site uses an anti-bot system.\nI can try to bypass the anti-bot system only through third-party specialized services.\nSuch a service costs about 2.5 EUR for 1000 requests (for example https://hypersolutions.co/pricing).\nIf the page on my cache server updates every 30 minutes, the maximum cost will be about ~2.5 EUR for ~20 days.\nOne obtained cookie can possibly be used multiple times, so the real cost may be lower (or significantly lower).\nIf someone is interested in this, I could implement everything myself, I just need the API key of the appropriate service.\nTelegram @ALERTua",
+      "yasno_connection_error": "Failed to fetch Yasno groups.\nPlease check your connection to Yasno API.\n{url}",
+      "dtek_json_empty_data": "Failed to fetch groups.\nPlease check your connection to the data source.\n`fact.data` field should exist and not be empty.\nThis can happen if there are no scheduled outages for today.\nPlease try to add the integration configuration later when the source contains the schedule data.\n{urls}"
     },
     "step": {
       "user": {
@@ -41,8 +44,7 @@
       }
     },
     "error": {
-      "invalid_auth": "Invalid username or password",
-      "no_accounts_found": "No accounts found"
+      "invalid_auth": "Invalid username or password"
     }
   },
   "device": {

custom_components/svitlo_yeah/translations/uk.json

@@ -2,7 +2,10 @@
   "title": "Svitlo Yeah!",
   "config": {
     "abort": {
-      "dtek_scraping_fail": "Помилка запиту на сайт ДТЕК\nЯкщо ви певні, що сайт працює, то причина в захисті сайту від збору даних (анти-бот система Incapsula Imperva).\nЗбір даних про відключення ДТЕК є складним процесом, оскільки сайт використовує антибот систему.\nЯ можу спробувати обійти антибот систему лише за допомогою сторонніх спеціалізованих сервісів.\nТакий сервіс коштує близько 2.5 EUR за 1000 запитів (наприклад https://hypersolutions.co/pricing).\nЯкщо сторінка на моєму кешу-сервері оновлюватиметься кожні 30 хвилин, максимальна вартість становитиме ~2.5 EUR за ~20 днів.\nОдин отриманий cookie можливо можна буде використовувати кілька разів, тому реальна вартість може бути нижчою (або значно нижчою).\nЯкщо хтось зацікавлений у цьому, я міг би реалізувати все це самостійно, мені потрібен лише API ключ відповідного сервісу.\nТелеграм @ALERTua"
+      "no_accounts_found": "Не знайдено особових рахунків",
+      "dtek_scraping_fail": "Помилка запиту на сайт ДТЕК\nЯкщо ви певні, що сайт працює, то причина в захисті сайту від збору даних (анти-бот система Incapsula Imperva).\nЗбір даних про відключення ДТЕК є складним процесом, оскільки сайт використовує антибот систему.\nЯ можу спробувати обійти антибот систему лише за допомогою сторонніх спеціалізованих сервісів.\nТакий сервіс коштує близько 2.5 EUR за 1000 запитів (наприклад https://hypersolutions.co/pricing).\nЯкщо сторінка на моєму кешу-сервері оновлюватиметься кожні 30 хвилин, максимальна вартість становитиме ~2.5 EUR за ~20 днів.\nОдин отриманий cookie можливо можна буде використовувати кілька разів, тому реальна вартість може бути нижчою (або значно нижчою).\nЯкщо хтось зацікавлений у цьому, я міг би реалізувати все це самостійно, мені потрібен лише API ключ відповідного сервісу.\nТелеграм @ALERTua",
+      "yasno_connection_error": "Не вдалося отримати групи Yasno.\nПеревірте з'єднання з API Yasno.\n{url}",
+      "dtek_json_empty_data": "Не вдалося отримати групи.\nПеревірте з'єднання з джерелом даних.\nПоле `fact.data` повинно існувати та не бути порожнім.\nЦе може статися, якщо на сьогодні графіку відключень ще немає.\nСпробуйте додати конфігурацію інтеграції пізніше, коли джерело міститиме графік відключень.\n{urls}"
     },
     "step": {
       "user": {
@@ -41,8 +44,7 @@
       }
     },
     "error": {
-      "invalid_auth": "Неправильне ім'я користувача або пароль",
-      "no_accounts_found": "Не знайдено особових рахунків"
+      "invalid_auth": "Неправильне ім'я користувача або пароль"
     }
   },
   "device": {