Fix

Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com>

CODEOWNERS

@@ -516,6 +516,8 @@ build.json @home-assistant/supervisor
 /tests/components/flo/ @dmulcahey
 /homeassistant/components/flume/ @ChrisMandich @bdraco @jeeftor
 /tests/components/flume/ @ChrisMandich @bdraco @jeeftor
+/homeassistant/components/fluss/ @fluss
+/tests/components/fluss/ @fluss
 /homeassistant/components/flux_led/ @icemanch
 /tests/components/flux_led/ @icemanch
 /homeassistant/components/forecast_solar/ @klaasnicolaas @frenck

homeassistant/components/fluss/__init__.py

@@ -0,0 +1,31 @@
+"""The Fluss+ integration."""
+
+from __future__ import annotations
+
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.const import CONF_API_KEY, Platform
+from homeassistant.core import HomeAssistant
+
+from .coordinator import FlussDataUpdateCoordinator
+
+PLATFORMS: list[Platform] = [Platform.BUTTON]
+
+
+type FlussConfigEntry = ConfigEntry[FlussDataUpdateCoordinator]
+
+
+async def async_setup_entry(
+    hass: HomeAssistant,
+    entry: FlussConfigEntry,
+) -> bool:
+    """Set up Fluss+ from a config entry."""
+    coordinator = FlussDataUpdateCoordinator(hass, entry, entry.data[CONF_API_KEY])
+    await coordinator.async_config_entry_first_refresh()
+    entry.runtime_data = coordinator
+    await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
+    return True
+
+
+async def async_unload_entry(hass: HomeAssistant, entry: FlussConfigEntry) -> bool:
+    """Unload a config entry."""
+    return await hass.config_entries.async_unload_platforms(entry, PLATFORMS)

homeassistant/components/fluss/button.py

@@ -0,0 +1,38 @@
+"""Support for Fluss Devices."""
+
+from homeassistant.components.button import ButtonEntity
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.core import HomeAssistant
+from homeassistant.exceptions import HomeAssistantError
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
+
+from .coordinator import FlussApiClientError, FlussDataUpdateCoordinator
+from .entity import FlussEntity
+
+type FlussConfigEntry = ConfigEntry[FlussDataUpdateCoordinator]
+
+
+async def async_setup_entry(
+    hass: HomeAssistant,
+    entry: FlussConfigEntry,
+    async_add_entities: AddConfigEntryEntitiesCallback,
+) -> None:
+    """Set up the Fluss Devices, filtering out any invalid payloads."""
+    coordinator = entry.runtime_data
+    devices = coordinator.data
+
+    async_add_entities(
+        FlussButton(coordinator, device_id, device)
+        for device_id, device in devices.items()
+    )
+
+
+class FlussButton(FlussEntity, ButtonEntity):
+    """Representation of a Fluss button device."""
+
+    async def async_press(self) -> None:
+        """Handle the button press."""
+        try:
+            await self.coordinator.api.async_trigger_device(self.device_id)
+        except FlussApiClientError as err:
+            raise HomeAssistantError(f"Failed to trigger device: {err}") from err

homeassistant/components/fluss/config_flow.py

