feat: add rank endpoints with solo/flex metrics

- add League-V4 rank lookup by puuid

- expose solo/flex split with derived winRate

- include LP, wins, losses, and win rate in endpoint test output

- document new rank APIs and queue mapping in README

Author: Timmsy1998

README.md

@@ -100,6 +100,8 @@ fetchStaticData();
 
 - `getAccountByRiotId(riotId, [tagLine], [region])`: Fetch account by Riot ID (e.g., `Timmsy#BRUV`).
 - `getSummonerByPuuid(puuid, [region])`: Get summoner data by PUUID.
+- `getRankEntriesByPuuid(puuid, [region])`: Get all League-V4 rank entries for a player PUUID.
+- `getRankByPuuid(puuid, [region])`: Get rank split by Solo and Flex queues from a PUUID.
 - `getMatchlistByPuuid(puuid, [options], [region])`: Get match history (options: `{ start, count }`).
 - `getMatchById(matchId, [region])`: Get full match payload (`metadata` + `info`) by match ID.
 - `getMatchTimelineById(matchId, [region])`: Get timeline payload by match ID.
@@ -118,6 +120,10 @@ fetchStaticData();
 - `getMatchlistByPuuidAll`: `{ delayMs, maxMatches }`
 - `getMatchesWithDetailsByPuuid`: `{ pageDelayMs, detailDelayMs, maxMatches }`
 
+Rank queue mapping used by helper methods:
+- Solo Queue: `RANKED_SOLO_5x5`
+- Flex Queue: `RANKED_FLEX_SR`
+
 ### DataDragon
 
 - `getChampions()`: Fetch all champion data.

endpoints/riot.js

@@ -1,4 +1,14 @@
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const SOLO_QUEUE = 'RANKED_SOLO_5x5';
+const FLEX_QUEUE = 'RANKED_FLEX_SR';
+const withRankMetrics = (entry) => {
+    if (!entry) return null;
+    const wins = Number(entry.wins) || 0;
+    const losses = Number(entry.losses) || 0;
+    const gamesPlayed = wins + losses;
+    const winRate = gamesPlayed > 0 ? Number(((wins / gamesPlayed) * 100).toFixed(2)) : 0;
+    return { ...entry, winRate };
+};
 
 module.exports = (client, defaultRegion, regionMap) => ({
     /**
@@ -46,6 +56,37 @@ module.exports = (client, defaultRegion, regionMap) => ({
         }
     },
 
+    /**
+     * Fetch all ranked entries for a player PUUID.
+     * @param {string} puuid - Player PUUID.
+     * @param {string} [region] - Region code used to resolve platform routing.
+     * @returns {Promise<object[]>} Ranked entries from League-V4.
+     */
+    async getRankEntriesByPuuid(puuid, region = defaultRegion) {
+        const platform = regionMap[region].platform;
+        try {
+            const response = await client.get(`/lol/league/v4/entries/by-puuid/${encodeURIComponent(puuid)}`, {
+                baseURL: `https://${platform}`,
+            });
+            return response.data;
+        } catch (error) {
+            throw this._handleError(error);
+        }
+    },
+
+    /**
+     * Fetch ranked info split into Solo and Flex queues.
+     * @param {string} puuid - Player PUUID.
+     * @param {string} [region] - Region code used to resolve platform routing.
+     * @returns {Promise<{solo: object|null, flex: object|null, entries: object[]}>} Queue-split rank payload.
+     */
+    async getRankByPuuid(puuid, region = defaultRegion) {
+        const entries = await this.getRankEntriesByPuuid(puuid, region);
+        const solo = withRankMetrics(entries.find((entry) => entry.queueType === SOLO_QUEUE) || null);
+        const flex = withRankMetrics(entries.find((entry) => entry.queueType === FLEX_QUEUE) || null);
+        return { solo, flex, entries };
+    },
+
     /**
      * Fetch match IDs for a PUUID from Match-V5.
      * @param {string} puuid - Player PUUID.

test-endpoints.js

@@ -17,6 +17,12 @@ async function run() {
             summonerLevel: summoner.summonerLevel,
         });
 
+        const rank = await riot.getRankByPuuid(account.puuid);
+        console.log('[PASS] getRankByPuuid:', {
+            solo: rank.solo ? `${rank.solo.tier} ${rank.solo.rank} | ${rank.solo.leaguePoints} LP | ${rank.solo.wins}W-${rank.solo.losses}L | ${rank.solo.winRate}% WR` : null,
+            flex: rank.flex ? `${rank.flex.tier} ${rank.flex.rank} | ${rank.flex.leaguePoints} LP | ${rank.flex.wins}W-${rank.flex.losses}L | ${rank.flex.winRate}% WR` : null,
+        });
+
         const matchIds = await riot.getMatchlistByPuuid(account.puuid, { start: 0, count: 3 });
         console.log('[PASS] getMatchlistByPuuid:', matchIds.length, 'match ids');