from __future__ import annotations import json from collections.abc import Callable from dataclasses import dataclass from typing import Any from loguru import logger from sqlalchemy import select from sqlalchemy.orm import Session from sakura_cloud.core.config import settings from sakura_cloud.models.follow import UpdateAlert from sakura_cloud.models.mixins import utc_now from sakura_cloud.models.push import PushDeviceToken PushSender = Callable[[str, str, str, dict[str, str]], bool] @dataclass class PushSendSummary: attempted: int = 0 sent: int = 0 disabled: int = 0 failed: int = 0 def send_update_alert_push( db: Session, alert: UpdateAlert, *, sender: PushSender | None = None, ) -> PushSendSummary: payload = alert.payload_json or {} if alert.platform == "system": title = alert.title body = alert.body or "" else: title = "你关注的作者有新作品" author_name = ( payload.get("author_name") or payload.get("creator_name") or payload.get("creator_handle") or payload.get("author") or alert.creator_id ) body = f"{author_name} 发布了 {alert.title}" data = { "alert_id": alert.id, "source_platform": alert.platform, "source_id": str(payload.get("source_id") or payload.get("id") or alert.creator_id), "resource_type": str(payload.get("resource_type") or alert.content_type or ""), } return send_push_to_user(db, alert.user_id, title, body, data, sender=sender) def send_push_to_user( db: Session, user_id: str, title: str, body: str, data: dict[str, Any] | None = None, *, sender: PushSender | None = None, ) -> PushSendSummary: rows = db.scalars( select(PushDeviceToken).where( PushDeviceToken.user_id == user_id, PushDeviceToken.is_active.is_(True), ) ).all() summary = PushSendSummary(attempted=len(rows)) if not rows: return summary safe_data = {key: "" if value is None else str(value) for key, value in (data or {}).items()} disabled_any = False for row in rows: try: ok = sender(row.fcm_token, title, body, safe_data) if sender else _send_fcm(row.fcm_token, title, body, safe_data) except Exception as exc: # pragma: no cover - defensive guard around provider SDK. if _is_invalid_token_error(exc): _disable_token(row) disabled_any = True summary.disabled += 1 logger.warning("Disabled invalid FCM token for user={} device={}", user_id, row.device_id) else: summary.failed += 1 logger.warning("FCM push failed for user={} device={}: {}", user_id, row.device_id, exc.__class__.__name__) continue if ok: summary.sent += 1 logger.info("FCM push sent for user={} device={} alert={}", user_id, row.device_id, safe_data.get("alert_id", "")) else: _disable_token(row) disabled_any = True summary.disabled += 1 logger.warning("Disabled invalid FCM token for user={} device={}", user_id, row.device_id) if disabled_any: db.commit() return summary def _disable_token(row: PushDeviceToken) -> None: row.is_active = False row.last_seen_at = utc_now() def _send_fcm(token: str, title: str, body: str, data: dict[str, str]) -> bool: if not settings.fcm_enabled: logger.debug("FCM push skipped because FCM_ENABLED is false") return True app, messaging = _firebase_context() if app is None or messaging is None: logger.debug("FCM push skipped because Firebase credentials are not configured") return True message = messaging.Message( token=token, notification=messaging.Notification(title=title, body=body), data=data, android=messaging.AndroidConfig(priority="high"), ) messaging.send(message, app=app) return True def _firebase_context() -> tuple[Any | None, Any | None]: credential_json = settings.firebase_credentials_json.strip() credential_path = settings.firebase_credentials_path.strip() if not credential_json and not credential_path: return None, None try: import firebase_admin from firebase_admin import credentials, messaging except ImportError: logger.warning("firebase-admin is not installed; FCM push is disabled") return None, None if firebase_admin._apps: return firebase_admin.get_app(), messaging if credential_json: cred = credentials.Certificate(json.loads(credential_json)) else: cred = credentials.Certificate(credential_path) return firebase_admin.initialize_app(cred), messaging def _is_invalid_token_error(exc: Exception) -> bool: name = exc.__class__.__name__ if name in {"UnregisteredError", "SenderIdMismatchError", "InvalidArgumentError"}: return True text = str(exc).lower() return "registration token" in text or "not a valid fcm" in text or "unregistered" in text