move score page fetching to the backend

projects/common/package.json

@@ -20,6 +20,7 @@
   },
   "dependencies": {
     "ky": "^1.7.2",
-    "ws": "^8.18.0"
+    "ws": "^8.18.0",
+    "@typegoose/typegoose": "^12.8.0"
   }
 }

projects/common/src/leaderboard.ts

@@ -0,0 +1,5 @@
+const Leaderboards = {
+  SCORESABER: "scoresaber",
+} as const;
+
+export type Leaderboards = (typeof Leaderboards)[keyof typeof Leaderboards];

projects/common/src/leaderboard/impl/scoresaber-leaderboard.ts

@@ -0,0 +1,63 @@
+import Leaderboard from "../leaderboard";
+import LeaderboardDifficulty from "../leaderboard-difficulty";
+import ScoreSaberLeaderboardToken from "../../types/token/scoresaber/score-saber-leaderboard-token";
+import { getDifficultyFromScoreSaberDifficulty } from "../../utils/scoresaber-utils";
+import { parseDate } from "../../utils/time-utils";
+
+export default interface ScoreSaberLeaderboard extends Leaderboard {
+  /**
+   * The star count for the leaderboard.
+   */
+  readonly stars: number;
+
+  /**
+   * The total amount of plays.
+   */
+  readonly plays: number;
+
+  /**
+   * The amount of plays today.
+   */
+  readonly dailyPlays: number;
+}
+
+/**
+ * Parses a {@link ScoreSaberLeaderboardToken} into a {@link ScoreSaberLeaderboard}.
+ *
+ * @param token the token to parse
+ */
+export function getScoreSaberLeaderboardFromToken(token: ScoreSaberLeaderboardToken): ScoreSaberLeaderboard {
+  const difficulty: LeaderboardDifficulty = {
+    leaderboardId: token.difficulty.leaderboardId,
+    difficulty: getDifficultyFromScoreSaberDifficulty(token.difficulty.difficulty),
+    gameMode: token.difficulty.gameMode,
+    difficultyRaw: token.difficulty.difficultyRaw,
+  };
+  return {
+    id: token.id,
+    songHash: token.songHash,
+    songName: token.songName,
+    songSubName: token.songSubName,
+    songAuthorName: token.songAuthorName,
+    levelAuthorName: token.levelAuthorName,
+    difficulty: difficulty,
+    difficulties:
+      token.difficulties != undefined && token.difficulties.length > 0
+        ? token.difficulties.map(difficulty => {
+            return {
+              leaderboardId: difficulty.leaderboardId,
+              difficulty: getDifficultyFromScoreSaberDifficulty(difficulty.difficulty),
+              gameMode: difficulty.gameMode,
+              difficultyRaw: difficulty.difficultyRaw,
+            };
+          })
+        : [difficulty],
+    maxScore: token.maxScore,
+    ranked: token.ranked,
+    songArt: token.coverImage,
+    timestamp: parseDate(token.createdDate),
+    stars: token.stars,
+    plays: token.plays,
+    dailyPlays: token.dailyPlays,
+  };
+}

projects/common/src/leaderboard/leaderboard-difficulty.ts

@@ -0,0 +1,23 @@
+import { Difficulty } from "../score/difficulty";
+
+export default interface LeaderboardDifficulty {
+  /**
+   * The id of the leaderboard.
+   */
+  leaderboardId: number;
+
+  /**
+   * The difficulty of the leaderboard.
+   */
+  difficulty: Difficulty;
+
+  /**
+   * The game mode of the leaderboard.
+   */
+  gameMode: string;
+
+  /**
+   * The raw difficulty of the leaderboard.
+   */
+  difficultyRaw: string;
+}

projects/common/src/leaderboard/leaderboard.ts

