<?php
/**
 * Public PHP API of the smsportal plugin.
 *
 * @package Smsportal
 */

use Smsportal\Messages;
use Smsportal\Rules;

defined( 'ABSPATH' ) || exit;

if ( ! function_exists( 'smsportal_send_sms' ) ) {
	/**
	 * Queue an SMS. Returns at once; the message is sent in the background.
	 *
	 * Pass a stable `dedupe_key` (e.g. "my-plugin|order-123|shipped") to make repeated calls for the same
	 * event send only one SMS. Prefix the key with your plugin's name so it cannot collide with others.
	 * Without it every call gets a unique key and is always sent.
	 *
	 * @param mixed $to      Phone number (national or international format); non-scalar gives an error.
	 * @param mixed $message Message text; non-scalar gives an error.
	 * @param mixed $args    Optional array: event_label (shown in the log; a non-scalar value is ignored),
	 *                       dedupe_key (a non-scalar value gives an error), expires_hours (default 12, 0 = never expires),
	 *                       check_limits (default false; true when the number comes from a visitor, e.g. a form:
	 *                       the safety limits for customer numbers apply, see Smsportal\Limits).
	 * @return int|WP_Error ID of the log row, or an error for an invalid number or empty text.
	 */
	function smsportal_send_sms( $to, $message, $args = array() ) {
		$args  = is_array( $args ) ? $args : array();
		$hours = isset( $args['expires_hours'] ) ? absint( $args['expires_hours'] ) : Rules::DEFAULT_EXPIRES_HOURS;
		$key   = $args['dedupe_key'] ?? '';
		if ( ! is_scalar( $key ) && '' !== $key ) {
			return new WP_Error( 'smsportal_invalid_dedupe_key', __( 'The dedupe_key must be a string.', '85pl-android-sms-api' ) );
		}
		$key   = (string) $key;
		$label = $args['event_label'] ?? '';
		return Messages::enqueue(
			array(
				'recipient'    => is_scalar( $to ) ? (string) $to : '',
				'message'      => is_scalar( $message ) ? (string) $message : '',
				'event_label'  => is_scalar( $label ) ? (string) $label : '',
				'dedupe_key'   => '' === $key ? wp_generate_uuid4() : $key,
				'expires_at'   => $hours > 0 ? time() + $hours * HOUR_IN_SECONDS : null,
				'check_limits' => ! empty( $args['check_limits'] ),
			)
		);
	}
}