@@ -0,0 +1,54 @@
+"""Config flow for Fluss+ integration."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from fluss_api import (
+    FlussApiClient,
+    FlussApiClientAuthenticationError,
+    FlussApiClientCommunicationError,
+)
+import voluptuous as vol
+
+from homeassistant.config_entries import ConfigFlow, ConfigFlowResult
+from homeassistant.const import CONF_API_KEY
+from homeassistant.helpers import config_validation as cv
+from homeassistant.helpers.aiohttp_client import async_get_clientsession
+
+from .const import DOMAIN, LOGGER
+
+STEP_USER_DATA_SCHEMA = vol.Schema({vol.Required(CONF_API_KEY): cv.string})
+
+
+class FlussConfigFlow(ConfigFlow, domain=DOMAIN):
+    """Handle a config flow for Fluss+."""
+
+    async def async_step_user(
+        self, user_input: dict[str, Any] | None = None
+    ) -> ConfigFlowResult:
+        """Handle the initial step."""
+
+        errors: dict[str, str] = {}
+        if user_input is not None:
+            api_key = user_input[CONF_API_KEY]
+            self._async_abort_entries_match({CONF_API_KEY: api_key})
+            try:
+                FlussApiClient(
+                    user_input[CONF_API_KEY], session=async_get_clientsession(self.hass)
+                )
+            except FlussApiClientCommunicationError:
+                errors["base"] = "cannot_connect"
+            except FlussApiClientAuthenticationError:
+                errors["base"] = "invalid_auth"
+            except Exception:  # noqa: BLE001
+                LOGGER.exception("Unexpected exception occurred")
+                errors["base"] = "unknown"
+            if not errors:
+                return self.async_create_entry(
+                    title="My Fluss+ Devices", data=user_input
+                )
+
+        return self.async_show_form(
+            step_id="user", data_schema=STEP_USER_DATA_SCHEMA, errors=errors
+        )

homeassistant/components/fluss/const.py

@@ -0,0 +1,9 @@
+"""Constants for the Fluss+ integration."""
+
+from datetime import timedelta
+import logging
+
+DOMAIN = "fluss"
+LOGGER = logging.getLogger(__name__)
+UPDATE_INTERVAL = 60  # seconds
+UPDATE_INTERVAL_TIMEDELTA = timedelta(seconds=UPDATE_INTERVAL)

homeassistant/components/fluss/coordinator.py

@@ -0,0 +1,50 @@
+"""DataUpdateCoordinator for Fluss+ integration."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from fluss_api import (
+    FlussApiClient,
+    FlussApiClientAuthenticationError,
+    FlussApiClientError,
+)
+
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.core import HomeAssistant
+from homeassistant.exceptions import ConfigEntryAuthFailed
+from homeassistant.helpers.aiohttp_client import async_get_clientsession
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator, UpdateFailed
+from homeassistant.util import slugify
+
+from .const import LOGGER, UPDATE_INTERVAL_TIMEDELTA
+
+type FlussConfigEntry = ConfigEntry[FlussDataUpdateCoordinator]
+
+
+class FlussDataUpdateCoordinator(DataUpdateCoordinator[dict[str, Any]]):
+    """Manages fetching Fluss device data on a schedule."""
+
+    def __init__(
+        self, hass: HomeAssistant, config_entry: FlussConfigEntry, api_key: str
+    ) -> None:
+        """Initialize the coordinator."""
+        self.api = FlussApiClient(api_key, session=async_get_clientsession(hass))
+        super().__init__(
+            hass,
+            LOGGER,
+            name=f"Fluss+ ({slugify(api_key[:8])})",
+            config_entry=config_entry,
+            update_interval=UPDATE_INTERVAL_TIMEDELTA,
+        )
+
+    async def _async_update_data(self) -> dict[str, dict[str, Any]]:
+        """Fetch data from the Fluss API and return as a dictionary keyed by deviceId."""
+        try:
+            devices = await self.api.async_get_devices()
+        except FlussApiClientAuthenticationError as err:
+            raise ConfigEntryAuthFailed(f"Authentication failed: {err}") from err
+        except FlussApiClientError as err:
+            raise UpdateFailed(f"Error fetching Fluss devices: {err}") from err
+
+        return {device["deviceId"]: device for device in devices.get("devices", [])}

homeassistant/components/fluss/entity.py

@@ -0,0 +1,36 @@
+"""Base entities for the Fluss+ integration."""
+
+from homeassistant.helpers.entity import DeviceInfo
+from homeassistant.helpers.update_coordinator import CoordinatorEntity
+
+from .coordinator import FlussDataUpdateCoordinator
+
+
+class FlussEntity(CoordinatorEntity[FlussDataUpdateCoordinator]):
+    """Base class for Fluss entities."""
+
+    _attr_has_entity_name = True
+    _attr_name = None
+
+    def __init__(
+        self,
+        coordinator: FlussDataUpdateCoordinator,
+        device_id: str,
+        device: dict,
+    ) -> None:
+        """Initialize the entity with a device ID and device data."""
+        super().__init__(coordinator)
+        self.device_id = device_id
+        self._device = device
+        self._attr_unique_id = f"{device_id}"
+        self._attr_device_info = DeviceInfo(
+            identifiers={("fluss", device_id)},
+            name=device.get("deviceName"),
+            manufacturer="Fluss",
+            model="Fluss+ Device",
+        )
+
+    @property
+    def device(self) -> dict:
+        """Return the stored device data."""
+        return self._device

