Breaking in 4.0.0

Public names are sportsdataverse-py's — athlete → player, event → game on every ESPN league; sdv-py's name_pattern on the native families (nhlApiWeb* → nhl*, nflApi* → nfl*, CBS's 16 shorts, the 3.0.0 file-stem names). Every pre-v4 name still works as a deprecated alias that warns once. (changelog)
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)
sdv.yahoo.* no longer defaults league=ncaaf or sets a locale — The stats queries send no lang / region / tz and no default league — pass league explicitly. (changelog)

`yahoo` — native provider reference

namespace: sdv.yahoo (standalone — not an ESPN league)
families: Yahoo Sports (scores), Yahoo Sports
wrappers: 109 native

yahoo 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.yahoo. Pass { parsed: true } to any endpoint to get tidy rows instead of raw JSON.

import sdv from 'sportsdataverse';

// Yahoo Sports is keyless but rejects requests without browser-y headers —
// pass Origin/Referer via `headers` (two hosts share the `yahoo` namespace):
await sdv.yahoo.yahoo_league_standings({
  league: 'ncaaf',
  headers: { Origin: 'https://sports.yahoo.com', Referer: 'https://sports.yahoo.com/' },
});

Native API — Yahoo Sports (scores)

Flat (non-ESPN) wrappers for the Yahoo Sports scoreboard/boxscore feed. Host: https://api-secure.sports.yahoo.com. Each method is exposed under BOTH its snake_case name yahoo_scores_<endpoint> (sdv-py's name, py/R parity) and its camelCase form (canonical) on sdv.yahoo. 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
`yahoo_scores_boxscore` / `yahooScoresBoxscore`	`https://api-secure.sports.yahoo.com/v1/editorial/s/boxscore/{game_id}`	`game_id`*	`lang`, `region`, `tz`, `v`, `polling`	`parse_yahoo_scores_boxscore`	—
`yahoo_scores_scoreboard` / `yahooScoresScoreboard`	`https://api-secure.sports.yahoo.com/v1/editorial/s/scoreboard`	—	`lang`, `region`, `tz`, `leagues`, `week`, `season`, `conferences`, `count`, `v`	`parse_yahoo_scores_scoreboard`	—