package domain

import (
	"encoding/base64"
	"errors"
	"strconv"
)

// Stars 本地账本领域模型（无 TL 类型，镜像 boost.go 风格）。本实现是本地账本、
// 非真实支付：余额为整数 Stars（线上 Nanos 恒 0），借记原子、永不为负。

// StarsBalance 是一个账号的当前可用 Stars 余额。
type StarsBalance struct {
	UserID  int64
	Balance int64 // 当前可花费 Stars，恒 >= 0
	Granted bool  // 起始授予是否已应用（惰性首读授予的幂等守卫）
}

// StarsTransactionReason 标记一条流水的语义（投影到 tg.StarsTransaction 的标志位/标题）。
type StarsTransactionReason string

const (
	StarsReasonGrant       StarsTransactionReason = "grant"        // 起始余额自动授予
	StarsReasonTopup       StarsTransactionReason = "topup"        // 充值（本地铸造）
	StarsReasonReaction    StarsTransactionReason = "reaction"     // 付费 reaction 花费
	StarsReasonGift        StarsTransactionReason = "gift"         // 星礼花费/收取
	StarsReasonGiftUpgrade StarsTransactionReason = "gift_upgrade" // 普通礼物升级为唯一礼物
	StarsReasonPaidMedia   StarsTransactionReason = "paid_media"   // 付费媒体解锁
	StarsReasonAdjust      StarsTransactionReason = "adjust"       // 兜底/人工调整
)

// StarsTransaction 是一条账本流水。amount 带符号：贷记 > 0（含 refund/收取），借记 < 0。
type StarsTransaction struct {
	ID          int64 // 单调递增账本 id（keyset 游标）
	UserID      int64 // 账本归属
	Peer        Peer  // 对手方（grant/topup 等无对手时为零 Peer）
	Amount      int64 // 带符号金额
	Date        int   // Unix 秒
	Reason      StarsTransactionReason
	Title       string // 可选，投影到 tg.StarsTransaction.Title
	Description string // 可选，投影到 tg.StarsTransaction.Description
}

// IsCredit 报告该流水是否为入账（贷记），投影到 tg.StarsTransaction.Refund。
func (t StarsTransaction) IsCredit() bool { return t.Amount > 0 }

// StarsTransactionPage 是一页账本流水 + 当前余额 + 分页游标 + 对手方用户富化集合。
type StarsTransactionPage struct {
	Balance      int64
	Transactions []StarsTransaction
	NextOffset   string // 空表示无更多页（DrKLO 据此停止翻页，勿在末页给非空值）
	Users        []User // History 中提到的对手方用户，供 tg Users 富化
}

// Stars 账本边界常量。
const (
	// DefaultStarsStartingGrant 是惰性首读授予的起始 Stars 余额（本地测试用）。
	DefaultStarsStartingGrant = 1000
	// MaxStarsTransactionsLimit 是 getStarsTransactions 单页上限。
	MaxStarsTransactionsLimit = 100
	// MaxStarsTransactionsOffsetBytes 是 keyset 游标字符串长度上限。
	MaxStarsTransactionsOffsetBytes = 64
)

// Stars 账本哨兵错误（rpc 层 errors.Is 匹配后映射为 tgerr，仿 ErrPremiumRequired）。
var (
	// ErrStarsInsufficient 表示余额不足以完成借记（映射 BALANCE_TOO_LOW）。
	ErrStarsInsufficient = errors.New("stars: insufficient balance")
	// ErrStarsInvalidAmount 表示金额非法（<=0）。
	ErrStarsInvalidAmount = errors.New("stars: invalid amount")
)

// EncodeStarsCursor 把 keyset 游标（最后一条流水 id）编码为客户端不透明字符串。
func EncodeStarsCursor(id int64) string {
	return base64.RawURLEncoding.EncodeToString([]byte(strconv.FormatInt(id, 10)))
}

// DecodeStarsCursor 反解 EncodeStarsCursor；无法解析（含空串）时返回 ok=false，
// 调用方应据此从首页开始（客户端只会回传我们给过的游标，畸形仅作兜底）。
func DecodeStarsCursor(s string) (int64, bool) {
	if s == "" {
		return 0, false
	}
	raw, err := base64.RawURLEncoding.DecodeString(s)
	if err != nil {
		return 0, false
	}
	id, err := strconv.ParseInt(string(raw), 10, 64)
	if err != nil || id <= 0 {
		return 0, false
	}
	return id, true
}