fix: sync star gift profile pin order

Sync telesrv 6fcc6f0 (fix(stargifts): honor profile pin order).

Skipped telesrv docs changes per public sync rules.

internal/store/postgres/star_gift.go

@@ -535,9 +535,27 @@ WHERE ci.saved_gift_id = p.id AND ci.collection_id = $%d
 	}
 	page := domain.SavedStarGiftPage{Count: total}
 
-	if cursor, ok := domain.DecodeStarGiftCursor(offset); ok {
-		args = append(args, cursor)
-		where += fmt.Sprintf(" AND p.id < $%d", len(args))
+	profileOrder := filter.CollectionID == 0
+	if cursor, ok := domain.DecodeSavedStarGiftListCursor(offset); ok {
+		if profileOrder && cursor.PinnedOrder > 0 {
+			args = append(args, cursor.PinnedOrder, cursor.ID)
+			where += fmt.Sprintf(` AND (
+    p.pinned_order = 0
+    OR p.pinned_order > $%d
+    OR (p.pinned_order = $%d AND p.id < $%d)
+)`, len(args)-1, len(args)-1, len(args))
+		} else {
+			args = append(args, cursor.ID)
+			if profileOrder {
+				where += fmt.Sprintf(" AND p.pinned_order = 0 AND p.id < $%d", len(args))
+			} else {
+				where += fmt.Sprintf(" AND p.id < $%d", len(args))
+			}
+		}
+	}
+	orderBy := "ORDER BY p.id DESC"
+	if profileOrder {
+		orderBy = "ORDER BY (p.pinned_order = 0), p.pinned_order, p.id DESC"
 	}
 	args = append(args, limit+1)
 	limitPlaceholder := len(args)
@@ -553,7 +571,7 @@ SELECT p.id, p.owner_peer_type, p.owner_peer_id, p.from_user_id, p.gift_id, p.ca
                  WHERE i.saved_gift_id=p.id), ARRAY[]::integer[])
 FROM peer_star_gifts p `+joins+`
 WHERE `+where+`
-ORDER BY p.id DESC
+`+orderBy+`
 LIMIT $`+fmt.Sprint(limitPlaceholder), args...)
 	if err != nil {
 		return domain.SavedStarGiftPage{}, fmt.Errorf("list star gifts: %w", err)
@@ -572,7 +590,12 @@ LIMIT $`+fmt.Sprint(limitPlaceholder), args...)
 	}
 	if len(gifts) > limit {
 		gifts = gifts[:limit]
-		page.NextOffset = domain.EncodeStarGiftCursor(gifts[len(gifts)-1].ID)
+		last := gifts[len(gifts)-1]
+		pinnedOrder := 0
+		if profileOrder {
+			pinnedOrder = last.PinnedOrder
+		}
+		page.NextOffset = domain.EncodeSavedStarGiftListCursor(pinnedOrder, last.ID)
 	}
 	page.Gifts = gifts
 	return page, nil

internal/store/postgres/star_gift_integration_test.go

@@ -4,6 +4,7 @@ import (
 	"context"
 	"errors"
 	"fmt"
+	"slices"
 	"testing"
 	"time"
 
@@ -57,13 +58,16 @@ func TestStarGiftStorePostgres(t *testing.T) {
 	})
 
 	// 创建三份礼物（msg_id 递增）。
+	savedIDs := make([]int64, 3)
 	for i := 0; i < 3; i++ {
-		if _, err := st.Create(ctx, domain.SavedStarGift{
+		savedID, err := st.Create(ctx, domain.SavedStarGift{
 			Owner: ownerPeer, FromUserID: from.ID, GiftID: entry.Gift.ID, RevisionID: entry.Gift.RevisionID, MsgID: 100 + i,
 			Date: 1700000000 + i, ConvertStars: 50,
-		}); err != nil {
+		})
+		if err != nil {
 			t.Fatalf("create gift #%d: %v", i, err)
 		}
+		savedIDs[i] = savedID
 	}
 
 	// active revision 更新后，已收到的礼物必须继续固定到购买瞬间的 immutable revision。
@@ -113,6 +117,35 @@ func TestStarGiftStorePostgres(t *testing.T) {
 		t.Fatalf("page2 = %d next %q, want 1 + empty (terminal)", len(page2.Gifts), page2.NextOffset)
 	}
 
+	// 资料页顺序：完整 pin vector 的顺序必须成为列表前缀；游标即使切在
+	// pinned block 内或 pinned/unpinned 边界，也不能重复或漏项。
+	if err := st.SetPinned(ctx, ownerPeer, []int64{savedIDs[0], savedIDs[2]}); err != nil {
+		t.Fatalf("set pinned profile order: %v", err)
+	}
+	wantMsgIDs := []int{100, 102, 101}
+	gotMsgIDs := make([]int, 0, len(wantMsgIDs))
+	offset := ""
+	for pageNumber := 0; ; pageNumber++ {
+		page, err := st.ListByOwner(ctx, ownerPeer, false, offset, 1)
+		if err != nil {
+			t.Fatalf("list pinned page %d: %v", pageNumber, err)
+		}
+		if page.Count != 3 || len(page.Gifts) != 1 {
+			t.Fatalf("pinned page %d = %+v, want count=3 and one gift", pageNumber, page)
+		}
+		gotMsgIDs = append(gotMsgIDs, page.Gifts[0].MsgID)
+		if page.NextOffset == "" {
+			break
+		}
+		offset = page.NextOffset
+	}
+	if !slices.Equal(gotMsgIDs, wantMsgIDs) {
+		t.Fatalf("pinned paged msg ids = %v, want %v", gotMsgIDs, wantMsgIDs)
+	}
+	if err := st.SetPinned(ctx, ownerPeer, nil); err != nil {
+		t.Fatalf("clear pinned profile order: %v", err)
+	}
+
 	// 隐藏 msg_id=101 → excludeUnsaved 列表少一份。
 	if ok, err := st.SetUnsaved(ctx, domain.SavedStarGiftRef{Owner: ownerPeer, MsgID: 101}, true); err != nil || !ok {
 		t.Fatalf("set unsaved = %v err %v", ok, err)

internal/store/postgres/star_gift_lifecycle_migration_integration_test.go

@@ -14,7 +14,7 @@ func TestStarGiftLifecycleMigrationsApply(t *testing.T) {
 	if err != nil {
 		t.Fatalf("migrate star gift lifecycle schema: %v", err)
 	}
-	if status.Dirty || status.Empty || status.Version != 105 {
-		t.Fatalf("migration status = %+v, want clean version 105", status)
+	if status.Dirty || status.Empty || status.Version != 106 {
+		t.Fatalf("migration status = %+v, want clean version 106", status)
 	}
 }