<?php

declare(strict_types=1);

namespace Sentinelo\Backup;

use Sentinelo\Adapter\Wp\WpConfigStore;
use Sentinelo\Adapter\Wp\WpCrypto;
use Sentinelo\Adapter\Wp\WpFileSystem;
use Sentinelo\Adapter\Wp\WpLogger;
use Sentinelo\AgentCore\Backup\SettingsPreservation;

/**
 * Câblage WordPress de {@see SettingsPreservation}.
 *
 * Ici, nos réglages sont des options préfixées `SENTINELO_` dans la table des options du
 * site — une table du CLIENT, que la sauvegarde emporte à juste titre et que l'import
 * `DROP`/`CREATE` remet dans son état d'hier. Sans cette préservation, une restauration
 * rembobine la clé d'API et les identifiants de stockage : elle déconnecte le site
 * qu'elle est censée réparer.
 *
 * Le journal vit dans le répertoire temporaire de l'agent et non dans celui de la
 * restauration en cours : ce dernier est effacé sur TOUTES les sorties, y compris
 * l'échec, c'est-à-dire exactement le cas où le journal doit survivre. Il échappe aussi
 * au ramassage des orphelins, qui ne juge que des répertoires.
 */
final class AttachmentJournal
{
    /**
     * Nom du journal. Le point de tête et l'extension `.enc` disent tous deux ce que
     * c'est : un fichier de service, chiffré. Son contenu porte la clé d'API du site.
     */
    private const FILENAME = '.sentinelo-attachment.enc';

    private function __construct()
    {
    }

    public static function build(): SettingsPreservation
    {
        return new SettingsPreservation(
            new WpConfigStore(),
            new WpCrypto(),
            new WpLogger(),
            rtrim((new WpFileSystem())->tempPath(), '/') . '/' . self::FILENAME,
        );
    }

    /**
     * Rejoue un journal laissé par un import qui n'est jamais revenu.
     *
     * Branché sur le démarrage de l'extension, donc sur CHAQUE requête WordPress : c'est
     * le seul chemin qui tourne encore sur un site dont l'agent vient de perdre sa clé,
     * puisque la plateforme, elle, ne peut plus l'appeler. Le cas ordinaire est un
     * `is_file()` sur un fichier absent.
     *
     * Ne lève jamais : un site ne doit pas rendre 500 parce qu'une reprise de
     * rattachement s'est mal passée.
     */
    public static function recoverQuietly(): void
    {
        try {
            self::build()->recover();
        } catch (\Throwable $e) {
            \Sentinelo\Core\Logger::error('restore', 'Reprise du rattachement impossible : ' . $e->getMessage());
        }
    }
}