tgb

Apr 29, 2024

Changes in this version

+ type BusinessConnectionHandler func(context.Context, *BusinessConnectionUpdate) error

+ func (handler BusinessConnectionHandler) Handle(ctx context.Context, update *Update) error

+ type BusinessConnectionUpdate struct

+ Client *tg.Client

+ Update *Update

+ type DeletedBusinessMessageHandler func(context.Context, *DeletedBusinessMessagesUpdate) error

+ func (handler DeletedBusinessMessageHandler) Handle(ctx context.Context, update *Update) error

+ type DeletedBusinessMessagesUpdate struct

+ Client *tg.Client

+ Update *Update

type Router

+ func (bot *Router) BusinessConnection(handler BusinessConnectionHandler, filters ...Filter) *Router

+ func (bot *Router) BusinessMessage(handler MessageHandler, filters ...Filter) *Router

+ func (bot *Router) DeletedBusinessMessages(handler DeletedBusinessMessageHandler, filters ...Filter) *Router

+ func (bot *Router) EditedBusinessMessage(handler MessageHandler, filters ...Filter) *Router

Mar 13, 2024

Changes in this version

+ var DefaultCallbackDataCodec = NewCallackDataCodec()

+ func DecodeCallbackData(data string, dst any) error

+ func EncodeCallbackData(src any) (string, error)

+ type CallbackDataCodec struct

+ func NewCallackDataCodec(opts ...CallbackDataCodecOption) *CallbackDataCodec

+ func (p *CallbackDataCodec) Decode(data string, dst any) error

+ func (p *CallbackDataCodec) Encode(src any) (string, error)

+ type CallbackDataCodecOption func(*CallbackDataCodec)

+ func WithCallbackDataCodecDelimiter(delimiter rune) CallbackDataCodecOption

+ func WithCallbackDataCodecDisableLengthCheck(disable bool) CallbackDataCodecOption

+ func WithCallbackDataCodecFloatFmt(fmt byte) CallbackDataCodecOption

+ func WithCallbackDataCodecFloatPrec(prec int) CallbackDataCodecOption

+ func WithCallbackDataCodecIntBase(base int) CallbackDataCodecOption

+ type CallbackDataFilter struct

+ func NewCallbackDataFilter[T any](prefix string, opts ...CallbackDataCodecOption) *CallbackDataFilter[T]

+ func (p *CallbackDataFilter[T]) Button(text string, v T) (tg.InlineKeyboardButton, error)

+ func (p *CallbackDataFilter[T]) Decode(data string) (T, error)

+ func (p *CallbackDataFilter[T]) Encode(src T) (string, error)

+ func (p *CallbackDataFilter[T]) Filter() Filter

+ func (p *CallbackDataFilter[T]) FilterFunc(check func(v T) bool) Filter

+ func (p *CallbackDataFilter[T]) Handler(handler CallbackDataFilterHandler[T]) CallbackQueryHandler

+ func (p *CallbackDataFilter[T]) MustButton(text string, v T) tg.InlineKeyboardButton

+ type CallbackDataFilterHandler func(ctx context.Context, cbq *CallbackQueryUpdate, cbd T) error

+ type CallbackDataIsTooLongError struct

+ Length int

+ func (e *CallbackDataIsTooLongError) Error() string

type MessageUpdate

+ func (msg *MessageUpdate) React(reactions ...tg.ReactionType) *tg.SetMessageReactionCall

+ type TextMessageCallBuilder struct

+ func NewTextMessageCallBuilder(text string) *TextMessageCallBuilder

+ func (b *TextMessageCallBuilder) AsEditReplyMarkup(peer tg.PeerID, id int) *tg.EditMessageReplyMarkupCall

+ func (b *TextMessageCallBuilder) AsEditReplyMarkupFromCBQ(callback *tg.CallbackQuery) *tg.EditMessageReplyMarkupCall

+ func (b *TextMessageCallBuilder) AsEditReplyMarkupFromMsg(msg tg.Message) *tg.EditMessageReplyMarkupCall

+ func (b *TextMessageCallBuilder) AsEditReplyMarkupInline(id string) *tg.EditMessageReplyMarkupCall

+ func (b *TextMessageCallBuilder) AsEditText(peer tg.PeerID, id int) *tg.EditMessageTextCall

