Repository navigation
v0.5.0
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 theTcgDexMirrorenum. The same deployment retired the
per-node hostnames.api.na1.tcgdex.netandapi.na2.tcgdex.netno longer
route at all, so two of the six members could only ever fail; upstream now
recommendsapi.tcgdex.netfor everyone. Left in place they would be an
invitation to use hosts that no longer work. -
This also removes the
404discrimination added after 0.4.0 but never
released, which stopped an unrouted host's404being reported as a missing
card. That defect is resolved by the feature it lived in no longer existing.
The reasoning is kept indocs/learnings.md, because it
is about status codes rather than about failover.
Kept
- Pointing the SDK at a server of your own.
BaseAddressand
GraphQlEndpointare 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 onlyBaseAddress
leaves GraphQL queries going to the official host.
Added
BaseAddressis now validated to end with/. Paths resolve relative to
it, sohttps://mine/v2+en/cards/xgavehttps://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.