add map stats from beat saver

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

@@ -4,6 +4,7 @@ import ScoreSaberLeaderboardToken from "../../types/token/scoresaber/score-saber
 import { getDifficultyFromScoreSaberDifficulty } from "../../utils/scoresaber-utils";
 import { parseDate } from "../../utils/time-utils";
 import { LeaderboardStatus } from "../leaderboard-status";
+import { MapCharacteristic } from "../../types/map-characteristic";
 
 export default interface ScoreSaberLeaderboard extends Leaderboard {
   /**
@@ -41,7 +42,7 @@ export function getScoreSaberLeaderboardFromToken(token: ScoreSaberLeaderboardTo
   const difficulty: LeaderboardDifficulty = {
     leaderboardId: token.difficulty.leaderboardId,
     difficulty: getDifficultyFromScoreSaberDifficulty(token.difficulty.difficulty),
-    gameMode: token.difficulty.gameMode.replace("Solo", ""),
+    characteristic: token.difficulty.gameMode.replace("Solo", "") as MapCharacteristic,
     difficultyRaw: token.difficulty.difficultyRaw,
   };
 
@@ -66,7 +67,7 @@ export function getScoreSaberLeaderboardFromToken(token: ScoreSaberLeaderboardTo
             return {
               leaderboardId: difficulty.leaderboardId,
               difficulty: getDifficultyFromScoreSaberDifficulty(difficulty.difficulty),
-              gameMode: difficulty.gameMode.replace("Solo", ""),
+              characteristic: difficulty.gameMode.replace("Solo", "") as MapCharacteristic,
               difficultyRaw: difficulty.difficultyRaw,
             };
           })

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

@@ -1,4 +1,5 @@
-import { Difficulty } from "../score/difficulty";
+import { MapDifficulty } from "../score/map-difficulty";
+import { MapCharacteristic } from "../types/map-characteristic";
 
 export default interface LeaderboardDifficulty {
   /**
@@ -9,12 +10,12 @@ export default interface LeaderboardDifficulty {
   /**
    * The difficulty of the leaderboard.
    */
-  difficulty: Difficulty;
+  difficulty: MapDifficulty;
 
   /**
-   * The game mode of the leaderboard.
+   * The characteristic of the leaderboard.
    */
-  gameMode: string;
+  characteristic: MapCharacteristic;
 
   /**
    * The raw difficulty of the leaderboard.

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

@@ -0,0 +1,27 @@
+import { prop } from "@typegoose/typegoose";
+
+export default class BeatSaverAuthor {
+  /**
+   * The id of the author.
+   */
+  @prop({ required: true })
+  id: number;
+
+  /**
+   * The name of the mapper.
+   */
+  @prop({ required: true })
+  name: string;
+
+  /**
+   * The avatar URL for the mapper.
+   */
+  @prop({ required: true })
+  avatar: string;
+
+  constructor(id: number, name: string, avatar: string) {
+    this.id = id;
+    this.name = name;
+    this.avatar = avatar;
+  }
+}

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

@@ -1,13 +0,0 @@
-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

