lxns-rhythm-api 0.1.11 → 0.1.13

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 declare namespace models_d_exports {
-  export { Alias$1 as Alias, AssetType$1 as AssetType, Character, ClassEmblem, ClearType, Collection$1 as Collection, CollectionRequired$1 as CollectionRequired, CollectionRequiredSong$1 as CollectionRequiredSong, FullChainType, FullComboType, Genre$1 as Genre, LevelIndex$1 as LevelIndex, MapIcon, NamePlate$1 as NamePlate, Notes$1 as Notes, Player$1 as Player, RankType, RatingTrend$1 as RatingTrend, Score$1 as Score, SimpleScore$1 as SimpleScore, Song$2 as Song, SongDifficulty$1 as SongDifficulty, SongType$1 as SongType, Team, Trophy$1 as Trophy, TrophyColor, Version$1 as Version };
+  export { Alias$3 as Alias, AssetType$1 as AssetType, Character, ClassEmblem, ClearType, Collection$1 as Collection, CollectionRequired$1 as CollectionRequired, CollectionRequiredSong$1 as CollectionRequiredSong, FullChainType, FullComboType, Genre$1 as Genre, LevelIndex$1 as LevelIndex, MapIcon, NamePlate$1 as NamePlate, Notes$1 as Notes, Player$1 as Player, RankType, RatingTrend$1 as RatingTrend, Score$1 as Score, SimpleScore$1 as SimpleScore, Song$2 as Song, SongDifficulty$1 as SongDifficulty, SongType$1 as SongType, Team, Trophy$1 as Trophy, TrophyColor, Version$1 as Version };
 }
 interface Notes$1 {
   total: number;
@@ -61,7 +61,7 @@ interface Version$1 {
   title: string;
   version: number;
 }
-interface Alias$1 {
+interface Alias$3 {
   song_id: number;
   aliases: string[];
 }
@@ -155,7 +155,7 @@ interface NamePlate$1 extends Collection$1 {}
 interface MapIcon extends Collection$1 {}
 type AssetType$1 = "character" | "trophy" | "plate" | "icon" | "jacket" | "music";
 declare namespace models_d_exports$1 {
-  export { Alias, AssetType, BuddyNotes, Collection, CollectionGenre, CollectionRequired, CollectionRequiredSong, FCType, FSType, Frame, Genre, Icon, LevelIndex, NamePlate, Notes, Player, RateType, RatingTrend, Score, SimpleScore, Song$1 as Song, SongDifficulties, SongDifficulty, SongDifficultyUtage, SongType, Trophy, Version };
+  export { Alias$2 as Alias, AssetType, BuddyNotes, Collection, CollectionGenre, CollectionRequired, CollectionRequiredSong, FCType, FSType, Frame, Genre, Icon, LevelIndex, NamePlate, Notes, Player, RateType, RatingTrend, Score, SimpleScore, Song$1 as Song, SongDifficulties, SongDifficulty, SongDifficultyUtage, SongType, Trophy, Version };
 }
 interface Notes {
   total: number;
@@ -260,7 +260,7 @@ interface Version {
   /** 主要版本 ID */
   version: number;
 }
-interface Alias {
+interface Alias$2 {
   /** 歌曲 ID */
   song_id: number;
   /** 别名 */
@@ -395,12 +395,12 @@ interface SimpleScore {
 interface RatingTrend {
   /** 总 DX Rating */
   total: number;
-  /** 旧版本谱面总 DX Rating */
-  standard: number;
-  /** 现版本谱面总 DX Rating */
-  dx: number;
+  /** 旧版本谱面总 DX Rating (B35) */
+  standard_total: number;
+  /** 现版本谱面总 DX Rating (B15) */
+  dx_total: number;
   /** 日期 */
-  date: string;
+  date: string | number;
 }
 interface Trophy extends Collection {}
 interface Icon extends Collection {}
@@ -929,7 +929,128 @@ declare class HTTPError<T = unknown> extends Error {
 }
 //#endregion
 //#region src/api/chunithm/types/personal-types.d.ts
+type PlayerUpdate$1 = Partial<Player$1>;
 type PlayerScores$1 = Score$1[];
+interface Bests$3 {
+  bests: Score$1[];
+  selections: Score$1[];
+  new_bests: Score$1[];
+  recents?: Score$1[];
+}
+interface ScoreQuery$1 {
+  songId?: number;
+  songType?: SongType$1;
+  levelIndex?: LevelIndex$1 | number;
+}
+interface ScoreKey$1 {
+  songId: number;
+  songType?: SongType$1;
+  levelIndex: LevelIndex$1 | number;
+}
+interface RankingScore$1 {
+  ranking: number;
+  player_name?: string;
+  score?: number;
+  upload_time: string;
+}
+type ScoreHistory$3 = Score$1[];
+type Heatmap$3 = Record<string, number>;
+type PlayerCollectionListType$1 = "trophies" | "characters" | "plates" | "icons";
+type PlayerCollectionType$1 = "trophy" | "character" | "plate" | "icon";
+type PlayerCollectionList$1 = Collection$1[];
+interface UserConfig$1 {
+  allow_crawl_scores?: boolean;
+  allow_crawl_name_plate?: boolean;
+  allow_crawl_frame?: boolean;
+  allow_crawl_map_icon?: boolean;
+  crawl_scores_method?: string;
+  crawl_scores_difficulty?: string[];
+  allow_third_party_fetch_player?: boolean;
+  allow_third_party_fetch_scores?: boolean;
+  allow_third_party_fetch_history?: boolean;
+  allow_third_party_write_data?: boolean;
+  show_player_name_in_score_ranking?: boolean;
+}
+type UserConfigUpdate$1 = Partial<UserConfig$1>;
+interface YearInReview$3 {
+  game: string;
+  year: number;
+  latest_version: number;
+  player_name: string;
+  player_avatar_id: number;
+  [key: string]: unknown;
+}
+interface CreateYearInReviewShareRequest$1 {
+  public?: boolean;
+}
+interface YearInReviewShare$1 {
+  share_token: string;
+  [key: string]: unknown;
+}
+type ScoreExportType$1 = "csv" | (string & {});
+interface AliasListOptions$1 {
+  page?: number;
+  sort?: string;
+  approved?: boolean;
+  songId?: number;
+}
+interface AliasList$3 {
+  aliases: Alias$1[];
+  page_count: number;
+  page_size: number;
+}
+interface Alias$1 {
+  alias_id: number;
+  song: {
+    id: number;
+    name: string;
+  };
+  song_type: string;
+  difficulty: number;
+  alias: string;
+  approved: boolean;
+  weight: {
+    up: number;
+    down: number;
+    total: number;
+  };
+  uploader: {
+    id: number;
+    name: string;
+  };
+  upload_time: string;
+  vote?: AliasVote$1;
+}
+interface AliasVote$1 {
+  alias_id?: number;
+  vote_id?: number;
+  weight: number;
+}
+interface CreateAliasRequest$1 {
+  song_id: number;
+  alias: string;
+}
+interface CommentQuery$1 extends ScoreKey$1 {}
+interface Comment$1 {
+  comment_id: number;
+  comment?: string;
+  rating?: number;
+  is_liked: boolean;
+  like_count: number;
+  upload_time: string;
+  uploader: {
+    id: number;
+    name: string;
+    avatar_id?: number;
+  };
+}
+interface CreateCommentRequest$1 {
+  song_id: number;
+  song_type?: SongType$1 | null;
+  difficulty: LevelIndex$1 | number;
+  comment?: string;
+  rating?: number;
+}
 //#endregion
 //#region src/api/chunithm/personal-api.d.ts
 /**
@@ -943,6 +1064,16 @@ declare class ChunithmPersonalApi {
    * GET /api/v0/user/chunithm/player
    */
   getPlayer(): Promise<Player$1>;
+  /**
+   * 更新玩家信息
+   * PUT /api/v0/user/chunithm/player
+   */
+  updatePlayer(player: PlayerUpdate$1): Promise<Player$1>;
+  /**
+   * 解绑玩家信息
+   * DELETE /api/v0/user/chunithm/player
+   */
+  deletePlayer(): Promise<unknown>;
   /**
    * 获取玩家所有成绩
    * GET /api/v0/user/chunithm/player/scores
@@ -953,10 +1084,265 @@ declare class ChunithmPersonalApi {
    * POST /api/v0/user/chunithm/player/scores
    */
   postScores(scores: Score$1[]): Promise<unknown>;
+  /**
+   * 删除玩家成绩。不传参数时删除全部成绩，传参数时删除匹配的历史成绩。
+   * DELETE /api/v0/user/chunithm/player/scores
+   */
+  deleteScores(options?: ScoreQuery$1): Promise<unknown>;
+  /**
+   * 删除单条最佳成绩
+   * DELETE /api/v0/user/chunithm/player/score
+   */
+  deleteScore(options: ScoreKey$1): Promise<unknown>;
+  /**
+   * 获取玩家 Best 成绩。传 songId 时返回指定曲目的最佳成绩列表。
+   * GET /api/v0/user/chunithm/player/bests
+   */
+  getBests(): Promise<Bests$3>;
+  getBests(options: ScoreQuery$1): Promise<PlayerScores$1>;
+  /**
+   * 获取单谱面成绩排行
+   * GET /api/v0/user/chunithm/player/score/ranking
+   */
+  getScoreRanking(options: ScoreKey$1): Promise<RankingScore$1[]>;
+  /**
+   * 获取单谱面成绩历史
+   * GET /api/v0/user/chunithm/player/score/history
+   */
+  getScoreHistory(options: ScoreKey$1): Promise<ScoreHistory$3>;
+  /**
+   * 获取成绩上传热力图
+   * GET /api/v0/user/chunithm/player/heatmap
+   */
+  getHeatmap(): Promise<Heatmap$3>;
+  /**
+   * 获取 Rating 趋势
+   * GET /api/v0/user/chunithm/player/trend
+   */
+  getTrend(version?: number): Promise<RatingTrend$1[]>;
+  /**
+   * 获取玩家已获得的收藏品列表
+   * GET /api/v0/user/chunithm/player/{collectionType}
+   */
+  getPlayerCollectionList(collectionType: PlayerCollectionListType$1): Promise<PlayerCollectionList$1>;
+  /**
+   * 获取玩家收藏品进度
+   * GET /api/v0/user/chunithm/player/{collectionType}/{id}
+   */
+  getPlayerCollection(collectionType: PlayerCollectionType$1, id: number): Promise<Collection$1>;
+  /**
+   * 通过 NET 的 HTML 源代码同步玩家数据
+   * POST /api/v0/user/chunithm/player/html
+   */
+  postHtml(htmlSource: string): Promise<unknown>;
+  /**
+   * 导出玩家成绩
+   * GET /api/v0/user/chunithm/player/scores/export/{type}
+   */
+  exportScores(type?: ScoreExportType$1): Promise<Uint8Array<ArrayBuffer>>;
+  /**
+   * 导入玩家成绩
+   * POST /api/v0/user/chunithm/player/scores/import
+   */
+  importScores(file: Blob, fileName?: string): Promise<unknown>;
+  /**
+   * 获取玩家年度总结
+   * GET /api/v0/user/chunithm/player/year-in-review/{year}
+   */
+  getYearInReview(year: number, options?: {
+    agree?: boolean;
+  }): Promise<YearInReview$3>;
+  /**
+   * 生成年度总结分享链接
+   * POST /api/v0/user/chunithm/player/year-in-review/{year}/share
+   */
+  createYearInReviewShare(year: number, body?: CreateYearInReviewShareRequest$1): Promise<YearInReviewShare$1>;
+  /**
+   * 获取游戏个人配置
+   * GET /api/v0/user/chunithm/config
+   */
+  getConfig(): Promise<UserConfig$1>;
+  /**
+   * 更新游戏个人配置
+   * POST /api/v0/user/chunithm/config
+   */
+  updateConfig(config: UserConfigUpdate$1): Promise<UserConfig$1>;
+  /**
+   * 获取登录用户可见的别名列表
+   * GET /api/v0/user/chunithm/alias/list
+   */
+  getAliasList(options?: AliasListOptions$1): Promise<AliasList$3>;
+  /**
+   * 获取登录用户的别名投票记录
+   * GET /api/v0/user/chunithm/alias/votes
+   */
+  getAliasVotes(): Promise<AliasVote$1[]>;
+  /**
+   * 创建曲目别名
+   * POST /api/v0/user/chunithm/alias
+   */
+  createAlias(body: CreateAliasRequest$1): Promise<unknown>;
+  /**
+   * 为曲目别名投票
+   * POST /api/v0/user/chunithm/alias/{aliasId}/vote/{up|down}
+   */
+  voteAlias(aliasId: number, vote: "up" | "down" | boolean): Promise<unknown>;
+  /**
+   * 删除当前用户创建的曲目别名
+   * DELETE /api/v0/user/chunithm/alias/{aliasId}
+   */
+  deleteAlias(aliasId: number): Promise<unknown>;
+  /**
+   * 获取谱面评论
+   * GET /api/v0/user/chunithm/comment/list
+   */
+  getComments(options: CommentQuery$1): Promise<Comment$1[]>;
+  /**
+   * 创建或更新谱面评论
+   * POST /api/v0/user/chunithm/comment
+   */
+  createComment(body: CreateCommentRequest$1): Promise<unknown>;
+  /**
+   * 删除谱面评论
+   * DELETE /api/v0/user/chunithm/comment/{commentId}
+   */
+  deleteComment(commentId: number): Promise<unknown>;
+  /**
+   * 点赞谱面评论
+   * POST /api/v0/user/chunithm/comment/{commentId}/like
+   */
+  likeComment(commentId: number): Promise<unknown>;
+  /**
+   * 取消点赞谱面评论
+   * DELETE /api/v0/user/chunithm/comment/{commentId}/like
+   */
+  unlikeComment(commentId: number): Promise<unknown>;
 }
 //#endregion
 //#region src/api/maimai/types/personal-types.d.ts
+type PlayerUpdate = Partial<Player>;
 type PlayerScores = Score[];
+interface Bests$2 {
+  standard: Score[];
+  dx: Score[];
+  standard_total: number;
+  dx_total: number;
+}
+interface ScoreQuery {
+  songId?: number;
+  songType?: SongType;
+  levelIndex?: LevelIndex | number;
+}
+interface ScoreKey {
+  songId: number;
+  songType?: SongType;
+  levelIndex: LevelIndex | number;
+}
+interface RankingScore {
+  ranking: number;
+  player_name?: string;
+  achievements?: number;
+  dx_score?: number;
+  upload_time: string;
+}
+type ScoreHistory$2 = Score[];
+type Heatmap$2 = Record<string, number>;
+type PlayerCollectionListType = "trophies" | "icons" | "plates" | "frames";
+type PlayerCollectionType = "trophy" | "icon" | "plate" | "frame";
+type PlayerCollectionList = Collection[];
+interface UserConfig {
+  allow_crawl_scores?: boolean;
+  allow_crawl_name_plate?: boolean;
+  allow_crawl_frame?: boolean;
+  allow_crawl_map_icon?: boolean;
+  crawl_scores_method?: string;
+  crawl_scores_difficulty?: string[];
+  allow_third_party_fetch_player?: boolean;
+  allow_third_party_fetch_scores?: boolean;
+  allow_third_party_fetch_history?: boolean;
+  allow_third_party_write_data?: boolean;
+  show_player_name_in_score_ranking?: boolean;
+}
+type UserConfigUpdate = Partial<UserConfig>;
+interface YearInReview$2 {
+  game: string;
+  year: number;
+  latest_version: number;
+  player_name: string;
+  player_avatar_id: number;
+  [key: string]: unknown;
+}
+interface CreateYearInReviewShareRequest {
+  public?: boolean;
+}
+interface YearInReviewShare {
+  share_token: string;
+  [key: string]: unknown;
+}
+type ScoreExportType = "csv" | (string & {});
+interface AliasListOptions {
+  page?: number;
+  sort?: string;
+  approved?: boolean;
+  songId?: number;
+}
+interface AliasList$2 {
+  aliases: Alias[];
+  page_count: number;
+  page_size: number;
+}
+interface Alias {
+  alias_id: number;
+  song: {
+    id: number;
+    name: string;
+  };
+  song_type: string;
+  difficulty: number;
+  alias: string;
+  approved: boolean;
+  weight: {
+    up: number;
+    down: number;
+    total: number;
+  };
+  uploader: {
+    id: number;
+    name: string;
+  };
+  upload_time: string;
+  vote?: AliasVote;
+}
+interface AliasVote {
+  alias_id?: number;
+  vote_id?: number;
+  weight: number;
+}
+interface CreateAliasRequest {
+  song_id: number;
+  alias: string;
+}
+interface CommentQuery extends ScoreKey {}
+interface Comment {
+  comment_id: number;
+  comment?: string;
+  rating?: number;
+  is_liked: boolean;
+  like_count: number;
+  upload_time: string;
+  uploader: {
+    id: number;
+    name: string;
+    avatar_id?: number;
+  };
+}
+interface CreateCommentRequest {
+  song_id: number;
+  song_type?: SongType | null;
+  difficulty: LevelIndex | number;
+  comment?: string;
+  rating?: number;
+}
 //#endregion
 //#region src/api/maimai/personal-api.d.ts
 /**
@@ -971,6 +1357,16 @@ declare class MaimaiPersonalApi {
    * @returns PlayerInfo
    */
   getPlayer(): Promise<Player>;
+  /**
+   * 更新玩家信息
+   * PUT /api/v0/user/maimai/player
+   */
+  updatePlayer(player: PlayerUpdate): Promise<Player>;
+  /**
+   * 解绑玩家信息
+   * DELETE /api/v0/user/maimai/player
+   */
+  deletePlayer(): Promise<unknown>;
   /**
    * 获取玩家所有成绩
    * GET /api/v0/user/maimai/player/scores
@@ -984,6 +1380,139 @@ declare class MaimaiPersonalApi {
    * @returns 上传结果
    */
   postScores(scores: Score[]): Promise<unknown>;
+  /**
+   * 删除玩家成绩。不传参数时删除全部成绩，传参数时删除匹配的历史成绩。
+   * DELETE /api/v0/user/maimai/player/scores
+   */
+  deleteScores(options?: ScoreQuery): Promise<unknown>;
+  /**
+   * 删除单条最佳成绩
+   * DELETE /api/v0/user/maimai/player/score
+   */
+  deleteScore(options: ScoreKey): Promise<unknown>;
+  /**
+   * 获取玩家 Best 成绩。传 songId 时返回指定曲目的最佳成绩列表。
+   * GET /api/v0/user/maimai/player/bests
+   */
+  getBests(): Promise<Bests$2>;
+  getBests(options: ScoreQuery): Promise<PlayerScores>;
+  /**
+   * 获取单谱面成绩排行
+   * GET /api/v0/user/maimai/player/score/ranking
+   */
+  getScoreRanking(options: ScoreKey): Promise<RankingScore[]>;
+  /**
+   * 获取单谱面成绩历史
+   * GET /api/v0/user/maimai/player/score/history
+   */
+  getScoreHistory(options: ScoreKey): Promise<ScoreHistory$2>;
+  /**
+   * 获取成绩上传热力图
+   * GET /api/v0/user/maimai/player/heatmap
+   */
+  getHeatmap(): Promise<Heatmap$2>;
+  /**
+   * 获取 DX Rating 趋势
+   * GET /api/v0/user/maimai/player/trend
+   */
+  getTrend(version?: number): Promise<RatingTrend[]>;
+  /**
+   * 获取玩家已获得的收藏品列表
+   * GET /api/v0/user/maimai/player/{collectionType}
+   */
+  getPlayerCollectionList(collectionType: PlayerCollectionListType): Promise<PlayerCollectionList>;
+  /**
+   * 获取玩家收藏品进度
+   * GET /api/v0/user/maimai/player/{collectionType}/{id}
+   */
+  getPlayerCollection(collectionType: PlayerCollectionType, id: number): Promise<Collection>;
+  /**
+   * 通过 NET 的 HTML 源代码同步玩家数据
+   * POST /api/v0/user/maimai/player/html
+   */
+  postHtml(htmlSource: string): Promise<unknown>;
+  /**
+   * 导出玩家成绩
+   * GET /api/v0/user/maimai/player/scores/export/{type}
+   */
+  exportScores(type?: ScoreExportType): Promise<Uint8Array<ArrayBuffer>>;
+  /**
+   * 导入玩家成绩
+   * POST /api/v0/user/maimai/player/scores/import
+   */
+  importScores(file: Blob, fileName?: string): Promise<unknown>;
+  /**
+   * 获取玩家年度总结
+   * GET /api/v0/user/maimai/player/year-in-review/{year}
+   */
+  getYearInReview(year: number, options?: {
+    agree?: boolean;
+  }): Promise<YearInReview$2>;
+  /**
+   * 生成年度总结分享链接
+   * POST /api/v0/user/maimai/player/year-in-review/{year}/share
+   */
+  createYearInReviewShare(year: number, body?: CreateYearInReviewShareRequest): Promise<YearInReviewShare>;
+  /**
+   * 获取游戏个人配置
+   * GET /api/v0/user/maimai/config
+   */
+  getConfig(): Promise<UserConfig>;
+  /**
+   * 更新游戏个人配置
+   * POST /api/v0/user/maimai/config
+   */
+  updateConfig(config: UserConfigUpdate): Promise<UserConfig>;
+  /**
+   * 获取登录用户可见的别名列表
+   * GET /api/v0/user/maimai/alias/list
+   */
+  getAliasList(options?: AliasListOptions): Promise<AliasList$2>;
+  /**
+   * 获取登录用户的别名投票记录
+   * GET /api/v0/user/maimai/alias/votes
+   */
+  getAliasVotes(): Promise<AliasVote[]>;
+  /**
+   * 创建曲目别名
+   * POST /api/v0/user/maimai/alias
+   */
+  createAlias(body: CreateAliasRequest): Promise<unknown>;
+  /**
+   * 为曲目别名投票
+   * POST /api/v0/user/maimai/alias/{aliasId}/vote/{up|down}
+   */
+  voteAlias(aliasId: number, vote: "up" | "down" | boolean): Promise<unknown>;
+  /**
+   * 删除当前用户创建的曲目别名
+   * DELETE /api/v0/user/maimai/alias/{aliasId}
+   */
+  deleteAlias(aliasId: number): Promise<unknown>;
+  /**
+   * 获取谱面评论
+   * GET /api/v0/user/maimai/comment/list
+   */
+  getComments(options: CommentQuery): Promise<Comment[]>;
+  /**
+   * 创建或更新谱面评论
+   * POST /api/v0/user/maimai/comment
+   */
+  createComment(body: CreateCommentRequest): Promise<unknown>;
+  /**
+   * 删除谱面评论
+   * DELETE /api/v0/user/maimai/comment/{commentId}
+   */
+  deleteComment(commentId: number): Promise<unknown>;
+  /**
+   * 点赞谱面评论
+   * POST /api/v0/user/maimai/comment/{commentId}/like
+   */
+  likeComment(commentId: number): Promise<unknown>;
+  /**
+   * 取消点赞谱面评论
+   * DELETE /api/v0/user/maimai/comment/{commentId}/like
+   */
+  unlikeComment(commentId: number): Promise<unknown>;
 }
 //#endregion
 //#region src/api/oauth/user.d.ts
@@ -1179,7 +1708,15 @@ interface SongList$1 {
   versions: Version$1[];
 }
 interface AliasList$1 {
-  aliases: Alias$1[];
+  aliases: Alias$3[];
+}
+interface YearInReview$1 {
+  game: string;
+  year: number;
+  latest_version: number;
+  player_name: string;
+  player_avatar_id: number;
+  [key: string]: unknown;
 }
 //#endregion
 //#region src/api/chunithm/public-api.d.ts
@@ -1209,6 +1746,13 @@ declare class ChunithmPublicApi {
    * 获取收藏品信息
    */
   getCollectionInfo(collectionType: "trophy" | "character" | "plate" | "icon", id: number, version?: number): Promise<Collection$1>;
+  /**
+   * 获取公开分享的年度总结
+   * GET /api/v0/chunithm/year-in-review/{year}/share/{shareToken}
+   */
+  getYearInReviewShare(year: number, shareToken: string, options?: {
+    agree?: boolean;
+  }): Promise<YearInReview$1>;
 }
 //#endregion
 //#region src/api/maimai/types/dev-types.d.ts
@@ -1282,9 +1826,10 @@ declare class MaimaiDevApi {
   /**
    * DX Rating 趋势
    * @param friendCode 好友码
+   * @param version 游戏版本（可选）
    * @returns TrendList
    */
-  getTrend(friendCode: number): Promise<TrendList>;
+  getTrend(friendCode: number, version?: number): Promise<TrendList>;
   /**
    * 成绩游玩历史记录（仅返回带有 play_time 的成绩）
    * @param friendCode 好友码
@@ -1352,11 +1897,19 @@ interface SongList {
   versions: Version[];
 }
 interface AliasList {
-  aliases: Alias[];
+  aliases: Alias$2[];
 }
 interface CollectionGenreList {
   collectionGenres: CollectionGenre[];
 }
+interface YearInReview {
+  game: string;
+  year: number;
+  latest_version: number;
+  player_name: string;
+  player_avatar_id: number;
+  [key: string]: unknown;
+}
 //#endregion
 //#region src/api/maimai/public-api.d.ts
 /**
@@ -1421,6 +1974,13 @@ declare class MaimaiPublicApi {
   getCollectionGenreInfo(id: number, options?: {
     version?: number;
   }): Promise<CollectionGenre>;
+  /**
+   * 获取公开分享的年度总结
+   * GET /api/v0/maimai/year-in-review/{year}/share/{shareToken}
+   */
+  getYearInReviewShare(year: number, shareToken: string, options?: {
+    agree?: boolean;
+  }): Promise<YearInReview>;
 }
 //#endregion
 //#region src/client/lxns-api-client-types.d.ts