<?php

namespace App\Modules\TextMagic\Services;

interface TextMagicServiceInterface
{
    /**
     * Send SMS message
     */
    public function sendSMS(string $to, string $message, ?array $options = []): array;

    /**
     * Send SMS with task context
     */
    public function sendTaskSMS(int $taskId, string $to, string $message): array;

    /**
     * Send completion notification SMS
     */
    public function sendCompletionSMS(int $taskId, string $to, string $message): array;

    /**
     * Test SMS configuration
     */
    public function testSMS(string $to, string $message): array;

    /**
     * Test credentials
     */
    public function testCredentials(): array;

    /**
     * Validate phone number format
     */
    public function validatePhoneNumber(string $phoneNumber): bool;

    /**
     * Format phone number
     */
    public function formatPhoneNumber(string $phoneNumber): string;
}
