<?php
/**
 * Pointics List Channels 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;

/**
 * List configured Pointics earn channels.
 */
class Pointics_List_Channels_Tool extends Pointics_Base_Tool {

	/**
	 * Constructor.
	 */
	public function __construct() {
		parent::__construct(
			'pointics-list-channels',
			__( 'List Pointics earn channels with optional active, trigger, integration, and type filters. Use this before pointics-get-channel, pointics-update-channel, pointics-delete-channel, or pointics-trigger-channel to obtain real IDs; never guess channel IDs.', 'aisentic' )
		);
	}

	/**
	 * Define tool properties.
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'is_active',
				type: PropertyType::BOOLEAN,
				description: __( 'Optional filter for active or inactive channels.', 'aisentic' ),
				required: false
			),
			new ToolProperty(
				name: 'trigger',
				type: PropertyType::STRING,
				description: __( 'Optional live trigger identifier from pointics-list-channel-building-blocks.', 'aisentic' ),
				required: false
			),
			new ToolProperty(
				name: 'integration',
				type: PropertyType::STRING,
				description: __( 'Optional live integration identifier from pointics-list-channel-building-blocks.', 'aisentic' ),
				required: false
			),
			new ToolProperty(
				name: 'type',
				type: PropertyType::STRING,
				description: __( 'Optional live channel type from pointics-list-channel-building-blocks.', 'aisentic' ),
				required: false
			),
			new ToolProperty(
				name: 'page',
				type: PropertyType::INTEGER,
				description: __( 'Page number, starting at 1. Values are bounded before reaching Pointics.', 'aisentic' ),
				required: false
			),
			new ToolProperty(
				name: 'per_page',
				type: PropertyType::INTEGER,
				description: __( 'Rows per page, bounded to 100.', 'aisentic' ),
				required: false
			),
		];
	}

	/**
	 * Execute the tool.
	 *
	 * @param bool|null   $is_active Optional active filter.
	 * @param string|null $trigger Optional trigger filter.
	 * @param string|null $integration Optional integration filter.
	 * @param string|null $type Optional type filter.
	 * @param int|null    $page Optional page number.
	 * @param int|null    $per_page Optional rows per page.
	 * @return array
	 */
	public function __invoke(
		?bool $is_active = null,
		?string $trigger = null,
		?string $integration = null,
		?string $type = null,
		?int $page = null,
		?int $per_page = null
	): array {
		$check = $this->guard( 'manage_pointics', 'manage_options' );
		if ( $check ) {
			return $check;
		}

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

		$raw_per_page = $per_page;
		$page         = max( 1, (int) ( $page ?? 1 ) );
		$per_page     = min( 100, max( 1, (int) ( $per_page ?? 20 ) ) );
		$clamped      = null !== $raw_per_page && $raw_per_page > 100;

		try {
			$request = new \WP_REST_Request( 'GET' );
			$request->set_param( 'page', $page );
			$request->set_param( 'per_page', $per_page );

			foreach ( [ 'is_active', 'trigger', 'integration', 'type' ] as $key ) {
				$value = 'is_active' === $key ? $is_active : ( 'trigger' === $key ? $trigger : ( 'integration' === $key ? $integration : $type ) );
				if ( null !== $value ) {
					$request->set_param( $key, $value );
				}
			}

			$controller = pointics_container()->make( \Pointics\Api\Controllers\Channels_Controller::class );
			$data       = $this->extract_response(
				$controller->list_channels( $request ),
				__( 'Failed to list Pointics channels.', 'aisentic' ),
				'pointics-list-channels'
			);

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

			$result = $this->shape_paginated(
				$data,
				fn( array $item ): array => $this->with_admin_url(
					$this->pluck(
						$item,
						[ 'id', 'name', 'trigger', 'integration', 'type', 'calc_type', 'frequency', 'is_active' ]
					),
					'points-program'
				)
			);

			if ( $clamped ) {
				$result['note'] = __( 'per_page was bounded to the maximum of 100.', 'aisentic' );
			}

			return $result;
		} catch ( \Throwable $e ) {
			Log::error( 'Pointics_List_Channels_Tool error', [ 'error' => $e->getMessage() ] );
			return $this->steer(
				[
					'error'  => __( 'Failed to list Pointics channels.', 'aisentic' ),
					'code'   => 'internal',
					'status' => null,
				]
			);
		}
	}
}