nniback / core /referrals /api.py
Kyrlos11's picture
Upload 842 files
22087d0 verified
Raw History Blame Contribute Delete
7.61 kB
from fastapi import APIRouter, Depends, HTTPException, Query
from pydantic import BaseModel
from typing import Optional, List, Dict, Any
from decimal import Decimal
from datetime import datetime
from core.utils.auth_utils import verify_and_get_user_id_from_jwt
from core.utils.logger import logger
from core.utils.config import config
from core.services.supabase import DBConnection
from .service import ReferralService
from .config import MAX_EARNABLE_CREDITS_FROM_REFERRAL
from core.utils.config import config
router = APIRouter(prefix="/referrals", tags=["referrals"])
class ReferralCodeResponse(BaseModel):
referral_code: str
referral_url: str
class ReferralStats(BaseModel):
referral_code: str
total_referrals: int
successful_referrals: int
total_credits_earned: Decimal
last_referral_at: Optional[datetime]
remaining_earnable_credits: Decimal
max_earnable_credits: Decimal
has_reached_limit: bool
class Referral(BaseModel):
id: str
referred_account_id: str
credits_awarded: Decimal
status: str
created_at: datetime
completed_at: Optional[datetime]
class ReferralListResponse(BaseModel):
referrals: List[Referral]
total_count: int
class ValidateReferralCodeRequest(BaseModel):
referral_code: str
class ValidateReferralCodeResponse(BaseModel):
valid: bool
referrer_id: Optional[str] = None
message: Optional[str] = None
class ReferralEmailRequest(BaseModel):
emails: List[str]
class ReferralEmailResponse(BaseModel):
success: bool
message: Optional[str] = None
results: Optional[List[Dict[str, Any]]] = None
def get_referral_service() -> ReferralService:
db = DBConnection()
return ReferralService(db)
@router.post("/code/refresh", response_model=ReferralCodeResponse)
async def refresh_referral_code(
user_id: str = Depends(verify_and_get_user_id_from_jwt),
service: ReferralService = Depends(get_referral_service)
):
try:
result = await service.expire_and_regenerate_code(user_id)
if not result.get('success'):
raise HTTPException(status_code=400, detail=result.get('message', 'Failed to refresh code'))
new_code = result.get('new_code')
frontend_url = config.FRONTEND_URL
referral_url = f"{frontend_url}/auth?ref={new_code}"
return ReferralCodeResponse(
referral_code=new_code,
referral_url=referral_url
)
except HTTPException:
raise
except Exception as e:
logger.error(f"Failed to refresh referral code: {e}", user_id=user_id)
raise HTTPException(status_code=500, detail="Failed to refresh referral code")
@router.get("/code", response_model=ReferralCodeResponse)
async def get_referral_code(
user_id: str = Depends(verify_and_get_user_id_from_jwt),
service: ReferralService = Depends(get_referral_service)
):
try:
referral_code = await service.get_or_create_referral_code(user_id)
frontend_url = config.FRONTEND_URL
referral_url = f"{frontend_url}/auth?ref={referral_code}"
return ReferralCodeResponse(
referral_code=referral_code,
referral_url=referral_url
)
except Exception as e:
logger.error(f"Failed to get referral code: {e}", user_id=user_id)
raise HTTPException(status_code=500, detail="Failed to get referral code")
@router.post("/validate", response_model=ValidateReferralCodeResponse)
async def validate_referral_code(
request: ValidateReferralCodeRequest,
user_id: str = Depends(verify_and_get_user_id_from_jwt),
service: ReferralService = Depends(get_referral_service)
):
try:
referrer_id = await service.validate_referral_code(request.referral_code)
if referrer_id:
if referrer_id == user_id:
return ValidateReferralCodeResponse(
valid=False,
message="You cannot use your own referral code"
)
return ValidateReferralCodeResponse(
valid=True,
referrer_id=referrer_id,
message="Valid referral code"
)
else:
return ValidateReferralCodeResponse(
valid=False,
message="Invalid referral code"
)
except Exception as e:
logger.error(f"Failed to validate referral code: {e}")
raise HTTPException(status_code=500, detail="Failed to validate referral code")
@router.get("/stats", response_model=ReferralStats)
async def get_referral_stats(
user_id: str = Depends(verify_and_get_user_id_from_jwt),
service: ReferralService = Depends(get_referral_service)
):
try:
stats = await service.get_referral_stats(user_id)
return ReferralStats(
referral_code=stats.get('referral_code', ''),
total_referrals=stats.get('total_referrals', 0),
successful_referrals=stats.get('successful_referrals', 0),
total_credits_earned=Decimal(str(stats.get('total_credits_earned', 0))),
last_referral_at=stats.get('last_referral_at'),
remaining_earnable_credits=Decimal(str(stats.get('remaining_earnable_credits', MAX_EARNABLE_CREDITS_FROM_REFERRAL))),
max_earnable_credits=Decimal(str(stats.get('max_earnable_credits', MAX_EARNABLE_CREDITS_FROM_REFERRAL))),
has_reached_limit=stats.get('has_reached_limit', False)
)
except Exception as e:
logger.error(f"Failed to get referral stats: {e}", user_id=user_id)
raise HTTPException(status_code=500, detail="Failed to get referral stats")
@router.get("/list", response_model=ReferralListResponse)
async def get_user_referrals(
limit: int = Query(50, ge=1, le=100),
offset: int = Query(0, ge=0),
user_id: str = Depends(verify_and_get_user_id_from_jwt),
service: ReferralService = Depends(get_referral_service)
):
try:
referrals_data = await service.get_user_referrals(user_id, limit, offset)
referrals = [
Referral(
id=r['id'],
referred_account_id=r['referred_account_id'],
credits_awarded=Decimal(str(r['credits_awarded'])),
status=r['status'],
created_at=r['created_at'],
completed_at=r.get('completed_at')
)
for r in referrals_data
]
return ReferralListResponse(
referrals=referrals,
total_count=len(referrals)
)
except Exception as e:
logger.error(f"Failed to get user referrals: {e}", user_id=user_id)
raise HTTPException(status_code=500, detail="Failed to get user referrals")
@router.post("/email", response_model=ReferralEmailResponse)
async def send_referral_email(
request: ReferralEmailRequest,
user_id: str = Depends(verify_and_get_user_id_from_jwt),
service: ReferralService = Depends(get_referral_service)
):
try:
result = await service.send_referral_emails(user_id, request.emails)
return ReferralEmailResponse(
success=result.get('success', False),
message=result.get('message'),
results=result.get('results', [])
)
except HTTPException:
raise
except Exception as e:
logger.error(f"Failed to send referral emails: {e}", user_id=user_id)
raise HTTPException(status_code=500, detail="Failed to send referral emails")