@@ -1,57 +0,0 @@
-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: false })
-  public bsr!: string;
-
-  /**
-   * The author of the map.
-   */
-  @prop({ required: false, _id: false, type: () => BeatsaverAuthor })
-  public author!: BeatsaverAuthor;
-
-  /**
-   * True if the map is unknown on beatsaver.
-   */
-  @prop({ required: false })
-  public unknownMap?: boolean;
-
-  /**
-   * 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/beatsaver/map-difficulty.ts

@@ -0,0 +1,128 @@
+import { prop } from "@typegoose/typegoose";
+import { MapDifficulty } from "../../score/map-difficulty";
+
+export default class BeatSaverMapDifficulty {
+  /**
+   * The NJS of this difficulty.
+   */
+  @prop({ required: true })
+  njs: number;
+
+  /**
+   * The NJS offset of this difficulty.
+   */
+  @prop({ required: true })
+  offset: number;
+
+  /**
+   * The amount of notes in this difficulty.
+   */
+  @prop({ required: true })
+  notes: number;
+
+  /**
+   * The amount of bombs in this difficulty.
+   */
+  @prop({ required: true })
+  bombs: number;
+
+  /**
+   * The amount of obstacles in this difficulty.
+   */
+  @prop({ required: true })
+  obstacles: number;
+
+  /**
+   * The notes per second in this difficulty.
+   */
+  @prop({ required: true })
+  nps: number;
+
+  /**
+   * The characteristic of this difficulty.
+   */
+  @prop({ required: true, enum: ["Standard", "Lawless"] })
+  characteristic: "Standard" | "Lawless";
+
+  /**
+   * The difficulty level.
+   */
+  @prop({ required: true })
+  difficulty: MapDifficulty;
+
+  /**
+   * The amount of lighting events in this difficulty.
+   */
+  @prop({ required: true })
+  events: number;
+
+  /**
+   * Whether this difficulty uses Chroma.
+   */
+  @prop({ required: true, default: false })
+  chroma: boolean;
+
+  /**
+   * Does this difficulty use Mapping Extensions.
+   */
+  @prop({ required: true, default: false })
+  mappingExtensions: boolean;
+
+  /**
+   * Does this difficulty use Noodle Extensions.
+   */
+  @prop({ required: true, default: false })
+  noodleExtensions: boolean;
+
+  /**
+   * Whether this difficulty uses cinema mode.
+   */
+  @prop({ required: true, default: false })
+  cinema: boolean;
+
+  /**
+   * The maximum score achievable in this difficulty.
+   */
+  @prop({ required: true })
+  maxScore: number;
+
+  /**
+   * The custom label for this difficulty.
+   */
+  @prop()
+  label: string;
+
+  constructor(
+    njs: number,
+    offset: number,
+    notes: number,
+    bombs: number,
+    obstacles: number,
+    nps: number,
+    characteristic: "Standard" | "Lawless",
+    difficulty: MapDifficulty,
+    events: number,
+    chroma: boolean,
+    mappingExtensions: boolean,
+    noodleExtensions: boolean,
+    cinema: boolean,
+    maxScore: number,
+    label: string
+  ) {
+    this.njs = njs;
+    this.offset = offset;
+    this.notes = notes;
+    this.bombs = bombs;
+    this.obstacles = obstacles;
+    this.nps = nps;
+    this.characteristic = characteristic;
+    this.difficulty = difficulty;
+    this.events = events;
+    this.chroma = chroma;
+    this.mappingExtensions = mappingExtensions;
+    this.noodleExtensions = noodleExtensions;
+    this.cinema = cinema;
+    this.maxScore = maxScore;
+    this.label = label;
+  }
+}

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

@@ -0,0 +1,55 @@
+import { prop } from "@typegoose/typegoose";
+
+export default class BeatSaverMapMetadata {
+  /**
+   * The bpm of the song.
+   */
+  @prop({ required: true })
+  bpm: number;
+
+  /**
+   * The song's length in seconds.
+   */
+  @prop({ required: true })
+  duration: number;
+
+  /**
+   * The song's name.
+   */
+  @prop({ required: true })
+  songName: string;
+
+  /**
+   * The song's sub name.
+   */
+  @prop({ required: false })
+  songSubName: string;
+
+  /**
+   * The artist(s) name.
+   */
+  @prop({ required: true })
+  songAuthorName: string;
+
+  /**
+   * The level mapper(s) name.
+   */
+  @prop({ required: true })
+  levelAuthorName: string;
+
+  constructor(
+    bpm: number,
+    duration: number,
+    songName: string,
+    songSubName: string,
+    songAuthorName: string,
+    levelAuthorName: string
+  ) {
+    this.bpm = bpm;
+    this.duration = duration;
+    this.songName = songName;
+    this.songSubName = songSubName;
+    this.songAuthorName = songAuthorName;
+    this.levelAuthorName = levelAuthorName;
+  }
+}

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

@@ -0,0 +1,31 @@
+import { modelOptions, prop, Severity } from "@typegoose/typegoose";
+import BeatSaverMapDifficulty from "./map-difficulty";
+
+@modelOptions({
+  options: { allowMixed: Severity.ALLOW },
+})
+export default class BeatSaverMapVersion {
+  /**
+   * The hash of this map.
+   */
+  @prop({ required: true })
+  hash: string;
+
+  /**
+   * The date the map was created.
+   */
+  @prop({ required: true })
+  createdAt: Date;
+
+  /**
+   * The difficulties of this map.
+   */
+  @prop({ required: true })
+  difficulties: BeatSaverMapDifficulty[];
+
+  constructor(hash: string, createdAt: Date, difficulties: BeatSaverMapDifficulty[]) {
+    this.hash = hash;
+    this.createdAt = createdAt;
+    this.difficulties = difficulties;
+  }
+}

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