@@ -0,0 +1,75 @@
+import LeaderboardDifficulty from "./leaderboard-difficulty";
+
+export default interface Leaderboard {
+  /**
+   * The id of the leaderboard.
+   * @private
+   */
+  readonly id: number;
+
+  /**
+   * The hash of the song this leaderboard is for.
+   * @private
+   */
+  readonly songHash: string;
+
+  /**
+   * The name of the song this leaderboard is for.
+   * @private
+   */
+  readonly songName: string;
+
+  /**
+   * The sub name of the leaderboard.
+   * @private
+   */
+  readonly songSubName: string;
+
+  /**
+   * The author of the song this leaderboard is for.
+   * @private
+   */
+  readonly songAuthorName: string;
+
+  /**
+   * The author of the level this leaderboard is for.
+   * @private
+   */
+  readonly levelAuthorName: string;
+
+  /**
+   * The difficulty of the leaderboard.
+   * @private
+   */
+  readonly difficulty: LeaderboardDifficulty;
+
+  /**
+   * The difficulties of the leaderboard.
+   * @private
+   */
+  readonly difficulties: LeaderboardDifficulty[];
+
+  /**
+   * The maximum score of the leaderboard.
+   * @private
+   */
+  readonly maxScore: number;
+
+  /**
+   * Whether the leaderboard is ranked.
+   * @private
+   */
+  readonly ranked: boolean;
+
+  /**
+   * The link to the song art.
+   * @private
+   */
+  readonly songArt: string;
+
+  /**
+   * The date the leaderboard was created.
+   * @private
+   */
+  readonly timestamp: Date;
+}

projects/common/src/model/beatsaver/beatsaver-author.ts

@@ -0,0 +1,13 @@
+import { prop } from "@typegoose/typegoose";
+
+export default class BeatsaverAuthor {
+  /**
+   * The id of the author.
+   */
+  @prop({ required: true })
+  id: number;
+
+  constructor(id: number) {
+    this.id = id;
+  }
+}

projects/common/src/model/beatsaver/beatsaver-map.ts

@@ -0,0 +1,51 @@
+import { getModelForClass, modelOptions, prop, ReturnModelType, Severity } from "@typegoose/typegoose";
+import { Document } from "mongoose";
+import BeatsaverAuthor from "./beatsaver-author";
+
+/**
+ * The model for a BeatSaver map.
+ */
+@modelOptions({
+  options: { allowMixed: Severity.ALLOW },
+  schemaOptions: {
+    toObject: {
+      virtuals: true,
+      transform: function (_, ret) {
+        ret.id = ret._id;
+        delete ret._id;
+        delete ret.__v;
+        return ret;
+      },
+    },
+  },
+})
+export class BeatSaverMap {
+  /**
+   * The internal MongoDB ID (_id).
+   */
+  @prop({ required: true })
+  private _id!: string;
+
+  /**
+   * The bsr code for the map.
+   * @private
+   */
+  @prop({ required: true })
+  public bsr!: string;
+
+  /**
+   * The author of the map.
+   */
+  @prop({ required: true, _id: false, type: () => BeatsaverAuthor })
+  public author!: BeatsaverAuthor;
+
+  /**
+   * Exposes `id` as a virtual field mapped from `_id`.
+   */
+  public get id(): string {
+    return this._id;
+  }
+}
+
+export type BeatSaverMapDocument = BeatSaverMap & Document;
+export const BeatSaverMapModel: ReturnModelType<typeof BeatSaverMap> = getModelForClass(BeatSaverMap);

projects/common/src/model/player.ts

