feat: dispatch transactions events

cc cycle#96

src/Driver/Driver.php

@@ -16,6 +16,9 @@
 use Cycle\Database\Config\PDOConnectionConfig;
 use Cycle\Database\Config\ProvidesSourceString;
 use Cycle\Database\Event\QueryExecuted;
+use Cycle\Database\Event\TransactionBeginning;
+use Cycle\Database\Event\TransactionCommited;
+use Cycle\Database\Event\TransactionRolledBack;
 use Cycle\Database\EventDispatcherAwareInterface;
 use Cycle\Database\EventDispatcherAwareTrait;
 use Cycle\Database\Exception\DriverException;
@@ -358,6 +361,8 @@ public function beginTransaction(string $isolationLevel = null): bool
 
         $this->createSavepoint($this->transactionLevel);
 
+        $this->eventDispatcher?->dispatch(new TransactionBeginning($this));
+
         return true;
     }
 
@@ -399,6 +404,8 @@ public function commitTransaction(): bool
 
         $this->releaseSavepoint($this->transactionLevel + 1);
 
+        $this->eventDispatcher?->dispatch(new TransactionCommited($this));
+
         return true;
     }
 
@@ -436,6 +443,8 @@ public function rollbackTransaction(): bool
 
         $this->rollbackSavepoint($this->transactionLevel + 1);
 
+        $this->eventDispatcher?->dispatch(new TransactionRolledBack($this));
+
         return true;
     }
 

src/Event/AbstractDriverEvent.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Cycle\Database\Event;
+
+use Cycle\Database\Driver\DriverInterface;
+
+abstract class AbstractDriverEvent
+{
+    public function __construct(
+        public readonly DriverInterface $driver,
+    ) {
+    }
+}

src/Event/QueryExecuted.php

@@ -4,14 +4,15 @@
 
 use Cycle\Database\Driver\DriverInterface;
 
-class QueryExecuted
+final class QueryExecuted extends AbstractDriverEvent
 {
     public function __construct(
         public readonly string $query,
         public readonly array $params,
         public readonly float $queryStart,
         public readonly float $queryEnd,
-        public readonly DriverInterface $driver,
+        DriverInterface $driver,
     ) {
+        parent::__construct($driver);
     }
 }

src/Event/TransactionBeginning.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Cycle\Database\Event;
+
+use Cycle\Database\Event\AbstractDriverEvent;
+
+class TransactionBeginning extends AbstractDriverEvent
+{
+
+}

src/Event/TransactionCommited.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Cycle\Database\Event;
+
+class TransactionCommited extends AbstractDriverEvent
+{
+
+}

src/Event/TransactionRolledBack.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Cycle\Database\Event;
+
+class TransactionRolledBack extends AbstractDriverEvent
+{
+
+}