contracts

type Attachment struct {
	Filename    string // Name of the file
	ContentType string // MIME type of the file
	Data        []byte // File content
}

type ChatButton struct {
	ID    string // Button identifier
	Text  string // Button display text
	URL   string // Optional: URL for link buttons
	Phone string // Optional: phone number for call buttons
}

type ChatMessage struct {
	From           string            // Sender ID or phone number
	To             []string          // Recipient IDs or phone numbers
	Message        string            // Text message content
	TemplateID     string            // Optional: template ID for WhatsApp Business API
	TemplateParams []string          // Optional: template parameters
	MediaURL       string            // Optional: URL to media (image, video, document)
	MediaType      string            // Optional: "image", "video", "audio", "document"
	Buttons        []ChatButton      // Optional: interactive buttons
	ReplyToID      string            // Optional: message ID to reply to
	Metadata       map[string]string // Optional: custom metadata
}

type ChatSender interface {
	// Send sends a chat message and returns the result
	Send(ctx context.Context, message *ChatMessage) (*SendResult, error)

	// Name returns the provider name (e.g., "whatsapp", "telegram")
	Name() string
}

type Email struct {
	From        string            // Sender email address
	FromName    string            // Sender display name
	To          []string          // Recipients
	CC          []string          // Carbon copy recipients
	BCC         []string          // Blind carbon copy recipients
	ReplyTo     string            // Reply-to address
	Subject     string            // Email subject
	HTML        string            // HTML body content
	PlainText   string            // Plain text body content
	Attachments []Attachment      // File attachments
	Headers     map[string]string // Custom email headers
}

type EmailSender interface {
	// Send sends an email and returns the result
	Send(ctx context.Context, email *Email) (*SendResult, error)

	// Name returns the provider name (e.g., "mailgun", "sendgrid")
	Name() string
}

type PushNotification struct {
	DeviceTokens []string          // Target device tokens
	Title        string            // Notification title
	Body         string            // Notification body
	Data         map[string]string // Custom data payload
	Badge        *int              // Badge count (optional)
	Sound        string            // Notification sound (optional)
}

type PushSender interface {
	// Send sends a push notification and returns the result
	Send(ctx context.Context, notification *PushNotification) (*SendResult, error)

	// Name returns the provider name (e.g., "firebase", "apns")
	Name() string
}

type SMS struct {
	From    string   // Sender phone number or alphanumeric ID
	To      []string // Recipient phone numbers (E.164 format recommended)
	Message string   // SMS content (max 160 chars for single SMS)
}

type SMSSender interface {
	// Send sends an SMS and returns the result
	Send(ctx context.Context, sms *SMS) (*SendResult, error)

	// Name returns the provider name (e.g., "twilio", "cmcom")
	Name() string
}

type SendResult struct {
	ID         string            // Provider-specific message ID
	StatusCode int               // HTTP status code from the provider
	Message    string            // Human-readable status message
	Meta       map[string]string // Additional provider-specific metadata
}