uva-wrapper 4.9.0

package/src/stored-mmr-history/v1/getStoredMMRHistoryByName.ts

@@ -0,0 +1,48 @@
+import { doApiRequest } from "../../lib/request-handler";
+import {
+  DefaultApiResponse,
+  DefaultErrorsResponse,
+} from "../../types/response.type";
+
+export async function v1_getStoredMMRHistoryByName(
+  apiKey: string,
+  affinity: string,
+  name: string,
+  tag: string,
+  size?: number,
+) {
+  return (await doApiRequest(
+    apiKey,
+    `/valorant/v1/stored-mmr-history/${affinity}/${name}/${tag}`,
+    { size: size?.toString() },
+    { method: "GET" },
+  )) as
+    | (DefaultApiResponse<v1_getStoredMMRHistoryByName[]> & {
+        results: {
+          after: number;
+          before: number;
+          returned: number;
+          total: number;
+        };
+      })
+    | DefaultErrorsResponse;
+}
+export interface v1_getStoredMMRHistoryByName {
+  date: string;
+  elo: number;
+  last_mmr_change: number;
+  map: {
+    id: string;
+    name: string;
+  };
+  match_id: string;
+  ranking_in_tier: number;
+  season: {
+    id: string;
+    short: string;
+  };
+  tier: {
+    id: number;
+    name: string;
+  };
+}

package/src/stored-mmr-history/v1/getStoredMMRHistoryByPuuid.ts

@@ -0,0 +1,47 @@
+import { doApiRequest } from "../../lib/request-handler";
+import {
+  DefaultApiResponse,
+  DefaultErrorsResponse,
+} from "../../types/response.type";
+
+export async function v1_getStoredMMRHistoryByPuuid(
+  apiKey: string,
+  affinity: string,
+  puuid: string,
+  size?: number,
+) {
+  return (await doApiRequest(
+    apiKey,
+    `/valorant/v1/by-puuid/stored-mmr-history/${affinity}/${puuid}`,
+    { size: size?.toString() },
+    { method: "GET" },
+  )) as
+    | (DefaultApiResponse<v1_getStoredMMRHistoryByPuuid[]> & {
+        results: {
+          after: number;
+          before: number;
+          returned: number;
+          total: number;
+        };
+      })
+    | DefaultErrorsResponse;
+}
+export interface v1_getStoredMMRHistoryByPuuid {
+  date: string;
+  elo: number;
+  last_mmr_change: number;
+  map: {
+    id: string;
+    name: string;
+  };
+  match_id: string;
+  ranking_in_tier: number;
+  season: {
+    id: string;
+    short: string;
+  };
+  tier: {
+    id: number;
+    name: string;
+  };
+}

package/src/stored-mmr-history/v1/index.ts

@@ -0,0 +1,40 @@
+import { v1_getStoredMMRHistoryByName } from "./getStoredMMRHistoryByName";
+import { v1_getStoredMMRHistoryByPuuid } from "./getStoredMMRHistoryByPuuid";
+
+export class v1_StoredMMRHistoryCategory {
+  constructor(private readonly apiKey: string) {}
+
+  /**
+   * @link https://docs.henrikdev.xyz/api-reference/valorant/get-stored-mmr-history-by-name-v1
+   * @param affinity Region/affinity (e.g., na, eu, ap, kr)
+   * @param name Riot ID name
+   * @param tag Riot ID tag
+   * @param size Number of results (optional)
+   * @returns Stored MMR history retrieved successfully
+   */
+  async getByName(affinity: string, name: string, tag: string, size?: number) {
+    return await v1_getStoredMMRHistoryByName(
+      this.apiKey,
+      affinity,
+      name,
+      tag,
+      size,
+    );
+  }
+
+  /**
+   * @link https://docs.henrikdev.xyz/api-reference/valorant/get-stored-mmr-history-by-puuid-v1
+   * @param affinity Region/affinity (e.g., na, eu, ap, kr)
+   * @param puuid Player UUID
+   * @param size Number of results (optional)
+   * @returns Stored MMR history retrieved successfully
+   */
+  async getByPuuid(affinity: string, puuid: string, size?: number) {
+    return await v1_getStoredMMRHistoryByPuuid(
+      this.apiKey,
+      affinity,
+      puuid,
+      size,
+    );
+  }
+}

package/src/stored-mmr-history/v2/getStoredMMRHistoryByName.ts

