core

var (
	// ErrNotLogin indicates the user is not logged in | 用户未登录错误
	ErrNotLogin = fmt.Errorf("not logged in: authentication required")

	// ErrTokenInvalid indicates the provided token is invalid or malformed | Token无效或格式错误
	ErrTokenInvalid = fmt.Errorf("invalid token: the token is malformed or corrupted")

	// ErrTokenExpired indicates the token has expired | Token已过期
	ErrTokenExpired = fmt.Errorf("token expired: please login again to get a new token")

	// ErrInvalidLoginID indicates the login ID is invalid | 登录ID无效
	ErrInvalidLoginID = fmt.Errorf("invalid login ID: the login identifier cannot be empty")

	// ErrInvalidDevice indicates the device identifier is invalid | 设备标识无效
	ErrInvalidDevice = fmt.Errorf("invalid device: the device identifier is not valid")
)

var (
	// ErrPermissionDenied indicates insufficient permissions | 权限不足
	ErrPermissionDenied = fmt.Errorf("permission denied: insufficient permissions")

	// ErrRoleDenied indicates insufficient role | 角色权限不足
	ErrRoleDenied = fmt.Errorf("insufficient role: required role not found")
)

var (
	// ErrAccountDisabled indicates the account has been disabled or banned | 账号已被禁用
	ErrAccountDisabled = fmt.Errorf("account disabled: this account has been suspended or banned")

	// ErrAccountNotFound indicates the account doesn't exist | 账号不存在
	ErrAccountNotFound = fmt.Errorf("account not found: no account associated with this identifier")
)

var (
	// ErrSessionNotFound indicates the session doesn't exist | Session不存在
	ErrSessionNotFound = fmt.Errorf("session not found: the session may have expired or been deleted")

	// ErrKickedOut indicates the user has been kicked out | 用户已被踢下线
	ErrKickedOut = fmt.Errorf("kicked out: this session has been forcibly terminated")

	// ErrActiveTimeout indicates the session has been inactive for too long | Session活跃超时
	ErrActiveTimeout = fmt.Errorf("session inactive: the session has exceeded the inactivity timeout")

	// ErrMaxLoginCount indicates maximum concurrent login limit reached | 达到最大登录数量限制
	ErrMaxLoginCount = fmt.Errorf("max login limit: maximum number of concurrent logins reached")
)

var (
	// String utilities | 字符串工具
	RandomString        = utils.RandomString
	RandomNumericString = utils.RandomNumericString
	RandomAlphanumeric  = utils.RandomAlphanumeric
	IsEmpty             = utils.IsEmpty
	IsNotEmpty          = utils.IsNotEmpty
	DefaultString       = utils.DefaultString

	// Slice utilities | 切片工具
	ContainsString = utils.ContainsString
	RemoveString   = utils.RemoveString
	UniqueStrings  = utils.UniqueStrings
	MergeStrings   = utils.MergeStrings
	FilterStrings  = utils.FilterStrings
	MapStrings     = utils.MapStrings

	// Pattern matching | 模式匹配
	MatchPattern = utils.MatchPattern

	// Duration utilities | 时长工具
	FormatDuration = utils.FormatDuration
	ParseDuration  = utils.ParseDuration

	// Hash & Encoding | 哈希和编码
	SHA256Hash   = utils.SHA256Hash
	Base64Encode = utils.Base64Encode
	Base64Decode = utils.Base64Decode
)

var ErrStorageUnavailable = fmt.Errorf("storage unavailable: unable to connect to storage backend")