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

declare(strict_types=1);

namespace Aisentic\Integrations\Pointics;

use Aisentic\Util\Log;

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_Stats_Tool extends Pointics_Base_Tool {

	public function __construct() {
		parent::__construct(
			'pointics-get-reward-stats',
			__( 'Get curated Pointics reward redemption statistics. Use pointics-list-rewards for reward rows and pointics-list-redemption-methods for live vocabulary; this tool has no hardcoded dynamic enums.', 'aisentic' )
		);
	}

	protected function properties(): array {
		return [];
	}

	public function __invoke(): 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 {
			$controller = pointics_container()->make( \Pointics\Api\Controllers\Rewards_Controller::class );
			$data       = $this->extract_response( $controller->get_stats(), __( 'Failed to retrieve Pointics reward statistics.', 'aisentic' ), 'pointics-get-reward-stats' );
			if ( $this->is_error( $data ) ) {
				return $data;
			}

			return [
				'total_redemptions' => (int) ( $data['total_redemptions'] ?? 0 ),
				'points_redeemed'   => (int) ( $data['points_redeemed'] ?? 0 ),
				'redemption_rate'   => (float) ( $data['redemption_rate'] ?? 0 ),
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Pointics_Get_Reward_Stats_Tool error', [ 'error' => $e->getMessage() ] );
			return $this->steer(
				[
					'error'  => __( 'Failed to retrieve Pointics reward statistics.', 'aisentic' ),
					'code'   => 'internal',
					'status' => null,
				]
			);
		}
	}
}