Create src/multiplayer/raceStandings.js

src/multiplayer/raceStandings.js

@@ -0,0 +1,70 @@
+export function isRaceParticipant(player) {
+  return Boolean(player) && !player.disconnected && player.raceStatus !== 'lobby';
+}
+
+function getExplicitRacePosition(player) {
+  return Number.isFinite(player?.racePosition) ? player.racePosition : null;
+}
+
+function getComparableFinishTime(player) {
+  const value = player?.authoritativeFinishTime ?? player?.finishTime;
+  return Number.isFinite(value) ? value : Number.POSITIVE_INFINITY;
+}
+
+export function comparePlayersByRaceStandings(a, b) {
+  const explicitPositionA = getExplicitRacePosition(a);
+  const explicitPositionB = getExplicitRacePosition(b);
+  if (explicitPositionA != null && explicitPositionB != null && explicitPositionA !== explicitPositionB) {
+    return explicitPositionA - explicitPositionB;
+  }
+
+  const finishedA = Boolean(a?.finished);
+  const finishedB = Boolean(b?.finished);
+  const finishTimeA = getComparableFinishTime(a);
+  const finishTimeB = getComparableFinishTime(b);
+
+  if (finishedA && finishedB && finishTimeA !== finishTimeB) return finishTimeA - finishTimeB;
+  if (finishedA !== finishedB) return finishedA ? -1 : 1;
+
+  const progressDelta = (b?.progressDistance ?? 0) - (a?.progressDistance ?? 0);
+  if (progressDelta !== 0) return progressDelta;
+
+  const lapDelta = (b?.currentLap ?? 1) - (a?.currentLap ?? 1);
+  if (lapDelta !== 0) return lapDelta;
+
+  const checkpointDelta = (b?.highestCheckpointReached ?? 0) - (a?.highestCheckpointReached ?? 0);
+  if (checkpointDelta !== 0) return checkpointDelta;
+
+  const currentCheckpointDelta = (b?.currentCheckpoint ?? 0) - (a?.currentCheckpoint ?? 0);
+  if (currentCheckpointDelta !== 0) return currentCheckpointDelta;
+
+  const joinedAtDelta = (a?.joinedAt ?? 0) - (b?.joinedAt ?? 0);
+  if (joinedAtDelta !== 0) return joinedAtDelta;
+
+  return String(a?.username ?? a?.name ?? a?.id ?? '')
+    .localeCompare(String(b?.username ?? b?.name ?? b?.id ?? ''));
+}
+
+export function getRaceStandings(players = []) {
+  return [...players]
+    .filter(isRaceParticipant)
+    .sort(comparePlayersByRaceStandings)
+    .map((player, index) => ({
+      ...player,
+      racePosition: getExplicitRacePosition(player) ?? index + 1,
+    }));
+}
+
+export function getRaceStandingsMap(players = []) {
+  const standings = new Map();
+  getRaceStandings(players).forEach((player) => {
+    if (player?.id) standings.set(player.id, player.racePosition);
+  });
+  return standings;
+}
+
+export function getRacePositionForPlayer(players = [], playerId) {
+  if (!playerId) return null;
+  const player = getRaceStandings(players).find((entry) => entry.id === playerId);
+  return Number.isFinite(player?.racePosition) ? player.racePosition : null;
+}