@@ -0,0 +1,113 @@
+import { getModelForClass, modelOptions, prop, ReturnModelType, Severity } from "@typegoose/typegoose";
+import { Document } from "mongoose";
+import { PlayerHistory } from "../player/player-history";
+import { formatDateMinimal, getDaysAgoDate, getMidnightAlignedDate } from "../utils/time-utils";
+
+/**
+ * The model for a player.
+ */
+@modelOptions({ options: { allowMixed: Severity.ALLOW } })
+export class Player {
+  /**
+   * The id of the player.
+   */
+  @prop()
+  public _id!: string;
+
+  /**
+   * The player's statistic history.
+   */
+  @prop()
+  private statisticHistory?: Record<string, PlayerHistory>;
+
+  /**
+   * The date the player was last tracked.
+   */
+  @prop()
+  public lastTracked?: Date;
+
+  /**
+   * The date the player was first tracked.
+   */
+  @prop()
+  public trackedSince?: Date;
+
+  /**
+   * Gets the player's statistic history.
+   */
+  public getStatisticHistory(): Record<string, PlayerHistory> {
+    if (this.statisticHistory === undefined) {
+      this.statisticHistory = {};
+    }
+    return this.statisticHistory;
+  }
+
+  /**
+   * Gets the player's history for a specific date.
+   *
+   * @param date the date to get the history for.
+   */
+  public getHistoryByDate(date: Date): PlayerHistory {
+    if (this.statisticHistory === undefined) {
+      this.statisticHistory = {};
+    }
+    return this.getStatisticHistory()[formatDateMinimal(getMidnightAlignedDate(date))] || {};
+  }
+
+  /**
+   * Gets the player's history for the previous X days.
+   *
+   * @param days the number of days to get the history for.
+   */
+  public getHistoryPreviousDays(days: number): Record<string, PlayerHistory> {
+    const statisticHistory = this.getStatisticHistory();
+    const history: Record<string, PlayerHistory> = {};
+
+    for (let i = 0; i < days; i++) {
+      const date = formatDateMinimal(getMidnightAlignedDate(getDaysAgoDate(i)));
+      const playerHistory = statisticHistory[date];
+      if (playerHistory !== undefined && Object.keys(playerHistory).length > 0) {
+        history[date] = playerHistory;
+      }
+    }
+    return history;
+  }
+
+  /**
+   * Sets the player's statistic history.
+   *
+   * @param date the date to set it for.
+   * @param history the history to set.
+   */
+  public setStatisticHistory(date: Date, history: PlayerHistory) {
+    if (this.statisticHistory === undefined) {
+      this.statisticHistory = {};
+    }
+    this.statisticHistory[formatDateMinimal(getMidnightAlignedDate(date))] = history;
+  }
+
+  /**
+   * Sorts the player's statistic history by
+   * date in descending order. (oldest to newest)
+   */
+  public sortStatisticHistory() {
+    if (this.statisticHistory === undefined) {
+      this.statisticHistory = {};
+    }
+    this.statisticHistory = Object.fromEntries(
+      Object.entries(this.statisticHistory).sort((a, b) => new Date(b[0]).getTime() - new Date(a[0]).getTime())
+    );
+  }
+
+  /**
+   * Gets the number of days tracked.
+   *
+   * @returns the number of days tracked.
+   */
+  public getDaysTracked(): number {
+    return Object.keys(this.getStatisticHistory()).length;
+  }
+}
+
+export type PlayerDocument = Player & Document;
+export const PlayerModel: ReturnModelType<typeof Player> = getModelForClass(Player);

projects/common/src/player/impl/scoresaber-player.ts

@@ -1,10 +1,10 @@
 import Player, { StatisticChange } from "../player";
 import ky from "ky";
 import { PlayerHistory } from "../player-history";
-import ScoreSaberPlayerToken from "../../token/scoresaber/score-saber-player-token";
-import { formatDateMinimal, getDaysAgoDate, getMidnightAlignedDate } from "../../../utils/time-utils";
-import { getPageFromRank } from "../../../utils/utils";
-import { Config } from "../../../config";
+import ScoreSaberPlayerToken from "../../types/token/scoresaber/score-saber-player-token";
+import { formatDateMinimal, getDaysAgoDate, getMidnightAlignedDate } from "../../utils/time-utils";
+import { getPageFromRank } from "../../utils/utils";
+import { Config } from "../../config";
 
 /**
  * A ScoreSaber player.

projects/common/src/response/leaderboard-response.ts

@@ -0,0 +1,13 @@
+import { BeatSaverMap } from "../model/beatsaver/beatsaver-map";
+
+export type LeaderboardResponse<L> = {
+  /**
+   * The leaderboard.
+   */
+  leaderboard: L;
+
+  /**
+   * The beatsaver map.
+   */
+  beatsaver?: BeatSaverMap;
+};

