<?php
/**
 * Sends automation notification steps through the notification dispatcher.
 *
 * @package Bookline
 */

declare( strict_types=1 );

namespace Bookline\Application\Automation;

use Bookline\Domain\Automation\ActionResult;
use Bookline\Domain\Automation\ActionStep;
use Bookline\Domain\Automation\AutomationContext;
use Bookline\Domain\Automation\AutomationRecipient;
use Bookline\Domain\Automation\SendIntent;
use Bookline\Domain\Automation\SkipReason;
use Bookline\Domain\Notification\NotificationLogEntry;
use Bookline\Domain\Notification\NotificationStatus;
use Bookline\Domain\Notification\OutboundGuard;
use Bookline\Application\Notification\NotificationDispatcher;

/**
 * Bridges automation send steps to the notification log (docs/20 §5.1).
 *
 * @since 0.1.0
 */
final class AutomationNotificationSender {

	/**
	 * Constructor.
	 *
	 * @param NotificationDispatcher $dispatcher Dispatcher.
	 */
	public function __construct(
		private readonly NotificationDispatcher $dispatcher,
	) {}

	/**
	 * Execute a notification template send.
	 *
	 * @param AutomationContext $ctx  Context.
	 * @param ActionStep        $step Step.
	 */
	public function send_template( AutomationContext $ctx, ActionStep $step ): ActionResult {
		$intent = $step->intent() ?? SendIntent::Transactional;
		if ( SendIntent::Marketing === $intent && ! $ctx->field_bool( 'marketing_consent' ) ) {
			return ActionResult::skipped( SkipReason::NoMarketingConsent );
		}

		$recipient = $step->recipient() ?? AutomationRecipient::Customer;
		if ( AutomationRecipient::Agent === $recipient && $ctx->field_int( 'agent_id' ) <= 0 ) {
			return ActionResult::skipped( SkipReason::NoRecipient );
		}

		$entry = $this->dispatcher->queue_for_automation( $ctx, $step );
		if ( ! $entry instanceof NotificationLogEntry ) {
			return ActionResult::failed( 'Could not queue notification — template missing or recipient unavailable.' );
		}

		$template = $step->config()['template_key'] ?? '';
		$rendered = sprintf(
			'%s → %s (%s)',
			is_string( $template ) ? $template : '',
			$recipient->value,
			$intent->value
		);

		$extra = [
			'notification_log_id'  => (int) $entry->id(),
			'notification_subject' => $entry->subject(),
		];

		if ( NotificationStatus::Drafted === $entry->status() || ! OutboundGuard::allows_outbound() ) {
			return ActionResult::drafted( $rendered, $extra );
		}

		return ActionResult::completed( $rendered, 1, $extra );
	}
}