@@ -0,0 +1,51 @@
+import { doApiRequest } from "../../lib/request-handler";
+import {
+  DefaultApiResponse,
+  DefaultErrorsResponse,
+} from "../../types/response.type";
+
+export async function v2_getStoredMMRHistoryByName(
+  apiKey: string,
+  affinity: string,
+  platform: string,
+  name: string,
+  tag: string,
+  size?: number,
+) {
+  return (await doApiRequest(
+    apiKey,
+    `/v2/stored-mmr-history/${affinity}/${platform}/${name}/${tag}`,
+    { size: size?.toString() },
+    { method: "GET" },
+  )) as
+    | (DefaultApiResponse<v2_getStoredMMRHistoryByName[]> & {
+        results: {
+          after: number;
+          before: number;
+          returned: number;
+          total: number;
+        };
+      })
+    | DefaultErrorsResponse;
+}
+export interface v2_getStoredMMRHistoryByName {
+  date: string;
+  elo: number;
+  last_change: number;
+  map: {
+    id: string;
+    name: string;
+  };
+  match_id: string;
+  refunded_rr: number;
+  rr: number;
+  season: {
+    id: string;
+    short: string;
+  };
+  tier: {
+    id: number;
+    name: string;
+  };
+  was_derank_protected: boolean;
+}

package/src/stored-mmr-history/v2/getStoredMMRHistoryByPuuid.ts

@@ -0,0 +1,50 @@
+import { doApiRequest } from "../../lib/request-handler";
+import {
+  DefaultApiResponse,
+  DefaultErrorsResponse,
+} from "../../types/response.type";
+
+export async function v2_getStoredMMRHistoryByPuuid(
+  apiKey: string,
+  affinity: string,
+  platform: string,
+  puuid: string,
+  size?: number,
+) {
+  return (await doApiRequest(
+    apiKey,
+    `/valorant/v2/by-puuid/stored-mmr-history/${affinity}/${platform}/${puuid}`,
+    { size: size?.toString() },
+    { method: "GET" },
+  )) as
+    | (DefaultApiResponse<v2_getStoredMMRHistoryByPuuid[]> & {
+        results: {
+          after: number;
+          before: number;
+          returned: number;
+          total: number;
+        };
+      })
+    | DefaultErrorsResponse;
+}
+export interface v2_getStoredMMRHistoryByPuuid {
+  date: string;
+  elo: number;
+  last_change: number;
+  map: {
+    id: string;
+    name: string;
+  };
+  match_id: string;
+  refunded_rr: number;
+  rr: number;
+  season: {
+    id: string;
+    short: string;
+  };
+  tier: {
+    id: number;
+    name: string;
+  };
+  was_derank_protected: boolean;
+}

package/src/stored-mmr-history/v2/index.ts

@@ -0,0 +1,55 @@
+import { v2_getStoredMMRHistoryByName } from "./getStoredMMRHistoryByName";
+import { v2_getStoredMMRHistoryByPuuid } from "./getStoredMMRHistoryByPuuid";
+
+export class v2_StoredMMRHistoryCategory {
+  constructor(private readonly apiKey: string) {}
+
+  /**
+   * @link https://docs.henrikdev.xyz/api-reference/valorant/get-stored-mmr-history-by-name-v2
+   * @param affinity Region/affinity (e.g., na, eu, ap, kr)
+   * @param platform Platform (pc, console)
+   * @param name Riot ID name
+   * @param tag Riot ID name
+   * @param size Number of results (optional)
+   * @returns Stored MMR history retrieved successfully
+   */
+  async getByName(
+    affinity: string,
+    platform: string,
+    name: string,
+    tag: string,
+    size?: number,
+  ) {
+    return await v2_getStoredMMRHistoryByName(
+      this.apiKey,
+      affinity,
+      platform,
+      name,
+      tag,
+      size,
+    );
+  }
+
+  /**
+   * @link https://docs.henrikdev.xyz/api-reference/valorant/get-stored-mmr-history-by-puuid-v2
+   * @param affinity Region/affinity (e.g., na, eu, ap, kr)
+   * @param platform Platform (pc, console)
+   * @param puuid Player UUID
+   * @param size Number of results (optional)
+   * @returns Stored MMR history retrieved successfully
+   */
+  async getByPuuid(
+    affinity: string,
+    platform: string,
+    puuid: string,
+    size?: number,
+  ) {
+    return await v2_getStoredMMRHistoryByPuuid(
+      this.apiKey,
+      affinity,
+      platform,
+      puuid,
+      size,
+    );
+  }
+}

package/src/types/response.type.ts

@@ -0,0 +1,10 @@
+export type DefaultApiResponse<T> = {
+  data: T;
+  /**
+   * Required range: x >= 0
+   */
+  status: number;
+};
+export type DefaultErrorsResponse = {
+  errors: { code: number; message: string; status: number; details: unknown }[];
+};

package/src/vlr/index.ts

@@ -0,0 +1,9 @@
+import { v2_VlrCategory } from "./v2";
+
+export class VlrCategory {
+  constructor(private readonly apiKey: string) {
+    this.v2 = new v2_VlrCategory(this.apiKey);
+  }
+
+  v2: v2_VlrCategory;
+}

