add more normalizer and update getting started docs

docs/pages/getting_started.md

@@ -10,13 +10,15 @@ First we define the events that happen in our system.
 A hotel can be created with a `name` and a `id`:
 
 ```php
-use Patchlevel\EventSourcing\Aggregate\BasicAggregateRootId;
+use Patchlevel\EventSourcing\Aggregate\UuidAggregateRootId;
+use Patchlevel\EventSourcing\Serializer\Normalizer\UuidAggregateIdNormalizer;
 
 #[Event('hotel.created')]
 final class HotelCreated
 {
     public function __construct(
-        public readonly BasicAggregateRootId $hotelId,
+        #[UuidAggregateIdNormalizer]
+        public readonly UuidAggregateRootId $hotelId,
         public readonly string $hotelName
     ) {
     }
@@ -62,7 +64,7 @@ These events are thrown here and the state of the hotel is also changed.
 ```php
 use Patchlevel\EventSourcing\Aggregate\AggregateChanged;
 use Patchlevel\EventSourcing\Aggregate\BasicAggregateRoot;
-use Patchlevel\EventSourcing\Aggregate\BasicAggregateRootId;
+use Patchlevel\EventSourcing\Aggregate\UuidAggregateRootId;
 use Patchlevel\EventSourcing\Attribute\Aggregate;
 use Patchlevel\EventSourcing\Attribute\AggregateId;
 use Patchlevel\EventSourcing\Attribute\Apply;
@@ -71,7 +73,7 @@ use Patchlevel\EventSourcing\Attribute\Apply;
 final class Hotel extends BasicAggregateRoot
 {
     #[AggregateId]
-    private BasicAggregateRootId $id;
+    private UuidAggregateRootId $id;
     private string $name;
 
     /**
@@ -89,7 +91,7 @@ final class Hotel extends BasicAggregateRoot
         return $this->guests;
     }
 
-    public static function create(BasicAggregateRootId $id, string $hotelName): static
+    public static function create(UuidAggregateRootId $id, string $hotelName): static
     {
         $self = new static();
         $self->recordThat(new HotelCreated($id, $hotelName));
@@ -356,16 +358,16 @@ $projectionist->boot();
 We are now ready to use the Event Sourcing System. We can load, change and save aggregates.
 
 ```php
-use Patchlevel\EventSourcing\Aggregate\BasicAggregateRootId;
+use Patchlevel\EventSourcing\Aggregate\UuidAggregateRootId;
 
-$hotel1 = Hotel::create(new BasicAggregateRootId('1'), 'HOTEL');
+$hotel1 = Hotel::create(UuidAggregateRootId::generate(), 'HOTEL');
 $hotel1->checkIn('David');
 $hotel1->checkIn('Daniel');
 $hotel1->checkOut('David');
 
 $hotelRepository->save($hotel1);
 
-$hotel2 = $hotelRepository->load(new BasicAggregateRootId('2'));
+$hotel2 = $hotelRepository->load(UuidAggregateRootId::fromString('d0d0d0d0-d0d0-d0d0-d0d0-d0d0d0d0d0d0'));
 $hotel2->checkIn('David');
 $hotelRepository->save($hotel2);
 

src/Serializer/Normalizer/BasicAggregateIdNormalizer.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Patchlevel\EventSourcing\Serializer\Normalizer;
+
+use Attribute;
+use Patchlevel\EventSourcing\Aggregate\BasicAggregateRootId;
+
+#[Attribute(Attribute::TARGET_PROPERTY)]
+final class BasicAggregateIdNormalizer extends AggregateIdNormalizer
+{
+    public function __construct()
+    {
+        parent::__construct(BasicAggregateRootId::class);
+    }
+}

src/Serializer/Normalizer/UuidAggregateIdNormalizer.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Patchlevel\EventSourcing\Serializer\Normalizer;
+
+use Attribute;
+use Patchlevel\EventSourcing\Aggregate\UuidAggregateRootId;
+
+#[Attribute(Attribute::TARGET_PROPERTY)]
+final class UuidAggregateIdNormalizer extends AggregateIdNormalizer
+{
+    public function __construct()
+    {
+        parent::__construct(UuidAggregateRootId::class);
+    }
+}

tests/Benchmark/BasicImplementation/Normalizer/ProfileIdNormalizer.php

@@ -5,34 +5,14 @@
 namespace Patchlevel\EventSourcing\Tests\Benchmark\BasicImplementation\Normalizer;
 
 use Attribute;
-use InvalidArgumentException;
+use Patchlevel\EventSourcing\Serializer\Normalizer\AggregateIdNormalizer;
 use Patchlevel\EventSourcing\Tests\Benchmark\BasicImplementation\ProfileId;
-use Patchlevel\Hydrator\Normalizer\Normalizer;
-
-use function is_string;
 
 #[Attribute(Attribute::TARGET_PROPERTY)]
-final class ProfileIdNormalizer implements Normalizer
+final class ProfileIdNormalizer extends AggregateIdNormalizer
 {
-    public function normalize(mixed $value): string
+    public function __construct()
     {
-        if (!$value instanceof ProfileId) {
-            throw new InvalidArgumentException();
-        }
-
-        return $value->toString();
-    }
-
-    public function denormalize(mixed $value): ProfileId|null
-    {
-        if ($value === null) {
-            return null;
-        }
-
-        if (!is_string($value)) {
-            throw new InvalidArgumentException();
-        }
-
-        return ProfileId::fromString($value);
+        parent::__construct(ProfileId::class);
     }
 }