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

dispatch/filters/chatmember/chatmember.go

@@ -0,0 +1,41 @@
+// Package chatmember provides Filter helpers for *api.ChatMemberUpdated payloads.
+package chatmember
+
+import (
+	"github.com/lukaszraczylo/go-telegram/api"
+	"github.com/lukaszraczylo/go-telegram/dispatch"
+)
+
+// NewStatus returns a Filter that matches updates where the new chat member
+// status equals s (e.g. "member", "administrator", "kicked", "left").
+func NewStatus(s string) dispatch.Filter[*api.ChatMemberUpdated] {
+	return func(u *api.ChatMemberUpdated) bool {
+		if u == nil {
+			return false
+		}
+		switch m := u.NewChatMember.(type) {
+		case *api.ChatMemberOwner:
+			return m.Status == s
+		case *api.ChatMemberAdministrator:
+			return m.Status == s
+		case *api.ChatMemberMember:
+			return m.Status == s
+		case *api.ChatMemberRestricted:
+			return m.Status == s
+		case *api.ChatMemberLeft:
+			return m.Status == s
+		case *api.ChatMemberBanned:
+			return m.Status == s
+		default:
+			return false
+		}
+	}
+}
+
+// FromUser returns a Filter that matches updates where the acting user
+// (From.ID) equals uid.
+func FromUser(uid int64) dispatch.Filter[*api.ChatMemberUpdated] {
+	return func(u *api.ChatMemberUpdated) bool {
+		return u != nil && u.From.ID == uid
+	}
+}

dispatch/filters/chatmember/chatmember_test.go

@@ -0,0 +1,95 @@
+package chatmember_test
+
+import (
+	"testing"
+
+	"github.com/lukaszraczylo/go-telegram/api"
+	cmfilter "github.com/lukaszraczylo/go-telegram/dispatch/filters/chatmember"
+	"github.com/stretchr/testify/require"
+)
+
+func memberUpdate(status string, fromID int64) *api.ChatMemberUpdated {
+	var newMember api.ChatMember
+	switch status {
+	case "member":
+		newMember = &api.ChatMemberMember{Status: status}
+	case "administrator":
+		newMember = &api.ChatMemberAdministrator{Status: status}
+	case "kicked":
+		newMember = &api.ChatMemberBanned{Status: status}
+	case "left":
+		newMember = &api.ChatMemberLeft{Status: status}
+	default:
+		newMember = &api.ChatMemberMember{Status: status}
+	}
+	return &api.ChatMemberUpdated{
+		From:          api.User{ID: fromID},
+		NewChatMember: newMember,
+	}
+}
+
+func TestNewStatus_Matches(t *testing.T) {
+	f := cmfilter.NewStatus("member")
+	require.True(t, f(memberUpdate("member", 1)))
+	require.False(t, f(memberUpdate("kicked", 1)))
+	require.False(t, f(nil))
+}
+
+func TestNewStatus_Administrator(t *testing.T) {
+	f := cmfilter.NewStatus("administrator")
+	require.True(t, f(memberUpdate("administrator", 1)))
+	require.False(t, f(memberUpdate("member", 1)))
+}
+
+func TestNewStatus_Kicked(t *testing.T) {
+	f := cmfilter.NewStatus("kicked")
+	require.True(t, f(memberUpdate("kicked", 1)))
+	require.False(t, f(memberUpdate("left", 1)))
+}
+
+func TestNewStatus_Left(t *testing.T) {
+	f := cmfilter.NewStatus("left")
+	require.True(t, f(memberUpdate("left", 1)))
+	require.False(t, f(memberUpdate("member", 1)))
+}
+
+func TestFromUser_Matches(t *testing.T) {
+	f := cmfilter.FromUser(42)
+	require.True(t, f(memberUpdate("member", 42)))
+	require.False(t, f(memberUpdate("member", 99)))
+	require.False(t, f(nil))
+}
+
+func TestComposedFilters(t *testing.T) {
+	f := cmfilter.NewStatus("member").And(cmfilter.FromUser(7))
+	require.True(t, f(memberUpdate("member", 7)))
+	require.False(t, f(memberUpdate("member", 8)))
+	require.False(t, f(memberUpdate("kicked", 7)))
+}
+
+func TestNewStatus_Owner(t *testing.T) {
+	u := &api.ChatMemberUpdated{
+		From:          api.User{ID: 1},
+		NewChatMember: &api.ChatMemberOwner{Status: "creator"},
+	}
+	require.True(t, cmfilter.NewStatus("creator")(u))
+	require.False(t, cmfilter.NewStatus("member")(u))
+}
+
+func TestNewStatus_Restricted(t *testing.T) {
+	u := &api.ChatMemberUpdated{
+		From:          api.User{ID: 1},
+		NewChatMember: &api.ChatMemberRestricted{Status: "restricted"},
+	}
+	require.True(t, cmfilter.NewStatus("restricted")(u))
+	require.False(t, cmfilter.NewStatus("member")(u))
+}
+
+func TestNewStatus_UnknownType(t *testing.T) {
+	// nil NewChatMember → default branch → false
+	u := &api.ChatMemberUpdated{
+		From:          api.User{ID: 1},
+		NewChatMember: nil,
+	}
+	require.False(t, cmfilter.NewStatus("member")(u))
+}