<?php
/**
 * Uncanny Automator: action "Send SMS (smsportal)" with a number and a text.
 *
 * Choice (plan rule: the automation plugin with more active installs, wordpress.org API, 2026-10-30):
 * Uncanny Automator (slug uncanny-automator) 40,000+ vs AutomatorWP (automatorwp) 6,000+.
 *
 * Registered the way Automator documents for third-party integrations: on its automator_add_integration
 * hook, an \Uncanny_Automator\Integration subclass loads an \Uncanny_Automator\Recipe\Action subclass.
 * Those two classes extend Automator's and live in Automator/, loaded only from that hook, so nothing of
 * them runs (or is even read) when Automator is not active.
 *
 * @package Smsportal
 */

namespace Smsportal\Integrations;

use Smsportal\Integrations\Automator\Integration;
use Smsportal\Messages;
use WP_Error;

defined( 'ABSPATH' ) || exit;

/**
 * Glue between Uncanny Automator recipes and smsportal_send_sms().
 */
class Automator {

	const INTEGRATION_CODE = 'SMSPORTAL';
	const ACTION_CODE      = 'SMSPORTAL_SEND_SMS';
	const FIELD_PHONE      = 'SMSPORTAL_PHONE';
	const FIELD_MESSAGE    = 'SMSPORTAL_MESSAGE';

	/**
	 * Whether Uncanny Automator is active.
	 *
	 * @return bool
	 */
	public static function available(): bool {
		return defined( 'AUTOMATOR_PLUGIN_VERSION' ) && class_exists( '\Uncanny_Automator\Integration' )
			&& class_exists( '\Uncanny_Automator\Recipe\Action' );
	}

	/**
	 * Register hooks.
	 *
	 * @return void
	 */
	public static function register(): void {
		add_action( 'automator_add_integration', array( self::class, 'add_integration' ) );
	}

	/**
	 * Hook: Automator collects integrations.
	 *
	 * @return void
	 */
	public static function add_integration(): void {
		new Integration();
	}

	/**
	 * Queue the SMS of one action run. The same run (recipe log, action, number, text) sends once, also when
	 * Automator runs it again.
	 *
	 * @param mixed               $to          Number from the action.
	 * @param mixed               $message     Text from the action.
	 * @param array<string,mixed> $action_data Automator's action data (ID, recipe_log_id).
	 * @return int|WP_Error Log row ID or the reason it was not queued.
	 */
	public static function send( $to, $message, array $action_data ) {
		$to      = is_scalar( $to ) ? trim( (string) $to ) : '';
		$message = is_scalar( $message ) ? trim( wp_strip_all_tags( (string) $message ) ) : '';
		// The number usually comes from a token (a form, a new user, an order): a visitor controls it.
		$args = array(
			'event_label'  => __( 'Uncanny Automator: Send SMS', '85pl-android-sms-api' ),
			'check_limits' => true,
		);
		$log_id  = absint( $action_data['recipe_log_id'] ?? 0 );
		if ( $log_id > 0 ) {
			$args['dedupe_key'] = implode( '|', array( 'uncanny-automator', $log_id, absint( $action_data['ID'] ?? 0 ), md5( $to . '|' . $message ) ) );
		}
		$result = smsportal_send_sms( $to, $message, $args );
		$row    = is_int( $result ) ? Messages::get( $result ) : null;
		if ( null !== $row && 'rate_limited' === $row['status'] ) {
			// Shown in the recipe log; the SMS row stays under Sent with the same reason.
			return new WP_Error( 'smsportal_rate_limited', (string) $row['error'] );
		}
		return $result;
	}
}