<?php
/**
 * Das Import-Protokoll als Ringpuffer in einer Option.
 *
 * @package Aivor\Content
 */

namespace Aivor\Content\Log;

defined( 'ABSPATH' ) || exit;

/**
 * Schreibt und liest die Option aivor_content_log.
 *
 * Das Protokoll ist das Werkzeug, mit dem der Support in fuenf Minuten sieht,
 * was los ist. Jedes Ereignis geht zusaetzlich ueber do_action(), damit
 * Betreiber es in ihr eigenes Logging haengen koennen.
 */
final class EventLog {

	/**
	 * Name der Option.
	 *
	 * @var string
	 */
	public const OPTION = 'aivor_content_log';

	/**
	 * Groesse des Ringpuffers.
	 *
	 * @var int
	 */
	public const MAX_ENTRIES = 200;

	/**
	 * Zusammenfassung eines Laufs.
	 *
	 * @var string
	 */
	public const TYPE_RUN = 'run';

	/**
	 * Ein Beitrag wurde neu angelegt.
	 *
	 * @var string
	 */
	public const TYPE_IMPORTED = 'imported';

	/**
	 * Aivor hat eine erweiterte Fassung eines Bestandsbeitrags geliefert; sie
	 * kam als eigener Entwurf, der Bestandsbeitrag blieb unveraendert. Der
	 * Wert bleibt „replaced", damit aeltere Protokolleintraege lesbar bleiben.
	 *
	 * @var string
	 */
	public const TYPE_REPLACED = 'replaced';

	/**
	 * Eine Veroeffentlichung wurde an Aivor gemeldet.
	 *
	 * @var string
	 */
	public const TYPE_REPORTED = 'reported';

	/**
	 * Ein Patch wurde angewendet.
	 *
	 * @var string
	 */
	public const TYPE_PATCH_APPLIED = 'patch_applied';

	/**
	 * Ein Patch passte nicht mehr zum aktuellen Stand.
	 *
	 * @var string
	 */
	public const TYPE_PATCH_STALE = 'patch_stale';

	/**
	 * Ein Patch ist endgueltig gescheitert.
	 *
	 * @var string
	 */
	public const TYPE_PATCH_FAILED = 'patch_failed';

	/**
	 * Ein Patch wurde zurueckgestellt und nicht quittiert.
	 *
	 * @var string
	 */
	public const TYPE_PATCH_DEFERRED = 'patch_deferred';

	/**
	 * Die Aivor-API hat einen Fehler geliefert.
	 *
	 * @var string
	 */
	public const TYPE_API_ERROR = 'api_error';

	/**
	 * Ein Titelbild liess sich nicht laden.
	 *
	 * @var string
	 */
	public const TYPE_IMAGE_FAILED = 'image_failed';

	/**
	 * Aivor konnte die gemeldete URL nicht der Site zuordnen.
	 *
	 * @var string
	 */
	public const TYPE_URL_UNVERIFIED = 'url_unverified';

	/**
	 * Eine Lieferung war unbrauchbar und wurde verworfen.
	 *
	 * Der Server hat den Draft beim Abholen bereits verbucht — ohne diesen
	 * Eintrag waere der Text spurlos verloren. Die Meldung nennt deshalb den
	 * draft_hash, damit der Support ihn in Aivor erneut freigeben kann.
	 *
	 * @var string
	 */
	public const TYPE_DISCARDED = 'discarded';

	/**
	 * Ereignis ohne Handlungsbedarf.
	 *
	 * @var string
	 */
	public const LEVEL_INFO = 'info';

	/**
	 * Ereignis, das beobachtet werden sollte.
	 *
	 * @var string
	 */
	public const LEVEL_WARNING = 'warning';

	/**
	 * Ereignis, das Handeln erfordert.
	 *
	 * @var string
	 */
	public const LEVEL_ERROR = 'error';

	/**
	 * Schreibt ein Ereignis in den Ringpuffer.
	 *
	 * @param string               $type    Einer der TYPE_-Werte.
	 * @param string               $message Klartext, niemals mit Secrets.
	 * @param array<string, mixed> $context Optional: level, job_id, post_id.
	 * @return void
	 */
	public static function add( string $type, string $message, array $context = array() ): void {
		$entry = array(
			'time'    => time(),
			'type'    => $type,
			'level'   => isset( $context['level'] ) ? (string) $context['level'] : self::LEVEL_INFO,
			'message' => $message,
			'job_id'  => isset( $context['job_id'] ) ? (int) $context['job_id'] : 0,
			'post_id' => isset( $context['post_id'] ) ? (int) $context['post_id'] : 0,
		);

		// Frisch gelesen, siehe Settings::update(): sonst ueberschriebe ein
		// laufender Lauf ein zwischenzeitlich geleertes Protokoll.
		wp_cache_delete( self::OPTION, 'options' );

		$log = self::all();
		array_unshift( $log, $entry );
		$log = array_slice( $log, 0, self::MAX_ENTRIES );

		update_option( self::OPTION, $log, false );

		/**
		 * Meldet ein Protokollereignis weiter.
		 *
		 * @param array<string, mixed> $entry Der geschriebene Eintrag.
		 */
		do_action( 'aivor_content_log', $entry );
	}

	/**
	 * Liefert alle Eintraege, neueste zuerst.
	 *
	 * @return array<int, array<string, mixed>>
	 */
	public static function all(): array {
		$log = get_option( self::OPTION, array() );

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

	/**
	 * Leert das Protokoll.
	 *
	 * @return void
	 */
	public static function clear(): void {
		delete_option( self::OPTION );
	}

	/**
	 * Uebersetzte Bezeichnung eines Ereignistyps.
	 *
	 * @param string $type Einer der TYPE_-Werte.
	 * @return string
	 */
	public static function label( string $type ): string {
		$labels = array(
			self::TYPE_RUN            => __( 'Run', 'aivor-content-import' ),
			self::TYPE_IMPORTED       => __( 'Imported', 'aivor-content-import' ),
			self::TYPE_REPLACED       => __( 'Extended version', 'aivor-content-import' ),
			self::TYPE_REPORTED       => __( 'Reported', 'aivor-content-import' ),
			self::TYPE_PATCH_APPLIED  => __( 'Link update applied', 'aivor-content-import' ),
			self::TYPE_PATCH_STALE    => __( 'Link update outdated', 'aivor-content-import' ),
			self::TYPE_PATCH_FAILED   => __( 'Link update failed', 'aivor-content-import' ),
			self::TYPE_PATCH_DEFERRED => __( 'Link update postponed', 'aivor-content-import' ),
			self::TYPE_API_ERROR      => __( 'API error', 'aivor-content-import' ),
			self::TYPE_IMAGE_FAILED   => __( 'Featured image failed', 'aivor-content-import' ),
			self::TYPE_URL_UNVERIFIED => __( 'Address not confirmed', 'aivor-content-import' ),
			self::TYPE_DISCARDED      => __( 'Delivery discarded', 'aivor-content-import' ),
		);

		return $labels[ $type ] ?? $type;
	}
}