<?php
/**
 * Sitemap coverage: do the published posts of the public post types and the
 * post URLs in the sitemap add up?
 *
 * The published count comes from wp_count_posts(), NOT from WP_Query or
 * get_posts(): multilingual plugins filter those to the current language, so
 * a count built on them would silently share the blind spot this check
 * exists to expose. wp_count_posts() reads the posts table directly.
 *
 * BOUNDARY: this detects THAT the two numbers differ, never WHY. Posts are
 * legitimately absent from the sitemap for many reasons (a content type or
 * one post switched to noindex or "exclude from sitemap", a multilingual
 * plugin narrowing the query, a hook filtering the list), and this class
 * cannot tell them apart. The wording built on it must not name a cause or a
 * third-party plugin. No gap means no result at all, not a reassuring row.
 *
 * Pure: the WordPress calls live in published_count(), the comparison in
 * gap().
 *
 * @package ABDS_SEO
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Compares published posts with post URLs in the sitemap.
 */
class ABDS_SEO_Sitemap_Coverage {

	/**
	 * The gap, if there is one.
	 *
	 * @param int $published  Published posts across the public post types.
	 * @param int $in_sitemap Post URLs in the sitemap.
	 * @return array{published:int,in_sitemap:int,missing:int}|null Null when everything published is in the sitemap.
	 */
	public static function gap( int $published, int $in_sitemap ): ?array {
		if ( $published <= $in_sitemap ) {
			return null;
		}

		return array(
			'published'  => $published,
			'in_sitemap' => $in_sitemap,
			'missing'    => $published - $in_sitemap,
		);
	}

	/**
	 * Published posts across every public post type, counted straight from
	 * the posts table via wp_count_posts().
	 *
	 * @return int
	 */
	public static function published_count(): int {
		$total = 0;

		foreach ( array_keys( ABDS_SEO_Taxonomy_Helper::public_post_types() ) as $post_type ) {
			$counts = wp_count_posts( $post_type );
			$total += isset( $counts->publish ) ? (int) $counts->publish : 0;
		}

		return $total;
	}
}