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/echo/handlers.go

@@ -0,0 +1,32 @@
+package main
+
+import (
+	"fmt"
+
+	"github.com/lukaszraczylo/go-telegram/api"
+	"github.com/lukaszraczylo/go-telegram/dispatch"
+)
+
+// register wires all handlers onto the router. Exposed so tests can call
+// handlers directly without going through the router run loop.
+func register(r *dispatch.Router) {
+	r.OnCommand("/start", handleStart)
+	r.OnText(`.+`, handleEcho)
+}
+
+func handleStart(c *dispatch.Context, m *api.Message) error {
+	_, err := api.SendMessage(c.Ctx, c.Bot, &api.SendMessageParams{
+		ChatID: api.ChatIDFromInt(m.Chat.ID),
+		Text:   fmt.Sprintf("hello %s, send me anything to echo", m.From.FirstName),
+	})
+	return err
+}
+
+func handleEcho(c *dispatch.Context, m *api.Message) error {
+	_, err := api.SendMessage(c.Ctx, c.Bot, &api.SendMessageParams{
+		ChatID:          api.ChatIDFromInt(m.Chat.ID),
+		Text:            m.Text,
+		ReplyParameters: &api.ReplyParameters{MessageID: m.MessageID},
+	})
+	return err
+}