<?php

namespace TFGraphics\SmartImport\Logger;

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

final class RuntimeImportTrace
{

    public static function uas(string $stage, array $context = []): void
    {
        $allowed = ['INPUT', 'CLASSIFY', 'PLAN', 'DISCOVERY', 'EVIDENCE', 'DECISION', 'PRECISION', 'MERGE', 'IMAGE', 'PREVIEW', 'PI'];
        $normalized = strtoupper(trim($stage));
        if (! in_array($normalized, $allowed, true)) {
            throw new \InvalidArgumentException('Unsupported UAS trace stage.');
        }
        self::checkpoint('UAS', self::class, __FUNCTION__, $normalized, self::sanitize($context));
    }

    public static function checkpoint(string $checkpoint, string $class, string $method, string $esito, array $context = []): void
    {
        // Opt-in diagnostic logging; never create a public file in the plugin directory.
        if (! defined('TFSI_RUNTIME_TRACE_ENABLED') || TFSI_RUNTIME_TRACE_ENABLED !== true) {
            return;
        }
        $timestamp = self::timestamp();
        $encodedContext = self::encodeContext(self::sanitize($context));
        $line = sprintf(
            "[%s] CHECKPOINT %s | class=%s | method=%s | esito=%s | context=%s\n",
            $timestamp,
            $checkpoint,
            $class,
            $method,
            $esito,
            $encodedContext
        );

        self::writeLine($line);
    }

    private static function timestamp(): string
    {
        $microtime = microtime(true);
        $date = \DateTimeImmutable::createFromFormat('U.u', sprintf('%.6f', $microtime));

        if ($date instanceof \DateTimeImmutable) {
            return $date->format('Y-m-d H:i:s.u');
        }

        return gmdate('Y-m-d H:i:s');
    }

    private static function encodeContext(array $context): string
    {
        $json = function_exists('wp_json_encode')
            ? wp_json_encode($context, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)
            : json_encode($context, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

        return is_string($json) ? $json : '{}';
    }

    private static function sanitize(array $context): array
    {
        $safe = (new \TFGraphics\SmartImport\Inspector\Redaction\InspectorRedactor())->redact($context)->getValue();
        return is_array($safe) ? $safe : [];
    }

    private static function writeLine(string $line): void
    {
        if (function_exists('wc_get_logger')) {
            wc_get_logger()->debug($line, ['source' => 'tfsi-runtime']);
        }
    }
}