feat: Add verifyApiToken() function. (#2)

Author: goloroden

src/Client.php

@@ -39,4 +39,31 @@ public function ping(): void
             throw new RuntimeException('Failed to ping');
         }
     }
+
+    public function verifyApiToken(): void
+    {
+        $response = $this->httpClient->post(
+            '/api/v1/verify-api-token',
+            [
+                'headers' => [
+                    'Authorization' => 'Bearer ' . $this->apiToken,
+                ],
+            ],
+        );
+        $status = $response->getStatusCode();
+
+        if ($status !== 200) {
+            throw new RuntimeException(sprintf(
+                "Failed to verify API token, got HTTP status code '%d', expected '200'",
+                $status
+            ));
+        }
+
+        $body = (string) $response->getBody();
+        $data = json_decode($body, true);
+
+        if (!isset($data['type']) || $data['type'] !== 'io.eventsourcingdb.api.api-token-verified') {
+            throw new RuntimeException('Failed to verify API token');
+        }
+    }
 }

src/Container.php

@@ -10,15 +10,14 @@
 class Container
 {
     private string $imageName = 'thenativeweb/eventsourcingdb';
-    private string $imageTag;
+    private string $imageTag = 'latest';
     private int $internalPort = 3000;
     private string $apiToken = 'secret';
     private ?StartedGenericContainer $container = null;
     private HttpClient $httpClient;
 
     public function __construct()
     {
-        $this->imageTag = $this->getImageVersionFromDockerfile();
         $this->httpClient = new HttpClient([
             'http_errors' => false
         ]);
@@ -124,20 +123,4 @@ private function ensureRunning(): void
             throw new \RuntimeException('Container must be running');
         }
     }
-
-    private function getImageVersionFromDockerfile(): string
-    {
-        $dockerfile = __DIR__ . '/../docker/Dockerfile';
-
-        if (!file_exists($dockerfile)) {
-            throw new \RuntimeException('Dockerfile not found at ' . $dockerfile);
-        }
-
-        $content = file_get_contents($dockerfile);
-        if (!preg_match('/^FROM\s+thenativeweb\/eventsourcingdb:(.+)$/m', $content, $matches)) {
-            throw new \RuntimeException('Failed to extract image version from Dockerfile');
-        }
-
-        return trim($matches[1]);
-    }
 }

tests/ClientTest.php

@@ -8,7 +8,8 @@ class ClientTest extends TestCase
 {
     public function testPingSucceedsWhenServerIsReachable(): void
     {
-        $container = new Container();
+        $imageVersion = $this->getImageVersionFromDockerfile();
+        $container = new Container()->withImageTag($imageVersion);
         $container->start();
         try {
             $client = $container->getClient();
@@ -21,7 +22,8 @@ public function testPingSucceedsWhenServerIsReachable(): void
 
     public function testPingFailsWhenServerIsUnreachable(): void
     {
-        $container = new Container();
+        $imageVersion = $this->getImageVersionFromDockerfile();
+        $container = new Container()->withImageTag($imageVersion);
         $container->start();
         try {
             $port = $container->getMappedPort();
@@ -33,4 +35,50 @@ public function testPingFailsWhenServerIsUnreachable(): void
             $container->stop();
         }
     }
+
+    public function testVerifyApiTokenDoesNotThrowAnErrorIfTheTokenIsValid(): void
+    {
+        $imageVersion = $this->getImageVersionFromDockerfile();
+        $container = new Container()->withImageTag($imageVersion);
+        $container->start();
+        try {
+            $client = $container->getClient();
+            $client->verifyApiToken();
+            $this->expectNotToPerformAssertions();
+        } finally {
+            $container->stop();
+        }
+    }
+
+    public function testVerifyApiTokenThrowsAnErrorIfTheTokenIsInvalid(): void
+    {
+        $imageVersion = $this->getImageVersionFromDockerfile();
+        $container = new Container()->withImageTag($imageVersion);
+        $container->start();
+        try {
+            $baseUrl = $container->getBaseUrl();
+            $apiToken = $container->getApiToken() . '-invalid';
+            $client = new Client($baseUrl, $apiToken);
+            $this->expectException(Throwable::class);
+            $client->verifyApiToken();
+        } finally {
+            $container->stop();
+        }
+    }
+
+    private function getImageVersionFromDockerfile(): string
+    {
+        $dockerfile = __DIR__ . '/../docker/Dockerfile';
+
+        if (!file_exists($dockerfile)) {
+            throw new \RuntimeException('Dockerfile not found at ' . $dockerfile);
+        }
+
+        $content = file_get_contents($dockerfile);
+        if (!preg_match('/^FROM\s+thenativeweb\/eventsourcingdb:(.+)$/m', $content, $matches)) {
+            throw new \RuntimeException('Failed to extract image version from Dockerfile');
+        }
+
+        return trim($matches[1]);
+    }
 }