+ func (b *TextMessageCallBuilder) AsEditTextFromCBQ(callback *tg.CallbackQuery) *tg.EditMessageTextCall

+ func (b *TextMessageCallBuilder) AsEditTextFromMsg(msg *tg.Message) *tg.EditMessageTextCall

+ func (b *TextMessageCallBuilder) AsEditTextInline(id string) *tg.EditMessageTextCall

+ func (b *TextMessageCallBuilder) AsSend(peer tg.PeerID) *tg.SendMessageCall

+ func (b *TextMessageCallBuilder) Client(client *tg.Client) *TextMessageCallBuilder

+ func (b *TextMessageCallBuilder) Entities(entities []tg.MessageEntity) *TextMessageCallBuilder

+ func (b *TextMessageCallBuilder) LinkPreviewOptions(options tg.LinkPreviewOptions) *TextMessageCallBuilder

+ func (b *TextMessageCallBuilder) ParseMode(mode tg.ParseMode) *TextMessageCallBuilder

+ func (b *TextMessageCallBuilder) ReplyMarkup(markup tg.ReplyMarkup) *TextMessageCallBuilder

+ func (b *TextMessageCallBuilder) Text(text string) *TextMessageCallBuilder

Feb 18, 2024

Changes in this version

+ var DefaultWebhookRequestIP = realip.FromRequest

+ type ChatBoostHandler func(context.Context, *ChatBoostUpdate) error

+ func (handler ChatBoostHandler) Handle(ctx context.Context, update *Update) error

+ type ChatBoostUpdate struct

+ Client *tg.Client

+ Update *Update

+ type MessageReactionCountHandler func(context.Context, *MessageReactionCountUpdate) error

+ func (handler MessageReactionCountHandler) Handle(ctx context.Context, update *Update) error

+ type MessageReactionCountUpdate struct

+ Client *tg.Client

+ Update *Update

+ type MessageReactionHandler func(context.Context, *MessageReactionUpdate) error

+ func (handler MessageReactionHandler) Handle(ctx context.Context, update *Update) error

+ type MessageReactionUpdate struct

+ Client *tg.Client

+ Update *Update

+ type RemovedChatBoostHandler func(context.Context, *RemovedChatBoostUpdate) error

+ func (handler RemovedChatBoostHandler) Handle(ctx context.Context, update *Update) error

+ type RemovedChatBoostUpdate struct

+ Client *tg.Client

+ Update *Update

type Router

+ func (bot *Router) ChatBoost(handler ChatBoostHandler, filters ...Filter) *Router

+ func (bot *Router) MessageReaction(handler MessageReactionHandler, filters ...Filter) *Router

+ func (bot *Router) MessageReactionCount(handler MessageReactionCountHandler, filters ...Filter) *Router

+ func (bot *Router) RemovedChatBoost(handler RemovedChatBoostHandler, filters ...Filter) *Router

type WebhookOption

+ func WithWebhookRequestIP(ip func(r *http.Request) string) WebhookOption

Aug 9, 2022

Changes in this version

+ var ErrFilterNoAllow = fmt.Errorf("filter no allow")

Aug 8, 2022

Changes in this version

type Filter

+ func Not(filter Filter) Filter

type Middleware

+ Wrap func(Handler) Handler

+ type MiddlewareFunc func(Handler) Handler

+ func (m MiddlewareFunc) Wrap(h Handler) Handler

type Update

+ func (update *Update) Reply(ctx context.Context, v UpdateReply) error

+ type UpdateReply interface

+ Bind func(client *tg.Client)

+ DoVoid func(ctx context.Context) error

type Webhook

+ func (webhook *Webhook) ServeRequest(ctx context.Context, r *WebhookRequest) *WebhookResponse

+ type WebhookRequest struct

+ Body io.Reader

+ ContentType string

+ IP netip.Addr

+ Method string

+ SecurityToken string

+ type WebhookResponse struct

+ Body []byte

+ ContentType string

+ Status int

Aug 1, 2022

Changes in this version

type Filter

+ func MessageEntity(types ...tg.MessageEntityType) Filter

Jul 18, 2022

Changes in this version

type Filter

+ func MessageType(types ...tg.MessageType) Filter

+ func TextContains(v string, opts ...TextFuncFilterOption) Filter

+ func TextEqual(v string, opts ...TextFuncFilterOption) Filter

+ func TextFunc(fn func(text string, ignoreCase bool) bool, opts ...TextFuncFilterOption) Filter

