Add Enum support to Str type

Author: tobyzerner

src/Schema/Type/Str.php

@@ -2,6 +2,9 @@
 
 namespace Tobyz\JsonApiServer\Schema\Type;
 
+use BackedEnum;
+use UnitEnum;
+
 class Str implements Type
 {
     public int $minLength = 0;
@@ -17,6 +20,10 @@ public static function make(): static
 
     public function serialize(mixed $value): string
     {
+        if ($value instanceof UnitEnum) {
+            return $this->getEnumValue($value);
+        }
+
         return (string) $value;
     }
 
@@ -32,9 +39,12 @@ public function validate(mixed $value, callable $fail): void
             return;
         }
 
-        if ($this->enum !== null && !in_array($value, $this->enum, true)) {
-            $enum = array_map(fn($value) => '"' . $value . '"', $this->enum);
-            $fail(sprintf('must be one of %s', implode(', ', $enum)));
+        if ($this->enum !== null) {
+            $enumValues = array_map($this->getEnumValue(...), $this->enum);
+            if (!in_array($value, $enumValues, true)) {
+                $enum = array_map(fn($value) => '"' . $value . '"', $enumValues);
+                $fail(sprintf('must be one of %s', implode(', ', $enum)));
+            }
         }
 
         if (strlen($value) < $this->minLength) {
@@ -74,7 +84,8 @@ public function schema(): array
         }
 
         if ($this->enum !== null) {
-            $schema['enum'] = $this->enum;
+            $schema['enum'] = array_map($this->getEnumValue(...), $this->enum);
+            $schema['x-enum-varnames'] = array_map($this->getEnumName(...), $this->enum);
         }
 
         return $schema;
@@ -114,4 +125,26 @@ public function enum(?array $enum): static
 
         return $this;
     }
+
+    private function getEnumValue(string|UnitEnum $value): string
+    {
+        if ($value instanceof BackedEnum) {
+            return $value->value;
+        }
+
+        if ($value instanceof UnitEnum) {
+            return $value->name;
+        }
+
+        return $value;
+    }
+
+    private function getEnumName(string|UnitEnum $value): string
+    {
+        if ($value instanceof UnitEnum) {
+            return $value->name;
+        }
+
+        return $value;
+    }
 }