<?php
/**
 * Pointics Get Reward Tool
 *
 * @package Aisentic\Integrations\Pointics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Pointics;

use Aisentic\Util\Log;
use NeuronAI\Tools\PropertyType;
use NeuronAI\Tools\ToolProperty;

defined( 'ABSPATH' ) || exit;

// Tool contract methods are documented by their typed properties and approval interface.
// phpcs:disable Squiz.Commenting.FunctionComment.Missing

class Pointics_Get_Reward_Tool extends Pointics_Base_Tool {

	public function __construct() {
		parent::__construct(
			'pointics-get-reward',
			__( 'Get the full curated details of one Pointics reward, including its redeem method, redeem parameters, conditions, and user roles. Use pointics-list-rewards first to find a valid reward ID; never guess IDs.', 'aisentic' )
		);
	}

	protected function properties(): array {
		return [
			new ToolProperty( name: 'reward_id', type: PropertyType::NUMBER, description: __( 'Numeric reward ID from pointics-list-rewards.', 'aisentic' ), required: true ),
		];
	}

	public function __invoke( int $reward_id ): array {
		$guard = $this->guard( 'manage_pointics', 'manage_options' );
		if ( null !== $guard ) {
			return $guard;
		}

		$ready = $this->pointics_tables_ready();
		if ( null !== $ready ) {
			return $this->steer( $ready );
		}

		try {
			$request = new \WP_REST_Request( 'GET', '/pointics/v1/rewards/' . $reward_id );
			$request->set_url_params( [ 'id' => $reward_id ] );
			$controller = pointics_container()->make( \Pointics\Api\Controllers\Rewards_Controller::class );
			$data       = $this->extract_response( $controller->get_reward( $request ), __( 'Failed to retrieve the Pointics reward.', 'aisentic' ), 'pointics-get-reward' );

			if ( $this->is_error( $data ) ) {
				return $data;
			}

			return $this->shape_reward( $data );
		} catch ( \Throwable $e ) {
			Log::error( 'Pointics_Get_Reward_Tool error', [ 'error' => $e->getMessage() ] );
			return $this->steer(
				[
					'error'  => __( 'Failed to retrieve the Pointics reward.', 'aisentic' ),
					'code'   => 'internal',
					'status' => null,
				]
			);
		}
	}
}