homeassistant/components/fluss/manifest.json

@@ -0,0 +1,11 @@
+{
+  "domain": "fluss",
+  "name": "Fluss+",
+  "codeowners": ["@fluss"],
+  "config_flow": true,
+  "documentation": "https://www.home-assistant.io/integrations/fluss",
+  "iot_class": "cloud_polling",
+  "loggers": ["fluss-api"],
+  "quality_scale": "bronze",
+  "requirements": ["fluss-api==0.1.9.17"]
+}

homeassistant/components/fluss/quality_scale.yaml

@@ -0,0 +1,69 @@
+rules:
+  # Bronze
+  action-setup:
+    status: exempt
+    comment: |
+      No actions present
+  appropriate-polling: done
+  brands: done
+  common-modules: done
+  config-flow-test-coverage: done
+  config-flow: done
+  dependency-transparency: done
+  docs-actions: done
+  docs-high-level-description: done
+  docs-installation-instructions: done
+  docs-removal-instructions: done
+  entity-event-setup: done
+  entity-unique-id: done
+  has-entity-name: done
+  runtime-data: done
+  test-before-configure: done
+  test-before-setup: done
+  unique-config-entry: done
+  # Silver
+  action-exceptions: todo
+  config-entry-unloading: done
+  docs-configuration-parameters: done
+  docs-installation-parameters: done
+  integration-owner: done
+  log-when-unavailable: done
+  parallel-updates: todo
+  reauthentication-flow: todo
+  test-coverage: todo
+  # Gold
+  entity-translations: done
+  entity-device-class: done
+  devices: done
+  entity-category: done
+  entity-disabled-by-default:
+    status: exempt
+    comment: |
+      Not needed
+  discovery: todo
+  stale-devices: todo
+  diagnostics: todo
+  exception-translations: todo
+  icon-translations:
+    status: exempt
+    comment: |
+      No icons used
+  reconfiguration-flow: todo
+  dynamic-devices: todo
+  discovery-update-info: todo
+  repair-issues:
+    status: exempt
+    comment: |
+      No issues to repair
+  docs-use-cases: done
+  docs-supported-devices: todo
+  docs-supported-functions: done
+  docs-data-update: todo
+  docs-known-limitations: done
+  docs-troubleshooting: todo
+  docs-examples: todo
+
+  # Platinum
+  async-dependency: done
+  inject-websession: done
+  strict-typing: todo

homeassistant/components/fluss/strings.json

@@ -0,0 +1,20 @@
+{
+  "config": {
+    "step": {
+      "user": {
+        "description": "Your Fluss API key, available in the profile page of the Fluss+ app",
+        "data": {
+          "api_key": "[%key:common::config_flow::data::api_key%]"
+        },
+        "data_description": {
+          "api_key": "The API key found in the profile page of the Fluss+ app."
+        }
+      }
+    },
+    "error": {
+      "cannot_connect": "[%key:common::config_flow::error::cannot_connect%]",
+      "invalid_auth": "[%key:common::config_flow::error::invalid_auth%]",
+      "unknown": "[%key:common::config_flow::error::unknown%]"
+    }
+  }
+}

homeassistant/generated/config_flows.py

@@ -213,6 +213,7 @@ FLOWS = {
         "flipr",
         "flo",
         "flume",
+        "fluss",
         "flux_led",
         "folder_watcher",
         "forecast_solar",

homeassistant/generated/integrations.json

@@ -2062,6 +2062,12 @@
       "config_flow": true,
       "iot_class": "cloud_polling"
     },
