Merge branch 'develop'

* develop:
  specify next release
  add Connection::intercept()

Author: Baptouuuu

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 5.1.0 - 2026-03-21
+
+### Added
+
+- Internal `Formal\AccessLayer\Connection::intercept()`
+
 ## 5.0.0 - 2026-02-07
 
 ### Added

src/Connection.php

@@ -7,6 +7,7 @@
     Connection\Implementation,
     Connection\PDO,
     Connection\Logger,
+    Connection\Intercept,
     Exception\QueryFailed,
 };
 use Innmind\Url\Url;
@@ -51,4 +52,19 @@ public static function logger(self $connection, LoggerInterface $logger): self
             $logger,
         ));
     }
+
+    /**
+     * @internal
+     *
+     * @param callable(callable(Query|Query\Builder): Sequence<Row>, Driver, Query|Query\Builder): Sequence<Row> $intercept
+     */
+    public static function intercept(
+        self $connection,
+        callable $intercept,
+    ): self {
+        return new self(Intercept::of(
+            $connection->implementation,
+            \Closure::fromCallable($intercept),
+        ));
+    }
 }

src/Connection/Intercept.php

@@ -0,0 +1,52 @@
+<?php
+declare(strict_types = 1);
+
+namespace Formal\AccessLayer\Connection;
+
+use Formal\AccessLayer\{
+    Query,
+    Driver,
+    Row,
+};
+use Innmind\Immutable\Sequence;
+
+/**
+ * @internal
+ */
+final class Intercept implements Implementation
+{
+    /**
+     * @param \Closure(callable(Query|Query\Builder): Sequence<Row>, Driver, Query|Query\Builder): Sequence<Row> $intercept
+     */
+    private function __construct(
+        private Implementation $connection,
+        private \Closure $intercept,
+    ) {
+    }
+
+    #[\Override]
+    public function __invoke(Query|Query\Builder $query): Sequence
+    {
+        return ($this->intercept)(
+            fn(Query|Query\Builder $query) => ($this->connection)($query),
+            $this->connection->driver(),
+            $query,
+        );
+    }
+
+    /**
+     * @internal
+     *
+     * @param \Closure(callable(Query|Query\Builder): Sequence<Row>, Driver, Query|Query\Builder): Sequence<Row> $intercept
+     */
+    public static function of(Implementation $connection, \Closure $intercept): self
+    {
+        return new self($connection, $intercept);
+    }
+
+    #[\Override]
+    public function driver(): Driver
+    {
+        return $this->connection->driver();
+    }
+}