class UserController extends Controller
{
    public function register(Request $request)
    {
        $request->validate([
            'email' => 'required|email',
            'password' => 'required',
        ]);

        DB::beginTransaction();
        try {
            $user = User::create($request->all());
            Mail::to($user)->send(new WelcomeEmail());
            Log::info("User registered");
            DB::commit();
            return response()->json($user, 201);
        } catch (\Exception $e) {
            DB::rollBack();
            throw $e;
        }
    }
}

#[Api]
class RegisterUserAction
{
    use AsAction;

    public function __construct(
        private readonly Mediator $mediator
    ) {}

    public static function route(Router $router): void
    {
        $router->post('/register');
    }

    public function handle(RegisterUserRequest $request): JsonResponse
    {
        // Handler runs the logic
        $user = $this->mediator->send($request);

        // Notifications handle side effects
        $this->mediator->publish(new UserRegisteredEvent($user));

        return response()->json($user, 201);
    }
}

⚡ Zero Config Handlers are auto-discovered via #[RequestHandler] and #[Notification] attributes. No registration needed.

📢 Event Bus Publish events to multiple notification handlers, with priority control over execution order.

🎮 Attribute Routing Define routes directly on Action classes with #[Api], #[Prefix], #[Middleware], and more.

🔗 Pipelines Apply middleware-like logic (transactions, logging) globally or per-handler via #[Pipeline].

🧪 Testing Fakes Assert dispatched requests without executing business logic — built-in, no setup required.

🚀 Production Cache Eliminate discovery overhead (~2,500x faster boot) with php artisan mediator:cache.