<?php
/**
 * Booktics Public Service Provider
 *
 * Wires the Booktics public-chat tools, prompt, settings panel and manage-links
 * sender into the Public Chat agent. The admin-side wiring lives in
 * Booktics_Tools_Hooks and is untouched.
 *
 * @package Aisentic\Integrations\Booktics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Booktics;

use Aisentic\Providers\Base_Service_Provider;
use Aisentic\Agent\Booktics_Prompt_Bank;
use Aisentic\Api\Models\Settings;
use Aisentic\Integrations\Booktics\PublicChat\Booktics_Available_Slots_Tool;
use Aisentic\Integrations\Booktics\PublicChat\Booktics_Booking_Link_Tool;
use Aisentic\Integrations\Booktics\PublicChat\Booktics_Manage_Links_Tool;
use Aisentic\Integrations\Booktics\PublicChat\Booktics_Service_Search_Tool;
use Aisentic\PublicAgent\Panel_Registry;
use Aisentic\PublicAgent\Public_Agent_Settings;

defined( 'ABSPATH' ) || exit;

/**
 * Booktics public chat service provider class
 */
class Booktics_Public_Service_Provider extends Base_Service_Provider {

	/**
	 * Default out-of-scope message: shown to visitors, so translatable.
	 *
	 * @return string
	 */
	public static function default_out_of_scope(): string {
		return __( 'I can help you find services and book a time. For payments, refunds or account help, please contact us.', 'aisentic' );
	}

	/**
	 * Register hooks
	 *
	 * @return void
	 */
	public function register(): void {
		parent::register();
		// phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.DynamicHooknameFound -- Panel_Registry::FILTER is the literal 'aisentic_public_agent_panels'.
		add_filter( Panel_Registry::FILTER, [ $this, 'add_panel' ] );
		add_filter( 'aisentic_public_chat_tools', [ $this, 'add_tools' ], 10, 2 );
		add_filter( 'aisentic_public_chat_instructions', [ $this, 'add_instructions' ], 10, 2 );
		add_filter( 'aisentic_manage_links_senders', [ $this, 'add_sender' ] );

		// The chat shows services with their extras, branches, prices and staff
		// names, so a change to any of them refreshes the cached service list.
		// Saving or trashing runs save_post; a permanent delete does not.
		add_action( 'save_post_booktics-service', [ self::class, 'flush_service_cache' ] );
		add_action( 'save_post_booktics-ex-service', [ self::class, 'flush_service_cache' ] );
		add_action( 'save_post_booktics-location', [ self::class, 'flush_service_cache' ] );
		add_action( 'before_delete_post', [ $this, 'flush_on_service_delete' ] );
		add_action( 'update_option_booktics_options', [ self::class, 'flush_service_cache' ] );
		add_action( 'profile_update', [ $this, 'flush_on_name_change' ], 10, 3 );
	}

	/**
	 * Refresh the service list when a user's display name changes. Only staff
	 * names show in the chat, and on a shop every customer save fires
	 * profile_update.
	 *
	 * @param int        $user_id  User id.
	 * @param mixed      $old_user User before the save (WP_User).
	 * @param array|null $userdata Data saved (WordPress 5.8+).
	 * @return void
	 */
	public function flush_on_name_change( $user_id, $old_user = null, $userdata = null ): void {
		// Without both sides the change is unknown, so refresh to be safe.
		if ( ! isset( $old_user->display_name, $userdata['display_name'] ) || $old_user->display_name !== $userdata['display_name'] ) {
			self::flush_service_cache();
		}
	}

	/**
	 * Whether the current page is a Booktics page: a service page, or a post
	 * holding any Booktics shortcode or block.
	 *
	 * @return bool
	 */
	public function is_booktics_page(): bool {
		if ( is_singular( 'booktics-service' ) ) {
			return true;
		}

		// On a blog list or archive get_post() is the first post in the loop,
		// not the page the visitor is on.
		if ( ! is_singular() ) {
			return false;
		}

		$post = get_post();
		if ( ! $post instanceof \WP_Post ) {
			return false;
		}

		return 1 === preg_match( '/\[booktics_[a-z_]+|<!-- wp:booktics\//', (string) $post->post_content );
	}

	/**
	 * Refresh the cached service list when a service, extra or branch is deleted.
	 *
	 * @param int $post_id Post id.
	 * @return void
	 */
	public function flush_on_service_delete( $post_id ): void {
		if ( in_array( get_post_type( (int) $post_id ), [ 'booktics-service', 'booktics-ex-service', 'booktics-location' ], true ) ) {
			self::flush_service_cache();
		}
	}

	/**
	 * Make every cached Booktics service search stale.
	 *
	 * @return void
	 */
	public static function flush_service_cache(): void {
		update_option( Booktics_Service_Search_Tool::CACHE_GENERATION, (int) get_option( Booktics_Service_Search_Tool::CACHE_GENERATION, 0 ) + 1, false );
	}