@@ -0,0 +1,99 @@
+import { getModelForClass, modelOptions, prop, ReturnModelType, Severity } from "@typegoose/typegoose";
+import { Document } from "mongoose";
+import BeatSaverAuthor from "./author";
+import BeatSaverMapVersion from "./map-version";
+import BeatSaverMapMetadata from "./map-metadata";
+
+/**
+ * The model for a BeatSaver map.
+ */
+@modelOptions({
+  options: { allowMixed: Severity.ALLOW },
+  schemaOptions: {
+    collection: "beatsaver-maps",
+    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 })
+  protected _id!: string;
+
+  /**
+   * The name of the map.
+   */
+  @prop({ required: false })
+  public name!: string;
+
+  /**
+   * The description of the map.
+   */
+  @prop({ required: false })
+  public description!: string;
+
+  /**
+   * The bsr code for the map.
+   */
+  @prop({ required: false })
+  public bsr!: string;
+
+  /**
+   * The author of the map.
+   */
+  @prop({ required: false, _id: false, type: () => BeatSaverAuthor })
+  public author!: BeatSaverAuthor;
+
+  /**
+   * The versions of the map.
+   */
+  @prop({ required: false, _id: false, type: () => [BeatSaverMapVersion] })
+  public versions!: BeatSaverMapVersion[];
+
+  /**
+   * The metadata of the map.
+   */
+  @prop({ required: false, _id: false, type: () => BeatSaverMapMetadata })
+  public metadata!: BeatSaverMapMetadata;
+
+  /**
+   * True if the map is not found on beatsaver.
+   */
+  @prop({ required: false })
+  public notFound?: boolean;
+
+  /**
+   * The last time the map data was refreshed.
+   */
+  @prop({ required: true })
+  public lastRefreshed!: Date;
+
+  /**
+   * Exposes `id` as a virtual field mapped from `_id`.
+   */
+  public get id(): string {
+    return this._id;
+  }
+
+  /**
+   * Should the map data be refreshed?
+   *
+   * @returns true if the map data should be refreshed
+   */
+  public shouldRefresh(): boolean {
+    const now = new Date();
+    return now.getTime() - this.lastRefreshed.getTime() > 1000 * 60 * 60 * 24 * 3; // 3 days
+  }
+}
+
+export type BeatSaverMapDocument = BeatSaverMap & Document;
+export const BeatSaverMapModel: ReturnModelType<typeof BeatSaverMap> = getModelForClass(BeatSaverMap);

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

@@ -1,4 +1,4 @@
-import { BeatSaverMap } from "../model/beatsaver/beatsaver-map";
+import { BeatSaverMap } from "../model/beatsaver/map";
 
 export type LeaderboardResponse<L> = {
   /**

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

@@ -1,5 +1,5 @@
 import { Metadata } from "../types/metadata";
-import { BeatSaverMap } from "../model/beatsaver/beatsaver-map";
+import { BeatSaverMap } from "../model/beatsaver/map";
 
 export default interface LeaderboardScoresResponse<S, L> {
   /**

projects/common/src/score/difficulty.ts

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

projects/common/src/score/map-difficulty.ts

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

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

@@ -1,4 +1,4 @@
-import { BeatSaverMap } from "../model/beatsaver/beatsaver-map";
+import { BeatSaverMap } from "../model/beatsaver/map";
 
 export interface PlayerScore<S, L> {
   /**

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

@@ -1,5 +1,5 @@
 import Service from "../service";
-import { BeatSaverMapToken } from "../../types/token/beatsaver/beat-saver-map-token";
+import { BeatSaverMapToken } from "../../types/token/beatsaver/map";
 
 const API_BASE = "https://api.beatsaver.com";
 const LOOKUP_MAP_BY_HASH_ENDPOINT = `${API_BASE}/maps/hash/:query`;

projects/common/src/types/map-characteristic.ts

@@ -0,0 +1 @@
+export type MapCharacteristic = "Standard" | "Lawless";

projects/common/src/types/page.ts

@@ -1,13 +0,0 @@
-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/token/beatsaver/beat-saver-map-token.ts

@@ -1,24 +0,0 @@
-import BeatSaverAccountToken from "./beat-saver-account-token";
-import BeatSaverMapMetadataToken from "./beat-saver-map-metadata-token";
-import BeatSaverMapStatsToken from "./beat-saver-map-stats-token";
-
-export interface BeatSaverMapToken {
-  id: string;
-  name: string;
-  description: string;
-  uploader: BeatSaverAccountToken;
-  metadata: BeatSaverMapMetadataToken;
-  stats: BeatSaverMapStatsToken;
-  uploaded: string;
-  automapper: boolean;
-  ranked: boolean;
-  qualified: boolean;
-  // todo: versions
-  createdAt: string;
-  updatedAt: string;
-  lastPublishedAt: string;
-  tags: string[];
-  declaredAi: string;
-  blRanked: boolean;
-  blQualified: boolean;
-}

projects/common/src/types/token/beatsaver/difficulty-parity-summary.ts

@@ -0,0 +1,16 @@
+export type MapDifficultyParitySummaryToken = {
+  /**
+   * The amount of parity errors.
+   */
+  errors: number;
+
+  /**
+   * The amount of parity warnings.
+   */
+  warns: number;
+
+  /**
+   * The amount of resets in the difficulty.
+   */
+  resets: number;
+};

