<?php
declare(strict_types=1);

namespace ROITheme\Shared\Infrastructure\Hooks;

/**
 * Registra hooks para arquitectura cache-first.
 *
 * Permite que plugins externos evalúen condiciones ANTES de servir páginas,
 * sin bloquear el cache de WordPress.
 *
 * @see openspec/specs/cache-first-architecture/spec.md
 * @package ROITheme\Shared\Infrastructure\Hooks
 */
final class CacheFirstHooksRegistrar
{
    /**
     * Registra los hooks de cache-first.
     */
    public function register(): void
    {
        add_action('template_redirect', [$this, 'fireBeforePageServe'], 0);
    }

    /**
     * Dispara hook para que plugins externos evalúen acceso.
     *
     * Solo se dispara para:
     * - Páginas singulares (posts, pages, CPTs)
     * - Visitantes NO logueados (cache no aplica a usuarios logueados)
     *
     * Los plugins pueden llamar wp_safe_redirect() + exit para bloquear.
     * Si no hacen nada, la página se sirve normalmente (con cache si disponible).
     */
    public function fireBeforePageServe(): void
    {
        // No para usuarios logueados (cache no aplica, no tiene sentido evaluar)
        if (is_user_logged_in()) {
            return;
        }

        // Solo páginas singulares
        if (!is_singular()) {
            return;
        }

        // No en admin/ajax/cron/REST
        if (is_admin() || wp_doing_ajax() || wp_doing_cron()) {
            return;
        }

        if (defined('REST_REQUEST') && REST_REQUEST) {
            return;
        }

        $post_id = get_queried_object_id();

        if ($post_id > 0) {
            /**
             * Hook: roi_theme_before_page_serve
             *
             * Permite que plugins externos evalúen condiciones antes de servir página.
             *
             * Uso típico:
             * - Rate limiters (límite de vistas por IP)
             * - Membership plugins (verificar acceso)
             * - Geolocation restrictions
             *
             * Para bloquear acceso:
             *   wp_safe_redirect('/pagina-destino/', 302);
             *   exit;
             *
             * Para permitir acceso:
             *   return; // La página se servirá (con cache si disponible)
             *
             * @since 1.0.0
             * @param int $post_id ID del post/page que se va a servir
             */
            do_action('roi_theme_before_page_serve', $post_id);
        }
    }
}