infer aggregate id normalizer

composer.json

@@ -22,7 +22,7 @@
     "php": "~8.1.0 || ~8.2.0 || ~8.3.0",
     "doctrine/dbal": "^3.8.1|^4.0.0",
     "doctrine/migrations": "^3.3.2",
-    "patchlevel/hydrator": "^1.3.1",
+    "patchlevel/hydrator": "^1.4.1",
     "patchlevel/worker": "^1.2.0",
     "psr/cache": "^2.0.0|^3.0.0",
     "psr/clock": "^1.0",

deptrac-baseline.yaml

@@ -1,5 +1,11 @@
 deptrac:
   skip_violations:
+    Patchlevel\EventSourcing\Aggregate\AggregateRootId:
+      - Patchlevel\EventSourcing\Serializer\Normalizer\IdNormalizer
+    Patchlevel\EventSourcing\Aggregate\CustomId:
+      - Patchlevel\EventSourcing\Serializer\Normalizer\IdNormalizer
+    Patchlevel\EventSourcing\Aggregate\Uuid:
+      - Patchlevel\EventSourcing\Serializer\Normalizer\IdNormalizer
     Patchlevel\EventSourcing\Attribute\Processor:
       - Patchlevel\EventSourcing\Subscription\RunMode
     Patchlevel\EventSourcing\Attribute\Projector:

docs/pages/aggregate.md

@@ -91,20 +91,16 @@ final class CreateProfileHandler
 
 In order that an aggregate is actually saved, at least one event must exist in the DB.
 For our aggregate we create the Event `ProfileRegistered` with an ID and a name.
-Since the ID is a complex data type and cannot be easily serialized, we need to define a normalizer for the ID.
-We do this with the `IdNormalizer` attribute.
 We also give the event a unique name using the `Event` attribute.
 
 ```php
 use Patchlevel\EventSourcing\Aggregate\Uuid;
 use Patchlevel\EventSourcing\Attribute\Event;
-use Patchlevel\EventSourcing\Serializer\Normalizer\IdNormalizer;
 
 #[Event('profile.registered')]
 final class ProfileRegistered
 {
     public function __construct(
-        #[IdNormalizer]
         public readonly Uuid $profileId,
         public readonly string $name,
     ) {
@@ -114,7 +110,6 @@ final class ProfileRegistered
 !!! note
 
     You can find out more about events [here](./events.md).
-    And for normalizer [here](./normalizer.md).
 
 After we have defined the event, we have to adapt the profile aggregate:
 
@@ -489,7 +484,8 @@ final class NameChanged
 ```
 !!! warning
 
-    The payload must be serializable and unserializable as json.
+    You need to create a normalizer for the `Name` value object.
+    So the payload must be serializable and unserializable as json.
 
 !!! note
 

docs/pages/aggregate_id.md

@@ -25,21 +25,14 @@ use Patchlevel\EventSourcing\Aggregate\BasicAggregateRoot;
 use Patchlevel\EventSourcing\Aggregate\Uuid;
 use Patchlevel\EventSourcing\Attribute\Aggregate;
 use Patchlevel\EventSourcing\Attribute\Id;
-use Patchlevel\EventSourcing\Serializer\Normalizer\IdNormalizer;
 
 #[Aggregate('profile')]
 final class Profile extends BasicAggregateRoot
 {
     #[Id]
-    #[IdNormalizer]
     private Uuid $id;
 }
 ```
-!!! note
-
-    If you want to use snapshots, then you have to make sure that the aggregate id are normalized. 
-    You can find how to do this [here](normalizer.md).
-
 You have multiple options for generating an uuid:
 
 ```php
@@ -63,13 +56,11 @@ use Patchlevel\EventSourcing\Aggregate\BasicAggregateRoot;
 use Patchlevel\EventSourcing\Aggregate\CustomId;
 use Patchlevel\EventSourcing\Attribute\Aggregate;
 use Patchlevel\EventSourcing\Attribute\Id;
-use Patchlevel\EventSourcing\Serializer\Normalizer\IdNormalizer;
 
 #[Aggregate('profile')]
 final class Profile extends BasicAggregateRoot
 {
     #[Id]
-    #[IdNormalizer]
     private CustomId $id;
 }
 ```
@@ -79,11 +70,6 @@ final class Profile extends BasicAggregateRoot
     you need to change the `aggregate_id_type` to `string` in the store configuration.
     More information can be found [here](store.md).
 
-!!! note
-
-    If you want to use snapshots, then you have to make sure that the aggregate id are normalized. 
-    You can find how to do this [here](normalizer.md).
-
 So you can use any string as an id:
 
 ```php
@@ -124,21 +110,14 @@ So you can use it like this:
 use Patchlevel\EventSourcing\Aggregate\BasicAggregateRoot;
 use Patchlevel\EventSourcing\Attribute\Aggregate;
 use Patchlevel\EventSourcing\Attribute\Id;
-use Patchlevel\EventSourcing\Serializer\Normalizer\IdNormalizer;
 
 #[Aggregate('profile')]
 final class Profile extends BasicAggregateRoot
 {
     #[Id]
-    #[IdNormalizer]
     private ProfileId $id;
 }
 ```
-!!! note
-
-    If you want to use snapshots, then you have to make sure that the aggregate id are normalized. 
-    You can find how to do this [here](normalizer.md).
-
 We also offer you some traits, so that you don't have to implement the `AggregateRootId` interface yourself.
 Here for the uuid:
 
@@ -167,4 +146,3 @@ class ProfileId implements AggregateRootId
 * [How to create an aggregate](aggregate.md)
 * [How to create an event](events.md)
 * [How to test an aggregate](testing.md)
-* [How to normalize value objects](normalizer.md)

docs/pages/events.md

@@ -83,6 +83,11 @@ final class ProfileCreated
     }
 }
 ```
+!!! tip
+
+    Built-in normalizers like `IdNormalizer` and `DateTimeImmutableNormalizer` can be inferred from the type hint 
+    and so you don't have to specify them. If you want to configure the Normalizer, you still have to do it.
+
 !!! note
 
     You can find out more about normalizer [here](normalizer.md).    

docs/pages/getting_started.md

@@ -12,13 +12,11 @@ A hotel can be created with a `name` and a `id`:
 ```php
 use Patchlevel\EventSourcing\Aggregate\Uuid;
 use Patchlevel\EventSourcing\Attribute\Event;
-use Patchlevel\EventSourcing\Serializer\Normalizer\IdNormalizer;
 
 #[Event('hotel.created')]
 final class HotelCreated
 {
     public function __construct(
-        #[IdNormalizer]
         public readonly Uuid $hotelId,
         public readonly string $hotelName,
     ) {