projects/common/src/types/token/beatsaver/map-difficulty.ts

@@ -0,0 +1,90 @@
+import { MapDifficulty } from "../../../score/map-difficulty";
+import { MapDifficultyParitySummaryToken } from "./difficulty-parity-summary";
+
+export type BeatSaverMapDifficultyToken = {
+  /**
+   * The NJS of this difficulty.
+   */
+  njs: number;
+
+  /**
+   * The NJS offset of this difficulty.
+   */
+  offset: number;
+
+  /**
+   * The amount of notes in this difficulty.
+   */
+  notes: number;
+
+  /**
+   * The amount of bombs in this difficulty.
+   */
+  bombs: number;
+
+  /**
+   * The amount of obstacles in this difficulty.
+   */
+  obstacles: number;
+
+  /**
+   * The notes per second in this difficulty.
+   */
+  nps: number;
+
+  /**
+   * The length of this difficulty in seconds.
+   */
+  length: number;
+
+  /**
+   * The characteristic of this difficulty.
+   */
+  characteristic: "Standard" | "Lawless";
+
+  /**
+   * The difficulty of this difficulty.
+   */
+  difficulty: MapDifficulty;
+
+  /**
+   * The amount of lighting events in this difficulty.
+   */
+  events: number;
+
+  /**
+   * Whether this difficulty uses Chroma.
+   */
+  chroma: boolean;
+
+  /**
+   * Quite frankly I have no fucking idea what these are.
+   */
+  me: boolean;
+  ne: boolean;
+
+  /**
+   * Does this difficulty use cinema?
+   */
+  cinema: boolean;
+
+  /**
+   * The length of this difficulty in seconds.
+   */
+  seconds: number;
+
+  /**
+   * The parity summary of this difficulty.
+   */
+  paritySummary: MapDifficultyParitySummaryToken;
+
+  /**
+   * The maximum score of this difficulty.
+   */
+  maxScore: number;
+
+  /**
+   * The custom difficulty label.
+   */
+  label: string;
+};

projects/common/src/types/token/beatsaver/map-version.ts

@@ -0,0 +1,43 @@
+import { BeatSaverMapDifficultyToken } from "./map-difficulty";
+
+export type BeatSaverMapVersionToken = {
+  /**
+   * The hash of the map.
+   */
+  hash: string;
+
+  /**
+   * The stage of the map.
+   */
+  stage: "Published"; // todo: find the rest of these
+
+  /**
+   * The date the map was created.
+   */
+  createdAt: string;
+
+  /**
+   * The sage score of the map. (no idea what this is x.x)
+   */
+  sageScore: number;
+
+  /**
+   * The difficulties in the map.
+   */
+  diffs: BeatSaverMapDifficultyToken[];
+
+  /**
+   * The URL to the download of the map.
+   */
+  downloadURL: string;
+
+  /**
+   * The URL to the cover image.
+   */
+  coverURL: string;
+
+  /**
+   * The URL to the preview of the map.
+   */
+  previewURL: string;
+};

projects/common/src/types/token/beatsaver/map.ts

