<?php

/**
 * Entscheidung: Ist der Schutz aktiv, und soll ein Hinweis erscheinen?
 *
 * Eine Stelle entscheidet (siehe tasks/plan-staging-guard.md): HTTP-, Mail-,
 * Cron- und Sichtbarkeits-Waechter, Banner und CLI fragen hier ab.
 *
 * Die Tabelle in evaluate() ist reine Logik. state() bindet sie an
 * WordPress (Umgebungstyp, Adresse, Einstellungen, Notausschalter).
 */
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class Wp360_Staging_Guard_Environment {

	const REASON_DISABLED    = 'disabled';
	const REASON_OFF         = 'off';
	const REASON_FORCED      = 'forced';
	const REASON_ENVIRONMENT = 'environment';
	const REASON_NONE        = 'none';

	/**
	 * Entscheidung des laufenden Requests, einmal berechnet.
	 *
	 * @var array{active: bool, reason: string, notice: bool, environment: string}|null
	 */
	private static $state = null;

	/**
	 * Reine Entscheidungstabelle.
	 *
	 * Aktiv ist der Schutz bei *Immer an* und bei *Automatisch*, solange der
	 * Umgebungstyp nicht `production` ist. Eine abweichende Adresse allein
	 * schaltet ihn nie ein (Entscheidung 12.10.2026), sie loest nur den
	 * Hinweis aus: nicht aktiv, nicht *Aus*, Live-Adresse gesetzt, Host weicht ab.
	 *
	 * @param string $mode        auto|on|off.
	 * @param string $env_type    Ergebnis von wp_get_environment_type().
	 * @param string $current_url Aktuelle Adresse der Website.
	 * @param string $live_url    Gespeicherte Live-Adresse (oder leer).
	 * @param bool   $disabled    Notausschalter WP360_SG_DISABLE.
	 * @return array{active: bool, reason: string, notice: bool, environment: string}
	 */
	public static function evaluate( $mode, $env_type, $current_url, $live_url, $disabled = false ) {
		$env_type = (string) $env_type;

		if ( $disabled ) {
			return self::result( false, self::REASON_DISABLED, false, $env_type );
		}

		if ( 'off' === $mode ) {
			return self::result( false, self::REASON_OFF, false, $env_type );
		}

		if ( 'on' === $mode ) {
			return self::result( true, self::REASON_FORCED, false, $env_type );
		}

		// "auto" -- und jeder unbekannte Wert verhaelt sich wie "auto".
		if ( 'production' !== $env_type ) {
			return self::result( true, self::REASON_ENVIRONMENT, false, $env_type );
		}

		$notice = Wp360_Staging_Guard_Host_Matcher::differs_from_live( $current_url, $live_url );

		return self::result( false, self::REASON_NONE, $notice, $env_type );
	}

	/**
	 * Entscheidung fuer den laufenden Request (einmal berechnet).
	 *
	 * @return array{active: bool, reason: string, notice: bool, environment: string}
	 */
	public static function state() {
		if ( null === self::$state ) {
			$settings    = Wp360_Staging_Guard_Settings::get();
			self::$state = self::evaluate(
				$settings['mode'],
				wp_get_environment_type(),
				home_url(),
				$settings['live_url'],
				Wp360_Staging_Guard_Plugin::is_disabled()
			);
		}

		return self::$state;
	}

	/** Verwirft den zwischengespeicherten Zustand (nach einer Aenderung der Einstellungen im selben Request, und in Tests). */
	public static function reset() {
		self::$state = null;
	}

	/** @return bool */
	public static function is_active() {
		return self::state()['active'];
	}

	/**
	 * @param bool   $active Aktiv.
	 * @param string $reason Grund.
	 * @param bool   $notice Hinweis auf abweichende Adresse.
	 * @param string $env    Umgebungstyp.
	 * @return array{active: bool, reason: string, notice: bool, environment: string}
	 */
	private static function result( $active, $reason, $notice, $env ) {
		return array(
			'active'      => $active,
			'reason'      => $reason,
			'notice'      => $notice,
			'environment' => $env,
		);
	}
}