<?php

/**
 * Verlauf der Aktionen dieses Plugins (letzte 20). push() ist reine Logik
 * ohne WordPress-Aufrufe (testbar in tests/Unit); add() und all() lesen und
 * schreiben die Option.
 */
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class Wp360_Database_Cleaner_History {

	const OPTION_KEY = 'wp360_dc_history';

	const MAX_ENTRIES = 20;

	/**
	 * Fuegt einen Eintrag vorn an und kuerzt auf die neuesten.
	 *
	 * @param array<int, array{time: int, type: string, data: array}> $entries Bisherige Eintraege (neueste zuerst).
	 * @param string                                                  $type    Art der Aktion, z. B. 'autoload_off'.
	 * @param array                                                   $data    Einzelheiten; wird erst bei der Anzeige in Text umgesetzt.
	 * @param int                                                     $time    Zeitpunkt.
	 * @param int                                                     $max     Hoechstzahl der Eintraege.
	 * @return array<int, array{time: int, type: string, data: array}>
	 */
	public static function push( array $entries, $type, array $data, $time, $max = self::MAX_ENTRIES ) {
		array_unshift(
			$entries,
			array(
				'time' => (int) $time,
				'type' => (string) $type,
				'data' => $data,
			)
		);

		return array_slice( $entries, 0, $max );
	}

	/**
	 * Haelt eine Aktion im Verlauf fest. Autoload aus: Der Verlauf wird nur auf
	 * der eigenen Seite gelesen und soll nicht bei jedem Aufruf in den Speicher.
	 *
	 * @param string $type Art der Aktion.
	 * @param array  $data Einzelheiten.
	 */
	public static function add( $type, array $data ) {
		update_option( self::OPTION_KEY, self::push( self::all(), $type, $data, time() ), false );
	}

	/** @return array<int, array{time: int, type: string, data: array}> */
	public static function all() {
		$entries = get_option( self::OPTION_KEY, array() );

		return is_array( $entries ) ? $entries : array();
	}
}