@wardbox/whisper 0.2.0

package/dist/riot/index.d.cts

@@ -0,0 +1,101 @@
+import { p as RegionalRoute, t as WhisperClient } from "../client-DrrSDGBt.cjs";
+
+//#region src/types/generated/riot.d.ts
+/** Riot account information linked to a Riot ID. */
+interface Account {
+  /** In-game name component of the Riot ID. */
+  gameName: string;
+  /** Player Universally Unique Identifier (PUUID). */
+  puuid: string;
+  /** Tag component of the Riot ID (e.g., "NA1"). */
+  tagLine: string;
+}
+//#endregion
+//#region src/types/overrides/riot-account.d.ts
+/**
+ * Active shard information for a player in a specific game.
+ *
+ * Returned by account-v1.getByGame to determine which platform shard
+ * a player's game data is hosted on.
+ */
+interface ActiveShard {
+  /** Encrypted PUUID of the player */
+  puuid: string;
+  /** Game identifier (e.g., "val", "lor") */
+  game: string;
+  /** Active shard/platform for this player and game (e.g., "na", "eu") */
+  activeShard: string;
+}
+//#endregion
+//#region src/riot/account-v1.d.ts
+/**
+ * Riot Account API (v1).
+ *
+ * Shared across all Riot games. Look up accounts by PUUID or Riot ID,
+ * or query which shard a player is active on for a given game.
+ *
+ * All methods require a {@link RegionalRoute} (americas, europe, asia, sea).
+ *
+ * @example
+ * ```typescript
+ * import { accountV1 } from '@wardbox/whisper/riot';
+ *
+ * const account = await accountV1.getByRiotId(client, 'americas', 'PlayerName', 'NA1');
+ * console.log(account.puuid);
+ * ```
+ */
+declare const accountV1: {
+  /**
+   * Get an account by PUUID.
+   *
+   * @param client - WhisperClient instance
+   * @param route - Regional routing value (e.g., 'americas', 'europe')
+   * @param puuid - Encrypted PUUID
+   * @returns Account data including gameName, tagLine, and puuid
+   *
+   * @example
+   * ```typescript
+   * const account = await accountV1.getByPuuid(client, 'americas', 'abc-123-def');
+   * console.log(account.gameName, account.tagLine);
+   * ```
+   */
+  readonly getByPuuid: (client: WhisperClient, route: RegionalRoute, puuid: string) => Promise<Account>;
+  /**
+   * Get an account by Riot ID (gameName + tagLine).
+   *
+   * @param client - WhisperClient instance
+   * @param route - Regional routing value (e.g., 'americas', 'europe')
+   * @param gameName - Riot ID game name
+   * @param tagLine - Riot ID tag line (e.g., "NA1")
+   * @returns Account data including gameName, tagLine, and puuid
+   *
+   * @example
+   * ```typescript
+   * const account = await accountV1.getByRiotId(client, 'americas', 'PlayerName', 'NA1');
+   * console.log(account.puuid);
+   * ```
+   */
+  readonly getByRiotId: (client: WhisperClient, route: RegionalRoute, gameName: string, tagLine: string) => Promise<Account>;
+  /**
+   * Get the active shard for a player in a specific game.
+   *
+   * Determines which platform shard hosts a player's data for a given game.
+   * Useful for routing subsequent requests to the correct shard.
+   *
+   * @param client - WhisperClient instance
+   * @param route - Regional routing value (e.g., 'americas', 'europe')
+   * @param game - Game identifier (e.g., "val", "lor")
+   * @param puuid - Encrypted PUUID
+   * @returns Active shard information for the player and game
+   *
+   * @example
+   * ```typescript
+   * const shard = await accountV1.getByGame(client, 'americas', 'val', 'abc-123-def');
+   * console.log(shard.activeShard); // e.g., "na"
+   * ```
+   */
+  readonly getByGame: (client: WhisperClient, route: RegionalRoute, game: string, puuid: string) => Promise<ActiveShard>;
+};
+//#endregion
+export { type Account, type ActiveShard, accountV1 };
+//# sourceMappingURL=index.d.cts.map

