<?php

/**
 * Timetics Get Shortcodes Tool
 *
 * @package Aisentic\Integrations\Timetics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Timetics;

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

defined( 'ABSPATH' ) || exit;

/**
 * Tool to build ready-to-paste Timetics shortcodes. Administrator only.
 *
 * Timetics registers four shortcodes in core/frontend/shortcode.php. This tool
 * assembles them with the right attributes (validating any supplied meeting or
 * category ID) so the admin can drop them into a page or post.
 */
class Timetics_Get_Shortcodes_Tool extends Timetics_Base_Tool {

	/**
	 * The meeting post type used to validate a supplied meeting ID.
	 */
	private const MEETING_POST_TYPE = 'timetics-appointment';

	/**
	 * The taxonomy used to validate a supplied category ID.
	 */
	private const CATEGORY_TAXONOMY = 'timetics-meeting-category';

	public function __construct() {
		parent::__construct(
			'timetics-get-shortcodes',
			'Get ready-to-paste Timetics shortcodes for embedding booking functionality on a page or post. ' .
			'Returns the single-meeting booking form, the meeting list, a category listing, and the user dashboard. ' .
			'Optionally pass a meeting_id to embed a specific meeting\'s booking form, or a category_id for a category listing.'
		);
	}

	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'meeting_id',
				type: PropertyType::NUMBER,
				description: 'Optional meeting ID for the [timetics-booking-form] shortcode. If omitted, a placeholder id is used.',
				required: false
			),
			new ToolProperty(
				name: 'category_id',
				type: PropertyType::NUMBER,
				description: 'Optional category (term) ID for the [timetics-category] shortcode. If omitted, a placeholder id is used.',
				required: false
			),
			new ToolProperty(
				name: 'limit',
				type: PropertyType::NUMBER,
				description: 'Number of meetings shown by the [timetics-meeting-list] shortcode. Default: 10.',
				required: false
			),
			new ToolProperty(
				name: 'show_filter',
				type: PropertyType::BOOLEAN,
				description: 'Whether the [timetics-meeting-list] shortcode shows its filter UI. Default: true.',
				required: false
			),
		];
	}

	public function __invoke( ?int $meeting_id = null, ?int $category_id = null, ?int $limit = 10, ?bool $show_filter = true ): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		try {
			// Booking form — validate the meeting if one was supplied.
			$meeting_name = '';
			if ( null !== $meeting_id && $meeting_id > 0 ) {
				$post = get_post( $meeting_id );
				if ( ! $post || self::MEETING_POST_TYPE !== $post->post_type ) {
					return [ 'error' => "Meeting #{$meeting_id} was not found." ];
				}
				$meeting_name = $post->post_title;
				$booking_id   = (string) $meeting_id;
			} else {
				$booking_id = 'MEETING_ID';
			}

			// Category — validate the term if one was supplied.
			$category_name = '';
			if ( null !== $category_id && $category_id > 0 ) {
				$term = get_term( $category_id, self::CATEGORY_TAXONOMY );
				if ( ! $term || is_wp_error( $term ) ) {
					return [ 'error' => "Meeting category #{$category_id} was not found." ];
				}
				$category_name = $term->name;
				$category_slug = (string) $category_id;
			} else {
				$category_slug = 'CATEGORY_ID';
			}

			$limit       = max( 1, (int) ( $limit ?? 10 ) );
			$show_filter = null === $show_filter ? true : $show_filter;
			$filter_attr = $show_filter ? 'true' : 'false';

			return [
				'shortcodes' => [
					'booking_form'   => [
						'shortcode'    => sprintf( '[timetics-booking-form id="%s"]', $booking_id ),
						'description'  => 'Embeds the booking widget for a single meeting.',
						'meeting_id'   => null !== $meeting_id && $meeting_id > 0 ? $meeting_id : null,
						'meeting_name' => $meeting_name,
						'note'         => 'MEETING_ID' === $booking_id ? 'Replace MEETING_ID with a real meeting ID (use timetics-list-meetings to find one).' : '',
					],
					'meeting_list'   => [
						'shortcode'   => sprintf( '[timetics-meeting-list limit="%d" show_filter="%s"]', $limit, $filter_attr ),
						'description' => 'Shows a grid/list of all published meetings with an optional filter.',
					],
					'category'       => [
						'shortcode'     => sprintf( '[timetics-category id="%s"]', $category_slug ),
						'description'   => 'Shows the meetings filed under a single category.',
						'category_id'   => null !== $category_id && $category_id > 0 ? $category_id : null,
						'category_name' => $category_name,
						'note'          => 'CATEGORY_ID' === $category_slug ? 'Replace CATEGORY_ID with a real category ID (use timetics-list-meeting-categories to find one).' : '',
					],
					'user_dashboard' => [
						'shortcode'   => '[timetics-user-dashboard]',
						'description' => 'Shows the logged-in user\'s booking dashboard.',
					],
				],
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Timetics_Get_Shortcodes_Tool error', [ 'error' => $e->getMessage() ] );
			return [ 'error' => 'Failed to build shortcodes: ' . $e->getMessage() ];
		}
	}
}