<?php
/**
 * Expire soft holds — scheduled job stub (Action Scheduler in Milestone 8).
 *
 * @package Bookline
 */

declare( strict_types=1 );

namespace Bookline\Application\Booking;

use Bookline\Domain\Booking\BookingRepository;
use Bookline\Domain\Shared\Clock;

/**
 * Finds expired holds and releases them. Safe to call every minute.
 *
 * @since 0.1.0
 */
final class ExpireHoldsJob {

	/**
	 * Constructor.
	 *
	 * @param BookingRepository  $bookings Booking port.
	 * @param ReleaseHoldHandler $release  Release handler.
	 * @param Clock              $clock    Clock.
	 */
	public function __construct(
		private readonly BookingRepository $bookings,
		private readonly ReleaseHoldHandler $release,
		private readonly Clock $clock,
	) {}

	/**
	 * Release every expired hold up to $limit.
	 *
	 * @param int $limit Max holds to release this run.
	 * @return int Number released.
	 *
	 * @since 0.1.0
	 */
	public function run( int $limit = 100 ): int {
		$now     = $this->clock->now();
		$expired = $this->bookings->find_expired_holds( $now, $limit );
		$count   = 0;
		foreach ( $expired as $booking ) {
			$id = $booking->id();
			if ( null === $id ) {
				continue;
			}
			$this->release->handle( $id, 'expired' );
			++$count;
		}
		return $count;
	}
}