Files
2026-11-16 20:45:22 +08:00

161 lines
5.1 KiB
Python

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