haos-hacs-immich-album-watcher/custom_components/immich_album_watcher/text.py

"""Text platform for Immich Album Watcher."""

from __future__ import annotations

import logging

from homeassistant.components.text import TextEntity, TextMode
from homeassistant.config_entries import ConfigEntry, ConfigSubentry
from homeassistant.core import HomeAssistant, callback
from homeassistant.helpers.device_registry import DeviceEntryType
from homeassistant.helpers.entity import DeviceInfo
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.update_coordinator import CoordinatorEntity
from homeassistant.util import slugify

from .const import (
    ATTR_ALBUM_ID,
    ATTR_ALBUM_PROTECTED_URL,
    CONF_ALBUM_ID,
    CONF_ALBUM_NAME,
    CONF_HUB_NAME,
    DOMAIN,
)
from .coordinator import AlbumData, ImmichAlbumWatcherCoordinator

_LOGGER = logging.getLogger(__name__)


async def async_setup_entry(
    hass: HomeAssistant,
    entry: ConfigEntry,
    async_add_entities: AddEntitiesCallback,
) -> None:
    """Set up Immich Album Watcher text entities from a config entry."""
    # Iterate through all album subentries
    for subentry_id, subentry in entry.subentries.items():
        subentry_data = hass.data[DOMAIN][entry.entry_id]["subentries"].get(subentry_id)
        if not subentry_data:
            _LOGGER.error("Subentry data not found for %s", subentry_id)
            continue

        coordinator = subentry_data.coordinator

        async_add_entities(
            [ImmichAlbumProtectedPasswordText(coordinator, entry, subentry)],
            config_subentry_id=subentry_id,
        )


class ImmichAlbumProtectedPasswordText(
    CoordinatorEntity[ImmichAlbumWatcherCoordinator], TextEntity
):
    """Text entity for editing an Immich album's protected link password."""

    _attr_has_entity_name = True
    _attr_icon = "mdi:key-variant"
    _attr_translation_key = "album_protected_password_edit"
    _attr_mode = TextMode.PASSWORD
    _attr_native_max = 100

    def __init__(
        self,
        coordinator: ImmichAlbumWatcherCoordinator,
        entry: ConfigEntry,
        subentry: ConfigSubentry,
    ) -> None:
        """Initialize the text entity."""
        super().__init__(coordinator)
        self._entry = entry
        self._subentry = subentry
        self._album_id = subentry.data[CONF_ALBUM_ID]
        self._album_name = subentry.data.get(CONF_ALBUM_NAME, "Unknown Album")
        self._hub_name = entry.data.get(CONF_HUB_NAME, "Immich")
        unique_id_prefix = slugify(f"{self._hub_name}_album_{self._album_name}")
        self._attr_unique_id = f"{unique_id_prefix}_protected_password_edit"

    @property
    def _album_data(self) -> AlbumData | None:
        """Get the album data from coordinator."""
        return self.coordinator.data

    @property
    def translation_placeholders(self) -> dict[str, str]:
        """Return translation placeholders."""
        if self._album_data:
            return {"album_name": self._album_data.name}
        return {"album_name": self._album_name}

    @property
    def available(self) -> bool:
        """Return if entity is available.

        Only available when the album has a protected shared link.
        """
        if not self.coordinator.last_update_success or self._album_data is None:
            return False
        # Only available if there's a protected link to edit
        return self.coordinator.get_protected_link_id() is not None

    @property
    def device_info(self) -> DeviceInfo:
        """Return device info - one device per album."""
        return DeviceInfo(
            identifiers={(DOMAIN, self._subentry.subentry_id)},
            name=self._album_name,
            manufacturer="Immich",
            entry_type=DeviceEntryType.SERVICE,
            via_device=(DOMAIN, self._entry.entry_id),
        )

    @property
    def native_value(self) -> str | None:
        """Return the current password value."""
        if self._album_data:
            return self.coordinator.get_protected_password()
        return None

    @property
    def extra_state_attributes(self) -> dict[str, str]:
        """Return extra state attributes."""
        if not self._album_data:
            return {}

        attrs = {
            ATTR_ALBUM_ID: self._album_data.id,
        }

        protected_url = self.coordinator.get_protected_url()
        if protected_url:
            attrs[ATTR_ALBUM_PROTECTED_URL] = protected_url

        return attrs

    async def async_set_value(self, value: str) -> None:
        """Set the password for the protected shared link."""
        link_id = self.coordinator.get_protected_link_id()
        if not link_id:
            _LOGGER.error(
                "Cannot set password: no protected link found for album %s",
                self._album_id,
            )
            return

        # Empty string means remove password
        password = value if value else None

        success = await self.coordinator.async_set_shared_link_password(
            link_id, password
        )

        if success:
            # Trigger a coordinator update to refresh the state
            await self.coordinator.async_request_refresh()
        else:
            _LOGGER.error("Failed to update password for album %s", self._album_id)

    @callback
    def _handle_coordinator_update(self) -> None:
        """Handle updated data from the coordinator."""
        self.async_write_ha_state()