<?php
/**
 * Ledger retention cron.
 *
 * @package AgentFirewall
 */

declare(strict_types=1);

namespace AgentFirewall\Ledger;

defined( 'ABSPATH' ) || exit;

/**
 * Daily WP-Cron sweep applying the ledger retention window.
 *
 * Daily rather than hourly: retention is housekeeping measured in days, and
 * each pass deletes in bounded batches, so a site returning from a long
 * absence trims over several days instead of attempting one enormous delete.
 */
final class RetentionCron {

	/**
	 * Cron hook name.
	 */
	public const HOOK = 'adaf_prune_ledger';

	/**
	 * Constructor.
	 *
	 * @param RetentionService $service Retention service.
	 */
	public function __construct( private readonly RetentionService $service ) {
	}

	/**
	 * Schedule the sweep and hook the runner.
	 */
	public function register(): void {
		if ( false === wp_next_scheduled( self::HOOK ) ) {
			wp_schedule_event( time(), 'daily', self::HOOK );
		}

		add_action( self::HOOK, array( $this, 'run' ) );
	}

	/**
	 * Run one sweep. Does nothing while retention is off.
	 */
	public function run(): void {
		$this->service->prune();
	}

	/**
	 * Unschedule the sweep (deactivation).
	 */
	public static function unschedule(): void {
		wp_clear_scheduled_hook( self::HOOK );
	}
}