Add notification email opt-in with branded email templates

- Add receives_notification_emails column to users table
- Add SuppressMailNotificationListener to respect user email preferences
- Publish and customize mail templates with NativePHP branding (PNG logo)
- Update all notifications to support database channel
- Add settings UI for toggling notification emails
- Remove TestNotification and SendTestEmail command
- Add tests for suppression listener and settings

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: simonhamp

app/Console/Commands/SendTestEmail.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Listeners;
+
+use App\Models\User;
+use Illuminate\Notifications\Events\NotificationSending;
+
+class SuppressMailNotificationListener
+{
+    public function handle(NotificationSending $event): bool
+    {
+        if ($event->channel !== 'mail') {
+            return true;
+        }
+
+        if (! $event->notifiable instanceof User) {
+            return true;
+        }
+
+        return $event->notifiable->receives_notification_emails;
+    }
+}

app/Listeners/SuppressMailNotificationListener.php

@@ -6,12 +6,16 @@
 use Illuminate\Support\Facades\Hash;
 use Livewire\Attributes\Layout;
 use Livewire\Attributes\Title;
+use Livewire\Attributes\Url;
 use Livewire\Component;
 
 #[Layout('components.layouts.dashboard')]
 #[Title('Settings')]
 class Settings extends Component
 {
+    #[Url]
+    public string $tab = 'account';
+
     public string $name = '';
 
     public string $currentPassword = '';
@@ -22,9 +26,17 @@ class Settings extends Component
 
     public string $deleteConfirmPassword = '';
 
+    public bool $receivesNotificationEmails = true;
+
     public function mount(): void
     {
         $this->name = auth()->user()->name ?? '';
+        $this->receivesNotificationEmails = auth()->user()->receives_notification_emails;
+    }
+
+    public function updatedReceivesNotificationEmails(bool $value): void
+    {
+        auth()->user()->update(['receives_notification_emails' => $value]);
     }
 
     public function updateName(): void

app/Livewire/Customer/Settings.php

@@ -358,6 +358,7 @@ protected function casts(): array
         return [
             'email_verified_at' => 'datetime',
             'password' => 'hashed',
+            'receives_notification_emails' => 'boolean',
             'mobile_repo_access_granted_at' => 'datetime',
             'claude_plugins_repo_access_granted_at' => 'datetime',
             'discord_role_granted_at' => 'datetime',

app/Models/User.php

@@ -27,7 +27,7 @@ public function __construct(
      */
     public function via(object $notifiable): array
     {
-        return ['mail'];
+        return ['mail', 'database'];
     }
 
     public function toMail(object $notifiable): MailMessage
@@ -53,6 +53,8 @@ public function toMail(object $notifiable): MailMessage
     public function toArray(object $notifiable): array
     {
         return [
+            'title' => "You've been granted the {$this->bundle->name} bundle!",
+            'body' => "You now have access to {$this->grantedPlugins->count()} plugins in the {$this->bundle->name} bundle.",
             'bundle_id' => $this->bundle->id,
             'bundle_name' => $this->bundle->name,
             'granted_plugin_ids' => $this->grantedPlugins->pluck('id')->toArray(),

app/Notifications/BundleGranted.php

@@ -23,7 +23,7 @@ public function __construct(
      */
     public function via(object $notifiable): array
     {
-        return ['mail'];
+        return ['mail', 'database'];
     }
 
     public function toMail(object $notifiable): MailMessage
@@ -48,6 +48,8 @@ public function toMail(object $notifiable): MailMessage
     public function toArray(object $notifiable): array
     {
         return [
+            'title' => "New plugin added to your {$this->bundle->name} bundle!",
+            'body' => "{$this->plugin->name} has been added to your bundle — it's yours for free.",
             'plugin_id' => $this->plugin->id,
             'plugin_name' => $this->plugin->name,
             'bundle_id' => $this->bundle->id,

app/Notifications/BundlePluginAdded.php

@@ -18,7 +18,20 @@ public function __construct(
 
     public function via($notifiable): array
     {
-        return ['mail'];
+        return ['mail', 'database'];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray($notifiable): array
+    {
+        return [
+            'title' => 'Thank You for Making NativePHP Mobile Free',
+            'body' => 'NativePHP for Mobile is now free for everyone — thanks to early supporters like you.',
+            'license_id' => $this->license->id,
+            'license_key' => $this->license->key,
+        ];
     }
 
     public function toMail($notifiable): MailMessage

app/Notifications/LegacyLicenseThankYou.php

@@ -19,7 +19,7 @@ public function __construct(
 
     public function via($notifiable): array
     {
-        return ['mail'];
+        return ['mail', 'database'];
     }
 
     public function toMail($notifiable): MailMessage
@@ -43,6 +43,20 @@ public function toMail($notifiable): MailMessage
             ->salutation("Best regards,\nThe NativePHP Team");
     }
 
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray($notifiable): array
+    {
+        return [
+            'title' => $this->getSubject(),
+            'body' => $this->getMainMessage(),
+            'license_id' => $this->license->id,
+            'license_key' => $this->license->key,
+            'days_until_expiry' => $this->daysUntilExpiry,
+        ];
+    }
+
     private function getSubject(): string
     {
         return match ($this->daysUntilExpiry) {

app/Notifications/LicenseExpiryWarning.php

@@ -25,7 +25,7 @@ public function __construct(
      */
     public function via(object $notifiable): array
     {
-        return ['mail'];
+        return ['mail', 'database'];
     }
 
     public function toMail(object $notifiable): MailMessage
@@ -58,6 +58,8 @@ public function toMail(object $notifiable): MailMessage
     public function toArray(object $notifiable): array
     {
         return [
+            'title' => 'Your NativePHP License Key',
+            'body' => 'Your license key has been generated and is ready to use.',
             'license_key' => $this->licenseKey,
             'firstName' => $this->firstName,
         ];

app/Notifications/LicenseKeyGenerated.php

@@ -23,7 +23,7 @@ public function __construct(
      */
     public function via(object $notifiable): array
     {
-        return ['mail'];
+        return ['mail', 'database'];
     }
 
     /**
@@ -47,6 +47,8 @@ public function toMail(object $notifiable): MailMessage
     public function toArray(object $notifiable): array
     {
         return [
+            'title' => 'Your Plugin Has Been Approved!',
+            'body' => "{$this->plugin->name} is now listed in the NativePHP Plugin Directory.",
             'plugin_id' => $this->plugin->id,
             'plugin_name' => $this->plugin->name,
         ];