Skip to content

v0.5.0

Choose a tag to compare

@github-actions github-actions released this 06 Sep 21:58
· 255 commits to main since this release
a2c45d0

Breaking. Client-side failover and mirror selection are gone. If you called
UseFailover or UseMirror, delete the call — the default configuration is now
the recommended one. To target a different server, set BaseAddress and
GraphQlEndpoint.

Removed

  • UseFailover() and its two overloads, FailoverEndpoints,
    FailoverAttemptTimeout, FailoverCooldown.
    TCGdex deployed new
    infrastructure in September 2026, and its main route now routes around a node
    that is down. Rotating between official nodes client-side was always meant to
    be removed once that existed — it was built on the understanding that it would
    be — and keeping it would mean a second, slower retry layer duplicating one the
    service already does better.

  • UseMirror() and the TcgDexMirror enum. The same deployment retired the
    per-node hostnames. api.na1.tcgdex.net and api.na2.tcgdex.net no longer
    route at all, so two of the six members could only ever fail; upstream now
    recommends api.tcgdex.net for everyone. Left in place they would be an
    invitation to use hosts that no longer work.

  • This also removes the 404 discrimination added after 0.4.0 but never
    released, which stopped an unrouted host's 404 being reported as a missing
    card. That defect is resolved by the feature it lived in no longer existing.
    The reasoning is kept in docs/learnings.md, because it
    is about status codes rather than about failover.

Kept

  • Pointing the SDK at a server of your own. BaseAddress and
    GraphQlEndpoint are unchanged, and remain the supported way to use an
    unofficial mirror, a self-hosted instance, or a local test server. Set both —
    GraphQL sits outside the language segment, so changing only BaseAddress
    leaves GraphQL queries going to the official host.

Added

  • BaseAddress is now validated to end with /. Paths resolve relative to
    it, so https://mine/v2 + en/cards/x gave https://mine/en/cards/x — the
    API root silently dropped, every lookup returning "not found", and nothing
    pointing at the cause. The check previously existed only for failover
    endpoints; removing those left the identical hazard on the one address that
    still matters.