<?php

/**
 * Booktics Toggle Module Tool
 *
 * @package Aisentic\Integrations\Booktics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Booktics;

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

defined( 'ABSPATH' ) || exit;

/**
 * Tool to turn a Booktics feature module or integration on or off.
 *
 * Administrator only. Requires approval. Restricted to in-place feature toggles
 * (module/integration types) with an on/off status — it can never install,
 * activate, deactivate, or upgrade a WordPress plugin, and it does not touch any
 * credentials. Enabling a payment/integration module only flips its flag; the
 * admin must still supply credentials elsewhere for it to work.
 */
class Booktics_Toggle_Module_Tool extends Booktics_Base_Tool implements Approvable_Tool_Contract {

	/**
	 * Accepted statuses. Deliberately excludes install/activate/deactivate/upgrade.
	 */
	private const ALLOWED_STATUSES = [ 'on', 'off' ];

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

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-toggle-module',
			'Enable or disable a Booktics feature module or integration (e.g. Stripe, Google Calendar, FluentCRM, Zapier, Zoho, Pabbly). ' .
			'Use booktics-list-modules to find the module slug. status must be "on" or "off". Requires admin approval.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'slug',
				type: PropertyType::STRING,
				description: 'The module/integration slug, e.g. "stripe", "google-calendar", "fluentcrm", "zapier", "zoho", "pabbly".',
				required: true
			),
			new ToolProperty(
				name: 'status',
				type: PropertyType::STRING,
				description: 'Whether to turn the module on or off.',
				required: true,
				enum: self::ALLOWED_STATUSES
			),
		];
	}

	/**
	 * Card header shown in the approval UI.
	 *
	 * @return string
	 */
	public function get_approval_label(): string {
		return 'Toggle Booktics Module';
	}

	/**
	 * One-line summary shown under the card header.
	 *
	 * @return string
	 */
	public function format_approval_summary(): string {
		$inputs = $this->getInputs();
		$slug   = $inputs['slug'] ?? '?';
		$status = $inputs['status'] ?? '?';

		return "Turn the \"{$slug}\" module {$status}";
	}

	/**
	 * Human-readable inputs shown in the approval card table.
	 *
	 * @return array
	 */
	public function get_approval_inputs(): array {
		return $this->getInputs();
	}

	/**
	 * Execute the tool after human approval.
	 *
	 * @param string $slug   Module/integration slug.
	 * @param string $status on|off.
	 * @return array
	 */
	public function __invoke( string $slug, string $status ): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		$slug = sanitize_key( $slug );
		if ( '' === $slug ) {
			return [ 'error' => 'A module slug is required.' ];
		}
		if ( ! in_array( $status, self::ALLOWED_STATUSES, true ) ) {
			return [ 'error' => "Invalid status '{$status}'. Accepted values: " . implode( ', ', self::ALLOWED_STATUSES ) . '.' ];
		}

		// Confirm the slug is a real, in-place feature toggle (not a plugin/addon
		// install) before touching the controller, which would otherwise accept
		// install/activate actions for plugin-type extensions.
		$modules = function_exists( 'booktics_modules_list' ) ? booktics_modules_list() : [];
		$module  = $modules[ $slug ] ?? null;
		if ( ! is_array( $module ) ) {
			return [ 'error' => "Module '{$slug}' was not found. Use booktics-list-modules to see valid slugs." ];
		}
		if ( ! in_array( $module['type'] ?? '', self::TOGGLEABLE_TYPES, true ) ) {
			return [ 'error' => "Module '{$slug}' is not a toggleable feature module and cannot be changed with this tool." ];
		}

		try {
			$request = $this->build_json_request(
				'POST',
				'/booktics/v1/module',
				[
					'name'   => $slug,
					'status' => $status,
				]
			);
			if ( is_array( $request ) ) {
				return $request;
			}

			$controller = new \Booktics\Extensions\Controllers\Module_Controller();
			$data       = $this->extract_response( $controller->update_item( $request ), 'Failed to toggle module.' );

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

			$label = $module['title'] ?? $slug;

			return [
				'success' => true,
				'slug'    => $slug,
				'status'  => $status,
				'message' => "The \"{$label}\" module was turned {$status}.",
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Booktics_Toggle_Module_Tool error', [ 'error' => $e->getMessage() ] );

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