<?php
/**
 * Action Scheduler job helpers.
 *
 * @package AdminPowerups
 */

namespace SmartWP\AdminPowerups\Support;

defined( 'ABSPATH' ) || exit;

/**
 * Pending-only job checks and "queue once" for our background jobs.
 *
 * Dedupe against pending actions only: as_has_scheduled_action() also counts the running job,
 * so a job that queues its own follow-up would never get one.
 *
 * @since 1.0.0
 */
final class Jobs {

	/**
	 * Action Scheduler group of every job the plugin schedules (WooCommerce → Status → Scheduled
	 * Actions). The one place the group name lives.
	 */
	const GROUP = 'apwc';

	/**
	 * Whether a job of this hook is waiting (a running one doesn't count).
	 *
	 * @since 1.0.0
	 * @param string $hook Hook.
	 * @return bool
	 */
	public static function pending( string $hook ): bool {
		if ( '' === $hook || ! function_exists( 'as_get_scheduled_actions' ) ) {
			return false;
		}
		return (bool) as_get_scheduled_actions(
			array(
				'hook'     => $hook,
				'status'   => \ActionScheduler_Store::STATUS_PENDING,
				'per_page' => 1,
			),
			'ids'
		);
	}

	/**
	 * Queue a single job (no arguments) unless one of this hook is already waiting.
	 *
	 * @since 1.0.0
	 * @param string $hook  Hook.
	 * @param int    $delay Seconds from now; 0 queues an async job (as soon as possible).
	 * @param string $group Action Scheduler group.
	 * @return bool Whether a job was queued.
	 */
	public static function queue_once( string $hook, int $delay, string $group ): bool {
		if ( '' === $hook || ! function_exists( 'as_schedule_single_action' ) || self::pending( $hook ) ) {
			return false;
		}
		$id = $delay > 0
			? as_schedule_single_action( time() + $delay, $hook, array(), $group )
			: as_enqueue_async_action( $hook, array(), $group );
		return (bool) $id;
	}
}