<?php

/**
 * Booktics Get Service Tool
 *
 * @package Aisentic\Integrations\Booktics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Booktics;

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

defined( 'ABSPATH' ) || exit;

/**
 * Tool to retrieve a single Booktics service by ID.
 *
 * Readable by administrators and team members. Team members may only view a
 * service that is assigned to them.
 */
class Booktics_Get_Service_Tool extends Booktics_Base_Tool {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-get-service',
			'Get the full details of one Booktics service by its ID, including duration options, buffers, assigned team members, categories, and schedule. ' .
			'Use booktics-list-services first to find the ID.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'service_id',
				type: PropertyType::NUMBER,
				description: 'The numeric ID of the service to retrieve.',
				required: true
			),
		];
	}

	/**
	 * Execute the tool
	 *
	 * @param int $service_id Service ID.
	 * @return array
	 */
	public function __invoke( int $service_id ): array {
		$check = $this->guard_staff();
		if ( $check ) {
			return $check;
		}

		// Confirms the service exists and (for team members) that it is theirs.
		$access = $this->assert_service_access( $service_id );
		if ( $access ) {
			return $access;
		}

		try {
			$request = new \WP_REST_Request( 'GET', '/booktics/v1/services/' . $service_id );
			$request->set_url_params( [ 'id' => $service_id ] );

			$controller = new \Booktics\Service\Controllers\Service_Controller();
			$service    = $this->extract_response( $controller->get_item( $request ), 'Failed to retrieve service.' );

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

			return $this->shape_service( $service, true );
		} catch ( \Throwable $e ) {
			Log::error( 'Booktics_Get_Service_Tool error', [ 'error' => $e->getMessage() ] );

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