109 lines
3.4 KiB
PHP
109 lines
3.4 KiB
PHP
|
|
<?php
|
||
|
|
|
||
|
|
declare(strict_types=1);
|
||
|
|
|
||
|
|
namespace Tests\Unit\Shared\Helpers;
|
||
|
|
|
||
|
|
use Ramsey\Uuid\Lazy\LazyUuidFromString;
|
||
|
|
use Ramsey\Uuid\Uuid;
|
||
|
|
use Ramsey\Uuid\UuidInterface;
|
||
|
|
use Shared\Exceptions\InvalidUuidException;
|
||
|
|
use Shared\Helpers\UuidHelper;
|
||
|
|
|
||
|
|
covers(UuidHelper::class);
|
||
|
|
|
||
|
|
it('validates uuid strings with isValid', function (): void {
|
||
|
|
// GIVEN
|
||
|
|
$v4 = Uuid::uuid4()->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);
|
||
|
|
});
|