<?php

/**
 * Booktics Get Dashboard Summary Tool
 *
 * @package Aisentic\Integrations\Booktics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Booktics;

use NeuronAI\Tools\ToolProperty;
use NeuronAI\Tools\PropertyType;
use Aisentic\Util\Log;

defined( 'ABSPATH' ) || exit;

/**
 * Tool to read Booktics dashboard statistics for a date range.
 *
 * Administrator only. Returns booking, revenue, and customer totals (with the
 * change vs the previous equal-length period) and, optionally, a per-day
 * completed/cancelled breakdown. These are business-wide figures, so the tool is
 * restricted to administrators rather than individual team members.
 */
class Booktics_Get_Dashboard_Summary_Tool extends Booktics_Base_Tool {

	/**
	 * Default look-back window, in days.
	 */
	private const DEFAULT_DAYS = 30;

	/**
	 * Maximum span (in days) for an aggregate-only query.
	 */
	private const MAX_RANGE_DAYS = 180;

	/**
	 * Maximum span (in days) when a per-day breakdown is requested — a per-day
	 * report over a huge range returns one row per day and blows up token usage.
	 */
	private const MAX_RANGE_DAYS_WITH_DAILY = 92;

	/**
	 * Hard cap on the number of per-day rows ever returned.
	 */
	private const MAX_DAILY_ROWS = 92;

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-get-dashboard-summary',
			'Get Booktics dashboard statistics for a date range: total bookings, total revenue, and total customers, each with the percentage change vs the previous period. ' .
			'Optionally include a per-day completed/cancelled breakdown. Defaults to the last 30 days. Business-wide figures; administrator only.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'start_date',
				type: PropertyType::STRING,
				description: 'Start of the range in Y-m-d format. Defaults to 30 days ago.',
				required: false
			),
			new ToolProperty(
				name: 'end_date',
				type: PropertyType::STRING,
				description: 'End of the range in Y-m-d format. Defaults to today.',
				required: false
			),
			new ToolProperty(
				name: 'include_daily_breakdown',
				type: PropertyType::BOOLEAN,
				description: 'Include a per-day completed vs cancelled bookings report. Default: false.',
				required: false
			),
		];
	}

	/**
	 * Execute the tool
	 *
	 * @param string|null $start_date              Range start (Y-m-d).
	 * @param string|null $end_date                Range end (Y-m-d).
	 * @param bool|null   $include_daily_breakdown Include the per-day report.
	 * @return array
	 */
	public function __invoke(
		?string $start_date = null,
		?string $end_date = null,
		?bool $include_daily_breakdown = null
	): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		$end_date   = ! empty( $end_date ) ? $end_date : current_time( 'Y-m-d' );
		$start_date = ! empty( $start_date )
			? $start_date
			: gmdate( 'Y-m-d', strtotime( $end_date . ' -' . self::DEFAULT_DAYS . ' days' ) );

		if ( ! $this->is_valid_date( $start_date ) || ! $this->is_valid_date( $end_date ) ) {
			return [ 'error' => 'start_date and end_date must be in Y-m-d format.' ];
		}
		if ( $start_date > $end_date ) {
			return [ 'error' => 'start_date must be on or before end_date.' ];
		}

		// Clamp the span: unbounded ranges flood the model with rows.
		$span_days = (int) floor( ( strtotime( $end_date ) - strtotime( $start_date ) ) / DAY_IN_SECONDS ) + 1;
		$max_days  = true === $include_daily_breakdown ? self::MAX_RANGE_DAYS_WITH_DAILY : self::MAX_RANGE_DAYS;
		if ( $span_days > $max_days ) {
			return [
				'error' => sprintf(
					'Date range of %d days is too large; the maximum is %d days%s. Narrow start_date/end_date.',
					$span_days,
					$max_days,
					true === $include_daily_breakdown ? ' when include_daily_breakdown is true' : ''
				),
			];
		}

		try {
			$range = [
				'start_date' => $start_date,
				'end_date'   => $end_date,
			];

			$request = new \WP_REST_Request( 'GET', '/booktics/v1/dashboard' );
			$request->set_param( 'total_bookings', $range );
			$request->set_param( 'total_revenue', $range );
			$request->set_param( 'total_customers', $range );
			if ( true === $include_daily_breakdown ) {
				$request->set_param( 'booking_reports', $range );
			}

			$controller = new \Booktics\Dashboard\Controllers\Dashboard_Controller();
			$data       = $this->extract_response( $controller->get_dashboard_data( $request ), 'Failed to retrieve dashboard statistics.' );

			if ( isset( $data['error'] ) ) {
				return $data;
			}

			$response = [
				'date_range' => $range,
				'summary'    => $data,
			];

			// Defence-in-depth on top of the span clamp: cap per-day rows too.
			if ( isset( $data['booking_reports'] ) && is_array( $data['booking_reports'] ) ) {
				$reports = array_values( $data['booking_reports'] );
				if ( count( $reports ) > self::MAX_DAILY_ROWS ) {
					$response['summary']['booking_reports'] = array_slice( $reports, 0, self::MAX_DAILY_ROWS );
					$response['note']                       = sprintf(
						'Daily breakdown truncated to the first %d of %d days; narrow the date range to see the rest.',
						self::MAX_DAILY_ROWS,
						count( $reports )
					);
				}
			}

			return $response;
		} catch ( \Throwable $e ) {
			Log::error( 'Booktics_Get_Dashboard_Summary_Tool error', [ 'error' => $e->getMessage() ] );

			return [ 'error' => 'Failed to retrieve dashboard statistics: ' . $e->getMessage() ];
		}
	}
}