refactor(log): log through gotd/log instead of zap

Make the structured logger the github.com/gotd/log port: Options.Logger,
Bot.Logger() and pool.Options.Logger are now log.Logger, and internal
logging uses log.For(...).Info/Warn/Error with log attrs. The library no
longer imports zap. Breaking: wrap *zap.Logger with logzap.New (examples
updated). Add Bot.logger() helper.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: ernado

CHANGELOG.md

@@ -7,6 +7,14 @@ messages follow [Conventional Commits](https://www.conventionalcommits.org/).
 
 ## [Unreleased]
 
+### Changed
+
+- **Logging port** — the library now logs through `github.com/gotd/log` instead
+  of zap directly. `Options.Logger` and `Bot.Logger()` (and `pool.Options.Logger`)
+  are now `log.Logger`. **Breaking:** wrap a `*zap.Logger` with
+  `github.com/gotd/log/logzap.New` (or a `*slog.Logger` with `logslog.New`). The
+  library no longer depends on zap.
+
 ### Added
 
 - **Rich messages** (Bot API 10.1) — `SendRichMessage`/`SendRichHTML`/

bot.go

@@ -7,13 +7,11 @@ import (
 
 	"github.com/go-faster/errors"
 	"github.com/gotd/log"
-	"github.com/gotd/log/logzap"
 	"github.com/gotd/td/telegram"
 	"github.com/gotd/td/telegram/message"
 	"github.com/gotd/td/telegram/peers"
 	"github.com/gotd/td/telegram/updates"
 	"github.com/gotd/td/tg"
-	"go.uber.org/zap"
 )
 
 // Bot is a Telegram Bot API client implemented over MTProto.
@@ -22,7 +20,7 @@ import (
 // Run to connect and serve. Bot is safe for concurrent use once running.
 type Bot struct {
 	token string
-	log   *zap.Logger
+	log   log.Logger
 
 	client *telegram.Client
 	raw    *tg.Client
@@ -60,9 +58,7 @@ func New(token string, opt Options) (*Bot, error) {
 		return nil, errors.New("AppID and AppHash are required (see https://my.telegram.org)")
 	}
 	opt.setDefaults()
-
-	// gotd/td logs through the github.com/gotd/log port; bridge the zap logger.
-	lg := logzap.New(opt.Logger)
+	lg := opt.Logger
 
 	disp := tg.NewUpdateDispatcher()
 
@@ -83,7 +79,7 @@ func New(token string, opt Options) (*Bot, error) {
 		AccessHasher: pm,
 		Logger:       log.Named(lg, "gaps"),
 		OnChannelTooLong: func(channelID int64) {
-			opt.Logger.Warn("Channel too long", zap.Int64("channel_id", channelID))
+			log.For(lg).Warn(context.Background(), "Channel too long", log.Int64("channel_id", channelID))
 		},
 	})
 
@@ -146,10 +142,10 @@ func (b *Bot) publishCommands(ctx context.Context) {
 		return
 	}
 	if err := b.SetMyCommands(ctx, cmds); err != nil {
-		b.log.Warn("Register bot commands", zap.Error(err))
+		b.logger().Warn(ctx, "Register bot commands", log.Error(err))
 		return
 	}
-	b.log.Debug("Registered bot commands", zap.Int("count", len(cmds)))
+	b.logger().Debug(ctx, "Registered bot commands", log.Int("count", len(cmds)))
 }
 
 // Run connects, authorizes as a bot, and blocks serving updates until ctx is
@@ -187,9 +183,9 @@ func (b *Bot) Run(ctx context.Context) error {
 		return b.gaps.Run(ctx, b.raw, me.ID, updates.AuthOptions{
 			IsBot: true,
 			OnStart: func(ctx context.Context) {
-				b.log.Info("Bot started",
-					zap.Int64("id", me.ID),
-					zap.String("username", me.Username),
+				b.logger().Info(ctx, "Bot started",
+					log.Int64("id", me.ID),
+					log.String("username", me.Username),
 				)
 				b.publishCommands(ctx)
 				if b.onStart != nil {
@@ -218,8 +214,11 @@ func (b *Bot) Peers() *peers.Manager { return b.peers }
 // Self returns the bot's own user. It is nil until Run has authorized.
 func (b *Bot) Self() *tg.User { return b.self }
 
-// Logger returns the bot's zap logger.
-func (b *Bot) Logger() *zap.Logger { return b.log }
+// Logger returns the bot's structured logger (the github.com/gotd/log port).
+func (b *Bot) Logger() log.Logger { return b.log }
+
+// logger wraps the bot's logger in an ergonomic Helper for internal logging.
+func (b *Bot) logger() log.Helper { return log.For(b.log) }
 
 func (b *Bot) setRunCtx(ctx context.Context) {
 	b.runMu.Lock()

examples/advanced/main.go

@@ -19,6 +19,8 @@ import (
 	"strings"
 	"time"
 
+	glog "github.com/gotd/log"
+	"github.com/gotd/log/logzap"
 	"go.uber.org/zap"
 
 	"github.com/gotd/td/telegram/message/rich"
@@ -29,7 +31,7 @@ import (
 const samplePhotoURL = "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg"
 
 func main() {
-	log, _ := zap.NewDevelopment()
+	log, _ := zap.NewProduction()
 	defer func() { _ = log.Sync() }()
 
 	appID, err := strconv.Atoi(os.Getenv("APP_ID"))
@@ -40,7 +42,7 @@ func main() {
 	bot, err := botapi.New(os.Getenv("BOT_TOKEN"), botapi.Options{
 		AppID:     appID,
 		AppHash:   os.Getenv("APP_HASH"),
-		Logger:    log,
+		Logger:    logzap.New(log),
 		FloodWait: true, // transparently wait out flood limits
 	})
 	if err != nil {
@@ -220,7 +222,7 @@ func registerCommands(bot *botapi.Bot) {
 		go func() {
 			time.Sleep(5 * time.Second)
 			if _, err := c.Bot.SendMessage(ctx, chat, "⏰ Here's your reminder!"); err != nil {
-				c.Bot.Logger().Warn("background reminder failed", zap.Error(err))
+				glog.For(c.Bot.Logger()).Warn(ctx, "background reminder failed", glog.Error(err))
 			}
 		}()
 		_, err := c.Reply("OK, I'll remind you in 5 seconds.")

examples/buttons/main.go

@@ -15,6 +15,7 @@ import (
 	"strconv"
 	"time"
 
+	"github.com/gotd/log/logzap"
 	"go.uber.org/zap"
 
 	"github.com/gotd/botapi"
@@ -35,7 +36,7 @@ func menu() *botapi.InlineKeyboardMarkup {
 }
 
 func main() {
-	log, _ := zap.NewDevelopment()
+	log, _ := zap.NewProduction()
 	defer func() { _ = log.Sync() }()
 
 	appID, err := strconv.Atoi(os.Getenv("APP_ID"))
@@ -46,7 +47,7 @@ func main() {
 	bot, err := botapi.New(os.Getenv("BOT_TOKEN"), botapi.Options{
 		AppID:   appID,
 		AppHash: os.Getenv("APP_HASH"),
-		Logger:  log,
+		Logger:  logzap.New(log),
 	})
 	if err != nil {
 		log.Fatal("Create bot", zap.Error(err))

examples/echo/main.go

@@ -14,13 +14,14 @@ import (
 	"strconv"
 	"time"
 
+	"github.com/gotd/log/logzap"
 	"go.uber.org/zap"
 
 	"github.com/gotd/botapi"
 )
 
 func main() {
-	log, _ := zap.NewDevelopment()
+	log, _ := zap.NewProduction()
 	defer func() { _ = log.Sync() }()
 
 	appID, err := strconv.Atoi(os.Getenv("APP_ID"))
@@ -31,7 +32,7 @@ func main() {
 	bot, err := botapi.New(os.Getenv("BOT_TOKEN"), botapi.Options{
 		AppID:   appID,
 		AppHash: os.Getenv("APP_HASH"),
-		Logger:  log,
+		Logger:  logzap.New(log),
 	})
 	if err != nil {
 		log.Fatal("Create bot", zap.Error(err))

examples/inline/main.go

@@ -15,13 +15,14 @@ import (
 	"strconv"
 	"strings"
 
+	"github.com/gotd/log/logzap"
 	"go.uber.org/zap"
 
 	"github.com/gotd/botapi"
 )
 
 func main() {
-	log, _ := zap.NewDevelopment()
+	log, _ := zap.NewProduction()
 	defer func() { _ = log.Sync() }()
 
 	appID, err := strconv.Atoi(os.Getenv("APP_ID"))
@@ -32,7 +33,7 @@ func main() {
 	bot, err := botapi.New(os.Getenv("BOT_TOKEN"), botapi.Options{
 		AppID:   appID,
 		AppHash: os.Getenv("APP_HASH"),
-		Logger:  log,
+		Logger:  logzap.New(log),
 	})
 	if err != nil {
 		log.Fatal("Create bot", zap.Error(err))

examples/media/main.go

@@ -20,6 +20,7 @@ import (
 	"strconv"
 	"time"
 
+	"github.com/gotd/log/logzap"
 	"go.uber.org/zap"
 
 	"github.com/gotd/botapi"
@@ -29,7 +30,7 @@ import (
 const samplePhotoURL = "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg"
 
 func main() {
-	log, _ := zap.NewDevelopment()
+	log, _ := zap.NewProduction()
 	defer func() { _ = log.Sync() }()
 
 	appID, err := strconv.Atoi(os.Getenv("APP_ID"))
@@ -40,7 +41,7 @@ func main() {
 	bot, err := botapi.New(os.Getenv("BOT_TOKEN"), botapi.Options{
 		AppID:   appID,
 		AppHash: os.Getenv("APP_HASH"),
-		Logger:  log,
+		Logger:  logzap.New(log),
 	})
 	if err != nil {
 		log.Fatal("Create bot", zap.Error(err))

handler.go

@@ -4,7 +4,7 @@ import (
 	"context"
 	"sync"
 
-	"go.uber.org/zap"
+	"github.com/gotd/log"
 )
 
 // Context is passed to a Handler. It embeds the request context (so it can be
@@ -93,7 +93,7 @@ func (b *Bot) route(ctx context.Context, u *Update) {
 		}
 		c := &Context{Context: ctx, Bot: b, Update: u}
 		if err := h(c); err != nil {
-			b.log.Error("Handler error", zap.Error(err))
+			b.logger().Error(ctx, "Handler error", log.Error(err))
 		}
 		return
 	}

middleware.go

@@ -5,7 +5,7 @@ import (
 	"runtime/debug"
 	"time"
 
-	"go.uber.org/zap"
+	"github.com/gotd/log"
 )
 
 // Recover wraps a handler so a panic is recovered, logged with its stack, and
@@ -15,9 +15,9 @@ func Recover() Middleware {
 		return func(c *Context) (err error) {
 			defer func() {
 				if r := recover(); r != nil {
-					c.Bot.log.Error("Recovered from panic in handler",
-						zap.Any("panic", r),
-						zap.ByteString("stack", debug.Stack()),
+					c.Bot.logger().Error(c, "Recovered from panic in handler",
+						log.Any("panic", r),
+						log.String("stack", string(debug.Stack())),
 					)
 					err = &Error{Code: 500, Description: "Internal Server Error: handler panicked"}
 				}
@@ -47,10 +47,10 @@ func Logging() Middleware {
 		return func(c *Context) error {
 			err := next(c)
 			if err != nil {
-				c.Bot.log.Warn("Update handled with error",
-					zap.Int("update_id", c.Update.UpdateID), zap.Error(err))
+				c.Bot.logger().Warn(c, "Update handled with error",
+					log.Int("update_id", c.Update.UpdateID), log.Error(err))
 			} else {
-				c.Bot.log.Debug("Update handled", zap.Int("update_id", c.Update.UpdateID))
+				c.Bot.logger().Debug(c, "Update handled", log.Int("update_id", c.Update.UpdateID))
 			}
 			return err
 		}

on.go

@@ -3,8 +3,8 @@ package botapi
 import (
 	"context"
 
+	"github.com/gotd/log"
 	"github.com/gotd/td/tg"
-	"go.uber.org/zap"
 )
 
 // installHandlers wires the raw tg.UpdateDispatcher to the Bot API router. It is
@@ -58,7 +58,7 @@ func (b *Bot) dispatchMessage(ctx context.Context, msg tg.MessageClass, edited b
 
 	m, err := b.messageFromTg(ctx, msg)
 	if err != nil {
-		b.log.Error("Convert message", zap.Error(err))
+		b.logger().Error(ctx, "Convert message", log.Error(err))
 		return
 	}
 	if m == nil {