base

type APIClients struct {
	// Bible API client.
	Bible *bible.Client
	// IVR API client.
	IVR *ivr.Client
	// Kick API client.
	Kick *kick.Client
	// Pastebin FetchPaste URL override.
	// If set, this will override whatever the user enters.
	// Therefore, it should only be set in test.
	PastebinFetchPasteURLOverride string
	// 7TV API client.
	SevenTV *seventv.Client
}

type IncomingMessage struct {
	// Message is the message.
	Message Message
	// Prefix is the prefix for the channel the message was sent in.
	Prefix string
	// PermissionLevel is the permission level of the user that sent the message.
	PermissionLevel permission.Level
	// Resources contains resources available to an incoming message.
	Resources Resources
}

type Message struct {
	// Text contains the text of the message.
	Text string
	// Channel represents the channel the message was sent in
	// (or should be sent in).
	Channel string
	// ID is the unique ID of the message, as provided by the platform.
	// This may not be set - some platforms do not provide an ID.
	ID string
	// UserID is the unique ID of the user that sent the message.
	UserID string
	// User is the username of the user that sent the message.
	User string
	// Time is when the message was sent.
	Time time.Time
}

type OutgoingMessage struct {
	// Message is the message.
	Message
	// ReplyToID is the ID of the message being replied to.
	// This field is only set if:
	//   1. The platform provides IDs for individual messages
	//   2. The platform supports replying to messages
	//   3. The message is a reply to another message
	ReplyToID string
}

type Platform interface {
	// Name returns the platform's name.
	Name() string
	// Username returns the bot's username within the platform.
	Username() string

	// Connect connects to the platform.
	Connect(ctx context.Context) error
	// Disconnect disconnects from the platform and should be called before exiting.
	Disconnect() error

	// Listen returns a channel that will provide incoming messages.
	Listen() <-chan IncomingMessage
	// Send sends a message.
	Send(m Message) error
	// Reply sends a message in reply to another message.
	Reply(m Message, replyToID string) error

	// Join joins a channel.
	Join(channel, prefix string) error
	// Leave leaves a channel.
	Leave(channel string) error
	// SetPrefix sets the prefix for a channel.
	SetPrefix(channel, prefix string) error

	// User returns the (database) user for the username of a user on the platform.
	// It will return ErrUserUnknown if the user has never been seen by the bot.
	User(username string) (models.User, error)
	// CurrentUsers returns the names of the current users in all channels the bot has joined.
	CurrentUsers() ([]string, error)

	// Timeout times out a user in a channel.
	Timeout(username, channel string, duration time.Duration) error
}

type RandResources struct {
	// Reader will be used as the reader for random values.
	Reader io.Reader
	// Source is a source of random numbers.
	// Optional - a default will be used if not provided.
	Source rand.Source
}

type Resources struct {
	// Platform is the current platform.
	Platform Platform
	// DB is a reference to the database.
	DB *gorm.DB
	// Cache is a reference to the cache.
	Cache cache.Cache
	// AllPlatforms contains all platforms currently registered with the bot.
	AllPlatforms map[string]Platform
	// NewConfigSource is a function that returns a source of data
	// for the latest config.
	NewConfigSource func() (io.ReadCloser, error)
	// Rand is a reference to random sources.
	Rand RandResources
	// Clients contains API clients.
	Clients APIClients
}