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

declare(strict_types=1);

namespace Aisentic\Integrations\Timetics;

use Aisentic\Providers\Base_Service_Provider;
use Aisentic\Agent\Timetics_Prompt_Bank;
use Aisentic\Api\Models\Settings;
use Aisentic\Integrations\Timetics\PublicChat\Timetics_Available_Slots_Tool;
use Aisentic\Integrations\Timetics\PublicChat\Timetics_Booking_Link_Tool;
use Aisentic\Integrations\Timetics\PublicChat\Timetics_Manage_Links_Tool;
use Aisentic\Integrations\Timetics\PublicChat\Timetics_Public_Gateway;
use Aisentic\Integrations\Timetics\PublicChat\Timetics_Service_Search_Tool;
use Aisentic\PublicAgent\Panel_Registry;
use Aisentic\PublicAgent\Public_Agent_Settings;
use Aisentic\PublicAgent\Visitor_Timezone;

defined( 'ABSPATH' ) || exit;

/**
 * Timetics public chat service provider class
 */
class Timetics_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' );
	}

	/**
	 * Default contact message: shown to visitors, so translatable.
	 *
	 * @return string
	 */
	public static function default_contact(): string {
		return __( 'To change or cancel a booking, 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 meetings with prices, locations and staff names, and
		// the settings hold the currency and blocked days, so a change to any of
		// them refreshes the cached meeting list. A permanent delete does not
		// run save_post.
		add_action( 'save_post_timetics-appointment', [ self::class, 'flush_service_cache' ] );
		add_action( 'before_delete_post', [ $this, 'flush_on_meeting_delete' ] );
		add_action( 'update_option_timetics_settings', [ self::class, 'flush_service_cache' ] );
		add_action( 'profile_update', [ $this, 'flush_on_name_change' ], 10, 3 );
	}

	/**
	 * Refresh the meeting 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 Timetics page: a meeting page, or a post
	 * holding any Timetics shortcode.
	 *
	 * @return bool
	 */
	public function is_timetics_page(): bool {
		if ( is_singular( 'timetics-appointment' ) ) {
			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( '/\[timetics-[a-z-]+/', (string) $post->post_content );
	}

	/**
	 * Refresh the cached meeting list when a meeting is deleted.
	 *
	 * @param int $post_id Post id.
	 * @return void
	 */
	public function flush_on_meeting_delete( $post_id ): void {
		if ( 'timetics-appointment' === get_post_type( (int) $post_id ) ) {
			self::flush_service_cache();
		}
	}

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

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

	/**
	 * Describe the Timetics panel for the Public Agent settings page.
	 *
	 * @param array $panels Panels registered so far.
	 * @return array
	 */
	public function add_panel( array $panels ): array {
		$panels['timetics'] = [
			'topic'     => [
				'label'        => __( 'Book a meeting', 'aisentic' ),
				'description'  => __( 'See free times and book in a few taps', 'aisentic' ),
				'icon'         => 'calendar',
				'matches_page' => [ $this, 'is_timetics_page' ],
			],
			'label'     => __( 'Timetics', 'aisentic' ),
			'docs'      => 'https://arraytics.com/docs/wptimetics/how-to-set-up-the-ai-booking-assistant-in-wptimetics/',
			'icon'      => 'calendar',
			'available' => fn(): bool => ( new Timetics_Public_Gateway() )->is_active(),
			'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 needs to reach you, for example after too many booking-link requests in one day.', 'aisentic' ),
					'default' => self::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 Timetics 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 Timetics_Service_Search_Tool( $settings );
		$tools[] = new Timetics_Available_Slots_Tool( $settings );
		$tools[] = new Timetics_Booking_Link_Tool( $settings );
		$tools[] = new Timetics_Manage_Links_Tool( $settings );

		return $tools;
	}

	/**
	 * Append the Timetics 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" . Timetics_Prompt_Bank::get_sales_prompt(
			(string) $agent_settings->integration( 'timetics', 'outOfScopeMessage', self::default_out_of_scope() ),
			(string) $agent_settings->integration( 'timetics', 'contactMessage', self::default_contact() ),
			new \DateTimeImmutable( 'now', new \DateTimeZone( Visitor_Timezone::get() ) )
		);
	}

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

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

		return $senders;
	}

	/**
	 * Whether the Timetics panel is on and Timetics 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( 'timetics' );
	}
}