<?php

declare(strict_types=1);

use App\Support\ReasonTranslation\FallbackReasonTranslator;
use App\Support\ReasonTranslation\NextStepOption;
use App\Support\ReasonTranslation\ReasonResolutionEnvelope;

it('renders body lines and legacy next steps from the shared envelope', function (): void {
    $envelope = new ReasonResolutionEnvelope(
        internalCode: 'provider_consent_missing',
        operatorLabel: 'Admin consent required',
        shortExplanation: 'The provider connection cannot continue until admin consent is granted.',
        actionability: 'prerequisite_missing',
        nextSteps: [
            NextStepOption::link('Grant admin consent', 'https://example.test/admin-consent'),
        ],
    );

    expect($envelope->toBodyLines())->toBe([
        'Admin consent required',
        'The provider connection cannot continue until admin consent is granted.',
        'Next step: Grant admin consent.',
    ])->and($envelope->toLegacyNextSteps())->toBe([
        [
            'label' => 'Grant admin consent',
            'url' => 'https://example.test/admin-consent',
        ],
    ]);
});

it('builds understandable fallback translations without exposing raw codes as operator labels', function (): void {
    $envelope = app(FallbackReasonTranslator::class)->translate('custom_retry_timeout');

    expect($envelope)->not->toBeNull()
        ->and($envelope?->operatorLabel)->toBe('Custom Retry Timeout')
        ->and($envelope?->operatorLabel)->not->toBe('custom_retry_timeout')
        ->and($envelope?->shortExplanation)->toContain('transient dependency issue')
        ->and($envelope?->guidanceText())->toBe('Next step: Retry after the dependency recovers.');
});