+    "fluss": {
+      "name": "Fluss+",
+      "integration_type": "hub",
+      "config_flow": true,
+      "iot_class": "cloud_polling"
+    },
     "flux": {
       "name": "Flux",
       "integration_type": "hub",

requirements_all.txt

@@ -968,6 +968,9 @@ flexit_bacnet==2.2.3
 # homeassistant.components.flipr
 flipr-api==1.6.1
 
+# homeassistant.components.fluss
+fluss-api==0.1.9.17
+
 # homeassistant.components.flux_led
 flux-led==1.2.0
 

requirements_test_all.txt

@@ -844,6 +844,9 @@ flexit_bacnet==2.2.3
 # homeassistant.components.flipr
 flipr-api==1.6.1
 
+# homeassistant.components.fluss
+fluss-api==0.1.9.17
+
 # homeassistant.components.flux_led
 flux-led==1.2.0
 

tests/components/fluss/__init__.py

@@ -0,0 +1,92 @@
+"""Test Script for Fluss+ Initialisation."""
+
+from __future__ import annotations
+
+from unittest.mock import MagicMock, patch
+
+from fluss_api import (
+    FlussApiClient,
+    FlussApiClientAuthenticationError,
+    FlussApiClientCommunicationError,
+    FlussApiClientError,
+)
+import pytest
+
+from homeassistant.components.fluss import PLATFORMS
+from homeassistant.config_entries import ConfigEntryState
+from homeassistant.const import Platform
+from homeassistant.core import HomeAssistant
+from homeassistant.exceptions import ConfigEntryAuthFailed, ConfigEntryNotReady
+
+
+@pytest.mark.parametrize(
+    ("side_effect", "expected_exception"),
+    [
+        (FlussApiClientAuthenticationError, ConfigEntryAuthFailed),
+        (FlussApiClientCommunicationError, ConfigEntryNotReady),
+        (FlussApiClientError, ConfigEntryNotReady),
+    ],
+)
+async def test_async_setup_entry_errors(
+    hass: HomeAssistant,
+    mock_config_entry: MagicMock,
+    side_effect: Exception,
+    expected_exception: type[Exception],
+) -> None:
+    """Test setup errors."""
+    with (
+        patch("fluss_api.FlussApiClient", side_effect=side_effect),
+        pytest.raises(expected_exception),
+    ):
+        await hass.config_entries.async_setup(mock_config_entry.entry_id)
+    assert mock_config_entry.state is ConfigEntryState.SETUP_ERROR
+
+
+@pytest.mark.asyncio
+async def test_async_setup_entry_success(
+    hass: HomeAssistant,
+    mock_config_entry: MagicMock,
+    mock_api_client: FlussApiClient,
+) -> None:
+    """Test successful setup."""
+    with patch("fluss_api.FlussApiClient", return_value=mock_api_client):
+        assert await hass.config_entries.async_setup(mock_config_entry.entry_id)
+        assert mock_config_entry.state is ConfigEntryState.LOADED
+        hass.config_entries.async_forward_entry_setups.assert_called_once_with(
+            mock_config_entry, PLATFORMS
+        )
+
+
+@pytest.mark.asyncio
+async def test_async_unload_entry(
+    hass: HomeAssistant,
+    mock_config_entry: MagicMock,
+    mock_api_client: FlussApiClient,
+) -> None:
+    """Test unloading entry."""
+    # Set up the config entry first to ensure it's in LOADED state
+    with patch("fluss_api.FlussApiClient", return_value=mock_api_client):
+        await hass.config_entries.async_setup(mock_config_entry.entry_id)
+        assert mock_config_entry.state is ConfigEntryState.LOADED
+
+    # Test unloading
+    with patch(
+        "homeassistant.components.fluss.async_unload_platforms", return_value=True
+    ):
+        assert await hass.config_entries.async_unload(mock_config_entry.entry_id)
+        assert mock_config_entry.state is ConfigEntryState.NOT_LOADED
+
+
+@pytest.mark.asyncio
+async def test_platforms_forwarded(
+    hass: HomeAssistant,
+    mock_config_entry: MagicMock,
+    mock_api_client: FlussApiClient,
+) -> None:
+    """Test platforms are forwarded correctly."""
+    with patch("fluss_api.FlussApiClient", return_value=mock_api_client):
+        await hass.config_entries.async_setup(mock_config_entry.entry_id)
+        assert mock_config_entry.state is ConfigEntryState.LOADED
+        hass.config_entries.async_forward_entry_setups.assert_called_with(
+            mock_config_entry, [Platform.BUTTON]
+        )

tests/components/fluss/conftest.py

@@ -0,0 +1,74 @@
+"""Shared test fixtures for Fluss+ integration."""
+
+from __future__ import annotations
+
+from unittest.mock import AsyncMock, patch
+
+import pytest
+
+from homeassistant.components.fluss.const import DOMAIN
+from homeassistant.const import CONF_API_KEY
+from homeassistant.core import HomeAssistant
+
+from tests.common import MockConfigEntry
+
+
+@pytest.fixture
+def mock_config_entry() -> MockConfigEntry:
+    """Return the default mocked config entry."""
+    return MockConfigEntry(
+        domain=DOMAIN,
+        title="Fluss Integration",
+        data={CONF_API_KEY: "test_api_key"},
+        unique_id="test_api_key",
+    )
+
+
+@pytest.fixture
+def mock_api_client() -> AsyncMock:
+    """Mock Fluss API client with single device."""
+    with (
+        patch(
+            "homeassistant.components.fluss.coordinator.FlussApiClient",
+            autospec=True,
+        ) as mock_client,
+        patch(
+            "homeassistant.components.fluss.config_flow.FlussApiClient",
+            new=mock_client,
+        ),
+    ):
+        client = mock_client.return_value
+        client.async_get_devices.return_value = {
+            "devices": [{"deviceId": "1", "deviceName": "Test Device"}]
+        }
+        client.async_trigger_device.return_value = None
+        yield client
+
+
+@pytest.fixture
+def mock_api_client_multiple_devices() -> AsyncMock:
+    """Mock Fluss API client with multiple devices."""
+    with patch(
+        "homeassistant.components.fluss.coordinator.FlussApiClient",
+        autospec=True,
+    ) as mock_client:
+        client = mock_client.return_value
+        client.async_get_devices.return_value = {
+            "devices": [
+                {"deviceId": "2a303030sdj1", "deviceName": "Device 1"},
+                {"deviceId": "ape93k9302j2", "deviceName": "Device 2"},
+            ]
+        }
+        client.async_trigger_device.return_value = None
+        yield client
+
+
+@pytest.fixture
+async def init_integration(
+    hass: HomeAssistant, mock_config_entry: MockConfigEntry, mock_api_client: AsyncMock
+) -> MockConfigEntry:
+    """Set up the Fluss integration for testing."""
+    mock_config_entry.add_to_hass(hass)
+    assert await hass.config_entries.async_setup(mock_config_entry.entry_id)
+    await hass.async_block_till_done()
+    return mock_config_entry

tests/components/fluss/test_button.py

@@ -0,0 +1,118 @@
+"""Tests for the Fluss Buttons."""
+
+from __future__ import annotations
+
+from unittest.mock import AsyncMock, patch
+
+from fluss_api import FlussApiClient, FlussApiClientError
+import pytest
+from syrupy.assertion import SnapshotAssertion
+
+from homeassistant.components.button import DOMAIN as BUTTON_DOMAIN, SERVICE_PRESS
+from homeassistant.config_entries import ConfigEntryState
+from homeassistant.const import ATTR_ENTITY_ID
+from homeassistant.core import HomeAssistant
+from homeassistant.exceptions import HomeAssistantError
+from homeassistant.helpers import device_registry as dr, entity_registry as er
+
+from tests.common import MockConfigEntry, snapshot_platform
+
+
+async def test_async_setup_entry_multiple_devices(
+    hass: HomeAssistant,
+    mock_api_client_multiple_devices: AsyncMock,
+    mock_config_entry: MockConfigEntry,
+    entity_registry: er.EntityRegistry,
+    snapshot: SnapshotAssertion,
+) -> None:
+    """Test setup with multiple devices."""
+    mock_config_entry.add_to_hass(hass)
+    assert await hass.config_entries.async_setup(mock_config_entry.entry_id)
+    await hass.async_block_till_done()
+
+    mock_api_client_multiple_devices.async_get_devices.assert_called_once()
+
+    await snapshot_platform(hass, entity_registry, snapshot, mock_config_entry.entry_id)
+
+
+async def test_button_press_success(
+    hass: HomeAssistant,
+    mock_api_client: FlussApiClient,
+    entity_registry: er.EntityRegistry,
+    init_integration: MockConfigEntry,
+    snapshot: SnapshotAssertion,
+) -> None:
+    """Test successful button press."""
+    state = hass.states.get("button.test_device")
+    assert state
+    assert state == snapshot(name="button_state")
+
+    entry_reg = entity_registry.async_get(state.entity_id)
+    assert entry_reg
+
+    device_registry = dr.async_get(hass)
+    device = device_registry.async_get(entry_reg.device_id)
+    assert device == snapshot(name="device_info")
+
+    await hass.services.async_call(
+        BUTTON_DOMAIN,
+        SERVICE_PRESS,
+        {ATTR_ENTITY_ID: "button.test_device"},
+        blocking=True,
+    )
+
+    mock_api_client.async_trigger_device.assert_called_once_with("1")
+
+
+async def test_button_press_error(
+    hass: HomeAssistant,
+    mock_api_client: FlussApiClient,
+    init_integration: MockConfigEntry,
+) -> None:
+    """Test button press with API error."""
+    state = hass.states.get("button.test_device")
+    assert state
+
+    mock_api_client.async_trigger_device.side_effect = FlussApiClientError("API Boom")
+
+    with pytest.raises(HomeAssistantError, match="Failed to trigger device: API Boom"):
+        await hass.services.async_call(
+            BUTTON_DOMAIN,
+            SERVICE_PRESS,
+            {ATTR_ENTITY_ID: "button.test_device"},
+            blocking=True,
+        )
+
+
+async def test_no_devices_setup(
+    hass: HomeAssistant,
+    mock_api_client: FlussApiClient,
+    mock_config_entry: MockConfigEntry,
+) -> None:
+    """Test setup with no devices."""
+    mock_api_client.async_get_devices.return_value = {"devices": []}
+    mock_config_entry.add_to_hass(hass)
+
+    with patch("fluss_api.FlussApiClient", return_value=mock_api_client):
+        assert await hass.config_entries.async_setup(mock_config_entry.entry_id)
+        await hass.async_block_till_done()
+
+    assert hass.states.get("button.test_device") is None
+
+
+async def test_unload_entry(
+    hass: HomeAssistant,
+    init_integration: MockConfigEntry,
+) -> None:
+    """Test unloading the entry."""
+    assert init_integration.state is ConfigEntryState.LOADED
+    assert await hass.config_entries.async_unload(init_integration.entry_id)
+    await hass.async_block_till_done()
+    assert init_integration.state is ConfigEntryState.NOT_LOADED
+
+    state = hass.states.get("button.test_device")
+    if state:
+        assert state.state == "unavailable"
+        assert state.attributes.get("restored") is True
+    else:
+        assert state is None

tests/components/fluss/test_config_flow.py

@@ -0,0 +1,100 @@
+"""Tests for the Fluss+ config flow."""
+
+from unittest.mock import AsyncMock, patch
+
+from fluss_api import (
+    FlussApiClientAuthenticationError,
+    FlussApiClientCommunicationError,
+)
+import pytest
+
+from homeassistant.components.fluss.const import DOMAIN
+from homeassistant.config_entries import SOURCE_USER
+from homeassistant.const import CONF_API_KEY
+from homeassistant.core import HomeAssistant
+from homeassistant.data_entry_flow import FlowResultType
+
+
+async def test_show_form(hass: HomeAssistant) -> None:
+    """Test that the form is shown."""
+    result = await hass.config_entries.flow.async_init(
+        DOMAIN, context={"source": SOURCE_USER}
+    )
+
+    assert result["type"] is FlowResultType.FORM
+    assert result["step_id"] == "user"
+    assert result["errors"] == {}
+
+
+async def test_successful_flow(hass: HomeAssistant, mock_api_client: AsyncMock) -> None:
+    """Test successful config flow."""
+    user_input = {CONF_API_KEY: "valid_api_key"}
+
+    result = await hass.config_entries.flow.async_init(
+        DOMAIN, context={"source": SOURCE_USER}, data=user_input
+    )
+
+    assert result["type"] is FlowResultType.CREATE_ENTRY
+    assert result["title"] == "My Fluss+ Devices"
+    assert result["data"] == user_input
+
+
+@pytest.mark.parametrize(
+    ("exception", "expected_error"),
+    [
+        (FlussApiClientAuthenticationError, "invalid_auth"),
+        (FlussApiClientCommunicationError, "cannot_connect"),
+        (ValueError, "unknown"),
+    ],
+)
+async def test_step_user_errors(
+    hass: HomeAssistant,
+    exception: Exception,
+    expected_error: str,
+    mock_api_client: AsyncMock,
+) -> None:
+    """Test error cases for user step with recovery."""
+    user_input = {CONF_API_KEY: "some_api_key"}
+
+    class_mock = mock_api_client._mock_parent
+    class_mock.side_effect = exception
+
+    result = await hass.config_entries.flow.async_init(
+        DOMAIN, context={"source": SOURCE_USER}, data=user_input
+    )
+
+    assert result["type"] is FlowResultType.FORM
+    assert result["step_id"] == "user"
+    assert result["errors"] == {"base": expected_error}
+
+    class_mock.side_effect = None
+
+    result = await hass.config_entries.flow.async_configure(
+        result["flow_id"],
+        user_input,
+    )
+    assert result["type"] is FlowResultType.CREATE_ENTRY
+    assert result["title"] == "My Fluss+ Devices"
+    assert result["data"] == user_input
+
+
+async def test_unexpected_exception_logging(
+    hass: HomeAssistant, mock_api_client: AsyncMock
+) -> None:
+    """Test logging of unexpected exceptions."""
+    user_input = {CONF_API_KEY: "some_api_key"}
+
+    with patch(
+        "homeassistant.components.fluss.config_flow.LOGGER.exception"
+    ) as mock_logger:
+        class_mock = mock_api_client._mock_parent
+        class_mock.side_effect = Exception("Unexpected error")
+
+        result = await hass.config_entries.flow.async_init(
+            DOMAIN, context={"source": SOURCE_USER}, data=user_input
+        )
+
+        assert result["type"] is FlowResultType.FORM
+        assert result["step_id"] == "user"
+        assert result["errors"] == {"base": "unknown"}
+        mock_logger.assert_called_once_with("Unexpected exception occurred")

tests/components/fluss/test_init.py

@@ -0,0 +1,74 @@
+"""Test script for Fluss+ integration initialization."""
+
+from unittest.mock import AsyncMock, patch
+
+from fluss_api import (
+    FlussApiClientAuthenticationError,
+    FlussApiClientCommunicationError,
+    FlussApiClientError,
+)
+import pytest
+
+from homeassistant.config_entries import ConfigEntryState
+from homeassistant.core import HomeAssistant
+
+from tests.common import MockConfigEntry
+
+
+async def test_async_setup_entry_authentication_error(
+    hass: HomeAssistant, mock_config_entry
+) -> None:
+    """Test that an authentication error during setup leads to SETUP_ERROR state."""
+    mock_config_entry.add_to_hass(hass)
+    with patch(
+        "homeassistant.components.fluss.coordinator.FlussApiClient.async_get_devices",
+        side_effect=FlussApiClientAuthenticationError("Invalid credentials"),
+    ):
+        await hass.config_entries.async_setup(mock_config_entry.entry_id)
+        await hass.async_block_till_done()
+
+    assert mock_config_entry.state is ConfigEntryState.SETUP_ERROR
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize(
+    "error_type",
+    [
+        FlussApiClientCommunicationError("Network error"),
+        FlussApiClientError("General error"),
+    ],
+    ids=["communication_error", "general_error"],
+)
+async def test_async_setup_entry_error(
+    hass: HomeAssistant, mock_config_entry, error_type
+) -> None:
+    """Test that non-authentication errors during setup lead to SETUP_RETRY state."""
+    mock_config_entry.add_to_hass(hass)
+    with patch(
+        "homeassistant.components.fluss.coordinator.FlussApiClient",
+        side_effect=error_type,
+    ):
+        await hass.config_entries.async_setup(mock_config_entry.entry_id)
+        await hass.async_block_till_done()
+
+    assert mock_config_entry.state is ConfigEntryState.SETUP_ERROR
+
+
+@pytest.mark.asyncio
+async def test_load_unload_config_entry(
+    hass: HomeAssistant,
+    mock_config_entry: MockConfigEntry,
+    mock_api_client: AsyncMock,
+) -> None:
+    """Test the Fluss configuration entry loading/unloading."""
+    mock_config_entry.add_to_hass(hass)
+    await hass.config_entries.async_setup(mock_config_entry.entry_id)
+    await hass.async_block_till_done()
+
+    assert mock_config_entry.state is ConfigEntryState.LOADED
+    assert len(mock_api_client.async_get_devices.mock_calls) == 1
+
+    await hass.config_entries.async_unload(mock_config_entry.entry_id)
+    await hass.async_block_till_done()
+
+    assert mock_config_entry.state is ConfigEntryState.NOT_LOADED