Breaking in 4.0.0

Integer id columns are decimal strings — Every id column of integers (id, *_id, game_pk, playerId, …) comes back as exact decimal strings on every surface — parsers, producers, loaders, HockeyTech analytics. Compare and join ids as strings; Number(row.game_id) for a safe number back. (changelog)
An empty or non-JSON 2xx body raises AssetFetchError — An empty 200 or an HTML challenge page is a failed fetch, not "" / []. Catch AssetFetchError (unknown — retry later) apart from NoDataError (nothing there). (changelog)
400 / 422 raise InvalidParameterError — For every family (it was AssetFetchError), never retried; the message names host, path and status with a redacted excerpt of the body. (changelog)
Typed returns — generated row types for parsed: true — TypeScript only. A wrapper's raw payload resolves to unknown (was any); verified endpoints resolve to their row interfaces; the summary dispatchers to ParsedTables. Narrow or cast a raw payload. (changelog)
Typed wrapper params and loader rows; strict mode — TypeScript only. A param the endpoint does not have, a missing required path param or a non-boolean bool param is a type error; parser rows are Record<string, unknown>; loader rows are their generated row types. (changelog)
Wrapper failures raise NoDataError / AssetFetchError — Instead of raw axios errors. NoDataError = the fetch worked and there is nothing there (404, ESPN { code: 404 }); AssetFetchError = the fetch failed (403 / 429 / 5xx after retries, network). Retries follow DEFAULT_RETRY_STATUSES with backoff. (changelog)

`odds` — native provider reference

namespace: sdv.odds (standalone — not an ESPN league)
families: The Odds API
wrappers: 10 native

odds is a cross-sport provider namespace (no ESPN {sport}/{league} nesting). Every method is exposed under BOTH its snake_case name (<family>_<endpoint>, py/R parity) and a camelCase canonical name (<family><Endpoint>) on sdv.odds. Pass { parsed: true } to any endpoint to get tidy rows instead of raw JSON.

import sdv from 'sportsdataverse';

// The Odds API uses a plain `apiKey` query param (you supply it):
await sdv.odds.oddsApiSports({ api_key: process.env.ODDS_API_KEY });

Native API — The Odds API

Flat (non-ESPN) wrappers for the-odds-api.com. Host: https://api.the-odds-api.com. Each method is exposed under BOTH its snake_case name odds_api_<endpoint> (sdv-py's name, py/R parity) and its camelCase form (canonical) on sdv.odds. Pass { parsed: true } to run the payload through its tidy.js parser; omit it for the raw response.

Method	HTTP	Path params	Query params	Parser	Auth
`odds_api_event_markets` / `oddsApiEventMarkets`	`https://api.the-odds-api.com/v4/sports/{sport_key}/events/{event_id}/markets`	`sport_key`, `event_id`	`api_key` → `apiKey`, `regions`, `bookmakers`, `date_format` → `dateFormat`	`parse_odds_api_event_markets`	—
`odds_api_event_odds` / `oddsApiEventOdds`	`https://api.the-odds-api.com/v4/sports/{sport_key}/events/{event_id}/odds`	`sport_key`, `event_id`	`api_key` → `apiKey`, `regions`, `markets`, `odds_format` → `oddsFormat`, `date_format` → `dateFormat`, `bookmakers`	`parse_odds_api_event_odds`	—
`odds_api_event_odds_history` / `oddsApiEventOddsHistory`	`https://api.the-odds-api.com/v4/historical/sports/{sport_key}/events/{event_id}/odds`	`sport_key`, `event_id`	`api_key` → `apiKey`, `date`, `regions`, `markets`, `odds_format` → `oddsFormat`, `date_format` → `dateFormat`, `bookmakers`	`parse_odds_api_event_odds_history`	—
`odds_api_sports` / `oddsApiSports`	`https://api.the-odds-api.com/v4/sports`	—	`api_key` → `apiKey`, `all`	`parse_odds_api_sports`	—
`odds_api_sports_events` / `oddsApiSportsEvents`	`https://api.the-odds-api.com/v4/sports/{sport_key}/events`	`sport_key`*	`api_key` → `apiKey`, `date_format` → `dateFormat`, `event_ids` → `eventIds`, `commence_time_from` → `commenceTimeFrom`, `commence_time_to` → `commenceTimeTo`	`parse_odds_api_sports_events`	—
`odds_api_sports_events_history` / `oddsApiSportsEventsHistory`	`https://api.the-odds-api.com/v4/historical/sports/{sport_key}/events`	`sport_key`*	`api_key` → `apiKey`, `date`, `date_format` → `dateFormat`, `event_ids` → `eventIds`, `commence_time_from` → `commenceTimeFrom`, `commence_time_to` → `commenceTimeTo`	`parse_odds_api_sports_events_history`	—
`odds_api_sports_odds` / `oddsApiSportsOdds`	`https://api.the-odds-api.com/v4/sports/{sport_key}/odds`	`sport_key`*	`api_key` → `apiKey`, `regions`, `markets`, `odds_format` → `oddsFormat`, `date_format` → `dateFormat`, `event_ids` → `eventIds`, `bookmakers`, `commence_time_from` → `commenceTimeFrom`, `commence_time_to` → `commenceTimeTo`	`parse_odds_api_sports_odds`	—
`odds_api_sports_odds_history` / `oddsApiSportsOddsHistory`	`https://api.the-odds-api.com/v4/historical/sports/{sport_key}/odds`	`sport_key`*	`api_key` → `apiKey`, `date`, `regions`, `markets`, `odds_format` → `oddsFormat`, `date_format` → `dateFormat`, `event_ids` → `eventIds`, `bookmakers`	`parse_odds_api_sports_odds_history`	—
`odds_api_sports_participants` / `oddsApiSportsParticipants`	`https://api.the-odds-api.com/v4/sports/{sport_key}/participants`	`sport_key`*	`api_key` → `apiKey`	`parse_odds_api_sports_participants`	—
`odds_api_sports_scores` / `oddsApiSportsScores`	`https://api.the-odds-api.com/v4/sports/{sport_key}/scores`	`sport_key`*	`api_key` → `apiKey`, `days_from` → `daysFrom`, `date_format` → `dateFormat`, `event_ids` → `eventIds`	`parse_odds_api_sports_scores`	—