tg/session.go

package tg

// The type represents map of sessions using
// as key.
type SessionMap map[SessionId]*Session

// Add new empty session by it's ID.
func (sm SessionMap) Add(
	bot *Bot,
	sid SessionId,
	scope SessionScope,
) *Session {
	ret := NewSession(bot, sid, scope)
	sm[sid] = ret
	return ret
}

// The way to determine where the context is
// related to.
type SessionScope uint8
const (
	NoSessionScope SessionScope = iota
	PrivateSessionScope
	GroupSessionScope
	ChannelSessionScope
)

// Represents unique value to identify chats.
// In fact is simply ID of the chat.
type SessionId int64

// Convert the SessionId to Telegram API's type.
func (si SessionId) ToApi() int64 {
	return int64(si)
}

// The type represents current state of
// user interaction per each of them.
type Session struct {
	// Id of the chat of the user.
	Id SessionId
	Scope SessionScope
	// Custom value for each user.
	Data  any

	bot *Bot
	pathHistory []Path
	skippedUpdates *UpdateChan
	updates *UpdateChan
}

// Return new empty session.
func NewSession(bot *Bot, id SessionId, scope SessionScope) *Session {
	ret := &Session{}
	ret.Id = id
	ret.Scope = scope
	ret.bot = bot
	ret.updates = NewUpdateChan()
	ret.skippedUpdates = NewUpdateChan()
	return ret
}