@pinta365/blizzard_api 0.3.9 → 0.5.0

package/esm/src/wow/profile/guild.d.ts

@@ -0,0 +1,150 @@
+import type { ApiContext } from "../../shared/index.js";
+import type { Character, Href, KeyId, KeyNameId, LinkSelfHref, LocalizedString, TypeName } from "../../shared/index.js";
+export interface GuildCrestRgba {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export interface CrestAsset {
+    id?: number;
+    media?: KeyId;
+    color: {
+        id: number;
+        rgba?: GuildCrestRgba;
+    };
+}
+export interface GuildReference {
+    key: Href;
+    name: string;
+    id: number;
+    realm: {
+        key: Href;
+        name: LocalizedString;
+        id: number;
+        slug: string;
+    };
+    faction: TypeName;
+}
+export interface Guild extends LinkSelfHref {
+    key?: Href;
+    id: number;
+    name: string;
+    faction: TypeName;
+    achievement_points?: number;
+    member_count?: number;
+    realm: {
+        key: Href;
+        name: LocalizedString;
+        id: number;
+        slug: string;
+    };
+    crest?: {
+        emblem: CrestAsset;
+        border: CrestAsset;
+        background: CrestAsset;
+    };
+    roster?: Href;
+    achievements?: Href;
+    created_timestamp?: number;
+    activity?: Href;
+    name_search: string;
+}
+export interface GuildActivity extends LinkSelfHref {
+    guild: GuildReference;
+    activities?: {
+        character_achievement?: {
+            character: Character;
+            achievement: KeyNameId;
+        };
+        encounter_completed?: {
+            encounter: KeyNameId;
+            mode: TypeName;
+        };
+        activity: {
+            type: string;
+        };
+        timestamp: number;
+    }[];
+}
+export interface Critiera {
+    id: number;
+    amount?: number;
+    is_completed: boolean;
+    child_criteria?: Critiera[];
+}
+export interface GuildAchievements extends LinkSelfHref {
+    guild: GuildReference;
+    total_quantity: number;
+    total_points: number;
+    achievements: {
+        id: number;
+        achievement: KeyNameId;
+        criteria?: Critiera;
+        completed_timestamp?: number;
+    }[];
+    category_progress?: {
+        category: KeyNameId;
+        quantity: number;
+        points: number;
+    }[];
+    recent_events?: {
+        achievement: KeyNameId;
+        timestamp: number;
+    }[];
+}
+export interface GuildRosterMemberCharacter {
+    key: Href;
+    name: string;
+    id: number;
+    realm: {
+        key: Href;
+        id: number;
+        slug: string;
+    };
+    level: number;
+    playable_class: KeyId;
+    playable_race: KeyId;
+    faction: {
+        type: string;
+    };
+}
+export interface GuildRoster extends LinkSelfHref {
+    guild: GuildReference;
+    members: {
+        character: GuildRosterMemberCharacter;
+        rank: number;
+    }[];
+}
+/**
+ * Returns a single guild by its name and realm.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param nameSlug - The slug of the guild.
+ * @returns A promise that resolves to an object representing a single guild by its name and realm.
+ */
+export declare function guild(ctx: ApiContext, realmSlug: string, nameSlug: string): Promise<Guild>;
+/**
+ * Returns a single guild's activity by name and realm.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param nameSlug - The slug of the guild.
+ * @returns A promise that resolves to an object representing a single guild's activity by its name and realm.
+ */
+export declare function guildActivity(ctx: ApiContext, realmSlug: string, nameSlug: string): Promise<GuildActivity>;
+/**
+ * Returns a single guild's achievements by name and realm.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param nameSlug - The slug of the guild.
+ * @returns A promise that resolves to an object representing a single guild's achievements by its name and realm.
+ */
+export declare function guildAchievements(ctx: ApiContext, realmSlug: string, nameSlug: string): Promise<GuildAchievements>;
+/**
+ * Returns a single guild's roster by its name and realm.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param nameSlug - The slug of the guild.
+ * @returns A promise that resolves to an object representing a single guild's roster by its name and realm.
+ */
+export declare function guildRoster(ctx: ApiContext, realmSlug: string, nameSlug: string): Promise<GuildRoster>;

package/esm/src/wow/profile/guild.js

@@ -0,0 +1,56 @@
+/**
+ * Returns a single guild by its name and realm.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param nameSlug - The slug of the guild.
+ * @returns A promise that resolves to an object representing a single guild by its name and realm.
+ */
+export async function guild(ctx, realmSlug, nameSlug) {
+    return await ctx.request({
+        method: "GET",
+        url: `/data/wow/guild/${realmSlug}/${nameSlug}`,
+        namespace: "profile",
+    });
+}
+/**
+ * Returns a single guild's activity by name and realm.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param nameSlug - The slug of the guild.
+ * @returns A promise that resolves to an object representing a single guild's activity by its name and realm.
+ */
+export async function guildActivity(ctx, realmSlug, nameSlug) {
+    return await ctx.request({
+        method: "GET",
+        url: `/data/wow/guild/${realmSlug}/${nameSlug}/activity`,
+        namespace: "profile",
+    });
+}
+/**
+ * Returns a single guild's achievements by name and realm.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param nameSlug - The slug of the guild.
+ * @returns A promise that resolves to an object representing a single guild's achievements by its name and realm.
+ */
+export async function guildAchievements(ctx, realmSlug, nameSlug) {
+    return await ctx.request({
+        method: "GET",
+        url: `/data/wow/guild/${realmSlug}/${nameSlug}/achievements`,
+        namespace: "profile",
+    });
+}
+/**
+ * Returns a single guild's roster by its name and realm.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param nameSlug - The slug of the guild.
+ * @returns A promise that resolves to an object representing a single guild's roster by its name and realm.
+ */
+export async function guildRoster(ctx, realmSlug, nameSlug) {
+    return await ctx.request({
+        method: "GET",
+        url: `/data/wow/guild/${realmSlug}/${nameSlug}/roster`,
+        namespace: "profile",
+    });
+}

package/esm/src/wow/search.d.ts

@@ -0,0 +1,23 @@
+import type { ApiContext } from "../shared/index.js";
+import type { Namespaces } from "../shared/index.js";
+export interface SearchParameters {
+    searchFields?: Record<string | symbol, string | number>;
+    orderBy?: string;
+    page?: number;
+    pageSize?: number;
+}
+export interface Search {
+    page: number;
+    pageSize: number;
+    maxPageSize: number;
+    pageCount: number;
+    resultCountCapped?: boolean;
+    results: unknown[];
+}
+/**
+ * Performs a search.
+ *
+ * @param SearchParameters - Object containing search parameters.
+ * @returns A promise that resolves to an object representing details about the search.
+ */
+export declare function search(ctx: ApiContext, url: string, namespace: Namespaces, searchParameters: SearchParameters): Promise<Search>;

package/esm/src/wow/search.js

@@ -0,0 +1,29 @@
+/**
+ * Performs a search.
+ *
+ * @param SearchParameters - Object containing search parameters.
+ * @returns A promise that resolves to an object representing details about the search.
+ */
+export async function search(ctx, url, namespace, searchParameters) {
+    const searchFields = searchParameters.searchFields
+        ? Object.fromEntries(Object.entries(searchParameters.searchFields).map(([key, value]) => [key, value.toString()]))
+        : undefined;
+    const qs = {
+        ...searchFields,
+    };
+    if (searchParameters.orderBy) {
+        qs.orderby = searchParameters.orderBy;
+    }
+    if (searchParameters.page !== undefined) {
+        qs._page = searchParameters.page;
+    }
+    if (searchParameters.pageSize !== undefined) {
+        qs._pageSize = searchParameters.pageSize;
+    }
+    return await ctx.request({
+        method: "GET",
+        url: `/data/wow/search${url}`,
+        qs,
+        namespace,
+    });
+}

package/esm/src/wow/types.d.ts

@@ -0,0 +1,58 @@
+export type { Achievement, AchievementCategories, AchievementCategory, AchievementMedia, Achievements, AggregatesByFaction, } from "./game_data/achievement.js";
+export type { AuctionItem, AuctionListing, Auctions, Commodities, commodity } from "./game_data/auction_house.js";
+export type { AzeriteEssenceDetails, AzeritEessenceMedia, AzeriteEssences, AzeritePower, } from "./game_data/azerite_essence.js";
+export type { ConnectedRealm, ConnectedRealmRealm, ConnectedRealms } from "./game_data/connected_realm.js";
+export type { ClassAbility, Covenant, CovenantAbilitySpellTooltip, CovenantConduit, CovenantConduitRank, CovenantConduits, CovenantConduitSpellTooltip, CovenantMedia, Covenants, CovenantSoulbind, CovenantSoulbinds, SignatureAbility, } from "./game_data/covenant.js";
+export type { Creature, CreatureDisplayAssets, CreatureDisplayMedia, CreatureFamilies, CreatureFamily, CreatureFamilyAssets, CreatureFamilyMedia, CreatureType, CreatureTypes, } from "./game_data/creature.js";
+export type { Border, Emblem, GuildCrestBorder, GuildCrestEmblem, GuildCrests, IdRgba, } from "./game_data/guild_crest.js";
+export type { Heirloom, Heirlooms, Upgrade, UpgradeStats, ValueDisplayString } from "./game_data/heirloom.js";
+export type { Decor, Decors, Fixture, FixtureHook, FixtureHooks, Fixtures, Room, Rooms } from "./game_data/housing.js";
+export type { Item, ItemClass, ItemClasses, ItemMedia, ItemSet, ItemSets, ItemSubclass } from "./game_data/item.js";
+export type { AppearanceSlot, ItemAppearance, ItemAppearanceSearch, ItemAppearanceSearchResult, ItemAppearanceSet, ItemAppearanceSets, ItemAppearanceSlot, ItemAppearanceSlotRef, ItemAppearanceSlots, } from "./game_data/item_appearance.js";
+export type { EncounterSection, JournalEncounter, JournalEncounters, JournalExpansion, JournalExpansions, JournalInstance, JournalInstanceMedia, JournalInstances, } from "./game_data/journal.js";
+export type { KeystoneAffix, KeystoneAffixes, KeystoneAffixMedia } from "./game_data/keystone_affix.js";
+export type { ModifiedCraftingCategories, ModifiedCraftingCategory, ModifiedCraftingParents, ModifiedCraftingSlotType, ModifiedCraftingSlotTypes, } from "./game_data/modified_crafting.js";
+export type { Mount, Mounts } from "./game_data/mount.js";
+export type { MythicKeystoneDungeon, MythicKeystoneDungeons, MythicKeystoneIndex, MythicKeystonePeriod, MythicKeystonePeriods, MythicKeystoneSeason, MythicKeystoneSeasons, } from "./game_data/mythic_keystone_dungeon.js";
+export type { MythicKeystoneLeaderboard, MythicKeystoneLeaderboards, MythicLeaderboardRating, } from "./game_data/mythic_keystone_leaderboard.js";
+export type { MythicRaidLeaderboard } from "./game_data/mythic_raid_leaderboard.js";
+export type { Neighborhood, NeighborhoodMap, NeighborhoodMaps } from "./game_data/neighborhood.js";
+export type { Pet, PetAbilities, PetAbility, PetAbilityMedia, PetMedia, Pets } from "./game_data/pet.js";
+export type { PlayableClass, PlayableClasses, PlayableClassMedia, PlayableClassPvpTalentSlots, } from "./game_data/playable_class.js";
+export type { PlayableRace, PlayableRaces } from "./game_data/playable_race.js";
+export type { PlayableSpecialization, PlayableSpecializationMedia, PlayableSpecializations, } from "./game_data/playable_specialization.js";
+export type { PowerType, PowerTypes } from "./game_data/power_type.js";
+export type { Profession, ProfessionMedia, ProfessionRecipie, professionRecipieMedia, Professions, ProfessionSkillTier, } from "./game_data/profession.js";
+export type { PvpSeason, PvpSeasonLeaderboard, PvpSeasonLeaderboards, PvpSeasonRewards, PvpSeasons, } from "./game_data/pvp_season.js";
+export type { PvpTier, PvpTierMedia, PvpTiers } from "./game_data/pvp_tier.js";
+export type { Quest, QuestArea, QuestAreas, QuestCategories, QuestCategory, Quests, QuestType, QuestTypes, } from "./game_data/quest.js";
+export type { Realm, RealmList, Realms } from "./game_data/realm.js";
+export type { Region, Regions } from "./game_data/region.js";
+export type { ReputationFaction, ReputationFactions, ReputationTier, ReputationTiers, } from "./game_data/reputations.js";
+export type { Spell, SpellMedia } from "./game_data/spell.js";
+export type { HeroTalentTree, NodeType, PvpTalent, PvpTalents, Rank, SpellTooltip, Talent, TalentNode, Talents, TalentTree, TalentTreeNodes, TalentTrees, Tooltip, } from "./game_data/talent.js";
+export type { TechTalent, TechTalentMedia, TechTalents, TechTalentTree, TechTalentTreeRef, TechTalentTrees, } from "./game_data/tech_talent.js";
+export type { Title, Titles } from "./game_data/title.js";
+export type { WowToken } from "./game_data/token.js";
+export type { Toy, Toys } from "./game_data/toy.js";
+export type { AccountCharacter, AccountCollectionsIndex, AccountDecorCollection, AccountHeirloomsCollection, AccountMount, AccountMountsCollection, AccountPetsCollection, AccountProfileSummary, AccountToysCollection, AccountTransmogsCollection, ProtectedCharacterProfile, } from "./profile/account_profile.js";
+export type { AchievementCriteria, AchievementStatistic, AchievementsubCategory, CharacterAchievementStatistics, CharacterAchievementSummary, } from "./profile/character_achievements.js";
+export type { CharacterAppearanceSummary } from "./profile/character_appearance.js";
+export type { CharacterCollectionDecor, CharacterCollectionHeirlooms, CharacterCollectionMounts, CharacterCollectionPets, CharacterCollectionToys, CharacterCollectionTransmogs, CharacterCollectionTypes, CollectedHeirloom, CollectedMount, CollectedPet, CollectedToy, DecorItem, TransmogrifiedSlot, } from "./profile/character_collections.js";
+export type { CharacterEncounterDungeons, CharacterEncounterRaids, CharacterEncounters, } from "./profile/character_encounters.js";
+export type { characterEquipments, EquippedItemWeapon, Rgba } from "./profile/character_equipment.js";
+export type { CharacterHouse } from "./profile/character_house.js";
+export type { CharacterHunterPets } from "./profile/character_hunter_pets.js";
+export type { CharacterMedia } from "./profile/character_media.js";
+export type { CharacterMythicKeystoneProfile, CharacterMythicKeystoneSeasonDetails, MythicKeystoneBestRun, MythicKeystoneMemberCharacter, MythicRating, } from "./profile/character_mythic_keystone_profile.js";
+export type { CharacterProfession, CharacterProfessions, Tier } from "./profile/character_professions.js";
+export type { CharacterProfile, CharacterProfileStatus, CharacterRealm } from "./profile/character_profile.js";
+export type { CharacterPvpBracketStatistics, CharacterPvpSummary, MatchStatistic } from "./profile/character_pvp.js";
+export type { CharacterCompletedQuests, CharacterQuests } from "./profile/character_quests.js";
+export type { CharacterReputations } from "./profile/character_reputations.js";
+export type { CharacterSoulbinds } from "./profile/character_soulbinds.js";
+export type { CharacterSpecializations, CharacterSpecializationTalent, ClassicSpecializationTalent, Detail, } from "./profile/character_specializations.js";
+export type { CharacterStatistics, StatRating, StatRatingBonus } from "./profile/character_statistics.js";
+export type { CharacterTitles } from "./profile/character_titles.js";
+export type { CrestAsset, Critiera, Guild, GuildAchievements, GuildActivity, GuildCrestRgba, GuildReference, GuildRoster, GuildRosterMemberCharacter, } from "./profile/guild.js";
+export type { Search, SearchParameters } from "./search.js";

package/esm/src/wow/types.js

@@ -0,0 +1 @@
+export {};

package/esm/src/wow_classic/auction_house.d.ts

@@ -0,0 +1,41 @@
+/**
+ * This module provides the Classic Era auction house endpoints. Classic Era realms have separate Alliance, Horde and
+ * neutral auction houses, so auctions are listed per auction house instead of per connected realm.
+ */
+import type { ApiContext } from "../shared/index.js";
+import type { Href, LinkSelfHref, NamedRef } from "../shared/index.js";
+export interface AuctionHouses extends LinkSelfHref {
+    auctions: NamedRef[];
+}
+export interface AuctionHouseAuctions extends LinkSelfHref {
+    connected_realm: Href;
+    auctions: {
+        id: number;
+        item: {
+            id: number;
+            rand?: number;
+            seed?: number;
+        };
+        bid?: number;
+        buyout?: number;
+        quantity: number;
+        time_left: string;
+    }[];
+    id: number;
+    name: string;
+}
+/**
+ * Returns an index of the auction houses (Alliance, Horde, neutral) of a Classic Era connected realm.
+ *
+ * @param connectedRealmId - The ID of the connected realm.
+ * @returns A promise that resolves to an object listing the auction houses.
+ */
+export declare function auctionHouses(ctx: ApiContext, connectedRealmId: number): Promise<AuctionHouses>;
+/**
+ * Returns all active auctions of one auction house of a Classic Era connected realm.
+ *
+ * @param connectedRealmId - The ID of the connected realm.
+ * @param auctionHouseId - The ID of the auction house, from auctionHouses().
+ * @returns A promise that resolves to an object listing the auctions.
+ */
+export declare function auctionHouse(ctx: ApiContext, connectedRealmId: number, auctionHouseId: number): Promise<AuctionHouseAuctions>;

package/esm/src/wow_classic/auction_house.js

@@ -0,0 +1,31 @@
+/**
+ * This module provides the Classic Era auction house endpoints. Classic Era realms have separate Alliance, Horde and
+ * neutral auction houses, so auctions are listed per auction house instead of per connected realm.
+ */
+/**
+ * Returns an index of the auction houses (Alliance, Horde, neutral) of a Classic Era connected realm.
+ *
+ * @param connectedRealmId - The ID of the connected realm.
+ * @returns A promise that resolves to an object listing the auction houses.
+ */
+export async function auctionHouses(ctx, connectedRealmId) {
+    return await ctx.request({
+        method: "GET",
+        url: `/data/wow/connected-realm/${connectedRealmId}/auctions/index`,
+        namespace: "dynamic",
+    });
+}
+/**
+ * Returns all active auctions of one auction house of a Classic Era connected realm.
+ *
+ * @param connectedRealmId - The ID of the connected realm.
+ * @param auctionHouseId - The ID of the auction house, from auctionHouses().
+ * @returns A promise that resolves to an object listing the auctions.
+ */
+export async function auctionHouse(ctx, connectedRealmId, auctionHouseId) {
+    return await ctx.request({
+        method: "GET",
+        url: `/data/wow/connected-realm/${connectedRealmId}/auctions/${auctionHouseId}`,
+        namespace: "dynamic",
+    });
+}

package/esm/src/wow_classic/character_specializations.d.ts

@@ -0,0 +1,45 @@
+/**
+ * This module provides the Classic Era character specializations endpoint. Era characters have talent trees with
+ * points spent per tree (and dual-spec groups) instead of Retail's loadouts, so the response has its own shape.
+ */
+import type { ApiContext } from "../shared/index.js";
+import type { Character, Href } from "../shared/index.js";
+export interface ClassicEraTalent {
+    talent: {
+        id: number;
+    };
+    spell_tooltip: {
+        spell: {
+            name: string;
+            id: number;
+        };
+        description: string;
+        cast_time: string;
+        power_cost?: string | null;
+        range?: string;
+        cooldown?: string;
+    };
+    talent_rank: number;
+}
+export interface ClassicEraCharacterSpecializations {
+    _links: {
+        self: Href;
+    };
+    character: Character;
+    specialization_groups: {
+        is_active: boolean;
+        specializations: {
+            specialization_name: string;
+            spent_points: number;
+            talents: ClassicEraTalent[];
+        }[];
+    }[];
+}
+/**
+ * Returns a summary of a character's talent trees (Classic Era).
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param characterName - The lowercase name of the character.
+ * @returns A promise that resolves to an object representing the character's talent groups.
+ */
+export declare function characterSpecializations(ctx: ApiContext, realmSlug: string, characterName: string): Promise<ClassicEraCharacterSpecializations>;

package/esm/src/wow_classic/character_specializations.js

@@ -0,0 +1,18 @@
+/**
+ * This module provides the Classic Era character specializations endpoint. Era characters have talent trees with
+ * points spent per tree (and dual-spec groups) instead of Retail's loadouts, so the response has its own shape.
+ */
+/**
+ * Returns a summary of a character's talent trees (Classic Era).
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param characterName - The lowercase name of the character.
+ * @returns A promise that resolves to an object representing the character's talent groups.
+ */
+export async function characterSpecializations(ctx, realmSlug, characterName) {
+    return await ctx.request({
+        method: "GET",
+        url: `/profile/wow/character/${realmSlug}/${characterName}/specializations`,
+        namespace: "profile",
+    });
+}

package/esm/src/wow_classic/era.d.ts

@@ -0,0 +1,8 @@
+/**
+ * World of Warcraft Classic Era endpoints (Era, Season of Discovery, Hardcore, Anniversary), namespace variant
+ * "classic1x". The client binds them to a "classic1x" context.
+ * Verified against the live API (EU) on 2026-09-30.
+ */
+export * from "./shared.js";
+export { auctionHouse, auctionHouses } from "./auction_house.js";
+export { characterSpecializations } from "./character_specializations.js";

package/esm/src/wow_classic/era.js

@@ -0,0 +1,10 @@
+/**
+ * World of Warcraft Classic Era endpoints (Era, Season of Discovery, Hardcore, Anniversary), namespace variant
+ * "classic1x". The client binds them to a "classic1x" context.
+ * Verified against the live API (EU) on 2026-09-30.
+ */
+export * from "./shared.js";
+// Game Data APIs
+export { auctionHouse, auctionHouses } from "./auction_house.js";
+// Profile APIs
+export { characterSpecializations } from "./character_specializations.js";

package/esm/src/wow_classic/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * World of Warcraft Classic (progression) endpoints, namespace variant "classic".
+ * These are the Retail endpoint functions that the Classic API supports; the client binds them to a "classic" context.
+ * Verified against the live API (EU) on 2026-09-30.
+ */
+export * from "./shared.js";
+export { auctions } from "../wow/game_data/auction_house.js";
+export { mythicKeystonePeriod, mythicKeystonePeriods, mythicKeystoneSeason, mythicKeystoneSeasons, } from "../wow/game_data/mythic_keystone_dungeon.js";
+export { mythicKeystoneLeaderboard, mythicKeystoneLeaderboards } from "../wow/game_data/mythic_keystone_leaderboard.js";
+export { playableSpecialization, playableSpecializationMedia, playableSpecializations, } from "../wow/game_data/playable_specialization.js";
+export { pvpSeason, pvpSeasonLeaderboard, pvpSeasonLeaderboards, pvpSeasonRewards, pvpSeasons, } from "../wow/game_data/pvp_season.js";
+export { token } from "../wow/game_data/token.js";
+export { characterAchievementStatistics } from "../wow/profile/character_achievements.js";
+export { characterPvpBracketStatistics } from "../wow/profile/character_pvp.js";
+export { characterAchievementSummary, characterSpecializations, commodities } from "./profile_overrides.js";

package/esm/src/wow_classic/index.js

@@ -0,0 +1,17 @@
+/**
+ * World of Warcraft Classic (progression) endpoints, namespace variant "classic".
+ * These are the Retail endpoint functions that the Classic API supports; the client binds them to a "classic" context.
+ * Verified against the live API (EU) on 2026-09-30.
+ */
+export * from "./shared.js";
+// Game Data APIs
+export { auctions } from "../wow/game_data/auction_house.js";
+export { mythicKeystonePeriod, mythicKeystonePeriods, mythicKeystoneSeason, mythicKeystoneSeasons, } from "../wow/game_data/mythic_keystone_dungeon.js";
+export { mythicKeystoneLeaderboard, mythicKeystoneLeaderboards } from "../wow/game_data/mythic_keystone_leaderboard.js";
+export { playableSpecialization, playableSpecializationMedia, playableSpecializations, } from "../wow/game_data/playable_specialization.js";
+export { pvpSeason, pvpSeasonLeaderboard, pvpSeasonLeaderboards, pvpSeasonRewards, pvpSeasons, } from "../wow/game_data/pvp_season.js";
+export { token } from "../wow/game_data/token.js";
+// Profile APIs
+export { characterAchievementStatistics } from "../wow/profile/character_achievements.js";
+export { characterPvpBracketStatistics } from "../wow/profile/character_pvp.js";
+export { characterAchievementSummary, characterSpecializations, commodities } from "./profile_overrides.js";

package/esm/src/wow_classic/profile_overrides.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Classic versions of Retail endpoints whose Classic responses lack fields that Retail always returns.
+ * Each one makes the same request as the Retail endpoint, but returns a type where those fields are optional,
+ * so the Retail types can keep them required.
+ * Verified against the live API (EU) on 2026-10-01.
+ */
+import type { ApiContext } from "../shared/index.js";
+import type { AchievementCategories } from "../wow/game_data/achievement.js";
+import type { Commodities } from "../wow/game_data/auction_house.js";
+import type { ConnectedRealm } from "../wow/game_data/connected_realm.js";
+import type { CharacterAchievementSummary } from "../wow/profile/character_achievements.js";
+import type { CharacterAppearanceSummary } from "../wow/profile/character_appearance.js";
+import type { CharacterProfile } from "../wow/profile/character_profile.js";
+import type { CharacterPvpSummary } from "../wow/profile/character_pvp.js";
+import type { CharacterSpecializations } from "../wow/profile/character_specializations.js";
+import type { CharacterStatistics } from "../wow/profile/character_statistics.js";
+import type { GuildAchievements } from "../wow/profile/guild.js";
+/** Makes the keys K of T optional. */
+type WithOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/** Character profile as returned for Classic: Retail-only links and fields are optional. */
+export interface ClassicCharacterProfile extends WithOptional<CharacterProfile, "active_spec" | "achievement_points" | "achievements" | "encounters" | "mythic_keystone_profile" | "collections" | "quests" | "achievements_statistics" | "professions" | "name_search" | "is_remix"> {
+}
+/** Character appearance as returned for Classic (no active specialization on Era). */
+export interface ClassicCharacterAppearanceSummary extends WithOptional<CharacterAppearanceSummary, "active_spec"> {
+}
+/** Character PvP summary as returned for Classic (no honor level). */
+export interface ClassicCharacterPvpSummary extends WithOptional<CharacterPvpSummary, "honor_level"> {
+}
+/** Character achievement summary as returned for Classic (no statistics link). */
+export interface ClassicCharacterAchievementSummary extends WithOptional<CharacterAchievementSummary, "statistics"> {
+}
+/** Character statistics as returned for Classic: Retail-only secondary stats are optional. */
+export interface ClassicCharacterStatistics extends WithOptional<CharacterStatistics, "speed" | "melee_haste" | "mastery" | "bonus_armor" | "lifesteal" | "versatility" | "versatility_damage_done_bonus" | "versatility_healing_done_bonus" | "versatility_damage_taken_bonus" | "avoidance" | "ranged_haste" | "spell_haste"> {
+}
+/** Character specializations as returned for Classic progression (talent groups instead of loadouts). */
+export interface ClassicCharacterSpecializations extends WithOptional<CharacterSpecializations, "specializations"> {
+}
+/** Guild achievements as returned for Classic (totals and achievements may be missing). */
+export interface ClassicGuildAchievements extends WithOptional<GuildAchievements, "total_quantity" | "total_points" | "achievements"> {
+}
+/** Connected realm as returned for Classic (no mythic leaderboards link). */
+export interface ClassicConnectedRealm extends WithOptional<ConnectedRealm, "mythic_leaderboards"> {
+}
+/** Achievement categories as returned for Classic (no guild categories on Era). */
+export interface ClassicAchievementCategories extends WithOptional<AchievementCategories, "guild_categories"> {
+}
+/** Commodities as returned for Classic (the auctions list can be missing). */
+export interface ClassicCommodities extends WithOptional<Commodities, "auctions"> {
+}
+/**
+ * Returns a profile summary for a character.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param characterName - The lowercase name of the character.
+ * @returns A promise that resolves to an object representing a profile summary for a character.
+ */
+export declare function characterProfile(ctx: ApiContext, realmSlug: string, characterName: string): Promise<ClassicCharacterProfile>;
+/**
+ * Returns a summary of a character's appearance settings.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param characterName - The lowercase name of the character.
+ * @returns A promise that resolves to an object representing a summary of a character's appearance settings.
+ */
+export declare function characterAppearanceSummary(ctx: ApiContext, realmSlug: string, characterName: string): Promise<ClassicCharacterAppearanceSummary>;
+/**
+ * Returns a PvP summary for a character.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param characterName - The lowercase name of the character.
+ * @returns A promise that resolves to an object representing a PvP summary for a character.
+ */
+export declare function characterPvpSummary(ctx: ApiContext, realmSlug: string, characterName: string): Promise<ClassicCharacterPvpSummary>;
+/**
+ * Returns a summary of the achievements a character has completed.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param characterName - The lowercase name of the character.
+ * @returns A promise that resolves to an object representing a summary of the achievements a character has completed.
+ */
+export declare function characterAchievementSummary(ctx: ApiContext, realmSlug: string, characterName: string): Promise<ClassicCharacterAchievementSummary>;
+/**
+ * Returns a statistics summary for a character.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param characterName - The lowercase name of the character.
+ * @returns A promise that resolves to an object representing a statistics summary for a character.
+ */
+export declare function characterStatistics(ctx: ApiContext, realmSlug: string, characterName: string): Promise<ClassicCharacterStatistics>;
+/**
+ * Returns a summary of a character's specializations.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param characterName - The lowercase name of the character.
+ * @returns A promise that resolves to an object representing a summary of a character's specializations.
+ */
+export declare function characterSpecializations(ctx: ApiContext, realmSlug: string, characterName: string): Promise<ClassicCharacterSpecializations>;
+/**
+ * Returns a single guild's achievements by name.
+ *
+ * @param realmSlug - The slug of the realm.
+ * @param nameSlug - The slug of the guild.
+ * @returns A promise that resolves to an object representing a guild's achievements.
+ */
+export declare function guildAchievements(ctx: ApiContext, realmSlug: string, nameSlug: string): Promise<ClassicGuildAchievements>;
+/**
+ * Returns a connected realm by ID.
+ *
+ * @param connectedRealmId - The ID of the connected realm.
+ * @returns A promise that resolves to an object representing details about a connected realm.
+ */
+export declare function connectedRealm(ctx: ApiContext, connectedRealmId: number): Promise<ClassicConnectedRealm>;
+/**
+ * Returns an index of achievement categories.
+ *
+ * @returns A promise that resolves to an object representing a list of the index of achievement categories.
+ */
+export declare function achievementCategories(ctx: ApiContext): Promise<ClassicAchievementCategories>;
+/**
+ * Returns all active auctions for commodity items for the entire game region.
+ *
+ * @returns A promise that resolves to an object representing the region's commodity auctions.
+ */
+export declare function commodities(ctx: ApiContext): Promise<ClassicCommodities>;
+export {};