Add achievements related endpoints

Add wizard's vault endpoints.

Author: kittywitch

http/tests/account_achievements.rs

@@ -0,0 +1,11 @@
+#![cfg(feature = "blocking")]
+
+use gw2lib::{model::authenticated::account::achievements::AccountAchievements, Requester};
+
+pub mod setup;
+
+#[test]
+fn eff_testing() {
+    let client = setup::setup();
+    let _: AccountAchievements = client.get().unwrap();
+}

http/tests/account_wizards_vault.rs

@@ -0,0 +1,35 @@
+#![cfg(feature = "blocking")]
+
+use gw2lib::{
+    model::authenticated::account::wizards_vault::{
+        daily::WizardsVaultDailies, listings::WizardsVaultListing, special::WizardsVaultSpecials,
+        weekly::WizardsVaultWeeklies,
+    },
+    Requester,
+};
+
+pub mod setup;
+
+#[test]
+fn dailies() {
+    let client = setup::setup();
+    let _: WizardsVaultDailies = client.get().unwrap();
+}
+
+#[test]
+fn listings() {
+    let client = setup::setup();
+    let _: Vec<WizardsVaultListing> = client.all().unwrap();
+}
+
+#[test]
+fn specials() {
+    let client = setup::setup();
+    let _: WizardsVaultSpecials = client.get().unwrap();
+}
+
+#[test]
+fn weeklies() {
+    let client = setup::setup();
+    let _: WizardsVaultWeeklies = client.get().unwrap();
+}

http/tests/achievements.rs

@@ -0,0 +1,34 @@
+#![cfg(feature = "blocking")]
+
+use gw2lib::{
+    model::achievements::{
+        categories::AchievementCategory, groups::AchievementGroup, Achievement,
+    },
+    Requester,
+};
+
+pub mod setup;
+
+#[test]
+fn achievement_single() {
+    let client = setup::setup();
+    let _: Achievement = client.single(739).unwrap();
+}
+
+#[test]
+fn achievements() {
+    let client = setup::setup();
+    let _: Vec<Achievement> = client.all().unwrap();
+}
+
+#[test]
+fn achievement_categories() {
+    let client = setup::setup();
+    let _: Vec<AchievementCategory> = client.all().unwrap();
+}
+
+#[test]
+fn achievement_groups() {
+    let client = setup::setup();
+    let _: Vec<AchievementGroup> = client.all().unwrap();
+}

model/README.md