+ func TextHasPrefix(v string, opts ...TextFuncFilterOption) Filter

+ func TextHasSuffix(v string, opts ...TextFuncFilterOption) Filter

+ func TextIn(vs []string, opts ...TextFuncFilterOption) Filter

+ type Router struct

+ func NewRouter() *Router

+ func (bot *Router) CallbackQuery(handler CallbackQueryHandler, filters ...Filter) *Router

+ func (bot *Router) ChannelPost(handler MessageHandler, filters ...Filter) *Router

+ func (bot *Router) ChatJoinRequest(handler ChatJoinRequestHandler, filters ...Filter) *Router

+ func (bot *Router) ChatMember(handler ChatMemberUpdatedHandler, filters ...Filter) *Router

+ func (bot *Router) ChosenInlineResult(handler ChosenInlineResultHandler, filters ...Filter) *Router

+ func (bot *Router) EditedChannelPost(handler MessageHandler, filters ...Filter) *Router

+ func (bot *Router) EditedMessage(handler MessageHandler, filters ...Filter) *Router

+ func (bot *Router) Error(handler ErrorHandler) *Router

+ func (bot *Router) Handle(ctx context.Context, update *Update) error

+ func (bot *Router) InlineQuery(handler InlineQueryHandler, filters ...Filter) *Router

+ func (bot *Router) Message(handler MessageHandler, filters ...Filter) *Router

+ func (bot *Router) MyChatMember(handler ChatMemberUpdatedHandler, filters ...Filter) *Router

+ func (bot *Router) Poll(handler PollHandler, filters ...Filter) *Router

+ func (bot *Router) PollAnswer(handler PollAnswerHandler, filters ...Filter) *Router

+ func (bot *Router) PreCheckoutQuery(handler PreCheckoutQueryHandler, filters ...Filter) *Router

+ func (bot *Router) ShippingQuery(handler ShippingQueryHandler, filters ...Filter) *Router

+ func (bot *Router) Update(handler HandlerFunc, filters ...Filter) *Router

+ func (bot *Router) Use(mws ...Middleware) *Router

+ type TextFuncFilterOption func(*textFuncFilter)

+ func WithTextFuncIgnoreCase(v bool) TextFuncFilterOption

Jul 3, 2022

Changes in this version

type MessageUpdate

+ func (msg *MessageUpdate) AnswerMediaGroup(action []tg.InputMedia) *tg.SendMediaGroupCall

type PollerOption

+ func WithPollerLogger(logger Logger) PollerOption

type Webhook

+ func (webhook *Webhook) Run(ctx context.Context, listen string) error

type WebhookOption

+ func WithWebhookLogger(logger Logger) WebhookOption

Jun 29, 2022

Changes in this version

type Bot

+ func (bot *Bot) Error(handler ErrorHandler) *Bot

+ func (bot *Bot) Update(handler HandlerFunc, filters ...Filter) *Bot

+ type ErrorHandler func(ctx context.Context, update *Update, err error) error

Jun 27, 2022

Changes in this version

+ type CallbackQueryHandler func(context.Context, *CallbackQueryUpdate) error

+ func (handler CallbackQueryHandler) Handle(ctx context.Context, update *Update) error

+ type CallbackQueryUpdate struct

+ Client *tg.Client

+ Update *Update

+ func (cbq *CallbackQueryUpdate) Answer() *tg.AnswerCallbackQueryCall

+ func (cbq *CallbackQueryUpdate) AnswerText(text string, alert bool) *tg.AnswerCallbackQueryCall

+ func (cbq *CallbackQueryUpdate) AnswerURL(url string) *tg.AnswerCallbackQueryCall

+ type ChatJoinRequestHandler func(context.Context, *ChatJoinRequestUpdate) error

+ func (handler ChatJoinRequestHandler) Handle(ctx context.Context, update *Update) error

+ type ChatJoinRequestUpdate struct

+ Client *tg.Client

+ Update *Update

+ func (joinRequest *ChatJoinRequestUpdate) Approve() *tg.ApproveChatJoinRequestCall

+ func (joinRequest *ChatJoinRequestUpdate) Decline() *tg.DeclineChatJoinRequestCall

+ type ChatMemberUpdatedHandler func(context.Context, *ChatMemberUpdatedUpdate) error

