<?php

declare(strict_types=1);

namespace Sentinelo\Core;

/**
 * Ce que l'edition wordpress.org fait autrement — et rien d'autre.
 *
 * La relecture du repertoire a exige quelques comportements que l'edition privee
 * n'adopte pas, parce qu'ils retirent une capacite que les agences utilisent ou
 * qu'ils rendent une panne reseau plus couteuse. Chaque ecart passe par une methode
 * nommee ici, jamais par un test de constante disperse : c'est la liste exhaustive
 * de ce qui differe, et une relecture la lit en un endroit.
 *
 * L'emplacement des fichiers de l'agent depend aussi de l'edition, mais il vit dans
 * les constantes ({@see SENTINELO_STORAGE_DIR}) : il doit etre connu avant que
 * l'autoloader ne soit charge.
 */
final class Edition
{
    public const PRIVATE = 'private';
    public const WPORG = 'wporg';

    public static function current(): string
    {
        return defined('SENTINELO_EDITION') && SENTINELO_EDITION === self::WPORG ? self::WPORG : self::PRIVATE;
    }

    public static function isWordPressOrg(): bool
    {
        return self::current() === self::WPORG;
    }

    /**
     * Les reglages de mise a jour automatique appartiennent a l'outil de mise a jour
     * de WordPress : sur wordpress.org, ils se changent dans wp-admin, pas a distance.
     */
    public static function canWriteAutoUpdateSettings(): bool
    {
        return !self::isWordPressOrg();
    }

    /**
     * Edition privee : on force le prochain controle en remettant `last_checked` a
     * zero, sans effacer ce qui est connu — si api.wordpress.org ne repond pas a cet
     * instant, les mises a jour deja annoncees survivent.
     *
     * Edition wordpress.org : l'agent ne redige jamais les transients du coeur ; il
     * les vide comme WordPress le fait apres une installation et les laisse
     * reconstruire. Contrepartie : une panne reseau a cet instant vide la liste
     * jusqu'au controle suivant.
     */
    public static function editsCoreUpdateTransients(): bool
    {
        return !self::isWordPressOrg();
    }

    /**
     * Edition privee : `Plugin_Upgrader::upgrade()` puis reactivation explicite si la
     * mise a jour a laisse l'extension desactivee (meme chose pour le theme actif).
     *
     * Edition wordpress.org : `bulk_upgrade()`, comme `wp_ajax_update_plugin()` du
     * coeur — l'extension n'est jamais desactivee, donc l'agent n'a rien a reactiver
     * et ne change jamais de theme.
     */
    public static function reactivatesAfterUpdate(): bool
    {
        return !self::isWordPressOrg();
    }

    /**
     * Durcissement « interdire l'editeur de fichiers » : l'edition privee pose aussi
     * `DISALLOW_FILE_EDIT` ; l'edition wordpress.org ne definit aucune constante du
     * coeur et se limite au filtre des trois capacites.
     */
    public static function definesCoreConstants(): bool
    {
        return !self::isWordPressOrg();
    }

    /**
     * Le lien de connexion a usage unique vers wp-admin (`sso/token`). Retire de
     * l'edition wordpress.org a la relecture : la route n'y est pas enregistree, et
     * `build.sh --wporg` retire aussi les deux fichiers de l'archive.
     */
    public static function offersOneClickLogin(): bool
    {
        return !self::isWordPressOrg();
    }

    /**
     * wordpress.org charge lui-meme les traductions d'une extension du repertoire
     * (WordPress >= 4.6) ; l'edition privee les charge depuis languages/.
     */
    public static function loadsOwnTextDomain(): bool
    {
        return !self::isWordPressOrg();
    }
}