"""Sidebar panel registration for the Maintenance Supporter integration."""

from __future__ import annotations

import hashlib
import logging
from pathlib import Path

from homeassistant.components import frontend, panel_custom
from homeassistant.components.http import StaticPathConfig
from homeassistant.core import HomeAssistant

from .const import DOMAIN, PANEL_ICON, PANEL_NAME, PANEL_URL
from .helpers.global_options import get_panel_title

_LOGGER = logging.getLogger(__name__)


async def _async_file_hash(hass: HomeAssistant, path: Path) -> str:
    """Return a short hash of a file for cache busting."""
    try:
        content = await hass.async_add_executor_job(path.read_bytes)
        return hashlib.sha256(content).hexdigest()[:8]
    except OSError:
        return "0"


async def async_register_panel(hass: HomeAssistant, *, force: bool = False) -> None:
    """Register the maintenance supporter sidebar panel.

    Pass ``force=True`` to re-register an already-registered panel (e.g. after
    the user changes the sidebar title in options) — HA's panel registry has no
    in-place update, so we remove and re-add it.
    """
    title = get_panel_title(hass)
    if hass.data.get(DOMAIN, {}).get("_panel_registered"):
        if not force:
            return
        # The ONLY global-options change that needs a re-register is the
        # sidebar title — HA has no in-place panel update. If the title is
        # unchanged, return early: calling async_remove_panel on every
        # unrelated settings change (feature toggles, objects-table columns,
        # notification prefs, …) yanks the panel out from under anyone
        # currently viewing it and bounces them to the HA default dashboard.
        if hass.data.get(DOMAIN, {}).get("_panel_title") == title:
            return
        # Title changed: drop the existing registration so the re-register
        # below doesn't raise "Overwriting panel".
        frontend.async_remove_panel(hass, PANEL_NAME)
        hass.data.setdefault(DOMAIN, {})["_panel_registered"] = False

    panel_path = Path(__file__).parent / "frontend" / "maintenance-panel.js"
    version = await _async_file_hash(hass, panel_path)
    versioned_url = f"{PANEL_URL}_{version}"

    # Static path is registered once per versioned URL; on a forced re-register
    # the URL is unchanged (same bundle hash), so guard against re-adding it.
    if hass.data.get(DOMAIN, {}).get("_panel_static_url") != versioned_url:
        await hass.http.async_register_static_paths([StaticPathConfig(versioned_url, str(panel_path), False)])
        hass.data.setdefault(DOMAIN, {})["_panel_static_url"] = versioned_url

    await panel_custom.async_register_panel(
        hass,
        frontend_url_path=PANEL_NAME,
        webcomponent_name="maintenance-supporter-panel",
        sidebar_title=title,
        sidebar_icon=PANEL_ICON,
        module_url=versioned_url,
        require_admin=False,
        config={},
    )

    hass.data.setdefault(DOMAIN, {})["_panel_registered"] = True
    hass.data.setdefault(DOMAIN, {})["_panel_title"] = title
    _LOGGER.debug(
        "Maintenance Supporter sidebar panel registered (title=%s, v=%s)",
        title,
        version,
    )


async def async_unregister_panel(hass: HomeAssistant) -> None:
    """Remove the maintenance supporter sidebar panel."""
    if not hass.data.get(DOMAIN, {}).get("_panel_registered"):
        return

    frontend.async_remove_panel(hass, PANEL_NAME)
    hass.data.setdefault(DOMAIN, {})["_panel_registered"] = False
    _LOGGER.debug("Maintenance Supporter sidebar panel removed")