chore: Allow identities to be null

Author: ollieread

src/Contracts/EntityMapper.php

@@ -34,7 +34,7 @@ public function repository(): ?string;
      *
      * @phpstan-param array<string, mixed>|EntityType $data
      *
-     * @return int|string
+     * @return int|string|null
      */
-    public function identity(array|object $data): int|string;
+    public function identity(array|object $data): int|string|null;
 }

src/Support/BaseEntityMapper.php

@@ -52,13 +52,13 @@ public function repository(): ?string
      *
      * @phpstan-param array<string, mixed>|EntityType $data
      *
-     * @return int|string
+     * @return int|string|null
      */
-    public function identity(object|array $data): int|string
+    public function identity(object|array $data): int|string|null
     {
         if (is_object($data)) {
             if (method_exists($data, 'hasId') && ! $data->hasId()) {
-                throw new RuntimeException('Cannot get identity from an entity without an ID');
+                return null;
             }
 
             if (property_exists($data, 'id')) {
@@ -77,7 +77,7 @@ public function identity(object|array $data): int|string
         }
 
         if (! isset($data['id'])) {
-            throw new RuntimeException('Cannot get identity from an entity without an ID');
+            return null;
         }
 
         assert(is_string($data['id']) || is_int($data['id']), 'The ID must be an int or string');