projects/common/src/response/leaderboard-scores-response.ts

@@ -0,0 +1,25 @@
+import { Metadata } from "../types/metadata";
+import { BeatSaverMap } from "../model/beatsaver/beatsaver-map";
+import Score from "../score/score";
+
+export default interface LeaderboardScoresResponse<L> {
+  /**
+   * The scores that were set.
+   */
+  readonly scores: Score[];
+
+  /**
+   * The leaderboard that was used.
+   */
+  readonly leaderboard: L;
+
+  /**
+   * The beatsaver map for the song.
+   */
+  readonly beatSaver?: BeatSaverMap;
+
+  /**
+   * The pagination metadata.
+   */
+  readonly metadata: Metadata;
+}

projects/common/src/response/player-scores-response.ts

@@ -0,0 +1,14 @@
+import { Metadata } from "../types/metadata";
+import { PlayerScore } from "../score/player-score";
+
+export default interface PlayerScoresResponse<S, L> {
+  /**
+   * The scores that were set.
+   */
+  readonly scores: PlayerScore<S, L>[];
+
+  /**
+   * The pagination metadata.
+   */
+  readonly metadata: Metadata;
+}

projects/common/src/score/difficulty.ts

@@ -0,0 +1 @@
+export type Difficulty = "Easy" | "Normal" | "Hard" | "Expert" | "Expert+" | "Unknown";

projects/common/src/score/impl/scoresaber-score.ts

@@ -0,0 +1,62 @@
+import Score from "../score";
+import { Modifier } from "../modifier";
+import ScoreSaberScoreToken from "../../types/token/scoresaber/score-saber-score-token";
+import ScoreSaberLeaderboardPlayerInfoToken from "../../types/token/scoresaber/score-saber-leaderboard-player-info-token";
+
+export default interface ScoreSaberScore extends Score {
+  /**
+   * The score's id.
+   */
+  readonly id: string;
+
+  /**
+   * The amount of pp for the score.
+   * @private
+   */
+  readonly pp: number;
+
+  /**
+   * The weight of the score, or undefined if not ranked.s
+   * @private
+   */
+  readonly weight?: number;
+
+  /**
+   * The player who set the score
+   */
+  readonly playerInfo: ScoreSaberLeaderboardPlayerInfoToken;
+}
+
+/**
+ * Gets a {@link ScoreSaberScore} from a {@link ScoreSaberScoreToken}.
+ *
+ * @param token the token to convert
+ */
+export function getScoreSaberScoreFromToken(token: ScoreSaberScoreToken): ScoreSaberScore {
+  const modifiers: Modifier[] =
+    token.modifiers == undefined || token.modifiers === ""
+      ? []
+      : token.modifiers.split(",").map(mod => {
+          mod = mod.toUpperCase();
+          const modifier = Modifier[mod as keyof typeof Modifier];
+          if (modifier === undefined) {
+            throw new Error(`Unknown modifier: ${mod}`);
+          }
+          return modifier;
+        });
+
+  return {
+    leaderboard: "scoresaber",
+    score: token.baseScore,
+    rank: token.rank,
+    modifiers: modifiers,
+    misses: token.missedNotes,
+    badCuts: token.badCuts,
+    fullCombo: token.fullCombo,
+    timestamp: new Date(token.timeSet),
+    id: token.id,
+    pp: token.pp,
+    weight: token.weight,
+    playerInfo: token.leaderboardPlayerInfo,
+  };
+}

projects/common/src/score/modifier.ts

