<?php

/**
 * WpCafe Get Top Sales Tool
 *
 * @package Aisentic\Integrations\WpCafe
 */

declare(strict_types=1);

namespace Aisentic\Integrations\WpCafe;

use NeuronAI\Tools\ToolProperty;
use NeuronAI\Tools\PropertyType;
use Aisentic\Integrations\WpCafe\Wpcafe_Base_Tool;
use Aisentic\Util\Log;

defined( 'ABSPATH' ) || exit;

/**
 * Tool to get WpCafe top-selling menu items.
 * Returns the best-selling products ranked by quantity sold for the given period.
 */
class Wpcafe_Get_Top_Sales_Tool extends Wpcafe_Base_Tool {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'wpcafe-get-top-sales',
			'Get or retrieve WpCafe top-selling menu items, best sellers, or top sales data.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'per_page',
				type: PropertyType::NUMBER,
				description: 'Number of top products to return. Default: 10, maximum: 25.',
				required: false
			),
			new ToolProperty(
				name: 'period',
				type: PropertyType::STRING,
				description: 'Time period for sales data. Accepted values: week, month, year. Default: month.',
				required: false
			),
			new ToolProperty(
				name: 'branch',
				type: PropertyType::STRING,
				description: 'Branch/location filter. Pass a location term ID or "all" for all branches.',
				required: false
			),
		];
	}

	/**
	 * Execute the tool
	 *
	 * @param int|null    $per_page Number of top products.
	 * @param string|null $period   Time period (week, month, year).
	 * @param string|null $branch   Branch/location filter.
	 * @return array
	 */
	public function __invoke(
		?int $per_page = 10,
		?string $period = 'month',
		?string $branch = null
	): array {
		$check = $this->guard( 'manage_woocommerce', 'manage_options' );
		if ( $check ) {
			return $check;
		}

		$valid_periods = [ 'week', 'month', 'year' ];
		if ( ! empty( $period ) && ! in_array( $period, $valid_periods, true ) ) {
			return [ 'error' => "Invalid period '{$period}'. Accepted values: week, month, year." ];
		}

		try {
			$params = [
				'per_page' => min( 25, max( 1, (int) ( $per_page ?? 10 ) ) ),
				'period'   => $period ?? 'month',
			];

			if ( ! empty( $branch ) ) {
				$params['branch'] = sanitize_text_field( $branch );
			}

			$request = new \WP_REST_Request( 'GET', '/wpcafe/v2/dashboard/top-sales' );
			$request->set_query_params( $params );

			$controller = new \WpCafe\Dashboard\Controllers\Dashboard_Controller();

			$data = $this->extract_response( $controller->get_top_sales( $request ), 'Failed to retrieve top sales data.' );
			if ( isset( $data['error'] ) ) {
				return $data;
			}

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

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