telegram

type Command ¶ added in v1.15.16

type Command struct {
	Command     string
	Description string
}

Command describes one entry of the bot's command menu. It mirrors Telegram's BotCommand without binding this package to the bot library.

func AdminCommands() []Command

func PublicCommands() []Command

type TelegramAdmin ¶

type TelegramAdmin struct {
	logger.Logger
	// contains filtered or unexported fields
}

TelegramAdmin handles administrative Telegram commands independently from the general Telegram bot flow.

func NewTelegramAdmin(ctx context.Context, deps TelegramAdminDependencies) *TelegramAdmin

func (a *TelegramAdmin) Handle(msg *tgbotapi.Message)

type TelegramAdminActionStore ¶

type TelegramAdminActionStore interface {
	Get(ctx context.Context, key string) (string, error)
	Set(ctx context.Context, key, value string, ttl time.Duration) error
	Delete(ctx context.Context, key string) error
}

TelegramAdminActionStore persists short-lived confirmations for destructive administrator commands.

type TelegramAdminDependencies ¶

type TelegramAdminDependencies struct {
	Messenger TelegramMessenger
	// Commands publishes the administrator command menu; optional so tests
	// and deployments without a live bot still work.
	Commands      TelegramCommandRegistrar
	Actions       TelegramAdminActionStore
	Tickets       repository.TicketRepo
	Orders        repository.OrderRepo
	Users         repository.UserRepo
	UserAuth      repository.UserAuthRepo
	Subscriptions repository.UserSubscriptionRepo
	UserCache     repository.UserCacheRepo
	Plans         repository.SubscribeRepo
	Logs          repository.LogRepo
	// Wallet is the billing-domain read port for balance display.
	Wallet repository.WalletRepo
}

TelegramAdminDependencies contains only the collaborators used by Telegram administrator commands. It intentionally does not accept ServiceContext.

type TelegramAdminHandler ¶

type TelegramAdminHandler interface {
	Handle(msg *tgbotapi.Message)
}

TelegramAdminHandler handles administrator Telegram commands.

type TelegramCommandRegistrar ¶ added in v1.15.16

type TelegramCommandRegistrar interface {
	SetCommands(chatID int64, commands []Command) error
}

TelegramCommandRegistrar publishes the command menu Telegram shows in the message composer. A zero chatID addresses the default scope, which every user sees; a non-zero chatID scopes the menu to that chat.

func NewTelegramBotCommandRegistrar(bot *tgbotapi.BotAPI) TelegramCommandRegistrar

type TelegramLogic ¶

type TelegramLogic struct {
	logger.Logger
	// contains filtered or unexported fields
}

func NewTelegramLogic(ctx context.Context, deps TelegramLogicDependencies) *TelegramLogic

func (l *TelegramLogic) TelegramLogic(req *tgbotapi.Update)

type TelegramLogicDependencies ¶

type TelegramLogicDependencies struct {
	Messenger TelegramMessenger
	Sessions  TelegramSessionStore
	UserAuth  repository.UserAuthRepo
	UserCache repository.UserCacheRepo
	Admin     TelegramAdminHandler
}

TelegramLogicDependencies explicitly declares the collaborators used by general Telegram command dispatch and account binding.

type TelegramMessenger ¶

type TelegramMessenger interface {
	Send(chatID int64, message string) error
}

TelegramMessenger sends a response to a Telegram chat.

func NewTelegramBotMessenger(bot *tgbotapi.BotAPI) TelegramMessenger

type TelegramRedisStore ¶

type TelegramRedisStore interface {
	TelegramSessionStore
	TelegramAdminActionStore
}

TelegramRedisStore supports both account-binding sessions and administrator command confirmations.

func NewTelegramRedisStore(client *redis.Client) TelegramRedisStore

type TelegramSessionStore ¶

type TelegramSessionStore interface {
	Get(ctx context.Context, key string) (string, error)
	Delete(ctx context.Context, key string) error
}

TelegramSessionStore reads and consumes short-lived account-binding tokens. Deleting the token on a successful bind is what makes the deep link single-use.