<?php
/**
 * Scan result DTO.
 *
 * @package Integrum\SecurityScanner\Models
 */

declare( strict_types = 1 );

namespace Integrum\SecurityScanner\Models;

/**
 * Immutable scan result for a single file.
 */
final class ScanResult {

	public readonly string $file_path;

	public readonly string $status;

	public readonly string $threat_type;

	public readonly string $severity;

	public readonly ?string $scanned_at;

	public readonly array $detail;

	/**
	 * Constructor.
	 *
	 * @param string                $file_path   Relative path from the site root.
	 * @param string                $status      clean|infected|suspicious|error.
	 * @param string                $threat_type Threat class (empty if clean).
	 * @param string                $severity    info|low|medium|high|critical.
	 * @param string|null           $scanned_at  ISO-8601 timestamp.
	 * @param array<string, string> $detail Raw Imunify response fields (verdict, signature, ids).
	 */
	public function __construct(
		string $file_path,
		string $status,
		string $threat_type = '',
		string $severity = 'info',
		?string $scanned_at = null,
		array $detail = array()
	) {
		$this->file_path   = $file_path;
		$this->status      = $status;
		$this->threat_type = $threat_type;
		$this->severity    = $severity;
		$this->scanned_at  = $scanned_at;
		$this->detail      = $detail;
	}
}