"""Push notifications via Firebase Cloud Messaging.

TODO: Implement in Phase 2.
"""

import uuid


def send_zone_captured(
    victim_user_id: uuid.UUID, attacker_name: str, area_m2: float
) -> None:
    """Notify a user that their zone was partially captured."""
    # Phase 2: Use firebase-admin SDK to send FCM push
    pass


def send_leaderboard_change(user_id: uuid.UUID, new_rank: int) -> None:
    """Notify a user that their leaderboard position changed."""
    pass


def send_streak_at_risk(user_id: uuid.UUID, streak_days: int) -> None:
    """Notify a user that their streak is about to expire."""
    pass


def send_friend_joined(user_id: uuid.UUID, friend_name: str) -> None:
    """Notify a user that a friend just joined GeoZoner."""
    pass