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/welcome/README.md

@@ -0,0 +1,22 @@
+# welcome
+
+Greet new chat members as they join a group and log member departures.
+
+## What it shows
+
+- `OnMessageFilter` matching `Message.NewChatMembers` to send a welcome message for each joiner
+- `OnMessageFilter` matching `Message.LeftChatMember` to log departures
+- `OnMyChatMember` to detect when the bot itself is added to or removed from a group
+
+## Required bot permissions
+
+The bot must be an **admin** in the group (or at minimum have the *"Read Messages"* permission granted to non-admin bots via `setMyDefaultAdminRights`). Without this, Telegram does not forward service messages about member joins and leaves.
+
+## Running
+
+```bash
+export TELEGRAM_BOT_TOKEN=123456:ABC...
+go run ./examples/welcome
+```
+
+Add the bot to a group, then have another user join or leave — the bot will greet joiners and log departures to stdout.