feat: Provide UUID factory

Author: pl-github

src/Uuid/UuidTrait.php

@@ -28,11 +28,9 @@ final protected function setUpUuidTrait(): void
         $this->lastUuidValue = 0;
     }
 
-    final protected function nextUuid(): string
+    final protected static function uuidFromInteger(int $number): string
     {
-        $this->lastUuidValue ??= 0;
-
-        $uuid = str_pad(dechex(++$this->lastUuidValue), 32, '0', STR_PAD_LEFT);
+        $uuid = str_pad(dechex($number), 32, '0', STR_PAD_LEFT);
         $uuid = substr_replace($uuid, '-', 8, 0);
         $uuid = substr_replace($uuid, '-', 13, 0);
         $uuid = substr_replace($uuid, '-', 18, 0);
@@ -41,6 +39,13 @@ final protected function nextUuid(): string
         return (string) Uuid::fromString($uuid);
     }
 
+    final protected function nextUuid(): string
+    {
+        $this->lastUuidValue ??= 0;
+
+        return self::uuidFromInteger(++$this->lastUuidValue);
+    }
+
     final protected static function assertIsUuid(mixed $actual, string $message = ''): void
     {
         self::assertIsString($actual, $message);

tests/Uuid/UuidTraitTest.php

@@ -17,6 +17,12 @@ final class UuidTraitTest extends TestCase
 {
     use UuidTrait;
 
+    public function testCreateUuidByInteger(): void
+    {
+        self::assertEquals('00000000-0000-0000-0000-000000000001', self::uuidFromInteger(1));
+        self::assertEquals('00000000-0000-0000-0000-000000000002', self::uuidFromInteger(2));
+    }
+
     public function testNextUuid(): void
     {
         self::assertEquals('00000000-0000-0000-0000-000000000001', $this->nextUuid());