<?php

/**
 * Booktics Get Team Member 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 team member by ID.
 *
 * Administrator only. Returns the member's profile plus their working schedule,
 * custom hours, and holidays. A team member who wants their own schedule uses
 * booktics-get-my-schedule instead.
 */
class Booktics_Get_Team_Member_Tool extends Booktics_Base_Tool {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-get-team-member',
			'Get the full details of one Booktics team member by their ID, including contact details, assigned services, status, and working schedule (weekly hours, custom hours, and holidays). ' .
			'Use booktics-list-team-members first to find the ID. Administrator only.'
		);
	}

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

	/**
	 * Execute the tool
	 *
	 * @param int $team_member_id Team-member (WP user) ID.
	 * @return array
	 */
	public function __invoke( int $team_member_id ): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		$access = $this->assert_team_member( $team_member_id );
		if ( $access ) {
			return $access;
		}

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

			$controller = new \Booktics\Team_Member\Controllers\Team_Member_Controller();
			$member     = $this->extract_response( $controller->get_item( $request ), 'Failed to retrieve team member.' );

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

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

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