feat: sync public links and phone change updates

internal/domain/account.go

@@ -6,23 +6,31 @@ import (
 )
 
 var (
-	ErrPasswordHashInvalid   = errors.New("password hash invalid")
-	ErrSRPIDInvalid          = errors.New("srp id invalid")
-	ErrSRPPasswordChanged    = errors.New("srp password changed")
-	ErrNewSettingsInvalid    = errors.New("new password settings invalid")
-	ErrNewSaltInvalid        = errors.New("new password salt invalid")
-	ErrPasswordRecoveryNA    = errors.New("password recovery not available")
-	ErrEmailCodeInvalid      = errors.New("email code invalid")
-	ErrEmailInvalid          = errors.New("email invalid")
-	ErrEmailNotAllowed       = errors.New("email not allowed")
-	ErrEmailOccupied         = errors.New("email occupied")
-	ErrSessionPasswordNeeded = errors.New("session password needed")
+	ErrPasswordHashInvalid    = errors.New("password hash invalid")
+	ErrSRPIDInvalid           = errors.New("srp id invalid")
+	ErrSRPPasswordChanged     = errors.New("srp password changed")
+	ErrNewSettingsInvalid     = errors.New("new password settings invalid")
+	ErrNewSaltInvalid         = errors.New("new password salt invalid")
+	ErrPasswordRecoveryNA     = errors.New("password recovery not available")
+	ErrEmailCodeInvalid       = errors.New("email code invalid")
+	ErrEmailInvalid           = errors.New("email invalid")
+	ErrEmailNotAllowed        = errors.New("email not allowed")
+	ErrEmailOccupied          = errors.New("email occupied")
+	ErrSessionPasswordNeeded  = errors.New("session password needed")
+	ErrPhoneNumberInvalid     = errors.New("phone number invalid")
+	ErrPhoneNumberOccupied    = errors.New("phone number occupied")
+	ErrPhoneCodeEmpty         = errors.New("phone code empty")
+	ErrPhoneCodeInvalid       = errors.New("phone code invalid")
+	ErrPhoneCodeExpired       = errors.New("phone code expired")
+	ErrPhoneChangeAuthInvalid = errors.New("phone change auth invalid")
+	ErrPhoneChangeForbidden   = errors.New("phone change forbidden")
 )
 
 type AuthCodeDeliveryKind string
 
 const (
 	AuthCodeDeliveryPhone              AuthCodeDeliveryKind = "phone"
+	AuthCodeDeliverySMS                AuthCodeDeliveryKind = "sms"
 	AuthCodeDeliveryEmail              AuthCodeDeliveryKind = "email"
 	AuthCodeDeliveryEmailSetupRequired AuthCodeDeliveryKind = "email_setup_required"
 )
@@ -240,3 +248,18 @@ func NormalizePhone(phone string) string {
 	}
 	return b.String()
 }
+
+// ValidPhone 校验 NormalizePhone 后的持久化形态：5-32 位纯数字。
+// 上限与 users.phone 列宽一致；当前开发登录/改号链路不强制精确 E.164 长度，
+// 但拒绝空串、非数字和会截断的超长输入。
+func ValidPhone(phone string) bool {
+	if len(phone) < 5 || len(phone) > 32 {
+		return false
+	}
+	for _, r := range phone {
+		if r < '0' || r > '9' {
+			return false
+		}
+	}
+	return true
+}

internal/domain/phone_change.go

@@ -0,0 +1,18 @@
+package domain
+
+// PhoneChangeRequest 是账号改号的持久化命令。PG 实现必须把 User、Event 与
+// dispatch outbox 放在同一事务；Exclude* 精确排除发起设备，因为当前设备从
+// account.changePhone 的 User 返回值更新本地状态。
+type PhoneChangeRequest struct {
+	UserID           int64
+	Phone            string
+	Date             int
+	ExcludeAuthKeyID [8]byte
+	ExcludeSessionID int64
+}
+
+type PhoneChangeResult struct {
+	User    User
+	Event   UpdateEvent
+	Changed bool
+}

internal/domain/update_event.go

@@ -27,7 +27,10 @@ const (
 	UpdateEventDialogUnreadMark UpdateEventType = "dialog_unread_mark"
 	UpdateEventPeerSettings     UpdateEventType = "peer_settings"
 	UpdateEventPeerStoryBlocked UpdateEventType = "peer_story_blocked"
-	UpdateEventDeleteMessages   UpdateEventType = "delete_messages"
+	// UpdateEventUserPhone 映射 updateUserPhone。它是账号绝对状态更新，TL
+	// 构造器不携 pts；事件仍占账号 pts，以便其它设备在线/离线保持同一水位。
+	UpdateEventUserPhone      UpdateEventType = "user_phone"
+	UpdateEventDeleteMessages UpdateEventType = "delete_messages"
 	// UpdateEventPinnedMessages 映射 updatePinnedMessages（私聊置顶/取消
 	// 置顶；MessageIDs 是该 owner 自己视角的 box id，Bool 为 pinned）。
 	// TL 构造器自带账号 pts/pts_count，不属于 LacksWirePts。
@@ -77,6 +80,7 @@ type UpdateEvent struct {
 	Peer             Peer
 	Peers            []Peer
 	Bool             bool
+	Phone            string
 	Settings         PeerSettings
 	MessageIDs       []int
 	MaxID            int
@@ -122,6 +126,7 @@ func (e UpdateEvent) LacksWirePts() bool {
 		UpdateEventDialogUnreadMark,
 		UpdateEventPeerSettings,
 		UpdateEventPeerStoryBlocked,
+		UpdateEventUserPhone,
 		UpdateEventDialogFilter,
 		UpdateEventDialogFilterOrder,
 		UpdateEventDialogFilters,