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

scripts/snapshot.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Capture the live Telegram Bot API HTML to testdata/html/snapshot_<date>.html
+# and update the latest.html symlink. Used by `make snapshot`.
+set -euo pipefail
+
+DATE=$(date +%Y-%m-%d)
+DEST="testdata/html/snapshot_${DATE}.html"
+
+curl -fsSL --user-agent "go-telegram codegen scraper" \
+  https://core.telegram.org/bots/api > "$DEST"
+
+ln -sf "snapshot_${DATE}.html" "testdata/html/latest.html"
+echo "captured: $DEST"