<?php
namespace Consiva\Consent\Support;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Notable events worth knowing about in support: the last MAX warnings are kept (no personal data, no
 * tokens) and appear in the Diagnostics bundle. With WP_DEBUG_LOG on they also go to debug.log, and the
 * consiva_consent_log action lets a site send them elsewhere.
 */
final class Logger {

	const OPTION = 'consiva_consent_log';
	const MAX    = 10;

	/**
	 * @param string $message Plain text: never include tokens or personal data.
	 * @return void
	 */
	public static function warning( $message ) {
		$message = sanitize_text_field( (string) $message );
		$log     = get_option( self::OPTION, array() );
		$log     = is_array( $log ) ? $log : array();
		$log[]   = array(
			'at'      => time(),
			'message' => $message,
		);
		update_option( self::OPTION, array_slice( $log, -self::MAX ), false );

		/**
		 * Fires when Consiva.ai records a warning.
		 *
		 * @param string $message Warning.
		 */
		do_action( 'consiva_consent_log', $message );

		if ( defined( 'WP_DEBUG' ) && WP_DEBUG && defined( 'WP_DEBUG_LOG' ) && WP_DEBUG_LOG ) {
			error_log( 'Consiva.ai: ' . $message ); // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log -- only when the site owner turned on WP_DEBUG_LOG.
		}
	}

	/**
	 * @return array<int,array{at:int,message:string}>
	 */
	public static function recent() {
		$log = get_option( self::OPTION, array() );
		return is_array( $log ) ? $log : array();
	}
}