<?php
/**
 * Eventin Count Events Tool
 *
 * @package Aisentic\Integrations\Eventin
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Eventin;

use Aisentic\Contracts\Read_Only_Tool_Contract;
use Aisentic\Util\Log;

defined( 'ABSPATH' ) || exit;

/**
 * How many events there are: all, upcoming, ongoing, past and draft.
 *
 * One call answers all these counts.
 * Why: before, the model counted rows from eventin-list-events, which stops at 50.
 */
class Eventin_Count_Events_Tool extends Eventin_Stats_Base_Tool implements Read_Only_Tool_Contract {

	/**
	 * Constructor.
	 *
	 * @param Eventin_Stats_Query|null $query Count queries; tests pass a fake.
	 */
	public function __construct( ?Eventin_Stats_Query $query = null ) {
		parent::__construct(
			'eventin-count-events',
			'Count Eventin events in one call: all, published, upcoming, ongoing, past (also called expired or ended) and draft. Use for any "how many events" question instead of counting the rows of eventin-list-events, which stops at 50. Several questions at once, such as how many events, how many upcoming and how many expired, need only ONE call. Every result has a status: "ok" means say the numbers from it; "needs_clarification" means ask the question it gives and never pick for them; "not_found" or "not_available" means say plainly you cannot see it and open the page in the result. Never assume a missing event or date range; "this month" and "last week" are fine, worked out from today. To open a page, use the page url in the result.',
			$query
		);
	}

	/**
	 * Define tool properties.
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [];
	}

	/**
	 * Execute the tool.
	 *
	 * @return array
	 */
	public function __invoke(): array {
		return $this->answer();
	}

	/**
	 * Work out the answer.
	 *
	 * @return array
	 */
	private function answer(): array {
		$check = $this->guard( 'etn_manage_event' );
		if ( $check ) {
			return $check;
		}

		try {
			$counts = $this->query->count_events();

			return [
				'status'      => 'ok',
				'counts'      => $counts,
				'today'       => current_time( 'Y-m-d' ),
				'definitions' => [
					'all'       => 'Every event that is not in the trash, drafts included.',
					'published' => 'Live events.',
					'upcoming'  => 'Published, starting today or later.',
					'ongoing'   => 'Published, started on or before today and ending today or later.',
					'past'      => 'Published, ended before today. This is what people mean by expired.',
					'no_date'   => 'Published, but no start date is set, so it is in none of the groups above.',
					'draft'     => 'Saved but not published.',
				],
				'page'        => $this->page( __( 'Events', 'aisentic' ), '/events' ),
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Eventin_Count_Events_Tool error', [ 'error' => $e->getMessage() ] );

			return [ 'error' => 'Could not count events: ' . $e->getMessage() ];
		}
	}
}