<?php

/**
 * WpCafe Update Order Status Tool
 *
 * @package Aisentic\Integrations\WpCafe
 */

declare(strict_types=1);

namespace Aisentic\Integrations\WpCafe;

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

defined( 'ABSPATH' ) || exit;

/**
 * Tool to update the status of a WpCafe food order.
 * Requires admin approval before execution.
 */
class Wpcafe_Update_Order_Status_Tool extends Wpcafe_Base_Tool implements Approvable_Tool_Contract {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'wpcafe-update-order-status',
			'Update, change, or set the status of a WpCafe food order (any registered WooCommerce status, e.g. pending, processing, ' .
			'on-hold, completed, cancelled, refunded, failed). Find the order ID with wpcafe-list-food-orders.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'order_id',
				type: PropertyType::NUMBER,
				description: 'The WooCommerce order ID to update. Use wpcafe-list-food-orders to find it.',
				required: true
			),
			new ToolProperty(
				name: 'status',
				type: PropertyType::STRING,
				description: 'New order status. The site\'s registered WooCommerce statuses are accepted (e.g. pending, processing, on-hold, completed, cancelled, refunded, failed). Custom statuses added by other plugins are also valid.',
				required: true
			),
		];
	}

	/**
	 * Human-readable label for the approval card header.
	 *
	 * @return string
	 */
	public function get_approval_label(): string {
		return 'Update Food Order Status';
	}

	/**
	 * One-line summary of what this invocation will do.
	 *
	 * @return string
	 */
	public function format_approval_summary(): string {
		$inputs   = $this->getInputs();
		$order_id = $inputs['order_id'] ?? '?';
		$status   = $inputs['status'] ?? '?';

		return "Change order #{$order_id} status to \"{$status}\"";
	}

	/**
	 * Human-readable version of tool inputs for the approval card.
	 *
	 * @return array
	 */
	public function get_approval_inputs(): array {
		return $this->getInputs();
	}

	/**
	 * Execute the tool
	 *
	 * @param int    $order_id WooCommerce order ID.
	 * @param string $status   New order status.
	 * @return array
	 */
	public function __invoke( int $order_id, string $status ): array {
		$check = $this->guard( 'manage_woocommerce', 'manage_options', 'wpcafe_manage_orders' );
		if ( $check ) {
			return $check;
		}

		if ( ! function_exists( 'wc_get_order_statuses' ) ) {
			return [ 'error' => 'WooCommerce is not active.' ];
		}

		if ( $order_id <= 0 ) {
			return [ 'error' => 'order_id must be a positive integer.' ];
		}

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

		$valid_statuses = array_keys( wc_get_order_statuses() );
		$prefixed       = 'wc-' === substr( $status, 0, 3 ) ? $status : 'wc-' . $status;

		if ( ! in_array( $prefixed, $valid_statuses, true ) ) {
			$readable = implode( ', ', array_map( fn( $s ) => 0 === strpos( $s, 'wc-' ) ? substr( $s, 3 ) : $s, $valid_statuses ) );
			return [ 'error' => "Invalid status '{$status}'. Valid values: {$readable}." ];
		}

		try {
			$request = new \WP_REST_Request( 'PATCH', '/wpcafe/v2/food-orders/' . $order_id );
			$request->set_url_params( [ 'id' => $order_id ] );
			$request->set_param( 'status', $status );

			$controller = new \WpCafe\FoodOrder\Controllers\Food_Order_Controller();
			$response   = $controller->update_item_status( $request );

			$data = $this->extract_response( $response, 'Failed to update order status.' );
			if ( isset( $data['error'] ) ) {
				return $data;
			}

			return [
				'success'  => true,
				'order_id' => $order_id,
				'status'   => $status,
				'message'  => "Order #{$order_id} status updated to \"{$status}\".",
			];
		} catch ( \Throwable $e ) {
			Log::error(
				'Wpcafe_Update_Order_Status_Tool error',
				[ 'error' => $e->getMessage() ]
			);

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