@pinta365/blizzard_api 0.4.0 → 0.6.0

package/script/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/script/src/wow/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/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/script/src/wow_classic/auction_house.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auctionHouses = auctionHouses;
+exports.auctionHouse = auctionHouse;
+/**
+ * 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.
+ */
+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.
+ */
+async function auctionHouse(ctx, connectedRealmId, auctionHouseId) {
+    return await ctx.request({
+        method: "GET",
+        url: `/data/wow/connected-realm/${connectedRealmId}/auctions/${auctionHouseId}`,
+        namespace: "dynamic",
+    });
+}

package/script/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/script/src/wow_classic/character_specializations.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.characterSpecializations = characterSpecializations;
+/**
+ * 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.
+ */
+async function characterSpecializations(ctx, realmSlug, characterName) {
+    return await ctx.request({
+        method: "GET",
+        url: `/profile/wow/character/${realmSlug}/${characterName}/specializations`,
+        namespace: "profile",
+    });
+}

package/script/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/script/src/wow_classic/era.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.characterSpecializations = exports.auctionHouses = exports.auctionHouse = void 0;
+__exportStar(require("./shared.js"), exports);
+// Game Data APIs
+var auction_house_js_1 = require("./auction_house.js");
+Object.defineProperty(exports, "auctionHouse", { enumerable: true, get: function () { return auction_house_js_1.auctionHouse; } });
+Object.defineProperty(exports, "auctionHouses", { enumerable: true, get: function () { return auction_house_js_1.auctionHouses; } });
+// Profile APIs
+var character_specializations_js_1 = require("./character_specializations.js");
+Object.defineProperty(exports, "characterSpecializations", { enumerable: true, get: function () { return character_specializations_js_1.characterSpecializations; } });