@@ -15,4 +15,6 @@ export enum Modifier {
   CS = "Fail on Saber Clash",
   IF = "One Life",
   BE = "Battery Energy",
+  NF = "No Fail",
+  NB = "No Bombs",
 }

projects/common/src/score/player-leaderboard-score.ts

@@ -0,0 +1,6 @@
+export default interface PlayerLeaderboardScore<S> {
+  /**
+   * The score that was set.
+   */
+  readonly score: S;
+}

projects/common/src/score/player-score.ts

@@ -0,0 +1,18 @@
+import { BeatSaverMap } from "../model/beatsaver/beatsaver-map";
+
+export interface PlayerScore<S, L> {
+  /**
+   * The score.
+   */
+  readonly score: S;
+
+  /**
+   * The leaderboard the score was set on.
+   */
+  readonly leaderboard: L;
+
+  /**
+   * The BeatSaver of the song.
+   */
+  readonly beatSaver?: BeatSaverMap;
+}

projects/common/src/score/score.ts

@@ -0,0 +1,51 @@
+import { Modifier } from "./modifier";
+import { Leaderboards } from "../leaderboard";
+
+export default interface Score {
+  /**
+   * The leaderboard the score is from.
+   */
+  readonly leaderboard: Leaderboards;
+
+  /**
+   * The base score for the score.
+   * @private
+   */
+  readonly score: number;
+
+  /**
+   * The rank for the score.
+   * @private
+   */
+  readonly rank: number;
+
+  /**
+   * The modifiers used on the score.
+   * @private
+   */
+  readonly modifiers: Modifier[];
+
+  /**
+   * The amount missed notes.
+   * @private
+   */
+  readonly misses: number;
+
+  /**
+   * The amount of bad cuts.
+   * @private
+   */
+  readonly badCuts: number;
+
+  /**
+   * Whether every note was hit.
+   * @private
+   */
+  readonly fullCombo: boolean;
+
+  /**
+   * The time the score was set.
+   * @private
+   */
+  readonly timestamp: Date;
+}

projects/common/src/service/impl/scoresaber.ts

@@ -2,7 +2,7 @@ import Service from "../service";
 import { ScoreSaberPlayerSearchToken } from "../../types/token/scoresaber/score-saber-player-search-token";
 import ScoreSaberPlayerToken from "../../types/token/scoresaber/score-saber-player-token";
 import { ScoreSaberPlayersPageToken } from "../../types/token/scoresaber/score-saber-players-page-token";
-import { ScoreSort } from "../../types/score/score-sort";
+import { ScoreSort } from "../../score/score-sort";
 import ScoreSaberPlayerScoresPageToken from "../../types/token/scoresaber/score-saber-player-scores-page-token";
 import ScoreSaberLeaderboardToken from "../../types/token/scoresaber/score-saber-leaderboard-token";
 import ScoreSaberLeaderboardScoresPageToken from "../../types/token/scoresaber/score-saber-leaderboard-scores-page-token";

projects/common/src/service/service.ts

@@ -40,7 +40,6 @@ export default class Service {
     try {
       return await ky.get<T>(this.buildRequestUrl(true, url)).json();
     } catch (error) {
-      console.error(`Error fetching data from ${url}:`, error);
       return undefined;
     }
   }

projects/common/src/types/metadata.ts

@@ -0,0 +1,28 @@
+export class Metadata {
+  /**
+   * The amount of pages in the pagination
+   */
+  public readonly totalPages: number;
+
+  /**
+   * The total amount of items
+   */
+  public readonly totalItems: number;
+
+  /**
+   * The current page
+   */
+  public readonly page: number;
+
+  /**
+   * The amount of items per page
+   */
+  public readonly itemsPerPage: number;
+
+  constructor(totalPages: number, totalItems: number, page: number, itemsPerPage: number) {
+    this.totalPages = totalPages;
+    this.totalItems = totalItems;
+    this.page = page;
+    this.itemsPerPage = itemsPerPage;
+  }
+}

