feat: add health endpoint (resolves #1410)

app/Http/Controllers/HealthController.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Foundation\Events\DiagnosingHealth;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Event;
+
+class HealthController extends Controller
+{
+    public function show(Request $request): JsonResponse
+    {
+        $status = [];
+
+        Event::dispatch(new DiagnosingHealth);
+
+        if (defined('LARAVEL_START')) {
+            $status['duration'] = round((microtime(true) - LARAVEL_START) * 1000).'ms';
+        }
+
+        return response()->json($status);
+    }
+}

routes/web.php

@@ -1,5 +1,6 @@
 <?php
 
+use App\Http\Controllers\HealthController;
 use App\Http\Controllers\PageController;
 use App\Http\Controllers\UserController;
 use Illuminate\Support\Facades\Route;
@@ -160,6 +161,8 @@
     ->middleware(['auth'])
     ->name('users.destroy');
 
+Route::get('/health', [HealthController::class, 'show'])->name('health');
+
 require __DIR__.'/admin.php';
 require __DIR__.'/block-list.php';
 require __DIR__.'/individuals.php';

tests/Feature/HealthTest.php

@@ -0,0 +1,21 @@
+<?php
+
+use Illuminate\Testing\Fluent\AssertableJson;
+
+use function Pest\Laravel\get;
+
+test('health page loads without response', function () {
+    get(route('health'))
+        ->assertOk()
+        ->assertJson(fn (AssertableJson $json) => $json->missing('duration')
+        );
+});
+
+test('health page loads with response', function () {
+    define('LARAVEL_START', microtime(true));
+
+    get(route('health'))
+        ->assertOk()
+        ->assertJson(fn (AssertableJson $json) => $json->has('duration')
+        );
+});