Add UUID column support

composer.json

@@ -12,7 +12,8 @@
         }
     ],
     "require": {
-        "php": "^8.1"
+        "php": "^8.1",
+        "ramsey/uuid": "^4.0"
     },
     "require-dev": {
         "phpunit/phpunit": "^10.1",

src/ColumnBuilder.php

@@ -4,6 +4,7 @@
 
 use Composite\Entity\Columns;
 use Composite\Entity\Exceptions\EntityException;
+use Ramsey\Uuid\UuidInterface;
 
 class ColumnBuilder
 {
@@ -14,6 +15,7 @@ class ColumnBuilder
         'float' => Columns\FloatColumn::class,
         'int' => Columns\IntegerColumn::class,
         'string' => Columns\StringColumn::class,
+        UuidInterface::class => Columns\UuidColumn::class,
         \stdClass::class => Columns\ObjectColumn::class,
         \DateTime::class => Columns\DateTimeColumn::class,
         \DateTimeImmutable::class => Columns\DateTimeColumn::class,

src/Columns/UuidColumn.php

@@ -0,0 +1,23 @@
+<?php declare(strict_types=1);
+
+namespace Composite\Entity\Columns;
+
+use Ramsey\Uuid\Uuid;
+use Ramsey\Uuid\UuidInterface;
+
+class UuidColumn extends AbstractColumn
+{
+    public function cast(mixed $dbValue): UuidInterface
+    {
+        return Uuid::fromString((string)$dbValue);
+    }
+
+    /**
+     * @param UuidInterface $entityValue
+     * @return string
+     */
+    public function uncast(mixed $entityValue): string
+    {
+        return $entityValue->toString();
+    }
+}

tests/Columns/UuidColumnTest.php

@@ -0,0 +1,83 @@
+<?php declare(strict_types=1);
+
+namespace Composite\Entity\Tests\Columns;
+
+use Composite\Entity\AbstractEntity;
+use Ramsey\Uuid\Uuid;
+use Ramsey\Uuid\UuidInterface;
+
+final class UuidColumnTest extends \PHPUnit\Framework\TestCase
+{
+    public static function cast_dataProvider(): array
+    {
+        return [
+            [
+                'value' => null,
+                'expected' => null,
+            ],
+            [
+                'value' => '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
+                'expected' => Uuid::fromString('6ba7b810-9dad-11d1-80b4-00c04fd430c8'),
+            ],
+            [
+                'value' => '550e8400-e29b-41d4-a716-446655440000',
+                'expected' => Uuid::fromString('550e8400-e29b-41d4-a716-446655440000'),
+            ],
+            [
+                'value' => 'invalid_uuid',
+                'expected' => null,
+            ],
+        ];
+    }
+
+    /**
+     * @dataProvider cast_dataProvider
+     */
+    public function test_cast(mixed $value, ?UuidInterface $expected): void
+    {
+        $class = new class extends AbstractEntity {
+            public function __construct(
+                public ?UuidInterface $column = null,
+            ) {}
+        };
+        $entity = $class::fromArray(['column' => $value]);
+        $this->assertEquals($expected, $entity->column);
+    }
+
+    public static function uncast_dataProvider(): array
+    {
+        return [
+            [
+                'value' => null,
+                'expected' => null,
+            ],
+            [
+                'value' => Uuid::fromString('6ba7b810-9dad-11d1-80b4-00c04fd430c8'),
+                'expected' => '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
+            ],
+            [
+                'value' => Uuid::fromString('550e8400-e29b-41d4-a716-446655440000'),
+                'expected' => '550e8400-e29b-41d4-a716-446655440000',
+            ],
+        ];
+    }
+
+    /**
+     * @dataProvider uncast_dataProvider
+     */
+    public function test_uncast(?UuidInterface $value, mixed $expected): void
+    {
+        $entity = new class($value) extends AbstractEntity {
+            public function __construct(
+                public ?UuidInterface $column,
+            ) {}
+        };
+        $actual = $entity->toArray()['column'];
+        $this->assertEquals($expected, $actual);
+
+        $newEntity = $entity::fromArray(['column' => $actual]);
+        $newActual = $newEntity->toArray()['column'];
+        $this->assertEquals($entity->column, $newEntity->column);
+        $this->assertEquals($expected, $newActual);
+    }
+}