<?php

/**
 * Sicherung der Autoload-Aenderungen, damit sich jede rueckgaengig machen
 * laesst. Reine Logik ohne WordPress-Aufrufe (testbar in tests/Unit); das
 * Lesen und Schreiben der Option uebernimmt der Autoload_Manager.
 */
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class Wp360_Database_Cleaner_Autoload_Backup {

	const OPTION_KEY = 'wp360_dc_autoload_backup';

	/** Hoechstzahl gesicherter Optionen; darueber fallen die aeltesten weg. */
	const MAX_ENTRIES = 500;

	/**
	 * Haelt eine Aenderung fest. Wird dieselbe Option erneut geaendert, bleibt der
	 * urspruengliche Wert erhalten: "Rueckgaengig" soll zum echten Ausgangszustand
	 * zurueck, nicht zum Zwischenstand.
	 *
	 * @param array<string, array{previous: string, target: string, time: int}> $backup   Bisherige Sicherung.
	 * @param string                                                            $name     Optionsname.
	 * @param string                                                            $previous Spaltenwert autoload vor der Aenderung.
	 * @param string                                                            $target   Neues Ziel: 'on' oder 'off'.
	 * @param int                                                               $time     Zeitpunkt.
	 * @param int                                                               $max      Hoechstzahl der Eintraege.
	 * @return array<string, array{previous: string, target: string, time: int}>
	 */
	public static function merge( array $backup, $name, $previous, $target, $time, $max = self::MAX_ENTRIES ) {
		$original = isset( $backup[ $name ]['previous'] ) ? $backup[ $name ]['previous'] : $previous;

		// Neu anhaengen, damit die Reihenfolge der Einfuegung erhalten bleibt.
		unset( $backup[ $name ] );
		$backup[ $name ] = array(
			'previous' => (string) $original,
			'target'   => (string) $target,
			'time'     => (int) $time,
		);

		// Ueber der Grenze: die aeltesten (nach Zeit, bei Gleichstand nach Einfuegung) streichen.
		while ( count( $backup ) > $max ) {
			$oldest_key  = null;
			$oldest_time = null;
			foreach ( $backup as $key => $entry ) {
				if ( null === $oldest_time || $entry['time'] < $oldest_time ) {
					$oldest_key  = $key;
					$oldest_time = $entry['time'];
				}
			}
			unset( $backup[ $oldest_key ] );
		}

		return $backup;
	}

	/**
	 * @param array<string, array<string, mixed>> $backup Bisherige Sicherung.
	 * @param string                              $name   Optionsname.
	 * @return array<string, array<string, mixed>>
	 */
	public static function remove( array $backup, $name ) {
		unset( $backup[ $name ] );

		return $backup;
	}
}