Upgrade to gember/event-sourcing 0.4.0

Jeroen de Graaf · Jeroen de Graaf · commit 2404d2becad5 · 2025-08-27T20:08:12.000+02:00
diff --git a/composer.json b/composer.json
@@ -27,8 +27,8 @@
         "doctrine/doctrine-migrations-bundle": "^3.3",
         "doctrine/orm": "^3.2",
         "fakerphp/faker": "^1.23",
-        "gember/event-sourcing": "^0.3",
-        "gember/event-sourcing-symfony-bundle": "^0.3",
+        "gember/event-sourcing": "^0.4",
+        "gember/event-sourcing-symfony-bundle": "^0.4",
         "symfony/console": "7.1.*",
         "symfony/dotenv": "7.1.*",
         "symfony/flex": "^2",
diff --git a/composer.lock b/composer.lock
diff --git a/migrations/Version20241009183226.php b/migrations/Version20241009183226.php
@@ -29,8 +29,8 @@ public function up(Schema $schema): void
             <<<'SQL'
             CREATE TABLE `event_store_relation` (
               `event_id` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL,
-              `domain_id` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL,
-              UNIQUE KEY `event_id_domain_id` (`event_id`,`domain_id`),
+              `domain_tag` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL,
+              UNIQUE KEY `event_id_domain_tag` (`event_id`,`domain_tag`),
               CONSTRAINT `event_store_x_event_store_relation` FOREIGN KEY (`event_id`) REFERENCES `event_store` (`id`)
             ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
             SQL
diff --git a/src/Domain/Course/ChangeCourseCapacity.php b/src/Domain/Course/ChangeCourseCapacity.php
@@ -5,21 +5,21 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\Course;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEventSubscriber;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 use Gember\EventSourcing\UseCase\EventSourcedUseCase;
 use Gember\EventSourcing\UseCase\EventSourcedUseCaseBehaviorTrait;
 
 /**
- * Use case based one domain identifier.
+ * Use case based one domain tag.
  */
 final class ChangeCourseCapacity implements EventSourcedUseCase
 {
     use EventSourcedUseCaseBehaviorTrait;
 
     /*
-     * Define to which domain identifiers this use case belongs to.
+     * Define to which domain tags this use case belongs to.
      */
-    #[DomainId]
+    #[DomainTag]
     private CourseId $courseId;
 
     /*
@@ -53,7 +53,7 @@ public function changeCapacity(int $capacity): void
     }
 
     /*
-     * Change internal state by subscribing to relevant domain events for any of the domain identifiers,
+     * Change internal state by subscribing to relevant domain events for any of the domain tags,
      * so that this use case can apply its business rules.
      */
     #[DomainEventSubscriber]
diff --git a/src/Domain/Course/Course.php b/src/Domain/Course/Course.php
@@ -5,7 +5,7 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\Course;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEventSubscriber;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 use Gember\EventSourcing\UseCase\EventSourcedUseCase;
 use Gember\EventSourcing\UseCase\EventSourcedUseCaseBehaviorTrait;
 
@@ -17,9 +17,9 @@ final class Course implements EventSourcedUseCase
     use EventSourcedUseCaseBehaviorTrait;
 
     /*
-     * Define to which domain identifiers this use case belongs to.
+     * Define to which domain tags this use case belongs to.
      */
-    #[DomainId]
+    #[DomainTag]
     private CourseId $courseId;
 
     /*
@@ -51,7 +51,7 @@ public function rename(string $name): void
     }
 
     /*
-     * Change internal state by subscribing to relevant domain events for any of the domain identifiers,
+     * Change internal state by subscribing to relevant domain events for any of the domain tags,
      * so that this use case can apply its business rules.
      */
     #[DomainEventSubscriber]
diff --git a/src/Domain/Course/CourseCapacityChangedEvent.php b/src/Domain/Course/CourseCapacityChangedEvent.php
@@ -5,13 +5,13 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\Course;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEvent;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 
 #[DomainEvent(name: 'course.capacity-changed')]
 final readonly class CourseCapacityChangedEvent
 {
     public function __construct(
-        #[DomainId]
+        #[DomainTag]
         public string $courseId,
         public int $capacity,
     ) {}
diff --git a/src/Domain/Course/CourseCreatedEvent.php b/src/Domain/Course/CourseCreatedEvent.php
@@ -5,13 +5,13 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\Course;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEvent;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 
 #[DomainEvent(name: 'course.created')]
 final readonly class CourseCreatedEvent
 {
     public function __construct(
-        #[DomainId]
+        #[DomainTag]
         public string $courseId,
         public string $name,
         public int $capacity,
diff --git a/src/Domain/Course/CourseRenamedEvent.php b/src/Domain/Course/CourseRenamedEvent.php
@@ -5,13 +5,13 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\Course;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEvent;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 
 #[DomainEvent(name: 'course.renamed')]
 final readonly class CourseRenamedEvent
 {
     public function __construct(
-        #[DomainId]
+        #[DomainTag]
         public string $courseId,
         public string $name,
     ) {}
diff --git a/src/Domain/Student/Student.php b/src/Domain/Student/Student.php
@@ -5,7 +5,7 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\Student;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEventSubscriber;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 use Gember\EventSourcing\UseCase\EventSourcedUseCase;
 use Gember\EventSourcing\UseCase\EventSourcedUseCaseBehaviorTrait;
 
@@ -17,9 +17,9 @@ final class Student implements EventSourcedUseCase
     use EventSourcedUseCaseBehaviorTrait;
 
     /*
-     * Define to which domain identifiers this use case belongs to.
+     * Define to which domain tags this use case belongs to.
      */
-    #[DomainId]
+    #[DomainTag]
     private StudentId $studentId;
 
     public static function create(StudentId $studentId): self
@@ -31,7 +31,7 @@ public static function create(StudentId $studentId): self
     }
 
     /*
-     * Change internal state by subscribing to relevant domain events for any of the domain identifiers,
+     * Change internal state by subscribing to relevant domain events for any of the domain tags,
      * so that this use case can apply its business rules.
      */
     #[DomainEventSubscriber]
diff --git a/src/Domain/Student/StudentCreatedEvent.php b/src/Domain/Student/StudentCreatedEvent.php
@@ -5,13 +5,13 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\Student;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEvent;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 
 #[DomainEvent(name: 'student.created')]
 final readonly class StudentCreatedEvent
 {
     public function __construct(
-        #[DomainId]
+        #[DomainTag]
         public string $studentId,
     ) {}
 }
diff --git a/src/Domain/StudentToCourseSubscription/CourseFullyBookedEvent.php b/src/Domain/StudentToCourseSubscription/CourseFullyBookedEvent.php
@@ -5,13 +5,13 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\StudentToCourseSubscription;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEvent;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 
 #[DomainEvent(name: 'student-to-course-subscription.course-fully-booked')]
 final readonly class CourseFullyBookedEvent
 {
     public function __construct(
-        #[DomainId]
+        #[DomainTag]
         public string $courseId,
     ) {}
 }
diff --git a/src/Domain/StudentToCourseSubscription/StudentSubscribedToCourseEvent.php b/src/Domain/StudentToCourseSubscription/StudentSubscribedToCourseEvent.php
@@ -5,15 +5,15 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\StudentToCourseSubscription;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEvent;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 
 #[DomainEvent(name: 'student-to-course-subscription.student-subscribed-to-course')]
 final readonly class StudentSubscribedToCourseEvent
 {
     public function __construct(
-        #[DomainId]
+        #[DomainTag]
         public string $courseId,
-        #[DomainId]
+        #[DomainTag]
         public string $studentId,
     ) {}
 }
diff --git a/src/Domain/StudentToCourseSubscription/StudentUnsubscribedFromCourseEvent.php b/src/Domain/StudentToCourseSubscription/StudentUnsubscribedFromCourseEvent.php
@@ -5,15 +5,15 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\StudentToCourseSubscription;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEvent;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 
 #[DomainEvent(name: 'student-to-course-subscription.student-unsubscribed-from-course')]
 final readonly class StudentUnsubscribedFromCourseEvent
 {
     public function __construct(
-        #[DomainId]
+        #[DomainTag]
         public string $courseId,
-        #[DomainId]
+        #[DomainTag]
         public string $studentId,
     ) {}
 }
diff --git a/src/Domain/StudentToCourseSubscription/SubscribeStudentToCourse.php b/src/Domain/StudentToCourseSubscription/SubscribeStudentToCourse.php
@@ -5,7 +5,7 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\StudentToCourseSubscription;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEventSubscriber;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 use Gember\EventSourcing\UseCase\EventSourcedUseCase;
 use Gember\EventSourcing\UseCase\EventSourcedUseCaseBehaviorTrait;
 use Gember\ExampleEventSourcingDcb\Domain\Course\CourseCapacityChangedEvent;
@@ -17,18 +17,18 @@
 use Gember\ExampleEventSourcingDcb\Domain\Student\StudentNotFoundException;
 
 /**
- * Use case based on multiple domain identifiers.
+ * Use case based on multiple domain tags.
  */
 final class SubscribeStudentToCourse implements EventSourcedUseCase
 {
     use EventSourcedUseCaseBehaviorTrait;
 
     /*
-     * Define to which domain identifiers this use case belongs to.
+     * Define to which domain tags this use case belongs to.
      */
-    #[DomainId]
+    #[DomainTag]
     private CourseId $courseId;
-    #[DomainId]
+    #[DomainTag]
     private StudentId $studentId;
 
     /*
@@ -84,7 +84,7 @@ public function subscribe(): void
     }
 
     /*
-     * Change internal state by subscribing to relevant domain events for any of the domain identifiers,
+     * Change internal state by subscribing to relevant domain events for any of the domain tags,
      * so that this use case can apply its business rules.
      */
     #[DomainEventSubscriber]
diff --git a/src/Domain/StudentToCourseSubscription/UnsubscribeStudentFromCourse.php b/src/Domain/StudentToCourseSubscription/UnsubscribeStudentFromCourse.php
@@ -5,7 +5,7 @@
 namespace Gember\ExampleEventSourcingDcb\Domain\StudentToCourseSubscription;
 
 use Gember\EventSourcing\UseCase\Attribute\DomainEventSubscriber;
-use Gember\EventSourcing\UseCase\Attribute\DomainId;
+use Gember\EventSourcing\UseCase\Attribute\DomainTag;
 use Gember\EventSourcing\UseCase\EventSourcedUseCase;
 use Gember\EventSourcing\UseCase\EventSourcedUseCaseBehaviorTrait;
 use Gember\ExampleEventSourcingDcb\Domain\Course\CourseCreatedEvent;
@@ -16,18 +16,18 @@
 use Gember\ExampleEventSourcingDcb\Domain\Student\StudentNotFoundException;
 
 /**
- * Use case based on multiple domain identifiers.
+ * Use case based on multiple domain tags.
  */
 final class UnsubscribeStudentFromCourse implements EventSourcedUseCase
 {
     use EventSourcedUseCaseBehaviorTrait;
 
     /*
-     * Define to which domain identifiers this use case belongs to.
+     * Define to which domain tags this use case belongs to.
      */
-    #[DomainId]
+    #[DomainTag]
     private CourseId $courseId;
-    #[DomainId]
+    #[DomainTag]
     private StudentId $studentId;
 
     /*
@@ -66,7 +66,7 @@ public function unsubscribe(): void
     }
 
     /*
-     * Change internal state by subscribing to relevant domain events for any of the domain identifiers,
+     * Change internal state by subscribing to relevant domain events for any of the domain tags,
      * so that this use case can apply its business rules.
      */
     #[DomainEventSubscriber]
diff --git a/symfony.lock b/symfony.lock
@@ -1,4 +1,13 @@
 {
+    "doctrine/deprecations": {
+        "version": "1.1",
+        "recipe": {
+            "repo": "github.com/symfony/recipes",
+            "branch": "main",
+            "version": "1.0",
+            "ref": "87424683adc81d7dc305eefec1fced883084aab9"
+        }
+    },
     "doctrine/doctrine-bundle": {
         "version": "2.13",
         "recipe": {

Original file line number	Diff line number	Diff line change
`@@ -5,13 +5,13 @@`
`5`	`5`	`namespace Gember\ExampleEventSourcingDcb\Domain\Student;`
`6`	`6`
`7`	`7`	`use Gember\EventSourcing\UseCase\Attribute\DomainEvent;`
`8`		`-use Gember\EventSourcing\UseCase\Attribute\DomainId;`
	`8`	`+use Gember\EventSourcing\UseCase\Attribute\DomainTag;`
`9`	`9`
`10`	`10`	`#[DomainEvent(name: 'student.created')]`
`11`	`11`	`final readonly class StudentCreatedEvent`
`12`	`12`	`{`
`13`	`13`	`public function __construct(`
`14`		`- #[DomainId]`
	`14`	`+ #[DomainTag]`
`15`	`15`	`public string $studentId,`
`16`	`16`	`) {}`
`17`	`17`	`}`