<?php

namespace TFGraphics\SmartImport\DomainEngine;

/**
 * Complete output of DomainEngine::resolve().
 * Carries the identifier resolution + the resolved provider chain.
 */
final class DomainResolution
{
    private ?IdentifierResolution $identifierResolution;
    private ProviderChain         $providerChain;
    private string                $resolvedDomain;
    private bool                  $requiresOperatorInput;

    public function __construct(
        string                $resolvedDomain,
        ProviderChain         $providerChain,
        ?IdentifierResolution $identifierResolution  = null,
        bool                  $requiresOperatorInput = false
    ) {
        $this->resolvedDomain        = $resolvedDomain;
        $this->providerChain         = $providerChain;
        $this->identifierResolution  = $identifierResolution;
        $this->requiresOperatorInput = $requiresOperatorInput;
    }

    public function getResolvedDomain(): string           { return $this->resolvedDomain; }
    public function getProviderChain(): ProviderChain     { return $this->providerChain; }
    public function getIdentifierResolution(): ?IdentifierResolution { return $this->identifierResolution; }
    public function requiresOperatorInput(): bool         { return $this->requiresOperatorInput; }

    /** Convenience: primary provider name or null */
    public function getPrimaryProvider(): ?string
    {
        return $this->providerChain->getPrimary();
    }

    /** Convenience: true when a non-empty chain was resolved */
    public function isResolved(): bool
    {
        return ! $this->providerChain->isEmpty() && ! $this->requiresOperatorInput;
    }
}