guildwars2-ts 1.1.5 → 1.2.1

package/dist/index.js

@@ -132,8 +132,7 @@ var ApiBase = class {
     const headers = new axios.AxiosHeaders();
     headers["Accept-Language"] = this._language;
     if (tokenRequired) {
-      if (!this._apiToken)
-        throw new ApiTokenError();
+      if (!this._apiToken) throw new ApiTokenError();
       headers.Authorization = `Bearer ${this._apiToken}`;
     }
     const options = {
@@ -228,8 +227,7 @@ var ApiBase = class {
     let match;
     while (match = regex.exec(fullUrl)) {
       const [key, param] = match;
-      if (!param)
-        continue;
+      if (!param) continue;
       const value = encodeURI(String(urlParams[param]));
       fullUrl = fullUrl.replace(key, value);
       regex.lastIndex = 0;
@@ -440,6 +438,19 @@ var AccountHomeCatsDTO = zod.z.array(
   /** Ids of cat unlocked in home instance. */
   zod.z.number()
 );
+var AccountHomesteadDecorationsDTO = zod.z.array(
+  zod.z.object({
+    /** Deocration id. */
+    id: zod.z.number(),
+    /** Decoration count. */
+    count: zod.z.number()
+  })
+);
+var stringArrayType = zod.z.array(zod.z.string());
+var numberArrayType = zod.z.array(zod.z.number());
+
+// src/models/account/account.homestead.glyphs.dto.ts
+var AccountHomesteadGlyphsDTO = stringArrayType;
 var AccountInventoryDTO = zod.z.array(
   zod.z.union([
     zod.z.null(),
@@ -851,7 +862,7 @@ var CharacterCoreDTO = zod.z.object({
   /** Character level. */
   level: zod.z.number(),
   /** Character guild. */
-  guild: zod.z.string().optional(),
+  guild: zod.z.union([zod.z.string(), zod.z.null()]),
   /** Character age. */
   age: zod.z.number(),
   /** Character creation date. */
@@ -859,7 +870,7 @@ var CharacterCoreDTO = zod.z.object({
   /** Character deaths. */
   deaths: zod.z.number(),
   /** Character title id. */
-  title: zod.z.number()
+  title: zod.z.number().optional()
 });
 var CharacterCraftingDTO = zod.z.object({
   /**
@@ -1839,6 +1850,42 @@ var HomeCatsDTO = zod.z.array(
     hint: zod.z.string().optional()
   })
 );
+var HomesteadDecorationsDTO = zod.z.array(
+  zod.z.object({
+    /** The decoration id. */
+    id: zod.z.number(),
+    /* The name of the decoration. */
+    name: zod.z.string(),
+    /** The homestead decoration description. */
+    description: zod.z.string(),
+    /** The maximum amount of storable instances of this decoration. */
+    max_count: zod.z.number(),
+    /** A URL pointing to an icon for the decoration. */
+    icon: zod.z.string(),
+    /** An array of decoration category ids which this decoration belongs to.
+     * Can be compared to the v2/homestead/decorations/categories endpoint */
+    categories: zod.z.array(zod.z.number())
+  })
+);
+var HomesteadDecorationsCategoriesDTO = zod.z.array(
+  zod.z.object({
+    /** The category's ID. */
+    id: zod.z.number(),
+    /** The category name. */
+    name: zod.z.string()
+  })
+);
+var HomesteadGlyphsDTO = zod.z.array(
+  zod.z.object({
+    /** The homestead glyph id. */
+    id: zod.z.string(),
+    /** The id of the glyph item.
+     * Can be compared to the /v2/items endpoint. */
+    item_id: zod.z.number(),
+    /** The slot it is attached to. */
+    slot: zod.z.enum(["harvesting", "mining", "logging"])
+  })
+);
 var BuildDTO = zod.z.object({
   /** The id of the current game build. */
   id: zod.z.number()
@@ -4078,6 +4125,14 @@ var endpoints = {
       path: "v2/account/home/nodes",
       tokenRequired: true
     },
+    homesteadDecorations: {
+      path: "v2/account/homestead/decorations",
+      tokenRequired: true
+    },
+    homesteadGlyphs: {
+      path: "v2/account/homestead/glyphs",
+      tokenRequired: true
+    },
     inventory: {
       path: "v2/account/inventory",
       tokenRequired: true
@@ -4493,6 +4548,32 @@ var endpoints = {
       tokenRequired: false
     }
   },
+  homestead: {
+    decorationsById: {
+      path: "v2/homestead/decorations?ids=$(ids)",
+      tokenRequired: false
+    },
+    decorationsAll: {
+      path: "v2/homestead/decorations",
+      tokenRequired: false
+    },
+    decorationsCategoriesById: {
+      path: "v2/homestead/decorations/categories?ids=$(ids)",
+      tokenRequired: false
+    },
+    decorationsCategoriesAll: {
+      path: "v2/homestead/decorations/categories",
+      tokenRequired: false
+    },
+    glyphsById: {
+      path: "v2/homestead/glyphs?ids=$(ids)",
+      tokenRequired: false
+    },
+    glyphsAll: {
+      path: "v2/homestead/glyphs",
+      tokenRequired: false
+    }
+  },
   items: {
     all: {
       path: "v2/items",
@@ -5029,6 +5110,26 @@ var AccountApi = class extends ApiBase {
   async getHomeCats() {
     return await this.buildRequest(endpoints.account.homeCats, {}, AccountHomeCatsDTO);
   }
+  /**
+   * Returns information about unlocked homestead decorations.
+   */
+  async getHomesteadDecorations() {
+    return await this.buildRequest(
+      endpoints.account.homesteadDecorations,
+      {},
+      AccountHomesteadDecorationsDTO
+    );
+  }
+  /**
+   * Returns information about glyphs stored in homestead collection boxes.
+   */
+  async getHomesteadGlyphs() {
+    return await this.buildRequest(
+      endpoints.account.homesteadGlyphs,
+      {},
+      AccountHomesteadGlyphsDTO
+    );
+  }
   /**
    * Returns the shared inventory slots in an account.
    * If null, the slot is empty
@@ -5263,8 +5364,6 @@ var AccountApi = class extends ApiBase {
     );
   }
 };
-var stringArrayType = zod.z.array(zod.z.string());
-var numberArrayType = zod.z.array(zod.z.number());
 
 // src/apis/achievements/achievements.ts
 var AchievementsApi = class extends ApiBase {
@@ -5734,6 +5833,44 @@ var HomeApi = class extends ApiBase {
   }
 };
 
+// src/apis/homestead/homestead.ts
+var HomesteadApi = class extends ApiBase {
+  async getDecorations(ids) {
+    if (ids) {
+      return await this.buildRequest(
+        endpoints.homestead.decorationsById,
+        { ids },
+        HomesteadDecorationsDTO
+      );
+    }
+    return await this.buildRequest(endpoints.homestead.decorationsAll, {}, numberArrayType);
+  }
+  async getCategories(ids) {
+    if (ids) {
+      return await this.buildRequest(
+        endpoints.homestead.decorationsCategoriesById,
+        { ids },
+        HomesteadDecorationsCategoriesDTO
+      );
+    }
+    return await this.buildRequest(
+      endpoints.homestead.decorationsCategoriesAll,
+      {},
+      numberArrayType
+    );
+  }
+  async getGlyphs(ids) {
+    if (ids) {
+      return await this.buildRequest(
+        endpoints.homestead.glyphsById,
+        { ids },
+        HomesteadGlyphsDTO
+      );
+    }
+    return await this.buildRequest(endpoints.homestead.glyphsAll, {}, stringArrayType);
+  }
+};
+
 // src/apis/misc/backstory.ts
 var BackstoryApi = class extends ApiBase {
   async getAnswers(ids) {
@@ -5770,8 +5907,7 @@ var BuildApi = class extends ApiBase {
 // src/apis/misc/colors.ts
 var ColorsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.colors.byId, { ids }, ColorsDTO);
+    if (ids) return await this.buildRequest(endpoints.colors.byId, { ids }, ColorsDTO);
     return await this.buildRequest(endpoints.colors.all, {}, numberArrayType);
   }
 };
@@ -5850,8 +5986,7 @@ var DailyCraftingApi = class extends ApiBase {
 // src/apis/misc/dungeons.ts
 var DungeonsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.dungeons.byId, { ids }, DungeonsDTO);
+    if (ids) return await this.buildRequest(endpoints.dungeons.byId, { ids }, DungeonsDTO);
     return await this.buildRequest(endpoints.dungeons.all, {}, stringArrayType);
   }
 };
@@ -5874,8 +6009,7 @@ var EmotesApi = class extends ApiBase {
 // src/apis/misc/files.ts
 var FilesApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.files.byId, { ids }, FilesDTO);
+    if (ids) return await this.buildRequest(endpoints.files.byId, { ids }, FilesDTO);
     return await this.buildRequest(endpoints.files.all, {}, stringArrayType);
   }
 };
@@ -5883,8 +6017,7 @@ var FilesApi = class extends ApiBase {
 // src/apis/misc/finishers.ts
 var FinishersApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.finishers.byId, { ids }, FinishersDTO);
+    if (ids) return await this.buildRequest(endpoints.finishers.byId, { ids }, FinishersDTO);
     return await this.buildRequest(endpoints.finishers.all, {}, numberArrayType);
   }
 };
@@ -5892,8 +6025,7 @@ var FinishersApi = class extends ApiBase {
 // src/apis/misc/gliders.ts
 var GlidersApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.gliders.byId, { ids }, GlidersDTO);
+    if (ids) return await this.buildRequest(endpoints.gliders.byId, { ids }, GlidersDTO);
     return await this.buildRequest(endpoints.gliders.all, {}, numberArrayType);
   }
 };
@@ -5901,8 +6033,7 @@ var GlidersApi = class extends ApiBase {
 // src/apis/misc/items.ts
 var ItemsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.items.byId, { ids }, ItemsDTO);
+    if (ids) return await this.buildRequest(endpoints.items.byId, { ids }, ItemsDTO);
     return await this.buildRequest(endpoints.items.all, {}, numberArrayType);
   }
 };
@@ -5910,8 +6041,7 @@ var ItemsApi = class extends ApiBase {
 // src/apis/misc/itemstats.ts
 var ItemStatsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.itemstats.byId, { ids }, ItemStatsDTO);
+    if (ids) return await this.buildRequest(endpoints.itemstats.byId, { ids }, ItemStatsDTO);
     return await this.buildRequest(endpoints.itemstats.all, {}, numberArrayType);
   }
 };
@@ -5919,8 +6049,7 @@ var ItemStatsApi = class extends ApiBase {
 // src/apis/misc/jadebots.ts
 var JadebotsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.jadebots.byId, { ids }, JadebotsDTO);
+    if (ids) return await this.buildRequest(endpoints.jadebots.byId, { ids }, JadebotsDTO);
     return await this.buildRequest(endpoints.jadebots.all, {}, numberArrayType);
   }
 };
@@ -5941,8 +6070,7 @@ var LegendaryArmoryApi = class extends ApiBase {
 // src/apis/misc/legends.ts
 var LegendsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.legends.byId, { ids }, LegendsDTO);
+    if (ids) return await this.buildRequest(endpoints.legends.byId, { ids }, LegendsDTO);
     return await this.buildRequest(endpoints.legends.all, {}, stringArrayType);
   }
 };
@@ -5974,8 +6102,7 @@ var MapChestsApi = class extends ApiBase {
 // src/apis/misc/maps.ts
 var MapsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.maps.byId, { ids }, MapsDTO);
+    if (ids) return await this.buildRequest(endpoints.maps.byId, { ids }, MapsDTO);
     return await this.buildRequest(endpoints.maps.all, {}, numberArrayType);
   }
 };
@@ -5983,8 +6110,7 @@ var MapsApi = class extends ApiBase {
 // src/apis/misc/masteries.ts
 var MasteriesApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.masteries.byId, { ids }, MasteriesDTO);
+    if (ids) return await this.buildRequest(endpoints.masteries.byId, { ids }, MasteriesDTO);
     return await this.buildRequest(endpoints.masteries.all, {}, numberArrayType);
   }
 };
@@ -5992,8 +6118,7 @@ var MasteriesApi = class extends ApiBase {
 // src/apis/misc/materials.ts
 var MaterialsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.materials.byId, { ids }, MaterialsDTO);
+    if (ids) return await this.buildRequest(endpoints.materials.byId, { ids }, MaterialsDTO);
     return await this.buildRequest(endpoints.materials.all, {}, numberArrayType);
   }
 };
@@ -6001,8 +6126,7 @@ var MaterialsApi = class extends ApiBase {
 // src/apis/misc/minis.ts
 var MinisApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.minis.byId, { ids }, MinisDTO);
+    if (ids) return await this.buildRequest(endpoints.minis.byId, { ids }, MinisDTO);
     return await this.buildRequest(endpoints.minis.all, {}, numberArrayType);
   }
 };
@@ -6024,8 +6148,7 @@ var MountsApi = class extends ApiBase {
 // src/apis/misc/novelties.ts
 var NoveltiesApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.novelties.byId, { ids }, NoveltiesDTO);
+    if (ids) return await this.buildRequest(endpoints.novelties.byId, { ids }, NoveltiesDTO);
     return await this.buildRequest(endpoints.novelties.all, {}, numberArrayType);
   }
 };
@@ -6033,8 +6156,7 @@ var NoveltiesApi = class extends ApiBase {
 // src/apis/misc/outfits.ts
 var OutfitsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.outfits.byId, { ids }, OutfitsDTO);
+    if (ids) return await this.buildRequest(endpoints.outfits.byId, { ids }, OutfitsDTO);
     return await this.buildRequest(endpoints.outfits.all, {}, numberArrayType);
   }
 };
@@ -6042,8 +6164,7 @@ var OutfitsApi = class extends ApiBase {
 // src/apis/misc/pets.ts
 var PetsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.pets.byId, { ids }, PetsDTO);
+    if (ids) return await this.buildRequest(endpoints.pets.byId, { ids }, PetsDTO);
     return await this.buildRequest(endpoints.pets.all, {}, numberArrayType);
   }
 };
@@ -6060,8 +6181,7 @@ var ProfessionsApi = class extends ApiBase {
 // src/apis/misc/quaggans.ts
 var QuaggansApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.quaggans.byId, { ids }, QuaggansDTO);
+    if (ids) return await this.buildRequest(endpoints.quaggans.byId, { ids }, QuaggansDTO);
     return await this.buildRequest(endpoints.quaggans.all, {}, stringArrayType);
   }
 };
@@ -6069,8 +6189,7 @@ var QuaggansApi = class extends ApiBase {
 // src/apis/misc/quests.ts
 var QuestsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.quests.byId, { ids }, QuestsDTO);
+    if (ids) return await this.buildRequest(endpoints.quests.byId, { ids }, QuestsDTO);
     return await this.buildRequest(endpoints.quests.all, {}, numberArrayType);
   }
 };
@@ -6078,8 +6197,7 @@ var QuestsApi = class extends ApiBase {
 // src/apis/misc/races.ts
 var RacesApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.races.byId, { ids }, RacesDTO);
+    if (ids) return await this.buildRequest(endpoints.races.byId, { ids }, RacesDTO);
     return await this.buildRequest(endpoints.races.all, {}, stringArrayType);
   }
 };
@@ -6087,8 +6205,7 @@ var RacesApi = class extends ApiBase {
 // src/apis/misc/raids.ts
 var RaidsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.raids.byId, { ids }, RaidsDTO);
+    if (ids) return await this.buildRequest(endpoints.raids.byId, { ids }, RaidsDTO);
     return await this.buildRequest(endpoints.raids.all, {}, stringArrayType);
   }
 };
@@ -6096,8 +6213,7 @@ var RaidsApi = class extends ApiBase {
 // src/apis/misc/recipes.ts
 var RecipesApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.recipes.byId, { ids }, RecipesDTO);
+    if (ids) return await this.buildRequest(endpoints.recipes.byId, { ids }, RecipesDTO);
     return await this.buildRequest(endpoints.recipes.all, {}, numberArrayType);
   }
   /**
@@ -6118,8 +6234,7 @@ var RecipesApi = class extends ApiBase {
 // src/apis/misc/skiffs.ts
 var SkiffsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.skiffs.byId, { ids }, SkiffsDTO);
+    if (ids) return await this.buildRequest(endpoints.skiffs.byId, { ids }, SkiffsDTO);
     return await this.buildRequest(endpoints.skiffs.all, {}, numberArrayType);
   }
 };
@@ -6139,8 +6254,7 @@ var SkillsApi = class extends ApiBase {
 // src/apis/misc/skins.ts
 var SkinsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.skins.byId, { ids }, SkinsDTO);
+    if (ids) return await this.buildRequest(endpoints.skins.byId, { ids }, SkinsDTO);
     return await this.buildRequest(endpoints.skins.all, {}, numberArrayType);
   }
 };
@@ -6161,8 +6275,7 @@ var storiesCore = zod.z.array(zod.z.number());
 var seasonsCore = zod.z.array(zod.z.string());
 var StoriesApi = class extends ApiBase {
   async getStories(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.stories.byId, { ids }, StoriesDTO);
+    if (ids) return await this.buildRequest(endpoints.stories.byId, { ids }, StoriesDTO);
     return await this.buildRequest(endpoints.stories.all, {}, storiesCore);
   }
   async getSeasons(ids) {
@@ -6219,8 +6332,7 @@ var SubtokenApi = class extends ApiBase {
 // src/apis/misc/titles.ts
 var TitlesApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.titles.byId, { ids }, TitlesDTO);
+    if (ids) return await this.buildRequest(endpoints.titles.byId, { ids }, TitlesDTO);
     return await this.buildRequest(endpoints.titles.all, {}, numberArrayType);
   }
 };
@@ -6238,8 +6350,7 @@ var TokenInfoApi = class extends ApiBase {
 // src/apis/misc/traits.ts
 var TraitsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.traits.byId, { ids }, TraitsDTO);
+    if (ids) return await this.buildRequest(endpoints.traits.byId, { ids }, TraitsDTO);
     return await this.buildRequest(endpoints.traits.all, {}, numberArrayType);
   }
 };
@@ -6257,8 +6368,7 @@ var WorldBossesApi = class extends ApiBase {
 // src/apis/misc/worlds.ts
 var WorldsApi = class extends ApiBase {
   async get(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.worlds.byId, { ids }, WorldsDTO);
+    if (ids) return await this.buildRequest(endpoints.worlds.byId, { ids }, WorldsDTO);
     return await this.buildRequest(endpoints.worlds.all, {}, numberArrayType);
   }
 };
@@ -6271,23 +6381,19 @@ var PvPApi = class extends ApiBase {
     return await this.buildRequest(endpoints.pvp.amuletsAll, {}, numberArrayType);
   }
   async getGames(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.pvp.gamesById, { ids }, PvPGamesDTO);
+    if (ids) return await this.buildRequest(endpoints.pvp.gamesById, { ids }, PvPGamesDTO);
     return await this.buildRequest(endpoints.pvp.gamesAll, {}, stringArrayType);
   }
   async getHeroes(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.pvp.heroesById, { ids }, PvPHeroesDTO);
+    if (ids) return await this.buildRequest(endpoints.pvp.heroesById, { ids }, PvPHeroesDTO);
     return await this.buildRequest(endpoints.pvp.heroesAll, {}, stringArrayType);
   }
   async getRanks(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.pvp.ranksById, { ids }, PvPRanksDTO);
+    if (ids) return await this.buildRequest(endpoints.pvp.ranksById, { ids }, PvPRanksDTO);
     return await this.buildRequest(endpoints.pvp.ranksAll, {}, numberArrayType);
   }
   async getSeasons(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.pvp.seasonsById, { ids }, PvPSeasonDTO);
+    if (ids) return await this.buildRequest(endpoints.pvp.seasonsById, { ids }, PvPSeasonDTO);
     return await this.buildRequest(endpoints.pvp.seasonsAll, {}, stringArrayType);
   }
   async getLeaderboards(id, region, type) {
@@ -6413,8 +6519,7 @@ var WorldVsWorldApi = class extends ApiBase {
     return await this.buildRequest(endpoints.wvw.objectives, {}, stringArrayType);
   }
   async getRanks(ids) {
-    if (ids)
-      return await this.buildRequest(endpoints.wvw.ranksById, { ids }, WvWRanksDTO);
+    if (ids) return await this.buildRequest(endpoints.wvw.ranksById, { ids }, WvWRanksDTO);
     return await this.buildRequest(endpoints.wvw.ranks, {}, numberArrayType);
   }
   async getUpgrades(ids) {
@@ -6462,6 +6567,8 @@ var GW2Api = class extends ApiBase {
   guild = new GuildApi(this.getParams());
   /** /v2/home Api */
   home = new HomeApi(this.getParams());
+  /** /v2/homestead Api */
+  homestead = new HomesteadApi(this.getParams());
   /** /v2/items Api */
   items = new ItemsApi(this.getParams());
   /** /v2/itemstats Api */