<?php

/**
 * Booktics Get Appointment 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 retrieve a single Booktics appointment by ID.
 *
 * Administrators may view any appointment. Team members may only view an
 * appointment assigned to them.
 */
class Booktics_Get_Appointment_Tool extends Booktics_Base_Tool {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-get-appointment',
			'Get the full details of one Booktics appointment (booking) by its ID, including customer contact, service, team member, timing, status, and notes. ' .
			'Use booktics-list-appointments to find the ID.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'appointment_id',
				type: PropertyType::NUMBER,
				description: 'The numeric ID of the appointment to retrieve.',
				required: true
			),
		];
	}

	/**
	 * Execute the tool
	 *
	 * @param int $appointment_id Appointment ID.
	 * @return array
	 */
	public function __invoke( int $appointment_id ): array {
		$check = $this->guard_staff();
		if ( $check ) {
			return $check;
		}

		// Confirms the appointment exists and (for team members) that it is theirs.
		$access = $this->assert_appointment_access( $appointment_id );
		if ( $access ) {
			return $access;
		}

		try {
			$request = new \WP_REST_Request( 'GET', '/booktics/v1/appointments/' . $appointment_id );
			$request->set_url_params( [ 'id' => $appointment_id ] );

			$controller  = new \Booktics\Appointment\Controllers\Appointment_Controller();
			$appointment = $this->extract_response( $controller->get_item( $request ), 'Failed to retrieve appointment.' );

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

			return $this->shape_appointment( $appointment, true );
		} catch ( \Throwable $e ) {
			Log::error( 'Booktics_Get_Appointment_Tool error', [ 'error' => $e->getMessage() ] );

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