Add stage 7: email verification magic links and a profile page

Backend
- New Mail namespace: a Mailer interface with SMTP (phpmailer), PHP mail()
  (the default fallback), and log-to-file transports, selected by
  MAIL_TRANSPORT. EmailVerifier issues a hashed, 15-minute magic-link token
  and sends the link (APP_URL/verify-email?token=...).
- Migration 005: email_verifications table + users.verification_email_sent_at.
- Registration now emails a verification link (best effort — a send failure
  doesn't fail registration).
- POST /api/auth/verify-email consumes a token and returns a session, so
  opening the link verifies the address (or applies a pending email change)
  and logs the user in. Single-use; distinct 400s for invalid/used/expired.
- POST /api/email/verification resends; POST /api/email/change requests a
  deferred change (current password required; link goes to the new address;
  users.email only updates when that link is opened). Both throttled to once
  per 60s, returning 429 + retry_after.
- GET /api/me and every session payload now include pending_email. Shared
  SessionPayload builds the user/session JSON for all entry points.

Frontend
- /verify-email view: posts the token, adopts the returned session, redirects.
- /profile view: shows address + status, a resend button with a live cooldown
  (driven by retry_after / 429), and a change-email form (new address +
  current password) that surfaces the pending change.
- Header shows a "verify email" badge linking to the profile.

Tests: 9 new (EmailVerificationTest) covering the link lifecycle, throttle,
and deferred change; AuthTest folded into ApiTestCase, which now routes mail
to a per-test log. Suite: 32 passing.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

src/Http/Controllers/AuthController.php

@@ -4,9 +4,11 @@ declare(strict_types=1);
 
 namespace App\Http\Controllers;
 
-use App\Auth\JwtService;
+use App\Auth\SessionPayload;
 use App\Exception\ApiException;
 use App\Exception\ValidationException;
+use App\Mail\EmailVerifier;
+use App\Mail\MailException;
 use App\Repository\UserRepository;
 use Psr\Http\Message\ResponseInterface as Response;
 use Psr\Http\Message\ServerRequestInterface as Request;
@@ -22,7 +24,8 @@ final class AuthController extends Controller
 
     public function __construct(
         private readonly UserRepository $users,
-        private readonly JwtService $jwt,
+        private readonly SessionPayload $session,
+        private readonly EmailVerifier $verifier,
     ) {
     }
 
@@ -39,7 +42,15 @@ final class AuthController extends Controller
 
         $user = $this->users->create($email, password_hash($password, PASSWORD_DEFAULT));
 
-        return $this->json($response, $this->session($user), 201);
+        // Best effort: a failed send must not fail registration — the user can
+        // resend from their profile.
+        try {
+            $this->verifier->sendVerification($user);
+        } catch (MailException $e) {
+            error_log('Verification email failed for user ' . $user['id'] . ': ' . $e->getMessage());
+        }
+
+        return $this->json($response, $this->session->forUser($user), 201);
     }
 
     /**
@@ -56,7 +67,7 @@ final class AuthController extends Controller
             throw new ApiException('Invalid email or password.', 401);
         }
 
-        return $this->json($response, $this->session($user));
+        return $this->json($response, $this->session->forUser($user));
     }
 
     /**
@@ -64,10 +75,7 @@ final class AuthController extends Controller
      */
     public function me(Request $request, Response $response): Response
     {
-        /** @var array{id: int, email: string, email_verified_at: string|null, created_at: string} $user */
-        $user = $request->getAttribute('user');
-
-        return $this->json($response, ['user' => $this->presentUser($user)]);
+        return $this->json($response, ['user' => $this->session->present($this->user($request))]);
     }
 
     /**
@@ -106,38 +114,4 @@ final class AuthController extends Controller
 
         return [mb_strtolower($email), $password];
     }
-
-    /**
-     * Build the standard authentication payload returned by register and login.
-     *
-     * @param array{id: int, email: string, email_verified_at: string|null, created_at: string} $user
-     * @return array<string, mixed>
-     */
-    private function session(array $user): array
-    {
-        $token = $this->jwt->issue($user);
-
-        return [
-            'user' => $this->presentUser($user),
-            'token' => $token['token'],
-            'expires_at' => $token['expires_at'],
-        ];
-    }
-
-    /**
-     * @param array{id: int, email: string, email_verified_at?: string|null, created_at?: string} $user
-     * @return array<string, mixed>
-     */
-    private function presentUser(array $user): array
-    {
-        $verifiedAt = $user['email_verified_at'] ?? null;
-
-        return [
-            'id' => (int) $user['id'],
-            'email' => $user['email'],
-            'email_verified' => $verifiedAt !== null,
-            'email_verified_at' => $verifiedAt,
-            'created_at' => $user['created_at'] ?? null,
-        ];
-    }
 }