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

dispatch/context.go

@@ -0,0 +1,40 @@
+// Package dispatch provides a typed router for Telegram updates. It
+// consumes any transport.Updater and dispatches updates to handlers
+// registered by command, regex, or update-payload kind.
+package dispatch
+
+import (
+	"context"
+
+	"github.com/lukaszraczylo/go-telegram/api"
+	"github.com/lukaszraczylo/go-telegram/client"
+)
+
+// Context bundles the per-update state every handler receives.
+//
+// Ctx is the request context propagated from Router.Run; cancelling the
+// run cancels every handler.
+//
+// Bot is the API client. Handlers reply by calling api.SendMessage(c.Ctx,
+// c.Bot, ...) etc.
+//
+// Update is the raw update; payload-typed handlers also receive a
+// narrowed pointer to one of its sub-fields.
+//
+// Values is a per-update bag matchers populate. Conventional keys:
+//
+//	"command":      string, the matched bot command (e.g. "/start")
+//	"command_args": string, everything after the command
+//	"regex_match":  []string, regex sub-matches when OnText matches
+type Context struct {
+	Ctx    context.Context
+	Bot    *client.Bot
+	Update *api.Update
+	Values map[string]any
+}
+
+// NewContext constructs a Context. Used by Router internally; exposed for
+// custom test harnesses.
+func NewContext(ctx context.Context, b *client.Bot, u *api.Update) *Context {
+	return &Context{Ctx: ctx, Bot: b, Update: u, Values: map[string]any{}}
+}