<?php
/**
 * Google Search Console API client.
 *
 * @package Tagsmith
 */

declare(strict_types=1);

namespace Tagsmith\Google;

defined( 'ABSPATH' ) || exit;

/**
 * Lists verified sites and runs Search Analytics queries.
 */
class SearchConsoleApi extends GoogleApi {

	/**
	 * Search Console API base URL.
	 *
	 * @var string
	 */
	private const BASE = 'https://searchconsole.googleapis.com/webmasters/v3';

	/**
	 * The sites the connected account has verified access to. Sites where
	 * the account is only an unverified user are excluded.
	 *
	 * @return array<int, array{site_url: string, permission: string}>
	 * @throws ApiError On failure.
	 */
	public function sites(): array {
		$response = $this->call( 'GET', self::BASE . '/sites' );
		$result   = array();

		foreach ( (array) ( $response['siteEntry'] ?? array() ) as $site ) {
			if ( ! is_array( $site ) ) {
				continue;
			}

			$permission = (string) ( $site['permissionLevel'] ?? '' );

			if ( 'siteUnverifiedUser' === $permission ) {
				continue;
			}

			$result[] = array(
				'site_url'   => (string) ( $site['siteUrl'] ?? '' ),
				'permission' => $permission,
			);
		}

		return $result;
	}

	/**
	 * Runs a Search Analytics query for a site.
	 *
	 * @param string               $site_url The site URL, e.g. 'sc-domain:example.com'.
	 * @param array<string, mixed> $body     SearchAnalyticsQueryRequest body.
	 * @return array<string, mixed> SearchAnalyticsQueryResponse.
	 * @throws ApiError On failure.
	 */
	public function query( string $site_url, array $body ): array {
		$url = self::BASE . '/sites/' . rawurlencode( $site_url ) . '/searchAnalytics/query';

		return $this->call( 'POST', $url, $body );
	}
}