package/dist/riot/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/types/generated/riot.ts","../../src/types/overrides/riot-account.ts","../../src/riot/account-v1.ts"],"mappings":";;;;UAIiB,OAAA;;EAEf,QAAA;EAFsB;EAItB,KAAA;EAJsB;EAMtB,OAAA;AAAA;;;;;;AANF;;;UCEiB,WAAA;EDAf;ECEA,KAAA;EDEA;ECAA,IAAA;EDAO;ECEP,WAAA;AAAA;;;;;;;;;;;;;;AANF;;;;;cCea,SAAA;EDTX;;;;;;ACSF;;;;;;;;EDTE,8BCwByB,aAAA,EAAa,KAAA,EAAS,aAAA,EAAa,KAAA,aAAkB,OAAA,CAAQ,OAAA;EA6B3E;;;;;;;;;;;;;;;EAAA,+BAJD,aAAA,EAAa,KAAA,EACd,aAAA,EAAa,QAAA,UACJ,OAAA,aAEf,OAAA,CAAQ,OAAA;;;;;;;;;;;;;;;;;;;+BA4BD,aAAA,EAAa,KAAA,EACd,aAAA,EAAa,IAAA,UACR,KAAA,aAEX,OAAA,CAAQ,WAAA;AAAA"}

package/dist/riot/index.d.ts

@@ -0,0 +1,101 @@
+import { p as RegionalRoute, t as WhisperClient } from "../client-Xu0AwrUw.js";
+
+//#region src/types/generated/riot.d.ts
+/** Riot account information linked to a Riot ID. */
+interface Account {
+  /** In-game name component of the Riot ID. */
+  gameName: string;
+  /** Player Universally Unique Identifier (PUUID). */
+  puuid: string;
+  /** Tag component of the Riot ID (e.g., "NA1"). */
+  tagLine: string;
+}
+//#endregion
+//#region src/types/overrides/riot-account.d.ts
+/**
+ * Active shard information for a player in a specific game.
+ *
+ * Returned by account-v1.getByGame to determine which platform shard
+ * a player's game data is hosted on.
+ */
+interface ActiveShard {
+  /** Encrypted PUUID of the player */
+  puuid: string;
+  /** Game identifier (e.g., "val", "lor") */
+  game: string;
+  /** Active shard/platform for this player and game (e.g., "na", "eu") */
+  activeShard: string;
+}
+//#endregion
+//#region src/riot/account-v1.d.ts
+/**
+ * Riot Account API (v1).
+ *
+ * Shared across all Riot games. Look up accounts by PUUID or Riot ID,
+ * or query which shard a player is active on for a given game.
+ *
+ * All methods require a {@link RegionalRoute} (americas, europe, asia, sea).
+ *
+ * @example
+ * ```typescript
+ * import { accountV1 } from '@wardbox/whisper/riot';
+ *
+ * const account = await accountV1.getByRiotId(client, 'americas', 'PlayerName', 'NA1');
+ * console.log(account.puuid);
+ * ```
+ */
+declare const accountV1: {
+  /**
+   * Get an account by PUUID.
+   *
+   * @param client - WhisperClient instance
+   * @param route - Regional routing value (e.g., 'americas', 'europe')
+   * @param puuid - Encrypted PUUID
+   * @returns Account data including gameName, tagLine, and puuid
+   *
+   * @example
+   * ```typescript
+   * const account = await accountV1.getByPuuid(client, 'americas', 'abc-123-def');
+   * console.log(account.gameName, account.tagLine);
+   * ```
+   */
+  readonly getByPuuid: (client: WhisperClient, route: RegionalRoute, puuid: string) => Promise<Account>;
+  /**
+   * Get an account by Riot ID (gameName + tagLine).
+   *
+   * @param client - WhisperClient instance
+   * @param route - Regional routing value (e.g., 'americas', 'europe')
+   * @param gameName - Riot ID game name
+   * @param tagLine - Riot ID tag line (e.g., "NA1")
+   * @returns Account data including gameName, tagLine, and puuid
+   *
+   * @example
+   * ```typescript
+   * const account = await accountV1.getByRiotId(client, 'americas', 'PlayerName', 'NA1');
+   * console.log(account.puuid);
+   * ```
+   */
+  readonly getByRiotId: (client: WhisperClient, route: RegionalRoute, gameName: string, tagLine: string) => Promise<Account>;
+  /**
+   * Get the active shard for a player in a specific game.
+   *
+   * Determines which platform shard hosts a player's data for a given game.
+   * Useful for routing subsequent requests to the correct shard.
+   *
+   * @param client - WhisperClient instance
+   * @param route - Regional routing value (e.g., 'americas', 'europe')
+   * @param game - Game identifier (e.g., "val", "lor")
+   * @param puuid - Encrypted PUUID
+   * @returns Active shard information for the player and game
+   *
+   * @example
+   * ```typescript
+   * const shard = await accountV1.getByGame(client, 'americas', 'val', 'abc-123-def');
+   * console.log(shard.activeShard); // e.g., "na"
+   * ```
+   */
+  readonly getByGame: (client: WhisperClient, route: RegionalRoute, game: string, puuid: string) => Promise<ActiveShard>;
+};
+//#endregion
+export { type Account, type ActiveShard, accountV1 };
+//# sourceMappingURL=index.d.ts.map

