<?php

declare(strict_types=1);

namespace Finanzmanager\Services;

use Psr\Log\AbstractLogger;
use Stringable;

/**
 * Leitet die Meldungen der FinTS-Bibliothek in das Debug-Log der Anwendung.
 *
 * php-fints erwartet einen PSR-3-Logger; die Anwendung hat mit `DebugLog` einen
 * eigenen, schlichteren. Dieser Adapter ist die Naht dazwischen: Er schreibt
 * unter der Kategorie `fints` und nur, wenn das Debug-Log überhaupt
 * eingeschaltet ist – ein FinTS-Dialog erzeugt sonst mehrere hundert Zeilen je
 * Abruf.
 *
 * Die Bibliothek maskiert PIN und TAN bereits selbst (`SanitizingLogger`),
 * `DebugLog` tut dasselbe noch einmal für den Kontext.
 */
class DebugLogAdapter extends AbstractLogger
{
    /**
     * @param mixed $level
     * @param array<string,mixed> $context
     */
    public function log($level, string|Stringable $message, array $context = []): void
    {
        if (!DebugLog::aktiv()) {
            return;
        }

        DebugLog::schreibe(
            'fints',
            '[' . (is_scalar($level) ? (string)$level : 'info') . '] ' . (string)$message,
            $context
        );
    }
}