igdb-dotnet

What's Changed

• feat: Add /dumps endpoint by @kamranayub in https://github.com/kamranayub/igdb-dotnet/pull/34 for IGDB Partners

Full Changelog: https://github.com/kamranayub/igdb-dotnet/compare/3.0.0...3.1.0

BREAKING CHANGES

• AgeRatingContentDescriptionCategory went from 2 to 85 new categories
• Removal of external game categories not listed in docs:
  • 18 (Xbox Live Title IDs)
  • 5 (GiantBomb)
  • 2 (GamesDb)
  • PushSquare
  • GamersGate

Changes

• External games enum updated
• Add Collection relationship models
• Addition of Event models
• Addition of Language models
• Addition of ReleaseDateStatus

Full Changelog: https://github.com/kamranayub/igdb-dotnet/compare/2.3.2...3.0.0

Contributors

Thanks @michael-j-green!

What's Changed

• fix: typo in Game Category Episode by @Thundernerd in https://github.com/kamranayub/igdb-dotnet/pull/25

New Contributors

• @Thundernerd made their first contribution in https://github.com/kamranayub/igdb-dotnet/pull/25

Full Changelog: https://github.com/kamranayub/igdb-dotnet/compare/2.3.1...2.3.2

Added

• ExternalCategory.GamersGate
• ExternalCategory.GamesPress
• ExternalCategory.PlayAsia

Full Changelog: https://github.com/kamranayub/igdb-dotnet/compare/2.3.0...2.3.1

What's Changed

• feat: Updates for latest API changes by @kamranayub in https://github.com/kamranayub/igdb-dotnet/pull/22

Full Changelog: https://github.com/kamranayub/igdb-dotnet/compare/2.2.0...2.3.0

What's Changed

• feat: Updates for latest API changes by @kamranayub in https://github.com/kamranayub/igdb-dotnet/pull/22

Full Changelog: https://github.com/kamranayub/igdb-dotnet/compare/2.2.0...2.3.0-preview1

Changes

• #14 Add CountAsync to count query results instead of return them (Thanks @HRKings!)
• #12 Add new company_logos endpoint support (Thanks @mcknight89)

Changes

• #15 Fixed invalid timestamp handling (Closes #10) (Thanks @mcknight89!)

• fix: nuspec changes for new 2.0 version

!! BREAKING CHANGES !!

The API upgrade to v4 has brought some breaking changes as well as a more involved OAuth2 token authentication flow, which this handles by default using an in-memory token cache.

API v3 to v4 Changes

For the full list of changes to the API, see https://api-docs.igdb.com/?shell#breaking-changes

Client Changes

• Remove all obsolete endpoints, including the Private endpoints
• Renamed IGDB.Client to IGDB.IGDBClient
• Removed static Create method and replaced with more typical new IGDBClient(...)
• You must now pass clientId and clientSecret when creating an IGDB client
• Exposed a simple TwitchAuthClient wrapper class you may use to obtain client credential tokens
• Implement a default InMemoryTokenStore that stores tokens in memory
• The TokenManager will handle checking expired tokens and refreshing when retrieving from the token store
• You may pass a custom ITokenStore that implements the interface to customize token management

Token Management

In IGDBv4 they are based on the Twitch Developer APIs which require valid OAuth2 tokens in any API requests. This is a hassle to handle in a complete way with a backplane (persisted storage) and distributed support. Instead, the SDK will provide a naive default implementation of in-memory token management that should be OK for 80% of the cases. By default, tokens expire in 60d and if the singleton is alive for over 60d, first, congratulations but second, it will check whether the token has expired and refresh it if needed.

Fixes

• fix: GetApiStatus returns array of ApiStatus

BREAKING CHANGE:

• feat: Switch int to long since IGDB identifiers are int64
• fix: Move PlatformLogo and CompanyLogo to IGDB.Models namespace

Other changes:

• feat: Add IIdentifier interface so it's easier to narrow types

Changes

• fix(serialization): Better handling of mixed types

Changes

• fix(serialization): Fix issue with deserializing expanded fields with mixed content

Changes

• fix(serialization): Fix issue with nested serializing of identity objects

Changes

• feat(serialization): Add ability to deserialize models

Changes

• Add ExternalCategory.GiantBomb (enum value: 3) external game support

Changes

• Tested, initial release 🎉

Changes

• [ci] Better Nuget package

Changes

• [ci] Use property switches