Laniakea/handler.go

package laniakea

import (
	"context"
	"encoding/base64"
	"encoding/json"
	"errors"
	"fmt"
	"strings"
	"time"

	"git.scuroneko.dev/scuroneko/laniakea/tgapi"
)

// ErrInvalidPayloadType is returned when callback payload encoding type is unknown.
var ErrInvalidPayloadType = errors.New("invalid payload type")

// ErrInvalidPayload reports that a callback payload could not be decoded under the
// expected encoding (e.g. the compact format separator is missing).
var ErrInvalidPayload = errors.New("invalid payload")

func (bot *Bot[T]) handle(parentCtx context.Context, u *tgapi.Update) {
	defer func() {
		if r := recover(); r != nil {
			if bot.logger != nil {
				bot.logger.Errorln(fmt.Sprintf("panic in handle: %v", r))
			}

			err, ok := r.(error)
			if !ok {
				err = fmt.Errorf("%v", r)
			}
			bot.safeEmitEvent(parentCtx, ErrorEvent{
				UpdateID:   u.UpdateID,
				UpdateType: u.Type,
				Err:        err,
				UserFacing: false,
			})
		}
	}()
	startTime := time.Now()

	ctx, cancel := context.WithCancel(parentCtx)
	defer cancel()

	msgCtx := &MessageContext{
		Update: *u, API: bot.api,
		Logger:        bot.logger,
		errorTemplate: bot.errorTemplate,
		l10n:          bot.l10n,
		draftProvider: bot.draftProvider,
		sceneRuntime:  bot,
		observer:      bot.observer,
		eventEmitter:  bot.safeEmitEvent,
		asyncTask:     bot.startAsyncTask,
		payloadType:   bot.payloadType,
		botID:         bot.userID,
		ctx:           ctx,
	}
	bot.prepareUpdateCtx(u, msgCtx)
	bot.safeEmitEvent(ctx, UpdateReceivedEvent{
		UpdateID:   u.UpdateID,
		UpdateType: u.Type,
		FromID:     msgCtx.FromID,
		ChatID:     msgCtx.ChatID,
	})

	for _, middleware := range bot.middlewares {
		if !middleware.Execute(msgCtx, bot.appData) {
			bot.safeEmitEvent(ctx, UpdateHandledEvent{
				UpdateID:   u.UpdateID,
				UpdateType: u.Type,
				FromID:     msgCtx.FromID,
				ChatID:     msgCtx.ChatID,
				Duration:   time.Since(startTime),
				Handled:    false,
			})
			return
		}
	}

	sceneHandled, err := bot.tryHandleScene(msgCtx)
	if err != nil {
		msgCtx.error(err)
		bot.safeEmitEvent(ctx, UpdateHandledEvent{
			UpdateID:   u.UpdateID,
			UpdateType: u.Type,
			FromID:     msgCtx.FromID,
			ChatID:     msgCtx.ChatID,
			Duration:   time.Since(startTime),
			Handled:    false,
		})
		var reported *reportedSceneError
		if !errors.As(err, &reported) {
			bot.safeEmitEvent(ctx, ErrorEvent{
				UpdateID:    u.UpdateID,
				UpdateType:  u.Type,
				Plugin:      "bot",
				HandlerKind: HandlerSceneKind,
				HandlerName: "tryHandleScene",
				FromID:      msgCtx.FromID,
				ChatID:      msgCtx.ChatID,
				Err:         err,
				UserFacing:  IsUserError(err),
			})
		}
		return
	}
	if sceneHandled {
		bot.safeEmitEvent(ctx, UpdateHandledEvent{
			UpdateID:   u.UpdateID,
			UpdateType: u.Type,
			FromID:     msgCtx.FromID,
			ChatID:     msgCtx.ChatID,
			Duration:   time.Since(startTime),
			Handled:    true,
		})
		return
	}

	handled := false
	switch u.Type {
	case tgapi.UpdateTypeMessage, tgapi.UpdateTypeChannelPost:
		handled = bot.handleMessage(u, msgCtx)
	case tgapi.UpdateTypeCallbackQuery:
		handled = bot.handleCallback(u, msgCtx)
	default:
		handled = bot.handleUpdate(u, msgCtx)
	}
	bot.safeEmitEvent(ctx, UpdateHandledEvent{
		UpdateID:   u.UpdateID,
		UpdateType: u.Type,
		FromID:     msgCtx.FromID,
		ChatID:     msgCtx.ChatID,
		Duration:   time.Since(startTime),
		Handled:    handled,
	})
}

func cloneMsgContext(src *MessageContext) *MessageContext {
	cloned := *src
	if src.Args != nil {
		cloned.Args = append([]string(nil), src.Args...)
	}
	return &cloned
}

func encodeJSONPayload(d CallbackData) (string, error) {
	b, err := json.Marshal(d)
	if err != nil {
		return "", err
	}
	return string(b), nil
}

func decodeJSONPayload(s string) (CallbackData, error) {
	var data CallbackData
	err := json.Unmarshal([]byte(s), &data)
	return data, err
}

func encodeBase64Payload(d CallbackData) (string, error) {
	data, err := encodeJSONPayload(d)
	if err != nil {
		return "", err
	}
	dst := make([]byte, base64.RawURLEncoding.EncodedLen(len([]byte(data))))
	base64.RawURLEncoding.Encode(dst, []byte(data))
	return string(dst), nil
}

