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

client/httpclient.go

@@ -0,0 +1,40 @@
+package client
+
+import (
+	"net"
+	"net/http"
+	"time"
+)
+
+// HTTPDoer abstracts the HTTP transport. The default is a net/http client
+// tuned for Telegram's long-poll usage. Users may plug in valyala/fasthttp
+// (via an adapter), or any custom retry/circuit-breaker client by passing
+// WithHTTPClient to New.
+type HTTPDoer interface {
+	Do(req *http.Request) (*http.Response, error)
+}
+
+// NewDefaultHTTPDoer returns an *http.Client with sensible defaults for
+// Telegram Bot API usage:
+//   - 60s overall timeout (longer than typical long-poll Timeout=30s).
+//   - Connection pooling sized for a small number of long-lived hosts.
+//   - HTTP/2 enabled (default in net/http).
+func NewDefaultHTTPDoer() *http.Client {
+	t := &http.Transport{
+		Proxy: http.ProxyFromEnvironment,
+		DialContext: (&net.Dialer{
+			Timeout:   10 * time.Second,
+			KeepAlive: 30 * time.Second,
+		}).DialContext,
+		MaxIdleConns:          16,
+		MaxIdleConnsPerHost:   8,
+		IdleConnTimeout:       90 * time.Second,
+		TLSHandshakeTimeout:   10 * time.Second,
+		ExpectContinueTimeout: 1 * time.Second,
+		ForceAttemptHTTP2:     true,
+	}
+	return &http.Client{
+		Transport: t,
+		Timeout:   60 * time.Second,
+	}
+}