package/src/vlr/v2/getVlrEsportsEvents.ts

@@ -0,0 +1,40 @@
+import { doApiRequest } from "../../lib/request-handler";
+
+export async function v2_getVlrEsportsEvents(
+  apiKey: string,
+  region?:
+    | "north_america"
+    | "europe"
+    | "brazil"
+    | "asia_pacific"
+    | "korea"
+    | "japan"
+    | "latin_america"
+    | "oceania"
+    | "mena"
+    | "gc"
+    | "collegiate",
+  type?: "completed" | "upcoming",
+  page?: number,
+) {
+  return await doApiRequest<v2_getVlrEsportsEvents_ResponseData[]>(
+    apiKey,
+    "/valorant/v2/esports/vlr/events",
+    { region, type, page: page?.toString() },
+    { method: "GET" },
+  );
+}
+
+export interface v2_getVlrEsportsEvents_ResponseData {
+  dates: {
+    end: string;
+    start: string;
+  };
+  icon: string;
+  id: number;
+  price: string;
+  region: string;
+  slug: string;
+  status: "completed" | "ongoing" | "upcoming" | "unknown";
+  title: string;
+}

package/src/vlr/v2/getVlrEventMatches.ts

@@ -0,0 +1,23 @@
+import { doApiRequest } from "../../lib/request-handler";
+
+export async function v2_getVlrEventMatches(apiKey: string, eventId: number) {
+  return await doApiRequest<v2_getVlrEventMatches_ResponseData[]>(
+    apiKey,
+    `/valorant/v2/esports/vlr/events/${eventId}/matches`,
+    {},
+    { method: "GET" },
+  );
+}
+export interface v2_getVlrEventMatches_ResponseData {
+  event: string;
+  id: number;
+  series: string;
+  slug: string;
+  tags: string[];
+  teams: {
+    is_winner: boolean;
+    name: string;
+    score: number | null;
+  }[];
+  date: string;
+}

package/src/vlr/v2/getVlrMatchDetails.ts

@@ -0,0 +1,167 @@
+import { doApiRequest } from "../../lib/request-handler";
+
+export async function v2_getVlrMatchDetails(apiKey: string, matchId: number) {
+  return await doApiRequest<v2_getVlrMatchDetails_ResponseData>(
+    apiKey,
+    `/valorant/v2/esports/vlr/matches/${matchId}`,
+    {},
+    { method: "GET" },
+  );
+}
+
+export interface v2_getVlrMatchDetails_ResponseData {
+  games: {
+    map: string;
+    rounds: {
+      round: number;
+      winning_site: string;
+      winning_team: number;
+    }[];
+    teams: {
+      is_winner: boolean;
+      name: string;
+      players: {
+        agent: string;
+        player: {
+          id: number;
+          name: string;
+          nation: string;
+          slug: string;
+        };
+        stats: {
+          acs: number | null;
+          adr: number | null;
+          assists: number | null;
+          deaths: number | null;
+          first_deaths: number | null;
+          first_kills: number | null;
+          fk_diff: number | null;
+          hs_pct: number | null;
+          kast: number | null;
+          kd_diff: number | null;
+          kills: number | null;
+          rating: number | null;
+        };
+      }[];
+      score: number | null;
+      score_ct: number | null;
+      score_t: number | null;
+    }[];
+    duration_in_s: number | null;
+    picked_by: number | null;
+  }[];
+  head_to_head: {
+    date: string;
+    event: {
+      icon: string;
+      name: string;
+      series: string;
+    };
+    match: {
+      id: number;
+      slug: string;
+    };
+    score: {
+      team_1: number;
+      team_2: number;
+      winner_team: number;
+    };
+  }[];
+  metadata: {
+    date: string;
+    event: {
+      icon: string;
+      id: number;
+      series: string;
+      slug: string;
+      title: string;
+    };
+    format: string;
+    note: string;
+    patch: string;
+    status: string;
+  };
+  past_matches: {
+    matches: {
+      date: string;
+      is_win: boolean;
+      match: {
+        id: number;
+        slug: string;
+      };
+      opponent: {
+        logo: string;
+        name: string;
+      };
+      score: {
+        against: number;
+        for: number;
+      };
+    }[];
+    team: number;
+  }[];
+  streams: {
+    link: string;
+    name: string;
+  }[];
+  teams: {
+    icon: string;
+    id: number;
+    name: string;
+    slug: string;
+    url: string;
+    score: number | null;
+  }[];
+  vods: {
+    link: string;
+    name: string;
+  }[];
+  economy: {
+    teams: {
+      eco: {
+        rounds: number;
+        won: number;
+      };
+      full_buy: {
+        rounds: number;
+        won: number;
+      };
+      pistol_won: number;
+      semi_eco: {
+        rounds: number;
+        won: number;
+      };
+      team_name: string;
+    }[];
+  } | null;
+  performance: {
+    kill_matrix: {
+      deaths: number;
+      killer: number;
+      kills: number;
+      victim: number;
+    }[];
+    player_performances: {
+      clutches: {
+        "1v1": number;
+        "1v2": number;
+        "1v3": number;
+        "1v4": number;
+        "1v5": number;
+      };
+      defuses: number;
+      econ_rating: number;
+      multi_kills: {
+        "2k": number;
+        "3k": number;
+        "4k": number;
+        "5k": number;
+      };
+      plants: number;
+      player: {
+        id: number;
+        name: string;
+      };
+    }[];
+  } | null;
+}

