guildwars2-ts 1.1.6 → 1.2.1

package/dist/index.mjs

@@ -125,8 +125,7 @@ var ApiBase = class {
     const headers = new 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 = {
@@ -221,8 +220,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;
@@ -433,6 +431,19 @@ var AccountHomeCatsDTO = z.array(
   /** Ids of cat unlocked in home instance. */
   z.number()
 );
+var AccountHomesteadDecorationsDTO = z.array(
+  z.object({
+    /** Deocration id. */
+    id: z.number(),
+    /** Decoration count. */
+    count: z.number()
+  })
+);
+var stringArrayType = z.array(z.string());
+var numberArrayType = z.array(z.number());
+
+// src/models/account/account.homestead.glyphs.dto.ts
+var AccountHomesteadGlyphsDTO = stringArrayType;
 var AccountInventoryDTO = z.array(
   z.union([
     z.null(),
@@ -1832,6 +1843,42 @@ var HomeCatsDTO = z.array(
     hint: z.string().optional()
   })
 );
+var HomesteadDecorationsDTO = z.array(
+  z.object({
+    /** The decoration id. */
+    id: z.number(),
+    /* The name of the decoration. */
+    name: z.string(),
+    /** The homestead decoration description. */
+    description: z.string(),
+    /** The maximum amount of storable instances of this decoration. */
+    max_count: z.number(),
+    /** A URL pointing to an icon for the decoration. */
+    icon: z.string(),
+    /** An array of decoration category ids which this decoration belongs to.
+     * Can be compared to the v2/homestead/decorations/categories endpoint */
+    categories: z.array(z.number())
+  })
+);
+var HomesteadDecorationsCategoriesDTO = z.array(
+  z.object({
+    /** The category's ID. */
+    id: z.number(),
+    /** The category name. */
+    name: z.string()
+  })
+);
+var HomesteadGlyphsDTO = z.array(
+  z.object({
+    /** The homestead glyph id. */
+    id: z.string(),
+    /** The id of the glyph item.
+     * Can be compared to the /v2/items endpoint. */
+    item_id: z.number(),
+    /** The slot it is attached to. */
+    slot: z.enum(["harvesting", "mining", "logging"])
+  })
+);
 var BuildDTO = z.object({
   /** The id of the current game build. */
   id: z.number()
@@ -4071,6 +4118,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
@@ -4486,6 +4541,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",
@@ -5022,6 +5103,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
@@ -5256,8 +5357,6 @@ var AccountApi = class extends ApiBase {
     );
   }
 };
-var stringArrayType = z.array(z.string());
-var numberArrayType = z.array(z.number());
 
 // src/apis/achievements/achievements.ts
 var AchievementsApi = class extends ApiBase {
@@ -5727,6 +5826,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) {
@@ -5763,8 +5900,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);
   }
 };
@@ -5843,8 +5979,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);
   }
 };
@@ -5867,8 +6002,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);
   }
 };
@@ -5876,8 +6010,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);
   }
 };
@@ -5885,8 +6018,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);
   }
 };
@@ -5894,8 +6026,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);
   }
 };
@@ -5903,8 +6034,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);
   }
 };
@@ -5912,8 +6042,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);
   }
 };
@@ -5934,8 +6063,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);
   }
 };
@@ -5967,8 +6095,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);
   }
 };
@@ -5976,8 +6103,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);
   }
 };
@@ -5985,8 +6111,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);
   }
 };
@@ -5994,8 +6119,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);
   }
 };
@@ -6017,8 +6141,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);
   }
 };
@@ -6026,8 +6149,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);
   }
 };
@@ -6035,8 +6157,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);
   }
 };
@@ -6053,8 +6174,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);
   }
 };
@@ -6062,8 +6182,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);
   }
 };
@@ -6071,8 +6190,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);
   }
 };
@@ -6080,8 +6198,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);
   }
 };
@@ -6089,8 +6206,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);
   }
   /**
@@ -6111,8 +6227,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);
   }
 };
@@ -6132,8 +6247,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);
   }
 };
@@ -6154,8 +6268,7 @@ var storiesCore = z.array(z.number());
 var seasonsCore = z.array(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) {
@@ -6212,8 +6325,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);
   }
 };
@@ -6231,8 +6343,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);
   }
 };
@@ -6250,8 +6361,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);
   }
 };
@@ -6264,23 +6374,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) {
@@ -6406,8 +6512,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) {
@@ -6455,6 +6560,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 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "guildwars2-ts",
-  "version": "1.1.6",
+  "version": "1.2.1",
   "description": "GuildWars 2 API Wrapper in Typescript",
   "homepage": "https://gitlab.com/dinckelman/guildwars2-ts",
   "main": "dist/index.js",
@@ -22,10 +22,10 @@
     "gw2"
   ],
   "dependencies": {
-    "axios": "1.6.8",
+    "axios": "1.7.5",
     "promise-queue": "2.2.5",
-    "tslog": "4.9.2",
-    "zod": "3.22.4"
+    "tslog": "4.9.3",
+    "zod": "3.23.8"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.6.3",
@@ -40,7 +40,7 @@
   },
   "scripts": {
     "lint:dry": "biome check .",
-    "lint": "biome check . --apply",
+    "lint": "biome check . --write",
     "build": "tsup --env.NODE_ENV production",
     "test": "jest",
     "test:coverage": "jest --coverage"