api/services/nginx/app/tests/Unit/Invoicing/EconomicUpstreamErrorFormattingTest.php

<?php

app_require('modules/economic/economic_m.php');

it('includes nested annotated e-conomic validation errors and developer hint in runtime exceptions', function (): void {
    $economic = new class extends economic_m {
        public function __construct()
        {
            // Intentionally skip parent constructor to avoid credential requirements in tests.
        }

        public function formatForTest(int $httpStatusCode, string $response): string
        {
            return $this->format_upstream_error_message($httpStatusCode, $response);
        }
    };

    $response = json_encode([
        'message' => 'Validation failed. 2 errors found.',
        'developerHint' => 'Review annotated errors for payload details.',
        'errors' => [
            'recipient' => [
                'attention' => [
                    'errorMessage' => 'Customer contact not found for recipient attention.',
                ],
            ],
            'references' => [
                'customerContact' => [
                    'errorMessage' => 'Customer contact reference is invalid.',
                ],
            ],
        ],
        'logId' => 'abc123',
        'httpStatusCode' => 400,
    ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

    expect($response)->not->toBeFalse();
    $formatted = $economic->formatForTest(400, (string)$response);

    expect($formatted)
        ->toContain('Validation failed. 2 errors found.')
        ->toContain('errors.recipient.attention: Customer contact not found for recipient attention.')
        ->toContain('errors.references.customerContact: Customer contact reference is invalid.')
        ->toContain('developerHint')
        ->toContain('abc123');
});