Add JsonRpcRequest and abstract Request

Author: paulbalandan

src/Message/JsonRpcRequest.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of the Nexus MCP SDK package.
+ *
+ * (c) 2025 John Paul E. Balandan, CPA <[email protected]>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Nexus\Mcp\Message;
+
+/**
+ * A request that expects a response.
+ */
+final readonly class JsonRpcRequest extends Request
+{
+    public function __construct(
+        public RequestId $requestId,
+        string $jsonrpc,
+        string $method,
+        ?array $params = null,
+    ) {
+        parent::__construct($jsonrpc, $method, $params);
+    }
+
+    /**
+     * @return array{
+     *   jsonrpc: non-empty-string,
+     *   id: int|non-empty-string,
+     *   method: non-empty-string,
+     *   params?: null|array<string, mixed>,
+     * }
+     */
+    #[\Override]
+    public function toArray(): array
+    {
+        return array_filter([
+            'jsonrpc' => $this->jsonrpc,
+            'id' => $this->requestId->id,
+            'method' => $this->method,
+            'params' => $this->params,
+        ], static fn(mixed $value): bool => null !== $value);
+    }
+}

src/Message/Request.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of the Nexus MCP SDK package.
+ *
+ * (c) 2025 John Paul E. Balandan, CPA <[email protected]>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Nexus\Mcp\Message;
+
+/**
+ * The base JSON-RPC request object.
+ */
+abstract readonly class Request extends Message
+{
+    /**
+     * @param non-empty-string          $jsonrpc
+     * @param non-empty-string          $method
+     * @param null|array<string, mixed> $params
+     */
+    public function __construct(
+        string $jsonrpc,
+        public string $method,
+        public ?array $params = null,
+    ) {
+        parent::__construct($jsonrpc);
+    }
+}

tests/Message/JsonRpcRequestTest.php

@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of the Nexus MCP SDK package.
+ *
+ * (c) 2025 John Paul E. Balandan, CPA <[email protected]>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Nexus\Mcp\Tests\Message;
+
+use Nexus\Mcp\Message\JsonRpcRequest;
+use Nexus\Mcp\Message\Request;
+use Nexus\Mcp\Message\RequestId;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * @internal
+ */
+#[CoversClass(JsonRpcRequest::class)]
+#[CoversClass(Request::class)]
+final class JsonRpcRequestTest extends TestCase
+{
+    public function testRequestCanBeJsonSerialized(): void
+    {
+        $request = new JsonRpcRequest(RequestId::fromId('123'), '2.0', 'initialize');
+        self::assertSame([
+            'jsonrpc' => '2.0',
+            'id' => '123',
+            'method' => 'initialize',
+        ], $request->toArray());
+        self::assertSame('{"jsonrpc":"2.0","id":"123","method":"initialize"}', json_encode($request));
+    }
+
+    public function testRequestWithParamsCanBeJsonSerialized(): void
+    {
+        $request = new JsonRpcRequest(
+            RequestId::fromId('123'),
+            '2.0',
+            'initialize',
+            ['param1' => 'value1', 'param2' => 'value2']
+        );
+        self::assertSame([
+            'jsonrpc' => '2.0',
+            'id' => '123',
+            'method' => 'initialize',
+            'params' => ['param1' => 'value1', 'param2' => 'value2'],
+        ], $request->toArray());
+        self::assertSame(
+            '{"jsonrpc":"2.0","id":"123","method":"initialize","params":{"param1":"value1","param2":"value2"}}',
+            json_encode($request)
+        );
+    }
+}