guildwars2-ts 1.1.1 → 1.1.4

package/dist/index.js

@@ -70,13 +70,10 @@ var ApiTimeoutError = class _ApiTimeoutError extends Error {
   }
 };
 var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
-  LogLevel2[LogLevel2["silly"] = 0] = "silly";
-  LogLevel2[LogLevel2["trace"] = 1] = "trace";
-  LogLevel2[LogLevel2["debug"] = 2] = "debug";
-  LogLevel2[LogLevel2["info"] = 3] = "info";
-  LogLevel2[LogLevel2["warn"] = 4] = "warn";
   LogLevel2[LogLevel2["error"] = 5] = "error";
-  LogLevel2[LogLevel2["fatal"] = 6] = "fatal";
+  LogLevel2[LogLevel2["warn"] = 4] = "warn";
+  LogLevel2[LogLevel2["info"] = 3] = "info";
+  LogLevel2[LogLevel2["debug"] = 2] = "debug";
   return LogLevel2;
 })(LogLevel || {});
 var logger = new tslog.Logger({
@@ -109,8 +106,7 @@ var ApiBase = class {
   constructor(apiParams) {
     this._apiToken = apiParams?.token;
     this._language = apiParams?.language ?? "en" /* English */;
-    this._rateLimitRetry = apiParams?.rateLimit?.retry ?? true;
-    this._rateLimitRetryAttempts = apiParams?.rateLimit?.retry ? apiParams.rateLimit.attempts : 0;
+    this._rateLimitRetry = apiParams?.rateLimitRetry ?? true;
   }
   /**
    * Parameters for the api response, at top level
@@ -119,10 +115,7 @@ var ApiBase = class {
     return {
       token: this._apiToken,
       language: this._language,
-      rateLimit: {
-        retry: this._rateLimitRetry,
-        attempts: this._rateLimitRetryAttempts
-      }
+      rateLimitRetry: this._rateLimitRetry
     };
   }
   /**
@@ -131,8 +124,9 @@ var ApiBase = class {
    * @param endpoint - API Endpoint
    * @param apiParams - Query string
    * @param responseType - Type of the response
+   * @param attempts - Previously failed retry count
    */
-  async buildRequest(endpoint, apiParams, responseType) {
+  async buildRequest(endpoint, apiParams, responseType, attempts) {
     const { tokenRequired } = endpoint;
     const url = this._getApiUrl(endpoint, apiParams);
     const headers = new axios.AxiosHeaders();
@@ -154,14 +148,14 @@ var ApiBase = class {
       const parse = responseType.safeParse(data);
       if (!parse.success) {
         logger.warn(
-          "The requested data failed to parse, when using the known schema. Data is still returned, but may be incorrectly typed"
+          "The requested data failed to parse, when using the known schema. Data is still returned, but may be incorrectly typed. Please submit the following log to the developers:"
         );
-        logger.warn("Please submit the following log to the developers:");
         logger.warn(parse.error.errors);
       }
+      logger.info(`[200] Successful request to ${endpoint.path}`);
       return data;
     } catch (error) {
-      return await this.retryRequest(endpoint, options, responseType, apiParams, 0, error);
+      return await this.retryRequest(endpoint, options, responseType, apiParams, attempts ?? 0, error);
     }
   }
   /**
@@ -174,48 +168,49 @@ var ApiBase = class {
    * @param rateLimitAttempt - Current rate-limit retry counter
    * @param prevError - Error that caused a retry
    */
-  async retryRequest(endpoint, prevOptions, responseType, apiParams, rateLimitAttempt = 0, prevError) {
+  async retryRequest(endpoint, prevOptions, responseType, apiParams, rateLimitAttempt, prevError) {
     if (prevError instanceof axios.AxiosError && prevError.response) {
       const { status } = prevError.response;
       switch (true) {
         case status === 401: {
-          logger.warn(`Request to ${prevOptions.url} failed.`);
+          logger.warn(
+            // biome-ignore lint/style/noNonNullAssertion: <This will always be present>
+            `[401] Failed request to ${prevOptions.url}. Failed to authorize with the provided token.`
+          );
           throw new ApiTokenError();
         }
         case status === 403: {
           const requiredScope = prevError.response.data.text.slice(0, 1).toUpperCase() + prevError.response.data.text.slice(1);
-          logger.warn(`Request to ${prevOptions.url} failed. ${requiredScope}.`);
+          logger.warn(`[403] Failed request to ${prevOptions.url}. ${requiredScope}.`);
           throw new ApiPermissionsError(requiredScope);
         }
         case status === 404: {
-          logger.warn(`Request to ${prevOptions.url} returned no data.`);
+          logger.warn(`[404] Failed request to ${prevOptions.url}. No data was returned.`);
           throw new ApiNotFoundError();
         }
-        case (status === 429 && this._rateLimitRetry): {
-          logger.warn("Rate-limit has been reached. Request will be repeated soon.");
-          if (rateLimitAttempt < 3) {
-            setTimeout(async () => {
-              return await this.retryRequest(
-                endpoint,
-                prevOptions,
-                responseType,
-                apiParams,
-                rateLimitAttempt++,
-                prevError
-              );
-            }, 1e3);
-            break;
-          } else {
-            logger.error(`Rate-limit retries failed. Aborting request to ${prevOptions.url}`);
+        case status === 429: {
+          if (!this._rateLimitRetry) {
+            logger.warn("[429] Rate-limit has been reached, but retries were turned off. Stopping here.");
             throw new ApiRetryFailedError();
           }
+          if (rateLimitAttempt < 3) {
+            logger.warn(
+              // biome-ignore lint/style/noNonNullAssertion: <This will always be present>
+              `[429] Rate-limit has been reached. Request to ${prevOptions.url} will be repeated in 30 seconds.`
+            );
+            await new Promise((resolve) => setTimeout(() => resolve(), 3e4));
+            return await this.buildRequest(endpoint, apiParams, responseType, ++rateLimitAttempt);
+          }
+          logger.error(`[429] Rate-limit retries failed. Aborting request to ${prevOptions.url}`);
+          throw new ApiRetryFailedError();
         }
         case status === 504: {
-          logger.warn(`Request to ${prevOptions.url} timed out.`);
+          logger.warn(`[504] Request to ${prevOptions.url} timed out.`);
           throw new ApiTimeoutError();
         }
         default:
-          logger.warn(`Request to ${prevOptions.url} failed. ${prevError.message}`);
+          logger.warn(`[???] Request to ${prevOptions.url} failed. ${prevError.message}`);
+          throw new ApiGenericError();
       }
     }
     throw new ApiGenericError();
@@ -592,6 +587,107 @@ var AccountWalletDTO = zod.z.array(
     value: zod.z.number()
   })
 );
+var AccountWizardsVaultDailyDTO = zod.z.object({
+  /** The current progress to the meta achievement for the daily. */
+  meta_progress_current: zod.z.number(),
+  /** The threshold for the meta progress to be 'complete', and the meta reward claimable. */
+  meta_progress_complete: zod.z.number(),
+  /** The ID of the item you receive for claiming the meta reward */
+  meta_reward_item_id: zod.z.number(),
+  /** The amount of Astral Acclaim you receive for claiming the meta reward */
+  meta_reward_astral: zod.z.number(),
+  /** Whether the account has claimed the meta reward. */
+  meta_reward_claimed: zod.z.boolean(),
+  /** An array of objects detailing each daily objective */
+  objectives: zod.z.array(
+    zod.z.object({
+      /** The ID of the objective. */
+      id: zod.z.number(),
+      /** The title of the objective. */
+      title: zod.z.string(),
+      /** The reward track containing the objective. */
+      track: zod.z.string(),
+      /** The astral acclaim awarded for the objective. */
+      acclaim: zod.z.number(),
+      /** The current progress of the objective. */
+      progress_current: zod.z.number(),
+      /** The progress status of the objective. */
+      progress_complete: zod.z.number(),
+      /** The claim status of the objective. */
+      claimed: zod.z.boolean()
+    })
+  )
+});
+var AccountWizardsVaultListingsDTO = zod.z.array(
+  zod.z.object({
+    /** The listing id. */
+    id: zod.z.number(),
+    /** The id of the item */
+    item_id: zod.z.number(),
+    /** The quantity of the item the user receives */
+    item_count: zod.z.number(),
+    /** Appears to be the position in the wizards vault UI. */
+    type: zod.z.enum(["Featured", "Normal", "Legacy"]),
+    /** The quantity of Astral Acclaim to purchase . */
+    cost: zod.z.number(),
+    /** Amount of the item already purchased. Not included if the reward is unlimited. */
+    purchased: zod.z.number().optional(),
+    /** Maximum amount that can be purchased. Not included if the reward is unlimited. */
+    purchase_limit: zod.z.number().optional()
+  })
+);
+var AccountWizardsVaultSpecialDTO = zod.z.object({
+  /** An array of objects detailing each weekly objective */
+  objectives: zod.z.array(
+    zod.z.object({
+      /** The ID of the objective. */
+      id: zod.z.number(),
+      /** The title of the objective. */
+      title: zod.z.string(),
+      /** The reward track containing the objective. */
+      track: zod.z.string(),
+      /** The astral acclaim awarded for the objective. */
+      acclaim: zod.z.number(),
+      /** The current progress of the objective. */
+      progress_current: zod.z.number(),
+      /** The progress status of the objective. */
+      progress_complete: zod.z.number(),
+      /** The claim status of the objective. */
+      claimed: zod.z.boolean()
+    })
+  )
+});
+var AccountWizardsVaultWeeklyDTO = zod.z.object({
+  /** The current progress to the meta achievement for the weekly. */
+  meta_progress_current: zod.z.number(),
+  /** The threshold for the meta progress to be 'complete', and the meta reward claimable. */
+  meta_progress_complete: zod.z.number(),
+  /** The ID of the item you receive for claiming the meta reward */
+  meta_reward_item_id: zod.z.number(),
+  /** The amount of Astral Acclaim you receive for claiming the meta reward */
+  meta_reward_astral: zod.z.number(),
+  /** Whether the account has claimed the meta reward. */
+  meta_reward_claimed: zod.z.boolean(),
+  /** An array of objects detailing each weekly objective */
+  objectives: zod.z.array(
+    zod.z.object({
+      /** The ID of the objective. */
+      id: zod.z.number(),
+      /** The title of the objective. */
+      title: zod.z.string(),
+      /** The reward track containing the objective. */
+      track: zod.z.string(),
+      /** The astral acclaim awarded for the objective. */
+      acclaim: zod.z.number(),
+      /** The current progress of the objective. */
+      progress_current: zod.z.number(),
+      /** The progress status of the objective. */
+      progress_complete: zod.z.number(),
+      /** The claim status of the objective. */
+      claimed: zod.z.boolean()
+    })
+  )
+});
 var AccountWorldBossesDTO = zod.z.array(
   /** Name of the world boss. */
   zod.z.string()
@@ -1783,7 +1879,7 @@ var ColorsDTO = zod.z.array(
     /** ID of the dye item. */
     item: zod.z.number().optional(),
     /** Color categories. */
-    categories: zod.z.tuple([Hue, Material, Rarity]).optional()
+    categories: zod.z.tuple([Hue, Material, Rarity]).or(zod.z.array(zod.z.undefined()).length(0))
   })
 );
 var EmblemDTO = zod.z.array(
@@ -3643,6 +3739,44 @@ var StoriesSeasonsDTO = zod.z.array(
     stories: zod.z.array(zod.z.number())
   })
 );
+var WizardsVaultDTO = zod.z.object({
+  /** The name of the current season. */
+  title: zod.z.string(),
+  /** The date that the current season begins. */
+  start: zod.z.string(),
+  /** The date that the current season ends. */
+  end: zod.z.string(),
+  /** The wizard's vault listing ids available (use the sub endpoint to view item details). */
+  listings: zod.z.array(zod.z.number()),
+  /** The wizard's vault objective ids available (use the sub endpoint to view item details). */
+  objectives: zod.z.array(zod.z.number())
+});
+var WizardsVaultListingsDTO = zod.z.array(
+  zod.z.object({
+    /** The listing id. */
+    id: zod.z.number(),
+    /** The id of the item */
+    item_id: zod.z.number(),
+    /** The quantity of the item the user receives */
+    item_count: zod.z.number(),
+    /** Appears to be the position in the wizards vault UI. */
+    type: zod.z.enum(["Featured", "Normal", "Legacy"]),
+    /** The quantity of Astral Acclaim to purchase . */
+    cost: zod.z.number()
+  })
+);
+var WizardsVaultObjectivesDTO = zod.z.array(
+  zod.z.object({
+    /** The ID of the objective. */
+    id: zod.z.number(),
+    /** The title of the objective. */
+    title: zod.z.string(),
+    /** The reward track containing the objective. */
+    track: zod.z.enum(["PvP", "WvW", "PvE"]),
+    /** The amount of astral acclaim awarded. */
+    acclaim: zod.z.number()
+  })
+);
 var WvWAbilitiesDTO = zod.z.array(
   zod.z.object({
     /** The id of the abilities.*/
@@ -4032,6 +4166,22 @@ var endpoints = {
       path: "v2/account/wallet",
       tokenRequired: true
     },
+    wizardsVaultDaily: {
+      path: "v2/account/wizardsvault/daily",
+      tokenRequired: true
+    },
+    wizardsVaultListings: {
+      path: "v2/account/wizardsvault/listings",
+      tokenRequired: true
+    },
+    wizardsVaultSpecial: {
+      path: "v2/account/wizardsvault/special",
+      tokenRequired: true
+    },
+    wizardsVaultWeekly: {
+      path: "v2/account/wizardsvault/weekly",
+      tokenRequired: true
+    },
     worldBosses: {
       path: "v2/account/worldbosses",
       tokenRequired: true
@@ -4700,6 +4850,28 @@ var endpoints = {
       tokenRequired: false
     }
   },
+  wizardsVault: {
+    root: {
+      path: "v2/wizardsvault",
+      tokenRequired: false
+    },
+    listingsAll: {
+      path: "v2/wizardsvault/listings",
+      tokenRequired: false
+    },
+    listingsById: {
+      path: "v2/wizardsvault/listings?ids=$(ids)",
+      tokenRequired: false
+    },
+    objectivesAll: {
+      path: "v2/wizardsvault/objectives",
+      tokenRequired: false
+    },
+    objectivesById: {
+      path: "v2/wizardsvault/objectives?ids=$(ids)",
+      tokenRequired: false
+    }
+  },
   worldBosses: {
     path: "v2/worldbosses",
     tokenRequired: false
@@ -5040,6 +5212,46 @@ var AccountApi = class extends ApiBase {
   async getWallet() {
     return await this.buildRequest(endpoints.account.wallet, {}, AccountWalletDTO);
   }
+  /**
+   * Returns the current set of daily Wizard's Vault achievements for the account.
+   */
+  async getWizardsVaultDaily() {
+    return await this.buildRequest(
+      endpoints.account.wizardsVaultDaily,
+      {},
+      AccountWizardsVaultDailyDTO
+    );
+  }
+  /**
+   * Returns the current set of Wizard's Vault rewards, along with details about which have already been purchased by the account, and in what quantity.
+   */
+  async getWizardsVaultListings() {
+    return await this.buildRequest(
+      endpoints.account.wizardsVaultListings,
+      {},
+      AccountWizardsVaultListingsDTO
+    );
+  }
+  /**
+   * Returns the current set of special Wizard's Vault achievements for the account.
+   */
+  async getWizardsVaultSpecial() {
+    return await this.buildRequest(
+      endpoints.account.wizardsVaultSpecial,
+      {},
+      AccountWizardsVaultSpecialDTO
+    );
+  }
+  /**
+   * Returns the current set of weekly Wizard's Vault achievements for the account.
+   */
+  async getWizardsVaultWeekly() {
+    return await this.buildRequest(
+      endpoints.account.wizardsVaultWeekly,
+      {},
+      AccountWizardsVaultWeeklyDTO
+    );
+  }
   /**
    * Returns information about which world bosses have been killed by the account since daily-reset.
    */
@@ -6105,6 +6317,38 @@ var PvPApi = class extends ApiBase {
   }
 };
 
+// src/apis/wizardsvault/wizardsvault.ts
+var WizardsVaultApi = class extends ApiBase {
+  /**
+   * Returns information about the current Wizard's Vault season.
+   */
+  async get() {
+    return await this.buildRequest(endpoints.wizardsVault.root, {}, WizardsVaultDTO);
+  }
+  async getListings(ids) {
+    if (ids)
+      return await this.buildRequest(
+        endpoints.wizardsVault.listingsById,
+        { ids },
+        WizardsVaultListingsDTO
+      );
+    return await this.buildRequest(endpoints.wizardsVault.listingsAll, {}, numberArrayType);
+  }
+  async getObjectives(ids) {
+    if (ids)
+      return await this.buildRequest(
+        endpoints.wizardsVault.objectivesById,
+        { ids },
+        WizardsVaultObjectivesDTO
+      );
+    return await this.buildRequest(
+      endpoints.wizardsVault.objectivesAll,
+      {},
+      numberArrayType
+    );
+  }
+};
+
 // src/apis/wvw/wvw.ts
 var WorldVsWorldApi = class extends ApiBase {
   async getAbilities(ids) {
@@ -6280,6 +6524,8 @@ var GW2Api = class extends ApiBase {
   tokenInfo = new TokenInfoApi(this.getParams());
   /** /v2/traits Api */
   traits = new TraitsApi(this.getParams());
+  /** /v2/wizardsvault Api */
+  wizardsVault = new WizardsVaultApi(this.getParams());
   /** /v2/worldbosses Api */
   worldBosses = new WorldBossesApi(this.getParams());
   /** /v2/worlds Api */
@@ -6293,5 +6539,3 @@ exports.GW2Api = GW2Api;
 exports.LogLevel = LogLevel;
 exports.setLogLevel = setLogLevel;
 exports.setPathLogging = setPathLogging;
-//# sourceMappingURL=out.js.map
-//# sourceMappingURL=index.js.map