refactor!: Model and endpoint changes for Aug 2025 API update (#45)

Updates for August 2025 migration

---------

Co-authored-by: codename-irvin <brian.budge@protonmail.com>

Author: kamranayub

IGDB.Tests/Dumps.cs

@@ -31,7 +31,7 @@ public async Task ShouldReturnDumpsList()
     [Fact]
     public async Task ShouldReturnGamesEndpointDump()
     {
-      var gameDump = await _api.GetDataDumpEndpointAsync("games");
+      var gameDump = await _api.GetDataDumpEndpointAsync(IGDBClient.Endpoints.Games);
 
       Assert.NotNull(gameDump);
       Assert.NotNull(gameDump.S3Url);

IGDB.Tests/GameTimeToBeats.cs

@@ -0,0 +1,33 @@
+using System;
+using System.Threading.Tasks;
+using Xunit;
+
+namespace IGDB.Tests
+{
+  public class GameTimeToBeats
+  {
+    IGDBClient _api;
+
+    public GameTimeToBeats()
+    {
+      _api = new IGDB.IGDBClient(
+        Environment.GetEnvironmentVariable("IGDB_CLIENT_ID"),
+        Environment.GetEnvironmentVariable("IGDB_CLIENT_SECRET")
+      );
+    }
+
+    [Fact]
+    public async Task Should_Return_GameTimeToBeat_Data()
+    {
+      var games = await _api.QueryAsync<IGDB.Models.GameTimeToBeat>(IGDBClient.Endpoints.GameTimeToBeats, query: "fields *; where id = 3575;");
+      Assert.NotNull(games);
+      Assert.NotEmpty(games);
+      Assert.Equal(3575, games[0].Id);
+      Assert.Equal(201711, games[0].GameId);
+      Assert.Equal(1, games[0].Count);
+      Assert.Equal(14400, games[0].Hastily);
+      Assert.Equal(28800, games[0].Normally);
+      Assert.Equal(32400, games[0].Completely);
+    }
+  }
+}

IGDB.Tests/Games.cs

@@ -103,6 +103,38 @@ public async Task ShouldReturnResponseWithSingleGameExpandedCover()
       Assert.Equal(756, game.Cover.Value.Width);
     }
 
+    [Fact]
+    public async Task ShouldReturnResponseWithExpandedTableEnumFieldsForAug2025Migration()
+    {
+      var games = await _api.QueryAsync<Game>(IGDBClient.Endpoints.Games, "fields id,game_type.type,game_status.status; where id = 52625;");
+
+      Assert.NotNull(games);
+
+      var game = games[0];
+
+      Assert.NotNull(game.GameStatus.Value);
+      Assert.Equal("Cancelled", game.GameStatus.Value.Status);
+
+      Assert.NotNull(game.GameType.Value);
+      Assert.Equal("Main Game", game.GameType.Value.Type);
+    }
+
+    [Fact]
+    public async Task ShouldReturnResponseWithNonExpandedTableEnumFieldsForAug2025Migration()
+    {
+      var games = await _api.QueryAsync<Game>(IGDBClient.Endpoints.Games, "fields id,game_type,game_status; where id = 52625;");
+
+      Assert.NotNull(games);
+
+      var game = games[0];
+
+      Assert.NotNull(game.GameStatus.Id);
+      Assert.Equal(6, game.GameStatus.Id);
+
+      Assert.NotNull(game.GameType.Id);
+      Assert.Equal(0, game.GameType.Id);
+    }
+
     [Fact]
     public async Task ShouldReturnResponseWithUnixTimestamp()
     {

IGDB/IGDBApi.cs

@@ -252,23 +252,34 @@ public static bool IsInvalidTokenResponse(ApiException ex)
     public static class Endpoints
     {
       public const string AgeRating = "age_ratings";
-      public const string AgeRatingContentDescriptions = "age_rating_content_descriptions";
+      public const string AgeRatingCategories = "age_rating_categories";
+      public const string AgeRatingContentDescriptionsV2 = "age_rating_content_descriptions_v2";
+      public const string AgeRatingOrganizations = "age_rating_organizations";
       public const string AlternativeNames = "alternative_names";
       public const string Artworks = "artworks";
       public const string Characters = "characters";
+      public const string CharacterGenders = "character_genders";
       public const string CharacterMugShots = "character_mug_shots";
+      public const string CharacterSpecies = "character_species";
       public const string Collections = "collections";
       public const string Companies = "companies";
+      public const string CompanyStatus = "company_status";
       public const string CompanyWebsites = "company_websites";
       public const string CompanyLogos = "company_logos";
       public const string Covers = "covers";
+      public const string DateFormats = "date_formats";
       public const string ExternalGames = "external_games";
+      public const string ExternalGameSources = "external_game_sources";
       public const string Franchies = "franchises";
       public const string Games = "games";
       public const string GameEngines = "game_engines";
       public const string GameEngineLogos = "game_engine_logos";
       public const string GameVersions = "game_versions";
       public const string GameModes = "game_modes";
+      public const string GameReleaseFormats = "game_release_formats";
+      public const string GameStatuses = "game_statuses";
+      public const string GameTimeToBeats = "game_time_to_beats";
+      public const string GameTypes = "game_types";
       public const string GameVersionFeatures = "game_version_features";
       public const string GameVersionFeatureValues = "game_version_feature_values";
       public const string GameVideos = "game_videos";
@@ -279,16 +290,19 @@ public static class Endpoints
       public const string Platforms = "platforms";
       public const string PlatformFamilies = "platform_families";
       public const string PlatformLogos = "platform_logos";
+      public const string PlatformTypes = "platform_types";
       public const string PlatformVersions = "platform_versions";
       public const string PlatformVersionCompanies = "platform_version_companies";
       public const string PlatformVersionReleaseDates = "platform_version_release_dates";
       public const string PlatformWebsites = "platform_websites";
       public const string PlayerPerspectives = "player_perspectives";
       public const string ReleaseDates = "release_dates";
+      public const string ReleaseDateRegions = "release_date_regions";
       public const string Screenshots = "screenshots";
       public const string Search = "search";
       public const string Themes = "themes";
       public const string Websites = "websites";
+      public const string WebsiteTypes = "website_types";
     }
   }
 }

