feat: Pass data to roll-back event

docs: Update docs

README.md

@@ -173,6 +173,16 @@ A roll-back can be conditional, so you can roll back an approval if a condition
 Approval::first()->rollback(fn () => true);
 ```
 
+### Events
+
+When a Model has been rolled back, a `ModelRolledBack` event will be fired with the Approval Model that was rolled back, as well as the User that rolled it back.
+
+```php
+// ModelRolledBackEvent::class
+
+public Model $approval,
+public Authenticatable|null $user,
+````
 ## Disable Approvals
 
 If you don't want Model data to be approved, you can bypass it with the `withoutApproval` method.

src/Events/ModelRolledBackEvent.php

@@ -2,14 +2,17 @@
 
 namespace Cjmellor\Approval\Events;
 
+use Illuminate\Contracts\Auth\Authenticatable;
+use Illuminate\Database\Eloquent\Model;
 use Illuminate\Foundation\Events\Dispatchable;
 
 class ModelRolledBackEvent
 {
     use Dispatchable;
 
-    public function __construct()
-    {
-        //
+    public function __construct(
+        public Model $approval,
+        public Authenticatable|null $user,
+    ) {
     }
 }

src/Models/Approval.php

@@ -97,6 +97,6 @@ public function rollback(Closure $condition = null): void
             'rolled_back_at' => now(),
         ]);
 
-        Event::dispatch(new ModelRolledBackEvent($this));
+        Event::dispatch(new ModelRolledBackEvent(approval: $this, user: auth()->user()));
     }
 }

tests/Feature/Models/ApprovalTest.php

@@ -35,10 +35,13 @@
         ->rolled_back_at->not->toBeNull();
 
     // Assert the Events were fired
-    Event::assertDispatched(ModelRolledBackEvent::class);
+    Event::assertDispatched(function (ModelRolledBackEvent $event) use ($fakeModel): bool {
+        return $event->approval->is($fakeModel->fresh()->approvals()->first())
+            && $event->user === null;
+    });
 });
 
-test('a rolled back Approval can be conditionally set', function () {
+test(description: 'a rolled back Approval can be conditionally set', closure: function () {
     // Build a query
     $fakeModel = new FakeModel();