<?php
/**
 * Storage for the indexing job's state.
 *
 * @package Postlinkly
 * @since   1.14.0
 */

declare(strict_types=1);

namespace Postlinkly\Indexing;

/**
 * Reads and writes the single indexing job record.
 *
 * Stored as a non-autoloaded option rather than a transient: the job runs for
 * minutes or hours across many requests, and a transient on a site with a
 * persistent object cache can be evicted under memory pressure or dropped by
 * any plugin calling a cache flush — losing the job's own bookkeeping mid-run
 * and leaving it with no way to tell where it had got to.
 *
 * @since 1.14.0
 */
final class JobStateRepository {

	/**
	 * Option holding the job record.
	 */
	public const OPTION = 'postlinkly_index_job';

	/**
	 * Returns the stored job, or null when there is none to trust.
	 *
	 * @since 1.14.0
	 */
	public function load(): ?JobState {
		return JobState::from_array( get_option( self::OPTION, null ) );
	}

	/**
	 * Writes the job record.
	 *
	 * @since 1.14.0
	 *
	 * @param JobState $state State to persist.
	 *
	 * @return void
	 */
	public function save( JobState $state ): void {
		update_option( self::OPTION, $state->to_array(), false );
	}

	/**
	 * Removes the job record entirely.
	 *
	 * @since 1.14.0
	 *
	 * @return void
	 */
	public function delete(): void {
		delete_option( self::OPTION );
	}
}