<?php
/**
 * Pointics Get Channel 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;

/**
 * Retrieve one configured Pointics earn channel.
 */
class Pointics_Get_Channel_Tool extends Pointics_Base_Tool {

	/**
	 * Constructor.
	 */
	public function __construct() {
		parent::__construct(
			'pointics-get-channel',
			__( 'Get the curated full detail for one Pointics earn channel, including calc_type and calc_params. Call pointics-list-channels first to obtain a real channel ID; never guess IDs.', 'aisentic' )
		);
	}

	/**
	 * Define tool properties.
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'channel_id',
				type: PropertyType::INTEGER,
				description: __( 'The real channel ID returned by pointics-list-channels.', 'aisentic' ),
				required: true
			),
		];
	}

	/**
	 * Execute the tool.
	 *
	 * @param int $channel_id Channel ID.
	 * @return array
	 */
	public function __invoke( int $channel_id ): array {
		$check = $this->guard( 'manage_pointics', 'manage_options' );
		if ( $check ) {
			return $check;
		}

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

		if ( $channel_id <= 0 ) {
			return $this->steer(
				[
					'error'  => __( 'channel_id must be a positive integer. Use pointics-list-channels to find it.', 'aisentic' ),
					'code'   => 'validation',
					'status' => 422,
				]
			);
		}

		try {
			$request = new \WP_REST_Request( 'GET' );
			$request->set_param( 'id', $channel_id );
			$controller = pointics_container()->make( \Pointics\Api\Controllers\Channels_Controller::class );
			$data       = $this->extract_response(
				$controller->get_channel( $request ),
				__( 'Failed to get the Pointics channel.', 'aisentic' ),
				'pointics-get-channel'
			);

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

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