<?php
/**
 * WordPress mail driver.
 *
 * @package Rahkar\WP
 */

declare( strict_types = 1 );

namespace Rahkar\WP\Notifications\Drivers\Email;

use Rahkar\WP\Contracts\Driver;
use Rahkar\WP\Notifications\Message;
use Rahkar\WP\Notifications\Result;

defined( 'ABSPATH' ) || exit;

/**
 * Delivery through `wp_mail`.
 *
 * Whatever the site already uses for email — a plain PHP mailer, an SMTP plugin,
 * a transactional service — sits behind `wp_mail`, so this driver inherits it
 * without needing to know. A store that has already configured deliverable email
 * for its WooCommerce receipts gets the same deliverability here for free.
 */
final class WpMail implements Driver {

	public const ID = 'wp_mail';

	/**
	 * {@inheritDoc}
	 */
	public function id(): string {
		return self::ID;
	}

	/**
	 * {@inheritDoc}
	 */
	public function name(): string {
		return __( 'ایمیل پیش‌فرض وردپرس', 'rahkar-toolkit' );
	}

	/**
	 * {@inheritDoc}
	 *
	 * Always true: `wp_mail` exists on every install. Whether it actually
	 * *delivers* is a different question, and one this driver cannot answer —
	 * which is what the test button on the settings screen is for.
	 */
	public function isConfigured(): bool {
		return true;
	}

	/**
	 * {@inheritDoc}
	 *
	 * @param Message $message Message to deliver.
	 */
	public function send( Message $message ): Result {
		if ( ! is_email( $message->to ) ) {
			return Result::permanent( 'invalid_recipient', __( 'نشانی ایمیل معتبر نیست.', 'rahkar-toolkit' ) );
		}

		if ( '' === trim( $message->body ) ) {
			return Result::permanent( 'empty_body', __( 'متن ایمیل خالی است.', 'rahkar-toolkit' ) );
		}

		$sent = wp_mail(
			$message->to,
			'' !== $message->subject ? $message->subject : get_bloginfo( 'name' ),
			$message->body,
			[
				'Content-Type: text/html; charset=UTF-8',
			]
		);

		if ( $sent ) {
			return Result::success();
		}

		// `wp_mail` returning false usually means the transport refused the
		// handoff — a broken SMTP host, a rejected sender. Both can recover, so
		// this is worth another attempt rather than being parked immediately.
		return Result::retryable( 'send_failed', __( 'ارسال ایمیل توسط وردپرس ناموفق بود.', 'rahkar-toolkit' ) );
	}

	/**
	 * {@inheritDoc}
	 *
	 * Nothing to configure — the site's existing mail setup is the configuration.
	 */
	public function settingsSchema(): array {
		return [];
	}
}