package/dist/riot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/types/generated/riot.ts","../../src/types/overrides/riot-account.ts","../../src/riot/account-v1.ts"],"mappings":";;;;UAIiB,OAAA;;EAEf,QAAA;EAFsB;EAItB,KAAA;EAJsB;EAMtB,OAAA;AAAA;;;;;;AANF;;;UCEiB,WAAA;EDAf;ECEA,KAAA;EDEA;ECAA,IAAA;EDAO;ECEP,WAAA;AAAA;;;;;;;;;;;;;;AANF;;;;;cCea,SAAA;EDTX;;;;;;ACSF;;;;;;;;EDTE,8BCwByB,aAAA,EAAa,KAAA,EAAS,aAAA,EAAa,KAAA,aAAkB,OAAA,CAAQ,OAAA;EA6B3E;;;;;;;;;;;;;;;EAAA,+BAJD,aAAA,EAAa,KAAA,EACd,aAAA,EAAa,QAAA,UACJ,OAAA,aAEf,OAAA,CAAQ,OAAA;;;;;;;;;;;;;;;;;;;+BA4BD,aAAA,EAAa,KAAA,EACd,aAAA,EAAa,IAAA,UACR,KAAA,aAEX,OAAA,CAAQ,WAAA;AAAA"}

package/dist/riot/index.js

@@ -0,0 +1,32 @@
+//#region src/riot/account-v1.ts
+/**
+* Riot Account API (v1).
+*
+* Shared across all Riot games. Look up accounts by PUUID or Riot ID,
+* or query which shard a player is active on for a given game.
+*
+* All methods require a {@link RegionalRoute} (americas, europe, asia, sea).
+*
+* @example
+* ```typescript
+* import { accountV1 } from '@wardbox/whisper/riot';
+*
+* const account = await accountV1.getByRiotId(client, 'americas', 'PlayerName', 'NA1');
+* console.log(account.puuid);
+* ```
+*/
+const accountV1 = {
+	async getByPuuid(client, route, puuid) {
+		return (await client.request(route, `/riot/account/v1/accounts/by-puuid/${encodeURIComponent(puuid)}`, "account-v1.getByPuuid")).data;
+	},
+	async getByRiotId(client, route, gameName, tagLine) {
+		return (await client.request(route, `/riot/account/v1/accounts/by-riot-id/${encodeURIComponent(gameName)}/${encodeURIComponent(tagLine)}`, "account-v1.getByRiotId")).data;
+	},
+	async getByGame(client, route, game, puuid) {
+		return (await client.request(route, `/riot/account/v1/active-shards/by-game/${encodeURIComponent(game)}/by-puuid/${encodeURIComponent(puuid)}`, "account-v1.getByGame")).data;
+	}
+};
+//#endregion
+export { accountV1 };
+
+//# sourceMappingURL=index.js.map