+ func (handler ChatMemberUpdatedHandler) Handle(ctx context.Context, update *Update) error

+ type ChatMemberUpdatedUpdate struct

+ Client *tg.Client

+ Update *Update

+ type ChosenInlineResultHandler func(context.Context, *ChosenInlineResultUpdate) error

+ func (handler ChosenInlineResultHandler) Handle(ctx context.Context, update *Update) error

+ type ChosenInlineResultUpdate struct

+ Client *tg.Client

+ Update *Update

+ type InlineQueryHandler func(context.Context, *InlineQueryUpdate) error

+ func (handler InlineQueryHandler) Handle(ctx context.Context, update *Update) error

+ type InlineQueryUpdate struct

+ Client *tg.Client

+ Update *Update

+ func (iq *InlineQueryUpdate) Answer(results []tg.InlineQueryResult) *tg.AnswerInlineQueryCall

+ type MessageHandler func(context.Context, *MessageUpdate) error

+ func (handler MessageHandler) Handle(ctx context.Context, update *Update) error

+ type MessageUpdate struct

+ Client *tg.Client

+ Update *Update

+ func (msg *MessageUpdate) Answer(text string) *tg.SendMessageCall

+ func (msg *MessageUpdate) AnswerAnimation(animation tg.FileArg) *tg.SendAnimationCall

+ func (msg *MessageUpdate) AnswerAudio(audio tg.FileArg) *tg.SendAudioCall

+ func (msg *MessageUpdate) AnswerChatAction(action string) *tg.SendChatActionCall

+ func (msg *MessageUpdate) AnswerContact(phoneNumber string, firstName string) *tg.SendContactCall

+ func (msg *MessageUpdate) AnswerDice(emoji string) *tg.SendDiceCall

+ func (msg *MessageUpdate) AnswerDocument(document tg.FileArg) *tg.SendDocumentCall

+ func (msg *MessageUpdate) AnswerLocation(latitude float64, longitude float64) *tg.SendLocationCall

+ func (msg *MessageUpdate) AnswerPhoto(photo tg.FileArg) *tg.SendPhotoCall

+ func (msg *MessageUpdate) AnswerPoll(question string, options []string) *tg.SendPollCall

+ func (msg *MessageUpdate) AnswerSticker(sticker tg.FileArg) *tg.SendStickerCall

+ func (msg *MessageUpdate) AnswerVenue(latitude float64, longitude float64, title string, address string) *tg.SendVenueCall

+ func (msg *MessageUpdate) AnswerVideo(video tg.FileArg) *tg.SendVideoCall

+ func (msg *MessageUpdate) AnswerVideoNote(videoNote tg.FileArg) *tg.SendVideoNoteCall

+ func (msg *MessageUpdate) AnswerVoice(voice tg.FileArg) *tg.SendVoiceCall

+ func (msg *MessageUpdate) Copy(to tg.PeerID) *tg.CopyMessageCall

+ func (msg *MessageUpdate) EditCaption(caption string) *tg.EditMessageCaptionCall

+ func (msg *MessageUpdate) EditReplyMarkup(markup tg.InlineKeyboardMarkup) *tg.EditMessageReplyMarkupCall

+ func (msg *MessageUpdate) EditText(text string) *tg.EditMessageTextCall

+ func (msg *MessageUpdate) Forward(to tg.PeerID) *tg.ForwardMessageCall

+ type PollAnswerHandler func(context.Context, *PollAnswerUpdate) error

+ func (handler PollAnswerHandler) Handle(ctx context.Context, update *Update) error

+ type PollAnswerUpdate struct

+ Client *tg.Client

+ Update *Update

+ type PollHandler func(context.Context, *PollUpdate) error

+ func (handler PollHandler) Handle(ctx context.Context, update *Update) error

+ type PollUpdate struct

+ Client *tg.Client

+ Update *Update

type PollerOption

+ func WithPollerAllowedUpdates(allowedUpdates []string) PollerOption

+ func WithPollerLimit(limit int) PollerOption

+ type PreCheckoutQueryHandler func(context.Context, *PreCheckoutQueryUpdate) error

+ func (handler PreCheckoutQueryHandler) Handle(ctx context.Context, update *Update) error

+ type PreCheckoutQueryUpdate struct

+ Client *tg.Client

+ Update *Update

+ func (pcq *PreCheckoutQueryUpdate) Answer(ok bool) *tg.AnswerPreCheckoutQueryCall

