<?php

namespace TFGraphics\SmartImport\DomainEngine\Exceptions;

/**
 * Thrown when the DomainEngine cannot resolve the domain for a given input.
 * Maps to error type DISCOVERY_UNRESOLVED defined in UNIVERSAL_PROVIDER_DISCOVERY.md.
 */
final class DiscoveryUnresolvedException extends \RuntimeException
{
    private string $sanitizedInput;
    private string $suggestion;

    public function __construct(
        string     $sanitizedInput,
        string     $suggestion = 'Verificare che il codice sia un ISBN, EAN o identificatore valido.',
        \Throwable $previous = null
    ) {
        $this->sanitizedInput = $sanitizedInput;
        $this->suggestion     = $suggestion;

        parent::__construct(
            sprintf(
                '[DISCOVERY_UNRESOLVED] Input non riconosciuto: "%s". %s',
                $sanitizedInput,
                $suggestion
            ),
            0,
            $previous
        );
    }

    public function getSanitizedInput(): string { return $this->sanitizedInput; }
    public function getSuggestion(): string     { return $this->suggestion; }

    /** Structured payload for API/AJAX responses */
    public function toArray(): array
    {
        return [
            'error_type'  => 'DISCOVERY_UNRESOLVED',
            'input'       => $this->sanitizedInput,
            'suggestion'  => $this->suggestion,
        ];
    }
}