package/dist/tft/index.cjs

@@ -0,0 +1,152 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/tft/spectator-tft-v5.ts
+/**
+* TFT Spectator API (v5).
+*
+* Access live TFT game data. Use this to check if a player is currently
+* in a TFT game.
+*
+* All methods require a {@link PlatformRoute} (e.g., 'na1', 'euw1').
+*
+* @example
+* ```typescript
+* import { spectatorTftV5 } from '@wardbox/whisper/tft';
+*
+* const game = await spectatorTftV5.getCurrentGame(client, 'na1', puuid);
+* console.log(`In TFT game on map ${game.mapId}`);
+* ```
+*/
+const spectatorTftV5 = { async getCurrentGame(client, route, puuid) {
+	return (await client.request(route, `/lol/spectator/tft/v5/active-games/by-puuid/${encodeURIComponent(puuid)}`, "spectator-tft-v5.getCurrentGame")).data;
+} };
+//#endregion
+//#region src/tft/tft-league-v1.ts
+/**
+* TFT League API (v1).
+*
+* Query TFT ranked league standings, entries by PUUID, and full league data
+* for challenger/grandmaster/master tiers. Also includes top-rated ladder
+* for Hyper Roll and Double Up queues.
+*
+* All methods require a {@link PlatformRoute} (e.g., 'na1', 'euw1').
+*
+* @example
+* ```typescript
+* import { tftLeagueV1 } from '@wardbox/whisper/tft';
+*
+* const challenger = await tftLeagueV1.getChallengerLeague(client, 'na1');
+* console.log(challenger.entries.length);
+* ```
+*/
+const tftLeagueV1 = {
+	async getChallengerLeague(client, route, options) {
+		const params = options?.queue !== void 0 ? { queue: options.queue } : void 0;
+		return (await client.request(route, "/tft/league/v1/challenger", "tft-league-v1.getChallengerLeague", params ? { params } : void 0)).data;
+	},
+	async getGrandmasterLeague(client, route, options) {
+		const params = options?.queue !== void 0 ? { queue: options.queue } : void 0;
+		return (await client.request(route, "/tft/league/v1/grandmaster", "tft-league-v1.getGrandmasterLeague", params ? { params } : void 0)).data;
+	},
+	async getMasterLeague(client, route, options) {
+		const params = options?.queue !== void 0 ? { queue: options.queue } : void 0;
+		return (await client.request(route, "/tft/league/v1/master", "tft-league-v1.getMasterLeague", params ? { params } : void 0)).data;
+	},
+	async getLeagueEntriesByPuuid(client, route, puuid, options) {
+		const params = options?.queue !== void 0 ? { queue: options.queue } : void 0;
+		return (await client.request(route, `/tft/league/v1/by-puuid/${encodeURIComponent(puuid)}`, "tft-league-v1.getLeagueEntriesByPuuid", params ? { params } : void 0)).data;
+	},
+	async getLeagueEntries(client, route, tier, division, options) {
+		const params = {};
+		if (options) {
+			if (options.queue !== void 0) params.queue = options.queue;
+			if (options.page !== void 0) params.page = String(options.page);
+		}
+		return (await client.request(route, `/tft/league/v1/entries/${encodeURIComponent(tier)}/${encodeURIComponent(division)}`, "tft-league-v1.getLeagueEntries", Object.keys(params).length > 0 ? { params } : void 0)).data;
+	},
+	async getLeagueById(client, route, leagueId) {
+		return (await client.request(route, `/tft/league/v1/leagues/${encodeURIComponent(leagueId)}`, "tft-league-v1.getLeagueById")).data;
+	},
+	async getTopRatedLadder(client, route, queue) {
+		return (await client.request(route, `/tft/league/v1/rated-ladders/${encodeURIComponent(queue)}/top`, "tft-league-v1.getTopRatedLadder")).data;
+	}
+};
+//#endregion
+//#region src/tft/tft-match-v1.ts
+/**
+* TFT Match API (v1).
+*
+* Retrieve TFT match history and match details by PUUID or match ID.
+*
+* All methods require a {@link RegionalRoute} (americas, europe, asia, sea).
+*
+* @example
+* ```typescript
+* import { tftMatchV1 } from '@wardbox/whisper/tft';
+*
+* const matchIds = await tftMatchV1.getMatchIdsByPuuid(client, 'americas', 'puuid-123');
+* const match = await tftMatchV1.getMatch(client, 'americas', matchIds[0]);
+* ```
+*/
+const tftMatchV1 = {
+	async getMatchIdsByPuuid(client, route, puuid, options) {
+		const params = {};
+		if (options) {
+			for (const [key, value] of Object.entries(options)) if (value !== void 0) params[key] = String(value);
+		}
+		return (await client.request(route, `/tft/match/v1/matches/by-puuid/${encodeURIComponent(puuid)}/ids`, "tft-match-v1.getMatchIdsByPuuid", Object.keys(params).length > 0 ? { params } : void 0)).data;
+	},
+	async getMatch(client, route, matchId) {
+		return (await client.request(route, `/tft/match/v1/matches/${encodeURIComponent(matchId)}`, "tft-match-v1.getMatch")).data;
+	}
+};
+//#endregion
+//#region src/tft/tft-status-v1.ts
+/**
+* TFT Status API (v1).
+*
+* Retrieve TFT platform status information including incidents and maintenances.
+*
+* All methods require a {@link PlatformRoute} (e.g., 'na1', 'euw1').
+*
+* @example
+* ```typescript
+* import { tftStatusV1 } from '@wardbox/whisper/tft';
+*
+* const status = await tftStatusV1.getPlatformData(client, 'na1');
+* console.log(status.name, status.incidents.length);
+* ```
+*/
+const tftStatusV1 = { async getPlatformData(client, route) {
+	return (await client.request(route, "/tft/status/v1/platform-data", "tft-status-v1.getPlatformData")).data;
+} };
+//#endregion
+//#region src/tft/tft-summoner-v1.ts
+/**
+* TFT Summoner API (v1).
+*
+* Access TFT summoner data by PUUID or RSO access token.
+*
+* All methods require a {@link PlatformRoute} (e.g., 'na1', 'euw1').
+*
+* @example
+* ```typescript
+* import { tftSummonerV1 } from '@wardbox/whisper/tft';
+*
+* const summoner = await tftSummonerV1.getByPuuid(client, 'na1', puuid);
+* console.log(summoner.summonerLevel);
+* ```
+*/
+const tftSummonerV1 = {
+	async getByPuuid(client, route, puuid) {
+		return (await client.request(route, `/tft/summoner/v1/summoners/by-puuid/${encodeURIComponent(puuid)}`, "tft-summoner-v1.getByPuuid")).data;
+	},
+	async getByAccessToken(client, route, accessToken) {
+		return (await client.request(route, "/tft/summoner/v1/summoners/me", "tft-summoner-v1.getByAccessToken", { headers: { Authorization: `Bearer ${accessToken}` } })).data;
+	}
+};
+//#endregion
+exports.spectatorTftV5 = spectatorTftV5;
+exports.tftLeagueV1 = tftLeagueV1;
+exports.tftMatchV1 = tftMatchV1;
+exports.tftStatusV1 = tftStatusV1;
+exports.tftSummonerV1 = tftSummonerV1;