feat: migrate /ranking/class

src/models/RivalUser.tsp

@@ -0,0 +1,17 @@
+namespace SolvedAC;
+
+model RivalUser is User {
+  /**
+   * 라이벌 여부입니다.
+   *
+   * @example false
+   */
+  isRival: boolean;
+
+  /**
+   * 역라이벌 여부입니다.
+   *
+   * @example false
+   */
+  isReverseRival: boolean;
+}

src/models/UserWithSocial.tsp → src/models/SocialUser.tsp

@@ -3,7 +3,7 @@ namespace SolvedAC;
 /**
  * solved.ac 사용자 정보입니다.
  */
-model UserWithSocial is User {
+model SocialUser is User {
   /**
    * 라이벌 여부입니다.
    *

src/models/User.tsp

@@ -207,7 +207,9 @@ model User {
   proUntil: offsetDateTime;
 
   /**
-   * 사용자의 문제 풀이 레이팅 순위입니다.
+   * 사용자의 순위입니다.
+   * 이 값은 요청하는 엔드포인트의 정렬 기준에 따라 다를 수 있습니다.
+   * 예) /ranking/* 엔드포인트에서는 해당 랭킹의 순위, /show 엔드포인트에서는 문제풀이 레이팅 순위
    *
    * @example 130
    */

src/models/_barrel.tsp

@@ -15,5 +15,6 @@ import "./ProblemTagAlias.tsp";
 import "./ProblemTag.tsp";
 import "./PaginatedList.tsp";
 import "./User.tsp";
+import "./RivalUser.tsp";
+import "./SocialUser.tsp";
 import "./ArenaTier.tsp";
-import "./UserWithSocial.tsp";

src/openapi.yaml

@@ -38,8 +38,6 @@ paths:
     $ref: "./paths/problem/class.yaml#/paths/Path"
   /ranking/tier:
     $ref: "./paths/ranking/tier.yaml#/paths/Path"
-  /ranking/class:
-    $ref: "./paths/ranking/class.yaml#/paths/Path"
   /ranking/streak:
     $ref: "./paths/ranking/streak.yaml#/paths/Path"
   /ranking/rival:

src/operations/ranking/_barrel.tsp

@@ -1 +1,2 @@
 import "./contribution.tsp";
+import "./class.tsp";

src/operations/ranking/class.tsp

@@ -0,0 +1,35 @@
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace SolvedAC;
+
+/**
+ * CLASS가 높은 사용자가 먼저 오도록 정렬한 사용자 목록을 가져옵니다.
+ *
+ * @return
+ *     페이지네이션 가능한 사용자 목록을 반환합니다.
+ */
+@summary("CLASS 순으로 정렬해 사용자 목록 가져오기")
+@tag("ranking")
+@get
+@route("/ranking/class")
+op getRankingByClass(
+  /**
+   * 응답을 받을 언어입니다.
+   */
+  @header
+  `x-solvedac-language`?: Language,
+
+  /**
+   * 페이지
+   */
+  @query
+  page?: uint32,
+): GetRankingByClass.Ok;
+
+namespace GetRankingByClass {
+  @extension(XInternal, true)
+  model Ok is PaginatedList<RivalUser> {
+    @statusCode status: 200;
+  }
+}

src/operations/ranking/contribution.tsp

@@ -29,7 +29,7 @@ op getRankingByContribution(
 
 namespace GetRankingByContribution {
   @extension(XInternal, true)
-  model Ok is PaginatedList<User> {
+  model Ok is PaginatedList<RivalUser> {
     @statusCode status: 200;
   }
 }

src/operations/user/show.tsp

@@ -32,7 +32,7 @@ op getUserByHandle(
 
 namespace GetUserByHandle {
   @extension(XInternal, true)
-  model Ok is UserWithSocial {
+  model Ok is SocialUser {
     @statusCode status: 200;
   }
 }