<?php

/**
 * Booktics Reschedule Appointment Tool
 *
 * @package Aisentic\Integrations\Booktics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Booktics;

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

defined( 'ABSPATH' ) || exit;

/**
 * Tool to reschedule a Booktics appointment to a new date/time.
 *
 * Administrators may reschedule any appointment; team members may only
 * reschedule appointments assigned to them. Requires approval.
 *
 * This performs an admin-side move via the appointment update endpoint. It does
 * NOT use Booktics' customer-facing reschedule flow, which is gated on the
 * `allow_customer_rescheduling` setting and a per-booking security token — both
 * inappropriate for staff-initiated changes.
 */
class Booktics_Reschedule_Appointment_Tool extends Booktics_Base_Tool implements Approvable_Tool_Contract {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-reschedule-appointment',
			'Reschedule/move a Booktics appointment to a new date and time. ' .
			'Find the ID with booktics-list-appointments. Requires approval.'
		);
	}

	/**
	 * 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 reschedule.',
				required: true
			),
			new ToolProperty(
				name: 'date',
				type: PropertyType::STRING,
				description: 'New date in Y-m-d format.',
				required: true
			),
			new ToolProperty(
				name: 'start_time',
				type: PropertyType::STRING,
				description: 'New start time in HH:MM (24-hour) format.',
				required: true
			),
			new ToolProperty(
				name: 'end_time',
				type: PropertyType::STRING,
				description: 'New end time in HH:MM (24-hour) format.',
				required: true
			),
		];
	}

	/**
	 * Card header shown in the approval UI.
	 *
	 * @return string
	 */
	public function get_approval_label(): string {
		return 'Reschedule Booktics Appointment';
	}

	/**
	 * One-line summary shown under the card header.
	 *
	 * @return string
	 */
	public function format_approval_summary(): string {
		$inputs = $this->getInputs();
		$id     = $inputs['appointment_id'] ?? '?';
		$when   = trim( ( $inputs['date'] ?? '' ) . ' ' . ( $inputs['start_time'] ?? '' ) );

		// Resolve so the approver can confirm which appointment moves.
		$detail = $this->describe_appointment( $inputs['appointment_id'] ?? 0 );

		return '' !== $detail
			? "Reschedule appointment #{$id} ({$detail}) to {$when}"
			: "Reschedule appointment #{$id} to {$when}";
	}

	/**
	 * Human-readable inputs shown in the approval card table.
	 *
	 * @return array
	 */
	public function get_approval_inputs(): array {
		$inputs = $this->getInputs();

		// Surface who/what/when it moves from.
		$detail = $this->describe_appointment( $inputs['appointment_id'] ?? 0 );
		if ( '' !== $detail ) {
			$inputs['appointment'] = $detail;
		}

		return $inputs;
	}

	/**
	 * Execute the tool after human approval.
	 *
	 * @param int    $appointment_id Appointment ID.
	 * @param string $date           New date (Y-m-d).
	 * @param string $start_time     New start time (HH:MM).
	 * @param string $end_time       New end time (HH:MM).
	 * @return array
	 */
	public function __invoke(
		int $appointment_id,
		string $date,
		string $start_time,
		string $end_time
	): array {
		$check = $this->guard_staff();
		if ( $check ) {
			return $check;
		}

		$access = $this->assert_appointment_access( $appointment_id );
		if ( $access ) {
			return $access;
		}

		$datetime_error = $this->validate_appointment_datetime( $date, $start_time, $end_time );
		if ( $datetime_error ) {
			return $datetime_error;
		}

		try {
			$body = [
				'date'       => $date,
				'start_time' => $start_time,
				'end_time'   => $end_time,
			];

			$request = $this->build_json_request( 'PUT', '/booktics/v1/appointments/' . $appointment_id, $body, $appointment_id );
			if ( is_array( $request ) ) {
				return $request;
			}

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

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

			return [
				'success'        => true,
				'appointment_id' => $appointment_id,
				'date'           => $date,
				'start_time'     => $start_time,
				'end_time'       => $end_time,
				'message'        => "Appointment #{$appointment_id} rescheduled to {$date} {$start_time}–{$end_time}.",
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Booktics_Reschedule_Appointment_Tool error', [ 'error' => $e->getMessage() ] );

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