// 1. Get account by Riot ID (regional endpoint)
const account = await fetch(`https://asia.api.riotgames.com/riot/account/v1/accounts/by-riot-id/Hide%20on%20bush/KR1?api_key=${key}`);
const { puuid } = await account.json();

// 2. Get summoner data (platform endpoint)
const summoner = await fetch(`https://kr.api.riotgames.com/lol/summoner/v4/summoners/by-puuid/${puuid}?api_key=${key}`);
const { id: summonerId } = await summoner.json();

// 3. Get ranked stats (platform endpoint, different ID)
const leagues = await fetch(`https://kr.api.riotgames.com/lol/league/v4/entries/by-puuid/${puuid}?api_key=${key}`);
const ranked = await leagues.json();
const soloQ = ranked.find(q => q.queueType === 'RANKED_SOLO_5x5');

// 4. Calculate win rate manually
const winRate = soloQ.wins / (soloQ.wins + soloQ.losses);

const player = await client.players.getByRiotId('Hide on bush', 'KR1');
const soloQ = await player.getSoloQueueStats();
console.log(`${soloQ.tier} ${soloQ.division} - ${(soloQ.winRate * 100).toFixed(1)}% WR`);

import { LolClient } from 'league-sdk';

const client = new LolClient({
  apiKey: process.env.RIOT_API_KEY!,
  platform: 'kr'
});

// Get player and their ranked stats
const player = await client.players.getByRiotId('Hide on bush', 'KR1');
const soloQ = await player.getSoloQueueStats();

// Get recent matches
const matches = await client.matches.getForPlayer(player.puuid, { count: 5 });
for (const match of matches) {
  const p = match.getParticipant(player.puuid)!;
  console.log(`${p.championName}: ${p.kills}/${p.deaths}/${p.assists}`);
}

const player = await client.players.getByRiotId('Hide on bush', 'KR1');

player.puuid          // Unique ID
player.riotId         // "Hide on bush#KR1"
player.level          // Summoner level

await player.getRankedStats();     // All ranked queues
await player.getSoloQueueStats();  // Solo/Duo only
await player.getFlexQueueStats();  // Flex only
await player.getMatchIds({ count: 10, queue: 420 });

const match = await client.matches.getById('EUW1_1234567890');

match.gameMode            // "CLASSIC"
match.gameDurationFormatted // "32:15"
match.blueTeam / match.redTeam
match.winner              // Winning team

const p = match.getParticipant(puuid)!;
p.kills / p.deaths / p.assists
p.kda                     // Calculated KDA
p.totalCs / p.csPerMinute
p.damage.toChampions

import { PLATFORMS, QUEUES, isRankedQueue, formatRank, compareRanks } from 'league-sdk';

PLATFORMS.EUW1           // 'euw1'
isRankedQueue(420)       // true (Solo/Duo)
formatRank('DIAMOND', 'II')  // "Diamond II"
compareRanks('DIAMOND', 'II', 'PLATINUM', 'I')  // 1 (Diamond > Plat)

import { NotFoundError, RateLimitError, AuthenticationError } from 'league-sdk';

try {
  const player = await client.players.getByRiotId('Unknown', 'Player');
} catch (error) {
  if (error instanceof NotFoundError) {
    console.log('Player not found');
  } else if (error instanceof RateLimitError) {
    console.log(`Retry after ${error.retryAfter}s`);
  } else if (error instanceof AuthenticationError) {
    console.log('Invalid API key');
  }
}

import { downloadChampionIcons, downloadAllAssets } from 'league-sdk/scripts';

await downloadChampionIcons({ outputDir: './assets' });
await downloadAllAssets({ outputDir: './assets', champions: true, items: true });

const client = new LolClient({
  apiKey: 'your-key',
  rateLimiter: {
    requestsPerSecond: 20,    // Default
    requestsPerWindow: 100,   // Default (2-min window)
    enabled: true
  }
});

// Check status
const status = client.getRateLimitStatus();