# This file was auto-generated by Fern from our API Definition.

import typing
from json.decoder import JSONDecodeError

from ..core.api_error import ApiError
from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
from ..core.http_response import AsyncHttpResponse, HttpResponse
from ..core.jsonable_encoder import jsonable_encoder
from ..core.pydantic_utilities import parse_obj_as
from ..core.request_options import RequestOptions
from ..errors.unprocessable_entity_error import UnprocessableEntityError
from ..types.country_response import CountryResponse
from ..types.timezone_response import TimezoneResponse


class RawReferenceDataClient:
    def __init__(self, *, client_wrapper: SyncClientWrapper):
        self._client_wrapper = client_wrapper

    def get_timezones(
        self, *, request_options: typing.Optional[RequestOptions] = None
    ) -> HttpResponse[typing.List[TimezoneResponse]]:
        """
        Get all active timezones.

        Returns a list of all available timezones from the IANA timezone database.
        Timezones are ordered by display order and name.

        **Returns:**
        - List of timezone objects with:
          - IANA timezone name (e.g., "America/New_York")
          - User-friendly display name
          - UTC offset information
          - Country code association

        **Use Cases:**
        - User profile timezone selection
        - Scheduling and calendar features
        - Time conversion utilities

        Parameters
        ----------
        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        HttpResponse[typing.List[TimezoneResponse]]
            Successful Response
        """
        _response = self._client_wrapper.httpx_client.request(
            "v1/reference/timezones",
            method="GET",
            request_options=request_options,
        )
        try:
            if 200 <= _response.status_code < 300:
                _data = typing.cast(
                    typing.List[TimezoneResponse],
                    parse_obj_as(
                        type_=typing.List[TimezoneResponse],  # type: ignore
                        object_=_response.json(),
                    ),
                )
                return HttpResponse(response=_response, data=_data)
            _response_json = _response.json()
        except JSONDecodeError:
            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

    def get_countries(
        self, *, request_options: typing.Optional[RequestOptions] = None
    ) -> HttpResponse[typing.List[CountryResponse]]:
        """
        Get all active countries.

        Returns a comprehensive list of countries with ISO codes, currency information,
        phone codes, and geographic data.

        **Returns:**
        - List of country objects with:
          - ISO 3166-1 alpha-2 and alpha-3 codes
          - Official and native names
          - Currency information (code, name, symbol)
          - International dialing code
          - Flag emoji
          - Geographic coordinates and regions

        **Use Cases:**
        - User profile country selection
        - Address forms
        - Phone number validation
        - Currency selection
        - Geographic filtering

        Parameters
        ----------
        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        HttpResponse[typing.List[CountryResponse]]
            Successful Response
        """
        _response = self._client_wrapper.httpx_client.request(
            "v1/reference/countries",
            method="GET",
            request_options=request_options,
        )
        try:
            if 200 <= _response.status_code < 300:
                _data = typing.cast(
                    typing.List[CountryResponse],
                    parse_obj_as(
                        type_=typing.List[CountryResponse],  # type: ignore
                        object_=_response.json(),
                    ),
                )
                return HttpResponse(response=_response, data=_data)
            _response_json = _response.json()
        except JSONDecodeError:
            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

    def get_timezones_for_country(
        self, country_id: str, *, request_options: typing.Optional[RequestOptions] = None
    ) -> HttpResponse[typing.List[TimezoneResponse]]:
        """
        Get timezones for a specific country.

        Returns the timezones associated with the given country, ordered by display order.
        Useful for pre-selecting the correct timezone when a user picks their country.

        **Path Parameters:**
        - `country_id`: The country ID (country_ prefixed)

        **Returns:**
        - List of timezone objects for the country

        Parameters
        ----------
        country_id : str

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        HttpResponse[typing.List[TimezoneResponse]]
            Successful Response
        """
        _response = self._client_wrapper.httpx_client.request(
            f"v1/reference/countries/{jsonable_encoder(country_id)}/timezones",
            method="GET",
            request_options=request_options,
        )
        try:
            if 200 <= _response.status_code < 300:
                _data = typing.cast(
                    typing.List[TimezoneResponse],
                    parse_obj_as(
                        type_=typing.List[TimezoneResponse],  # type: ignore
                        object_=_response.json(),
                    ),
                )
                return HttpResponse(response=_response, data=_data)
            if _response.status_code == 422:
                raise UnprocessableEntityError(
                    headers=dict(_response.headers),
                    body=typing.cast(
                        typing.Any,
                        parse_obj_as(
                            type_=typing.Any,  # type: ignore
                            object_=_response.json(),
                        ),
                    ),
                )
            _response_json = _response.json()
        except JSONDecodeError:
            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)