package/script/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/script/src/wow_classic/index.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commodities = exports.characterSpecializations = exports.characterAchievementSummary = exports.characterPvpBracketStatistics = exports.characterAchievementStatistics = exports.token = exports.pvpSeasons = exports.pvpSeasonRewards = exports.pvpSeasonLeaderboards = exports.pvpSeasonLeaderboard = exports.pvpSeason = exports.playableSpecializations = exports.playableSpecializationMedia = exports.playableSpecialization = exports.mythicKeystoneLeaderboards = exports.mythicKeystoneLeaderboard = exports.mythicKeystoneSeasons = exports.mythicKeystoneSeason = exports.mythicKeystonePeriods = exports.mythicKeystonePeriod = exports.auctions = void 0;
+__exportStar(require("./shared.js"), exports);
+// Game Data APIs
+var auction_house_js_1 = require("../wow/game_data/auction_house.js");
+Object.defineProperty(exports, "auctions", { enumerable: true, get: function () { return auction_house_js_1.auctions; } });
+var mythic_keystone_dungeon_js_1 = require("../wow/game_data/mythic_keystone_dungeon.js");
+Object.defineProperty(exports, "mythicKeystonePeriod", { enumerable: true, get: function () { return mythic_keystone_dungeon_js_1.mythicKeystonePeriod; } });
+Object.defineProperty(exports, "mythicKeystonePeriods", { enumerable: true, get: function () { return mythic_keystone_dungeon_js_1.mythicKeystonePeriods; } });
+Object.defineProperty(exports, "mythicKeystoneSeason", { enumerable: true, get: function () { return mythic_keystone_dungeon_js_1.mythicKeystoneSeason; } });
+Object.defineProperty(exports, "mythicKeystoneSeasons", { enumerable: true, get: function () { return mythic_keystone_dungeon_js_1.mythicKeystoneSeasons; } });
+var mythic_keystone_leaderboard_js_1 = require("../wow/game_data/mythic_keystone_leaderboard.js");
+Object.defineProperty(exports, "mythicKeystoneLeaderboard", { enumerable: true, get: function () { return mythic_keystone_leaderboard_js_1.mythicKeystoneLeaderboard; } });
+Object.defineProperty(exports, "mythicKeystoneLeaderboards", { enumerable: true, get: function () { return mythic_keystone_leaderboard_js_1.mythicKeystoneLeaderboards; } });
+var playable_specialization_js_1 = require("../wow/game_data/playable_specialization.js");
+Object.defineProperty(exports, "playableSpecialization", { enumerable: true, get: function () { return playable_specialization_js_1.playableSpecialization; } });
+Object.defineProperty(exports, "playableSpecializationMedia", { enumerable: true, get: function () { return playable_specialization_js_1.playableSpecializationMedia; } });
+Object.defineProperty(exports, "playableSpecializations", { enumerable: true, get: function () { return playable_specialization_js_1.playableSpecializations; } });
+var pvp_season_js_1 = require("../wow/game_data/pvp_season.js");
+Object.defineProperty(exports, "pvpSeason", { enumerable: true, get: function () { return pvp_season_js_1.pvpSeason; } });
+Object.defineProperty(exports, "pvpSeasonLeaderboard", { enumerable: true, get: function () { return pvp_season_js_1.pvpSeasonLeaderboard; } });
+Object.defineProperty(exports, "pvpSeasonLeaderboards", { enumerable: true, get: function () { return pvp_season_js_1.pvpSeasonLeaderboards; } });
+Object.defineProperty(exports, "pvpSeasonRewards", { enumerable: true, get: function () { return pvp_season_js_1.pvpSeasonRewards; } });
+Object.defineProperty(exports, "pvpSeasons", { enumerable: true, get: function () { return pvp_season_js_1.pvpSeasons; } });
+var token_js_1 = require("../wow/game_data/token.js");
+Object.defineProperty(exports, "token", { enumerable: true, get: function () { return token_js_1.token; } });
+// Profile APIs
+var character_achievements_js_1 = require("../wow/profile/character_achievements.js");
+Object.defineProperty(exports, "characterAchievementStatistics", { enumerable: true, get: function () { return character_achievements_js_1.characterAchievementStatistics; } });
+var character_pvp_js_1 = require("../wow/profile/character_pvp.js");
+Object.defineProperty(exports, "characterPvpBracketStatistics", { enumerable: true, get: function () { return character_pvp_js_1.characterPvpBracketStatistics; } });
+var profile_overrides_js_1 = require("./profile_overrides.js");
+Object.defineProperty(exports, "characterAchievementSummary", { enumerable: true, get: function () { return profile_overrides_js_1.characterAchievementSummary; } });
+Object.defineProperty(exports, "characterSpecializations", { enumerable: true, get: function () { return profile_overrides_js_1.characterSpecializations; } });
+Object.defineProperty(exports, "commodities", { enumerable: true, get: function () { return profile_overrides_js_1.commodities; } });

package/script/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 {};

