add enum support

Author: jakubkulhan

data-access-kit/src/Converter/DefaultValueConverter.php

@@ -10,7 +10,11 @@
 use DateTimeImmutable;
 use DateTimeZone;
 use ReflectionNamedType;
+use ReflectionEnum;
+use BackedEnum;
+use UnitEnum;
 use stdClass;
+use function enum_exists;
 use function in_array;
 use function is_object;
 use function json_decode;
@@ -74,6 +78,14 @@ public function objectToDatabase(Table $table, Column $column, mixed $value, boo
 				} else if (in_array($valueType->getName(), [DateTime::class, DateTimeImmutable::class], true)) {
 					/** @var DateTime|DateTimeImmutable $value */
 					$returnValue = (clone $value)->setTimezone($this->dateTimeZone)->format($this->dateTimeFormat);
+				} else if (enum_exists($valueType->getName())) {
+					/** @var BackedEnum|UnitEnum $value */
+					if ($value instanceof BackedEnum) {
+						$returnValue = $value->value;
+					} else {
+						// Unit enum - store the name
+						$returnValue = $value->name;
+					}
 				} else if (null !== ($nestedTable = $this->registry->maybeGet($valueType->getName()))) {
 					$jsonObject = new stdClass();
 					foreach ($nestedTable->columns as $nestedColumn) {
@@ -161,6 +173,35 @@ public function databaseToObject(Table $table, Column $column, mixed $value, boo
 						));
 					}
 				}
+			} else if (enum_exists($valueType->getName())) {
+				/** @var class-string<BackedEnum|UnitEnum> $className */
+				$className = $valueType->getName();
+				$enumReflection = new ReflectionEnum($className);
+				
+				if ($enumReflection->isBacked()) {
+					// Backed enum - use from() method
+					/** @var class-string<BackedEnum> $className */
+					$returnValue = $className::from($value);
+				} else {
+					// Unit enum - find case by name
+					$cases = $enumReflection->getCases();
+					$returnValue = null;
+					foreach ($cases as $case) {
+						if ($case->getName() === $value) {
+							$returnValue = $case->getValue();
+							break;
+						}
+					}
+					if ($returnValue === null) {
+						throw new ConverterException(sprintf(
+							"Could not find enum case [%s] for enum [%s] in property [%s::\$%s].",
+							$value,
+							$className,
+							$table->reflection->getName(),
+							$column->reflection->getName()
+						));
+					}
+				}
 			} else if (null !== ($nestedTable = $this->registry->maybeGet($valueType->getName()))) {
 				$jsonObject = $decode ? json_decode($value) : $value;
 				$nestedObject = $nestedTable->reflection->newInstanceWithoutConstructor();

data-access-kit/test/Converter/DefaultValueConverterTest.php

@@ -6,6 +6,9 @@
 use DataAccessKit\Attribute\Table;
 use DataAccessKit\Converter\Fixture\DeepNestedObject;
 use DataAccessKit\Converter\Fixture\NestedObject;
+use DataAccessKit\Converter\Fixture\StatusEnum;
+use DataAccessKit\Converter\Fixture\PriorityEnum;
+use DataAccessKit\Converter\Fixture\UnitEnum;
 use DataAccessKit\Registry;
 use DateTime;
 use DateTimeImmutable;
@@ -100,6 +103,15 @@ public static function data()
 			#[Column] public DeepNestedObject $deepNestedObject;
 			#[Column] public ?DeepNestedObject $nullableDeepNestedObjectNull;
 			#[Column] public ?DeepNestedObject $nullableDeepNestedObjectNotNull;
+			#[Column] public StatusEnum $statusEnum;
+			#[Column] public ?StatusEnum $nullableStatusEnumNull;
+			#[Column] public ?StatusEnum $nullableStatusEnumNotNull;
+			#[Column] public PriorityEnum $priorityEnum;
+			#[Column] public ?PriorityEnum $nullablePriorityEnumNull;
+			#[Column] public ?PriorityEnum $nullablePriorityEnumNotNull;
+			#[Column] public UnitEnum $unitEnum;
+			#[Column] public ?UnitEnum $nullableUnitEnumNull;
+			#[Column] public ?UnitEnum $nullableUnitEnumNotNull;
 		});
 
 		$data = [
@@ -139,6 +151,15 @@ public static function data()
 			"deepNestedObject" => [new DeepNestedObject(new DeepNestedObject()), '{"nested":{"nested":null}}'],
 			"nullableDeepNestedObjectNull" => [null, null],
 			"nullableDeepNestedObjectNotNull" => [new DeepNestedObject(new DeepNestedObject()), '{"nested":{"nested":null}}'],
+			"statusEnum" => [StatusEnum::Active, 'active'],
+			"nullableStatusEnumNull" => [null, null],
+			"nullableStatusEnumNotNull" => [StatusEnum::Pending, 'pending'],
+			"priorityEnum" => [PriorityEnum::High, 3],
+			"nullablePriorityEnumNull" => [null, null],
+			"nullablePriorityEnumNotNull" => [PriorityEnum::Medium, 2],
+			"unitEnum" => [UnitEnum::Red, 'Red'],
+			"nullableUnitEnumNull" => [null, null],
+			"nullableUnitEnumNotNull" => [UnitEnum::Blue, 'Blue'],
 		];
 		foreach ($data as $columnName => [$objectValue, $databaseValue]) {
 			yield $columnName => [$table, $table->columns[$columnName], $objectValue, $databaseValue];

data-access-kit/test/Converter/Fixture/PriorityEnum.php

@@ -0,0 +1,10 @@
+<?php declare(strict_types=1);
+
+namespace DataAccessKit\Converter\Fixture;
+
+enum PriorityEnum: int
+{
+	case Low = 1;
+	case Medium = 2;
+	case High = 3;
+} 

data-access-kit/test/Converter/Fixture/StatusEnum.php

@@ -0,0 +1,10 @@
+<?php declare(strict_types=1);
+
+namespace DataAccessKit\Converter\Fixture;
+
+enum StatusEnum: string
+{
+	case Active = 'active';
+	case Inactive = 'inactive';
+	case Pending = 'pending';
+} 

data-access-kit/test/Converter/Fixture/UnitEnum.php

@@ -0,0 +1,10 @@
+<?php declare(strict_types=1);
+
+namespace DataAccessKit\Converter\Fixture;
+
+enum UnitEnum
+{
+	case Red;
+	case Green;
+	case Blue;
+}