<?php

/**
 * Booktics Create 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 create (book) a new Booktics appointment.
 *
 * Administrator only. Requires approval. To book on behalf of a customer,
 * pass an existing customer_id; a free-text customer_name may be recorded when
 * no customer record exists yet.
 */
class Booktics_Create_Appointment_Tool extends Booktics_Base_Tool implements Approvable_Tool_Contract {

	/**
	 * Statuses accepted when booking an appointment.
	 */
	private const ALLOWED_STATUSES = [ 'pending', 'active', 'approved', 'completed' ];

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-create-appointment',
			'Book/create a new Booktics appointment for a service with a team member at a given date and time. ' .
			'Required: service_id, team_member_id, date, start_time, end_time. Use booktics-list-services to find service IDs. Requires admin approval.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'service_id',
				type: PropertyType::NUMBER,
				description: 'The service being booked.',
				required: true
			),
			new ToolProperty(
				name: 'team_member_id',
				type: PropertyType::NUMBER,
				description: 'The team member (WP user ID) who will provide the service.',
				required: true
			),
			new ToolProperty(
				name: 'date',
				type: PropertyType::STRING,
				description: 'Appointment date in Y-m-d format.',
				required: true
			),
			new ToolProperty(
				name: 'start_time',
				type: PropertyType::STRING,
				description: 'Start time in HH:MM (24-hour) format.',
				required: true
			),
			new ToolProperty(
				name: 'end_time',
				type: PropertyType::STRING,
				description: 'End time in HH:MM (24-hour) format.',
				required: true
			),
			new ToolProperty(
				name: 'customer_id',
				type: PropertyType::NUMBER,
				description: 'Existing customer (guest) ID to attach to the booking.',
				required: false
			),
			new ToolProperty(
				name: 'customer_name',
				type: PropertyType::STRING,
				description: 'Customer name to record when no customer_id is provided.',
				required: false
			),
			new ToolProperty(
				name: 'status',
				type: PropertyType::STRING,
				description: 'Initial status. One of: pending, active, approved, completed. Default: active.',
				required: false,
				enum: self::ALLOWED_STATUSES
			),
			new ToolProperty(
				name: 'total_attendees',
				type: PropertyType::NUMBER,
				description: 'Number of attendees for a group booking. Default: 1.',
				required: false
			),
			new ToolProperty(
				name: 'note',
				type: PropertyType::STRING,
				description: 'Internal note for the appointment.',
				required: false
			),
		];
	}

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

	/**
	 * One-line summary shown under the card header.
	 *
	 * @return string
	 */
	public function format_approval_summary(): string {
		$inputs       = $this->getInputs();
		$title        = $this->resolve_service_title( $inputs['service_id'] ?? 0 );
		$service_name = '' !== $title ? $title : ( 'service #' . ( $inputs['service_id'] ?? '?' ) );
		$member       = $this->team_member_name( $inputs['team_member_id'] ?? 0 );
		$member       = '' !== $member ? $member : ( 'team member #' . ( $inputs['team_member_id'] ?? '?' ) );

		$when = trim( ( $inputs['date'] ?? '' ) . ' ' . ( $inputs['start_time'] ?? '' ) );

		return "Book \"{$service_name}\" with {$member} on {$when}";
	}

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

		if ( ! empty( $inputs['service_id'] ) ) {
			$title = $this->resolve_service_title( $inputs['service_id'] );
			if ( '' !== $title ) {
				$inputs['service_id'] = $title . ' (ID: ' . $inputs['service_id'] . ')';
			}
		}
		if ( ! empty( $inputs['team_member_id'] ) ) {
			$name = $this->team_member_name( $inputs['team_member_id'] );
			if ( '' !== $name ) {
				$inputs['team_member_id'] = $name . ' (ID: ' . $inputs['team_member_id'] . ')';
			}
		}

		return $inputs;
	}

	/**
	 * Resolve a service's title from its ID for the approval card.
	 *
	 * @param int|string $service_id Service ID.
	 * @return string Title, or '' when the service is missing.
	 */
	private function resolve_service_title( $service_id ): string {
		$service_id = (int) $service_id;
		if ( $service_id <= 0 ) {
			return '';
		}

		$service = \Booktics\Models\Service_Model::find( $service_id );
		return $service ? (string) $service->title : '';
	}

	/**
	 * Execute the tool after human approval.
	 *
	 * @param int         $service_id      Service ID.
	 * @param int         $team_member_id  Team-member (WP user) ID.
	 * @param string      $date            Date (Y-m-d).
	 * @param string      $start_time      Start time (HH:MM).
	 * @param string      $end_time        End time (HH:MM).
	 * @param int|null    $customer_id     Existing customer (guest) ID.
	 * @param string|null $customer_name   Customer name.
	 * @param string|null $status          Initial status.
	 * @param int|null    $total_attendees Attendee count.
	 * @param string|null $note            Internal note.
	 * @return array
	 */
	public function __invoke(
		int $service_id,
		int $team_member_id,
		string $date,
		string $start_time,
		string $end_time,
		?int $customer_id = null,
		?string $customer_name = null,
		?string $status = null,
		?int $total_attendees = null,
		?string $note = null
	): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		$validation = $this->validate_core_fields( $service_id, $team_member_id, $date, $start_time, $end_time );
		if ( $validation ) {
			return $validation;
		}

		if ( null !== $status && ! in_array( $status, self::ALLOWED_STATUSES, true ) ) {
			return [ 'error' => "Invalid status '{$status}'. Accepted values: " . implode( ', ', self::ALLOWED_STATUSES ) . '.' ];
		}

		try {
			$body = [
				'service_id'      => $service_id,
				'team_member_id'  => $team_member_id,
				'date'            => $date,
				'start_time'      => $start_time,
				'end_time'        => $end_time,
				'status'          => $status ?? 'active',
				'total_attendees' => null !== $total_attendees ? max( 1, $total_attendees ) : 1,
			];
			if ( null !== $customer_id ) {
				$body['customer_id'] = $customer_id;
			}
			if ( null !== $customer_name ) {
				$body['customer_name'] = sanitize_text_field( $customer_name );
			}
			if ( null !== $note ) {
				$body['note'] = sanitize_textarea_field( $note );
			}

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

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

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

			$id = (int) ( $data['id'] ?? 0 );
			if ( $id <= 0 ) {
				Log::error( 'Booktics_Create_Appointment_Tool got a success response without an ID', [ 'data_keys' => array_keys( $data ) ] );
				return [ 'error' => 'The appointment may not have been created; Booktics returned no ID. Please verify in Booktics before retrying.' ];
			}

			return [
				'success'        => true,
				'appointment_id' => $id,
				'message'        => "Appointment booked successfully (ID: {$id}) on {$date} at {$start_time}.",
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Booktics_Create_Appointment_Tool error', [ 'error' => $e->getMessage() ] );

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

	/**
	 * Validate the required booking fields and referenced records.
	 *
	 * @param int    $service_id     Service ID.
	 * @param int    $team_member_id Team-member ID.
	 * @param string $date           Date (Y-m-d).
	 * @param string $start_time     Start time (HH:MM).
	 * @param string $end_time       End time (HH:MM).
	 * @return array|null Error array on failure, null when valid.
	 */
	private function validate_core_fields( int $service_id, int $team_member_id, string $date, string $start_time, string $end_time ): ?array {
		if ( $service_id <= 0 || $team_member_id <= 0 ) {
			return [ 'error' => 'A valid service_id and team_member_id are required.' ];
		}

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

		if ( ! \Booktics\Models\Service_Model::find( $service_id ) ) {
			return [ 'error' => "Service #{$service_id} was not found. Use booktics-list-services to find a valid ID." ];
		}

		if ( ! get_userdata( $team_member_id ) ) {
			return [ 'error' => "Team member #{$team_member_id} was not found. Provide the WordPress user ID of a Booktics team member." ];
		}

		return null;
	}
}