gateway

type Adapter interface {
	// Name returns the platform identifier ("telegram", "discord", "slack").
	Name() string

	// Start connects to the platform and begins receiving messages.
	// Calls onMessage for each inbound message. Blocks until ctx is canceled.
	Start(ctx context.Context, onMessage func(InboundMessage)) error

	// Stop gracefully disconnects from the platform.
	Stop(ctx context.Context) error

	// Send delivers a message to a platform channel.
	Send(ctx context.Context, channelID, sender, content string) error

	// Channels returns all channels/groups the bot is a member of.
	Channels(ctx context.Context) ([]ExternalChannel, error)

	// Health returns nil if the adapter is connected and operational.
	Health(ctx context.Context) error
}

type AdapterStatus struct {
	LastMessageAt time.Time `json:"last_message_at,omitempty"`
	Error         string    `json:"error,omitempty"`
	BotName       string    `json:"bot_name,omitempty"`
	Connected     bool      `json:"connected"`
}

type Attachment struct {
	URL      string `json:"url"`
	Name     string `json:"name"`
	MimeType string `json:"mime_type"`
	Source   string `json:"source"` // "slack", "telegram", "discord", "local"
	FileID   string `json:"file_id,omitempty"`
	Size     int64  `json:"size,omitempty"`
}

type ChannelStore interface {
	SaveChannel(ctx context.Context, bcChannel, platform, platformID string) error
	LoadChannels(ctx context.Context) ([]PersistedChannel, error)
}

type ExternalChannel struct {
	ID   string
	Name string
	Type string // "group", "channel", "dm"
}

type FileSender interface {
	// SendFile uploads a file to a platform channel.
	SendFile(ctx context.Context, channelID, sender, filename string, data []byte, mimeType string) error
}

type InboundMessage struct {
	Timestamp   time.Time
	ChannelID   string
	ChannelName string
	Sender      string
	SenderID    string
	Content     string
	MessageID   string
	Attachments []Attachment
}

type Manager struct {
	// contains filtered or unexported fields
}

type PersistedChannel struct {
	BCChannel  string
	Platform   string
	PlatformID string
}

type StatusReporter interface {
	// Status returns the current connection state for UI display.
	Status() AdapterStatus
}