namespace Neo.Afx.WinService.Messages
{
    public interface ISmsSender
    {
        /// <summary>
        /// Gets the number of credits remaining.
        /// </summary>
        int Credits
        {
            get;
        }

        /// <summary>
        /// Sends the given message to the given cell number.
        /// </summary>
        /// <param name="message">The message to be sent.</param>
        /// <param name="cellNumber">The cell number to which the message is sent.</param>
        /// <param name="error">
        ///     When this method returns, contains the error message if
        ///     the SMS was not sent successfully; otherwise contains a null references.
        /// </param>
        /// <returns>
        /// 	<code>true</code> if successful; <code>false</code> otherwise.
        /// </returns>
        bool Send(string message, string cellNumber, out string error);
    }
}