<?php

/**
 * Booktics Cancel 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 cancel a Booktics appointment.
 *
 * Administrators may cancel any appointment; team members may only cancel
 * appointments assigned to them. Requires approval.
 *
 * Cancellation is applied by setting the appointment status to "canceled" via
 * the update endpoint (which also syncs the linked order to canceled). This is
 * used instead of Booktics' customer-facing cancel flow, which is gated on the
 * `allow_customer_cancellation` setting and a per-booking security token.
 */
class Booktics_Cancel_Appointment_Tool extends Booktics_Base_Tool implements Approvable_Tool_Contract {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-cancel-appointment',
			'Cancel a Booktics appointment (booking). Optionally record a cancellation note. ' .
			'Find the ID with booktics-list-appointments. Requires approval. This does not delete the record; it marks it canceled.'
		);
	}

	/**
	 * 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 cancel.',
				required: true
			),
			new ToolProperty(
				name: 'cancel_note',
				type: PropertyType::STRING,
				description: 'Optional reason or note for the cancellation.',
				required: false
			),
		];
	}

	/**
	 * Card header shown in the approval UI.
	 *
	 * @return string
	 */
	public function get_approval_label(): string {
		return 'Cancel 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'] ?? '?';

		// Resolve so the approver sees which booking, not just a bare ID.
		$detail  = $this->describe_appointment( $inputs['appointment_id'] ?? 0 );
		$summary = '' !== $detail ? "Cancel appointment #{$id} — {$detail}" : "Cancel appointment #{$id}";
		if ( ! empty( $inputs['cancel_note'] ) ) {
			$summary .= " (reason: {$inputs['cancel_note']})";
		}

		return $summary;
	}

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

		// Surface who/what/when for the approver.
		$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|null $cancel_note    Optional cancellation note.
	 * @return array
	 */
	public function __invoke( int $appointment_id, ?string $cancel_note = null ): array {
		$check = $this->guard_staff();
		if ( $check ) {
			return $check;
		}

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

		try {
			$body = [ 'status' => 'canceled' ];
			if ( null !== $cancel_note && '' !== trim( $cancel_note ) ) {
				$body['cancel_note'] = sanitize_text_field( $cancel_note );
			}

			$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 cancel appointment.' );

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

			return [
				'success'        => true,
				'appointment_id' => $appointment_id,
				'status'         => 'canceled',
				'message'        => "Appointment #{$appointment_id} has been cancelled.",
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Booktics_Cancel_Appointment_Tool error', [ 'error' => $e->getMessage() ] );

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