test: adds DTO tests

Author: JasonTheAdams

tests/unit/Providers/DTO/ProviderMetadataTest.php

@@ -0,0 +1,225 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WordPress\AiClient\Tests\unit\Providers\DTO;
+
+use PHPUnit\Framework\TestCase;
+use WordPress\AiClient\Providers\DTO\ProviderMetadata;
+use WordPress\AiClient\Providers\Enums\ProviderTypeEnum;
+
+/**
+ * @covers \WordPress\AiClient\Providers\DTO\ProviderMetadata
+ */
+class ProviderMetadataTest extends TestCase
+{
+    /**
+     * Tests constructor and getter methods.
+     *
+     * @return void
+     */
+    public function testConstructorAndGetters(): void
+    {
+        $id = 'openai';
+        $name = 'OpenAI';
+        $type = ProviderTypeEnum::cloud();
+
+        $metadata = new ProviderMetadata($id, $name, $type);
+
+        $this->assertEquals($id, $metadata->getId());
+        $this->assertEquals($name, $metadata->getName());
+        $this->assertSame($type, $metadata->getType());
+        $this->assertTrue($metadata->getType()->isCloud());
+    }
+
+    /**
+     * Tests different provider types.
+     *
+     * @return void
+     */
+    public function testDifferentProviderTypes(): void
+    {
+        // Test cloud provider
+        $cloudProvider = new ProviderMetadata('google', 'Google AI', ProviderTypeEnum::cloud());
+        $this->assertTrue($cloudProvider->getType()->isCloud());
+        $this->assertFalse($cloudProvider->getType()->isServer());
+        $this->assertFalse($cloudProvider->getType()->isClient());
+
+        // Test server provider
+        $serverProvider = new ProviderMetadata('llama', 'LLaMA', ProviderTypeEnum::server());
+        $this->assertFalse($serverProvider->getType()->isCloud());
+        $this->assertTrue($serverProvider->getType()->isServer());
+        $this->assertFalse($serverProvider->getType()->isClient());
+
+        // Test client provider
+        $clientProvider = new ProviderMetadata('browser-ai', 'Browser AI', ProviderTypeEnum::client());
+        $this->assertFalse($clientProvider->getType()->isCloud());
+        $this->assertFalse($clientProvider->getType()->isServer());
+        $this->assertTrue($clientProvider->getType()->isClient());
+    }
+
+    /**
+     * Tests JSON schema generation.
+     *
+     * @return void
+     */
+    public function testGetJsonSchema(): void
+    {
+        $schema = ProviderMetadata::getJsonSchema();
+
+        $this->assertIsArray($schema);
+        $this->assertEquals('object', $schema['type']);
+
+        // Check properties
+        $this->assertArrayHasKey('properties', $schema);
+        $this->assertArrayHasKey('id', $schema['properties']);
+        $this->assertArrayHasKey('name', $schema['properties']);
+        $this->assertArrayHasKey('type', $schema['properties']);
+
+        // Check property types
+        $this->assertEquals('string', $schema['properties']['id']['type']);
+        $this->assertEquals('string', $schema['properties']['name']['type']);
+        $this->assertEquals('string', $schema['properties']['type']['type']);
+
+        // Check enum values for type
+        $this->assertArrayHasKey('enum', $schema['properties']['type']);
+        $this->assertEquals(ProviderTypeEnum::getValues(), $schema['properties']['type']['enum']);
+
+        // Check required fields
+        $this->assertArrayHasKey('required', $schema);
+        $this->assertEquals(['id', 'name', 'type'], $schema['required']);
+    }
+
+    /**
+     * Tests array conversion.
+     *
+     * @return void
+     */
+    public function testToArray(): void
+    {
+        $metadata = new ProviderMetadata('anthropic', 'Anthropic', ProviderTypeEnum::cloud());
+        $array = $metadata->toArray();
+
+        $this->assertIsArray($array);
+        $this->assertEquals('anthropic', $array['id']);
+        $this->assertEquals('Anthropic', $array['name']);
+        $this->assertEquals('cloud', $array['type']);
+        $this->assertCount(3, $array);
+    }
+
+    /**
+     * Tests creating from array.
+     *
+     * @return void
+     */
+    public function testFromArray(): void
+    {
+        $data = [
+            'id' => 'custom-provider',
+            'name' => 'Custom Provider',
+            'type' => 'server'
+        ];
+
+        $metadata = ProviderMetadata::fromArray($data);
+
+        $this->assertInstanceOf(ProviderMetadata::class, $metadata);
+        $this->assertEquals('custom-provider', $metadata->getId());
+        $this->assertEquals('Custom Provider', $metadata->getName());
+        $this->assertTrue($metadata->getType()->isServer());
+    }
+
+    /**
+     * Tests round-trip array transformation.
+     *
+     * @return void
+     */
+    public function testArrayRoundTrip(): void
+    {
+        $original = new ProviderMetadata('test-provider', 'Test Provider', ProviderTypeEnum::client());
+        $array = $original->toArray();
+        $restored = ProviderMetadata::fromArray($array);
+
+        $this->assertEquals($original->getId(), $restored->getId());
+        $this->assertEquals($original->getName(), $restored->getName());
+        $this->assertEquals($original->getType()->value, $restored->getType()->value);
+    }
+
+    /**
+     * Tests JSON serialization.
+     *
+     * @return void
+     */
+    public function testJsonSerialize(): void
+    {
+        $metadata = new ProviderMetadata('json-provider', 'JSON Provider', ProviderTypeEnum::cloud());
+        $json = json_encode($metadata);
+        $decoded = json_decode($json, true);
+
+        $this->assertIsString($json);
+        $this->assertIsArray($decoded);
+        $this->assertEquals('json-provider', $decoded['id']);
+        $this->assertEquals('JSON Provider', $decoded['name']);
+        $this->assertEquals('cloud', $decoded['type']);
+    }
+
+    /**
+     * Tests with special characters in names.
+     *
+     * @return void
+     */
+    public function testSpecialCharactersInNames(): void
+    {
+        $metadata = new ProviderMetadata(
+            'special-chars',
+            'Provider with "quotes" & special <chars>',
+            ProviderTypeEnum::cloud()
+        );
+
+        $array = $metadata->toArray();
+        $this->assertEquals('Provider with "quotes" & special <chars>', $array['name']);
+
+        $restored = ProviderMetadata::fromArray($array);
+        $this->assertEquals($metadata->getName(), $restored->getName());
+    }
+
+    /**
+     * Tests with empty strings.
+     *
+     * @return void
+     */
+    public function testEmptyStrings(): void
+    {
+        $metadata = new ProviderMetadata('', '', ProviderTypeEnum::cloud());
+
+        $this->assertEquals('', $metadata->getId());
+        $this->assertEquals('', $metadata->getName());
+
+        $array = $metadata->toArray();
+        $this->assertEquals('', $array['id']);
+        $this->assertEquals('', $array['name']);
+    }
+
+    /**
+     * Tests implements correct interfaces.
+     *
+     * @return void
+     */
+    public function testImplementsCorrectInterfaces(): void
+    {
+        $metadata = new ProviderMetadata('test', 'Test', ProviderTypeEnum::cloud());
+
+        $this->assertInstanceOf(
+            \WordPress\AiClient\Common\Contracts\WithArrayTransformationInterface::class,
+            $metadata
+        );
+        $this->assertInstanceOf(
+            \WordPress\AiClient\Common\Contracts\WithJsonSchemaInterface::class,
+            $metadata
+        );
+        $this->assertInstanceOf(
+            \JsonSerializable::class,
+            $metadata
+        );
+    }
+}
+