Files
WP-LIT-MCP/tests/Unit/Abilities/WriteFailedTest.php
T
janniclas.loosenandClaude Opus 5.5 8e5ba9eac4 refactor: WriteFailed named constructors, Rollback runner, Errors read-back helpers (H6)
- WriteFailed::rolledBack()/partial() replace the 11-parameter constructor (now
  private); the hint/state of either error are plain $hint/$state.
- Rollback::attempt(...steps) runs every undo step and collects failure messages;
  used by ContentCreate::discard, ContentUpdate::rollBack, MediaUpdate::rollBack and
  DiviSaver::restore.
- Errors::clientMessage/codeOf/fieldsOf replace DiviReplaceTextAbility::reason,
  the JSON digging in MediaUpdateAbility::failure and ContentCreateAbility::fields.
- Errors docblock documents the exception/WP_Error split.
- ContentCreateAbility::discard takes the client reason as a parameter (both callers
  still pass REASON_EXTRAS; changing the Divi text needs a ruling).

Error payloads unchanged.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-26 17:40:32 +02:00

100 lines
4.4 KiB
PHP

<?php
declare(strict_types=1);
namespace LIT\MCP\Tests\Unit\Abilities;
use LIT\MCP\Abilities\WriteFailed;
use LIT\MCP\Tests\Unit\TestCase;
use RuntimeException;
final class WriteFailedTest extends TestCase
{
public function testCleanRollbackMapsToWriteFailed(): void
{
$cause = new RuntimeException('meta kaputt');
$failure = WriteFailed::rolledBack('Felder konnten nicht gespeichert werden.', $cause, postId: 5);
self::assertTrue($failure->rolledBack);
self::assertSame($cause, $failure->getPrevious());
self::assertStringContainsString('meta kaputt', $failure->getMessage());
self::assertSame('lit_write_failed', $failure->toError()->get_error_code());
}
public function testRolledBackHintReplacesTheDefaultHintOfWriteFailedOnly(): void
{
$clean = WriteFailed::rolledBack('x', hint: 'Erst neu lesen.');
$partial = WriteFailed::partial('x');
self::assertSame('Erst neu lesen.', $clean->toError()->get_error_data()['hint']);
self::assertNotSame('Erst neu lesen.', $partial->toError()->get_error_data()['hint']);
self::assertStringStartsWith('Den Aufruf nicht einfach wiederholen.', $partial->toError()->get_error_data()['hint']);
}
public function testIncompleteRollbackMapsToPartialWriteWithTheIds(): void
{
$error = WriteFailed::partial('Felder konnten nicht gespeichert werden.', postId: 5, revisionId: 811)->toError();
self::assertSame('lit_partial_write', $error->get_error_code());
self::assertSame(5, $error->get_error_data()['post_id']);
self::assertSame(811, $error->get_error_data()['revision_id']);
}
public function testIncompleteRollbackCanDescribeItsOwnStateHintAndDetails(): void
{
$error = WriteFailed::partial(
'Menü nicht gespeichert.',
state: 'Das Menü ist teilweise geändert.',
hint: 'Mit lit/menu-get prüfen.',
details: ['menu_id' => 3]
)->toError();
self::assertSame('lit_partial_write', $error->get_error_code());
self::assertStringContainsString('Das Menü ist teilweise geändert.', $error->get_error_message());
self::assertStringNotContainsString('Entwurf', $error->get_error_message());
self::assertSame('Mit lit/menu-get prüfen.', $error->get_error_data()['hint']);
self::assertSame(3, $error->get_error_data()['menu_id']);
}
public function testRolledBackStateReplacesNothingWasSavedOfWriteFailedOnly(): void
{
$state = 'Die Änderung wurde nicht gespeichert (Sicherung 88 bleibt erhalten).';
$clean = WriteFailed::rolledBack('x', state: $state)->toError();
$partial = WriteFailed::partial('x')->toError();
self::assertStringContainsString($state, $clean->get_error_message());
self::assertStringNotContainsString('Nichts wurde gespeichert', $clean->get_error_message());
self::assertStringNotContainsString($state, $partial->get_error_message());
}
public function testCleanRollbackKeepsItsDetails(): void
{
$error = WriteFailed::rolledBack('Nicht übernommen.', details: ['backup_id' => 88])->toError();
self::assertSame('lit_write_failed', $error->get_error_code());
self::assertSame(88, $error->get_error_data()['backup_id']);
self::assertStringContainsString('"backup_id":88', $error->get_error_message());
}
public function testTheLogMessageIsTheDetailOrTheCauseOrTheReasonWithTheRollbackOutcome(): void
{
$cause = new RuntimeException('meta kaputt');
self::assertSame('Detail [rolled back]', WriteFailed::rolledBack('x', $cause, 'Detail')->getMessage());
self::assertSame('meta kaputt [rollback incomplete]', WriteFailed::partial('x', $cause)->getMessage());
self::assertSame('Grund [rolled back]', WriteFailed::rolledBack('Grund')->getMessage());
}
public function testTheNamedConstructorsKeepTheIdsForCallersThatLogThem(): void
{
$clean = WriteFailed::rolledBack('x', postId: 7, revisionId: 811);
$partial = WriteFailed::partial('x', postId: 7, revisionId: 811);
self::assertTrue($clean->rolledBack);
self::assertSame([7, 811], [$clean->postId, $clean->revisionId]);
self::assertFalse($partial->rolledBack);
self::assertSame([7, 811], [$partial->postId, $partial->revisionId]);
self::assertArrayNotHasKey('post_id', $clean->toError()->get_error_data());
}
}