<?php

/**
 * Booktics Update Settings 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 update low-impact Booktics settings.
 *
 * Administrator only. Requires approval. Only the curated, low-impact settings
 * exposed as parameters below can be changed; the tool cannot touch payment
 * credentials, API keys, OAuth tokens, webhook URLs, licensing, or capabilities.
 * Booktics merges the supplied keys, so omitted settings are left untouched.
 */
class Booktics_Update_Settings_Tool extends Booktics_Base_Tool implements Approvable_Tool_Contract {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-update-settings',
			'Change low-impact Booktics settings such as currency, date/time format, timezone, business name and contact, branding colours, and customer reschedule/cancel permissions. ' .
			'Cannot change API keys, payment credentials, or any secret. Only the fields you provide change. Requires admin approval.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'currency',
				type: PropertyType::STRING,
				description: 'Three-letter currency code, e.g. "USD".',
				required: false
			),
			new ToolProperty(
				name: 'date_format',
				type: PropertyType::STRING,
				description: 'PHP date format string, e.g. "Y-m-d".',
				required: false
			),
			new ToolProperty(
				name: 'time_format',
				type: PropertyType::STRING,
				description: 'PHP time format string, e.g. "H:i".',
				required: false
			),
			new ToolProperty(
				name: 'timezone',
				type: PropertyType::STRING,
				description: 'Timezone string, e.g. "America/New_York".',
				required: false
			),
			new ToolProperty(
				name: 'business_name',
				type: PropertyType::STRING,
				description: 'Public business name.',
				required: false
			),
			new ToolProperty(
				name: 'business_email',
				type: PropertyType::STRING,
				description: 'Public business contact email.',
				required: false
			),
			new ToolProperty(
				name: 'business_address',
				type: PropertyType::STRING,
				description: 'Public business address.',
				required: false
			),
			new ToolProperty(
				name: 'primary_color',
				type: PropertyType::STRING,
				description: 'Primary brand colour as a hex value, e.g. "#2563eb".',
				required: false
			),
			new ToolProperty(
				name: 'secondary_color',
				type: PropertyType::STRING,
				description: 'Secondary brand colour as a hex value.',
				required: false
			),
			new ToolProperty(
				name: 'show_end_time',
				type: PropertyType::BOOLEAN,
				description: 'Whether to show appointment end times to customers.',
				required: false
			),
			new ToolProperty(
				name: 'allow_customer_rescheduling',
				type: PropertyType::BOOLEAN,
				description: 'Whether customers may reschedule their own bookings.',
				required: false
			),
			new ToolProperty(
				name: 'allow_customer_cancellation',
				type: PropertyType::BOOLEAN,
				description: 'Whether customers may cancel their own bookings.',
				required: false
			),
			new ToolProperty(
				name: 'allow_customer_as_wp_user',
				type: PropertyType::BOOLEAN,
				description: 'Whether booking customers are registered as WordPress users.',
				required: false
			),
		];
	}

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

	/**
	 * One-line summary shown under the card header.
	 *
	 * @return string
	 */
	public function format_approval_summary(): string {
		$keys = array_keys( $this->getInputs() );

		return empty( $keys )
			? 'Update Booktics settings'
			: 'Update Booktics settings: ' . implode( ', ', $keys );
	}

	/**
	 * 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|null $currency                    Currency code.
	 * @param string|null $date_format                 Date format.
	 * @param string|null $time_format                 Time format.
	 * @param string|null $timezone                    Timezone string.
	 * @param string|null $business_name               Business name.
	 * @param string|null $business_email              Business email.
	 * @param string|null $business_address            Business address.
	 * @param string|null $primary_color               Primary brand colour.
	 * @param string|null $secondary_color             Secondary brand colour.
	 * @param bool|null   $show_end_time               Show end times.
	 * @param bool|null   $allow_customer_rescheduling Customers may reschedule.
	 * @param bool|null   $allow_customer_cancellation Customers may cancel.
	 * @param bool|null   $allow_customer_as_wp_user   Register customers as WP users.
	 * @return array
	 */
	public function __invoke(
		?string $currency = null,
		?string $date_format = null,
		?string $time_format = null,
		?string $timezone = null,
		?string $business_name = null,
		?string $business_email = null,
		?string $business_address = null,
		?string $primary_color = null,
		?string $secondary_color = null,
		?bool $show_end_time = null,
		?bool $allow_customer_rescheduling = null,
		?bool $allow_customer_cancellation = null,
		?bool $allow_customer_as_wp_user = null
	): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		if ( null !== $business_email && '' !== trim( $business_email ) && ! is_email( $business_email ) ) {
			return [ 'error' => 'business_email must be a valid email address.' ];
		}

		$body = [];
		foreach (
			[
				'currency'         => $currency,
				'date_format'      => $date_format,
				'time_format'      => $time_format,
				'timezone'         => $timezone,
				'business_name'    => $business_name,
				'business_email'   => $business_email,
				'business_address' => $business_address,
				'primary_color'    => $primary_color,
				'secondary_color'  => $secondary_color,
			] as $key => $value
		) {
			if ( null !== $value ) {
				$body[ $key ] = 'business_address' === $key
					? sanitize_textarea_field( $value )
					: sanitize_text_field( $value );
			}
		}

		foreach (
			[
				'show_end_time'               => $show_end_time,
				'allow_customer_rescheduling' => $allow_customer_rescheduling,
				'allow_customer_cancellation' => $allow_customer_cancellation,
				'allow_customer_as_wp_user'   => $allow_customer_as_wp_user,
			] as $key => $value
		) {
			if ( null !== $value ) {
				$body[ $key ] = (bool) $value;
			}
		}

		if ( empty( $body ) ) {
			return [ 'error' => 'No settings provided to update.' ];
		}

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

			$controller = new \Booktics\Settings\Controllers\Settings_Controller();
			$data       = $this->extract_response( $controller->update_item( $request ), 'Failed to update settings.' );

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

			$updated = array_keys( $body );

			return [
				'success'        => true,
				'updated_fields' => $updated,
				'settings'       => array_intersect_key( $data, $body ),
				'message'        => 'Settings updated successfully: ' . implode( ', ', $updated ) . '.',
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Booktics_Update_Settings_Tool error', [ 'error' => $e->getMessage() ] );

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