Initial release of go-telegram

A fully-generated, strongly-typed Go client for the Telegram Bot API.

* 176 methods + 301 types generated from Bot API v10.0
* 1408 auto-generated tests (8 scenarios per method)
* Typed unions throughout — no 'any' in the public surface
* Pluggable HTTP transport and JSON codec (default goccy/go-json)
* Built-in retry middleware honouring Telegram's retry_after
* Generic dispatcher with filters and conversation handlers
* Self-verifying codegen pipeline (regen → audit → emit → run tests)
* 14 example bots covering common patterns

examples/conversation/handlers.go

@@ -0,0 +1,75 @@
+package main
+
+import (
+	"github.com/lukaszraczylo/go-telegram/api"
+	"github.com/lukaszraczylo/go-telegram/client"
+	"github.com/lukaszraczylo/go-telegram/dispatch"
+	"github.com/lukaszraczylo/go-telegram/dispatch/conversation"
+	msgfilter "github.com/lukaszraczylo/go-telegram/dispatch/filters/message"
+)
+
+// onMsg lifts a Filter[*api.Message] into a Filter[*api.Update].
+func onMsg(f dispatch.Filter[*api.Message]) dispatch.Filter[*api.Update] {
+	return func(u *api.Update) bool { return u.Message != nil && f(u.Message) }
+}
+
+// notCmd matches message updates that are NOT a bot command.
+var notCmd = onMsg(msgfilter.AnyCommand().Not())
+
+// buildConv constructs the /newbot conversation. Accepts an optional Storage
+// so tests can inject MemoryStorage for isolation; pass nil for the default.
+func buildConv(storage conversation.Storage) *conversation.Conversation {
+	conv := &conversation.Conversation{
+		Storage: storage,
+		EntryPoints: []conversation.Step{{
+			Filter: onMsg(msgfilter.Command("/newbot")),
+			Handler: func(c *dispatch.Context, u *api.Update) error {
+				_, _ = api.SendMessage(c.Ctx, c.Bot, &api.SendMessageParams{
+					ChatID: api.ChatIDFromInt(u.Message.Chat.ID),
+					Text:   "What should the bot's name be?",
+				})
+				return conversation.Next("await_name")
+			},
+		}},
+		States: map[conversation.State][]conversation.Step{
+			"await_name": {{
+				Filter: notCmd,
+				Handler: func(c *dispatch.Context, u *api.Update) error {
+					_, _ = api.SendMessage(c.Ctx, c.Bot, &api.SendMessageParams{
+						ChatID: api.ChatIDFromInt(u.Message.Chat.ID),
+						Text:   "Got it! What's the description?",
+					})
+					return conversation.Next("await_desc")
+				},
+			}},
+			"await_desc": {{
+				Filter: notCmd,
+				Handler: func(c *dispatch.Context, u *api.Update) error {
+					_, _ = api.SendMessage(c.Ctx, c.Bot, &api.SendMessageParams{
+						ChatID: api.ChatIDFromInt(u.Message.Chat.ID),
+						Text:   "Done! Your bot has been configured.",
+					})
+					return conversation.End()
+				},
+			}},
+		},
+		Exits: []conversation.Step{{
+			Filter: onMsg(msgfilter.Command("/cancel")),
+			Handler: func(c *dispatch.Context, u *api.Update) error {
+				_, _ = api.SendMessage(c.Ctx, c.Bot, &api.SendMessageParams{
+					ChatID: api.ChatIDFromInt(u.Message.Chat.ID),
+					Text:   "Cancelled.",
+				})
+				return conversation.End()
+			},
+		}},
+	}
+	return conv
+}
+
+// register wires the conversation middleware onto the router.
+func register(r *dispatch.Router, bot *client.Bot) {
+	_ = bot // bot available for future handlers if needed
+	conv := buildConv(nil)
+	r.Use(conv.Dispatch)
+}