class AsyncRawReferenceDataClient:
    def __init__(self, *, client_wrapper: AsyncClientWrapper):
        self._client_wrapper = client_wrapper

    async def get_timezones(
        self, *, request_options: typing.Optional[RequestOptions] = None
    ) -> AsyncHttpResponse[typing.List[TimezoneResponse]]:
        """
        Get all active timezones.

        Returns a list of all available timezones from the IANA timezone database.
        Timezones are ordered by display order and name.

        **Returns:**
        - List of timezone objects with:
          - IANA timezone name (e.g., "America/New_York")
          - User-friendly display name
          - UTC offset information
          - Country code association

        **Use Cases:**
        - User profile timezone selection
        - Scheduling and calendar features
        - Time conversion utilities

        Parameters
        ----------
        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        AsyncHttpResponse[typing.List[TimezoneResponse]]
            Successful Response
        """
        _response = await self._client_wrapper.httpx_client.request(
            "v1/reference/timezones",
            method="GET",
            request_options=request_options,
        )
        try:
            if 200 <= _response.status_code < 300:
                _data = typing.cast(
                    typing.List[TimezoneResponse],
                    parse_obj_as(
                        type_=typing.List[TimezoneResponse],  # type: ignore
                        object_=_response.json(),
                    ),
                )
                return AsyncHttpResponse(response=_response, data=_data)
            _response_json = _response.json()
        except JSONDecodeError:
            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

    async def get_countries(
        self, *, request_options: typing.Optional[RequestOptions] = None
    ) -> AsyncHttpResponse[typing.List[CountryResponse]]:
        """
        Get all active countries.

        Returns a comprehensive list of countries with ISO codes, currency information,
        phone codes, and geographic data.

        **Returns:**
        - List of country objects with:
          - ISO 3166-1 alpha-2 and alpha-3 codes
          - Official and native names
          - Currency information (code, name, symbol)
          - International dialing code
          - Flag emoji
          - Geographic coordinates and regions

        **Use Cases:**
        - User profile country selection
        - Address forms
        - Phone number validation
        - Currency selection
        - Geographic filtering

        Parameters
        ----------
        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        AsyncHttpResponse[typing.List[CountryResponse]]
            Successful Response
        """
        _response = await self._client_wrapper.httpx_client.request(
            "v1/reference/countries",
            method="GET",
            request_options=request_options,
        )
        try:
            if 200 <= _response.status_code < 300:
                _data = typing.cast(
                    typing.List[CountryResponse],
                    parse_obj_as(
                        type_=typing.List[CountryResponse],  # type: ignore
                        object_=_response.json(),
                    ),
                )
                return AsyncHttpResponse(response=_response, data=_data)
            _response_json = _response.json()
        except JSONDecodeError:
            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

    async def get_timezones_for_country(
        self, country_id: str, *, request_options: typing.Optional[RequestOptions] = None
    ) -> AsyncHttpResponse[typing.List[TimezoneResponse]]:
        """
        Get timezones for a specific country.

        Returns the timezones associated with the given country, ordered by display order.
        Useful for pre-selecting the correct timezone when a user picks their country.

        **Path Parameters:**
        - `country_id`: The country ID (country_ prefixed)

        **Returns:**
        - List of timezone objects for the country

        Parameters
        ----------
        country_id : str

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        AsyncHttpResponse[typing.List[TimezoneResponse]]
            Successful Response
        """
        _response = await self._client_wrapper.httpx_client.request(
            f"v1/reference/countries/{jsonable_encoder(country_id)}/timezones",
            method="GET",
            request_options=request_options,
        )
        try:
            if 200 <= _response.status_code < 300:
                _data = typing.cast(
                    typing.List[TimezoneResponse],
                    parse_obj_as(
                        type_=typing.List[TimezoneResponse],  # type: ignore
                        object_=_response.json(),
                    ),
                )
                return AsyncHttpResponse(response=_response, data=_data)
            if _response.status_code == 422:
                raise UnprocessableEntityError(
                    headers=dict(_response.headers),
                    body=typing.cast(
                        typing.Any,
                        parse_obj_as(
                            type_=typing.Any,  # type: ignore
                            object_=_response.json(),
                        ),
                    ),
                )
            _response_json = _response.json()
        except JSONDecodeError:
            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
