// Package service — NotificationService is the single seam every // user-facing event flows through ("the notification plugin"). Today it // does two things per event: // // 1. Persists a row in `notifications` (so an in-app notification center // and, later, websocket + push delivery can read the same history). // 2. Sends an email to the recipient via the shared mailer. // // Everything here is fire-and-forget from the caller's perspective: a // follow request must succeed even if the email bounces or the insert // fails, so Notify* never returns an error — failures are logged. When // websocket/push land they hook in right here alongside the email send. package service import ( "bytes" "context" "fmt" "html/template" "strings" "time" "github.com/prabhupadasays/spsays-bff/internal/model" "github.com/prabhupadasays/spsays-bff/internal/repository" "github.com/prabhupadasays/spsays-bff/pkg/mailer" "github.com/prabhupadasays/spsays-bff/pkg/realtime" "go.uber.org/zap" ) // Notification kinds — short machine strings stored in notifications.kind. const ( NotifFollowRequest = "follow_request" NotifFollowAccepted = "follow_accepted" NotifPostLike = "post_like" // Reminder kinds are delivered live (email + push + a websocket toast) // but NOT persisted — they're ephemeral nudges, not history. NotifChantReminder = "chant_reminder" NotifQuoteReminder = "quote_reminder" NotifChantIncomplete = "chant_incomplete_reminder" ) type NotificationService struct { notifs *repository.NotificationRepo users *repository.UserRepo mail mailer.Mailer rt *realtime.SoketiClient // optional — nil disables WebSocket push push *PushSender // optional — nil disables Web Push logger *zap.Logger frontendURL string } func NewNotificationService(notifs *repository.NotificationRepo, users *repository.UserRepo, mail mailer.Mailer, rt *realtime.SoketiClient, push *PushSender, logger *zap.Logger, frontendURL string) *NotificationService { return &NotificationService{ notifs: notifs, users: users, mail: mail, rt: rt, push: push, logger: logger, frontendURL: strings.TrimRight(frontendURL, "/"), } } // List returns the caller's notifications, newest first. func (s *NotificationService) List(ctx context.Context, userID string, limit, offset int) ([]model.Notification, error) { if limit <= 0 || limit > 100 { limit = 30 } if offset < 0 { offset = 0 } return s.notifs.ListByUser(ctx, userID, limit, offset) } // UnreadCount returns the caller's unread notification count (for the bell // badge). func (s *NotificationService) UnreadCount(ctx context.Context, userID string) (int, error) { return s.notifs.CountUnread(ctx, userID) } // MarkAllRead marks all of the caller's notifications read. func (s *NotificationService) MarkAllRead(ctx context.Context, userID string) error { return s.notifs.MarkAllRead(ctx, userID) } // LikeEmailPref / SetLikeEmailPref back the Settings → Notifications toggle // for aggregated like emails. func (s *NotificationService) LikeEmailPref(ctx context.Context, userID string) (bool, error) { return s.notifs.LikeEmailsEnabled(ctx, userID) } func (s *NotificationService) SetLikeEmailPref(ctx context.Context, userID string, enabled bool) error { return s.notifs.SetLikeEmailsEnabled(ctx, userID, enabled) } // NotifyFollowRequest tells `recipientID` that `actorID` asked to follow // them. Persists the row and emails the recipient (if they have an email // on file). func (s *NotificationService) NotifyFollowRequest(ctx context.Context, recipientID, actorID string) { s.dispatch(ctx, recipientID, actorID, NotifFollowRequest, "%s requested to follow you — Prabhupāda Says") } // NotifyFollowAccepted tells `recipientID` that `actorID` accepted their // follow request (i.e. the recipient can now see actor's activity). func (s *NotificationService) NotifyFollowAccepted(ctx context.Context, recipientID, actorID string) { s.dispatch(ctx, recipientID, actorID, NotifFollowAccepted, "%s accepted your follow request — Prabhupāda Says") } // NotifyPostLike tells the post author that `likerID` liked their post. Sent // only when the liker isn't the author (callers also guard). Unlike follows, // likes are high-volume, so this delivers a persisted row + realtime nudge + // Web Push but NO email. The push is tagged per-post so repeated likes on the // same post collapse into one notification rather than stacking. func (s *NotificationService) NotifyPostLike(ctx context.Context, postID, authorID, likerID string) { if authorID == "" || likerID == "" || authorID == likerID { return } // Aggregate into the single (author, post) like-notification row. Returns // the new liker count and whether an aggregated email is due (throttled). count, emailDue, err := s.notifs.UpsertLike(ctx, authorID, likerID, postID, likeEmailThrottle) if err != nil { s.logger.Warn("aggregate like notification failed", zap.String("recipient", authorID), zap.Error(err)) count, emailDue = 1, false } actorUser, _ := s.users.FindByID(ctx, likerID) who := "Someone" if actorUser != nil { who = actorDisplay(actorUser) } body := likeMessage(who, count) // Realtime nudge — carry actor_count so the toast can read "and N others". if s.rt != nil { payload := map[string]any{"kind": NotifPostLike, "actor_count": count} if actorUser != nil { payload["actor_name"] = actorDisplay(actorUser) payload["actor_handle"] = actorUser.Handle payload["actor_avatar_url"] = actorUser.AvatarURL } if err := s.rt.Trigger(ctx, "notifications."+authorID, "notification", payload); err != nil { s.logger.Warn("realtime like publish failed", zap.String("recipient", authorID), zap.Error(err)) } } // Tapping a notification opens the author's own feed anchored to the post. author, _ := s.users.FindByID(ctx, authorID) url := s.frontendURL + "/notifications" if author != nil { url = s.frontendURL + "/u/" + author.Handle + "/posts#post-" + postID } // Web Push — tagged per-post so repeated likes collapse into one. if s.push != nil { s.push.SendToUser(ctx, authorID, PushPayload{ Title: "New Like", Body: body, URL: url, Icon: s.iconURL(), Tag: NotifPostLike + ":" + postID, }) } // Aggregated email — only when the throttle says one is due (so a burst of // likes yields a single email), the author has an address, and they // haven't opted out. `body` already aggregates ("X and N others …"). if !emailDue || author == nil || author.Email == nil || strings.TrimSpace(*author.Email) == "" { return } if enabled, perr := s.notifs.LikeEmailsEnabled(ctx, authorID); perr != nil || !enabled { return } var buf bytes.Buffer if err := likeEmailTpl.Execute(&buf, map[string]any{ "RecipientName": author.Name, "Message": body, "URL": url, }); err != nil { s.logger.Warn("render like email failed", zap.Error(err)) return } if err := s.mail.Send(strings.TrimSpace(*author.Email), "New likes on your post — Prabhupāda Says", buf.String()); err != nil { s.logger.Warn("like email send failed", zap.String("to", *author.Email), zap.Error(err)) } } // likeEmailThrottle is the minimum gap between aggregated like emails for a // single post — a burst of likes within the window produces one email. const likeEmailThrottle = 6 * time.Hour // likeMessage renders the aggregated like text: "X liked your post" or // "X and N others liked your post". func likeMessage(who string, count int) string { if count <= 1 { return who + " liked your post" } others := count - 1 noun := "others" if others == 1 { noun = "other" } return fmt.Sprintf("%s and %d %s liked your post", who, others, noun) } // dispatch persists the notification and sends the matching email. All // failures are logged, never propagated. func (s *NotificationService) dispatch(ctx context.Context, recipientID, actorID, kind, subjectFmt string) { actor := actorID if _, err := s.notifs.Create(ctx, recipientID, &actor, kind); err != nil { s.logger.Warn("persist notification failed", zap.String("recipient", recipientID), zap.String("kind", kind), zap.Error(err)) // Persistence failed, but still try the other channels. } // Look up the actor once — both the realtime push and the email use it. actorUser, aerr := s.users.FindByID(ctx, actorID) if aerr != nil { s.logger.Warn("notification actor lookup failed", zap.String("actor", actorID), zap.Error(aerr)) } // Realtime push (best-effort) — a lightweight nudge so the client can // bump the bell + toast immediately. Fires regardless of whether the // recipient has an email; authoritative data still comes from REST. s.publishRealtime(ctx, recipientID, kind, actorUser) // Web Push (best-effort) — reaches the recipient even with the app // closed. Same seam as realtime/email; nil sender is a no-op. s.publishPush(ctx, recipientID, kind, actorUser) // Email (best-effort). recipient, err := s.users.FindByID(ctx, recipientID) if err != nil { s.logger.Warn("notification recipient lookup failed", zap.String("recipient", recipientID), zap.Error(err)) return } if recipient.Email == nil || strings.TrimSpace(*recipient.Email) == "" { // No email on file (OAuth-only account that never added one) — // the persisted row + realtime push are the notification. return } if actorUser == nil { // Can't render the email body without the actor's name. return } body, err := s.render(kind, recipient, actorUser) if err != nil { s.logger.Warn("render notification email failed", zap.String("kind", kind), zap.Error(err)) return } subject := strings.Replace(subjectFmt, "%s", actorDisplay(actorUser), 1) if err := s.mail.Send(strings.TrimSpace(*recipient.Email), subject, body); err != nil { s.logger.Warn("notification email send failed", zap.String("to", *recipient.Email), zap.String("kind", kind), zap.Error(err)) } } // publishRealtime pushes a lightweight notification event to the // recipient's Soketi channel. PUBLIC channel for now ("notifications.{id}") // — switch to a "private-" prefix once Soketi App auth is wired up. The // payload carries just enough for a toast; the client refetches the // authoritative unread count + list from REST. func (s *NotificationService) publishRealtime(ctx context.Context, recipientID, kind string, actor *model.User) { if s.rt == nil { return } payload := map[string]any{"kind": kind} if actor != nil { payload["actor_name"] = actorDisplay(actor) payload["actor_handle"] = actor.Handle payload["actor_avatar_url"] = actor.AvatarURL } if err := s.rt.Trigger(ctx, "notifications."+recipientID, "notification", payload); err != nil { s.logger.Warn("realtime notification publish failed", zap.String("recipient", recipientID), zap.String("kind", kind), zap.Error(err)) } } // SendReminder delivers an ephemeral sādhana reminder across all live // channels — a websocket toast (no unread bump, not persisted), a Web Push, // and an email. Best-effort; nothing is persisted to the notification // center. `url` is where tapping the notification lands. func (s *NotificationService) SendReminder(ctx context.Context, userID, kind, title, body, url string) { // Realtime toast — a distinct "reminder" event so the client toasts // without bumping the unread badge (reminders have no DB row). if s.rt != nil { _ = s.rt.Trigger(ctx, "notifications."+userID, "reminder", map[string]any{ "kind": kind, "title": title, "body": body, "url": url, }) } // Web Push (reaches closed apps). if s.push != nil { s.push.SendToUser(ctx, userID, PushPayload{Title: title, Body: body, URL: url, Icon: s.iconURL(), Tag: kind, RequireInteraction: true}) } // Email (only if there's an address on file). recipient, err := s.users.FindByID(ctx, userID) if err != nil || recipient == nil || recipient.Email == nil || strings.TrimSpace(*recipient.Email) == "" { return } var buf bytes.Buffer if err := reminderEmailTpl.Execute(&buf, map[string]any{ "RecipientName": recipient.Name, "Message": body, "URL": url, }); err != nil { s.logger.Warn("render reminder email failed", zap.String("kind", kind), zap.Error(err)) return } if err := s.mail.Send(strings.TrimSpace(*recipient.Email), title, buf.String()); err != nil { s.logger.Warn("reminder email send failed", zap.String("to", *recipient.Email), zap.String("kind", kind), zap.Error(err)) } } // publishPush delivers a Web Push notification to the recipient's devices. // The body quotes the actor; tapping it opens their profile (where a pending // follow request can be accepted). Best-effort; nil sender is a no-op. func (s *NotificationService) publishPush(ctx context.Context, recipientID, kind string, actor *model.User) { if s.push == nil { return } who := "Someone" url := s.frontendURL + "/notifications" if actor != nil { who = actorDisplay(actor) url = s.frontendURL + "/u/" + actor.Handle } // Title must be meaningful, not the app name: iOS renders installed-PWA // notifications as "
Hare Kṛṣṇa{{if .RecipientName}}, {{.RecipientName}}{{end}} 🙏
{{.ActorName}} (@{{.ActorHandle}}) has requested to follow you on Prabhupāda Says.
You can review and accept or decline the request from their profile:
Your servants,
The Prabhupāda Says team
Hare Kṛṣṇa{{if .RecipientName}}, {{.RecipientName}}{{end}} 🙏
{{.ActorName}} (@{{.ActorHandle}}) has accepted your follow request. You're now following them on Prabhupāda Says.
Your servants,
The Prabhupāda Says team
Hare Kṛṣṇa{{if .RecipientName}}, {{.RecipientName}}{{end}} 🙏
{{.Message}}
You can turn these reminders off any time in Settings → Notifications.
Your servants,
The Prabhupāda Says team
Hare Kṛṣṇa{{if .RecipientName}}, {{.RecipientName}}{{end}} 🙏
{{.Message}}.
You can turn off like emails any time in Settings → Notifications.
Your servants,
The Prabhupāda Says team