<?php

/**
 * Timetics Create Staff Tool
 *
 * @package Aisentic\Integrations\Timetics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Timetics;

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

defined( 'ABSPATH' ) || exit;

/**
 * Tool to add a Timetics staff member (team member). Administrator only.
 */
class Timetics_Create_Staff_Tool extends Timetics_Base_Tool implements Approvable_Tool_Contract {

	public function __construct() {
		parent::__construct(
			'timetics-create-staff',
			'Add a new Timetics staff member (team member who can host meetings). Requires a first name and ' .
			'email; last name and phone are optional. Creates a WordPress user with the staff role and emails ' .
			'them an onboarding link. Requires admin approval.'
		);
	}

	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'first_name',
				type: PropertyType::STRING,
				description: 'The staff member\'s first name.',
				required: true
			),
			new ToolProperty(
				name: 'email',
				type: PropertyType::STRING,
				description: 'The staff member\'s email address (also used as their login).',
				required: true
			),
			new ToolProperty(
				name: 'last_name',
				type: PropertyType::STRING,
				description: 'The staff member\'s last name.',
				required: false
			),
			new ToolProperty(
				name: 'phone',
				type: PropertyType::STRING,
				description: 'The staff member\'s phone number.',
				required: false
			),
		];
	}

	public function get_approval_label(): string {
		return 'Create Timetics Staff';
	}

	public function format_approval_summary(): string {
		$inputs = $this->getInputs();
		$name   = trim( (string) ( $inputs['first_name'] ?? '' ) . ' ' . (string) ( $inputs['last_name'] ?? '' ) );
		$email  = (string) ( $inputs['email'] ?? '' );

		return "Create staff member {$name} <{$email}>";
	}

	public function get_approval_inputs(): array {
		return $this->getInputs();
	}

	public function __invoke( string $first_name, string $email, ?string $last_name = null, ?string $phone = null ): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		if ( '' === trim( $first_name ) ) {
			return [ 'error' => 'first_name cannot be empty.' ];
		}
		if ( ! is_email( $email ) ) {
			return [ 'error' => 'A valid email is required.' ];
		}

		try {
			$body = [
				'first_name' => sanitize_text_field( $first_name ),
				'last_name'  => null !== $last_name ? sanitize_text_field( $last_name ) : '',
				'email'      => sanitize_email( $email ),
				'phone'      => null !== $phone ? sanitize_text_field( $phone ) : '',
			];

			$request = $this->build_request( 'POST', '/timetics/v1/staffs', [], $body );
			if ( is_array( $request ) ) {
				return $request;
			}

			$controller = \Timetics\Core\Staffs\Api_Staff::instance();
			$data       = $this->extract_response( $controller->create_item( $request ), 'Failed to create staff.' );

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

			return [
				'success'  => true,
				'staff_id' => $data['id'] ?? null,
				'staff'    => $this->shape_staff( $data ),
				'message'  => 'Staff member created successfully.',
			];
		} catch ( \Throwable $e ) {
			Log::error( 'Timetics_Create_Staff_Tool error', [ 'error' => $e->getMessage() ] );
			return [ 'error' => 'Failed to create staff: ' . $e->getMessage() ];
		}
	}
}