??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
??????????????
<?php

namespace WPMailSMTP;

use WPMailSMTP\Admin\DebugEvents\DebugEvents;
use WPMailSMTP\Helpers\Helpers;

/**
 * Class Debug — legacy global "last error" message bag.
 *
 * The plugin no longer reads from this bag. For diagnostic logging, use
 * {@see DebugEvents::add()}. For tracking the current email-sending failure
 * state per connection (the data the EmailSendingErrors banner renders), use
 * {@see EmailSendingDebug}.
 *
 * @since      1.2.0
 * @deprecated {VERSION}
 */
class Debug {

	/**
	 * Key for options table where all messages will be saved to.
	 *
	 * @since 1.2.0
	 */
	const OPTION_KEY = 'wp_mail_smtp_debug';

	/**
	 * Hold the cached error messages.
	 *
	 * @since 3.0.0
	 *
	 * @var array
	 */
	private static $cached_messages;

	/**
	 * Save unique debug message to a debug log.
	 * Adds one more to a list, at the end.
	 *
	 * Use {@see DebugEvents::add()} directly. The legacy bag this method
	 * writes to has no remaining readers in the plugin.
	 *
	 * @since      1.2.0
	 * @since      3.0.0 Start saving the Debug Event IDs, instead of error messages.
	 * @since      3.5.0 Returns Event ID.
	 * @deprecated {VERSION}
	 *
	 * @param mixed $message An array or string error message.
	 *
	 * @return bool|int
	 */
	public static function set( $message ) {

		if ( empty( $message ) ) {
			return false;
		}

		self::clear_cache();

		// Log the error message to the Debug Events.
		$event_id = DebugEvents::add( $message );

		$all = self::get_raw();

		if ( ! empty( $event_id ) ) {
			array_push( $all, $event_id );
		} else {
			if ( ! is_string( $message ) ) {
				$message = wp_json_encode( $message );
			} else {
				$message = wp_strip_all_tags( $message, false );
			}

			array_push( $all, $message );
		}

		update_option( self::OPTION_KEY, array_unique( $all ), false );

		return $event_id;
	}

	/**
	 * Remove all messages for a debug log.
	 *
	 * The plugin no longer reads from this bag, so clearing it is a no-op for
	 * in-plugin behavior. For per-connection send failure state, use
	 * {@see EmailSendingDebug::clear()}.
	 *
	 * @since      1.2.0
	 * @deprecated {VERSION}
	 */
	public static function clear() {

		self::clear_cache();

		update_option( self::OPTION_KEY, [], false );
	}

	/**
	 * Clear cached error messages.
	 *
	 * @since 3.0.0
	 */
	private static function clear_cache() {

		self::$cached_messages = null;
	}

	/**
	 * Get the raw DB debug option values.
	 *
	 * @since 3.0.0
	 */
	private static function get_raw() {

		$all = get_option( self::OPTION_KEY, [] );

		if ( ! is_array( $all ) ) {
			$all = (array) $all;
		}

		return $all;
	}

	/**
	 * Retrieve all messages from a debug log.
	 *
	 * For diagnostic event history, use {@see DebugEvents::get_debug_messages()}.
	 * For per-connection send failure state, use {@see EmailSendingDebug::get()}.
	 *
	 * @since      1.2.0
	 * @deprecated {VERSION}
	 *
	 * @return array
	 */
	public static function get() {

		if ( isset( self::$cached_messages ) ) {
			return self::$cached_messages;
		}

		$all = self::get_raw();

		if ( empty( $all ) ) {
			self::$cached_messages = [];

			return [];
		}

		$event_ids    = [];
		$old_messages = [];

		foreach ( $all as $item ) {
			if ( is_int( $item ) ) {
				$event_ids[] = (int) $item;
			} else {
				$old_messages[] = $item;
			}
		}

		$event_messages        = DebugEvents::get_debug_messages( $event_ids );
		self::$cached_messages = array_unique( array_merge( $old_messages, $event_messages ) );

		return self::$cached_messages;
	}

	/**
	 * Get the last message that was saved to a debug log.
	 *
	 * For per-connection send failure state, use {@see EmailSendingDebug::get()}
	 * keyed by connection id and read the `error_message` field.
	 *
	 * @since      1.2.0
	 * @deprecated {VERSION}
	 *
	 * @return string
	 */
	public static function get_last() {

		$all = self::get();

		if ( ! empty( $all ) && is_array( $all ) ) {
			return (string) end( $all );
		}

		return '';
	}

	/**
	 * Get the proper variable content output to debug.
	 *
	 * Moved to {@see Helpers::pvar(