Console Commands

The package provides several Artisan commands to speed up your workflow and manage the mediator.

🛠️ Generation Commands

Scaffold your classes instantly. All generation commands support a --root option to change the base directory (e.g., --root=Domain/Users).

Command	Description	Options
make:mediator-handler	Creates a Request and Handler class.	--action (adds Action), --root=Dir
make:mediator-action	Creates an Action and Request class.	--root=Dir
make:mediator-notification	Creates an Event and its Notification class.	--root=Dir

Examples:

# Uses default root folder (Handlers/)
php artisan make:mediator-handler RegisterUserHandler --action

# Changes root folder to Orders/
php artisan make:mediator-action CreateOrderAction --root=Orders

# Changes root folder to Domain/Events/
php artisan make:mediator-notification UserRegisteredNotification --root=Domain/Events

🔍 Information Commands

mediator:list

View all discovered or cached handlers, notifications, and actions in a clean console table.

php artisan mediator:list

Options:

• --handlers: List only Request Handlers.
• --events: List only Notifications.
• --actions: List only Actions.

Output Example:

  Handlers
+------------------------------------------+------------------------------------------+
| Request                                  | Handler                                  |
+------------------------------------------+------------------------------------------+
| App\Http\Handlers\RegisterUserRequest    | App\Http\Handlers\RegisterUserHandler    |
+------------------------------------------+------------------------------------------+

🚀 Production Optimization

In development, the package scans your directories to auto-discover attributes. In production, this file-system scanning overhead should be eliminated by caching the discovery results.

# Creates the cache file
php artisan mediator:cache 

# Clears the existing cache file
php artisan mediator:clear