[WoW] Add support for Character Appearance APIs

.changeset/rare-days-tan.md

@@ -0,0 +1,5 @@
+---
+'@blizzard-api/wow': minor
+---
+
+Add support for Character Appearance APIs

packages/wow/src/character-appearance/character-appearance.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest';
+import { characterAppearanceSummary } from './character-appearance';
+
+describe('characterAppearanceSummary', () => {
+  it('should return the correct ProtectedResource object', () => {
+    const realmSlug = 'test-realm';
+    const characterName = 'test-character';
+    const token = 'test-token';
+
+    const expectedResource = {
+      namespace: 'profile',
+      path: '/profile/wow/character/test-realm/test-character/appearance',
+      token: 'test-token',
+    };
+
+    const result = characterAppearanceSummary(realmSlug, characterName, token);
+
+    expect(result).toEqual(expectedResource);
+  });
+});

packages/wow/src/character-appearance/character-appearance.ts

@@ -0,0 +1,14 @@
+import type { ProtectedResource } from '@blizzard-api/core';
+import type { CharacterAppearanceResponse } from './types';
+
+export function characterAppearanceSummary(
+  realmSlug: string,
+  characterName: string,
+  token: string,
+): ProtectedResource<CharacterAppearanceResponse> {
+  return {
+    namespace: 'profile',
+    path: `/profile/wow/character/${realmSlug}/${characterName.toLowerCase()}/appearance`,
+    token,
+  };
+}

packages/wow/src/character-appearance/types.ts

@@ -0,0 +1,55 @@
+import type { Color, Faction, Gender, Href, KeyBase, NameId, NameIdKey } from '../base';
+
+export interface CharacterAppearanceResponse {
+  _links: { self: Href };
+  active_spec: NameIdKey;
+  character: Character;
+  customizations: Array<Customization>;
+  faction: Faction;
+  gender: Gender;
+  guild_crest: GuildCrest;
+  items: Array<Item>;
+  playable_class: NameIdKey;
+  playable_race: NameIdKey;
+}
+
+interface Character extends NameIdKey {
+  realm: { slug: string } & NameIdKey;
+}
+
+interface Customization {
+  choice: Choice;
+  option: NameId;
+}
+
+interface Choice {
+  display_order: number;
+  id: number;
+  name?: string;
+}
+
+interface GuildCrest {
+  background: { color: RGBWithId };
+  border: BorderEmblem;
+  emblem: BorderEmblem;
+}
+
+interface RGBWithId {
+  id: number;
+  rgba: Color;
+}
+
+interface BorderEmblem {
+  color: RGBWithId;
+  id: number;
+  media: { id: number } & KeyBase;
+}
+
+interface Item {
+  enchant: number;
+  id: number;
+  internal_slot_id: number;
+  item_appearance_modifier_id: number;
+  slot: { name: string; type: string };
+  subclass: number;
+}

packages/wow/src/index.ts

@@ -26,6 +26,7 @@ import {
   characterAchievementsSummary,
   characterAchievementStatistics,
 } from './character-achievements/character-achievements';
+import { characterAppearanceSummary } from './character-appearance/character-appearance';
 import { connectedRealm, connectedRealmIndex, connectedRealmSearch } from './connected-realm/connected-realm';
 import {
   conduit,
@@ -184,6 +185,8 @@ export const wow = {
   //Character Achievements
   characterAchievementsSummary,
   characterAchievementStatistics,
+  //Character Appearance
+  characterAppearanceSummary,
   //Connected Realm
   connectedRealm,
   connectedRealmIndex,
@@ -362,6 +365,9 @@ export * from './azerite-essence/types';
 //Character Achievements
 export * from './character-achievements/character-achievements';
 export * from './character-achievements/types';
+//Character Appearance
+export * from './character-appearance/character-appearance';
+export * from './character-appearance/types';
 //Connected Realm
 export * from './connected-realm/connected-realm';
 export * from './connected-realm/types';