<?php

namespace TFGraphics\SmartImport\DomainEngine;

/**
 * Value object returned by IdentifierClassifier.
 * Carries the resolved domain, identifier type, normalised value and confidence level.
 *
 * Confidence levels:
 *  - HIGH   : Classe A — deterministic regex match, no ambiguity
 *  - MEDIUM : Classe B — contextual hint used
 *  - LOW    : heuristic guess, requires operator confirmation
 */
final class IdentifierResolution
{
    public const CONFIDENCE_HIGH   = 'high';
    public const CONFIDENCE_MEDIUM = 'medium';
    public const CONFIDENCE_LOW    = 'low';

    private string  $domain;
    private string  $identifierType;
    private string  $normalizedValue;
    private string  $confidence;
    private ?string $hint;

    public function __construct(
        string  $domain,
        string  $identifierType,
        string  $normalizedValue,
        string  $confidence = self::CONFIDENCE_HIGH,
        ?string $hint = null
    ) {
        $this->domain          = $domain;
        $this->identifierType  = $identifierType;
        $this->normalizedValue = $normalizedValue;
        $this->confidence      = $confidence;
        $this->hint            = $hint;
    }

    public function getDomain(): string          { return $this->domain; }
    public function getIdentifierType(): string  { return $this->identifierType; }
    public function getNormalizedValue(): string { return $this->normalizedValue; }
    public function getConfidence(): string      { return $this->confidence; }
    public function getHint(): ?string           { return $this->hint; }

    public function isHighConfidence(): bool   { return $this->confidence === self::CONFIDENCE_HIGH; }
    public function isMediumConfidence(): bool { return $this->confidence === self::CONFIDENCE_MEDIUM; }
    public function isLowConfidence(): bool    { return $this->confidence === self::CONFIDENCE_LOW; }
}