<?php
namespace Zadex\Forms\Integrations;

defined('ABSPATH') || exit;

/**
 * Error log for the form integrations. Messages never contain API keys (they come from provider responses
 * or our own validation). Each entry fires `zadex/forms/integration_error` (provider, message, context) and
 * is written to the PHP error log when WP_DEBUG_LOG is on. The last entries are kept in memory for tests.
 */
final class Log
{
    /** @var array<int, array{provider: string, message: string, context: array<string, mixed>}> */
    private static array $entries = [];

    /** @param array<string, mixed> $context */
    public static function error(string $provider, string $message, array $context = []): void
    {
        self::$entries[] = ['provider' => $provider, 'message' => $message, 'context' => $context];
        if (count(self::$entries) > 50) {
            array_shift(self::$entries);
        }
        do_action('zadex/forms/integration_error', $provider, $message, $context);
        if (defined('WP_DEBUG') && WP_DEBUG && defined('WP_DEBUG_LOG') && WP_DEBUG_LOG) {
            error_log('[Zadex forms] ' . $provider . ': ' . $message); // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log -- only with WP_DEBUG + WP_DEBUG_LOG on, so site owners can debug failing integrations.
        }
    }

    /** @return array<int, array{provider: string, message: string, context: array<string, mixed>}> */
    public static function entries(): array
    {
        return self::$entries;
    }

    public static function clear(): void
    {
        self::$entries = [];
    }
}