<?php

/**
 * Booktics List Modules Tool
 *
 * @package Aisentic\Integrations\Booktics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Booktics;

use Aisentic\Util\Log;

defined( 'ABSPATH' ) || exit;

/**
 * Tool to list Booktics feature modules and integrations and their on/off state.
 *
 * Administrator only. Only toggleable feature modules and integrations are
 * returned; installable add-on/companion plugins are intentionally excluded, as
 * those are not safe for the assistant to manage.
 */
class Booktics_List_Modules_Tool extends Booktics_Base_Tool {

	/**
	 * Module types that are safe, in-place feature toggles.
	 */
	private const TOGGLEABLE_TYPES = [ 'module', 'integration' ];

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-list-modules',
			'List Booktics feature modules and integrations (e.g. Stripe, Google Calendar, FluentCRM, Zapier) with their current on/off status. ' .
			'Use this to see what can be enabled or disabled before toggling one with booktics-toggle-module. Administrator only.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [];
	}

	/**
	 * Execute the tool
	 *
	 * @return array
	 */
	public function __invoke(): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		try {
			$request = new \WP_REST_Request( 'GET', '/booktics/v1/module' );
			$request->set_query_params( [ 'type' => 'all' ] );

			$controller = new \Booktics\Extensions\Controllers\Module_Controller();
			$result     = $this->extract_response( $controller->get_items( $request ), 'Failed to retrieve modules.' );

			if ( isset( $result['error'] ) ) {
				return $result;
			}

			// Keep only in-place feature toggles; exclude plugin/addon installs.
			$modules = array_filter(
				$result,
				static function ( $module ) {
					return is_array( $module ) && in_array( $module['type'] ?? '', self::TOGGLEABLE_TYPES, true );
				}
			);

			return [ 'items' => $this->shape_rows( array_values( $modules ), fn( $module ) => $this->shape_module( $module ) ) ];
		} catch ( \Throwable $e ) {
			Log::error( 'Booktics_List_Modules_Tool error', [ 'error' => $e->getMessage() ] );

			return [ 'error' => 'Failed to retrieve modules: ' . $e->getMessage() ];
		}
	}
}