refactor: introduce Interface suffic

Author: chr-hertel

examples/cli/src/Builder.php

@@ -5,9 +5,9 @@
 use PhpLlm\McpSdk\Capability\PromptChain;
 use PhpLlm\McpSdk\Capability\ResourceChain;
 use PhpLlm\McpSdk\Capability\ToolChain;
-use PhpLlm\McpSdk\Server\NotificationHandler;
+use PhpLlm\McpSdk\Server\NotificationHandlerInterface;
 use PhpLlm\McpSdk\Server\NotificationHandler\InitializedHandler;
-use PhpLlm\McpSdk\Server\RequestHandler;
+use PhpLlm\McpSdk\Server\RequestHandlerInterface;
 use PhpLlm\McpSdk\Server\RequestHandler\InitializeHandler;
 use PhpLlm\McpSdk\Server\RequestHandler\PingHandler;
 use PhpLlm\McpSdk\Server\RequestHandler\PromptGetHandler;
@@ -20,7 +20,7 @@
 class Builder
 {
     /**
-     * @return list<RequestHandler>
+     * @return list<RequestHandlerInterface>
      */
     public static function buildRequestHandlers(): array
     {
@@ -49,7 +49,7 @@ public static function buildRequestHandlers(): array
     }
 
     /**
-     * @return list<NotificationHandler>
+     * @return list<NotificationHandlerInterface>
      */
     public static function buildNotificationHandlers(): array
     {

src/Server.php

@@ -5,7 +5,7 @@
 namespace PhpLlm\McpSdk;
 
 use PhpLlm\McpSdk\Server\JsonRpcHandler;
-use PhpLlm\McpSdk\Server\Transport;
+use PhpLlm\McpSdk\Server\TransportInterface;
 use Psr\Log\LoggerInterface;
 use Psr\Log\NullLogger;
 
@@ -17,7 +17,7 @@ public function __construct(
     ) {
     }
 
-    public function connect(Transport $transport): void
+    public function connect(TransportInterface $transport): void
     {
         $transport->initialize();
         $this->logger->info('Transport initialized');

src/Server/JsonRpcHandler.php

@@ -17,18 +17,18 @@
 readonly class JsonRpcHandler
 {
     /**
-     * @var array<int, RequestHandler>
+     * @var array<int, RequestHandlerInterface>
      */
     private array $requestHandlers;
 
     /**
-     * @var array<int, NotificationHandler>
+     * @var array<int, NotificationHandlerInterface>
      */
     private array $notificationHandlers;
 
     /**
-     * @param iterable<RequestHandler>      $requestHandlers
-     * @param iterable<NotificationHandler> $notificationHandlers
+     * @param iterable<RequestHandlerInterface>      $requestHandlers
+     * @param iterable<NotificationHandlerInterface> $notificationHandlers
      */
     public function __construct(
         private Factory $messageFactory,

src/Server/NotificationHandler/BaseNotificationHandler.php

@@ -5,9 +5,9 @@
 namespace PhpLlm\McpSdk\Server\NotificationHandler;
 
 use PhpLlm\McpSdk\Message\Notification;
-use PhpLlm\McpSdk\Server\NotificationHandler;
+use PhpLlm\McpSdk\Server\NotificationHandlerInterface;
 
-abstract class BaseNotificationHandler implements NotificationHandler
+abstract class BaseNotificationHandler implements NotificationHandlerInterface
 {
     public function supports(Notification $message): bool
     {

src/Server/NotificationHandler.php renamed to src/Server/NotificationHandlerInterface.php

@@ -6,7 +6,7 @@
 
 use PhpLlm\McpSdk\Message\Notification;
 
-interface NotificationHandler
+interface NotificationHandlerInterface
 {
     public function supports(Notification $message): bool;
 

src/Server/RequestHandler/BaseRequestHandler.php

@@ -5,9 +5,9 @@
 namespace PhpLlm\McpSdk\Server\RequestHandler;
 
 use PhpLlm\McpSdk\Message\Request;
-use PhpLlm\McpSdk\Server\RequestHandler;
+use PhpLlm\McpSdk\Server\RequestHandlerInterface;
 
-abstract class BaseRequestHandler implements RequestHandler
+abstract class BaseRequestHandler implements RequestHandlerInterface
 {
     public function supports(Request $message): bool
     {

src/Server/RequestHandler.php renamed to src/Server/RequestHandlerInterface.php

@@ -8,7 +8,7 @@
 use PhpLlm\McpSdk\Message\Request;
 use PhpLlm\McpSdk\Message\Response;
 
-interface RequestHandler
+interface RequestHandlerInterface
 {
     public function supports(Request $message): bool;
 

src/Server/Transport/Sse/Store/CachePoolStore.php

@@ -4,11 +4,11 @@
 
 namespace PhpLlm\McpSdk\Server\Transport\Sse\Store;
 
-use PhpLlm\McpSdk\Server\Transport\Sse\Store;
+use PhpLlm\McpSdk\Server\Transport\Sse\StoreInterface;
 use Psr\Cache\CacheItemPoolInterface;
 use Symfony\Component\Uid\Uuid;
 
-final readonly class CachePoolStore implements Store
+final readonly class CachePoolStore implements StoreInterface
 {
     public function __construct(
         private CacheItemPoolInterface $cachePool,

src/Server/Transport/Sse/Store.php renamed to src/Server/Transport/Sse/StoreInterface.php

@@ -6,7 +6,7 @@
 
 use Symfony\Component\Uid\Uuid;
 
-interface Store
+interface StoreInterface
 {
     public function push(Uuid $id, string $message): void;
 

src/Server/Transport/Sse/StreamTransport.php

@@ -4,14 +4,14 @@
 
 namespace PhpLlm\McpSdk\Server\Transport\Sse;
 
-use PhpLlm\McpSdk\Server\Transport;
+use PhpLlm\McpSdk\Server\TransportInterface;
 use Symfony\Component\Uid\Uuid;
 
-final readonly class StreamTransport implements Transport
+final readonly class StreamTransport implements TransportInterface
 {
     public function __construct(
         private string $messageEndpoint,
-        private Store $store,
+        private StoreInterface $store,
         private Uuid $id,
     ) {
     }

src/Server/Transport/Stdio/SymfonyConsoleTransport.php

@@ -4,15 +4,15 @@
 
 namespace PhpLlm\McpSdk\Server\Transport\Stdio;
 
-use PhpLlm\McpSdk\Server\Transport;
+use PhpLlm\McpSdk\Server\TransportInterface;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Input\StreamableInputInterface;
 use Symfony\Component\Console\Output\OutputInterface;
 
 /**
  * Heavily inspired by https://jolicode.com/blog/mcp-the-open-protocol-that-turns-llm-chatbots-into-intelligent-agents.
  */
-final class SymfonyConsoleTransport implements Transport
+final class SymfonyConsoleTransport implements TransportInterface
 {
     private string $buffer = '';
 

src/Server/Transport.php renamed to src/Server/TransportInterface.php

@@ -4,7 +4,7 @@
 
 namespace PhpLlm\McpSdk\Server;
 
-interface Transport
+interface TransportInterface
 {
     public function initialize(): void;
 

tests/Fixtures/InMemoryTransport.php

@@ -2,9 +2,9 @@
 
 namespace PhpLlm\McpSdk\Tests\Fixtures;
 
-use PhpLlm\McpSdk\Server\Transport;
+use PhpLlm\McpSdk\Server\TransportInterface;
 
-class InMemoryTransport implements Transport
+class InMemoryTransport implements TransportInterface
 {
     private bool $connected = true;