<?php
/**
 * Readers for data the Pro modules write.
 *
 * Writing an FAQ or running a link scan is Pro work. Reading what was already
 * written is not, and free screens legitimately need it: the page report shows
 * an existing FAQ, the auditor counts broken links from the last scan. Keeping
 * these readers here means the free edition — which ships without the Pro
 * module folders entirely — can read that data without referencing a class
 * that is not there.
 *
 * @package AiRankSuite
 */

declare(strict_types=1);

namespace AiRankSuite\Support;

defined( 'ABSPATH' ) || exit;

final class StoredReads {

	/** Where the link scanner records its last completed run. */
	private const LINKSCAN_LAST = 'airanksuite_linkscan_last';
	private const LINKSCAN_JOB  = 'airanksuite_linkscan_job';

	/**
	 * The FAQ pairs stored on a post, or an empty list.
	 *
	 * @return array<int, array<string, string>>
	 */
	public static function faq_items( int $post_id ): array {
		$raw = get_post_meta( $post_id, '_airanksuite_faq', true );
		if ( ! is_string( $raw ) || '' === $raw ) {
			return array();
		}
		$decoded = json_decode( $raw, true );
		return is_array( $decoded ) ? $decoded : array();
	}

	/** The run id of the last completed link scan, or null when none finished. */
	public static function linkscan_run_id(): ?string {
		$last = get_option( self::LINKSCAN_LAST );
		if ( is_array( $last ) && isset( $last['run_id'] ) ) {
			return (string) $last['run_id'];
		}
		$job = get_option( self::LINKSCAN_JOB );
		if ( is_array( $job ) && 'done' === ( $job['state'] ?? '' ) && isset( $job['run_id'] ) ) {
			return (string) $job['run_id'];
		}
		return null;
	}

	/**
	 * The two values that limit a link query to the published scan.
	 *
	 * The caller writes the scope into its own statement as a literal —
	 * `( %d = 1 AND run_id = %s )` — and binds this pair to it. With no
	 * completed scan the flag is 0 and the scope matches no rows rather than
	 * every row, because a half-finished scan must never be read as the
	 * site's state.
	 *
	 * @return array{0: int, 1: string}
	 */
	public static function linkscan_scope(): array {
		$run = self::linkscan_run_id();
		return array( null === $run ? 0 : 1, (string) $run );
	}

}