<?php

/**
 * Booktics Create Service 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 a new Booktics service (a bookable appointment type).
 *
 * Administrator only. Implements Approvable_Tool_Contract so the agent can
 * never create a service without explicit human approval.
 */
class Booktics_Create_Service_Tool extends Booktics_Base_Tool implements Approvable_Tool_Contract {

	/**
	 * Accepted service statuses.
	 */
	private const ALLOWED_STATUSES = [ 'active', 'deactive' ];

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-create-service',
			'Create a new Booktics service (a bookable appointment type such as "Haircut" or "30-min Consultation"). ' .
			'Only "title" is required. Optionally set the duration, price, buffers, status, assigned team members, and categories. Requires admin approval.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'title',
				type: PropertyType::STRING,
				description: 'Name of the service, e.g. "Haircut".',
				required: true
			),
			new ToolProperty(
				name: 'description',
				type: PropertyType::STRING,
				description: 'Short description of the service.',
				required: false
			),
			new ToolProperty(
				name: 'duration_minutes',
				type: PropertyType::NUMBER,
				description: 'How long the service takes, in minutes. Default: 30.',
				required: false
			),
			new ToolProperty(
				name: 'price',
				type: PropertyType::NUMBER,
				description: 'Charge amount for the service in the store currency. Default: 0 (free).',
				required: false
			),
			new ToolProperty(
				name: 'status',
				type: PropertyType::STRING,
				description: 'Service status. "active" makes it bookable, "deactive" hides it. Default: active.',
				required: false,
				enum: self::ALLOWED_STATUSES
			),
			new ToolProperty(
				name: 'before_buffer_time',
				type: PropertyType::NUMBER,
				description: 'Padding time (minutes) reserved before each appointment. Default: 0.',
				required: false
			),
			new ToolProperty(
				name: 'after_buffer_time',
				type: PropertyType::NUMBER,
				description: 'Padding time (minutes) reserved after each appointment. Default: 0.',
				required: false
			),
			new ToolProperty(
				name: 'team_member_ids',
				type: PropertyType::ARRAY,
				description: 'Array of team-member (WP user) IDs who provide this service. If omitted, Booktics auto-assigns an administrator.',
				required: false
			),
			new ToolProperty(
				name: 'category_ids',
				type: PropertyType::ARRAY,
				description: 'Array of category term IDs to file this service under.',
				required: false
			),
		];
	}

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

	/**
	 * One-line summary shown under the card header.
	 *
	 * @return string
	 */
	public function format_approval_summary(): string {
		$inputs = $this->getInputs();
		$title  = isset( $inputs['title'] ) ? "\"{$inputs['title']}\"" : '(untitled)';

		$summary = "Create service {$title}";
		if ( ! empty( $inputs['duration_minutes'] ) ) {
			$summary .= " ({$inputs['duration_minutes']} min)";
		}
		if ( isset( $inputs['price'] ) && '' !== $inputs['price'] ) {
			$summary .= ' priced at ' . $inputs['price'];
		}

		return $summary;
	}

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

	/**
	 * Execute the tool after human approval.
	 *
	 * @param string      $title              Service name.
	 * @param string|null $description        Service description.
	 * @param int|null    $duration_minutes   Duration in minutes.
	 * @param float|null  $price              Charge amount.
	 * @param string|null $status            active|deactive.
	 * @param int|null    $before_buffer_time Buffer before, minutes.
	 * @param int|null    $after_buffer_time  Buffer after, minutes.
	 * @param array|null  $team_member_ids    Assigned team-member IDs.
	 * @param array|null  $category_ids       Category term IDs.
	 * @return array
	 */
	public function __invoke(
		string $title,
		?string $description = null,
		?int $duration_minutes = null,
		?float $price = null,
		?string $status = null,
		?int $before_buffer_time = null,
		?int $after_buffer_time = null,
		?array $team_member_ids = null,
		?array $category_ids = null
	): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		if ( empty( trim( $title ) ) ) {
			return [ 'error' => 'title is required.' ];
		}

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

		try {
			$body = [
				'title'  => sanitize_text_field( $title ),
				'status' => $status ?? 'active',
			];

			if ( null !== $description ) {
				$body['description'] = sanitize_text_field( $description );
			}
			if ( null !== $before_buffer_time ) {
				$body['before_buffer_time'] = max( 0, $before_buffer_time );
			}
			if ( null !== $after_buffer_time ) {
				$body['after_buffer_time'] = max( 0, $after_buffer_time );
			}
			if ( null !== $team_member_ids ) {
				$body['team_member'] = array_values( array_unique( array_map( 'intval', $team_member_ids ) ) );
			}
			if ( null !== $category_ids ) {
				$body['categories'] = array_values( array_unique( array_map( 'intval', $category_ids ) ) );
			}
			if ( null !== $duration_minutes || null !== $price ) {
				$body['additional_durations'] = [
					$this->default_duration_row( (int) ( $duration_minutes ?? 30 ), (float) ( $price ?? 0 ) ),
				];
			}

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

			$controller = new \Booktics\Service\Controllers\Service_Controller();
			$data       = $this->extract_response( $controller->create_item( $request ), 'Failed to create service.' );

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

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

			return [
				'success'    => true,
				'service_id' => $id,
				'title'      => $title,
				'message'    => "Service \"{$title}\" created successfully (ID: {$id}).",
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Booktics_Create_Service_Tool error', [ 'error' => $e->getMessage() ] );

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