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

transport/updater.go

@@ -0,0 +1,23 @@
+package transport
+
+import (
+	"context"
+
+	"github.com/lukaszraczylo/go-telegram/api"
+)
+
+// Updater is the abstraction over update sources. Implementations must:
+//   - return a channel from Updates() that receives every Update they read.
+//   - close the channel after Run returns.
+//   - honour ctx cancellation in Run.
+type Updater interface {
+	// Updates returns the channel updates flow into. Multiple readers
+	// is implementation-defined; users should treat it as single-reader.
+	Updates() <-chan api.Update
+	// Run blocks until ctx is cancelled or a fatal error occurs. It is
+	// the user's responsibility to call Run in a goroutine if needed.
+	Run(ctx context.Context) error
+	// Stop signals Run to exit and waits for the channel to drain.
+	// Implementations must be idempotent.
+	Stop(ctx context.Context) error
+}