<?php
/**
 * Sign-in housekeeping.
 *
 * @package Rahkar\WP
 */

declare( strict_types = 1 );

namespace Rahkar\WP\Modules\OtpAuth;

use Rahkar\WP\Plugin;
use Rahkar\WP\Queue\Queue;
use Rahkar\WP\Support\Hooks;
use Rahkar\WP\Support\Logger;

defined( 'ABSPATH' ) || exit;

/**
 * Clears out lapsed codes, spent rate-limit counters and old log rows.
 *
 * Runs on the plugin's own queue, never on a visitor's request, and re-arms
 * itself. It is armed whenever a code is issued and whenever the monitoring
 * screen is opened: a queue row can be lost to a restore from backup, and a
 * cleanup that has silently stopped is how a codes table reaches a million rows.
 */
final class Housekeeping {

	/**
	 * Queue hook.
	 */
	public const JOB_HOOK = Hooks::OTP_CLEANUP;

	/**
	 * Time between runs.
	 */
	private const INTERVAL = 6 * HOUR_IN_SECONDS;

	/**
	 * Ensure the next run is queued. Idempotent.
	 */
	public static function schedule(): void {
		Queue::pushUnique( self::JOB_HOOK, [], 'otp:cleanup', self::INTERVAL );
	}

	/**
	 * Do the work and re-arm.
	 *
	 * @internal Queue handler.
	 */
	public static function run(): void {
		$codes = Plugin::make( OtpService::class )->purgeExpired();
		$rates = RateLimiter::purgeExpired();
		$log   = OtpLog::purge();

		if ( $codes + $rates + $log > 0 ) {
			Logger::info(
				'otp',
				'Sign-in housekeeping removed old rows.',
				[
					'codes' => $codes,
					'rates' => $rates,
					'log'   => $log,
				]
			);
		}

		self::schedule();
	}
}