<?php
/**
 * Logger wrapper around the WooCommerce logging API.
 *
 * @package ProfitEngine
 */

declare( strict_types=1 );

namespace ProfitEngine\Infrastructure;

defined( 'ABSPATH' ) || exit;

/**
 * Thin logging facade.
 *
 * Uses WooCommerce's logger (visible under WooCommerce → Status → Logs) with a
 * dedicated `profit-engine` source, falling back to error_log() when WC is unavailable.
 * All logging is gated behind a filter so verbose logging can be disabled in
 * production without code changes.
 */
class Logger {

	private const SOURCE = 'profit-engine';

	/**
	 * Whether logging is enabled for the current request.
	 */
	private function is_enabled(): bool {
		/**
		 * Toggle PPE logging.
		 *
		 * @param bool $enabled Defaults to true when WP_DEBUG is on.
		 */
		return (bool) apply_filters( 'profit_engine_logging_enabled', defined( 'WP_DEBUG' ) && WP_DEBUG );
	}

	/**
	 * Log an informational message.
	 *
	 * @param string              $message Message.
	 * @param array<string,mixed> $context Extra context.
	 */
	public function info( string $message, array $context = array() ): void {
		$this->log( 'info', $message, $context );
	}

	/**
	 * Log a warning.
	 *
	 * @param string              $message Message.
	 * @param array<string,mixed> $context Extra context.
	 */
	public function warning( string $message, array $context = array() ): void {
		$this->log( 'warning', $message, $context );
	}

	/**
	 * Log an error. Errors are always recorded regardless of the enabled flag.
	 *
	 * @param string              $message Message.
	 * @param array<string,mixed> $context Extra context.
	 */
	public function error( string $message, array $context = array() ): void {
		$this->log( 'error', $message, $context, true );
	}

	/**
	 * Write a log entry.
	 *
	 * @param string              $level   Log level.
	 * @param string              $message Message.
	 * @param array<string,mixed> $context Extra context.
	 * @param bool                $force   Bypass the enabled gate (for errors).
	 */
	private function log( string $level, string $message, array $context, bool $force = false ): void {
		if ( ! $force && ! $this->is_enabled() ) {
			return;
		}

		if ( array() !== $context ) {
			$message .= ' ' . wp_json_encode( $context );
		}

		if ( function_exists( 'wc_get_logger' ) ) {
			wc_get_logger()->log( $level, $message, array( 'source' => self::SOURCE ) );
			return;
		}

		// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
		error_log( sprintf( '[%s][%s] %s', self::SOURCE, $level, $message ) );
	}
}