<?php

/**
 * Timetics Get Reports Tool
 *
 * @package Aisentic\Integrations\Timetics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Timetics;

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

defined( 'ABSPATH' ) || exit;

/**
 * Tool to get a Timetics reports overview for a date range. Administrator only.
 *
 * Returns headline metrics — total bookings, total earnings, and new customers —
 * and optionally a per-day breakdown of completed vs cancelled bookings.
 */
class Timetics_Get_Reports_Tool extends Timetics_Base_Tool {

	/**
	 * Metrics the reports endpoint understands.
	 */
	private const METRICS = [ 'total_booking', 'total_earning', 'total_customer', 'booking_reports' ];

	/**
	 * Default headline metrics when none are requested.
	 */
	private const DEFAULT_METRICS = [ 'total_booking', 'total_earning', 'total_customer' ];

	public function __construct() {
		parent::__construct(
			'timetics-get-reports-overview',
			'Get a Timetics reports overview for a date range: total bookings, total earnings, and number of ' .
			'customers. Optionally include a per-day breakdown of completed vs cancelled bookings. Use this for ' .
			'questions like "how many bookings and how much revenue did we have last month".'
		);
	}

	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'start_date',
				type: PropertyType::STRING,
				description: 'Start of the reporting range (YYYY-MM-DD).',
				required: true
			),
			new ToolProperty(
				name: 'end_date',
				type: PropertyType::STRING,
				description: 'End of the reporting range (YYYY-MM-DD).',
				required: true
			),
			new ToolProperty(
				name: 'metrics',
				type: PropertyType::ARRAY,
				description: 'Which metrics to return: any of total_booking, total_earning, total_customer, '
					. 'booking_reports (per-day breakdown). Defaults to the three headline totals.',
				required: false
			),
		];
	}

	public function __invoke( string $start_date, string $end_date, ?array $metrics = null ): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		$start_date = trim( $start_date );
		$end_date   = trim( $end_date );
		if ( '' === $start_date || '' === $end_date ) {
			return [ 'error' => 'Both start_date and end_date are required (YYYY-MM-DD).' ];
		}

		$requested = $this->resolve_metrics( $metrics );
		if ( empty( $requested ) ) {
			return [ 'error' => 'No valid metrics requested. Accepted: ' . implode( ', ', self::METRICS ) . '.' ];
		}

		try {
			$body = [];
			foreach ( $requested as $metric ) {
				$body[] = [
					'report'     => $metric,
					'start_date' => sanitize_text_field( $start_date ),
					'end_date'   => sanitize_text_field( $end_date ),
				];
			}

			$request = $this->build_request( 'POST', '/timetics/v1/reports/overview', [], $body );
			if ( is_array( $request ) ) {
				return $request;
			}

			$controller = \Timetics\Core\Reports\Api_Report::instance();
			$data       = $this->extract_response( $controller->get_overview( $request ), 'Failed to get reports overview.' );

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

			return [
				'start_date' => $start_date,
				'end_date'   => $end_date,
				'reports'    => $data,
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Timetics_Get_Reports_Tool error', [ 'error' => $e->getMessage() ] );
			return [ 'error' => 'Failed to get reports overview: ' . $e->getMessage() ];
		}
	}

	private function resolve_metrics( ?array $metrics ): array {
		if ( null === $metrics || [] === $metrics ) {
			return self::DEFAULT_METRICS;
		}

		return array_values( array_intersect( self::METRICS, array_map( 'strval', $metrics ) ) );
	}
}