+ type ShippingQueryHandler func(context.Context, *ShippingQueryUpdate) error

+ func (handler ShippingQueryHandler) Handle(ctx context.Context, update *Update) error

+ type ShippingQueryUpdate struct

+ Client *tg.Client

+ Update *Update

+ func (sq *ShippingQueryUpdate) Answer(ok bool) *tg.AnswerShippingQueryCall

+ type Update struct

+ Client *tg.Client

+ func (update *Update) Respond(ctx context.Context, v UpdateRespond) error

+ type UpdateRespond interface

+ Bind func(client *tg.Client)

+ DoVoid func(ctx context.Context) error

type WebhookOption

+ func WithDropPendingUpdates(dropPendingUpdates bool) WebhookOption

+ func WithWebhookAllowedUpdates(updates ...string) WebhookOption

+ func WithWebhookIP(ip string) WebhookOption

+ func WithWebhookMaxConnections(maxConnections int) WebhookOption

Jun 23, 2022

Changes in this version

type Filter

+ func ChatType(types ...tg.ChatType) Filter

+ type Poller struct

+ func NewPoller(handler Handler, client *tg.Client, opts ...PollerOption) *Poller

+ func (poller *Poller) Run(ctx context.Context) error

+ type PollerOption func(*Poller)

+ func WithPollerHandlerTimeout(timeout time.Duration) PollerOption

+ func WithPollerRetryAfter(retryAfter time.Duration) PollerOption

+ func WithPollerTimeout(timeout time.Duration) PollerOption

Jun 22, 2022

Changes in this version

+ var DefaultSubnets = []netip.Prefix

+ type Bot struct

+ func New() *Bot

+ func (bot *Bot) CallbackQuery(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) ChannelPost(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) ChatJoinRequest(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) ChatMember(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) ChosenInlineResult(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) EditedChannelPost(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) EditedMessage(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) Handle(ctx context.Context, update *tg.Update) error

+ func (bot *Bot) InlineQuery(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) Message(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) MyChatMember(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) Poll(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) PollAnswer(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) PreCheckoutQuery(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) ShippingQuery(handler Handler, filters ...Filter) *Bot

+ func (bot *Bot) Use(mws ...Middleware) *Bot

+ type CommandFilter struct

+ func Command(command string, opts ...CommandFilterOption) *CommandFilter

+ func (filter *CommandFilter) Allow(ctx context.Context, update *tg.Update) (bool, error)

+ type CommandFilterOption func(*CommandFilter)

+ func WithCommandAlias(aliases ...string) CommandFilterOption

+ func WithCommandIgnoreCaption(ignoreCaption bool) CommandFilterOption

+ func WithCommandIgnoreCase(ignoreCase bool) CommandFilterOption

+ func WithCommandIgnoreMention(ignoreMention bool) CommandFilterOption

+ func WithCommandPrefix(prefixes ...string) CommandFilterOption

+ type Filter interface

+ Allow func(ctx context.Context, update *tg.Update) (bool, error)

+ func All(filters ...Filter) Filter

+ func Any(filters ...Filter) Filter

+ func Regexp(re *regexp.Regexp) Filter

+ type FilterFunc func(ctx context.Context, update *tg.Update) (bool, error)

+ func (filter FilterFunc) Allow(ctx context.Context, update *tg.Update) (bool, error)

+ type Handler interface

+ Handle func(ctx context.Context, update *tg.Update) error

+ type HandlerFunc func(ctx context.Context, update *tg.Update) error

+ func (handler HandlerFunc) Handle(ctx context.Context, update *tg.Update) error

+ type Logger interface

+ Printf func(format string, args ...any)

+ type Middleware func(Handler) Handler

+ type Webhook struct

+ func NewWebhook(url string, handler Handler, client *tg.Client, options ...WebhookOption) *Webhook

+ func (webhook *Webhook) ServeHTTP(w http.ResponseWriter, r *http.Request)

+ func (webhook *Webhook) Setup(ctx context.Context, dropPendingUpdates bool) error

+ type WebhookOption func(*Webhook)

+ func WithIP(ip string) WebhookOption

+ func WithMaxConnections(maxConnections int) WebhookOption

+ func WithWebhookSecuritySubnets(subnets ...netip.Prefix) WebhookOption

+ func WithWebhookSecurityToken(token string) WebhookOption