Add version 7 UUID support (#10)

* Add version 7 UUID support

* Bump ramsey/uuid to 4.5

composer.json

@@ -4,7 +4,7 @@
     "require": {
         "php": ">=8.0",
         "cycle/entity-behavior": "^1.0",
-        "ramsey/uuid": "^4.0"
+        "ramsey/uuid": "^4.5"
     },
     "require-dev": {
         "cycle/annotated": "^3.0",

src/Listener/Uuid7.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Uuid\Listener;
+
+use Cycle\ORM\Entity\Behavior\Attribute\Listen;
+use Cycle\ORM\Entity\Behavior\Event\Mapper\Command\OnCreate;
+use Ramsey\Uuid\Uuid;
+
+final class Uuid7
+{
+    public function __construct(
+        private string $field = 'uuid'
+    ) {
+    }
+
+    #[Listen(OnCreate::class)]
+    public function __invoke(OnCreate $event): void
+    {
+        if (!isset($event->state->getData()[$this->field])) {
+            $event->state->register($this->field, Uuid::uuid7());
+        }
+    }
+}

src/Uuid7.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cycle\ORM\Entity\Behavior\Uuid;
+
+use Cycle\ORM\Entity\Behavior\Uuid\Listener\Uuid7 as Listener;
+use Doctrine\Common\Annotations\Annotation\NamedArgumentConstructor;
+use Doctrine\Common\Annotations\Annotation\Target;
+use JetBrains\PhpStorm\ArrayShape;
+
+/**
+ * Uses a version 7 (Unix Epoch Time) UUID
+ *
+ * @Annotation
+ * @NamedArgumentConstructor()
+ * @Target({"CLASS"})
+ */
+#[\Attribute(\Attribute::TARGET_CLASS), NamedArgumentConstructor]
+final class Uuid7 extends Uuid
+{
+    /**
+     * @param non-empty-string $field Uuid property name
+     * @param non-empty-string|null $column Uuid column name
+     *
+     * @see \Ramsey\Uuid\UuidFactoryInterface::uuid7()
+     */
+    public function __construct(
+        string $field = 'uuid',
+        ?string $column = null
+    ) {
+        $this->field = $field;
+        $this->column = $column;
+    }
+
+    protected function getListenerClass(): string
+    {
+        return Listener::class;
+    }
+
+    #[ArrayShape(['field' => 'string'])]
+    protected function getListenerArgs(): array
+    {
+        return [
+            'field' => $this->field
+        ];
+    }
+}

tests/Uuid/Functional/Driver/Common/Uuid/ListenerTest.php

@@ -4,6 +4,7 @@
 
 namespace Cycle\ORM\Entity\Behavior\Uuid\Tests\Functional\Driver\Common\Uuid;
 
+use Cycle\ORM\Entity\Behavior\Uuid\Listener\Uuid7;
 use Cycle\ORM\Entity\Behavior\Uuid\Tests\Fixtures\Uuid\User;
 use Cycle\ORM\Entity\Behavior\Uuid\Tests\Functional\Driver\Common\BaseTest;
 use Cycle\ORM\Entity\Behavior\Uuid\Tests\Traits\TableTrait;
@@ -159,6 +160,21 @@ public function testUuid6(): void
         $this->assertIsString($data->uuid->toString());
     }
 
+    public function testUuid7(): void
+    {
+        $this->withListeners(Uuid7::class);
+
+        $user = new User();
+        $this->save($user);
+
+        $select = new Select($this->orm->with(heap: new Heap()), User::class);
+        $data = $select->fetchOne();
+
+        $this->assertInstanceOf(UuidInterface::class, $data->uuid);
+        $this->assertSame(7, $data->uuid->getVersion());
+        $this->assertIsString($data->uuid->toString());
+    }
+
     public function withListeners(array|string $listeners): void
     {
         $this->withSchema(new Schema([