toString(); $v7 = Uuid::uuid7()->toString(); $invalid = 'not-a-uuid'; // WHEN & THEN expect(UuidHelper::isValid($v4))->toBeTrue() ->and(UuidHelper::isValid($v7))->toBeTrue() ->and(UuidHelper::isValid($invalid))->toBeFalse(); }); it('roundtrips v4 and v7 uuids through base58 including surrounding whitespace', function (): void { // GIVEN $v4 = Uuid::uuid4(); $v7 = Uuid::uuid7(); // WHEN $v4Base58 = UuidHelper::toBase58($v4); $v7Base58 = UuidHelper::toBase58($v7); $decodedV4 = UuidHelper::fromBase58(" {$v4Base58} \n"); $decodedV7 = UuidHelper::fromBase58("\t{$v7Base58} "); // THEN expect($decodedV4->toString())->toBe($v4->toString()) ->and($decodedV7->toString())->toBe($v7->toString()); }); it('rejects invalid base58 inputs', function (string $input): void { // GIVEN / WHEN / THEN expect(static fn (): UuidInterface => UuidHelper::fromBase58($input)) ->toThrow(InvalidUuidException::class); })->with([ 'empty string' => [''], 'too short' => ['12345678901234567890'], 'too long' => ['12345678901234567890123'], 'ambiguous chars 0OIl' => ['0OIl123456789012345678'], 'invalid payload' => ['zzzzzzzzzzzzzzzzzzzzzz'], ]); it('detects uuid versions for v4, v7, and v1', function (): void { // GIVEN $v4 = Uuid::uuid4(); $v7 = Uuid::uuid7(); $v1 = Uuid::uuid1(); // WHEN & THEN expect(UuidHelper::version($v4))->toBe(4) ->and(UuidHelper::isV4($v4))->toBeTrue() ->and(UuidHelper::isV7($v4))->toBeFalse() ->and(UuidHelper::version($v7))->toBe(7) ->and(UuidHelper::isV4($v7))->toBeFalse() ->and(UuidHelper::isV7($v7))->toBeTrue() ->and(UuidHelper::version($v1))->toBe(1) ->and(UuidHelper::isV4($v1))->toBeFalse() ->and(UuidHelper::isV7($v1))->toBeFalse(); }); it('passes validateUuid for valid uuid and throws for invalid UuidInterface', function (): void { // GIVEN $valid = Uuid::uuid4(); $invalid = new LazyUuidFromString('invalid'); // WHEN UuidHelper::validateUuid($valid); // THEN expect(static function () use ($invalid): void { UuidHelper::validateUuid($invalid); })->toThrow(InvalidUuidException::class); }); it('extracts exact utc datetime with millisecond precision from v7 uuid', function (): void { // GIVEN $expected = new \DateTimeImmutable('2025-06-15 12:34:56.789000', new \DateTimeZone('UTC')); $v7 = Uuid::uuid7($expected); // WHEN $actual = UuidHelper::toDateTime($v7); // THEN expect($actual->getTimezone()->getName())->toBe('UTC') ->and($actual->format('Y-m-d H:i:s.v'))->toBe($expected->format('Y-m-d H:i:s.v')); }); it('throws InvalidUuidException when extracting datetime from non-v7 uuid', function (): void { // GIVEN $v4 = Uuid::uuid4(); // WHEN & THEN expect(static fn (): \DateTimeImmutable => UuidHelper::toDateTime($v4)) ->toThrow(InvalidUuidException::class); }); it('generates a v7 uuid using CarbonImmutable::now when no datetime is provided', function (): void { // GIVEN $frozen = CarbonImmutable::parse('2026-11-16 12:34:56.000', 'UTC'); CarbonImmutable::setTestNow($frozen); try { // WHEN $uuid = UuidHelper::v7(); // THEN expect(UuidHelper::isV7($uuid))->toBeTrue() ->and(UuidHelper::toDateTime($uuid)->format('Y-m-d H:i:s'))->toBe('2026-11-16 12:34:56'); } finally { CarbonImmutable::setTestNow(); } }); it('generates a v7 uuid using the provided datetime', function (): void { // GIVEN $dateTime = new \DateTimeImmutable('2025-05-01 08:15:30', new \DateTimeZone('UTC')); // WHEN $uuid = UuidHelper::v7($dateTime); // THEN expect(UuidHelper::isV7($uuid))->toBeTrue() ->and(UuidHelper::toDateTime($uuid)->format('Y-m-d H:i:s'))->toBe('2025-05-01 08:15:30'); }); it('generates a v4 uuid with UuidHelper::v4', function (): void { // WHEN $uuid = UuidHelper::v4(); // THEN expect(UuidHelper::isV4($uuid))->toBeTrue(); }); it('parses both rfc4122 and base58 uuids with UuidHelper::parse and throws on invalid input', function (): void { // GIVEN $v7 = UuidHelper::v7(); $base58 = UuidHelper::toBase58($v7); // WHEN & THEN expect(UuidHelper::parse($v7->toString())->toString())->toBe($v7->toString()) ->and(UuidHelper::parse($base58)->toString())->toBe($v7->toString()) ->and(static fn (): UuidInterface => UuidHelper::parse('invalid-uuid')) ->toThrow(InvalidUuidException::class); }); });