<?php

/**
 * Timetics List Bookings 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 list Timetics bookings. Administrator only.
 *
 * Optionally scopes the list to a single meeting and/or a start date onward, so
 * the assistant can answer questions like "who is booked into the consultation
 * this week".
 */
class Timetics_List_Bookings_Tool extends Timetics_Base_Tool {

	public function __construct() {
		parent::__construct(
			'timetics-list-bookings',
			'List Timetics bookings (appointments customers have booked). Returns each booking\'s id, status, ' .
			'date/time, customer, meeting, and assigned staff. Optionally filter by meeting_id or by a ' .
			'start_date onward. Use timetics-search-bookings to find a booking by customer name or email.'
		);
	}

	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'per_page',
				type: PropertyType::NUMBER,
				description: 'Number of bookings per page. Default: 20, maximum: 50.',
				required: false
			),
			new ToolProperty(
				name: 'paged',
				type: PropertyType::NUMBER,
				description: 'Page number to retrieve. Default: 1.',
				required: false
			),
			new ToolProperty(
				name: 'meeting_id',
				type: PropertyType::NUMBER,
				description: 'Only return bookings for this meeting (appointment) ID. Omit for all meetings.',
				required: false
			),
			new ToolProperty(
				name: 'start_date',
				type: PropertyType::STRING,
				description: 'Only return bookings on or after this date (YYYY-MM-DD). Omit for all dates.',
				required: false
			),
		];
	}

	public function __invoke( ?int $per_page = 20, ?int $paged = 1, ?int $meeting_id = null, ?string $start_date = null ): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		try {
			$query = $this->clamp_pagination( $per_page, $paged );
			if ( null !== $meeting_id && $meeting_id > 0 ) {
				$query['meeting_id'] = $meeting_id;
			}
			if ( null !== $start_date && '' !== trim( $start_date ) ) {
				$query['start_date'] = sanitize_text_field( $start_date );
			}

			$request = $this->build_request( 'GET', '/timetics/v1/bookings', $query );
			if ( is_array( $request ) ) {
				return $request;
			}

			$controller = \Timetics\Core\Bookings\Api_Booking::instance();
			$data       = $this->extract_response( $controller->get_items( $request ), 'Failed to list bookings.' );

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

			$items = $this->list_items( $data );

			return [
				'total'    => $data['total'] ?? count( $items ),
				'per_page' => $query['per_page'],
				'paged'    => $query['paged'],
				'bookings' => $this->shape_rows( $items, fn( $item ) => $this->shape_booking( $item ) ),
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Timetics_List_Bookings_Tool error', [ 'error' => $e->getMessage() ] );
			return [ 'error' => 'Failed to list bookings: ' . $e->getMessage() ];
		}
	}
}