Feat/438 notification preferences toggle groups, send gate, and one click unsubscribe

[RamRamez]

• https://github.com/Giveth/giveth-v6-core/issues/438

Summary by CodeRabbit

• New Features

  • Added email notifications when users become eligible for GIVbacks.
  • Added supporter notifications when a project publishes a new update, including the update title and project details.
  • Added tracking for GIVbacks eligibility separately from standard project verification.

• Improvements

  • Project update notifications are now enabled by default and can be managed through email notification settings.
  • Expanded notification data validation for more consistent project and update information.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 72f60d05-9864-48e3-b47d-fd0164f348f6

📥 Commits

Reviewing files that changed from the base of the PR and between a9fc4c6 and 1eb286d.

📒 Files selected for processing (7)

• migrations/1756000000000-v6EventTriggeredEmails.ts
• src/entities/notificationType.ts
• src/services/notificationService.test.ts
• src/services/notificationService.ts
• src/types/general.ts
• src/types/notifications.ts
• src/utils/validators/segmentAndMetadataValidators.ts

---

Walkthrough

Adds GIVbacks eligibility and supporter project update email events. It adds notification contracts, Ortto activity mappings, segment validators, tests, and a migration for notification types and user settings.

Changes

V6 event-triggered emails

Layer / File(s)	Summary
Notification contracts and validators src/types/general.ts, src/types/notifications.ts, src/entities/notificationType.ts, src/utils/validators/segmentAndMetadataValidators.ts	Adds the GIVbacks eligibility notification identifiers, Ortto activity mapping, validator name, and project payload validators. Adds project payload validation for supporter update notifications.
Activity creation and coverage src/services/notificationService.ts, src/services/notificationService.test.ts	Creates Ortto activities for GIVbacks eligibility and supporter project updates. Tests the new activities, payload attributes, validators, and nine existing events.
Notification settings migration migrations/1756000000000-v6EventTriggeredEmails.ts	Creates the GIVbacks eligibility notification type and user settings. Enables email defaults for project updates. The rollback restores seeded project update flags but does not restore prior per-user values.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant NotificationEvent
  participant activityCreator
  participant OrttoActivity
  participant SegmentValidator
  NotificationEvent->>activityCreator: Send event and payload
  activityCreator->>OrttoActivity: Create mapped activity attributes
  activityCreator->>SegmentValidator: Resolve and validate segment payload
  SegmentValidator-->>activityCreator: Return validation result

Loading

Suggested reviewers: ae2079

Poem

A rabbit hops through settings bright

And maps new badges into flight
Project updates bloom with cheer
Validators guard each payload near
Emails thump: the path is clear

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/438-Notification-preferences--toggle-groups,-send-gate,-and-one-click-unsubscribe

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}