"""Define WiFi commands."""

from __future__ import annotations

from collections.abc import Awaitable, Callable
from typing import Any

import voluptuous as vol

from aioguardian.errors import CommandError
from aioguardian.helpers.command import Command

PARAM_PASSWORD = "password"  # noqa: S105, # nosec
PARAM_SSID = "ssid"

WIFI_CONFIGURE_PARAM_SCHEMA = vol.Schema(
    {
        vol.Required(PARAM_SSID): vol.All(str, vol.Length(max=36)),
        vol.Required(PARAM_PASSWORD): vol.All(str, vol.Length(max=64)),
    }
)


class WiFiCommands:
    """Define an object to manage WiFi commands.

    Note that this class shouldn't be instantiated directly; an instance of it will
    automatically be added to the :meth:`Client <aioguardian.Client>` (as
    ``client.wifi``).

    Args:
    ----
        execute_command: The execute_command method from the Client object.

    """

    def __init__(
        self, execute_command: Callable[..., Awaitable[dict[str, Any]]]
    ) -> None:
        """Initialize.

        Args:
        ----
            execute_command: The execute_command method from the Client object.

        """
        self._execute_command = execute_command

    async def configure(
        self, ssid: str, password: str, *, silent: bool = True
    ) -> dict[str, Any]:
        """Configure the device to use a wireless network.

        Args:
        ----
            ssid: An SSID to connect to.
            password: The password to use to connect to the SSID.
            silent: Whether the valve controller should beep upon successful command.

        Returns:
        -------
            An API response payload.

        Raises:
        ------
            CommandError: Raised when invalid parameters are provided.

        """
        params = {PARAM_SSID: ssid, PARAM_PASSWORD: password}

        try:
            WIFI_CONFIGURE_PARAM_SCHEMA(params)
        except vol.Invalid as err:
            msg = f"Invalid parameters provided: {err}"
            raise CommandError(msg) from err

        return await self._execute_command(
            Command.WIFI_CONFIGURE, params=params, silent=silent
        )

    async def disable_ap(self, *, silent: bool = True) -> dict[str, Any]:
        """Disable the device's onboard WiFi access point.

        Args:
        ----
            silent: Whether the valve controller should beep upon successful command.

        Returns:
        -------
            An API response payload.

        """
        return await self._execute_command(Command.WIFI_DISABLE_AP, silent=silent)

    async def enable_ap(self, *, silent: bool = True) -> dict[str, Any]:
        """Enable the device's onboard WiFi access point.

        Args:
        ----
            silent: Whether the valve controller should beep upon successful command.

        Returns:
        -------
            An API response payload.

        """
        return await self._execute_command(Command.WIFI_ENABLE_AP, silent=silent)

    async def list(self, *, silent: bool = True) -> dict[str, Any]:
        """List previously scanned nearby SSIDs.

        Args:
        ----
            silent: Whether the valve controller should beep upon successful command.

        Returns:
        -------
            An API response payload.

        """
        return await self._execute_command(Command.WIFI_LIST, silent=silent)

    async def reset(self, *, silent: bool = True) -> dict[str, Any]:
        """Erase and reset all WiFi settings.

        Args:
        ----
            silent: Whether the valve controller should beep upon successful command.

        Returns:
        -------
            An API response payload.

        """
        return await self._execute_command(Command.WIFI_RESET, silent=silent)

    async def scan(self, *, silent: bool = True) -> dict[str, Any]:
        """Scan for nearby SSIDs.

        Args:
        ----
            silent: Whether the valve controller should beep upon successful command.

        Returns:
        -------
            An API response payload.

        """
        return await self._execute_command(Command.WIFI_SCAN, silent=silent)

    async def status(self, *, silent: bool = True) -> dict[str, Any]:
        """Return the current WiFi status of the device.

        Args:
        ----
            silent: Whether the valve controller should beep upon successful command.

        Returns:
        -------
            An API response payload.

        """
        return await self._execute_command(Command.WIFI_STATUS, silent=silent)