<?php

/**
 * WpCafe List Locations 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 list WpCafe restaurant locations/branches.
 * Call this to find branch IDs needed when filtering reservations or creating a new location.
 */
class Wpcafe_List_Locations_Tool extends Wpcafe_Base_Tool {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'wpcafe-list-locations',
			'List, browse, or retrieve WpCafe restaurant locations or branches. Use to find branch IDs needed when creating reservations.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'per_page',
				type: PropertyType::NUMBER,
				description: 'Number of locations per page. Default: 20, maximum: 50.',
				required: false
			),
			new ToolProperty(
				name: 'paged',
				type: PropertyType::NUMBER,
				description: 'Page number. Default: 1.',
				required: false
			),
			new ToolProperty(
				name: 'search',
				type: PropertyType::STRING,
				description: 'Filter locations by name.',
				required: false
			),
		];
	}

	/**
	 * Execute the tool
	 *
	 * @param int|null    $per_page Items per page.
	 * @param int|null    $paged    Page number.
	 * @param string|null $search   Name search term.
	 * @return array
	 */
	public function __invoke(
		?int $per_page = 20,
		?int $paged = 1,
		?string $search = null
	): array {
		$check = $this->guard( 'manage_options', 'manage_woocommerce' );
		if ( $check ) {
			return $check;
		}

		try {
			$params = [
				'per_page' => min( 50, max( 1, (int) ( $per_page ?? 20 ) ) ),
				'paged'    => max( 1, (int) ( $paged ?? 1 ) ),
			];

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

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

			$controller = new \WpCafe\Location\Controllers\Location_Controller();
			$result     = $this->extract_response( $controller->get_items( $request ), 'Failed to retrieve locations.' );

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

			$shaped = $this->shape_paginated(
				$result,
				fn( $location ) => [
					'id'                        => $location['term_id'] ?? null,
					'restaurant_name'           => $location['restaurant_name'] ?? '',
					'location'                  => $location['location'] ?? '',
					'status'                    => $location['status'] ?? '',
					'enable_pickup'             => $location['enable_pickup'] ?? '',
					'enable_delivery'           => $location['enable_delivery'] ?? '',
					'enable_reservation'        => $location['enable_reservation'] ?? '',
					'delivery_fee'              => $location['delivery_fee'] ?? 0,
					'reservation_minimum_guest' => $location['reservation_minimum_guest'] ?? 0,
					'reservation_maximum_guest' => $location['reservation_maximum_guest'] ?? 0,
				]
			);

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

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