projects/common/src/types/page.ts

@@ -0,0 +1,13 @@
+import { Metadata } from "./metadata";
+
+export type Page<T> = {
+  /**
+   * The data to return.
+   */
+  data: T[];
+
+  /**
+   * The metadata of the page.
+   */
+  metadata: Metadata;
+};

projects/common/src/types/score/impl/scoresaber-score.ts

@@ -1,47 +0,0 @@
-import Score from "../score";
-import { Modifier } from "../modifier";
-import ScoreSaberScoreToken from "../../token/scoresaber/score-saber-score-token";
-
-export default class ScoreSaberScore extends Score {
-  constructor(
-    score: number,
-    weight: number | undefined,
-    rank: number,
-    worth: number,
-    modifiers: Modifier[],
-    misses: number,
-    badCuts: number,
-    fullCombo: boolean,
-    timestamp: Date
-  ) {
-    super(score, weight, rank, worth, modifiers, misses, badCuts, fullCombo, timestamp);
-  }
-
-  /**
-   * Gets a {@link ScoreSaberScore} from a {@link ScoreSaberScoreToken}.
-   *
-   * @param token the token to convert
-   */
-  public static fromToken(token: ScoreSaberScoreToken): ScoreSaberScore {
-    const modifiers: Modifier[] = token.modifiers.split(",").map(mod => {
-      mod = mod.toUpperCase();
-      const modifier = Modifier[mod as keyof typeof Modifier];
-      if (modifier === undefined) {
-        throw new Error(`Unknown modifier: ${mod}`);
-      }
-      return modifier;
-    });
-
-    return new ScoreSaberScore(
-      token.baseScore,
-      token.weight,
-      token.rank,
-      token.pp,
-      modifiers,
-      token.missedNotes,
-      token.badCuts,
-      token.fullCombo,
-      new Date(token.timeSet)
-    );
-  }
-}

projects/common/src/types/score/score.ts

@@ -1,116 +0,0 @@
-import { Modifier } from "./modifier";
-
-export default class Score {
-  /**
-   * The base score for the score.
-   * @private
-   */
-  private readonly _score: number;
-
-  /**
-   * The weight of the score, or undefined if not ranked.s
-   * @private
-   */
-  private readonly _weight: number | undefined;
-
-  /**
-   * The rank for the score.
-   * @private
-   */
-  private readonly _rank: number;
-
-  /**
-   * The worth of the score (this could be pp, ap, cr, etc.),
-   * or undefined if not ranked.
-   * @private
-   */
-  private readonly _worth: number;
-
-  /**
-   * The modifiers used on the score.
-   * @private
-   */
-  private readonly _modifiers: Modifier[];
-
-  /**
-   * The amount missed notes.
-   * @private
-   */
-  private readonly _misses: number;
-
-  /**
-   * The amount of bad cuts.
-   * @private
-   */
-  private readonly _badCuts: number;
-
-  /**
-   * Whether every note was hit.
-   * @private
-   */
-  private readonly _fullCombo: boolean;
-
-  /**
-   * The time the score was set.
-   * @private
-   */
-  private readonly _timestamp: Date;
-
-  constructor(
-    score: number,
-    weight: number | undefined,
-    rank: number,
-    worth: number,
-    modifiers: Modifier[],
-    misses: number,
-    badCuts: number,
-    fullCombo: boolean,
-    timestamp: Date
-  ) {
-    this._score = score;
-    this._weight = weight;
-    this._rank = rank;
-    this._worth = worth;
-    this._modifiers = modifiers;
-    this._misses = misses;
-    this._badCuts = badCuts;
-    this._fullCombo = fullCombo;
-    this._timestamp = timestamp;
-  }
-
-  get score(): number {
-    return this._score;
-  }
-
-  get weight(): number | undefined {
-    return this._weight;
-  }
-
-  get rank(): number {
-    return this._rank;
-  }
-
-  get worth(): number {
-    return this._worth;
-  }
-
-  get modifiers(): Modifier[] {
-    return this._modifiers;
-  }
-
-  get misses(): number {
-    return this._misses;
-  }
-
-  get badCuts(): number {
-    return this._badCuts;
-  }
-
-  get fullCombo(): boolean {
-    return this._fullCombo;
-  }
-
-  get timestamp(): Date {
-    return this._timestamp;
-  }
-}

