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

test/integration/README.md

@@ -0,0 +1,13 @@
+# Integration tests
+
+Live tests against the real Telegram Bot API. Skipped by default.
+
+## Run
+
+```bash
+export TELEGRAM_BOT_TOKEN=test_bot_token_here
+export TELEGRAM_TEST_CHAT_ID=123456789  # a chat the bot can post in
+make integration
+```
+
+The suite covers `getMe`, `sendMessage`, and the `setWebhook`/`deleteWebhook` cycle.