Added abstract BoltException to simplify catch of bolt expcetions

Author: stefanak-michal

src/Bolt.php

@@ -3,7 +3,7 @@
 namespace Bolt;
 
 use Bolt\error\ConnectException;
-use Exception;
+use Bolt\error\BoltException;
 use Bolt\protocol\{AProtocol, ServerState};
 use Bolt\connection\IConnection;
 
@@ -31,7 +31,7 @@ public function __construct(private IConnection $connection)
 
     /**
      * Connect via Connection, execute handshake on it, create and return protocol version class
-     * @throws Exception
+     * @throws BoltException
      */
     public function build(): AProtocol
     {
@@ -80,7 +80,7 @@ public function setConnection(IConnection $connection): Bolt
 
     /**
      * @link https://www.neo4j.com/docs/bolt/current/bolt/handshake/
-     * @throws Exception
+     * @throws BoltException
      */
     private function handshake(): string
     {

src/connection/IConnection.php

@@ -2,6 +2,8 @@
 
 namespace Bolt\connection;
 
+use Bolt\error\ConnectException;
+
 /**
  * Interface IConnection
  *
@@ -13,10 +15,19 @@ interface IConnection
 {
     public function __construct(string $ip = '127.0.0.1', int $port = 7687, float $timeout = 15);
 
+    /**
+     * @throws ConnectException
+     */
     public function connect(): bool;
 
+    /**
+     * @throws ConnectException
+     */
     public function write(string $buffer): void;
 
+    /**
+     * @throws ConnectException
+     */
     public function read(int $length = 2048): string;
 
     public function disconnect(): void;

src/connection/Socket.php

@@ -22,9 +22,6 @@ class Socket extends AConnection
 
     private const POSSIBLE_TIMEOUTS_CODES = [11, 10060];
 
-    /**
-     * @throws ConnectException
-     */
     public function connect(): bool
     {
         if (!extension_loaded('sockets')) {
@@ -53,9 +50,6 @@ public function connect(): bool
         return true;
     }
 
-    /**
-     * @throws ConnectException
-     */
     public function write(string $buffer): void
     {
         if ($this->socket === false) {
@@ -75,9 +69,6 @@ public function write(string $buffer): void
         }
     }
 
-    /**
-     * @throws ConnectException
-     */
     public function read(int $length = 2048): string
     {
         if ($this->socket === false)

src/connection/StreamSocket.php

@@ -32,9 +32,6 @@ public function setSslContextOptions(array $options): void
         $this->sslContextOptions = $options;
     }
 
-    /**
-     * @throws ConnectException
-     */
     public function connect(): bool
     {
         $context = stream_context_create([
@@ -65,9 +62,6 @@ public function connect(): bool
         return true;
     }
 
-    /**
-     * @throws ConnectException
-     */
     public function write(string $buffer): void
     {
         if (Bolt::$debug)
@@ -91,9 +85,6 @@ public function write(string $buffer): void
         }
     }
 
-    /**
-     * @throws ConnectException
-     */
     public function read(int $length = 2048): string
     {
         $output = '';

src/error/BoltException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Bolt\error;
+
+/**
+ * Class BoltException
+ * @package Bolt\error
+ */
+abstract class BoltException extends \Exception
+{
+
+}

src/error/ConnectException.php

@@ -2,16 +2,14 @@
 
 namespace Bolt\error;
 
-use Exception;
-
 /**
  * Class ConnectException
  *
  * @author Michal Stefanak
  * @link https://github.com/neo4j-php/Bolt
  * @package Bolt\error
  */
-class ConnectException extends Exception
+class ConnectException extends BoltException
 {
 
 }

src/error/PackException.php

@@ -2,16 +2,14 @@
 
 namespace Bolt\error;
 
-use Exception;
-
 /**
  * Class PackException
  *
  * @author Michal Stefanak
  * @link https://github.com/neo4j-php/Bolt
  * @package Bolt\error
  */
-class PackException extends Exception
+class PackException extends BoltException
 {
 
 }

src/error/UnpackException.php

@@ -2,16 +2,14 @@
 
 namespace Bolt\error;
 
-use Exception;
-
 /**
  * Class UnpackException
  *
  * @author Michal Stefanak
  * @link https://github.com/neo4j-php/Bolt
  * @package Bolt\error
  */
-class UnpackException extends Exception
+class UnpackException extends BoltException
 {
 
 }

src/packstream/IPacker.php

@@ -2,6 +2,8 @@
 
 namespace Bolt\packstream;
 
+use Bolt\error\PackException;
+
 /**
  * Interface IPacker
  *
@@ -18,6 +20,7 @@ public function __construct(array $structuresLt = []);
 
     /**
      * Pack message
+     * @throws PackException
      */
     public function pack(int $signature, mixed ...$params): iterable;
 }

src/packstream/IUnpacker.php

@@ -2,6 +2,8 @@
 
 namespace Bolt\packstream;
 
+use Bolt\error\UnpackException;
+
 /**
  * Interface IUnpacker
  *
@@ -18,6 +20,7 @@ public function __construct(array $structuresLt = []);
 
     /**
      * Unpack message
+     * @throws UnpackException
      */
     public function unpack(string $msg): mixed;