Implement ScalarType example: Email

Author: jerowork

composer.json

@@ -19,6 +19,7 @@
     "require": {
         "php": "^8.4",
         "ext-ctype": "*",
+        "ext-filter": "*",
         "ext-iconv": "*",
         "ext-sqlite3": "*",
         "guzzlehttp/psr7": "^2.7.1",

composer.lock

@@ -17,6 +17,6 @@
     public function __construct(
         public string $id,
         public string $name,
-        public ?string $email,
+        public ?Email $email,
     ) {}
 }

src/Domain/Author/Author.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Jerowork\ExampleApplicationGraphqlAttributeSchema\Domain\Author;
+
+use InvalidArgumentException;
+use Stringable;
+
+final readonly class Email implements Stringable
+{
+    public function __construct(
+        public string $email,
+    ) {
+        if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
+            throw new InvalidArgumentException('Invalid email address');
+        }
+    }
+
+    public function __toString(): string
+    {
+        return $this->email;
+    }
+}

src/Domain/Author/Email.php

@@ -6,6 +6,7 @@
 
 use Jerowork\ExampleApplicationGraphqlAttributeSchema\Domain\Author\Author;
 use Jerowork\ExampleApplicationGraphqlAttributeSchema\Domain\Author\AuthorRepository;
+use Jerowork\ExampleApplicationGraphqlAttributeSchema\Domain\Author\Email;
 use Jerowork\ExampleApplicationGraphqlAttributeSchema\Infrastructure\Api\Http\GraphQL\Type\AuthorType;
 use Jerowork\GraphqlAttributeSchema\Attribute\Mutation;
 use Ramsey\Uuid\Uuid;
@@ -19,7 +20,7 @@ public function __construct(
     ) {}
 
     #[Mutation(description: 'Create an author')]
-    public function createAuthor(string $name, ?string $email): AuthorType
+    public function createAuthor(string $name, ?Email $email): AuthorType
     {
         $author = new Author(
             (string) Uuid::uuid7(),

src/Infrastructure/Api/Http/GraphQL/Resolver/Mutation/CreateAuthorMutation.php

@@ -5,6 +5,7 @@
 namespace Jerowork\ExampleApplicationGraphqlAttributeSchema\Infrastructure\Api\Http\GraphQL\Type;
 
 use Jerowork\ExampleApplicationGraphqlAttributeSchema\Domain\Author\Author;
+use Jerowork\ExampleApplicationGraphqlAttributeSchema\Domain\Author\Email;
 use Jerowork\GraphqlAttributeSchema\Attribute\Field;
 use Jerowork\GraphqlAttributeSchema\Attribute\Type;
 use Symfony\Component\DependencyInjection\Attribute\Exclude;
@@ -30,7 +31,7 @@ public function getName(): string
     }
 
     #[Field]
-    public function getEmail(): ?string
+    public function getEmail(): ?Email
     {
         return $this->author->email;
     }

src/Infrastructure/Api/Http/GraphQL/Type/AuthorType.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Jerowork\ExampleApplicationGraphqlAttributeSchema\Infrastructure\Api\Http\GraphQL\Type\Scalar;
+
+use GraphQL\Language\AST\Node;
+use GraphQL\Language\AST\StringValueNode;
+use GraphQL\Type\Definition\ScalarType;
+use InvalidArgumentException;
+use Jerowork\ExampleApplicationGraphqlAttributeSchema\Domain\Author\Email;
+use Jerowork\GraphqlAttributeSchema\Attribute\Scalar;
+
+#[Scalar(alias: Email::class)]
+final class EmailType extends ScalarType
+{
+    public function serialize($value): string
+    {
+        if (!$value instanceof Email) {
+            throw new InvalidArgumentException('Expected an Email value for custom scalar EmailType');
+        }
+
+        return (string) $value;
+    }
+
+    public function parseValue($value): Email
+    {
+        if (!is_string($value)) {
+            throw new InvalidArgumentException('Expected a string value for custom scalar EmailType');
+        }
+
+        return new Email($value);
+    }
+
+    public function parseLiteral(Node $valueNode, ?array $variables = null): Email
+    {
+        if (!$valueNode instanceof StringValueNode) {
+            throw new InvalidArgumentException('Expected a string value (node) for custom scalar EmailType');
+        }
+
+        return new Email($valueNode->value);
+    }
+}

src/Infrastructure/Api/Http/GraphQL/Type/Scalar/EmailType.php

@@ -6,6 +6,7 @@
 
 use Jerowork\ExampleApplicationGraphqlAttributeSchema\Domain\Author\Author;
 use Jerowork\ExampleApplicationGraphqlAttributeSchema\Domain\Author\AuthorRepository;
+use Jerowork\ExampleApplicationGraphqlAttributeSchema\Domain\Author\Email;
 use Jerowork\ExampleApplicationGraphqlAttributeSchema\Infrastructure\Persistence\SQLite\SQLiteFactory;
 use RuntimeException;
 use Symfony\Component\DependencyInjection\Attribute\AsAlias;
@@ -57,7 +58,7 @@ public function getById(string $authorId): Author
         return new Author(
             $row['id'],
             $row['name'],
-            $row['email'],
+            $row['email'] !== null ? new Email($row['email']) : null,
         );
     }
 
@@ -109,7 +110,7 @@ public function getByIds(string ...$authorIds): array
             $authors[] = new Author(
                 $row['id'],
                 $row['name'],
-                $row['email'],
+                $row['email'] !== null ? new Email($row['email']) : null,
             );
         }
 
@@ -156,7 +157,7 @@ public function save(Author $author): void
         $statement->bindValue('name', $author->name);
 
         if ($author->email !== null) {
-            $statement->bindValue('email', $author->email);
+            $statement->bindValue('email', (string) $author->email);
         }
 
         $statement->execute();