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

@@ -0,0 +1,12 @@
+# inline
+
+Demonstrates inline-mode queries. Enable inline mode for your bot via [@BotFather](https://t.me/BotFather) (`/setinline`).
+
+## Run
+
+```bash
+export TELEGRAM_BOT_TOKEN=...
+go run ./examples/inline
+```
+
+In any Telegram chat, type `@yourbot something` to see two results: an echo and an UPPERCASE'd version.

examples/inline/main.go

@@ -0,0 +1,64 @@
+// Package main demonstrates inline-mode queries with go-telegram.
+//
+// Enable inline mode for your bot via @BotFather: /setinline → enable.
+// Then type @yourbot something in any chat to see results.
+//
+//	TELEGRAM_BOT_TOKEN=xxx go run ./examples/inline
+package main
+
+import (
+	"context"
+	"log"
+	"os"
+	"os/signal"
+	"strings"
+	"syscall"
+
+	"github.com/lukaszraczylo/go-telegram/api"
+	"github.com/lukaszraczylo/go-telegram/client"
+	"github.com/lukaszraczylo/go-telegram/dispatch"
+	"github.com/lukaszraczylo/go-telegram/transport"
+)
+
+func main() {
+	token := os.Getenv("TELEGRAM_BOT_TOKEN")
+	if token == "" {
+		log.Fatal("TELEGRAM_BOT_TOKEN required")
+	}
+	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
+	defer stop()
+
+	bot := client.New(token)
+	router := dispatch.New(bot)
+
+	router.OnInlineQuery(func(c *dispatch.Context, q *api.InlineQuery) error {
+		// Echo the query as article results.
+		results := []api.InlineQueryResult{
+			&api.InlineQueryResultArticle{
+				Type:  "article",
+				ID:    "echo",
+				Title: "Echo: " + q.Query,
+				InputMessageContent: &api.InputTextMessageContent{
+					MessageText: q.Query,
+				},
+			},
+			&api.InlineQueryResultArticle{
+				Type:  "article",
+				ID:    "upper",
+				Title: "UPPER: " + strings.ToUpper(q.Query),
+				InputMessageContent: &api.InputTextMessageContent{
+					MessageText: strings.ToUpper(q.Query),
+				},
+			},
+		}
+		_, err := api.AnswerInlineQuery(c.Ctx, c.Bot, &api.AnswerInlineQueryParams{
+			InlineQueryID: q.ID,
+			Results:       results,
+		})
+		return err
+	})
+
+	if err := router.Run(ctx, transport.NewLongPoller(bot)); err != nil && err != context.Canceled {
+		log.Printf("router exited: %v", err)
+	}
+}