test(migration): cover legacy footer settings migration to structured payload

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

Author: vitormattos

tests/php/Unit/Migration/Version18002Date20260410000000Test.php

@@ -0,0 +1,120 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Libresign\Tests\Unit\Migration;
+
+require_once __DIR__ . '/../../../../lib/Migration/Version18002Date20260410000000.php';
+
+use OCA\Libresign\AppInfo\Application;
+use OCA\Libresign\Migration\Version18002Date20260410000000;
+use OCA\Libresign\Service\Policy\Provider\Footer\SignatureFooterPolicyValue;
+use OCP\Exceptions\AppConfigTypeConflictException;
+use OCP\IAppConfig;
+use OCP\Migration\IOutput;
+use PHPUnit\Framework\MockObject\MockObject;
+use PHPUnit\Framework\TestCase;
+
+final class Version18002Date20260410000000Test extends TestCase {
+	private IAppConfig&MockObject $appConfig;
+
+	protected function setUp(): void {
+		parent::setUp();
+		$this->appConfig = $this->createMock(IAppConfig::class);
+	}
+
+	public function testMigratesLegacyFooterSettingsIntoStructuredPayload(): void {
+		$this->appConfig
+			->expects($this->exactly(4))
+			->method('getValueString')
+			->willReturnMap([
+				[Application::APP_ID, 'add_footer', '', '1'],
+				[Application::APP_ID, 'write_qrcode_on_footer', '', '0'],
+				[Application::APP_ID, 'validation_site', '', 'https://validator.example/base/'],
+				[Application::APP_ID, 'footer_template_is_default', '', '0'],
+			]);
+
+		$this->appConfig
+			->expects($this->once())
+			->method('deleteKey')
+			->with(Application::APP_ID, 'add_footer');
+
+		$this->appConfig
+			->expects($this->once())
+			->method('setValueString')
+			->with(
+				Application::APP_ID,
+				'add_footer',
+				SignatureFooterPolicyValue::encode([
+					'enabled' => true,
+					'writeQrcodeOnFooter' => false,
+					'validationSite' => 'https://validator.example/base/',
+					'customizeFooterTemplate' => true,
+				]),
+			);
+
+		$migration = new Version18002Date20260410000000($this->appConfig);
+		$migration->preSchemaChange($this->createMock(IOutput::class), static fn () => null, []);
+	}
+
+	public function testReadsLegacyBooleanWhenAddFooterHasTypedBoolValue(): void {
+		$this->appConfig
+			->expects($this->exactly(4))
+			->method('getValueString')
+			->willReturnCallback(static function (string $app, string $key, string $default): string {
+				if ($app !== Application::APP_ID) {
+					return $default;
+				}
+
+				if ($key === 'add_footer') {
+					throw new AppConfigTypeConflictException('bool stored');
+				}
+
+				if ($key === 'write_qrcode_on_footer') {
+					return '1';
+				}
+
+				if ($key === 'validation_site') {
+					return '';
+				}
+
+				if ($key === 'footer_template_is_default') {
+					return '1';
+				}
+
+				return $default;
+			});
+
+		$this->appConfig
+			->expects($this->once())
+			->method('getValueBool')
+			->with(Application::APP_ID, 'add_footer', true)
+			->willReturn(false);
+
+		$this->appConfig
+			->expects($this->once())
+			->method('deleteKey')
+			->with(Application::APP_ID, 'add_footer');
+
+		$this->appConfig
+			->expects($this->once())
+			->method('setValueString')
+			->with(
+				Application::APP_ID,
+				'add_footer',
+				SignatureFooterPolicyValue::encode([
+					'enabled' => false,
+					'writeQrcodeOnFooter' => true,
+					'validationSite' => '',
+					'customizeFooterTemplate' => false,
+				]),
+			);
+
+		$migration = new Version18002Date20260410000000($this->appConfig);
+		$migration->preSchemaChange($this->createMock(IOutput::class), static fn () => null, []);
+	}
+}