<?php

namespace App\Logging;

use Monolog\Formatter\LineFormatter;
use Monolog\Handler\RotatingFileHandler;
use Monolog\Logger;

/**
 * Dedicated file logger for the Blacksoil BRE evaluate() journey.
 * Writes daily-rotated files at storage/logs/blacksoil-bre-YYYY-MM-DD.log
 * (retains last 30 files). Lazy-initialised singleton — safe to call from
 * anywhere in the request lifecycle.
 */
class BlacksoilBreLogger
{
    private static $instance;

    public static function logger()
    {
        if (self::$instance !== null) {
            return self::$instance;
        }

        $logger  = new Logger('blacksoil_bre');
        $handler = new RotatingFileHandler(
            storage_path('logs/blacksoil-bre.log'),
            30,
            Logger::DEBUG
        );
        $handler->setFormatter(new LineFormatter(
            "[%datetime%] %level_name%: %message% %context%\n",
            'Y-m-d H:i:s',
            true,
            true
        ));
        $logger->pushHandler($handler);

        self::$instance = $logger;
        return $logger;
    }

    /**
     * Emit a structured journey event.
     * Always tags the batch + row identifiers when supplied so a single upload
     * can be traced end-to-end via grep.
     */
    public static function event($name, array $context = [])
    {
        self::logger()->info($name, $context);
    }

    public static function warning($name, array $context = [])
    {
        self::logger()->warning($name, $context);
    }

    public static function error($name, array $context = [])
    {
        self::logger()->error($name, $context);
    }
}