<?php

/**
 * Booktics List Services 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 list Booktics services (bookable appointment types).
 *
 * Readable by administrators and team members. Use it to find a service and
 * its ID before creating or updating an appointment or another service.
 */
class Booktics_List_Services_Tool extends Booktics_Base_Tool {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'booktics-list-services',
			'List, browse, or search Booktics services (the bookable appointment types offered, e.g. "Haircut", "Consultation"). ' .
			'Use this to find a service ID before booking an appointment or editing a service. Returns duration, buffers, status, and assigned team members.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'per_page',
				type: PropertyType::NUMBER,
				description: 'Number of services to return per page. Default: 10, maximum: 50.',
				required: false
			),
			new ToolProperty(
				name: 'paged',
				type: PropertyType::NUMBER,
				description: 'Page number. Default: 1.',
				required: false
			),
			new ToolProperty(
				name: 'search',
				type: PropertyType::STRING,
				description: 'Search term to filter services by title.',
				required: false
			),
			new ToolProperty(
				name: 'category_id',
				type: PropertyType::NUMBER,
				description: 'Filter to services in a specific category term ID.',
				required: false
			),
		];
	}

	/**
	 * Execute the tool
	 *
	 * @param int|null    $per_page    Items per page.
	 * @param int|null    $paged       Page number.
	 * @param string|null $search      Search term.
	 * @param int|null    $category_id Category term ID.
	 * @return array
	 */
	public function __invoke(
		?int $per_page = 10,
		?int $paged = 1,
		?string $search = null,
		?int $category_id = null
	): array {
		$check = $this->guard_staff();
		if ( $check ) {
			return $check;
		}

		try {
			$params = [
				'per_page' => min( 50, max( 1, (int) ( $per_page ?? 10 ) ) ),
				'paged'    => max( 1, (int) ( $paged ?? 1 ) ),
			];
			if ( ! empty( $search ) ) {
				$params['search'] = $search;
			}
			if ( null !== $category_id ) {
				$params['category_id'] = $category_id;
			}

			// Team members only ever see the services assigned to them.
			$scoped_team_member = $this->enforced_team_member_id();
			if ( null !== $scoped_team_member ) {
				$params['team_member_id'] = $scoped_team_member;
			}

			$request = new \WP_REST_Request( 'GET', '/booktics/v1/services' );
			$request->set_query_params( $params );

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

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

			// A genuinely empty result already comes back as a 200 with items:[],
			// so it flows through the shaping path below — no special-casing needed.
			return $this->shape_paginated( $result, fn( $service ) => $this->shape_service( $service ) );
		} catch ( \Throwable $e ) {
			Log::error(
				'Booktics_List_Services_Tool error',
				[ 'error' => $e->getMessage() ]
			);

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