discordbot/blue_archive/gacha.py

#this is the gacha cog for blue archive, handles all recruitment commands##
"""Blue Archive Gacha Simulator — in-game-accurate recruitment with live banners."""
######################################################################
import asyncio
import logging
from pathlib import Path
from typing import Optional

import discord
from discord.ext import commands

from . import db as gacha_db
from .data import (
    db,
    fetch_banners,
    format_banner_embed,
    roll_rarity,
    get_rates_for_banner,
    PULL10_RATES,
    DEFAULT_RATES,
)
from .gacha_renderer import render_pull

log = logging.getLogger(__name__)

SPARK_TARGET = 200
BANNER_FILE = Path("data/ba_banner_state.json")


def _load_banner_state() -> dict:
    """Which banner each user has picked. Lightweight JSON, separate from SQLite."""
    if BANNER_FILE.exists():
        import json
        with open(BANNER_FILE, "r") as f:
            return json.load(f)
    return {}


def _save_banner_state(state: dict) -> None:
    import json
    BANNER_FILE.parent.mkdir(parents=True, exist_ok=True)
    with open(BANNER_FILE, "w") as f:
        json.dump(state, f, indent=2)


def _get_banner_id(user_id: int) -> Optional[str]:
    state = _load_banner_state()
    return state.get(str(user_id))


def _set_banner_id(user_id: int, banner_id: Optional[str]) -> None:
    state = _load_banner_state()
    state[str(user_id)] = banner_id
    _save_banner_state(state)