	/**
	 * Get services
	 *
	 * @return array
	 */
	public function get_services(): array {
		return [];
	}

	/**
	 * Describe the Booktics panel for the Public Agent settings page.
	 *
	 * @param array $panels Panels registered so far.
	 * @return array
	 */
	public function add_panel( array $panels ): array {
		$panels['booktics'] = [
			'topic'     => [
				'label'        => __( 'Book appointment', 'aisentic' ),
				'description'  => __( 'See free times and book in a few taps', 'aisentic' ),
				'icon'         => 'calendar',
				'matches_page' => [ $this, 'is_booktics_page' ],
			],
			'label'     => __( 'Booktics', 'aisentic' ),
			'docs'      => 'https://arraytics.com/docs/booktics/how-to-set-up-the-ai-booking-assistant-in-booktics/',
			'icon'      => 'calendar',
			'available' => fn(): bool => function_exists( 'booktics' ),
			'fields'    => [
				'recommendedLimit'  => [
					'type'    => 'number',
					'label'   => __( 'Services Shown', 'aisentic' ),
					'help'    => __( 'Maximum number of services the assistant shows per search.', 'aisentic' ),
					'min'     => 1,
					'max'     => 12,
					'default' => 4,
				],
				'contactMessage'    => [
					'type'    => 'textarea',
					'label'   => __( 'Contact Message', 'aisentic' ),
					'help'    => __( 'Shown when a visitor wants to change or cancel a booking but online changes are turned off in Booktics.', 'aisentic' ),
					'default' => Booktics_Manage_Links_Tool::default_contact(),
				],
				'outOfScopeMessage' => [
					'type'    => 'textarea',
					'label'   => __( 'Out of Scope Message', 'aisentic' ),
					'help'    => __( 'Shown when a visitor asks something outside the assistant\'s scope, such as a payment or a refund.', 'aisentic' ),
					'default' => self::default_out_of_scope(),
				],
				'starterPrompts'    => [
					'type'     => 'prompts',
					'label'    => __( 'Starter Prompts', 'aisentic' ),
					'help'     => __( 'Quick-reply chips shown when the chat opens.', 'aisentic' ),
					'max'      => 8,
					'maxChars' => 100,
					'default'  => [
						__( 'What services do you offer?', 'aisentic' ),
						__( 'Any free times this week?', 'aisentic' ),
						__( 'How much is a consultation?', 'aisentic' ),
						__( 'I need to change my booking', 'aisentic' ),
					],
				],
			],
		];

		return $panels;
	}

	/**
	 * Add the Booktics tools to the public chat toolset
	 *
	 * @param array    $tools    Existing tools.
	 * @param Settings $settings Settings instance.
	 * @return array
	 */
	public function add_tools( array $tools, Settings $settings ): array {
		if ( ! $this->is_enabled( $settings ) ) {
			return $tools;
		}

		$tools[] = new Booktics_Service_Search_Tool( $settings );
		$tools[] = new Booktics_Available_Slots_Tool( $settings );
		$tools[] = new Booktics_Booking_Link_Tool( $settings );
		$tools[] = new Booktics_Manage_Links_Tool( $settings );

		return $tools;
	}

	/**
	 * Append the Booktics booking prompt to the public chat instructions
	 *
	 * @param string   $prompt   Existing prompt.
	 * @param Settings $settings Settings instance.
	 * @return string
	 */
	public function add_instructions( string $prompt, Settings $settings ): string {
		if ( ! $this->is_enabled( $settings ) ) {
			return $prompt;
		}

		$agent_settings = new Public_Agent_Settings( $settings );

		return $prompt . "\n\n" . Booktics_Prompt_Bank::get_sales_prompt(
			(string) $agent_settings->integration( 'booktics', 'outOfScopeMessage', self::default_out_of_scope() ),
			(string) $agent_settings->integration( 'booktics', 'contactMessage', Booktics_Manage_Links_Tool::default_contact() )
		);
	}

	/**
	 * Let the shared manage-links endpoint reach Booktics.
	 *
	 * @param array $senders Senders by plugin slug.
	 * @return array
	 */
	public function add_sender( array $senders ): array {
		// No sender while the Booktics chat is off, so the public endpoint cannot
		// send Booktics emails on a site that only uses another integration.
		if ( ! $this->is_enabled( new Settings() ) ) {
			return $senders;
		}

		$senders['booktics'] = static function ( string $email, array $hint ): void {
			// phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Booktics' own action; Booktics emails the links.
			do_action( 'booktics_send_manage_links', $email, $hint );
		};

		return $senders;
	}

	/**
	 * Whether the Booktics panel is on and Booktics is active.
	 *
	 * @param Settings $settings Settings instance.
	 * @return bool
	 */
	private function is_enabled( Settings $settings ): bool {
		// is_enabled() already checks the panel's `available` callback.
		return ( new Public_Agent_Settings( $settings ) )->is_enabled( 'booktics' );
	}
}