Files
server/tests/php/Unit/Preview/PreviewConfigurationTest.php
T
2026-08-29 07:53:14 -04:00

116 lines
4.7 KiB
PHP

<?php
declare(strict_types=1);
namespace KTXT\Unit\Preview;
use InvalidArgumentException;
use KTXC\Models\Tenant\TenantConfiguration;
use KTXC\Models\Tenant\TenantPreviewGeneration;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class PreviewConfigurationTest extends TestCase
{
#[Test]
public function providesSafeDefaultsWhenPreviewConfigurationIsAbsent(): void
{
$preview = (new TenantConfiguration())->preview();
self::assertTrue($preview->enabled());
self::assertSame('previews', $preview->store());
self::assertSame(TenantPreviewGeneration::MODE_EAGER_WITH_LAZY_FALLBACK, $preview->generation()->mode());
self::assertSame(104857600, $preview->generation()->maxSourceSize());
self::assertSame(30, $preview->generation()->timeoutSeconds());
self::assertSame(3600, $preview->generation()->retryDelaySeconds());
self::assertSame(640, $preview->variants()->variant('popover')?->width);
self::assertSame(440, $preview->variants()->variant('popover')?->height);
self::assertSame('image/webp', $preview->variants()->variant('popover')?->format);
self::assertSame(80, $preview->variants()->variant('popover')?->quality);
self::assertSame(256, $preview->variants()->variant('thumbnail')?->width);
}
#[Test]
public function loadsAndSerializesTenantPreviewConfiguration(): void
{
$data = [
'enabled' => true,
'store' => 'generated-content',
'generation' => [
'mode' => TenantPreviewGeneration::MODE_LAZY,
'maxSourceSize' => 1024,
'timeoutSeconds' => 5,
'retryDelaySeconds' => 60,
],
'variants' => [
'popover' => [
'width' => 800,
'height' => 600,
'format' => 'IMAGE/PNG',
'quality' => 90,
],
],
];
$configuration = (new TenantConfiguration())->jsonDeserialize(['preview' => $data]);
self::assertSame('generated-content', $configuration->preview()->store());
self::assertSame(TenantPreviewGeneration::MODE_LAZY, $configuration->preview()->generation()->mode());
self::assertSame(['popover'], array_keys($configuration->preview()->variants()->all()));
self::assertSame('image/png', $configuration->preview()->variants()->variant('popover')?->format);
$data['variants']['popover']['format'] = 'image/png';
self::assertSame($data, $configuration->jsonSerialize()['preview']);
}
#[Test]
public function mergesKnownVariantDefaultsForPartialOverrides(): void
{
$configuration = (new TenantConfiguration())->jsonDeserialize([
'preview' => [
'variants' => [
'popover' => ['width' => 900],
],
],
]);
$variant = $configuration->preview()->variants()->variant('popover');
self::assertSame(900, $variant?->width);
self::assertSame(440, $variant?->height);
self::assertSame('image/webp', $variant?->format);
self::assertSame(80, $variant?->quality);
self::assertNull($configuration->preview()->variants()->variant('thumbnail'));
}
#[Test]
public function allowsNoVariantsWhenPreviewsAreDisabled(): void
{
$configuration = (new TenantConfiguration())->jsonDeserialize([
'preview' => ['enabled' => false, 'variants' => []],
]);
self::assertFalse($configuration->preview()->enabled());
self::assertSame([], $configuration->preview()->variants()->all());
}
/** @return iterable<string, array{array<string, mixed>}> */
public static function invalidConfigurations(): iterable
{
yield 'invalid store' => [['store' => '../previews']];
yield 'unknown generation mode' => [['generation' => ['mode' => 'eager']]];
yield 'zero source limit' => [['generation' => ['maxSourceSize' => 0]]];
yield 'invalid variant name' => [['variants' => ['../popover' => []]]];
yield 'invalid dimensions' => [['variants' => ['popover' => ['width' => 0]]]];
yield 'invalid output MIME' => [['variants' => ['popover' => ['format' => 'webp']]]];
yield 'invalid quality' => [['variants' => ['popover' => ['quality' => 101]]]];
yield 'enabled without variants' => [['enabled' => true, 'variants' => []]];
}
#[Test]
#[\PHPUnit\Framework\Attributes\DataProvider('invalidConfigurations')]
public function rejectsInvalidConfiguration(array $data): void
{
$this->expectException(InvalidArgumentException::class);
(new TenantConfiguration())->jsonDeserialize(['preview' => $data]);
}
}