class BlueArchiveGacha(commands.Cog):
    """Blue Archive recruitment simulator with live banners and in-game-style renders."""

    def __init__(self, bot: commands.Bot) -> None:
        self.bot = bot
        self._banner_cache: dict = {"current": [], "upcoming": [], "ended": []}
        self._cache_ready = asyncio.Event()

    # ── Lifecycle ───────────────────────────────────────────────────────

    async def cog_load(self) -> None:
        """Load student DB, init SQLite, and fetch banners on startup."""
        db.load()
        gacha_db.init_db()
        await self._refresh_banners()
        self._refresh_task = self.bot.loop.create_task(self._periodic_refresh())

    async def cog_unload(self) -> None:
        self._refresh_task.cancel()

    async def _refresh_banners(self) -> None:
        try:
            self._banner_cache = await fetch_banners()
        except Exception:
            log.exception("Banner refresh failed")
        finally:
            self._cache_ready.set()  # always unblock waiters, even on failure

    async def _periodic_refresh(self) -> None:
        while True:
            await asyncio.sleep(6 * 3600)  # 6 hours
            await self._refresh_banners()

    def _all_banners(self) -> list[dict]:
        """Return a flat list of all available (current + upcoming) banners for picking."""
        return self._banner_cache.get("current", []) + self._banner_cache.get("upcoming", [])

    # ── Commands ────────────────────────────────────────────────────────

    @commands.group(name="gacha", aliases=["banners", "g"], invoke_without_command=True)
    async def gacha(self, ctx: commands.Context) -> None:
        """Show currently active recruitment banners from the live API."""
        try:
            await asyncio.wait_for(self._cache_ready.wait(), timeout=15.0)
        except asyncio.TimeoutError:
            pass  # proceed with whatever we have
        banners = self._all_banners()

        if not banners:
            embed = discord.Embed(
                title="Recruitment",
                description="No active banners available right now.\n"
                            "Try the permanent **Regular Recruitment** banner instead:\n"
                            "`!gacha pick regular`",
                color=0x5BA0D0,
            )
            await ctx.reply(embed=embed)
            return

        # Build embed
        embed = discord.Embed(
            title="Recruitment — Available Banners",
            description="Use `!gacha pick <number>` to select a banner, then `!pull` to recruit!\n"
                        "Or `!gacha pick regular` for the permanent banner.\n"
                        "`!gacha info` to see your status.",
            color=0x5BA0D0,
        )

        for i, banner in enumerate(banners[:8]):  # Discord embed field limit
            embed.add_field(
                name="",
                value=format_banner_embed(banner, i),
                inline=False,
            )

        embed.set_footer(text="Banner data from BlueArchiveAPI • Updates every 6 hours")
        await ctx.reply(embed=embed)

    @gacha.command(name="pick")
    async def gacha_pick(self, ctx: commands.Context, *, choice: str = "") -> None:
        """Select your active recruitment banner.

        Usage: !gacha pick <number>  or  !gacha pick regular
        """
        choice = choice.strip().lower()
        if not choice:
            await ctx.reply("Usage: `!gacha pick <number>` or `!gacha pick regular`")
            return

        if choice == "regular":
            _set_banner_id(ctx.author.id, "regular")
            await ctx.reply(
                "Active banner set to **Regular Recruitment** (permanent pool, no rate-up).\n"
                "Use `!pull` to recruit!"
            )
            return

        # Try numeric pick from banner list
        try:
            idx = int(choice) - 1
        except ValueError:
            await ctx.reply("Usage: `!gacha pick <number>` or `!gacha pick regular`")
            return

        try:
            await asyncio.wait_for(self._cache_ready.wait(), timeout=15.0)
        except asyncio.TimeoutError:
            pass
        banners = self._all_banners()

        if idx < 0 or idx >= len(banners):
            await ctx.reply(f"Invalid banner number. There are {len(banners)} banners available (1–{len(banners)}).")
            return

        banner = banners[idx]
        rateups = ", ".join(banner.get("rateups", [])) or "Standard Pool"
        gtype = banner.get("gachaType", "PickupGacha")

        _set_banner_id(ctx.author.id, str(banner["id"]))

        # Show current spark for this banner
        spark = gacha_db.get_spark(ctx.author.id, str(banner["id"]))

        await ctx.reply(
            f"Active banner: **{gtype}**\n"
            f"Rate-up: {rateups}\n"
            f"Recruitment Points: {spark}/{SPARK_TARGET}. Use `!pull` to recruit!"
        )

    @commands.command(name="pull")
    async def pull_gacha(self, ctx: commands.Context, *, mode: str = "10") -> None:
        """Pull on your active recruitment banner.

        Usage: !pull         (10-pull with guaranteed 2★+ on 10th)
               !pull single  (1-pull)
        """
        mode = mode.strip().lower()
        if mode in ("single", "1", "one"):
            count = 1
        else:
            count = 10

        user_id = ctx.author.id
        banner_id = _get_banner_id(user_id)

        # Determine banner info
        try:
            await asyncio.wait_for(self._cache_ready.wait(), timeout=15.0)
        except asyncio.TimeoutError:
            pass
        banner = None
        banner_name = "Regular Recruitment"
        rates = DEFAULT_RATES

        if banner_id and banner_id != "regular":
            for b in self._all_banners():
                if b["id"] == banner_id:
                    banner = b
                    break
            if banner:
                rateups = ", ".join(banner.get("rateups", [])) or "Standard Pool"
                gtype = banner.get("gachaType", "PickupGacha")
                banner_name = f"{gtype} — {rateups}"
                rates = get_rates_for_banner(banner)

        # "Opening envelope" teaser
        teaser = await ctx.reply("Opening recruitment envelope" + ("s..." if count > 1 else "..."))

        # Build the banner-specific character pool
        if banner_id and banner_id != "regular" and banner:
            pool = db.build_pool(banner)
            rateup_names = [n.lower() for n in banner.get("rateups", [])]
        else:
            pool = db.build_pool(None)  # regular recruitment
            rateup_names = []

        # Perform pulls
        pulls = []
        for i in range(count):
            # 10th pull guarantee
            r = rates
            if count == 10 and i == 9:
                r = PULL10_RATES

            rarity = roll_rarity(r)
            rarity_pool = pool.get(rarity, [])
            if rarity_pool:
                student = db.weighted_pick(rarity_pool, rateup_names, rarity)
            else:
                student = db.random_by_rarity(rarity)  # fallback

            pulls.append(student)

        # Save pulls to inventory (eligma for dupes) and update spark
        user_id = ctx.author.id
        spark_banner = str(banner_id) if banner_id else "regular"
        spark = gacha_db.add_spark(user_id, spark_banner, count)

        eligma_earned = 0
        for p in pulls:
            e = gacha_db.add_pull(user_id, p["Id"], p["StarGrade"])
            eligma_earned += e

        dupe_msg = f" | +{eligma_earned} Eligma from dupes" if eligma_earned else ""

        # Render result image
        try:
            async with ctx.typing():
                img_bytes = await render_pull(pulls, banner_name, spark)
        except Exception as e:
            log.exception("Render failed")
            try:
                await teaser.delete()
            except (discord.NotFound, discord.Forbidden):
                pass
            await ctx.reply(f"Render failed: {e}")
            return

        # Send image with spark+eligma caption
        try:
            file = discord.File(img_bytes, filename="gacha_result.png")
            try:
                await teaser.delete()
            except (discord.NotFound, discord.Forbidden):
                pass
            await ctx.reply(
                f"Recruitment Points: {spark}/{SPARK_TARGET}{dupe_msg}",
                file=file,
            )
        except Exception as e:
            log.exception("Failed to send result image")
            await ctx.reply(f"Failed to send result: {e}")

    @commands.command(name="spark")
    async def spark(self, ctx: commands.Context, *, character_name: str = "") -> None:
        """Claim a rate-up student using 200 Recruitment Points from your active banner.

        Usage: !spark <character name>
        """
        if not character_name:
            await ctx.reply("Usage: `!spark <character name>` — e.g., `!spark Aru`")
            return

        user_id = ctx.author.id
        banner_id = str(_get_banner_id(user_id) or "regular")
        spark = gacha_db.get_spark(user_id, banner_id)

        if spark < SPARK_TARGET:
            await ctx.reply(
                f"You need {SPARK_TARGET} Recruitment Points to spark. "
                f"You have {spark} on this banner."
            )
            return

        # Check if character exists
        student = db.get_by_name(character_name)
        if not student:
            await ctx.reply(f"Character **{character_name}** not found in the database.")
            return

        # Deduct spark and add student to inventory
        if not gacha_db.spend_spark(user_id, banner_id):
            await ctx.reply("Not enough Recruitment Points.")
            return
        gacha_db.add_pull(user_id, student["Id"], student["StarGrade"])
        remaining = gacha_db.get_spark(user_id, banner_id)

        await ctx.reply(
            f"**Spark!** You claimed **{student['Name']}** "
            f"({student['StarGrade']}*, {student.get('School', 'Unknown')})!\n"
            f"Remaining Recruitment Points: {remaining}"
        )

    @gacha.command(name="info")
    async def gacha_info(self, ctx: commands.Context) -> None:
        """Show your active banner, spark count, and collection summary."""
        user_id = ctx.author.id
        banner_id = str(_get_banner_id(user_id) or "regular")
        spark = gacha_db.get_spark(user_id, banner_id)

        # Banner name
        banner_name = "Regular Recruitment"
        if banner_id and banner_id != "regular":
            for b in self._all_banners():
                if b["id"] == banner_id:
                    rateups = ", ".join(b.get("rateups", [])) or "Standard Pool"
                    banner_name = f"{b.get('gachaType', 'PickupGacha')} — {rateups}"
                    break

        # Recent pulls
        recent = []
        for sid in reversed(history[-5:]):
            s = db.get(sid)
            if s:
                recent.append(f"{'*' * s['StarGrade']} {s['Name']}")

        embed = discord.Embed(
            title="Your Gacha Status",
            color=0x5BA0D0,
        )
        embed.add_field(name="Active Banner", value=banner_name, inline=False)
        embed.add_field(
            name="Recruitment Points", value=f"{spark}/{SPARK_TARGET}", inline=True
        )
        embed.add_field(
            name="Eligma", value=str(gacha_db.get_eligma(user_id)), inline=True
        )
        stats = gacha_db.get_inventory_stats(user_id)
        embed.add_field(
            name="Collection",
            value=f"{stats['unique']} unique students from {stats['total_pulls']} total pulls",
            inline=False,
        )

        await ctx.reply(embed=embed)


async def setup(bot: commands.Bot) -> None:
    await bot.add_cog(BlueArchiveGacha(bot))