notification_service.py 42 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055
  1. """Notification service for sending push notifications via various providers."""
  2. import asyncio
  3. import json
  4. import logging
  5. import re
  6. import smtplib
  7. from datetime import datetime
  8. from email.mime.multipart import MIMEMultipart
  9. from email.mime.text import MIMEText
  10. from typing import Any
  11. from urllib.parse import quote
  12. import httpx
  13. from sqlalchemy import select
  14. from sqlalchemy.ext.asyncio import AsyncSession
  15. from backend.app.models.notification import NotificationDigestQueue, NotificationLog, NotificationProvider
  16. from backend.app.models.notification_template import NotificationTemplate
  17. logger = logging.getLogger(__name__)
  18. class NotificationService:
  19. """Service for sending notifications through various providers."""
  20. def __init__(self):
  21. self._http_client: httpx.AsyncClient | None = None
  22. self._template_cache: dict[str, NotificationTemplate] = {}
  23. self._digest_scheduler_task: asyncio.Task | None = None
  24. self._last_digest_check: str = "" # "HH:MM" to avoid duplicate checks
  25. async def _get_client(self) -> httpx.AsyncClient:
  26. """Get or create HTTP client."""
  27. if self._http_client is None or self._http_client.is_closed:
  28. self._http_client = httpx.AsyncClient(timeout=30.0)
  29. return self._http_client
  30. async def close(self):
  31. """Close HTTP client."""
  32. if self._http_client and not self._http_client.is_closed:
  33. await self._http_client.aclose()
  34. def _is_in_quiet_hours(self, provider: NotificationProvider) -> bool:
  35. """Check if current time is within provider's quiet hours."""
  36. if not provider.quiet_hours_enabled:
  37. return False
  38. if not provider.quiet_hours_start or not provider.quiet_hours_end:
  39. return False
  40. try:
  41. now = datetime.now()
  42. current_time = now.hour * 60 + now.minute
  43. start_parts = provider.quiet_hours_start.split(":")
  44. end_parts = provider.quiet_hours_end.split(":")
  45. start_minutes = int(start_parts[0]) * 60 + int(start_parts[1])
  46. end_minutes = int(end_parts[0]) * 60 + int(end_parts[1])
  47. # Handle overnight quiet hours (e.g., 22:00 to 07:00)
  48. if start_minutes > end_minutes:
  49. # Quiet hours span midnight
  50. return current_time >= start_minutes or current_time < end_minutes
  51. else:
  52. # Same day quiet hours
  53. return start_minutes <= current_time < end_minutes
  54. except (ValueError, TypeError, AttributeError):
  55. logger.warning(f"Invalid quiet hours format for provider {provider.name}")
  56. return False
  57. async def _get_template(self, db: AsyncSession, event_type: str) -> NotificationTemplate | None:
  58. """Get a notification template by event type."""
  59. # Check cache first
  60. if event_type in self._template_cache:
  61. return self._template_cache[event_type]
  62. result = await db.execute(select(NotificationTemplate).where(NotificationTemplate.event_type == event_type))
  63. template = result.scalar_one_or_none()
  64. if template:
  65. self._template_cache[event_type] = template
  66. return template
  67. def _render_template(self, template_str: str, variables: dict[str, Any]) -> str:
  68. """Render a template string with variables. Missing variables become empty."""
  69. result = template_str
  70. for key, value in variables.items():
  71. result = result.replace("{" + key + "}", str(value) if value is not None else "")
  72. # Remove any remaining unreplaced placeholders
  73. result = re.sub(r"\{[a-z_]+\}", "", result)
  74. return result
  75. def _format_duration(self, seconds: int | None) -> str:
  76. """Format duration in seconds to human-readable string."""
  77. if seconds is None:
  78. return "Unknown"
  79. hours = seconds // 3600
  80. minutes = (seconds % 3600) // 60
  81. if hours > 0:
  82. return f"{hours}h {minutes}m"
  83. return f"{minutes}m"
  84. def _clean_filename(self, filename: str) -> str:
  85. """Extract filename and remove file extensions."""
  86. import os
  87. # Strip path prefix (e.g., /data/Metadata/plate_5.gcode -> plate_5.gcode)
  88. filename = os.path.basename(filename)
  89. # Remove common extensions
  90. if filename.endswith(".gcode.3mf"):
  91. return filename[:-10]
  92. elif filename.endswith(".gcode"):
  93. return filename[:-6]
  94. elif filename.endswith(".3mf"):
  95. return filename[:-4]
  96. return filename
  97. async def _build_message_from_template(
  98. self, db: AsyncSession, event_type: str, variables: dict[str, Any]
  99. ) -> tuple[str, str]:
  100. """Build notification title and body from template."""
  101. # Add common variables
  102. variables["timestamp"] = datetime.now().strftime("%Y-%m-%d %H:%M")
  103. variables["app_name"] = "Bambuddy"
  104. template = await self._get_template(db, event_type)
  105. if not template:
  106. # Fallback to simple message
  107. logger.warning(f"Template not found for event type: {event_type}")
  108. return event_type.replace("_", " ").title(), str(variables)
  109. title = self._render_template(template.title_template, variables)
  110. body = self._render_template(template.body_template, variables)
  111. return title, body
  112. async def send_test_notification(
  113. self, provider_type: str, config: dict[str, Any], db: AsyncSession | None = None
  114. ) -> tuple[bool, str]:
  115. """Send a test notification to verify configuration."""
  116. if db:
  117. title, message = await self._build_message_from_template(db, "test", {})
  118. else:
  119. title = "Bambuddy Test"
  120. message = "This is a test notification. If you see this, notifications are working!"
  121. try:
  122. if provider_type == "callmebot":
  123. return await self._send_callmebot(config, f"{title}\n{message}")
  124. elif provider_type == "ntfy":
  125. return await self._send_ntfy(config, title, message)
  126. elif provider_type == "pushover":
  127. return await self._send_pushover(config, title, message)
  128. elif provider_type == "telegram":
  129. return await self._send_telegram(config, f"*{title}*\n{message}")
  130. elif provider_type == "email":
  131. return await self._send_email(config, title, message)
  132. elif provider_type == "discord":
  133. return await self._send_discord(config, title, message)
  134. elif provider_type == "webhook":
  135. return await self._send_webhook(config, title, message)
  136. else:
  137. return False, f"Unknown provider type: {provider_type}"
  138. except Exception as e:
  139. logger.exception(f"Error sending test notification via {provider_type}")
  140. return False, str(e)
  141. async def _send_callmebot(self, config: dict, message: str) -> tuple[bool, str]:
  142. """Send notification via CallMeBot (WhatsApp)."""
  143. phone = config.get("phone", "").strip()
  144. apikey = config.get("apikey", "").strip()
  145. if not phone or not apikey:
  146. return False, "Phone number and API key are required"
  147. # URL encode the message
  148. encoded_message = quote(message)
  149. url = f"https://api.callmebot.com/whatsapp.php?phone={phone}&text={encoded_message}&apikey={apikey}"
  150. client = await self._get_client()
  151. response = await client.get(url)
  152. if response.status_code == 200:
  153. return True, "Message sent successfully"
  154. else:
  155. return False, f"HTTP {response.status_code}: {response.text[:200]}"
  156. async def _send_ntfy(self, config: dict, title: str, message: str) -> tuple[bool, str]:
  157. """Send notification via ntfy."""
  158. server = config.get("server", "https://ntfy.sh").rstrip("/")
  159. topic = config.get("topic", "").strip()
  160. auth_token = config.get("auth_token", "").strip()
  161. if not topic:
  162. return False, "Topic is required"
  163. url = f"{server}/{topic}"
  164. headers = {"Title": title}
  165. if auth_token:
  166. headers["Authorization"] = f"Bearer {auth_token}"
  167. client = await self._get_client()
  168. response = await client.post(url, content=message, headers=headers)
  169. if response.status_code in (200, 204):
  170. return True, "Message sent successfully"
  171. else:
  172. return False, f"HTTP {response.status_code}: {response.text[:200]}"
  173. async def _send_pushover(self, config: dict, title: str, message: str) -> tuple[bool, str]:
  174. """Send notification via Pushover."""
  175. user_key = config.get("user_key", "").strip()
  176. app_token = config.get("app_token", "").strip()
  177. priority = config.get("priority", 0)
  178. if not user_key or not app_token:
  179. return False, "User key and app token are required"
  180. url = "https://api.pushover.net/1/messages.json"
  181. data = {
  182. "token": app_token,
  183. "user": user_key,
  184. "title": title,
  185. "message": message,
  186. "priority": priority,
  187. }
  188. client = await self._get_client()
  189. response = await client.post(url, data=data)
  190. if response.status_code == 200:
  191. return True, "Message sent successfully"
  192. else:
  193. try:
  194. error_data = response.json()
  195. errors = error_data.get("errors", [])
  196. return False, f"Pushover error: {', '.join(errors)}"
  197. except Exception:
  198. return False, f"HTTP {response.status_code}: {response.text[:200]}"
  199. async def _send_telegram(self, config: dict, message: str) -> tuple[bool, str]:
  200. """Send notification via Telegram bot."""
  201. bot_token = config.get("bot_token", "").strip()
  202. chat_id = config.get("chat_id", "").strip()
  203. if not bot_token or not chat_id:
  204. return False, "Bot token and chat ID are required"
  205. url = f"https://api.telegram.org/bot{bot_token}/sendMessage"
  206. data = {
  207. "chat_id": chat_id,
  208. "text": message,
  209. "parse_mode": "Markdown",
  210. }
  211. client = await self._get_client()
  212. response = await client.post(url, json=data)
  213. if response.status_code == 200:
  214. result = response.json()
  215. if result.get("ok"):
  216. return True, "Message sent successfully"
  217. else:
  218. return False, f"Telegram error: {result.get('description', 'Unknown error')}"
  219. else:
  220. return False, f"HTTP {response.status_code}: {response.text[:200]}"
  221. async def _send_email(self, config: dict, subject: str, body: str) -> tuple[bool, str]:
  222. """Send notification via email (SMTP)."""
  223. smtp_server = config.get("smtp_server", "").strip()
  224. smtp_port = int(config.get("smtp_port", 587))
  225. username = config.get("username", "").strip()
  226. password = config.get("password", "").strip()
  227. from_email = config.get("from_email", "").strip()
  228. to_email = config.get("to_email", "").strip()
  229. # Security: "starttls" (port 587), "ssl" (port 465), "none" (port 25)
  230. security = config.get("security", "starttls")
  231. # Authentication: "true" or "false"
  232. auth_enabled = config.get("auth_enabled", "true").lower() == "true"
  233. if not all([smtp_server, from_email, to_email]):
  234. return False, "SMTP server, from email, and to email are required"
  235. if auth_enabled and not all([username, password]):
  236. return False, "Username and password are required when authentication is enabled"
  237. try:
  238. msg = MIMEMultipart()
  239. msg["From"] = from_email
  240. msg["To"] = to_email
  241. msg["Subject"] = f"[Bambuddy] {subject}"
  242. msg.attach(MIMEText(body, "plain"))
  243. if security == "ssl":
  244. # Direct SSL connection (typically port 465)
  245. server = smtplib.SMTP_SSL(smtp_server, smtp_port)
  246. elif security == "starttls":
  247. # STARTTLS upgrade (typically port 587)
  248. server = smtplib.SMTP(smtp_server, smtp_port)
  249. server.starttls()
  250. else:
  251. # No encryption (typically port 25) - use with caution
  252. server = smtplib.SMTP(smtp_server, smtp_port)
  253. if auth_enabled:
  254. server.login(username, password)
  255. server.sendmail(from_email, to_email, msg.as_string())
  256. server.quit()
  257. return True, "Email sent successfully"
  258. except smtplib.SMTPAuthenticationError:
  259. return False, "SMTP authentication failed - check username/password"
  260. except smtplib.SMTPException as e:
  261. return False, f"SMTP error: {str(e)}"
  262. except Exception as e:
  263. return False, f"Email error: {str(e)}"
  264. async def _send_discord(self, config: dict, title: str, message: str) -> tuple[bool, str]:
  265. """Send notification via Discord webhook."""
  266. webhook_url = config.get("webhook_url", "").strip()
  267. if not webhook_url:
  268. return False, "Webhook URL is required"
  269. if not webhook_url.startswith("https://discord.com/api/webhooks/"):
  270. return False, "Invalid Discord webhook URL"
  271. # Discord embed format for nicer messages
  272. data = {
  273. "embeds": [
  274. {
  275. "title": title,
  276. "description": message,
  277. "color": 0x00AE42, # Bambu green
  278. }
  279. ]
  280. }
  281. client = await self._get_client()
  282. response = await client.post(webhook_url, json=data)
  283. if response.status_code in (200, 204):
  284. return True, "Message sent successfully"
  285. else:
  286. return False, f"HTTP {response.status_code}: {response.text[:200]}"
  287. async def _send_webhook(self, config: dict, title: str, message: str) -> tuple[bool, str]:
  288. """Send notification via generic webhook (POST JSON)."""
  289. webhook_url = config.get("webhook_url", "").strip()
  290. auth_header = config.get("auth_header", "").strip()
  291. custom_field_title = config.get("field_title", "title").strip() or "title"
  292. custom_field_message = config.get("field_message", "message").strip() or "message"
  293. if not webhook_url:
  294. return False, "Webhook URL is required"
  295. # Build payload with custom field names
  296. data = {
  297. custom_field_title: title,
  298. custom_field_message: message,
  299. "timestamp": datetime.now().isoformat(),
  300. "source": "Bambuddy",
  301. }
  302. headers = {"Content-Type": "application/json"}
  303. if auth_header:
  304. # Support "Bearer token" or just "token" format
  305. if " " in auth_header:
  306. headers["Authorization"] = auth_header
  307. else:
  308. headers["Authorization"] = f"Bearer {auth_header}"
  309. client = await self._get_client()
  310. try:
  311. response = await client.post(webhook_url, json=data, headers=headers)
  312. if response.status_code in (200, 201, 202, 204):
  313. return True, "Webhook delivered successfully"
  314. else:
  315. return False, f"HTTP {response.status_code}: {response.text[:200]}"
  316. except Exception as e:
  317. return False, f"Webhook error: {str(e)}"
  318. async def _send_to_provider(
  319. self, provider: NotificationProvider, title: str, message: str, db: AsyncSession | None = None
  320. ) -> tuple[bool, str]:
  321. """Send notification to a specific provider."""
  322. # Check quiet hours
  323. if self._is_in_quiet_hours(provider):
  324. logger.info(f"Skipping notification to {provider.name} - quiet hours active")
  325. return True, "Skipped - quiet hours"
  326. config = json.loads(provider.config) if isinstance(provider.config, str) else provider.config
  327. try:
  328. if provider.provider_type == "callmebot":
  329. return await self._send_callmebot(config, f"{title}\n{message}")
  330. elif provider.provider_type == "ntfy":
  331. return await self._send_ntfy(config, title, message)
  332. elif provider.provider_type == "pushover":
  333. return await self._send_pushover(config, title, message)
  334. elif provider.provider_type == "telegram":
  335. return await self._send_telegram(config, f"*{title}*\n{message}")
  336. elif provider.provider_type == "email":
  337. return await self._send_email(config, title, message)
  338. elif provider.provider_type == "discord":
  339. return await self._send_discord(config, title, message)
  340. elif provider.provider_type == "webhook":
  341. return await self._send_webhook(config, title, message)
  342. else:
  343. return False, f"Unknown provider type: {provider.provider_type}"
  344. except Exception as e:
  345. logger.exception(f"Error sending notification via {provider.provider_type}")
  346. return False, str(e)
  347. async def _update_provider_status(
  348. self, db: AsyncSession, provider_id: int, success: bool, error: str | None = None
  349. ):
  350. """Update provider status after sending notification."""
  351. result = await db.execute(select(NotificationProvider).where(NotificationProvider.id == provider_id))
  352. provider = result.scalar_one_or_none()
  353. if provider:
  354. if success:
  355. provider.last_success = datetime.utcnow()
  356. else:
  357. provider.last_error = error
  358. provider.last_error_at = datetime.utcnow()
  359. await db.commit()
  360. async def _get_providers_for_event(
  361. self,
  362. db: AsyncSession,
  363. event_field: str,
  364. printer_id: int | None = None,
  365. ) -> list[NotificationProvider]:
  366. """Get all enabled providers that want a specific event type."""
  367. # Build the query dynamically based on event field
  368. query = select(NotificationProvider).where(
  369. NotificationProvider.enabled.is_(True),
  370. getattr(NotificationProvider, event_field).is_(True),
  371. )
  372. if printer_id is not None:
  373. query = query.where(
  374. (NotificationProvider.printer_id.is_(None)) | (NotificationProvider.printer_id == printer_id)
  375. )
  376. result = await db.execute(query)
  377. return list(result.scalars().all())
  378. async def _log_notification(
  379. self,
  380. db: AsyncSession,
  381. provider_id: int,
  382. event_type: str,
  383. title: str,
  384. message: str,
  385. success: bool,
  386. error_message: str | None = None,
  387. printer_id: int | None = None,
  388. printer_name: str | None = None,
  389. ):
  390. """Create a log entry for a sent notification."""
  391. try:
  392. log = NotificationLog(
  393. provider_id=provider_id,
  394. event_type=event_type,
  395. title=title,
  396. message=message,
  397. success=success,
  398. error_message=error_message,
  399. printer_id=printer_id,
  400. printer_name=printer_name,
  401. )
  402. db.add(log)
  403. await db.commit()
  404. except Exception as e:
  405. logger.warning(f"Failed to log notification: {e}")
  406. # Don't fail the notification just because logging failed
  407. async def _send_to_providers(
  408. self,
  409. providers: list[NotificationProvider],
  410. title: str,
  411. message: str,
  412. db: AsyncSession,
  413. event_type: str = "unknown",
  414. printer_id: int | None = None,
  415. printer_name: str | None = None,
  416. force_immediate: bool = False,
  417. ):
  418. """Send notification to multiple providers and log the results.
  419. All notifications are always sent immediately. If digest mode is enabled,
  420. the notification is ALSO queued for the daily digest summary.
  421. """
  422. for provider in providers:
  423. try:
  424. # Always send notification immediately
  425. success, error = await self._send_to_provider(provider, title, message, db)
  426. # Also queue for digest if enabled (digest is a summary, not a queue)
  427. if provider.daily_digest_enabled and provider.daily_digest_time:
  428. await self._queue_for_digest(
  429. provider=provider,
  430. event_type=event_type,
  431. title=title,
  432. message=message,
  433. db=db,
  434. printer_id=printer_id,
  435. printer_name=printer_name,
  436. )
  437. await self._update_provider_status(db, provider.id, success, error if not success else None)
  438. await self._log_notification(
  439. db=db,
  440. provider_id=provider.id,
  441. event_type=event_type,
  442. title=title,
  443. message=message,
  444. success=success,
  445. error_message=error if not success else None,
  446. printer_id=printer_id,
  447. printer_name=printer_name,
  448. )
  449. if success:
  450. logger.info(f"Sent notification via {provider.name}")
  451. else:
  452. logger.warning(f"Failed to send notification via {provider.name}: {error}")
  453. except Exception as e:
  454. logger.exception(f"Error sending notification via {provider.name}")
  455. await self._update_provider_status(db, provider.id, False, str(e))
  456. await self._log_notification(
  457. db=db,
  458. provider_id=provider.id,
  459. event_type=event_type,
  460. title=title,
  461. message=message,
  462. success=False,
  463. error_message=str(e),
  464. printer_id=printer_id,
  465. printer_name=printer_name,
  466. )
  467. async def on_print_start(
  468. self,
  469. printer_id: int,
  470. printer_name: str,
  471. data: dict,
  472. db: AsyncSession,
  473. archive_data: dict | None = None,
  474. ):
  475. """Handle print start event - send notifications to relevant providers.
  476. Args:
  477. printer_id: The printer ID
  478. printer_name: The printer name
  479. data: MQTT event data with filename, subtask_name, remaining_time, raw_data
  480. db: Database session
  481. archive_data: Optional archive data with print_time_seconds from 3MF parsing
  482. """
  483. logger.info(f"on_print_start called for printer {printer_id} ({printer_name})")
  484. providers = await self._get_providers_for_event(db, "on_print_start", printer_id)
  485. if not providers:
  486. logger.info(f"No notification providers configured for print_start event on printer {printer_id}")
  487. return
  488. # Use subtask_name (project name) if available, otherwise use filename
  489. subtask_name = data.get("subtask_name")
  490. if subtask_name:
  491. # Replace underscores with spaces for readability
  492. filename = subtask_name.replace("_", " ")
  493. else:
  494. filename = self._clean_filename(data.get("filename", "Unknown"))
  495. # Priority for estimated_time:
  496. # 1. Archive's print_time_seconds from 3MF parsing (most reliable)
  497. # 2. MQTT remaining_time (may be 0 at print start)
  498. # 3. raw_data mc_remaining_time
  499. estimated_time = None
  500. # Try archive data first (from 3MF parsing - most reliable)
  501. if archive_data and archive_data.get("print_time_seconds"):
  502. estimated_time = archive_data["print_time_seconds"]
  503. logger.debug(f"Using print_time_seconds from archive: {estimated_time}")
  504. # Fall back to MQTT remaining_time
  505. if estimated_time is None:
  506. estimated_time = data.get("remaining_time")
  507. if estimated_time:
  508. logger.debug(f"Using remaining_time from MQTT: {estimated_time}")
  509. # Last resort: raw_data mc_remaining_time (in minutes, convert to seconds)
  510. if estimated_time is None:
  511. raw_time = data.get("raw_data", {}).get("mc_remaining_time")
  512. if raw_time:
  513. estimated_time = raw_time * 60
  514. logger.debug(f"Using mc_remaining_time from raw_data: {estimated_time}")
  515. time_str = self._format_duration(estimated_time)
  516. variables = {
  517. "printer": printer_name,
  518. "filename": filename,
  519. "estimated_time": time_str,
  520. }
  521. logger.info(f"Found {len(providers)} providers for print_start: {[p.name for p in providers]}")
  522. title, message = await self._build_message_from_template(db, "print_start", variables)
  523. await self._send_to_providers(providers, title, message, db, "print_start", printer_id, printer_name)
  524. async def on_print_complete(
  525. self,
  526. printer_id: int,
  527. printer_name: str,
  528. status: str,
  529. data: dict,
  530. db: AsyncSession,
  531. archive_data: dict | None = None,
  532. ):
  533. """Handle print complete event - send notifications to relevant providers."""
  534. logger.info(f"on_print_complete called for printer {printer_id} ({printer_name}), status={status}")
  535. # Determine event type based on status
  536. if status == "completed":
  537. event_field = "on_print_complete"
  538. event_type = "print_complete"
  539. elif status in ("failed",):
  540. event_field = "on_print_failed"
  541. event_type = "print_failed"
  542. elif status in ("aborted", "stopped", "cancelled"):
  543. event_field = "on_print_stopped"
  544. event_type = "print_stopped"
  545. else:
  546. logger.warning(f"Unknown print status '{status}', defaulting to on_print_complete")
  547. event_field = "on_print_complete"
  548. event_type = "print_complete"
  549. providers = await self._get_providers_for_event(db, event_field, printer_id)
  550. if not providers:
  551. logger.info(f"No notification providers configured for {event_field} event on printer {printer_id}")
  552. return
  553. # Use subtask_name (project name) if available, otherwise use filename
  554. subtask_name = data.get("subtask_name")
  555. if subtask_name:
  556. filename = subtask_name.replace("_", " ")
  557. else:
  558. filename = self._clean_filename(data.get("filename", "Unknown"))
  559. variables = {
  560. "printer": printer_name,
  561. "filename": filename,
  562. "duration": "Unknown",
  563. "filament_grams": "Unknown",
  564. "reason": "Unknown",
  565. }
  566. if archive_data:
  567. if archive_data.get("print_time_seconds"):
  568. variables["duration"] = self._format_duration(archive_data["print_time_seconds"])
  569. if archive_data.get("actual_filament_grams"):
  570. variables["filament_grams"] = f"{archive_data['actual_filament_grams']:.1f}"
  571. if status == "failed" and archive_data.get("failure_reason"):
  572. variables["reason"] = archive_data["failure_reason"]
  573. logger.info(f"on_print_complete variables: {variables}, archive_data: {archive_data}")
  574. logger.info(f"Found {len(providers)} providers for {event_field}: {[p.name for p in providers]}")
  575. title, message = await self._build_message_from_template(db, event_type, variables)
  576. await self._send_to_providers(providers, title, message, db, event_type, printer_id, printer_name)
  577. async def on_print_progress(
  578. self,
  579. printer_id: int,
  580. printer_name: str,
  581. filename: str,
  582. progress: int,
  583. db: AsyncSession,
  584. remaining_time: int | None = None,
  585. ):
  586. """Handle print progress milestone (25%, 50%, 75%)."""
  587. providers = await self._get_providers_for_event(db, "on_print_progress", printer_id)
  588. if not providers:
  589. return
  590. variables = {
  591. "printer": printer_name,
  592. "filename": self._clean_filename(filename),
  593. "progress": str(progress),
  594. "remaining_time": self._format_duration(remaining_time) if remaining_time else "Unknown",
  595. }
  596. title, message = await self._build_message_from_template(db, "print_progress", variables)
  597. await self._send_to_providers(providers, title, message, db, "print_progress", printer_id, printer_name)
  598. async def on_printer_offline(self, printer_id: int, printer_name: str, db: AsyncSession):
  599. """Handle printer offline event."""
  600. providers = await self._get_providers_for_event(db, "on_printer_offline", printer_id)
  601. if not providers:
  602. return
  603. variables = {"printer": printer_name}
  604. title, message = await self._build_message_from_template(db, "printer_offline", variables)
  605. await self._send_to_providers(providers, title, message, db, "printer_offline", printer_id, printer_name)
  606. async def on_printer_error(
  607. self,
  608. printer_id: int,
  609. printer_name: str,
  610. error_type: str,
  611. db: AsyncSession,
  612. error_detail: str | None = None,
  613. ):
  614. """Handle printer error event (AMS issues, etc.)."""
  615. providers = await self._get_providers_for_event(db, "on_printer_error", printer_id)
  616. if not providers:
  617. return
  618. variables = {
  619. "printer": printer_name,
  620. "error_type": error_type,
  621. "error_detail": error_detail or "No details available",
  622. }
  623. title, message = await self._build_message_from_template(db, "printer_error", variables)
  624. await self._send_to_providers(providers, title, message, db, "printer_error", printer_id, printer_name)
  625. async def on_filament_low(
  626. self,
  627. printer_id: int,
  628. printer_name: str,
  629. slot: int,
  630. remaining_percent: int,
  631. db: AsyncSession,
  632. color: str | None = None,
  633. ):
  634. """Handle low filament event."""
  635. providers = await self._get_providers_for_event(db, "on_filament_low", printer_id)
  636. if not providers:
  637. return
  638. variables = {
  639. "printer": printer_name,
  640. "slot": str(slot),
  641. "remaining_percent": str(remaining_percent),
  642. "color": color or "",
  643. }
  644. title, message = await self._build_message_from_template(db, "filament_low", variables)
  645. await self._send_to_providers(providers, title, message, db, "filament_low", printer_id, printer_name)
  646. async def on_maintenance_due(
  647. self,
  648. printer_id: int,
  649. printer_name: str,
  650. maintenance_items: list[dict],
  651. db: AsyncSession,
  652. ):
  653. """Handle maintenance due event - sends notification when maintenance is due or warning."""
  654. if not maintenance_items:
  655. return
  656. providers = await self._get_providers_for_event(db, "on_maintenance_due", printer_id)
  657. if not providers:
  658. logger.info(f"No notification providers configured for maintenance_due event on printer {printer_id}")
  659. return
  660. # Format maintenance items list
  661. items_list = []
  662. for item in maintenance_items:
  663. status = "OVERDUE" if item.get("is_due") else "Soon"
  664. items_list.append(f"- {item['name']} ({status})")
  665. items_str = "\n".join(items_list)
  666. variables = {
  667. "printer": printer_name,
  668. "items": items_str,
  669. }
  670. logger.info(f"Found {len(providers)} providers for maintenance_due: {[p.name for p in providers]}")
  671. title, message = await self._build_message_from_template(db, "maintenance_due", variables)
  672. await self._send_to_providers(providers, title, message, db, "maintenance_due", printer_id, printer_name)
  673. async def on_ams_humidity_high(
  674. self,
  675. printer_id: int,
  676. printer_name: str,
  677. ams_label: str,
  678. humidity: float,
  679. threshold: float,
  680. db: AsyncSession,
  681. ):
  682. """Handle AMS high humidity alarm event. Always sends immediately (bypasses digest)."""
  683. providers = await self._get_providers_for_event(db, "on_ams_humidity_high", printer_id)
  684. if not providers:
  685. return
  686. variables = {
  687. "printer": printer_name,
  688. "ams_label": ams_label,
  689. "humidity": f"{humidity:.0f}",
  690. "threshold": f"{threshold:.0f}",
  691. }
  692. title, message = await self._build_message_from_template(db, "ams_humidity_high", variables)
  693. # Alarms always send immediately, bypassing digest mode
  694. await self._send_to_providers(
  695. providers, title, message, db, "ams_humidity_high", printer_id, printer_name, force_immediate=True
  696. )
  697. async def on_ams_temperature_high(
  698. self,
  699. printer_id: int,
  700. printer_name: str,
  701. ams_label: str,
  702. temperature: float,
  703. threshold: float,
  704. db: AsyncSession,
  705. ):
  706. """Handle AMS high temperature alarm event. Always sends immediately (bypasses digest)."""
  707. providers = await self._get_providers_for_event(db, "on_ams_temperature_high", printer_id)
  708. if not providers:
  709. return
  710. variables = {
  711. "printer": printer_name,
  712. "ams_label": ams_label,
  713. "temperature": f"{temperature:.1f}",
  714. "threshold": f"{threshold:.1f}",
  715. }
  716. title, message = await self._build_message_from_template(db, "ams_temperature_high", variables)
  717. # Alarms always send immediately, bypassing digest mode
  718. await self._send_to_providers(
  719. providers, title, message, db, "ams_temperature_high", printer_id, printer_name, force_immediate=True
  720. )
  721. async def on_ams_ht_humidity_high(
  722. self,
  723. printer_id: int,
  724. printer_name: str,
  725. ams_label: str,
  726. humidity: float,
  727. threshold: float,
  728. db: AsyncSession,
  729. ):
  730. """Handle AMS-HT high humidity alarm event. Always sends immediately (bypasses digest)."""
  731. providers = await self._get_providers_for_event(db, "on_ams_ht_humidity_high", printer_id)
  732. if not providers:
  733. return
  734. variables = {
  735. "printer": printer_name,
  736. "ams_label": ams_label,
  737. "humidity": f"{humidity:.0f}",
  738. "threshold": f"{threshold:.0f}",
  739. }
  740. # Use the same template as regular AMS (can create separate templates later if needed)
  741. title, message = await self._build_message_from_template(db, "ams_humidity_high", variables)
  742. # Alarms always send immediately, bypassing digest mode
  743. await self._send_to_providers(
  744. providers, title, message, db, "ams_ht_humidity_high", printer_id, printer_name, force_immediate=True
  745. )
  746. async def on_ams_ht_temperature_high(
  747. self,
  748. printer_id: int,
  749. printer_name: str,
  750. ams_label: str,
  751. temperature: float,
  752. threshold: float,
  753. db: AsyncSession,
  754. ):
  755. """Handle AMS-HT high temperature alarm event. Always sends immediately (bypasses digest)."""
  756. providers = await self._get_providers_for_event(db, "on_ams_ht_temperature_high", printer_id)
  757. if not providers:
  758. return
  759. variables = {
  760. "printer": printer_name,
  761. "ams_label": ams_label,
  762. "temperature": f"{temperature:.1f}",
  763. "threshold": f"{threshold:.1f}",
  764. }
  765. # Use the same template as regular AMS (can create separate templates later if needed)
  766. title, message = await self._build_message_from_template(db, "ams_temperature_high", variables)
  767. # Alarms always send immediately, bypassing digest mode
  768. await self._send_to_providers(
  769. providers, title, message, db, "ams_ht_temperature_high", printer_id, printer_name, force_immediate=True
  770. )
  771. def clear_template_cache(self):
  772. """Clear the template cache. Call this when templates are updated."""
  773. self._template_cache.clear()
  774. async def _queue_for_digest(
  775. self,
  776. provider: NotificationProvider,
  777. event_type: str,
  778. title: str,
  779. message: str,
  780. db: AsyncSession,
  781. printer_id: int | None = None,
  782. printer_name: str | None = None,
  783. ):
  784. """Queue a notification for later delivery in the daily digest."""
  785. try:
  786. queue_entry = NotificationDigestQueue(
  787. provider_id=provider.id,
  788. event_type=event_type,
  789. title=title,
  790. message=message,
  791. printer_id=printer_id,
  792. printer_name=printer_name,
  793. )
  794. db.add(queue_entry)
  795. await db.commit()
  796. logger.info(f"Queued notification for digest: {event_type} for provider {provider.name}")
  797. except Exception as e:
  798. logger.warning(f"Failed to queue notification for digest: {e}")
  799. async def send_digest(self, provider_id: int):
  800. """Send all queued notifications as a single digest for a provider."""
  801. from backend.app.core.database import async_session
  802. async with async_session() as db:
  803. # Get the provider
  804. result = await db.execute(select(NotificationProvider).where(NotificationProvider.id == provider_id))
  805. provider = result.scalar_one_or_none()
  806. if not provider or not provider.enabled:
  807. return
  808. # Get all queued notifications for this provider
  809. result = await db.execute(
  810. select(NotificationDigestQueue)
  811. .where(NotificationDigestQueue.provider_id == provider_id)
  812. .order_by(NotificationDigestQueue.created_at)
  813. )
  814. queue_entries = list(result.scalars().all())
  815. if not queue_entries:
  816. logger.debug(f"No queued notifications for provider {provider.name}")
  817. return
  818. # Build digest message
  819. title = f"Daily Digest - {len(queue_entries)} Events"
  820. # Group by event type
  821. events_by_type: dict[str, list] = {}
  822. for entry in queue_entries:
  823. if entry.event_type not in events_by_type:
  824. events_by_type[entry.event_type] = []
  825. events_by_type[entry.event_type].append(entry)
  826. # Format the digest body
  827. body_parts = []
  828. for event_type, entries in events_by_type.items():
  829. event_label = event_type.replace("_", " ").title()
  830. body_parts.append(f"== {event_label} ({len(entries)}) ==")
  831. for entry in entries:
  832. time_str = entry.created_at.strftime("%H:%M")
  833. printer_info = f"[{entry.printer_name}] " if entry.printer_name else ""
  834. body_parts.append(f" {time_str} {printer_info}{entry.title}")
  835. body_parts.append("")
  836. body = "\n".join(body_parts)
  837. # Send the digest
  838. success, error = await self._send_to_provider(provider, title, body, db)
  839. # Log the digest
  840. await self._log_notification(
  841. db=db,
  842. provider_id=provider.id,
  843. event_type="daily_digest",
  844. title=title,
  845. message=body,
  846. success=success,
  847. error_message=error if not success else None,
  848. )
  849. # Clear the queue
  850. for entry in queue_entries:
  851. await db.delete(entry)
  852. await db.commit()
  853. if success:
  854. logger.info(f"Sent daily digest with {len(queue_entries)} events to {provider.name}")
  855. else:
  856. logger.warning(f"Failed to send daily digest to {provider.name}: {error}")
  857. async def check_and_send_digests(self):
  858. """Check all providers and send digests if it's their scheduled time."""
  859. from backend.app.core.database import async_session
  860. current_time = datetime.now().strftime("%H:%M")
  861. # Avoid duplicate checks within the same minute
  862. if current_time == self._last_digest_check:
  863. return
  864. self._last_digest_check = current_time
  865. async with async_session() as db:
  866. # Find all providers with digest enabled at this time
  867. result = await db.execute(
  868. select(NotificationProvider).where(
  869. NotificationProvider.enabled.is_(True),
  870. NotificationProvider.daily_digest_enabled.is_(True),
  871. NotificationProvider.daily_digest_time == current_time,
  872. )
  873. )
  874. providers = result.scalars().all()
  875. for provider in providers:
  876. try:
  877. await self.send_digest(provider.id)
  878. except Exception as e:
  879. logger.error(f"Error sending digest for provider {provider.id}: {e}")
  880. def start_digest_scheduler(self):
  881. """Start the background scheduler for daily digest notifications."""
  882. if self._digest_scheduler_task is None:
  883. self._digest_scheduler_task = asyncio.create_task(self._digest_scheduler_loop())
  884. logger.info("Notification digest scheduler started")
  885. def stop_digest_scheduler(self):
  886. """Stop the background scheduler for daily digests."""
  887. if self._digest_scheduler_task:
  888. self._digest_scheduler_task.cancel()
  889. self._digest_scheduler_task = None
  890. logger.info("Notification digest scheduler stopped")
  891. async def _digest_scheduler_loop(self):
  892. """Background loop that checks for scheduled digests every minute."""
  893. while True:
  894. try:
  895. await self.check_and_send_digests()
  896. except Exception as e:
  897. logger.error(f"Error in digest scheduler: {e}")
  898. # Wait until the next minute
  899. await asyncio.sleep(60)
  900. # Global instance
  901. notification_service = NotificationService()