"""
Refractor Tier Completion Notifications

Builds and sends Discord embeds when a player completes a refractor tier
during post-game evaluation. Each tier-up event gets its own embed.

Notification failures are non-fatal: the send is wrapped in try/except so
a Discord API hiccup never disrupts game flow.
"""

import logging

import discord

from helpers.refractor_constants import TIER_NAMES, NOTIF_TIER_COLORS as TIER_COLORS

logger = logging.getLogger("discord_app")

FOOTER_TEXT = "Paper Dynasty Refractor"


def build_tier_up_embed(tier_up: dict, image_url: str | None = None) -> discord.Embed:
    """Build a Discord embed for a tier-up event.

    Parameters
    ----------
    tier_up:
        Dict with keys: player_name, old_tier, new_tier, current_value, track_name.
    image_url:
        Optional S3 URL for the newly rendered refractor card image. When
        provided, the card art is shown as the embed image.

    Returns
    -------
    discord.Embed
        A fully configured embed ready to send to a channel.
    """
    player_name: str = tier_up["player_name"]
    new_tier: int = tier_up["new_tier"]
    track_name: str = tier_up["track_name"]

    tier_name = TIER_NAMES.get(new_tier, f"Tier {new_tier}")
    color = TIER_COLORS.get(new_tier, 0x2ECC71)

    if new_tier >= 4:
        # Superfractor — special title and description.
        embed = discord.Embed(
            title="SUPERFRACTOR!",
            description=(
                f"**{player_name}** has reached maximum refractor tier on the **{track_name}** track"
            ),
            color=color,
        )
    else:
        embed = discord.Embed(
            title="Refractor Tier Up!",
            description=(
                f"**{player_name}** reached **Tier {new_tier} ({tier_name})** on the **{track_name}** track"
            ),
            color=color,
        )

    if image_url:
        embed.set_image(url=image_url)
    embed.set_footer(text=FOOTER_TEXT)
    return embed


async def notify_tier_completion(
    channel: discord.abc.Messageable, tier_up: dict, image_url: str | None = None
) -> None:
    """Send a tier-up notification embed to the given channel.

    Non-fatal: any exception during send is caught and logged so that a
    Discord API failure never interrupts game evaluation.

    Parameters
    ----------
    channel:
        A discord.abc.Messageable (e.g. discord.TextChannel).
    tier_up:
        Dict with keys: player_name, old_tier, new_tier, current_value, track_name.
    image_url:
        Optional S3 URL for the refractor card image. Passed through to
        build_tier_up_embed so the card art appears in the notification.
    """
    try:
        embed = build_tier_up_embed(tier_up, image_url=image_url)
        await channel.send(embed=embed)
    except Exception as exc:
        logger.error(
            "Failed to send tier-up notification for %s (tier %s): %s",
            tier_up.get("player_name", "unknown"),
            tier_up.get("new_tier"),
            exc,
        )