@@ -20,17 +20,17 @@ You don't even need to fork this library to test your struct!
 
 Example commit adding an endpoint: [bcb0bd3](https://github.com/greaka/gw2lib/commit/bcb0bd3e99f135f54fb01d088714ce8471a56d86)
 
-> Last update: 2024/03/09
+> Last update: 2025/11/03
 
 - achievements
-  - [ ] achievements
-    - [ ] daily
-      - [ ] tomorrow
-    - [ ] groups
-    - [ ] categories
+  - [x] achievements
+    - [ ] daily (deprecated)
+      - [ ] tomorrow (deprecated)
+    - [x] groups
+    - [x] categories
 - authenticated
   - [x] account
-    - [ ] achievements
+    - [x] achievements
     - [x] bank
     - [ ] dailycrafting
     - [ ] dungeons
@@ -61,6 +61,11 @@ Example commit adding an endpoint: [bcb0bd3](https://github.com/greaka/gw2lib/co
     - [ ] skins
     - [ ] titles
     - [x] wallet
+    - wizardsvault
+      - [x] listings
+      - [x] daily
+      - [x] weekly
+      - [x] special
     - [ ] worldbosses
   - characters
     - [x] :id

model/src/achievements/categories.rs

@@ -0,0 +1,69 @@
+use serde::{Deserialize, Serialize};
+
+use crate::{
+    achievements::AchievementId, authenticated::account::Access, BulkEndpoint, Endpoint,
+    EndpointWithId, FixedEndpoint,
+};
+
+pub type AchievementCategoryId = u32;
+pub type AchievementCategoryOrder = u32;
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub enum DailyAchievementType {
+    PvE,
+    PvP,
+    WvW,
+    SpecialEvent,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub enum AchievementAccessCondition {
+    HasAccess,
+    NoAccess,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementAccess {
+    product: Access,
+    condition: AchievementAccessCondition,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementDetails {
+    id: AchievementId,
+    required_access: Option<AchievementAccess>,
+    flags: Option<Vec<DailyAchievementType>>,
+    level: Option<[u8; 2]>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementCategory {
+    id: AchievementCategoryId,
+    name: String,
+    description: String,
+    order: AchievementCategoryOrder,
+    icon: String,
+    achievements: Vec<AchievementDetails>,
+    tomorrow: Option<Vec<AchievementDetails>>,
+}
+
+impl Endpoint for AchievementCategory {
+    const AUTHENTICATED: bool = false;
+    const LOCALE: bool = true;
+    const URL: &'static str = "v2/achievements/categories";
+    const VERSION: &'static str = "2025-08-29T01:00:00.000Z";
+}
+
+impl EndpointWithId for AchievementCategory {
+    type IdType = AchievementCategoryId;
+}
+
+impl FixedEndpoint for AchievementCategory {}
+
+impl BulkEndpoint for AchievementCategory {
+    const ALL: bool = true;
+
+    fn id(&self) -> &Self::IdType {
+        &self.id
+    }
+}

model/src/achievements/groups.rs

@@ -0,0 +1,39 @@
+use serde::{Deserialize, Serialize};
+
+use crate::{
+    achievements::categories::AchievementCategoryId, BulkEndpoint, Endpoint, EndpointWithId,
+    FixedEndpoint,
+};
+
+pub type AchievementGroupGuid = String;
+pub type AchievementGroupOrder = u32;
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementGroup {
+    id: AchievementGroupGuid,
+    name: String,
+    description: String,
+    order: AchievementGroupOrder,
+    categories: Vec<AchievementCategoryId>,
+}
+
+impl EndpointWithId for AchievementGroup {
+    type IdType = AchievementGroupGuid;
+}
+
+impl Endpoint for AchievementGroup {
+    const AUTHENTICATED: bool = false;
+    const LOCALE: bool = true;
+    const URL: &'static str = "v2/achievements/groups";
+    const VERSION: &'static str = "2025-08-29T01:00:00.000Z";
+}
+
+impl FixedEndpoint for AchievementGroup {}
+
+impl BulkEndpoint for AchievementGroup {
+    const ALL: bool = true;
+
+    fn id(&self) -> &Self::IdType {
+        &self.id
+    }
+}

model/src/achievements/mod.rs

@@ -0,0 +1,157 @@
+use serde::{Deserialize, Serialize};
+
+use crate::{
+    items::{skins::SkinId, ItemId},
+    maps::continents::{MasteryPointId, MasteryPointRegion},
+    misc::{minis::MiniPetId, titles::TitleId},
+    BulkEndpoint, Endpoint, EndpointWithId, FixedEndpoint,
+};
+
+pub mod categories;
+pub mod groups;
+
+pub type AchievementId = u32;
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub enum AchievementFlags {
+    Pvp,
+    CategoryDisplay,
+    MoveToTop,
+    IgnoreNearlyComplete,
+    Repeatable,
+    Hidden,
+    RequiresUnlock,
+    RepairOnLogin,
+    Daily,
+    Weekly,
+    Monthly,
+    Permanent,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub enum AchievementType {
+    Default,
+    ItemSet,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementTier {
+    count: u32,
+    points: u32,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementCoinsReward {
+    count: u32,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementItemReward {
+    id: ItemId,
+    count: u8,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementMasteryReward {
+    id: MasteryPointId,
+    region: MasteryPointRegion,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementTitleReward {
+    id: TitleId,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(tag = "type")]
+pub enum AchievementReward {
+    Coins(AchievementCoinsReward),
+    Item(AchievementItemReward),
+    Mastery(AchievementMasteryReward),
+    Title(AchievementTitleReward),
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementTextBit {
+    id: Option<u32>,
+    text: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementItemBit {
+    id: Option<ItemId>,
+    text: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementMinipetBit {
+    id: Option<MiniPetId>,
+    text: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct AchievementSkinBit {
+    id: Option<SkinId>,
+    text: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(deny_unknown_fields)]
+pub struct AchievementEmptyBit {}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(tag = "type")]
+pub enum AchievementBit {
+    Text(AchievementTextBit),
+    Item(AchievementItemBit),
+    Minipet(AchievementMinipetBit),
+    Skin(AchievementSkinBit),
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(untagged)]
+pub enum AchievementUntaggedBit {
+    Tagged(AchievementBit),
+    Empty(AchievementEmptyBit),
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct Achievement {
+    id: AchievementId,
+    icon: Option<String>,
+    name: String,
+    description: String,
+    requirement: String,
+    locked_text: String,
+    #[serde(rename = "type")]
+    _type: Option<AchievementType>,
+    flags: Vec<AchievementFlags>,
+    tiers: Vec<AchievementTier>,
+    #[serde(default)]
+    prerequisites: Vec<AchievementId>,
+    #[serde(default)]
+    rewards: Vec<AchievementReward>,
+    bits: Option<Vec<AchievementUntaggedBit>>,
+    point_cap: Option<i32>,
+}
+
+impl EndpointWithId for Achievement {
+    type IdType = AchievementId;
+}
+
+impl Endpoint for Achievement {
+    const AUTHENTICATED: bool = false;
+    const LOCALE: bool = true;
+    const URL: &'static str = "v2/achievements";
+    const VERSION: &'static str = "2025-08-29T01:00:00.000Z";
+}
+
+impl FixedEndpoint for Achievement {}
+
+impl BulkEndpoint for Achievement {
+    const ALL: bool = false;
+
+    fn id(&self) -> &Self::IdType {
+        &self.id
+    }
+}

model/src/authenticated/account.rs

@@ -1,8 +1,10 @@
+pub mod achievements;
 pub mod bank;
 pub mod inventory;
 pub mod materials;
 pub mod raids;
 pub mod wallet;
+pub mod wizards_vault;
 
 use std::collections::BTreeSet;