"""Define a series of endpoints for what locations are supported."""
from __future__ import annotations

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


class Supported:
    """Define an object to supported location API calls."""

    def __init__(self, request: Callable[..., Awaitable]) -> None:
        """Initialize.

        Args:
            request: The request method from the CloudAPI object.
        """
        self._request = request

    async def cities(self, country: str, state: str) -> list[dict[str, Any]]:
        """Return a list of supported cities in a country/state.

        Args:
            state: A state.
            country: A country.

        Returns:
            An API response payload.
        """
        data = await self._request(
            "get", "cities", params={"state": state, "country": country}
        )
        return [d["city"] for d in data["data"]]

    async def countries(self) -> list[dict[str, Any]]:
        """Return an array of all supported countries.

        Returns:
            An API response payload.
        """
        data = await self._request("get", "countries")
        return [d["country"] for d in data["data"]]

    async def states(self, country: str) -> list[dict[str, Any]]:
        """Return a list of supported states in a country.

        Args:
            country: A country.

        Returns:
            An API response payload.
        """
        data = await self._request("get", "states", params={"country": country})
        return [d["state"] for d in data["data"]]

    async def stations(
        self, city: str, state: str, country: str
    ) -> list[dict[str, Any]]:
        """Return a list of supported stations in a city.

        Args:
            city: A city.
            state: A state.
            country: A country.

        Returns:
            An API response payload.
        """
        data = await self._request(
            "get", "stations", params={"city": city, "state": state, "country": country}
        )
        return cast(list[dict[str, Any]], data["data"])