IGDB/Models/AgeRating.cs

@@ -2,66 +2,12 @@ namespace IGDB.Models
 {
   public class AgeRating : IIdentifier, IHasChecksum
   {
-    public AgeRatingCategory? Category { get; set; }
     public string Checksum { get; set; }
-    public IdentitiesOrValues<AgeRatingContentDescription> ContentDescriptions { get; set; }
-    public long? Id { get; set; }
-    public AgeRatingTitle? Rating { get; set; }
+    public IdentityOrValue<AgeRatingOrganization> Organization { get; set; }
+    public IdentityOrValue<AgeRatingCategory> RatingCategory { get; set; }
+    public IdentitiesOrValues<AgeRatingContentDescriptionV2> RatingContentDescriptions { get; set; }
     public string RatingCoverUrl { get; set; }
     public string Synopsis { get; set; }
-  }
-
-  public enum AgeRatingCategory
-  {
-    ESRB = 1,
-    PEGI = 2,
-    CERO = 3,
-    USK = 4,
-    GRAC = 5,
-    CLASS_IND = 6,
-    ACB = 7
-  }
-
-  public enum AgeRatingTitle
-  {
-    Three = 1,
-    Seven = 2,
-    Twelve = 3,
-    Sixteen = 4,
-    Eighteen = 5,
-    RP = 6,
-    EC = 7,
-    E = 8,
-    E10 = 9,
-    T = 10,
-    M = 11,
-    AO = 12,
-    CERO_A = 13,
-    CERO_B = 14,
-    CERO_C = 15,
-    CERO_D = 16,
-    CERO_Z = 17,
-    USK_0 = 18,
-    USK_6 = 19,
-    USK_12 = 20,
-    USK_16 = 21,
-    USK_18 = 22,
-    GRAC_All = 23,
-    GRAC_Twelve = 24,
-    GRAC_Fifteen = 25,
-    GRAC_Eighteen = 26,
-    GRAC_Testing = 27,
-    CLASS_IND_L = 28,
-    CLASS_IND_Ten = 29,
-    CLASS_IND_Twelve = 30,
-    CLASS_IND_Fourteen = 31,
-    CLASS_IND_Sixteen = 32,
-    CLASS_IND_Eighteen = 33,
-    ACB_G = 34,
-    ACB_PG = 35,
-    ACB_M = 36,
-    ACB_MA15 = 37,
-    ACB_R18 = 38,
-    ACB_RC = 39,
+    public long? Id { get; set; }
   }
 }

IGDB/Models/AgeRatingCategory.cs

@@ -0,0 +1,14 @@
+using System;
+
+namespace IGDB.Models
+{
+  public class AgeRatingCategory : ITimestamps, IIdentifier, IHasChecksum
+  {
+    public string Checksum { get; set; }
+    public DateTimeOffset? CreatedAt { get; set; }
+    public IdentityOrValue<AgeRatingOrganization> Organization { get; set; }
+    public string Rating { get; set; }
+    public long? Id { get; set; }
+    public DateTimeOffset? UpdatedAt { get; set; }
+  }
+}

IGDB/Models/AgeRatingContentDescription.cs

@@ -0,0 +1,14 @@
+using System;
+
+namespace IGDB.Models
+{
+  public class AgeRatingContentDescriptionV2 : ITimestamps, IIdentifier, IHasChecksum
+  {
+    public string Checksum { get; set; }
+    public DateTimeOffset? CreatedAt { get; set; }
+    public IdentityOrValue<AgeRatingOrganization> Organization { get; set; }
+    public string Description { get; set; }
+    public long? Id { get; set; }
+    public DateTimeOffset? UpdatedAt { get; set; }
+  }
+}

IGDB/Models/AgeRatingContentDescriptionV2.cs

@@ -0,0 +1,9 @@
+namespace IGDB.Models
+{
+  public class AgeRatingOrganization : IIdentifier, IHasChecksum
+  {
+    public string Checksum { get; set; }
+    public string Name { get; set; }
+    public long? Id { get; set; }
+  }
+}

IGDB/Models/AgeRatingOrganization.cs

@@ -5,34 +5,18 @@ namespace IGDB.Models
   public class Character : ITimestamps, IIdentifier, IHasChecksum
   {
     public string[] Akas { get; set; }
+    public IdentityOrValue<CharacterGender> CharacterGender { get; set; }
+    public IdentityOrValue<CharacterSpecies> CharacterSpecies { get; set; }
     public string Checksum { get; set; }
     public string CountryName { get; set; }
     public DateTimeOffset? CreatedAt { get; set; }
     public string Description { get; set; }
     public IdentitiesOrValues<Game> Games { get; set; }
-    public Gender? Gender { get; set; }
     public long? Id { get; set; }
     public IdentityOrValue<CharacterMugShot> MugShot { get; set; }
     public string Name { get; set; }
     public string Slug { get; set; }
-    public Species? Species { get; set; }
     public DateTimeOffset? UpdatedAt { get; set; }
     public string Url { get; set; }
   }
-
-  public enum Gender
-  {
-    Male = 1,
-    Female = 2,
-    Other = 3
-  }
-
-  public enum Species
-  {
-    Human = 1,
-    Alien = 2,
-    Animal = 3,
-    Android = 4,
-    Unknown = 5
-  }
 }