<?php
/**
 * IntelTele API client contract.
 *
 * @package IntelTele
 */

namespace IntelTele\Api;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

interface ClientInterface {
	/**
	 * Get account balance.
	 */
	public function get_balance(): ApiResult;

	/**
	 * Send SMS.
	 *
	 * @param string   $message Message text.
	 * @param string[] $phones Recipient phones.
	 * @param array<string,mixed> $options Extra options.
	 */
	public function send_sms( string $message, array $phones, array $options = array() ): ApiResult;

	/**
	 * Send Viber.
	 *
	 * @param string   $message Message text.
	 * @param string[] $phones Recipient phones.
	 * @param array<string,mixed> $options Extra options.
	 */
	public function send_viber( string $message, array $phones, array $options = array() ): ApiResult;

	/**
	 * Get SMS statuses.
	 *
	 * @param string[] $message_ids Message IDs.
	 */
	public function get_sms_statuses( array $message_ids ): ApiResult;

	/**
	 * Get Viber statuses.
	 *
	 * @param string[] $message_ids Message IDs.
	 */
	public function get_viber_statuses( array $message_ids ): ApiResult;
}