<?php

/**
 * WpCafe Create Discount Tool
 *
 * @package Aisentic\Integrations\WpCafe
 */

declare(strict_types=1);

namespace Aisentic\Integrations\WpCafe;

use NeuronAI\Tools\ToolProperty;
use NeuronAI\Tools\PropertyType;
use Aisentic\Contracts\Approvable_Tool_Contract;
use Aisentic\Integrations\WpCafe\Wpcafe_Discount_Base_Tool;
use Aisentic\Util\Log;

defined( 'ABSPATH' ) || exit;

/**
 * Tool to create a new WpCafe discount or promotional code.
 * Requires admin approval before execution.
 */
class Wpcafe_Create_Discount_Tool extends Wpcafe_Discount_Base_Tool implements Approvable_Tool_Contract {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'wpcafe-create-discount',
			'Create a new WpCafe discount code or promotion. Supports percentage, fixed, and standard types. ' .
			'Optionally restrict to specific products or categories. Supports time-based rules: on_date, date_range, ' .
			'time_range (happy-hour style), and day_of_week. discount_title acts as the coupon code customers enter. ' .
			'Requires admin approval. Requires WpCafe Pro and the Discount module to be enabled.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'discount_title',
				type: PropertyType::STRING,
				description: 'The discount code customers enter (e.g. "SUMMER20"). Must be unique.',
				required: true
			),
			new ToolProperty(
				name: 'discount_type',
				type: PropertyType::STRING,
				description: 'Discount type: "percentage" (% off), "fixed_amount" (flat amount off), or "standard" (same as fixed_amount).',
				required: true,
				enum: [ 'percentage', 'fixed_amount', 'standard' ]
			),
			new ToolProperty(
				name: 'discount_amount',
				type: PropertyType::NUMBER,
				description: 'Discount value. For percentage type: 1–100. For fixed/standard: any positive number.',
				required: true
			),
			new ToolProperty(
				name: 'discount_status',
				type: PropertyType::STRING,
				description: 'Whether the discount is "active" (customers can use it) or "inactive" (disabled). Defaults to "inactive".',
				required: false,
				enum: [ 'active', 'inactive' ]
			),
			new ToolProperty(
				name: 'is_active',
				type: PropertyType::BOOLEAN,
				description: 'Whether the discount code is active for customer-facing lookup. Defaults to true.',
				required: false
			),
			new ToolProperty(
				name: 'product_rule_type',
				type: PropertyType::STRING,
				description: 'Which products the discount applies to: "all_products" (default), "specific_products", or "specific_categories".',
				required: false,
				enum: [ 'all_products', 'specific_products', 'specific_categories' ]
			),
			new ToolProperty(
				name: 'specific_products',
				type: PropertyType::ARRAY,
				description: 'Array of WooCommerce product IDs the discount applies to. Required when product_rule_type is "specific_products".',
				required: false
			),
			new ToolProperty(
				name: 'excluded_products',
				type: PropertyType::ARRAY,
				description: 'Array of WooCommerce product IDs to exclude when product_rule_type is "all_products".',
				required: false
			),
			new ToolProperty(
				name: 'specific_categories',
				type: PropertyType::ARRAY,
				description: 'Array of WooCommerce category IDs the discount applies to. Required when product_rule_type is "specific_categories".',
				required: false
			),
			new ToolProperty(
				name: 'addon_discount_applicable',
				type: PropertyType::STRING,
				description: 'What the discount applies to: "total_amount" (default, entire cart) or "addons_total_amount" (addons only).',
				required: false,
				enum: [ 'total_amount', 'addons_total_amount' ]
			),
			new ToolProperty(
				name: 'date_rule_type',
				type: PropertyType::STRING,
				description: 'Time-based rule type. "on_date": valid on one date. "date_range": valid between two dates. ' .
							'"time_range": valid within a daily time window (happy-hour). "day_of_week": valid on specific days.',
				required: false,
				enum: [ 'on_date', 'date_range', 'time_range', 'day_of_week' ]
			),
			new ToolProperty(
				name: 'date_rule_date',
				type: PropertyType::STRING,
				description: 'Exact date the discount is valid (Y-m-d). Required when date_rule_type is "on_date".',
				required: false
			),
			new ToolProperty(
				name: 'date_rule_start_date',
				type: PropertyType::STRING,
				description: 'Start date of the valid range (Y-m-d). Required when date_rule_type is "date_range".',
				required: false
			),
			new ToolProperty(
				name: 'date_rule_end_date',
				type: PropertyType::STRING,
				description: 'End date of the valid range (Y-m-d). Required when date_rule_type is "date_range".',
				required: false
			),
			new ToolProperty(
				name: 'date_rule_start_time',
				type: PropertyType::STRING,
				description: 'Daily start time in HH:MM (24-hour) format. Required when date_rule_type is "time_range".',
				required: false
			),
			new ToolProperty(
				name: 'date_rule_end_time',
				type: PropertyType::STRING,
				description: 'Daily end time in HH:MM (24-hour) format. Required when date_rule_type is "time_range".',
				required: false
			),
			new ToolProperty(
				name: 'date_rule_days',
				type: PropertyType::ARRAY,
				description: 'Days of the week the discount is valid. Use PHP short names: Mon, Tue, Wed, Thu, Fri, Sat, Sun. Required when date_rule_type is "day_of_week".',
				required: false
			),
		];
	}

	/**
	 * Human-readable label for the approval card header.
	 *
	 * @return string
	 */
	public function get_approval_label(): string {
		return 'Create WpCafe Discount';
	}

	/**
	 * One-line summary of what this invocation will do.
	 *
	 * @return string
	 */
	public function format_approval_summary(): string {
		$inputs = $this->getInputs();
		$title  = $inputs['discount_title'] ?? '?';
		$type   = $inputs['discount_type'] ?? '';
		$amount = $inputs['discount_amount'] ?? '';
		$suffix = 'percentage' === $type ? '%' : '';
		$status = $inputs['discount_status'] ?? 'inactive';

		return "Create discount \"{$title}\" — {$amount}{$suffix} {$type} (status: {$status})";
	}

	/**
	 * Human-readable version of tool inputs for the approval card.
	 *
	 * @return array
	 */
	public function get_approval_inputs(): array {
		return $this->getInputs();
	}

	/**
	 * Execute the tool
	 *
	 * @param string      $discount_title          Discount code / title.
	 * @param string      $discount_type           Discount type (percentage|fixed_amount|standard).
	 * @param float       $discount_amount         Discount value.
	 * @param string|null $discount_status         Active status (active|inactive).
	 * @param bool|null   $is_active               Customer-facing active flag.
	 * @param string|null $product_rule_type       Product scope type.
	 * @param array|null  $specific_products       Product IDs for specific_products scope.
	 * @param array|null  $excluded_products       Product IDs to exclude from all_products scope.
	 * @param array|null  $specific_categories     Category IDs for specific_categories scope.
	 * @param string|null $addon_discount_applicable What the discount is applied to.
	 * @param string|null $date_rule_type          Date/time rule type.
	 * @param string|null $date_rule_date          Exact date (Y-m-d) for on_date rule.
	 * @param string|null $date_rule_start_date    Start date (Y-m-d) for date_range rule.
	 * @param string|null $date_rule_end_date      End date (Y-m-d) for date_range rule.
	 * @param string|null $date_rule_start_time    Start time (HH:MM) for time_range rule.
	 * @param string|null $date_rule_end_time      End time (HH:MM) for time_range rule.
	 * @param array|null  $date_rule_days          Day abbreviations for day_of_week rule.
	 * @return array
	 */
	public function __invoke(
		string $discount_title,
		string $discount_type,
		float $discount_amount,
		?string $discount_status = null,
		?bool $is_active = null,
		?string $product_rule_type = null,
		?array $specific_products = null,
		?array $excluded_products = null,
		?array $specific_categories = null,
		?string $addon_discount_applicable = null,
		?string $date_rule_type = null,
		?string $date_rule_date = null,
		?string $date_rule_start_date = null,
		?string $date_rule_end_date = null,
		?string $date_rule_start_time = null,
		?string $date_rule_end_time = null,
		?array $date_rule_days = null
	): array {
		$check = $this->guard( 'manage_options' );
		if ( $check ) {
			return $check;
		}

		$check = $this->guard_discount_pro();
		if ( $check ) {
			return $check;
		}

		$check = $this->validate_discount_fields( $discount_title, $discount_type, $discount_amount, $discount_status, $addon_discount_applicable );
		if ( null !== $check ) {
			return $check;
		}

		try {
			$data = [
				'discount_title'            => sanitize_text_field( $discount_title ),
				'discount_type'             => $discount_type,
				'discount_amount'           => $discount_amount,
				'discount_status'           => $discount_status ?? 'inactive',
				'is_active'                 => $is_active ?? true,
				'addon_discount_applicable' => $addon_discount_applicable ?? 'total_amount',
				'product_rule'              => $this->build_product_rule( $product_rule_type, $specific_products, $excluded_products, $specific_categories ),
				'date_rule'                 => $this->build_date_rule( $date_rule_type, $date_rule_date, $date_rule_start_date, $date_rule_end_date, $date_rule_start_time, $date_rule_end_time, $date_rule_days ),
			];

			$discount = \WpCafePro\Models\Discount_Model::create( $data );

			if ( ! $discount ) {
				return [ 'error' => 'Failed to create discount. The database insert did not return a valid record.' ];
			}

			return [
				'success'        => true,
				'discount_id'    => $discount->id,
				'discount_title' => $discount->discount_title,
				'message'        => "Discount \"{$discount_title}\" created successfully (ID: {$discount->id}).",
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Wpcafe_Create_Discount_Tool error', [ 'error' => $e->getMessage() ] );
			return [ 'error' => 'Failed to create discount: ' . $e->getMessage() ];
		}
	}

	/**
	 * Validate required and optional discount fields before writing to the model.
	 *
	 * @param string      $title      Discount title/code.
	 * @param string      $type       Discount type.
	 * @param float       $amount     Discount amount.
	 * @param string|null $status     Discount status.
	 * @param string|null $applicable Addon applicable setting.
	 * @return array|null Error array on failure, null on success.
	 */
	private function validate_discount_fields( string $title, string $type, float $amount, ?string $status, ?string $applicable ): ?array {
		if ( '' === trim( $title ) ) {
			return [ 'error' => 'discount_title is required and cannot be empty.' ];
		}

		$check = $this->validate_discount_type( $type );
		if ( null !== $check ) {
			return $check;
		}

		if ( $amount <= 0 ) {
			return [ 'error' => 'discount_amount must be greater than 0.' ];
		}

		if ( 'percentage' === $type && $amount > 100 ) {
			return [ 'error' => 'Percentage discount_amount cannot exceed 100.' ];
		}

		if ( null !== $status ) {
			$check = $this->validate_discount_status( $status );
			if ( null !== $check ) {
				return $check;
			}
		}

		if ( null !== $applicable ) {
			$check = $this->validate_addon_applicable( $applicable );
			if ( null !== $check ) {
				return $check;
			}
		}

		return null;
	}
}