projects/common/src/types/token/scoresaber/score-saber-leaderboard-token.ts

@@ -19,8 +19,8 @@ export default interface ScoreSaberLeaderboardToken {
   maxPP: number;
   stars: number;
   positiveModifiers: boolean;
-  plays: boolean;
-  dailyPlays: boolean;
+  plays: number;
+  dailyPlays: number;
   coverImage: string;
   difficulties: ScoreSaberDifficultyToken[];
 }

projects/common/src/utils/leaderboard.util.ts

@@ -0,0 +1,14 @@
+import { Config } from "../config";
+import { LeaderboardResponse } from "../response/leaderboard-response";
+import { kyFetch } from "./utils";
+import { Leaderboards } from "../leaderboard";
+
+/**
+ * Fetches the leaderboard
+ *
+ * @param id the leaderboard id
+ * @param leaderboard the leaderboard
+ */
+export async function fetchLeaderboard<L>(leaderboard: Leaderboards, id: string) {
+  return kyFetch<LeaderboardResponse<L>>(`${Config.apiUrl}/leaderboard/${leaderboard}/${id}`);
+}

projects/common/src/utils/player-utils.ts

@@ -1,4 +1,4 @@
-import { PlayerHistory } from "../types/player/player-history";
+import { PlayerHistory } from "../player/player-history";
 import { kyFetch } from "./utils";
 import { Config } from "../config";
 

projects/common/src/utils/score-utils.ts

@@ -0,0 +1,37 @@
+import { Leaderboards } from "../leaderboard";
+import { kyFetch } from "./utils";
+import PlayerScoresResponse from "../response/player-scores-response";
+import { Config } from "../config";
+import { ScoreSort } from "../score/score-sort";
+
+/**
+ * Fetches the player's scores
+ *
+ * @param leaderboard the leaderboard
+ * @param id the player id
+ * @param page the page
+ * @param sort the sort
+ * @param search the search
+ */
+export async function fetchPlayerScores<S, L>(
+  leaderboard: Leaderboards,
+  id: string,
+  page: number,
+  sort: ScoreSort,
+  search?: string
+) {
+  return kyFetch<PlayerScoresResponse<S, L>>(
+    `${Config.apiUrl}/scores/player/${leaderboard}/${id}/${page}/${sort}${search ? `?search=${search}` : ""}`
+  );
+}
+
+/**
+ * Fetches the player's scores
+ *
+ * @param leaderboard the leaderboard
+ * @param id the player id
+ * @param page the page
+ */
+export async function fetchLeaderboardScores<S, L>(leaderboard: Leaderboards, id: string, page: number) {
+  return kyFetch<PlayerScoresResponse<S, L>>(`${Config.apiUrl}/scores/leaderboard/${leaderboard}/${id}/${page}`);
+}

projects/common/src/utils/scoresaber-utils.ts

@@ -1,9 +1,11 @@
+import { Difficulty } from "../score/difficulty";
+
 /**
  * Formats the ScoreSaber difficulty number
  *
  * @param diff the diffuiclity number
  */
-export function getDifficultyFromScoreSaberDifficulty(diff: number) {
+export function getDifficultyFromScoreSaberDifficulty(diff: number): Difficulty {
   switch (diff) {
     case 1: {
       return "Easy";

projects/common/tsconfig.json

@@ -7,6 +7,8 @@
     "moduleResolution": "node",
     "skipLibCheck": true,
     "allowSyntheticDefaultImports": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
     "strict": true,
     "baseUrl": "./",
     "paths": {