feat: support UUID-based entity ids in ObjectRegistry

Add AbstractUid support via toRfc4122() conversion for entities
using UUID/ULID identifiers. Add unit test and Behat functional
scenario.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: nikophil

src/Test/Behat/features/main/access-uuid.feature

@@ -0,0 +1,22 @@
+Feature: Test accessing Uuid-based entity ids
+
+  Scenario: Can create and reference Uuid entity
+    Given there is an "entity with uid" named "the object"
+    Then "entity with uid" "the object" should exist
+
+  Scenario: Can access last id for Uuid entity via lastId transform
+    Given there is an "entity with uid" named "A"
+    # The <lastId> transform resolves the Uuid to its RFC 4122 string format.
+    # We just need to verify the transform doesn't throw, the 404 is expected.
+    When I am on "/<lastId>"
+    Then the response status code should be 404
+
+  Scenario: Can access last id for specific Uuid entity type
+    Given there is an "entity with uid" named "B"
+    When I am on "/<lastId(entity with uid)>"
+    Then the response status code should be 404
+
+  Scenario: Can access id from reference for Uuid entity
+    Given there is an "entity with uid" named "my-uid-entity"
+    When I am on "/<id(entity with uid, my-uid-entity)>"
+    Then the response status code should be 404

src/Test/Behat/src/ObjectRegistry.php

@@ -11,6 +11,7 @@
 
 namespace Zenstruck\Foundry\Test\Behat;
 
+use Symfony\Component\Uid\AbstractUid;
 use Zenstruck\Foundry\Persistence\Event\AfterPersist;
 use Zenstruck\Foundry\Persistence\PersistenceManager;
 use Zenstruck\Foundry\Story\Event\StateAddedToStory;
@@ -162,8 +163,13 @@ private function coerceIdToScalar(array $ids): int|string
         }
 
         $id = array_first($ids);
+
+        if ($id instanceof AbstractUid) {
+            return $id->toRfc4122();
+        }
+
         if (!\is_int($id) && !\is_string($id)) {
-            throw new \InvalidArgumentException(\sprintf('Wrong type for the id: expected int or string, got "%s".', \get_debug_type($id)));
+            throw new \InvalidArgumentException(\sprintf('Wrong type for the id: expected int, string or Uid, got "%s".', \get_debug_type($id)));
         }
 
         return $id;

src/Test/Behat/tests/Fixture/Factories/EntityWithUidFactory.php

@@ -0,0 +1,33 @@
+<?php
+
+/*
+ * This file is part of the zenstruck/foundry package.
+ *
+ * (c) Kevin Bond <kevinbond@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Zenstruck\Foundry\Test\Behat\Tests\Fixture\Factories;
+
+use Zenstruck\Foundry\Persistence\PersistentObjectFactory;
+use Zenstruck\Foundry\Test\Behat\Attribute\FactoryShortName;
+use Zenstruck\Foundry\Tests\Fixture\Entity\EntityWithUid;
+
+/**
+ * @extends PersistentObjectFactory<EntityWithUid>
+ */
+#[FactoryShortName(shortName: 'entity with uid', pluralName: 'entities with uid')]
+final class EntityWithUidFactory extends PersistentObjectFactory
+{
+    public static function class(): string
+    {
+        return EntityWithUid::class;
+    }
+
+    protected function defaults(): array
+    {
+        return [];
+    }
+}

src/Test/Behat/tests/Unit/ObjectRegistryTest.php

@@ -13,6 +13,7 @@
 
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\TestCase;
+use Symfony\Component\Uid\Uuid;
 use Zenstruck\Foundry\ObjectFactory;
 use Zenstruck\Foundry\Persistence\Event\AfterPersist;
 use Zenstruck\Foundry\Persistence\PersistenceManager;
@@ -145,6 +146,25 @@ public function it_stores_string_id_from_after_persist_event(): void
         self::assertSame('uuid-123', $this->registry->lastId());
     }
 
+    #[Test]
+    public function it_stores_uuid_from_after_persist_event(): void
+    {
+        $uuid = Uuid::v7();
+
+        $persistenceManager = $this->createStub(PersistenceManager::class);
+        $persistenceManager->method('getIdentifierValues')->willReturn(['id' => $uuid]);
+
+        $registry = new ObjectRegistry($this->resolver, $persistenceManager);
+        $registry->reset();
+
+        $user = new User(id: 1, name: 'John');
+        $event = new AfterPersist($user, [], $this->createStub(PersistentObjectFactory::class));
+
+        $registry->storeLastId($event);
+
+        self::assertSame($uuid->toRfc4122(), $registry->lastId());
+    }
+
     #[Test]
     public function it_throws_when_no_last_id_available(): void
     {
@@ -252,7 +272,7 @@ public function it_throws_when_id_type_is_invalid(): void
         $registry->storeLastId($event);
 
         $this->expectException(\InvalidArgumentException::class);
-        $this->expectExceptionMessage('Wrong type for the id: expected int or string, got "array".');
+        $this->expectExceptionMessage('Wrong type for the id: expected int, string or Uid, got "array".');
 
         $registry->lastId();
     }