@@ -0,0 +1,96 @@
+import BeatSaverAccountToken from "./account";
+import BeatSaverMapMetadataToken from "./map-metadata";
+import BeatSaverMapStatsToken from "./map-stats";
+import { BeatSaverMapVersionToken } from "./map-version";
+
+export interface BeatSaverMapToken {
+  /**
+   * The id of the map.
+   */
+  id: string;
+
+  /**
+   * The name of the map.
+   */
+  name: string;
+
+  /**
+   * The description of the map.
+   */
+  description: string;
+
+  /**
+   * The uploader of the map.
+   */
+  uploader: BeatSaverAccountToken;
+
+  /**
+   * The metadata of the map.
+   */
+  metadata: BeatSaverMapMetadataToken;
+
+  /**
+   * The stats of the map.
+   */
+  stats: BeatSaverMapStatsToken;
+
+  /**
+   * The date the map was uploaded.
+   */
+  uploaded: string;
+
+  /**
+   * Whether the map was mapped by an automapper.
+   */
+  automapper: boolean;
+
+  /**
+   * Whether the map is ranked on ScoreSaber.
+   */
+  ranked: boolean;
+
+  /**
+   * Whether the map is qualified on ScoreSaber.
+   */
+  qualified: boolean;
+
+  /**
+   * The versions of the map.
+   */
+  versions: BeatSaverMapVersionToken[];
+
+  /**
+   * The date the map was created.
+   */
+  createdAt: string;
+
+  /**
+   * The date the map was last updated.
+   */
+  updatedAt: string;
+
+  /**
+   * The date the map was last published.
+   */
+  lastPublishedAt: string;
+
+  /**
+   * The tags of the map.
+   */
+  tags: string[];
+
+  /**
+   * Whether the map is declared to be mapped by an AI.
+   */
+  declaredAi: string;
+
+  /**
+   * Whether the map is ranked on BeatLeader.
+   */
+  blRanked: boolean;
+
+  /**
+   * Whether the map is qualified on BeatLeader.
+   */
+  blQualified: boolean;
+}

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

@@ -1,7 +1,8 @@
-import { BeatSaverMap } from "../model/beatsaver/beatsaver-map";
+import { BeatSaverMap } from "../model/beatsaver/map";
+import { MapDifficulty } from "../score/map-difficulty";
 
 /**
- * Gets the beatSaver mapper profile url.
+ * Gets the BeatSaver mapper profile url.
  *
  * @param map the beatsaver map
  * @returns the beatsaver mapper profile url
@@ -9,3 +10,18 @@ import { BeatSaverMap } from "../model/beatsaver/beatsaver-map";
 export function getBeatSaverMapperProfileUrl(map?: BeatSaverMap) {
   return map != undefined ? `https://beatsaver.com/profile/${map?.author.id}` : undefined;
 }
+
+/**
+ * Gets a BeatSaver difficulty from a map.
+ *
+ * @param map the map to get the difficulty from
+ * @param hash the hash of the map
+ * @param difficulty the difficulty to get
+ */
+export function getBeatSaverDifficulty(map: BeatSaverMap, hash: string, difficulty: MapDifficulty) {
+  const version = map.versions.find(v => v.hash === hash);
+  if (version == undefined) {
+    return undefined;
+  }
+  return version.difficulties.find(d => d.difficulty === difficulty);
+}

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

@@ -60,7 +60,7 @@ export function sortPlayerHistory(history: Map<string, PlayerHistory>) {
  * @param id the player id
  */
 export async function trackPlayer(id: string) {
-  await kyFetch(`${Config.apiUrl}/player/history/1/${id}?createIfMissing=true`);
+  await kyFetch(`${Config.apiUrl}/player/history/${id}/1?createIfMissing=true`);
 }
 
 /**

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

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

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

@@ -134,3 +134,20 @@ export function getDaysAgo(date: Date): number {
 export function parseDate(date: string): Date {
   return new Date(date);
 }
+
+/**
+ * Formats the time in the format "MM:SS"
+ *
+ * @param seconds the time to format in seconds
+ * @returns the formatted time in "MM:SS" format
+ */
+export function formatTime(seconds: number): string {
+  const minutes = Math.floor(seconds / 60);
+  const remainingSeconds = seconds % 60;
+
+  // Zero pad minutes and seconds to ensure two digits
+  const formattedMinutes = minutes < 10 ? `0${minutes}` : `${minutes}`;
+  const formattedSeconds = remainingSeconds < 10 ? `0${remainingSeconds}` : `${remainingSeconds}`;
+
+  return `${formattedMinutes}:${formattedSeconds}`;
+}