package/src/vlr/v2/getVlrPlayer.ts

@@ -0,0 +1,78 @@
+import { doApiRequest } from "../../lib/request-handler";
+
+export async function v2_getVlrPlayer(
+  apiKey: string,
+  player: number,
+  timespan?: "30d" | "60d" | "90d" | "all",
+) {
+  return await doApiRequest(
+    apiKey,
+    `/valorant/v2/esports/vlr/players/${player}`,
+    { timespan },
+    { method: "GET" },
+  );
+}
+
+export interface v2_getVlrPlayer_ResponseData {
+  agent_stats: {
+    agent: string;
+    stats: {
+      acs: number;
+      adr: number;
+      apr: number;
+      assists: number;
+      deaths: number;
+      fdpr: number;
+      first_deaths: number;
+      first_kills: number;
+      fkpr: number;
+      kast: number;
+      kd: number;
+      kills: number;
+      kpr: number;
+      rating: number;
+    };
+    usage: {
+      count: number;
+      percentage: number;
+      rounds: number;
+    };
+  }[];
+  current_teams: {
+    id: number;
+    logo: string;
+    name: string;
+  }[];
+  event_placements: {
+    event: {
+      id: number;
+      name: string;
+      slug: string;
+    };
+    placements: {
+      placement: string;
+      stage: string;
+      prize: string;
+      team: string;
+    }[];
+    year: string;
+  }[];
+  id: number;
+  name: string;
+  past_teams: {
+    id: number;
+    logo: string;
+    name: string;
+  }[];
+  socials: {
+    platform: string;
+    url: string;
+  }[];
+  avatar: string;
+  country: {
+    code: string;
+    name: string;
+  };
+  real_name: string;
+  total_winnings: string;
+}

package/src/vlr/v2/getVlrPlayerMatches.ts

@@ -0,0 +1,36 @@
+import { doApiRequest } from "../../lib/request-handler";
+
+export async function v2_getVlrPlayerMatches(
+  apiKey: string,
+  player: number,
+  page?: number,
+) {
+  return await doApiRequest<v2_getVlrPlayerMatches_ResponseData[]>(
+    apiKey,
+    `/valorant/v2/esports/vlr/players/${player}/matches`,
+    {
+      page: page?.toString(),
+    },
+  );
+}
+export interface v2_getVlrPlayerMatches_ResponseData {
+  league: {
+    icon: string;
+    name: string;
+    series: string;
+  };
+  match: {
+    id: number;
+    slug: string;
+  };
+  teams: [
+    {
+      icon: string;
+      name: string;
+      tag: string;
+      score: number | null;
+    },
+  ];
+  vods: string[];
+  date: string | null;
+}

package/src/vlr/v2/getVlrTeam.ts

@@ -0,0 +1,49 @@
+import { doApiRequest } from "../../lib/request-handler";
+
+export async function v2_getVlrTeam(apiKey: string, teamId: number) {
+  return await doApiRequest<v2_getVlrTeam_ResponseData>(
+    apiKey,
+    `/valorant/v2/esports/vlr/teams/${teamId}`,
+    {},
+    { method: "GET" },
+  );
+}
+
+export interface v2_getVlrTeam_ResponseData {
+  event_placements: {
+    event: {
+      id: number;
+      name: string;
+      slug: string;
+    };
+    placements: {
+      placement: string;
+      stage: string;
+      prize: string | null;
+      team: string | null;
+    }[];
+    year: string;
+  }[];
+  id: number;
+  name: string;
+  roster: {
+    alias: string;
+    id: number;
+    is_captain: boolean;
+    role: string;
+    avatar: string | null;
+    country_code: string | null;
+    real_name: string | null;
+  }[];
+  socials: {
+    platform: string;
+    url: string;
+  }[];
+  country: {
+    code: string;
+    name: string;
+  } | null;
+  logo: string | null;
+  tag: string | null;
+  total_winnings: string | null;
+}