func decodeBase64Payload(s string) (CallbackData, error) {
	b, err := base64.RawURLEncoding.DecodeString(s)
	if err != nil {
		return CallbackData{}, err
	}
	return decodeJSONPayload(string(b))
}

// Compact payload format: cmd|arg1,arg2,...
// Bytes \, |, and , inside a part are escaped with a leading backslash so the
// payload round-trips without ambiguity. Encoding/decoding operate byte-wise
// because all separators are single-byte ASCII; multi-byte UTF-8 code points
// pass through unchanged.

func encodeCompactPart(s string) string {
	if !strings.ContainsAny(s, `\|,`) {
		return s
	}
	var b strings.Builder
	b.Grow(len(s) + 2)
	for i := 0; i < len(s); i++ {
		switch s[i] {
		case '\\', '|', ',':
			b.WriteByte('\\')
		}
		b.WriteByte(s[i])
	}
	return b.String()
}

func decodeCompactPart(s string) string {
	if !strings.Contains(s, `\`) {
		return s
	}
	var b strings.Builder
	b.Grow(len(s))
	for i := 0; i < len(s); i++ {
		if s[i] == '\\' && i+1 < len(s) {
			b.WriteByte(s[i+1])
			i++
			continue
		}
		b.WriteByte(s[i])
	}
	return b.String()
}

func encodeCompactPayload(d CallbackData) (string, error) {
	var b strings.Builder
	b.WriteString(encodeCompactPart(d.Command))
	b.WriteByte('|')
	for i, a := range d.Args {
		if i > 0 {
			b.WriteByte(',')
		}
		b.WriteString(encodeCompactPart(a))
	}
	return b.String(), nil
}

func decodeCompactPayload(s string) (CallbackData, error) {
	sepIdx := -1
	for i := 0; i < len(s); i++ {
		if s[i] == '\\' && i+1 < len(s) {
			i++
			continue
		}
		if s[i] == '|' {
			sepIdx = i
			break
		}
	}
	if sepIdx == -1 {
		return CallbackData{}, ErrInvalidPayload
	}
	cmd := decodeCompactPart(s[:sepIdx])
	argsRaw := s[sepIdx+1:]
	if argsRaw == "" {
		return CallbackData{Command: cmd}, nil
	}

	var args []string
	start := 0
	for i := 0; i < len(argsRaw); i++ {
		if argsRaw[i] == '\\' && i+1 < len(argsRaw) {
			i++
			continue
		}
		if argsRaw[i] == ',' {
			args = append(args, decodeCompactPart(argsRaw[start:i]))
			start = i + 1
		}
	}
	args = append(args, decodeCompactPart(argsRaw[start:]))
	return CallbackData{Command: cmd, Args: args}, nil
}
func encodeCompactBase64Payload(d CallbackData) (string, error) {
	payload, _ := encodeCompactPayload(d)
	return base64.RawURLEncoding.EncodeToString([]byte(payload)), nil
}
func decodeCompactBase64Payload(s string) (CallbackData, error) {
	b, err := base64.RawURLEncoding.DecodeString(s)
	if err != nil {
		return CallbackData{}, err
	}
	return decodeCompactPayload(string(b))
}

func decodePayloadAs(payloadType BotPayloadType, s string) (CallbackData, error) {
	switch payloadType {
	case BotPayloadBase64:
		return decodeBase64Payload(s)
	case BotPayloadJSON:
		return decodeJSONPayload(s)
	case BotPayloadCompact:
		return decodeCompactPayload(s)
	case BotPayloadCompactBase64:
		return decodeCompactBase64Payload(s)
	}
	return CallbackData{}, ErrInvalidPayloadType
}

func decodePayload(payloadType BotPayloadType, s string, strict bool) (CallbackData, BotPayloadType, error) {
	knownTypes := []BotPayloadType{
		BotPayloadBase64,
		BotPayloadJSON,
		BotPayloadCompact,
		BotPayloadCompactBase64,
	}
	if _, err := decodePayloadAs(payloadType, ""); errors.Is(err, ErrInvalidPayloadType) {
		return CallbackData{}, "", ErrInvalidPayloadType
	}

	data, err := decodePayloadAs(payloadType, s)
	if err == nil {
		return data, payloadType, nil
	}
	if strict {
		return CallbackData{}, "", fmt.Errorf("%w: expected %s", ErrPayloadTypeMismatch, payloadType)
	}

	for _, candidate := range knownTypes {
		if candidate == payloadType {
			continue
		}
		data, err = decodePayloadAs(candidate, s)
		if err == nil {
			return data, candidate, nil
		}
	}
	return CallbackData{}, "", err
}

func (bot *Bot[T]) decodePayload(s string) (CallbackData, error) {
	data, decodedType, err := decodePayload(bot.payloadType, s, bot.strictPayloadType)
	if err != nil {
		return CallbackData{}, err
	}
	if decodedType == BotPayloadBase64 && bot.debug && bot.logger != nil {
		bot.logger.Debugf("decoded callback payload base64->json: raw=%q json=%s", s, data.ToJSON())
	}
	return data, nil
}