feat: introduce user management events

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>
2026-08-07 22:32:45 -04:00
parent 985e4a6450
commit f147ffc5c7
11 changed files with 457 additions and 19 deletions
@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KTXT\Unit\Event;
+
+use KTXC\User\Event\UserCreatedEvent;
+use KTXC\User\Event\UserDeletingEvent;
+use KTXC\User\Event\UserUpdatedEvent;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\Attributes\TestDox;
+use PHPUnit\Framework\TestCase;
+
+final class UserEventTest extends TestCase
+{
+    #[Test]
+    #[TestDox('User lifecycle events contain an immutable user snapshot')]
+    public function containsUserSnapshot(): void
+    {
+        $event = UserCreatedEvent::fromUser(
+            [
+                'uid' => 'user-a',
+                'identity' => 'person@example.test',
+                'label' => 'Person',
+                'enabled' => true,
+                'roles' => ['member'],
+            ],
+            'tenant-a',
+            'actor-a',
+        );
+
+        self::assertSame(UserCreatedEvent::class, $event->getName());
+        self::assertSame('user-a', $event->userIdentifier());
+        self::assertSame('person@example.test', $event->userIdentity());
+        self::assertSame('Person', $event->userLabel());
+        self::assertTrue($event->userEnabled());
+        self::assertSame(['member'], $event->userRoles());
+        self::assertSame('tenant-a', $event->getTenantId());
+        self::assertSame('actor-a', $event->actorIdentifier());
+        self::assertSame('actor-a', $event->getIdentityId());
+    }
+
+    #[Test]
+    #[TestDox('Created, updated, and deleting users have distinct event names')]
+    public function distinguishesLifecycleStage(): void
+    {
+        $user = ['uid' => 'user-a', 'identity' => 'person@example.test'];
+
+        self::assertSame(UserCreatedEvent::class, UserCreatedEvent::fromUser($user, 'tenant-a')->getName());
+        self::assertSame(UserUpdatedEvent::class, UserUpdatedEvent::fromUser($user, 'tenant-a')->getName());
+        self::assertSame(UserDeletingEvent::class, UserDeletingEvent::fromUser($user, 'tenant-a')->getName());
+    }
+
+    #[Test]
+    #[TestDox('User lifecycle events reject incomplete snapshots')]
+    public function rejectsIncompleteSnapshot(): void
+    {
+        $this->expectException(\InvalidArgumentException::class);
+
+        UserCreatedEvent::fromUser(['identity' => 'person@example.test'], 'tenant-a');
+    }
+}