<?php
/**
 * Log helper for AI Support Assistant.
 *
 * @package AISupportAssistant\Helpers
 */

namespace AISupportAssistant\Helpers;

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

/**
 * Class Logger
 */
class Logger {

	/**
	 * Write a log entry.
	 *
	 * @param string $level   The log level (INFO, ERROR, DEBUG).
	 * @param string $message The message text to record.
	 * @param array  $context Context parameters.
	 * @return void
	 */
	public static function log( string $level, string $message, array $context = array() ): void {
		// Diagnostic logging is opt-in and must never create public upload files.
		if ( ! defined( 'WP_DEBUG' ) || ! WP_DEBUG ) {
			return;
		}
		foreach ( array( 'question', 'answer', 'session_id', 'response', 'api_key' ) as $sensitive_key ) {
			unset( $context[ $sensitive_key ] );
		}
		$settings = \AISupportAssistant\Admin\Settings::get_instance();
		foreach ( array( 'openai_api_key', 'gemini_api_key' ) as $key_name ) {
			$key = (string) $settings->get( $key_name, '' );
			if ( '' !== $key ) {
				$message = str_replace( $key, '[redacted]', $message );
			}
		}
		$message      = preg_replace( '/([?&]key=)[^\s&]+/i', '$1[redacted]', $message );
		$timestamp    = current_time( 'Y-m-d H:i:s' );
		$context_json = ''; // Do not record arbitrary provider payloads or user content.
		$formatted    = sprintf( "[%s] [%s] %s%s\n", $timestamp, strtoupper( $level ), $message, $context_json );

		// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
		error_log( $formatted );
	}

	/**
	 * Log info.
	 *
	 * @param string $message Log message.
	 * @param array  $context Context data.
	 * @return void
	 */
	public static function info( string $message, array $context = array() ): void {
		self::log( 'INFO', $message, $context );
	}

	/**
	 * Log error.
	 *
	 * @param string $message Log message.
	 * @param array  $context Context data.
	 * @return void
	 */
	public static function error( string $message, array $context = array() ): void {
		self::log( 'ERROR', $message, $context );
	}

	/**
	 * Log warning.
	 *
	 * @param string $message Log message.
	 * @param array  $context Context data.
	 * @return void
	 */
	public static function warning( string $message, array $context = array() ): void {
		self::log( 'WARNING', $message, $context );
	}

	/**
	 * Log debug.
	 *
	 * @param string $message Log message.
	 * @param array  $context Context data.
	 * @return void
	 */
	public static function debug( string $message, array $context = array() ): void {
		if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
			self::log( 'DEBUG', $message, $context );
		}
	}
}