"""Config flow for fitbit.""" from collections.abc import Mapping import logging from typing import Any from homeassistant.config_entries import ConfigEntry, ConfigFlowResult from homeassistant.const import CONF_TOKEN from homeassistant.helpers import config_entry_oauth2_flow from . import api from .const import DOMAIN, OAUTH_SCOPES from .exceptions import FitbitApiException, FitbitAuthException _LOGGER = logging.getLogger(__name__) class OAuth2FlowHandler( config_entry_oauth2_flow.AbstractOAuth2FlowHandler, domain=DOMAIN ): """Config flow to handle fitbit OAuth2 authentication.""" DOMAIN = DOMAIN reauth_entry: ConfigEntry | None = None @property def logger(self) -> logging.Logger: """Return logger.""" return logging.getLogger(__name__) @property def extra_authorize_data(self) -> dict[str, str]: """Extra data that needs to be appended to the authorize url.""" return { "scope": " ".join(OAUTH_SCOPES), "prompt": "consent" if not self.reauth_entry else "none", } async def async_step_reauth( self, entry_data: Mapping[str, Any] ) -> ConfigFlowResult: """Perform reauth upon an API authentication error.""" self.reauth_entry = self.hass.config_entries.async_get_entry( self.context["entry_id"] ) return await self.async_step_reauth_confirm() async def async_step_reauth_confirm( self, user_input: dict[str, Any] | None = None ) -> ConfigFlowResult: """Confirm reauth dialog.""" if user_input is None: return self.async_show_form(step_id="reauth_confirm") return await self.async_step_user() async def async_step_creation( self, user_input: dict[str, Any] | None = None ) -> ConfigFlowResult: """Create config entry from external data with Fitbit specific error handling.""" try: return await super().async_step_creation() except FitbitAuthException as err: _LOGGER.error( "Failed to authenticate when creating Fitbit credentials: %s", err ) return self.async_abort(reason="invalid_auth") except FitbitApiException as err: _LOGGER.error("Failed to create Fitbit credentials: %s", err) return self.async_abort(reason="cannot_connect") async def async_oauth_create_entry(self, data: dict[str, Any]) -> ConfigFlowResult: """Create an entry for the flow, or update existing entry.""" client = api.ConfigFlowFitbitApi(self.hass, data[CONF_TOKEN]) try: profile = await client.async_get_user_profile() except FitbitAuthException as err: _LOGGER.error("Failed to authenticate with Fitbit API: %s", err) return self.async_abort(reason="invalid_access_token") except FitbitApiException as err: _LOGGER.error("Failed to fetch user profile for Fitbit API: %s", err) return self.async_abort(reason="cannot_connect") if self.reauth_entry: if self.reauth_entry.unique_id != profile.encoded_id: return self.async_abort(reason="wrong_account") self.hass.config_entries.async_update_entry(self.reauth_entry, data=data) await self.hass.config_entries.async_reload(self.reauth_entry.entry_id) return self.async_abort(reason="reauth_successful") await self.async_set_unique_id(profile.encoded_id) self._abort_if_unique_id_configured() return self.async_create_entry(title=profile.display_name, data=data) async def async_step_import(self, data: dict[str, Any]) -> ConfigFlowResult: """Handle import from YAML.""" return await self.async_oauth_create_entry(data)