package/script/src/wow_classic/profile_overrides.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.characterProfile = characterProfile;
+exports.characterAppearanceSummary = characterAppearanceSummary;
+exports.characterPvpSummary = characterPvpSummary;
+exports.characterAchievementSummary = characterAchievementSummary;
+exports.characterStatistics = characterStatistics;
+exports.characterSpecializations = characterSpecializations;
+exports.guildAchievements = guildAchievements;
+exports.connectedRealm = connectedRealm;
+exports.achievementCategories = achievementCategories;
+exports.commodities = commodities;
+const achievement_js_1 = require("../wow/game_data/achievement.js");
+const auction_house_js_1 = require("../wow/game_data/auction_house.js");
+const connected_realm_js_1 = require("../wow/game_data/connected_realm.js");
+const character_achievements_js_1 = require("../wow/profile/character_achievements.js");
+const character_appearance_js_1 = require("../wow/profile/character_appearance.js");
+const character_profile_js_1 = require("../wow/profile/character_profile.js");
+const character_pvp_js_1 = require("../wow/profile/character_pvp.js");
+const character_specializations_js_1 = require("../wow/profile/character_specializations.js");
+const character_statistics_js_1 = require("../wow/profile/character_statistics.js");
+const guild_js_1 = require("../wow/profile/guild.js");
+/**
+ * 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.
+ */
+async function characterProfile(ctx, realmSlug, characterName) {
+    return await (0, character_profile_js_1.characterProfile)(ctx, realmSlug, characterName);
+}
+/**
+ * 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.
+ */
+async function characterAppearanceSummary(ctx, realmSlug, characterName) {
+    return await (0, character_appearance_js_1.characterAppearanceSummary)(ctx, realmSlug, characterName);
+}
+/**
+ * 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.
+ */
+async function characterPvpSummary(ctx, realmSlug, characterName) {
+    return await (0, character_pvp_js_1.characterPvpSummary)(ctx, realmSlug, characterName);
+}
+/**
+ * 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.
+ */
+async function characterAchievementSummary(ctx, realmSlug, characterName) {
+    return await (0, character_achievements_js_1.characterAchievementSummary)(ctx, realmSlug, characterName);
+}
+/**
+ * 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.
+ */
+async function characterStatistics(ctx, realmSlug, characterName) {
+    return await (0, character_statistics_js_1.characterStatistics)(ctx, realmSlug, characterName);
+}
+/**
+ * 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.
+ */
+async function characterSpecializations(ctx, realmSlug, characterName) {
+    return await (0, character_specializations_js_1.characterSpecializations)(ctx, realmSlug, characterName);
+}
+/**
+ * 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.
+ */
+async function guildAchievements(ctx, realmSlug, nameSlug) {
+    return await (0, guild_js_1.guildAchievements)(ctx, realmSlug, nameSlug);
+}
+/**
+ * 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.
+ */
+async function connectedRealm(ctx, connectedRealmId) {
+    return await (0, connected_realm_js_1.connectedRealm)(ctx, connectedRealmId);
+}
+/**
+ * Returns an index of achievement categories.
+ *
+ * @returns A promise that resolves to an object representing a list of the index of achievement categories.
+ */
+async function achievementCategories(ctx) {
+    return await (0, achievement_js_1.achievementCategories)(ctx);
+}
+/**
+ * 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.
+ */
+async function commodities(ctx) {
+    return await (0, auction_house_js_1.commodities)(ctx);
+}

package/script/src/wow_classic/shared.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Endpoints that work for both Classic flavors (progression and Era). They are the Retail endpoint functions;
+ * the client binds them to a context whose namespaces carry the "classic" or "classic1x" variant.
+ * Verified against the live API (EU) on 2026-09-30.
+ */
+export { achievement, achievementCategory, achievementMedia, achievements } from "../wow/game_data/achievement.js";
+export { connectedRealms, searchConnectedRealm } from "../wow/game_data/connected_realm.js";
+export { creature, creatureDisplayMedia, creatureFamilies, creatureFamily, creatureFamilyMedia, creatureType, creatureTypes, searchCreature, } from "../wow/game_data/creature.js";
+export { guildCrestBorder, guildCrestEmblem, guildCrests } from "../wow/game_data/guild_crest.js";
+export { item, itemClass, itemClasses, itemMedia, itemSubclass, searchItem } from "../wow/game_data/item.js";
+export { searchMedia } from "../wow/game_data/media_search.js";
+export { playableClass, playableClasses, playableClassMedia } from "../wow/game_data/playable_class.js";
+export { playableRace, playableRaces } from "../wow/game_data/playable_race.js";
+export { powerType, powerTypes } from "../wow/game_data/power_type.js";
+export { realm, realms, searchRealm } from "../wow/game_data/realm.js";
+export { region, regions } from "../wow/game_data/region.js";
+export { characterEquipments } from "../wow/profile/character_equipment.js";
+export { characterHunterPets } from "../wow/profile/character_hunter_pets.js";
+export { characterMedia } from "../wow/profile/character_media.js";
+export { characterProfileStatus } from "../wow/profile/character_profile.js";
+export { characterReputations } from "../wow/profile/character_reputations.js";
+export { guild, guildActivity, guildRoster } from "../wow/profile/guild.js";
+export { achievementCategories, characterAppearanceSummary, characterProfile, characterPvpSummary, characterStatistics, connectedRealm, guildAchievements, } from "./profile_overrides.js";